okgeometry-api 1.20.0 → 1.21.0

package/src/wasm-bindings.d.ts

@@ -616,6 +616,13 @@ export function mesh_boolean_union(vertex_count_a: number, buffer_a: Float64Arra
  */
 export function mesh_boolean_union_all(packed: Float64Array, flags: string): Float64Array;
 
+/**
+ * Flat 3D endpoints of every open boundary edge: `[x0,y0,z0, x1,y1,z1, ...]`,
+ * six values per segment. Empty when the mesh is closed. Drives the red
+ * "open edge" viewport highlight.
+ */
+export function mesh_boundary_edge_segments(vertex_count: number, buffer: Float64Array): Float64Array;
+
 /**
  * Extract boundary (perimeter) edges from a mesh as polylines.
  * Returns polyline buffer: [num_polylines, n1, x,y,z,..., n2, x,y,z,...]
@@ -857,6 +864,16 @@ export function mesh_import_stl(data: Uint8Array, weld_tolerance: number): Float
  */
 export function mesh_is_closed_volume(vertex_count: number, buffer: Float64Array): boolean;
 
+/**
+ * Layered "make watertight": first geometry-preserving repair; if that already
+ * closes the mesh, return it. Otherwise fall back to voxel remeshing.
+ *
+ * Output: `[ before(13), after(13), method, effectiveResolution, vertexCount,
+ * ...positions, ...indices ]` where `method` is 0 (repair) or 1 (remesh) and
+ * `after` describes the returned mesh.
+ */
+export function mesh_make_watertight(vertex_count: number, buffer: Float64Array, resolution: number, iso: number): Float64Array;
+
 /**
  * Debug helper: run only the isolated direct-port `MeshGL -> Impl -> MeshGL`
  * normalization owner and return a JSON dump for local port validation.
@@ -951,6 +968,25 @@ export function mesh_raycast_all(vertex_count: number, buffer: Float64Array, ox:
  */
 export function mesh_raycast_many(mesh_data: Float64Array, ox: number, oy: number, oz: number, dx: number, dy: number, dz: number, max_distance: number): Float64Array;
 
+/**
+ * Geometry-preserving repair: weld, drop degenerate/duplicate triangles,
+ * remove orphan vertices, fix winding, and fill holes.
+ *
+ * `flags` bitmask: 1=weld, 2=removeDegenerate, 4=removeDuplicate,
+ * 8=fillHoles, 16=fixWinding, 32=removeUnreferenced. `weld_tolerance <= 0`
+ * = auto; `max_hole_edges <= 0` = fill every hole.
+ *
+ * Output: `[ before(13), after(13), weldedVertices, removedTriangles,
+ * filledHoles, vertexCount, ...positions, ...indices ]` — the trailing mesh
+ * buffer is a standard `[vertexCount, positions, indices]` block.
+ */
+export function mesh_repair(vertex_count: number, buffer: Float64Array, flags: number, weld_tolerance: number, max_hole_edges: number): Float64Array;
+
+/**
+ * Full mesh health report (see [`push_repair_diag`] for the 13-value layout).
+ */
+export function mesh_repair_diagnostics(vertex_count: number, buffer: Float64Array): Float64Array;
+
 /**
  * Rotate a mesh around an arbitrary axis and return new buffers
  * Axis is defined by (ax, ay, az), angle in radians
@@ -1047,6 +1083,16 @@ export function mesh_topology_metrics_raw(vertex_count: number, buffer: Float64A
  */
 export function mesh_translate(vertex_count: number, buffer: Float64Array, dx: number, dy: number, dz: number): Float64Array;
 
+/**
+ * Rebuild a mesh as a guaranteed-watertight solid via generalized-winding-
+ * number voxel remeshing. `resolution` = cells along the longest axis
+ * (`0` = 64 default, auto-capped by a work budget). `iso` = winding threshold
+ * (`<=0` or `>=1` → 0.5).
+ *
+ * Output: a standard `[vertexCount, ...positions, ...indices]` mesh buffer.
+ */
+export function mesh_voxel_remesh(vertex_count: number, buffer: Float64Array, resolution: number, iso: number): Float64Array;
+
 /**
  * Intersect two NURBS curves.
  * Returns: [num_points, x,y,z, ...]
@@ -1558,6 +1604,7 @@ export interface InitOutput {
     readonly mesh_boolean_subtraction: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly mesh_boolean_union: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly mesh_boolean_union_all: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly mesh_boundary_edge_segments: (a: number, b: number, c: number) => [number, number];
     readonly mesh_boundary_polylines: (a: number, b: number, c: number) => [number, number];
     readonly mesh_build_coplanar_connected_face_groups: (a: number, b: number, c: number) => [number, number];
     readonly mesh_build_render_buffers: (a: number, b: number, c: number, d: number) => [number, number];
@@ -1593,6 +1640,7 @@ export interface InitOutput {
     readonly mesh_import_obj: (a: number, b: number) => [number, number];
     readonly mesh_import_stl: (a: number, b: number, c: number) => [number, number];
     readonly mesh_is_closed_volume: (a: number, b: number, c: number) => number;
+    readonly mesh_make_watertight: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly mesh_manifold_port_import_roundtrip_debug: (a: number, b: number, c: number, d: number) => [number, number];
     readonly mesh_manifold_port_import_stage_hashes_debug: (a: number, b: number, c: number, d: number) => [number, number];
     readonly mesh_manifold_port_triangulate_projected_polygon_debug: (a: number, b: number, c: number, d: number) => [number, number];
@@ -1607,6 +1655,8 @@ export interface InitOutput {
     readonly mesh_raycast: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
     readonly mesh_raycast_all: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
     readonly mesh_raycast_many: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number];
+    readonly mesh_repair: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly mesh_repair_diagnostics: (a: number, b: number, c: number) => [number, number];
     readonly mesh_rotate: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly mesh_scale: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly mesh_sheet_union: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
@@ -1620,6 +1670,7 @@ export interface InitOutput {
     readonly mesh_topology_metrics: (a: number, b: number, c: number) => [number, number];
     readonly mesh_topology_metrics_raw: (a: number, b: number, c: number) => [number, number];
     readonly mesh_translate: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly mesh_voxel_remesh: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly nurbs_curve_curve_intersect: (a: number, b: number, c: number, d: number) => [number, number];
     readonly nurbs_curve_curve_intersect_params: (a: number, b: number, c: number, d: number) => [number, number];
     readonly nurbs_curve_plane_intersect: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];

package/src/wasm-bindings.js

@@ -1977,6 +1977,23 @@ export function mesh_boolean_union_all(packed, flags) {
     return v3;
 }
 
+/**
+ * Flat 3D endpoints of every open boundary edge: `[x0,y0,z0, x1,y1,z1, ...]`,
+ * six values per segment. Empty when the mesh is closed. Drives the red
+ * "open edge" viewport highlight.
+ * @param {number} vertex_count
+ * @param {Float64Array} buffer
+ * @returns {Float64Array}
+ */
+export function mesh_boundary_edge_segments(vertex_count, buffer) {
+    const ptr0 = passArrayF64ToWasm0(buffer, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.mesh_boundary_edge_segments(vertex_count, ptr0, len0);
+    var v2 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v2;
+}
+
 /**
  * Extract boundary (perimeter) edges from a mesh as polylines.
  * Returns polyline buffer: [num_polylines, n1, x,y,z,..., n2, x,y,z,...]
@@ -2622,6 +2639,28 @@ export function mesh_is_closed_volume(vertex_count, buffer) {
     return ret !== 0;
 }
 
+/**
+ * Layered "make watertight": first geometry-preserving repair; if that already
+ * closes the mesh, return it. Otherwise fall back to voxel remeshing.
+ *
+ * Output: `[ before(13), after(13), method, effectiveResolution, vertexCount,
+ * ...positions, ...indices ]` where `method` is 0 (repair) or 1 (remesh) and
+ * `after` describes the returned mesh.
+ * @param {number} vertex_count
+ * @param {Float64Array} buffer
+ * @param {number} resolution
+ * @param {number} iso
+ * @returns {Float64Array}
+ */
+export function mesh_make_watertight(vertex_count, buffer, resolution, iso) {
+    const ptr0 = passArrayF64ToWasm0(buffer, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.mesh_make_watertight(vertex_count, ptr0, len0, resolution, iso);
+    var v2 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v2;
+}
+
 /**
  * Debug helper: run only the isolated direct-port `MeshGL -> Impl -> MeshGL`
  * normalization owner and return a JSON dump for local port validation.
@@ -2926,6 +2965,48 @@ export function mesh_raycast_many(mesh_data, ox, oy, oz, dx, dy, dz, max_distanc
     return v2;
 }
 
+/**
+ * Geometry-preserving repair: weld, drop degenerate/duplicate triangles,
+ * remove orphan vertices, fix winding, and fill holes.
+ *
+ * `flags` bitmask: 1=weld, 2=removeDegenerate, 4=removeDuplicate,
+ * 8=fillHoles, 16=fixWinding, 32=removeUnreferenced. `weld_tolerance <= 0`
+ * = auto; `max_hole_edges <= 0` = fill every hole.
+ *
+ * Output: `[ before(13), after(13), weldedVertices, removedTriangles,
+ * filledHoles, vertexCount, ...positions, ...indices ]` — the trailing mesh
+ * buffer is a standard `[vertexCount, positions, indices]` block.
+ * @param {number} vertex_count
+ * @param {Float64Array} buffer
+ * @param {number} flags
+ * @param {number} weld_tolerance
+ * @param {number} max_hole_edges
+ * @returns {Float64Array}
+ */
+export function mesh_repair(vertex_count, buffer, flags, weld_tolerance, max_hole_edges) {
+    const ptr0 = passArrayF64ToWasm0(buffer, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.mesh_repair(vertex_count, ptr0, len0, flags, weld_tolerance, max_hole_edges);
+    var v2 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v2;
+}
+
+/**
+ * Full mesh health report (see [`push_repair_diag`] for the 13-value layout).
+ * @param {number} vertex_count
+ * @param {Float64Array} buffer
+ * @returns {Float64Array}
+ */
+export function mesh_repair_diagnostics(vertex_count, buffer) {
+    const ptr0 = passArrayF64ToWasm0(buffer, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.mesh_repair_diagnostics(vertex_count, ptr0, len0);
+    var v2 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v2;
+}
+
 /**
  * Rotate a mesh around an arbitrary axis and return new buffers
  * Axis is defined by (ax, ay, az), angle in radians
@@ -3221,6 +3302,28 @@ export function mesh_translate(vertex_count, buffer, dx, dy, dz) {
     return v2;
 }
 
+/**
+ * Rebuild a mesh as a guaranteed-watertight solid via generalized-winding-
+ * number voxel remeshing. `resolution` = cells along the longest axis
+ * (`0` = 64 default, auto-capped by a work budget). `iso` = winding threshold
+ * (`<=0` or `>=1` → 0.5).
+ *
+ * Output: a standard `[vertexCount, ...positions, ...indices]` mesh buffer.
+ * @param {number} vertex_count
+ * @param {Float64Array} buffer
+ * @param {number} resolution
+ * @param {number} iso
+ * @returns {Float64Array}
+ */
+export function mesh_voxel_remesh(vertex_count, buffer, resolution, iso) {
+    const ptr0 = passArrayF64ToWasm0(buffer, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.mesh_voxel_remesh(vertex_count, ptr0, len0, resolution, iso);
+    var v2 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v2;
+}
+
 /**
  * Intersect two NURBS curves.
  * Returns: [num_points, x,y,z, ...]