inline-i18n-multi 0.13.0 → 0.14.0

package/README.md

@@ -84,6 +84,7 @@ See "Hello" in your app? Just search for "Hello" in your codebase. **Done.**
 - **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)
 - **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)
 
 ---
 
@@ -1021,6 +1022,7 @@ Available helpers:
 | `formatNumber(value, options?, locale?)` | Format numbers (currency, percent, etc.) |
 | `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 |
 
 ### Custom Formatters
 

package/dist/index.d.mts

@@ -219,6 +219,18 @@ declare function isLoaded(locale: Locale, namespace?: string): boolean;
  * t('items.count', { count: 5 }) // "5 items"
  */
 declare function t(key: string, vars?: TranslationVars, locale?: Locale): string;
+/**
+ * Get the raw template string for a translation key without interpolation (v0.14.0)
+ * Returns undefined if the key is not found.
+ *
+ * @param key - Dot-separated translation key, optionally prefixed with namespace
+ * @param locale - Override locale (optional)
+ * @example
+ * tRaw('welcome')               // → "Welcome, {name}!"
+ * tRaw('items.count', 'ko')     // → "{count}개 항목"
+ * tRaw('common:greeting')       // → "Hello"
+ */
+declare function tRaw(key: string, locale?: Locale): string | undefined;
 /**
  * Check if a translation key exists
  * @param key - Translation key (may include namespace prefix)
@@ -422,4 +434,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, 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, 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 };

package/dist/index.d.ts

@@ -219,6 +219,18 @@ declare function isLoaded(locale: Locale, namespace?: string): boolean;
  * t('items.count', { count: 5 }) // "5 items"
  */
 declare function t(key: string, vars?: TranslationVars, locale?: Locale): string;
+/**
+ * Get the raw template string for a translation key without interpolation (v0.14.0)
+ * Returns undefined if the key is not found.
+ *
+ * @param key - Dot-separated translation key, optionally prefixed with namespace
+ * @param locale - Override locale (optional)
+ * @example
+ * tRaw('welcome')               // → "Welcome, {name}!"
+ * tRaw('items.count', 'ko')     // → "{count}개 항목"
+ * tRaw('common:greeting')       // → "Hello"
+ */
+declare function tRaw(key: string, locale?: Locale): string | undefined;
 /**
  * Check if a translation key exists
  * @param key - Translation key (may include namespace prefix)
@@ -422,4 +434,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, 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, 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 };

package/dist/index.js

@@ -976,6 +976,19 @@ function t(key, vars, locale) {
   };
   return applyDebugFormat(result, debugInfo);
 }
+function tRaw(key, locale) {
+  const { namespace, key: actualKey } = parseKey(key);
+  const currentLocale2 = locale ?? getLocale();
+  const fallbackChain = buildFallbackChain(currentLocale2);
+  const nsDictionaries = namespacedDictionaries[namespace] || {};
+  for (const tryLocale of fallbackChain) {
+    const dict = nsDictionaries[tryLocale];
+    if (!dict) continue;
+    const found = getNestedValue(dict, actualKey);
+    if (found !== void 0) return found;
+  }
+  return void 0;
+}
 function hasTranslation(key, locale, context) {
   const { namespace, key: actualKey } = parseKey(key);
   const currentLocale2 = locale ?? getLocale();
@@ -1249,6 +1262,7 @@ exports.resetConfig = resetConfig;
 exports.restoreLocale = restoreLocale;
 exports.setLocale = setLocale;
 exports.t = t;
+exports.tRaw = tRaw;
 exports.trackMissingKeys = trackMissingKeys;
 exports.zh_es = zh_es;
 //# sourceMappingURL=index.js.map