vellora 0.1.0-alpha.0

package/dist/render.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Public render functions: `renderPdf` and `renderPdfToStream`.
+ *
+ * Both wire input handling → templating → strict orchestration → native bridge. Input is always
+ * content (string | Uint8Array | Readable), never a path, and a `Readable` is buffered in full
+ * before templating. Currently the native bridge is the deterministic mock; the native bridge
+ * swaps in the real `@vellora/native` with no change to these signatures.
+ */
+import type { Writable } from "node:stream";
+import { VelloraInputError } from "./errors.js";
+import type { HtmlInput, NativeBridge, RenderData, RenderOptions } from "./types.js";
+/** Test/wiring seam: swap the default native bridge. Returns the previous bridge. */
+export declare function setNativeBridge(bridge: NativeBridge): NativeBridge;
+/**
+ * Render document HTML to a complete PDF.
+ *
+ * @param html document **content** (string | Uint8Array | Readable), never a file path.
+ * @param data optional templating data.
+ * @param opts optional render options (`strict` defaults to `true`).
+ */
+export declare function renderPdf(html: HtmlInput, data?: RenderData, opts?: RenderOptions): Promise<Uint8Array>;
+/**
+ * Render document HTML and write the complete PDF to `writable`, then end it.
+ *
+ * Input is fully buffered; the complete PDF is produced via the native render path and then written.
+ * Resolves only after the complete PDF is written. A `writable` `error` rejects and aborts.
+ * (Page-by-page progressive emission awaits a future native streaming surface.)
+ */
+export declare function renderPdfToStream(html: HtmlInput, writable: Writable, data?: RenderData, opts?: RenderOptions): Promise<void>;
+export { VelloraInputError };

package/dist/render.js

@@ -0,0 +1,82 @@
+import { VelloraError, VelloraInputError } from "./errors.js";
+import { normalizeInput } from "./input.js";
+import { NativeAddonBridge } from "./native-bridge.js";
+import { orchestrate } from "./orchestrate.js";
+import { renderTemplate } from "./template/index.js";
+/**
+ * Internal: the active native bridge. The production default is the real `@vellora/native` addon
+ * (lazy — the `.node` loads only on first render). Unit tests reset this to the deterministic mock
+ * (see `test/_setup-bridge.ts`); a per-call override is passed via `_bridge`.
+ */
+let defaultBridge;
+function getDefaultBridge() {
+    if (!defaultBridge) {
+        defaultBridge = new NativeAddonBridge();
+    }
+    return defaultBridge;
+}
+/** Test/wiring seam: swap the default native bridge. Returns the previous bridge. */
+export function setNativeBridge(bridge) {
+    const previous = getDefaultBridge();
+    defaultBridge = bridge;
+    return previous;
+}
+/** Run the shared pipeline: normalize → template → orchestrate, resolving to PDF bytes. */
+async function pipeline(html, data, opts) {
+    const content = await normalizeInput(html);
+    const templated = renderTemplate(content, data);
+    const bridge = opts._bridge ?? getDefaultBridge();
+    return orchestrate(templated, opts, bridge);
+}
+/**
+ * Render document HTML to a complete PDF.
+ *
+ * @param html document **content** (string | Uint8Array | Readable), never a file path.
+ * @param data optional templating data.
+ * @param opts optional render options (`strict` defaults to `true`).
+ */
+export function renderPdf(html, data, opts = {}) {
+    return pipeline(html, data, opts);
+}
+/**
+ * Render document HTML and write the complete PDF to `writable`, then end it.
+ *
+ * Input is fully buffered; the complete PDF is produced via the native render path and then written.
+ * Resolves only after the complete PDF is written. A `writable` `error` rejects and aborts.
+ * (Page-by-page progressive emission awaits a future native streaming surface.)
+ */
+export async function renderPdfToStream(html, writable, data, opts = {}) {
+    const pdf = await pipeline(html, data, opts);
+    await writeAndEnd(writable, pdf);
+}
+/** Write a buffer to a `Writable` and end it; reject on a destination error. */
+function writeAndEnd(writable, bytes) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const fail = (cause) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            reject(cause instanceof Error ? cause : new VelloraError(String(cause)));
+        };
+        // Stay subscribed for the lifetime of the write so a post-callback `error` event (Node emits one
+        // when a write callback reports an error) is absorbed rather than left uncaught.
+        writable.on("error", fail);
+        writable.write(bytes, (writeErr) => {
+            if (writeErr) {
+                fail(writeErr);
+                return;
+            }
+            writable.end(() => {
+                if (!settled) {
+                    settled = true;
+                    resolve();
+                }
+            });
+        });
+    });
+}
+// Re-export so the public barrel can avoid importing the input module directly.
+export { VelloraInputError };
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/source-position.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared offset→{line,col} mapping. One implementation for the mock bridge's violation locator and
+ * the tokenizer's non-incremental callers, so the two can't drift. The tokenizer's main scan tracks
+ * line/col incrementally (single O(N) pass); this helper serves the occasional one-off lookup.
+ */
+/** Compute the 1-based line/column of an absolute `offset` within `source`. */
+export declare function offsetToLineCol(source: string, offset: number): {
+    line: number;
+    col: number;
+};

