blitz-pdf 0.1.4 → 0.1.5

package/README.md

@@ -74,6 +74,35 @@ 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.
 
+## Rendering in a worker
+
+`renderPdfInWorker` has the same signature as `renderPdf`, but layout and PDF
+serialization run in a new worker: a Web Worker in browsers and a
+`worker_threads` worker in Node.js and Bun. The calling thread stays responsive:
+
+```js
+import { renderPdfInWorker } from "blitz-pdf"; // or "blitz-pdf/browser"
+
+const pdfs = await Promise.all(documents.map(html =>
+  renderPdfInWorker(html, { format: "A4", assets: async url => (await fetch(url)).arrayBuffer() })));
+```
+
+The WASM is compiled once into a `WebAssembly.Module` and posted to
+every worker. Workers only instantiate it, so they skip WASM compilation.
+`init({ wasm })` sets the source for this shared module as well. Each call
+starts a separate worker and terminates it after the render, so its memory is
+freed and concurrent calls run in parallel. Limit concurrency yourself, for
+example to `navigator.hardwareConcurrency` or `os.availableParallelism()`.
+
+Options are validated on the calling thread. An `assets` function also runs
+there, so it can use closures, credentials, and caches; the worker receives
+only the returned bytes. Errors are reported the same way as for `renderPdf`.
+Bundlers must emit `dist/worker.js` through its `new Worker(new URL(...,
+import.meta.url))` reference; Vite and webpack do this automatically.
+
+To manage your own workers, post the shared module from `getWasmModule()` and
+pass it to `init({ wasm: module })` inside the worker.
+
 ## Options
 
 `renderPdf(html: string, options?: PdfOptions): Promise<Uint8Array>`

package/dist/api.d.ts

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

package/dist/api.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,EAAE,aAAa,EAAE,OAAgC,EAAE,WAAW,EAAE,EAAE,SAAS;qBAY5E,WAAW,KAAQ,OAAO,CAAC,IAAI,CAAC;sBAYxB,MAAM,YAAW,UAAU,KAAQ,OAAO,CAAC,UAAU,CAAC;8BAQ9C,MAAM,YAAW,UAAU,KAAQ,OAAO,CAAC,UAAU,CAAC;yBAXnE,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;4BAiBlB,OAAO,CAAC,MAAM,CAAC;EAEnD"}

package/dist/api.js

@@ -1,46 +1,44 @@
-import loadWasm, { render_pdf, engine_version, RenderJob } from "../wasm/blitz_pdf.js";
+import loadWasm, { engine_version } from "../wasm/blitz_pdf.js";
 import { createAssetLoader } from "./assets.js";
 import { normalizeOptions } from "./options.js";
