@chipmobilesdk/rn-i18n 0.3.0 → 0.4.0

package/lib/module/i18n.js

@@ -0,0 +1,230 @@
+"use strict";
+
+import { createReporter } from "./config/diagnostics.js";
+import { validateConfig } from "./config/validateConfig.js";
+import { createActiveLocaleStore } from "./locale/activeLocale.js";
+import { defaultDeviceLocaleProvider, matchSupportedLocale } from "./locale/deviceLocale.js";
+import { clearPersistedLocale, readPersistedLocale, readPersistedLocaleSync, writePersistedLocale } from "./locale/persistence.js";
+import { hasPluralRule } from "./translation/plurals.js";
+import { translate } from "./translation/resolver.js";
+import { createRuntimeRegistry, registerRuntimeEntries } from "./translation/runtimeKeys.js";
+import { formatCurrencyValue } from "./format/currency.js";
+import { formatDateValue } from "./format/date.js";
+import { formatNumberValue } from "./format/number.js";
+import { KNOWN_UNIT_IDS, convertUnitValue, formatUnitValue } from "./format/units.js";
+const DEFAULT_MISSING = {
+  mode: 'key'
+};
+const DEFAULT_INVALID = {
+  mode: 'placeholder',
+  text: '—'
+};
+
+/**
+ * Creates an I18n instance from an app-owned configuration. Validation runs
+ * eagerly and throws an I18nConfigError before any localized content can be
+ * served (FR-003). Pass the app's generated key type for typed lookups:
+ * `createI18n<AppI18nKey>(config)`.
+ */
+export function createI18n(config) {
+  validateConfig(config, KNOWN_UNIT_IDS);
+  const locales = [...config.locales];
+  const localesByCode = new Map(locales.map(locale => [locale.code, locale]));
+  const missingTranslation = config.missingTranslation ?? DEFAULT_MISSING;
+  const report = createReporter(config.onDiagnostic);
+  const invalidFormat = {
+    ...(config.invalidFormat ?? DEFAULT_INVALID),
+    report
+  };
+  const persistenceEnabled = config.persistLocale !== false && !!config.storage;
+  const runtimeEntries = createRuntimeRegistry(config.runtimeEntries);
+  const store = createActiveLocaleStore({
+    code: config.primaryLocale,
+    source: 'primaryFallback',
+    recovered: false
+  }, report);
+
+  // A language this package has no plural rule for falls back to
+  // `count === 1 ? one : other`, which is wrong for most of the world. Said
+  // once per locale, at creation, rather than never (I18N-12).
+  for (const locale of locales) {
+    if (!hasPluralRule(locale)) {
+      report({
+        code: 'plural_rule_default',
+        locale: locale.code,
+        message: `No plural rule for "${locale.code}"; falling back to "count === 1 selects one". ` + 'Declare `pluralRule` on the locale if that is not how the language works.'
+      });
+    }
+  }
+  const resolverContext = {
+    localesByCode,
+    resources: config.resources,
+    runtimeEntries,
+    missingTranslation,
+    warned: new Set(),
+    report
+  };
+  const activeLocale = () => {
+    const locale = localesByCode.get(store.get().code);
+    if (!locale) {
+      // Unreachable after validation; guards against external mutation.
+      throw new Error(`[rn-i18n] Active locale "${store.get().code}" is not configured.`);
+    }
+    return locale;
+  };
+
+  /** persisted → device → primary fallback; shared by `init` and `initSync`. */
+  const resolveInitialLocale = persisted => {
+    if (persisted) {
+      if (localesByCode.has(persisted)) {
+        store.set({
+          code: persisted,
+          source: 'persisted',
+          recovered: false
+        });
+        return;
+      }
+      report({
+        code: 'locale_unsupported',
+        locale: persisted,
+        message: `Persisted locale "${persisted}" is no longer supported; recovering to "${config.primaryLocale}".`
+      });
+      store.set({
+        code: config.primaryLocale,
+        source: 'primaryFallback',
+        recovered: true
+      });
+      return;
+    }
+    const provider = config.deviceLocale ?? defaultDeviceLocaleProvider;
+    const match = matchSupportedLocale(provider(), locales);
+    store.set(match ? {
+      code: match.code,
+      source: match.source,
+      recovered: false
+    } : {
+      code: config.primaryLocale,
+      source: 'primaryFallback',
+      recovered: false
+    });
+  };
+
+  /**
+   * `init()` runs once, and loses to the user.
+   *
+   * It used to be re-run by every caller (StrictMode mounts an effect twice),
+   * and the persisted value it had awaited was written in unconditionally — so
+   * a locale the user picked, or a deep link set, while the read was in flight
+   * was overwritten by the old one (I18N-07).
+   */
+  let initialized;
+  let switched = false;
+  const runInit = async () => {
+    const persisted = persistenceEnabled && config.storage ? await readPersistedLocale(config.storage, report) : null;
+    if (switched) {
+      // The user chose while the read was in flight; their choice stands.
+      return;
+    }
+    resolveInitialLocale(persisted);
+  };
+  return {
+    init() {
+      initialized ??= runInit();
+      return initialized;
+    },
+    initSync() {
+      if (!persistenceEnabled || !config.storage) {
+        resolveInitialLocale(null);
+        return true;
+      }
+      const {
+        storage
+      } = config;
+      if (typeof storage.getItemSync !== 'function') {
+        return false;
+      }
+      resolveInitialLocale(readPersistedLocaleSync(storage, report));
+      return true;
+    },
+    t(key, vars, options) {
+      return translate(resolverContext, store.get().code, key, vars, options);
+    },
+    getLocale() {
+      return store.get();
+    },
+    async setLocale(code) {
+      if (!localesByCode.has(code)) {
+        throw new Error(`[rn-i18n] Cannot switch to unsupported locale "${code}".`);
+      }
+      switched = true;
+      const current = store.get();
+      if (current.code === code && current.source === 'runtimeSwitch') {
+        // Already this locale, by this route: re-rendering the whole tree and
+        // rewriting storage would change nothing (I18N-07).
+        return;
+      }
+      store.set({
+        code,
+        source: 'runtimeSwitch',
+        recovered: false
+      });
+      if (persistenceEnabled && config.storage) {
+        await writePersistedLocale(config.storage, code, report);
+      }
+    },
+    async useDeviceLocale() {
+      switched = true;
+      if (persistenceEnabled && config.storage) {
+        await clearPersistedLocale(config.storage, report);
+      }
+      const provider = config.deviceLocale ?? defaultDeviceLocaleProvider;
+      const match = matchSupportedLocale(provider(), locales);
+      store.set(match ? {
+        code: match.code,
+        source: match.source,
+        recovered: false
+      } : {
+        code: config.primaryLocale,
+        source: 'primaryFallback',
+        recovered: false
+      });
+      return store.get();
+    },
+    getSupportedLocales() {
+      return locales;
+    },
+    formatNumber(value, options) {
+      const locale = activeLocale();
+      return formatNumberValue(value, locale.code, locale.defaultNumberFormat, options, invalidFormat);
+    },
+    formatDate(value, options, formatting) {
+      const locale = activeLocale();
+      return formatDateValue(value, locale.code, locale.defaultDateFormat, options, invalidFormat, formatting?.replaceDefaults === true);
+    },
+    formatCurrency(value, currency, options) {
+      const locale = activeLocale();
+      return formatCurrencyValue(value, locale.code, locale.defaultCurrency, currency, options, invalidFormat);
+    },
+    formatUnit(value, options) {
+      const locale = activeLocale();
+      return formatUnitValue(value, locale.code, locale.defaultUnit, locale.defaultNumberFormat, options, invalidFormat);
+    },
+    convertUnit(value, from, to) {
+      return convertUnitValue(value, from, to);
+    },
+    registerRuntimeEntries(entries) {
+      registerRuntimeEntries(runtimeEntries, entries);
+      // What `t()` answers has changed, so every subscriber has to read again:
+      // a feature that registered its entries after mounting used to leave the
+      // screen showing the key (I18N-06).
+      store.bump();
+    },
+    subscribe(listener) {
+      return store.subscribe(listener);
+    },
+    getVersion() {
+      return store.getVersion();
+    }
+  };
+}
+//# sourceMappingURL=i18n.js.map