package/dist/source-position.js

@@ -0,0 +1,21 @@
+/**
+ * Shared offset→{line,col} mapping. One implementation for the mock bridge's violation locator and
+ * the tokenizer's non-incremental callers, so the two can't drift. The tokenizer's main scan tracks
+ * line/col incrementally (single O(N) pass); this helper serves the occasional one-off lookup.
+ */
+/** Compute the 1-based line/column of an absolute `offset` within `source`. */
+export function offsetToLineCol(source, offset) {
+    let line = 1;
+    let col = 1;
+    for (let i = 0; i < offset; i++) {
+        if (source[i] === "\n") {
+            line++;
+            col = 1;
+        }
+        else {
+            col++;
+        }
+    }
+    return { line, col };
+}
+//# sourceMappingURL=source-position.js.map

package/dist/source-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-position.js","sourceRoot":"","sources":["../src/source-position.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc;IAC5D,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,EAAE,CAAC;YACP,GAAG,GAAG,CAAC,CAAC;QACV,CAAC;aAAM,CAAC;YACN,GAAG,EAAE,CAAC;QACR,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/template/helpers.d.ts

@@ -0,0 +1,7 @@
+/** A built-in helper: receives the resolved value + literal args, returns a string. */
+export type Helper = (value: unknown, args: unknown[], location: {
+    line: number;
+    col: number;
+}) => string;
+/** The built-in helper registry. Unknown helper names reject with a `VelloraTemplateError`. */
+export declare const HELPERS: Record<string, Helper>;

package/dist/template/helpers.js

