@arslankhan/doc-forge 0.0.0-stage → 0.1.1

package/dist/invoice/calculate.js

@@ -0,0 +1,270 @@
+/**
+ * Invoice arithmetic in minor units.
+ * This is a configurable policy, not a claim of tax compliance for any country.
+ *
+ * Order of operations:
+ * 1. Line gross = quantity × rate, rounded to `fractionDigits`.
+ * 2. Line discount, when the item has one, is applied to that gross amount.
+ * 3. Subtotal is the sum of line amounts after line discounts.
+ * 4. The invoice discount is applied once to that subtotal.
+ * 5. The invoice discount is shared across lines in proportion to their net amounts.
+ * 6. Tax is calculated on each line's discounted taxable amount.
+ *    An item tax rate wins. Otherwise `invoice.taxRate` is used. Otherwise tax is 0.
+ * 7. Grand total = subtotal − invoice discount + tax.
+ *
+ * Rounding is half away from zero at each monetary step.
+ * Quantity totals use 6 decimal places. Values at or above 1e12 are rejected.
+ * Negative quantities, rates, discounts, and tax rates are rejected.
+ * Missing or non-numeric quantities and rates throw; they are not treated as zero.
+ */
+export class InvoiceCalculationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "InvoiceCalculationError";
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+const QUANTITY_DIGITS = 6;
+const AMOUNT_LIMIT = 1_000_000_000_000;
+export function calculateInvoice(data, policy = {}) {
+    const digits = fractionDigits(policy.fractionDigits);
+    if (!isRecord(data)) {
+        throw new InvoiceCalculationError("invalid_data", "Invoice data must be a JSON object.");
+    }
+    const invoice = data.invoice === undefined ? {} : data.invoice;
+    if (!isRecord(invoice)) {
+        throw new InvoiceCalculationError("invalid_invoice", "invoice must be an object when it is present.");
+    }
+    const defaultTax = optionalPercent(invoice.taxRate, "invoice.taxRate");
+    const items = readItems(invoice.items);
+    const lines = items.map((item, index) => calculateLine(item, index, digits, defaultTax));
+    const subtotalMinor = lines.reduce((sum, line) => sum + line.netMinor, 0n);
+    const discountMinor = invoiceDiscount(invoice.discount, subtotalMinor, digits);
+    const shares = allocate(discountMinor, lines.map((line) => line.netMinor));
+    const calculated = lines.map((line, index) => {
+        const share = shares[index] ?? 0n;
+        const taxableMinor = line.netMinor - share;
+        const taxMinor = percentOf(taxableMinor, line.taxRate);
+        return toLineResult(line, share, taxableMinor, taxMinor, digits);
+    });
+    const taxMinor = calculated.reduce((sum, line) => sum + toMinor(line.taxAmount, digits), 0n);
+    const taxableMinor = subtotalMinor - discountMinor;
+    const grandMinor = taxableMinor + taxMinor;
+    return {
+        fractionDigits: digits,
+        lines: calculated,
+        totals: {
+            subtotal: minorToNumber(subtotalMinor, digits),
+            discountAmount: minorToNumber(discountMinor, digits),
+            taxableAmount: minorToNumber(taxableMinor, digits),
+            taxTotal: minorToNumber(taxMinor, digits),
+            grandTotal: minorToNumber(grandMinor, digits),
+            totalQuantity: minorToNumber(lines.reduce((sum, line) => sum + toMinor(line.quantity, QUANTITY_DIGITS), 0n), QUANTITY_DIGITS),
+        },
+    };
+}
+function calculateLine(item, index, digits, defaultTax) {
+    const where = `invoice.items[${index}]`;
+    const description = readText(item.description, `${where}.description`);
+    const unit = readText(item.unit, `${where}.unit`);
+    const quantity = readAmount(item.quantity, `${where}.quantity`);
+    const rate = readAmount(item.rate, `${where}.rate`);
+    const taxRate = item.taxRate === undefined || item.taxRate === null ? defaultTax : optionalPercent(item.taxRate, `${where}.taxRate`);
+    const grossMinor = multiplyRounded(quantity, rate, digits);
+    const discountMinor = lineDiscount(item.discount, grossMinor, digits, where);
+    if (discountMinor > grossMinor) {
+        throw new InvoiceCalculationError("discount_exceeds_amount", `${where} discount is greater than the line amount.`);
+    }
+    return {
+        description,
+        quantity,
+        unit,
+        rate,
+        taxRate,
+        grossMinor,
+        discountMinor,
+        netMinor: grossMinor - discountMinor,
+    };
+}
+function toLineResult(line, share, taxableMinor, taxMinor, digits) {
+    const netAmount = minorToNumber(line.netMinor, digits);
+    return {
+        description: line.description,
+        quantity: line.quantity,
+        unit: line.unit,
+        rate: line.rate,
+        grossAmount: minorToNumber(line.grossMinor, digits),
+        discountAmount: minorToNumber(line.discountMinor, digits),
+        netAmount,
+        lineTotal: netAmount,
+        invoiceDiscountShare: minorToNumber(share, digits),
+        taxableAmount: minorToNumber(taxableMinor, digits),
+        taxRate: line.taxRate,
+        taxAmount: minorToNumber(taxMinor, digits),
+    };
+}
+function readItems(value) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        throw new InvoiceCalculationError("invalid_items", "invoice.items must be an array when it is present.");
+    }
+    return value.map((item, index) => {
+        if (!isRecord(item)) {
+            throw new InvoiceCalculationError("invalid_item", `invoice.items[${index}] must be an object.`);
+        }
+        return item;
+    });
+}
+function invoiceDiscount(value, subtotalMinor, digits) {
+    if (value === undefined || value === null) {
+        return 0n;
+    }
+    const discount = readDiscount(value, "invoice.discount");
+    const amount = discountAmount(discount, subtotalMinor, digits);
+    if (amount > subtotalMinor) {
+        throw new InvoiceCalculationError("discount_exceeds_amount", "Invoice discount is greater than the subtotal.");
+    }
+    return amount;
+}
+function lineDiscount(value, grossMinor, digits, where) {
+    if (value === undefined || value === null) {
+        return 0n;
+    }
+    return discountAmount(readDiscount(value, `${where}.discount`), grossMinor, digits);
+}
+function readDiscount(value, where) {
+    if (!isRecord(value) || (value.type !== "percentage" && value.type !== "fixed")) {
+        throw new InvoiceCalculationError("invalid_discount", `${where} must be a percentage or fixed discount.`);
+    }
+    const amount = readAmount(value.value, `${where}.value`);
+    if (value.type === "percentage" && amount > 100) {
+        throw new InvoiceCalculationError("invalid_discount", `${where} percentage must be from 0 to 100.`);
+    }
+    return { type: value.type, value: amount };
+}
+function discountAmount(discount, baseMinor, digits) {
+    if (discount.type === "percentage") {
+        return percentOf(baseMinor, discount.value);
+    }
+    return toMinor(discount.value, digits);
+}
+function optionalPercent(value, where) {
+    if (value === undefined || value === null) {
+        return 0;
+    }
+    const rate = readAmount(value, where);
+    if (rate > 100) {
+        throw new InvoiceCalculationError("invalid_tax_rate", `${where} must be from 0 to 100.`);
+    }
+    return rate;
+}
+function readText(value, where) {
+    if (value === undefined || value === null) {
+        return "";
+    }
+    if (typeof value !== "string") {
+        throw new InvoiceCalculationError("invalid_text", `${where} must be a string.`);
+    }
+    return value;
+}
+function readAmount(value, where) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new InvoiceCalculationError("invalid_number", `${where} must be a finite number.`);
+    }
+    if (Object.is(value, -0)) {
+        return 0;
+    }
+    if (value < 0) {
+        throw new InvoiceCalculationError("negative_value", `${where} must be greater than or equal to 0.`);
+    }
+    if (value >= AMOUNT_LIMIT) {
+        throw new InvoiceCalculationError("amount_out_of_range", `${where} must be less than ${AMOUNT_LIMIT}.`);
+    }
+    return value;
+}
+function fractionDigits(value) {
+    if (value === undefined) {
+        return 2;
+    }
+    if (!Number.isInteger(value) || value < 0 || value > 6) {
+        throw new InvoiceCalculationError("invalid_policy", "fractionDigits must be an integer from 0 to 6.");
+    }
+    return value;
+}
+function multiplyRounded(left, right, digits) {
+    const scale = QUANTITY_DIGITS;
+    return rescale(toMinor(left, scale) * toMinor(right, scale), scale * 2, digits);
+}
+function percentOf(baseMinor, percent) {
+    const percentScale = QUANTITY_DIGITS;
+    const product = baseMinor * toMinor(percent, percentScale);
+    return divRound(product, 100n * 10n ** BigInt(percentScale));
+}
+function allocate(total, parts) {
+    if (parts.length === 0 || total === 0n) {
+        return parts.map(() => 0n);
+    }
+    const sum = parts.reduce((acc, part) => acc + part, 0n);
+    if (sum === 0n) {
+        return parts.map(() => 0n);
+    }
+    let remaining = total;
+    return parts.map((part, index) => {
+        if (index === parts.length - 1) {
+            return remaining;
+        }
+        const share = divRound(total * part, sum);
+        remaining -= share;
+        return share;
+    });
+}
+function toMinor(value, digits) {
+    const negative = value < 0;
+    const formatted = new Intl.NumberFormat("en-US", {
+        useGrouping: false,
+        maximumFractionDigits: 20,
+        minimumFractionDigits: 0,
+    }).format(Math.abs(value));
+    const [wholeText, fractionText = ""] = formatted.split(".");
+    const head = fractionText.slice(0, digits).padEnd(digits, "0");
+    const roundDigit = fractionText[digits] ?? "0";
+    let minor = BigInt(wholeText || "0") * 10n ** BigInt(digits) + BigInt(head || "0");
+    if (roundDigit >= "5") {
+        minor += 1n;
+    }
+    return negative ? -minor : minor;
+}
+function rescale(value, fromDigits, toDigits) {
+    if (fromDigits === toDigits) {
+        return value;
+    }
+    if (fromDigits > toDigits) {
+        return divRound(value, 10n ** BigInt(fromDigits - toDigits));
+    }
+    return value * 10n ** BigInt(toDigits - fromDigits);
+}
+function divRound(value, divisor) {
+    const negative = value < 0n;
+    const abs = negative ? -value : value;
+    const quotient = abs / divisor;
+    const remainder = abs % divisor;
+    const rounded = remainder * 2n >= divisor ? quotient + 1n : quotient;
+    return negative ? -rounded : rounded;
+}
+function minorToNumber(minor, digits) {
+    const negative = minor < 0n;
+    const abs = negative ? -minor : minor;
+    const scale = 10n ** BigInt(digits);
+    const whole = abs / scale;
+    const fraction = (abs % scale).toString().padStart(digits, "0");
+    const text = digits === 0 ? `${whole}` : `${whole}.${fraction}`;
+    return Number(negative ? `-${text}` : text);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=calculate.js.map

package/dist/invoice/calculate.js.map

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

package/dist/invoice/context.d.ts

@@ -0,0 +1,15 @@
+import type { JsonValue } from "../binding.js";
+import { type InvoiceCalculationPolicy } from "./calculate.js";
+export type { InvoiceCalculationPolicy } from "./calculate.js";
+/**
+ * Builds a rendering copy of invoice JSON and adds calculated fields.
+ * The input object is not modified. User fields are copied, then calculated
+ * names are written on the copy: `invoice.subtotal`, `invoice.discountAmount`,
+ * `invoice.taxableAmount`, `invoice.taxTotal`, `invoice.grandTotal`,
+ * `invoice.totalQuantity`, and each item's `lineTotal`, `grossAmount`,
+ * `discountAmount`, `netAmount`, `taxAmount`, and `taxableAmount`.
+ */
+export declare function prepareInvoiceContext(data: unknown, policy?: InvoiceCalculationPolicy): {
+    [key: string]: JsonValue;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/invoice/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/invoice/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAGL,KAAK,wBAAwB,EAE9B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAiBpH"}

package/dist/invoice/context.js

@@ -0,0 +1,79 @@
+import { calculateInvoice, InvoiceCalculationError, } from "./calculate.js";
+/**
+ * Builds a rendering copy of invoice JSON and adds calculated fields.
+ * The input object is not modified. User fields are copied, then calculated
+ * names are written on the copy: `invoice.subtotal`, `invoice.discountAmount`,
+ * `invoice.taxableAmount`, `invoice.taxTotal`, `invoice.grandTotal`,
+ * `invoice.totalQuantity`, and each item's `lineTotal`, `grossAmount`,
+ * `discountAmount`, `netAmount`, `taxAmount`, and `taxableAmount`.
+ */
+export function prepareInvoiceContext(data, policy) {
+    if (!isJsonObject(data)) {
+        throw new InvoiceCalculationError("invalid_data", "Invoice data must be a JSON object.");
+    }
+    const calculation = calculateInvoice(data, policy);
+    const clone = structuredClone(data);
+    const invoice = isRecord(clone.invoice) ? { ...clone.invoice } : {};
+    const sourceItems = Array.isArray(invoice.items) ? invoice.items : [];
+    invoice.items = calculation.lines.map((line, index) => enrichItem(sourceItems[index], line));
+    invoice.subtotal = calculation.totals.subtotal;
+    invoice.discountAmount = calculation.totals.discountAmount;
+    invoice.taxableAmount = calculation.totals.taxableAmount;
+    invoice.taxTotal = calculation.totals.taxTotal;
+    invoice.grandTotal = calculation.totals.grandTotal;
+    invoice.totalQuantity = calculation.totals.totalQuantity;
+    clone.invoice = invoice;
+    return clone;
+}
+function enrichItem(source, line) {
+    const base = isRecord(source) ? { ...source } : {};
+    return {
+        ...jsonRecord(base),
+        description: line.description,
+        quantity: line.quantity,
+        unit: line.unit,
+        rate: line.rate,
+        grossAmount: line.grossAmount,
+        discountAmount: line.discountAmount,
+        netAmount: line.netAmount,
+        lineTotal: line.lineTotal,
+        taxRate: line.taxRate,
+        taxAmount: line.taxAmount,
+        taxableAmount: line.taxableAmount,
+    };
+}
+function jsonRecord(value) {
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (isJsonValue(entry)) {
+            result[key] = entry;
+        }
+    }
+    return result;
+}
+function isJsonObject(value) {
+    return isRecord(value) && isJsonValue(value);
+}
+function isRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+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 (isRecord(value)) {
+        return Object.values(value).every((entry) => isJsonValue(entry));
+    }
+    return false;
+}
+//# sourceMappingURL=context.js.map