package/lib/module/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createReporter","validateConfig","createActiveLocaleStore","defaultDeviceLocaleProvider","matchSupportedLocale","clearPersistedLocale","readPersistedLocale","readPersistedLocaleSync","writePersistedLocale","hasPluralRule","translate","createRuntimeRegistry","registerRuntimeEntries","formatCurrencyValue","formatDateValue","formatNumberValue","KNOWN_UNIT_IDS","convertUnitValue","formatUnitValue","DEFAULT_MISSING","mode","DEFAULT_INVALID","text","createI18n","config","locales","localesByCode","Map","map","locale","code","missingTranslation","report","onDiagnostic","invalidFormat","persistenceEnabled","persistLocale","storage","runtimeEntries","store","primaryLocale","source","recovered","message","resolverContext","resources","warned","Set","activeLocale","get","Error","resolveInitialLocale","persisted","has","set","provider","deviceLocale","match","initialized","switched","runInit","init","initSync","getItemSync","t","key","vars","options","getLocale","setLocale","current","useDeviceLocale","getSupportedLocales","formatNumber","value","defaultNumberFormat","formatDate","formatting","defaultDateFormat","replaceDefaults","formatCurrency","currency","defaultCurrency","formatUnit","defaultUnit","convertUnit","from","to","entries","bump","subscribe","listener","getVersion"],"sourceRoot":"../../src","sources":["i18n.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/**
+ * @chipmobilesdk/rn-i18n — reusable localization for ChipMobileSdk-family
+ * React Native apps.
+ *
+ * This is the single entrypoint, and the package is React Native code only. The
+ * Node-only extraction and synchronization tooling is a package of its own,
+ * `@chipmobilesdk/rn-i18n-tooling` (the `chip-i18n` CLI): it used to ship inside
+ * this tarball as TypeScript source under `./tooling`, which no consumer could
+ * execute.
+ */
+
+export { createI18n } from "./i18n.js";
+export { I18nConfigError } from "./config/types.js";
+export { runtimeEntriesFromCatalog } from "./config/catalog.js";
+export { localeStorageFromKeyValue } from "./locale/keyValueStorage.js";
+export { LOCALE_STORAGE_KEY } from "./locale/persistence.js";
+export { defaultDeviceLocaleProvider } from "./locale/deviceLocale.js";
+export { SUPPORTED_UNITS, UnitConversionError, convertUnitValue as convertUnit, getUnitSymbol } from "./format/units.js";
+export { I18nProvider } from "./react/I18nProvider.js";
+export { useLocale, useTranslation } from "./react/hooks.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createI18n","I18nConfigError","runtimeEntriesFromCatalog","localeStorageFromKeyValue","LOCALE_STORAGE_KEY","defaultDeviceLocaleProvider","SUPPORTED_UNITS","UnitConversionError","convertUnitValue","convertUnit","getUnitSymbol","I18nProvider","useLocale","useTranslation"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,QAAQ,WAAQ;AAGnC,SAASC,eAAe,QAAQ,mBAAgB;AAChD,SAASC,yBAAyB,QAAQ,qBAAkB;AAC5D,SAASC,yBAAyB,QAAQ,6BAA0B;AA6BpE,SAASC,kBAAkB,QAAQ,yBAAsB;AACzD,SAASC,2BAA2B,QAAQ,0BAAuB;AAEnE,SACCC,eAAe,EACfC,mBAAmB,EACnBC,gBAAgB,IAAIC,WAAW,EAC/BC,aAAa,QACP,mBAAgB;AAGvB,SAASC,YAAY,QAAQ,yBAAsB;AAEnD,SAASC,SAAS,EAAEC,cAAc,QAAQ,kBAAe","ignoreList":[]}

