@arslankhan/doc-forge 0.0.0-stage → 0.1.1

package/dist/report/process.js

@@ -0,0 +1,347 @@
+import { parseBindingPath } from "../binding-path.js";
+import { resolveBinding } from "../binding.js";
+import { formatScalar } from "../invoice/format.js";
+/**
+ * Label used for null and missing group values. Both share one group.
+ * Ascending sorts place that group last. Descending sorts place it first.
+ * Group order otherwise follows the sorted records, then the original record order.
+ * Up to three group levels are supported. Each level prints its heading, then nested
+ * levels, then that level's subtotal. Inner subtotals therefore appear before outer ones.
+ *
+ * Sum, minimum, and maximum read finite numbers only. Missing and null values are skipped
+ * and are not treated as zero. A present non-number throws. Zero is included.
+ * Sums are accumulated at 8 decimal places, half away from zero. Values at or beyond
+ * 1e12 throw. Count counts records, including records whose aggregated field is missing.
+ * Count is printed as an integer even when the column format is currency.
+ */
+export const BLANK_GROUP_LABEL = "(Blank)";
+const MAX_GROUP_LEVELS = 3;
+const SUM_SCALE = 100000000n;
+const SUM_DIGITS = 8;
+export class ReportProcessingError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ReportProcessingError";
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Builds a report table view. The template element and the input data are not modified. */
+export function prepareReportTable(element, data) {
+    const columns = element.columns.filter((column) => column.visible !== false);
+    assertPaths(element);
+    const records = readCollection(data, element.collectionPath);
+    const sorted = sortRecords(records, element.sort ?? []);
+    const viewColumns = columns.map((column) => ({
+        id: column.id,
+        header: column.header,
+        align: column.align ?? defaultAlign(column),
+        weight: column.width ?? 1,
+    }));
+    const base = {
+        columns: viewColumns,
+        showHeader: element.showHeader !== false,
+        pageBreakBefore: element.pageBreakBefore === true,
+        alternateRowColor: element.alternateRowColor,
+    };
+    if (sorted.length === 0) {
+        return {
+            ...base,
+            empty: true,
+            recordCount: 0,
+            rows: [{ kind: "empty", cells: [element.emptyText?.trim() ? element.emptyText : "No records"], level: 0 }],
+        };
+    }
+    const rows = groupRows(sorted, element.groupBy ?? [], columns, data, 0);
+    if (element.showGrandTotal && columns.some((column) => column.aggregate !== undefined)) {
+        rows.push({
+            kind: "grand",
+            cells: totalCells(sorted, columns, data, element.grandTotalLabel?.trim() ? element.grandTotalLabel : "Total"),
+            level: 0,
+        });
+    }
+    return { ...base, empty: false, recordCount: sorted.length, rows };
+}
+function assertPaths(element) {
+    requirePath(element.collectionPath, "Collection path");
+    for (const column of element.columns) {
+        requirePath(column.binding.path, `Column "${column.id}" binding`);
+    }
+    for (const level of element.groupBy ?? []) {
+        requirePath(level.path, "Group path");
+    }
+    if ((element.groupBy?.length ?? 0) > MAX_GROUP_LEVELS) {
+        throw new ReportProcessingError("invalid_group", `A report table supports at most ${MAX_GROUP_LEVELS} group levels.`);
+    }
+    for (const sort of element.sort ?? []) {
+        requirePath(sort.path, "Sort path");
+        if (sort.direction !== "asc" && sort.direction !== "desc") {
+            throw new ReportProcessingError("invalid_group", "Sort direction must be asc or desc.");
+        }
+    }
+}
+function requirePath(path, label) {
+    const parsed = parseBindingPath(path);
+    if (!parsed.valid) {
+        throw new ReportProcessingError(parsed.reason === "unsafe" ? "unsafe_path" : "invalid_path", `${label} "${path}" is not a safe binding path.`);
+    }
+}
+function readCollection(data, path) {
+    const lookup = resolveBinding(data, path);
+    if (lookup.status !== "found" || lookup.value === null) {
+        return [];
+    }
+    if (!Array.isArray(lookup.value)) {
+        throw new ReportProcessingError("invalid_collection", `Collection path "${path}" must be an array.`);
+    }
+    return lookup.value.map((item, index) => {
+        if (!isPlainObject(item) || !isJsonObject(item)) {
+            throw new ReportProcessingError("invalid_record", `Record ${index + 1} at "${path}" must be a JSON object.`);
+        }
+        return { index, record: structuredClone(item) };
+    });
+}
+function sortRecords(records, sorts) {
+    const copy = records.slice();
+    copy.sort((left, right) => {
+        for (const sort of sorts) {
+            const compared = compareLookups(resolveBinding(left.record, sort.path), resolveBinding(right.record, sort.path));
+            if (compared !== 0) {
+                return sort.direction === "desc" ? -compared : compared;
+            }
+        }
+        return left.index - right.index;
+    });
+    return copy;
+}
+function compareLookups(left, right) {
+    const leftMissing = left.status !== "found" || left.value === null;
+    const rightMissing = right.status !== "found" || right.value === null;
+    if (leftMissing && rightMissing) {
+        return 0;
+    }
+    if (leftMissing) {
+        return 1;
+    }
+    if (rightMissing) {
+        return -1;
+    }
+    return compareValues(left.value, right.value);
+}
+function compareValues(left, right) {
+    if (typeof left === "number" && typeof right === "number") {
+        return left === right ? 0 : left < right ? -1 : 1;
+    }
+    if (typeof left === "string" && typeof right === "string") {
+        return left.localeCompare(right, "en", { numeric: true, sensitivity: "variant" });
+    }
+    if (typeof left === "boolean" && typeof right === "boolean") {
+        return Number(left) - Number(right);
+    }
+    const rank = (value) => typeof value === "boolean" ? 0 : typeof value === "number" ? 1 : typeof value === "string" ? 2 : 3;
+    const byRank = rank(left) - rank(right);
+    if (byRank !== 0) {
+        return byRank;
+    }
+    return JSON.stringify(left).localeCompare(JSON.stringify(right), "en");
+}
+function groupRows(records, levels, columns, root, depth) {
+    if (levels.length === 0) {
+        return records.map((record) => ({
+            kind: "record",
+            cells: columns.map((column) => cellText(column.binding, record.record, root)),
+            level: depth,
+            record: record.record,
+        }));
+    }
+    const level = levels[0];
+    if (level === undefined) {
+        return [];
+    }
+    const buckets = new Map();
+    const order = [];
+    for (const record of records) {
+        const identity = groupIdentity(record, level.path);
+        const existing = buckets.get(identity.key);
+        if (existing) {
+            existing.items.push(record);
+        }
+        else {
+            buckets.set(identity.key, { label: identity.label, items: [record] });
+            order.push(identity.key);
+        }
+    }
+    const rows = [];
+    for (const key of order) {
+        const bucket = buckets.get(key);
+        if (!bucket) {
+            continue;
+        }
+        const heading = level.label ? `${level.label}: ${bucket.label}` : bucket.label;
+        rows.push({ kind: "group", cells: [heading], level: depth });
+        rows.push(...groupRows(bucket.items, levels.slice(1), columns, root, depth + 1));
+        if (columns.some((column) => column.aggregate !== undefined)) {
+            rows.push({
+                kind: "subtotal",
+                cells: totalCells(bucket.items, columns, root, `${bucket.label} total`),
+                level: depth,
+            });
+        }
+    }
+    return rows;
+}
+function groupIdentity(record, path) {
+    const lookup = resolveBinding(record.record, path);
+    if (lookup.status !== "found" || lookup.value === null) {
+        return { key: "\u0000", label: BLANK_GROUP_LABEL };
+    }
+    const value = lookup.value;
+    if (typeof value === "object") {
+        throw new ReportProcessingError("invalid_group", `Group path "${path}" must be text, a number, or a boolean.`);
+    }
+    const label = typeof value === "number" ? plainNumber(value) : String(value);
+    return { key: `${typeof value}:${label}`, label };
+}
+function totalCells(records, columns, root, label) {
+    const cells = columns.map((column) => {
+        if (column.aggregate === undefined) {
+            return "";
+        }
+        const value = aggregateValue(records, column);
+        if (value === null) {
+            return "";
+        }
+        return formatAggregate(column, value, root);
+    });
+    const labelIndex = columns.findIndex((column) => column.aggregate === undefined);
+    if (labelIndex >= 0) {
+        cells[labelIndex] = label;
+    }
+    else if (cells.length > 0) {
+        cells[0] = `${label} ${cells[0]}`.trim();
+    }
+    return cells;
+}
+function aggregateValue(records, column) {
+    if (column.aggregate === "count") {
+        return records.length;
+    }
+    const numbers = [];
+    for (const record of records) {
+        const lookup = resolveBinding(record.record, column.binding.path);
+        if (lookup.status !== "found" || lookup.value === null) {
+            continue;
+        }
+        if (typeof lookup.value !== "number" || !Number.isFinite(lookup.value)) {
+            throw new ReportProcessingError("invalid_number", `Column "${column.id}" cannot aggregate a non-numeric value at "${column.binding.path}".`);
+        }
+        if (Math.abs(lookup.value) >= 1e12) {
+            throw new ReportProcessingError("invalid_number", `Column "${column.id}" has a value outside the supported range.`);
+        }
+        numbers.push(lookup.value);
+    }
+    if (numbers.length === 0) {
+        return null;
+    }
+    if (column.aggregate === "min") {
+        return numbers.reduce((min, value) => (value < min ? value : min));
+    }
+    if (column.aggregate === "max") {
+        return numbers.reduce((max, value) => (value > max ? value : max));
+    }
+    return fromScaled(numbers.reduce((sum, value) => sum + toScaled(value), 0n));
+}
+function formatAggregate(column, value, root) {
+    if (column.aggregate === "count") {
+        return String(value);
+    }
+    const formatted = formatScalar(value, column.binding.format, currencyCode(column.binding, root));
+    return applyAffixes(column.binding, formatted ?? plainNumber(value));
+}
+function cellText(binding, record, root) {
+    const lookup = resolveBinding(record, binding.path);
+    if (lookup.status === "found") {
+        const formatted = formatScalar(lookup.value, binding.format, currencyCode(binding, root));
+        if (formatted !== null) {
+            return applyAffixes(binding, formatted);
+        }
+    }
+    if (binding.fallback !== undefined) {
+        return applyAffixes(binding, binding.fallback);
+    }
+    return "";
+}
+function currencyCode(binding, root) {
+    const format = binding.format;
+    if (format?.style !== "currency") {
+        return undefined;
+    }
+    if (format.currency !== undefined) {
+        return format.currency;
+    }
+    for (const path of ["invoice.currency", "report.currency"]) {
+        const lookup = resolveBinding(root, path);
+        if (lookup.status === "found" && typeof lookup.value === "string") {
+            return lookup.value;
+        }
+    }
+    return undefined;
+}
+function applyAffixes(binding, value) {
+    return `${binding.prefix ?? ""}${value}${binding.suffix ?? ""}`;
+}
+function defaultAlign(column) {
+    if (column.binding.format?.style === "decimal" || column.binding.format?.style === "currency" || column.aggregate === "count") {
+        return "right";
+    }
+    return "left";
+}
+function plainNumber(value) {
+    return fromScaled(toScaled(value)).toString();
+}
+function toScaled(value) {
+    const negative = value < 0;
+    const text = Math.abs(value).toLocaleString("en-US", {
+        useGrouping: false,
+        maximumFractionDigits: SUM_DIGITS,
+    });
+    const [whole = "0", fraction = ""] = text.split(".");
+    const digits = `${fraction}${"0".repeat(SUM_DIGITS)}`.slice(0, SUM_DIGITS);
+    const minor = BigInt(whole) * SUM_SCALE + BigInt(digits);
+    return negative ? -minor : minor;
+}
+function fromScaled(value) {
+    const negative = value < 0n;
+    const absolute = negative ? -value : value;
+    const whole = absolute / SUM_SCALE;
+    const fraction = (absolute % SUM_SCALE).toString().padStart(SUM_DIGITS, "0").replace(/0+$/, "");
+    const text = fraction.length > 0 ? `${whole.toString()}.${fraction}` : whole.toString();
+    return negative ? -Number(text) : Number(text);
+}
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function isJsonObject(value) {
+    return Object.values(value).every((entry) => isJsonValue(entry));
+}
+function isJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return true;
+    }
+    if (typeof value === "number") {
+        return Number.isFinite(value);
+    }
+    if (Array.isArray(value)) {
+        return value.every((entry) => isJsonValue(entry));
+    }
+    if (isPlainObject(value)) {
+        return isJsonObject(value);
+    }
+    return false;
+}
+//# sourceMappingURL=process.js.map

