react-native-i18njs 0.0.2 → 0.0.3

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2024-present, wangws
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -15,7 +15,7 @@
 - 🛡️ **极致类型安全**：完全 TypeScript 编写，提供从 Key 到插值参数的完整类型推导。
 - 📱 **自动跟随系统**：基于 `react-native-localize`，自动检测并响应设备语言变更。
 - ⚡ **高性能**：基于 `i18n-js` 核心，轻量高效，无多余运行时开销。
-- 🔌 **灵活 API**：同时支持 Hook (`useI18n`)、高阶组件 (`withTranslation`) 和全局函数 (`t`)。
+- 🔌 **灵活 API**：同时支持 Hook (`useI18n`)、高阶组件 (`withI18n`) 和全局函数 (`t`)。
 - 📝 **富文本支持**：`Trans` 组件轻松处理嵌套样式和组件插值。
 - 🌍 **格式化内置**：开箱即用的数字、货币、日期格式化支持。
 
@@ -129,13 +129,13 @@ const message = t('errors.network_timeout');
 
 #### 进阶：监听语言变化
 
-如果你需要在组件外监听语言变更（例如同步更新全局状态），可以使用默认导出的实例：
+如果你需要在组件外监听语言变更（例如同步更新全局状态），可以使用顶层 `subscribe` 函数：
 
 ```ts
-import i18n from 'react-native-i18njs';
+import { subscribe } from 'react-native-i18njs';
 
 // 订阅语言变更
-const unsubscribe = i18n.subscribe((locale) => {
+const unsubscribe = subscribe((locale) => {
   console.log('Language changed to:', locale);
   // 更新 API 默认 Header 或其他全局状态
 });
@@ -144,6 +144,27 @@ const unsubscribe = i18n.subscribe((locale) => {
 // unsubscribe();
 ```
 
+#### 进阶：重置为跟随系统
+
+用户手动调用 `setLocale` 后会锁定语言，不再自动跟随系统。如果需要恢复跟随系统语言：
+
+```ts
+import { resetToSystem } from 'react-native-i18njs';
+
+// 撤销用户锁定，重新跟随系统语言
+resetToSystem();
+```
+
+#### 进阶：RTL 检测
+
+```ts
+import { isRTL } from 'react-native-i18njs';
+
+if (isRTL()) {
+  // 当前为从右到左语言（如阿拉伯语、希伯来语）
+}
+```
+
 #### 实战示例：Axios 拦截器
 
 ```ts
@@ -192,7 +213,7 @@ async function loadFrench() {
 
 ### 4. 格式化工具
 
-利用 `Intl` 标准进行格式化：
+利用 `Intl` 标准进行格式化，在组件中通过 Hook 使用：
 
 ```ts
 const { formatNumber, formatCurrency, formatDate } = useI18n();