package/lib/module/locale/activeLocale.js

@@ -0,0 +1,33 @@
+"use strict";
+
+import { createListenerSet } from '@chipmobilesdk/rn-core';
+import { defaultReporter, describeError } from "../config/diagnostics.js";
+export function createActiveLocaleStore(initial, report = defaultReporter) {
+  let preference = initial;
+  let version = 0;
+  const listeners = createListenerSet({
+    onListenerError: error => report({
+      code: 'listener_threw',
+      message: `A locale listener threw; the locale change still applied: ${describeError(error)}`
+    })
+  });
+  return {
+    get: () => preference,
+    set(next) {
+      preference = next;
+      version += 1;
+      // Isolated (CORE-03). One that threw used to skip every listener after
+      // it — useSyncExternalStore subscribers included — and made setLocale
+      // reject after the switch but before the choice was persisted, so the
+      // app showed one locale and stored another.
+      listeners.notify();
+    },
+    bump() {
+      version += 1;
+      listeners.notify();
+    },
+    subscribe: listener => listeners.add(listener),
+    getVersion: () => version
+  };
+}
+//# sourceMappingURL=activeLocale.js.map

package/lib/module/locale/activeLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createListenerSet","defaultReporter","describeError","createActiveLocaleStore","initial","report","preference","version","listeners","onListenerError","error","code","message","get","set","next","notify","bump","subscribe","listener","add","getVersion"],"sourceRoot":"../../../src","sources":["locale/activeLocale.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,wBAAwB;AAE1D,SAASC,eAAe,EAAEC,aAAa,QAAoC,0BAAuB;AAiBlG,OAAO,SAASC,uBAAuBA,CACtCC,OAA+B,EAC/BC,MAA6B,GAAGJ,eAAe,EAC3B;EACpB,IAAIK,UAAU,GAAGF,OAAO;EACxB,IAAIG,OAAO,GAAG,CAAC;EACf,MAAMC,SAAS,GAAGR,iBAAiB,CAAK;IACvCS,eAAe,EAAEC,KAAK,IACrBL,MAAM,CAAC;MACNM,IAAI,EAAE,gBAAgB;MACtBC,OAAO,EAAE,6DAA6DV,aAAa,CAACQ,KAAK,CAAC;IAC3F,CAAC;EACH,CAAC,CAAC;EAEF,OAAO;IACNG,GAAG,EAAEA,CAAA,KAAMP,UAAU;IACrBQ,GAAGA,CAACC,IAAI,EAAE;MACTT,UAAU,GAAGS,IAAI;MACjBR,OAAO,IAAI,CAAC;MACZ;MACA;MACA;MACA;MACAC,SAAS,CAACQ,MAAM,CAAC,CAAC;IACnB,CAAC;IACDC,IAAIA,CAAA,EAAG;MACNV,OAAO,IAAI,CAAC;MACZC,SAAS,CAACQ,MAAM,CAAC,CAAC;IACnB,CAAC;IACDE,SAAS,EAAEC,QAAQ,IAAIX,SAAS,CAACY,GAAG,CAACD,QAAQ,CAAC;IAC9CE,UAAU,EAAEA,CAAA,KAAMd;EACnB,CAAC;AACF","ignoreList":[]}

