h17-sspdf 0.5.0 → 1.0.1

package/README.md

@@ -20,6 +20,8 @@ Source JSON  +  Theme  =  PDF
 npm install h17-sspdf
 ```
 
+Requires **Node.js 18 or newer**. The engine vendors a single self-contained UMD build of jsPDF (which bundles fflate, fast-png, iobuffer internally) plus Chart.js and chartjs-node-canvas. The only install-time dependency is [`canvas`](https://www.npmjs.com/package/canvas) (native C++ addon, used by the chart plugin) — no transitive dependency tree beyond that.
+
 ## The problem it solves
 
 Generating PDFs imperatively means tracking the cursor yourself. Every element you place shifts everything below it. Line wrapping, page breaks, font resets, all manual.
@@ -471,6 +473,7 @@ Claude Code skills for generating PDFs and themes are available in the `skills/`
 - Single-line `row` cells, no multi-line column pairs
 - `{{page}}` gives the current page number; `{{pages}}` (total page count) is not supported because keep-together rules make the final page count unpredictable until the last operation is laid out
 - Charts require the `canvas` npm package (native C++ addon) for server-side rendering; everything else is zero native dependencies
+- A `jspdf.umd.js` build is vendored for client-side/browser use. It bundles all dependencies internally but requires wiring up your own entry point — `pdf-core.js` uses the Node build by default
 
 ---
 
@@ -480,7 +483,7 @@ Hugo Palma, 2026
 
 This project vendors the following MIT-licensed libraries:
 
-- [jsPDF](https://github.com/parallax/jsPDF) - PDF generation. Copyright (c) 2010-2025 James Hall, yWorks GmbH.
+- [jsPDF](https://github.com/parallax/jsPDF) - PDF generation (UMD build, bundles fflate, fast-png, iobuffer internally). Copyright (c) 2010-2025 James Hall, yWorks GmbH.
 - [Chart.js](https://github.com/chartjs/Chart.js) - Chart rendering. Copyright (c) 2014-2024 Chart.js Contributors.
 - [chartjs-node-canvas](https://github.com/SeanSobey/ChartjsNodeCanvas) - Server-side Chart.js rendering. Copyright (c) 2018 Sean Sobey.
 

package/core/pdf-core.js

@@ -1,5 +1,5 @@
 const fs = require("fs");
-const { jsPDF } = require("../vendor/jspdf/jspdf.node");
+const { jsPDF } = require("../vendor/jspdf/jspdf.umd.js");
 const { pxToMm, ptToMm, resolveLineHeightMm } = require("./units");
 
 // Style math helpers, shared between core rendering and height estimation.
@@ -123,6 +123,8 @@ class PDFCore {
     this.pageHeight = this.doc.internal.pageSize.getHeight();
     this.backgroundColor = this._resolveColor(this.page.backgroundColor);
     this.lastDrawnBounds = null;
+    this.documentStateDepth = 0;
+    this.hasDeferredInitialRenderState = Array.isArray(theme.customFonts) && theme.customFonts.length > 0;
     this.defaultRenderState = this._buildDefaultRenderState(this.page);
     this.contentTopY = this.marginTopMm + this.headerHeightMm;
     this.contentBottomY = this.pageHeight - this.marginBottomMm - this.footerHeightMm;
@@ -138,7 +140,12 @@ class PDFCore {
     });
 
     this.paintBackground();
-    this.applyDefaultRenderState();
+    // Custom fonts are registered by renderDocument() after core construction.
+    // Deferring the first setFont() avoids jsPDF warnings when page.defaultText
+    // uses a custom family that is not yet in the font map.
+    if (!this.hasDeferredInitialRenderState) {
+      this.applyDefaultRenderState();
+    }
   }
 
   /**
@@ -178,9 +185,11 @@ class PDFCore {
    * Force a new page and reset cursor to top margin.
    */
   addPage() {
+    const reopenedStateDepth = this._closeDocumentStatesForPageBreak();
     this.doc.addPage();
     this.paintBackground();
     this.applyDefaultRenderState();
+    this._reopenDocumentStatesAfterPageBreak(reopenedStateDepth);
     this.cursorY = this.contentTopY;
   }
 
@@ -198,6 +207,7 @@ class PDFCore {
       && typeof this.doc.restoreGraphicsState === "function";
     if (canSaveGraphicsState) {
       this.doc.saveGraphicsState();
+      this.documentStateDepth += 1;
     }
 
     try {
@@ -205,6 +215,7 @@ class PDFCore {
     } finally {
       if (canSaveGraphicsState) {
         this.doc.restoreGraphicsState();
+        this.documentStateDepth = Math.max(0, this.documentStateDepth - 1);
       }
       this.applyDefaultRenderState();
     }
@@ -498,11 +509,21 @@ class PDFCore {
     const baseline = y + baselineOffsetMm;
 
     if (markerStyle.shape) {
-      // Vector shape marker: renders via core/shapes.js, no text encoding needed
+      // Vector shape marker: renders via core/shapes.js, no text encoding needed.
+      // Wrapped in saveGraphicsState/restoreGraphicsState to isolate draw state
+      // mutations (setLineCap, setFillColor, etc.) from the main content stream.
+      // Without this, accumulated state operators can cause print rendering issues
+      // where printer RIPs interpret the stacked state differently than screen viewers.
       const { renderShape, getShapeWidth } = require("./shapes");
       const shapeColor = markerStyle.shapeColor || markerStyle.color || [0, 0, 0];
       const shapeSize = markerStyle.shapeSize || 1;
+      if (typeof this.doc.saveGraphicsState === "function") {
+        this.doc.saveGraphicsState();
+      }
       renderShape(markerStyle.shape, this.doc, x, baseline, shapeColor, shapeSize, textFontSize);
+      if (typeof this.doc.restoreGraphicsState === "function") {
+        this.doc.restoreGraphicsState();
+      }
       this.applyDefaultRenderState();
     } else {
       // Text-based marker (existing behavior)
@@ -1070,6 +1091,29 @@ class PDFCore {
       fillColor: this._resolveColor(page.defaultFillColor),
     };
   }
+
+  _closeDocumentStatesForPageBreak() {
+    if (this.documentStateDepth <= 0) {
+      return 0;
+    }
+
+    for (let i = 0; i < this.documentStateDepth; i += 1) {
+      this.doc.restoreGraphicsState();
+    }
+
+    return this.documentStateDepth;
+  }
+
+  _reopenDocumentStatesAfterPageBreak(depth) {
+    const count = Number(depth) || 0;
+    if (count <= 0) {
+      return;
+    }
+
+    for (let i = 0; i < count; i += 1) {
+      this.doc.saveGraphicsState();
+    }
+  }
 }
 
 module.exports = {

package/core/render-document.js

@@ -47,6 +47,7 @@ function renderDocument(input) {
 
   const core = new PDFCore(runtimeTheme);
   registerThemeFonts(core, runtimeTheme);
+  core.applyDefaultRenderState();
 
   installPageTemplates(core, runtimeTheme, built.pageTemplates);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "h17-sspdf",
-  "version": "0.5.0",
+  "version": "1.0.1",
   "description": "Declarative PDF engine - define layout once, feed it JSON, get consistent PDFs",
   "main": "index.js",
   "author": "Hugo Palma",
@@ -20,7 +20,9 @@
   "files": [
     "core",
     "fonts",
-    "vendor",
+    "vendor/jspdf",
+    "vendor/chart.js",
+    "vendor/chartjs-node-canvas",
     "examples/themes",
     "examples/sources",
     "index.js",