@jsonpdf/renderer 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JsonPDF
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @jsonpdf/renderer
+
+PDF generation pipeline for jsonpdf — takes a template and data, produces a PDF.
+
+## Pipeline
+
+```
+Template + Data
+  → Validate (schema check)
+  → Resolve (LiquidJS expressions → concrete values)
+  → Measure (compute element sizes via plugins)
+  → Layout (page breaks, columns, band placement)
+  → Render (draw to PDF via pdf-lib)
+  → PDF bytes
+```
+
+The renderer uses **two-pass rendering** to support `_totalPages` — the first pass computes the page count, then the second pass renders with the final value available.
+
+## Features
+
+- LiquidJS expression binding with dot-path data resolution
+- Conditional bands (show/hide based on expressions)
+- Data-driven band iteration (`dataSource` property)
+- Multi-section layouts with independent page configurations
+- Multi-column layouts
+- Footnotes
+- PDF bookmarks/outlines
+- Anchor links
+- Gradient fills
+- Font embedding with weight/style variants
+
+## Usage
+
+```ts
+import { renderPdf } from '@jsonpdf/renderer';
+
+const result = await renderPdf(template, data, {
+  fonts: fontMap,
+});
+
+// result.pdf — Uint8Array of PDF bytes
+// result.pages — number of pages rendered
+```
+
+## Exports
+
+| Category    | Exports                                                       |
+| ----------- | ------------------------------------------------------------- |
+| Main        | `renderPdf`, `RenderOptions`, `RenderResult`                  |
+| Expressions | `createExpressionEngine`, `ExpressionEngine`                  |
+| Data        | `validateData`, `resolveDotPath`, `buildScope`                |
+| Layout      | `mergePageConfig`, `LayoutBand`, `LayoutPage`, `LayoutResult` |
+| Bands       | `BandInstance`, `ExpandedSection`                             |
+| Fonts       | `embedFonts`, `collectFontSpecs`, `mapWeight`, `FontSpec`     |
+| Bookmarks   | `collectAnchors`, `buildPdfOutline`, `BookmarkEntry`          |
+| Columns     | `computeColumnLayout`, `ColumnLayout`                         |
+| Platform    | `initBrowser` (re-exported from `@jsonpdf/plugins`)           |

package/dist/anchors.d.ts

@@ -0,0 +1,13 @@
+import type { LayoutResult } from './layout.js';
+/**
+ * Collect all anchor IDs from a layout result.
+ * Returns a map from anchor ID to 1-based page number.
+ *
+ * Scans both band-level anchors (`band.anchor`) and element-level
+ * anchors (`element.anchor`). If the same anchor ID appears multiple
+ * times, the first occurrence wins.
+ */
+export declare function collectAnchors(layout: LayoutResult, options?: {
+    warnOnDuplicates?: boolean;
+}): Map<string, number>;
+//# sourceMappingURL=anchors.d.ts.map

package/dist/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCrB"}

package/dist/anchors.js

@@ -0,0 +1,37 @@
+/**
+ * Collect all anchor IDs from a layout result.
+ * Returns a map from anchor ID to 1-based page number.
+ *
+ * Scans both band-level anchors (`band.anchor`) and element-level
+ * anchors (`element.anchor`). If the same anchor ID appears multiple
+ * times, the first occurrence wins.
+ */
+export function collectAnchors(layout, options) {
+    const warn = options?.warnOnDuplicates ?? false;
+    const anchors = new Map();
+    for (const page of layout.pages) {
+        const pageNumber = page.pageIndex + 1;
+        for (const layoutBand of page.bands) {
+            if (layoutBand.band.anchor) {
+                if (!anchors.has(layoutBand.band.anchor)) {
+                    anchors.set(layoutBand.band.anchor, pageNumber);
+                }
+                else if (warn) {
+                    console.warn(`Duplicate anchor "${layoutBand.band.anchor}" on page ${String(pageNumber)}; first occurrence on page ${String(anchors.get(layoutBand.band.anchor))} used`);
+                }
+            }
+            for (const element of layoutBand.band.elements) {
+                if (element.anchor) {
+                    if (!anchors.has(element.anchor)) {
+                        anchors.set(element.anchor, pageNumber);
+                    }
+                    else if (warn) {
+                        console.warn(`Duplicate anchor "${element.anchor}" on page ${String(pageNumber)}; first occurrence on page ${String(anchors.get(element.anchor))} used`);
+                    }
+                }
+            }
+        }
+    }
+    return anchors;
+}
+//# sourceMappingURL=anchors.js.map

