@asciiz/atoolkit 0.1.0

package/dist/awasm/memory/memory-view.js

@@ -0,0 +1,110 @@
+// ================================================================
+//  Awasm - Linear Memory: MemoryView
+// ================================================================
+/**
+ * Detachment-resilient typed array accessors over WebAssembly linear memory.
+ * Caches buffer references and revalidates views against WasmMemory generation counters
+ * to prevent accessing detached ArrayBuffers following memory expansion.
+ */
+export class MemoryView {
+    _memory;
+    _cachedGeneration;
+    _cachedBuffer;
+    constructor(memory) {
+        this._memory = memory;
+        this._cachedGeneration = memory.generation;
+        this._cachedBuffer = memory.buffer;
+    }
+    resolveBuffer() {
+        if (this._cachedGeneration !== this._memory.generation) {
+            this._cachedBuffer = this._memory.buffer;
+            this._cachedGeneration = this._memory.generation;
+        }
+        return this._cachedBuffer;
+    }
+    /**
+     * Slices an 8-bit unsigned integer view over linear memory.
+     */
+    asUint8(byteOffset, length) {
+        const buffer = this.resolveBuffer();
+        return new Uint8Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices an 8-bit signed integer view over linear memory.
+     */
+    asInt8(byteOffset, length) {
+        const buffer = this.resolveBuffer();
+        return new Int8Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices a 16-bit signed integer view over linear memory. Requires 2-byte alignment.
+     */
+    asInt16(byteOffset, length) {
+        if ((byteOffset & 1) !== 0) {
+            throw new Error(`Int16 offset must be 2-byte aligned, received ${byteOffset}`);
+        }
+        const buffer = this.resolveBuffer();
+        return new Int16Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices a 16-bit unsigned integer view over linear memory. Requires 2-byte alignment.
+     */
+    asUint16(byteOffset, length) {
+        if ((byteOffset & 1) !== 0) {
+            throw new Error(`Uint16 offset must be 2-byte aligned, received ${byteOffset}`);
+        }
+        const buffer = this.resolveBuffer();
+        return new Uint16Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices a 32-bit signed integer view over linear memory. Requires 4-byte alignment.
+     */
+    asInt32(byteOffset, length) {
+        if ((byteOffset & 3) !== 0) {
+            throw new Error(`Int32 offset must be 4-byte aligned, received ${byteOffset}`);
+        }
+        const buffer = this.resolveBuffer();
+        return new Int32Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices a 32-bit unsigned integer view over linear memory. Requires 4-byte alignment.
+     */
+    asUint32(byteOffset, length) {
+        if ((byteOffset & 3) !== 0) {
+            throw new Error(`Uint32 offset must be 4-byte aligned, received ${byteOffset}`);
+        }
+        const buffer = this.resolveBuffer();
+        return new Uint32Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices a 32-bit floating point view over linear memory. Requires 4-byte alignment.
+     */
+    asFloat32(byteOffset, length) {
+        if ((byteOffset & 3) !== 0) {
+            throw new Error(`Float32 offset must be 4-byte aligned, received ${byteOffset}`);
+        }
+        const buffer = this.resolveBuffer();
+        return new Float32Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices a 64-bit floating point view over linear memory. Requires 8-byte alignment.
+     */
+    asFloat64(byteOffset, length) {
+        if ((byteOffset & 7) !== 0) {
+            throw new Error(`Float64 offset must be 8-byte aligned, received ${byteOffset}`);
+        }
+        const buffer = this.resolveBuffer();
+        return new Float64Array(buffer, byteOffset, length);
+    }
+    /**
+     * Slices a DataView window over linear memory.
+     */
+    asDataView(byteOffset, byteLength) {
+        const buffer = this.resolveBuffer();
+        return new DataView(buffer, byteOffset, byteLength);
+    }
+    get memory() {
+        return this._memory;
+    }
+}
+//# sourceMappingURL=memory-view.js.map

package/dist/awasm/memory/memory-view.js.map

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

package/dist/awasm/memory/wasm-memory.d.ts

@@ -0,0 +1,40 @@
+export interface MemoryDescriptor {
+    initial: number;
+    maximum?: number;
+    shared?: boolean;
+}
+export type MemoryResizeListener = (newBuffer: ArrayBuffer, previousByteLength: number) => void;
+/**
+ * Managed WebAssembly memory coordinator tracking page growth, limits, and buffer stability.
+ * Holds direct ownership of native WebAssembly.Memory and notifies listeners when buffer reallocation occurs.
+ */
+export declare class WasmMemory {
+    private readonly _memory;
+    private readonly _isShared;
+    private _pageCount;
+    private _generation;
+    private _listeners;
+    static readonly PAGE_SIZE: number;
+    constructor(descriptor: MemoryDescriptor);
+    /**
+     * Adopts an existing native WebAssembly.Memory instance.
+     */
+    static fromNative(memory: WebAssembly.Memory, initialPages?: number): WasmMemory;
+    /**
+     * Grows linear memory by the specified page delta.
+     * Increments generation counter and notifies registered resize listeners.
+     */
+    grow(deltaPages: number): number;
+    /**
+     * Registers a callback invoked immediately when memory grows and the underlying buffer is reallocated.
+     * Returns an unregister function.
+     */
+    onResize(listener: MemoryResizeListener): () => void;
+    get handle(): WebAssembly.Memory;
+    get buffer(): ArrayBuffer;
+    get pageCount(): number;
+    get byteLength(): number;
+    get generation(): number;
+    get isShared(): boolean;
+}
+//# sourceMappingURL=wasm-memory.d.ts.map

package/dist/awasm/memory/wasm-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-memory.d.ts","sourceRoot":"","sources":["../../../awasm/memory/wasm-memory.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;AAEhG;;;GAGG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAyB;IAE3C,gBAAuB,SAAS,EAAE,MAAM,CAAS;gBAErC,UAAU,EAAE,gBAAgB;IAaxC;;OAEG;WACW,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,GAAE,MAAU,GAAG,UAAU;IAU1F;;;OAGG;IACI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAkBvC;;;OAGG;IACI,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAU3D,IAAW,MAAM,IAAI,WAAW,CAAC,MAAM,CAEtC;IAED,IAAW,MAAM,IAAI,WAAW,CAE/B;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,QAAQ,IAAI,OAAO,CAE7B;CACJ"}

package/dist/awasm/memory/wasm-memory.js

@@ -0,0 +1,88 @@
+// ================================================================
+//  Awasm - Linear Memory: WasmMemory
+// ================================================================
+/**
+ * Managed WebAssembly memory coordinator tracking page growth, limits, and buffer stability.
+ * Holds direct ownership of native WebAssembly.Memory and notifies listeners when buffer reallocation occurs.
+ */
+export class WasmMemory {
+    _memory;
+    _isShared;
+    _pageCount;
+    _generation;
+    _listeners;
+    static PAGE_SIZE = 65536;
+    constructor(descriptor) {
+        this._isShared = descriptor.shared ?? false;
+        this._pageCount = descriptor.initial;
+        this._generation = 0;
+        this._listeners = [];
+        this._memory = new WebAssembly.Memory({
+            initial: descriptor.initial,
+            maximum: descriptor.maximum,
+            shared: descriptor.shared,
+        });
+    }
+    /**
+     * Adopts an existing native WebAssembly.Memory instance.
+     */
+    static fromNative(memory, initialPages = 1) {
+        const instance = Object.create(WasmMemory.prototype);
+        instance._memory = memory;
+        instance._isShared = memory.buffer instanceof SharedArrayBuffer;
+        instance._pageCount = initialPages;
+        instance._generation = 0;
+        instance._listeners = [];
+        return instance;
+    }
+    /**
+     * Grows linear memory by the specified page delta.
+     * Increments generation counter and notifies registered resize listeners.
+     */
+    grow(deltaPages) {
+        if (deltaPages <= 0) {
+            return this._pageCount;
+        }
+        const previousByteLength = this._pageCount * WasmMemory.PAGE_SIZE;
+        const previousPages = this._memory.grow(deltaPages);
+        this._pageCount += deltaPages;
+        this._generation += 1;
+        const newBuffer = this._memory.buffer;
+        for (let i = 0; i < this._listeners.length; i++) {
+            this._listeners[i](newBuffer, previousByteLength);
+        }
+        return previousPages;
+    }
+    /**
+     * Registers a callback invoked immediately when memory grows and the underlying buffer is reallocated.
+     * Returns an unregister function.
+     */
+    onResize(listener) {
+        this._listeners.push(listener);
+        return () => {
+            const index = this._listeners.indexOf(listener);
+            if (index !== -1) {
+                this._listeners.splice(index, 1);
+            }
+        };
+    }
+    get handle() {
+        return this._memory;
+    }
+    get buffer() {
+        return this._memory.buffer;
+    }
+    get pageCount() {
+        return this._pageCount;
+    }
+    get byteLength() {
+        return this._pageCount * WasmMemory.PAGE_SIZE;
+    }
+    get generation() {
+        return this._generation;
+    }
+    get isShared() {
+        return this._isShared;
+    }
+}
+//# sourceMappingURL=wasm-memory.js.map

package/dist/awasm/memory/wasm-memory.js.map

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

package/dist/awasm/runtime/host-bridge.d.ts

@@ -0,0 +1,30 @@
+export interface HostEnvOptions {
+    onAbort?: (message: string, file: string, line: number, column: number) => void;
+    onLog?: (message: string) => void;
+    nowProvider?: () => number;
+}
+/**
+ * Host function import table builder.
+ * Registers JavaScript functions and default environment hooks to link into WebAssembly modules.
+ */
+export declare class HostBridge {
+    private readonly _imports;
+    constructor();
+    /**
+     * Registers a single host function under the specified module and export name.
+     */
+    register(moduleName: string, exportName: string, fn: any): this;
+    /**
+     * Registers a record of host functions under the specified module namespace.
+     */
+    registerModule(moduleName: string, functions: Record<string, any>): this;
+    /**
+     * Injects standard default environment hooks: env.now, env.abort, and optional env.log.
+     */
+    registerDefaultEnv(options?: HostEnvOptions): this;
+    /**
+     * Compiles registered imports into the WebAssembly.Imports dictionary format.
+     */
+    build(): WebAssembly.Imports;
+}
+//# sourceMappingURL=host-bridge.d.ts.map

package/dist/awasm/runtime/host-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge.d.ts","sourceRoot":"","sources":["../../../awasm/runtime/host-bridge.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;;IAM/D;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,IAAI;IAQtE;;OAEG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQ/E;;OAEG;IACI,kBAAkB,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI;IAkB7D;;OAEG;IACI,KAAK,IAAI,WAAW,CAAC,OAAO;CAGtC"}

package/dist/awasm/runtime/host-bridge.js

@@ -0,0 +1,57 @@
+// ================================================================
+//  Awasm - Runtime: HostBridge
+// ================================================================
+/**
+ * Host function import table builder.
+ * Registers JavaScript functions and default environment hooks to link into WebAssembly modules.
+ */
+export class HostBridge {
+    _imports;
+    constructor() {
+        this._imports = {};
+    }
+    /**
+     * Registers a single host function under the specified module and export name.
+     */
+    register(moduleName, exportName, fn) {
+        if (!this._imports[moduleName]) {
+            this._imports[moduleName] = {};
+        }
+        this._imports[moduleName][exportName] = fn;
+        return this;
+    }
+    /**
+     * Registers a record of host functions under the specified module namespace.
+     */
+    registerModule(moduleName, functions) {
+        if (!this._imports[moduleName]) {
+            this._imports[moduleName] = {};
+        }
+        Object.assign(this._imports[moduleName], functions);
+        return this;
+    }
+    /**
+     * Injects standard default environment hooks: env.now, env.abort, and optional env.log.
+     */
+    registerDefaultEnv(options = {}) {
+        const nowFn = options.nowProvider ?? (() => (typeof performance !== "undefined" ? performance.now() : Date.now()));
+        const abortFn = options.onAbort ?? ((msg, file, line, col) => {
+            throw new Error(`WebAssembly abort at ${file}:${line}:${col} - ${msg}`);
+        });
+        this.register("env", "now", nowFn);
+        this.register("env", "abort", (msgPtr, filePtr, line, col) => {
+            abortFn(String(msgPtr), String(filePtr), line, col);
+        });
+        if (options.onLog) {
+            this.register("env", "log", options.onLog);
+        }
+        return this;
+    }
+    /**
+     * Compiles registered imports into the WebAssembly.Imports dictionary format.
+     */
+    build() {
+        return this._imports;
+    }
+}
+//# sourceMappingURL=host-bridge.js.map

package/dist/awasm/runtime/host-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge.js","sourceRoot":"","sources":["../../../awasm/runtime/host-bridge.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,+BAA+B;AAC/B,mEAAmE;AAQnE;;;GAGG;AACH,MAAM,OAAO,UAAU;IACF,QAAQ,CAAsC;IAE/D;QACI,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,UAAkB,EAAE,UAAkB,EAAE,EAAO;QAC3D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,cAAc,CAAC,UAAkB,EAAE,SAA8B;QACpE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,kBAAkB,CAAC,UAA0B,EAAE;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACnH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzD,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,IAAI,IAAI,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,MAAc,EAAE,OAAe,EAAE,IAAY,EAAE,GAAW,EAAE,EAAE;YACzF,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK;QACR,OAAO,IAAI,CAAC,QAA+B,CAAC;IAChD,CAAC;CACJ"}

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

@@ -0,0 +1,5 @@
+export { ModuleInspector, type WasmExportKind, type WasmImportKind, type ModuleExportDescriptor, type ModuleImportDescriptor, type ModuleManifest, } from "./module-inspector.js";
+export { HostBridge, type HostEnvOptions } from "./host-bridge.js";
+export { ModuleLoader } from "./module-loader.js";
+export { WasmInstance } from "./wasm-instance.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../awasm/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/awasm/runtime/index.js

@@ -0,0 +1,5 @@
+export { ModuleInspector, } from "./module-inspector.js";
+export { HostBridge } from "./host-bridge.js";
+export { ModuleLoader } from "./module-loader.js";
+export { WasmInstance } from "./wasm-instance.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../awasm/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,eAAe,GAMlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/awasm/runtime/module-inspector.d.ts

@@ -0,0 +1,32 @@
+export type WasmExportKind = "function" | "table" | "memory" | "global";
+export type WasmImportKind = "function" | "table" | "memory" | "global";
+export interface ModuleExportDescriptor {
+    name: string;
+    kind: WasmExportKind;
+}
+export interface ModuleImportDescriptor {
+    module: string;
+    name: string;
+    kind: WasmImportKind;
+}
+export interface ModuleManifest {
+    exports: ModuleExportDescriptor[];
+    imports: ModuleImportDescriptor[];
+    declaredMemory: boolean;
+    requiredModules: string[];
+}
+/**
+ * Static binary inspector and validator for uninstantiated WebAssembly modules.
+ * Extracts interface schemas, import dependencies, and export symbols synchronously.
+ */
+export declare class ModuleInspector {
+    /**
+     * Inspects module exports and imports without instantiating or executing guest code.
+     */
+    static inspect(module: WebAssembly.Module): ModuleManifest;
+    /**
+     * Validates binary byte sequence against the WebAssembly specification.
+     */
+    static validate(bytes: BufferSource): boolean;
+}
+//# sourceMappingURL=module-inspector.d.ts.map

package/dist/awasm/runtime/module-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-inspector.d.ts","sourceRoot":"","sources":["../../../awasm/runtime/module-inspector.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,eAAe;IACxB;;OAEG;WACW,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,cAAc;IA8BjE;;OAEG;WACW,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;CAGvD"}

package/dist/awasm/runtime/module-inspector.js

@@ -0,0 +1,43 @@
+// ================================================================
+//  Awasm - Runtime: ModuleInspector
+// ================================================================
+/**
+ * Static binary inspector and validator for uninstantiated WebAssembly modules.
+ * Extracts interface schemas, import dependencies, and export symbols synchronously.
+ */
+export class ModuleInspector {
+    /**
+     * Inspects module exports and imports without instantiating or executing guest code.
+     */
+    static inspect(module) {
+        const rawExports = WebAssembly.Module.exports(module);
+        const rawImports = WebAssembly.Module.imports(module);
+        const exports = rawExports.map((e) => ({
+            name: e.name,
+            kind: e.kind,
+        }));
+        const imports = rawImports.map((i) => ({
+            module: i.module,
+            name: i.name,
+            kind: i.kind,
+        }));
+        const requiredModulesSet = new Set();
+        for (let i = 0; i < imports.length; i++) {
+            requiredModulesSet.add(imports[i].module);
+        }
+        const declaredMemory = exports.some((e) => e.kind === "memory") || imports.some((i) => i.kind === "memory");
+        return {
+            exports,
+            imports,
+            declaredMemory,
+            requiredModules: Array.from(requiredModulesSet),
+        };
+    }
+    /**
+     * Validates binary byte sequence against the WebAssembly specification.
+     */
+    static validate(bytes) {
+        return WebAssembly.validate(bytes);
+    }
+}
+//# sourceMappingURL=module-inspector.js.map

package/dist/awasm/runtime/module-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-inspector.js","sourceRoot":"","sources":["../../../awasm/runtime/module-inspector.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oCAAoC;AACpC,mEAAmE;AAuBnE;;;GAGG;AACH,MAAM,OAAO,eAAe;IACxB;;OAEG;IACI,MAAM,CAAC,OAAO,CAAC,MAA0B;QAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEtD,MAAM,OAAO,GAA6B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAsB;SACjC,CAAC,CAAC,CAAC;QAEJ,MAAM,OAAO,GAA6B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAsB;SACjC,CAAC,CAAC,CAAC;QAEJ,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAE5G,OAAO;YACH,OAAO;YACP,OAAO;YACP,cAAc;YACd,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC;SAClD,CAAC;IACN,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,CAAC,KAAmB;QACtC,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACJ"}

package/dist/awasm/runtime/module-loader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WebAssembly binary acquisition and compilation coordinator.
+ * Supports streaming compilation for Response streams and optional IndexedDB bytecode caching.
+ */
+export declare class ModuleLoader {
+    /**
+     * Compiles a WebAssembly module from streaming network responses or in-memory buffers.
+     */
+    static compile(source: BufferSource | Response | Promise<Response>): Promise<WebAssembly.Module>;
+    /**
+     * Compiles a WebAssembly module with persistent IndexedDB bytecode caching across sessions.
+     */
+    static compileCached(key: string, sourceProvider: () => Promise<BufferSource | Response>): Promise<WebAssembly.Module>;
+    private static readFromCache;
+    private static writeToCache;
+}
+//# sourceMappingURL=module-loader.d.ts.map

package/dist/awasm/runtime/module-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../../../awasm/runtime/module-loader.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,YAAY;IACrB;;OAEG;WACiB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;IAqB7G;;OAEG;WACiB,aAAa,CAC7B,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,GACvD,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;mBAcT,aAAa;mBA4Bb,YAAY;CAyBpC"}

package/dist/awasm/runtime/module-loader.js

@@ -0,0 +1,99 @@
+// ================================================================
+//  Awasm - Runtime: ModuleLoader
+// ================================================================
+/**
+ * WebAssembly binary acquisition and compilation coordinator.
+ * Supports streaming compilation for Response streams and optional IndexedDB bytecode caching.
+ */
+export class ModuleLoader {
+    /**
+     * Compiles a WebAssembly module from streaming network responses or in-memory buffers.
+     */
+    static async compile(source) {
+        if (typeof Response !== "undefined" && (source instanceof Response || source instanceof Promise)) {
+            if (typeof WebAssembly.compileStreaming === "function") {
+                try {
+                    return await WebAssembly.compileStreaming(source);
+                }
+                catch {
+                    // Fall back to buffer extraction on streaming failure (e.g. content-type mismatch)
+                    const response = await source;
+                    const buffer = await response.arrayBuffer();
+                    return await WebAssembly.compile(buffer);
+                }
+            }
+            else {
+                const response = await source;
+                const buffer = await response.arrayBuffer();
+                return await WebAssembly.compile(buffer);
+            }
+        }
+        return await WebAssembly.compile(source);
+    }
+    /**
+     * Compiles a WebAssembly module with persistent IndexedDB bytecode caching across sessions.
+     */
+    static async compileCached(key, sourceProvider) {
+        const cached = await this.readFromCache(key);
+        if (cached) {
+            return cached;
+        }
+        const source = await sourceProvider();
+        const compiled = await this.compile(source);
+        this.writeToCache(key, compiled).catch(() => { });
+        return compiled;
+    }
+    static async readFromCache(key) {
+        if (typeof indexedDB === "undefined") {
+            return null;
+        }
+        return new Promise((resolve) => {
+            try {
+                const req = indexedDB.open("awasm_bytecode_cache", 1);
+                req.onupgradeneeded = () => {
+                    req.result.createObjectStore("modules");
+                };
+                req.onsuccess = () => {
+                    const db = req.result;
+                    const tx = db.transaction("modules", "readonly");
+                    const store = tx.objectStore("modules");
+                    const getReq = store.get(key);
+                    getReq.onsuccess = () => {
+                        resolve(getReq.result ?? null);
+                    };
+                    getReq.onerror = () => resolve(null);
+                };
+                req.onerror = () => resolve(null);
+            }
+            catch {
+                resolve(null);
+            }
+        });
+    }
+    static async writeToCache(key, module) {
+        if (typeof indexedDB === "undefined") {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                const req = indexedDB.open("awasm_bytecode_cache", 1);
+                req.onupgradeneeded = () => {
+                    req.result.createObjectStore("modules");
+                };
+                req.onsuccess = () => {
+                    const db = req.result;
+                    const tx = db.transaction("modules", "readwrite");
+                    const store = tx.objectStore("modules");
+                    store.put(module, key);
+                    tx.oncomplete = () => resolve();
+                    tx.onerror = () => reject(tx.error);
+                };
+                req.onerror = () => reject(req.error);
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+}
+//# sourceMappingURL=module-loader.js.map

package/dist/awasm/runtime/module-loader.js.map

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

package/dist/awasm/runtime/wasm-instance.d.ts

@@ -0,0 +1,25 @@
+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 declare class WasmInstance<TExports extends Record<string, any> = Record<string, any>> {
+    private readonly _module;
+    private readonly _instance;
+    private readonly _memory;
+    private readonly _exports;
+    constructor(module: WebAssembly.Module, instance: WebAssembly.Instance, memory: WasmMemory);
+    /**
+     * Asynchronously instantiates a WebAssembly module with imports, automatically discovering exported memory.
+     */
+    static instantiate<T extends Record<string, any> = Record<string, any>>(module: WebAssembly.Module, imports?: WebAssembly.Imports, providedMemory?: WasmMemory): Promise<WasmInstance<T>>;
+    /**
+     * Invokes an exported guest function by name.
+     */
+    call<TResult = number>(name: string, ...args: number[]): TResult;
+    get exports(): TExports;
+    get handle(): WebAssembly.Instance;
+    get memory(): WasmMemory;
+    get module(): WebAssembly.Module;
+}
+//# sourceMappingURL=wasm-instance.d.ts.map

package/dist/awasm/runtime/wasm-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-instance.d.ts","sourceRoot":"","sources":["../../../awasm/runtime/wasm-instance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;GAGG;AACH,qBAAa,YAAY,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAChF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAExB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU;IAO1F;;OAEG;WACiB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/E,MAAM,EAAE,WAAW,CAAC,MAAM,EAC1B,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,EAC7B,cAAc,CAAC,EAAE,UAAU,GAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAgB3B;;OAEG;IACI,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO;IAQvE,IAAW,OAAO,IAAI,QAAQ,CAE7B;IAED,IAAW,MAAM,IAAI,WAAW,CAAC,QAAQ,CAExC;IAED,IAAW,MAAM,IAAI,UAAU,CAE9B;IAED,IAAW,MAAM,IAAI,WAAW,CAAC,MAAM,CAEtC;CACJ"}