blitz-pdf 0.1.7 → 0.1.8

package/dist/worker-runtime.js

@@ -1,34 +1,50 @@
 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. */
+/** One document at a time; retain the initialized engine and its bundled-font cache. */
 export function serve(endpoint) {
+    let initialized = false;
+    let activeId;
     let receiveAssets;
     endpoint.onMessage(async (message) => {
         if (message.type === "assets") {
+            if (message.id !== activeId)
+                return;
             const receive = receiveAssets;
             receiveAssets = undefined;
             receive?.(message.data);
             return;
         }
+        if (activeId !== undefined) {
+            endpoint.post({ type: "error", id: message.id, error: new Error("Worker already has an active document") }, []);
+            return;
+        }
+        activeId = message.id;
         try {
-            initSync({ module: message.module });
+            if (!initialized) {
+                initSync({ module: message.module });
+                initialized = true;
+            }
             const load = message.external
                 ? (urls) => new Promise(resolve => {
                     receiveAssets = resolve;
-                    endpoint.post({ type: "assets", urls }, []);
+                    endpoint.post({ type: "assets", id: message.id, urls }, []);
                 })
                 : undefined;
             const pdf = await render(message.html, message.options, load);
-            endpoint.post({ type: "done", pdf }, [pdf.buffer]);
+            endpoint.post({ type: "done", id: message.id, pdf }, [pdf.buffer]);
         }
         catch (error) {
             try {
-                endpoint.post({ type: "error", error }, []);
+                endpoint.post({ type: "error", id: message.id, error }, []);
             }
             catch {
-                endpoint.post({ type: "error", error: new Error(String(error)) }, []);
+                endpoint.post({ type: "error", id: message.id, error: new Error(String(error)) }, []);
             }
         }
+        finally {
+            activeId = undefined;
+            receiveAssets = undefined;
+        }
     });
 }
 //# sourceMappingURL=worker-runtime.js.map

package/dist/worker-runtime.js.map

