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.
npm i -D @taishods/core
npx taisho --help| Comando | Para qué sirve |
|---|---|
| taisho init | Crea el taisho.config.ts del proyecto. |
| taisho generate | Compila la config a una carpeta autocontenida: el CSS con tu marca y el JS de comportamiento. |
| taisho watch | Genera una vez y vuelve a generar lo que cambia cada vez que se guarda un archivo. |
| taisho check | Avisa las clases y variables del sistema mal escritas. |
| taisho mcp | Arranca un servidor MCP local para que un asistente de IA consulte los componentes, las utilidades y tu tema. |
| taisho migrate | Pasa 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, -y | No pregunta: escribe el config con los valores por defecto. |
| --install-icons | Instala 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. |
| --strict | Sale con 1 si hubo cualquier aviso. La salida se escribe igual. |
npx taisho generate
npx taisho generate --out public/taisho
npx taisho generate --strictAl 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):
✅ Generado en public/taisho/
Esto va en tu HTML, en este orden:
<link rel="stylesheet" href="/taisho/fonts.css">
<link rel="stylesheet" href="/taisho/theme.css">
<link rel="stylesheet" href="/taisho/taisho.css">
<script type="module" src="/taisho/taisho.core.js"></script>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. |
✅ taisho/ al día (3 archivos, 215 ms). Mirando 9 archivos de content, la config y src/icons/. Ctrl+C para salir.
+ w.html → sin cambios (12 ms)
⚠ w.html:1: "gap-bse" no existe en el DS y no se emite. ¿Se quiso decir "gap-base"?Un límite
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-scale | Avisa también las medidas cuyo número vale otra cosa en otros sistemas (p-4 son 4 px aquí). Apagado por defecto. |
npx taisho check # el proyecto entero
npx taisho check src # una carpeta
npx taisho check 'src/**/*.{svelte,css}' # sólo estos archivos
npx taisho check --format json # para que lo lea un programaCada aviso es una línea con archivo:línea:columna, la regla y el mensaje, con un reemplazo cuando
lo hay:
aviso.html:1:23 unknown-class "bg-brnad-500" no existe en el DS y no se emite. ¿Se quiso decir "bg-brand-500"?
taisho check: 1 archivo(s) revisado(s), 1 aviso(s).Qué avisa
| Regla | Qué avisa |
|---|---|
| unknown-class | Una 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-ts | Un elemento con clases del sistema pero sin la clase ts, que sin ella no recibe estilo. |
| ignored-attribute | Un 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-prefix | Una clase con el prefijo ts-, que ya no se usa: se escribe sin él y con la clase ts en el mismo elemento. |
| unknown-var | Un var(--ts-*) o var(--color-*) que ningún tema declara. |
| other-scale | Só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. |
| --write | Aplica 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 |
|---|---|
| 0 | Corrió y no hubo problemas. En check, sin avisos de severidad error. |
| 1 | Corrió 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. |
| 2 | Error 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.
npx taisho check --lang en