package/dist/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAoB,EACpB,OAAwC;IAExC,MAAM,IAAI,GAAG,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAEtC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAClD,CAAC;qBAAM,IAAI,IAAI,EAAE,CAAC;oBAChB,OAAO,CAAC,IAAI,CACV,qBAAqB,UAAU,CAAC,IAAI,CAAC,MAAM,aAAa,MAAM,CAAC,UAAU,CAAC,8BAA8B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAC3J,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;wBACjC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBAC1C,CAAC;yBAAM,IAAI,IAAI,EAAE,CAAC;wBAChB,OAAO,CAAC,IAAI,CACV,qBAAqB,OAAO,CAAC,MAAM,aAAa,MAAM,CAAC,UAAU,CAAC,8BAA8B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAC3I,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/band-expander.d.ts

@@ -0,0 +1,25 @@
+import type { Band, Section } from '@jsonpdf/core';
+import type { ExpressionEngine } from './expression.js';
+/** A band instance with its associated Liquid scope. */
+export interface BandInstance {
+    band: Band;
+    scope: Record<string, unknown>;
+}
+/** Bands separated by their structural role within a section. */
+export interface ExpandedSection {
+    pageHeaderBands: Band[];
+    pageFooterBands: Band[];
+    lastPageFooterBands: Band[];
+    columnHeaderBands: Band[];
+    columnFooterBands: Band[];
+    backgroundBands: Band[];
+    contentBands: BandInstance[];
+}
+/**
+ * Expand a section's bands into structural roles and ordered content instances.
+ *
+ * Content band ordering: title → [groupHeader → detail items → groupFooter] → body → summary
+ * NoData bands are included only when detail bands exist but produce no items.
+ */
+export declare function expandBands(section: Section, data: Record<string, unknown>, engine: ExpressionEngine, totalPages: number): Promise<ExpandedSection>;
+//# sourceMappingURL=band-expander.d.ts.map

package/dist/band-expander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"band-expander.d.ts","sourceRoot":"","sources":["../src/band-expander.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,IAAI,EAAE,CAAC;IACxB,eAAe,EAAE,IAAI,EAAE,CAAC;IACxB,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAC5B,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC1B,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC1B,eAAe,EAAE,IAAI,EAAE,CAAC;IACxB,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAoK1B"}

package/dist/band-expander.js