@@ -0,0 +1,150 @@
+/**
+ * Deterministic format helpers: `currency`, `number`, `date`.
+ *
+ * Determinism is the hard constraint (ARCHITECTURE.md: same template + data ⇒ byte-stable PDF):
+ * helpers NEVER read the host's ambient `Intl` locale or `TZ`. `currency`/`number` use
+ * `Intl.NumberFormat` with an explicitly pinned locale; `date` parses the instant as UTC and formats
+ * via an explicit format string in UTC. Output is escaped by the interpolation layer like any value.
+ */
+import { VelloraTemplateError } from "../errors.js";
+/** Locale pinned per currency so output is machine-independent. Extend as currencies are added. */
+const CURRENCY_LOCALE = {
+    BRL: "pt-BR",
+    USD: "en-US",
+    EUR: "de-DE",
+    GBP: "en-GB",
+};
+function toNumber(value) {
+    if (typeof value === "number") {
+        return value;
+    }
+    if (typeof value === "string" && value.trim() !== "") {
+        const n = Number(value);
+        if (!Number.isNaN(n)) {
+            return n;
+        }
+    }
+    return Number.NaN;
+}
+/** `currency(code)` — e.g. `currency("BRL")` ⇒ `R$ 1.234,50` (NBSP separator, per Intl pt-BR/BRL). */
+const currency = (value, args, location) => {
+    const code = args[0];
+    if (typeof code !== "string") {
+        throw new VelloraTemplateError('currency() requires a currency code string, e.g. currency("BRL").', location);
+    }
+    if (!/^[A-Za-z]{3}$/.test(code)) {
+        throw new VelloraTemplateError(`currency() received an invalid currency code: ${JSON.stringify(code)}. Expected a 3-letter ISO 4217 code, e.g. currency("BRL").`, location);
+    }
+    const n = toNumber(value);
+    if (Number.isNaN(n)) {
+        return "";
+    }
+    const locale = CURRENCY_LOCALE[code] ?? "en-US";
+    return new Intl.NumberFormat(locale, { style: "currency", currency: code }).format(n);
+};
+/** `number(fractionDigits?)` — fixed fraction digits via en-US so the decimal point is `.`. */
+const number = (value, args, location) => {
+    const digitsArg = args[0];
+    let digits;
+    if (digitsArg !== undefined) {
+        // `Intl.NumberFormat` requires `fractionDigits` to be an integer in [0, 20]; out-of-range or
+        // non-integer values throw a raw `RangeError`. Validate up front for a located message.
+        if (typeof digitsArg !== "number" ||
+            !Number.isInteger(digitsArg) ||
+            digitsArg < 0 ||
+            digitsArg > 20) {
+            throw new VelloraTemplateError(`number() received an invalid fraction-digit count: ${JSON.stringify(digitsArg)}. Expected an integer in [0, 20].`, location);
+        }
+        digits = digitsArg;
+    }
+    const n = toNumber(value);
+    if (Number.isNaN(n)) {
+        return "";
+    }
+    return new Intl.NumberFormat("en-US", {
+        minimumFractionDigits: digits,
+        maximumFractionDigits: digits,
+        useGrouping: false,
+    }).format(n);
+};
+const MONTHS = [
+    "January",
+    "February",
+    "March",
+    "April",
+    "May",
+    "June",
+    "July",
+    "August",
+    "September",
+    "October",
+    "November",
+    "December",
+];
+/** Parse a date-ish value to UTC fields. Accepts ISO date / ISO instant / Date. NaN ⇒ undefined. */
+function toUtcDate(value) {
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? undefined : value;
+    }
+    if (typeof value !== "string" || value.trim() === "") {
+        return undefined;
+    }
+    // A bare `YYYY-MM-DD` is parsed by the platform as UTC midnight; an instant carries its own zone.
+    // A local datetime without zone (`YYYY-MM-DDTHH:mm:ss`) is pinned to UTC for determinism.
+    const bareLocal = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?(\.\d+)?$/.test(value);
+    const instant = new Date(bareLocal ? `${value}Z` : value);
+    return Number.isNaN(instant.getTime()) ? undefined : instant;
+}
+function pad(n, width) {
+    return String(n).padStart(width, "0");
+}
+/**
+ * `date(format)` — UTC formatting against an explicit token string so output is timezone-stable.
+ * Supported tokens: `YYYY` `YY` `MM` `M` `MMMM` `DD` `D` `HH` `mm` `ss`.
+ */
+const date = (value, args, location) => {
+    const format = args[0];
+    if (typeof format !== "string") {
+        throw new VelloraTemplateError('date() requires a format string, e.g. date("YYYY-MM-DD").', location);
+    }
+    const d = toUtcDate(value);
+    if (!d) {
+        return "";
+    }
+    const year = d.getUTCFullYear();
+    const month = d.getUTCMonth() + 1;
+    const day = d.getUTCDate();
+    const hours = d.getUTCHours();
+    const minutes = d.getUTCMinutes();
+    const seconds = d.getUTCSeconds();
+    // Longest tokens first so `YYYY` is not consumed as two `YY`, and `MMMM` before `MM`.
+    return format.replace(/YYYY|MMMM|YY|MM|DD|HH|mm|ss|M|D/g, (token) => {
+        switch (token) {
+            case "YYYY":
+                return pad(year, 4);
+            case "YY":
+                return pad(year % 100, 2);
+            case "MMMM":
+                return MONTHS[month - 1] ?? "";
+            case "MM":
+                return pad(month, 2);
+            case "M":
+                return String(month);
+            case "DD":
+                return pad(day, 2);
+            case "D":
+                return String(day);
+            case "HH":
+                return pad(hours, 2);
+            case "mm":
+                return pad(minutes, 2);
+            case "ss":
+                return pad(seconds, 2);
+            default:
+                return token;
+        }
+    });
+};
+/** The built-in helper registry. Unknown helper names reject with a `VelloraTemplateError`. */
+export const HELPERS = { currency, number, date };
+//# sourceMappingURL=helpers.js.map

