@aura3d/addons 0.0.0-stage → 5.0.0

package/dist/utils/WorkerPool.js

@@ -0,0 +1,360 @@
+export class WorkerPoolError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "WorkerPoolError";
+    }
+}
+/**
+ * Bounded, opt-in processing pool. Exactly one task is sent to each worker at a
+ * time. Cancelling an executing task terminates its worker, so CPU-bound work
+ * that cannot process a cancel message cannot retain a slot indefinitely. A new
+ * worker is created for the next task. Queued tasks are removed without sending
+ * or transferring their payloads.
+ */
+export class WorkerPool {
+    createWorker;
+    size;
+    maxQueue;
+    workers = new Set();
+    queue = [];
+    nextId = 1;
+    disposed = false;
+    creating = 0;
+    draining = false;
+    constructor(options) {
+        if (!Number.isSafeInteger(options.size) || options.size < 1) {
+            throw new RangeError("WorkerPool size must be a positive safe integer");
+        }
+        const maxQueue = options.maxQueue ?? 64;
+        if (!Number.isSafeInteger(maxQueue) || maxQueue < 0) {
+            throw new RangeError("WorkerPool maxQueue must be a non-negative safe integer");
+        }
+        if (typeof options.createWorker !== "function")
+            throw new TypeError("WorkerPool requires a worker factory");
+        this.createWorker = options.createWorker;
+        this.size = options.size;
+        this.maxQueue = maxQueue;
+    }
+    get workerCount() { return this.workers.size; }
+    get pendingCount() { return this.queue.length; }
+    get activeCount() {
+        let count = 0;
+        for (const slot of this.workers)
+            if (slot.active)
+                count++;
+        return count;
+    }
+    run(payload, options = {}) {
+        if (this.disposed)
+            return Promise.reject(disposedError());
+        if (options.signal?.aborted)
+            return Promise.reject(abortError());
+        if (this.nextId > Number.MAX_SAFE_INTEGER)
+            return Promise.reject(new RangeError("WorkerPool request IDs exhausted"));
+        // Waiting tasks reserve either an available execution slot or a queue slot.
+        // Counting the queue is essential while a factory is running: it may call
+        // run() synchronously, before drain() can open the remaining workers.
+        const outstanding = this.activeCount + this.creating + this.queue.length;
+        if (outstanding >= this.size + this.maxQueue) {
+            return Promise.reject(new WorkerPoolError("queue-full", "WorkerPool waiting queue is full"));
+        }
+        return new Promise((resolve, reject) => {
+            const task = {
+                id: this.nextId++, payload, transfer: [...(options.transfer ?? [])], resolve, reject,
+                signal: options.signal, settled: false
+            };
+            if (task.signal) {
+                task.abort = () => this.cancel(task);
+                task.signal.addEventListener("abort", task.abort, { once: true });
+            }
+            this.queue.push(task);
+            if (task.signal?.aborted)
+                this.cancel(task);
+            else
+                this.drain();
+        });
+    }
+    /** Rejects all work, removes listeners and terminates every owned worker. Idempotent. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const task of this.queue.splice(0))
+            this.reject(task, disposedError());
+        for (const slot of [...this.workers]) {
+            if (slot.active)
+                this.reject(slot.active, disposedError());
+            this.retire(slot);
+        }
+    }
+    drain() {
+        if (this.draining)
+            return;
+        this.draining = true;
+        try {
+            while (!this.disposed && this.queue.length > 0) {
+                let slot = [...this.workers].find((candidate) => !candidate.active);
+                if (!slot && this.workers.size + this.creating >= this.size)
+                    return;
+                const task = this.queue.shift();
+                if (!slot) {
+                    this.creating++;
+                    try {
+                        slot = this.openWorker();
+                    }
+                    catch (error) {
+                        this.reject(task, workerError("WorkerPool could not create a worker", error));
+                        continue;
+                    }
+                    finally {
+                        this.creating--;
+                    }
+                }
+                if (this.disposed || task.settled) {
+                    // A supplied factory can synchronously dispose the pool or abort work.
+                    if (this.disposed) {
+                        this.reject(task, disposedError());
+                        this.retire(slot);
+                    }
+                    continue;
+                }
+                slot.active = task;
+                try {
+                    slot.worker.postMessage({ type: "task", id: task.id, payload: task.payload }, task.transfer);
+                }
+                catch (error) {
+                    // postMessage can fail, for example if a payload cannot be cloned.
+                    if (slot.active === task) {
+                        this.reject(task, workerError("WorkerPool could not send a task", error));
+                        this.retire(slot);
+                    }
+                }
+            }
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+    openWorker() {
+        const worker = this.createWorker();
+        const slot = {
+            worker,
+            message: (event) => this.receive(slot, event.data),
+            error: (event) => {
+                if (typeof event.preventDefault === "function")
+                    event.preventDefault();
+                this.failWorker(slot, event.message || "WorkerPool worker failed");
+            },
+            messageError: () => this.failWorker(slot, "WorkerPool could not deserialize a worker response"),
+            retired: false
+        };
+        try {
+            worker.addEventListener("message", slot.message);
+            worker.addEventListener("error", slot.error);
+            worker.addEventListener("messageerror", slot.messageError);
+            this.workers.add(slot);
+            return slot;
+        }
+        catch (error) {
+            // Partially installed listeners and the newly created worker are ours too.
+            this.retire(slot);
+            throw error;
+        }
+    }
+    receive(slot, value) {
+        if (slot.retired || !slot.active || typeof value !== "object" || value === null)
+            return;
+        const message = value;
+        // Ignore stale replies and unrelated messages; IDs are never reused.
+        if (message.id !== slot.active.id)
+            return;
+        const task = slot.active;
+        slot.active = undefined;
+        if (message.type === "result" && "value" in message) {
+            this.resolve(task, message.value);
+        }
+        else if (message.type === "error" && isSerializedError(message.error)) {
+            const error = new Error(message.error.message);
+            error.name = message.error.name;
+            this.reject(task, error);
+        }
+        else {
+            this.reject(task, new WorkerPoolError("invalid-response", "WorkerPool received an invalid task response"));
+            this.retire(slot);
+        }
+        this.drain();
+    }
+    cancel(task) {
+        if (task.settled)
+            return;
+        const index = this.queue.indexOf(task);
+        if (index !== -1)
+            this.queue.splice(index, 1);
+        const slot = [...this.workers].find((candidate) => candidate.active === task);
+        this.reject(task, abortError());
+        if (slot) {
+            // Retire the slot before sending cancel: a synchronous adapter response
+            // must not dispatch a queued task to a worker we are about to terminate.
+            this.retire(slot, task.id);
+        }
+        this.drain();
+    }
+    failWorker(slot, message) {
+        if (slot.retired)
+            return;
+        if (slot.active)
+            this.reject(slot.active, new WorkerPoolError("worker-failed", message));
+        this.retire(slot);
+        this.drain();
+    }
+    retire(slot, cancelId) {
+        if (slot.retired)
+            return;
+        slot.retired = true;
+        slot.active = undefined;
+        this.workers.delete(slot);
+        // Attempt every cleanup even when an adapter has a faulty disposer.
+        try {
+            slot.worker.removeEventListener("message", slot.message);
+        }
+        catch { /* continue cleanup */ }
+        try {
+            slot.worker.removeEventListener("error", slot.error);
+        }
+        catch { /* continue cleanup */ }
+        try {
+            slot.worker.removeEventListener("messageerror", slot.messageError);
+        }
+        catch { /* continue cleanup */ }
+        if (cancelId !== undefined) {
+            // Cancellation is best effort; termination also stops a synchronous
+            // handler that cannot receive this message.
+            try {
+                slot.worker.postMessage({ type: "cancel", id: cancelId }, []);
+            }
+            catch { /* terminate below */ }
+        }
+        try {
+            slot.worker.terminate();
+        }
+        catch { /* no further owned resources */ }
+    }
+    resolve(task, value) {
+        if (task.settled)
+            return;
+        this.finish(task);
+        task.resolve(value);
+    }
+    reject(task, error) {
+        if (task.settled)
+            return;
+        this.finish(task);
+        task.reject(error);
+    }
+    finish(task) {
+        task.settled = true;
+        if (task.signal && task.abort)
+            task.signal.removeEventListener("abort", task.abort);
+        task.abort = undefined;
+    }
+}
+/**
+ * Install a task handler in a worker. The returned disposer removes its listener,
+ * aborts outstanding handlers and suppresses late results. Output transferables
+ * are supplied explicitly with the result.
+ */
+export function installWorkerPoolHandler(port, handler) {
+    const active = new Map();
+    let disposed = false;
+    const sendError = (id, error) => {
+        const serialized = serializeError(error);
+        try {
+            port.postMessage({ type: "error", id, error: serialized }, []);
+        }
+        catch { /* transport is gone */ }
+    };
+    const onMessage = (event) => {
+        const data = event.data;
+        if (disposed || typeof data !== "object" || data === null)
+            return;
+        const request = data;
+        if (!Number.isSafeInteger(request.id) || request.id < 1)
+            return;
+        const id = request.id;
+        if (request.type === "cancel") {
+            active.get(id)?.abort();
+            active.delete(id);
+            return;
+        }
+        if (request.type !== "task" || !("payload" in request))
+            return;
+        if (active.has(id)) {
+            active.get(id)?.abort();
+            active.delete(id);
+            sendError(id, new Error("Duplicate WorkerPool task ID"));
+            return;
+        }
+        const controller = new AbortController();
+        active.set(id, controller);
+        void (async () => {
+            // Do not start a handler when a cancel or dispose arrived in this turn.
+            await Promise.resolve();
+            if (disposed || active.get(id) !== controller || controller.signal.aborted)
+                return;
+            try {
+                const result = await handler(request.payload, controller.signal);
+                if (disposed || active.get(id) !== controller || controller.signal.aborted)
+                    return;
+                active.delete(id);
+                port.postMessage({ type: "result", id, value: result.value }, [...(result.transfer ?? [])]);
+            }
+            catch (error) {
+                if (disposed || controller.signal.aborted)
+                    return;
+                // A postMessage clone error occurs after removal from active.
+                if (active.get(id) === controller)
+                    active.delete(id);
+                sendError(id, error);
+            }
+        })();
+    };
+    port.addEventListener("message", onMessage);
+    return () => {
+        if (disposed)
+            return;
+        disposed = true;
+        try {
+            port.removeEventListener("message", onMessage);
+        }
+        finally {
+            for (const controller of active.values())
+                controller.abort();
+            active.clear();
+        }
+    };
+}
+function isSerializedError(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const error = value;
+    return typeof error.name === "string" && typeof error.message === "string";
+}
+function serializeError(value) {
+    return value instanceof Error
+        ? { name: value.name, message: value.message }
+        : { name: "Error", message: String(value) };
+}
+function abortError() {
+    const error = new Error("WorkerPool task cancelled");
+    error.name = "AbortError";
+    return error;
+}
+function disposedError() {
+    return new WorkerPoolError("disposed", "WorkerPool has been disposed");
+}
+function workerError(message, error) {
+    return new WorkerPoolError("worker-failed", `${message}: ${error instanceof Error ? error.message : String(error)}`);
+}
+//# sourceMappingURL=WorkerPool.js.map

