Skill: Token Build
Transforme a fonte da verdade dos tokens DTCG em saídas prontas para plataforma. Os tokens são escritos uma vez; cada saída de plataforma é gerada.
Etapas
- Leia
workflows/token-build.md(arquitetura, opções de ferramentas, regras de resolução, alvos de saída, CI). - Escolha a ferramenta: Style Dictionary (multiplataforma, o padrão), Tokens Studio (tokens do Figma — combina com
figma-integration), exportação W3C DTCG ou um script personalizado pequeno (modelo emscripts/validate_tokens.py). - Respeite as regras de resolução: resolva aliases para valores finais por plataforma; exponha tokens semânticos e de componente (primitivos permanecem internos); emita base + sobreposições de escuro/marca/densidade (
tokens/theming.json) apenas como deltas; formate por$type. - Gere o(s) alvo(s) solicitado(s): variáveis CSS
:root,@themedo Tailwind v4, JS/TS tipado, Asset Catalog iOS +Color.DS/Spacing,colors.xmldo Android/tema Compose. - Configure CI: em alteração de
tokens/*.json, executescripts/validate_tokens.py, regenere, falhe se artefatos comissionados estiverem desatualizados; bloqueie cores comscripts/contrast.py.
Verificação (definição de pronto)
python3 scripts/validate_tokens.pypassa (sem aliases não resolvidos).- Regenerar não produz diff em relação aos artefatos comissionados.
- Saídas de escuro/marca/densidade contêm apenas deltas, não duplicatas completas.