@chipmobilesdk/rn-i18n 0.2.0 → 0.4.0

package/lib/module/translation/plurals.js

@@ -0,0 +1,114 @@
+"use strict";
+
+export const PLURAL_CATEGORIES = ['zero', 'one', 'two', 'few', 'many', 'other'];
+const oneOtherRule = count => count === 1 ? 'one' : 'other';
+const otherOnlyRule = () => 'other';
+/** French and Brazilian Portuguese: 0 and 1 are both singular. */
+const zeroOneRule = count => count === 0 || count === 1 ? 'one' : 'other';
+
+/** Russian, Ukrainian, Polish, Czech and their neighbours (CLDR). */
+const slavicRule = count => {
+  if (!Number.isInteger(count)) {
+    return 'many';
+  }
+  const mod10 = Math.abs(count) % 10;
+  const mod100 = Math.abs(count) % 100;
+  if (mod10 === 1 && mod100 !== 11) {
+    return 'one';
+  }
+  if (mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)) {
+    return 'few';
+  }
+  return 'many';
+};
+
+/** Arabic (CLDR), which uses every category. */
+const arabicRule = count => {
+  if (count === 0) return 'zero';
+  if (count === 1) return 'one';
+  if (count === 2) return 'two';
+  const mod100 = Math.abs(count) % 100;
+  if (mod100 >= 3 && mod100 <= 10) return 'few';
+  if (mod100 >= 11 && mod100 <= 99) return 'many';
+  return 'other';
+};
+
+/**
+ * Package-owned plural rules, a compact subset of CLDR. Intl.PluralRules is not
+ * implemented by Hermes, so rules are resolved from configuration to keep
+ * behavior identical across devices and test environments.
+ *
+ * A language that is not here falls back to `count === 1 ? one : other`, which
+ * is wrong for most of the world — Korean and Thai have no singular, French
+ * calls 0 singular, Russian has `few` and `many` — so the fallback now reports
+ * a diagnostic once per locale rather than being silently applied (I18N-12).
+ */
+const BUILT_IN_RULES = {
+  // one/other
+  en: oneOtherRule,
+  de: oneOtherRule,
+  es: oneOtherRule,
+  it: oneOtherRule,
+  nl: oneOtherRule,
+  sv: oneOtherRule,
+  da: oneOtherRule,
+  nb: oneOtherRule,
+  fi: oneOtherRule,
+  el: oneOtherRule,
+  he: oneOtherRule,
+  // other only
+  ja: otherOnlyRule,
+  vi: otherOnlyRule,
+  ko: otherOnlyRule,
+  zh: otherOnlyRule,
+  th: otherOnlyRule,
+  id: otherOnlyRule,
+  ms: otherOnlyRule,
+  // 0 and 1 are singular
+  fr: zeroOneRule,
+  pt: zeroOneRule,
+  // Slavic
+  ru: slavicRule,
+  uk: slavicRule,
+  pl: slavicRule,
+  cs: slavicRule,
+  sk: slavicRule,
+  // Every category
+  ar: arabicRule
+};
+export const DEFAULT_PLURAL_RULE = oneOtherRule;
+
+/** True when this package has a rule for the language, or the locale brought one. */
+export function hasPluralRule(locale) {
+  if (locale.pluralRule) {
+    return true;
+  }
+  const language = locale.code.split('-')[0]?.toLowerCase() ?? '';
+  return language in BUILT_IN_RULES;
+}
+export function resolvePluralRule(locale) {
+  if (locale.pluralRule) {
+    return locale.pluralRule;
+  }
+  const language = locale.code.split('-')[0]?.toLowerCase() ?? '';
+  return BUILT_IN_RULES[language] ?? DEFAULT_PLURAL_RULE;
+}
+
+/**
+ * A plural group is an object whose keys are all plural categories, whose
+ * values are all strings, and which provides the required `other` variant.
+ */
+export function isPluralGroup(node) {
+  if (typeof node !== 'object' || node === null) {
+    return false;
+  }
+  const keys = Object.keys(node);
+  if (keys.length === 0 || !('other' in node)) {
+    return false;
+  }
+  return keys.every(key => PLURAL_CATEGORIES.includes(key) && typeof node[key] === 'string');
+}
+export function selectPluralVariant(group, category) {
+  return group[category] ?? group.other;
+}
+//# sourceMappingURL=plurals.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["PLURAL_CATEGORIES","oneOtherRule","count","otherOnlyRule","zeroOneRule","slavicRule","Number","isInteger","mod10","Math","abs","mod100","arabicRule","BUILT_IN_RULES","en","de","es","it","nl","sv","da","nb","fi","el","he","ja","vi","ko","zh","th","id","ms","fr","pt","ru","uk","pl","cs","sk","ar","DEFAULT_PLURAL_RULE","hasPluralRule","locale","pluralRule","language","code","split","toLowerCase","resolvePluralRule","isPluralGroup","node","keys","Object","length","every","key","includes","selectPluralVariant","group","category","other"],"sourceRoot":"../../../src","sources":["translation/plurals.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/translation/resolver.js

