vellora 0.1.0-alpha.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,28 @@
+# vellora
+
+HTML to PDF for Node.js — no browser. Public API + templating + strict orchestration.
+
+> Part of the [vellora](https://github.com/diomalta/vellora) project.
+> **Pre-release (alpha)** — the API may change before `1.0`.
+
+## Install
+
+```bash
+npm install vellora
+```
+
+## Usage
+
+```ts
+import { renderPdf } from "vellora";
+
+const pdf = await renderPdf(html, data);
+// pdf: Uint8Array — page size comes from CSS in your HTML: @page { size: A4 }
+```
+
+See the [project README](https://github.com/diomalta/vellora#readme) for the full
+guide, compatibility table, and roadmap.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/errors.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Typed error contract for the public `vellora` API.
+ *
+ * Every failure path of `renderPdf` / `renderPdfToStream` rejects with one of these typed errors
+ * (never a bare `Error`). `VelloraError` is the base; consumers branch on `instanceof` and on the
+ * stable, machine-readable `code`. `VelloraUnsupportedError` surfaces the core's located
+ * out-of-subset diagnostic verbatim — node location and remediation hint — and is the single
+ * contract shape mapped from the bridge in `unsupportedFromDiagnostic`.
+ */
+/** Stable, machine-readable error codes. Consumers and CI branch on these. */
+export type VelloraErrorCode = "VELLORA_ERROR" | "VELLORA_TEMPLATE_ERROR" | "VELLORA_INPUT_ERROR" | "VELLORA_UNSUPPORTED";
+/** Base class for every error thrown by the public API. */
+export declare class VelloraError extends Error {
+    /** Stable, machine-readable discriminator. */
+    readonly code: VelloraErrorCode;
+    constructor(message: string, code?: VelloraErrorCode);
+}
+/** A template syntax/semantic error (unclosed block, unknown helper). Carries token location. */
+export declare class VelloraTemplateError extends VelloraError {
+    /** 1-based line of the offending token, when known. */
+    readonly line?: number;
+    /** 1-based column of the offending token, when known. */
+    readonly col?: number;
+    constructor(message: string, location?: {
+        line: number;
+        col: number;
+    });
+}
+/** Bad input to the public API (wrong `html` type, or a `Readable` that errored). */
+export declare class VelloraInputError extends VelloraError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * The located out-of-subset diagnostic the bridge/core emits, flattened across the FFI. This exact
+ * shape is the contract with the napi binding.
+ */
+export interface UnsupportedDiagnostic {
+    /** The out-of-subset feature in the core's colon-namespaced taxonomy, e.g. `"css:animation"` or
+     * `"element:script"`. Best-effort mode normalizes `@vellora/lint` rule ids to this same vocabulary,
+     * so a given construct yields one canonical `feature` regardless of which path reported it. */
+    feature: string;
+    /** 1-based source line of the offending node, or `null` when the source position is unknown. */
+    line: number | null;
+    /** 1-based source column of the offending node, or `null` when the source position is unknown. */
+    col: number | null;
+    /** Remediation hint from the core, e.g. `"run vellora fix"`. */
+    hint: string;
+}
+/**
+ * An out-of-subset construct reported by the core. Carries the located diagnostic verbatim so
+ * consumers and CI can surface a precise, actionable message and branch on it.
+ */
+export declare class VelloraUnsupportedError extends VelloraError {
+    /** The out-of-subset feature reported by the core. */
+    readonly feature: string;
+    /** 1-based source line of the offending node, or `null` when the source position is unknown. */
+    readonly line: number | null;
+    /** 1-based source column of the offending node, or `null` when the source position is unknown. */
+    readonly col: number | null;
+    /** Remediation hint from the core. */
+    readonly hint: string;
+    constructor(diagnostic: UnsupportedDiagnostic);
+}
+/** Type guard: does an unknown value carry the structured located diagnostic fields? */
+export declare function isUnsupportedDiagnostic(value: unknown): value is UnsupportedDiagnostic;
+/**
+ * Adapter (the single seam): reconstruct a `VelloraUnsupportedError` from a core/native
+ * located diagnostic, preserving node location + remediation hint verbatim. The bridge may reject
+ * either with a `VelloraUnsupportedError` already, or with an error/object carrying the structured
+ * `{ feature, line, col, hint }` fields; both map to the same typed error.
+ */
+export declare function unsupportedFromDiagnostic(reason: unknown): VelloraUnsupportedError | undefined;

package/dist/errors.js

@@ -0,0 +1,105 @@
+/**
+ * Typed error contract for the public `vellora` API.
+ *
+ * Every failure path of `renderPdf` / `renderPdfToStream` rejects with one of these typed errors
+ * (never a bare `Error`). `VelloraError` is the base; consumers branch on `instanceof` and on the
+ * stable, machine-readable `code`. `VelloraUnsupportedError` surfaces the core's located
+ * out-of-subset diagnostic verbatim — node location and remediation hint — and is the single
+ * contract shape mapped from the bridge in `unsupportedFromDiagnostic`.
+ */
+/** Base class for every error thrown by the public API. */
+export class VelloraError extends Error {
+    /** Stable, machine-readable discriminator. */
+    code;
+    constructor(message, code = "VELLORA_ERROR") {
+        super(message);
+        this.name = "VelloraError";
+        this.code = code;
+    }
+}
+/** A template syntax/semantic error (unclosed block, unknown helper). Carries token location. */
+export class VelloraTemplateError extends VelloraError {
+    /** 1-based line of the offending token, when known. */
+    line;
+    /** 1-based column of the offending token, when known. */
+    col;
+    constructor(message, location) {
+        super(message, "VELLORA_TEMPLATE_ERROR");
+        this.name = "VelloraTemplateError";
+        this.line = location?.line;
+        this.col = location?.col;
+    }
+}
+/** Bad input to the public API (wrong `html` type, or a `Readable` that errored). */
+export class VelloraInputError extends VelloraError {
+    constructor(message, options) {
+        super(message, "VELLORA_INPUT_ERROR");
+        this.name = "VelloraInputError";
+        if (options && "cause" in options) {
+            this.cause = options.cause;
+        }
+    }
+}
+/**
+ * An out-of-subset construct reported by the core. Carries the located diagnostic verbatim so
+ * consumers and CI can surface a precise, actionable message and branch on it.
+ */
+export class VelloraUnsupportedError extends VelloraError {
+    /** The out-of-subset feature reported by the core. */
+    feature;
+    /** 1-based source line of the offending node, or `null` when the source position is unknown. */
+    line;
+    /** 1-based source column of the offending node, or `null` when the source position is unknown. */
+    col;
+    /** Remediation hint from the core. */
+    hint;
+    constructor(diagnostic) {
+        super(formatUnsupportedMessage(diagnostic), "VELLORA_UNSUPPORTED");
+        this.name = "VelloraUnsupportedError";
+        this.feature = diagnostic.feature;
+        this.line = diagnostic.line;
+        this.col = diagnostic.col;
+        this.hint = diagnostic.hint;
+    }
+}
+/** Render the located-diagnostic message, omitting the location when line/col are unknown (null). */
+function formatUnsupportedMessage(diagnostic) {
+    const location = diagnostic.line !== null && diagnostic.col !== null
+        ? ` at line ${diagnostic.line}, column ${diagnostic.col}`
+        : "";
+    return `Unsupported construct "${diagnostic.feature}"${location}: ${diagnostic.hint}`;
+}
+/** Type guard: does an unknown value carry the structured located diagnostic fields? */
+export function isUnsupportedDiagnostic(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const v = value;
+    return (typeof v.feature === "string" &&
+        (typeof v.line === "number" || v.line === null) &&
+        (typeof v.col === "number" || v.col === null) &&
+        typeof v.hint === "string");
+}
+/**
+ * Adapter (the single seam): reconstruct a `VelloraUnsupportedError` from a core/native
+ * located diagnostic, preserving node location + remediation hint verbatim. The bridge may reject
+ * either with a `VelloraUnsupportedError` already, or with an error/object carrying the structured
+ * `{ feature, line, col, hint }` fields; both map to the same typed error.
+ */
+export function unsupportedFromDiagnostic(reason) {
+    if (reason instanceof VelloraUnsupportedError) {
+        return reason;
+    }
+    if (isUnsupportedDiagnostic(reason)) {
+        return new VelloraUnsupportedError(reason);
+    }
+    // The error may carry the diagnostic on a nested property (FFI flattening).
+    if (typeof reason === "object" && reason !== null) {
+        const diagnostic = reason.diagnostic;
+        if (isUnsupportedDiagnostic(diagnostic)) {
+            return new VelloraUnsupportedError(diagnostic);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * vellora — public API.
+ *
+ * Pass document HTML (and optional data) in, get a deterministic PDF out, strict by default.
+ *
+ *   import { renderPdf } from "vellora";
+ *   const pdf = await renderPdf(html, data);
+ *
+ * Input is always **content** (string | Uint8Array | Readable), never a file path. Templating
+ * (`{{ var }}`, `{% for %}`, `{% if %}`, `currency`/`number`/`date` helpers) runs before render.
+ * Strict mode validates and never mutates; `{ strict: false }` runs `@vellora/lint` fixers first.
+ */
+export { isUnsupportedDiagnostic, unsupportedFromDiagnostic, type UnsupportedDiagnostic, VelloraError, type VelloraErrorCode, VelloraInputError, VelloraTemplateError, VelloraUnsupportedError, } from "./errors.js";
+export { MockNativeBridge, type MockRenderCall } from "./mock-bridge.js";
+export { NativeAddonBridge } from "./native-bridge.js";
+export { DEFAULT_CREATION_DATE, resolveOptions } from "./orchestrate.js";
+export { renderPdf, renderPdfToStream, setNativeBridge } from "./render.js";
+export { renderTemplate } from "./template/index.js";
+export type { BridgeRenderOptions, HtmlInput, NativeBridge, RenderData, RenderMetadata, RenderOptions, } from "./types.js";

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * vellora — public API.
+ *
+ * Pass document HTML (and optional data) in, get a deterministic PDF out, strict by default.
+ *
+ *   import { renderPdf } from "vellora";
+ *   const pdf = await renderPdf(html, data);
+ *
+ * Input is always **content** (string | Uint8Array | Readable), never a file path. Templating
+ * (`{{ var }}`, `{% for %}`, `{% if %}`, `currency`/`number`/`date` helpers) runs before render.
+ * Strict mode validates and never mutates; `{ strict: false }` runs `@vellora/lint` fixers first.
+ */
+export { isUnsupportedDiagnostic, unsupportedFromDiagnostic, VelloraError, VelloraInputError, VelloraTemplateError, VelloraUnsupportedError, } from "./errors.js";
+export { MockNativeBridge } from "./mock-bridge.js";
+export { NativeAddonBridge } from "./native-bridge.js";
+export { DEFAULT_CREATION_DATE, resolveOptions } from "./orchestrate.js";
+export { renderPdf, renderPdfToStream, setNativeBridge } from "./render.js";
+export { renderTemplate } from "./template/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EAEzB,YAAY,EAEZ,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAuB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,6 @@
+import type { HtmlInput } from "./types.js";
+/**
+ * Normalize `html` to a content string. No filesystem access; a path-like string is content.
+ * Async because a `Readable` must be drained before templating begins.
+ */
+export declare function normalizeInput(html: HtmlInput): Promise<string>;

package/dist/input.js

@@ -0,0 +1,79 @@
+import { VelloraInputError } from "./errors.js";
+const UTF8 = new TextDecoder("utf-8", { fatal: true });
+/**
+ * Decode bytes as strict UTF-8. The native core rejects non-UTF-8 input, so the public byte path
+ * must too: a `fatal` decoder throws on malformed bytes, which we map to a `VelloraInputError`
+ * rather than silently substituting U+FFFD (which would re-encode as valid UTF-8 and hide the bug).
+ */
+function decodeUtf8(bytes) {
+    try {
+        return UTF8.decode(bytes);
+    }
+    catch (cause) {
+        throw new VelloraInputError("The input HTML is not valid UTF-8.", { cause });
+    }
+}
+/** Duck-typed `Readable` check (avoids `instanceof` coupling across realms). */
+function isReadable(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.pipe === "function" &&
+        typeof value.on === "function");
+}
+/** Buffer a `Readable` to completion, then decode as UTF-8. Rejects (never hangs) on stream error. */
+function bufferReadable(stream) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        const onError = (cause) => {
+            cleanup();
+            reject(new VelloraInputError("The input HTML stream errored before it ended.", { cause }));
+        };
+        const onData = (chunk) => {
+            chunks.push(typeof chunk === "string" ? Buffer.from(chunk, "utf8") : chunk);
+        };
+        const onEnd = () => {
+            cleanup();
+            try {
+                resolve(decodeUtf8(Buffer.concat(chunks)));
+            }
+            catch (err) {
+                reject(err);
+            }
+        };
+        const cleanup = () => {
+            stream.off("data", onData);
+            stream.off("end", onEnd);
+            stream.off("error", onError);
+            stream.off("close", onClose);
+        };
+        const onClose = () => {
+            // A destroy() without an `error` still closes; treat a close-before-end as an error so the
+            // promise never hangs waiting for an `end` that will not arrive.
+            cleanup();
+            reject(new VelloraInputError("The input HTML stream closed before it ended.", {
+                cause: undefined,
+            }));
+        };
+        stream.on("data", onData);
+        stream.once("end", onEnd);
+        stream.once("error", onError);
+        stream.once("close", onClose);
+    });
+}
+/**
+ * Normalize `html` to a content string. No filesystem access; a path-like string is content.
+ * Async because a `Readable` must be drained before templating begins.
+ */
+export async function normalizeInput(html) {
+    if (typeof html === "string") {
+        return html;
+    }
+    if (html instanceof Uint8Array) {
+        return decodeUtf8(html);
+    }
+    if (isReadable(html)) {
+        return bufferReadable(html);
+    }
+    throw new VelloraInputError("Invalid html input: expected a string, Uint8Array, or Readable (content, never a file path).");
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

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

package/dist/mock-bridge.d.ts

@@ -0,0 +1,15 @@
+import type { BridgeRenderOptions, NativeBridge } from "./types.js";
+/** One record of a `render` call, captured for test assertions. */
+export interface MockRenderCall {
+    html: string;
+    options: BridgeRenderOptions;
+}
+/**
+ * A deterministic mock implementing the `NativeBridge` contract. The bytes are a stable function of
+ * `(html, options)`, so identical inputs render byte-identically and different inputs differ.
+ */
+export declare class MockNativeBridge implements NativeBridge {
+    /** Every `render` call, in order, for assertions. */
+    readonly calls: MockRenderCall[];
+    render(html: string, options: BridgeRenderOptions): Promise<Uint8Array>;
+}

package/dist/mock-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-bridge.js","sourceRoot":"","sources":["../src/mock-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAgBvD;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAsB;IAC3C,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAC/E,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAC/E,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE;CACjF,CAAC;AAEF,6FAA6F;AAC7F,SAAS,aAAa,CAAC,IAAY;IACjC,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC3B,qDAAqD;IAC5C,KAAK,GAAqB,EAAE,CAAC;IAEtC,MAAM,CAAC,IAAY,EAAE,OAA4B;QAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAY,EAAE,OAA4B;IAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC;SAChC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;SACpB,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC;SACnB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;SAChD,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,MAAM,IAAI,GAAG;QACX,UAAU;QACV,SAAS;QACT,mCAAmC;QACnC,QAAQ;QACR,SAAS;QACT,2CAA2C;QAC3C,QAAQ;QACR,SAAS;QACT,iCAAiC;QACjC,QAAQ;QACR,kBAAkB,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;QACjD,aAAa,MAAM,EAAE;QACrB,OAAO;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/native-bridge.d.ts

@@ -0,0 +1,6 @@
+import type { BridgeRenderOptions, NativeBridge } from "./types.js";
+export declare class NativeAddonBridge implements NativeBridge {
+    private renderFn?;
+    private load;
+    render(html: string, options: BridgeRenderOptions): Promise<Uint8Array>;
+}

package/dist/native-bridge.js

@@ -0,0 +1,43 @@
+/**
+ * Real native bridge: adapts `@vellora/native` (the prebuilt napi-rs addon) to the `NativeBridge`
+ * contract the orchestration calls. This is the production default; the mock backs unit tests.
+ *
+ * The addon is imported lazily on first render, so importing `vellora` never loads the native `.node`
+ * until a real render happens (tests that inject their own bridge never trigger it).
+ */
+import { VelloraInputError } from "./errors.js";
+/**
+ * Map the orchestration's ISO-8601 creation date to the addon's `[year, month, day]` (UTC).
+ *
+ * Currently records the PDF creation date at **date granularity (year, month, day) in UTC** — the
+ * `vellora-core` PDF writer only accepts y/m/d — so the time-of-day and timezone of the ISO-8601
+ * instant are intentionally dropped here (documented, not silent). The public boundary
+ * (`orchestrate.resolveOptions`) rejects an unparseable date before we get here; the `Number.isNaN`
+ * guard below is defense-in-depth so a `NaN` triple can never be forwarded across the FFI.
+ */
+function isoToYmd(iso) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime())) {
+        throw new VelloraInputError(`metadata.creationDate must be a valid ISO-8601 date string; received ${JSON.stringify(iso)}.`);
+    }
+    return [d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate()];
+}
+export class NativeAddonBridge {
+    renderFn;
+    async load() {
+        if (!this.renderFn) {
+            const native = (await import("@vellora/native"));
+            this.renderFn = native.render;
+        }
+        return this.renderFn;
+    }
+    async render(html, options) {
+        const render = await this.load();
+        const bytes = new TextEncoder().encode(html);
+        return render(bytes, {
+            title: options.metadata.title,
+            creationDate: isoToYmd(options.metadata.creationDate),
+        });
+    }
+}
+//# sourceMappingURL=native-bridge.js.map

