Saltar al contenido

Línea de comandos

El comando taisho compila el CSS con tu marca, lo recompila al guardar y revisa que las clases existan. Viene con el paquete: no hay nada más que instalar.

Los comandos

Se instala @taishods/core en el proyecto (hace falta Node 22.18 o más nuevo) y se corre con npx. taisho --help lista todo lo que sigue.

terminal
Comando Para qué sirve
taisho initCrea el taisho.config.ts del proyecto.
taisho generateCompila la config a una carpeta autocontenida: el CSS con tu marca y el JS de comportamiento.
taisho watchGenera una vez y vuelve a generar lo que cambia cada vez que se guarda un archivo.
taisho checkAvisa las clases y variables del sistema mal escritas.
taisho mcpArranca un servidor MCP local para que un asistente de IA consulte los componentes, las utilidades y tu tema.
taisho migratePasa código de otro sistema al de TaishoDS Core y lista lo que no pudo convertir.

Los pasos para empezar, con el CDN o con el paquete, están en Instalación, y el archivo de configuración, en Theming.


taisho init

Crea taisho.config.ts en la carpeta actual, o en la que se le pase (taisho init [carpeta]). Si ya existe uno, no lo pisa: avisa y sale con 1.

Opción Efecto
--yes, -yNo pregunta: escribe el config con los valores por defecto.
--install-iconsInstala lucide-static (los íconos) sin preguntar.
--lang <es|en>Idioma del config y de los mensajes (es o en); con esta opción no se pregunta.

En una terminal pregunta, en este orden: el idioma de los mensajes (propone el del sistema), el color de marca en hexadecimal, el nombre del tema, si las fuentes son del sistema o de Fontsource, la carpeta de los íconos propios y la carpeta de salida del CSS y el JS. Enter acepta lo que propone cada pregunta. Sin terminal (un CI, por ejemplo) o con --yes no pregunta y escribe los valores por defecto.

La carpeta de salida que propone depende del proyecto: public/taisho si existe public/, static/taisho si existe static/ y ./taisho si no. Si el package.json declara un empaquetador o un framework (Vite, SvelteKit, Astro, Next y similares), propone ./taisho aunque existan esas carpetas, porque el CSS se importa desde el código y esos empaquetadores no permiten importar lo que está en public/. Se guarda como out en el config.

Los íconos de Lucide no vienen con el Core: viven en el paquete lucide-static. Si el proyecto tiene un package.json y todavía no lo tiene instalado, la última pregunta es si instalarlo. Con sí, init lo instala como dependencia de desarrollo con el gestor del proyecto (npm, pnpm, Yarn o Bun, según el archivo de bloqueo que haya) y muestra el comando que corre. Si la instalación falla, por ejemplo sin red, init no falla: avisa y deja el comando para correr a mano. Sin terminal o con --yes no instala nada e imprime el comando exacto; --install-icons lo instala sin preguntar.


taisho generate

Compila el config a la carpeta de salida: theme.css (los tokens de tu tema), fonts.css, el CSS del sistema y el JavaScript de comportamiento (taisho.core.js y sus módulos). Con content en el config, el CSS es taisho.css y lleva sólo lo que tus archivos usan; sin content, es taisho.full.css, completo. Si el proyecto usa íconos, también escribe el sprite.

Opción Efecto
--config <ruta>Ruta al config. Por defecto, ./taisho.config.ts. También se puede pasar como argumento.
--out <carpeta>Carpeta de salida. Manda sobre el out del config; sin ninguno de los dos, ./taisho junto al config.
--strictSale con 1 si hubo cualquier aviso. La salida se escribe igual.
terminal

Al terminar imprime las líneas exactas para pegar en el HTML, con la ruta que ve el navegador (sin public/ ni static/, y con barras normales también en Windows):

salida

Los íconos salen del paquete lucide-static. generate no lo instala ni pregunta: si el código usa íconos que no se resuelven porque falta el paquete, lo avisa con el comando para instalarlo y termina con error; si no usa íconos, no dice nada. Hay más en Íconos.


taisho watch

Genera una vez y se queda mirando: cada vez que se guarda un archivo de content, el config o un SVG de src/icons/, regenera sólo lo que cambió. Sale con Ctrl+C, con código 0. Si algo falla (un config inválido, un ícono que no existe), lo muestra, deja la salida anterior y sigue mirando.

Opción Efecto
--config <ruta>Ruta al config. Por defecto, ./taisho.config.ts. También se puede pasar como argumento.
--out <carpeta>Carpeta de salida, igual que en generate.
salida

Un límite

Si el taisho.config.ts importa otro archivo (por ejemplo, los colores en un marca.ts), un cambio en ese archivo no se detecta. Hay que tocar el config o reiniciar taisho watch.

