@jsonpdf/renderer 0.1.0-alpha.1

package/dist/gradient.js

@@ -0,0 +1,176 @@
+import { PDFName, PDFNumber, PDFArray, PDFRawStream } from 'pdf-lib';
+import { parseColor } from '@jsonpdf/core';
+/**
+ * Draw a gradient-filled rectangle on a PDF page.
+ *
+ * Uses PDF shading patterns (Type 2 axial for linear, Type 3 radial for radial).
+ * The gradient is clipped to the specified rectangle.
+ *
+ * @param page - The pdf-lib page
+ * @param doc - The pdf-lib document
+ * @param x - Left edge in pdf-lib coordinates
+ * @param y - Bottom edge in pdf-lib coordinates (NOT top)
+ * @param width - Rectangle width
+ * @param height - Rectangle height
+ * @param gradient - The gradient definition
+ * @param opacity - Optional opacity (0-1)
+ */
+export function drawGradientRect(page, doc, x, y, width, height, gradient, opacity) {
+    const context = doc.context;
+    // Build the color function from stops
+    const colorFunction = buildColorFunction(context, gradient.stops);
+    // Build the shading dictionary
+    let shadingDict;
+    if (gradient.type === 'linear') {
+        shadingDict = buildAxialShading(context, gradient, x, y, width, height, colorFunction);
+    }
+    else {
+        shadingDict = buildRadialShading(context, gradient, x, y, width, height, colorFunction);
+    }
+    const shadingRef = context.register(shadingDict);
+    // Generate unique name for this shading resource
+    const shadingName = `Sh${String(shadingRef.objectNumber)}`;
+    // Add shading to page resources
+    const pageDict = page.node;
+    let resources = pageDict.get(PDFName.of('Resources'));
+    if (!resources) {
+        resources = context.obj({});
+        pageDict.set(PDFName.of('Resources'), resources);
+    }
+    let shadingResources = resources.get(PDFName.of('Shading'));
+    if (!shadingResources) {
+        shadingResources = context.obj({});
+        resources.set(PDFName.of('Shading'), shadingResources);
+    }
+    shadingResources.set(PDFName.of(shadingName), shadingRef);
+    // Build graphics state for opacity if needed
+    let gsName;
+    if (opacity !== undefined && opacity < 1) {
+        const gsDict = context.obj({
+            Type: 'ExtGState',
+            ca: PDFNumber.of(opacity),
+            CA: PDFNumber.of(opacity),
+        });
+        const gsRef = context.register(gsDict);
+        gsName = `GS${String(gsRef.objectNumber)}`;
+        let extGState = resources.get(PDFName.of('ExtGState'));
+        if (!extGState) {
+            extGState = context.obj({});
+            resources.set(PDFName.of('ExtGState'), extGState);
+        }
+        extGState.set(PDFName.of(gsName), gsRef);
+    }
+    // Build content stream operators:
+    // q (save state) → clip to rect → optional gs → sh (paint shading) → Q (restore)
+    const ops = [];
+    ops.push('q'); // save graphics state
+    // Clip to rectangle
+    ops.push(`${n(x)} ${n(y)} ${n(width)} ${n(height)} re W n`);
+    // Apply opacity graphics state if needed
+    if (gsName) {
+        ops.push(`/${gsName} gs`);
+    }
+    // Paint the shading
+    ops.push(`/${shadingName} sh`);
+    ops.push('Q'); // restore graphics state
+    // Inject the operators into the page content stream
+    const stream = PDFRawStream.of(context.obj({}), new TextEncoder().encode(ops.join('\n')));
+    const streamRef = context.register(stream);
+    // Append to page contents
+    const currentContents = pageDict.get(PDFName.of('Contents'));
+    if (currentContents instanceof PDFArray) {
+        currentContents.push(streamRef);
+    }
+    else if (currentContents) {
+        const newArray = PDFArray.withContext(context);
+        newArray.push(currentContents);
+        newArray.push(streamRef);
+        pageDict.set(PDFName.of('Contents'), newArray);
+    }
+    else {
+        pageDict.set(PDFName.of('Contents'), streamRef);
+    }
+}
+/** Format a number for PDF operators (avoid scientific notation). */
+function n(v) {
+    return Number(v.toFixed(4)).toString();
+}
+/**
+ * Build a PDF Function object for gradient color interpolation.
+ * Two stops → Type 2 exponential. More → Type 3 stitching.
+ */
+function buildColorFunction(context, stops) {
+    if (stops.length === 2) {
+        const c0 = parseColor(stops[0].color);
+        const c1 = parseColor(stops[1].color);
+        return context.obj({
+            FunctionType: 2,
+            Domain: [0, 1],
+            C0: [c0.r, c0.g, c0.b],
+            C1: [c1.r, c1.g, c1.b],
+            N: 1,
+        });
+    }
+    // Multi-stop: Type 3 stitching function
+    const functions = [];
+    const bounds = [];
+    const encode = [];
+    for (let i = 0; i < stops.length - 1; i++) {
+        const c0 = parseColor(stops[i].color);
+        const c1 = parseColor(stops[i + 1].color);
+        functions.push(context.obj({
+            FunctionType: 2,
+            Domain: [0, 1],
+            C0: [c0.r, c0.g, c0.b],
+            C1: [c1.r, c1.g, c1.b],
+            N: 1,
+        }));
+        if (i > 0) {
+            bounds.push(stops[i].position);
+        }
+        encode.push(0, 1);
+    }
+    return context.obj({
+        FunctionType: 3,
+        Domain: [0, 1],
+        Functions: functions,
+        Bounds: bounds,
+        Encode: encode,
+    });
+}
+/** Build a Type 2 (axial/linear) shading dictionary. */
+function buildAxialShading(context, gradient, x, y, width, height, colorFunction) {
+    // Convert angle to start/end coordinates
+    const angleRad = (gradient.angle * Math.PI) / 180;
+    const cos = Math.cos(angleRad);
+    const sin = Math.sin(angleRad);
+    // Project the rectangle corners onto the gradient direction
+    const cx = x + width / 2;
+    const cy = y + height / 2;
+    const halfDiag = Math.abs((cos * width) / 2) + Math.abs((sin * height) / 2);
+    const x0 = cx - cos * halfDiag;
+    const y0 = cy + sin * halfDiag; // PDF Y is upward, angle 90 = top-to-bottom = -Y
+    const x1 = cx + cos * halfDiag;
+    const y1 = cy - sin * halfDiag;
+    return context.obj({
+        ShadingType: 2,
+        ColorSpace: 'DeviceRGB',
+        Coords: [x0, y0, x1, y1],
+        Function: colorFunction,
+        Extend: [true, true],
+    });
+}
+/** Build a Type 3 (radial) shading dictionary. */
+function buildRadialShading(context, gradient, x, y, width, height, colorFunction) {
+    const cx = x + (gradient.cx ?? 0.5) * width;
+    const cy = y + (gradient.cy ?? 0.5) * height;
+    const r = (gradient.radius ?? 0.5) * Math.min(width, height);
+    return context.obj({
+        ShadingType: 3,
+        ColorSpace: 'DeviceRGB',
+        Coords: [cx, cy, 0, cx, cy, r],
+        Function: colorFunction,
+        Extend: [true, true],
+    });
+}
+//# sourceMappingURL=gradient.js.map

