@xndrjs/i18n 0.6.0-alpha.1 → 0.6.1

package/README.md

@@ -195,7 +195,7 @@ Variables found across **all locales** of the same key are merged. If parsing fa
 
 ### 3. Generated files
 
-- **`i18n-types.generated.ts`** — `I18N_MODE`, `MyProjectParams`, `MyProjectSchema`.
+- **`i18n-types.generated.ts`** — `I18N_MODE`, `MyProjectParams`, `MyProjectSchema`. With `delivery: "custom"`, also `MyProjectDeliveryArea`, `DELIVERY_ARTIFACTS`, `LOCALE_DELIVERY_AREA`, and `MyProjectDeliveryArtifacts`.
 - **`dictionary.generated.ts`** — imports the JSON files and exports `defaultDictionary` (canonical delivery) or `defaultDictionaryFor(locale)` / `defaultDictionaryFor(area)` when eager namespaces exist in split/custom delivery. Omitted when every namespace is lazy in split/custom delivery.
 - **`instance.generated.ts`** — exports `createI18n(dictionary)` (required argument; no default import of the fallback dictionary), typed `projectDictionaryLocales()` (full schema), and in multi mode `projectNamespaceLocales()` (single namespace); with `delivery: "custom"`, also `projectDictionaryForDeliveryArea()` and `projectNamespaceForDeliveryArea()`; `LOCALE_FALLBACK` wired in when configured.
 - **`i18n.ts`** (optional, hand-written) — app-owned singleton if desired.
@@ -424,7 +424,8 @@ Specify **exactly one** of `dictionary` (single-file) or `namespaces` (multi-fil
 | `dictionarySchemaOutput`            | Optional path for generated external dictionary validation (`dictionary-schema.generated.ts`). Requires `zod` in the consumer app.                                                                                                                                                                                                                                                                          |
 | `loadOnInit`                        | Multi mode only; **canonical delivery only**. Namespaces to include in the initial bundle via static imports. When omitted, all namespaces are eager (default). Not allowed with `split-by-locale` or `custom` — those modes load every namespace through `namespaceLoaders`.                                                                                                                               |
 | `namespaceLoadersOutput`            | Output path for generated `namespaceLoaders` (dynamic `import()` per lazy namespace). Defaults to `{dirname(instanceOutput)}/namespace-loaders.generated.ts`. Required when lazy namespaces exist.                                                                                                                                                                                                          |
-| `delivery`                          | Optional. `"canonical"` (default) — one multilocale JSON per namespace. `"split-by-locale"` — emits `{basename}.{locale}.json` under `{deliveryOutput}/translations/` and per-locale loaders.                                                                                                                                                                                                               |
+| `delivery`                          | Optional. `"canonical"` (default) — one multilocale JSON per namespace. `"split-by-locale"` — emits `{basename}.{locale}.json` under `{deliveryOutput}/translations/` and per-locale loaders. `"custom"` — named delivery areas via `deliveryArtifacts`; emits `{basename}.{area}.json`, area-scoped loaders, and typed `DELIVERY_ARTIFACTS` / `LOCALE_DELIVERY_AREA` in `i18n-types.generated.ts`.         |
+| `deliveryArtifacts`                 | Required when `delivery` is `"custom"`. Map of delivery area → locale list (e.g. `{ "eu": ["en", "it"], "amer": ["en-US"] }`). Codegen validates structure and that locales partition the project locale set. Emitted as `DELIVERY_ARTIFACTS` (area → locales) and `LOCALE_DELIVERY_AREA` (locale → area).                                                                                                  |
 | `deliveryOutput`                    | Optional. Directory for compiled and split delivery JSON (files land in `{deliveryOutput}/translations/`). Defaults to `dirname(typesOutput)`. Use e.g. `public/i18n` to ship per-locale JSON from a static host while keeping generated TypeScript under `generated/`.                                                                                                                                     |
 
 > Paths are resolved relative to the directory containing `i18n.codegen.json` (e.g. `i18n/` when using `xndrjs-i18n-setup .`).
@@ -482,6 +483,7 @@ Codegen writes `{deliveryOutput}/translations/{basename}.{locale}.json` (for exa
 | `export const defaultDictionary` | `dictionary.generated.ts` is not generated                                                                                         |
 | `namespaceLoaders.billing()`     | `namespaceLoaders.billing(locale)` or `namespaceLoaders.billing(area)`                                                             |
 | —                                | `ensureNamespacesLoadedForLocale(i18n, locale)` or `ensureNamespacesLoadedForArea(i18n, area)` in `namespace-loaders.generated.ts` |
+| —                                | `DELIVERY_ARTIFACTS`, `LOCALE_DELIVERY_AREA` in `i18n-types.generated.ts` (`custom` only)                                          |
 
 When `loadOnInit` lists eager namespaces in **canonical** delivery only, `dictionary.generated.ts` still exports `defaultDictionary` with static imports. In split/custom delivery, eager slices use `defaultDictionaryFor(locale)` or `defaultDictionaryFor(area)` when configured.
 
@@ -505,6 +507,55 @@ const i18n = createI18n({});
 await ensureNamespacesLoadedForArea(i18n, activeArea);
 ```
 
+Custom delivery config and typed artifacts (no need to read `deliveryArtifacts` from JSON at runtime):
+
+```json
+{
+  "delivery": "custom",
+  "deliveryArtifacts": {
+    "eu": ["en", "it", "fr"],
+    "amer": ["en-US", "es-AR"]
+  },
+  "namespaces": {
+    "default": "translations/default.json",
+    "billing": "translations/billing.yaml"
+  },
+  "namespaceLoadersOutput": "generated/namespace-loaders.generated.ts"
+}
+```
+
+Codegen emits the partition in `i18n-types.generated.ts`:
+
+```ts
+export type MyProjectDeliveryArea = "amer" | "eu";
+
+export const DELIVERY_ARTIFACTS = {
+  amer: ["en-US", "es-AR"] as const,
+  eu: ["en", "fr", "it"] as const,
+} as const satisfies Record<MyProjectDeliveryArea, readonly MyProjectLocale[]>;
+
+export type MyProjectDeliveryArtifacts = typeof DELIVERY_ARTIFACTS;
+
+export const LOCALE_DELIVERY_AREA = {
+  "en-US": "amer",
+  "es-AR": "amer",
+  en: "eu",
+  fr: "eu",
+  it: "eu",
+} as const satisfies Record<MyProjectLocale, MyProjectDeliveryArea>;
+```
+
+```ts
+import {
+  DELIVERY_ARTIFACTS,
+  LOCALE_DELIVERY_AREA,
+  type MyProjectDeliveryArea,
+} from "./generated/i18n-types.generated.js";
+
+const euLocales = DELIVERY_ARTIFACTS.eu; // readonly ["en", "fr", "it"]
+const areaForEnUs: MyProjectDeliveryArea = LOCALE_DELIVERY_AREA["en-US"]; // "amer"
+```
+
 Example `dictionary.generated.ts` (multi, canonical delivery, `loadOnInit: ["default"]`):
 
 ```ts
@@ -533,6 +584,10 @@ export const namespaceLoaders = {
         return import("./translations/billing.it.json").then((m) => m.default);
       case "de-CH":
         return import("./translations/billing.de-CH.json").then((m) => m.default);
+      default:
+        throw new Error(
+          `[i18n] No translation artifact for namespace "billing" and locale "${String(locale)}".`
+        );
     }
   },
 };
