brepjs 18.100.3 → 18.102.0

package/dist/2d.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_shapeTypes = require("./shapeTypes-DQfoZt_L.cjs");
+const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-BLkQkExs.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BoHwuwaU.cjs");
-const require_blueprint = require("./blueprint-1x01ITBT.cjs");
-const require_boolean2D = require("./boolean2D-C1Akp29q.cjs");
-const require_blueprintFns = require("./blueprintFns-DkmuKpz6.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-ygBBXxnP.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-DCttG3KS.cjs");
+const require_blueprint = require("./blueprint-D5ArjKiA.cjs");
+const require_boolean2D = require("./boolean2D-BCqDjg0y.cjs");
+const require_blueprintFns = require("./blueprintFns-CcCfkbyd.cjs");
 //#region src/core/curve2dHandle.ts
 /**
 * Wrap a raw kernel 2D curve handle with brand + disposal tracking.

package/dist/2d.js

@@ -1,10 +1,10 @@
-import { B as createKernelHandle, Q as getKernel2D, a as createEdge } from "./shapeTypes-z5bfGPVI.js";
+import { B as createKernelHandle, Q as getKernel2D, a as createEdge } from "./shapeTypes-C4lPfrc2.js";
 import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
-import { w as kernelCallRaw } from "./topologyQueryFns-De27Nxmf.js";
-import { a as Blueprints, i as CompoundBlueprint, r as organiseBlueprints } from "./blueprintSketcher-C5Q-JLEK.js";
-import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-DZB6Drrd.js";
-import { a as fuseBlueprints, c as roundedRectangleBlueprint, i as cutBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-DV642GXt.js";
-import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-o4dhTIZQ.js";
+import { w as kernelCallRaw } from "./topologyQueryFns-Do8E4EXj.js";
+import { a as Blueprints, i as CompoundBlueprint, r as organiseBlueprints } from "./blueprintSketcher-CEQ8s7TD.js";
+import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-CF12Nceg.js";
+import { a as fuseBlueprints, c as roundedRectangleBlueprint, i as cutBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-8rB2sUzj.js";
+import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-BuPAK4OB.js";
 //#region src/core/curve2dHandle.ts
 /**
 * Wrap a raw kernel 2D curve handle with brand + disposal tracking.

package/dist/{blueprint-DZB6Drrd.js → blueprint-CF12Nceg.js}

@@ -1,14 +1,14 @@
-import { G as unregisterFromCleanup, Q as getKernel2D, U as registerForCleanup, Z as getKernel, a as createEdge, u as createWire } from "./shapeTypes-z5bfGPVI.js";
+import { G as unregisterFromCleanup, Q as getKernel2D, U as registerForCleanup, Z as getKernel, a as createEdge, u as createWire } from "./shapeTypes-C4lPfrc2.js";
 import { n as wasmIndex } from "./vec3-Dpha8d5k.js";
 import { A as ok, R as unwrap, b as err, d as validationError, h as bug, n as computationError } from "./errors-DNWJsfVU.js";
 import { r as RAD2DEG, t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
 import { r as makePlane } from "./planeOps-DSjjtrjg.js";
-import { _ as cast, h as uvCoordinates, i as faceGeomType, m as uvBounds, r as faceCenter } from "./faceFns-CFvc_qXI.js";
-import { p as getOrientation } from "./curveFns-CaEoZJFJ.js";
+import { _ as cast, h as uvCoordinates, i as faceGeomType, m as uvBounds, r as faceCenter } from "./faceFns-mo4ThIHz.js";
+import { p as getOrientation } from "./curveFns-CG05Jygr.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { r as makeFace } from "./surfaceBuilders-BYopOndo.js";
-import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-BamnXOMX.js";
+import { r as makeFace } from "./surfaceBuilders-Bww4jhBo.js";
+import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-DT44wBAD.js";
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprint-1x01ITBT.cjs → blueprint-D5ArjKiA.cjs}

@@ -1,14 +1,14 @@
-const require_shapeTypes = require("./shapeTypes-DQfoZt_L.cjs");
+const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
-const require_faceFns = require("./faceFns-B7yceDjt.cjs");
-const require_curveFns = require("./curveFns-BIlzT4bO.cjs");
+const require_faceFns = require("./faceFns-DKg2St8b.cjs");
+const require_curveFns = require("./curveFns-Dx7_wMut.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-zGpnLDxz.cjs");
-const require_helpers = require("./helpers-A0a3O6af.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-FLnYYA70.cjs");
+const require_helpers = require("./helpers-8zxf2gkc.cjs");
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprintFns-o4dhTIZQ.js → blueprintFns-BuPAK4OB.js}

@@ -1,6 +1,6 @@
 import { A as ok, b as err, d as validationError, t as BrepErrorCode } from "./errors-DNWJsfVU.js";
-import { i as CompoundBlueprint } from "./blueprintSketcher-C5Q-JLEK.js";
-import { t as Blueprint } from "./blueprint-DZB6Drrd.js";
+import { i as CompoundBlueprint } from "./blueprintSketcher-CEQ8s7TD.js";
+import { t as Blueprint } from "./blueprint-CF12Nceg.js";
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintFns-DkmuKpz6.cjs → blueprintFns-CcCfkbyd.cjs}

@@ -1,6 +1,6 @@
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BoHwuwaU.cjs");
-const require_blueprint = require("./blueprint-1x01ITBT.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-DCttG3KS.cjs");
+const require_blueprint = require("./blueprint-D5ArjKiA.cjs");
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintSketcher-C5Q-JLEK.js → blueprintSketcher-CEQ8s7TD.js}

@@ -1,10 +1,10 @@
-import { Q as getKernel2D, Z as getKernel } from "./shapeTypes-z5bfGPVI.js";
+import { Q as getKernel2D, Z as getKernel } from "./shapeTypes-C4lPfrc2.js";
 import { n as wasmIndex } from "./vec3-Dpha8d5k.js";
 import { A as ok, R as unwrap, T as isOk, b as err, h as bug, n as computationError, s as safeIndex } from "./errors-DNWJsfVU.js";
 import { r as RAD2DEG, t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { _ as samePoint, b as subtract2d, d as cartesianToPolar, f as crossProduct2d, g as rotate2d, h as polarToCartesian, l as add2d, m as polarAngle2d, o as normalize2d, p as distance2d, v as scalarMultiply2d } from "./helpers-BamnXOMX.js";
-import { _ as Curve2D, c as make2dCircle, f as make2dSegmentCurve, h as approximateAsBSpline, m as make2dThreePointArc, n as asSVG, o as make2dArcFromCenter, p as make2dTangentArc, r as viewbox, s as make2dBezierCurve, t as Blueprint, u as make2dEllipseArc, x as isPoint2D, y as BoundingBox2d } from "./blueprint-DZB6Drrd.js";
+import { _ as samePoint, b as subtract2d, d as cartesianToPolar, f as crossProduct2d, g as rotate2d, h as polarToCartesian, l as add2d, m as polarAngle2d, o as normalize2d, p as distance2d, v as scalarMultiply2d } from "./helpers-DT44wBAD.js";
+import { _ as Curve2D, c as make2dCircle, f as make2dSegmentCurve, h as approximateAsBSpline, m as make2dThreePointArc, n as asSVG, o as make2dArcFromCenter, p as make2dTangentArc, r as viewbox, s as make2dBezierCurve, t as Blueprint, u as make2dEllipseArc, x as isPoint2D, y as BoundingBox2d } from "./blueprint-CF12Nceg.js";
 //#region node_modules/flatqueue/index.js
 /**
 * @typedef {Float64ArrayConstructor | Float32ArrayConstructor |

package/dist/{blueprintSketcher-BoHwuwaU.cjs → blueprintSketcher-DCttG3KS.cjs}

@@ -1,10 +1,10 @@
-const require_shapeTypes = require("./shapeTypes-DQfoZt_L.cjs");
+const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_helpers = require("./helpers-A0a3O6af.cjs");
-const require_blueprint = require("./blueprint-1x01ITBT.cjs");
+const require_helpers = require("./helpers-8zxf2gkc.cjs");
+const require_blueprint = require("./blueprint-D5ArjKiA.cjs");
 //#region node_modules/flatqueue/index.js
 /**
 * @typedef {Float64ArrayConstructor | Float32ArrayConstructor |

package/dist/{boolean2D-DV642GXt.js → boolean2D-8rB2sUzj.js}

@@ -1,10 +1,10 @@
 import { n as wasmIndex } from "./vec3-Dpha8d5k.js";
 import { R as unwrap, h as bug, s as safeIndex } from "./errors-DNWJsfVU.js";
 import { r as lastOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { v as zip } from "./surfaceBuilders-BYopOndo.js";
-import { a as Blueprints, i as CompoundBlueprint, l as intersectCurves, r as organiseBlueprints, t as BlueprintSketcher, u as Flatbush } from "./blueprintSketcher-C5Q-JLEK.js";
-import { _ as samePoint$1, b as subtract2d, f as crossProduct2d, s as PRECISION_INTERSECTION } from "./helpers-BamnXOMX.js";
-import { b as removeDuplicatePoints, f as make2dSegmentCurve, t as Blueprint } from "./blueprint-DZB6Drrd.js";
+import { v as zip } from "./surfaceBuilders-Bww4jhBo.js";
+import { a as Blueprints, i as CompoundBlueprint, l as intersectCurves, r as organiseBlueprints, t as BlueprintSketcher, u as Flatbush } from "./blueprintSketcher-CEQ8s7TD.js";
+import { _ as samePoint$1, b as subtract2d, f as crossProduct2d, s as PRECISION_INTERSECTION } from "./helpers-DT44wBAD.js";
+import { b as removeDuplicatePoints, f as make2dSegmentCurve, t as Blueprint } from "./blueprint-CF12Nceg.js";
 //#region src/2d/blueprints/cannedBlueprints.ts
 /**
 * Create a regular polygon blueprint inscribed in a circle of the given radius.

package/dist/{boolean2D-C1Akp29q.cjs → boolean2D-BCqDjg0y.cjs}

@@ -1,10 +1,10 @@
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-zGpnLDxz.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BoHwuwaU.cjs");
-const require_helpers = require("./helpers-A0a3O6af.cjs");
-const require_blueprint = require("./blueprint-1x01ITBT.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-FLnYYA70.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-DCttG3KS.cjs");
+const require_helpers = require("./helpers-8zxf2gkc.cjs");
+const require_blueprint = require("./blueprint-D5ArjKiA.cjs");
 //#region src/2d/blueprints/cannedBlueprints.ts
 /**
 * Create a regular polygon blueprint inscribed in a circle of the given radius.

package/dist/brepjs.cjs

@@ -1,37 +1,37 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_textBlueprints = require("./textBlueprints-B8cDsSHe.cjs");
-const require_shapeTypes = require("./shapeTypes-DQfoZt_L.cjs");
-const require_occtWasmAdapter = require("./occtWasmAdapter-Bv2OTOX9.cjs");
+const require_textBlueprints = require("./textBlueprints-08NcMO9T.cjs");
+const require_shapeTypes = require("./shapeTypes-Bwgm5N6R.cjs");
+const require_occtWasmAdapter = require("./occtWasmAdapter-DDZELjlB.cjs");
 const require_vec3 = require("./vec3-CFwOI0ZI.cjs");
 const require_errors = require("./errors-CXJtc4I7.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-BLkQkExs.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-ygBBXxnP.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
 const require_planeOps = require("./planeOps-BA4HfgQu.cjs");
-const require_faceFns = require("./faceFns-B7yceDjt.cjs");
-const require_shapeFns = require("./shapeFns-B3GP-0FJ.cjs");
-const require_curveFns = require("./curveFns-BIlzT4bO.cjs");
-const require_meshFns = require("./meshFns-BKBGgLB4.cjs");
+const require_faceFns = require("./faceFns-DKg2St8b.cjs");
+const require_shapeFns = require("./shapeFns-L4a8kH_A.cjs");
+const require_curveFns = require("./curveFns-Dx7_wMut.cjs");
+const require_meshFns = require("./meshFns-DeKdpmu7.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-zGpnLDxz.cjs");
-const require_solidBuilders = require("./solidBuilders-B0Uyvvyy.cjs");
-const require_healingFns = require("./healingFns-CEzX-45q.cjs");
-const require_threadFns = require("./threadFns-B_8tna0V.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-BoHwuwaU.cjs");
-const require_helpers = require("./helpers-A0a3O6af.cjs");
-const require_drawFns = require("./drawFns-Dwq6JHbb.cjs");
-const require_measureFns = require("./measureFns-Cmc_y0WE.cjs");
-const require_cornerFinder = require("./cornerFinder-CqSNuWBI.cjs");
-const require_boolean2D = require("./boolean2D-C1Akp29q.cjs");
-const require_blueprintFns = require("./blueprintFns-DkmuKpz6.cjs");
-const require_importFns = require("./importFns-Dj107tFY.cjs");
-const require_loftFns = require("./loftFns-CFyOO359.cjs");
-const require_cameraFns = require("./cameraFns-B-T9D-ie.cjs");
-const require_textMetrics = require("./textMetrics-B8qEy3dh.cjs");
-const require_shapeRefFns = require("./shapeRefFns-C6L7KhTi.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-FLnYYA70.cjs");
+const require_solidBuilders = require("./solidBuilders-CgRmJEdn.cjs");
+const require_healingFns = require("./healingFns-CM5mVMow.cjs");
+const require_threadFns = require("./threadFns-DGYdomjN.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-DCttG3KS.cjs");
+const require_helpers = require("./helpers-8zxf2gkc.cjs");
+const require_drawFns = require("./drawFns-DYkjT_hx.cjs");
+const require_measureFns = require("./measureFns-Q2dnokUU.cjs");
+const require_cornerFinder = require("./cornerFinder-Ci2NbbAW.cjs");
+const require_boolean2D = require("./boolean2D-BCqDjg0y.cjs");
+const require_blueprintFns = require("./blueprintFns-CcCfkbyd.cjs");
+const require_importFns = require("./importFns-B6hw9Nhx.cjs");
+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_primitiveFns = require("./primitiveFns-B898KlXM.cjs");
+const require_primitiveFns = require("./primitiveFns-BAWtMd9H.cjs");
 //#region src/topology/shapeBooleans.ts
 var BOPAlgo_GlueShift = 1;
 var BOPAlgo_GlueFull = 2;
@@ -2132,6 +2132,139 @@ function roof(w, options) {
 	}
 }
 //#endregion
+//#region src/operations/instanceFns.ts
+/**
+* Transform-only instancing — hold ONE source shape + N placements without
+* copying the kernel shape. Real geometry (a Compound, or a fused solid) or a
+* render payload (one mesh + N matrices) is produced only on demand.
+*
+* A 10x10 grid is 1 solid + 100 transforms, not 100 booleans. Materialize-on-
+* export keeps the kernel work deferred; `instancedMesh` meshes the source once
+* for an instanced (e.g. three.js InstancedMesh) preview.
+*/
+function translation(v) {
+	return [
+		[
+			1,
+			0,
+			0,
+			v[0]
+		],
+		[
+			0,
+			1,
+			0,
+			v[1]
+		],
+		[
+			0,
+			0,
+			1,
+			v[2]
+		],
+		[
+			0,
+			0,
+			0,
+			1
+		]
+	];
+}
+function isVec3Array(p) {
+	const first = p[0];
+	return first !== void 0 && typeof first[0] === "number";
+}
+function make(source, placements, grid) {
+	return {
+		__instanced: true,
+		source,
+		placements,
+		grid,
+		[Symbol.dispose]() {
+			source[Symbol.dispose]();
+		}
+	};
+}
+/** Type guard for an InstancedShape. */
+function isInstanced(x) {
+	return typeof x === "object" && x !== null && x.__instanced === true;
+}
+/**
+* Instance a shape across explicit placements. `Vec3[]` is translate-only sugar
+* for `Matrix4x4[]`. The source is owned by the returned container.
+*/
+function instance(source, placements) {
+	return make(source, isVec3Array(placements) ? placements.map(translation) : placements.map((m) => m.map((row) => [...row])));
+}
+/** Instance a shape across a cols x rows grid in the XY plane. */
+function instanceGrid(source, opts) {
+	const { cols, rows, pitchX, pitchY } = opts;
+	if (!Number.isInteger(cols) || !Number.isInteger(rows) || cols < 1 || rows < 1) throw new RangeError(`instanceGrid: cols and rows must be positive integers, got ${cols}x${rows}`);
+	const placements = [];
+	for (let i = 0; i < cols; i++) for (let j = 0; j < rows; j++) placements.push(translation([
+		i * pitchX,
+		j * pitchY,
+		0
+	]));
+	return make(source, placements, {
+		cols,
+		rows,
+		pitchX,
+		pitchY
+	});
+}
+/** Number of placements. */
+function instanceCount(inst) {
+	return inst.placements.length;
+}
+/**
+* Produce real geometry: a Compound of N placed copies (default), or a single
+* fused solid (`fuse: true`, 3D only). This is where the N kernel transforms
+* happen. A grid-built instance fuses via the faster kernel `gridPattern`.
+*/
+function materialize(inst, opts = {}) {
+	const { source, placements, grid } = inst;
+	if (placements.length === 0) return require_errors.err(require_errors.validationError("INSTANCE_EMPTY", "materialize: instance has no placements"));
+	if (opts.fuse) {
+		if (!require_shapeTypes.isShape3D(source)) return require_errors.err(require_errors.validationError("MATERIALIZE_NOT_3D", "materialize({fuse:true}) requires a 3D source shape"));
+		if (grid) return require_threadFns.gridPattern(source, [
+			1,
+			0,
+			0
+		], [
+			0,
+			1,
+			0
+		], grid.cols, grid.rows, grid.pitchX, grid.pitchY);
+		return combine(source, placements, true);
+	}
+	return combine(source, placements, false);
+}
+function combine(source, placements, fuse) {
+	const copies = [];
+	for (const m of placements) {
+		const placed = require_shapeFns.applyMatrix(source, m);
+		if (!placed.ok) {
+			for (const c of copies) c[Symbol.dispose]();
+			return placed;
+		}
+		copies.push(placed.value);
+	}
+	const result = fuse ? require_solidBuilders.fuseAll(copies, { unsafe: true }) : require_errors.ok(require_solidBuilders.makeCompound(copies));
+	for (const c of copies) if (!result.ok || c !== result.value) c[Symbol.dispose]();
+	return result;
+}
+/**
+* Mesh the source once and return it alongside the placements — the
+* "one tessellation, N placements" render payload for an instanced draw.
+*/
+function instancedMesh(inst, opts) {
+	return {
+		geometry: require_meshFns.mesh(inst.source, opts),
+		instances: inst.placements
+	};
+}
+//#endregion
 //#region src/kernel/solverAdapter.ts
 /**
 * Constraint solver adapter — analytical solver for simple assembly mates.
@@ -5645,34 +5778,61 @@ function cacheKey(node, env, kernelId, tolerance) {
 	return `${toHex(node.structuralHash)}:${kernelId}:${toHex(projHash)}:${tolHash}`;
 }
 var Evaluator = class {
-	scope = new require_shapeTypes.DisposalScope();
 	cache = /* @__PURE__ */ new Map();
