Saltar al contenido

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}.

Gray
100
200
300
400
500
600
700
800
900
1000
Brand
100
200
300
400
500
600
700
800
900
1000
Brand secondary
100
200
300
400
500
600
700
800
900
1000
Accent
100
200
300
400
500
600
700
800
900
1000
Success
100
200
300
400
500
600
700
800
900
1000
Warning
100
200
300
400
500
600
700
800
900
1000
Info
100
200
300
400
500
600
700
800
900
1000
Danger
100
200
300
400
500
600
700
800
900
1000

Color de texto

heading --ts-color-heading
copy --ts-color-copy
subtle --ts-color-subtle
label --ts-color-label

Estados semánticos

success Texto de ejemplo
warning Texto de ejemplo
info Texto de ejemplo
danger Texto de ejemplo

Tipografía

Tamaños

Aa 10 · 10px
Aa 12 · 12px
Aa 14 · 14px
Aa 16 · 16px
Aa 18 · 18px
Aa 20 · 20px
Aa 24 · clamp(var(--ts-sizing-20), 2vw + 1rem, var(--ts-sizing-24))
Aa 28 · clamp(var(--ts-sizing-24), 2.5vw + 1rem, var(--ts-sizing-28))
Aa 32 · clamp(var(--ts-sizing-24), 3vw + 1rem, var(--ts-sizing-32))
Aa 36 · clamp(var(--ts-sizing-28), 3.5vw + 1rem, var(--ts-sizing-36))
Aa 40 · clamp(var(--ts-sizing-32), 4vw + 1rem, var(--ts-sizing-40))
Aa 48 · clamp(var(--ts-sizing-36), 5vw + 1rem, var(--ts-sizing-48))
Aa 60 · clamp(var(--ts-sizing-40), 6vw + 1rem, var(--ts-sizing-60))
Aa 72 · clamp(var(--ts-sizing-48), 7.5vw + 1rem, var(--ts-sizing-72))

Pesos

thin 100
extralight 200
light 300
normal 400
medium 500
semibold 600
bold 700
extrabold 800
black 900

Espaciado

Escala semántica compartida por gaps y paddings (gap-*, p-*). Es la que redefine el density mode.

none · 0px
quarter · 6px
half · 12px
base · 24px
section · 32px
double · 48px

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.

none
xs
sm
md
lg
xl
2xl
3xl
full

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.

1 1px
2 2px
3 3px
4 4px

Desenfoque

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.

none 0px
sm 4px
md 8px
lg 16px
xl 48px

Capas (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.

base 0
raised 1
pinned 2
handle 3
sticky 10
glow 30
nav 30
banner 40
nav-menu 40
dropdown 50
toast 50
overlay 50
dialog 51

Opacidad

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.

0 0
30 0.3
40 0.4
50 0.5
60 0.6
70 0.7
75 0.75
80 0.8
90 0.9
100 1
muted 0.6

Screens

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.

sm 640px
md 768px
lg 1024px
xl 1280px

Contraste

--ts-contrast-threshold es la luminosidad OKLCH bajo la que el texto de un Badge custom pasa a blanco (clave contrastThreshold).

threshold 0.56

Sombras

sm
md
lg
xl

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.

instant 100ms
fast 150ms
base 200ms
slow 300ms
slower 500ms
spin 600ms
loop-fast 1200ms
loop-base 1600ms
loop-slow 4000ms
loop infinite
standard ease
in cubic-bezier(0.4, 0, 1, 1)
out cubic-bezier(0.22, 1, 0.36, 1)
spring cubic-bezier(0.16, 1.3, 0.3, 1)
in-out ease-in-out
linear linear

Tamañ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 · 48px24px · 32px · 40px · 48px
--ts-button-px-{xs|sm|md|lg}6px · 10px · 14px · 20px6px · 10px · 14px · 20px
--ts-field-px-{sm|md|lg}10px · 12px · 14px10px · 12px · 14px
--ts-select-pr-{sm|md|lg}32px · 36px · 40px32px · 36px · 40px
--ts-textarea-px-{sm|md|lg}10px · 12px · 14px10px · 12px · 14px
--ts-textarea-py-{sm|md|lg}8px · 10px · 12px8px · 10px · 12px
--ts-badge-h-{sm|md|lg}20px · 24px · 28px20px · 24px · 28px
--ts-badge-px-{sm|md|lg}8px · 10px · 12px8px · 10px · 12px
--ts-tag-h-{sm|md|lg}20px · 24px · 28px20px · 24px · 28px
--ts-tag-px-{sm|md|lg}6px · 8px · 10px6px · 8px · 10px
--ts-control-box-{sm|md|lg}14px · 16px · 20px14px · 16px · 20px
--ts-radio-dot-{sm|md|lg}6px · 8px · 10px6px · 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}-contrast70 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}-contrast4 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: 0pxLa 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.

--font-sans "Geist Sans", "Geist Sans Fallback", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"
--font-mono "Geist Mono", "Geist Mono Fallback", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace
--ts-color-btn var(--color-gray-1000)
--ts-color-highlight light-dark(var(--color-gray-100), var(--color-gray-200))
--ts-color-highlight-strong light-dark(var(--color-gray-200), var(--color-gray-300))
--ts-color-toggle-thumb light-dark(var(--color-background-100), var(--color-gray-1000))
--ts-color-toggle-icon light-dark(var(--color-gray-1000), var(--color-gray-100))
--ts-corner-shape round
--ts-focus-ring-color light-dark(var(--color-grayAlpha-700), var(--color-grayAlpha-600))
--ts-spotlight-color 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.

svelte
<!-- 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>