Änderungen

Aktuell

Behoben

• renderToStream() konnte das Zusammenfüge-Skript vor dem verzögerten Block ausgeben, wenn zwei Blöcke im selben Tick fertig wurden. Gemeldet von @hal-moravec mit einer minimalen Reproduktion, wodurch der Fix zwei Zeilen lang wurde.
• Der Filter date lieferte im nicht strikten Modus bei null Invalid Date statt eines leeren Strings.
• Sourcemaps zeigten eine Zeile zu hoch, wenn die erste Zeile eines Templates ein Kommentar war.

Geändert

• Kompilierfehler zeigen jetzt zwei Zeilen Kontext statt einer. Keine API-Änderung.

Neu

• Streaming-Partials. {{#defer}} darf jetzt auch in einem eingebundenen Partial stehen, nicht nur auf der obersten Ebene des Einstiegs-Templates. Das war die meistgewünschte Funktion 2025 und brauchte drei Anläufe.
• RenderOptions.onError — ersetzt einen fehlschlagenden Block durch einen Ersatz-String, statt den Stream zu zerstören.
• verso explain --tree gibt den Knotenbaum aus.

Behoben

• Die Auflösung von Partials folgt Symlinks jetzt unter Linux und macOS einheitlich.
• Der Filter unique behielt das letzte statt des ersten Vorkommens.

Neu

• Operator in in Bedingungen: {{#if role in allowedRoles}}.
• --sourcemap für verso build.
• Browser-Build als verso/browser veröffentlicht, 7,4 kB mit gzip.

Performance

• Konstantenfaltung statischer Attributwerte. Templates, die überwiegend aus Markup bestehen, werden 30–40 % kleiner kompiliert.
• Escaping nutzt jetzt einen einzigen Zeichendurchlauf; eine Tabelle mit 2 000 Zeilen rendert in 1,9 statt 3,1 ms.

Inkompatibel

Geändert

• Leere Arrays sind jetzt falsy. {{#if items}} nimmt bei [] nicht mehr den wahren Zweig. Das war die größte einzelne Quelle von Fehlerberichten in 2.x.
• Escaping berücksichtigt den Kontext. Werte in den Attributen href, src und style werden für diese Kontexte escaped. Templates, die manuell doppelt escaped haben, zeigen jetzt literale Entities — der Codemod findet sie.
• compile() ist synchron; die asynchrone Variante ist nach compileFile() umgezogen.
• Mindestens Node.js 18. Node 16 hat im September 2023 das Ende seiner Lebensdauer erreicht.

Entfernt

• {{#with}}, abgekündigt seit 2.6. Verwenden Sie {{> partial with value}}.
• Implizite Suche nach verso.config.js. Geben Sie --config ausdrücklich an.

Wartung

Behoben

• Backport des Streaming-Fixes aus 3.2.1.

Die 2.x-Linie bekommt Sicherheits- und Korrektheitsfixes bis 30. Juni 2027. Neue Funktionen werden nicht zurückportiert.

Abgelöst

Neu

• Layouts: {{#extends}}, {{#slot}} und {{#fill}}.
• Befehl verso check.

Abgekündigt

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

Historisch

Erstes öffentliches Release. Herausgelöst aus einer Static-Site-Pipeline, in der es etwa acht Monate lang eine einzelne 300-Zeilen-Datei war. Interpolation, #if, #each, Partials und sechs Filter.