@arslankhan/doc-forge 0.0.0-stage → 0.1.1

package/dist/render/appearance.js

@@ -0,0 +1,149 @@
+import { resolveBinding } from "../binding.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 function reportCellStyle(element, column, kind, record, stripe) {
+    const tableText = {
+        color: element.style?.color,
+        fontFamily: element.style?.fontFamily,
+        fontSize: element.style?.fontSize,
+        fontStyle: element.style?.fontStyle,
+        fontWeight: element.style?.fontWeight,
+        verticalAlign: element.style?.verticalAlign,
+        textDecoration: element.style?.textDecoration,
+    };
+    const tableBorder = borderSlice(element.style);
+    if (kind === "header") {
+        return withAlign(mergeStyles(tableText, tableBorder, { fontWeight: "bold", backgroundColor: "#f4f6f8" }, element.headerStyle, column?.headerStyle), column?.headerStyle?.textAlign ?? column?.align);
+    }
+    if (kind === "group") {
+        return mergeStyles(tableText, { fontWeight: "bold", backgroundColor: "#eef3f8" }, element.groupStyle);
+    }
+    if (kind === "subtotal") {
+        return withAlign(mergeStyles(tableText, tableBorder, { fontWeight: "bold" }, element.subtotalStyle), column?.align);
+    }
+    if (kind === "grand") {
+        return withAlign(mergeStyles(tableText, tableBorder, { fontWeight: "bold" }, element.grandTotalStyle), column?.align);
+    }
+    const row = mergeStyles(tableText, tableBorder, element.bodyStyle);
+    const striped = stripe && row.backgroundColor === undefined ? mergeStyles(row, { backgroundColor: stripe }) : row;
+    const ruled = mergeStyles(striped, matchingRuleStyle(element.rowRules, record));
+    return withAlign(mergeStyles(ruled, column?.style), column?.style?.textAlign ?? column?.align);
+}
+export function stripeColor(element, recordIndex) {
+    if (element.stripeRows === false) {
+        return undefined;
+    }
+    if (recordIndex % 2 === 0) {
+        return element.evenRowColor ?? element.alternateRowColor;
+    }
+    return element.oddRowColor;
+}
+/** Later layers replace earlier ones. Nested padding and border edges merge. */
+export function mergeStyles(...layers) {
+    const result = {};
+    for (const layer of layers) {
+        if (!layer) {
+            continue;
+        }
+        for (const key of Object.keys(layer)) {
+            const value = layer[key];
+            if (value === undefined) {
+                continue;
+            }
+            if (key === "padding") {
+                result.padding = { ...result.padding, ...value };
+            }
+            else if (key === "borderTop" || key === "borderRight" || key === "borderBottom" || key === "borderLeft") {
+                result[key] = { ...result[key], ...value };
+            }
+            else {
+                Object.assign(result, { [key]: value });
+            }
+        }
+    }
+    return result;
+}
+function withAlign(style, align) {
+    if (style.textAlign !== undefined || align === undefined) {
+        return style;
+    }
+    return { ...style, textAlign: align };
+}
+/**
+ * Border fields for a table cell.
+ * An overlay such as a header style replaces only the border fields it sets.
+ */
+export function cellBorderStyle(base, overlay) {
+    return mergeStyles(borderSlice(base), borderSlice(overlay));
+}
+function borderSlice(style) {
+    if (!style) {
+        return {};
+    }
+    return {
+        borderColor: style.borderColor,
+        borderWidth: style.borderWidth,
+        borderStyle: style.borderStyle,
+        borderTop: style.borderTop,
+        borderRight: style.borderRight,
+        borderBottom: style.borderBottom,
+        borderLeft: style.borderLeft,
+    };
+}
+function matchingRuleStyle(rules, record) {
+    if (!rules || !record) {
+        return undefined;
+    }
+    for (const rule of rules) {
+        if (ruleMatches(rule, record)) {
+            return rule.style;
+        }
+    }
+    return undefined;
+}
+function ruleMatches(rule, record) {
+    const lookup = resolveBinding(record, rule.path);
+    const missing = lookup.status === "missing";
+    const value = lookup.status === "found" ? lookup.value : undefined;
+    if (rule.operator === "blank") {
+        return missing || value === null || value === "";
+    }
+    if (missing || value === undefined || value === null) {
+        return false;
+    }
+    if (rule.operator === "eq") {
+        return sameLiteral(value, rule.value);
+    }
+    if (rule.operator === "neq") {
+        return !sameLiteral(value, rule.value);
+    }
+    if (typeof value !== "number" || typeof rule.value !== "number") {
+        return false;
+    }
+    if (rule.operator === "gt") {
+        return value > rule.value;
+    }
+    if (rule.operator === "gte") {
+        return value >= rule.value;
+    }
+    if (rule.operator === "lt") {
+        return value < rule.value;
+    }
+    return value <= rule.value;
+}
+function sameLiteral(left, right) {
+    if (typeof left === "object") {
+        return false;
+    }
+    return left === right;
+}
+//# sourceMappingURL=appearance.js.map