-	registered = /* @__PURE__ */ new WeakSet();
+	refCounts = /* @__PURE__ */ new Map();
+	evaluating = false;
+	pendingKeys = [];
 	kernelId;
 	defaultTolerance;
+	maxCacheEntries;
 	onStep;
 	hits = 0;
 	misses = 0;
+	evictions = 0;
 	constructor(options = {}) {
 		this.kernelId = options.kernel ?? require_shapeTypes.getActiveKernelId() ?? "unregistered";
 		this.defaultTolerance = options.tolerance;
 		if (options.onStep) this.onStep = options.onStep;
+		const max = options.maxCacheEntries;
+		if (max !== void 0 && (!Number.isInteger(max) || max < 1)) throw new RangeError(`Evaluator: maxCacheEntries must be a positive integer, got ${String(max)}`);
+		this.maxCacheEntries = max;
 	}
 	/**
 	* Materialize a CSG IR tree against the given parameter environment.
-	* The returned shape is borrowed — valid for as long as this Evaluator is
-	* not disposed. Callers must NOT call `.delete()` / `[Symbol.dispose]()`
-	* on the returned shape; that would invalidate the cache entry for every
-	* future call returning the same handle.
+	* The returned shape is borrowed — callers must NOT call `.delete()` /
+	* `[Symbol.dispose]()` on it; that would invalidate the cache entry for
+	* every future call returning the same handle. By default it stays valid
+	* until the Evaluator is disposed; if `maxCacheEntries` is set, only until
+	* the next successful evaluate() call (LRU eviction may free older entries),
+	* and evaluate() is then non-reentrant — calling it from an onStep callback
+	* throws.
 	*/
 	evaluate(node, env = {}) {
-		return require_shapeTypes.withKernel(this.kernelId, () => this.evaluateInner(node, env));
+		if (this.maxCacheEntries !== void 0 && this.evaluating) throw new Error("Evaluator.evaluate() is not reentrant when maxCacheEntries is set — do not call it from an onStep callback.");
+		return require_shapeTypes.withKernel(this.kernelId, () => {
+			this.evaluating = true;
+			let committed = false;
+			try {
+				const result = this.evaluateInner(node, env);
+				if (this.maxCacheEntries !== void 0 && result.ok) this.trimCache(this.maxCacheEntries);
+				committed = result.ok;
+				return result;
+			} finally {
+				if (!committed && this.maxCacheEntries !== void 0) this.rollbackPending();
+				this.pendingKeys.length = 0;
+				this.evaluating = false;
+			}
+		});
 	}
 	evaluateInner(node, env) {
 		const key = cacheKey(node, env, this.kernelId, this.defaultTolerance);
 		const cached = this.cache.get(key);
 		if (cached !== void 0) {
 			this.hits++;
+			if (this.maxCacheEntries !== void 0) {
+				this.cache.delete(key);
+				this.cache.set(key, cached);
+			}
 			this.onStep?.({
 				node,
 				cacheKey: key,
@@ -5687,11 +5847,10 @@ var Evaluator = class {
 			evalNode: (child) => this.evaluateInner(child, env)
 		});
 		if (!result.ok) return result;
-		if (!this.registered.has(result.value)) {
-			this.scope.register(result.value);
-			this.registered.add(result.value);
-		}
-		this.cache.set(key, result.value);
+		const shape = result.value;
+		this.refCounts.set(shape, (this.refCounts.get(shape) ?? 0) + 1);
+		this.cache.set(key, shape);
+		if (this.maxCacheEntries !== void 0) this.pendingKeys.push(key);
 		this.onStep?.({
 			node,
 			cacheKey: key,
@@ -5699,19 +5858,48 @@ var Evaluator = class {
 		});
 		return result;
 	}
+	releaseShape(shape) {
+		const next = (this.refCounts.get(shape) ?? 1) - 1;
+		if (next <= 0) {
+			this.refCounts.delete(shape);
+			shape[Symbol.dispose]();
+		} else this.refCounts.set(shape, next);
+	}
+	trimCache(max) {
+		while (this.cache.size > max) {
+			const oldest = this.cache.keys().next();
+			if (oldest.done) break;
+			const key = oldest.value;
+			const shape = this.cache.get(key);
+			this.cache.delete(key);
+			this.evictions++;
+			if (shape !== void 0) this.releaseShape(shape);
+		}
+	}
+	rollbackPending() {
+		for (const key of this.pendingKeys) {
+			const shape = this.cache.get(key);
+			if (shape === void 0) continue;
+			this.cache.delete(key);
+			this.releaseShape(shape);
+		}
+	}
 	cacheStats() {
 		return {
 			hits: this.hits,
 			misses: this.misses,
-			entries: this.cache.size
+			entries: this.cache.size,
+			evictions: this.evictions
 		};
 	}
 	resetStats() {
 		this.hits = 0;
 		this.misses = 0;
+		this.evictions = 0;
 	}
 	[Symbol.dispose]() {
-		this.scope[Symbol.dispose]();
+		for (const shape of this.refCounts.keys()) shape[Symbol.dispose]();
+		this.refCounts.clear();
 		this.cache.clear();
 	}
 };
@@ -6733,6 +6921,7 @@ exports.getTagMetadata = require_shapeFns.getTagMetadata;
 exports.getVertices = require_topologyQueryFns.getVertices;
 exports.getVoxel = getVoxel;
 exports.getWires = require_topologyQueryFns.getWires;
+exports.gridPattern = require_threadFns.gridPattern;
 exports.guidedSweep = require_loftFns.guidedSweep;
 exports.heal = heal;
 exports.healFace = require_healingFns.healFace;
@@ -6755,6 +6944,10 @@ exports.initFromManifold = require_shapeTypes.initFromManifold;
 exports.initFromOC = require_shapeTypes.initFromOC;
 exports.initVoxel = initVoxel;
 exports.innerWires = require_faceFns.innerWires;
+exports.instance = instance;
+exports.instanceCount = instanceCount;
+exports.instanceGrid = instanceGrid;
+exports.instancedMesh = instancedMesh;
 exports.interpolateCurve = require_curveFns.interpolateCurve;
 exports.intersect = intersect;
 exports.intersect2D = require_boolean2D.intersect2D;
@@ -6785,6 +6978,7 @@ exports.isFace = require_shapeTypes.isFace;
 exports.isFilletRadius = isFilletRadius;
 exports.isInitRequest = require_workerHandler.isInitRequest;
 exports.isInside2D = require_blueprintFns.isInside2D;
+exports.isInstanced = isInstanced;
 exports.isLive = require_shapeTypes.isLive;
 exports.isManifoldShell = require_shapeTypes.isManifoldShell;
 exports.isNumber = isNumber;
@@ -6838,6 +7032,7 @@ exports.map = require_errors.map;
 exports.mapBoth = require_errors.mapBoth;
 exports.mapErr = require_errors.mapErr;
 exports.match = require_errors.match;
+exports.materialize = materialize;
 exports.measureArea = require_measureFns.measureArea;
 exports.measureCurvatureAt = require_measureFns.measureCurvatureAt;
 exports.measureCurvatureAtMid = require_measureFns.measureCurvatureAtMid;