Aller au contenu

add

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

Shell
npx blockstudio add ui/tabs

Si vous omettez l’espace de noms, CLI recherche dans tous les registres configurés :

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

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

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

Shell
npx blockstudio add ui/hero

Ajouter plusieurs blocs :

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

Afficher un aperçu sans rien écrire :

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

Ignorer toutes les invites :

Shell
npx blockstudio add ui/tabs --yes