package/dist/render/appearance.js.map

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

package/dist/render/css.d.ts

@@ -0,0 +1,17 @@
+import type { BoxEdges, ElementStyle, FontWeight, LengthUnit } from "../types.js";
+/** Returns a CSS color token, or null when the string could change the declaration list. */
+export declare function cssColor(value: string | undefined): string | null;
+/** Returns a CSS font-family list, or null when the string is not a plain family list. */
+export declare function cssFontFamily(value: string | undefined): string | null;
+export declare function cssFontWeight(value: FontWeight | undefined): string | null;
+export declare function cssLength(value: number, unit: LengthUnit): string;
+export declare function cssNumber(value: number | undefined, minimum: number, maximum: number): string | null;
+export declare function styleAttribute(declarations: ReadonlyArray<readonly [string, string | null]>): string | undefined;
+export declare function boxStyle(style: ElementStyle | undefined, unit: LengthUnit): Array<readonly [string, string | null]>;
+/** Shared border, or one declaration per side when any side is set. */
+export declare function borderDeclarations(style: ElementStyle | undefined, unit: LengthUnit): Array<readonly [string, string | null]>;
+export declare function paddingCss(padding: BoxEdges | undefined, unit: LengthUnit): string | null;
+export declare function textStyle(style: ElementStyle | undefined): Array<readonly [string, string | null]>;
+/** Flex alignment for a text box. Omitted unless vertical alignment is set. */
+export declare function blockAlignDeclarations(style: ElementStyle | undefined): Array<readonly [string, string | null]>;
+//# sourceMappingURL=css.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/render/css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA+B,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AAU1H,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASjE;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAStE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAc1E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMjE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKpG;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAMhH;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAQnH;AAID,uEAAuE;AACvE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,IAAI,EAAE,UAAU,GACf,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAUzC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAWzF;AAgCD,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAclG;AASD,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAuB/G"}

package/dist/render/css.js

