brepjs 20.5.0 → 20.7.0

package/dist/{threadFns-BUQPg_vI.cjs → threadFns-BuRPVenB.cjs}

@@ -1,19 +1,18 @@
-const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
-const require_errors = require("./errors-jwhfQJZK.cjs");
-const require_vecOps = require("./vecOps-CCnJt-yH.cjs");
-const require_faceFns = require("./faceFns-CZeHWke7.cjs");
-const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
-const require_primitiveFns = require("./primitiveFns-ZV3aMbqG.cjs");
-const require_shapeFns = require("./shapeFns-C2j6oZ2u.cjs");
-const require_loftFns = require("./loftFns-DL9UsQhd.cjs");
-const require_refResolveFns = require("./refResolveFns-Ct52Uw7R.cjs");
-//#region src/utils/uuid.ts
+const require_shapeTypes = require("./shapeTypes-D_anqiRe.cjs");
+const require_errors = require("./errors-GVyCnpi0.cjs");
+const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
+const require_faceFns = require("./faceFns-DSRREV5G.cjs");
+const require_solidBuilders = require("./solidBuilders-CUd-korS.cjs");
+const require_primitiveFns = require("./primitiveFns-EtHyTqhw.cjs");
+const require_shapeFns = require("./shapeFns-B54CsPyk.cjs");
+const require_loftFns = require("./loftFns-mkJeOaII.cjs");
+const require_refResolveFns = require("./refResolveFns-D99Vqe7a.cjs");
+// src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {
 	return (String([1e7]) + String(-1e3) + String(-4e3) + String(-8e3) + String(-1e11)).replace(/[018]/g, (c) => (Number(c) ^ crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(1))[0] & 15 >> Number(c) / 4).toString(16));
 }
-//#endregion
-//#region src/operations/exporters.ts
+// src/operations/exporters.ts
 /**
 * Create an XCAF assembly document from a list of shape configurations.
 *
@@ -48,8 +47,7 @@ function createAssembly(shapes = []) {
 	const doc = require_shapeTypes.getKernel().createXCAFDocument(parts);
 	return require_shapeTypes.createKernelHandle(doc);
 }
-//#endregion
-//#region src/utils/quaternion.ts
+// src/utils/quaternion.ts
 function dot(a, b) {
 	return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
 }
@@ -136,8 +134,7 @@ function quatMultiply(a, b) {
 		aw * bz + ax * by - ay * bx + az * bw
 	];
 }
-//#endregion
-//#region src/operations/patternFns.ts
+// src/operations/patternFns.ts
 /**
 * Create a linear pattern of a shape along a direction.
 *
@@ -226,8 +223,7 @@ function gridPattern(shape, directionX, directionY, countX, countY, spacingX, sp
 	if (row !== shape && !passthrough) row[Symbol.dispose]();
 	return out;
 }
-//#endregion
-//#region src/operations/exporterFns.ts
+// src/operations/exporterFns.ts
 /**
 * Functional assembly exporter using branded shape types.
 */
@@ -292,8 +288,7 @@ function exportAssemblySTEP(shapes = [], { unit, modelUnit } = {}) {
 		doc.delete();
 	}
 }
-//#endregion
-//#region src/operations/assemblyFns.ts
+// src/operations/assemblyFns.ts
 /** Create a new assembly node. */
 function createAssemblyNode(name, options = {}) {
 	return {
@@ -360,8 +355,7 @@ function collectShapes(root) {
 	});
 	return shapes;
 }
