brepjs 20.12.11 → 20.12.12

package/dist/{drawFns-BQIHgHQg.js → drawFns-Bht1ceeH.js}

@@ -10,12 +10,12 @@ import { d as pointOnSurface, l as normalAt, m as uvBounds, r as faceCenter, u a
 import { h as offsetWire2D, i as curveIsClosed, l as curveStartPoint } from "./curveFns-EsJgIpc6.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-BpgouNir.js";
 import { c as makeBSplineApproximation, d as makeCircle, f as makeEllipse, m as makeHelix, r as makeFace, s as assembleWire } from "./surfaceBuilders-BBs6D6Km.js";
-import { a as Blueprints, c as make2dOffset, i as CompoundBlueprint, l as intersectCurves, n as BaseSketcher2d, o as chamferCurves, s as filletCurves, u as Flatbush } from "./blueprintSketcher-nBI9PlsW.js";
-import { b as squareDistance2d, l as add2d, s as PRECISION_OFFSET, v as samePoint$1, x as subtract2d } from "./helpers-CsHdKbfF.js";
-import { _ as approximateAsSvgCompatibleCurve, a as edgeToCurve, f as make2dInerpolatedBSplineCurve, i as curvesAsEdgesOnPlane, l as make2dCircle, p as make2dSegmentCurve, s as make2dArcFromCenter, t as Blueprint, u as make2dEllipse, v as Curve2D, x as BoundingBox2d, y as deserializeCurve2D } from "./blueprint-DbNFPHzC.js";
-import { t as cornerFinder } from "./cornerFinder-CeyQ5JMA.js";
-import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-DuWgyjOR.js";
-import { _ as wrapSketchData, a as Sketches, o as Sketch, t as textBlueprints, v as wrapSketchDataArray } from "./textBlueprints-BvZNjVwM.js";
+import { a as Blueprints, c as make2dOffset, i as CompoundBlueprint, l as intersectCurves, n as BaseSketcher2d, o as chamferCurves, s as filletCurves, u as Flatbush } from "./blueprintSketcher-DPP1g95U.js";
+import { b as squareDistance2d, l as add2d, s as PRECISION_OFFSET, v as samePoint$1, x as subtract2d } from "./helpers-BuI9lh-t.js";
+import { _ as approximateAsSvgCompatibleCurve, a as edgeToCurve, f as make2dInerpolatedBSplineCurve, i as curvesAsEdgesOnPlane, l as make2dCircle, p as make2dSegmentCurve, s as make2dArcFromCenter, t as Blueprint, u as make2dEllipse, v as Curve2D, x as BoundingBox2d, y as deserializeCurve2D } from "./blueprint-BYXwa2cF.js";
+import { t as cornerFinder } from "./cornerFinder-DgVMDBCo.js";
+import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-CNf7lVXV.js";
+import { _ as wrapSketchData, a as Sketches, o as Sketch, t as textBlueprints, v as wrapSketchDataArray } from "./textBlueprints-Dq3pUNSr.js";
 import { i as projectEdges, t as cameraFromPlane } from "./cameraFns-CLkNCsYU.js";
 // src/2d/lib/stitching.ts
 /**

package/dist/{drawFns-JZV96JGO.cjs → drawFns-CLJog-Xp.cjs}

@@ -10,12 +10,12 @@ const require_faceFns = require("./faceFns-Jo9hMVqL.cjs");
 const require_curveFns = require("./curveFns-B8mm5cou.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
 const require_surfaceBuilders = require("./surfaceBuilders-D5kFAV1i.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-DHp6AeEM.cjs");
-const require_helpers = require("./helpers-BvYkHZK7.cjs");
-const require_blueprint = require("./blueprint-BY2aygt_.cjs");
-const require_cornerFinder = require("./cornerFinder-Da8Dv4bp.cjs");
-const require_boolean2D = require("./boolean2D-C6TS6oFP.cjs");
-const require_textBlueprints = require("./textBlueprints-D3XhH1kb.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-zQgjgodb.cjs");
+const require_helpers = require("./helpers-D7Y4Vxhf.cjs");
+const require_blueprint = require("./blueprint-DtPRNDEu.cjs");
+const require_cornerFinder = require("./cornerFinder-Dzsi68w-.cjs");
+const require_boolean2D = require("./boolean2D-BJFpEXix.cjs");
+const require_textBlueprints = require("./textBlueprints-BPrPhg5b.cjs");
 const require_cameraFns = require("./cameraFns-B9xKg36U.cjs");
 // src/2d/lib/stitching.ts
 /**

package/dist/{healingFns-qioD81Of.cjs → healingFns-DGc2hk9z.cjs}

@@ -4,7 +4,7 @@ const require_errors = require("./errors-O_blYTWT.cjs");
 const require_topologyQueryFns = require("./topologyQueryFns-BUhKY2Kj.cjs");
 const require_constants = require("./constants-oee0S_x6.cjs");
 const require_faceFns = require("./faceFns-Jo9hMVqL.cjs");
-const require_booleanFns = require("./booleanFns-D0qfjH0a.cjs");
+const require_booleanFns = require("./booleanFns-CkcJ8WB7.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
 // src/topology/threeHelpers.ts
 /**
@@ -855,6 +855,22 @@ function freezeTelemetry(t) {
 		failedInputs: [...t.failedInputs].sort((a, b) => a - b)
 	};
 }
+function releaseOwned(node) {
+	if (node.owned) require_shapeTypes.disposeResultShape(node.shape);
+}
+/** If the run was cancelled, release the `held` nodes this frame owns and throw. */
+function throwIfAborted(options, ...held) {
+	if (!options.signal?.aborted) return;
+	for (const node of held) releaseOwned(node);
+	throw options.signal.reason;
+}
+/**
+* The caller's copy of the final node. A caller's own input can survive to the
+* top (nothing combined, or every step failed), so it comes back as a copy.
+*/
+function ownedResult(node, options) {
+	return node.owned ? require_errors.ok(node.shape) : require_booleanFns.copyAsBooleanResult(node.shape, options.trackEvolution ?? true);
+}
 function cutAllBisect(base, tools, options = {}) {
 	return cutAllBisectWith(REAL_OPS, base, tools, options);
 }
@@ -868,23 +884,36 @@ function cutAllBisectWith(ops, base, tools, options = {}) {
 		singletonFallbacks: 0,
 		failedInputs: /* @__PURE__ */ new Set()
 	};
-	const result = bisectCut(ops, base, tools, 0, options, telemetry);
+	const result = bisectCut(ops, {
+		shape: base,
+		owned: false
+	}, tools, 0, options, telemetry);
 	if (require_errors.isErr(result)) return result;
+	const shape = ownedResult(result.value, options);
+	if (require_errors.isErr(shape)) return shape;
 	return require_errors.ok({
-		shape: result.value,
+		shape: shape.value,
 		telemetry: freezeTelemetry(telemetry)
 	});
 }