package/dist/invoice/context.js.map

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

package/dist/invoice/format.d.ts

@@ -0,0 +1,10 @@
+import type { JsonValue } from "../binding.js";
+import type { ValueFormat } from "../types.js";
+/**
+ * Formats a calculated or bound scalar for display.
+ * The numeric calculation result is not modified. Invalid locales fall back to `en`.
+ * A currency style without a 3-letter code is shown as a decimal number.
+ * A date must be `YYYY-MM-DD`. Anything else returns null so the caller can use a fallback.
+ */
+export declare function formatScalar(value: JsonValue, format: ValueFormat | undefined, currencyCode?: string): string | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/invoice/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/invoice/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4BpH"}

package/dist/invoice/format.js

@@ -0,0 +1,95 @@
+/**
+ * Formats a calculated or bound scalar for display.
+ * The numeric calculation result is not modified. Invalid locales fall back to `en`.
+ * A currency style without a 3-letter code is shown as a decimal number.
+ * A date must be `YYYY-MM-DD`. Anything else returns null so the caller can use a fallback.
+ */
+export function formatScalar(value, format, currencyCode) {
+    if (format === undefined) {
+        return plainScalar(value);
+    }
+    if (format.style === "date") {
+        return formatDate(value, format);
+    }
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return null;
+    }
+    const minimum = format.minimumFractionDigits;
+    const maximum = format.maximumFractionDigits ?? minimum;
+    const options = {
+        useGrouping: true,
+        minimumFractionDigits: minimum,
+        maximumFractionDigits: maximum ?? 20,
+    };
+    if (format.style === "percent") {
+        return formatNumber(value, format.locale, { ...options, style: "percent" });
+    }
+    if (format.style === "currency") {
+        const currency = currencyCode && /^[A-Za-z]{3}$/.test(currencyCode) ? currencyCode.toUpperCase() : undefined;
+        if (!currency) {
+            return formatNumber(value, format.locale, options);
+        }
+        return formatNumber(value, format.locale, { ...options, style: "currency", currency });
+    }
+    return formatNumber(value, format.locale, options);
+}
+function plainScalar(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? String(value) : null;
+    }
+    if (typeof value === "boolean") {
+        return value ? "true" : "false";
+    }
+    return null;
+}
+function formatDate(value, format) {
+    if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return null;
+    }
+    const [yearText, monthText, dayText] = value.split("-");
+    const year = Number(yearText);
+    const month = Number(monthText);
+    const day = Number(dayText);
+    const utc = new Date(Date.UTC(year, month - 1, day));
+    if (utc.getUTCFullYear() !== year || utc.getUTCMonth() !== month - 1 || utc.getUTCDate() !== day) {
+        return null;
+    }
+    if (format.dateStyle === undefined || format.dateStyle === "iso") {
+        return value;
+    }
+    try {
+        return new Intl.DateTimeFormat(normalizeLocale(format.locale), {
+            dateStyle: format.dateStyle,
+            timeZone: "UTC",
+        }).format(utc);
+    }
+    catch {
+        return new Intl.DateTimeFormat("en", { dateStyle: format.dateStyle, timeZone: "UTC" }).format(utc);
+    }
+}
+function formatNumber(value, locale, options) {
+    try {
+        return new Intl.NumberFormat(normalizeLocale(locale), options).format(value);
+    }
+    catch {
+        const decimal = { ...options };
+        delete decimal.currency;
+        decimal.style = "decimal";
+        return new Intl.NumberFormat("en", decimal).format(value);
+    }
+}
+function normalizeLocale(locale) {
+    if (locale === undefined || locale.trim().length === 0) {
+        return "en";
+    }
+    try {
+        return new Intl.Locale(locale).toString();
+    }
+    catch {
+        return "en";
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/invoice/format.js.map

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

package/dist/license/capabilities.d.ts

@@ -0,0 +1,17 @@
+import type { DocumentTemplate } from "../schema.js";
+/**
+ * What a template uses. This is not a license decision and does not block rendering.
+ */
+export interface DocumentCapabilities {
+    documentType: DocumentTemplate["documentType"];
+    elementTypes: readonly string[];
+    elementCount: number;
+    usesInvoiceCalculation: boolean;
+    usesReportGrouping: boolean;
+    usesReportAggregates: boolean;
+    usesReportSort: boolean;
+    usesAdvancedTableStyle: boolean;
+    usesElementStyle: boolean;
+}
+export declare function inspectDocumentCapabilities(template: DocumentTemplate): DocumentCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/license/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/license/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC/C,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,oBAAoB,CA4C5F"}

package/dist/license/capabilities.js

@@ -0,0 +1,46 @@
+export function inspectDocumentCapabilities(template) {
+    const elements = Array.isArray(template.elements) ? template.elements : [];
+    const elementTypes = [...new Set(elements.map((element) => element.type))];
+    let usesReportGrouping = false;
+    let usesReportAggregates = false;
+    let usesReportSort = false;
+    let usesAdvancedTableStyle = false;
+    let usesElementStyle = false;
+    for (const element of elements) {
+        if (element.style) {
+            usesElementStyle = true;
+        }
+        if (element.type === "reportTable") {
+            usesReportGrouping = usesReportGrouping || (element.groupBy?.length ?? 0) > 0;
+            usesReportSort = usesReportSort || (element.sort?.length ?? 0) > 0;
+            usesReportAggregates = usesReportAggregates || element.columns.some((column) => column.aggregate !== undefined);
+            usesAdvancedTableStyle =
+                usesAdvancedTableStyle ||
+                    element.headerStyle !== undefined ||
+                    element.bodyStyle !== undefined ||
+                    element.groupStyle !== undefined ||
+                    element.subtotalStyle !== undefined ||
+                    element.grandTotalStyle !== undefined ||
+                    (element.rowRules?.length ?? 0) > 0 ||
+                    element.alternateRowColor !== undefined ||
+                    element.oddRowColor !== undefined ||
+                    element.evenRowColor !== undefined ||
+                    element.columns.some((column) => column.style !== undefined || column.headerStyle !== undefined);
+        }
+        if (element.type === "items" && element.headerStyle !== undefined) {
+            usesAdvancedTableStyle = true;
+        }
+    }
+    return {
+        documentType: template.documentType,
+        elementTypes,
+        elementCount: elements.length,
+        usesInvoiceCalculation: template.documentType === "invoice",
+        usesReportGrouping,
+        usesReportAggregates,
+        usesReportSort,
+        usesAdvancedTableStyle,
+        usesElementStyle,
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/license/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/license/capabilities.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,2BAA2B,CAAC,QAA0B;IACpE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,oBAAoB,GAAG,KAAK,CAAC;IACjC,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,sBAAsB,GAAG,KAAK,CAAC;IACnC,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACnC,kBAAkB,GAAG,kBAAkB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC9E,cAAc,GAAG,cAAc,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACnE,oBAAoB,GAAG,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YAChH,sBAAsB;gBACpB,sBAAsB;oBACtB,OAAO,CAAC,WAAW,KAAK,SAAS;oBACjC,OAAO,CAAC,SAAS,KAAK,SAAS;oBAC/B,OAAO,CAAC,UAAU,KAAK,SAAS;oBAChC,OAAO,CAAC,aAAa,KAAK,SAAS;oBACnC,OAAO,CAAC,eAAe,KAAK,SAAS;oBACrC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;oBACnC,OAAO,CAAC,iBAAiB,KAAK,SAAS;oBACvC,OAAO,CAAC,WAAW,KAAK,SAAS;oBACjC,OAAO,CAAC,YAAY,KAAK,SAAS;oBAClC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC;QACrG,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAClE,sBAAsB,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,YAAY;QACZ,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,sBAAsB,EAAE,QAAQ,CAAC,YAAY,KAAK,SAAS;QAC3D,kBAAkB;QAClB,oBAAoB;QACpB,cAAc;QACd,sBAAsB;QACtB,gBAAgB;KACjB,CAAC;AACJ,CAAC"}