@@ -0,0 +1,170 @@
+import { RenderError } from "./errors.js";
+const HEX_COLOR = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+const RGB_COLOR = /^rgba?\(\s*(?:\d{1,3}%?\s*,\s*){2}\d{1,3}%?(?:\s*,\s*(?:\d{1,3}%|0|1|0?\.\d+))?\s*\)$/;
+const NAMED_COLOR = /^(?:transparent|[a-zA-Z]{1,30})$/;
+const FONT_FAMILY = /^(?:[A-Za-z][A-Za-z0-9]*(?:[ -][A-Za-z0-9]+)*|"[A-Za-z0-9 -]+")(?:\s*,\s*(?:[A-Za-z][A-Za-z0-9]*(?:[ -][A-Za-z0-9]+)*|"[A-Za-z0-9 -]+"))*$/;
+/** Returns a CSS color token, or null when the string could change the declaration list. */
+export function cssColor(value) {
+    if (value === undefined) {
+        return null;
+    }
+    const color = value.trim();
+    if (HEX_COLOR.test(color) || RGB_COLOR.test(color) || NAMED_COLOR.test(color)) {
+        return color;
+    }
+    return null;
+}
+/** Returns a CSS font-family list, or null when the string is not a plain family list. */
+export function cssFontFamily(value) {
+    if (value === undefined) {
+        return null;
+    }
+    const family = value.trim();
+    if (family.length === 0 || family.length > 200 || !FONT_FAMILY.test(family)) {
+        return null;
+    }
+    return family;
+}
+export function cssFontWeight(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (value === "medium") {
+        return "500";
+    }
+    if (value === "normal" || value === "bold" || value === "lighter" || value === "bolder") {
+        return value;
+    }
+    if (typeof value === "number" && Number.isFinite(value) && value >= 1 && value <= 1000) {
+        return String(value);
+    }
+    return null;
+}
+export function cssLength(value, unit) {
+    if (!Number.isFinite(value)) {
+        throw new RenderError("invalid_length", "A rendered length must be a finite number.");
+    }
+    const rounded = Math.round(value * 1000) / 1000;
+    return `${rounded}${unit}`;
+}
+export function cssNumber(value, minimum, maximum) {
+    if (value === undefined || !Number.isFinite(value) || value < minimum || value > maximum) {
+        return null;
+    }
+    return String(Math.round(value * 1000) / 1000);
+}
+export function styleAttribute(declarations) {
+    const body = declarations
+        .filter((entry) => entry[1] !== null)
+        .map(([property, value]) => `${property}:${value}`)
+        .join(";");
+    return body.length > 0 ? body : undefined;
+}
+export function boxStyle(style, unit) {
+    return [
+        ["background", cssColor(style?.backgroundColor)],
+        ...borderDeclarations(style, unit),
+        ["border-radius", style?.borderRadius !== undefined ? cssLength(style.borderRadius, unit) : null],
+        ["padding", paddingCss(style?.padding, unit)],
+        ["opacity", cssNumber(style?.opacity, 0, 1)],
+    ];
+}
+const BORDER_LINE = new Set(["solid", "dashed", "dotted", "double", "none"]);
+/** Shared border, or one declaration per side when any side is set. */
+export function borderDeclarations(style, unit) {
+    if (style?.borderTop || style?.borderRight || style?.borderBottom || style?.borderLeft) {
+        return [
+            ["border-top", edgeCss(style.borderTop, style, unit)],
+            ["border-right", edgeCss(style.borderRight, style, unit)],
+            ["border-bottom", edgeCss(style.borderBottom, style, unit)],
+            ["border-left", edgeCss(style.borderLeft, style, unit)],
+        ];
+    }
+    return [["border", sharedBorder(style, unit)]];
+}
+export function paddingCss(padding, unit) {
+    if (!padding) {
+        return null;
+    }
+    const edges = [padding.top, padding.right, padding.bottom, padding.left];
+    if (edges.every((edge) => edge === undefined)) {
+        return null;
+    }
+    return edges
+        .map((edge) => cssLength(edge ?? 0, unit))
+        .join(" ");
+}
+function sharedBorder(style, unit) {
+    const line = borderLine(style?.borderStyle);
+    if (line === "none") {
+        return null;
+    }
+    const borderWidth = style?.borderWidth;
+    const borderColor = cssColor(style?.borderColor);
+    if (borderWidth === undefined || !Number.isFinite(borderWidth) || borderWidth <= 0 || !borderColor) {
+        return null;
+    }
+    return `${cssLength(borderWidth, unit)} ${line} ${borderColor}`;
+}
+function edgeCss(edge, style, unit) {
+    const line = borderLine(edge?.style ?? style.borderStyle);
+    const width = edge?.width ?? style.borderWidth;
+    const color = cssColor(edge?.color ?? style.borderColor);
+    if (line === "none" || width === undefined || !Number.isFinite(width) || width <= 0 || !color) {
+        return "none";
+    }
+    return `${cssLength(width, unit)} ${line} ${color}`;
+}
+function borderLine(value) {
+    if (value !== undefined && BORDER_LINE.has(value)) {
+        return value;
+    }
+    return "solid";
+}
+export function textStyle(style) {
+    const align = style?.textAlign;
+    const textAlign = align === "left" || align === "center" || align === "right" || align === "justify" ? align : null;
+    const fontStyle = style?.fontStyle === "italic" || style?.fontStyle === "normal" ? style.fontStyle : null;
+    return [
+        ["color", cssColor(style?.color) ?? "#1c2430"],
+        ["font-family", cssFontFamily(style?.fontFamily) ?? "Helvetica, Arial, sans-serif"],
+        ["font-size", style?.fontSize !== undefined ? cssLength(style.fontSize, "pt") : "12pt"],
+        ["font-weight", cssFontWeight(style?.fontWeight) ?? "normal"],
+        ["font-style", fontStyle],
+        ["text-align", textAlign],
+        ["text-decoration", textDecoration(style?.textDecoration)],
+        ["line-height", cssNumber(style?.lineHeight, 0, 10)],
+    ];
+}
+function textDecoration(value) {
+    if (value === "none" || value === "underline" || value === "line-through") {
+        return value;
+    }
+    return null;
+}
+/** Flex alignment for a text box. Omitted unless vertical alignment is set. */
+export function blockAlignDeclarations(style) {
+    if (style?.verticalAlign === "middle") {
+        return [
+            ["display", "flex"],
+            ["flex-direction", "column"],
+            ["justify-content", "center"],
+        ];
+    }
+    if (style?.verticalAlign === "bottom") {
+        return [
+            ["display", "flex"],
+            ["flex-direction", "column"],
+            ["justify-content", "flex-end"],
+        ];
+    }
+    if (style?.verticalAlign === "top") {
+        return [
+            ["display", "flex"],
+            ["flex-direction", "column"],
+            ["justify-content", "flex-start"],
+        ];
+    }
+    return [];
+}
+//# sourceMappingURL=css.js.map

