@arslankhan/doc-forge 0.0.0-stage → 0.1.1

package/dist/pdf/options.js

@@ -0,0 +1,322 @@
+import { createTemplate } from "../serialize.js";
+import { standardPageDimensions } from "../types.js";
+import { PdfRenderError } from "./errors.js";
+export const PDF_PAPER_SIZES = ["A4", "A3", "Letter", "Legal", "custom"];
+const A3_MM = { width: 297, height: 420 };
+/** Validates PDF options and merges them onto a detached template copy. */
+export function resolvePdfSettings(template, options) {
+    const validated = createTemplate(template);
+    const next = applyPageOverride(validated, options.page);
+    const box = pageBox(next);
+    const timeout = readTimeout(options.timeout);
+    const scale = readScale(options.scale);
+    const preferCssPageSize = readBoolean(options.preferCssPageSize, "preferCssPageSize");
+    if (options.printBackground !== undefined && typeof options.printBackground !== "boolean") {
+        throw new PdfRenderError("invalid_option", "printBackground must be a boolean.");
+    }
+    const printBackground = options.printBackground ?? true;
+    const imageNetwork = readBoolean(options.imageNetwork, "imageNetwork") === true;
+    const metadata = readMetadata(options.metadata);
+    readLaunch(options.launch);
+    readTemplateHtml(options.headerTemplate, "headerTemplate");
+    readTemplateHtml(options.footerTemplate, "footerTemplate");
+    if (options.beforePdf !== undefined && typeof options.beforePdf !== "function") {
+        throw new PdfRenderError("invalid_option", "beforePdf must be a function.");
+    }
+    if (options.browser !== undefined && typeof options.browser.newContext !== "function") {
+        throw new PdfRenderError("invalid_option", "browser must be a Playwright browser.");
+    }
+    if (options.title !== undefined && typeof options.title !== "string") {
+        throw new PdfRenderError("invalid_option", "title must be a string.");
+    }
+    const wantsNumbers = next.documentType === "report" && next.report?.showPageNumber === true;
+    const displayHeaderFooter = options.displayHeaderFooter ??
+        (wantsNumbers || options.headerTemplate !== undefined || options.footerTemplate !== undefined);
+    if (typeof displayHeaderFooter !== "boolean") {
+        throw new PdfRenderError("invalid_option", "displayHeaderFooter must be a boolean.");
+    }
+    const marginsWereSet = options.page?.margins !== undefined;
+    const margin = pdfMargin(next, box, marginsWereSet, displayHeaderFooter);
+    const fitted = insetFixedPage(next, box, marginsWereSet);
+    return {
+        template: fitted,
+        timeout,
+        scale,
+        printBackground,
+        preferCssPageSize: preferCssPageSize === true,
+        width: cssLength(box.width, box.unit),
+        height: cssLength(box.height, box.unit),
+        margin,
+        displayHeaderFooter,
+        headerTemplate: options.headerTemplate,
+        footerTemplate: options.footerTemplate,
+        metadata,
+        imageSources: options.imageSources ?? {},
+        imageNetwork,
+        title: options.title,
+        additionalCss: options.additionalCss,
+        invoice: options.invoice,
+    };
+}
+function applyPageOverride(template, override) {
+    if (override === undefined) {
+        return template;
+    }
+    if (typeof override !== "object" || override === null) {
+        throw new PdfRenderError("invalid_option", "page must be an object.");
+    }
+    const page = {
+        ...template.page,
+        margins: { ...template.page.margins },
+        dimensions: template.page.dimensions ? { ...template.page.dimensions } : undefined,
+    };
+    const orientation = override.orientation ?? page.orientation;
+    if (override.orientation !== undefined && override.orientation !== "portrait" && override.orientation !== "landscape") {
+        throw new PdfRenderError("invalid_option", 'orientation must be "portrait" or "landscape".');
+    }
+    if (override.paperSize !== undefined && !PDF_PAPER_SIZES.includes(override.paperSize)) {
+        throw new PdfRenderError("invalid_option", 'paperSize must be "A4", "A3", "Letter", "Legal", or "custom".');
+    }
+    if (override.dimensions !== undefined && override.paperSize !== undefined && override.paperSize !== "custom") {
+        throw new PdfRenderError("invalid_option", "Set dimensions only when paperSize is custom.");
+    }
+    if (override.dimensions !== undefined) {
+        page.paperSize = "custom";
+        page.orientation = orientation;
+        page.dimensions = readDimensions(override.dimensions);
+    }
+    else if (override.paperSize === "custom") {
+        throw new PdfRenderError("invalid_option", "A custom PDF page requires dimensions.");
+    }
+    else if (override.paperSize === "A3") {
+        page.paperSize = "custom";
+        page.orientation = orientation;
+        page.dimensions = oriented(A3_MM.width, A3_MM.height, orientation);
+    }
+    else if (override.paperSize !== undefined) {
+        page.paperSize = override.paperSize;
+        page.orientation = orientation;
+        page.dimensions = standardPageDimensions(override.paperSize, orientation);
+    }
+    else if (override.orientation !== undefined && override.orientation !== template.page.orientation) {
+        page.orientation = orientation;
+        if (page.paperSize === "custom") {
+            if (!page.dimensions) {
+                throw new PdfRenderError("invalid_option", "A custom page needs dimensions before its orientation can change.");
+            }
+            page.dimensions = {
+                width: page.dimensions.height,
+                height: page.dimensions.width,
+                unit: page.dimensions.unit,
+            };
+        }
+        else {
+            page.dimensions = standardPageDimensions(page.paperSize, orientation);
+        }
+    }
+    if (override.margins !== undefined) {
+        page.margins = mergeMargins(page.margins, override.margins);
+    }
+    return { ...template, page };
+}
+function pageBox(template) {
+    const page = template.page;
+    if (page.dimensions) {
+        return {
+            width: page.dimensions.width,
+            height: page.dimensions.height,
+            unit: page.dimensions.unit,
+            margins: page.margins,
+        };
+    }
+    if (page.paperSize === "custom") {
+        throw new PdfRenderError("invalid_option", "Custom paper sizes require dimensions.");
+    }
+    const dimensions = standardPageDimensions(page.paperSize, page.orientation);
+    return { width: dimensions.width, height: dimensions.height, unit: dimensions.unit, margins: page.margins };
+}
+function insetFixedPage(template, box, marginsWereSet) {
+    if (template.documentType === "report" || !marginsWereSet) {
+        return template;
+    }
+    const width = box.width - box.margins.left - box.margins.right;
+    const height = box.height - box.margins.top - box.margins.bottom;
+    if (width <= 0 || height <= 0) {
+        throw new PdfRenderError("invalid_option", "PDF margins leave no room for the page.");
+    }
+    return {
+        ...template,
+        page: {
+            ...template.page,
+            paperSize: "custom",
+            dimensions: { width, height, unit: box.unit },
+        },
+    };
+}
+function pdfMargin(template, box, marginsWereSet, displayHeaderFooter) {
+    const useTemplate = template.documentType === "report" || marginsWereSet;
+    const margins = useTemplate ? box.margins : { top: 0, right: 0, bottom: 0, left: 0 };
+    if (displayHeaderFooter) {
+        for (const edge of ["top", "right", "bottom", "left"]) {
+            if (toMm(margins[edge], useTemplate ? box.unit : "mm") < 10) {
+                throw new PdfRenderError("invalid_option", "PDF headers and footers need at least 10mm on every margin. Set page.margins before printing page numbers.");
+            }
+        }
+    }
+    const unit = useTemplate ? box.unit : "mm";
+    return {
+        top: cssLength(margins.top, unit),
+        right: cssLength(margins.right, unit),
+        bottom: cssLength(margins.bottom, unit),
+        left: cssLength(margins.left, unit),
+    };
+}
+function mergeMargins(base, override) {
+    if (typeof override !== "object" || override === null) {
+        throw new PdfRenderError("invalid_option", "margins must be an object.");
+    }
+    const next = { ...base };
+    for (const edge of ["top", "right", "bottom", "left"]) {
+        if (override[edge] !== undefined) {
+            next[edge] = readMargin(override[edge], edge);
+        }
+    }
+    return next;
+}
+function readMargin(value, edge) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new PdfRenderError("invalid_option", `Margin ${edge} must be a finite number greater than or equal to 0.`);
+    }
+    return value;
+}
+function readDimensions(value) {
+    if (typeof value !== "object" || value === null) {
+        throw new PdfRenderError("invalid_option", "dimensions must be an object.");
+    }
+    const unit = value.unit;
+    if (unit !== "mm" && unit !== "pt" && unit !== "in" && unit !== "px") {
+        throw new PdfRenderError("invalid_option", 'dimensions.unit must be "mm", "pt", "in", or "px".');
+    }
+    for (const side of ["width", "height"]) {
+        const length = value[side];
+        if (typeof length !== "number" || !Number.isFinite(length) || length <= 0 || toMm(length, unit) > 2000) {
+            throw new PdfRenderError("invalid_option", `dimensions.${side} must be a finite length greater than 0 and at most 2000mm.`);
+        }
+    }
+    return { width: value.width, height: value.height, unit };
+}
+function oriented(width, height, orientation) {
+    if (orientation === "landscape") {
+        return { width: height, height: width, unit: "mm" };
+    }
+    return { width, height, unit: "mm" };
+}
+function readTimeout(value) {
+    if (value === undefined) {
+        return 30_000;
+    }
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 1 || value > 120_000) {
+        throw new PdfRenderError("invalid_option", "timeout must be a finite number of milliseconds from 1 through 120000.");
+    }
+    return value;
+}
+function readScale(value) {
+    if (value === undefined) {
+        return 1;
+    }
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0.1 || value > 2) {
+        throw new PdfRenderError("invalid_option", "scale must be a finite number from 0.1 through 2.");
+    }
+    return value;
+}
+function readBoolean(value, label) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "boolean") {
+        throw new PdfRenderError("invalid_option", `${label} must be a boolean.`);
+    }
+    return value;
+}
+function readMetadata(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "object" || value === null) {
+        throw new PdfRenderError("invalid_option", "metadata must be an object.");
+    }
+    for (const key of ["title", "author", "subject"]) {
+        if (value[key] !== undefined) {
+            readMetadataString(value[key], key);
+        }
+    }
+    if (value.keywords !== undefined && typeof value.keywords !== "string" && !Array.isArray(value.keywords)) {
+        throw new PdfRenderError("invalid_option", "metadata.keywords must be a string or an array of strings.");
+    }
+    if (Array.isArray(value.keywords)) {
+        for (const keyword of value.keywords) {
+            readMetadataString(keyword, "keywords");
+        }
+    }
+    else if (typeof value.keywords === "string") {
+        readMetadataString(value.keywords, "keywords");
+    }
+    return value;
+}
+function readMetadataString(value, label) {
+    if (typeof value !== "string" || value.length > 200 || /[\u0000-\u001F\u007F]/.test(value)) {
+        throw new PdfRenderError("invalid_option", `metadata.${label} must be text of at most 200 characters.`);
+    }
+}
+function readLaunch(value) {
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "object" || value === null) {
+        throw new PdfRenderError("invalid_option", "launch must be an object.");
+    }
+    if (value.headless !== undefined && typeof value.headless !== "boolean") {
+        throw new PdfRenderError("invalid_option", "launch.headless must be a boolean.");
+    }
+    if (value.executablePath !== undefined && (typeof value.executablePath !== "string" || value.executablePath.trim().length === 0 || value.executablePath.includes("\0"))) {
+        throw new PdfRenderError("invalid_option", "launch.executablePath must be a non-empty path.");
+    }
+    if (value.args !== undefined) {
+        if (!Array.isArray(value.args) || value.args.length > 40) {
+            throw new PdfRenderError("invalid_option", "launch.args must be an array of at most 40 strings.");
+        }
+        for (const arg of value.args) {
+            if (typeof arg !== "string" || arg.length > 200 || /[\u0000-\u001F\u007F]/.test(arg)) {
+                throw new PdfRenderError("invalid_option", "Each launch arg must be a single line of at most 200 characters.");
+            }
+        }
+    }
+}
+export function readTemplateHtml(value, label) {
+    if (value === undefined) {
+        return;
+    }
+    if (typeof value !== "string" || value.length > 4000) {
+        throw new PdfRenderError("invalid_option", `${label} must be HTML of at most 4000 characters.`);
+    }
+    if (/<script|javascript:|on[a-z]+\s*=/i.test(value)) {
+        throw new PdfRenderError("invalid_option", `${label} cannot contain script or event-handler markup.`);
+    }
+}
+function cssLength(value, unit) {
+    const rounded = Math.round(value * 1000) / 1000;
+    return `${rounded}${unit}`;
+}
+function toMm(value, unit) {
+    if (unit === "mm") {
+        return value;
+    }
+    if (unit === "in") {
+        return value * 25.4;
+    }
+    if (unit === "pt") {
+        return (value * 25.4) / 72;
+    }
+    return (value * 25.4) / 96;
+}
+//# sourceMappingURL=options.js.map

