@chipmobilesdk/rn-i18n 0.2.0 → 0.4.0

package/lib/typescript/commonjs/i18n.d.ts

@@ -0,0 +1,46 @@
+import type { ActiveLocalePreference, I18nConfig, LocaleConfig, RuntimeTranslationEntry, TranslateOptions, TranslateVars, UnitId } from './config/types';
+import type { UnitFormatOptions } from './format/units';
+export interface I18n<TKey extends string = string> {
+    /** Resolves the initial locale: persisted → device → primary fallback. */
+    init(): Promise<void>;
+    /**
+     * `init()` without waiting, before the first render (PERF-08). Resolves the locale
+     * and returns true when it can do so synchronously: persistence is off, or the
+     * storage adapter has `getItemSync`. Returns false, changing nothing, when the
+     * adapter can only read asynchronously; call `init()` then.
+     */
+    initSync(): boolean;
+    t(key: TKey, vars?: TranslateVars, options?: TranslateOptions): string;
+    getLocale(): ActiveLocalePreference;
+    /** Switches at runtime without restart and persists best-effort. */
+    setLocale(code: string): Promise<void>;
+    /**
+     * Forgets the stored choice and follows the device again — the "System
+     * language" option a settings screen offers (I18N-17). Resolves to the
+     * locale now active.
+     */
+    useDeviceLocale(): Promise<ActiveLocalePreference>;
+    getSupportedLocales(): readonly LocaleConfig[];
+    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Options are merged over the locale's default (`{ month: 'long' }` keeps the
+     * year and day). `replaceDefaults` uses only what is passed.
+     */
+    formatDate(value: Date | number, options?: Intl.DateTimeFormatOptions, formatting?: {
+        replaceDefaults?: boolean;
+    }): string;
+    formatCurrency(value: number, currency?: string, options?: Intl.NumberFormatOptions): string;
+    formatUnit(value: number, options?: UnitFormatOptions): string;
+    convertUnit(value: number, from: UnitId, to: UnitId): number;
+    registerRuntimeEntries(entries: readonly RuntimeTranslationEntry[]): void;
+    subscribe(listener: () => void): () => void;
+    getVersion(): number;
+}
+/**
+ * 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 declare function createI18n<TKey extends string = string>(config: I18nConfig): I18n<TKey>;
+//# sourceMappingURL=i18n.d.ts.map

package/lib/typescript/commonjs/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/i18n.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,sBAAsB,EACtB,UAAU,EAEV,YAAY,EAEZ,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,MAAM,EACN,MAAM,gBAAgB,CAAC;AAkBxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,IAAI,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IACjD,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,IAAI,OAAO,CAAC;IACpB,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACvE,SAAS,IAAI,sBAAsB,CAAC;IACpC,oEAAoE;IACpE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,eAAe,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnD,mBAAmB,IAAI,SAAS,YAAY,EAAE,CAAC;IAC/C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC;IACxE;;;OAGG;IACH,UAAU,CACT,KAAK,EAAE,IAAI,GAAG,MAAM,EACpB,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EACpC,UAAU,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACxC,MAAM,CAAC;IACV,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC;IAC7F,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAC/D,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7D,sBAAsB,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,GAAG,IAAI,CAAC;IAC1E,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,UAAU,IAAI,MAAM,CAAC;CACrB;AAKD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CA0OvF"}

package/lib/typescript/commonjs/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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';
+export type { I18n } from './i18n';
+export { I18nConfigError } from './config/types';
+export { runtimeEntriesFromCatalog } from './config/catalog';
+export { localeStorageFromKeyValue } from './locale/keyValueStorage';
+export type { I18nErrorCode } from './config/errors';
+export type { I18nDiagnostic, I18nDiagnosticCode, I18nDiagnosticHandler, } from './config/diagnostics';
+export type { ActiveLocalePreference, DeviceLocaleProvider, I18nConfig, InvalidFormatPolicy, LocaleConfig, LocaleDirection, LocaleSelectionSource, LocaleStorageAdapter, MissingTranslationPolicy, PluralCategory, PluralRule, RuntimeTranslationEntry, TranslateOptions, TranslateVars, TranslationNamespace, TranslationNode, TranslationResources, UnitDimension, UnitId, } from './config/types';
+export { LOCALE_STORAGE_KEY } from './locale/persistence';
+export { defaultDeviceLocaleProvider } from './locale/deviceLocale';
+export { SUPPORTED_UNITS, UnitConversionError, convertUnitValue as convertUnit, getUnitSymbol, } from './format/units';
+export type { UnitFormatOptions } from './format/units';
+export { I18nProvider } from './react/I18nProvider';
+export type { I18nProviderProps } from './react/I18nProvider';
+export { useLocale, useTranslation } from './react/hooks';
+export type { UseLocaleResult, UseTranslationResult } from './react/hooks';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACX,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,UAAU,EACV,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,MAAM,GACN,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,gBAAgB,IAAI,WAAW,EAC/B,aAAa,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/commonjs/locale/activeLocale.d.ts

@@ -0,0 +1,17 @@
+import { type I18nDiagnosticHandler } from '../config/diagnostics';
+import type { ActiveLocalePreference } from '../config/types';
+export interface ActiveLocaleStore {
+    get(): ActiveLocalePreference;
+    set(preference: ActiveLocalePreference): void;
+    subscribe(listener: () => void): () => void;
+    /**
+     * Notifies subscribers without changing the locale: what reaches the screen
+     * changed, not which language it is in (a runtime entry registered by a
+     * lazily loaded feature, say).
+     */
+    bump(): void;
+    /** Monotonic change counter consumed by useSyncExternalStore. */
+    getVersion(): number;
+}
+export declare function createActiveLocaleStore(initial: ActiveLocalePreference, report?: I18nDiagnosticHandler): ActiveLocaleStore;
+//# sourceMappingURL=activeLocale.d.ts.map

