@xndrjs/i18n 0.2.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+import { V as ValidationResult } from './types-CFWVT2PP.js';
+import '@formatjs/icu-messageformat-parser';
+
+type LocaleDictionary = Record<string, string>;
+type KeyDictionary = Record<string, LocaleDictionary>;
+type MultiDictionary = Record<string, KeyDictionary>;
+type LocaleOfSingle<Schema extends KeyDictionary> = {
+    [K in keyof Schema]: keyof Schema[K];
+}[keyof Schema] & string;
+type LocaleOfMulti<Schema extends MultiDictionary> = {
+    [NS in keyof Schema]: {
+        [K in keyof Schema[NS]]: keyof Schema[NS][K];
+    }[keyof Schema[NS]];
+}[keyof Schema] & string;
+type LocaleFallbackMap$1 = Record<string, string | null>;
+type RequestLocale<DictionaryLocale extends string, Fallback extends LocaleFallbackMap$1 | undefined = undefined> = DictionaryLocale | (Fallback extends LocaleFallbackMap$1 ? keyof Fallback & string : never);
+type IcuTranslationProviderOptions<Fallback extends LocaleFallbackMap$1 | undefined = undefined> = {
+    localeFallback?: Fallback;
+};
+
+interface TranslationProviderSingleForLocale<Schema extends KeyDictionary, Params extends {
+    [K in keyof Schema]: unknown;
+}, Locale extends string> {
+    readonly locale: Locale;
+    get<K extends keyof Schema & string>(key: K, ...params: Params[K] extends never ? [] : [params: Params[K]]): string;
+}
+interface TranslationProviderSingle<Schema extends KeyDictionary, Params extends {
+    [K in keyof Schema]: unknown;
+}, RequestLocales extends string = LocaleOfSingle<Schema>> {
+    get<K extends keyof Schema & string>(key: K, locale: RequestLocales, ...params: Params[K] extends never ? [] : [params: Params[K]]): string;
+    forLocale<Locale extends RequestLocales>(locale: Locale): TranslationProviderSingleForLocale<Schema, Params, Locale>;
+    getAll(): Schema;
+    setAll(values: Schema): void;
+}
+declare class IcuTranslationProviderSingleForLocale<Schema extends KeyDictionary, Params extends {
+    [K in keyof Schema]: unknown;
+}, RequestLocales extends string, Locale extends RequestLocales, Fallback extends LocaleFallbackMap$1 | undefined> implements TranslationProviderSingleForLocale<Schema, Params, Locale> {
+    private readonly provider;
+    readonly locale: Locale;
+    constructor(provider: IcuTranslationProviderSingle<Schema, Params, RequestLocales, Fallback>, locale: Locale);
+    get<K extends keyof Schema & string>(key: K, ...args: Params[K] extends never ? [] : [params: Params[K]]): string;
+}
+declare class IcuTranslationProviderSingle<Schema extends KeyDictionary, Params extends {
+    [K in keyof Schema]: unknown;
+}, RequestLocales extends string = LocaleOfSingle<Schema>, Fallback extends LocaleFallbackMap$1 | undefined = undefined> implements TranslationProviderSingle<Schema, Params, RequestLocales> {
+    private dictionary;
+    private compiledCache;
+    private readonly localeFallback?;
+    constructor(dictionary: Schema, options?: IcuTranslationProviderOptions<Fallback>);
+    get<K extends keyof Schema & string>(key: K, locale: RequestLocales, ...args: Params[K] extends never ? [] : [params: Params[K]]): string;
+    forLocale<Locale extends RequestLocales>(locale: Locale): IcuTranslationProviderSingleForLocale<Schema, Params, RequestLocales, Locale, Fallback>;
+    getAll(): Schema;
+    setAll(values: Schema): void;
+}
+
+interface TranslationProviderMultiForLocale<Schema extends MultiDictionary, Params extends {
+    [NS in keyof Schema]: {
+        [K in keyof Schema[NS]]: unknown;
+    };
+}, Locale extends string> {
+    readonly locale: Locale;
+    get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(namespace: NS, key: K, ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]): string;
+}
+interface TranslationProviderMulti<Schema extends MultiDictionary, Params extends {
+    [NS in keyof Schema]: {
+        [K in keyof Schema[NS]]: unknown;
+    };
+}, RequestLocales extends string = LocaleOfMulti<Schema>> {
+    get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(namespace: NS, key: K, locale: RequestLocales, ...params: Params[NS][K] extends never ? [] : [params: Params[NS][K]]): string;
+    forLocale<Locale extends RequestLocales>(locale: Locale): TranslationProviderMultiForLocale<Schema, Params, Locale>;
+    getAll(): Schema;
+    hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;
+    setAll(values: Schema): void;
+    setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
+}
+declare class IcuTranslationProviderMultiForLocale<Schema extends MultiDictionary, Params extends {
+    [NS in keyof Schema]: {
+        [K in keyof Schema[NS]]: unknown;
+    };
+}, RequestLocales extends string, Locale extends RequestLocales, Fallback extends LocaleFallbackMap$1 | undefined> implements TranslationProviderMultiForLocale<Schema, Params, Locale> {
+    private readonly provider;
+    readonly locale: Locale;
+    constructor(provider: IcuTranslationProviderMulti<Schema, Params, RequestLocales, Fallback>, locale: Locale);
+    get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(namespace: NS, key: K, ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]): string;
+}
+declare class IcuTranslationProviderMulti<Schema extends MultiDictionary, Params extends {
+    [NS in keyof Schema]: {
+        [K in keyof Schema[NS]]: unknown;
+    };
+}, RequestLocales extends string = LocaleOfMulti<Schema>, Fallback extends LocaleFallbackMap$1 | undefined = undefined> implements TranslationProviderMulti<Schema, Params, RequestLocales> {
+    private dictionary;
+    private compiledCache;
+    private readonly localeFallback?;
+    private loadedNamespaces;
+    constructor(dictionary: Partial<Schema>, options?: IcuTranslationProviderOptions<Fallback>);
+    get<NS extends keyof Schema, K extends keyof Schema[NS] & keyof Params[NS] & string>(namespace: NS, key: K, locale: RequestLocales, ...args: Params[NS][K] extends never ? [] : [params: Params[NS][K]]): string;
+    forLocale<Locale extends RequestLocales>(locale: Locale): IcuTranslationProviderMultiForLocale<Schema, Params, RequestLocales, Locale, Fallback>;
+    getAll(): Schema;
+    hasNamespace<NS extends keyof Schema & string>(namespace: NS): boolean;
+    setAll(values: Schema): void;
+    setNamespace<NS extends keyof Schema>(namespace: NS, values: Schema[NS]): void;
+}
+
+type LocaleFallbackMap = Record<string, string | null>;
+interface ResolvedLocaleTemplate {
+    template: string;
+    resolvedLocale: string;
+    fallbackChain: readonly string[];
+}
+declare function validateLocaleFallback(map: LocaleFallbackMap): void;
+declare function resolveLocaleTemplate(localeByKey: Record<string, string | undefined> | undefined, requestedLocale: string, fallbackMap?: LocaleFallbackMap): ResolvedLocaleTemplate | undefined;
+declare function formatLocaleFallbackChain(requestedLocale: string, fallbackMap?: LocaleFallbackMap): string;
+
+interface EnsureNamespacesLoadedOptions<Schema extends MultiDictionary, NS extends keyof Schema & string> {
+    provider: Pick<{
+        hasNamespace(namespace: NS): boolean;
+        setNamespace(namespace: NS, values: Schema[NS]): void;
+    }, "hasNamespace" | "setNamespace">;
+    resolveLoader: (namespace: NS) => () => Promise<unknown>;
+    validate: (namespace: NS, raw: unknown) => ValidationResult<Schema[NS]>;
+}
+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, resolveLocaleTemplate, validateLocaleFallback };

