brepjs 13.1.0 → 13.4.0

package/dist/{blueprint-Bpa-w3WF.js → blueprint-CB_85Lz_.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-Beo7ikOL.js";
-import { L as unwrap, d as validationError, k as ok, m as bug, n as computationError, y as err } from "./errors-D7ZQfeqv.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-D4THn1al.js";
-import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-6mY9O_5h.js";
-import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-Bz2OkAF_.js";
-import { f as getOrientation } from "./curveFns-CzcOFFDX.js";
-import { r as makeFace } from "./surfaceBuilders-BC0MvMK1.js";
-import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-C9PtrI6D.js";
+import { H as registerForCleanup, W as unregisterFromCleanup, X as getKernel2D, Y as getKernel, a as createEdge, u as createWire } from "./shapeTypes-Di6GlhPk.js";
+import { L as unwrap, d as validationError, k as ok, m as bug, n as computationError, y as err } from "./errors-BVOlxlIA.js";
+import { _ as DEG2RAD, y as RAD2DEG } from "./vecOps-DFfUfsmc.js";
+import { r as toVec3 } from "./types-BWBlwp6w.js";
+import { r as makePlane } from "./planeOps-D88tfyJs.js";
+import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-Cat-4X74.js";
+import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-B5LgmXBo.js";
+import { f as getOrientation } from "./curveFns-DY4dFcP-.js";
+import { r as makeFace } from "./surfaceBuilders-BaqeZa0x.js";
+import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-DgX1UucG.js";
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprint-YPV8lQqg.cjs → blueprint-CDnBM-tA.cjs}

