brepjs 13.1.0 → 13.4.0

package/dist/2d/curve2dGeometryFns.d.ts

@@ -0,0 +1,107 @@
+import { Curve2DHandle } from '../core/curve2dHandle.js';
+import { Point2D } from './lib/definitions.js';
+import { Plane } from '../core/planeTypes.js';
+import { Edge, Face } from '../core/shapeTypes.js';
+import { Result } from '../core/result.js';
+/** Create a 2D line segment between two points. */
+export declare function line2d(from: Point2D, to: Point2D): Result<Curve2DHandle>;
+/** Create a full 2D circle. */
+export declare function circle2d(center: Point2D, radius: number, sense?: boolean): Result<Curve2DHandle>;
+/** Create a 2D arc through three points. */
+export declare function arc2d(p1: Point2D, mid: Point2D, p2: Point2D): Result<Curve2DHandle>;
+/** Create a 2D arc from a start point, tangent direction, and end point. */
+export declare function arc2dTangent(start: Point2D, tangent: Point2D, end: Point2D): Result<Curve2DHandle>;
+/** Options for ellipse construction. */
+export interface Ellipse2dOptions {
+    /** X-axis direction for the major axis (default: [1, 0]). */
+    readonly xDir?: Point2D;
+    /** Orientation sense (default: true = counter-clockwise). */
+    readonly sense?: boolean;
+}
+/** Create a full 2D ellipse. */
+export declare function ellipse2d(center: Point2D, majorRadius: number, minorRadius: number, options?: Ellipse2dOptions): Result<Curve2DHandle>;
+/** Create a 2D elliptical arc. */
+export declare function ellipseArc2d(center: Point2D, majorRadius: number, minorRadius: number, startAngle: number, endAngle: number, options?: Ellipse2dOptions): Result<Curve2DHandle>;
+/** Create a 2D Bezier curve through control points. */
+export declare function bezier2d(points: Point2D[]): Result<Curve2DHandle>;
+/** Options for B-spline construction. */
+export interface BSpline2dOptions {
+    readonly degMin?: number;
+    readonly degMax?: number;
+    readonly continuity?: 'C0' | 'C1' | 'C2' | 'C3';
+    readonly tolerance?: number;
+    readonly smoothing?: [number, number, number] | null;
+}
+/** Create a 2D B-spline curve interpolating through points. */
+export declare function bspline2d(points: Point2D[], options?: BSpline2dOptions): Result<Curve2DHandle>;
+/** Translate a 2D curve by (dx, dy). Returns a new curve. */
+export declare function translateCurve2d(curve: Curve2DHandle, dx: number, dy: number): Result<Curve2DHandle>;
+/** Rotate a 2D curve by an angle (radians) around a center point. Returns a new curve. */
+export declare function rotateCurve2d(curve: Curve2DHandle, angle: number, center?: Point2D): Result<Curve2DHandle>;
+/** Scale a 2D curve by a factor around a center point. Returns a new curve. */
+export declare function scaleCurve2d(curve: Curve2DHandle, factor: number, center?: Point2D): Result<Curve2DHandle>;
+/** Mirror a 2D curve across a point. Returns a new curve. */
+export declare function mirrorCurve2d(curve: Curve2DHandle, point: Point2D): Result<Curve2DHandle>;
+/** Mirror a 2D curve across an axis defined by origin and direction. Returns a new curve. */
+export declare function mirrorCurve2dAcrossAxis(curve: Curve2DHandle, origin: Point2D, direction: Point2D): Result<Curve2DHandle>;
+/** Offset a 2D curve by a distance. Returns a new curve. */
+export declare function offsetCurve2d(curve: Curve2DHandle, distance: number): Result<Curve2DHandle>;
+/** Evaluate a point on a 2D curve at a parameter value. */
+export declare function evaluateCurve2d(curve: Curve2DHandle, param: number): Result<Point2D>;
+/** Evaluate point and tangent on a 2D curve at a parameter value. */
+export declare function tangentCurve2d(curve: Curve2DHandle, param: number): Result<{
+    point: Point2D;
+    tangent: Point2D;
+}>;
+/** Get the parameter bounds of a 2D curve. */
+export declare function boundsCurve2d(curve: Curve2DHandle): Result<{
+    first: number;
+    last: number;
+}>;
+/** Get the geometric type of a 2D curve (e.g., "Line", "Circle", "BSpline"). */
+export declare function typeCurve2d(curve: Curve2DHandle): Result<string>;
+/**
+ * Find intersection points and overlap segments between two 2D curves.
+ *
+ * Returned `segments` are individually disposable — callers must dispose
+ * each element when done.
+ *
+ * @param tolerance - Intersection tolerance (default: `1e-7`).
+ */
+export declare function intersectCurves2d(c1: Curve2DHandle, c2: Curve2DHandle, tolerance?: number): Result<{
+    points: Point2D[];
+    segments: Curve2DHandle[];
+}>;
+/**
+ * Project a point onto a 2D curve, finding the closest parameter.
+ *
+ * Returns `ok(null)` when no projection exists (valid geometric outcome),
+ * not an error. Only kernel failures produce `err()`.
+ */
+export declare function projectPointOnCurve2d(curve: Curve2DHandle, point: Point2D): Result<{
+    param: number;
+    distance: number;
+} | null>;
+/**
+ * Compute the minimum distance between two 2D curves.
+ *
+ * @param bounds1 - Optional parameter range for c1 (default: full curve bounds).
+ * @param bounds2 - Optional parameter range for c2 (default: full curve bounds).
+ */
+export declare function distanceBetweenCurves2d(c1: Curve2DHandle, c2: Curve2DHandle, bounds1?: {
+    first: number;
+    last: number;
+}, bounds2?: {
+    first: number;
+    last: number;
+}): Result<number>;
+/**
+ * Lift a 2D curve onto a 3D plane, producing a 3D edge.
+ *
+ * Decomposes the `Plane` into kernel arguments:
+ * `plane.origin` → `planeOrigin`, `plane.zDir` → `planeZ`, `plane.xDir` → `planeX`.
+ */
+export declare function liftCurve2dToPlane(curve: Curve2DHandle, plane: Plane): Result<Edge>;
+/** Extract the 2D parametric curve of a 3D edge on a face. */
+export declare function extractCurve2dFromEdge(edge: Edge, face: Face): Result<Curve2DHandle>;
+//# sourceMappingURL=curve2dGeometryFns.d.ts.map

