react-native-jieba 0.2.0 → 0.3.0

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,QAAQ","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

@@ -3,10 +3,26 @@
 import { Platform } from 'react-native';
 import Jieba from './NativeJieba';
 import JiebaAndroidHelper from "./NativeJiebaAndroidHelper.js";
-let initPromise = null;
-export function initJieba(_options = {}) {
-  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(_options = {}) {
     }
     // 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","_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":[]}
+{"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

@@ -1,10 +1,17 @@
 "use strict";
 
-import { setJiebaWasm } from "./NativeJieba.web.js";
-let initPromise = null;
-export function initJieba(options = {}) {
-  if (initPromise) return initPromise;
-  initPromise = (async () => {
+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.
@@ -20,9 +27,14 @@ export function initJieba(options = {}) {
     await wasm.default(options.wasmUrl);
     setJiebaWasm(wasm);
   })().catch(err => {
-    initPromise = null;
+    preparePromise = null;
     throw err;
   });
-  return initPromise;
+  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

@@ -1 +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":[]}
+{"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/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

@@ -10,6 +10,7 @@ export type JiebaWasmModule = {
     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

@@ -1 +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"}
+{"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,4 +1,4 @@
-export type InitJiebaOptions = {
+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
@@ -6,5 +6,28 @@ export type InitJiebaOptions = {
      */
     wasmUrl?: string | URL | Request;
 };
-export declare function initJieba(_options?: InitJiebaOptions): Promise<void>;
+/**
+ * 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":"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"}
+{"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

@@ -1,4 +1,18 @@
-import type { InitJiebaOptions } from './init';
-export type { InitJiebaOptions } from './init';
-export declare function initJieba(options?: InitJiebaOptions): Promise<void>;
+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

@@ -1 +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"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-jieba",
-  "version": "0.2.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",

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

@@ -3,7 +3,7 @@ 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
+// throw otherwise. The wasm module is loaded lazily by `prepareJieba()` (see
 // `init.web.ts`) and handed to this shim via `setJiebaWasm`.
 
 export type JiebaWasmModule = {
@@ -23,17 +23,25 @@ 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 initialized. ' +
-        'Call (and await) initJieba() before any segmentation call.'
+      '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.
   },

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,7 +2,7 @@ import { Platform } from 'react-native';
 import Jieba from './NativeJieba';
 import JiebaAndroidHelper from './NativeJiebaAndroidHelper';
 
-export type InitJiebaOptions = {
+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
@@ -11,11 +11,28 @@ export type InitJiebaOptions = {
   wasmUrl?: string | URL | Request;
 };
 
-let initPromise: Promise<void> | null = null;
+let preparePromise: Promise<void> | null = null;
 
-export function initJieba(_options: InitJiebaOptions = {}): Promise<void> {
-  if (initPromise) return initPromise;
-  initPromise = (async () => {
+/**
+ * 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(
@@ -27,8 +44,19 @@ export function initJieba(_options: InitJiebaOptions = {}): 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

@@ -1,13 +1,29 @@
-import { setJiebaWasm, type JiebaWasmModule } from './NativeJieba.web';
-import type { InitJiebaOptions } from './init';
+import {
+  setJiebaWasm,
+  isJiebaWasmReady,
+  type JiebaWasmModule,
+} from './NativeJieba.web';
 
-export type { InitJiebaOptions } from './init';
+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 initPromise: Promise<void> | null = null;
+let preparePromise: Promise<void> | null = null;
 
-export function initJieba(options: InitJiebaOptions = {}): Promise<void> {
-  if (initPromise) return initPromise;
-  initPromise = (async () => {
+/**
+ * **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.
@@ -25,8 +41,13 @@ export function initJieba(options: InitJiebaOptions = {}): Promise<void> {
     await wasm.default(options.wasmUrl);
     setJiebaWasm(wasm);
   })().catch((err) => {
-    initPromise = null;
+    preparePromise = null;
     throw err;
   });
-  return initPromise;
+  return preparePromise;
+}
+
+/** Whether the wasm module has been loaded and jieba can segment. */
+export function isJiebaReady(): boolean {
+  return isJiebaWasmReady();
 }