التثبيت

متطلبات البيئة

• Vue 2.7 (الإصدار النهائي؛ لا يُدعم 2.6 وما دونه، ولا يُدعم IE11)
• يُوصى بـ Node 20 + pnpm 10

التثبيت عبر مدير الحزم

npm install @lh-ui/vue2
# أو
pnpm add @lh-ui/vue2
# أو
yarn add @lh-ui/vue2

الاعتماد الوحيد لـ @lh-ui/vue2 في وقت التشغيل هو @lh-ui/share (الطبقة المشتركة: دوال core الصرفة / theme / constants / locales / types / مصدر أنماط المكوّنات)، ويُثبَّت تلقائيًا معه.

التثبيت من خادم خاص

إذا كان الحزمة مستضافة على خادم خاص بدل السجل العام، فاتبع إحدى الطريقتين التاليتين.

الطريقة الأولى: رابط tarball مباشر

يكفي أن يوفِّر الخادم استضافة ملفات ثابتة. ضع ملف lh-ui-vue2-x.y.z.tgz الناتج عن npm pack في مجلد على الخادم، ثم:

npm install https://your-domain.com/pkg/lh-ui-vue2-1.0.0.tgz
# أو
pnpm add https://your-domain.com/pkg/lh-ui-vue2-1.0.0.tgz
# أو
yarn add https://your-domain.com/pkg/lh-ui-vue2-1.0.0.tgz

في طريقة رابط tarball المباشر، يظل @lh-ui/share يُحل من السجل الحالي، لذا يجب ضمان ظهور هذه الحزمة على السجل العام أو سجلك الخاص.

الطريقة الثانية: سجل ذاتي (مثل Verdaccio)

يدعم السجل الذاتي الجلب وفق semver وإدارة الإصدارات. وجِّه المسارات بدقّة وفق scope في ملف .npmrc الموجود في المجلد الجذري للمشروع (دون التأثير على مصدر تثبيت الحزم الأخرى):

@lh-ui:registry=https://your-domain.com/

ثم ثبّت كالمعتاد:

pnpm add @lh-ui/vue2

استيراد الأنماط يدويًا

// متغيرات السمة (فاتح + داكن)
import '@lh-ui/vue2/theme.css'
// استيراد أنماط مكوّن مفرد عند الحاجة (اختياري — فالمدخل الكامل يشملها)
import '@lh-ui/vue2/style/button'

سياسة الإصدارات

• يتطلب ترقية @lh-ui/share الالتزام بقاعدة «إصدار share أولًا → ترقية مكتبة واجهة المستخدم وفحص الانحدار → ثم الإصدار».
• الوضع الحالي: صدر @lh-ui/vue2 بالإصدار 1.0.0، و@lh-ui/share بالإصدار 0.1.0.