package/dist/index.js

@@ -0,0 +1,320 @@
+import { IntlMessageFormat } from 'intl-messageformat';
+
+// src/IcuTranslationProviderSingle.ts
+
+// src/deep-freeze.ts
+function deepFreeze(value) {
+  if (value === null || typeof value !== "object") {
+    return value;
+  }
+  Object.freeze(value);
+  for (const child of Object.values(value)) {
+    deepFreeze(child);
+  }
+  return value;
+}
+function cloneAndFreeze(value) {
+  return deepFreeze(structuredClone(value));
+}
+
+// src/resolve-locale.ts
+function validateLocaleFallback(map) {
+  for (const startLocale of Object.keys(map)) {
+    const visited = /* @__PURE__ */ new Set();
+    let current = startLocale;
+    while (current !== void 0) {
+      if (visited.has(current)) {
+        throw new Error(`[i18n] Circular locale fallback detected involving "${current}"`);
+      }
+      visited.add(current);
+      const next = map[current];
+      if (next === void 0 || next === null) {
+        break;
+      }
+      current = next;
+    }
+  }
+}
+function resolveLocaleTemplate(localeByKey, requestedLocale, fallbackMap) {
+  const chain = [requestedLocale];
+  let currentLocale = requestedLocale;
+  while (true) {
+    const template = localeByKey?.[currentLocale];
+    if (template !== void 0) {
+      return { template, resolvedLocale: currentLocale, fallbackChain: chain };
+    }
+    if (!fallbackMap) {
+      return void 0;
+    }
+    const fallback = fallbackMap[currentLocale];
+    if (fallback === void 0 || fallback === null) {
+      return void 0;
+    }
+    if (chain.includes(fallback)) {
+      throw new Error(
+        `[i18n] Circular locale fallback detected: ${[...chain, fallback].join(" \u2192 ")}`
+      );
+    }
+    chain.push(fallback);
+    currentLocale = fallback;
+  }
+}
+function formatLocaleFallbackChain(requestedLocale, fallbackMap) {
+  if (!fallbackMap) {
+    return requestedLocale;
+  }
+  const chain = [requestedLocale];
+  let current = requestedLocale;
+  while (true) {
+    const fallback = fallbackMap[current];
+    if (fallback === void 0 || fallback === null) {
+      break;
+    }
+    if (chain.includes(fallback)) {
+      chain.push(fallback);
+      break;
+    }
+    chain.push(fallback);
+    current = fallback;
+  }
+  return chain.join(" \u2192 ");
+}
+
+// src/IcuTranslationProviderSingle.ts
+var IcuTranslationProviderSingleForLocale = class {
+  constructor(provider, locale) {
+    this.provider = provider;
+    this.locale = locale;
+  }
+  provider;
+  locale;
+  get(key, ...args) {
+    return this.provider.get(key, this.locale, ...args);
+  }
+};
+var IcuTranslationProviderSingle = class {
+  dictionary;
+  compiledCache = {};
+  localeFallback;
+  constructor(dictionary, options) {
+    this.dictionary = structuredClone(dictionary);
+    if (options?.localeFallback) {
+      validateLocaleFallback(options.localeFallback);
+      this.localeFallback = options.localeFallback;
+    }
+  }
+  get(key, locale, ...args) {
+    const params = args[0];
+    const resolved = resolveLocaleTemplate(this.dictionary[key], locale, this.localeFallback);
+    if (!resolved) {
+      const chain = formatLocaleFallbackChain(locale, this.localeFallback);
+      throw new Error(
+        `[i18n] Missing key or locale: "${String(key)}" [${locale}] (fallback chain: ${chain})`
+      );
+    }
+    const { template, resolvedLocale } = resolved;
+    if (!this.compiledCache[resolvedLocale]) {
+      this.compiledCache[resolvedLocale] = {};
+    }
+    const cacheKey = String(key);
+    if (!this.compiledCache[resolvedLocale][cacheKey]) {
+      try {
+        this.compiledCache[resolvedLocale][cacheKey] = new IntlMessageFormat(
+          template,
+          resolvedLocale
+        );
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(
+          `[i18n ICU Syntax Error] Dictionary error for key "${String(key)}" [${resolvedLocale}]: ${message}`
+        );
+      }
+    }
+    try {
+      return this.compiledCache[resolvedLocale][cacheKey].format(params);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new Error(
+        `[i18n Formatting Error] Invalid or missing parameters for key "${String(key)}" [${resolvedLocale}]: ${message}`
+      );
+    }
+  }
+  forLocale(locale) {
+    return new IcuTranslationProviderSingleForLocale(this, locale);
+  }
+  getAll() {
+    return cloneAndFreeze(this.dictionary);
+  }
+  setAll(values) {
+    this.dictionary = structuredClone(values);
+    this.compiledCache = {};
+  }
+};
+var IcuTranslationProviderMultiForLocale = class {
+  constructor(provider, locale) {
+    this.provider = provider;
+    this.locale = locale;
+  }
+  provider;
+  locale;
+  get(namespace, key, ...args) {
+    return this.provider.get(namespace, key, this.locale, ...args);
+  }
+};
+var IcuTranslationProviderMulti = class {
+  dictionary;
+  compiledCache = {};
+  localeFallback;
+  loadedNamespaces;
+  constructor(dictionary, options) {
+    this.dictionary = structuredClone(dictionary);
+    this.loadedNamespaces = new Set(Object.keys(dictionary));
+    if (options?.localeFallback) {
+      validateLocaleFallback(options.localeFallback);
+      this.localeFallback = options.localeFallback;
+    }
+  }
+  get(namespace, key, locale, ...args) {
+    if (!this.loadedNamespaces.has(namespace)) {
+      throw new Error(
+        `[i18n] Namespace not loaded: "${String(namespace)}". Call ensureNamespacesLoaded(i18n, ["${String(namespace)}"]) first.`
+      );
+    }
+    const params = args[0];
+    const localeByKey = this.dictionary[namespace]?.[key];
+    const resolved = resolveLocaleTemplate(localeByKey, locale, this.localeFallback);
+    if (!resolved) {
+      const chain = formatLocaleFallbackChain(locale, this.localeFallback);
+      throw new Error(
+        `[i18n] Missing key or locale: namespace "${String(namespace)}", key "${String(key)}" [${locale}] (fallback chain: ${chain})`
+      );
+    }
+    const { template, resolvedLocale } = resolved;
+    if (!this.compiledCache[resolvedLocale]) {
+      this.compiledCache[resolvedLocale] = {};
+    }
+    if (!this.compiledCache[resolvedLocale][namespace]) {
+      this.compiledCache[resolvedLocale][namespace] = {};
+    }
+    const namespaceCache = this.compiledCache[resolvedLocale][namespace];
+    const cacheKey = String(key);
+    if (!namespaceCache[cacheKey]) {
+      try {
+        namespaceCache[cacheKey] = new IntlMessageFormat(template, resolvedLocale);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(
+          `[i18n ICU Syntax Error] namespace "${String(namespace)}", key "${String(key)}" [${resolvedLocale}]: ${message}`
+        );
+      }
+    }
+    try {
+      return namespaceCache[cacheKey].format(params);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new Error(
+        `[i18n Formatting Error] namespace "${String(namespace)}", key "${String(key)}" [${resolvedLocale}]: ${message}`
+      );
+    }
+  }
+  forLocale(locale) {
+    return new IcuTranslationProviderMultiForLocale(this, locale);
+  }
+  getAll() {
+    return cloneAndFreeze(this.dictionary);
+  }
+  hasNamespace(namespace) {
+    return this.loadedNamespaces.has(namespace);
+  }
+  setAll(values) {
+    this.dictionary = structuredClone(values);
+    this.compiledCache = {};
+    this.loadedNamespaces = new Set(Object.keys(values));
+  }
+  setNamespace(namespace, values) {
+    this.dictionary = {
+      ...this.dictionary,
+      [namespace]: structuredClone(values)
+    };
+    this.loadedNamespaces.add(namespace);
+    for (const locale of Object.keys(this.compiledCache)) {
+      delete this.compiledCache[locale]?.[namespace];
+    }
+  }
+};
+
+// src/validation/errors.ts
+function issueMessage(issue) {
+  switch (issue.kind) {
+    case "missing_key":
+      return `Missing required key at ${issue.path.join(".")}`;
+    case "invalid_input":
+    case "invalid_locale_value":
+    case "icu_syntax_error":
+    case "locale_args_mismatch":
+    case "variable_mismatch":
+    case "variable_type_mismatch":
+      return issue.message;
+  }
+}
+function formatIssues(issues) {
+  return issues.map((issue) => {
+    if ("path" in issue && issue.path.length > 0) {
+      return `[${issue.path.join(".")}] ${issue.kind}: ${issueMessage(issue)}`;
+    }
+    return `${issue.kind}: ${issueMessage(issue)}`;
+  }).join("\n");
+}
+var DictionaryValidationError = class extends Error {
+  constructor(issues) {
+    super(formatIssues(issues));
+    this.issues = issues;
+    this.name = "DictionaryValidationError";
+  }
+  issues;
+};
+
+// src/ensure-namespace.ts
+var inFlightByProvider = /* @__PURE__ */ new WeakMap();
+async function ensureOneNamespace(options, namespace) {
+  if (options.provider.hasNamespace(namespace)) {
+    return;
+  }
+  const providerKey = options.provider;
+  let inFlight = inFlightByProvider.get(providerKey);
+  if (!inFlight) {
+    inFlight = /* @__PURE__ */ new Map();
+    inFlightByProvider.set(providerKey, inFlight);
+  }
+  const existing = inFlight.get(namespace);
+  if (existing) {
+    return existing;
+  }
+  const promise = (async () => {
+    try {
+      if (options.provider.hasNamespace(namespace)) {
+        return;
+      }
+      const raw = await options.resolveLoader(namespace)();
+      const result = options.validate(namespace, raw);
+      if (!result.ok) {
+        throw new DictionaryValidationError(result.issues);
+      }
+      options.provider.setNamespace(namespace, result.data);
+    } finally {
+      inFlight.delete(namespace);
+    }
+  })();
+  inFlight.set(namespace, promise);
+  return promise;
+}
+async function ensureNamespacesLoadedImpl(options, namespaces) {
+  if (namespaces.length === 0) {
+    return;
+  }
+  await Promise.all(namespaces.map((namespace) => ensureOneNamespace(options, namespace)));
+}
+
+export { IcuTranslationProviderMulti, IcuTranslationProviderSingle, ensureNamespacesLoadedImpl, formatLocaleFallbackChain, resolveLocaleTemplate, validateLocaleFallback };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/deep-freeze.ts","../src/resolve-locale.ts","../src/IcuTranslationProviderSingle.ts","../src/IcuTranslationProviderMulti.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 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/dist/types-CFWVT2PP.d.ts