package/dist/pdf/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/pdf/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAsIlF,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,QAA0B,EAAE,OAAyB;IACtF,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;IACtF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC1F,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,oCAAoC,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACxD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,IAAI,CAAC;IAChF,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,gBAAgB,CAAC,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC3D,gBAAgB,CAAC,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC/E,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACtF,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,uCAAuC,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrE,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5F,MAAM,mBAAmB,GACvB,OAAO,CAAC,mBAAmB;QAC3B,CAAC,YAAY,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC;IACjG,IAAI,OAAO,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC7C,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,wCAAwC,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC;IAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,mBAAmB,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;IACzD,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,OAAO;QACP,KAAK;QACL,eAAe;QACf,iBAAiB,EAAE,iBAAiB,KAAK,IAAI;QAC7C,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC;QACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;QACvC,MAAM;QACN,mBAAmB;QACnB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,QAAQ;QACR,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,YAAY;QACZ,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,QAA0B,EAAE,QAAqC;IAC1F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAG;QACX,GAAG,QAAQ,CAAC,IAAI;QAChB,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE;QACrC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS;KACnF,CAAC;IACF,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC;IAC7D,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,IAAI,QAAQ,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACtH,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,gDAAgD,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,+DAA+D,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC7G,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,+CAA+C,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,wCAAwC,CAAC,CAAC;IACvF,CAAC;SAAM,IAAI,QAAQ,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrE,CAAC;SAAM,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC;SAAM,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACpG,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,mEAAmE,CAAC,CAAC;YAClH,CAAC;YACD,IAAI,CAAC,UAAU,GAAG;gBAChB,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;gBAC7B,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;gBAC7B,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;aAC3B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,OAAO,CAAC,QAA0B;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;YAC9B,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,wCAAwC,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5E,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;AAC9G,CAAC;AAED,SAAS,cAAc,CACrB,QAA0B,EAC1B,GAA8E,EAC9E,cAAuB;IAEvB,IAAI,QAAQ,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;IACjE,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,yCAAyC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE;YACJ,GAAG,QAAQ,CAAC,IAAI;YAChB,SAAS,EAAE,QAAQ;YACnB,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;SAC9C;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,QAA0B,EAC1B,GAA+C,EAC/C,cAAuB,EACvB,mBAA4B;IAE5B,MAAM,WAAW,GAAG,QAAQ,CAAC,YAAY,KAAK,QAAQ,IAAI,cAAc,CAAC;IACzE,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrF,IAAI,mBAAmB,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAU,EAAE,CAAC;YAC/D,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC5D,MAAM,IAAI,cAAc,CACtB,gBAAgB,EAChB,4GAA4G,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,OAAO;QACL,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;QACjC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QACrC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;QACvC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAiB,EAAE,QAA8B;IACrE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAU,EAAE,CAAC;QAC/D,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,IAAY;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,UAAU,IAAI,sDAAsD,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAAqB;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACrE,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,oDAAoD,CAAC,CAAC;IACnG,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAU,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;YACvG,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,cAAc,IAAI,6DAA6D,CAAC,CAAC;QAC9H,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,MAAc,EAAE,WAA4B;IAC3E,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB;IAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACzF,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,wEAAwE,CAAC,CAAC;IACvH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB;IAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,mDAAmD,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAA0B,EAAE,KAAa;IAC5D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,GAAG,KAAK,qBAAqB,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAA8B;IAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,6BAA6B,CAAC,CAAC;IAC5E,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7B,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzG,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,4DAA4D,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc,EAAE,KAAa;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,YAAY,KAAK,0CAA0C,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAmC;IACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACxE,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,oCAAoC,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACxK,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,iDAAiD,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACzD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,qDAAqD,CAAC,CAAC;QACpG,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrF,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,kEAAkE,CAAC,CAAC;YACjH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAyB,EAAE,KAAa;IACvE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACrD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,GAAG,KAAK,2CAA2C,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,GAAG,KAAK,iDAAiD,CAAC,CAAC;IACxG,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,IAAgB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,OAAO,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,IAAI,CAAC,KAAa,EAAE,IAAgB;IAC3C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC7B,CAAC"}

