inline-i18n-multi 0.11.0 → 0.12.0

package/README.md

@@ -82,6 +82,7 @@ See "Hello" in your app? Just search for "Hello" in your codebase. **Done.**
 - **Locale Display Names** - Get human-readable locale names using `Intl.DisplayNames` (`getLocaleDisplayName('ko', 'en')` → `"Korean"`)
 - **Translation Key Listing** - `getTranslationKeys(locale?, namespace?)` returns all loaded translation keys
 - **Missing Translation Tracker** - Runtime collection of missing translation keys (`trackMissingKeys(true/false)`, `getMissingKeys()`, `clearMissingKeys()`)
+- **Locale Change Event** — Subscribe to locale changes with `onLocaleChange()` (v0.12.0)
 
 ---
 
@@ -898,6 +899,23 @@ Useful for discovering untranslated content during development and testing.
 
 ---
 
+## Locale Change Event
+
+Subscribe to locale changes with `onLocaleChange()` to run custom logic when the locale switches:
+
+```ts
+import { setLocale, onLocaleChange } from 'inline-i18n-multi'
+
+const unsubscribe = onLocaleChange((newLocale, previousLocale) => {
+  console.log(`Locale changed: ${previousLocale} → ${newLocale}`)
+})
+
+setLocale('ko')  // logs: "Locale changed: en → ko"
+unsubscribe()    // stop listening
+```
+
+---
+
 ## Configuration
 
 Configure global settings for fallback behavior and warnings:
@@ -997,6 +1015,8 @@ Available helpers:
 | `trackMissingKeys(enabled)` | Enable or disable missing translation key tracking |
 | `getMissingKeys()` | Get all tracked missing translation keys |
 | `clearMissingKeys()` | Clear the tracked missing keys list |
+| `onLocaleChange(callback)` | Subscribe to locale changes, returns unsubscribe function |
+| `clearLocaleListeners()` | Remove all locale change listeners |
 
 ### Custom Formatters
 

package/dist/index.d.mts

@@ -97,6 +97,14 @@ declare function it(ko: string, en: string, vars?: TranslationVars): string;
  */
 declare function it(translations: Translations, vars?: TranslationVars): string;
 
+type LocaleChangeCallback = (locale: Locale, previousLocale: Locale) => void;
+/**
+ * Subscribe to locale changes.
+ * Returns an unsubscribe function.
+ */
+declare function onLocaleChange(callback: LocaleChangeCallback): () => void;
+/** Remove all locale change listeners (for testing) */
+declare function clearLocaleListeners(): void;
 declare function setLocale(locale: Locale): void;
 declare function getLocale(): Locale;
 /**
@@ -387,4 +395,4 @@ interface RichTextSegment {
  */
 declare function parseRichText(template: string, componentNames: string[]): RichTextSegment[];
 
-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, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getTranslationKeys, 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, trackMissingKeys, 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, clearLocaleListeners, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getTranslationKeys, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, onLocaleChange, parseRichText, registerFormatter, resetConfig, restoreLocale, setLocale, t, trackMissingKeys, zh_es };

package/dist/index.d.ts

@@ -97,6 +97,14 @@ declare function it(ko: string, en: string, vars?: TranslationVars): string;
  */
 declare function it(translations: Translations, vars?: TranslationVars): string;
 
+type LocaleChangeCallback = (locale: Locale, previousLocale: Locale) => void;
+/**
+ * Subscribe to locale changes.
+ * Returns an unsubscribe function.
+ */
+declare function onLocaleChange(callback: LocaleChangeCallback): () => void;
+/** Remove all locale change listeners (for testing) */
+declare function clearLocaleListeners(): void;
 declare function setLocale(locale: Locale): void;
 declare function getLocale(): Locale;
 /**
@@ -387,4 +395,4 @@ interface RichTextSegment {
  */
 declare function parseRichText(template: string, componentNames: string[]): RichTextSegment[];
 
-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, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getTranslationKeys, 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, trackMissingKeys, 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, clearLocaleListeners, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getTranslationKeys, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, onLocaleChange, parseRichText, registerFormatter, resetConfig, restoreLocale, setLocale, t, trackMissingKeys, zh_es };

package/dist/index.js

@@ -105,6 +105,21 @@ function applyDebugFormat(output, debugInfo) {
 
 // src/context.ts
 var currentLocale = "en";
+var listeners = /* @__PURE__ */ new Set();
+function onLocaleChange(callback) {
+  listeners.add(callback);
+  return () => {
+    listeners.delete(callback);
+  };
+}
+function notifyListeners(locale, previousLocale) {
+  for (const cb of listeners) {
+    cb(locale, previousLocale);
+  }
+}
+function clearLocaleListeners() {
+  listeners.clear();
+}
 function setCookie(name, value, days) {
   if (typeof document === "undefined") return;
   const expires = new Date(Date.now() + days * 864e5).toUTCString();
@@ -131,8 +146,12 @@ function persistLocaleToStorage(locale) {
   }
 }
 function setLocale(locale) {
+  const previousLocale = currentLocale;
   currentLocale = locale;
   persistLocaleToStorage(locale);
+  if (locale !== previousLocale) {
+    notifyListeners(locale, previousLocale);
+  }
 }
 function getLocale() {
   return currentLocale;
@@ -1178,6 +1197,7 @@ exports.__i18n_lookup = __i18n_lookup;
 exports.clearDictionaries = clearDictionaries;
 exports.clearFormatters = clearFormatters;
 exports.clearICUCache = clearICUCache;
+exports.clearLocaleListeners = clearLocaleListeners;
 exports.clearMissingKeys = clearMissingKeys;
 exports.configure = configure;
 exports.createScope = createScope;
@@ -1208,6 +1228,7 @@ exports.ja_zh = ja_zh;
 exports.loadAsync = loadAsync;
 exports.loadDictionaries = loadDictionaries;
 exports.loadDictionary = loadDictionary;
+exports.onLocaleChange = onLocaleChange;
 exports.parseRichText = parseRichText;
 exports.registerFormatter = registerFormatter;
 exports.resetConfig = resetConfig;