package/lib/typescript/commonjs/locale/activeLocale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeLocale.d.ts","sourceRoot":"","sources":["../../../../src/locale/activeLocale.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkC,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IACjC,GAAG,IAAI,sBAAsB,CAAC;IAC9B,GAAG,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C;;;;OAIG;IACH,IAAI,IAAI,IAAI,CAAC;IACb,iEAAiE;IACjE,UAAU,IAAI,MAAM,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,qBAAuC,GAC7C,iBAAiB,CA6BnB"}

package/lib/typescript/commonjs/locale/deviceLocale.d.ts

@@ -0,0 +1,19 @@
+import type { DeviceLocaleProvider, LocaleConfig, LocaleSelectionSource } from '../config/types';
+/**
+ * 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 declare const defaultDeviceLocaleProvider: DeviceLocaleProvider;
+export interface DeviceLocaleMatch {
+    code: string;
+    source: Extract<LocaleSelectionSource, 'device' | 'languageMatch'>;
+}
+/**
+ * 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 declare function matchSupportedLocale(deviceLocale: string | undefined, locales: readonly LocaleConfig[]): DeviceLocaleMatch | undefined;
+//# sourceMappingURL=deviceLocale.d.ts.map

package/lib/typescript/commonjs/locale/deviceLocale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceLocale.d.ts","sourceRoot":"","sources":["../../../../src/locale/deviceLocale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEjG;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,oBAMzC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC,qBAAqB,EAAE,QAAQ,GAAG,eAAe,CAAC,CAAC;CACnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,SAAS,YAAY,EAAE,GAC9B,iBAAiB,GAAG,SAAS,CAoB/B"}

package/lib/typescript/commonjs/locale/keyValueStorage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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' }))`.
+ */
+import type { KeyValuePort } from '@chipmobilesdk/rn-core';
+import type { LocaleStorageAdapter } from '../config/types';
+export declare function localeStorageFromKeyValue(port: KeyValuePort): LocaleStorageAdapter & {
+    getItemSync(key: string): string | null;
+};
+//# sourceMappingURL=keyValueStorage.d.ts.map

package/lib/typescript/commonjs/locale/keyValueStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyValueStorage.d.ts","sourceRoot":"","sources":["../../../../src/locale/keyValueStorage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,YAAY,GAChB,oBAAoB,GAAG;IAAE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,CAapE"}

package/lib/typescript/commonjs/locale/persistence.d.ts

