ocjs-fluidcad 1.7.0 → 1.8.0

package/dist/index.d.ts

@@ -13,9 +13,22 @@ import type { OpenCascadeInstance } from "./opencascade.fluidcad.multi-threaded.
 // deprecated-name `export type` aliases, FS, OCJS, … (everything but `init`).
 export * from "./opencascade.fluidcad.multi-threaded.js";
 
+/** Options for {@link init}: Emscripten Module overrides plus the worker pool size. */
+export interface InitOptions extends Record<string, unknown> {
+  /**
+   * pthread workers to pre-spawn for OCCT's parallel algorithms (booleans, meshing).
+   * Defaults to one per logical CPU. When set (>= 1), OCCT's default thread pool is
+   * capped at the same count, so OCCT never asks for more threads than the pool holds.
+   * `OSD_ThreadPool.DefaultPool().Init(n)` changes OCCT's count later. The pre-spawned
+   * workers stay for the life of the instance; raising the count past them spawns more
+   * on demand under Node, but can deadlock a browser.
+   */
+  pthreadPoolSize?: number;
+}
+
 /**
  * Initialize the multi-threaded OCCT V8 module. The returned instance exposes the
  * canonical (mangled) classes AND the restored deprecated OCCT names.
- * @param options Emscripten Module overrides (e.g. `locateFile`).
+ * @param options Emscripten Module overrides (e.g. `locateFile`) and `pthreadPoolSize`.
  */
-export default function init(options?: Record<string, unknown>): Promise<OpenCascadeInstance>;
+export default function init(options?: InitOptions): Promise<OpenCascadeInstance>;

package/dist/index.js

@@ -13,13 +13,20 @@
 // twice"; see FORK_PLAN.md §5.)
 //
 // Consumers who want the un-aliased module can import "<pkg>/raw".
+//
+// `pthreadPoolSize` sizes the pthread worker pool the runtime pre-spawns (default:
+// one per logical CPU). It also caps OCCT's default thread pool at the same count,
+// before any parallel algorithm can run: otherwise OCCT sizes its pool from the CPU
+// count and asks for more threads than were pre-spawned, which Node absorbs by
+// spawning workers on demand but which can deadlock a browser.
 
 import rawInit from "./opencascade.fluidcad.multi-threaded.js";
 import ALIASES from "./aliases.generated.js";
 
 /**
  * Initialize the OCCT V8 WASM module with deprecated OCCT type names restored.
- * @param {Record<string, unknown>} [options] Emscripten Module overrides (e.g. `locateFile`).
+ * @param {Record<string, unknown> & { pthreadPoolSize?: number }} [options] Emscripten
+ *   Module overrides (e.g. `locateFile`), plus `pthreadPoolSize`.
  * @returns {Promise<any>} the initialized instance (canonical + deprecated names).
  */
 export default async function init(options) {
@@ -30,5 +37,11 @@ export default async function init(options) {
       oc[alias] = oc[canonical];
     }
   }
+  const poolSize = options?.pthreadPoolSize;
+  if (Number.isInteger(poolSize) && poolSize >= 1) {
+    // The first DefaultPool() call creates the pool at that size; drop the
+    // returned handle wrapper, the pool itself lives on as OCCT's static.
+    oc.OSD_ThreadPool.DefaultPool(poolSize).delete();
+  }
   return oc;
 }

package/dist/opencascade.fluidcad.multi-threaded.build-manifest.json

@@ -3,17 +3,17 @@
     "error_categories": {},
     "failed": 0,
     "failures": [],
-    "total": 5360
+    "total": 5357
   },
   "outputs": [
     {
       "js_exists": true,
-      "js_size": 68072,
+      "js_size": 68071,
       "name": "opencascade.fluidcad.multi-threaded.js",
       "pass": true,
       "wasm_exists": true,
       "wasm_file": "opencascade.fluidcad.multi-threaded.wasm",
-      "wasm_size": 23370009
+      "wasm_size": 23369947
     }
   ],
   "runtime_helpers": {
@@ -385,5 +385,5 @@
   "timestamp": "2026-07-22T20:05:33Z",
   "validation_passed": true,
   "yaml_config": "fluidcad_multi.yml",
-  "yaml_hash": "b027279facf9"
+  "yaml_hash": "8eb2a24b5c4e"
 }