@reportwright/viewer 0.13.0 → 0.13.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All `@reportwright/*` packages (formerly `@pagewrightjs/*`) share one version. The versioning policy is in [CONTRIBUTING.md](CONTRIBUTING.md#versioning-semver).
 
+## 0.13.1 — 2026-10-09
+
+### Fixed
+- **N10: the CJK fonts are named Regular in the PDF.** `@reportwright/fonts-cjk` downloads variable TrueType fonts whose default instance is Thin; 0.13.0 cut and renamed the subset at Regular, but `exportPdf` and `exportPdfStream` built the BaseFont from the full font's PostScript name, so pdffonts showed `NotoSansJP-Thin` / `NotoSansKR-Thin`. Both now take the name from the subset they embed (`NotoSansJP-Regular`). Test: tests/engine/b11-cjk-names.test.js (the downloaded fonts are tested when present).
+- **N44: a streamed tagged PDF's memory stays flat.** The writer kept where each object is in arrays of 7 bytes an object that doubled; a tagged million-row ledger has 8–11 million objects (an element per cell), most of tagging's ~125 MB at 1M rows. They are now blocks of 16,384 entries, each deflated (~2 KB) once the numbers are two blocks past; the tagger lets go of a page's elements when it ends. Same file byte for byte (but its ID): veraPDF UA-1 and A-2a pass, same `pdfinfo -struct` tree. Off-heap peak at 50k/100k/200k rows: 16.8/29.1/36.6 MB before, 6.7/7.3/9.3 MB after (RSS ~205 MB either way). Test: tests/engine/b11-n44-tagged-memory.test.js.
+- **N45: `pw render` stopped by a signal leaves no temporary file.** SIGTERM (Docker, Kubernetes, CI), SIGINT (Ctrl+C) and SIGHUP remove `<file>.<pid>.part`, keep an older PDF at the path as it was, and exit 143, 130 or 129. Before, every one of them left the `.part` file. Test: tests/engine/b10-perf-cli.test.js.
+- **N41: a copied worker starts.** The npm package's `engine.worker.js` bundles its libraries (bidi-js, fontkit) instead of importing them by name, so an esbuild app that copies it next to its bundle renders in the worker (it crashed with "Failed to resolve module specifier bidi-js" and fell back to the main thread). Barcodes and the standard-font metrics are files next to it (`engine.worker.bwip.js`, `engine.worker.stdfonts.js`), as in the browser build; the README says to copy `engine.worker*.js`. Test: tests/e2e/b11-esbuild-worker.mjs.
+- **N40: `fonts` is optional.** `render()`, `exportPdf()`, `exportPdfStream()` and the Word, Excel and PowerPoint exports use one default store over `@reportwright/fonts` when given none, and an export loads the fonts the model uses into whatever store it gets, so render and export need not share a store (it failed with "this.loader is not a function" or 'Font "Helvetica" is not loaded'). A report in the standard PDF fonts needs no store and no fonts package (a bold title in a Helvetica report no longer loads Inter-Bold); a font that cannot load says "Install @reportwright/fonts, or pass { fontStore }". Test: tests/engine/b11-fonts-n40.test.js, and the packed packages in all four combinations (packages.test.js).
+- **N19: one warning prefix.** The engine package's console warnings and deprecations start with `[reportwright]`, as the rest do (they said `[@reportwright/engine]`).
+- **N43: the standard-font metrics are a table.** Helvetica, Times, Courier, Symbol and ZapfDingbats widths and font-wide metrics are generated once from the Adobe AFM data (`scripts/gen-standard-metrics.mjs` → `src/engine/text/standard-metrics.js`, 22 KB, 5 KB gzipped) instead of decompressed with pako from `@pdf-lib/standard-fonts` at every cold start; that package is no longer a dependency of `@reportwright/engine` or `@reportwright/viewer` (pdf-lib still installs it for itself), and the viewer's `engine.worker.stdfonts.js` is gone (the table is in the worker: 588 → 594 KB gzipped, about 100 KB gzipped less in all). PDFs are byte-identical. A new process making a 1-page Helvetica invoice: median of 10, 115 → 94 ms on an M2 (Node 20). Test: tests/engine/b11-fonts-n43.test.js.
+- **N42: the designer Outline passes axe.** It was a `listbox` whose rows also hold their move buttons (a listbox may hold only options: aria-required-children, critical). The rows are now toggle buttons (`aria-pressed`) in a labelled group, with the same keyboard: one Tab stop, Up/Down/Home/End, Enter or Space selects.
+- **N44: a large sort's memory stays flat.** The disk spill behind grouped and sorted streamed reports held a 1,000-row batch from every sorted run while merging (50 runs at 1,000,000 rows), so its memory grew with the rows. Runs are now about 8 MB (at most 10,000 rows), batches 200 rows, and the merge holds about 4 MB: past that many runs, groups of runs are merged on disk first. A 200,000-row grouped ledger: 280 → 232 MB peak; the same with 50 runs (the run count of 1,000,000 rows): 296 → 240 MB. `spillSorter({ runMB, mergeMB })` sets them. The engine README recommends `presorted: true` with ORDER BY at the source for big grouped reports. Test: tests/engine/b11-mem-spill.test.js.
+- **SILENT-6: an item taller than the page warns in `validate()`.** A body item taller than the room the page has for the body (the page less its margins, page header and footer, a body section's own page and bands counted) warns with both heights and what the render does: its lower part is cut at the page bottom (a text box's text of more than one line continues on the next page). Tables, matrices, lists and subreports, which split by their rows, and pageless pages are quiet. `render()` keeps its own warning where it cuts (with the page number) and does not repeat validate's. Test: tests/engine/b11-mem-silent6-tall.test.js.
+- **N37: repeated copies cascade.** Ctrl+D (Duplicate) and Paste put a copy 12 pt right and down, and 12 more while an item already sits there, so copying the same item again and again fans the copies out instead of stacking them on the first copy. A pasted coordinate that is not a finite number starts at 0, and the steps are bounded, so a paste of hostile JSON (`1e309`, 2^60) cannot hang the tab. Test: tests/engine/b11-mem-designer-cascade.test.js.
+
 ## 0.13.0 — 2026-10-09
 
 A minor release: new options (`largeReportRows`, `signal`, `warnOnLeave`, `onDirtyChange`), the 14 standard PDF fonts, streamed Excel and Word exports, and warnings where mistakes used to be silent. The tester's 0.12.1 tickets are fixed except where noted; fonts are still TTF (WOFF2 is not done).

package/README.md

@@ -11,8 +11,10 @@ The viewer renders in a Web Worker (`engine.worker.js`, one self-contained file
 
 - **Vite 7**: set `worker: { format: 'es' }` in `vite.config.js`. Without it the build fails with
   `Invalid value "iife" for option "worker.format"`.
-- **esbuild** (plain bundling) does not follow `new Worker(new URL(...))`: copy `node_modules/@reportwright/viewer/dist/engine.worker.js`
-  next to your bundle (it is one file; its only imports are the package's own dependencies).
+- **esbuild** (plain bundling) does not follow `new Worker(new URL(...))`: copy the worker files next to your bundle:
+  `cp node_modules/@reportwright/viewer/dist/engine.worker*.js dist/`. `engine.worker.js` has no imports (its libraries are
+  inside it); `engine.worker.bwip.js` (barcodes) loads only when a report
+  needs it. Without it those reports render on the main thread, with the warning below.
 
 If the worker cannot load, the viewer still renders, on the main thread (slow and janky at 100k rows), and logs once
 `[reportwright] worker did not load (<reason>); rendering on the main thread`. `handle.usesWorker` tells you which one you got.

package/THIRD-PARTY-NOTICES.md

@@ -9,7 +9,7 @@ ReportWright is MIT licensed (see LICENSE). It ships or bundles the following th
 | [HarfBuzz](https://github.com/harfbuzz/harfbuzz), compiled to WebAssembly by [harfbuzzjs](https://github.com/harfbuzz/harfbuzzjs) | harfbuzzjs 1.6.2 | HarfBuzz: "Old MIT" (below); harfbuzzjs: MIT, Copyright (c) 2019-2026 The harfbuzzjs project authors | text shaping (`harfbuzz.wasm`) and font subsetting (`harfbuzz-subset.wasm`) |
 | [pdf-lib](https://github.com/Hopding/pdf-lib) | 1.17.1 | MIT, Copyright (c) 2019 Andrew Dillon | the classic PDF writer (encryption, `prepare`, `save`) |
 | [@pdf-lib/fontkit](https://github.com/Hopding/fontkit) | 1.1.1 | MIT | reading font files |
-| [@pdf-lib/standard-fonts](https://github.com/Hopding/standard-fonts) | 1.0.0 | MIT; the metrics are Adobe's AFM files for the 14 standard PDF fonts | Helvetica, Times and Courier widths |
+| [@pdf-lib/standard-fonts](https://github.com/Hopding/standard-fonts) | 1.0.0 | MIT; the metrics are Adobe's AFM files for the 14 standard PDF fonts | Helvetica, Times and Courier widths: generated from its AFM data into src/engine/text/standard-metrics.js (scripts/gen-standard-metrics.mjs); the package itself is not a runtime dependency |
 | [bwip-js](https://github.com/metafloor/bwip-js) | 4.11.4 | MIT | barcodes |
 | [fflate](https://github.com/101arrowz/fflate) | 0.8.3 | MIT | zip and deflate (Excel, Word, PowerPoint, PDF streams) |
 | [bidi-js](https://github.com/lojjic/bidi-js) | 1.0.3 | MIT | right-to-left text |

package/dist/{chunk-DXHLIJEY.js → chunk-47ZAKRVN.js}

@@ -1,13 +1,13 @@
-import {
-  formatValue,
-  isoDate,
-  roundHalfAway
-} from "./chunk-GJS242RR.js";
 import {
   mergedRegions,
   needsTableData,
   textRows
 } from "./chunk-F6RMRXIN.js";
+import {
+  formatValue,
+  isoDate,
+  roundHalfAway
+} from "./chunk-GJS242RR.js";
 import "./chunk-OLLMACWA.js";
 
 // src/exporters/csv.js
@@ -95,4 +95,4 @@ export {
   exportCsv,
   writeCsvStream
 };
-//# sourceMappingURL=chunk-DXHLIJEY.js.map
+//# sourceMappingURL=chunk-47ZAKRVN.js.map

package/dist/{chunk-L6YEIVVD.js → chunk-B5ZCT3UK.js}

@@ -22,13 +22,10 @@ import {
   serverPdfUrl,
   subsetter,
   usingWorker
-} from "./chunk-CNDUJ7IV.js";
+} from "./chunk-ES2LYZ6S.js";
 import {
   NO_CJK_FONTS
 } from "./chunk-BR5K6SBL.js";
-import {
-  safeUrl
-} from "./chunk-72S6DETS.js";
 import {
   needsExportData
 } from "./chunk-F6RMRXIN.js";
@@ -36,10 +33,13 @@ import {
   fontKeysOf,
   linkTitle,
   pageToSvg
-} from "./chunk-UJL7C2AS.js";
+} from "./chunk-U2ZY2NPQ.js";
+import {
+  safeUrl
+} from "./chunk-72S6DETS.js";
 import {
   CORE_FONT_KEY
-} from "./chunk-QFLVVM3H.js";
+} from "./chunk-MS2LQC2O.js";
 import {
   __commonJS,
   __toESM
@@ -19475,10 +19475,10 @@ async function exportBlob(fmt, model, def, opt = {}) {
   const o = { ...EXPORT_DEFAULTS, ...opt.options || {} };
   const lang = def.locale || opt.lang || "en";
   if (fmt === "json") return new Blob([JSON.stringify(model)], { type: "application/json" });
-  if (fmt === "csv") return new Blob([(await import("./chunk-DXHLIJEY.js")).exportCsv(model, { locale: def.locale, currency: def.currency })], { type: "text/csv;charset=utf-8" });
+  if (fmt === "csv") return new Blob([(await import("./chunk-47ZAKRVN.js")).exportCsv(model, { locale: def.locale, currency: def.currency })], { type: "text/csv;charset=utf-8" });
   if (fmt === "html" && opt.interactive !== false && o.html === "interactive") {
     try {
-      const { exportInteractiveHtml } = await import("./chunk-UHHURTSV.js");
+      const { exportInteractiveHtml } = await import("./chunk-PF4RFKX2.js");
       const { html } = await exportInteractiveHtml(def, { params: opt.params, reportId: opt.reportId, lang: opt.lang, model });
       return new Blob([html], { type: "text/html;charset=utf-8" });
     } catch (e) {
@@ -19488,19 +19488,19 @@ async function exportBlob(fmt, model, def, opt = {}) {
   }
   if (fmt === "html") {
     const store = await loadedFonts(model);
-    const { exportHtml } = await import("./chunk-PQNM6ET7.js");
+    const { exportHtml } = await import("./chunk-WOBRKNIA.js");
     return new Blob([await exportHtml(model, { fonts: store, title: def.name, subset: subsetter, drillBase: origin(), static: o.html === "static", locale: def.locale, currency: def.currency, lang: opt.lang, strings: opt.strings })], { type: "text/html;charset=utf-8" });
   }
   if (fmt === "docx") {
-    const { exportDocx } = await import("./chunk-FEM2QVOO.js");
+    const { exportDocx } = await import("./chunk-JD6EJ3LI.js");
     return new Blob([await exportDocx(model, { title: def.name, lang, fontStore: await loadedFonts(model), fetchImage })], { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" });
   }
   if (fmt === "pptx") {
-    const { exportPptx } = await import("./chunk-IFYCJZNS.js");
+    const { exportPptx } = await import("./chunk-GRYITZPG.js");
     return new Blob([await exportPptx(model, { title: def.name, lang, fontStore: await loadedFonts(model), fetchImage })], { type: "application/vnd.openxmlformats-officedocument.presentationml.presentation" });
   }
   if (fmt === "xlsx") {
-    const { exportXlsx } = await import("./chunk-F5EPQTPF.js");
+    const { exportXlsx } = await import("./chunk-H422SRD3.js");
     const bytes = await exportXlsx(model, { currency: def.currency, title: def.name, formulas: o.formulas, fontStore: await loadedFonts(model), fetchImage });
     return new Blob([bytes], { type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" });
   }
@@ -20708,4 +20708,4 @@ export {
   ReportViewer,
   uiFontCss
 };
-//# sourceMappingURL=chunk-L6YEIVVD.js.map
+//# sourceMappingURL=chunk-B5ZCT3UK.js.map