okgeometry-api 0.5.8 → 1.0.0

package/dist/Mesh.d.ts

@@ -6,7 +6,7 @@ import type { SweepableCurve, RotationAxis } from "./types.js";
 import { MeshBooleanExecutionError } from "./mesh-boolean.protocol.js";
 import type { MeshBooleanAsyncOptions, MeshBooleanOptions } from "./mesh-boolean.protocol.js";
 export { MeshBooleanExecutionError };
-export type { MeshBooleanAsyncOptions, MeshBooleanBackend, MeshBooleanLimits, MeshBooleanOptions, MeshBooleanErrorCode, MeshBooleanErrorPayload, MeshBooleanProgressEvent, } from "./mesh-boolean.protocol.js";
+export type { MeshBooleanAsyncOptions, MeshBooleanLimits, MeshBooleanOptions, MeshBooleanErrorCode, MeshBooleanErrorPayload, MeshBooleanProgressEvent, } from "./mesh-boolean.protocol.js";
 export interface PlanarRectangle {
     corners: [Point, Point, Point, Point];
     width: number;
@@ -33,12 +33,17 @@ export interface PlanarArc {
 export declare class Mesh {
     private _buffer;
     private _vertexCount;
+    private _trustedBooleanInput;
     private static readonly DEFAULT_BOOLEAN_LIMITS;
+    private static readonly TOPOLOGY_METRICS_CACHE_FACE_THRESHOLD;
     private _positionBuffer;
     private _indexBuffer;
     private _vertices;
     private _faces;
     private _edgeVertexPairs;
+    private _topologyMetricsCache;
+    private _isClosedVolumeCache;
+    private _rawBoundsCache;
     private constructor();
     /**
      * Configure default size for the shared boolean worker pool.
@@ -89,7 +94,11 @@ export declare class Mesh {
      * @param buffer - Float64Array in mesh buffer format
      * @returns New Mesh instance
      */
-    static fromBuffer(buffer: Float64Array): Mesh;
+    static fromBuffer(buffer: Float64Array, options?: {
+        trustedBooleanInput?: boolean;
+    }): Mesh;
+    private static fromTrustedBuffer;
+    get trustedBooleanInput(): boolean;
     /**
      * Build an axis-aligned rectangle on a plane basis from opposite corners.
      * The resulting corners are ordered [p0, p1, p2, p3] and form a closed loop.
@@ -276,7 +285,7 @@ export declare class Mesh {
      */
     scaleXYZ(sx: number, sy: number, sz: number): Mesh;
     private runBoolean;
-    private static encodeBooleanOperationWithBackend;
+    static encodeBooleanOperationToken(operation: "union" | "subtraction" | "intersection", a: Mesh, b: Mesh, options?: MeshBooleanOptions): string;
     /**
      * Compute boolean union with another mesh.
      * @param other - Mesh to union with
@@ -420,6 +429,15 @@ export declare class Mesh {
      * Returns true when no welded topological boundary edges are found.
      */
     isClosedVolume(): boolean;
+    /**
+     * Return welded-edge topology metrics for this triangulated mesh.
+     * `boundaryEdges`: edges referenced by exactly one triangle.
+     * `nonManifoldEdges`: edges referenced by more than two triangles.
+     */
+    topologyMetrics(): {
+        boundaryEdges: number;
+        nonManifoldEdges: number;
+    };
     /**
      * Odd/even point containment test against a closed mesh.
      * Uses majority vote across multiple ray directions for robustness.

package/dist/Mesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mesh.d.ts","sourceRoot":"","sources":["../src/Mesh.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Mesh.d.ts","sourceRoot":"","sources":["../src/Mesh.ts"],"names":[],"mappings":"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"}

package/dist/Mesh.js

@@ -12,6 +12,7 @@ import { pointsToCoords, parsePolylineBuffer as parsePolylineBuf } from "./Buffe
 import { configureDefaultMeshBooleanWorkerPool, disposeMeshBooleanWorkerPools, runMeshBooleanInWorkerPool, } from "./mesh-boolean.pool.js";
 import { MeshBooleanExecutionError } from "./mesh-boolean.protocol.js";
 import * as wasm from "../wasm/okgeometrycore_bg.js";
+import { mesh_topology_metrics } from "../wasm/okgeometrycore.js";
 export { MeshBooleanExecutionError };
 /**
  * Buffer-backed triangle mesh with GPU-ready accessors.
@@ -20,15 +21,19 @@ export { MeshBooleanExecutionError };
  * Buffer format: [vertexCount, x1,y1,z1, ..., i1,i2,i3, ...]
  */
 export class Mesh {
-    constructor(buffer) {
+    constructor(buffer, trustedBooleanInput = false) {
         // Lazy caches
         this._positionBuffer = null;
         this._indexBuffer = null;
         this._vertices = null;
         this._faces = null;
         this._edgeVertexPairs = null;
+        this._topologyMetricsCache = null;
+        this._isClosedVolumeCache = null;
+        this._rawBoundsCache = undefined;
         this._buffer = buffer;
         this._vertexCount = buffer.length > 0 ? buffer[0] : 0;
+        this._trustedBooleanInput = trustedBooleanInput;
     }
     /**
      * Configure default size for the shared boolean worker pool.
@@ -51,8 +56,12 @@ export class Mesh {
         };
     }
     static computeRawBounds(mesh) {
-        if (mesh._vertexCount <= 0)
+        if (mesh._rawBoundsCache !== undefined)
+            return mesh._rawBoundsCache;
+        if (mesh._vertexCount <= 0) {
+            mesh._rawBoundsCache = null;
             return null;
+        }
         const data = mesh._buffer;
         const limit = 1 + mesh._vertexCount * 3;
         let minX = data[1];
@@ -78,7 +87,9 @@ export class Mesh {
             if (z > maxZ)
                 maxZ = z;
         }
-        return { minX, minY, minZ, maxX, maxY, maxZ };
+        const bounds = { minX, minY, minZ, maxX, maxY, maxZ };
+        mesh._rawBoundsCache = bounds;
+        return bounds;
     }
     static boundsOverlap(a, b, eps = 1e-9) {
         if (!a || !b)
@@ -104,10 +115,12 @@ export class Mesh {
         return Math.min(1e-4, Math.max(1e-9, scale * 1e-6));
     }
     static cloneMesh(mesh) {
-        return Mesh.fromBuffer(new Float64Array(mesh._buffer));
+        return Mesh.fromBuffer(new Float64Array(mesh._buffer), {
+            trustedBooleanInput: mesh._trustedBooleanInput,
+        });
     }
     static emptyMesh() {
-        return Mesh.fromBuffer(new Float64Array(0));
+        return Mesh.fromTrustedBuffer(new Float64Array(0));
     }
     // ── GPU-ready buffers ──────────────────────────────────────────
     /**
@@ -145,7 +158,10 @@ export class Mesh {
     }
     /** Number of triangular faces in this mesh */
     get faceCount() {
-        return this.indexBuffer.length / 3;
+        const start = 1 + this._vertexCount * 3;
+        if (this._buffer.length <= start)
+            return 0;
+        return Math.floor((this._buffer.length - start) / 3);
     }
     // ── High-level accessors (lazy) ────────────────────────────────
     /**
@@ -189,8 +205,14 @@ export class Mesh {
      * @param buffer - Float64Array in mesh buffer format
      * @returns New Mesh instance
      */
-    static fromBuffer(buffer) {
-        return new Mesh(buffer);
+    static fromBuffer(buffer, options) {
+        return new Mesh(buffer, options?.trustedBooleanInput ?? false);
+    }
+    static fromTrustedBuffer(buffer) {
+        return new Mesh(buffer, true);
+    }
+    get trustedBooleanInput() {
+        return this._trustedBooleanInput;
     }
     /**
      * Build an axis-aligned rectangle on a plane basis from opposite corners.
@@ -415,7 +437,7 @@ export class Mesh {
         ensureInit();
         const coords = pointsToCoords(pts);
         const buf = wasm.mesh_patch_from_points(coords);
-        return new Mesh(buf);
+        return Mesh.fromTrustedBuffer(buf);
     }
     /**
      * Create an axis-aligned box centered at origin.
@@ -426,7 +448,7 @@ export class Mesh {
      */
     static createBox(width, height, depth) {
         ensureInit();
-        return new Mesh(wasm.mesh_create_box(width, height, depth));
+        return Mesh.fromTrustedBuffer(wasm.mesh_create_box(width, height, depth));
     }
     /**
      * Create a UV sphere centered at origin.
@@ -437,7 +459,7 @@ export class Mesh {
      */
     static createSphere(radius, segments, rings) {
         ensureInit();
-        return new Mesh(wasm.mesh_create_sphere(radius, segments, rings));
+        return Mesh.fromTrustedBuffer(wasm.mesh_create_sphere(radius, segments, rings));
     }
     /**
      * Create a cylinder centered at origin with axis along Y.
@@ -448,7 +470,7 @@ export class Mesh {
      */
     static createCylinder(radius, height, segments) {
         ensureInit();
-        return new Mesh(wasm.mesh_create_cylinder(radius, height, segments));
+        return Mesh.fromTrustedBuffer(wasm.mesh_create_cylinder(radius, height, segments));
     }
     /**
      * Create a regular prism centered at origin.
@@ -459,7 +481,7 @@ export class Mesh {
      */
     static createPrism(radius, height, sides) {
         ensureInit();
-        return new Mesh(wasm.mesh_create_prism(radius, height, sides));
+        return Mesh.fromTrustedBuffer(wasm.mesh_create_prism(radius, height, sides));
     }
     /**
      * Create a cone centered at origin with apex at top.
@@ -470,7 +492,7 @@ export class Mesh {
      */
     static createCone(radius, height, segments) {
         ensureInit();
-        return new Mesh(wasm.mesh_create_cone(radius, height, segments));
+        return Mesh.fromTrustedBuffer(wasm.mesh_create_cone(radius, height, segments));
     }
     /**
      * Import a mesh from OBJ format string.
@@ -479,7 +501,7 @@ export class Mesh {
      */
     static fromOBJ(objString) {
         ensureInit();
-        return new Mesh(wasm.mesh_import_obj(objString));
+        return Mesh.fromTrustedBuffer(wasm.mesh_import_obj(objString));
     }
     /**
      * Loft through multiple circles to create a surface of revolution.
@@ -502,7 +524,7 @@ export class Mesh {
             data[off + 5] = c.normal?.z ?? 0;
             data[off + 6] = c.radius;
         }
-        return new Mesh(wasm.loft_circles(data, segments, caps));
+        return Mesh.fromTrustedBuffer(wasm.loft_circles(data, segments, caps));
     }
     /**
      * Loft through multiple polylines to create a ruled surface.
@@ -521,7 +543,7 @@ export class Mesh {
                 parts.push(p.x, p.y, p.z);
             }
         }
-        return new Mesh(wasm.loft_polylines(new Float64Array(parts), segments, caps));
+        return Mesh.fromTrustedBuffer(wasm.loft_polylines(new Float64Array(parts), segments, caps));
     }
     /**
      * Sweep a profile polyline along a path polyline.
@@ -532,7 +554,7 @@ export class Mesh {
      */
     static sweep(profilePoints, pathPoints, caps = false) {
         ensureInit();
-        return new Mesh(wasm.sweep_polylines(pointsToCoords(profilePoints), pointsToCoords(pathPoints), caps));
+        return Mesh.fromTrustedBuffer(wasm.sweep_polylines(pointsToCoords(profilePoints), pointsToCoords(pathPoints), caps));
     }
     /**
      * Compute a stable planar normal from ordered curve points.
@@ -550,7 +572,7 @@ export class Mesh {
     static extrudePlanarCurve(points, normal, height, closed) {
         ensureInit();
         const buf = wasm.mesh_extrude_planar_curve(pointsToCoords(points), normal.x, normal.y, normal.z, height, closed);
-        return Mesh.fromBuffer(buf);
+        return Mesh.fromTrustedBuffer(buf);
     }
     /**
      * Shift a closed cutter profile slightly opposite to travel direction and
@@ -583,7 +605,7 @@ export class Mesh {
         ensureInit();
         const profileData = Mesh.encodeCurve(profile);
         const pathData = Mesh.encodeCurve(path);
-        return new Mesh(wasm.sweep_curves(profileData, pathData, segments, segments, caps));
+        return Mesh.fromTrustedBuffer(wasm.sweep_curves(profileData, pathData, segments, segments, caps));
     }
     /** Encode a curve into the WASM format for sweep_curves. */
     static encodeCurve(curve) {
@@ -667,7 +689,7 @@ export class Mesh {
     static mergeMeshes(meshes) {
         ensureInit();
         const packed = Mesh.packMeshes(meshes);
-        return Mesh.fromBuffer(wasm.mesh_merge(packed));
+        return Mesh.fromTrustedBuffer(wasm.mesh_merge(packed));
     }
     /**
      * Raycast against many meshes and return all hits sorted by distance.
@@ -736,7 +758,7 @@ export class Mesh {
      */
     translate(offset) {
         ensureInit();
-        return new Mesh(wasm.mesh_translate(this._vertexCount, this._buffer, offset.x, offset.y, offset.z));
+        return Mesh.fromTrustedBuffer(wasm.mesh_translate(this._vertexCount, this._buffer, offset.x, offset.y, offset.z));
     }
     /**
      * Rotate this mesh around an axis.
@@ -753,7 +775,7 @@ export class Mesh {
                 .rotate(dir, angleRadians)
                 .translate(new Vec3(c.x, c.y, c.z));
         }
-        return new Mesh(wasm.mesh_rotate(this._vertexCount, this._buffer, axis.x, axis.y, axis.z, angleRadians));
+        return Mesh.fromTrustedBuffer(wasm.mesh_rotate(this._vertexCount, this._buffer, axis.x, axis.y, axis.z, angleRadians));
     }
     /**
      * Scale this mesh uniformly.
@@ -762,7 +784,7 @@ export class Mesh {
      */
     scale(factor) {
         ensureInit();
-        return new Mesh(wasm.mesh_scale(this._vertexCount, this._buffer, factor, factor, factor));
+        return Mesh.fromTrustedBuffer(wasm.mesh_scale(this._vertexCount, this._buffer, factor, factor, factor));
     }
     /**
      * Scale this mesh non-uniformly along each axis.
@@ -773,7 +795,7 @@ export class Mesh {
      */
     scaleXYZ(sx, sy, sz) {
         ensureInit();
-        return new Mesh(wasm.mesh_scale(this._vertexCount, this._buffer, sx, sy, sz));
+        return Mesh.fromTrustedBuffer(wasm.mesh_scale(this._vertexCount, this._buffer, sx, sy, sz));
     }
     runBoolean(other, operation, invoke, options) {
         const faceCountA = this.faceCount;
@@ -825,10 +847,17 @@ export class Mesh {
         if (!Number.isFinite(vertexCount) || vertexCount < 0) {
             throw new Error(`Boolean ${operation} failed and returned a corrupt mesh buffer.`);
         }
-        return Mesh.fromBuffer(result);
+        return Mesh.fromTrustedBuffer(result);
     }
-    static encodeBooleanOperationWithBackend(operation, _backend) {
-        return `${operation}@nextgen`;
+    static encodeBooleanOperationToken(operation, a, b, options) {
+        const tokens = [operation];
+        if (a._trustedBooleanInput && b._trustedBooleanInput) {
+            tokens.push("trustedInput");
+        }
+        if (options?.debugForceFaceID) {
+            tokens.push("forceFaceID");
+        }
+        return tokens.join("@");
     }
     // ── Booleans ───────────────────────────────────────────────────
     /**
@@ -839,7 +868,7 @@ export class Mesh {
      */
     union(other, options) {
         ensureInit();
-        const operationToken = Mesh.encodeBooleanOperationWithBackend("union", options?.backend);
+        const operationToken = Mesh.encodeBooleanOperationToken("union", this, other, options);
         return this.runBoolean(other, "union", () => wasm.mesh_boolean_operation(this._vertexCount, this._buffer, other._vertexCount, other._buffer, operationToken), options);
     }
     /**
@@ -850,7 +879,7 @@ export class Mesh {
      */
     subtract(other, options) {
         ensureInit();
-        const operationToken = Mesh.encodeBooleanOperationWithBackend("subtraction", options?.backend);
+        const operationToken = Mesh.encodeBooleanOperationToken("subtraction", this, other, options);
         return this.runBoolean(other, "subtraction", () => wasm.mesh_boolean_operation(this._vertexCount, this._buffer, other._vertexCount, other._buffer, operationToken), options);
     }
     /**
@@ -861,7 +890,7 @@ export class Mesh {
      */
     intersect(other, options) {
         ensureInit();
-        const operationToken = Mesh.encodeBooleanOperationWithBackend("intersection", options?.backend);
+        const operationToken = Mesh.encodeBooleanOperationToken("intersection", this, other, options);
         return this.runBoolean(other, "intersection", () => wasm.mesh_boolean_operation(this._vertexCount, this._buffer, other._vertexCount, other._buffer, operationToken), options);
     }
     /**
@@ -869,24 +898,24 @@ export class Mesh {
      * Defaults to allowUnsafe=true so high-poly jobs can run off the UI thread.
      */
     async unionAsync(other, options) {
-        const result = await runMeshBooleanInWorkerPool("union", this._buffer, other._buffer, options);
-        return Mesh.fromBuffer(result);
+        const result = await runMeshBooleanInWorkerPool("union", this._buffer, other._buffer, this._trustedBooleanInput, other._trustedBooleanInput, options);
+        return Mesh.fromTrustedBuffer(result);
     }
     /**
      * Compute boolean subtraction in a dedicated Web Worker (non-blocking).
      * Defaults to allowUnsafe=true so high-poly jobs can run off the UI thread.
      */
     async subtractAsync(other, options) {
-        const result = await runMeshBooleanInWorkerPool("subtraction", this._buffer, other._buffer, options);
-        return Mesh.fromBuffer(result);
+        const result = await runMeshBooleanInWorkerPool("subtraction", this._buffer, other._buffer, this._trustedBooleanInput, other._trustedBooleanInput, options);
+        return Mesh.fromTrustedBuffer(result);
     }
     /**
      * Compute boolean intersection in a dedicated Web Worker (non-blocking).
      * Defaults to allowUnsafe=true so high-poly jobs can run off the UI thread.
      */
     async intersectAsync(other, options) {
-        const result = await runMeshBooleanInWorkerPool("intersection", this._buffer, other._buffer, options);
-        return Mesh.fromBuffer(result);
+        const result = await runMeshBooleanInWorkerPool("intersection", this._buffer, other._buffer, this._trustedBooleanInput, other._trustedBooleanInput, options);
+        return Mesh.fromTrustedBuffer(result);
     }
     // ── Intersection queries ───────────────────────────────────────
     /**
@@ -916,7 +945,7 @@ export class Mesh {
      */
     applyMatrix(matrix) {
         ensureInit();
-        return new Mesh(wasm.mesh_apply_matrix(this._vertexCount, this._buffer, new Float64Array(matrix)));
+        return Mesh.fromTrustedBuffer(wasm.mesh_apply_matrix(this._vertexCount, this._buffer, new Float64Array(matrix)));
     }
     /**
      * Evaluate a point on the mesh surface at parametric coordinates.
@@ -1098,17 +1127,60 @@ export class Mesh {
     extrudeFace(faceIndex, distance) {
         ensureInit();
         if (!Number.isFinite(faceIndex) || faceIndex < 0) {
-            return Mesh.fromBuffer(new Float64Array(this._buffer));
+            return Mesh.fromBuffer(new Float64Array(this._buffer), {
+                trustedBooleanInput: this._trustedBooleanInput,
+            });
         }
-        return Mesh.fromBuffer(wasm.mesh_extrude_face(this._vertexCount, this._buffer, Math.floor(faceIndex), distance));
+        return Mesh.fromTrustedBuffer(wasm.mesh_extrude_face(this._vertexCount, this._buffer, Math.floor(faceIndex), distance));
     }
     /**
      * Check if this triangulated mesh represents a closed volume.
      * Returns true when no welded topological boundary edges are found.
      */
     isClosedVolume() {
+        if (this._isClosedVolumeCache !== null) {
+            return this._isClosedVolumeCache;
+        }
+        if (this._topologyMetricsCache) {
+            const closedFromMetrics = this._topologyMetricsCache.boundaryEdges === 0;
+            this._isClosedVolumeCache = closedFromMetrics;
+            return closedFromMetrics;
+        }
+        ensureInit();
+        if (this.faceCount >= Mesh.TOPOLOGY_METRICS_CACHE_FACE_THRESHOLD) {
+            const metrics = this.topologyMetrics();
+            const closedFromMetrics = metrics.boundaryEdges === 0;
+            this._isClosedVolumeCache = closedFromMetrics;
+            return closedFromMetrics;
+        }
+        const closed = wasm.mesh_is_closed_volume(this._vertexCount, this._buffer);
+        this._isClosedVolumeCache = closed;
+        return closed;
+    }
+    /**
+     * Return welded-edge topology metrics for this triangulated mesh.
+     * `boundaryEdges`: edges referenced by exactly one triangle.
+     * `nonManifoldEdges`: edges referenced by more than two triangles.
+     */
+    topologyMetrics() {
+        if (this._topologyMetricsCache) {
+            return {
+                boundaryEdges: this._topologyMetricsCache.boundaryEdges,
+                nonManifoldEdges: this._topologyMetricsCache.nonManifoldEdges,
+            };
+        }
         ensureInit();
-        return wasm.mesh_is_closed_volume(this._vertexCount, this._buffer);
+        const metrics = mesh_topology_metrics(this._vertexCount, this._buffer);
+        const boundaryEdges = Math.floor(metrics[0] ?? 0);
+        const nonManifoldEdges = Math.floor(metrics[1] ?? 0);
+        this._topologyMetricsCache = { boundaryEdges, nonManifoldEdges };
+        if (this._isClosedVolumeCache === null) {
+            this._isClosedVolumeCache = boundaryEdges === 0;
+        }
+        return {
+            boundaryEdges,
+            nonManifoldEdges,
+        };
     }
     /**
      * Odd/even point containment test against a closed mesh.
@@ -1162,4 +1234,5 @@ Mesh.DEFAULT_BOOLEAN_LIMITS = {
     maxCombinedInputFaces: 180000,
     maxFaceProduct: 500000000,
 };
+Mesh.TOPOLOGY_METRICS_CACHE_FACE_THRESHOLD = 20000;
 //# sourceMappingURL=Mesh.js.map