-export function createApi(defaultSource, prepare = async (source) => source) {
+import { render, validateHtml } from "./render.js";
+import { compileWasm } from "./wasm.js";
+import { renderInWorker } from "./worker-host.js";
+export function createApi({ defaultSource, prepare = async (source) => source, spawnWorker }) {
+    let compiled;
     let ready;
+    function compile(source) {
+        if (compiled)
+            return compiled;
+        compiled = (async () => compileWasm(await prepare(source ?? await defaultSource())))()
+            .catch((error) => { compiled = undefined; throw error; });
+        return compiled;
+    }
     /** 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 });
+            await loadWasm({ module_or_path: await compile(options.wasm) });
         })().catch((error) => { ready = undefined; throw error; });
         return ready;
     }
+    /** The compiled WASM module, compiled once and shared with every worker. It can be posted to your own workers. */
+    function getWasmModule() { return compile(); }
     /** 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");
+        validateHtml(html);
         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();
-        }
+        return render(html, normalized, assetResolver && createAssetLoader(assetResolver));
+    }
+    /** Like `renderPdf`, but layout and serialization run in a new worker. An `assets` function still runs on the calling thread. */
+    async function renderPdfInWorker(html, options = {}) {
+        validateHtml(html);
+        const { assetResolver, ...normalized } = normalizeOptions(options);
+        return renderInWorker(spawnWorker, await compile(), html, normalized, assetResolver);
     }
     async function getEngineVersion() { await init(); return engine_version(); }
-    return { init, renderPdf, getEngineVersion };
+    return { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersion };
 }
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,EAAE,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AASpE,MAAM,UAAU,SAAS,CAAC,EAAE,aAAa,EAAE,OAAO,GAAG,KAAK,EAAC,MAAM,EAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAa;IACnG,IAAI,QAAiD,CAAC;IACtD,IAAI,KAAgC,CAAC;IAErC,SAAS,OAAO,CAAC,MAAmB;QAClC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,MAAM,IAAI,MAAM,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;aACnF,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,6FAA6F;IAC7F,SAAS,IAAI,CAAC,UAAuB,EAAE;QACrC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;YAClB,MAAM,QAAQ,CAAC,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,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,kHAAkH;IAClH,SAAS,aAAa,KAAkC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;IAE3E,oFAAoF;IACpF,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,UAAsB,EAAE;QAC7D,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,IAAI,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,IAAI,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,iIAAiI;IACjI,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,UAAsB,EAAE;QACrE,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,cAAc,CAAC,WAAW,EAAE,MAAM,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,UAAU,gBAAgB,KAAsB,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,cAAc,EAAE,CAAC,CAAC,CAAC;IAC7F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;AACjF,CAAC"}

package/dist/browser.d.ts

@@ -1,3 +1,3 @@
 export type { AssetData, AssetMap, AssetResolver, AttachmentRelationship, BinaryData, InitOptions, Length, PageFormat, PageNumberOptions, PdfAttachment, PdfDate, PdfMetadata, PdfOptions, PdfXmpProperty, PdfXmpSchema, 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>;
+export declare const init: (options?: import("./types.js").InitOptions) => Promise<void>, renderPdf: (html: string, options?: import("./types.js").PdfOptions) => Promise<Uint8Array>, renderPdfInWorker: (html: string, options?: import("./types.js").PdfOptions) => Promise<Uint8Array>, getWasmModule: () => Promise<WebAssembly.Module>, getEngineVersion: () => Promise<string>;
 //# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

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

package/dist/browser.js

@@ -1,3 +1,15 @@
 import { createApi } from "./api.js";
-export const { init, renderPdf, getEngineVersion } = createApi(() => new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url));
+export const { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersion } = createApi({
+    defaultSource: () => new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url),
+    spawnWorker: events => {
+        const worker = new Worker(new URL("./worker.js", import.meta.url), { type: "module" });
+        worker.onmessage = event => events.message(event.data);
+        worker.onerror = event => {
+            event.preventDefault();
+            events.error(new Error(`Render worker failed: ${event.message || "unknown error"}`));
+        };
+        worker.onmessageerror = () => events.error(new Error("Render worker sent a message that could not be deserialized"));
+        return { post: (message, transfer) => worker.postMessage(message, transfer), terminate: () => worker.terminate() };
+    },
+});
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1 +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"}
+{"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,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC;IAC/F,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1E,WAAW,EAAE,MAAM,CAAC,EAAE;QACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE;YACvB,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC,CAAC;QACF,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC,CAAC;QACrH,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;IACrH,CAAC;CACF,CAAC,CAAC"}

package/dist/node-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node-worker.d.ts.map

package/dist/node-worker.d.ts.map

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

package/dist/node-worker.js

@@ -0,0 +1,10 @@
+import { parentPort } from "node:worker_threads";
+import { serve } from "./worker-runtime.js";
+const port = parentPort;
+if (!port)
+    throw new Error("blitz-pdf node-worker must run in a worker thread");
+serve({
+    post: (message, transfer) => port.postMessage(message, transfer),
+    onMessage: handler => { port.on("message", handler); },
+});
+//# sourceMappingURL=node-worker.js.map

package/dist/node-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-worker.js","sourceRoot":"","sources":["../src/node-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,IAAI,CAAC,IAAI;IAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;AAChF,KAAK,CAAC;IACJ,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;IAChE,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACvD,CAAC,CAAC"}

package/dist/node.d.ts

