okgeometry-api 1.17.0 → 1.18.0

package/src/Circle.ts

@@ -63,9 +63,12 @@ export class Circle {
   }
 
   /**
-   * Sample the circle into evenly-spaced points.
+   * Sample the circle into evenly-spaced points across the full closed
+   * parameter range INCLUSIVE of both ends: the last point coincides with
+   * the first (the seam). Consumers building a closed polygon from a circle
+   * must drop the final duplicate (see Mesh.buildPlanarCircle).
    * @param n - Number of points to generate
-   * @returns Array of n points around the circle
+   * @returns Array of n points around the circle, first == last
    */
   sample(n: number): Point[] {
     ensureInit();
@@ -139,25 +142,25 @@ export class Circle {
    * @param caps - Whether to cap the ends (default true)
    * @returns Mesh representing the extruded cylinder
    */
-  extrude(direction: Vec3, segments = 16, caps = true): Mesh {
-    ensureInit();
-    const buf = wasm.extrude_circle(
-      this.center.x, this.center.y, this.center.z,
-      this.normal.x, this.normal.y, this.normal.z,
+  extrude(direction: Vec3, segments = 16, caps = true): Mesh {
+    ensureInit();
+    const buf = wasm.extrude_circle(
+      this.center.x, this.center.y, this.center.z,
+      this.normal.x, this.normal.y, this.normal.z,
       this.radius,
       direction.x, direction.y, direction.z,
       segments, caps
-    );
-    return Mesh.fromBuffer(buf);
-  }
-
-  /**
-   * Extrude this closed circle into a trusted solid suitable for booleans.
-   * @param direction - Extrusion direction and magnitude
-   * @param segments - Number of boundary samples used for tessellation (default 32)
-   * @returns Closed mesh solid ready for boolean operations
-   */
-  extrudeAsSolid(direction: Vec3, segments = 32): Mesh {
-    return Mesh.extrudeCurveAsSolid(this, direction, segments);
-  }
-}
+    );
+    return Mesh.fromBuffer(buf);
+  }
+
+  /**
+   * Extrude this closed circle into a trusted solid suitable for booleans.
+   * @param direction - Extrusion direction and magnitude
+   * @param segments - Number of boundary samples used for tessellation (default 32)
+   * @returns Closed mesh solid ready for boolean operations
+   */
+  extrudeAsSolid(direction: Vec3, segments = 32): Mesh {
+    return Mesh.extrudeCurveAsSolid(this, direction, segments);
+  }
+}