@reportwright/cli 0.14.0-rc.1 → 0.14.0-rc.2

package/CHANGELOG.md

@@ -2,10 +2,20 @@
 
 All `@reportwright/*` packages (formerly `@pagewrightjs/*`) share one version. The versioning policy is in [CONTRIBUTING.md](CONTRIBUTING.md#versioning-semver).
 
+## 0.14.0-rc.2 — 2026-10-10 (release candidate)
+
+### Fixed (from the rc.1 release gate)
+- **Memory of a zebra table in `exportPdfStream`.** A detail row whose style reads `RowNumber()` (`backgroundColor: '=IIf(RowNumber() Mod 2 = 0, "#f3f4f6", "#ffffff")'`) was refused by the streaming planner ("detail expressions", in `r.why`) and rendered whole, so every page stayed in memory: ~3.5–8 KB a row, 558 MB–1 GB at 100,000 rows. It now streams (row styles may read `RowNumber()`, as row values could), and its pages are the whole render's (pixels, text). Peak RSS at 100,000 rows, probe `scripts/eng-probe.mjs`: plain 270 MB, zebra 1,056 → 287 MB, zebra with expression borders and formats 1,261 → 300 MB.
+- **Expression styles that give the same values share one style.** Each row's evaluated style was a new object, and the cell styles built on it a new cache entry per row (garbage V8 collected late: about 2× the peak RSS of a plain table and 2.5× its time). Rows whose expressions give the same plain values now share one frozen style (at most 64 per style), so a zebra table renders at about the plain table's speed (100,000 rows: 5.8 s → 2.1 s; plain 1.6 s). Reports without expression styles are byte-identical; the zebra reports' bytes change only because they now stream (same pages, pixels and text).
+- The zebra PDF stays larger than the plain one (100,000 rows: 7.4 MB against 3.5 MB): each cell's fill is drawn as a rectangle with its colour (`rg … re f`), as the whole render always drew it; there is no resource per row.
+
+### Docs
+- The engine README says when a streamed PDF's memory stays flat, and what "Page N of M" costs (a counting pass: about 1.5–1.8× the time, +10–60 MB at 50,000 rows).
+
 ## 0.14.0-rc.1 — 2026-10-10 (release candidate)
 
 ### Changed
-- **PDFs are written by `@reportwright/pdf`** (pinned `0.1.0-beta.5`, no dependencies of its own), the streaming PDF writer extracted from the engine. `exportPdfStream` (plain, PDF/A, PDF/UA-tagged, `parallel` workers) and `exportPdf` for reports of text (any font, shaped scripts), boxes, ellipses, lines and links go through it. Images, SVG paths, rounded boxes, form fields, encryption, signing (`prepare`), `save` options, and whole-model PDF/A and tagged files stay on pdf-lib for now.
+- **PDFs are written by `@reportwright/pdf`** (pinned `0.1.0-beta.9`, no dependencies of its own), the streaming PDF writer extracted from the engine. `exportPdfStream` (plain, PDF/A, PDF/UA-tagged, `parallel` workers) and `exportPdf` for reports of text (any font, shaped scripts), boxes, ellipses, lines and links go through it. Images, SVG paths, rounded boxes, form fields, encryption, signing (`prepare`), `save` options, and whole-model PDF/A and tagged files stay on pdf-lib for now.
 - **The bytes change; the content does not.** `scripts/writer-parity.mjs` exports every report of the gate corpus (the repository's reports, the streaming ledgers, the 54-report tester corpus) with both writers and requires pixel-identical pages (pdftoppm, 72 dpi, zero differing pixels), the same text per page, `qpdf --check` and veraPDF (PDF/A-2b, 2a, PDF/UA-1) passing, the same fonts (embedded, subset), links, outline, structure elements, form fields, attachments, metadata and page labels, and the same bytes on two runs. One accepted difference: right-to-left locale formats (ar-SA, he-IL) no longer carry their invisible bidi marks (U+200F…) in the extracted text, so a viewer copies "Page 1 of 1" instead of "1 of 1 Page"; the words and pixels are the same.
 - **`exportPdf` of a plain report no longer loads pdf-lib.** A report in embedded fonts (Inter, Noto) exports about twice as fast (one 300-row grouped table: ~110 ms → ~50 ms cold) and with 5–10 MB less memory; its file is about 5% larger (the font subset keeps glyph IDs, as the streaming writer always did).
 - The file ID of a streamed PDF without `id` is now a hash of its content (it was random): the same report and `creationDate` give the same bytes.

package/README.md

@@ -8,6 +8,12 @@
 
 The CLI carries [`@reportwright/engine`](https://github.com/MrArun005/reportwright/tree/main/packages/engine); fonts come from [`@reportwright/fonts`](https://github.com/MrArun005/reportwright/tree/main/packages/fonts).
 
+## Screenshots
+
+`pw render` output, page 1 (reports from the repository's `reports/`):
+
+<img src="https://raw.githubusercontent.com/MrArun005/reportwright/main/docs/screenshots/sales-by-region.png" alt="Grouped table" width="32%"> <img src="https://raw.githubusercontent.com/MrArun005/reportwright/main/docs/screenshots/loan-statement.png" alt="Loan statement" width="32%"> <img src="https://raw.githubusercontent.com/MrArun005/reportwright/main/docs/screenshots/tablix-showcase.png" alt="Pivot tables" width="32%">
+
 ## Install
 
 ```bash

package/dist/cli.mjs

@@ -18831,31 +18831,63 @@ function resolveStyle(layers, ctx) {
     }
   }
   if (allStatic) {
-    let map = CACHE;
+    let map2 = CACHE;
     for (const l of layers) {
       if (!l || typeof l !== "object") continue;
-      let next = map.get(l);
+      let next = map2.get(l);
       if (!next) {
         next = { map: /* @__PURE__ */ new WeakMap(), value: null };
-        map.set(l, next);
+        map2.set(l, next);
       }
       node3 = next;
-      map = next.map;
+      map2 = next.map;
     }
     if (node3?.value) return node3.value;
   }
   const out = {};
+  let key = allStatic ? null : "";
   for (const l of layers) {
     if (!l || typeof l !== "object") continue;
     for (const k in l) {
       const v = l[k];
       if (v === void 0) continue;
-      out[k] = isDynamic(v) ? safe(v, ctx) : v;
+      if (!isDynamic(v)) {
+        out[k] = v;
+        continue;
+      }
+      const x = out[k] = safe(v, ctx);
+      if (key === null) continue;
+      const t = typeof x;
+      if (t === "string") key += `${k}${JSON.stringify(x)},`;
+      else if (x == null || t === "boolean" || t === "number" && !Object.is(x, -0)) key += `${k}:${x},`;
+      else key = null;
+    }
+  }
+  if (allStatic) {
+    if (node3) node3.value = Object.freeze(out);
+    return out;
+  }
+  if (key === null) return out;
+  let map = CACHE;
+  for (const l of layers) {
+    if (!l || typeof l !== "object") continue;
+    let next = map.get(l);
+    if (!next) {
+      next = { map: /* @__PURE__ */ new WeakMap(), value: null };
+      map.set(l, next);
     }
+    node3 = next;
+    map = next.map;
   }
-  if (allStatic && node3) node3.value = Object.freeze(out);
+  if (!node3) return out;
+  const kept = node3.dyn ||= /* @__PURE__ */ new Map();
+  const hit = kept.get(key);
+  if (hit) return hit;
+  if (kept.size >= DYN_KEEP) return out;
+  kept.set(key, Object.freeze(out));
   return out;
 }
+var DYN_KEEP = 64;
 var CACHE = /* @__PURE__ */ new WeakMap();
 var DYN = /* @__PURE__ */ new WeakMap();
 function hasDynamic(l) {
@@ -31253,7 +31285,7 @@ function memorySorter(cmp) {
   };
 }
 var okValue = (v, o) => typeof v !== "string" || !isDynamic(v) || streamable(v, o);
-var okStyle = (st, d = 0) => !st || typeof st !== "object" || d > 8 || Object.values(st).every((v) => v && typeof v === "object" ? okStyle(v, d + 1) : okValue(v));
+var okStyle = (st, o, d = 0) => !st || typeof st !== "object" || d > 8 || Object.values(st).every((v) => v && typeof v === "object" ? okStyle(v, o, d + 1) : okValue(v, o));
 var isHidden = (h) => !(h == null || h === false || h === "");
 function foldOf(v) {
   if (typeof v !== "string" || !v.startsWith("=")) return null;
@@ -31314,8 +31346,9 @@ async function planStream(def0, opts) {
   for (const g of groups) if (g.parent || g.sortBy || g.collapsible && g.initiallyCollapsed || g.expandLevels != null || !okValue(g.expr)) return no2("group shape");
   const okRow = (row, { rowNumber = false, folds: folds2 = false } = {}) => {
     if (!row || isHidden(row.hidden) && row.hidden !== true) return false;
-    if (!okStyle(row.style)) return false;
-    return (Array.isArray(row.cells) ? row.cells : []).every((c) => !c || !c.item && !(Number(c.rowSpan) > 1) && !("raw" in c) && okStyle(c.style) && (okValue(c.value, { rowNumber }) || folds2 && foldOf(c.value)));
+    const so = opts.paged ? { rowNumber } : void 0;
+    if (!okStyle(row.style, so)) return false;
+    return (Array.isArray(row.cells) ? row.cells : []).every((c) => !c || !c.item && !(Number(c.rowSpan) > 1) && !("raw" in c) && okStyle(c.style, so) && (okValue(c.value, { rowNumber }) || folds2 && foldOf(c.value)));
   };
   if (!(item.detail || []).every((r) => okRow(r, { rowNumber: true }))) return no2("detail expressions");
   if (!(item.header || []).every((r) => okRow(r))) return no2("header expressions");
@@ -31829,7 +31862,7 @@ async function planPaged(def0, opts = {}) {
   const { def, parts } = await resolveReuse(def0, makeLoader(opts.loadReport, /* @__PURE__ */ new Map()), () => {
   }, opts.reportId ? [opts.reportId] : [], { items: 0 });
   if (parts) return no2("report parts");
-  const plan2 = await planStream(def, { ...opts, format: "xlsx" });
+  const plan2 = await planStream(def, { ...opts, format: "xlsx", paged: true });
   if (plan2.why !== void 0) return no2(plan2.why);
   if ((def.dataSets || []).length !== 1) return no2("more than one data set");
   let ds = def.dataSets[0];
@@ -33297,7 +33330,10 @@ stream
     literal(key, text2) {
       const F = fontOf(key);
       let out = "";
-      const L = F.lat ||= new Array(256);
+      const L = (
+        /** @type {any} */
+        F.lat ||= new Array(256)
+      );
       let i = 0;
       for (; i < text2.length; i++) {
         const c = text2.charCodeAt(i);
@@ -34241,7 +34277,8 @@ async function pdfOf(model, fontStore2, opt) {
       if (opt.subset && !fieldFonts.has(key) && !fontStore2.get(key)["OS/2"]?.fsType?.noSubsetting) {
         const cps = used.get(key) || /* @__PURE__ */ new Set([32]);
         try {
-          const sub = withPadding(await opt.subset(bytes, cps, glyphs ? { glyphs: glyphs.keys() } : void 0));
+          const sub = withPadding(await /** @type {any} */
+          opt.subset(bytes, cps, glyphs ? { glyphs: glyphs.keys() } : void 0));
           const f4 = fontkit.create(sub);
           for (const cp of cps) void f4.glyphForCodePoint(cp).advanceWidth;
           for (const id of glyphs?.keys() || []) void f4.getGlyph(id).advanceWidth;
@@ -34293,7 +34330,9 @@ async function pdfOf(model, fontStore2, opt) {
       if (why) return { img: null, why: `the PNG is not usable (${why})` };
       if (!local) return { img: await doc.embedPng(bytes) };
       const e2 = await PngEmbedder.for(bytes);
-      const size = src.length + 2 * ((e2.image.rgbChannel?.length || 0) + (e2.image.alphaChannel?.length || 0));
+      const size = src.length + 2 * /** @type {any} */
+      ((e2.image.rgbChannel?.length || 0) + /** @type {any} */
+      (e2.image.alphaChannel?.length || 0));
       if (size > PNG_CACHE_ENTRY) return { img: await doc.embedPng(bytes) };
       const entry = { e: e2, z: (
         /** @type {any[]} */
@@ -34364,6 +34403,7 @@ async function pdfOf(model, fontStore2, opt) {
       c.lineWidth(1);
       draw();
       const ops = (
+        /** @type {any} */
         /** @type {any} */
         p.getContentStream().operators
       );
@@ -36828,7 +36868,7 @@ var THEME = `${XML2}<a:theme xmlns:a="http://schemas.openxmlformats.org/drawingm
 // package.json
 var package_default = {
   name: "reportwright",
-  version: "0.14.0-rc.1",
+  version: "0.14.0-rc.2",
   license: "MIT",
   private: true,
   engines: { node: "22.x" },
@@ -36856,7 +36896,8 @@ var package_default = {
     "build:packages": "node scripts/build-embed.mjs && node scripts/build-packages.mjs",
     "scan:packages": "node scripts/scan-packages.mjs",
     perf: "node scripts/perf.mjs",
-    "build:site": "node scripts/build-site.mjs"
+    "build:site": "node scripts/build-site.mjs",
+    "format:check": "node scripts/format-check.mjs"
   },
   dependencies: {
     "@anthropic-ai/sdk": "^0.131.0",
@@ -36869,7 +36910,7 @@ var package_default = {
     "@node-saml/node-saml": "^5.1.0",
     "@pdf-lib/fontkit": "^1.1.1",
     "@pdf-lib/standard-fonts": "^1.0.0",
-    "@reportwright/pdf": "0.1.0-beta.8",
+    "@reportwright/pdf": "0.1.0-beta.9",
     "@signpdf/placeholder-pdf-lib": "^3.3.0",
     "@signpdf/signer-p12": "^3.3.0",
     "@signpdf/signpdf": "^3.3.0",