taisho check

Revisa el código contra el sistema y avisa lo que no va a pintar. Funciona sin generate y sin config, así que sirve también como chequeo de un CI.

Opción Efecto
[rutas…]Archivos, carpetas o globs a revisar. Sin ellos, el content del config o, sin config, todo el proyecto menos node_modules, dist, build y coverage.
--config <ruta>Ruta al config, de donde salen el content y el vocabulario.
--format <text|json>Formato de salida. Por defecto, text; json imprime el resultado en stdout y manda el resumen a stderr.
--other-scaleAvisa también las medidas cuyo número vale otra cosa en otros sistemas (p-4 son 4 px aquí). Apagado por defecto.
terminal

Cada aviso es una línea con archivo:línea:columna, la regla y el mensaje, con un reemplazo cuando lo hay:

salida

Qué avisa

Regla Qué avisa
unknown-classUna clase del sistema que no existe: un error de tipeo, un valor fuera de la escala o un nombre de otro sistema. Las clases propias del proyecto no avisan.
missing-tsUn elemento con clases del sistema pero sin la clase ts, que sin ella no recibe estilo.
ignored-attributeUn atributo que no se lee como clases (su nombre no termina en class) con la clase ts y clases del sistema en el valor: esas clases no se emiten.
legacy-prefixUna clase con el prefijo ts-, que ya no se usa: se escribe sin él y con la clase ts en el mismo elemento.
unknown-varUn var(--ts-*) o var(--color-*) que ningún tema declara.
other-scaleSólo con --other-scale: una medida con el nombre de otro sistema y otro valor.

Las clases se miran en los atributos class y className literales de .html, .svelte, .vue, .astro, .jsx y .tsx. Una clase armada al ejecutar el código no se valida. Los .md sólo se revisan si se piden.

Salida para programas

Con --format json, stdout trae sólo un JSON con version, files y la lista warnings; cada aviso lleva file, line, column, rule, severity, code, params, message y, cuando hay un reemplazo claro, suggestion. El resumen va a stderr. Para decidir algo en un script se leen code y params, que son iguales en los dos idiomas; el texto de message puede cambiar. Una regla nueva entra como aviso (severity: "warning"), que no cambia el código de salida.


taisho mcp

Arranca un servidor MCP por la entrada y la salida estándar, para que un asistente de IA consulte los componentes, las utilidades y el tema del proyecto mientras escribe. Es local y de sólo lectura: no escribe archivos, no usa la red y no envía telemetría. Lo lanza el cliente del asistente, no se corre a mano; sale con 0 cuando el cliente cierra la entrada. Cómo configurarlo y qué responde cada herramienta está en Asistentes de IA.

Opción Efecto
--config <ruta>Ruta al config. Por defecto, ./taisho.config.ts; sin config usa el tema de fábrica. La carpeta del config pasa a ser la raíz del proyecto.
--lang <es|en>Idioma de las fichas y los mensajes (es o en). Por defecto, el lang del config y, si no, el del sistema.

taisho migrate

Pasa código escrito para otro sistema al vocabulario de TaishoDS Core y lista lo que no pudo convertir. Sin --write sólo informa, así que se puede correr sin riesgo. El origen se elige con --from; cada uno se explica en la guía de migración de Fundamentos. Sin --from o con un origen que no existe, sale con 2.

Opción Efecto
--from <origen>De qué sistema se migra. Es obligatoria.
[rutas…]Archivos o carpetas a revisar; reemplazan al content.
--writeAplica los cambios. Sin ella sólo informa lo que cambiaría.
--config <ruta>Ruta al config, de donde salen el content y el vocabulario.

Opciones comunes y códigos de salida

taisho --help muestra la ayuda y taisho --version, la versión. taisho sin argumentos muestra la ayuda y sale con 0. Un cliente de integración continua distingue «el código tiene problemas» (1) de «el comando no pudo correr» (2):

Código Significa
0Corrió y no hubo problemas. En check, sin avisos de severidad error.
1Corrió y falló lo pedido: un config inválido, un error al generar, avisos con --strict, errores en check, un taisho.config.ts que ya existe (init) o un Node anterior al 22.18.
2Error de uso: una opción que no existe o que no aplica al comando, una opción sin su valor, un comando que no existe, un valor de --lang que no existe, o un check que no pudo correr.

Idioma de los mensajes

taisho habla español o inglés: mensajes, errores, ayuda y reportes. El idioma sale, en este orden, de --lang es o --lang en (vale en cualquier comando), de la opción lang del taisho.config.ts y del idioma del sistema. Ningún comando lo pregunta salvo init, así que un CI nunca queda esperando una respuesta. El idioma no cambia el CSS ni los códigos de salida.

terminal