@invompt/invoml 1.0.0-alpha.4

package/dist/src/calculator.js

@@ -0,0 +1,164 @@
+import { InternalDecimal, roundHalfUp, getCurrencyDecimals } from './rounding.js';
+import { resolveTaxConfig, resolveCategory } from './tax.js';
+import { parseDiscount, applyDiscount, allocateProportionally } from './discounts.js';
+/** Compute all totals for an InvoML document using arbitrary-precision decimal arithmetic. Returns subtotal, per-category tax breakdowns, discount details, and amount due. */
+export function calculate(doc) {
+    const taxConfig = resolveTaxConfig(doc.meta.tax);
+    const dp = getCurrencyDecimals(doc.meta.currency);
+    const round = (v) => roundHalfUp(v, dp);
+    // Work on shallow copies of items to avoid mutating the caller's input
+    const items = doc.items.map(i => ({ ...i }));
+    // ── STEP 1: Line Calculations ──
+    for (const item of items) {
+        // Use Decimal for multiplication to avoid native float precision loss
+        const gross = round(new InternalDecimal(item.quantity.toString()).times(item.unitPrice.toString()).toNumber());
+        const lineDiscount = item.discount ? applyDiscount(parseDiscount(item.discount), gross, dp) : 0;
+        item.amount = round(new InternalDecimal(gross.toString()).minus(lineDiscount.toString()).toNumber());
+        if (taxConfig && !taxConfig.compound) {
+            const cat = resolveCategory(item, taxConfig);
+            if (cat && !cat.exempt && !cat.reverseCharge) {
+                if (taxConfig.inclusive) {
+                    // Use Decimal for the inclusive back-out division
+                    const divisor = new InternalDecimal(1).plus(new InternalDecimal(cat.rate.toString()).dividedBy(100));
+                    const net = round(new InternalDecimal(item.amount.toString()).dividedBy(divisor).toNumber());
+                    item.taxAmount = round(new InternalDecimal(item.amount.toString()).minus(net.toString()).toNumber());
+                }
+                else {
+                    // Use Decimal for exclusive tax multiplication
+                    item.taxAmount = round(new InternalDecimal(item.amount.toString()).times(new InternalDecimal(cat.rate.toString()).dividedBy(100)).toNumber());
+                }
+            }
+            else {
+                item.taxAmount = 0;
+            }
+        }
+        else {
+            item.taxAmount = 0;
+        }
+    }
+    // ── STEP 2: Subtotal ──
+    let subtotal = round(items.reduce((sum, i) => sum.plus(i.amount ?? 0), new InternalDecimal(0)).toNumber());
+    // ── STEP 3: Invoice-Level Discounts (cascading) ──
+    let running = subtotal;
+    const discountDetails = [];
+    for (const discount of doc.discounts ?? []) {
+        const amount = applyDiscount(discount, running, dp);
+        discountDetails.push({ label: discount.label, amount });
+        running = round(new InternalDecimal(running.toString()).minus(amount.toString()).toNumber());
+    }
+    const afterDiscounts = running;
+    const discountTotal = round(new InternalDecimal(subtotal.toString()).minus(afterDiscounts.toString()).toNumber());
+    // ── STEP 4: Tax Calculation ──
+    const taxDetails = [];
+    let taxTotalD = new InternalDecimal(0);
+    let withholdingTotalD = new InternalDecimal(0);
+    if (taxConfig === null) {
+        // No tax — nothing to do
+    }
+    else if (taxConfig.compound) {
+        // Compound: all categories apply to full base, taxCategory is ignored
+        const base = afterDiscounts;
+        for (const cat of taxConfig.categories) {
+            // Use Decimal for the compound tax multiplication
+            const catTax = round(new InternalDecimal(base.toString()).times(new InternalDecimal(cat.rate.toString()).dividedBy(100)).toNumber());
+            taxDetails.push({ category: cat.id, label: cat.label, rate: cat.rate, base, amount: catTax, inclusive: false });
+            if (cat.withholding) {
+                withholdingTotalD = withholdingTotalD.plus(catTax);
+            }
+            else if (!cat.reverseCharge) {
+                taxTotalD = taxTotalD.plus(catTax);
+            }
+        }
+    }
+    else if (taxConfig.inclusive) {
+        // Inclusive: separate regular and withholding categories — same split as exclusive branch
+        const regularCats = taxConfig.categories.filter(c => !c.withholding);
+        const withholdingCats = taxConfig.categories.filter(c => c.withholding);
+        const catAmounts = regularCats.map(cat => {
+            const linesInCat = items.filter(i => resolveCategory(i, taxConfig).id === cat.id);
+            return round(linesInCat.reduce((s, i) => s.plus(i.amount ?? 0), new InternalDecimal(0)).toNumber());
+        });
+        const catDiscounts = allocateProportionally(catAmounts, discountTotal, subtotal, round);
+        for (let idx = 0; idx < regularCats.length; idx++) {
+            const cat = regularCats[idx];
+            const catNetAfterDiscount = round(new InternalDecimal(catAmounts[idx].toString()).minus(catDiscounts[idx].toString()).toNumber());
+            let catTax;
+            let catNetBeforeTax;
+            if (cat.exempt) {
+                // Exempt categories have zero tax regardless of rate
+                catTax = 0;
+                catNetBeforeTax = catNetAfterDiscount;
+            }
+            else {
+                // Use Decimal for the inclusive back-out division
+                const divisor = new InternalDecimal(1).plus(new InternalDecimal(cat.rate.toString()).dividedBy(100));
+                catNetBeforeTax = round(new InternalDecimal(catNetAfterDiscount.toString()).dividedBy(divisor).toNumber());
+                catTax = round(new InternalDecimal(catNetAfterDiscount.toString()).minus(catNetBeforeTax.toString()).toNumber());
+            }
+            taxDetails.push({ category: cat.id, label: cat.label, rate: cat.rate, base: catNetBeforeTax, amount: catTax, inclusive: true });
+            if (!cat.reverseCharge) {
+                taxTotalD = taxTotalD.plus(catTax);
+            }
+        }
+        // Withholding categories in inclusive mode: apply to afterDiscounts base (same as exclusive)
+        for (const cat of withholdingCats) {
+            const base = afterDiscounts;
+            const catTax = round(new InternalDecimal(base.toString()).times(new InternalDecimal(cat.rate.toString()).dividedBy(100)).toNumber());
+            taxDetails.push({ category: cat.id, label: cat.label, rate: cat.rate, base, amount: catTax, inclusive: false });
+            withholdingTotalD = withholdingTotalD.plus(catTax);
+        }
+    }
+    else {
+        // Standard / multi-rate
+        // Separate withholding categories (apply to full base) from regular categories
+        const regularCats = taxConfig.categories.filter(c => !c.withholding);
+        const withholdingCats = taxConfig.categories.filter(c => c.withholding);
+        const regularAmounts = regularCats.map(cat => {
+            const linesInCat = items.filter(i => resolveCategory(i, taxConfig).id === cat.id);
+            return round(linesInCat.reduce((s, i) => s.plus(i.amount ?? 0), new InternalDecimal(0)).toNumber());
+        });
+        const regularDiscounts = allocateProportionally(regularAmounts, discountTotal, subtotal, round);
+        for (let idx = 0; idx < regularCats.length; idx++) {
+            const cat = regularCats[idx];
+            const base = round(new InternalDecimal(regularAmounts[idx].toString()).minus(regularDiscounts[idx].toString()).toNumber());
+            // Use Decimal for the exclusive tax multiplication
+            const catTax = cat.exempt ? 0 : round(new InternalDecimal(base.toString()).times(new InternalDecimal(cat.rate.toString()).dividedBy(100)).toNumber());
+            taxDetails.push({ category: cat.id, label: cat.label, rate: cat.rate, base, amount: catTax, inclusive: false });
+            if (!cat.reverseCharge) {
+                taxTotalD = taxTotalD.plus(catTax);
+            }
+        }
+        // Withholding categories apply to afterDiscounts (full taxable base)
+        for (const cat of withholdingCats) {
+            const base = afterDiscounts;
+            const catTax = round(new InternalDecimal(base.toString()).times(new InternalDecimal(cat.rate.toString()).dividedBy(100)).toNumber());
+            taxDetails.push({ category: cat.id, label: cat.label, rate: cat.rate, base, amount: catTax, inclusive: false });
+            withholdingTotalD = withholdingTotalD.plus(catTax);
+        }
+    }
+    const taxTotal = round(taxTotalD.toNumber());
+    const withholdingTotal = round(withholdingTotalD.toNumber());
+    // ── STEP 5: Grand Total ──
+    let total;
+    if (taxConfig?.inclusive) {
+        total = afterDiscounts;
+    }
+    else {
+        // Use Decimal for the final total addition to avoid float precision loss
+        total = round(new InternalDecimal(afterDiscounts.toString()).plus(taxTotal.toString()).minus(withholdingTotal.toString()).toNumber());
+    }
+    // ── STEP 6: Amount Due ──
+    const prepaid = doc.totals?.prepaidAmount ?? 0;
+    const amountDue = round(new InternalDecimal(total.toString()).minus(prepaid.toString()).toNumber());
+    return {
+        subtotal,
+        discountDetails: discountDetails.length > 0 ? discountDetails : undefined,
+        afterDiscounts,
+        taxDetails: taxDetails.length > 0 ? taxDetails : undefined,
+        taxTotal,
+        withholdingTotal,
+        total,
+        prepaidAmount: prepaid,
+        amountDue,
+    };
+}

