okgeometry-api 1.1.3 → 1.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okgeometry-api",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "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

@@ -104,10 +104,13 @@ export interface MeshBooleanDebugProbe {
   resultHits: MeshDebugRayHit[];
 }
 
+export type MeshBooleanDebugProbeId =
+  "posX" | "negX" | "posY" | "negY" | "posZ" | "negZ";
+
 export interface MeshBooleanDebugOptions {
   rayPaddingScale?: number;
   maxRayHits?: number;
-  probes?: Array<"posX" | "negX" | "posY" | "negY" | "posZ" | "negZ">;
+  probes?: MeshBooleanDebugProbeId[];
 }
 
 export interface MeshBooleanDebugReport {
@@ -129,9 +132,14 @@ export class Mesh {
   private _buffer: Float64Array;
   private _vertexCount: number;
   private _trustedBooleanInput: boolean;
-  private static readonly DEFAULT_BOOLEAN_DEBUG_PROBES: Array<
-    "posX" | "negX" | "posY" | "negY" | "posZ" | "negZ"
-  > = ["posX", "negX", "posY", "negY", "posZ", "negZ"];
+  private static readonly DEFAULT_BOOLEAN_DEBUG_PROBES: MeshBooleanDebugProbeId[] = [
+    "posX",
+    "negX",
+    "posY",
+    "negY",
+    "posZ",
+    "negZ",
+  ];
 
   private static readonly DEFAULT_BOOLEAN_LIMITS: MeshBooleanLimits = {
     maxInputFacesPerMesh: 120_000,
@@ -278,87 +286,159 @@ export class Mesh {
     }));
   }
 
