Historique des versions

Actuelle

Corrigé

• renderToStream() pouvait émettre le script d’assemblage avant le bloc différé quand deux blocs se résolvaient dans le même tick. Signalé par @hal-moravec avec une reproduction minimale, ce qui a réduit le correctif à deux lignes.
• Le filtre date renvoyait Invalid Date au lieu d’une chaîne vide pour une entrée null en mode non strict.
• Les sourcemaps pointaient une ligne trop haut pour les templates dont la première ligne était un commentaire.

Modifié

• Les erreurs de compilation affichent maintenant deux lignes de contexte au lieu d’une. Aucun changement d’API.

Ajouté

• Partials en streaming. {{#defer}} peut désormais figurer dans un partial inclus, et plus seulement au premier niveau du template d’entrée. C’était la fonctionnalité la plus demandée de 2025, et il a fallu trois tentatives.
• RenderOptions.onError — remplace un bloc en échec par une chaîne de secours au lieu de détruire le flux.
• verso explain --tree affiche l’arbre des nœuds.

Corrigé

• La résolution des partials suit désormais les liens symboliques de la même façon sous Linux et macOS.
• Le filtre unique conservait la dernière occurrence au lieu de la première.

Ajouté

• Opérateur in dans les conditions : {{#if role in allowedRoles}}.
• --sourcemap pour verso build.
• Version navigateur publiée sous verso/browser, 7,4 ko compressée.

Performances

• Repliement des valeurs d’attributs statiques. Les templates surtout composés de balisage se compilent 30 à 40 % plus petits.
• L’échappement se fait désormais en un seul parcours des caractères ; le rendu d’un tableau de 2 000 lignes est passé de 3,1 à 1,9 ms.

Incompatible

Modifié

• Les tableaux vides sont désormais faux. {{#if items}} ne prend plus la branche vraie pour []. C’était la principale source de rapports de bug sur toute la 2.x.
• L’échappement tient compte du contexte. Les valeurs des attributs href, src et style sont échappées pour ces contextes. Les templates qui échappaient deux fois à la main afficheront des entités littérales — le codemod les repère.
• compile() est synchrone ; la forme asynchrone est passée à compileFile().
• Node.js 18 est le minimum. Node 16 est arrivé en fin de vie en septembre 2023.

Supprimé

• {{#with}}, déprécié depuis la 2.6. Utilisez {{> partial with value}}.
• Recherche implicite de verso.config.js. Passez --config explicitement.

Maintenance

Corrigé

• Rétroportage du correctif de streaming de la 3.2.1.

La branche 2.x reçoit des correctifs de sécurité et de justesse jusqu’au 30 juin 2027. Aucune nouvelle fonctionnalité ne sera rétroportée.

Remplacée

Ajouté

• Mises en page : {{#extends}}, {{#slot}} et {{#fill}}.
• Commande verso check.

Déprécié

• {{#with}} — supprimé en 3.0.

Historique

Première version publique. Extraite d’une chaîne de génération de site statique où elle tenait en un seul fichier de 300 lignes depuis environ huit mois. Interpolation, #if, #each, partials et six filtres.