brepjs 20.2.0 → 20.4.0

package/dist/{meshFns-BT7W4b1c.cjs → meshFns-CAxkaRTm.cjs}

@@ -1,7 +1,7 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-gG-7hA7k.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-CI4j3NTE.cjs");
-const require_originTrackingFns = require("./originTrackingFns-B3-1bBED.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
+const require_originTrackingFns = require("./originTrackingFns-CWo6NWHK.cjs");
 //#region src/topology/meshCache.ts
 /**
 * Build a parameter key for the inner cache map (excludes shape identity).

package/dist/{meshFns-o9MnZeir.js → meshFns-COlno8TY.js}

@@ -1,7 +1,7 @@
-import { q as getKernel, ut as qualityDeflection } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, g as err, r as ioError } from "./errors-CDSezF9z.js";
-import { d as getSolids, n as getBounds } from "./topologyQueryFns-fNWsM4Lr.js";
-import { t as getFaceOrigins } from "./originTrackingFns-BFmhk_Up.js";
+import { q as getKernel, ut as qualityDeflection } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, g as err, r as ioError } from "./errors-Zb3jBa0u.js";
+import { d as getSolids, n as getBounds } from "./topologyQueryFns-DnfjQgP7.js";
+import { t as getFaceOrigins } from "./originTrackingFns-DiHy5BZC.js";
 //#region src/topology/meshCache.ts
 /**
 * Build a parameter key for the inner cache map (excludes shape identity).

package/dist/ns/measurement.d.ts

@@ -3,3 +3,4 @@
  */
 export { measureVolume, measureArea, measureLength, measureDistance, measureDistanceProps, createDistanceQuery, measureVolumeProps, measureSurfaceProps, measureLinearProps, measureCurvatureAt, measureCurvatureAtMid, } from '../measurement/measureFns.js';
 export { checkInterference, checkAllInterferences } from '../measurement/interferenceFns.js';
+export { principalBoundingBox } from '../measurement/principalBoxFns.js';

package/dist/{occtWasmAdapter-D4I0n537.js → occtWasmAdapter-BX10fyla.js}

@@ -2362,6 +2362,24 @@ function linearCenterOfMass(k, shape) {
 		vec.delete();
 	}
 }
