okgeometry-api 1.9.0 → 1.10.0

package/src/Mesh.ts

@@ -2521,6 +2521,68 @@ export class Mesh {
     return this.splitWithCurve(target, options as MeshCurveSplitOptions | undefined);
   }
 
+  /**
+   * Split this CLOSED solid by a `surface` (an open sheet or a closed shell)
+   * into BOTH sides as WATERTIGHT CAPPED solids.
+   *
+   * Unlike {@link split} — which, for an open-surface cutter, leaves open
+   * shells — this welds the portion of the surface that lies inside the solid
+   * onto each side as a cap. Because the host cut and the surface trim are
+   * computed from the same triangle–triangle intersection segments, the seam
+   * vertices coincide and the result is watertight.
+   *
+   * Result semantics (classification "surface"):
+   * - `outside` / `negative`: the side on the negative side of the surface
+   *   normal, capped by the trimmed surface patch.
+   * - `inside` / `positive`: the positive side, capped by the same patch.
+   *
+   * If the surface does not fully cut through the solid, the produced side(s)
+   * will not be closed — verify with `isClosedVolume()` on the side you keep.
+   */
+  splitSolidBySurface(surface: Mesh, options?: MeshBooleanOptions): MeshSplitResult {
+    ensureInit();
+    if (this.faceCount === 0) {
+      return Mesh.createSurfaceSplitResult([], []);
+    }
+    if (surface.faceCount === 0) {
+      return Mesh.createSurfaceSplitResult([Mesh.cloneMesh(this)], []);
+    }
+
+    if (!options?.allowUnsafe) {
+      const limits = Mesh.resolveBooleanLimits(options?.limits);
+      const faceCountA = this.faceCount;
+      const faceCountB = surface.faceCount;
+      const maxInputFaces = Math.max(faceCountA, faceCountB);
+      const combinedInputFaces = faceCountA + faceCountB;
+      const faceProduct = faceCountA * faceCountB;
+      if (
+        maxInputFaces > limits.maxInputFacesPerMesh
+        || combinedInputFaces > limits.maxCombinedInputFaces
+        || faceProduct > limits.maxFaceProduct
+      ) {
+        throw new Error(
+          `Mesh solid split by surface blocked by safety limits `
+          + `(solid faces=${faceCountA}, surface faces=${faceCountB}, faceProduct=${faceProduct}). `
+          + "Simplify inputs or pass allowUnsafe: true to force execution.",
+        );
+      }
+    }
+
+    const token = Mesh.encodeBooleanSplitToken(this, surface, options);
+    const result = wasm.mesh_solid_split_by_surface(
+      this._vertexCount,
+      this._buffer,
+      surface._vertexCount,
+      surface._buffer,
+      token,
+    );
+    if (result.length === 0) {
+      throw new Error("Mesh solid split by surface failed and returned an invalid result buffer.");
+    }
+    const parsed = Mesh.parseSplitResultBuffer(result);
+    return Mesh.createSurfaceSplitResult(parsed.outside, parsed.inside);
+  }
+
   debugBoolean(
     other: Mesh,
     operation: MeshBooleanOperation,