Saltar al contenido

añadir

Shell
npx blockstudio add <blocks...> [options]

Descarga bloques de un registro y los guarda en el directorio de bloques de tu proyecto.

Argumentos

Argumento Descripción
blocks Uno o más bloques para añadir. Formato: namespace/block o simplemente block.

Opciones

Opción Descripción
-y, --yes Omite todas las indicaciones (sobrescritura, resolución de conflictos).
--dry-run Muestra una vista previa de lo que se instalaría sin escribir archivos.

Resolución de espacios de nombres

Al especificar un espacio de nombres, CLI busca en ese registro específico:

Shell
npx blockstudio add ui/tabs

Si omites el espacio de nombres, CLI busca en todos los registros configurados:

Shell
npx blockstudio add tabs

Si el bloque se encuentra en un solo registro, se usa automáticamente. Si aparece en varios, CLI muestra una selección interactiva para elegir.

Con --yes, se usa el primer registro coincidente según el orden de blocks.json. Sin una terminal y con --dry-run, un nombre ambiguo detiene el comando con un error que enumera los registros:

Código
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

Antes de resolver cualquier bloque, add obtiene todos los registros configurados. Si alguno no está disponible o no es válido, el comando falla, incluso si el bloque tiene un espacio de nombres explícito.

Dependencias

Los bloques pueden declarar dependencias de otros bloques del mismo registro. Al añadir un bloque, sus dependencias se resuelven e instalan automáticamente.

Shell
npx blockstudio add ui/tabs

Si tabs depende de tab-item, ambos bloques se descargan e instalan. Las dependencias siempre se instalan antes que los bloques que dependen de ellas.

Las dependencias circulares se detectan y se rechazan con un error.

Comportamiento al sobrescribir

Si ya existe una carpeta de bloque en el directorio de destino:

  • Modo interactivo: te pide confirmar la sobrescritura
  • Indicador --yes: sobrescribe sin preguntar
  • Indicador --dry-run: informa qué se sobrescribiría
  • Modo no interactivo sin --yes: se detiene antes de descargar, con Block "<name>" already exists at <path>. Use --yes to overwrite.

La comprobación también incluye las dependencias, así que para añadir tabs cuando tab-item ya está instalado se necesita --yes.

Varios bloques

Los bloques pasados en un mismo comando se procesan en orden. Si alguno falla, el comando se detiene ahí y los bloques instalados antes durante la misma ejecución permanecen en el disco.

Ejemplos

Añadir un solo bloque:

Shell
npx blockstudio add ui/hero

Añadir varios bloques:

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

Vista previa sin escribir:

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

Omitir todas las indicaciones:

Shell
npx blockstudio add ui/tabs --yes