okgeometry-api 0.5.0 → 0.5.2

package/src/Line.ts

@@ -0,0 +1,144 @@
+import { ensureInit } from "./engine.js";
+import { Point } from "./Point.js";
+import { Vec3 } from "./Vec3.js";
+import { Mesh } from "./Mesh.js";
+import type { Plane } from "./Plane.js";
+import type { RotationAxis } from "./types.js";
+import * as wasm from "../wasm/okgeometrycore_bg.js";
+
+/**
+ * Immutable line segment defined by start and end points.
+ * Supports evaluation, transformation, and extrusion operations.
+ */
+export class Line {
+  constructor(
+    public readonly start: Point,
+    public readonly end: Point
+  ) {}
+
+  /**
+   * Evaluate a point on the line at normalized parameter t.
+   * @param t - Parameter in [0, 1] (0 = start, 1 = end)
+   * @returns Point on line at parameter t
+   */
+  pointAt(t: number): Point {
+    ensureInit();
+    const r = wasm.line_point_at(
+      this.start.x, this.start.y, this.start.z,
+      this.end.x, this.end.y, this.end.z,
+      t
+    );
+    return new Point(r[0], r[1], r[2]);
+  }
+
+  /**
+   * Get the length of this line segment.
+   * @returns Euclidean distance from start to end
+   */
+  length(): number {
+    ensureInit();
+    return wasm.line_length(
+      this.start.x, this.start.y, this.start.z,
+      this.end.x, this.end.y, this.end.z
+    );
+  }
+
+  /**
+   * Get the unit direction vector of this line.
+   * @returns Normalized vector from start to end
+   */
+  tangent(): Vec3 {
+    ensureInit();
+    const r = wasm.line_tangent(
+      this.start.x, this.start.y, this.start.z,
+      this.end.x, this.end.y, this.end.z
+    );
+    return new Vec3(r[0], r[1], r[2]);
+  }
+
+  /**
+   * Sample the line into evenly-spaced points.
+   * @param n - Number of points to generate
+   * @returns Array of n points along the line
+   */
+  sample(n: number): Point[] {
+    ensureInit();
+    const buf = wasm.create_line(
+      this.start.x, this.start.y, this.start.z,
+      this.end.x, this.end.y, this.end.z,
+      n
+    );
+    const pts: Point[] = [];
+    for (let i = 0; i < buf.length; i += 3) {
+      pts.push(new Point(buf[i], buf[i + 1], buf[i + 2]));
+    }
+    return pts;
+  }
+
+  /**
+   * Translate this line by an offset vector.
+   * @param offset - Translation vector
+   * @returns New translated line
+   */
+  translate(offset: Vec3): Line {
+    return new Line(this.start.add(offset), this.end.add(offset));
+  }
+
+  /**
+   * Rotate this line around an axis.
+   * @param axis - Rotation axis (Vec3 through origin, or Line for arbitrary axis)
+   * @param angle - Rotation angle in radians
+   * @returns New rotated line
+   */
+  rotate(axis: RotationAxis, angle: number): Line {
+    return new Line(this.start.rotate(axis, angle), this.end.rotate(axis, angle));
+  }
+
+  /**
+   * Offset this line perpendicular to its direction.
+   * @param distance - Offset distance (positive = along normal cross direction)
+   * @param normal - Reference normal for determining offset direction (default Z axis)
+   * @returns New offset line
+   */
+  offset(distance: number, normal: Vec3 = Vec3.Z): Line {
+    ensureInit();
+    const r = wasm.line_offset(
+      this.start.x, this.start.y, this.start.z,
+      this.end.x, this.end.y, this.end.z,
+      distance,
+      normal.x, normal.y, normal.z,
+    );
+    return new Line(
+      new Point(r[0], r[1], r[2]),
+      new Point(r[3], r[4], r[5]),
+    );
+  }
+
+  /**
+   * Project this line onto a plane.
+   * @param plane - Target plane
+   * @param direction - Optional projection direction (default: perpendicular to plane)
+   * @returns New projected line
+   */
+  projectOntoPlane(plane: Plane, direction?: Vec3): Line {
+    const proj = (p: Point) => direction ? plane.projectPointAlongDirection(p, direction) : plane.projectPoint(p);
+    return new Line(proj(this.start), proj(this.end));
+  }
+
+  /**
+   * Extrude this line into a mesh surface.
+   * @param direction - Extrusion direction vector
+   * @param segments - Number of segments along extrusion (default 1)
+   * @returns Mesh representing the extruded surface
+   */
+  extrude(direction: Vec3, segments = 1): Mesh {
+    ensureInit();
+    const buf = wasm.extrude_line(
+      this.start.x, this.start.y, this.start.z,
+      this.end.x, this.end.y, this.end.z,
+      direction.x, direction.y, direction.z,
+      segments
+    );
+    return Mesh.fromBuffer(buf);
+  }
+}