@@ -544,7 +599,7 @@ export async function ensureNamespacesLoadedForLocale(
 ): Promise<void> {
   await Promise.all(
     namespaces.map(async (namespace) => {
-      i18n.setNamespace(namespace, await namespaceLoaders[namespace](locale));
+      i18n.mergeNamespace(namespace, await namespaceLoaders[namespace](locale));
     })
   );
 }
@@ -566,12 +621,12 @@ Use split delivery when you want smaller lazy chunks (one locale per dynamic imp
 
 ### Single vs. multi-namespace API
 
-|             | Single-file                    | Multi-namespace                               |
-| ----------- | ------------------------------ | --------------------------------------------- |
-| `I18N_MODE` | `'single'`                     | `'multi'`                                     |
-| Provider    | `IcuTranslationProviderSingle` | `IcuTranslationProviderMulti`                 |
-| `.get()`    | `get(key, locale, params?)`    | `get(namespace, key, locale, params?)`        |
-| Override    | `setAll(schema)`               | `setAll(schema)` + `setNamespace(ns, values)` |
+|             | Single-file                           | Multi-namespace                                                               |
+| ----------- | ------------------------------------- | ----------------------------------------------------------------------------- |
+| `I18N_MODE` | `'single'`                            | `'multi'`                                                                     |
+| Provider    | `IcuTranslationProviderSingle`        | `IcuTranslationProviderMulti`                                                 |
+| `.get()`    | `get(key, locale, params?)`           | `get(namespace, key, locale, params?)`                                        |
+| Override    | `setAll(schema)` / `mergeAll(schema)` | `setAll(schema)` + `setNamespace(ns, values)` / `mergeNamespace` / `mergeAll` |
 
 ### Multi-namespace example
 
@@ -611,10 +666,20 @@ i18n.setNamespace("billing", externalBillingPayload);
 
 ### Lazy namespace loading (multi mode)
 
-Split namespaces across chunks with `loadOnInit` in **canonical** delivery only. With `split-by-locale` or `custom`, every namespace is lazy and codegen emits typed `namespaceLoaders` — one dynamic `import()` per lazy namespace (and per locale or delivery area). `.get()` stays synchronous — register lazy namespaces with `setNamespace()` before rendering.
+`.get()` stays synchronous — register lazy namespaces with `setNamespace()` before rendering. The pattern depends on `delivery`:
+
+| Delivery                     | Loading pattern                                                                                                                                                                                                                                                    |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `canonical`                  | `loadOnInit` for eager namespaces; manual `namespaceLoaders.ns()` for lazy ones. Use `hasNamespace` to skip already-loaded namespaces.                                                                                                                             |
+| `split-by-locale` / `custom` | Every namespace is lazy. Prefer `ensureNamespacesLoadedForLocale` / `ensureNamespacesLoadedForArea` — they call `mergeAll()` (single) or `mergeNamespace()` (multi) so loading another locale or area accumulates translations instead of replacing prior locales. |
+
+#### Canonical delivery — `loadOnInit` and manual loaders
+
+Split namespaces across chunks with `loadOnInit` in **canonical** delivery only. Codegen emits typed `namespaceLoaders` with one dynamic `import()` per lazy namespace.
 
 ```json
 {
+  "delivery": "canonical",
   "namespaces": {
     "default": "translations/default.json",
     "billing": "translations/billing.yaml"
@@ -626,6 +691,8 @@ Split namespaces across chunks with `loadOnInit` in **canonical** delivery only.
 
 Codegen also emits `LoadOnInitNamespace`, `LazyNamespace`, and `InitialSchema` types. The generated factory accepts a partial `InitialSchema` at init time.
 
+Use `hasNamespace` when loading lazily by hand — namespaces loaded once stay in memory:
+
 ```ts
 import { i18n, namespaceLoaders, type LazyNamespace } from "./i18n";
 
@@ -645,16 +712,54 @@ await Promise.all(
 );
 ```
 
-With `delivery: "split-by-locale"`, pick the locale on each loader:
+#### Split-by-locale / custom — `ensureNamespacesLoaded*`
+
+With `split-by-locale` or `custom`, codegen emits `ensureNamespacesLoadedForLocale` / `ensureNamespacesLoadedForArea`. These helpers call `mergeAll()` in single mode or `mergeNamespace()` in multi mode — loading another locale or delivery area **adds** locale entries per key instead of replacing the whole dictionary:
+
+```ts
+import { createI18n } from "./generated/instance.generated.js";
+import {
+  ensureNamespacesLoadedForLocale,
+  ensureNamespacesLoadedForArea,
+} from "./generated/namespace-loaders.generated.js";
+
+const i18n = createI18n({});
+
+// split-by-locale — en and it coexist after both calls
+await ensureNamespacesLoadedForLocale(i18n, "it");
+i18n.get("billing", "invoice_summary", "it", { count: 3 });
+
+await ensureNamespacesLoadedForLocale(i18n, "en");
+i18n.get("billing", "invoice_summary", "en", { count: 3 });
+i18n.get("billing", "invoice_summary", "it", { count: 3 }); // still available
+
+// custom delivery
+await ensureNamespacesLoadedForArea(i18n, "eu", ["billing"]);
+```
+
+Route-scoped subset:
+
+```ts
+await ensureNamespacesLoadedForLocale(i18n, activeLocale, ["billing"]);
+```
+
+Manual loader calls (without the helper) should use `mergeAll` (single) or `mergeNamespace` (multi) when accumulating locales on the same instance:
 
 ```ts
 const locale = "it" as const;
 
-if (!i18n.hasNamespace("billing")) {
-  i18n.setNamespace("billing", await namespaceLoaders.billing(locale));
-}
+// single
+i18n.mergeAll(await namespaceLoaders.default(locale));
+
+// multi
+i18n.mergeNamespace("billing", await namespaceLoaders.billing(locale));
+
+// add another locale on the same instance:
+i18n.mergeNamespace("billing", await namespaceLoaders.billing("en"));
 ```
 
+Generated loaders throw if locale/area does not match a known artifact (no silent `undefined` into `setNamespace`).
+
 Optional locale projection before register:
 
 ```ts
@@ -728,7 +833,9 @@ Both providers share this behavior:
 - **`getAll()`** — returns a deep-frozen snapshot of the current dictionary (not a live reference).
 - **`hasNamespace(ns)`** — (multi only) returns whether a namespace has been loaded (eager init, lazy load, or `setNamespace`).
 - **`setAll(values)`** — replaces the dictionary and clears the entire cache.
+- **`mergeAll(values)`** — merges locale entries per translation key (single: whole schema; multi: each namespace in `values`). Alternative to `setAll` when accumulating locales on the same instance. Used by generated `ensureNamespacesLoaded*` helpers in single-mode split/custom delivery.
 - **`setNamespace(ns, values)`** — (multi only) replaces one namespace and invalidates only its cache entries.
+- **`mergeNamespace(ns, values)`** — (multi only) merges locale entries per translation key into an existing namespace (or registers it when not loaded yet). Used by generated `ensureNamespacesLoaded*` helpers in multi-mode split/custom delivery.
 - **Missing key/locale** — by default throws an error if the template is `undefined` (configurable via `onMissing`, see below). An empty string (`""`) is treated as a valid template.
 - **ICU syntax error** — throws `[i18n ICU Syntax Error] ...`.
 - **Formatting error** (missing/invalid params) — throws `[i18n Formatting Error] ...`.

package/dist/index.d.ts

@@ -42,6 +42,7 @@ interface TranslationProviderSingle<Schema extends KeyDictionary, Params extends
     forLocale<Locale extends RequestLocales>(locale: Locale): TranslationProviderSingleForLocale<Schema, Params, Locale>;
     getAll(): Schema;
     setAll(values: Schema): void;
+    mergeAll(values: Partial<Schema>): void;
 }
 declare class IcuTranslationProviderSingleForLocale<Schema extends KeyDictionary, Params extends {
     [K in keyof Schema]: unknown;
@@ -64,6 +65,7 @@ declare class IcuTranslationProviderSingle<Schema extends KeyDictionary, Params
     forLocale<Locale extends RequestLocales>(locale: Locale): IcuTranslationProviderSingleForLocale<Schema, Params, RequestLocales, Locale, Fallback>;
     getAll(): Schema;
     setAll(values: Schema): void;
+    mergeAll(values: Partial<Schema>): void;
 }
 
 interface TranslationProviderMultiForLocale<Schema extends MultiDictionary, Params extends {
@@ -84,7 +86,9 @@ interface TranslationProviderMulti<Schema extends MultiDictionary, Params extend
     getAll(): Schema;
     hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;
     setAll(values: Schema): void;
+    mergeAll(values: Partial<Schema>): void;
     setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
+    mergeNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
 }
 declare class IcuTranslationProviderMultiForLocale<Schema extends MultiDictionary, Params extends {
     [NS in keyof Schema]: {
@@ -113,7 +117,9 @@ declare class IcuTranslationProviderMulti<Schema extends MultiDictionary, Params
     getAll(): Schema;
     hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;
     setAll(values: Schema): void;
+    mergeAll(values: Partial<Schema>): void;
     setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
+    mergeNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
 }
 
 type LocaleFallbackMap = Record<string, string | null>;
@@ -147,5 +153,15 @@ declare function projectDictionaryForDeliveryAreaCore<T extends MultiDictionary>
  * Projects every namespace in a multi-namespace dictionary.
  */
 declare function projectDictionaryLocalesCore<T extends MultiDictionary>(dictionary: T, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
+/**
+ * Merges locale entries per translation key without dropping keys or locales
+ * already present in `existing`. Incoming locales overwrite the same locale on conflict.
+ */
+declare function mergeNamespaceLocalesCore<T extends KeyDictionary>(existing: T, incoming: T): T;
+/**
+ * Merges locale entries per key in every namespace present in `incoming`.
+ * Namespaces and keys not in `incoming` are preserved from `existing`.
+ */
+declare function mergeDictionaryLocalesCore<T extends MultiDictionary>(existing: T, incoming: Partial<T>): T;
 
-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 };
+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, mergeDictionaryLocalesCore, mergeNamespaceLocalesCore, projectDictionaryForDeliveryAreaCore, projectDictionaryLocalesCore, projectNamespaceForDeliveryAreaCore, projectNamespaceLocalesCore, resolveLocaleTemplate, validateLocaleFallback };

