@litert-lm/core 0.12.0

package/dist/litertlm_web.js

@@ -0,0 +1,75 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Placeholder for internal dependency on trusted resource url
+import { getGlobalLiteRtLm } from './global_litertlm';
+/**
+ * Set up the default WebGPU device for the LiteRT LM Wasm module.
+ */
+export async function setupDefaultWebGpuDevice() {
+    await getGlobalLiteRtLm().setupDefaultWebGpuDevice();
+}
+/**
+ * Run LiteRt LM models in the browser.
+ */
+export class LiteRtLm {
+    liteRtLmWasm;
+    static DEFAULT_WASM_PATH = 'https://cdn.jsdelivr.net/npm/@litert-lm/core@0.12.0/wasm';
+    constructor(wasmModule) {
+        this.liteRtLmWasm = wasmModule;
+        this.liteRtLmWasm.setupLogging();
+    }
+    async setupDefaultWebGpuDevice() {
+        if (this.liteRtLmWasm.preinitializedWebGPUDevice) {
+            return;
+        }
+        this.liteRtLmWasm.preinitializedWebGPUDevice =
+            await createDefaultWebGpuDevice();
+    }
+    delete() {
+        // no op for now.
+    }
+}
+// TODO: b/475939320 - Use a shared implementation with LiteRT.
+const DESIRED_WEBGPU_FEATURES = [
+    'shader-f16',
+    'subgroups',
+];
+async function createDefaultWebGpuDevice() {
+    const adapterDescriptor = {
+        powerPreference: 'high-performance',
+    };
+    const adapter = await navigator.gpu.requestAdapter(adapterDescriptor);
+    if (!adapter) {
+        throw new Error('No GPU adapter found.');
+    }
+    const requiredLimits = {
+        maxBufferSize: adapter.limits.maxBufferSize,
+        maxStorageBufferBindingSize: adapter.limits.maxStorageBufferBindingSize,
+        maxStorageBuffersPerShaderStage: adapter.limits.maxStorageBuffersPerShaderStage,
+        maxTextureDimension2D: adapter.limits.maxTextureDimension2D,
+    };
+    const requiredFeatures = [];
+    for (const feature of DESIRED_WEBGPU_FEATURES) {
+        if (adapter.features.has(feature)) {
+            requiredFeatures.push(feature);
+        }
+    }
+    return await adapter.requestDevice({
+        requiredFeatures,
+        requiredLimits,
+    });
+}
+//# sourceMappingURL=litertlm_web.js.map

