Pular para o conteúdo

add

Shell
npx blockstudio add <blocks...> [options]

Baixa blocos de um registro e os grava no diretório de blocos do seu projeto.

Argumentos

Argumento Descrição
blocks Um ou mais blocos a adicionar. Formato: namespace/block ou apenas block.

Opções

Opção Descrição
-y, --yes Ignora todas as solicitações (substituição, resolução de conflitos).
--dry-run Mostra uma prévia do que seria instalado, sem gravar arquivos.

Resolução de namespace

Quando você especifica um namespace, CLI consulta esse registro específico:

Shell
npx blockstudio add ui/tabs

Quando você omite o namespace, CLI pesquisa em todos os registros configurados:

Shell
npx blockstudio add tabs

Se o bloco for encontrado em apenas um registro, ele será usado automaticamente. Se for encontrado em vários, CLI exibirá uma solicitação interativa para selecionar um.

Com --yes, é usado o primeiro registro correspondente na ordem de blocks.json. Sem um terminal e com --dry-run, um nome ambíguo interrompe o comando com um erro que lista os registros:

Código
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

Antes de resolver qualquer bloco, add consulta todos os registros configurados. Se algum deles estiver inacessível ou for inválido, o comando falhará, mesmo que o bloco tenha um namespace explícito.

Dependências

Os blocos podem declarar dependências de outros blocos no mesmo registro. Ao adicionar um bloco, suas dependências são resolvidas e instaladas automaticamente.

Shell
npx blockstudio add ui/tabs

Se tabs depender de tab-item, ambos os blocos serão baixados e instalados. As dependências são sempre instaladas antes dos blocos que dependem delas.

Dependências circulares são detectadas e rejeitadas com um erro.

Comportamento de substituição

Se já existir uma pasta de bloco no diretório de destino:

  • Modo interativo: solicita confirmação para substituir
  • Opção --yes: substitui sem perguntar
  • Opção --dry-run: informa o que seria substituído
  • Modo não interativo sem --yes: interrompe antes de baixar, com Block "<name>" already exists at <path>. Use --yes to overwrite.

A verificação também abrange dependências; portanto, adicionar tabs quando tab-item já está instalado requer --yes.

Vários blocos

Os blocos passados em um comando são processados em ordem. Se algum falhar, o comando para nesse ponto, e os blocos instalados anteriormente na mesma execução permanecem no disco.

Exemplos

Adicionar um bloco:

Shell
npx blockstudio add ui/hero

Adicionar vários blocos:

Shell
npx blockstudio add ui/tabs ui/hero ui/accordion

Pré-visualizar sem gravar:

Shell
npx blockstudio add ui/tabs --dry-run

Ignorar todas as solicitações:

Shell
npx blockstudio add ui/tabs --yes