@runanywhere/web 0.1.0-beta.1

package/dist/Foundation/SherpaONNXBridge.d.ts

@@ -0,0 +1,134 @@
+/**
+ * RunAnywhere Web SDK - Sherpa-ONNX WASM Bridge
+ *
+ * Loads the sherpa-onnx WASM module (separate from RACommons) and provides
+ * typed access to the sherpa-onnx C API for:
+ *   - STT (Speech-to-Text) via Whisper, Zipformer, Paraformer
+ *   - TTS (Text-to-Speech) via Piper/VITS
+ *   - VAD (Voice Activity Detection) via Silero
+ *
+ * Architecture:
+ *   RACommons WASM handles LLM, VLM, Embeddings (llama.cpp)
+ *   Sherpa-ONNX WASM handles STT, TTS, VAD (onnxruntime)
+ *
+ * The sherpa-onnx module is lazy-loaded on first use of STT/TTS/VAD.
+ */
+/**
+ * Emscripten module interface for sherpa-onnx WASM.
+ * Based on sherpa-onnx's wasm/nodejs C API exports.
+ */
+export interface SherpaONNXModule {
+    ccall: (ident: string, returnType: string | null, argTypes: string[], args: unknown[]) => unknown;
+    cwrap: (ident: string, returnType: string | null, argTypes: string[]) => (...args: unknown[]) => unknown;
+    _malloc: (size: number) => number;
+    _free: (ptr: number) => void;
+    setValue: (ptr: number, value: number, type: string) => void;
+    getValue: (ptr: number, type: string) => number;
+    UTF8ToString: (ptr: number) => string;
+    stringToUTF8: (str: string, ptr: number, maxLen: number) => void;
+    lengthBytesUTF8: (str: string) => number;
+    HEAPU8: Uint8Array;
+    HEAP16: Int16Array;
+    HEAP32: Int32Array;
+    HEAPF32: Float32Array;
+    HEAPF64: Float64Array;
+    FS: SherpaFS;
+    _SherpaOnnxCreateOfflineRecognizer: (configPtr: number) => number;
+    _SherpaOnnxDestroyOfflineRecognizer: (handle: number) => void;
+    _SherpaOnnxCreateOfflineStream: (handle: number) => number;
+    _SherpaOnnxDestroyOfflineStream: (stream: number) => void;
+    _SherpaOnnxAcceptWaveformOffline: (stream: number, sampleRate: number, samplesPtr: number, numSamples: number) => void;
+    _SherpaOnnxDecodeOfflineStream: (handle: number, stream: number) => void;
+    _SherpaOnnxGetOfflineStreamResultAsJson: (stream: number) => number;
+    _SherpaOnnxDestroyOfflineStreamResultJson: (ptr: number) => void;
+    _SherpaOnnxCreateOnlineRecognizer: (configPtr: number) => number;
+    _SherpaOnnxDestroyOnlineRecognizer: (handle: number) => void;
+    _SherpaOnnxCreateOnlineStream: (handle: number) => number;
+    _SherpaOnnxDestroyOnlineStream: (stream: number) => void;
+    _SherpaOnnxOnlineStreamAcceptWaveform: (stream: number, sampleRate: number, samplesPtr: number, numSamples: number) => void;
+    _SherpaOnnxIsOnlineStreamReady: (handle: number, stream: number) => number;
+    _SherpaOnnxDecodeOnlineStream: (handle: number, stream: number) => void;
+    _SherpaOnnxGetOnlineStreamResultAsJson: (handle: number, stream: number) => number;
+    _SherpaOnnxDestroyOnlineStreamResultJson: (ptr: number) => void;
+    _SherpaOnnxOnlineStreamInputFinished: (stream: number) => void;
+    _SherpaOnnxOnlineStreamIsEndpoint: (handle: number, stream: number) => number;
+    _SherpaOnnxOnlineStreamReset: (handle: number, stream: number) => void;
+    _SherpaOnnxCreateOfflineTts: (configPtr: number) => number;
+    _SherpaOnnxDestroyOfflineTts: (handle: number) => void;
+    _SherpaOnnxOfflineTtsGenerate: (handle: number, textPtr: number, sid: number, speed: number) => number;
+    _SherpaOnnxDestroyOfflineTtsGeneratedAudio: (audio: number) => void;
+    _SherpaOnnxOfflineTtsSampleRate: (handle: number) => number;
+    _SherpaOnnxOfflineTtsNumSpeakers: (handle: number) => number;
+    _SherpaOnnxCreateVoiceActivityDetector: (configPtr: number, bufferSizeInSeconds: number) => number;
+    _SherpaOnnxDestroyVoiceActivityDetector: (handle: number) => void;
+    _SherpaOnnxVoiceActivityDetectorAcceptWaveform: (handle: number, samplesPtr: number, numSamples: number) => void;
+    _SherpaOnnxVoiceActivityDetectorEmpty: (handle: number) => number;
+    _SherpaOnnxVoiceActivityDetectorDetected: (handle: number) => number;
+    _SherpaOnnxVoiceActivityDetectorPop: (handle: number) => void;
+    _SherpaOnnxVoiceActivityDetectorFront: (handle: number) => number;
+    _SherpaOnnxDestroySpeechSegment: (segment: number) => void;
+    _SherpaOnnxVoiceActivityDetectorReset: (handle: number) => void;
+    _SherpaOnnxVoiceActivityDetectorFlush: (handle: number) => void;
+    _CopyHeap?: (srcPtr: number, numBytes: number, dstPtr: number) => void;
+}
+interface SherpaFS {
+    mkdir: (path: string) => void;
+    writeFile: (path: string, data: Uint8Array | string) => void;
+    readFile: (path: string) => Uint8Array;
+    unlink: (path: string) => void;
+    analyzePath: (path: string) => {
+        exists: boolean;
+    };
+}
+/**
+ * SherpaONNXBridge - Loads and manages the sherpa-onnx WASM module.
+ *
+ * Singleton that provides access to sherpa-onnx C API functions.
+ * Lazy-loaded: only initializes when STT/TTS/VAD is first used.
+ */
+export declare class SherpaONNXBridge {
+    private static _instance;
+    private _module;
+    private _loaded;
+    private _loading;
+    static get shared(): SherpaONNXBridge;
+    get isLoaded(): boolean;
+    get module(): SherpaONNXModule;
+    /**
+     * Ensure the sherpa-onnx WASM module is loaded.
+     * Safe to call multiple times -- will only load once.
+     *
+     * @param wasmUrl - URL/path to the sherpa-onnx glue JS file.
+     *                  Defaults to wasm/sherpa/sherpa-onnx-glue.js
+     */
+    ensureLoaded(wasmUrl?: string): Promise<void>;
+    private _doLoad;
+    /**
+     * Get the Emscripten FS object from the module.
+     * Handles both direct FS property and module-level helper functions.
+     */
+    private getFS;
+    /**
+     * Ensure a directory exists in the sherpa-onnx Emscripten virtual FS.
+     */
+    ensureDir(path: string): void;
+    /**
+     * Write a file into the sherpa-onnx Emscripten virtual FS.
+     * Used to stage model files before loading.
+     *
+     * Prefers FS_createDataFile over FS.writeFile for reliability —
+     * the module was compiled with NODERAWFS which can leave FS.writeFile
+     * in a broken state even after our browser patches.
+     */
+    writeFile(path: string, data: Uint8Array): void;
+    /**
+     * Download a file from a URL and write it to the sherpa-onnx FS.
+     */
+    downloadAndWrite(url: string, fsPath: string, onProgress?: (loaded: number, total: number) => void): Promise<void>;
+    allocString(str: string): number;
+    readString(ptr: number): string;
+    free(ptr: number): void;
+    shutdown(): void;
+}
+export {};
+//# sourceMappingURL=SherpaONNXBridge.d.ts.map

