@asciiz/atoolkit 0.1.0

package/dist/awasm/runtime/wasm-instance.js

@@ -0,0 +1,60 @@
+// ================================================================
+//  Awasm - Runtime: WasmInstance
+// ================================================================
+import { WasmMemory } from "../memory/wasm-memory.js";
+/**
+ * Managed WebAssembly instance binding runtime exports and linear memory.
+ * Exposes native instance handles alongside managed invocations and memory references.
+ */
+export class WasmInstance {
+    _module;
+    _instance;
+    _memory;
+    _exports;
+    constructor(module, instance, memory) {
+        this._module = module;
+        this._instance = instance;
+        this._memory = memory;
+        this._exports = instance.exports;
+    }
+    /**
+     * Asynchronously instantiates a WebAssembly module with imports, automatically discovering exported memory.
+     */
+    static async instantiate(module, imports, providedMemory) {
+        const instance = await WebAssembly.instantiate(module, imports);
+        let memory = providedMemory;
+        if (!memory) {
+            const rawMemory = instance.exports.memory;
+            if (rawMemory instanceof WebAssembly.Memory) {
+                memory = WasmMemory.fromNative(rawMemory);
+            }
+            else {
+                memory = new WasmMemory({ initial: 1 });
+            }
+        }
+        return new WasmInstance(module, instance, memory);
+    }
+    /**
+     * Invokes an exported guest function by name.
+     */
+    call(name, ...args) {
+        const fn = this._exports[name];
+        if (typeof fn !== "function") {
+            throw new Error(`Exported function '${name}' not found on WebAssembly instance`);
+        }
+        return fn(...args);
+    }
+    get exports() {
+        return this._exports;
+    }
+    get handle() {
+        return this._instance;
+    }
+    get memory() {
+        return this._memory;
+    }
+    get module() {
+        return this._module;
+    }
+}
+//# sourceMappingURL=wasm-instance.js.map

package/dist/awasm/runtime/wasm-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-instance.js","sourceRoot":"","sources":["../../../awasm/runtime/wasm-instance.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,iCAAiC;AACjC,mEAAmE;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;GAGG;AACH,MAAM,OAAO,YAAY;IACJ,OAAO,CAAqB;IAC5B,SAAS,CAAuB;IAChC,OAAO,CAAa;IACpB,QAAQ,CAAW;IAEpC,YAAY,MAA0B,EAAE,QAA8B,EAAE,MAAkB;QACtF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAmB,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,WAAW,CAC3B,MAA0B,EAC1B,OAA6B,EAC7B,cAA2B;QAE3B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEhE,IAAI,MAAM,GAAG,cAAc,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,SAAS,GAAI,QAAQ,CAAC,OAAe,CAAC,MAAM,CAAC;YACnD,IAAI,SAAS,YAAY,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC1C,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;QAED,OAAO,IAAI,YAAY,CAAI,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,IAAI,CAAmB,IAAY,EAAE,GAAG,IAAc;QACzD,MAAM,EAAE,GAAI,IAAI,CAAC,QAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,qCAAqC,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ"}

package/dist/awasm/thread/atomic-queue.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Lock-free circular ring buffer residing in shared linear memory.
+ * Coordinates message passing between worker threads via atomic load and store operations.
+ *
+ * Memory layout:
+ * - offset + 0: Atomic Head Index (4 bytes)
+ * - offset + 4: Atomic Tail Index (4 bytes)
+ * - offset + 8: Ring buffer slots (capacity * 4 bytes)
+ */
+export declare class AtomicQueue {
+    private readonly _view;
+    private readonly _headIndex;
+    private readonly _tailIndex;
+    private readonly _dataBaseIndex;
+    private readonly _capacity;
+    private readonly _mask;
+    constructor(buffer: SharedArrayBuffer, byteOffset: number, capacityPowerOfTwo?: number);
+    /**
+     * Appends a 32-bit integer to the ring buffer. Returns false when full.
+     */
+    enqueue(value: number): boolean;
+    /**
+     * Reads and removes the next 32-bit integer from the ring buffer. Returns null when empty.
+     */
+    dequeue(): number | null;
+    get length(): number;
+    get capacity(): number;
+    /**
+     * Calculates the total byte size required to host ring buffer metadata and slots.
+     */
+    static requiredBytes(capacityPowerOfTwo: number): number;
+}
+//# sourceMappingURL=atomic-queue.d.ts.map

