okgeometry-api 0.4.3 → 0.4.5

package/dist/mesh-boolean.protocol.d.ts

@@ -0,0 +1,85 @@
+export type MeshBooleanOperation = "union" | "subtraction" | "intersection";
+export interface MeshBooleanLimits {
+    maxInputFacesPerMesh: number;
+    maxCombinedInputFaces: number;
+    maxFaceProduct: number;
+}
+export interface MeshBooleanOptions {
+    /**
+     * Override one or more safety limits for this operation.
+     */
+    limits?: Partial<MeshBooleanLimits>;
+    /**
+     * Skip safety limits and force boolean execution.
+     */
+    allowUnsafe?: boolean;
+}
+export type MeshBooleanErrorCode = "worker_unavailable" | "worker_crashed" | "worker_protocol" | "worker_aborted" | "worker_timeout" | "kernel_error";
+export interface MeshBooleanErrorPayload {
+    code: MeshBooleanErrorCode;
+    message: string;
+    details?: string;
+}
+export type MeshBooleanJobStage = "queued" | "running" | "completed";
+export interface MeshBooleanProgressEvent {
+    stage: MeshBooleanJobStage;
+    jobId: number;
+    workerId?: number;
+    queueSize: number;
+}
+export interface MeshBooleanAsyncOptions extends MeshBooleanOptions {
+    /**
+     * Abort the worker job when this signal is aborted.
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional timeout in milliseconds.
+     */
+    timeoutMs?: number;
+    /**
+     * Optional custom worker factory (for app-level worker pooling/reuse).
+     */
+    workerFactory?: () => Worker;
+    /**
+     * Override worker pool size for this call.
+     */
+    poolSize?: number;
+    /**
+     * Observe coarse-grained job stage changes.
+     */
+    onProgress?: (event: MeshBooleanProgressEvent) => void;
+}
+export interface MeshBooleanWorkerRequest {
+    kind: "mesh-boolean-request";
+    jobId: number;
+    operation: MeshBooleanOperation;
+    bufferA: ArrayBuffer;
+    bufferB: ArrayBuffer;
+    options: MeshBooleanOptions;
+}
+export interface MeshBooleanWorkerCancel {
+    kind: "mesh-boolean-cancel";
+    jobId: number;
+}
+export type MeshBooleanWorkerInbound = MeshBooleanWorkerRequest | MeshBooleanWorkerCancel;
+export interface MeshBooleanWorkerSuccessResponse {
+    kind: "mesh-boolean-result";
+    jobId: number;
+    ok: true;
+    buffer: ArrayBuffer;
+    elapsedMs: number;
+}
+export interface MeshBooleanWorkerErrorResponse {
+    kind: "mesh-boolean-result";
+    jobId: number;
+    ok: false;
+    error: MeshBooleanErrorPayload;
+    elapsedMs: number;
+}
+export type MeshBooleanWorkerResponse = MeshBooleanWorkerSuccessResponse | MeshBooleanWorkerErrorResponse;
+export declare class MeshBooleanExecutionError extends Error {
+    readonly code: MeshBooleanErrorCode;
+    readonly details?: string;
+    constructor(payload: MeshBooleanErrorPayload);
+}
+//# sourceMappingURL=mesh-boolean.protocol.d.ts.map

package/dist/mesh-boolean.protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-boolean.protocol.d.ts","sourceRoot":"","sources":["../src/mesh-boolean.protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAC5B,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,GAAG,uBAAuB,CAAC;AAE1F,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,yBAAyB,GAAG,gCAAgC,GAAG,8BAA8B,CAAC;AAE1G,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,uBAAuB;CAM7C"}

package/dist/mesh-boolean.protocol.js

@@ -0,0 +1,9 @@
+export class MeshBooleanExecutionError extends Error {
+    constructor(payload) {
+        super(payload.message);
+        this.name = "MeshBooleanExecutionError";
+        this.code = payload.code;
+        this.details = payload.details;
+    }
+}
+//# sourceMappingURL=mesh-boolean.protocol.js.map