package/lib/module/locale/deviceLocale.js

@@ -0,0 +1,46 @@
+"use strict";
+
+/**
+ * Default device locale detection. Hermes resolves the Intl default locale
+ * from the device locale on both Android and iOS, so no native module is
+ * required. Apps may inject their own provider (e.g. react-native-localize)
+ * through `I18nConfig.deviceLocale`.
+ */
+export const defaultDeviceLocaleProvider = () => {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale;
+  } catch {
+    return undefined;
+  }
+};
+/**
+ * Matches a detected device locale against the supported locales: an exact
+ * (case-insensitive) match wins; otherwise a device language that matches
+ * exactly one supported locale selects that locale (US4 scenario 3).
+ */
+export function matchSupportedLocale(deviceLocale, locales) {
+  if (!deviceLocale) {
+    return undefined;
+  }
+  const normalized = deviceLocale.toLowerCase();
+  const exact = locales.find(locale => locale.code.toLowerCase() === normalized);
+  if (exact) {
+    return {
+      code: exact.code,
+      source: 'device'
+    };
+  }
+  const language = normalized.split('-')[0];
+  if (!language) {
+    return undefined;
+  }
+  const languageMatches = locales.filter(locale => locale.code.toLowerCase().split('-')[0] === language);
+  if (languageMatches.length === 1) {
+    return {
+      code: languageMatches[0].code,
+      source: 'languageMatch'
+    };
+  }
+  return undefined;
+}
+//# sourceMappingURL=deviceLocale.js.map

package/lib/module/locale/deviceLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defaultDeviceLocaleProvider","Intl","DateTimeFormat","resolvedOptions","locale","undefined","matchSupportedLocale","deviceLocale","locales","normalized","toLowerCase","exact","find","code","source","language","split","languageMatches","filter","length"],"sourceRoot":"../../../src","sources":["locale/deviceLocale.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,2BAAiD,GAAGA,CAAA,KAAM;EACtE,IAAI;IACH,OAAOC,IAAI,CAACC,cAAc,CAAC,CAAC,CAACC,eAAe,CAAC,CAAC,CAACC,MAAM;EACtD,CAAC,CAAC,MAAM;IACP,OAAOC,SAAS;EACjB;AACD,CAAC;AAOD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CACnCC,YAAgC,EAChCC,OAAgC,EACA;EAChC,IAAI,CAACD,YAAY,EAAE;IAClB,OAAOF,SAAS;EACjB;EACA,MAAMI,UAAU,GAAGF,YAAY,CAACG,WAAW,CAAC,CAAC;EAC7C,MAAMC,KAAK,GAAGH,OAAO,CAACI,IAAI,CAACR,MAAM,IAAIA,MAAM,CAACS,IAAI,CAACH,WAAW,CAAC,CAAC,KAAKD,UAAU,CAAC;EAC9E,IAAIE,KAAK,EAAE;IACV,OAAO;MAAEE,IAAI,EAAEF,KAAK,CAACE,IAAI;MAAEC,MAAM,EAAE;IAAS,CAAC;EAC9C;EACA,MAAMC,QAAQ,GAAGN,UAAU,CAACO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;EACzC,IAAI,CAACD,QAAQ,EAAE;IACd,OAAOV,SAAS;EACjB;EACA,MAAMY,eAAe,GAAGT,OAAO,CAACU,MAAM,CACrCd,MAAM,IAAIA,MAAM,CAACS,IAAI,CAACH,WAAW,CAAC,CAAC,CAACM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAKD,QACvD,CAAC;EACD,IAAIE,eAAe,CAACE,MAAM,KAAK,CAAC,EAAE;IACjC,OAAO;MAAEN,IAAI,EAAEI,eAAe,CAAC,CAAC,CAAC,CAACJ,IAAI;MAAEC,MAAM,EAAE;IAAgB,CAAC;EAClE;EACA,OAAOT,SAAS;AACjB","ignoreList":[]}

