@endora-commerce/mod-invoices 0.0.0-stage → 0.100.0

package/dist/backend/pdf-components/descriptor.d.ts

@@ -0,0 +1,29 @@
+import type { InvoiceTemplateBlockField } from '@endora-commerce/contracts';
+import type { InvoicePdfBlockRegistry } from '../services/invoice-pdf-block-registry.js';
+/**
+ * Page-builder descriptor for the invoice template WYSIWYG palette (US6).
+ * Served to the admin editor so it can offer the bounded invoice component set.
+ *
+ * The field shape is the published contract's, because a contributed block
+ * describes its own fields (`specs/134-paid-module-extraction/` T063).
+ */
+export type InvoiceComponentField = InvoiceTemplateBlockField;
+export interface InvoiceComponentDescriptor {
+    name: string;
+    ownerModule: string;
+    label: string;
+    fields: Record<string, InvoiceComponentField>;
+}
+/**
+ * The descriptor `GET /api/v1/admin/invoice-templates/page-builder/config`
+ * serves: this module's ten blocks, then every present contributor's.
+ *
+ * Built per request rather than held as a constant, because a contributor's
+ * presence is read on every call — switching one off removes its block from
+ * the palette description without a restart, and switching it on restores it.
+ */
+export declare function invoicePageBuilderDescriptor(blocks: InvoicePdfBlockRegistry): {
+    schemaVersion: 1;
+    components: InvoiceComponentDescriptor[];
+};
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/backend/pdf-components/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../src/backend/pdf-components/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAGzF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC/C;AA+MD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,uBAAuB,GAAG;IAC7E,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,0BAA0B,EAAE,CAAC;CAC1C,CAkBA"}

package/dist/backend/pdf-components/descriptor.js