@@ -1,3 +1,3 @@
 export type { AssetData, AssetMap, AssetResolver, AttachmentRelationship, BinaryData, InitOptions, Length, PageFormat, PageNumberOptions, PdfAttachment, PdfDate, PdfMetadata, PdfOptions, PdfXmpProperty, PdfXmpSchema, 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>;
+export declare const init: (options?: import("./types.js").InitOptions) => Promise<void>, renderPdf: (html: string, options?: import("./types.js").PdfOptions) => Promise<Uint8Array>, renderPdfInWorker: (html: string, options?: import("./types.js").PdfOptions) => Promise<Uint8Array>, getWasmModule: () => Promise<WebAssembly.Module>, getEngineVersion: () => Promise<string>;
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

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

package/dist/node.js

@@ -1,10 +1,22 @@
 import { readFile } from "node:fs/promises";
+import { Worker } from "node:worker_threads";
 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;
+export const { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersion } = createApi({
+    defaultSource: () => readFile(new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url)),
+    prepare: 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;
+    },
+    spawnWorker: events => {
+        const worker = new Worker(new URL("./node-worker.js", import.meta.url));
+        worker.on("message", events.message);
+        worker.on("error", events.error);
+        worker.on("messageerror", events.error);
+        worker.on("exit", code => events.error(new Error(`Render worker exited with code ${code}`)));
+        return { post: (message, transfer) => worker.postMessage(message, transfer), terminate: () => void worker.terminate() };
+    },
 });
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +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"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC;IAC/F,aAAa,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpF,OAAO,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACtB,IAAI,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,WAAW,EAAE,MAAM,CAAC,EAAE;QACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;IAC1H,CAAC;CACF,CAAC,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,8 @@
+import type { normalizeOptions } from "./options.js";
+/** Normalized options without the resolver function, so they can be posted to a worker. */
+export type RenderOptions = Omit<ReturnType<typeof normalizeOptions>, "assetResolver">;
+export type LoadAssets = (urls: string[]) => Promise<Uint8Array[]>;
+export declare function validateHtml(html: unknown): asserts html is string;
+/** Requires an initialized WASM instance in the current thread. */
+export declare function render(html: string, options: RenderOptions, load?: LoadAssets): Promise<Uint8Array>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAAE,eAAe,CAAC,CAAC;AACvF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAEnE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAGlE;AAED,mEAAmE;AACnE,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAczG"}

package/dist/render.js