package/dist/litertlm_web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"litertlm_web.js","sourceRoot":"","sources":["../src/litertlm_web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,8DAA8D;AAE9D,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAGpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,iBAAiB,EAAE,CAAC,wBAAwB,EAAE,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,QAAQ;IACV,YAAY,CAAe;IACpC,MAAM,CAAC,iBAAiB,GAAG,0DAA0D,CAAC;IAEtF,YAAY,UAAsB;QAChC,IAAI,CAAC,YAAY,GAAG,UAA0B,CAAC;QAC/C,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC5B,IAAI,IAAI,CAAC,YAAY,CAAC,0BAA0B,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,0BAA0B;YACxC,MAAM,yBAAyB,EAAE,CAAC;IACxC,CAAC;IAED,MAAM;QACJ,iBAAiB;IACnB,CAAC;;AAGH,+DAA+D;AAC/D,MAAM,uBAAuB,GAAG;IAC9B,YAAY;IACZ,WAA6B;CACH,CAAC;AAE7B,KAAK,UAAU,yBAAyB;IACtC,MAAM,iBAAiB,GAA6B;QAClD,eAAe,EAAE,kBAAkB;KACpC,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,cAAc,GAAG;QACrB,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa;QAC3C,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,2BAA2B;QACvE,+BAA+B,EAC3B,OAAO,CAAC,MAAM,CAAC,+BAA+B;QAClD,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB;KAC5D,CAAC;IAEF,MAAM,gBAAgB,GAAqB,EAAE,CAAC;IAC9C,KAAK,MAAM,OAAO,IAAI,uBAAuB,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,OAAO,CAAC,aAAa,CAAC;QACjC,gBAAgB;QAChB,cAAc;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/load.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { LiteRtLm } from './litertlm_web';
+import { UrlPath } from './url_path_utils';
+/**
+ * Options for loading LiteRT-LM's Wasm module.
+ **/
+export interface LoadOptions {
+}
+/**
+ * Load the LiteRtLm library with WASM from the given URL. Does not set the
+ * global LiteRtLm instance.
+ */
+export declare function load(path: UrlPath, options?: LoadOptions): Promise<LiteRtLm>;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAkC,OAAO,EAAC,MAAM,kBAAkB,CAAC;AAM1E;;IAEI;AACJ,MAAM,WAAW,WAAW;CAAG;AAE/B;;;GAGG;AACH,wBAAsB,IAAI,CACtB,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB3D"}

package/dist/load.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { createWasmLib } from '@litertjs/wasm-utils';
+import { LiteRtLm } from './litertlm_web';
+import { appendPathSegment, pathToString } from './url_path_utils';
+import { supportsFeature } from './wasm_feature_detect';
+const WASM_JS_FILE_NAME = 'litertlm_wasm_internal.js';
+const WASM_JS_COMPAT_FILE_NAME = 'litertlm_wasm_compat_internal.js';
+/**
+ * Load the LiteRtLm library with WASM from the given URL. Does not set the
+ * global LiteRtLm instance.
+ */
+export async function load(path, options) {
+    const pathString = pathToString(path);
+    const relaxedSimd = await supportsFeature('relaxedSimd');
+    let fileName = WASM_JS_COMPAT_FILE_NAME;
+    if (relaxedSimd) {
+        fileName = WASM_JS_FILE_NAME;
+    }
+    let jsFilePath = path;
+    if (pathString.endsWith('.wasm')) {
+        throw new Error('Please load the `.js` file corresponding to the `.wasm` file, or ' +
+            'load the directory containing it.');
+    }
+    else if (!pathString.endsWith('.js')) {
+        jsFilePath = appendPathSegment(path, fileName);
+    }
+    return createWasmLib(LiteRtLm, jsFilePath);
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAC,iBAAiB,EAAE,YAAY,EAAU,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAEtD,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AACtD,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAOpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACtB,IAAa,EAAE,OAAqB;IACtC,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;IACzD,IAAI,QAAQ,GAAG,wBAAwB,CAAC;IACxC,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,GAAG,iBAAiB,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACX,mEAAmE;YACnE,mCAAmC,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC"}

package/dist/load_litertlm.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { LiteRtLm } from './litertlm_web';
+import { LoadOptions } from './load';
+type UrlString = string;
+/**
+ * Options for loading LiteRT-LM.
+ *
+ * @property threads Whether to load the threaded version of the Wasm module.
+ *     Defaults to false. Unused when specifying a .js file directly instead of
+ *     a directory containing the Wasm files.
+ **/
+export interface LoadLiteRtLmOptions extends LoadOptions {
+}
+/**
+ * Load LiteRT-LM Wasm files from the given URL. This needs to be called before
+ * calling any other LiteRT-LM functions.
+ *
+ * The URL can be:
+ *
+ * - A directory containing the LiteRT Wasm files (e.g. `.../wasm/`), or
+ * - The LiteRT-LM Wasm's js file (e.g. `.../litertlm_wasm_internal.js`)
+ *
+ * If the URL is to a directory, LiteRT-LM will detect what WASM features are
+ * available in the browser and load the compatible WASM file. If the URL is
+ * to a file, it will be loaded as is.
+ *
+ * @param path The path to the directory containing the LiteRT-LM Wasm files, or
+ *     the full URL of the LiteRT-LM Wasm .js file.
+ */
+export declare function loadLiteRtLm(path: UrlString, options?: LoadLiteRtLmOptions): Promise<LiteRtLm>;
+/**
+ * Unload the LiteRT-LM WASM module.
+ *
+ * This deletes the global LiteRT-LM instance and invalidate any models
+ * associated with it. You will need to call loadLiteRtLm() again to reload the
+ * module.
+ */
+export declare function unloadLiteRtLm(): void;
+/**
+ * Get the global LiteRT-LM instance, or load it if it hasn't been loaded yet.
+ */
+export declare function getOrLoadGlobalLiteRtLm(): Promise<LiteRtLm>;
+export {};
+//# sourceMappingURL=load_litertlm.d.ts.map

package/dist/load_litertlm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_litertlm.d.ts","sourceRoot":"","sources":["../src/load_litertlm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAO,WAAW,EAAC,MAAM,QAAQ,CAAC;AAEzC,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB;;;;;;IAMI;AACJ,MAAM,WAAW,mBAAoB,SAAQ,WAAW;CAAG;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CACxB,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAcrE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAYrC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE3D"}

package/dist/load_litertlm.js

@@ -0,0 +1,75 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Placeholder for internal dependency on trusted resource url type
+import { getGlobalLiteRtLm, getGlobalLiteRtLmPromise, hasGlobalLiteRtLm, hasGlobalLiteRtLmPromise, setGlobalLiteRtLm, setGlobalLiteRtLmPromise } from './global_litertlm';
+import { LiteRtLm } from './litertlm_web';
+import { load } from './load';
+/**
+ * Load LiteRT-LM Wasm files from the given URL. This needs to be called before
+ * calling any other LiteRT-LM functions.
+ *
+ * The URL can be:
+ *
+ * - A directory containing the LiteRT Wasm files (e.g. `.../wasm/`), or
+ * - The LiteRT-LM Wasm's js file (e.g. `.../litertlm_wasm_internal.js`)
+ *
+ * If the URL is to a directory, LiteRT-LM will detect what WASM features are
+ * available in the browser and load the compatible WASM file. If the URL is
+ * to a file, it will be loaded as is.
+ *
+ * @param path The path to the directory containing the LiteRT-LM Wasm files, or
+ *     the full URL of the LiteRT-LM Wasm .js file.
+ */
+export function loadLiteRtLm(path, options) {
+    if (hasGlobalLiteRtLmPromise()) {
+        throw new Error('LiteRT-LM is already loading / loaded.');
+    }
+    setGlobalLiteRtLmPromise(load(path, options)
+        .then(async (liteRtLm) => {
+        setGlobalLiteRtLm(liteRtLm);
+        return liteRtLm;
+    })
+        .catch(error => {
+        setGlobalLiteRtLmPromise(undefined);
+        throw error;
+    }));
+    return getGlobalLiteRtLmPromise();
+}
+/**
+ * Unload the LiteRT-LM WASM module.
+ *
+ * This deletes the global LiteRT-LM instance and invalidate any models
+ * associated with it. You will need to call loadLiteRtLm() again to reload the
+ * module.
+ */
+export function unloadLiteRtLm() {
+    if (hasGlobalLiteRtLmPromise() && !hasGlobalLiteRtLm()) {
+        throw new Error('LiteRT-LM is loading and can not be unloaded or canceled ' +
+            'until it is finished loading.');
+    }
+    if (hasGlobalLiteRtLm()) {
+        getGlobalLiteRtLm().delete();
+        setGlobalLiteRtLm(undefined);
+    }
+    setGlobalLiteRtLmPromise(undefined);
+}
+/**
+ * Get the global LiteRT-LM instance, or load it if it hasn't been loaded yet.
+ */
+export function getOrLoadGlobalLiteRtLm() {
+    return getGlobalLiteRtLmPromise() ?? loadLiteRtLm(LiteRtLm.DEFAULT_WASM_PATH);
+}
+//# sourceMappingURL=load_litertlm.js.map

package/dist/load_litertlm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_litertlm.js","sourceRoot":"","sources":["../src/load_litertlm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,mEAAmE;AAEnE,OAAO,EAAC,iBAAiB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,wBAAwB,EAAC,MAAM,mBAAmB,CAAC;AACxK,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAC,IAAI,EAAc,MAAM,QAAQ,CAAC;AAazC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CACxB,IAAe,EAAE,OAA6B;IAChD,IAAI,wBAAwB,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;SACd,IAAI,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE;QACrB,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;SACD,KAAK,CAAC,KAAK,CAAC,EAAE;QACb,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,wBAAwB,EAAG,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,wBAAwB,EAAE,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACX,2DAA2D;YAC3D,+BAA+B,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACxB,iBAAiB,EAAE,CAAC,MAAM,EAAE,CAAC;QAC7B,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,wBAAwB,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,wBAAwB,EAAE,IAAI,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAChF,CAAC"}

package/dist/mutex.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright 2026 The ODML Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * A mutual exclusion lock for managing asynchronous operations.
+ *
+ * In an Emscripten WebAssembly environment using Asyncify or JSPI, C++
+ * execution can be paused during asynchronous operations (such as waiting for
+ * WebGPU execution). While Wasm is paused, the JS event loop continues running.
+ * If JS invokes another Wasm binding function that attempts to acquire the same
+ * C++ mutex held by the paused stack frame, single-threaded C++ cannot yield
+ * and triggers an unrecoverable deadlock.
+ *
+ * This class prevents re-entrancy deadlocks by serializing all entry points
+ * from JavaScript into Wasm that interact with underlying C++ mutexes. Even
+ * seemingly synchronous tasks (like creating or deleting a session) must
+ * asynchronously wait for this mutex to ensure any paused C++ tasks have fully
+ * completed and released their locks.
+ */
+export declare class Mutex {
+    private mutexPromise;
+    private queueCount;
+    /**
+     * Whether the mutex is currently locked.
+     */
+    get isLocked(): boolean;
+    /**
+     * Executes the provided function once the mutex is acquired, and releases
+     * the mutex when the function completes.
+     */
+    acquireAndRun<T>(fn: () => Promise<T> | T): Promise<T>;
+}
+//# sourceMappingURL=mutex.d.ts.map

package/dist/mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../src/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,UAAU,CAAK;IAEvB;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;OAGG;IACG,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAe5D"}

package/dist/mutex.js

@@ -0,0 +1,62 @@
+/**
+ * Copyright 2026 The ODML Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * A mutual exclusion lock for managing asynchronous operations.
+ *
+ * In an Emscripten WebAssembly environment using Asyncify or JSPI, C++
+ * execution can be paused during asynchronous operations (such as waiting for
+ * WebGPU execution). While Wasm is paused, the JS event loop continues running.
+ * If JS invokes another Wasm binding function that attempts to acquire the same
+ * C++ mutex held by the paused stack frame, single-threaded C++ cannot yield
+ * and triggers an unrecoverable deadlock.
+ *
+ * This class prevents re-entrancy deadlocks by serializing all entry points
+ * from JavaScript into Wasm that interact with underlying C++ mutexes. Even
+ * seemingly synchronous tasks (like creating or deleting a session) must
+ * asynchronously wait for this mutex to ensure any paused C++ tasks have fully
+ * completed and released their locks.
+ */
+export class Mutex {
+    mutexPromise = Promise.resolve();
+    queueCount = 0;
+    /**
+     * Whether the mutex is currently locked.
+     */
+    get isLocked() {
+        return this.queueCount > 0;
+    }
+    /**
+     * Executes the provided function once the mutex is acquired, and releases
+     * the mutex when the function completes.
+     */
+    async acquireAndRun(fn) {
+        this.queueCount++;
+        const previousPromise = this.mutexPromise;
+        let resolveMutex;
+        this.mutexPromise = new Promise((resolve) => {
+            resolveMutex = resolve;
+        });
+        try {
+            await previousPromise;
+            return await fn();
+        }
+        finally {
+            this.queueCount--;
+            resolveMutex();
+        }
+    }
+}
+//# sourceMappingURL=mutex.js.map

package/dist/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../src/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,KAAK;IACR,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IACjC,UAAU,GAAG,CAAC,CAAC;IAEvB;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAI,EAAuB;QAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC;QAC1C,IAAI,YAAyB,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAChD,YAAY,GAAG,OAAO,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,eAAe,CAAC;YACtB,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,YAAY,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;CACF"}

package/dist/readable_stream_data_stream_wrapper.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright 2026 The ODML Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Wraps a ReadableStream for use in LiteRT LM C++ streamed model loading.
+ */
+export declare class ReadableStreamDataStreamWrapper {
+    private readonly stream;
+    private readonly getWasmHeap;
+    readonly bytesPerSlice: number;
+    private slices;
+    private streamDone;
+    private globalPosition;
+    private reader;
+    private leftoverData?;
+    private isReading;
+    constructor(stream: ReadableStream<Uint8Array>, getWasmHeap: () => Uint8Array, bytesPerSlice?: number);
+    private getViews;
+    private readInternal;
+    private fillBufferFromStream;
+    private doDiscard;
+    readAndDiscard(destAddress: number, offset: number | bigint, count: number | bigint): Promise<{
+        error?: Error;
+    }>;
+    readAndPreserve(destAddress: number, offset: number | bigint, count: number | bigint): Promise<{
+        error?: Error;
+    }>;
+    discard(offset: number | bigint, count: number | bigint): Promise<{
+        error?: Error;
+    }>;
+}
+//# sourceMappingURL=readable_stream_data_stream_wrapper.d.ts.map

package/dist/readable_stream_data_stream_wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readable_stream_data_stream_wrapper.d.ts","sourceRoot":"","sources":["../src/readable_stream_data_stream_wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiEH;;GAEG;AACH,qBAAa,+BAA+B;IActC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,QAAQ,CAAC,aAAa;IAhB1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO,CAAC,MAAM,CAIR;IACN,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,SAAS,CAAS;gBAGL,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAElC,WAAW,EAAE,MAAM,UAAU,EACrC,aAAa,SAAa;IAQvC,OAAO,CAAG,QAAQ;YAoFJ,YAAY;YAoDZ,oBAAoB;IA8ElC,OAAO,CAAC,SAAS;IAMX,cAAc,CAChB,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAC,MAAM,EAC1C,KAAK,EAAE,MAAM,GAAC,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAC,CAAC;IAU7C,eAAe,CACjB,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAC,MAAM,EAC1C,KAAK,EAAE,MAAM,GAAC,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAC,CAAC;IAU7C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAC,MAAM,GACrD,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAC,CAAC;CAQ7B"}