add
npx blockstudio add <blocks...> [options]
Télécharge des blocs depuis un registre et les écrit dans le répertoire de blocs de votre projet.
Arguments
| Argument | Description |
|---|---|
blocks |
Un ou plusieurs blocs à ajouter. Format : namespace/block ou simplement block. |
Options
| Option | Description |
|---|---|
-y, --yes |
Ignore toutes les invites (écrasement, résolution des conflits). |
--dry-run |
Affiche un aperçu de l’installation sans écrire de fichiers. |
Résolution des espaces de noms
Lorsque vous indiquez un espace de noms, CLI consulte le registre correspondant :
npx blockstudio add ui/tabs
Si vous omettez l’espace de noms, CLI recherche dans tous les registres configurés :
npx blockstudio add tabs
Si le bloc est trouvé dans un seul registre, il est utilisé automatiquement. S’il est trouvé dans plusieurs, CLI affiche une invite interactive de sélection.
Avec --yes, le premier registre correspondant selon l’ordre de blocks.json est utilisé.
Sans terminal et avec --dry-run, un nom ambigu interrompt la commande avec une erreur qui répertorie les registres :
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Avant de résoudre un bloc, add récupère chaque registre configuré. Si l’un d’eux est inaccessible ou invalide, la commande échoue, même pour un bloc avec un espace de noms explicite.
Dépendances
Les blocs peuvent déclarer des dépendances envers d’autres blocs du même registre. Lorsque vous ajoutez un bloc, ses dépendances sont résolues et installées automatiquement.
npx blockstudio add ui/tabs
Si tabs dépend de tab-item, les deux blocs sont téléchargés et installés. Les dépendances sont toujours installées avant les blocs qui en dépendent.
Les dépendances circulaires sont détectées et rejetées avec une erreur.
Comportement en cas d’écrasement
Si un dossier de bloc existe déjà dans le répertoire cible :
- Mode interactif : vous demande de confirmer l’écrasement
- Option
--yes: écrase sans demander - Option
--dry-run: indique ce qui serait écrasé - Mode non interactif sans
--yes: s’arrête avant le téléchargement, avecBlock "<name>" already exists at <path>. Use --yes to overwrite.
La vérification porte aussi sur les dépendances : ajouter tabs lorsque tab-item est déjà installé nécessite --yes.
Plusieurs blocs
Les blocs transmis dans une même commande sont traités dans l’ordre. Si l’un d’eux échoue, la commande s’arrête à cet endroit et les blocs installés plus tôt au cours de cette exécution restent sur le disque.
Exemples
Ajouter un seul bloc :
npx blockstudio add ui/hero
Ajouter plusieurs blocs :
npx blockstudio add ui/tabs ui/hero ui/accordion
Afficher un aperçu sans rien écrire :
npx blockstudio add ui/tabs --dry-run
Ignorer toutes les invites :
npx blockstudio add ui/tabs --yes