-  private static buildBooleanDebugProbes(
+  private static uniqueDebugProbeIds(
+    probeIds: MeshBooleanDebugProbeId[],
+  ): MeshBooleanDebugProbeId[] {
+    return [...new Set(probeIds)];
+  }
+
+  private static buildInputBProbeOriginOffsets(
+    jitter: number,
+  ): Record<MeshBooleanDebugProbeId, Vec3> {
+    const major = jitter;
+    const minor = jitter * 0.61803398875;
+    const micro = jitter * 0.38196601125;
+    return {
+      posX: new Vec3(0, minor, -major),
+      negX: new Vec3(0, -minor, major),
+      posY: new Vec3(major, 0, micro),
+      negY: new Vec3(-major, 0, -micro),
+      posZ: new Vec3(major, -minor, 0),
+      negZ: new Vec3(-major, minor, 0),
+    };
+  }
+
+  private static buildDirectionalDebugProbes(
     inputA: Mesh,
     inputB: Mesh,
     result: Mesh,
-    options?: MeshBooleanDebugOptions,
+    center: Point,
+    pad: number,
+    maxDistance: number,
+    maxHits: number,
+    probeIds: MeshBooleanDebugProbeId[],
+    labelPrefix = "",
+    originOffsets?: Partial<Record<MeshBooleanDebugProbeId, Vec3>>,
   ): MeshBooleanDebugProbe[] {
-    const boundsA = Mesh.toDebugBounds(inputA.getBounds());
-    const boundsB = Mesh.toDebugBounds(inputB.getBounds());
-    const resultBounds = Mesh.toDebugBounds(result.getBounds());
-    const min = new Point(
-      Math.min(boundsA.min.x, boundsB.min.x, resultBounds.min.x),
-      Math.min(boundsA.min.y, boundsB.min.y, resultBounds.min.y),
-      Math.min(boundsA.min.z, boundsB.min.z, resultBounds.min.z),
-    );
-    const max = new Point(
-      Math.max(boundsA.max.x, boundsB.max.x, resultBounds.max.x),
-      Math.max(boundsA.max.y, boundsB.max.y, resultBounds.max.y),
-      Math.max(boundsA.max.z, boundsB.max.z, resultBounds.max.z),
-    );
-    const center = new Point(
-      (min.x + max.x) * 0.5,
-      (min.y + max.y) * 0.5,
-      (min.z + max.z) * 0.5,
-    );
-    const diag = Math.max(
-      1e-6,
-      Math.hypot(max.x - min.x, max.y - min.y, max.z - min.z),
-    );
-    const padScale = Number.isFinite(options?.rayPaddingScale)
-      ? Math.max(0.01, options?.rayPaddingScale ?? 0.25)
-      : 0.25;
-    const pad = Math.max(1e-3, diag * padScale);
-    const maxHits = Mesh.clampDebugHitCount(options?.maxRayHits);
-    const probeIds = options?.probes?.length
-      ? options.probes
-      : Mesh.DEFAULT_BOOLEAN_DEBUG_PROBES;
+    const prefixed = (id: string) => (labelPrefix ? `${labelPrefix}:${id}` : id);
     const probeSpecs: Record<
-      "posX" | "negX" | "posY" | "negY" | "posZ" | "negZ",
+      MeshBooleanDebugProbeId,
       { origin: Point; direction: Vec3 }
     > = {
       posX: {
-        origin: new Point(max.x + pad, center.y, center.z),
+        origin: new Point(center.x + pad, center.y, center.z),
         direction: new Vec3(-1, 0, 0),
       },
       negX: {
-        origin: new Point(min.x - pad, center.y, center.z),
+        origin: new Point(center.x - pad, center.y, center.z),
         direction: new Vec3(1, 0, 0),
       },
       posY: {
-        origin: new Point(center.x, max.y + pad, center.z),
+        origin: new Point(center.x, center.y + pad, center.z),
         direction: new Vec3(0, -1, 0),
       },
       negY: {
-        origin: new Point(center.x, min.y - pad, center.z),
+        origin: new Point(center.x, center.y - pad, center.z),
         direction: new Vec3(0, 1, 0),
       },
       posZ: {
-        origin: new Point(center.x, center.y, max.z + pad),
+        origin: new Point(center.x, center.y, center.z + pad),
         direction: new Vec3(0, 0, -1),
       },
       negZ: {
-        origin: new Point(center.x, center.y, min.z - pad),
+        origin: new Point(center.x, center.y, center.z - pad),
         direction: new Vec3(0, 0, 1),
       },
     };
-    const maxDistance = diag + pad * 2;
 
     return probeIds.map((id) => {
       const spec = probeSpecs[id];
+      const originOffset = originOffsets?.[id];
+      const origin = originOffset
+        ? new Point(
+          spec.origin.x + originOffset.x,
+          spec.origin.y + originOffset.y,
+          spec.origin.z + originOffset.z,
+        )
+        : spec.origin;
       return {
-        label: id,
-        origin: spec.origin,
+        label: prefixed(id),
+        origin,
         direction: spec.direction,
         maxDistance,
-        inputAHits: Mesh.collectDebugHits(inputA, spec.origin, spec.direction, maxDistance, maxHits),
-        inputBHits: Mesh.collectDebugHits(inputB, spec.origin, spec.direction, maxDistance, maxHits),
-        resultHits: Mesh.collectDebugHits(result, spec.origin, spec.direction, maxDistance, maxHits),
+        inputAHits: Mesh.collectDebugHits(inputA, origin, spec.direction, maxDistance, maxHits),
+        inputBHits: Mesh.collectDebugHits(inputB, origin, spec.direction, maxDistance, maxHits),
+        resultHits: Mesh.collectDebugHits(result, origin, spec.direction, maxDistance, maxHits),
       };
     });
   }
 
+  private static buildBooleanDebugProbes(
+    inputA: Mesh,
+    inputB: Mesh,
+    result: Mesh,
+    options?: MeshBooleanDebugOptions,
+  ): MeshBooleanDebugProbe[] {
+    const boundsA = Mesh.toDebugBounds(inputA.getBounds());
+    const boundsB = Mesh.toDebugBounds(inputB.getBounds());
+    const resultBounds = Mesh.toDebugBounds(result.getBounds());
+    const min = new Point(
+      Math.min(boundsA.min.x, boundsB.min.x, resultBounds.min.x),
+      Math.min(boundsA.min.y, boundsB.min.y, resultBounds.min.y),
+      Math.min(boundsA.min.z, boundsB.min.z, resultBounds.min.z),
+    );
+    const max = new Point(
+      Math.max(boundsA.max.x, boundsB.max.x, resultBounds.max.x),
+      Math.max(boundsA.max.y, boundsB.max.y, resultBounds.max.y),
+      Math.max(boundsA.max.z, boundsB.max.z, resultBounds.max.z),
+    );
+    const center = new Point(
+      (min.x + max.x) * 0.5,
+      (min.y + max.y) * 0.5,
+      (min.z + max.z) * 0.5,
+    );
+    const diag = Math.max(
+      1e-6,
+      Math.hypot(max.x - min.x, max.y - min.y, max.z - min.z),
+    );
+    const padScale = Number.isFinite(options?.rayPaddingScale)
+      ? Math.max(0.01, options?.rayPaddingScale ?? 0.25)
+      : 0.25;
+    const pad = Math.max(1e-3, diag * padScale);
+    const maxHits = Mesh.clampDebugHitCount(options?.maxRayHits);
+    const sceneProbeIds = Mesh.uniqueDebugProbeIds(
+      options?.probes?.length
+        ? options.probes
+        : Mesh.DEFAULT_BOOLEAN_DEBUG_PROBES,
+    );
+    const inputBProbeIds = Mesh.uniqueDebugProbeIds(sceneProbeIds.concat(["posZ", "negZ"]));
+    const inputBJitter = Math.max(1e-6, Math.min(pad * 0.1, boundsB.diagonal * 0.01));
+    const maxDistance = diag + pad * 2;
+    const sceneCenterProbes = Mesh.buildDirectionalDebugProbes(
+      inputA,
+      inputB,
+      result,
+      center,
+      pad,
+      maxDistance,
+      maxHits,
+      sceneProbeIds,
+    );
+    const inputBCenterProbes = Mesh.buildDirectionalDebugProbes(
+      inputA,
+      inputB,
+      result,
+      boundsB.center,
+      pad,
+      maxDistance,
+      maxHits,
+      inputBProbeIds,
+      "inputB",
+      Mesh.buildInputBProbeOriginOffsets(inputBJitter),
+    );
+    return sceneCenterProbes.concat(inputBCenterProbes);
+  }
+
   private static createBooleanDebugReport(
     inputA: Mesh,
     inputB: Mesh,

package/src/index.ts

@@ -36,6 +36,7 @@ export { NurbsSurface } from "./NurbsSurface.js";
 export { Mesh, MeshBooleanExecutionError } from "./Mesh.js";
 export type {
   MeshBooleanOperation,
+  MeshBooleanDebugProbeId,
   MeshBooleanDebugOptions,
   MeshBooleanDebugProbe,
   MeshBooleanDebugReport,