@xndrjs/i18n 0.3.1 → 0.3.3-alpha.0

package/README.md

@@ -195,7 +195,7 @@ Variables found across **all locales** of the same key are merged. If parsing fa
 
 - **`i18n-types.generated.ts`** — `I18N_MODE`, `MyProjectParams`, `MyProjectSchema`.
 - **`dictionary.generated.ts`** — imports the JSON files and assembles the initial dictionary.
-- **`instance.generated.ts`** — exports `createI18n()` and typed `projectLocales()` (with `LOCALE_FALLBACK` wired in when configured).
+- **`instance.generated.ts`** — exports `createI18n()`, typed `projectLocales()` (full schema), and in multi mode `projectNamespaceLocales()` (single namespace); `LOCALE_FALLBACK` wired in when configured.
 - **`i18n.ts`** (optional, hand-written) — app-owned singleton if desired.
 
 Example generated types (multi-namespace):
@@ -302,19 +302,24 @@ const localeFallback = {
 const i18n = new IcuTranslationProviderMulti(schema, { localeFallback });
 ```
 
-#### `projectLocales`
+#### `projectLocales` / `projectNamespaceLocales`
 
-Namespaces split the dictionary by domain; `projectLocales` splits it by **locale**. Use it before `setAll()` / `setNamespace()` when you only need one locale (or a small regional group) in memory — not every language on every loaded namespace.
+Namespaces split the dictionary by domain; locale projection splits it by **locale**. Use before `setAll()` / `setNamespace()` when you only need one locale (or a small regional group) in memory.
 
 ```ts
-import { createI18n, projectLocales } from "./i18n/generated/instance.generated.js";
+import {
+  createI18n,
+  projectLocales,
+  projectNamespaceLocales,
+} from "./i18n/generated/instance.generated.js";
 import billingDictionary from "./i18n/translations/billing.json";
 
 const i18n = createI18n();
-i18n.setNamespace("billing", projectLocales(billingDictionary, [activeLocale]));
+i18n.setNamespace("billing", projectNamespaceLocales(billingDictionary, [activeLocale]));
+i18n.setAll(projectLocales(fullDictionary, [activeLocale])); // multi: all namespaces
 ```
 
-Codegen emits a typed `projectLocales` in `instance.generated.ts` (wires `LOCALE_FALLBACK` like `createI18n`). The low-level `@xndrjs/i18n` export remains for tooling without codegen.
+Codegen emits typed wrappers in `instance.generated.ts` (`projectLocales` for the full schema; `projectNamespaceLocales` in multi mode for one namespace). The low-level `@xndrjs/i18n` exports remain for tooling without codegen.
 
 ### 6. Translation audit (`xndrjs-i18n-audit`)
 

package/dist/index.d.ts

@@ -116,7 +116,11 @@ declare function formatLocaleFallbackChain(requestedLocale: string, fallbackMap?
  * For each key and target locale, copies the direct template when present;
  * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).
  */
-declare function projectLocales(dictionary: KeyDictionary, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): KeyDictionary;
+declare function projectLocales<T extends KeyDictionary>(dictionary: T, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
+/**
+ * Projects every namespace in a multi-namespace dictionary.
+ */
+declare function projectNamespacesLocales<T extends MultiDictionary>(dictionary: T, locales: readonly string[], localeFallback?: LocaleFallbackMap$1): T;
 
 interface EnsureNamespacesLoadedOptions<Schema extends MultiDictionary, NS extends keyof Schema & string> {
     provider: Pick<{
@@ -128,4 +132,4 @@ interface EnsureNamespacesLoadedOptions<Schema extends MultiDictionary, NS exten
 }
 declare function ensureNamespacesLoadedImpl<Schema extends MultiDictionary, NS extends keyof Schema & string>(options: EnsureNamespacesLoadedOptions<Schema, NS>, namespaces: NS[]): Promise<void>;
 
-export { type EnsureNamespacesLoadedOptions, IcuTranslationProviderMulti, type IcuTranslationProviderOptions, IcuTranslationProviderSingle, type KeyDictionary, type LocaleDictionary, type LocaleFallbackMap$1 as LocaleFallbackMap, type LocaleOfMulti, type LocaleOfSingle, type MultiDictionary, type RequestLocale, type ResolvedLocaleTemplate, type TranslationProviderMulti, type TranslationProviderMultiForLocale, type TranslationProviderSingle, type TranslationProviderSingleForLocale, ensureNamespacesLoadedImpl, formatLocaleFallbackChain, projectLocales, resolveLocaleTemplate, validateLocaleFallback };
+export { type EnsureNamespacesLoadedOptions, IcuTranslationProviderMulti, type IcuTranslationProviderOptions, IcuTranslationProviderSingle, type KeyDictionary, type LocaleDictionary, type LocaleFallbackMap$1 as LocaleFallbackMap, type LocaleOfMulti, type LocaleOfSingle, type MultiDictionary, type RequestLocale, type ResolvedLocaleTemplate, type TranslationProviderMulti, type TranslationProviderMultiForLocale, type TranslationProviderSingle, type TranslationProviderSingleForLocale, ensureNamespacesLoadedImpl, formatLocaleFallbackChain, projectLocales, projectNamespacesLocales, resolveLocaleTemplate, validateLocaleFallback };

package/dist/index.js

@@ -244,7 +244,7 @@ var IcuTranslationProviderMulti = class {
 };
 
 // src/project-locales.ts
-function projectLocales(dictionary, locales, localeFallback) {
+function projectKeyDictionary(dictionary, locales, localeFallback) {
   const targetLocales = [...new Set(locales)];
   const result = {};
   for (const [key, localesByKey] of Object.entries(dictionary)) {
@@ -261,6 +261,24 @@ function projectLocales(dictionary, locales, localeFallback) {
   }
   return result;
 }
+function projectLocales(dictionary, locales, localeFallback) {
+  return projectKeyDictionary(dictionary, locales, localeFallback);
+}
+function projectNamespacesLocales(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;
+}
 
 // src/validation/errors.ts
 function issueMessage(issue) {
@@ -334,6 +352,6 @@ async function ensureNamespacesLoadedImpl(options, namespaces) {
   await Promise.all(namespaces.map((namespace) => ensureOneNamespace(options, namespace)));
 }
 
-export { IcuTranslationProviderMulti, IcuTranslationProviderSingle, ensureNamespacesLoadedImpl, formatLocaleFallbackChain, projectLocales, resolveLocaleTemplate, validateLocaleFallback };
+export { IcuTranslationProviderMulti, IcuTranslationProviderSingle, ensureNamespacesLoadedImpl, formatLocaleFallbackChain, projectLocales, projectNamespacesLocales, resolveLocaleTemplate, validateLocaleFallback };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/deep-freeze.ts","../src/resolve-locale.ts","../src/IcuTranslationProviderSingle.ts","../src/IcuTranslationProviderMulti.ts","../src/project-locales.ts","../src/validation/errors.ts","../src/ensure-namespace.ts"],"names":["IntlMessageFormat"],"mappings":"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","file":"index.js","sourcesContent":["export function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\") {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const child of Object.values(value)) {\n    deepFreeze(child);\n  }\n\n  return value;\n}\n\nexport function cloneAndFreeze<T>(value: T): T {\n  return deepFreeze(structuredClone(value));\n}\n","export type LocaleFallbackMap = Record<string, string | null>;\n\nexport interface ResolvedLocaleTemplate {\n  template: string;\n  resolvedLocale: string;\n  fallbackChain: readonly string[];\n}\n\nexport function validateLocaleFallback(map: LocaleFallbackMap): void {\n  for (const startLocale of Object.keys(map)) {\n    const visited = new Set<string>();\n    let current: string | undefined = startLocale;\n\n    while (current !== undefined) {\n      if (visited.has(current)) {\n        throw new Error(`[i18n] Circular locale fallback detected involving \"${current}\"`);\n      }\n      visited.add(current);\n\n      const next: string | null | undefined = map[current];\n      if (next === undefined || next === null) {\n        break;\n      }\n      current = next;\n    }\n  }\n}\n\nexport function resolveLocaleTemplate(\n  localeByKey: Record<string, string | undefined> | undefined,\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): ResolvedLocaleTemplate | undefined {\n  const chain: string[] = [requestedLocale];\n  let currentLocale = requestedLocale;\n\n  while (true) {\n    const template = localeByKey?.[currentLocale];\n    if (template !== undefined) {\n      return { template, resolvedLocale: currentLocale, fallbackChain: chain };\n    }\n\n    if (!fallbackMap) {\n      return undefined;\n    }\n\n    const fallback = fallbackMap[currentLocale];\n    if (fallback === undefined || fallback === null) {\n      return undefined;\n    }\n\n    if (chain.includes(fallback)) {\n      throw new Error(\n        `[i18n] Circular locale fallback detected: ${[...chain, fallback].join(\" → \")}`\n      );\n    }\n\n    chain.push(fallback);\n    currentLocale = fallback;\n  }\n}\n\nexport function formatLocaleFallbackChain(\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): string {\n  if (!fallbackMap) {\n    return requestedLocale;\n  }\n\n  const chain: string[] = [requestedLocale];\n  let current = requestedLocale;\n\n  while (true) {\n    const fallback = fallbackMap[current];\n    if (fallback === undefined || fallback === null) {\n      break;\n    }\n    if (chain.includes(fallback)) {\n      chain.push(fallback);\n      break;\n    }\n    chain.push(fallback);\n    current = fallback;\n  }\n\n  return chain.join(\" → \");\n}\n","import { IntlMessageFormat } from \"intl-messageformat\";\nimport { cloneAndFreeze } from \"./deep-freeze.js\";\nimport {\n  formatLocaleFallbackChain,\n  resolveLocaleTemplate,\n  validateLocaleFallback,\n} from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  KeyDictionary,\n  LocaleFallbackMap,\n  LocaleOfSingle,\n  SingleCompiledCache,\n} from \"./types.js\";\n\nexport interface TranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n}\n\nexport interface TranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n> {\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderSingleForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  setAll(values: Schema): void;\n}\n\nexport class IcuTranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderSingleForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderSingle<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    return (\n      this.provider.get as (\n        key: K,\n        locale: Locale,\n        ...params: Params[K] extends never ? [] : [params: Params[K]]\n      ) => string\n    )(key, this.locale, ...args);\n  }\n}\n\nexport class IcuTranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderSingle<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: SingleCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n\n  constructor(dictionary: Schema, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary);\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n  }\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    const params = args[0] as Record<string, unknown> | undefined;\n    const resolved = resolveLocaleTemplate(this.dictionary[key], locale, this.localeFallback);\n\n    if (!resolved) {\n      const chain = formatLocaleFallbackChain(locale, this.localeFallback);\n      throw new Error(\n        `[i18n] Missing key or locale: \"${String(key)}\" [${locale}] (fallback chain: ${chain})`\n      );\n    }\n\n    const { template, resolvedLocale } = resolved;\n\n    if (!this.compiledCache[resolvedLocale]) {\n      this.compiledCache[resolvedLocale] = {};\n    }\n\n    const cacheKey = String(key);\n\n    if (!this.compiledCache[resolvedLocale][cacheKey]) {\n      try {\n        this.compiledCache[resolvedLocale][cacheKey] = new IntlMessageFormat(\n          template,\n          resolvedLocale\n        );\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        throw new Error(\n          `[i18n ICU Syntax Error] Dictionary error for key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n        );\n      }\n    }\n\n    try {\n      return this.compiledCache[resolvedLocale][cacheKey].format(params) as string;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new Error(\n        `[i18n Formatting Error] Invalid or missing parameters for key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n      );\n    }\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderSingleForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderSingleForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n  }\n}\n","import { IntlMessageFormat } from \"intl-messageformat\";\nimport { cloneAndFreeze } from \"./deep-freeze.js\";\nimport {\n  formatLocaleFallbackChain,\n  resolveLocaleTemplate,\n  validateLocaleFallback,\n} from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  LocaleFallbackMap,\n  LocaleOfMulti,\n  MultiCompiledCache,\n  MultiDictionary,\n} from \"./types.js\";\n\nexport interface TranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n}\n\nexport interface TranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n> {\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderMultiForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;\n  setAll(values: Schema): void;\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;\n}\n\nexport class IcuTranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderMultiForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderMulti<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    return (\n      this.provider.get as <\n        NS extends keyof Schema,\n        K extends keyof Schema[NS] & keyof Params[NS] & string,\n      >(\n        namespace: NS,\n        key: K,\n        locale: Locale,\n        ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n      ) => string\n    )(namespace, key, this.locale, ...args);\n  }\n}\n\nexport class IcuTranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderMulti<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: MultiCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n  private loadedNamespaces: Set<string>;\n\n  constructor(dictionary: Partial<Schema>, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary) as Schema;\n    this.loadedNamespaces = new Set(Object.keys(dictionary));\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n  }\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    if (!this.loadedNamespaces.has(namespace as string)) {\n      throw new Error(\n        `[i18n] Namespace not loaded: \"${String(namespace)}\". Call ensureNamespacesLoaded(i18n, [\"${String(namespace)}\"]) first.`\n      );\n    }\n\n    const params = args[0] as Record<string, unknown> | undefined;\n    const localeByKey = (\n      this.dictionary[namespace as string] as Record<string, Record<string, string>>\n    )?.[key];\n    const resolved = resolveLocaleTemplate(localeByKey, locale, this.localeFallback);\n\n    if (!resolved) {\n      const chain = formatLocaleFallbackChain(locale, this.localeFallback);\n      throw new Error(\n        `[i18n] Missing key or locale: namespace \"${String(namespace)}\", key \"${String(key)}\" [${locale}] (fallback chain: ${chain})`\n      );\n    }\n\n    const { template, resolvedLocale } = resolved;\n\n    if (!this.compiledCache[resolvedLocale]) {\n      this.compiledCache[resolvedLocale] = {};\n    }\n\n    if (!this.compiledCache[resolvedLocale][namespace as string]) {\n      this.compiledCache[resolvedLocale][namespace as string] = {};\n    }\n\n    const namespaceCache = this.compiledCache[resolvedLocale][namespace as string]!;\n    const cacheKey = String(key);\n\n    if (!namespaceCache[cacheKey]) {\n      try {\n        namespaceCache[cacheKey] = new IntlMessageFormat(template, resolvedLocale);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        throw new Error(\n          `[i18n ICU Syntax Error] namespace \"${String(namespace)}\", key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n        );\n      }\n    }\n\n    try {\n      return namespaceCache[cacheKey].format(params) as string;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new Error(\n        `[i18n Formatting Error] namespace \"${String(namespace)}\", key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n      );\n    }\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderMultiForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderMultiForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean {\n    return this.loadedNamespaces.has(namespace);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n    this.loadedNamespaces = new Set(Object.keys(values));\n  }\n\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void {\n    this.dictionary = {\n      ...this.dictionary,\n      [namespace]: structuredClone(values),\n    };\n    this.loadedNamespaces.add(namespace as string);\n\n    for (const locale of Object.keys(this.compiledCache)) {\n      delete this.compiledCache[locale]?.[namespace as string];\n    }\n  }\n}\n","import { resolveLocaleTemplate } from \"./resolve-locale.js\";\nimport type { KeyDictionary, LocaleFallbackMap } from \"./types.js\";\n\n/**\n * Builds a dictionary that contains only the requested locales.\n * For each key and target locale, copies the direct template when present;\n * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).\n */\nexport function projectLocales(\n  dictionary: KeyDictionary,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): KeyDictionary {\n  const targetLocales = [...new Set(locales)];\n  const result: KeyDictionary = {};\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] = projected;\n    }\n  }\n\n  return result;\n}\n","import type { ValidationIssue, ValidationResult } from \"./types.js\";\n\nfunction issueMessage(issue: ValidationIssue): string {\n  switch (issue.kind) {\n    case \"missing_key\":\n      return `Missing required key at ${issue.path.join(\".\")}`;\n    case \"invalid_input\":\n    case \"invalid_locale_value\":\n    case \"icu_syntax_error\":\n    case \"locale_args_mismatch\":\n    case \"variable_mismatch\":\n    case \"variable_type_mismatch\":\n      return issue.message;\n  }\n}\n\nexport function formatIssues(issues: readonly ValidationIssue[]): string {\n  return issues\n    .map((issue) => {\n      if (\"path\" in issue && issue.path.length > 0) {\n        return `[${issue.path.join(\".\")}] ${issue.kind}: ${issueMessage(issue)}`;\n      }\n      return `${issue.kind}: ${issueMessage(issue)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport class DictionaryValidationError extends Error {\n  constructor(public readonly issues: readonly ValidationIssue[]) {\n    super(formatIssues(issues));\n    this.name = \"DictionaryValidationError\";\n  }\n}\n\nexport function assertValidDictionary<T>(\n  result: ValidationResult<T>\n): asserts result is { ok: true; data: T } {\n  if (!result.ok) {\n    throw new DictionaryValidationError(result.issues);\n  }\n}\n","import type { MultiDictionary } from \"./types.js\";\nimport type { ValidationResult } from \"./validation/types.js\";\nimport { DictionaryValidationError } from \"./validation/errors.js\";\n\nexport interface EnsureNamespacesLoadedOptions<\n  Schema extends MultiDictionary,\n  NS extends keyof Schema & string,\n> {\n  provider: Pick<\n    { hasNamespace(namespace: NS): boolean; setNamespace(namespace: NS, values: Schema[NS]): void },\n    \"hasNamespace\" | \"setNamespace\"\n  >;\n  resolveLoader: (namespace: NS) => () => Promise<unknown>;\n  validate: (namespace: NS, raw: unknown) => ValidationResult<Schema[NS]>;\n}\n\nconst inFlightByProvider = new WeakMap<object, Map<string, Promise<void>>>();\n\nasync function ensureOneNamespace<Schema extends MultiDictionary, NS extends keyof Schema & string>(\n  options: EnsureNamespacesLoadedOptions<Schema, NS>,\n  namespace: NS\n): Promise<void> {\n  if (options.provider.hasNamespace(namespace)) {\n    return;\n  }\n\n  const providerKey = options.provider as object;\n  let inFlight = inFlightByProvider.get(providerKey);\n  if (!inFlight) {\n    inFlight = new Map();\n    inFlightByProvider.set(providerKey, inFlight);\n  }\n\n  const existing = inFlight.get(namespace);\n  if (existing) {\n    return existing;\n  }\n\n  const promise = (async () => {\n    try {\n      if (options.provider.hasNamespace(namespace)) {\n        return;\n      }\n\n      const raw = await options.resolveLoader(namespace)();\n      const result = options.validate(namespace, raw);\n      if (!result.ok) {\n        throw new DictionaryValidationError(result.issues);\n      }\n\n      options.provider.setNamespace(namespace, result.data);\n    } finally {\n      inFlight!.delete(namespace);\n    }\n  })();\n\n  inFlight.set(namespace, promise);\n  return promise;\n}\n\nexport async function ensureNamespacesLoadedImpl<\n  Schema extends MultiDictionary,\n  NS extends keyof Schema & string,\n>(options: EnsureNamespacesLoadedOptions<Schema, NS>, namespaces: NS[]): Promise<void> {\n  if (namespaces.length === 0) {\n    return;\n  }\n\n  await Promise.all(namespaces.map((namespace) => ensureOneNamespace(options, namespace)));\n}\n"]}
+{"version":3,"sources":["../src/deep-freeze.ts","../src/resolve-locale.ts","../src/IcuTranslationProviderSingle.ts","../src/IcuTranslationProviderMulti.ts","../src/project-locales.ts","../src/validation/errors.ts","../src/ensure-namespace.ts"],"names":["IntlMessageFormat"],"mappings":"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","file":"index.js","sourcesContent":["export function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\") {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const child of Object.values(value)) {\n    deepFreeze(child);\n  }\n\n  return value;\n}\n\nexport function cloneAndFreeze<T>(value: T): T {\n  return deepFreeze(structuredClone(value));\n}\n","export type LocaleFallbackMap = Record<string, string | null>;\n\nexport interface ResolvedLocaleTemplate {\n  template: string;\n  resolvedLocale: string;\n  fallbackChain: readonly string[];\n}\n\nexport function validateLocaleFallback(map: LocaleFallbackMap): void {\n  for (const startLocale of Object.keys(map)) {\n    const visited = new Set<string>();\n    let current: string | undefined = startLocale;\n\n    while (current !== undefined) {\n      if (visited.has(current)) {\n        throw new Error(`[i18n] Circular locale fallback detected involving \"${current}\"`);\n      }\n      visited.add(current);\n\n      const next: string | null | undefined = map[current];\n      if (next === undefined || next === null) {\n        break;\n      }\n      current = next;\n    }\n  }\n}\n\nexport function resolveLocaleTemplate(\n  localeByKey: Record<string, string | undefined> | undefined,\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): ResolvedLocaleTemplate | undefined {\n  const chain: string[] = [requestedLocale];\n  let currentLocale = requestedLocale;\n\n  while (true) {\n    const template = localeByKey?.[currentLocale];\n    if (template !== undefined) {\n      return { template, resolvedLocale: currentLocale, fallbackChain: chain };\n    }\n\n    if (!fallbackMap) {\n      return undefined;\n    }\n\n    const fallback = fallbackMap[currentLocale];\n    if (fallback === undefined || fallback === null) {\n      return undefined;\n    }\n\n    if (chain.includes(fallback)) {\n      throw new Error(\n        `[i18n] Circular locale fallback detected: ${[...chain, fallback].join(\" → \")}`\n      );\n    }\n\n    chain.push(fallback);\n    currentLocale = fallback;\n  }\n}\n\nexport function formatLocaleFallbackChain(\n  requestedLocale: string,\n  fallbackMap?: LocaleFallbackMap\n): string {\n  if (!fallbackMap) {\n    return requestedLocale;\n  }\n\n  const chain: string[] = [requestedLocale];\n  let current = requestedLocale;\n\n  while (true) {\n    const fallback = fallbackMap[current];\n    if (fallback === undefined || fallback === null) {\n      break;\n    }\n    if (chain.includes(fallback)) {\n      chain.push(fallback);\n      break;\n    }\n    chain.push(fallback);\n    current = fallback;\n  }\n\n  return chain.join(\" → \");\n}\n","import { IntlMessageFormat } from \"intl-messageformat\";\nimport { cloneAndFreeze } from \"./deep-freeze.js\";\nimport {\n  formatLocaleFallbackChain,\n  resolveLocaleTemplate,\n  validateLocaleFallback,\n} from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  KeyDictionary,\n  LocaleFallbackMap,\n  LocaleOfSingle,\n  SingleCompiledCache,\n} from \"./types.js\";\n\nexport interface TranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n}\n\nexport interface TranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n> {\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[K] extends never ? [] : [params: Params[K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderSingleForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  setAll(values: Schema): void;\n}\n\nexport class IcuTranslationProviderSingleForLocale<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderSingleForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderSingle<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    return (\n      this.provider.get as (\n        key: K,\n        locale: Locale,\n        ...params: Params[K] extends never ? [] : [params: Params[K]]\n      ) => string\n    )(key, this.locale, ...args);\n  }\n}\n\nexport class IcuTranslationProviderSingle<\n  Schema extends KeyDictionary,\n  Params extends { [K in keyof Schema]: unknown },\n  RequestLocales extends string = LocaleOfSingle<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderSingle<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: SingleCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n\n  constructor(dictionary: Schema, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary);\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n  }\n\n  get<K extends keyof Schema & string>(\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[K] extends never ? [] : [params: Params[K]]\n  ): string {\n    const params = args[0] as Record<string, unknown> | undefined;\n    const resolved = resolveLocaleTemplate(this.dictionary[key], locale, this.localeFallback);\n\n    if (!resolved) {\n      const chain = formatLocaleFallbackChain(locale, this.localeFallback);\n      throw new Error(\n        `[i18n] Missing key or locale: \"${String(key)}\" [${locale}] (fallback chain: ${chain})`\n      );\n    }\n\n    const { template, resolvedLocale } = resolved;\n\n    if (!this.compiledCache[resolvedLocale]) {\n      this.compiledCache[resolvedLocale] = {};\n    }\n\n    const cacheKey = String(key);\n\n    if (!this.compiledCache[resolvedLocale][cacheKey]) {\n      try {\n        this.compiledCache[resolvedLocale][cacheKey] = new IntlMessageFormat(\n          template,\n          resolvedLocale\n        );\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        throw new Error(\n          `[i18n ICU Syntax Error] Dictionary error for key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n        );\n      }\n    }\n\n    try {\n      return this.compiledCache[resolvedLocale][cacheKey].format(params) as string;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new Error(\n        `[i18n Formatting Error] Invalid or missing parameters for key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n      );\n    }\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderSingleForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderSingleForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n  }\n}\n","import { IntlMessageFormat } from \"intl-messageformat\";\nimport { cloneAndFreeze } from \"./deep-freeze.js\";\nimport {\n  formatLocaleFallbackChain,\n  resolveLocaleTemplate,\n  validateLocaleFallback,\n} from \"./resolve-locale.js\";\nimport type {\n  IcuTranslationProviderOptions,\n  LocaleFallbackMap,\n  LocaleOfMulti,\n  MultiCompiledCache,\n  MultiDictionary,\n} from \"./types.js\";\n\nexport interface TranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  Locale extends string,\n> {\n  readonly locale: Locale;\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n}\n\nexport interface TranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n> {\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string;\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): TranslationProviderMultiForLocale<Schema, Params, Locale>;\n  getAll(): Schema;\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;\n  setAll(values: Schema): void;\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;\n}\n\nexport class IcuTranslationProviderMultiForLocale<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string,\n  Locale extends RequestLocales,\n  Fallback extends LocaleFallbackMap | undefined,\n> implements TranslationProviderMultiForLocale<Schema, Params, Locale> {\n  constructor(\n    private readonly provider: IcuTranslationProviderMulti<\n      Schema,\n      Params,\n      RequestLocales,\n      Fallback\n    >,\n    readonly locale: Locale\n  ) {}\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    return (\n      this.provider.get as <\n        NS extends keyof Schema,\n        K extends keyof Schema[NS] & keyof Params[NS] & string,\n      >(\n        namespace: NS,\n        key: K,\n        locale: Locale,\n        ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n      ) => string\n    )(namespace, key, this.locale, ...args);\n  }\n}\n\nexport class IcuTranslationProviderMulti<\n  Schema extends MultiDictionary,\n  Params extends { [NS in keyof Schema]: { [K in keyof Schema[NS]]: unknown } },\n  RequestLocales extends string = LocaleOfMulti<Schema>,\n  Fallback extends LocaleFallbackMap | undefined = undefined,\n> implements TranslationProviderMulti<Schema, Params, RequestLocales> {\n  private dictionary: Schema;\n  private compiledCache: MultiCompiledCache = {};\n  private readonly localeFallback?: Fallback;\n  private loadedNamespaces: Set<string>;\n\n  constructor(dictionary: Partial<Schema>, options?: IcuTranslationProviderOptions<Fallback>) {\n    this.dictionary = structuredClone(dictionary) as Schema;\n    this.loadedNamespaces = new Set(Object.keys(dictionary));\n    if (options?.localeFallback) {\n      validateLocaleFallback(options.localeFallback);\n      this.localeFallback = options.localeFallback;\n    }\n  }\n\n  get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(\n    namespace: NS,\n    key: K,\n    locale: RequestLocales,\n    ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]\n  ): string {\n    if (!this.loadedNamespaces.has(namespace as string)) {\n      throw new Error(\n        `[i18n] Namespace not loaded: \"${String(namespace)}\". Call ensureNamespacesLoaded(i18n, [\"${String(namespace)}\"]) first.`\n      );\n    }\n\n    const params = args[0] as Record<string, unknown> | undefined;\n    const localeByKey = (\n      this.dictionary[namespace as string] as Record<string, Record<string, string>>\n    )?.[key];\n    const resolved = resolveLocaleTemplate(localeByKey, locale, this.localeFallback);\n\n    if (!resolved) {\n      const chain = formatLocaleFallbackChain(locale, this.localeFallback);\n      throw new Error(\n        `[i18n] Missing key or locale: namespace \"${String(namespace)}\", key \"${String(key)}\" [${locale}] (fallback chain: ${chain})`\n      );\n    }\n\n    const { template, resolvedLocale } = resolved;\n\n    if (!this.compiledCache[resolvedLocale]) {\n      this.compiledCache[resolvedLocale] = {};\n    }\n\n    if (!this.compiledCache[resolvedLocale][namespace as string]) {\n      this.compiledCache[resolvedLocale][namespace as string] = {};\n    }\n\n    const namespaceCache = this.compiledCache[resolvedLocale][namespace as string]!;\n    const cacheKey = String(key);\n\n    if (!namespaceCache[cacheKey]) {\n      try {\n        namespaceCache[cacheKey] = new IntlMessageFormat(template, resolvedLocale);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        throw new Error(\n          `[i18n ICU Syntax Error] namespace \"${String(namespace)}\", key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n        );\n      }\n    }\n\n    try {\n      return namespaceCache[cacheKey].format(params) as string;\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      throw new Error(\n        `[i18n Formatting Error] namespace \"${String(namespace)}\", key \"${String(key)}\" [${resolvedLocale}]: ${message}`\n      );\n    }\n  }\n\n  forLocale<Locale extends RequestLocales>(\n    locale: Locale\n  ): IcuTranslationProviderMultiForLocale<Schema, Params, RequestLocales, Locale, Fallback> {\n    return new IcuTranslationProviderMultiForLocale(this, locale);\n  }\n\n  getAll(): Schema {\n    return cloneAndFreeze(this.dictionary);\n  }\n\n  hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean {\n    return this.loadedNamespaces.has(namespace);\n  }\n\n  setAll(values: Schema): void {\n    this.dictionary = structuredClone(values);\n    this.compiledCache = {};\n    this.loadedNamespaces = new Set(Object.keys(values));\n  }\n\n  setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void {\n    this.dictionary = {\n      ...this.dictionary,\n      [namespace]: structuredClone(values),\n    };\n    this.loadedNamespaces.add(namespace as string);\n\n    for (const locale of Object.keys(this.compiledCache)) {\n      delete this.compiledCache[locale]?.[namespace as string];\n    }\n  }\n}\n","import { resolveLocaleTemplate } from \"./resolve-locale.js\";\nimport type { KeyDictionary, LocaleFallbackMap, MultiDictionary } from \"./types.js\";\n\nfunction projectKeyDictionary<T extends KeyDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const targetLocales = [...new Set(locales)];\n  const result = {} as T;\n\n  for (const [key, localesByKey] of Object.entries(dictionary)) {\n    const projected: Record<string, string> = {};\n\n    for (const locale of targetLocales) {\n      const resolved = resolveLocaleTemplate(localesByKey, locale, localeFallback);\n      if (resolved !== undefined) {\n        projected[locale] = resolved.template;\n      }\n    }\n\n    if (Object.keys(projected).length > 0) {\n      result[key as keyof T] = projected as T[keyof T];\n    }\n  }\n\n  return result;\n}\n\n/**\n * Builds a dictionary that contains only the requested locales.\n * For each key and target locale, copies the direct template when present;\n * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).\n */\nexport function projectLocales<T extends KeyDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  return projectKeyDictionary(dictionary, locales, localeFallback);\n}\n\n/**\n * Projects every namespace in a multi-namespace dictionary.\n */\nexport function projectNamespacesLocales<T extends MultiDictionary>(\n  dictionary: T,\n  locales: readonly string[],\n  localeFallback?: LocaleFallbackMap\n): T {\n  const result = {} as T;\n\n  for (const namespace of Object.keys(dictionary) as (keyof T & string)[]) {\n    const namespaceDictionary = dictionary[namespace];\n    if (namespaceDictionary === undefined) {\n      continue;\n    }\n\n    result[namespace] = projectKeyDictionary(\n      namespaceDictionary,\n      locales,\n      localeFallback\n    ) as T[typeof namespace];\n  }\n\n  return result;\n}\n","import type { ValidationIssue, ValidationResult } from \"./types.js\";\n\nfunction issueMessage(issue: ValidationIssue): string {\n  switch (issue.kind) {\n    case \"missing_key\":\n      return `Missing required key at ${issue.path.join(\".\")}`;\n    case \"invalid_input\":\n    case \"invalid_locale_value\":\n    case \"icu_syntax_error\":\n    case \"locale_args_mismatch\":\n    case \"variable_mismatch\":\n    case \"variable_type_mismatch\":\n      return issue.message;\n  }\n}\n\nexport function formatIssues(issues: readonly ValidationIssue[]): string {\n  return issues\n    .map((issue) => {\n      if (\"path\" in issue && issue.path.length > 0) {\n        return `[${issue.path.join(\".\")}] ${issue.kind}: ${issueMessage(issue)}`;\n      }\n      return `${issue.kind}: ${issueMessage(issue)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport class DictionaryValidationError extends Error {\n  constructor(public readonly issues: readonly ValidationIssue[]) {\n    super(formatIssues(issues));\n    this.name = \"DictionaryValidationError\";\n  }\n}\n\nexport function assertValidDictionary<T>(\n  result: ValidationResult<T>\n): asserts result is { ok: true; data: T } {\n  if (!result.ok) {\n    throw new DictionaryValidationError(result.issues);\n  }\n}\n","import type { MultiDictionary } from \"./types.js\";\nimport type { ValidationResult } from \"./validation/types.js\";\nimport { DictionaryValidationError } from \"./validation/errors.js\";\n\nexport interface EnsureNamespacesLoadedOptions<\n  Schema extends MultiDictionary,\n  NS extends keyof Schema & string,\n> {\n  provider: Pick<\n    { hasNamespace(namespace: NS): boolean; setNamespace(namespace: NS, values: Schema[NS]): void },\n    \"hasNamespace\" | \"setNamespace\"\n  >;\n  resolveLoader: (namespace: NS) => () => Promise<unknown>;\n  validate: (namespace: NS, raw: unknown) => ValidationResult<Schema[NS]>;\n}\n\nconst inFlightByProvider = new WeakMap<object, Map<string, Promise<void>>>();\n\nasync function ensureOneNamespace<Schema extends MultiDictionary, NS extends keyof Schema & string>(\n  options: EnsureNamespacesLoadedOptions<Schema, NS>,\n  namespace: NS\n): Promise<void> {\n  if (options.provider.hasNamespace(namespace)) {\n    return;\n  }\n\n  const providerKey = options.provider as object;\n  let inFlight = inFlightByProvider.get(providerKey);\n  if (!inFlight) {\n    inFlight = new Map();\n    inFlightByProvider.set(providerKey, inFlight);\n  }\n\n  const existing = inFlight.get(namespace);\n  if (existing) {\n    return existing;\n  }\n\n  const promise = (async () => {\n    try {\n      if (options.provider.hasNamespace(namespace)) {\n        return;\n      }\n\n      const raw = await options.resolveLoader(namespace)();\n      const result = options.validate(namespace, raw);\n      if (!result.ok) {\n        throw new DictionaryValidationError(result.issues);\n      }\n\n      options.provider.setNamespace(namespace, result.data);\n    } finally {\n      inFlight!.delete(namespace);\n    }\n  })();\n\n  inFlight.set(namespace, promise);\n  return promise;\n}\n\nexport async function ensureNamespacesLoadedImpl<\n  Schema extends MultiDictionary,\n  NS extends keyof Schema & string,\n>(options: EnsureNamespacesLoadedOptions<Schema, NS>, namespaces: NS[]): Promise<void> {\n  if (namespaces.length === 0) {\n    return;\n  }\n\n  await Promise.all(namespaces.map((namespace) => ensureOneNamespace(options, namespace)));\n}\n"]}