@@ -0,0 +1,24 @@
+import { type I18nDiagnosticHandler } from '../config/diagnostics';
+import type { LocaleStorageAdapter } from '../config/types';
+export declare 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 declare function readPersistedLocale(storage: LocaleStorageAdapter, report?: I18nDiagnosticHandler): Promise<string | null>;
+/** `readPersistedLocale` for a store with a synchronous read; same failure handling. */
+export declare function readPersistedLocaleSync(storage: LocaleStorageAdapter & {
+    getItemSync(key: string): string | null;
+}, report?: I18nDiagnosticHandler): string | null;
+/**
+ * Persists the selected locale. Persistence is best-effort: a write failure
+ * is reported but the in-memory locale switch stays authoritative.
+ */
+export declare function writePersistedLocale(storage: LocaleStorageAdapter, code: string, report?: I18nDiagnosticHandler): Promise<void>;
+/**
+ * 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 declare function clearPersistedLocale(storage: LocaleStorageAdapter, report?: I18nDiagnosticHandler): Promise<void>;
+//# sourceMappingURL=persistence.d.ts.map

package/lib/typescript/commonjs/locale/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../../src/locale/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,eAAO,MAAM,kBAAkB,kCAAkC,CAAC;AAElE;;;GAGG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,GAAE,qBAAuC,GAC7C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,oBAAoB,GAAG;IAAE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,EAC3E,MAAM,GAAE,qBAAuC,GAC7C,MAAM,GAAG,IAAI,CAUf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,qBAAuC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,GAAE,qBAAuC,GAC7C,OAAO,CAAC,IAAI,CAAC,CASf"}

package/lib/typescript/commonjs/package.json

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

package/lib/typescript/commonjs/react/I18nProvider.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { I18n } from '../i18n';
+export declare const I18nContext: React.Context<I18n<string> | null>;
+export interface I18nProviderProps {
+    i18n: I18n<never>;
+    children: ReactNode;
+}
+/**
+ * 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 declare function I18nProvider({ i18n, children }: I18nProviderProps): React.JSX.Element;
+export declare function useI18nContext(): I18n<string>;
+//# sourceMappingURL=I18nProvider.d.ts.map

package/lib/typescript/commonjs/react/I18nProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/I18nProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAIpC,eAAO,MAAM,WAAW,oCAA2C,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,iBAAiB,qBAIjE;AAED,wBAAgB,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC,CAM7C"}

package/lib/typescript/commonjs/react/hooks.d.ts

@@ -0,0 +1,21 @@
+import type { ActiveLocalePreference, LocaleConfig, LocaleDirection, TranslateOptions, TranslateVars } from '../config/types';
+export interface UseTranslationResult<TKey extends string> {
+    t: (key: TKey, vars?: TranslateVars, options?: TranslateOptions) => string;
+    locale: string;
+}
+/**
+ * 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 declare function useTranslation<TKey extends string = string>(): UseTranslationResult<TKey>;
+export interface UseLocaleResult {
+    locale: string;
+    direction: LocaleDirection;
+    preference: ActiveLocalePreference;
+    supportedLocales: readonly LocaleConfig[];
+    setLocale: (code: string) => Promise<void>;
+}
+/** Returns active locale state, direction metadata, and the locale switcher. */
+export declare function useLocale(): UseLocaleResult;
+//# sourceMappingURL=hooks.d.ts.map

package/lib/typescript/commonjs/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,MAAM,iBAAiB,CAAC;AAQzB,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,MAAM;IACxD,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,KAAK,oBAAoB,CAAC,IAAI,CAAC,CAezF;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,eAAe,CAAC;IAC3B,UAAU,EAAE,sBAAsB,CAAC;IACnC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,gFAAgF;AAChF,wBAAgB,SAAS,IAAI,eAAe,CAc3C"}

package/lib/typescript/commonjs/translation/interpolate.d.ts

@@ -0,0 +1,8 @@
+import type { TranslateVars } from '../config/types';
+/**
+ * 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 declare function interpolate(text: string, vars?: TranslateVars, onMissingVariable?: (name: string) => void): string;
+//# sourceMappingURL=interpolate.d.ts.map

package/lib/typescript/commonjs/translation/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../../../src/translation/interpolate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,aAAa,EACpB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACxC,MAAM,CASR"}

package/lib/typescript/commonjs/translation/plurals.d.ts

@@ -0,0 +1,13 @@
+import type { LocaleConfig, PluralCategory, PluralRule, TranslationNode } from '../config/types';
+export declare const PLURAL_CATEGORIES: readonly PluralCategory[];
+export declare const DEFAULT_PLURAL_RULE: PluralRule;
+/** True when this package has a rule for the language, or the locale brought one. */
+export declare function hasPluralRule(locale: LocaleConfig): boolean;
+export declare function resolvePluralRule(locale: LocaleConfig): PluralRule;
+/**
+ * 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 declare function isPluralGroup(node: TranslationNode): node is Record<string, string>;
+export declare function selectPluralVariant(group: Record<string, string>, category: PluralCategory): string;
+//# sourceMappingURL=plurals.d.ts.map

package/lib/typescript/commonjs/translation/plurals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plurals.d.ts","sourceRoot":"","sources":["../../../../src/translation/plurals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEjG,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAOtD,CAAC;AA8EF,eAAO,MAAM,mBAAmB,EAAE,UAAyB,CAAC;AAE5D,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAM3D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAMlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAanF;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,QAAQ,EAAE,cAAc,GACtB,MAAM,CAER"}

package/lib/typescript/commonjs/translation/resolver.d.ts

@@ -0,0 +1,24 @@
+import type { I18nDiagnostic, I18nDiagnosticHandler } from '../config/diagnostics';
+import type { LocaleConfig, MissingTranslationPolicy, TranslateOptions, TranslateVars, TranslationNamespace, TranslationNode, TranslationResources } from '../config/types';
+import type { RuntimeEntryRegistry } from './runtimeKeys';
+export interface ResolverContext {
+    localesByCode: ReadonlyMap<string, LocaleConfig>;
+    resources: TranslationResources;
+    runtimeEntries: RuntimeEntryRegistry;
+    missingTranslation: MissingTranslationPolicy;
+    /** Dedupe set so each failed lookup path warns exactly once. */
+    warned: Set<string>;
+    report: I18nDiagnosticHandler;
+}
+export declare function warnOnce(context: Pick<ResolverContext, 'warned' | 'report'>, dedupeKey: string, diagnostic: I18nDiagnostic): void;
+/** Walks a dot-path key through a nested translation namespace. */
+export declare function getTranslationNode(namespace: TranslationNamespace | undefined, key: string): TranslationNode | 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 declare function translate(context: ResolverContext, activeCode: string, key: string, vars?: TranslateVars, options?: TranslateOptions): string;
+//# sourceMappingURL=resolver.d.ts.map

