brepjs 13.4.0 → 14.1.2

package/dist/{drawFns-l5CY2s-l.js → drawFns-n9qif7QN.js}

@@ -1,18 +1,20 @@
-import { J as _usingCtx, L as DisposalScope, Y as getKernel, o as createFace, p as isFace, t as castShape, u as createWire } from "./shapeTypes-Di6GlhPk.js";
-import { L as unwrap, d as validationError, k as ok, m as bug, r as ioError, s as safeIndex, t as BrepErrorCode, w as isOk, y as err } from "./errors-BVOlxlIA.js";
-import { _ as DEG2RAD, c as vecLength, d as vecNormalize, g as vecSub, h as vecScale, m as vecRotate, r as vecCross } from "./vecOps-DFfUfsmc.js";
+import { J as _usingCtx, L as DisposalScope, Y as getKernel, o as createFace, p as isFace, t as castShape, u as createWire } from "./shapeTypes-BO1aiDhi.js";
+import { A as ok, R as unwrap, T as isOk, b as err, d as validationError, h as bug, r as ioError, s as safeIndex, t as BrepErrorCode } from "./errors-C-cgQA3w.js";
+import { _ as downcast, c as normalAt, g as cast, l as outerWire, n as faceCenter } from "./faceFns-TSH54pPQ.js";
+import { t as DEG2RAD } from "./constants-B9u763C3.js";
 import { r as toVec3 } from "./types-BWBlwp6w.js";
