Перейти к содержимому

добавить

Командная оболочка
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