Tokens en tres capas: primitivo → semántico → componente
Tu tokens.css ya separa dos capas: --ba-blue, --fx-glow… (primitivos) y --ink, --panel, --accent… dentro de cada tema (semánticos). La tercera capa, la del componente, es la que hace que cambiar un botón no obligue a tocar el tema.
La idea nueva: cada capa solo mira a la de debajo. Un tema cambia la capa semántica. Una marca cambia los primitivos. Una variante de componente cambia sus propias variables. El HTML de las cuatro columnas es idéntico: solo cambian dos clases en el contenedor.
--p-azul-700→--s-accion→--b-fondo→background
BA · claro
BA · oscuro
Otra marca · claro
Otra marca · oscuro
Primitivo
nombre por lo que es: --ba-blue, --p-azul-700. Nunca se usa en un componente.
Semántico
nombre por la función: --accent, --ink, --s-peligro. Lo cambia el tema.
Componente
nombre por la pieza: --b-fondo, --kpi-color. Lo cambian las variantes y los estados.
El CSS
Ejercicios
Busca en componentes.css y en los layouts usos directos de primitivos (var(--ba-blue), var(--fx-glow)) y decide qué token semántico debería ir en su lugar.
Añade el estado :disabled al botón cambiando solo --b-*.
Crea una tercera marca con solo ocho primitivos y comprueba que los dos temas funcionan sin tocar nada más.