package/package.json

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

package/src/audit/audit-dictionaries.ts

@@ -1,7 +1,8 @@
 import path from "node:path";
-import type { CodegenConfig, DictionaryJson } from "../codegen/types.js";
+import type { DictionaryJson } from "../codegen/types.js";
 import { buildRequiredLocales, enrichLocaleFallback } from "../codegen/locale-policy.js";
 import { resolveLocaleTemplate } from "../resolve-locale.js";
+import { CodegenConfig } from "../codegen/codegen-config-schema.js";
 
 export type FailOnCriterion = "effective" | "direct" | "any";
 
@@ -105,7 +106,7 @@ export function auditDictionaries(options: AuditDictionariesOptions): I18nAuditR
 
   return {
     requiredLocales,
-    localeFallback: localeFallbackForAudit,
+    ...(localeFallbackForAudit !== undefined ? { localeFallback: localeFallbackForAudit } : {}),
     summary,
     missingDirectByLocale,
     missingEffectiveByLocale,
@@ -162,7 +163,9 @@ export async function runAuditFromConfig(options: RunAuditOptions): Promise<RunA
   const report = auditDictionaries({
     namespaces,
     config,
-    treatEmptyAsMissing: options.treatEmptyAsMissing,
+    ...(options.treatEmptyAsMissing !== undefined
+      ? { treatEmptyAsMissing: options.treatEmptyAsMissing }
+      : {}),
   });
 
   const exitCode =

package/src/audit/run-audit.ts

@@ -37,7 +37,12 @@ export function parseAuditArgs(argv: string[]): AuditCliOptions {
 
   const treatEmptyAsMissing = !argv.includes("--allow-empty");
 
-  return { configPath, outPath, failOn, treatEmptyAsMissing };
+  return {
+    configPath,
+    treatEmptyAsMissing,
+    ...(outPath !== undefined ? { outPath } : {}),
+    ...(failOn !== undefined ? { failOn } : {}),
+  };
 }
 
 export async function runAuditCli(argv = process.argv.slice(2)): Promise<number> {
@@ -56,7 +61,7 @@ export async function runAuditCli(argv = process.argv.slice(2)): Promise<number>
     config,
     configPath: options.configPath,
     treatEmptyAsMissing: options.treatEmptyAsMissing,
-    failOn: options.failOn,
+    ...(options.failOn !== undefined ? { failOn: options.failOn } : {}),
   });
 
   const json = `${JSON.stringify(report, null, 2)}\n`;

