add
npx blockstudio add <blocks...> [options]
Scarica i blocchi da un registro e li salva nella directory dei blocchi del progetto.
Argomenti
| Argomento | Descrizione |
|---|---|
blocks |
Uno o più blocchi da aggiungere. Formato: namespace/block o semplicemente block. |
Opzioni
| Opzione | Descrizione |
|---|---|
-y, --yes |
Ignora tutti i prompt (sovrascrittura, risoluzione dei conflitti). |
--dry-run |
Mostra un’anteprima di ciò che verrebbe installato, senza scrivere file. |
Risoluzione dei namespace
Quando specifichi un namespace, CLI cerca nel registro specificato:
npx blockstudio add ui/tabs
Quando ometti il namespace, CLI cerca in tutti i registri configurati:
npx blockstudio add tabs
Se il blocco viene trovato in un solo registro, viene usato automaticamente. Se viene trovato in più registri, CLI mostra un prompt interattivo di selezione.
Con --yes, viene usato il primo registro corrispondente nell’ordine di blocks.json. Senza terminale e con --dry-run, un nome ambiguo interrompe il comando con un errore che elenca i registri:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Prima di risolvere qualsiasi blocco, add recupera tutti i registri configurati. Se uno di essi non è raggiungibile o non è valido, il comando non riesce, anche per un blocco con namespace esplicito.
Dipendenze
I blocchi possono dichiarare dipendenze da altri blocchi dello stesso registro. Quando aggiungi un blocco, le sue dipendenze vengono risolte e installate automaticamente.
npx blockstudio add ui/tabs
Se tabs dipende da tab-item, entrambi i blocchi vengono scaricati e installati. Le dipendenze vengono sempre installate prima dei blocchi che ne dipendono.
Le dipendenze circolari vengono rilevate e rifiutate con un errore.
Comportamento in caso di sovrascrittura
Se nella directory di destinazione esiste già una cartella del blocco:
- Modalità interattiva: ti chiede di confermare la sovrascrittura
- Flag
--yes: sovrascrive senza chiedere - Flag
--dry-run: mostra cosa verrebbe sovrascritto - Modalità non interattiva senza
--yes: si interrompe prima del download, conBlock "<name>" already exists at <path>. Use --yes to overwrite.
Il controllo include anche le dipendenze, quindi per aggiungere tabs quando tab-item è già installato serve --yes.
Più blocchi
I blocchi passati in un unico comando vengono elaborati in ordine. Se uno non riesce, il comando si interrompe e i blocchi installati in precedenza nella stessa esecuzione restano sul disco.
Esempi
Aggiungere un singolo blocco:
npx blockstudio add ui/hero
Aggiungere più blocchi:
npx blockstudio add ui/tabs ui/hero ui/accordion
Anteprima senza scrivere file:
npx blockstudio add ui/tabs --dry-run
Ignorare tutti i prompt:
npx blockstudio add ui/tabs --yes