brepkit-wasm 2.88.1 → 2.89.0

package/brepkit_wasm.d.ts

@@ -1121,6 +1121,28 @@ export class BrepKernel {
      * non-positive, or the normal vector is zero.
      */
     makeCircleEdge(cx: number, cy: number, cz: number, nx: number, ny: number, nz: number, radius: number): number;
+    /**
+     * Create a closed circular edge with a caller-supplied reference x-direction.
+     *
+     * Like [`makeCircleEdge`](Self::make_circle_edge), but `ref_dir = (rx, ry, rz)`
+     * is projected onto the plane perpendicular to the normal to fix the
+     * circle's `u_axis` — which controls the seam vertex position at
+     * `circle.evaluate(0.0)`. Use when downstream code (PCurve computation,
+     * extrusion frame) depends on a specific seam placement.
+     *
+     * `ref_dir` must be non-zero (rejected at this boundary) and ideally
+     * not parallel to the normal — `Frame3::from_normal_and_ref` falls
+     * back to an arbitrary perpendicular when the projection of `ref_dir`
+     * onto the plane is degenerate, defeating the purpose of this call.
+     *
+     * Returns an edge handle (`u32`).
+     *
+     * # Errors
+     *
+     * Returns an error if any coordinate is NaN/infinite, `radius` is
+     * non-positive, or the normal vector or `ref_dir` is zero.
+     */
+    makeCircleEdgeWithRef(cx: number, cy: number, cz: number, nx: number, ny: number, nz: number, radius: number, rx: number, ry: number, rz: number): number;
     /**
      * Create a circular face on the XY plane (using NURBS arcs).
      *
@@ -1169,6 +1191,31 @@ export class BrepKernel {
      * the normal vector is zero.
      */
     makeEllipseEdge(cx: number, cy: number, cz: number, nx: number, ny: number, nz: number, semi_major: number, semi_minor: number): number;
+    /**
+     * Create a closed elliptical edge with a caller-supplied reference major-axis.
+     *
+     * Like [`makeEllipseEdge`](Self::make_ellipse_edge), but `ref_dir = (rx, ry, rz)`
+     * is projected onto the plane perpendicular to the normal to fix the
+     * ellipse's major-axis direction (`u_axis`, carrying `semi_major`).
+     * Use this when the caller has an intended major-axis orientation —
+     * otherwise the default-frame variant chooses an arbitrary
+     * perpendicular, which can cause adapters to fall back to NURBS
+     * approximations to preserve their requested orientation.
+     *
+     * `ref_dir` must be non-zero (rejected at this boundary) and ideally
+     * not parallel to the normal — `Frame3::from_normal_and_ref` falls
+     * back to an arbitrary perpendicular when the projection of `ref_dir`
+     * onto the plane is degenerate, defeating the purpose of this call.
+     *
+     * Returns an edge handle (`u32`).
+     *
+     * # Errors
+     *
+     * Returns an error if any coordinate is NaN/infinite, either
+     * semi-axis is non-positive, `semi_minor` exceeds `semi_major`, or
+     * the normal vector or `ref_dir` is zero.
+     */
+    makeEllipseEdgeWithRef(cx: number, cy: number, cz: number, nx: number, ny: number, nz: number, semi_major: number, semi_minor: number, rx: number, ry: number, rz: number): number;
     /**
      * Create an ellipsoid solid centered at the origin.
      *

package/brepkit_wasm_bg.js

@@ -2471,6 +2471,45 @@ export class BrepKernel {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Create a closed circular edge with a caller-supplied reference x-direction.
+     *
+     * Like [`makeCircleEdge`](Self::make_circle_edge), but `ref_dir = (rx, ry, rz)`
+     * is projected onto the plane perpendicular to the normal to fix the
+     * circle's `u_axis` — which controls the seam vertex position at
+     * `circle.evaluate(0.0)`. Use when downstream code (PCurve computation,
+     * extrusion frame) depends on a specific seam placement.
+     *
+     * `ref_dir` must be non-zero (rejected at this boundary) and ideally
+     * not parallel to the normal — `Frame3::from_normal_and_ref` falls
+     * back to an arbitrary perpendicular when the projection of `ref_dir`
+     * onto the plane is degenerate, defeating the purpose of this call.
+     *
+     * Returns an edge handle (`u32`).
+     *
+     * # Errors
+     *
+     * Returns an error if any coordinate is NaN/infinite, `radius` is
+     * non-positive, or the normal vector or `ref_dir` is zero.
+     * @param {number} cx
+     * @param {number} cy
+     * @param {number} cz
+     * @param {number} nx
+     * @param {number} ny
+     * @param {number} nz
+     * @param {number} radius
+     * @param {number} rx
+     * @param {number} ry
+     * @param {number} rz
+     * @returns {number}
+     */
+    makeCircleEdgeWithRef(cx, cy, cz, nx, ny, nz, radius, rx, ry, rz) {
+        const ret = wasm.brepkernel_makeCircleEdgeWithRef(this.__wbg_ptr, cx, cy, cz, nx, ny, nz, radius, rx, ry, rz);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * Create a circular face on the XY plane (using NURBS arcs).
      *
@@ -2572,6 +2611,49 @@ export class BrepKernel {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Create a closed elliptical edge with a caller-supplied reference major-axis.
+     *
+     * Like [`makeEllipseEdge`](Self::make_ellipse_edge), but `ref_dir = (rx, ry, rz)`
+     * is projected onto the plane perpendicular to the normal to fix the
+     * ellipse's major-axis direction (`u_axis`, carrying `semi_major`).
+     * Use this when the caller has an intended major-axis orientation —
+     * otherwise the default-frame variant chooses an arbitrary
+     * perpendicular, which can cause adapters to fall back to NURBS
+     * approximations to preserve their requested orientation.
+     *
+     * `ref_dir` must be non-zero (rejected at this boundary) and ideally
+     * not parallel to the normal — `Frame3::from_normal_and_ref` falls
+     * back to an arbitrary perpendicular when the projection of `ref_dir`
+     * onto the plane is degenerate, defeating the purpose of this call.
+     *
+     * Returns an edge handle (`u32`).
+     *
+     * # Errors
+     *
+     * Returns an error if any coordinate is NaN/infinite, either
+     * semi-axis is non-positive, `semi_minor` exceeds `semi_major`, or
+     * the normal vector or `ref_dir` is zero.
+     * @param {number} cx
+     * @param {number} cy
+     * @param {number} cz
+     * @param {number} nx
+     * @param {number} ny
+     * @param {number} nz
+     * @param {number} semi_major
+     * @param {number} semi_minor
+     * @param {number} rx
+     * @param {number} ry
+     * @param {number} rz
+     * @returns {number}
+     */
+    makeEllipseEdgeWithRef(cx, cy, cz, nx, ny, nz, semi_major, semi_minor, rx, ry, rz) {
+        const ret = wasm.brepkernel_makeEllipseEdgeWithRef(this.__wbg_ptr, cx, cy, cz, nx, ny, nz, semi_major, semi_minor, rx, ry, rz);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * Create an ellipsoid solid centered at the origin.
      *

package/brepkit_wasm_node.cjs

@@ -2473,6 +2473,45 @@ class BrepKernel {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Create a closed circular edge with a caller-supplied reference x-direction.
+     *
+     * Like [`makeCircleEdge`](Self::make_circle_edge), but `ref_dir = (rx, ry, rz)`
+     * is projected onto the plane perpendicular to the normal to fix the
+     * circle's `u_axis` — which controls the seam vertex position at
+     * `circle.evaluate(0.0)`. Use when downstream code (PCurve computation,
+     * extrusion frame) depends on a specific seam placement.
+     *
+     * `ref_dir` must be non-zero (rejected at this boundary) and ideally
+     * not parallel to the normal — `Frame3::from_normal_and_ref` falls
+     * back to an arbitrary perpendicular when the projection of `ref_dir`
+     * onto the plane is degenerate, defeating the purpose of this call.
+     *
+     * Returns an edge handle (`u32`).
+     *
+     * # Errors
+     *
+     * Returns an error if any coordinate is NaN/infinite, `radius` is
+     * non-positive, or the normal vector or `ref_dir` is zero.
+     * @param {number} cx
+     * @param {number} cy
+     * @param {number} cz
+     * @param {number} nx
+     * @param {number} ny
+     * @param {number} nz
+     * @param {number} radius
+     * @param {number} rx
+     * @param {number} ry
+     * @param {number} rz
+     * @returns {number}
+     */
+    makeCircleEdgeWithRef(cx, cy, cz, nx, ny, nz, radius, rx, ry, rz) {
+        const ret = wasm.brepkernel_makeCircleEdgeWithRef(this.__wbg_ptr, cx, cy, cz, nx, ny, nz, radius, rx, ry, rz);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * Create a circular face on the XY plane (using NURBS arcs).
      *
@@ -2574,6 +2613,49 @@ class BrepKernel {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * Create a closed elliptical edge with a caller-supplied reference major-axis.
+     *
+     * Like [`makeEllipseEdge`](Self::make_ellipse_edge), but `ref_dir = (rx, ry, rz)`
+     * is projected onto the plane perpendicular to the normal to fix the
+     * ellipse's major-axis direction (`u_axis`, carrying `semi_major`).
+     * Use this when the caller has an intended major-axis orientation —
+     * otherwise the default-frame variant chooses an arbitrary
+     * perpendicular, which can cause adapters to fall back to NURBS
+     * approximations to preserve their requested orientation.
+     *
+     * `ref_dir` must be non-zero (rejected at this boundary) and ideally
+     * not parallel to the normal — `Frame3::from_normal_and_ref` falls
+     * back to an arbitrary perpendicular when the projection of `ref_dir`
+     * onto the plane is degenerate, defeating the purpose of this call.
+     *
+     * Returns an edge handle (`u32`).
+     *
+     * # Errors
+     *
+     * Returns an error if any coordinate is NaN/infinite, either
+     * semi-axis is non-positive, `semi_minor` exceeds `semi_major`, or
+     * the normal vector or `ref_dir` is zero.
+     * @param {number} cx
+     * @param {number} cy
+     * @param {number} cz
+     * @param {number} nx
+     * @param {number} ny
+     * @param {number} nz
+     * @param {number} semi_major
+     * @param {number} semi_minor
+     * @param {number} rx
+     * @param {number} ry
+     * @param {number} rz
+     * @returns {number}
+     */
+    makeEllipseEdgeWithRef(cx, cy, cz, nx, ny, nz, semi_major, semi_minor, rx, ry, rz) {
+        const ret = wasm.brepkernel_makeEllipseEdgeWithRef(this.__wbg_ptr, cx, cy, cz, nx, ny, nz, semi_major, semi_minor, rx, ry, rz);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * Create an ellipsoid solid centered at the origin.
      *

package/package.json

@@ -2,7 +2,7 @@
   "name": "brepkit-wasm",
   "type": "module",
   "description": "WebAssembly bindings for brepkit — browser-native B-Rep solid modeling",
-  "version": "2.88.1",
+  "version": "2.89.0",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",