package/dist/gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.js","sourceRoot":"","sources":["../src/gradient.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { renderPdf, type RenderOptions, type RenderResult } from './renderer.js';
+export { createExpressionEngine, type ExpressionEngine } from './expression.js';
+export { validateData, resolveDotPath, buildScope } from './data.js';
+export { mergePageConfig, type LayoutBand, type LayoutPage, type LayoutResult } from './layout.js';
+export type { BandInstance, ExpandedSection } from './band-expander.js';
+export { embedFonts, collectFontSpecs, mapWeight, type FontSpec } from './fonts.js';
+export { initBrowser } from '@jsonpdf/plugins';
+export { collectAnchors } from './anchors.js';
+export { buildPdfOutline, type BookmarkEntry } from './bookmarks.js';
+export { computeColumnLayout, type ColumnLayout } from './columns.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACnG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { renderPdf } from './renderer.js';
+export { createExpressionEngine } from './expression.js';
+export { validateData, resolveDotPath, buildScope } from './data.js';
+export { mergePageConfig } from './layout.js';
+export { embedFonts, collectFontSpecs, mapWeight } from './fonts.js';
+export { initBrowser } from '@jsonpdf/plugins';
+export { collectAnchors } from './anchors.js';
+export { buildPdfOutline } from './bookmarks.js';
+export { computeColumnLayout } from './columns.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyC,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,eAAe,EAAuD,MAAM,aAAa,CAAC;AAEnG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAiB,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAsB,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAqB,MAAM,cAAc,CAAC"}

package/dist/layout.d.ts

@@ -0,0 +1,54 @@
+import type { PDFDocument } from 'pdf-lib';
+import type { Template, Band, PageConfig } from '@jsonpdf/core';
+import type { FontMap, Plugin, ImageCache } from '@jsonpdf/plugins';
+import type { ExpressionEngine } from './expression.js';
+/** Maximum nesting depth for container elements to prevent infinite recursion. */
+export declare const MAX_CONTAINER_DEPTH = 10;
+export interface LayoutBand {
+    band: Band;
+    offsetY: number;
+    measuredHeight: number;
+    elementHeights: Map<string, number>;
+    scope: Record<string, unknown>;
+    /** Column index (0-based). Undefined for full-width bands. */
+    columnIndex?: number;
+    /** X-offset from left margin for this column. */
+    columnOffsetX?: number;
+    /** Width of this column in points. */
+    columnWidth?: number;
+}
+export interface LayoutPage {
+    sectionIndex: number;
+    pageIndex: number;
+    bands: LayoutBand[];
+    /** Computed page height when autoHeight is enabled. */
+    computedHeight?: number;
+}
+/** A bookmark entry collected during layout for TOC generation. */
+export interface BookmarkLayoutEntry {
+    /** Display title. */
+    title: string;
+    /** 1-based page number. */
+    pageNumber: number;
+    /** Nesting level: 0 = section, 1 = band. */
+    level: number;
+    /** Anchor ID for internal links (derived from section/band id). */
+    anchorId: string;
+}
+export interface LayoutResult {
+    pages: LayoutPage[];
+    totalPages: number;
+    /** Bookmarks collected during layout (for _bookmarks data source). */
+    bookmarks: BookmarkLayoutEntry[];
+}
+/** Merge section-level page config overrides with the template-level defaults. */
+export declare function mergePageConfig(base: PageConfig, override?: Partial<PageConfig>): PageConfig;
+/**
+ * Layout a template across multiple pages.
+ *
+ * Handles all 13 band types, multi-section support, page breaks,
+ * and content overflow. Each LayoutBand carries its Liquid scope
+ * for expression resolution during rendering.
+ */
+export declare function layoutTemplate(template: Template, fonts: FontMap, getPlugin: (type: string) => Plugin, engine: ExpressionEngine, data: Record<string, unknown>, totalPagesHint: number, pdfDoc: PDFDocument, imageCache: ImageCache): Promise<LayoutResult>;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAW,QAAQ,EAAE,IAAI,EAAY,UAAU,EAAkB,MAAM,eAAe,CAAC;AACnG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAO5F;AAwPD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,YAAY,CAAC,CAyEvB"}