@jasy/pdf 1.0.0-alpha.1 → 1.0.0-alpha.10

package/dist/renderer/rectangle-renderer.js

@@ -1,48 +1,54 @@
-"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.RectangleRenderer = void 0;
-const renderer_registry_1 = require("../utils/renderer-registry");
-class RectangleRenderer {
-    static render(rectangleElement, objectManager) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { x, y, width, height, children, color, backgroundColor, borderWidth, radius, sideBorders, } = rectangleElement.getProps();
-            const h = height;
-            const nodes = [];
-            if (sideBorders) {
-                // Per-side borders: a fill-only box (no stroke), then a line per present side
-                // (sharp corners). This is what lets cells draw grid lines.
-                if (backgroundColor) {
-                    nodes.push({ type: "rect", x, y, width, height: h, strokeWidth: 0, fill: backgroundColor });
-                }
-                nodes.push(...RectangleRenderer.sideLines(x, y, width, h, borderWidth, sideBorders));
+import { RendererRegistry } from "../utils/renderer-registry.js";
+import { isGradientInput, resolveGradient } from "../api/gradient.js";
+export class RectangleRenderer {
+    static async render(rectangleElement, objectManager) {
+        const { x, y, width, height, children, color, backgroundColor, borderWidth, radius, sideBorders, overflow, } = rectangleElement.getProps();
+        const h = height;
+        const nodes = [];
+        // A gradient is written box-relative (an angle and stops); this is the first place the box is
+        // known, so it is resolved into the absolute page coordinates the IR wants.
+        const fill = backgroundColor !== undefined && isGradientInput(backgroundColor)
+            ? resolveGradient(backgroundColor, x, y, width, h)
+            : backgroundColor;
+        if (sideBorders) {
+            // Per-side borders: a fill-only box (no stroke), then a line per present side
+            // (sharp corners). This is what lets cells draw grid lines.
+            if (backgroundColor) {
+                nodes.push({ type: "rect", x, y, width, height: h, strokeWidth: 0, fill });
             }
-            else {
-                // The box itself becomes a display-list primitive. A background means a filled box;
-                // otherwise it is stroked only. (Unchanged path - byte-identical.)
-                const node = Object.assign(Object.assign({ type: "rect", x,
-                    y,
-                    width, height: h, stroke: color, strokeWidth: borderWidth }, (backgroundColor ? { fill: backgroundColor } : {})), (radius ? { radius } : {}));
-                nodes.push(node);
+            nodes.push(...RectangleRenderer.sideLines(x, y, width, h, borderWidth, sideBorders));
+        }
+        else {
+            // The box itself becomes a display-list primitive. A background means a filled box;
+            // otherwise it is stroked only. (Unchanged path - byte-identical.)
+            const node = {
+                type: "rect",
+                x,
+                y,
+                width,
+                height: h,
+                stroke: color,
+                strokeWidth: borderWidth,
+                ...(fill ? { fill } : {}),
+                ...(radius ? { radius } : {}),
+            };
+            nodes.push(node);
+        }
+        // Children follow the box (Rectangle is also a container). With overflow: "hidden" they are
+        // wrapped in a clip to the (rounded) box rect, so a Positioned child is cropped at the edge
+        // instead of spilling over. Default "visible" emits no clip - byte-identical.
+        const clip = overflow === "hidden";
+        if (clip) {
+            nodes.push({ type: "clip-push", x, y, width, height: h, ...(radius ? { radius } : {}) });
+        }
+        if (children)
+            for (const child of children) {
+                const renderer = RendererRegistry.getRenderer(child);
+                nodes.push(...(await renderer(child, objectManager)));
             }
-            // Children follow the box (Rectangle is also a container).
-            if (children)
-                for (const child of children) {
-                    const renderer = renderer_registry_1.RendererRegistry.getRenderer(child);
-                    if (renderer) {
-                        nodes.push(...(yield renderer(child, objectManager)));
-                    }
-                }
-            return nodes;
-        });
+        if (clip)
+            nodes.push({ type: "clip-pop" });
+        return nodes;
     }
     /** One `line` node per present side, along the box edges (top-left coordinates). */
     static sideLines(x, y, width, height, strokeWidth, sides) {
@@ -58,4 +64,3 @@ class RectangleRenderer {
         return lines;
     }
 }
-exports.RectangleRenderer = RectangleRenderer;

package/dist/renderer/repeating-header-renderer.d.ts

@@ -1,6 +1,6 @@
-import { PDFObjectManager } from "../utils/pdf-object-manager";
-import { RepeatingHeaderElement } from "../elements/layout/repeating-header-element";
-import { IRNode } from "../ir/display-list";
+import { PDFObjectManager } from "../utils/pdf-object-manager.js";
+import { RepeatingHeaderElement } from "../elements/layout/repeating-header-element.js";
+import { IRNode } from "../ir/display-list.js";
 export declare class RepeatingHeaderRenderer {
     static render(element: RepeatingHeaderElement, objectManager: PDFObjectManager): Promise<IRNode[]>;
 }

package/dist/renderer/repeating-header-renderer.js

@@ -1,28 +1,12 @@
-"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.RepeatingHeaderRenderer = void 0;
-const renderer_registry_1 = require("../utils/renderer-registry");
-class RepeatingHeaderRenderer {
-    static render(element, objectManager) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { header, body } = element.getProps();
-            const nodes = [];
-            for (const child of [header, body]) {
-                const renderer = renderer_registry_1.RendererRegistry.getRenderer(child);
-                if (renderer)
-                    nodes.push(...(yield renderer(child, objectManager)));
-            }
-            return nodes;
-        });
+import { RendererRegistry } from "../utils/renderer-registry.js";
+export class RepeatingHeaderRenderer {
+    static async render(element, objectManager) {
+        const { header, body } = element.getProps();
+        const nodes = [];
+        for (const child of [header, body]) {
+            const renderer = RendererRegistry.getRenderer(child);
+            nodes.push(...(await renderer(child, objectManager)));
+        }
+        return nodes;
     }
 }
-exports.RepeatingHeaderRenderer = RepeatingHeaderRenderer;

package/dist/renderer/rotated-renderer.d.ts

@@ -0,0 +1,7 @@
+import { PDFObjectManager } from "../utils/pdf-object-manager.js";
+import { RotatedElement } from "../elements/layout/rotated-element.js";
+import { RotatedBoxElement } from "../elements/layout/rotated-box-element.js";
+import { IRNode } from "../ir/display-list.js";
+export declare class RotatedRenderer {
+    static render(element: RotatedElement | RotatedBoxElement, objectManager: PDFObjectManager): Promise<IRNode[]>;
+}

package/dist/renderer/rotated-renderer.js

@@ -0,0 +1,29 @@
+import { RendererRegistry } from "../utils/renderer-registry.js";
+export class RotatedRenderer {
+    // Both `Rotated` (paint-only) and `RotatedBox` (layout-aware quarter-turns) expose the same
+    // `{ angle, child, x, y, width, height }` and rotate the child around the box center - shared here.
+    static async render(element, objectManager) {
+        const { angle, child, x, y, width, height } = element.getProps();
+        // Rotate around the box CENTER, in the engine's top-left coordinates (the IR->backend seam flips
+        // the matrix to PDF space per page). A positive angle reads clockwise on the page.
+        const cx = x + width / 2;
+        const cy = y + height / 2;
+        const theta = (angle * Math.PI) / 180;
+        const cos = Math.cos(theta);
+        const sin = Math.sin(theta);
+        // M = T(cx,cy) · R(theta) · T(-cx,-cy) as a PDF cm [a,b,c,d,e,f]: the linear part is the rotation,
+        // the translation keeps the center fixed.
+        const matrix = [
+            cos,
+            sin,
+            -sin,
+            cos,
+            cx - cos * cx + sin * cy,
+            cy - sin * cx - cos * cy,
+        ];
+        const renderer = RendererRegistry.getRenderer(child);
+        const childNodes = await renderer(child, objectManager);
+        // Wrap the child's drawing between a push (apply the matrix) and a pop (restore).
+        return [{ type: "transform-push", matrix }, ...childNodes, { type: "transform-pop" }];
+    }
+}

package/dist/renderer/row-renderer.d.ts

@@ -1,6 +1,6 @@
-import { PDFObjectManager } from "../utils/pdf-object-manager";
-import { RowElement } from "../elements/row-element";
-import { IRNode } from "../ir/display-list";
+import { PDFObjectManager } from "../utils/pdf-object-manager.js";
+import { RowElement } from "../elements/row-element.js";
+import { IRNode } from "../ir/display-list.js";
 export declare class RowRenderer {
     static render(rowElement: RowElement, objectManager: PDFObjectManager): Promise<IRNode[]>;
 }

package/dist/renderer/row-renderer.js

@@ -1,30 +1,13 @@
-"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.RowRenderer = void 0;
-const renderer_registry_1 = require("../utils/renderer-registry");
-class RowRenderer {
-    static render(rowElement, objectManager) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { children } = rowElement.getProps();
-            const nodes = [];
-            if (children)
-                for (const child of children) {
-                    const renderer = renderer_registry_1.RendererRegistry.getRenderer(child);
-                    if (renderer) {
-                        nodes.push(...(yield renderer(child, objectManager)));
-                    }
-                }
-            return nodes;
-        });
+import { RendererRegistry } from "../utils/renderer-registry.js";
+export class RowRenderer {
+    static async render(rowElement, objectManager) {
+        const { children } = rowElement.getProps();
+        const nodes = [];
+        if (children)
+            for (const child of children) {
+                const renderer = RendererRegistry.getRenderer(child);
+                nodes.push(...(await renderer(child, objectManager)));
+            }
+        return nodes;
     }
 }