package/dist/report/process.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,30 @@
+import type { DocumentElement, PageConfiguration, ReportOptions } from "./types.js";
+/** Optional invoice arithmetic settings. Ignored by generic and report templates. */
+export interface InvoiceOptions {
+    /** Decimal places for money. Default 2. Range 0 through 6. */
+    fractionDigits?: number;
+}
+/** Current template schema. Increment when the JSON format changes. */
+export declare const SCHEMA_VERSION: 1;
+export declare const SUPPORTED_SCHEMA_VERSIONS: readonly [1];
+export type SupportedSchemaVersion = (typeof SUPPORTED_SCHEMA_VERSIONS)[number];
+export declare const DOCUMENT_TYPES: readonly ["generic", "invoice", "report"];
+export type DocumentType = (typeof DOCUMENT_TYPES)[number];
+export declare function isSupportedSchemaVersion(value: number): value is SupportedSchemaVersion;
+/**
+ * Versioned template document.
+ * Persistence is left to the host application.
+ */
+export interface DocumentTemplate {
+    schemaVersion: SupportedSchemaVersion;
+    id: string;
+    name: string;
+    documentType: DocumentType;
+    page: PageConfiguration;
+    elements: DocumentElement[];
+    /** Present only when this template needs saved invoice arithmetic settings. */
+    invoice?: InvoiceOptions;
+    /** Present only when this template saves report headers, footers, or empty-state text. */
+    report?: ReportOptions;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpF,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uEAAuE;AACvE,eAAO,MAAM,cAAc,EAAG,CAAU,CAAC;AAEzC,eAAO,MAAM,yBAAyB,cAA4B,CAAC;AAEnE,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,eAAO,MAAM,cAAc,2CAA4C,CAAC;AAExE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,sBAAsB,CAEvF;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,sBAAsB,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB"}

package/dist/schema.js

@@ -0,0 +1,8 @@
+/** Current template schema. Increment when the JSON format changes. */
+export const SCHEMA_VERSION = 1;
+export const SUPPORTED_SCHEMA_VERSIONS = [SCHEMA_VERSION];
+export const DOCUMENT_TYPES = ["generic", "invoice", "report"];
+export function isSupportedSchemaVersion(value) {
+    return SUPPORTED_SCHEMA_VERSIONS.includes(value);
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAQA,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,cAAc,CAAU,CAAC;AAInE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAIxE,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAQ,yBAA+C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/serialize.d.ts

@@ -0,0 +1,13 @@
+import type { DocumentTemplate } from "./schema.js";
+/**
+ * Validates `input` and returns a detached copy.
+ * Binding paths are stored as data. Serialization does not resolve them.
+ */
+export declare function createTemplate(input: unknown): DocumentTemplate;
+/** Serializes a valid template to JSON. Invalid templates are rejected. */
+export declare function serializeTemplate(input: unknown): string;
+/** Parses JSON and returns a validated template. Does not evaluate expressions. */
+export declare function deserializeTemplate(json: string): DocumentTemplate;
+/** Deep copy with no shared nested objects or arrays. */
+export declare function cloneTemplate(template: DocumentTemplate): DocumentTemplate;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAG/D;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAiBlE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAE1E"}

package/dist/serialize.js

@@ -0,0 +1,42 @@
+import { TemplateValidationError, validateTemplate } from "./validate.js";
+/**
+ * Validates `input` and returns a detached copy.
+ * Binding paths are stored as data. Serialization does not resolve them.
+ */
+export function createTemplate(input) {
+    assertValid(input);
+    return cloneTemplate(input);
+}
+/** Serializes a valid template to JSON. Invalid templates are rejected. */
+export function serializeTemplate(input) {
+    return JSON.stringify(createTemplate(input));
+}
+/** Parses JSON and returns a validated template. Does not evaluate expressions. */
+export function deserializeTemplate(json) {
+    if (typeof json !== "string") {
+        throw new TemplateValidationError([
+            { path: "", code: "invalid_json", message: "Template JSON must be a string." },
+        ]);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new TemplateValidationError([
+            { path: "", code: "invalid_json", message: "Template JSON could not be parsed." },
+        ]);
+    }
+    return createTemplate(parsed);
+}
+/** Deep copy with no shared nested objects or arrays. */
+export function cloneTemplate(template) {
+    return structuredClone(template);
+}
+function assertValid(input) {
+    const result = validateTemplate(input);
+    if (!result.valid) {
+        throw new TemplateValidationError(result.errors);
+    }
+}
+//# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE1E;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,WAAW,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,uBAAuB,CAAC;YAChC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iCAAiC,EAAE;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,uBAAuB,CAAC;YAChC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,oCAAoC,EAAE;SAClF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,QAA0B;IACtD,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}