HeEx Formatter

Le HeEx Formatter accepte une chaîne brute de template HeEx et un ensemble optionnel de préférences de formatage. Il normalise l’indentation, enveloppe les attributs longs et assure des espaces finaux et des sauts de ligne cohérents. Il comprend les expressions Elixir dans les blocs <%= %> et ne modifie pas la sémantique d’exécution. Le formatter est conçu pour les templates de vues Phoenix et les composants LiveView; il aide les équipes à adopter un style commun dans le code des templates. Il est déterministe et idempotent: formater la même entrée à plusieurs reprises donne une sortie identique.
Sous le capot, l’outil effectue un réflow guidé par les tokens: il tokenise le template, suit les balises, les attributs et l’Elixir intégré, calcule les sauts de ligne optimaux selon la longueur maximale de ligne et reconstruit le code avec une indentation normalisée. Les commentaires, les attributs de type HTML et les notations telles que assigns et slots LiveView restent intacts. Des options avancées permettent de régler la taille des indentations (2 ou 4 espaces), une longueur de ligne maximale préférée et la stratégie d’enveloppement des attributs (enveloppant si nécessaire vs alignement des attributs).
Bénéficiaires: les développeurs Elixir, les relecteurs et les équipes qui entretiennent des applications Phoenix gagnent du temps de revue, une esthétique cohérente et des revues de diff plus faciles. Valeur unique: formatage spécifique au domaine pour les templates HeEx, support des constructions LiveView et une intégration CI ou Pre-Commit aisée. Cas d’usage: standardiser le style avant les PR, intégrer de nouveaux contributeurs et imposer une norme de code au niveau de l’équipe sans modifications manuelles.