package/dist/Foundation/SherpaONNXBridge.d.ts.map

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

package/dist/Foundation/SherpaONNXBridge.js

@@ -0,0 +1,332 @@
+/**
+ * RunAnywhere Web SDK - Sherpa-ONNX WASM Bridge
+ *
+ * Loads the sherpa-onnx WASM module (separate from RACommons) and provides
+ * typed access to the sherpa-onnx C API for:
+ *   - STT (Speech-to-Text) via Whisper, Zipformer, Paraformer
+ *   - TTS (Text-to-Speech) via Piper/VITS
+ *   - VAD (Voice Activity Detection) via Silero
+ *
+ * Architecture:
+ *   RACommons WASM handles LLM, VLM, Embeddings (llama.cpp)
+ *   Sherpa-ONNX WASM handles STT, TTS, VAD (onnxruntime)
+ *
+ * The sherpa-onnx module is lazy-loaded on first use of STT/TTS/VAD.
+ */
+import { SDKError, SDKErrorCode } from './ErrorTypes';
+import { SDKLogger } from './SDKLogger';
+const logger = new SDKLogger('SherpaONNX');
+// ---------------------------------------------------------------------------
+// SherpaONNXBridge
+// ---------------------------------------------------------------------------
+/**
+ * SherpaONNXBridge - Loads and manages the sherpa-onnx WASM module.
+ *
+ * Singleton that provides access to sherpa-onnx C API functions.
+ * Lazy-loaded: only initializes when STT/TTS/VAD is first used.
+ */
+export class SherpaONNXBridge {
+    static _instance = null;
+    _module = null;
+    _loaded = false;
+    _loading = null;
+    static get shared() {
+        if (!SherpaONNXBridge._instance) {
+            SherpaONNXBridge._instance = new SherpaONNXBridge();
+        }
+        return SherpaONNXBridge._instance;
+    }
+    get isLoaded() {
+        return this._loaded && this._module !== null;
+    }
+    get module() {
+        if (!this._module) {
+            throw new SDKError(SDKErrorCode.WASMNotLoaded, 'Sherpa-ONNX WASM not loaded. Call ensureLoaded() first.');
+        }
+        return this._module;
+    }
+    /**
+     * Ensure the sherpa-onnx WASM module is loaded.
+     * Safe to call multiple times -- will only load once.
+     *
+     * @param wasmUrl - URL/path to the sherpa-onnx glue JS file.
+     *                  Defaults to wasm/sherpa/sherpa-onnx-glue.js
+     */
+    async ensureLoaded(wasmUrl) {
+        if (this._loaded)
+            return;
+        // Prevent duplicate loading
+        if (this._loading) {
+            await this._loading;
+            return;
+        }
+        this._loading = this._doLoad(wasmUrl);
+        await this._loading;
+        this._loading = null;
+    }
+    async _doLoad(wasmUrl) {
+        logger.info('Loading Sherpa-ONNX WASM module...');
+        try {
+            const moduleUrl = wasmUrl ?? new URL('../../wasm/sherpa/sherpa-onnx-glue.js', import.meta.url).href;
+            const { default: createModule } = await import(/* @vite-ignore */ moduleUrl);
+            // Derive the base URL for the .wasm binary
+            const baseUrl = moduleUrl.substring(0, moduleUrl.lastIndexOf('/') + 1);
+            const wasmBinaryUrl = baseUrl + 'sherpa-onnx.wasm';
+            // Pre-fetch the WASM binary to avoid Emscripten's sync XHR
+            // (the Node.js-targeted build uses sync fetch which fails in browsers)
+            logger.info(`Fetching sherpa-onnx WASM binary from ${wasmBinaryUrl}`);
+            const wasmResponse = await fetch(wasmBinaryUrl);
+            if (!wasmResponse.ok) {
+                throw new Error(`Failed to fetch sherpa-onnx.wasm: ${wasmResponse.status} ${wasmResponse.statusText}`);
+            }
+            const wasmBinary = await wasmResponse.arrayBuffer();
+            logger.info(`Sherpa-ONNX WASM binary fetched: ${(wasmBinary.byteLength / 1_000_000).toFixed(1)} MB`);
+            // Use instantiateWasm for async compilation (Chrome blocks sync compile for >8MB).
+            //
+            // The sherpa-onnx glue JS was compiled with NODERAWFS but we patched it:
+            //   1. ENVIRONMENT_IS_NODE = false → forces browser code paths
+            //   2. NODERAWFS mounting skipped → FS uses MEMFS
+            //   3. receiveInstance patched → re-assigns Module exports after wasmExports is set
+            //
+            // We pass noFSInit: true to skip FS.init() (which creates /dev/stdin etc.).
+            // We don't need standard streams — only file operations for staging model files.
+            // This ensures initRuntime() succeeds and the ready promise resolves.
+            //
+            // We track a separate wasmReady promise so that if WebAssembly.instantiate
+            // itself fails, we get the actual error instead of a generic timeout.
+            let resolveWasm;
+            let rejectWasm;
+            const wasmReady = new Promise((resolve, reject) => {
+                resolveWasm = resolve;
+                rejectWasm = reject;
+            });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const mod = createModule({
+                noFSInit: true,
+                print: (text) => logger.debug(text),
+                printErr: (text) => logger.warning(text),
+                wasmBinary,
+                locateFile: (path) => baseUrl + path,
+                instantiateWasm: (imports, receiveInstance) => {
+                    WebAssembly.instantiate(wasmBinary, imports)
+                        .then((result) => {
+                        try {
+                            receiveInstance(result.instance, result.module);
+                            resolveWasm();
+                        }
+                        catch (err) {
+                            // receiveInstance may throw if initRuntime fails (e.g. FS errors).
+                            // The WASM exports are already set by our patch at this point.
+                            logger.warning(`receiveInstance completed with error (exports should still be set): ${err}`);
+                            resolveWasm(); // Still resolve — exports are set before the throw point
+                        }
+                    })
+                        .catch((err) => {
+                        const error = err instanceof Error ? err : new Error(String(err));
+                        logger.error(`WASM instantiation failed: ${error.message}`);
+                        rejectWasm(error);
+                    });
+                    return {}; // Indicates async instantiation
+                },
+            });
+            // Wait for WASM instantiation + receiveInstance to complete.
+            // Also race with the module.ready promise (which resolves after full init).
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('Sherpa-ONNX WASM module timed out after 30s')), 30_000);
+            });
+            await Promise.race([wasmReady, timeoutPromise]);
+            this._module = mod;
+            // Verify critical exports are available (set by our patched receiveInstance)
+            if (typeof mod._malloc !== 'function') {
+                const available = ['_malloc', '_free', '_SherpaOnnxCreateOfflineRecognizer']
+                    .map(fn => `${fn}: ${typeof mod[fn]}`)
+                    .join(', ');
+                throw new Error(`WASM exports not available after initialization. Available: ${available}`);
+            }
+            this._loaded = true;
+            logger.info('Sherpa-ONNX WASM module loaded successfully');
+        }
+        catch (error) {
+            this._module = null;
+            this._loaded = false;
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`Failed to load Sherpa-ONNX WASM: ${message}`);
+            throw new SDKError(SDKErrorCode.WASMLoadFailed, `Failed to load Sherpa-ONNX WASM module: ${message}. ` +
+                'Build with: ./wasm/scripts/build-sherpa-onnx.sh');
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Filesystem Helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Get the Emscripten FS object from the module.
+     * Handles both direct FS property and module-level helper functions.
+     */
+    getFS() {
+        const m = this.module;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = m;
+        // First try direct FS property
+        if (m.FS && typeof m.FS.mkdir === 'function') {
+            return m.FS;
+        }
+        // Fallback: construct FS-like interface from Emscripten module-level helpers
+        if (typeof mod.FS_createPath === 'function') {
+            return {
+                mkdir: (p) => {
+                    const parent = p.substring(0, p.lastIndexOf('/')) || '/';
+                    const name = p.substring(p.lastIndexOf('/') + 1);
+                    mod.FS_createPath(parent, name, true, true);
+                },
+                writeFile: (p, data) => {
+                    const dir = p.substring(0, p.lastIndexOf('/')) || '/';
+                    const name = p.substring(p.lastIndexOf('/') + 1);
+                    try {
+                        mod.FS_unlink(p);
+                    }
+                    catch { /* file may not exist */ }
+                    mod.FS_createDataFile(dir, name, data, true, true, true);
+                },
+                readFile: (p) => mod.FS_readFile(p),
+                unlink: (p) => mod.FS_unlink(p),
+                analyzePath: (p) => {
+                    try {
+                        mod.FS_readFile(p);
+                        return { exists: true };
+                    }
+                    catch {
+                        return { exists: false };
+                    }
+                },
+            };
+        }
+        throw new SDKError(SDKErrorCode.WASMNotLoaded, 'Sherpa-ONNX FS not available');
+    }
+    /**
+     * Ensure a directory exists in the sherpa-onnx Emscripten virtual FS.
+     */
+    ensureDir(path) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = this.module;
+        if (typeof mod.FS_createPath === 'function') {
+            // Use FS_createPath which creates all intermediate directories
+            mod.FS_createPath('/', path.replace(/^\//, ''), true, true);
+            return;
+        }
+        // Fallback to FS.mkdir
+        const fs = this.getFS();
+        const parts = path.split('/').filter(Boolean);
+        let current = '';
+        for (const part of parts) {
+            current += '/' + part;
+            if (!fs.analyzePath(current).exists) {
+                fs.mkdir(current);
+            }
+        }
+    }
+    /**
+     * Write a file into the sherpa-onnx Emscripten virtual FS.
+     * Used to stage model files before loading.
+     *
+     * Prefers FS_createDataFile over FS.writeFile for reliability —
+     * the module was compiled with NODERAWFS which can leave FS.writeFile
+     * in a broken state even after our browser patches.
+     */
+    writeFile(path, data) {
+        const dir = path.substring(0, path.lastIndexOf('/'));
+        if (dir)
+            this.ensureDir(dir);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = this.module;
+        // Prefer FS_createDataFile — it creates the file node and writes data
+        // in one shot, avoiding potential issues with FS.open / FS.write on
+        // NODERAWFS-patched modules.
+        if (typeof mod.FS_createDataFile === 'function') {
+            const parentDir = dir || '/';
+            const filename = path.substring(path.lastIndexOf('/') + 1);
+            // Remove existing file first (FS_createDataFile throws if it exists)
+            try {
+                if (typeof mod.FS_unlink === 'function') {
+                    mod.FS_unlink(path);
+                }
+            }
+            catch {
+                // File doesn't exist — that's fine
+            }
+            mod.FS_createDataFile(parentDir, filename, data, true, true, false);
+            logger.debug(`Wrote ${data.length} bytes to sherpa FS: ${path}`);
+            return;
+        }
+        // Fallback to FS.writeFile
+        const fs = this.getFS();
+        fs.writeFile(path, data);
+        logger.debug(`Wrote ${data.length} bytes to sherpa FS: ${path}`);
+    }
+    /**
+     * Download a file from a URL and write it to the sherpa-onnx FS.
+     */
+    async downloadAndWrite(url, fsPath, onProgress) {
+        logger.info(`Downloading ${url} -> ${fsPath}`);
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new SDKError(SDKErrorCode.NetworkError, `Failed to download ${url}: ${response.status} ${response.statusText}`);
+        }
+        const contentLength = Number(response.headers.get('content-length') ?? 0);
+        const reader = response.body?.getReader();
+        if (!reader) {
+            // Fallback: read all at once
+            const buffer = await response.arrayBuffer();
+            this.writeFile(fsPath, new Uint8Array(buffer));
+            return;
+        }
+        // Stream download with progress
+        const chunks = [];
+        let loaded = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            chunks.push(value);
+            loaded += value.length;
+            onProgress?.(loaded, contentLength);
+        }
+        // Combine chunks
+        const combined = new Uint8Array(loaded);
+        let offset = 0;
+        for (const chunk of chunks) {
+            combined.set(chunk, offset);
+            offset += chunk.length;
+        }
+        this.writeFile(fsPath, combined);
+    }
+    // -----------------------------------------------------------------------
+    // String Helpers
+    // -----------------------------------------------------------------------
+    allocString(str) {
+        const m = this.module;
+        const len = m.lengthBytesUTF8(str) + 1;
+        const ptr = m._malloc(len);
+        m.stringToUTF8(str, ptr, len);
+        return ptr;
+    }
+    readString(ptr) {
+        if (ptr === 0)
+            return '';
+        return this.module.UTF8ToString(ptr);
+    }
+    free(ptr) {
+        if (ptr !== 0)
+            this.module._free(ptr);
+    }
+    // -----------------------------------------------------------------------
+    // Cleanup
+    // -----------------------------------------------------------------------
+    shutdown() {
+        this._module = null;
+        this._loaded = false;
+        this._loading = null;
+        SherpaONNXBridge._instance = null;
+        logger.info('Sherpa-ONNX bridge shut down');
+    }
+}
+//# sourceMappingURL=SherpaONNXBridge.js.map