@@ -0,0 +1,193 @@
+import { resolveDotPath, buildScope } from './data.js';
+/**
+ * Expand a section's bands into structural roles and ordered content instances.
+ *
+ * Content band ordering: title → [groupHeader → detail items → groupFooter] → body → summary
+ * NoData bands are included only when detail bands exist but produce no items.
+ */
+export async function expandBands(section, data, engine, totalPages) {
+    const result = {
+        pageHeaderBands: [],
+        pageFooterBands: [],
+        lastPageFooterBands: [],
+        columnHeaderBands: [],
+        columnFooterBands: [],
+        backgroundBands: [],
+        contentBands: [],
+    };
+    // Separate structural bands
+    const titleBands = [];
+    const detailBands = [];
+    const bodyBands = [];
+    const summaryBands = [];
+    const noDataBands = [];
+    const groupHeaderBands = [];
+    const groupFooterBands = [];
+    for (const band of section.bands) {
+        switch (band.type) {
+            case 'pageHeader':
+                result.pageHeaderBands.push(band);
+                break;
+            case 'pageFooter':
+                result.pageFooterBands.push(band);
+                break;
+            case 'lastPageFooter':
+                result.lastPageFooterBands.push(band);
+                break;
+            case 'columnHeader':
+                result.columnHeaderBands.push(band);
+                break;
+            case 'columnFooter':
+                result.columnFooterBands.push(band);
+                break;
+            case 'background':
+                result.backgroundBands.push(band);
+                break;
+            case 'title':
+                titleBands.push(band);
+                break;
+            case 'detail':
+                detailBands.push(band);
+                break;
+            case 'body':
+                bodyBands.push(band);
+                break;
+            case 'summary':
+                summaryBands.push(band);
+                break;
+            case 'noData':
+                noDataBands.push(band);
+                break;
+            case 'groupHeader':
+                groupHeaderBands.push(band);
+                break;
+            case 'groupFooter':
+                groupFooterBands.push(band);
+                break;
+        }
+    }
+    const baseScope = buildScope(data, 0, totalPages);
+    // Title bands (first in content order)
+    for (const band of titleBands) {
+        if (await shouldInclude(band, baseScope, engine)) {
+            result.contentBands.push({ band, scope: baseScope });
+        }
+    }
+    // Detail bands with iteration
+    let hasDetailItems = false;
+    for (const band of detailBands) {
+        if (!band.dataSource) {
+            throw new Error(`Detail band "${band.id}" must have a dataSource property`);
+        }
+        const sourceArray = resolveDotPath(data, band.dataSource);
+        if (!Array.isArray(sourceArray) || sourceArray.length === 0) {
+            continue;
+        }
+        hasDetailItems = true;
+        const itemName = band.itemName ?? 'item';
+        if (band.groupBy) {
+            // Group the array
+            const groups = groupByKey(sourceArray, band.groupBy);
+            for (const group of groups) {
+                const groupScope = {
+                    ...baseScope,
+                    _groupKey: group.key,
+                    _groupItems: group.items,
+                };
+                // Group headers
+                for (const gh of groupHeaderBands) {
+                    if (await shouldInclude(gh, groupScope, engine)) {
+                        result.contentBands.push({ band: gh, scope: groupScope });
+                    }
+                }
+                // Detail items within group
+                for (let i = 0; i < group.items.length; i++) {
+                    const itemScope = buildScope(data, 0, totalPages, {
+                        item: group.items[i],
+                        itemName,
+                        index: i,
+                    });
+                    itemScope['_groupKey'] = group.key;
+                    if (await shouldInclude(band, itemScope, engine)) {
+                        result.contentBands.push({ band, scope: itemScope });
+                    }
+                }
+                // Group footers
+                for (const gf of groupFooterBands) {
+                    if (await shouldInclude(gf, groupScope, engine)) {
+                        result.contentBands.push({ band: gf, scope: groupScope });
+                    }
+                }
+            }
+        }
+        else {
+            // Simple iteration
+            for (let i = 0; i < sourceArray.length; i++) {
+                const itemScope = buildScope(data, 0, totalPages, {
+                    item: sourceArray[i],
+                    itemName,
+                    index: i,
+                });
+                if (await shouldInclude(band, itemScope, engine)) {
+                    result.contentBands.push({ band, scope: itemScope });
+                }
+            }
+        }
+    }
+    // NoData bands (only when no detail items were produced)
+    if (!hasDetailItems && detailBands.length > 0 && noDataBands.length > 0) {
+        for (const band of noDataBands) {
+            if (await shouldInclude(band, baseScope, engine)) {
+                result.contentBands.push({ band, scope: baseScope });
+            }
+        }
+    }
+    // Body bands
+    for (const band of bodyBands) {
+        if (await shouldInclude(band, baseScope, engine)) {
+            result.contentBands.push({ band, scope: baseScope });
+        }
+    }
+    // Summary bands (last in content order)
+    for (const band of summaryBands) {
+        if (await shouldInclude(band, baseScope, engine)) {
+            result.contentBands.push({ band, scope: baseScope });
+        }
+    }
+    return result;
+}
+/** Check if a band should be included based on its condition. */
+async function shouldInclude(band, scope, engine) {
+    if (!band.condition)
+        return true;
+    return engine.evaluate(band.condition, scope);
+}
+/** Group an array by a property path. */
+function groupByKey(array, keyPath) {
+    const groupMap = new Map();
+    const groupOrder = [];
+    for (const item of array) {
+        let key;
+        if (item !== null && typeof item === 'object') {
+            const val = item[keyPath];
+            if (typeof val === 'string')
+                key = val;
+            else if (typeof val === 'number' || typeof val === 'boolean')
+                key = String(val);
+            else
+                key = '';
+        }
+        else {
+            key = '';
+        }
+        if (!groupMap.has(key)) {
+            groupMap.set(key, []);
+            groupOrder.push(key);
+        }
+        const items = groupMap.get(key);
+        if (items)
+            items.push(item);
+    }
+    return groupOrder.map((key) => ({ key, items: groupMap.get(key) ?? [] }));
+}
+//# sourceMappingURL=band-expander.js.map

