okgeometry-api 0.4.4 → 0.4.5

package/dist/Mesh.d.ts

@@ -3,6 +3,10 @@ import { Vec3 } from "./Vec3.js";
 import { Plane } from "./Plane.js";
 import { Polyline } from "./Polyline.js";
 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, MeshBooleanLimits, MeshBooleanOptions, MeshBooleanErrorCode, MeshBooleanErrorPayload, MeshBooleanProgressEvent, } from "./mesh-boolean.protocol.js";
 export interface PlanarRectangle {
     corners: [Point, Point, Point, Point];
     width: number;
@@ -12,6 +16,14 @@ export interface PlanarCircle {
     points: Point[];
     radius: number;
 }
+export interface PlanarArc {
+    points: Point[];
+    center: Point;
+    radius: number;
+    startAngle: number;
+    endAngle: number;
+    sweepAngle: number;
+}
 /**
  * Buffer-backed triangle mesh with GPU-ready accessors.
  * All geometry lives in a Float64Array from WASM.
@@ -21,12 +33,28 @@ export interface PlanarCircle {
 export declare class Mesh {
     private _buffer;
     private _vertexCount;
+    private static readonly DEFAULT_BOOLEAN_LIMITS;
     private _positionBuffer;
     private _indexBuffer;
     private _vertices;
     private _faces;
     private _edgeVertexPairs;
     private constructor();
+    /**
+     * Configure default size for the shared boolean worker pool.
+     */
+    static configureBooleanWorkerPool(options: {
+        size: number;
+    }): void;
+    /**
+     * Dispose all shared boolean worker pools.
+     */
+    static disposeBooleanWorkerPools(): void;
+    private static resolveBooleanLimits;
+    private static computeRawBounds;
+    private static boundsOverlap;
+    private static cloneMesh;
+    private static emptyMesh;
     /**
      * Float32 xyz positions for Three.js BufferGeometry.
      * Lazy-computed and cached.
@@ -70,6 +98,22 @@ export declare class Mesh {
      * Radius is measured in the plane orthogonal to `normal`.
      */
     static buildPlanarCircle(center: Point, radiusPoint: Point, normal: Vec3, segments?: number): PlanarCircle;
+    /**
+     * Build a planar arc from center, start, and end points.
+     * Uses the shortest signed sweep between start and end around `normal`.
+     */
+    static buildPlanarArcCenterStartEnd(center: Point, startPoint: Point, endPoint: Point, normal: Vec3, segments?: number): PlanarArc;
+    /**
+     * Build a planar arc from start/end points and a radius control point.
+     * Radius is measured from start point to radiusPoint in the active plane.
+     * The best of 4 candidates (2 centers x minor/major sweeps) is selected by
+     * midpoint proximity to radiusPoint.
+     */
+    static buildPlanarArcStartEndRadius(startPoint: Point, endPoint: Point, radiusPoint: Point, normal: Vec3, segments?: number): PlanarArc | null;
+    private static resolveArcBasis;
+    private static angleOnBasis;
+    private static normalizeSignedAngle;
+    private static projectPointToPlane;
     /**
      * Create a planar patch mesh from boundary points using CDT (Constrained Delaunay Triangulation).
      * Correctly handles both convex and concave polygons.
@@ -229,24 +273,43 @@ export declare class Mesh {
      * @returns New scaled mesh
      */
     scaleXYZ(sx: number, sy: number, sz: number): Mesh;
+    private runBoolean;
     /**
      * Compute boolean union with another mesh.
      * @param other - Mesh to union with
+     * @param options - Optional safety overrides
      * @returns New mesh containing volume of both inputs
      */
-    union(other: Mesh): Mesh;
+    union(other: Mesh, options?: MeshBooleanOptions): Mesh;
     /**
      * Compute boolean subtraction with another mesh.
      * @param other - Mesh to subtract
+     * @param options - Optional safety overrides
      * @returns New mesh with other's volume removed from this
      */
-    subtract(other: Mesh): Mesh;
+    subtract(other: Mesh, options?: MeshBooleanOptions): Mesh;
     /**
      * Compute boolean intersection with another mesh.
      * @param other - Mesh to intersect with
+     * @param options - Optional safety overrides
      * @returns New mesh containing only the overlapping volume
      */
-    intersect(other: Mesh): Mesh;
+    intersect(other: Mesh, options?: MeshBooleanOptions): Mesh;
+    /**
+     * Compute boolean union in a dedicated Web Worker (non-blocking).
+     * Defaults to allowUnsafe=true so high-poly jobs can run off the UI thread.
+     */
+    unionAsync(other: Mesh, options?: MeshBooleanAsyncOptions): Promise<Mesh>;
+    /**
+     * Compute boolean subtraction in a dedicated Web Worker (non-blocking).
+     * Defaults to allowUnsafe=true so high-poly jobs can run off the UI thread.
+     */
+    subtractAsync(other: Mesh, options?: MeshBooleanAsyncOptions): Promise<Mesh>;
+    /**
+     * Compute boolean intersection in a dedicated Web Worker (non-blocking).
+     * Defaults to allowUnsafe=true so high-poly jobs can run off the UI thread.
+     */
+    intersectAsync(other: Mesh, options?: MeshBooleanAsyncOptions): Promise<Mesh>;
     /**
      * Compute intersection curves with a plane.
      * @param plane - Cutting plane

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

@@ -9,7 +9,10 @@ import { Polygon } from "./Polygon.js";
 import { NurbsCurve } from "./NurbsCurve.js";
 import { PolyCurve } from "./PolyCurve.js";
 import { pointsToCoords, parsePolylineBuffer as parsePolylineBuf } from "./BufferCodec.js";
+import { configureDefaultMeshBooleanWorkerPool, disposeMeshBooleanWorkerPools, runMeshBooleanInWorkerPool, } from "./mesh-boolean.pool.js";
+import { MeshBooleanExecutionError } from "./mesh-boolean.protocol.js";
 import * as wasm from "../wasm/okgeometrycore_bg.js";
+export { MeshBooleanExecutionError };
 /**
  * Buffer-backed triangle mesh with GPU-ready accessors.
  * All geometry lives in a Float64Array from WASM.
@@ -27,6 +30,72 @@ export class Mesh {
         this._buffer = buffer;
         this._vertexCount = buffer.length > 0 ? buffer[0] : 0;
     }
+    /**
+     * Configure default size for the shared boolean worker pool.
+     */
+    static configureBooleanWorkerPool(options) {
+        configureDefaultMeshBooleanWorkerPool(options);
+    }
+    /**
+     * Dispose all shared boolean worker pools.
+     */
+    static disposeBooleanWorkerPools() {
+        disposeMeshBooleanWorkerPools();
+    }
+    static resolveBooleanLimits(overrides) {
+        const defaults = Mesh.DEFAULT_BOOLEAN_LIMITS;
+        return {
+            maxInputFacesPerMesh: overrides?.maxInputFacesPerMesh ?? defaults.maxInputFacesPerMesh,
+            maxCombinedInputFaces: overrides?.maxCombinedInputFaces ?? defaults.maxCombinedInputFaces,
+            maxFaceProduct: overrides?.maxFaceProduct ?? defaults.maxFaceProduct,
+        };
+    }
+    static computeRawBounds(mesh) {
+        if (mesh._vertexCount <= 0)
+            return null;
+        const data = mesh._buffer;
+        const limit = 1 + mesh._vertexCount * 3;
+        let minX = data[1];
+        let minY = data[2];
+        let minZ = data[3];
+        let maxX = minX;
+        let maxY = minY;
+        let maxZ = minZ;
+        for (let i = 4; i < limit; i += 3) {
+            const x = data[i];
+            const y = data[i + 1];
+            const z = data[i + 2];
+            if (x < minX)
+                minX = x;
+            if (y < minY)
+                minY = y;
+            if (z < minZ)
+                minZ = z;
+            if (x > maxX)
+                maxX = x;
+            if (y > maxY)
+                maxY = y;
+            if (z > maxZ)
+                maxZ = z;
+        }
+        return { minX, minY, minZ, maxX, maxY, maxZ };
+    }
+    static boundsOverlap(a, b, eps = 1e-9) {
+        if (!a || !b)
+            return false;
+        return a.minX <= b.maxX + eps
+            && a.maxX + eps >= b.minX
+            && a.minY <= b.maxY + eps
+            && a.maxY + eps >= b.minY
+            && a.minZ <= b.maxZ + eps
+            && a.maxZ + eps >= b.minZ;
+    }
+    static cloneMesh(mesh) {
+        return Mesh.fromBuffer(new Float64Array(mesh._buffer));
+    }
+    static emptyMesh() {
+        return Mesh.fromBuffer(new Float64Array(0));
+    }
     // ── GPU-ready buffers ──────────────────────────────────────────
     /**
      * Float32 xyz positions for Three.js BufferGeometry.
@@ -146,6 +215,190 @@ export class Mesh {
             radius,
         };
     }
+    /**
+     * Build a planar arc from center, start, and end points.
+     * Uses the shortest signed sweep between start and end around `normal`.
+     */
+    static buildPlanarArcCenterStartEnd(center, startPoint, endPoint, normal, segments = 64) {
+        const n = normal.normalize();
+        const minSegments = Math.max(2, Math.floor(segments));
+        const startRaw = startPoint.sub(center);
+        const endRaw = endPoint.sub(center);
+        const startVec = startRaw.sub(n.scale(startRaw.dot(n)));
+        const endVec = endRaw.sub(n.scale(endRaw.dot(n)));
+        const radius = startVec.length();
+        const endLen = endVec.length();
+        if (radius < 1e-12 || endLen < 1e-12) {
+            return {
+                points: [],
+                center,
+                radius: 0,
+                startAngle: 0,
+                endAngle: 0,
+                sweepAngle: 0,
+            };
+        }
+        const basis = Mesh.resolveArcBasis(center, radius, n);
+        const startAngle = Mesh.angleOnBasis(startVec, basis.uAxis, basis.vAxis);
+        const endAngleRaw = Mesh.angleOnBasis(endVec.scale(radius / endLen), basis.uAxis, basis.vAxis);
+        const sweepAngle = Mesh.normalizeSignedAngle(endAngleRaw - startAngle);
+        if (Math.abs(sweepAngle) < 1e-9) {
+            return {
+                points: [],
+                center,
+                radius: 0,
+                startAngle: 0,
+                endAngle: 0,
+                sweepAngle: 0,
+            };
+        }
+        const endAngle = startAngle + sweepAngle;
+        const arc = new Arc(center, radius, startAngle, endAngle, n);
+        return {
+            points: arc.sample(minSegments),
+            center,
+            radius,
+            startAngle,
+            endAngle,
+            sweepAngle,
+        };
+    }
+    /**
+     * Build a planar arc from start/end points and a radius control point.
+     * Radius is measured from start point to radiusPoint in the active plane.
+     * The best of 4 candidates (2 centers x minor/major sweeps) is selected by
+     * midpoint proximity to radiusPoint.
+     */
+    static buildPlanarArcStartEndRadius(startPoint, endPoint, radiusPoint, normal, segments = 64) {
+        const n = normal.normalize();
+        const minSegments = Math.max(2, Math.floor(segments));
+        const start = Mesh.projectPointToPlane(startPoint, startPoint, n);
+        const end = Mesh.projectPointToPlane(endPoint, startPoint, n);
+        const guide = Mesh.projectPointToPlane(radiusPoint, startPoint, n);
+        const chord = end.sub(start);
+        const chordLength = chord.length();
+        if (chordLength < 1e-9) {
+            return null;
+        }
+        const radius = guide.sub(start).length();
+        const halfChord = chordLength * 0.5;
+        if (!Number.isFinite(radius) || radius < halfChord + 1e-9) {
+            return null;
+        }
+        const chordDir = chord.scale(1 / chordLength);
+        const perpRaw = n.cross(chordDir);
+        const perpLen = perpRaw.length();
+        if (perpLen < 1e-12) {
+            return null;
+        }
+        const perp = perpRaw.scale(1 / perpLen);
+        const hSq = radius * radius - halfChord * halfChord;
+        if (hSq < 0) {
+            return null;
+        }
+        const h = Math.sqrt(Math.max(0, hSq));
+        const mid = start.add(chord.scale(0.5));
+        const centers = [mid.add(perp.scale(h)), mid.add(perp.scale(-h))];
+        const candidates = [];
+        for (const center of centers) {
+            const startVec = start.sub(center);
+            const endVec = end.sub(center);
+            if (startVec.length() < 1e-12 || endVec.length() < 1e-12) {
+                continue;
+            }
+            const basis = Mesh.resolveArcBasis(center, radius, n);
+            const startAngle = Mesh.angleOnBasis(startVec, basis.uAxis, basis.vAxis);
+            const endAngleRaw = Mesh.angleOnBasis(endVec, basis.uAxis, basis.vAxis);
+            const minorSweep = Mesh.normalizeSignedAngle(endAngleRaw - startAngle);
+            if (Math.abs(minorSweep) < 1e-9) {
+                continue;
+            }
+            const majorSweep = minorSweep > 0
+                ? minorSweep - Math.PI * 2
+                : minorSweep + Math.PI * 2;
+            const sweepOptions = [minorSweep];
+            if (Math.abs(majorSweep) > 1e-9) {
+                sweepOptions.push(majorSweep);
+            }
+            for (const sweepAngle of sweepOptions) {
+                const endAngle = startAngle + sweepAngle;
+                const arc = new Arc(center, radius, startAngle, endAngle, n);
+                const midPoint = arc.pointAt(0.5);
+                candidates.push({
+                    center,
+                    radius,
+                    startAngle,
+                    endAngle,
+                    sweepAngle,
+                    points: arc.sample(minSegments),
+                    score: midPoint.distanceTo(guide),
+                });
+            }
+        }
+        if (candidates.length === 0) {
+            return null;
+        }
+        candidates.sort((a, b) => a.score - b.score);
+        const winner = candidates[0];
+        return {
+            points: winner.points,
+            center: winner.center,
+            radius: winner.radius,
+            startAngle: winner.startAngle,
+            endAngle: winner.endAngle,
+            sweepAngle: winner.sweepAngle,
+        };
+    }
+    static resolveArcBasis(center, radius, normal) {
+        if (radius > 1e-12) {
+            const circle = new Circle(center, radius, normal);
+            const p0 = circle.pointAt(0);
+            const pQuarter = circle.pointAt(0.25);
+            const uRaw = p0.sub(center);
+            const vRaw = pQuarter.sub(center);
+            const uLen = uRaw.length();
+            const vLen = vRaw.length();
+            if (uLen > 1e-12 && vLen > 1e-12) {
+                return {
+                    uAxis: uRaw.scale(1 / uLen),
+                    vAxis: vRaw.scale(1 / vLen),
+                };
+            }
+        }
+        const n = normal.normalize();
+        const reference = Math.abs(n.z) < 0.9 ? Vec3.Z : Vec3.X;
+        const uRaw = n.cross(reference);
+        const uLen = uRaw.length();
+        if (uLen < 1e-12) {
+            return { uAxis: Vec3.X, vAxis: Vec3.Y };
+        }
+        const uAxis = uRaw.scale(1 / uLen);
+        const vRaw = n.cross(uAxis);
+        const vLen = vRaw.length();
+        if (vLen < 1e-12) {
+            return { uAxis, vAxis: Vec3.Y };
+        }
+        return { uAxis, vAxis: vRaw.scale(1 / vLen) };
+    }
+    static angleOnBasis(vector, uAxis, vAxis) {
+        return Math.atan2(vector.dot(vAxis), vector.dot(uAxis));
+    }
+    static normalizeSignedAngle(angle) {
+        const twoPi = Math.PI * 2;
+        let wrapped = angle % twoPi;
+        if (wrapped <= -Math.PI) {
+            wrapped += twoPi;
+        }
+        else if (wrapped > Math.PI) {
+            wrapped -= twoPi;
+        }
+        return wrapped;
+    }
+    static projectPointToPlane(point, planeOrigin, planeNormal) {
+        const offset = point.sub(planeOrigin);
+        const projected = offset.sub(planeNormal.scale(offset.dot(planeNormal)));
+        return planeOrigin.add(projected);
+    }
     /**
      * Create a planar patch mesh from boundary points using CDT (Constrained Delaunay Triangulation).
      * Correctly handles both convex and concave polygons.
@@ -516,33 +769,107 @@ export class Mesh {
         ensureInit();
         return new Mesh(wasm.mesh_scale(this._vertexCount, this._buffer, sx, sy, sz));
     }
+    runBoolean(other, operation, invoke, options) {
+        const faceCountA = this.faceCount;
+        const faceCountB = other.faceCount;
+        if (operation === "union") {
+            if (faceCountA === 0)
+                return Mesh.cloneMesh(other);
+            if (faceCountB === 0)
+                return Mesh.cloneMesh(this);
+        }
+        else if (operation === "intersection") {
+            if (faceCountA === 0 || faceCountB === 0)
+                return Mesh.emptyMesh();
+        }
+        else {
+            if (faceCountA === 0)
+                return Mesh.emptyMesh();
+            if (faceCountB === 0)
+                return Mesh.cloneMesh(this);
+        }
+        const boundsA = Mesh.computeRawBounds(this);
+        const boundsB = Mesh.computeRawBounds(other);
+        if (!Mesh.boundsOverlap(boundsA, boundsB)) {
+            if (operation === "union")
+                return Mesh.mergeMeshes([this, other]);
+            if (operation === "intersection")
+                return Mesh.emptyMesh();
+            return Mesh.cloneMesh(this);
+        }
+        if (!options?.allowUnsafe) {
+            const limits = Mesh.resolveBooleanLimits(options?.limits);
+            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(`Boolean ${operation} blocked by safety limits `
+                    + `(A faces=${faceCountA}, B faces=${faceCountB}, faceProduct=${faceProduct}). `
+                    + "Simplify inputs, run in a Worker, or pass allowUnsafe: true to force execution.");
+            }
+        }
+        const result = invoke();
+        if (operation === "union" && result.length === 0) {
+            throw new Error("Boolean union failed and returned an empty mesh buffer.");
+        }
+        return Mesh.fromBuffer(result);
+    }
     // ── Booleans ───────────────────────────────────────────────────
     /**
      * Compute boolean union with another mesh.
      * @param other - Mesh to union with
+     * @param options - Optional safety overrides
      * @returns New mesh containing volume of both inputs
      */
-    union(other) {
+    union(other, options) {
         ensureInit();
-        return new Mesh(wasm.mesh_boolean_union(this._vertexCount, this._buffer, other._vertexCount, other._buffer));
+        return this.runBoolean(other, "union", () => wasm.mesh_boolean_union(this._vertexCount, this._buffer, other._vertexCount, other._buffer), options);
     }
     /**
      * Compute boolean subtraction with another mesh.
      * @param other - Mesh to subtract
+     * @param options - Optional safety overrides
      * @returns New mesh with other's volume removed from this
      */
-    subtract(other) {
+    subtract(other, options) {
         ensureInit();
-        return new Mesh(wasm.mesh_boolean_subtraction(this._vertexCount, this._buffer, other._vertexCount, other._buffer));
+        return this.runBoolean(other, "subtraction", () => wasm.mesh_boolean_subtraction(this._vertexCount, this._buffer, other._vertexCount, other._buffer), options);
     }
     /**
      * Compute boolean intersection with another mesh.
      * @param other - Mesh to intersect with
+     * @param options - Optional safety overrides
      * @returns New mesh containing only the overlapping volume
      */
-    intersect(other) {
+    intersect(other, options) {
         ensureInit();
-        return new Mesh(wasm.mesh_boolean_intersection(this._vertexCount, this._buffer, other._vertexCount, other._buffer));
+        return this.runBoolean(other, "intersection", () => wasm.mesh_boolean_intersection(this._vertexCount, this._buffer, other._vertexCount, other._buffer), options);
+    }
+    /**
+     * Compute boolean union in a dedicated Web Worker (non-blocking).
+     * 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);
+    }
+    /**
+     * 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);
+    }
+    /**
+     * 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);
     }
     // ── Intersection queries ───────────────────────────────────────
     /**
@@ -813,4 +1140,9 @@ export class Mesh {
         return wasm.mesh_export_obj(this._vertexCount, this._buffer);
     }
 }
+Mesh.DEFAULT_BOOLEAN_LIMITS = {
+    maxInputFacesPerMesh: 120000,
+    maxCombinedInputFaces: 180000,
+    maxFaceProduct: 500000000,
+};
 //# sourceMappingURL=Mesh.js.map