@jsonpdf/renderer 0.1.0-alpha.1

package/dist/coordinate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate.js","sourceRoot":"","sources":["../src/coordinate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,SAAiB,EACjB,UAAkB,EAClB,SAAiB,EACjB,UAAkB;IAElB,OAAO;QACL,CAAC,EAAE,UAAU,GAAG,SAAS;QACzB,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS;KACtC,CAAC;AACJ,CAAC"}

package/dist/data.d.ts

@@ -0,0 +1,18 @@
+import type { JSONSchema } from '@jsonpdf/core';
+/** Validate user data against a template's dataSchema. Throws on failure. */
+export declare function validateData(data: Record<string, unknown>, schema: JSONSchema): void;
+/**
+ * Return a copy of `data` with `default` values from the schema filled in
+ * for any missing properties. Uses AJV's `useDefaults` option.
+ */
+export declare function applySchemaDefaults(data: Record<string, unknown>, schema: JSONSchema): Record<string, unknown>;
+/** Resolve a dot-separated path against a data object. */
+export declare function resolveDotPath(data: Record<string, unknown>, path: string): unknown;
+export interface ItemContext {
+    item: unknown;
+    itemName: string;
+    index: number;
+}
+/** Build a Liquid scope from data, page info, and optional item context. */
+export declare function buildScope(data: Record<string, unknown>, pageNumber: number, totalPages: number, itemContext?: ItemContext): Record<string, unknown>;
+//# sourceMappingURL=data.d.ts.map

package/dist/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAWpF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUnF;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,WAAW,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}

package/dist/data.js