@@ -0,0 +1,118 @@
+"use strict";
+
+import { interpolate } from "./interpolate.js";
+import { isPluralGroup, resolvePluralRule, selectPluralVariant } from "./plurals.js";
+/**
+ * How many lookup paths are remembered. An app that misses many distinct keys
+ * forgets the oldest first, so memory stays bounded (I18N-11).
+ */
+const WARNED_CAPACITY = 500;
+export function warnOnce(context, dedupeKey, diagnostic) {
+  const {
+    warned
+  } = context;
+  if (warned.has(dedupeKey)) {
+    return;
+  }
+  warned.add(dedupeKey);
+  if (warned.size > WARNED_CAPACITY) {
+    const oldest = warned.values().next().value;
+    if (oldest !== undefined) warned.delete(oldest);
+  }
+  context.report(diagnostic);
+}
+
+/** Walks a dot-path key through a nested translation namespace. */
+export function getTranslationNode(namespace, key) {
+  if (!namespace) {
+    return undefined;
+  }
+  let node = namespace;
+  for (const segment of key.split('.')) {
+    if (typeof node !== 'object' || node === null) {
+      return undefined;
+    }
+    const next = node[segment];
+    if (next === undefined) {
+      return undefined;
+    }
+    node = next;
+  }
+  return node;
+}
+function pickValue(node, locale, options, warnings, key) {
+  if (typeof node === 'string') {
+    return node;
+  }
+  if (isPluralGroup(node)) {
+    const count = options?.count;
+    if (count === undefined) {
+      return node.other;
+    }
+    return selectPluralVariant(node, resolvePluralRule(locale)(count));
+  }
+  warnOnce(warnings, `invalid-value|${locale.code}|${key}`, {
+    code: 'invalid_value',
+    key,
+    locale: locale.code,
+    message: `Translation value for "${key}" in locale "${locale.code}" is not text or a plural group; treating it as missing.`
+  });
+  return undefined;
+}
+
+/**
+ * Resolves a key through the active locale, its ordered fallback chain, and
+ * declared runtime-only default text, applying plural selection and named
+ * variable interpolation. Misses are reported with one console warning per
+ * lookup path; a full-chain miss applies the configured missing-translation
+ * policy (FR-008…FR-011, FR-033).
+ */
+export function translate(context, activeCode, key, vars, options) {
+  const active = context.localesByCode.get(activeCode);
+  const chain = [activeCode, ...(active?.fallbackChain ?? [])];
+  const mergedVars = options?.count === undefined ? vars : {
+    count: options.count,
+    ...vars
+  };
+  const interpolateWith = (text, sourceLocale) => interpolate(text, mergedVars, name => warnOnce(context, `missing-var|${sourceLocale}|${key}|${name}`, {
+    code: 'missing_variable',
+    key,
+    locale: sourceLocale,
+    message: `Missing interpolation variable "${name}" for key "${key}" in locale "${sourceLocale}".`
+  }));
+  for (const code of chain) {
+    const locale = context.localesByCode.get(code);
+    if (!locale) {
+      continue;
+    }
+    const node = getTranslationNode(context.resources[code], key);
+    if (node === undefined) {
+      continue;
+    }
+    const value = pickValue(node, locale, options, context, key);
+    if (value === undefined) {
+      continue;
+    }
+    if (code !== activeCode) {
+      warnOnce(context, `fallback|${activeCode}|${key}`, {
+        code: 'fallback_used',
+        key,
+        locale: activeCode,
+        message: `Key "${key}" is missing in locale "${activeCode}"; served from fallback locale "${code}".`
+      });
+    }
+    return interpolateWith(value, code);
+  }
+  const runtimeEntry = context.runtimeEntries.get(key);
+  if (runtimeEntry) {
+    return interpolateWith(runtimeEntry.defaultText, activeCode);
+  }
+  warnOnce(context, `missing|${activeCode}|${key}`, {
+    code: 'missing_translation',
+    key,
+    locale: activeCode,
+    message: `Missing translation for key "${key}" in locale "${activeCode}" and its entire fallback chain.`
+  });
+  return context.missingTranslation.mode === 'placeholder' ? context.missingTranslation.text : key;
+}
+//# sourceMappingURL=resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["interpolate","isPluralGroup","resolvePluralRule","selectPluralVariant","WARNED_CAPACITY","warnOnce","context","dedupeKey","diagnostic","warned","has","add","size","oldest","values","next","value","undefined","delete","report","getTranslationNode","namespace","key","node","segment","split","pickValue","locale","options","warnings","count","other","code","message","translate","activeCode","vars","active","localesByCode","get","chain","fallbackChain","mergedVars","interpolateWith","text","sourceLocale","name","resources","runtimeEntry","runtimeEntries","defaultText","missingTranslation","mode"],"sourceRoot":"../../../src","sources":["translation/resolver.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/translation/runtimeKeys.js