package/dist/src/discounts.d.ts

@@ -0,0 +1,6 @@
+import type { InvoMLDiscount } from './types.js';
+export declare function parseDiscount(discount: string | InvoMLDiscount): InvoMLDiscount;
+export declare function applyDiscount(discount: InvoMLDiscount, base: number, decimals?: number): number;
+/** Allocate a total discount proportionally across categories based on their amounts.
+ *  The last category absorbs any rounding residual (tie-breaking). */
+export declare function allocateProportionally(categoryAmounts: number[], totalDiscount: number, subtotal: number, round: (v: number) => number): number[];

package/dist/src/discounts.js

@@ -0,0 +1,46 @@
+import { InternalDecimal, roundHalfUp } from './rounding.js';
+const DISCOUNT_PATTERN = /^(\d+(\.\d+)?%|\d+(\.\d+)?)$/;
+export function parseDiscount(discount) {
+    if (typeof discount === 'object')
+        return discount;
+    if (!DISCOUNT_PATTERN.test(discount)) {
+        throw new Error(`Invalid discount format: "${discount}"`);
+    }
+    if (discount.endsWith('%')) {
+        return { type: 'percentage', value: parseFloat(discount.slice(0, -1)) };
+    }
+    return { type: 'fixed', value: parseFloat(discount) };
+}
+export function applyDiscount(discount, base, decimals = 2) {
+    if (discount.type === 'percentage') {
+        // Use Decimal for multiplication to avoid native float precision loss
+        const amount = new InternalDecimal(base.toString())
+            .times(new InternalDecimal(discount.value.toString()).dividedBy(100));
+        return roundHalfUp(amount.toNumber(), decimals);
+    }
+    const absBase = Math.abs(base);
+    const amount = roundHalfUp(Math.min(discount.value, absBase), decimals);
+    return base < 0 ? -amount : amount;
+}
+/** Allocate a total discount proportionally across categories based on their amounts.
+ *  The last category absorbs any rounding residual (tie-breaking). */
+export function allocateProportionally(categoryAmounts, totalDiscount, subtotal, round) {
+    const result = [];
+    // Use Decimal accumulator to avoid float precision loss when summing allocated amounts
+    let allocated = new InternalDecimal(0);
+    for (let idx = 0; idx < categoryAmounts.length; idx++) {
+        if (idx === categoryAmounts.length - 1) {
+            result.push(round(new InternalDecimal(totalDiscount.toString()).minus(allocated).toNumber()));
+        }
+        else {
+            // Keep proportion as Decimal through the multiplication to avoid float round-trip
+            const proportion = subtotal !== 0
+                ? new InternalDecimal(categoryAmounts[idx].toString()).dividedBy(subtotal)
+                : new InternalDecimal(0);
+            const catDiscount = round(new InternalDecimal(totalDiscount.toString()).times(proportion).toNumber());
+            result.push(catDiscount);
+            allocated = allocated.plus(catDiscount);
+        }
+    }
+    return result;
+}