package/src/codegen/codegen-config-schema.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { SUPPORTED_IMPORT_EXTENSIONS } from "./constants.js";
+
+const localeFallbackSchema = z.record(z.string(), z.union([z.string(), z.null()]));
+
+const codegenConfigShape = {
+  dictionary: z.string().min(1).optional(),
+  namespaces: z.record(z.string(), z.string().min(1)).optional(),
+  defaultNamespace: z.string().min(1).optional(),
+  typesOutput: z.string().min(1),
+  dictionaryOutput: z.string().min(1),
+  instanceOutput: z.string().min(1),
+  dictionarySchemaOutput: z.string().min(1).optional(),
+  loadOnInit: z.array(z.string().min(1)).optional(),
+  namespaceLoadersOutput: z.string().min(1).optional(),
+  importExtension: z.enum(SUPPORTED_IMPORT_EXTENSIONS).optional(),
+  paramsTypeName: z.string().min(1),
+  schemaTypeName: z.string().min(1),
+  localeTypeName: z.string().min(1).optional(),
+  localeFallbackConstName: z.string().min(1).optional(),
+  localeFallback: localeFallbackSchema.optional(),
+  factoryName: z.string().min(1).optional(),
+};
+
+export const codegenConfigKeys = Object.keys(
+  codegenConfigShape
+) as (keyof typeof codegenConfigShape)[];
+
+export const codegenConfigSchema = z
+  .object(codegenConfigShape)
+  .strict()
+  .superRefine((config, ctx) => {
+    const hasDictionary = config.dictionary !== undefined;
+    const hasNamespaces = config.namespaces !== undefined;
+
+    if (hasDictionary === hasNamespaces) {
+      ctx.addIssue({
+        code: "custom",
+        message: 'Specify exactly one of "dictionary" or "namespaces".',
+      });
+    }
+  });
+
+export type CodegenConfig = z.infer<typeof codegenConfigSchema>;
+
+export function formatCodegenConfigIssues(error: z.ZodError): string {
+  const issueLines = error.issues.map((issue) => {
+    const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+    return `  - ${path}: ${issue.message}`;
+  });
+
+  return [
+    "[Codegen Error] Invalid i18n.codegen.json:",
+    ...issueLines,
+    "",
+    `Allowed keys: ${codegenConfigKeys.join(", ")}`,
+  ].join("\n");
+}