package/dist/awasm/thread/atomic-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-queue.d.ts","sourceRoot":"","sources":["../../../awasm/thread/atomic-queue.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAE,MAAY;IAiB3F;;OAEG;IACI,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAetC;;OAEG;IACI,OAAO,IAAI,MAAM,GAAG,IAAI;IAe/B,IAAW,MAAM,IAAI,MAAM,CAI1B;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;OAEG;WACW,aAAa,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM;CAGlE"}

package/dist/awasm/thread/atomic-queue.js

@@ -0,0 +1,78 @@
+// ================================================================
+//  Awasm - Threading: AtomicQueue
+// ================================================================
+/**
+ * Lock-free circular ring buffer residing in shared linear memory.
+ * Coordinates message passing between worker threads via atomic load and store operations.
+ *
+ * Memory layout:
+ * - offset + 0: Atomic Head Index (4 bytes)
+ * - offset + 4: Atomic Tail Index (4 bytes)
+ * - offset + 8: Ring buffer slots (capacity * 4 bytes)
+ */
+export class AtomicQueue {
+    _view;
+    _headIndex;
+    _tailIndex;
+    _dataBaseIndex;
+    _capacity;
+    _mask;
+    constructor(buffer, byteOffset, capacityPowerOfTwo = 256) {
+        if ((byteOffset & 3) !== 0) {
+            throw new Error(`Byte offset must be 4-byte aligned, received ${byteOffset}`);
+        }
+        if ((capacityPowerOfTwo & (capacityPowerOfTwo - 1)) !== 0 || capacityPowerOfTwo <= 0) {
+            throw new Error(`Capacity must be a positive power of two, received ${capacityPowerOfTwo}`);
+        }
+        this._view = new Int32Array(buffer);
+        const base = byteOffset >> 2;
+        this._headIndex = base;
+        this._tailIndex = base + 1;
+        this._dataBaseIndex = base + 2;
+        this._capacity = capacityPowerOfTwo;
+        this._mask = capacityPowerOfTwo - 1;
+    }
+    /**
+     * Appends a 32-bit integer to the ring buffer. Returns false when full.
+     */
+    enqueue(value) {
+        const head = Atomics.load(this._view, this._headIndex);
+        const tail = Atomics.load(this._view, this._tailIndex);
+        if (tail - head >= this._capacity) {
+            return false;
+        }
+        const slotIndex = this._dataBaseIndex + (tail & this._mask);
+        Atomics.store(this._view, slotIndex, value);
+        Atomics.store(this._view, this._tailIndex, tail + 1);
+        return true;
+    }
+    /**
+     * Reads and removes the next 32-bit integer from the ring buffer. Returns null when empty.
+     */
+    dequeue() {
+        const head = Atomics.load(this._view, this._headIndex);
+        const tail = Atomics.load(this._view, this._tailIndex);
+        if (head >= tail) {
+            return null;
+        }
+        const slotIndex = this._dataBaseIndex + (head & this._mask);
+        const value = Atomics.load(this._view, slotIndex);
+        Atomics.store(this._view, this._headIndex, head + 1);
+        return value;
+    }
+    get length() {
+        const head = Atomics.load(this._view, this._headIndex);
+        const tail = Atomics.load(this._view, this._tailIndex);
+        return Math.max(0, tail - head);
+    }
+    get capacity() {
+        return this._capacity;
+    }
+    /**
+     * Calculates the total byte size required to host ring buffer metadata and slots.
+     */
+    static requiredBytes(capacityPowerOfTwo) {
+        return (2 + capacityPowerOfTwo) * 4;
+    }
+}
+//# sourceMappingURL=atomic-queue.js.map

package/dist/awasm/thread/atomic-queue.js.map

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

package/dist/awasm/thread/index.d.ts

@@ -0,0 +1,4 @@
+export { SharedMemory, type SharedMemoryDescriptor, type WaitResult } from "./shared-memory.js";
+export { AtomicQueue } from "./atomic-queue.js";
+export { WorkerPool, type WorkerTaskMessage, type WorkerResultMessage, } from "./worker-pool.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/awasm/thread/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../awasm/thread/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,sBAAsB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACH,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GAC3B,MAAM,kBAAkB,CAAC"}