package/lib/typescript/commonjs/translation/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/translation/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EACX,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,SAAS,EAAE,oBAAoB,CAAC;IAChC,cAAc,EAAE,oBAAoB,CAAC;IACrC,kBAAkB,EAAE,wBAAwB,CAAC;IAC7C,gEAAgE;IAChE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,MAAM,EAAE,qBAAqB,CAAC;CAC9B;AAQD,wBAAgB,QAAQ,CACvB,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,QAAQ,CAAC,EACnD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,cAAc,GACxB,IAAI,CAWN;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,GAAG,EAAE,MAAM,GACT,eAAe,GAAG,SAAS,CAgB7B;AA4BD;;;;;;GAMG;AACH,wBAAgB,SAAS,CACxB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAoDR"}

package/lib/typescript/commonjs/translation/runtimeKeys.d.ts

@@ -0,0 +1,16 @@
+import { type RuntimeTranslationEntry } from '../config/types';
+/**
+ * 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 type RuntimeEntryRegistry = Map<string, RuntimeTranslationEntry>;
+export declare function createRuntimeRegistry(entries?: readonly RuntimeTranslationEntry[]): RuntimeEntryRegistry;
+/**
+ * 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 declare function validateRuntimeEntries(entries: readonly RuntimeTranslationEntry[]): void;
+export declare function registerRuntimeEntries(registry: RuntimeEntryRegistry, entries: readonly RuntimeTranslationEntry[]): void;
+//# sourceMappingURL=runtimeKeys.d.ts.map

package/lib/typescript/commonjs/translation/runtimeKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeKeys.d.ts","sourceRoot":"","sources":["../../../../src/translation/runtimeKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAExE,wBAAgB,qBAAqB,CACpC,OAAO,CAAC,EAAE,SAAS,uBAAuB,EAAE,GAC1C,oBAAoB,CAMtB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,GAAG,IAAI,CAmBxF;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,SAAS,uBAAuB,EAAE,GACzC,IAAI,CAKN"}

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

@@ -0,0 +1,18 @@
+import type { RuntimeTranslationEntry } from './types.js';
+/**
+ * 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/module/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,YAAS,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/module/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/module/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/module/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/module/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/module/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.js';
+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.js';
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/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/module/config/validateConfig.d.ts

@@ -0,0 +1,8 @@
+import type { I18nConfig } from './types.js';
+/**
+ * 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/module/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,YAAS,CAAC;AAGxD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CA0DxF"}

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

@@ -0,0 +1,12 @@
+import type { InvalidFormatPolicy } from '../config/types.js';
+/**
+ * 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/module/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,oBAAiB,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/module/format/date.d.ts

@@ -0,0 +1,14 @@
+import type { InvalidFormatPolicy } from '../config/types.js';
+/**
+ * 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/module/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,oBAAiB,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/module/format/invalid.d.ts

@@ -0,0 +1,12 @@
+import { type I18nDiagnosticHandler } from '../config/diagnostics.js';
+import type { InvalidFormatPolicy } from '../config/types.js';
+/** 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/module/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,0BAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAiB,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/module/format/number.d.ts

@@ -0,0 +1,8 @@
+import type { InvalidFormatPolicy } from '../config/types.js';
+/**
+ * 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/module/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,oBAAiB,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"}