react-native-jieba 0.1.0 → 0.3.0

package/lib/module/NativeJieba.web.js

@@ -0,0 +1,66 @@
+"use strict";
+
+// `jieba-wasm` exposes the same segmentation primitives as cppjieba, but a
+// smaller surface: cut / cutAll / cutForSearch / tag / add_word. The remaining
+// native methods are polyfilled on top of those where the semantics allow, and
+// throw otherwise. The wasm module is loaded lazily by `prepareJieba()` (see
+// `init.web.ts`) and handed to this shim via `setJiebaWasm`.
+
+let wasm = null;
+export function setJiebaWasm(module) {
+  wasm = module;
+}
+export function isJiebaWasmReady() {
+  return wasm !== null;
+}
+function getWasm() {
+  if (!wasm) {
+    throw new Error('react-native-jieba: jieba-wasm is not loaded yet. ' + 'On web you must call (and await) prepareJieba() before any ' + 'segmentation call.');
+  }
+  return wasm;
+}
+const Jieba = {
+  isReady() {
+    return isJiebaWasmReady();
+  },
+  setDictPath() {
+    // No-op on web: jieba-wasm bundles its own dictionary.
+  },
+  cut(sentence, hmm) {
+    return getWasm().cut(sentence, hmm);
+  },
+  cutAll(sentence) {
+    return getWasm().cut_all(sentence);
+  },
+  cutForSearch(sentence, hmm) {
+    return getWasm().cut_for_search(sentence, hmm);
+  },
+  cutHMM(sentence) {
+    // jieba-wasm has no HMM-only mode; precise cut with HMM enabled is the
+    // closest equivalent.
+    return getWasm().cut(sentence, true);
+  },
+  cutSmall(sentence, _maxWordLen) {
+    // jieba-wasm does not expose a max-word-length cut; fall back to precise
+    // cut. The maxWordLen argument is accepted for API parity but ignored.
+    return getWasm().cut(sentence, true);
+  },
+  tag(sentence) {
+    return getWasm().tag(sentence);
+  },
+  extract() {
+    throw new Error('react-native-jieba: extract() (TF-IDF keyword extraction) is not ' + 'supported on web — jieba-wasm does not ship the IDF dictionary.');
+  },
+  insertUserWord(word, tag) {
+    // add_word returns the inserted word's frequency (>= 0 on success).
+    return getWasm().add_word(word, undefined, tag === '' ? undefined : tag) >= 0;
+  },
+  find(word) {
+    // jieba-wasm has no dictionary lookup; approximate it by checking whether
+    // the word survives precise (non-HMM) segmentation as a single token.
+    const segments = getWasm().cut(word, false);
+    return segments.length === 1 && segments[0] === word;
+  }
+};
+export default Jieba;
+//# sourceMappingURL=NativeJieba.web.js.map