package/dist/awasm/thread/index.js

@@ -0,0 +1,4 @@
+export { SharedMemory } from "./shared-memory.js";
+export { AtomicQueue } from "./atomic-queue.js";
+export { WorkerPool, } from "./worker-pool.js";
+//# sourceMappingURL=index.js.map

package/dist/awasm/thread/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../awasm/thread/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAgD,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACH,UAAU,GAGb,MAAM,kBAAkB,CAAC"}

package/dist/awasm/thread/shared-memory.d.ts

@@ -0,0 +1,38 @@
+export interface SharedMemoryDescriptor {
+    initial: number;
+    maximum: number;
+}
+export type WaitResult = "ok" | "not-equal" | "timed-out";
+/**
+ * Shared linear memory coordinator backed by SharedArrayBuffer and Atomics.
+ * Provides thread-safe WebAssembly memory accessible across Web Workers.
+ */
+export declare class SharedMemory {
+    private readonly _memory;
+    private readonly _int32View;
+    private readonly _initialPages;
+    private readonly _maximumPages;
+    constructor(descriptor: SharedMemoryDescriptor);
+    /**
+     * Executes Atomics.wait on the 32-bit integer location at the specified byte offset.
+     * Note: Cannot execute on browser main UI thread.
+     */
+    wait(byteOffset: number, expectedValue: number, timeoutMs?: number): WaitResult;
+    /**
+     * Executes Atomics.notify on the 32-bit integer location at the specified byte offset.
+     */
+    notify(byteOffset: number, count?: number): number;
+    /**
+     * Performs an atomic 32-bit integer read at the specified byte offset.
+     */
+    load(byteOffset: number): number;
+    /**
+     * Performs an atomic 32-bit integer write at the specified byte offset.
+     */
+    store(byteOffset: number, value: number): number;
+    get handle(): WebAssembly.Memory;
+    get buffer(): SharedArrayBuffer;
+    get initialPages(): number;
+    get maximumPages(): number;
+}
+//# sourceMappingURL=shared-memory.d.ts.map

package/dist/awasm/thread/shared-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-memory.d.ts","sourceRoot":"","sources":["../../../awasm/thread/shared-memory.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1D;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,UAAU,EAAE,sBAAsB;IAmB9C;;;OAGG;IACI,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU;IAQtF;;OAEG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM;IAQ5D;;OAEG;IACI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKvC;;OAEG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAKvD,IAAW,MAAM,IAAI,WAAW,CAAC,MAAM,CAEtC;IAED,IAAW,MAAM,IAAI,iBAAiB,CAErC;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;CACJ"}

package/dist/awasm/thread/shared-memory.js

@@ -0,0 +1,74 @@
+// ================================================================
+//  Awasm - Threading: SharedMemory
+// ================================================================
+/**
+ * Shared linear memory coordinator backed by SharedArrayBuffer and Atomics.
+ * Provides thread-safe WebAssembly memory accessible across Web Workers.
+ */
+export class SharedMemory {
+    _memory;
+    _int32View;
+    _initialPages;
+    _maximumPages;
+    constructor(descriptor) {
+        if (descriptor.maximum < descriptor.initial) {
+            throw new Error(`Maximum pages (${descriptor.maximum}) must be greater than or equal to initial (${descriptor.initial})`);
+        }
+        this._initialPages = descriptor.initial;
+        this._maximumPages = descriptor.maximum;
+        this._memory = new WebAssembly.Memory({
+            initial: descriptor.initial,
+            maximum: descriptor.maximum,
+            shared: true,
+        });
+        this._int32View = new Int32Array(this._memory.buffer);
+    }
+    /**
+     * Executes Atomics.wait on the 32-bit integer location at the specified byte offset.
+     * Note: Cannot execute on browser main UI thread.
+     */
+    wait(byteOffset, expectedValue, timeoutMs) {
+        if ((byteOffset & 3) !== 0) {
+            throw new Error(`Byte offset must be 4-byte aligned for 32-bit atomics, received ${byteOffset}`);
+        }
+        const index = byteOffset >> 2;
+        return Atomics.wait(this._int32View, index, expectedValue, timeoutMs);
+    }
+    /**
+     * Executes Atomics.notify on the 32-bit integer location at the specified byte offset.
+     */
+    notify(byteOffset, count = 1) {
+        if ((byteOffset & 3) !== 0) {
+            throw new Error(`Byte offset must be 4-byte aligned for 32-bit atomics, received ${byteOffset}`);
+        }
+        const index = byteOffset >> 2;
+        return Atomics.notify(this._int32View, index, count);
+    }
+    /**
+     * Performs an atomic 32-bit integer read at the specified byte offset.
+     */
+    load(byteOffset) {
+        const index = byteOffset >> 2;
+        return Atomics.load(this._int32View, index);
+    }
+    /**
+     * Performs an atomic 32-bit integer write at the specified byte offset.
+     */
+    store(byteOffset, value) {
+        const index = byteOffset >> 2;
+        return Atomics.store(this._int32View, index, value);
+    }
+    get handle() {
+        return this._memory;
+    }
+    get buffer() {
+        return this._memory.buffer;
+    }
+    get initialPages() {
+        return this._initialPages;
+    }
+    get maximumPages() {
+        return this._maximumPages;
+    }
+}
+//# sourceMappingURL=shared-memory.js.map

