add
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:
npx blockstudio add ui/tabs
Quando você omite o namespace, CLI pesquisa em todos os registros configurados:
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:
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.
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, comBlock "<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:
npx blockstudio add ui/hero
Adicionar vários blocos:
npx blockstudio add ui/tabs ui/hero ui/accordion
Pré-visualizar sem gravar:
npx blockstudio add ui/tabs --dry-run
Ignorar todas as solicitações:
npx blockstudio add ui/tabs --yes