inline-i18n-multi 0.12.0 → 0.13.0

package/README.md

@@ -83,6 +83,7 @@ See "Hello" in your app? Just search for "Hello" in your codebase. **Done.**
 - **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)
+- **Formatting Utilities** — Locale-aware `formatNumber`, `formatDate`, `formatList` powered by `Intl` APIs (v0.13.0)
 
 ---
 
@@ -1017,6 +1018,9 @@ Available helpers:
 | `clearMissingKeys()` | Clear the tracked missing keys list |
 | `onLocaleChange(callback)` | Subscribe to locale changes, returns unsubscribe function |
 | `clearLocaleListeners()` | Remove all locale change listeners |
+| `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) |
 
 ### Custom Formatters
 

package/dist/index.d.mts

@@ -367,6 +367,33 @@ declare function detectLocale(options: DetectLocaleOptions): Locale;
  */
 declare function createScope(namespace: string): (key: string, vars?: TranslationVars, locale?: Locale) => string;
 
+/**
+ * Format a number for the given locale using Intl.NumberFormat.
+ *
+ * @example
+ * formatNumber(1234.5) // "1,234.5" (en)
+ * formatNumber(1234.5, { style: 'currency', currency: 'USD' }) // "$1,234.50"
+ * formatNumber(0.85, { style: 'percent' }, 'ko') // "85%"
+ */
+declare function formatNumber(value: number, options?: Intl.NumberFormatOptions, locale?: Locale): string;
+/**
+ * Format a date for the given locale using Intl.DateTimeFormat.
+ *
+ * @example
+ * formatDate(new Date()) // "3/30/2026" (en)
+ * formatDate(new Date(), { dateStyle: 'full' }, 'ja') // "2026年3月30日月曜日"
+ */
+declare function formatDate(value: Date | number, options?: Intl.DateTimeFormatOptions, locale?: Locale): string;
+/**
+ * Format a list for the given locale using Intl.ListFormat.
+ *
+ * @example
+ * formatList(['A', 'B', 'C']) // "A, B, and C" (en)
+ * formatList(['A', 'B', 'C'], { type: 'disjunction' }) // "A, B, or C"
+ * formatList(['りんご', 'みかん'], {}, 'ja') // "りんごとみかん"
+ */
+declare function formatList(values: string[], options?: Intl.ListFormatOptions, locale?: Locale): string;
+
 /**
  * Rich Text segment types
  */
@@ -395,4 +422,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, 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, trackMissingKeys, zh_es };

package/dist/index.d.ts

@@ -367,6 +367,33 @@ declare function detectLocale(options: DetectLocaleOptions): Locale;
  */
 declare function createScope(namespace: string): (key: string, vars?: TranslationVars, locale?: Locale) => string;
 
+/**
+ * Format a number for the given locale using Intl.NumberFormat.
+ *
+ * @example
+ * formatNumber(1234.5) // "1,234.5" (en)
+ * formatNumber(1234.5, { style: 'currency', currency: 'USD' }) // "$1,234.50"
+ * formatNumber(0.85, { style: 'percent' }, 'ko') // "85%"
+ */
+declare function formatNumber(value: number, options?: Intl.NumberFormatOptions, locale?: Locale): string;
+/**
+ * Format a date for the given locale using Intl.DateTimeFormat.
+ *
+ * @example
+ * formatDate(new Date()) // "3/30/2026" (en)
+ * formatDate(new Date(), { dateStyle: 'full' }, 'ja') // "2026年3月30日月曜日"
+ */
+declare function formatDate(value: Date | number, options?: Intl.DateTimeFormatOptions, locale?: Locale): string;
+/**
+ * Format a list for the given locale using Intl.ListFormat.
+ *
+ * @example
+ * formatList(['A', 'B', 'C']) // "A, B, and C" (en)
+ * formatList(['A', 'B', 'C'], { type: 'disjunction' }) // "A, B, or C"
+ * formatList(['りんご', 'みかん'], {}, 'ja') // "りんごとみかん"
+ */
+declare function formatList(values: string[], options?: Intl.ListFormatOptions, locale?: Locale): string;
+
 /**
  * Rich Text segment types
  */
@@ -395,4 +422,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, 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, trackMissingKeys, zh_es };

package/dist/index.js

@@ -1157,6 +1157,17 @@ function createScope(namespace) {
   };
 }
 
+// src/format.ts
+function formatNumber(value, options, locale) {
+  return new Intl.NumberFormat(locale ?? getLocale(), options).format(value);
+}
+function formatDate(value, options, locale) {
+  return new Intl.DateTimeFormat(locale ?? getLocale(), options).format(value);
+}
+function formatList(values, options, locale) {
+  return new Intl.ListFormat(locale ?? getLocale(), options).format(values);
+}
+
 // src/richtext.ts
 function escapeRegExp(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -1207,6 +1218,9 @@ exports.en_es = en_es;
 exports.en_fr = en_fr;
 exports.en_ja = en_ja;
 exports.en_zh = en_zh;
+exports.formatDate = formatDate;
+exports.formatList = formatList;
+exports.formatNumber = formatNumber;
 exports.getConfig = getConfig;
 exports.getDictionary = getDictionary;
 exports.getLoadedLocales = getLoadedLocales;