okgeometry-api 1.1.4 → 1.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okgeometry-api",
-  "version": "1.1.4",
+  "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,6 +286,28 @@ export class Mesh {
     }));
   }
 
+  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,
@@ -286,12 +316,13 @@ export class Mesh {
     pad: number,
     maxDistance: number,
     maxHits: number,
-    probeIds: Array<"posX" | "negX" | "posY" | "negY" | "posZ" | "negZ">,
+    probeIds: MeshBooleanDebugProbeId[],
     labelPrefix = "",
+    originOffsets?: Partial<Record<MeshBooleanDebugProbeId, Vec3>>,
   ): MeshBooleanDebugProbe[] {
     const prefixed = (id: string) => (labelPrefix ? `${labelPrefix}:${id}` : id);
     const probeSpecs: Record<
-      "posX" | "negX" | "posY" | "negY" | "posZ" | "negZ",
+      MeshBooleanDebugProbeId,
       { origin: Point; direction: Vec3 }
     > = {
       posX: {
@@ -322,14 +353,22 @@ export class Mesh {
 
     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: prefixed(id),
-        origin: spec.origin,
+        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),
       };
     });
   }
@@ -367,9 +406,13 @@ export class Mesh {
       : 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 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,
@@ -379,7 +422,7 @@ export class Mesh {
       pad,
       maxDistance,
       maxHits,
-      probeIds,
+      sceneProbeIds,
     );
     const inputBCenterProbes = Mesh.buildDirectionalDebugProbes(
       inputA,
@@ -389,8 +432,9 @@ export class Mesh {
       pad,
       maxDistance,
       maxHits,
-      probeIds,
+      inputBProbeIds,
       "inputB",
+      Mesh.buildInputBProbeOriginOffsets(inputBJitter),
     );
     return sceneCenterProbes.concat(inputBCenterProbes);
   }

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,