@@ -0,0 +1,28 @@
+import { render_pdf, RenderJob } from "../wasm/blitz_pdf.js";
+export function validateHtml(html) {
+    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");
+}
+/** Requires an initialized WASM instance in the current thread. */
+export async function render(html, options, load) {
+    if (!load)
+        return render_pdf(html, options);
+    const job = new RenderJob(html, options);
+    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();
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAO7D,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAC3E,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;AAC1H,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,OAAsB,EAAE,IAAiB;IAClF,IAAI,CAAC,IAAI;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;YAAS,CAAC;QACT,iFAAiF;QACjF,GAAG,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/wasm.d.ts

@@ -0,0 +1,3 @@
+import type { WasmSource } from "./types.js";
+export declare function compileWasm(source: WasmSource): Promise<WebAssembly.Module>;
+//# sourceMappingURL=wasm.d.ts.map

package/dist/wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../src/wasm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAcjF"}

package/dist/wasm.js

@@ -0,0 +1,18 @@
+export async function compileWasm(source) {
+    if (source instanceof WebAssembly.Module)
+        return source;
+    if (typeof source === "string" || source instanceof URL || (typeof Request === "function" && source instanceof Request)) {
+        source = await fetch(source);
+    }
+    if (typeof Response === "function" && source instanceof Response) {
+        if (!source.ok)
+            throw new Error(`Failed to fetch WASM: ${source.status} ${source.statusText} fetching '${source.url}'`);
+        // Streaming compilation rejects other MIME types, so fall back to buffering instead.
+        if (typeof WebAssembly.compileStreaming === "function" && source.headers.get("Content-Type") === "application/wasm") {
+            return WebAssembly.compileStreaming(source);
+        }
+        return WebAssembly.compile(await source.arrayBuffer());
+    }
+    return WebAssembly.compile(source);
+}
+//# sourceMappingURL=wasm.js.map

package/dist/wasm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.js","sourceRoot":"","sources":["../src/wasm.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAkB;IAClD,IAAI,MAAM,YAAY,WAAW,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IACxD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,OAAO,KAAK,UAAU,IAAI,MAAM,YAAY,OAAO,CAAC,EAAE,CAAC;QACxH,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,UAAU,IAAI,MAAM,YAAY,QAAQ,EAAE,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,cAAc,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACxH,qFAAqF;QACrF,IAAI,OAAO,WAAW,CAAC,gBAAgB,KAAK,UAAU,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,kBAAkB,EAAE,CAAC;YACpH,OAAO,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,WAAW,CAAC,OAAO,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,WAAW,CAAC,OAAO,CAAC,MAAsB,CAAC,CAAC;AACrD,CAAC"}

package/dist/worker-host.d.ts

@@ -0,0 +1,16 @@
+import type { RenderOptions } from "./render.js";
+import type { AssetResolver } from "./types.js";
+import type { HostMessage, WorkerMessage } from "./worker-protocol.js";
+export interface WorkerEvents {
+    message(message: WorkerMessage): void;
+    /** Crashes, unreadable messages, or an exit before the render settled. */
+    error(error: unknown): void;
+}
+export interface WorkerHandle {
+    post(message: HostMessage, transfer: ArrayBuffer[]): void;
+    terminate(): void;
+}
+export type SpawnWorker = (events: WorkerEvents) => WorkerHandle;
+/** Renders in a fresh worker that instantiates the precompiled module, then terminates it. */
+export declare function renderInWorker(spawn: SpawnWorker, module: WebAssembly.Module, html: string, options: RenderOptions, resolver: AssetResolver | undefined): Promise<Uint8Array>;
+//# sourceMappingURL=worker-host.d.ts.map

package/dist/worker-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-host.d.ts","sourceRoot":"","sources":["../src/worker-host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,0EAA0E;IAC1E,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC1D,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,YAAY,CAAC;AAEjE,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EACzF,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBlF"}

package/dist/worker-host.js

@@ -0,0 +1,31 @@
+import { createAssetLoader } from "./assets.js";
+/** Renders in a fresh worker that instantiates the precompiled module, then terminates it. */
+export function renderInWorker(spawn, module, html, options, resolver) {
+    return new Promise((resolve, reject) => {
+        const load = resolver && createAssetLoader(resolver);
+        let settled = false;
+        const settle = (callback) => {
+            if (settled)
+                return;
+            settled = true;
+            worker.terminate();
+            callback();
+        };
+        const worker = spawn({
+            message(message) {
+                if (message.type === "done")
+                    settle(() => resolve(message.pdf));
+                else if (message.type === "error")
+                    settle(() => reject(message.error));
+                else if (!load)
+                    settle(() => reject(new Error("Render worker requested assets without a resolver")));
+                else
+                    load(message.urls).then(data => { if (!settled)
+                        worker.post({ type: "assets", data }, data.map(bytes => bytes.buffer)); }, (error) => settle(() => reject(error)));
+            },
+            error(error) { settle(() => reject(error)); },
+        });
+        worker.post({ type: "render", module, html, options, external: load !== undefined }, []);
+    });
+}
+//# sourceMappingURL=worker-host.js.map

package/dist/worker-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-host.js","sourceRoot":"","sources":["../src/worker-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAkBhD,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,KAAkB,EAAE,MAA0B,EAAE,IAAY,EACzF,OAAsB,EAAE,QAAmC;IAC3D,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,QAAoB,EAAE,EAAE;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,SAAS,EAAE,CAAC;YACnB,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC;QACF,MAAM,MAAM,GAAiB,KAAK,CAAC;YACjC,OAAO,CAAC,OAAO;gBACb,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;oBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;qBAC3D,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;oBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;qBAClE,IAAI,CAAC,IAAI;oBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC;;oBAChG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAC1B,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,EAChH,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAChD,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,KAAK,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/worker-protocol.d.ts

@@ -0,0 +1,22 @@
+import type { RenderOptions } from "./render.js";
+export type HostMessage = {
+    type: "render";
+    module: WebAssembly.Module;
+    html: string;
+    options: RenderOptions;
+    external: boolean;
+} | {
+    type: "assets";
+    data: Uint8Array[];
+};
+export type WorkerMessage = {
+    type: "assets";
+    urls: string[];
+} | {
+    type: "done";
+    pdf: Uint8Array;
+} | {
+    type: "error";
+    error: unknown;
+};
+//# sourceMappingURL=worker-protocol.d.ts.map

package/dist/worker-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.d.ts","sourceRoot":"","sources":["../src/worker-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACvG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/worker-protocol.js

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

package/dist/worker-protocol.js.map

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

package/dist/worker-runtime.d.ts

@@ -0,0 +1,8 @@
+import type { HostMessage, WorkerMessage } from "./worker-protocol.js";
+export interface WorkerEndpoint {
+    post(message: WorkerMessage, transfer: ArrayBuffer[]): void;
+    onMessage(handler: (message: HostMessage) => void): void;
+}
+/** Worker side of `renderPdfInWorker`: one render per worker; asset bytes come from the host. */
+export declare function serve(endpoint: WorkerEndpoint): void;
+//# sourceMappingURL=worker-runtime.d.ts.map

package/dist/worker-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-runtime.d.ts","sourceRoot":"","sources":["../src/worker-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC5D,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;CAC1D;AAED,iGAAiG;AACjG,wBAAgB,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAwBpD"}

package/dist/worker-runtime.js

@@ -0,0 +1,34 @@
+import { initSync } from "../wasm/blitz_pdf.js";
+import { render } from "./render.js";
+/** Worker side of `renderPdfInWorker`: one render per worker; asset bytes come from the host. */
+export function serve(endpoint) {
+    let receiveAssets;
+    endpoint.onMessage(async (message) => {
+        if (message.type === "assets") {
+            const receive = receiveAssets;
+            receiveAssets = undefined;
+            receive?.(message.data);
+            return;
+        }
+        try {
+            initSync({ module: message.module });
+            const load = message.external
+                ? (urls) => new Promise(resolve => {
+                    receiveAssets = resolve;
+                    endpoint.post({ type: "assets", urls }, []);
+                })
+                : undefined;
+            const pdf = await render(message.html, message.options, load);
+            endpoint.post({ type: "done", pdf }, [pdf.buffer]);
+        }
+        catch (error) {
+            try {
+                endpoint.post({ type: "error", error }, []);
+            }
+            catch {
+                endpoint.post({ type: "error", error: new Error(String(error)) }, []);
+            }
+        }
+    });
+}
+//# sourceMappingURL=worker-runtime.js.map

package/dist/worker-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-runtime.js","sourceRoot":"","sources":["../src/worker-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC,iGAAiG;AACjG,MAAM,UAAU,KAAK,CAAC,QAAwB;IAC5C,IAAI,aAAyD,CAAC;IAC9D,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;QACjC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,aAAa,CAAC;YAC9B,aAAa,GAAG,SAAS,CAAC;YAC1B,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ;gBAC3B,CAAC,CAAC,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,OAAO,CAAe,OAAO,CAAC,EAAE;oBACxD,aAAa,GAAG,OAAO,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9C,CAAC,CAAC;gBACF,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAqB,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAAC,CAAC;YACpD,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAAC,CAAC;QAClF,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

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

package/dist/worker.js

@@ -0,0 +1,7 @@
+import { serve } from "./worker-runtime.js";
+const scope = globalThis;
+serve({
+    post: (message, transfer) => scope.postMessage(message, transfer),
+    onMessage: handler => { scope.onmessage = event => handler(event.data); },
+});
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAO5C,MAAM,KAAK,GAAG,UAA6C,CAAC;AAC5D,KAAK,CAAC;IACJ,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;IACjE,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CAC1E,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blitz-pdf",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Render HTML and CSS to PDF with Blitz and WebAssembly in Node.js, Bun, and browsers.",
   "type": "module",
   "license": "MIT",
@@ -15,7 +15,10 @@
   "engines": {
     "node": ">=20"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/worker.js",
+    "./dist/node-worker.js"
+  ],
   "main": "./dist/node.js",
   "module": "./dist/browser.js",
   "types": "./dist/node.d.ts",

package/src/api.ts

@@ -1,44 +1,55 @@
-import loadWasm, { render_pdf, engine_version, RenderJob } from "../wasm/blitz_pdf.js";
+import loadWasm, { engine_version } from "../wasm/blitz_pdf.js";
 import { createAssetLoader } from "./assets.js";
 import { normalizeOptions } from "./options.js";
+import { render, validateHtml } from "./render.js";
+import { compileWasm } from "./wasm.js";
+import { renderInWorker, type SpawnWorker } from "./worker-host.js";
 import type { InitOptions, PdfOptions, WasmSource } from "./types.js";
 
-export function createApi(defaultSource: () => Promise<WasmSource> | WasmSource,
-  prepare: (source: WasmSource) => Promise<WasmSource> = async source => source) {
+export interface ApiConfig {
+  defaultSource: () => Promise<WasmSource> | WasmSource;
+  prepare?: (source: WasmSource) => Promise<WasmSource>;
+  spawnWorker: SpawnWorker;
+}
+
+export function createApi({ defaultSource, prepare = async source => source, spawnWorker }: ApiConfig) {
+  let compiled: Promise<WebAssembly.Module> | undefined;
   let ready: Promise<void> | undefined;
 
+  function compile(source?: WasmSource): Promise<WebAssembly.Module> {
+    if (compiled) return compiled;
+    compiled = (async () => compileWasm(await prepare(source ?? await defaultSource())))()
+      .catch((error: unknown) => { compiled = undefined; throw error; });
+    return compiled;
+  }
+
   /** Initialize once. Concurrent callers share initialization; failed loads can be retried. */
   function init(options: InitOptions = {}): Promise<void> {
     if (ready) return ready;
     ready = (async () => {
-      const source = await prepare(options.wasm ?? await defaultSource());
-      await loadWasm({ module_or_path: source });
+      await loadWasm({ module_or_path: await compile(options.wasm) });
     })().catch((error: unknown) => { ready = undefined; throw error; });
     return ready;
   }
 
+  /** The compiled WASM module, compiled once and shared with every worker. It can be posted to your own workers. */
+  function getWasmModule(): Promise<WebAssembly.Module> { return compile(); }
+
   /** Render HTML/CSS to a vector PDF/A-3u with embedded fonts and selectable text. */
   async function renderPdf(html: string, options: PdfOptions = {}): Promise<Uint8Array> {
-    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");
+    validateHtml(html);
     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();
-    }
+    return render(html, normalized, assetResolver && createAssetLoader(assetResolver));
+  }
+
+  /** Like `renderPdf`, but layout and serialization run in a new worker. An `assets` function still runs on the calling thread. */
+  async function renderPdfInWorker(html: string, options: PdfOptions = {}): Promise<Uint8Array> {
+    validateHtml(html);
+    const { assetResolver, ...normalized } = normalizeOptions(options);
+    return renderInWorker(spawnWorker, await compile(), html, normalized, assetResolver);
   }
 
   async function getEngineVersion(): Promise<string> { await init(); return engine_version(); }
-  return { init, renderPdf, getEngineVersion };
+  return { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersion };
 }

package/src/browser.ts

@@ -1,6 +1,16 @@
 import { createApi } from "./api.js";
 
 export type { AssetData, AssetMap, AssetResolver, AttachmentRelationship, BinaryData, InitOptions, Length, PageFormat, PageNumberOptions, PdfAttachment, PdfDate, PdfMetadata, PdfOptions, PdfXmpProperty, PdfXmpSchema, WasmSource } from "./types.js";
-export const { init, renderPdf, getEngineVersion } = createApi(
-  () => new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url),
-);
+export const { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersion } = createApi({
+  defaultSource: () => new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url),
+  spawnWorker: events => {
+    const worker = new Worker(new URL("./worker.js", import.meta.url), { type: "module" });
+    worker.onmessage = event => events.message(event.data);
+    worker.onerror = event => {
+      event.preventDefault();
+      events.error(new Error(`Render worker failed: ${event.message || "unknown error"}`));
+    };
+    worker.onmessageerror = () => events.error(new Error("Render worker sent a message that could not be deserialized"));
+    return { post: (message, transfer) => worker.postMessage(message, transfer), terminate: () => worker.terminate() };
+  },
+});

