react-native-jieba 0.2.0 → 0.4.0

package/cpp/JiebaEngine.h

@@ -0,0 +1,128 @@
+#pragma once
+
+#include <cppjieba/DictTrie.hpp>
+#include <cppjieba/FullSegment.hpp>
+#include <cppjieba/HMMModel.hpp>
+#include <cppjieba/HMMSegment.hpp>
+#include <cppjieba/KeywordExtractor.hpp>
+#include <cppjieba/MPSegment.hpp>
+#include <cppjieba/MixSegment.hpp>
+#include <cppjieba/QuerySegment.hpp>
+
+#include <memory>
+#include <string>
+#include <utility>
+#include <vector>
+
+namespace rnjieba {
+
+/**
+ * A cppjieba engine whose keyword extractor is built ON DEMAND.
+ *
+ * `cppjieba::Jieba` holds `KeywordExtractor` by value, so its constructor always
+ * loads `idf.utf8` and hard-fails (XCHECK) when that file is absent. That makes the
+ * ~5MB IDF dictionary a mandatory dependency of plain segmentation, even though only
+ * `extract()` ever reads it.
+ *
+ * This type composes the same cppjieba primitives directly, sharing one `DictTrie` and
+ * one `HMMModel` across every segmenter exactly as `cppjieba::Jieba` does, but defers the
+ * `KeywordExtractor` until `extract()` is first called. Apps that only tokenize therefore
+ * never load the IDF dictionary — and may omit the file from their bundle entirely (see
+ * `excludeIdfDict` in the README).
+ */
+class JiebaEngine {
+public:
+  JiebaEngine(
+    std::string dictPath,
+    std::string hmmModelPath,
+    std::string userDictPath,
+    std::string idfPath,
+    std::string stopWordPath
+  )
+    : idfPath_(std::move(idfPath)),
+      stopWordPath_(std::move(stopWordPath)),
+      dictTrie_(dictPath, userDictPath),
+      model_(hmmModelPath),
+      mpSeg_(&dictTrie_),
+      hmmSeg_(&model_),
+      mixSeg_(&dictTrie_, &model_),
+      fullSeg_(&dictTrie_),
+      querySeg_(&dictTrie_, &model_) {}
+
+  void Cut(const std::string& sentence, std::vector<std::string>& words, bool hmm) const {
+    mixSeg_.Cut(sentence, words, hmm);
+  }
+  void CutAll(const std::string& sentence, std::vector<std::string>& words) const {
+    fullSeg_.Cut(sentence, words);
+  }
+  void CutForSearch(const std::string& sentence, std::vector<std::string>& words, bool hmm) const {
+    querySeg_.Cut(sentence, words, hmm);
+  }
+  void CutHMM(const std::string& sentence, std::vector<std::string>& words) const {
+    hmmSeg_.Cut(sentence, words);
+  }
+  void CutSmall(
+    const std::string& sentence,
+    std::vector<std::string>& words,
+    size_t maxWordLen
+  ) const {
+    mpSeg_.Cut(sentence, words, maxWordLen);
+  }
+  void Tag(
+    const std::string& sentence,
+    std::vector<std::pair<std::string, std::string>>& words
+  ) const {
+    mixSeg_.Tag(sentence, words);
+  }
+  bool InsertUserWord(const std::string& word, const std::string& tag) {
+    return dictTrie_.InsertUserWord(word, tag);
+  }
+  bool Find(const std::string& word) {
+    return dictTrie_.Find(word);
+  }
+
+  /**
+   * The TF-IDF keyword extractor, constructed on first use.
+   *
+   * Reuses this engine's already-loaded trie and HMM model, so the only additional cost is
+   * reading `idf.utf8` and `stop_words.utf8`. Throws `std::runtime_error` when the IDF
+   * dictionary is missing — mirroring the web backend, where `extract()` is likewise
+   * unsupported because jieba-wasm ships no IDF data.
+   */
+  const cppjieba::KeywordExtractor& Extractor() {
+    if (!extractor_) {
+      if (!UnicodeFileExists(idfPath_)) {
+        throw std::runtime_error(
+          "react-native-jieba: extract() is unavailable because the IDF dictionary was not "
+          "found at '" + idfPath_ + "'. This build excluded it (see the `excludeIdfDict` "
+          "build flag). Re-enable the IDF dictionary to use extract(); cut()/tag() are "
+          "unaffected."
+        );
+      }
+      extractor_ = std::make_unique<cppjieba::KeywordExtractor>(
+        &dictTrie_, &model_, idfPath_, stopWordPath_
+      );
+    }
+    return *extractor_;
+  }
+
+private:
+  static bool UnicodeFileExists(const std::string& path);
+
+  std::string idfPath_;
+  std::string stopWordPath_;
+
+  cppjieba::DictTrie dictTrie_;
+  cppjieba::HMMModel model_;
+
+  // All share the trie and model above.
+  cppjieba::MPSegment mpSeg_;
+  cppjieba::HMMSegment hmmSeg_;
+  cppjieba::MixSegment mixSeg_;
+  cppjieba::FullSegment fullSeg_;
+  cppjieba::QuerySegment querySeg_;
+
+  std::unique_ptr<cppjieba::KeywordExtractor> extractor_;
+};
+
+}

