@jasy/pdf 1.0.0-alpha.2 → 1.0.0-alpha.3

package/dist/renderer/page-renderer.js

@@ -1,81 +1,65 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PageRenderer = void 0;
-const page_sizes_1 = require("../constants/page-sizes");
-const renderer_registry_1 = require("../utils/renderer-registry");
-const pdf_config_1 = require("./pdf-config");
-const pdf_backend_1 = require("./pdf-backend");
-class PageRenderer {
-    static render(page, objectManager) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            const { children, config, header, footer } = page.getProps();
-            // Header (top band) and footer (bottom band) sit around the body and repeat on every
-            // physical page; they are placed by `PageElement.calculateLayout` / the page driver.
-            const renderables = [...(header ? [header] : []), ...children, ...(footer ? [footer] : [])];
-            // Page geometry (also the MediaBox below). Needed up front because flipping the
-            // display list to PDF coordinates uses the page height. config is fully resolved
-            // by the layout pass; fall back to the document default rather than asserting.
-            let [width, height] = page_sizes_1.pageFormats[(_a = config === null || config === void 0 ? void 0 : config.pageSize) !== null && _a !== void 0 ? _a : page_sizes_1.PageSize.A4];
-            if ((config === null || config === void 0 ? void 0 : config.orientation) === pdf_config_1.Orientation.landscape) {
-                [width, height] = [height, width];
+import { pageFormats, PageSize } from "../constants/page-sizes.js";
+import { RendererRegistry } from "../utils/renderer-registry.js";
+import { Orientation } from "./pdf-config.js";
+import { PdfBackend } from "./pdf-backend.js";
+export class PageRenderer {
+    static async render(page, objectManager) {
+        const { children, config, header, footer } = page.getProps();
+        // Header (top band) and footer (bottom band) sit around the body and repeat on every
+        // physical page; they are placed by `PageElement.calculateLayout` / the page driver.
+        const renderables = [...(header ? [header] : []), ...children, ...(footer ? [footer] : [])];
+        // Page geometry (also the MediaBox below). Needed up front because flipping the
+        // display list to PDF coordinates uses the page height. config is fully resolved
+        // by the layout pass; fall back to the document default rather than asserting.
+        let [width, height] = config?.customSize ?? pageFormats[config?.pageSize ?? PageSize.A4];
+        if (config?.orientation === Orientation.landscape) {
+            [width, height] = [height, width];
+        }
+        // Collect the whole page as a display list (top-left coordinates), flip it to PDF
+        // coordinates at this one seam, then serialize once. Serializing registers the
+        // fonts/images used below, so it must run before the resource section.
+        const nodes = [];
+        for (const element of renderables) {
+            const renderer = RendererRegistry.getRenderer(element);
+            if (renderer) {
+                nodes.push(...(await renderer(element, objectManager)));
             }
-            // Collect the whole page as a display list (top-left coordinates), flip it to PDF
-            // coordinates at this one seam, then serialize once. Serializing registers the
-            // fonts/images used below, so it must run before the resource section.
-            const nodes = [];
-            for (const element of renderables) {
-                const renderer = renderer_registry_1.RendererRegistry.getRenderer(element);
-                if (renderer) {
-                    nodes.push(...(yield renderer(element, objectManager)));
-                }
-            }
-            const pageContent = pdf_backend_1.PdfBackend.serialize(pdf_backend_1.PdfBackend.flipY(nodes, height), objectManager);
-            // Add the page content as a new object (FlateDecode-compressed when enabled). The /Length is
-            // computed inside, with an explicit EOL before `endstream` (PDF/A clause 6.1.7.1).
-            const contentObjectNumber = objectManager.addContentStream(pageContent);
-            // Get the parent object number dynamically (linked with the page object)
-            const parentObjectNumber = objectManager.getParentObjectNumber(); // Get parent object number
-            // Page object with MediaBox
-            // - Get all fonts and add it to the page (reference)
-            objectManager.registerFont("Helvetica");
-            const fontReferences = [];
-            objectManager.getAllFontsRaw().forEach((value, _key) => {
-                const fontRef = `/F${value.fontIndex} ${value.resourceIndex} 0 R`;
-                fontReferences.push(fontRef);
-            });
-            // - Get all images and add it to the page (reference)
-            const imageReferences = [];
-            objectManager.getAllImagesRaw().forEach((value) => {
-                const imageRef = `/IM${value} ${value} 0 R`;
-                imageReferences.push(imageRef);
-            });
-            const imageCode = imageReferences.length > 0
-                ? "/ProcSet [/PDF /Text /ImageB /ImageC /ImageI] /XObject <<\n" +
-                    imageReferences.join("\n") +
-                    "\n>>\n"
-                : "";
-            // - Transparency (ExtGState) references, registered during serialize above
-            const extGStateReferences = [];
-            objectManager.getAllExtGStatesRaw().forEach((objectNumber, name) => {
-                extGStateReferences.push(`/${name} ${objectNumber} 0 R`);
-            });
-            const extGStateCode = extGStateReferences.length > 0
-                ? "/ExtGState <<\n" + extGStateReferences.join("\n") + "\n>>\n"
-                : "";
-            const pageObject = `<< /Type /Page /Parent ${parentObjectNumber} 0 R /Contents ${contentObjectNumber} 0 R /Resources <<\n/Font <<\n${fontReferences.join("\n")}\n>>\n${imageCode}${extGStateCode}>>\n/MediaBox [0 0 ${width} ${height}] >>`;
-            // Add page as new object and return the page number
-            return objectManager.addObject(pageObject);
+        }
+        const pageContent = PdfBackend.serialize(PdfBackend.flipY(nodes, height), objectManager);
+        // Add the page content as a new object (FlateDecode-compressed when enabled). The /Length is
+        // computed inside, with an explicit EOL before `endstream` (PDF/A clause 6.1.7.1).
+        const contentObjectNumber = objectManager.addContentStream(pageContent);
+        // Get the parent object number dynamically (linked with the page object)
+        const parentObjectNumber = objectManager.getParentObjectNumber(); // Get parent object number
+        // Page object with MediaBox
+        // - Get all fonts and add it to the page (reference)
+        objectManager.registerFont("Helvetica");
+        const fontReferences = [];
+        objectManager.getAllFontsRaw().forEach((value, _key) => {
+            const fontRef = `/F${value.fontIndex} ${value.resourceIndex} 0 R`;
+            fontReferences.push(fontRef);
+        });
+        // - Get all images and add it to the page (reference)
+        const imageReferences = [];
+        objectManager.getAllImagesRaw().forEach((value) => {
+            const imageRef = `/IM${value} ${value} 0 R`;
+            imageReferences.push(imageRef);
+        });
+        const imageCode = imageReferences.length > 0
+            ? "/ProcSet [/PDF /Text /ImageB /ImageC /ImageI] /XObject <<\n" +
+                imageReferences.join("\n") +
+                "\n>>\n"
+            : "";
+        // - Transparency (ExtGState) references, registered during serialize above
+        const extGStateReferences = [];
+        objectManager.getAllExtGStatesRaw().forEach((objectNumber, name) => {
+            extGStateReferences.push(`/${name} ${objectNumber} 0 R`);
         });
+        const extGStateCode = extGStateReferences.length > 0
+            ? "/ExtGState <<\n" + extGStateReferences.join("\n") + "\n>>\n"
+            : "";
+        const pageObject = `<< /Type /Page /Parent ${parentObjectNumber} 0 R /Contents ${contentObjectNumber} 0 R /Resources <<\n/Font <<\n${fontReferences.join("\n")}\n>>\n${imageCode}${extGStateCode}>>\n/MediaBox [0 0 ${width} ${height}] >>`;
+        // Add page as new object and return the page number
+        return objectManager.addObject(pageObject);
     }
 }
-exports.PageRenderer = PageRenderer;

package/dist/renderer/pdf-backend.d.ts

@@ -1,5 +1,5 @@
-import { IRNode } from "../ir/display-list";
-import { PDFObjectManager } from "../utils/pdf-object-manager";
+import { IRNode } from "../ir/display-list.js";
+import { PDFObjectManager } from "../utils/pdf-object-manager.js";
 /**
  * PDF backend - turns display-list primitives into content-stream operators.
  *

package/dist/renderer/pdf-backend.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PdfBackend = void 0;
 /**
  * PDF backend - turns display-list primitives into content-stream operators.
  *
@@ -9,7 +6,7 @@ exports.PdfBackend = void 0;
  * emitted inline by the per-element renderers, so output stays byte-identical while
  * the renderers are migrated onto the IR one at a time.
  */
-class PdfBackend {
+export class PdfBackend {
     /**
      * Flip a display list from the engine's top-left origin (y grows downward) to PDF's
      * bottom-left origin (y grows upward). This is the ONE place the Y axis is flipped -
@@ -21,23 +18,30 @@ class PdfBackend {
         return nodes.map((node) => {
             switch (node.type) {
                 case "rect":
-                    return Object.assign(Object.assign({}, node), { y: pageHeight - node.y - node.height });
+                    return { ...node, y: pageHeight - node.y - node.height };
                 case "line":
-                    return Object.assign(Object.assign({}, node), { y1: pageHeight - node.y1, y2: pageHeight - node.y2 });
+                    return {
+                        ...node,
+                        y1: pageHeight - node.y1,
+                        y2: pageHeight - node.y2,
+                    };
                 case "text":
                     // node.y is the baseline measured from the page top; flip it directly.
-                    return Object.assign(Object.assign({}, node), { y: pageHeight - node.y });
+                    return { ...node, y: pageHeight - node.y };
                 case "image": {
                     // Flip the placement box (and the clip frame, if any) around its bottom edge.
-                    const flipped = Object.assign(Object.assign({}, node), { y: pageHeight - node.y - node.height });
+                    const flipped = { ...node, y: pageHeight - node.y - node.height };
                     if (node.clip) {
-                        flipped.clip = Object.assign(Object.assign({}, node.clip), { y: pageHeight - node.clip.y - node.clip.height });
+                        flipped.clip = {
+                            ...node.clip,
+                            y: pageHeight - node.clip.y - node.clip.height,
+                        };
                     }
                     return flipped;
                 }
                 case "clip-push":
                     // Flip the clip rect around its bottom edge, like a rect.
-                    return Object.assign(Object.assign({}, node), { y: pageHeight - node.y - node.height });
+                    return { ...node, y: pageHeight - node.y - node.height };
                 case "clip-pop":
                     return node;
                 default: {
@@ -100,7 +104,6 @@ class PdfBackend {
      * `om` is used only by primitives that allocate PDF resources (images, fonts).
      */
     static serializeNode(node, om) {
-        var _a, _b, _c, _d, _e, _f;
         switch (node.type) {
             case "line":
                 // q/Q isolates the graphics state; "[] 0 d" resets the dash pattern to solid.
@@ -114,10 +117,10 @@ class PdfBackend {
                     `S\n` +
                     `Q\n`);
             case "rect": {
-                // Stroke only with a stroke colour AND a positive width - a 0-width border means
+                // Stroke only with a stroke color AND a positive width - a 0-width border means
                 // "no border" (e.g. a filled box with no outline). Nothing to paint at all (no
                 // fill, no border) draws nothing. Paint: B = fill+stroke, f = fill, S = stroke.
-                const doStroke = !!node.stroke && ((_a = node.strokeWidth) !== null && _a !== void 0 ? _a : 0) > 0;
+                const doStroke = !!node.stroke && (node.strokeWidth ?? 0) > 0;
                 if (!node.fill && !doStroke)
                     return "";
                 let ops = "";
@@ -129,13 +132,13 @@ class PdfBackend {
                 const paint = node.fill ? (doStroke ? "B" : "f") : "S";
                 // Rounded corners emit a Bézier path; sharp corners keep the plain `re`
                 // (byte-identical when no radius is set).
-                const path = ((_b = node.radius) !== null && _b !== void 0 ? _b : 0) > 0
+                const path = (node.radius ?? 0) > 0
                     ? PdfBackend.roundedRectPath(node.x, node.y, node.width, node.height, node.radius)
                     : `${node.x} ${node.y} ${node.width} ${node.height} re`;
                 const body = ops + `${path} ${paint}\n`;
                 // Transparency needs an isolating q/Q so the state does not leak; opaque rects
                 // keep their bare operators (byte-identical).
-                const gs = PdfBackend.alphaPrefix(om, (_d = (_c = node.fill) === null || _c === void 0 ? void 0 : _c.getAlpha()) !== null && _d !== void 0 ? _d : 1, doStroke ? node.stroke.getAlpha() : 1);
+                const gs = PdfBackend.alphaPrefix(om, node.fill?.getAlpha() ?? 1, doStroke ? node.stroke.getAlpha() : 1);
                 return gs ? `q\n${gs}${body}Q\n` : body;
             }
             case "text": {
@@ -166,14 +169,14 @@ class PdfBackend {
             case "image": {
                 // The backend owns PDF resource creation: register the XObject (using the
                 // source pixel dimensions) and then place it with a scaling matrix.
-                const ref = om.registerImage(node.intrinsicWidth, node.intrinsicHeight, node.imageType, node.data);
+                const ref = om.registerImage(node.intrinsicWidth, node.intrinsicHeight, node.imageType, node.data, node.smask);
                 const draw = `q\n${node.width} 0 0 ${node.height} ${node.x} ${node.y} cm\n` + `/IM${ref} Do\nQ\n`;
                 if (!node.clip)
                     return draw;
                 // Clip to the frame (re … W n); rounded when a radius is set. The rectangular
                 // path is byte-identical to before.
                 const c = node.clip;
-                const clipPath = ((_e = node.radius) !== null && _e !== void 0 ? _e : 0) > 0
+                const clipPath = (node.radius ?? 0) > 0
                     ? PdfBackend.roundedRectPath(c.x, c.y, c.width, c.height, node.radius)
                     : `${c.x} ${c.y} ${c.width} ${c.height} re `;
                 return `q\n${clipPath}\nW n \n` + draw + `Q\n`;
@@ -181,7 +184,7 @@ class PdfBackend {
             case "clip-push": {
                 // Save the graphics state and intersect the clip with this (rounded) rect. Everything
                 // drawn until the matching clip-pop is cropped to it.
-                const path = ((_f = node.radius) !== null && _f !== void 0 ? _f : 0) > 0
+                const path = (node.radius ?? 0) > 0
                     ? PdfBackend.roundedRectPath(node.x, node.y, node.width, node.height, node.radius)
                     : `${node.x} ${node.y} ${node.width} ${node.height} re`;
                 return `q\n${path}\nW n\n`;
@@ -196,4 +199,3 @@ class PdfBackend {
         }
     }
 }
-exports.PdfBackend = PdfBackend;

package/dist/renderer/pdf-config.js

@@ -1,17 +1,14 @@
-"use strict";
 // Leaf module: no imports, so it can never sit inside an import cycle. The page/color
 // enums live here because they are runtime values used across modules that DO form
 // cycles (object manager <-> document <-> elements); importing them from a cyclic
 // module snapshots them as `undefined` under some load orders.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ColorMode = exports.Orientation = void 0;
-var Orientation;
+export var Orientation;
 (function (Orientation) {
     Orientation["portrait"] = "PORTRAIT";
     Orientation["landscape"] = "LANDSCAPE";
-})(Orientation || (exports.Orientation = Orientation = {}));
-var ColorMode;
+})(Orientation || (Orientation = {}));
+export var ColorMode;
 (function (ColorMode) {
     ColorMode["color"] = "COLOR";
     ColorMode["grayscale"] = "GRAYSCALE";
-})(ColorMode || (exports.ColorMode = ColorMode = {}));
+})(ColorMode || (ColorMode = {}));

package/dist/renderer/pdf-document-class.d.ts

@@ -1,8 +1,8 @@
-import { PageSize } from "../constants/page-sizes";
-import { PDFDocumentElement } from "../elements";
-import { FontStyle, PDFObjectManager } from "../utils/pdf-object-manager";
-import { ColorMode, Orientation } from "./pdf-config";
-export { ColorMode, Orientation } from "./pdf-config";
+import { PageSize } from "../constants/page-sizes.js";
+import { PDFDocumentElement } from "../elements/index.js";
+import { FontStyle, PDFObjectManager } from "../utils/pdf-object-manager.js";
+import { ColorMode, Orientation } from "./pdf-config.js";
+export { ColorMode, Orientation } from "./pdf-config.js";
 export interface Margin {
     left: number;
     top: number;

package/dist/renderer/pdf-document-class.js

@@ -1,90 +1,76 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDFDocument = exports.Orientation = exports.ColorMode = void 0;
-const pdf_object_manager_1 = require("../utils/pdf-object-manager");
-const pdf_renderer_1 = require("./pdf-renderer");
+import { FontStyle, PDFObjectManager } from "../utils/pdf-object-manager.js";
+import { PDFRenderer } from "./pdf-renderer.js";
 // Re-exported so existing `../renderer` consumers keep importing these from here.
-var pdf_config_1 = require("./pdf-config");
-Object.defineProperty(exports, "ColorMode", { enumerable: true, get: function () { return pdf_config_1.ColorMode; } });
-Object.defineProperty(exports, "Orientation", { enumerable: true, get: function () { return pdf_config_1.Orientation; } });
-class PDFDocument {
+export { ColorMode, Orientation } from "./pdf-config.js";
+export class PDFDocument {
     //#region  Helper
     // Method to register all standard fonts
     registerStandardFonts(objectManager) {
         const standardFonts = [
             {
                 fontName: "Helvetica",
-                fontStyle: pdf_object_manager_1.FontStyle.Normal,
+                fontStyle: FontStyle.Normal,
                 fullName: "Helvetica",
             },
             {
                 fontName: "Helvetica",
-                fontStyle: pdf_object_manager_1.FontStyle.Bold,
+                fontStyle: FontStyle.Bold,
                 fullName: "Helvetica-Bold",
             },
             {
                 fontName: "Helvetica",
-                fontStyle: pdf_object_manager_1.FontStyle.Italic,
+                fontStyle: FontStyle.Italic,
                 fullName: "Helvetica-Oblique",
             },
             {
                 fontName: "Helvetica",
-                fontStyle: pdf_object_manager_1.FontStyle.BoldItalic,
+                fontStyle: FontStyle.BoldItalic,
                 fullName: "Helvetica-BoldOblique",
             },
-            { fontName: "Courier", fontStyle: pdf_object_manager_1.FontStyle.Normal, fullName: "Courier" },
+            { fontName: "Courier", fontStyle: FontStyle.Normal, fullName: "Courier" },
             {
                 fontName: "Courier",
-                fontStyle: pdf_object_manager_1.FontStyle.Bold,
+                fontStyle: FontStyle.Bold,
                 fullName: "Courier-Bold",
             },
             {
                 fontName: "Courier",
-                fontStyle: pdf_object_manager_1.FontStyle.Italic,
+                fontStyle: FontStyle.Italic,
                 fullName: "Courier-Oblique",
             },
             {
                 fontName: "Courier",
-                fontStyle: pdf_object_manager_1.FontStyle.BoldItalic,
+                fontStyle: FontStyle.BoldItalic,
                 fullName: "Courier-BoldOblique",
             },
             {
                 fontName: "Times-Roman",
-                fontStyle: pdf_object_manager_1.FontStyle.Normal,
+                fontStyle: FontStyle.Normal,
                 fullName: "Times-Roman",
             },
             {
                 fontName: "Times-Roman",
-                fontStyle: pdf_object_manager_1.FontStyle.Bold,
+                fontStyle: FontStyle.Bold,
                 fullName: "Times-Bold",
             },
             {
                 fontName: "Times-Roman",
-                fontStyle: pdf_object_manager_1.FontStyle.Italic,
+                fontStyle: FontStyle.Italic,
                 fullName: "Times-Italic",
             },
             {
                 fontName: "Times-Roman",
-                fontStyle: pdf_object_manager_1.FontStyle.BoldItalic,
+                fontStyle: FontStyle.BoldItalic,
                 fullName: "Times-BoldItalic",
             },
             {
                 fontName: "Symbol",
-                fontStyle: pdf_object_manager_1.FontStyle.Normal,
+                fontStyle: FontStyle.Normal,
                 fullName: "Symbol",
             },
             {
                 fontName: "ITC Zapf Dingbats",
-                fontStyle: pdf_object_manager_1.FontStyle.Normal,
+                fontStyle: FontStyle.Normal,
                 fullName: "ZapfDingbats",
             },
         ];
@@ -94,10 +80,10 @@ class PDFDocument {
     constructor(config) {
         // One object manager per document instance - no global singleton. Threaded
         // explicitly into the renderer.
-        this._objectManager = new pdf_object_manager_1.PDFObjectManager();
+        this._objectManager = new PDFObjectManager();
         // Add all standard font families - unless the document is PDF/A, which forbids non-embedded
         // fonts (the caller then supplies embedded fonts for every name it uses).
-        if ((config === null || config === void 0 ? void 0 : config.registerStandardFonts) !== false) {
+        if (config?.registerStandardFonts !== false) {
             this.registerStandardFonts(this._objectManager);
         }
         if (config)
@@ -107,12 +93,9 @@ class PDFDocument {
         return this._objectManager;
     }
     beforeRenderer() { }
-    static render() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const instance = new this();
-            instance.child = instance.build();
-            return yield pdf_renderer_1.PDFRenderer.render(instance.child, instance._objectManager);
-        });
+    static async render() {
+        const instance = new this();
+        instance.child = instance.build();
+        return await PDFRenderer.render(instance.child, instance._objectManager);
     }
 }
-exports.PDFDocument = PDFDocument;

package/dist/renderer/pdf-document-renderer.d.ts

@@ -1,6 +1,6 @@
-import { PDFDocumentElement } from "../elements/pdf-document-element";
-import { LayoutContext } from "../elements/pdf-element";
-import { PDFObjectManager } from "../utils/pdf-object-manager";
+import { PDFDocumentElement } from "../elements/pdf-document-element.js";
+import { LayoutContext } from "../elements/pdf-element.js";
+import { PDFObjectManager } from "../utils/pdf-object-manager.js";
 export declare class PDFDocumentRenderer {
     static render(document: PDFDocumentElement, objectManager: PDFObjectManager, ctx: LayoutContext): Promise<number>;
     /**