package/dist/render/css.js.map

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

package/dist/render/errors.d.ts

@@ -0,0 +1,6 @@
+/** Thrown when rendering cannot continue for a reason other than template validation. */
+export declare class RenderError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/render/errors.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1C"}

package/dist/render/errors.js

@@ -0,0 +1,11 @@
+/** Thrown when rendering cannot continue for a reason other than template validation. */
+export class RenderError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "RenderError";
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/render/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/render/errors.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/render/escape.d.ts

@@ -0,0 +1,7 @@
+/** Escapes text for HTML element content and attribute values. */
+export declare function escapeHtml(value: string): string;
+/**
+ * Emits one tag. Attribute values are escaped. Only the attributes passed here are written.
+ */
+export declare function htmlTag(name: string, attributes: Readonly<Record<string, string | undefined>>, children?: string): string;
+//# sourceMappingURL=escape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../src/render/escape.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAID;;GAEG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACxD,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAYR"}

package/dist/render/escape.js

@@ -0,0 +1,27 @@
+/** Escapes text for HTML element content and attribute values. */
+export function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+const VOID_TAGS = new Set(["img", "meta"]);
+/**
+ * Emits one tag. Attribute values are escaped. Only the attributes passed here are written.
+ */
+export function htmlTag(name, attributes, children) {
+    const parts = [];
+    for (const [key, value] of Object.entries(attributes)) {
+        if (value === undefined) {
+            continue;
+        }
+        parts.push(` ${key}="${escapeHtml(value)}"`);
+    }
+    if (children === undefined && VOID_TAGS.has(name)) {
+        return `<${name}${parts.join("")}>`;
+    }
+    return `<${name}${parts.join("")}>${children ?? ""}</${name}>`;
+}
+//# sourceMappingURL=escape.js.map

package/dist/render/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../src/render/escape.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,UAAwD,EACxD,QAAiB;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,OAAO,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,QAAQ,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC;AACjE,CAAC"}

package/dist/render/image-policy.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Which image URLs may be written into the HTML.
+ * `javascript:` and other non-image schemes are never allowed.
+ * Relative paths are allowed by default. `https` and image data URLs are opt-in.
+ */
+export interface ImageSourcePolicy {
+    allowRelative?: boolean;
+    allowHttps?: boolean;
+    /** When set with `allowHttps`, only these hostnames are accepted. */
+    httpsHosts?: readonly string[];
+    allowDataImages?: boolean;
+}
+/**
+ * Image sources the designer preview may display.
+ * `https`, relative paths, and image data URLs are visible. Dangerous schemes stay blocked.
+ */
+export declare const designerImageSources: ImageSourcePolicy;
+/** Returns the first candidate the policy allows. Later candidates are fallbacks. */
+export declare function firstAllowedImageSource(candidates: readonly string[], policy: ImageSourcePolicy): string | undefined;
+export declare function imageSourceDecision(src: string, policy: ImageSourcePolicy): "allow" | "reject";
+//# sourceMappingURL=image-policy.d.ts.map

