brepjs 20.6.0 → 20.7.0

package/dist/{drawFns-CH0q-0JP.cjs → drawFns-DlCxozRP.cjs}

@@ -1,22 +1,22 @@
-const require_shapeTypes = require("./shapeTypes-CkxvJRpq.cjs");
+const require_shapeTypes = require("./shapeTypes-D_anqiRe.cjs");
 const require_bug = require("./bug-CBcpIPuf.cjs");
-const require_errors = require("./errors-DoMAp7mQ.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-C6HwYYpi.cjs");
+const require_errors = require("./errors-GVyCnpi0.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-ENxs8uu2.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-BDt05NAD.cjs");
-const require_faceFns = require("./faceFns-B8ctN5Te.cjs");
-const require_curveFns = require("./curveFns-Cxq5lFqU.cjs");
+const require_planeOps = require("./planeOps-C9d2Y56B.cjs");
+const require_faceFns = require("./faceFns-DSRREV5G.cjs");
+const require_curveFns = require("./curveFns-U7srQ3ZA.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-CTk2lGlw.cjs");
-const require_blueprintSketcher = require("./blueprintSketcher-pVbM0BHf.cjs");
-const require_helpers = require("./helpers-BhHbDu6-.cjs");
-const require_blueprint = require("./blueprint-Ci2Mw5v-.cjs");
-const require_cornerFinder = require("./cornerFinder-DshfhGHG.cjs");
-const require_boolean2D = require("./boolean2D-Dq29HCr9.cjs");
-const require_textBlueprints = require("./textBlueprints-DbEWBdhF.cjs");
-const require_cameraFns = require("./cameraFns-BMXugx7m.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-DOn2jWkh.cjs");
+const require_blueprintSketcher = require("./blueprintSketcher-CSDqr27-.cjs");
+const require_helpers = require("./helpers-JuPoaP_b.cjs");
+const require_blueprint = require("./blueprint-wq2TU1XP.cjs");
+const require_cornerFinder = require("./cornerFinder-DJWo6h1Z.cjs");
+const require_boolean2D = require("./boolean2D-BkgOjMRt.cjs");
+const require_textBlueprints = require("./textBlueprints-BQ60Rc96.cjs");
+const require_cameraFns = require("./cameraFns-CKUN90f_.cjs");
 // src/2d/lib/stitching.ts
 /**
 * Group a flat list of curves into connected chains by matching endpoints.

package/dist/{errors-DoMAp7mQ.cjs → errors-GVyCnpi0.cjs}

@@ -232,7 +232,10 @@ var BrepErrorCode = {
 	CHAMFER_ANGLE_FAILED: "CHAMFER_ANGLE_FAILED",
 	CSG_NOT_3D: "CSG_NOT_3D",
 	SHELL_NOT_3D: "SHELL_NOT_3D",
+	SHELL_NO_EFFECT: "SHELL_NO_EFFECT",
+	SHELL_INVALID_RESULT: "SHELL_INVALID_RESULT",
 	OFFSET_NOT_3D: "OFFSET_NOT_3D",
+	OFFSET_INVALID_RESULT: "OFFSET_INVALID_RESULT",
 	NULL_SHAPE: "NULL_SHAPE",
 	NO_WRAPPER: "NO_WRAPPER",
 	WELD_NOT_SHELL: "WELD_NOT_SHELL",

package/dist/{errors-B3espUT6.js → errors-vxP5FT8B.js}

@@ -232,7 +232,10 @@ var BrepErrorCode = {
 	CHAMFER_ANGLE_FAILED: "CHAMFER_ANGLE_FAILED",
 	CSG_NOT_3D: "CSG_NOT_3D",
 	SHELL_NOT_3D: "SHELL_NOT_3D",
+	SHELL_NO_EFFECT: "SHELL_NO_EFFECT",
+	SHELL_INVALID_RESULT: "SHELL_INVALID_RESULT",
 	OFFSET_NOT_3D: "OFFSET_NOT_3D",
+	OFFSET_INVALID_RESULT: "OFFSET_INVALID_RESULT",
 	NULL_SHAPE: "NULL_SHAPE",
 	NO_WRAPPER: "NO_WRAPPER",
 	WELD_NOT_SHELL: "WELD_NOT_SHELL",

package/dist/{faceFns-C-wc4fX-.js → faceFns-BBk6XKJO.js}

@@ -1,6 +1,6 @@
-import { i as castShape, q as getKernel } from "./shapeTypes-Bva18qvE.js";
-import { E as ok, P as unwrap, g as err, l as typeCastError } from "./errors-B3espUT6.js";
-import { a as getCachedSurfaceType } from "./topologyQueryFns-CY6YiGsk.js";
+import { i as castShape, q as getKernel } from "./shapeTypes-CgbUTASh.js";
+import { E as ok, P as unwrap, g as err, l as typeCastError } from "./errors-vxP5FT8B.js";
+import { a as getCachedSurfaceType } from "./topologyQueryFns-6M_dbT1R.js";
 import { r as toVec3 } from "./types-CKXsIm9-.js";
 // src/topology/cast.ts
 var TOPO_ENUM = {

package/dist/{faceFns-B8ctN5Te.cjs → faceFns-DSRREV5G.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-CkxvJRpq.cjs");
-const require_errors = require("./errors-DoMAp7mQ.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-C6HwYYpi.cjs");
+const require_shapeTypes = require("./shapeTypes-D_anqiRe.cjs");
+const require_errors = require("./errors-GVyCnpi0.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-ENxs8uu2.cjs");
 const require_types = require("./types-CjF9Rofr.cjs");
 // src/topology/cast.ts
 var TOPO_ENUM = {

package/dist/{healingFns-D3mNy1rp.cjs → healingFns-C9G3yjOe.cjs}

@@ -1,9 +1,9 @@
-const require_shapeTypes = require("./shapeTypes-CkxvJRpq.cjs");
-const require_errors = require("./errors-DoMAp7mQ.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-C6HwYYpi.cjs");
+const require_shapeTypes = require("./shapeTypes-D_anqiRe.cjs");
+const require_errors = require("./errors-GVyCnpi0.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-ENxs8uu2.cjs");
 const require_constants = require("./constants-oee0S_x6.cjs");
-const require_faceFns = require("./faceFns-B8ctN5Te.cjs");
-const require_solidBuilders = require("./solidBuilders-BFEnqrU0.cjs");
+const require_faceFns = require("./faceFns-DSRREV5G.cjs");
+const require_solidBuilders = require("./solidBuilders-CUd-korS.cjs");
 const require_arrayAccess = require("./arrayAccess-DpJYARwv.cjs");
 // src/topology/threeHelpers.ts
 /**
@@ -106,6 +106,99 @@ function toLODGeometryLevels(lods, options) {
 		distance: distances?.[idx] ?? (last - idx) * step
 	}));
 }
+// src/topology/thickResultCheck.ts
+var UNCHANGED_VOLUME_REL_TOL = 1e-7;
+var WALL_DISTANCE_REL_TOL = .001;
+function facesByHash(shape) {
+	const kernel = require_shapeTypes.getKernel();
+	const byHash = /* @__PURE__ */ new Map();
+	for (const face of require_topologyQueryFns.getFaces(shape)) byHash.set(kernel.hashCode(face.wrapped, require_constants.HASH_CODE_MAX), face);
+	return byHash;
+}
+function volumeFailure(distance, input, result) {
+	if (Math.abs(result.volume - input.volume) <= UNCHANGED_VOLUME_REL_TOL * Math.abs(input.volume) && result.faceCount === input.faceCount) return "unchanged";
+	if (result.volume <= 0) return "volume";
+	return result.volume > input.volume === distance > 0 ? void 0 : "volume";
+}
+/** Distance from the middle of a generated wall's surface to its source face. */
+function wallGap(source, generated) {
+	const kernel = require_shapeTypes.getKernel();
+	const uv = kernel.uvBounds(generated.wrapped);
+	const p = kernel.pointOnSurface(generated.wrapped, (uv.uMin + uv.uMax) / 2, (uv.vMin + uv.vMax) / 2);
+	const q = kernel.projectPointOnFace(source.wrapped, p);
+	return Math.hypot(p[0] - q[0], p[1] - q[1], p[2] - q[2]);
+}
+function worstWallDeviation(input, result, evolution, spec) {
+	if (evolution.generated.size === 0) return 0;
+	const sources = facesByHash(input);
+	const produced = facesByHash(result);
+	const wall = Math.abs(spec.distance);
+	let worst = 0;
+	for (const [sourceHash, generatedHashes] of evolution.generated) {
+		if (spec.openedFaceHashes?.has(sourceHash)) continue;
+		const source = sources.get(sourceHash);
+		if (!source) continue;
+		for (const hash of generatedHashes) {
+			const face = produced.get(hash);
+			if (!face) continue;
+			worst = Math.max(worst, Math.abs(wallGap(source, face) - wall));
+		}
+	}
+	return worst;
+}
+function failure(spec, reason, metadata) {
+	const wall = Math.abs(spec.distance);
+	const isShell = spec.operation === "shell";
+	if (isShell && reason === "unchanged") {
+		const code = require_errors.BrepErrorCode.SHELL_NO_EFFECT;
+		return require_errors.err(require_errors.kernelError(code, `Shell left the solid unchanged: a ${wall} wall is too thick for this body`, void 0, {
+			operation: "shell",
+			reason,
+			thickness: wall,
+			...metadata
+		}, require_topologyQueryFns.getSuggestionForCode(code)));
+	}
+	const code = isShell ? require_errors.BrepErrorCode.SHELL_INVALID_RESULT : require_errors.BrepErrorCode.OFFSET_INVALID_RESULT;
+	const what = isShell ? `a ${wall} wall` : `an offset of ${spec.distance}`;
+	return require_errors.err(require_errors.kernelError(code, `${spec.operation} gave no usable solid (${reason}): ${what} is too large for this body`, void 0, {
+		operation: spec.operation,
+		reason,
+		distance: spec.distance,
+		...metadata
+	}, require_topologyQueryFns.getSuggestionForCode(code)));
+}
+/**
+* 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.
+*/
+function checkThickResult(input, result, evolution, spec) {
+	const kernel = require_shapeTypes.getKernel();
+	if (kernel.isNull(result.wrapped)) return failure(spec, "empty", {});
+	const inputVolume = kernel.volume(input.wrapped);
+	const resultVolume = kernel.volume(result.wrapped);
+	const byVolume = volumeFailure(spec.distance, {
+		volume: inputVolume,
+		faceCount: require_topologyQueryFns.getFaces(input).length
+	}, {
+		volume: resultVolume,
+		faceCount: require_topologyQueryFns.getFaces(result).length
+	});
+	if (byVolume) return failure(spec, byVolume, {
+		inputVolume,
+		resultVolume
+	});
+	if (!kernel.isValid(result.wrapped)) return failure(spec, "invalid", {});
+	if (evolution && require_shapeTypes.getKernelCapabilities().nativeHistory === true) {
+		const deviation = worstWallDeviation(input, result, evolution, spec);
+		const allowed = Math.max(10 * spec.tolerance, WALL_DISTANCE_REL_TOL * Math.abs(spec.distance));
+		if (deviation > allowed) return failure(spec, "wall-distance", {
+			deviation,
+			allowed
+		});
+	}
+	return require_errors.ok(void 0);
+}
 // src/topology/modifierFns.ts
 /**
 * Functional modifier operations — fillet, chamfer, shell, thicken, offset, draft.
@@ -324,6 +417,22 @@ function chamfer(shape, edges, distance) {
 		}));
 	}
 }
+function acceptThickResult(input, cast, evolution, spec, propagateMetadata = true) {
+	let checked;
+	try {
+		if (require_shapeTypes.isShape3D(cast) || require_shapeTypes.getKernel().isNull(cast.wrapped)) checked = checkThickResult(input, cast, evolution, spec);
+		else checked = require_errors.err(spec.operation === "shell" ? require_errors.kernelError("SHELL_RESULT_NOT_3D", "Shell result is not a 3D shape") : require_errors.kernelError("OFFSET_RESULT_NOT_3D", "Offset result is not a 3D shape"));
+	} catch (e) {
+		require_shapeTypes.disposeResultShape(cast);
+		throw e;
+	}
+	if (require_errors.isErr(checked)) {
+		require_shapeTypes.disposeResultShape(cast);
+		return checked;
+	}
+	if (evolution && propagateMetadata) require_solidBuilders.propagateAllMetadata(evolution, [input], cast);
+	return require_errors.ok(cast);
+}
 /**
 * Create a hollow shell by removing faces and offsetting remaining walls.
 *
@@ -331,31 +440,29 @@ function chamfer(shape, edges, distance) {
 * @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.
 */
 function shell(shape, faces, thickness, tolerance = .001, { trackEvolution = true } = {}) {
 	const check = validateNotNull$1(shape, "shell: shape");
 	if (require_errors.isErr(check)) return check;
 	if (thickness <= 0) return require_errors.err(require_errors.validationError("INVALID_THICKNESS", "Shell thickness must be positive"));
 	if (faces.length === 0) return require_errors.err(require_errors.validationError("NO_FACES", "At least one face must be specified for shell"));
+	const kernel = require_shapeTypes.getKernel();
+	const spec = {
+		operation: "shell",
+		distance: -thickness,
+		tolerance,
+		openedFaceHashes: new Set(faces.map((f) => kernel.hashCode(f.wrapped, require_constants.HASH_CODE_MAX)))
+	};
 	try {
-		if (!trackEvolution) {
-			const resultShape = require_shapeTypes.getKernel().shell(shape.wrapped, faces.map((f) => f.wrapped), thickness, tolerance);
-			const cast = require_shapeTypes.castResultShape(resultShape);
-			if (!require_shapeTypes.isShape3D(cast)) {
-				require_shapeTypes.disposeResultShape(cast);
-				return require_errors.err(require_errors.kernelError("SHELL_RESULT_NOT_3D", "Shell result is not a 3D shape"));
-			}
-			return require_errors.ok(cast);
-		}
-		const inputFaceHashes = require_solidBuilders.collectInputFaceHashes([shape]);
-		const { shape: resultShape, evolution } = require_shapeTypes.getKernel().shellWithHistory(shape.wrapped, faces.map((f) => f.wrapped), thickness, inputFaceHashes, require_constants.HASH_CODE_MAX, tolerance);
-		const cast = require_shapeTypes.castResultShape(resultShape);
-		if (!require_shapeTypes.isShape3D(cast)) {
-			require_shapeTypes.disposeResultShape(cast);
-			return require_errors.err(require_errors.kernelError("SHELL_RESULT_NOT_3D", "Shell result is not a 3D shape"));
+		if (!trackEvolution && require_shapeTypes.getKernelCapabilities().nativeHistory !== true) {
+			const resultShape = kernel.shell(shape.wrapped, faces.map((f) => f.wrapped), thickness, tolerance);
+			return acceptThickResult(shape, require_shapeTypes.castResultShape(resultShape), void 0, spec);
 		}
-		require_solidBuilders.propagateAllMetadata(evolution, [shape], cast);
-		return require_errors.ok(cast);
+		const { shape: resultShape, evolution } = kernel.shellWithHistory(shape.wrapped, faces.map((f) => f.wrapped), thickness, require_topologyQueryFns.subShapeHashes(shape, "face"), require_constants.HASH_CODE_MAX, tolerance);
+		return acceptThickResult(shape, require_shapeTypes.castResultShape(resultShape), evolution, spec, trackEvolution);
 	} catch (e) {
 		const raw = e instanceof Error ? e.message : String(e);
 		return require_errors.err(require_errors.kernelError("SHELL_FAILED", `Shell operation failed: ${raw}`, e, {
@@ -371,21 +478,20 @@ function shell(shape, faces, thickness, tolerance = .001, { trackEvolution = tru
 * @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.
 */
 function offset(shape, distance, tolerance = 1e-6) {
 	const check = validateNotNull$1(shape, "offset: shape");
 	if (require_errors.isErr(check)) return check;
 	if (Math.abs(distance) < 1e-10) return require_errors.err(require_errors.validationError("ZERO_OFFSET", "Offset distance cannot be zero"));
 	try {
-		const inputFaceHashes = require_solidBuilders.collectInputFaceHashes([shape]);
-		const { shape: resultShape, evolution } = require_shapeTypes.getKernel().offsetWithHistory(shape.wrapped, distance, inputFaceHashes, require_constants.HASH_CODE_MAX, tolerance);
-		const cast = require_shapeTypes.castResultShape(resultShape);
-		if (!require_shapeTypes.isShape3D(cast)) {
-			require_shapeTypes.disposeResultShape(cast);
-			return require_errors.err(require_errors.kernelError("OFFSET_RESULT_NOT_3D", "Offset result is not a 3D shape"));
-		}
-		require_solidBuilders.propagateAllMetadata(evolution, [shape], cast);
-		return require_errors.ok(cast);
+		const { shape: resultShape, evolution } = require_shapeTypes.getKernel().offsetWithHistory(shape.wrapped, distance, require_topologyQueryFns.subShapeHashes(shape, "face"), require_constants.HASH_CODE_MAX, tolerance);
+		return acceptThickResult(shape, require_shapeTypes.castResultShape(resultShape), evolution, {
+			operation: "offset",
+			distance,
+			tolerance
+		});
 	} catch (e) {
 		const raw = e instanceof Error ? e.message : String(e);
 		return require_errors.err(require_errors.kernelError("OFFSET_FAILED", `Offset operation failed: ${raw}`, e));

package/dist/{healingFns-CJfuZMw2.js → healingFns-CEr0afli.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-Bva18qvE.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-B3espUT6.js";
-import { c as getFaces, i as getCachedIsValid, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-CY6YiGsk.js";
+import { C as isSolid, D as getShapeKind, T as isWire, Y as getKernelCapabilities, h as disposeResultShape, i as castShape, m as disposeDowncastSource, n as castResultShape, q as getKernel, x as isShape3D, y as isFace } from "./shapeTypes-CgbUTASh.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-vxP5FT8B.js";
+import { C as subShapeHashes, O as getSuggestionForCode, c as getFaces, i as getCachedIsValid, m as invalidateShapeCache, p as getWires, s as getEdges } from "./topologyQueryFns-6M_dbT1R.js";
 import { n as HASH_CODE_MAX } from "./constants-iraOnb2p.js";
-import { y as downcast } from "./faceFns-C-wc4fX-.js";
-import { C as propagateAllMetadata, f as cut, h as fuseAll, m as fuse, p as cutAll, x as collectInputFaceHashes } from "./solidBuilders-BpTN-NfM.js";
+import { y as downcast } from "./faceFns-BBk6XKJO.js";
+import { C as propagateAllMetadata, f as cut, h as fuseAll, m as fuse, p as cutAll, x as collectInputFaceHashes } from "./solidBuilders-DE_na4G3.js";
 import { t as firstOrThrow } from "./arrayAccess-BpgouNir.js";
 // src/topology/threeHelpers.ts
 /**
@@ -106,6 +106,99 @@ function toLODGeometryLevels(lods, options) {
 		distance: distances?.[idx] ?? (last - idx) * step
 	}));
 }
+// src/topology/thickResultCheck.ts
+var UNCHANGED_VOLUME_REL_TOL = 1e-7;
+var WALL_DISTANCE_REL_TOL = .001;
+function facesByHash(shape) {
+	const kernel = getKernel();
+	const byHash = /* @__PURE__ */ new Map();
+	for (const face of getFaces(shape)) byHash.set(kernel.hashCode(face.wrapped, HASH_CODE_MAX), face);
+	return byHash;
+}
+function volumeFailure(distance, input, result) {
+	if (Math.abs(result.volume - input.volume) <= UNCHANGED_VOLUME_REL_TOL * Math.abs(input.volume) && result.faceCount === input.faceCount) return "unchanged";
+	if (result.volume <= 0) return "volume";
+	return result.volume > input.volume === distance > 0 ? void 0 : "volume";
+}
+/** Distance from the middle of a generated wall's surface to its source face. */
+function wallGap(source, generated) {
+	const kernel = getKernel();
+	const uv = kernel.uvBounds(generated.wrapped);
+	const p = kernel.pointOnSurface(generated.wrapped, (uv.uMin + uv.uMax) / 2, (uv.vMin + uv.vMax) / 2);
+	const q = kernel.projectPointOnFace(source.wrapped, p);
+	return Math.hypot(p[0] - q[0], p[1] - q[1], p[2] - q[2]);
+}
+function worstWallDeviation(input, result, evolution, spec) {
+	if (evolution.generated.size === 0) return 0;
+	const sources = facesByHash(input);
+	const produced = facesByHash(result);
+	const wall = Math.abs(spec.distance);
+	let worst = 0;
+	for (const [sourceHash, generatedHashes] of evolution.generated) {
+		if (spec.openedFaceHashes?.has(sourceHash)) continue;
+		const source = sources.get(sourceHash);
+		if (!source) continue;
+		for (const hash of generatedHashes) {
+			const face = produced.get(hash);
+			if (!face) continue;
+			worst = Math.max(worst, Math.abs(wallGap(source, face) - wall));
+		}
+	}
+	return worst;
+}
+function failure(spec, reason, metadata) {
+	const wall = Math.abs(spec.distance);
+	const isShell = spec.operation === "shell";
+	if (isShell && reason === "unchanged") {
+		const code = BrepErrorCode.SHELL_NO_EFFECT;
+		return err(kernelError(code, `Shell left the solid unchanged: a ${wall} wall is too thick for this body`, void 0, {
+			operation: "shell",
+			reason,
+			thickness: wall,
+			...metadata
+		}, getSuggestionForCode(code)));
+	}
+	const code = isShell ? BrepErrorCode.SHELL_INVALID_RESULT : BrepErrorCode.OFFSET_INVALID_RESULT;
+	const what = isShell ? `a ${wall} wall` : `an offset of ${spec.distance}`;
+	return err(kernelError(code, `${spec.operation} gave no usable solid (${reason}): ${what} is too large for this body`, void 0, {
+		operation: spec.operation,
+		reason,
+		distance: spec.distance,
+		...metadata
+	}, getSuggestionForCode(code)));
+}
+/**
+* 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.
+*/
+function checkThickResult(input, result, evolution, spec) {
+	const kernel = getKernel();
+	if (kernel.isNull(result.wrapped)) return failure(spec, "empty", {});
+	const inputVolume = kernel.volume(input.wrapped);
+	const resultVolume = kernel.volume(result.wrapped);
+	const byVolume = volumeFailure(spec.distance, {
+		volume: inputVolume,
+		faceCount: getFaces(input).length
+	}, {
+		volume: resultVolume,
+		faceCount: getFaces(result).length
+	});
+	if (byVolume) return failure(spec, byVolume, {
+		inputVolume,
+		resultVolume
+	});
+	if (!kernel.isValid(result.wrapped)) return failure(spec, "invalid", {});
+	if (evolution && getKernelCapabilities().nativeHistory === true) {
+		const deviation = worstWallDeviation(input, result, evolution, spec);
+		const allowed = Math.max(10 * spec.tolerance, WALL_DISTANCE_REL_TOL * Math.abs(spec.distance));
+		if (deviation > allowed) return failure(spec, "wall-distance", {
+			deviation,
+			allowed
+		});
+	}
+	return ok(void 0);
+}
 // src/topology/modifierFns.ts
 /**
 * Functional modifier operations — fillet, chamfer, shell, thicken, offset, draft.
@@ -324,6 +417,22 @@ function chamfer(shape, edges, distance) {
 		}));
 	}
 }
+function acceptThickResult(input, cast, evolution, spec, propagateMetadata = true) {
+	let checked;
+	try {
+		if (isShape3D(cast) || getKernel().isNull(cast.wrapped)) checked = checkThickResult(input, cast, evolution, spec);
+		else checked = err(spec.operation === "shell" ? kernelError("SHELL_RESULT_NOT_3D", "Shell result is not a 3D shape") : kernelError("OFFSET_RESULT_NOT_3D", "Offset result is not a 3D shape"));
+	} catch (e) {
+		disposeResultShape(cast);
+		throw e;
+	}
+	if (isErr(checked)) {
+		disposeResultShape(cast);
+		return checked;
+	}
+	if (evolution && propagateMetadata) propagateAllMetadata(evolution, [input], cast);
+	return ok(cast);
+}
 /**
 * Create a hollow shell by removing faces and offsetting remaining walls.
 *
@@ -331,31 +440,29 @@ function chamfer(shape, edges, distance) {
 * @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.
 */
 function shell(shape, faces, thickness, tolerance = .001, { trackEvolution = true } = {}) {
 	const check = validateNotNull$1(shape, "shell: shape");
 	if (isErr(check)) return check;
 	if (thickness <= 0) return err(validationError("INVALID_THICKNESS", "Shell thickness must be positive"));
 	if (faces.length === 0) return err(validationError("NO_FACES", "At least one face must be specified for shell"));
+	const kernel = getKernel();
+	const spec = {
+		operation: "shell",
+		distance: -thickness,
+		tolerance,
+		openedFaceHashes: new Set(faces.map((f) => kernel.hashCode(f.wrapped, HASH_CODE_MAX)))
+	};
 	try {
-		if (!trackEvolution) {
-			const resultShape = getKernel().shell(shape.wrapped, faces.map((f) => f.wrapped), thickness, tolerance);
-			const cast = castResultShape(resultShape);
-			if (!isShape3D(cast)) {
-				disposeResultShape(cast);
-				return err(kernelError("SHELL_RESULT_NOT_3D", "Shell result is not a 3D shape"));
-			}
-			return ok(cast);
+		if (!trackEvolution && getKernelCapabilities().nativeHistory !== true) {
+			const resultShape = kernel.shell(shape.wrapped, faces.map((f) => f.wrapped), thickness, tolerance);
+			return acceptThickResult(shape, castResultShape(resultShape), void 0, spec);
 		}
-		const inputFaceHashes = collectInputFaceHashes([shape]);
-		const { shape: resultShape, evolution } = getKernel().shellWithHistory(shape.wrapped, faces.map((f) => f.wrapped), thickness, inputFaceHashes, HASH_CODE_MAX, tolerance);
-		const cast = castResultShape(resultShape);
-		if (!isShape3D(cast)) {
-			disposeResultShape(cast);
-			return err(kernelError("SHELL_RESULT_NOT_3D", "Shell result is not a 3D shape"));
-		}
-		propagateAllMetadata(evolution, [shape], cast);
-		return ok(cast);
+		const { shape: resultShape, evolution } = kernel.shellWithHistory(shape.wrapped, faces.map((f) => f.wrapped), thickness, subShapeHashes(shape, "face"), HASH_CODE_MAX, tolerance);
+		return acceptThickResult(shape, castResultShape(resultShape), evolution, spec, trackEvolution);
 	} catch (e) {
 		const raw = e instanceof Error ? e.message : String(e);
 		return err(kernelError("SHELL_FAILED", `Shell operation failed: ${raw}`, e, {
@@ -371,21 +478,20 @@ function shell(shape, faces, thickness, tolerance = .001, { trackEvolution = tru
 * @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.
 */
 function offset(shape, distance, tolerance = 1e-6) {
 	const check = validateNotNull$1(shape, "offset: shape");
 	if (isErr(check)) return check;
 	if (Math.abs(distance) < 1e-10) return err(validationError("ZERO_OFFSET", "Offset distance cannot be zero"));
 	try {
-		const inputFaceHashes = collectInputFaceHashes([shape]);
-		const { shape: resultShape, evolution } = getKernel().offsetWithHistory(shape.wrapped, distance, inputFaceHashes, HASH_CODE_MAX, tolerance);
-		const cast = castResultShape(resultShape);
-		if (!isShape3D(cast)) {
-			disposeResultShape(cast);
-			return err(kernelError("OFFSET_RESULT_NOT_3D", "Offset result is not a 3D shape"));
-		}
-		propagateAllMetadata(evolution, [shape], cast);
-		return ok(cast);
+		const { shape: resultShape, evolution } = getKernel().offsetWithHistory(shape.wrapped, distance, subShapeHashes(shape, "face"), HASH_CODE_MAX, tolerance);
+		return acceptThickResult(shape, castResultShape(resultShape), evolution, {
+			operation: "offset",
+			distance,
+			tolerance
+		});
 	} catch (e) {
 		const raw = e instanceof Error ? e.message : String(e);
 		return err(kernelError("OFFSET_FAILED", `Offset operation failed: ${raw}`, e));

package/dist/{helpers-BhHbDu6-.cjs → helpers-JuPoaP_b.cjs}

@@ -1,12 +1,12 @@
-const require_shapeTypes = require("./shapeTypes-CkxvJRpq.cjs");
-const require_errors = require("./errors-DoMAp7mQ.cjs");
-const require_topologyQueryFns = require("./topologyQueryFns-C6HwYYpi.cjs");
+const require_shapeTypes = require("./shapeTypes-D_anqiRe.cjs");
+const require_errors = require("./errors-GVyCnpi0.cjs");
+const require_topologyQueryFns = require("./topologyQueryFns-ENxs8uu2.cjs");
 const require_constants = require("./constants-oee0S_x6.cjs");
 const require_vecOps = require("./vecOps-CrGEPPQM.cjs");
-const require_faceFns = require("./faceFns-B8ctN5Te.cjs");
-const require_shapeFns = require("./shapeFns-DKDlt3k2.cjs");
-const require_curveFns = require("./curveFns-Cxq5lFqU.cjs");
-const require_measureFns = require("./measureFns-C6wgH_1a.cjs");
+const require_faceFns = require("./faceFns-DSRREV5G.cjs");
+const require_shapeFns = require("./shapeFns-B54CsPyk.cjs");
+const require_curveFns = require("./curveFns-U7srQ3ZA.cjs");
+const require_measureFns = require("./measureFns-BvNkzSR6.cjs");
 // src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;

package/dist/{helpers-BXoAMWe3.js → helpers-sDialr0f.js}

@@ -1,12 +1,12 @@
-import { q as getKernel, y as isFace } from "./shapeTypes-Bva18qvE.js";
-import { E as ok, g as err, o as queryError, x as isOk } from "./errors-B3espUT6.js";
-import { c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-CY6YiGsk.js";
+import { q as getKernel, y as isFace } from "./shapeTypes-CgbUTASh.js";
+import { E as ok, g as err, o as queryError, x as isOk } from "./errors-vxP5FT8B.js";
+import { c as getFaces, f as getVertices, p as getWires, s as getEdges } from "./topologyQueryFns-6M_dbT1R.js";
 import { t as DEG2RAD } from "./constants-iraOnb2p.js";
 import { a as vecDot, d as vecNormalize } from "./vecOps-S-m9H_fe.js";
-import { l as normalAt, s as getSurfaceType } from "./faceFns-C-wc4fX-.js";
-import { a as isSameShape, n as getHashCode } from "./shapeFns-B5hzkmwe.js";
-import { f as getCurveType, i as curveIsClosed, o as curveLength } from "./curveFns-CEb6TLxC.js";
-import { n as measureArea } from "./measureFns-BmdVG0_8.js";
+import { l as normalAt, s as getSurfaceType } from "./faceFns-BBk6XKJO.js";
+import { a as isSameShape, n as getHashCode } from "./shapeFns-DB3l3ULC.js";
+import { f as getCurveType, i as curveIsClosed, o as curveLength } from "./curveFns-CkA2WJP2.js";
+import { n as measureArea } from "./measureFns-PRM3gOjw.js";
 // src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;

package/dist/{importFns-DHaw1x5R.cjs → importFns-ClqPJCFR.cjs}

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

package/dist/{importFns-YZyGYu_M.js → importFns-DSUfSQn2.js}

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

package/dist/io.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_meshFns = require("./meshFns-r_p0RRoO.cjs");
-const require_importFns = require("./importFns-DHaw1x5R.cjs");
+const require_meshFns = require("./meshFns-W7ZTKqiJ.cjs");
+const require_importFns = require("./importFns-ClqPJCFR.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-uNRS602U.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-YZyGYu_M.js";
+import { n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-CgbT3uuO.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-DSUfSQn2.js";
 export { blueprintToDXF, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, importIGES, importSTEP, importSTL, importSVG, importSVGPathD };

package/dist/kernel/capabilities.d.ts

@@ -24,9 +24,17 @@ export interface KernelCapabilities {
     readonly exactMeasurement: boolean;
     /** How tessellation resolution is controlled — see module docs. */
     readonly tessellationModel: TessellationModel;
+    /**
+     * `*WithHistory` maps come from the kernel's own operation history, so a
+     * face listed as generated from a source face is that face's offset, sweep,
+     * or fillet. Kernels that rebuild the maps by geometric matching leave it unset.
+     */
+    readonly nativeHistory?: boolean | undefined;
 }
 /** Default for an exact B-rep kernel (OCCT family, brepkit). */
 export declare const EXACT_BREP_CAPABILITIES: KernelCapabilities;
+/** OCCT-family kernels: exact B-rep with OCCT's own shape history. */
+export declare const OCCT_CAPABILITIES: KernelCapabilities;
 /**
  * Conservative fallback for a kernel that doesn't declare capabilities: assume
  * exact B-rep so export/measurement aren't wrongly blocked, but claim no

package/dist/kernel/occtWasm/occtWasmAdapter.cjs

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

package/dist/kernel/occtWasm/occtWasmAdapter.js

@@ -1 +1 @@
-export { t as OcctWasmAdapter } from "../../occtWasmAdapter-cnV8J7Y-.js";
+export { t as OcctWasmAdapter } from "../../occtWasmAdapter-PzZJHUAd.js";

package/dist/{loftFns-CTTia_cZ.js → loftFns-B8DSoG-F.js}

@@ -1,5 +1,5 @@
-import { G as _usingCtx, T as isWire, h as disposeResultShape, n as castResultShape, q as getKernel, x as isShape3D } from "./shapeTypes-Bva18qvE.js";
-import { E as ok, b as isErr, d as validationError, g as err, i as kernelError, l as typeCastError, t as BrepErrorCode } from "./errors-B3espUT6.js";
+import { G as _usingCtx, T as isWire, h as disposeResultShape, n as castResultShape, q as getKernel, x as isShape3D } from "./shapeTypes-CgbUTASh.js";
+import { E as ok, b as isErr, d as validationError, g as err, i as kernelError, l as typeCastError, t as BrepErrorCode } from "./errors-vxP5FT8B.js";
 import { r as toVec3 } from "./types-CKXsIm9-.js";
 import { c as vecLength, t as vecAdd } from "./vecOps-S-m9H_fe.js";
 // src/operations/extrudeUtils.ts