@xndrjs/i18n 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -10,9 +10,23 @@ type LocaleOfMulti<Schema extends MultiDictionary> = {
     }[keyof Schema[NS]];
 }[keyof Schema] & string;
 type LocaleFallbackMap$1 = Record<string, string | null>;
-type RequestLocale<DictionaryLocale extends string, Fallback extends LocaleFallbackMap$1 | undefined = undefined> = DictionaryLocale | (Fallback extends LocaleFallbackMap$1 ? keyof Fallback & string : never);
+type MissingTranslationContext = {
+    /** Only set by the multi-namespace provider. */
+    namespace?: string;
+    key: string;
+    locale: string;
+    fallbackChain: string;
+};
+type OnMissingTranslation = "throw" | "key" | ((context: MissingTranslationContext) => string);
 type IcuTranslationProviderOptions<Fallback extends LocaleFallbackMap$1 | undefined = undefined> = {
     localeFallback?: Fallback;
+    /**
+     * Strategy when no template resolves for a key/locale (after walking the
+     * fallback chain). "throw" (default) raises an error, "key" returns the
+     * translation key itself, a function receives the context and returns the
+     * string to display. ICU syntax and formatting errors always throw.
+     */
+    onMissing?: OnMissingTranslation;
 };
 
 interface TranslationProviderSingleForLocale<Schema extends KeyDictionary, Params extends {
@@ -43,8 +57,10 @@ declare class IcuTranslationProviderSingle<Schema extends KeyDictionary, Params
     private dictionary;
     private compiledCache;
     private readonly localeFallback?;
+    private readonly onMissing;
     constructor(dictionary: Schema, options?: IcuTranslationProviderOptions<Fallback>);
     get<K extends keyof Schema & string>(key: K, locale: RequestLocales, ...args: Params[K] extends never ? [] : [params: Params[K]]): string;
+    getWithLocale(key: string, locale: string, params?: Record<string, unknown>): string;
     forLocale<Locale extends RequestLocales>(locale: Locale): IcuTranslationProviderSingleForLocale<Schema, Params, RequestLocales, Locale, Fallback>;
     getAll(): Schema;
     setAll(values: Schema): void;
@@ -88,9 +104,11 @@ declare class IcuTranslationProviderMulti<Schema extends MultiDictionary, Params
     private dictionary;
     private compiledCache;
     private readonly localeFallback?;
+    private readonly onMissing;
     private loadedNamespaces;
     constructor(dictionary: Partial<Schema>, options?: IcuTranslationProviderOptions<Fallback>);
     get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(namespace: NS, key: K, locale: RequestLocales, ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]): string;
+    getWithLocale(namespace: string, key: string, locale: string, params?: Record<string, unknown>): string;
     forLocale<Locale extends RequestLocales>(locale: Locale): IcuTranslationProviderMultiForLocale<Schema, Params, RequestLocales, Locale, Fallback>;
     getAll(): Schema;
     hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;
