okgeometry-api 0.2.11 → 0.2.13

package/dist/Arc.d.ts

@@ -2,20 +2,70 @@ import { Point } from "./Point.js";
 import { Vec3 } from "./Vec3.js";
 import { Polyline } from "./Polyline.js";
 import type { Plane } from "./Plane.js";
+import type { RotationAxis } from "./types.js";
+/**
+ * Immutable circular arc defined by center, radius, and angular span.
+ * Angles are in radians, measured counter-clockwise from the positive X axis
+ * in the plane defined by the normal.
+ */
 export declare class Arc {
     readonly center: Point;
     readonly radius: number;
     readonly startAngle: number;
     readonly endAngle: number;
     readonly normal: Vec3;
+    /**
+     * Create a new arc.
+     * @param center - Center point
+     * @param radius - Arc radius
+     * @param startAngle - Start angle in radians
+     * @param endAngle - End angle in radians
+     * @param normal - Normal vector defining the arc's plane (default Z axis)
+     */
     constructor(center: Point, radius: number, startAngle: number, endAngle: number, normal?: Vec3);
+    /**
+     * Evaluate a point on the arc at normalized parameter t.
+     * @param t - Parameter in [0, 1] (0 = start angle, 1 = end angle)
+     * @returns Point on arc at parameter t
+     */
     pointAt(t: number): Point;
+    /**
+     * Get the arc length.
+     * @returns Arc length = radius * angular span
+     */
     length(): number;
+    /**
+     * Translate this arc by an offset vector.
+     * @param offset - Translation vector
+     * @returns New translated arc
+     */
     translate(offset: Vec3): Arc;
-    rotate(axis: Vec3 | import("./Line.js").Line, angle: number): Arc;
+    /**
+     * Rotate this arc around an axis.
+     * @param axis - Rotation axis (Vec3 through origin, or Line for arbitrary axis)
+     * @param angle - Rotation angle in radians
+     * @returns New rotated arc
+     */
+    rotate(axis: RotationAxis, angle: number): Arc;
+    /**
+     * Offset this arc by changing its radius.
+     * @param distance - Distance to offset (positive = larger, negative = smaller)
+     * @returns New arc with adjusted radius
+     */
     offset(distance: number): Arc;
-    /** Project onto plane. Returns a Polyline because a tilted arc projects to an elliptical arc. */
+    /**
+     * Project onto plane. Returns a Polyline because a tilted arc projects to an elliptical arc.
+     * @param plane - Target plane
+     * @param direction - Optional projection direction (default: perpendicular to plane)
+     * @param samples - Number of sample points for approximation (default 64)
+     * @returns Polyline approximating the projected arc
+     */
     projectOntoPlane(plane: Plane, direction?: Vec3, samples?: number): Polyline;
+    /**
+     * Sample the arc into evenly-spaced points.
+     * @param n - Number of points to generate
+     * @returns Array of n points along the arc
+     */
     sample(n: number): Point[];
 }
 //# sourceMappingURL=Arc.d.ts.map