package/dist/render/image-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-policy.d.ts","sourceRoot":"","sources":["../../src/render/image-policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAID;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAIlC,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,EAAE,iBAAiB,GACxB,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,GAAG,QAAQ,CAqB9F"}

package/dist/render/image-policy.js

@@ -0,0 +1,62 @@
+const DATA_IMAGE = /^data:image\/(?:png|jpeg|jpg|gif|webp);base64,[a-z0-9+/=\s]+$/i;
+/**
+ * Image sources the designer preview may display.
+ * `https`, relative paths, and image data URLs are visible. Dangerous schemes stay blocked.
+ */
+export const designerImageSources = {
+    allowRelative: true,
+    allowHttps: true,
+    allowDataImages: true,
+};
+/** Returns the first candidate the policy allows. Later candidates are fallbacks. */
+export function firstAllowedImageSource(candidates, policy) {
+    for (const candidate of candidates) {
+        if (imageSourceDecision(candidate, policy) === "allow") {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function imageSourceDecision(src, policy) {
+    const value = src.trim();
+    if (value.length === 0 || /[\u0000-\u001F\u007F]/.test(value)) {
+        return "reject";
+    }
+    if (/^(?:javascript|vbscript|data|file|blob):/i.test(value) && !DATA_IMAGE.test(value)) {
+        return "reject";
+    }
+    if (DATA_IMAGE.test(value)) {
+        return policy.allowDataImages ? "allow" : "reject";
+    }
+    if (/^[a-z][a-z0-9+.-]*:/i.test(value)) {
+        return isApprovedHttps(value, policy) ? "allow" : "reject";
+    }
+    if (policy.allowRelative === false) {
+        return "reject";
+    }
+    if (value.startsWith("//") || value.includes("\\") || /[<>"']/.test(value)) {
+        return "reject";
+    }
+    return "allow";
+}
+function isApprovedHttps(value, policy) {
+    if (!policy.allowHttps || !/^https:\/\//i.test(value)) {
+        return false;
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    if (url.username !== "" || url.password !== "" || url.protocol !== "https:") {
+        return false;
+    }
+    const hosts = policy.httpsHosts;
+    if (!hosts || hosts.length === 0) {
+        return true;
+    }
+    return hosts.some((host) => host.toLowerCase() === url.hostname.toLowerCase());
+}
+//# sourceMappingURL=image-policy.js.map

package/dist/render/image-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-policy.js","sourceRoot":"","sources":["../../src/render/image-policy.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,GAAG,gEAAgE,CAAC;AAEpF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF,qFAAqF;AACrF,MAAM,UAAU,uBAAuB,CACrC,UAA6B,EAC7B,MAAyB;IAEzB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;YACvD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,MAAyB;IACxE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,2CAA2C,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvF,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrD,CAAC;IACD,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,KAAa,EAAE,MAAyB;IAC/D,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,28 @@
+import { type InvoiceCalculationPolicy } from "../invoice/context.js";
+import type { DocumentTemplate } from "../schema.js";
+import { type ImageSourcePolicy } from "./image-policy.js";
+export interface RenderOptions {
+    /** Defaults to the template name. */
+    title?: string;
+    /** `full` is a complete document. `fragment` is the style element plus the page. */
+    document?: "full" | "fragment";
+    /**
+     * Trusted CSS appended after the generated rules.
+     * It is not sanitized as a stylesheet. It cannot contain `<`, so it cannot close the style element.
+     */
+    additionalCss?: string;
+    /** Controls which image URLs are emitted. Relative paths are allowed unless turned off. */
+    imageSources?: ImageSourcePolicy;
+    /**
+     * Overrides the template's saved invoice fraction digits.
+     * Used only when `documentType` is `invoice`.
+     */
+    invoice?: InvoiceCalculationPolicy;
+}
+/**
+ * Renders a saved template and JSON data to HTML.
+ * Text and image bindings are resolved with `resolveTemplateData`. The template and data are not modified.
+ * Image URLs are not requested. Static and bound sources both pass through `imageSources`.
+ */
+export declare function renderToHTML(template: DocumentTemplate, data: unknown, options?: RenderOptions): string;
+//# sourceMappingURL=render-html.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render-html.d.ts","sourceRoot":"","sources":["../../src/render/render-html.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOrD,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGpF,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAiDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAoE3G"}