brepjs 12.11.2 → 12.13.0

package/README.md

@@ -40,12 +40,16 @@ Production-ready with the OpenCascade kernel. [brepkit](https://github.com/andym
 npm install brepjs brepjs-opencascade
 ```
 
-`brepjs/quick` handles WASM init automatically via top-level await (ESM only). Manual setup:
+`brepjs/quick` handles WASM init automatically via top-level await (ESM only). Other options:
 
 ```typescript
+// Auto-detect kernel
+import { init } from 'brepjs';
+await init();
+
+// Or manual setup
 import opencascade from 'brepjs-opencascade';
 import { initFromOC } from 'brepjs';
-
 const oc = await opencascade();
 initFromOC(oc);
 ```

package/dist/2d/blueprints/Blueprint.d.ts

@@ -47,6 +47,7 @@ export default class Blueprint implements DrawingInterface {
     constructor(curves: Curve2D[]);
     /** Release WASM resources held by the underlying curves and bounding box. */
     delete(): void;
+    [Symbol.dispose](): void;
     /** Return a deep copy of this blueprint. */
     clone(): Blueprint;
     /** Return a multi-line string representation for debugging. */

package/dist/2d/blueprints/Blueprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Blueprint.d.ts","sourceRoot":"","sources":["../../../src/2d/blueprints/Blueprint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Blueprint.d.ts","sourceRoot":"","sources":["../../../src/2d/blueprints/Blueprint.ts"],"names":[],"mappings":"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"}

package/dist/2d/lib/BoundingBox2d.d.ts

@@ -12,6 +12,7 @@ export declare class BoundingBox2d {
     constructor(wrapped?: KernelType);
     get wrapped(): KernelType;
     delete(): void;
+    [Symbol.dispose](): void;
     /** Return a human-readable string of the form `(xMin,yMin) - (xMax,yMax)`. */
     get repr(): string;
     /** Return the `[min, max]` corner points of the bounding box. */

package/dist/2d/lib/BoundingBox2d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoundingBox2d.d.ts","sourceRoot":"","sources":["../../../src/2d/lib/BoundingBox2d.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,CAAC,EAAE,UAAU;IAKhC,IAAI,OAAO,IAAI,UAAU,CAGxB;IAED,MAAM,IAAI,IAAI;IAQd,8EAA8E;IAC9E,IAAI,IAAI,IAAI,MAAM,CAGjB;IAED,iEAAiE;IACjE,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAM/B;IAED,mDAAmD;IACnD,IAAI,MAAM,IAAI,OAAO,CAGpB;IAED,uDAAuD;IACvD,IAAI,KAAK,IAAI,MAAM,CAGlB;IAED,wDAAwD;IACxD,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED;;;;OAIG;IACH,YAAY,CAAC,cAAc,SAAI,GAAG,OAAO;IAWzC,mDAAmD;IACnD,GAAG,CAAC,KAAK,EAAE,aAAa;IAIxB,0EAA0E;IAC1E,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAIpC,iFAAiF;IACjF,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAGvC"}
+{"version":3,"file":"BoundingBox2d.d.ts","sourceRoot":"","sources":["../../../src/2d/lib/BoundingBox2d.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,CAAC,EAAE,UAAU;IAKhC,IAAI,OAAO,IAAI,UAAU,CAGxB;IAED,MAAM,IAAI,IAAI;IAQd,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB,8EAA8E;IAC9E,IAAI,IAAI,IAAI,MAAM,CAGjB;IAED,iEAAiE;IACjE,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAM/B;IAED,mDAAmD;IACnD,IAAI,MAAM,IAAI,OAAO,CAGpB;IAED,uDAAuD;IACvD,IAAI,KAAK,IAAI,MAAM,CAGlB;IAED,wDAAwD;IACxD,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED;;;;OAIG;IACH,YAAY,CAAC,cAAc,SAAI,GAAG,OAAO;IAWzC,mDAAmD;IACnD,GAAG,CAAC,KAAK,EAAE,aAAa;IAIxB,0EAA0E;IAC1E,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAIpC,iFAAiF;IACjF,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAGvC"}

package/dist/2d/lib/Curve2D.d.ts

@@ -24,6 +24,7 @@ export declare class Curve2D {
     constructor(handle: KernelType);
     get wrapped(): KernelType;
     delete(): void;
+    [Symbol.dispose](): void;
     /** Compute (and cache) the 2D bounding box of this curve. */
     get boundingBox(): BoundingBox2d;
     /** Return a human-readable representation, e.g. `LINE (0,0) - (1,1)`. */

package/dist/2d/lib/Curve2D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Curve2D.d.ts","sourceRoot":"","sources":["../../../src/2d/lib/Curve2D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,sBAAsB,CAAC;AAMpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAMhD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,YAAY,EAAE,IAAI,GAAG,aAAa,CAAC;IACnC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,UAAU,CAAwB;gBAE9B,MAAM,EAAE,UAAU;IAM9B,IAAI,OAAO,IAAI,UAAU,CAGxB;IAED,MAAM,IAAI,IAAI;IAQd,6DAA6D;IAC7D,IAAI,WAAW,kBAOd;IAED,yEAAyE;IACzE,IAAI,IAAI,WAEP;IAED,6FAA6F;IAC7F,SAAS,IAAI,MAAM;IAInB,yEAAyE;IACzE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIjC,8EAA8E;IAC9E,IAAI,UAAU,IAAI,OAAO,CAKxB;IAED,4EAA4E;IAC5E,IAAI,SAAS,IAAI,OAAO,CAKvB;IAED,4DAA4D;IAC5D,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,0DAA0D;IAC1D,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,wFAAwF;IACxF,IAAI,QAAQ,IAAI,SAAS,CAExB;IAED,qDAAqD;IACrD,KAAK,IAAI,OAAO;IAQhB,sDAAsD;IACtD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAyBzB,gFAAgF;IAChF,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM;IAQhD,8EAA8E;IAC9E,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIlC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IA2B3D;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IAe3C;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,SAAS,SAAO,GAAG,OAAO,EAAE;CAiCnE"}
+{"version":3,"file":"Curve2D.d.ts","sourceRoot":"","sources":["../../../src/2d/lib/Curve2D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,sBAAsB,CAAC;AAMpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAMhD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,YAAY,EAAE,IAAI,GAAG,aAAa,CAAC;IACnC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,UAAU,CAAwB;gBAE9B,MAAM,EAAE,UAAU;IAM9B,IAAI,OAAO,IAAI,UAAU,CAGxB;IAED,MAAM,IAAI,IAAI;IAQd,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB,6DAA6D;IAC7D,IAAI,WAAW,kBAOd;IAED,yEAAyE;IACzE,IAAI,IAAI,WAEP;IAED,6FAA6F;IAC7F,SAAS,IAAI,MAAM;IAInB,yEAAyE;IACzE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIjC,8EAA8E;IAC9E,IAAI,UAAU,IAAI,OAAO,CAKxB;IAED,4EAA4E;IAC5E,IAAI,SAAS,IAAI,OAAO,CAKvB;IAED,4DAA4D;IAC5D,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,0DAA0D;IAC1D,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,wFAAwF;IACxF,IAAI,QAAQ,IAAI,SAAS,CAExB;IAED,qDAAqD;IACrD,KAAK,IAAI,OAAO;IAQhB,sDAAsD;IACtD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAyBzB,gFAAgF;IAChF,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM;IAQhD,8EAA8E;IAC9E,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIlC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IA2B3D;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IAe3C;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,SAAS,SAAO,GAAG,OAAO,EAAE;CAiCnE"}

package/dist/2d.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_Blueprint = require("./Blueprint-C2znXaaZ.cjs");
-const require_boolean2D = require("./boolean2D-Bu1v9M_m.cjs");
-const require_blueprintFns = require("./blueprintFns-CxfjtauU.cjs");
+const require_Blueprint = require("./Blueprint-D1qS-Zyd.cjs");
+const require_boolean2D = require("./boolean2D-CaZrebEm.cjs");
+const require_blueprintFns = require("./blueprintFns--fsdFjx9.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 { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./Blueprint-B_jo065X.js";
-import { a as fuseBlueprints, c as roundedRectangleBlueprint, g as CompoundBlueprint, h as Blueprints, i as cutBlueprints, m as organiseBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-yyAQW-Rw.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-bpyUa_XY.js";
+import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./Blueprint-7b-gvX_p.js";
+import { a as fuseBlueprints, c as roundedRectangleBlueprint, g as CompoundBlueprint, h as Blueprints, i as cutBlueprints, m as organiseBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-BnJQsw1Q.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-DM5lmYDI.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/{Blueprint-B_jo065X.js → Blueprint-7b-gvX_p.js}

@@ -1,12 +1,12 @@
-import { G as getKernel2D, L as registerForCleanup, W as getKernel, i as createEdge, l as createWire, z as unregisterFromCleanup } from "./shapeTypes-DkpaETrw.js";
+import { G as getKernel2D, L as registerForCleanup, W as getKernel, i as createEdge, l as createWire, z as unregisterFromCleanup } from "./shapeTypes-BmN9vAte.js";
 import { L as unwrap, d as validationError, k as ok, m as bug, n as computationError, y as err } from "./errors-B2qrBS1S.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-PYHm_Q9z.js";
-import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-C-HZ3rFB.js";
-import { f as getOrientation } from "./curveFns-D1LG7v0s.js";
-import { r as makeFace } from "./surfaceBuilders-BZWDla4x.js";
-import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-CPw-TkjO.js";
+import { g as cast, m as uvCoordinates, n as faceCenter, p as uvBounds, r as faceGeomType } from "./faceFns-BN95alxi.js";
+import { f as getOrientation } from "./curveFns-Bse_M07l.js";
+import { r as makeFace } from "./surfaceBuilders-Ccaf33Q_.js";
+import { _ as samePoint, b as subtract2d, l as add2d, o as normalize2d, p as distance2d, t as getSingleFace, v as scalarMultiply2d } from "./helpers-BSRZXwBR.js";
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {
@@ -78,6 +78,9 @@ var BoundingBox2d = class {
 			if (typeof this._wrapped.delete === "function") this._wrapped.delete();
 		}
 	}
+	[Symbol.dispose]() {
+		this.delete();
+	}
 	/** Return a human-readable string of the form `(xMin,yMin) - (xMax,yMax)`. */
 	get repr() {
 		const [min, max] = this.bounds;
@@ -165,6 +168,9 @@ var Curve2D = class Curve2D {
 			if (typeof this._wrapped.delete === "function") this._wrapped.delete();
 		}
 	}
+	[Symbol.dispose]() {
+		this.delete();
+	}
 	/** Compute (and cache) the 2D bounding box of this curve. */
 	get boundingBox() {
 		if (this._boundingBox) return this._boundingBox;
@@ -729,6 +735,9 @@ var Blueprint = class Blueprint {
 		});
 		if (this._boundingBox) this._boundingBox.delete();
 	}
+	[Symbol.dispose]() {
+		this.delete();
+	}
 	/** Return a deep copy of this blueprint. */
 	clone() {
 		return new Blueprint(this.curves.map((c) => c.clone()));

package/dist/{Blueprint-C2znXaaZ.cjs → Blueprint-D1qS-Zyd.cjs}

@@ -1,12 +1,12 @@
-const require_shapeTypes = require("./shapeTypes-DQiNnWj0.cjs");
+const require_shapeTypes = require("./shapeTypes-CBc5OTQ4.cjs");
 const require_errors = require("./errors-Bkxm3vs2.cjs");
 const require_vecOps = require("./vecOps-4iBMiet9.cjs");
 const require_types = require("./types-BD-VVaWB.cjs");
 const require_planeOps = require("./planeOps-CXJOsSMJ.cjs");
-const require_faceFns = require("./faceFns-KUsSM65w.cjs");
-const require_curveFns = require("./curveFns-C_MUV5Nj.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-DVRuWItl.cjs");
-const require_helpers = require("./helpers-C5QjF_x8.cjs");
+const require_faceFns = require("./faceFns-wT8HTsiI.cjs");
+const require_curveFns = require("./curveFns-B40hdZon.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-B1CDCs7m.cjs");
+const require_helpers = require("./helpers-WmqZmmA1.cjs");
 //#region src/2d/lib/definitions.ts
 /** Type guard that checks whether a value is a `Point2D`. */
 function isPoint2D(point) {
@@ -78,6 +78,9 @@ var BoundingBox2d = class {
 			if (typeof this._wrapped.delete === "function") this._wrapped.delete();
 		}
 	}
+	[Symbol.dispose]() {
+		this.delete();
+	}
 	/** Return a human-readable string of the form `(xMin,yMin) - (xMax,yMax)`. */
 	get repr() {
 		const [min, max] = this.bounds;
@@ -165,6 +168,9 @@ var Curve2D = class Curve2D {
 			if (typeof this._wrapped.delete === "function") this._wrapped.delete();
 		}
 	}
+	[Symbol.dispose]() {
+		this.delete();
+	}
 	/** Compute (and cache) the 2D bounding box of this curve. */
 	get boundingBox() {
 		if (this._boundingBox) return this._boundingBox;
@@ -729,6 +735,9 @@ var Blueprint = class Blueprint {
 		});
 		if (this._boundingBox) this._boundingBox.delete();
 	}
+	[Symbol.dispose]() {
+		this.delete();
+	}
 	/** Return a deep copy of this blueprint. */
 	clone() {
 		return new Blueprint(this.curves.map((c) => c.clone()));

package/dist/{blueprintFns-CxfjtauU.cjs → blueprintFns--fsdFjx9.cjs}

@@ -1,6 +1,6 @@
 const require_errors = require("./errors-Bkxm3vs2.cjs");
-const require_Blueprint = require("./Blueprint-C2znXaaZ.cjs");
-const require_boolean2D = require("./boolean2D-Bu1v9M_m.cjs");
+const require_Blueprint = require("./Blueprint-D1qS-Zyd.cjs");
+const require_boolean2D = require("./boolean2D-CaZrebEm.cjs");
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{blueprintFns-bpyUa_XY.js → blueprintFns-DM5lmYDI.js}

@@ -1,6 +1,6 @@
 import { d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-B2qrBS1S.js";
-import { t as Blueprint } from "./Blueprint-B_jo065X.js";
-import { g as CompoundBlueprint } from "./boolean2D-yyAQW-Rw.js";
+import { t as Blueprint } from "./Blueprint-7b-gvX_p.js";
+import { g as CompoundBlueprint } from "./boolean2D-BnJQsw1Q.js";
 //#region src/2d/lib/curve2dFns.ts
 /**
 * Return a reversed copy of the curve (non-mutating).

package/dist/{boolean2D-yyAQW-Rw.js → boolean2D-BnJQsw1Q.js}

@@ -1,14 +1,14 @@
-import { G as getKernel2D, M as DisposalScope, U as _usingCtx, W as getKernel, a as createFace, i as createEdge, l as createWire, m as isShape3D, t as castShape } from "./shapeTypes-DkpaETrw.js";
+import { G as getKernel2D, M as DisposalScope, U as _usingCtx, W as getKernel, a as createFace, i as createEdge, l as createWire, m as isShape3D, t as castShape } from "./shapeTypes-BmN9vAte.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-B2qrBS1S.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-PYHm_Q9z.js";
-import { _ as downcast, c as normalAt, p as uvBounds, u as pointOnSurface } from "./faceFns-C-HZ3rFB.js";
-import { c as curveStartPoint, l as curveTangentAt, r as curveIsClosed } from "./curveFns-D1LG7v0s.js";
-import { _ as zip, i as makeNewFaceWithinFace, r as makeFace, s as assembleWire } from "./surfaceBuilders-BZWDla4x.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-CPw-TkjO.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-B_jo065X.js";
-import { c as twistExtrude, n as revolve, r as complexExtrude, s as sweep, t as extrude } from "./extrudeFns-GVLc2cLp.js";
+import { _ as downcast, c as normalAt, p as uvBounds, u as pointOnSurface } from "./faceFns-BN95alxi.js";
+import { c as curveStartPoint, l as curveTangentAt, r as curveIsClosed } from "./curveFns-Bse_M07l.js";
+import { _ as zip, i as makeNewFaceWithinFace, r as makeFace, s as assembleWire } from "./surfaceBuilders-Ccaf33Q_.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-BSRZXwBR.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-7b-gvX_p.js";
+import { c as twistExtrude, n as revolve, r as complexExtrude, s as sweep, t as extrude } from "./extrudeFns-D4euaVFA.js";
 //#region src/2d/lib/intersections.ts
 /**
 * Compute intersection points and common segments between two 2D curves.
@@ -1021,7 +1021,7 @@ function loft(wires, { ruled = true, startPoint, endPoint, tolerance = 1e-6 } =
 		if (!isShape3D(result)) return err(typeCastError("LOFT_NOT_3D", "Loft did not produce a 3D shape"));
 		return ok(result);
 	} catch {
-		return err(kernelError("LOFT_FAILED", "Loft operation failed"));
+		return err(kernelError("LOFT_FAILED", "Loft operation failed", void 0, void 0, "Common causes: wire profiles with different edge counts, self-intersecting result, or profiles too far apart. Ensure profiles are compatible and ordered."));
 	}
 }
 //#endregion

package/dist/{boolean2D-Bu1v9M_m.cjs → boolean2D-CaZrebEm.cjs}

@@ -1,14 +1,14 @@
-const require_shapeTypes = require("./shapeTypes-DQiNnWj0.cjs");
+const require_shapeTypes = require("./shapeTypes-CBc5OTQ4.cjs");
 const require_errors = require("./errors-Bkxm3vs2.cjs");
 const require_vecOps = require("./vecOps-4iBMiet9.cjs");
 const require_types = require("./types-BD-VVaWB.cjs");
 const require_planeOps = require("./planeOps-CXJOsSMJ.cjs");
-const require_faceFns = require("./faceFns-KUsSM65w.cjs");
-const require_curveFns = require("./curveFns-C_MUV5Nj.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-DVRuWItl.cjs");
-const require_helpers = require("./helpers-C5QjF_x8.cjs");
-const require_Blueprint = require("./Blueprint-C2znXaaZ.cjs");
-const require_extrudeFns = require("./extrudeFns-C2Pmhe-R.cjs");
+const require_faceFns = require("./faceFns-wT8HTsiI.cjs");
+const require_curveFns = require("./curveFns-B40hdZon.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-B1CDCs7m.cjs");
+const require_helpers = require("./helpers-WmqZmmA1.cjs");
+const require_Blueprint = require("./Blueprint-D1qS-Zyd.cjs");
+const require_extrudeFns = require("./extrudeFns-B4Fwc4sm.cjs");
 //#region src/2d/lib/intersections.ts
 /**
 * Compute intersection points and common segments between two 2D curves.
@@ -1021,7 +1021,7 @@ function loft(wires, { ruled = true, startPoint, endPoint, tolerance = 1e-6 } =
 		if (!require_shapeTypes.isShape3D(result)) return require_errors.err(require_errors.typeCastError("LOFT_NOT_3D", "Loft did not produce a 3D shape"));
 		return require_errors.ok(result);
 	} catch {
-		return require_errors.err(require_errors.kernelError("LOFT_FAILED", "Loft operation failed"));
+		return require_errors.err(require_errors.kernelError("LOFT_FAILED", "Loft operation failed", void 0, void 0, "Common causes: wire profiles with different edge counts, self-intersecting result, or profiles too far apart. Ensure profiles are compatible and ordered."));
 	}
 }
 //#endregion

package/dist/{booleanFns-hPtsWvKU.cjs → booleanFns-DX08b6Hh.cjs}

@@ -1,9 +1,9 @@
-const require_shapeTypes = require("./shapeTypes-DQiNnWj0.cjs");
+const require_shapeTypes = require("./shapeTypes-CBc5OTQ4.cjs");
 const require_errors = require("./errors-Bkxm3vs2.cjs");
 const require_vecOps = require("./vecOps-4iBMiet9.cjs");
 const require_planeOps = require("./planeOps-CXJOsSMJ.cjs");
-const require_shapeFns = require("./shapeFns-csbO4RSU.cjs");
-const require_surfaceBuilders = require("./surfaceBuilders-DVRuWItl.cjs");
+const require_shapeFns = require("./shapeFns-DFkO3e8a.cjs");
+const require_surfaceBuilders = require("./surfaceBuilders-B1CDCs7m.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) {
+function castToShape3D(shape, errorCode, errorMsg, suggestion) {
 	const wrapped = require_shapeTypes.castShape(shape);
 	if (!require_shapeTypes.isShape3D(wrapped)) {
 		const shapeType = shape.ShapeType();
@@ -29,7 +29,7 @@ function castToShape3D(shape, errorCode, errorMsg) {
 			"SHAPE"
 		][shapeType] ?? `UNKNOWN(${shapeType})`;
 		wrapped[Symbol.dispose]();
-		return require_errors.err(require_errors.typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`));
+		return require_errors.err(require_errors.typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`, void 0, void 0, suggestion));
 	}
 	return require_errors.ok(wrapped);
 }
@@ -59,7 +59,7 @@ function fuse(a, b, { optimisation = "none", simplify = false, signal, fuzzyValu
 		simplify,
 		fuzzyValue
 	});
-	const fuseResult = castToShape3D(resultShape, "FUSE_NOT_3D", "Fuse did not produce a 3D shape");
+	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 (fuseResult.ok) require_shapeFns.propagateAllMetadata(evolution, [a, b], fuseResult.value);
 	return fuseResult;
 }
@@ -88,7 +88,7 @@ function cut(base, tool, { optimisation = "none", simplify = false, signal, fuzz
 		simplify,
 		fuzzyValue
 	});
-	const cutResult = castToShape3D(resultShape, "CUT_NOT_3D", "Cut did not produce a 3D shape");
+	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 (cutResult.ok) require_shapeFns.propagateAllMetadata(evolution, [base, tool], cutResult.value);
 	return cutResult;
 }
@@ -111,7 +111,7 @@ function intersect(a, b, { simplify = false, signal, fuzzyValue } = {}) {
 		simplify,
 		fuzzyValue
 	});
-	const intResult = castToShape3D(resultShape, "INTERSECT_NOT_3D", "Intersect did not produce a 3D shape");
+	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 (intResult.ok) require_shapeFns.propagateAllMetadata(evolution, [a, b], intResult.value);
 	return intResult;
 }
@@ -253,7 +253,7 @@ function section(shape, plane, { approximation = true, planeSize = 1e4 } = {}) {
 		return require_errors.err(require_errors.kernelError("SECTION_FAILED", `Section with ${planeName} plane failed: ${raw}`, e, {
 			operation: "section",
 			plane: planeName
-		}));
+		}, "The cutting plane may not intersect the shape. Verify plane position relative to shape bounds."));
 	} finally {
 		sectionFace.delete();
 	}
@@ -269,7 +269,7 @@ function sectionToFace(shape, plane, options = {}) {
 	const wires = require_shapeFns.getWires(sectionResult.value);
 	if (wires.length === 0) {
 		const edges = require_shapeFns.getEdges(sectionResult.value);
-		if (edges.length === 0) return require_errors.err(require_errors.kernelError("SECTION_FAILED", "sectionToFace: section produced no geometry"));
+		if (edges.length === 0) return require_errors.err(require_errors.kernelError("SECTION_FAILED", "sectionToFace: section produced no geometry", void 0, void 0, "The cutting plane may not intersect the shape. Verify plane position relative to shape bounds."));
 		const kernel = require_shapeTypes.getKernel();
 		const vertexToEdges = /* @__PURE__ */ new Map();
 		const edgeVertexHashes = /* @__PURE__ */ new Map();
@@ -319,7 +319,7 @@ function sectionToFace(shape, plane, options = {}) {
 			} catch {}
 		}
 	}
-	if (wires.length === 0) return require_errors.err(require_errors.kernelError("SECTION_FAILED", "sectionToFace: section produced no usable geometry"));
+	if (wires.length === 0) return require_errors.err(require_errors.kernelError("SECTION_FAILED", "sectionToFace: section produced no usable geometry", void 0, void 0, "The cutting plane may not intersect the shape. Verify plane position relative to shape bounds."));
 	let outerIdx = 0;
 	let maxDiag = -1;
 	for (let i = 0; i < wires.length; i++) {
@@ -354,7 +354,7 @@ function split(shape, tools) {
 		return require_errors.err(require_errors.kernelError("SPLIT_FAILED", `Split operation failed on ${tools.length} tool(s): ${raw}`, e, {
 			operation: "split",
 			toolCount: tools.length
-		}));
+		}, "The splitting tools may not intersect the shape. Ensure tools cross through the shape's interior."));
 	}
 }
 /**

package/dist/{booleanFns-ZBHOH5IJ.js → booleanFns-DyoSwthi.js}

@@ -1,9 +1,9 @@
-import { W as getKernel, m as isShape3D, t as castShape } from "./shapeTypes-DkpaETrw.js";
+import { W as getKernel, m as isShape3D, t as castShape } from "./shapeTypes-BmN9vAte.js";
 import { C as isErr, d as validationError, i as kernelError, k as ok, l as typeCastError, t as BrepErrorCode, y as err } from "./errors-B2qrBS1S.js";
 import { h as vecScale, t as vecAdd, v as HASH_CODE_MAX } from "./vecOps-B9-MTeC8.js";
 import { o as resolvePlane } from "./planeOps-PYHm_Q9z.js";
-import { F as getWires, M as getEdges, P as getVertices, _ as propagateAllMetadata, g as collectInputFaceHashes, v as propagateMetadataByHash } from "./shapeFns-glO_2u3k.js";
-import { r as makeFace } from "./surfaceBuilders-BZWDla4x.js";
+import { F as getWires, M as getEdges, P as getVertices, _ as propagateAllMetadata, g as collectInputFaceHashes, v as propagateMetadataByHash } from "./shapeFns-CO_837FR.js";
+import { r as makeFace } from "./surfaceBuilders-Ccaf33Q_.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) {
+function castToShape3D(shape, errorCode, errorMsg, suggestion) {
 	const wrapped = castShape(shape);
 	if (!isShape3D(wrapped)) {
 		const shapeType = shape.ShapeType();
@@ -29,7 +29,7 @@ function castToShape3D(shape, errorCode, errorMsg) {
 			"SHAPE"
 		][shapeType] ?? `UNKNOWN(${shapeType})`;
 		wrapped[Symbol.dispose]();
-		return err(typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`));
+		return err(typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`, void 0, void 0, suggestion));
 	}
 	return ok(wrapped);
 }
@@ -59,7 +59,7 @@ function fuse(a, b, { optimisation = "none", simplify = false, signal, fuzzyValu
 		simplify,
 		fuzzyValue
 	});
-	const fuseResult = castToShape3D(resultShape, "FUSE_NOT_3D", "Fuse did not produce a 3D shape");
+	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 (fuseResult.ok) propagateAllMetadata(evolution, [a, b], fuseResult.value);
 	return fuseResult;
 }
@@ -88,7 +88,7 @@ function cut(base, tool, { optimisation = "none", simplify = false, signal, fuzz
 		simplify,
 		fuzzyValue
 	});
-	const cutResult = castToShape3D(resultShape, "CUT_NOT_3D", "Cut did not produce a 3D shape");
+	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 (cutResult.ok) propagateAllMetadata(evolution, [base, tool], cutResult.value);
 	return cutResult;
 }
@@ -111,7 +111,7 @@ function intersect(a, b, { simplify = false, signal, fuzzyValue } = {}) {
 		simplify,
 		fuzzyValue
 	});
-	const intResult = castToShape3D(resultShape, "INTERSECT_NOT_3D", "Intersect did not produce a 3D shape");
+	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 (intResult.ok) propagateAllMetadata(evolution, [a, b], intResult.value);
 	return intResult;
 }
@@ -253,7 +253,7 @@ function section(shape, plane, { approximation = true, planeSize = 1e4 } = {}) {
 		return err(kernelError("SECTION_FAILED", `Section with ${planeName} plane failed: ${raw}`, e, {
 			operation: "section",
 			plane: planeName
-		}));
+		}, "The cutting plane may not intersect the shape. Verify plane position relative to shape bounds."));
 	} finally {
 		sectionFace.delete();
 	}
@@ -269,7 +269,7 @@ function sectionToFace(shape, plane, options = {}) {
 	const wires = getWires(sectionResult.value);
 	if (wires.length === 0) {
 		const edges = getEdges(sectionResult.value);
-		if (edges.length === 0) return err(kernelError("SECTION_FAILED", "sectionToFace: section produced no geometry"));
+		if (edges.length === 0) return err(kernelError("SECTION_FAILED", "sectionToFace: section produced no geometry", void 0, void 0, "The cutting plane may not intersect the shape. Verify plane position relative to shape bounds."));
 		const kernel = getKernel();
 		const vertexToEdges = /* @__PURE__ */ new Map();
 		const edgeVertexHashes = /* @__PURE__ */ new Map();
@@ -319,7 +319,7 @@ function sectionToFace(shape, plane, options = {}) {
 			} catch {}
 		}
 	}
-	if (wires.length === 0) return err(kernelError("SECTION_FAILED", "sectionToFace: section produced no usable geometry"));
+	if (wires.length === 0) return err(kernelError("SECTION_FAILED", "sectionToFace: section produced no usable geometry", void 0, void 0, "The cutting plane may not intersect the shape. Verify plane position relative to shape bounds."));
 	let outerIdx = 0;
 	let maxDiag = -1;
 	for (let i = 0; i < wires.length; i++) {
@@ -354,7 +354,7 @@ function split(shape, tools) {
 		return err(kernelError("SPLIT_FAILED", `Split operation failed on ${tools.length} tool(s): ${raw}`, e, {
 			operation: "split",
 			toolCount: tools.length
-		}));
+		}, "The splitting tools may not intersect the shape. Ensure tools cross through the shape's interior."));
 	}
 }
 /**