@@ -0,0 +1,56 @@
+import { validateWithSchema, applySchemaDefaults as coreApplyDefaults } from '@jsonpdf/core';
+/** Validate user data against a template's dataSchema. Throws on failure. */
+export function validateData(data, schema) {
+    // Skip validation if schema is empty or just { type: 'object' }
+    const keys = Object.keys(schema);
+    if (keys.length === 0)
+        return;
+    if (keys.length === 1 && schema['type'] === 'object')
+        return;
+    const result = validateWithSchema(schema, data);
+    if (!result.valid) {
+        const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');
+        throw new Error(`Data validation failed: ${messages}`);
+    }
+}
+/**
+ * Return a copy of `data` with `default` values from the schema filled in
+ * for any missing properties. Uses AJV's `useDefaults` option.
+ */
+export function applySchemaDefaults(data, schema) {
+    const keys = Object.keys(schema);
+    if (keys.length === 0)
+        return data;
+    if (keys.length === 1 && schema['type'] === 'object')
+        return data;
+    return coreApplyDefaults(schema, data);
+}
+/** Resolve a dot-separated path against a data object. */
+export function resolveDotPath(data, path) {
+    if (!path)
+        return undefined;
+    const segments = path.split('.');
+    let current = data;
+    for (const segment of segments) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+/** Build a Liquid scope from data, page info, and optional item context. */
+export function buildScope(data, pageNumber, totalPages, itemContext) {
+    const scope = {
+        ...data,
+        _pageNumber: pageNumber,
+        _totalPages: totalPages,
+    };
+    if (itemContext) {
+        scope[itemContext.itemName] = itemContext.item;
+        scope['_index'] = itemContext.index;
+    }
+    return scope;
+}
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7F,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,IAA6B,EAAE,MAAkB;IAC5E,gEAAgE;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,OAAO;IAE7D,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA6B,EAC7B,MAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAElE,OAAO,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,IAA6B,EAAE,IAAY;IACxE,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAChE,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAClD,OAAO,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAQD,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CACxB,IAA6B,EAC7B,UAAkB,EAClB,UAAkB,EAClB,WAAyB;IAEzB,MAAM,KAAK,GAA4B;QACrC,GAAG,IAAI;QACP,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,UAAU;KACxB,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;QAC/C,KAAK,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/expression.d.ts

@@ -0,0 +1,13 @@
+export interface ExpressionEngine {
+    /** Resolve Liquid expressions in a string. */
+    resolve(template: string, scope: Record<string, unknown>): Promise<string>;
+    /** Recursively resolve all string values in a props object. */
+    resolveProps(props: Record<string, unknown>, scope: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Evaluate a Liquid expression as a boolean. */
+    evaluate(expression: string, scope: Record<string, unknown>): Promise<boolean>;
+    /** Register a custom Liquid filter. */
+    registerFilter(name: string, fn: (value: unknown, ...args: unknown[]) => unknown): void;
+}
+/** Create a new expression engine with custom filters. */
+export declare function createExpressionEngine(): ExpressionEngine;
+//# sourceMappingURL=expression.d.ts.map

package/dist/expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../src/expression.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E,+DAA+D;IAC/D,YAAY,CACV,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/E,uCAAuC;IACvC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACzF;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,IAAI,gBAAgB,CAkGzD"}

package/dist/expression.js

@@ -0,0 +1,90 @@
+import { Liquid } from 'liquidjs';
+/** Create a new expression engine with custom filters. */
+export function createExpressionEngine() {
+    const liquid = new Liquid({
+        strictVariables: false,
+        strictFilters: false,
+    });
+    // Cache parsed Liquid templates to avoid re-parsing identical expression strings
+    const parseCache = new Map();
+    function getParsed(templateStr) {
+        let parsed = parseCache.get(templateStr);
+        if (!parsed) {
+            parsed = liquid.parse(templateStr);
+            parseCache.set(templateStr, parsed);
+        }
+        return parsed;
+    }
+    liquid.registerFilter('money', (value, currency) => {
+        const num = Number(value);
+        if (isNaN(num))
+            return String(value);
+        return new Intl.NumberFormat('en-US', {
+            style: 'currency',
+            currency: typeof currency === 'string' ? currency : 'USD',
+        }).format(num);
+    });
+    liquid.registerFilter('pad', (value, width, char) => {
+        return String(value).padStart(Number(width) || 0, typeof char === 'string' ? char : ' ');
+    });
+    async function resolve(template, scope) {
+        const parsed = getParsed(template);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const result = await liquid.render(parsed, scope);
+        return result;
+    }
+    // Matches a pure Liquid expression: exactly {{ expr }} with nothing else
+    const PURE_EXPR_RE = /^\{\{\s*(.+?)\s*\}\}$/;
+    async function resolveValue(value, scope) {
+        if (typeof value === 'string') {
+            // For pure expressions like "{{ departmentSummary }}", return the raw
+            // scope value when it resolves to a non-primitive (array/object).
+            // This allows properties like chart.dataSource to receive actual arrays
+            // instead of their stringified representation.
+            const match = value.match(PURE_EXPR_RE);
+            if (match) {
+                try {
+                    const raw = await liquid.evalValue(match[1], scope);
+                    if (raw !== null && raw !== undefined && typeof raw === 'object') {
+                        return raw;
+                    }
+                }
+                catch {
+                    // evalValue can't handle all Liquid syntax (e.g. filters with |).
+                    // Fall through to normal string resolution.
+                }
+            }
+            return resolve(value, scope);
+        }
+        if (Array.isArray(value)) {
+            return Promise.all(value.map((item) => resolveValue(item, scope)));
+        }
+        if (value !== null && typeof value === 'object') {
+            const result = {};
+            for (const [k, v] of Object.entries(value)) {
+                result[k] = await resolveValue(v, scope);
+            }
+            return result;
+        }
+        return value;
+    }
+    async function resolveProps(props, scope) {
+        return (await resolveValue(props, scope));
+    }
+    async function evaluate(expression, scope) {
+        // Safety note: `expression` is interpolated directly into a Liquid template.
+        // This is safe because conditions come from template definitions (developer-authored),
+        // not from end-user data. If template authoring is ever opened to untrusted users,
+        // this would need to be sanitized against template injection.
+        const wrapped = `{% if ${expression} %}true{% endif %}`;
+        const parsed = getParsed(wrapped);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const result = await liquid.render(parsed, scope);
+        return result.trim() === 'true';
+    }
+    function registerFilter(name, fn) {
+        liquid.registerFilter(name, fn);
+    }
+    return { resolve, resolveProps, evaluate, registerFilter };
+}
+//# sourceMappingURL=expression.js.map

package/dist/expression.js.map

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

package/dist/font-loader.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Load font bytes from a source path or URL.
+ *
+ * - HTTP/HTTPS URLs are fetched via fetch() with a 30s timeout
+ * - file:// URLs and local paths are handled by the platform-specific readFileBytes
+ */
+export declare function loadFontBytes(src: string): Promise<Uint8Array>;
+//# sourceMappingURL=font-loader.d.ts.map

package/dist/font-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-loader.d.ts","sourceRoot":"","sources":["../src/font-loader.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBpE"}

package/dist/font-loader.js

@@ -0,0 +1,29 @@
+import { readFileBytes } from '@jsonpdf/plugins';
+/** Default fetch timeout in milliseconds (30 seconds). */
+const FETCH_TIMEOUT_MS = 30_000;
+/**
+ * Load font bytes from a source path or URL.
+ *
+ * - HTTP/HTTPS URLs are fetched via fetch() with a 30s timeout
+ * - file:// URLs and local paths are handled by the platform-specific readFileBytes
+ */
+export async function loadFontBytes(src) {
+    if (src.startsWith('http://') || src.startsWith('https://')) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => {
+            controller.abort();
+        }, FETCH_TIMEOUT_MS);
+        try {
+            const response = await fetch(src, { signal: controller.signal });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch font: ${String(response.status)} ${response.statusText}`);
+            }
+            return new Uint8Array(await response.arrayBuffer());
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    return readFileBytes(src);
+}
+//# sourceMappingURL=font-loader.js.map

package/dist/font-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-loader.js","sourceRoot":"","sources":["../src/font-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/fonts.d.ts

@@ -0,0 +1,19 @@
+import type { PDFDocument } from 'pdf-lib';
+import type { FontMap } from '@jsonpdf/plugins';
+import type { Template, FontDeclaration } from '@jsonpdf/core';
+export interface FontSpec {
+    family: string;
+    weight: 'normal' | 'bold';
+    style: 'normal' | 'italic';
+}
+/** Map a numeric font weight to 'normal' or 'bold'. */
+export declare function mapWeight(weight?: number): 'normal' | 'bold';
+/**
+ * Embed all required fonts. Each font spec must have a matching
+ * FontDeclaration with base64-encoded data. Fontkit must be registered
+ * on the doc before calling this function.
+ */
+export declare function embedFonts(doc: PDFDocument, specs: FontSpec[], fontDeclarations: FontDeclaration[]): Promise<FontMap>;
+/** Collect all unique font specs referenced in a template's styles. */
+export declare function collectFontSpecs(template: Template): FontSpec[];
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAoB,eAAe,EAAW,MAAM,eAAe,CAAC;AAG1F,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC5B;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAG5D;AAuBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,gBAAgB,EAAE,eAAe,EAAE,GAClC,OAAO,CAAC,OAAO,CAAC,CAiClB;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAyE/D"}

package/dist/fonts.js

@@ -0,0 +1,124 @@
+import { fontKey } from '@jsonpdf/plugins';
+import { resolveElementStyle } from './style-resolver.js';
+/** Map a numeric font weight to 'normal' or 'bold'. */
+export function mapWeight(weight) {
+    if (weight === undefined)
+        return 'normal';
+    return weight > 500 ? 'bold' : 'normal';
+}
+/**
+ * Find a FontDeclaration that matches a given font spec.
+ * Tries exact match (family + weight + style) first, then falls back
+ * to any declaration with the same family name.
+ */
+function findDeclaration(spec, declarations) {
+    const familyLower = spec.family.toLowerCase();
+    let familyFallback;
+    for (const d of declarations) {
+        if (d.family.toLowerCase() !== familyLower)
+            continue;
+        const weightMatch = mapWeight(d.weight) === spec.weight;
+        const styleMatch = (d.style ?? 'normal') === spec.style;
+        if (weightMatch && styleMatch)
+            return d;
+        familyFallback ??= d;
+    }
+    return familyFallback;
+}
+/**
+ * Embed all required fonts. Each font spec must have a matching
+ * FontDeclaration with base64-encoded data. Fontkit must be registered
+ * on the doc before calling this function.
+ */
+export async function embedFonts(doc, specs, fontDeclarations) {
+    const fonts = new Map();
+    const uniqueKeys = new Set();
+    for (const spec of specs) {
+        uniqueKeys.add(fontKey(spec.family, spec.weight, spec.style));
+    }
+    for (const key of uniqueKeys) {
+        if (fonts.has(key))
+            continue;
+        const [family, weight, style] = key.split(':');
+        const spec = { family, weight, style };
+        const decl = findDeclaration(spec, fontDeclarations);
+        if (!decl) {
+            throw new Error(`No font declaration found for "${key}". Declare the font in template.fonts.`);
+        }
+        const binary = atob(decl.data);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        const embedded = await doc.embedFont(bytes, { subset: true });
+        fonts.set(key, embedded);
+    }
+    return fonts;
+}
+/** Collect all unique font specs referenced in a template's styles. */
+export function collectFontSpecs(template) {
+    const specs = new Map();
+    const defaultFamily = template.defaultStyle.fontFamily;
+    function addFromStyle(style) {
+        const family = style.fontFamily ?? defaultFamily;
+        const weight = style.fontWeight ?? 'normal';
+        const fontStyle = style.fontStyle ?? 'normal';
+        const key = fontKey(family, weight, fontStyle);
+        if (!specs.has(key)) {
+            specs.set(key, { family, weight, style: fontStyle });
+        }
+    }
+    // Always include the default font so the font map is never empty
+    addFromStyle(template.defaultStyle);
+    // Named styles
+    for (const style of Object.values(template.styles)) {
+        addFromStyle(style);
+    }
+    // Walk elements recursively, computing the RESOLVED style for each
+    // so that cross-source font combinations (e.g. fontFamily from override +
+    // fontWeight from named style) are properly collected.
+    function walkElement(element) {
+        // Resolved style captures the full merge of defaults + named + overrides
+        addFromStyle(resolveElementStyle(element, template.styles, template.defaultStyle));
+        // Conditional style variations
+        if (element.conditionalStyles) {
+            for (const cs of element.conditionalStyles) {
+                const effective = {
+                    ...element,
+                    style: cs.style ?? element.style,
+                    styleOverrides: { ...(element.styleOverrides ?? {}), ...(cs.styleOverrides ?? {}) },
+                };
+                addFromStyle(resolveElementStyle(effective, template.styles, template.defaultStyle));
+            }
+        }
+        // Rich text StyledRun variations
+        const content = element.properties.content;
+        if (Array.isArray(content)) {
+            for (const run of content) {
+                if (run.styleOverrides || run.style) {
+                    const effective = {
+                        ...element,
+                        style: run.style ?? element.style,
+                        styleOverrides: { ...(element.styleOverrides ?? {}), ...(run.styleOverrides ?? {}) },
+                    };
+                    addFromStyle(resolveElementStyle(effective, template.styles, template.defaultStyle));
+                }
+            }
+        }
+        // Recurse into nested elements (containers, frames)
+        if (element.elements) {
+            for (const child of element.elements) {
+                walkElement(child);
+            }
+        }
+    }
+    for (const section of template.sections) {
+        for (const band of section.bands) {
+            for (const element of band.elements) {
+                walkElement(element);
+            }
+        }
+    }
+    return [...specs.values()];
+}
+//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,MAAe;IACvC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC1C,OAAO,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CACtB,IAAc,EACd,YAA+B;IAE/B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,cAA2C,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,WAAW;YAAE,SAAS;QACrD,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC;QACxD,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC;QACxD,IAAI,WAAW,IAAI,UAAU;YAAE,OAAO,CAAC,CAAC;QACxC,cAAc,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAgB,EAChB,KAAiB,EACjB,gBAAmC;IAEnC,MAAM,KAAK,GAAY,IAAI,GAAG,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAE7B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAI5C,CAAC;QACF,MAAM,IAAI,GAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,kCAAkC,GAAG,wCAAwC,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,MAAM,aAAa,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC;IAEvD,SAAS,YAAY,CAAC,KAAqB;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,aAAa,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,QAAQ,CAAC;QAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,QAAQ,CAAC;QAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEpC,eAAe;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,0EAA0E;IAC1E,uDAAuD;IACvD,SAAS,WAAW,CAAC,OAAgB;QACnC,yEAAyE;QACzE,YAAY,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;QAEnF,+BAA+B;QAC/B,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBAC3C,MAAM,SAAS,GAAY;oBACzB,GAAG,OAAO;oBACV,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK;oBAChC,cAAc,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE;iBACpF,CAAC;gBACF,YAAY,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,OAAsB,EAAE,CAAC;gBACzC,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;oBACpC,MAAM,SAAS,GAAY;wBACzB,GAAG,OAAO;wBACV,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK;wBACjC,cAAc,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE;qBACrF,CAAC;oBACF,YAAY,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;gBACvF,CAAC;YACH,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrC,WAAW,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpC,WAAW,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/footnotes.d.ts

@@ -0,0 +1,34 @@
+import type { PDFPage } from 'pdf-lib';
+import type { RichContent, Style } from '@jsonpdf/core';
+import type { FontMap } from '@jsonpdf/plugins';
+/** A single footnote entry collected during rendering. */
+export interface FootnoteEntry {
+    /** 1-based footnote number. */
+    number: number;
+    /** The footnote content (string or StyledRun[]). */
+    content: RichContent;
+}
+/** Accumulated footnotes for a single page. */
+export interface PageFootnotes {
+    entries: FootnoteEntry[];
+    /** Total height consumed by footnotes + separator line. */
+    totalHeight: number;
+}
+/**
+ * Measure the total height of a set of footnotes.
+ * Includes separator line height + gap + content lines.
+ */
+export declare function measureFootnoteHeight(entries: FootnoteEntry[], baseStyle: Style, fonts: FontMap, width: number): number;
+/**
+ * Render footnotes at the bottom of a page.
+ *
+ * @param page - The pdf-lib page
+ * @param entries - Footnote entries to render
+ * @param x - Left edge of the footnote area (left margin)
+ * @param y - Top of the footnote area in pdf-lib coordinates
+ * @param width - Available width for footnotes
+ * @param baseStyle - Base style for footnote text
+ * @param fonts - Font map
+ */
+export declare function renderFootnotes(page: PDFPage, entries: FootnoteEntry[], x: number, y: number, width: number, baseStyle: Style, fonts: FontMap): void;
+//# sourceMappingURL=footnotes.d.ts.map

package/dist/footnotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footnotes.d.ts","sourceRoot":"","sources":["../src/footnotes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,EAAE,KAAK,EAChB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAsBR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,aAAa,EAAE,EACxB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,KAAK,EAChB,KAAK,EAAE,OAAO,GACb,IAAI,CA8DN"}

package/dist/footnotes.js

@@ -0,0 +1,103 @@
+import { rgb } from 'pdf-lib';
+import { parseColor } from '@jsonpdf/core';
+import { getFont, getLineHeight, wrapText } from '@jsonpdf/plugins';
+const SEPARATOR_WIDTH_FRACTION = 1 / 3;
+const SEPARATOR_THICKNESS = 0.5;
+const SEPARATOR_GAP = 4; // gap above and below separator
+const FOOTNOTE_FONT_SIZE_RATIO = 0.8; // footnote text is 80% of base font size
+/**
+ * Measure the total height of a set of footnotes.
+ * Includes separator line height + gap + content lines.
+ */
+export function measureFootnoteHeight(entries, baseStyle, fonts, width) {
+    if (entries.length === 0)
+        return 0;
+    const fontSize = (baseStyle.fontSize ?? 12) * FOOTNOTE_FONT_SIZE_RATIO;
+    const superFontSize = fontSize * 0.65;
+    const style = { ...baseStyle, fontSize };
+    const font = getFont(fonts, style);
+    const lh = getLineHeight(style);
+    // Separator line + gaps
+    let height = SEPARATOR_GAP + SEPARATOR_THICKNESS + SEPARATOR_GAP;
+    // Each footnote wrapped to available width
+    for (const entry of entries) {
+        const text = getFootnoteText(entry);
+        const numWidth = font.widthOfTextAtSize(String(entry.number), superFontSize);
+        const indent = numWidth + 3;
+        const wrapped = wrapText(text, font, fontSize, width - indent, lh);
+        height += wrapped.lines.length * lh;
+    }
+    return height;
+}
+/**
+ * Render footnotes at the bottom of a page.
+ *
+ * @param page - The pdf-lib page
+ * @param entries - Footnote entries to render
+ * @param x - Left edge of the footnote area (left margin)
+ * @param y - Top of the footnote area in pdf-lib coordinates
+ * @param width - Available width for footnotes
+ * @param baseStyle - Base style for footnote text
+ * @param fonts - Font map
+ */
+export function renderFootnotes(page, entries, x, y, width, baseStyle, fonts) {
+    if (entries.length === 0)
+        return;
+    const fontSize = (baseStyle.fontSize ?? 12) * FOOTNOTE_FONT_SIZE_RATIO;
+    const style = { ...baseStyle, fontSize };
+    const font = getFont(fonts, style);
+    const lh = getLineHeight(style);
+    const colorStr = style.color ?? '#000000';
+    const color = parseColor(colorStr);
+    const superFontSize = fontSize * 0.65;
+    let cursorY = y;
+    // Draw separator line (1/3 of page width)
+    cursorY -= SEPARATOR_GAP;
+    const lineWidth = width * SEPARATOR_WIDTH_FRACTION;
+    page.drawLine({
+        start: { x, y: cursorY },
+        end: { x: x + lineWidth, y: cursorY },
+        thickness: SEPARATOR_THICKNESS,
+        color: rgb(color.r, color.g, color.b),
+    });
+    cursorY -= SEPARATOR_THICKNESS + SEPARATOR_GAP;
+    // Render each footnote
+    for (const entry of entries) {
+        const text = getFootnoteText(entry);
+        const ascent = font.heightAtSize(fontSize, { descender: false });
+        // Draw superscript number
+        const superAscent = font.heightAtSize(superFontSize, { descender: false });
+        const superRaise = ascent * 0.35;
+        const numText = String(entry.number);
+        const numWidth = font.widthOfTextAtSize(numText, superFontSize);
+        const drawY = cursorY - ascent;
+        page.drawText(numText, {
+            x,
+            y: drawY + superRaise + (ascent - superAscent),
+            font,
+            size: superFontSize,
+            color: rgb(color.r, color.g, color.b),
+        });
+        // Draw footnote content text with wrapping
+        const indent = numWidth + 3;
+        const wrapped = wrapText(text, font, fontSize, width - indent, lh);
+        for (const line of wrapped.lines) {
+            const lineDrawY = cursorY - ascent;
+            page.drawText(line, {
+                x: x + indent,
+                y: lineDrawY,
+                font,
+                size: fontSize,
+                color: rgb(color.r, color.g, color.b),
+            });
+            cursorY -= lh;
+        }
+    }
+}
+/** Extract plain text from footnote content (string or StyledRun[]). */
+function getFootnoteText(entry) {
+    if (typeof entry.content === 'string')
+        return entry.content;
+    return entry.content.map((run) => run.text).join('');
+}
+//# sourceMappingURL=footnotes.js.map

package/dist/footnotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footnotes.js","sourceRoot":"","sources":["../src/footnotes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAiBpE,MAAM,wBAAwB,GAAG,CAAC,GAAG,CAAC,CAAC;AACvC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,gCAAgC;AACzD,MAAM,wBAAwB,GAAG,GAAG,CAAC,CAAC,yCAAyC;AAE/E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAwB,EACxB,SAAgB,EAChB,KAAc,EACd,KAAa;IAEb,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEnC,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,wBAAwB,CAAC;IACvE,MAAM,aAAa,GAAG,QAAQ,GAAG,IAAI,CAAC;IACtC,MAAM,KAAK,GAAU,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEhC,wBAAwB;IACxB,IAAI,MAAM,GAAG,aAAa,GAAG,mBAAmB,GAAG,aAAa,CAAC;IAEjE,2CAA2C;IAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC;IACtC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAa,EACb,OAAwB,EACxB,CAAS,EACT,CAAS,EACT,KAAa,EACb,SAAgB,EAChB,KAAc;IAEd,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,wBAAwB,CAAC;IACvE,MAAM,KAAK,GAAU,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEnC,MAAM,aAAa,GAAG,QAAQ,GAAG,IAAI,CAAC;IAEtC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,0CAA0C;IAC1C,OAAO,IAAI,aAAa,CAAC;IACzB,MAAM,SAAS,GAAG,KAAK,GAAG,wBAAwB,CAAC;IACnD,IAAI,CAAC,QAAQ,CAAC;QACZ,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE;QACxB,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE;QACrC,SAAS,EAAE,mBAAmB;QAC9B,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;KACtC,CAAC,CAAC;IACH,OAAO,IAAI,mBAAmB,GAAG,aAAa,CAAC;IAE/C,uBAAuB;IACvB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjE,0BAA0B;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAEhE,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;QAE/B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;YACrB,CAAC;YACD,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;YAC9C,IAAI;YACJ,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;SACtC,CAAC,CAAC;QAEH,2CAA2C;QAC3C,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QAEnE,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;gBAClB,CAAC,EAAE,CAAC,GAAG,MAAM;gBACb,CAAC,EAAE,SAAS;gBACZ,IAAI;gBACJ,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;aACtC,CAAC,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,SAAS,eAAe,CAAC,KAAoB;IAC3C,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/gradient.d.ts

@@ -0,0 +1,19 @@
+import type { PDFPage, PDFDocument } from 'pdf-lib';
+import type { Gradient } 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 declare function drawGradientRect(page: PDFPage, doc: PDFDocument, x: number, y: number, width: number, height: number, gradient: Gradient, opacity?: number): void;
+//# sourceMappingURL=gradient.d.ts.map

package/dist/gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.d.ts","sourceRoot":"","sources":["../src/gradient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,KAAK,EAAE,QAAQ,EAAkC,MAAM,eAAe,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAiFN"}