+/**
+* Cut `tools` from `base`. An owned base is consumed: it comes back as the
+* result when nothing was cut, and is released otherwise, on a throw included.
+*/
 function bisectCut(ops, base, tools, startIdx, options, telemetry) {
 	if (tools.length === 0) return require_errors.ok(base);
 	if (tools.length === 1) return applySingletonCut(ops, base, tools, startIdx, options, telemetry);
 	telemetry.batchAttempts++;
-	const batchResult = tryBatch(() => ops.cutAll(base, tools, options));
+	const batchResult = tryBatch(() => ops.cutAll(base.shape, tools, options));
 	if (batchResult && batchResult.ok) {
 		telemetry.batchSucceeded++;
-		return batchResult;
+		releaseOwned(base);
+		return require_errors.ok({
+			shape: batchResult.value,
+			owned: true
+		});
 	}
-	if (options.signal?.aborted) throw options.signal.reason;
+	throwIfAborted(options, base);
 	const mid = Math.floor(tools.length / 2);
 	const left = bisectCut(ops, base, tools.slice(0, mid), startIdx, options, telemetry);
 	if (!left.ok) return left;
@@ -893,9 +922,15 @@ function bisectCut(ops, base, tools, startIdx, options, telemetry) {
 function applySingletonCut(ops, base, tools, startIdx, options, telemetry) {
 	telemetry.singletonFallbacks++;
 	const tool = require_arrayAccess.firstOrThrow(tools);
-	const pairResult = tryBatch(() => ops.cut(base, tool, options));
-	if (pairResult && pairResult.ok) return pairResult;
-	if (options.signal?.aborted) throw options.signal.reason;
+	const pairResult = tryBatch(() => ops.cut(base.shape, tool, options));
+	if (pairResult && pairResult.ok) {
+		releaseOwned(base);
+		return require_errors.ok({
+			shape: pairResult.value,
+			owned: true
+		});
+	}
+	throwIfAborted(options, base);
 	telemetry.failedInputs.add(startIdx);
 	return require_errors.ok(base);
 }
@@ -915,29 +950,54 @@ function fuseAllBisectWith(ops, shapes, options = {}) {
 	};
 	const result = bisectFuse(ops, shapes, 0, options, telemetry);
 	if (require_errors.isErr(result)) return result;
+	const shape = ownedResult(result.value, options);
+	if (require_errors.isErr(shape)) return shape;
 	return require_errors.ok({
-		shape: result.value,
+		shape: shape.value,
 		telemetry: freezeTelemetry(telemetry)
 	});
 }
 function bisectFuse(ops, shapes, startIdx, options, telemetry) {
-	if (shapes.length === 1) return require_errors.ok(require_arrayAccess.firstOrThrow(shapes));
+	if (shapes.length === 1) return require_errors.ok({
+		shape: require_arrayAccess.firstOrThrow(shapes),
+		owned: false
+	});
 	telemetry.batchAttempts++;
 	const batchResult = tryBatch(() => ops.fuseAll(shapes, options));
 	if (batchResult && batchResult.ok) {
 		telemetry.batchSucceeded++;
-		return batchResult;
+		return require_errors.ok({
+			shape: batchResult.value,
+			owned: true
+		});
 	}
-	if (options.signal?.aborted) throw options.signal.reason;
+	throwIfAborted(options);
 	const mid = Math.floor(shapes.length / 2);
-	return combineFuseHalves(ops, bisectFuse(ops, shapes.slice(0, mid), startIdx, options, telemetry), bisectFuse(ops, shapes.slice(mid), startIdx + mid, options, telemetry), shapes, startIdx, mid, options, telemetry);
+	const left = bisectFuse(ops, shapes.slice(0, mid), startIdx, options, telemetry);
+	let right;
+	try {
+		right = bisectFuse(ops, shapes.slice(mid), startIdx + mid, options, telemetry);
+	} catch (cause) {
+		if (left.ok) releaseOwned(left.value);
+		throw cause;
+	}
+	return combineFuseHalves(ops, left, right, shapes, startIdx, mid, options, telemetry);
 }
 function combineFuseHalves(ops, left, right, shapes, startIdx, mid, options, telemetry) {
 	if (left.ok && right.ok) {
 		telemetry.singletonFallbacks++;
-		const merged = tryBatch(() => ops.fuse(left.value, right.value, options));
-		if (merged && merged.ok) return merged;
+		const merged = tryBatch(() => ops.fuse(left.value.shape, right.value.shape, options));
+		if (merged && merged.ok) {
+			releaseOwned(left.value);
+			releaseOwned(right.value);
+			return require_errors.ok({
+				shape: merged.value,
+				owned: true
+			});
+		}
+		throwIfAborted(options, left.value, right.value);
 		for (let i = mid; i < shapes.length; i++) telemetry.failedInputs.add(startIdx + i);
+		releaseOwned(right.value);
 		return left;
 	}
 	if (left.ok) {

package/dist/{healingFns-D6mUhe0Z.js → healingFns-DvuJr4RS.js}

@@ -4,7 +4,7 @@ import { E as ok, b as isErr, d as validationError, g as err, i as kernelError,
 import { C as subShapeHashes, O as getSuggestionForCode, c as getFaces, i as getCachedIsValid, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-yOGEI9hO.js";
 import { n as HASH_CODE_MAX } from "./constants-iraOnb2p.js";
 import { y as downcast } from "./faceFns-2jGPfqvB.js";
-import { a as fuseAll, d as collectInputFaceHashes, i as fuse, m as propagateMetadataByHash, n as cut, p as propagateAllMetadata, r as cutAll } from "./booleanFns-BwzBRGqj.js";
+import { a as fuse, f as collectInputFaceHashes, h as propagateMetadataByHash, i as cutAll, m as propagateAllMetadata, n as copyAsBooleanResult, o as fuseAll, r as cut } from "./booleanFns-B9RvEpHB.js";
 import { t as firstOrThrow } from "./arrayAccess-BpgouNir.js";
 // src/topology/threeHelpers.ts
 /**
@@ -855,6 +855,22 @@ function freezeTelemetry(t) {
 		failedInputs: [...t.failedInputs].sort((a, b) => a - b)
 	};
 }
+function releaseOwned(node) {
+	if (node.owned) disposeResultShape(node.shape);
+}
+/** If the run was cancelled, release the `held` nodes this frame owns and throw. */
+function throwIfAborted(options, ...held) {
+	if (!options.signal?.aborted) return;
+	for (const node of held) releaseOwned(node);
+	throw options.signal.reason;
+}
+/**
+* The caller's copy of the final node. A caller's own input can survive to the
+* top (nothing combined, or every step failed), so it comes back as a copy.
+*/
+function ownedResult(node, options) {
+	return node.owned ? ok(node.shape) : copyAsBooleanResult(node.shape, options.trackEvolution ?? true);
+}
 function cutAllBisect(base, tools, options = {}) {
 	return cutAllBisectWith(REAL_OPS, base, tools, options);
 }
@@ -868,23 +884,36 @@ function cutAllBisectWith(ops, base, tools, options = {}) {
 		singletonFallbacks: 0,
 		failedInputs: /* @__PURE__ */ new Set()
 	};
-	const result = bisectCut(ops, base, tools, 0, options, telemetry);
+	const result = bisectCut(ops, {
+		shape: base,
+		owned: false
+	}, tools, 0, options, telemetry);
 	if (isErr(result)) return result;
+	const shape = ownedResult(result.value, options);
+	if (isErr(shape)) return shape;
 	return ok({
-		shape: result.value,
+		shape: shape.value,
 		telemetry: freezeTelemetry(telemetry)
 	});
 }
+/**
+* Cut `tools` from `base`. An owned base is consumed: it comes back as the
+* result when nothing was cut, and is released otherwise, on a throw included.
+*/
 function bisectCut(ops, base, tools, startIdx, options, telemetry) {
 	if (tools.length === 0) return ok(base);
 	if (tools.length === 1) return applySingletonCut(ops, base, tools, startIdx, options, telemetry);
 	telemetry.batchAttempts++;
-	const batchResult = tryBatch(() => ops.cutAll(base, tools, options));
+	const batchResult = tryBatch(() => ops.cutAll(base.shape, tools, options));
 	if (batchResult && batchResult.ok) {
 		telemetry.batchSucceeded++;
-		return batchResult;
+		releaseOwned(base);
+		return ok({
+			shape: batchResult.value,
+			owned: true
+		});
 	}
-	if (options.signal?.aborted) throw options.signal.reason;
+	throwIfAborted(options, base);
 	const mid = Math.floor(tools.length / 2);
 	const left = bisectCut(ops, base, tools.slice(0, mid), startIdx, options, telemetry);
 	if (!left.ok) return left;
@@ -893,9 +922,15 @@ function bisectCut(ops, base, tools, startIdx, options, telemetry) {
 function applySingletonCut(ops, base, tools, startIdx, options, telemetry) {
 	telemetry.singletonFallbacks++;
 	const tool = firstOrThrow(tools);
-	const pairResult = tryBatch(() => ops.cut(base, tool, options));
-	if (pairResult && pairResult.ok) return pairResult;
-	if (options.signal?.aborted) throw options.signal.reason;
+	const pairResult = tryBatch(() => ops.cut(base.shape, tool, options));
+	if (pairResult && pairResult.ok) {
+		releaseOwned(base);
+		return ok({
+			shape: pairResult.value,
+			owned: true
+		});
+	}
+	throwIfAborted(options, base);
 	telemetry.failedInputs.add(startIdx);
 	return ok(base);
 }
@@ -915,29 +950,54 @@ function fuseAllBisectWith(ops, shapes, options = {}) {
 	};
 	const result = bisectFuse(ops, shapes, 0, options, telemetry);
 	if (isErr(result)) return result;
+	const shape = ownedResult(result.value, options);
+	if (isErr(shape)) return shape;
 	return ok({
-		shape: result.value,
+		shape: shape.value,
 		telemetry: freezeTelemetry(telemetry)
 	});
 }
 function bisectFuse(ops, shapes, startIdx, options, telemetry) {
-	if (shapes.length === 1) return ok(firstOrThrow(shapes));
+	if (shapes.length === 1) return ok({
+		shape: firstOrThrow(shapes),
+		owned: false
+	});
 	telemetry.batchAttempts++;
 	const batchResult = tryBatch(() => ops.fuseAll(shapes, options));
 	if (batchResult && batchResult.ok) {
 		telemetry.batchSucceeded++;
-		return batchResult;
+		return ok({
+			shape: batchResult.value,
+			owned: true
+		});
 	}
-	if (options.signal?.aborted) throw options.signal.reason;
+	throwIfAborted(options);
 	const mid = Math.floor(shapes.length / 2);
-	return combineFuseHalves(ops, bisectFuse(ops, shapes.slice(0, mid), startIdx, options, telemetry), bisectFuse(ops, shapes.slice(mid), startIdx + mid, options, telemetry), shapes, startIdx, mid, options, telemetry);
+	const left = bisectFuse(ops, shapes.slice(0, mid), startIdx, options, telemetry);
+	let right;
+	try {
+		right = bisectFuse(ops, shapes.slice(mid), startIdx + mid, options, telemetry);
+	} catch (cause) {
+		if (left.ok) releaseOwned(left.value);
+		throw cause;
+	}
+	return combineFuseHalves(ops, left, right, shapes, startIdx, mid, options, telemetry);
 }
 function combineFuseHalves(ops, left, right, shapes, startIdx, mid, options, telemetry) {
 	if (left.ok && right.ok) {
 		telemetry.singletonFallbacks++;
-		const merged = tryBatch(() => ops.fuse(left.value, right.value, options));
-		if (merged && merged.ok) return merged;
+		const merged = tryBatch(() => ops.fuse(left.value.shape, right.value.shape, options));
+		if (merged && merged.ok) {
+			releaseOwned(left.value);
+			releaseOwned(right.value);
+			return ok({
+				shape: merged.value,
+				owned: true
+			});
+		}
+		throwIfAborted(options, left.value, right.value);
 		for (let i = mid; i < shapes.length; i++) telemetry.failedInputs.add(startIdx + i);
+		releaseOwned(right.value);
 		return left;
 	}
 	if (left.ok) {

package/dist/{helpers-CsHdKbfF.js → helpers-BuI9lh-t.js}

@@ -6,7 +6,7 @@ import { a as vecDot, d as vecNormalize } from "./vecOps-S-m9H_fe.js";
 import { l as normalAt, s as getSurfaceType } from "./faceFns-2jGPfqvB.js";
 import { a as isSameShape, n as getHashCode } from "./shapeFns-kFm-m8jh.js";
 import { f as getCurveType, i as curveIsClosed, o as curveLength } from "./curveFns-EsJgIpc6.js";
-import { n as measureArea } from "./measureFns-D3egqKcW.js";
+import { n as measureArea } from "./measureFns--UKrACtx.js";
 // src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;

package/dist/{helpers-BvYkHZK7.cjs → helpers-D7Y4Vxhf.cjs}

@@ -6,7 +6,7 @@ const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
 const require_faceFns = require("./faceFns-Jo9hMVqL.cjs");
 const require_shapeFns = require("./shapeFns-D47cmLG8.cjs");
 const require_curveFns = require("./curveFns-B8mm5cou.cjs");
-const require_measureFns = require("./measureFns-R85865k9.cjs");
+const require_measureFns = require("./measureFns-D8uSDn-8.cjs");
 // src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;

package/dist/{importFns-BzzUvnKA.cjs → importFns-Dwlc0KtB.cjs}

@@ -6,7 +6,7 @@ const require_constants = require("./constants-oee0S_x6.cjs");
 const require_solidBuilders = require("./solidBuilders-Dwm0hXn5.cjs");
 const require_meshFns = require("./meshFns-Cs_qrlXI.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
-const require_blueprint = require("./blueprint-BY2aygt_.cjs");
+const require_blueprint = require("./blueprint-DtPRNDEu.cjs");
 // src/io/objExportFns.ts
 /** Read a vec3 from a typed array at the given vertex index. */
 function vec3At(arr, i) {

package/dist/{importFns-C8yUNPzJ.js → importFns-TKzj4FaZ.js}

@@ -6,7 +6,7 @@ import { n as HASH_CODE_MAX } from "./constants-iraOnb2p.js";
 import { t as makeCompound } from "./solidBuilders-ZDGdvaTU.js";
 import { u as igesUnsupportedError } from "./meshFns-Bo4EQJFO.js";
 import { n as getAtOrThrow } from "./arrayAccess-BpgouNir.js";
-import { c as make2dBezierCurve, h as make2dThreePointArc, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-DbNFPHzC.js";
+import { c as make2dBezierCurve, h as make2dThreePointArc, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-BYXwa2cF.js";
 // src/io/objExportFns.ts
 /** Read a vec3 from a typed array at the given vertex index. */
 function vec3At(arr, i) {

package/dist/io.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_meshFns = require("./meshFns-Cs_qrlXI.cjs");
-const require_importFns = require("./importFns-BzzUvnKA.cjs");
+const require_importFns = require("./importFns-Dwlc0KtB.cjs");
 exports.blueprintToDXF = require_importFns.blueprintToDXF;
 exports.exportDXF = require_importFns.exportDXF;
 exports.exportGlb = require_importFns.exportGlb;

package/dist/io.js

@@ -1,3 +1,3 @@
 import { n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-Bo4EQJFO.js";
-import { a as exportSTEPConfigured, c as exportThreeMF, d as exportGlb, f as exportGltf, l as blueprintToDXF, n as importSTEP, o as importSVG, p as exportOBJ, r as importSTL, s as importSVGPathD, t as importIGES, u as exportDXF } from "./importFns-C8yUNPzJ.js";
+import { a as exportSTEPConfigured, c as exportThreeMF, d as exportGlb, f as exportGltf, l as blueprintToDXF, n as importSTEP, o as importSVG, p as exportOBJ, r as importSTL, s as importSVGPathD, t as importIGES, u as exportDXF } from "./importFns-TKzj4FaZ.js";
 export { blueprintToDXF, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, importIGES, importSTEP, importSTL, importSVG, importSVGPathD };

package/dist/{measureFns-D3egqKcW.js → measureFns--UKrACtx.js}

@@ -30,6 +30,8 @@ function nullShapeErr(fn) {
 * Run `fn` on fresh handles to the distinct sub-shapes of `type`, releasing them
 * afterwards. Unlike getFaces and friends this leaves the shape's topology cache
 * alone, so a measurement allocates nothing that outlives it.
+*
+* @internal
 */
 function withSubShapes(shape, type, fn) {
 	const kernel = getKernel();
@@ -40,7 +42,11 @@ function withSubShapes(shape, type, fn) {
 		for (const item of items) kernel.dispose(item);
 	}
 }
-/** Run `fn` on a throwaway compound of `parts`, releasing the compound afterwards. */
+/**
+* Run `fn` on a throwaway compound of `parts`, releasing the compound afterwards.
+*
+* @internal
+*/
 function withCompoundOf(parts, fn) {
 	const kernel = getKernel();
 	const c = kernel.makeCompound(parts);
@@ -141,9 +147,9 @@ function measureSurfaceProps(shape) {
 /**
 * Measure linear properties of any shape.
 *
-* For edges this is the arc length; for wires and faces it is the total length
-* of their edges; for shells, solids, and compounds it is the total length of
-* their distinct edges, each counted once.
+* For edges this is the arc length; for wires it is the total length of their
+* edges; for faces, shells, solids, and compounds it is the total length of
+* their distinct edges, each counted once (a face's seam edge included).
 *
 * @param shape - Any shape whose linear extent is to be measured.
 * @returns `Result` containing length, center of mass, and raw mass property.
@@ -164,7 +170,7 @@ function measureLinearProps(shape) {
 		};
 	};
 	let result;
-	if (type === "vertex" || type === "edge" || type === "wire" || type === "face") result = linearOf(shape.wrapped);
+	if (type === "vertex" || type === "edge" || type === "wire") result = linearOf(shape.wrapped);
 	else result = withSubShapes(shape, "edge", (edges) => edges.length === 0 ? {
 		mass: 0,
 		length: 0,
@@ -289,4 +295,4 @@ function measureCurvatureAtMid(face) {
 		minDirection: result.minDirection
 	});
 }
-export { measureDistance as a, measureLinearProps as c, measureVolumeProps as d, getCachedMeasurement as f, measureCurvatureAtMid as i, measureSurfaceProps as l, measureArea as n, measureDistanceProps as o, setCachedMeasurement as p, measureCurvatureAt as r, measureLength as s, createDistanceQuery as t, measureVolume as u };
+export { measureDistance as a, measureLinearProps as c, measureVolumeProps as d, withCompoundOf as f, setCachedMeasurement as h, measureCurvatureAtMid as i, measureSurfaceProps as l, getCachedMeasurement as m, measureArea as n, measureDistanceProps as o, withSubShapes as p, measureCurvatureAt as r, measureLength as s, createDistanceQuery as t, measureVolume as u };

package/dist/{measureFns-R85865k9.cjs → measureFns-D8uSDn-8.cjs}

@@ -30,6 +30,8 @@ function nullShapeErr(fn) {
 * Run `fn` on fresh handles to the distinct sub-shapes of `type`, releasing them
 * afterwards. Unlike getFaces and friends this leaves the shape's topology cache
 * alone, so a measurement allocates nothing that outlives it.
+*
+* @internal
 */
 function withSubShapes(shape, type, fn) {
 	const kernel = require_shapeTypes.getKernel();
@@ -40,7 +42,11 @@ function withSubShapes(shape, type, fn) {
 		for (const item of items) kernel.dispose(item);
 	}
 }
-/** Run `fn` on a throwaway compound of `parts`, releasing the compound afterwards. */
+/**
+* Run `fn` on a throwaway compound of `parts`, releasing the compound afterwards.
+*
+* @internal
+*/
 function withCompoundOf(parts, fn) {
 	const kernel = require_shapeTypes.getKernel();
 	const c = kernel.makeCompound(parts);
@@ -141,9 +147,9 @@ function measureSurfaceProps(shape) {
 /**
 * Measure linear properties of any shape.
 *
-* For edges this is the arc length; for wires and faces it is the total length
-* of their edges; for shells, solids, and compounds it is the total length of
-* their distinct edges, each counted once.
+* For edges this is the arc length; for wires it is the total length of their
+* edges; for faces, shells, solids, and compounds it is the total length of
+* their distinct edges, each counted once (a face's seam edge included).
 *
 * @param shape - Any shape whose linear extent is to be measured.
 * @returns `Result` containing length, center of mass, and raw mass property.
@@ -164,7 +170,7 @@ function measureLinearProps(shape) {
 		};
 	};
 	let result;
-	if (type === "vertex" || type === "edge" || type === "wire" || type === "face") result = linearOf(shape.wrapped);
+	if (type === "vertex" || type === "edge" || type === "wire") result = linearOf(shape.wrapped);
 	else result = withSubShapes(shape, "edge", (edges) => edges.length === 0 ? {
 		mass: 0,
 		length: 0,
@@ -367,3 +373,15 @@ Object.defineProperty(exports, "setCachedMeasurement", {
 		return setCachedMeasurement;
 	}
 });
+Object.defineProperty(exports, "withCompoundOf", {
+	enumerable: true,
+	get: function() {
+		return withCompoundOf;
+	}
+});
+Object.defineProperty(exports, "withSubShapes", {
+	enumerable: true,
+	get: function() {
+		return withSubShapes;
+	}
+});

package/dist/measurement/measureFns.d.ts

@@ -1,8 +1,23 @@
+import { KernelShape, ShapeType } from '../kernel/types.js';
 import { AnyShape, Dimension, Face, OrientedFace, Shape3D } from '../core/shapeTypes.js';
 import { Result } from '../core/result.js';
 import { CurvatureResult } from '../kernel/occt/measureOps.js';
 import { PhysicalProps, VolumeProps, SurfaceProps, LinearProps, DistanceProps } from './measureTypes.js';
 export type { PhysicalProps, VolumeProps, SurfaceProps, LinearProps, DistanceProps };
+/**
+ * Run `fn` on fresh handles to the distinct sub-shapes of `type`, releasing them
+ * afterwards. Unlike getFaces and friends this leaves the shape's topology cache
+ * alone, so a measurement allocates nothing that outlives it.
+ *
+ * @internal
+ */
+export declare function withSubShapes<R>(shape: AnyShape<Dimension>, type: ShapeType, fn: (items: KernelShape[]) => R): R;
+/**
+ * Run `fn` on a throwaway compound of `parts`, releasing the compound afterwards.
+ *
+ * @internal
+ */
+export declare function withCompoundOf<R>(parts: KernelShape[], fn: (c: KernelShape) => R): R;
 /**
  * Measure volume properties of a 3D shape.
  *
@@ -22,9 +37,9 @@ export declare function measureSurfaceProps(shape: Face<Dimension> | Shape3D): R
 /**
  * Measure linear properties of any shape.
  *
- * For edges this is the arc length; for wires and faces it is the total length
- * of their edges; for shells, solids, and compounds it is the total length of
- * their distinct edges, each counted once.
+ * For edges this is the arc length; for wires it is the total length of their
+ * edges; for faces, shells, solids, and compounds it is the total length of
+ * their distinct edges, each counted once (a face's seam edge included).
  *
  * @param shape - Any shape whose linear extent is to be measured.
  * @returns `Result` containing length, center of mass, and raw mass property.

package/dist/measurement/principalBoxFns.d.ts

@@ -16,7 +16,8 @@ export type { PrincipalBoundingBox };
  * Z reports 136.6 x 136.6 x 2, because any in-plane pair of axes is principal
  * for a square plate.
  *
- * @param shape - A solid, compsolid, or compound containing solids.
+ * @param shape - A solid, compsolid, or compound containing solids. A compound
+ *   is measured by its solids alone: loose faces, shells, or wires in it are ignored.
  * @returns `Result` with the box center in world coordinates, orthonormal
  *   right-handed axes ordered by decreasing extent, and the full edge lengths
  *   along those axes. Fails with `NOT_A_SOLID` for any other shape type

package/dist/measurement.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_measureFns = require("./measureFns-R85865k9.cjs");
-const require_principalBoxFns = require("./principalBoxFns-DepJW5im.cjs");
+const require_measureFns = require("./measureFns-D8uSDn-8.cjs");
+const require_principalBoxFns = require("./principalBoxFns-Cozj46sS.cjs");
 exports.createDistanceQuery = require_measureFns.createDistanceQuery;
 exports.measureArea = require_measureFns.measureArea;
 exports.measureDistance = require_measureFns.measureDistance;

package/dist/measurement.js

@@ -1,3 +1,3 @@
-import { a as measureDistance, c as measureLinearProps, d as measureVolumeProps, l as measureSurfaceProps, n as measureArea, o as measureDistanceProps, s as measureLength, t as createDistanceQuery, u as measureVolume } from "./measureFns-D3egqKcW.js";
-import { t as principalBoundingBox } from "./principalBoxFns-BgetPvvQ.js";
+import { a as measureDistance, c as measureLinearProps, d as measureVolumeProps, l as measureSurfaceProps, n as measureArea, o as measureDistanceProps, s as measureLength, t as createDistanceQuery, u as measureVolume } from "./measureFns--UKrACtx.js";
+import { t as principalBoundingBox } from "./principalBoxFns-C3SQMyG5.js";
 export { createDistanceQuery, measureArea, measureDistance, measureDistanceProps, measureLength, measureLinearProps, measureSurfaceProps, measureVolume, measureVolumeProps, principalBoundingBox };

package/dist/operations.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_threadFns = require("./threadFns-DNFoBBrH.cjs");
+const require_threadFns = require("./threadFns-Dq_Gff0C.cjs");
 const require_loftFns = require("./loftFns-CnerVgTM.cjs");
 exports.addChild = require_threadFns.addChild;
 exports.addJoint = require_threadFns.addJoint;

package/dist/operations.js

@@ -1,3 +1,3 @@
-import { A as setJointValue, B as walkAssembly, C as cylindricalJoint, D as planarJoint, E as mechanismDOF, F as countNodes, H as circularPattern, I as createAssemblyNode, L as findNode, M as sphericalJoint, N as addChild, O as prismaticJoint, P as collectShapes, R as removeChild, S as addJoint, T as jointTransform, U as gridPattern, V as exportAssemblySTEP, W as linearPattern, Y as createAssembly, _ as exportURDF, b as inverseKinematics, c as modifyStep, d as replayFrom, f as replayHistory, g as undoLast, h as stepsFrom, i as createRegistry, j as setJointValues, k as revoluteJoint, l as registerOperation, m as stepCount, n as addStep, o as findStep, r as createHistory, s as getShape, t as thread, u as registerShape, v as importURDF, w as forwardKinematics, x as jointTrajectory, y as jointsFromDH, z as updateNode } from "./threadFns-CEr8JDsu.js";
+import { A as setJointValue, B as walkAssembly, C as cylindricalJoint, D as planarJoint, E as mechanismDOF, F as countNodes, H as circularPattern, I as createAssemblyNode, L as findNode, M as sphericalJoint, N as addChild, O as prismaticJoint, P as collectShapes, R as removeChild, S as addJoint, T as jointTransform, U as gridPattern, V as exportAssemblySTEP, W as linearPattern, Y as createAssembly, _ as exportURDF, b as inverseKinematics, c as modifyStep, d as replayFrom, f as replayHistory, g as undoLast, h as stepsFrom, i as createRegistry, j as setJointValues, k as revoluteJoint, l as registerOperation, m as stepCount, n as addStep, o as findStep, r as createHistory, s as getShape, t as thread, u as registerShape, v as importURDF, w as forwardKinematics, x as jointTrajectory, y as jointsFromDH, z as updateNode } from "./threadFns-D7D_qR7t.js";
 import { c as twistExtrude, o as supportExtrude, r as complexExtrude, s as sweep } from "./loftFns-jnQL_zpD.js";
 export { addChild, addJoint, addStep, circularPattern, collectShapes, complexExtrude, countNodes, createAssembly, createAssemblyNode, createHistory, createRegistry, cylindricalJoint, exportAssemblySTEP, exportURDF, findNode, findStep, forwardKinematics, getShape as getHistoryShape, gridPattern, importURDF, inverseKinematics, jointTrajectory, jointTransform, jointsFromDH, linearPattern, mechanismDOF, modifyStep, planarJoint, prismaticJoint, registerOperation, registerShape, removeChild, replayFrom, replayHistory, revoluteJoint, setJointValue, setJointValues, sphericalJoint, stepCount, stepsFrom, supportExtrude, sweep, thread, twistExtrude, undoLast, updateNode, walkAssembly };

package/dist/{primitiveFns-eiM6OjWU.cjs → primitiveFns-CZqSRhm8.cjs}

@@ -4,7 +4,7 @@ const require_validityTypes = require("./validityTypes-lfyOkCQm.cjs");
 const require_constants = require("./constants-oee0S_x6.cjs");
 const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
 const require_solidBuilders = require("./solidBuilders-Dwm0hXn5.cjs");
-const require_booleanFns = require("./booleanFns-D0qfjH0a.cjs");
+const require_booleanFns = require("./booleanFns-CkcJ8WB7.cjs");
 const require_surfaceBuilders = require("./surfaceBuilders-D5kFAV1i.cjs");
 // src/topology/transformFns.ts
 /**

package/dist/{primitiveFns-NxbTqKy7.js → primitiveFns-DPqHA3sX.js}

@@ -4,7 +4,7 @@ import { n as isClosedWire } from "./validityTypes-CGrEOscY.js";
 import { n as HASH_CODE_MAX, t as DEG2RAD } from "./constants-iraOnb2p.js";
 import { d as vecNormalize, h as vecScale } from "./vecOps-S-m9H_fe.js";
 import { a as makeOffset, c as makeTorus, i as makeEllipsoid, l as makeVertex, n as makeCone, o as makeSolid, r as makeCylinder, s as makeSphere, t as makeCompound, u as weldShellsAndFaces } from "./solidBuilders-ZDGdvaTU.js";
-import { d as collectInputFaceHashes, f as hasAnyMetadata, h as propagateMetadataThroughRelocation, m as propagateMetadataByHash, p as propagateAllMetadata } from "./booleanFns-BwzBRGqj.js";
+import { f as collectInputFaceHashes, g as propagateMetadataThroughRelocation, h as propagateMetadataByHash, m as propagateAllMetadata, p as hasAnyMetadata } from "./booleanFns-B9RvEpHB.js";
 import { _ as makeThreePointArc, a as makeNonPlanarFace, c as makeBSplineApproximation, d as makeCircle, f as makeEllipse, g as makeTangentArc, h as makeLine, i as makeNewFaceWithinFace, m as makeHelix, o as makePolygon, p as makeEllipseArc, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeBezierCurve } from "./surfaceBuilders-BBs6D6Km.js";
 // src/topology/transformFns.ts
 /**