@@ -1 +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"}
+{"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,wFAAwF;AACxF,MAAM,UAAU,KAAK,CAAC,QAAwB;IAC5C,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,QAA4B,CAAC;IACjC,IAAI,aAAyD,CAAC;IAC9D,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;QACjC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,OAAO,CAAC,EAAE,KAAK,QAAQ;gBAAE,OAAO;YACpC,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,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,uCAAuC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAChH,OAAO;QACT,CAAC;QACD,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACrC,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;YACD,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,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9D,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,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAqB,CAAC,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAAC,CAAC;YACpE,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAAC,CAAC;QAClG,CAAC;gBAAS,CAAC;YACT,QAAQ,GAAG,SAAS,CAAC;YACrB,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/licenses/RUST_DEPENDENCIES.txt

@@ -49,19 +49,19 @@ bitflags 2.13.2
 License: MIT OR Apache-2.0
 Source: https://github.com/bitflags/bitflags
 
-blitz-dom 0.3.0-beta.3
+blitz-dom 0.3.0-beta.4
 License: MIT OR Apache-2.0
 Source: https://github.com/dioxuslabs/blitz
 
-blitz-html 0.3.0-beta.3
+blitz-html 0.3.0-beta.4
 License: MIT OR Apache-2.0
 Source: https://github.com/dioxuslabs/blitz
 
-blitz-paint 0.3.0-beta.3
+blitz-paint 0.3.0-beta.4
 License: MIT OR Apache-2.0
 Source: https://github.com/dioxuslabs/blitz
 
-blitz-traits 0.3.0-beta.3
+blitz-traits 0.3.0-beta.4
 License: MIT OR Apache-2.0
 Source: https://github.com/dioxuslabs/blitz
 
@@ -121,7 +121,7 @@ core_maths 0.1.1
 License: MIT
 Source: https://github.com/robertbastian/core_maths
 
-crc32fast 1.5.2
+crc32fast 1.5.3
 License: MIT OR Apache-2.0
 Source: https://github.com/srijs/rust-crc32fast
 
@@ -197,7 +197,7 @@ encoding_rs 0.8.42
 License: (Apache-2.0 OR MIT) AND BSD-3-Clause
 Source: https://github.com/hsivonen/encoding_rs
 
-equivalent 1.0.2
+equivalent 1.0.3
 License: Apache-2.0 OR MIT
 Source: https://github.com/indexmap-rs/equivalent
 
@@ -233,7 +233,7 @@ font-types 0.11.3
 License: MIT OR Apache-2.0
 Source: https://github.com/googlefonts/fontations
 
-font-types 0.12.6
+font-types 0.12.7
 License: MIT OR Apache-2.0
 Source: https://github.com/googlefonts/fontations
 
@@ -385,9 +385,9 @@ js-sys 0.3.106
 License: MIT OR Apache-2.0
 Source: https://github.com/wasm-bindgen/wasm-bindgen/tree/master/crates/js-sys
 
-keyboard-types 0.7.0
+keyboard-types 0.8.3
 License: MIT OR Apache-2.0
-Source: https://github.com/pyfisch/keyboard-types
+Source: https://github.com/rust-windowing/keyboard-types
 
 krilla 0.8.2
 License: MIT OR Apache-2.0
@@ -397,7 +397,7 @@ kurbo 0.13.1
 License: Apache-2.0 OR MIT
 Source: https://github.com/linebender/kurbo
 
-libc 0.2.190
+libc 0.2.191
 License: MIT OR Apache-2.0
 Source: https://github.com/rust-lang/libc
 
@@ -721,7 +721,7 @@ smallvec 1.16.3
 License: MIT OR Apache-2.0
 Source: https://github.com/servo/rust-smallvec
 
-smol_str 0.3.6
+smol_str 0.3.7
 License: MIT OR Apache-2.0
 Source: https://github.com/rust-lang/rust-analyzer/tree/master/lib/smol_str
 
@@ -777,7 +777,7 @@ stylo_static_prefs 0.22.0
 License: MPL-2.0
 Source: https://github.com/servo/stylo
 
-stylo_taffy 0.3.0-beta.3
+stylo_taffy 0.3.0-beta.4
 License: MIT OR Apache-2.0 OR MPL-2.0
 Source: https://github.com/dioxuslabs/blitz
 
@@ -877,10 +877,6 @@ unicode-script 0.5.8
 License: MIT OR Apache-2.0
 Source: https://github.com/unicode-rs/unicode-script
 
-unicode-segmentation 1.13.3
-License: MIT OR Apache-2.0
-Source: https://github.com/unicode-rs/unicode-segmentation
-
 unicode-vo 0.1.0
 License: MIT/Apache-2.0
 Source: https://github.com/RazrFalcon/unicode-vo
@@ -1263,7 +1259,7 @@ serde_bytes 0.11.19 (LICENSE-MIT)
 serde_core 1.0.229 (LICENSE-MIT)
 serde_derive 1.0.229 (LICENSE-MIT)
 servo_arc 0.5.0 (LICENSE-MIT)
-smol_str 0.3.6 (LICENSE-MIT)
+smol_str 0.3.7 (LICENSE-MIT)
 stylo_malloc_size_of 0.22.0 (LICENSE-MIT)
 syn 2.0.119 (LICENSE-MIT)
 syn 3.0.9 (LICENSE-MIT)
@@ -1361,7 +1357,7 @@ crossbeam-utils 0.8.23 (LICENSE-APACHE)
 data-url 0.3.2 (LICENSE-APACHE)
 displaydoc 0.2.7 (LICENSE-APACHE)
 either 1.19.0 (LICENSE-APACHE)
-equivalent 1.0.2 (LICENSE-APACHE)
+equivalent 1.0.3 (LICENSE-APACHE)
 euclid 0.22.14 (LICENSE-APACHE)
 fastrand 2.5.0 (LICENSE-APACHE)
 flate2 1.1.10 (LICENSE-APACHE)
@@ -1404,7 +1400,7 @@ servo_arc 0.5.0 (LICENSE-APACHE)
 simplecss 0.2.2 (LICENSE-APACHE)
 smallbitvec 2.6.1 (LICENSE-APACHE)
 smallvec 1.16.3 (LICENSE-APACHE)
-smol_str 0.3.6 (LICENSE-APACHE)
+smol_str 0.3.7 (LICENSE-APACHE)
 stable_deref_trait 1.2.1 (LICENSE-APACHE)
 string_cache 0.11.0 (LICENSE-APACHE)
 string_cache_codegen 0.11.2 (LICENSE-APACHE)
@@ -1413,7 +1409,6 @@ svgtypes 0.16.1 (LICENSE-APACHE)
 tendril 0.5.1 (LICENSE-APACHE)
 thread_local 1.1.10 (LICENSE-APACHE)
 unicode-bidi 0.3.18 (LICENSE-APACHE)
-unicode-segmentation 1.13.3 (LICENSE-APACHE)
 unicode-vo 0.1.0 (LICENSE-APACHE)
 url 2.5.8 (LICENSE-APACHE)
 version_check 0.9.5 (LICENSE-APACHE)
@@ -2016,13 +2011,13 @@ DEALINGS IN THE SOFTWARE.
 
 
 ========================================================================
-blitz-dom 0.3.0-beta.3 (LICENSE-APACHE)
-blitz-html 0.3.0-beta.3 (LICENSE-APACHE)
-blitz-paint 0.3.0-beta.3 (LICENSE-APACHE)
-blitz-traits 0.3.0-beta.3 (LICENSE-APACHE)
+blitz-dom 0.3.0-beta.4 (LICENSE-APACHE)
+blitz-html 0.3.0-beta.4 (LICENSE-APACHE)
+blitz-paint 0.3.0-beta.4 (LICENSE-APACHE)
+blitz-traits 0.3.0-beta.4 (LICENSE-APACHE)
 debug_timer 0.1.3 (LICENSE-APACHE)
 rustc-hash 2.1.3 (LICENSE-APACHE)
-stylo_taffy 0.3.0-beta.3 (LICENSE-APACHE)
+stylo_taffy 0.3.0-beta.4 (LICENSE-APACHE)
 ========================================================================
 
                               Apache License
@@ -2203,13 +2198,13 @@ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 END OF TERMS AND CONDITIONS
 
 ========================================================================
-blitz-dom 0.3.0-beta.3 (LICENSE-MIT)
-blitz-html 0.3.0-beta.3 (LICENSE-MIT)
-blitz-paint 0.3.0-beta.3 (LICENSE-MIT)
-blitz-traits 0.3.0-beta.3 (LICENSE-MIT)
+blitz-dom 0.3.0-beta.4 (LICENSE-MIT)
+blitz-html 0.3.0-beta.4 (LICENSE-MIT)
+blitz-paint 0.3.0-beta.4 (LICENSE-MIT)
+blitz-traits 0.3.0-beta.4 (LICENSE-MIT)
 debug_timer 0.1.3 (LICENSE-MIT)
 rustc-hash 2.1.3 (LICENSE-MIT)
-stylo_taffy 0.3.0-beta.3 (LICENSE-MIT)
+stylo_taffy 0.3.0-beta.4 (LICENSE-MIT)
 ========================================================================
 
 Permission is hereby granted, free of charge, to any
@@ -2946,7 +2941,7 @@ SOFTWARE.
 ========================================================================
 core_detect 1.0.0 (LICENSE-APACHE)
 gif 0.14.2 (LICENSE-APACHE)
-keyboard-types 0.7.0 (LICENSE-APACHE)
+keyboard-types 0.8.3 (LICENSE-APACHE)
 weezl 0.1.12 (LICENSE-APACHE)
 ========================================================================
 
@@ -3210,7 +3205,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ========================================================================
-crc32fast 1.5.2 (LICENSE-APACHE)
+crc32fast 1.5.3 (LICENSE-APACHE)
 quick-error 2.0.1 (LICENSE-APACHE)
 ========================================================================
 
@@ -3419,7 +3414,7 @@ quick-error 2.0.1 (LICENSE-APACHE)
 
 
 ========================================================================
-crc32fast 1.5.2 (LICENSE-MIT)
+crc32fast 1.5.3 (LICENSE-MIT)
 ========================================================================
 
 MIT License
@@ -4204,7 +4199,7 @@ SOFTWARE.
 ========================================================================
 dtoa 1.0.11 (LICENSE-APACHE)
 itoa 1.0.18 (LICENSE-APACHE)
-libc 0.2.190 (LICENSE-APACHE)
+libc 0.2.191 (LICENSE-APACHE)
 parley_engine 0.12.0 (LICENSE-APACHE)
 pdf-writer 0.15.0 (LICENSE-APACHE)
 proc-macro2 1.0.107 (LICENSE-APACHE)
@@ -5095,7 +5090,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 
 ========================================================================
-equivalent 1.0.2 (LICENSE-MIT)
+equivalent 1.0.3 (LICENSE-MIT)
 ========================================================================
 
 Copyright (c) 2016--2023
@@ -5602,7 +5597,7 @@ DEALINGS IN THE SOFTWARE.
 
 
 ========================================================================
-font-types 0.12.6 (LICENSE-APACHE)
+font-types 0.12.7 (LICENSE-APACHE)
 read-fonts 0.41.0 (LICENSE-APACHE)
 skrifa 0.44.0 (LICENSE-APACHE)
 ========================================================================
@@ -5677,7 +5672,7 @@ limitations under the License.
 
 
 ========================================================================
-font-types 0.12.6 (LICENSE-MIT)
+font-types 0.12.7 (LICENSE-MIT)
 read-fonts 0.41.0 (LICENSE-MIT)
 skrifa 0.44.0 (LICENSE-MIT)
 ========================================================================
@@ -6158,7 +6153,6 @@ DEALINGS IN THE SOFTWARE.
 ========================================================================
 heck 0.5.0 (LICENSE-MIT)
 unicode-bidi 0.3.18 (LICENSE-MIT)
-unicode-segmentation 1.13.3 (LICENSE-MIT)
 ========================================================================
 
 Copyright (c) 2015 The Rust Project Developers
@@ -6677,7 +6671,7 @@ DEALINGS IN THE SOFTWARE.
 
 
 ========================================================================
-keyboard-types 0.7.0 (LICENSE-MIT)
+keyboard-types 0.8.3 (LICENSE-MIT)
 ========================================================================
 
 Copyright (c) 2017 Pyfisch
@@ -6760,7 +6754,7 @@ DEALINGS IN THE SOFTWARE.
 
 
 ========================================================================
-libc 0.2.190 (LICENSE-MIT)
+libc 0.2.191 (LICENSE-MIT)
 ========================================================================
 
 Copyright (c) The Rust Project Developers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blitz-pdf",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Render HTML and CSS to PDF with Blitz and WebAssembly in Node.js, Bun, and browsers.",
   "type": "module",
   "license": "MIT",

package/src/api.ts

@@ -3,8 +3,8 @@ 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";
+import { createWorkerPool, type SpawnWorker } from "./worker-host.js";
+import type { InitOptions, PdfOptions, PdfWorkerPool, PdfWorkerPoolOptions, WasmSource } from "./types.js";
 
 export interface ApiConfig {
   defaultSource: () => Promise<WasmSource> | WasmSource;
@@ -15,6 +15,7 @@ export interface ApiConfig {
 export function createApi({ defaultSource, prepare = async source => source, spawnWorker }: ApiConfig) {
   let compiled: Promise<WebAssembly.Module> | undefined;
   let ready: Promise<void> | undefined;
+  let defaultPool: PdfWorkerPool | undefined;
 
   function compile(source?: WasmSource): Promise<WebAssembly.Module> {
     if (compiled) return compiled;
@@ -43,13 +44,37 @@ export function createApi({ defaultSource, prepare = async source => source, spa
     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. */
+  /** Create an owned pool, with independent concurrency and shutdown. No workers start until needed. */
+  function createPdfWorkerPool(options: PdfWorkerPoolOptions = {}): PdfWorkerPool {
+    const pool = createWorkerPool(spawnWorker, options);
+    // Include compilation in accepted work so close also drains renders waiting for WASM.
+    const pending = new Set<Promise<Uint8Array>>();
+    let closing: Promise<void> | undefined;
+    return {
+      renderPdf(html: string, options: PdfOptions = {}): Promise<Uint8Array> {
+        if (closing) return Promise.reject(new Error("PDF worker pool is closed"));
+        const work = (async () => {
+          validateHtml(html);
+          const { assetResolver, ...normalized } = normalizeOptions(options);
+          return pool.render(await compile(), html, normalized, assetResolver);
+        })();
+        pending.add(work);
+        void work.then(() => pending.delete(work), () => pending.delete(work));
+        return work;
+      },
+      close(): Promise<void> {
+        closing ??= Promise.allSettled([...pending]).then(() => pool.close());
+        return closing;
+      },
+    };
+  }
+
+  /** Render in the shared bounded pool. 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);
+    defaultPool ??= createPdfWorkerPool();
+    return defaultPool.renderPdf(html, options);
   }
 
   async function getEngineVersion(): Promise<string> { await init(); return engine_version(); }
-  return { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersion };
+  return { init, renderPdf, renderPdfInWorker, createPdfWorkerPool, getWasmModule, getEngineVersion };
 }

package/src/browser.ts

@@ -1,7 +1,8 @@
 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, renderPdfInWorker, getWasmModule, getEngineVersion } = createApi({
+export type { PdfWorkerPool, PdfWorkerPoolOptions } from "./types.js";
+export const { init, renderPdf, renderPdfInWorker, createPdfWorkerPool, 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" });

package/src/node.ts

@@ -3,7 +3,8 @@ 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, renderPdfInWorker, getWasmModule, getEngineVersion } = createApi({
+export type { PdfWorkerPool, PdfWorkerPoolOptions } from "./types.js";
+export const { init, renderPdf, renderPdfInWorker, createPdfWorkerPool, 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);
@@ -16,6 +17,10 @@ export const { init, renderPdf, renderPdfInWorker, getWasmModule, getEngineVersi
     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() };
+    return {
+      post: (message, transfer) => worker.postMessage(message, transfer),
+      terminate: async () => { await worker.terminate(); },
+      ref: () => { worker.ref(); }, unref: () => { worker.unref(); },
+    };
   },
 });

package/src/types.ts

@@ -123,3 +123,18 @@ export interface PdfOptions {
   /** Reject larger documents. Default: 100; maximum: 1000. */
   maxPages?: number;
 }
+/** Limits for a pool of reusable, independent PDF engines. */
+export interface PdfWorkerPoolOptions {
+  /** Maximum simultaneous renders. Default: 4. */
+  maxWorkers?: number;
+  /** Release an unused worker after this many milliseconds. Default: 30000; 0 disables reuse. */
+  idleTimeoutMs?: number;
+  /** Recreate a worker after this many documents to bound retained engine memory. Default: 100. */
+  maxJobsPerWorker?: number;
+}
+
+export interface PdfWorkerPool {
+  renderPdf(html: string, options?: PdfOptions): Promise<Uint8Array>;
+  /** Stop accepting work, finish accepted renders, and release every worker. Idempotent. */
+  close(): Promise<void>;
+}

package/src/worker-host.ts

@@ -1,45 +1,164 @@
 import { createAssetLoader } from "./assets.js";
 import type { RenderOptions } from "./render.js";
-import type { AssetResolver } from "./types.js";
+import type { AssetResolver, PdfWorkerPoolOptions } 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. */
+  /** Crashes, unreadable messages, or an unexpected exit, including while idle. */
   error(error: unknown): void;
 }
 
 export interface WorkerHandle {
   post(message: HostMessage, transfer: ArrayBuffer[]): void;
-  terminate(): void;
+  terminate(): void | Promise<void>;
+  ref?(): void;
+  unref?(): 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 }, []);
-  });
+interface Job {
+  id: number;
+  message: Extract<HostMessage, { type: "render" }>;
+  load: ReturnType<typeof createAssetLoader> | undefined;
+  resolve(pdf: Uint8Array): void;
+  reject(error: unknown): void;
+}
+
+interface Slot {
+  worker?: WorkerHandle;
+  job?: Job;
+  timer?: ReturnType<typeof setTimeout>;
+  completed: number;
+  retired: boolean;
+}
+
+function integer(value: number, min: number, max: number, name: string): number {
+  if (!Number.isSafeInteger(value) || value < min || value > max) {
+    throw new RangeError(`${name} must be an integer from ${min} to ${max}`);
+  }
+  return value;
+}
+
+/** Jobs have their own resolver and document; only the initialized engine survives. */
+export function createWorkerPool(spawn: SpawnWorker, options: PdfWorkerPoolOptions = {}) {
+  const maxWorkers = integer(options.maxWorkers ?? 4, 1, Number.MAX_SAFE_INTEGER, "maxWorkers");
+  const idleTimeoutMs = integer(options.idleTimeoutMs ?? 30_000, 0, 2_147_483_647, "idleTimeoutMs");
+  const maxJobs = integer(options.maxJobsPerWorker ?? 100, 1, Number.MAX_SAFE_INTEGER, "maxJobsPerWorker");
+  const slots = new Set<Slot>();
+  const queue: Job[] = [];
+  const terminating = new Set<Promise<void>>();
+  let nextId = 0;
+  let closing: Promise<void> | undefined;
+  let resolveClosed: (() => void) | undefined;
+  let pumping = false;
+
+  function checkClosed() {
+    if (closing && queue.length === 0 && slots.size === 0 && terminating.size === 0) resolveClosed?.();
+  }
+
+  function retire(slot: Slot) {
+    if (slot.retired) return;
+    slot.retired = true;
+    clearTimeout(slot.timer);
+    slots.delete(slot);
+    // Observe asynchronous termination before close resolves; late exit events are ignored.
+    const done = Promise.resolve().then(() => slot.worker?.terminate()).then(() => {}, () => {});
+    terminating.add(done);
+    void done.then(() => { terminating.delete(done); checkClosed(); });
+  }
+
+  function fail(slot: Slot, error: unknown) {
+    if (slot.retired) return;
+    const job = slot.job;
+    delete slot.job;
+    retire(slot);
+    job?.reject(error);
+    pump();
+  }
+
+  function release(slot: Slot) {
+    slot.completed++;
+    if (slot.completed >= maxJobs || idleTimeoutMs === 0 || (closing && queue.length === 0)) {
+      retire(slot);
+    } else if (queue.length === 0) {
+      slot.worker?.unref?.();
+      slot.timer = setTimeout(() => { retire(slot); checkClosed(); }, idleTimeoutMs);
+      // A warm worker and its eviction timer must not keep a CLI alive.
+      slot.timer.unref?.();
+    }
+    pump();
+  }
+
+  function message(slot: Slot, value: WorkerMessage) {
+    const job = slot.job;
+    if (slot.retired || !job || value.id !== job.id) return;
+    if (value.type === "done") {
+      delete slot.job;
+      release(slot);
+      job.resolve(value.pdf);
+    } else if (value.type === "error") {
+      fail(slot, value.error);
+    } else if (!job.load) {
+      fail(slot, new Error("Render worker requested assets without a resolver"));
+    } else {
+      void job.load(value.urls).then(data => {
+        // Resolver promises can finish after a crash or retirement. Never send them to another job.
+        if (slot.retired || slot.job !== job) return;
+        try {
+          slot.worker!.post({ type: "assets", id: job.id, data }, data.map(bytes => bytes.buffer as ArrayBuffer));
+        } catch (error) { fail(slot, error); }
+      }, error => { if (!slot.retired && slot.job === job) fail(slot, error); });
+    }
+  }
+
+  function pump() {
+    if (pumping) return;
+    pumping = true;
+    try {
+      while (queue.length > 0) {
+        let slot = [...slots].find(candidate => !candidate.job);
+        if (!slot && slots.size >= maxWorkers) break;
+        const job = queue.shift()!;
+        if (!slot) {
+          slot = { completed: 0, retired: false, job };
+          slots.add(slot);
+          const created = slot;
+          try {
+            created.worker = spawn({ message: value => message(created, value), error: error => fail(created, error) });
+          } catch (error) { fail(created, error); continue; }
+        } else {
+          clearTimeout(slot.timer);
+          delete slot.timer;
+          slot.job = job;
+        }
+        try {
+          slot.worker!.ref?.();
+          slot.worker!.post(job.message, []);
+        } catch (error) { fail(slot, error); }
+      }
+      if (closing && queue.length === 0) for (const slot of slots) if (!slot.job) retire(slot);
+    } finally { pumping = false; }
+    checkClosed();
+  }
+
+  return {
+    render(module: WebAssembly.Module, html: string, options: RenderOptions, resolver?: AssetResolver): Promise<Uint8Array> {
+      if (closing) return Promise.reject(new Error("PDF worker pool is closed"));
+      return new Promise((resolve, reject) => {
+        const id = ++nextId;
+        queue.push({ id, message: { type: "render", id, module, html, options, external: resolver !== undefined },
+          load: resolver ? createAssetLoader(resolver) : undefined, resolve, reject });
+        pump();
+      });
+    },
+    close(): Promise<void> {
+      if (!closing) {
+        closing = new Promise(resolve => { resolveClosed = resolve; });
+        pump();
+      }
+      return closing;
+    },
+  };
 }

package/src/worker-protocol.ts

@@ -1,10 +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[] };
+  | { type: "render"; id: number; module: WebAssembly.Module; html: string; options: RenderOptions; external: boolean }
+  | { type: "assets"; id: number; data: Uint8Array[] };
 
 export type WorkerMessage =
-  | { type: "assets"; urls: string[] }
-  | { type: "done"; pdf: Uint8Array }
-  | { type: "error"; error: unknown };
+  | { type: "assets"; id: number; urls: string[] }
+  | { type: "done"; id: number; pdf: Uint8Array }
+  | { type: "error"; id: number; error: unknown };