Lunar Style CSS Compiler : notes de conception pour la validation des builds CSS

Conception d’un outil de build qui vérifie la détection des sources par Tailwind et l’usage de classes dynamiques, tout en contrôlant la taille du CSS et les régressions visuelles.

1. Vérifier d’abord les fonctions de build existantes

Ce document présente les notes de conception d’un outil de validation des builds CSS. Il ne revendique ni la sortie d’un compilateur distinct ni des chiffres de performance. Tailwind détecte les classes candidates dans les sources et génère les styles nécessaires. Il ne faut donc pas concevoir une optimisation en supposant que toutes les classes utilitaires CSS sont systématiquement incluses dans le bundle.

La détection des classes par Tailwind repose sur les chaînes présentes dans les sources. Elle n’équivaut pas à une analyse AST capable de comprendre le résultat de l’exécution du programme ; des classes assemblées dynamiquement peuvent donc ne pas être détectées. Vérifiez la configuration à l’aide de la documentation officielle sur la détection dans les sources.

2. Pipeline de validation

• Utiliser des noms de classe complets, repérables dans les sources, plutôt que des classes assemblées dynamiquement.
• Déclarer explicitement les chemins exclus de la détection par défaut, tels que les paquets d’interface partagés.
• Comparer les affichages adaptatifs, le mode sombre et les états hover, focus et disabled avant et après la suppression de CSS.
• Mesurer dans les mêmes conditions non seulement la taille du fichier original, mais aussi sa taille de transfert sous gzip ou Brotli.

3. Interpréter les résultats

Une diminution de la taille du CSS ne garantit pas que le LCP passe sous un seuil donné. Les images, les polices, la réponse du serveur et le chemin de rendu influencent également ce résultat. Comparez les temps de build et les indicateurs du navigateur après avoir consigné l’appareil, le cache, le réseau et le nombre d’exécutions.

Cette conception privilégie la documentation des paramètres modifiés et de procédures de mesure reproductibles, plutôt que l’annonce de taux de réduction ou de temps de traitement non vérifiés.