package/dist/src/format.d.ts

@@ -0,0 +1,3 @@
+/** US-style number formatter: commas for thousands, period for decimal, always dp places.
+ *  Produces "7,200.00" for dp=2, "7,200" for dp=0, "7,200.000" for dp=3. */
+export declare function fmtNum(n: number, dp: number): string;

package/dist/src/format.js

@@ -0,0 +1,14 @@
+/** US-style number formatter: commas for thousands, period for decimal, always dp places.
+ *  Produces "7,200.00" for dp=2, "7,200" for dp=0, "7,200.000" for dp=3. */
+export function fmtNum(n, dp) {
+    if (!isFinite(n))
+        throw new Error(`Cannot format non-finite number: ${n}`);
+    let fixed = n.toFixed(dp);
+    // Normalize negative zero: -0.00 → 0.00
+    if (parseFloat(fixed) === 0)
+        fixed = (0).toFixed(dp);
+    if (dp === 0)
+        return fixed.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    const [intPart, fracPart] = fixed.split('.');
+    return `${intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',')}.${fracPart}`;
+}

package/dist/src/html-css.d.ts

@@ -0,0 +1,4 @@
+/** Base CSS for all InvoML HTML output. Applied to every document regardless of template. */
+export declare const BASE_CSS = "\n/* InvoML base styles */\n*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n\nbody { background: #f5f5f5; }\n\n.invoml-container {\n  --invoml-color-accent: #2563eb;\n  --invoml-color-text: #1a1a1a;\n  --invoml-color-muted: #666666;\n  --invoml-color-border: #e0e0e0;\n  --invoml-color-background: #ffffff;\n  --invoml-font-heading: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;\n  --invoml-font-body: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;\n  --invoml-padding-y: 10mm;\n  --invoml-padding-x: 12mm;\n  --invoml-section-gap: 18px;\n  --invoml-table-row-padding: 10px;\n  --invoml-parties-gap: 28px;\n  --invoml-payment-margin-top: 28px;\n  --invoml-meta-gap: 18px;\n  --invoml-totals-margin: 18px;\n  --invoml-line-height: 1.5;\n  --invoml-paragraph-spacing: 12px;\n\n  width: 210mm;\n  margin: 0 auto;\n  padding: var(--invoml-padding-y) var(--invoml-padding-x);\n  background: var(--invoml-color-background);\n  color: var(--invoml-color-text);\n  font-family: var(--invoml-font-body);\n  font-size: 14px;\n  line-height: var(--invoml-line-height);\n  -webkit-font-smoothing: antialiased;\n}\n\n.invoml-container h1, .invoml-container h2, .invoml-container h3,\n.invoml-container h4, .invoml-container h5, .invoml-container h6 {\n  font-family: var(--invoml-font-heading);\n  color: var(--invoml-color-text);\n  line-height: 1.3;\n  margin: 0;\n}\n\n.invoml-container a { color: var(--invoml-color-accent); text-decoration: none; }\n.invoml-container a:hover { text-decoration: underline; }\n.invoml-container table { border-collapse: collapse; border-spacing: 0; width: 100%; }\n.invoml-container th, .invoml-container td { text-align: left; vertical-align: top; }\n.invoml-container ul, .invoml-container ol { padding-left: 1.5em; }\n.invoml-container p + p { margin-top: var(--invoml-paragraph-spacing); }\n\n/* Density variants */\n.invoml-density-compact {\n  --invoml-padding-y: 5mm;\n  --invoml-padding-x: 6mm;\n  --invoml-section-gap: 6px;\n  --invoml-table-row-padding: 3px;\n  --invoml-parties-gap: 10px;\n  --invoml-payment-margin-top: 10px;\n  --invoml-meta-gap: 6px;\n  --invoml-totals-margin: 6px;\n  --invoml-line-height: 1.3;\n  --invoml-paragraph-spacing: 4px;\n}\n.invoml-density-spacious {\n  --invoml-padding-y: 20mm;\n  --invoml-padding-x: 24mm;\n  --invoml-section-gap: 36px;\n  --invoml-table-row-padding: 16px;\n  --invoml-parties-gap: 48px;\n  --invoml-payment-margin-top: 48px;\n  --invoml-meta-gap: 28px;\n  --invoml-totals-margin: 32px;\n  --invoml-line-height: 1.8;\n  --invoml-paragraph-spacing: 20px;\n}\n\n/* Header block */\n.invoml-header { margin-bottom: var(--invoml-section-gap); }\n.invoml-header-title {\n  font-size: 28px;\n  font-weight: 300;\n  letter-spacing: -0.5px;\n  color: var(--invoml-color-text);\n  font-family: var(--invoml-font-heading);\n  margin-bottom: 6px;\n}\n.invoml-header-number {\n  font-size: 13px;\n  font-weight: 600;\n  color: var(--invoml-color-accent);\n  letter-spacing: 0.5px;\n  margin-bottom: 14px;\n  display: inline-block;\n  background: color-mix(in srgb, var(--invoml-color-accent) 10%, transparent);\n  padding: 3px 10px;\n  border-radius: 4px;\n}\n.invoml-header-meta {\n  display: flex;\n  flex-wrap: wrap;\n  gap: var(--invoml-meta-gap);\n  font-size: 13px;\n}\n.invoml-header-meta-item { display: flex; flex-direction: column; gap: 2px; min-width: 90px; }\n.invoml-header-meta-label {\n  font-size: 10px;\n  text-transform: uppercase;\n  letter-spacing: 1px;\n  color: var(--invoml-color-muted);\n  font-weight: 500;\n}\n.invoml-header-meta-value { color: var(--invoml-color-text); font-weight: 500; font-size: 13px; }\n\n/* Party blocks */\n.invoml-party {\n  font-size: 14px;\n  line-height: var(--invoml-line-height);\n  margin-bottom: var(--invoml-section-gap);\n  vertical-align: top;\n}\n.invoml-party-label {\n  font-size: 10px;\n  text-transform: uppercase;\n  letter-spacing: 1.5px;\n  color: var(--invoml-color-muted);\n  margin-bottom: 8px;\n  font-weight: 500;\n}\n.invoml-party-name {\n  font-weight: 600;\n  color: var(--invoml-color-text);\n  font-size: 15px;\n  margin-bottom: 6px;\n}\n.invoml-party-details { color: var(--invoml-color-muted); font-size: 13px; line-height: var(--invoml-line-height); }\n.invoml-party-details > div { margin: 2px 0; }\n\n/* Items table */\n.invoml-items { margin: var(--invoml-totals-margin) 0; }\n.invoml-items th {\n  padding: var(--invoml-table-row-padding) 0;\n  border-bottom: 1px solid var(--invoml-color-border);\n  font-size: 10px;\n  text-transform: uppercase;\n  letter-spacing: 1px;\n  color: var(--invoml-color-muted);\n  font-weight: 500;\n}\n.invoml-items td {\n  padding: var(--invoml-table-row-padding) 0;\n  border-bottom: 1px solid color-mix(in srgb, var(--invoml-color-border) 50%, transparent);\n  font-size: 14px;\n  color: var(--invoml-color-text);\n}\n.invoml-items .col-right { text-align: right; padding-right: 0; padding-left: 12px; }\n\n/* Totals */\n.invoml-totals { display: flex; justify-content: flex-end; margin-top: var(--invoml-totals-margin); }\n.invoml-totals-inner { width: 300px; }\n.invoml-totals-row {\n  display: flex;\n  justify-content: space-between;\n  padding: 5px 0;\n  font-size: 14px;\n  color: var(--invoml-color-text);\n}\n.invoml-totals-row.is-grand {\n  border-top: 2px solid var(--invoml-color-text);\n  margin-top: 8px;\n  padding-top: 10px;\n  font-size: 15px;\n  font-weight: 600;\n}\n.invoml-totals-row.is-amount-due {\n  border-top: 1px solid var(--invoml-color-border);\n  margin-top: 4px;\n  padding-top: 8px;\n  font-weight: 600;\n}\n.invoml-totals-label { color: var(--invoml-color-muted); }\n.invoml-totals-label.is-bold { color: var(--invoml-color-text); font-weight: 600; }\n.invoml-totals-amount { font-variant-numeric: tabular-nums; }\n\n/* Payment block */\n.invoml-payment {\n  margin-top: var(--invoml-payment-margin-top);\n  padding-top: 24px;\n  border-top: 1px solid var(--invoml-color-border);\n}\n.invoml-payment-title {\n  font-size: 10px;\n  text-transform: uppercase;\n  letter-spacing: 1.5px;\n  color: var(--invoml-color-muted);\n  margin-bottom: 12px;\n  font-weight: 500;\n}\n.invoml-payment-details { font-size: 14px; line-height: var(--invoml-line-height); color: var(--invoml-color-muted); }\n.invoml-payment-details strong { color: var(--invoml-color-text); font-weight: 600; }\n\n/* Notes block */\n.invoml-notes {\n  margin-top: var(--invoml-section-gap);\n  padding-top: var(--invoml-section-gap);\n  border-top: 1px solid var(--invoml-color-border);\n  font-size: 13px;\n  color: var(--invoml-color-muted);\n}\n\n/* Section block */\n.invoml-section { margin: var(--invoml-section-gap) 0; }\n.invoml-section-title {\n  font-size: 13px;\n  font-weight: 600;\n  color: var(--invoml-color-text);\n  margin-bottom: 8px;\n  text-transform: uppercase;\n  letter-spacing: 0.5px;\n}\n.invoml-section-content { font-size: 14px; color: var(--invoml-color-text); line-height: var(--invoml-line-height); }\n";
+/** Per-template CSS overrides. Applied when style.template is set. */
+export declare const TEMPLATE_CSS: Record<string, string>;