package/dist/native-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-bridge.js","sourceRoot":"","sources":["../src/native-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD;;;;;;;;GAQG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,iBAAiB,CACzB,wEAAwE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAAe;IAEvB,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAA4B,CAAC;YAC5E,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAA4B;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,KAAK,EAAE;YACnB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK;YAC7B,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/orchestrate.d.ts

@@ -0,0 +1,17 @@
+import type { BridgeRenderOptions, NativeBridge, RenderOptions } from "./types.js";
+/**
+ * Fixed default PDF creation date injected when `opts.metadata.creationDate` is omitted. A constant
+ * (the project's reference instant), never the host wall-clock, so output is byte-stable. This is
+ * what satisfies the `vellora-core` `pdf-output` "Deterministic creation date" precondition.
+ */
+export declare const DEFAULT_CREATION_DATE = "2000-01-01T00:00:00.000Z";
+/** Resolve public `RenderOptions` into the fully-resolved config handed to the bridge. */
+export declare function resolveOptions(opts?: RenderOptions): BridgeRenderOptions;
+/**
+ * Drive validation + native render for already-templated HTML.
+ *
+ * @param html finalized HTML from the templating engine.
+ * @param opts public render options (default strict).
+ * @param bridge the swappable native render boundary.
+ */
+export declare function orchestrate(html: string, opts: RenderOptions, bridge: NativeBridge): Promise<Uint8Array>;