package/dist/Foundation/SherpaONNXBridge.js.map

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

package/dist/Foundation/StructOffsets.d.ts

@@ -0,0 +1,147 @@
+/**
+ * RunAnywhere Web SDK - WASM Struct Field Offsets
+ *
+ * C struct field offsets depend on alignment, padding, pointer size (wasm32
+ * vs wasm64) and compiler flags. Hard-coding them in TypeScript is fragile
+ * and leads to silent data corruption when the C layout changes.
+ *
+ * This module queries `rac_wasm_offsetof_*()` helpers (compiled via
+ * `offsetof()` in wasm_exports.cpp) exactly once after the WASM module is
+ * loaded, and caches the results for the lifetime of the page.
+ *
+ * Usage:
+ *   import { Offsets, loadOffsets } from '../Foundation/StructOffsets';
+ *
+ *   // Called once during SDK init (after WASM load):
+ *   loadOffsets(wasmModule);
+ *
+ *   // Then anywhere:
+ *   m.setValue(optPtr + Offsets.llmOptions.temperature, 0.8, 'float');
+ */
+export interface ConfigOffsets {
+    logLevel: number;
+}
+export interface LLMOptionsOffsets {
+    maxTokens: number;
+    temperature: number;
+    topP: number;
+}
+export interface LLMResultOffsets {
+    text: number;
+    promptTokens: number;
+    completionTokens: number;
+}
+export interface VLMImageOffsets {
+    format: number;
+    filePath: number;
+    pixelData: number;
+    base64Data: number;
+    width: number;
+    height: number;
+    dataSize: number;
+}
+export interface VLMOptionsOffsets {
+    maxTokens: number;
+    temperature: number;
+    topP: number;
+    streamingEnabled: number;
+    systemPrompt: number;
+    modelFamily: number;
+}
+export interface VLMResultOffsets {
+    text: number;
+    promptTokens: number;
+    imageTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    timeToFirstTokenMs: number;
+    imageEncodeTimeMs: number;
+    totalTimeMs: number;
+    tokensPerSecond: number;
+}
+export interface StructuredOutputConfigOffsets {
+    jsonSchema: number;
+    includeSchemaInPrompt: number;
+}
+export interface StructuredOutputValidationOffsets {
+    isValid: number;
+    errorMessage: number;
+    extractedJson: number;
+}
+export interface EmbeddingsOptionsOffsets {
+    normalize: number;
+    pooling: number;
+    nThreads: number;
+}
+export interface EmbeddingsResultOffsets {
+    embeddings: number;
+    numEmbeddings: number;
+    dimension: number;
+    processingTimeMs: number;
+    totalTokens: number;
+}
+export interface EmbeddingVectorOffsets {
+    data: number;
+    dimension: number;
+    structSize: number;
+}
+export interface DiffusionOptionsOffsets {
+    prompt: number;
+    negativePrompt: number;
+    width: number;
+    height: number;
+    steps: number;
+    guidanceScale: number;
+    seed: number;
+    scheduler: number;
+    mode: number;
+    denoiseStrength: number;
+    reportIntermediate: number;
+    progressStride: number;
+}
+export interface DiffusionResultOffsets {
+    imageData: number;
+    imageSize: number;
+    width: number;
+    height: number;
+    seedUsed: number;
+    generationTimeMs: number;
+    safetyFlagged: number;
+}
+export interface AllOffsets {
+    config: ConfigOffsets;
+    llmOptions: LLMOptionsOffsets;
+    llmResult: LLMResultOffsets;
+    vlmImage: VLMImageOffsets;
+    vlmOptions: VLMOptionsOffsets;
+    vlmResult: VLMResultOffsets;
+    structuredOutputConfig: StructuredOutputConfigOffsets;
+    structuredOutputValidation: StructuredOutputValidationOffsets;
+    embeddingsOptions: EmbeddingsOptionsOffsets;
+    embeddingsResult: EmbeddingsResultOffsets;
+    embeddingVector: EmbeddingVectorOffsets;
+    diffusionOptions: DiffusionOptionsOffsets;
+    diffusionResult: DiffusionResultOffsets;
+}
+/**
+ * Get the cached struct offsets. Throws if `loadOffsets()` hasn't been called.
+ */
+export declare function getOffsets(): AllOffsets;
+/**
+ * Convenience re-export so callers can write `Offsets.vlmResult.text`.
+ */
+export declare const Offsets: AllOffsets;
+/**
+ * Read all struct field offsets from the WASM module and cache them.
+ * Must be called exactly once, after the WASM module is loaded.
+ *
+ * @param m - The Emscripten WASM module instance
+ */
+export declare function loadOffsets(m: any): void;
+/**
+ * Load offsets for a standalone WASM module (e.g. in a Web Worker).
+ * Returns the offsets directly instead of storing them in the singleton.
+ * Useful when the Worker has its own WASM instance.
+ */
+export declare function loadOffsetsFromModule(m: any): AllOffsets;
+//# sourceMappingURL=StructOffsets.d.ts.map

package/dist/Foundation/StructOffsets.d.ts.map

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