package/src/node-worker.ts

@@ -0,0 +1,9 @@
+import { parentPort } from "node:worker_threads";
+import { serve } from "./worker-runtime.js";
+
+const port = parentPort;
+if (!port) throw new Error("blitz-pdf node-worker must run in a worker thread");
+serve({
+  post: (message, transfer) => port.postMessage(message, transfer),
+  onMessage: handler => { port.on("message", handler); },
+});

package/src/node.ts

@@ -1,12 +1,21 @@
 import { readFile } from "node:fs/promises";
+import { Worker } from "node:worker_threads";
 import { createApi } from "./api.js";
 
 export type { AssetData, AssetMap, AssetResolver, AttachmentRelationship, BinaryData, InitOptions, Length, PageFormat, PageNumberOptions, PdfAttachment, PdfDate, PdfMetadata, PdfOptions, PdfXmpProperty, PdfXmpSchema, WasmSource } from "./types.js";
-export const { init, renderPdf, getEngineVersion } = createApi(
-  () => readFile(new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url)),
-  async source => {
+export const { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersion } = createApi({
+  defaultSource: () => readFile(new URL("../wasm/blitz_pdf_bg.wasm", import.meta.url)),
+  prepare: 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;
   },
-);
+  spawnWorker: events => {
+    const worker = new Worker(new URL("./node-worker.js", import.meta.url));
+    worker.on("message", events.message);
+    worker.on("error", events.error);
+    worker.on("messageerror", events.error);
+    worker.on("exit", code => events.error(new Error(`Render worker exited with code ${code}`)));
+    return { post: (message, transfer) => worker.postMessage(message, transfer), terminate: () => void worker.terminate() };
+  },
+});

