Audit des jetons de composants
Cet audit déplace les décisions visuelles répétées vers des jetons avant que le travail sur les composants ne les rende plus difficiles à modifier de façon cohérente. Il s’agit d’un registre de migration, et non d’une permission de transformer chaque mesure locale en jeton.
Migrations terminées#
| Décision répétée | Jeton ou rôle sémantique | Consommateurs |
|---|---|---|
| Couleurs de surface, de texte et de séparateur | color.paper, color.ink, color.line, échelle neutre | En-tête, navigation, pagination, contrôles de code et de clavier |
| Traitement d’état | status.note, status.success, status.important, status.warning, status.danger, status.archived | Encadrés Markdown et étiquettes de version |
| Traitement des coins | radius.*, diagram.radius | Code, encadrés, contrôles clavier, surfaces d’image et de diagramme |
| Élévation | shadow.panel, shadow.overlay, diagram.shadow | Aperçus, sous-menus, pagination, code, contrôles clavier, cartes de cartes mentales |
| Mouvement | duration.fast, duration.standard, easing.standard | Transitions d’aperçu de carte mentale et futurs composants interactifs |
| Géométrie de composant | component.theme-toggle.* | Sélecteur de thème partagé dans les en-têtes des deux sites |
Règle d’audit#
Déplacez une valeur vers un jeton lorsqu’elle nomme un rôle réutilisable, apparaît dans plus d’un composant ou doit rester alignée entre les sites et les diagrammes exportés. Gardez la géométrie locale dans CSS lorsqu’elle explique seulement une relation de mise en page.
Le vérificateur de jetons refuse les littéraux de couleur bruts et les utilitaires de palette Tailwind non gouvernés dans assets/css/site.css. Les migrations de gabarits devraient préférer un utilitaire sémantique existant ou une classe de composant nommée; elles ne doivent pas introduire un nouveau littéral seulement pour éviter de modifier la source de jetons.