@vielzeug/lingua 1.1.2 → 1.1.4

package/dist/format.js

@@ -1,10 +1,6 @@
-function e(e, t, n) {
-	let r = e.get(t);
-	if (r !== void 0) return r;
-	let i = n();
-	return e.size >= 128 && e.delete(e.keys().next().value), e.set(t, i), i;
-}
-var t = [
+import { getOrCreate as e } from "./_bounded-cache.js";
+//#region src/format.ts
+var t = 128, n = [
 	"years",
 	"months",
 	"weeks",
@@ -15,7 +11,7 @@ var t = [
 	"milliseconds",
 	"microseconds",
 	"nanoseconds"
-], n = {
+], r = {
 	days: "d",
 	hours: "h",
 	microseconds: "us",
@@ -27,15 +23,15 @@ var t = [
 	weeks: "w",
 	years: "y"
 };
-function r(e) {
-	return t.map((t) => {
-		let r = e[t];
-		return typeof r == "number" ? `${r}${n[t]}` : void 0;
+function i(e) {
+	return n.map((t) => {
+		let n = e[t];
+		return typeof n == "number" ? `${n}${r[t]}` : void 0;
 	}).filter((e) => e !== void 0).join(" ");
 }
-function i(n) {
-	let i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), u = typeof n == "string" ? () => n : n;
-	function d(e, t) {
+function a(r) {
+	let a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), d = typeof r == "string" ? () => r : r;
+	function f(e, t) {
 		if (!t) return e;
 		let n = {};
 		for (let e of Object.keys(t).sort()) n[e] = t[e];
@@ -47,45 +43,45 @@ function i(n) {
 	}
 	return {
 		clear() {
-			i.clear(), a.clear(), o.clear(), s.clear(), c.clear(), l.clear();
+			a.clear(), o.clear(), s.clear(), c.clear(), l.clear(), u.clear();
 		},
-		currency(t, n, r) {
-			let i = u(), o = {
-				...r,
-				currency: n,
+		currency(n, r, i) {
+			let a = d(), s = {
+				...i,
+				currency: r,
 				style: "currency"
 			};
-			return e(a, d(i, o), () => new Intl.NumberFormat(i, o)).format(t);
+			return e(o, f(a, s), t, () => new Intl.NumberFormat(a, s)).format(n);
 		},
-		date(t, n) {
-			let r = u();
-			return e(o, d(r, n), () => new Intl.DateTimeFormat(r, n)).format(t);
+		date(n, r) {
+			let i = d();
+			return e(s, f(i, r), t, () => new Intl.DateTimeFormat(i, r)).format(n);
 		},
-		duration(n, i) {
-			let a = u(), o = Intl;
-			return o.DurationFormat ? t.every((e) => n[e] === void 0) ? "" : e(l, d(a, i), () => new o.DurationFormat(a, i)).format(n) : r(n);
+		duration(r, a) {
+			let o = d(), s = Intl;
+			return s.DurationFormat ? n.every((e) => r[e] === void 0) ? "" : e(u, f(o, a), t, () => new s.DurationFormat(o, a)).format(r) : i(r);
 		},
-		list(t, n) {
-			let r = u(), i = t.map((e) => String(e)), a = n?.style ?? "long", o = n?.type === "or" ? "disjunction" : "conjunction";
-			return e(c, d(r, {
-				style: a,
-				type: o
-			}), () => new Intl.ListFormat(r, {
-				style: a,
-				type: o
-			})).format(i);
+		list(n, r) {
+			let i = d(), a = n.map((e) => String(e)), o = r?.style ?? "long", s = r?.type === "or" ? "disjunction" : "conjunction";
+			return e(l, f(i, {
+				style: o,
+				type: s
+			}), t, () => new Intl.ListFormat(i, {
+				style: o,
+				type: s
+			})).format(a);
 		},
-		number(t, n) {
-			let r = u();
-			return e(i, d(r, n), () => new Intl.NumberFormat(r, n)).format(t);
+		number(n, r) {
+			let i = d();
+			return e(a, f(i, r), t, () => new Intl.NumberFormat(i, r)).format(n);
 		},
-		relative(t, n, r) {
-			let i = u();
-			return e(s, d(i, r), () => new Intl.RelativeTimeFormat(i, r)).format(t, n);
+		relative(n, r, i) {
+			let a = d();
+			return e(c, f(a, i), t, () => new Intl.RelativeTimeFormat(a, i)).format(n, r);
 		}
 	};
 }
 //#endregion
-export { i as createFormatter };
+export { a as createFormatter };
 
 //# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","names":[],"sources":["../src/format.ts"],"sourcesContent":["/**\n * /lingua/format\n *\n * Standalone Intl formatter factory. Import from `/lingua/format`.\n * Creates formatters for numbers, dates, currencies, lists, durations, and relative time.\n *\n * Pass a static locale string or a reactive locale getter.\n *\n * @example\n * ```ts\n * import { createFormatter } from '@vielzeug/lingua/format';\n *\n * // Static locale\n * const fmt = createFormatter('en-US');\n *\n * // Reactive — always reads the current locale from the i18n instance\n * const fmt = createFormatter(() => i18n.locale);\n *\n * fmt.number(1_234.56);\n * fmt.currency(9.99, 'USD');\n * fmt.date(new Date());\n * fmt.relative(-1, 'day');\n * fmt.list(['A', 'B', 'C']);\n * fmt.duration({ hours: 1, minutes: 30 });\n * ```\n */\n\nconst FORMAT_CACHE_MAX = 128;\n\nfunction getOrCreate<F>(cache: Map<string, F>, key: string, build: () => F): F {\n  const cached = cache.get(key);\n\n  if (cached !== undefined) return cached;\n\n  const value = build();\n\n  if (cache.size >= FORMAT_CACHE_MAX) cache.delete(cache.keys().next().value as string);\n\n  cache.set(key, value);\n\n  return value;\n}\n\nexport type DurationValue = Partial<\n  Record<\n    | 'days'\n    | 'hours'\n    | 'microseconds'\n    | 'milliseconds'\n    | 'minutes'\n    | 'months'\n    | 'nanoseconds'\n    | 'seconds'\n    | 'weeks'\n    | 'years',\n    number\n  >\n>;\n\nexport type DurationFormatOptions = {\n  hours?: '2-digit' | 'numeric';\n  microseconds?: 'numeric';\n  milliseconds?: 'numeric';\n  minutes?: '2-digit' | 'numeric';\n  nanoseconds?: 'numeric';\n  seconds?: '2-digit' | 'numeric';\n  style?: 'digital' | 'long' | 'narrow' | 'short';\n};\n\nexport type ListFormatOptions = {\n  style?: 'long' | 'narrow' | 'short';\n  type?: 'and' | 'or';\n};\n\nexport type Formatter = {\n  /**\n   * Clears all cached `Intl` formatter instances. Useful after a locale change on a long-running\n   * SSR server, or to reclaim memory.\n   *\n   * @note This clears the cache for **all callers sharing this formatter instance**. When called on\n   * `i18n.fmt`, the cache is cleared for every part of the application that reads `i18n.fmt`.\n   * `setLocale()` already calls `clear()` automatically — manual calls are rarely needed.\n   */\n  clear(): void;\n  currency(value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, 'currency' | 'style'>): string;\n  date(value: Date | number, options?: Intl.DateTimeFormatOptions): string;\n  /**\n   * Formats a duration using `Intl.DurationFormat` when available, or a compact labeled fallback\n   * (e.g. `'1h 30min'`). Returns `''` when every field of `value` is `undefined`.\n   *\n   * @note The fallback labels (`h`, `min`, `s`, `ms`, etc.) are English-only and are not\n   * locale-aware. If `Intl.DurationFormat` is unavailable in your target environment and\n   * you need localised duration output, provide your own formatter using the individual\n   * duration fields from `DurationValue`.\n   */\n  duration(value: DurationValue, options?: DurationFormatOptions): string;\n  list(value: Array<string | number>, options?: ListFormatOptions): string;\n  /** Formats a number with the current locale. */\n  number(value: number, options?: Intl.NumberFormatOptions): string;\n  relative(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;\n};\n\n// ─── Internal ─────────────────────────────────────────────────────────────────\n\nconst DURATION_UNITS: Array<keyof DurationValue> = [\n  'years',\n  'months',\n  'weeks',\n  'days',\n  'hours',\n  'minutes',\n  'seconds',\n  'milliseconds',\n  'microseconds',\n  'nanoseconds',\n];\n\nconst DURATION_LABELS: Record<keyof DurationValue, string> = {\n  days: 'd',\n  hours: 'h',\n  microseconds: 'us',\n  milliseconds: 'ms',\n  minutes: 'min',\n  months: 'mo',\n  nanoseconds: 'ns',\n  seconds: 's',\n  weeks: 'w',\n  years: 'y',\n};\n\ntype DurationFormatterCtor = new (\n  locale: string,\n  options?: DurationFormatOptions,\n) => { format(value: DurationValue): string };\n\nfunction durationLabeled(value: DurationValue): string {\n  return DURATION_UNITS.map((unit) => {\n    const amount = value[unit];\n\n    return typeof amount === 'number' ? `${amount}${DURATION_LABELS[unit]}` : undefined;\n  })\n    .filter((part): part is string => part !== undefined)\n    .join(' ');\n}\n\n// ─── Factory ──────────────────────────────────────────────────────────────────\n\n/**\n * Creates a formatter bound to a locale. Pass a static locale string or a\n * reactive getter function `() => string` (e.g. `() => i18n.locale`).\n */\nexport function createFormatter(source: string | (() => string)): Formatter {\n  const numberCache = new Map<string, Intl.NumberFormat>();\n  const currencyCache = new Map<string, Intl.NumberFormat>();\n  const dateCache = new Map<string, Intl.DateTimeFormat>();\n  const relativeCache = new Map<string, Intl.RelativeTimeFormat>();\n  const listCache = new Map<string, Intl.ListFormat>();\n  const durationCache = new Map<string, { format(value: DurationValue): string }>();\n\n  const getLocale = typeof source === 'string' ? () => source : source;\n\n  function cachedKey(locale: string, options?: object): string {\n    if (!options) return locale;\n\n    const sorted: Record<string, unknown> = {};\n\n    for (const key of Object.keys(options as Record<string, unknown>).sort()) {\n      sorted[key] = (options as Record<string, unknown>)[key];\n    }\n\n    try {\n      return `${locale}:${JSON.stringify(sorted)}`;\n    } catch {\n      // Circular references or BigInt values — fall back to locale-only key.\n      // Multiple callers with different unserializable options will share the same formatter instance.\n      return locale;\n    }\n  }\n\n  return {\n    clear() {\n      numberCache.clear();\n      currencyCache.clear();\n      dateCache.clear();\n      relativeCache.clear();\n      listCache.clear();\n      durationCache.clear();\n    },\n\n    currency(value, currency, options) {\n      const locale = getLocale();\n      const opts: Intl.NumberFormatOptions = { ...options, currency, style: 'currency' };\n\n      return getOrCreate(currencyCache, cachedKey(locale, opts), () => new Intl.NumberFormat(locale, opts)).format(\n        value,\n      );\n    },\n\n    date(value, options) {\n      const locale = getLocale();\n\n      return getOrCreate(dateCache, cachedKey(locale, options), () => new Intl.DateTimeFormat(locale, options)).format(\n        value,\n      );\n    },\n\n    duration(value, options) {\n      const locale = getLocale();\n      const IntlExt = Intl as typeof Intl & { DurationFormat?: DurationFormatterCtor };\n\n      if (!IntlExt.DurationFormat) return durationLabeled(value);\n\n      if (DURATION_UNITS.every((u) => value[u] === undefined)) return '';\n\n      return getOrCreate(\n        durationCache,\n        cachedKey(locale, options),\n        () => new IntlExt.DurationFormat!(locale, options),\n      ).format(value);\n    },\n\n    list(value, options) {\n      const locale = getLocale();\n      const items = value.map((v) => String(v));\n      // list() has exactly two string options with small finite value domains.\n      // We normalize both to their resolved defaults and build the key directly\n      // rather than using cachedKey(). This also prevents cache misses when\n      // callers pass { style: 'long', type: 'and' } vs {} (same ListFormat).\n      const style = options?.style ?? 'long';\n      const type = options?.type === 'or' ? 'disjunction' : 'conjunction';\n\n      return getOrCreate(\n        listCache,\n        cachedKey(locale, { style, type }),\n        () => new Intl.ListFormat(locale, { style, type }),\n      ).format(items);\n    },\n\n    number(value, options) {\n      const locale = getLocale();\n\n      return getOrCreate(numberCache, cachedKey(locale, options), () => new Intl.NumberFormat(locale, options)).format(\n        value,\n      );\n    },\n\n    relative(value, unit, options) {\n      const locale = getLocale();\n\n      return getOrCreate(\n        relativeCache,\n        cachedKey(locale, options),\n        () => new Intl.RelativeTimeFormat(locale, options),\n      ).format(value, unit);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"format.js","names":[],"sources":["../src/format.ts"],"sourcesContent":["/**\n * /lingua/format\n *\n * Standalone Intl formatter factory. Import from `/lingua/format`.\n * Creates formatters for numbers, dates, currencies, lists, durations, and relative time.\n *\n * Pass a static locale string or a reactive locale getter.\n *\n * @example\n * ```ts\n * import { createFormatter } from '@vielzeug/lingua/format';\n *\n * // Static locale\n * const fmt = createFormatter('en-US');\n *\n * // Reactive — always reads the current locale from the i18n instance\n * const fmt = createFormatter(() => i18n.locale);\n *\n * fmt.number(1_234.56);\n * fmt.currency(9.99, 'USD');\n * fmt.date(new Date());\n * fmt.relative(-1, 'day');\n * fmt.list(['A', 'B', 'C']);\n * fmt.duration({ hours: 1, minutes: 30 });\n * ```\n */\n\nimport { getOrCreate } from './_bounded-cache';\n\nconst FORMAT_CACHE_MAX = 128;\n\nexport type DurationValue = Partial<\n  Record<\n    | 'days'\n    | 'hours'\n    | 'microseconds'\n    | 'milliseconds'\n    | 'minutes'\n    | 'months'\n    | 'nanoseconds'\n    | 'seconds'\n    | 'weeks'\n    | 'years',\n    number\n  >\n>;\n\nexport type DurationFormatOptions = {\n  hours?: '2-digit' | 'numeric';\n  microseconds?: 'numeric';\n  milliseconds?: 'numeric';\n  minutes?: '2-digit' | 'numeric';\n  nanoseconds?: 'numeric';\n  seconds?: '2-digit' | 'numeric';\n  style?: 'digital' | 'long' | 'narrow' | 'short';\n};\n\nexport type ListFormatOptions = {\n  style?: 'long' | 'narrow' | 'short';\n  type?: 'and' | 'or';\n};\n\nexport type Formatter = {\n  /**\n   * Clears all cached `Intl` formatter instances. Useful after a locale change on a long-running\n   * SSR server, or to reclaim memory.\n   *\n   * @note This clears the cache for **all callers sharing this formatter instance**. When called on\n   * `i18n.fmt`, the cache is cleared for every part of the application that reads `i18n.fmt`.\n   * `setLocale()` already calls `clear()` automatically — manual calls are rarely needed.\n   */\n  clear(): void;\n  currency(value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, 'currency' | 'style'>): string;\n  date(value: Date | number, options?: Intl.DateTimeFormatOptions): string;\n  /**\n   * Formats a duration using `Intl.DurationFormat` when available, or a compact labeled fallback\n   * (e.g. `'1h 30min'`). Returns `''` when every field of `value` is `undefined`.\n   *\n   * @note The fallback labels (`h`, `min`, `s`, `ms`, etc.) are English-only and are not\n   * locale-aware. If `Intl.DurationFormat` is unavailable in your target environment and\n   * you need localised duration output, provide your own formatter using the individual\n   * duration fields from `DurationValue`.\n   */\n  duration(value: DurationValue, options?: DurationFormatOptions): string;\n  list(value: Array<string | number>, options?: ListFormatOptions): string;\n  /** Formats a number with the current locale. */\n  number(value: number, options?: Intl.NumberFormatOptions): string;\n  relative(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;\n};\n\n// ─── Internal ─────────────────────────────────────────────────────────────────\n\nconst DURATION_UNITS: Array<keyof DurationValue> = [\n  'years',\n  'months',\n  'weeks',\n  'days',\n  'hours',\n  'minutes',\n  'seconds',\n  'milliseconds',\n  'microseconds',\n  'nanoseconds',\n];\n\nconst DURATION_LABELS: Record<keyof DurationValue, string> = {\n  days: 'd',\n  hours: 'h',\n  microseconds: 'us',\n  milliseconds: 'ms',\n  minutes: 'min',\n  months: 'mo',\n  nanoseconds: 'ns',\n  seconds: 's',\n  weeks: 'w',\n  years: 'y',\n};\n\ntype DurationFormatterCtor = new (\n  locale: string,\n  options?: DurationFormatOptions,\n) => { format(value: DurationValue): string };\n\nfunction durationLabeled(value: DurationValue): string {\n  return DURATION_UNITS.map((unit) => {\n    const amount = value[unit];\n\n    return typeof amount === 'number' ? `${amount}${DURATION_LABELS[unit]}` : undefined;\n  })\n    .filter((part): part is string => part !== undefined)\n    .join(' ');\n}\n\n// ─── Factory ──────────────────────────────────────────────────────────────────\n\n/**\n * Creates a formatter bound to a locale. Pass a static locale string or a\n * reactive getter function `() => string` (e.g. `() => i18n.locale`).\n */\nexport function createFormatter(source: string | (() => string)): Formatter {\n  const numberCache = new Map<string, Intl.NumberFormat>();\n  const currencyCache = new Map<string, Intl.NumberFormat>();\n  const dateCache = new Map<string, Intl.DateTimeFormat>();\n  const relativeCache = new Map<string, Intl.RelativeTimeFormat>();\n  const listCache = new Map<string, Intl.ListFormat>();\n  const durationCache = new Map<string, { format(value: DurationValue): string }>();\n\n  const getLocale = typeof source === 'string' ? () => source : source;\n\n  function cachedKey(locale: string, options?: object): string {\n    if (!options) return locale;\n\n    const sorted: Record<string, unknown> = {};\n\n    for (const key of Object.keys(options as Record<string, unknown>).sort()) {\n      sorted[key] = (options as Record<string, unknown>)[key];\n    }\n\n    try {\n      return `${locale}:${JSON.stringify(sorted)}`;\n    } catch {\n      // Circular references or BigInt values — fall back to locale-only key.\n      // Multiple callers with different unserializable options will share the same formatter instance.\n      return locale;\n    }\n  }\n\n  return {\n    clear() {\n      numberCache.clear();\n      currencyCache.clear();\n      dateCache.clear();\n      relativeCache.clear();\n      listCache.clear();\n      durationCache.clear();\n    },\n\n    currency(value, currency, options) {\n      const locale = getLocale();\n      const opts: Intl.NumberFormatOptions = { ...options, currency, style: 'currency' };\n\n      return getOrCreate(\n        currencyCache,\n        cachedKey(locale, opts),\n        FORMAT_CACHE_MAX,\n        () => new Intl.NumberFormat(locale, opts),\n      ).format(value);\n    },\n\n    date(value, options) {\n      const locale = getLocale();\n\n      return getOrCreate(\n        dateCache,\n        cachedKey(locale, options),\n        FORMAT_CACHE_MAX,\n        () => new Intl.DateTimeFormat(locale, options),\n      ).format(value);\n    },\n\n    duration(value, options) {\n      const locale = getLocale();\n      const IntlExt = Intl as typeof Intl & { DurationFormat?: DurationFormatterCtor };\n\n      if (!IntlExt.DurationFormat) return durationLabeled(value);\n\n      if (DURATION_UNITS.every((u) => value[u] === undefined)) return '';\n\n      return getOrCreate(\n        durationCache,\n        cachedKey(locale, options),\n        FORMAT_CACHE_MAX,\n        () => new IntlExt.DurationFormat!(locale, options),\n      ).format(value);\n    },\n\n    list(value, options) {\n      const locale = getLocale();\n      const items = value.map((v) => String(v));\n      // list() has exactly two string options with small finite value domains.\n      // We normalize both to their resolved defaults and build the key directly\n      // rather than using cachedKey(). This also prevents cache misses when\n      // callers pass { style: 'long', type: 'and' } vs {} (same ListFormat).\n      const style = options?.style ?? 'long';\n      const type = options?.type === 'or' ? 'disjunction' : 'conjunction';\n\n      return getOrCreate(\n        listCache,\n        cachedKey(locale, { style, type }),\n        FORMAT_CACHE_MAX,\n        () => new Intl.ListFormat(locale, { style, type }),\n      ).format(items);\n    },\n\n    number(value, options) {\n      const locale = getLocale();\n\n      return getOrCreate(\n        numberCache,\n        cachedKey(locale, options),\n        FORMAT_CACHE_MAX,\n        () => new Intl.NumberFormat(locale, options),\n      ).format(value);\n    },\n\n    relative(value, unit, options) {\n      const locale = getLocale();\n\n      return getOrCreate(\n        relativeCache,\n        cachedKey(locale, options),\n        FORMAT_CACHE_MAX,\n        () => new Intl.RelativeTimeFormat(locale, options),\n      ).format(value, unit);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/i18n-types.d.ts

@@ -143,6 +143,10 @@ export type I18n<M extends Messages = Messages> = {
      * Returns `true` if the given key exists in the active fallback chain — either as a leaf
      * string key or as a plural branch (any key under `key.` prefix).
      *
+     * **Note:** a branch-only key (e.g. `items` when only `items.one`/`items.other` exist) makes
+     * `has()` return `true`, but `t()` can't resolve it — use `tp(key, count)` for those. Calling
+     * `t()` on a branch-only key logs a dev-mode warning pointing at this.
+     *
      * @example
      * i18n.has('inbox')       // true for leaf or pipe-plural expanded branch
      * i18n.has('inbox.one')   // true for explicit sub-key
@@ -204,6 +208,10 @@ export type I18n<M extends Messages = Messages> = {
      * @remarks The namespace registry is **not** included in `I18nState`. After restoring,
      * call `extend()` for each namespace before relying on namespace-patched keys.
      *
+     * @remarks Unlike `register()` and construction, this does **not** run the automatic
+     * dev-mode plural-form check — the assumption is that `state` was already registered (and
+     * therefore already checked) once on whatever system produced it.
+     *
      * @throws `LinguaDisposedError` if called on a disposed instance.
      * @throws `LinguaRestoreError` if the state's locale has no catalog.
      */
@@ -211,7 +219,10 @@ export type I18n<M extends Messages = Messages> = {
     /**
      * Returns a scoped translator. All `t()` / `tp()` calls are automatically prefixed with `${prefix}.`.
      * The returned object is memoized — calling `scope(prefix)` with the same string always returns the
-     * same reference.
+     * same reference, as long as it's still in the cache (bounded at 128 distinct prefixes; oldest
+     * evicts first). Intended for a static, finite set of prefixes (nav sections, form names, ...) —
+     * don't pass a dynamic per-item prefix (e.g. `scope(`item.${id}`)` in a list render), or the
+     * memoization guarantee stops holding once you exceed the bound.
      *
      * @example
      * const nav = i18n.scope('nav');

package/dist/i18n-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-types.d.ts","sourceRoot":"","sources":["../src/i18n-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"i18n-types.d.ts","sourceRoot":"","sources":["../src/i18n-types.ts"],"names":[],"mappings":"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"}

package/dist/i18n.cjs

@@ -1,2 +1,2 @@
-const e=require("./format.cjs"),t=require("./_dev.cjs"),n=require("./template.cjs"),r=require("./_catalog.cjs"),i=require("./errors.cjs"),a=require("./_catalog-store.cjs"),o=require("./_chain.cjs"),s=require("./_namespace-store.cjs");function c(e,t,n){let{chain:r,set:i}=o.buildLocaleChain(e,t,n);return{chain:r,chainSet:i,locale:e}}function l(e,t,n,r){let i=[];return!r&&n===0&&i.push(`${e}.zero`),(t!==`zero`||r)&&i.push(`${e}.${t}`),t!==`other`&&i.push(`${e}.other`),i}function u(e){return d(e)}function d(u,f){let p=u??{},m=o.createLocaleCaches(),h=e=>o.canon(e,m),g=Array.isArray(p.fallback)?p.fallback.map(h):p.fallback?[h(p.fallback)]:[],_=!1,v=new AbortController,y=a.createCatalogStore(()=>_),b=s.createNamespaceStore(()=>_),x=c(h(p.locale??`en`),g,m),S=new Set,C=new Set,w=p.onMissingKey??(e=>e),T=p.onMissingVar??(e=>`{${e}}`),E=p.onSubscriberError??(e=>t.error(`subscriber error`,e)),D,O=new Map,k=()=>(D||=e.createFormatter(()=>x.locale),D),A=e=>{for(let t of x.chain){let n=y.resolve(t)?.get(e);if(n!==void 0)return n}},j=e=>{if(A(e)!==void 0)return!0;for(let t of x.chain){let n=y.resolve(t);if(n&&n.prefixes.has(e))return!0}return!1},M=(e,t,r)=>n.renderTemplate(t.compiled,r,e,x.locale,T),N=(e,t)=>{let n=String(e),r=A(n);return r?M(n,r,t):w(n,x.locale)},P=(e,t,n)=>{if(!Number.isFinite(t))throw new i.LinguaInvalidCountError("`count` must be a finite number.");let r=n?.vars,a=n?.ordinal??!1;if(r&&Object.hasOwn(r,`count`))throw new i.LinguaCountInVarsError("`tp` does not allow `vars.count`; `count` is injected automatically.");let s=String(e),c=r?{count:t,...r}:{count:t};for(let e of x.chain){let n=y.resolve(e);if(!n)continue;let r=l(s,o.selectPluralForm(e,t,a,m),t,a);for(let e of r){let t=n.get(e);if(t!==void 0)return M(e,t,c)}}return w(s,x.locale)},F={locale:x.locale,t:N,tp:P},I=()=>{F={locale:x.locale,t:N,tp:P};let e=[...S];for(let t of e)try{t(F)}catch(e){E(e)}};if(y.onChange=e=>{x.chainSet.has(e)&&I()},f?.catalogStore&&y.seedFrom(f.catalogStore.catalogs,f.catalogStore.pendingLoaders),f?.nsStore&&b.seedFrom(f.nsStore),p.catalogs){let e=new Map,t=new Map;for(let[n,i]of Object.entries(p.catalogs)){let a=h(n);if(typeof i==`function`)t.set(a,i);else{let t=new r.CatalogEntry;t.setAll(r.flattenStrings(i)),e.set(a,t)}}y.seedFrom(e,t)}let L=e=>y.preload(h(e)),R=0;return{get disposalSignal(){return v.signal},dispose(){if(!_){_=!0,v.abort();for(let e of[...C])e();C.clear(),S.clear(),y.dispose(),b.dispose(),O.clear()}},get disposed(){return _},extend(e,t,n){i.checkDisposed(_),b.registerNamespace(e,t);let r=n?h(n):x.locale;return b.loadNamespace(e,r,(e,t)=>y.patch(e,t))},get fmt(){return k()},fork(e){return d({fallback:e?.fallback??(g.length>0?g:void 0),locale:e?.locale??x.locale,onMissingKey:e?.onMissingKey??p.onMissingKey,onMissingVar:e?.onMissingVar??p.onMissingVar,onSubscriberError:e?.onSubscriberError??p.onSubscriberError},{catalogStore:y,nsStore:b})},getSnapshot(){return F},getState(){let e={};for(let[t,n]of y.catalogs)e[t]=Object.fromEntries([...n.entries.entries()].map(([e,{message:t}])=>[e,t]));return{catalogs:e,locale:x.locale}},getSupportedLocales(e){let t=[...y.knownLocales()];return e===!0?t.sort():t},has(e){return j(String(e))},isLoaded(e){try{return y.isLoaded(h(e))}catch{return!1}},isNamespaceLoaded(e,t){if(!t)return b.isLoaded(e,x.locale);try{return b.isLoaded(e,h(t))}catch{return!1}},isNamespaceRegistered(e){return b.isRegistered(e)},isRegistered(e){try{return y.isRegistered(h(e))}catch{return!1}},loadNamespace(e,t){let n=t?h(t):x.locale;return b.loadNamespace(e,n,(e,t)=>y.patch(e,t))},get locale(){return x.locale},preload:L,register(e,t){let n=h(e);return y.register(n,t,b)},registerNamespace(e,t){b.registerNamespace(e,t)},restoreState(e){if(i.checkDisposed(_),!Object.hasOwn(e.catalogs,e.locale))throw new i.LinguaRestoreError(`restoreState: locale "${e.locale}" has no catalog in the provided state.`);let t=new Map,n=y.knownLocales();for(let e of n)b.clearLocale(e);for(let[n,i]of Object.entries(e.catalogs)){let e=h(n),a=new r.CatalogEntry;a.setAll(Object.entries(i)),t.set(e,a)}y.dispose(),y.onChange=e=>{x.chainSet.has(e)&&I()},y.seedFrom(t,new Map),x=c(h(e.locale),g,m),D?.clear(),I()},scope(e){let t=String(e),n=O.get(t);if(n)return n;let r={get fmt(){return k()},has:e=>j(`${t}.${e}`),t:(e,n)=>N(`${t}.${e}`,n),tp:(e,n,r)=>P(`${t}.${e}`,n,r)};return O.set(t,r),r},async setLocale(e){i.checkDisposed(_);let t=h(e);if(x.locale===t)return;let n=++R;await L(t),!(_||R!==n)&&(x=c(t,g,m),D?.clear(),I())},subscribe:(e,t)=>{let n=t?.signal,r=()=>{S.delete(e),n?.removeEventListener(`abort`,r),C.delete(r)};if(_)throw new i.LinguaDisposedError;if(n?.aborted)return r;if(t?.immediate===!0)try{e(F)}catch(e){return E(e),r}return S.add(e),n?.addEventListener(`abort`,r,{once:!0}),C.add(r),r},[Symbol.dispose](){this.dispose()},t:N,tp:P}}function f(e){return e.getState()}function p(e,t){e.restoreState(t)}exports.LinguaCountInVarsError=i.LinguaCountInVarsError,exports.LinguaDisposedError=i.LinguaDisposedError,exports.LinguaError=i.LinguaError,exports.LinguaInvalidCountError=i.LinguaInvalidCountError,exports.LinguaInvalidLocaleError=i.LinguaInvalidLocaleError,exports.LinguaMissingLocaleError=i.LinguaMissingLocaleError,exports.LinguaNamespaceMissingError=i.LinguaNamespaceMissingError,exports.LinguaRestoreError=i.LinguaRestoreError,exports.createI18n=u,exports.hydrateI18n=p,exports.serializeI18n=f;
+const e=require("./_bounded-cache.cjs"),t=require("./format.cjs"),n=require("./_dev.cjs"),r=require("./_catalog.cjs"),i=require("./errors.cjs"),a=require("./_catalog-store.cjs"),o=require("./_chain.cjs"),s=require("./_namespace-store.cjs"),c=require("./_translate.cjs");var l=128;function u(e,t,n){let{chain:r,set:i}=o.buildLocaleChain(e,t,n);return{chain:r,chainSet:i,locale:e}}function d(e){return f(e)}function f(d,p){let m=d??{},h=o.createLocaleCaches(),g=e=>o.canon(e,h),_=Array.isArray(m.fallback)?m.fallback.map(g):m.fallback?[g(m.fallback)]:[],v=!1,y=new AbortController,b=a.createCatalogStore(()=>v),x=s.createNamespaceStore(()=>v),S=u(g(m.locale??`en`),_,h),C=new Set,w=new Set,T=m.onMissingKey??(e=>e),E=m.onMissingVar??(e=>`{${e}}`),D=m.onSubscriberError??(e=>n.error(`subscriber error`,e)),O,k=new Map,A=()=>(O||=t.createFormatter(()=>S.locale),O),j=()=>({caches:h,catalogStore:b,chain:S.chain,locale:S.locale,onMissingKey:T,onMissingVar:E}),M=e=>c.hasKey(j(),e),N=(e,t)=>c.translate(j(),String(e),t),P=(e,t,n)=>c.translatePlural(j(),String(e),t,n),F={locale:S.locale,t:N,tp:P},I=()=>{F={locale:S.locale,t:N,tp:P};let e=[...C];for(let t of e)try{t(F)}catch(e){D(e)}};if(b.onChange=e=>{S.chainSet.has(e)&&I()},p?.catalogStore&&b.seedFrom(p.catalogStore.snapshotCatalogs(),p.catalogStore.snapshotLoaders()),p?.nsStore&&x.seedFrom(p.nsStore),m.catalogs){let e=new Map,t=new Map;for(let[n,i]of Object.entries(m.catalogs)){let o=g(n);if(typeof i==`function`)t.set(o,i);else{let t=new r.CatalogEntry;t.setAll(r.flattenStrings(i)),e.set(o,t),a.validateCatalogInDev(o,i)}}b.seedFrom(e,t)}let L=e=>b.preload(g(e)),R=0,z={get disposalSignal(){return y.signal},dispose(){if(!v){v=!0,y.abort();for(let e of[...w])e();w.clear(),C.clear(),b.dispose(),x.dispose(),k.clear()}},get disposed(){return v},extend(e,t,n){i.checkDisposed(v),x.registerNamespace(e,t);let r=n?g(n):S.locale;return x.loadNamespace(e,r,(e,t)=>b.patch(e,t))},get fmt(){return A()},fork(e){return f({fallback:e?.fallback??(_.length>0?_:void 0),locale:e?.locale??S.locale,onMissingKey:e?.onMissingKey??m.onMissingKey,onMissingVar:e?.onMissingVar??m.onMissingVar,onSubscriberError:e?.onSubscriberError??m.onSubscriberError},{catalogStore:b,nsStore:x})},getSnapshot(){return F},getState(){let e={};for(let[t,n]of b.snapshotCatalogs())e[t]=Object.fromEntries([...n.entries.entries()].map(([e,{message:t}])=>[e,t]));return{catalogs:e,locale:S.locale}},getSupportedLocales(e){let t=[...b.knownLocales()];return e===!0?t.sort():t},has(e){return M(String(e))},isLoaded(e){try{return b.isLoaded(g(e))}catch{return!1}},isNamespaceLoaded(e,t){if(!t)return x.isLoaded(e,S.locale);try{return x.isLoaded(e,g(t))}catch{return!1}},isNamespaceRegistered(e){return x.isRegistered(e)},isRegistered(e){try{return b.isRegistered(g(e))}catch{return!1}},loadNamespace(e,t){let n=t?g(t):S.locale;return x.loadNamespace(e,n,(e,t)=>b.patch(e,t))},get locale(){return S.locale},preload:L,register(e,t){let n=g(e);return b.register(n,t,x)},registerNamespace(e,t){x.registerNamespace(e,t)},restoreState(e){if(i.checkDisposed(v),!Object.hasOwn(e.catalogs,e.locale))throw new i.LinguaRestoreError(`restoreState: locale "${e.locale}" has no catalog in the provided state.`);let t=new Map,n=b.knownLocales();for(let e of n)x.clearLocale(e);for(let[n,i]of Object.entries(e.catalogs)){let e=g(n),a=new r.CatalogEntry;a.setAll(Object.entries(i)),t.set(e,a)}b.dispose(),b.onChange=e=>{S.chainSet.has(e)&&I()},b.seedFrom(t,new Map),S=u(g(e.locale),_,h),O?.clear(),I()},scope(t){let n=String(t);return e.getOrCreate(k,n,l,()=>({get fmt(){return A()},has:e=>M(`${n}.${e}`),t:(e,t)=>N(`${n}.${e}`,t),tp:(e,t,r)=>P(`${n}.${e}`,t,r)}))},async setLocale(e){i.checkDisposed(v);let t=g(e);if(S.locale===t)return;let n=++R;await L(t),!(v||R!==n)&&(S=u(t,_,h),O?.clear(),I())},subscribe:(e,t)=>{let n=t?.signal,r=()=>{C.delete(e),n?.removeEventListener(`abort`,r),w.delete(r)};if(v)throw new i.LinguaDisposedError;if(n?.aborted)return r;if(t?.immediate===!0)try{e(F)}catch(e){return D(e),r}return C.add(e),n?.addEventListener(`abort`,r,{once:!0}),w.add(r),r},[Symbol.dispose](){z.dispose()},t:N,tp:P};return z}exports.LinguaCountInVarsError=i.LinguaCountInVarsError,exports.LinguaDisposedError=i.LinguaDisposedError,exports.LinguaError=i.LinguaError,exports.LinguaInvalidCountError=i.LinguaInvalidCountError,exports.LinguaInvalidLocaleError=i.LinguaInvalidLocaleError,exports.LinguaMissingLocaleError=i.LinguaMissingLocaleError,exports.LinguaNamespaceMissingError=i.LinguaNamespaceMissingError,exports.LinguaRestoreError=i.LinguaRestoreError,exports.createI18n=d;
 //# sourceMappingURL=i18n.cjs.map

package/dist/i18n.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.cjs","names":[],"sources":["../src/i18n.ts"],"sourcesContent":["import type {\n  I18n,\n  I18nOptions,\n  I18nSnapshot,\n  I18nState,\n  Locale,\n  MessageBranchKeys,\n  MessageLeafKeys,\n  ScopedI18n,\n  SubscribeOptions,\n  TpOptions,\n  TranslateVars,\n  Unsubscribe,\n} from './i18n-types';\n\nimport { CatalogEntry, type Messages, flattenStrings } from './_catalog';\nimport { type CatalogStore, type Loader, type LocaleSource, createCatalogStore } from './_catalog-store';\nimport { type LocaleCaches, buildLocaleChain, canon, createLocaleCaches, selectPluralForm } from './_chain';\nimport { error as logError } from './_dev';\nimport { type NamespaceFactory, type NamespaceStore, createNamespaceStore } from './_namespace-store';\nimport {\n  LinguaCountInVarsError,\n  LinguaDisposedError,\n  LinguaInvalidCountError,\n  LinguaRestoreError,\n  checkDisposed,\n} from './errors';\nimport { type Formatter, createFormatter } from './format';\nimport { type CompiledTemplate, renderTemplate } from './template';\n\nexport {\n  LinguaCountInVarsError,\n  LinguaDisposedError,\n  LinguaError,\n  LinguaInvalidCountError,\n  LinguaInvalidLocaleError,\n  LinguaMissingLocaleError,\n  LinguaNamespaceMissingError,\n  LinguaRestoreError,\n} from './errors';\n\nexport type {\n  I18n,\n  I18nOptions,\n  I18nSnapshot,\n  I18nState,\n  Locale,\n  MessageBranchKeys,\n  MessageLeafKeys,\n  ScopedI18n,\n  SubscribeOptions,\n  TpOptions,\n  TranslateVars,\n  Unsubscribe,\n} from './i18n-types';\nexport type { Loader, LocaleSource } from './_catalog-store';\nexport type { Messages } from './_catalog';\nexport type { NamespaceFactory } from './_namespace-store';\n\n// ─── Locale state ─────────────────────────────────────────────────────────────\n// Replaced atomically on every locale change.\n\ntype LocaleState = {\n  readonly chain: readonly Locale[];\n  readonly chainSet: ReadonlySet<Locale>;\n  readonly locale: Locale;\n};\n\nfunction buildState(locale: Locale, fallback: Locale[], caches: LocaleCaches): LocaleState {\n  const { chain, set } = buildLocaleChain(locale, fallback, caches);\n\n  return { chain, chainSet: set, locale };\n}\n\n// ─── Plural key priority ──────────────────────────────────────────────────────\n// Cardinal zero: try .zero override first, then CLDR form, then .other as final fallback.\n// Ordinal / non-zero: try CLDR form, then .other as final fallback.\nfunction pluralKeyPriority(base: string, form: string, count: number, ordinal: boolean): string[] {\n  const keys: string[] = [];\n\n  if (!ordinal && count === 0) keys.push(`${base}.zero`);\n\n  if (form !== 'zero' || ordinal) keys.push(`${base}.${form}`);\n\n  if (form !== 'other') keys.push(`${base}.other`);\n\n  return keys;\n}\n\n// ─── Factory ──────────────────────────────────────────────────────────────────\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  return _createI18nImpl<M>(config);\n}\n\n// ─── Internal seed shape ──────────────────────────────────────────────────────\n\ntype I18nSeed<M extends Messages> = {\n  catalogStore?: CatalogStore<M>;\n  nsStore?: NamespaceStore;\n};\n\nfunction _createI18nImpl<M extends Messages = Messages>(config?: I18nOptions<M>, _seed?: I18nSeed<M>): I18n<M> {\n  const cfg: I18nOptions<M> = config ?? {};\n\n  // ─── Per-instance caches (no shared module-level state) ───────────────────\n  const caches: LocaleCaches = createLocaleCaches();\n\n  const canonL = (loc: string) => canon(loc, caches);\n\n  const fallback = Array.isArray(cfg.fallback) ? cfg.fallback.map(canonL) : cfg.fallback ? [canonL(cfg.fallback)] : [];\n\n  // ─── Disposal ─────────────────────────────────────────────────────────────\n  let disposed = false;\n  const disposeController = new AbortController();\n\n  // ─── Bounded stores ───────────────────────────────────────────────────────\n  const catalogStore: CatalogStore<M> = createCatalogStore(() => disposed);\n  const nsStore: NamespaceStore = createNamespaceStore(() => disposed);\n\n  // ─── Locale state ─────────────────────────────────────────────────────────\n  let state: LocaleState = buildState(canonL(cfg.locale ?? 'en'), fallback, caches);\n\n  // ─── Subscribers ──────────────────────────────────────────────────────────\n  const subscribers = new Set<(snapshot: I18nSnapshot) => void>();\n  const subscriptionUnsubscribers = new Set<Unsubscribe>();\n\n  const onMissingKey = cfg.onMissingKey ?? ((key: string) => key);\n  const onMissingVar = cfg.onMissingVar ?? ((varName: string) => `{${varName}}`);\n  const onSubscriberError = cfg.onSubscriberError ?? ((error: unknown) => logError('subscriber error', error));\n\n  // ─── Lazy formatter — avoids Intl overhead for SSR forks that only need t(). ──\n  let _fmt: Formatter | undefined;\n\n  // ─── Scope cache — stable object references per prefix for reactive framework renders. ──\n  const scopeCache = new Map<string, ScopedI18n>();\n\n  const getFormatter = (): Formatter => {\n    if (!_fmt) _fmt = createFormatter(() => state.locale);\n\n    return _fmt;\n  };\n\n  // ─── Translate helpers ────────────────────────────────────────────────────\n\n  // Single-pass entry lookup across the active fallback chain.\n  const findEntry = (key: string): { compiled: CompiledTemplate; message: string } | undefined => {\n    for (const candidate of state.chain) {\n      const found = catalogStore.resolve(candidate)?.get(key);\n\n      if (found !== undefined) return found;\n    }\n\n    return undefined;\n  };\n\n  // Shared by has() and scope().has() — true if `base` exists as a leaf key or a plural branch prefix.\n  const hasKey = (base: string): boolean => {\n    if (findEntry(base) !== undefined) return true;\n\n    for (const candidate of state.chain) {\n      const catalog = catalogStore.resolve(candidate);\n\n      if (!catalog) continue;\n\n      if (catalog.prefixes.has(base)) return true;\n    }\n\n    return false;\n  };\n\n  const interpolate = (\n    key: string,\n    found: { compiled: CompiledTemplate; message: string },\n    vars: TranslateVars | undefined,\n  ): string => renderTemplate(found.compiled, vars, key, state.locale, onMissingVar);\n\n  const translate = (key: MessageLeafKeys<M> | (string & {}), vars?: TranslateVars): string => {\n    const base = String(key);\n    const found = findEntry(base);\n\n    if (!found) return onMissingKey(base, state.locale);\n\n    return interpolate(base, found, vars);\n  };\n\n  const translatePlural = (key: MessageBranchKeys<M> | (string & {}), count: number, options?: TpOptions): string => {\n    if (!Number.isFinite(count)) {\n      throw new LinguaInvalidCountError('`count` must be a finite number.');\n    }\n\n    const vars = options?.vars;\n    const ordinal = options?.ordinal ?? false;\n\n    if (vars && Object.hasOwn(vars, 'count')) {\n      throw new LinguaCountInVarsError('`tp` does not allow `vars.count`; `count` is injected automatically.');\n    }\n\n    const base = String(key);\n    const mergedVars = vars ? { count, ...vars } : { count };\n\n    // Walk the fallback chain locale-by-locale, selecting CLDR plural form using each\n    // locale's own rules. This ensures cross-locale fallbacks produce grammatically correct forms.\n    for (const candidate of state.chain) {\n      const catalog = catalogStore.resolve(candidate);\n\n      if (!catalog) continue;\n\n      const form = selectPluralForm(candidate, count, ordinal, caches);\n      const keys = pluralKeyPriority(base, form, count, ordinal);\n\n      for (const k of keys) {\n        const found = catalog.get(k);\n\n        if (found !== undefined) {\n          return interpolate(k, found, mergedVars);\n        }\n      }\n    }\n\n    return onMissingKey(base, state.locale);\n  };\n\n  // ─── bump() ───────────────────────────────────────────────────────────────\n  // Rebuilds the snapshot and notifies all current subscribers.\n\n  let snapshot: I18nSnapshot = {\n    locale: state.locale,\n    t: translate,\n    tp: translatePlural,\n  };\n\n  const bump = (): void => {\n    snapshot = { locale: state.locale, t: translate, tp: translatePlural };\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  // ─── Wire catalog store onChange → bump ───────────────────────────────────\n  catalogStore.onChange = (loc: Locale) => {\n    if (state.chainSet.has(loc)) bump();\n  };\n\n  // ─── Seed from parent fork ─────────────────────────────────────────────────\n  if (_seed?.catalogStore) {\n    catalogStore.seedFrom(_seed.catalogStore.catalogs, _seed.catalogStore.pendingLoaders);\n  }\n\n  if (_seed?.nsStore) {\n    nsStore.seedFrom(_seed.nsStore);\n  }\n\n  // ─── Initial catalogs from config ─────────────────────────────────────────\n  if (cfg.catalogs) {\n    const staticEntries = new Map<Locale, CatalogEntry>();\n    const loaderEntries = new Map<Locale, Loader<M>>();\n\n    for (const [loc, source] of Object.entries(cfg.catalogs)) {\n      const normalized = canonL(loc);\n\n      if (typeof source === 'function') {\n        loaderEntries.set(normalized, source as Loader<M>);\n      } else {\n        const entry = new CatalogEntry();\n\n        entry.setAll(flattenStrings(source as M));\n        staticEntries.set(normalized, entry);\n      }\n    }\n\n    // Use seedFrom for zero-overhead init (no bump, no notifications during setup)\n    catalogStore.seedFrom(staticEntries, loaderEntries);\n  }\n\n  // ─── Preload helper ───────────────────────────────────────────────────────\n\n  const preload = (loc: Locale): Promise<void> => catalogStore.preload(canonL(loc));\n\n  // ─── Monotonic generation counter — last writer wins for concurrent setLocale() ──\n  let switchGen = 0;\n\n  // ─── Subscribe helper ─────────────────────────────────────────────────────\n\n  const subscribeInternal = (callback: (snapshot: I18nSnapshot) => void, options?: SubscribeOptions): Unsubscribe => {\n    const signal = options?.signal;\n\n    const unsubscribe = (): void => {\n      subscribers.delete(callback);\n      signal?.removeEventListener('abort', unsubscribe);\n      subscriptionUnsubscribers.delete(unsubscribe);\n    };\n\n    if (disposed) throw new LinguaDisposedError();\n\n    if (signal?.aborted) return unsubscribe;\n\n    if (options?.immediate === true) {\n      try {\n        callback(snapshot);\n      } catch (error) {\n        onSubscriberError(error);\n\n        return unsubscribe;\n      }\n    }\n\n    subscribers.add(callback);\n    signal?.addEventListener('abort', unsubscribe, { once: true });\n    subscriptionUnsubscribers.add(unsubscribe);\n\n    return unsubscribe;\n  };\n\n  // ─── Public object ─────────────────────────────────────────────────────────\n\n  return {\n    get disposalSignal(): AbortSignal {\n      return disposeController.signal;\n    },\n\n    dispose(): void {\n      if (disposed) return;\n\n      disposed = true;\n      disposeController.abort();\n      for (const unsubscribe of [...subscriptionUnsubscribers]) unsubscribe();\n      subscriptionUnsubscribers.clear();\n      subscribers.clear();\n      catalogStore.dispose();\n      nsStore.dispose();\n      scopeCache.clear();\n    },\n\n    get disposed(): boolean {\n      return disposed;\n    },\n\n    extend(ns: string, factory: NamespaceFactory, loc?: Locale): Promise<void> {\n      checkDisposed(disposed);\n\n      nsStore.registerNamespace(ns, factory);\n\n      const normalized = loc ? canonL(loc) : state.locale;\n\n      return nsStore.loadNamespace(ns, normalized, (l, messages) => catalogStore.patch(l, messages));\n    },\n\n    get fmt(): Formatter {\n      return getFormatter();\n    },\n\n    fork(overrides?: Omit<I18nOptions<M>, 'catalogs'>): I18n<M> {\n      return _createI18nImpl(\n        {\n          fallback: overrides?.fallback ?? (fallback.length > 0 ? fallback : undefined),\n          locale: overrides?.locale ?? state.locale,\n          onMissingKey: overrides?.onMissingKey ?? cfg.onMissingKey,\n          onMissingVar: overrides?.onMissingVar ?? cfg.onMissingVar,\n          onSubscriberError: overrides?.onSubscriberError ?? cfg.onSubscriberError,\n        },\n        {\n          catalogStore: catalogStore as CatalogStore<M>,\n          nsStore: nsStore as NamespaceStore,\n        },\n      );\n    },\n\n    getSnapshot() {\n      return snapshot;\n    },\n\n    getState(): I18nState {\n      const catalogsOut: Record<Locale, Record<string, string>> = {};\n\n      for (const [loc, entry] of catalogStore.catalogs) {\n        catalogsOut[loc] = Object.fromEntries([...entry.entries.entries()].map(([k, { message }]) => [k, message]));\n      }\n\n      return { catalogs: catalogsOut, locale: state.locale };\n    },\n\n    getSupportedLocales(sorted?: boolean): Locale[] {\n      const locales = [...catalogStore.knownLocales()];\n\n      return sorted === true ? locales.sort() : locales;\n    },\n\n    has(key: MessageLeafKeys<M> | MessageBranchKeys<M> | (string & {})): boolean {\n      return hasKey(String(key));\n    },\n\n    isLoaded(loc: Locale): boolean {\n      try {\n        return catalogStore.isLoaded(canonL(loc));\n      } catch {\n        return false;\n      }\n    },\n\n    isNamespaceLoaded(ns: string, loc?: Locale): boolean {\n      if (!loc) return nsStore.isLoaded(ns, state.locale);\n\n      try {\n        return nsStore.isLoaded(ns, canonL(loc));\n      } catch {\n        return false;\n      }\n    },\n\n    isNamespaceRegistered(ns: string): boolean {\n      return nsStore.isRegistered(ns);\n    },\n\n    isRegistered(loc: Locale): boolean {\n      try {\n        return catalogStore.isRegistered(canonL(loc));\n      } catch {\n        return false;\n      }\n    },\n\n    loadNamespace(ns: string, loc?: Locale): Promise<void> {\n      const normalized = loc ? canonL(loc) : state.locale;\n\n      return nsStore.loadNamespace(ns, normalized, (l, messages) => catalogStore.patch(l, messages));\n    },\n\n    get locale(): Locale {\n      return state.locale;\n    },\n\n    preload,\n\n    register(loc: Locale, source: LocaleSource<M>): Promise<void> {\n      const normalized = canonL(loc);\n\n      return catalogStore.register(normalized, source, nsStore);\n    },\n\n    registerNamespace(ns: string, factory: NamespaceFactory): void {\n      nsStore.registerNamespace(ns, factory);\n    },\n\n    restoreState(st: I18nState): void {\n      checkDisposed(disposed);\n\n      if (!Object.hasOwn(st.catalogs, st.locale)) {\n        throw new LinguaRestoreError(`restoreState: locale \"${st.locale}\" has no catalog in the provided state.`);\n      }\n\n      const freshEntries = new Map<Locale, CatalogEntry>();\n      const knownLocales = catalogStore.knownLocales();\n\n      for (const knownLocale of knownLocales) {\n        nsStore.clearLocale(knownLocale);\n      }\n\n      for (const [loc, flatCatalog] of Object.entries(st.catalogs)) {\n        const normalized = canonL(loc);\n        const entry = new CatalogEntry();\n\n        entry.setAll(Object.entries(flatCatalog));\n        freshEntries.set(normalized, entry);\n      }\n\n      // Dispose and re-seed the catalog store with the restored entries.\n      // onChange is re-wired immediately after dispose.\n      catalogStore.dispose();\n      catalogStore.onChange = (loc: Locale) => {\n        if (state.chainSet.has(loc)) bump();\n      };\n      catalogStore.seedFrom(freshEntries, new Map());\n\n      const normalized = canonL(st.locale);\n\n      state = buildState(normalized, fallback, caches);\n      _fmt?.clear();\n      bump();\n    },\n\n    scope(prefix: MessageBranchKeys<M> | (string & {})): ScopedI18n {\n      const pre = String(prefix);\n      const cached = scopeCache.get(pre);\n\n      if (cached) return cached;\n\n      const scoped: ScopedI18n = {\n        get fmt() {\n          return getFormatter();\n        },\n        has: (key) => hasKey(`${pre}.${key}`),\n        t: (key, vars?) => translate(`${pre}.${key}`, vars),\n        tp: (key, count, options?) => translatePlural(`${pre}.${key}`, count, options),\n      };\n\n      scopeCache.set(pre, scoped);\n\n      return scoped;\n    },\n\n    async setLocale(next: Locale): Promise<void> {\n      checkDisposed(disposed);\n\n      const normalized = canonL(next);\n\n      if (state.locale === normalized) return;\n\n      // Monotonic generation counter — last writer wins.\n      const gen = ++switchGen;\n\n      await preload(normalized);\n\n      if (disposed || switchGen !== gen) return;\n\n      state = buildState(normalized, fallback, caches);\n      _fmt?.clear();\n      bump();\n    },\n\n    subscribe: subscribeInternal,\n\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n\n    t: translate,\n\n    tp: translatePlural,\n  };\n}\n\n// ─── SSR standalone helpers ───────────────────────────────────────────────────\n\n/**\n * Serialises the currently loaded catalogs and active locale into a plain object.\n * Pass the result to `hydrateI18n()` on the client.\n *\n * Prefer calling `i18n.getState()` directly — these standalone functions are provided\n * for convenience when you receive a plain `I18n` reference without the full type.\n *\n * **Warning:** Only fully resolved catalogs are included. Loader-only locales not yet\n * preloaded are omitted. Use `i18n.isLoaded(locale)` to verify before calling.\n *\n * **Warning:** The namespace registry is **not** serialized — factory functions cannot\n * be converted to JSON. After `hydrateI18n()`, call `extend()` again for each namespace\n * before relying on namespace-patched keys.\n */\nexport function serializeI18n(i18n: I18n): I18nState {\n  return i18n.getState();\n}\n\n/**\n * Hydrates an i18n instance with pre-loaded state (e.g. from a server-rendered payload).\n *\n * Prefer calling `i18n.restoreState(state)` directly — these standalone functions are\n * provided for convenience.\n *\n * @remarks The namespace registry is **not** included in `I18nState`. After hydrating,\n * call `extend()` for each namespace before relying on namespace-patched keys.\n *\n * @throws `LinguaDisposedError` if called on a disposed instance.\n * @throws `LinguaRestoreError` if the state's locale has no catalog.\n */\nexport function hydrateI18n(i18n: I18n, state: I18nState): void {\n  i18n.restoreState(state);\n}\n"],"mappings":"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"}
+{"version":3,"file":"i18n.cjs","names":[],"sources":["../src/i18n.ts"],"sourcesContent":["import type {\n  I18n,\n  I18nOptions,\n  I18nSnapshot,\n  I18nState,\n  Locale,\n  MessageBranchKeys,\n  MessageLeafKeys,\n  ScopedI18n,\n  SubscribeOptions,\n  TpOptions,\n  TranslateVars,\n  Unsubscribe,\n} from './i18n-types';\n\nimport { getOrCreate } from './_bounded-cache';\nimport { CatalogEntry, type Messages, flattenStrings } from './_catalog';\nimport {\n  type CatalogStore,\n  type Loader,\n  type LocaleSource,\n  createCatalogStore,\n  validateCatalogInDev,\n} from './_catalog-store';\nimport { type LocaleCaches, buildLocaleChain, canon, createLocaleCaches } from './_chain';\nimport { error as logError } from './_dev';\nimport { type NamespaceFactory, type NamespaceStore, createNamespaceStore } from './_namespace-store';\nimport {\n  type TranslateContext,\n  hasKey as hasKeyIn,\n  translate as translateIn,\n  translatePlural as translatePluralIn,\n} from './_translate';\nimport { LinguaDisposedError, LinguaRestoreError, checkDisposed } from './errors';\nimport { type Formatter, createFormatter } from './format';\n\nexport {\n  LinguaCountInVarsError,\n  LinguaDisposedError,\n  LinguaError,\n  LinguaInvalidCountError,\n  LinguaInvalidLocaleError,\n  LinguaMissingLocaleError,\n  LinguaNamespaceMissingError,\n  LinguaRestoreError,\n} from './errors';\n\nexport type {\n  I18n,\n  I18nOptions,\n  I18nSnapshot,\n  I18nState,\n  Locale,\n  MessageBranchKeys,\n  MessageLeafKeys,\n  ScopedI18n,\n  SubscribeOptions,\n  TpOptions,\n  TranslateVars,\n  Unsubscribe,\n} from './i18n-types';\nexport type { Loader, LocaleSource } from './_catalog-store';\nexport type { Messages } from './_catalog';\nexport type { NamespaceFactory } from './_namespace-store';\n\n// Bound for the per-instance `scope()` cache — see its declaration below for why it's bounded.\nconst SCOPE_CACHE_MAX = 128;\n\n// ─── Locale state ─────────────────────────────────────────────────────────────\n// Replaced atomically on every locale change.\n\ntype LocaleState = {\n  readonly chain: readonly Locale[];\n  readonly chainSet: ReadonlySet<Locale>;\n  readonly locale: Locale;\n};\n\nfunction buildState(locale: Locale, fallback: Locale[], caches: LocaleCaches): LocaleState {\n  const { chain, set } = buildLocaleChain(locale, fallback, caches);\n\n  return { chain, chainSet: set, locale };\n}\n\n// ─── Factory ──────────────────────────────────────────────────────────────────\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  return _createI18nImpl<M>(config);\n}\n\n// ─── Internal seed shape ──────────────────────────────────────────────────────\n\ntype I18nSeed<M extends Messages> = {\n  catalogStore?: CatalogStore<M>;\n  nsStore?: NamespaceStore;\n};\n\nfunction _createI18nImpl<M extends Messages = Messages>(config?: I18nOptions<M>, _seed?: I18nSeed<M>): I18n<M> {\n  const cfg: I18nOptions<M> = config ?? {};\n\n  // ─── Per-instance caches (no shared module-level state) ───────────────────\n  const caches: LocaleCaches = createLocaleCaches();\n\n  const canonL = (loc: string) => canon(loc, caches);\n\n  const fallback = Array.isArray(cfg.fallback) ? cfg.fallback.map(canonL) : cfg.fallback ? [canonL(cfg.fallback)] : [];\n\n  // ─── Disposal ─────────────────────────────────────────────────────────────\n  let disposed = false;\n  const disposeController = new AbortController();\n\n  // ─── Bounded stores ───────────────────────────────────────────────────────\n  const catalogStore: CatalogStore<M> = createCatalogStore(() => disposed);\n  const nsStore: NamespaceStore = createNamespaceStore(() => disposed);\n\n  // ─── Locale state ─────────────────────────────────────────────────────────\n  let state: LocaleState = buildState(canonL(cfg.locale ?? 'en'), fallback, caches);\n\n  // ─── Subscribers ──────────────────────────────────────────────────────────\n  const subscribers = new Set<(snapshot: I18nSnapshot) => void>();\n  const subscriptionUnsubscribers = new Set<Unsubscribe>();\n\n  const onMissingKey = cfg.onMissingKey ?? ((key: string) => key);\n  const onMissingVar = cfg.onMissingVar ?? ((varName: string) => `{${varName}}`);\n  const onSubscriberError = cfg.onSubscriberError ?? ((error: unknown) => logError('subscriber error', error));\n\n  // ─── Lazy formatter — avoids Intl overhead for SSR forks that only need t(). ──\n  let _fmt: Formatter | undefined;\n\n  // ─── Scope cache — stable object references per prefix for reactive framework renders. ──\n  // Bounded the same way format.ts bounds its Intl-formatter caches: `scope()` is meant for a\n  // static, finite set of prefixes (nav sections, form names, ...), but nothing stopped a caller\n  // from passing a dynamic per-item prefix (e.g. `scope(`item.${id}`)` in a list render) and\n  // growing this unboundedly for the instance's lifetime. Oldest entry evicts past the cap.\n  const scopeCache = new Map<string, ScopedI18n>();\n\n  const getFormatter = (): Formatter => {\n    if (!_fmt) _fmt = createFormatter(() => state.locale);\n\n    return _fmt;\n  };\n\n  // ─── Translate helpers ────────────────────────────────────────────────────\n  // The actual algorithm (fallback-chain lookup, plural-form selection, interpolation) lives in\n  // `_translate.ts` — this instance just supplies fresh context (current locale/chain) per call.\n\n  const translateContext = (): TranslateContext => ({\n    caches,\n    catalogStore,\n    chain: state.chain,\n    locale: state.locale,\n    onMissingKey,\n    onMissingVar,\n  });\n\n  // Shared by has() and scope().has().\n  const hasKey = (base: string): boolean => hasKeyIn(translateContext(), base);\n\n  const translate = (key: MessageLeafKeys<M> | (string & {}), vars?: TranslateVars): string =>\n    translateIn(translateContext(), String(key), vars);\n\n  const translatePlural = (key: MessageBranchKeys<M> | (string & {}), count: number, options?: TpOptions): string =>\n    translatePluralIn(translateContext(), String(key), count, options);\n\n  // ─── bump() ───────────────────────────────────────────────────────────────\n  // Rebuilds the snapshot and notifies all current subscribers.\n\n  let snapshot: I18nSnapshot = {\n    locale: state.locale,\n    t: translate,\n    tp: translatePlural,\n  };\n\n  const bump = (): void => {\n    snapshot = { locale: state.locale, t: translate, tp: translatePlural };\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  // ─── Wire catalog store onChange → bump ───────────────────────────────────\n  catalogStore.onChange = (loc: Locale) => {\n    if (state.chainSet.has(loc)) bump();\n  };\n\n  // ─── Seed from parent fork ─────────────────────────────────────────────────\n  if (_seed?.catalogStore) {\n    catalogStore.seedFrom(_seed.catalogStore.snapshotCatalogs(), _seed.catalogStore.snapshotLoaders());\n  }\n\n  if (_seed?.nsStore) {\n    nsStore.seedFrom(_seed.nsStore);\n  }\n\n  // ─── Initial catalogs from config ─────────────────────────────────────────\n  if (cfg.catalogs) {\n    const staticEntries = new Map<Locale, CatalogEntry>();\n    const loaderEntries = new Map<Locale, Loader<M>>();\n\n    for (const [loc, source] of Object.entries(cfg.catalogs)) {\n      const normalized = canonL(loc);\n\n      if (typeof source === 'function') {\n        loaderEntries.set(normalized, source as Loader<M>);\n      } else {\n        const entry = new CatalogEntry();\n\n        entry.setAll(flattenStrings(source as M));\n        staticEntries.set(normalized, entry);\n        validateCatalogInDev(normalized, source as M);\n      }\n    }\n\n    // Use seedFrom for zero-overhead init (no bump, no notifications during setup)\n    catalogStore.seedFrom(staticEntries, loaderEntries);\n  }\n\n  // ─── Preload helper ───────────────────────────────────────────────────────\n\n  const preload = (loc: Locale): Promise<void> => catalogStore.preload(canonL(loc));\n\n  // ─── Monotonic generation counter — last writer wins for concurrent setLocale() ──\n  let switchGen = 0;\n\n  // ─── Subscribe helper ─────────────────────────────────────────────────────\n\n  const subscribeInternal = (callback: (snapshot: I18nSnapshot) => void, options?: SubscribeOptions): Unsubscribe => {\n    const signal = options?.signal;\n\n    const unsubscribe = (): void => {\n      subscribers.delete(callback);\n      signal?.removeEventListener('abort', unsubscribe);\n      subscriptionUnsubscribers.delete(unsubscribe);\n    };\n\n    if (disposed) throw new LinguaDisposedError();\n\n    if (signal?.aborted) return unsubscribe;\n\n    if (options?.immediate === true) {\n      try {\n        callback(snapshot);\n      } catch (error) {\n        onSubscriberError(error);\n\n        return unsubscribe;\n      }\n    }\n\n    subscribers.add(callback);\n    signal?.addEventListener('abort', unsubscribe, { once: true });\n    subscriptionUnsubscribers.add(unsubscribe);\n\n    return unsubscribe;\n  };\n\n  // ─── Public object ─────────────────────────────────────────────────────────\n  // Named `const` (not a bare `return { ... }`) so `[Symbol.dispose]` below can close over\n  // `source` directly instead of `this` — `this` inside an object-literal method is only bound\n  // when called as `obj.method()`; detaching it first (`const d = i18n[Symbol.dispose]; d()`,\n  // the exact shape most framework cleanup-hook APIs expect) would otherwise throw.\n\n  const source: I18n<M> = {\n    get disposalSignal(): AbortSignal {\n      return disposeController.signal;\n    },\n\n    dispose(): void {\n      if (disposed) return;\n\n      disposed = true;\n      disposeController.abort();\n      for (const unsubscribe of [...subscriptionUnsubscribers]) unsubscribe();\n      subscriptionUnsubscribers.clear();\n      subscribers.clear();\n      catalogStore.dispose();\n      nsStore.dispose();\n      scopeCache.clear();\n    },\n\n    get disposed(): boolean {\n      return disposed;\n    },\n\n    extend(ns: string, factory: NamespaceFactory, loc?: Locale): Promise<void> {\n      checkDisposed(disposed);\n\n      nsStore.registerNamespace(ns, factory);\n\n      const normalized = loc ? canonL(loc) : state.locale;\n\n      return nsStore.loadNamespace(ns, normalized, (l, messages) => catalogStore.patch(l, messages));\n    },\n\n    get fmt(): Formatter {\n      return getFormatter();\n    },\n\n    fork(overrides?: Omit<I18nOptions<M>, 'catalogs'>): I18n<M> {\n      return _createI18nImpl(\n        {\n          fallback: overrides?.fallback ?? (fallback.length > 0 ? fallback : undefined),\n          locale: overrides?.locale ?? state.locale,\n          onMissingKey: overrides?.onMissingKey ?? cfg.onMissingKey,\n          onMissingVar: overrides?.onMissingVar ?? cfg.onMissingVar,\n          onSubscriberError: overrides?.onSubscriberError ?? cfg.onSubscriberError,\n        },\n        {\n          catalogStore,\n          nsStore,\n        },\n      );\n    },\n\n    getSnapshot() {\n      return snapshot;\n    },\n\n    getState(): I18nState {\n      const catalogsOut: Record<Locale, Record<string, string>> = {};\n\n      for (const [loc, entry] of catalogStore.snapshotCatalogs()) {\n        catalogsOut[loc] = Object.fromEntries([...entry.entries.entries()].map(([k, { message }]) => [k, message]));\n      }\n\n      return { catalogs: catalogsOut, locale: state.locale };\n    },\n\n    getSupportedLocales(sorted?: boolean): Locale[] {\n      const locales = [...catalogStore.knownLocales()];\n\n      return sorted === true ? locales.sort() : locales;\n    },\n\n    has(key: MessageLeafKeys<M> | MessageBranchKeys<M> | (string & {})): boolean {\n      return hasKey(String(key));\n    },\n\n    isLoaded(loc: Locale): boolean {\n      try {\n        return catalogStore.isLoaded(canonL(loc));\n      } catch {\n        return false;\n      }\n    },\n\n    isNamespaceLoaded(ns: string, loc?: Locale): boolean {\n      if (!loc) return nsStore.isLoaded(ns, state.locale);\n\n      try {\n        return nsStore.isLoaded(ns, canonL(loc));\n      } catch {\n        return false;\n      }\n    },\n\n    isNamespaceRegistered(ns: string): boolean {\n      return nsStore.isRegistered(ns);\n    },\n\n    isRegistered(loc: Locale): boolean {\n      try {\n        return catalogStore.isRegistered(canonL(loc));\n      } catch {\n        return false;\n      }\n    },\n\n    loadNamespace(ns: string, loc?: Locale): Promise<void> {\n      const normalized = loc ? canonL(loc) : state.locale;\n\n      return nsStore.loadNamespace(ns, normalized, (l, messages) => catalogStore.patch(l, messages));\n    },\n\n    get locale(): Locale {\n      return state.locale;\n    },\n\n    preload,\n\n    register(loc: Locale, source: LocaleSource<M>): Promise<void> {\n      const normalized = canonL(loc);\n\n      return catalogStore.register(normalized, source, nsStore);\n    },\n\n    registerNamespace(ns: string, factory: NamespaceFactory): void {\n      nsStore.registerNamespace(ns, factory);\n    },\n\n    restoreState(st: I18nState): void {\n      checkDisposed(disposed);\n\n      if (!Object.hasOwn(st.catalogs, st.locale)) {\n        throw new LinguaRestoreError(`restoreState: locale \"${st.locale}\" has no catalog in the provided state.`);\n      }\n\n      const freshEntries = new Map<Locale, CatalogEntry>();\n      const knownLocales = catalogStore.knownLocales();\n\n      for (const knownLocale of knownLocales) {\n        nsStore.clearLocale(knownLocale);\n      }\n\n      // No validateCatalogInDev() call here, unlike register()/construction/preload(): `state`\n      // is already flattened dot-notation (I18nState.catalogs), not the nested Messages shape\n      // validateCatalog() expects, and restoreState() exists specifically for cheap SSR\n      // hydration of a payload that was already registered — and therefore already\n      // validated — once on the system that produced it. Re-validating here would mean\n      // un-flattening every restored catalog back into nested form on every hydration, for a\n      // check that's already run.\n      for (const [loc, flatCatalog] of Object.entries(st.catalogs)) {\n        const normalized = canonL(loc);\n        const entry = new CatalogEntry();\n\n        entry.setAll(Object.entries(flatCatalog));\n        freshEntries.set(normalized, entry);\n      }\n\n      // Dispose and re-seed the catalog store with the restored entries.\n      // onChange is re-wired immediately after dispose.\n      catalogStore.dispose();\n      catalogStore.onChange = (loc: Locale) => {\n        if (state.chainSet.has(loc)) bump();\n      };\n      catalogStore.seedFrom(freshEntries, new Map());\n\n      const normalized = canonL(st.locale);\n\n      state = buildState(normalized, fallback, caches);\n      _fmt?.clear();\n      bump();\n    },\n\n    scope(prefix: MessageBranchKeys<M> | (string & {})): ScopedI18n {\n      const pre = String(prefix);\n\n      return getOrCreate(scopeCache, pre, SCOPE_CACHE_MAX, () => ({\n        get fmt() {\n          return getFormatter();\n        },\n        has: (key) => hasKey(`${pre}.${key}`),\n        t: (key, vars?) => translate(`${pre}.${key}`, vars),\n        tp: (key, count, options?) => translatePlural(`${pre}.${key}`, count, options),\n      }));\n    },\n\n    async setLocale(next: Locale): Promise<void> {\n      checkDisposed(disposed);\n\n      const normalized = canonL(next);\n\n      if (state.locale === normalized) return;\n\n      // Monotonic generation counter — last writer wins.\n      const gen = ++switchGen;\n\n      await preload(normalized);\n\n      if (disposed || switchGen !== gen) return;\n\n      state = buildState(normalized, fallback, caches);\n      _fmt?.clear();\n      bump();\n    },\n\n    subscribe: subscribeInternal,\n\n    [Symbol.dispose](): void {\n      source.dispose();\n    },\n\n    t: translate,\n\n    tp: translatePlural,\n  };\n\n  return source;\n}\n"],"mappings":"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"}

package/dist/i18n.d.ts

@@ -1,4 +1,4 @@
-import type { I18n, I18nOptions, I18nState } from './i18n-types';
+import type { I18n, I18nOptions } from './i18n-types';
 import { type Messages } from './_catalog';
 export { LinguaCountInVarsError, LinguaDisposedError, LinguaError, LinguaInvalidCountError, LinguaInvalidLocaleError, LinguaMissingLocaleError, LinguaNamespaceMissingError, LinguaRestoreError, } from './errors';
 export type { I18n, I18nOptions, I18nSnapshot, I18nState, Locale, MessageBranchKeys, MessageLeafKeys, ScopedI18n, SubscribeOptions, TpOptions, TranslateVars, Unsubscribe, } from './i18n-types';
@@ -9,32 +9,4 @@ export type { NamespaceFactory } from './_namespace-store';
 export declare function createI18n<M extends Messages>(config: I18nOptions<M>): I18n<M>;
 /** Overload: no type parameter (loose typing, allows heterogeneous catalogs) */
 export declare function createI18n(config?: I18nOptions<Messages>): I18n<Messages>;
-/**
- * Serialises the currently loaded catalogs and active locale into a plain object.
- * Pass the result to `hydrateI18n()` on the client.
- *
- * Prefer calling `i18n.getState()` directly — these standalone functions are provided
- * for convenience when you receive a plain `I18n` reference without the full type.
- *
- * **Warning:** Only fully resolved catalogs are included. Loader-only locales not yet
- * preloaded are omitted. Use `i18n.isLoaded(locale)` to verify before calling.
- *
- * **Warning:** The namespace registry is **not** serialized — factory functions cannot
- * be converted to JSON. After `hydrateI18n()`, call `extend()` again for each namespace
- * before relying on namespace-patched keys.
- */
-export declare function serializeI18n(i18n: I18n): I18nState;
-/**
- * Hydrates an i18n instance with pre-loaded state (e.g. from a server-rendered payload).
- *
- * Prefer calling `i18n.restoreState(state)` directly — these standalone functions are
- * provided for convenience.
- *
- * @remarks The namespace registry is **not** included in `I18nState`. After hydrating,
- * call `extend()` for each namespace before relying on namespace-patched keys.
- *
- * @throws `LinguaDisposedError` if called on a disposed instance.
- * @throws `LinguaRestoreError` if the state's locale has no catalog.
- */
-export declare function hydrateI18n(i18n: I18n, state: I18nState): void;
 //# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAEX,SAAS,EASV,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAgB,KAAK,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAezE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAkC3D,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAChF,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;AAmc3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAE9D"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAWZ,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAgB,KAAK,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAoBzE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAsB3D,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAChF,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC"}