Vai al contenuto

add

Shell
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:

Shell
npx blockstudio add ui/tabs

Quando ometti il namespace, CLI cerca in tutti i registri configurati:

Shell
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:

Codice
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.

Shell
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, con Block "<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:

Shell
npx blockstudio add ui/hero

Aggiungere più blocchi:

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

Anteprima senza scrivere file:

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

Ignorare tutti i prompt:

Shell
npx blockstudio add ui/tabs --yes