package/dist/orchestrate.js

@@ -0,0 +1,148 @@
+import { VelloraError, VelloraInputError, VelloraUnsupportedError, unsupportedFromDiagnostic, } from "./errors.js";
+/**
+ * Map a `@vellora/lint` `RuleId` (kebab-case) onto the SAME colon-namespaced `feature` taxonomy the
+ * `vellora-core` strict path emits (`element:<tag>`, `css:<feature>`), so the typed
+ * `VelloraUnsupportedError.feature` is identical for a given out-of-subset construct whether it is
+ * surfaced via best-effort lint or via the strict/core gate. The `{ feature, line, col, hint }`
+ * shape is a single contract; consumers/CI key on `feature`, so the two paths must not
+ * diverge.
+ */
+const RULE_ID_TO_CORE_FEATURE = {
+    "script-element": "element:script",
+    "inline-svg": "element:svg",
+    "css-animation": "css:animation",
+    "flex-grid-in-td": "css:grid",
+    "img-dimension-attrs": "css:img-dimensions",
+    "invalid-markup": "html:invalid-markup",
+};
+/**
+ * Fixed default PDF creation date injected when `opts.metadata.creationDate` is omitted. A constant
+ * (the project's reference instant), never the host wall-clock, so output is byte-stable. This is
+ * what satisfies the `vellora-core` `pdf-output` "Deterministic creation date" precondition.
+ */
+export const DEFAULT_CREATION_DATE = "2000-01-01T00:00:00.000Z";
+/** Inclusive UTC-year range accepted at the public boundary. The napi FFI maps the year to a `u16`
+ * (`[year, month, day]`), so a year outside `1..=65535` would otherwise pass public validation yet be
+ * silently dropped at the FFI checked-conversion (extended-ISO years run to +275760). Rejecting it
+ * here keeps the two validation layers in agreement and turns the failure into a typed
+ * `VelloraInputError` instead of a silent FFI drop. */
+const MIN_CREATION_YEAR = 1;
+const MAX_CREATION_YEAR = 65535;
+/**
+ * Validate a caller-supplied `creationDate` at the public boundary. The string must be a
+ * `Date`-parseable ISO-8601 instant whose UTC year fits the FFI `u16`; an empty, non-parseable, or
+ * out-of-`u16`-range value rejects with `VelloraInputError` rather than being forwarded as a `NaN`
+ * date (which the core would otherwise coerce to a silently-wrong year-0 date) or silently dropped at
+ * the FFI.
+ */
+function validateCreationDate(creationDate) {
+    const date = new Date(creationDate);
+    if (creationDate.trim() === "" || Number.isNaN(date.getTime())) {
+        throw new VelloraInputError(`metadata.creationDate must be a valid ISO-8601 date string; received ${JSON.stringify(creationDate)}.`);
+    }
+    const year = date.getUTCFullYear();
+    if (year < MIN_CREATION_YEAR || year > MAX_CREATION_YEAR) {
+        throw new VelloraInputError(`metadata.creationDate year must be in ${MIN_CREATION_YEAR}..=${MAX_CREATION_YEAR}; received year ${year} from ${JSON.stringify(creationDate)}.`);
+    }
+}
+/** Resolve public `RenderOptions` into the fully-resolved config handed to the bridge. */
+export function resolveOptions(opts = {}) {
+    const metadata = opts.metadata ?? {};
+    if (metadata.creationDate !== undefined) {
+        validateCreationDate(metadata.creationDate);
+    }
+    const resolved = {
+        metadata: {
+            ...metadata,
+            creationDate: metadata.creationDate ?? DEFAULT_CREATION_DATE,
+        },
+    };
+    if ("fonts" in opts) {
+        resolved.fonts = opts.fonts;
+    }
+    if ("images" in opts) {
+        resolved.images = opts.images;
+    }
+    if (opts.baseUrl !== undefined) {
+        resolved.baseUrl = opts.baseUrl;
+    }
+    return resolved;
+}
+/**
+ * Best-effort fix: lazily import `@vellora/lint` (only here) and run its fixers on the HTML.
+ *
+ * `@vellora/lint` is a declared dependency that exports `fix`, so a missing `fix` indicates a real
+ * resolution/version/config failure of the requested best-effort operation — fail loudly instead of
+ * silently rendering the un-fixed HTML. It must also return the current `{ html, report }`
+ * shape; an old/version-skewed `fix` that resolves but returns the old `{ html }` shape would
+ * otherwise throw an opaque `TypeError` on `report.findings`, so its return is shape-guarded with the
+ * same loud message. The fixer also already computes the residual, non-auto-fixable findings;
+ * rather than discard them and rely on a later core gate, surface the first error-severity finding as
+ * the same typed `VelloraUnsupportedError` the core path uses, normalized to the core `feature`
+ * taxonomy.
+ */
+async function applyFixers(html) {
+    const lint = await import("@vellora/lint");
+    const fix = lint.fix;
+    if (typeof fix !== "function") {
+        throw new VelloraError("best-effort mode requested but @vellora/lint.fix is unavailable");
+    }
+    const result = await fix(html);
+    // Guard the return SHAPE before dereferencing `report.findings`: the static cast above makes the
+    // structural fields look total to tsc, but a mis-resolved/old-version `fix` could resolve and
+    // return a different runtime shape. Fail loudly with a meaningful message instead of leaking a raw
+    // `TypeError: Cannot read properties of undefined (reading 'findings')`.
+    if (!result ||
+        typeof result.html !== "string" ||
+        !result.report ||
+        !Array.isArray(result.report.findings)) {
+        throw new VelloraError("best-effort mode requested but @vellora/lint.fix returned an unexpected shape");
+    }
+    // The fixer already located every remaining, non-auto-fixable diagnostic. Surface the first
+    // error-severity one as the typed error contract rather than dropping it. Normalize
+    // the lint `RuleId` to the core `feature` taxonomy so the best-effort and strict/core paths emit the
+    // IDENTICAL `feature` for the same construct. The lint `location` is in the FIXED/re-serialized
+    // output coordinate space (see `@vellora/lint.fix`), but the caller holds the ORIGINAL HTML and the
+    // orchestrator has no mapping back, so report `null` line/col rather than a coordinate that may point
+    // into the rewritten document — matching the core path's honest-None behavior.
+    const unfixable = result.report.findings.find((f) => f.severity === "error" && !f.applied);
+    if (unfixable) {
+        throw new VelloraUnsupportedError({
+            feature: RULE_ID_TO_CORE_FEATURE[unfixable.rule] ?? unfixable.rule,
+            line: null,
+            col: null,
+            hint: unfixable.suggestedFix,
+        });
+    }
+    return result.html;
+}
+/**
+ * Drive validation + native render for already-templated HTML.
+ *
+ * @param html finalized HTML from the templating engine.
+ * @param opts public render options (default strict).
+ * @param bridge the swappable native render boundary.
+ */
+export async function orchestrate(html, opts, bridge) {
+    const resolved = resolveOptions(opts);
+    const strict = opts.strict !== false;
+    try {
+        // `applyFixers` runs inside the try so any fixer crash (e.g. a resvg rasterize failure) is
+        // mapped to a typed Vellora error instead of escaping as a bare `Error`.
+        const finalHtml = strict ? html : await applyFixers(html);
+        return await bridge.render(finalHtml, resolved);
+    }
+    catch (reason) {
+        const unsupported = unsupportedFromDiagnostic(reason);
+        if (unsupported) {
+            throw unsupported;
+        }
+        // Already-typed Vellora errors propagate unchanged; anything else (e.g. a raw fixer/resvg
+        // crash) is wrapped so the public contract never leaks a bare `Error`.
+        if (reason instanceof VelloraError) {
+            throw reason;
+        }
+        throw new VelloraError(reason instanceof Error ? reason.message : String(reason));
+    }
+}
+//# sourceMappingURL=orchestrate.js.map

package/dist/orchestrate.js.map

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