inline-i18n-multi 0.14.0 → 0.16.0

package/README.md

@@ -85,6 +85,8 @@ See "Hello" in your app? Just search for "Hello" in your codebase. **Done.**
 - **Locale Change Event** — Subscribe to locale changes with `onLocaleChange()` (v0.12.0)
 - **Formatting Utilities** — Locale-aware `formatNumber`, `formatDate`, `formatList` powered by `Intl` APIs (v0.13.0)
 - **Raw Template Access** -- `tRaw(key, locale?)` returns raw template string without interpolation (v0.14.0)
+- **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)
 
 ---
 
@@ -1023,6 +1025,8 @@ Available helpers:
 | `formatDate(value, options?, locale?)` | Format dates and times |
 | `formatList(values, options?, locale?)` | Format lists (conjunction, disjunction) |
 | `tRaw(key, locale?)` | Get raw template string without interpolation |
+| `tBatch(keys, vars?, locale?)` | Translate multiple keys at once |
+| `getMissingLocales(key)` | List locales missing a translation key |
 
 ### Custom Formatters
 

package/dist/index.d.mts

@@ -231,6 +231,18 @@ declare function t(key: string, vars?: TranslationVars, locale?: Locale): string
  * tRaw('common:greeting')       // → "Hello"
  */
 declare function tRaw(key: string, locale?: Locale): string | undefined;
+/**
+ * Translate multiple keys at once (v0.15.0)
+ * @param keys - Array of translation keys
+ * @param vars - Optional variables applied to all translations
+ * @param locale - Override locale (optional)
+ * @returns Object mapping each key to its translated string
+ *
+ * @example
+ * tBatch(['greeting', 'farewell'])
+ * // → { greeting: 'Hello', farewell: 'Goodbye' }
+ */
+declare function tBatch(keys: string[], vars?: TranslationVars, locale?: Locale): Record<string, string>;
 /**
  * Check if a translation key exists
  * @param key - Translation key (may include namespace prefix)
@@ -238,6 +250,20 @@ declare function tRaw(key: string, locale?: Locale): string | undefined;
  * @param context - Optional context for contextual translations (v0.9.0)
  */
 declare function hasTranslation(key: string, locale?: Locale, context?: string): boolean;
+/**
+ * Get all locales where a translation key is missing (v0.16.0)
+ * Inverse of `hasTranslation` — checks every loaded locale in the key's namespace
+ * and returns those that do not contain the key.
+ *
+ * @param key - Translation key (may include namespace prefix)
+ * @returns Array of locale codes missing the key
+ *
+ * @example
+ * loadDictionaries({ en: { hello: 'Hi' }, ko: { hello: '안녕' }, ja: {} })
+ * getMissingLocales('hello')   // → ['ja']
+ * getMissingLocales('common:greeting')   // → ['en', 'ko', 'ja'] (key missing in all)
+ */
+declare function getMissingLocales(key: string): Locale[];
 /**
  * Get all loaded locales
  * @param namespace - Optional namespace (returns from all if not specified)
@@ -434,4 +460,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, 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, 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, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, formatDate, formatList, formatNumber, 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 };

package/dist/index.d.ts

@@ -231,6 +231,18 @@ declare function t(key: string, vars?: TranslationVars, locale?: Locale): string
  * tRaw('common:greeting')       // → "Hello"
  */
 declare function tRaw(key: string, locale?: Locale): string | undefined;
+/**
+ * Translate multiple keys at once (v0.15.0)
+ * @param keys - Array of translation keys
+ * @param vars - Optional variables applied to all translations
+ * @param locale - Override locale (optional)
+ * @returns Object mapping each key to its translated string
+ *
+ * @example
+ * tBatch(['greeting', 'farewell'])
+ * // → { greeting: 'Hello', farewell: 'Goodbye' }
+ */
+declare function tBatch(keys: string[], vars?: TranslationVars, locale?: Locale): Record<string, string>;
 /**
  * Check if a translation key exists
  * @param key - Translation key (may include namespace prefix)
@@ -238,6 +250,20 @@ declare function tRaw(key: string, locale?: Locale): string | undefined;
  * @param context - Optional context for contextual translations (v0.9.0)
  */
 declare function hasTranslation(key: string, locale?: Locale, context?: string): boolean;
+/**
+ * Get all locales where a translation key is missing (v0.16.0)
+ * Inverse of `hasTranslation` — checks every loaded locale in the key's namespace
+ * and returns those that do not contain the key.
+ *
+ * @param key - Translation key (may include namespace prefix)
+ * @returns Array of locale codes missing the key
+ *
+ * @example
+ * loadDictionaries({ en: { hello: 'Hi' }, ko: { hello: '안녕' }, ja: {} })
+ * getMissingLocales('hello')   // → ['ja']
+ * getMissingLocales('common:greeting')   // → ['en', 'ko', 'ja'] (key missing in all)
+ */
+declare function getMissingLocales(key: string): Locale[];
 /**
  * Get all loaded locales
  * @param namespace - Optional namespace (returns from all if not specified)
@@ -434,4 +460,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, 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, 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, clearMissingKeys, configure, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, formatDate, formatList, formatNumber, 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 };

package/dist/index.js

@@ -989,6 +989,13 @@ function tRaw(key, locale) {
   }
   return void 0;
 }
+function tBatch(keys, vars, locale) {
+  const result = {};
+  for (const key of keys) {
+    result[key] = t(key, vars, locale);
+  }
+  return result;
+}
 function hasTranslation(key, locale, context) {
   const { namespace, key: actualKey } = parseKey(key);
   const currentLocale2 = locale ?? getLocale();
@@ -1001,6 +1008,18 @@ function hasTranslation(key, locale, context) {
   }
   return getNestedValue(dict, actualKey) !== void 0;
 }
+function getMissingLocales(key) {
+  const { namespace, key: actualKey } = parseKey(key);
+  const nsDictionaries = namespacedDictionaries[namespace] || {};
+  const missing = [];
+  for (const locale of Object.keys(nsDictionaries)) {
+    const dict = nsDictionaries[locale];
+    if (!dict || getNestedValue(dict, actualKey) === void 0) {
+      missing.push(locale);
+    }
+  }
+  return missing;
+}
 function getLoadedLocales(namespace) {
   if (namespace) {
     return Object.keys(namespacedDictionaries[namespace] || {});
@@ -1241,6 +1260,7 @@ exports.getLoadedNamespaces = getLoadedNamespaces;
 exports.getLocale = getLocale;
 exports.getLocaleDisplayName = getLocaleDisplayName;
 exports.getMissingKeys = getMissingKeys;
+exports.getMissingLocales = getMissingLocales;
 exports.getTranslationKeys = getTranslationKeys;
 exports.hasTranslation = hasTranslation;
 exports.isLoaded = isLoaded;
@@ -1262,6 +1282,7 @@ exports.resetConfig = resetConfig;
 exports.restoreLocale = restoreLocale;
 exports.setLocale = setLocale;
 exports.t = t;
+exports.tBatch = tBatch;
 exports.tRaw = tRaw;
 exports.trackMissingKeys = trackMissingKeys;
 exports.zh_es = zh_es;