package/dist/Arc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Arc.d.ts","sourceRoot":"","sources":["../src/Arc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,qBAAa,GAAG;aAEI,MAAM,EAAE,KAAK;aACb,MAAM,EAAE,MAAM;aACd,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,IAAI;gBAJZ,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,IAAa;IAGvC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK;IAUzB,MAAM,IAAI,MAAM;IAKhB,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,GAAG;IAI5B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG;IAOjE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAI7B,iGAAiG;IACjG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,QAAQ;IAMxE,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE;CAa3B"}
+{"version":3,"file":"Arc.d.ts","sourceRoot":"","sources":["../src/Arc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;GAIG;AACH,qBAAa,GAAG;aAUI,MAAM,EAAE,KAAK;aACb,MAAM,EAAE,MAAM;aACd,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,IAAI;IAb9B;;;;;;;OAOG;gBAEe,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,IAAa;IAGvC;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK;IAUzB;;;OAGG;IACH,MAAM,IAAI,MAAM;IAKhB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,GAAG;IAI5B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG;IAO9C;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAI7B;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,QAAQ;IAMxE;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE;CAa3B"}

package/dist/Arc.js

@@ -3,7 +3,20 @@ import { Point } from "./Point.js";
 import { Vec3 } from "./Vec3.js";
 import { Polyline } from "./Polyline.js";
 import * as wasm from "../wasm/okgeometrycore_bg.js";
+/**
+ * Immutable circular arc defined by center, radius, and angular span.
+ * Angles are in radians, measured counter-clockwise from the positive X axis
+ * in the plane defined by the normal.
+ */
 export class Arc {
+    /**
+     * Create a new arc.
+     * @param center - Center point
+     * @param radius - Arc radius
+     * @param startAngle - Start angle in radians
+     * @param endAngle - End angle in radians
+     * @param normal - Normal vector defining the arc's plane (default Z axis)
+     */
     constructor(center, radius, startAngle, endAngle, normal = Vec3.Z) {
         this.center = center;
         this.radius = radius;
@@ -11,33 +24,69 @@ export class Arc {
         this.endAngle = endAngle;
         this.normal = normal;
     }
+    /**
+     * Evaluate a point on the arc at normalized parameter t.
+     * @param t - Parameter in [0, 1] (0 = start angle, 1 = end angle)
+     * @returns Point on arc at parameter t
+     */
     pointAt(t) {
         ensureInit();
         const r = wasm.arc_point_at(this.center.x, this.center.y, this.center.z, this.normal.x, this.normal.y, this.normal.z, this.radius, this.startAngle, this.endAngle, t);
         return new Point(r[0], r[1], r[2]);
     }
+    /**
+     * Get the arc length.
+     * @returns Arc length = radius * angular span
+     */
     length() {
         ensureInit();
         return wasm.arc_length(this.radius, this.startAngle, this.endAngle);
     }
+    /**
+     * Translate this arc by an offset vector.
+     * @param offset - Translation vector
+     * @returns New translated arc
+     */
     translate(offset) {
         return new Arc(this.center.add(offset), this.radius, this.startAngle, this.endAngle, this.normal);
     }
+    /**
+     * Rotate this arc around an axis.
+     * @param axis - Rotation axis (Vec3 through origin, or Line for arbitrary axis)
+     * @param angle - Rotation angle in radians
+     * @returns New rotated arc
+     */
     rotate(axis, angle) {
         const n = this.normal;
         const dirAxis = 'start' in axis ? new Vec3(axis.end.x - axis.start.x, axis.end.y - axis.start.y, axis.end.z - axis.start.z) : axis;
         const rn = new Point(n.x, n.y, n.z).rotate(dirAxis, angle);
         return new Arc(this.center.rotate(axis, angle), this.radius, this.startAngle, this.endAngle, new Vec3(rn.x, rn.y, rn.z));
     }
+    /**
+     * Offset this arc by changing its radius.
+     * @param distance - Distance to offset (positive = larger, negative = smaller)
+     * @returns New arc with adjusted radius
+     */
     offset(distance) {
         return new Arc(this.center, this.radius + distance, this.startAngle, this.endAngle, this.normal);
     }
-    /** Project onto plane. Returns a Polyline because a tilted arc projects to an elliptical arc. */
+    /**
+     * Project onto plane. Returns a Polyline because a tilted arc projects to an elliptical arc.
+     * @param plane - Target plane
+     * @param direction - Optional projection direction (default: perpendicular to plane)
+     * @param samples - Number of sample points for approximation (default 64)
+     * @returns Polyline approximating the projected arc
+     */
     projectOntoPlane(plane, direction, samples = 64) {
         const pts = this.sample(samples);
         const proj = (p) => direction ? plane.projectPointAlongDirection(p, direction) : plane.projectPoint(p);
         return new Polyline(pts.map(proj));
     }
+    /**
+     * Sample the arc into evenly-spaced points.
+     * @param n - Number of points to generate
+     * @returns Array of n points along the arc
+     */
     sample(n) {
         ensureInit();
         const buf = wasm.create_arc(this.center.x, this.center.y, this.center.z, this.normal.x, this.normal.y, this.normal.z, this.radius, this.startAngle, this.endAngle, n);

package/dist/Arc.js.map

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

package/dist/BufferCodec.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Buffer encoding/decoding utilities for WASM communication.
+ *
+ * # WASM Buffer Formats
+ *
+ * ## Mesh Buffer
+ * `[vertexCount, x1,y1,z1, ..., i1,i2,i3, ...]`
+ * - Element 0: Number of vertices
+ * - Elements 1 to vertexCount*3: Vertex coordinates (xyz triplets)
+ * - Remaining elements: Triangle indices (groups of 3)
+ *
+ * ## Polyline Buffer (multi-polyline result)
+ * `[numPolylines, count1, x,y,z,..., count2, x,y,z,...]`
+ * - Element 0: Number of polylines
+ * - For each polyline: point count followed by xyz coordinates
+ *
+ * ## Intersection Points Buffer
+ * `[numPoints, x1,y1,z1, x2,y2,z2, ...]`
+ * - Element 0: Number of intersection points
+ * - Remaining: xyz triplets for each point
+ *
+ * ## Curve Encoding (for sweep/loft)
+ * See CurveTypeCode enum in types.ts for format details.
+ *
+ * ## NURBS Curve Data
+ * `[degree, numControlPoints, x1,y1,z1,..., w1,w2,..., k1,k2,...]`
+ *
+ * ## NURBS Surface Data
+ * `[degU, degV, numU, numV, cp_xyz..., weights..., knotsU..., knotsV...]`
+ *
+ * @module BufferCodec
+ */
+import { Point } from "./Point.js";
+import { Vec3 } from "./Vec3.js";
+/**
+ * Convert array of Points to flat coordinate buffer.
+ * @param points - Array of Point objects
+ * @returns Float64Array with interleaved [x1,y1,z1, x2,y2,z2, ...]
+ *
+ * @example
+ * ```typescript
+ * const pts = [new Point(0,0,0), new Point(1,2,3)];
+ * const coords = pointsToCoords(pts);
+ * // coords = Float64Array [0, 0, 0, 1, 2, 3]
+ * ```
+ */
+export declare function pointsToCoords(points: Point[]): Float64Array;
+/**
+ * Convert flat coordinate buffer to array of Points.
+ * @param coords - Float64Array with interleaved xyz coordinates
+ * @returns Array of Point objects
+ *
+ * @example
+ * ```typescript
+ * const coords = new Float64Array([0, 0, 0, 1, 2, 3]);
+ * const pts = coordsToPoints(coords);
+ * // pts = [Point(0,0,0), Point(1,2,3)]
+ * ```
+ */
+export declare function coordsToPoints(coords: Float64Array | number[]): Point[];
+/**
+ * Read a single Point from buffer at specified offset.
+ * @param buf - Source buffer
+ * @param offset - Starting index in buffer
+ * @returns Tuple of [Point, newOffset] where newOffset = offset + 3
+ */
+export declare function readPoint(buf: Float64Array, offset: number): [Point, number];
+/**
+ * Read a single Vec3 from buffer at specified offset.
+ * @param buf - Source buffer
+ * @param offset - Starting index in buffer
+ * @returns Tuple of [Vec3, newOffset] where newOffset = offset + 3
+ */
+export declare function readVec3(buf: Float64Array, offset: number): [Vec3, number];
+/**
+ * Decode WASM result buffer as single Point.
+ * Common pattern for pointAt(), closestPoint() results.
+ * @param r - WASM result array (must have at least 3 elements)
+ * @returns Point from first 3 elements
+ */
+export declare function decodePointResult(r: Float64Array): Point;
+/**
+ * Decode WASM result buffer as single Vec3.
+ * Common pattern for tangent(), normal() results.
+ * @param r - WASM result array (must have at least 3 elements)
+ * @returns Vec3 from first 3 elements
+ */
+export declare function decodeVec3Result(r: Float64Array): Vec3;
+/**
+ * Parse WASM multi-polyline buffer into array of point arrays.
+ * Used by mesh intersection operations that return multiple polylines.
+ *
+ * Buffer format: [numPolylines, count1, x,y,z,..., count2, x,y,z,...]
+ *
+ * @param buf - WASM result buffer
+ * @returns Array of Point arrays, one per polyline
+ *
+ * @example
+ * ```typescript
+ * // Buffer: [2, 3, 0,0,0, 1,0,0, 1,1,0, 2, 5,5,5, 6,6,6]
+ * // = 2 polylines: first has 3 points, second has 2 points
+ * const polylines = parsePolylineBuffer(buf);
+ * // polylines[0] = [Point(0,0,0), Point(1,0,0), Point(1,1,0)]
+ * // polylines[1] = [Point(5,5,5), Point(6,6,6)]
+ * ```
+ */
+export declare function parsePolylineBuffer(buf: Float64Array): Point[][];
+/**
+ * Parse WASM intersection points buffer.
+ * Used by curve-curve and curve-plane intersection operations.
+ *
+ * Buffer format: [numPoints, x1,y1,z1, x2,y2,z2, ...]
+ *
+ * @param buf - WASM result buffer
+ * @returns Array of intersection Points
+ */
+export declare function parseIntersectionPoints(buf: Float64Array): Point[];
+//# sourceMappingURL=BufferCodec.d.ts.map

package/dist/BufferCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BufferCodec.d.ts","sourceRoot":"","sources":["../src/BufferCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAQ5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,KAAK,EAAE,CAOvE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAE1E;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,KAAK,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAEtD;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,EAAE,EAAE,CAehE;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,EAAE,CASlE"}

package/dist/BufferCodec.js

@@ -0,0 +1,171 @@
+/**
+ * Buffer encoding/decoding utilities for WASM communication.
+ *
+ * # WASM Buffer Formats
+ *
+ * ## Mesh Buffer
+ * `[vertexCount, x1,y1,z1, ..., i1,i2,i3, ...]`
+ * - Element 0: Number of vertices
+ * - Elements 1 to vertexCount*3: Vertex coordinates (xyz triplets)
+ * - Remaining elements: Triangle indices (groups of 3)
+ *
+ * ## Polyline Buffer (multi-polyline result)
+ * `[numPolylines, count1, x,y,z,..., count2, x,y,z,...]`
+ * - Element 0: Number of polylines
+ * - For each polyline: point count followed by xyz coordinates
+ *
+ * ## Intersection Points Buffer
+ * `[numPoints, x1,y1,z1, x2,y2,z2, ...]`
+ * - Element 0: Number of intersection points
+ * - Remaining: xyz triplets for each point
+ *
+ * ## Curve Encoding (for sweep/loft)
+ * See CurveTypeCode enum in types.ts for format details.
+ *
+ * ## NURBS Curve Data
+ * `[degree, numControlPoints, x1,y1,z1,..., w1,w2,..., k1,k2,...]`
+ *
+ * ## NURBS Surface Data
+ * `[degU, degV, numU, numV, cp_xyz..., weights..., knotsU..., knotsV...]`
+ *
+ * @module BufferCodec
+ */
+import { Point } from "./Point.js";
+import { Vec3 } from "./Vec3.js";
+// ── Point Array Conversion ─────────────────────────────────────────
+/**
+ * Convert array of Points to flat coordinate buffer.
+ * @param points - Array of Point objects
+ * @returns Float64Array with interleaved [x1,y1,z1, x2,y2,z2, ...]
+ *
+ * @example
+ * ```typescript
+ * const pts = [new Point(0,0,0), new Point(1,2,3)];
+ * const coords = pointsToCoords(pts);
+ * // coords = Float64Array [0, 0, 0, 1, 2, 3]
+ * ```
+ */
+export function pointsToCoords(points) {
+    const coords = new Float64Array(points.length * 3);
+    for (let i = 0; i < points.length; i++) {
+        coords[i * 3] = points[i].x;
+        coords[i * 3 + 1] = points[i].y;
+        coords[i * 3 + 2] = points[i].z;
+    }
+    return coords;
+}
+/**
+ * Convert flat coordinate buffer to array of Points.
+ * @param coords - Float64Array with interleaved xyz coordinates
+ * @returns Array of Point objects
+ *
+ * @example
+ * ```typescript
+ * const coords = new Float64Array([0, 0, 0, 1, 2, 3]);
+ * const pts = coordsToPoints(coords);
+ * // pts = [Point(0,0,0), Point(1,2,3)]
+ * ```
+ */
+export function coordsToPoints(coords) {
+    const data = coords instanceof Float64Array ? coords : new Float64Array(coords);
+    const pts = [];
+    for (let i = 0; i < data.length; i += 3) {
+        pts.push(new Point(data[i], data[i + 1], data[i + 2]));
+    }
+    return pts;
+}
+/**
+ * Read a single Point from buffer at specified offset.
+ * @param buf - Source buffer
+ * @param offset - Starting index in buffer
+ * @returns Tuple of [Point, newOffset] where newOffset = offset + 3
+ */
+export function readPoint(buf, offset) {
+    return [new Point(buf[offset], buf[offset + 1], buf[offset + 2]), offset + 3];
+}
+/**
+ * Read a single Vec3 from buffer at specified offset.
+ * @param buf - Source buffer
+ * @param offset - Starting index in buffer
+ * @returns Tuple of [Vec3, newOffset] where newOffset = offset + 3
+ */
+export function readVec3(buf, offset) {
+    return [new Vec3(buf[offset], buf[offset + 1], buf[offset + 2]), offset + 3];
+}
+// ── WASM Result Decoding ───────────────────────────────────────────
+/**
+ * Decode WASM result buffer as single Point.
+ * Common pattern for pointAt(), closestPoint() results.
+ * @param r - WASM result array (must have at least 3 elements)
+ * @returns Point from first 3 elements
+ */
+export function decodePointResult(r) {
+    return new Point(r[0], r[1], r[2]);
+}
+/**
+ * Decode WASM result buffer as single Vec3.
+ * Common pattern for tangent(), normal() results.
+ * @param r - WASM result array (must have at least 3 elements)
+ * @returns Vec3 from first 3 elements
+ */
+export function decodeVec3Result(r) {
+    return new Vec3(r[0], r[1], r[2]);
+}
+// ── Polyline Buffer Format ─────────────────────────────────────────
+/**
+ * Parse WASM multi-polyline buffer into array of point arrays.
+ * Used by mesh intersection operations that return multiple polylines.
+ *
+ * Buffer format: [numPolylines, count1, x,y,z,..., count2, x,y,z,...]
+ *
+ * @param buf - WASM result buffer
+ * @returns Array of Point arrays, one per polyline
+ *
+ * @example
+ * ```typescript
+ * // Buffer: [2, 3, 0,0,0, 1,0,0, 1,1,0, 2, 5,5,5, 6,6,6]
+ * // = 2 polylines: first has 3 points, second has 2 points
+ * const polylines = parsePolylineBuffer(buf);
+ * // polylines[0] = [Point(0,0,0), Point(1,0,0), Point(1,1,0)]
+ * // polylines[1] = [Point(5,5,5), Point(6,6,6)]
+ * ```
+ */
+export function parsePolylineBuffer(buf) {
+    if (buf.length === 0)
+        return [];
+    const numPolylines = buf[0];
+    const result = [];
+    let idx = 1;
+    for (let i = 0; i < numPolylines; i++) {
+        const count = buf[idx++];
+        const pts = [];
+        for (let j = 0; j < count; j++) {
+            pts.push(new Point(buf[idx], buf[idx + 1], buf[idx + 2]));
+            idx += 3;
+        }
+        result.push(pts);
+    }
+    return result;
+}
+// ── Intersection Result Format ─────────────────────────────────────
+/**
+ * Parse WASM intersection points buffer.
+ * Used by curve-curve and curve-plane intersection operations.
+ *
+ * Buffer format: [numPoints, x1,y1,z1, x2,y2,z2, ...]
+ *
+ * @param buf - WASM result buffer
+ * @returns Array of intersection Points
+ */
+export function parseIntersectionPoints(buf) {
+    if (buf.length === 0)
+        return [];
+    const numPts = buf[0];
+    const pts = [];
+    for (let i = 0; i < numPts; i++) {
+        const off = 1 + i * 3;
+        pts.push(new Point(buf[off], buf[off + 1], buf[off + 2]));
+    }
+    return pts;
+}
+//# sourceMappingURL=BufferCodec.js.map

package/dist/BufferCodec.js.map

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

package/dist/Circle.d.ts

@@ -2,20 +2,85 @@ import { Point } from "./Point.js";
 import { Vec3 } from "./Vec3.js";
 import { Mesh } from "./Mesh.js";
 import { Polygon } from "./Polygon.js";
-import type { Plane } from "./Plane.js";
+import { Plane } from "./Plane.js";
+import type { RotationAxis } from "./types.js";
+/**
+ * Immutable circle defined by center, radius, and normal.
+ * Supports evaluation, transformation, extrusion, and projection.
+ */
 export declare class Circle {
     readonly center: Point;
     readonly radius: number;
     readonly normal: Vec3;
-    constructor(center: Point, radius: number, normal?: Vec3);
+    readonly uAxis?: Vec3 | undefined;
+    /**
+     * Create a new circle.
+     * @param center - Center point
+     * @param radius - Circle radius
+     * @param normal - Normal vector defining the circle's plane (default Z axis)
+     * @param uAxis - Optional reference direction defining where t=0 starts.
+     *                Critical for sweep operations to maintain consistent profile orientation.
+     */
+    constructor(center: Point, radius: number, normal?: Vec3, uAxis?: Vec3 | undefined);
+    /**
+     * Create a Circle from a Plane, automatically using the plane's xAxis
+     * as the circle's uAxis for consistent orientation in sweep operations.
+     * @param plane - Plane defining circle's position and orientation
+     * @param radius - Circle radius
+     * @returns New Circle at plane origin with plane normal
+     */
+    static fromPlane(plane: Plane, radius: number): Circle;
+    /**
+     * Evaluate a point on the circle at normalized parameter t.
+     * @param t - Parameter in [0, 1] (0 and 1 are the same point for closed circle)
+     * @returns Point on circle at parameter t
+     */
     pointAt(t: number): Point;
+    /**
+     * Get the circumference of this circle.
+     * @returns 2 * PI * radius
+     */
     length(): number;
+    /**
+     * Sample the circle into evenly-spaced points.
+     * @param n - Number of points to generate
+     * @returns Array of n points around the circle
+     */
     sample(n: number): Point[];
+    /**
+     * Translate this circle by an offset vector.
+     * @param offset - Translation vector
+     * @returns New translated circle
+     */
     translate(offset: Vec3): Circle;
-    rotate(axis: Vec3 | import("./Line.js").Line, angle: number): Circle;
+    /**
+     * Rotate this circle around an axis.
+     * @param axis - Rotation axis (Vec3 through origin, or Line for arbitrary axis)
+     * @param angle - Rotation angle in radians
+     * @returns New rotated circle
+     */
+    rotate(axis: RotationAxis, angle: number): Circle;
+    /**
+     * Offset this circle by changing its radius.
+     * @param distance - Distance to offset (positive = larger, negative = smaller)
+     * @returns New circle with adjusted radius
+     */
     offset(distance: number): Circle;
-    /** Project onto plane. Returns a Polygon because a tilted circle projects to an ellipse. */
+    /**
+     * Project onto plane. Returns a Polygon because a tilted circle projects to an ellipse.
+     * @param plane - Target plane
+     * @param direction - Optional projection direction (default: perpendicular to plane)
+     * @param samples - Number of sample points for approximation (default 64)
+     * @returns Polygon approximating the projected circle
+     */
     projectOntoPlane(plane: Plane, direction?: Vec3, samples?: number): Polygon;
+    /**
+     * Extrude this circle along a direction vector to create a cylindrical mesh.
+     * @param direction - Extrusion direction and magnitude
+     * @param segments - Number of circumferential segments (default 16)
+     * @param caps - Whether to cap the ends (default true)
+     * @returns Mesh representing the extruded cylinder
+     */
     extrude(direction: Vec3, segments?: number, caps?: boolean): Mesh;
 }
 //# sourceMappingURL=Circle.d.ts.map

package/dist/Circle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../src/Circle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,qBAAa,MAAM;aAEC,MAAM,EAAE,KAAK;aACb,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,IAAI;gBAFZ,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,IAAa;IAGvC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK;IAUzB,MAAM,IAAI,MAAM;IAKhB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE;IAc1B,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAI/B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAQpE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIhC,4FAA4F;IAC5F,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,OAAO;IAMvE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,SAAK,EAAE,IAAI,UAAO,GAAG,IAAI;CAW3D"}
+{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../src/Circle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;GAGG;AACH,qBAAa,MAAM;aAUC,MAAM,EAAE,KAAK;aACb,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,IAAI;aACZ,KAAK,CAAC,EAAE,IAAI;IAZ9B;;;;;;;OAOG;gBAEe,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,IAAa,EACrB,KAAK,CAAC,EAAE,IAAI,YAAA;IAG9B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAItD;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK;IAUzB;;;OAGG;IACH,MAAM,IAAI,MAAM;IAKhB;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE;IAc1B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAI/B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAcjD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIhC;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,OAAO;IAMvE;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,SAAK,EAAE,IAAI,UAAO,GAAG,IAAI;CAW3D"}