إضافة
npx blockstudio add <blocks...> [options]
ينزّل المكوّنات من سجل ويكتبها في مجلد المكوّنات بمشروعك.
الوسائط
| الوسيط | الوصف |
|---|---|
blocks |
مكوّن واحد أو أكثر لإضافته. التنسيق: namespace/block أو block فقط. |
الخيارات
| الخيار | الوصف |
|---|---|
-y, --yes |
تخطَّ جميع المطالبات (الاستبدال وحل التعارضات). |
--dry-run |
اعرض معاينة لما سيُثبّت دون كتابة ملفات. |
تحديد مساحة الاسم
عند تحديد مساحة اسم، يبحث CLI في السجل المحدد:
npx blockstudio add ui/tabs
عند عدم تحديد مساحة اسم، يبحث CLI في جميع السجلات المُعدّة:
npx blockstudio add tabs
إذا عُثر على المكوّن في سجل واحد فقط، فسيُستخدم تلقائيًا. وإذا عُثر عليه في عدة سجلات، يعرض CLI مطالبة اختيار تفاعلية لتحديد السجل.
مع --yes، يُستخدم أول سجل مطابق حسب ترتيب blocks.json.
من دون طرفية، ومع --dry-run، يؤدي الاسم الملتبس إلى إيقاف الأمر
مع عرض خطأ يسرد السجلات:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
قبل حل أي كتلة، يجلب add كل السجلات المُعدّة. إذا تعذّر الوصول إلى أحدها
أو كان غير صالح، يفشل الأمر حتى عند تحديد مساحة اسم صريحة للكتلة.
التبعيات
يمكن للكتل إعلان اعتمادها على كتل أخرى في السجل نفسه. عند إضافة كتلة، تُحلّ اعتماداتها وتُثبّت تلقائيًا.
npx blockstudio add ui/tabs
إذا كانت tabs تعتمد على tab-item، فسيتم تنزيل الكتلتين وتثبيتهما.
تُثبّت الاعتمادات دائمًا قبل الكتل التي تعتمد عليها.
يُكتشف الاعتماد الدائري ويُرفض مع عرض خطأ.
سلوك الاستبدال
إذا كان مجلد كتلة موجودًا بالفعل في الدليل المستهدف:
- الوضع التفاعلي: يطلب منك تأكيد الاستبدال
- العلامة
--yes: يستبدل دون سؤال - العلامة
--dry-run: يعرض ما سيُستبدل - الوضع غير التفاعلي من دون
--yes: يتوقف قبل التنزيل، مع عرضBlock "<name>" already exists at <path>. Use --yes to overwrite.
يشمل الفحص الاعتمادات أيضًا، لذا فإن إضافة tabs عندما تكون tab-item مثبتة بالفعل تتطلب --yes.
كتل متعددة
تُعالَج الكتل المقدمة في أمر واحد بالترتيب. إذا فشلت إحداها، يتوقف الأمر عندها، وتبقى الكتل التي ثُبّتت قبلها أثناء التشغيل نفسه على القرص.
أمثلة
إضافة كتلة واحدة:
npx blockstudio add ui/hero
إضافة كتل متعددة:
npx blockstudio add ui/tabs ui/hero ui/accordion
معاينة دون كتابة:
npx blockstudio add ui/tabs --dry-run
تخطي جميع المطالبات:
npx blockstudio add ui/tabs --yes