okgeometry-api 1.24.0 → 1.25.0

package/src/Mesh.ts

@@ -3846,6 +3846,36 @@ export class Mesh {
     return Mesh.fromTrustedBuffer(r as Float64Array);
   }
 
+  /**
+   * All feature-edge chains of this mesh: every connected chain of edges
+   * separating the same two smooth face groups — the exact grouping
+   * `chamferEdges` expands picks to. Each chain is an ordered polyline
+   * (`points` = flat xyz triples); `closed` chains (tessellated rims) omit
+   * the duplicate seam point. Use this to show what a chamfer pick will
+   * actually cut. Throws on an invalid mesh; a mesh with no feature edges
+   * returns an empty array.
+   */
+  featureEdgeChains(): Array<{ closed: boolean; points: Float64Array }> {
+    ensureInit();
+    const r = wasm.mesh_feature_edge_chains(this._vertexCount, this._buffer);
+    if (!r.length) {
+      throw new Error(
+        `Mesh.featureEdgeChains() failed: ${wasm.geometry_last_error() || "unknown error"}`,
+      );
+    }
+    const chains: Array<{ closed: boolean; points: Float64Array }> = [];
+    let offset = 0;
+    const chainCount = r[offset++];
+    for (let c = 0; c < chainCount; c++) {
+      const closed = r[offset++] !== 0;
+      const pointCount = r[offset++];
+      const points = (r as Float64Array).slice(offset, offset + pointCount * 3);
+      offset += pointCount * 3;
+      chains.push({ closed, points });
+    }
+    return chains;
+  }
+
   /**
    * Geometry-preserving repair: weld coincident vertices, drop degenerate /
    * duplicate triangles, remove orphan vertices, make winding consistent +