package/dist/template/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/template/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,mGAAmG;AACnG,MAAM,eAAe,GAA2B;IAC9C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,OAAO;CACb,CAAC;AASF,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC;AACpB,CAAC;AAED,sGAAsG;AACtG,MAAM,QAAQ,GAAW,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,oBAAoB,CAC5B,mEAAmE,EACnE,QAAQ,CACT,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,oBAAoB,CAC5B,iDAAiD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,4DAA4D,EACjI,QAAQ,CACT,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;IAChD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,MAAM,GAAW,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,MAA0B,CAAC;IAC/B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,6FAA6F;QAC7F,wFAAwF;QACxF,IACE,OAAO,SAAS,KAAK,QAAQ;YAC7B,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;YAC5B,SAAS,GAAG,CAAC;YACb,SAAS,GAAG,EAAE,EACd,CAAC;YACD,MAAM,IAAI,oBAAoB,CAC5B,sDAAsD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,mCAAmC,EAClH,QAAQ,CACT,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;QACpC,qBAAqB,EAAE,MAAM;QAC7B,qBAAqB,EAAE,MAAM;QAC7B,WAAW,EAAE,KAAK;KACnB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG;IACb,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAC;AAEF,oGAAoG;AACpG,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,kGAAkG;IAClG,0FAA0F;IAC1F,MAAM,SAAS,GAAG,kDAAkD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED,SAAS,GAAG,CAAC,CAAS,EAAE,KAAa;IACnC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,IAAI,GAAW,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,oBAAoB,CAC5B,2DAA2D,EAC3D,QAAQ,CACT,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC;IAClC,sFAAsF;IACtF,OAAO,MAAM,CAAC,OAAO,CAAC,kCAAkC,EAAE,CAAC,KAAK,EAAE,EAAE;QAClE,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtB,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAC5B,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACvB,KAAK,GAAG;gBACN,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,KAAK,GAAG;gBACN,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACvB,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACzB,KAAK,IAAI;gBACP,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACzB;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,OAAO,GAA2B,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC"}

package/dist/template/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Built-in templating engine entry point.
+ *
+ * `renderTemplate(html, data)` tokenizes → parses → renders to a finalized HTML string with all
+ * `{{ }}` / `{% %}` tokens resolved. Syntax errors (unclosed blocks, unknown tags/helpers) reject
+ * with a located `VelloraTemplateError` before any native call. No arbitrary code is executed.
+ */
+import type { RenderData } from "../types.js";
+export { HELPERS } from "./helpers.js";
+/** Apply the templating engine. Throws `VelloraTemplateError` on any syntax error. */
+export declare function renderTemplate(html: string, data?: RenderData): string;

package/dist/template/index.js

@@ -0,0 +1,11 @@
+import { render } from "./interpreter.js";
+import { parse } from "./parser.js";
+import { tokenize } from "./tokenizer.js";
+export { HELPERS } from "./helpers.js";
+/** Apply the templating engine. Throws `VelloraTemplateError` on any syntax error. */
+export function renderTemplate(html, data = {}) {
+    const tokens = tokenize(html);
+    const ast = parse(tokens);
+    return render(ast, data);
+}
+//# sourceMappingURL=index.js.map

