Tokens para diseño
El vocabulario de tokens de TaishoDS Core explicado para diseño, y cómo llevarlos a Figma. Esta página es el contrato compartido entre el código y el archivo de diseño.
Cómo se lee un shade
Cada familia de color tiene 10 shades, de 100 (más claro) a 1000 (más oscuro) en modo claro. No se eligen a
mano: el motor los genera en OKLCH a partir de una sola semilla hex, y calcula la rampa
espejada para modo oscuro.
| Shade | Para qué se usa |
|---|---|
| 500 | El color base de la familia. Es el que representa a la marca. |
| 100 / 200 | Fondos y bordes suaves (chips, estados sutiles). |
| 700 | Texto sobre superficies claras. --ts-color-subtle usa gray-700 justamente porque cumple AA. |
El contrato -contrast
Cada shade cromático viene con un gemelo -contrast:
el color de texto/ícono que el motor garantiza legible sobre ese shade. No hay que
elegirlo — ya está resuelto y verificado contra WCAG AA en los tests.
/* Fondo brand + su texto garantizado */
background: var(--color-brand-500);
color: var(--color-brand-500-contrast);| Familias | ¿Tiene -contrast? |
|---|---|
| brand, brand-secondary, accent | Sí — los 10 shades |
| success, warning, info, danger | Sí — los 10 shades |
| gray, grayAlpha, background, overlay | No (son superficies, no fondos de marca) |
Estados y densidad
Los cuatro estados (success, warning, info, danger) no son un color suelto: cada uno trae un
juego de sub-tokens listo para armar una pieza completa.
--ts-color-danger /* el color base (shade 500) */
--ts-color-danger-bg /* fondo suave (shade 100) */
--ts-color-danger-border /* borde (shade 200) */
--ts-color-danger-text /* texto sobre fondo claro (shade 700) */
--ts-color-danger-contrast /* texto sobre el color base */Densidad: alturas de control y paddings existen en
dos juegos — comfortable (default) y compact. Se cambian de una, en runtime, sin
recompilar. Al diseñar, se define la pantalla en comfortable y se comprueba que respire en compact.
Llevar los tokens a Figma
El motor exporta los tokens en formato DTCG (el estándar del Design Tokens Community Group), generados de la misma fuente que el CSS — no hay una lista paralela que se pueda desincronizar. Así se mapean a Figma:
| En el JSON (DTCG) | En Figma |
|---|---|
| Grupo raíz (color, sizing, spacing…) | Colección de Variables |
| $value | Valor del modo light |
| $extensions["com.taishods"].dark | Valor del modo dark |
| $extensions["com.taishods"].hex | Valor de la Variable de color (Figma no lee OKLCH) |
| Alias {color.gray.1000} | Alias a otra Variable |
| $type: dimension { value, unit } | Variable FLOAT (px) |
| $type: shadow | Effect Style (Figma no soporta Variables de sombra) |
hex equivalente en $extensions:
ese es el que hay que importar. El OKLCH sigue siendo la fuente de verdad del código.Tokens del tema taisho (el que usa esta
documentación).