blitz-pdf 0.0.0-stage → 0.1.0

package/dist/options.js

@@ -0,0 +1,135 @@
+import { assetBytes, copyBytes, MAX_ASSET_BYTES } from "./assets.js";
+const formats = {
+    A3: [297 * 96 / 25.4, 420 * 96 / 25.4],
+    A4: [210 * 96 / 25.4, 297 * 96 / 25.4],
+    A5: [148 * 96 / 25.4, 210 * 96 / 25.4],
+    Letter: [8.5 * 96, 11 * 96], Legal: [8.5 * 96, 14 * 96], Tabloid: [11 * 96, 17 * 96],
+};
+const optionKeys = new Set(["format", "width", "height", "landscape", "margin", "media", "baseUrl", "assets", "fonts", "title", "pageNumbers", "maxPages"]);
+const unitScale = { px: 1, pt: 96 / 72, mm: 96 / 25.4, cm: 96 / 2.54, in: 96 };
+function length(value, name) {
+    let result;
+    if (typeof value === "number")
+        result = value;
+    else if (typeof value === "string") {
+        const match = /^\s*(\d+(?:\.\d+)?|\.\d+)(px|pt|mm|cm|in)\s*$/.exec(value);
+        if (!match)
+            throw new TypeError(`${name} must be a number of CSS pixels or a length in px, pt, mm, cm, or in`);
+        result = Number(match[1]) * unitScale[match[2]];
+    }
+    else
+        throw new TypeError(`${name} must be a CSS length`);
+    if (!Number.isFinite(result) || result < 0)
+        throw new RangeError(`${name} must be finite and non-negative`);
+    return result;
+}
+function record(value, name) {
+    if (value === null || typeof value !== "object" || Array.isArray(value) ||
+        ![Object.prototype, null].includes(Object.getPrototypeOf(value))) {
+        throw new TypeError(`${name} must be a plain object`);
+    }
+}
+export function normalizeOptions(options = {}) {
+    record(options, "options");
+    for (const key of Object.keys(options)) {
+        if (!optionKeys.has(key))
+            throw new TypeError(`Unknown PDF option: ${key}`);
+    }
+    if (options.landscape !== undefined && typeof options.landscape !== "boolean")
+        throw new TypeError("landscape must be a boolean");
+    const format = options.format ?? "A4";
+    if (!Object.hasOwn(formats, format))
+        throw new TypeError(`Unknown page format: ${String(format)}`);
+    if ((options.width === undefined) !== (options.height === undefined))
+        throw new TypeError("width and height must be provided together");
+    if (options.format !== undefined && options.width !== undefined)
+        throw new TypeError("Use either format or custom width and height");
+    let [width, height] = options.width === undefined
+        ? formats[format] : [length(options.width, "width"), length(options.height, "height")];
+    if (options.landscape)
+        [width, height] = [height, width];
+    if (width <= 0 || height <= 0 || width > 19200 || height > 19200)
+        throw new RangeError("Page dimensions must be positive and at most 19200 CSS pixels");
+    const inputMargin = options.margin ?? 0;
+    const margin = { top: 0, right: 0, bottom: 0, left: 0 };
+    if (typeof inputMargin === "object") {
+        record(inputMargin, "margin");
+        for (const key of Object.keys(inputMargin))
+            if (!Object.hasOwn(margin, key))
+                throw new TypeError(`Unknown margin side: ${key}`);
+        for (const side of Object.keys(margin))
+            margin[side] = length(inputMargin[side] ?? 0, `margin.${side}`);
+    }
+    else {
+        const value = length(inputMargin, "margin");
+        for (const side of Object.keys(margin))
+            margin[side] = value;
+    }
+    let pageNumbers = null;
+    if (options.pageNumbers !== undefined && options.pageNumbers !== false) {
+        const input = options.pageNumbers === true ? {} : options.pageNumbers;
+        record(input, "pageNumbers");
+        for (const key of Object.keys(input))
+            if (!["template", "align", "fontSize"].includes(key))
+                throw new TypeError(`Unknown pageNumbers option: ${key}`);
+        const template = input.template ?? "{page} / {pages}";
+        if (typeof template !== "string" || template.length > 512 || /[\u0000-\u001f\u007f\u0085\u2028\u2029]/u.test(template))
+            throw new TypeError("pageNumbers.template must be a single line of at most 512 characters");
+        if (!template.includes("{page}") || /[{}]/.test(template.replaceAll("{page}", "").replaceAll("{pages}", "")))
+            throw new TypeError("pageNumbers.template must include {page}; only {page} and {pages} placeholders are supported");
+        const align = input.align ?? "right";
+        if (!["left", "center", "right"].includes(align))
+            throw new TypeError("pageNumbers.align must be left, center, or right");
+        const fontSize = length(input.fontSize ?? 12, "pageNumbers.fontSize");
+        if (fontSize < 1 || fontSize > 48)
+            throw new RangeError("pageNumbers.fontSize must be between 1 and 48 CSS pixels");
+        pageNumbers = { template, align, fontSize };
+    }
+    const footerHeight = pageNumbers ? pageNumbers.fontSize * 2 + 8 : 0;
+    if (width - margin.left - margin.right < 1 || height - margin.top - margin.bottom - footerHeight < 1)
+        throw new RangeError("Margins and pageNumbers must leave at least one CSS pixel of content");
+    const media = options.media ?? "print";
+    if (media !== "print" && media !== "screen")
+        throw new TypeError("media must be print or screen");
+    const maxPages = options.maxPages ?? 100;
+    if (!Number.isInteger(maxPages) || maxPages < 1 || maxPages > 1000)
+        throw new RangeError("maxPages must be an integer between 1 and 1000");
+    if (options.title !== undefined && typeof options.title !== "string")
+        throw new TypeError("title must be a string");
+    const baseUrl = options.baseUrl ?? "https://blitz-pdf.invalid/";
+    if (typeof baseUrl !== "string")
+        throw new TypeError("baseUrl must be an absolute URL string");
+    let base;
+    try {
+        base = new URL(baseUrl);
+    }
+    catch {
+        throw new TypeError("baseUrl must be an absolute URL string");
+    }
+    if (!["http:", "https:", "file:"].includes(base.protocol))
+        throw new TypeError("baseUrl must use http:, https:, or file:");
+    const assets = Object.create(null);
+    const inputAssets = options.assets;
+    const assetResolver = typeof inputAssets === "function" ? inputAssets : undefined;
+    if (inputAssets !== undefined && !assetResolver) {
+        record(inputAssets, "assets");
+        let size = 0;
+        for (const [key, value] of Object.entries(inputAssets)) {
+            const data = assetBytes(value, `assets[${key}]`);
+            size += data.byteLength;
+            if (size > MAX_ASSET_BYTES)
+                throw new RangeError("Assets exceed the 64 MiB limit");
+            const url = new URL(key, base).href;
+            if (Object.hasOwn(assets, url))
+                throw new TypeError(`Duplicate resolved asset URL: ${url}`);
+            assets[url] = data;
+        }
+    }
+    if (options.fonts !== undefined && !Array.isArray(options.fonts))
+        throw new TypeError("fonts must be an array of font bytes");
+    const fonts = (options.fonts ?? []).map((font, i) => copyBytes(font, `fonts[${i}]`));
+    if (fonts.reduce((total, font) => total + font.byteLength, 0) > 32 * 1024 * 1024)
+        throw new RangeError("Fonts exceed the 32 MiB limit");
+    return { width, height, margin, media, maxPages, baseUrl: base.href, assets, assetResolver, fonts, pageNumbers, title: options.title ?? null };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+/** Numbers are CSS pixels (96 px = 1 inch). */
+export type Length = number | `${number}${"px" | "pt" | "mm" | "cm" | "in"}`;
+export type PageFormat = "A3" | "A4" | "A5" | "Letter" | "Legal" | "Tabloid";
+export type BinaryData = Uint8Array | ArrayBuffer;
+/** UTF-8 text (for CSS/SVG) or binary resource contents. */
+export type AssetData = BinaryData | string;
+export type AssetMap = Record<string, AssetData>;
+/** Receives an absolute URL. Returning null/undefined rejects the render as a missing asset. */
+export type AssetResolver = (url: string) => AssetData | null | undefined | Promise<AssetData | null | undefined>;
+export type WasmSource = BinaryData | WebAssembly.Module | URL | Request | Response | string;
+export interface InitOptions {
+    /** Override the bundled WASM location, or supply bytes/a compiled module. */
+    wasm?: WasmSource;
+}
+export interface PageNumberOptions {
+    /** Single line with {page} and optionally {pages}. Default: "{page} / {pages}". */
+    template?: string;
+    /** Default: right. */
+    align?: "left" | "center" | "right";
+    /** Default: 12 CSS pixels (9pt). */
+    fontSize?: Length;
+}
+export interface PdfOptions {
+    /** Default: A4. Use width and height together for a custom page. */
+    format?: PageFormat;
+    width?: Length;
+    height?: Length;
+    landscape?: boolean;
+    /** Default: 0. Missing sides of an object default to 0. */
+    margin?: Length | {
+        top?: Length;
+        right?: Length;
+        bottom?: Length;
+        left?: Length;
+    };
+    /** CSS media queries to use. Default: print. */
+    media?: "print" | "screen";
+    /** Base for resolving asset URLs. Default: https://blitz-pdf.invalid/ */
+    baseUrl?: string;
+    /** Resource map or async loader, called once per absolute URL per render. Data URLs are handled internally. */
+    assets?: AssetMap | AssetResolver;
+    /** Additional static TTF, OTF, WOFF, or WOFF2 fonts, using their internal family names. */
+    fonts?: readonly BinaryData[];
+    /** PDF document title. */
+    title?: string;
+    /** Selectable page-number footer. Reserves space above the bottom margin. Default: false. */
+    pageNumbers?: boolean | PageNumberOptions;
+    /** Reject larger documents. Default: 100; maximum: 1000. */
+    maxPages?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAClD,4DAA4D;AAC5D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACjD,gGAAgG;AAChG,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAClH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7F,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IAEzB,oEAAoE;IACpE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+GAA+G;IAC/G,MAAM,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAClC,2FAA2F;IAC3F,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,WAAW,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/bun.ts

@@ -0,0 +1,8 @@
+import { mkdir } from "node:fs/promises";
+import { renderPdf } from "blitz-pdf";
+
+const html = await Bun.file(new URL("./invoice.html", import.meta.url)).text();
+const pdf = await renderPdf(html, { format: "A4", margin: "18mm", title: "Invoice INV-0042" });
+await mkdir(new URL("../output/pdf/", import.meta.url), { recursive: true });
+await Bun.write(new URL("../output/pdf/invoice.pdf", import.meta.url), pdf);
+console.log(`Created output/pdf/invoice.pdf (${pdf.length} bytes).`);

package/examples/german-invoice/README.md

@@ -0,0 +1,70 @@
+# German invoice example
+
+Run `npm run example:german-invoice` from the project root, or
+`bun examples/german-invoice.mjs`. Output: `output/pdf/german-invoice.pdf`.
+
+The sample contains three A4 pages and 24 software project services. It uses
+the public `renderPdf` API, an async stylesheet loader, CSS page breaks between
+project sections, protected table rows, and automatic page-number footers.
+No PDF editing step is needed after rendering. Numbers, invoice text, and
+amounts remain selectable; the output targets PDF/A-3u without XML attachments.
+
+Edit `data.mjs` for invoice data, `template.mjs` for HTML, and `invoice.css`
+for appearance. `invoiceOptions()` configures margins and page numbers.
+Page totals are computed by the renderer; they are never hard-coded in the
+HTML. Longer content can add pages automatically. Each project section starts
+on a new page; table headings are authored once per section. Automatic repeated
+table headers across additional overflow pages are not currently supported.
+
+Amounts are integer cents. Quantities are hundredths of an hour, and rates are
+basis points (1900 = 19%). Each line is rounded half-up, then the discount is
+rounded on the subtotal and VAT on the discounted net amount. The generated
+`german-invoice-totals.json` contains every line and intermediate value.
+
+| Amount | EUR |
+| --- | ---: |
+| Services before discount | 22.205,00 |
+| Agreed project discount, 3% | -666,15 |
+| Taxable net, 19% rate | 21.538,85 |
+| VAT, 19% | 4.092,38 |
+| Amount payable | **25.631,23** |
+
+## Scope of the sample
+
+All companies, people, addresses, tax and register identifiers, and bank details
+are fictitious demonstration data. The PDF is marked “Musterrechnung” and
+“Nicht zur Zahlung bestimmt”; it does not issue a real invoice. Replace the
+sample identifiers with the actual supplier's registered details in a real
+application. The demonstration bank details do not identify a payable account.
+
+The scenario is an ordinary domestic German B2B service invoice dated
+13 October 2026, covering services performed from 1 to 30 September 2026, with
+19% standard VAT and a previously agreed discount. It demonstrates the relevant
+mandatory information: full supplier/customer names and addresses, supplier
+VAT ID, issue date, a sample unique invoice number, type and extent of services,
+performance period, discounted taxable net, tax rate and tax amount.
+[§ 14(4) UStG](https://www.gesetze-im-internet.de/ustg_1980/__14.html),
+[§ 12(1) UStG](https://www.gesetze-im-internet.de/ustg_1980/__12.html).
+
+The supplier block also includes the GmbH's seat, register court and number,
+and managing director. The fictitious company has no supervisory board.
+[§ 35a GmbHG](https://www.gesetze-im-internet.de/gmbhg/__35a.html).
+
+PDF/A describes the file's archival format. This example contains no structured
+invoice XML and makes no ZUGFeRD, XRechnung or EN 16931 claim. For the stated
+2026 scenario, PDF delivery assumes the recipient's consent under the transition
+rule. That assumption is not an exemption for every future invoice. Different
+transactions, including reverse charge, exemptions and advance payments, need
+their applicable invoice treatment.
+[§ 27(38) UStG](https://www.gesetze-im-internet.de/ustg_1980/__27.html).
+
+## Verification
+
+`bun test` checks the arithmetic, required sample fields, all 24 rows on their
+intended pages, correct footers, selectable text, absence of raster pages and
+XML attachments, and spacing between body text and footers.
+
+`npm run test:pdfa` captures the invoice along with the other integration PDFs
+and validates them using veraPDF's PDF/A-3u profile. The validation reports are
+under `output/pdfa-validation/`. The content tests check this example's fields
+and calculations; the archival validator does not certify tax-law compliance.

package/examples/german-invoice/data.mjs

@@ -0,0 +1,83 @@
+// Entirely fictitious demonstration data. No invoice is issued by this example.
+export const invoice = {
+  number: "RE-2026-1042",
+  issueDate: "2026-10-13",
+  dueDate: "2026-10-27",
+  serviceFrom: "2026-09-01",
+  serviceTo: "2026-09-30",
+  customerNumber: "KD-2087",
+  orderNumber: "EW-2026-0831",
+  project: "Kundenportal und Bestellverwaltung",
+  supplier: {
+    name: "Musterwerk Digital GmbH", street: "Musterstraße 14", city: "10115 Berlin", country: "Deutschland",
+    vatId: "DE123456788", managingDirector: "Clara Muster", register: "Amtsgericht Charlottenburg, HRB 999999 B",
+    email: "rechnung@musterwerk.example", website: "musterwerk.example",
+    bank: "Beispielbank (Musterdaten)", iban: "DE36 0000 0000 0000 0000 00", bic: "TESTDE00XXX",
+  },
+  customer: { name: "Elbwiese Handels GmbH", department: "Finanzbuchhaltung", street: "Beispielweg 8", city: "20457 Hamburg", country: "Deutschland" },
+  // All services in this domestic B2B example use the standard 19% VAT rate.
+  vatBasisPoints: 1900,
+  discountBasisPoints: 300,
+  sections: [
+    { title: "Konzeption und Gestaltung", subtitle: "Anforderungen, Abläufe und verbindliche Gestaltungsvorlagen", items: [
+      ["01", "Projektauftakt und Zielbild", "Workshop mit Vertrieb, Service und IT; dokumentierte Ziele und Abnahmekriterien.", 400, 13500],
+      ["02", "Anforderungsanalyse", "Aufnahme von Rollen, Bestellabläufen und Freigaben; abgestimmter Anforderungskatalog.", 650, 13500],
+      ["03", "Informationsarchitektur", "Struktur für Kundenkonten, Bestellungen, Dokumente und interne Bearbeitung.", 500, 12500],
+      ["04", "Prozessmodellierung", "Abläufe für Angebot, Bestellung und Statusmeldungen inklusive Sonderfällen.", 550, 12500],
+      ["05", "Interaktiver Prototyp", "Klickbarer Entwurf der zentralen Ansichten für Desktop und Mobilgeräte.", 800, 12500],
+      ["06", "Gestaltung der Oberfläche", "Ausarbeitung von Navigation, Formularen und Tabellen im vereinbarten Erscheinungsbild.", 900, 12500],
+    ] },
+    { title: "Umsetzung und Integration", subtitle: "Designsystem, Funktionen und Anbindung an bestehende Abläufe", items: [
+      ["07", "Komponentenbibliothek", "Wiederverwendbare Schaltflächen, Eingaben, Hinweise und Statusanzeigen.", 700, 12500],
+      ["08", "Designabstimmung", "Zwei gemeinsame Durchsprachen einschließlich dokumentierter Korrekturen.", 350, 12500],
+      ["09", "Projektgrundlage und Entwicklungsumgebung", "Repository, Build-Prozess sowie getrennte Entwicklungs- und Testumgebungen.", 500, 13500],
+      ["10", "Anmeldung und Rollenverwaltung", "Geschützte Anmeldung, Passwortzurücksetzung und abgestimmte Rollenrechte.", 1050, 13500],
+      ["11", "Kundenstammdaten", "Pflege von Kontaktdaten und Lieferadressen einschließlich Eingabeprüfung.", 800, 12500],
+      ["12", "Produkt- und Preisdaten", "Übernahme des vereinbarten Artikelsortiments und kundenspezifischer Preise.", 950, 13500],
+      ["13", "Bestellerfassung", "Warenkorb, Mengenprüfung und Erfassung interner Bestellreferenzen.", 1200, 13500],
+      ["14", "Freigabeprozess", "Mehrstufige Freigaben, Rückfragen und nachvollziehbare Statusübergänge.", 1000, 13500],
+      ["15", "Schnittstelle zur Warenwirtschaft", "Übertragung von Bestellungen und Rückübernahme vereinbarter Statusdaten.", 1400, 15000],
+      ["16", "Dokumentenübersicht", "Zuordnung und geschützter Abruf von Angeboten, Auftragsbestätigungen und Rechnungen.", 750, 12500],
+      ["17", "Benachrichtigungen", "Vorlagen und Versandlogik für Bestelleingang, Rückfragen und Freigaben.", 550, 12500],
+      ["18", "Responsive Umsetzung", "Anpassung der freigegebenen Ansichten an Smartphone, Tablet und Desktop.", 800, 12500],
+    ] },
+    { title: "Qualitätssicherung und Übergabe", subtitle: "Prüfung, Abnahme und Einführung des vereinbarten Lieferumfangs", items: [
+      ["19", "Automatisierte Funktionstests", "Tests der zentralen Bestell-, Freigabe- und Berechtigungsabläufe.", 850, 12500],
+      ["20", "Barrierearme Bedienung", "Prüfung von Tastaturbedienung, Fokusführung und Formularbeschriftungen.", 450, 11000],
+      ["21", "Leistungs- und Sicherheitstests", "Abgestimmte Lastfälle sowie Prüfung von Zugriffsschutz und Fehlermeldungen.", 600, 13500],
+      ["22", "Abnahme und Nacharbeiten", "Begleitung der fachlichen Abnahme und Bearbeitung des vereinbarten Prüfprotokolls.", 550, 12500],
+      ["23", "Dokumentation und Schulung", "Betriebshandbuch und gemeinsame Einführung der zuständigen Mitarbeitenden.", 400, 11000],
+      ["24", "Produktivsetzung und Übergabe", "Bereitstellung, Funktionskontrolle und dokumentierte Übergabe am 30.09.2026.", 350, 13500],
+    ] },
+  ],
+};
+
+// Tuple columns: position, name, description, hundredths of an hour, net unit price in cents.
+// Integer arithmetic and half-up rounding keep amounts deterministic in Node, Bun and browsers.
+function roundedRatio(amount, numerator, denominator) {
+  const result = (BigInt(amount) * BigInt(numerator) + BigInt(denominator) / 2n) / BigInt(denominator);
+  if (result > BigInt(Number.MAX_SAFE_INTEGER)) throw new RangeError("Example invoice amount is too large");
+  return Number(result);
+}
+
+export function calculateInvoice(data = invoice) {
+  let subtotalCents = 0;
+  const sections = data.sections.map(section => {
+    const carriedCents = subtotalCents;
+    const items = section.items.map(([position, name, description, quantityHundredths, unitPriceCents]) => {
+      if (!Number.isSafeInteger(quantityHundredths) || quantityHundredths <= 0 || !Number.isSafeInteger(unitPriceCents) || unitPriceCents < 0) throw new TypeError("Invoice quantities and prices must be non-negative fixed-point integers");
+      const netCents = roundedRatio(quantityHundredths, unitPriceCents, 100);
+      subtotalCents += netCents;
+      if (!Number.isSafeInteger(subtotalCents)) throw new RangeError("Example invoice amount is too large");
+      return { position, name, description, quantityHundredths, unitPriceCents, netCents };
+    });
+    return { ...section, items, carriedCents, cumulativeCents: subtotalCents };
+  });
+  for (const rate of [data.discountBasisPoints, data.vatBasisPoints]) {
+    if (!Number.isInteger(rate) || rate < 0 || rate > 10000) throw new RangeError("Invoice rates must be between 0 and 10000 basis points");
+  }
+  const discountCents = roundedRatio(subtotalCents, data.discountBasisPoints, 10000);
+  const netCents = subtotalCents - discountCents;
+  const vatCents = roundedRatio(netCents, data.vatBasisPoints, 10000);
+  return { sections, subtotalCents, discountCents, netCents, vatCents, totalCents: netCents + vatCents };
+}

package/examples/german-invoice/invoice.css

@@ -0,0 +1,59 @@
+* { box-sizing: border-box; }
+body { margin: 0; color: #172d3b; font: 11px/1.45 sans-serif; }
+.masthead, .brand, .address-row, .title-row, .invoice-meta, .section-heading, .carry, .settlement, .bank, .continuation-header { display: flex; }
+.masthead { justify-content: space-between; align-items: center; border-bottom: 2px solid #167d8d; padding-bottom: 15px; }
+.brand { align-items: center; gap: 12px; }
+.brand-mark { display: block; color: white; background: #167d8d; border-radius: 8px; font-size: 27px; font-weight: bold; line-height: 42px; text-align: center; width: 42px; height: 42px; }
+.brand strong { font-size: 21px; letter-spacing: 1px; }
+.brand small { display: block; color: #637480; font-size: 10px; }
+.contact { color: #637480; text-align: right; }
+.sample-note { margin-top: 10px; color: #637480; font-size: 9px; letter-spacing: .3px; }
+.address-row { justify-content: space-between; margin: 22px 0 20px; }
+.sender-line { margin: 0 0 12px; font-size: 8px; color: #637480; }
+address { font-style: normal; font-size: 12px; line-height: 1.55; }
+.supplier-address { font-size: 10px; line-height: 1.65; }
+.title-row { align-items: baseline; justify-content: space-between; }
+h1 { margin: 0; font-size: 31px; line-height: 1.2; }
+.title-row > span { font-weight: bold; font-size: 16px; }
+.invoice-meta { margin-top: 15px; padding: 12px 14px; background: #edf5f5; justify-content: space-between; }
+.invoice-meta span, .bank span { display: block; font-size: 9px; color: #637480; margin-bottom: 3px; }
+.project { margin: 16px 0 18px; line-height: 1.65; }
+.project > strong { font-size: 12px; }
+.continuation { break-before: page; }
+.continuation-header { justify-content: space-between; align-items: center; border-bottom: 2px solid #167d8d; padding-bottom: 16px; margin-bottom: 24px; }
+.continuation-header > strong { font-size: 18px; }
+.continuation-header > strong > span { font-size: 11px; font-weight: normal; }
+.continuation-header > div { text-align: right; font-size: 10px; }
+.section-heading { align-items: center; gap: 12px; margin: 0 0 12px; break-after: avoid; }
+.section-index { color: #167d8d; font-size: 26px; line-height: 1; font-weight: bold; }
+h2 { font-size: 14px; line-height: 1.3; margin: 0 0 3px; }
+.section-heading p { margin: 0; font-size: 10px; color: #637480; }
+table { width: 100%; border-collapse: collapse; }
+.col-position { width: 6%; } .col-description { width: 49%; } .col-quantity { width: 10%; } .col-unit { width: 16%; } .col-total { width: 19%; }
+th { padding: 8px 6px; border-bottom: 1px solid #aac6cc; background: #edf5f5; color: #43616e; font-size: 9px; font-weight: bold; text-align: left; }
+.items td { vertical-align: top; padding: 9px 6px; border-bottom: 1px solid #dce6e8; }
+.items tbody tr { break-inside: avoid; }
+.items td strong { font-size: 10px; font-weight: bold; }
+.description { margin-top: 3px; font-size: 9px; color: #637480; line-height: 1.45; }
+.position { font-size: 10px; color: #637480; }
+.numeric { text-align: right; white-space: nowrap; font-size: 10px; }
+.amount { font-weight: bold; }
+.carry { justify-content: space-between; padding: 9px 6px; font-size: 10px; border-top: 1px solid #dce6e8; }
+.after-table { border-top: 0; background: #f4f7f8; }
+.continuation-note { font-size: 9px; color: #637480; margin: 13px 0 22px; }
+.company-details { border-top: 1px solid #dce6e8; padding-top: 10px; color: #637480; font-size: 8px; line-height: 1.65; break-inside: avoid; }
+.settlement { gap: 28px; margin-top: 20px; align-items: flex-start; break-inside: avoid; }
+.tax-note { flex: 1; color: #637480; font-size: 9px; }
+.tax-note > strong { color: #172d3b; font-size: 11px; }
+.tax-note p { margin: 8px 0 0; }
+.totals { width: 62%; font-size: 11px; }
+.totals td { padding: 5px 0; }
+.totals td:last-child { text-align: right; white-space: nowrap; font-weight: bold; }
+.totals .net td { border-top: 1px solid #dce6e8; padding-top: 9px; }
+.totals .grand-total td { padding: 12px 0; font-size: 16px; color: #126a78; border-top: 2px solid #167d8d; }
+.payment { background: #edf5f5; padding: 14px 16px; margin-top: 18px; break-inside: avoid; }
+h3 { font-size: 11px; margin: 0; }
+.payment p { margin: 7px 0 12px; font-size: 10px; line-height: 1.6; }
+.bank { justify-content: space-between; gap: 10px; font-size: 9px; }
+.closing { margin: 18px 0; font-size: 10px; }
+p { widows: 2; orphans: 2; }

package/examples/german-invoice/template.mjs

@@ -0,0 +1,49 @@
+import { invoice, calculateInvoice } from "./data.mjs";
+
+export const money = cents => new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(cents / 100);
+const quantity = hundredths => new Intl.NumberFormat("de-DE", { minimumFractionDigits: 2, maximumFractionDigits: 2 }).format(hundredths / 100);
+const percent = basisPoints => new Intl.NumberFormat("de-DE", { maximumFractionDigits: 2 }).format(basisPoints / 100) + " %";
+const date = value => value.split("-").reverse().join(".");
+const escape = value => String(value).replace(/[&<>"']/g, ch => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[ch]);
+const e = escape;
+
+export function invoiceOptions(data = invoice) {
+  return {
+    format: "A4", margin: { top: "16mm", right: "17mm", bottom: "12mm", left: "17mm" },
+    title: `Musterrechnung ${data.number} - ${data.customer.name}`,
+    pageNumbers: { template: `${data.number} · Musterrechnung · Seite {page} von {pages}`, fontSize: "8pt", align: "right" },
+  };
+}
+
+export function createInvoiceHtml(data = invoice) {
+  const totals = calculateInvoice(data);
+  const s = data.supplier;
+  const c = data.customer;
+  const identity = `<div class="company-details"><strong>${e(s.name)}</strong> · Sitz: Berlin · Geschäftsführung: ${e(s.managingDirector)}<br>${e(s.register)} · USt-IdNr.: ${e(s.vatId)}</div>`;
+  const sections = totals.sections.map((section, index) => {
+    const first = index === 0;
+    const last = index === totals.sections.length - 1;
+    return `<section class="invoice-section ${first ? "first" : "continuation"}">
+      ${first ? `
+        <header class="masthead"><div class="brand"><span class="brand-mark">M</span><div><strong>MUSTERWERK</strong><small>Digitalprodukte. Klar umgesetzt.</small></div></div><div class="contact">${e(s.email)}<br>${e(s.website)}</div></header>
+        <div class="sample-note">MUSTERRECHNUNG · Fiktive Geschäftsdaten · Nicht zur Zahlung bestimmt</div>
+        <div class="address-row"><div><p class="sender-line">${e(s.name)} · ${e(s.street)} · ${e(s.city)}</p><address><strong>${e(c.name)}</strong><br>${e(c.department)}<br>${e(c.street)}<br>${e(c.city)}<br>${e(c.country)}</address></div>
+        <div class="supplier-address"><strong>Rechnungssteller</strong><br>${e(s.name)}<br>${e(s.street)}<br>${e(s.city)}<br>${e(s.country)}<br>USt-IdNr. ${e(s.vatId)}</div></div>
+        <div class="title-row"><h1>Rechnung</h1><span>${e(data.number)}</span></div>
+        <div class="invoice-meta"><div><span>Rechnungsdatum</span><strong>${date(data.issueDate)}</strong></div><div><span>Kundennummer</span><strong>${e(data.customerNumber)}</strong></div><div><span>Ihre Bestellung</span><strong>${e(data.orderNumber)}</strong></div><div><span>Zahlbar bis</span><strong>${date(data.dueDate)}</strong></div></div>
+        <p class="project"><strong>${e(data.project)}</strong><br>Leistungszeitraum: ${date(data.serviceFrom)} bis ${date(data.serviceTo)}.<br>Wir berechnen die folgenden vereinbarten und erbrachten Leistungen.</p>
+      ` : `<header class="continuation-header"><strong>MUSTERWERK <span>Digital GmbH</span></strong><div>Rechnung ${e(data.number)}<br>${e(c.name)}</div></header>`}
+      <div class="section-heading"><span class="section-index">${String(index + 1).padStart(2, "0")}</span><div><h2>${e(section.title)}</h2><p>${e(section.subtitle)}</p></div></div>
+      ${!first ? `<div class="carry"><span>Bisherige Leistungen netto</span><strong>${money(section.carriedCents)}</strong></div>` : ""}
+      <table class="items"><colgroup><col class="col-position"><col class="col-description"><col class="col-quantity"><col class="col-unit"><col class="col-total"></colgroup>
+      <thead><tr><th>Pos.</th><th>Leistung</th><th class="numeric">Std.</th><th class="numeric">Preis / Std.</th><th class="numeric">Netto</th></tr></thead>
+      <tbody>${section.items.map(item => `<tr><td class="position">${e(item.position)}</td><td><strong>${e(item.name)}</strong><div class="description">${e(item.description)}</div></td><td class="numeric">${quantity(item.quantityHundredths)}</td><td class="numeric">${money(item.unitPriceCents)}</td><td class="numeric amount">${money(item.netCents)}</td></tr>`).join("")}</tbody></table>
+      ${last ? `<div class="settlement"><div class="tax-note"><strong>Abrechnung</strong><p>Alle Positionen netto in EUR.<br>Alle Leistungen unterliegen ${percent(data.vatBasisPoints)} Umsatzsteuer.</p><p>Vereinbarter Projektrabatt: ${percent(data.discountBasisPoints)} auf sämtliche Positionen.</p></div>
+        <table class="totals"><tr><td>Summe Leistungen netto</td><td>${money(totals.subtotalCents)}</td></tr><tr><td>Projektrabatt ${percent(data.discountBasisPoints)}</td><td>-${money(totals.discountCents)}</td></tr><tr class="net"><td>Entgelt netto (${percent(data.vatBasisPoints)} USt.)</td><td>${money(totals.netCents)}</td></tr><tr><td>Umsatzsteuer ${percent(data.vatBasisPoints)}</td><td>${money(totals.vatCents)}</td></tr><tr class="grand-total"><td>Rechnungsbetrag</td><td>${money(totals.totalCents)}</td></tr></table></div>
+        <div class="payment"><h3>Zahlungsbedingungen</h3><p>Zahlbar bis zum <strong>${date(data.dueDate)}</strong> ohne Abzug per Überweisung.<br>Verwendungszweck: <strong>${e(data.number)} / ${e(data.customerNumber)}</strong></p><div class="bank"><div><span>Kontoinhaber</span><strong>${e(s.name)}</strong></div><div><span>IBAN (Musterdaten)</span><strong>${e(s.iban)}</strong></div><div><span>BIC</span><strong>${e(s.bic)}</strong></div></div></div>
+        <p class="closing">Vielen Dank für die vertrauensvolle Zusammenarbeit.</p>${identity}
+      ` : `<div class="carry after-table"><span>Kumulierte Leistungen netto</span><strong>${money(section.cumulativeCents)}</strong></div><p class="continuation-note">Fortsetzung im folgenden Abschnitt. Rabatt, Umsatzsteuer und Rechnungsbetrag am Ende der Rechnung.</p>${identity}`}
+    </section>`;
+  }).join("");
+  return `<!doctype html><html lang="de"><head><meta charset="utf-8"><title>${e(data.number)}</title><link rel="stylesheet" href="invoice.css"></head><body>${sections}</body></html>`;
+}

package/examples/german-invoice.mjs

@@ -0,0 +1,20 @@
+import { readFile, mkdir, writeFile } from "node:fs/promises";
+import { renderPdf } from "blitz-pdf";
+import { createInvoiceHtml, invoiceOptions } from "./german-invoice/template.mjs";
+import { invoice, calculateInvoice } from "./german-invoice/data.mjs";
+
+const baseUrl = new URL("german-invoice/", import.meta.url);
+const html = createInvoiceHtml(invoice);
+const bytes = await renderPdf(html, {
+  ...invoiceOptions(invoice),
+  baseUrl: baseUrl.href,
+  // Demonstrates the async asset API with a real external stylesheet.
+  assets: async url => readFile(new URL(url)),
+});
+const output = new URL("../output/pdf/", import.meta.url);
+await mkdir(output, { recursive: true });
+await writeFile(new URL("german-invoice.pdf", output), bytes);
+await writeFile(new URL("german-invoice.html", output), html);
+await writeFile(new URL("invoice.css", output), await readFile(new URL("invoice.css", baseUrl)));
+await writeFile(new URL("german-invoice-totals.json", output), JSON.stringify(calculateInvoice(invoice), null, 2) + "\n");
+console.log(`Created output/pdf/german-invoice.pdf (${bytes.length} bytes, PDF/A-3u with automatic page numbers).`);

package/examples/invoice.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+<meta charset="utf-8">
+<style>
+  body { margin: 0; font-family: sans-serif; color: #172033; font-size: 14px; line-height: 1.5; }
+  header { display: flex; justify-content: space-between; align-items: center; border-bottom: 3px solid #2457db; padding-bottom: 20px; }
+  h1 { color: #2457db; margin: 0; font-size: 36px; }
+  .meta { color: #56647a; text-align: right; }
+  .customer { margin: 28px 0; }
+  table { width: 100%; border-collapse: collapse; }
+  th { background: #edf2fc; text-align: left; }
+  th, td { padding: 12px; border-bottom: 1px solid #dde3ed; }
+  .number { text-align: right; }
+  .total { margin-top: 20px; text-align: right; font-size: 20px; }
+  footer { margin-top: 50px; padding-top: 18px; border-top: 1px solid #dde3ed; color: #56647a; }
+</style>
+<header><h1>INVOICE</h1><div class="meta">BLITZ STUDIO<br>INV-0042 · 13 October 2026</div></header>
+<section class="customer"><b>Prepared for</b><br>Example Company<br>Berlin, Germany</section>
+<table>
+  <thead><tr><th>Description</th><th class="number">Hours</th><th class="number">Rate</th><th class="number">Amount</th></tr></thead>
+  <tbody>
+    <tr><td>Design and typography</td><td class="number">8</td><td class="number">€125.00</td><td class="number">€1,000.00</td></tr>
+    <tr><td>HTML and CSS implementation</td><td class="number">12</td><td class="number">€125.00</td><td class="number">€1,500.00</td></tr>
+    <tr><td>PDF integration and testing</td><td class="number">6</td><td class="number">€125.00</td><td class="number">€750.00</td></tr>
+  </tbody>
+</table>
+<p class="total"><b>Total: €3,250.00</b></p>
+<footer>Generated from HTML with Blitz and WebAssembly.<br>Text stays selectable. Fonts are embedded. Shapes are vectors.</footer>
+</html>

package/examples/node.mjs

@@ -0,0 +1,8 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { renderPdf } from "blitz-pdf";
+
+const html = await readFile(new URL("./invoice.html", import.meta.url), "utf8");
+const pdf = await renderPdf(html, { format: "A4", margin: "18mm", title: "Invoice INV-0042" });
+await mkdir(new URL("../output/pdf/", import.meta.url), { recursive: true });
+await writeFile(new URL("../output/pdf/invoice.pdf", import.meta.url), pdf);
+console.log(`Created output/pdf/invoice.pdf (${pdf.length} bytes).`);

package/examples/pagination.html

@@ -0,0 +1,40 @@
+<!doctype html>
+<html lang="en">
+<meta charset="utf-8">
+<style>
+  body { margin:0; font:14px/1.5 sans-serif; color:#172033; }
+  h1 { font-size:30px; line-height:1.2; color:#2457db; margin:0 0 10px; }
+  h2 { font-size:18px; margin:0 0 8px; break-after:avoid; }
+  p { margin:6px 0; widows:2; orphans:2; }
+  header { border-bottom:3px solid #2457db; padding-bottom:16px; margin-bottom:22px; }
+  .card { break-inside:avoid; border:1px solid #cad7ee; border-left:4px solid #2457db; background:#f4f7fe; padding:18px; margin:0 0 16px; }
+  .chapter { break-before:page; }
+  table { width:100%; border-collapse:collapse; margin-top:20px; }
+  td,th { text-align:left; padding:10px; border-bottom:1px solid #dae1ed; }
+  th { background:#edf2fc; }
+  footer { margin-top:24px; color:#56647a; font-size:12px; }
+</style>
+<header><h1>Page break verification</h1><p>Vector PDF/A-3u generated by Blitz and WebAssembly.</p></header>
+<div class="card"><h2>01 / Complete blocks</h2><p>Each card stays together when it fits on a page. Borders and text move together.</p></div>
+<div class="card"><h2>02 / Selectable text</h2><p>These are embedded font glyphs with Unicode mappings: café, office, affinity, €.</p></div>
+<div class="card"><h2>03 / CSS rules</h2><p>The renderer reads computed break rules from the same CSS cascade used for layout.</p></div>
+<div class="card"><h2>04 / Automatic flow</h2><p>This block moves intact if the current page has insufficient remaining space.</p></div>
+<div class="card"><h2>05 / Line integrity</h2><p>Text lines stay inside the printable area. Content appears once across the document.</p></div>
+<div class="card"><h2>06 / Archival output</h2><p>The document contains XMP identification, an sRGB output intent, and embedded fonts.</p></div>
+<section class="chapter">
+  <h1>Explicit chapter break</h1>
+  <p>This section starts on a fresh page through <b>break-before: page</b>.</p>
+  <table>
+    <thead><tr><th>Control</th><th>Expected behavior</th></tr></thead>
+    <tbody>
+      <tr><td>break-before: page</td><td>Begin a new page</td></tr>
+      <tr><td>break-after: avoid</td><td>Keep the heading with text</td></tr>
+      <tr><td>break-inside: avoid</td><td>Move a complete block</td></tr>
+      <tr><td>widows / orphans</td><td>Protect paragraph fragments</td></tr>
+      <tr><td>Table rows</td><td>Keep fitting rows intact</td></tr>
+      <tr><td>Legacy page-break-*</td><td>Use the same cascade</td></tr>
+    </tbody>
+  </table>
+  <footer>No clipped lines, duplicated text, or accidental blank pages.</footer>
+</section>
+</html>

package/examples/pagination.mjs

@@ -0,0 +1,8 @@
+import { readFile, mkdir, writeFile } from "node:fs/promises";
+import { renderPdf } from "blitz-pdf";
+
+const html = await readFile(new URL("./pagination.html", import.meta.url), "utf8");
+const pdf = await renderPdf(html, { format:"A5", margin:"12mm", title:"PDF/A-3u page break verification" });
+await mkdir(new URL("../output/pdf/", import.meta.url), { recursive:true });
+await writeFile(new URL("../output/pdf/pagination.pdf", import.meta.url), pdf);
+console.log(`Created output/pdf/pagination.pdf (${pdf.length} bytes).`);