okgeometry-api 1.1.2 → 1.1.3

package/package.json

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

package/src/Mesh.ts

@@ -376,6 +376,65 @@ export class Mesh {
     };
   }
 
+  private static roundDebugScalar(value: number): number {
+    return Number.isFinite(value) ? Number(value.toFixed(4)) : value;
+  }
+
+  private static summarizeDebugHit(hit: MeshDebugRayHit | undefined): {
+    point: { x: number; y: number; z: number };
+    normal: { x: number; y: number; z: number };
+    faceIndex: number;
+    distance: number;
+  } | null {
+    if (!hit) return null;
+    return {
+      point: {
+        x: Mesh.roundDebugScalar(hit.point.x),
+        y: Mesh.roundDebugScalar(hit.point.y),
+        z: Mesh.roundDebugScalar(hit.point.z),
+      },
+      normal: {
+        x: Mesh.roundDebugScalar(hit.normal.x),
+        y: Mesh.roundDebugScalar(hit.normal.y),
+        z: Mesh.roundDebugScalar(hit.normal.z),
+      },
+      faceIndex: hit.faceIndex,
+      distance: Mesh.roundDebugScalar(hit.distance),
+    };
+  }
+
+  private static summarizeDebugProbe(probe: MeshBooleanDebugProbe): {
+    label: string;
+    origin: { x: number; y: number; z: number };
+    direction: { x: number; y: number; z: number };
+    inputAFirst: ReturnType<typeof Mesh.summarizeDebugHit>;
+    inputBFirst: ReturnType<typeof Mesh.summarizeDebugHit>;
+    resultFirst: ReturnType<typeof Mesh.summarizeDebugHit>;
+    inputAHits: number;
+    inputBHits: number;
+    resultHits: number;
+  } {
+    return {
+      label: probe.label,
+      origin: {
+        x: Mesh.roundDebugScalar(probe.origin.x),
+        y: Mesh.roundDebugScalar(probe.origin.y),
+        z: Mesh.roundDebugScalar(probe.origin.z),
+      },
+      direction: {
+        x: Mesh.roundDebugScalar(probe.direction.x),
+        y: Mesh.roundDebugScalar(probe.direction.y),
+        z: Mesh.roundDebugScalar(probe.direction.z),
+      },
+      inputAFirst: Mesh.summarizeDebugHit(probe.inputAHits[0]),
+      inputBFirst: Mesh.summarizeDebugHit(probe.inputBHits[0]),
+      resultFirst: Mesh.summarizeDebugHit(probe.resultHits[0]),
+      inputAHits: probe.inputAHits.length,
+      inputBHits: probe.inputBHits.length,
+      resultHits: probe.resultHits.length,
+    };
+  }
+
   private static logSubtractDebugSuccess(
     inputA: Mesh,
     inputB: Mesh,
@@ -390,13 +449,30 @@ export class Mesh {
         "subtraction",
         { maxRayHits: 2, probes: ["posX", "negX", "posY"] },
       );
+      const probeSummary = report.probes.map((probe) => Mesh.summarizeDebugProbe(probe));
       console.log("[okgeometry-api] Mesh.subtract debug", {
         options: options ?? null,
         inputA: report.inputA,
         inputB: report.inputB,
         result: report.resultSummary,
-        probes: report.probes,
+        deltas: {
+          faceCount: report.resultSummary.faceCount - report.inputA.faceCount,
+          vertexCount: report.resultSummary.vertexCount - report.inputA.vertexCount,
+        },
+        probeSummary,
+        report,
+      });
+      console.log("[okgeometry-api] Mesh.subtract summary", {
+        inputAFaces: report.inputA.faceCount,
+        inputBFaces: report.inputB.faceCount,
+        resultFaces: report.resultSummary.faceCount,
+        inputAVerts: report.inputA.vertexCount,
+        inputBVerts: report.inputB.vertexCount,
+        resultVerts: report.resultSummary.vertexCount,
+        resultClosed: report.resultSummary.isClosedVolume,
+        resultTopology: report.resultSummary.topology,
       });
+      console.log("[okgeometry-api] Mesh.subtract probeSummary", probeSummary);
     } catch (debugError) {
       console.error("[okgeometry-api] Mesh.subtract debug logging failed", debugError);
     }