Wijzigingen

Actueel

Opgelost

• renderToStream() kon het samenvoegscript vóór het uitgestelde blok uitsturen als twee blokken in dezelfde tick klaar waren. Gemeld door @hal-moravec met een minimale reproductie, waardoor de fix twee regels lang werd.
• Het filter date gaf in niet-strikte modus Invalid Date terug in plaats van een lege string bij null.
• Sourcemaps wezen één regel te hoog bij templates waarvan de eerste regel commentaar was.

Gewijzigd

• Compileerfouten tonen nu twee regels context in plaats van één. Geen API-wijziging.

Toegevoegd

• Streaming partials. {{#defer}} mag nu ook in een ingevoegd partial staan, niet alleen op het hoogste niveau van het hoofdtemplate. Dit was de meest gevraagde functie van 2025 en kostte drie pogingen.
• RenderOptions.onError — vervang een falend blok door een reservestring in plaats van de stream te vernietigen.
• verso explain --tree toont de knooppuntenboom.

Opgelost

• Het oplossen van partials volgt symlinks nu consequent op Linux en macOS.
• Het filter unique bewaarde het laatste voorkomen in plaats van het eerste.

Toegevoegd

• Operator in in voorwaarden: {{#if role in allowedRoles}}.
• --sourcemap voor verso build.
• Browserbuild gepubliceerd als verso/browser, 7,4 kB met gzip.

Prestaties

• Constant folding van statische attribuutwaarden. Templates die vooral uit markup bestaan, compileren 30–40% kleiner.
• Escaping gebruikt nu één doorloop over de tekens; een tabel van 2 000 rijen renderen ging van 3,1 naar 1,9 ms.

Brekend

Gewijzigd

• Lege arrays zijn nu falsy. {{#if items}} neemt bij [] niet langer de ware tak. Dit was de grootste afzonderlijke bron van bugmeldingen in 2.x.
• Escaping houdt rekening met de context. Waarden in de attributen href, src en style worden voor die contexten geëscapet. Templates die handmatig dubbel escapeten, tonen nu letterlijke entiteiten — de codemod vindt ze.
• compile() is synchroon; de asynchrone vorm is verhuisd naar compileFile().
• Node.js 18 is het minimum. Node 16 bereikte in september 2023 het einde van zijn levensduur.

Verwijderd

• {{#with}}, uitgefaseerd sinds 2.6. Gebruik {{> partial with value}}.
• Impliciet zoeken naar verso.config.js. Geef --config expliciet op.

Onderhoud

Opgelost

• Backport van de streamingfix uit 3.2.1.

De 2.x-lijn krijgt beveiligings- en correctheidsfixes tot 30 juni 2027. Nieuwe functies worden niet teruggeport.

Vervangen

Toegevoegd

• Layouts: {{#extends}}, {{#slot}} en {{#fill}}.
• Commando verso check.

Uitgefaseerd

• {{#with}} — verwijderd in 3.0.

Historisch

Eerste publieke release. Losgemaakt uit een pipeline voor statische sites, waarin het ongeveer acht maanden één bestand van 300 regels was. Interpolatie, #if, #each, partials en zes filters.