inline-i18n-multi 0.16.0 → 0.17.0

package/README.md

@@ -87,6 +87,7 @@ See "Hello" in your app? Just search for "Hello" in your codebase. **Done.**
 - **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)
+- **Translation Completeness Ratio** -- `getCompletenessRatio(locale, baseLocale?, namespace?)` returns the fraction of base-locale keys present in a target locale (v0.17.0)
 
 ---
 
@@ -1027,6 +1028,7 @@ Available helpers:
 | `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 |
+| `getCompletenessRatio(locale, baseLocale?, namespace?)` | Get translation completeness ratio (0-1) |
 
 ### Custom Formatters
 

package/dist/index.d.mts

@@ -279,6 +279,22 @@ declare function getDictionary(locale: Locale, namespace?: string): Dictionary |
  * Get all loaded namespaces
  */
 declare function getLoadedNamespaces(): string[];
+/**
+ * Get translation completeness ratio of a locale relative to a base locale (v0.17.0)
+ * Returns a value between 0 and 1 representing the fraction of base locale keys
+ * that exist in the target locale.
+ *
+ * @param locale - Target locale to measure
+ * @param baseLocale - Reference locale (defaults to config.defaultLocale)
+ * @param namespace - Optional namespace to scope the comparison
+ * @returns Ratio in [0, 1]; 1 if base has no keys or locale === base
+ *
+ * @example
+ * loadDictionaries({ en: { a: '1', b: '2', c: '3' }, ko: { a: '가' } })
+ * getCompletenessRatio('ko')        // → 0.333... (1 of 3 keys translated)
+ * getCompletenessRatio('en')        // → 1 (same as base)
+ */
+declare function getCompletenessRatio(locale: Locale, baseLocale?: Locale, namespace?: string): number;
 /**
  * Get the display name of a locale using Intl.DisplayNames (v0.11.0)
  * @param locale - Locale code to get display name for (e.g., 'ko', 'ja', 'en-US')
@@ -460,4 +476,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, 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, 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 };

package/dist/index.d.ts

@@ -279,6 +279,22 @@ declare function getDictionary(locale: Locale, namespace?: string): Dictionary |
  * Get all loaded namespaces
  */
 declare function getLoadedNamespaces(): string[];
+/**
+ * Get translation completeness ratio of a locale relative to a base locale (v0.17.0)
+ * Returns a value between 0 and 1 representing the fraction of base locale keys
+ * that exist in the target locale.
+ *
+ * @param locale - Target locale to measure
+ * @param baseLocale - Reference locale (defaults to config.defaultLocale)
+ * @param namespace - Optional namespace to scope the comparison
+ * @returns Ratio in [0, 1]; 1 if base has no keys or locale === base
+ *
+ * @example
+ * loadDictionaries({ en: { a: '1', b: '2', c: '3' }, ko: { a: '가' } })
+ * getCompletenessRatio('ko')        // → 0.333... (1 of 3 keys translated)
+ * getCompletenessRatio('en')        // → 1 (same as base)
+ */
+declare function getCompletenessRatio(locale: Locale, baseLocale?: Locale, namespace?: string): number;
 /**
  * Get the display name of a locale using Intl.DisplayNames (v0.11.0)
  * @param locale - Locale code to get display name for (e.g., 'ko', 'ja', 'en-US')
@@ -460,4 +476,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, 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, 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 };

package/dist/index.js

@@ -1039,6 +1039,18 @@ function getDictionary(locale, namespace) {
 function getLoadedNamespaces() {
   return Object.keys(namespacedDictionaries);
 }
+function getCompletenessRatio(locale, baseLocale, namespace) {
+  const base = baseLocale ?? getConfig().defaultLocale;
+  if (locale === base) return 1;
+  const baseKeys = getTranslationKeys(base, namespace);
+  if (baseKeys.length === 0) return 1;
+  const localeKeys = new Set(getTranslationKeys(locale, namespace));
+  let matched = 0;
+  for (const k of baseKeys) {
+    if (localeKeys.has(k)) matched++;
+  }
+  return matched / baseKeys.length;
+}
 function getLocaleDisplayName(locale, displayLocale) {
   const dl = displayLocale ?? getLocale();
   try {
@@ -1253,6 +1265,7 @@ exports.en_zh = en_zh;
 exports.formatDate = formatDate;
 exports.formatList = formatList;
 exports.formatNumber = formatNumber;
+exports.getCompletenessRatio = getCompletenessRatio;
 exports.getConfig = getConfig;
 exports.getDictionary = getDictionary;
 exports.getLoadedLocales = getLoadedLocales;