blitz-pdf 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 blitz-pdf contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,356 @@
-# Temporary Holding Version
+<img src="assets/icon.svg" width="64" height="64" alt="">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# blitz-pdf
+
+HTML and CSS to **vector PDF/A-3u**, powered by [Blitz](https://github.com/DioxusLabs/blitz)
+and [Krilla](https://github.com/LaurenzV/krilla), compiled to WebAssembly.
+
+Runs in **Bun, Node.js, and browsers**. Text is selectable and searchable, fonts
+are subsetted and embedded, and shapes remain vectors. No Chromium, GPU, native
+addon, or rendering service. Source images remain images.
+
+This is an early implementation; see the limitations below.
+
+## Install
+
+```sh
+npm install blitz-pdf
+# or
+bun add blitz-pdf
+```
+
+## Node.js and Bun
+
+```js
+import { renderPdf } from "blitz-pdf";
+
+const pdf = await renderPdf(`
+  <style>body { font-family: sans-serif } h1 { color: #2457db }</style>
+  <h1>Hello, PDF</h1>
+  <p>Selectable text: café, office, €.</p>
+`, { format: "A4", margin: "15mm", title: "Example" });
+
+// Node.js
+await (await import("node:fs/promises")).writeFile("example.pdf", pdf);
+
+// Bun
+// await Bun.write("example.pdf", pdf);
+```
+
+The first render loads the bundled WASM automatically. The npm package includes
+JavaScript, TypeScript declarations, and the WASM containing the fonts. Consumers
+do not need Rust. The package is ESM, targeting Node.js 20+ and modern Bun.
+
+## Browser
+
+```js
+import { renderPdf } from "blitz-pdf/browser";
+
+const bytes = await renderPdf("<h1>Made in the browser</h1>");
+const url = URL.createObjectURL(new Blob([bytes], { type: "application/pdf" }));
+const link = document.createElement("a");
+link.href = url;
+link.download = "example.pdf";
+link.click();
+// Revoke the URL when it is no longer needed.
+```
+
+Bundlers should copy the WASM referenced through `new URL(..., import.meta.url)`.
+For a custom deployment, set its location before the first render:
+
+```js
+import { init, renderPdf } from "blitz-pdf/browser";
+await init({ wasm: new URL("/assets/blitz_pdf_bg.wasm", location.href) });
+const pdf = await renderPdf("<p>Ready</p>");
+```
+
+The binary is exported as `blitz-pdf/wasm`. Serve it with
+`Content-Type: application/wasm`. `init` also accepts bytes, a `Response`, or a
+compiled `WebAssembly.Module`. Concurrent callers share initialization; failed
+loads can be retried.
+
+Asset I/O is asynchronous. HTML layout and PDF serialization perform synchronous
+CPU work. Use a Web Worker or server worker thread when the calling thread must
+stay responsive. Each worker gets its own WASM instance. Shared memory and
+cross-origin isolation are not required.
+
+## Options
+
+`renderPdf(html: string, options?: PdfOptions): Promise<Uint8Array>`
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `format` | `"A4"` | `A3`, `A4`, `A5`, `Letter`, `Legal`, or `Tabloid` |
+| `width`, `height` | From format | Supply both for custom dimensions; omit `format` |
+| `landscape` | `false` | Swap width and height |
+| `margin` | `0` | One length or `{ top, right, bottom, left }`; omitted sides are zero |
+| `media` | `"print"` | CSS media queries: `print` or `screen` |
+| `title` | Unset | PDF metadata title |
+| `pageNumbers` | `false` | `true` or `{ template, align, fontSize }` for an automatic text footer |
+| `baseUrl` | `https://blitz-pdf.invalid/` | Resolve relative asset URLs |
+| `assets` | `{}` | Resource map or `(url) => data / Promise<data>`; data is a UTF-8 string, `Uint8Array`, or `ArrayBuffer` |
+| `fonts` | `[]` | Additional static TTF, OTF, WOFF, or WOFF2 font bytes |
+| `maxPages` | `100` | Reject larger documents; maximum 1000 |
+
+Lengths accept numbers in CSS pixels (96 px = 1 inch), or strings with `px`,
+`pt`, `mm`, `cm`, or `in`. PDF dimensions use 72 points per inch. Page dimensions
+are limited to 19200 CSS pixels; margins must leave printable content.
+`getEngineVersion()` returns the package version and pinned Blitz revision.
+
+## Resources and fonts
+
+The renderer requests resources through `assets` or decodes data URLs. Supply an
+asset map or a loading function; network and file access are controlled by your
+function. Missing resources fail with an error.
+Linked CSS, nested imports, images, and `@font-face` use the same resolver.
+
+```js
+const pdf = await renderPdf(`
+  <link rel="stylesheet" href="invoice.css">
+  <img src="logo.png" width="80">
+  <h1>Invoice</h1>
+`, {
+  baseUrl: "https://example.com/documents/",
+  assets: {
+    "invoice.css": "h1 { color: navy }",
+    "logo.png": new Uint8Array(await (await fetch("/logo.png")).arrayBuffer()),
+  },
+});
+```
+
+For dynamic loading, `assets` can be an async function in Bun, Node, browsers,
+and workers:
+
+```js
+const pdf = await renderPdf(`
+  <link rel="stylesheet" href="invoice.css">
+  <img src="logo.png" width="80">
+  <h1>Invoice</h1>
+`, {
+  baseUrl: "https://example.com/documents/",
+  assets: async (url) => {
+    const response = await fetch(url);
+    if (!response.ok) throw new Error(`HTTP ${response.status} loading ${url}`);
+    return response.arrayBuffer();
+  },
+});
+```
+
+The callback receives an **absolute URL string**, resolved against the document
+or referring stylesheet. Return UTF-8 text, a `Uint8Array` (including a Node/Bun
+`Buffer`), or an `ArrayBuffer`; synchronous returns also work. For filesystem
+assets, use a `file:` base URL and return `readFile(new URL(url))` in your callback.
+`AssetData`, `AssetMap`, and `AssetResolver` are exported TypeScript types.
+
+Blitz discovers resources as it parses and lays out the document, including
+nested CSS imports, font faces, and CSS background images. Loading completes
+before pagination and PDF serialization. Each absolute URL is loaded once per
+render and cached for that render; data URLs bypass the callback. Up to eight
+independent callbacks run concurrently. Concurrent renders have separate caches.
+Browser callbacks follow the browser's normal CORS rules.
+
+Returning `null` or `undefined` rejects the render as a missing asset. A thrown
+error or rejected promise includes the resource URL and preserves the original
+error as `cause`. Invalid return types and assets exceeding the combined 64 MiB
+limit also reject. Already-running callbacks may finish after another callback
+fails; their results are discarded. Apply fetch timeouts in your loader when
+needed. The existing asset-map API continues to work.
+
+DejaVu Sans regular, bold, italic, and bold italic are bundled; DejaVu Sans Mono
+backs `monospace`. Other generic families fall back to DejaVu Sans. There is no
+system font discovery. Fonts passed in `fonts` use their internal family names;
+use `@font-face` with an asset URL for a CSS alias. Supply fonts for scripts not
+covered by the bundled family.
+
+Input limits: 16 MiB HTML, 64 MiB supplied assets, 32 MiB supplied fonts, and 1024
+resource requests. These are practical limits, not a complete sandbox; isolate
+untrusted documents in a terminable worker with application limits.
+
+## PDF/A-3 conformance
+
+Every successful render targets **PDF/A-3u (ISO 19005-3, level U)**. The PDF 1.7
+output includes embedded fonts and Unicode mappings, an sRGB ICC output intent,
+device-independent colors, PDF/A identification in XMP, document IDs, and a UTC
+creation timestamp. Text remains selectable; no page or text rasterization is
+used. Transparency and source images remain supported.
+
+Krilla's archival validator runs during serialization. Nonconforming inputs,
+such as a missing glyph or a font with restricted embedding permissions, fail
+the render instead of producing a mislabeled file. Use fonts licensed for
+embedding. Level U does not require a structure tree; tagged PDF/A-3a is not
+implemented.
+
+The independent conformance test captures PDFs from the Bun integration suite
+and validates each with [veraPDF](https://docs.verapdf.org/cli/validation/).
+It also requires a deliberately nonconforming control PDF to fail validation.
+
+```sh
+# Development/CI only; Java 21 and unzip are required for installation.
+npm run setup:verapdf
+npm run test:pdfa
+# Or use an existing installation:
+VERAPDF_BIN=/path/to/verapdf npm run test:pdfa
+```
+
+The installer pins veraPDF 1.30.3 and verifies its SHA-256 checksum. Reports and
+captured PDFs are saved under `output/pdfa-validation/`. Java and veraPDF are
+not runtime dependencies of the npm package.
+
+## Page breaks
+
+Pagination uses the printable area after `margin`. Supported controls in normal
+vertical flow include:
+
+- `break-before` / `break-after`: `page`, `always`, `avoid`, `avoid-page`,
+  `left`, `right`, `recto`, and `verso`.
+- `break-inside: avoid` / `avoid-page`, plus legacy `page-break-before`,
+  `page-break-after`, and `page-break-inside` aliases.
+- Inherited `widows` and `orphans` (positive integers; default 2).
+- Automatic protection of text lines, table rows, images, and SVG boxes.
+
+```html
+<style>
+  h2 { break-after: avoid; }
+  .chapter { break-before: page; }
+  .card { break-inside: avoid; }
+  p { widows: 3; orphans: 3; }
+</style>
+```
+
+Selectors, external stylesheets, print/screen queries, variables, specificity,
+and `!important` use Stylo's real cascade. Adjacent forced breaks coalesce;
+first/last break rules do not add accidental blank pages. Left/right/recto/verso
+may intentionally insert a blank page, respecting the document's direction.
+All pages, including intentional blanks, count toward `maxPages`.
+
+Forced breaks take precedence over keep-together rules. Blocks larger than a
+page are allowed to fragment, and impossible widow/orphan constraints are
+relaxed to make progress. A text line that cannot fit the printable height
+fails explicitly. Keep-with-next protects a heading even when the following
+paragraph spans multiple pages.
+
+### Page numbers
+
+```js
+const pdf = await renderPdf(html, {
+  format: "A4",
+  margin: "17mm",
+  pageNumbers: {
+    template: "RE-2026-1042 · Seite {page} von {pages}",
+    align: "right",
+    fontSize: "8pt",
+  },
+});
+```
+
+`pageNumbers: true` defaults to `"{page} / {pages}"`, right alignment, and
+12 CSS pixels (9pt). The template is a single line containing `{page}` and
+optionally `{pages}`. Alignment accepts `left`, `center`, or `right`; font size
+accepts the usual lengths, from 1 to 48 CSS pixels. A template that does not
+fit the page width fails explicitly.
+
+The renderer reserves a footer band of `2 × fontSize + 8px` above the bottom
+margin **before pagination**. Numbers use the final page count, including
+intentional blanks. The footer uses embedded DejaVu Sans and the same Unicode
+shaping as body text, preserving selectable text and PDF/A-3u. It works with
+async assets in every runtime. `PageNumberOptions` is an exported TypeScript type.
+
+## German invoice example
+
+```sh
+npm run example:german-invoice
+# Or run the same generator using Bun:
+bun examples/german-invoice.mjs
+```
+
+Creates `output/pdf/german-invoice.pdf`: three A4 pages, 24 itemized services,
+German dates and currency, supplier/customer details, invoice and order numbers,
+a service period, a 3% project discount, 19% VAT, payment details, and automatic
+“Seite X von Y” footers. The final amount is **25.631,23 EUR**. Calculations use
+integer cents and half-up rounding. The stylesheet loads through the async
+`assets` callback. The generator also writes the HTML/CSS and calculated totals
+alongside the PDF for inspection.
+
+The [example source and scope](examples/german-invoice/README.md) explain the
+fictitious data and the German invoice fields. This is a **PDF/A-3u example
+without embedded XML**, as opposed to a structured e-invoice. Its 2026 domestic
+B2B scenario assumes the recipient agrees to PDF delivery under the applicable
+transition rule. [§ 14 UStG](https://www.gesetze-im-internet.de/ustg_1980/__14.html),
+[§ 27(38) UStG](https://www.gesetze-im-internet.de/ustg_1980/__27.html).
+
+## Current limits
+
+- CSS support follows Blitz, whose coverage is evolving.
+- Text retains shaped glyphs and Unicode cluster mappings, including ligatures.
+  Unrecognized or ambiguous text runs are rejected rather than assigned guessed
+  Unicode.
+- Pagination fragments one continuous vertical layout. CSS `@page`, repeated
+  table/fixed headers, nested multicolumn fragmentation, and independent
+  fragmentation of parallel flex/grid flows are not implemented. Oversized
+  boxes/images may span pages; box decorations are sliced rather than cloned.
+- CSS filters, blurred shadows, non-default variable font instances, and
+  repeating radial gradients are rejected. Use static font faces. There is no
+  automatic raster fallback.
+- Gradients become sRGB PDF shadings; advanced CSS interpolation spaces may
+  differ. SVG shapes stay vector; upstream SVG text may become vector outlines.
+- Scripts are not executed. Interactive forms, link annotations, accessibility
+  tags, encryption, and signatures are not generated.
+
+## Development
+
+Install Node.js 22.13+ for development tooling, Bun, and rustup. The repository
+pins Rust 1.99.0 and its WASM target in `rust-toolchain.toml`.
+
+```sh
+npm ci
+cargo install wasm-bindgen-cli --version 0.2.129 --locked
+npm run build
+bun test
+npm run test:node
+npm run example:node
+# or: bun run example:bun
+npm pack
+```
+
+The wasm-bindgen CLI version must match `Cargo.lock`. Dependencies and upstream
+commits are locked. `npm pack` verifies artifacts and renders a PDF before making
+the tarball; it does not publish. Install locally using
+`npm install ./blitz-pdf-0.1.0.tgz`.
+
+The pinned Stylo source in `vendor/stylo` enables paged-media properties in the
+Servo build; `vendor/README.md` records the small patch. Its MPL-2.0 source is
+included in the npm archive.
+
+`bun test` exercises the compiled module through its public package export. Tests
+extract Unicode with PDF.js and inspect embedded fonts, vector paths, absence
+of page images, dimensions, pagination, assets, media queries, and error recovery.
+For browser verification, run `npm run test:browser` and open
+`http://127.0.0.1:4173`. CI builds WASM, runs Bun and Node tests, validates the
+captured PDFs with veraPDF, benchmarks, and packs an npm artifact.
+
+## Performance benchmarks
+
+```sh
+bun run bench
+bun run bench --iterations=50 --warmup=5
+bun run bench --iterations=50 --warmup=5 --json > benchmark-results.json
+```
+
+Benchmarks measure WASM initialization separately, then first-render, mean,
+median, p95, throughput, and output size for small HTML, a styled invoice,
+100 paragraphs, matching asset-map/async-loader documents with nested CSS
+and a font, and the complete three-page German invoice with page numbers.
+The async benchmarks use in-memory data to measure resolver overhead
+without network latency. Warmed samples include parsing, styling/layout,
+painting, font subsetting, and PDF serialization. Resource fetches, file writes, and process
+startup are excluded. Each iteration renders a new document. JSON records the
+runtime, platform, sample count, and RSS.
+
+Results depend on hardware, engine, fonts, and document complexity. Run on your
+deployment hardware. CI records results without a timing threshold on shared
+runners.
+
+## License
+
+MIT. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) and `licenses/` for
+dependencies and fonts. This is an independent integration.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,25 @@
+# Third-party notices
+
+blitz-pdf is an independent project, not an official Dioxus Labs package.
+
+The distributed WebAssembly module includes:
+
+- [Blitz](https://github.com/DioxusLabs/blitz), MIT OR Apache-2.0, pinned to `e72650a6e67941852fddf025295cfee30c39ea32`.
+- [Krilla](https://github.com/LaurenzV/krilla), MIT OR Apache-2.0, for PDF serialization and font subsetting.
+- [Parley](https://github.com/linebender/parley), MIT OR Apache-2.0, for text layout.
+- [Stylo](https://github.com/servo/stylo), MPL-2.0, for CSS styling.
+- [Taffy](https://github.com/DioxusLabs/taffy), MIT, for layout.
+
+The resolved dependency inventory and upstream license notices are in
+`licenses/RUST_DEPENDENCIES.txt`. `Cargo.lock` pins versions and source commits.
+Upstream sources are available at the repository links in that inventory and
+through crates.io. Stylo 0.22.0 is patched to expose paged-media CSS properties
+in its Servo build. Its full modified MPL-2.0 source and license are included in
+`vendor/stylo`; `vendor/README.md` lists the changes. Other dependencies are used
+without source modifications.
+
+Bundled DejaVu fonts use the Bitstream Vera / DejaVu license reproduced in
+`licenses/DejaVu.txt`. The regular WOFF2 comes from Blitz's
+`examples/wasm_hello/assets/DejaVuSans.woff2` at the pinned revision. Other faces
+are from the official DejaVu 2.37 TTF release. Fonts are subsetted and embedded
+in generated PDFs.

package/assets/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="14" fill="#2563eb"/>
+  <text x="32" y="32" dy="0.35em" text-anchor="middle" font-family="ui-sans-serif, system-ui, -apple-system, sans-serif" font-size="26" font-weight="600" fill="#ffffff">BP</text>
+</svg>

package/dist/api.d.ts

@@ -0,0 +1,7 @@
+import type { InitOptions, PdfOptions, WasmSource } from "./types.js";
+export declare function createApi(defaultSource: () => Promise<WasmSource> | WasmSource, prepare?: (source: WasmSource) => Promise<WasmSource>): {
+    init: (options?: InitOptions) => Promise<void>;
+    renderPdf: (html: string, options?: PdfOptions) => Promise<Uint8Array>;
+    getEngineVersion: () => Promise<string>;
+};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtE,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,EAC7E,OAAO,GAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAA0B;qBAItD,WAAW,KAAQ,OAAO,CAAC,IAAI,CAAC;sBAUxB,MAAM,YAAW,UAAU,KAAQ,OAAO,CAAC,UAAU,CAAC;4BAqBlD,OAAO,CAAC,MAAM,CAAC;EAEnD"}

package/dist/api.js

@@ -0,0 +1,46 @@
+import loadWasm, { render_pdf, engine_version, RenderJob } from "../wasm/blitz_pdf.js";
+import { createAssetLoader } from "./assets.js";
+import { normalizeOptions } from "./options.js";
+export function createApi(defaultSource, prepare = async (source) => source) {
+    let ready;
+    /** Initialize once. Concurrent callers share initialization; failed loads can be retried. */
+    function init(options = {}) {
+        if (ready)
+            return ready;
+        ready = (async () => {
+            const source = await prepare(options.wasm ?? await defaultSource());
+            await loadWasm({ module_or_path: source });
+        })().catch((error) => { ready = undefined; throw error; });
+        return ready;
+    }
+    /** Render HTML/CSS to a vector PDF/A-3u with embedded fonts and selectable text. */
+    async function renderPdf(html, options = {}) {
+        if (typeof html !== "string")
+            throw new TypeError("html must be a string");
+        if (new TextEncoder().encode(html).byteLength > 16 * 1024 * 1024)
+            throw new RangeError("HTML exceeds the 16 MiB limit");
+        const { assetResolver, ...normalized } = normalizeOptions(options);
+        await init();
+        if (!assetResolver)
+            return render_pdf(html, normalized);
+        const load = createAssetLoader(assetResolver);
+        const job = new RenderJob(html, normalized);
+        try {
+            for (;;) {
+                const urls = job.pending_assets();
+                if (urls.length === 0)
+                    return job.finish();
+                const data = await load(urls);
+                for (let i = 0; i < urls.length; i++)
+                    job.provide_asset(urls[i], data[i]);
+            }
+        }
+        finally {
+            // In-flight JS loaders never access this job, including after a sibling rejects.
+            job.free();
+        }
+    }
+    async function getEngineVersion() { await init(); return engine_version(); }
+    return { init, renderPdf, getEngineVersion };
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,UAAU,SAAS,CAAC,aAAqD,EAC7E,UAAuD,KAAK,EAAC,MAAM,EAAC,EAAE,CAAC,MAAM;IAC7E,IAAI,KAAgC,CAAC;IAErC,6FAA6F;IAC7F,SAAS,IAAI,CAAC,UAAuB,EAAE;QACrC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;YAClB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,MAAM,aAAa,EAAE,CAAC,CAAC;YACpE,MAAM,QAAQ,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oFAAoF;IACpF,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,UAAsB,EAAE;QAC7D,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC3E,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;QACxH,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,IAAI,EAAE,CAAC;QACb,IAAI,CAAC,aAAa;YAAE,OAAO,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;oBAAE,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,iFAAiF;YACjF,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAED,KAAK,UAAU,gBAAgB,KAAsB,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,cAAc,EAAE,CAAC,CAAC,CAAC;IAC7F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;AAC/C,CAAC"}

package/dist/assets.d.ts

@@ -0,0 +1,7 @@
+import type { AssetData, AssetResolver, BinaryData } from "./types.js";
+export declare const MAX_ASSET_BYTES: number;
+export declare function copyBytes(value: BinaryData, name: string): Uint8Array;
+export declare function assetBytes(value: AssetData, name: string): Uint8Array;
+/** Load independent requests concurrently, with a byte budget shared by all batches of this render. */
+export declare function createAssetLoader(resolver: AssetResolver): (urls: string[]) => Promise<Uint8Array[]>;
+//# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAKrE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAErE;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,IAEzC,MAAM,MAAM,EAAE,KAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBrD"}

package/dist/assets.js

@@ -0,0 +1,52 @@
+export const MAX_ASSET_BYTES = 64 * 1024 * 1024;
+export function copyBytes(value, name) {
+    // Buffer.slice() creates a view, so use a constructor to snapshot every Uint8Array.
+    if (value instanceof Uint8Array)
+        return new Uint8Array(value);
+    if (value instanceof ArrayBuffer)
+        return new Uint8Array(value.slice(0));
+    throw new TypeError(`${name} must be a Uint8Array or ArrayBuffer`);
+}
+export function assetBytes(value, name) {
+    return typeof value === "string" ? new TextEncoder().encode(value) : copyBytes(value, name);
+}
+/** Load independent requests concurrently, with a byte budget shared by all batches of this render. */
+export function createAssetLoader(resolver) {
+    let totalBytes = 0;
+    return async (urls) => {
+        const results = new Array(urls.length);
+        let next = 0;
+        let failed = false;
+        async function worker() {
+            while (!failed && next < urls.length) {
+                const index = next++;
+                const url = urls[index];
+                try {
+                    let value;
+                    try {
+                        value = await resolver(url);
+                    }
+                    catch (cause) {
+                        throw new Error(`Failed to load asset: ${url}`, { cause });
+                    }
+                    if (failed)
+                        return;
+                    if (value == null)
+                        throw new Error(`Missing asset: ${url}. The asset resolver returned ${String(value)}`);
+                    const data = assetBytes(value, `Asset resolver result for ${url}`);
+                    totalBytes += data.byteLength;
+                    if (totalBytes > MAX_ASSET_BYTES)
+                        throw new RangeError("Assets exceed the 64 MiB limit");
+                    results[index] = data;
+                }
+                catch (error) {
+                    failed = true;
+                    throw error;
+                }
+            }
+        }
+        await Promise.all(Array.from({ length: Math.min(8, urls.length) }, worker));
+        return results;
+    };
+}
+//# sourceMappingURL=assets.js.map

package/dist/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,MAAM,UAAU,SAAS,CAAC,KAAiB,EAAE,IAAY;IACvD,oFAAoF;IACpF,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,IAAY;IACvD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC9F,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,OAAO,KAAK,EAAE,IAAc,EAAyB,EAAE;QACrD,MAAM,OAAO,GAAG,IAAI,KAAK,CAAa,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,UAAU,MAAM;YACnB,OAAO,CAAC,MAAM,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;gBACrB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,IAAI,KAAyC,CAAC;oBAC9C,IAAI,CAAC;wBAAC,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAAC,CAAC;oBACpC,OAAO,KAAK,EAAE,CAAC;wBAAC,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAAC,CAAC;oBAC7E,IAAI,MAAM;wBAAE,OAAO;oBACnB,IAAI,KAAK,IAAI,IAAI;wBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,iCAAiC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAC1G,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,6BAA6B,GAAG,EAAE,CAAC,CAAC;oBACnE,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC;oBAC9B,IAAI,UAAU,GAAG,eAAe;wBAAE,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;oBACzF,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;gBACxB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAAC,MAAM,GAAG,IAAI,CAAC;oBAAC,MAAM,KAAK,CAAC;gBAAC,CAAC;YACjD,CAAC;QACH,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5E,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,3 @@
+export type { AssetData, AssetMap, AssetResolver, BinaryData, InitOptions, Length, PageFormat, PageNumberOptions, PdfOptions, WasmSource } from "./types.js";
+export declare const init: (options?: import("./types.js").InitOptions) => Promise<void>, renderPdf: (html: string, options?: import("./types.js").PdfOptions) => Promise<Uint8Array>, getEngineVersion: () => Promise<string>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7J,eAAO,MAAQ,IAAI,iEAAE,SAAS,oFAAE,gBAAgB,uBAE/C,CAAC"}

package/dist/browser.js

@@ -0,0 +1,3 @@
+import { createApi } from "./api.js";
+export const { init, renderPdf, getEngineVersion } = createApi(() => new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url));
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAC5D,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC5D,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,3 @@
+export type { AssetData, AssetMap, AssetResolver, BinaryData, InitOptions, Length, PageFormat, PageNumberOptions, PdfOptions, WasmSource } from "./types.js";
+export declare const init: (options?: import("./types.js").InitOptions) => Promise<void>, renderPdf: (html: string, options?: import("./types.js").PdfOptions) => Promise<Uint8Array>, getEngineVersion: () => Promise<string>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7J,eAAO,MAAQ,IAAI,iEAAE,SAAS,oFAAE,gBAAgB,uBAO/C,CAAC"}

package/dist/node.js

@@ -0,0 +1,10 @@
+import { readFile } from "node:fs/promises";
+import { createApi } from "./api.js";
+export const { init, renderPdf, getEngineVersion } = createApi(() => readFile(new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url)), async (source) => {
+    if (source instanceof URL && source.protocol === "file:")
+        return readFile(source);
+    if (typeof source === "string" && source.startsWith("file:"))
+        return readFile(new URL(source));
+    return source;
+});
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAC5D,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACrE,KAAK,EAAC,MAAM,EAAC,EAAE;IACb,IAAI,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/F,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,24 @@
+import type { PdfOptions } from "./types.js";
+export declare function normalizeOptions(options?: PdfOptions): {
+    width: number;
+    height: number;
+    margin: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    media: "print" | "screen";
+    maxPages: number;
+    baseUrl: string;
+    assets: Record<string, Uint8Array<ArrayBufferLike>>;
+    assetResolver: import("./types.js").AssetResolver | undefined;
+    fonts: Uint8Array<ArrayBufferLike>[];
+    pageNumbers: {
+        template: string;
+        align: "left" | "center" | "right";
+        fontSize: number;
+    } | null;
+    title: string | null;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyC,UAAU,EAAE,MAAM,YAAY,CAAC;AA8BpF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,UAAe;;;;;;;;;;;;;;;;kBAwB1B,MAAM;eAAS,MAAM,GAAG,QAAQ,GAAG,OAAO;kBAAY,MAAM;;;EA6C1F"}