package/dist/mesh-boolean.protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-boolean.protocol.js","sourceRoot":"","sources":["../src/mesh-boolean.protocol.ts"],"names":[],"mappings":"AAmGA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAIlD,YAAY,OAAgC;QAC1C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF"}

package/dist/mesh-boolean.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mesh-boolean.worker.d.ts.map

package/dist/mesh-boolean.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-boolean.worker.d.ts","sourceRoot":"","sources":["../src/mesh-boolean.worker.ts"],"names":[],"mappings":"AAgIA,OAAO,EAAE,CAAC"}

package/dist/mesh-boolean.worker.js

@@ -0,0 +1,105 @@
+import { init, isInitialized } from "./engine.js";
+import { Mesh } from "./Mesh.js";
+const workerScope = self;
+const cancelledJobs = new Set();
+let initPromise = null;
+function nowMs() {
+    if (typeof performance !== "undefined" && typeof performance.now === "function") {
+        return performance.now();
+    }
+    return Date.now();
+}
+function toErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    return String(error);
+}
+function makeError(code, message, details) {
+    return { code, message, details };
+}
+function postError(jobId, startedAt, payload) {
+    const response = {
+        kind: "mesh-boolean-result",
+        jobId,
+        ok: false,
+        error: payload,
+        elapsedMs: Math.max(0, nowMs() - startedAt),
+    };
+    workerScope.postMessage(response);
+}
+function postSuccess(jobId, startedAt, buffer) {
+    const response = {
+        kind: "mesh-boolean-result",
+        jobId,
+        ok: true,
+        buffer,
+        elapsedMs: Math.max(0, nowMs() - startedAt),
+    };
+    workerScope.postMessage(response, [buffer]);
+}
+async function ensureWorkerInit() {
+    if (isInitialized())
+        return;
+    if (!initPromise) {
+        initPromise = init();
+    }
+    await initPromise;
+}
+workerScope.addEventListener("message", async (event) => {
+    const message = event.data;
+    if (!message)
+        return;
+    if (message.kind === "mesh-boolean-cancel") {
+        cancelledJobs.add(message.jobId);
+        return;
+    }
+    if (message.kind !== "mesh-boolean-request")
+        return;
+    const startedAt = nowMs();
+    const jobId = message.jobId;
+    if (cancelledJobs.has(jobId)) {
+        postError(jobId, startedAt, makeError("worker_aborted", `Boolean ${message.operation} aborted.`));
+        cancelledJobs.delete(jobId);
+        return;
+    }
+    try {
+        await ensureWorkerInit();
+        if (cancelledJobs.has(jobId)) {
+            postError(jobId, startedAt, makeError("worker_aborted", `Boolean ${message.operation} aborted.`));
+            cancelledJobs.delete(jobId);
+            return;
+        }
+        const meshA = Mesh.fromBuffer(new Float64Array(message.bufferA));
+        const meshB = Mesh.fromBuffer(new Float64Array(message.bufferB));
+        const options = {
+            allowUnsafe: message.options.allowUnsafe ?? true,
+            limits: message.options.limits,
+        };
+        let result;
+        if (message.operation === "union") {
+            result = meshA.union(meshB, options);
+        }
+        else if (message.operation === "subtraction") {
+            result = meshA.subtract(meshB, options);
+        }
+        else {
+            result = meshA.intersect(meshB, options);
+        }
+        if (cancelledJobs.has(jobId)) {
+            postError(jobId, startedAt, makeError("worker_aborted", `Boolean ${message.operation} aborted.`));
+            cancelledJobs.delete(jobId);
+            return;
+        }
+        const payload = new Float64Array(result.rawBuffer);
+        postSuccess(jobId, startedAt, payload.buffer);
+    }
+    catch (error) {
+        postError(jobId, startedAt, makeError("kernel_error", `Boolean ${message.operation} failed.`, toErrorMessage(error)));
+    }
+    finally {
+        cancelledJobs.delete(jobId);
+    }
+});
+//# sourceMappingURL=mesh-boolean.worker.js.map

package/dist/mesh-boolean.worker.js.map

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