lindera-wasm-web 2.3.4 → 3.0.1

package/lindera_wasm.js

@@ -1,16 +1,5 @@
 /* @ts-self-types="./lindera_wasm.d.ts" */
 
-/**
- * Compression algorithm for dictionary data.
- * @enum {0 | 1 | 2 | 3}
- */
-export const CompressionAlgorithm = Object.freeze({
-    Deflate: 0, "0": "Deflate",
-    Zlib: 1, "1": "Zlib",
-    Gzip: 2, "2": "Gzip",
-    Raw: 3, "3": "Raw",
-});
-
 /**
  * A morphological analysis dictionary.
  */
@@ -295,13 +284,6 @@ export class Metadata {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_metadata_free(ptr, 0);
     }
-    /**
-     * @returns {CompressionAlgorithm}
-     */
-    get compress_algorithm() {
-        const ret = wasm.jsmetadata_compress_algorithm(this.__wbg_ptr);
-        return ret;
-    }
     /**
      * @returns {Metadata}
      */
@@ -349,24 +331,17 @@ export class Metadata {
     /**
      * @param {string | null} [name]
      * @param {string | null} [encoding]
-     * @param {CompressionAlgorithm | null} [compress_algorithm]
      */
-    constructor(name, encoding, compress_algorithm) {
+    constructor(name, encoding) {
         var ptr0 = isLikeNone(name) ? 0 : passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         var len0 = WASM_VECTOR_LEN;
         var ptr1 = isLikeNone(encoding) ? 0 : passStringToWasm0(encoding, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         var len1 = WASM_VECTOR_LEN;
-        const ret = wasm.jsmetadata_new(ptr0, len0, ptr1, len1, isLikeNone(compress_algorithm) ? 4 : compress_algorithm);
+        const ret = wasm.jsmetadata_new(ptr0, len0, ptr1, len1);
         this.__wbg_ptr = ret >>> 0;
         MetadataFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
-    /**
-     * @param {CompressionAlgorithm} algorithm
-     */
-    set compress_algorithm(algorithm) {
-        wasm.jsmetadata_set_compress_algorithm(this.__wbg_ptr, algorithm);
-    }
     /**
      * @param {Schema} schema
      */
@@ -970,6 +945,9 @@ export class TokenizerBuilder {
     }
     /**
      * Builds and returns a configured [`Tokenizer`] instance.
+     *
+     * If a dictionary instance was set via `setDictionaryInstance()`,
+     * it will be used directly instead of loading from a URI.
      * @returns {Tokenizer}
      */
     build() {
@@ -993,7 +971,7 @@ export class TokenizerBuilder {
         return this;
     }
     /**
-     * Sets the dictionary to use for tokenization.
+     * Sets the dictionary to use for tokenization by URI.
      * @param {string} uri
      */
     setDictionary(uri) {
@@ -1004,6 +982,18 @@ export class TokenizerBuilder {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Sets a pre-loaded dictionary instance for tokenization.
+     *
+     * Use this method when the dictionary has been loaded from bytes
+     * (e.g., via `loadDictionaryFromBytes()`) instead of from a URI.
+     * @param {Dictionary} dictionary
+     */
+    setDictionaryInstance(dictionary) {
+        _assertClass(dictionary, Dictionary);
+        var ptr0 = dictionary.__destroy_into_raw();
+        wasm.tokenizerbuilder_setDictionaryInstance(this.__wbg_ptr, ptr0);
+    }
     /**
      * Sets whether to keep whitespace tokens in the output.
      * @param {boolean} keep
@@ -1027,7 +1017,7 @@ export class TokenizerBuilder {
         }
     }
     /**
-     * Sets a user-defined dictionary.
+     * Sets a user-defined dictionary by URI.
      * @param {string} uri
      */
     setUserDictionary(uri) {
@@ -1038,6 +1028,18 @@ export class TokenizerBuilder {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Sets a pre-loaded user dictionary instance.
+     *
+     * Use this method when the user dictionary has been loaded from bytes
+     * instead of from a URI.
+     * @param {UserDictionary} user_dictionary
+     */
+    setUserDictionaryInstance(user_dictionary) {
+        _assertClass(user_dictionary, UserDictionary);
+        var ptr0 = user_dictionary.__destroy_into_raw();
+        wasm.tokenizerbuilder_setUserDictionaryInstance(this.__wbg_ptr, ptr0);
+    }
     /**
      * @param {string} uri
      */
@@ -1049,6 +1051,14 @@ export class TokenizerBuilder {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * @param {Dictionary} dictionary
+     */
+    set_dictionary_instance(dictionary) {
+        _assertClass(dictionary, Dictionary);
+        var ptr0 = dictionary.__destroy_into_raw();
+        wasm.tokenizerbuilder_set_dictionary_instance(this.__wbg_ptr, ptr0);
+    }
     /**
      * @param {boolean} keep
      */
@@ -1080,6 +1090,14 @@ export class TokenizerBuilder {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * @param {UserDictionary} user_dictionary
+     */
+    set_user_dictionary_instance(user_dictionary) {
+        _assertClass(user_dictionary, UserDictionary);
+        var ptr0 = user_dictionary.__destroy_into_raw();
+        wasm.tokenizerbuilder_set_user_dictionary_instance(this.__wbg_ptr, ptr0);
+    }
 }
 if (Symbol.dispose) TokenizerBuilder.prototype[Symbol.dispose] = TokenizerBuilder.prototype.free;
 
@@ -1220,6 +1238,61 @@ export function loadDictionary(uri) {
     return Dictionary.__wrap(ret[0]);
 }
 
+/**
+ * Loads a dictionary from raw byte arrays.
+ *
+ * This function constructs a `Dictionary` directly from the binary data
+ * of each dictionary component file, without requiring filesystem access.
+ * This is useful for loading dictionaries from OPFS or other browser storage.
+ *
+ * # Arguments
+ *
+ * * `metadata` - The contents of `metadata.json`
+ * * `dict_da` - The contents of `dict.da` (Double-Array Trie)
+ * * `dict_vals` - The contents of `dict.vals` (word value data)
+ * * `dict_words_idx` - The contents of `dict.wordsidx` (word details index)
+ * * `dict_words` - The contents of `dict.words` (word details)
+ * * `matrix_mtx` - The contents of `matrix.mtx` (connection cost matrix)
+ * * `char_def` - The contents of `char_def.bin` (character definitions)
+ * * `unk` - The contents of `unk.bin` (unknown word dictionary)
+ *
+ * # Returns
+ *
+ * A `Dictionary` instance constructed from the provided byte data.
+ * @param {Uint8Array} metadata
+ * @param {Uint8Array} dict_da
+ * @param {Uint8Array} dict_vals
+ * @param {Uint8Array} dict_words_idx
+ * @param {Uint8Array} dict_words
+ * @param {Uint8Array} matrix_mtx
+ * @param {Uint8Array} char_def
+ * @param {Uint8Array} unk
+ * @returns {Dictionary}
+ */
+export function loadDictionaryFromBytes(metadata, dict_da, dict_vals, dict_words_idx, dict_words, matrix_mtx, char_def, unk) {
+    const ptr0 = passArray8ToWasm0(metadata, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArray8ToWasm0(dict_da, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passArray8ToWasm0(dict_vals, wasm.__wbindgen_malloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ptr3 = passArray8ToWasm0(dict_words_idx, wasm.__wbindgen_malloc);
+    const len3 = WASM_VECTOR_LEN;
+    const ptr4 = passArray8ToWasm0(dict_words, wasm.__wbindgen_malloc);
+    const len4 = WASM_VECTOR_LEN;
+    const ptr5 = passArray8ToWasm0(matrix_mtx, wasm.__wbindgen_malloc);
+    const len5 = WASM_VECTOR_LEN;
+    const ptr6 = passArray8ToWasm0(char_def, wasm.__wbindgen_malloc);
+    const len6 = WASM_VECTOR_LEN;
+    const ptr7 = passArray8ToWasm0(unk, wasm.__wbindgen_malloc);
+    const len7 = WASM_VECTOR_LEN;
+    const ret = wasm.loadDictionaryFromBytes(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, ptr6, len6, ptr7, len7);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return Dictionary.__wrap(ret[0]);
+}
+
 /**
  * Loads a user dictionary from the specified URI.
  * @param {string} uri
@@ -1252,6 +1325,41 @@ export function load_dictionary(uri) {
     return Dictionary.__wrap(ret[0]);
 }
 
+/**
+ * @param {Uint8Array} metadata
+ * @param {Uint8Array} dict_da
+ * @param {Uint8Array} dict_vals
+ * @param {Uint8Array} dict_words_idx
+ * @param {Uint8Array} dict_words
+ * @param {Uint8Array} matrix_mtx
+ * @param {Uint8Array} char_def
+ * @param {Uint8Array} unk
+ * @returns {Dictionary}
+ */
+export function load_dictionary_from_bytes(metadata, dict_da, dict_vals, dict_words_idx, dict_words, matrix_mtx, char_def, unk) {
+    const ptr0 = passArray8ToWasm0(metadata, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArray8ToWasm0(dict_da, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passArray8ToWasm0(dict_vals, wasm.__wbindgen_malloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ptr3 = passArray8ToWasm0(dict_words_idx, wasm.__wbindgen_malloc);
+    const len3 = WASM_VECTOR_LEN;
+    const ptr4 = passArray8ToWasm0(dict_words, wasm.__wbindgen_malloc);
+    const len4 = WASM_VECTOR_LEN;
+    const ptr5 = passArray8ToWasm0(matrix_mtx, wasm.__wbindgen_malloc);
+    const len5 = WASM_VECTOR_LEN;
+    const ptr6 = passArray8ToWasm0(char_def, wasm.__wbindgen_malloc);
+    const len6 = WASM_VECTOR_LEN;
+    const ptr7 = passArray8ToWasm0(unk, wasm.__wbindgen_malloc);
+    const len7 = WASM_VECTOR_LEN;
+    const ret = wasm.load_dictionary_from_bytes(ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, ptr6, len6, ptr7, len7);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return Dictionary.__wrap(ret[0]);
+}
+
 /**
  * @param {string} uri
  * @param {Metadata} metadata
@@ -1289,7 +1397,7 @@ export function version() {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_83742b46f01ce22d: function(arg0, arg1) {
+        __wbg_Error_2e59b1b37a9a34c3: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
@@ -1300,64 +1408,64 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_bigint_get_as_i64_447a76b5c6ef7bda: function(arg0, arg1) {
+        __wbg___wbindgen_bigint_get_as_i64_2c5082002e4826e2: function(arg0, arg1) {
             const v = arg1;
             const ret = typeof(v) === 'bigint' ? v : undefined;
             getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_boolean_get_c0f3f60bac5a78d1: function(arg0) {
+        __wbg___wbindgen_boolean_get_a86c216575a75c30: function(arg0) {
             const v = arg0;
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_5398f5bb970e0daa: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_dd5d2d07ce9e6c57: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
             const len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_in_41dbb8413020e076: function(arg0, arg1) {
+        __wbg___wbindgen_in_4bd7a57e54337366: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_bigint_e2141d4f045b7eda: function(arg0) {
+        __wbg___wbindgen_is_bigint_6c98f7e945dacdde: function(arg0) {
             const ret = typeof(arg0) === 'bigint';
             return ret;
         },
-        __wbg___wbindgen_is_function_3c846841762788c1: function(arg0) {
+        __wbg___wbindgen_is_function_49868bde5eb1e745: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_null_0b605fc6b167c56f: function(arg0) {
+        __wbg___wbindgen_is_null_344c8750a8525473: function(arg0) {
             const ret = arg0 === null;
             return ret;
         },
-        __wbg___wbindgen_is_object_781bc9f159099513: function(arg0) {
+        __wbg___wbindgen_is_object_40c5a80572e8f9d3: function(arg0) {
             const val = arg0;
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_undefined_52709e72fb9f179c: function(arg0) {
+        __wbg___wbindgen_is_undefined_c0cca72b82b86f4d: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_eq_ee31bfad3e536463: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_eq_7d430e744a913d26: function(arg0, arg1) {
             const ret = arg0 === arg1;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_5bcc3bed3c69e72b: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_3a72ae764d46d944: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_34bb9d9dcfa21373: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_7579aab02a8a620c: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_395e606bd0ee4427: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_914df97fcfa788f2: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -1365,34 +1473,34 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_6ddd609b62940d55: function(arg0, arg1) {
+        __wbg___wbindgen_throw_81fc77679af83bc6: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_e133b57c9155d22c: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_7f2987183bb62793: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_done_08ce71ee07e3bd17: function(arg0) {
+        __wbg_done_547d467e97529006: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_entries_e8a20ff8c9757101: function(arg0) {
+        __wbg_entries_616b1a459b85be0b: function(arg0) {
             const ret = Object.entries(arg0);
             return ret;
         },
-        __wbg_get_326e41e095fb2575: function() { return handleError(function (arg0, arg1) {
-            const ret = Reflect.get(arg0, arg1);
-            return ret;
-        }, arguments); },
-        __wbg_get_a8ee5c45dabc1b3b: function(arg0, arg1) {
+        __wbg_get_4848e350b40afc16: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
-        __wbg_get_unchecked_329cfe50afab7352: function(arg0, arg1) {
+        __wbg_get_ed0642c4b9d31ddf: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(arg0, arg1);
+            return ret;
+        }, arguments); },
+        __wbg_get_unchecked_7d7babe32e9e6a54: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
-        __wbg_instanceof_ArrayBuffer_101e2bf31071a9f6: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_ff7c1337a5e3b33a: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof ArrayBuffer;
@@ -1402,7 +1510,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Map_f194b366846aca0c: function(arg0) {
+        __wbg_instanceof_Map_a10a2795ef4bfe97: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Map;
@@ -1412,7 +1520,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_740438561a5b956d: function(arg0) {
+        __wbg_instanceof_Uint8Array_4b8da683deb25d72: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -1422,54 +1530,54 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_33b91feb269ff46e: function(arg0) {
+        __wbg_isArray_db61795ad004c139: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_isSafeInteger_ecd6a7f9c3e053cd: function(arg0) {
+        __wbg_isSafeInteger_ea83862ba994770c: function(arg0) {
             const ret = Number.isSafeInteger(arg0);
             return ret;
         },
-        __wbg_iterator_d8f549ec8fb061b1: function() {
+        __wbg_iterator_de403ef31815a3e6: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_b3416cf66a5452c8: function(arg0) {
+        __wbg_length_0c32cb8543c8e4c8: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_ea16607d7b61445b: function(arg0) {
+        __wbg_length_6e821edde497a532: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_5f486cdf45a04d78: function(arg0) {
+        __wbg_new_4f9fafbb3909af72: function() {
+            const ret = new Object();
+            return ret;
+        },
+        __wbg_new_a560378ea1240b14: function(arg0) {
             const ret = new Uint8Array(arg0);
             return ret;
         },
-        __wbg_new_a70fbab9066b301f: function() {
+        __wbg_new_f3c9df4f38f3f798: function() {
             const ret = new Array();
             return ret;
         },
-        __wbg_new_ab79df5bd7c26067: function() {
-            const ret = new Object();
+        __wbg_next_01132ed6134b8ef5: function(arg0) {
+            const ret = arg0.next;
             return ret;
         },
-        __wbg_next_11b99ee6237339e3: function() { return handleError(function (arg0) {
+        __wbg_next_b3713ec761a9dbfd: function() { return handleError(function (arg0) {
             const ret = arg0.next();
             return ret;
         }, arguments); },
-        __wbg_next_e01a967809d1aa68: function(arg0) {
-            const ret = arg0.next;
-            return ret;
-        },
-        __wbg_prototypesetcall_d62e5099504357e6: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_3e05eb9545565046: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_push_e87b0e732085a946: function(arg0, arg1) {
+        __wbg_push_6bdbc990be5ac37b: function(arg0, arg1) {
             const ret = arg0.push(arg1);
             return ret;
         },
-        __wbg_set_7eaa4f96924fd6b3: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_set_8ee2d34facb8466e: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = Reflect.set(arg0, arg1, arg2);
             return ret;
         }, arguments); },
@@ -1477,7 +1585,7 @@ function __wbg_get_imports() {
             const ret = Token.__wrap(arg0);
             return ret;
         },
-        __wbg_value_21fc78aab0322612: function(arg0) {
+        __wbg_value_7f6052747ccf940f: function(arg0) {
             const ret = arg0.value;
             return ret;
         },
@@ -1678,6 +1786,13 @@ function isLikeNone(x) {
     return x === undefined || x === null;
 }
 
+function passArray8ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 1, 1) >>> 0;
+    getUint8ArrayMemory0().set(arg, ptr / 1);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
 function passArrayJsValueToWasm0(array, malloc) {
     const ptr = malloc(array.length * 4, 4) >>> 0;
     for (let i = 0; i < array.length; i++) {

package/opfs.d.ts

@@ -0,0 +1,84 @@
+/**
+ * OPFS (Origin Private File System) helper utilities for Lindera WASM.
+ *
+ * @module opfs
+ */
+
+/** Dictionary binary file data loaded from OPFS. */
+export interface DictionaryFiles {
+  /** Contents of metadata.json */
+  metadata: Uint8Array;
+  /** Contents of dict.da (Double-Array Trie) */
+  dictDa: Uint8Array;
+  /** Contents of dict.vals (word value data) */
+  dictVals: Uint8Array;
+  /** Contents of dict.wordsidx (word details index) */
+  dictWordsIdx: Uint8Array;
+  /** Contents of dict.words (word details) */
+  dictWords: Uint8Array;
+  /** Contents of matrix.mtx (connection cost matrix) */
+  matrixMtx: Uint8Array;
+  /** Contents of char_def.bin (character definitions) */
+  charDef: Uint8Array;
+  /** Contents of unk.bin (unknown word dictionary) */
+  unk: Uint8Array;
+}
+
+/** Progress information passed to the onProgress callback. */
+export interface DownloadProgress {
+  /** Current phase of the operation. */
+  phase: "downloading" | "extracting" | "storing" | "complete";
+  /** Bytes downloaded so far (only during "downloading" phase). */
+  loaded?: number;
+  /** Total bytes to download, if known (only during "downloading" phase). */
+  total?: number;
+}
+
+/** Options for downloadDictionary(). */
+export interface DownloadDictionaryOptions {
+  /** Progress callback. */
+  onProgress?: (progress: DownloadProgress) => void;
+}
+
+/**
+ * Downloads a dictionary archive, extracts it, and stores the files in OPFS.
+ *
+ * @param url - URL of the dictionary zip archive.
+ * @param name - Name to store the dictionary under (e.g., "ipadic").
+ * @param options - Optional settings.
+ */
+export function downloadDictionary(
+  url: string,
+  name: string,
+  options?: DownloadDictionaryOptions,
+): Promise<void>;
+
+/**
+ * Loads dictionary files from OPFS as an object of Uint8Arrays.
+ *
+ * @param name - The dictionary name (e.g., "ipadic").
+ * @returns Object containing the dictionary file data.
+ */
+export function loadDictionaryFiles(name: string): Promise<DictionaryFiles>;
+
+/**
+ * Removes a dictionary from OPFS.
+ *
+ * @param name - The dictionary name to remove.
+ */
+export function removeDictionary(name: string): Promise<void>;
+
+/**
+ * Lists all dictionaries stored in OPFS.
+ *
+ * @returns Array of dictionary names.
+ */
+export function listDictionaries(): Promise<string[]>;
+
+/**
+ * Checks if a dictionary exists in OPFS.
+ *
+ * @param name - The dictionary name to check.
+ * @returns True if the dictionary exists.
+ */
+export function hasDictionary(name: string): Promise<boolean>;