package/src/codegen/config.test.ts

@@ -0,0 +1,106 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { codegenConfigKeys } from "./codegen-config-schema.js";
+import { loadConfig } from "./config.js";
+
+function writeConfig(dir: string, config: Record<string, unknown>) {
+  const configPath = join(dir, "i18n.codegen.json");
+  writeFileSync(configPath, JSON.stringify(config, null, 2));
+  return configPath;
+}
+
+const validMultiConfig = {
+  namespaces: {
+    default: "translations/default.json",
+  },
+  typesOutput: "generated/i18n-types.generated.ts",
+  dictionaryOutput: "generated/dictionary.generated.ts",
+  instanceOutput: "generated/instance.generated.ts",
+  paramsTypeName: "AppParams",
+  schemaTypeName: "AppSchema",
+};
+
+describe("loadConfig", () => {
+  let tempDir: string;
+
+  afterEach(() => {
+    if (tempDir) {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  it("accepts a valid multi-namespace config", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-config-"));
+    const configPath = writeConfig(tempDir, validMultiConfig);
+
+    expect(loadConfig(configPath)).toEqual(validMultiConfig);
+  });
+
+  it("fails on unknown top-level keys and reports allowed keys", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-config-"));
+    const configPath = writeConfig(tempDir, {
+      ...validMultiConfig,
+      typoKey: true,
+    });
+
+    const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => {
+      throw new Error("process.exit");
+    }) as typeof process.exit);
+    const errorSpy = vi.spyOn(console, "error").mockImplementation(() => void 0);
+
+    expect(() => loadConfig(configPath)).toThrow("process.exit");
+    expect(errorSpy).toHaveBeenCalled();
+
+    const message = String(errorSpy.mock.calls[0]?.[0]);
+    expect(message).toContain("Invalid i18n.codegen.json");
+    expect(message).toContain("typoKey");
+    expect(message).toContain(`Allowed keys: ${codegenConfigKeys.join(", ")}`);
+
+    exitSpy.mockRestore();
+    errorSpy.mockRestore();
+  });
+
+  it("fails when both dictionary and namespaces are present", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-config-"));
+    const configPath = writeConfig(tempDir, {
+      ...validMultiConfig,
+      dictionary: "translations/default.json",
+    });
+
+    const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => {
+      throw new Error("process.exit");
+    }) as typeof process.exit);
+    const errorSpy = vi.spyOn(console, "error").mockImplementation(() => void 0);
+
+    expect(() => loadConfig(configPath)).toThrow("process.exit");
+
+    const message = String(errorSpy.mock.calls[0]?.[0]);
+    expect(message).toContain('Specify exactly one of "dictionary" or "namespaces".');
+
+    exitSpy.mockRestore();
+    errorSpy.mockRestore();
+  });
+
+  it("fails when required fields are missing", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-config-"));
+    const configPath = writeConfig(tempDir, {
+      namespaces: validMultiConfig.namespaces,
+    });
+
+    const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => {
+      throw new Error("process.exit");
+    }) as typeof process.exit);
+    const errorSpy = vi.spyOn(console, "error").mockImplementation(() => void 0);
+
+    expect(() => loadConfig(configPath)).toThrow("process.exit");
+
+    const message = String(errorSpy.mock.calls[0]?.[0]);
+    expect(message).toContain("typesOutput");
+    expect(message).toContain("Allowed keys:");
+
+    exitSpy.mockRestore();
+    errorSpy.mockRestore();
+  });
+});

