okgeometry-api 1.19.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.
@@ -923,6 +940,15 @@ export function mesh_polyline_intersection_points(vertex_count: number, buffer:
  */
 export function mesh_prepare_boolean_cutter_curve(coords: Float64Array, closed: boolean, nx: number, ny: number, nz: number, height: number): Float64Array;
 
+/**
+ * Host-aware boolean cutter preparation: like
+ * `mesh_prepare_boolean_cutter_curve`, but the bias is raised past the
+ * measured host-surface deviation under the cutter footprint (sculpted /
+ * non-planar faces). The host arrives as a standard triangulated buffer.
+ * Returns [height, epsilon, pointCount, x,y,z,...]
+ */
+export function mesh_prepare_hosted_boolean_cutter(host_vertex_count: number, host_buffer: Float64Array, coords: Float64Array, closed: boolean, nx: number, ny: number, nz: number, height: number): Float64Array;
+
 /**
  * Raycast against mesh and return closest hit.
  * Output: [] when no hit, otherwise [pointX,pointY,pointZ, normalX,normalY,normalZ, faceIndex, distance]
@@ -942,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
@@ -1038,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, ...]
@@ -1328,6 +1383,16 @@ export function sculpt_session_create(vertex_count: number, buffer: Float64Array
  */
 export function sculpt_session_dab(id: number, cx: number, cy: number, cz: number, vx: number, vy: number, vz: number, dragx: number, dragy: number, dragz: number, pressure: number): Float32Array;
 
+/**
+ * Locally REDUCE point density in the given triangle group (constrained
+ * edge collapse of interior vertices; the group boundary is preserved)
+ * until the group has at most `target_points` unique vertices or no safe
+ * collapse remains. Returns 1 when at least one collapse happened, 0
+ * otherwise. Clears session undo history; callers must refetch
+ * `sculpt_session_render_data` afterwards.
+ */
+export function sculpt_session_decimate_faces(id: number, triangles: Uint32Array, target_points: number): number;
+
 /**
  * Finish the active stroke (pushes one undo entry).
  */
@@ -1539,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];
@@ -1574,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];
@@ -1584,9 +1651,12 @@ export interface InitOutput {
     readonly mesh_plane_intersect: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly mesh_polyline_intersection_points: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly mesh_prepare_boolean_cutter_curve: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
+    readonly mesh_prepare_hosted_boolean_cutter: (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: (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];
@@ -1600,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];
@@ -1637,6 +1708,7 @@ export interface InitOutput {
     readonly sculpt_session_begin_stroke: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
     readonly sculpt_session_create: (a: number, b: number, c: number) => number;
     readonly sculpt_session_dab: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => [number, number];
+    readonly sculpt_session_decimate_faces: (a: number, b: number, c: number, d: number) => number;
     readonly sculpt_session_end_stroke: (a: number) => void;
     readonly sculpt_session_face_group: (a: number, b: number, c: number) => [number, number];
     readonly sculpt_session_info: (a: 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.
@@ -2830,6 +2869,33 @@ export function mesh_prepare_boolean_cutter_curve(coords, closed, nx, ny, nz, he
     return v2;
 }
 
+/**
+ * Host-aware boolean cutter preparation: like
+ * `mesh_prepare_boolean_cutter_curve`, but the bias is raised past the
+ * measured host-surface deviation under the cutter footprint (sculpted /
+ * non-planar faces). The host arrives as a standard triangulated buffer.
+ * Returns [height, epsilon, pointCount, x,y,z,...]
+ * @param {number} host_vertex_count
+ * @param {Float64Array} host_buffer
+ * @param {Float64Array} coords
+ * @param {boolean} closed
+ * @param {number} nx
+ * @param {number} ny
+ * @param {number} nz
+ * @param {number} height
+ * @returns {Float64Array}
+ */
+export function mesh_prepare_hosted_boolean_cutter(host_vertex_count, host_buffer, coords, closed, nx, ny, nz, height) {
+    const ptr0 = passArrayF64ToWasm0(host_buffer, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArrayF64ToWasm0(coords, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.mesh_prepare_hosted_boolean_cutter(host_vertex_count, ptr0, len0, ptr1, len1, closed, nx, ny, nz, height);
+    var v3 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    return v3;
+}
+
 /**
  * Raycast against mesh and return closest hit.
  * Output: [] when no hit, otherwise [pointX,pointY,pointZ, normalX,normalY,normalZ, faceIndex, distance]
@@ -2899,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
@@ -3194,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, ...]
@@ -3943,6 +4073,25 @@ export function sculpt_session_dab(id, cx, cy, cz, vx, vy, vz, dragx, dragy, dra
     return v1;
 }
 
+/**
+ * Locally REDUCE point density in the given triangle group (constrained
+ * edge collapse of interior vertices; the group boundary is preserved)
+ * until the group has at most `target_points` unique vertices or no safe
+ * collapse remains. Returns 1 when at least one collapse happened, 0
+ * otherwise. Clears session undo history; callers must refetch
+ * `sculpt_session_render_data` afterwards.
+ * @param {number} id
+ * @param {Uint32Array} triangles
+ * @param {number} target_points
+ * @returns {number}
+ */
+export function sculpt_session_decimate_faces(id, triangles, target_points) {
+    const ptr0 = passArray32ToWasm0(triangles, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.sculpt_session_decimate_faces(id, ptr0, len0, target_points);
+    return ret >>> 0;
+}
+
 /**
  * Finish the active stroke (pushes one undo entry).
  * @param {number} id