package/src/render.ts

@@ -0,0 +1,28 @@
+import { render_pdf, RenderJob } from "../wasm/blitz_pdf.js";
+import type { normalizeOptions } from "./options.js";
+
+/** Normalized options without the resolver function, so they can be posted to a worker. */
+export type RenderOptions = Omit<ReturnType<typeof normalizeOptions>, "assetResolver">;
+export type LoadAssets = (urls: string[]) => Promise<Uint8Array[]>;
+
+export function validateHtml(html: unknown): asserts html is string {
+  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");
+}
+
+/** Requires an initialized WASM instance in the current thread. */
+export async function render(html: string, options: RenderOptions, load?: LoadAssets): Promise<Uint8Array> {
+  if (!load) return render_pdf(html, options);
+  const job = new RenderJob(html, options);
+  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();
+  }
+}

package/src/wasm.ts

@@ -0,0 +1,17 @@
+import type { WasmSource } from "./types.js";
+
+export async function compileWasm(source: WasmSource): Promise<WebAssembly.Module> {
+  if (source instanceof WebAssembly.Module) return source;
+  if (typeof source === "string" || source instanceof URL || (typeof Request === "function" && source instanceof Request)) {
+    source = await fetch(source);
+  }
+  if (typeof Response === "function" && source instanceof Response) {
+    if (!source.ok) throw new Error(`Failed to fetch WASM: ${source.status} ${source.statusText} fetching '${source.url}'`);
+    // Streaming compilation rejects other MIME types, so fall back to buffering instead.
+    if (typeof WebAssembly.compileStreaming === "function" && source.headers.get("Content-Type") === "application/wasm") {
+      return WebAssembly.compileStreaming(source);
+    }
+    return WebAssembly.compile(await source.arrayBuffer());
+  }
+  return WebAssembly.compile(source as BufferSource);
+}