package/dist/utils/WorkerPool.js.map

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

package/package.json

@@ -1,6 +1,117 @@
 {
   "name": "@aura3d/addons",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "5.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./renderers/SpatialDOMRenderer": {
+      "types": "./dist/renderers/SpatialDOMRenderer.d.ts",
+      "browser": "./dist/renderers/SpatialDOMRenderer.js",
+      "import": "./dist/renderers/SpatialDOMRenderer.js",
+      "default": "./dist/renderers/SpatialDOMRenderer.js"
+    },
+    "./renderers/VectorRenderer": {
+      "types": "./dist/renderers/VectorRenderer.d.ts",
+      "browser": "./dist/renderers/VectorRenderer.js",
+      "import": "./dist/renderers/VectorRenderer.js",
+      "default": "./dist/renderers/VectorRenderer.js"
+    },
+    "./effects/StereoOutputs": {
+      "types": "./dist/effects/StereoOutputs.d.ts",
+      "browser": "./dist/effects/StereoOutputs.js",
+      "import": "./dist/effects/StereoOutputs.js",
+      "default": "./dist/effects/StereoOutputs.js"
+    },
+    "./effects/AsciiOutput": {
+      "types": "./dist/effects/AsciiOutput.d.ts",
+      "browser": "./dist/effects/AsciiOutput.js",
+      "import": "./dist/effects/AsciiOutput.js",
+      "default": "./dist/effects/AsciiOutput.js"
+    },
+    "./effects/OutlineOutput": {
+      "types": "./dist/effects/OutlineOutput.d.ts",
+      "browser": "./dist/effects/OutlineOutput.js",
+      "import": "./dist/effects/OutlineOutput.js",
+      "default": "./dist/effects/OutlineOutput.js"
+    },
+    "./objects/MarchingCubes": {
+      "types": "./dist/objects/MarchingCubes.d.ts",
+      "browser": "./dist/objects/MarchingCubes.js",
+      "import": "./dist/objects/MarchingCubes.js",
+      "default": "./dist/objects/MarchingCubes.js"
+    },
+    "./objects/SpecializedObjects": {
+      "types": "./dist/objects/SpecializedObjects.d.ts",
+      "browser": "./dist/objects/SpecializedObjects.js",
+      "import": "./dist/objects/SpecializedObjects.js",
+      "default": "./dist/objects/SpecializedObjects.js"
+    },
+    "./generators/EnvironmentGenerators": {
+      "types": "./dist/generators/EnvironmentGenerators.d.ts",
+      "browser": "./dist/generators/EnvironmentGenerators.js",
+      "import": "./dist/generators/EnvironmentGenerators.js",
+      "default": "./dist/generators/EnvironmentGenerators.js"
+    },
+    "./tools/Sculptor": {
+      "types": "./dist/tools/Sculptor.d.ts",
+      "browser": "./dist/tools/Sculptor.js",
+      "import": "./dist/tools/Sculptor.js",
+      "default": "./dist/tools/Sculptor.js"
+    },
+    "./tools/TubePainter": {
+      "types": "./dist/tools/TubePainter.d.ts",
+      "browser": "./dist/tools/TubePainter.js",
+      "import": "./dist/tools/TubePainter.js",
+      "default": "./dist/tools/TubePainter.js"
+    },
+    "./tools/Fracture": {
+      "types": "./dist/tools/Fracture.d.ts",
+      "browser": "./dist/tools/Fracture.js",
+      "import": "./dist/tools/Fracture.js",
+      "default": "./dist/tools/Fracture.js"
+    },
+    "./utils/WorkerPool": {
+      "types": "./dist/utils/WorkerPool.d.ts",
+      "browser": "./dist/utils/WorkerPool.js",
+      "import": "./dist/utils/WorkerPool.js",
+      "default": "./dist/utils/WorkerPool.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@aura3d/engine": "5.0.0",
+    "@aura3d/rendering": "5.0.0",
+    "@aura3d/scene": "5.0.0"
+  },
+  "sideEffects": false,
+  "description": "Optional independently authored renderers, effects, procedural objects, geometry tools, and utilities for Aura3D.",
+  "keywords": [
+    "aura3d",
+    "3d",
+    "typescript",
+    "addons"
+  ],
+  "homepage": "https://aura3d.auraone.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/auraoneai/aura3d.git",
+    "directory": "packages/addons"
+  },
+  "bugs": {
+    "url": "https://github.com/auraoneai/aura3d/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ]
 }