package/cpp/JiebaImpl.cpp

@@ -1,6 +1,10 @@
 #include "JiebaImpl.h"
 
-#include <cppjieba/Jieba.hpp>
+#ifdef __ANDROID__
+#include "JiebaDictAndroid.h"
+#endif
+
+#include "JiebaEngine.h"
 
 #include <memory>
 #include <mutex>
@@ -23,8 +27,8 @@ std::string& dictPathStorage() {
   return p;
 }
 
-std::unique_ptr<cppjieba::Jieba>& jiebaStorage() {
-  static std::unique_ptr<cppjieba::Jieba> j;
+std::unique_ptr<rnjieba::JiebaEngine>& jiebaStorage() {
+  static std::unique_ptr<rnjieba::JiebaEngine> j;
   return j;
 }
 
@@ -58,13 +62,32 @@ void JiebaImpl::setDictPathFromNative(const std::string& dictPath) {
   }
 }
 
+bool JiebaImpl::isReady(jsi::Runtime& rt) {
+  std::lock_guard<std::mutex> lock(dictMutex());
+  // Ready once the engine is constructed, or once a dict path is resolved (the
+  // engine is then built lazily on first use). On iOS the path is set at +load;
+  // on Android it is set eagerly by prepareJieba or lazily on the first call.
+  return jiebaStorage() != nullptr || !dictPathStorage().empty();
+}
+
 void JiebaImpl::setDictPath(jsi::Runtime& rt, jsi::String path) {
   setDictPathFromNative(path.utf8(rt));
 }
 