@@ -0,0 +1,77 @@
+import { parse } from '@formatjs/icu-messageformat-parser';
+
+type VariableType = "string" | "number" | "date";
+type VariableSpec = Record<string, VariableType>;
+type IcuAst = ReturnType<typeof parse>;
+declare function extractVariables(nodes: IcuAst): VariableSpec;
+declare function mergeVariableSpecs(target: VariableSpec, source: VariableSpec): VariableSpec;
+declare function variableSpecsEqual(a: VariableSpec, b: VariableSpec): boolean;
+
+type ParsedLocaleEntry = {
+    readonly template: string;
+    readonly args: VariableSpec;
+};
+type ParsedKeyEntry = {
+    readonly locales: Readonly<Record<string, ParsedLocaleEntry>>;
+    readonly mergedArgs: VariableSpec;
+};
+type NormalizedKeyDictionary = Readonly<Record<string, ParsedKeyEntry>>;
+type NormalizedMultiDictionary = Readonly<Record<string, NormalizedKeyDictionary>>;
+type NormalizedDictionary = {
+    readonly mode: "single";
+    readonly keys: NormalizedKeyDictionary;
+} | {
+    readonly mode: "multi";
+    readonly namespaces: NormalizedMultiDictionary;
+};
+type DictionarySpec = {
+    readonly mode: "single";
+    readonly requiredKeys: readonly string[];
+    readonly argsByKey: Readonly<Record<string, VariableSpec>>;
+} | {
+    readonly mode: "multi";
+    readonly requiredKeys: Readonly<Record<string, readonly string[]>>;
+    readonly argsByKey: Readonly<Record<string, Readonly<Record<string, VariableSpec>>>>;
+};
+type ValidationIssue = {
+    readonly kind: "invalid_input";
+    readonly message: string;
+} | {
+    readonly kind: "missing_key";
+    readonly path: readonly string[];
+} | {
+    readonly kind: "invalid_locale_value";
+    readonly path: readonly string[];
+    readonly message: string;
+} | {
+    readonly kind: "icu_syntax_error";
+    readonly path: readonly string[];
+    readonly message: string;
+} | {
+    readonly kind: "locale_args_mismatch";
+    readonly path: readonly string[];
+    readonly locales: Readonly<Record<string, VariableSpec>>;
+    readonly message: string;
+} | {
+    readonly kind: "variable_mismatch";
+    readonly path: readonly string[];
+    readonly expected: VariableSpec;
+    readonly found: VariableSpec;
+    readonly message: string;
+} | {
+    readonly kind: "variable_type_mismatch";
+    readonly path: readonly string[];
+    readonly variable: string;
+    readonly expected: VariableType;
+    readonly found: VariableType;
+    readonly message: string;
+};
+type ValidationResult<T> = {
+    readonly ok: true;
+    readonly data: T;
+} | {
+    readonly ok: false;
+    readonly issues: readonly ValidationIssue[];
+};
+
+export { type DictionarySpec as D, type NormalizedDictionary as N, type ParsedKeyEntry as P, type ValidationResult as V, type VariableSpec as a, type ValidationIssue as b, type NormalizedKeyDictionary as c, type NormalizedMultiDictionary as d, type ParsedLocaleEntry as e, type VariableType as f, extractVariables as g, mergeVariableSpecs as m, variableSpecsEqual as v };