package/lib/module/NativeJieba.web.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["wasm","setJiebaWasm","module","isJiebaWasmReady","getWasm","Error","Jieba","isReady","setDictPath","cut","sentence","hmm","cutAll","cut_all","cutForSearch","cut_for_search","cutHMM","cutSmall","_maxWordLen","tag","extract","insertUserWord","word","add_word","undefined","find","segments","length"],"sourceRoot":"../../src","sources":["NativeJieba.web.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;;AAaA,IAAIA,IAA4B,GAAG,IAAI;AAEvC,OAAO,SAASC,YAAYA,CAACC,MAAuB,EAAQ;EAC1DF,IAAI,GAAGE,MAAM;AACf;AAEA,OAAO,SAASC,gBAAgBA,CAAA,EAAY;EAC1C,OAAOH,IAAI,KAAK,IAAI;AACtB;AAEA,SAASI,OAAOA,CAAA,EAAoB;EAClC,IAAI,CAACJ,IAAI,EAAE;IACT,MAAM,IAAIK,KAAK,CACb,oDAAoD,GAClD,6DAA6D,GAC7D,oBACJ,CAAC;EACH;EACA,OAAOL,IAAI;AACb;AAEA,MAAMM,KAAW,GAAG;EAClBC,OAAOA,CAAA,EAAG;IACR,OAAOJ,gBAAgB,CAAC,CAAC;EAC3B,CAAC;EACDK,WAAWA,CAAA,EAAG;IACZ;EAAA,CACD;EACDC,GAAGA,CAACC,QAAQ,EAAEC,GAAG,EAAE;IACjB,OAAOP,OAAO,CAAC,CAAC,CAACK,GAAG,CAACC,QAAQ,EAAEC,GAAG,CAAC;EACrC,CAAC;EACDC,MAAMA,CAACF,QAAQ,EAAE;IACf,OAAON,OAAO,CAAC,CAAC,CAACS,OAAO,CAACH,QAAQ,CAAC;EACpC,CAAC;EACDI,YAAYA,CAACJ,QAAQ,EAAEC,GAAG,EAAE;IAC1B,OAAOP,OAAO,CAAC,CAAC,CAACW,cAAc,CAACL,QAAQ,EAAEC,GAAG,CAAC;EAChD,CAAC;EACDK,MAAMA,CAACN,QAAQ,EAAE;IACf;IACA;IACA,OAAON,OAAO,CAAC,CAAC,CAACK,GAAG,CAACC,QAAQ,EAAE,IAAI,CAAC;EACtC,CAAC;EACDO,QAAQA,CAACP,QAAQ,EAAEQ,WAAW,EAAE;IAC9B;IACA;IACA,OAAOd,OAAO,CAAC,CAAC,CAACK,GAAG,CAACC,QAAQ,EAAE,IAAI,CAAC;EACtC,CAAC;EACDS,GAAGA,CAACT,QAAQ,EAAE;IACZ,OAAON,OAAO,CAAC,CAAC,CAACe,GAAG,CAACT,QAAQ,CAAC;EAChC,CAAC;EACDU,OAAOA,CAAA,EAAG;IACR,MAAM,IAAIf,KAAK,CACb,mEAAmE,GACjE,iEACJ,CAAC;EACH,CAAC;EACDgB,cAAcA,CAACC,IAAI,EAAEH,GAAG,EAAE;IACxB;IACA,OACEf,OAAO,CAAC,CAAC,CAACmB,QAAQ,CAACD,IAAI,EAAEE,SAAS,EAAEL,GAAG,KAAK,EAAE,GAAGK,SAAS,GAAGL,GAAG,CAAC,IAAI,CAAC;EAE1E,CAAC;EACDM,IAAIA,CAACH,IAAI,EAAE;IACT;IACA;IACA,MAAMI,QAAQ,GAAGtB,OAAO,CAAC,CAAC,CAACK,GAAG,CAACa,IAAI,EAAE,KAAK,CAAC;IAC3C,OAAOI,QAAQ,CAACC,MAAM,KAAK,CAAC,IAAID,QAAQ,CAAC,CAAC,CAAC,KAAKJ,IAAI;EACtD;AACF,CAAC;AAED,eAAehB,KAAK","ignoreList":[]}

package/lib/module/index.js

@@ -1,5 +1,5 @@
 "use strict";
 
 export { cut, cutAll, cutForSearch, cutHMM, cutSmall, tag, extract, insertUserWord, find } from "./jieba.js";