@@ -0,0 +1,50 @@
+"use strict";
+
+import { I18nConfigError } from "../config/types.js";
+
+/**
+ * Registry of declared runtime-only translation entries. Entries participate
+ * in the same lookup pipeline as scanned template keys and are protected from
+ * removal during locale JSON synchronization.
+ */
+
+export function createRuntimeRegistry(entries) {
+  const registry = new Map();
+  if (entries) {
+    registerRuntimeEntries(registry, entries);
+  }
+  return registry;
+}
+
+/**
+ * The same checks the configured entries get (I18N-06): an entry registered at
+ * runtime by a lazily loaded feature used to be written in unvalidated, so a
+ * missing key or a non-string default surfaced only when a screen rendered it.
+ */
+export function validateRuntimeEntries(entries) {
+  const issues = [];
+  const seen = new Set();
+  for (const entry of entries) {
+    if (!entry?.key) {
+      issues.push('Runtime-only entries must declare a non-empty key.');
+      continue;
+    }
+    if (seen.has(entry.key)) {
+      issues.push(`Duplicate runtime-only entry "${entry.key}".`);
+    }
+    seen.add(entry.key);
+    if (typeof entry.defaultText !== 'string') {
+      issues.push(`Runtime-only entry "${entry.key}" must declare default text.`);
+    }
+  }
+  if (issues.length > 0) {
+    throw new I18nConfigError(issues);
+  }
+}
+export function registerRuntimeEntries(registry, entries) {
+  validateRuntimeEntries(entries);
+  for (const entry of entries) {
+    registry.set(entry.key, entry);
+  }
+}
+//# sourceMappingURL=runtimeKeys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["I18nConfigError","createRuntimeRegistry","entries","registry","Map","registerRuntimeEntries","validateRuntimeEntries","issues","seen","Set","entry","key","push","has","add","defaultText","length","set"],"sourceRoot":"../../../src","sources":["translation/runtimeKeys.ts"],"mappings":";;AAAA,SAASA,eAAe,QAAsC,oBAAiB;;AAE/E;AACA;AACA;AACA;AACA;;AAGA,OAAO,SAASC,qBAAqBA,CACpCC,OAA4C,EACrB;EACvB,MAAMC,QAA8B,GAAG,IAAIC,GAAG,CAAC,CAAC;EAChD,IAAIF,OAAO,EAAE;IACZG,sBAAsB,CAACF,QAAQ,EAAED,OAAO,CAAC;EAC1C;EACA,OAAOC,QAAQ;AAChB;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,sBAAsBA,CAACJ,OAA2C,EAAQ;EACzF,MAAMK,MAAgB,GAAG,EAAE;EAC3B,MAAMC,IAAI,GAAG,IAAIC,GAAG,CAAS,CAAC;EAC9B,KAAK,MAAMC,KAAK,IAAIR,OAAO,EAAE;IAC5B,IAAI,CAACQ,KAAK,EAAEC,GAAG,EAAE;MAChBJ,MAAM,CAACK,IAAI,CAAC,oDAAoD,CAAC;MACjE;IACD;IACA,IAAIJ,IAAI,CAACK,GAAG,CAACH,KAAK,CAACC,GAAG,CAAC,EAAE;MACxBJ,MAAM,CAACK,IAAI,CAAC,iCAAiCF,KAAK,CAACC,GAAG,IAAI,CAAC;IAC5D;IACAH,IAAI,CAACM,GAAG,CAACJ,KAAK,CAACC,GAAG,CAAC;IACnB,IAAI,OAAOD,KAAK,CAACK,WAAW,KAAK,QAAQ,EAAE;MAC1CR,MAAM,CAACK,IAAI,CAAC,uBAAuBF,KAAK,CAACC,GAAG,8BAA8B,CAAC;IAC5E;EACD;EACA,IAAIJ,MAAM,CAACS,MAAM,GAAG,CAAC,EAAE;IACtB,MAAM,IAAIhB,eAAe,CAACO,MAAM,CAAC;EAClC;AACD;AAEA,OAAO,SAASF,sBAAsBA,CACrCF,QAA8B,EAC9BD,OAA2C,EACpC;EACPI,sBAAsB,CAACJ,OAAO,CAAC;EAC/B,KAAK,MAAMQ,KAAK,IAAIR,OAAO,EAAE;IAC5BC,QAAQ,CAACc,GAAG,CAACP,KAAK,CAACC,GAAG,EAAED,KAAK,CAAC;EAC/B;AACD","ignoreList":[]}