+function inertia(k, shape) {
+	const vec = k.getInertia(unwrap(shape));
+	try {
+		return [
+			vec.get(0),
+			vec.get(1),
+			vec.get(2),
+			vec.get(3),
+			vec.get(4),
+			vec.get(5),
+			vec.get(6),
+			vec.get(7),
+			vec.get(8)
+		];
+	} finally {
+		vec.delete();
+	}
+}
 function boundingBox(k, shape) {
 	const bb = k.getBoundingBox(unwrap(shape), true);
 	return {
@@ -5435,6 +5453,9 @@ var OcctWasmAdapter = class OcctWasmAdapter {
 	boundingBox(shape) {
 		return boundingBox(this.k, shape);
 	}
+	inertia(shape) {
+		return inertia(this.k, shape);
+	}
 	distance(shape1, shape2) {
 		return distance(this.k, this.Module, shape1, shape2);
 	}

package/dist/{occtWasmAdapter-wCKnmevS.cjs → occtWasmAdapter-CA6PmIIj.cjs}

@@ -2362,6 +2362,24 @@ function linearCenterOfMass(k, shape) {
 		vec.delete();
 	}
 }
+function inertia(k, shape) {
+	const vec = k.getInertia(unwrap(shape));
+	try {
+		return [
+			vec.get(0),
+			vec.get(1),
+			vec.get(2),
+			vec.get(3),
+			vec.get(4),
+			vec.get(5),
+			vec.get(6),
+			vec.get(7),
+			vec.get(8)
+		];
+	} finally {
+		vec.delete();
+	}
+}
 function boundingBox(k, shape) {
 	const bb = k.getBoundingBox(unwrap(shape), true);
 	return {
@@ -5435,6 +5453,9 @@ var OcctWasmAdapter = class OcctWasmAdapter {
 	boundingBox(shape) {
 		return boundingBox(this.k, shape);
 	}
+	inertia(shape) {
+		return inertia(this.k, shape);
+	}
 	distance(shape1, shape2) {
 		return distance(this.k, this.Module, shape1, shape2);
 	}

package/dist/operations/extrudeFns.d.ts

@@ -6,6 +6,10 @@ export type { ExtrusionProfile, SweepOptions } from './extrudeUtils.js';
 /**
  * Extrude a face along a vector to produce a solid.
  *
+ * The result carries semantic face roles (`extrude:start`, `extrude:end`,
+ * `extrude:side:<i>`, `extrude:hole<j>:side:<i>`) that
+ * `assignRoles(solid, 'extrude')` returns in place of positional names.
+ *
  * @param face - The planar face to extrude.
  * @param extrusionVec - Direction and magnitude of the extrusion as `[x, y, z]`.
  * @returns `Result` containing the extruded solid, or an error if validation or operation fails.

package/dist/operations.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_threadFns = require("./threadFns-DAKMitvE.cjs");
-const require_loftFns = require("./loftFns-CI8uJc1D.cjs");
+const require_threadFns = require("./threadFns-BUQPg_vI.cjs");
+const require_loftFns = require("./loftFns-DL9UsQhd.cjs");
 exports.addChild = require_threadFns.addChild;
 exports.addJoint = require_threadFns.addJoint;
 exports.addStep = require_threadFns.addStep;

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-DlGXBSK7.js";
-import { c as twistExtrude, o as supportExtrude, r as complexExtrude, s as sweep } from "./loftFns-DE1GYW9g.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-3U9x4v_M.js";
+import { c as twistExtrude, o as supportExtrude, r as complexExtrude, s as sweep } from "./loftFns-B5mq1WDh.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/{originTrackingFns-B3-1bBED.cjs → originTrackingFns-CWo6NWHK.cjs}

@@ -1,5 +1,5 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-CI4j3NTE.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 //#region src/topology/metadata/originTrackingFns.ts
 /**

package/dist/{originTrackingFns-BFmhk_Up.js → originTrackingFns-DiHy5BZC.js}

@@ -1,5 +1,5 @@
-import { q as getKernel } from "./shapeTypes-DVpJHhgk.js";
-import { S as subShapeHashes, c as getFaces, l as getOrCreateCache, r as getCacheEntry } from "./topologyQueryFns-fNWsM4Lr.js";
+import { q as getKernel } from "./shapeTypes-CqNJoSam.js";
+import { C as subShapeHashes, c as getFaces, l as getOrCreateCache, r as getCacheEntry } from "./topologyQueryFns-DnfjQgP7.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
 //#region src/topology/metadata/originTrackingFns.ts
 /**

package/dist/{planeOps-BO6nvRja.js → planeOps-Cxws4Tiu.js}

@@ -1,4 +1,4 @@
-import { E as ok, P as unwrap, d as validationError, g as err } from "./errors-CDSezF9z.js";
+import { E as ok, P as unwrap, d as validationError, g as err } from "./errors-Zb3jBa0u.js";
 import { t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
 import { d as vecNormalize, h as vecScale, m as vecRotate, r as vecCross, s as vecIsZero, t as vecAdd } from "./vecOps-SKPRvPH-.js";

package/dist/{planeOps-DqGSxcMr.cjs → planeOps-DJuclNxa.cjs}

@@ -1,4 +1,4 @@
-const require_errors = require("./errors-gG-7hA7k.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");

package/dist/{primitiveFns-DfhjU_X9.js → primitiveFns-CGJzS4MO.js}

@@ -1,9 +1,9 @@
-import { E as GeometryCleanupError, G as _usingCtx, d as createSolid, n as castResultShape, q as getKernel } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, d as validationError, g as err, m as andThen, t as BrepErrorCode } from "./errors-CDSezF9z.js";
-import { n as isClosedWire } from "./validityTypes-2DNKAPEw.js";
+import { E as GeometryCleanupError, G as _usingCtx, d as createSolid, n as castResultShape, q as getKernel } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, d as validationError, g as err, m as andThen, t as BrepErrorCode } from "./errors-Zb3jBa0u.js";
+import { n as isClosedWire } from "./validityTypes-t7JpS0Ki.js";
 import { n as HASH_CODE_MAX, t as DEG2RAD } from "./constants-ITRzCnCp.js";
-import { C as propagateAllMetadata, S as hasAnyMetadata, T as propagateMetadataThroughRelocation, 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, w as propagateMetadataByHash, x as collectInputFaceHashes } from "./solidBuilders-p_ppeTkc.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-Dccm2kQX.js";
+import { C as propagateAllMetadata, S as hasAnyMetadata, T as propagateMetadataThroughRelocation, 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, w as propagateMetadataByHash, x as collectInputFaceHashes } from "./solidBuilders-IstbiWju.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-8nLk2PWk.js";
 //#region src/topology/transformFns.ts
 /**
 * Immutable shape transforms — translate, rotate, scale, mirror, applyMatrix.

package/dist/{primitiveFns-Ke-n8Bib.cjs → primitiveFns-ZV3aMbqG.cjs}

@@ -1,9 +1,9 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-gG-7hA7k.cjs");
-const require_validityTypes = require("./validityTypes-D9oxhu4U.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_validityTypes = require("./validityTypes-r0A2YdNq.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
-const require_solidBuilders = require("./solidBuilders-B8t5h68e.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-Bn-c9xVR.cjs");
+const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-vYgSvgI6.cjs");
 //#region src/topology/transformFns.ts
 /**
 * Immutable shape transforms — translate, rotate, scale, mirror, applyMatrix.

package/dist/principalBoxFns-5FSbxAj-.cjs

@@ -0,0 +1,212 @@
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_bug = require("./bug-O02CsAmt.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
+const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
+const require_measureFns = require("./measureFns-D_GpQw5z.cjs");
+//#region src/measurement/principalBoxFns.ts
+/**
+* Principal-axes bounding box: a solid's extent measured in the frame of its
+* principal axes of inertia instead of the world axes.
+*/
+var ZERO_VOLUME_TOLERANCE = 1e-9;
+var OFF_DIAGONAL_TOLERANCE = 1e-12;
+var JACOBI_MAX_SWEEPS = 32;
+var JACOBI_PLANES = [
+	[0, 1],
+	[0, 2],
+	[1, 2]
+];
+var ORIGIN = [
+	0,
+	0,
+	0
+];
+function validatePrincipalBoxInput(shape) {
+	const kernel = require_shapeTypes.getKernel();
+	if (kernel.isNull(shape.wrapped)) return require_errors.err(require_errors.validationError(require_errors.BrepErrorCode.NULL_SHAPE_INPUT, "principalBoundingBox: shape is a null shape"));
+	const type = kernel.shapeType(shape.wrapped);
+	if (type !== "solid" && type !== "compsolid" && type !== "compound") return require_errors.err(require_errors.validationError(require_errors.BrepErrorCode.NOT_A_SOLID, `principalBoundingBox: expected a solid, got a ${type}`, void 0, { shapeType: type }, "Use getBounds() for faces, wires, and shells"));
+	const volume = require_topologyQueryFns.kernelCallRaw(() => type === "solid" || require_topologyQueryFns.subShapeCount(shape, "solid") > 0 ? kernel.volume(shape.wrapped) : 0, require_errors.BrepErrorCode.PRINCIPAL_BOX_FAILED, "principalBoundingBox: failed to measure volume");
+	if (!volume.ok) return volume;
+	if (volume.value <= ZERO_VOLUME_TOLERANCE) return require_errors.err(require_errors.validationError(require_errors.BrepErrorCode.ZERO_VOLUME, "principalBoundingBox: shape encloses no volume", void 0, { volume: volume.value }, "Use getBounds() for shapes without volume, or build a solid first"));
+}
+/** One cyclic-Jacobi rotation that zeroes `a[p][q]`, accumulated into the eigenvector matrix `v`. */
+function jacobiRotate(a, v, p, q) {
+	const apq = require_bug.wasmIndex(a, p * 3 + q);
+	const theta = (require_bug.wasmIndex(a, q * 3 + q) - require_bug.wasmIndex(a, p * 3 + p)) / (2 * apq);
+	const t = (theta >= 0 ? 1 : -1) / (Math.abs(theta) + Math.sqrt(theta * theta + 1));
+	const c = 1 / Math.sqrt(t * t + 1);
+	const s = t * c;
+	for (let k = 0; k < 3; k++) {
+		const akp = require_bug.wasmIndex(a, k * 3 + p);
+		const akq = require_bug.wasmIndex(a, k * 3 + q);
+		a[k * 3 + p] = c * akp - s * akq;
+		a[k * 3 + q] = s * akp + c * akq;
+	}
+	for (let k = 0; k < 3; k++) {
+		const apk = require_bug.wasmIndex(a, p * 3 + k);
+		const aqk = require_bug.wasmIndex(a, q * 3 + k);
+		a[p * 3 + k] = c * apk - s * aqk;
+		a[q * 3 + k] = s * apk + c * aqk;
+		const vkp = require_bug.wasmIndex(v, k * 3 + p);
+		const vkq = require_bug.wasmIndex(v, k * 3 + q);
+		v[k * 3 + p] = c * vkp - s * vkq;
+		v[k * 3 + q] = s * vkp + c * vkq;
+	}
+	a[p * 3 + q] = 0;
+	a[q * 3 + p] = 0;
+}
+/**
+* Eigenvectors of a symmetric 3x3 matrix by cyclic Jacobi. Every rotation is
+* proper, so the returned axes form a right-handed orthonormal frame.
+*/
+function principalAxes(m) {
+	const a = [...m];
+	const v = [
+		1,
+		0,
+		0,
+		0,
+		1,
+		0,
+		0,
+		0,
+		1
+	];
+	const threshold = OFF_DIAGONAL_TOLERANCE * Math.hypot(...m);
+	for (let sweep = 0; sweep < JACOBI_MAX_SWEEPS; sweep++) {
+		let rotated = false;
+		for (const [p, q] of JACOBI_PLANES) {
+			if (Math.abs(require_bug.wasmIndex(a, p * 3 + q)) <= threshold) continue;
+			jacobiRotate(a, v, p, q);
+			rotated = true;
+		}
+		if (!rotated) break;
+	}
+	const column = (j) => [
+		require_bug.wasmIndex(v, j),
+		require_bug.wasmIndex(v, 3 + j),
+		require_bug.wasmIndex(v, 6 + j)
+	];
+	return [
+		column(0),
+		column(1),
+		column(2)
+	];
+}
+/** Flip `v` so its largest-magnitude component is positive. */
+function canonicalSign(v) {
+	const x = Math.abs(v[0]);
+	const y = Math.abs(v[1]);
+	const z = Math.abs(v[2]);
+	return (x >= y && x >= z ? v[0] : y >= z ? v[1] : v[2]) < 0 ? [
+		-v[0],
+		-v[1],
+		-v[2]
+	] : v;
+}
+function withoutNegativeZero(v) {
+	return [
+		v[0] + 0,
+		v[1] + 0,
+		v[2] + 0
+	];
+}
+function boundsInFrame(shape, axes) {
+	try {
+		var _usingCtx$1 = require_shapeTypes._usingCtx();
+		const kernel = require_shapeTypes.getKernel();
+		const [a0, a1, a2] = axes;
+		const framed = _usingCtx$1.u(require_shapeTypes.castResultShape(kernel.generalTransform(shape.wrapped, [
+			...a0,
+			...a1,
+			...a2
+		], ORIGIN, true)));
+		return kernel.boundingBox(framed.wrapped);
+	} catch (_) {
+		_usingCtx$1.e = _;
+	} finally {
+		_usingCtx$1.d();
+	}
+}
+function assembleBox(axes, bounds) {
+	const extents = axes.map((axis, i) => ({
+		axis,
+		size: require_bug.wasmIndex(bounds.max, i) - require_bug.wasmIndex(bounds.min, i),
+		mid: (require_bug.wasmIndex(bounds.min, i) + require_bug.wasmIndex(bounds.max, i)) / 2
+	}));
+	const centerAlong = (c) => extents.reduce((sum, e) => sum + e.mid * require_bug.wasmIndex(e.axis, c), 0);
+	const sorted = [...extents].sort((p, q) => q.size - p.size);
+	const major = canonicalSign(require_bug.wasmIndex(sorted, 0).axis);
+	const middle = canonicalSign(require_bug.wasmIndex(sorted, 1).axis);
+	return {
+		center: [
+			centerAlong(0),
+			centerAlong(1),
+			centerAlong(2)
+		],
+		axes: [
+			withoutNegativeZero(major),
+			withoutNegativeZero(middle),
+			withoutNegativeZero(require_vecOps.vecCross(major, middle))
+		],
+		size: [
+			require_bug.wasmIndex(sorted, 0).size,
+			require_bug.wasmIndex(sorted, 1).size,
+			require_bug.wasmIndex(sorted, 2).size
+		]
+	};
+}
+/**
+* Measure a solid's bounding box on its principal axes of inertia.
+*
+* `getBounds` answers in world axes, so a board turned 30 degrees reports an
+* inflated box with no frame. This box follows the part's own frame instead:
+* it is the axis-aligned box in the frame of the principal axes of the volume
+* inertia tensor about the center of mass.
+*
+* This is NOT a minimum-volume oriented bounding box. When principal moments
+* coincide, the principal axes in that plane are not unique and the box can be
+* larger than the tightest one: a 100 x 100 x 2 plate rotated 30 degrees about
+* 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.
+* @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
+*   (face, wire, shell, ...), `ZERO_VOLUME` when the shape encloses no volume
+*   (e.g. a compound of faces), and an `UNSUPPORTED` error on kernels without
+*   an inertia query.
+*
+* @example
+* ```ts
+* const { size, axes, center } = unwrap(principalBoundingBox(board));
+* // size: [length, width, thickness]; axes[2] is the board's normal
+* ```
+*/
+function principalBoundingBox(shape) {
+	const cached = require_measureFns.getCachedMeasurement(shape.wrapped, "principal");
+	if (cached) return require_errors.ok(cached);
+	const invalid = validatePrincipalBoxInput(shape);
+	if (invalid) return invalid;
+	const kernel = require_shapeTypes.getKernel();
+	const inertiaOf = kernel.inertia?.bind(kernel);
+	if (!inertiaOf) return require_errors.err(require_errors.unsupportedError(require_errors.BrepErrorCode.UNSUPPORTED_CAPABILITY, `principalBoundingBox: the ${kernel.kernelId} kernel has no inertia query`, void 0, { kernel: kernel.kernelId }, "Use the occt-wasm kernel, which provides the inertia query"));
+	const inertia = require_topologyQueryFns.kernelCallRaw(() => inertiaOf(shape.wrapped), require_errors.BrepErrorCode.PRINCIPAL_BOX_FAILED, "principalBoundingBox: failed to compute the matrix of inertia");
+	if (!inertia.ok) return inertia;
+	const axes = principalAxes(inertia.value);
+	const bounds = require_topologyQueryFns.kernelCallRaw(() => boundsInFrame(shape, axes), require_errors.BrepErrorCode.PRINCIPAL_BOX_FAILED, "principalBoundingBox: failed to measure bounds in the principal frame");
+	if (!bounds.ok) return bounds;
+	const result = assembleBox(axes, bounds.value);
+	require_measureFns.setCachedMeasurement(shape.wrapped, "principal", result);
+	return require_errors.ok(result);
+}
+//#endregion
+Object.defineProperty(exports, "principalBoundingBox", {
+	enumerable: true,
+	get: function() {
+		return principalBoundingBox;
+	}
+});

package/dist/principalBoxFns-BJgGEoik.js

@@ -0,0 +1,207 @@
+import { G as _usingCtx, n as castResultShape, q as getKernel } from "./shapeTypes-CqNJoSam.js";
+import { i as wasmIndex } from "./bug-BdOHwn_e.js";
+import { E as ok, d as validationError, g as err, t as BrepErrorCode, u as unsupportedError } from "./errors-Zb3jBa0u.js";
+import { E as kernelCallRaw, S as subShapeCount } from "./topologyQueryFns-DnfjQgP7.js";
+import { r as vecCross } from "./vecOps-SKPRvPH-.js";
+import { f as getCachedMeasurement, p as setCachedMeasurement } from "./measureFns-CyDVZomf.js";
+//#region src/measurement/principalBoxFns.ts
+/**
+* Principal-axes bounding box: a solid's extent measured in the frame of its
+* principal axes of inertia instead of the world axes.
+*/
+var ZERO_VOLUME_TOLERANCE = 1e-9;
+var OFF_DIAGONAL_TOLERANCE = 1e-12;
+var JACOBI_MAX_SWEEPS = 32;
+var JACOBI_PLANES = [
+	[0, 1],
+	[0, 2],
+	[1, 2]
+];
+var ORIGIN = [
+	0,
+	0,
+	0
+];
+function validatePrincipalBoxInput(shape) {
+	const kernel = getKernel();
+	if (kernel.isNull(shape.wrapped)) return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, "principalBoundingBox: shape is a null shape"));
+	const type = kernel.shapeType(shape.wrapped);
+	if (type !== "solid" && type !== "compsolid" && type !== "compound") return err(validationError(BrepErrorCode.NOT_A_SOLID, `principalBoundingBox: expected a solid, got a ${type}`, void 0, { shapeType: type }, "Use getBounds() for faces, wires, and shells"));
+	const volume = kernelCallRaw(() => type === "solid" || subShapeCount(shape, "solid") > 0 ? kernel.volume(shape.wrapped) : 0, BrepErrorCode.PRINCIPAL_BOX_FAILED, "principalBoundingBox: failed to measure volume");
+	if (!volume.ok) return volume;
+	if (volume.value <= ZERO_VOLUME_TOLERANCE) return err(validationError(BrepErrorCode.ZERO_VOLUME, "principalBoundingBox: shape encloses no volume", void 0, { volume: volume.value }, "Use getBounds() for shapes without volume, or build a solid first"));
+}
+/** One cyclic-Jacobi rotation that zeroes `a[p][q]`, accumulated into the eigenvector matrix `v`. */
+function jacobiRotate(a, v, p, q) {
+	const apq = wasmIndex(a, p * 3 + q);
+	const theta = (wasmIndex(a, q * 3 + q) - wasmIndex(a, p * 3 + p)) / (2 * apq);
+	const t = (theta >= 0 ? 1 : -1) / (Math.abs(theta) + Math.sqrt(theta * theta + 1));
+	const c = 1 / Math.sqrt(t * t + 1);
+	const s = t * c;
+	for (let k = 0; k < 3; k++) {
+		const akp = wasmIndex(a, k * 3 + p);
+		const akq = wasmIndex(a, k * 3 + q);
+		a[k * 3 + p] = c * akp - s * akq;
+		a[k * 3 + q] = s * akp + c * akq;
+	}
+	for (let k = 0; k < 3; k++) {
+		const apk = wasmIndex(a, p * 3 + k);
+		const aqk = wasmIndex(a, q * 3 + k);
+		a[p * 3 + k] = c * apk - s * aqk;
+		a[q * 3 + k] = s * apk + c * aqk;
+		const vkp = wasmIndex(v, k * 3 + p);
+		const vkq = wasmIndex(v, k * 3 + q);
+		v[k * 3 + p] = c * vkp - s * vkq;
+		v[k * 3 + q] = s * vkp + c * vkq;
+	}
+	a[p * 3 + q] = 0;
+	a[q * 3 + p] = 0;
+}
+/**
+* Eigenvectors of a symmetric 3x3 matrix by cyclic Jacobi. Every rotation is
+* proper, so the returned axes form a right-handed orthonormal frame.
+*/
+function principalAxes(m) {
+	const a = [...m];
+	const v = [
+		1,
+		0,
+		0,
+		0,
+		1,
+		0,
+		0,
+		0,
+		1
+	];
+	const threshold = OFF_DIAGONAL_TOLERANCE * Math.hypot(...m);
+	for (let sweep = 0; sweep < JACOBI_MAX_SWEEPS; sweep++) {
+		let rotated = false;
+		for (const [p, q] of JACOBI_PLANES) {
+			if (Math.abs(wasmIndex(a, p * 3 + q)) <= threshold) continue;
+			jacobiRotate(a, v, p, q);
+			rotated = true;
+		}
+		if (!rotated) break;
+	}
+	const column = (j) => [
+		wasmIndex(v, j),
+		wasmIndex(v, 3 + j),
+		wasmIndex(v, 6 + j)
+	];
+	return [
+		column(0),
+		column(1),
+		column(2)
+	];
+}
+/** Flip `v` so its largest-magnitude component is positive. */
+function canonicalSign(v) {
+	const x = Math.abs(v[0]);
+	const y = Math.abs(v[1]);
+	const z = Math.abs(v[2]);
+	return (x >= y && x >= z ? v[0] : y >= z ? v[1] : v[2]) < 0 ? [
+		-v[0],
+		-v[1],
+		-v[2]
+	] : v;
+}
+function withoutNegativeZero(v) {
+	return [
+		v[0] + 0,
+		v[1] + 0,
+		v[2] + 0
+	];
+}
+function boundsInFrame(shape, axes) {
+	try {
+		var _usingCtx$1 = _usingCtx();
+		const kernel = getKernel();
+		const [a0, a1, a2] = axes;
+		const framed = _usingCtx$1.u(castResultShape(kernel.generalTransform(shape.wrapped, [
+			...a0,
+			...a1,
+			...a2
+		], ORIGIN, true)));
+		return kernel.boundingBox(framed.wrapped);
+	} catch (_) {
+		_usingCtx$1.e = _;
+	} finally {
+		_usingCtx$1.d();
+	}
+}
+function assembleBox(axes, bounds) {
+	const extents = axes.map((axis, i) => ({
+		axis,
+		size: wasmIndex(bounds.max, i) - wasmIndex(bounds.min, i),
+		mid: (wasmIndex(bounds.min, i) + wasmIndex(bounds.max, i)) / 2
+	}));
+	const centerAlong = (c) => extents.reduce((sum, e) => sum + e.mid * wasmIndex(e.axis, c), 0);
+	const sorted = [...extents].sort((p, q) => q.size - p.size);
+	const major = canonicalSign(wasmIndex(sorted, 0).axis);
+	const middle = canonicalSign(wasmIndex(sorted, 1).axis);
+	return {
+		center: [
+			centerAlong(0),
+			centerAlong(1),
+			centerAlong(2)
+		],
+		axes: [
+			withoutNegativeZero(major),
+			withoutNegativeZero(middle),
+			withoutNegativeZero(vecCross(major, middle))
+		],
+		size: [
+			wasmIndex(sorted, 0).size,
+			wasmIndex(sorted, 1).size,
+			wasmIndex(sorted, 2).size
+		]
+	};
+}
+/**
+* Measure a solid's bounding box on its principal axes of inertia.
+*
+* `getBounds` answers in world axes, so a board turned 30 degrees reports an
+* inflated box with no frame. This box follows the part's own frame instead:
+* it is the axis-aligned box in the frame of the principal axes of the volume
+* inertia tensor about the center of mass.
+*
+* This is NOT a minimum-volume oriented bounding box. When principal moments
+* coincide, the principal axes in that plane are not unique and the box can be
+* larger than the tightest one: a 100 x 100 x 2 plate rotated 30 degrees about
+* 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.
+* @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
+*   (face, wire, shell, ...), `ZERO_VOLUME` when the shape encloses no volume
+*   (e.g. a compound of faces), and an `UNSUPPORTED` error on kernels without
+*   an inertia query.
+*
+* @example
+* ```ts
+* const { size, axes, center } = unwrap(principalBoundingBox(board));
+* // size: [length, width, thickness]; axes[2] is the board's normal
+* ```
+*/
+function principalBoundingBox(shape) {
+	const cached = getCachedMeasurement(shape.wrapped, "principal");
+	if (cached) return ok(cached);
+	const invalid = validatePrincipalBoxInput(shape);
+	if (invalid) return invalid;
+	const kernel = getKernel();
+	const inertiaOf = kernel.inertia?.bind(kernel);
+	if (!inertiaOf) return err(unsupportedError(BrepErrorCode.UNSUPPORTED_CAPABILITY, `principalBoundingBox: the ${kernel.kernelId} kernel has no inertia query`, void 0, { kernel: kernel.kernelId }, "Use the occt-wasm kernel, which provides the inertia query"));
+	const inertia = kernelCallRaw(() => inertiaOf(shape.wrapped), BrepErrorCode.PRINCIPAL_BOX_FAILED, "principalBoundingBox: failed to compute the matrix of inertia");
+	if (!inertia.ok) return inertia;
+	const axes = principalAxes(inertia.value);
+	const bounds = kernelCallRaw(() => boundsInFrame(shape, axes), BrepErrorCode.PRINCIPAL_BOX_FAILED, "principalBoundingBox: failed to measure bounds in the principal frame");
+	if (!bounds.ok) return bounds;
+	const result = assembleBox(axes, bounds.value);
+	setCachedMeasurement(shape.wrapped, "principal", result);
+	return ok(result);
+}
+//#endregion
+export { principalBoundingBox as t };

package/dist/projection.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cameraFns = require("./cameraFns-B8Ai6b3Q.cjs");
+const require_cameraFns = require("./cameraFns-RHCb1F1s.cjs");
 exports.PROJECTION_PLANES = require_cameraFns.PROJECTION_PLANES;
 exports.cameraFromPlane = require_cameraFns.cameraFromPlane;
 exports.cameraLookAt = require_cameraFns.cameraLookAt;

package/dist/projection.js

@@ -1,2 +1,2 @@
-import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, o as PROJECTION_PLANES, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-u08iOn7p.js";
+import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, o as PROJECTION_PLANES, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-Cs6v3bWQ.js";
 export { PROJECTION_PLANES, cameraFromPlane, cameraLookAt, createCamera, isProjectionPlane, makeProjectedEdges, projectEdges };

package/dist/query.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_helpers = require("./helpers-Dh4qTGcQ.cjs");
-const require_cornerFinder = require("./cornerFinder-BVUuCBX-.cjs");
+const require_helpers = require("./helpers-NRZVshPb.cjs");
+const require_cornerFinder = require("./cornerFinder-Cji_BK-R.cjs");
 exports.cornerFinder = require_cornerFinder.cornerFinder;
 exports.edgeFinder = require_helpers.edgeFinder;
 exports.faceFinder = require_helpers.faceFinder;

package/dist/query.js

@@ -1,3 +1,3 @@
-import { n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-BWNXoJz0.js";
-import { t as cornerFinder } from "./cornerFinder-DfoRecV-.js";
+import { n as edgeFinder, r as faceFinder, t as getSingleFace } from "./helpers-BN1mVMuZ.js";
+import { t as cornerFinder } from "./cornerFinder-Dlae8IX5.js";
 export { cornerFinder, edgeFinder, faceFinder, getSingleFace };