package/src/worker-host.ts

@@ -0,0 +1,45 @@
+import { createAssetLoader } from "./assets.js";
+import type { RenderOptions } from "./render.js";
+import type { AssetResolver } from "./types.js";
+import type { HostMessage, WorkerMessage } from "./worker-protocol.js";
+
+export interface WorkerEvents {
+  message(message: WorkerMessage): void;
+  /** Crashes, unreadable messages, or an exit before the render settled. */
+  error(error: unknown): void;
+}
+
+export interface WorkerHandle {
+  post(message: HostMessage, transfer: ArrayBuffer[]): void;
+  terminate(): void;
+}
+
+export type SpawnWorker = (events: WorkerEvents) => WorkerHandle;
+
+/** Renders in a fresh worker that instantiates the precompiled module, then terminates it. */
+export function renderInWorker(spawn: SpawnWorker, module: WebAssembly.Module, html: string,
+  options: RenderOptions, resolver: AssetResolver | undefined): Promise<Uint8Array> {
+  return new Promise<Uint8Array>((resolve, reject) => {
+    const load = resolver && createAssetLoader(resolver);
+    let settled = false;
+    const settle = (callback: () => void) => {
+      if (settled) return;
+      settled = true;
+      worker.terminate();
+      callback();
+    };
+    const worker: WorkerHandle = spawn({
+      message(message) {
+        if (message.type === "done") settle(() => resolve(message.pdf));
+        else if (message.type === "error") settle(() => reject(message.error));
+        else if (!load) settle(() => reject(new Error("Render worker requested assets without a resolver")));
+        else load(message.urls).then(
+          data => { if (!settled) worker.post({ type: "assets", data }, data.map(bytes => bytes.buffer as ArrayBuffer)); },
+          (error: unknown) => settle(() => reject(error)),
+        );
+      },
+      error(error) { settle(() => reject(error)); },
+    });
+    worker.post({ type: "render", module, html, options, external: load !== undefined }, []);
+  });
+}

