додати
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