brepjs 13.0.0 → 13.2.0

package/dist/2d.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_boolean2D = require("./boolean2D-D76Hc7Wx.cjs");
-const require_blueprint = require("./blueprint-BP3P8Ado.cjs");
-const require_blueprintFns = require("./blueprintFns-BQ-MP_Vy.cjs");
+const require_boolean2D = require("./boolean2D-CtB21ajK.cjs");
+const require_blueprint = require("./blueprint-PLJan-W5.cjs");
+const require_blueprintFns = require("./blueprintFns-Bsx25BG7.cjs");
 exports.Blueprint = require_blueprint.Blueprint;
 exports.Blueprints = require_boolean2D.Blueprints;
 exports.BoundingBox2d = require_blueprint.BoundingBox2d;

package/dist/2d.js

@@ -1,4 +1,4 @@
-import { a as fuseBlueprints, c as roundedRectangleBlueprint, g as Blueprints, h as CompoundBlueprint, i as cutBlueprints, m as organiseBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-Cqfwz60G.js";
-import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-mSGgCL3V.js";
-import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-DWFkjbDT.js";
+import { a as fuseBlueprints, c as roundedRectangleBlueprint, g as Blueprints, h as CompoundBlueprint, i as cutBlueprints, m as organiseBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-52qVCooY.js";
+import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-DYCdRlW5.js";
+import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-eWh7NpZx.js";
 export { Blueprint, Blueprints, BoundingBox2d, CompoundBlueprint, Curve2D, createBlueprint, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, cut2D, cutBlueprints, fuse2D, fuseBlueprints, getBounds2D, getOrientation2D, intersect2D, intersectBlueprints, isInside2D, mirror2D, organiseBlueprints, polysidesBlueprint, reverseCurve, rotate2D, roundedRectangleBlueprint, scale2D, sketchOnFace2D, sketchOnPlane2D, stretch2D, toSVGPathD, translate2D };

package/dist/{arrayAccess-CccV7jov.js → arrayAccess-Dps31ERU.js}

@@ -1,7 +1,7 @@
-import { Y as getKernel, r as castShapeWithKnownType, t as castShape } from "./shapeTypes-D38b_BKF.js";
-import { L as unwrap, d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-B1fl3mAU.js";
+import { Y as getKernel, r as castShapeWithKnownType, t as castShape } from "./shapeTypes-CYb8Byqj.js";
+import { L as unwrap, d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-B_T0aMQF.js";
 import { _ as DEG2RAD, v as HASH_CODE_MAX } from "./vecOps-B9-MTeC8.js";
-import { _ as downcast } from "./faceFns-Bne5RIvn.js";
+import { _ as downcast } from "./faceFns-EnGcKFAr.js";
 //#region src/topology/topologyQueryFns.ts
 /**
 * Topology query functions — extract sub-shapes, compute bounds, and

package/dist/{arrayAccess-BF8Hm4-H.cjs → arrayAccess-peFKE9Ob.cjs}

@@ -1,7 +1,7 @@
-const require_shapeTypes = require("./shapeTypes-GmE4D5Q_.cjs");
-const require_errors = require("./errors-C85KVJr-.cjs");
+const require_shapeTypes = require("./shapeTypes-CElaawp7.cjs");
+const require_errors = require("./errors-DupKEMqI.cjs");
 const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_faceFns = require("./faceFns-8BurpAGN.cjs");
+const require_faceFns = require("./faceFns-8dGb8q3J.cjs");
 //#region src/topology/topologyQueryFns.ts
 /**
 * Topology query functions — extract sub-shapes, compute bounds, and

package/dist/{blueprint-mSGgCL3V.js → blueprint-DYCdRlW5.js}

@@ -1,13 +1,13 @@
-import { H as registerForCleanup, W as unregisterFromCleanup, X as getKernel2D, Y as getKernel, a as createEdge, u as createWire } from "./shapeTypes-D38b_BKF.js";
-import { L as unwrap, d as validationError, k as ok, m as bug, n as computationError, y as err } from "./errors-B1fl3mAU.js";
+import { H as registerForCleanup, W as unregisterFromCleanup, X as getKernel2D, Y as getKernel, a as createEdge, u as createWire } from "./shapeTypes-CYb8Byqj.js";
+import { L as unwrap, d as validationError, k as ok, m as bug, n as computationError, y as err } from "./errors-B_T0aMQF.js";
 import { _ as DEG2RAD, y as RAD2DEG } from "./vecOps-B9-MTeC8.js";
 import { r as toVec3 } from "./types-Bb4KK_iG.js";
-import { r as makePlane } from "./planeOps-DPintPbl.js";
-import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-Bne5RIvn.js";
-import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-CccV7jov.js";
-import { f as getOrientation } from "./curveFns-D_s3LdNT.js";
-import { r as makeFace } from "./surfaceBuilders-DiCVk_Un.js";
-import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-CxexSe1n.js";
+import { r as makePlane } from "./planeOps-BuBXTLBr.js";
+import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-EnGcKFAr.js";
+import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-Dps31ERU.js";
+import { f as getOrientation } from "./curveFns-C-jU1_Y_.js";
+import { r as makeFace } from "./surfaceBuilders-DnGdDW8i.js";
+import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-Rf0vhX6I.js";
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprint-BP3P8Ado.cjs → blueprint-PLJan-W5.cjs}

@@ -1,13 +1,13 @@
-const require_shapeTypes = require("./shapeTypes-GmE4D5Q_.cjs");
-const require_errors = require("./errors-C85KVJr-.cjs");
+const require_shapeTypes = require("./shapeTypes-CElaawp7.cjs");
+const require_errors = require("./errors-DupKEMqI.cjs");
 const require_vecOps = require("./vecOps-4iBMiet9.cjs");
 const require_types = require("./types-BD-VVaWB.cjs");
-const require_planeOps = require("./planeOps-DdkIuVjk.cjs");
-const require_faceFns = require("./faceFns-8BurpAGN.cjs");
-const require_arrayAccess = require("./arrayAccess-BF8Hm4-H.cjs");
-const require_curveFns = require("./curveFns-CJjkUGyW.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BzDQQ4EG.cjs");
-const require_helpers = require("./helpers-D8DIMw2U.cjs");
+const require_planeOps = require("./planeOps-cTxDywpG.cjs");
+const require_faceFns = require("./faceFns-8dGb8q3J.cjs");
+const require_arrayAccess = require("./arrayAccess-peFKE9Ob.cjs");
+const require_curveFns = require("./curveFns-ywh7Ctyk.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-ZUTb3z6i.cjs");
+const require_helpers = require("./helpers-pQpV9Mwh.cjs");
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprintFns-BQ-MP_Vy.cjs → blueprintFns-Bsx25BG7.cjs}

@@ -1,6 +1,6 @@
-const require_errors = require("./errors-C85KVJr-.cjs");
-const require_boolean2D = require("./boolean2D-D76Hc7Wx.cjs");
-const require_blueprint = require("./blueprint-BP3P8Ado.cjs");
+const require_errors = require("./errors-DupKEMqI.cjs");
+const require_boolean2D = require("./boolean2D-CtB21ajK.cjs");
+const require_blueprint = require("./blueprint-PLJan-W5.cjs");
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintFns-DWFkjbDT.js → blueprintFns-eWh7NpZx.js}

@@ -1,6 +1,6 @@
-import { d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-B1fl3mAU.js";
-import { h as CompoundBlueprint } from "./boolean2D-Cqfwz60G.js";
-import { t as Blueprint } from "./blueprint-mSGgCL3V.js";
+import { d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-B_T0aMQF.js";
+import { h as CompoundBlueprint } from "./boolean2D-52qVCooY.js";
+import { t as Blueprint } from "./blueprint-DYCdRlW5.js";
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{boolean2D-Cqfwz60G.js → boolean2D-52qVCooY.js}

@@ -1,15 +1,15 @@
-import { J as _usingCtx, L as DisposalScope, X as getKernel2D, Y as getKernel, a as createEdge, h as isShape3D, o as createFace, t as castShape, u as createWire } from "./shapeTypes-D38b_BKF.js";
-import { L as unwrap, d as validationError, i as kernelError, k as ok, l as typeCastError, m as bug, n as computationError, s as safeIndex, w as isOk, y as err } from "./errors-B1fl3mAU.js";
+import { J as _usingCtx, L as DisposalScope, X as getKernel2D, Y as getKernel, a as createEdge, h as isShape3D, o as createFace, t as castShape, u as createWire } from "./shapeTypes-CYb8Byqj.js";
+import { L as unwrap, d as validationError, i as kernelError, k as ok, l as typeCastError, m as bug, n as computationError, s as safeIndex, w as isOk, y as err } from "./errors-B_T0aMQF.js";
 import { _ as DEG2RAD, d as vecNormalize, h as vecScale, r as vecCross, y as RAD2DEG } from "./vecOps-B9-MTeC8.js";
 import { r as toVec3 } from "./types-Bb4KK_iG.js";
-import { n as createPlane } from "./planeOps-DPintPbl.js";
-import { _ as downcast, c as normalAt, p as uvBounds, u as pointOnSurface } from "./faceFns-Bne5RIvn.js";
-import { r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-CccV7jov.js";
-import { c as curveStartPoint, l as curveTangentAt, r as curveIsClosed } from "./curveFns-D_s3LdNT.js";
-import { _ as zip, i as makeNewFaceWithinFace, r as makeFace, s as assembleWire } from "./surfaceBuilders-DiCVk_Un.js";
-import { _ as samePoint$1, b as subtract2d, d as cartesianToPolar, f as crossProduct2d, g as rotate2d, h as polarToCartesian, l as add2d, m as polarAngle2d, o as normalize2d, p as distance2d, s as PRECISION_INTERSECTION, v as scalarMultiply2d } from "./helpers-CxexSe1n.js";
-import { _ as Curve2D, b as removeDuplicatePoints, c as make2dCircle, f as make2dSegmentCurve, h as approximateAsBSpline, m as make2dThreePointArc, n as asSVG, o as make2dArcFromCenter, p as make2dTangentArc, r as viewbox, s as make2dBezierCurve, t as Blueprint, u as make2dEllipseArc, x as isPoint2D, y as BoundingBox2d } from "./blueprint-mSGgCL3V.js";
-import { c as twistExtrude, n as revolve, r as complexExtrude, s as sweep, t as extrude } from "./extrudeFns-lDvV4ir2.js";
+import { n as createPlane } from "./planeOps-BuBXTLBr.js";
+import { _ as downcast, c as normalAt, p as uvBounds, u as pointOnSurface } from "./faceFns-EnGcKFAr.js";
+import { r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-Dps31ERU.js";
+import { c as curveStartPoint, l as curveTangentAt, r as curveIsClosed } from "./curveFns-C-jU1_Y_.js";
+import { _ as zip, i as makeNewFaceWithinFace, r as makeFace, s as assembleWire } from "./surfaceBuilders-DnGdDW8i.js";
+import { _ as samePoint$1, b as subtract2d, d as cartesianToPolar, f as crossProduct2d, g as rotate2d, h as polarToCartesian, l as add2d, m as polarAngle2d, o as normalize2d, p as distance2d, s as PRECISION_INTERSECTION, v as scalarMultiply2d } from "./helpers-Rf0vhX6I.js";
+import { _ as Curve2D, b as removeDuplicatePoints, c as make2dCircle, f as make2dSegmentCurve, h as approximateAsBSpline, m as make2dThreePointArc, n as asSVG, o as make2dArcFromCenter, p as make2dTangentArc, r as viewbox, s as make2dBezierCurve, t as Blueprint, u as make2dEllipseArc, x as isPoint2D, y as BoundingBox2d } from "./blueprint-DYCdRlW5.js";
+import { c as twistExtrude, n as revolve, r as complexExtrude, s as sweep, t as extrude } from "./extrudeFns-LsH1rDMa.js";
 //#region node_modules/flatqueue/index.js
 /** @template T */
 var FlatQueue = class {

package/dist/{boolean2D-D76Hc7Wx.cjs → boolean2D-CtB21ajK.cjs}

@@ -1,15 +1,15 @@
-const require_shapeTypes = require("./shapeTypes-GmE4D5Q_.cjs");
-const require_errors = require("./errors-C85KVJr-.cjs");
+const require_shapeTypes = require("./shapeTypes-CElaawp7.cjs");
+const require_errors = require("./errors-DupKEMqI.cjs");
 const require_vecOps = require("./vecOps-4iBMiet9.cjs");
 const require_types = require("./types-BD-VVaWB.cjs");
-const require_planeOps = require("./planeOps-DdkIuVjk.cjs");
-const require_faceFns = require("./faceFns-8BurpAGN.cjs");
-const require_arrayAccess = require("./arrayAccess-BF8Hm4-H.cjs");
-const require_curveFns = require("./curveFns-CJjkUGyW.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BzDQQ4EG.cjs");
-const require_helpers = require("./helpers-D8DIMw2U.cjs");
-const require_blueprint = require("./blueprint-BP3P8Ado.cjs");
-const require_extrudeFns = require("./extrudeFns-0kBZvqJz.cjs");
+const require_planeOps = require("./planeOps-cTxDywpG.cjs");
+const require_faceFns = require("./faceFns-8dGb8q3J.cjs");
+const require_arrayAccess = require("./arrayAccess-peFKE9Ob.cjs");
+const require_curveFns = require("./curveFns-ywh7Ctyk.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-ZUTb3z6i.cjs");
+const require_helpers = require("./helpers-pQpV9Mwh.cjs");
+const require_blueprint = require("./blueprint-PLJan-W5.cjs");
+const require_extrudeFns = require("./extrudeFns-CGCIbydL.cjs");
 //#region node_modules/flatqueue/index.js
 /** @template T */
 var FlatQueue = class {

package/dist/{booleanFns-CYPXeNVN.cjs → booleanFns-BrptUFkP.cjs}

@@ -1,9 +1,9 @@
-const require_shapeTypes = require("./shapeTypes-GmE4D5Q_.cjs");
-const require_errors = require("./errors-C85KVJr-.cjs");
+const require_shapeTypes = require("./shapeTypes-CElaawp7.cjs");
+const require_errors = require("./errors-DupKEMqI.cjs");
 const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_planeOps = require("./planeOps-DdkIuVjk.cjs");
-const require_arrayAccess = require("./arrayAccess-BF8Hm4-H.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BzDQQ4EG.cjs");
+const require_planeOps = require("./planeOps-cTxDywpG.cjs");
+const require_arrayAccess = require("./arrayAccess-peFKE9Ob.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-ZUTb3z6i.cjs");
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.
@@ -13,7 +13,7 @@ function validateShape3D(shape, label) {
 	if (require_shapeTypes.getKernel().isNull(shape.wrapped)) return require_errors.err(require_errors.validationError(require_errors.BrepErrorCode.NULL_SHAPE_INPUT, `${label} is a null shape`));
 	return require_errors.ok(void 0);
 }
-function castToShape3D(shape, errorCode, errorMsg, suggestion) {
+function castToShape3D(shape, errorCode, errorMsg, suggestion, diagnostics) {
 	const wrapped = require_shapeTypes.castShape(shape);
 	if (!require_shapeTypes.isShape3D(wrapped)) {
 		const shapeType = shape.ShapeType();
@@ -29,7 +29,7 @@ function castToShape3D(shape, errorCode, errorMsg, suggestion) {
 			"SHAPE"
 		][shapeType] ?? `UNKNOWN(${shapeType})`;
 		wrapped[Symbol.dispose]();
-		return require_errors.err(require_errors.typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`, void 0, void 0, suggestion));
+		return require_errors.err(require_errors.typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`, void 0, diagnostics ? { diagnostics } : void 0, suggestion));
 	}
 	return require_errors.ok(wrapped);
 }
@@ -40,12 +40,16 @@ function fuse(a, b, { optimisation = "none", simplify = false, signal, fuzzyValu
 	const checkB = validateShape3D(b, "fuse: second operand");
 	if (require_errors.isErr(checkB)) return checkB;
 	const inputFaceHashes = require_arrayAccess.collectInputFaceHashes([a, b]);
-	const { shape: resultShape, evolution } = require_shapeTypes.getKernel().fuseWithHistory(a.wrapped, b.wrapped, inputFaceHashes, require_vecOps.HASH_CODE_MAX, {
+	const { shape: resultShape, evolution, diagnostics } = require_shapeTypes.getKernel().fuseWithHistory(a.wrapped, b.wrapped, inputFaceHashes, require_vecOps.HASH_CODE_MAX, {
 		optimisation,
 		simplify,
 		fuzzyValue
 	});
-	const fuseResult = castToShape3D(resultShape, "FUSE_NOT_3D", "Fuse did not produce a 3D shape", "Common causes: overlapping coplanar faces, zero-thickness geometry, or non-manifold input. Try autoHeal() on inputs first.");
+	if (diagnostics.hasErrors) {
+		require_shapeTypes.getKernel().dispose(resultShape);
+		return require_errors.err(require_errors.kernelError(require_errors.BrepErrorCode.BOOLEAN_HAS_ERRORS, "Boolean operation reported internal errors. The result may be invalid.", void 0, { diagnostics }, "Use checkBoolean() to pre-validate operands, or try autoHeal() on inputs."));
+	}
+	const fuseResult = castToShape3D(resultShape, "FUSE_NOT_3D", "Fuse did not produce a 3D shape", "Common causes: overlapping coplanar faces, zero-thickness geometry, or non-manifold input. Try autoHeal() on inputs first.", diagnostics);
 	if (fuseResult.ok) require_arrayAccess.propagateAllMetadata(evolution, [a, b], fuseResult.value);
 	return fuseResult;
 }
@@ -56,12 +60,16 @@ function cut(base, tool, { optimisation = "none", simplify = false, signal, fuzz
 	const checkTool = validateShape3D(tool, "cut: tool");
 	if (require_errors.isErr(checkTool)) return checkTool;
 	const inputFaceHashes = require_arrayAccess.collectInputFaceHashes([base, tool]);
-	const { shape: resultShape, evolution } = require_shapeTypes.getKernel().cutWithHistory(base.wrapped, tool.wrapped, inputFaceHashes, require_vecOps.HASH_CODE_MAX, {
+	const { shape: resultShape, evolution, diagnostics } = require_shapeTypes.getKernel().cutWithHistory(base.wrapped, tool.wrapped, inputFaceHashes, require_vecOps.HASH_CODE_MAX, {
 		optimisation,
 		simplify,
 		fuzzyValue
 	});
-	const cutResult = castToShape3D(resultShape, "CUT_NOT_3D", "Cut did not produce a 3D shape", "Common causes: tool does not fully intersect the base, or produces a zero-thickness sliver. Ensure the tool extends through the shape.");
+	if (diagnostics.hasErrors) {
+		require_shapeTypes.getKernel().dispose(resultShape);
+		return require_errors.err(require_errors.kernelError(require_errors.BrepErrorCode.BOOLEAN_HAS_ERRORS, "Boolean operation reported internal errors. The result may be invalid.", void 0, { diagnostics }, "Use checkBoolean() to pre-validate operands, or try autoHeal() on inputs."));
+	}
+	const cutResult = castToShape3D(resultShape, "CUT_NOT_3D", "Cut did not produce a 3D shape", "Common causes: tool does not fully intersect the base, or produces a zero-thickness sliver. Ensure the tool extends through the shape.", diagnostics);
 	if (cutResult.ok) require_arrayAccess.propagateAllMetadata(evolution, [base, tool], cutResult.value);
 	return cutResult;
 }
@@ -72,11 +80,15 @@ function intersect(a, b, { simplify = false, signal, fuzzyValue, unsafe: _unsafe
 	const checkB = validateShape3D(b, "intersect: second operand");
 	if (require_errors.isErr(checkB)) return checkB;
 	const inputFaceHashes = require_arrayAccess.collectInputFaceHashes([a, b]);
-	const { shape: resultShape, evolution } = require_shapeTypes.getKernel().intersectWithHistory(a.wrapped, b.wrapped, inputFaceHashes, require_vecOps.HASH_CODE_MAX, {
+	const { shape: resultShape, evolution, diagnostics } = require_shapeTypes.getKernel().intersectWithHistory(a.wrapped, b.wrapped, inputFaceHashes, require_vecOps.HASH_CODE_MAX, {
 		simplify,
 		fuzzyValue
 	});
-	const intResult = castToShape3D(resultShape, "INTERSECT_NOT_3D", "Intersect did not produce a 3D shape", "Shapes may not overlap. Verify they share a common volume before intersecting.");
+	if (diagnostics.hasErrors) {
+		require_shapeTypes.getKernel().dispose(resultShape);
+		return require_errors.err(require_errors.kernelError(require_errors.BrepErrorCode.BOOLEAN_HAS_ERRORS, "Boolean operation reported internal errors. The result may be invalid.", void 0, { diagnostics }, "Use checkBoolean() to pre-validate operands, or try autoHeal() on inputs."));
+	}
+	const intResult = castToShape3D(resultShape, "INTERSECT_NOT_3D", "Intersect did not produce a 3D shape", "Shapes may not overlap. Verify they share a common volume before intersecting.", diagnostics);
 	if (intResult.ok) require_arrayAccess.propagateAllMetadata(evolution, [a, b], intResult.value);
 	return intResult;
 }

package/dist/{booleanFns-B79ALtKn.js → booleanFns-iM6UPb8e.js}

@@ -1,9 +1,9 @@
-import { Y as getKernel, h as isShape3D, t as castShape } from "./shapeTypes-D38b_BKF.js";
-import { C as isErr, L as unwrap, d as validationError, i as kernelError, k as ok, l as typeCastError, t as BrepErrorCode, y as err } from "./errors-B1fl3mAU.js";
+import { Y as getKernel, h as isShape3D, t as castShape } from "./shapeTypes-CYb8Byqj.js";
+import { C as isErr, L as unwrap, d as validationError, i as kernelError, k as ok, l as typeCastError, t as BrepErrorCode, y as err } from "./errors-B_T0aMQF.js";
 import { h as vecScale, t as vecAdd, v as HASH_CODE_MAX } from "./vecOps-B9-MTeC8.js";
-import { o as resolvePlane } from "./planeOps-DPintPbl.js";
-import { F as getEdges, R as getVertices, b as propagateAllMetadata, n as getAtOrThrow, t as firstOrThrow, x as propagateMetadataByHash, y as collectInputFaceHashes, z as getWires } from "./arrayAccess-CccV7jov.js";
-import { r as makeFace } from "./surfaceBuilders-DiCVk_Un.js";
+import { o as resolvePlane } from "./planeOps-BuBXTLBr.js";
+import { F as getEdges, R as getVertices, b as propagateAllMetadata, n as getAtOrThrow, t as firstOrThrow, x as propagateMetadataByHash, y as collectInputFaceHashes, z as getWires } from "./arrayAccess-Dps31ERU.js";
+import { r as makeFace } from "./surfaceBuilders-DnGdDW8i.js";
 //#region src/topology/booleanFns.ts
 /**
 * Boolean and compound operations — functional replacements for _3DShape boolean methods.
@@ -13,7 +13,7 @@ function validateShape3D(shape, label) {
 	if (getKernel().isNull(shape.wrapped)) return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, `${label} is a null shape`));
 	return ok(void 0);
 }
-function castToShape3D(shape, errorCode, errorMsg, suggestion) {
+function castToShape3D(shape, errorCode, errorMsg, suggestion, diagnostics) {
 	const wrapped = castShape(shape);
 	if (!isShape3D(wrapped)) {
 		const shapeType = shape.ShapeType();
@@ -29,7 +29,7 @@ function castToShape3D(shape, errorCode, errorMsg, suggestion) {
 			"SHAPE"
 		][shapeType] ?? `UNKNOWN(${shapeType})`;
 		wrapped[Symbol.dispose]();
-		return err(typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`, void 0, void 0, suggestion));
+		return err(typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`, void 0, diagnostics ? { diagnostics } : void 0, suggestion));
 	}
 	return ok(wrapped);
 }
@@ -40,12 +40,16 @@ function fuse(a, b, { optimisation = "none", simplify = false, signal, fuzzyValu
 	const checkB = validateShape3D(b, "fuse: second operand");
 	if (isErr(checkB)) return checkB;
 	const inputFaceHashes = collectInputFaceHashes([a, b]);
-	const { shape: resultShape, evolution } = getKernel().fuseWithHistory(a.wrapped, b.wrapped, inputFaceHashes, HASH_CODE_MAX, {
+	const { shape: resultShape, evolution, diagnostics } = getKernel().fuseWithHistory(a.wrapped, b.wrapped, inputFaceHashes, HASH_CODE_MAX, {
 		optimisation,
 		simplify,
 		fuzzyValue
 	});
-	const fuseResult = castToShape3D(resultShape, "FUSE_NOT_3D", "Fuse did not produce a 3D shape", "Common causes: overlapping coplanar faces, zero-thickness geometry, or non-manifold input. Try autoHeal() on inputs first.");
+	if (diagnostics.hasErrors) {
+		getKernel().dispose(resultShape);
+		return err(kernelError(BrepErrorCode.BOOLEAN_HAS_ERRORS, "Boolean operation reported internal errors. The result may be invalid.", void 0, { diagnostics }, "Use checkBoolean() to pre-validate operands, or try autoHeal() on inputs."));
+	}
+	const fuseResult = castToShape3D(resultShape, "FUSE_NOT_3D", "Fuse did not produce a 3D shape", "Common causes: overlapping coplanar faces, zero-thickness geometry, or non-manifold input. Try autoHeal() on inputs first.", diagnostics);
 	if (fuseResult.ok) propagateAllMetadata(evolution, [a, b], fuseResult.value);
 	return fuseResult;
 }
@@ -56,12 +60,16 @@ function cut(base, tool, { optimisation = "none", simplify = false, signal, fuzz
 	const checkTool = validateShape3D(tool, "cut: tool");
 	if (isErr(checkTool)) return checkTool;
 	const inputFaceHashes = collectInputFaceHashes([base, tool]);
-	const { shape: resultShape, evolution } = getKernel().cutWithHistory(base.wrapped, tool.wrapped, inputFaceHashes, HASH_CODE_MAX, {
+	const { shape: resultShape, evolution, diagnostics } = getKernel().cutWithHistory(base.wrapped, tool.wrapped, inputFaceHashes, HASH_CODE_MAX, {
 		optimisation,
 		simplify,
 		fuzzyValue
 	});
-	const cutResult = castToShape3D(resultShape, "CUT_NOT_3D", "Cut did not produce a 3D shape", "Common causes: tool does not fully intersect the base, or produces a zero-thickness sliver. Ensure the tool extends through the shape.");
+	if (diagnostics.hasErrors) {
+		getKernel().dispose(resultShape);
+		return err(kernelError(BrepErrorCode.BOOLEAN_HAS_ERRORS, "Boolean operation reported internal errors. The result may be invalid.", void 0, { diagnostics }, "Use checkBoolean() to pre-validate operands, or try autoHeal() on inputs."));
+	}
+	const cutResult = castToShape3D(resultShape, "CUT_NOT_3D", "Cut did not produce a 3D shape", "Common causes: tool does not fully intersect the base, or produces a zero-thickness sliver. Ensure the tool extends through the shape.", diagnostics);
 	if (cutResult.ok) propagateAllMetadata(evolution, [base, tool], cutResult.value);
 	return cutResult;
 }
@@ -72,11 +80,15 @@ function intersect(a, b, { simplify = false, signal, fuzzyValue, unsafe: _unsafe
 	const checkB = validateShape3D(b, "intersect: second operand");
 	if (isErr(checkB)) return checkB;
 	const inputFaceHashes = collectInputFaceHashes([a, b]);
-	const { shape: resultShape, evolution } = getKernel().intersectWithHistory(a.wrapped, b.wrapped, inputFaceHashes, HASH_CODE_MAX, {
+	const { shape: resultShape, evolution, diagnostics } = getKernel().intersectWithHistory(a.wrapped, b.wrapped, inputFaceHashes, HASH_CODE_MAX, {
 		simplify,
 		fuzzyValue
 	});
-	const intResult = castToShape3D(resultShape, "INTERSECT_NOT_3D", "Intersect did not produce a 3D shape", "Shapes may not overlap. Verify they share a common volume before intersecting.");
+	if (diagnostics.hasErrors) {
+		getKernel().dispose(resultShape);
+		return err(kernelError(BrepErrorCode.BOOLEAN_HAS_ERRORS, "Boolean operation reported internal errors. The result may be invalid.", void 0, { diagnostics }, "Use checkBoolean() to pre-validate operands, or try autoHeal() on inputs."));
+	}
+	const intResult = castToShape3D(resultShape, "INTERSECT_NOT_3D", "Intersect did not produce a 3D shape", "Shapes may not overlap. Verify they share a common volume before intersecting.", diagnostics);
 	if (intResult.ok) propagateAllMetadata(evolution, [a, b], intResult.value);
 	return intResult;
 }