package/lib/module/locale/keyValueStorage.js

@@ -0,0 +1,25 @@
+"use strict";
+
+/**
+ * A `LocaleStorageAdapter` over rn-core's synchronous `KeyValuePort` (PERF-08).
+ *
+ * The adapter carries `getItemSync`, so `i18n.initSync()` resolves the persisted
+ * locale before the first render. Open the port the way the app opens its other
+ * durable state, for example `openDurable(() => createMMKV({ id: 'app' }))`.
+ */
+
+export function localeStorageFromKeyValue(port) {
+  return {
+    getItemSync: key => port.getString(key) ?? null,
+    async getItem(key) {
+      return port.getString(key) ?? null;
+    },
+    async setItem(key, value) {
+      port.set(key, value);
+    },
+    async removeItem(key) {
+      port.remove(key);
+    }
+  };
+}
+//# sourceMappingURL=keyValueStorage.js.map

package/lib/module/locale/keyValueStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["localeStorageFromKeyValue","port","getItemSync","key","getString","getItem","setItem","value","set","removeItem","remove"],"sourceRoot":"../../../src","sources":["locale/keyValueStorage.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,OAAO,SAASA,yBAAyBA,CACxCC,IAAkB,EACmD;EACrE,OAAO;IACNC,WAAW,EAAEC,GAAG,IAAIF,IAAI,CAACG,SAAS,CAACD,GAAG,CAAC,IAAI,IAAI;IAC/C,MAAME,OAAOA,CAACF,GAAG,EAAE;MAClB,OAAOF,IAAI,CAACG,SAAS,CAACD,GAAG,CAAC,IAAI,IAAI;IACnC,CAAC;IACD,MAAMG,OAAOA,CAACH,GAAG,EAAEI,KAAK,EAAE;MACzBN,IAAI,CAACO,GAAG,CAACL,GAAG,EAAEI,KAAK,CAAC;IACrB,CAAC;IACD,MAAME,UAAUA,CAACN,GAAG,EAAE;MACrBF,IAAI,CAACS,MAAM,CAACP,GAAG,CAAC;IACjB;EACD,CAAC;AACF","ignoreList":[]}

package/lib/module/locale/persistence.js