-export { initJieba } from "./init.js";
+export { prepareJieba, isJiebaReady } from './init';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["cut","cutAll","cutForSearch","cutHMM","cutSmall","tag","extract","insertUserWord","find","initJieba"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SACEA,GAAG,EACHC,MAAM,EACNC,YAAY,EACZC,MAAM,EACNC,QAAQ,EACRC,GAAG,EACHC,OAAO,EACPC,cAAc,EACdC,IAAI,QACC,YAAS;AAEhB,SAASC,SAAS,QAAQ,WAAQ","ignoreList":[]}
+{"version":3,"names":["cut","cutAll","cutForSearch","cutHMM","cutSmall","tag","extract","insertUserWord","find","prepareJieba","isJiebaReady"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SACEA,GAAG,EACHC,MAAM,EACNC,YAAY,EACZC,MAAM,EACNC,QAAQ,EACRC,GAAG,EACHC,OAAO,EACPC,cAAc,EACdC,IAAI,QACC,YAAS;AAEhB,SAASC,YAAY,EAAEC,YAAY,QAAQ,QAAQ","ignoreList":[]}

package/lib/module/init.js

@@ -1,12 +1,28 @@
 "use strict";
 
 import { Platform } from 'react-native';
-import Jieba from "./NativeJieba.js";
+import Jieba from './NativeJieba';
 import JiebaAndroidHelper from "./NativeJiebaAndroidHelper.js";
-let initPromise = null;
-export function initJieba() {
-  if (initPromise) return initPromise;
-  initPromise = (async () => {
+let preparePromise = null;
+
+/**
+ * Optional on native (iOS/Android): the dictionary is located/extracted
+ * automatically on the first segmentation call, so you can call `cut`, `tag`,
+ * etc. directly without ever calling `prepareJieba`.
+ *
+ * Calling it is still useful as a *warm-up*: on Android's very first run the
+ * dictionary assets are extracted from the APK, and doing that work here
+ * (asynchronously, up front) avoids a one-time blocking pause on the first
+ * `cut`/`tag` call.
+ *
+ * On web it is **required** — it loads and instantiates the `jieba-wasm`
+ * binary, which cannot be done synchronously.
+ *
+ * Idempotent: repeated calls return the same promise.
+ */
+export function prepareJieba(_options = {}) {
+  if (preparePromise) return preparePromise;
+  preparePromise = (async () => {
     if (Platform.OS === 'android') {
       if (!JiebaAndroidHelper) {
         throw new Error('react-native-jieba: JiebaAndroidHelper native module is missing.');
@@ -16,9 +32,20 @@ export function initJieba() {
     }
     // iOS: OnLoad.mm already configured the dict path from the bundle.
   })().catch(err => {
-    initPromise = null;
+    preparePromise = null;
     throw err;
   });
-  return initPromise;
+  return preparePromise;
+}
+
+/**
+ * Whether jieba is ready to segment synchronously.
+ *
+ * Backed by the native engine state (not by whether `prepareJieba` was called),
+ * so it stays correct even when the dictionary is resolved lazily on the first
+ * `cut`/`tag` call. On iOS this is `true` from app launch.
+ */
+export function isJiebaReady() {
+  return Jieba.isReady();
 }
 //# sourceMappingURL=init.js.map

package/lib/module/init.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","Jieba","JiebaAndroidHelper","initPromise","initJieba","OS","Error","path","prepareDictDir","setDictPath","catch","err"],"sourceRoot":"../../src","sources":["init.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,KAAK,MAAM,kBAAe;AACjC,OAAOC,kBAAkB,MAAM,+BAA4B;AAE3D,IAAIC,WAAiC,GAAG,IAAI;AAE5C,OAAO,SAASC,SAASA,CAAA,EAAkB;EACzC,IAAID,WAAW,EAAE,OAAOA,WAAW;EACnCA,WAAW,GAAG,CAAC,YAAY;IACzB,IAAIH,QAAQ,CAACK,EAAE,KAAK,SAAS,EAAE;MAC7B,IAAI,CAACH,kBAAkB,EAAE;QACvB,MAAM,IAAII,KAAK,CACb,kEACF,CAAC;MACH;MACA,MAAMC,IAAI,GAAG,MAAML,kBAAkB,CAACM,cAAc,CAAC,CAAC;MACtDP,KAAK,CAACQ,WAAW,CAACF,IAAI,CAAC;IACzB;IACA;EACF,CAAC,EAAE,CAAC,CAACG,KAAK,CAAEC,GAAG,IAAK;IAClBR,WAAW,GAAG,IAAI;IAClB,MAAMQ,GAAG;EACX,CAAC,CAAC;EACF,OAAOR,WAAW;AACpB","ignoreList":[]}
+{"version":3,"names":["Platform","Jieba","JiebaAndroidHelper","preparePromise","prepareJieba","_options","OS","Error","path","prepareDictDir","setDictPath","catch","err","isJiebaReady","isReady"],"sourceRoot":"../../src","sources":["init.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,KAAK,MAAM,eAAe;AACjC,OAAOC,kBAAkB,MAAM,+BAA4B;AAW3D,IAAIC,cAAoC,GAAG,IAAI;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAC1BC,QAA6B,GAAG,CAAC,CAAC,EACnB;EACf,IAAIF,cAAc,EAAE,OAAOA,cAAc;EACzCA,cAAc,GAAG,CAAC,YAAY;IAC5B,IAAIH,QAAQ,CAACM,EAAE,KAAK,SAAS,EAAE;MAC7B,IAAI,CAACJ,kBAAkB,EAAE;QACvB,MAAM,IAAIK,KAAK,CACb,kEACF,CAAC;MACH;MACA,MAAMC,IAAI,GAAG,MAAMN,kBAAkB,CAACO,cAAc,CAAC,CAAC;MACtDR,KAAK,CAACS,WAAW,CAACF,IAAI,CAAC;IACzB;IACA;EACF,CAAC,EAAE,CAAC,CAACG,KAAK,CAAEC,GAAG,IAAK;IAClBT,cAAc,GAAG,IAAI;IACrB,MAAMS,GAAG;EACX,CAAC,CAAC;EACF,OAAOT,cAAc;AACvB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASU,YAAYA,CAAA,EAAY;EACtC,OAAOZ,KAAK,CAACa,OAAO,CAAC,CAAC;AACxB","ignoreList":[]}

package/lib/module/init.web.js

@@ -0,0 +1,40 @@
+"use strict";
+
+import { setJiebaWasm, isJiebaWasmReady } from "./NativeJieba.web.js";
+let preparePromise = null;
+
+/**
+ * **Required on web**: loads and instantiates the `jieba-wasm` binary (which
+ * cannot be done synchronously). Await it once before calling `cut`, `tag`, etc.
+ *
+ * Idempotent: repeated calls return the same promise.
+ */
+export function prepareJieba(options = {}) {
+  if (preparePromise) return preparePromise;
+  preparePromise = (async () => {
+    // `jieba-wasm` resolves to its `web` build under the `browser`/`import`
+    // conditions, whose default export is an async initializer that fetches
+    // and instantiates the wasm binary.
+    const wasm = await import('jieba-wasm');
+
+    // With no argument, jieba-wasm's `web` initializer resolves the binary via
+    // `new URL('jieba_rs_wasm_bg.wasm', import.meta.url)` *relative to its own
+    // module*, which bundlers (Vite, Webpack 5, …) rewrite to the correct
+    // emitted asset URL in both dev and production. Only pass `wasmUrl` when the
+    // consumer explicitly overrides where the binary is served from — passing a
+    // wrong/relative path here makes the dev server return index.html and wasm
+    // instantiation fails with a bad magic word.
+    await wasm.default(options.wasmUrl);
+    setJiebaWasm(wasm);
+  })().catch(err => {
+    preparePromise = null;
+    throw err;
+  });
+  return preparePromise;
+}
+
+/** Whether the wasm module has been loaded and jieba can segment. */
+export function isJiebaReady() {
+  return isJiebaWasmReady();
+}
+//# sourceMappingURL=init.web.js.map

package/lib/module/init.web.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["setJiebaWasm","isJiebaWasmReady","preparePromise","prepareJieba","options","wasm","default","wasmUrl","catch","err","isJiebaReady"],"sourceRoot":"../../src","sources":["init.web.ts"],"mappings":";;AAAA,SACEA,YAAY,EACZC,gBAAgB,QAEX,sBAAmB;AAW1B,IAAIC,cAAoC,GAAG,IAAI;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,OAA4B,GAAG,CAAC,CAAC,EAAiB;EAC7E,IAAIF,cAAc,EAAE,OAAOA,cAAc;EACzCA,cAAc,GAAG,CAAC,YAAY;IAC5B;IACA;IACA;IACA,MAAMG,IAAI,GAAI,MAAM,MAAM,CAAC,YAAY,CAEpB;;IAEnB;IACA;IACA;IACA;IACA;IACA;IACA;IACA,MAAMA,IAAI,CAACC,OAAO,CAACF,OAAO,CAACG,OAAO,CAAC;IACnCP,YAAY,CAACK,IAAI,CAAC;EACpB,CAAC,EAAE,CAAC,CAACG,KAAK,CAAEC,GAAG,IAAK;IAClBP,cAAc,GAAG,IAAI;IACrB,MAAMO,GAAG;EACX,CAAC,CAAC;EACF,OAAOP,cAAc;AACvB;;AAEA;AACA,OAAO,SAASQ,YAAYA,CAAA,EAAY;EACtC,OAAOT,gBAAgB,CAAC,CAAC;AAC3B","ignoreList":[]}

package/lib/module/jieba.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import Jieba from "./NativeJieba.js";
+import Jieba from './NativeJieba';
 export function cut(sentence, hmm = true) {
   return Jieba.cut(sentence, hmm);
 }

package/lib/module/jieba.js.map

@@ -1 +1 @@
-{"version":3,"names":["Jieba","cut","sentence","hmm","cutAll","cutForSearch","cutHMM","cutSmall","maxWordLen","tag","extract","topK","insertUserWord","word","find"],"sourceRoot":"../../src","sources":["jieba.ts"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,kBAAe;AAKjC,OAAO,SAASC,GAAGA,CAACC,QAAgB,EAAEC,GAAY,GAAG,IAAI,EAAY;EACnE,OAAOH,KAAK,CAACC,GAAG,CAACC,QAAQ,EAAEC,GAAG,CAAC;AACjC;AAEA,OAAO,SAASC,MAAMA,CAACF,QAAgB,EAAY;EACjD,OAAOF,KAAK,CAACI,MAAM,CAACF,QAAQ,CAAC;AAC/B;AAEA,OAAO,SAASG,YAAYA,CAC1BH,QAAgB,EAChBC,GAAY,GAAG,IAAI,EACT;EACV,OAAOH,KAAK,CAACK,YAAY,CAACH,QAAQ,EAAEC,GAAG,CAAC;AAC1C;AAEA,OAAO,SAASG,MAAMA,CAACJ,QAAgB,EAAY;EACjD,OAAOF,KAAK,CAACM,MAAM,CAACJ,QAAQ,CAAC;AAC/B;AAEA,OAAO,SAASK,QAAQA,CAACL,QAAgB,EAAEM,UAAkB,EAAY;EACvE,OAAOR,KAAK,CAACO,QAAQ,CAACL,QAAQ,EAAEM,UAAU,CAAC;AAC7C;AAEA,OAAO,SAASC,GAAGA,CAACP,QAAgB,EAAY;EAC9C,OAAOF,KAAK,CAACS,GAAG,CAACP,QAAQ,CAAC;AAC5B;AAEA,OAAO,SAASQ,OAAOA,CAACR,QAAgB,EAAES,IAAY,GAAG,CAAC,EAAa;EACrE,OAAOX,KAAK,CAACU,OAAO,CAACR,QAAQ,EAAES,IAAI,CAAC;AACtC;AAEA,OAAO,SAASC,cAAcA,CAACC,IAAY,EAAEJ,GAAW,GAAG,EAAE,EAAW;EACtE,OAAOT,KAAK,CAACY,cAAc,CAACC,IAAI,EAAEJ,GAAG,CAAC;AACxC;AAEA,OAAO,SAASK,IAAIA,CAACD,IAAY,EAAW;EAC1C,OAAOb,KAAK,CAACc,IAAI,CAACD,IAAI,CAAC;AACzB","ignoreList":[]}
+{"version":3,"names":["Jieba","cut","sentence","hmm","cutAll","cutForSearch","cutHMM","cutSmall","maxWordLen","tag","extract","topK","insertUserWord","word","find"],"sourceRoot":"../../src","sources":["jieba.ts"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,eAAe;AAKjC,OAAO,SAASC,GAAGA,CAACC,QAAgB,EAAEC,GAAY,GAAG,IAAI,EAAY;EACnE,OAAOH,KAAK,CAACC,GAAG,CAACC,QAAQ,EAAEC,GAAG,CAAC;AACjC;AAEA,OAAO,SAASC,MAAMA,CAACF,QAAgB,EAAY;EACjD,OAAOF,KAAK,CAACI,MAAM,CAACF,QAAQ,CAAC;AAC/B;AAEA,OAAO,SAASG,YAAYA,CAACH,QAAgB,EAAEC,GAAY,GAAG,IAAI,EAAY;EAC5E,OAAOH,KAAK,CAACK,YAAY,CAACH,QAAQ,EAAEC,GAAG,CAAC;AAC1C;AAEA,OAAO,SAASG,MAAMA,CAACJ,QAAgB,EAAY;EACjD,OAAOF,KAAK,CAACM,MAAM,CAACJ,QAAQ,CAAC;AAC/B;AAEA,OAAO,SAASK,QAAQA,CAACL,QAAgB,EAAEM,UAAkB,EAAY;EACvE,OAAOR,KAAK,CAACO,QAAQ,CAACL,QAAQ,EAAEM,UAAU,CAAC;AAC7C;AAEA,OAAO,SAASC,GAAGA,CAACP,QAAgB,EAAY;EAC9C,OAAOF,KAAK,CAACS,GAAG,CAACP,QAAQ,CAAC;AAC5B;AAEA,OAAO,SAASQ,OAAOA,CAACR,QAAgB,EAAES,IAAY,GAAG,CAAC,EAAa;EACrE,OAAOX,KAAK,CAACU,OAAO,CAACR,QAAQ,EAAES,IAAI,CAAC;AACtC;AAEA,OAAO,SAASC,cAAcA,CAACC,IAAY,EAAEJ,GAAW,GAAG,EAAE,EAAW;EACtE,OAAOT,KAAK,CAACY,cAAc,CAACC,IAAI,EAAEJ,GAAG,CAAC;AACxC;AAEA,OAAO,SAASK,IAAIA,CAACD,IAAY,EAAW;EAC1C,OAAOb,KAAK,CAACc,IAAI,CAACD,IAAI,CAAC;AACzB","ignoreList":[]}

package/lib/typescript/src/NativeJieba.d.ts

@@ -1,5 +1,6 @@
 import { type TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
+    isReady(): boolean;
     setDictPath(path: string): void;
     cut(sentence: string, hmm: boolean): string[];
     cutAll(sentence: string): string[];

package/lib/typescript/src/NativeJieba.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeJieba.d.ts","sourceRoot":"","sources":["../../../src/NativeJieba.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;;AAED,wBAA+D"}
+{"version":3,"file":"NativeJieba.d.ts","sourceRoot":"","sources":["../../../src/NativeJieba.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,OAAO,IAAI,OAAO,CAAC;IACnB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;;AAED,wBAA+D"}

package/lib/typescript/src/NativeJieba.web.d.ts

@@ -0,0 +1,16 @@
+import type { Spec } from './NativeJieba';
+export type JiebaWasmModule = {
+    cut(text: string, hmm?: boolean | null): string[];
+    cut_all(text: string): string[];
+    cut_for_search(text: string, hmm?: boolean | null): string[];
+    tag(sentence: string, hmm?: boolean | null): Array<{
+        word: string;
+        tag: string;
+    }>;
+    add_word(word: string, freq?: number | null, tag?: string | null): number;
+};
+export declare function setJiebaWasm(module: JiebaWasmModule): void;
+export declare function isJiebaWasmReady(): boolean;
+declare const Jieba: Spec;
+export default Jieba;
+//# sourceMappingURL=NativeJieba.web.d.ts.map

package/lib/typescript/src/NativeJieba.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeJieba.web.d.ts","sourceRoot":"","sources":["../../../src/NativeJieba.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAQ1C,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;IAClD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;IAC7D,GAAG,CACD,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,GACnB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;CAC3E,CAAC;AAIF,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE1D;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAaD,QAAA,MAAM,KAAK,EAAE,IA+CZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,4 +1,5 @@
 export { cut, cutAll, cutForSearch, cutHMM, cutSmall, tag, extract, insertUserWord, find, } from './jieba';
 export type { Tagged, Keyword } from './jieba';
-export { initJieba } from './init';
+export { prepareJieba, isJiebaReady } from './init';
+export type { PrepareJiebaOptions } from './init';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,MAAM,EACN,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,GAAG,EACH,OAAO,EACP,cAAc,EACd,IAAI,GACL,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,MAAM,EACN,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,GAAG,EACH,OAAO,EACP,cAAc,EACd,IAAI,GACL,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC"}

package/lib/typescript/src/init.d.ts

@@ -1,2 +1,33 @@
-export declare function initJieba(): Promise<void>;
+export type PrepareJiebaOptions = {
+    /**
+     * Web only: URL (or fetch input) for the jieba-wasm `.wasm` binary. Most
+     * bundlers resolve it automatically, so this is only needed when the asset
+     * is served from a custom location. Ignored on iOS and Android.
+     */
+    wasmUrl?: string | URL | Request;
+};
+/**
+ * Optional on native (iOS/Android): the dictionary is located/extracted
+ * automatically on the first segmentation call, so you can call `cut`, `tag`,
+ * etc. directly without ever calling `prepareJieba`.
+ *
+ * Calling it is still useful as a *warm-up*: on Android's very first run the
+ * dictionary assets are extracted from the APK, and doing that work here
+ * (asynchronously, up front) avoids a one-time blocking pause on the first
+ * `cut`/`tag` call.
+ *
+ * On web it is **required** — it loads and instantiates the `jieba-wasm`
+ * binary, which cannot be done synchronously.
+ *
+ * Idempotent: repeated calls return the same promise.
+ */
+export declare function prepareJieba(_options?: PrepareJiebaOptions): Promise<void>;
+/**
+ * Whether jieba is ready to segment synchronously.
+ *
+ * Backed by the native engine state (not by whether `prepareJieba` was called),
+ * so it stays correct even when the dictionary is resolved lazily on the first
+ * `cut`/`tag` call. On iOS this is `true` from app launch.
+ */
+export declare function isJiebaReady(): boolean;
 //# sourceMappingURL=init.d.ts.map

package/lib/typescript/src/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/init.ts"],"names":[],"mappings":"AAMA,wBAAgB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBzC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/init.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;CAClC,CAAC;AAIF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,mBAAwB,GACjC,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/lib/typescript/src/init.web.d.ts

@@ -0,0 +1,18 @@
+export type PrepareJiebaOptions = {
+    /**
+     * URL (or fetch input) for the jieba-wasm `.wasm` binary. Most bundlers
+     * resolve it automatically, so this is only needed when the asset is served
+     * from a custom location.
+     */
+    wasmUrl?: string | URL | Request;
+};
+/**
+ * **Required on web**: loads and instantiates the `jieba-wasm` binary (which
+ * cannot be done synchronously). Await it once before calling `cut`, `tag`, etc.
+ *
+ * Idempotent: repeated calls return the same promise.
+ */
+export declare function prepareJieba(options?: PrepareJiebaOptions): Promise<void>;
+/** Whether the wasm module has been loaded and jieba can segment. */
+export declare function isJiebaReady(): boolean;
+//# sourceMappingURL=init.web.d.ts.map

package/lib/typescript/src/init.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.web.d.ts","sourceRoot":"","sources":["../../../src/init.web.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;CAClC,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB7E;AAED,qEAAqE;AACrE,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/lib/typescript/src/jieba.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jieba.d.ts","sourceRoot":"","sources":["../../../src/jieba.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,OAAc,GAAG,MAAM,EAAE,CAEnE;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,OAAc,GAClB,MAAM,EAAE,CAEV;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9C;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,EAAE,CAErE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAW,GAAG,OAAO,CAEtE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1C"}
+{"version":3,"file":"jieba.d.ts","sourceRoot":"","sources":["../../../src/jieba.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,OAAc,GAAG,MAAM,EAAE,CAEnE;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,OAAc,GAAG,MAAM,EAAE,CAE5E;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9C;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,EAAE,CAErE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAW,GAAG,OAAO,CAEtE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-jieba",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Native Chinese text segmentation for React Native, powered by cppjieba.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -15,6 +15,9 @@
   "files": [
     "src",
     "lib",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
     "android/build.gradle",
     "android/CMakeLists.txt",
     "android/generated",
@@ -23,6 +26,8 @@
     "ios/generated",
     "cpp/JiebaImpl.h",
     "cpp/JiebaImpl.cpp",
+    "cpp/JiebaDictAndroid.h",
+    "cpp/JiebaDictAndroid.cpp",
     "cpp/cppjieba/LICENSE",
     "cpp/cppjieba/include/cppjieba",
     "cpp/cppjieba/deps/limonp/LICENSE",
@@ -94,6 +99,7 @@
     "eslint-plugin-ft-flow": "^3.0.11",
     "eslint-plugin-prettier": "^5.5.5",
     "jest": "^30.3.0",
+    "jieba-wasm": "^2.4.0",
     "lefthook": "^2.1.4",
     "prettier": "^3.8.1",
     "react": "19.2.3",
@@ -105,9 +111,15 @@
     "typescript": "^6.0.2"
   },
   "peerDependencies": {
+    "jieba-wasm": ">=2.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.85.0"
   },
+  "peerDependenciesMeta": {
+    "jieba-wasm": {
+      "optional": true
+    }
+  },
   "workspaces": [
     "example"
   ],

package/src/NativeJieba.ts

@@ -1,6 +1,7 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
 
 export interface Spec extends TurboModule {
+  isReady(): boolean;
   setDictPath(path: string): void;
   cut(sentence: string, hmm: boolean): string[];
   cutAll(sentence: string): string[];

package/src/NativeJieba.web.ts

@@ -0,0 +1,90 @@
+import type { Spec } from './NativeJieba';
+
+// `jieba-wasm` exposes the same segmentation primitives as cppjieba, but a
+// smaller surface: cut / cutAll / cutForSearch / tag / add_word. The remaining
+// native methods are polyfilled on top of those where the semantics allow, and
+// throw otherwise. The wasm module is loaded lazily by `prepareJieba()` (see
+// `init.web.ts`) and handed to this shim via `setJiebaWasm`.
+
+export type JiebaWasmModule = {
+  cut(text: string, hmm?: boolean | null): string[];
+  cut_all(text: string): string[];
+  cut_for_search(text: string, hmm?: boolean | null): string[];
+  tag(
+    sentence: string,
+    hmm?: boolean | null
+  ): Array<{ word: string; tag: string }>;
+  add_word(word: string, freq?: number | null, tag?: string | null): number;
+};
+
+let wasm: JiebaWasmModule | null = null;
+
+export function setJiebaWasm(module: JiebaWasmModule): void {
+  wasm = module;
+}
+
+export function isJiebaWasmReady(): boolean {
+  return wasm !== null;
+}
+
+function getWasm(): JiebaWasmModule {
+  if (!wasm) {
+    throw new Error(
+      'react-native-jieba: jieba-wasm is not loaded yet. ' +
+        'On web you must call (and await) prepareJieba() before any ' +
+        'segmentation call.'
+    );
+  }
+  return wasm;
+}
+
+const Jieba: Spec = {
+  isReady() {
+    return isJiebaWasmReady();
+  },
+  setDictPath() {
+    // No-op on web: jieba-wasm bundles its own dictionary.
+  },
+  cut(sentence, hmm) {
+    return getWasm().cut(sentence, hmm);
+  },
+  cutAll(sentence) {
+    return getWasm().cut_all(sentence);
+  },
+  cutForSearch(sentence, hmm) {
+    return getWasm().cut_for_search(sentence, hmm);
+  },
+  cutHMM(sentence) {
+    // jieba-wasm has no HMM-only mode; precise cut with HMM enabled is the
+    // closest equivalent.
+    return getWasm().cut(sentence, true);
+  },
+  cutSmall(sentence, _maxWordLen) {
+    // jieba-wasm does not expose a max-word-length cut; fall back to precise
+    // cut. The maxWordLen argument is accepted for API parity but ignored.
+    return getWasm().cut(sentence, true);
+  },
+  tag(sentence) {
+    return getWasm().tag(sentence);
+  },
+  extract() {
+    throw new Error(
+      'react-native-jieba: extract() (TF-IDF keyword extraction) is not ' +
+        'supported on web — jieba-wasm does not ship the IDF dictionary.'
+    );
+  },
+  insertUserWord(word, tag) {
+    // add_word returns the inserted word's frequency (>= 0 on success).
+    return (
+      getWasm().add_word(word, undefined, tag === '' ? undefined : tag) >= 0
+    );
+  },
+  find(word) {
+    // jieba-wasm has no dictionary lookup; approximate it by checking whether
+    // the word survives precise (non-HMM) segmentation as a single token.
+    const segments = getWasm().cut(word, false);
+    return segments.length === 1 && segments[0] === word;
+  },
+};
+
+export default Jieba;

package/src/index.tsx

@@ -10,4 +10,5 @@ export {
   find,
 } from './jieba';
 export type { Tagged, Keyword } from './jieba';
-export { initJieba } from './init';
+export { prepareJieba, isJiebaReady } from './init';
+export type { PrepareJiebaOptions } from './init';

package/src/init.ts

@@ -2,11 +2,37 @@ import { Platform } from 'react-native';
 import Jieba from './NativeJieba';
 import JiebaAndroidHelper from './NativeJiebaAndroidHelper';
 
-let initPromise: Promise<void> | null = null;
+export type PrepareJiebaOptions = {
+  /**
+   * Web only: URL (or fetch input) for the jieba-wasm `.wasm` binary. Most
+   * bundlers resolve it automatically, so this is only needed when the asset
+   * is served from a custom location. Ignored on iOS and Android.
+   */
+  wasmUrl?: string | URL | Request;
+};
 
-export function initJieba(): Promise<void> {
-  if (initPromise) return initPromise;
-  initPromise = (async () => {
+let preparePromise: Promise<void> | null = null;
+
+/**
+ * Optional on native (iOS/Android): the dictionary is located/extracted
+ * automatically on the first segmentation call, so you can call `cut`, `tag`,
+ * etc. directly without ever calling `prepareJieba`.
+ *
+ * Calling it is still useful as a *warm-up*: on Android's very first run the
+ * dictionary assets are extracted from the APK, and doing that work here
+ * (asynchronously, up front) avoids a one-time blocking pause on the first
+ * `cut`/`tag` call.
+ *
+ * On web it is **required** — it loads and instantiates the `jieba-wasm`
+ * binary, which cannot be done synchronously.
+ *
+ * Idempotent: repeated calls return the same promise.
+ */
+export function prepareJieba(
+  _options: PrepareJiebaOptions = {}
+): Promise<void> {
+  if (preparePromise) return preparePromise;
+  preparePromise = (async () => {
     if (Platform.OS === 'android') {
       if (!JiebaAndroidHelper) {
         throw new Error(
@@ -18,8 +44,19 @@ export function initJieba(): Promise<void> {
     }
     // iOS: OnLoad.mm already configured the dict path from the bundle.
   })().catch((err) => {
-    initPromise = null;
+    preparePromise = null;
     throw err;
   });
-  return initPromise;
+  return preparePromise;
+}
+
+/**
+ * Whether jieba is ready to segment synchronously.
+ *
+ * Backed by the native engine state (not by whether `prepareJieba` was called),
+ * so it stays correct even when the dictionary is resolved lazily on the first
+ * `cut`/`tag` call. On iOS this is `true` from app launch.
+ */
+export function isJiebaReady(): boolean {
+  return Jieba.isReady();
 }

package/src/init.web.ts

@@ -0,0 +1,53 @@
+import {
+  setJiebaWasm,
+  isJiebaWasmReady,
+  type JiebaWasmModule,
+} from './NativeJieba.web';
+
+export type PrepareJiebaOptions = {
+  /**
+   * URL (or fetch input) for the jieba-wasm `.wasm` binary. Most bundlers
+   * resolve it automatically, so this is only needed when the asset is served
+   * from a custom location.
+   */
+  wasmUrl?: string | URL | Request;
+};
+
+let preparePromise: Promise<void> | null = null;
+
+/**
+ * **Required on web**: loads and instantiates the `jieba-wasm` binary (which
+ * cannot be done synchronously). Await it once before calling `cut`, `tag`, etc.
+ *
+ * Idempotent: repeated calls return the same promise.
+ */
+export function prepareJieba(options: PrepareJiebaOptions = {}): Promise<void> {
+  if (preparePromise) return preparePromise;
+  preparePromise = (async () => {
+    // `jieba-wasm` resolves to its `web` build under the `browser`/`import`
+    // conditions, whose default export is an async initializer that fetches
+    // and instantiates the wasm binary.
+    const wasm = (await import('jieba-wasm')) as unknown as {
+      default: (input?: string | URL | Request) => Promise<unknown>;
+    } & JiebaWasmModule;
+
+    // With no argument, jieba-wasm's `web` initializer resolves the binary via
+    // `new URL('jieba_rs_wasm_bg.wasm', import.meta.url)` *relative to its own
+    // module*, which bundlers (Vite, Webpack 5, …) rewrite to the correct
+    // emitted asset URL in both dev and production. Only pass `wasmUrl` when the
+    // consumer explicitly overrides where the binary is served from — passing a
+    // wrong/relative path here makes the dev server return index.html and wasm
+    // instantiation fails with a bad magic word.
+    await wasm.default(options.wasmUrl);
+    setJiebaWasm(wasm);
+  })().catch((err) => {
+    preparePromise = null;
+    throw err;
+  });
+  return preparePromise;
+}
+
+/** Whether the wasm module has been loaded and jieba can segment. */
+export function isJiebaReady(): boolean {
+  return isJiebaWasmReady();
+}

package/src/jieba.ts

@@ -11,10 +11,7 @@ export function cutAll(sentence: string): string[] {
   return Jieba.cutAll(sentence);
 }
 
-export function cutForSearch(
-  sentence: string,
-  hmm: boolean = true
-): string[] {
+export function cutForSearch(sentence: string, hmm: boolean = true): string[] {
   return Jieba.cutForSearch(sentence, hmm);
 }