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