inline-i18n-multi 0.5.0 → 0.7.0

package/README.md

@@ -63,6 +63,13 @@ See "Hello" in your app? Just search for "Hello" in your codebase. **Done.**
 - **Compact Number Formatting** - Short number display (`{count, number, compact}`)
 - **Rich Text Interpolation** - Embed React components in translations (`<link>text</link>`)
 - **Lazy Loading** - Async dictionary loading on demand (`loadAsync()`)
+- **Custom Formatter Registry** - Register custom ICU-style formatters (`registerFormatter('phone', fn)`)
+- **Interpolation Guards** - Handle missing variables gracefully (`missingVarHandler`)
+- **Locale Detection** - Auto-detect user locale from navigator, cookie, URL, or header (`detectLocale()`)
+- **Selectordinal** - Ordinal plural formatting (`{rank, selectordinal, one {#st} two {#nd} ...}`)
+- **ICU Message Cache** - Memoize parsed ICU ASTs for performance (`icuCacheSize`, `clearICUCache()`)
+- **Plural Shorthand** - Concise plural syntax (`{count, p, item|items}`)
+- **Locale Persistence** - Auto-save/restore locale to cookie or localStorage (`persistLocale`, `restoreLocale()`)
 
 ---
 
@@ -206,7 +213,10 @@ it({
 }, { price: 1234.56 })  // → "Price: 1,234.56"
 ```
 
-**Supported ICU styles:**
+**Supported ICU types:**
+- `plural`: `zero`, `one`, `two`, `few`, `many`, `other` (and exact matches like `=0`, `=1`)
+- `select`: match on string values
+- `selectordinal`: ordinal plural categories (`one`, `two`, `few`, `other`)
 - `number`: `decimal`, `percent`, `integer`, `currency`, `compact`, `compactLong`
 - `date`: `short`, `medium`, `long`, `full`
 - `time`: `short`, `medium`, `long`, `full`
@@ -370,6 +380,283 @@ function Dashboard() {
 
 ---
 
+## Custom Formatter Registry
+
+Register custom ICU-style formatters for domain-specific formatting:
+
+```typescript
+import { registerFormatter, clearFormatters, it, setLocale } from 'inline-i18n-multi'
+
+setLocale('en')
+
+// Register a phone number formatter
+registerFormatter('phone', (value, locale, style?) => {
+  const s = String(value)
+  if (locale === 'ko') return `${s.slice(0, 3)}-${s.slice(3, 7)}-${s.slice(7)}`
+  return `(${s.slice(0, 3)}) ${s.slice(3, 6)}-${s.slice(6)}`
+})
+
+// Use in translations
+it({
+  en: 'Call {num, phone}',
+  ko: '전화: {num, phone}'
+}, { num: '2125551234' })
+// → "Call (212) 555-1234"
+
+// Register a formatter with style support
+registerFormatter('mask', (value, locale, style?) => {
+  const s = String(value)
+  if (style === 'email') {
+    const [user, domain] = s.split('@')
+    return `${user[0]}***@${domain}`
+  }
+  return s.slice(0, 2) + '***' + s.slice(-2)
+})
+
+it({ en: 'Email: {email, mask, email}' }, { email: 'john@example.com' })
+// → "Email: j***@example.com"
+
+// Clear all custom formatters
+clearFormatters()
+```
+
+Reserved names (`plural`, `select`, `selectordinal`, `number`, `date`, `time`, `relativeTime`, `list`, `currency`) cannot be used as custom formatter names and will throw an error.
+
+---
+
+## Interpolation Guards
+
+Handle missing interpolation variables gracefully with a custom handler:
+
+```typescript
+import { configure, it, setLocale } from 'inline-i18n-multi'
+
+setLocale('en')
+
+// Configure a missing variable handler
+configure({
+  missingVarHandler: (varName, locale) => {
+    console.warn(`Missing variable "${varName}" for locale "${locale}"`)
+    return `[${varName}]`
+  }
+})
+
+// When a variable is missing, the handler is called instead of leaving {varName}
+it({ en: 'Hello, {name}!' })
+// logs: Missing variable "name" for locale "en"
+// → "Hello, [name]!"
+
+// Works with ICU patterns too
+it({ en: '{count, plural, one {# item} other {# items}}' })
+// logs: Missing variable "count" for locale "en"
+// → "{count}"
+
+// Without a handler, missing variables are left as-is: {varName}
+```
+
+---
+
+## Locale Detection
+
+Auto-detect the user's locale from multiple sources:
+
+```typescript
+import { detectLocale, setLocale } from 'inline-i18n-multi'
+
+// Basic detection from browser navigator
+const locale = detectLocale({
+  supportedLocales: ['en', 'ko', 'ja'],
+  defaultLocale: 'en',
+})
+setLocale(locale)
+
+// Multiple sources in priority order
+const detected = detectLocale({
+  supportedLocales: ['en', 'ko', 'ja'],
+  defaultLocale: 'en',
+  sources: ['cookie', 'url', 'navigator'],
+  cookieName: 'NEXT_LOCALE',  // default
+})
+
+// Server-side detection from Accept-Language header
+const ssrLocale = detectLocale({
+  supportedLocales: ['en', 'ko', 'ja'],
+  defaultLocale: 'en',
+  sources: ['header'],
+  headerValue: 'ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7',
+})
+// → "ko"
+
+// BCP 47 parent matching (en-US matches en)
+const matched = detectLocale({
+  supportedLocales: ['en', 'ko'],
+  defaultLocale: 'en',
+  sources: ['navigator'],
+})
+// Browser reports "en-US" → matches "en"
+```
+
+**Detection sources:**
+
+| Source | Description |
+|--------|-------------|
+| `navigator` | Browser `navigator.languages` / `navigator.language` |
+| `cookie` | Reads locale from `document.cookie` (configurable name) |
+| `url` | First path segment (e.g., `/ko/about` matches `ko`) |
+| `header` | Parses `Accept-Language` header value (for SSR) |
+
+Sources are tried in order; the first match wins. If no source matches, `defaultLocale` is returned.
+
+---
+
+## Selectordinal
+
+Ordinal plural formatting for ranking and ordering (e.g., 1st, 2nd, 3rd):
+
+```typescript
+import { it, setLocale } from 'inline-i18n-multi'
+
+setLocale('en')
+
+// Ordinal suffixes
+it({
+  en: '{rank, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}'
+}, { rank: 1 })   // → "1st"
+
+it({
+  en: '{rank, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}'
+}, { rank: 2 })   // → "2nd"
+
+it({
+  en: '{rank, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}'
+}, { rank: 3 })   // → "3rd"
+
+it({
+  en: '{rank, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}'
+}, { rank: 4 })   // → "4th"
+
+// Handles English irregulars correctly
+it({
+  en: '{rank, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}'
+}, { rank: 11 })  // → "11th" (not "11st")
+
+it({
+  en: '{rank, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}'
+}, { rank: 21 })  // → "21st"
+
+// Combined with text
+it({
+  en: 'You finished {rank, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} place!'
+}, { rank: 3 })   // → "You finished 3rd place!"
+```
+
+Uses `Intl.PluralRules` with `{ type: 'ordinal' }` for locale-aware ordinal categories.
+
+---
+
+## ICU Message Cache
+
+Memoize parsed ICU ASTs to avoid re-parsing the same message patterns:
+
+```typescript
+import { configure, clearICUCache } from 'inline-i18n-multi'
+
+// Enable caching (default: 500 entries)
+configure({ icuCacheSize: 500 })
+
+// Disable caching
+configure({ icuCacheSize: 0 })
+
+// Manually clear the cache
+clearICUCache()
+```
+
+The cache uses FIFO (First-In, First-Out) eviction when the maximum size is reached. Repeated calls to `it()` or `t()` with the same ICU pattern will reuse the cached AST instead of re-parsing.
+
+---
+
+## Plural Shorthand
+
+Concise syntax for common plural patterns using `p` as a short type name:
+
+```typescript
+import { it, setLocale } from 'inline-i18n-multi'
+
+setLocale('en')
+
+// 2-part: singular|plural (value is prepended automatically)
+it({
+  en: '{count, p, item|items}',
+  ko: '{count, p, 개|개}'
+}, { count: 1 })   // → "1 item"
+
+it({
+  en: '{count, p, item|items}',
+  ko: '{count, p, 개|개}'
+}, { count: 5 })   // → "5 items"
+
+// 3-part: zero|singular|plural
+it({
+  en: '{count, p, no items|item|items}',
+  ko: '{count, p, 항목 없음|개|개}'
+}, { count: 0 })   // → "no items"
+
+it({
+  en: '{count, p, no items|item|items}',
+  ko: '{count, p, 항목 없음|개|개}'
+}, { count: 1 })   // → "1 item"
+
+it({
+  en: '{count, p, no items|item|items}',
+  ko: '{count, p, 항목 없음|개|개}'
+}, { count: 5 })   // → "5 items"
+```
+
+The shorthand is preprocessed into standard ICU `plural` syntax before parsing.
+
+---
+
+## Locale Persistence
+
+Auto-save and restore the user's locale to `cookie` or `localStorage`:
+
+```typescript
+import { configure, setLocale, restoreLocale } from 'inline-i18n-multi'
+
+// Configure persistence
+configure({
+  persistLocale: {
+    storage: 'cookie',         // 'cookie' | 'localStorage'
+    key: 'LOCALE',             // storage key (default: 'LOCALE')
+    expires: 365               // cookie expiry in days (default: 365)
+  }
+})
+
+// Restore locale from storage (returns the saved locale or undefined)
+const saved = restoreLocale()
+if (saved) {
+  // locale was restored from storage
+}
+
+// setLocale() automatically saves to the configured storage
+setLocale('ko')  // also saves 'ko' to cookie or localStorage
+```
+
+```typescript
+// localStorage example
+configure({
+  persistLocale: {
+    storage: 'localStorage',
+    key: 'APP_LOCALE'
+  }
+})
+
+restoreLocale()   // reads from localStorage
+setLocale('ja')   // saves 'ja' to localStorage
+```
+
+---
+
 ## Configuration
 
 Configure global settings for fallback behavior and warnings:
@@ -455,12 +742,27 @@ Available helpers:
 
 | Function | Description |
 |----------|-------------|
-| `configure(options)` | Configure global settings (fallback, warnings, debug) |
+| `configure(options)` | Configure global settings (fallback, warnings, debug, missingVarHandler, icuCacheSize, persistLocale) |
 | `getConfig()` | Get current configuration |
 | `resetConfig()` | Reset configuration to defaults |
 | `loadAsync(locale, namespace?)` | Asynchronously load dictionary using configured loader |
 | `isLoaded(locale, namespace?)` | Check if dictionary has been loaded |
 | `parseRichText(template, names)` | Parse rich text template into segments |
+| `clearICUCache()` | Clear the ICU message AST cache |
+| `restoreLocale()` | Restore locale from configured persistent storage (cookie or localStorage) |
+
+### Custom Formatters
+
+| Function | Description |
+|----------|-------------|
+| `registerFormatter(name, formatter)` | Register a custom ICU-style formatter |
+| `clearFormatters()` | Clear all custom formatters |
+
+### Locale Detection
+
+| Function | Description |
+|----------|-------------|
+| `detectLocale(options)` | Auto-detect user's locale from multiple sources |
 
 ### React Hooks & Components
 
@@ -486,6 +788,18 @@ interface Config {
   onMissingTranslation?: WarningHandler
   debugMode?: boolean | DebugModeOptions
   loader?: (locale: Locale, namespace: string) => Promise<Record<string, unknown>>
+  missingVarHandler?: (varName: string, locale: string) => string
+  icuCacheSize?: number
+  persistLocale?: PersistLocaleOptions
+}
+
+interface PersistLocaleOptions {
+  /** Storage backend */
+  storage: 'cookie' | 'localStorage'
+  /** Storage key (default: 'LOCALE') */
+  key?: string
+  /** Cookie expiry in days (default: 365, cookie only) */
+  expires?: number
 }
 
 interface DebugModeOptions {
@@ -505,6 +819,23 @@ interface TranslationWarning {
 
 type WarningHandler = (warning: TranslationWarning) => void
 
+type CustomFormatter = (value: unknown, locale: string, style?: string) => string
+
+type DetectSource = 'navigator' | 'cookie' | 'url' | 'header'
+
+interface DetectLocaleOptions {
+  /** Locales your app supports */
+  supportedLocales: Locale[]
+  /** Fallback when no source matches */
+  defaultLocale: Locale
+  /** Detection sources in priority order (default: ['navigator']) */
+  sources?: DetectSource[]
+  /** Cookie name to read (default: 'NEXT_LOCALE') */
+  cookieName?: string
+  /** Accept-Language header value (for SSR) */
+  headerValue?: string
+}
+
 interface RichTextSegment {
   type: 'text' | 'component'
   content: string
@@ -564,30 +895,6 @@ npm install inline-i18n-multi-next
 
 ---
 
-## Build-Time Optimization
-
-### Babel Plugin
-
-Transform `it()` calls at build time for better performance. Extracts translations for static analysis and enables dead code elimination for unused locales.
-
-```bash
-npm install -D @inline-i18n-multi/babel-plugin
-```
-
-[View Babel plugin →](https://www.npmjs.com/package/@inline-i18n-multi/babel-plugin)
-
-### SWC Plugin
-
-SWC plugin for Next.js 13+ projects. Faster than Babel with the same optimization benefits. Configure in `next.config.js` under `experimental.swcPlugins`.
-
-```bash
-npm install -D @inline-i18n-multi/swc-plugin
-```
-
-[View SWC plugin →](https://www.npmjs.com/package/@inline-i18n-multi/swc-plugin)
-
----
-
 ## Developer Tools
 
 ### CLI
@@ -614,7 +921,6 @@ npm install -D @inline-i18n-multi/cli
 **Please read the [full documentation on GitHub](https://github.com/exiivy98/inline-i18n-multi)** for:
 - Complete API reference
 - Framework integrations (React, Next.js)
-- Build-time optimization
 - CLI tools
 - Best practices and examples
 

package/dist/index.d.mts

@@ -63,6 +63,19 @@ interface Config {
     debugMode?: boolean | DebugModeOptions;
     /** Async loader function for lazy loading dictionaries */
     loader?: (locale: Locale, namespace: string) => Promise<Record<string, unknown>>;
+    /** Custom handler for missing interpolation variables (v0.6.0) */
+    missingVarHandler?: (varName: string, locale: string) => string;
+    /** Maximum number of parsed ICU ASTs to cache (default: 500, 0 to disable) (v0.7.0) */
+    icuCacheSize?: number;
+    /** Locale persistence configuration (v0.7.0) */
+    persistLocale?: {
+        /** Storage mechanism */
+        storage: 'cookie' | 'localStorage';
+        /** Storage key name (default: 'LOCALE') */
+        key?: string;
+        /** Cookie expiry in days (default: 365). Only applies to cookie storage. */
+        expires?: number;
+    };
 }
 
 /**
@@ -81,12 +94,16 @@ declare function it(translations: Translations, vars?: TranslationVars): string;
 
 declare function setLocale(locale: Locale): void;
 declare function getLocale(): Locale;
+/**
+ * Restore locale from configured persistent storage.
+ * Returns the restored locale, or undefined if nothing was found.
+ */
+declare function restoreLocale(): Locale | undefined;
 
 /**
- * Runtime lookup function for plugin-transformed code.
- * This is called by code that has been processed by @inline-i18n-multi/babel-plugin
- * or @inline-i18n-multi/swc-plugin.
+ * Runtime lookup function for build-tool-transformed code.
  *
+ * @deprecated Will be removed in v1.0.0
  * @param _hash - Content hash (for caching/debugging, unused at runtime)
  * @param translations - Translation map with locale keys
  * @param vars - Variables for interpolation
@@ -211,7 +228,7 @@ declare function getDictionary(locale: Locale, namespace?: string): Dictionary |
  */
 declare function getLoadedNamespaces(): string[];
 
-type FullConfig = Required<Omit<Config, 'loader'>> & Pick<Config, 'loader'>;
+type FullConfig = Required<Omit<Config, 'loader' | 'missingVarHandler' | 'persistLocale'>> & Pick<Config, 'loader' | 'missingVarHandler' | 'persistLocale'>;
 /**
  * Configure inline-i18n-multi settings
  *
@@ -232,6 +249,52 @@ declare function getConfig(): FullConfig;
  */
 declare function resetConfig(): void;
 
+/**
+ * Clear the ICU message AST cache
+ */
+declare function clearICUCache(): void;
+type CustomFormatter = (value: unknown, locale: string, style?: string) => string;
+/**
+ * Register a custom formatter
+ *
+ * @example
+ * registerFormatter('phone', (value, locale, style?) => {
+ *   const s = String(value)
+ *   return `(${s.slice(0,3)}) ${s.slice(3,6)}-${s.slice(6)}`
+ * })
+ */
+declare function registerFormatter(name: string, formatter: CustomFormatter): void;
+/**
+ * Clear all custom formatters
+ */
+declare function clearFormatters(): void;
+
+type DetectSource = 'navigator' | 'cookie' | 'url' | 'header';
+interface DetectLocaleOptions {
+    /** Locales your app supports */
+    supportedLocales: Locale[];
+    /** Fallback when no source matches */
+    defaultLocale: Locale;
+    /** Detection sources in priority order (default: ['navigator']) */
+    sources?: DetectSource[];
+    /** Cookie name to read (default: 'NEXT_LOCALE') */
+    cookieName?: string;
+    /** Accept-Language header value (for SSR) */
+    headerValue?: string;
+}
+/**
+ * Auto-detect the user's locale from multiple sources
+ *
+ * @example
+ * const locale = detectLocale({
+ *   supportedLocales: ['en', 'ko', 'ja'],
+ *   defaultLocale: 'en',
+ *   sources: ['cookie', 'navigator'],
+ *   cookieName: 'NEXT_LOCALE',
+ * })
+ */
+declare function detectLocale(options: DetectLocaleOptions): Locale;
+
 /**
  * Rich Text segment types
  */
@@ -260,4 +323,4 @@ interface RichTextSegment {
  */
 declare function parseRichText(template: string, componentNames: string[]): RichTextSegment[];
 
-export { type Config, type DebugModeOptions, type Dictionaries, type Dictionary, type Locale, type PluralRules, type RichTextSegment, type TranslationVars, type TranslationWarning, type Translations, type WarningHandler, __i18n_lookup, clearDictionaries, configure, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, resetConfig, setLocale, t, zh_es };
+export { type Config, type CustomFormatter, type DebugModeOptions, type DetectLocaleOptions, type DetectSource, type Dictionaries, type Dictionary, type Locale, type PluralRules, type RichTextSegment, type TranslationVars, type TranslationWarning, type Translations, type WarningHandler, __i18n_lookup, clearDictionaries, clearFormatters, clearICUCache, configure, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, resetConfig, restoreLocale, setLocale, t, zh_es };

package/dist/index.d.ts

@@ -63,6 +63,19 @@ interface Config {
     debugMode?: boolean | DebugModeOptions;
     /** Async loader function for lazy loading dictionaries */
     loader?: (locale: Locale, namespace: string) => Promise<Record<string, unknown>>;
+    /** Custom handler for missing interpolation variables (v0.6.0) */
+    missingVarHandler?: (varName: string, locale: string) => string;
+    /** Maximum number of parsed ICU ASTs to cache (default: 500, 0 to disable) (v0.7.0) */
+    icuCacheSize?: number;
+    /** Locale persistence configuration (v0.7.0) */
+    persistLocale?: {
+        /** Storage mechanism */
+        storage: 'cookie' | 'localStorage';
+        /** Storage key name (default: 'LOCALE') */
+        key?: string;
+        /** Cookie expiry in days (default: 365). Only applies to cookie storage. */
+        expires?: number;
+    };
 }
 
 /**
@@ -81,12 +94,16 @@ declare function it(translations: Translations, vars?: TranslationVars): string;
 
 declare function setLocale(locale: Locale): void;
 declare function getLocale(): Locale;
+/**
+ * Restore locale from configured persistent storage.
+ * Returns the restored locale, or undefined if nothing was found.
+ */
+declare function restoreLocale(): Locale | undefined;
 
 /**
- * Runtime lookup function for plugin-transformed code.
- * This is called by code that has been processed by @inline-i18n-multi/babel-plugin
- * or @inline-i18n-multi/swc-plugin.
+ * Runtime lookup function for build-tool-transformed code.
  *
+ * @deprecated Will be removed in v1.0.0
  * @param _hash - Content hash (for caching/debugging, unused at runtime)
  * @param translations - Translation map with locale keys
  * @param vars - Variables for interpolation
@@ -211,7 +228,7 @@ declare function getDictionary(locale: Locale, namespace?: string): Dictionary |
  */
 declare function getLoadedNamespaces(): string[];
 
-type FullConfig = Required<Omit<Config, 'loader'>> & Pick<Config, 'loader'>;
+type FullConfig = Required<Omit<Config, 'loader' | 'missingVarHandler' | 'persistLocale'>> & Pick<Config, 'loader' | 'missingVarHandler' | 'persistLocale'>;
 /**
  * Configure inline-i18n-multi settings
  *
@@ -232,6 +249,52 @@ declare function getConfig(): FullConfig;
  */
 declare function resetConfig(): void;
 
+/**
+ * Clear the ICU message AST cache
+ */
+declare function clearICUCache(): void;
+type CustomFormatter = (value: unknown, locale: string, style?: string) => string;
+/**
+ * Register a custom formatter
+ *
+ * @example
+ * registerFormatter('phone', (value, locale, style?) => {
+ *   const s = String(value)
+ *   return `(${s.slice(0,3)}) ${s.slice(3,6)}-${s.slice(6)}`
+ * })
+ */
+declare function registerFormatter(name: string, formatter: CustomFormatter): void;
+/**
+ * Clear all custom formatters
+ */
+declare function clearFormatters(): void;
+
+type DetectSource = 'navigator' | 'cookie' | 'url' | 'header';
+interface DetectLocaleOptions {
+    /** Locales your app supports */
+    supportedLocales: Locale[];
+    /** Fallback when no source matches */
+    defaultLocale: Locale;
+    /** Detection sources in priority order (default: ['navigator']) */
+    sources?: DetectSource[];
+    /** Cookie name to read (default: 'NEXT_LOCALE') */
+    cookieName?: string;
+    /** Accept-Language header value (for SSR) */
+    headerValue?: string;
+}
+/**
+ * Auto-detect the user's locale from multiple sources
+ *
+ * @example
+ * const locale = detectLocale({
+ *   supportedLocales: ['en', 'ko', 'ja'],
+ *   defaultLocale: 'en',
+ *   sources: ['cookie', 'navigator'],
+ *   cookieName: 'NEXT_LOCALE',
+ * })
+ */
+declare function detectLocale(options: DetectLocaleOptions): Locale;
+
 /**
  * Rich Text segment types
  */
@@ -260,4 +323,4 @@ interface RichTextSegment {
  */
 declare function parseRichText(template: string, componentNames: string[]): RichTextSegment[];
 
-export { type Config, type DebugModeOptions, type Dictionaries, type Dictionary, type Locale, type PluralRules, type RichTextSegment, type TranslationVars, type TranslationWarning, type Translations, type WarningHandler, __i18n_lookup, clearDictionaries, configure, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, resetConfig, setLocale, t, zh_es };
+export { type Config, type CustomFormatter, type DebugModeOptions, type DetectLocaleOptions, type DetectSource, type Dictionaries, type Dictionary, type Locale, type PluralRules, type RichTextSegment, type TranslationVars, type TranslationWarning, type Translations, type WarningHandler, __i18n_lookup, clearDictionaries, clearFormatters, clearICUCache, configure, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, resetConfig, restoreLocale, setLocale, t, zh_es };