package/dist/pdf/render-pdf.d.ts

@@ -0,0 +1,13 @@
+import type { DocumentTemplate } from "../schema.js";
+import { closePdfBrowser, openPdfBrowser } from "./browser.js";
+import { type PdfRenderOptions } from "./options.js";
+/**
+ * Renders a template and JSON data to a PDF buffer.
+ * Invoice totals and report rows are produced by the existing modules through `renderToHTML`.
+ * The template and the data object are not modified.
+ */
+export declare function renderToPDF(template: DocumentTemplate, data: unknown, options?: PdfRenderOptions): Promise<Buffer>;
+/** Writes a PDF to `filePath`. The path is used only because the caller supplied it. */
+export declare function renderToPdfFile(template: DocumentTemplate, data: unknown, filePath: string, options?: PdfRenderOptions): Promise<void>;
+export { closePdfBrowser, openPdfBrowser };
+//# sourceMappingURL=render-pdf.d.ts.map

package/dist/pdf/render-pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-pdf.d.ts","sourceRoot":"","sources":["../../src/pdf/render-pdf.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,eAAe,EAAoB,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUzE;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4E5H;AAED,wFAAwF;AACxF,wBAAsB,eAAe,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}

package/dist/pdf/render-pdf.js

@@ -0,0 +1,195 @@
+import { writeFile } from "node:fs/promises";
+import { resolveBinding } from "../binding.js";
+import { prepareInvoiceContext } from "../invoice/context.js";
+import { formatScalar } from "../invoice/format.js";
+import { imageSourceDecision } from "../render/image-policy.js";
+import { renderToHTML } from "../render/render-html.js";
+import { escapeHtml } from "../render/escape.js";
+import { closePdfBrowser, launchPdfBrowser, openPdfBrowser } from "./browser.js";
+import { PdfRenderError } from "./errors.js";
+import { resolvePdfSettings } from "./options.js";
+const PDF_CSS = `
+html, body { margin: 0 !important; background: #ffffff !important; }
+.dfr-page { margin: 0 !important; box-shadow: none !important; }
+.dfr-page:not(.dfr-report) { overflow: hidden !important; }
+.dfr-margins { display: none !important; }
+@page { margin: 0 !important; }
+`.trim();
+/**
+ * Renders a template and JSON data to a PDF buffer.
+ * Invoice totals and report rows are produced by the existing modules through `renderToHTML`.
+ * The template and the data object are not modified.
+ */
+export async function renderToPDF(template, data, options = {}) {
+    const settings = resolvePdfSettings(template, options);
+    const headerFooter = headerFooterTemplates(settings.template, data, settings.displayHeaderFooter, options);
+    const css = [PDF_CSS, headerFooter.hideDocumentFooter ? "@media print { .dfr-page-footer { display: none !important; } }" : "", settings.additionalCss]
+        .filter((part) => part !== undefined && part.length > 0)
+        .join("\n");
+    const html = renderToHTML(settings.template, data, {
+        title: settings.title,
+        imageSources: settings.imageSources,
+        invoice: settings.invoice,
+        additionalCss: css,
+    });
+    const owned = options.browser === undefined && options.launch !== undefined;
+    const browser = options.browser ?? (owned ? await launchPdfBrowser(options.launch) : await openPdfBrowser());
+    const context = await browser.newContext({ javaScriptEnabled: false });
+    let page;
+    try {
+        page = await context.newPage();
+        await page.route("**/*", async (route) => {
+            const url = route.request().url();
+            if (url.startsWith("data:") || url.startsWith("about:")) {
+                await route.continue();
+                return;
+            }
+            if (settings.imageNetwork && imageSourceDecision(url, settings.imageSources) === "allow" && /^https:\/\//i.test(url)) {
+                await route.continue();
+                return;
+            }
+            await route.abort();
+        });
+        await runStep(page.setContent(html, { waitUntil: "load", timeout: settings.timeout }), settings.timeout, "The document did not finish loading before the timeout.");
+        if (options.beforePdf) {
+            await runStep(Promise.resolve(options.beforePdf(page)), settings.timeout, "The document was not ready before the timeout.");
+        }
+        const printed = await runStep(page.pdf({
+            width: settings.width,
+            height: settings.height,
+            margin: settings.margin,
+            printBackground: settings.printBackground,
+            preferCSSPageSize: settings.preferCssPageSize,
+            scale: settings.scale,
+            displayHeaderFooter: settings.displayHeaderFooter,
+            headerTemplate: headerFooter.header,
+            footerTemplate: headerFooter.footer,
+            timeout: settings.timeout,
+        }), settings.timeout, "The PDF was not produced before the timeout.");
+        return Buffer.from(await applyMetadata(printed, settings.metadata, settings.title ?? settings.template.name));
+    }
+    catch (error) {
+        if (error instanceof PdfRenderError) {
+            throw error;
+        }
+        if (isTimeout(error)) {
+            throw new PdfRenderError("timeout", "The document did not finish loading before the timeout.");
+        }
+        const message = error instanceof Error ? error.message.split("\n")[0] : "The PDF could not be rendered.";
+        throw new PdfRenderError("render_failed", message);
+    }
+    finally {
+        await page?.close().catch(() => undefined);
+        await context.close().catch(() => undefined);
+        if (owned) {
+            await browser.close().catch(() => undefined);
+        }
+    }
+}
+/** Writes a PDF to `filePath`. The path is used only because the caller supplied it. */
+export async function renderToPdfFile(template, data, filePath, options = {}) {
+    if (typeof filePath !== "string" || filePath.trim().length === 0 || filePath.includes("\0")) {
+        throw new PdfRenderError("invalid_option", "filePath must be a non-empty path.");
+    }
+    const pdf = await renderToPDF(template, data, options);
+    await writeFile(filePath, pdf);
+}
+export { closePdfBrowser, openPdfBrowser };
+function headerFooterTemplates(template, data, displayHeaderFooter, options) {
+    if (!displayHeaderFooter) {
+        return { hideDocumentFooter: false };
+    }
+    const view = template.documentType === "invoice"
+        ? prepareInvoiceContext(data, options.invoice ?? { fractionDigits: template.invoice?.fractionDigits })
+        : data;
+    const header = options.headerTemplate ?? marginBox(bandLine(template.report?.pageHeader, view));
+    const pageNumber = template.documentType === "report" && template.report?.showPageNumber
+        ? "Page <span class=\"pageNumber\"></span> of <span class=\"totalPages\"></span>"
+        : "";
+    const footerText = bandLine(template.report?.pageFooter, view);
+    const footer = options.footerTemplate ?? marginBox([footerText, pageNumber].filter((part) => part.length > 0).join(" "));
+    return { header, footer, hideDocumentFooter: true };
+}
+function marginBox(content) {
+    return `<div style="font-family: Helvetica, Arial, sans-serif; font-size: 9px; width: 100%; padding: 0 8mm; color: #1c2430;">${content}</div>`;
+}
+function bandLine(entries, data) {
+    if (!entries) {
+        return "";
+    }
+    return entries
+        .filter((entry) => entry.type === "text")
+        .map((entry) => escapeHtml(entry.binding ? boundText(entry.binding, data) : entry.text ?? ""))
+        .filter((text) => text.length > 0)
+        .join(" ");
+}
+function boundText(binding, data) {
+    const lookup = resolveBinding(data, binding.path);
+    if (lookup.status === "found") {
+        const formatted = formatScalar(lookup.value, binding.format, currencyFrom(binding, data));
+        if (formatted !== null) {
+            return `${binding.prefix ?? ""}${formatted}${binding.suffix ?? ""}`;
+        }
+    }
+    if (binding.fallback !== undefined) {
+        return `${binding.prefix ?? ""}${binding.fallback}${binding.suffix ?? ""}`;
+    }
+    return "";
+}
+function currencyFrom(binding, data) {
+    if (binding.format?.style !== "currency") {
+        return undefined;
+    }
+    if (binding.format.currency) {
+        return binding.format.currency;
+    }
+    for (const path of ["invoice.currency", "report.currency"]) {
+        const lookup = resolveBinding(data, path);
+        if (lookup.status === "found" && typeof lookup.value === "string") {
+            return lookup.value;
+        }
+    }
+    return undefined;
+}
+async function applyMetadata(pdf, metadata, fallbackTitle) {
+    if (metadata === undefined) {
+        return pdf;
+    }
+    const { PDFDocument } = await import("pdf-lib");
+    const document = await PDFDocument.load(pdf);
+    document.setTitle(metadata.title ?? fallbackTitle);
+    if (metadata.author !== undefined) {
+        document.setAuthor(metadata.author);
+    }
+    if (metadata.subject !== undefined) {
+        document.setSubject(metadata.subject);
+    }
+    if (metadata.keywords !== undefined) {
+        document.setKeywords(Array.isArray(metadata.keywords) ? [...metadata.keywords] : [metadata.keywords]);
+    }
+    return document.save();
+}
+async function runStep(promise, timeout, message) {
+    let timer;
+    const guarded = promise.then((value) => value, (error) => {
+        throw error;
+    });
+    guarded.catch(() => undefined);
+    try {
+        return await Promise.race([
+            guarded,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new PdfRenderError("timeout", message)), timeout);
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+    }
+}
+function isTimeout(error) {
+    return error instanceof Error && (error.name === "TimeoutError" || /Timeout/i.test(error.message));
+}
+//# sourceMappingURL=render-pdf.js.map