package/dist/src/html-css.js

@@ -0,0 +1,300 @@
+/** Base CSS for all InvoML HTML output. Applied to every document regardless of template. */
+export const BASE_CSS = `
+/* InvoML base styles */
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+body { background: #f5f5f5; }
+
+.invoml-container {
+  --invoml-color-accent: #2563eb;
+  --invoml-color-text: #1a1a1a;
+  --invoml-color-muted: #666666;
+  --invoml-color-border: #e0e0e0;
+  --invoml-color-background: #ffffff;
+  --invoml-font-heading: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --invoml-font-body: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --invoml-padding-y: 10mm;
+  --invoml-padding-x: 12mm;
+  --invoml-section-gap: 18px;
+  --invoml-table-row-padding: 10px;
+  --invoml-parties-gap: 28px;
+  --invoml-payment-margin-top: 28px;
+  --invoml-meta-gap: 18px;
+  --invoml-totals-margin: 18px;
+  --invoml-line-height: 1.5;
+  --invoml-paragraph-spacing: 12px;
+
+  width: 210mm;
+  margin: 0 auto;
+  padding: var(--invoml-padding-y) var(--invoml-padding-x);
+  background: var(--invoml-color-background);
+  color: var(--invoml-color-text);
+  font-family: var(--invoml-font-body);
+  font-size: 14px;
+  line-height: var(--invoml-line-height);
+  -webkit-font-smoothing: antialiased;
+}
+
+.invoml-container h1, .invoml-container h2, .invoml-container h3,
+.invoml-container h4, .invoml-container h5, .invoml-container h6 {
+  font-family: var(--invoml-font-heading);
+  color: var(--invoml-color-text);
+  line-height: 1.3;
+  margin: 0;
+}
+
+.invoml-container a { color: var(--invoml-color-accent); text-decoration: none; }
+.invoml-container a:hover { text-decoration: underline; }
+.invoml-container table { border-collapse: collapse; border-spacing: 0; width: 100%; }
+.invoml-container th, .invoml-container td { text-align: left; vertical-align: top; }
+.invoml-container ul, .invoml-container ol { padding-left: 1.5em; }
+.invoml-container p + p { margin-top: var(--invoml-paragraph-spacing); }
+
+/* Density variants */
+.invoml-density-compact {
+  --invoml-padding-y: 5mm;
+  --invoml-padding-x: 6mm;
+  --invoml-section-gap: 6px;
+  --invoml-table-row-padding: 3px;
+  --invoml-parties-gap: 10px;
+  --invoml-payment-margin-top: 10px;
+  --invoml-meta-gap: 6px;
+  --invoml-totals-margin: 6px;
+  --invoml-line-height: 1.3;
+  --invoml-paragraph-spacing: 4px;
+}
+.invoml-density-spacious {
+  --invoml-padding-y: 20mm;
+  --invoml-padding-x: 24mm;
+  --invoml-section-gap: 36px;
+  --invoml-table-row-padding: 16px;
+  --invoml-parties-gap: 48px;
+  --invoml-payment-margin-top: 48px;
+  --invoml-meta-gap: 28px;
+  --invoml-totals-margin: 32px;
+  --invoml-line-height: 1.8;
+  --invoml-paragraph-spacing: 20px;
+}
+
+/* Header block */
+.invoml-header { margin-bottom: var(--invoml-section-gap); }
+.invoml-header-title {
+  font-size: 28px;
+  font-weight: 300;
+  letter-spacing: -0.5px;
+  color: var(--invoml-color-text);
+  font-family: var(--invoml-font-heading);
+  margin-bottom: 6px;
+}
+.invoml-header-number {
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--invoml-color-accent);
+  letter-spacing: 0.5px;
+  margin-bottom: 14px;
+  display: inline-block;
+  background: color-mix(in srgb, var(--invoml-color-accent) 10%, transparent);
+  padding: 3px 10px;
+  border-radius: 4px;
+}
+.invoml-header-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--invoml-meta-gap);
+  font-size: 13px;
+}
+.invoml-header-meta-item { display: flex; flex-direction: column; gap: 2px; min-width: 90px; }
+.invoml-header-meta-label {
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  color: var(--invoml-color-muted);
+  font-weight: 500;
+}
+.invoml-header-meta-value { color: var(--invoml-color-text); font-weight: 500; font-size: 13px; }
+
+/* Party blocks */
+.invoml-party {
+  font-size: 14px;
+  line-height: var(--invoml-line-height);
+  margin-bottom: var(--invoml-section-gap);
+  vertical-align: top;
+}
+.invoml-party-label {
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 1.5px;
+  color: var(--invoml-color-muted);
+  margin-bottom: 8px;
+  font-weight: 500;
+}
+.invoml-party-name {
+  font-weight: 600;
+  color: var(--invoml-color-text);
+  font-size: 15px;
+  margin-bottom: 6px;
+}
+.invoml-party-details { color: var(--invoml-color-muted); font-size: 13px; line-height: var(--invoml-line-height); }
+.invoml-party-details > div { margin: 2px 0; }
+
+/* Items table */
+.invoml-items { margin: var(--invoml-totals-margin) 0; }
+.invoml-items th {
+  padding: var(--invoml-table-row-padding) 0;
+  border-bottom: 1px solid var(--invoml-color-border);
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  color: var(--invoml-color-muted);
+  font-weight: 500;
+}
+.invoml-items td {
+  padding: var(--invoml-table-row-padding) 0;
+  border-bottom: 1px solid color-mix(in srgb, var(--invoml-color-border) 50%, transparent);
+  font-size: 14px;
+  color: var(--invoml-color-text);
+}
+.invoml-items .col-right { text-align: right; padding-right: 0; padding-left: 12px; }
+
+/* Totals */
+.invoml-totals { display: flex; justify-content: flex-end; margin-top: var(--invoml-totals-margin); }
+.invoml-totals-inner { width: 300px; }
+.invoml-totals-row {
+  display: flex;
+  justify-content: space-between;
+  padding: 5px 0;
+  font-size: 14px;
+  color: var(--invoml-color-text);
+}
+.invoml-totals-row.is-grand {
+  border-top: 2px solid var(--invoml-color-text);
+  margin-top: 8px;
+  padding-top: 10px;
+  font-size: 15px;
+  font-weight: 600;
+}
+.invoml-totals-row.is-amount-due {
+  border-top: 1px solid var(--invoml-color-border);
+  margin-top: 4px;
+  padding-top: 8px;
+  font-weight: 600;
+}
+.invoml-totals-label { color: var(--invoml-color-muted); }
+.invoml-totals-label.is-bold { color: var(--invoml-color-text); font-weight: 600; }
+.invoml-totals-amount { font-variant-numeric: tabular-nums; }
+
+/* Payment block */
+.invoml-payment {
+  margin-top: var(--invoml-payment-margin-top);
+  padding-top: 24px;
+  border-top: 1px solid var(--invoml-color-border);
+}
+.invoml-payment-title {
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 1.5px;
+  color: var(--invoml-color-muted);
+  margin-bottom: 12px;
+  font-weight: 500;
+}
+.invoml-payment-details { font-size: 14px; line-height: var(--invoml-line-height); color: var(--invoml-color-muted); }
+.invoml-payment-details strong { color: var(--invoml-color-text); font-weight: 600; }
+
+/* Notes block */
+.invoml-notes {
+  margin-top: var(--invoml-section-gap);
+  padding-top: var(--invoml-section-gap);
+  border-top: 1px solid var(--invoml-color-border);
+  font-size: 13px;
+  color: var(--invoml-color-muted);
+}
+
+/* Section block */
+.invoml-section { margin: var(--invoml-section-gap) 0; }
+.invoml-section-title {
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--invoml-color-text);
+  margin-bottom: 8px;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+}
+.invoml-section-content { font-size: 14px; color: var(--invoml-color-text); line-height: var(--invoml-line-height); }
+`;
+/** Per-template CSS overrides. Applied when style.template is set. */
+export const TEMPLATE_CSS = {
+    professional: `
+/* Template: professional */
+.invoml-container[data-invoml-template="professional"] {
+  --invoml-color-accent: #2563eb;
+  --invoml-color-text: #1a1a1a;
+  --invoml-color-muted: #666666;
+  --invoml-color-border: #e0e0e0;
+}
+.invoml-container[data-invoml-template="professional"] .invoml-party {
+  display: inline-block;
+  width: 50%;
+}
+`,
+    minimal: `
+/* Template: minimal */
+.invoml-container[data-invoml-template="minimal"] {
+  --invoml-color-accent: #555555;
+  --invoml-color-text: #222222;
+  --invoml-color-muted: #888888;
+  --invoml-color-border: #eeeeee;
+  --invoml-padding-y: 20mm;
+  --invoml-padding-x: 24mm;
+  --invoml-section-gap: 36px;
+  --invoml-table-row-padding: 16px;
+  --invoml-parties-gap: 48px;
+  --invoml-payment-margin-top: 48px;
+  --invoml-meta-gap: 28px;
+  --invoml-totals-margin: 32px;
+  --invoml-line-height: 1.8;
+  --invoml-paragraph-spacing: 20px;
+}
+.invoml-container[data-invoml-template="minimal"] .invoml-header-number {
+  background: none;
+  padding: 0;
+  letter-spacing: 1px;
+}
+.invoml-container[data-invoml-template="minimal"] .invoml-party {
+  display: inline-block;
+  width: 50%;
+}
+`,
+    modern: `
+/* Template: modern */
+.invoml-container[data-invoml-template="modern"] {
+  --invoml-color-accent: #e63946;
+  --invoml-color-text: #111111;
+  --invoml-color-muted: #555555;
+  --invoml-color-border: #cccccc;
+  --invoml-padding-y: 5mm;
+  --invoml-padding-x: 6mm;
+  --invoml-section-gap: 6px;
+  --invoml-table-row-padding: 3px;
+  --invoml-parties-gap: 10px;
+  --invoml-payment-margin-top: 10px;
+  --invoml-meta-gap: 6px;
+  --invoml-totals-margin: 6px;
+  --invoml-line-height: 1.3;
+  --invoml-paragraph-spacing: 4px;
+}
+.invoml-container[data-invoml-template="modern"] .invoml-header-title {
+  font-size: 36px;
+  font-weight: 700;
+  letter-spacing: -2px;
+}
+.invoml-container[data-invoml-template="modern"] .invoml-header {
+  border-bottom: 3px solid var(--invoml-color-accent);
+  padding-bottom: 12px;
+  margin-bottom: 12px;
+}
+.invoml-container[data-invoml-template="modern"] .invoml-party {
+  display: inline-block;
+  width: 50%;
+}
+`,
+};

package/dist/src/html-renderer.d.ts

@@ -0,0 +1,5 @@
+import type { InvoMLDocument } from './types.js';
+/** Render an InvoML document (with computed totals in doc.totals) as a
+ *  self-contained HTML string suitable for browser display, iframe embedding,
+ *  or headless PDF generation. */
+export declare function toHTML(doc: InvoMLDocument): string;