مقدمة

lh-ui-core هو مركز وقت البناء للسلالة الأصلية في عائلة lh-ui.

ما هذا المستودع

@lh-ui/core هو موطن المصدر الأصلي الوحيد لرموز التصميم، وعقود المكوّنات، والحالات الذهبية، بالإضافة إلى أداة codegen تحوّل الرموز المحايدة إلى هياكل لغوية للأطراف الأصلية الأربعة.

وهو ليس تبعية في وقت التشغيل. إنه يعمل في وقت البناء فقط: يحوّل رموز JSON وعقود المكوّنات المستقلة عن المنصات إلى منتجات لأربعة أطراف أصلية هي Android (Kotlin) / iOS (Swift) / HarmonyOS (ArkTS) / C، ثم تكتب كل مكتبة واجهة أصلية التنفيذ يدويًا. لا يوجد أي JavaScript في وقت التشغيل الأصلي.

بنية السلالتين

للعائلة سلالتان مستقلتان تمامًا، ويُمنع ربطهما ببعضهما:

عائلة lh-ui
├── سلالة الويب: lh-ui-share (قلب TS + المصدر الوحيد لأنماط SCSS) ← plus / vue2 / react / uniapp
└── السلالة الأصلية: هذا المستودع (رموز JSON + المواصفات + codegen) ← android / ios / harmony / windows

لا توجد أي علاقة تبعية في الكود بين هذا المستودع وlh-ui-share؛ كل منهما يشكل حلقة مغلقة مستقلة ويُصدر بشكل مستقل. يتم الحفاظ على وحدة العلامة التجارية والشكل المرئي عبر آلية محاذاة يدوية في مستودع توثيق العائلة (docs/设计语言基线.md)، لا عبر مزامنة تلقائية.

طبقات العقود الثلاث

يتكون محتوى هذا المستودع من ثلاث طبقات من عقود JSON، مستقلة عن بعضها لكنها تشير إحداها إلى الأخرى:

الطبقة	الموقع	السؤال الذي تجيب عنه
الرموز	tokens/*.json	«كيف يبدو الواجهة» —— الألوان، المسافات، أحجام الخطوط، الزوايا، الظلال، الحركة، الترتيب الطبقي، الأبعاد على مستوى المكوّن
العقود	specs/*.json	«ما هي قدرات المكوّن» —— props / القيم المُعدَّدة / القيم الافتراضية / الأحداث / الفتحات / السلوكيات
الحالات	cases/*.json	«كيف يُختبر المكوّن» —— تأكيدات سلوكية given/when/then قابلة للترجمة عبر الأطراف

يستهلك codegen الرموز فقط لتوليد الهياكل للأطراف الأربعة؛ أما العقود والحالات فيستهلكها حاليًا كل طرف أصلي يدويًا (وقد يتوسع ذلك مستقبلًا لتوليد هياكل الأنواع وقوالب الاختبار تلقائيًا).

بذور الرموز

كانت القيم الأولية لـ tokens/*.json في هذا المستودع بذرةً محاذيةً مستخرجة يدويًا مرة واحدة من lh-ui-share/styles/theme/common/variables.scss وvar-dark.scss (في 2026-10-10، راجع docs/设计语言基线.md الخاص بالعائلة). بعد ذلك التاريخ، تطور المستودعان كلٌّ على حدة، دون أي مزامنة. ويجب تسجيل أي تغييرات في الرموز على مستوى العلامة التجارية (لوحات الألوان، مقاييس المسافات) في وثيقة خط الأساس تلك.

من الذي ينبغي أن يقرأ هذا التوثيق

• مطوّرو الأطراف الأصلية (android / ios / harmony / windows): لفهم اصطلاحات التسمية، وتحويلات الوحدات، وآلية الوضع الداكن في منتجات dist/، ومعرفة من أين تأتي الرموز وكيف تُحسب قيمها.
• مشرفو هذا المستودع: لفهم مسؤوليات ودوال كل وحدة في خط أنابيب codegen، والقدرة على تعديل القوالب، وإضافة الرموز، وإضافة المكوّنات.

الخطوات التالية

• البدء السريع —— الاستنساخ، والتثبيت،وتشغيل codegen مرة واحدة
• بنية الدلائل —— مسؤولية كل دليل
• تنسيق الرموز —— قيود حقول رموز JSON
• نظرة عامة على خط الأنابيب —— تدفق البيانات الكامل لـ codegen