brepjs 20.1.5 → 20.3.0

package/dist/core/errors.d.ts

@@ -22,6 +22,7 @@ export declare const BrepErrorCode: {
     readonly SOLID_FROM_SHELL_FAILED: "SOLID_FROM_SHELL_FAILED";
     readonly FIX_SELF_INTERSECTION_FAILED: "FIX_SELF_INTERSECTION_FAILED";
     readonly MESH_FAILED: "MESH_FAILED";
+    readonly PRINCIPAL_BOX_FAILED: "PRINCIPAL_BOX_FAILED";
     readonly ELLIPSE_RADII: "ELLIPSE_RADII";
     readonly FUSE_ALL_EMPTY: "FUSE_ALL_EMPTY";
     readonly FILLET_NO_EDGES: "FILLET_NO_EDGES";
@@ -47,6 +48,9 @@ export declare const BrepErrorCode: {
     readonly DRAFT_INVALID_ANGLE: "DRAFT_INVALID_ANGLE";
     readonly DRAFT_NOT_3D: "DRAFT_NOT_3D";
     readonly DRAFT_FAILED: "DRAFT_FAILED";
+    readonly CSG_EXTENSION_UNKNOWN: "CSG_EXTENSION_UNKNOWN";
+    readonly NOT_A_SOLID: "NOT_A_SOLID";
+    readonly ZERO_VOLUME: "ZERO_VOLUME";
     readonly FUSE_NOT_3D: "FUSE_NOT_3D";
     readonly CUT_NOT_3D: "CUT_NOT_3D";
     readonly INTERSECT_NOT_3D: "INTERSECT_NOT_3D";

package/dist/core.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-DWezb9DI.cjs");
-const require_validityTypes = require("./validityTypes-4nhcQAdO.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_validityTypes = require("./validityTypes-r0A2YdNq.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
-const require_planeOps = require("./planeOps-CpupTCRM.cjs");
+const require_planeOps = require("./planeOps-DJuclNxa.cjs");
 exports.BrepBugError = require_bug.BrepBugError;
 exports.DEG2RAD = require_constants.DEG2RAD;
 exports.DisposalScope = require_shapeTypes.DisposalScope;

package/dist/core.js

@@ -1,9 +1,9 @@
-import { C as isSolid, D as getShapeKind, E as GeometryCleanupError, F as createKernelHandle, H as withScope, L as isLive, M as is3D, N as DisposalScope, P as createHandle, S as isShell, T as isWire, U as withScopeResult, W as withScopeResultAsync, _ as isCompound, b as isShape1D, i as castShape, j as is2D, v as isEdge, w as isVertex, x as isShape3D, y as isFace } from "./shapeTypes-DVpJHhgk.js";
+import { C as isSolid, D as getShapeKind, E as GeometryCleanupError, F as createKernelHandle, H as withScope, L as isLive, M as is3D, N as DisposalScope, P as createHandle, S as isShell, T as isWire, U as withScopeResult, W as withScopeResultAsync, _ as isCompound, b as isShape1D, i as castShape, j as is2D, v as isEdge, w as isVertex, x as isShape3D, y as isFace } from "./shapeTypes-CqNJoSam.js";
 import { n as bug, t as BrepBugError } from "./bug-BdOHwn_e.js";
-import { E as ok, F as unwrapErr, I as unwrapOr, L as unwrapOrElse, M as tryCatch, N as tryCatchAsync, P as unwrap, S as map, T as match, _ as flatMap, a as moduleInitError, b as isErr, c as sketcherStateError, d as validationError, f as OK, g as err, h as collect, i as kernelError, l as typeCastError, m as andThen, n as computationError, o as queryError, r as ioError, u as unsupportedError, w as mapErr, x as isOk } from "./errors-CTn8i3lY.js";
-import { c as manifoldShell, f as validSolid, i as isOrientedFace, l as orientedFace, n as isClosedWire, r as isManifoldShell, s as isValidSolid, t as closedWire } from "./validityTypes-D6M4CiEI.js";
+import { E as ok, F as unwrapErr, I as unwrapOr, L as unwrapOrElse, M as tryCatch, N as tryCatchAsync, P as unwrap, S as map, T as match, _ as flatMap, a as moduleInitError, b as isErr, c as sketcherStateError, d as validationError, f as OK, g as err, h as collect, i as kernelError, l as typeCastError, m as andThen, n as computationError, o as queryError, r as ioError, u as unsupportedError, w as mapErr, x as isOk } from "./errors-Zb3jBa0u.js";
+import { c as manifoldShell, f as validSolid, i as isOrientedFace, l as orientedFace, n as isClosedWire, r as isManifoldShell, s as isValidSolid, t as closedWire } from "./validityTypes-t7JpS0Ki.js";
 import { n as HASH_CODE_MAX, r as RAD2DEG, t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { n as toVec2, r as toVec3, t as resolveDirection } from "./types-D24Y27N0.js";
 import { a as vecDot, c as vecLength, d as vecNormalize, f as vecProjectToPlane, g as vecSub, h as vecScale, i as vecDistance, l as vecLengthSq, m as vecRotate, n as vecAngle, o as vecEquals, p as vecRepr, r as vecCross, s as vecIsZero, t as vecAdd, u as vecNegate } from "./vecOps-SKPRvPH-.js";
-import { i as pivotPlane, n as createPlane, o as resolvePlane, s as translatePlane, t as createNamedPlane } from "./planeOps-CkpMeheg.js";
+import { i as pivotPlane, n as createPlane, o as resolvePlane, s as translatePlane, t as createNamedPlane } from "./planeOps-Cxws4Tiu.js";
 export { BrepBugError, DEG2RAD, DisposalScope, GeometryCleanupError, HASH_CODE_MAX, OK, RAD2DEG, andThen, bug, castShape, closedWire, collect, computationError, createHandle, createKernelHandle, createNamedPlane, createPlane, err, flatMap, getShapeKind, ioError, is2D, is3D, isClosedWire, isCompound, isEdge, isErr, isFace, isLive, isManifoldShell, isOk, isOrientedFace, isShape1D, isShape3D, isShell, isSolid, isValidSolid, isVertex, isWire, kernelError, manifoldShell, map, mapErr, match, moduleInitError, ok, orientedFace, pivotPlane, queryError, resolveDirection, resolvePlane, sketcherStateError, toVec2, toVec3, translatePlane, tryCatch, tryCatchAsync, typeCastError, unsupportedError, unwrap, unwrapErr, unwrapOr, unwrapOrElse, validSolid, validationError, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub, withScope, withScopeResult, withScopeResultAsync };

package/dist/{cornerFinder-B-eLajMt.cjs → cornerFinder-Cji_BK-R.cjs}

@@ -1,6 +1,6 @@
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_helpers = require("./helpers-DzuHzyWn.cjs");
+const require_helpers = require("./helpers-NRZVshPb.cjs");
 //#region src/query/cornerFinder.ts
 var PI_2 = 2 * Math.PI;
 function positiveHalfAngle(angle) {

package/dist/{cornerFinder-D589drKe.js → cornerFinder-Dlae8IX5.js}

@@ -1,6 +1,6 @@
 import { t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { n as getAtOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { p as distance2d, u as angle2d, v as samePoint } from "./helpers-Hna44lMW.js";
+import { p as distance2d, u as angle2d, v as samePoint } from "./helpers-BN1mVMuZ.js";
 //#region src/query/cornerFinder.ts
 var PI_2 = 2 * Math.PI;
 function positiveHalfAngle(angle) {

package/dist/csg/builders.d.ts

@@ -3,7 +3,7 @@ import { Contour, Segment2D } from './segments.js';
 import { Matrix4x4 } from '../core/types.js';
 import { ColorInput } from '../topology/metadata/colorFns.js';
 import { EdgeRef, ShapeRef } from '../topology/shapeRef/shapeRefTypes.js';
-import { BoxNode, SphereNode, CylinderNode, ConeNode, TorusNode, PolygonNode, CircleNode, LineNode, VertexLitNode, EmptyNode, FuseNode, CutNode, IntersectNode, FuseAllNode, CutAllNode, TranslateNode, RotateNode, ScaleNode, MirrorNode, ExtrudeNode, RevolveNode, LoftNode, SweepNode, ProfileNode, PathNode, ColorNode, ShellNode, FilletNode, ChamferNode, CompoundNode, InstanceNode, IRNode, SolidNode, FaceNode, EdgeNode, VertexNode } from './types.js';
+import { BoxNode, SphereNode, CylinderNode, ConeNode, TorusNode, PolygonNode, CircleNode, LineNode, VertexLitNode, EmptyNode, FuseNode, CutNode, IntersectNode, FuseAllNode, CutAllNode, TranslateNode, RotateNode, ScaleNode, MirrorNode, ExtrudeNode, RevolveNode, LoftNode, SweepNode, ProfileNode, PathNode, ColorNode, ShellNode, FilletNode, ChamferNode, CompoundNode, InstanceNode, ExtensionNode, IRNode, JsonValue, OutputKind, SolidNode, FaceNode, EdgeNode, VertexNode } from './types.js';
 export declare function box(x: ScalarInput, y: ScalarInput, z: ScalarInput): BoxNode;
 export declare function sphere(radius: ScalarInput): SphereNode;
 export declare function cylinder(radius: ScalarInput, height: ScalarInput): CylinderNode;
@@ -83,4 +83,16 @@ export interface RevolveOptions {
 export declare function revolve(profile: FaceNode, angle?: ScalarInput, options?: RevolveOptions): RevolveNode;
 export declare function compound(children: ReadonlyArray<IRNode>): CompoundNode;
 export declare function instance(source: IRNode, placements: ReadonlyArray<Matrix4x4>, fuse?: boolean): InstanceNode;
+export interface ExtensionOptions {
+    readonly children?: ReadonlyArray<IRNode> | undefined;
+    readonly params?: Readonly<Record<string, ScalarInput>> | undefined;
+    /** Must be JSON-safe; defaults to `null`. */
+    readonly data?: JsonValue | undefined;
+}
+/** A caller-defined operation, materialized at evaluation by the
+ *  `ExtensionEvaluator` registered under `name` in
+ *  `EvaluatorOptions.extensions`. Unlike the other builders this one validates
+ *  eagerly and throws a TypeError: a node whose data cannot be hashed
+ *  canonically has no content address. */
+export declare function extension(name: string, output: OutputKind, options?: ExtensionOptions): ExtensionNode;
 export type { FaceNode, EdgeNode, VertexNode, SolidNode };

package/dist/csg/evaluate.d.ts

@@ -2,7 +2,7 @@ import { Result } from '../core/result.js';
 import { AnyShape, Dimension } from '../core/shapeTypes.js';
 import { ShapeMesh, MeshOptions } from '../topology/meshFns.js';
 import { Env } from './expressions.js';
-import { IRNode } from './types.js';
+import { IRNode, ExtensionEvaluator } from './types.js';
 export interface EvaluatorOptions {
     /** Kernel id to materialize against. Defaults to the currently-active kernel. */
     readonly kernel?: string | undefined;
@@ -30,6 +30,14 @@ export interface EvaluatorOptions {
      * positive integer.
      */
     readonly maxMeshCacheEntries?: number | undefined;
+    /**
+     * Evaluators for `Extension` nodes, keyed by node name. The registry is
+     * copied at construction (the cache key does not include it, so it must not
+     * change under a live cache). An Extension whose name is not registered
+     * evaluates to an Err with code `CSG_EXTENSION_UNKNOWN`. See
+     * {@link ExtensionEvaluator} for the ownership contract.
+     */
+    readonly extensions?: Readonly<Record<string, ExtensionEvaluator>> | undefined;
 }
 export interface StepInfo {
     readonly node: IRNode;
@@ -54,6 +62,7 @@ export declare class Evaluator implements Disposable {
     private readonly maxMeshCacheEntries;
     private readonly meshCache;
     private readonly onStep?;
+    private readonly extensions;
     private hits;
     private misses;
     private evictions;

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

@@ -1,9 +1,10 @@
 import { AnyShape, Dimension } from '../../core/shapeTypes.js';
 import { Result } from '../../core/result.js';
 import { Env } from '../expressions.js';
-import { IRNode } from '../types.js';
+import { ExtensionEvaluator, IRNode } from '../types.js';
 export interface EvalContext {
     readonly env: Env;
     readonly tolerance: number | undefined;
     readonly evalNode: (node: IRNode) => Result<AnyShape<Dimension>>;
+    readonly extensions: ReadonlyMap<string, ExtensionEvaluator>;
 }

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

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

package/dist/csg/hash.d.ts

@@ -5,5 +5,6 @@ export declare function fnvMixString(h: bigint, s: string): bigint;
 export declare function fnvMixNumber(h: bigint, n: number): bigint;
 export declare function fnvMixHash(h: bigint, child: bigint): bigint;
 export declare function fnvMixInt32(h: bigint, n: number): bigint;
+export declare function fnvMixText(h: bigint, s: string): bigint;
 export declare function fnvMixBool(h: bigint, b: boolean): bigint;
 export declare function toHex(h: bigint): string;

package/dist/csg/index.d.ts

@@ -5,9 +5,9 @@
  * parameterize via named expression bindings; evaluate against the active
  * kernel with subtree-level cache reuse for incremental parametric edits.
  */
-export { box, sphere, cylinder, cone, torus, polygon, circle, line, vertex, emptySolid, emptyFace, emptyWire, fuse, cut, intersect, fuseAll, cutAll, translate, rotate, scale, mirror, extrude, revolve, loft, sweep, profile, path, color, fillet, chamfer, shell, compound, instance, type RevolveOptions, type LoftOptions, type SweepNodeOptions, type RotateOptions, type ScaleOptions, type MirrorOptions, } from './builders.js';
+export { box, sphere, cylinder, cone, torus, polygon, circle, line, vertex, emptySolid, emptyFace, emptyWire, fuse, cut, intersect, fuseAll, cutAll, translate, rotate, scale, mirror, extrude, revolve, loft, sweep, profile, path, color, fillet, chamfer, shell, compound, instance, extension, type ExtensionOptions, type RevolveOptions, type LoftOptions, type SweepNodeOptions, type RotateOptions, type ScaleOptions, type MirrorOptions, } from './builders.js';
 export { numLit, vec3Lit, vec2Lit, param, binOp, unaryOp, component, buildVec, add, mul, asScalarExpr, asVec3Expr, asVec2Expr, type Expr, type ExprValue, type Env, type ScalarInput, type Vec3Input, type Vec2Input, type BinaryOp, type UnaryOp, } from './expressions.js';
-export type { IRNode, NodeKind, OutputKind, PrimitiveNode, BooleanNode, TransformIRNode, ExtrudeNode, RevolveNode, LoftNode, SweepNode, ProfileNode, PathNode, ColorNode, FilletNode, ChamferNode, ShellNode, InstanceNode, SolidNode, FaceNode, EdgeNode, VertexNode, AnyNode, } from './types.js';
+export type { IRNode, NodeKind, OutputKind, PrimitiveNode, BooleanNode, TransformIRNode, ExtrudeNode, RevolveNode, LoftNode, SweepNode, ProfileNode, PathNode, ColorNode, FilletNode, ChamferNode, ShellNode, InstanceNode, ExtensionNode, ExtensionEvaluator, ExtensionInput, JsonValue, SolidNode, FaceNode, EdgeNode, VertexNode, AnyNode, } from './types.js';
 export { outputKindOf } from './types.js';
 export { lineTo, arcTo, bezierTo, ellipseArcTo, contour, type Contour, type Segment2D, type SegmentOptions, type EllipseArcOptions, } from './segments.js';
 export { rectangularProfile, circularProfile, iBeamProfile, asymmetricIProfile, lShapeProfile, tShapeProfile, uShapeProfile, zShapeProfile, cShapeProfile, ellipseProfile, trapeziumProfile, rectangleHollowProfile, circleHollowProfile, arbitraryClosedProfile, arbitraryProfileWithVoids, type IBeamParams, type AsymmetricIParams, type LShapeParams, type TShapeParams, type UShapeParams, type ZShapeParams, type CShapeParams, type TrapeziumParams, type RectangleHollowParams, type CircleHollowParams, } from './profiles.js';

package/dist/csg/jsonData.d.ts

@@ -0,0 +1,8 @@
+import { Result } from '../core/result.js';
+import { JsonValue } from './types.js';
+/** Validate `value` as JSON-safe and return its canonical frozen copy, or a
+ *  message naming the first offending path (rooted at `path`). */
+export declare function canonicalJson(value: unknown, path: string): Result<JsonValue, string>;
+/** Type-tagged, length-prefixed Merkle mix of a JSON value; object keys are
+ *  hashed in sorted order, so key order never changes the result. */
+export declare function hashJson(h: bigint, v: JsonValue): bigint;

package/dist/csg/serialize.d.ts

@@ -1,6 +1,6 @@
 import { Result } from '../core/result.js';
 import { IRNode } from './types.js';
-export declare const CSG_VERSION = 8;
+export declare const CSG_VERSION = 9;
 export interface CsgEnvelope {
     readonly csgVersion: number;
     readonly defs?: readonly unknown[];

package/dist/csg/types.d.ts

@@ -2,7 +2,10 @@ import { Expr } from './expressions.js';
 import { Contour, Segment2D } from './segments.js';
 import { EdgeRef, ShapeRef } from '../topology/shapeRef/shapeRefTypes.js';
 import { Matrix4x4 } from '../core/types.js';
+import { AnyShape, Dimension } from '../core/shapeTypes.js';
+import { Result } from '../core/result.js';
 export type OutputKind = 'Solid' | 'Face' | 'Wire' | 'Edge' | 'Vertex' | 'Compound';
+export declare function isOutputKind(v: unknown): v is OutputKind;
 /** Output kinds that have a corresponding empty-shape builder + serializer. */
 export type EmptyOutputKind = 'Solid' | 'Face' | 'Wire';
 export interface IRNodeBase {
@@ -198,10 +201,56 @@ export interface InstanceNode extends IRNodeBase {
     /** Fuse the placed copies into one solid; otherwise a Compound. */
     readonly fuse: boolean;
 }
+/** A value `JSON.stringify` / `JSON.parse` round-trips exactly. */
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+/** An operation the IR has no built-in kind for, materialized by the
+ *  {@link ExtensionEvaluator} registered under `name` in
+ *  `EvaluatorOptions.extensions`. `optimize` treats it as opaque: its
+ *  children and params are optimized, the node itself is never folded. */
+export interface ExtensionNode extends IRNodeBase {
+    readonly kind: 'Extension';
+    readonly name: string;
+    /** Declared at build time for `outputKindOf`; evaluation does not check the
+     *  materialized shape against it. */
+    readonly output: OutputKind;
+    readonly children: readonly IRNode[];
+    /** Scalar inputs, resolved to numbers against the env before the evaluator
+     *  runs, so they take part in param invalidation. */
+    readonly params: Readonly<Record<string, Expr>>;
+    /** Frozen canonical copy of the builder input; neither key order nor `-0`
+     *  changes the hash. */
+    readonly data: JsonValue;
+}
+export interface ExtensionInput {
+    readonly params: Readonly<Record<string, number>>;
+    readonly data: JsonValue;
+    /** The node's children, materialized in order. */
+    readonly children: readonly AnyShape<Dimension>[];
+}
+/**
+ * Materializes an {@link ExtensionNode}; registered by name through
+ * `EvaluatorOptions.extensions` and called under the Evaluator's kernel.
+ *
+ * The Evaluator caches the result by the node's content address, so it must
+ * depend only on `input`.
+ *
+ * Ownership: `children` are borrowed from the Evaluator's cache. Do not
+ * dispose them or keep them past the call (a bounded cache may evict them).
+ * Return either a fresh shape or one of `children` unchanged; the Evaluator
+ * owns and disposes the result, and reference-counts handles so a returned
+ * child is freed once. Never return a handle owned elsewhere, such as a
+ * borrowed sub-shape from `getFaces`.
+ *
+ * Return an `Err` for expected failures; a throw escapes `evaluate()` like a
+ * throw from any built-in evaluator.
+ */
+export type ExtensionEvaluator = (input: ExtensionInput) => Result<AnyShape<Dimension>>;
 export type PrimitiveNode = BoxNode | SphereNode | CylinderNode | ConeNode | TorusNode | PolygonNode | CircleNode | LineNode | VertexLitNode | EmptyNode;
 export type BooleanNode = FuseNode | CutNode | IntersectNode | FuseAllNode | CutAllNode;
 export type TransformIRNode = TranslateNode | RotateNode | ScaleNode | MirrorNode;
-export type IRNode = PrimitiveNode | BooleanNode | TransformIRNode | ExtrudeNode | RevolveNode | LoftNode | SweepNode | ProfileNode | PathNode | ColorNode | FilletNode | ChamferNode | ShellNode | CompoundNode | InstanceNode;
+export type IRNode = PrimitiveNode | BooleanNode | TransformIRNode | ExtrudeNode | RevolveNode | LoftNode | SweepNode | ProfileNode | PathNode | ColorNode | FilletNode | ChamferNode | ShellNode | CompoundNode | InstanceNode | ExtensionNode;
 export type NodeKind = IRNode['kind'];
 export type AnyNode = IRNode;
 /** Nodes that produce a 3D solid. */

package/dist/{curveFns-D-hc0_6t.cjs → curveFns-6-ULFrEB.cjs}

@@ -1,5 +1,5 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-DWezb9DI.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
 //#region src/topology/curveFns.ts
 /**
 * Curve and 1D shape functions — functional replacements for _1DShape/Curve methods.

package/dist/{curveFns-Q-tL9uNq.js → curveFns-KS1BWGhF.js}

@@ -1,5 +1,5 @@
-import { T as isWire, h as disposeResultShape, n as castResultShape, q as getKernel, v as isEdge } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, g as err, l as typeCastError } from "./errors-CTn8i3lY.js";
+import { T as isWire, h as disposeResultShape, n as castResultShape, q as getKernel, v as isEdge } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, g as err, l as typeCastError } from "./errors-Zb3jBa0u.js";
 //#region src/topology/curveFns.ts
 /**
 * Curve and 1D shape functions — functional replacements for _1DShape/Curve methods.

package/dist/{drawFns-CrBzPDfw.js → drawFns-BD5OqwLF.js}

@@ -1,22 +1,22 @@
-import { G as _usingCtx, N as DisposalScope, c as createEdge, l as createFace, p as createWire, q as getKernel } from "./shapeTypes-DVpJHhgk.js";
+import { G as _usingCtx, N as DisposalScope, c as createEdge, l as createFace, p as createWire, q as getKernel } from "./shapeTypes-CqNJoSam.js";
 import { i as wasmIndex, n as bug } from "./bug-BdOHwn_e.js";
-import { P as unwrap, s as safeIndex } from "./errors-CTn8i3lY.js";
-import { s as getEdges } from "./topologyQueryFns-C8Dv3AdW.js";
+import { P as unwrap, s as safeIndex } from "./errors-Zb3jBa0u.js";
+import { s as getEdges } from "./topologyQueryFns-DnfjQgP7.js";
 import { t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
 import { d as vecNormalize, g as vecSub, h as vecScale, m as vecRotate, r as vecCross } from "./vecOps-SKPRvPH-.js";
-import { a as planeToWorld, o as resolvePlane } from "./planeOps-CkpMeheg.js";
-import { d as pointOnSurface, l as normalAt, m as uvBounds, r as faceCenter, u as outerWire, v as copyShape, y as downcast } from "./faceFns-DQ51W4Eg.js";
-import { h as offsetWire2D, i as curveIsClosed, l as curveStartPoint } from "./curveFns-Q-tL9uNq.js";
+import { a as planeToWorld, o as resolvePlane } from "./planeOps-Cxws4Tiu.js";
+import { d as pointOnSurface, l as normalAt, m as uvBounds, r as faceCenter, u as outerWire, v as copyShape, y as downcast } from "./faceFns-CTlJC5IY.js";
+import { h as offsetWire2D, i as curveIsClosed, l as curveStartPoint } from "./curveFns-KS1BWGhF.js";
 import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { c as makeBSplineApproximation, d as makeCircle, f as makeEllipse, m as makeHelix, r as makeFace, s as assembleWire } from "./surfaceBuilders-DW56oYUA.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-BnVu9r7p.js";
-import { b as squareDistance2d, l as add2d, s as PRECISION_OFFSET, v as samePoint$1, x as subtract2d } from "./helpers-Hna44lMW.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-DQaebcah.js";
-import { t as cornerFinder } from "./cornerFinder-D589drKe.js";
-import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-Dp7Bjzvc.js";
-import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-BlTo-FeX.js";
-import { i as projectEdges, t as cameraFromPlane } from "./cameraFns-CcgzxZ-9.js";
+import { c as makeBSplineApproximation, d as makeCircle, f as makeEllipse, m as makeHelix, r as makeFace, s as assembleWire } from "./surfaceBuilders-8nLk2PWk.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-FywUpRiV.js";
+import { b as squareDistance2d, l as add2d, s as PRECISION_OFFSET, v as samePoint$1, x as subtract2d } from "./helpers-BN1mVMuZ.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-rwJjYPzo.js";
+import { t as cornerFinder } from "./cornerFinder-Dlae8IX5.js";
+import { c as roundedRectangleBlueprint, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-D8igCYc9.js";
+import { _ as wrapSketchDataArray, a as Sketch, g as wrapSketchData, i as Sketches, t as textBlueprints } from "./textBlueprints-3jLY3G3u.js";
+import { i as projectEdges, t as cameraFromPlane } from "./cameraFns-Cs6v3bWQ.js";
 //#region src/2d/lib/stitching.ts
 /**
 * Group a flat list of curves into connected chains by matching endpoints.

package/dist/{drawFns-BGW37YtA.cjs → drawFns-Dcvgj3Xg.cjs}

@@ -1,22 +1,22 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-DWezb9DI.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-DbQBANFg.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
-const require_planeOps = require("./planeOps-CpupTCRM.cjs");
-const require_faceFns = require("./faceFns-iyZwpUFe.cjs");
-const require_curveFns = require("./curveFns-D-hc0_6t.cjs");
+const require_planeOps = require("./planeOps-DJuclNxa.cjs");
+const require_faceFns = require("./faceFns-CZeHWke7.cjs");
+const require_curveFns = require("./curveFns-6-ULFrEB.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BujH-WLG.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-DX8NeWqA.cjs");
-const require_helpers = require("./helpers-DzuHzyWn.cjs");
-const require_blueprint = require("./blueprint-cDEPhHO0.cjs");
-const require_cornerFinder = require("./cornerFinder-B-eLajMt.cjs");
-const require_boolean2D = require("./boolean2D-B0jPhKO1.cjs");
-const require_textBlueprints = require("./textBlueprints-BaRZlz2x.cjs");
-const require_cameraFns = require("./cameraFns-DUKz-5_d.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-vYgSvgI6.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-CzKbxeTk.cjs");
+const require_helpers = require("./helpers-NRZVshPb.cjs");
+const require_blueprint = require("./blueprint-Yyoiz-U1.cjs");
+const require_cornerFinder = require("./cornerFinder-Cji_BK-R.cjs");
+const require_boolean2D = require("./boolean2D-BzZ9iBSn.cjs");
+const require_textBlueprints = require("./textBlueprints-BE9lHH5V.cjs");
+const require_cameraFns = require("./cameraFns-RHCb1F1s.cjs");
 //#region src/2d/lib/stitching.ts
 /**
 * Group a flat list of curves into connected chains by matching endpoints.

package/dist/{errors-CTn8i3lY.js → errors-Zb3jBa0u.js}

@@ -190,6 +190,7 @@ var BrepErrorCode = {
 	SOLID_FROM_SHELL_FAILED: "SOLID_FROM_SHELL_FAILED",
 	FIX_SELF_INTERSECTION_FAILED: "FIX_SELF_INTERSECTION_FAILED",
 	MESH_FAILED: "MESH_FAILED",
+	PRINCIPAL_BOX_FAILED: "PRINCIPAL_BOX_FAILED",
 	ELLIPSE_RADII: "ELLIPSE_RADII",
 	FUSE_ALL_EMPTY: "FUSE_ALL_EMPTY",
 	FILLET_NO_EDGES: "FILLET_NO_EDGES",
@@ -215,6 +216,9 @@ var BrepErrorCode = {
 	DRAFT_INVALID_ANGLE: "DRAFT_INVALID_ANGLE",
 	DRAFT_NOT_3D: "DRAFT_NOT_3D",
 	DRAFT_FAILED: "DRAFT_FAILED",
+	CSG_EXTENSION_UNKNOWN: "CSG_EXTENSION_UNKNOWN",
+	NOT_A_SOLID: "NOT_A_SOLID",
+	ZERO_VOLUME: "ZERO_VOLUME",
 	FUSE_NOT_3D: "FUSE_NOT_3D",
 	CUT_NOT_3D: "CUT_NOT_3D",
 	INTERSECT_NOT_3D: "INTERSECT_NOT_3D",

package/dist/{errors-DWezb9DI.cjs → errors-jwhfQJZK.cjs}

@@ -190,6 +190,7 @@ var BrepErrorCode = {
 	SOLID_FROM_SHELL_FAILED: "SOLID_FROM_SHELL_FAILED",
 	FIX_SELF_INTERSECTION_FAILED: "FIX_SELF_INTERSECTION_FAILED",
 	MESH_FAILED: "MESH_FAILED",
+	PRINCIPAL_BOX_FAILED: "PRINCIPAL_BOX_FAILED",
 	ELLIPSE_RADII: "ELLIPSE_RADII",
 	FUSE_ALL_EMPTY: "FUSE_ALL_EMPTY",
 	FILLET_NO_EDGES: "FILLET_NO_EDGES",
@@ -215,6 +216,9 @@ var BrepErrorCode = {
 	DRAFT_INVALID_ANGLE: "DRAFT_INVALID_ANGLE",
 	DRAFT_NOT_3D: "DRAFT_NOT_3D",
 	DRAFT_FAILED: "DRAFT_FAILED",
+	CSG_EXTENSION_UNKNOWN: "CSG_EXTENSION_UNKNOWN",
+	NOT_A_SOLID: "NOT_A_SOLID",
+	ZERO_VOLUME: "ZERO_VOLUME",
 	FUSE_NOT_3D: "FUSE_NOT_3D",
 	CUT_NOT_3D: "CUT_NOT_3D",
 	INTERSECT_NOT_3D: "INTERSECT_NOT_3D",

package/dist/{faceFns-DQ51W4Eg.js → faceFns-CTlJC5IY.js}

@@ -1,6 +1,6 @@
-import { i as castShape, q as getKernel } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, P as unwrap, g as err, l as typeCastError } from "./errors-CTn8i3lY.js";
-import { a as getCachedSurfaceType } from "./topologyQueryFns-C8Dv3AdW.js";
+import { i as castShape, q as getKernel } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, P as unwrap, g as err, l as typeCastError } from "./errors-Zb3jBa0u.js";
+import { a as getCachedSurfaceType } from "./topologyQueryFns-DnfjQgP7.js";
 import { r as toVec3 } from "./types-D24Y27N0.js";
 //#region src/topology/cast.ts
 var TOPO_ENUM = {

package/dist/{faceFns-iyZwpUFe.cjs → faceFns-CZeHWke7.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-DWezb9DI.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-DbQBANFg.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_types = require("./types-KjA8tY4Y.cjs");
 //#region src/topology/cast.ts
 var TOPO_ENUM = {

package/dist/{healingFns-DxEg4twQ.js → healingFns-BDkAwJNy.js}

@@ -1,9 +1,9 @@
-import { C as isSolid, D as getShapeKind, T as isWire, h as disposeResultShape, i as castShape, m as disposeDowncastSource, n as castResultShape, q as getKernel, x as isShape3D, y as isFace } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, b as isErr, d as validationError, g as err, i as kernelError, l as typeCastError, t as BrepErrorCode, x as isOk } from "./errors-CTn8i3lY.js";
-import { c as getFaces, i as getCachedIsValid, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-C8Dv3AdW.js";
+import { C as isSolid, D as getShapeKind, T as isWire, h as disposeResultShape, i as castShape, m as disposeDowncastSource, n as castResultShape, q as getKernel, x as isShape3D, y as isFace } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, b as isErr, d as validationError, g as err, i as kernelError, l as typeCastError, t as BrepErrorCode, x as isOk } from "./errors-Zb3jBa0u.js";
+import { c as getFaces, i as getCachedIsValid, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-DnfjQgP7.js";
 import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
-import { y as downcast } from "./faceFns-DQ51W4Eg.js";
-import { C as propagateAllMetadata, f as cut, h as fuseAll, m as fuse, p as cutAll, x as collectInputFaceHashes } from "./solidBuilders-BmUEjbhs.js";
+import { y as downcast } from "./faceFns-CTlJC5IY.js";
+import { C as propagateAllMetadata, f as cut, h as fuseAll, m as fuse, p as cutAll, x as collectInputFaceHashes } from "./solidBuilders-BwOF7M-p.js";
 import { t as firstOrThrow } from "./arrayAccess-DrUGPADn.js";
 //#region src/topology/threeHelpers.ts
 /**

package/dist/{healingFns-DlyPwsRq.cjs → healingFns-DziPRwmh.cjs}

@@ -1,9 +1,9 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-DWezb9DI.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-DbQBANFg.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
-const require_faceFns = require("./faceFns-iyZwpUFe.cjs");
-const require_solidBuilders = require("./solidBuilders-CZdfdC4S.cjs");
+const require_faceFns = require("./faceFns-CZeHWke7.cjs");
+const require_solidBuilders = require("./solidBuilders-6eLtWBLM.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
 //#region src/topology/threeHelpers.ts
 /**

package/dist/{helpers-Hna44lMW.js → helpers-BN1mVMuZ.js}

@@ -1,12 +1,12 @@
-import { q as getKernel, y as isFace } from "./shapeTypes-DVpJHhgk.js";
-import { E as ok, g as err, o as queryError, x as isOk } from "./errors-CTn8i3lY.js";
-import { c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-C8Dv3AdW.js";
+import { q as getKernel, y as isFace } from "./shapeTypes-CqNJoSam.js";
+import { E as ok, g as err, o as queryError, x as isOk } from "./errors-Zb3jBa0u.js";
+import { c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-DnfjQgP7.js";
 import { t as DEG2RAD } from "./constants-ITRzCnCp.js";
 import { a as vecDot, d as vecNormalize } from "./vecOps-SKPRvPH-.js";
-import { l as normalAt, s as getSurfaceType } from "./faceFns-DQ51W4Eg.js";
-import { a as isSameShape, n as getHashCode } from "./shapeFns-sbLSffyZ.js";
-import { f as getCurveType, i as curveIsClosed, o as curveLength } from "./curveFns-Q-tL9uNq.js";
-import { n as measureArea } from "./measureFns-DnZsoSsE.js";
+import { l as normalAt, s as getSurfaceType } from "./faceFns-CTlJC5IY.js";
+import { a as isSameShape, n as getHashCode } from "./shapeFns--1wNlcc_.js";
+import { f as getCurveType, i as curveIsClosed, o as curveLength } from "./curveFns-KS1BWGhF.js";
+import { n as measureArea } from "./measureFns-CyDVZomf.js";
 //#region src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;

package/dist/{helpers-DzuHzyWn.cjs → helpers-NRZVshPb.cjs}

@@ -1,12 +1,12 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
-const require_errors = require("./errors-DWezb9DI.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-DbQBANFg.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
 const require_constants = require("./constants-BOVyEYGH.cjs");
 const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
-const require_faceFns = require("./faceFns-iyZwpUFe.cjs");
-const require_shapeFns = require("./shapeFns-SdMLvQ7n.cjs");
-const require_curveFns = require("./curveFns-D-hc0_6t.cjs");
-const require_measureFns = require("./measureFns-Czv8iOd1.cjs");
+const require_faceFns = require("./faceFns-CZeHWke7.cjs");
+const require_shapeFns = require("./shapeFns-C2j6oZ2u.cjs");
+const require_curveFns = require("./curveFns-6-ULFrEB.cjs");
+const require_measureFns = require("./measureFns-D_GpQw5z.cjs");
 //#region src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;

package/dist/{importFns-CzX0LzER.js → importFns-0kHGg-b8.js}

@@ -1,8 +1,8 @@
-import { n as castResultShape, q as getKernel } from "./shapeTypes-DVpJHhgk.js";
+import { n as castResultShape, q as getKernel } from "./shapeTypes-CqNJoSam.js";
 import { i as wasmIndex, r as vec3At$1 } from "./bug-BdOHwn_e.js";
-import { E as ok, g as err, r as ioError, t as BrepErrorCode } from "./errors-CTn8i3lY.js";
+import { E as ok, g as err, r as ioError, t as BrepErrorCode } from "./errors-Zb3jBa0u.js";
 import { n as getAtOrThrow } from "./arrayAccess-DrUGPADn.js";
-import { c as make2dBezierCurve, h as make2dThreePointArc, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-DQaebcah.js";
+import { c as make2dBezierCurve, h as make2dThreePointArc, p as make2dSegmentCurve, t as Blueprint } from "./blueprint-rwJjYPzo.js";
 //#region src/io/objExportFns.ts
 /** Read a vec3 from a typed array at the given vertex index. */
 function vec3At(arr, i) {

package/dist/{importFns-BygnKmG8.cjs → importFns-BEi-HsSw.cjs}

@@ -1,8 +1,8 @@
-const require_shapeTypes = require("./shapeTypes-BWsKDxzf.cjs");
+const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
 const require_bug = require("./bug-O02CsAmt.cjs");
-const require_errors = require("./errors-DWezb9DI.cjs");
+const require_errors = require("./errors-jwhfQJZK.cjs");
 const require_arrayAccess = require("./arrayAccess-e4H9cBfh.cjs");
-const require_blueprint = require("./blueprint-cDEPhHO0.cjs");
+const require_blueprint = require("./blueprint-Yyoiz-U1.cjs");
 //#region 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

@@ -131,6 +131,7 @@ export { exportURDF, importURDF, type UrdfExportOptions, type UrdfDocument, } fr
 export { createHistory, addStep, undoLast, findStep, getShape as getHistoryShape, stepCount, stepsFrom, registerShape, createRegistry, registerOperation, replayHistory, replayFrom, modifyStep, serializeHistory, deserializeHistory, type OperationStep, type ModelHistory, type SerializedHistory, type OperationFn, type OperationRegistry as HistoryOperationRegistry, } from './operations/historyFns.js';
 export { measureVolume, measureArea, measureLength, measureDistance, measureDistanceProps, createDistanceQuery, measureVolumeProps, measureSurfaceProps, measureLinearProps, type PhysicalProps, type VolumeProps, type SurfaceProps, type LinearProps, type DistanceProps, measureCurvatureAt, measureCurvatureAtMid, type CurvatureResult, } from './measurement/measureFns.js';
 export { checkInterference, checkAllInterferences, type InterferenceResult, type InterferencePair, } from './measurement/interferenceFns.js';
+export { principalBoundingBox, type PrincipalBoundingBox } from './measurement/principalBoxFns.js';
 export { importSTEP, importSTL, importIGES } from './io/importFns.js';
 export { importDXF } from './io/dxfImportFns.js';
 export { importOBJ } from './io/objImportFns.js';

package/dist/io.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_meshFns = require("./meshFns-82W7072d.cjs");
-const require_importFns = require("./importFns-BygnKmG8.cjs");
+const require_meshFns = require("./meshFns-CAxkaRTm.cjs");
+const require_importFns = require("./importFns-BEi-HsSw.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-DegHraku.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-CzX0LzER.js";
+import { n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-COlno8TY.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-0kHGg-b8.js";
 export { blueprintToDXF, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, importIGES, importSTEP, importSTL, importSVG, importSVGPathD };

package/dist/kernel/interfaces/measureOps.d.ts

@@ -1,4 +1,16 @@
 import { DistanceResult, KernelShape } from '../types.js';
+/** A 3x3 matrix as nine row-major entries. */
+export type Matrix3 = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
 /** All scalar measurements for a shape, computed in bulk. */
 export interface BulkMeasurement {
     volume: number;
@@ -20,6 +32,13 @@ export interface KernelMeasureOps {
         min: [number, number, number];
         max: [number, number, number];
     };
+    /**
+     * Volume matrix of inertia about the center of mass (unit density), in axes
+     * parallel to world X/Y/Z. Products of inertia carry the tensor's negative
+     * sign, so the matrix is symmetric with `[1]==[3]`, `[2]==[6]`, `[5]==[7]`.
+     * Optional: kernels without it cannot answer principal-axes queries.
+     */
+    inertia?(shape: KernelShape): Matrix3;
     /** Minimum distance between two shapes with witness points. */
     distance(shape1: KernelShape, shape2: KernelShape): DistanceResult;
     /** Compute surface curvature at a UV point on a face. */

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

@@ -1,11 +1,12 @@
 import { DistanceResult, KernelShape } from '../types.js';
-import { BulkMeasurement } from '../interfaces/measureOps.js';
+import { BulkMeasurement, Matrix3 } from '../interfaces/measureOps.js';
 import { OcctKernelWasm, OcctWasmModule } from './occtWasmTypes.js';
 export declare function volume(k: OcctKernelWasm, shape: KernelShape): number;
 export declare function area(k: OcctKernelWasm, shape: KernelShape): number;
 export declare function length(k: OcctKernelWasm, shape: KernelShape): number;
 export declare function centerOfMass(k: OcctKernelWasm, shape: KernelShape): [number, number, number];
 export declare function linearCenterOfMass(k: OcctKernelWasm, shape: KernelShape): [number, number, number];
+export declare function inertia(k: OcctKernelWasm, shape: KernelShape): Matrix3;
 export declare function boundingBox(k: OcctKernelWasm, shape: KernelShape): {
     min: [number, number, number];
     max: [number, number, number];