package/lib/typescript/commonjs/config/catalog.d.ts

@@ -0,0 +1,18 @@
+import type { RuntimeTranslationEntry } from './types';
+/**
+ * Runtime entries for a package's message catalog (I18N-13), so an app registers
+ * an SDK's copy in one line and translates it like its own:
+ *
+ * ```ts
+ * createI18n({ ...config, runtimeEntries: runtimeEntriesFromCatalog(paymentMessages.user) });
+ * ```
+ *
+ * Catalogs mark variables `{name}`; rn-i18n's are `{{name}}`, so they are
+ * converted. `policy: 'add'` lets the sync CLI write missing keys into each locale
+ * file with the default text.
+ */
+export declare function runtimeEntriesFromCatalog(catalog: Readonly<Record<string, string>>, options?: {
+    readonly policy?: 'add' | 'report';
+    readonly description?: string;
+}): RuntimeTranslationEntry[];
+//# sourceMappingURL=catalog.d.ts.map

package/lib/typescript/commonjs/config/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/config/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACzC,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACjF,uBAAuB,EAAE,CAO3B"}

package/lib/typescript/commonjs/config/diagnostics.d.ts

@@ -0,0 +1,21 @@
+/** What rn-i18n reports. Stable: an app may branch on these. */
+export type I18nDiagnosticCode = 'missing_translation' | 'fallback_used' | 'missing_variable' | 'invalid_value' | 'invalid_format' | 'locale_unsupported' | 'plural_rule_default' | 'locale_read_failed' | 'locale_write_failed' | 'listener_threw';
+export interface I18nDiagnostic {
+    readonly code: I18nDiagnosticCode;
+    /** For people: names the key, locale or variable involved. */
+    readonly message: string;
+    readonly key?: string;
+    readonly locale?: string;
+}
+export type I18nDiagnosticHandler = (diagnostic: I18nDiagnostic) => void;
+/**
+ * One place every diagnostic goes through (I18N-11): the app's SDK sinks always
+ * (`installSdkSink` from rn-core), then `onDiagnostic` when the app gave one,
+ * otherwise `console.warn` in development builds and tests only.
+ */
+export declare function createReporter(onDiagnostic?: I18nDiagnosticHandler): I18nDiagnosticHandler;
+/** For the few call sites that run before or outside an i18n instance. */
+export declare const defaultReporter: I18nDiagnosticHandler;
+/** Foreign error text, shaped before it reaches a message. */
+export declare function describeError(error: unknown): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/lib/typescript/commonjs/config/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/config/diagnostics.ts"],"names":[],"mappings":"AAMA,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAC3B,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,gBAAgB,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;AAiBzE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,qBAAqB,GAAG,qBAAqB,CAY1F;AAED,0EAA0E;AAC1E,eAAO,MAAM,eAAe,uBAAmB,CAAC;AAEhD,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/lib/typescript/commonjs/config/errors.d.ts

