@open-nav/invoicing 0.1.0

package/dist/pdf.d.ts

@@ -0,0 +1,92 @@
+import type { InvoiceData } from '@open-nav/core';
+import { type NativePdfOptions } from './pdf-native.js';
+/**
+ * PDF output, by either of two engines.
+ *
+ * `native` is the default and needs nothing installed: pdfmake lays the
+ * document out and pdfkit writes the PDF, using the Roboto files pdfmake
+ * bundles. Roboto covers Latin Extended-A, so `ő` and `ű` embed correctly —
+ * which was the whole difficulty, since the PDF core fonts cannot represent
+ * them and a font therefore has to be embedded.
+ *
+ * `browser` renders the HTML document and converts it with Chrome, Chromium
+ * or Edge. It follows the HTML exactly, at the cost of needing a browser.
+ *
+ * They are two layouts, not one: the native engine follows the same theme but
+ * builds the page from pdfmake's document model rather than CSS, so the two
+ * will not match pixel for pixel.
+ */
+export declare class PdfConversionError extends Error {
+}
+export interface PdfOptions extends NativePdfOptions {
+    /**
+     * Which engine to use.
+     *
+     * `native` (the default) needs nothing installed. `browser` follows the
+     * HTML document exactly but requires Chrome, Chromium or Edge.
+     */
+    engine?: 'native' | 'browser';
+    /** Browser executable. Auto-detected when omitted. `browser` engine only. */
+    browserPath?: string;
+    /** Extra arguments passed to the browser. */
+    browserArgs?: string[];
+    /**
+     * Run the browser with its sandbox. On by default.
+     *
+     * The sandbox is what contains a malicious document, and invoice data is
+     * input. It is left on even though that means conversion fails when running
+     * as root — in a container or CI, pass `sandbox: false` deliberately. The
+     * error message says so, rather than quietly weakening the default for
+     * everybody.
+     */
+    sandbox?: boolean;
+    /** Give up after this long. Defaults to 30 000 ms. */
+    timeoutMs?: number;
+    /** Environment consulted when detecting a browser. Injectable for tests. */
+    env?: Record<string, string | undefined>;
+    /**
+     * Absolute locations probed when detecting a browser, in place of the usual
+     * install paths. Injectable for tests: those paths are the host's, so
+     * without this a test cannot describe a machine that has no browser.
+     */
+    searchPaths?: readonly string[];
+    /**
+     * Convert HTML to PDF yourself, instead of spawning a browser.
+     *
+     * ```ts
+     * import { chromium } from 'playwright';
+     * const convert = async (html: string) => {
+     *   const browser = await chromium.launch();
+     *   const page = await browser.newPage();
+     *   await page.setContent(html, { waitUntil: 'load' });
+     *   const pdf = await page.pdf({ printBackground: true });
+     *   await browser.close();
+     *   return pdf;
+     * };
+     * ```
+     */
+    convert?: (html: string) => Promise<Buffer>;
+}
+/**
+ * Render an invoice straight to PDF bytes.
+ *
+ * Uses the native engine unless `engine: 'browser'` is asked for, or a
+ * `convert` function is supplied — passing a converter is itself a request to
+ * go through HTML.
+ */
+export declare function renderInvoicePdf(document: InvoiceData, options?: PdfOptions): Promise<Buffer>;
+/** Convert a rendered document to PDF bytes. */
+export declare function htmlToPdf(html: string, options?: PdfOptions): Promise<Buffer>;
+/**
+ * Locate a browser able to print to PDF.
+ *
+ * Order: an explicit environment variable, a Playwright install, the usual
+ * install locations, then `PATH`.
+ *
+ * `searchPaths` replaces that third step. It exists because the usual
+ * locations are absolute paths on the host, so no value of `env` can describe
+ * a machine without a browser — which is exactly what the failure path has to
+ * be tested against.
+ */
+export declare function findBrowser(env?: Record<string, string | undefined>, searchPaths?: readonly string[]): string | undefined;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAClD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,gDAAgD;AAChD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAavF;AA8HD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,WAAW,GAAE,SAAS,MAAM,EAAqB,GAChD,MAAM,GAAG,SAAS,CAuBpB"}

package/dist/pdf.js

