brepjs 18.102.0 → 18.104.0

package/dist/brepjs.cjs

@@ -30,7 +30,7 @@ const require_loftFns = require("./loftFns-DaRDYpfB.cjs");
 const require_cameraFns = require("./cameraFns-S7YbAxfg.cjs");
 const require_textMetrics = require("./textMetrics-W-H6jUDj.cjs");
 const require_shapeRefFns = require("./shapeRefFns-Dij41NuC.cjs");
-const require_workerHandler = require("./workerHandler-CdlOTwJg.cjs");
+const require_workerPool = require("./workerPool-edtPrfHM.cjs");
 const require_primitiveFns = require("./primitiveFns-BAWtMd9H.cjs");
 //#region src/topology/shapeBooleans.ts
 var BOPAlgo_GlueShift = 1;
@@ -5471,6 +5471,19 @@ function compound$1(children) {
 		freeParams: depsOf(...children)
 	};
 }
+function instance$1(source, placements, fuse = false) {
+	const copied = placements.map((m) => m.map((row) => [...row]));
+	let h = fnvMixInt32(fnvMixBool(mix(startHash("Instance"), source), fuse), copied.length);
+	for (const m of copied) for (const v of m.flat()) h = fnvMixNumber(h, v);
+	return {
+		kind: "Instance",
+		source,
+		placements: copied,
+		fuse,
+		structuralHash: h,
+		freeParams: depsOf(source)
+	};
+}
 //#endregion
 //#region src/csg/types.ts
 function outputKindOf(node) {
@@ -5495,6 +5508,7 @@ function outputKindOf(node) {
 		case "Scale":
 		case "Mirror": return outputKindOf(node.target);
 		case "Compound": return "Compound";
+		case "Instance": return node.fuse ? "Solid" : "Compound";
 	}
 }
 //#endregion
@@ -5728,6 +5742,13 @@ function evalEmpty() {
 	return require_errors.err(require_errors.computationError(require_errors.BrepErrorCode.NULL_SHAPE_INPUT, "Empty: cannot materialize an Empty node directly — only valid as boolean/transform operand"));
 }
 //#endregion
+//#region src/csg/evaluators/instance.ts
+function evalInstance(node, ctx) {
+	const r = ctx.evalNode(node.source);
+	if (!r.ok) return r;
+	return materialize(instance(r.value, node.placements), { fuse: node.fuse });
+}
+//#endregion
 //#region src/csg/evaluate.ts
 function dispatch(node, ctx) {
 	switch (node.kind) {
@@ -5751,6 +5772,7 @@ function dispatch(node, ctx) {
 		case "Scale": return evalScale(node, ctx);
 		case "Mirror": return evalMirror(node, ctx);
 		case "Compound": return evalCompound(node, ctx);
+		case "Instance": return evalInstance(node, ctx);
 	}
 }
 function hashExprValue(h, v) {
@@ -6085,6 +6107,12 @@ function nodeToJson(n) {
 		kind: "Compound",
 		children: n.children.map(nodeToJson)
 	};
+	if (n.kind === "Instance") return {
+		kind: "Instance",
+		source: nodeToJson(n.source),
+		placements: n.placements,
+		fuse: n.fuse
+	};
 	return primitiveToJson(n) ?? booleanToJson(n) ?? transformToJson(n);
 }
 function bad(msg) {
@@ -6225,6 +6253,7 @@ function readNode(j) {
 		case "Scale":
 		case "Mirror": return readTransform(kind, j);
 		case "Compound": return readCompound(j);
+		case "Instance": return readInstance(j);
 		default: return bad(`unknown node kind: ${String(kind)}`);
 	}
 }
@@ -6383,6 +6412,16 @@ function readCompound(j) {
 	const children = readNodeArray(j["children"], "Compound.children");
 	return children.ok ? require_errors.ok(compound$1(children.value)) : children;
 }
+function isMatrix4x4(v) {
+	return Array.isArray(v) && v.length === 4 && v.every((row) => Array.isArray(row) && row.length === 4 && row.every(isNumber$1));
+}
+function readInstance(j) {
+	const source = readNode(j["source"]);
+	if (!source.ok) return source;
+	const placements = j["placements"];
+	if (!Array.isArray(placements) || !placements.every(isMatrix4x4)) return bad("Instance.placements must be an array of 4x4 number matrices");
+	return require_errors.ok(instance$1(source.value, placements, j["fuse"] === true));
+}
 //#endregion
 //#region src/csg/optimize.ts
 function optimize(node) {
@@ -6479,6 +6518,7 @@ function optimizeNode(n) {
 			at: n.at ? foldExpr(n.at) : void 0
 		});
 		case "Compound": return compound$1(n.children.map(optimizeNode).filter((c) => c.kind !== "Empty"));
+		case "Instance": return instance$1(optimizeNode(n.source), n.placements, n.fuse);
 	}
 }
 function optimizeFuse(a, b, tol) {
@@ -6568,6 +6608,7 @@ function rebuildChildren(n, pred, repl) {
 			at: n.at
 		});
 		case "Compound": return compound$1(n.children.map((c) => walk(c, pred, repl)));