package/dist/awasm/thread/shared-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-memory.js","sourceRoot":"","sources":["../../../awasm/thread/shared-memory.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,mCAAmC;AACnC,mEAAmE;AASnE;;;GAGG;AACH,MAAM,OAAO,YAAY;IACJ,OAAO,CAAqB;IAC5B,UAAU,CAAa;IACvB,aAAa,CAAS;IACtB,aAAa,CAAS;IAEvC,YAAY,UAAkC;QAC1C,IAAI,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACX,kBAAkB,UAAU,CAAC,OAAO,+CAA+C,UAAU,CAAC,OAAO,GAAG,CAC3G,CAAC;QACN,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC;QAExC,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;YAClC,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,MAAM,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACI,IAAI,CAAC,UAAkB,EAAE,aAAqB,EAAE,SAAkB;QACrE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,mEAAmE,UAAU,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,UAAkB,EAAE,QAAgB,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,mEAAmE,UAAU,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,UAAkB;QAC1B,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAkB,EAAE,KAAa;QAC1C,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,MAAsC,CAAC;IAC/D,CAAC;IAED,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;CACJ"}

package/dist/awasm/thread/worker-pool.d.ts

@@ -0,0 +1,43 @@
+import { SharedMemory } from "./shared-memory.js";
+export interface WorkerTaskMessage {
+    type: "init" | "task" | "terminate";
+    taskId?: number;
+    module?: WebAssembly.Module;
+    memory?: WebAssembly.Memory;
+    arg0?: number;
+    arg1?: number;
+}
+export interface WorkerResultMessage {
+    taskId: number;
+    result: unknown;
+    error?: string;
+}
+/**
+ * Multi-threaded worker pool coordinating compute tasks on shared WebAssembly instances.
+ * Broadcasts compiled modules and SharedMemory handles to Web Workers via structured cloning.
+ */
+export declare class WorkerPool {
+    private readonly _workers;
+    private readonly _concurrency;
+    private _roundRobinIndex;
+    private _isInitialized;
+    private _pendingTasks;
+    private _nextTaskId;
+    constructor(workerScriptUrl: string | URL, concurrency?: number);
+    /**
+     * Broadcasts the compiled WebAssembly.Module and SharedMemory to all workers in the pool.
+     */
+    initialize(module: WebAssembly.Module, memory: SharedMemory): Promise<void>;
+    /**
+     * Dispatches a computational task to the next available worker in round-robin order.
+     */
+    dispatch<T = unknown>(taskIndex: number, arg0?: number, arg1?: number): Promise<T>;
+    /**
+     * Terminates all active worker threads and clears pending tasks.
+     */
+    terminate(): void;
+    private handleWorkerMessage;
+    get concurrency(): number;
+    get isInitialized(): boolean;
+}
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/awasm/thread/worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../awasm/thread/worker-pool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,aAAa,CAA2E;IAChG,OAAO,CAAC,WAAW,CAAS;gBAEhB,eAAe,EAAE,MAAM,GAAG,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM;IAsB/D;;OAEG;IACU,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxF;;OAEG;IACI,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,CAAC,CAAC;IAyB/F;;OAEG;IACI,SAAS,IAAI,IAAI;IASxB,OAAO,CAAC,mBAAmB;IAmB3B,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,aAAa,IAAI,OAAO,CAElC;CACJ"}

