brepjs 20.12.2 → 20.12.5

package/dist/{helpers-DxoCOnD_.cjs → helpers-C4f2MV-r.cjs}

@@ -1,12 +1,12 @@
-const require_shapeTypes = require("./shapeTypes-HDVHzNk1.cjs");
+const require_shapeTypes = require("./shapeTypes-D938X2mg.cjs");
 const require_errors = require("./errors-O_blYTWT.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-gyva7bvF.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-4WYqtSFF.cjs");
 const require_constants = require("./constants-oee0S_x6.cjs");
 const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
-const require_faceFns = require("./faceFns-C6fYNgZl.cjs");
-const require_shapeFns = require("./shapeFns-CHFmX5HQ.cjs");
-const require_curveFns = require("./curveFns-CMiP40Ko.cjs");
-const require_measureFns = require("./measureFns-Ed7LXAhG.cjs");
+const require_faceFns = require("./faceFns-Cx7cwUMx.cjs");
+const require_shapeFns = require("./shapeFns-CwjjUOr0.cjs");
+const require_curveFns = require("./curveFns-BKT4Sg8q.cjs");
+const require_measureFns = require("./measureFns-CuabRDRL.cjs");
 // src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;
@@ -216,11 +216,15 @@ function resolveDir(dir) {
 * with a vertex constructed at the reference point.
 */
 function distanceFromPointFilter(distance, point, tolerance) {
-	const kernel = require_shapeTypes.getKernel();
-	const vtx = kernel.makeVertex(point[0], point[1], point[2]);
 	return (element) => {
-		const d = kernel.distance(vtx, element.wrapped).value;
-		return Math.abs(d - distance) < tolerance;
+		const kernel = require_shapeTypes.getKernel();
+		const vtx = kernel.makeVertex(point[0], point[1], point[2]);
+		try {
+			const d = kernel.distance(vtx, element.wrapped).value;
+			return Math.abs(d - distance) < tolerance;
+		} finally {
+			kernel.dispose(vtx);
+		}
 	};
 }
 // src/query/shapeFinders.ts

package/dist/{helpers-i26hsY3T.js → helpers-CNgipe6l.js}

@@ -1,12 +1,12 @@
-import { q as getKernel, y as isFace } from "./shapeTypes-Db3yAgTO.js";
+import { q as getKernel, y as isFace } from "./shapeTypes-PNVEv6ga.js";
 import { E as ok, g as err, o as queryError, x as isOk } from "./errors-BTccWbtE.js";
-import { c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-DKNVBMuN.js";
+import { c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-BZUY10TD.js";
 import { t as DEG2RAD } from "./constants-iraOnb2p.js";
 import { a as vecDot, d as vecNormalize } from "./vecOps-S-m9H_fe.js";
-import { l as normalAt, s as getSurfaceType } from "./faceFns-DEDlLMcn.js";
-import { a as isSameShape, n as getHashCode } from "./shapeFns-D7DcPxfx.js";
-import { f as getCurveType, i as curveIsClosed, o as curveLength } from "./curveFns-AMqd_WaO.js";
-import { n as measureArea } from "./measureFns-BuxKO1GV.js";
+import { l as normalAt, s as getSurfaceType } from "./faceFns-lE2OvBfq.js";
+import { a as isSameShape, n as getHashCode } from "./shapeFns-CdrDroOM.js";
+import { f as getCurveType, i as curveIsClosed, o as curveLength } from "./curveFns-BGPSFUWB.js";
+import { n as measureArea } from "./measureFns-C94G0fH8.js";
 // src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;
@@ -216,11 +216,15 @@ function resolveDir(dir) {
 * with a vertex constructed at the reference point.
 */
 function distanceFromPointFilter(distance, point, tolerance) {
-	const kernel = getKernel();
-	const vtx = kernel.makeVertex(point[0], point[1], point[2]);
 	return (element) => {
-		const d = kernel.distance(vtx, element.wrapped).value;
-		return Math.abs(d - distance) < tolerance;
+		const kernel = getKernel();
+		const vtx = kernel.makeVertex(point[0], point[1], point[2]);
+		try {
+			const d = kernel.distance(vtx, element.wrapped).value;
+			return Math.abs(d - distance) < tolerance;
+		} finally {
+			kernel.dispose(vtx);
+		}
 	};
 }
 // src/query/shapeFinders.ts

package/dist/{importFns-Fr6WPpl2.cjs → importFns-fIdcaMqt.cjs}

@@ -1,8 +1,8 @@
-const require_shapeTypes = require("./shapeTypes-HDVHzNk1.cjs");
+const require_shapeTypes = require("./shapeTypes-D938X2mg.cjs");
 const require_bug = require("./bug-CBcpIPuf.cjs");
 const require_errors = require("./errors-O_blYTWT.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
-const require_blueprint = require("./blueprint-p1SmFAfl.cjs");
+const require_blueprint = require("./blueprint-ERmwk6zG.cjs");
 // src/io/objExportFns.ts
 /** Read a vec3 from a typed array at the given vertex index. */
 function vec3At(arr, i) {

package/dist/{importFns-Bz4sXl93.js → importFns-gB1X3ti2.js}

@@ -1,8 +1,8 @@
-import { n as castResultShape, q as getKernel } from "./shapeTypes-Db3yAgTO.js";
+import { n as castResultShape, q as getKernel } from "./shapeTypes-PNVEv6ga.js";
 import { i as wasmIndex, r as vec3At$1 } from "./bug-ClMTAJhe.js";
 import { E as ok, g as err, r as ioError, t as BrepErrorCode } from "./errors-BTccWbtE.js";
 import { n as getAtOrThrow } from "./arrayAccess-BpgouNir.js";
-import { c as make2dBezierCurve, h as make2dThreePointArc, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-CLgJoNt5.js";
+import { c as make2dBezierCurve, h as make2dThreePointArc, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-Zmt5-07y.js";
 // src/io/objExportFns.ts
 /** Read a vec3 from a typed array at the given vertex index. */
 function vec3At(arr, i) {

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { currentQuality } from './kernel/quality.js';
 export type { QualityLevel } from './kernel/quality.js';
 export { EXACT_BREP_CAPABILITIES, DEFAULT_CAPABILITIES } from './kernel/capabilities.js';
 export type { KernelCapabilities, TessellationModel } from './kernel/capabilities.js';
-export type { KernelAdapter, BrepkitHandle, OcctWasmHandle, OcctWasmModule, OcctKernelWasm, SurfaceType, ShapeOrientation, ShapeType, KernelBooleanOps, KernelBuilderOps, KernelCore, KernelCurveOps, KernelEvolutionOps, KernelIOOps, KernelMeasureOps, KernelMeshOps, KernelModifierOps, KernelPrimitiveOps, KernelRepairOps, KernelSurfaceOps, KernelSweepOps, KernelTopologyOps, KernelTransformOps, } from './kernel/index.js';
+export type { KernelAdapter, BrepkitHandle, OcctWasmHandle, OcctWasmModule, OcctKernelWasm, SurfaceType as KernelSurfaceType, ShapeOrientation, ShapeType, KernelBooleanOps, KernelBuilderOps, KernelCore, KernelCurveOps, KernelEvolutionOps, KernelIOOps, KernelMeasureOps, KernelMeshOps, KernelModifierOps, KernelPrimitiveOps, KernelRepairOps, KernelSurfaceOps, KernelSweepOps, KernelTopologyOps, KernelTransformOps, } from './kernel/index.js';
 export { supportsProjection, supportsConstraintSketch } from './kernel/index.js';
 export type { ProjectionCapability, ConstraintSketchCapability } from './kernel/index.js';
 export { getPerformanceStats, resetPerformanceStats } from './kernel/index.js';
@@ -93,7 +93,7 @@ export { facesOfEdge, edgesOfFace, wiresOfFace, verticesOfEdge, verticesOfFace,
 export { getCurveType, curveStartPoint, curveEndPoint, curvePointAt, curveTangentAt, curveAxis, curveLength, curveIsClosed, curveIsPeriodic, curvePeriod, getOrientation, flipOrientation, offsetWire2D, interpolateCurve, approximateCurve, type InterpolateCurveOptions, type ApproximateCurveOptions, } from './topology/curveFns.js';
 export { getNurbsCurveData, getNurbsSurfaceData } from './topology/nurbsFns.js';
 export type { NurbsCurveData, NurbsSurfaceData } from './kernel/types.js';
-export { getSurfaceType, faceGeomType, faceOrientation, flipFaceOrientation, uvBounds, pointOnSurface, uvCoordinates, normalAt, faceCenter, faceAxis, classifyPointOnFace, outerWire, innerWires, removeHolesFromFace, projectPointOnFace, type UVBounds, type PointProjectionResult, } from './topology/faceFns.js';
+export { getSurfaceType, faceGeomType, faceOrientation, flipFaceOrientation, uvBounds, pointOnSurface, uvCoordinates, normalAt, faceCenter, faceAxis, classifyPointOnFace, outerWire, innerWires, removeHolesFromFace, projectPointOnFace, type SurfaceType, type UVBounds, type PointProjectionResult, } from './topology/faceFns.js';
 export { exportSTEP, exportSTL, exportIGES, meshMultiLOD, meshLODs, meshLODsProgressive, type ShapeMesh, type EdgeMesh, type MeshOptions, type MultiLODMesh, type LODMesh, type MeshLODsOptions, type MeshLODsProgressiveOptions, type MeshLevelFn, } from './topology/meshFns.js';
 export { clearMeshCache, createMeshCache, type MeshCacheContext } from './topology/meshCache.js';
 export { toBufferGeometryData, toLineGeometryData, toGroupedBufferGeometryData, type BufferGeometryData, type LineGeometryData, type GroupedBufferGeometryData, type BufferGeometryGroup, toLODGeometryData, type LODGeometryData, toLODGeometryLevels, type LODGeometryLevel, } from './topology/threeHelpers.js';

package/dist/io.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_meshFns = require("./meshFns-BNrdUhgG.cjs");
-const require_importFns = require("./importFns-Fr6WPpl2.cjs");
+const require_meshFns = require("./meshFns-GXF5gPZL.cjs");
+const require_importFns = require("./importFns-fIdcaMqt.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-LytwBtBQ.js";
-import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-Bz4sXl93.js";
+import { n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-jarDZKw1.js";
+import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-gB1X3ti2.js";
 export { blueprintToDXF, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, importIGES, importSTEP, importSTL, importSVG, importSVGPathD };

package/dist/kernel/geometry2d.d.ts

@@ -89,6 +89,13 @@ export declare function intersectCurves2dFn(c1: Curve2dObj, c2: Curve2dObj, tole
     points: [number, number][];
     segments: Curve2dObj[];
 };
+/**
+ * Gauss-Newton the foot point of (px, py) on c from a sampled start parameter, staying
+ * within [from, to] (either order). A sampling grid alone leaves the point up to
+ * ~r*pi/N off an arc, while intersection and split callers treat a point as on the
+ * curve only within ~1e-8, so an unrefined sample rejects nearly every real crossing.
+ */
+export declare function refineFootPoint(c: Curve2dObj, px: number, py: number, start: number, from: number, to: number): number;
 export declare function serializeCurve2d(c: Curve2dObj): string;
 export declare function deserializeCurve2d(data: string): Curve2dObj;
 export declare function createBBox2d(): BBox2d;

package/dist/kernel/occtWasm/constructionOps.d.ts

@@ -14,7 +14,7 @@ export declare function makeEllipseEdge(k: OcctKernelWasm, center: Vec3, normal:
 export declare function makeEllipseArc(k: OcctKernelWasm, center: Vec3, normal: Vec3, majorRadius: number, minorRadius: number, startAngle: number, endAngle: number, xDir?: Vec3): KernelShape;
 export declare function makeBezierEdge(k: OcctKernelWasm, Module: OcctWasmModule, points: [number, number, number][]): KernelShape;
 export declare function makeTangentArc(k: OcctKernelWasm, startPoint: [number, number, number], startTangent: [number, number, number], endPoint: [number, number, number]): KernelShape;
-export declare function makeHelixWire(k: OcctKernelWasm, pitch: number, height: number, radius: number, center?: [number, number, number], direction?: [number, number, number]): KernelShape;
+export declare function makeHelixWire(k: OcctKernelWasm, pitch: number, height: number, radius: number, center?: [number, number, number], direction?: [number, number, number], leftHanded?: boolean): KernelShape;
 export declare function makeCompound(k: OcctKernelWasm, Module: OcctWasmModule, shapes: KernelShape[]): KernelShape;
 export declare function solidFromShell(k: OcctKernelWasm, shell: KernelShape): KernelShape;
 export declare function buildSolidFromFaces(k: OcctKernelWasm, Module: OcctWasmModule, points: Array<{

package/dist/kernel/occtWasm/occtWasmAdapter.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_occtWasmAdapter = require("../../occtWasmAdapter-D1EXktNq.cjs");
+const require_occtWasmAdapter = require("../../occtWasmAdapter-DeoeK2iJ.cjs");
 exports.OcctWasmAdapter = require_occtWasmAdapter.OcctWasmAdapter;

package/dist/kernel/occtWasm/occtWasmAdapter.d.ts

@@ -96,7 +96,7 @@ export declare class OcctWasmAdapter implements KernelAdapter {
     makeEllipseArc(center: [number, number, number], normal: [number, number, number], majorRadius: number, minorRadius: number, startAngle: number, endAngle: number, xDir?: [number, number, number]): KernelShape;
     makeBezierEdge(points: [number, number, number][]): KernelShape;
     makeTangentArc(startPoint: [number, number, number], startTangent: [number, number, number], endPoint: [number, number, number]): KernelShape;
-    makeHelixWire(pitch: number, height: number, radius: number, center?: [number, number, number], direction?: [number, number, number], _leftHanded?: boolean): KernelShape;
+    makeHelixWire(pitch: number, height: number, radius: number, center?: [number, number, number], direction?: [number, number, number], leftHanded?: boolean): KernelShape;
     makeWireFromMixed(items: KernelShape[]): KernelShape;
     makeCompound(shapes: KernelShape[]): KernelShape;
     solidFromShell(shell: KernelShape): KernelShape;

package/dist/kernel/occtWasm/occtWasmAdapter.js

@@ -1 +1 @@
-export { t as OcctWasmAdapter } from "../../occtWasmAdapter-RBm-JLoN.js";
+export { t as OcctWasmAdapter } from "../../occtWasmAdapter-DlNmVNUn.js";

package/dist/kernel/occtWasm/occtWasmTypes.d.ts

@@ -172,6 +172,11 @@ export interface OcctKernelWasm {
     makeBezierEdge(flatPoints: EmVectorDouble): number;
     makeTangentArc(x1: number, y1: number, z1: number, tx: number, ty: number, tz: number, x2: number, y2: number, z2: number): number;
     makeHelixWire(px: number, py: number, pz: number, dx: number, dy: number, dz: number, pitch: number, height: number, radius: number): number;
+    /**
+     * {@link makeHelixWire} with an explicit winding. Optional: absent on WASM
+     * builds older than occt-wasm 4.3.0, so callers must feature-detect it.
+     */
+    makeHelixWireHanded?(px: number, py: number, pz: number, dx: number, dy: number, dz: number, pitch: number, height: number, radius: number, leftHanded: boolean): number;
     makeWire(edgeIds: EmVectorUint32): number;
     makeFace(wireId: number): number;
     makeNonPlanarFace(wireId: number): number;

package/dist/{loftFns-BsFinbgs.cjs → loftFns-AHaYxJyS.cjs}

@@ -1,4 +1,4 @@
-const require_shapeTypes = require("./shapeTypes-HDVHzNk1.cjs");
+const require_shapeTypes = require("./shapeTypes-D938X2mg.cjs");
 const require_errors = require("./errors-O_blYTWT.cjs");
 const require_types = require("./types-CjF9Rofr.cjs");
 const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
@@ -40,6 +40,14 @@ function makeSpineWire(start, end) {
 	kernel.dispose(edge);
 	return require_shapeTypes.castResultShape(wire);
 }
+/** A planar face bounded by `wire`, or `null` when the wire does not span one. */
+function planarFaceOf(wire) {
+	try {
+		return require_shapeTypes.getKernel().makeFace(wire.wrapped, true);
+	} catch {
+		return null;
+	}
+}
 /** Build a helix wire for twist extrusion. */
 function makeHelixWire(pitch, height, radius, center, dir, leftHanded = false) {
 	const kernel = require_shapeTypes.getKernel();
@@ -87,7 +95,14 @@ function castSweepShellTuple(result) {
 */
 function sweep(wire, spine, config = {}, shellMode = false) {
 	if (config.mode === "simple" && !shellMode) {
-		const resultOc = require_shapeTypes.getKernel().simplePipe(wire.wrapped, spine.wrapped);
+		const kernel = require_shapeTypes.getKernel();
+		const profileFace = planarFaceOf(wire);
+		let resultOc;
+		try {
+			resultOc = kernel.simplePipe(profileFace ?? wire.wrapped, spine.wrapped);
+		} finally {
+			if (profileFace) kernel.dispose(profileFace);
+		}
 		const shape = require_shapeTypes.castResultShape(resultOc);
 		if (!require_shapeTypes.isShape3D(shape)) {
 			require_shapeTypes.disposeResultShape(shape);

package/dist/{loftFns-pMh0ET-J.js → loftFns-mbyBvJ8Y.js}

@@ -1,4 +1,4 @@
-import { G as _usingCtx, T as isWire, h as disposeResultShape, n as castResultShape, q as getKernel, x as isShape3D } from "./shapeTypes-Db3yAgTO.js";
+import { G as _usingCtx, T as isWire, h as disposeResultShape, n as castResultShape, q as getKernel, x as isShape3D } from "./shapeTypes-PNVEv6ga.js";
 import { E as ok, b as isErr, d as validationError, g as err, i as kernelError, l as typeCastError, t as BrepErrorCode } from "./errors-BTccWbtE.js";
 import { r as toVec3 } from "./types-CKXsIm9-.js";
 import { c as vecLength, t as vecAdd } from "./vecOps-S-m9H_fe.js";
@@ -40,6 +40,14 @@ function makeSpineWire(start, end) {
 	kernel.dispose(edge);
 	return castResultShape(wire);
 }
+/** A planar face bounded by `wire`, or `null` when the wire does not span one. */
+function planarFaceOf(wire) {
+	try {
+		return getKernel().makeFace(wire.wrapped, true);
+	} catch {
+		return null;
+	}
+}
 /** Build a helix wire for twist extrusion. */
 function makeHelixWire(pitch, height, radius, center, dir, leftHanded = false) {
 	const kernel = getKernel();
@@ -87,7 +95,14 @@ function castSweepShellTuple(result) {
 */
 function sweep(wire, spine, config = {}, shellMode = false) {
 	if (config.mode === "simple" && !shellMode) {
-		const resultOc = getKernel().simplePipe(wire.wrapped, spine.wrapped);
+		const kernel = getKernel();
+		const profileFace = planarFaceOf(wire);
+		let resultOc;
+		try {
+			resultOc = kernel.simplePipe(profileFace ?? wire.wrapped, spine.wrapped);
+		} finally {
+			if (profileFace) kernel.dispose(profileFace);
+		}
 		const shape = castResultShape(resultOc);
 		if (!isShape3D(shape)) {
 			disposeResultShape(shape);

package/dist/{measureFns-BuxKO1GV.js → measureFns-C94G0fH8.js}

@@ -1,7 +1,7 @@
-import { q as getKernel } from "./shapeTypes-Db3yAgTO.js";
+import { q as getKernel } from "./shapeTypes-PNVEv6ga.js";
 import { E as ok, d as validationError, g as err, t as BrepErrorCode } from "./errors-BTccWbtE.js";
-import { E as kernelCallRaw } from "./topologyQueryFns-DKNVBMuN.js";
-import { m as uvBounds } from "./faceFns-DEDlLMcn.js";
+import { E as kernelCallRaw } from "./topologyQueryFns-BZUY10TD.js";
+import { m as uvBounds } from "./faceFns-lE2OvBfq.js";
 // src/measurement/measureCache.ts
 var cache = /* @__PURE__ */ new WeakMap();
 function getCachedMeasurement(shape, key) {
@@ -27,6 +27,66 @@ function nullShapeErr(fn) {
 	return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, `${fn}: shape is a null shape`));
 }
 /**
+* 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.
+*/
+function withSubShapes(shape, type, fn) {
+	const kernel = getKernel();
+	const items = kernel.iterShapes(shape.wrapped, type);
+	try {
+		return fn(items);
+	} finally {
+		for (const item of items) kernel.dispose(item);
+	}
+}
+/** Run `fn` on a throwaway compound of `parts`, releasing the compound afterwards. */
+function withCompoundOf(parts, fn) {
+	const kernel = getKernel();
+	const c = kernel.makeCompound(parts);
+	try {
+		return fn(c);
+	} finally {
+		kernel.dispose(c);
+	}
+}
+function volumeOf(target) {
+	const kernel = getKernel();
+	const m = kernel.volume(target);
+	const comResult = kernelCallRaw(() => kernel.centerOfMass(target), BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
+	if (!comResult.ok) return comResult;
+	return ok({
+		mass: m,
+		volume: m,
+		centerOfMass: comResult.value
+	});
+}
+/** Area-weighted centroid of `faces`, from each face's own surface center of mass. */
+function surfaceCentroid(faces) {
+	const kernel = getKernel();
+	let total = 0;
+	let x = 0;
+	let y = 0;
+	let z = 0;
+	for (const f of faces) {
+		const a = kernel.area(f);
+		const [cx, cy, cz] = kernel.surfaceCenterOfMass(f);
+		total += a;
+		x += a * cx;
+		y += a * cy;
+		z += a * cz;
+	}
+	return total > 0 ? [
+		x / total,
+		y / total,
+		z / total
+	] : [
+		0,
+		0,
+		0
+	];
+}
+/**
 * Measure volume properties of a 3D shape.
 *
 * @param shape - A solid or compound shape.
@@ -37,31 +97,23 @@ function measureVolumeProps(shape) {
 	const cached = getCachedMeasurement(shape.wrapped, "volume");
 	if (cached) return ok(cached);
 	if (shapeIsNull(shape)) return nullShapeErr("measureVolumeProps");
-	const kernel = getKernel();
-	const type = kernel.shapeType(shape.wrapped);
-	if (type !== "solid" && type !== "compsolid" && type !== "compound") {
-		const zero = {
-			mass: 0,
-			volume: 0,
-			centerOfMass: [
-				0,
-				0,
-				0
-			]
-		};
-		setCachedMeasurement(shape.wrapped, "volume", zero);
-		return ok(zero);
-	}
-	const m = kernel.volume(shape.wrapped);
-	const comResult = kernelCallRaw(() => kernel.centerOfMass(shape.wrapped), BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
-	if (!comResult.ok) return comResult;
-	const result = {
-		mass: m,
-		volume: m,
-		centerOfMass: comResult.value
+	const type = getKernel().shapeType(shape.wrapped);
+	const zero = {
+		mass: 0,
+		volume: 0,
+		centerOfMass: [
+			0,
+			0,
+			0
+		]
 	};
-	setCachedMeasurement(shape.wrapped, "volume", result);
-	return ok(result);
+	let result;
+	if (type === "solid" || type === "compsolid") result = volumeOf(shape.wrapped);
+	else if (type === "compound") result = withSubShapes(shape, "solid", (solids) => solids.length === 0 ? ok(zero) : withCompoundOf(solids, volumeOf));
+	else result = ok(zero);
+	if (!result.ok) return result;
+	setCachedMeasurement(shape.wrapped, "volume", result.value);
+	return result;
 }
 /**
 * Measure surface properties of a face or 3D shape.
@@ -76,7 +128,7 @@ function measureSurfaceProps(shape) {
 	if (shapeIsNull(shape)) return nullShapeErr("measureSurfaceProps");
 	const kernel = getKernel();
 	const m = kernel.area(shape.wrapped);
-	const comResult = kernelCallRaw(() => kernel.centerOfMass(shape.wrapped), BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
+	const comResult = kernelCallRaw(() => kernel.shapeType(shape.wrapped) === "face" ? kernel.surfaceCenterOfMass(shape.wrapped) : withSubShapes(shape, "face", surfaceCentroid), BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
 	if (!comResult.ok) return comResult;
 	const result = {
 		mass: m,
@@ -89,8 +141,9 @@ function measureSurfaceProps(shape) {
 /**
 * Measure linear properties of any shape.
 *
-* For edges this is the arc length; for wires/compounds it is the total
-* length of all edges.
+* 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.
 *
 * @param shape - Any shape whose linear extent is to be measured.
 * @returns `Result` containing length, center of mass, and raw mass property.
@@ -101,12 +154,26 @@ function measureLinearProps(shape) {
 	if (cached) return ok(cached);
 	if (shapeIsNull(shape)) return nullShapeErr("measureLinearProps");
 	const kernel = getKernel();
-	const m = kernel.length(shape.wrapped);
-	const result = {
-		mass: m,
-		length: m,
-		centerOfMass: kernel.linearCenterOfMass(shape.wrapped)
+	const type = kernel.shapeType(shape.wrapped);
+	const linearOf = (target) => {
+		const m = kernel.length(target);
+		return {
+			mass: m,
+			length: m,
+			centerOfMass: kernel.linearCenterOfMass(target)
+		};
 	};
+	let result;
+	if (type === "vertex" || type === "edge" || type === "wire" || type === "face") result = linearOf(shape.wrapped);
+	else result = withSubShapes(shape, "edge", (edges) => edges.length === 0 ? {
+		mass: 0,
+		length: 0,
+		centerOfMass: [
+			0,
+			0,
+			0
+		]
+	} : withCompoundOf(edges, linearOf));
 	setCachedMeasurement(shape.wrapped, "linear", result);
 	return ok(result);
 }

package/dist/{measureFns-Ed7LXAhG.cjs → measureFns-CuabRDRL.cjs}

@@ -1,7 +1,7 @@
-const require_shapeTypes = require("./shapeTypes-HDVHzNk1.cjs");
+const require_shapeTypes = require("./shapeTypes-D938X2mg.cjs");
 const require_errors = require("./errors-O_blYTWT.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-gyva7bvF.cjs");
-const require_faceFns = require("./faceFns-C6fYNgZl.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-4WYqtSFF.cjs");
+const require_faceFns = require("./faceFns-Cx7cwUMx.cjs");
 // src/measurement/measureCache.ts
 var cache = /* @__PURE__ */ new WeakMap();
 function getCachedMeasurement(shape, key) {
@@ -27,6 +27,66 @@ function nullShapeErr(fn) {
 	return require_errors.err(require_errors.validationError(require_errors.BrepErrorCode.NULL_SHAPE_INPUT, `${fn}: shape is a null shape`));
 }
 /**
+* 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.
+*/
+function withSubShapes(shape, type, fn) {
+	const kernel = require_shapeTypes.getKernel();
+	const items = kernel.iterShapes(shape.wrapped, type);
+	try {
+		return fn(items);
+	} finally {
+		for (const item of items) kernel.dispose(item);
+	}
+}
+/** Run `fn` on a throwaway compound of `parts`, releasing the compound afterwards. */
+function withCompoundOf(parts, fn) {
+	const kernel = require_shapeTypes.getKernel();
+	const c = kernel.makeCompound(parts);
+	try {
+		return fn(c);
+	} finally {
+		kernel.dispose(c);
+	}
+}
+function volumeOf(target) {
+	const kernel = require_shapeTypes.getKernel();
+	const m = kernel.volume(target);
+	const comResult = require_topologyQueryFns.kernelCallRaw(() => kernel.centerOfMass(target), require_errors.BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
+	if (!comResult.ok) return comResult;
+	return require_errors.ok({
+		mass: m,
+		volume: m,
+		centerOfMass: comResult.value
+	});
+}
+/** Area-weighted centroid of `faces`, from each face's own surface center of mass. */
+function surfaceCentroid(faces) {
+	const kernel = require_shapeTypes.getKernel();
+	let total = 0;
+	let x = 0;
+	let y = 0;
+	let z = 0;
+	for (const f of faces) {
+		const a = kernel.area(f);
+		const [cx, cy, cz] = kernel.surfaceCenterOfMass(f);
+		total += a;
+		x += a * cx;
+		y += a * cy;
+		z += a * cz;
+	}
+	return total > 0 ? [
+		x / total,
+		y / total,
+		z / total
+	] : [
+		0,
+		0,
+		0
+	];
+}
+/**
 * Measure volume properties of a 3D shape.
 *
 * @param shape - A solid or compound shape.
@@ -37,31 +97,23 @@ function measureVolumeProps(shape) {
 	const cached = getCachedMeasurement(shape.wrapped, "volume");
 	if (cached) return require_errors.ok(cached);
 	if (shapeIsNull(shape)) return nullShapeErr("measureVolumeProps");
-	const kernel = require_shapeTypes.getKernel();
-	const type = kernel.shapeType(shape.wrapped);
-	if (type !== "solid" && type !== "compsolid" && type !== "compound") {
-		const zero = {
-			mass: 0,
-			volume: 0,
-			centerOfMass: [
-				0,
-				0,
-				0
-			]
-		};
-		setCachedMeasurement(shape.wrapped, "volume", zero);
-		return require_errors.ok(zero);
-	}
-	const m = kernel.volume(shape.wrapped);
-	const comResult = require_topologyQueryFns.kernelCallRaw(() => kernel.centerOfMass(shape.wrapped), require_errors.BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
-	if (!comResult.ok) return comResult;
-	const result = {
-		mass: m,
-		volume: m,
-		centerOfMass: comResult.value
+	const type = require_shapeTypes.getKernel().shapeType(shape.wrapped);
+	const zero = {
+		mass: 0,
+		volume: 0,
+		centerOfMass: [
+			0,
+			0,
+			0
+		]
 	};
-	setCachedMeasurement(shape.wrapped, "volume", result);
-	return require_errors.ok(result);
+	let result;
+	if (type === "solid" || type === "compsolid") result = volumeOf(shape.wrapped);
+	else if (type === "compound") result = withSubShapes(shape, "solid", (solids) => solids.length === 0 ? require_errors.ok(zero) : withCompoundOf(solids, volumeOf));
+	else result = require_errors.ok(zero);
+	if (!result.ok) return result;
+	setCachedMeasurement(shape.wrapped, "volume", result.value);
+	return result;
 }
 /**
 * Measure surface properties of a face or 3D shape.
@@ -76,7 +128,7 @@ function measureSurfaceProps(shape) {
 	if (shapeIsNull(shape)) return nullShapeErr("measureSurfaceProps");
 	const kernel = require_shapeTypes.getKernel();
 	const m = kernel.area(shape.wrapped);
-	const comResult = require_topologyQueryFns.kernelCallRaw(() => kernel.centerOfMass(shape.wrapped), require_errors.BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
+	const comResult = require_topologyQueryFns.kernelCallRaw(() => kernel.shapeType(shape.wrapped) === "face" ? kernel.surfaceCenterOfMass(shape.wrapped) : withSubShapes(shape, "face", surfaceCentroid), require_errors.BrepErrorCode.CENTER_OF_MASS_FAILED, "Failed to compute center of mass");
 	if (!comResult.ok) return comResult;
 	const result = {
 		mass: m,
@@ -89,8 +141,9 @@ function measureSurfaceProps(shape) {
 /**
 * Measure linear properties of any shape.
 *
-* For edges this is the arc length; for wires/compounds it is the total
-* length of all edges.
+* 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.
 *
 * @param shape - Any shape whose linear extent is to be measured.
 * @returns `Result` containing length, center of mass, and raw mass property.
@@ -101,12 +154,26 @@ function measureLinearProps(shape) {
 	if (cached) return require_errors.ok(cached);
 	if (shapeIsNull(shape)) return nullShapeErr("measureLinearProps");
 	const kernel = require_shapeTypes.getKernel();
-	const m = kernel.length(shape.wrapped);
-	const result = {
-		mass: m,
-		length: m,
-		centerOfMass: kernel.linearCenterOfMass(shape.wrapped)
+	const type = kernel.shapeType(shape.wrapped);
+	const linearOf = (target) => {
+		const m = kernel.length(target);
+		return {
+			mass: m,
+			length: m,
+			centerOfMass: kernel.linearCenterOfMass(target)
+		};
 	};
+	let result;
+	if (type === "vertex" || type === "edge" || type === "wire" || type === "face") result = linearOf(shape.wrapped);
+	else result = withSubShapes(shape, "edge", (edges) => edges.length === 0 ? {
+		mass: 0,
+		length: 0,
+		centerOfMass: [
+			0,
+			0,
+			0
+		]
+	} : withCompoundOf(edges, linearOf));
 	setCachedMeasurement(shape.wrapped, "linear", result);
 	return require_errors.ok(result);
 }

package/dist/measurement/measureFns.d.ts

@@ -22,8 +22,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/compounds it is the total
- * length of all edges.
+ * 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.
  *
  * @param shape - Any shape whose linear extent is to be measured.
  * @returns `Result` containing length, center of mass, and raw mass property.