react-native-jieba 0.1.0 → 0.2.0

package/README.md

@@ -5,6 +5,7 @@ Native Chinese text segmentation for React Native, powered by [cppjieba](https:/
 - Runs on the New Architecture as a C++ Turbo Module — no bridge overhead, no JS port of jieba.
 - Ships the cppjieba dictionaries (`jieba.dict.utf8`, `hmm_model.utf8`, `idf.utf8`, `stop_words.utf8`, `user.dict.utf8`) inside the package, bundled as iOS pod resources and Android assets.
 - Supports the standard jieba modes: precise (`cut`), full (`cutAll`), search engine (`cutForSearch`), HMM (`cutHMM`), small-word (`cutSmall`), POS tagging (`tag`), and TF-IDF keyword extraction (`extract`).
+- Works on **web** (react-native-web) via [`jieba-wasm`](https://github.com/fengkx/jieba-wasm), with the same API.
 
 ## Requirements
 
@@ -28,6 +29,23 @@ cd ios && pod install
 
 Android: no extra steps — autolinking picks up the AAR.
 
+Web (react-native-web): install the optional `jieba-wasm` peer dependency, which provides the WebAssembly backend.
+
+```sh
+npm install jieba-wasm
+```
+
+Any bundler that handles `.wasm` assets (Vite, Webpack 5, Metro-web, etc.) will bundle the binary automatically.
+
+If you use **Vite**, exclude `jieba-wasm` from dependency pre-bundling so its `.wasm` is served from the package directory (otherwise the binary isn't copied into `.vite/deps` and the fetch 404s):
+
+```js
+// vite.config.js
+export default {
+  optimizeDeps: { exclude: ['jieba-wasm'] },
+};
+```
+
 ## Usage
 
 Call `initJieba()` once before the first segmentation call. On iOS the dictionary path is resolved from the app bundle automatically; on Android it extracts the bundled assets to `filesDir/jieba-dict/` on first run.
@@ -62,11 +80,11 @@ extract('我是拖拉机学院手扶拖拉机专业的。', 5);
 
 ## API
 
-All segmentation calls are synchronous JSI calls — no Promises.
+On native, all segmentation calls are synchronous JSI calls — no Promises. On web they are synchronous too, but `initJieba()` must finish first (it loads the wasm module).
 
 | Function | Signature | Notes |
 | --- | --- | --- |
-| `initJieba()` | `() => Promise<void>` | Must be awaited once before any other call. Idempotent. |
+| `initJieba(options?)` | `(options?: { wasmUrl?: string \| URL \| Request }) => Promise<void>` | Must be awaited once before any other call. Idempotent. `wasmUrl` is web-only and rarely needed (override where the `.wasm` is served). |
 | `cut(sentence, hmm?)` | `(string, boolean) => string[]` | Precise mode. `hmm` defaults to `true`. |
 | `cutAll(sentence)` | `(string) => string[]` | Full mode (every possible word). |
 | `cutForSearch(sentence, hmm?)` | `(string, boolean) => string[]` | Search-engine mode. |
@@ -77,12 +95,90 @@ All segmentation calls are synchronous JSI calls — no Promises.
 | `insertUserWord(word, tag?)` | `(string, string) => boolean` | Adds a user dictionary word at runtime. |
 | `find(word)` | `(string) => boolean` | Tests whether a word is in the dictionary. |
 
+### Web support
+
+On web the implementation is backed by [`jieba-wasm`](https://github.com/fengkx/jieba-wasm) (jieba-rs compiled to WebAssembly) instead of cppjieba. The core API is identical, with a few caveats because jieba-wasm exposes a smaller surface:
+
+| Function | Web behavior |
+| --- | --- |
+| `cut`, `cutAll`, `cutForSearch`, `tag` | Fully supported. |
+| `insertUserWord` | Supported (maps to jieba-wasm `add_word`); the `tag` argument is honored, frequency is auto-assigned. |
+| `cutHMM` | Falls back to `cut(sentence, true)` (jieba-wasm has no HMM-only mode). |
+| `cutSmall` | Falls back to `cut`; the `maxWordLen` argument is accepted for parity but ignored. |
+| `find` | Approximated: returns `true` when the word survives precise (non-HMM) segmentation as a single token. |
+| `extract` | **Not supported** — throws. jieba-wasm does not ship the IDF dictionary needed for TF-IDF extraction. |
+
+#### Example (Vite + react-native-web)
+
+```js
+// vite.config.js
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: { 'react-native': 'react-native-web' },
+  },
+  // jieba-wasm resolves its `.wasm` via `import.meta.url`; pre-bundling into
+  // `.vite/deps` would leave the binary behind, so exclude it.
+  optimizeDeps: { exclude: ['jieba-wasm'] },
+});
+```
+
+```tsx
+// App.tsx
+import { useEffect, useState } from 'react';
+import { Platform, Text, View } from 'react-native';
+import { initJieba, cut, cutForSearch, tag, extract } from 'react-native-jieba';
+
+export default function App() {
+  const [words, setWords] = useState<string[] | null>(null);
+
+  useEffect(() => {
+    // On web this loads + instantiates the wasm module (async).
+    // On native it's a near-instant no-op / dict-path setup.
+    initJieba()
+      .then(() => {
+        setWords(cut('我来到北京清华大学'));
+        // → ['我', '来到', '北京', '清华大学']
+
+        cutForSearch('小明硕士毕业于中国科学院计算所');
+        // → ['小明', '硕士', '毕业', '于', '中国', '科学', '学院', ...]
+
+        tag('我爱北京天安门');
+        // → [{ word: '我', tag: 'r' }, { word: '爱', tag: 'v' }, ...]
+
+        // extract() throws on web — guard it for cross-platform code.
+        const keywords = Platform.OS === 'web' ? [] : extract('…', 5);
+      })
+      .catch((e) => console.error(e));
+  }, []);
+
+  if (!words) return <Text>Loading…</Text>;
+  return (
+    <View>
+      {words.map((w, i) => (
+        <Text key={i}>{w}</Text>
+      ))}
+    </View>
+  );
+}
+```
+
+To self-host the binary (CDN or custom path), pass `wasmUrl`:
+
+```ts
+await initJieba({ wasmUrl: 'https://cdn.example.com/jieba_rs_wasm_bg.wasm' });
+```
+
 ## How it works
 
 - The Turbo Module lives in `cpp/JiebaImpl.{h,cpp}` and wraps `cppjieba::Jieba` as a JSI Cxx module.
 - iOS resolves the dictionary directory from `NSBundle` in `ios/OnLoad.mm` before the module is registered, so `initJieba()` is a no-op on iOS.
 - Android ships the dictionary as AAR assets and extracts them on demand via `JiebaAndroidHelperModule`, which then hands the path to the C++ module via the codegen-exposed `setDictPath` JSI method.
 - cppjieba and its `limonp` dependency are vendored as git submodules under `cpp/cppjieba/`. The published npm tarball contains only the headers and dictionaries that are actually needed at build time.
+- On web, `react-native-web`'s bundler resolution picks up `src/NativeJieba.web.ts` and `src/init.web.ts`. `initJieba()` lazily imports `jieba-wasm`, awaits its async wasm initializer, and routes the JS API to the wasm exports.
 
 ## Contributing
 

package/lib/module/NativeJieba.web.js

@@ -0,0 +1,60 @@
+"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 `initJieba()` (see
+// `init.web.ts`) and handed to this shim via `setJiebaWasm`.
+
+let wasm = null;
+export function setJiebaWasm(module) {
+  wasm = module;
+}
+function getWasm() {
+  if (!wasm) {
+    throw new Error('react-native-jieba: jieba-wasm is not initialized. ' + 'Call (and await) initJieba() before any segmentation call.');
+  }
+  return wasm;
+}
+const Jieba = {
+  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","getWasm","Error","Jieba","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,SAASC,OAAOA,CAAA,EAAoB;EAClC,IAAI,CAACH,IAAI,EAAE;IACT,MAAM,IAAII,KAAK,CACb,qDAAqD,GACnD,4DACJ,CAAC;EACH;EACA,OAAOJ,IAAI;AACb;AAEA,MAAMK,KAAW,GAAG;EAClBC,WAAWA,CAAA,EAAG;IACZ;EAAA,CACD;EACDC,GAAGA,CAACC,QAAQ,EAAEC,GAAG,EAAE;IACjB,OAAON,OAAO,CAAC,CAAC,CAACI,GAAG,CAACC,QAAQ,EAAEC,GAAG,CAAC;EACrC,CAAC;EACDC,MAAMA,CAACF,QAAQ,EAAE;IACf,OAAOL,OAAO,CAAC,CAAC,CAACQ,OAAO,CAACH,QAAQ,CAAC;EACpC,CAAC;EACDI,YAAYA,CAACJ,QAAQ,EAAEC,GAAG,EAAE;IAC1B,OAAON,OAAO,CAAC,CAAC,CAACU,cAAc,CAACL,QAAQ,EAAEC,GAAG,CAAC;EAChD,CAAC;EACDK,MAAMA,CAACN,QAAQ,EAAE;IACf;IACA;IACA,OAAOL,OAAO,CAAC,CAAC,CAACI,GAAG,CAACC,QAAQ,EAAE,IAAI,CAAC;EACtC,CAAC;EACDO,QAAQA,CAACP,QAAQ,EAAEQ,WAAW,EAAE;IAC9B;IACA;IACA,OAAOb,OAAO,CAAC,CAAC,CAACI,GAAG,CAACC,QAAQ,EAAE,IAAI,CAAC;EACtC,CAAC;EACDS,GAAGA,CAACT,QAAQ,EAAE;IACZ,OAAOL,OAAO,CAAC,CAAC,CAACc,GAAG,CAACT,QAAQ,CAAC;EAChC,CAAC;EACDU,OAAOA,CAAA,EAAG;IACR,MAAM,IAAId,KAAK,CACb,mEAAmE,GACjE,iEACJ,CAAC;EACH,CAAC;EACDe,cAAcA,CAACC,IAAI,EAAEH,GAAG,EAAE;IACxB;IACA,OACEd,OAAO,CAAC,CAAC,CAACkB,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,GAAGrB,OAAO,CAAC,CAAC,CAACI,GAAG,CAACa,IAAI,EAAE,KAAK,CAAC;IAC3C,OAAOI,QAAQ,CAACC,MAAM,KAAK,CAAC,IAAID,QAAQ,CAAC,CAAC,CAAC,KAAKJ,IAAI;EACtD;AACF,CAAC;AAED,eAAef,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 { initJieba } 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","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,QAAQ","ignoreList":[]}

package/lib/module/init.js

@@ -1,10 +1,10 @@
 "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() {
+export function initJieba(_options = {}) {
   if (initPromise) return initPromise;
   initPromise = (async () => {
     if (Platform.OS === 'android') {

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","initPromise","initJieba","_options","OS","Error","path","prepareDictDir","setDictPath","catch","err"],"sourceRoot":"../../src","sources":["init.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,KAAK,MAAM,eAAe;AACjC,OAAOC,kBAAkB,MAAM,+BAA4B;AAW3D,IAAIC,WAAiC,GAAG,IAAI;AAE5C,OAAO,SAASC,SAASA,CAACC,QAA0B,GAAG,CAAC,CAAC,EAAiB;EACxE,IAAIF,WAAW,EAAE,OAAOA,WAAW;EACnCA,WAAW,GAAG,CAAC,YAAY;IACzB,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,WAAW,GAAG,IAAI;IAClB,MAAMS,GAAG;EACX,CAAC,CAAC;EACF,OAAOT,WAAW;AACpB","ignoreList":[]}

package/lib/module/init.web.js

@@ -0,0 +1,28 @@
+"use strict";
+
+import { setJiebaWasm } from "./NativeJieba.web.js";
+let initPromise = null;
+export function initJieba(options = {}) {
+  if (initPromise) return initPromise;
+  initPromise = (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 => {
+    initPromise = null;
+    throw err;
+  });
+  return initPromise;
+}
+//# sourceMappingURL=init.web.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["setJiebaWasm","initPromise","initJieba","options","wasm","default","wasmUrl","catch","err"],"sourceRoot":"../../src","sources":["init.web.ts"],"mappings":";;AAAA,SAASA,YAAY,QAA8B,sBAAmB;AAKtE,IAAIC,WAAiC,GAAG,IAAI;AAE5C,OAAO,SAASC,SAASA,CAACC,OAAyB,GAAG,CAAC,CAAC,EAAiB;EACvE,IAAIF,WAAW,EAAE,OAAOA,WAAW;EACnCA,WAAW,GAAG,CAAC,YAAY;IACzB;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;IACnCN,YAAY,CAACI,IAAI,CAAC;EACpB,CAAC,EAAE,CAAC,CAACG,KAAK,CAAEC,GAAG,IAAK;IAClBP,WAAW,GAAG,IAAI;IAClB,MAAMO,GAAG;EACX,CAAC,CAAC;EACF,OAAOP,WAAW;AACpB","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.web.d.ts

@@ -0,0 +1,15 @@
+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;
+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;AAYD,QAAA,MAAM,KAAK,EAAE,IA4CZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

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

@@ -1,2 +1,10 @@
-export declare function initJieba(): Promise<void>;
+export type InitJiebaOptions = {
+    /**
+     * 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 declare function initJieba(_options?: InitJiebaOptions): Promise<void>;
 //# 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,gBAAgB,GAAG;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;CAClC,CAAC;AAIF,wBAAgB,SAAS,CAAC,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE"}

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

@@ -0,0 +1,4 @@
+import type { InitJiebaOptions } from './init';
+export type { InitJiebaOptions } from './init';
+export declare function initJieba(options?: InitJiebaOptions): Promise<void>;
+//# 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":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAI/C,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBvE"}

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.2.0",
   "description": "Native Chinese text segmentation for React Native, powered by cppjieba.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -94,6 +94,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 +106,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.web.ts

@@ -0,0 +1,82 @@
+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 `initJieba()` (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;
+}
+
+function getWasm(): JiebaWasmModule {
+  if (!wasm) {
+    throw new Error(
+      'react-native-jieba: jieba-wasm is not initialized. ' +
+        'Call (and await) initJieba() before any segmentation call.'
+    );
+  }
+  return wasm;
+}
+
+const Jieba: Spec = {
+  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/init.ts

@@ -2,9 +2,18 @@ import { Platform } from 'react-native';
 import Jieba from './NativeJieba';
 import JiebaAndroidHelper from './NativeJiebaAndroidHelper';
 
+export type InitJiebaOptions = {
+  /**
+   * 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;
+};
+
 let initPromise: Promise<void> | null = null;
 
-export function initJieba(): Promise<void> {
+export function initJieba(_options: InitJiebaOptions = {}): Promise<void> {
   if (initPromise) return initPromise;
   initPromise = (async () => {
     if (Platform.OS === 'android') {

package/src/init.web.ts

@@ -0,0 +1,32 @@
+import { setJiebaWasm, type JiebaWasmModule } from './NativeJieba.web';
+import type { InitJiebaOptions } from './init';
+
+export type { InitJiebaOptions } from './init';
+
+let initPromise: Promise<void> | null = null;
+
+export function initJieba(options: InitJiebaOptions = {}): Promise<void> {
+  if (initPromise) return initPromise;
+  initPromise = (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) => {
+    initPromise = null;
+    throw err;
+  });
+  return initPromise;
+}

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);
 }