-exports.RowRenderer = RowRenderer;

package/dist/renderer/struct-group-renderer.d.ts

@@ -0,0 +1,10 @@
+import { StructGroup } from "../elements/layout/struct-group.js";
+import { PDFObjectManager } from "../utils/pdf-object-manager.js";
+import { IRNode } from "../ir/display-list.js";
+/**
+ * Renders a StructGroup: opens its structure element, renders the child under it, closes it. With accessible
+ * tagging off it is fully transparent - just the child's IR.
+ */
+export declare class StructGroupRenderer {
+    static render(group: StructGroup, objectManager: PDFObjectManager): Promise<IRNode[]>;
+}

package/dist/renderer/struct-group-renderer.js

@@ -0,0 +1,24 @@
+import { RendererRegistry } from "../utils/renderer-registry.js";
+/**
+ * Renders a StructGroup: opens its structure element, renders the child under it, closes it. With accessible
+ * tagging off it is fully transparent - just the child's IR.
+ */
+export class StructGroupRenderer {
+    static async render(group, objectManager) {
+        const { role, child } = group.getProps();
+        const renderChild = async () => {
+            const renderer = RendererRegistry.getRenderer(child);
+            return renderer(child, objectManager);
+        };
+        if (!objectManager.struct.enabled)
+            return renderChild();
+        const key = objectManager.struct.openElement(group.structId, role);
+        objectManager.struct.push(key);
+        try {
+            return await renderChild();
+        }
+        finally {
+            objectManager.struct.pop(); // keep the parent stack balanced even if a child throws
+        }
+    }
+}