@@ -207,6 +228,16 @@ formatCurrency(99.99, 'USD'); // "$99.99"
 formatDate(new Date(), { dateStyle: 'full' }); // "Tuesday, October 10, 2023"
 ```
 
+在非组件环境中，也可以直接使用顶层导出：
+
+```ts
+import { formatNumber, formatCurrency, formatDate } from 'react-native-i18njs';
+
+formatNumber(1234.56);
+formatCurrency(99.99, 'USD');
+formatDate(new Date());
+```
+
 ## ⚙️ 配置选项 (I18nOptions)
 
 `initI18n` 接受的第二个参数对象：

package/dist/index.d.mts

@@ -35,6 +35,8 @@ interface I18nEngine {
     formatDate(date: Date | number, options?: Intl.DateTimeFormatOptions): string;
     subscribe(listener: Listener): () => void;
     isRTL(): boolean;
+    /** 重置为跟随系统语言，撤销 setLocale 的用户锁定 */
+    resetToSystem(): void;
     ready(): Promise<void>;
     isReady(): boolean;
 }
@@ -55,12 +57,18 @@ declare class DefaultI18nEngine implements I18nEngine {
     private version;
     private readyPromise;
     private resolveReady?;
+    /** Intl 格式化器缓存，key = locale + JSON(options) */
+    private numberFormatCache;
+    private dateFormatCache;
+    /** locale chain 缓存，locale 或 fallbackLocales 变化时失效 */
+    private localeChainCache;
     constructor();
     init(translations: Translations, options?: I18nOptions): void;
     loadTranslations(translations: Translations): void;
     updateLocale(): void;
     setLocale(locale: string): void;
     getLocale(): string;
+    resetToSystem(): void;
     t(scope: Scope, options?: TranslateOptions): string;
     formatNumber(n: number, options?: Intl.NumberFormatOptions): string;
     formatCurrency(n: number, currency: string, options?: Intl.NumberFormatOptions): string;
@@ -69,11 +77,16 @@ declare class DefaultI18nEngine implements I18nEngine {
     isRTL(): boolean;
     ready(): Promise<void>;
     isReady(): boolean;
+    private invalidateCaches;
+    private getCachedNumberFormat;
+    private getCachedDateFormat;
     private handleRTL;
     private notifyListeners;
     private setLocaleFromSystem;
     private applyLocale;
     private translateAtLocale;
+    /** 将 locale 及其自动降级（如 en-US → en）追加到 chain 中 */
+    private pushWithDegradation;
     private getLocaleChain;
     private hasTranslation;
     private normalizeTranslateResult;
@@ -126,7 +139,14 @@ declare const loadTranslations: (translations: Translations) => void;
 declare const setLocale: (locale: string) => void;
 declare const getLocale: () => string;
 declare const t: (scope: Scope, options?: TranslateOptions) => string;
+declare const formatNumber: (n: number, options?: Intl.NumberFormatOptions) => string;
+declare const formatCurrency: (n: number, currency: string, options?: Intl.NumberFormatOptions) => string;
+declare const formatDate: (date: Date | number, options?: Intl.DateTimeFormatOptions) => string;
+declare const subscribe: (listener: Listener) => (() => void);
+declare const isRTL: () => boolean;
+/** 重置为跟随系统语言，撤销 setLocale 的用户锁定 */
+declare const resetToSystem: () => void;
 declare const readyI18n: () => Promise<void>;
 declare const isI18nReady: () => boolean;
 
-export { I18nContext, type I18nContextType, type I18nOptions, I18nProvider, type I18nProviderProps, type Path, Trans, type Translations, i18nService as default, getLocale, initI18n, isI18nReady, loadTranslations, readyI18n, setLocale, t, useI18n, withI18n };
+export { I18nContext, type I18nContextType, type I18nOptions, I18nProvider, type I18nProviderProps, type Listener, type Path, Trans, type Translations, i18nService as default, formatCurrency, formatDate, formatNumber, getLocale, initI18n, isI18nReady, isRTL, loadTranslations, readyI18n, resetToSystem, setLocale, subscribe, t, useI18n, withI18n };

package/dist/index.d.ts

@@ -35,6 +35,8 @@ interface I18nEngine {
     formatDate(date: Date | number, options?: Intl.DateTimeFormatOptions): string;
     subscribe(listener: Listener): () => void;
     isRTL(): boolean;
+    /** 重置为跟随系统语言，撤销 setLocale 的用户锁定 */
+    resetToSystem(): void;
     ready(): Promise<void>;
     isReady(): boolean;
 }
@@ -55,12 +57,18 @@ declare class DefaultI18nEngine implements I18nEngine {
     private version;
     private readyPromise;
     private resolveReady?;
+    /** Intl 格式化器缓存，key = locale + JSON(options) */
+    private numberFormatCache;
+    private dateFormatCache;
+    /** locale chain 缓存，locale 或 fallbackLocales 变化时失效 */
+    private localeChainCache;
     constructor();
     init(translations: Translations, options?: I18nOptions): void;
     loadTranslations(translations: Translations): void;
     updateLocale(): void;
     setLocale(locale: string): void;
     getLocale(): string;
+    resetToSystem(): void;
     t(scope: Scope, options?: TranslateOptions): string;
     formatNumber(n: number, options?: Intl.NumberFormatOptions): string;
     formatCurrency(n: number, currency: string, options?: Intl.NumberFormatOptions): string;
@@ -69,11 +77,16 @@ declare class DefaultI18nEngine implements I18nEngine {
     isRTL(): boolean;
     ready(): Promise<void>;
     isReady(): boolean;
+    private invalidateCaches;
+    private getCachedNumberFormat;
+    private getCachedDateFormat;
     private handleRTL;
     private notifyListeners;
     private setLocaleFromSystem;
     private applyLocale;
     private translateAtLocale;
+    /** 将 locale 及其自动降级（如 en-US → en）追加到 chain 中 */
+    private pushWithDegradation;
     private getLocaleChain;
     private hasTranslation;
     private normalizeTranslateResult;
@@ -126,7 +139,14 @@ declare const loadTranslations: (translations: Translations) => void;
 declare const setLocale: (locale: string) => void;
 declare const getLocale: () => string;
 declare const t: (scope: Scope, options?: TranslateOptions) => string;
+declare const formatNumber: (n: number, options?: Intl.NumberFormatOptions) => string;
+declare const formatCurrency: (n: number, currency: string, options?: Intl.NumberFormatOptions) => string;
+declare const formatDate: (date: Date | number, options?: Intl.DateTimeFormatOptions) => string;
+declare const subscribe: (listener: Listener) => (() => void);
+declare const isRTL: () => boolean;
+/** 重置为跟随系统语言，撤销 setLocale 的用户锁定 */
+declare const resetToSystem: () => void;
 declare const readyI18n: () => Promise<void>;
 declare const isI18nReady: () => boolean;
 
-export { I18nContext, type I18nContextType, type I18nOptions, I18nProvider, type I18nProviderProps, type Path, Trans, type Translations, i18nService as default, getLocale, initI18n, isI18nReady, loadTranslations, readyI18n, setLocale, t, useI18n, withI18n };
+export { I18nContext, type I18nContextType, type I18nOptions, I18nProvider, type I18nProviderProps, type Listener, type Path, Trans, type Translations, i18nService as default, formatCurrency, formatDate, formatNumber, getLocale, initI18n, isI18nReady, isRTL, loadTranslations, readyI18n, resetToSystem, setLocale, subscribe, t, useI18n, withI18n };

package/dist/index.js

@@ -73,6 +73,12 @@ var DefaultI18nEngine = class {
     __publicField(this, "version");
     __publicField(this, "readyPromise");
     __publicField(this, "resolveReady");
+    // --- 性能缓存 ---
+    /** Intl 格式化器缓存，key = locale + JSON(options) */
+    __publicField(this, "numberFormatCache", /* @__PURE__ */ new Map());
+    __publicField(this, "dateFormatCache", /* @__PURE__ */ new Map());
+    /** locale chain 缓存，locale 或 fallbackLocales 变化时失效 */
+    __publicField(this, "localeChainCache", /* @__PURE__ */ new Map());
     this.i18n = new i18nJs.I18n();
     this.listeners = /* @__PURE__ */ new Set();
     this.i18n.enableFallback = false;
@@ -107,6 +113,7 @@ var DefaultI18nEngine = class {
     this.localeSource = "system";
     this.missingBehavior = missingBehavior;
     this.onMissingKey = onMissingKey;
+    this.invalidateCaches();
     if (this.followSystem) this.updateLocale();
     this.version += 1;
     this.notifyListeners({ type: "translations", version: this.version });
@@ -142,6 +149,10 @@ var DefaultI18nEngine = class {
   getLocale() {
     return this.i18n.locale;
   }
+  resetToSystem() {
+    this.localeSource = "system";
+    this.updateLocale();
+  }
   t(scope, options) {
     var _a, _b, _c;
     if (typeof scope !== "string") {
@@ -175,7 +186,7 @@ var DefaultI18nEngine = class {
       return String(n);
     }
     try {
-      return new Intl.NumberFormat(this.i18n.locale, options).format(n);
+      return this.getCachedNumberFormat(this.i18n.locale, options).format(n);
     } catch {
       return String(n);
     }
@@ -185,7 +196,7 @@ var DefaultI18nEngine = class {
       return `${n} ${currency}`;
     }
     try {
-      return new Intl.NumberFormat(this.i18n.locale, {
+      return this.getCachedNumberFormat(this.i18n.locale, {
         ...options,
         style: "currency",
         currency
@@ -201,7 +212,7 @@ var DefaultI18nEngine = class {
       return d.toISOString();
     }
     try {
-      return new Intl.DateTimeFormat(this.i18n.locale, options).format(d);
+      return this.getCachedDateFormat(this.i18n.locale, options).format(d);
     } catch {
       return d.toISOString();
     }
@@ -222,15 +233,40 @@ var DefaultI18nEngine = class {
   isReady() {
     return this.initialized;
   }
+  // ─── 缓存管理 ────────────────────────────────────────────
+  invalidateCaches() {
+    this.numberFormatCache.clear();
+    this.dateFormatCache.clear();
+    this.localeChainCache.clear();
+  }
+  getCachedNumberFormat(locale, options) {
+    const cacheKey = locale + (options ? JSON.stringify(options) : "");
+    let fmt = this.numberFormatCache.get(cacheKey);
+    if (!fmt) {
+      fmt = new Intl.NumberFormat(locale, options);
+      this.numberFormatCache.set(cacheKey, fmt);
+    }
+    return fmt;
+  }
+  getCachedDateFormat(locale, options) {
+    const cacheKey = locale + (options ? JSON.stringify(options) : "");
+    let fmt = this.dateFormatCache.get(cacheKey);
+    if (!fmt) {
+      fmt = new Intl.DateTimeFormat(locale, options);
+      this.dateFormatCache.set(cacheKey, fmt);
+    }
+    return fmt;
+  }
+  // ─── 私有方法 ────────────────────────────────────────────
   handleRTL(locale) {
     var _a, _b;
-    const isRTL = this.isRTLLocale(locale);
+    const isRTL2 = this.isRTLLocale(locale);
     if (typeof ((_a = reactNative.I18nManager) == null ? void 0 : _a.allowRTL) !== "function" || typeof ((_b = reactNative.I18nManager) == null ? void 0 : _b.forceRTL) !== "function") {
       return;
     }
-    if (reactNative.I18nManager.isRTL !== isRTL) {
-      reactNative.I18nManager.allowRTL(isRTL);
-      reactNative.I18nManager.forceRTL(isRTL);
+    if (reactNative.I18nManager.isRTL !== isRTL2) {
+      reactNative.I18nManager.allowRTL(isRTL2);
+      reactNative.I18nManager.forceRTL(isRTL2);
     }
   }
   notifyListeners(change) {
@@ -245,6 +281,7 @@ var DefaultI18nEngine = class {
     const normalizedLocale = this.normalizeLocaleTag(locale);
     if (this.i18n.locale !== normalizedLocale) {
       this.i18n.locale = normalizedLocale;
+      this.invalidateCaches();
       this.handleRTL(normalizedLocale);
       this.version += 1;
       this.notifyListeners({ type: "locale", version: this.version });
@@ -260,39 +297,36 @@ var DefaultI18nEngine = class {
       this.i18n.locale = prevLocale;
     }
   }
-  getLocaleChain(locale) {
-    const chain = [];
-    const normalizedLocale = this.normalizeLocaleTag(locale);
-    chain.push(normalizedLocale);
-    const parts = normalizedLocale.split("-").filter(Boolean);
+  /** 将 locale 及其自动降级（如 en-US → en）追加到 chain 中 */
+  pushWithDegradation(chain, locale) {
+    const normalized = this.normalizeLocaleTag(locale);
+    chain.push(normalized);
+    const parts = normalized.split("-").filter(Boolean);
     for (let i = parts.length - 1; i >= 1; i -= 1) {
       chain.push(parts.slice(0, i).join("-"));
     }
+  }
+  getLocaleChain(locale) {
+    const cached = this.localeChainCache.get(locale);
+    if (cached) return cached;
+    const chain = [];
+    this.pushWithDegradation(chain, locale);
+    const normalizedLocale = this.normalizeLocaleTag(locale);
     const extra = this.fallbackLocales ? typeof this.fallbackLocales === "function" ? this.fallbackLocales(normalizedLocale) : this.fallbackLocales : [];
     for (const l of extra) {
-      const normalizedFallback = this.normalizeLocaleTag(l);
-      chain.push(normalizedFallback);
-      const fallbackParts = normalizedFallback.split("-").filter(Boolean);
-      for (let i = fallbackParts.length - 1; i >= 1; i -= 1) {
-        chain.push(fallbackParts.slice(0, i).join("-"));
-      }
+      this.pushWithDegradation(chain, l);
     }
     if (this.i18n.defaultLocale) {
-      const normalizedDefault = this.normalizeLocaleTag(this.i18n.defaultLocale);
-      chain.push(normalizedDefault);
-      const defaultParts = normalizedDefault.split("-").filter(Boolean);
-      for (let i = defaultParts.length - 1; i >= 1; i -= 1) {
-        chain.push(defaultParts.slice(0, i).join("-"));
-      }
+      this.pushWithDegradation(chain, this.i18n.defaultLocale);
     }
     const seen = /* @__PURE__ */ new Set();
-    return chain.filter((l) => {
-      if (!l) return false;
-      const normalized = l;
-      if (seen.has(normalized)) return false;
-      seen.add(normalized);
+    const result = chain.filter((l) => {
+      if (!l || seen.has(l)) return false;
+      seen.add(l);
       return true;
     });
+    this.localeChainCache.set(locale, result);
+    return result;
   }
   hasTranslation(locale, key) {
     var _a;
@@ -327,7 +361,7 @@ var DefaultI18nEngine = class {
   }
   isRTLLocale(locale) {
     var _a;
-    const normalized = locale.replace(/_/g, "-");
+    const normalized = this.normalizeLocaleTag(locale);
     const parts = normalized.split("-").filter(Boolean);
     const languageCode = (_a = parts[0]) == null ? void 0 : _a.toLowerCase();
     if (!languageCode) return false;
@@ -427,13 +461,13 @@ function useI18n() {
   }, [context]);
 }
 var escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var TAG_REGEX = /<(\/?)([A-Za-z][\w-]*)(?:\s[^>]*?)?(\/?)>/g;
 var parseString = (input) => {
   var _a;
   const root = { type: "tag", name: "root", children: [] };
   const stack = [root];
-  const tagRegex = /<(\/?)([A-Za-z][\w-]*)(?:\s[^>]*?)?(\/?)>/g;
   let lastIndex = 0;
-  for (const match of input.matchAll(tagRegex)) {
+  for (const match of input.matchAll(TAG_REGEX)) {
     const fullMatch = match[0];
     const isClosing = match[1] === "/";
     const tagName = match[2];
@@ -463,51 +497,57 @@ var parseString = (input) => {
   }
   return root.children;
 };
+var renderAST = (nodes, keyPrefix, components, placeholderToElement) => {
+  return nodes.map((node, index) => {
+    const key = `${keyPrefix}-${index}`;
+    if (node.type === "text") {
+      const placeholders = Object.keys(placeholderToElement);
+      if (placeholders.length === 0) return node.content;
+      const pattern = new RegExp(`(${placeholders.map(escapeRegExp).join("|")})`, "g");
+      const parts = node.content.split(pattern);
+      if (parts.length === 1) return node.content;
+      return /* @__PURE__ */ React__default.default.createElement(React.Fragment, { key }, parts.map((part, i) => {
+        if (placeholderToElement[part]) {
+          return React.cloneElement(placeholderToElement[part], { key: `${key}-${i}` });
+        }
+        return part;
+      }));
+    } else if (node.type === "tag") {
+      const Component = components == null ? void 0 : components[node.name];
+      const children = renderAST(node.children, key, components, placeholderToElement);
+      if (React.isValidElement(Component)) {
+        return React.cloneElement(Component, { key }, children.length > 0 ? children : void 0);
+      }
+      return /* @__PURE__ */ React__default.default.createElement(React.Fragment, { key }, children);
+    }
+    return null;
+  });
+};
 var Trans = ({ i18nKey, values, components, ...props }) => {
   const { t: t2 } = useI18n();
-  const stringValues = {};
-  const placeholderToElement = {};
-  if (values) {
-    Object.keys(values).forEach((key) => {
-      const value = values[key];
-      if (React.isValidElement(value)) {
-        const placeholder = `__ELEMENT_${key}__`;
-        placeholderToElement[placeholder] = value;
-        stringValues[key] = placeholder;
-      } else {
-        stringValues[key] = value == null ? "" : String(value);
-      }
-    });
-  }
-  const translatedText = t2(i18nKey, stringValues);
-  const ast = parseString(translatedText);
-  const renderAST = (nodes, keyPrefix) => {
-    return nodes.map((node, index) => {
-      const key = `${keyPrefix}-${index}`;
-      if (node.type === "text") {
-        const placeholders = Object.keys(placeholderToElement);
-        if (placeholders.length === 0) return node.content;
-        const pattern = new RegExp(`(${placeholders.map(escapeRegExp).join("|")})`, "g");
-        const parts = node.content.split(pattern);
-        if (parts.length === 1) return node.content;
-        return /* @__PURE__ */ React__default.default.createElement(React.Fragment, { key }, parts.map((part, i) => {
-          if (placeholderToElement[part]) {
-            return React.cloneElement(placeholderToElement[part], { key: `${key}-${i}` });
-          }
-          return part;
-        }));
-      } else if (node.type === "tag") {
-        const Component = components == null ? void 0 : components[node.name];
-        const children2 = renderAST(node.children, key);
-        if (React.isValidElement(Component)) {
-          return React.cloneElement(Component, { key }, children2.length > 0 ? children2 : void 0);
+  const { stringValues, placeholderToElement } = React.useMemo(() => {
+    const sv = {};
+    const pte = {};
+    if (values) {
+      for (const key of Object.keys(values)) {
+        const value = values[key];
+        if (React.isValidElement(value)) {
+          const placeholder = `__ELEMENT_${key}__`;
+          pte[placeholder] = value;
+          sv[key] = placeholder;
+        } else {
+          sv[key] = value == null ? "" : String(value);
         }
-        return /* @__PURE__ */ React__default.default.createElement(React.Fragment, { key }, children2);
       }
-      return null;
-    });
-  };
-  const children = renderAST(ast, "trans");
+    }
+    return { stringValues: sv, placeholderToElement: pte };
+  }, [values]);
+  const translatedText = t2(i18nKey, stringValues);
+  const ast = React.useMemo(() => parseString(translatedText), [translatedText]);
+  const children = React.useMemo(
+    () => renderAST(ast, "trans", components, placeholderToElement),
+    [ast, components, placeholderToElement]
+  );
   return /* @__PURE__ */ React__default.default.createElement(reactNative.Text, { ...props }, children);
 };
 
@@ -517,6 +557,12 @@ var loadTranslations = (translations) => i18nService.loadTranslations(translatio
 var setLocale = (locale) => i18nService.setLocale(locale);
 var getLocale = () => i18nService.getLocale();
 var t = (scope, options) => i18nService.t(scope, options);
+var formatNumber = (n, options) => i18nService.formatNumber(n, options);
+var formatCurrency = (n, currency, options) => i18nService.formatCurrency(n, currency, options);
+var formatDate = (date, options) => i18nService.formatDate(date, options);
+var subscribe = (listener) => i18nService.subscribe(listener);
+var isRTL = () => i18nService.isRTL();
+var resetToSystem = () => i18nService.resetToSystem();
 var readyI18n = () => i18nService.ready();
 var isI18nReady = () => i18nService.isReady();
 var index_default = i18nService;
@@ -525,12 +571,18 @@ exports.I18nContext = I18nContext;
 exports.I18nProvider = I18nProvider;
 exports.Trans = Trans;
 exports.default = index_default;
+exports.formatCurrency = formatCurrency;
+exports.formatDate = formatDate;
+exports.formatNumber = formatNumber;
 exports.getLocale = getLocale;
 exports.initI18n = initI18n;
 exports.isI18nReady = isI18nReady;
+exports.isRTL = isRTL;
 exports.loadTranslations = loadTranslations;
 exports.readyI18n = readyI18n;
+exports.resetToSystem = resetToSystem;
 exports.setLocale = setLocale;
+exports.subscribe = subscribe;
 exports.t = t;
 exports.useI18n = useI18n;
 exports.withI18n = withI18n;

package/dist/index.mjs

@@ -46,6 +46,12 @@ var DefaultI18nEngine = class {
     __publicField(this, "version");
     __publicField(this, "readyPromise");
     __publicField(this, "resolveReady");
+    // --- 性能缓存 ---
+    /** Intl 格式化器缓存，key = locale + JSON(options) */
+    __publicField(this, "numberFormatCache", /* @__PURE__ */ new Map());
+    __publicField(this, "dateFormatCache", /* @__PURE__ */ new Map());
+    /** locale chain 缓存，locale 或 fallbackLocales 变化时失效 */
+    __publicField(this, "localeChainCache", /* @__PURE__ */ new Map());
     this.i18n = new I18n();
     this.listeners = /* @__PURE__ */ new Set();
     this.i18n.enableFallback = false;
@@ -80,6 +86,7 @@ var DefaultI18nEngine = class {
     this.localeSource = "system";
     this.missingBehavior = missingBehavior;
     this.onMissingKey = onMissingKey;
+    this.invalidateCaches();
     if (this.followSystem) this.updateLocale();
     this.version += 1;
     this.notifyListeners({ type: "translations", version: this.version });
@@ -115,6 +122,10 @@ var DefaultI18nEngine = class {
   getLocale() {
     return this.i18n.locale;
   }
+  resetToSystem() {
+    this.localeSource = "system";
+    this.updateLocale();
+  }
   t(scope, options) {
     var _a, _b, _c;
     if (typeof scope !== "string") {
@@ -148,7 +159,7 @@ var DefaultI18nEngine = class {
       return String(n);
     }
     try {
-      return new Intl.NumberFormat(this.i18n.locale, options).format(n);
+      return this.getCachedNumberFormat(this.i18n.locale, options).format(n);
     } catch {
       return String(n);
     }
@@ -158,7 +169,7 @@ var DefaultI18nEngine = class {
       return `${n} ${currency}`;
     }
     try {
-      return new Intl.NumberFormat(this.i18n.locale, {
+      return this.getCachedNumberFormat(this.i18n.locale, {
         ...options,
         style: "currency",
         currency
@@ -174,7 +185,7 @@ var DefaultI18nEngine = class {
       return d.toISOString();
     }
     try {
-      return new Intl.DateTimeFormat(this.i18n.locale, options).format(d);
+      return this.getCachedDateFormat(this.i18n.locale, options).format(d);
     } catch {
       return d.toISOString();
     }
@@ -195,15 +206,40 @@ var DefaultI18nEngine = class {
   isReady() {
     return this.initialized;
   }
+  // ─── 缓存管理 ────────────────────────────────────────────
+  invalidateCaches() {
+    this.numberFormatCache.clear();
+    this.dateFormatCache.clear();
+    this.localeChainCache.clear();
+  }
+  getCachedNumberFormat(locale, options) {
+    const cacheKey = locale + (options ? JSON.stringify(options) : "");
+    let fmt = this.numberFormatCache.get(cacheKey);
+    if (!fmt) {
+      fmt = new Intl.NumberFormat(locale, options);
+      this.numberFormatCache.set(cacheKey, fmt);
+    }
+    return fmt;
+  }
+  getCachedDateFormat(locale, options) {
+    const cacheKey = locale + (options ? JSON.stringify(options) : "");
+    let fmt = this.dateFormatCache.get(cacheKey);
+    if (!fmt) {
+      fmt = new Intl.DateTimeFormat(locale, options);
+      this.dateFormatCache.set(cacheKey, fmt);
+    }
+    return fmt;
+  }
+  // ─── 私有方法 ────────────────────────────────────────────
   handleRTL(locale) {
     var _a, _b;
-    const isRTL = this.isRTLLocale(locale);
+    const isRTL2 = this.isRTLLocale(locale);
     if (typeof ((_a = I18nManager) == null ? void 0 : _a.allowRTL) !== "function" || typeof ((_b = I18nManager) == null ? void 0 : _b.forceRTL) !== "function") {
       return;
     }
-    if (I18nManager.isRTL !== isRTL) {
-      I18nManager.allowRTL(isRTL);
-      I18nManager.forceRTL(isRTL);
+    if (I18nManager.isRTL !== isRTL2) {
+      I18nManager.allowRTL(isRTL2);
+      I18nManager.forceRTL(isRTL2);
     }
   }
   notifyListeners(change) {
@@ -218,6 +254,7 @@ var DefaultI18nEngine = class {
     const normalizedLocale = this.normalizeLocaleTag(locale);
     if (this.i18n.locale !== normalizedLocale) {
       this.i18n.locale = normalizedLocale;
+      this.invalidateCaches();
       this.handleRTL(normalizedLocale);
       this.version += 1;
       this.notifyListeners({ type: "locale", version: this.version });
@@ -233,39 +270,36 @@ var DefaultI18nEngine = class {
       this.i18n.locale = prevLocale;
     }
   }
-  getLocaleChain(locale) {
-    const chain = [];
-    const normalizedLocale = this.normalizeLocaleTag(locale);
-    chain.push(normalizedLocale);
-    const parts = normalizedLocale.split("-").filter(Boolean);
+  /** 将 locale 及其自动降级（如 en-US → en）追加到 chain 中 */
+  pushWithDegradation(chain, locale) {
+    const normalized = this.normalizeLocaleTag(locale);
+    chain.push(normalized);
+    const parts = normalized.split("-").filter(Boolean);
     for (let i = parts.length - 1; i >= 1; i -= 1) {
       chain.push(parts.slice(0, i).join("-"));
     }
+  }
+  getLocaleChain(locale) {
+    const cached = this.localeChainCache.get(locale);
+    if (cached) return cached;
+    const chain = [];
+    this.pushWithDegradation(chain, locale);
+    const normalizedLocale = this.normalizeLocaleTag(locale);
     const extra = this.fallbackLocales ? typeof this.fallbackLocales === "function" ? this.fallbackLocales(normalizedLocale) : this.fallbackLocales : [];
     for (const l of extra) {
-      const normalizedFallback = this.normalizeLocaleTag(l);
-      chain.push(normalizedFallback);
-      const fallbackParts = normalizedFallback.split("-").filter(Boolean);
-      for (let i = fallbackParts.length - 1; i >= 1; i -= 1) {
-        chain.push(fallbackParts.slice(0, i).join("-"));
-      }
+      this.pushWithDegradation(chain, l);
     }
     if (this.i18n.defaultLocale) {
-      const normalizedDefault = this.normalizeLocaleTag(this.i18n.defaultLocale);
-      chain.push(normalizedDefault);
-      const defaultParts = normalizedDefault.split("-").filter(Boolean);
-      for (let i = defaultParts.length - 1; i >= 1; i -= 1) {
-        chain.push(defaultParts.slice(0, i).join("-"));
-      }
+      this.pushWithDegradation(chain, this.i18n.defaultLocale);
     }
     const seen = /* @__PURE__ */ new Set();
-    return chain.filter((l) => {
-      if (!l) return false;
-      const normalized = l;
-      if (seen.has(normalized)) return false;
-      seen.add(normalized);
+    const result = chain.filter((l) => {
+      if (!l || seen.has(l)) return false;
+      seen.add(l);
       return true;
     });
+    this.localeChainCache.set(locale, result);
+    return result;
   }
   hasTranslation(locale, key) {
     var _a;
@@ -300,7 +334,7 @@ var DefaultI18nEngine = class {
   }
   isRTLLocale(locale) {
     var _a;
-    const normalized = locale.replace(/_/g, "-");
+    const normalized = this.normalizeLocaleTag(locale);
     const parts = normalized.split("-").filter(Boolean);
     const languageCode = (_a = parts[0]) == null ? void 0 : _a.toLowerCase();
     if (!languageCode) return false;
@@ -400,13 +434,13 @@ function useI18n() {
   }, [context]);
 }
 var escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var TAG_REGEX = /<(\/?)([A-Za-z][\w-]*)(?:\s[^>]*?)?(\/?)>/g;
 var parseString = (input) => {
   var _a;
   const root = { type: "tag", name: "root", children: [] };
   const stack = [root];
-  const tagRegex = /<(\/?)([A-Za-z][\w-]*)(?:\s[^>]*?)?(\/?)>/g;
   let lastIndex = 0;
-  for (const match of input.matchAll(tagRegex)) {
+  for (const match of input.matchAll(TAG_REGEX)) {
     const fullMatch = match[0];
     const isClosing = match[1] === "/";
     const tagName = match[2];
@@ -436,51 +470,57 @@ var parseString = (input) => {
   }
   return root.children;
 };
+var renderAST = (nodes, keyPrefix, components, placeholderToElement) => {
+  return nodes.map((node, index) => {
+    const key = `${keyPrefix}-${index}`;
+    if (node.type === "text") {
+      const placeholders = Object.keys(placeholderToElement);
+      if (placeholders.length === 0) return node.content;
+      const pattern = new RegExp(`(${placeholders.map(escapeRegExp).join("|")})`, "g");
+      const parts = node.content.split(pattern);
+      if (parts.length === 1) return node.content;
+      return /* @__PURE__ */ React.createElement(Fragment, { key }, parts.map((part, i) => {
+        if (placeholderToElement[part]) {
+          return cloneElement(placeholderToElement[part], { key: `${key}-${i}` });
+        }
+        return part;
+      }));
+    } else if (node.type === "tag") {
+      const Component = components == null ? void 0 : components[node.name];
+      const children = renderAST(node.children, key, components, placeholderToElement);
+      if (isValidElement(Component)) {
+        return cloneElement(Component, { key }, children.length > 0 ? children : void 0);
+      }
+      return /* @__PURE__ */ React.createElement(Fragment, { key }, children);
+    }
+    return null;
+  });
+};
 var Trans = ({ i18nKey, values, components, ...props }) => {
   const { t: t2 } = useI18n();
-  const stringValues = {};
-  const placeholderToElement = {};
-  if (values) {
-    Object.keys(values).forEach((key) => {
-      const value = values[key];
-      if (isValidElement(value)) {
-        const placeholder = `__ELEMENT_${key}__`;
-        placeholderToElement[placeholder] = value;
-        stringValues[key] = placeholder;
-      } else {
-        stringValues[key] = value == null ? "" : String(value);
-      }
-    });
-  }
-  const translatedText = t2(i18nKey, stringValues);
-  const ast = parseString(translatedText);
-  const renderAST = (nodes, keyPrefix) => {
-    return nodes.map((node, index) => {
-      const key = `${keyPrefix}-${index}`;
-      if (node.type === "text") {
-        const placeholders = Object.keys(placeholderToElement);
-        if (placeholders.length === 0) return node.content;
-        const pattern = new RegExp(`(${placeholders.map(escapeRegExp).join("|")})`, "g");
-        const parts = node.content.split(pattern);
-        if (parts.length === 1) return node.content;
-        return /* @__PURE__ */ React.createElement(Fragment, { key }, parts.map((part, i) => {
-          if (placeholderToElement[part]) {
-            return cloneElement(placeholderToElement[part], { key: `${key}-${i}` });
-          }
-          return part;
-        }));
-      } else if (node.type === "tag") {
-        const Component = components == null ? void 0 : components[node.name];
-        const children2 = renderAST(node.children, key);
-        if (isValidElement(Component)) {
-          return cloneElement(Component, { key }, children2.length > 0 ? children2 : void 0);
+  const { stringValues, placeholderToElement } = useMemo(() => {
+    const sv = {};
+    const pte = {};
+    if (values) {
+      for (const key of Object.keys(values)) {
+        const value = values[key];
+        if (isValidElement(value)) {
+          const placeholder = `__ELEMENT_${key}__`;
+          pte[placeholder] = value;
+          sv[key] = placeholder;
+        } else {
+          sv[key] = value == null ? "" : String(value);
         }
-        return /* @__PURE__ */ React.createElement(Fragment, { key }, children2);
       }
-      return null;
-    });
-  };
-  const children = renderAST(ast, "trans");
+    }
+    return { stringValues: sv, placeholderToElement: pte };
+  }, [values]);
+  const translatedText = t2(i18nKey, stringValues);
+  const ast = useMemo(() => parseString(translatedText), [translatedText]);
+  const children = useMemo(
+    () => renderAST(ast, "trans", components, placeholderToElement),
+    [ast, components, placeholderToElement]
+  );
   return /* @__PURE__ */ React.createElement(Text, { ...props }, children);
 };
 
@@ -490,8 +530,14 @@ var loadTranslations = (translations) => i18nService.loadTranslations(translatio
 var setLocale = (locale) => i18nService.setLocale(locale);
 var getLocale = () => i18nService.getLocale();
 var t = (scope, options) => i18nService.t(scope, options);
+var formatNumber = (n, options) => i18nService.formatNumber(n, options);
+var formatCurrency = (n, currency, options) => i18nService.formatCurrency(n, currency, options);
+var formatDate = (date, options) => i18nService.formatDate(date, options);
+var subscribe = (listener) => i18nService.subscribe(listener);
+var isRTL = () => i18nService.isRTL();
+var resetToSystem = () => i18nService.resetToSystem();
 var readyI18n = () => i18nService.ready();
 var isI18nReady = () => i18nService.isReady();
 var index_default = i18nService;
 
-export { I18nContext, I18nProvider, Trans, index_default as default, getLocale, initI18n, isI18nReady, loadTranslations, readyI18n, setLocale, t, useI18n, withI18n };
+export { I18nContext, I18nProvider, Trans, index_default as default, formatCurrency, formatDate, formatNumber, getLocale, initI18n, isI18nReady, isRTL, loadTranslations, readyI18n, resetToSystem, setLocale, subscribe, t, useI18n, withI18n };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-i18njs",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "一个轻量级、类型安全、零心智负担的 React Native 国际化解决方案。",
   "repository": {
     "type": "git",
@@ -8,6 +8,17 @@
   },
   "license": "ISC",
   "author": "wangws",
+  "keywords": [
+    "react-native",
+    "i18n",
+    "internationalization",
+    "localization",
+    "l10n",
+    "translation",
+    "locale",
+    "react",
+    "typescript"
+  ],
   "sideEffects": false,
   "main": "dist/index.js",
   "module": "dist/index.mjs",