@@ -0,0 +1,203 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { renderInvoiceHtml } from './html.js';
+import { renderInvoicePdfNative } from './pdf-native.js';
+/**
+ * PDF output, by either of two engines.
+ *
+ * `native` is the default and needs nothing installed: pdfmake lays the
+ * document out and pdfkit writes the PDF, using the Roboto files pdfmake
+ * bundles. Roboto covers Latin Extended-A, so `ő` and `ű` embed correctly —
+ * which was the whole difficulty, since the PDF core fonts cannot represent
+ * them and a font therefore has to be embedded.
+ *
+ * `browser` renders the HTML document and converts it with Chrome, Chromium
+ * or Edge. It follows the HTML exactly, at the cost of needing a browser.
+ *
+ * They are two layouts, not one: the native engine follows the same theme but
+ * builds the page from pdfmake's document model rather than CSS, so the two
+ * will not match pixel for pixel.
+ */
+export class PdfConversionError extends Error {
+}
+/**
+ * Render an invoice straight to PDF bytes.
+ *
+ * Uses the native engine unless `engine: 'browser'` is asked for, or a
+ * `convert` function is supplied — passing a converter is itself a request to
+ * go through HTML.
+ */
+export async function renderInvoicePdf(document, options = {}) {
+    const engine = options.engine ?? (options.convert || options.browserPath ? 'browser' : 'native');
+    if (engine === 'native')
+        return renderInvoicePdfNative(document, options);
+    return htmlToPdf(renderInvoiceHtml(document, options), options);
+}
+/** Convert a rendered document to PDF bytes. */
+export async function htmlToPdf(html, options = {}) {
+    if (options.convert)
+        return options.convert(html);
+    const browser = options.browserPath ?? findBrowser(options.env, options.searchPaths);
+    if (!browser) {
+        throw new PdfConversionError('No browser found to convert the document to PDF.\n' +
+            'Install Chrome, Chromium or Edge, or set one of OPEN_NAV_BROWSER, ' +
+            'CHROME_PATH or PUPPETEER_EXECUTABLE_PATH, or pass browserPath, ' +
+            'or supply your own convert() — see PdfOptions.');
+    }
+    return spawnConversion(html, browser, options);
+}
+async function spawnConversion(html, browser, options) {
+    const workDir = mkdtempSync(join(tmpdir(), 'open-nav-pdf-'));
+    const inputPath = join(workDir, 'invoice.html');
+    const outputPath = join(workDir, 'invoice.pdf');
+    try {
+        writeFileSync(inputPath, html, 'utf8');
+        const args = [
+            '--headless',
+            '--disable-gpu',
+            '--no-pdf-header-footer',
+            // Its own profile, so concurrent conversions do not fight over one.
+            `--user-data-dir=${join(workDir, 'profile')}`,
+            ...(options.sandbox === false ? ['--no-sandbox'] : []),
+            ...(options.browserArgs ?? []),
+            `--print-to-pdf=${outputPath}`,
+            `file://${inputPath}`,
+        ];
+        const { code, stderr } = await run(browser, args, options.timeoutMs ?? 30_000);
+        if (!existsSync(outputPath)) {
+            throw new PdfConversionError(explainFailure(browser, code, stderr, options));
+        }
+        const pdf = readFileSync(outputPath);
+        if (!pdf.subarray(0, 5).equals(Buffer.from('%PDF-'))) {
+            throw new PdfConversionError(`${browser} produced ${pdf.length} bytes that are not a PDF.\n${stderr.trim()}`);
+        }
+        return pdf;
+    }
+    finally {
+        rmSync(workDir, { recursive: true, force: true });
+    }
+}
+/** Turn a browser failure into something the caller can act on. */
+function explainFailure(browser, code, stderr, options) {
+    if (/without --no-sandbox is not supported/i.test(stderr)) {
+        return (`${browser} refuses to run as root with its sandbox enabled.\n` +
+            'Pass sandbox: false (or --no-sandbox on the CLI) if you accept that, ' +
+            'which is usual in a container, or run as a non-root user.');
+    }
+    if (options.sandbox === false && /sandbox/i.test(stderr)) {
+        return `${browser} could not start even with the sandbox disabled.\n${stderr.trim()}`;
+    }
+    return `${browser} exited with code ${code ?? 'unknown'} and produced no PDF.\n${stderr.trim()}`;
+}
+function run(command, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            reject(new PdfConversionError(`${command} did not finish within ${timeoutMs}ms. ` +
+                'A logo fetched over the network is the usual cause; inline it instead.'));
+        }, timeoutMs);
+        child.on('error', (error) => {
+            clearTimeout(timer);
+            reject(new PdfConversionError(`Could not run ${command}: ${error.message}`));
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            resolve({ code, stderr });
+        });
+    });
+}
+/** Environment variables that name a browser, in the order they are honoured. */
+const BROWSER_ENV_VARS = ['OPEN_NAV_BROWSER', 'CHROME_PATH', 'PUPPETEER_EXECUTABLE_PATH'];
+const EXECUTABLE_NAMES = [
+    'google-chrome-stable',
+    'google-chrome',
+    'chromium-browser',
+    'chromium',
+    'microsoft-edge',
+    'chrome',
+];
+const WELL_KNOWN_PATHS = [
+    // macOS
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+    '/Applications/Chromium.app/Contents/MacOS/Chromium',
+    '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+    // Linux
+    '/usr/bin/google-chrome-stable',
+    '/usr/bin/google-chrome',
+    '/usr/bin/chromium-browser',
+    '/usr/bin/chromium',
+    '/usr/bin/microsoft-edge',
+    '/snap/bin/chromium',
+    // Windows
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+];
+/**
+ * Locate a browser able to print to PDF.
+ *
+ * Order: an explicit environment variable, a Playwright install, the usual
+ * install locations, then `PATH`.
+ *
+ * `searchPaths` replaces that third step. It exists because the usual
+ * locations are absolute paths on the host, so no value of `env` can describe
+ * a machine without a browser — which is exactly what the failure path has to
+ * be tested against.
+ */
+export function findBrowser(env = process.env, searchPaths = WELL_KNOWN_PATHS) {
+    for (const name of BROWSER_ENV_VARS) {
+        const candidate = env[name];
+        if (candidate && existsSync(candidate))
+            return candidate;
+    }
+    const fromPlaywright = findPlaywrightChromium(env['PLAYWRIGHT_BROWSERS_PATH']);
+    if (fromPlaywright)
+        return fromPlaywright;
+    for (const candidate of searchPaths) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    const pathEntries = (env['PATH'] ?? '').split(process.platform === 'win32' ? ';' : ':');
+    for (const directory of pathEntries) {
+        if (!directory)
+            continue;
+        for (const name of EXECUTABLE_NAMES) {
+            const candidate = join(directory, name);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+/**
+ * Playwright keeps its browsers in a versioned directory, so the exact path
+ * is not predictable and has to be discovered.
+ */
+function findPlaywrightChromium(browsersPath) {
+    if (!browsersPath || !existsSync(browsersPath))
+        return undefined;
+    const candidates = [];
+    let entries;
+    try {
+        entries = readdirSync(browsersPath);
+    }
+    catch {
+        return undefined;
+    }
+    for (const entry of entries) {
+        if (!entry.startsWith('chromium'))
+            continue;
+        candidates.push(join(browsersPath, entry, 'chrome-linux', 'chrome'), join(browsersPath, entry, 'chrome-mac', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'), join(browsersPath, entry, 'chrome-win', 'chrome.exe'));
+    }
+    // Prefer a full build over the headless shell: the shell cannot print.
+    candidates.sort((left, right) => Number(left.includes('headless')) - Number(right.includes('headless')));
+    return candidates.find((candidate) => existsSync(candidate));
+}
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

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

package/dist/theme.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Visual configuration for the invoice document.
+ *
+ * Every field is optional; what is left out falls back to a restrained
+ * default that prints well in black and white. Values that end up inside the
+ * stylesheet are validated rather than interpolated blindly — a theme is
+ * configuration, but configuration is still input.
+ */
+export interface InvoiceTheme {
+    /** Accent for headings, rules and the total. */
+    accentColor?: string;
+    /** Body text colour. */
+    inkColor?: string;
+    /** Secondary text: labels, references, the footer. */
+    mutedColor?: string;
+    /** Background of the markings panel. */
+    panelColor?: string;
+    /** Rules and borders. */
+    borderColor?: string;
+    /** CSS font stack. Give a real fallback chain; a PDF converter needs it. */
+    fontFamily?: string;
+    /** Base size, as a CSS length. Everything else scales from it. */
+    baseFontSize?: string;
+    /** Page size for `@page`, e.g. `A4` or `Letter`. */
+    pageSize?: string;
+    /** Page margin for `@page`, e.g. `16mm 14mm`. */
+    pageMargin?: string;
+    /** Logo shown in the header. Use `embedImage` to inline a local file. */
+    logo?: InvoiceLogo;
+    /** Extra lines in the supplier block: phone, email, web, registration. */
+    issuerContact?: string[];
+    /** Lines printed in the footer, e.g. payment terms or company details. */
+    footerLines?: string[];
+    /** Tint alternate table rows. Off by default; it prints heavier. */
+    zebraRows?: boolean;
+    /** Show the "rendered from reported data" note. Defaults to true. */
+    provenanceNote?: boolean;
+    /** Appended verbatim after the generated stylesheet. The escape hatch. */
+    customCss?: string;
+}
+export interface InvoiceLogo {
+    /**
+     * Image source: a `data:` URI, or an absolute URL.
+     *
+     * Prefer a data URI. An external URL leaves the document dependent on the
+     * network, which defeats archiving it as a single file and can quietly
+     * produce a logo-less PDF.
+     */
+    src: string;
+    /** Rendered width as a CSS length. Height follows the aspect ratio. */
+    width?: string;
+    /** Alternative text, for accessibility and for a failed image. */
+    alt?: string;
+}
+export interface ResolvedTheme extends Required<Omit<InvoiceTheme, 'logo' | 'customCss'>> {
+    logo?: InvoiceLogo;
+    customCss?: string;
+}
+export declare const DEFAULT_THEME: ResolvedTheme;
+export declare class ThemeError extends Error {
+}
+/** Fill in the defaults, validating everything that lands in the CSS. */
+export declare function resolveTheme(theme?: InvoiceTheme): ResolvedTheme;
+/** Largest logo we inline, before base64 expansion. */
+export declare const MAX_LOGO_BYTES: number;
+/**
+ * Read an image and return it as a `data:` URI.
+ *
+ * Inlining keeps the document self-contained, which is what makes it archive
+ * as one file and print the same offline.
+ */
+export declare function embedImage(filePath: string, contents?: Buffer): string;
+/**
+ * Load a theme from a JSON file.
+ *
+ * A `logoFile` field is read relative to the theme file and inlined, so a
+ * theme can be checked in next to its logo and stay portable.
+ */
+export declare function loadTheme(filePath: string, io?: {
+    readFile?: (path: string) => string;
+    readBinary?: (path: string) => Buffer;
+}): InvoiceTheme;
+/** Build the document stylesheet from a resolved theme. */
+export declare function buildStyles(theme: ResolvedTheme): string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yEAAyE;IACzE,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;IACvF,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,EAAE,aAc3B,CAAC;AAEF,qBAAa,UAAW,SAAQ,KAAK;CAAG;AA8BxC,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,GAAE,YAAiB,GAAG,aAAa,CAmCpE;AAiBD,uDAAuD;AACvD,eAAO,MAAM,cAAc,QAAkB,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBtE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAO,GACtF,YAAY,CAoBd;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA4ExD"}

package/dist/theme.js

@@ -0,0 +1,210 @@
+import { readFileSync } from 'node:fs';
+import { dirname, extname, resolve } from 'node:path';
+export const DEFAULT_THEME = {
+    accentColor: '#16181d',
+    inkColor: '#16181d',
+    mutedColor: '#5b6270',
+    panelColor: '#f4f5f8',
+    borderColor: '#c9cdd6',
+    fontFamily: '"Helvetica Neue", Arial, "Liberation Sans", sans-serif',
+    baseFontSize: '10pt',
+    pageSize: 'A4',
+    pageMargin: '16mm 14mm',
+    issuerContact: [],
+    footerLines: [],
+    zebraRows: false,
+    provenanceNote: true,
+};
+export class ThemeError extends Error {
+}
+/** Colours we accept: hex, rgb(), rgba(), hsl(), hsla(), or a CSS keyword. */
+const COLOR = /^(#[0-9a-fA-F]{3,8}|(rgb|hsl)a?\([0-9.,%\s/deg]+\)|[a-zA-Z]{3,20})$/;
+/** Lengths and simple length lists, e.g. `10pt` or `16mm 14mm`. */
+const LENGTH_LIST = /^[0-9.]+(px|pt|pc|mm|cm|in|em|rem|%)?( +[0-9.]+(px|pt|pc|mm|cm|in|em|rem|%)?){0,3}$/;
+/** Page sizes: a keyword, optionally with an orientation, or two lengths. */
+const PAGE_SIZE = /^([A-Za-z][A-Za-z0-9]{0,10}( +(portrait|landscape))?|[0-9.]+[a-z]{2} +[0-9.]+[a-z]{2})$/;
+/**
+ * A font stack: names, quotes, commas, spaces, hyphens.
+ *
+ * Parentheses are excluded deliberately. No font name contains one, and
+ * allowing them would admit `url(...)`, which is how a stylesheet is made to
+ * fetch something.
+ */
+const FONT_STACK = /^[-A-Za-z0-9 ,."']+$/;
+function check(value, pattern, field, expected) {
+    const trimmed = value.trim();
+    if (!pattern.test(trimmed)) {
+        throw new ThemeError(`theme.${field}: ${JSON.stringify(value)} is not ${expected}. ` +
+            `Values reach the stylesheet, so they are checked rather than trusted.`);
+    }
+    return trimmed;
+}
+/** Fill in the defaults, validating everything that lands in the CSS. */
+export function resolveTheme(theme = {}) {
+    const merged = { ...DEFAULT_THEME, ...stripUndefined(theme) };
+    for (const field of [
+        'accentColor',
+        'inkColor',
+        'mutedColor',
+        'panelColor',
+        'borderColor',
+    ]) {
+        merged[field] = check(merged[field], COLOR, field, 'a CSS colour');
+    }
+    merged.baseFontSize = check(merged.baseFontSize, LENGTH_LIST, 'baseFontSize', 'a CSS length');
+    merged.pageMargin = check(merged.pageMargin, LENGTH_LIST, 'pageMargin', 'a CSS length');
+    merged.pageSize = check(merged.pageSize, PAGE_SIZE, 'pageSize', 'a CSS page size');
+    merged.fontFamily = check(merged.fontFamily, FONT_STACK, 'fontFamily', 'a CSS font stack');
+    if (merged.logo) {
+        const src = merged.logo.src.trim();
+        if (!/^(data:image\/[a-z+.-]+;base64,[A-Za-z0-9+/=]+|https?:\/\/\S+)$/.test(src)) {
+            throw new ThemeError('theme.logo.src must be a data: image URI or an http(s) URL. ' +
+                'Use embedImage() to inline a local file.');
+        }
+        merged.logo = {
+            src,
+            ...(merged.logo.width
+                ? { width: check(merged.logo.width, LENGTH_LIST, 'logo.width', 'a CSS length') }
+                : {}),
+            ...(merged.logo.alt ? { alt: merged.logo.alt } : {}),
+        };
+    }
+    return merged;
+}
+function stripUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+const MIME_TYPES = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+};
+/** Largest logo we inline, before base64 expansion. */
+export const MAX_LOGO_BYTES = 2 * 1024 * 1024;
+/**
+ * Read an image and return it as a `data:` URI.
+ *
+ * Inlining keeps the document self-contained, which is what makes it archive
+ * as one file and print the same offline.
+ */
+export function embedImage(filePath, contents) {
+    const extension = extname(filePath).toLowerCase();
+    const mime = MIME_TYPES[extension];
+    if (!mime) {
+        throw new ThemeError(`Unsupported image type ${extension || filePath}. Supported: ${Object.keys(MIME_TYPES).join(', ')}`);
+    }
+    const bytes = contents ?? readFileSync(filePath);
+    if (bytes.length > MAX_LOGO_BYTES) {
+        throw new ThemeError(`${filePath} is ${Math.round(bytes.length / 1024)} kB; the limit is ${MAX_LOGO_BYTES / 1024} kB. ` +
+            `A logo this large bloats every document it appears in.`);
+    }
+    return `data:${mime};base64,${bytes.toString('base64')}`;
+}
+/**
+ * Load a theme from a JSON file.
+ *
+ * A `logoFile` field is read relative to the theme file and inlined, so a
+ * theme can be checked in next to its logo and stay portable.
+ */
+export function loadTheme(filePath, io = {}) {
+    const readFile = io.readFile ?? ((path) => readFileSync(path, 'utf8'));
+    let parsed;
+    try {
+        parsed = JSON.parse(readFile(filePath));
+    }
+    catch (cause) {
+        throw new ThemeError(`${filePath} is not valid JSON: ${cause.message}`);
+    }
+    const { logoFile, ...theme } = parsed;
+    if (logoFile) {
+        const imagePath = resolve(dirname(filePath), logoFile);
+        const readBinary = io.readBinary ?? ((path) => readFileSync(path));
+        theme.logo = {
+            ...theme.logo,
+            src: embedImage(imagePath, readBinary(imagePath)),
+        };
+    }
+    return theme;
+}
+/** Build the document stylesheet from a resolved theme. */
+export function buildStyles(theme) {
+    return `<style>
+  @page { size: ${theme.pageSize}; margin: ${theme.pageMargin}; }
+  :root {
+    --accent: ${theme.accentColor};
+    --ink: ${theme.inkColor};
+    --muted: ${theme.mutedColor};
+    --rule: ${theme.borderColor};
+    --panel: ${theme.panelColor};
+  }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0;
+    color: var(--ink);
+    font: ${theme.baseFontSize}/1.45 ${theme.fontFamily};
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
+  }
+  .invoice { max-width: 190mm; margin: 0 auto; padding: 8mm 0; }
+  .page-break { page-break-after: always; }
+
+  header { display: flex; justify-content: space-between; align-items: flex-start; gap: 12mm; }
+  .brand { display: flex; flex-direction: column; gap: 3mm; }
+  .logo { display: block; max-width: 70mm; max-height: 26mm; }
+  h1 { margin: 0; font-size: 2em; letter-spacing: 0.08em; font-weight: 700; color: var(--accent); }
+  .subtitle { color: var(--muted); font-size: 0.9em; margin-top: 2mm; }
+  .meta { text-align: right; font-size: 0.95em; min-width: 64mm; }
+  .meta div { margin-bottom: 1mm; }
+  .meta .value { font-weight: 700; white-space: nowrap; }
+
+  .parties { display: flex; gap: 6mm; margin: 7mm 0; }
+  .party { flex: 1; border: 1px solid var(--rule); border-radius: 2mm; padding: 4mm; }
+  .party h2 {
+    margin: 0 0 2mm; font-size: 0.8em; text-transform: uppercase;
+    letter-spacing: 0.1em; color: var(--muted); font-weight: 700;
+  }
+  .party .name { font-weight: 700; font-size: 1.1em; margin-bottom: 1mm; }
+  .party .address { font-size: 0.9em; margin-bottom: 1.5mm; }
+  .party dl { margin: 2mm 0 0; display: grid; grid-template-columns: auto 1fr; gap: 0.6mm 3mm; font-size: 0.9em; }
+  .party dt { color: var(--muted); }
+  .party dd { margin: 0; }
+  .party .contact { margin-top: 2mm; font-size: 0.9em; color: var(--muted); }
+
+  table { width: 100%; border-collapse: collapse; font-size: 0.9em; }
+  thead th {
+    text-align: left; font-size: 0.8em; text-transform: uppercase; letter-spacing: 0.06em;
+    color: var(--muted); border-bottom: 1px solid var(--rule); padding: 2mm 1.5mm;
+  }
+  tbody td { padding: 2mm 1.5mm; border-bottom: 1px solid var(--rule); vertical-align: top; }
+  ${theme.zebraRows ? 'tbody tr:nth-child(even) td { background: var(--panel); }' : ''}
+  .num { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
+
+  .totals { display: flex; justify-content: flex-end; margin-top: 5mm; }
+  .totals table { width: auto; min-width: 80mm; }
+  .totals td { padding: 1.5mm 2mm; border: none; background: none; }
+  .totals .grand td {
+    border-top: 1.5px solid var(--accent); color: var(--accent);
+    font-weight: 700; font-size: 1.15em; padding-top: 2.5mm;
+  }
+
+  .vat-summary { margin-top: 6mm; }
+  .vat-summary h2, .markings h2 {
+    font-size: 0.8em; text-transform: uppercase; letter-spacing: 0.1em;
+    color: var(--muted); margin: 0 0 2mm; font-weight: 700;
+  }
+  .markings { margin-top: 6mm; background: var(--panel); border-radius: 2mm; padding: 4mm; }
+  .markings ul { margin: 0; padding-left: 4mm; }
+  .markings li { margin-bottom: 1mm; }
+  .markings .reference { color: var(--muted); font-size: 0.85em; }
+  .note { margin-top: 5mm; font-size: 0.9em; }
+  footer {
+    margin-top: 8mm; color: var(--muted); font-size: 0.8em;
+    border-top: 1px solid var(--rule); padding-top: 2mm;
+  }
+  footer div { margin-bottom: 0.8mm; }
+${theme.customCss ? `\n  /* customCss */\n${theme.customCss}\n` : ''}</style>`;
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

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