@@ -109,14 +127,25 @@ declare function resolveLocaleTemplate(localeByKey: Record<string, string | unde
 declare function formatLocaleFallbackChain(requestedLocale: string, fallbackMap?: LocaleFallbackMap): string;
 
 /**
- * Builds a dictionary that contains only the requested locales.
+ * Builds a namespace dictionary that contains only the requested locales.
  * For each key and target locale, copies the direct template when present;
  * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).
  */
-declare function projectLocales<T extends KeyDictionary>(dictionary: T, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
+declare function projectNamespaceLocalesCore<T extends KeyDictionary>(dictionary: T, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
+/**
+ * Projects a single namespace for a custom delivery area.
+ * Full locales resolve through `localeFallback` (e.g. external chains like `it → en-US`);
+ * preserve locales copy only their direct canonical entry when present.
+ */
+declare function projectNamespaceForDeliveryAreaCore<T extends KeyDictionary>(dictionary: T, areaLocales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
+/**
+ * Projects a multi-namespace dictionary for a custom delivery area.
+ * Each namespace uses the same delivery-area rules as `projectNamespaceForDeliveryAreaCore`.
+ */
+declare function projectDictionaryForDeliveryAreaCore<T extends MultiDictionary>(dictionary: T, areaLocales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
 /**
  * Projects every namespace in a multi-namespace dictionary.
  */
-declare function projectNamespacesLocales<T extends MultiDictionary>(dictionary: T, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
+declare function projectDictionaryLocalesCore<T extends MultiDictionary>(dictionary: T, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
 
-export { IcuTranslationProviderMulti, type IcuTranslationProviderOptions, IcuTranslationProviderSingle, type KeyDictionary, type LocaleDictionary, type LocaleFallbackMap$1 as LocaleFallbackMap, type LocaleOfMulti, type LocaleOfSingle, type MultiDictionary, type RequestLocale, type ResolvedLocaleTemplate, type TranslationProviderMulti, type TranslationProviderMultiForLocale, type TranslationProviderSingle, type TranslationProviderSingleForLocale, formatLocaleFallbackChain, projectLocales, projectNamespacesLocales, resolveLocaleTemplate, validateLocaleFallback };
+export { IcuTranslationProviderMulti, type IcuTranslationProviderOptions, IcuTranslationProviderSingle, type KeyDictionary, type LocaleDictionary, type LocaleFallbackMap$1 as LocaleFallbackMap, type LocaleOfMulti, type LocaleOfSingle, type MissingTranslationContext, type MultiDictionary, type OnMissingTranslation, type ResolvedLocaleTemplate, type TranslationProviderMulti, type TranslationProviderMultiForLocale, type TranslationProviderSingle, type TranslationProviderSingleForLocale, formatLocaleFallbackChain, projectDictionaryForDeliveryAreaCore, projectDictionaryLocalesCore, projectNamespaceForDeliveryAreaCore, projectNamespaceLocalesCore, resolveLocaleTemplate, validateLocaleFallback };

package/dist/index.js

@@ -1,12 +1,13 @@
 import { IntlMessageFormat } from 'intl-messageformat';
 
-// src/IcuTranslationProviderSingle.ts
-
 // src/deep-freeze.ts
 function deepFreeze(value) {
   if (value === null || typeof value !== "object") {
     return value;
   }
+  if (Object.isFrozen(value)) {
+    return value;
+  }
   Object.freeze(value);
   for (const child of Object.values(value)) {
     deepFreeze(child);
@@ -80,6 +81,68 @@ function formatLocaleFallbackChain(requestedLocale, fallbackMap) {
   return chain.join(" \u2192 ");
 }
 
+// src/format-core.ts
+function formatErrorLabel(context) {
+  if (context.namespace !== void 0) {
+    return `namespace "${context.namespace}", key "${context.key}"`;
+  }
+  return `key "${context.key}"`;
+}
+function formatMissingError(context) {
+  const chain = formatLocaleFallbackChain(context.locale, context.localeFallback);
+  if (context.namespace !== void 0) {
+    return `[i18n] Missing key or locale: namespace "${context.namespace}", key "${context.key}" [${context.locale}] (fallback chain: ${chain})`;
+  }
+  return `[i18n] Missing key or locale: "${context.key}" [${context.locale}] (fallback chain: ${chain})`;
+}
+function resolveMissing(context) {
+  const chain = formatLocaleFallbackChain(context.locale, context.localeFallback);
+  if (context.onMissing === "key") {
+    if (context.namespace !== void 0) {
+      return `${context.namespace}.${context.key}`;
+    }
+    return context.key;
+  }
+  if (typeof context.onMissing === "function") {
+    return context.onMissing({
+      ...context.namespace !== void 0 ? { namespace: context.namespace } : {},
+      key: context.key,
+      locale: context.locale,
+      fallbackChain: chain
+    });
+  }
+  throw new Error(formatMissingError(context));
+}
+function resolveAndFormat(options) {
+  const { localeByKey, locale, params, getCache, context } = options;
+  const resolved = resolveLocaleTemplate(localeByKey, locale, context.localeFallback);
+  if (!resolved) {
+    return resolveMissing(context);
+  }
+  const { template, resolvedLocale } = resolved;
+  const cache = getCache(resolvedLocale);
+  const cacheKey = context.key;
+  const label = formatErrorLabel(context);
+  if (!cache[cacheKey]) {
+    try {
+      cache[cacheKey] = new IntlMessageFormat(template, resolvedLocale);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new Error(
+        `[i18n ICU Syntax Error] Dictionary error for ${label} [${resolvedLocale}]: ${message}`
+      );
+    }
+  }
+  try {
+    return cache[cacheKey].format(params);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `[i18n Formatting Error] Invalid or missing parameters for ${label} [${resolvedLocale}]: ${message}`
+    );
+  }
+}
+
 // src/IcuTranslationProviderSingle.ts
 var IcuTranslationProviderSingleForLocale = class {
   constructor(provider, locale) {
@@ -89,55 +152,45 @@ var IcuTranslationProviderSingleForLocale = class {
   provider;
   locale;
   get(key, ...args) {
-    return this.provider.get(key, this.locale, ...args);
+    const params = args[0];
+    return this.provider.getWithLocale(String(key), this.locale, params);
   }
 };
 var IcuTranslationProviderSingle = class {
   dictionary;
   compiledCache = {};
   localeFallback;
+  onMissing;
   constructor(dictionary, options) {
     this.dictionary = structuredClone(dictionary);
     if (options?.localeFallback) {
       validateLocaleFallback(options.localeFallback);
       this.localeFallback = options.localeFallback;
     }
+    this.onMissing = options?.onMissing ?? "throw";
   }
   get(key, locale, ...args) {
     const params = args[0];
-    const resolved = resolveLocaleTemplate(this.dictionary[key], locale, this.localeFallback);
-    if (!resolved) {
-      const chain = formatLocaleFallbackChain(locale, this.localeFallback);
-      throw new Error(
-        `[i18n] Missing key or locale: "${String(key)}" [${locale}] (fallback chain: ${chain})`
-      );
-    }
-    const { template, resolvedLocale } = resolved;
-    if (!this.compiledCache[resolvedLocale]) {
-      this.compiledCache[resolvedLocale] = {};
-    }
-    const cacheKey = String(key);
-    if (!this.compiledCache[resolvedLocale][cacheKey]) {
-      try {
-        this.compiledCache[resolvedLocale][cacheKey] = new IntlMessageFormat(
-          template,
-          resolvedLocale
-        );
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new Error(
-          `[i18n ICU Syntax Error] Dictionary error for key "${String(key)}" [${resolvedLocale}]: ${message}`
-        );
+    return this.getWithLocale(String(key), locale, params);
+  }
+  getWithLocale(key, locale, params) {
+    return resolveAndFormat({
+      localeByKey: this.dictionary[key],
+      locale,
+      params,
+      getCache: (resolvedLocale) => {
+        if (!this.compiledCache[resolvedLocale]) {
+          this.compiledCache[resolvedLocale] = {};
+        }
+        return this.compiledCache[resolvedLocale];
+      },
+      context: {
+        key,
+        locale,
+        localeFallback: this.localeFallback,
+        onMissing: this.onMissing
       }
-    }
-    try {
-      return this.compiledCache[resolvedLocale][cacheKey].format(params);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      throw new Error(
-        `[i18n Formatting Error] Invalid or missing parameters for key "${String(key)}" [${resolvedLocale}]: ${message}`
-      );
-    }
+    });
   }
   forLocale(locale) {
     return new IcuTranslationProviderSingleForLocale(this, locale);
@@ -150,6 +203,8 @@ var IcuTranslationProviderSingle = class {
     this.compiledCache = {};
   }
 };
+
+// src/IcuTranslationProviderMulti.ts
 var IcuTranslationProviderMultiForLocale = class {
   constructor(provider, locale) {
     this.provider = provider;
@@ -158,13 +213,15 @@ var IcuTranslationProviderMultiForLocale = class {
   provider;
   locale;
   get(namespace, key, ...args) {
-    return this.provider.get(namespace, key, this.locale, ...args);
+    const params = args[0];
+    return this.provider.getWithLocale(String(namespace), String(key), this.locale, params);
   }
 };
 var IcuTranslationProviderMulti = class {
   dictionary;
   compiledCache = {};
   localeFallback;
+  onMissing;
   loadedNamespaces;
   constructor(dictionary, options) {
     this.dictionary = structuredClone(dictionary);
@@ -173,49 +230,40 @@ var IcuTranslationProviderMulti = class {
       validateLocaleFallback(options.localeFallback);
       this.localeFallback = options.localeFallback;
     }
+    this.onMissing = options?.onMissing ?? "throw";
   }
   get(namespace, key, locale, ...args) {
+    const params = args[0];
+    return this.getWithLocale(String(namespace), String(key), locale, params);
+  }
+  getWithLocale(namespace, key, locale, params) {
     if (!this.loadedNamespaces.has(namespace)) {
       throw new Error(
-        `[i18n] Namespace not loaded: "${String(namespace)}". Register it with setNamespace() before calling .get().`
+        `[i18n] Namespace not loaded: "${namespace}". Register it with setNamespace() before calling .get().`
       );
     }
-    const params = args[0];
     const localeByKey = this.dictionary[namespace]?.[key];
-    const resolved = resolveLocaleTemplate(localeByKey, locale, this.localeFallback);
-    if (!resolved) {
-      const chain = formatLocaleFallbackChain(locale, this.localeFallback);
-      throw new Error(
-        `[i18n] Missing key or locale: namespace "${String(namespace)}", key "${String(key)}" [${locale}] (fallback chain: ${chain})`
-      );
-    }
-    const { template, resolvedLocale } = resolved;
-    if (!this.compiledCache[resolvedLocale]) {
-      this.compiledCache[resolvedLocale] = {};
-    }
-    if (!this.compiledCache[resolvedLocale][namespace]) {
-      this.compiledCache[resolvedLocale][namespace] = {};
-    }
-    const namespaceCache = this.compiledCache[resolvedLocale][namespace];
-    const cacheKey = String(key);
-    if (!namespaceCache[cacheKey]) {
-      try {
-        namespaceCache[cacheKey] = new IntlMessageFormat(template, resolvedLocale);
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        throw new Error(
-          `[i18n ICU Syntax Error] namespace "${String(namespace)}", key "${String(key)}" [${resolvedLocale}]: ${message}`
-        );
+    return resolveAndFormat({
+      localeByKey,
+      locale,
+      params,
+      getCache: (resolvedLocale) => {
+        if (!this.compiledCache[resolvedLocale]) {
+          this.compiledCache[resolvedLocale] = {};
+        }
+        if (!this.compiledCache[resolvedLocale][namespace]) {
+          this.compiledCache[resolvedLocale][namespace] = {};
+        }
+        return this.compiledCache[resolvedLocale][namespace];
+      },
+      context: {
+        namespace,
+        key,
+        locale,
+        localeFallback: this.localeFallback,
+        onMissing: this.onMissing
       }
-    }
-    try {
-      return namespaceCache[cacheKey].format(params);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      throw new Error(
-        `[i18n Formatting Error] namespace "${String(namespace)}", key "${String(key)}" [${resolvedLocale}]: ${message}`
-      );
-    }
+    });
   }
   forLocale(locale) {
     return new IcuTranslationProviderMultiForLocale(this, locale);
@@ -244,6 +292,20 @@ var IcuTranslationProviderMulti = class {
 };
 
 // src/project-locales.ts
+function classifyAreaLocales(areaLocales, localeFallback) {
+  const areaSet = new Set(areaLocales);
+  const full = [];
+  const preserve = [];
+  for (const locale of areaLocales) {
+    const fallback = localeFallback?.[locale];
+    if (fallback !== null && fallback !== void 0 && areaSet.has(fallback)) {
+      preserve.push(locale);
+    } else {
+      full.push(locale);
+    }
+  }
+  return { full, preserve };
+}
 function projectKeyDictionary(dictionary, locales, localeFallback) {
   const targetLocales = [...new Set(locales)];
   const result = {};
@@ -261,10 +323,49 @@ function projectKeyDictionary(dictionary, locales, localeFallback) {
   }
   return result;
 }
-function projectLocales(dictionary, locales, localeFallback) {
+function projectNamespaceLocalesCore(dictionary, locales, localeFallback) {
   return projectKeyDictionary(dictionary, locales, localeFallback);
 }
-function projectNamespacesLocales(dictionary, locales, localeFallback) {
+function projectNamespaceForDeliveryAreaCore(dictionary, areaLocales, localeFallback) {
+  const { full, preserve } = classifyAreaLocales(areaLocales, localeFallback);
+  const fullProjection = full.length > 0 ? projectKeyDictionary(dictionary, full, localeFallback) : void 0;
+  const result = {};
+  for (const [key, localesByKey] of Object.entries(dictionary)) {
+    const projected = {};
+    if (fullProjection !== void 0) {
+      const fullEntry = fullProjection[key];
+      if (fullEntry !== void 0) {
+        Object.assign(projected, fullEntry);
+      }
+    }
+    for (const locale of preserve) {
+      const template = localesByKey[locale];
+      if (template !== void 0) {
+        projected[locale] = template;
+      }
+    }
+    if (Object.keys(projected).length > 0) {
+      result[key] = projected;
+    }
+  }
+  return result;
+}
+function projectDictionaryForDeliveryAreaCore(dictionary, areaLocales, localeFallback) {
+  const result = {};
+  for (const namespace of Object.keys(dictionary)) {
+    const namespaceDictionary = dictionary[namespace];
+    if (namespaceDictionary === void 0) {
+      continue;
+    }
+    result[namespace] = projectNamespaceForDeliveryAreaCore(
+      namespaceDictionary,
+      areaLocales,
+      localeFallback
+    );
+  }
+  return result;
+}
+function projectDictionaryLocalesCore(dictionary, locales, localeFallback) {
   const result = {};
   for (const namespace of Object.keys(dictionary)) {
     const namespaceDictionary = dictionary[namespace];
@@ -280,6 +381,6 @@ function projectNamespacesLocales(dictionary, locales, localeFallback) {
   return result;
 }
 
-export { IcuTranslationProviderMulti, IcuTranslationProviderSingle, formatLocaleFallbackChain, projectLocales, projectNamespacesLocales, resolveLocaleTemplate, validateLocaleFallback };
+export { IcuTranslationProviderMulti, IcuTranslationProviderSingle, formatLocaleFallbackChain, projectDictionaryForDeliveryAreaCore, projectDictionaryLocalesCore, projectNamespaceForDeliveryAreaCore, projectNamespaceLocalesCore, resolveLocaleTemplate, validateLocaleFallback };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/deep-freeze.ts","../src/resolve-locale.ts","../src/IcuTranslationProviderSingle.ts","../src/IcuTranslationProviderMulti.ts","../src/project-locales.ts"],"names":["IntlMessageFormat"],"mappings":"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","file":"index.js","sourcesContent":["export function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\") {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const child of Object.values(value)) {\n    deepFreeze(child);\n  }\n\n  return value;\n}\n\nexport function cloneAndFreeze<T>(value: T): T {\n  return deepFreeze(structuredClone(value));\n}\n","export type LocaleFallbackMap = Record<string, string | null>;\n\nexport interface ResolvedLocaleTemplate {\n  template: string;\n  resolvedLocale: string;\n  fallbackChain: readonly string[];\n}\n\nexport function validateLocaleFallback(map: LocaleFallbackMap): void {\n  for (const startLocale of Object.keys(map)) {\n    const visited = new Set<string>();\n    let current: string | undefined = startLocale;\n\n    while (current !== undefined) {\n      if (visited.has(current)) {\n        throw new Error(`[i18n] Circular locale fallback detected involving \"${current}\"`);\n      }\n      visited.add(current);\n\n      const next: string | null | undefined = map[current];\n      if (next === undefined || next === null) {\n        break;\n      }\n      current = next;\n    }\n  }\n}\n\nexport function resolveLocaleTemplate(\n  localeByKey: Record<string, string | undefined> | undefined,\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): ResolvedLocaleTemplate | undefined {\n  const chain: string[] = [requestedLocale];\n  let currentLocale = requestedLocale;\n\n  while (true) {\n    const template = localeByKey?.[currentLocale];\n    if (template !== undefined) {\n      return { template, resolvedLocale: currentLocale, fallbackChain: chain };\n    }\n\n    if (!fallbackMap) {\n      return undefined;\n    }\n\n    const fallback = fallbackMap[currentLocale];\n    if (fallback === undefined || fallback === null) {\n      return undefined;\n    }\n\n    if (chain.includes(fallback)) {\n      throw new Error(\n        `[i18n] Circular locale fallback detected: ${[...chain, fallback].join(\" → \")}`\n      );\n    }\n\n    chain.push(fallback);\n    currentLocale = fallback;\n  }\n}\n\nexport function formatLocaleFallbackChain(\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): string {\n  if (!fallbackMap) {\n    return requestedLocale;\n  }\n\n  const chain: string[] = [requestedLocale];\n  let current = requestedLocale;\n\n  while (true) {\n    const fallback = fallbackMap[current];\n    if (fallback === undefined || fallback === null) {\n      break;\n    }\n    if (chain.includes(fallback)) {\n      chain.push(fallback);\n      break;\n    }\n    chain.push(fallback);\n    current = fallback;\n  }\n\n  return chain.join(\" → \");\n}\n","import { IntlMessageFormat } from \"intl-messageformat\";\nimport { cloneAndFreeze } from \"./deep-freeze.js\";\nimport {\n  formatLocaleFallbackChain,\n  resolveLocaleTemplate,\n  validateLocaleFallback,\n} from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  KeyDictionary,\n  LocaleFallbackMap,\n  LocaleOfSingle,\n  SingleCompiledCache,\n} from \"./types.js\";\n\nexport interface TranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n}\n\nexport interface TranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n> {\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderSingleForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  setAll(values: Schema): void;\n}\n\nexport class IcuTranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderSingleForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderSingle<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    return (\n      this.provider.get as (\n        key: K,\n        locale: Locale,\n        ...params: Params[K] extends never ? [] : [params: Params[K]]\n      ) => string\n    )(key, this.locale, ...args);\n  }\n}\n\nexport class IcuTranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderSingle<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: SingleCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n\n  constructor(dictionary: Schema, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary);\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n  }\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    const params = args[0] as Record<string, unknown> | undefined;\n    const resolved = resolveLocaleTemplate(this.dictionary[key], locale, this.localeFallback);\n\n    if (!resolved) {\n      const chain = formatLocaleFallbackChain(locale, this.localeFallback);\n      throw new Error(\n        `[i18n] Missing key or locale: \"${String(key)}\" [${locale}] (fallback chain: ${chain})`\n      );\n    }\n\n    const { template, resolvedLocale } = resolved;\n\n    if (!this.compiledCache[resolvedLocale]) {\n      this.compiledCache[resolvedLocale] = {};\n    }\n\n    const cacheKey = String(key);\n\n    if (!this.compiledCache[resolvedLocale][cacheKey]) {\n      try {\n        this.compiledCache[resolvedLocale][cacheKey] = new IntlMessageFormat(\n          template,\n          resolvedLocale\n        );\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        throw new Error(\n          `[i18n ICU Syntax Error] Dictionary error for key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n        );\n      }\n    }\n\n    try {\n      return this.compiledCache[resolvedLocale][cacheKey].format(params) as string;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new Error(\n        `[i18n Formatting Error] Invalid or missing parameters for key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n      );\n    }\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderSingleForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderSingleForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n  }\n}\n","import { IntlMessageFormat } from \"intl-messageformat\";\nimport { cloneAndFreeze } from \"./deep-freeze.js\";\nimport {\n  formatLocaleFallbackChain,\n  resolveLocaleTemplate,\n  validateLocaleFallback,\n} from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  LocaleFallbackMap,\n  LocaleOfMulti,\n  MultiCompiledCache,\n  MultiDictionary,\n} from \"./types.js\";\n\nexport interface TranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n}\n\nexport interface TranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n> {\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderMultiForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;\n  setAll(values: Schema): void;\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;\n}\n\nexport class IcuTranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderMultiForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderMulti<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    return (\n      this.provider.get as <\n        NS extends keyof Schema,\n        K extends keyof Schema[NS] & keyof Params[NS] & string,\n      >(\n        namespace: NS,\n        key: K,\n        locale: Locale,\n        ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n      ) => string\n    )(namespace, key, this.locale, ...args);\n  }\n}\n\nexport class IcuTranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderMulti<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: MultiCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n  private loadedNamespaces: Set<string>;\n\n  constructor(dictionary: Partial<Schema>, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary) as Schema;\n    this.loadedNamespaces = new Set(Object.keys(dictionary));\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n  }\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    if (!this.loadedNamespaces.has(namespace as string)) {\n      throw new Error(\n        `[i18n] Namespace not loaded: \"${String(namespace)}\". Register it with setNamespace() before calling .get().`\n      );\n    }\n\n    const params = args[0] as Record<string, unknown> | undefined;\n    const localeByKey = (\n      this.dictionary[namespace as string] as Record<string, Record<string, string>>\n    )?.[key];\n    const resolved = resolveLocaleTemplate(localeByKey, locale, this.localeFallback);\n\n    if (!resolved) {\n      const chain = formatLocaleFallbackChain(locale, this.localeFallback);\n      throw new Error(\n        `[i18n] Missing key or locale: namespace \"${String(namespace)}\", key \"${String(key)}\" [${locale}] (fallback chain: ${chain})`\n      );\n    }\n\n    const { template, resolvedLocale } = resolved;\n\n    if (!this.compiledCache[resolvedLocale]) {\n      this.compiledCache[resolvedLocale] = {};\n    }\n\n    if (!this.compiledCache[resolvedLocale][namespace as string]) {\n      this.compiledCache[resolvedLocale][namespace as string] = {};\n    }\n\n    const namespaceCache = this.compiledCache[resolvedLocale][namespace as string]!;\n    const cacheKey = String(key);\n\n    if (!namespaceCache[cacheKey]) {\n      try {\n        namespaceCache[cacheKey] = new IntlMessageFormat(template, resolvedLocale);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        throw new Error(\n          `[i18n ICU Syntax Error] namespace \"${String(namespace)}\", key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n        );\n      }\n    }\n\n    try {\n      return namespaceCache[cacheKey].format(params) as string;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new Error(\n        `[i18n Formatting Error] namespace \"${String(namespace)}\", key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n      );\n    }\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderMultiForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderMultiForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean {\n    return this.loadedNamespaces.has(namespace);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n    this.loadedNamespaces = new Set(Object.keys(values));\n  }\n\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void {\n    this.dictionary = {\n      ...this.dictionary,\n      [namespace]: structuredClone(values),\n    };\n    this.loadedNamespaces.add(namespace as string);\n\n    for (const locale of Object.keys(this.compiledCache)) {\n      delete this.compiledCache[locale]?.[namespace as string];\n    }\n  }\n}\n","import { resolveLocaleTemplate } from \"./resolve-locale.js\";\nimport type { KeyDictionary, LocaleFallbackMap, MultiDictionary } from \"./types.js\";\n\nfunction projectKeyDictionary<T extends KeyDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const targetLocales = [...new Set(locales)];\n  const result = {} as T;\n\n  for (const [key, localesByKey] of Object.entries(dictionary)) {\n    const projected: Record<string, string> = {};\n\n    for (const locale of targetLocales) {\n      const resolved = resolveLocaleTemplate(localesByKey, locale, localeFallback);\n      if (resolved !== undefined) {\n        projected[locale] = resolved.template;\n      }\n    }\n\n    if (Object.keys(projected).length > 0) {\n      result[key as keyof T] = projected as T[keyof T];\n    }\n  }\n\n  return result;\n}\n\n/**\n * Builds a dictionary that contains only the requested locales.\n * For each key and target locale, copies the direct template when present;\n * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).\n */\nexport function projectLocales<T extends KeyDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  return projectKeyDictionary(dictionary, locales, localeFallback);\n}\n\n/**\n * Projects every namespace in a multi-namespace dictionary.\n */\nexport function projectNamespacesLocales<T extends MultiDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const result = {} as T;\n\n  for (const namespace of Object.keys(dictionary) as (keyof T & string)[]) {\n    const namespaceDictionary = dictionary[namespace];\n    if (namespaceDictionary === undefined) {\n      continue;\n    }\n\n    result[namespace] = projectKeyDictionary(\n      namespaceDictionary,\n      locales,\n      localeFallback\n    ) as T[typeof namespace];\n  }\n\n  return result;\n}\n"]}
+{"version":3,"sources":["../src/deep-freeze.ts","../src/resolve-locale.ts","../src/format-core.ts","../src/IcuTranslationProviderSingle.ts","../src/IcuTranslationProviderMulti.ts","../src/project-locales.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\") {\n    return value;\n  }\n\n  // Guards against infinite recursion on cyclic structures.\n  if (Object.isFrozen(value)) {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const child of Object.values(value)) {\n    deepFreeze(child);\n  }\n\n  return value;\n}\n\nexport function cloneAndFreeze<T>(value: T): T {\n  return deepFreeze(structuredClone(value));\n}\n","export type LocaleFallbackMap = Record<string, string | null>;\n\nexport interface ResolvedLocaleTemplate {\n  template: string;\n  resolvedLocale: string;\n  fallbackChain: readonly string[];\n}\n\nexport function validateLocaleFallback(map: LocaleFallbackMap): void {\n  for (const startLocale of Object.keys(map)) {\n    const visited = new Set<string>();\n    let current: string | undefined = startLocale;\n\n    while (current !== undefined) {\n      if (visited.has(current)) {\n        throw new Error(`[i18n] Circular locale fallback detected involving \"${current}\"`);\n      }\n      visited.add(current);\n\n      const next: string | null | undefined = map[current];\n      if (next === undefined || next === null) {\n        break;\n      }\n      current = next;\n    }\n  }\n}\n\nexport function resolveLocaleTemplate(\n  localeByKey: Record<string, string | undefined> | undefined,\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): ResolvedLocaleTemplate | undefined {\n  const chain: string[] = [requestedLocale];\n  let currentLocale = requestedLocale;\n\n  while (true) {\n    const template = localeByKey?.[currentLocale];\n    if (template !== undefined) {\n      return { template, resolvedLocale: currentLocale, fallbackChain: chain };\n    }\n\n    if (!fallbackMap) {\n      return undefined;\n    }\n\n    const fallback = fallbackMap[currentLocale];\n    if (fallback === undefined || fallback === null) {\n      return undefined;\n    }\n\n    if (chain.includes(fallback)) {\n      throw new Error(\n        `[i18n] Circular locale fallback detected: ${[...chain, fallback].join(\" → \")}`\n      );\n    }\n\n    chain.push(fallback);\n    currentLocale = fallback;\n  }\n}\n\nexport function formatLocaleFallbackChain(\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): string {\n  if (!fallbackMap) {\n    return requestedLocale;\n  }\n\n  const chain: string[] = [requestedLocale];\n  let current = requestedLocale;\n\n  while (true) {\n    const fallback = fallbackMap[current];\n    if (fallback === undefined || fallback === null) {\n      break;\n    }\n    if (chain.includes(fallback)) {\n      chain.push(fallback);\n      break;\n    }\n    chain.push(fallback);\n    current = fallback;\n  }\n\n  return chain.join(\" → \");\n}\n","import { IntlMessageFormat } from \"intl-messageformat\";\nimport { formatLocaleFallbackChain, resolveLocaleTemplate } from \"./resolve-locale.js\";\nimport type { LocaleCache, LocaleFallbackMap, OnMissingTranslation } from \"./types.js\";\n\nexport type FormatCoreContext = {\n  key: string;\n  namespace?: string | undefined;\n  locale: string;\n  localeFallback?: LocaleFallbackMap | undefined;\n  onMissing: OnMissingTranslation;\n};\n\nexport type ResolveAndFormatOptions = {\n  localeByKey: Record<string, string | undefined> | undefined;\n  locale: string;\n  params?: Record<string, unknown> | undefined;\n  getCache: (resolvedLocale: string) => LocaleCache;\n  context: FormatCoreContext;\n};\n\nfunction formatErrorLabel(context: Pick<FormatCoreContext, \"key\" | \"namespace\">): string {\n  if (context.namespace !== undefined) {\n    return `namespace \"${context.namespace}\", key \"${context.key}\"`;\n  }\n  return `key \"${context.key}\"`;\n}\n\nfunction formatMissingError(context: FormatCoreContext): string {\n  const chain = formatLocaleFallbackChain(context.locale, context.localeFallback);\n  if (context.namespace !== undefined) {\n    return `[i18n] Missing key or locale: namespace \"${context.namespace}\", key \"${context.key}\" [${context.locale}] (fallback chain: ${chain})`;\n  }\n  return `[i18n] Missing key or locale: \"${context.key}\" [${context.locale}] (fallback chain: ${chain})`;\n}\n\nfunction resolveMissing(context: FormatCoreContext): string {\n  const chain = formatLocaleFallbackChain(context.locale, context.localeFallback);\n  if (context.onMissing === \"key\") {\n    if (context.namespace !== undefined) {\n      return `${context.namespace}.${context.key}`;\n    }\n    return context.key;\n  }\n  if (typeof context.onMissing === \"function\") {\n    return context.onMissing({\n      ...(context.namespace !== undefined ? { namespace: context.namespace } : {}),\n      key: context.key,\n      locale: context.locale,\n      fallbackChain: chain,\n    });\n  }\n  throw new Error(formatMissingError(context));\n}\n\n/**\n * Shared runtime path for both ICU providers: resolve locale (with fallback) →\n * compile template (cached) → format with params; handles missing keys via `onMissing`.\n */\nexport function resolveAndFormat(options: ResolveAndFormatOptions): string {\n  const { localeByKey, locale, params, getCache, context } = options;\n  const resolved = resolveLocaleTemplate(localeByKey, locale, context.localeFallback);\n\n  if (!resolved) {\n    return resolveMissing(context);\n  }\n\n  const { template, resolvedLocale } = resolved;\n  const cache = getCache(resolvedLocale);\n  const cacheKey = context.key;\n  const label = formatErrorLabel(context);\n\n  if (!cache[cacheKey]) {\n    try {\n      cache[cacheKey] = new IntlMessageFormat(template, resolvedLocale);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new Error(\n        `[i18n ICU Syntax Error] Dictionary error for ${label} [${resolvedLocale}]: ${message}`\n      );\n    }\n  }\n\n  try {\n    return cache[cacheKey].format(params) as string;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    throw new Error(\n      `[i18n Formatting Error] Invalid or missing parameters for ${label} [${resolvedLocale}]: ${message}`\n    );\n  }\n}\n","import { cloneAndFreeze } from \"./deep-freeze.js\";\nimport { resolveAndFormat } from \"./format-core.js\";\nimport { validateLocaleFallback } from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  KeyDictionary,\n  LocaleFallbackMap,\n  LocaleOfSingle,\n  OnMissingTranslation,\n  SingleCompiledCache,\n} from \"./types.js\";\n\nexport interface TranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n}\n\nexport interface TranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n> {\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderSingleForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  setAll(values: Schema): void;\n}\n\nexport class IcuTranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderSingleForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderSingle<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    const params = args[0] as Record<string, unknown> | undefined;\n    return this.provider.getWithLocale(String(key), this.locale, params);\n  }\n}\n\nexport class IcuTranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderSingle<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: SingleCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n  private readonly onMissing: OnMissingTranslation;\n\n  constructor(dictionary: Schema, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary);\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n    this.onMissing = options?.onMissing ?? \"throw\";\n  }\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    const params = args[0] as Record<string, unknown> | undefined;\n    return this.getWithLocale(String(key), locale, params);\n  }\n\n  getWithLocale(key: string, locale: string, params?: Record<string, unknown>): string {\n    return resolveAndFormat({\n      localeByKey: this.dictionary[key],\n      locale,\n      params,\n      getCache: (resolvedLocale) => {\n        if (!this.compiledCache[resolvedLocale]) {\n          this.compiledCache[resolvedLocale] = {};\n        }\n        return this.compiledCache[resolvedLocale]!;\n      },\n      context: {\n        key,\n        locale,\n        localeFallback: this.localeFallback,\n        onMissing: this.onMissing,\n      },\n    });\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderSingleForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderSingleForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n  }\n}\n","import { cloneAndFreeze } from \"./deep-freeze.js\";\nimport { resolveAndFormat } from \"./format-core.js\";\nimport { validateLocaleFallback } from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  LocaleFallbackMap,\n  LocaleOfMulti,\n  MultiCompiledCache,\n  MultiDictionary,\n  OnMissingTranslation,\n} from \"./types.js\";\n\nexport interface TranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n}\n\nexport interface TranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n> {\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderMultiForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;\n  setAll(values: Schema): void;\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;\n}\n\nexport class IcuTranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderMultiForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderMulti<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    const params = args[0] as Record<string, unknown> | undefined;\n    return this.provider.getWithLocale(String(namespace), String(key), this.locale, params);\n  }\n}\n\nexport class IcuTranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderMulti<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: MultiCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n  private readonly onMissing: OnMissingTranslation;\n  private loadedNamespaces: Set<string>;\n\n  constructor(dictionary: Partial<Schema>, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary) as Schema;\n    this.loadedNamespaces = new Set(Object.keys(dictionary));\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n    this.onMissing = options?.onMissing ?? \"throw\";\n  }\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    const params = args[0] as Record<string, unknown> | undefined;\n    return this.getWithLocale(String(namespace), String(key), locale, params);\n  }\n\n  getWithLocale(\n    namespace: string,\n    key: string,\n    locale: string,\n    params?: Record<string, unknown>\n  ): string {\n    if (!this.loadedNamespaces.has(namespace)) {\n      throw new Error(\n        `[i18n] Namespace not loaded: \"${namespace}\". Register it with setNamespace() before calling .get().`\n      );\n    }\n\n    const localeByKey = (\n      this.dictionary[namespace] as Record<string, Record<string, string>> | undefined\n    )?.[key];\n\n    return resolveAndFormat({\n      localeByKey,\n      locale,\n      params,\n      getCache: (resolvedLocale) => {\n        if (!this.compiledCache[resolvedLocale]) {\n          this.compiledCache[resolvedLocale] = {};\n        }\n        if (!this.compiledCache[resolvedLocale]![namespace]) {\n          this.compiledCache[resolvedLocale]![namespace] = {};\n        }\n        return this.compiledCache[resolvedLocale]![namespace]!;\n      },\n      context: {\n        namespace,\n        key,\n        locale,\n        localeFallback: this.localeFallback,\n        onMissing: this.onMissing,\n      },\n    });\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderMultiForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderMultiForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean {\n    return this.loadedNamespaces.has(namespace);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n    this.loadedNamespaces = new Set(Object.keys(values));\n  }\n\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void {\n    this.dictionary = {\n      ...this.dictionary,\n      [namespace]: structuredClone(values),\n    };\n    this.loadedNamespaces.add(namespace as string);\n\n    for (const locale of Object.keys(this.compiledCache)) {\n      delete this.compiledCache[locale]?.[namespace as string];\n    }\n  }\n}\n","import { resolveLocaleTemplate } from \"./resolve-locale.js\";\nimport type { KeyDictionary, LocaleFallbackMap, MultiDictionary } from \"./types.js\";\n\nfunction classifyAreaLocales(\n  areaLocales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): { full: string[]; preserve: string[] } {\n  const areaSet = new Set(areaLocales);\n  const full: string[] = [];\n  const preserve: string[] = [];\n\n  for (const locale of areaLocales) {\n    const fallback = localeFallback?.[locale];\n    if (fallback !== null && fallback !== undefined && areaSet.has(fallback)) {\n      preserve.push(locale);\n    } else {\n      full.push(locale);\n    }\n  }\n\n  return { full, preserve };\n}\n\nfunction projectKeyDictionary<T extends KeyDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const targetLocales = [...new Set(locales)];\n  const result = {} as T;\n\n  for (const [key, localesByKey] of Object.entries(dictionary)) {\n    const projected: Record<string, string> = {};\n\n    for (const locale of targetLocales) {\n      const resolved = resolveLocaleTemplate(localesByKey, locale, localeFallback);\n      if (resolved !== undefined) {\n        projected[locale] = resolved.template;\n      }\n    }\n\n    if (Object.keys(projected).length > 0) {\n      result[key as keyof T] = projected as T[keyof T];\n    }\n  }\n\n  return result;\n}\n\n/**\n * Builds a namespace dictionary that contains only the requested locales.\n * For each key and target locale, copies the direct template when present;\n * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).\n */\nexport function projectNamespaceLocalesCore<T extends KeyDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  return projectKeyDictionary(dictionary, locales, localeFallback);\n}\n\n/**\n * Projects a single namespace for a custom delivery area.\n * Full locales resolve through `localeFallback` (e.g. external chains like `it → en-US`);\n * preserve locales copy only their direct canonical entry when present.\n */\nexport function projectNamespaceForDeliveryAreaCore<T extends KeyDictionary>(\n  dictionary: T,\n  areaLocales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const { full, preserve } = classifyAreaLocales(areaLocales, localeFallback);\n  const fullProjection =\n    full.length > 0 ? projectKeyDictionary(dictionary, full, localeFallback) : undefined;\n  const result = {} as T;\n\n  for (const [key, localesByKey] of Object.entries(dictionary)) {\n    const projected: Record<string, string> = {};\n\n    if (fullProjection !== undefined) {\n      const fullEntry = fullProjection[key as keyof T];\n      if (fullEntry !== undefined) {\n        Object.assign(projected, fullEntry);\n      }\n    }\n\n    for (const locale of preserve) {\n      const template = localesByKey[locale];\n      if (template !== undefined) {\n        projected[locale] = template;\n      }\n    }\n\n    if (Object.keys(projected).length > 0) {\n      result[key as keyof T] = projected as T[keyof T];\n    }\n  }\n\n  return result;\n}\n\n/**\n * Projects a multi-namespace dictionary for a custom delivery area.\n * Each namespace uses the same delivery-area rules as `projectNamespaceForDeliveryAreaCore`.\n */\nexport function projectDictionaryForDeliveryAreaCore<T extends MultiDictionary>(\n  dictionary: T,\n  areaLocales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const result = {} as T;\n\n  for (const namespace of Object.keys(dictionary) as (keyof T & string)[]) {\n    const namespaceDictionary = dictionary[namespace];\n    if (namespaceDictionary === undefined) {\n      continue;\n    }\n\n    result[namespace] = projectNamespaceForDeliveryAreaCore(\n      namespaceDictionary,\n      areaLocales,\n      localeFallback\n    ) as T[typeof namespace];\n  }\n\n  return result;\n}\n\n/**\n * Projects every namespace in a multi-namespace dictionary.\n */\nexport function projectDictionaryLocalesCore<T extends MultiDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const result = {} as T;\n\n  for (const namespace of Object.keys(dictionary) as (keyof T & string)[]) {\n    const namespaceDictionary = dictionary[namespace];\n    if (namespaceDictionary === undefined) {\n      continue;\n    }\n\n    result[namespace] = projectKeyDictionary(\n      namespaceDictionary,\n      locales,\n      localeFallback\n    ) as T[typeof namespace];\n  }\n\n  return result;\n}\n"]}

package/dist/validation/index.d.ts

@@ -81,6 +81,10 @@ type ValidationResult<T> = {
     readonly issues: readonly ValidationIssue[];
 };
 
+/**
+ * Validation step 1: coerce external input into a normalized dictionary shape
+ * (keys, locales, ICU args) against a `DictionarySpec`.
+ */
 declare function normalizeDictionary(input: unknown, spec: DictionarySpec): ValidationResult<NormalizedDictionary>;
 
 type LocaleDictionary = Record<string, string>;