package/dist/index.js

@@ -143,6 +143,123 @@ function resolveAndFormat(options) {
   }
 }
 
+// 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 = {};
+  for (const [key, localesByKey] of Object.entries(dictionary)) {
+    const projected = {};
+    for (const locale of targetLocales) {
+      const resolved = resolveLocaleTemplate(localesByKey, locale, localeFallback);
+      if (resolved !== void 0) {
+        projected[locale] = resolved.template;
+      }
+    }
+    if (Object.keys(projected).length > 0) {
+      result[key] = projected;
+    }
+  }
+  return result;
+}
+function projectNamespaceLocalesCore(dictionary, locales, localeFallback) {
+  return projectKeyDictionary(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];
+    if (namespaceDictionary === void 0) {
+      continue;
+    }
+    result[namespace] = projectKeyDictionary(
+      namespaceDictionary,
+      locales,
+      localeFallback
+    );
+  }
+  return result;
+}
+function mergeNamespaceLocalesCore(existing, incoming) {
+  const merged = structuredClone(existing);
+  for (const [key, incomingLocales] of Object.entries(incoming)) {
+    if (incomingLocales === void 0 || typeof incomingLocales !== "object") {
+      continue;
+    }
+    merged[key] = {
+      ...merged[key] ?? {},
+      ...incomingLocales
+    };
+  }
+  return merged;
+}
+function mergeDictionaryLocalesCore(existing, incoming) {
+  const merged = structuredClone(existing);
+  for (const namespace of Object.keys(incoming)) {
+    const incomingNamespace = incoming[namespace];
+    if (incomingNamespace === void 0) {
+      continue;
+    }
+    merged[namespace] = mergeNamespaceLocalesCore(
+      merged[namespace] ?? {},
+      incomingNamespace
+    );
+  }
+  return merged;
+}
+
 // src/IcuTranslationProviderSingle.ts
 var IcuTranslationProviderSingleForLocale = class {
   constructor(provider, locale) {
@@ -202,6 +319,17 @@ var IcuTranslationProviderSingle = class {
     this.dictionary = structuredClone(values);
     this.compiledCache = {};
   }
+  mergeAll(values) {
+    this.dictionary = mergeNamespaceLocalesCore(this.dictionary, values);
+    for (const [key, incomingLocales] of Object.entries(values)) {
+      if (incomingLocales === void 0 || typeof incomingLocales !== "object") {
+        continue;
+      }
+      for (const locale of Object.keys(incomingLocales)) {
+        delete this.compiledCache[locale]?.[key];
+      }
+    }
+  }
 };
 
 // src/IcuTranslationProviderMulti.ts
@@ -279,6 +407,14 @@ var IcuTranslationProviderMulti = class {
     this.compiledCache = {};
     this.loadedNamespaces = new Set(Object.keys(values));
   }
+  mergeAll(values) {
+    for (const namespace of Object.keys(values)) {
+      const incoming = values[namespace];
+      if (incoming !== void 0) {
+        this.mergeNamespace(namespace, incoming);
+      }
+    }
+  }
   setNamespace(namespace, values) {
     this.dictionary = {
       ...this.dictionary,
@@ -289,98 +425,16 @@ var IcuTranslationProviderMulti = class {
       delete this.compiledCache[locale]?.[namespace];
     }
   }
-};
-
-// 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 = {};
-  for (const [key, localesByKey] of Object.entries(dictionary)) {
-    const projected = {};
-    for (const locale of targetLocales) {
-      const resolved = resolveLocaleTemplate(localesByKey, locale, localeFallback);
-      if (resolved !== void 0) {
-        projected[locale] = resolved.template;
-      }
-    }
-    if (Object.keys(projected).length > 0) {
-      result[key] = projected;
-    }
-  }
-  return result;
-}
-function projectNamespaceLocalesCore(dictionary, locales, localeFallback) {
-  return projectKeyDictionary(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];
-    if (namespaceDictionary === void 0) {
-      continue;
+  mergeNamespace(namespace, values) {
+    if (!this.loadedNamespaces.has(namespace)) {
+      this.setNamespace(namespace, values);
+      return;
     }
-    result[namespace] = projectKeyDictionary(
-      namespaceDictionary,
-      locales,
-      localeFallback
-    );
+    const existing = this.dictionary[namespace];
+    this.setNamespace(namespace, mergeNamespaceLocalesCore(existing, values));
   }
-  return result;
-}
+};
 