package/dist/awasm/thread/worker-pool.js

@@ -0,0 +1,118 @@
+// ================================================================
+//  Awasm - Threading: WorkerPool
+// ================================================================
+/**
+ * Multi-threaded worker pool coordinating compute tasks on shared WebAssembly instances.
+ * Broadcasts compiled modules and SharedMemory handles to Web Workers via structured cloning.
+ */
+export class WorkerPool {
+    _workers;
+    _concurrency;
+    _roundRobinIndex;
+    _isInitialized;
+    _pendingTasks;
+    _nextTaskId;
+    constructor(workerScriptUrl, concurrency) {
+        const detectedConcurrency = typeof navigator !== "undefined" && navigator.hardwareConcurrency
+            ? navigator.hardwareConcurrency
+            : 4;
+        this._concurrency = concurrency ?? detectedConcurrency;
+        this._workers = [];
+        this._roundRobinIndex = 0;
+        this._isInitialized = false;
+        this._pendingTasks = new Map();
+        this._nextTaskId = 1;
+        if (typeof Worker !== "undefined") {
+            for (let i = 0; i < this._concurrency; i++) {
+                const worker = new Worker(workerScriptUrl, { type: "module" });
+                worker.onmessage = this.handleWorkerMessage.bind(this);
+                this._workers.push(worker);
+            }
+        }
+    }
+    /**
+     * Broadcasts the compiled WebAssembly.Module and SharedMemory to all workers in the pool.
+     */
+    async initialize(module, memory) {
+        if (this._isInitialized) {
+            return;
+        }
+        const promises = [];
+        for (let i = 0; i < this._workers.length; i++) {
+            const worker = this._workers[i];
+            const p = new Promise((resolve, reject) => {
+                const initId = this._nextTaskId++;
+                this._pendingTasks.set(initId, { resolve, reject });
+                const msg = {
+                    type: "init",
+                    taskId: initId,
+                    module,
+                    memory: memory.handle,
+                };
+                worker.postMessage(msg);
+            });
+            promises.push(p);
+        }
+        await Promise.all(promises);
+        this._isInitialized = true;
+    }
+    /**
+     * Dispatches a computational task to the next available worker in round-robin order.
+     */
+    dispatch(taskIndex, arg0 = 0, arg1 = 0) {
+        if (!this._isInitialized) {
+            throw new Error("WorkerPool must be initialized with module and shared memory before dispatching tasks");
+        }
+        if (this._workers.length === 0) {
+            throw new Error("No active workers available in pool");
+        }
+        const worker = this._workers[this._roundRobinIndex];
+        this._roundRobinIndex = (this._roundRobinIndex + 1) % this._workers.length;
+        const taskId = this._nextTaskId++;
+        return new Promise((resolve, reject) => {
+            this._pendingTasks.set(taskId, { resolve, reject });
+            const msg = {
+                type: "task",
+                taskId,
+                arg0: taskIndex,
+                arg1,
+            };
+            worker.postMessage(msg);
+        });
+    }
+    /**
+     * Terminates all active worker threads and clears pending tasks.
+     */
+    terminate() {
+        for (let i = 0; i < this._workers.length; i++) {
+            this._workers[i].terminate();
+        }
+        this._workers.length = 0;
+        this._pendingTasks.clear();
+        this._isInitialized = false;
+    }
+    handleWorkerMessage(event) {
+        const data = event.data;
+        if (!data || typeof data.taskId !== "number") {
+            return;
+        }
+        const pending = this._pendingTasks.get(data.taskId);
+        if (!pending) {
+            return;
+        }
+        this._pendingTasks.delete(data.taskId);
+        if (data.error) {
+            pending.reject(new Error(data.error));
+        }
+        else {
+            pending.resolve(data.result);
+        }
+    }
+    get concurrency() {
+        return this._concurrency;
+    }
+    get isInitialized() {
+        return this._isInitialized;
+    }
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/awasm/thread/worker-pool.js.map

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

package/dist/awgpu/binding.d.ts

@@ -0,0 +1,108 @@
+import { type Device } from "./device.js";
+import { type Buffer, type Texture, type Sampler, type BufferSlice } from "./memory.js";
+/**
+ * Standardized 4-tier WebGPU update frequency slots.
+ */
+export declare enum SlotFrequency {
+    PerFrame = 0,// ViewProj, Viewport, Time, Globals
+    PerPhase = 1,// Environment maps, shadow atlases, phase buffers
+    PerBatch = 2,// Surface properties, data textures, samplers, storage buffers
+    PerInstance = 3
+}
+export type ResourceBinding = GPUBufferBinding | GPUTextureView | GPUSampler | Buffer | Texture | Sampler | BufferSlice | GPUBuffer | GPUTexture;
+/**
+ * Resolves a high-level or raw resource into a native GPUBindingResource descriptor.
+ */
+export declare function resolveBindingResource(res: ResourceBinding): GPUBindingResource;
+/**
+ * Fluent builder for creating GPUBindGroupLayout descriptors.
+ */
+export declare class BindLayout {
+    readonly native: GPUBindGroupLayout;
+    readonly label: string;
+    constructor(native: GPUBindGroupLayout, label?: string);
+    /**
+     * Builder factory for fluent layout construction.
+     */
+    static builder(): BindLayoutBuilder;
+    /**
+     * Creates BindLayout from raw GPUBindGroupLayoutEntry array.
+     */
+    static create(device: Device | GPUDevice, entries: GPUBindGroupLayoutEntry[], label?: string): BindLayout;
+}
+export declare class BindLayoutBuilder {
+    private entries;
+    addUniform(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        hasDynamicOffset?: boolean;
+        minBindingSize?: number;
+    }): this;
+    addStorage(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        readOnly?: boolean;
+        hasDynamicOffset?: boolean;
+        minBindingSize?: number;
+    }): this;
+    addTexture(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        sampleType?: GPUTextureSampleType;
+        viewDimension?: GPUTextureViewDimension;
+        multisampled?: boolean;
+    }): this;
+    addStorageTexture(binding: number, format: GPUTextureFormat, visibility?: GPUShaderStageFlags, options?: {
+        access?: GPUStorageTextureAccess;
+        viewDimension?: GPUTextureViewDimension;
+    }): this;
+    addSampler(binding: number, visibility?: GPUShaderStageFlags, options?: {
+        comparison?: boolean;
+    }): this;
+    build(device: Device | GPUDevice, label?: string): BindLayout;
+}
+export interface BindingEntry {
+    binding: number;
+    resource: ResourceBinding;
+}
+/**
+ * GPU bind group wrapper tracking slot index and native GPUBindGroup.
+ */
+export declare class BindTable {
+    readonly native: GPUBindGroup;
+    readonly layout: GPUBindGroupLayout;
+    readonly slot: number;
+    readonly label: string;
+    constructor(native: GPUBindGroup, layout: GPUBindGroupLayout, slot?: number, label?: string);
+    /**
+     * Factory: Instantiates GPUBindGroup with automated resource resolution.
+     */
+    static create(device: Device | GPUDevice, layout: GPUBindGroupLayout | BindLayout, entries: BindingEntry[], options?: {
+        slot?: number;
+        label?: string;
+    }): BindTable;
+    private static _defaultCache?;
+    /**
+     * Retrieves existing cached BindTable or creates new instance if not present.
+     */
+    static getOrCreate(device: Device | GPUDevice, layout: GPUBindGroupLayout | BindLayout, entries: BindingEntry[], options?: {
+        slot?: number;
+        label?: string;
+    }): BindTable;
+    /**
+     * Clears default BindTable deduplication cache.
+     */
+    static clearCache(): void;
+}
+/**
+ * Computes deterministic lookup key for GPUBindGroupLayout and resource entries.
+ */
+export declare function hashBindingEntries(layout: GPUBindGroupLayout, entries: BindingEntry[]): string;
+/**
+ * Cache preventing redundant allocation of identical GPUBindGroup instances.
+ */
+export declare class BindTableCache {
+    private _cache;
+    get(key: string): BindTable | undefined;
+    set(key: string, table: BindTable): void;
+    getOrCreate(device: Device | GPUDevice, layout: GPUBindGroupLayout | BindLayout, entries: BindingEntry[], options?: {
+        slot?: number;
+        label?: string;
+    }): BindTable;
+    clear(): void;
+}
+//# sourceMappingURL=binding.d.ts.map

package/dist/awgpu/binding.d.ts.map

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