package/dist/template/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/template/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAmB,EAAE;IAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/template/interpreter.d.ts

@@ -0,0 +1,4 @@
+import type { RenderData } from "../types.js";
+import type { Node } from "./parser.js";
+/** Render a parsed AST to finalized HTML against `data`. */
+export declare function render(nodes: Node[], data: RenderData): string;

package/dist/template/interpreter.js

@@ -0,0 +1,208 @@
+/**
+ * Interpreter: resolve dotted paths against `data`, evaluate interpolation expressions
+ * (`path | helper(args)`), conditions (`path`, `not path`, `path == literal`, `path != literal`),
+ * and render the AST to a finalized HTML string.
+ *
+ * Escape-by-default: every interpolated value (helpers included) is HTML-escaped so data cannot
+ * inject markup. Missing paths resolve to `""` and never throw. No arbitrary code is executed: only
+ * the documented token grammar is interpreted; data values are inert text.
+ */
+import { VelloraTemplateError } from "../errors.js";
+import { HELPERS } from "./helpers.js";
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+/** Resolve a dotted path against the scope chain (innermost first). Missing ⇒ `undefined`. */
+function resolvePath(path, scopes) {
+    const segments = path.split(".");
+    const head = segments[0];
+    if (head === undefined) {
+        return undefined;
+    }
+    let base;
+    let found = false;
+    for (let i = scopes.length - 1; i >= 0; i--) {
+        const scope = scopes[i];
+        if (scope && Object.hasOwn(scope, head)) {
+            base = scope[head];
+            found = true;
+            break;
+        }
+    }
+    if (!found) {
+        return undefined;
+    }
+    for (let i = 1; i < segments.length; i++) {
+        if (base === null || base === undefined) {
+            return undefined;
+        }
+        const key = segments[i];
+        if (key === undefined) {
+            return undefined;
+        }
+        // Gate EVERY segment on own-property access so a dotted path can never walk the prototype chain
+        // (`x.__proto__`, `x.constructor.name`); such reads resolve to `undefined` (coerced to "").
+        if (!Object.hasOwn(base, key)) {
+            return undefined;
+        }
+        base = base[key];
+    }
+    return base;
+}
+/** Coerce a resolved value to its string form for escaping. `null`/`undefined` ⇒ `""`. */
+function coerce(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    return String(value);
+}
+/** Parse a literal argument: a quoted string or a number. */
+function parseLiteral(raw, pos) {
+    const trimmed = raw.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    if (trimmed !== "" && !Number.isNaN(Number(trimmed))) {
+        return Number(trimmed);
+    }
+    throw new VelloraTemplateError(`Unsupported helper argument: ${raw}.`, pos);
+}
+/** Split a `helper(arg, arg)` arg list, respecting quotes. */
+function splitArgs(rawArgs) {
+    const args = [];
+    let depth = 0;
+    let quote;
+    let current = "";
+    for (const ch of rawArgs) {
+        if (quote) {
+            current += ch;
+            if (ch === quote) {
+                quote = undefined;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            current += ch;
+            continue;
+        }
+        if (ch === "(") {
+            depth++;
+            current += ch;
+            continue;
+        }
+        if (ch === ")") {
+            depth--;
+            current += ch;
+            continue;
+        }
+        if (ch === "," && depth === 0) {
+            args.push(current);
+            current = "";
+            continue;
+        }
+        current += ch;
+    }
+    if (current.trim() !== "") {
+        args.push(current);
+    }
+    return args;
+}
+/** Evaluate an interpolation expression to its (unescaped) string value. */
+function evalInterpolation(expr, scopes, pos) {
+    const pipeIdx = expr.indexOf("|");
+    if (pipeIdx === -1) {
+        return coerce(resolvePath(expr.trim(), scopes));
+    }
+    const path = expr.slice(0, pipeIdx).trim();
+    const helperPart = expr.slice(pipeIdx + 1).trim();
+    const callMatch = helperPart.match(/^([A-Za-z_$][\w$]*)\s*(?:\((.*)\))?$/s);
+    if (!callMatch) {
+        throw new VelloraTemplateError(`Malformed helper expression: ${helperPart}.`, pos);
+    }
+    const name = callMatch[1] ?? "";
+    const helper = HELPERS[name];
+    if (!helper) {
+        throw new VelloraTemplateError(`Unknown helper: ${name}.`, pos);
+    }
+    const rawArgs = callMatch[2];
+    const args = rawArgs === undefined || rawArgs.trim() === ""
+        ? []
+        : splitArgs(rawArgs).map((a) => parseLiteral(a, pos));
+    const value = resolvePath(path, scopes);
+    try {
+        return helper(value, args, pos);
+    }
+    catch (err) {
+        if (err instanceof VelloraTemplateError) {
+            throw err;
+        }
+        // A helper may throw a raw V8 error (e.g. `Intl` `RangeError` on a bad currency/digits arg).
+        // Re-wrap as a located `VelloraTemplateError` so every error leaving the engine is typed.
+        throw new VelloraTemplateError(`Helper "${name}" failed: ${err instanceof Error ? err.message : String(err)}.`, pos);
+    }
+}
+/** Evaluate a condition expression to a boolean. Supports path, `not path`, `==`/`!=` literals. */
+function evalCondition(condition, scopes, pos) {
+    const negMatch = condition.match(/^not\s+(.+)$/);
+    if (negMatch) {
+        return !truthy(resolvePath((negMatch[1] ?? "").trim(), scopes));
+    }
+    const eqMatch = condition.match(/^(.+?)\s*(==|!=)\s*(.+)$/);
+    if (eqMatch) {
+        const left = resolvePath((eqMatch[1] ?? "").trim(), scopes);
+        const right = parseLiteral(eqMatch[3] ?? "", pos);
+        const equal = left === right;
+        return eqMatch[2] === "==" ? equal : !equal;
+    }
+    return truthy(resolvePath(condition.trim(), scopes));
+}
+/** Truthiness for conditions: empty arrays are falsy (so `{% if items %}` guards rows). */
+function truthy(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    return Boolean(value);
+}
+function renderNodes(nodes, scopes) {
+    let out = "";
+    for (const node of nodes) {
+        switch (node.type) {
+            case "text":
+                out += node.value;
+                break;
+            case "interpolation":
+                out += escapeHtml(evalInterpolation(node.expr, scopes, node.pos));
+                break;
+            case "for": {
+                const collection = resolvePath(node.collection, scopes);
+                if (Array.isArray(collection)) {
+                    for (const item of collection) {
+                        out += renderNodes(node.body, [...scopes, { [node.item]: item }]);
+                    }
+                }
+                break;
+            }
+            case "if":
+                out += evalCondition(node.condition, scopes, node.pos)
+                    ? renderNodes(node.consequent, scopes)
+                    : renderNodes(node.alternate, scopes);
+                break;
+        }
+    }
+    return out;
+}
+/** Render a parsed AST to finalized HTML against `data`. */
+export function render(nodes, data) {
+    return renderNodes(nodes, [data]);
+}
+//# sourceMappingURL=interpreter.js.map

package/dist/template/interpreter.js.map

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

package/dist/template/parser.d.ts

@@ -0,0 +1,22 @@
+import type { Position, Token } from "./tokenizer.js";
+export type Node = {
+    type: "text";
+    value: string;
+} | {
+    type: "interpolation";
+    expr: string;
+    pos: Position;
+} | {
+    type: "for";
+    item: string;
+    collection: string;
+    body: Node[];
+    pos: Position;
+} | {
+    type: "if";
+    condition: string;
+    consequent: Node[];
+    alternate: Node[];
+    pos: Position;
+};
+export declare function parse(tokens: Token[]): Node[];