-cppjieba::Jieba& JiebaImpl::getJieba() {
+rnjieba::JiebaEngine& JiebaImpl::getJieba() {
   std::lock_guard<std::mutex> lock(dictMutex());
   if (!jiebaStorage()) {
+#ifdef __ANDROID__
+    // If prepareJieba() was never awaited, extract the bundled assets now (a
+    // one-time, synchronous cost on the very first call) so callers don't have
+    // to call prepareJieba at all.
+    if (dictPathStorage().empty()) {
+      std::string extracted = extractJiebaDictDirAndroid();
+      if (!extracted.empty()) {
+        dictPathStorage() = extracted;
+      }
+    }
+#endif
     const std::string& base = dictPathStorage();
     if (base.empty()) {
       throw std::runtime_error(
@@ -72,7 +95,9 @@ cppjieba::Jieba& JiebaImpl::getJieba() {
         "The native module failed to locate bundled dict files."
       );
     }
-    jiebaStorage() = std::make_unique<cppjieba::Jieba>(
+    // The IDF path is recorded but NOT read here: JiebaEngine loads it only if extract() is
+    // called, so a build that omits idf.utf8 still tokenizes normally.
+    jiebaStorage() = std::make_unique<rnjieba::JiebaEngine>(
       joinPath(base, "jieba.dict.utf8"),
       joinPath(base, "hmm_model.utf8"),
       joinPath(base, "user.dict.utf8"),
@@ -130,7 +155,7 @@ jsi::Array JiebaImpl::tag(jsi::Runtime& rt, jsi::String sentence) {
 jsi::Array JiebaImpl::extract(jsi::Runtime& rt, jsi::String sentence, double topK) {
   std::vector<cppjieba::KeywordExtractor::Word> keywords;
   size_t n = topK <= 0 ? 5 : static_cast<size_t>(topK);
-  getJieba().extractor.Extract(sentence.utf8(rt), keywords, n);
+  getJieba().Extractor().Extract(sentence.utf8(rt), keywords, n);
   jsi::Array arr(rt, keywords.size());
   for (size_t i = 0; i < keywords.size(); ++i) {
     jsi::Object obj(rt);

package/cpp/JiebaImpl.h

@@ -6,8 +6,8 @@
 #include <mutex>
 #include <string>
 
-namespace cppjieba {
-class Jieba;
+namespace rnjieba {
+class JiebaEngine;
 }
 
 namespace facebook::react {
@@ -19,6 +19,7 @@ public:
 
   static void setDictPathFromNative(const std::string& dictPath);
 
+  bool isReady(jsi::Runtime& rt);
   void setDictPath(jsi::Runtime& rt, jsi::String path);
   jsi::Array cut(jsi::Runtime& rt, jsi::String sentence, bool hmm);
   jsi::Array cutAll(jsi::Runtime& rt, jsi::String sentence);
@@ -31,7 +32,7 @@ public:
   bool find(jsi::Runtime& rt, jsi::String word);
 
 private:
-  cppjieba::Jieba& getJieba();
+  rnjieba::JiebaEngine& getJieba();
 };
 
 }

package/ios/generated/ReactCodegen/JiebaSpec/JiebaSpec-generated.mm

@@ -26,6 +26,10 @@
 
 namespace facebook::react {
   
+    static facebook::jsi::Value __hostFunction_NativeJiebaSpecJSI_isReady(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+      return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, BooleanKind, "isReady", @selector(isReady), args, count);
+    }
+
     static facebook::jsi::Value __hostFunction_NativeJiebaSpecJSI_setDictPath(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
       return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "setDictPath", @selector(setDictPath:), args, count);
     }
@@ -69,6 +73,9 @@ namespace facebook::react {
   NativeJiebaSpecJSI::NativeJiebaSpecJSI(const ObjCTurboModule::InitParams &params)
     : ObjCTurboModule(params) {
       
+        methodMap_["isReady"] = MethodMetadata {0, __hostFunction_NativeJiebaSpecJSI_isReady};
+        
+        
         methodMap_["setDictPath"] = MethodMetadata {1, __hostFunction_NativeJiebaSpecJSI_setDictPath};
         
         

package/ios/generated/ReactCodegen/JiebaSpec/JiebaSpec.h

@@ -35,6 +35,7 @@ NS_ASSUME_NONNULL_BEGIN
 
 @protocol NativeJiebaSpec <RCTBridgeModule, RCTTurboModule>
 
+- (NSNumber *)isReady;
 - (void)setDictPath:(NSString *)path;
 - (NSArray<NSString *> *)cut:(NSString *)sentence
                          hmm:(BOOL)hmm;

package/ios/generated/ReactCodegen/JiebaSpecJSI.h

@@ -22,6 +22,7 @@ public:
 
 protected:
   NativeJiebaCxxSpec(std::shared_ptr<CallInvoker> jsInvoker) : TurboModule(std::string{NativeJiebaCxxSpec::kModuleName}, jsInvoker) {
+    methodMap_["isReady"] = MethodMetadata {.argCount = 0, .invoker = __isReady};
     methodMap_["setDictPath"] = MethodMetadata {.argCount = 1, .invoker = __setDictPath};
     methodMap_["cut"] = MethodMetadata {.argCount = 2, .invoker = __cut};
     methodMap_["cutAll"] = MethodMetadata {.argCount = 1, .invoker = __cutAll};
@@ -35,6 +36,13 @@ protected:
   }
   
 private:
+  static jsi::Value __isReady(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* /*args*/, size_t /*count*/) {
+    static_assert(
+      bridging::getParameterCount(&T::isReady) == 1,
+      "Expected isReady(...) to have 1 parameters");
+    return bridging::callFromJs<bool>(rt, &T::isReady,  static_cast<NativeJiebaCxxSpec*>(&turboModule)->jsInvoker_, static_cast<T*>(&turboModule));
+  }
+
   static jsi::Value __setDictPath(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
     static_assert(
       bridging::getParameterCount(&T::setDictPath) == 2,

package/lib/module/NativeJieba.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeJieba.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAkBpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,OAAO,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeJieba.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAmBpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,OAAO,CAAC","ignoreList":[]}

package/lib/module/NativeJieba.web.js

@@ -3,20 +3,26 @@
 // `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`.
 
 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 initialized. ' + 'Call (and await) initJieba() before any segmentation call.');
+    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.
   },

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

@@ -1 +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":[]}
+{"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';
+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,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/module/jieba.js

@@ -19,6 +19,18 @@ export function cutSmall(sentence, maxWordLen) {
 export function tag(sentence) {
   return Jieba.tag(sentence);
 }
+
+/**
+ * TF-IDF keyword extraction.
+ *
+ * Requires the IDF dictionary, which is loaded lazily on the first call (every other API works
+ * without it). Throws when that dictionary is unavailable:
+ *  - on **web**, always — jieba-wasm ships no IDF data;
+ *  - on **native**, only in builds that opted out of bundling it via `RN_JIEBA_EXCLUDE_IDF_DICT=1`
+ *    (iOS) or `rnJiebaExcludeIdfDict=true` (Android), which drops ~5MB from the app.
+ *
+ * Guard it in cross-platform code, or in any app that may be built with the dictionary excluded.
+ */
 export function extract(sentence, topK = 5) {
   return Jieba.extract(sentence, topK);
 }

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,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":[]}
+{"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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,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

@@ -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/lib/typescript/src/jieba.d.ts

@@ -12,6 +12,17 @@ export declare function cutForSearch(sentence: string, hmm?: boolean): string[];
 export declare function cutHMM(sentence: string): string[];
 export declare function cutSmall(sentence: string, maxWordLen: number): string[];
 export declare function tag(sentence: string): Tagged[];
+/**
+ * TF-IDF keyword extraction.
+ *
+ * Requires the IDF dictionary, which is loaded lazily on the first call (every other API works
+ * without it). Throws when that dictionary is unavailable:
+ *  - on **web**, always — jieba-wasm ships no IDF data;
+ *  - on **native**, only in builds that opted out of bundling it via `RN_JIEBA_EXCLUDE_IDF_DICT=1`
+ *    (iOS) or `rnJiebaExcludeIdfDict=true` (Android), which drops ~5MB from the app.
+ *
+ * Guard it in cross-platform code, or in any app that may be built with the dictionary excluded.
+ */
 export declare function extract(sentence: string, topK?: number): Keyword[];
 export declare function insertUserWord(word: string, tag?: string): boolean;
 export declare function find(word: string): boolean;

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,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"}
+{"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;;;;;;;;;;GAUG;AACH,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"}