@@ -0,0 +1,66 @@
+"use strict";
+
+import { defaultReporter, describeError } from "../config/diagnostics.js";
+export const LOCALE_STORAGE_KEY = '@chipmobilesdk/rn-i18n:locale';
+
+/**
+ * Reads the persisted locale preference. Adapter failures are reported and
+ * treated as "no persisted value" so locale selection never crashes (FR-015).
+ */
+export async function readPersistedLocale(storage, report = defaultReporter) {
+  try {
+    return await storage.getItem(LOCALE_STORAGE_KEY);
+  } catch (error) {
+    report({
+      code: 'locale_read_failed',
+      message: `Failed to read the persisted locale preference: ${describeError(error)}`
+    });
+    return null;
+  }
+}
+
+/** `readPersistedLocale` for a store with a synchronous read; same failure handling. */
+export function readPersistedLocaleSync(storage, report = defaultReporter) {
+  try {
+    return storage.getItemSync(LOCALE_STORAGE_KEY);
+  } catch (error) {
+    report({
+      code: 'locale_read_failed',
+      message: `Failed to read the persisted locale preference: ${describeError(error)}`
+    });
+    return null;
+  }
+}
+
+/**
+ * Persists the selected locale. Persistence is best-effort: a write failure
+ * is reported but the in-memory locale switch stays authoritative.
+ */
+export async function writePersistedLocale(storage, code, report = defaultReporter) {
+  try {
+    await storage.setItem(LOCALE_STORAGE_KEY, code);
+  } catch (error) {
+    report({
+      code: 'locale_write_failed',
+      locale: code,
+      message: `Failed to persist locale "${code}": ${describeError(error)}`
+    });
+  }
+}
+
+/**
+ * Forgets the stored choice, so the next launch follows the device again. The
+ * adapter's `removeItem` was required by the contract and called by nothing
+ * until `useDeviceLocale()` (I18N-17). Best-effort, like the write.
+ */
+export async function clearPersistedLocale(storage, report = defaultReporter) {
+  try {
+    await storage.removeItem(LOCALE_STORAGE_KEY);
+  } catch (error) {
+    report({
+      code: 'locale_write_failed',
+      message: `Failed to forget the persisted locale preference: ${describeError(error)}`
+    });
+  }
+}
+//# sourceMappingURL=persistence.js.map

package/lib/module/locale/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defaultReporter","describeError","LOCALE_STORAGE_KEY","readPersistedLocale","storage","report","getItem","error","code","message","readPersistedLocaleSync","getItemSync","writePersistedLocale","setItem","locale","clearPersistedLocale","removeItem"],"sourceRoot":"../../../src","sources":["locale/persistence.ts"],"mappings":";;AAAA,SAASA,eAAe,EAAEC,aAAa,QAAoC,0BAAuB;AAGlG,OAAO,MAAMC,kBAAkB,GAAG,+BAA+B;;AAEjE;AACA;AACA;AACA;AACA,OAAO,eAAeC,mBAAmBA,CACxCC,OAA6B,EAC7BC,MAA6B,GAAGL,eAAe,EACtB;EACzB,IAAI;IACH,OAAO,MAAMI,OAAO,CAACE,OAAO,CAACJ,kBAAkB,CAAC;EACjD,CAAC,CAAC,OAAOK,KAAK,EAAE;IACfF,MAAM,CAAC;MACNG,IAAI,EAAE,oBAAoB;MAC1BC,OAAO,EAAE,mDAAmDR,aAAa,CAACM,KAAK,CAAC;IACjF,CAAC,CAAC;IACF,OAAO,IAAI;EACZ;AACD;;AAEA;AACA,OAAO,SAASG,uBAAuBA,CACtCN,OAA2E,EAC3EC,MAA6B,GAAGL,eAAe,EAC/B;EAChB,IAAI;IACH,OAAOI,OAAO,CAACO,WAAW,CAACT,kBAAkB,CAAC;EAC/C,CAAC,CAAC,OAAOK,KAAK,EAAE;IACfF,MAAM,CAAC;MACNG,IAAI,EAAE,oBAAoB;MAC1BC,OAAO,EAAE,mDAAmDR,aAAa,CAACM,KAAK,CAAC;IACjF,CAAC,CAAC;IACF,OAAO,IAAI;EACZ;AACD;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeK,oBAAoBA,CACzCR,OAA6B,EAC7BI,IAAY,EACZH,MAA6B,GAAGL,eAAe,EAC/B;EAChB,IAAI;IACH,MAAMI,OAAO,CAACS,OAAO,CAACX,kBAAkB,EAAEM,IAAI,CAAC;EAChD,CAAC,CAAC,OAAOD,KAAK,EAAE;IACfF,MAAM,CAAC;MACNG,IAAI,EAAE,qBAAqB;MAC3BM,MAAM,EAAEN,IAAI;MACZC,OAAO,EAAE,6BAA6BD,IAAI,MAAMP,aAAa,CAACM,KAAK,CAAC;IACrE,CAAC,CAAC;EACH;AACD;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeQ,oBAAoBA,CACzCX,OAA6B,EAC7BC,MAA6B,GAAGL,eAAe,EAC/B;EAChB,IAAI;IACH,MAAMI,OAAO,CAACY,UAAU,CAACd,kBAAkB,CAAC;EAC7C,CAAC,CAAC,OAAOK,KAAK,EAAE;IACfF,MAAM,CAAC;MACNG,IAAI,EAAE,qBAAqB;MAC3BC,OAAO,EAAE,qDAAqDR,aAAa,CAACM,KAAK,CAAC;IACnF,CAAC,CAAC;EACH;AACD","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/react/I18nProvider.js