-//#endregion
-//#region src/operations/jointFns.ts
+// src/operations/jointFns.ts
 var DEG2RAD$2 = Math.PI / 180;
 function clamp(value, min, max) {
 	return Math.min(max, Math.max(min, value));
@@ -687,8 +681,7 @@ function forwardKinematics(assembly, jointValues = {}) {
 function mechanismDOF(assembly) {
 	return collectJoints(assembly).reduce((sum, j) => sum + j.dofs.length, 0);
 }
-//#endregion
-//#region src/operations/ikFns.ts
+// src/operations/ikFns.ts
 var IDENTITY_POSE = {
 	position: [
 		0,
@@ -987,8 +980,7 @@ function jointTrajectory(assembly, from, to, steps) {
 	}
 	return samples;
 }
-//#endregion
-//#region src/operations/dhFns.ts
+// src/operations/dhFns.ts
 /**
 * Denavit-Hartenberg interchange: build a brepjs joint chain from a standard
 * (distal) DH parameter table.
@@ -1064,8 +1056,7 @@ function jointsFromDH(rows, options = {}) {
 		};
 	});
 }
-//#endregion
-//#region src/operations/urdfFns.ts
+// src/operations/urdfFns.ts
 /**
 * URDF interchange: export a brepjs assembly + its joints to URDF, and import a
 * URDF document back into links and joints.
@@ -1241,8 +1232,7 @@ function importURDF(xml) {
 		joints
 	});
 }
-//#endregion
-//#region src/operations/historyFns.ts
+// src/operations/historyFns.ts
 /** Create a new empty history. */
 function createHistory() {
 	return {
@@ -1458,8 +1448,7 @@ function deserializeHistory(data) {
 		shapes
 	});
 }
-//#endregion
-//#region src/operations/threadFns.ts
+// src/operations/threadFns.ts
 /**
 * Build a helical screw-thread ridge by lofting rotated tooth sections.
 *
@@ -1529,7 +1518,6 @@ function thread(options) {
 		_usingCtx$1.d();
 	}
 }
-//#endregion
 Object.defineProperty(exports, "addChild", {
 	enumerable: true,
 	get: function() {

package/dist/{threadFns-3U9x4v_M.js → threadFns-DlL5VnMf.js}

@@ -1,19 +1,18 @@
-import { F as createKernelHandle, G as _usingCtx, N as DisposalScope, n as castResultShape, q as getKernel, x as isShape3D } from "./shapeTypes-CqNJoSam.js";
-import { E as ok, d as validationError, g as err, n as computationError, r as ioError, t as BrepErrorCode, x as isOk } from "./errors-Zb3jBa0u.js";
-import { d as vecNormalize, s as vecIsZero } from "./vecOps-SKPRvPH-.js";
-import { b as fromBREP } from "./faceFns-CTlJC5IY.js";
-import { h as fuseAll } from "./solidBuilders-IstbiWju.js";
-import { E as wire, h as line } from "./primitiveFns-CGJzS4MO.js";
-import { s as toBREP } from "./shapeFns--1wNlcc_.js";
-import { t as loft } from "./loftFns-B5mq1WDh.js";
-import { c as resolveRefParams } from "./refResolveFns-CpVZoeOT.js";
-//#region src/utils/uuid.ts
+import { F as createKernelHandle, G as _usingCtx, N as DisposalScope, n as castResultShape, q as getKernel, x as isShape3D } from "./shapeTypes-CgbUTASh.js";
+import { E as ok, d as validationError, g as err, n as computationError, r as ioError, t as BrepErrorCode, x as isOk } from "./errors-vxP5FT8B.js";
+import { d as vecNormalize, s as vecIsZero } from "./vecOps-S-m9H_fe.js";
+import { b as fromBREP } from "./faceFns-BBk6XKJO.js";
+import { h as fuseAll } from "./solidBuilders-DE_na4G3.js";
+import { E as wire, h as line } from "./primitiveFns-W3RYNJcm.js";
+import { s as toBREP } from "./shapeFns-DB3l3ULC.js";
+import { t as loft } from "./loftFns-B8DSoG-F.js";
+import { c as resolveRefParams } from "./refResolveFns-BkciKtNP.js";
+// src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {
 	return (String([1e7]) + String(-1e3) + String(-4e3) + String(-8e3) + String(-1e11)).replace(/[018]/g, (c) => (Number(c) ^ crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(1))[0] & 15 >> Number(c) / 4).toString(16));
 }
-//#endregion
-//#region src/operations/exporters.ts
+// src/operations/exporters.ts
 /**
 * Create an XCAF assembly document from a list of shape configurations.
 *
@@ -48,8 +47,7 @@ function createAssembly(shapes = []) {
 	const doc = getKernel().createXCAFDocument(parts);
 	return createKernelHandle(doc);
 }
-//#endregion
-//#region src/utils/quaternion.ts
+// src/utils/quaternion.ts
 function dot(a, b) {
 	return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
 }
@@ -136,8 +134,7 @@ function quatMultiply(a, b) {
 		aw * bz + ax * by - ay * bx + az * bw
 	];
 }
-//#endregion
-//#region src/operations/patternFns.ts
+// src/operations/patternFns.ts
 /**
 * Create a linear pattern of a shape along a direction.
 *
@@ -226,8 +223,7 @@ function gridPattern(shape, directionX, directionY, countX, countY, spacingX, sp
 	if (row !== shape && !passthrough) row[Symbol.dispose]();
 	return out;
 }
-//#endregion
-//#region src/operations/exporterFns.ts
+// src/operations/exporterFns.ts
 /**
 * Functional assembly exporter using branded shape types.
 */
@@ -292,8 +288,7 @@ function exportAssemblySTEP(shapes = [], { unit, modelUnit } = {}) {
 		doc.delete();
 	}
 }
-//#endregion
-//#region src/operations/assemblyFns.ts
+// src/operations/assemblyFns.ts
 /** Create a new assembly node. */
 function createAssemblyNode(name, options = {}) {
 	return {
@@ -360,8 +355,7 @@ function collectShapes(root) {
 	});
 	return shapes;
 }
-//#endregion
-//#region src/operations/jointFns.ts
+// src/operations/jointFns.ts
 var DEG2RAD$2 = Math.PI / 180;
 function clamp(value, min, max) {
 	return Math.min(max, Math.max(min, value));
@@ -687,8 +681,7 @@ function forwardKinematics(assembly, jointValues = {}) {
 function mechanismDOF(assembly) {
 	return collectJoints(assembly).reduce((sum, j) => sum + j.dofs.length, 0);
 }
-//#endregion
-//#region src/operations/ikFns.ts
+// src/operations/ikFns.ts
 var IDENTITY_POSE = {
 	position: [
 		0,
@@ -987,8 +980,7 @@ function jointTrajectory(assembly, from, to, steps) {
 	}
 	return samples;
 }
-//#endregion
-//#region src/operations/dhFns.ts
+// src/operations/dhFns.ts
 /**
 * Denavit-Hartenberg interchange: build a brepjs joint chain from a standard
 * (distal) DH parameter table.
@@ -1064,8 +1056,7 @@ function jointsFromDH(rows, options = {}) {
 		};
 	});
 }
-//#endregion
-//#region src/operations/urdfFns.ts
+// src/operations/urdfFns.ts
 /**
 * URDF interchange: export a brepjs assembly + its joints to URDF, and import a
 * URDF document back into links and joints.
@@ -1241,8 +1232,7 @@ function importURDF(xml) {
 		joints
 	});
 }
-//#endregion
-//#region src/operations/historyFns.ts
+// src/operations/historyFns.ts
 /** Create a new empty history. */
 function createHistory() {
 	return {
@@ -1458,8 +1448,7 @@ function deserializeHistory(data) {
 		shapes
 	});
 }
-//#endregion
-//#region src/operations/threadFns.ts
+// src/operations/threadFns.ts
 /**
 * Build a helical screw-thread ridge by lofting rotated tooth sections.
 *
@@ -1529,5 +1518,4 @@ function thread(options) {
 		_usingCtx$1.d();
 	}
 }
-//#endregion
 export { setJointValue as A, walkAssembly as B, cylindricalJoint as C, planarJoint as D, mechanismDOF as E, countNodes as F, quatFromAxisAngle as G, circularPattern as H, createAssemblyNode as I, quatRotate as J, quatFromTo as K, findNode as L, sphericalJoint as M, addChild as N, prismaticJoint as O, collectShapes as P, removeChild as R, addJoint as S, jointTransform as T, gridPattern as U, exportAssemblySTEP as V, linearPattern as W, createAssembly as Y, exportURDF as _, deserializeHistory as a, inverseKinematics as b, modifyStep as c, replayFrom as d, replayHistory as f, undoLast as g, stepsFrom as h, createRegistry as i, setJointValues as j, revoluteJoint as k, registerOperation as l, stepCount as m, addStep as n, findStep as o, serializeHistory as p, quatMultiply as q, createHistory as r, getShape as s, thread as t, registerShape as u, importURDF as v, forwardKinematics as w, jointTrajectory as x, jointsFromDH as y, updateNode as z };

package/dist/topology/modifierFns.d.ts

@@ -36,6 +36,9 @@ export declare function chamfer(shape: ValidSolid, edges: ReadonlyArray<Edge> |
  * @param faces - Faces to remove.
  * @param thickness - Wall thickness.
  * @param tolerance - Shell operation tolerance (default 1e-3).
+ * @returns Err `SHELL_NO_EFFECT` when the wall is too thick and the kernel
+ *   hands back the input, `SHELL_INVALID_RESULT` when the result is not a
+ *   usable hollow body.
  */
 export declare function shell(shape: ValidSolid, faces: ReadonlyArray<Face>, thickness: number, tolerance?: number, { trackEvolution }?: {
     trackEvolution?: boolean | undefined;
@@ -46,6 +49,8 @@ export declare function shell(shape: ValidSolid, faces: ReadonlyArray<Face>, thi
  * @param shape - The shape to offset (must be a 3D shape with faces).
  * @param distance - Offset distance (positive = outward, negative = inward).
  * @param tolerance - Offset tolerance (default 1e-6).
+ * @returns Err `OFFSET_INVALID_RESULT` when the offset consumes the body or
+ *   gives no usable solid.
  */
 export declare function offset(shape: ValidSolid, distance: number, tolerance?: number): Result<ValidSolid>;
 /**

package/dist/topology/thickResultCheck.d.ts

@@ -0,0 +1,18 @@
+import { Shape3D } from '../core/shapeTypes.js';
+import { ValidSolid } from '../core/validityTypes.js';
+import { Result } from '../core/result.js';
+import { ShapeEvolution } from '../kernel/types.js';
+export interface ThickResultSpec {
+    readonly operation: 'shell' | 'offset';
+    /** Signed offset distance; a shell wall grows inward, so pass its thickness negated. */
+    readonly distance: number;
+    readonly tolerance: number;
+    /** Shell openings: their history records the rim, not an offset wall. */
+    readonly openedFaceHashes?: ReadonlySet<number> | undefined;
+}
+/**
+ * Verify a shell/offset result against its input. The wall-distance check
+ * needs `evolution` built from every input face hash and a kernel with native
+ * history; pass `undefined` to skip it.
+ */
+export declare function checkThickResult(input: ValidSolid, result: Shape3D, evolution: ShapeEvolution | undefined, spec: ThickResultSpec): Result<undefined>;

package/dist/topology.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_topologyQueryFns = require("./topologyQueryFns-q2bGyuEV.cjs");
-const require_faceFns = require("./faceFns-CZeHWke7.cjs");
-const require_solidBuilders = require("./solidBuilders-CgicU3le.cjs");
-const require_primitiveFns = require("./primitiveFns-ZV3aMbqG.cjs");
-const require_shapeFns = require("./shapeFns-C2j6oZ2u.cjs");
-const require_curveFns = require("./curveFns-6-ULFrEB.cjs");
-const require_meshFns = require("./meshFns-CAxkaRTm.cjs");
-const require_healingFns = require("./healingFns-DwSpJZfg.cjs");
-const require_adjacencyFns = require("./adjacencyFns-1rxgJ6Hw.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-ENxs8uu2.cjs");
+const require_faceFns = require("./faceFns-DSRREV5G.cjs");
+const require_solidBuilders = require("./solidBuilders-CUd-korS.cjs");
+const require_primitiveFns = require("./primitiveFns-EtHyTqhw.cjs");
+const require_shapeFns = require("./shapeFns-B54CsPyk.cjs");
+const require_curveFns = require("./curveFns-U7srQ3ZA.cjs");
+const require_meshFns = require("./meshFns-W7ZTKqiJ.cjs");
+const require_healingFns = require("./healingFns-C9G3yjOe.cjs");
+const require_adjacencyFns = require("./adjacencyFns-_RTYhwtD.cjs");
 exports.addHoles = require_primitiveFns.addHoles;
 exports.adjacentFaces = require_adjacencyFns.adjacentFaces;
 exports.approximateCurve = require_curveFns.approximateCurve;

package/dist/topology.js

@@ -1,10 +1,10 @@
-import { _ as iterFaces, b as iterVertices, c as getFaces, f as getVertices, g as iterEdges, m as invalidateShapeCache, n as getBounds, p as getWires, s as getEdges, w as vertexPosition, x as iterWires } from "./topologyQueryFns-DnfjQgP7.js";
-import { C as shapeType, S as iterTopo, _ as cast, a as faceOrientation, b as fromBREP, c as innerWires, d as pointOnSurface, f as projectPointOnFace, g as asTopo, h as uvCoordinates, i as faceGeomType, l as normalAt, m as uvBounds, n as faceAxis, o as flipFaceOrientation, r as faceCenter, s as getSurfaceType, t as classifyPointOnFace, u as outerWire, x as isCompSolid, y as downcast } from "./faceFns-CTlJC5IY.js";
-import { h as fuseAll, p as cutAll } from "./solidBuilders-IstbiWju.js";
-import { C as threePointArc, D as wireLoop, E as wire, S as tangentArc, T as vertex, _ as polygon, a as circle, b as sphere, c as cylinder, d as ellipsoid, f as face, g as offsetFace, h as line, i as bsplineApprox, l as ellipse, m as helix, n as bezier, o as compound, p as filledFace, r as box, s as cone, t as addHoles, u as ellipseArc, v as sewShells, w as torus, x as subFace, y as solid } from "./primitiveFns-CGJzS4MO.js";
-import { a as isSameShape, i as isEqualShape, n as getHashCode } from "./shapeFns--1wNlcc_.js";
-import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as getCurveType, h as offsetWire2D, i as curveIsClosed, l as curveStartPoint, m as interpolateCurve, n as curveAxis, o as curveLength, p as getOrientation, r as curveEndPoint, s as curvePeriod, t as approximateCurve, u as curveTangentAt } from "./curveFns-KS1BWGhF.js";
-import { d as clearMeshCache, f as createMeshCache, n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-COlno8TY.js";
-import { A as toBufferGeometryData, P as toLineGeometryData, S as chamferDistAngle, _ as checkBoolean, a as healFace, b as getNurbsCurveData, d as chamferWithEvolution, f as cutWithEvolution, g as shellWithEvolution, h as intersectWithEvolution, j as toGroupedBufferGeometryData, k as variableFillet, l as solidFromShell, m as fuseWithEvolution, n as fixSelfIntersection, o as healSolid, p as filletWithEvolution, r as fixShape, s as healWire, t as autoHeal, u as positionOnCurve, v as cutAllBisect, x as getNurbsSurfaceData, y as fuseAllBisect } from "./healingFns-Ct3gEMvk.js";
-import { i as facesOfEdge, l as wiresOfFace, n as adjacentFaces, o as sharedEdges, r as edgesOfFace, s as verticesOfEdge } from "./adjacencyFns-DeyXahej.js";
+import { _ as iterFaces, b as iterVertices, c as getFaces, f as getVertices, g as iterEdges, m as invalidateShapeCache, n as getBounds, p as getWires, s as getEdges, w as vertexPosition, x as iterWires } from "./topologyQueryFns-6M_dbT1R.js";
+import { C as shapeType, S as iterTopo, _ as cast, a as faceOrientation, b as fromBREP, c as innerWires, d as pointOnSurface, f as projectPointOnFace, g as asTopo, h as uvCoordinates, i as faceGeomType, l as normalAt, m as uvBounds, n as faceAxis, o as flipFaceOrientation, r as faceCenter, s as getSurfaceType, t as classifyPointOnFace, u as outerWire, x as isCompSolid, y as downcast } from "./faceFns-BBk6XKJO.js";
+import { h as fuseAll, p as cutAll } from "./solidBuilders-DE_na4G3.js";
+import { C as threePointArc, D as wireLoop, E as wire, S as tangentArc, T as vertex, _ as polygon, a as circle, b as sphere, c as cylinder, d as ellipsoid, f as face, g as offsetFace, h as line, i as bsplineApprox, l as ellipse, m as helix, n as bezier, o as compound, p as filledFace, r as box, s as cone, t as addHoles, u as ellipseArc, v as sewShells, w as torus, x as subFace, y as solid } from "./primitiveFns-W3RYNJcm.js";
+import { a as isSameShape, i as isEqualShape, n as getHashCode } from "./shapeFns-DB3l3ULC.js";
+import { a as curveIsPeriodic, c as curvePointAt, d as flipOrientation, f as getCurveType, h as offsetWire2D, i as curveIsClosed, l as curveStartPoint, m as interpolateCurve, n as curveAxis, o as curveLength, p as getOrientation, r as curveEndPoint, s as curvePeriod, t as approximateCurve, u as curveTangentAt } from "./curveFns-CkA2WJP2.js";
+import { d as clearMeshCache, f as createMeshCache, n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-CgbT3uuO.js";
+import { A as toBufferGeometryData, P as toLineGeometryData, S as chamferDistAngle, _ as checkBoolean, a as healFace, b as getNurbsCurveData, d as chamferWithEvolution, f as cutWithEvolution, g as shellWithEvolution, h as intersectWithEvolution, j as toGroupedBufferGeometryData, k as variableFillet, l as solidFromShell, m as fuseWithEvolution, n as fixSelfIntersection, o as healSolid, p as filletWithEvolution, r as fixShape, s as healWire, t as autoHeal, u as positionOnCurve, v as cutAllBisect, x as getNurbsSurfaceData, y as fuseAllBisect } from "./healingFns-CEr0afli.js";
+import { i as facesOfEdge, l as wiresOfFace, n as adjacentFaces, o as sharedEdges, r as edgesOfFace, s as verticesOfEdge } from "./adjacencyFns-BgJQQjdt.js";
 export { addHoles, adjacentFaces, approximateCurve, asTopo, autoHeal, bezier, box, bsplineApprox, cast, chamferDistAngle as chamferDistAngleShape, chamferWithEvolution, checkBoolean, circle, classifyPointOnFace, clearMeshCache, compound, cone, createMeshCache, curveAxis, curveEndPoint, curveIsClosed, curveIsPeriodic, curveLength, curvePeriod, curvePointAt, curveStartPoint, curveTangentAt, cutAll, cutAllBisect, cutWithEvolution, cylinder, fromBREP as deserializeShape, downcast, edgesOfFace, ellipse, ellipseArc, ellipsoid, exportIGES, exportSTEP, exportSTL, face, faceAxis, faceCenter, faceGeomType, faceOrientation, facesOfEdge, filledFace, filletWithEvolution, fixSelfIntersection, fixShape, flipFaceOrientation, flipOrientation, fuseAll, fuseAllBisect, fuseWithEvolution, getBounds, getCurveType, getEdges, getFaces, getHashCode, getNurbsCurveData, getNurbsSurfaceData, getOrientation, getSurfaceType, getVertices, getWires, healFace, healSolid, healWire, helix, innerWires, interpolateCurve, intersectWithEvolution, invalidateShapeCache, isCompSolid, isEqualShape, isSameShape, iterEdges, iterFaces, iterTopo, iterVertices, iterWires, line, normalAt, offsetFace, offsetWire2D, outerWire, pointOnSurface, polygon, positionOnCurve, projectPointOnFace, sewShells, shapeType, sharedEdges, shellWithEvolution, solid, solidFromShell, sphere, subFace, tangentArc, threePointArc, toBufferGeometryData, toGroupedBufferGeometryData, toLineGeometryData, torus, uvBounds, uvCoordinates, variableFillet, vertex, vertexPosition, verticesOfEdge, wire, wireLoop, wiresOfFace };

package/dist/{topologyQueryFns-DnfjQgP7.js → topologyQueryFns-6M_dbT1R.js}

@@ -1,7 +1,7 @@
-import { G as _usingCtx, N as DisposalScope, O as getOrQueryType, n as castResultShape, q as getKernel, r as castResultShapeWithKnownType } from "./shapeTypes-CqNJoSam.js";
-import { E as ok, g as err } from "./errors-Zb3jBa0u.js";
-import { n as HASH_CODE_MAX } from "./constants-ITRzCnCp.js";
-//#region src/core/kernelErrorTranslation.ts
+import { G as _usingCtx, N as DisposalScope, O as getOrQueryType, n as castResultShape, q as getKernel, r as castResultShapeWithKnownType } from "./shapeTypes-CgbUTASh.js";
+import { E as ok, g as err } from "./errors-vxP5FT8B.js";
+import { n as HASH_CODE_MAX } from "./constants-iraOnb2p.js";
+// src/core/kernelErrorTranslation.ts
 /**
 * Kernel error translation — maps cryptic kernel messages to user-friendly explanations.
 *
@@ -74,6 +74,9 @@ var ERROR_CODE_SUGGESTIONS = {
 	CHAMFER_NOT_3D: "The chamfer distance may be too large. Try a smaller distance or check edge geometry.",
 	SHELL_NOT_3D: "The shell thickness may be too large for the shape. Try reducing thickness or removing problematic faces.",
 	OFFSET_NOT_3D: "The offset distance may be too large for the shape geometry. Try a smaller distance.",
+	SHELL_NO_EFFECT: "The wall is too thick for this body. Use a wall thinner than half the narrowest part of the shape.",
+	SHELL_INVALID_RESULT: "The wall is too thick for this body or one of its curved faces. Use a wall thinner than half the narrowest part and smaller than the tightest convex radius.",
+	OFFSET_INVALID_RESULT: "The offset is too large for this body. An inward offset must stay below half the narrowest part and the tightest convex radius.",
 	DRAFT_FAILED: "The draft angle may be too large or the selected faces incompatible. Try a smaller angle or different faces."
 };
 /** Look up an actionable suggestion for a given error code. */
@@ -91,8 +94,7 @@ function translateKernelError(kernelMessage) {
 	for (const { pattern, translation } of kernel_ERROR_PATTERNS) if (pattern.test(kernelMessage)) return `${translation} (kernel: ${kernelMessage})`;
 	return kernelMessage;
 }
-//#endregion
-//#region src/core/kernelCall.ts
+// src/core/kernelCall.ts
 function buildError(kind, code, message, cause, suggestion) {
 	const base = {
 		kind,
@@ -181,8 +183,7 @@ function kernelCallScoped(fn, code, message, kind = "KERNEL_OPERATION") {
 		_usingCtx$1.d();
 	}
 }
-//#endregion
-//#region src/topology/topologyQueryFns.ts
+// src/topology/topologyQueryFns.ts
 /**
 * Topology query functions — extract sub-shapes, compute bounds, and
 * describe shape topology. All results are lazily cached per shape.
@@ -428,5 +429,4 @@ function describe(shape) {
 function vertexPosition(vertex) {
 	return getKernel().vertexPosition(vertex.wrapped);
 }
-//#endregion
-export { subShapeHashes as C, kernelCallScoped as D, kernelCallRaw as E, subShapeCount as S, kernelCall as T, iterFaces as _, getCachedSurfaceType as a, iterVertices as b, getFaces as c, getSolids as d, getVertices as f, iterEdges as g, iterCompSolids as h, getCachedIsValid as i, getOrCreateCache as l, invalidateShapeCache as m, getBounds as n, getCompSolids as o, getWires as p, getCacheEntry as r, getEdges as s, describe as t, getShells as u, iterShells as v, vertexPosition as w, iterWires as x, iterSolids as y };
+export { subShapeHashes as C, kernelCallScoped as D, kernelCallRaw as E, getSuggestionForCode as O, subShapeCount as S, kernelCall as T, iterFaces as _, getCachedSurfaceType as a, iterVertices as b, getFaces as c, getSolids as d, getVertices as f, iterEdges as g, iterCompSolids as h, getCachedIsValid as i, getOrCreateCache as l, invalidateShapeCache as m, getBounds as n, getCompSolids as o, getWires as p, getCacheEntry as r, getEdges as s, describe as t, getShells as u, iterShells as v, vertexPosition as w, iterWires as x, iterSolids as y };

package/dist/{topologyQueryFns-q2bGyuEV.cjs → topologyQueryFns-ENxs8uu2.cjs}

@@ -1,7 +1,7 @@
-const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
-const require_errors = require("./errors-jwhfQJZK.cjs");
-const require_constants = require("./constants-BOVyEYGH.cjs");
-//#region src/core/kernelErrorTranslation.ts
+const require_shapeTypes = require("./shapeTypes-D_anqiRe.cjs");
+const require_errors = require("./errors-GVyCnpi0.cjs");
+const require_constants = require("./constants-oee0S_x6.cjs");
+// src/core/kernelErrorTranslation.ts
 /**
 * Kernel error translation — maps cryptic kernel messages to user-friendly explanations.
 *
@@ -74,6 +74,9 @@ var ERROR_CODE_SUGGESTIONS = {
 	CHAMFER_NOT_3D: "The chamfer distance may be too large. Try a smaller distance or check edge geometry.",
 	SHELL_NOT_3D: "The shell thickness may be too large for the shape. Try reducing thickness or removing problematic faces.",
 	OFFSET_NOT_3D: "The offset distance may be too large for the shape geometry. Try a smaller distance.",
+	SHELL_NO_EFFECT: "The wall is too thick for this body. Use a wall thinner than half the narrowest part of the shape.",
+	SHELL_INVALID_RESULT: "The wall is too thick for this body or one of its curved faces. Use a wall thinner than half the narrowest part and smaller than the tightest convex radius.",
+	OFFSET_INVALID_RESULT: "The offset is too large for this body. An inward offset must stay below half the narrowest part and the tightest convex radius.",
 	DRAFT_FAILED: "The draft angle may be too large or the selected faces incompatible. Try a smaller angle or different faces."
 };
 /** Look up an actionable suggestion for a given error code. */
@@ -91,8 +94,7 @@ function translateKernelError(kernelMessage) {
 	for (const { pattern, translation } of kernel_ERROR_PATTERNS) if (pattern.test(kernelMessage)) return `${translation} (kernel: ${kernelMessage})`;
 	return kernelMessage;
 }
-//#endregion
-//#region src/core/kernelCall.ts
+// src/core/kernelCall.ts
 function buildError(kind, code, message, cause, suggestion) {
 	const base = {
 		kind,
@@ -181,8 +183,7 @@ function kernelCallScoped(fn, code, message, kind = "KERNEL_OPERATION") {
 		_usingCtx$1.d();
 	}
 }
-//#endregion
-//#region src/topology/topologyQueryFns.ts
+// src/topology/topologyQueryFns.ts
 /**
 * Topology query functions — extract sub-shapes, compute bounds, and
 * describe shape topology. All results are lazily cached per shape.
@@ -428,7 +429,6 @@ function describe(shape) {
 function vertexPosition(vertex) {
 	return require_shapeTypes.getKernel().vertexPosition(vertex.wrapped);
 }
-//#endregion
 Object.defineProperty(exports, "describe", {
 	enumerable: true,
 	get: function() {
@@ -495,6 +495,12 @@ Object.defineProperty(exports, "getSolids", {
 		return getSolids;
 	}
 });
+Object.defineProperty(exports, "getSuggestionForCode", {
+	enumerable: true,
+	get: function() {
+		return getSuggestionForCode;
+	}
+});
 Object.defineProperty(exports, "getVertices", {
 	enumerable: true,
 	get: function() {

package/dist/{types-D24Y27N0.js → types-CKXsIm9-.js}

@@ -1,4 +1,4 @@
-//#region src/core/types.ts
+// src/core/types.ts
 /** Normalize any point input to Vec3 */
 function toVec3(p) {
 	if (p.length === 2) return [
@@ -46,5 +46,4 @@ function resolveDirection(d) {
 	}
 	return d;
 }
-//#endregion
 export { toVec2 as n, toVec3 as r, resolveDirection as t };

package/dist/{types-KjA8tY4Y.cjs → types-CjF9Rofr.cjs}

@@ -1,4 +1,4 @@
-//#region src/core/types.ts
+// src/core/types.ts
 /** Normalize any point input to Vec3 */
 function toVec3(p) {
 	if (p.length === 2) return [
@@ -46,7 +46,6 @@ function resolveDirection(d) {
 	}
 	return d;
 }
-//#endregion
 Object.defineProperty(exports, "resolveDirection", {
 	enumerable: true,
 	get: function() {

package/dist/{validityTypes-r0A2YdNq.cjs → validityTypes-BPamqRZ8.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-DH2ShBU_.cjs");
-const require_errors = require("./errors-jwhfQJZK.cjs");
-//#region src/core/validityTypes.ts
+const require_shapeTypes = require("./shapeTypes-D_anqiRe.cjs");
+const require_errors = require("./errors-GVyCnpi0.cjs");
+// src/core/validityTypes.ts
 /**
 * Type guard — check if a wire is closed (forms a loop).
 * Uses the kernel's `curveIsClosed` to verify at runtime.
@@ -125,7 +125,6 @@ function planarWire(wire) {
 	if (isPlanarWire(wire)) return require_errors.ok(wire);
 	return require_errors.err("Wire is not planar: edges do not lie in a common plane");
 }
-//#endregion
 Object.defineProperty(exports, "closedWire", {
 	enumerable: true,
 	get: function() {

package/dist/{validityTypes-t7JpS0Ki.js → validityTypes-BTuI0vcR.js}

@@ -1,6 +1,6 @@
-import { q as getKernel } from "./shapeTypes-CqNJoSam.js";
-import { E as ok, g as err } from "./errors-Zb3jBa0u.js";
-//#region src/core/validityTypes.ts
+import { q as getKernel } from "./shapeTypes-CgbUTASh.js";
+import { E as ok, g as err } from "./errors-vxP5FT8B.js";
+// src/core/validityTypes.ts
 /**
 * Type guard — check if a wire is closed (forms a loop).
 * Uses the kernel's `curveIsClosed` to verify at runtime.
@@ -125,5 +125,4 @@ function planarWire(wire) {
 	if (isPlanarWire(wire)) return ok(wire);
 	return err("Wire is not planar: edges do not lie in a common plane");
 }
-//#endregion
 export { isPlanarFace as a, manifoldShell as c, planarWire as d, validSolid as f, isOrientedFace as i, orientedFace as l, isClosedWire as n, isPlanarWire as o, isManifoldShell as r, isValidSolid as s, closedWire as t, planarFace as u };

package/dist/{vecOps-CCnJt-yH.cjs → vecOps-CrGEPPQM.cjs}

@@ -1,4 +1,4 @@
-//#region src/core/vecOps.ts
+// src/core/vecOps.ts
 /** Add two 3D vectors component-wise. */
 function vecAdd(a, b) {
 	return [
@@ -125,7 +125,6 @@ var round3 = (v) => Math.round(v * 1e3) / 1e3;
 function vecRepr(v) {
 	return `x: ${round3(v[0])}, y: ${round3(v[1])}, z: ${round3(v[2])}`;
 }
-//#endregion
 Object.defineProperty(exports, "vecAdd", {
 	enumerable: true,
 	get: function() {

package/dist/{vecOps-SKPRvPH-.js → vecOps-S-m9H_fe.js}

@@ -1,4 +1,4 @@
-//#region src/core/vecOps.ts
+// src/core/vecOps.ts
 /** Add two 3D vectors component-wise. */
 function vecAdd(a, b) {
 	return [
@@ -125,5 +125,4 @@ var round3 = (v) => Math.round(v * 1e3) / 1e3;
 function vecRepr(v) {
 	return `x: ${round3(v[0])}, y: ${round3(v[1])}, z: ${round3(v[2])}`;
 }
-//#endregion
 export { vecDot as a, vecLength as c, vecNormalize as d, vecProjectToPlane as f, vecSub as g, vecScale as h, vecDistance as i, vecLengthSq as l, vecRotate as m, vecAngle as n, vecEquals as o, vecRepr as p, vecCross as r, vecIsZero as s, vecAdd as t, vecNegate as u };

package/dist/vectors.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-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-DJuclNxa.cjs");
+const require_constants = require("./constants-oee0S_x6.cjs");
+const require_types = require("./types-CjF9Rofr.cjs");
+const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
+const require_planeOps = require("./planeOps-C9d2Y56B.cjs");
 exports.DEG2RAD = require_constants.DEG2RAD;
 exports.RAD2DEG = require_constants.RAD2DEG;
 exports.createNamedPlane = require_planeOps.createNamedPlane;

package/dist/vectors.js

@@ -1,5 +1,5 @@
-import { 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-Cxws4Tiu.js";
+import { r as RAD2DEG, t as DEG2RAD } from "./constants-iraOnb2p.js";
+import { n as toVec2, r as toVec3, t as resolveDirection } from "./types-CKXsIm9-.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-S-m9H_fe.js";
+import { i as pivotPlane, n as createPlane, o as resolvePlane, s as translatePlane, t as createNamedPlane } from "./planeOps-Dp0YvuFE.js";
 export { DEG2RAD, RAD2DEG, createNamedPlane, createPlane, pivotPlane, resolveDirection, resolvePlane, toVec2, toVec3, translatePlane, vecAdd, vecAngle, vecCross, vecDistance, vecDot, vecEquals, vecIsZero, vecLength, vecLengthSq, vecNegate, vecNormalize, vecProjectToPlane, vecRepr, vecRotate, vecScale, vecSub };

package/dist/worker.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_workerPool = require("./workerPool-D30NsiIW.cjs");
+const require_workerPool = require("./workerPool-D5tiNXrI.cjs");
 exports.createOperationRegistry = require_workerPool.createOperationRegistry;
 exports.createTaskQueue = require_workerPool.createTaskQueue;
 exports.createWorkerClient = require_workerPool.createWorkerClient;

package/dist/worker.js

@@ -1,2 +1 @@
-import { _ as isSuccessResponse, a as createWorkerClient, c as enqueueTask, d as rejectAll, f as isBatchRequest, g as isOperationRequest, h as isInitRequest, i as registerHandler, l as isEmpty, m as isErrorResponse, n as createOperationRegistry, o as createTaskQueue, p as isDisposeRequest, r as createWorkerHandler, s as dequeueTask, t as createWorkerPool, u as pendingCount } from "./workerPool-XcYX2UZ0.js";
-export { createOperationRegistry, createTaskQueue, createWorkerClient, createWorkerHandler, createWorkerPool, dequeueTask, enqueueTask, isBatchRequest, isDisposeRequest, isErrorResponse, isInitRequest, isOperationRequest, isEmpty as isQueueEmpty, isSuccessResponse, pendingCount, registerHandler, rejectAll };
+export { n as createOperationRegistry, o as createTaskQueue, a as createWorkerClient, r as createWorkerHandler, t as createWorkerPool, s as dequeueTask, c as enqueueTask, f as isBatchRequest, p as isDisposeRequest, m as isErrorResponse, h as isInitRequest, g as isOperationRequest, l as isQueueEmpty, _ as isSuccessResponse, u as pendingCount, i as registerHandler, d as rejectAll } from "./workerPool-Bc5hmJc4.js";