package/dist/band-expander.js.map

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

package/dist/bookmarks.d.ts

@@ -0,0 +1,22 @@
+import type { PDFDocument, PDFPage } from 'pdf-lib';
+export interface BookmarkEntry {
+    /** Display title in the PDF outline panel. */
+    title: string;
+    /** The PDF page this bookmark points to. */
+    page: PDFPage;
+    /** Y position in pdf-lib coordinates (from bottom of page). */
+    top: number;
+    /** X position in pdf-lib coordinates. */
+    left: number;
+    /** Nesting level: 0 = section, 1 = band. */
+    level: number;
+}
+/**
+ * Build a PDF outline (bookmarks panel) from collected entries.
+ *
+ * Level 0 entries become top-level items. Level 1+ entries become
+ * children of the most recent lower-level entry. Items at the same
+ * level are siblings.
+ */
+export declare function buildPdfOutline(doc: PDFDocument, entries: BookmarkEntry[]): void;
+//# sourceMappingURL=bookmarks.d.ts.map

package/dist/bookmarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarks.d.ts","sourceRoot":"","sources":["../src/bookmarks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAsB,MAAM,SAAS,CAAC;AAGxE,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,CA8ChF"}

package/dist/bookmarks.js

@@ -0,0 +1,78 @@
+import { PDFName, PDFString, PDFNumber, PDFArray, PDFNull } from 'pdf-lib';
+/**
+ * Build a PDF outline (bookmarks panel) from collected entries.
+ *
+ * Level 0 entries become top-level items. Level 1+ entries become
+ * children of the most recent lower-level entry. Items at the same
+ * level are siblings.
+ */
+export function buildPdfOutline(doc, entries) {
+    if (entries.length === 0)
+        return;
+    const context = doc.context;
+    // Build hierarchy using a stack
+    const rootItems = [];
+    const stack = [];
+    for (const entry of entries) {
+        const dest = createDestination(context, entry);
+        const dict = context.obj({
+            Title: PDFString.of(entry.title),
+            Dest: dest,
+        });
+        const ref = context.register(dict);
+        const item = { ref, dict, entry, children: [] };
+        // Pop stack until we find a parent at a lower level
+        while (stack.length > 0 && stack[stack.length - 1].entry.level >= entry.level) {
+            stack.pop();
+        }
+        if (stack.length > 0) {
+            stack[stack.length - 1].children.push(item);
+        }
+        else {
+            rootItems.push(item);
+        }
+        stack.push(item);
+    }
+    // Create outline root dictionary
+    const outlineDict = context.obj({ Type: 'Outlines' });
+    const outlineRef = context.register(outlineDict);
+    // Recursively link items with Parent/Prev/Next/First/Last/Count
+    const totalCount = linkItems(rootItems, outlineRef);
+    outlineDict.set(PDFName.of('First'), rootItems[0].ref);
+    outlineDict.set(PDFName.of('Last'), rootItems[rootItems.length - 1].ref);
+    outlineDict.set(PDFName.of('Count'), PDFNumber.of(totalCount));
+    // Set the outline on the document catalog
+    doc.catalog.set(PDFName.of('Outlines'), outlineRef);
+}
+function linkItems(items, parentRef) {
+    let totalCount = 0;
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        item.dict.set(PDFName.of('Parent'), parentRef);
+        if (i > 0) {
+            item.dict.set(PDFName.of('Prev'), items[i - 1].ref);
+        }
+        if (i < items.length - 1) {
+            item.dict.set(PDFName.of('Next'), items[i + 1].ref);
+        }
+        totalCount++;
+        if (item.children.length > 0) {
+            const childCount = linkItems(item.children, item.ref);
+            item.dict.set(PDFName.of('First'), item.children[0].ref);
+            item.dict.set(PDFName.of('Last'), item.children[item.children.length - 1].ref);
+            item.dict.set(PDFName.of('Count'), PDFNumber.of(childCount));
+            totalCount += childCount;
+        }
+    }
+    return totalCount;
+}
+function createDestination(context, entry) {
+    const arr = PDFArray.withContext(context);
+    arr.push(entry.page.ref);
+    arr.push(PDFName.of('XYZ'));
+    arr.push(PDFNumber.of(entry.left));
+    arr.push(PDFNumber.of(entry.top));
+    arr.push(PDFNull);
+    return arr;
+}
+//# sourceMappingURL=bookmarks.js.map

