@faicad/faijs 0.13.0

package/dist/vendored/brepjs/2d/curve2dGeometryFns.js

@@ -0,0 +1,235 @@
+/**
+ * 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
+ */
+import { getKernel2D } from '../kernel/index.js';
+import { createCurve2DHandle } from '../core/curve2dHandle.js';
+import { createEdge } from '../core/shapeTypes.js';
+import { ok, err } from '../core/result.js';
+import { kernelCallRaw } from '../core/kernelCall.js';
+import { validationError, BrepErrorCode } from '../core/errors.js';
+const { CURVE2D_CONSTRUCTION_FAILED, CURVE2D_INVALID_RADIUS, CURVE2D_TRANSFORM_FAILED, CURVE2D_QUERY_FAILED, CURVE2D_INTERSECTION_FAILED, CURVE2D_BRIDGE_FAILED, } = BrepErrorCode;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * 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) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- kernel returns opaque handle
+    const wrapped = getKernel2D().wrapCurve2dHandle(raw);
+    return createCurve2DHandle(wrapped);
+}
+/** 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;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Constructors
+// ═══════════════════════════════════════════════════════════════════════════
+/** Create a 2D line segment between two points. */
+export 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. */
+export 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. */
+export 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. */
+export 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. */
+export 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. */
+export 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. */
+export 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. */
+export 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');
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Transforms
+// ═══════════════════════════════════════════════════════════════════════════
+/** Translate a 2D curve by (dx, dy). Returns a new curve. */
+export 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. */
+export 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. */
+export 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. */
+export 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. */
+export 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. */
+export function offsetCurve2d(curve, distance) {
+    return curveCall(() => getKernel2D().offsetCurve2d(curve.raw, distance), CURVE2D_TRANSFORM_FAILED, 'Failed to offset 2D curve');
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Queries
+// ═══════════════════════════════════════════════════════════════════════════
+/** Evaluate a point on a 2D curve at a parameter value. */
+export 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. */
+export 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. */
+export 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"). */
+export function typeCurve2d(curve) {
+    return kernelCallRaw(() => getKernel2D().getCurve2dType(curve.raw), CURVE2D_QUERY_FAILED, 'Failed to get 2D curve type');
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Intersection & Projection
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * 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 function intersectCurves2d(c1, c2, tolerance = 1e-7) {
+    return kernelCallRaw(() => {
+        const result = getKernel2D().intersectCurves2d(c1.raw, c2.raw, tolerance);
+        // Defensively wrap segments — dispose already-wrapped handles if one fails
+        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()`.
+ */
+export 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).
+ */
+export 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');
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// 2D ↔ 3D Bridge
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * 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 function liftCurve2dToPlane(curve, plane) {
+    return kernelCallRaw(() => {
+        const raw = getKernel2D().liftCurve2dToPlane(curve.raw, [...plane.origin], [...plane.zDir], [...plane.xDir]);
+        return createEdge(raw);
+    }, CURVE2D_BRIDGE_FAILED, 'Failed to lift 2D curve to plane');
+}
+/** Extract the 2D parametric curve of a 3D edge on a face. */
+export function extractCurve2dFromEdge(edge, face) {
+    return curveCall(() => getKernel2D().extractCurve2dFromEdge(edge.wrapped, face.wrapped), CURVE2D_BRIDGE_FAILED, 'Failed to extract 2D curve from edge');
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Curve modification
+// ═══════════════════════════════════════════════════════════════════════════
+/** Trim a 2D curve to a sub-range of its parameter domain. */
+export function trimCurve2d(curve, start, end) {
+    return curveCall(() => getKernel2D().trimCurve2d(curve.raw, start, end), CURVE2D_CONSTRUCTION_FAILED, 'Failed to trim 2D curve');
+}
+/** Create an independent deep copy of a 2D curve. */
+export function copyCurve2d(curve) {
+    return curveCall(() => getKernel2D().copyCurve2d(curve.raw), CURVE2D_CONSTRUCTION_FAILED, 'Failed to copy 2D curve');
+}
+/** Split a 2D curve at the given parameter values. */
+export function splitCurve2d(curve, params) {
+    return kernelCallRaw(() => {
+        const handles = getKernel2D().splitCurve2d(curve.raw, params);
+        return handles.map((h) => wrapRawHandle(h));
+    }, CURVE2D_CONSTRUCTION_FAILED, 'Failed to split 2D curve');
+}
+//# sourceMappingURL=curve2dGeometryFns.js.map

package/dist/vendored/brepjs/2d/curve2dGeometryFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curve2dGeometryFns.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/2d/curve2dGeometryFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Public functional API for 2D curve geometry.\n *\n * Wraps {@link Kernel2DCapability} methods with branded {@link Curve2DHandle}\n * types, `Result<T>` error handling, and `Disposable` support.\n *\n * All functions call `getKernel2D()` internally — the kernel must be\n * initialised before use.\n *\n * @module\n */\n\nimport { getKernel2D } from '../kernel/index.js';\nimport type { Curve2DHandle } from '../core/curve2dHandle.js';\nimport { createCurve2DHandle } from '../core/curve2dHandle.js';\nimport type { Point2D } from '../2d/lib/definitions.js';\nimport type { Plane } from '../core/planeTypes.js';\nimport type { Edge, Face } from '../core/shapeTypes.js';\nimport { createEdge } from '../core/shapeTypes.js';\nimport { type Result, ok, err } from '../core/result.js';\nimport { kernelCallRaw } from '../core/kernelCall.js';\nimport { validationError, BrepErrorCode } from '../core/errors.js';\n\nconst {\n  CURVE2D_CONSTRUCTION_FAILED,\n  CURVE2D_INVALID_RADIUS,\n  CURVE2D_TRANSFORM_FAILED,\n  CURVE2D_QUERY_FAILED,\n  CURVE2D_INTERSECTION_FAILED,\n  CURVE2D_BRIDGE_FAILED,\n} = BrepErrorCode;\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Wrap a raw kernel curve handle, upcasting to Handle_Geom2d_Curve\n * (required for OCCT — specific subtypes like Handle_Geom2d_TrimmedCurve\n * must be upcasted before passing to generic curve operations).\n */\nfunction wrapRawHandle(raw: unknown): Curve2DHandle {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- kernel returns opaque handle\n  const wrapped = getKernel2D().wrapCurve2dHandle(raw as any);\n  return createCurve2DHandle(wrapped);\n}\n\n/** Wrap a kernel call that returns a raw curve handle into Result<Curve2DHandle>. */\nfunction curveCall(fn: () => unknown, code: string, message: string): Result<Curve2DHandle> {\n  const result = kernelCallRaw(fn, code, message);\n  if (!result.ok) return result;\n  return ok(wrapRawHandle(result.value));\n}\n\n/** Validate that ellipse radii are positive and that minor does not exceed major. */\nfunction validateEllipseRadii(majorRadius: number, minorRadius: number): Result<never> | null {\n  if (majorRadius <= 0 || minorRadius <= 0) {\n    return err(\n      validationError(\n        CURVE2D_INVALID_RADIUS,\n        `Ellipse radii must be positive, got major=${majorRadius}, minor=${minorRadius}`\n      )\n    );\n  }\n  if (minorRadius > majorRadius) {\n    return err(\n      validationError(\n        CURVE2D_INVALID_RADIUS,\n        `Ellipse minor radius (${minorRadius}) must not exceed major radius (${majorRadius})`\n      )\n    );\n  }\n  return null;\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// Constructors\n// ═══════════════════════════════════════════════════════════════════════════\n\n/** Create a 2D line segment between two points. */\nexport function line2d(from: Point2D, to: Point2D): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().makeLine2d(from[0], from[1], to[0], to[1]),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D line'\n  );\n}\n\n/** Create a full 2D circle. */\nexport function circle2d(center: Point2D, radius: number, sense?: boolean): Result<Curve2DHandle> {\n  if (radius <= 0) {\n    return err(\n      validationError(CURVE2D_INVALID_RADIUS, `Circle radius must be positive, got ${radius}`)\n    );\n  }\n  return curveCall(\n    () => getKernel2D().makeCircle2d(center[0], center[1], radius, sense),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D circle'\n  );\n}\n\n/** Create a 2D arc through three points. */\nexport function arc2d(p1: Point2D, mid: Point2D, p2: Point2D): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().makeArc2dThreePoints(p1[0], p1[1], mid[0], mid[1], p2[0], p2[1]),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D arc from 3 points'\n  );\n}\n\n/** Create a 2D arc from a start point, tangent direction, and end point. */\nexport function arc2dTangent(\n  start: Point2D,\n  tangent: Point2D,\n  end: Point2D\n): Result<Curve2DHandle> {\n  return curveCall(\n    () =>\n      getKernel2D().makeArc2dTangent(start[0], start[1], tangent[0], tangent[1], end[0], end[1]),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D tangent arc'\n  );\n}\n\n/** Options for ellipse construction. */\nexport interface Ellipse2dOptions {\n  /** X-axis direction for the major axis (default: [1, 0]). */\n  readonly xDir?: Point2D;\n  /** Orientation sense (default: true = counter-clockwise). */\n  readonly sense?: boolean;\n}\n\n/** Create a full 2D ellipse. */\nexport function ellipse2d(\n  center: Point2D,\n  majorRadius: number,\n  minorRadius: number,\n  options?: Ellipse2dOptions\n): Result<Curve2DHandle> {\n  const radiusError = validateEllipseRadii(majorRadius, minorRadius);\n  if (radiusError !== null) return radiusError;\n  return curveCall(\n    () =>\n      getKernel2D().makeEllipse2d(\n        center[0],\n        center[1],\n        majorRadius,\n        minorRadius,\n        options?.xDir?.[0],\n        options?.xDir?.[1],\n        options?.sense\n      ),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D ellipse'\n  );\n}\n\n/** Create a 2D elliptical arc. */\nexport function ellipseArc2d(\n  center: Point2D,\n  majorRadius: number,\n  minorRadius: number,\n  startAngle: number,\n  endAngle: number,\n  options?: Ellipse2dOptions\n): Result<Curve2DHandle> {\n  const radiusError = validateEllipseRadii(majorRadius, minorRadius);\n  if (radiusError !== null) return radiusError;\n  return curveCall(\n    () =>\n      getKernel2D().makeEllipseArc2d(\n        center[0],\n        center[1],\n        majorRadius,\n        minorRadius,\n        startAngle,\n        endAngle,\n        options?.xDir?.[0],\n        options?.xDir?.[1],\n        options?.sense\n      ),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D ellipse arc'\n  );\n}\n\n/** Create a 2D Bezier curve through control points. */\nexport function bezier2d(points: Point2D[]): Result<Curve2DHandle> {\n  if (points.length < 2) {\n    return err(\n      validationError(\n        CURVE2D_CONSTRUCTION_FAILED,\n        `Bezier curve requires at least 2 control points, got ${points.length}`\n      )\n    );\n  }\n  return curveCall(\n    () => getKernel2D().makeBezier2d(points),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D Bezier curve'\n  );\n}\n\n/** Options for B-spline construction. */\nexport interface BSpline2dOptions {\n  readonly degMin?: number;\n  readonly degMax?: number;\n  readonly continuity?: 'C0' | 'C1' | 'C2' | 'C3';\n  readonly tolerance?: number;\n  readonly smoothing?: [number, number, number] | null;\n}\n\n/** Create a 2D B-spline curve interpolating through points. */\nexport function bspline2d(points: Point2D[], options?: BSpline2dOptions): Result<Curve2DHandle> {\n  if (points.length < 2) {\n    return err(\n      validationError(\n        CURVE2D_CONSTRUCTION_FAILED,\n        `B-spline curve requires at least 2 points, got ${points.length}`\n      )\n    );\n  }\n  return curveCall(\n    () => getKernel2D().makeBSpline2d(points, options),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to create 2D B-spline curve'\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// Transforms\n// ═══════════════════════════════════════════════════════════════════════════\n\n/** Translate a 2D curve by (dx, dy). Returns a new curve. */\nexport function translateCurve2d(\n  curve: Curve2DHandle,\n  dx: number,\n  dy: number\n): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().translateCurve2d(curve.raw, dx, dy),\n    CURVE2D_TRANSFORM_FAILED,\n    'Failed to translate 2D curve'\n  );\n}\n\n/** Rotate a 2D curve by an angle (radians) around a center point. Returns a new curve. */\nexport function rotateCurve2d(\n  curve: Curve2DHandle,\n  angle: number,\n  center: Point2D = [0, 0]\n): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().rotateCurve2d(curve.raw, angle, center[0], center[1]),\n    CURVE2D_TRANSFORM_FAILED,\n    'Failed to rotate 2D curve'\n  );\n}\n\n/** Scale a 2D curve by a factor around a center point. Returns a new curve. */\nexport function scaleCurve2d(\n  curve: Curve2DHandle,\n  factor: number,\n  center: Point2D = [0, 0]\n): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().scaleCurve2d(curve.raw, factor, center[0], center[1]),\n    CURVE2D_TRANSFORM_FAILED,\n    'Failed to scale 2D curve'\n  );\n}\n\n/** Mirror a 2D curve across a point. Returns a new curve. */\nexport function mirrorCurve2d(curve: Curve2DHandle, point: Point2D): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().mirrorCurve2dAtPoint(curve.raw, point[0], point[1]),\n    CURVE2D_TRANSFORM_FAILED,\n    'Failed to mirror 2D curve'\n  );\n}\n\n/** Mirror a 2D curve across an axis defined by origin and direction. Returns a new curve. */\nexport function mirrorCurve2dAcrossAxis(\n  curve: Curve2DHandle,\n  origin: Point2D,\n  direction: Point2D\n): Result<Curve2DHandle> {\n  return curveCall(\n    () =>\n      getKernel2D().mirrorCurve2dAcrossAxis(\n        curve.raw,\n        origin[0],\n        origin[1],\n        direction[0],\n        direction[1]\n      ),\n    CURVE2D_TRANSFORM_FAILED,\n    'Failed to mirror 2D curve across axis'\n  );\n}\n\n/** Offset a 2D curve by a distance. Returns a new curve. */\nexport function offsetCurve2d(curve: Curve2DHandle, distance: number): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().offsetCurve2d(curve.raw, distance),\n    CURVE2D_TRANSFORM_FAILED,\n    'Failed to offset 2D curve'\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// Queries\n// ═══════════════════════════════════════════════════════════════════════════\n\n/** Evaluate a point on a 2D curve at a parameter value. */\nexport function evaluateCurve2d(curve: Curve2DHandle, param: number): Result<Point2D> {\n  return kernelCallRaw(\n    () => getKernel2D().evaluateCurve2d(curve.raw, param),\n    CURVE2D_QUERY_FAILED,\n    'Failed to evaluate 2D curve'\n  );\n}\n\n/** Evaluate point and tangent on a 2D curve at a parameter value. */\nexport function tangentCurve2d(\n  curve: Curve2DHandle,\n  param: number\n): Result<{ point: Point2D; tangent: Point2D }> {\n  return kernelCallRaw(\n    () => getKernel2D().evaluateCurve2dD1(curve.raw, param),\n    CURVE2D_QUERY_FAILED,\n    'Failed to evaluate 2D curve tangent'\n  );\n}\n\n/** Get the parameter bounds of a 2D curve. */\nexport function boundsCurve2d(curve: Curve2DHandle): Result<{ first: number; last: number }> {\n  return kernelCallRaw(\n    () => getKernel2D().getCurve2dBounds(curve.raw),\n    CURVE2D_QUERY_FAILED,\n    'Failed to get 2D curve bounds'\n  );\n}\n\n/** Get the geometric type of a 2D curve (e.g., \"Line\", \"Circle\", \"BSpline\"). */\nexport function typeCurve2d(curve: Curve2DHandle): Result<string> {\n  return kernelCallRaw(\n    () => getKernel2D().getCurve2dType(curve.raw),\n    CURVE2D_QUERY_FAILED,\n    'Failed to get 2D curve type'\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// Intersection & Projection\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Find intersection points and overlap segments between two 2D curves.\n *\n * Returned `segments` are individually disposable — callers must dispose\n * each element when done.\n *\n * @param tolerance - Intersection tolerance (default: `1e-7`).\n */\nexport function intersectCurves2d(\n  c1: Curve2DHandle,\n  c2: Curve2DHandle,\n  tolerance = 1e-7\n): Result<{ points: Point2D[]; segments: Curve2DHandle[] }> {\n  return kernelCallRaw(\n    () => {\n      const result = getKernel2D().intersectCurves2d(c1.raw, c2.raw, tolerance);\n      // Defensively wrap segments — dispose already-wrapped handles if one fails\n      const wrapped: Curve2DHandle[] = [];\n      try {\n        for (const s of result.segments) {\n          wrapped.push(wrapRawHandle(s));\n        }\n      } catch (e) {\n        wrapped.forEach((h) => {\n          h[Symbol.dispose]();\n        });\n        throw e;\n      }\n      return { points: result.points, segments: wrapped };\n    },\n    CURVE2D_INTERSECTION_FAILED,\n    'Failed to intersect 2D curves'\n  );\n}\n\n/**\n * Project a point onto a 2D curve, finding the closest parameter.\n *\n * Returns `ok(null)` when no projection exists (valid geometric outcome),\n * not an error. Only kernel failures produce `err()`.\n */\nexport function projectPointOnCurve2d(\n  curve: Curve2DHandle,\n  point: Point2D\n): Result<{ param: number; distance: number } | null> {\n  return kernelCallRaw(\n    () => getKernel2D().projectPointOnCurve2d(curve.raw, point[0], point[1]),\n    CURVE2D_QUERY_FAILED,\n    'Failed to project point onto 2D curve'\n  );\n}\n\n/**\n * Compute the minimum distance between two 2D curves.\n *\n * @param bounds1 - Optional parameter range for c1 (default: full curve bounds).\n * @param bounds2 - Optional parameter range for c2 (default: full curve bounds).\n */\nexport function distanceBetweenCurves2d(\n  c1: Curve2DHandle,\n  c2: Curve2DHandle,\n  bounds1?: { first: number; last: number },\n  bounds2?: { first: number; last: number }\n): Result<number> {\n  return kernelCallRaw(\n    () => {\n      const kernel = getKernel2D();\n      const b1 = bounds1 ?? kernel.getCurve2dBounds(c1.raw);\n      const b2 = bounds2 ?? kernel.getCurve2dBounds(c2.raw);\n      return kernel.distanceBetweenCurves2d(c1.raw, c2.raw, b1.first, b1.last, b2.first, b2.last);\n    },\n    CURVE2D_QUERY_FAILED,\n    'Failed to compute distance between 2D curves'\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// 2D ↔ 3D Bridge\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Lift a 2D curve onto a 3D plane, producing a 3D edge.\n *\n * Decomposes the `Plane` into kernel arguments:\n * `plane.origin` → `planeOrigin`, `plane.zDir` → `planeZ`, `plane.xDir` → `planeX`.\n */\nexport function liftCurve2dToPlane(curve: Curve2DHandle, plane: Plane): Result<Edge> {\n  return kernelCallRaw(\n    () => {\n      const raw = getKernel2D().liftCurve2dToPlane(\n        curve.raw,\n        [...plane.origin],\n        [...plane.zDir],\n        [...plane.xDir]\n      );\n      return createEdge(raw);\n    },\n    CURVE2D_BRIDGE_FAILED,\n    'Failed to lift 2D curve to plane'\n  );\n}\n\n/** Extract the 2D parametric curve of a 3D edge on a face. */\nexport function extractCurve2dFromEdge(edge: Edge, face: Face): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().extractCurve2dFromEdge(edge.wrapped, face.wrapped),\n    CURVE2D_BRIDGE_FAILED,\n    'Failed to extract 2D curve from edge'\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// Curve modification\n// ═══════════════════════════════════════════════════════════════════════════\n\n/** Trim a 2D curve to a sub-range of its parameter domain. */\nexport function trimCurve2d(\n  curve: Curve2DHandle,\n  start: number,\n  end: number\n): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().trimCurve2d(curve.raw, start, end),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to trim 2D curve'\n  );\n}\n\n/** Create an independent deep copy of a 2D curve. */\nexport function copyCurve2d(curve: Curve2DHandle): Result<Curve2DHandle> {\n  return curveCall(\n    () => getKernel2D().copyCurve2d(curve.raw),\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to copy 2D curve'\n  );\n}\n\n/** Split a 2D curve at the given parameter values. */\nexport function splitCurve2d(curve: Curve2DHandle, params: number[]): Result<Curve2DHandle[]> {\n  return kernelCallRaw(\n    () => {\n      const handles = getKernel2D().splitCurve2d(curve.raw, params);\n      return handles.map((h: unknown) => wrapRawHandle(h));\n    },\n    CURVE2D_CONSTRUCTION_FAILED,\n    'Failed to split 2D curve'\n  );\n}\n"]}

package/dist/vendored/brepjs/2d/curves.d.ts

@@ -0,0 +1,45 @@
+import type { KernelType } from '../kernel/types.js';
+import type { Plane } from '../core/planeTypes.js';
+import type { Face, Edge } from '../core/shapeTypes.js';
+import { type Result } from '../core/result.js';
+import type { Point2D } from './lib/index.js';
+import { BoundingBox2d, Curve2D } from './lib/index.js';
+/** Compute the 2D bounding box enclosing all given curves. */
+export declare const curvesBoundingBox: (curves: Curve2D[]) => BoundingBox2d;
+/** Convert 2D curves to 3D edges by projecting them onto a plane. */
+export declare function curvesAsEdgesOnPlane(curves: Curve2D[], plane: Plane): Edge[];
+/** Convert 2D curves to 3D edges by mapping them onto a parametric surface. */
+export declare const curvesAsEdgesOnSurface: (curves: Curve2D[], geomSurf: KernelType) => Edge[];
+/** Apply an opaque gp_GTrsf2d transformation to an array of 2D curves. */
+export declare const transformCurves: (curves: Curve2D[], transformation: KernelType | null) => Curve2D[];
+/**
+ * Raw kernel `gp_GTrsf2d` handle.
+ * Callers are responsible for lifetime management.
+ */
+export type Transformation2D = KernelType;
+/** Create a 2D affinity (non-uniform scale) transformation along a direction. */
+export declare const stretchTransform2d: (ratio: number, direction: Point2D, origin?: Point2D) => Transformation2D;
+/** Create a 2D translation transformation. */
+export declare const translationTransform2d: (translation: Point2D) => Transformation2D;
+/**
+ * Create a 2D mirror transformation.
+ *
+ * @param mode - `'center'` mirrors around a point; `'axis'` mirrors across a line.
+ */
+export declare const mirrorTransform2d: (centerOrDirection: Point2D, origin?: Point2D, mode?: string) => Transformation2D;
+/** Create a 2D rotation transformation around a center point (angle in radians). */
+export declare const rotateTransform2d: (angle: number, center?: Point2D) => Transformation2D;
+/** Create a 2D uniform scale transformation around a center point. */
+export declare const scaleTransform2d: (scaleFactor: number, center?: Point2D) => Transformation2D;
+/** How to map 2D sketch coordinates onto a face's parametric UV space. */
+export type ScaleMode = 'original' | 'bounds' | 'native';
+/**
+ * Convert 2D curves to 3D edges on a face's surface, applying UV scaling.
+ *
+ * @param scale - How to map 2D coordinates to the face's parametric space.
+ * @returns `Err` if the face type is unsupported for the chosen scale mode.
+ */
+export declare function curvesAsEdgesOnFace(curves: Curve2D[], face: Face, scale?: ScaleMode): Result<Edge[]>;
+/** Extract the 2D parametric curve of an edge on a face's surface. */
+export declare function edgeToCurve(e: Edge, face: Face): Curve2D;
+//# sourceMappingURL=curves.d.ts.map

package/dist/vendored/brepjs/2d/curves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curves.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/2d/curves.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAExD,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,GAAI,QAAQ,OAAO,EAAE,KAAG,aAOrD,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,CAO5E;AAED,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,GAAI,QAAQ,OAAO,EAAE,EAAE,UAAU,UAAU,KAAG,IAAI,EAKpF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAC1B,QAAQ,OAAO,EAAE,EAEjB,gBAAgB,UAAU,GAAG,IAAI,KAChC,OAAO,EAMT,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE1C,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,WAAW,OAAO,EAClB,SAAQ,OAAgB,KACvB,gBAWF,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,GAAI,aAAa,OAAO,KAAG,gBAE7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,mBAAmB,OAAO,EAC1B,SAAQ,OAAgB,EACxB,aAAe,KACd,gBAaF,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,SAAQ,OAAgB,KAAG,gBAE3E,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,EACnB,SAAQ,OAAgB,KACvB,gBAEF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EAAE,EACjB,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,SAAsB,GAC5B,MAAM,CAAC,IAAI,EAAE,CAAC,CA0EhB;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAQxD"}

package/dist/vendored/brepjs/2d/curves.js

@@ -0,0 +1,139 @@
+import { getKernel } from '../kernel/index.js';
+import { createEdge } from '../core/shapeTypes.js';
+import { uvBounds, faceGeomType } from '../topology/faceFns.js';
+import { getOrientation } from '../topology/curveFns.js';
+import { ok, err } from '../core/result.js';
+import { validationError } from '../core/errors.js';
+import { BoundingBox2d, Curve2D } from './lib/index.js';
+/** Compute the 2D bounding box enclosing all given curves. */
+export const curvesBoundingBox = (curves) => {
+    const kernel = getKernel();
+    const boundBox = kernel.createBoundingBox2d();
+    curves.forEach((c) => {
+        kernel.addCurveToBBox2d(boundBox, c.wrapped, 1e-6);
+    });
+    return new BoundingBox2d(boundBox);
+};
+/** Convert 2D curves to 3D edges by projecting them onto a plane. */
+export function curvesAsEdgesOnPlane(curves, plane) {
+    const kernel = getKernel();
+    return curves.map((curve) => createEdge(kernel.liftCurve2dToPlane(curve.wrapped, [...plane.origin], [...plane.zDir], [...plane.xDir])));
+}
+/** Convert 2D curves to 3D edges by mapping them onto a parametric surface. */
+export const curvesAsEdgesOnSurface = (curves, geomSurf) => {
+    const kernel = getKernel();
+    return curves.map((curve) => createEdge(kernel.buildEdgeOnSurface(curve.wrapped, geomSurf)));
+};
+/** Apply an opaque gp_GTrsf2d transformation to an array of 2D curves. */
+export const transformCurves = (curves, 
+// eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents -- KernelType is any but null is a valid sentinel
+transformation) => {
+    const kernel = getKernel();
+    return curves.map((curve) => {
+        if (!transformation)
+            return curve.clone();
+        return new Curve2D(kernel.transformCurve2dGeneral(curve.wrapped, transformation));
+    });
+};
+/** Create a 2D affinity (non-uniform scale) transformation along a direction. */
+export const stretchTransform2d = (ratio, direction, origin = [0, 0]) => {
+    // `createAffinityGTrsf2d` follows OCCT `gp_GTrsf2d::SetAffinity`: it scales the
+    // component perpendicular to its axis. To stretch *along* `direction`, pass the
+    // axis perpendicular to it (rotate 90°: (dx, dy) -> (-dy, dx)).
+    return getKernel().createAffinityGTrsf2d(origin[0], origin[1], -direction[1], direction[0], ratio);
+};
+/** Create a 2D translation transformation. */
+export const translationTransform2d = (translation) => {
+    return getKernel().createTranslationGTrsf2d(translation[0], translation[1]);
+};
+/**
+ * Create a 2D mirror transformation.
+ *
+ * @param mode - `'center'` mirrors around a point; `'axis'` mirrors across a line.
+ */
+export const mirrorTransform2d = (centerOrDirection, origin = [0, 0], mode = 'center') => {
+    if (mode === 'center') {
+        return getKernel().createMirrorGTrsf2d(centerOrDirection[0], centerOrDirection[1], 'point');
+    }
+    return getKernel().createMirrorGTrsf2d(0, 0, 'axis', origin[0], origin[1], centerOrDirection[0], centerOrDirection[1]);
+};
+/** Create a 2D rotation transformation around a center point (angle in radians). */
+export const rotateTransform2d = (angle, center = [0, 0]) => {
+    return getKernel().createRotationGTrsf2d(angle, center[0], center[1]);
+};
+/** Create a 2D uniform scale transformation around a center point. */
+export const scaleTransform2d = (scaleFactor, center = [0, 0]) => {
+    return getKernel().createScaleGTrsf2d(scaleFactor, center[0], center[1]);
+};
+/**
+ * Convert 2D curves to 3D edges on a face's surface, applying UV scaling.
+ *
+ * @param scale - How to map 2D coordinates to the face's parametric space.
+ * @returns `Err` if the face type is unsupported for the chosen scale mode.
+ */
+export function curvesAsEdgesOnFace(curves, face, scale = 'original') {
+    const kernel = getKernel();
+    let geomSurf = kernel.extractSurfaceFromFace(face.wrapped);
+    const bounds = uvBounds(face);
+    // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents -- KernelType is any but null is a valid sentinel
+    let transformation = null;
+    if (scale === 'original' && faceGeomType(face) !== 'PLANE') {
+        if (faceGeomType(face) !== 'CYLINDRE')
+            return err(validationError('UNSUPPORTED_FACE_TYPE', 'Only planar and cylindrical faces can be unwrapped for sketching'));
+        const cylData = kernel.getSurfaceCylinderData(geomSurf);
+        if (!cylData) {
+            return err(validationError('UNSUPPORTED_FACE_TYPE', 'Could not extract cylinder data from face surface'));
+        }
+        if (!cylData.isDirect) {
+            geomSurf = kernel.reverseSurfaceU(geomSurf);
+        }
+        // Scale the u (circumferential, X) coordinate from arc length to angle.
+        transformation = stretchTransform2d(1 / cylData.radius, [1, 0]);
+    }
+    if (scale === 'bounds') {
+        transformation = kernel.createIdentityGTrsf2d();
+        try {
+            kernel.setGTrsf2dTranslationPart(transformation, 0, 0); // ensure identity state
+            // Apply u-axis affinity
+            const uAffinity = kernel.createAffinityGTrsf2d(0, 0, 0, 1, bounds.uMax - bounds.uMin);
+            kernel.multiplyGTrsf2d(transformation, uAffinity);
+            uAffinity.delete();
+            if (bounds.uMin !== 0) {
+                const trans = kernel.createIdentityGTrsf2d();
+                kernel.setGTrsf2dTranslationPart(trans, -bounds.uMin, 0);
+                kernel.multiplyGTrsf2d(transformation, trans);
+                trans.delete();
+            }
+            // Apply v-axis affinity
+            const vAffinity = kernel.createAffinityGTrsf2d(0, 0, 1, 0, bounds.vMax - bounds.vMin);
+            kernel.multiplyGTrsf2d(transformation, vAffinity);
+            vAffinity.delete();
+            if (bounds.vMin !== 0) {
+                const trans = kernel.createIdentityGTrsf2d();
+                kernel.setGTrsf2dTranslationPart(trans, 0, -bounds.vMin);
+                kernel.multiplyGTrsf2d(transformation, trans);
+                trans.delete();
+            }
+        }
+        catch (e) {
+            transformation.delete();
+            throw e;
+        }
+    }
+    const modifiedCurves = transformCurves(curves, transformation);
+    const edges = curvesAsEdgesOnSurface(modifiedCurves, geomSurf);
+    if (transformation)
+        transformation.delete();
+    return ok(edges);
+}
+/** Extract the 2D parametric curve of an edge on a face's surface. */
+export function edgeToCurve(e, face) {
+    const kernel = getKernel();
+    const handle = kernel.extractCurve2dFromEdge(e.wrapped, face.wrapped);
+    const curve = new Curve2D(handle);
+    if (getOrientation(e) === 'backward') {
+        kernel.reverseCurve2d(curve.wrapped);
+    }
+    return curve;
+}
+//# sourceMappingURL=curves.js.map

package/dist/vendored/brepjs/2d/curves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curves.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/2d/curves.ts"],"names":[],"mappings":"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","sourcesContent":["import type { KernelType } from '../kernel/types.js';\nimport { getKernel } from '../kernel/index.js';\nimport type { Plane } from '../core/planeTypes.js';\nimport type { Face, Edge } from '../core/shapeTypes.js';\nimport { createEdge } from '../core/shapeTypes.js';\nimport { uvBounds, faceGeomType } from '../topology/faceFns.js';\nimport { getOrientation } from '../topology/curveFns.js';\nimport { type Result, ok, err } from '../core/result.js';\nimport { validationError } from '../core/errors.js';\nimport type { Point2D } from './lib/index.js';\nimport { BoundingBox2d, Curve2D } from './lib/index.js';\n\n/** Compute the 2D bounding box enclosing all given curves. */\nexport const curvesBoundingBox = (curves: Curve2D[]): BoundingBox2d => {\n  const kernel = getKernel();\n  const boundBox = kernel.createBoundingBox2d();\n  curves.forEach((c: Curve2D) => {\n    kernel.addCurveToBBox2d(boundBox, c.wrapped, 1e-6);\n  });\n  return new BoundingBox2d(boundBox);\n};\n\n/** Convert 2D curves to 3D edges by projecting them onto a plane. */\nexport function curvesAsEdgesOnPlane(curves: Curve2D[], plane: Plane): Edge[] {\n  const kernel = getKernel();\n  return curves.map((curve: Curve2D) =>\n    createEdge(\n      kernel.liftCurve2dToPlane(curve.wrapped, [...plane.origin], [...plane.zDir], [...plane.xDir])\n    )\n  );\n}\n\n/** Convert 2D curves to 3D edges by mapping them onto a parametric surface. */\nexport const curvesAsEdgesOnSurface = (curves: Curve2D[], geomSurf: KernelType): Edge[] => {\n  const kernel = getKernel();\n  return curves.map((curve: Curve2D) =>\n    createEdge(kernel.buildEdgeOnSurface(curve.wrapped, geomSurf))\n  );\n};\n\n/** Apply an opaque gp_GTrsf2d transformation to an array of 2D curves. */\nexport const transformCurves = (\n  curves: Curve2D[],\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents -- KernelType is any but null is a valid sentinel\n  transformation: KernelType | null\n): Curve2D[] => {\n  const kernel = getKernel();\n  return curves.map((curve: Curve2D) => {\n    if (!transformation) return curve.clone();\n    return new Curve2D(kernel.transformCurve2dGeneral(curve.wrapped, transformation));\n  });\n};\n\n/**\n * Raw kernel `gp_GTrsf2d` handle.\n * Callers are responsible for lifetime management.\n */\nexport type Transformation2D = KernelType;\n\n/** Create a 2D affinity (non-uniform scale) transformation along a direction. */\nexport const stretchTransform2d = (\n  ratio: number,\n  direction: Point2D,\n  origin: Point2D = [0, 0]\n): Transformation2D => {\n  // `createAffinityGTrsf2d` follows OCCT `gp_GTrsf2d::SetAffinity`: it scales the\n  // component perpendicular to its axis. To stretch *along* `direction`, pass the\n  // axis perpendicular to it (rotate 90°: (dx, dy) -> (-dy, dx)).\n  return getKernel().createAffinityGTrsf2d(\n    origin[0],\n    origin[1],\n    -direction[1],\n    direction[0],\n    ratio\n  );\n};\n\n/** Create a 2D translation transformation. */\nexport const translationTransform2d = (translation: Point2D): Transformation2D => {\n  return getKernel().createTranslationGTrsf2d(translation[0], translation[1]);\n};\n\n/**\n * Create a 2D mirror transformation.\n *\n * @param mode - `'center'` mirrors around a point; `'axis'` mirrors across a line.\n */\nexport const mirrorTransform2d = (\n  centerOrDirection: Point2D,\n  origin: Point2D = [0, 0],\n  mode = 'center'\n): Transformation2D => {\n  if (mode === 'center') {\n    return getKernel().createMirrorGTrsf2d(centerOrDirection[0], centerOrDirection[1], 'point');\n  }\n  return getKernel().createMirrorGTrsf2d(\n    0,\n    0,\n    'axis',\n    origin[0],\n    origin[1],\n    centerOrDirection[0],\n    centerOrDirection[1]\n  );\n};\n\n/** Create a 2D rotation transformation around a center point (angle in radians). */\nexport const rotateTransform2d = (angle: number, center: Point2D = [0, 0]): Transformation2D => {\n  return getKernel().createRotationGTrsf2d(angle, center[0], center[1]);\n};\n\n/** Create a 2D uniform scale transformation around a center point. */\nexport const scaleTransform2d = (\n  scaleFactor: number,\n  center: Point2D = [0, 0]\n): Transformation2D => {\n  return getKernel().createScaleGTrsf2d(scaleFactor, center[0], center[1]);\n};\n\n/** How to map 2D sketch coordinates onto a face's parametric UV space. */\nexport type ScaleMode = 'original' | 'bounds' | 'native';\n\n/**\n * Convert 2D curves to 3D edges on a face's surface, applying UV scaling.\n *\n * @param scale - How to map 2D coordinates to the face's parametric space.\n * @returns `Err` if the face type is unsupported for the chosen scale mode.\n */\nexport function curvesAsEdgesOnFace(\n  curves: Curve2D[],\n  face: Face,\n  scale: ScaleMode = 'original'\n): Result<Edge[]> {\n  const kernel = getKernel();\n  let geomSurf = kernel.extractSurfaceFromFace(face.wrapped);\n\n  const bounds = uvBounds(face);\n\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents -- KernelType is any but null is a valid sentinel\n  let transformation: KernelType | null = null;\n\n  if (scale === 'original' && faceGeomType(face) !== 'PLANE') {\n    if (faceGeomType(face) !== 'CYLINDRE')\n      return err(\n        validationError(\n          'UNSUPPORTED_FACE_TYPE',\n          'Only planar and cylindrical faces can be unwrapped for sketching'\n        )\n      );\n\n    const cylData = kernel.getSurfaceCylinderData(geomSurf);\n    if (!cylData) {\n      return err(\n        validationError(\n          'UNSUPPORTED_FACE_TYPE',\n          'Could not extract cylinder data from face surface'\n        )\n      );\n    }\n    if (!cylData.isDirect) {\n      geomSurf = kernel.reverseSurfaceU(geomSurf);\n    }\n    // Scale the u (circumferential, X) coordinate from arc length to angle.\n    transformation = stretchTransform2d(1 / cylData.radius, [1, 0]);\n  }\n\n  if (scale === 'bounds') {\n    transformation = kernel.createIdentityGTrsf2d();\n    try {\n      kernel.setGTrsf2dTranslationPart(transformation, 0, 0); // ensure identity state\n\n      // Apply u-axis affinity\n      const uAffinity = kernel.createAffinityGTrsf2d(0, 0, 0, 1, bounds.uMax - bounds.uMin);\n      kernel.multiplyGTrsf2d(transformation, uAffinity);\n      uAffinity.delete();\n\n      if (bounds.uMin !== 0) {\n        const trans = kernel.createIdentityGTrsf2d();\n        kernel.setGTrsf2dTranslationPart(trans, -bounds.uMin, 0);\n        kernel.multiplyGTrsf2d(transformation, trans);\n        trans.delete();\n      }\n\n      // Apply v-axis affinity\n      const vAffinity = kernel.createAffinityGTrsf2d(0, 0, 1, 0, bounds.vMax - bounds.vMin);\n      kernel.multiplyGTrsf2d(transformation, vAffinity);\n      vAffinity.delete();\n\n      if (bounds.vMin !== 0) {\n        const trans = kernel.createIdentityGTrsf2d();\n        kernel.setGTrsf2dTranslationPart(trans, 0, -bounds.vMin);\n        kernel.multiplyGTrsf2d(transformation, trans);\n        trans.delete();\n      }\n    } catch (e) {\n      transformation.delete();\n      throw e;\n    }\n  }\n\n  const modifiedCurves = transformCurves(curves, transformation);\n  const edges = curvesAsEdgesOnSurface(modifiedCurves, geomSurf);\n\n  if (transformation) transformation.delete();\n\n  return ok(edges);\n}\n\n/** Extract the 2D parametric curve of an edge on a face's surface. */\nexport function edgeToCurve(e: Edge, face: Face): Curve2D {\n  const kernel = getKernel();\n  const handle = kernel.extractCurve2dFromEdge(e.wrapped, face.wrapped);\n  const curve = new Curve2D(handle);\n  if (getOrientation(e) === 'backward') {\n    kernel.reverseCurve2d(curve.wrapped);\n  }\n  return curve;\n}\n"]}

package/dist/vendored/brepjs/2d/lib/approximations.d.ts

@@ -0,0 +1,47 @@
+import { Curve2D } from './curve2D.js';
+/**
+ * Approximate a 2D curve as a B-spline via the kernel's
+ * `approximateCurve2dAsBSpline` method.
+ *
+ * @param curve - The source `Curve2D` to approximate.
+ * @param tolerance - Maximum deviation from the original curve.
+ * @param continuity - Required geometric continuity of the result.
+ * @param maxSegments - Maximum number of B-spline spans.
+ *
+ * @example
+ * ```ts
+ * const bspline = approximateAsBSpline(curve, 1e-4, 'C1');
+ * ```
+ */
+export declare const approximateAsBSpline: (curve: Curve2D, tolerance?: number, continuity?: "C0" | "C1" | "C2" | "C3", maxSegments?: number) => Curve2D;
+/**
+ * Decompose a B-spline curve into an array of Bezier arcs.
+ *
+ * @param curve - A `Curve2D` whose type must be `BSPLINE_CURVE`.
+ * @returns An array of Bezier `Curve2D` segments covering the original B-spline.
+ */
+export declare const BSplineToBezier: (curve: Curve2D) => Curve2D[];
+/** Options for SVG-compatible curve approximation. */
+export interface ApproximationOptions {
+    /** Maximum deviation from the original curve. */
+    tolerance?: number;
+    /** Required geometric continuity. */
+    continuity?: 'C0' | 'C1' | 'C2' | 'C3';
+    /** Maximum number of B-spline spans. */
+    maxSegments?: number;
+}
+/**
+ * Convert an array of curves to SVG-compatible primitives (lines, arcs, and
+ * degree-1/2/3 Bezier curves).
+ *
+ * Higher-degree B-splines are decomposed into Bezier arcs and recursively
+ * processed. Full circles/ellipses are split at the midpoint so they can be
+ * represented as two SVG arcs.
+ *
+ * @example
+ * ```ts
+ * const svgCurves = approximateAsSvgCompatibleCurve(curves, { tolerance: 1e-5 });
+ * ```
+ */
+export declare function approximateAsSvgCompatibleCurve(curves: Curve2D[], options?: ApproximationOptions): Curve2D[];
+//# sourceMappingURL=approximations.d.ts.map

package/dist/vendored/brepjs/2d/lib/approximations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approximations.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/lib/approximations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,OAAO,EACd,kBAAgB,EAChB,aAAY,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAW,EAC5C,oBAAiB,KAChB,OASF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,OAAO,EAMvD,CAAC;AAEF,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACvC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,GAAE,oBAIR,GACA,OAAO,EAAE,CAyCX"}