@vielzeug/i18nit 2.1.0 → 3.0.3

package/dist/i18n.js

@@ -1,181 +1,172 @@
-import { BoundedMap as e, deepMerge as t, isMessageValue as n, resolvePath as r } from "./helpers.js";
-import { formatDate as i, formatList as a, formatNumber as o, formatRelative as s, getPluralForm as c, makeIntlCaches as l } from "./intl.js";
-import { interpolate as u } from "./interpolate.js";
 //#region src/i18n.ts
-function d(d = {}) {
-	let f = d.locale ?? "en", p = d.switchMode ?? "strict", m = Array.isArray(d.fallback) ? d.fallback : d.fallback ? [d.fallback] : [], h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Set(), y = new e(128), b = l(), x = null, S = null, C = !1, w = 0, T = null, E = d.onMissing, D = d.onDiagnostic;
-	if (d.messages) for (let [e, t] of Object.entries(d.messages)) h.set(e, structuredClone(t));
-	if (d.loaders) for (let [e, t] of Object.entries(d.loaders)) g.set(e, t);
-	function O(e) {
-		D ? D({
-			error: e,
-			kind: "subscriber-error"
-		}) : console.error("[i18nit] Subscriber threw:", e);
+var e = /\{([\p{ID_Continue}\-.]+)\}/gu;
+function t(e) {
+	try {
+		return Intl.getCanonicalLocales(e)[0] ?? e;
+	} catch {
+		return e;
 	}
-	function k(e, t) {
-		D ? D({
-			error: e,
-			kind: "loader-error",
-			locale: t
-		}) : console.warn("[i18nit] Loader error:", e);
+}
+function n(e, t) {
+	let n = e;
+	for (let e of t.split(".")) {
+		if (typeof n != "object" || !n || !Object.hasOwn(n, e)) return;
+		n = n[e];
 	}
-	function A(e) {
-		if (w > 0) {
-			T !== "locale-change" && (T = e);
-			return;
+	return n;
+}
+function r(e, t) {
+	let n = /* @__PURE__ */ new Set();
+	for (let r of [e, ...t]) {
+		n.add(r);
+		let e = r.split("-");
+		for (let t = e.length - 1; t > 0; t--) n.add(e.slice(0, t).join("-"));
+	}
+	return [...n];
+}
+function i(e, t, n, r) {
+	let i = `${t}:${r ? "ordinal" : "cardinal"}`, a = e.get(i);
+	if (!a) {
+		try {
+			a = new Intl.PluralRules(t, { type: r ? "ordinal" : "cardinal" });
+		} catch {
+			a = { select: (e) => e === 1 ? "one" : "other" };
 		}
-		let t = {
-			locale: f,
-			reason: e
+		e.set(i, a);
+	}
+	return a.select(n);
+}
+function a(t, r, i, a, o) {
+	return t.includes("{") ? t.replace(e, (e, t) => {
+		let s = r == null ? void 0 : n(r, t);
+		return s == null ? o({
+			key: i,
+			locale: a,
+			type: "var",
+			varName: t
+		}) : String(s);
+	}) : t;
+}
+function o(e) {
+	let o = e ?? {}, s = t(o.locale ?? "en"), c = Array.isArray(o.fallback) ? o.fallback.map(t) : o.fallback ? [t(o.fallback)] : [], l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Set(), f = /* @__PURE__ */ new Map(), p = o.onMissing ?? ((e) => e.type === "key" ? e.key : `{${e.varName}}`), m = o.onSubscriberError ?? (() => {}), h = 0, g = {
+		locale: s,
+		version: h
+	}, _ = r(s, c), v = 0, y = () => {
+		h++, g = {
+			locale: s,
+			version: h
 		};
-		for (let e of v) try {
-			e(t);
+		let e = [...d];
+		for (let t of e) try {
+			t(g);
 		} catch (e) {
-			O(e);
+			m(e);
 		}
-	}
-	function j(e) {
-		let t = y.get(e);
-		if (t) return t;
-		let n = /* @__PURE__ */ new Set(), r = (e) => {
-			n.add(e);
-			let t = e.split("-");
-			for (let e = t.length - 1; e > 0; e--) n.add(t.slice(0, e).join("-"));
-		};
-		r(e);
-		for (let e of m) r(e);
-		let i = [...n];
-		return y.set(e, i), i;
-	}
-	function M(e, t) {
-		let i = h.get(t);
-		if (!i) return !1;
-		let a = r(i, e);
-		return a !== void 0 && n(a);
-	}
-	function N(e, t) {
-		for (let i of j(t)) {
-			let t = h.get(i);
-			if (!t) continue;
-			let a = r(t, e);
-			if (a !== void 0 && n(a)) return a;
+	}, b = (e, t = !1) => {
+		if (d.add(e), t) try {
+			e(g);
+		} catch (e) {
+			m(e);
 		}
-	}
-	function P(e, t, n) {
-		let r = N(e, n);
-		if (r === void 0) return E?.(e, n) ?? e;
-		if (typeof r == "string") return u(r, t ?? {}, n, b);
-		let i = t ?? {}, a = Number(i.count ?? 0);
-		return u(r[a === 0 && r.zero !== void 0 ? "zero" : c(b, n, a)] ?? r.other, i, n, b);
-	}
-	function F(e, t) {
-		if (_.has(e)) return _.get(e);
-		if (h.has(e)) return Promise.resolve();
-		let n = g.get(e);
-		if (!n) return t === "strict" ? Promise.reject(/* @__PURE__ */ Error(`[i18nit] Missing loader for locale "${e}".`)) : Promise.resolve();
-		let r = (async () => {
-			try {
-				let t = await n(e);
-				C || R.replace(e, t);
-			} catch (t) {
-				throw k(t, e), t;
-			} finally {
-				_.delete(e);
-			}
+		return () => d.delete(e);
+	}, x = (e) => {
+		for (let t of _) {
+			let r = l.get(t)?.messages;
+			if (!r) continue;
+			let i = n(r, e);
+			if (typeof i == "string") return i;
+		}
+	}, S = (e, t) => {
+		if (typeof t == "function") {
+			l.set(e, {
+				kind: "dynamic",
+				loader: t
+			});
+			return;
+		}
+		l.set(e, {
+			kind: "static",
+			messages: t
+		});
+	}, C = (e, n) => {
+		let r = t(e);
+		S(r, n), _.includes(r) && y();
+	};
+	if (o.catalogs) for (let [e, n] of Object.entries(o.catalogs)) S(t(e), n);
+	let w = async (e) => {
+		let n = t(e), r = l.get(n);
+		if (!r) throw Error(`Missing locale source for "${n}".`);
+		if (r.kind === "static" || r.messages) return;
+		let i = u.get(n);
+		if (i?.entry === r) {
+			await i.task;
+			return;
+		}
+		let a = (async () => {
+			let e = await r.loader(n);
+			l.get(n) === r && (r.messages = e, _.includes(n) && y());
 		})();
-		return _.set(e, r), r;
-	}
-	function I(e, t) {
-		let n = () => e ?? f, r = (e) => t ? `${t}.${e}` : e;
-		return {
-			currency(e, t, r) {
-				return o(b, e, {
-					...r,
-					currency: t,
-					style: "currency"
-				}, n());
-			},
-			date(e, t) {
-				return i(b, e, t, n());
-			},
-			has(e) {
-				return N(r(e), n()) !== void 0;
-			},
-			hasOwn(e) {
-				return M(r(e), n());
-			},
-			list(e, t = "and") {
-				return a(b, e, n(), t);
-			},
-			get locale() {
-				return n();
-			},
-			number(e, t) {
-				return o(b, e, t, n());
-			},
-			relative(e, t, r) {
-				return s(b, e, t, r, n());
-			},
-			scope(n) {
-				return I(e, t ? `${t}.${String(n)}` : String(n));
-			},
-			t: (e, t) => P(r(e), t, n()),
-			withLocale(e) {
-				return I(e, t);
-			}
-		};
-	}
-	let L = I(null), R = Object.create(L);
-	return R.add = (e, n) => {
-		let r = h.get(e) ?? {};
-		h.set(e, t(r, n)), x = null, j(f).includes(e) && A("catalog-update");
-	}, R.batch = (e) => {
-		w++;
+		u.set(n, {
+			entry: r,
+			task: a
+		});
 		try {
-			e();
+			await a;
 		} finally {
-			if (w--, w === 0 && T !== null) {
-				let e = T;
-				T = null, A(e);
-			}
+			u.get(n)?.task === a && u.delete(n);
 		}
-	}, R.dispose = () => {
-		C = !0, v.clear(), h.clear(), g.clear(), _.clear(), y.clear(), x = null, S = null;
-	}, R.ensureLocale = async (e, t = p) => {
-		await F(e, t);
-	}, R.hasLocale = (e) => h.has(e), R.isReady = (e) => h.has(e), Object.defineProperties(R, {
-		loadableLocales: { get() {
-			return S ??= [...g.keys()], S;
-		} },
-		locales: { get() {
-			return x ??= [...h.keys()], x;
-		} }
-	}), R.registerLoader = (e, t) => {
-		g.set(e, t), S = null;
-	}, R.reload = async (e) => {
-		if (!g.has(e)) throw Error(`[i18nit] Cannot reload locale "${e}" without a registered loader.`);
-		h.delete(e), x = null, await F(e, "strict");
-	}, R.replace = (e, t) => {
-		h.set(e, structuredClone(t)), x = null, j(f).includes(e) && A("catalog-update");
-	}, R.subscribe = (e, t) => {
-		if (v.add(e), t) try {
-			e({
-				locale: f,
-				reason: "locale-change"
-			});
-		} catch (e) {
-			O(e);
-		}
-		return () => v.delete(e);
-	}, R.switchLocale = async (e, t = p) => {
-		e !== f && (await F(e, t), f = e, A("locale-change"));
-	}, R[Symbol.asyncDispose] = async () => {
-		await Promise.allSettled([..._.values()]), R.dispose();
-	}, R[Symbol.dispose] = () => {
-		R.dispose();
-	}, R;
+	};
+	function T(e, t) {
+		let n = String(e), r = x(n);
+		return r === void 0 ? p({
+			key: n,
+			locale: s,
+			type: "key"
+		}) : a(r, t, n, s, p);
+	}
+	function E(e, t, n) {
+		if (!Number.isFinite(t)) throw TypeError("`count` must be a finite number.");
+		if (n?.vars && Object.hasOwn(n.vars, "count")) throw Error("`tp` does not allow `vars.count`; `count` is injected automatically.");
+		let r = String(e), o = n?.ordinal === !0, c = i(f, s, t, o), l = x(!o && t === 0 ? `${r}.zero` : `${r}.${c}`) ?? x(`${r}.other`);
+		return l === void 0 ? p({
+			key: r,
+			locale: s,
+			type: "key"
+		}) : a(l, {
+			...n?.vars ?? {},
+			count: t
+		}, r, s, p);
+	}
+	return {
+		getSnapshot() {
+			return g;
+		},
+		getSupportedLocales(e) {
+			let t = [...l.keys()];
+			return e?.sorted === !0 ? t.sort() : t;
+		},
+		has(e) {
+			return x(String(e)) !== void 0;
+		},
+		get locale() {
+			return s;
+		},
+		preload: w,
+		register: C,
+		async setLocale(e) {
+			let n = t(e);
+			if (s === n) return;
+			let i = ++v;
+			await w(n), i === v && (s = n, _ = r(s, c), y());
+		},
+		subscribe(e, t) {
+			return b(e, t?.immediate === !0);
+		},
+		t: T,
+		tp: E
+	};
 }
 //#endregion
-export { d as createI18n };
+export { o as createI18n };
 
 //# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","names":[],"sources":["../src/i18n.ts"],"sourcesContent":["import type {\n  BoundI18n,\n  I18n,\n  I18nOptions,\n  Loader,\n  Locale,\n  LocaleChangeEvent,\n  LocaleChangeReason,\n  Messages,\n  MessageValue,\n  NamespaceKeys,\n  SwitchMode,\n  Unsubscribe,\n  Vars,\n} from './types';\n\nimport { BoundedMap, deepMerge, isMessageValue, resolvePath } from './helpers';\nimport { interpolate } from './interpolate';\nimport {\n  formatDate,\n  formatList,\n  formatNumber,\n  formatRelative,\n  getPluralForm,\n  type IntlCaches,\n  makeIntlCaches,\n} from './intl';\n\nexport function createI18n<T extends Messages = Messages>(config: I18nOptions<T> = {}): I18n<T> {\n  let locale = config.locale ?? 'en';\n  const defaultSwitchMode: SwitchMode = config.switchMode ?? 'strict';\n  const fallbacks = Array.isArray(config.fallback) ? config.fallback : config.fallback ? [config.fallback] : [];\n  const catalogs = new Map<Locale, Messages>();\n  const loaders = new Map<Locale, Loader>();\n  const loading = new Map<Locale, Promise<void>>();\n  const subscribers = new Set<(event: LocaleChangeEvent) => void>();\n  const chainCache = new BoundedMap<Locale, Locale[]>(128);\n  const caches: IntlCaches = makeIntlCaches();\n\n  let localesCache: Locale[] | null = null;\n  let loadersCache: Locale[] | null = null;\n  let disposed = false;\n  let batchDepth = 0;\n  let pendingNotify: LocaleChangeReason | null = null;\n\n  const onMissing = config.onMissing;\n  const onDiagnostic = config.onDiagnostic;\n\n  if (config.messages) {\n    for (const [loc, messages] of Object.entries(config.messages)) {\n      catalogs.set(loc, structuredClone(messages) as Messages);\n    }\n  }\n\n  if (config.loaders) {\n    for (const [loc, loader] of Object.entries(config.loaders)) {\n      loaders.set(loc, loader);\n    }\n  }\n\n  function diagnoseSubscriber(error: unknown): void {\n    if (onDiagnostic) {\n      onDiagnostic({ error, kind: 'subscriber-error' });\n    } else {\n      console.error('[i18nit] Subscriber threw:', error);\n    }\n  }\n\n  function diagnoseLoader(error: unknown, loc: Locale): void {\n    if (onDiagnostic) {\n      onDiagnostic({ error, kind: 'loader-error', locale: loc });\n    } else {\n      console.warn('[i18nit] Loader error:', error);\n    }\n  }\n\n  function notify(reason: LocaleChangeReason): void {\n    if (batchDepth > 0) {\n      if (pendingNotify !== 'locale-change') pendingNotify = reason;\n\n      return;\n    }\n\n    const event: LocaleChangeEvent = { locale, reason };\n\n    for (const listener of subscribers) {\n      try {\n        listener(event);\n      } catch (error) {\n        diagnoseSubscriber(error);\n      }\n    }\n  }\n\n  function getLocaleChain(loc: Locale): Locale[] {\n    const cached = chainCache.get(loc);\n\n    if (cached) return cached;\n\n    const seen = new Set<Locale>();\n\n    const push = (value: Locale) => {\n      seen.add(value);\n\n      const parts = value.split('-');\n\n      for (let i = parts.length - 1; i > 0; i--) {\n        seen.add(parts.slice(0, i).join('-'));\n      }\n    };\n\n    push(loc);\n    for (const fallback of fallbacks) push(fallback);\n\n    const chain = [...seen];\n\n    chainCache.set(loc, chain);\n\n    return chain;\n  }\n\n  function checkOwn(key: string, loc: Locale): boolean {\n    const catalog = catalogs.get(loc);\n\n    if (!catalog) return false;\n\n    const value = resolvePath(catalog, key);\n\n    return value !== undefined && isMessageValue(value);\n  }\n\n  function findMessage(key: string, loc: Locale): MessageValue | undefined {\n    for (const localeInChain of getLocaleChain(loc)) {\n      const messages = catalogs.get(localeInChain);\n\n      if (!messages) continue;\n\n      const value = resolvePath(messages, key);\n\n      if (value !== undefined && isMessageValue(value)) return value;\n    }\n\n    return undefined;\n  }\n\n  function translate(key: string, vars: Vars | undefined, loc: Locale): string {\n    const message = findMessage(key, loc);\n\n    if (message === undefined) return onMissing?.(key, loc) ?? key;\n\n    if (typeof message === 'string') {\n      return interpolate(message, vars ?? {}, loc, caches);\n    }\n\n    const context = vars ?? {};\n\n    if (import.meta.env?.DEV && context.count === undefined) {\n      console.warn(`[i18nit] Key \"${key}\" is a plural message but vars.count is missing. Defaulting to 0.`);\n    }\n\n    const count = Number(context.count ?? 0);\n    const form = count === 0 && message.zero !== undefined ? 'zero' : getPluralForm(caches, loc, count);\n\n    return interpolate(message[form] ?? message.other, context, loc, caches);\n  }\n\n  function loadOne(loc: Locale, mode: SwitchMode): Promise<void> {\n    if (loading.has(loc)) return loading.get(loc)!;\n\n    if (catalogs.has(loc)) return Promise.resolve();\n\n    const loader = loaders.get(loc);\n\n    if (!loader) {\n      if (mode === 'strict') {\n        return Promise.reject(new Error(`[i18nit] Missing loader for locale \"${loc}\".`));\n      }\n\n      return Promise.resolve();\n    }\n\n    const promise = (async () => {\n      try {\n        const messages = await loader(loc);\n\n        if (!disposed) api.replace(loc, messages);\n      } catch (error) {\n        diagnoseLoader(error, loc);\n        throw error;\n      } finally {\n        loading.delete(loc);\n      }\n    })();\n\n    loading.set(loc, promise);\n\n    return promise;\n  }\n\n  function createView<U extends Messages = Messages>(fixedLocale: Locale | null, prefix?: string): BoundI18n<U> {\n    const activeLocale = (): Locale => fixedLocale ?? locale;\n    const keyWithPrefix = (key: string): string => (prefix ? `${prefix}.${key}` : key);\n    const t: BoundI18n<U>['t'] = (key: NamespaceKeys<U>, vars?: Record<string, unknown>) =>\n      translate(keyWithPrefix(key as string), vars, activeLocale());\n\n    const view = {\n      currency(\n        value: number,\n        currency: string,\n        options?: Omit<Intl.NumberFormatOptions, 'style' | 'currency'>,\n      ): string {\n        return formatNumber(caches, value, { ...options, currency, style: 'currency' }, activeLocale());\n      },\n      date(value: Date | number, options?: Intl.DateTimeFormatOptions): string {\n        return formatDate(caches, value, options, activeLocale());\n      },\n      has(key: string): boolean {\n        return findMessage(keyWithPrefix(key), activeLocale()) !== undefined;\n      },\n      hasOwn(key: string): boolean {\n        return checkOwn(keyWithPrefix(key), activeLocale());\n      },\n      list(items: unknown[], type: 'and' | 'or' = 'and'): string {\n        return formatList(caches, items, activeLocale(), type);\n      },\n      get locale(): Locale {\n        return activeLocale();\n      },\n      number(value: number, options?: Intl.NumberFormatOptions): string {\n        return formatNumber(caches, value, options, activeLocale());\n      },\n      relative(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string {\n        return formatRelative(caches, value, unit, options, activeLocale());\n      },\n      scope<K extends NamespaceKeys<U>>(ns: K): BoundI18n<U[K] & Messages> {\n        const nextPrefix = prefix ? `${prefix}.${String(ns)}` : String(ns);\n\n        return createView<U[K] & Messages>(fixedLocale, nextPrefix);\n      },\n      t,\n      withLocale(nextLocale: Locale): BoundI18n<U> {\n        return createView<U>(nextLocale, prefix);\n      },\n    } satisfies BoundI18n<U>;\n\n    return view;\n  }\n\n  const rootView = createView<T>(null);\n\n  const api = Object.create(rootView) as I18n<T>;\n\n  api.add = (loc: Locale, messages: Messages): void => {\n    const existing = catalogs.get(loc) ?? {};\n\n    catalogs.set(loc, deepMerge(existing, messages));\n    localesCache = null;\n\n    if (getLocaleChain(locale).includes(loc)) notify('catalog-update');\n  };\n\n  api.batch = (fn: () => void): void => {\n    batchDepth++;\n\n    try {\n      fn();\n    } finally {\n      batchDepth--;\n\n      if (batchDepth === 0 && pendingNotify !== null) {\n        const reason = pendingNotify;\n\n        pendingNotify = null;\n        notify(reason);\n      }\n    }\n  };\n\n  api.dispose = (): void => {\n    disposed = true;\n    subscribers.clear();\n    catalogs.clear();\n    loaders.clear();\n    loading.clear();\n    chainCache.clear();\n    localesCache = null;\n    loadersCache = null;\n  };\n\n  api.ensureLocale = async (loc: Locale, mode: SwitchMode = defaultSwitchMode): Promise<void> => {\n    await loadOne(loc, mode);\n  };\n\n  api.hasLocale = (loc: Locale): boolean => catalogs.has(loc);\n  api.isReady = (loc: Locale): boolean => catalogs.has(loc);\n\n  Object.defineProperties(api, {\n    loadableLocales: {\n      get(): Locale[] {\n        loadersCache ??= [...loaders.keys()];\n\n        return loadersCache;\n      },\n    },\n    locales: {\n      get(): Locale[] {\n        localesCache ??= [...catalogs.keys()];\n\n        return localesCache;\n      },\n    },\n  });\n\n  api.registerLoader = (loc: Locale, loader: Loader): void => {\n    loaders.set(loc, loader);\n    loadersCache = null;\n  };\n\n  api.reload = async (loc: Locale): Promise<void> => {\n    if (!loaders.has(loc)) {\n      throw new Error(`[i18nit] Cannot reload locale \"${loc}\" without a registered loader.`);\n    }\n\n    catalogs.delete(loc);\n    localesCache = null;\n    await loadOne(loc, 'strict');\n  };\n\n  api.replace = (loc: Locale, messages: Messages): void => {\n    catalogs.set(loc, structuredClone(messages));\n    localesCache = null;\n\n    if (getLocaleChain(locale).includes(loc)) notify('catalog-update');\n  };\n\n  api.subscribe = (listener: (event: LocaleChangeEvent) => void, immediate?: boolean): Unsubscribe => {\n    subscribers.add(listener);\n\n    if (immediate) {\n      try {\n        listener({ locale, reason: 'locale-change' });\n      } catch (error) {\n        diagnoseSubscriber(error);\n      }\n    }\n\n    return () => subscribers.delete(listener);\n  };\n\n  api.switchLocale = async (nextLocale: Locale, mode: SwitchMode = defaultSwitchMode): Promise<void> => {\n    if (nextLocale === locale) return;\n\n    await loadOne(nextLocale, mode);\n    locale = nextLocale;\n    notify('locale-change');\n  };\n\n  api[Symbol.asyncDispose] = async (): Promise<void> => {\n    await Promise.allSettled([...loading.values()]);\n    api.dispose();\n  };\n\n  api[Symbol.dispose] = (): void => {\n    api.dispose();\n  };\n\n  return api;\n}\n\nexport type { I18n };\n"],"mappings":"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"}
+{"version":3,"file":"i18n.js","names":[],"sources":["../src/i18n.ts"],"sourcesContent":["import type {\n  AnyKey,\n  I18n,\n  I18nOptions,\n  I18nSnapshot,\n  Loader,\n  Locale,\n  LocaleSource,\n  MessageBranchKeys,\n  MessageLeafKeys,\n  Messages,\n  MissingInfo,\n  PluralTranslateOptions,\n  SubscribeOptions,\n  TranslateVars,\n  Unsubscribe,\n} from './types';\n\ntype PluralRuleSelector = { select: (count: number) => string };\ntype PluralCaches = Map<string, PluralRuleSelector>;\ntype LocaleRecord<M extends Messages> =\n  | { kind: 'dynamic'; loader: Loader<M>; messages?: M }\n  | { kind: 'static'; messages: M };\ntype LoadingRecord<M extends Messages> = {\n  entry: Extract<LocaleRecord<M>, { kind: 'dynamic' }>;\n  task: Promise<void>;\n};\n\nconst INTERPOLATION_PATTERN = /\\{([\\p{ID_Continue}\\-.]+)\\}/gu;\n\nfunction canon(locale: string): string {\n  try {\n    return Intl.getCanonicalLocales(locale)[0] ?? locale;\n  } catch {\n    return locale;\n  }\n}\n\nfunction resolvePath(obj: Record<string, unknown>, path: string): unknown {\n  let value: unknown = obj;\n\n  for (const part of path.split('.')) {\n    if (value == null || typeof value !== 'object') return undefined;\n\n    if (!Object.hasOwn(value as object, part)) return undefined;\n\n    value = (value as Record<string, unknown>)[part];\n  }\n\n  return value;\n}\n\nfunction buildLocaleChain(locale: Locale, fallback: Locale[]): Locale[] {\n  const seen = new Set<Locale>();\n\n  for (const value of [locale, ...fallback]) {\n    seen.add(value);\n\n    const parts = value.split('-');\n\n    for (let i = parts.length - 1; i > 0; i--) {\n      seen.add(parts.slice(0, i).join('-'));\n    }\n  }\n\n  return [...seen];\n}\n\nfunction selectPluralForm(cache: PluralCaches, locale: Locale, count: number, ordinal: boolean): string {\n  const key = `${locale}:${ordinal ? 'ordinal' : 'cardinal'}`;\n  let rules = cache.get(key);\n\n  if (!rules) {\n    try {\n      rules = new Intl.PluralRules(locale, { type: ordinal ? 'ordinal' : 'cardinal' });\n    } catch {\n      rules = { select: (value: number) => (value === 1 ? 'one' : 'other') };\n    }\n\n    cache.set(key, rules);\n  }\n\n  return rules.select(count);\n}\n\nfunction interpolate(\n  template: string,\n  vars: TranslateVars | undefined,\n  key: string,\n  locale: Locale,\n  onMissing: (info: MissingInfo) => string,\n): string {\n  if (!template.includes('{')) return template;\n\n  return template.replace(INTERPOLATION_PATTERN, (_match, varName: string) => {\n    const value = vars != null ? resolvePath(vars, varName) : undefined;\n\n    if (value == null) {\n      return onMissing({ key, locale, type: 'var', varName });\n    }\n\n    return String(value);\n  });\n}\n\n/** Overload: explicit type parameter (strict typing) */\nexport function createI18n<M extends Messages>(config: I18nOptions<M>): I18n<M>;\n/** Overload: no type parameter (loose typing, allows heterogeneous catalogs) */\nexport function createI18n(config?: I18nOptions<Messages>): I18n<Messages>;\nexport function createI18n<M extends Messages = Messages>(config?: I18nOptions<M>): I18n<M> {\n  const cfg = (config ?? {}) as I18nOptions<M>;\n  let locale = canon(cfg.locale ?? 'en');\n  const fallback = Array.isArray(cfg.fallback) ? cfg.fallback.map(canon) : cfg.fallback ? [canon(cfg.fallback)] : [];\n\n  const registry = new Map<Locale, LocaleRecord<M>>();\n  const loading = new Map<Locale, LoadingRecord<M>>();\n  const subscribers = new Set<(snapshot: I18nSnapshot) => void>();\n  const pluralCache: PluralCaches = new Map();\n  const onMissing =\n    cfg.onMissing ??\n    ((info: MissingInfo) => {\n      if (info.type === 'key') return info.key;\n\n      return `{${info.varName}}`;\n    });\n  const onSubscriberError = cfg.onSubscriberError ?? (() => {});\n\n  let version = 0;\n  let snapshot: I18nSnapshot = { locale, version };\n  let activeChain = buildLocaleChain(locale, fallback);\n  let switchId = 0;\n\n  const bump = (): void => {\n    version++;\n    snapshot = { locale, version };\n\n    const listeners = [...subscribers];\n\n    for (const listener of listeners) {\n      try {\n        listener(snapshot);\n      } catch (error) {\n        onSubscriberError(error);\n      }\n    }\n  };\n\n  const addListener = (callback: (snapshot: I18nSnapshot) => void, immediate = false): Unsubscribe => {\n    subscribers.add(callback);\n\n    if (immediate) {\n      try {\n        callback(snapshot);\n      } catch (error) {\n        onSubscriberError(error);\n      }\n    }\n\n    return () => subscribers.delete(callback);\n  };\n\n  const findMessage = (key: string): string | undefined => {\n    for (const candidate of activeChain) {\n      const messages = registry.get(candidate)?.messages;\n\n      if (!messages) continue;\n\n      const value = resolvePath(messages, key);\n\n      if (typeof value === 'string') return value;\n    }\n\n    return undefined;\n  };\n\n  const setLocaleSource = (normalized: Locale, source: LocaleSource<M>): void => {\n    if (typeof source === 'function') {\n      registry.set(normalized, { kind: 'dynamic', loader: source as Loader<M> });\n\n      return;\n    }\n\n    registry.set(normalized, { kind: 'static', messages: source as M });\n  };\n\n  const register = (loc: Locale, source: LocaleSource<M>): void => {\n    const normalized = canon(loc);\n\n    setLocaleSource(normalized, source);\n\n    if (activeChain.includes(normalized)) bump();\n  };\n\n  if (cfg.catalogs) {\n    for (const [loc, source] of Object.entries(cfg.catalogs)) {\n      setLocaleSource(canon(loc), source as LocaleSource<M>);\n    }\n  }\n\n  const preload = async (loc: Locale): Promise<void> => {\n    const normalized = canon(loc);\n    const entry = registry.get(normalized);\n\n    if (!entry) {\n      throw new Error(`Missing locale source for \"${normalized}\".`);\n    }\n\n    if (entry.kind === 'static') return;\n\n    if (entry.messages) return;\n\n    const active = loading.get(normalized);\n\n    if (active?.entry === entry) {\n      await active.task;\n\n      return;\n    }\n\n    const task = (async () => {\n      const messages = await entry.loader(normalized);\n\n      // Only apply if the registry entry is still the exact object we started\n      // loading from. Any call to register() replaces the entry with a new\n      // object, so a stale loader result from a superseded source is discarded.\n      if (registry.get(normalized) !== entry) return;\n\n      entry.messages = messages;\n\n      if (activeChain.includes(normalized)) bump();\n    })();\n\n    loading.set(normalized, { entry, task });\n\n    try {\n      await task;\n    } finally {\n      if (loading.get(normalized)?.task === task) {\n        loading.delete(normalized);\n      }\n    }\n  };\n\n  function translate(key: MessageLeafKeys<M> | AnyKey, vars?: TranslateVars): string {\n    const base = String(key);\n    const message = findMessage(base);\n\n    return message === undefined\n      ? onMissing({ key: base, locale, type: 'key' })\n      : interpolate(message, vars, base, locale, onMissing);\n  }\n\n  function translatePlural(\n    key: MessageBranchKeys<M> | AnyKey,\n    count: number,\n    options?: PluralTranslateOptions,\n  ): string {\n    if (!Number.isFinite(count)) {\n      throw new TypeError('`count` must be a finite number.');\n    }\n\n    if (options?.vars && Object.hasOwn(options.vars, 'count')) {\n      throw new Error('`tp` does not allow `vars.count`; `count` is injected automatically.');\n    }\n\n    const base = String(key);\n    const ordinal = options?.ordinal === true;\n    const form = selectPluralForm(pluralCache, locale, count, ordinal);\n    const selectedKey = !ordinal && count === 0 ? `${base}.zero` : `${base}.${form}`;\n    const message = findMessage(selectedKey) ?? findMessage(`${base}.other`);\n\n    if (message === undefined) {\n      return onMissing({ key: base, locale, type: 'key' });\n    }\n\n    return interpolate(message, { ...(options?.vars ?? {}), count }, base, locale, onMissing);\n  }\n\n  return {\n    getSnapshot() {\n      return snapshot;\n    },\n\n    getSupportedLocales(options): Locale[] {\n      const locales = [...registry.keys()];\n\n      // Code-point sort: deterministic across all environments and locales.\n      return options?.sorted === true ? locales.sort() : locales;\n    },\n\n    has(key: MessageLeafKeys<M> | AnyKey): boolean {\n      return findMessage(String(key)) !== undefined;\n    },\n\n    get locale(): Locale {\n      return locale;\n    },\n\n    preload,\n\n    register,\n\n    async setLocale(next: Locale): Promise<void> {\n      const normalized = canon(next);\n\n      if (locale === normalized) return;\n\n      const id = ++switchId;\n\n      await preload(normalized);\n\n      if (id !== switchId) return;\n\n      locale = normalized;\n      activeChain = buildLocaleChain(locale, fallback);\n      bump();\n    },\n\n    subscribe(callback: (snapshot: I18nSnapshot) => void, options?: SubscribeOptions): Unsubscribe {\n      return addListener(callback, options?.immediate === true);\n    },\n\n    t: translate,\n    tp: translatePlural,\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-/** @vielzeug/i18nit — Lightweight, type-safe i18n library. */
-export type { BoundI18n, DeepPartialMessages, DiagnosticEvent, I18n, I18nOptions, Loader, Locale, LocaleChangeEvent, LocaleChangeListener, LocaleChangeReason, Messages, MessageValue, NamespaceKeys, PluralForm, PluralKeys, PluralMessages, SwitchMode, TranslationKey, TranslationKeyParam, Unsubscribe, Vars, } from './types';
+/** @vielzeug/i18nit — Lightweight, type-safe i18n runtime. */
+export type { AnyKey, I18n, I18nOptions, I18nSnapshot, Loader, Locale, LocaleSource, MessageBranchKeys, MessageLeafKeys, Messages, MissingInfo, PluralTranslateOptions, SupportedLocalesOptions, SubscribeOptions, TranslateVars, Unsubscribe, } from './types';
 export { createI18n } from './i18n';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAG9D,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,IAAI,EACJ,WAAW,EACX,MAAM,EACN,MAAM,EACN,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,YAAY,EACV,MAAM,EACN,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,MAAM,EACN,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}

package/dist/types.d.ts

@@ -1,117 +1,76 @@
 export type Locale = string;
 export type Unsubscribe = () => void;
-export type PluralForm = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
-export type PluralMessages = Partial<Record<PluralForm, string>> & {
-    other: string;
+export interface Messages {
+    [key: string]: string | Messages;
+}
+export type TranslateVars = Record<string, unknown>;
+export type Loader<M extends Messages = Messages> = (locale: Locale) => Promise<M>;
+export type LocaleSource<M extends Messages = Messages> = M | Loader<M>;
+export type PluralTranslateOptions = {
+    ordinal?: boolean;
+    vars?: TranslateVars;
 };
-export type MessageValue = string | PluralMessages;
-export type Messages = {
-    [key: string]: MessageValue | Messages;
+export type SupportedLocalesOptions = {
+    sorted?: boolean;
 };
-export type Vars = Record<string, unknown>;
-/**
- * Recursively makes all message keys optional, allowing partial locale catalogs.
- * Use when a secondary locale only translates a subset of the primary locale's messages.
- */
-export type DeepPartialMessages<T extends Messages> = {
-    [K in keyof T]?: T[K] extends MessageValue ? MessageValue : T[K] extends Messages ? DeepPartialMessages<T[K]> : MessageValue;
-};
-/**
- * Recursive type that extracts all dot-notation keys from a Messages shape for type-safe translation.
- * Type-safe resolution is provided up to 8 levels of nesting; deeper paths resolve to `string`.
- */
-export type TranslationKey<T extends Messages, P extends string = '', D extends readonly 0[] = []> = D['length'] extends 8 ? string : {
-    [K in keyof T & string]: T[K] extends MessageValue ? P extends '' ? K : `${P}.${K}` : T[K] extends Messages ? TranslationKey<T[K], P extends '' ? K : `${P}.${K}`, [...D, 0]> : never;
-}[keyof T & string];
-/** The `key` parameter type for `t()` — enforces known dot-notation paths when `T` is concrete, allows any string otherwise. */
-export type TranslationKeyParam<T extends Messages> = [TranslationKey<T>] extends [never] ? string : TranslationKey<T> | (string & {});
-/** Extracts dot-notation keys from `T` whose final value is `PluralMessages`, for compile-time `count` enforcement. */
-export type PluralKeys<T extends Messages, P extends string = '', D extends readonly 0[] = []> = D['length'] extends 8 ? never : {
-    [K in keyof T & string]: T[K] extends PluralMessages ? P extends '' ? K : `${P}.${K}` : T[K] extends Messages ? PluralKeys<T[K], P extends '' ? K : `${P}.${K}`, [...D, 0]> : never;
-}[keyof T & string];
-export type Loader = (locale: Locale) => Promise<Messages>;
-export type SwitchMode = 'strict' | 'best-effort';
-/** The reason a `subscribe()` listener was notified. */
-export type LocaleChangeReason = 'locale-change' | 'catalog-update';
-/** Payload passed to every `subscribe()` listener. */
-export type LocaleChangeEvent = {
+export type MissingInfo = {
+    key: string;
     locale: Locale;
-    reason: LocaleChangeReason;
-};
-/** Type alias for a `subscribe()` listener function. */
-export type LocaleChangeListener = (event: LocaleChangeEvent) => void;
-/**
- * Diagnostic event passed to `onDiagnostic`. Each `kind` carries relevant context:
- * - `'subscriber-error'` — a subscriber callback threw; treat as a programming error.
- * - `'loader-error'` — a locale loader rejected; treat as a recoverable I/O failure.
- */
-export type DiagnosticEvent = {
-    error: unknown;
-    kind: 'subscriber-error';
+    type: 'key';
 } | {
-    error: unknown;
-    kind: 'loader-error';
+    key: string;
     locale: Locale;
+    type: 'var';
+    varName: string;
+};
+export type I18nSnapshot = {
+    readonly locale: Locale;
+    readonly version: number;
 };
-/** Keys of `T` whose values are nested `Messages` objects (i.e. valid scope targets). */
-export type NamespaceKeys<T extends Messages> = string extends keyof T ? string : {
-    [K in keyof T & string]: T[K] extends Messages ? K : never;
-}[keyof T & string];
-export type I18nOptions<T extends Messages = Messages> = {
+export type AnyKey = string & {};
+export type SubscribeOptions = {
+    immediate?: boolean;
+};
+type Depth = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8];
+export type MessageLeafKeys<T, P extends string = '', D extends number = 7> = [D] extends [0] ? never : T extends string ? P : T extends Record<string, unknown> ? {
+    [K in string & keyof T]: MessageLeafKeys<T[K], P extends '' ? K : `${P}.${K}`, Depth[D]>;
+}[string & keyof T] : never;
+export type MessageBranchKeys<T, P extends string = '', D extends number = 7> = [D] extends [0] ? never : T extends Record<string, unknown> ? {
+    [K in string & keyof T]: T[K] extends string ? never : (P extends '' ? K : `${P}.${K}`) | MessageBranchKeys<T[K], P extends '' ? K : `${P}.${K}`, Depth[D]>;
+}[string & keyof T] : never;
+/**
+ * Configuration for i18n instances.
+ * When `M` is not explicitly provided, it defaults to the broad `Messages` type,
+ * allowing heterogeneous catalogs. When `M` is explicit, strict type checking applies.
+ */
+export type I18nOptions<M extends Messages = Messages> = {
+    /** Locale registry. Values can be static messages or async loaders. */
+    catalogs?: Record<Locale, LocaleSource<M>>;
     fallback?: Locale | Locale[];
-    loaders?: Record<Locale, Loader>;
     locale?: Locale;
-    /**
-     * Static message bundles. Each locale can be a full or partial catalog.
-     * For a partial secondary locale, annotate it with `DeepPartialMessages<M>` to get compile-time
-     * checks that the subset matches the primary locale's shape.
-     */
-    messages?: Record<string, T | DeepPartialMessages<T>>;
-    /**
-     * Receives diagnostic events for both subscriber errors and loader failures.
-     * `'subscriber-error'` events indicate a programming error in a listener.
-     * `'loader-error'` events are recoverable I/O failures and include the failing `locale`.
-     * Defaults to `console.error` for subscriber errors and `console.warn` for loader errors.
-     */
-    onDiagnostic?: (event: DiagnosticEvent) => void;
-    onMissing?: (key: string, locale: Locale) => string | undefined;
-    /** Default mode for `ensureLocale()` and `switchLocale()`. */
-    switchMode?: SwitchMode;
+    onMissing?: (info: MissingInfo) => string;
+    onSubscriberError?: (error: unknown) => void;
 };
-export type BoundI18n<T extends Messages = Messages> = {
-    currency(value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, 'style' | 'currency'>): string;
-    date(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
-    has(key: string): boolean;
-    /** Like `has()`, but only checks the exact locale without walking the fallback chain. */
-    hasOwn(key: string): boolean;
-    list(items: unknown[], type?: 'and' | 'or'): string;
+export type I18n<M extends Messages = Messages> = {
+    /** Snapshot version starts at 0 and increments by 1 per observable change. */
+    getSnapshot(): I18nSnapshot;
+    getSupportedLocales(options?: SupportedLocalesOptions): Locale[];
+    /** Check if a key exists. Accepts literal keys from M, or any dynamic string. */
+    has(key: MessageLeafKeys<M> | AnyKey): boolean;
     readonly locale: Locale;
-    number(value: number, options?: Intl.NumberFormatOptions): string;
-    relative(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;
-    /** Returns a translator scoped to a namespace key. Only keys whose values are nested message objects are valid. */
-    scope<K extends NamespaceKeys<T>>(ns: K): BoundI18n<T[K] & Messages>;
-    /** Translates a plural key — requires `{ count: number }` when `T` is concrete and the key resolves to `PluralMessages`. */
-    t<K extends PluralKeys<T>>(key: K, vars: {
-        count: number;
-    } & Vars): string;
-    t(key: TranslationKeyParam<T>, vars?: Vars): string;
-    withLocale(locale: Locale): BoundI18n<T>;
-};
-export type I18n<T extends Messages = Messages> = BoundI18n<T> & {
-    [Symbol.asyncDispose](): Promise<void>;
-    [Symbol.dispose](): void;
-    add(locale: Locale, messages: Messages): void;
-    batch(fn: () => void): void;
-    dispose(): void;
-    ensureLocale(locale: Locale, mode?: SwitchMode): Promise<void>;
-    hasLocale(locale: Locale): boolean;
-    isReady(locale: Locale): boolean;
-    readonly loadableLocales: Locale[];
-    readonly locales: Locale[];
-    registerLoader(locale: Locale, loader: Loader): void;
-    reload(locale: Locale): Promise<void>;
-    replace(locale: Locale, messages: Messages): void;
-    subscribe(listener: (event: LocaleChangeEvent) => void, immediate?: boolean): Unsubscribe;
-    switchLocale(locale: Locale, mode?: SwitchMode): Promise<void>;
+    preload(locale: Locale): Promise<void>;
+    register(locale: Locale, source: LocaleSource<M>): void;
+    setLocale(locale: Locale): Promise<void>;
+    /**
+     * Subscribes to locale/catalog changes.
+     * - Default: callback runs only on changes.
+     * - `{ immediate: true }`: callback runs immediately with current snapshot and on every change.
+     */
+    subscribe(callback: (snapshot: I18nSnapshot) => void, options?: SubscribeOptions): Unsubscribe;
+    /** Get a translation. Accepts literal keys from M, or any dynamic string. */
+    t(key: MessageLeafKeys<M> | AnyKey, vars?: TranslateVars): string;
+    /** Get a pluralized translation from branch keys. */
+    tp(key: MessageBranchKeys<M> | AnyKey, count: number, options?: PluralTranslateOptions): string;
 };
+export {};
 //# sourceMappingURL=types.d.ts.map