package/dist/bookmarks.js.map

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

package/dist/columns.d.ts

@@ -0,0 +1,18 @@
+/** Computed column geometry for multi-column layout. */
+export interface ColumnLayout {
+    /** Width of each column in points. */
+    widths: number[];
+    /** X-offset from the left margin for each column. */
+    offsets: number[];
+    /** Gap between columns. */
+    gap: number;
+}
+/**
+ * Compute column layout geometry.
+ *
+ * Equal columns: `width = (contentWidth - (columns - 1) * gap) / columns`
+ * Asymmetric: `columnWidths` are ratios normalized to fill available space.
+ * If `columnWidths.length` doesn't match `columns`, falls back to equal.
+ */
+export declare function computeColumnLayout(contentWidth: number, columns: number, columnGap: number, columnWidths?: number[]): ColumnLayout;
+//# sourceMappingURL=columns.d.ts.map

package/dist/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../src/columns.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,YAAY,CAyBd"}

package/dist/columns.js

@@ -0,0 +1,31 @@
+/**
+ * Compute column layout geometry.
+ *
+ * Equal columns: `width = (contentWidth - (columns - 1) * gap) / columns`
+ * Asymmetric: `columnWidths` are ratios normalized to fill available space.
+ * If `columnWidths.length` doesn't match `columns`, falls back to equal.
+ */
+export function computeColumnLayout(contentWidth, columns, columnGap, columnWidths) {
+    if (columns <= 1) {
+        return { widths: [contentWidth], offsets: [0], gap: 0 };
+    }
+    const totalGap = (columns - 1) * columnGap;
+    const availableWidth = Math.max(0, contentWidth - totalGap);
+    let widths;
+    if (columnWidths && columnWidths.length === columns) {
+        const totalRatio = columnWidths.reduce((sum, r) => sum + r, 0);
+        widths = columnWidths.map((r) => (r / totalRatio) * availableWidth);
+    }
+    else {
+        const w = availableWidth / columns;
+        widths = Array.from({ length: columns }, () => w);
+    }
+    const offsets = [];
+    let x = 0;
+    for (let i = 0; i < columns; i++) {
+        offsets.push(x);
+        x += widths[i] + columnGap;
+    }
+    return { widths, offsets, gap: columnGap };
+}
+//# sourceMappingURL=columns.js.map

package/dist/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../src/columns.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,OAAe,EACf,SAAiB,EACjB,YAAuB;IAEvB,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,CAAC;IAE5D,IAAI,MAAgB,CAAC;IACrB,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,cAAc,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,cAAc,GAAG,OAAO,CAAC;QACnC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AAC7C,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,8 @@
+import type { PDFDocument, PDFPage } from 'pdf-lib';
+import type { MeasureContext, RenderContext, FontMap, ImageCache } from '@jsonpdf/plugins';
+import type { Element, Style } from '@jsonpdf/core';
+/** Create a MeasureContext for an element. */
+export declare function createMeasureContext(element: Element, fonts: FontMap, styles: Record<string, Style>, defaultStyle: Style, pdfDoc: PDFDocument, imageCache: ImageCache): MeasureContext;
+/** Create a RenderContext for an element. */
+export declare function createRenderContext(element: Element, fonts: FontMap, styles: Record<string, Style>, defaultStyle: Style, page: PDFPage, bandOffsetY: number, pageHeight: number, marginTop: number, marginLeft: number, pdfDoc: PDFDocument, imageCache: ImageCache, measuredHeight?: number): RenderContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAIpD,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,YAAY,EAAE,KAAK,EACnB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,GACrB,cAAc,CAYhB;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,YAAY,EAAE,KAAK,EACnB,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,aAAa,CAyBf"}

package/dist/context.js