@@ -1,13 +1,13 @@
-const require_shapeTypes = require("./shapeTypes-Du2qyM2n.cjs");
-const require_errors = require("./errors-BDTFTJ22.cjs");
-const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_types = require("./types-BD-VVaWB.cjs");
-const require_planeOps = require("./planeOps-DA5DmML2.cjs");
-const require_faceFns = require("./faceFns-DSUZvptN.cjs");
-const require_arrayAccess = require("./arrayAccess-FwdVX3Nh.cjs");
-const require_curveFns = require("./curveFns-DHFAK2lD.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BCiMuuGV.cjs");
-const require_helpers = require("./helpers-BWZ7h12W.cjs");
+const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_vecOps = require("./vecOps-DKGelwGL.cjs");
+const require_types = require("./types-BjDcsS7l.cjs");
+const require_planeOps = require("./planeOps-BqLav0Ir.cjs");
+const require_faceFns = require("./faceFns-BywUjlJ7.cjs");
+const require_arrayAccess = require("./arrayAccess-t2dlxGSK.cjs");
+const require_curveFns = require("./curveFns-CZszKLQB.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-CZzipftq.cjs");
+const require_helpers = require("./helpers-1iCCEElA.cjs");
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {

package/dist/{blueprintFns-iQsyPfTY.cjs → blueprintFns-D4YucGaQ.cjs}

@@ -1,6 +1,127 @@
-const require_errors = require("./errors-BDTFTJ22.cjs");
-const require_boolean2D = require("./boolean2D-CMXMxTgD.cjs");
-const require_blueprint = require("./blueprint-YPV8lQqg.cjs");
+const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_boolean2D = require("./boolean2D-lqfKJKUY.cjs");
+const require_blueprint = require("./blueprint-CDnBM-tA.cjs");
+//#region src/core/kernelCall.ts
+var errorFactories = {
+	KERNEL_OPERATION: (code, message, cause) => ({
+		kind: "KERNEL_OPERATION",
+		code,
+		message,
+		cause
+	}),
+	VALIDATION: (code, message, cause) => ({
+		kind: "VALIDATION",
+		code,
+		message,
+		cause
+	}),
+	TYPE_CAST: (code, message, cause) => ({
+		kind: "TYPE_CAST",
+		code,
+		message,
+		cause
+	}),
+	SKETCHER_STATE: (code, message, cause) => ({
+		kind: "SKETCHER_STATE",
+		code,
+		message,
+		cause
+	}),
+	MODULE_INIT: (code, message, cause) => ({
+		kind: "MODULE_INIT",
+		code,
+		message,
+		cause
+	}),
+	COMPUTATION: (code, message, cause) => ({
+		kind: "COMPUTATION",
+		code,
+		message,
+		cause
+	}),
+	IO: (code, message, cause) => ({
+		kind: "IO",
+		code,
+		message,
+		cause
+	}),
+	QUERY: (code, message, cause) => ({
+		kind: "QUERY",
+		code,
+		message,
+		cause
+	}),
+	UNSUPPORTED: (code, message, cause) => ({
+		kind: "UNSUPPORTED",
+		code,
+		message,
+		cause
+	})
+};
+/**
+* Wrap a kernel call that returns an KernelShape, automatically casting
+* the result into a branded AnyShape. On exception, returns an Err
+* with the given error code and message.
+*
+* kernel error messages are automatically translated into user-friendly
+* explanations when the error kind is KERNEL_OPERATION.
+*/
+function kernelCall(fn, code, message, kind = "KERNEL_OPERATION") {
+	try {
+		return require_errors.ok(require_shapeTypes.castShape(fn()));
+	} catch (e) {
+		const rawMessage = e instanceof Error ? e.message : String(e);
+		const translatedMessage = kind === "KERNEL_OPERATION" ? require_errors.translateKernelError(rawMessage) : rawMessage;
+		return require_errors.err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e));
+	}
+}
+/**
+* Wrap a kernel call that returns an arbitrary value. On exception,
+* returns an Err with the given error code and message.
+*
+* kernel error messages are automatically translated into user-friendly
+* explanations when the error kind is KERNEL_OPERATION.
+*/
+function kernelCallRaw(fn, code, message, kind = "KERNEL_OPERATION") {
+	try {
+		return require_errors.ok(fn());
+	} catch (e) {
+		const rawMessage = e instanceof Error ? e.message : String(e);
+		const translatedMessage = kind === "KERNEL_OPERATION" ? require_errors.translateKernelError(rawMessage) : rawMessage;
+		return require_errors.err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e));
+	}
+}
+/**
+* Wrap a kernel call that needs intermediate kernel allocations.
+*
+* A DisposalScope is created and passed to fn. The scope is disposed
+* deterministically after fn returns or throws — ensuring no intermediate
+* handles are leaked even on error paths.
+*
+* ```ts
+* return kernelCallScoped(
+*   (scope) => {
+*     const axis = scope.register(makeKernelAx1(origin, dir));
+*     return getKernel().revolveVec(...) // was: oc.BRepBuilderAPI_MakeRevol_1(shape.wrapped, axis).Shape();
+*   },
+*   BrepErrorCode.REVOLUTION_NOT_3D,
+*   'Revolution failed'
+* );
+* ```
+*/
+function kernelCallScoped(fn, code, message, kind = "KERNEL_OPERATION") {
+	try {
+		var _usingCtx$1 = require_shapeTypes._usingCtx();
+		const scope = _usingCtx$1.u(new require_shapeTypes.DisposalScope());
+		return kernelCall(() => fn(scope), code, message, kind);
+	} catch (_) {
+		_usingCtx$1.e = _;
+	} finally {
+		_usingCtx$1.d();
+	}
+}
+//#endregion
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).
@@ -206,6 +327,24 @@ Object.defineProperty(exports, "isInside2D", {
 		return isInside2D;
 	}
 });
