@vielzeug/i18nit 2.0.0 → 3.0.1

package/dist/i18n.js

@@ -1,218 +1,172 @@
-import { BoundView as e } from "./core.js";
-import { BoundedMap as t, deepMerge as n, isMessageValue as r, resolvePath as i } from "./helpers.js";
-import { formatDate as a, formatList as o, formatNumber as s, formatRelative as c, getPluralForm as l, makeIntlCaches as u } from "./intl.js";
-import { interpolate as d } from "./interpolate.js";
 //#region src/i18n.ts
-var f = class {
-	#e;
-	#t;
-	#n = /* @__PURE__ */ new Map();
-	#r = /* @__PURE__ */ new Map();
-	#i = /* @__PURE__ */ new Map();
-	#a = /* @__PURE__ */ new Set();
-	#o = new t(128);
-	#s;
-	#c;
-	#l = null;
-	#u = null;
-	#d = !1;
-	#f = 0;
-	#p = null;
-	#m;
-	#h = u();
-	#g;
-	constructor({ fallback: t, loaders: n, locale: l = "en", messages: u, onDiagnostic: d, onMissing: f } = {}) {
-		if (this.#e = l, this.#t = Array.isArray(t) ? t : t ? [t] : [], this.#s = f, this.#c = d, u) for (let [e, t] of Object.entries(u)) this.#n.set(e, structuredClone(t));
-		if (n) for (let [e, t] of Object.entries(n)) this.#r.set(e, t);
-		this.#m = {
-			checkOwn: (e, t) => {
-				let n = this.#n.get(t);
-				if (!n) return !1;
-				let a = i(n, e);
-				return a !== void 0 && r(a);
-			},
-			findMessage: (e, t) => this.#b(e, t),
-			formatDate: (e, t, n) => a(this.#h, e, t, n),
-			formatList: (e, t, n) => o(this.#h, e, t, n),
-			formatNumber: (e, t, n) => s(this.#h, e, t, n),
-			formatRelative: (e, t, n, r) => c(this.#h, e, t, n, r),
-			getLocale: () => this.#e,
-			translate: (e, t, n) => this.#S(e, t, n)
-		}, this.#g = new e(this.#m, null);
+var e = /\{([\p{ID_Continue}\-.]+)\}/gu;
+function t(e) {
+	try {
+		return Intl.getCanonicalLocales(e)[0] ?? e;
+	} catch {
+		return e;
 	}
-	get locale() {
-		return this.#e;
-	}
-	get locales() {
-		return this.#l ??= [...this.#n.keys()], this.#l;
-	}
-	set locale(e) {
-		this.#e !== e && (this.#e = e, this.#y("locale-change"));
-	}
-	async setLocale(e) {
-		e !== this.#e && (await this.load(e), this.locale = e);
-	}
-	add(e, t) {
-		let r = this.#n.get(e) ?? {};
-		this.#n.set(e, n(r, t)), this.#l = null, this.#x(this.#e).includes(e) && this.#y("catalog-update");
-	}
-	replace(e, t) {
-		this.#n.set(e, structuredClone(t)), this.#l = null, this.#x(this.#e).includes(e) && this.#y("catalog-update");
-	}
-	has(e) {
-		return this.#g.has(e);
-	}
-	hasOwn(e) {
-		return this.#g.hasOwn(e);
-	}
-	hasLocale(e) {
-		return this.#n.has(e);
-	}
-	async load(...e) {
-		await Promise.all(e.map((e) => this.#C(e)));
-	}
-	async reload(e) {
-		this.#r.has(e) && (this.#n.delete(e), this.#l = null, await this.#C(e));
-	}
-	registerLoader(e, t) {
-		this.#r.set(e, t), this.#u = null;
-	}
-	get loadableLocales() {
-		return this.#u ??= [...this.#r.keys()], this.#u;
-	}
-	t(e, t) {
-		return this.#g.t(e, t);
-	}
-	number(e, t) {
-		return this.#g.number(e, t);
-	}
-	date(e, t) {
-		return this.#g.date(e, t);
-	}
-	list(e, t = "and") {
-		return this.#g.list(e, t);
-	}
-	relative(e, t, n) {
-		return this.#g.relative(e, t, n);
-	}
-	currency(e, t, n) {
-		return this.#g.currency(e, t, n);
-	}
-	withLocale(e) {
-		return this.#g.withLocale(e);
-	}
-	scope(e) {
-		return this.#g.scope(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];
 	}
-	batch(e) {
-		this.#f++;
+	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 {
-			e();
-		} finally {
-			if (this.#f--, this.#f === 0 && this.#p !== null) {
-				let e = this.#p;
-				this.#p = null, this.#y(e);
-			}
+			a = new Intl.PluralRules(t, { type: r ? "ordinal" : "cardinal" });
+		} catch {
+			a = { select: (e) => e === 1 ? "one" : "other" };
 		}
+		e.set(i, a);
 	}
-	subscribe(e, t) {
-		if (this.#a.add(e), t) try {
-			e({
-				locale: this.#e,
-				reason: "locale-change"
-			});
+	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
+		};
+		let e = [...d];
+		for (let t of e) try {
+			t(g);
 		} catch (e) {
-			this.#_(e);
+			m(e);
 		}
-		return () => this.#a.delete(e);
-	}
-	dispose() {
-		this.#d = !0, this.#a.clear(), this.#n.clear(), this.#r.clear(), this.#i.clear(), this.#o.clear(), this.#l = null, this.#u = null;
-	}
-	[Symbol.dispose]() {
-		this.dispose();
-	}
-	async [Symbol.asyncDispose]() {
-		await Promise.allSettled([...this.#i.values()]), this.dispose();
-	}
-	#_(e) {
-		this.#c ? this.#c({
-			error: e,
-			kind: "subscriber-error"
-		}) : console.error("[i18nit] Subscriber threw:", e);
-	}
-	#v(e, t) {
-		this.#c ? this.#c({
-			error: e,
-			kind: "loader-error",
-			locale: t
-		}) : console.warn("[i18nit] Loader error:", e);
-	}
-	#y(e) {
-		if (this.#f > 0) {
-			this.#p !== "locale-change" && (this.#p = e);
-			return;
-		}
-		let t = {
-			locale: this.#e,
-			reason: e
-		};
-		for (let e of this.#a) try {
-			e(t);
+	}, b = (e, t = !1) => {
+		if (d.add(e), t) try {
+			e(g);
 		} catch (e) {
-			this.#_(e);
+			m(e);
 		}
-	}
-	#b(e, t) {
-		for (let n of this.#x(t)) {
-			let t = this.#n.get(n);
-			if (!t) continue;
-			let a = i(t, e);
-			if (a !== void 0 && r(a)) return a;
+		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;
 		}
-	}
-	#x(e) {
-		let t = this.#o.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 this.#t) r(e);
-		let i = [...n];
-		return this.#o.set(e, i), i;
-	}
-	#S(e, t, n) {
-		let r = this.#b(e, n);
-		if (r === void 0) return this.#s?.(e, n) ?? e;
-		if (typeof r == "string") return d(r, t ?? {}, n, this.#h);
-		let i = t ?? {}, a = Number(i.count ?? 0);
-		return d(r[a === 0 && r.zero !== void 0 ? "zero" : l(this.#h, n, a)] ?? r.other, i, n, this.#h);
-	}
-	#C(e) {
-		if (this.#i.has(e)) return this.#i.get(e);
-		if (this.#n.has(e)) return Promise.resolve();
-		let t = this.#r.get(e);
-		if (!t) return Promise.resolve();
-		let n = (async () => {
-			try {
-				let n = await t(e);
-				this.#d || this.replace(e, n);
-			} catch (t) {
-				throw this.#v(t, e), t;
-			} finally {
-				this.#i.delete(e);
-			}
+	}, 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 this.#i.set(e, n), n;
-	}
-};
-function p(e) {
-	return new f(e);
+		u.set(n, {
+			entry: r,
+			task: a
+		});
+		try {
+			await a;
+		} finally {
+			u.get(n)?.task === a && u.delete(n);
+		}
+	};
+	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 { f as I18n, p as createI18n };
+export { o as createI18n };
 
 //# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","names":["#caches","#view","#locale","#fallbacks","#onMissing","#onDiagnostic","#catalogs","#loaders","#core","#findMessage","#translate","#localesCache","#notify","#getLocaleChain","#loadOne","#loadersCache","#batchDepth","#pendingNotify","#subscribers","#diagnoseSubscriber","#disposed","#loading","#chainCache","#diagnoseLoader"],"sources":["../src/i18n.ts"],"sourcesContent":["import type {\n  BoundI18n,\n  DiagnosticEvent,\n  I18nOptions,\n  Loader,\n  Locale,\n  LocaleChangeEvent,\n  LocaleChangeReason,\n  MessageValue,\n  Messages,\n  NamespaceKeys,\n  TranslationKeyParam,\n  Unsubscribe,\n  Vars,\n} from './types';\n\nimport { BoundView, type I18nCore } from './core';\nimport { BoundedMap, deepMerge, isMessageValue, resolvePath } from './helpers';\nimport { interpolate } from './interpolate';\nimport {\n  type IntlCaches,\n  formatDate,\n  formatList,\n  formatNumber,\n  formatRelative,\n  getPluralForm,\n  makeIntlCaches,\n} from './intl';\n\nexport class I18n<T extends Messages = Messages> implements BoundI18n<T> {\n  #locale: Locale;\n  #fallbacks: Locale[];\n  #catalogs = new Map<Locale, Messages>();\n  #loaders = new Map<Locale, Loader>();\n  #loading = new Map<Locale, Promise<void>>();\n  #subscribers = new Set<(event: LocaleChangeEvent) => void>();\n  /** Bounded at 128 entries — prevents unbounded growth when locale tags come from user input. */\n  #chainCache = new BoundedMap<Locale, Locale[]>(128);\n  #onMissing?: (key: string, locale: Locale) => string | undefined;\n  #onDiagnostic?: (event: DiagnosticEvent) => void;\n  #localesCache: Locale[] | null = null;\n  #loadersCache: Locale[] | null = null;\n  #disposed = false;\n  #batchDepth = 0;\n  #pendingNotify: LocaleChangeReason | null = null;\n  #core: I18nCore;\n\n  // Instance-scoped Intl caches — GC'd with the instance (important for SSR with many locales).\n  readonly #caches: IntlCaches = makeIntlCaches();\n\n  /** Internal BoundView — I18n delegates its BoundI18n surface here to avoid duplicating every method. */\n  readonly #view: BoundView<T>;\n\n  constructor({ fallback, loaders, locale = 'en', messages, onDiagnostic, onMissing }: I18nOptions<T> = {}) {\n    this.#locale = locale;\n    this.#fallbacks = Array.isArray(fallback) ? fallback : fallback ? [fallback] : [];\n    this.#onMissing = onMissing;\n    this.#onDiagnostic = onDiagnostic;\n\n    if (messages) {\n      for (const [l, m] of Object.entries(messages)) {\n        // Deep-clone at init so external mutations to the source object can't corrupt the catalog.\n        this.#catalogs.set(l, structuredClone(m) as Messages);\n      }\n    }\n\n    if (loaders) for (const [l, fn] of Object.entries(loaders)) this.#loaders.set(l, fn);\n\n    this.#core = {\n      checkOwn: (key: string, locale: Locale) => {\n        const catalog = this.#catalogs.get(locale);\n\n        if (!catalog) return false;\n\n        const value = resolvePath(catalog, key);\n\n        return value !== undefined && isMessageValue(value);\n      },\n      findMessage: (key: string, locale: Locale) => this.#findMessage(key, locale),\n      formatDate: (value, options, locale) => formatDate(this.#caches, value, options, locale),\n      formatList: (items, locale, type) => formatList(this.#caches, items, locale, type),\n      formatNumber: (value, options, locale) => formatNumber(this.#caches, value, options, locale),\n      formatRelative: (value, unit, options, locale) => formatRelative(this.#caches, value, unit, options, locale),\n      getLocale: () => this.#locale,\n      translate: (key, vars, locale) => this.#translate(key, vars, locale),\n    };\n\n    this.#view = new BoundView<T>(this.#core, null);\n  }\n\n  /* -------------------- Locale -------------------- */\n\n  get locale(): Locale {\n    return this.#locale;\n  }\n\n  get locales(): Locale[] {\n    this.#localesCache ??= [...this.#catalogs.keys()];\n\n    return this.#localesCache;\n  }\n\n  set locale(value: Locale) {\n    if (this.#locale === value) return;\n\n    if (import.meta.env?.DEV && !this.#catalogs.has(value) && this.#loaders.has(value)) {\n      console.warn(\n        `[i18nit] locale \"${value}\" has a registered loader but is not loaded. ` +\n          'Use setLocale() to load and switch atomically.',\n      );\n    }\n\n    this.#locale = value;\n    this.#notify('locale-change');\n  }\n\n  async setLocale(locale: Locale): Promise<void> {\n    if (locale === this.#locale) return;\n\n    await this.load(locale);\n    this.locale = locale;\n  }\n\n  /* -------------------- Message Management -------------------- */\n\n  /** Deep-merges messages into an existing locale catalog. */\n  add(locale: Locale, messages: Messages): void {\n    const existing = this.#catalogs.get(locale) ?? {};\n\n    this.#catalogs.set(locale, deepMerge(existing, messages));\n    this.#localesCache = null;\n\n    if (this.#getLocaleChain(this.#locale).includes(locale)) this.#notify('catalog-update');\n  }\n\n  /** Replaces the entire locale catalog for `locale` with a deep clone of `messages`. */\n  replace(locale: Locale, messages: Messages): void {\n    this.#catalogs.set(locale, structuredClone(messages));\n    this.#localesCache = null;\n\n    if (this.#getLocaleChain(this.#locale).includes(locale)) this.#notify('catalog-update');\n  }\n\n  has(key: string): boolean {\n    return this.#view.has(key);\n  }\n\n  /** Like `has()`, but only checks the exact locale without walking the fallback chain. */\n  hasOwn(key: string): boolean {\n    return this.#view.hasOwn(key);\n  }\n\n  hasLocale(locale: Locale): boolean {\n    return this.#catalogs.has(locale);\n  }\n\n  /* -------------------- Async Loaders -------------------- */\n\n  async load(...locales: Locale[]): Promise<void> {\n    await Promise.all(locales.map((locale) => this.#loadOne(locale)));\n  }\n\n  /**\n   * Force-reloads a locale catalog even if already populated. Useful for hot-reload and forced bundle refresh.\n   * No-op (with a dev warning) when no loader is registered for the locale, to prevent silently clearing the catalog.\n   */\n  async reload(locale: Locale): Promise<void> {\n    if (!this.#loaders.has(locale)) {\n      if (import.meta.env?.DEV) {\n        console.warn(`[i18nit] reload(\"${locale}\") skipped — no loader registered for this locale.`);\n      }\n\n      return;\n    }\n\n    this.#catalogs.delete(locale);\n    this.#localesCache = null;\n    await this.#loadOne(locale);\n  }\n\n  registerLoader(locale: Locale, loader: Loader): void {\n    this.#loaders.set(locale, loader);\n    this.#loadersCache = null;\n  }\n\n  /** Returns the locale keys for which a loader has been registered. */\n  get loadableLocales(): Locale[] {\n    this.#loadersCache ??= [...this.#loaders.keys()];\n\n    return this.#loadersCache;\n  }\n\n  /* -------------------- BoundI18n surface (delegated to #view) -------------------- */\n\n  /**\n   * Translates a key with optional interpolation variables.\n   * Locale must be loaded first via `load()` or provided via `messages` in config.\n   * For a per-call locale override use `withLocale(locale).t(key, vars)`.\n   */\n  t(key: TranslationKeyParam<T>, vars?: Vars): string {\n    return this.#view.t(key, vars);\n  }\n\n  number(value: number, options?: Intl.NumberFormatOptions): string {\n    return this.#view.number(value, options);\n  }\n\n  date(value: Date | number, options?: Intl.DateTimeFormatOptions): string {\n    return this.#view.date(value, options);\n  }\n\n  list(items: unknown[], type: 'and' | 'or' = 'and'): string {\n    return this.#view.list(items, type);\n  }\n\n  relative(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string {\n    return this.#view.relative(value, unit, options);\n  }\n\n  currency(value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, 'style' | 'currency'>): string {\n    return this.#view.currency(value, currency, options);\n  }\n\n  /**\n   * Returns a bound interface that translates in the given locale without\n   * changing the active locale on the instance. Useful for SSR and\n   * multi-locale rendering in a single pass.\n   */\n  withLocale(locale: Locale): BoundI18n<T> {\n    return this.#view.withLocale(locale);\n  }\n\n  /**\n   * Returns a translator scoped to a key namespace prefix. Reacts to locale changes on the\n   * instance. When `T` is a concrete message type, the returned `BoundI18n` is narrowed to\n   * the subtree type so `t()` autocomplete works within the scope.\n   * Only keys whose values are nested message objects are valid scope targets.\n   */\n  scope<K extends NamespaceKeys<T>>(ns: K): BoundI18n<T[K] & Messages> {\n    return this.#view.scope(ns);\n  }\n\n  /* -------------------- Subscriptions -------------------- */\n\n  /**\n   * Executes `fn` while deferring subscriber notifications. A single notification fires\n   * after `fn` completes, collapsing any number of `add()` / `replace()` calls made within.\n   * Nested `batch()` calls are supported; notification fires when the outermost batch exits.\n   * If both a locale change and a catalog update are triggered, `'locale-change'` takes priority.\n   *\n   * @remarks\n   * `batch()` is synchronous. Async operations (e.g. `load()`) started inside `fn` complete\n   * after the batch exits and will notify subscribers individually. To batch-load multiple\n   * locales and notify once, await `load()` before entering the batch:\n   * ```ts\n   * await i18n.load('fr', 'de');\n   * i18n.batch(() => { i18n.locale = 'fr'; });\n   * ```\n   */\n  batch(fn: () => void): void {\n    this.#batchDepth++;\n\n    try {\n      fn();\n    } finally {\n      this.#batchDepth--;\n\n      if (this.#batchDepth === 0 && this.#pendingNotify !== null) {\n        const reason = this.#pendingNotify;\n\n        this.#pendingNotify = null;\n        this.#notify(reason);\n      }\n    }\n  }\n\n  subscribe(listener: (event: LocaleChangeEvent) => void, immediate?: boolean): Unsubscribe {\n    this.#subscribers.add(listener);\n\n    if (immediate) {\n      try {\n        listener({ locale: this.#locale, reason: 'locale-change' });\n      } catch (err) {\n        this.#diagnoseSubscriber(err);\n      }\n    }\n\n    return () => this.#subscribers.delete(listener);\n  }\n\n  /** Releases all resources held by this instance. */\n  dispose(): void {\n    this.#disposed = true;\n    this.#subscribers.clear();\n    this.#catalogs.clear();\n    this.#loaders.clear();\n    this.#loading.clear();\n    this.#chainCache.clear();\n    this.#localesCache = null;\n    this.#loadersCache = null;\n  }\n\n  /** Enables `using i18n = createI18n(...)` for deterministic resource release. */\n  [Symbol.dispose](): void {\n    this.dispose();\n  }\n\n  /**\n   * Awaits any in-flight `load()` calls and then releases all resources.\n   * Enables `await using i18n = createI18n(...)` in environments that support `Symbol.asyncDispose`.\n   */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await Promise.allSettled([...this.#loading.values()]);\n    this.dispose();\n  }\n\n  /* -------------------- Private -------------------- */\n\n  #diagnoseSubscriber(error: unknown): void {\n    if (this.#onDiagnostic) {\n      this.#onDiagnostic({ error, kind: 'subscriber-error' });\n    } else {\n      console.error('[i18nit] Subscriber threw:', error);\n    }\n  }\n\n  #diagnoseLoader(error: unknown, locale: Locale): void {\n    if (this.#onDiagnostic) {\n      this.#onDiagnostic({ error, kind: 'loader-error', locale });\n    } else {\n      console.warn('[i18nit] Loader error:', error);\n    }\n  }\n\n  #notify(reason: LocaleChangeReason): void {\n    if (this.#batchDepth > 0) {\n      // 'locale-change' takes priority over 'catalog-update' if both occur in one batch\n      if (this.#pendingNotify !== 'locale-change') this.#pendingNotify = reason;\n\n      return;\n    }\n\n    const event: LocaleChangeEvent = { locale: this.#locale, reason };\n\n    for (const listener of this.#subscribers) {\n      try {\n        listener(event);\n      } catch (err) {\n        this.#diagnoseSubscriber(err);\n      }\n    }\n  }\n\n  #findMessage(key: string, locale: Locale): MessageValue | undefined {\n    for (const loc of this.#getLocaleChain(locale)) {\n      const messages = this.#catalogs.get(loc);\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  #getLocaleChain(locale: Locale): Locale[] {\n    const cached = this.#chainCache.get(locale);\n\n    if (cached) return cached;\n\n    const seen = new Set<Locale>();\n    const push = (l: Locale) => {\n      seen.add(l);\n\n      const parts = l.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(locale);\n    for (const fallback of this.#fallbacks) push(fallback);\n\n    const chain = [...seen];\n\n    this.#chainCache.set(locale, chain);\n\n    return chain;\n  }\n\n  #translate(key: string, vars: Vars | undefined, locale: Locale): string {\n    const message = this.#findMessage(key, locale);\n\n    if (message === undefined) return this.#onMissing?.(key, locale) ?? key;\n\n    if (typeof message === 'string') return interpolate(message, vars ?? {}, locale, this.#caches);\n\n    const v = vars ?? {};\n\n    if (import.meta.env?.DEV && v.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(v.count ?? 0);\n    const form = count === 0 && message.zero !== undefined ? 'zero' : getPluralForm(this.#caches, locale, count);\n\n    return interpolate(message[form] ?? message.other, v, locale, this.#caches);\n  }\n\n  #loadOne(locale: Locale): Promise<void> {\n    if (this.#loading.has(locale)) return this.#loading.get(locale)!;\n\n    if (this.#catalogs.has(locale)) return Promise.resolve();\n\n    const loader = this.#loaders.get(locale);\n\n    if (!loader) return Promise.resolve();\n\n    const promise = (async () => {\n      try {\n        const messages = await loader(locale);\n\n        // Use replace() so the loader result is the authoritative catalog for this locale,\n        // not merged on top of any pre-seeded static messages.\n        if (!this.#disposed) this.replace(locale, messages);\n      } catch (error) {\n        this.#diagnoseLoader(error, locale);\n        throw error;\n      } finally {\n        this.#loading.delete(locale);\n      }\n    })();\n\n    this.#loading.set(locale, promise);\n\n    return promise;\n  }\n}\n\nexport function createI18n<T extends Messages = Messages>(config?: I18nOptions<T>): I18n<T> {\n  return new I18n<T>(config);\n}\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.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./i18n.cjs`);exports.I18n=e.I18n,exports.createI18n=e.createI18n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./i18n.cjs`);exports.createI18n=e.createI18n;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-/** @vielzeug/i18nit — Lightweight, type-safe i18n library. */
-export type { BoundI18n, DeepPartialMessages, DiagnosticEvent, I18nOptions, Loader, Locale, LocaleChangeEvent, LocaleChangeListener, LocaleChangeReason, Messages, MessageValue, NamespaceKeys, PluralForm, PluralKeys, PluralMessages, TranslationKey, TranslationKeyParam, Unsubscribe, Vars, } from './types';
-export { createI18n, I18n } from './i18n';
+/** @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,WAAW,EACX,MAAM,EACN,MAAM,EACN,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,IAAI,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/index.js

@@ -1,2 +1,2 @@
-import { I18n as e, createI18n as t } from "./i18n.js";
-export { e as I18n, t as createI18n };
+import { createI18n as e } from "./i18n.js";
+export { e as createI18n };

package/dist/types.d.ts

@@ -1,97 +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>;
-/** 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;
+    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>;
+    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