+		case "Instance": return instance$1(walk(n.source, pred, repl), n.placements, n.fuse);
 	}
 }
 function forEachNode(root, fn) {
@@ -6596,6 +6637,7 @@ function childrenOf(n) {
 		case "Scale":
 		case "Mirror": return [n.target];
 		case "Compound": return n.children;
+		case "Instance": return [n.source];
 	}
 }
 function nodeCount(root) {
@@ -6632,6 +6674,7 @@ var csg_exports = /* @__PURE__ */ require_textBlueprints.__exportAll({
 	fromJSON: () => fromJSON,
 	fuse: () => fuse$1,
 	fuseAll: () => fuseAll$1,
+	instance: () => instance$1,
 	intersect: () => intersect$1,
 	line: () => line$1,
 	mirror: () => mirror$1,
@@ -6759,17 +6802,18 @@ exports.createHistory = require_threadFns.createHistory;
 exports.createKernelHandle = require_shapeTypes.createKernelHandle;
 exports.createMeshCache = require_meshFns.createMeshCache;
 exports.createNamedPlane = require_planeOps.createNamedPlane;
-exports.createOperationRegistry = require_workerHandler.createOperationRegistry;
+exports.createOperationRegistry = require_workerPool.createOperationRegistry;
 exports.createPlane = require_planeOps.createPlane;
 exports.createRef = require_shapeRefFns.createRef;
 exports.createRegistry = require_threadFns.createRegistry;
 exports.createShell = require_shapeTypes.createShell;
 exports.createSolid = require_shapeTypes.createSolid;
-exports.createTaskQueue = require_workerHandler.createTaskQueue;
+exports.createTaskQueue = require_workerPool.createTaskQueue;
 exports.createVertex = require_shapeTypes.createVertex;
 exports.createWire = require_shapeTypes.createWire;
-exports.createWorkerClient = require_workerHandler.createWorkerClient;
-exports.createWorkerHandler = require_workerHandler.createWorkerHandler;
+exports.createWorkerClient = require_workerPool.createWorkerClient;
+exports.createWorkerHandler = require_workerPool.createWorkerHandler;
+exports.createWorkerPool = require_workerPool.createWorkerPool;
 Object.defineProperty(exports, "csg", {
 	enumerable: true,
 	get: function() {
@@ -6803,7 +6847,7 @@ exports.cutWithEvolution = require_healingFns.cutWithEvolution;
 exports.cylinder = require_primitiveFns.cylinder;
 exports.cylindricalJoint = require_threadFns.cylindricalJoint;
 exports.defaultScorer = require_shapeRefFns.defaultScorer;
-exports.dequeueTask = require_workerHandler.dequeueTask;
+exports.dequeueTask = require_workerPool.dequeueTask;
 exports.describe = describe;
 exports.deserializeDrawing = require_drawFns.deserializeDrawing;
 exports.deserializeHistory = require_threadFns.deserializeHistory;
@@ -6835,7 +6879,7 @@ exports.edgesOfFace = require_healingFns.edgesOfFace;
 exports.ellipse = require_primitiveFns.ellipse;
 exports.ellipseArc = require_primitiveFns.ellipseArc;
 exports.ellipsoid = require_primitiveFns.ellipsoid;
-exports.enqueueTask = require_workerHandler.enqueueTask;
+exports.enqueueTask = require_workerPool.enqueueTask;
 exports.err = require_errors.err;
 exports.exportAssemblySTEP = require_threadFns.exportAssemblySTEP;
 exports.exportDXF = require_importFns.exportDXF;
@@ -6968,33 +7012,33 @@ exports.isChamferRadius = isChamferRadius;
 exports.isClosedWire = require_shapeTypes.isClosedWire;
 exports.isCompSolid = require_faceFns.isCompSolid;
 exports.isCompound = require_shapeTypes.isCompound;
-exports.isDisposeRequest = require_workerHandler.isDisposeRequest;
+exports.isDisposeRequest = require_workerPool.isDisposeRequest;
 exports.isEdge = require_shapeTypes.isEdge;
 exports.isEmpty = isEmpty;
 exports.isEqualShape = require_shapeFns.isEqualShape;
 exports.isErr = require_errors.isErr;
-exports.isErrorResponse = require_workerHandler.isErrorResponse;
+exports.isErrorResponse = require_workerPool.isErrorResponse;
 exports.isFace = require_shapeTypes.isFace;
 exports.isFilletRadius = isFilletRadius;
-exports.isInitRequest = require_workerHandler.isInitRequest;
+exports.isInitRequest = require_workerPool.isInitRequest;
 exports.isInside2D = require_blueprintFns.isInside2D;
 exports.isInstanced = isInstanced;
 exports.isLive = require_shapeTypes.isLive;
 exports.isManifoldShell = require_shapeTypes.isManifoldShell;
 exports.isNumber = isNumber;
 exports.isOk = require_errors.isOk;
-exports.isOperationRequest = require_workerHandler.isOperationRequest;
+exports.isOperationRequest = require_workerPool.isOperationRequest;
 exports.isOrientedFace = require_shapeTypes.isOrientedFace;
 exports.isPlanarFace = require_shapeTypes.isPlanarFace;
 exports.isPlanarWire = require_shapeTypes.isPlanarWire;
 exports.isProjectionPlane = require_cameraFns.isProjectionPlane;
-exports.isQueueEmpty = require_workerHandler.isEmpty;
+exports.isQueueEmpty = require_workerPool.isEmpty;
 exports.isSameShape = require_shapeFns.isSameShape;
 exports.isShape1D = require_shapeTypes.isShape1D;
 exports.isShape3D = require_shapeTypes.isShape3D;
 exports.isShell = require_shapeTypes.isShell;
 exports.isSolid = require_shapeTypes.isSolid;
-exports.isSuccessResponse = require_workerHandler.isSuccessResponse;
+exports.isSuccessResponse = require_workerPool.isSuccessResponse;
 exports.isValid = isValid;
 exports.isValidSolid = require_shapeTypes.isValidSolid;
 exports.isVertex = require_shapeTypes.isVertex;
@@ -7085,7 +7129,7 @@ Object.defineProperty(exports, "patterns", {
 		return patterns_exports;
 	}
 });
-exports.pendingCount = require_workerHandler.pendingCount;
+exports.pendingCount = require_workerPool.pendingCount;
 exports.pipeline = require_errors.pipeline;
 exports.pivotPlane = require_planeOps.pivotPlane;
 exports.planarFace = require_shapeTypes.planarFace;
@@ -7118,13 +7162,13 @@ Object.defineProperty(exports, "query", {
 });
 exports.queryError = require_errors.queryError;
 exports.rectangularPattern = rectangularPattern;
-exports.registerHandler = require_workerHandler.registerHandler;
+exports.registerHandler = require_workerPool.registerHandler;
 exports.registerKernel = require_shapeTypes.registerKernel;
 exports.registerKernelTier = require_shapeTypes.registerKernelTier;
 exports.registerOperation = require_threadFns.registerOperation;
 exports.registerShape = require_threadFns.registerShape;
 exports.registerVoxel = registerVoxel;
-exports.rejectAll = require_workerHandler.rejectAll;
+exports.rejectAll = require_workerPool.rejectAll;
 exports.removeChild = require_threadFns.removeChild;
 exports.removeHolesFromFace = require_faceFns.removeHolesFromFace;
 exports.repairMesh = repairMesh;

package/dist/brepjs.js

@@ -29,7 +29,7 @@ import { a as Sketch, c as compoundSketchLoft, d as sketchFace, f as sketchLoft,
 import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-Bu6jgTKc.js";
 import { n as textMetrics, r as sketchText, t as fontMetrics } from "./textMetrics-CBbDQ5QW.js";
 import { a as updateRoles, i as resolveRef, n as captureHint, o as defaultScorer, r as createRef, t as assignRoles } from "./shapeRefFns-Cn4WNb3q.js";
-import { a as createTaskQueue, c as isEmpty$1, d as isDisposeRequest, f as isErrorResponse, h as isSuccessResponse, i as createWorkerClient, l as pendingCount, m as isOperationRequest, n as createWorkerHandler, o as dequeueTask, p as isInitRequest, r as registerHandler, s as enqueueTask, t as createOperationRegistry, u as rejectAll } from "./workerHandler-CFetYgIm.js";
+import { a as createWorkerClient, c as enqueueTask, d as rejectAll, f as isDisposeRequest, g as isSuccessResponse, h as isOperationRequest, i as registerHandler, l as isEmpty$1, m as isInitRequest, n as createOperationRegistry, o as createTaskQueue, p as isErrorResponse, r as createWorkerHandler, s as dequeueTask, t as createWorkerPool, u as pendingCount } from "./workerPool-BxBKpKeI.js";
 import { C as threePointArc, D as wireLoop, E as wire, S as tangentArc, T as vertex, _ as polygon, a as circle, b as sphere$1, c as cylinder, d as ellipsoid, f as face, g as offsetFace, h as line, i as bsplineApprox, l as ellipse, m as helix, n as bezier, o as compound, p as filledFace, r as box, s as cone, t as addHoles, u as ellipseArc, v as sewShells, w as torus$1, x as subFace, y as solid } from "./primitiveFns-62SO4ti5.js";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
@@ -5474,6 +5474,19 @@ function compound$1(children) {
 		freeParams: depsOf(...children)
 	};
 }
+function instance$1(source, placements, fuse = false) {
+	const copied = placements.map((m) => m.map((row) => [...row]));
+	let h = fnvMixInt32(fnvMixBool(mix(startHash("Instance"), source), fuse), copied.length);
+	for (const m of copied) for (const v of m.flat()) h = fnvMixNumber(h, v);
+	return {
+		kind: "Instance",
+		source,
+		placements: copied,
+		fuse,
+		structuralHash: h,
+		freeParams: depsOf(source)
+	};
+}
 //#endregion
 //#region src/csg/types.ts
 function outputKindOf(node) {
@@ -5498,6 +5511,7 @@ function outputKindOf(node) {
 		case "Scale":
 		case "Mirror": return outputKindOf(node.target);
 		case "Compound": return "Compound";
+		case "Instance": return node.fuse ? "Solid" : "Compound";
 	}
 }
 //#endregion
@@ -5731,6 +5745,13 @@ function evalEmpty() {
 	return err(computationError(BrepErrorCode.NULL_SHAPE_INPUT, "Empty: cannot materialize an Empty node directly — only valid as boolean/transform operand"));
 }
 //#endregion
+//#region src/csg/evaluators/instance.ts
+function evalInstance(node, ctx) {
+	const r = ctx.evalNode(node.source);
+	if (!r.ok) return r;
+	return materialize(instance(r.value, node.placements), { fuse: node.fuse });
+}
+//#endregion
 //#region src/csg/evaluate.ts
 function dispatch(node, ctx) {
 	switch (node.kind) {
@@ -5754,6 +5775,7 @@ function dispatch(node, ctx) {
 		case "Scale": return evalScale(node, ctx);
 		case "Mirror": return evalMirror(node, ctx);
 		case "Compound": return evalCompound(node, ctx);
+		case "Instance": return evalInstance(node, ctx);
 	}
 }
 function hashExprValue(h, v) {
@@ -6088,6 +6110,12 @@ function nodeToJson(n) {
 		kind: "Compound",
 		children: n.children.map(nodeToJson)
 	};
+	if (n.kind === "Instance") return {
+		kind: "Instance",
+		source: nodeToJson(n.source),
+		placements: n.placements,
+		fuse: n.fuse
+	};
 	return primitiveToJson(n) ?? booleanToJson(n) ?? transformToJson(n);
 }
 function bad(msg) {
@@ -6228,6 +6256,7 @@ function readNode(j) {
 		case "Scale":
 		case "Mirror": return readTransform(kind, j);
 		case "Compound": return readCompound(j);
+		case "Instance": return readInstance(j);
 		default: return bad(`unknown node kind: ${String(kind)}`);
 	}
 }
@@ -6386,6 +6415,16 @@ function readCompound(j) {
 	const children = readNodeArray(j["children"], "Compound.children");
 	return children.ok ? ok(compound$1(children.value)) : children;
 }
+function isMatrix4x4(v) {
+	return Array.isArray(v) && v.length === 4 && v.every((row) => Array.isArray(row) && row.length === 4 && row.every(isNumber$1));
+}
+function readInstance(j) {
+	const source = readNode(j["source"]);
+	if (!source.ok) return source;
+	const placements = j["placements"];
+	if (!Array.isArray(placements) || !placements.every(isMatrix4x4)) return bad("Instance.placements must be an array of 4x4 number matrices");
+	return ok(instance$1(source.value, placements, j["fuse"] === true));
+}
 //#endregion
 //#region src/csg/optimize.ts
 function optimize(node) {
@@ -6482,6 +6521,7 @@ function optimizeNode(n) {
 			at: n.at ? foldExpr(n.at) : void 0
 		});
 		case "Compound": return compound$1(n.children.map(optimizeNode).filter((c) => c.kind !== "Empty"));
+		case "Instance": return instance$1(optimizeNode(n.source), n.placements, n.fuse);
 	}
 }
 function optimizeFuse(a, b, tol) {
@@ -6571,6 +6611,7 @@ function rebuildChildren(n, pred, repl) {
 			at: n.at
 		});
 		case "Compound": return compound$1(n.children.map((c) => walk(c, pred, repl)));
+		case "Instance": return instance$1(walk(n.source, pred, repl), n.placements, n.fuse);
 	}
 }
 function forEachNode(root, fn) {
@@ -6599,6 +6640,7 @@ function childrenOf(n) {
 		case "Scale":
 		case "Mirror": return [n.target];
 		case "Compound": return n.children;
+		case "Instance": return [n.source];
 	}
 }
 function nodeCount(root) {
@@ -6635,6 +6677,7 @@ var csg_exports = /* @__PURE__ */ __exportAll({
 	fromJSON: () => fromJSON,
 	fuse: () => fuse$1,
 	fuseAll: () => fuseAll$1,
+	instance: () => instance$1,
 	intersect: () => intersect$1,
 	line: () => line$1,
 	mirror: () => mirror$1,
@@ -6659,4 +6702,4 @@ var csg_exports = /* @__PURE__ */ __exportAll({
 	withEvaluator: () => withEvaluator
 });
 //#endregion
-export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolvePlane, resolveRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };
+export { BaseSketcher2d, BlueprintSketcher, BrepBugError, BrepErrorCode, BrepWrapperError, BrepkitAdapter, CompoundSketch, DEFAULT_CAPABILITIES, DEG2RAD, DisposalScope, EXACT_BREP_CAPABILITIES, FaceSketcher, HASH_CODE_MAX, OK, OcctWasmAdapter, RAD2DEG, Sketch, Sketcher, Sketches, addChild, addHoles, addJoint, addMate, addStep, adjacentFaces, all, andThen, applyGlue, applyMatrix, approximateCurve, as2D, as3D, asTopo, assignRoles, autoHeal, bezier, blueprintToDXF, booleanPipeline, booleans_exports as booleans, boss, box, bsplineApprox, bug, cameraFromPlane, cameraLookAt, captureHint, cast, castShape, castShape3D, chamfer, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkAllInterferences, checkBoolean, checkInterference, circle, circularPattern, classifyPointOnFace, clearMeshCache, clone, closedWire, collect, collectShapes, colorFaces, colorShape, complexExtrude, composeTransforms, compound, compoundSketchExtrude, compoundSketchFace, compoundSketchLoft, compoundSketchRevolve, computationError, computeStraightSkeleton, cone, construction_exports as construction, convexHull, cornerFinder, countNodes, createAssembly, createAssemblyNode, createBlueprint, createCamera, createCompound, createCompoundBlueprint, createDistanceQuery, createEdge, createFace, createHandle, createHistory, createKernelHandle, createMeshCache, createNamedPlane, createOperationRegistry, createPlane, createRef, createRegistry, createShell, createSolid, createTaskQueue, createVertex, createWire, createWorkerClient, createWorkerHandler, createWorkerPool, csg_exports as csg, currentQuality, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cut, cut2D, cutAll, cutAllBisect, cutBlueprints, cutWithEvolution, cylinder, cylindricalJoint, defaultScorer, dequeueTask, describe, deserializeDrawing, deserializeHistory, fromBREP as deserializeShape, downcast, draft, draw, drawCircle, drawEllipse, drawFaceOutline, drawParametricFunction, drawPointsInterpolation, drawPolysides, drawProjection, drawRectangle, drawRoundedRectangle, drawSingleCircle, drawSingleEllipse, drawText, drawingChamfer, drawingCut, drawingFillet, drawingFuse, drawingIntersect, drawingToSketchOnPlane, drill, edgeFinder, edgesOfFace, ellipse, ellipseArc, ellipsoid, enqueueTask, err, exportAssemblySTEP, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, exportURDF, extrude, extrudeAll, face, faceAxis, faceCenter, faceFinder, faceGeomType, faceOrientation, facesOfEdge, fieldBoolean, fieldContour, fieldOffset, fieldReinit, fieldShell, fill, filledFace, fillet, filletWithEvolution, findFacesByTag, findNode, findStep, fixSelfIntersection, fixShape, flatMap, flatten, flipFaceOrientation, flipOrientation, fontMetrics, forwardKinematics, fromBREP$1 as fromBREP, fromKernelDir, fromKernelPnt, fromKernelVec, fromNullable, fuse, fuse2D, fuseAll, fuseAllBisect, fuseBlueprints, fuseWithEvolution, gearGeometry, getActiveVoxelId, getBounds, getBounds2D, getCompSolids, getCurveType, getDisposalStats, getEdges, getFaceColor, getFaceOrigins, getFaceTags, getFaces, getFont, getHashCode, getShape as getHistoryShape, getKernel, getKernelCapabilities, getKernelTier, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getOrientation2D, getPerformanceStats, getShapeColor, getShapeKind, getShells, getSingleFace, getSolids, getSurfaceType, getTagMetadata, getVertices, getVoxel, getWires, gridPattern, guidedSweep, heal, healFace, healSolid, healWire, helix, hull, importDXF, importGLB, importIGES, importOBJ, importSTEP, importSTL, importSVG, importSVGPathD, importThreeMF, importURDF, init, initFromManifold, initFromOC, initVoxel, innerWires, instance, instanceCount, instanceGrid, instancedMesh, interpolateCurve, intersect, intersect2D, intersectBlueprints, intersectWithEvolution, invalidateShapeCache, inverseKinematics, ioNs_exports as io, ioError, is2D, is3D, isChamferRadius, isClosedWire, isCompSolid, isCompound, isDisposeRequest, isEdge, isEmpty, isEqualShape, isErr, isErrorResponse, isFace, isFilletRadius, isInitRequest, isInside2D, isInstanced, isLive, isManifoldShell, isNumber, isOk, isOperationRequest, isOrientedFace, isPlanarFace, isPlanarWire, isProjectionPlane, isEmpty$1 as isQueueEmpty, isSameShape, isShape1D, isShape3D, isShell, isSolid, isSuccessResponse, isValid, isValidSolid, isVertex, isWire, iterCompSolids, iterEdges, iterFaces, iterShells, iterSolids, iterTopo, iterVertices, iterWires, jointTrajectory, jointTransform, jointsFromDH, kernelCall, kernelCallRaw, kernelCallScoped, kernelError, latticeInfill, latticeInfillShape, line, linearPattern, loadFont, loft, loftAll, makeBaseBox, makeExternalGear, makeInternalGear, makePlane, makePlanetaryGear, makeProjectedEdges, manifoldShell, map, mapBoth, mapErr, match, materialize, measureArea, measureCurvatureAt, measureCurvatureAtMid, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, measurement_exports as measurement, mechanismDOF, mesh, meshEdges, meshMultiLOD, minkowski, mirror, mirror2D, mirrorDrawing, mirrorJoin, modifiers_exports as modifiers, modifyStep, moduleInitError, multiSectionSweep, normalAt, offset, offsetFace, offsetMesh, offsetShape, offsetWire2D, ok, or, orElse, organiseBlueprints, orientedFace, outerWire, patterns_exports as patterns, pendingCount, pipeline, pivotPlane, planarFace, planarJoint, planarWire, planetPlacements, pocket, pointOnSurface, pointsInside, polygon, polyhedron, polysideInnerRadius, polysidesBlueprint, positionOnCurve, prewarm, primitives_exports as primitives, prismaticJoint, projectEdges, projectPointOnFace, query_exports as query, queryError, rectangularPattern, registerHandler, registerKernel, registerKernelTier, registerOperation, registerShape, registerVoxel, rejectAll, removeChild, removeHolesFromFace, repairMesh, replayFrom, replayHistory, resetDisposalStats, resetPerformanceStats, resize, resolve, resolve3D, resolveDirection, resolvePlane, resolveRef, reverseCurve, revoluteJoint, revolve, roof, rotate, rotate2D, rotateDrawing, roundedRectangleBlueprint, scale, scale2D, scaleDrawing, box$1 as sdfBox, capsule as sdfCapsule, cone$1 as sdfCone, cylinder$1 as sdfCylinder, fieldAxialRamp as sdfFieldAxialRamp, fieldClamp as sdfFieldClamp, fieldConst as sdfFieldConst, fieldFromSdf as sdfFieldFromSdf, fieldRadialRamp as sdfFieldRadialRamp, lattice as sdfLattice, plane as sdfPlane, roundedBox as sdfRoundedBox, sphere as sdfSphere, strutLattice as sdfStrutLattice, sweep as sdfSweep, torus as sdfTorus, section, sectionToFace, serializeHistory, setJointValue, setJointValues, setShapeOrigin, setTagMetadata, sewShells, shape, shapeToMeshInput, shapeType, sharedEdges, shell, shellMesh, shellShape, shellWithEvolution, simplify, sketchCircle, sketchEllipse, sketchExtrude, sketchFace, sketchFaceOffset, sketchHelix, sketchLoft, sketchOnFace2D, sketchOnPlane2D, sketchParametricFunction, sketchPolysides, sketchRectangle, sketchRevolve, sketchRoundedRectangle, sketchSweep, sketchText, sketchWires, sketcherStateError, slice, solid, solidFromShell, solveAssembly, sphere$1 as sphere, sphericalJoint, split, stepCount, stepsFrom, stretch2D, subFace, supportExtrude, supportsConstraintSketch, supportsProjection, surfaceFromGrid, surfaceFromImage, sweep$1 as sweep, tagFaces, tangentArc, tap, tapErr, textBlueprints, textMetrics, thicken, thread, threePointArc, toBREP, toBufferGeometryData, toGroupedBufferGeometryData, toKernelVec, toLODGeometryData, toLineGeometryData, toSVGPathD, toVec2, toVec3, torus$1 as torus, tpmsLattice, transformCopy, transforms_exports as transforms, translate, translate2D, translateDrawing, translatePlane, tryCatch, tryCatchAsync, twistExtrude, typeCastError, undoLast, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, updateNode, updateRoles, uvBounds, uvCoordinates, validSolid, validatePlanetary, validationError, variableFillet, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, vertex, vertexFinder, vertexPosition, verticesOfEdge, voxelBoolean, voxelBooleanField, voxelBooleanFieldShapes, voxelBooleanShapes, voxelField, voxelFieldFromShape, walkAssembly, windingNumbers, wire, wireFinder, wireLoop, wiresOfFace, withKernel, withKernelDir, withKernelPnt, withKernelVec, withQuality, withScope, withScopeResult, withScopeResultAsync, withTier, zip as zipResults };

package/dist/csg/builders.d.ts

@@ -1,5 +1,6 @@
 import { ScalarInput, Vec3Input } from './expressions.js';
-import { BoxNode, SphereNode, CylinderNode, ConeNode, TorusNode, PolygonNode, CircleNode, LineNode, VertexLitNode, EmptyNode, FuseNode, CutNode, IntersectNode, FuseAllNode, CutAllNode, TranslateNode, RotateNode, ScaleNode, MirrorNode, CompoundNode, IRNode, SolidNode, FaceNode, EdgeNode, VertexNode } from './types.js';
+import { Matrix4x4 } from '../core/types.js';
+import { BoxNode, SphereNode, CylinderNode, ConeNode, TorusNode, PolygonNode, CircleNode, LineNode, VertexLitNode, EmptyNode, FuseNode, CutNode, IntersectNode, FuseAllNode, CutAllNode, TranslateNode, RotateNode, ScaleNode, MirrorNode, CompoundNode, InstanceNode, IRNode, SolidNode, FaceNode, EdgeNode, VertexNode } from './types.js';
 export declare function box(x: ScalarInput, y: ScalarInput, z: ScalarInput): BoxNode;
 export declare function sphere(radius: ScalarInput): SphereNode;
 export declare function cylinder(radius: ScalarInput, height: ScalarInput): CylinderNode;
@@ -33,4 +34,5 @@ export interface MirrorOptions {
 }
 export declare function mirror(target: IRNode, options?: MirrorOptions): MirrorNode;
 export declare function compound(children: ReadonlyArray<IRNode>): CompoundNode;
+export declare function instance(source: IRNode, placements: ReadonlyArray<Matrix4x4>, fuse?: boolean): InstanceNode;
 export type { FaceNode, EdgeNode, VertexNode, SolidNode };

package/dist/csg/evaluators/instance.d.ts

@@ -0,0 +1,5 @@
+import { Result } from '../../core/result.js';
+import { AnyShape, Dimension } from '../../core/shapeTypes.js';
+import { InstanceNode } from '../types.js';
+import { EvalContext } from './context.js';
+export declare function evalInstance(node: InstanceNode, ctx: EvalContext): Result<AnyShape<Dimension>>;

package/dist/csg/index.d.ts

@@ -5,9 +5,9 @@
  * parameterize via named expression bindings; evaluate against the active
  * kernel with subtree-level cache reuse for incremental parametric edits.
  */
-export { box, sphere, cylinder, cone, torus, polygon, circle, line, vertex, emptySolid, emptyFace, emptyWire, fuse, cut, intersect, fuseAll, cutAll, translate, rotate, scale, mirror, compound, type RotateOptions, type ScaleOptions, type MirrorOptions, } from './builders.js';
+export { box, sphere, cylinder, cone, torus, polygon, circle, line, vertex, emptySolid, emptyFace, emptyWire, fuse, cut, intersect, fuseAll, cutAll, translate, rotate, scale, mirror, compound, instance, type RotateOptions, type ScaleOptions, type MirrorOptions, } from './builders.js';
 export { numLit, vec3Lit, vec2Lit, param, binOp, unaryOp, component, buildVec, add, mul, asScalarExpr, asVec3Expr, asVec2Expr, type Expr, type ExprValue, type Env, type ScalarInput, type Vec3Input, type Vec2Input, type BinaryOp, type UnaryOp, } from './expressions.js';
-export type { IRNode, NodeKind, OutputKind, PrimitiveNode, BooleanNode, TransformIRNode, SolidNode, FaceNode, EdgeNode, VertexNode, AnyNode, } from './types.js';
+export type { IRNode, NodeKind, OutputKind, PrimitiveNode, BooleanNode, TransformIRNode, InstanceNode, SolidNode, FaceNode, EdgeNode, VertexNode, AnyNode, } from './types.js';
 export { outputKindOf } from './types.js';
 export { Evaluator, withEvaluator, type EvaluatorOptions, type StepInfo, type CacheStats, } from './evaluate.js';
 export { toJSON, fromJSON, CSG_VERSION, type CsgEnvelope } from './serialize.js';

package/dist/csg/types.d.ts

@@ -1,4 +1,5 @@
 import { Expr } from './expressions.js';
+import { Matrix4x4 } from '../core/types.js';
 export type OutputKind = 'Solid' | 'Face' | 'Wire' | 'Edge' | 'Vertex' | 'Compound';
 /** Output kinds that have a corresponding empty-shape builder + serializer. */
 export type EmptyOutputKind = 'Solid' | 'Face' | 'Wire';
@@ -111,10 +112,18 @@ export interface CompoundNode extends IRNodeBase {
     readonly kind: 'Compound';
     readonly children: readonly IRNode[];
 }
+export interface InstanceNode extends IRNodeBase {
+    readonly kind: 'Instance';
+    readonly source: IRNode;
+    /** Per-instance world transforms (row-major 4x4 literals). */
+    readonly placements: readonly Matrix4x4[];
+    /** Fuse the placed copies into one solid; otherwise a Compound. */
+    readonly fuse: boolean;
+}
 export type PrimitiveNode = BoxNode | SphereNode | CylinderNode | ConeNode | TorusNode | PolygonNode | CircleNode | LineNode | VertexLitNode | EmptyNode;
 export type BooleanNode = FuseNode | CutNode | IntersectNode | FuseAllNode | CutAllNode;
 export type TransformIRNode = TranslateNode | RotateNode | ScaleNode | MirrorNode;
-export type IRNode = PrimitiveNode | BooleanNode | TransformIRNode | CompoundNode;
+export type IRNode = PrimitiveNode | BooleanNode | TransformIRNode | CompoundNode | InstanceNode;
 export type NodeKind = IRNode['kind'];
 export type AnyNode = IRNode;
 /** Nodes that produce a 3D solid. */

package/dist/index.d.ts

@@ -137,7 +137,7 @@ export { importGLB } from './io/gltfImportFns.js';
 export type { DXFImportOptions } from './io/dxfImportFns.js';
 export { edgeFinder, faceFinder, wireFinder, vertexFinder, cornerFinder, type EdgeFinderFn, type FaceFinderFn, type WireFinderFn, type VertexFinderFn, type CornerFinderFn, type CornerFilter, type ShapeFinder, } from './query/finderFns.js';
 export { createCamera, cameraLookAt, cameraFromPlane, projectEdges, type Camera, } from './projection/cameraFns.js';
-export { type WorkerRequest, type InitRequest, type OperationRequest, type DisposeRequest, type WorkerResponse, type SuccessResponse, type ErrorResponse, isInitRequest, isOperationRequest, isDisposeRequest, isSuccessResponse, isErrorResponse, type PendingTask, type TaskQueue, createTaskQueue, enqueueTask, dequeueTask, pendingCount, isQueueEmpty, rejectAll, createWorkerClient, createOperationRegistry, registerHandler, createWorkerHandler, type WorkerClient, type WorkerClientOptions, type WorkerResult, type OperationHandler, type OperationRegistry, } from './worker/index.js';
+export { type WorkerRequest, type InitRequest, type OperationRequest, type DisposeRequest, type WorkerResponse, type SuccessResponse, type ErrorResponse, isInitRequest, isOperationRequest, isDisposeRequest, isSuccessResponse, isErrorResponse, type PendingTask, type TaskQueue, createTaskQueue, enqueueTask, dequeueTask, pendingCount, isQueueEmpty, rejectAll, createWorkerClient, createOperationRegistry, registerHandler, createWorkerHandler, createWorkerPool, type WorkerClient, type WorkerClientOptions, type WorkerResult, type OperationHandler, type OperationRegistry, type WorkerPool, type WorkerPoolOptions, type WorkerOperation, } from './worker/index.js';
 export type { Shapeable, WrappedMarker, FinderFn, FilletRadius, ChamferDistance, DraftAngle, DraftOptions, DrawingLike, DrillOptions, PocketOptions, BossOptions, MirrorJoinOptions, RectangularPatternOptions, } from './topology/apiTypes.js';
 export { resolve, resolve3D } from './topology/apiTypes.js';
 export { box, cylinder, sphere, cone, torus, ellipsoid, line, circle, ellipse, helix, threePointArc, ellipseArc, bsplineApprox, bezier, tangentArc, wire, wireLoop, face, filledFace, subFace, polygon, vertex, compound, solid, offsetFace, sewShells, addHoles, type BoxOptions, type CylinderOptions, type SphereOptions, type ConeOptions, type TorusOptions, type EllipsoidOptions, type CircleOptions, type EllipseOptions, type HelixOptions, type EllipseArcOptions, } from './topology/primitiveFns.js';

package/dist/worker/index.d.ts

@@ -8,3 +8,4 @@ export { type WorkerRequest, type InitRequest, type OperationRequest, type Dispo
 export { type PendingTask, type TaskQueue, createTaskQueue, enqueueTask, dequeueTask, pendingCount, isEmpty as isQueueEmpty, rejectAll, } from './taskQueue.js';
 export { createWorkerClient, type WorkerClient, type WorkerClientOptions, type WorkerResult, } from './workerClient.js';
 export { createOperationRegistry, registerHandler, createWorkerHandler, type OperationHandler, type OperationRegistry, } from './workerHandler.js';
+export { createWorkerPool, type WorkerPool, type WorkerPoolOptions, type WorkerOperation, } from './workerPool.js';

package/dist/worker/workerPool.d.ts

@@ -0,0 +1,46 @@
+import { WorkerResult } from './workerClient.js';
+export interface WorkerPoolOptions {
+    /** The Worker instances to pool over; each is wrapped in a WorkerClient. */
+    workers: Worker[];
+    /** Optional URL for the WASM binary, forwarded to every worker on init. */
+    wasmUrl?: string;
+}
+/** A single operation for {@link WorkerPool.executeBatch}. */
+export interface WorkerOperation {
+    /** Name of the registered operation to invoke. */
+    operation: string;
+    /** BREP-serialized input shapes. */
+    shapesBrep: string[];
+    /** Parameters forwarded to the operation handler. */
+    params: Record<string, unknown>;
+}
+export interface WorkerPool {
+    /** Number of workers in the pool. */
+    readonly size: number;
+    /**
+     * Initialize every worker (load WASM) in parallel. Atomic: if any worker
+     * fails, the pool disposes every worker and rejects with the original error,
+     * leaving the pool in a terminal disposed state.
+     */
+    init(): Promise<void>;
+    /** Run one operation on the least-loaded worker. */
+    execute(operation: string, shapesBrep: string[], params: Record<string, unknown>): Promise<WorkerResult>;
+    /**
+     * Run a batch of independent operations, fanned across the pool concurrently.
+     * Resolves with results in the same order as `operations`.
+     */
+    executeBatch(operations: ReadonlyArray<WorkerOperation>): Promise<WorkerResult[]>;
+    /** In-flight task count per worker, indexed as the pool was constructed. */
+    inFlight(): readonly number[];
+    /** Dispose every worker, rejecting all pending and future operations. Idempotent. */
+    dispose(): void;
+}
+/**
+ * Create a worker pool over the given Worker instances.
+ *
+ * Dispatch is least-loaded: each operation goes to the worker with the fewest
+ * in-flight tasks (ties resolve to the first). The count is bumped synchronously
+ * at dispatch, so a burst of calls spreads across workers rather than piling
+ * onto one. Under uniform op cost this degrades to round-robin.
+ */
+export declare function createWorkerPool(options: WorkerPoolOptions): WorkerPool;

package/dist/worker.cjs

@@ -1,17 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_workerHandler = require("./workerHandler-CdlOTwJg.cjs");
-exports.createOperationRegistry = require_workerHandler.createOperationRegistry;
-exports.createTaskQueue = require_workerHandler.createTaskQueue;
-exports.createWorkerClient = require_workerHandler.createWorkerClient;
-exports.createWorkerHandler = require_workerHandler.createWorkerHandler;
-exports.dequeueTask = require_workerHandler.dequeueTask;
-exports.enqueueTask = require_workerHandler.enqueueTask;
-exports.isDisposeRequest = require_workerHandler.isDisposeRequest;
-exports.isErrorResponse = require_workerHandler.isErrorResponse;
-exports.isInitRequest = require_workerHandler.isInitRequest;
-exports.isOperationRequest = require_workerHandler.isOperationRequest;
-exports.isQueueEmpty = require_workerHandler.isEmpty;
-exports.isSuccessResponse = require_workerHandler.isSuccessResponse;
-exports.pendingCount = require_workerHandler.pendingCount;
-exports.registerHandler = require_workerHandler.registerHandler;
-exports.rejectAll = require_workerHandler.rejectAll;
+const require_workerPool = require("./workerPool-edtPrfHM.cjs");
+exports.createOperationRegistry = require_workerPool.createOperationRegistry;
+exports.createTaskQueue = require_workerPool.createTaskQueue;
+exports.createWorkerClient = require_workerPool.createWorkerClient;
+exports.createWorkerHandler = require_workerPool.createWorkerHandler;
+exports.createWorkerPool = require_workerPool.createWorkerPool;
+exports.dequeueTask = require_workerPool.dequeueTask;
+exports.enqueueTask = require_workerPool.enqueueTask;
+exports.isDisposeRequest = require_workerPool.isDisposeRequest;
+exports.isErrorResponse = require_workerPool.isErrorResponse;
+exports.isInitRequest = require_workerPool.isInitRequest;
+exports.isOperationRequest = require_workerPool.isOperationRequest;
+exports.isQueueEmpty = require_workerPool.isEmpty;
+exports.isSuccessResponse = require_workerPool.isSuccessResponse;
+exports.pendingCount = require_workerPool.pendingCount;
+exports.registerHandler = require_workerPool.registerHandler;
+exports.rejectAll = require_workerPool.rejectAll;

package/dist/worker.js

@@ -1,2 +1,2 @@
-import { a as createTaskQueue, c as isEmpty, d as isDisposeRequest, f as isErrorResponse, h as isSuccessResponse, i as createWorkerClient, l as pendingCount, m as isOperationRequest, n as createWorkerHandler, o as dequeueTask, p as isInitRequest, r as registerHandler, s as enqueueTask, t as createOperationRegistry, u as rejectAll } from "./workerHandler-CFetYgIm.js";
-export { createOperationRegistry, createTaskQueue, createWorkerClient, createWorkerHandler, dequeueTask, enqueueTask, isDisposeRequest, isErrorResponse, isInitRequest, isOperationRequest, isEmpty as isQueueEmpty, isSuccessResponse, pendingCount, registerHandler, rejectAll };
+import { a as createWorkerClient, c as enqueueTask, d as rejectAll, f as isDisposeRequest, g as isSuccessResponse, h as isOperationRequest, i as registerHandler, l as isEmpty, m as isInitRequest, n as createOperationRegistry, o as createTaskQueue, p as isErrorResponse, r as createWorkerHandler, s as dequeueTask, t as createWorkerPool, u as pendingCount } from "./workerPool-BxBKpKeI.js";
+export { createOperationRegistry, createTaskQueue, createWorkerClient, createWorkerHandler, createWorkerPool, dequeueTask, enqueueTask, isDisposeRequest, isErrorResponse, isInitRequest, isOperationRequest, isEmpty as isQueueEmpty, isSuccessResponse, pendingCount, registerHandler, rejectAll };

package/dist/{workerHandler-CFetYgIm.js → workerPool-BxBKpKeI.js}

@@ -205,4 +205,68 @@ function createWorkerHandler(registry, initFn) {
 	};
 }
 //#endregion
-export { createTaskQueue as a, isEmpty as c, isDisposeRequest as d, isErrorResponse as f, isSuccessResponse as h, createWorkerClient as i, pendingCount as l, isOperationRequest as m, createWorkerHandler as n, dequeueTask as o, isInitRequest as p, registerHandler as r, enqueueTask as s, createOperationRegistry as t, rejectAll as u };
+//#region src/worker/workerPool.ts
+/**
+* Worker pool for spreading CAD operations across several Web Workers.
+*
+* Wraps N {@link WorkerClient}s behind the same promise API and dispatches each
+* operation to the least-loaded worker, so independent work can span cores
+* instead of serializing through a single worker.
+*/
+/**
+* Create a worker pool over the given Worker instances.
+*
+* Dispatch is least-loaded: each operation goes to the worker with the fewest
+* in-flight tasks (ties resolve to the first). The count is bumped synchronously
+* at dispatch, so a burst of calls spreads across workers rather than piling
+* onto one. Under uniform op cost this degrades to round-robin.
+*/
+function createWorkerPool(options) {
+	const { workers, wasmUrl } = options;
+	if (workers.length === 0) throw new Error("createWorkerPool requires at least one worker");
+	const slots = workers.map((worker) => ({
+		client: createWorkerClient({
+			worker,
+			...wasmUrl !== void 0 ? { wasmUrl } : {}
+		}),
+		inFlight: 0
+	}));
+	let disposed = false;
+	function leastLoaded() {
+		return slots.reduce((best, slot) => slot.inFlight < best.inFlight ? slot : best);
+	}
+	function execute(operation, shapesBrep, params) {
+		if (disposed) return Promise.reject(/* @__PURE__ */ new Error("WorkerPool has been disposed"));
+		const slot = leastLoaded();
+		slot.inFlight += 1;
+		return slot.client.execute(operation, shapesBrep, params).finally(() => {
+			slot.inFlight -= 1;
+		});
+	}
+	function dispose() {
+		if (disposed) return;
+		disposed = true;
+		for (const slot of slots) slot.client.dispose();
+	}
+	return {
+		size: slots.length,
+		async init() {
+			try {
+				await Promise.all(slots.map((slot) => slot.client.init()));
+			} catch (err) {
+				dispose();
+				throw err;
+			}
+		},
+		execute,
+		executeBatch(operations) {
+			return Promise.all(operations.map((op) => execute(op.operation, op.shapesBrep, op.params)));
+		},
+		inFlight() {
+			return slots.map((slot) => slot.inFlight);
+		},
+		dispose
+	};
+}
+//#endregion
+export { createWorkerClient as a, enqueueTask as c, rejectAll as d, isDisposeRequest as f, isSuccessResponse as g, isOperationRequest as h, registerHandler as i, isEmpty as l, isInitRequest as m, createOperationRegistry as n, createTaskQueue as o, isErrorResponse as p, createWorkerHandler as r, dequeueTask as s, createWorkerPool as t, pendingCount as u };

package/dist/{workerHandler-CdlOTwJg.cjs → workerPool-edtPrfHM.cjs}

@@ -205,6 +205,70 @@ function createWorkerHandler(registry, initFn) {
 	};
 }
 //#endregion
+//#region src/worker/workerPool.ts
+/**
+* Worker pool for spreading CAD operations across several Web Workers.
+*
+* Wraps N {@link WorkerClient}s behind the same promise API and dispatches each
+* operation to the least-loaded worker, so independent work can span cores
+* instead of serializing through a single worker.
+*/
+/**
+* Create a worker pool over the given Worker instances.
+*
+* Dispatch is least-loaded: each operation goes to the worker with the fewest
+* in-flight tasks (ties resolve to the first). The count is bumped synchronously
+* at dispatch, so a burst of calls spreads across workers rather than piling
+* onto one. Under uniform op cost this degrades to round-robin.
+*/
+function createWorkerPool(options) {
+	const { workers, wasmUrl } = options;
+	if (workers.length === 0) throw new Error("createWorkerPool requires at least one worker");
+	const slots = workers.map((worker) => ({
+		client: createWorkerClient({
+			worker,
+			...wasmUrl !== void 0 ? { wasmUrl } : {}
+		}),
+		inFlight: 0
+	}));
+	let disposed = false;
+	function leastLoaded() {
+		return slots.reduce((best, slot) => slot.inFlight < best.inFlight ? slot : best);
+	}
+	function execute(operation, shapesBrep, params) {
+		if (disposed) return Promise.reject(/* @__PURE__ */ new Error("WorkerPool has been disposed"));
+		const slot = leastLoaded();
+		slot.inFlight += 1;
+		return slot.client.execute(operation, shapesBrep, params).finally(() => {
+			slot.inFlight -= 1;
+		});
+	}
+	function dispose() {
+		if (disposed) return;
+		disposed = true;
+		for (const slot of slots) slot.client.dispose();
+	}
+	return {
+		size: slots.length,
+		async init() {
+			try {
+				await Promise.all(slots.map((slot) => slot.client.init()));
+			} catch (err) {
+				dispose();
+				throw err;
+			}
+		},
+		execute,
+		executeBatch(operations) {
+			return Promise.all(operations.map((op) => execute(op.operation, op.shapesBrep, op.params)));
+		},
+		inFlight() {
+			return slots.map((slot) => slot.inFlight);
+		},
+		dispose
+	};
+}
+//#endregion
 Object.defineProperty(exports, "createOperationRegistry", {
 	enumerable: true,
 	get: function() {
@@ -229,6 +293,12 @@ Object.defineProperty(exports, "createWorkerHandler", {
 		return createWorkerHandler;
 	}
 });
+Object.defineProperty(exports, "createWorkerPool", {
+	enumerable: true,
+	get: function() {
+		return createWorkerPool;
+	}
+});
 Object.defineProperty(exports, "dequeueTask", {
 	enumerable: true,
 	get: function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs",
-  "version": "18.102.0",
+  "version": "18.104.0",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",