Compétence : Token Build
Transformer la source de vérité des tokens DTCG en livrables prêts pour chaque plateforme. Les tokens sont rédigés une fois ; chaque sortie de plateforme est générée.
Étapes
- Lire
workflows/token-build.md(architecture, options d'outils, règles de résolution, cibles de sortie, CI). - Choisir l'outil : Style Dictionary (multi-plateforme, par défaut), Tokens Studio (tokens issus de Figma — s'utilise avec
figma-integration), export W3C DTCG, ou un petit script personnalisé (modèle surscripts/validate_tokens.py). - Respecter les règles de résolution : résoudre les alias en valeurs finales par plateforme ; exposer les tokens sémantiques et de composants (les primitifs restent internes) ; émettre les surcharges dark/brand/density (
tokens/theming.json) uniquement sous forme de décalques ; formater par$type. - Générer les cible(s) demandée(s) : variables CSS
:root, Tailwind v4@theme, JS/TS typé, catalogue d'actifs iOS +Color.DS/Spacing, Androidcolors.xml/thème Compose. - Mettre en place le CI : lors d'un changement sur
tokens/*.json, exécuterscripts/validate_tokens.py, régénérer, échouer si les artefacts commités sont périmés ; contrôler les couleurs avecscripts/contrast.py.
Vérification (critère de complétion)
python3 scripts/validate_tokens.pyréussit (aucun alias non résolu).- La régénération ne produit aucune différence par rapport aux artefacts commités.
- Les sorties dark/brand/density contiennent uniquement des décalques, pas de doublons complets.