-export { IcuTranslationProviderMulti, IcuTranslationProviderSingle, formatLocaleFallbackChain, projectDictionaryForDeliveryAreaCore, projectDictionaryLocalesCore, projectNamespaceForDeliveryAreaCore, projectNamespaceLocalesCore, resolveLocaleTemplate, validateLocaleFallback };
+export { IcuTranslationProviderMulti, IcuTranslationProviderSingle, formatLocaleFallbackChain, mergeDictionaryLocalesCore, mergeNamespaceLocalesCore, 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/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"]}
+{"version":3,"sources":["../src/deep-freeze.ts","../src/resolve-locale.ts","../src/format-core.ts","../src/project-locales.ts","../src/IcuTranslationProviderSingle.ts","../src/IcuTranslationProviderMulti.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 { 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\n/**\n * Merges locale entries per translation key without dropping keys or locales\n * already present in `existing`. Incoming locales overwrite the same locale on conflict.\n */\nexport function mergeNamespaceLocalesCore<T extends KeyDictionary>(existing: T, incoming: T): T {\n  const merged = structuredClone(existing);\n\n  for (const [key, incomingLocales] of Object.entries(incoming)) {\n    if (incomingLocales === undefined || typeof incomingLocales !== \"object\") {\n      continue;\n    }\n\n    merged[key as keyof T] = {\n      ...(merged[key as keyof T] ?? {}),\n      ...incomingLocales,\n    } as T[keyof T];\n  }\n\n  return merged;\n}\n\n/**\n * Merges locale entries per key in every namespace present in `incoming`.\n * Namespaces and keys not in `incoming` are preserved from `existing`.\n */\nexport function mergeDictionaryLocalesCore<T extends MultiDictionary>(\n  existing: T,\n  incoming: Partial<T>\n): T {\n  const merged = structuredClone(existing) as T;\n\n  for (const namespace of Object.keys(incoming) as (keyof T & string)[]) {\n    const incomingNamespace = incoming[namespace];\n    if (incomingNamespace === undefined) {\n      continue;\n    }\n\n    merged[namespace] = mergeNamespaceLocalesCore(\n      (merged[namespace] ?? {}) as T[typeof namespace],\n      incomingNamespace as T[typeof namespace]\n    ) as T[typeof namespace];\n  }\n\n  return merged;\n}\n","import { cloneAndFreeze } from \"./deep-freeze.js\";\nimport { resolveAndFormat } from \"./format-core.js\";\nimport { mergeNamespaceLocalesCore } from \"./project-locales.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  mergeAll(values: Partial<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  mergeAll(values: Partial<Schema>): void {\n    this.dictionary = mergeNamespaceLocalesCore(this.dictionary, values as Schema);\n\n    for (const [key, incomingLocales] of Object.entries(values)) {\n      if (incomingLocales === undefined || typeof incomingLocales !== \"object\") {\n        continue;\n      }\n\n      for (const locale of Object.keys(incomingLocales)) {\n        delete this.compiledCache[locale]?.[key];\n      }\n    }\n  }\n}\n","import { cloneAndFreeze } from \"./deep-freeze.js\";\nimport { resolveAndFormat } from \"./format-core.js\";\nimport { mergeNamespaceLocalesCore } from \"./project-locales.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  mergeAll(values: Partial<Schema>): void;\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;\n  mergeNamespace<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  mergeAll(values: Partial<Schema>): void {\n    for (const namespace of Object.keys(values) as (keyof Schema & string)[]) {\n      const incoming = values[namespace];\n      if (incoming !== undefined) {\n        this.mergeNamespace(namespace, incoming as Schema[typeof namespace]);\n      }\n    }\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  mergeNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void {\n    if (!this.loadedNamespaces.has(namespace as string)) {\n      this.setNamespace(namespace, values);\n      return;\n    }\n\n    const existing = this.dictionary[namespace];\n    this.setNamespace(namespace, mergeNamespaceLocalesCore(existing as Schema[NS], values));\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xndrjs/i18n",
-  "version": "0.6.0-alpha.1",
+  "version": "0.6.1",
   "description": "Compiler-first, type-safe ICU MessageFormat i18n with runtime dictionary override from external sources.",
   "private": false,
   "license": "MIT",

package/src/IcuTranslationProviderMulti.test.ts

@@ -210,6 +210,31 @@ describe("IcuTranslationProviderMulti", () => {
     expect(local.get("default", "login_button", "en")).toBe("Login");
   });
 
+  it("merges locales per key with mergeNamespace without dropping existing locales", () => {
+    const local = new IcuTranslationProviderMulti<TestSchema, TestParams>({
+      billing: {
+        // @ts-expect-error missing locale
+        invoice_summary: {
+          en: "You have {count, plural, one {1 invoice} other {{count} invoices}} for {name}",
+        },
+      },
+    });
+
+    local.mergeNamespace("billing", {
+      // @ts-expect-error missing locale
+      invoice_summary: {
+        it: "Hai {count, plural, one {1 fattura} other {{count} fatture}} per {name}",
+      },
+    });
+
+    expect(local.get("billing", "invoice_summary", "en", { count: 2, name: "Bob" })).toBe(
+      "You have 2 invoices for Bob"
+    );
+    expect(local.get("billing", "invoice_summary", "it", { count: 2, name: "Bob" })).toBe(
+      "Hai 2 fatture per Bob"
+    );
+  });
+
   it("replaces the full dictionary on setAll", () => {
     const local = new IcuTranslationProviderMulti<TestSchema, TestParams>(dictionary);
 
@@ -224,6 +249,35 @@ describe("IcuTranslationProviderMulti", () => {
     expect(local.get("default", "login_button", "en")).toBe("Sign in");
   });
 
+  it("merges namespaces with mergeAll without dropping existing locales", () => {
+    const local = new IcuTranslationProviderMulti<TestSchema, TestParams>({
+      billing: {
+        // @ts-expect-error missing locale
+        invoice_summary: {
+          en: "You have {count, plural, one {1 invoice} other {{count} invoices}} for {name}",
+        },
+      },
+    });
+
+    local.mergeAll({
+      billing: {
+        // @ts-expect-error missing locale
+        invoice_summary: {
+          it: "Hai {count, plural, one {1 fattura} other {{count} fatture}} per {name}",
+        },
+      },
+      default: dictionary.default,
+    });
+
+    expect(local.get("billing", "invoice_summary", "en", { count: 2, name: "Bob" })).toBe(
+      "You have 2 invoices for Bob"
+    );
+    expect(local.get("billing", "invoice_summary", "it", { count: 2, name: "Bob" })).toBe(
+      "Hai 2 fatture per Bob"
+    );
+    expect(local.get("default", "login_button", "en")).toBe("Login");
+  });
+
   it("returns a deep-frozen snapshot from getAll", () => {
     expect(provider.getAll()).toEqual(dictionary);
     expect(provider.getAll()).not.toBe(dictionary);

package/src/IcuTranslationProviderMulti.ts

@@ -1,5 +1,6 @@
 import { cloneAndFreeze } from "./deep-freeze.js";
 import { resolveAndFormat } from "./format-core.js";
+import { mergeNamespaceLocalesCore } from "./project-locales.js";
 import { validateLocaleFallback } from "./resolve-locale.js";
 import type {
   IcuTranslationProviderOptions,
@@ -40,7 +41,9 @@ export interface TranslationProviderMulti<
   getAll(): Schema;
   hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;
   setAll(values: Schema): void;
+  mergeAll(values: Partial<Schema>): void;
   setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
+  mergeNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
 }
 
 export class IcuTranslationProviderMultiForLocale<
@@ -161,6 +164,15 @@ export class IcuTranslationProviderMulti<
     this.loadedNamespaces = new Set(Object.keys(values));
   }
 
+  mergeAll(values: Partial<Schema>): void {
+    for (const namespace of Object.keys(values) as (keyof Schema & string)[]) {
+      const incoming = values[namespace];
+      if (incoming !== undefined) {
+        this.mergeNamespace(namespace, incoming as Schema[typeof namespace]);
+      }
+    }
+  }
+
   setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void {
     this.dictionary = {
       ...this.dictionary,
@@ -172,4 +184,14 @@ export class IcuTranslationProviderMulti<
       delete this.compiledCache[locale]?.[namespace as string];
     }
   }
+
+  mergeNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void {
+    if (!this.loadedNamespaces.has(namespace as string)) {
+      this.setNamespace(namespace, values);
+      return;
+    }
+
+    const existing = this.dictionary[namespace];
+    this.setNamespace(namespace, mergeNamespaceLocalesCore(existing as Schema[NS], values));
+  }
 }

package/src/IcuTranslationProviderSingle.test.ts

@@ -235,6 +235,27 @@ describe("IcuTranslationProviderSingle", () => {
     expect(local.get("login_button", "en")).toBe("Sign in");
   });
 
+  it("merges locales per key with mergeAll without dropping existing locales", () => {
+    const local = new IcuTranslationProviderSingle<TestSchema, TestParams>({
+      ...dictionary,
+      // @ts-expect-error missing locale
+      welcome: {
+        en: "Welcome {name}!",
+      },
+    });
+
+    local.mergeAll({
+      // @ts-expect-error missing locale
+      welcome: {
+        it: "Benvenuto {name}!",
+      },
+    });
+
+    expect(local.get("welcome", "en", { name: "Ada" })).toBe("Welcome Ada!");
+    expect(local.get("welcome", "it", { name: "Ada" })).toBe("Benvenuto Ada!");
+    expect(local.get("login_button", "en")).toBe("Login");
+  });
+
   it("returns a deep-frozen snapshot from getAll", () => {
     expect(provider.getAll()).toEqual(dictionary);
     expect(provider.getAll()).not.toBe(dictionary);

package/src/IcuTranslationProviderSingle.ts

@@ -1,5 +1,6 @@
 import { cloneAndFreeze } from "./deep-freeze.js";
 import { resolveAndFormat } from "./format-core.js";
+import { mergeNamespaceLocalesCore } from "./project-locales.js";
 import { validateLocaleFallback } from "./resolve-locale.js";
 import type {
   IcuTranslationProviderOptions,
@@ -37,6 +38,7 @@ export interface TranslationProviderSingle<
   ): TranslationProviderSingleForLocale<Schema, Params, Locale>;
   getAll(): Schema;
   setAll(values: Schema): void;
+  mergeAll(values: Partial<Schema>): void;
 }
 
 export class IcuTranslationProviderSingleForLocale<
@@ -128,4 +130,18 @@ export class IcuTranslationProviderSingle<
     this.dictionary = structuredClone(values);
     this.compiledCache = {};
   }
+
+  mergeAll(values: Partial<Schema>): void {
+    this.dictionary = mergeNamespaceLocalesCore(this.dictionary, values as Schema);
+
+    for (const [key, incomingLocales] of Object.entries(values)) {
+      if (incomingLocales === undefined || typeof incomingLocales !== "object") {
+        continue;
+      }
+
+      for (const locale of Object.keys(incomingLocales)) {
+        delete this.compiledCache[locale]?.[key];
+      }
+    }
+  }
 }

package/src/codegen/emit/namespace-loaders-file.test.ts

@@ -100,6 +100,7 @@ describe("formatNamespaceLoadersFile", () => {
     expect(output).not.toContain("billing: {");
     expect(output).not.toContain("import('./translations/billing.json')");
     expect(output).toContain("export async function ensureNamespacesLoadedForLocale(");
+    expect(output).toContain("i18n.mergeNamespace(namespace,");
     expect(output).toContain("i18n: I18nMultiInstance,");
     expect(output).toContain(
       'namespaces: readonly LazyNamespace[] = ["billing", "default", "user"] as const,'
@@ -107,6 +108,43 @@ describe("formatNamespaceLoadersFile", () => {
     expect(output.match(/from '\.\/i18n-types\.generated'/g)?.length).toBe(1);
   });
 
+  it("emits mergeAll helper for single mode in split delivery", () => {
+    const output = formatNamespaceLoadersFile({
+      loadersOutputPath,
+      lazyEntries: [
+        {
+          namespace: "default",
+          filePath: "src/i18n/translations/translations.json",
+          absolutePath: path.join(projectRoot, "src/i18n/translations/translations.json"),
+        },
+      ],
+      schemaTypeName: "AppSchema",
+      paramsTypeName: "AppParams",
+      localeTypeName: "AppLocale",
+      localeFallbackConstName: "LOCALE_FALLBACK",
+      hasLocaleFallback: true,
+      typesModule: "i18n-types.generated",
+      importExtension: "none",
+      projectRoot,
+      isSingle: true,
+      delivery: "split-by-locale",
+      requestLocales: ["en", "it"],
+      splitPathsByNamespace: {
+        default: {
+          en: "src/i18n/generated/translations/translations.en.json",
+          it: "src/i18n/generated/translations/translations.it.json",
+        },
+      },
+    });
+
+    expect(output).toContain("[K in LazyNamespace]: (locale: AppLocale) => Promise<AppSchema>;");
+    expect(output).toContain("import type { TranslationProviderSingle } from '@xndrjs/i18n';");
+    expect(output).toContain("type I18nSingleInstance = TranslationProviderSingle<");
+    expect(output).toContain("export async function ensureNamespacesLoadedForLocale(");
+    expect(output).toContain("i18n.mergeAll(await namespaceLoaders[namespace](locale));");
+    expect(output).not.toContain("mergeNamespace");
+  });
+
   it("throws when a split path is missing", () => {
     expect(() =>
       formatNamespaceLoadersFile({
@@ -190,6 +228,7 @@ describe("formatNamespaceLoadersFile", () => {
     );
     expect(output).not.toContain("import('./translations/billing.json')");
     expect(output).toContain("export async function ensureNamespacesLoadedForArea(");
+    expect(output).toContain("i18n.mergeNamespace(namespace,");
     expect(output).toContain(
       'namespaces: readonly LazyNamespace[] = ["billing", "default"] as const,'
     );

package/src/codegen/emit/namespace-loaders-file.ts

@@ -34,76 +34,73 @@ interface PartitionedNamespaceLoadersParams {
 }
 
 function formatI18nMultiInstanceType(options: NamespaceLoadersFileOptions): string {
-  const {
-    schemaTypeName,
-    paramsTypeName,
-    localeTypeName,
-    localeFallbackConstName,
-    hasLocaleFallback,
-  } = options;
+  const { schemaTypeName, paramsTypeName, localeTypeName } = options;
 
-  const typeArgs = hasLocaleFallback
-    ? `${schemaTypeName}, ${paramsTypeName}, ${localeTypeName}, typeof ${localeFallbackConstName}`
-    : `${schemaTypeName}, ${paramsTypeName}`;
-
-  return `IcuTranslationProviderMulti<${typeArgs}>`;
+  return `TranslationProviderMulti<${schemaTypeName}, ${paramsTypeName}, ${localeTypeName}>`;
 }
 
-function formatDefaultNamespacesLiteral(lazyEntries: NamespaceEntry[]): string {
-  return [...lazyEntries]
-    .map((entry) => entry.namespace)
-    .sort()
-    .map((namespace) => JSON.stringify(namespace))
-    .join(", ");
+function formatI18nSingleInstanceType(options: NamespaceLoadersFileOptions): string {
+  const { schemaTypeName, paramsTypeName, localeTypeName } = options;
+
+  return `TranslationProviderSingle<${schemaTypeName}, ${paramsTypeName}, ${localeTypeName}>`;
 }
 
 function formatLoadNamespacesHelper(
   options: NamespaceLoadersFileOptions,
   { paramName, paramTypeName, loadNamespacesFunctionName }: PartitionedNamespaceLoadersParams
 ): string {
-  const { lazyEntries } = options;
+  const { lazyEntries, isSingle } = options;
   const defaultNamespaces = formatDefaultNamespacesLiteral(lazyEntries);
+  const i18nInstanceType = isSingle
+    ? formatI18nSingleInstanceType(options)
+    : formatI18nMultiInstanceType(options);
+  const mergeCall = isSingle
+    ? `i18n.mergeAll(await namespaceLoaders[namespace](${paramName}))`
+    : `i18n.mergeNamespace(namespace, await namespaceLoaders[namespace](${paramName}))`;
+  const i18nTypeAlias = isSingle ? "I18nSingleInstance" : "I18nMultiInstance";
 
   return (
-    `\ntype I18nMultiInstance = ${formatI18nMultiInstanceType(options)};\n\n` +
+    `\ntype ${i18nTypeAlias} = ${i18nInstanceType};\n\n` +
     `export async function ${loadNamespacesFunctionName}(\n` +
-    `  i18n: I18nMultiInstance,\n` +
+    `  i18n: ${i18nTypeAlias},\n` +
     `  ${paramName}: ${paramTypeName},\n` +
     `  namespaces: readonly LazyNamespace[] = [${defaultNamespaces}] as const,\n` +
     `): Promise<void> {\n` +
     `  await Promise.all(\n` +
     `    namespaces.map(async (namespace) => {\n` +
-    `      i18n.setNamespace(namespace, await namespaceLoaders[namespace](${paramName}));\n` +
+    `      ${mergeCall};\n` +
     `    }),\n` +
     `  );\n` +
     `}\n`
   );
 }
 
+function formatDefaultNamespacesLiteral(lazyEntries: NamespaceEntry[]): string {
+  return [...lazyEntries]
+    .map((entry) => entry.namespace)
+    .sort()
+    .map((namespace) => JSON.stringify(namespace))
+    .join(", ");
+}
+
 function formatPartitionedTypesImport(
   options: NamespaceLoadersFileOptions,
   paramTypeName: string
 ): string {
-  const {
-    schemaTypeName,
-    paramsTypeName,
-    localeTypeName,
-    localeFallbackConstName,
-    hasLocaleFallback,
-    typesModule,
-    importExtension,
-    isSingle,
-  } = options;
+  const { schemaTypeName, paramsTypeName, localeTypeName, typesModule, importExtension, isSingle } =
+    options;
 
   if (isSingle) {
-    return `import type { ${schemaTypeName}, LazyNamespace, ${paramTypeName} } from '${toRelativeModuleImport(typesModule, importExtension)}';\n\n`;
+    return (
+      `import type { TranslationProviderSingle } from '@xndrjs/i18n';\n` +
+      `import type { ${schemaTypeName}, LazyNamespace, ${paramTypeName}, ${localeTypeName} } from '${toRelativeModuleImport(typesModule, importExtension)}';\n\n`
+    );
   }
 
-  const fallbackImport = hasLocaleFallback ? `${localeFallbackConstName}, ` : "";
-  const paramTypeImport = paramTypeName === localeTypeName ? "" : `, type ${paramTypeName}`;
+  const paramTypeImport = paramTypeName === localeTypeName ? "" : `, ${paramTypeName}`;
   return (
-    `import { IcuTranslationProviderMulti } from '@xndrjs/i18n';\n` +
-    `import { ${fallbackImport}type ${localeTypeName}, type ${paramsTypeName}, type ${schemaTypeName}, type LazyNamespace${paramTypeImport} } from '${toRelativeModuleImport(typesModule, importExtension)}';\n\n`
+    `import type { TranslationProviderMulti } from '@xndrjs/i18n';\n` +
+    `import type { ${localeTypeName}, ${paramsTypeName}, ${schemaTypeName}, LazyNamespace${paramTypeImport} } from '${toRelativeModuleImport(typesModule, importExtension)}';\n\n`
   );
 }
 
@@ -129,8 +126,11 @@ function formatPartitionedNamespaceLoadersFile(
     schemaTypeName,
     projectRoot,
     splitPathsByNamespace = {},
+    isSingle = false,
   } = options;
 
+  const loaderValueType = isSingle ? schemaTypeName : `${schemaTypeName}[K]`;
+
   const typesImport = formatPartitionedTypesImport(options, paramTypeName);
   const loaderEntries = lazyEntries
     .map((entry) => {
@@ -167,9 +167,9 @@ function formatPartitionedNamespaceLoadersFile(
     `${GENERATED_FILE_BANNER}` +
     typesImport +
     `export const namespaceLoaders: {\n` +
-    `  [K in LazyNamespace]: (${paramName}: ${paramTypeName}) => Promise<${schemaTypeName}[K]>;\n` +
+    `  [K in LazyNamespace]: (${paramName}: ${paramTypeName}) => Promise<${loaderValueType}>;\n` +
     `} = {\n${loaderEntries}\n};\n` +
-    (options.isSingle ? "" : formatLoadNamespacesHelper(options, params))
+    formatLoadNamespacesHelper(options, params)
   );
 }
 

package/src/index.ts

@@ -30,6 +30,8 @@ export {
 export type { ResolvedLocaleTemplate } from "./resolve-locale.js";
 
 export {
+  mergeDictionaryLocalesCore,
+  mergeNamespaceLocalesCore,
   projectDictionaryForDeliveryAreaCore,
   projectDictionaryLocalesCore,
   projectNamespaceForDeliveryAreaCore,

package/src/project-locales.test.ts

@@ -1,5 +1,7 @@
 import { describe, expect, it } from "vitest";
 import {
+  mergeDictionaryLocalesCore,
+  mergeNamespaceLocalesCore,
   projectDictionaryForDeliveryAreaCore,
   projectDictionaryLocalesCore,
   projectNamespaceForDeliveryAreaCore,
@@ -202,3 +204,67 @@ describe("projectDictionaryLocalesCore", () => {
     });
   });
 });
+
+describe("mergeNamespaceLocalesCore", () => {
+  it("merges locale maps per key without dropping existing locales", () => {
+    const existing = {
+      welcome: { en: "Welcome {name}!" },
+      login_button: { en: "Login", it: "Accedi" },
+    };
+    const incoming = {
+      welcome: { it: "Benvenuto {name}!" },
+      invoice_summary: { en: "{count} invoices" },
+    };
+
+    // @ts-expect-error missing key in incoming
+    expect(mergeNamespaceLocalesCore(existing, incoming)).toEqual({
+      welcome: { en: "Welcome {name}!", it: "Benvenuto {name}!" },
+      login_button: { en: "Login", it: "Accedi" },
+      invoice_summary: { en: "{count} invoices" },
+    });
+  });
+
+  it("overwrites the same locale when incoming provides a new template", () => {
+    const existing = {
+      welcome: { en: "Welcome {name}!" },
+    };
+    const incoming = {
+      welcome: { en: "Hello {name}!" },
+    };
+
+    expect(mergeNamespaceLocalesCore(existing, incoming)).toEqual({
+      welcome: { en: "Hello {name}!" },
+    });
+  });
+});
+
+describe("mergeDictionaryLocalesCore", () => {
+  it("merges each namespace without dropping existing locales", () => {
+    const existing = {
+      default: {
+        welcome: { en: "Welcome {name}!" },
+      },
+      billing: {
+        invoice_summary: { en: "{count} invoices" },
+      },
+    };
+    const incoming = {
+      default: {
+        welcome: { it: "Benvenuto {name}!" },
+      },
+      billing: {
+        invoice_summary: { it: "{count} fatture" },
+      },
+    };
+
+    // @ts-expect-error missing locale
+    expect(mergeDictionaryLocalesCore(existing, incoming)).toEqual({
+      default: {
+        welcome: { en: "Welcome {name}!", it: "Benvenuto {name}!" },
+      },
+      billing: {
+        invoice_summary: { en: "{count} invoices", it: "{count} fatture" },
+      },
+    });
+  });
+});

package/src/project-locales.ts

@@ -152,3 +152,49 @@ export function projectDictionaryLocalesCore<T extends MultiDictionary>(
 
   return result;
 }
+
+/**
+ * Merges locale entries per translation key without dropping keys or locales
+ * already present in `existing`. Incoming locales overwrite the same locale on conflict.
+ */
+export function mergeNamespaceLocalesCore<T extends KeyDictionary>(existing: T, incoming: T): T {
+  const merged = structuredClone(existing);
+
+  for (const [key, incomingLocales] of Object.entries(incoming)) {
+    if (incomingLocales === undefined || typeof incomingLocales !== "object") {
+      continue;
+    }
+
+    merged[key as keyof T] = {
+      ...(merged[key as keyof T] ?? {}),
+      ...incomingLocales,
+    } as T[keyof T];
+  }
+
+  return merged;
+}
+
+/**
+ * Merges locale entries per key in every namespace present in `incoming`.
+ * Namespaces and keys not in `incoming` are preserved from `existing`.
+ */
+export function mergeDictionaryLocalesCore<T extends MultiDictionary>(
+  existing: T,
+  incoming: Partial<T>
+): T {
+  const merged = structuredClone(existing) as T;
+
+  for (const namespace of Object.keys(incoming) as (keyof T & string)[]) {
+    const incomingNamespace = incoming[namespace];
+    if (incomingNamespace === undefined) {
+      continue;
+    }
+
+    merged[namespace] = mergeNamespaceLocalesCore(
+      (merged[namespace] ?? {}) as T[typeof namespace],
+      incomingNamespace as T[typeof namespace]
+    ) as T[typeof namespace];
+  }
+
+  return merged;
+}