package/src/worker-protocol.ts

@@ -0,0 +1,10 @@
+import type { RenderOptions } from "./render.js";
+
+export type HostMessage =
+  | { type: "render"; module: WebAssembly.Module; html: string; options: RenderOptions; external: boolean }
+  | { type: "assets"; data: Uint8Array[] };
+
+export type WorkerMessage =
+  | { type: "assets"; urls: string[] }
+  | { type: "done"; pdf: Uint8Array }
+  | { type: "error"; error: unknown };

package/src/worker-runtime.ts

@@ -0,0 +1,35 @@
+import { initSync } from "../wasm/blitz_pdf.js";
+import { render } from "./render.js";
+import type { HostMessage, WorkerMessage } from "./worker-protocol.js";
+
+export interface WorkerEndpoint {
+  post(message: WorkerMessage, transfer: ArrayBuffer[]): void;
+  onMessage(handler: (message: HostMessage) => void): void;
+}
+
+/** Worker side of `renderPdfInWorker`: one render per worker; asset bytes come from the host. */
+export function serve(endpoint: WorkerEndpoint): void {
+  let receiveAssets: ((data: Uint8Array[]) => void) | undefined;
+  endpoint.onMessage(async message => {
+    if (message.type === "assets") {
+      const receive = receiveAssets;
+      receiveAssets = undefined;
+      receive?.(message.data);
+      return;
+    }
+    try {
+      initSync({ module: message.module });
+      const load = message.external
+        ? (urls: string[]) => new Promise<Uint8Array[]>(resolve => {
+          receiveAssets = resolve;
+          endpoint.post({ type: "assets", urls }, []);
+        })
+        : undefined;
+      const pdf = await render(message.html, message.options, load);
+      endpoint.post({ type: "done", pdf }, [pdf.buffer as ArrayBuffer]);
+    } catch (error) {
+      try { endpoint.post({ type: "error", error }, []); }
+      catch { endpoint.post({ type: "error", error: new Error(String(error)) }, []); }
+    }
+  });
+}

package/src/worker.ts

@@ -0,0 +1,12 @@
+import { serve } from "./worker-runtime.js";
+
+interface DedicatedWorkerScope {
+  postMessage(message: unknown, transfer: Transferable[]): void;
+  onmessage: ((event: MessageEvent) => void) | null;
+}
+
+const scope = globalThis as unknown as DedicatedWorkerScope;
+serve({
+  post: (message, transfer) => scope.postMessage(message, transfer),
+  onMessage: handler => { scope.onmessage = event => handler(event.data); },
+});