package/src/codegen/config.ts

@@ -1,10 +1,28 @@
 import fs from "node:fs";
-import type { CodegenConfig, LoadOnInitResolution, NamespaceEntry } from "./types.js";
+import type { LoadOnInitResolution, NamespaceEntry } from "./types.js";
+import {
+  CodegenConfig,
+  codegenConfigSchema,
+  formatCodegenConfigIssues,
+} from "./codegen-config-schema.js";
 import { fail } from "./paths.js";
 
 export function loadConfig(configPath: string): CodegenConfig {
-  const raw = fs.readFileSync(configPath, "utf8");
-  return JSON.parse(raw) as CodegenConfig;
+  let raw: unknown;
+
+  try {
+    raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    fail(`[Codegen Error] Failed to parse config JSON (${configPath}): ${message}`);
+  }
+
+  const result = codegenConfigSchema.safeParse(raw);
+  if (!result.success) {
+    fail(formatCodegenConfigIssues(result.error));
+  }
+
+  return result.data;
 }
 
 export function resolveNamespaces(config: CodegenConfig): NamespaceEntry[] {

package/src/codegen/constants.ts

@@ -0,0 +1 @@
+export const SUPPORTED_IMPORT_EXTENSIONS = ["none", ".ts", ".js"] as const;

package/src/codegen/emit/instance-file.ts

@@ -13,6 +13,7 @@ export interface InstanceFileOptions {
   factoryName: string;
   hasLocaleFallback: boolean;
   hasLocaleType: boolean;
+  namespaceNames: string[];
   importExtension: ImportExtension;
 }
 
@@ -29,6 +30,7 @@ export function formatInstanceFile(options: InstanceFileOptions): string {
     factoryName,
     hasLocaleFallback,
     hasLocaleType,
+    namespaceNames,
     importExtension,
   } = options;
 
@@ -54,10 +56,27 @@ export function formatInstanceFile(options: InstanceFileOptions): string {
     : "";
   const localesParamType = hasLocaleType ? `readonly ${localeTypeName}[]` : "readonly string[]";
   const projectLocalesFallbackArg = hasLocaleFallback ? `, ${localeFallbackConstName}` : "";
+  const coreImports = isSingle
+    ? "projectLocales as projectLocalesCore"
+    : "projectLocales as projectLocalesCore, projectNamespacesLocales as projectNamespacesLocalesCore";
+  const projectLocalesBlock = isSingle
+    ? `\n` +
+      `export function projectLocales(\n` +
+      `  dictionary: ${schemaTypeName},\n` +
+      `  locales: ${localesParamType},\n` +
+      `): ${schemaTypeName} {\n` +
+      `  return projectLocalesCore(dictionary, locales${projectLocalesFallbackArg});\n` +
+      `}\n`
+    : formatMultiProjectLocalesBlock(
+        schemaTypeName,
+        namespaceNames,
+        localesParamType,
+        projectLocalesFallbackArg
+      );
 
   return (
     `${GENERATED_FILE_BANNER}` +
-    `import { ${providerClass}, projectLocales as projectLocalesCore, type KeyDictionary } from '@xndrjs/i18n';\n` +
+    `import { ${providerClass}, ${coreImports} } from '@xndrjs/i18n';\n` +
     `import { dictionary } from '${dictionaryImport}';\n` +
     initialDictionaryImport +
     typesImportLine +
@@ -67,11 +86,41 @@ export function formatInstanceFile(options: InstanceFileOptions): string {
     `) {\n` +
     `  return new ${providerClass}<${providerTypeArgs}>(initialDictionary${providerOptions});\n` +
     `}\n` +
+    projectLocalesBlock
+  );
+}
+
+function formatMultiProjectLocalesBlock(
+  schemaTypeName: string,
+  namespaceNames: string[],
+  localesParamType: string,
+  projectLocalesFallbackArg: string
+): string {
+  const overloads = namespaceNames
+    .map(
+      (namespace) =>
+        `export function projectNamespaceLocales(\n` +
+        `  dictionary: ${schemaTypeName}["${namespace}"],\n` +
+        `  locales: ${localesParamType},\n` +
+        `): ${schemaTypeName}["${namespace}"];`
+    )
+    .join("\n");
+
+  return (
     `\n` +
     `export function projectLocales(\n` +
-    `  dictionary: KeyDictionary,\n` +
+    `  dictionary: ${schemaTypeName},\n` +
+    `  locales: ${localesParamType},\n` +
+    `): ${schemaTypeName} {\n` +
+    `  return projectNamespacesLocalesCore(dictionary, locales${projectLocalesFallbackArg});\n` +
+    `}\n` +
+    `\n` +
+    overloads +
+    `\n` +
+    `export function projectNamespaceLocales(\n` +
+    `  dictionary: ${schemaTypeName}[keyof ${schemaTypeName}],\n` +
     `  locales: ${localesParamType},\n` +
-    `): KeyDictionary {\n` +
+    `): ${schemaTypeName}[keyof ${schemaTypeName}] {\n` +
     `  return projectLocalesCore(dictionary, locales${projectLocalesFallbackArg});\n` +
     `}\n`
   );

package/src/codegen/fixtures/billing-namespace.json

@@ -0,0 +1,6 @@
+{
+  "invoice_summary": {
+    "en": "You have {count, plural, one {1 invoice} other {{count} invoices}}",
+    "it": "Hai {count, plural, one {1 fattura} other {{count} fatture}}"
+  }
+}

package/src/codegen/generate-i18n-types.test.ts

@@ -74,7 +74,8 @@ describe("generate-i18n-types", () => {
     expect(types).toContain("export type AppLocale = 'en'");
     expect(factory).toContain("export function createI18n(");
     expect(factory).toContain("export function projectLocales(");
-    expect(factory).toContain("locales: readonly AppLocale[]");
+    expect(factory).toContain("projectNamespacesLocalesCore(dictionary, locales)");
+    expect(factory).toContain("export function projectNamespaceLocales(");
     expect(factory).toContain("projectLocalesCore(dictionary, locales)");
     expect(factory).toContain("IcuTranslationProviderMulti");
     expect(types).toContain("login_button: never");
@@ -224,6 +225,10 @@ describe("generate-i18n-types", () => {
     expect(types).toContain("export const I18N_MODE = 'single' as const");
     expect(types).toContain("export type AppLocale = 'en'");
     expect(factory).toContain("export function createI18n(");
+    expect(factory).toContain("export function projectLocales(");
+    expect(factory).toContain("dictionary: AppSchema");
+    expect(factory).not.toContain("projectNamespaceLocales");
+    expect(factory).not.toContain("projectNamespacesLocalesCore");
     expect(factory).toContain("IcuTranslationProviderSingle");
     expect(types).toContain("login_button: never;");
     expect(types).toContain("welcome: { name: string };");
@@ -790,7 +795,10 @@ describe("generate-i18n-types", () => {
 
     const result = runCodegen(tempDir);
     expect(result.status).not.toBe(0);
-    expect(result.stderr).toContain('importExtension must be "none", ".ts", or ".js"');
+    expect(result.stderr).toContain("Invalid i18n.codegen.json");
+    expect(result.stderr).toContain("importExtension");
+    expect(result.stderr).toContain('one of "none"|".ts"|".js"');
+    expect(result.stderr).toContain("Allowed keys:");
   });
 
   it("compiles yaml dictionaries to json and generates json imports", () => {

package/src/codegen/generate-i18n-types.ts

@@ -132,6 +132,7 @@ function main() {
     factoryName,
     hasLocaleFallback: Boolean(config.localeFallback),
     hasLocaleType: Boolean(requestLocaleUnion),
+    namespaceNames: entries.map((entry) => entry.namespace),
     importExtension,
   });
 

package/src/codegen/paths.ts

@@ -1,6 +1,7 @@
 import path from "node:path";
-import type { CodegenConfig, ImportExtension } from "./types.js";
-import { SUPPORTED_IMPORT_EXTENSIONS } from "./types.js";
+import type { ImportExtension } from "./types.js";
+import { SUPPORTED_IMPORT_EXTENSIONS } from "./constants.js";
+import { CodegenConfig } from "./codegen-config-schema.js";
 
 export const GENERATED_FILE_BANNER = "// Automatically generated code. Do not edit manually.\n";
 export const DEFAULT_IMPORT_EXTENSION: ImportExtension = "none";

package/src/codegen/project-locales-set-namespace.test.ts

@@ -0,0 +1,181 @@
+import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { afterEach, describe, expect, expectTypeOf, it } from "vitest";
+import billingDictionary from "./fixtures/billing-namespace.json";
+
+const codegenScript = fileURLToPath(new URL("./generate-i18n-types.ts", import.meta.url));
+const packageRoot = fileURLToPath(new URL("../../", import.meta.url));
+
+type BillingNamespace = typeof billingDictionary;
+
+function runCodegen(cwd: string) {
+  return spawnSync("tsx", [codegenScript, "--config", "i18n.codegen.json"], {
+    cwd,
+    encoding: "utf8",
+    env: process.env,
+  });
+}
+
+function runTsc(projectPath: string) {
+  return spawnSync("pnpm", ["exec", "tsc", "--noEmit", "-p", projectPath], {
+    cwd: packageRoot,
+    encoding: "utf8",
+    env: process.env,
+  });
+}
+
+function setupMultiCodegenFixture(tempDir: string) {
+  const i18nDir = join(tempDir, "src/i18n");
+  const translationsDir = join(i18nDir, "translations");
+  mkdirSync(translationsDir, { recursive: true });
+
+  writeFileSync(
+    join(translationsDir, "default.json"),
+    JSON.stringify({
+      login_button: { en: "Login" },
+    })
+  );
+  writeFileSync(
+    join(translationsDir, "billing.json"),
+    readFileSync(
+      fileURLToPath(new URL("./fixtures/billing-namespace.json", import.meta.url)),
+      "utf8"
+    )
+  );
+
+  writeFileSync(
+    join(tempDir, "i18n.codegen.json"),
+    JSON.stringify({
+      namespaces: {
+        default: "src/i18n/translations/default.json",
+        billing: "src/i18n/translations/billing.json",
+      },
+      typesOutput: "src/i18n/i18n-types.generated.ts",
+      dictionaryOutput: "src/i18n/dictionary.generated.ts",
+      instanceOutput: "src/i18n/instance.generated.ts",
+      paramsTypeName: "AppParams",
+      schemaTypeName: "AppSchema",
+      localeFallback: {
+        en: null,
+        it: "en",
+      },
+    })
+  );
+
+  const codegen = runCodegen(tempDir);
+  expect(codegen.status, codegen.stderr || codegen.stdout).toBe(0);
+}
+
+function writeTscProject(tempDir: string) {
+  writeFileSync(
+    join(tempDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          noEmit: true,
+          resolveJsonModule: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+          paths: {
+            "@xndrjs/i18n": [join(packageRoot, "src/index.ts")],
+          },
+        },
+        include: ["src/**/*.ts"],
+      },
+      null,
+      2
+    )
+  );
+}
+
+describe("codegen projectLocales + setNamespace", () => {
+  describe("generated instance output", () => {
+    let tempDir: string;
+
+    afterEach(() => {
+      if (tempDir) {
+        rmSync(tempDir, { recursive: true, force: true });
+      }
+    });
+
+    it("emits projectNamespaceLocales for multi mode with schema-typed namespace payloads", () => {
+      tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-project-locales-"));
+      setupMultiCodegenFixture(tempDir);
+
+      const factory = readFileSync(join(tempDir, "src/i18n/instance.generated.ts"), "utf8");
+      expect(factory).toContain('dictionary: AppSchema["billing"]');
+      expect(factory).toContain(
+        "projectNamespacesLocalesCore(dictionary, locales, LOCALE_FALLBACK)"
+      );
+    });
+
+    it("passes tsc when hydrating with projectNamespaceLocales before setNamespace", () => {
+      tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-project-locales-"));
+      setupMultiCodegenFixture(tempDir);
+
+      writeFileSync(
+        join(tempDir, "src/hydrate-billing.ts"),
+        [
+          `import { createI18n, projectNamespaceLocales } from "./i18n/instance.generated.js";`,
+          `import billingDictionary from "./i18n/translations/billing.json";`,
+          ``,
+          `const i18n = createI18n();`,
+          `i18n.setNamespace("billing", projectNamespaceLocales(billingDictionary, ["en"]));`,
+        ].join("\n")
+      );
+
+      writeTscProject(tempDir);
+
+      const tsc = runTsc(join(tempDir, "tsconfig.json"));
+      expect(tsc.status, `${tsc.stdout}\n${tsc.stderr}`).toBe(0);
+    });
+
+    it("passes tsc when replacing the full schema with projectLocales before setAll", () => {
+      tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-project-locales-"));
+      setupMultiCodegenFixture(tempDir);
+
+      writeFileSync(
+        join(tempDir, "src/hydrate-all.ts"),
+        [
+          `import { createI18n, projectLocales } from "./i18n/instance.generated.js";`,
+          `import type { AppSchema } from "./i18n/i18n-types.generated.js";`,
+          `import billingDictionary from "./i18n/translations/billing.json";`,
+          `import defaultDictionary from "./i18n/translations/default.json";`,
+          ``,
+          `const fullDictionary = {`,
+          `  default: defaultDictionary,`,
+          `  billing: billingDictionary,`,
+          `} satisfies AppSchema;`,
+          ``,
+          `const i18n = createI18n();`,
+          `i18n.setAll(projectLocales(fullDictionary, ["en"]));`,
+        ].join("\n")
+      );
+
+      writeTscProject(tempDir);
+
+      const tsc = runTsc(join(tempDir, "tsconfig.json"));
+      expect(tsc.status, `${tsc.stdout}\n${tsc.stderr}`).toBe(0);
+    });
+
+    it("types projectNamespaceLocales result as the namespace schema", () => {
+      type AppSchema = {
+        billing: BillingNamespace;
+      };
+
+      type ProjectNamespaceLocalesBilling = (
+        dictionary: AppSchema["billing"],
+        locales: readonly ("en" | "it")[]
+      ) => AppSchema["billing"];
+
+      expectTypeOf<ReturnType<ProjectNamespaceLocalesBilling>>().toEqualTypeOf<BillingNamespace>();
+    });
+  });
+});

package/src/codegen/types.ts

@@ -1,25 +1,6 @@
-export const SUPPORTED_IMPORT_EXTENSIONS = ["none", ".ts", ".js"] as const;
-export type ImportExtension = (typeof SUPPORTED_IMPORT_EXTENSIONS)[number];
+import type { SUPPORTED_IMPORT_EXTENSIONS } from "./constants.js";
 
-export interface CodegenConfig {
-  dictionary?: string;
-  namespaces?: Record<string, string>;
-  defaultNamespace?: string;
-  typesOutput: string;
-  dictionaryOutput: string;
-  instanceOutput: string;
-  dictionarySchemaOutput?: string;
-  loadOnInit?: string[];
-  namespaceLoadersOutput?: string;
-  /** Extension used in relative imports between generated modules. Default: "none" */
-  importExtension?: ImportExtension;
-  paramsTypeName: string;
-  schemaTypeName: string;
-  localeTypeName?: string;
-  localeFallbackConstName?: string;
-  localeFallback?: Record<string, string | null>;
-  factoryName?: string;
-}
+export type ImportExtension = (typeof SUPPORTED_IMPORT_EXTENSIONS)[number];
 
 export interface NamespaceEntry {
   namespace: string;

package/src/index.ts

@@ -28,7 +28,7 @@ export {
 } from "./resolve-locale.js";
 export type { ResolvedLocaleTemplate } from "./resolve-locale.js";
 
-export { projectLocales } from "./project-locales.js";
+export { projectLocales, projectNamespacesLocales } from "./project-locales.js";
 
 export { ensureNamespacesLoadedImpl } from "./ensure-namespace.js";
 export type { EnsureNamespacesLoadedOptions } from "./ensure-namespace.js";

package/src/project-locales.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { projectLocales } from "./project-locales.js";
+import { projectLocales, projectNamespacesLocales } from "./project-locales.js";
 
 describe("projectLocales", () => {
   const dictionary = {
@@ -65,3 +65,21 @@ describe("projectLocales", () => {
     });
   });
 });
+
+describe("projectNamespacesLocales", () => {
+  it("projects each namespace independently", () => {
+    const dictionary = {
+      default: {
+        login_button: { en: "Login", it: "Accedi" },
+      },
+      billing: {
+        invoice_summary: { en: "{count} invoices", it: "{count} fatture" },
+      },
+    };
+
+    expect(projectNamespacesLocales(dictionary, ["en"])).toEqual({
+      default: { login_button: { en: "Login" } },
+      billing: { invoice_summary: { en: "{count} invoices" } },
+    });
+  });
+});

package/src/project-locales.ts

@@ -1,18 +1,13 @@
 import { resolveLocaleTemplate } from "./resolve-locale.js";
-import type { KeyDictionary, LocaleFallbackMap } from "./types.js";
+import type { KeyDictionary, LocaleFallbackMap, MultiDictionary } from "./types.js";
 
-/**
- * Builds a dictionary that contains only the requested locales.
- * For each key and target locale, copies the direct template when present;
- * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).
- */
-export function projectLocales(
-  dictionary: KeyDictionary,
+function projectKeyDictionary<T extends KeyDictionary>(
+  dictionary: T,
   locales: readonly string[],
   localeFallback?: LocaleFallbackMap
-): KeyDictionary {
+): T {
   const targetLocales = [...new Set(locales)];
-  const result: KeyDictionary = {};
+  const result = {} as T;
 
   for (const [key, localesByKey] of Object.entries(dictionary)) {
     const projected: Record<string, string> = {};
@@ -25,8 +20,47 @@ export function projectLocales(
     }
 
     if (Object.keys(projected).length > 0) {
-      result[key] = projected;
+      result[key as keyof T] = projected as T[keyof T];
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Builds a dictionary that contains only the requested locales.
+ * For each key and target locale, copies the direct template when present;
+ * otherwise resolves through `localeFallback` (same rules as `.get()` at runtime).
+ */
+export function projectLocales<T extends KeyDictionary>(
+  dictionary: T,
+  locales: readonly string[],
+  localeFallback?: LocaleFallbackMap
+): T {
+  return projectKeyDictionary(dictionary, locales, localeFallback);
+}
+
+/**
+ * Projects every namespace in a multi-namespace dictionary.
+ */
+export function projectNamespacesLocales<T extends MultiDictionary>(
+  dictionary: T,
+  locales: readonly string[],
+  localeFallback?: LocaleFallbackMap
+): T {
+  const result = {} as T;
+
+  for (const namespace of Object.keys(dictionary) as (keyof T & string)[]) {
+    const namespaceDictionary = dictionary[namespace];
+    if (namespaceDictionary === undefined) {
+      continue;
     }
+
+    result[namespace] = projectKeyDictionary(
+      namespaceDictionary,
+      locales,
+      localeFallback
+    ) as T[typeof namespace];
   }
 
   return result;