+Object.defineProperty(exports, "kernelCall", {
+	enumerable: true,
+	get: function() {
+		return kernelCall;
+	}
+});
+Object.defineProperty(exports, "kernelCallRaw", {
+	enumerable: true,
+	get: function() {
+		return kernelCallRaw;
+	}
+});
+Object.defineProperty(exports, "kernelCallScoped", {
+	enumerable: true,
+	get: function() {
+		return kernelCallScoped;
+	}
+});
 Object.defineProperty(exports, "mirror2D", {
 	enumerable: true,
 	get: function() {

package/dist/{blueprintFns-D0RopDZS.js → blueprintFns-DVDommWB.js}

@@ -1,6 +1,127 @@
-import { d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-D7ZQfeqv.js";
-import { h as CompoundBlueprint } from "./boolean2D-D_yuF0kT.js";
-import { t as Blueprint } from "./blueprint-Bpa-w3WF.js";
+import { J as _usingCtx, L as DisposalScope, t as castShape } from "./shapeTypes-Di6GlhPk.js";
+import { d as validationError, f as translateKernelError, k as ok, t as BrepErrorCode, y as err } from "./errors-BVOlxlIA.js";
+import { h as CompoundBlueprint } from "./boolean2D-Mzp-0g7o.js";
+import { t as Blueprint } from "./blueprint-CB_85Lz_.js";
+//#region src/core/kernelCall.ts
+var errorFactories = {
+	KERNEL_OPERATION: (code, message, cause) => ({
+		kind: "KERNEL_OPERATION",
+		code,
+		message,
+		cause
+	}),
+	VALIDATION: (code, message, cause) => ({
+		kind: "VALIDATION",
+		code,
+		message,
+		cause
+	}),
+	TYPE_CAST: (code, message, cause) => ({
+		kind: "TYPE_CAST",
+		code,
+		message,
+		cause
+	}),
+	SKETCHER_STATE: (code, message, cause) => ({
+		kind: "SKETCHER_STATE",
+		code,
+		message,
+		cause
+	}),
+	MODULE_INIT: (code, message, cause) => ({
+		kind: "MODULE_INIT",
+		code,
+		message,
+		cause
+	}),
+	COMPUTATION: (code, message, cause) => ({
+		kind: "COMPUTATION",
+		code,
+		message,
+		cause
+	}),
+	IO: (code, message, cause) => ({
+		kind: "IO",
+		code,
+		message,
+		cause
+	}),
+	QUERY: (code, message, cause) => ({
+		kind: "QUERY",
+		code,
+		message,
+		cause
+	}),
+	UNSUPPORTED: (code, message, cause) => ({
+		kind: "UNSUPPORTED",
+		code,
+		message,
+		cause
+	})
+};
+/**
+* Wrap a kernel call that returns an KernelShape, automatically casting
+* the result into a branded AnyShape. On exception, returns an Err
+* with the given error code and message.
+*
+* kernel error messages are automatically translated into user-friendly
+* explanations when the error kind is KERNEL_OPERATION.
+*/
+function kernelCall(fn, code, message, kind = "KERNEL_OPERATION") {
+	try {
+		return ok(castShape(fn()));
+	} catch (e) {
+		const rawMessage = e instanceof Error ? e.message : String(e);
+		const translatedMessage = kind === "KERNEL_OPERATION" ? translateKernelError(rawMessage) : rawMessage;
+		return err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e));
+	}
+}
+/**
+* Wrap a kernel call that returns an arbitrary value. On exception,
+* returns an Err with the given error code and message.
+*
+* kernel error messages are automatically translated into user-friendly
+* explanations when the error kind is KERNEL_OPERATION.
+*/
+function kernelCallRaw(fn, code, message, kind = "KERNEL_OPERATION") {
+	try {
+		return ok(fn());
+	} catch (e) {
+		const rawMessage = e instanceof Error ? e.message : String(e);
+		const translatedMessage = kind === "KERNEL_OPERATION" ? translateKernelError(rawMessage) : rawMessage;
+		return err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e));
+	}
+}
+/**
+* Wrap a kernel call that needs intermediate kernel allocations.
+*
+* A DisposalScope is created and passed to fn. The scope is disposed
+* deterministically after fn returns or throws — ensuring no intermediate
+* handles are leaked even on error paths.
+*
+* ```ts
+* return kernelCallScoped(
+*   (scope) => {
+*     const axis = scope.register(makeKernelAx1(origin, dir));
+*     return getKernel().revolveVec(...) // was: oc.BRepBuilderAPI_MakeRevol_1(shape.wrapped, axis).Shape();
+*   },
+*   BrepErrorCode.REVOLUTION_NOT_3D,
+*   'Revolution failed'
+* );
+* ```
+*/
+function kernelCallScoped(fn, code, message, kind = "KERNEL_OPERATION") {
+	try {
+		var _usingCtx$1 = _usingCtx();
+		const scope = _usingCtx$1.u(new DisposalScope());
+		return kernelCall(() => fn(scope), code, message, kind);
+	} catch (_) {
+		_usingCtx$1.e = _;
+	} finally {
+		_usingCtx$1.d();
+	}
+}
+//#endregion
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).
@@ -128,4 +249,4 @@ function sketchOnFace2D(bp, face, scaleMode) {
 	return bp.sketchOnFace(face, scaleMode);
 }
 //#endregion