-import { a as planeToWorld, o as resolvePlane } from "./planeOps-D88tfyJs.js";
-import { _ as downcast, c as normalAt, g as cast, l as outerWire, n as faceCenter } from "./faceFns-Cat-4X74.js";
-import { F as getEdges, n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-B5LgmXBo.js";
-import { m as offsetWire2D } from "./curveFns-DY4dFcP-.js";
-import { c as makeBSplineApproximation, d as makeEllipse, p as makeHelix, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeCircle } from "./surfaceBuilders-BaqeZa0x.js";
-import { _ as chamferCurves, b as intersectCurves, c as roundedRectangleBlueprint, f as Sketch, g as Blueprints, h as CompoundBlueprint, l as BaseSketcher2d, m as organiseBlueprints, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D, u as BlueprintSketcher, v as filletCurves, x as Flatbush, y as make2dOffset } from "./boolean2D-Mzp-0g7o.js";
-import { _ as samePoint$1, b as subtract2d, c as PRECISION_OFFSET, l as add2d, y as squareDistance2d } from "./helpers-DgX1UucG.js";
-import { _ as Curve2D, a as edgeToCurve, c as make2dCircle, d as make2dInerpolatedBSplineCurve, f as make2dSegmentCurve, g as approximateAsSvgCompatibleCurve, i as curvesAsEdgesOnPlane, l as make2dEllipse, o as make2dArcFromCenter, t as Blueprint, v as deserializeCurve2D, y as BoundingBox2d } from "./blueprint-CB_85Lz_.js";
-import { o as makeSolid, t as makeCompound } from "./solidBuilders-ctO_wFrm.js";
-import { t as cornerFinder } from "./cornerFinder-aBLykolI.js";
-import { c as twistExtrude, n as revolve, r as complexExtrude, t as extrude } from "./extrudeFns-b0uLn4E4.js";
+import { c as vecLength, d as vecNormalize, g as vecSub, h as vecScale, m as vecRotate, r as vecCross } from "./vecOps-D9etjPgV.js";
+import { a as planeToWorld, o as resolvePlane } from "./planeOps-gTOEarV2.js";
+import { M as getEdges } from "./shapeFns-DCi9O27X.js";
+import { m as offsetWire2D } from "./curveFns-CcInoOEA.js";
+import { n as getAtOrThrow, r as lastOrThrow, t as firstOrThrow } from "./arrayAccess-xxcB3YNq.js";
+import { c as makeBSplineApproximation, d as makeEllipse, p as makeHelix, r as makeFace, s as assembleWire, t as addHolesInFace, u as makeCircle } from "./surfaceBuilders-DE5e6bp8.js";
+import { _ as chamferCurves, b as intersectCurves, c as roundedRectangleBlueprint, f as Sketch, g as Blueprints, h as CompoundBlueprint, l as BaseSketcher2d, m as organiseBlueprints, n as fuse2D, r as intersect2D, s as polysidesBlueprint, t as cut2D, u as BlueprintSketcher, v as filletCurves, x as Flatbush, y as make2dOffset } from "./boolean2D-D_Te-6N6.js";
+import { _ as samePoint$1, b as subtract2d, c as PRECISION_OFFSET, l as add2d, y as squareDistance2d } from "./helpers-XrXlKm8D.js";
+import { _ as Curve2D, a as edgeToCurve, c as make2dCircle, d as make2dInerpolatedBSplineCurve, f as make2dSegmentCurve, g as approximateAsSvgCompatibleCurve, i as curvesAsEdgesOnPlane, l as make2dEllipse, o as make2dArcFromCenter, t as Blueprint, v as deserializeCurve2D, y as BoundingBox2d } from "./blueprint-B3A5x7P9.js";
+import { o as makeSolid, t as makeCompound } from "./solidBuilders-jk7HfWs8.js";
+import { t as cornerFinder } from "./cornerFinder-AEFnAxt4.js";
+import { c as twistExtrude, n as revolve, r as complexExtrude, t as extrude } from "./extrudeFns-DrDr9-nU.js";
 import opentype from "opentype.js";
 //#region src/2d/lib/stitching.ts
 /**

package/dist/{errors-BlC5ZWv4.cjs → errors-9zQcQK1H.cjs}

@@ -247,6 +247,24 @@ var kernel_ERROR_PATTERNS = [
 		translation: "Shape validation failed. The resulting shape has invalid topology. Try healing the shape or checking input geometry."
 	}
 ];
+var ERROR_CODE_SUGGESTIONS = {
+	FUSE_FAILED: "Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.",
+	CUT_FAILED: "Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.",
+	FUSE_NOT_3D: "The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.",
+	CUT_NOT_3D: "The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.",
+	INTERSECT_NOT_3D: "The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.",
+	SWEEP_FAILED: "Ensure the spine curve has no sharp corners or self-intersections. Try simplifying the profile or using a smoother path.",
+	LOFT_FAILED: "Check that all profiles have the same number of edges and consistent orientation. Try reordering profiles.",
+	FILLET_NOT_3D: "The fillet radius may be too large for the selected edges. Try a smaller radius or check that adjacent faces have enough room.",
+	CHAMFER_NOT_3D: "The chamfer distance may be too large. Try a smaller distance or check edge geometry.",
+	SHELL_NOT_3D: "The shell thickness may be too large for the shape. Try reducing thickness or removing problematic faces.",
+	OFFSET_NOT_3D: "The offset distance may be too large for the shape geometry. Try a smaller distance.",
+	DRAFT_FAILED: "The draft angle may be too large or the selected faces incompatible. Try a smaller angle or different faces."
+};
+/** Look up an actionable suggestion for a given error code. */
+function getSuggestionForCode(code) {
+	return ERROR_CODE_SUGGESTIONS[code];
+}
 /**
 * Translate an kernel error message into a user-friendly explanation.
 * If no pattern matches, returns the original message.
@@ -347,6 +365,7 @@ var BrepErrorCode = {
 	INTERSECTION_FAILED: "INTERSECTION_FAILED",
 	SELF_INTERSECTION_FAILED: "SELF_INTERSECTION_FAILED",
 	STRAIGHT_SKELETON_FAILED: "STRAIGHT_SKELETON_FAILED",
+	CENTER_OF_MASS_FAILED: "CENTER_OF_MASS_FAILED",
 	COMPOUND_NO_FACES: "COMPOUND_NO_FACES",
 	COMPOUND_FACE_NOT_FOUND: "COMPOUND_FACE_NOT_FOUND",
 	FINDER_NOT_UNIQUE: "FINDER_NOT_UNIQUE",
@@ -384,6 +403,9 @@ var BrepErrorCode = {
 	CURVE2D_QUERY_FAILED: "CURVE2D_QUERY_FAILED",
 	CURVE2D_INTERSECTION_FAILED: "CURVE2D_INTERSECTION_FAILED",
 	CURVE2D_BRIDGE_FAILED: "CURVE2D_BRIDGE_FAILED",
+	CLONE_FAILED: "CLONE_FAILED",
+	SIMPLIFY_FAILED: "SIMPLIFY_FAILED",
+	TO_BREP_FAILED: "TO_BREP_FAILED",
 	UNSUPPORTED_CAPABILITY: "UNSUPPORTED_CAPABILITY"
 };
 function makeError(kind, code, message, cause, metadata, suggestion) {
@@ -534,6 +556,12 @@ Object.defineProperty(exports, "fromNullable", {
 		return fromNullable;
 	}
 });
+Object.defineProperty(exports, "getSuggestionForCode", {
+	enumerable: true,
+	get: function() {
+		return getSuggestionForCode;
+	}
+});
 Object.defineProperty(exports, "ioError", {
 	enumerable: true,
 	get: function() {

package/dist/{errors-BVOlxlIA.js → errors-C-cgQA3w.js}

@@ -247,6 +247,24 @@ var kernel_ERROR_PATTERNS = [
 		translation: "Shape validation failed. The resulting shape has invalid topology. Try healing the shape or checking input geometry."
 	}
 ];
+var ERROR_CODE_SUGGESTIONS = {
+	FUSE_FAILED: "Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.",
+	CUT_FAILED: "Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.",
+	FUSE_NOT_3D: "The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.",
+	CUT_NOT_3D: "The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.",
+	INTERSECT_NOT_3D: "The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.",
+	SWEEP_FAILED: "Ensure the spine curve has no sharp corners or self-intersections. Try simplifying the profile or using a smoother path.",
+	LOFT_FAILED: "Check that all profiles have the same number of edges and consistent orientation. Try reordering profiles.",
+	FILLET_NOT_3D: "The fillet radius may be too large for the selected edges. Try a smaller radius or check that adjacent faces have enough room.",
+	CHAMFER_NOT_3D: "The chamfer distance may be too large. Try a smaller distance or check edge geometry.",
+	SHELL_NOT_3D: "The shell thickness may be too large for the shape. Try reducing thickness or removing problematic faces.",
+	OFFSET_NOT_3D: "The offset distance may be too large for the shape geometry. Try a smaller distance.",
+	DRAFT_FAILED: "The draft angle may be too large or the selected faces incompatible. Try a smaller angle or different faces."
+};
+/** Look up an actionable suggestion for a given error code. */
+function getSuggestionForCode(code) {
+	return ERROR_CODE_SUGGESTIONS[code];
+}
 /**
 * Translate an kernel error message into a user-friendly explanation.
 * If no pattern matches, returns the original message.
@@ -347,6 +365,7 @@ var BrepErrorCode = {
 	INTERSECTION_FAILED: "INTERSECTION_FAILED",
 	SELF_INTERSECTION_FAILED: "SELF_INTERSECTION_FAILED",
 	STRAIGHT_SKELETON_FAILED: "STRAIGHT_SKELETON_FAILED",
+	CENTER_OF_MASS_FAILED: "CENTER_OF_MASS_FAILED",
 	COMPOUND_NO_FACES: "COMPOUND_NO_FACES",
 	COMPOUND_FACE_NOT_FOUND: "COMPOUND_FACE_NOT_FOUND",
 	FINDER_NOT_UNIQUE: "FINDER_NOT_UNIQUE",
@@ -384,6 +403,9 @@ var BrepErrorCode = {
 	CURVE2D_QUERY_FAILED: "CURVE2D_QUERY_FAILED",
 	CURVE2D_INTERSECTION_FAILED: "CURVE2D_INTERSECTION_FAILED",
 	CURVE2D_BRIDGE_FAILED: "CURVE2D_BRIDGE_FAILED",
+	CLONE_FAILED: "CLONE_FAILED",
+	SIMPLIFY_FAILED: "SIMPLIFY_FAILED",
+	TO_BREP_FAILED: "TO_BREP_FAILED",
 	UNSUPPORTED_CAPABILITY: "UNSUPPORTED_CAPABILITY"
 };
 function makeError(kind, code, message, cause, metadata, suggestion) {
@@ -462,4 +484,4 @@ function safeIndex(arr, index, context) {
 	return arr[index];
 }
 //#endregion
-export { or as A, unwrapOrElse as B, isErr as C, mapErr as D, mapBoth as E, tryCatch as F, tryCatchAsync as I, unwrap as L, pipeline as M, tap as N, match as O, tapErr as P, unwrapErr as R, fromNullable as S, map as T, zip as V, andThen as _, moduleInitError as a, flatMap as b, sketcherStateError as c, validationError as d, translateKernelError as f, all as g, OK as h, kernelError as i, orElse as j, ok as k, typeCastError as l, bug as m, computationError as n, queryError as o, BrepBugError as p, ioError as r, safeIndex as s, BrepErrorCode as t, unsupportedError as u, collect as v, isOk as w, flatten as x, err as y, unwrapOr as z };
+export { ok as A, unwrapOr as B, fromNullable as C, mapBoth as D, map as E, tapErr as F, zip as H, tryCatch as I, tryCatchAsync as L, orElse as M, pipeline as N, mapErr as O, tap as P, unwrap as R, flatten as S, isOk as T, unwrapOrElse as V, all as _, moduleInitError as a, err as b, sketcherStateError as c, validationError as d, getSuggestionForCode as f, OK as g, bug as h, kernelError as i, or as j, match as k, typeCastError as l, BrepBugError as m, computationError as n, queryError as o, translateKernelError as p, ioError as r, safeIndex as s, BrepErrorCode as t, unsupportedError as u, andThen as v, isErr as w, flatMap as x, collect as y, unwrapErr as z };

package/dist/{extrudeFns-b0uLn4E4.js → extrudeFns-DrDr9-nU.js}

@@ -1,6 +1,6 @@
-import { Y as getKernel, c as createSolid, h as isShape3D, t as castShape, y as isWire } from "./shapeTypes-Di6GlhPk.js";
-import { 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 { c as vecLength, d as vecNormalize, t as vecAdd } from "./vecOps-DFfUfsmc.js";
+import { Y as getKernel, c as createSolid, h as isShape3D, t as castShape, y as isWire } from "./shapeTypes-BO1aiDhi.js";
+import { A as ok, R as unwrap, b as err, d as validationError, i as kernelError, l as typeCastError, t as BrepErrorCode } from "./errors-C-cgQA3w.js";
+import { c as vecLength, d as vecNormalize, t as vecAdd } from "./vecOps-D9etjPgV.js";
 //#region src/operations/extrudeUtils.ts
 /**
 * Build an kernel scaling law from an extrusion profile configuration.

package/dist/{extrudeFns-GpCB_Uzs.cjs → extrudeFns-Rcut7h8S.cjs}

@@ -1,6 +1,6 @@
-const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
-const require_errors = require("./errors-BlC5ZWv4.cjs");
-const require_vecOps = require("./vecOps-DKGelwGL.cjs");
+const require_shapeTypes = require("./shapeTypes-BqWQlrYE.cjs");
+const require_errors = require("./errors-9zQcQK1H.cjs");
+const require_vecOps = require("./vecOps-BXvBYIor.cjs");
 //#region src/operations/extrudeUtils.ts
 /**
 * Build an kernel scaling law from an extrusion profile configuration.

package/dist/{faceFns-Cat-4X74.js → faceFns-TSH54pPQ.js}

@@ -1,6 +1,96 @@
-import { Y as getKernel, t as castShape } from "./shapeTypes-Di6GlhPk.js";
-import { L as unwrap, k as ok, l as typeCastError, y as err } from "./errors-BVOlxlIA.js";
+import { J as _usingCtx, L as DisposalScope, Y as getKernel, t as castShape } from "./shapeTypes-BO1aiDhi.js";
+import { A as ok, R as unwrap, b as err, f as getSuggestionForCode, l as typeCastError, p as translateKernelError } from "./errors-C-cgQA3w.js";
 import { r as toVec3 } from "./types-BWBlwp6w.js";
+//#region src/core/kernelCall.ts
+function buildError(kind, code, message, cause, suggestion) {
+	const base = {
+		kind,
+		code,
+		message,
+		cause
+	};
+	if (suggestion) return {
+		...base,
+		suggestion
+	};
+	return base;
+}
+var errorFactories = {
+	KERNEL_OPERATION: (code, message, cause, suggestion) => buildError("KERNEL_OPERATION", code, message, cause, suggestion),
+	VALIDATION: (code, message, cause, suggestion) => buildError("VALIDATION", code, message, cause, suggestion),
+	TYPE_CAST: (code, message, cause, suggestion) => buildError("TYPE_CAST", code, message, cause, suggestion),
+	SKETCHER_STATE: (code, message, cause, suggestion) => buildError("SKETCHER_STATE", code, message, cause, suggestion),
+	MODULE_INIT: (code, message, cause, suggestion) => buildError("MODULE_INIT", code, message, cause, suggestion),
+	COMPUTATION: (code, message, cause, suggestion) => buildError("COMPUTATION", code, message, cause, suggestion),
+	IO: (code, message, cause, suggestion) => buildError("IO", code, message, cause, suggestion),
+	QUERY: (code, message, cause, suggestion) => buildError("QUERY", code, message, cause, suggestion),
+	UNSUPPORTED: (code, message, cause, suggestion) => buildError("UNSUPPORTED", code, message, cause, suggestion)
+};
+/**
+* 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;
+		const suggestion = getSuggestionForCode(code);
+		return err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e, suggestion));
+	}
+}
+/**
+* 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;
+		const suggestion = getSuggestionForCode(code);
+		return err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e, suggestion));
+	}
+}
+/**
+* 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/topology/cast.ts
 var TOPO_ENUM = {
 	compound: 0,
@@ -214,4 +304,4 @@ function innerWires(face) {
 	return Array.from(iterTopo(face.wrapped, "wire")).map((w) => castShape(unwrap(downcast(w)))).filter((w) => !getKernel().isSame(w.wrapped, outer.wrapped));
 }
 //#endregion
-export { downcast as _, flipFaceOrientation as a, iterTopo as b, normalAt as c, projectPointOnFace as d, removeHolesFromFace as f, cast as g, asTopo as h, faceOrientation as i, outerWire as l, uvCoordinates as m, faceCenter as n, getSurfaceType as o, uvBounds as p, faceGeomType as r, innerWires as s, classifyPointOnFace as t, pointOnSurface as u, fromBREP as v, shapeType as x, isCompSolid as y };
+export { kernelCallRaw as C, kernelCall as S, downcast as _, flipFaceOrientation as a, iterTopo as b, normalAt as c, projectPointOnFace as d, removeHolesFromFace as f, cast as g, asTopo as h, faceOrientation as i, outerWire as l, uvCoordinates as m, faceCenter as n, getSurfaceType as o, uvBounds as p, faceGeomType as r, innerWires as s, classifyPointOnFace as t, pointOnSurface as u, fromBREP as v, kernelCallScoped as w, shapeType as x, isCompSolid as y };

package/dist/{faceFns-BywUjlJ7.cjs → faceFns-cE2WxY6I.cjs}

@@ -1,6 +1,96 @@
-const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
-const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_shapeTypes = require("./shapeTypes-BqWQlrYE.cjs");
+const require_errors = require("./errors-9zQcQK1H.cjs");
 const require_types = require("./types-BjDcsS7l.cjs");
+//#region src/core/kernelCall.ts
+function buildError(kind, code, message, cause, suggestion) {
+	const base = {
+		kind,
+		code,
+		message,
+		cause
+	};
+	if (suggestion) return {
+		...base,
+		suggestion
+	};
+	return base;
+}
+var errorFactories = {
+	KERNEL_OPERATION: (code, message, cause, suggestion) => buildError("KERNEL_OPERATION", code, message, cause, suggestion),
+	VALIDATION: (code, message, cause, suggestion) => buildError("VALIDATION", code, message, cause, suggestion),
+	TYPE_CAST: (code, message, cause, suggestion) => buildError("TYPE_CAST", code, message, cause, suggestion),
+	SKETCHER_STATE: (code, message, cause, suggestion) => buildError("SKETCHER_STATE", code, message, cause, suggestion),
+	MODULE_INIT: (code, message, cause, suggestion) => buildError("MODULE_INIT", code, message, cause, suggestion),
+	COMPUTATION: (code, message, cause, suggestion) => buildError("COMPUTATION", code, message, cause, suggestion),
+	IO: (code, message, cause, suggestion) => buildError("IO", code, message, cause, suggestion),
+	QUERY: (code, message, cause, suggestion) => buildError("QUERY", code, message, cause, suggestion),
+	UNSUPPORTED: (code, message, cause, suggestion) => buildError("UNSUPPORTED", code, message, cause, suggestion)
+};
+/**
+* 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;
+		const suggestion = require_errors.getSuggestionForCode(code);
+		return require_errors.err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e, suggestion));
+	}
+}
+/**
+* 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;
+		const suggestion = require_errors.getSuggestionForCode(code);
+		return require_errors.err(errorFactories[kind](code, `${message}: ${translatedMessage}`, e, suggestion));
+	}
+}
+/**
+* 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/topology/cast.ts
 var TOPO_ENUM = {
 	compound: 0,
@@ -292,6 +382,24 @@ Object.defineProperty(exports, "iterTopo", {
 		return iterTopo;
 	}
 });
+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, "normalAt", {
 	enumerable: true,
 	get: function() {

package/dist/{helpers-1iCCEElA.cjs → helpers-DZje6XWE.cjs}

@@ -1,10 +1,11 @@
-const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
-const require_errors = require("./errors-BlC5ZWv4.cjs");
-const require_vecOps = require("./vecOps-DKGelwGL.cjs");
-const require_faceFns = require("./faceFns-BywUjlJ7.cjs");
-const require_arrayAccess = require("./arrayAccess-t2dlxGSK.cjs");
-const require_curveFns = require("./curveFns-CZszKLQB.cjs");
-const require_measureFns = require("./measureFns-Bx-kl7_g.cjs");
+const require_shapeTypes = require("./shapeTypes-BqWQlrYE.cjs");
+const require_errors = require("./errors-9zQcQK1H.cjs");
+const require_faceFns = require("./faceFns-cE2WxY6I.cjs");
+const require_constants = require("./constants-unWN8k4c.cjs");
+const require_vecOps = require("./vecOps-BXvBYIor.cjs");
+const require_shapeFns = require("./shapeFns-aEeSHNqX.cjs");
+const require_curveFns = require("./curveFns-DCEcwcpd.cjs");
+const require_measureFns = require("./measureFns-D_QKZ5yg.cjs");
 //#region src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;
@@ -138,10 +139,10 @@ function createTypedFinder(topoKind, filters, rebuild, extend) {
 	const shouldKeep = (element) => filters.every((f) => f(element));
 	function getCachedElements(shape) {
 		switch (topoKind) {
-			case "edge": return require_arrayAccess.getEdges(shape);
-			case "face": return require_arrayAccess.getFaces(shape);
-			case "wire": return require_arrayAccess.getWires(shape);
-			case "vertex": return require_arrayAccess.getVertices(shape);
+			case "edge": return require_shapeFns.getEdges(shape);
+			case "face": return require_shapeFns.getFaces(shape);
+			case "wire": return require_shapeFns.getWires(shape);
+			case "vertex": return require_shapeFns.getVertices(shape);
 		}
 	}
 	const extractElements = (shape) => {
@@ -157,14 +158,14 @@ function createTypedFinder(topoKind, filters, rebuild, extend) {
 		inList: (elements) => {
 			const hashSet = /* @__PURE__ */ new Map();
 			for (const e of elements) {
-				const h = require_arrayAccess.getHashCode(e);
+				const h = require_shapeFns.getHashCode(e);
 				const bucket = hashSet.get(h);
 				if (bucket) bucket.push(e);
 				else hashSet.set(h, [e]);
 			}
 			return withFilter((el) => {
-				const bucket = hashSet.get(require_arrayAccess.getHashCode(el));
-				return !!bucket && bucket.some((e) => require_arrayAccess.isSameShape(e, el));
+				const bucket = hashSet.get(require_shapeFns.getHashCode(el));
+				return !!bucket && bucket.some((e) => require_shapeFns.isSameShape(e, el));
 			});
 		},
 		not: (builderFn) => {
@@ -250,7 +251,7 @@ function edgeDirectionFilter(dir, angle) {
 		const { tangent: rawTangent } = kernel.curveTangent(edge.wrapped, midParam);
 		const tangent = require_vecOps.vecNormalize(rawTangent);
 		const ang = Math.acos(Math.min(1, Math.abs(require_vecOps.vecDot(tangent, d))));
-		return Math.abs(ang - require_vecOps.DEG2RAD * angle) < 1e-6;
+		return Math.abs(ang - require_constants.DEG2RAD * angle) < 1e-6;
 	};
 }
 function buildEdgeFinder(filters) {
@@ -275,7 +276,7 @@ function faceDirectionFilter(dir, angle) {
 	return (face) => {
 		const n = require_faceFns.normalAt(face);
 		const ang = Math.acos(Math.min(1, Math.abs(require_vecOps.vecDot(require_vecOps.vecNormalize(n), d))));
-		return Math.abs(ang - require_vecOps.DEG2RAD * angle) < 1e-6;
+		return Math.abs(ang - require_constants.DEG2RAD * angle) < 1e-6;
 	};
 }
 function buildFaceFinder(filters) {
@@ -302,7 +303,7 @@ function buildWireFinder(filters) {
 	return createTypedFinder("wire", filters, buildWireFinder, (_base, withFilter) => ({
 		isClosed: () => withFilter((wire) => require_curveFns.curveIsClosed(wire)),
 		isOpen: () => withFilter((wire) => !require_curveFns.curveIsClosed(wire)),
-		ofEdgeCount: (count) => withFilter((wire) => require_arrayAccess.getEdges(wire).length === count)
+		ofEdgeCount: (count) => withFilter((wire) => require_shapeFns.getEdges(wire).length === count)
 	}));
 }
 /** Create an immutable wire finder. */

package/dist/{helpers-DgX1UucG.js → helpers-XrXlKm8D.js}

@@ -1,10 +1,11 @@
-import { Y as getKernel, p as isFace } from "./shapeTypes-Di6GlhPk.js";
-import { L as unwrap, k as ok, m as bug, o as queryError, w as isOk, y as err } from "./errors-BVOlxlIA.js";
-import { _ as DEG2RAD, a as vecDot, d as vecNormalize } from "./vecOps-DFfUfsmc.js";
-import { c as normalAt, o as getSurfaceType } from "./faceFns-Cat-4X74.js";
-import { F as getEdges, I as getFaces, R as getVertices, a as getHashCode, c as isSameShape, z as getWires } from "./arrayAccess-B5LgmXBo.js";
-import { a as curveLength, d as getCurveType, r as curveIsClosed } from "./curveFns-DY4dFcP-.js";
-import { n as measureArea } from "./measureFns-D3rAp1X1.js";
+import { Y as getKernel, p as isFace } from "./shapeTypes-BO1aiDhi.js";
+import { A as ok, R as unwrap, T as isOk, b as err, h as bug, o as queryError } from "./errors-C-cgQA3w.js";
+import { c as normalAt, o as getSurfaceType } from "./faceFns-TSH54pPQ.js";
+import { t as DEG2RAD } from "./constants-B9u763C3.js";
+import { a as vecDot, d as vecNormalize } from "./vecOps-D9etjPgV.js";
+import { F as getVertices, I as getWires, M as getEdges, N as getFaces, a as isSameShape, n as getHashCode } from "./shapeFns-DCi9O27X.js";
+import { a as curveLength, d as getCurveType, r as curveIsClosed } from "./curveFns-CcInoOEA.js";
+import { n as measureArea } from "./measureFns-DHByqdmn.js";
 //#region src/utils/vec2d.ts
 /** Precision for curve intersection and parameter operations. */
 var PRECISION_INTERSECTION = 1e-9;

package/dist/{historyFns-BFwp8NLX.js → historyFns-2hCWrX_X.js}

@@ -1,9 +1,9 @@
-import { Y as getKernel, t as castShape, z as createKernelHandle } from "./shapeTypes-Di6GlhPk.js";
-import { d as validationError, k as ok, n as computationError, r as ioError, y as err } from "./errors-BVOlxlIA.js";
-import { d as vecNormalize, s as vecIsZero } from "./vecOps-DFfUfsmc.js";
-import { v as fromBREP } from "./faceFns-Cat-4X74.js";
-import { u as toBREP } from "./arrayAccess-B5LgmXBo.js";
-import { i as fuseAll } from "./booleanFns-B46fgObh.js";
+import { Y as getKernel, t as castShape, z as createKernelHandle } from "./shapeTypes-BO1aiDhi.js";
+import { A as ok, b as err, d as validationError, n as computationError, r as ioError } from "./errors-C-cgQA3w.js";
+import { v as fromBREP } from "./faceFns-TSH54pPQ.js";
+import { d as vecNormalize, s as vecIsZero } from "./vecOps-D9etjPgV.js";
+import { s as toBREP } from "./shapeFns-DCi9O27X.js";
+import { i as fuseAll } from "./booleanFns-CgsaJFBf.js";
 //#region src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {
@@ -429,10 +429,10 @@ function modifyStep(history, stepId, newParams, registry) {
 /** Serialize a history to a JSON-safe object (shapes converted via toBREP). */
 function serializeHistory(history) {
 	const shapes = {};
-	for (const [id, shape] of history.shapes) try {
-		shapes[id] = toBREP(shape);
-	} catch (e) {
-		return err(computationError("SERIALIZE_SHAPE_FAILED", `Failed to serialize shape "${id}": ${e instanceof Error ? e.message : String(e)}`));
+	for (const [id, shape] of history.shapes) {
+		const brepResult = toBREP(shape);
+		if (!brepResult.ok) return err(computationError("SERIALIZE_SHAPE_FAILED", `Failed to serialize shape "${id}": ${brepResult.error.message}`));
+		shapes[id] = brepResult.value;
 	}
 	return ok({
 		steps: history.steps,

package/dist/{historyFns-DqxDtXIZ.cjs → historyFns-BiQ9dmzp.cjs}

@@ -1,9 +1,9 @@
-const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
-const require_errors = require("./errors-BlC5ZWv4.cjs");
-const require_vecOps = require("./vecOps-DKGelwGL.cjs");
-const require_faceFns = require("./faceFns-BywUjlJ7.cjs");
-const require_arrayAccess = require("./arrayAccess-t2dlxGSK.cjs");
-const require_booleanFns = require("./booleanFns-Bw8sAMgI.cjs");
+const require_shapeTypes = require("./shapeTypes-BqWQlrYE.cjs");
+const require_errors = require("./errors-9zQcQK1H.cjs");
+const require_faceFns = require("./faceFns-cE2WxY6I.cjs");
+const require_vecOps = require("./vecOps-BXvBYIor.cjs");
+const require_shapeFns = require("./shapeFns-aEeSHNqX.cjs");
+const require_booleanFns = require("./booleanFns-B6M6Lm0V.cjs");
 //#region src/utils/uuid.ts
 /** Generate a v4-style UUID string using `crypto.getRandomValues`. */
 function uuidv() {
@@ -429,10 +429,10 @@ function modifyStep(history, stepId, newParams, registry) {
 /** Serialize a history to a JSON-safe object (shapes converted via toBREP). */
 function serializeHistory(history) {
 	const shapes = {};
-	for (const [id, shape] of history.shapes) try {
-		shapes[id] = require_arrayAccess.toBREP(shape);
-	} catch (e) {
-		return require_errors.err(require_errors.computationError("SERIALIZE_SHAPE_FAILED", `Failed to serialize shape "${id}": ${e instanceof Error ? e.message : String(e)}`));
+	for (const [id, shape] of history.shapes) {
+		const brepResult = require_shapeFns.toBREP(shape);
+		if (!brepResult.ok) return require_errors.err(require_errors.computationError("SERIALIZE_SHAPE_FAILED", `Failed to serialize shape "${id}": ${brepResult.error.message}`));
+		shapes[id] = brepResult.value;
 	}
 	return require_errors.ok({
 		steps: history.steps,

package/dist/{importFns-ChXEJAvu.cjs → importFns-DGE5nCSW.cjs}

@@ -1,7 +1,7 @@
-const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
-const require_errors = require("./errors-BlC5ZWv4.cjs");
-const require_arrayAccess = require("./arrayAccess-t2dlxGSK.cjs");
-const require_blueprint = require("./blueprint-CDnBM-tA.cjs");
+const require_shapeTypes = require("./shapeTypes-BqWQlrYE.cjs");
+const require_errors = require("./errors-9zQcQK1H.cjs");
+const require_arrayAccess = require("./arrayAccess-CmulMesb.cjs");
+const require_blueprint = require("./blueprint-D0XChcek.cjs");
 //#region src/io/objExportFns.ts
 /** Read a vec3 from a typed array at the given vertex index. */
 function vec3At(arr, i) {

package/dist/{importFns-Cb8fcldB.js → importFns-m0xyj0Zt.js}

@@ -1,7 +1,7 @@
-import { Y as getKernel, t as castShape } from "./shapeTypes-Di6GlhPk.js";
-import { k as ok, r as ioError, t as BrepErrorCode, y as err } from "./errors-BVOlxlIA.js";
-import { n as getAtOrThrow } from "./arrayAccess-B5LgmXBo.js";
-import { f as make2dSegmentCurve, m as make2dThreePointArc, s as make2dBezierCurve, t as Blueprint } from "./blueprint-CB_85Lz_.js";
+import { Y as getKernel, t as castShape } from "./shapeTypes-BO1aiDhi.js";
+import { A as ok, b as err, r as ioError, t as BrepErrorCode } from "./errors-C-cgQA3w.js";
+import { n as getAtOrThrow } from "./arrayAccess-xxcB3YNq.js";
+import { f as make2dSegmentCurve, m as make2dThreePointArc, s as make2dBezierCurve, t as Blueprint } from "./blueprint-B3A5x7P9.js";
 //#region src/io/objExportFns.ts
 /** Read a vec3 from a typed array at the given vertex index. */
 function vec3At(arr, i) {

package/dist/index.d.ts

@@ -80,6 +80,8 @@ export { checkBoolean } from './topology/booleanDiagnosticFns.js';
 export type { CheckBooleanResult, BooleanIssue, BooleanOpType, BooleanDiagnostics, } from './kernel/types.js';
 export { fuseWithEvolution, cutWithEvolution, intersectWithEvolution, filletWithEvolution, chamferWithEvolution, shellWithEvolution, type EvolutionResult, } from './topology/evolutionFns.js';
 export type { ShapeEvolution } from './kernel/types.js';
+export { captureHint, assignRoles, createRef, updateRoles, resolveRef, defaultScorer, } from './topology/shapeRef/index.js';
+export type { GeometricHint, ShapeRef, RoleTable, ResolvedRef, BrokenRef, FaceScorer, } from './topology/shapeRef/index.js';
 export { surfaceFromGrid, surfaceFromImage, type SurfaceFromGridOptions, type SurfaceFromImageOptions, } from './topology/surfaceFns.js';
 export { hull, type HullOptions } from './topology/hullFns.js';
 export { convexHull } from './operations/convexHullFns.js';
@@ -117,4 +119,13 @@ export { translate, rotate, mirror, scale, clone, applyMatrix, composeTransforms
 export { extrude, revolve, loft, type RevolveOptions, type LoftOptions as CleanLoftOptions, type SweepOptions as CleanSweepOptions, } from './operations/api.js';
 export { drill, pocket, boss, mirrorJoin, rectangularPattern, } from './operations/compoundOpsFns.js';
 export { shape, BrepWrapperError, type Wrapped, type Wrapped3D, type WrappedCurve, type WrappedFace, } from './topology/wrapperFns.js';
+export * as primitives from './ns/primitives.js';
+export * as booleans from './ns/booleans.js';
+export * as modifiers from './ns/modifiers.js';
+export * as transforms from './ns/transforms.js';
+export * as measurement from './ns/measurement.js';
+export * as io from './ns/ioNs.js';
+export * as query from './ns/query.js';
+export * as construction from './ns/construction.js';
+export * as patterns from './ns/patterns.js';
 //# sourceMappingURL=index.d.ts.map