Tokens
Los valores de diseño de los que sale todo el sistema, los mismos que produce tu taisho.config.ts. Cada muestra usa la CSS var en vivo, así que sigue el modo
claro/oscuro del sitio.
Color
Cada familia tiene 10 shades (100 claro → 1000 oscuro) generados en OKLCH desde una
semilla. Se consume con bg-{familia}-{shade} o la var --color-{familia}-{shade}.
Color de texto
--ts-color-heading--ts-color-copy--ts-color-subtle--ts-color-labelEstados semánticos
Tipografía
Tamaños
10 · 10px12 · 12px14 · 14px16 · 16px18 · 18px20 · 20px24 · clamp(var(--ts-sizing-20), 2vw + 1rem, var(--ts-sizing-24))28 · clamp(var(--ts-sizing-24), 2.5vw + 1rem, var(--ts-sizing-28))32 · clamp(var(--ts-sizing-24), 3vw + 1rem, var(--ts-sizing-32))36 · clamp(var(--ts-sizing-28), 3.5vw + 1rem, var(--ts-sizing-36))40 · clamp(var(--ts-sizing-32), 4vw + 1rem, var(--ts-sizing-40))48 · clamp(var(--ts-sizing-36), 5vw + 1rem, var(--ts-sizing-48))60 · clamp(var(--ts-sizing-40), 6vw + 1rem, var(--ts-sizing-60))72 · clamp(var(--ts-sizing-48), 7.5vw + 1rem, var(--ts-sizing-72))Pesos
100200300400500600700800900Espaciado
Escala semántica compartida por gaps y paddings (gap-*, p-*). Es la que redefine el density mode.
Radios de borde
--ts-corner-shape es la forma de las esquinas: vale round por
defecto y squircle si el tema pide cornerShape: 'squircle'. Con
squircle (sólo donde el navegador soporta corner-shape) cada radio sube un paso en la
escala: xs toma el valor de sm, y así hasta 2xl. 3xl, none y full no se mueven.
Ancho de borde y anillo
Una sola escala para todo trazo: bordes, anillos
(box-shadow: 0 0 0 N), contornos de foco y bandas de acento. 1 es el hairline de los materiales; 2 el énfasis (tab activo, anillo de avatar); 3 el contorno de outline-*; 4 el halo de foco y outline-4-transparent. Se sobreescribe desde el tema con
la clave borderWidths.
1px2px3px4pxDesenfoque
Para fondos de vidrio y capas decorativas (backdrop-blur-*, blur-*). none existe para poder
transicionar desde o hacia un blur: el telón de Modal y Drawer va de none a sm. Clave de tema: blurs.
0px4px8px16px48pxCapas (z-index)
Escala semántica: cada rol tiene su capa y los componentes consumen el rol
(z-index: var(--ts-z-dropdown)), no un número suelto. El orden
de apilamiento es el orden de los valores. Los escalones numéricos z-0 … z-50 siguen disponibles para
el uso libre. Clave de tema: zIndex.
0123103030404050505051Opacidad
Escalones para opacity-* y un rol semántico: muted es la opacidad de reposo de lo secundario que se enciende al
hover (botón de cerrar de Tag y Banner). Clave de tema: opacities.
00.30.40.50.60.70.750.80.910.6Screens
Anchos de viewport de referencia. max-w-screen-* los lee como
variable. Los cortes de NavBar, Sidebar y Table responsive usan estos mismos valores, pero una
condición @container o @media no puede leer
una variable: el generador los toma de la escala por defecto, así que un override desde el tema
(clave screens) mueve las utilidades y no esos cortes.
640px768px1024px1280pxContraste
--ts-contrast-threshold es la luminosidad OKLCH bajo la que el texto de
un Badge custom pasa a blanco (clave contrastThreshold).
0.56Sombras
Motion
Duraciones y curvas de toda transición CSS del sistema
(duration-*, ease-*). Con prefers-reduced-motion: reduce las duraciones de transición
bajan a 1ms desde los tokens, y --ts-iterations-loop pasa a 0: el skeleton, la barra indeterminada y el halo del Badge quedan quietos. Los demás
loops (spin, loop-*) siguen. Más en Motion.
100ms150ms200ms300ms500ms600ms1200ms1600ms4000msinfiniteeasecubic-bezier(0.4, 0, 1, 1)cubic-bezier(0.22, 1, 0.36, 1)cubic-bezier(0.16, 1.3, 0.3, 1)ease-in-outlinearTamaños de control
Alto, padding y tamaño de caja de cada control en sus tres tamaños
(sm, md, lg). Son
los que redefine compact: ahí los controles se
compactan sin tocar los componentes. Cada fila es un patrón que cubre sus tres tamaños; los
valores van en el orden sm · md · lg.
| Patrón | Cómodo | Compacto |
|---|---|---|
--ts-control-h-{xs|sm|md|lg} | 24px · 32px · 40px · 48px | 24px · 32px · 40px · 48px |
--ts-button-px-{xs|sm|md|lg} | 6px · 10px · 14px · 20px | 6px · 10px · 14px · 20px |
--ts-field-px-{sm|md|lg} | 10px · 12px · 14px | 10px · 12px · 14px |
--ts-select-pr-{sm|md|lg} | 32px · 36px · 40px | 32px · 36px · 40px |
--ts-textarea-px-{sm|md|lg} | 10px · 12px · 14px | 10px · 12px · 14px |
--ts-textarea-py-{sm|md|lg} | 8px · 10px · 12px | 8px · 10px · 12px |
--ts-badge-h-{sm|md|lg} | 20px · 24px · 28px | 20px · 24px · 28px |
--ts-badge-px-{sm|md|lg} | 8px · 10px · 12px | 8px · 10px · 12px |
--ts-tag-h-{sm|md|lg} | 20px · 24px · 28px | 20px · 24px · 28px |
--ts-tag-px-{sm|md|lg} | 6px · 8px · 10px | 6px · 8px · 10px |
--ts-control-box-{sm|md|lg} | 14px · 16px · 20px | 14px · 16px · 20px |
--ts-radio-dot-{sm|md|lg} | 6px · 8px · 10px | 6px · 8px · 10px |
Familias de tokens
Estas propiedades vienen en familias grandes, así que se documentan como patrón con su
cantidad y un ejemplo en vez de una por una. Los fondos y los telones tienen dos niveles
cada uno, y -contrast es el texto que se lee bien sobre ese color.
| Patrón | Cantidad | Ejemplo | Para qué |
|---|---|---|---|
--color-{paleta}-{shade}-contrast | 70 tokens | --color-brand-100-contrast: var(--color-gray-1000) | Color de texto legible sobre ese shade (blanco o gris 1000, según el contraste). Es el que usa ts-color-{paleta}-{shade}-contrast. |
--color-{paleta}-solid[-hover|-active][-contrast] | 48 tokens | --color-brand-solid: var(--color-brand-600) | El relleno sólido de cada marca y estado (Button, Checkbox, Radio y Toggle primarios), su hover y su active, y el texto legible sobre cada uno. Es el paso de la semilla si es más oscuro que 600; si no, el 600. |
--ts-color-{estado}-contrast | 4 tokens | --ts-color-success-contrast: var(--color-success-500-contrast) | Texto legible sobre el color sólido de cada estado (success, warning, info, danger). |
--ts-sizing-{n} | 36 tokens | --ts-sizing-0: 0px | La escala en píxeles de la que salen ts-w-{n}, ts-h-{n}, ts-size-{n} y la tipografía. {n} es la cantidad de px. |
--color-grayAlpha-{shade} | 10 tokens | --color-grayAlpha-100: light-dark(oklch(0 0 0 / 0.05), oklch(1 0 0 / 0.05)) | Gris translúcido (negro en claro, blanco en oscuro) para superficies que dejan ver lo de atrás. |
--color-{background|overlay}-{n} | 4 tokens | --color-background-100: light-dark(oklch(1 0 0), oklch(0.12 0 0)) | Fondos de página (background) y telones de Modal y Drawer (overlay); cada uno tiene dos niveles. |
Otros tokens
Las familias tipográficas (--font-sans, --font-mono), el color de fondo del botón sólido y el resplandor del
spotlight.
"Geist Sans", "Geist Sans Fallback", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji""Geist Mono", "Geist Mono Fallback", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospacevar(--color-gray-1000)light-dark(var(--color-gray-100), var(--color-gray-200))light-dark(var(--color-gray-200), var(--color-gray-300))light-dark(var(--color-background-100), var(--color-gray-1000))light-dark(var(--color-gray-1000), var(--color-gray-100))roundlight-dark(var(--color-grayAlpha-700), var(--color-grayAlpha-600))light-dark(var(--color-grayAlpha-100), var(--color-grayAlpha-200))Cómo consumir
Conviene preferir las utilidades semánticas del sistema y recurrir a las CSS vars solo para casos puntuales.
<!-- Utilidad semántica (recomendado) -->
<div class="ts bg-brand-500 p-base radius-lg gap-half">…</div>
<!-- CSS var directa (casos puntuales) -->
<div style="background: var(--color-brand-500); padding: var(--ts-space-base)">…</div>