@@ -0,0 +1,16 @@
+import { SdkError } from '@chipmobilesdk/rn-core';
+/** The package's error codes. */
+export type I18nErrorCode = 'invalid_config' | 'unit_conversion';
+/**
+ * Configuration error listing every detected violation. An `SdkError`
+ * (`@chipmobilesdk/rn-core`) with `pkg: 'rn-i18n'`.
+ */
+export declare class I18nConfigError extends SdkError<I18nErrorCode> {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
+/** A unit conversion the package cannot perform, such as across dimensions. */
+export declare class UnitConversionError extends SdkError<I18nErrorCode> {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/commonjs/config/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/config/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEjE;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,aAAa,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEvB,MAAM,EAAE,SAAS,MAAM,EAAE;CAOrC;AAED,+EAA+E;AAC/E,qBAAa,mBAAoB,SAAQ,QAAQ,CAAC,aAAa,CAAC;gBACnD,OAAO,EAAE,MAAM;CAI3B"}

package/lib/typescript/commonjs/config/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Public configuration and contract types for @chipmobilesdk/rn-i18n.
+ *
+ * The package has one runtime dependency, rn-core; formatting uses the Intl APIs
+ * built into Hermes (Intl.NumberFormat, Intl.DateTimeFormat), while plural
+ * rules and unit conversion are package-owned because Intl.PluralRules and
+ * Intl unit-style formatting are not reliably available in Hermes.
+ */
+import type { I18nDiagnosticHandler } from './diagnostics';
+export type LocaleDirection = 'ltr' | 'rtl';
+export type PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
+export type PluralRule = (count: number) => PluralCategory;
+export type UnitDimension = 'length' | 'mass' | 'volume' | 'temperature';
+export type UnitId = 'millimeter' | 'centimeter' | 'meter' | 'kilometer' | 'inch' | 'foot' | 'mile' | 'gram' | 'kilogram' | 'ounce' | 'pound' | 'milliliter' | 'liter' | 'gallon' | 'celsius' | 'fahrenheit' | 'kelvin';
+export interface LocaleConfig {
+    /** BCP-47 language-region code, e.g. `vi-VN`, `en-US`, `ja-JP`. */
+    code: string;
+    displayName: string;
+    direction: LocaleDirection;
+    /**
+     * Ordered locale codes consulted when a key is missing from this locale.
+     * Every entry must be another supported locale; cycles, duplicates, and
+     * self-references are rejected during setup validation.
+     */
+    fallbackChain: string[];
+    /** ISO-4217 currency code used when no explicit currency is requested. */
+    defaultCurrency: string;
+    defaultUnit: UnitId;
+    /**
+     * Default Intl.DateTimeFormat options for this locale. Restricted to the
+     * component options supported by Hermes on both Android and iOS.
+     */
+    defaultDateFormat: Intl.DateTimeFormatOptions;
+    /** Default Intl.NumberFormat options for this locale. */
+    defaultNumberFormat: Intl.NumberFormatOptions;
+    /** Optional plural rule override; defaults to the built-in language rule. */
+    pluralRule?: PluralRule;
+}
+export type TranslationNode = string | {
+    [key: string]: TranslationNode;
+};
+export type TranslationNamespace = {
+    [key: string]: TranslationNode;
+};
+/** App-owned translation resources keyed by locale code. */
+export type TranslationResources = {
+    [localeCode: string]: TranslationNamespace;
+};
+/**
+ * A translation key intentionally resolved at runtime and therefore not
+ * discoverable by static source scanning. Declared entries are protected
+ * from removal during locale JSON synchronization.
+ */
+export interface RuntimeTranslationEntry {
+    key: string;
+    /** Template text used when no locale resource provides a value. */
+    defaultText: string;
+    /**
+     * Synchronization policy when the key is missing from a locale file:
+     * `add` writes the default text, `report` only lists it. Default: `report`.
+     */
+    policy?: 'add' | 'report';
+    /** Owning feature note surfaced in the extraction report. */
+    description?: string;
+}
+export type MissingTranslationPolicy = {
+    mode: 'key';
+} | {
+    mode: 'placeholder';
+    text: string;
+};
+export type InvalidFormatPolicy = {
+    mode: 'placeholder';
+    text: string;
+} | {
+    mode: 'error';
+};
+/** App-injected persistence contract. The package never bundles a backend. */
+export interface LocaleStorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    /**
+     * A synchronous read, for a store that has one (MMKV, rn-core's `KeyValuePort`).
+     * With it, `initSync()` resolves the locale before the first render, so the app
+     * never paints a frame in the wrong language (PERF-08).
+     */
+    getItemSync?(key: string): string | null;
+}
+/** Returns the device locale, or undefined when detection is unavailable. */
+export type DeviceLocaleProvider = () => string | undefined;
+export interface I18nConfig {
+    locales: LocaleConfig[];
+    /** Recovery locale when persistence or device detection cannot decide. */
+    primaryLocale: string;
+    resources: TranslationResources;
+    runtimeEntries?: RuntimeTranslationEntry[];
+    /** Persist the selected locale across launches. Default: true. */
+    persistLocale?: boolean;
+    /** Required when `persistLocale` is not disabled. */
+    storage?: LocaleStorageAdapter;
+    /**
+     * Receives every diagnostic: missing translations and variables, fallbacks,
+     * invalid formats, persistence failures. Defaults to `console.warn` in
+     * development builds only. Diagnostics also reach rn-core's SDK sinks.
+     */
+    onDiagnostic?: I18nDiagnosticHandler;
+    deviceLocale?: DeviceLocaleProvider;
+    /** Default: `{ mode: 'key' }`. */
+    missingTranslation?: MissingTranslationPolicy;
+    /** Default: `{ mode: 'placeholder', text: '—' }`. */
+    invalidFormat?: InvalidFormatPolicy;
+}
+export type LocaleSelectionSource = 'persisted' | 'device' | 'languageMatch' | 'primaryFallback' | 'runtimeSwitch';
+export interface ActiveLocalePreference {
+    code: string;
+    source: LocaleSelectionSource;
+    /** True when an unsupported persisted locale was discarded. */
+    recovered: boolean;
+}
+export type TranslateVars = Record<string, string | number>;
+export interface TranslateOptions {
+    /** Selects the plural variant and is exposed as the `count` variable. */
+    count?: number;
+}
+export { I18nConfigError } from './errors';
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/config/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/config/validateConfig.d.ts

@@ -0,0 +1,8 @@
+import type { I18nConfig } from './types';
+/**
+ * Validates an I18nConfig before any localized content is served (FR-003,
+ * FR-046). Collects every violation and throws a single I18nConfigError so
+ * apps see the complete picture instead of fixing issues one at a time.
+ */
+export declare function validateConfig(config: I18nConfig, knownUnits: ReadonlySet<string>): void;
+//# sourceMappingURL=validateConfig.d.ts.map

package/lib/typescript/commonjs/config/validateConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateConfig.d.ts","sourceRoot":"","sources":["../../../../src/config/validateConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAGxD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CA0DxF"}

package/lib/typescript/commonjs/format/currency.d.ts

@@ -0,0 +1,12 @@
+import type { InvalidFormatPolicy } from '../config/types';
+/**
+ * Locale-aware currency formatting. The locale's configured default currency
+ * applies unless the caller passes an explicit currency override (FR-021).
+ *
+ * `locale.defaultNumberFormat` is deliberately **not** applied here: a currency
+ * carries its own minor units (yen has none, dinar has three), and the locale's
+ * generic number options would override them — ¥1,234.56 instead of ¥1,235.
+ * Pass the options you want for a currency explicitly (I18N-09).
+ */
+export declare function formatCurrencyValue(value: number, localeCode: string, defaultCurrency: string, currencyOverride: string | undefined, options: Intl.NumberFormatOptions | undefined, invalidFormat: InvalidFormatPolicy): string;
+//# sourceMappingURL=currency.d.ts.map

package/lib/typescript/commonjs/format/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../../src/format/currency.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,OAAO,EAAE,IAAI,CAAC,mBAAmB,GAAG,SAAS,EAC7C,aAAa,EAAE,mBAAmB,GAChC,MAAM,CAkBR"}

package/lib/typescript/commonjs/format/date.d.ts

@@ -0,0 +1,14 @@
+import type { InvalidFormatPolicy } from '../config/types';
+/**
+ * Locale-aware date formatting through the Hermes built-in
+ * Intl.DateTimeFormat.
+ *
+ * Options are **merged** over the locale's configured default, the way
+ * `formatNumber` has always worked: `{ month: 'long' }` changes the month and
+ * keeps the year and day. Replacing the default wholesale, which this used to
+ * do, meant one option silently dropped every other component — and the two
+ * formatters disagreed about what an option meant (I18N-09). Pass
+ * `{ replaceDefaults: true }` for the old behaviour.
+ */
+export declare function formatDateValue(value: Date | number, localeCode: string, defaults: Intl.DateTimeFormatOptions, override: Intl.DateTimeFormatOptions | undefined, invalidFormat: InvalidFormatPolicy, replaceDefaults?: boolean): string;
+//# sourceMappingURL=date.d.ts.map

package/lib/typescript/commonjs/format/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../../src/format/date.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,IAAI,GAAG,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EACpC,QAAQ,EAAE,IAAI,CAAC,qBAAqB,GAAG,SAAS,EAChD,aAAa,EAAE,mBAAmB,EAClC,eAAe,UAAQ,GACrB,MAAM,CAeR"}

package/lib/typescript/commonjs/format/invalid.d.ts

@@ -0,0 +1,12 @@
+import { type I18nDiagnosticHandler } from '../config/diagnostics';
+import type { InvalidFormatPolicy } from '../config/types';
+/** The policy as an i18n instance resolves it: with the instance's reporter. */
+export type ResolvedInvalidFormatPolicy = InvalidFormatPolicy & {
+    readonly report?: I18nDiagnosticHandler | undefined;
+};
+/**
+ * Applies the configured invalid-format behavior: return the placeholder, or
+ * throw a clear formatting error in `error` mode (FR-037, FR-045).
+ */
+export declare function applyInvalidFormatPolicy(policy: ResolvedInvalidFormatPolicy, message: string): string;
+//# sourceMappingURL=invalid.d.ts.map

package/lib/typescript/commonjs/format/invalid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid.d.ts","sourceRoot":"","sources":["../../../../src/format/invalid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,gFAAgF;AAChF,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,GAAG;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACpD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,2BAA2B,EACnC,OAAO,EAAE,MAAM,GACb,MAAM,CAMR"}

package/lib/typescript/commonjs/format/number.d.ts

@@ -0,0 +1,8 @@
+import type { InvalidFormatPolicy } from '../config/types';
+/**
+ * Locale-aware number formatting through the Hermes built-in
+ * Intl.NumberFormat. The locale default options apply unless the caller
+ * passes explicit overrides (FR-019).
+ */
+export declare function formatNumberValue(value: number, localeCode: string, defaults: Intl.NumberFormatOptions, override: Intl.NumberFormatOptions | undefined, invalidFormat: InvalidFormatPolicy): string;
+//# sourceMappingURL=number.d.ts.map

package/lib/typescript/commonjs/format/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../../src/format/number.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAClC,QAAQ,EAAE,IAAI,CAAC,mBAAmB,GAAG,SAAS,EAC9C,aAAa,EAAE,mBAAmB,GAChC,MAAM,CAcR"}

package/lib/typescript/commonjs/format/units.d.ts

@@ -0,0 +1,23 @@
+import type { InvalidFormatPolicy, UnitId } from '../config/types';
+export declare const SUPPORTED_UNITS: readonly UnitId[];
+export declare const KNOWN_UNIT_IDS: ReadonlySet<string>;
+import { UnitConversionError } from '../config/errors';
+export { UnitConversionError };
+export declare function getUnitSymbol(unit: UnitId): string;
+/**
+ * Converts between compatible supported units. Unknown units or conversions
+ * across dimensions throw a UnitConversionError (FR-044/FR-045).
+ */
+export declare function convertUnitValue(value: number, from: UnitId, to: UnitId): number;
+export interface UnitFormatOptions extends Intl.NumberFormatOptions {
+    /** Unit the value is expressed in. Default: the locale's default unit. */
+    from?: UnitId;
+    /** Unit to display. Default: `from` (no conversion). */
+    to?: UnitId;
+}
+/**
+ * Converts (when requested) and formats a measurement value: locale-aware
+ * numeric part via Intl.NumberFormat plus the package-owned unit symbol.
+ */
+export declare function formatUnitValue(value: number, localeCode: string, localeDefaultUnit: UnitId, numberDefaults: Intl.NumberFormatOptions, options: UnitFormatOptions | undefined, invalidFormat: InvalidFormatPolicy): string;
+//# sourceMappingURL=units.d.ts.map

package/lib/typescript/commonjs/format/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../../src/format/units.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAqClF,eAAO,MAAM,eAAe,EAAiC,SAAS,MAAM,EAAE,CAAC;AAE/E,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAA4B,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAwBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAuBhF;AAED,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,mBAAmB;IAClE,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,IAAI,CAAC,mBAAmB,EACxC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,aAAa,EAAE,mBAAmB,GAChC,MAAM,CAmBR"}