@@ -0,0 +1,29 @@
+"use strict";
+
+import React, { createContext, useContext } from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+// The context intentionally erases the app-specific key type; the typed
+// surface is restored by the hooks' generic parameters.
+export const I18nContext = /*#__PURE__*/createContext(null);
+/**
+ * Provides the I18n instance to the React tree. Locale changes re-render
+ * consumers through the hooks' useSyncExternalStore subscription, so a
+ * runtime switch updates UI within one interaction cycle (PERF-002).
+ */
+export function I18nProvider({
+  i18n,
+  children
+}) {
+  return /*#__PURE__*/_jsx(I18nContext.Provider, {
+    value: i18n,
+    children: children
+  });
+}
+export function useI18nContext() {
+  const i18n = useContext(I18nContext);
+  if (!i18n) {
+    throw new Error('[rn-i18n] No I18n instance found. Wrap your app in <I18nProvider>.');
+  }
+  return i18n;
+}
+//# sourceMappingURL=I18nProvider.js.map

package/lib/module/react/I18nProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","jsx","_jsx","I18nContext","I18nProvider","i18n","children","Provider","value","useI18nContext","Error"],"sourceRoot":"../../../src","sources":["react/I18nProvider.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAIC,aAAa,EAAEC,UAAU,QAAQ,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAIzD;AACA;AACA,OAAO,MAAMC,WAAW,gBAAGJ,aAAa,CAAsB,IAAI,CAAC;AAOnE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,YAAYA,CAAC;EAAEC,IAAI;EAAEC;AAA4B,CAAC,EAAE;EACnE,oBACCJ,IAAA,CAACC,WAAW,CAACI,QAAQ;IAACC,KAAK,EAAEH,IAAgC;IAAAC,QAAA,EAAEA;EAAQ,CAAuB,CAAC;AAEjG;AAEA,OAAO,SAASG,cAAcA,CAAA,EAAiB;EAC9C,MAAMJ,IAAI,GAAGL,UAAU,CAACG,WAAW,CAAC;EACpC,IAAI,CAACE,IAAI,EAAE;IACV,MAAM,IAAIK,KAAK,CAAC,oEAAoE,CAAC;EACtF;EACA,OAAOL,IAAI;AACZ","ignoreList":[]}

package/lib/module/react/hooks.js

@@ -0,0 +1,42 @@
+"use strict";
+
+import { useCallback, useMemo, useSyncExternalStore } from 'react';
+import { useI18nContext } from "./I18nProvider.js";
+function useLocaleVersion(i18n) {
+  return useSyncExternalStore(i18n.subscribe, i18n.getVersion, i18n.getVersion);
+}
+/**
+ * Returns the translation function bound to the active locale. Pass the
+ * app's generated key type for compile-time key validation (FR-041):
+ * `const { t } = useTranslation<AppI18nKey>();`
+ */
+export function useTranslation() {
+  const i18n = useI18nContext();
+  const version = useLocaleVersion(i18n);
+  // One `t` and one result per locale version (I18N-05): a memoized child that
+  // takes `t` re-renders when the locale changes, not on every parent render.
+  return useMemo(() => ({
+    t: (key, vars, options) => i18n.t(key, vars, options),
+    locale: i18n.getLocale().code
+  }),
+  // `version` is the dependency that matters: it changes with the locale.
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- `version` is read to invalidate, not used
+  [i18n, version]);
+}
+/** Returns active locale state, direction metadata, and the locale switcher. */
+export function useLocale() {
+  const i18n = useI18nContext();
+  useLocaleVersion(i18n);
+  const setLocale = useCallback(code => i18n.setLocale(code), [i18n]);
+  const preference = i18n.getLocale();
+  const supportedLocales = i18n.getSupportedLocales();
+  const active = supportedLocales.find(locale => locale.code === preference.code);
+  return {
+    locale: preference.code,
+    direction: active?.direction ?? 'ltr',
+    preference,
+    supportedLocales,
+    setLocale
+  };
+}
+//# sourceMappingURL=hooks.js.map

