@vielzeug/lingua 26.11.12 → 26.11.13

package/dist/lingua.js

@@ -15,20 +15,6 @@ function renderText(e, t, n) {
 		return r == null ? n(e.value) : String(r);
 	}).join("");
 }
-function renderParts(e, t, n) {
-	let r = [];
-	for (let i of e) typeof i == "string" ? i !== "" && r.push({
-		type: "text",
-		value: i
-	}) : Object.hasOwn(t, i.value) ? r.push({
-		type: "value",
-		value: t[i.value]
-	}) : r.push({
-		type: "text",
-		value: n(i.value)
-	});
-	return r;
-}
 // src/errors.ts
 var LinguaError = class extends Error {
 	constructor(e, t) {
@@ -38,7 +24,7 @@ var LinguaError = class extends Error {
 	constructor() {
 		super("Operation called on a disposed i18n instance.");
 	}
-}, LinguaInvalidCatalogError = class extends LinguaError {}, LinguaInvalidLocaleError = class extends LinguaError {}, LinguaInvalidPluralCountError = class extends LinguaError {}, LinguaInvalidStateError = class extends LinguaError {}, LinguaMissingCatalogError = class extends LinguaError {}, LinguaMissingKeyError = class extends LinguaError {}, LinguaMissingValueError = class extends LinguaError {}, t = /* @__PURE__ */ new Set([
+}, LinguaInvalidCatalogError = class extends LinguaError {}, LinguaInvalidLocaleError = class extends LinguaError {}, LinguaInvalidPluralCountError = class extends LinguaError {}, LinguaMissingCatalogError = class extends LinguaError {}, LinguaMissingKeyError = class extends LinguaError {}, LinguaMissingValueError = class extends LinguaError {}, t = /* @__PURE__ */ new Set([
 	"__proto__",
 	"constructor",
 	"prototype"
@@ -129,18 +115,16 @@ function createCatalogStore(e) {
 		catalogMap() {
 			return new Map([...t].map(([e, { compiled: t }]) => [e, t]));
 		},
-		hydrate,
 		isLoaded(e) {
 			return t.has(canonicalLocale(e));
 		},
 		load,
-		state(e) {
+		serialized(e) {
 			let n = {};
 			for (let [e, { catalog: r }] of t) n[e] = r;
 			return {
 				catalogs: n,
-				locale: e,
-				version: 1
+				locale: e
 			};
 		}
 	};
@@ -150,7 +134,7 @@ function resolveMissing(e, t) {
 	if (e === "throw") throw t.name ? new LinguaMissingValueError(`Missing interpolation value "${t.name}" for key "${t.key}" in locale "${t.locale}".`) : new LinguaMissingKeyError(`Missing translation key "${t.key}" in locale "${t.locale}".`);
 	return typeof e == "function" ? e(t) : t.name ? `{${t.name}}` : t.key;
 }
-function createTranslatorFromCompiled(e, t = {}) {
+function createTranslateEngine(e, t = {}) {
 	let n = canonicalLocale(t.locale ?? "en"), r = localeChain(n, (Array.isArray(t.fallback) ? t.fallback : t.fallback ? [t.fallback] : []).map(canonicalLocale)), i = t.missing, missingKey = (e) => resolveMissing(i, {
 		key: e,
 		locale: n
@@ -169,140 +153,104 @@ function createTranslatorFromCompiled(e, t = {}) {
 	}, templateFor = (e, t) => {
 		let n = resolve(e);
 		if (!n) return;
-		if (n.message.kind === "text") return "count" in t ? void 0 : {
-			key: e,
-			template: n.message.template
-		};
+		if (n.message.kind === "text") return "count" in t ? void 0 : n.message.template;
 		if (!("count" in t) || !Number.isFinite(t.count)) {
 			if ("count" in t) throw new LinguaInvalidPluralCountError("`count` must be a finite number.");
 			return;
 		}
-		let r = t.count === 0 && !t.ordinal ? "zero" : pluralCategory(n.locale, t.count, t.ordinal ?? !1), i = n.message.forms.get(r) ?? n.message.forms.get("other");
-		return i ? {
-			key: e,
-			template: i
-		} : void 0;
-	}, valuesFor = (e) => "count" in e ? {
-		count: e.count,
-		...e.values
-	} : e.values ?? {}, partsDynamic = (e, t) => {
-		let n = templateFor(e, t);
-		return n ? renderParts(n.template, valuesFor(t), (e) => missingValue(e, n.key)) : [{
-			type: "text",
-			value: missingKey(e)
-		}];
-	}, translateDynamic = (e, t = {}) => {
+		let r = pluralCategory(n.locale, t.count, t.ordinal ?? !1);
+		return n.message.forms.get(r) ?? n.message.forms.get("other");
+	}, translate = (e, t = {}) => {
 		let n = templateFor(e, t);
-		return n ? renderText(n.template, valuesFor(t), (e) => missingValue(e, n.key)) : missingKey(e);
+		return n ? renderText(n, "count" in t ? {
+			count: t.count,
+			...t.values
+		} : t.values ?? {}, (t) => missingValue(t, e)) : missingKey(e);
 	};
 	return {
 		locale: n,
-		parts(e, t) {
-			return partsDynamic(e, t);
-		},
-		partsDynamic,
-		translate(e, t = {}) {
-			return translateDynamic(e, t);
-		},
-		translateDynamic
+		translate
 	};
 }
 function createTranslator(e, t) {
-	let n = canonicalLocale(t?.locale ?? "en");
-	return createTranslatorFromCompiled(/* @__PURE__ */ new Map([[n, compileCatalog(e)]]), {
-		...t,
-		locale: n
-	});
+	let n = createTranslateEngine(/* @__PURE__ */ new Map([[canonicalLocale(t?.locale ?? "en"), compileCatalog(e)]]), t);
+	return {
+		locale: n.locale,
+		translate: n.translate
+	};
 }
 // src/i18n.ts
 function createI18n(e) {
-	if (e.state && e.state.version !== 1) throw new LinguaInvalidStateError(`Unsupported lingua state version: ${String(e.state.version)}.`);
-	let t = e.fallback, n = (Array.isArray(t) ? t : t ? [t] : []).map(canonicalLocale), r = new AbortController(), i = /* @__PURE__ */ new Set(), a = !1, o = canonicalLocale(e.locale ?? e.state?.locale ?? "en"), s = 0, c = 0, l = createCatalogStore({
+	let t = (Array.isArray(e.fallback) ? e.fallback : e.fallback ? [e.fallback] : []).map(canonicalLocale), n = new AbortController(), r = /* @__PURE__ */ new Set(), i = !1, a = canonicalLocale(e.locale ?? "en"), o = 0, s = createCatalogStore({
 		catalogs: e.catalogs,
 		loadCatalog: e.loadCatalog
-	});
-	if (e.state) for (let [t, n] of Object.entries(e.state.catalogs)) l.hydrate(t, n);
-	let loadTargets = async (e) => {
-		let t = [];
-		for (let r of /* @__PURE__ */ new Set([e, ...n])) await l.load(r) && t.push(r);
-		return t;
-	}, buildTranslator = () => {
-		let r = localeChain(o, n).some(l.isLoaded) ? e.missing : () => {
-			throw new LinguaMissingCatalogError(`No catalog loaded for locale "${o}". Call load() before translating.`);
+	}), loadTargets = async (e) => {
+		let n = [];
+		for (let r of /* @__PURE__ */ new Set([e, ...t])) await s.load(r) && n.push(r);
+		return n;
+	}, buildEngine = () => {
+		let n = localeChain(a, t).some(s.isLoaded) ? e.missing : () => {
+			throw new LinguaMissingCatalogError(`No catalog loaded for locale "${a}". Call load() before translating.`);
 		};
-		return createTranslatorFromCompiled(l.catalogMap(), {
-			fallback: t,
-			locale: o,
-			missing: r
+		return createTranslateEngine(s.catalogMap(), {
+			...e,
+			locale: a,
+			missing: n
 		});
-	}, buildSnapshot = () => ({
-		locale: o,
-		revision: s,
-		translator: buildTranslator()
-	}), u = buildSnapshot(), assertLive = () => {
-		if (a) throw new LinguaDisposedError();
+	}, assertLive = () => {
+		if (i) throw new LinguaDisposedError();
 	}, dispose = () => {
-		a || (a = !0, i.clear(), r.abort());
-	}, dispatch = (e) => {
-		try {
-			e(u);
-		} catch {}
+		i || (i = !0, r.clear(), n.abort());
 	}, notify = () => {
-		s++, u = buildSnapshot();
-		for (let e of [...i]) dispatch(e);
-	}, relevant = (e) => localeChain(o, n).includes(e);
+		c = buildEngine();
+		for (let e of [...r]) try {
+			e(a);
+		} catch {}
+	}, relevant = (e) => localeChain(a, t).includes(e), c = buildEngine();
 	return {
 		get disposalSignal() {
-			return r.signal;
+			return n.signal;
 		},
 		dispose,
 		get disposed() {
-			return a;
+			return i;
 		},
 		getSnapshot() {
-			return u;
+			return a;
 		},
 		isLoaded(e) {
-			return !a && l.isLoaded(e?.locale ?? o);
+			return !i && s.isLoaded(e?.locale ?? a);
 		},
 		async load(e) {
 			assertLive();
-			let t = canonicalLocale(e?.locale ?? o), n = await loadTargets(t);
+			let t = canonicalLocale(e?.locale ?? a), n = await loadTargets(t);
 			assertLive(), n.some(relevant) && notify();
 		},
 		get locale() {
-			return o;
-		},
-		parts(e, t) {
-			return u.translator.partsDynamic(e, t);
-		},
-		partsDynamic(e, t) {
-			return u.translator.partsDynamic(e, t);
+			return a;
 		},
 		serialize() {
-			return assertLive(), l.state(o);
+			return assertLive(), s.serialized(a);
 		},
 		async setLocale(e) {
 			assertLive();
-			let t = canonicalLocale(e), n = ++c, r = await loadTargets(t);
-			assertLive(), n === c && (t === o ? r.some(relevant) && notify() : (o = t, notify()));
+			let t = canonicalLocale(e), n = ++o, r = await loadTargets(t);
+			assertLive(), n === o && (t === a ? r.some(relevant) && notify() : (a = t, notify()));
 		},
 		subscribe(e, t) {
 			if (assertLive(), t?.signal?.aborted) return () => {};
 			let unsubscribe = () => {
-				i.delete(e), t?.signal?.removeEventListener("abort", unsubscribe);
+				r.delete(e), t?.signal?.removeEventListener("abort", unsubscribe);
 			};
-			return t?.signal?.addEventListener("abort", unsubscribe, { once: !0 }), i.add(e), t?.immediate && dispatch(e), unsubscribe;
+			if (t?.signal?.addEventListener("abort", unsubscribe, { once: !0 }), r.add(e), t?.immediate) try {
+				e(a);
+			} catch {}
+			return unsubscribe;
 		},
-		[Symbol.dispose]: dispose,
-		translate(e, t = {}) {
-			return u.translator.translateDynamic(e, t);
-		},
-		translateDynamic(e, t) {
-			return u.translator.translateDynamic(e, t);
-		}
+		translate: (e, t) => c.translate(e, t),
+		[Symbol.dispose]: dispose
 	};
 }
-export { LinguaDisposedError, LinguaError, LinguaInvalidCatalogError, LinguaInvalidLocaleError, LinguaInvalidPluralCountError, LinguaInvalidStateError, LinguaMissingCatalogError, LinguaMissingKeyError, LinguaMissingValueError, catalogKeys, createI18n, createTranslator };
+export { LinguaDisposedError, LinguaError, LinguaInvalidCatalogError, LinguaInvalidLocaleError, LinguaInvalidPluralCountError, LinguaMissingCatalogError, LinguaMissingKeyError, LinguaMissingValueError, catalogKeys, createI18n, createTranslator };
 
 //# sourceMappingURL=lingua.js.map

package/dist/lingua.js.map

@@ -1 +1 @@
-{"version":3,"file":"lingua.js","names":["error","interpolation","parts","offset","match","value","index","part","values","missing","result","message","opts","unsafeKeys","node","messages","prefix","key","forms","form","template","catalog","pluralRules","canonical","locale","chain","candidate","fallback","length","ordinal","rules","count","loaded","tasks","options","requestedLocale","existing","task","error","compiled","catalogs","loadedLocale","strategy","info","found","category","name","fallbackLocales","controller","subscribers","disposed","revision","transition","stateLocale","changed","target","snapshot","listener","loadOptions","targetLocale","translateOptions","next","nextLocale","request","subscribeOptions"],"sources":["../src/_template.ts","../src/errors.ts","../src/_catalog.ts","../src/catalog.ts","../src/_dev.ts","../src/_locale.ts","../src/_resources.ts","../src/translator.ts","../src/i18n.ts"],"sourcesContent":["import type { Part } from './types';\n\nexport type TemplatePart = string | { readonly value: string };\nexport type Template = readonly TemplatePart[];\n\nconst interpolation = /\\{([\\p{ID_Continue}-]+)\\}/gu;\n\nexport function compileTemplate(value: string): Template {\n  const parts: TemplatePart[] = [];\n  let offset = 0;\n\n  for (const match of value.matchAll(interpolation)) {\n    const index = match.index ?? 0;\n\n    if (index > offset) parts.push(value.slice(offset, index));\n\n    parts.push({ value: match[1] });\n    offset = index + match[0].length;\n  }\n\n  if (offset < value.length) parts.push(value.slice(offset));\n\n  return parts;\n}\n\nexport function renderText(\n  parts: Template,\n  values: Record<string, unknown>,\n  missing: (name: string) => string,\n): string {\n  return parts\n    .map((part) => {\n      if (typeof part === 'string') return part;\n\n      const value = Object.hasOwn(values, part.value) ? values[part.value] : undefined;\n\n      return value == null ? missing(part.value) : String(value);\n    })\n    .join('');\n}\n\nexport function renderParts<V>(\n  parts: Template,\n  values: Record<string, V | number>,\n  missing: (name: string) => string,\n): Array<Part<V | number>> {\n  const result: Array<Part<V | number>> = [];\n\n  for (const part of parts) {\n    if (typeof part === 'string') {\n      if (part !== '') result.push({ type: 'text', value: part });\n\n      continue;\n    }\n\n    if (Object.hasOwn(values, part.value)) {\n      result.push({ type: 'value', value: values[part.value]! as V | number });\n    } else {\n      result.push({ type: 'text', value: missing(part.value) });\n    }\n  }\n\n  return result;\n}\n","export class LinguaError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class LinguaDisposedError extends LinguaError {\n  constructor() {\n    super('Operation called on a disposed i18n instance.');\n  }\n}\n\nexport class LinguaInvalidCatalogError extends LinguaError {}\nexport class LinguaInvalidLocaleError extends LinguaError {}\nexport class LinguaInvalidPluralCountError extends LinguaError {}\nexport class LinguaInvalidStateError extends LinguaError {}\nexport class LinguaMissingCatalogError extends LinguaError {}\nexport class LinguaMissingKeyError extends LinguaError {}\nexport class LinguaMissingValueError extends LinguaError {}\n","import { compileTemplate, type Template } from './_template';\nimport { LinguaInvalidCatalogError } from './errors';\nimport type { Catalog, CatalogNode, PluralMessage } from './types';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport type CompiledText = { readonly kind: 'text'; readonly template: Template };\nexport type CompiledPlural = { readonly forms: ReadonlyMap<string, Template>; readonly kind: 'plural' };\nexport type CompiledMessage = CompiledPlural | CompiledText;\nexport type CompiledCatalog = ReadonlyMap<string, CompiledMessage>;\n\nexport function isPluralMessage(node: CatalogNode): node is PluralMessage {\n  return typeof node === 'object' && node !== null && Object.hasOwn(node, 'plural');\n}\n\n/** Compile explicit catalog nodes once. Nested objects only group keys; plural intent is never inferred. */\nexport function compileCatalog(catalog: Catalog): CompiledCatalog {\n  const messages = new Map<string, CompiledMessage>();\n\n  const visit = (node: CatalogNode, prefix: string): void => {\n    if (typeof node === 'string') {\n      messages.set(prefix, { kind: 'text', template: compileTemplate(node) });\n\n      return;\n    }\n\n    if (typeof node !== 'object' || node === null || Array.isArray(node)) {\n      throw new LinguaInvalidCatalogError(`Catalog node \"${prefix}\" must be a string, plural message, or object.`);\n    }\n\n    if (isPluralMessage(node)) {\n      if (Reflect.ownKeys(node).some((key) => key !== 'plural')) {\n        throw new LinguaInvalidCatalogError(`Plural message \"${prefix}\" must contain only a \"plural\" property.`);\n      }\n\n      if (typeof node.plural !== 'object' || node.plural === null || Array.isArray(node.plural)) {\n        throw new LinguaInvalidCatalogError(`Plural message \"${prefix}\" must provide an object of string forms.`);\n      }\n\n      const forms = new Map<string, Template>();\n\n      for (const [form, template] of Object.entries(node.plural)) {\n        if (typeof template !== 'string') {\n          throw new LinguaInvalidCatalogError(`Plural form \"${prefix}.${form}\" must be a string.`);\n        }\n\n        forms.set(form, compileTemplate(template));\n      }\n\n      messages.set(prefix, { forms, kind: 'plural' });\n\n      return;\n    }\n\n    for (const [key, value] of Object.entries(node)) {\n      if (unsafeKeys.has(key)) {\n        throw new LinguaInvalidCatalogError(`Catalog key \"${key}\" is reserved.`);\n      }\n\n      visit(value, prefix ? `${prefix}.${key}` : key);\n    }\n  };\n\n  for (const [key, value] of Object.entries(catalog)) {\n    if (unsafeKeys.has(key)) throw new LinguaInvalidCatalogError(`Catalog key \"${key}\" is reserved.`);\n\n    visit(value, key);\n  }\n\n  return messages;\n}\n","import { compileCatalog } from './_catalog';\nimport type { Catalog, MessageKey } from './types';\n\n/** Enumerate every message key in a catalog as a dotted path.\n *\n *  Traverses nested grouping objects and explicit `{ plural: ... }` messages,\n *  producing the same dotted paths that `MessageKey<C>` represents at the type\n *  level. Use this to derive key arrays from the catalog itself instead of\n *  maintaining a parallel list that can go stale.\n *\n *  Pass any catalog subtree to enumerate group-scoped keys. For an `I18n`\n *  instance, pass its current locale catalog explicitly.\n *\n *  @example\n *  ```ts\n *  const messages = {\n *    nav: { home: '...', settings: '...' },\n *  };\n *  const keys = catalogKeys(messages); // ['nav.home', 'nav.settings']\n *  const navKeys = catalogKeys(messages.nav); // ['home', 'settings']\n *\n *  // From an i18n instance: read the current locale's catalog first\n *  const i18n = createI18n({ catalogs: { en: messages }, locale: 'en' });\n *  const state = i18n.serialize();\n *  const allKeys = catalogKeys(state.catalogs[state.locale]);\n *  ```\n */\nexport function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<MessageKey<C>> {\n  return [...compileCatalog(catalog).keys()] as unknown as ReadonlyArray<MessageKey<C>>;\n}\n","export const isDev = !(globalThis as { __LINGUA_PROD__?: boolean }).__LINGUA_PROD__;\n\n/** @internal @security Messages may include user-supplied data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/lingua] ${msg}`);\n}\n\n/** @internal */\nexport function error(msg: string, ...args: unknown[]): void {\n  if (isDev) console.error(`[@vielzeug/lingua] ${msg}`, ...args);\n}\n","import { LinguaInvalidLocaleError } from './errors';\nimport type { Locale } from './types';\n\nconst pluralRules = new Map<string, Intl.PluralRules>();\n\nexport function canonicalLocale(locale: string): Locale {\n  try {\n    const [canonical] = Intl.getCanonicalLocales(locale);\n\n    if (canonical) return canonical;\n  } catch {\n    // Error below names the failed public input.\n  }\n\n  throw new LinguaInvalidLocaleError(`Invalid BCP 47 locale tag: \"${locale}\".`);\n}\n\nexport function localeChain(locale: Locale, fallback: readonly Locale[]): readonly Locale[] {\n  const chain = new Set<Locale>();\n\n  for (const candidate of [locale, ...fallback]) {\n    const parts = candidate.split('-');\n\n    for (let length = parts.length; length > 0; length--) {\n      chain.add(parts.slice(0, length).join('-'));\n    }\n  }\n\n  return [...chain];\n}\n\nexport function pluralCategory(locale: Locale, count: number, ordinal: boolean): Intl.LDMLPluralRule {\n  const key = `${locale}:${ordinal ? 'ordinal' : 'cardinal'}`;\n  let rules = pluralRules.get(key);\n\n  if (!rules) {\n    rules = new Intl.PluralRules(locale, { type: ordinal ? 'ordinal' : 'cardinal' });\n    pluralRules.set(key, rules);\n  }\n\n  return rules.select(count);\n}\n","import { type CompiledCatalog, compileCatalog } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport { LinguaMissingCatalogError } from './errors';\nimport type { Catalog, Catalogs, Locale, TranslationState } from './types';\n\ntype CatalogStoreOptions<C extends Catalog> = {\n  readonly catalogs?: Catalogs<C>;\n  readonly loadCatalog?: (locale: Locale) => Promise<C> | C;\n};\n\n/** One catalog state machine owns loaded catalogs and in-flight loading work. */\nexport function createCatalogStore<C extends Catalog>(options: CatalogStoreOptions<C>) {\n  const loaded = new Map<Locale, { readonly catalog: C; readonly compiled: CompiledCatalog }>();\n  const tasks = new Map<Locale, Promise<void>>();\n\n  const hydrate = (locale: Locale, catalog: C): void => {\n    loaded.set(canonicalLocale(locale), { catalog, compiled: compileCatalog(catalog) });\n  };\n\n  for (const [locale, catalog] of Object.entries(options.catalogs ?? {})) hydrate(locale, catalog);\n\n  const load = async (requestedLocale: Locale): Promise<boolean> => {\n    const locale = canonicalLocale(requestedLocale);\n\n    if (loaded.has(locale)) return false;\n\n    const existing = tasks.get(locale);\n\n    if (existing) {\n      await existing;\n\n      return false;\n    }\n\n    if (!options.loadCatalog) {\n      throw new LinguaMissingCatalogError(`No catalog source provided for locale \"${locale}\".`);\n    }\n\n    const task = Promise.resolve(options.loadCatalog(locale)).then(\n      (catalog) => {\n        hydrate(locale, catalog);\n        tasks.delete(locale);\n      },\n      (error: unknown) => {\n        tasks.delete(locale);\n        throw error;\n      },\n    );\n\n    tasks.set(locale, task);\n    await task;\n\n    return true;\n  };\n\n  return {\n    catalogMap(): ReadonlyMap<Locale, CompiledCatalog> {\n      return new Map([...loaded].map(([locale, { compiled }]) => [locale, compiled]));\n    },\n    hydrate,\n    isLoaded(locale: Locale): boolean {\n      return loaded.has(canonicalLocale(locale));\n    },\n    load,\n    state(locale: Locale): TranslationState<C> {\n      const catalogs: Catalogs<C> = {};\n\n      for (const [loadedLocale, { catalog }] of loaded) catalogs[loadedLocale] = catalog;\n\n      return { catalogs, locale, version: 1 };\n    },\n  };\n}\n","import { type CompiledCatalog, type CompiledMessage, compileCatalog } from './_catalog';\nimport { isDev, warn } from './_dev';\nimport { canonicalLocale, localeChain, pluralCategory } from './_locale';\nimport { renderParts, renderText, type Template } from './_template';\nimport { LinguaInvalidPluralCountError, LinguaMissingKeyError, LinguaMissingValueError } from './errors';\nimport type {\n  Catalog,\n  Locale,\n  MissingInfo,\n  MissingStrategy,\n  Part,\n  PluralKey,\n  PluralOptions,\n  TextKey,\n  TranslateOptions,\n  TranslatorOptions,\n} from './types';\n\nexport type Translator<C extends Catalog = Catalog> = {\n  readonly locale: Locale;\n  parts<V>(key: TextKey<C>, options: TranslateOptions & { values: Record<string, V> }): Array<Part<V>>;\n  parts<V>(key: PluralKey<C>, options: PluralOptions & { values?: Record<string, V> }): Array<Part<number | V>>;\n  partsDynamic<V>(\n    key: string,\n    options: (TranslateOptions | PluralOptions) & { values?: Record<string, V> },\n  ): Array<Part<number | V>>;\n  translate(key: TextKey<C>, options?: TranslateOptions): string;\n  translate(key: PluralKey<C>, options: PluralOptions): string;\n  translateDynamic(key: string, options?: TranslateOptions | PluralOptions): string;\n};\n\ntype InternalOptions = {\n  readonly fallback?: Locale | readonly Locale[];\n  readonly locale?: Locale;\n  readonly missing?: MissingStrategy;\n};\n\nfunction resolveMissing(strategy: MissingStrategy | undefined, info: MissingInfo): string {\n  if (strategy === 'throw') {\n    throw info.name\n      ? new LinguaMissingValueError(\n          `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`,\n        )\n      : new LinguaMissingKeyError(`Missing translation key \"${info.key}\" in locale \"${info.locale}\".`);\n  }\n\n  if (typeof strategy === 'function') return strategy(info);\n\n  // 'key' or undefined (default)\n  if (strategy === undefined && isDev) {\n    warn(\n      info.name\n        ? `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`\n        : `Missing translation key \"${info.key}\" in locale \"${info.locale}\".`,\n    );\n  }\n\n  return info.name ? `{${info.name}}` : info.key;\n}\n\ntype ResolvedMessage = { readonly locale: Locale; readonly message: CompiledMessage };\n\nexport function createTranslatorFromCompiled<C extends Catalog>(\n  catalogs: ReadonlyMap<Locale, CompiledCatalog>,\n  options: InternalOptions = {},\n): Translator<C> {\n  const locale = canonicalLocale(options.locale ?? 'en');\n  const fallback = (\n    Array.isArray(options.fallback) ? options.fallback : options.fallback ? [options.fallback] : []\n  ).map(canonicalLocale);\n  const chain = localeChain(locale, fallback);\n  const missing = options.missing;\n\n  const missingKey = (key: string): string => resolveMissing(missing, { key, locale });\n  const missingValue = (name: string, key: string): string => resolveMissing(missing, { key, locale, name });\n\n  const resolve = (key: string): ResolvedMessage | undefined => {\n    for (const candidate of chain) {\n      const message = catalogs.get(candidate)?.get(key);\n\n      if (message) return { locale: candidate, message };\n    }\n\n    return undefined;\n  };\n\n  const templateFor = (\n    key: string,\n    options: TranslateOptions | PluralOptions,\n  ): { key: string; template: Template } | undefined => {\n    const found = resolve(key);\n\n    if (!found) return undefined;\n\n    if (found.message.kind === 'text') {\n      if ('count' in options) return undefined;\n\n      return { key, template: found.message.template };\n    }\n\n    if (!('count' in options) || !Number.isFinite(options.count)) {\n      if ('count' in options) throw new LinguaInvalidPluralCountError('`count` must be a finite number.');\n\n      return undefined;\n    }\n\n    const category =\n      options.count === 0 && !options.ordinal\n        ? 'zero'\n        : pluralCategory(found.locale, options.count, options.ordinal ?? false);\n    const template = found.message.forms.get(category) ?? found.message.forms.get('other');\n\n    return template ? { key, template } : undefined;\n  };\n\n  const valuesFor = (options: TranslateOptions | PluralOptions): Record<string, unknown> =>\n    'count' in options ? { count: options.count, ...options.values } : (options.values ?? {});\n\n  const partsDynamic = <V>(\n    key: string,\n    options: (TranslateOptions | PluralOptions) & { values?: Record<string, V> },\n  ): Array<Part<number | V>> => {\n    const found = templateFor(key, options);\n\n    if (!found) return [{ type: 'text', value: missingKey(key) }];\n\n    return renderParts(found.template, valuesFor(options) as Record<string, V | number>, (name) =>\n      missingValue(name, found.key),\n    );\n  };\n\n  const translateDynamic = (key: string, options: TranslateOptions | PluralOptions = {}): string => {\n    const found = templateFor(key, options);\n\n    if (!found) return missingKey(key);\n\n    return renderText(found.template, valuesFor(options), (name) => missingValue(name, found.key));\n  };\n\n  return {\n    locale,\n    parts(key: string, options: (TranslateOptions | PluralOptions) & { values?: Record<string, unknown> }) {\n      return partsDynamic(key, options);\n    },\n    partsDynamic,\n    translate(key: string, options: TranslateOptions | PluralOptions = {}) {\n      return translateDynamic(key, options);\n    },\n    translateDynamic,\n  } as Translator<C>;\n}\n\n/** Creates a fixed-locale translator from one catalog. Lingua snapshots catalog messages during construction. */\nexport function createTranslator<C extends Catalog>(catalog: C, options?: TranslatorOptions): Translator<C> {\n  const locale = canonicalLocale(options?.locale ?? 'en');\n  const compiled = new Map<Locale, CompiledCatalog>([[locale, compileCatalog(catalog)]]);\n\n  return createTranslatorFromCompiled<C>(compiled, { ...options, locale });\n}\n","import { error as logError } from './_dev';\nimport { canonicalLocale, localeChain } from './_locale';\nimport { createCatalogStore } from './_resources';\nimport { LinguaDisposedError, LinguaInvalidStateError, LinguaMissingCatalogError } from './errors';\nimport { createTranslatorFromCompiled, type Translator } from './translator';\nimport type { Catalog, I18nOptions, Locale, SubscribeOptions, TranslationState } from './types';\n\nexport type I18nSnapshot<C extends Catalog = Catalog> = {\n  readonly locale: Locale;\n  readonly revision: number;\n  /**\n   * Translator for this snapshot's locale and loaded catalogs. Components can hold the\n   * snapshot and translate through it without importing the whole i18n instance; always\n   * re-read it after a notification instead of caching a translator across snapshots.\n   */\n  readonly translator: Translator<C>;\n};\n\nexport type I18n<C extends Catalog = Catalog> = Translator<C> & {\n  [Symbol.dispose](): void;\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  getSnapshot(): I18nSnapshot<C>;\n  isLoaded(options?: { locale?: Locale }): boolean;\n  load(options?: { locale?: Locale }): Promise<void>;\n  serialize(): TranslationState<C>;\n  setLocale(locale: Locale): Promise<void>;\n  subscribe(listener: (snapshot: I18nSnapshot<C>) => void, options?: SubscribeOptions): () => void;\n};\n\nexport function createI18n<C extends Catalog>(options: I18nOptions<C>): I18n<C> {\n  if (options.state && options.state.version !== 1) {\n    throw new LinguaInvalidStateError(`Unsupported lingua state version: ${String(options.state.version)}.`);\n  }\n\n  const fallback = options.fallback;\n  const fallbackLocales = (Array.isArray(fallback) ? fallback : fallback ? [fallback] : []).map(canonicalLocale);\n  const controller = new AbortController();\n  const subscribers = new Set<(snapshot: I18nSnapshot<C>) => void>();\n  let disposed = false;\n  let locale = canonicalLocale(options.locale ?? options.state?.locale ?? 'en');\n  let revision = 0;\n  let transition = 0;\n\n  const catalogs = createCatalogStore<C>({ catalogs: options.catalogs, loadCatalog: options.loadCatalog });\n\n  // Hydrate from serialized state (SSR).\n  if (options.state) {\n    for (const [stateLocale, catalog] of Object.entries(options.state.catalogs)) {\n      catalogs.hydrate(stateLocale, catalog);\n    }\n  }\n\n  const loadTargets = async (target: Locale): Promise<readonly Locale[]> => {\n    const changed: Locale[] = [];\n\n    for (const candidate of new Set([target, ...fallbackLocales])) {\n      if (await catalogs.load(candidate)) changed.push(candidate);\n    }\n\n    return changed;\n  };\n\n  const buildTranslator = (): Translator<C> => {\n    const ready = localeChain(locale, fallbackLocales).some(catalogs.isLoaded);\n    const missing = ready\n      ? options.missing\n      : () => {\n          throw new LinguaMissingCatalogError(\n            `No catalog loaded for locale \"${locale}\". Call load() before translating.`,\n          );\n        };\n\n    return createTranslatorFromCompiled<C>(catalogs.catalogMap(), { fallback, locale, missing });\n  };\n\n  const buildSnapshot = (): I18nSnapshot<C> => ({ locale, revision, translator: buildTranslator() });\n\n  let snapshot = buildSnapshot();\n\n  const assertLive = (): void => {\n    if (disposed) throw new LinguaDisposedError();\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    subscribers.clear();\n    controller.abort();\n  };\n\n  const dispatch = (listener: (next: I18nSnapshot<C>) => void): void => {\n    try {\n      listener(snapshot);\n    } catch (error) {\n      logError('subscriber error', error);\n    }\n  };\n\n  const notify = (): void => {\n    revision++;\n    snapshot = buildSnapshot();\n\n    for (const listener of [...subscribers]) dispatch(listener);\n  };\n\n  const relevant = (candidate: Locale): boolean => localeChain(locale, fallbackLocales).includes(candidate);\n\n  return {\n    get disposalSignal() {\n      return controller.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    getSnapshot() {\n      return snapshot;\n    },\n    isLoaded(loadOptions) {\n      return !disposed && catalogs.isLoaded(loadOptions?.locale ?? locale);\n    },\n    async load(loadOptions) {\n      assertLive();\n\n      const targetLocale = canonicalLocale(loadOptions?.locale ?? locale);\n      const changed = await loadTargets(targetLocale);\n\n      assertLive();\n      if (changed.some(relevant)) notify();\n    },\n    get locale() {\n      return locale;\n    },\n    parts(key: string, translateOptions) {\n      return snapshot.translator.partsDynamic(key, translateOptions);\n    },\n    partsDynamic(key, translateOptions) {\n      return snapshot.translator.partsDynamic(key, translateOptions);\n    },\n    serialize() {\n      assertLive();\n\n      return catalogs.state(locale);\n    },\n    async setLocale(nextLocale) {\n      assertLive();\n\n      const next = canonicalLocale(nextLocale);\n      const request = ++transition;\n      const changed = await loadTargets(next);\n\n      assertLive();\n      if (request !== transition) return;\n\n      if (next === locale) {\n        if (changed.some(relevant)) notify();\n\n        return;\n      }\n\n      locale = next;\n      notify();\n    },\n    subscribe(listener, subscribeOptions) {\n      assertLive();\n\n      if (subscribeOptions?.signal?.aborted) return () => {};\n\n      const unsubscribe = (): void => {\n        subscribers.delete(listener);\n        subscribeOptions?.signal?.removeEventListener('abort', unsubscribe);\n      };\n\n      subscribeOptions?.signal?.addEventListener('abort', unsubscribe, { once: true });\n      subscribers.add(listener);\n\n      if (subscribeOptions?.immediate) dispatch(listener);\n\n      return unsubscribe;\n    },\n    [Symbol.dispose]: dispose,\n    translate(key: string, translateOptions = {}) {\n      return snapshot.translator.translateDynamic(key, translateOptions);\n    },\n    translateDynamic(key, translateOptions) {\n      return snapshot.translator.translateDynamic(key, translateOptions);\n    },\n  } as I18n<C>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"lingua.js","names":["error","interpolation","parts","offset","match","value","index","part","values","missing","message","opts","unsafeKeys","node","messages","prefix","key","forms","form","template","catalog","pluralRules","canonical","locale","chain","candidate","fallback","length","ordinal","rules","count","loaded","tasks","options","requestedLocale","existing","task","error","compiled","catalogs","loadedLocale","strategy","info","found","category","name","engine","fallbackLocales","controller","subscribers","disposed","transition","changed","target","effectiveMissing","listener","loadOptions","targetLocale","next","nextLocale","request","subscribeOptions","translateOptions"],"sources":["../src/_template.ts","../src/errors.ts","../src/_catalog.ts","../src/catalog.ts","../src/_dev.ts","../src/_locale.ts","../src/_resources.ts","../src/translator.ts","../src/i18n.ts"],"sourcesContent":["export type TemplatePart = string | { readonly value: string };\nexport type Template = readonly TemplatePart[];\n\nconst interpolation = /\\{([\\p{ID_Continue}-]+)\\}/gu;\n\nexport function compileTemplate(value: string): Template {\n  const parts: TemplatePart[] = [];\n  let offset = 0;\n\n  for (const match of value.matchAll(interpolation)) {\n    const index = match.index ?? 0;\n\n    if (index > offset) parts.push(value.slice(offset, index));\n\n    parts.push({ value: match[1] });\n    offset = index + match[0].length;\n  }\n\n  if (offset < value.length) parts.push(value.slice(offset));\n\n  return parts;\n}\n\nexport function renderText(\n  parts: Template,\n  values: Record<string, unknown>,\n  missing: (name: string) => string,\n): string {\n  return parts\n    .map((part) => {\n      if (typeof part === 'string') return part;\n\n      const value = Object.hasOwn(values, part.value) ? values[part.value] : undefined;\n\n      return value == null ? missing(part.value) : String(value);\n    })\n    .join('');\n}\n","export class LinguaError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class LinguaDisposedError extends LinguaError {\n  constructor() {\n    super('Operation called on a disposed i18n instance.');\n  }\n}\n\nexport class LinguaInvalidCatalogError extends LinguaError {}\nexport class LinguaInvalidLocaleError extends LinguaError {}\nexport class LinguaInvalidPluralCountError extends LinguaError {}\nexport class LinguaMissingCatalogError extends LinguaError {}\nexport class LinguaMissingKeyError extends LinguaError {}\nexport class LinguaMissingValueError extends LinguaError {}\n","import { compileTemplate, type Template } from './_template';\nimport { LinguaInvalidCatalogError } from './errors';\nimport type { Catalog, CatalogNode, PluralMessage } from './types';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport type CompiledText = { readonly kind: 'text'; readonly template: Template };\nexport type CompiledPlural = { readonly forms: ReadonlyMap<string, Template>; readonly kind: 'plural' };\nexport type CompiledMessage = CompiledPlural | CompiledText;\nexport type CompiledCatalog = ReadonlyMap<string, CompiledMessage>;\n\nexport function isPluralMessage(node: CatalogNode): node is PluralMessage {\n  return typeof node === 'object' && node !== null && Object.hasOwn(node, 'plural');\n}\n\n/** Compile explicit catalog nodes once. Nested objects only group keys; plural intent is never inferred. */\nexport function compileCatalog(catalog: Catalog): CompiledCatalog {\n  const messages = new Map<string, CompiledMessage>();\n\n  const visit = (node: CatalogNode, prefix: string): void => {\n    if (typeof node === 'string') {\n      messages.set(prefix, { kind: 'text', template: compileTemplate(node) });\n\n      return;\n    }\n\n    if (typeof node !== 'object' || node === null || Array.isArray(node)) {\n      throw new LinguaInvalidCatalogError(`Catalog node \"${prefix}\" must be a string, plural message, or object.`);\n    }\n\n    if (isPluralMessage(node)) {\n      if (Reflect.ownKeys(node).some((key) => key !== 'plural')) {\n        throw new LinguaInvalidCatalogError(`Plural message \"${prefix}\" must contain only a \"plural\" property.`);\n      }\n\n      if (typeof node.plural !== 'object' || node.plural === null || Array.isArray(node.plural)) {\n        throw new LinguaInvalidCatalogError(`Plural message \"${prefix}\" must provide an object of string forms.`);\n      }\n\n      const forms = new Map<string, Template>();\n\n      for (const [form, template] of Object.entries(node.plural)) {\n        if (typeof template !== 'string') {\n          throw new LinguaInvalidCatalogError(`Plural form \"${prefix}.${form}\" must be a string.`);\n        }\n\n        forms.set(form, compileTemplate(template));\n      }\n\n      messages.set(prefix, { forms, kind: 'plural' });\n\n      return;\n    }\n\n    for (const [key, value] of Object.entries(node)) {\n      if (unsafeKeys.has(key)) {\n        throw new LinguaInvalidCatalogError(`Catalog key \"${key}\" is reserved.`);\n      }\n\n      visit(value, prefix ? `${prefix}.${key}` : key);\n    }\n  };\n\n  for (const [key, value] of Object.entries(catalog)) {\n    if (unsafeKeys.has(key)) throw new LinguaInvalidCatalogError(`Catalog key \"${key}\" is reserved.`);\n\n    visit(value, key);\n  }\n\n  return messages;\n}\n","import { compileCatalog } from './_catalog';\nimport type { Catalog, MessageKey } from './types';\n\n/** Enumerate every message key in a catalog as a dotted path.\n *\n *  Traverses nested grouping objects and explicit `{ plural: ... }` messages,\n *  producing the same dotted paths that `MessageKey<C>` represents at the type\n *  level. Use this to derive key arrays from the catalog itself instead of\n *  maintaining a parallel list that can go stale.\n *\n *  Pass any catalog subtree to enumerate group-scoped keys. For an `I18n`\n *  instance, pass its current locale catalog explicitly.\n *\n *  @example\n *  ```ts\n *  const messages = {\n *    nav: { home: '...', settings: '...' },\n *  };\n *  const keys = catalogKeys(messages); // ['nav.home', 'nav.settings']\n *  const navKeys = catalogKeys(messages.nav); // ['home', 'settings']\n *\n *  // From an i18n instance: read the current locale's catalog first\n *  const i18n = createI18n({ catalogs: { en: messages }, locale: 'en' });\n *  const state = i18n.serialize();\n *  const allKeys = catalogKeys(state.catalogs[state.locale]);\n *  ```\n */\nexport function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<MessageKey<C>> {\n  return [...compileCatalog(catalog).keys()] as unknown as ReadonlyArray<MessageKey<C>>;\n}\n","export const isDev = !(globalThis as { __LINGUA_PROD__?: boolean }).__LINGUA_PROD__;\n\n/** @internal @security Messages may include user-supplied data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/lingua] ${msg}`);\n}\n\n/** @internal */\nexport function error(msg: string, ...args: unknown[]): void {\n  if (isDev) console.error(`[@vielzeug/lingua] ${msg}`, ...args);\n}\n","import { LinguaInvalidLocaleError } from './errors';\nimport type { Locale } from './types';\n\nconst pluralRules = new Map<string, Intl.PluralRules>();\n\nexport function canonicalLocale(locale: string): Locale {\n  try {\n    const [canonical] = Intl.getCanonicalLocales(locale);\n\n    if (canonical) return canonical;\n  } catch {\n    // Error below names the failed public input.\n  }\n\n  throw new LinguaInvalidLocaleError(`Invalid BCP 47 locale tag: \"${locale}\".`);\n}\n\nexport function localeChain(locale: Locale, fallback: readonly Locale[]): readonly Locale[] {\n  const chain = new Set<Locale>();\n\n  for (const candidate of [locale, ...fallback]) {\n    const parts = candidate.split('-');\n\n    for (let length = parts.length; length > 0; length--) {\n      chain.add(parts.slice(0, length).join('-'));\n    }\n  }\n\n  return [...chain];\n}\n\nexport function pluralCategory(locale: Locale, count: number, ordinal: boolean): Intl.LDMLPluralRule {\n  const key = `${locale}:${ordinal ? 'ordinal' : 'cardinal'}`;\n  let rules = pluralRules.get(key);\n\n  if (!rules) {\n    rules = new Intl.PluralRules(locale, { type: ordinal ? 'ordinal' : 'cardinal' });\n    pluralRules.set(key, rules);\n  }\n\n  return rules.select(count);\n}\n","import { type CompiledCatalog, compileCatalog } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport { LinguaMissingCatalogError } from './errors';\nimport type { Catalog, Catalogs, Locale, SerializedI18n } from './types';\n\ntype CatalogStoreOptions<C extends Catalog> = {\n  readonly catalogs?: Catalogs<C>;\n  readonly loadCatalog?: (locale: Locale) => Promise<C> | C;\n};\n\n/** One catalog state machine owns loaded catalogs and in-flight loading work. */\nexport function createCatalogStore<C extends Catalog>(options: CatalogStoreOptions<C>) {\n  const loaded = new Map<Locale, { readonly catalog: C; readonly compiled: CompiledCatalog }>();\n  const tasks = new Map<Locale, Promise<void>>();\n\n  const hydrate = (locale: Locale, catalog: C): void => {\n    loaded.set(canonicalLocale(locale), { catalog, compiled: compileCatalog(catalog) });\n  };\n\n  for (const [locale, catalog] of Object.entries(options.catalogs ?? {})) hydrate(locale, catalog);\n\n  const load = async (requestedLocale: Locale): Promise<boolean> => {\n    const locale = canonicalLocale(requestedLocale);\n\n    if (loaded.has(locale)) return false;\n\n    const existing = tasks.get(locale);\n\n    if (existing) {\n      await existing;\n\n      return false;\n    }\n\n    if (!options.loadCatalog) {\n      throw new LinguaMissingCatalogError(`No catalog source provided for locale \"${locale}\".`);\n    }\n\n    const task = Promise.resolve(options.loadCatalog(locale)).then(\n      (catalog) => {\n        hydrate(locale, catalog);\n        tasks.delete(locale);\n      },\n      (error: unknown) => {\n        tasks.delete(locale);\n        throw error;\n      },\n    );\n\n    tasks.set(locale, task);\n    await task;\n\n    return true;\n  };\n\n  return {\n    catalogMap(): ReadonlyMap<Locale, CompiledCatalog> {\n      return new Map([...loaded].map(([locale, { compiled }]) => [locale, compiled]));\n    },\n    isLoaded(locale: Locale): boolean {\n      return loaded.has(canonicalLocale(locale));\n    },\n    load,\n    serialized(locale: Locale): SerializedI18n<C> {\n      const catalogs: Catalogs<C> = {};\n\n      for (const [loadedLocale, { catalog }] of loaded) catalogs[loadedLocale] = catalog;\n\n      return { catalogs, locale };\n    },\n  };\n}\n","import { type CompiledCatalog, type CompiledMessage, compileCatalog } from './_catalog';\nimport { isDev, warn } from './_dev';\nimport { canonicalLocale, localeChain, pluralCategory } from './_locale';\nimport { renderText, type Template } from './_template';\nimport { LinguaInvalidPluralCountError, LinguaMissingKeyError, LinguaMissingValueError } from './errors';\nimport type {\n  Catalog,\n  Locale,\n  MissingInfo,\n  MissingStrategy,\n  PluralKey,\n  PluralOptions,\n  TextKey,\n  TranslateOptions,\n  TranslatorOptions,\n} from './types';\n\nexport type Translator<C extends Catalog = Catalog> = {\n  readonly locale: Locale;\n  translate(key: TextKey<C>, options?: TranslateOptions): string;\n  translate(key: PluralKey<C>, options: PluralOptions): string;\n};\n\n/** Loose translate signature implemented by the engine; public overloads restrict keys per catalog type. */\nexport type LooseTranslate = (key: string, options?: TranslateOptions | PluralOptions) => string;\n\nfunction resolveMissing(strategy: MissingStrategy | undefined, info: MissingInfo): string {\n  if (strategy === 'throw') {\n    throw info.name\n      ? new LinguaMissingValueError(\n          `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`,\n        )\n      : new LinguaMissingKeyError(`Missing translation key \"${info.key}\" in locale \"${info.locale}\".`);\n  }\n\n  if (typeof strategy === 'function') return strategy(info);\n\n  // 'key' or undefined (default)\n  if (strategy === undefined && isDev) {\n    warn(\n      info.name\n        ? `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`\n        : `Missing translation key \"${info.key}\" in locale \"${info.locale}\".`,\n    );\n  }\n\n  return info.name ? `{${info.name}}` : info.key;\n}\n\n/** Internal engine: resolves and renders any string key against compiled catalogs for a fixed locale. */\nexport function createTranslateEngine(\n  catalogs: ReadonlyMap<Locale, CompiledCatalog>,\n  options: InternalOptions = {},\n): { readonly locale: Locale; readonly translate: LooseTranslate } {\n  const locale = canonicalLocale(options.locale ?? 'en');\n  const fallback = (\n    Array.isArray(options.fallback) ? options.fallback : options.fallback ? [options.fallback] : []\n  ).map(canonicalLocale);\n  const chain = localeChain(locale, fallback);\n  const missing = options.missing;\n\n  const missingKey = (key: string): string => resolveMissing(missing, { key, locale });\n  const missingValue = (name: string, key: string): string => resolveMissing(missing, { key, locale, name });\n\n  const resolve = (key: string): { readonly locale: Locale; readonly message: CompiledMessage } | undefined => {\n    for (const candidate of chain) {\n      const message = catalogs.get(candidate)?.get(key);\n\n      if (message) return { locale: candidate, message };\n    }\n\n    return undefined;\n  };\n\n  const templateFor = (key: string, options: TranslateOptions | PluralOptions): Template | undefined => {\n    const found = resolve(key);\n\n    if (!found) return undefined;\n\n    if (found.message.kind === 'text') {\n      if ('count' in options) return undefined;\n\n      return found.message.template;\n    }\n\n    if (!('count' in options) || !Number.isFinite(options.count)) {\n      if ('count' in options) throw new LinguaInvalidPluralCountError('`count` must be a finite number.');\n\n      return undefined;\n    }\n\n    const category = pluralCategory(found.locale, options.count, options.ordinal ?? false);\n\n    return found.message.forms.get(category) ?? found.message.forms.get('other');\n  };\n\n  const translate = (key: string, options: TranslateOptions | PluralOptions = {}): string => {\n    const template = templateFor(key, options);\n\n    if (!template) return missingKey(key);\n\n    const values: Record<string, unknown> =\n      'count' in options ? { count: options.count, ...options.values } : (options.values ?? {});\n\n    return renderText(template, values, (name) => missingValue(name, key));\n  };\n\n  return { locale, translate };\n}\n\ntype InternalOptions = {\n  readonly fallback?: Locale | readonly Locale[];\n  readonly locale?: Locale;\n  readonly missing?: MissingStrategy;\n};\n\n/** Creates a fixed-locale translator from one catalog. Lingua snapshots catalog messages during construction. */\nexport function createTranslator<C extends Catalog>(catalog: C, options?: TranslatorOptions): Translator<C> {\n  const engine = createTranslateEngine(\n    new Map([[canonicalLocale(options?.locale ?? 'en'), compileCatalog(catalog)]]),\n    options,\n  );\n\n  return { locale: engine.locale, translate: engine.translate };\n}\n","import { error as logError } from './_dev';\nimport { canonicalLocale, localeChain } from './_locale';\nimport { createCatalogStore } from './_resources';\nimport { LinguaDisposedError, LinguaMissingCatalogError } from './errors';\nimport { createTranslateEngine, type Translator } from './translator';\nimport type {\n  Catalog,\n  I18nOptions,\n  Locale,\n  PluralOptions,\n  SerializedI18n,\n  SubscribeOptions,\n  TranslateOptions,\n} from './types';\n\nexport type I18n<C extends Catalog = Catalog> = Translator<C> & {\n  [Symbol.dispose](): void;\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  /** Current locale. Referentially stable until the locale changes, so frameworks can use it directly as a store snapshot. */\n  getSnapshot(): Locale;\n  isLoaded(options?: { locale?: Locale }): boolean;\n  load(options?: { locale?: Locale }): Promise<void>;\n  serialize(): SerializedI18n<C>;\n  setLocale(locale: Locale): Promise<void>;\n  subscribe(listener: (locale: Locale) => void, options?: SubscribeOptions): () => void;\n};\n\nexport function createI18n<C extends Catalog>(options: I18nOptions<C>): I18n<C> {\n  const fallbackLocales = (\n    Array.isArray(options.fallback) ? options.fallback : options.fallback ? [options.fallback] : []\n  ).map(canonicalLocale);\n  const controller = new AbortController();\n  const subscribers = new Set<(locale: Locale) => void>();\n  let disposed = false;\n  let locale = canonicalLocale(options.locale ?? 'en');\n  let transition = 0;\n\n  const catalogs = createCatalogStore<C>({ catalogs: options.catalogs, loadCatalog: options.loadCatalog });\n\n  const loadTargets = async (target: Locale): Promise<readonly Locale[]> => {\n    const changed: Locale[] = [];\n\n    for (const candidate of new Set([target, ...fallbackLocales])) {\n      if (await catalogs.load(candidate)) changed.push(candidate);\n    }\n\n    return changed;\n  };\n\n  const buildEngine = () => {\n    const ready = localeChain(locale, fallbackLocales).some(catalogs.isLoaded);\n    const effectiveMissing = ready\n      ? options.missing\n      : (): never => {\n          throw new LinguaMissingCatalogError(\n            `No catalog loaded for locale \"${locale}\". Call load() before translating.`,\n          );\n        };\n\n    return createTranslateEngine(catalogs.catalogMap(), { ...options, locale, missing: effectiveMissing });\n  };\n\n  const assertLive = (): void => {\n    if (disposed) throw new LinguaDisposedError();\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    subscribers.clear();\n    controller.abort();\n  };\n\n  const notify = (): void => {\n    engine = buildEngine();\n\n    for (const listener of [...subscribers]) {\n      try {\n        listener(locale);\n      } catch (error) {\n        logError('subscriber error', error);\n      }\n    }\n  };\n\n  const relevant = (candidate: Locale): boolean => localeChain(locale, fallbackLocales).includes(candidate);\n\n  let engine = buildEngine();\n\n  const instance: I18n<C> = {\n    get disposalSignal() {\n      return controller.signal;\n    },\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    getSnapshot() {\n      return locale;\n    },\n    isLoaded(loadOptions) {\n      return !disposed && catalogs.isLoaded(loadOptions?.locale ?? locale);\n    },\n    async load(loadOptions) {\n      assertLive();\n\n      const targetLocale = canonicalLocale(loadOptions?.locale ?? locale);\n      const changed = await loadTargets(targetLocale);\n\n      assertLive();\n      if (changed.some(relevant)) notify();\n    },\n    get locale() {\n      return locale;\n    },\n    serialize() {\n      assertLive();\n\n      return catalogs.serialized(locale);\n    },\n    async setLocale(nextLocale) {\n      assertLive();\n\n      const next = canonicalLocale(nextLocale);\n      const request = ++transition;\n      const changed = await loadTargets(next);\n\n      assertLive();\n      if (request !== transition) return;\n\n      if (next === locale) {\n        if (changed.some(relevant)) notify();\n\n        return;\n      }\n\n      locale = next;\n      notify();\n    },\n    subscribe(listener, subscribeOptions) {\n      assertLive();\n\n      if (subscribeOptions?.signal?.aborted) return () => {};\n\n      const unsubscribe = (): void => {\n        subscribers.delete(listener);\n        subscribeOptions?.signal?.removeEventListener('abort', unsubscribe);\n      };\n\n      subscribeOptions?.signal?.addEventListener('abort', unsubscribe, { once: true });\n      subscribers.add(listener);\n\n      if (subscribeOptions?.immediate) {\n        try {\n          listener(locale);\n        } catch (error) {\n          logError('subscriber error', error);\n        }\n      }\n\n      return unsubscribe;\n    },\n    translate: (key: string, translateOptions?: TranslateOptions | PluralOptions): string =>\n      engine.translate(key, translateOptions),\n    [Symbol.dispose]: dispose,\n  };\n\n  return instance;\n}\n"],"mappings":"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"}

package/dist/ripple.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/ripple");function createReactiveI18n(t){let n=(0,e.fromSubscribable)({getSnapshot:()=>t.locale,subscribe:e=>t.subscribe(()=>e())});return{i18n:t,locale:n,translate:(e,r)=>(n.value,t.translateDynamic(e,r)),translateDynamic:(e,r)=>(n.value,t.translateDynamic(e,r))}}exports.createReactiveI18n=createReactiveI18n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/ripple");function createReactiveI18n(t){let n=(0,e.fromSubscribable)({getSnapshot:()=>t.getSnapshot(),subscribe:e=>t.subscribe(()=>e())}),translate=(e,r)=>(n.value,t.translate(e,r));return{i18n:t,locale:n,translate}}exports.createReactiveI18n=createReactiveI18n;
 //# sourceMappingURL=ripple.cjs.map

package/dist/ripple.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ripple.cjs","names":["fromSubscribable","_vielzeug_ripple","locale","i18n","listener","key","options"],"sources":["../src/ripple.ts"],"sourcesContent":["import { fromSubscribable, type Readable } from '@vielzeug/ripple';\n\nimport type { I18n } from './i18n';\nimport type { Catalog, Locale, MessageKey, PluralOptions, TranslateOptions } from './types';\n\n/** A lingua instance mirrored into ripple readables so templates react to locale changes. */\nexport interface ReactiveI18n<C extends Catalog> {\n  /** The underlying instance for imperative work (`setLocale`, `load`, disposal). */\n  readonly i18n: I18n<C>;\n  /** Reactive locale: reading it inside a computed/template registers the dependency. */\n  readonly locale: Readable<Locale>;\n  /** Translate a text or plural key; re-evaluates whenever the locale changes. */\n  translate(key: MessageKey<C>, options?: TranslateOptions | PluralOptions): string;\n  /** Translate a runtime-assembled key; re-evaluates whenever the locale changes. */\n  translateDynamic(key: string, options?: TranslateOptions | PluralOptions): string;\n}\n\n/**\n * Bridges a lingua instance into ripple so translated strings are reactive.\n *\n * `i18n.translate()` is not ripple-reactive on its own: reading it inside a `computed()`\n * computes once and never re-runs, since it registers no tracked dependency. Both translate\n * methods here first read the reactive {@link ReactiveI18n.locale}, so any binding built on them\n * re-evaluates the instant `setLocale()` resolves.\n */\nexport function createReactiveI18n<C extends Catalog>(i18n: I18n<C>): ReactiveI18n<C> {\n  const locale = fromSubscribable<Locale>({\n    getSnapshot: () => i18n.locale,\n    subscribe: (listener) => i18n.subscribe(() => listener()),\n  });\n\n  return {\n    i18n,\n    locale,\n    translate: (key, options) => {\n      void locale.value;\n      return i18n.translateDynamic(key, options);\n    },\n    translateDynamic: (key, options) => {\n      void locale.value;\n      return i18n.translateDynamic(key, options);\n    },\n  };\n}\n"],"mappings":"A,qGAyBA,SAAgB,mBAAsC,EAAgC,CACpF,IAAME,GAAA,EAASF,EAAAA,iBAAAA,CAAyB,CACtC,gBAAmBG,EAAK,OACxB,UAAY,GAAaA,EAAK,cAAgBC,EAAS,CAAC,CAC1D,CAAC,EAED,MAAO,CACL,OACA,SACA,WAAY,EAAK,KACfF,EAAY,MACLC,EAAK,iBAAiBE,EAAKC,CAAO,GAE3C,kBAAmB,EAAK,KACtBJ,EAAY,MACLC,EAAK,iBAAiBE,EAAKC,CAAO,EAE7C,CACF,C"}
+{"version":3,"file":"ripple.cjs","names":["fromSubscribable","_vielzeug_ripple","locale","i18n","listener","key","options"],"sources":["../src/ripple.ts"],"sourcesContent":["import { fromSubscribable, type Readable } from '@vielzeug/ripple';\n\nimport type { I18n } from './i18n';\nimport type { Translator } from './translator';\nimport type { Catalog, Locale, PluralOptions, TranslateOptions } from './types';\n\n/** A lingua instance mirrored into ripple readables so templates react to locale changes. */\nexport interface ReactiveI18n<C extends Catalog> {\n  /** The underlying instance for imperative work (`setLocale`, `load`, disposal). */\n  readonly i18n: I18n<C>;\n  /** Reactive locale: reading it inside a computed/template registers the dependency. */\n  readonly locale: Readable<Locale>;\n  /** Translate a text or plural key; re-evaluates whenever the locale changes. */\n  readonly translate: Translator<C>['translate'];\n}\n\n/**\n * Bridges a lingua instance into ripple so translated strings are reactive.\n *\n * `i18n.translate()` is not ripple-reactive on its own: reading it inside a `computed()`\n * computes once and never re-runs, since it registers no tracked dependency. The bridge's\n * `translate` reads the reactive {@link ReactiveI18n.locale} first, so any binding built on\n * it re-evaluates the instant `setLocale()` resolves.\n */\nexport function createReactiveI18n<C extends Catalog>(i18n: I18n<C>): ReactiveI18n<C> {\n  const locale = fromSubscribable<Locale>({\n    getSnapshot: () => i18n.getSnapshot(),\n    subscribe: (listener) => i18n.subscribe(() => listener()),\n  });\n\n  const translate = (key: string, options?: TranslateOptions | PluralOptions): string => {\n    void locale.value;\n    return i18n.translate(key as never, options as never);\n  };\n\n  return { i18n, locale, translate: translate as ReactiveI18n<C>['translate'] };\n}\n"],"mappings":"A,qGAwBA,SAAgB,mBAAsC,EAAgC,CACpF,IAAME,GAAA,EAASF,EAAAA,iBAAAA,CAAyB,CACtC,gBAAmBG,EAAK,YAAY,EACpC,UAAY,GAAaA,EAAK,cAAgBC,EAAS,CAAC,CAC1D,CAAC,EAEK,WAAa,EAAa,KAC9BF,EAAY,MACLC,EAAK,UAAUE,EAAcC,CAAgB,GAGtD,MAAO,CAAE,OAAM,SAAmB,SAA0C,CAC9E,C"}

package/dist/ripple.d.ts

@@ -1,6 +1,7 @@
 import { type Readable } from '@vielzeug/ripple';
 import type { I18n } from './i18n';
-import type { Catalog, Locale, MessageKey, PluralOptions, TranslateOptions } from './types';
+import type { Translator } from './translator';
+import type { Catalog, Locale } from './types';
 /** A lingua instance mirrored into ripple readables so templates react to locale changes. */
 export interface ReactiveI18n<C extends Catalog> {
     /** The underlying instance for imperative work (`setLocale`, `load`, disposal). */
@@ -8,17 +9,15 @@ export interface ReactiveI18n<C extends Catalog> {
     /** Reactive locale: reading it inside a computed/template registers the dependency. */
     readonly locale: Readable<Locale>;
     /** Translate a text or plural key; re-evaluates whenever the locale changes. */
-    translate(key: MessageKey<C>, options?: TranslateOptions | PluralOptions): string;
-    /** Translate a runtime-assembled key; re-evaluates whenever the locale changes. */
-    translateDynamic(key: string, options?: TranslateOptions | PluralOptions): string;
+    readonly translate: Translator<C>['translate'];
 }
 /**
  * Bridges a lingua instance into ripple so translated strings are reactive.
  *
  * `i18n.translate()` is not ripple-reactive on its own: reading it inside a `computed()`
- * computes once and never re-runs, since it registers no tracked dependency. Both translate
- * methods here first read the reactive {@link ReactiveI18n.locale}, so any binding built on them
- * re-evaluates the instant `setLocale()` resolves.
+ * computes once and never re-runs, since it registers no tracked dependency. The bridge's
+ * `translate` reads the reactive {@link ReactiveI18n.locale} first, so any binding built on
+ * it re-evaluates the instant `setLocale()` resolves.
  */
 export declare function createReactiveI18n<C extends Catalog>(i18n: I18n<C>): ReactiveI18n<C>;
 //# sourceMappingURL=ripple.d.ts.map

package/dist/ripple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ripple.d.ts","sourceRoot":"","sources":["../src/ripple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE5F,6FAA6F;AAC7F,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,OAAO;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,gFAAgF;IAChF,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,MAAM,CAAC;IAClF,mFAAmF;IACnF,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,MAAM,CAAC;CACnF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAkBpF"}
+{"version":3,"file":"ripple.d.ts","sourceRoot":"","sources":["../src/ripple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAEhF,6FAA6F;AAC7F,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,OAAO;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAYpF"}

package/dist/ripple.js

@@ -2,14 +2,13 @@ import { fromSubscribable as e } from "@vielzeug/ripple";
 // src/ripple.ts
 function createReactiveI18n(t) {
 	let n = e({
-		getSnapshot: () => t.locale,
+		getSnapshot: () => t.getSnapshot(),
 		subscribe: (e) => t.subscribe(() => e())
-	});
+	}), translate = (e, r) => (n.value, t.translate(e, r));
 	return {
 		i18n: t,
 		locale: n,
-		translate: (e, r) => (n.value, t.translateDynamic(e, r)),
-		translateDynamic: (e, r) => (n.value, t.translateDynamic(e, r))
+		translate
 	};
 }
 export { createReactiveI18n };

package/dist/ripple.js.map

@@ -1 +1 @@
-{"version":3,"file":"ripple.js","names":["locale","fromSubscribable","i18n","listener","key","options"],"sources":["../src/ripple.ts"],"sourcesContent":["import { fromSubscribable, type Readable } from '@vielzeug/ripple';\n\nimport type { I18n } from './i18n';\nimport type { Catalog, Locale, MessageKey, PluralOptions, TranslateOptions } from './types';\n\n/** A lingua instance mirrored into ripple readables so templates react to locale changes. */\nexport interface ReactiveI18n<C extends Catalog> {\n  /** The underlying instance for imperative work (`setLocale`, `load`, disposal). */\n  readonly i18n: I18n<C>;\n  /** Reactive locale: reading it inside a computed/template registers the dependency. */\n  readonly locale: Readable<Locale>;\n  /** Translate a text or plural key; re-evaluates whenever the locale changes. */\n  translate(key: MessageKey<C>, options?: TranslateOptions | PluralOptions): string;\n  /** Translate a runtime-assembled key; re-evaluates whenever the locale changes. */\n  translateDynamic(key: string, options?: TranslateOptions | PluralOptions): string;\n}\n\n/**\n * Bridges a lingua instance into ripple so translated strings are reactive.\n *\n * `i18n.translate()` is not ripple-reactive on its own: reading it inside a `computed()`\n * computes once and never re-runs, since it registers no tracked dependency. Both translate\n * methods here first read the reactive {@link ReactiveI18n.locale}, so any binding built on them\n * re-evaluates the instant `setLocale()` resolves.\n */\nexport function createReactiveI18n<C extends Catalog>(i18n: I18n<C>): ReactiveI18n<C> {\n  const locale = fromSubscribable<Locale>({\n    getSnapshot: () => i18n.locale,\n    subscribe: (listener) => i18n.subscribe(() => listener()),\n  });\n\n  return {\n    i18n,\n    locale,\n    translate: (key, options) => {\n      void locale.value;\n      return i18n.translateDynamic(key, options);\n    },\n    translateDynamic: (key, options) => {\n      void locale.value;\n      return i18n.translateDynamic(key, options);\n    },\n  };\n}\n"],"mappings":";;AAyBA,SAAgB,mBAAsC,GAAgC;CACpF,IAAMA,IAASC,EAAyB;EACtC,mBAAmBC,EAAK;EACxB,YAAY,MAAaA,EAAK,gBAAgBC,EAAS,CAAC;CAC1D,CAAC;CAED,OAAO;EACL;EACA;EACA,YAAY,GAAK,OACfH,EAAY,OACLE,EAAK,iBAAiBE,GAAKC,CAAO;EAE3C,mBAAmB,GAAK,OACtBL,EAAY,OACLE,EAAK,iBAAiBE,GAAKC,CAAO;CAE7C;AACF"}
+{"version":3,"file":"ripple.js","names":["locale","fromSubscribable","i18n","listener","key","options"],"sources":["../src/ripple.ts"],"sourcesContent":["import { fromSubscribable, type Readable } from '@vielzeug/ripple';\n\nimport type { I18n } from './i18n';\nimport type { Translator } from './translator';\nimport type { Catalog, Locale, PluralOptions, TranslateOptions } from './types';\n\n/** A lingua instance mirrored into ripple readables so templates react to locale changes. */\nexport interface ReactiveI18n<C extends Catalog> {\n  /** The underlying instance for imperative work (`setLocale`, `load`, disposal). */\n  readonly i18n: I18n<C>;\n  /** Reactive locale: reading it inside a computed/template registers the dependency. */\n  readonly locale: Readable<Locale>;\n  /** Translate a text or plural key; re-evaluates whenever the locale changes. */\n  readonly translate: Translator<C>['translate'];\n}\n\n/**\n * Bridges a lingua instance into ripple so translated strings are reactive.\n *\n * `i18n.translate()` is not ripple-reactive on its own: reading it inside a `computed()`\n * computes once and never re-runs, since it registers no tracked dependency. The bridge's\n * `translate` reads the reactive {@link ReactiveI18n.locale} first, so any binding built on\n * it re-evaluates the instant `setLocale()` resolves.\n */\nexport function createReactiveI18n<C extends Catalog>(i18n: I18n<C>): ReactiveI18n<C> {\n  const locale = fromSubscribable<Locale>({\n    getSnapshot: () => i18n.getSnapshot(),\n    subscribe: (listener) => i18n.subscribe(() => listener()),\n  });\n\n  const translate = (key: string, options?: TranslateOptions | PluralOptions): string => {\n    void locale.value;\n    return i18n.translate(key as never, options as never);\n  };\n\n  return { i18n, locale, translate: translate as ReactiveI18n<C>['translate'] };\n}\n"],"mappings":";;AAwBA,SAAgB,mBAAsC,GAAgC;CACpF,IAAMA,IAASC,EAAyB;EACtC,mBAAmBC,EAAK,YAAY;EACpC,YAAY,MAAaA,EAAK,gBAAgBC,EAAS,CAAC;CAC1D,CAAC,GAEK,aAAa,GAAa,OAC9BH,EAAY,OACLE,EAAK,UAAUE,GAAcC,CAAgB;CAGtD,OAAO;EAAE;EAAM;EAAmB;CAA0C;AAC9E"}

package/dist/translator.cjs

@@ -1,2 +1,2 @@
-const e=require("./_catalog.cjs");require("./_dev.cjs");const t=require("./_locale.cjs"),n=require("./_template.cjs"),r=require("./errors.cjs");function resolveMissing(e,t){if(e===`throw`)throw t.name?new r.LinguaMissingValueError(`Missing interpolation value "${t.name}" for key "${t.key}" in locale "${t.locale}".`):new r.LinguaMissingKeyError(`Missing translation key "${t.key}" in locale "${t.locale}".`);return typeof e==`function`?e(t):t.name?`{${t.name}}`:t.key}function createTranslatorFromCompiled(e,i={}){let a=t.canonicalLocale(i.locale??`en`),o=(Array.isArray(i.fallback)?i.fallback:i.fallback?[i.fallback]:[]).map(t.canonicalLocale),s=t.localeChain(a,o),c=i.missing,missingKey=e=>resolveMissing(c,{key:e,locale:a}),missingValue=(e,t)=>resolveMissing(c,{key:t,locale:a,name:e}),resolve=t=>{for(let n of s){let r=e.get(n)?.get(t);if(r)return{locale:n,message:r}}},templateFor=(e,n)=>{let i=resolve(e);if(!i)return;if(i.message.kind===`text`)return`count`in n?void 0:{key:e,template:i.message.template};if(!(`count`in n)||!Number.isFinite(n.count)){if(`count`in n)throw new r.LinguaInvalidPluralCountError("`count` must be a finite number.");return}let a=n.count===0&&!n.ordinal?`zero`:t.pluralCategory(i.locale,n.count,n.ordinal??!1),o=i.message.forms.get(a)??i.message.forms.get(`other`);return o?{key:e,template:o}:void 0},valuesFor=e=>`count`in e?{count:e.count,...e.values}:e.values??{},partsDynamic=(e,t)=>{let r=templateFor(e,t);return r?n.renderParts(r.template,valuesFor(t),e=>missingValue(e,r.key)):[{type:`text`,value:missingKey(e)}]},translateDynamic=(e,t={})=>{let r=templateFor(e,t);return r?n.renderText(r.template,valuesFor(t),e=>missingValue(e,r.key)):missingKey(e)};return{locale:a,parts(e,t){return partsDynamic(e,t)},partsDynamic,translate(e,t={}){return translateDynamic(e,t)},translateDynamic}}function createTranslator(n,r){let i=t.canonicalLocale(r?.locale??`en`);return createTranslatorFromCompiled(new Map([[i,e.compileCatalog(n)]]),{...r,locale:i})}exports.createTranslator=createTranslator,exports.createTranslatorFromCompiled=createTranslatorFromCompiled;
+const e=require("./_catalog.cjs");require("./_dev.cjs");const t=require("./_locale.cjs"),n=require("./_template.cjs"),r=require("./errors.cjs");function resolveMissing(e,t){if(e===`throw`)throw t.name?new r.LinguaMissingValueError(`Missing interpolation value "${t.name}" for key "${t.key}" in locale "${t.locale}".`):new r.LinguaMissingKeyError(`Missing translation key "${t.key}" in locale "${t.locale}".`);return typeof e==`function`?e(t):t.name?`{${t.name}}`:t.key}function createTranslateEngine(e,i={}){let a=t.canonicalLocale(i.locale??`en`),o=(Array.isArray(i.fallback)?i.fallback:i.fallback?[i.fallback]:[]).map(t.canonicalLocale),s=t.localeChain(a,o),c=i.missing,missingKey=e=>resolveMissing(c,{key:e,locale:a}),missingValue=(e,t)=>resolveMissing(c,{key:t,locale:a,name:e}),resolve=t=>{for(let n of s){let r=e.get(n)?.get(t);if(r)return{locale:n,message:r}}},templateFor=(e,n)=>{let i=resolve(e);if(!i)return;if(i.message.kind===`text`)return`count`in n?void 0:i.message.template;if(!(`count`in n)||!Number.isFinite(n.count)){if(`count`in n)throw new r.LinguaInvalidPluralCountError("`count` must be a finite number.");return}let a=t.pluralCategory(i.locale,n.count,n.ordinal??!1);return i.message.forms.get(a)??i.message.forms.get(`other`)},translate=(e,t={})=>{let r=templateFor(e,t);if(!r)return missingKey(e);let i=`count`in t?{count:t.count,...t.values}:t.values??{};return n.renderText(r,i,t=>missingValue(t,e))};return{locale:a,translate}}function createTranslator(n,r){let i=createTranslateEngine(new Map([[t.canonicalLocale(r?.locale??`en`),e.compileCatalog(n)]]),r);return{locale:i.locale,translate:i.translate}}exports.createTranslateEngine=createTranslateEngine,exports.createTranslator=createTranslator;
 //# sourceMappingURL=translator.cjs.map

package/dist/translator.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"translator.cjs","names":["LinguaMissingValueError","LinguaMissingKeyError","canonicalLocale","localeChain","LinguaInvalidPluralCountError","pluralCategory","renderParts","renderText","compileCatalog","require__catalog","require__locale","require__template","require_errors","strategy","info","locale","options","fallback","chain","missing","candidate","message","catalogs","key","found","category","template","name","catalog"],"sources":["../src/translator.ts"],"sourcesContent":["import { type CompiledCatalog, type CompiledMessage, compileCatalog } from './_catalog';\nimport { isDev, warn } from './_dev';\nimport { canonicalLocale, localeChain, pluralCategory } from './_locale';\nimport { renderParts, renderText, type Template } from './_template';\nimport { LinguaInvalidPluralCountError, LinguaMissingKeyError, LinguaMissingValueError } from './errors';\nimport type {\n  Catalog,\n  Locale,\n  MissingInfo,\n  MissingStrategy,\n  Part,\n  PluralKey,\n  PluralOptions,\n  TextKey,\n  TranslateOptions,\n  TranslatorOptions,\n} from './types';\n\nexport type Translator<C extends Catalog = Catalog> = {\n  readonly locale: Locale;\n  parts<V>(key: TextKey<C>, options: TranslateOptions & { values: Record<string, V> }): Array<Part<V>>;\n  parts<V>(key: PluralKey<C>, options: PluralOptions & { values?: Record<string, V> }): Array<Part<number | V>>;\n  partsDynamic<V>(\n    key: string,\n    options: (TranslateOptions | PluralOptions) & { values?: Record<string, V> },\n  ): Array<Part<number | V>>;\n  translate(key: TextKey<C>, options?: TranslateOptions): string;\n  translate(key: PluralKey<C>, options: PluralOptions): string;\n  translateDynamic(key: string, options?: TranslateOptions | PluralOptions): string;\n};\n\ntype InternalOptions = {\n  readonly fallback?: Locale | readonly Locale[];\n  readonly locale?: Locale;\n  readonly missing?: MissingStrategy;\n};\n\nfunction resolveMissing(strategy: MissingStrategy | undefined, info: MissingInfo): string {\n  if (strategy === 'throw') {\n    throw info.name\n      ? new LinguaMissingValueError(\n          `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`,\n        )\n      : new LinguaMissingKeyError(`Missing translation key \"${info.key}\" in locale \"${info.locale}\".`);\n  }\n\n  if (typeof strategy === 'function') return strategy(info);\n\n  // 'key' or undefined (default)\n  if (strategy === undefined && isDev) {\n    warn(\n      info.name\n        ? `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`\n        : `Missing translation key \"${info.key}\" in locale \"${info.locale}\".`,\n    );\n  }\n\n  return info.name ? `{${info.name}}` : info.key;\n}\n\ntype ResolvedMessage = { readonly locale: Locale; readonly message: CompiledMessage };\n\nexport function createTranslatorFromCompiled<C extends Catalog>(\n  catalogs: ReadonlyMap<Locale, CompiledCatalog>,\n  options: InternalOptions = {},\n): Translator<C> {\n  const locale = canonicalLocale(options.locale ?? 'en');\n  const fallback = (\n    Array.isArray(options.fallback) ? options.fallback : options.fallback ? [options.fallback] : []\n  ).map(canonicalLocale);\n  const chain = localeChain(locale, fallback);\n  const missing = options.missing;\n\n  const missingKey = (key: string): string => resolveMissing(missing, { key, locale });\n  const missingValue = (name: string, key: string): string => resolveMissing(missing, { key, locale, name });\n\n  const resolve = (key: string): ResolvedMessage | undefined => {\n    for (const candidate of chain) {\n      const message = catalogs.get(candidate)?.get(key);\n\n      if (message) return { locale: candidate, message };\n    }\n\n    return undefined;\n  };\n\n  const templateFor = (\n    key: string,\n    options: TranslateOptions | PluralOptions,\n  ): { key: string; template: Template } | undefined => {\n    const found = resolve(key);\n\n    if (!found) return undefined;\n\n    if (found.message.kind === 'text') {\n      if ('count' in options) return undefined;\n\n      return { key, template: found.message.template };\n    }\n\n    if (!('count' in options) || !Number.isFinite(options.count)) {\n      if ('count' in options) throw new LinguaInvalidPluralCountError('`count` must be a finite number.');\n\n      return undefined;\n    }\n\n    const category =\n      options.count === 0 && !options.ordinal\n        ? 'zero'\n        : pluralCategory(found.locale, options.count, options.ordinal ?? false);\n    const template = found.message.forms.get(category) ?? found.message.forms.get('other');\n\n    return template ? { key, template } : undefined;\n  };\n\n  const valuesFor = (options: TranslateOptions | PluralOptions): Record<string, unknown> =>\n    'count' in options ? { count: options.count, ...options.values } : (options.values ?? {});\n\n  const partsDynamic = <V>(\n    key: string,\n    options: (TranslateOptions | PluralOptions) & { values?: Record<string, V> },\n  ): Array<Part<number | V>> => {\n    const found = templateFor(key, options);\n\n    if (!found) return [{ type: 'text', value: missingKey(key) }];\n\n    return renderParts(found.template, valuesFor(options) as Record<string, V | number>, (name) =>\n      missingValue(name, found.key),\n    );\n  };\n\n  const translateDynamic = (key: string, options: TranslateOptions | PluralOptions = {}): string => {\n    const found = templateFor(key, options);\n\n    if (!found) return missingKey(key);\n\n    return renderText(found.template, valuesFor(options), (name) => missingValue(name, found.key));\n  };\n\n  return {\n    locale,\n    parts(key: string, options: (TranslateOptions | PluralOptions) & { values?: Record<string, unknown> }) {\n      return partsDynamic(key, options);\n    },\n    partsDynamic,\n    translate(key: string, options: TranslateOptions | PluralOptions = {}) {\n      return translateDynamic(key, options);\n    },\n    translateDynamic,\n  } as Translator<C>;\n}\n\n/** Creates a fixed-locale translator from one catalog. Lingua snapshots catalog messages during construction. */\nexport function createTranslator<C extends Catalog>(catalog: C, options?: TranslatorOptions): Translator<C> {\n  const locale = canonicalLocale(options?.locale ?? 'en');\n  const compiled = new Map<Locale, CompiledCatalog>([[locale, compileCatalog(catalog)]]);\n\n  return createTranslatorFromCompiled<C>(compiled, { ...options, locale });\n}\n"],"mappings":"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"}
+{"version":3,"file":"translator.cjs","names":["LinguaMissingValueError","LinguaMissingKeyError","canonicalLocale","localeChain","LinguaInvalidPluralCountError","pluralCategory","renderText","compileCatalog","require__catalog","require__locale","require__template","require_errors","strategy","info","locale","options","fallback","chain","missing","candidate","message","catalogs","key","found","category","template","values","name","engine","catalog"],"sources":["../src/translator.ts"],"sourcesContent":["import { type CompiledCatalog, type CompiledMessage, compileCatalog } from './_catalog';\nimport { isDev, warn } from './_dev';\nimport { canonicalLocale, localeChain, pluralCategory } from './_locale';\nimport { renderText, type Template } from './_template';\nimport { LinguaInvalidPluralCountError, LinguaMissingKeyError, LinguaMissingValueError } from './errors';\nimport type {\n  Catalog,\n  Locale,\n  MissingInfo,\n  MissingStrategy,\n  PluralKey,\n  PluralOptions,\n  TextKey,\n  TranslateOptions,\n  TranslatorOptions,\n} from './types';\n\nexport type Translator<C extends Catalog = Catalog> = {\n  readonly locale: Locale;\n  translate(key: TextKey<C>, options?: TranslateOptions): string;\n  translate(key: PluralKey<C>, options: PluralOptions): string;\n};\n\n/** Loose translate signature implemented by the engine; public overloads restrict keys per catalog type. */\nexport type LooseTranslate = (key: string, options?: TranslateOptions | PluralOptions) => string;\n\nfunction resolveMissing(strategy: MissingStrategy | undefined, info: MissingInfo): string {\n  if (strategy === 'throw') {\n    throw info.name\n      ? new LinguaMissingValueError(\n          `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`,\n        )\n      : new LinguaMissingKeyError(`Missing translation key \"${info.key}\" in locale \"${info.locale}\".`);\n  }\n\n  if (typeof strategy === 'function') return strategy(info);\n\n  // 'key' or undefined (default)\n  if (strategy === undefined && isDev) {\n    warn(\n      info.name\n        ? `Missing interpolation value \"${info.name}\" for key \"${info.key}\" in locale \"${info.locale}\".`\n        : `Missing translation key \"${info.key}\" in locale \"${info.locale}\".`,\n    );\n  }\n\n  return info.name ? `{${info.name}}` : info.key;\n}\n\n/** Internal engine: resolves and renders any string key against compiled catalogs for a fixed locale. */\nexport function createTranslateEngine(\n  catalogs: ReadonlyMap<Locale, CompiledCatalog>,\n  options: InternalOptions = {},\n): { readonly locale: Locale; readonly translate: LooseTranslate } {\n  const locale = canonicalLocale(options.locale ?? 'en');\n  const fallback = (\n    Array.isArray(options.fallback) ? options.fallback : options.fallback ? [options.fallback] : []\n  ).map(canonicalLocale);\n  const chain = localeChain(locale, fallback);\n  const missing = options.missing;\n\n  const missingKey = (key: string): string => resolveMissing(missing, { key, locale });\n  const missingValue = (name: string, key: string): string => resolveMissing(missing, { key, locale, name });\n\n  const resolve = (key: string): { readonly locale: Locale; readonly message: CompiledMessage } | undefined => {\n    for (const candidate of chain) {\n      const message = catalogs.get(candidate)?.get(key);\n\n      if (message) return { locale: candidate, message };\n    }\n\n    return undefined;\n  };\n\n  const templateFor = (key: string, options: TranslateOptions | PluralOptions): Template | undefined => {\n    const found = resolve(key);\n\n    if (!found) return undefined;\n\n    if (found.message.kind === 'text') {\n      if ('count' in options) return undefined;\n\n      return found.message.template;\n    }\n\n    if (!('count' in options) || !Number.isFinite(options.count)) {\n      if ('count' in options) throw new LinguaInvalidPluralCountError('`count` must be a finite number.');\n\n      return undefined;\n    }\n\n    const category = pluralCategory(found.locale, options.count, options.ordinal ?? false);\n\n    return found.message.forms.get(category) ?? found.message.forms.get('other');\n  };\n\n  const translate = (key: string, options: TranslateOptions | PluralOptions = {}): string => {\n    const template = templateFor(key, options);\n\n    if (!template) return missingKey(key);\n\n    const values: Record<string, unknown> =\n      'count' in options ? { count: options.count, ...options.values } : (options.values ?? {});\n\n    return renderText(template, values, (name) => missingValue(name, key));\n  };\n\n  return { locale, translate };\n}\n\ntype InternalOptions = {\n  readonly fallback?: Locale | readonly Locale[];\n  readonly locale?: Locale;\n  readonly missing?: MissingStrategy;\n};\n\n/** Creates a fixed-locale translator from one catalog. Lingua snapshots catalog messages during construction. */\nexport function createTranslator<C extends Catalog>(catalog: C, options?: TranslatorOptions): Translator<C> {\n  const engine = createTranslateEngine(\n    new Map([[canonicalLocale(options?.locale ?? 'en'), compileCatalog(catalog)]]),\n    options,\n  );\n\n  return { locale: engine.locale, translate: engine.translate };\n}\n"],"mappings":"A,gJA0BA,SAAS,eAAe,EAAuC,EAA2B,CACxF,GAAIY,IAAa,QACf,MAAMC,EAAK,KACP,IAAIb,EAAAA,wBACF,gCAAgCa,EAAK,KAAK,aAAaA,EAAK,IAAI,eAAeA,EAAK,OAAO,GAC7F,EACA,IAAIZ,EAAAA,sBAAsB,4BAA4BY,EAAK,IAAI,eAAeA,EAAK,OAAO,GAAG,EAcnG,OAXI,OAAOD,GAAa,WAAmBA,EAASC,CAAI,EAWjDA,EAAK,KAAO,IAAIA,EAAK,KAAK,GAAKA,EAAK,GAC7C,CAGA,SAAgB,sBACd,EACA,EAA2B,CAAC,EACqC,CACjE,IAAMC,EAASZ,EAAAA,gBAAgBa,EAAQ,QAAU,IAAI,EAC/CC,GACJ,MAAM,QAAQD,EAAQ,QAAQ,EAAIA,EAAQ,SAAWA,EAAQ,SAAW,CAACA,EAAQ,QAAQ,EAAI,CAAC,EAAA,CAC9F,IAAIb,EAAAA,eAAe,EACfe,EAAQd,EAAAA,YAAYW,EAAQE,CAAQ,EACpCE,EAAUH,EAAQ,QAElB,WAAc,GAAwB,eAAeG,EAAS,CAAE,MAAK,QAAO,CAAC,EAC7E,cAAgB,EAAc,IAAwB,eAAeA,EAAS,CAAE,MAAK,SAAQ,MAAK,CAAC,EAEnG,QAAW,GAA4F,CAC3G,IAAK,IAAMC,KAAaF,EAAO,CAC7B,IAAMG,EAAUC,EAAS,IAAIF,CAAS,CAAC,EAAE,IAAIG,CAAG,EAEhD,GAAIF,EAAS,MAAO,CAAE,OAAQD,EAAW,SAAQ,CACnD,CAGF,EAEM,aAAe,EAAa,IAAoE,CACpG,IAAMI,EAAQ,QAAQD,CAAG,EAEzB,GAAI,CAACC,EAAO,OAEZ,GAAIA,EAAM,QAAQ,OAAS,OAGzB,MAFI,UAAWR,EAAS,OAEjBQ,EAAM,QAAQ,SAGvB,GAAI,EAAE,UAAWR,IAAY,CAAC,OAAO,SAASA,EAAQ,KAAK,EAAG,CAC5D,GAAI,UAAWA,EAAS,MAAM,IAAIX,EAAAA,8BAA8B,kCAAkC,EAElG,MACF,CAEA,IAAMoB,EAAWnB,EAAAA,eAAekB,EAAM,OAAQR,EAAQ,MAAOA,EAAQ,SAAW,EAAK,EAErF,OAAOQ,EAAM,QAAQ,MAAM,IAAIC,CAAQ,GAAKD,EAAM,QAAQ,MAAM,IAAI,OAAO,CAC7E,EAEM,WAAa,EAAa,EAA4C,CAAC,IAAc,CACzF,IAAME,EAAW,YAAYH,EAAKP,CAAO,EAEzC,GAAI,CAACU,EAAU,OAAO,WAAWH,CAAG,EAEpC,IAAMI,EACJ,UAAWX,EAAU,CAAE,MAAOA,EAAQ,MAAO,GAAGA,EAAQ,MAAO,EAAKA,EAAQ,QAAU,CAAC,EAEzF,OAAOT,EAAAA,WAAWmB,EAAUC,EAAS,GAAS,aAAaC,EAAML,CAAG,CAAC,CACvE,EAEA,MAAO,CAAE,SAAQ,SAAU,CAC7B,CASA,SAAgB,iBAAoC,EAAY,EAA4C,CAC1G,IAAMM,EAAS,sBACb,IAAI,IAAI,CAAC,CAAC1B,EAAAA,gBAAgBa,GAAS,QAAU,IAAI,EAAGR,EAAAA,eAAesB,CAAO,CAAC,CAAC,CAAC,EAC7Ed,CACF,EAEA,MAAO,CAAE,OAAQa,EAAO,OAAQ,UAAWA,EAAO,SAAU,CAC9D,C"}

package/dist/translator.d.ts

@@ -1,26 +1,22 @@
 import { type CompiledCatalog } from './_catalog';
-import type { Catalog, Locale, MissingStrategy, Part, PluralKey, PluralOptions, TextKey, TranslateOptions, TranslatorOptions } from './types';
+import type { Catalog, Locale, MissingStrategy, PluralKey, PluralOptions, TextKey, TranslateOptions, TranslatorOptions } from './types';
 export type Translator<C extends Catalog = Catalog> = {
     readonly locale: Locale;
-    parts<V>(key: TextKey<C>, options: TranslateOptions & {
-        values: Record<string, V>;
-    }): Array<Part<V>>;
-    parts<V>(key: PluralKey<C>, options: PluralOptions & {
-        values?: Record<string, V>;
-    }): Array<Part<number | V>>;
-    partsDynamic<V>(key: string, options: (TranslateOptions | PluralOptions) & {
-        values?: Record<string, V>;
-    }): Array<Part<number | V>>;
     translate(key: TextKey<C>, options?: TranslateOptions): string;
     translate(key: PluralKey<C>, options: PluralOptions): string;
-    translateDynamic(key: string, options?: TranslateOptions | PluralOptions): string;
+};
+/** Loose translate signature implemented by the engine; public overloads restrict keys per catalog type. */
+export type LooseTranslate = (key: string, options?: TranslateOptions | PluralOptions) => string;
+/** Internal engine: resolves and renders any string key against compiled catalogs for a fixed locale. */
+export declare function createTranslateEngine(catalogs: ReadonlyMap<Locale, CompiledCatalog>, options?: InternalOptions): {
+    readonly locale: Locale;
+    readonly translate: LooseTranslate;
 };
 type InternalOptions = {
     readonly fallback?: Locale | readonly Locale[];
     readonly locale?: Locale;
     readonly missing?: MissingStrategy;
 };
-export declare function createTranslatorFromCompiled<C extends Catalog>(catalogs: ReadonlyMap<Locale, CompiledCatalog>, options?: InternalOptions): Translator<C>;
 /** Creates a fixed-locale translator from one catalog. Lingua snapshots catalog messages during construction. */
 export declare function createTranslator<C extends Catalog>(catalog: C, options?: TranslatorOptions): Translator<C>;
 export {};