intor-translator 1.5.0 → 1.6.0

package/dist/index.cjs

@@ -50,6 +50,162 @@ var BaseTranslator = class {
   }
 };
 
+// src/formatter/utils/to-cache-key.ts
+function toCacheKey(locale, options) {
+  if (!options || Object.keys(options).length === 0) return locale;
+  const normalized = Object.entries(options).filter(([, value]) => value !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}:${String(value)}`).join("|");
+  return `${locale}__${normalized}`;
+}
+
+// src/formatter/date/create-date-time-formatter.ts
+function createDateTimeFormatter() {
+  const cache = /* @__PURE__ */ new Map();
+  return (locale, options) => {
+    const key = toCacheKey(locale, options);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const formatter = new Intl.DateTimeFormat(locale, options);
+    cache.set(key, formatter);
+    return formatter;
+  };
+}
+
+// src/formatter/display-name/create-display-names.ts
+function createDisplayNames() {
+  const cache = /* @__PURE__ */ new Map();
+  return (locale, options) => {
+    const key = toCacheKey(locale, options);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const displayNames = new Intl.DisplayNames(locale, options);
+    cache.set(key, displayNames);
+    return displayNames;
+  };
+}
+
+// src/formatter/list/create-list-formatter.ts
+function createListFormatter() {
+  const cache = /* @__PURE__ */ new Map();
+  return (locale, options) => {
+    const key = toCacheKey(locale, options);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const formatter = new Intl.ListFormat(locale, options);
+    cache.set(key, formatter);
+    return formatter;
+  };
+}
+
+// src/formatter/number/create-number-formatter.ts
+function createNumberFormatter() {
+  const cache = /* @__PURE__ */ new Map();
+  return (locale, options) => {
+    const key = toCacheKey(locale, options);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const formatter = new Intl.NumberFormat(locale, options);
+    cache.set(key, formatter);
+    return formatter;
+  };
+}
+
+// src/formatter/plural/create-plural-rules.ts
+function createPluralRules() {
+  const cache = /* @__PURE__ */ new Map();
+  return (locale, options) => {
+    const key = toCacheKey(locale, options);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const rules = new Intl.PluralRules(locale, options);
+    cache.set(key, rules);
+    return rules;
+  };
+}
+
+// src/formatter/relative-time/create-relative-time-formatter.ts
+function createRelativeTimeFormatter() {
+  const cache = /* @__PURE__ */ new Map();
+  return (locale, options) => {
+    const key = toCacheKey(locale, options);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const formatter = new Intl.RelativeTimeFormat(locale, options);
+    cache.set(key, formatter);
+    return formatter;
+  };
+}
+
+// src/formatter/create-formatter.ts
+function createFormatter({
+  getLocale,
+  formatDefaults
+}) {
+  const getDateTimeFormatter = createDateTimeFormatter();
+  const getListFormatter = createListFormatter();
+  const getRelativeTimeFormatter = createRelativeTimeFormatter();
+  const getNumberFormatter = createNumberFormatter();
+  const getDisplayNames = createDisplayNames();
+  const getPluralRules = createPluralRules();
+  return {
+    number(value, options) {
+      return getNumberFormatter(getLocale(), {
+        ...formatDefaults?.number,
+        ...options
+      }).format(value);
+    },
+    currency(value, currency, options) {
+      const resolvedCurrency = currency ?? formatDefaults?.currencyCode;
+      if (!resolvedCurrency) {
+        throw new Error("[intor-translator] currency is required");
+      }
+      return getNumberFormatter(getLocale(), {
+        ...formatDefaults?.currency,
+        ...options,
+        style: "currency",
+        currency: resolvedCurrency
+      }).format(value);
+    },
+    date(value, options) {
+      return getDateTimeFormatter(getLocale(), {
+        ...formatDefaults?.date,
+        ...formatDefaults?.timeZone ? { timeZone: formatDefaults.timeZone } : {},
+        ...options
+      }).format(value);
+    },
+    relativeTime(value, unit, options) {
+      return getRelativeTimeFormatter(getLocale(), {
+        ...formatDefaults?.relativeTime,
+        ...options
+      }).format(value, unit);
+    },
+    list(values, options) {
+      return getListFormatter(getLocale(), {
+        ...formatDefaults?.list,
+        ...options
+      }).format(values);
+    },
+    displayName(value, options) {
+      const resolvedOptions = {
+        ...formatDefaults?.displayName,
+        ...options
+      };
+      if (!resolvedOptions.type) {
+        throw new Error("[intor-translator] displayName type is required");
+      }
+      return getDisplayNames(
+        getLocale(),
+        resolvedOptions
+      ).of(value);
+    },
+    plural(value, options) {
+      return getPluralRules(getLocale(), {
+        ...formatDefaults?.plural,
+        ...options
+      }).select(value);
+    }
+  };
+}
+
 // src/shared/utils/resolve-candidate-locales.ts
 var resolveCandidateLocales = (locale, fallbackLocalesMap) => {
   const fallbacks = fallbackLocalesMap?.[locale] || [];
@@ -266,14 +422,27 @@ var CoreTranslator = class extends BaseTranslator {
     [...DEFAULT_HOOKS],
     { name: "Intor Translator" }
   );
+  /** Locale-aware formatting helpers. */
+  format;
   constructor(options) {
-    const { locale, messages, isLoading, hooks, ...translateConfig } = options;
+    const {
+      locale,
+      messages,
+      isLoading,
+      hooks,
+      formatDefaults,
+      ...translateConfig
+    } = options;
     super({
       locale,
       ...messages !== void 0 && { messages },
       ...isLoading !== void 0 && { isLoading }
     });
     this.translateConfig = translateConfig;
+    this.format = createFormatter({
+      getLocale: () => this.locale,
+      ...formatDefaults !== void 0 && { formatDefaults }
+    });
     if (hooks) for (const hook of hooks) this.use(hook);
   }
   /** Registers a pipeline hook. */
@@ -328,6 +497,8 @@ var ScopeTranslator = class extends CoreTranslator {
   /** Create a scoped translator with a prefix key for resolving nested message paths. */
   scoped(preKey) {
     return {
+      /** Locale-aware formatting helpers. */
+      format: this.format,
       /** Checks whether a translation key exists. */
       hasKey: (key, targetLocale) => {
         const fullKey = getFullKey(preKey, key);