@@ -0,0 +1,227 @@
+import { INVOICE_COMPONENT_NAMES } from './tree-mapper.js';
+const LABELS = {
+    'invoices.InvoiceHeader': 'Header (number + dates)',
+    'invoices.InvoiceParties': 'Seller & buyer',
+    'invoices.InvoiceLineItems': 'Line items table',
+    'invoices.InvoiceVatSummary': 'VAT summary',
+    'invoices.InvoiceTotals': 'Totals & amount in words',
+    'invoices.InvoiceNotes': 'Notes (free text)',
+    'invoices.InvoiceSpacer': 'Spacer',
+    'invoices.InvoiceDivider': 'Divider',
+    'invoices.InvoiceLogo': 'Logo',
+    'invoices.InvoiceFooter': 'Footer / legal',
+};
+const YES_NO = [
+    { label: 'Yes', value: true },
+    { label: 'No', value: false },
+];
+function radio(label) {
+    return { type: 'radio', label, options: YES_NO };
+}
+const SHARED_MARGIN = {
+    marginTop: { type: 'number', label: 'Margin top (px)' },
+    marginBottom: { type: 'number', label: 'Margin bottom (px)' },
+};
+const FIELDS = {
+    'invoices.InvoiceHeader': {
+        titleSize: { type: 'number', label: 'Title size' },
+        titleColor: { type: 'color', label: 'Title color' },
+        titleBold: radio('Title bold'),
+        align: {
+            type: 'select',
+            label: 'Align',
+            options: [
+                { label: 'Left', value: 'left' },
+                { label: 'Center', value: 'center' },
+                { label: 'Right', value: 'right' },
+            ],
+        },
+        showIssuedAt: radio('Show issue date'),
+        showSaleDate: radio('Show sale date'),
+        showPaymentDue: radio('Show payment due'),
+        showPaymentMethod: radio('Show payment method'),
+        labelIssuedAt: { type: 'text', label: 'Issue date label' },
+        labelSaleDate: { type: 'text', label: 'Sale date label' },
+        labelPaymentDue: { type: 'text', label: 'Payment due label' },
+        labelPaymentMethod: { type: 'text', label: 'Payment method label' },
+        // T137: the KSeF number row prints whenever the invoice has one and no
+        // placed block prints it; the operator may relabel it and not hide it.
+        labelKsefNumber: { type: 'text', label: 'KSeF number label' },
+        ...SHARED_MARGIN,
+    },
+    'invoices.InvoiceParties': {
+        sellerLabel: { type: 'text', label: 'Seller label' },
+        buyerLabel: { type: 'text', label: 'Buyer label' },
+        showSellerBank: radio('Show seller bank'),
+        showSellerSwift: radio('Show seller SWIFT'),
+        showBuyerTaxId: radio('Show buyer tax ID'),
+        labelFontSize: { type: 'number', label: 'Label font size' },
+        bodyFontSize: { type: 'number', label: 'Body font size' },
+        columnGap: { type: 'number', label: 'Column gap (px)' },
+        sellerWidthPercent: { type: 'number', label: 'Seller width %' },
+        ...SHARED_MARGIN,
+    },
+    'invoices.InvoiceLineItems': {
+        fontSize: { type: 'number', label: 'Font size' },
+        headerBold: radio('Header bold'),
+        headerBackground: { type: 'color', label: 'Header background' },
+        headerColor: { type: 'color', label: 'Header text color' },
+        borderColor: { type: 'color', label: 'Border color' },
+        zebra: radio('Zebra rows'),
+        showUnit: radio('Show unit'),
+        showQty: radio('Show quantity'),
+        showUnitNet: radio('Show unit net price'),
+        showTaxRate: radio('Show tax rate'),
+        showNet: radio('Show net value'),
+        showGross: radio('Show gross value'),
+        ...SHARED_MARGIN,
+    },
+    'invoices.InvoiceVatSummary': {
+        fontSize: { type: 'number', label: 'Font size' },
+        headerBold: radio('Header bold'),
+        headerBackground: { type: 'color', label: 'Header background' },
+        headerColor: { type: 'color', label: 'Header text color' },
+        borderColor: { type: 'color', label: 'Border color' },
+        showTotalRow: radio('Show total row'),
+        totalLabel: { type: 'text', label: 'Total row label' },
+        ...SHARED_MARGIN,
+    },
+    'invoices.InvoiceTotals': {
+        align: {
+            type: 'select',
+            label: 'Align',
+            options: [
+                { label: 'Left', value: 'left' },
+                { label: 'Center', value: 'center' },
+                { label: 'Right', value: 'right' },
+            ],
+        },
+        fontSize: { type: 'number', label: 'Font size' },
+        color: { type: 'color', label: 'Text color' },
+        amountDueColor: { type: 'color', label: 'Amount due color' },
+        amountDueBold: radio('Amount due bold'),
+        amountInWordsItalics: radio('Amount in words italics'),
+        showPaid: radio('Show paid'),
+        showAmountDue: radio('Show amount due'),
+        showGross: radio('Show gross'),
+        showAmountInWords: radio('Show amount in words'),
+        labelPaid: { type: 'text', label: 'Paid label' },
+        labelAmountDue: { type: 'text', label: 'Amount due label' },
+        labelGross: { type: 'text', label: 'Gross label' },
+        labelInWords: { type: 'text', label: 'In words label' },
+        ...SHARED_MARGIN,
+    },
+    'invoices.InvoiceNotes': {
+        text: { type: 'textarea', label: 'Notes text' },
+        align: {
+            type: 'select',
+            label: 'Align',
+            options: [
+                { label: 'Left', value: 'left' },
+                { label: 'Center', value: 'center' },
+                { label: 'Right', value: 'right' },
+            ],
+        },
+        fontSize: { type: 'number', label: 'Font size' },
+        color: { type: 'color', label: 'Text color' },
+        bold: radio('Bold'),
+        italics: radio('Italics'),
+        showTopDivider: radio('Top divider'),
+        ...SHARED_MARGIN,
+    },
+    'invoices.InvoiceSpacer': {
+        height: { type: 'number', label: 'Height (px)' },
+        backgroundColor: { type: 'color', label: 'Background color' },
+    },
+    'invoices.InvoiceDivider': {
+        thickness: { type: 'number', label: 'Thickness (px)' },
+        color: { type: 'color', label: 'Color' },
+        style: {
+            type: 'select',
+            label: 'Style',
+            options: [
+                { label: 'Solid', value: 'solid' },
+                { label: 'Dashed', value: 'dashed' },
+            ],
+        },
+        widthPercent: { type: 'number', label: 'Width %' },
+        align: {
+            type: 'select',
+            label: 'Align',
+            options: [
+                { label: 'Left', value: 'left' },
+                { label: 'Center', value: 'center' },
+                { label: 'Right', value: 'right' },
+            ],
+        },
+        marginY: { type: 'number', label: 'Vertical margin (px)' },
+    },
+    'invoices.InvoiceLogo': {
+        imageSource: {
+            type: 'select',
+            label: 'Image source',
+            options: [
+                { label: 'URL', value: 'url' },
+                { label: 'Asset library', value: 'library' },
+            ],
+        },
+        src: { type: 'text', label: 'Image URL' },
+        assetId: { type: 'text', label: 'Image' },
+        width: { type: 'number', label: 'Width (px)' },
+        maxHeight: { type: 'number', label: 'Max height (px)' },
+        align: {
+            type: 'select',
+            label: 'Align',
+            options: [
+                { label: 'Left', value: 'left' },
+                { label: 'Center', value: 'center' },
+                { label: 'Right', value: 'right' },
+            ],
+        },
+        marginBottom: { type: 'number', label: 'Margin bottom (px)' },
+    },
+    'invoices.InvoiceFooter': {
+        text: { type: 'textarea', label: 'Footer text' },
+        align: {
+            type: 'select',
+            label: 'Align',
+            options: [
+                { label: 'Left', value: 'left' },
+                { label: 'Center', value: 'center' },
+                { label: 'Right', value: 'right' },
+            ],
+        },
+        fontSize: { type: 'number', label: 'Font size' },
+        color: { type: 'color', label: 'Text color' },
+        bold: radio('Bold'),
+        italics: radio('Italics'),
+        showTopDivider: radio('Top divider'),
+        ...SHARED_MARGIN,
+    },
+};
+/**
+ * The descriptor `GET /api/v1/admin/invoice-templates/page-builder/config`
+ * serves: this module's ten blocks, then every present contributor's.
+ *
+ * Built per request rather than held as a constant, because a contributor's
+ * presence is read on every call — switching one off removes its block from
+ * the palette description without a restart, and switching it on restores it.
+ */
+export function invoicePageBuilderDescriptor(blocks) {
+    return {
+        schemaVersion: 1,
+        components: [
+            ...INVOICE_COMPONENT_NAMES.map((name) => ({
+                name,
+                ownerModule: 'invoices',
+                label: LABELS[name] ?? name,
+                fields: FIELDS[name] ?? {},
+            })),
+            ...blocks.present().map((block) => {
+                const { label, fields } = block.describe();
+                return { name: block.name, ownerModule: block.moduleId, label, fields: { ...fields } };
+            }),
+        ],
+    };
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/backend/pdf-components/descriptor.js.map

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

package/dist/backend/pdf-components/embed-logo-images.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pre-resolve InvoiceLogo images to data URIs before pdfmake runs.
+ *
+ * pdfmake fetches `image: <http url>` over the network. When the admin embeds a
+ * library asset, `resolveData` bakes an absolute API URL
+ * (`http://localhost:3001/assets/file/<id>`). Fetching that URL from inside the
+ * same Node process that is still serving the preview request deadlocks or
+ * 403s (private assets), which surfaces as INTERNAL on Preview PDF.
+ *
+ * Loading bytes via the Assets Library storage adapter (or a short external
+ * fetch for true remote URLs) and inlining `data:image/…;base64,…` avoids the
+ * self-HTTP path. Unsupported formats (SVG, WebP, …) are omitted so the PDF
+ * still renders.
+ */
+/**
+ * `Uint8Array` rather than `Buffer` since `specs/110-instance-repository/`
+ * T118c: the bytes arrive from `assetReadPort.openAssetBytes`, and
+ * `@endora-commerce/contracts` cannot name the `Buffer` global (it is compiled
+ * by `@endora-commerce/admin-kit` with `types: ["vite/client"]`). A `Buffer`
+ * still satisfies it, which is why the external-fetch path below and this
+ * file's own tests are unchanged.
+ */
+export type LoadedAssetImage = {
+    bytes: Uint8Array;
+    mimeType: string;
+};
+export type LoadAssetImage = (assetId: string) => Promise<LoadedAssetImage | null>;
+export declare function toImageDataUri(bytes: Uint8Array, mimeType: string): string | null;
+export declare function extractAssetIdFromUrl(url: string): string | null;
+/**
+ * Returns a shallow-cloned tree with InvoiceLogo `src` replaced by data URIs
+ * (or cleared when the image cannot be embedded).
+ */
+export declare function embedInvoiceLogoImages(tree: unknown, loadAssetImage?: LoadAssetImage): Promise<unknown>;
+//# sourceMappingURL=embed-logo-images.d.ts.map

package/dist/backend/pdf-components/embed-logo-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-logo-images.d.ts","sourceRoot":"","sources":["../../../src/backend/pdf-components/embed-logo-images.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAYnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIjF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AA4DD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,OAAO,EACb,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/backend/pdf-components/embed-logo-images.js

@@ -0,0 +1,101 @@
+/**
+ * Pre-resolve InvoiceLogo images to data URIs before pdfmake runs.
+ *
+ * pdfmake fetches `image: <http url>` over the network. When the admin embeds a
+ * library asset, `resolveData` bakes an absolute API URL
+ * (`http://localhost:3001/assets/file/<id>`). Fetching that URL from inside the
+ * same Node process that is still serving the preview request deadlocks or
+ * 403s (private assets), which surfaces as INTERNAL on Preview PDF.
+ *
+ * Loading bytes via the Assets Library storage adapter (or a short external
+ * fetch for true remote URLs) and inlining `data:image/…;base64,…` avoids the
+ * self-HTTP path. Unsupported formats (SVG, WebP, …) are omitted so the PDF
+ * still renders.
+ */
+const ASSET_FILE_RE = /\/assets\/file\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i;
+/** pdfmake reliably embeds JPEG/PNG; other types are skipped. */
+const PDFMAKE_IMAGE_MIME = new Set(['image/jpeg', 'image/jpg', 'image/png']);
+function normalizeMime(mime) {
+    const m = mime.toLowerCase().split(';')[0]?.trim() ?? '';
+    return m === 'image/jpg' ? 'image/jpeg' : m;
+}
+export function toImageDataUri(bytes, mimeType) {
+    const mime = normalizeMime(mimeType);
+    if (!PDFMAKE_IMAGE_MIME.has(mime))
+        return null;
+    return `data:${mime};base64,${Buffer.from(bytes).toString('base64')}`;
+}
+export function extractAssetIdFromUrl(url) {
+    const m = ASSET_FILE_RE.exec(url);
+    return m?.[1] ?? null;
+}
+async function fetchExternalImage(url, timeoutMs = 3_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { signal: controller.signal });
+        if (!res.ok)
+            return null;
+        const mime = normalizeMime(res.headers.get('content-type') ?? 'image/png');
+        if (!PDFMAKE_IMAGE_MIME.has(mime))
+            return null;
+        const arr = new Uint8Array(await res.arrayBuffer());
+        return { bytes: Buffer.from(arr), mimeType: mime };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function resolveLogoSrc(props, loadAssetImage) {
+    const existing = typeof props['src'] === 'string' ? props['src'].trim() : '';
+    if (/^data:image\/(png|jpe?g);base64,/i.test(existing))
+        return existing;
+    const assetIdRaw = typeof props['assetId'] === 'string' ? props['assetId'].trim() : '';
+    const fromSrc = existing ? extractAssetIdFromUrl(existing) : null;
+    const assetId = assetIdRaw || fromSrc || '';
+    if (assetId && loadAssetImage) {
+        const loaded = await loadAssetImage(assetId);
+        if (loaded) {
+            const dataUri = toImageDataUri(loaded.bytes, loaded.mimeType);
+            if (dataUri)
+                return dataUri;
+        }
+        return '';
+    }
+    // Remote URL that is not our assets endpoint — safe to fetch (CDN / public HTTP).
+    if (/^https?:\/\//i.test(existing) && !extractAssetIdFromUrl(existing)) {
+        const loaded = await fetchExternalImage(existing);
+        if (loaded) {
+            const dataUri = toImageDataUri(loaded.bytes, loaded.mimeType);
+            if (dataUri)
+                return dataUri;
+        }
+        return '';
+    }
+    // Library URL without a loader (unit tests) — clear so pdfmake does not self-fetch.
+    if (extractAssetIdFromUrl(existing))
+        return '';
+    return existing;
+}
+/**
+ * Returns a shallow-cloned tree with InvoiceLogo `src` replaced by data URIs
+ * (or cleared when the image cannot be embedded).
+ */
+export async function embedInvoiceLogoImages(tree, loadAssetImage) {
+    if (!tree || typeof tree !== 'object')
+        return tree;
+    const root = tree;
+    if (!Array.isArray(root.content))
+        return tree;
+    const content = await Promise.all(root.content.map(async (node) => {
+        if (node?.type !== 'invoices.InvoiceLogo' || !node.props)
+            return node;
+        const src = await resolveLogoSrc(node.props, loadAssetImage);
+        return { ...node, props: { ...node.props, src } };
+    }));
+    return { ...root, content };
+}
+//# sourceMappingURL=embed-logo-images.js.map

package/dist/backend/pdf-components/embed-logo-images.js.map

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

package/dist/backend/pdf-components/sample.d.ts

@@ -0,0 +1,4 @@
+import type { InvoiceDetail } from '@endora-commerce/contracts';
+/** A representative invoice used for template preview rendering (US6). */
+export declare function sampleInvoiceDetail(): InvoiceDetail;
+//# sourceMappingURL=sample.d.ts.map

package/dist/backend/pdf-components/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../../src/backend/pdf-components/sample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,0EAA0E;AAC1E,wBAAgB,mBAAmB,IAAI,aAAa,CAwEnD"}

package/dist/backend/pdf-components/sample.js

@@ -0,0 +1,75 @@
+/** A representative invoice used for template preview rendering (US6). */
+export function sampleInvoiceDetail() {
+    return {
+        id: '00000000-0000-4000-8000-0000000000aa',
+        orderId: '00000000-0000-4000-8000-0000000000bb',
+        orderBusinessId: 'ORD-2026-0042',
+        salesChannelId: null,
+        kind: 'invoice',
+        number: 'INV-2026-0042',
+        status: 'ready',
+        currency: 'USD',
+        issuedAt: '2026-05-04T10:00:00.000Z',
+        saleDate: '2026-05-04',
+        paymentDueDate: '2026-05-18',
+        paymentMethod: 'Bank transfer',
+        netTotal: 2000,
+        taxTotal: 400,
+        grossTotal: 2400,
+        paidTotal: 0,
+        amountDue: 2400,
+        total: 2400,
+        originalInvoiceId: null,
+        templateId: null,
+        pdfAssetId: null,
+        ksefReferenceNumber: null,
+        ksefProcessedAt: null,
+        lines: [
+            {
+                ordinal: 1,
+                name: 'Cloud hosting — annual plan',
+                unit: 'ea',
+                quantity: 1,
+                unitNetPrice: 500,
+                taxRate: 0.2,
+                netValue: 500,
+                grossValue: 600,
+            },
+            {
+                ordinal: 2,
+                name: 'Professional services — onboarding',
+                unit: 'hr',
+                quantity: 10,
+                unitNetPrice: 150,
+                taxRate: 0.2,
+                netValue: 1500,
+                grossValue: 1800,
+            },
+        ],
+        vatSummary: [{ taxRate: 0.2, netTotal: 2000, vatAmount: 400, grossTotal: 2400 }],
+        seller: {
+            legalName: 'Acme Supplies Ltd.',
+            addressLine1: '100 Market Street, Suite 4',
+            addressLine2: '',
+            postalCode: '10001',
+            city: 'New York',
+            country: 'US',
+            taxId: '12-3456789',
+            bankName: 'Example Bank',
+            bankAccount: 'US64 EXAMPLE 0000 0000 0000 00',
+            swift: 'EXAMPUS33',
+            email: '',
+            phone: '',
+        },
+        buyer: {
+            name: 'Globex Trading Co.',
+            taxId: '98-7654321',
+            addressLine1: '250 Commerce Avenue',
+            addressLine2: '',
+            postalCode: '60601',
+            city: 'Chicago',
+            country: 'US',
+        },
+    };
+}
+//# sourceMappingURL=sample.js.map

package/dist/backend/pdf-components/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../../src/backend/pdf-components/sample.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,EAAE,EAAE,sCAAsC;QAC1C,OAAO,EAAE,sCAAsC;QAC/C,eAAe,EAAE,eAAe;QAChC,cAAc,EAAE,IAAI;QACpB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE,YAAY;QACtB,cAAc,EAAE,YAAY;QAC5B,aAAa,EAAE,eAAe;QAC9B,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,GAAG;QACb,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;QACX,iBAAiB,EAAE,IAAI;QACvB,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,IAAI;QAChB,mBAAmB,EAAE,IAAI;QACzB,eAAe,EAAE,IAAI;QACrB,KAAK,EAAE;YACL;gBACE,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,6BAA6B;gBACnC,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,CAAC;gBACX,YAAY,EAAE,GAAG;gBACjB,OAAO,EAAE,GAAG;gBACZ,QAAQ,EAAE,GAAG;gBACb,UAAU,EAAE,GAAG;aAChB;YACD;gBACE,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,oCAAoC;gBAC1C,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,EAAE;gBACZ,YAAY,EAAE,GAAG;gBACjB,OAAO,EAAE,GAAG;gBACZ,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,IAAI;aACjB;SACF;QACD,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAChF,MAAM,EAAE;YACN,SAAS,EAAE,oBAAoB;YAC/B,YAAY,EAAE,4BAA4B;YAC1C,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,OAAO;YACnB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,cAAc;YACxB,WAAW,EAAE,gCAAgC;YAC7C,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;SACV;QACD,KAAK,EAAE;YACL,IAAI,EAAE,oBAAoB;YAC1B,KAAK,EAAE,YAAY;YACnB,YAAY,EAAE,qBAAqB;YACnC,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,OAAO;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;SACd;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/pdf-components/sections.d.ts

@@ -0,0 +1,34 @@
+import type { Content } from 'pdfmake/interfaces.js';
+import type { InvoiceDetail } from '@endora-commerce/contracts';
+import { type AmountToWordsLocale } from '../services/amount-to-words.js';
+/**
+ * Invoice PDF section builders (feature 047, US6). Each maps a slice of the
+ * invoice data (+ optional Puck props) to pdfmake `Content`. Shared by the
+ * built-in generic layout and the WYSIWYG template tree mapper.
+ */
+export declare function money(n: number): string;
+export declare function pct(rate: number): string;
+export declare const TITLES: Record<InvoiceDetail['kind'], string>;
+type Props = Record<string, unknown>;
+/** Interpolate `{{var invoice.x}}` / `{{var order.x}}` style tokens. */
+export declare function interpolate(text: string, inv: InvoiceDetail): string;
+/** What the renderer tells the header beyond its props. */
+export interface HeaderSectionOptions {
+    /**
+     * A present, placed contributed block prints the KSeF number itself, so the
+     * header's own row stands down (`specs/134-paid-module-extraction/` T137).
+     */
+    readonly suppressKsefNumber?: boolean;
+}
+export declare function headerSection(inv: InvoiceDetail, props?: Props, options?: HeaderSectionOptions): Content;
+export declare function partiesSection(inv: InvoiceDetail, props?: Props): Content;
+export declare function lineItemsSection(inv: InvoiceDetail, props?: Props): Content;
+export declare function vatSummarySection(inv: InvoiceDetail, props?: Props): Content;
+export declare function totalsSection(inv: InvoiceDetail, locale: AmountToWordsLocale, props?: Props): Content;
+export declare function notesSection(props: Props, inv: InvoiceDetail): Content;
+export declare function footerSection(props: Props, inv: InvoiceDetail): Content;
+export declare function spacerSection(props?: Props): Content;
+export declare function dividerSection(props?: Props): Content;
+export declare function logoSection(props?: Props): Content;
+export {};
+//# sourceMappingURL=sections.d.ts.map

package/dist/backend/pdf-components/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../src/backend/pdf-components/sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAEzF;;;;GAIG;AAEH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvC;AACD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAKxD,CAAC;AAGF,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAiCrC,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAapE;AAED,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,KAAK,GAAE,KAAU,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAiET;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CA0C7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CA4F/E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CA8ChF;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,mBAAmB,EAC3B,KAAK,GAAE,KAAU,GAChB,OAAO,CA0CT;AA8BD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAGtE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAMvE;AAED,wBAAgB,aAAa,CAAC,KAAK,GAAE,KAAU,GAAG,OAAO,CAUxD;AAED,wBAAgB,cAAc,CAAC,KAAK,GAAE,KAAU,GAAG,OAAO,CA2BzD;AAED,wBAAgB,WAAW,CAAC,KAAK,GAAE,KAAU,GAAG,OAAO,CAiBtD"}