package/dist/validation/index.d.ts

@@ -0,0 +1,44 @@
+import { D as DictionarySpec, V as ValidationResult, N as NormalizedDictionary, a as VariableSpec, b as ValidationIssue } from '../types-CFWVT2PP.js';
+export { c as NormalizedKeyDictionary, d as NormalizedMultiDictionary, P as ParsedKeyEntry, e as ParsedLocaleEntry, f as VariableType, g as extractVariables, m as mergeVariableSpecs, v as variableSpecsEqual } from '../types-CFWVT2PP.js';
+import { z } from 'zod';
+import '@formatjs/icu-messageformat-parser';
+
+declare function normalizeDictionary(input: unknown, spec: DictionarySpec): ValidationResult<NormalizedDictionary>;
+
+type LocaleDictionary = Record<string, string>;
+type KeyDictionary = Record<string, LocaleDictionary>;
+type MultiDictionary = Record<string, KeyDictionary>;
+declare function toDictionary(normalized: NormalizedDictionary): KeyDictionary | MultiDictionary;
+declare function toNamespaceDictionary(normalized: NormalizedDictionary, namespace: string): KeyDictionary;
+
+declare function validateNormalizedDictionary(normalized: NormalizedDictionary, spec: DictionarySpec): ValidationResult<NormalizedDictionary>;
+
+declare function createArgsSchema(expected: VariableSpec): z.ZodType<VariableSpec>;
+
+declare function createNormalizedDictionarySchema(spec: DictionarySpec): z.ZodType<NormalizedDictionary>;
+
+declare function formatIssues(issues: readonly ValidationIssue[]): string;
+declare class DictionaryValidationError extends Error {
+    readonly issues: readonly ValidationIssue[];
+    constructor(issues: readonly ValidationIssue[]);
+}
+declare function assertValidDictionary<T>(result: ValidationResult<T>): asserts result is {
+    ok: true;
+    data: T;
+};
+
+type ParseTemplateSuccess = {
+    readonly ok: true;
+    readonly args: VariableSpec;
+};
+type ParseTemplateFailure = {
+    readonly ok: false;
+    readonly message: string;
+};
+type ParseTemplateResult = ParseTemplateSuccess | ParseTemplateFailure;
+declare function parseTemplate(template: string): ParseTemplateResult;
+
+declare function validateExternalDictionary<TSchema>(input: unknown, spec: DictionarySpec): ValidationResult<TSchema>;
+declare function validateExternalNamespace<TNamespaceSchema>(namespace: string, input: unknown, spec: DictionarySpec): ValidationResult<TNamespaceSchema>;
+
+export { DictionarySpec, DictionaryValidationError, NormalizedDictionary, type ParseTemplateResult, ValidationIssue, ValidationResult, VariableSpec, assertValidDictionary, createArgsSchema, createNormalizedDictionarySchema, formatIssues, normalizeDictionary, parseTemplate, toDictionary, toNamespaceDictionary, validateExternalDictionary, validateExternalNamespace, validateNormalizedDictionary };