Skip to content

NOTES.md

Latest commit

 

History

History
75 lines (60 loc) · 2.47 KB

NOTES.md

File metadata and controls

75 lines (60 loc) · 2.47 KB
Raw

Notes

v2 changes

La v2 garde le sujet initial et renforce l'outil pour un usage plus realiste :

  • CLI plus robuste ;
  • packaging minimal ;
  • entree console installable ;
  • audit de design tokens JSON ;
  • rapports Markdown ;
  • tests plus nombreux ;
  • validation WCAG minimale documentee.

Ce qui a ete teste :

  • bibliotheque de calcul ;
  • parsing des couleurs ;
  • audit CSV ;
  • audit tokens ;
  • sortie Markdown ;
  • codes de sortie CLI ;
  • erreurs d'ecriture ;
  • commande python3 -m a11y_contrast ;
  • installation editable et entree a11y-contrast.

Ce qui reste hors perimetre :

  • CSS complet ;
  • variables CSS ;
  • alpha/compositing ;
  • APCA/WCAG 3 ;
  • inspection DOM ;
  • rendu navigateur ;
  • taille et poids de police reels.

Idees abandonnees

  • Detecteur local de secrets : utile, mais plus sensible et plus difficile a calibrer proprement dans une session courte.
  • Simulation SIR pedagogique : interessante, mais le risque de surinterpretation est plus fort si le modele reste tres simple.
  • Profileur generique de qualite CSV : utile, mais son perimetre peut devenir flou sans schema metier.

Hypotheses retenues

  • Les couleurs d'entree sont deja composees et opaques.
  • Les seuils exposes sont les seuils WCAG 2.x classiques pour contraste.
  • Un CSV simple avec colonnes foreground et background est un format suffisamment reutilisable pour une micro-contribution.
  • Le format tokens JSON v2 reste volontairement minimal : { "token.name": { "foreground": "#fff", "background": "#000" } }.

Observations non concluantes

  • Le benchmark local montre que le calcul est rapide dans cet environnement, mais il ne constitue pas une garantie de performance sur d'autres machines.
  • Les paires proches du seuil sont utiles pour detecter les erreurs de formule, mais un corpus externe plus large serait necessaire pour augmenter la confiance.
  • Le format Markdown est lisible pour une revue manuelle, mais il n'a pas ete teste dans un outil de design ou une plateforme CI precise.

Pistes futures

  • Ajouter une commande qui suggere automatiquement une couleur proche atteignant un seuil donne.
  • Ajouter des formats d'entree design tokens plus proches de Style Dictionary, Theo ou tokens W3C Design Tokens Community Group.
  • Ajouter une sortie HTML ou GitHub Step Summary.
  • Ajouter une comparaison contre un outil de reference externe sur un corpus plus large.
  • Ajouter une option stricte qui refuse les couleurs non normalisees si un projet veut imposer un style de tokens.