package/dist/pdf/render-pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-pdf.js","sourceRoot":"","sources":["../../src/pdf/render-pdf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAyB,MAAM,cAAc,CAAC;AAEzE,MAAM,OAAO,GAAG;;;;;;CAMf,CAAC,IAAI,EAAE,CAAC;AAET;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAA0B,EAAE,IAAa,EAAE,UAA4B,EAAE;IACzG,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC3G,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,iEAAiE,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,aAAa,CAAC;SACpJ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACvD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE;QACjD,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,aAAa,EAAE,GAAG;KACnB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;IAC7G,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,IAAI,IAA6D,CAAC;IAClE,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC;YAClC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxD,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,CAAC,YAAY,IAAI,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrH,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,CACX,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,EACvE,QAAQ,CAAC,OAAO,EAChB,yDAAyD,CAC1D,CAAC;QACF,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,OAAO,CACX,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EACxC,QAAQ,CAAC,OAAO,EAChB,gDAAgD,CACjD,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,IAAI,CAAC,GAAG,CAAC;YACP,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;YAC7C,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;YACjD,cAAc,EAAE,YAAY,CAAC,MAAM;YACnC,cAAc,EAAE,YAAY,CAAC,MAAM;YACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC,EACF,QAAQ,CAAC,OAAO,EAChB,8CAA8C,CAC/C,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAChH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,yDAAyD,CAAC,CAAC;QACjG,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC;QACzG,MAAM,IAAI,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAA0B,EAC1B,IAAa,EACb,QAAgB,EAChB,UAA4B,EAAE;IAE9B,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,oCAAoC,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AAE3C,SAAS,qBAAqB,CAC5B,QAA0B,EAC1B,IAAa,EACb,mBAA4B,EAC5B,OAAyB;IAEzB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,KAAK,SAAS;QAC9C,CAAC,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;QACtG,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAChG,MAAM,UAAU,GAAG,QAAQ,CAAC,YAAY,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,EAAE,cAAc;QACtF,CAAC,CAAC,+EAA+E;QACjF,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,wHAAwH,OAAO,QAAQ,CAAC;AACjJ,CAAC;AAED,SAAS,QAAQ,CAAC,OAA+C,EAAE,IAAa;IAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAuD,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SAC7F,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;SAC7F,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,OAAoB,EAAE,IAAa;IACpD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1F,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACtE,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,OAAoB,EAAE,IAAa;IACvD,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK,KAAK,UAAU,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IACjC,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,QAAsC,EAAE,aAAqB;IACrG,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;IACnD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,OAAO,CAAI,OAAmB,EAAE,OAAe,EAAE,OAAe;IAC7E,IAAI,KAAgD,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAChB,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO;YACP,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACpF,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACrG,CAAC"}