-export { reverseCurve as S, curve2dIsOnCurve as _, isInside2D as a, curve2dSplitAt as b, scale2D as c, stretch2D as d, toSVGPathD as f, curve2dFirstPoint as g, curve2dDistanceFrom as h, getOrientation2D as i, sketchOnFace2D as l, curve2dBoundingBox as m, createCompoundBlueprint as n, mirror2D as o, translate2D as p, getBounds2D as r, rotate2D as s, createBlueprint as t, sketchOnPlane2D as u, curve2dLastPoint as v, curve2dTangentAt as x, curve2dParameter as y };
+export { kernelCall as C, reverseCurve as S, kernelCallScoped as T, curve2dIsOnCurve as _, isInside2D as a, curve2dSplitAt as b, scale2D as c, stretch2D as d, toSVGPathD as f, curve2dFirstPoint as g, curve2dDistanceFrom as h, getOrientation2D as i, sketchOnFace2D as l, curve2dBoundingBox as m, createCompoundBlueprint as n, mirror2D as o, translate2D as p, getBounds2D as r, rotate2D as s, createBlueprint as t, sketchOnPlane2D as u, curve2dLastPoint as v, kernelCallRaw as w, curve2dTangentAt as x, curve2dParameter as y };

package/dist/{boolean2D-D_yuF0kT.js → boolean2D-Mzp-0g7o.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-Beo7ikOL.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-D7ZQfeqv.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-D4THn1al.js";
-import { _ as downcast, c as normalAt, p as uvBounds, u as pointOnSurface } from "./faceFns-6mY9O_5h.js";
-import { r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-Bz2OkAF_.js";
-import { c as curveStartPoint, l as curveTangentAt, r as curveIsClosed } from "./curveFns-CzcOFFDX.js";
-import { _ as zip, i as makeNewFaceWithinFace, r as makeFace, s as assembleWire } from "./surfaceBuilders-BC0MvMK1.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-C9PtrI6D.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-Bpa-w3WF.js";
-import { c as twistExtrude, n as revolve, r as complexExtrude, s as sweep, t as extrude } from "./extrudeFns-CDWViQSe.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-Di6GlhPk.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-BVOlxlIA.js";
+import { _ as DEG2RAD, d as vecNormalize, h as vecScale, r as vecCross, y as RAD2DEG } from "./vecOps-DFfUfsmc.js";
+import { r as toVec3 } from "./types-BWBlwp6w.js";
+import { n as createPlane } from "./planeOps-D88tfyJs.js";
+import { _ as downcast, c as normalAt, p as uvBounds, u as pointOnSurface } from "./faceFns-Cat-4X74.js";
+import { r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-B5LgmXBo.js";
+import { c as curveStartPoint, l as curveTangentAt, r as curveIsClosed } from "./curveFns-DY4dFcP-.js";
+import { _ as zip, i as makeNewFaceWithinFace, r as makeFace, s as assembleWire } from "./surfaceBuilders-BaqeZa0x.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-DgX1UucG.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-CB_85Lz_.js";
+import { c as twistExtrude, n as revolve, r as complexExtrude, s as sweep, t as extrude } from "./extrudeFns-b0uLn4E4.js";
 //#region node_modules/flatqueue/index.js
 /** @template T */
 var FlatQueue = class {

package/dist/{boolean2D-CMXMxTgD.cjs → boolean2D-lqfKJKUY.cjs}

@@ -1,15 +1,15 @@
-const require_shapeTypes = require("./shapeTypes-Du2qyM2n.cjs");
-const require_errors = require("./errors-BDTFTJ22.cjs");
-const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_types = require("./types-BD-VVaWB.cjs");
-const require_planeOps = require("./planeOps-DA5DmML2.cjs");
-const require_faceFns = require("./faceFns-DSUZvptN.cjs");
-const require_arrayAccess = require("./arrayAccess-FwdVX3Nh.cjs");
-const require_curveFns = require("./curveFns-DHFAK2lD.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BCiMuuGV.cjs");
-const require_helpers = require("./helpers-BWZ7h12W.cjs");
-const require_blueprint = require("./blueprint-YPV8lQqg.cjs");
-const require_extrudeFns = require("./extrudeFns-CqKzY5BT.cjs");
+const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_vecOps = require("./vecOps-DKGelwGL.cjs");
+const require_types = require("./types-BjDcsS7l.cjs");
+const require_planeOps = require("./planeOps-BqLav0Ir.cjs");
+const require_faceFns = require("./faceFns-BywUjlJ7.cjs");
+const require_arrayAccess = require("./arrayAccess-t2dlxGSK.cjs");
+const require_curveFns = require("./curveFns-CZszKLQB.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-CZzipftq.cjs");
+const require_helpers = require("./helpers-1iCCEElA.cjs");
+const require_blueprint = require("./blueprint-CDnBM-tA.cjs");
+const require_extrudeFns = require("./extrudeFns-GpCB_Uzs.cjs");
 //#region node_modules/flatqueue/index.js
 /** @template T */
 var FlatQueue = class {

package/dist/{booleanFns-omB4YLGU.js → booleanFns-B46fgObh.js}

@@ -1,9 +1,9 @@
-import { Y as getKernel, h as isShape3D, t as castShape } from "./shapeTypes-Beo7ikOL.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-D7ZQfeqv.js";
-import { h as vecScale, t as vecAdd, v as HASH_CODE_MAX } from "./vecOps-B9-MTeC8.js";
-import { o as resolvePlane } from "./planeOps-D4THn1al.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-Bz2OkAF_.js";
-import { r as makeFace } from "./surfaceBuilders-BC0MvMK1.js";
+import { Y as getKernel, h as isShape3D, t as castShape } from "./shapeTypes-Di6GlhPk.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-BVOlxlIA.js";
+import { h as vecScale, t as vecAdd, v as HASH_CODE_MAX } from "./vecOps-DFfUfsmc.js";
+import { o as resolvePlane } from "./planeOps-D88tfyJs.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-B5LgmXBo.js";
+import { r as makeFace } from "./surfaceBuilders-BaqeZa0x.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;
 }

package/dist/{booleanFns-o7EsqNGM.cjs → booleanFns-Bw8sAMgI.cjs}

@@ -1,9 +1,9 @@
-const require_shapeTypes = require("./shapeTypes-Du2qyM2n.cjs");
-const require_errors = require("./errors-BDTFTJ22.cjs");
-const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_planeOps = require("./planeOps-DA5DmML2.cjs");
-const require_arrayAccess = require("./arrayAccess-FwdVX3Nh.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-BCiMuuGV.cjs");
+const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_vecOps = require("./vecOps-DKGelwGL.cjs");
+const require_planeOps = require("./planeOps-BqLav0Ir.cjs");
+const require_arrayAccess = require("./arrayAccess-t2dlxGSK.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-CZzipftq.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;
 }