Habilidad: Compilación de Tokens
Convierte la fuente de verdad de tokens DTCG en salidas listas para cada plataforma. Los tokens se crean una vez; cada salida de plataforma se genera automáticamente.
Pasos
- Lee
workflows/token-build.md(arquitectura, opciones de herramientas, reglas de resolución, destinos de salida, CI). - Elige la herramienta: Style Dictionary (multiplataforma, la predeterminada), Tokens Studio (tokens de Figma — combinado con
figma-integration), exportación W3C DTCG, o un script personalizado pequeño (modelado enscripts/validate_tokens.py). - Respeta las reglas de resolución: resuelve alias a valores finales por plataforma; expone tokens semánticos y de componente (los primitivos se mantienen internos); emite sobreescrituras base + oscuro/marca/densidad (
tokens/theming.json) solo como deltas; formatea según$type. - Genera los destinos solicitados: variables CSS
:root, Tailwind v4@theme, JS/TS con tipos, Asset Catalog de iOS +Color.DS/Spacing,colors.xmlde Android/theme de Compose. - Conecta CI: al cambiar
tokens/*.json, ejecutascripts/validate_tokens.py, regenera y falla si los artefactos comprometidos están desactualizados; controla colores conscripts/contrast.py.
Verificación (definición de completado)
python3 scripts/validate_tokens.pypasa (sin alias sin resolver).- Regenerar no produce diferencias respecto a los artefactos comprometidos.
- Las salidas oscuro/marca/densidad contienen solo deltas, no duplicados completos.