package/dist/render/appearance.d.ts

@@ -0,0 +1,25 @@
+import { type JsonValue } from "../binding.js";
+import type { ElementStyle, ReportColumn, ReportTableElement } from "../types.js";
+/**
+ * Style precedence for one report cell, from lowest to highest:
+ * 1. Table text defaults from `element.style` (color, font, vertical alignment).
+ * 2. Role defaults: header, group, subtotal, and grand total.
+ * 3. Role style: `headerStyle`, `bodyStyle`, `groupStyle`, `subtotalStyle`, or `grandTotalStyle`.
+ * 4. Zebra background for record rows that do not already set a background.
+ * 5. The first matching `rowRules` entry, for record rows only.
+ * 6. Column `headerStyle` or `style`, then the column's `align` when text alignment is still unset.
+ *
+ * A later layer replaces only the properties it sets. Padding edges and border sides merge per edge.
+ */
+export declare function reportCellStyle(element: ReportTableElement, column: ReportColumn | undefined, kind: "header" | "record" | "group" | "subtotal" | "grand" | "empty", record: {
+    [key: string]: JsonValue;
+} | undefined, stripe: string | undefined): ElementStyle;
+export declare function stripeColor(element: ReportTableElement, recordIndex: number): string | undefined;
+/** Later layers replace earlier ones. Nested padding and border edges merge. */
+export declare function mergeStyles(...layers: Array<ElementStyle | undefined>): ElementStyle;
+/**
+ * Border fields for a table cell.
+ * An overlay such as a header style replaces only the border fields it sets.
+ */
+export declare function cellBorderStyle(base: ElementStyle | undefined, overlay: ElementStyle | undefined): ElementStyle;
+//# sourceMappingURL=appearance.d.ts.map

package/dist/render/appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../src/render/appearance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAGV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,EACpE,MAAM,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,YAAY,CA8Bd;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQhG;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,YAAY,CAqBpF;AASD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAE/G"}