@@ -0,0 +1,38 @@
+import { resolveElementStyle, resolveNamedStyle, normalizePadding } from './style-resolver.js';
+import { templateToPdf } from './coordinate.js';
+/** Create a MeasureContext for an element. */
+export function createMeasureContext(element, fonts, styles, defaultStyle, pdfDoc, imageCache) {
+    const elementStyle = resolveElementStyle(element, styles, defaultStyle);
+    const padding = normalizePadding(elementStyle.padding);
+    return {
+        fonts,
+        availableWidth: element.width - padding.left - padding.right,
+        availableHeight: element.height - padding.top - padding.bottom,
+        resolveStyle: (name) => resolveNamedStyle(name, styles, defaultStyle),
+        elementStyle,
+        pdfDoc,
+        imageCache,
+    };
+}
+/** Create a RenderContext for an element. */
+export function createRenderContext(element, fonts, styles, defaultStyle, page, bandOffsetY, pageHeight, marginTop, marginLeft, pdfDoc, imageCache, measuredHeight) {
+    const elementStyle = resolveElementStyle(element, styles, defaultStyle);
+    const padding = normalizePadding(elementStyle.padding);
+    const { x, y } = templateToPdf(element.x, bandOffsetY + element.y, pageHeight, marginTop, marginLeft);
+    const height = measuredHeight ?? element.height;
+    return {
+        fonts,
+        availableWidth: element.width - padding.left - padding.right,
+        availableHeight: height - padding.top - padding.bottom,
+        resolveStyle: (name) => resolveNamedStyle(name, styles, defaultStyle),
+        elementStyle,
+        pdfDoc,
+        imageCache,
+        page,
+        x: x + padding.left,
+        y: y - padding.top,
+        width: element.width - padding.left - padding.right,
+        height: height - padding.top - padding.bottom,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,8CAA8C;AAC9C,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,KAAc,EACd,MAA6B,EAC7B,YAAmB,EACnB,MAAmB,EACnB,UAAsB;IAEtB,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACvD,OAAO;QACL,KAAK;QACL,cAAc,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK;QAC5D,eAAe,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM;QAC9D,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC;QAC7E,YAAY;QACZ,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,KAAc,EACd,MAA6B,EAC7B,YAAmB,EACnB,IAAa,EACb,WAAmB,EACnB,UAAkB,EAClB,SAAiB,EACjB,UAAkB,EAClB,MAAmB,EACnB,UAAsB,EACtB,cAAuB;IAEvB,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,aAAa,CAC5B,OAAO,CAAC,CAAC,EACT,WAAW,GAAG,OAAO,CAAC,CAAC,EACvB,UAAU,EACV,SAAS,EACT,UAAU,CACX,CAAC;IACF,MAAM,MAAM,GAAG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,OAAO;QACL,KAAK;QACL,cAAc,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK;QAC5D,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM;QACtD,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC;QAC7E,YAAY;QACZ,MAAM;QACN,UAAU;QACV,IAAI;QACJ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI;QACnB,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK;QACnD,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM;KAC9C,CAAC;AACJ,CAAC"}

package/dist/coordinate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Translate from template coordinates (top-left origin) to pdf-lib
+ * coordinates (bottom-left origin).
+ *
+ * Template: (0, 0) = top-left of content area, Y goes down.
+ * pdf-lib:  (0, 0) = bottom-left of page, Y goes up.
+ *
+ * Returns the top of the element in pdf-lib coordinates.
+ */
+export declare function templateToPdf(templateX: number, templateY: number, pageHeight: number, marginTop: number, marginLeft: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=coordinate.d.ts.map

package/dist/coordinate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate.d.ts","sourceRoot":"","sources":["../src/coordinate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B"}

package/dist/coordinate.js

@@ -0,0 +1,16 @@
+/**
+ * Translate from template coordinates (top-left origin) to pdf-lib
+ * coordinates (bottom-left origin).
+ *
+ * Template: (0, 0) = top-left of content area, Y goes down.
+ * pdf-lib:  (0, 0) = bottom-left of page, Y goes up.
+ *
+ * Returns the top of the element in pdf-lib coordinates.
+ */
+export function templateToPdf(templateX, templateY, pageHeight, marginTop, marginLeft) {
+    return {
+        x: marginLeft + templateX,
+        y: pageHeight - marginTop - templateY,
+    };
+}
+//# sourceMappingURL=coordinate.js.map