package/lib/module/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useSyncExternalStore","useI18nContext","useLocaleVersion","i18n","subscribe","getVersion","useTranslation","version","t","key","vars","options","locale","getLocale","code","useLocale","setLocale","preference","supportedLocales","getSupportedLocales","active","find","direction"],"sourceRoot":"../../../src","sources":["react/hooks.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,OAAO,EAAEC,oBAAoB,QAAQ,OAAO;AASlE,SAASC,cAAc,QAAQ,mBAAgB;AAE/C,SAASC,gBAAgBA,CAACC,IAAkB,EAAU;EACrD,OAAOH,oBAAoB,CAACG,IAAI,CAACC,SAAS,EAAED,IAAI,CAACE,UAAU,EAAEF,IAAI,CAACE,UAAU,CAAC;AAC9E;AAOA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAA6D;EAC1F,MAAMH,IAAI,GAAGF,cAAc,CAAC,CAAC;EAC7B,MAAMM,OAAO,GAAGL,gBAAgB,CAACC,IAAI,CAAC;EACtC;EACA;EACA,OAAOJ,OAAO,CACb,OAAO;IACNS,CAAC,EAAEA,CAACC,GAAS,EAAEC,IAAoB,EAAEC,OAA0B,KAC9DR,IAAI,CAACK,CAAC,CAACC,GAAG,EAAEC,IAAI,EAAEC,OAAO,CAAC;IAC3BC,MAAM,EAAET,IAAI,CAACU,SAAS,CAAC,CAAC,CAACC;EAC1B,CAAC,CAAC;EACF;EACA;EACA,CAACX,IAAI,EAAEI,OAAO,CACf,CAAC;AACF;AAUA;AACA,OAAO,SAASQ,SAASA,CAAA,EAAoB;EAC5C,MAAMZ,IAAI,GAAGF,cAAc,CAAC,CAAC;EAC7BC,gBAAgB,CAACC,IAAI,CAAC;EACtB,MAAMa,SAAS,GAAGlB,WAAW,CAAEgB,IAAY,IAAKX,IAAI,CAACa,SAAS,CAACF,IAAI,CAAC,EAAE,CAACX,IAAI,CAAC,CAAC;EAC7E,MAAMc,UAAU,GAAGd,IAAI,CAACU,SAAS,CAAC,CAAC;EACnC,MAAMK,gBAAgB,GAAGf,IAAI,CAACgB,mBAAmB,CAAC,CAAC;EACnD,MAAMC,MAAM,GAAGF,gBAAgB,CAACG,IAAI,CAACT,MAAM,IAAIA,MAAM,CAACE,IAAI,KAAKG,UAAU,CAACH,IAAI,CAAC;EAC/E,OAAO;IACNF,MAAM,EAAEK,UAAU,CAACH,IAAI;IACvBQ,SAAS,EAAEF,MAAM,EAAEE,SAAS,IAAI,KAAK;IACrCL,UAAU;IACVC,gBAAgB;IAChBF;EACD,CAAC;AACF","ignoreList":[]}

package/lib/module/translation/interpolate.js

@@ -0,0 +1,20 @@
+"use strict";
+
+const VARIABLE_PATTERN = /\{\{\s*([\w.]+)\s*\}\}/g;
+
+/**
+ * Replaces `{{name}}` placeholders with named values. Missing variables keep
+ * their placeholder text so the result stays deterministic, and each missing
+ * name is reported through `onMissingVariable`.
+ */
+export function interpolate(text, vars, onMissingVariable) {
+  return text.replace(VARIABLE_PATTERN, (placeholder, name) => {
+    const value = vars?.[name];
+    if (value === undefined || value === null) {
+      onMissingVariable?.(name);
+      return placeholder;
+    }
+    return String(value);
+  });
+}
+//# sourceMappingURL=interpolate.js.map

package/lib/module/translation/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["VARIABLE_PATTERN","interpolate","text","vars","onMissingVariable","replace","placeholder","name","value","undefined","String"],"sourceRoot":"../../../src","sources":["translation/interpolate.ts"],"mappings":";;AAEA,MAAMA,gBAAgB,GAAG,yBAAyB;;AAElD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAC1BC,IAAY,EACZC,IAAoB,EACpBC,iBAA0C,EACjC;EACT,OAAOF,IAAI,CAACG,OAAO,CAACL,gBAAgB,EAAE,CAACM,WAAW,EAAEC,IAAY,KAAK;IACpE,MAAMC,KAAK,GAAGL,IAAI,GAAGI,IAAI,CAAC;IAC1B,IAAIC,KAAK,KAAKC,SAAS,IAAID,KAAK,KAAK,IAAI,EAAE;MAC1CJ,iBAAiB,GAAGG,IAAI,CAAC;MACzB,OAAOD,WAAW;IACnB;IACA,OAAOI,MAAM,CAACF,KAAK,CAAC;EACrB,CAAC,CAAC;AACH","ignoreList":[]}