inline-i18n-multi 0.17.0 → 0.18.0

package/README.md

@@ -88,6 +88,7 @@ See "Hello" in your app? Just search for "Hello" in your codebase. **Done.**
 - **Batch Translation** -- `tBatch(keys, vars?, locale?)` translates multiple keys at once (v0.15.0)
 - **Missing Locales Detection** -- `getMissingLocales(key)` returns locales where a key is absent (v0.16.0)
 - **Translation Completeness Ratio** -- `getCompletenessRatio(locale, baseLocale?, namespace?)` returns the fraction of base-locale keys present in a target locale (v0.17.0)
+- **Missing Key Listener** -- `onMissingKey(callback)` subscribes to missing translation events with `(key, locale)` (v0.18.0)
 
 ---
 
@@ -1029,6 +1030,7 @@ Available helpers:
 | `tBatch(keys, vars?, locale?)` | Translate multiple keys at once |
 | `getMissingLocales(key)` | List locales missing a translation key |
 | `getCompletenessRatio(locale, baseLocale?, namespace?)` | Get translation completeness ratio (0-1) |
+| `onMissingKey(callback)` | Subscribe to missing translation key events |
 
 ### Custom Formatters
 

package/dist/index.d.mts

@@ -318,6 +318,27 @@ declare function getLocaleDisplayName(locale: Locale, displayLocale?: Locale): s
  * getTranslationKeys('en', 'common')   // → ['hello', 'goodbye']
  */
 declare function getTranslationKeys(locale?: Locale, namespace?: string): string[];
+type MissingKeyCallback = (key: string, locale: Locale) => void;
+/**
+ * Subscribe to missing translation key events (v0.18.0)
+ * Callback fires every time `t()` encounters a key with no translation
+ * (independent of `trackMissingKeys`).
+ *
+ * @param callback - Receives `(key, requestedLocale)` for each missing key
+ * @returns Unsubscribe function
+ *
+ * @example
+ * const off = onMissingKey((key, locale) => {
+ *   reportToMonitoring({ key, locale })
+ * })
+ * t('missing.key')   // callback fires with ('missing.key', 'en')
+ * off()              // stop listening
+ */
+declare function onMissingKey(callback: MissingKeyCallback): () => void;
+/**
+ * Remove all missing-key listeners (for testing) (v0.18.0)
+ */
+declare function clearMissingKeyListeners(): void;
 /**
  * Enable or disable missing translation tracking (v0.11.0)
  * When enabled, all missing translation keys encountered via t() are recorded.
@@ -476,4 +497,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, clearLocaleListeners, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, formatDate, formatList, formatNumber, getCompletenessRatio, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getMissingLocales, 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, tBatch, tRaw, 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, clearMissingKeyListeners, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, formatDate, formatList, formatNumber, getCompletenessRatio, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getMissingLocales, getTranslationKeys, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, onLocaleChange, onMissingKey, parseRichText, registerFormatter, resetConfig, restoreLocale, setLocale, t, tBatch, tRaw, trackMissingKeys, zh_es };

package/dist/index.d.ts

@@ -318,6 +318,27 @@ declare function getLocaleDisplayName(locale: Locale, displayLocale?: Locale): s
  * getTranslationKeys('en', 'common')   // → ['hello', 'goodbye']
  */
 declare function getTranslationKeys(locale?: Locale, namespace?: string): string[];
+type MissingKeyCallback = (key: string, locale: Locale) => void;
+/**
+ * Subscribe to missing translation key events (v0.18.0)
+ * Callback fires every time `t()` encounters a key with no translation
+ * (independent of `trackMissingKeys`).
+ *
+ * @param callback - Receives `(key, requestedLocale)` for each missing key
+ * @returns Unsubscribe function
+ *
+ * @example
+ * const off = onMissingKey((key, locale) => {
+ *   reportToMonitoring({ key, locale })
+ * })
+ * t('missing.key')   // callback fires with ('missing.key', 'en')
+ * off()              // stop listening
+ */
+declare function onMissingKey(callback: MissingKeyCallback): () => void;
+/**
+ * Remove all missing-key listeners (for testing) (v0.18.0)
+ */
+declare function clearMissingKeyListeners(): void;
 /**
  * Enable or disable missing translation tracking (v0.11.0)
  * When enabled, all missing translation keys encountered via t() are recorded.
@@ -476,4 +497,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, clearLocaleListeners, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, formatDate, formatList, formatNumber, getCompletenessRatio, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getMissingLocales, 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, tBatch, tRaw, 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, clearMissingKeyListeners, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, formatDate, formatList, formatNumber, getCompletenessRatio, getConfig, getDictionary, getLoadedLocales, getLoadedNamespaces, getLocale, getLocaleDisplayName, getMissingKeys, getMissingLocales, getTranslationKeys, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, onLocaleChange, onMissingKey, parseRichText, registerFormatter, resetConfig, restoreLocale, setLocale, t, tBatch, tRaw, trackMissingKeys, zh_es };

package/dist/index.js

@@ -938,7 +938,7 @@ function t(key, vars, locale) {
     }
   }
   if (!template) {
-    recordMissingKey(key);
+    recordMissingKey(key, currentLocale2);
     emitWarning({
       type: "missing_translation",
       key,
@@ -1089,6 +1089,16 @@ function getTranslationKeys(locale, namespace) {
 }
 var missingKeys = /* @__PURE__ */ new Set();
 var trackMissing = false;
+var missingKeyListeners = /* @__PURE__ */ new Set();
+function onMissingKey(callback) {
+  missingKeyListeners.add(callback);
+  return () => {
+    missingKeyListeners.delete(callback);
+  };
+}
+function clearMissingKeyListeners() {
+  missingKeyListeners.clear();
+}
 function trackMissingKeys(enabled) {
   trackMissing = enabled;
   if (!enabled) {
@@ -1101,10 +1111,16 @@ function getMissingKeys() {
 function clearMissingKeys() {
   missingKeys = /* @__PURE__ */ new Set();
 }
-function recordMissingKey(key) {
+function recordMissingKey(key, locale) {
   if (trackMissing) {
     missingKeys.add(key);
   }
+  if (missingKeyListeners.size > 0) {
+    const loc = locale ?? getLocale();
+    for (const cb of missingKeyListeners) {
+      cb(key, loc);
+    }
+  }
 }
 
 // src/detect.ts
@@ -1253,6 +1269,7 @@ exports.clearDictionaries = clearDictionaries;
 exports.clearFormatters = clearFormatters;
 exports.clearICUCache = clearICUCache;
 exports.clearLocaleListeners = clearLocaleListeners;
+exports.clearMissingKeyListeners = clearMissingKeyListeners;
 exports.clearMissingKeys = clearMissingKeys;
 exports.configure = configure;
 exports.createScope = createScope;
@@ -1289,6 +1306,7 @@ exports.loadAsync = loadAsync;
 exports.loadDictionaries = loadDictionaries;
 exports.loadDictionary = loadDictionary;
 exports.onLocaleChange = onLocaleChange;
+exports.onMissingKey = onMissingKey;
 exports.parseRichText = parseRichText;
 exports.registerFormatter = registerFormatter;
 exports.resetConfig = resetConfig;