okgeometry-api 1.59.0 → 1.60.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okgeometry-api",
-  "version": "1.59.0",
+  "version": "1.60.0",
   "description": "Geometry engine API for AEC applications - NURBS, meshes, booleans, intersections. Powered by Rust/WASM.",
   "type": "module",
   "main": "dist/index.js",

package/src/WallNetwork.ts

@@ -326,6 +326,42 @@ export class WallNetwork {
     this.mod.wall_network_set_openings(this.id, wall, buf);
   }
 
+  /**
+   * Replace one element's FREE-FORM void cutter list (okdraw VOIDS-PLAN
+   * §3.3) — walls AND floors share the element index space. Cutter meshes
+   * are WORLD-space closed triangle soups; an empty list clears. Derived
+   * state like openings: never recorded, the host re-derives on load/undo.
+   * Wire: the network's first mesh-valued input, count-prefixed flat pack
+   * `[cutterCount, (vertexCount, indexCount, xyz…, indices…)×N]`.
+   * Returns the number of cutters applied (0 = cleared, refused slot, or
+   * malformed input — see geometryLastError).
+   */
+  setCutters(
+    element: number,
+    cutters: Array<{ positions: Float64Array | number[]; indices: Uint32Array | number[] }>,
+  ): number {
+    let words = 1;
+    for (const c of cutters) {
+      words += 2 + c.positions.length + c.indices.length;
+    }
+    const buf = new Float64Array(words);
+    buf[0] = cutters.length;
+    let o = 1;
+    for (const c of cutters) {
+      const vc = Math.floor(c.positions.length / 3);
+      buf[o] = vc;
+      buf[o + 1] = c.indices.length;
+      o += 2;
+      buf.set(c.positions as ArrayLike<number>, o);
+      o += c.positions.length;
+      for (let k = 0; k < c.indices.length; k++) {
+        buf[o + k] = c.indices[k];
+      }
+      o += c.indices.length;
+    }
+    return this.mod.wall_network_set_cutters(this.id, element, buf);
+  }
+
   /**
    * Solve + re-emit dirty chunks; pulls every rebuilt chunk's buffers and
    * DRAINS the kernel-side packed copies (chunk buffers are scratch — the