Íconos
El set completo de Lucide más tus SVGs custom, con validación en tiempo de build: es imposible publicar un ícono que no existe.
Uso
En HTML el ícono es un <svg> con la clase ts icon y un tamaño (icon-16, icon-20…, los pasos de la escala; la utilidad general size-20 también
sirve). Hereda el color del texto
(currentColor). Con npx taisho generate, el <use> apunta al sprite que el comando arma con sólo los íconos que
se usan, y el nombre sale del fragmento #ts-<nombre>.
<svg class="ts icon icon-20" aria-hidden="true"><use href="taisho/taisho.icons.svg#ts-search"></use></svg>Los íconos de Lucide salen del paquete lucide-static, que no viene con el Core. npx taisho init ofrece instalarlo (y --install-icons lo instala sin
preguntar); también se instala a mano con npm i -D lucide-static. Sin él, un proyecto que no usa
íconos compila igual; si el código usa alguno, taisho generate avisa con ese comando y termina con
error.
Sin build, con el CDN, no hay sprite: se copia el SVG del ícono desde lucide.dev, se pega en el HTML y
se le pone class="ts icon icon-20". Es lo que traen los ejemplos de cada componente.
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round"
class="ts icon icon-20" aria-hidden="true">
<path d="m21 21-4.34-4.34" />
<circle cx="11" cy="11" r="8" />
</svg>Si el ícono va solo, sin texto al lado, el botón o el enlace que lo contiene necesita un aria-label; si acompaña a un texto, queda con aria-hidden="true". La página del componente Icon tiene los tamaños y los ejemplos.
Validación en build
Si un #ts-<nombre> de tu HTML no existe (ni en Lucide ni en tus
custom), taisho generate termina con error y sugiere el más parecido, por
distancia de edición.
Íconos custom
Se pone un .svg en src/icons. El nombre del
archivo (kebab, sin .svg) pasa a ser el nombre del ícono. El CLI del
Core (taisho generate) siempre mira esa carpeta.
# src/icons/taisho-mark.svg → #ts-taisho-markResolución: primero Lucide, si no existe la carpeta custom, si tampoco, error de build.
Auto-detecta el estilo: stroke (tipo Lucide, hereda currentColor) vs. raw (con sus
propios fills).
Pauta para SVGs estilo Lucide
viewBox="0 0 24 24", fill="none", trazos con stroke — así heredan color y grosor como los de Lucide.Íconos armados en runtime
El escáner lee el texto de tus archivos: si el nombre del ícono sólo existe en tiempo de ejecución (se arma
con una variable, o viene de una API), no lo ve y el ícono queda fuera del sprite. Para esos casos, se listan
en la opción icons de taisho.config.ts:
// taisho.config.ts
export default {
// ...
icons: ['check', 'x', 'triangle-alert'],
};Es la excepción, no el camino normal: un nombre escrito completo en el href no hace
falta declararlo. Un nombre que no existe en Lucide ni en tus íconos custom corta el taisho generate.
El sprite desde JS, con Vite
Con el plugin taisho() de Vite, el sprite queda en taisho/taisho.icons.svg, fuera de public/. Las referencias que
se escriben en un HTML las reescribe vite build con el nombre final del archivo (con hash).
Las que se arman en JS con un texto, como '/taisho/taisho.icons.svg#ts-moon', Vite no las ve:
en producción apuntan a un archivo que no existe. Se importa el sprite y se usa la ruta que devuelve:
import sprite from '../taisho/taisho.icons.svg?no-inline';
boton.innerHTML = `<svg class="ts icon icon-20" aria-hidden="true"><use href="${sprite}#ts-moon"></use></svg>`;?no-inline pide el archivo: sin él, Vite incrusta los archivos chicos en el JS como data: y no queda un archivo que referenciar. El ícono entra al sprite porque el
escáner lee el href="…#ts-moon" de ese archivo, siempre que esté cubierto por content.