package/dist/renderer/text-renderer.d.ts

@@ -1,9 +1,13 @@
-import { TextElement, TextSegment } from "../elements/text-element";
-import { FontStyle, PDFObjectManager } from "../utils/pdf-object-manager";
-import type { FontMetrics } from "../utils/font-metrics";
-import { IRNode } from "../ir/display-list";
+import { TextElement, TextSegment } from "../elements/text-element.js";
+import { FontStyle, PDFObjectManager } from "../utils/pdf-object-manager.js";
+import type { FontMetrics } from "../utils/font-metrics.js";
+import { IRNode } from "../ir/display-list.js";
+import { type LineOptions, TextOverflow } from "../text/line-breaker.js";
 export declare class TextRenderer {
-    static calculateTextHeight(content: string | TextSegment[], fontSize: number, fontFamily: string, fontStyle: FontStyle, objectManager: FontMetrics, maxWidth: number): number;
+    static calculateTextHeight(content: string | TextSegment[], fontSize: number, fontFamily: string, fontStyle: FontStyle, objectManager: FontMetrics, maxWidth: number, maxLines?: number, overflow?: TextOverflow, lineHeight?: number, letterSpacing?: number, lineOptions?: LineOptions): number;
     static render(textElement: TextElement, objectManager: PDFObjectManager): Promise<IRNode[]>;
+    private static _expandColorGlyphs;
+    private static _glyphToPath;
+    private static _toGradient;
     private static _buildRuns;
 }