package/dist/2d/curve2dGeometryFns.d.ts.map

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

package/dist/2d.cjs

@@ -1,13 +1,222 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_boolean2D = require("./boolean2D-CMXMxTgD.cjs");
-const require_blueprint = require("./blueprint-YPV8lQqg.cjs");
-const require_blueprintFns = require("./blueprintFns-iQsyPfTY.cjs");
+const require_shapeTypes = require("./shapeTypes-8eK48l-X.cjs");
+const require_errors = require("./errors-BlC5ZWv4.cjs");
+const require_blueprintFns = require("./blueprintFns-D4YucGaQ.cjs");
+const require_boolean2D = require("./boolean2D-lqfKJKUY.cjs");
+const require_blueprint = require("./blueprint-CDnBM-tA.cjs");
+//#region src/core/curve2dHandle.ts
+/**
+* Wrap a raw kernel 2D curve handle with brand + disposal tracking.
+*
+* Uses {@link createKernelHandle} internally for stats tracking,
+* `FinalizationRegistry` safety net, and double-dispose guards.
+*/
+function createCurve2DHandle(rawHandle) {
+	const inner = require_shapeTypes.createKernelHandle(typeof rawHandle.delete === "function" ? rawHandle : { delete() {} });
+	return {
+		get raw() {
+			if (inner.disposed) throw new Error("Curve2DHandle has been disposed");
+			return rawHandle;
+		},
+		get disposed() {
+			return inner.disposed;
+		},
+		[Symbol.dispose]() {
+			inner[Symbol.dispose]();
+		}
+	};
+}
+//#endregion
+//#region src/2d/curve2dGeometryFns.ts
+/**
+* Public functional API for 2D curve geometry.
+*
+* Wraps {@link Kernel2DCapability} methods with branded {@link Curve2DHandle}
+* types, `Result<T>` error handling, and `Disposable` support.
+*
+* All functions call `getKernel2D()` internally — the kernel must be
+* initialised before use.
+*
+* @module
+*/
+var { CURVE2D_CONSTRUCTION_FAILED, CURVE2D_INVALID_RADIUS, CURVE2D_TRANSFORM_FAILED, CURVE2D_QUERY_FAILED, CURVE2D_INTERSECTION_FAILED, CURVE2D_BRIDGE_FAILED } = require_errors.BrepErrorCode;
+/**
+* Wrap a raw kernel curve handle, upcasting to Handle_Geom2d_Curve
+* (required for OCCT — specific subtypes like Handle_Geom2d_TrimmedCurve
+* must be upcasted before passing to generic curve operations).
+*/
+function wrapRawHandle(raw) {
+	return createCurve2DHandle(require_shapeTypes.getKernel2D().wrapCurve2dHandle(raw));
+}
+/** Wrap a kernel call that returns a raw curve handle into Result<Curve2DHandle>. */
+function curveCall(fn, code, message) {
+	const result = require_blueprintFns.kernelCallRaw(fn, code, message);
+	if (!result.ok) return result;
+	return require_errors.ok(wrapRawHandle(result.value));
+}
+/** Validate that ellipse radii are positive and that minor does not exceed major. */
+function validateEllipseRadii(majorRadius, minorRadius) {
+	if (majorRadius <= 0 || minorRadius <= 0) return require_errors.err(require_errors.validationError(CURVE2D_INVALID_RADIUS, `Ellipse radii must be positive, got major=${majorRadius}, minor=${minorRadius}`));
+	if (minorRadius > majorRadius) return require_errors.err(require_errors.validationError(CURVE2D_INVALID_RADIUS, `Ellipse minor radius (${minorRadius}) must not exceed major radius (${majorRadius})`));
+	return null;
+}
+/** Create a 2D line segment between two points. */
+function line2d(from, to) {
+	return curveCall(() => require_shapeTypes.getKernel2D().makeLine2d(from[0], from[1], to[0], to[1]), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D line");
+}
+/** Create a full 2D circle. */
+function circle2d(center, radius, sense) {
+	if (radius <= 0) return require_errors.err(require_errors.validationError(CURVE2D_INVALID_RADIUS, `Circle radius must be positive, got ${radius}`));
+	return curveCall(() => require_shapeTypes.getKernel2D().makeCircle2d(center[0], center[1], radius, sense), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D circle");
+}
+/** Create a 2D arc through three points. */
+function arc2d(p1, mid, p2) {
+	return curveCall(() => require_shapeTypes.getKernel2D().makeArc2dThreePoints(p1[0], p1[1], mid[0], mid[1], p2[0], p2[1]), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D arc from 3 points");
+}
+/** Create a 2D arc from a start point, tangent direction, and end point. */
+function arc2dTangent(start, tangent, end) {
+	return curveCall(() => require_shapeTypes.getKernel2D().makeArc2dTangent(start[0], start[1], tangent[0], tangent[1], end[0], end[1]), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D tangent arc");
+}
+/** Create a full 2D ellipse. */
+function ellipse2d(center, majorRadius, minorRadius, options) {
+	const radiusError = validateEllipseRadii(majorRadius, minorRadius);
+	if (radiusError !== null) return radiusError;
+	return curveCall(() => require_shapeTypes.getKernel2D().makeEllipse2d(center[0], center[1], majorRadius, minorRadius, options?.xDir?.[0], options?.xDir?.[1], options?.sense), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D ellipse");
+}
+/** Create a 2D elliptical arc. */
+function ellipseArc2d(center, majorRadius, minorRadius, startAngle, endAngle, options) {
+	const radiusError = validateEllipseRadii(majorRadius, minorRadius);
+	if (radiusError !== null) return radiusError;
+	return curveCall(() => require_shapeTypes.getKernel2D().makeEllipseArc2d(center[0], center[1], majorRadius, minorRadius, startAngle, endAngle, options?.xDir?.[0], options?.xDir?.[1], options?.sense), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D ellipse arc");
+}
+/** Create a 2D Bezier curve through control points. */
+function bezier2d(points) {
+	if (points.length < 2) return require_errors.err(require_errors.validationError(CURVE2D_CONSTRUCTION_FAILED, `Bezier curve requires at least 2 control points, got ${points.length}`));
+	return curveCall(() => require_shapeTypes.getKernel2D().makeBezier2d(points), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D Bezier curve");
+}
+/** Create a 2D B-spline curve interpolating through points. */
+function bspline2d(points, options) {
+	if (points.length < 2) return require_errors.err(require_errors.validationError(CURVE2D_CONSTRUCTION_FAILED, `B-spline curve requires at least 2 points, got ${points.length}`));
+	return curveCall(() => require_shapeTypes.getKernel2D().makeBSpline2d(points, options), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D B-spline curve");
+}
+/** Translate a 2D curve by (dx, dy). Returns a new curve. */
+function translateCurve2d(curve, dx, dy) {
+	return curveCall(() => require_shapeTypes.getKernel2D().translateCurve2d(curve.raw, dx, dy), CURVE2D_TRANSFORM_FAILED, "Failed to translate 2D curve");
+}
+/** Rotate a 2D curve by an angle (radians) around a center point. Returns a new curve. */
+function rotateCurve2d(curve, angle, center = [0, 0]) {
+	return curveCall(() => require_shapeTypes.getKernel2D().rotateCurve2d(curve.raw, angle, center[0], center[1]), CURVE2D_TRANSFORM_FAILED, "Failed to rotate 2D curve");
+}
+/** Scale a 2D curve by a factor around a center point. Returns a new curve. */
+function scaleCurve2d(curve, factor, center = [0, 0]) {
+	return curveCall(() => require_shapeTypes.getKernel2D().scaleCurve2d(curve.raw, factor, center[0], center[1]), CURVE2D_TRANSFORM_FAILED, "Failed to scale 2D curve");
+}
+/** Mirror a 2D curve across a point. Returns a new curve. */
+function mirrorCurve2d(curve, point) {
+	return curveCall(() => require_shapeTypes.getKernel2D().mirrorCurve2dAtPoint(curve.raw, point[0], point[1]), CURVE2D_TRANSFORM_FAILED, "Failed to mirror 2D curve");
+}
+/** Mirror a 2D curve across an axis defined by origin and direction. Returns a new curve. */
+function mirrorCurve2dAcrossAxis(curve, origin, direction) {
+	return curveCall(() => require_shapeTypes.getKernel2D().mirrorCurve2dAcrossAxis(curve.raw, origin[0], origin[1], direction[0], direction[1]), CURVE2D_TRANSFORM_FAILED, "Failed to mirror 2D curve across axis");
+}
+/** Offset a 2D curve by a distance. Returns a new curve. */
+function offsetCurve2d(curve, distance) {
+	return curveCall(() => require_shapeTypes.getKernel2D().offsetCurve2d(curve.raw, distance), CURVE2D_TRANSFORM_FAILED, "Failed to offset 2D curve");
+}
+/** Evaluate a point on a 2D curve at a parameter value. */
+function evaluateCurve2d(curve, param) {
+	return require_blueprintFns.kernelCallRaw(() => require_shapeTypes.getKernel2D().evaluateCurve2d(curve.raw, param), CURVE2D_QUERY_FAILED, "Failed to evaluate 2D curve");
+}
+/** Evaluate point and tangent on a 2D curve at a parameter value. */
+function tangentCurve2d(curve, param) {
+	return require_blueprintFns.kernelCallRaw(() => require_shapeTypes.getKernel2D().evaluateCurve2dD1(curve.raw, param), CURVE2D_QUERY_FAILED, "Failed to evaluate 2D curve tangent");
+}
+/** Get the parameter bounds of a 2D curve. */
+function boundsCurve2d(curve) {
+	return require_blueprintFns.kernelCallRaw(() => require_shapeTypes.getKernel2D().getCurve2dBounds(curve.raw), CURVE2D_QUERY_FAILED, "Failed to get 2D curve bounds");
+}
+/** Get the geometric type of a 2D curve (e.g., "Line", "Circle", "BSpline"). */
+function typeCurve2d(curve) {
+	return require_blueprintFns.kernelCallRaw(() => require_shapeTypes.getKernel2D().getCurve2dType(curve.raw), CURVE2D_QUERY_FAILED, "Failed to get 2D curve type");
+}
+/**
+* Find intersection points and overlap segments between two 2D curves.
+*
+* Returned `segments` are individually disposable — callers must dispose
+* each element when done.
+*
+* @param tolerance - Intersection tolerance (default: `1e-7`).
+*/
+function intersectCurves2d(c1, c2, tolerance = 1e-7) {
+	return require_blueprintFns.kernelCallRaw(() => {
+		const result = require_shapeTypes.getKernel2D().intersectCurves2d(c1.raw, c2.raw, tolerance);
+		const wrapped = [];
+		try {
+			for (const s of result.segments) wrapped.push(wrapRawHandle(s));
+		} catch (e) {
+			wrapped.forEach((h) => {
+				h[Symbol.dispose]();
+			});
+			throw e;
+		}
+		return {
+			points: result.points,
+			segments: wrapped
+		};
+	}, CURVE2D_INTERSECTION_FAILED, "Failed to intersect 2D curves");
+}
+/**
+* Project a point onto a 2D curve, finding the closest parameter.
+*
+* Returns `ok(null)` when no projection exists (valid geometric outcome),
+* not an error. Only kernel failures produce `err()`.
+*/
+function projectPointOnCurve2d(curve, point) {
+	return require_blueprintFns.kernelCallRaw(() => require_shapeTypes.getKernel2D().projectPointOnCurve2d(curve.raw, point[0], point[1]), CURVE2D_QUERY_FAILED, "Failed to project point onto 2D curve");
+}
+/**
+* Compute the minimum distance between two 2D curves.
+*
+* @param bounds1 - Optional parameter range for c1 (default: full curve bounds).
+* @param bounds2 - Optional parameter range for c2 (default: full curve bounds).
+*/
+function distanceBetweenCurves2d(c1, c2, bounds1, bounds2) {
+	return require_blueprintFns.kernelCallRaw(() => {
+		const kernel = require_shapeTypes.getKernel2D();
+		const b1 = bounds1 ?? kernel.getCurve2dBounds(c1.raw);
+		const b2 = bounds2 ?? kernel.getCurve2dBounds(c2.raw);
+		return kernel.distanceBetweenCurves2d(c1.raw, c2.raw, b1.first, b1.last, b2.first, b2.last);
+	}, CURVE2D_QUERY_FAILED, "Failed to compute distance between 2D curves");
+}
+/**
+* Lift a 2D curve onto a 3D plane, producing a 3D edge.
+*
+* Decomposes the `Plane` into kernel arguments:
+* `plane.origin` → `planeOrigin`, `plane.zDir` → `planeZ`, `plane.xDir` → `planeX`.
+*/
+function liftCurve2dToPlane(curve, plane) {
+	return require_blueprintFns.kernelCallRaw(() => {
+		return require_shapeTypes.createEdge(require_shapeTypes.getKernel2D().liftCurve2dToPlane(curve.raw, [...plane.origin], [...plane.zDir], [...plane.xDir]));
+	}, CURVE2D_BRIDGE_FAILED, "Failed to lift 2D curve to plane");
+}
+/** Extract the 2D parametric curve of a 3D edge on a face. */
+function extractCurve2dFromEdge(edge, face) {
+	return curveCall(() => require_shapeTypes.getKernel2D().extractCurve2dFromEdge(edge.wrapped, face.wrapped), CURVE2D_BRIDGE_FAILED, "Failed to extract 2D curve from edge");
+}
+//#endregion
 exports.Blueprint = require_blueprint.Blueprint;
 exports.Blueprints = require_boolean2D.Blueprints;
 exports.BoundingBox2d = require_blueprint.BoundingBox2d;
 exports.CompoundBlueprint = require_boolean2D.CompoundBlueprint;
 exports.Curve2D = require_blueprint.Curve2D;
+exports.arc2d = arc2d;
+exports.arc2dTangent = arc2dTangent;
+exports.bezier2d = bezier2d;
+exports.boundsCurve2d = boundsCurve2d;
+exports.bspline2d = bspline2d;
+exports.circle2d = circle2d;
 exports.createBlueprint = require_blueprintFns.createBlueprint;
+exports.createCurve2DHandle = createCurve2DHandle;
 exports.curve2dBoundingBox = require_blueprintFns.curve2dBoundingBox;
 exports.curve2dDistanceFrom = require_blueprintFns.curve2dDistanceFrom;
 exports.curve2dFirstPoint = require_blueprintFns.curve2dFirstPoint;
@@ -18,22 +227,39 @@ exports.curve2dSplitAt = require_blueprintFns.curve2dSplitAt;
 exports.curve2dTangentAt = require_blueprintFns.curve2dTangentAt;
 exports.cut2D = require_boolean2D.cut2D;
 exports.cutBlueprints = require_boolean2D.cutBlueprints;
+exports.distanceBetweenCurves2d = distanceBetweenCurves2d;
+exports.ellipse2d = ellipse2d;
+exports.ellipseArc2d = ellipseArc2d;
+exports.evaluateCurve2d = evaluateCurve2d;
+exports.extractCurve2dFromEdge = extractCurve2dFromEdge;
 exports.fuse2D = require_boolean2D.fuse2D;
 exports.fuseBlueprints = require_boolean2D.fuseBlueprints;
 exports.getBounds2D = require_blueprintFns.getBounds2D;
 exports.getOrientation2D = require_blueprintFns.getOrientation2D;
 exports.intersect2D = require_boolean2D.intersect2D;
 exports.intersectBlueprints = require_boolean2D.intersectBlueprints;
+exports.intersectCurves2d = intersectCurves2d;
 exports.isInside2D = require_blueprintFns.isInside2D;
+exports.liftCurve2dToPlane = liftCurve2dToPlane;
+exports.line2d = line2d;
 exports.mirror2D = require_blueprintFns.mirror2D;
+exports.mirrorCurve2d = mirrorCurve2d;
+exports.mirrorCurve2dAcrossAxis = mirrorCurve2dAcrossAxis;
+exports.offsetCurve2d = offsetCurve2d;
 exports.organiseBlueprints = require_boolean2D.organiseBlueprints;
 exports.polysidesBlueprint = require_boolean2D.polysidesBlueprint;
+exports.projectPointOnCurve2d = projectPointOnCurve2d;
 exports.reverseCurve = require_blueprintFns.reverseCurve;
 exports.rotate2D = require_blueprintFns.rotate2D;
+exports.rotateCurve2d = rotateCurve2d;
 exports.roundedRectangleBlueprint = require_boolean2D.roundedRectangleBlueprint;
 exports.scale2D = require_blueprintFns.scale2D;
+exports.scaleCurve2d = scaleCurve2d;
 exports.sketchOnFace2D = require_blueprintFns.sketchOnFace2D;
 exports.sketchOnPlane2D = require_blueprintFns.sketchOnPlane2D;
 exports.stretch2D = require_blueprintFns.stretch2D;
+exports.tangentCurve2d = tangentCurve2d;
 exports.toSVGPathD = require_blueprintFns.toSVGPathD;
 exports.translate2D = require_blueprintFns.translate2D;
+exports.translateCurve2d = translateCurve2d;
+exports.typeCurve2d = typeCurve2d;

package/dist/2d.d.ts

@@ -17,7 +17,9 @@ export { createBlueprint, getBounds2D, getOrientation2D, isInside2D, toSVGPathD,
 export { fuseBlueprints, cutBlueprints, intersectBlueprints, } from './2d/blueprints/booleanOperations.js';
 export { fuse2D, cut2D, intersect2D, type Shape2D } from './2d/blueprints/boolean2D.js';
 export { reverseCurve, curve2dBoundingBox, curve2dFirstPoint, curve2dLastPoint, curve2dSplitAt, curve2dParameter, curve2dTangentAt, curve2dIsOnCurve, curve2dDistanceFrom, } from './2d/lib/curve2dFns.js';
+export { line2d, circle2d, arc2d, arc2dTangent, ellipse2d, ellipseArc2d, bezier2d, bspline2d, translateCurve2d, rotateCurve2d, scaleCurve2d, mirrorCurve2d, mirrorCurve2dAcrossAxis, offsetCurve2d, evaluateCurve2d, tangentCurve2d, boundsCurve2d, typeCurve2d, intersectCurves2d, projectPointOnCurve2d, distanceBetweenCurves2d, liftCurve2dToPlane, extractCurve2dFromEdge, type Ellipse2dOptions, type BSpline2dOptions, } from './2d/curve2dGeometryFns.js';
 export { type Point2D, BoundingBox2d, Curve2D } from './2d/lib/index.js';
+export { type Curve2DHandle, createCurve2DHandle } from './core/curve2dHandle.js';
 export { organiseBlueprints } from './2d/blueprints/lib.js';
 export { polysidesBlueprint, roundedRectangleBlueprint } from './2d/blueprints/cannedBlueprints.js';
 export type { ScaleMode } from './2d/curves.js';

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

@@ -1 +1 @@
-{"version":3,"file":"2d.d.ts","sourceRoot":"","sources":["../src/2d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAItE,OAAO,EACL,eAAe,EAEf,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,eAAe,EACf,cAAc,GACf,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAIxF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACpG,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"2d.d.ts","sourceRoot":"","sources":["../src/2d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAItE,OAAO,EACL,eAAe,EAEf,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,eAAe,EACf,cAAc,GACf,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAIxF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,KAAK,aAAa,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACpG,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/2d.js

@@ -1,4 +1,206 @@
-import { a as fuseBlueprints, c as roundedRectangleBlueprint, g as Blueprints, h as CompoundBlueprint, i as cutBlueprints, m as organiseBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-D_yuF0kT.js";
-import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-Bpa-w3WF.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-D0RopDZS.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 };
+import { X as getKernel2D, a as createEdge, z as createKernelHandle } from "./shapeTypes-Di6GlhPk.js";
+import { d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-BVOlxlIA.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, w as kernelCallRaw, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-DVDommWB.js";
+import { a as fuseBlueprints, c as roundedRectangleBlueprint, g as Blueprints, h as CompoundBlueprint, i as cutBlueprints, m as organiseBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-Mzp-0g7o.js";
+import { _ as Curve2D, t as Blueprint, y as BoundingBox2d } from "./blueprint-CB_85Lz_.js";
+//#region src/core/curve2dHandle.ts
+/**
+* Wrap a raw kernel 2D curve handle with brand + disposal tracking.
+*
+* Uses {@link createKernelHandle} internally for stats tracking,
+* `FinalizationRegistry` safety net, and double-dispose guards.
+*/
+function createCurve2DHandle(rawHandle) {
+	const inner = createKernelHandle(typeof rawHandle.delete === "function" ? rawHandle : { delete() {} });
+	return {
+		get raw() {
+			if (inner.disposed) throw new Error("Curve2DHandle has been disposed");
+			return rawHandle;
+		},
+		get disposed() {
+			return inner.disposed;
+		},
+		[Symbol.dispose]() {
+			inner[Symbol.dispose]();
+		}
+	};
+}
+//#endregion
+//#region src/2d/curve2dGeometryFns.ts
+/**
+* Public functional API for 2D curve geometry.
+*
+* Wraps {@link Kernel2DCapability} methods with branded {@link Curve2DHandle}
+* types, `Result<T>` error handling, and `Disposable` support.
+*
+* All functions call `getKernel2D()` internally — the kernel must be
+* initialised before use.
+*
+* @module
+*/
+var { CURVE2D_CONSTRUCTION_FAILED, CURVE2D_INVALID_RADIUS, CURVE2D_TRANSFORM_FAILED, CURVE2D_QUERY_FAILED, CURVE2D_INTERSECTION_FAILED, CURVE2D_BRIDGE_FAILED } = BrepErrorCode;
+/**
+* Wrap a raw kernel curve handle, upcasting to Handle_Geom2d_Curve
+* (required for OCCT — specific subtypes like Handle_Geom2d_TrimmedCurve
+* must be upcasted before passing to generic curve operations).
+*/
+function wrapRawHandle(raw) {
+	return createCurve2DHandle(getKernel2D().wrapCurve2dHandle(raw));
+}
+/** Wrap a kernel call that returns a raw curve handle into Result<Curve2DHandle>. */
+function curveCall(fn, code, message) {
+	const result = kernelCallRaw(fn, code, message);
+	if (!result.ok) return result;
+	return ok(wrapRawHandle(result.value));
+}
+/** Validate that ellipse radii are positive and that minor does not exceed major. */
+function validateEllipseRadii(majorRadius, minorRadius) {
+	if (majorRadius <= 0 || minorRadius <= 0) return err(validationError(CURVE2D_INVALID_RADIUS, `Ellipse radii must be positive, got major=${majorRadius}, minor=${minorRadius}`));
+	if (minorRadius > majorRadius) return err(validationError(CURVE2D_INVALID_RADIUS, `Ellipse minor radius (${minorRadius}) must not exceed major radius (${majorRadius})`));
+	return null;
+}
+/** Create a 2D line segment between two points. */
+function line2d(from, to) {
+	return curveCall(() => getKernel2D().makeLine2d(from[0], from[1], to[0], to[1]), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D line");
+}
+/** Create a full 2D circle. */
+function circle2d(center, radius, sense) {
+	if (radius <= 0) return err(validationError(CURVE2D_INVALID_RADIUS, `Circle radius must be positive, got ${radius}`));
+	return curveCall(() => getKernel2D().makeCircle2d(center[0], center[1], radius, sense), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D circle");
+}
+/** Create a 2D arc through three points. */
+function arc2d(p1, mid, p2) {
+	return curveCall(() => getKernel2D().makeArc2dThreePoints(p1[0], p1[1], mid[0], mid[1], p2[0], p2[1]), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D arc from 3 points");
+}
+/** Create a 2D arc from a start point, tangent direction, and end point. */
+function arc2dTangent(start, tangent, end) {
+	return curveCall(() => getKernel2D().makeArc2dTangent(start[0], start[1], tangent[0], tangent[1], end[0], end[1]), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D tangent arc");
+}
+/** Create a full 2D ellipse. */
+function ellipse2d(center, majorRadius, minorRadius, options) {
+	const radiusError = validateEllipseRadii(majorRadius, minorRadius);
+	if (radiusError !== null) return radiusError;
+	return curveCall(() => getKernel2D().makeEllipse2d(center[0], center[1], majorRadius, minorRadius, options?.xDir?.[0], options?.xDir?.[1], options?.sense), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D ellipse");
+}
+/** Create a 2D elliptical arc. */
+function ellipseArc2d(center, majorRadius, minorRadius, startAngle, endAngle, options) {
+	const radiusError = validateEllipseRadii(majorRadius, minorRadius);
+	if (radiusError !== null) return radiusError;
+	return curveCall(() => getKernel2D().makeEllipseArc2d(center[0], center[1], majorRadius, minorRadius, startAngle, endAngle, options?.xDir?.[0], options?.xDir?.[1], options?.sense), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D ellipse arc");
+}
+/** Create a 2D Bezier curve through control points. */
+function bezier2d(points) {
+	if (points.length < 2) return err(validationError(CURVE2D_CONSTRUCTION_FAILED, `Bezier curve requires at least 2 control points, got ${points.length}`));
+	return curveCall(() => getKernel2D().makeBezier2d(points), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D Bezier curve");
+}
+/** Create a 2D B-spline curve interpolating through points. */
+function bspline2d(points, options) {
+	if (points.length < 2) return err(validationError(CURVE2D_CONSTRUCTION_FAILED, `B-spline curve requires at least 2 points, got ${points.length}`));
+	return curveCall(() => getKernel2D().makeBSpline2d(points, options), CURVE2D_CONSTRUCTION_FAILED, "Failed to create 2D B-spline curve");
+}
+/** Translate a 2D curve by (dx, dy). Returns a new curve. */
+function translateCurve2d(curve, dx, dy) {
+	return curveCall(() => getKernel2D().translateCurve2d(curve.raw, dx, dy), CURVE2D_TRANSFORM_FAILED, "Failed to translate 2D curve");
+}
+/** Rotate a 2D curve by an angle (radians) around a center point. Returns a new curve. */
+function rotateCurve2d(curve, angle, center = [0, 0]) {
+	return curveCall(() => getKernel2D().rotateCurve2d(curve.raw, angle, center[0], center[1]), CURVE2D_TRANSFORM_FAILED, "Failed to rotate 2D curve");
+}
+/** Scale a 2D curve by a factor around a center point. Returns a new curve. */
+function scaleCurve2d(curve, factor, center = [0, 0]) {
+	return curveCall(() => getKernel2D().scaleCurve2d(curve.raw, factor, center[0], center[1]), CURVE2D_TRANSFORM_FAILED, "Failed to scale 2D curve");
+}
+/** Mirror a 2D curve across a point. Returns a new curve. */
+function mirrorCurve2d(curve, point) {
+	return curveCall(() => getKernel2D().mirrorCurve2dAtPoint(curve.raw, point[0], point[1]), CURVE2D_TRANSFORM_FAILED, "Failed to mirror 2D curve");
+}
+/** Mirror a 2D curve across an axis defined by origin and direction. Returns a new curve. */
+function mirrorCurve2dAcrossAxis(curve, origin, direction) {
+	return curveCall(() => getKernel2D().mirrorCurve2dAcrossAxis(curve.raw, origin[0], origin[1], direction[0], direction[1]), CURVE2D_TRANSFORM_FAILED, "Failed to mirror 2D curve across axis");
+}
+/** Offset a 2D curve by a distance. Returns a new curve. */
+function offsetCurve2d(curve, distance) {
+	return curveCall(() => getKernel2D().offsetCurve2d(curve.raw, distance), CURVE2D_TRANSFORM_FAILED, "Failed to offset 2D curve");
+}
+/** Evaluate a point on a 2D curve at a parameter value. */
+function evaluateCurve2d(curve, param) {
+	return kernelCallRaw(() => getKernel2D().evaluateCurve2d(curve.raw, param), CURVE2D_QUERY_FAILED, "Failed to evaluate 2D curve");
+}
+/** Evaluate point and tangent on a 2D curve at a parameter value. */
+function tangentCurve2d(curve, param) {
+	return kernelCallRaw(() => getKernel2D().evaluateCurve2dD1(curve.raw, param), CURVE2D_QUERY_FAILED, "Failed to evaluate 2D curve tangent");
+}
+/** Get the parameter bounds of a 2D curve. */
+function boundsCurve2d(curve) {
+	return kernelCallRaw(() => getKernel2D().getCurve2dBounds(curve.raw), CURVE2D_QUERY_FAILED, "Failed to get 2D curve bounds");
+}
+/** Get the geometric type of a 2D curve (e.g., "Line", "Circle", "BSpline"). */
+function typeCurve2d(curve) {
+	return kernelCallRaw(() => getKernel2D().getCurve2dType(curve.raw), CURVE2D_QUERY_FAILED, "Failed to get 2D curve type");
+}
+/**
+* Find intersection points and overlap segments between two 2D curves.
+*
+* Returned `segments` are individually disposable — callers must dispose
+* each element when done.
+*
+* @param tolerance - Intersection tolerance (default: `1e-7`).
+*/
+function intersectCurves2d(c1, c2, tolerance = 1e-7) {
+	return kernelCallRaw(() => {
+		const result = getKernel2D().intersectCurves2d(c1.raw, c2.raw, tolerance);
+		const wrapped = [];
+		try {
+			for (const s of result.segments) wrapped.push(wrapRawHandle(s));
+		} catch (e) {
+			wrapped.forEach((h) => {
+				h[Symbol.dispose]();
+			});
+			throw e;
+		}
+		return {
+			points: result.points,
+			segments: wrapped
+		};
+	}, CURVE2D_INTERSECTION_FAILED, "Failed to intersect 2D curves");
+}
+/**
+* Project a point onto a 2D curve, finding the closest parameter.
+*
+* Returns `ok(null)` when no projection exists (valid geometric outcome),
+* not an error. Only kernel failures produce `err()`.
+*/
+function projectPointOnCurve2d(curve, point) {
+	return kernelCallRaw(() => getKernel2D().projectPointOnCurve2d(curve.raw, point[0], point[1]), CURVE2D_QUERY_FAILED, "Failed to project point onto 2D curve");
+}
+/**
+* Compute the minimum distance between two 2D curves.
+*
+* @param bounds1 - Optional parameter range for c1 (default: full curve bounds).
+* @param bounds2 - Optional parameter range for c2 (default: full curve bounds).
+*/
+function distanceBetweenCurves2d(c1, c2, bounds1, bounds2) {
+	return kernelCallRaw(() => {
+		const kernel = getKernel2D();
+		const b1 = bounds1 ?? kernel.getCurve2dBounds(c1.raw);
+		const b2 = bounds2 ?? kernel.getCurve2dBounds(c2.raw);
+		return kernel.distanceBetweenCurves2d(c1.raw, c2.raw, b1.first, b1.last, b2.first, b2.last);
+	}, CURVE2D_QUERY_FAILED, "Failed to compute distance between 2D curves");
+}
+/**
+* Lift a 2D curve onto a 3D plane, producing a 3D edge.
+*
+* Decomposes the `Plane` into kernel arguments:
+* `plane.origin` → `planeOrigin`, `plane.zDir` → `planeZ`, `plane.xDir` → `planeX`.
+*/
+function liftCurve2dToPlane(curve, plane) {
+	return kernelCallRaw(() => {
+		return createEdge(getKernel2D().liftCurve2dToPlane(curve.raw, [...plane.origin], [...plane.zDir], [...plane.xDir]));
+	}, CURVE2D_BRIDGE_FAILED, "Failed to lift 2D curve to plane");
+}
+/** Extract the 2D parametric curve of a 3D edge on a face. */
+function extractCurve2dFromEdge(edge, face) {
+	return curveCall(() => getKernel2D().extractCurve2dFromEdge(edge.wrapped, face.wrapped), CURVE2D_BRIDGE_FAILED, "Failed to extract 2D curve from edge");
+}
+//#endregion
+export { Blueprint, Blueprints, BoundingBox2d, CompoundBlueprint, Curve2D, arc2d, arc2dTangent, bezier2d, boundsCurve2d, bspline2d, circle2d, createBlueprint, createCurve2DHandle, curve2dBoundingBox, curve2dDistanceFrom, curve2dFirstPoint, curve2dIsOnCurve, curve2dLastPoint, curve2dParameter, curve2dSplitAt, curve2dTangentAt, cut2D, cutBlueprints, distanceBetweenCurves2d, ellipse2d, ellipseArc2d, evaluateCurve2d, extractCurve2dFromEdge, fuse2D, fuseBlueprints, getBounds2D, getOrientation2D, intersect2D, intersectBlueprints, intersectCurves2d, isInside2D, liftCurve2dToPlane, line2d, mirror2D, mirrorCurve2d, mirrorCurve2dAcrossAxis, offsetCurve2d, organiseBlueprints, polysidesBlueprint, projectPointOnCurve2d, reverseCurve, rotate2D, rotateCurve2d, roundedRectangleBlueprint, scale2D, scaleCurve2d, sketchOnFace2D, sketchOnPlane2D, stretch2D, tangentCurve2d, toSVGPathD, translate2D, translateCurve2d, typeCurve2d };

package/dist/{arrayAccess-Bz2OkAF_.js → arrayAccess-B5LgmXBo.js}

@@ -1,7 +1,7 @@
-import { Y as getKernel, r as castShapeWithKnownType, t as castShape } from "./shapeTypes-Beo7ikOL.js";
-import { L as unwrap, d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-D7ZQfeqv.js";
-import { _ as DEG2RAD, v as HASH_CODE_MAX } from "./vecOps-B9-MTeC8.js";
-import { _ as downcast } from "./faceFns-6mY9O_5h.js";
+import { Y as getKernel, r as castShapeWithKnownType, t as castShape } from "./shapeTypes-Di6GlhPk.js";
+import { L as unwrap, d as validationError, k as ok, t as BrepErrorCode, y as err } from "./errors-BVOlxlIA.js";
+import { _ as DEG2RAD, v as HASH_CODE_MAX } from "./vecOps-DFfUfsmc.js";
+import { _ as downcast } from "./faceFns-Cat-4X74.js";
 //#region src/topology/topologyQueryFns.ts
 /**
 * Topology query functions — extract sub-shapes, compute bounds, and

package/dist/{arrayAccess-FwdVX3Nh.cjs → arrayAccess-t2dlxGSK.cjs}

@@ -1,7 +1,7 @@
-const require_shapeTypes = require("./shapeTypes-Du2qyM2n.cjs");
-const require_errors = require("./errors-BDTFTJ22.cjs");
-const require_vecOps = require("./vecOps-4iBMiet9.cjs");
-const require_faceFns = require("./faceFns-DSUZvptN.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_faceFns = require("./faceFns-BywUjlJ7.cjs");
 //#region src/topology/topologyQueryFns.ts
 /**
 * Topology query functions — extract sub-shapes, compute bounds, and