@vielzeug/lingua 2.4.1 → 3.0.0

package/README.md

@@ -1,56 +1,37 @@
 # @vielzeug/lingua
 
-> Explicit, framework-neutral localization for TypeScript.
-
-`@vielzeug/lingua` provides immutable translators for fixed locales and a stateful i18n store for locale changes and optional lazy catalogs.
+> Typed i18n with pluralization and lazy locale loading
 
 ## Installation
 
 ```sh
 pnpm add @vielzeug/lingua
+npm install @vielzeug/lingua
+yarn add @vielzeug/lingua
 ```
 
 ## Quick Start
 
 ```ts
-import { createCatalogTranslator } from '@vielzeug/lingua';
+import { createTranslator } from '@vielzeug/lingua';
 
-const translator = createCatalogTranslator({
+const translator = createTranslator({
   greeting: 'Hello, {name}!',
   inbox: { plural: { one: 'One message', other: '{count} messages' } },
-});
+}, { locale: 'en' });
 
 translator.translate('greeting', { values: { name: 'Ada' } });
 translator.translate('inbox', { count: 3 });
 ```
 
-## Integration Patterns
-
-Use `translate()` for string interpolation and `segments()` for UI values. Give UI values consumer-owned keys before passing them; Lingua returns same values without cloning or mutation.
-
-```ts
-const retry = { key: 'retry', href: '/retry' };
-translator.segments('greeting', { values: { name: retry } });
-```
-
-Use `createTranslationStore()` only when locale changes at runtime. Its stable `subscribe` and `getSnapshot` methods work directly with platform subscription APIs such as React `useSyncExternalStore`; hydrate client store from server `serialize()` state before first render. Missing keys return key, and absent interpolation values return `{name}` by default.
-
-Keep arrays and application metadata outside catalogs. Store message keys with application definitions, then translate labels while building UI options.
-
-## Exports
-
-- `createCatalogTranslator` — immutable translator for one fixed-locale catalog.
-- `createTranslator` — immutable translator for fixed locale-keyed catalogs.
-- `createTranslationStore` / `hydrateTranslationStore` — mutable locale state, lazy catalog loading, and SSR state.
-- `createFormatter` from `@vielzeug/lingua/format`.
-- `validateCatalog` from `@vielzeug/lingua/validate`.
-
 ## Documentation
 
 - [Overview](https://vielzeug.dev/lingua/)
 - [Usage Guide](https://vielzeug.dev/lingua/usage)
 - [API Reference](https://vielzeug.dev/lingua/api)
+- [Examples](https://vielzeug.dev/lingua/examples)
+- [Migration Guide](https://vielzeug.dev/lingua/migration)
 
 ## License
 
-MIT © Helmuth Saatkamp
+MIT © [Helmuth Saatkamp](https://github.com/helmuthdu) — part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.

package/dist/_resources.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs"),t=require("./_catalog.cjs"),n=require("./_locale.cjs");function r(r){let i=new Map,a=new Map,o=new Map;for(let[e,t]of Object.entries(r))i.set(n.canonicalLocale(e),t);let s=(e,n)=>{a.set(e,{catalog:n,compiled:t.compileCatalog(n)})};for(let[e,t]of i)typeof t!=`function`&&s(e,t);return{catalogMap(){return new Map([...a].map(([e,{compiled:t}])=>[e,t]))},isLoaded(e){return a.has(n.canonicalLocale(e))},load:async t=>{let r=n.canonicalLocale(t);if(a.has(r))return!1;let c=i.get(r);if(!c)throw new e.LinguaMissingCatalogError(`Catalog has no source for locale "${r}".`);if(typeof c!=`function`)return s(r,c),!0;let l=o.get(r);if(l)return await l,!1;let u=c().then(e=>{s(r,e),o.delete(r)},e=>{throw o.delete(r),e});return o.set(r,u),await u,!0},state(e){let t={};for(let[e,{catalog:n}]of a)t[e]=n;return{catalogs:t,locale:e,version:3}}}}exports.createCatalogStore=r;
+const e=require("./errors.cjs"),t=require("./_catalog.cjs"),n=require("./_locale.cjs");function r(r){let i=new Map,a=new Map,o=(e,r)=>{i.set(n.canonicalLocale(e),{catalog:r,compiled:t.compileCatalog(r)})};for(let[e,t]of Object.entries(r.catalogs??{}))o(e,t);return{catalogMap(){return new Map([...i].map(([e,{compiled:t}])=>[e,t]))},hydrate:o,isLoaded(e){return i.has(n.canonicalLocale(e))},load:async t=>{let s=n.canonicalLocale(t);if(i.has(s))return!1;let c=a.get(s);if(c)return await c,!1;if(!r.loadCatalog)throw new e.LinguaMissingCatalogError(`No catalog source provided for locale "${s}".`);let l=Promise.resolve(r.loadCatalog(s)).then(e=>{o(s,e),a.delete(s)},e=>{throw a.delete(s),e});return a.set(s,l),await l,!0},state(e){let t={};for(let[e,{catalog:n}]of i)t[e]=n;return{catalogs:t,locale:e,version:4}}}}exports.createCatalogStore=r;
 //# sourceMappingURL=_resources.cjs.map

package/dist/_resources.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_resources.cjs","names":[],"sources":["../src/_resources.ts"],"sourcesContent":["import { type CompiledCatalog, compileCatalog } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport { LinguaMissingCatalogError } from './errors';\nimport type { Catalog, CatalogSources, Catalogs, Locale, TranslationState } from './types';\n\n/** One catalog state machine owns static sources, lazy sources, and in-flight work. */\nexport function createCatalogStore<C extends Catalog>(sources: CatalogSources<C>) {\n  const definitions = new Map<Locale, C | (() => Promise<C>)>();\n  const loaded = new Map<Locale, { readonly catalog: C; readonly compiled: CompiledCatalog }>();\n  const tasks = new Map<Locale, Promise<void>>();\n\n  for (const [locale, source] of Object.entries(sources)) definitions.set(canonicalLocale(locale), source);\n\n  const add = (locale: Locale, catalog: C): void => {\n    loaded.set(locale, { catalog, compiled: compileCatalog(catalog) });\n  };\n\n  for (const [locale, source] of definitions) {\n    if (typeof source !== 'function') add(locale, source);\n  }\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 source = definitions.get(locale);\n\n    if (!source) throw new LinguaMissingCatalogError(`Catalog has no source for locale \"${locale}\".`);\n\n    if (typeof source !== 'function') {\n      add(locale, source);\n\n      return true;\n    }\n\n    const existing = tasks.get(locale);\n\n    if (existing) {\n      await existing;\n\n      return false;\n    }\n\n    const task = source().then(\n      (catalog) => {\n        add(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    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: 3 };\n    },\n  };\n}\n"],"mappings":"uFAMA,SAAgB,EAAsC,EAA4B,CAChF,IAAM,EAAc,IAAI,IAClB,EAAS,IAAI,IACb,EAAQ,IAAI,IAElB,IAAK,GAAM,CAAC,EAAQ,KAAW,OAAO,QAAQ,CAAO,EAAG,EAAY,IAAI,EAAA,gBAAgB,CAAM,EAAG,CAAM,EAEvG,IAAM,GAAO,EAAgB,IAAqB,CAChD,EAAO,IAAI,EAAQ,CAAE,UAAS,SAAU,EAAA,eAAe,CAAO,CAAE,CAAC,CACnE,EAEA,IAAK,GAAM,CAAC,EAAQ,KAAW,EACzB,OAAO,GAAW,YAAY,EAAI,EAAQ,CAAM,EA2CtD,MAAO,CACL,YAAmD,CACjD,OAAO,IAAI,IAAI,CAAC,GAAG,CAAM,CAAC,CAAC,KAAK,CAAC,EAAQ,CAAE,eAAgB,CAAC,EAAQ,CAAQ,CAAC,CAAC,CAChF,EACA,SAAS,EAAyB,CAChC,OAAO,EAAO,IAAI,EAAA,gBAAgB,CAAM,CAAC,CAC3C,EACA,UA/CkB,IAA8C,CAChE,IAAM,EAAS,EAAA,gBAAgB,CAAe,EAE9C,GAAI,EAAO,IAAI,CAAM,EAAG,MAAO,GAE/B,IAAM,EAAS,EAAY,IAAI,CAAM,EAErC,GAAI,CAAC,EAAQ,MAAM,IAAI,EAAA,0BAA0B,qCAAqC,EAAO,GAAG,EAEhG,GAAI,OAAO,GAAW,WAGpB,OAFA,EAAI,EAAQ,CAAM,EAEX,GAGT,IAAM,EAAW,EAAM,IAAI,CAAM,EAEjC,GAAI,EAGF,OAFA,MAAM,EAEC,GAGT,IAAM,EAAO,EAAO,CAAC,CAAC,KACnB,GAAY,CACX,EAAI,EAAQ,CAAO,EACnB,EAAM,OAAO,CAAM,CACrB,EACC,GAAmB,CAElB,MADA,EAAM,OAAO,CAAM,EACb,CACR,CACF,EAKA,OAHA,EAAM,IAAI,EAAQ,CAAI,EACtB,MAAM,EAEC,EACT,EAUE,MAAM,EAAqC,CACzC,IAAM,EAAwB,CAAC,EAE/B,IAAK,GAAM,CAAC,EAAc,CAAE,cAAc,EAAQ,EAAS,GAAgB,EAE3E,MAAO,CAAE,WAAU,SAAQ,QAAS,CAAE,CACxC,CACF,CACF"}
+{"version":3,"file":"_resources.cjs","names":[],"sources":["../src/_resources.ts"],"sourcesContent":["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: 4 };\n    },\n  };\n}\n"],"mappings":"uFAWA,SAAgB,EAAsC,EAAiC,CACrF,IAAM,EAAS,IAAI,IACb,EAAQ,IAAI,IAEZ,GAAW,EAAgB,IAAqB,CACpD,EAAO,IAAI,EAAA,gBAAgB,CAAM,EAAG,CAAE,UAAS,SAAU,EAAA,eAAe,CAAO,CAAE,CAAC,CACpF,EAEA,IAAK,GAAM,CAAC,EAAQ,KAAY,OAAO,QAAQ,EAAQ,UAAY,CAAC,CAAC,EAAG,EAAQ,EAAQ,CAAO,EAoC/F,MAAO,CACL,YAAmD,CACjD,OAAO,IAAI,IAAI,CAAC,GAAG,CAAM,CAAC,CAAC,KAAK,CAAC,EAAQ,CAAE,eAAgB,CAAC,EAAQ,CAAQ,CAAC,CAAC,CAChF,EACA,UACA,SAAS,EAAyB,CAChC,OAAO,EAAO,IAAI,EAAA,gBAAgB,CAAM,CAAC,CAC3C,EACA,UA1CkB,IAA8C,CAChE,IAAM,EAAS,EAAA,gBAAgB,CAAe,EAE9C,GAAI,EAAO,IAAI,CAAM,EAAG,MAAO,GAE/B,IAAM,EAAW,EAAM,IAAI,CAAM,EAEjC,GAAI,EAGF,OAFA,MAAM,EAEC,GAGT,GAAI,CAAC,EAAQ,YACX,MAAM,IAAI,EAAA,0BAA0B,0CAA0C,EAAO,GAAG,EAG1F,IAAM,EAAO,QAAQ,QAAQ,EAAQ,YAAY,CAAM,CAAC,CAAC,CAAC,KACvD,GAAY,CACX,EAAQ,EAAQ,CAAO,EACvB,EAAM,OAAO,CAAM,CACrB,EACC,GAAmB,CAElB,MADA,EAAM,OAAO,CAAM,EACb,CACR,CACF,EAKA,OAHA,EAAM,IAAI,EAAQ,CAAI,EACtB,MAAM,EAEC,EACT,EAWE,MAAM,EAAqC,CACzC,IAAM,EAAwB,CAAC,EAE/B,IAAK,GAAM,CAAC,EAAc,CAAE,cAAc,EAAQ,EAAS,GAAgB,EAE3E,MAAO,CAAE,WAAU,SAAQ,QAAS,CAAE,CACxC,CACF,CACF"}

package/dist/_resources.d.ts

@@ -1,10 +1,16 @@
 import { type CompiledCatalog } from './_catalog';
-import type { Catalog, CatalogSources, Locale, TranslationState } from './types';
-/** One catalog state machine owns static sources, lazy sources, and in-flight work. */
-export declare function createCatalogStore<C extends Catalog>(sources: CatalogSources<C>): {
+import type { Catalog, Catalogs, Locale, TranslationState } from './types';
+type CatalogStoreOptions<C extends Catalog> = {
+    readonly catalogs?: Catalogs<C>;
+    readonly loadCatalog?: (locale: Locale) => Promise<C> | C;
+};
+/** One catalog state machine owns loaded catalogs and in-flight loading work. */
+export declare function createCatalogStore<C extends Catalog>(options: CatalogStoreOptions<C>): {
     catalogMap(): ReadonlyMap<Locale, CompiledCatalog>;
+    hydrate: (locale: Locale, catalog: C) => void;
     isLoaded(locale: Locale): boolean;
     load: (requestedLocale: Locale) => Promise<boolean>;
     state(locale: Locale): TranslationState<C>;
 };
+export {};
 //# sourceMappingURL=_resources.d.ts.map

package/dist/_resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_resources.d.ts","sourceRoot":"","sources":["../src/_resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,YAAY,CAAC;AAGlE,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAY,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3F,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;kBAwD9D,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC;qBAGjC,MAAM,GAAG,OAAO;4BA5CE,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;kBAgD9C,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;EAQ7C"}
+{"version":3,"file":"_resources.d.ts","sourceRoot":"","sources":["../src/_resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,YAAY,CAAC;AAGlE,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3E,KAAK,mBAAmB,CAAC,CAAC,SAAS,OAAO,IAAI;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAC3D,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;kBA6CnE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC;sBAzC3B,MAAM,WAAW,CAAC,KAAG,IAAI;qBA6C/B,MAAM,GAAG,OAAO;4BAvCE,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;kBA2C9C,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;EAQ7C"}

package/dist/_resources.js

@@ -3,44 +3,41 @@ import { compileCatalog as t } from "./_catalog.js";
 import { canonicalLocale as n } from "./_locale.js";
 //#region src/_resources.ts
 function r(r) {
-	let i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map();
-	for (let [e, t] of Object.entries(r)) i.set(n(e), t);
-	let s = (e, n) => {
-		a.set(e, {
-			catalog: n,
-			compiled: t(n)
+	let i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o = (e, r) => {
+		i.set(n(e), {
+			catalog: r,
+			compiled: t(r)
 		});
 	};
-	for (let [e, t] of i) typeof t != "function" && s(e, t);
+	for (let [e, t] of Object.entries(r.catalogs ?? {})) o(e, t);
 	return {
 		catalogMap() {
-			return new Map([...a].map(([e, { compiled: t }]) => [e, t]));
+			return new Map([...i].map(([e, { compiled: t }]) => [e, t]));
 		},
+		hydrate: o,
 		isLoaded(e) {
-			return a.has(n(e));
+			return i.has(n(e));
 		},
 		load: async (t) => {
-			let r = n(t);
-			if (a.has(r)) return !1;
-			let c = i.get(r);
-			if (!c) throw new e(`Catalog has no source for locale "${r}".`);
-			if (typeof c != "function") return s(r, c), !0;
-			let l = o.get(r);
-			if (l) return await l, !1;
-			let u = c().then((e) => {
-				s(r, e), o.delete(r);
+			let s = n(t);
+			if (i.has(s)) return !1;
+			let c = a.get(s);
+			if (c) return await c, !1;
+			if (!r.loadCatalog) throw new e(`No catalog source provided for locale "${s}".`);
+			let l = Promise.resolve(r.loadCatalog(s)).then((e) => {
+				o(s, e), a.delete(s);
 			}, (e) => {
-				throw o.delete(r), e;
+				throw a.delete(s), e;
 			});
-			return o.set(r, u), await u, !0;
+			return a.set(s, l), await l, !0;
 		},
 		state(e) {
 			let t = {};
-			for (let [e, { catalog: n }] of a) t[e] = n;
+			for (let [e, { catalog: n }] of i) t[e] = n;
 			return {
 				catalogs: t,
 				locale: e,
-				version: 3
+				version: 4
 			};
 		}
 	};

package/dist/_resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"_resources.js","names":[],"sources":["../src/_resources.ts"],"sourcesContent":["import { type CompiledCatalog, compileCatalog } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport { LinguaMissingCatalogError } from './errors';\nimport type { Catalog, CatalogSources, Catalogs, Locale, TranslationState } from './types';\n\n/** One catalog state machine owns static sources, lazy sources, and in-flight work. */\nexport function createCatalogStore<C extends Catalog>(sources: CatalogSources<C>) {\n  const definitions = new Map<Locale, C | (() => Promise<C>)>();\n  const loaded = new Map<Locale, { readonly catalog: C; readonly compiled: CompiledCatalog }>();\n  const tasks = new Map<Locale, Promise<void>>();\n\n  for (const [locale, source] of Object.entries(sources)) definitions.set(canonicalLocale(locale), source);\n\n  const add = (locale: Locale, catalog: C): void => {\n    loaded.set(locale, { catalog, compiled: compileCatalog(catalog) });\n  };\n\n  for (const [locale, source] of definitions) {\n    if (typeof source !== 'function') add(locale, source);\n  }\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 source = definitions.get(locale);\n\n    if (!source) throw new LinguaMissingCatalogError(`Catalog has no source for locale \"${locale}\".`);\n\n    if (typeof source !== 'function') {\n      add(locale, source);\n\n      return true;\n    }\n\n    const existing = tasks.get(locale);\n\n    if (existing) {\n      await existing;\n\n      return false;\n    }\n\n    const task = source().then(\n      (catalog) => {\n        add(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    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: 3 };\n    },\n  };\n}\n"],"mappings":";;;;AAMA,SAAgB,EAAsC,GAA4B;CAChF,IAAM,oBAAc,IAAI,IAAoC,GACtD,oBAAS,IAAI,IAAyE,GACtF,oBAAQ,IAAI,IAA2B;CAE7C,KAAK,IAAM,CAAC,GAAQ,MAAW,OAAO,QAAQ,CAAO,GAAG,EAAY,IAAI,EAAgB,CAAM,GAAG,CAAM;CAEvG,IAAM,KAAO,GAAgB,MAAqB;EAChD,EAAO,IAAI,GAAQ;GAAE;GAAS,UAAU,EAAe,CAAO;EAAE,CAAC;CACnE;CAEA,KAAK,IAAM,CAAC,GAAQ,MAAW,GAC7B,AAAI,OAAO,KAAW,cAAY,EAAI,GAAQ,CAAM;CA2CtD,OAAO;EACL,aAAmD;GACjD,OAAO,IAAI,IAAI,CAAC,GAAG,CAAM,CAAC,CAAC,KAAK,CAAC,GAAQ,EAAE,mBAAgB,CAAC,GAAQ,CAAQ,CAAC,CAAC;EAChF;EACA,SAAS,GAAyB;GAChC,OAAO,EAAO,IAAI,EAAgB,CAAM,CAAC;EAC3C;EACA,aA/CkB,MAA8C;GAChE,IAAM,IAAS,EAAgB,CAAe;GAE9C,IAAI,EAAO,IAAI,CAAM,GAAG,OAAO;GAE/B,IAAM,IAAS,EAAY,IAAI,CAAM;GAErC,IAAI,CAAC,GAAQ,MAAM,IAAI,EAA0B,qCAAqC,EAAO,GAAG;GAEhG,IAAI,OAAO,KAAW,YAGpB,OAFA,EAAI,GAAQ,CAAM,GAEX;GAGT,IAAM,IAAW,EAAM,IAAI,CAAM;GAEjC,IAAI,GAGF,OAFA,MAAM,GAEC;GAGT,IAAM,IAAO,EAAO,CAAC,CAAC,MACnB,MAAY;IAEX,AADA,EAAI,GAAQ,CAAO,GACnB,EAAM,OAAO,CAAM;GACrB,IACC,MAAmB;IAElB,MADA,EAAM,OAAO,CAAM,GACb;GACR,CACF;GAKA,OAHA,EAAM,IAAI,GAAQ,CAAI,GACtB,MAAM,GAEC;EACT;EAUE,MAAM,GAAqC;GACzC,IAAM,IAAwB,CAAC;GAE/B,KAAK,IAAM,CAAC,GAAc,EAAE,iBAAc,GAAQ,EAAS,KAAgB;GAE3E,OAAO;IAAE;IAAU;IAAQ,SAAS;GAAE;EACxC;CACF;AACF"}
+{"version":3,"file":"_resources.js","names":[],"sources":["../src/_resources.ts"],"sourcesContent":["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: 4 };\n    },\n  };\n}\n"],"mappings":";;;;AAWA,SAAgB,EAAsC,GAAiC;CACrF,IAAM,oBAAS,IAAI,IAAyE,GACtF,oBAAQ,IAAI,IAA2B,GAEvC,KAAW,GAAgB,MAAqB;EACpD,EAAO,IAAI,EAAgB,CAAM,GAAG;GAAE;GAAS,UAAU,EAAe,CAAO;EAAE,CAAC;CACpF;CAEA,KAAK,IAAM,CAAC,GAAQ,MAAY,OAAO,QAAQ,EAAQ,YAAY,CAAC,CAAC,GAAG,EAAQ,GAAQ,CAAO;CAoC/F,OAAO;EACL,aAAmD;GACjD,OAAO,IAAI,IAAI,CAAC,GAAG,CAAM,CAAC,CAAC,KAAK,CAAC,GAAQ,EAAE,mBAAgB,CAAC,GAAQ,CAAQ,CAAC,CAAC;EAChF;EACA;EACA,SAAS,GAAyB;GAChC,OAAO,EAAO,IAAI,EAAgB,CAAM,CAAC;EAC3C;EACA,aA1CkB,MAA8C;GAChE,IAAM,IAAS,EAAgB,CAAe;GAE9C,IAAI,EAAO,IAAI,CAAM,GAAG,OAAO;GAE/B,IAAM,IAAW,EAAM,IAAI,CAAM;GAEjC,IAAI,GAGF,OAFA,MAAM,GAEC;GAGT,IAAI,CAAC,EAAQ,aACX,MAAM,IAAI,EAA0B,0CAA0C,EAAO,GAAG;GAG1F,IAAM,IAAO,QAAQ,QAAQ,EAAQ,YAAY,CAAM,CAAC,CAAC,CAAC,MACvD,MAAY;IAEX,AADA,EAAQ,GAAQ,CAAO,GACvB,EAAM,OAAO,CAAM;GACrB,IACC,MAAmB;IAElB,MADA,EAAM,OAAO,CAAM,GACb;GACR,CACF;GAKA,OAHA,EAAM,IAAI,GAAQ,CAAI,GACtB,MAAM,GAEC;EACT;EAWE,MAAM,GAAqC;GACzC,IAAM,IAAwB,CAAC;GAE/B,KAAK,IAAM,CAAC,GAAc,EAAE,iBAAc,GAAQ,EAAS,KAAgB;GAE3E,OAAO;IAAE;IAAU;IAAQ,SAAS;GAAE;EACxC;CACF;AACF"}

package/dist/_template.cjs

@@ -1,2 +1,2 @@
-var e=/\{([\p{ID_Continue}-]+)\}/gu;function t(t){let n=[],r=0;for(let i of t.matchAll(e)){let e=i.index??0;e>r&&n.push(t.slice(r,e)),n.push({value:i[1]}),r=e+i[0].length}return r<t.length&&n.push(t.slice(r)),n}function n(e,t,n){return e.map(e=>{if(typeof e==`string`)return e;let r=Object.hasOwn(t,e.value)?t[e.value]:void 0;return r==null?n(e.value):String(r)}).join(``)}function r(e,t,n){let r=[];for(let i of e){if(typeof i==`string`){i!==``&&r.push(i);continue}r.push(Object.hasOwn(t,i.value)?t[i.value]:n(i.value))}return r}exports.compileTemplate=t,exports.renderSegments=r,exports.renderText=n;
+var e=/\{([\p{ID_Continue}-]+)\}/gu;function t(t){let n=[],r=0;for(let i of t.matchAll(e)){let e=i.index??0;e>r&&n.push(t.slice(r,e)),n.push({value:i[1]}),r=e+i[0].length}return r<t.length&&n.push(t.slice(r)),n}function n(e,t,n){return e.map(e=>{if(typeof e==`string`)return e;let r=Object.hasOwn(t,e.value)?t[e.value]:void 0;return r==null?n(e.value):String(r)}).join(``)}function r(e,t,n){let r=[];for(let i of e){if(typeof i==`string`){i!==``&&r.push({type:`text`,value:i});continue}Object.hasOwn(t,i.value)?r.push({type:`value`,value:t[i.value]}):r.push({type:`text`,value:n(i.value)})}return r}exports.compileTemplate=t,exports.renderParts=r,exports.renderText=n;
 //# sourceMappingURL=_template.cjs.map

package/dist/_template.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_template.cjs","names":[],"sources":["../src/_template.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\nexport function renderSegments<V>(\n  parts: Template,\n  values: Record<string, V | number>,\n  missing: (name: string) => string,\n): Array<string | number | V> {\n  const result: Array<string | number | V> = [];\n\n  for (const part of parts) {\n    if (typeof part === 'string') {\n      if (part !== '') result.push(part);\n\n      continue;\n    }\n\n    result.push(Object.hasOwn(values, part.value) ? values[part.value]! : missing(part.value));\n  }\n\n  return result;\n}\n"],"mappings":"AAGA,IAAM,EAAgB,8BAEtB,SAAgB,EAAgB,EAAyB,CACvD,IAAM,EAAwB,CAAC,EAC3B,EAAS,EAEb,IAAK,IAAM,KAAS,EAAM,SAAS,CAAa,EAAG,CACjD,IAAM,EAAQ,EAAM,OAAS,EAEzB,EAAQ,GAAQ,EAAM,KAAK,EAAM,MAAM,EAAQ,CAAK,CAAC,EAEzD,EAAM,KAAK,CAAE,MAAO,EAAM,EAAG,CAAC,EAC9B,EAAS,EAAQ,EAAM,EAAE,CAAC,MAC5B,CAIA,OAFI,EAAS,EAAM,QAAQ,EAAM,KAAK,EAAM,MAAM,CAAM,CAAC,EAElD,CACT,CAEA,SAAgB,EACd,EACA,EACA,EACQ,CACR,OAAO,EACJ,IAAK,GAAS,CACb,GAAI,OAAO,GAAS,SAAU,OAAO,EAErC,IAAM,EAAQ,OAAO,OAAO,EAAQ,EAAK,KAAK,EAAI,EAAO,EAAK,OAAS,IAAA,GAEvE,OAAO,GAAS,KAAO,EAAQ,EAAK,KAAK,EAAI,OAAO,CAAK,CAC3D,CAAC,CAAC,CACD,KAAK,EAAE,CACZ,CAEA,SAAgB,EACd,EACA,EACA,EAC4B,CAC5B,IAAM,EAAqC,CAAC,EAE5C,IAAK,IAAM,KAAQ,EAAO,CACxB,GAAI,OAAO,GAAS,SAAU,CACxB,IAAS,IAAI,EAAO,KAAK,CAAI,EAEjC,QACF,CAEA,EAAO,KAAK,OAAO,OAAO,EAAQ,EAAK,KAAK,EAAI,EAAO,EAAK,OAAU,EAAQ,EAAK,KAAK,CAAC,CAC3F,CAEA,OAAO,CACT"}
+{"version":3,"file":"_template.cjs","names":[],"sources":["../src/_template.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"],"mappings":"AAKA,IAAM,EAAgB,8BAEtB,SAAgB,EAAgB,EAAyB,CACvD,IAAM,EAAwB,CAAC,EAC3B,EAAS,EAEb,IAAK,IAAM,KAAS,EAAM,SAAS,CAAa,EAAG,CACjD,IAAM,EAAQ,EAAM,OAAS,EAEzB,EAAQ,GAAQ,EAAM,KAAK,EAAM,MAAM,EAAQ,CAAK,CAAC,EAEzD,EAAM,KAAK,CAAE,MAAO,EAAM,EAAG,CAAC,EAC9B,EAAS,EAAQ,EAAM,EAAE,CAAC,MAC5B,CAIA,OAFI,EAAS,EAAM,QAAQ,EAAM,KAAK,EAAM,MAAM,CAAM,CAAC,EAElD,CACT,CAEA,SAAgB,EACd,EACA,EACA,EACQ,CACR,OAAO,EACJ,IAAK,GAAS,CACb,GAAI,OAAO,GAAS,SAAU,OAAO,EAErC,IAAM,EAAQ,OAAO,OAAO,EAAQ,EAAK,KAAK,EAAI,EAAO,EAAK,OAAS,IAAA,GAEvE,OAAO,GAAS,KAAO,EAAQ,EAAK,KAAK,EAAI,OAAO,CAAK,CAC3D,CAAC,CAAC,CACD,KAAK,EAAE,CACZ,CAEA,SAAgB,EACd,EACA,EACA,EACyB,CACzB,IAAM,EAAkC,CAAC,EAEzC,IAAK,IAAM,KAAQ,EAAO,CACxB,GAAI,OAAO,GAAS,SAAU,CACxB,IAAS,IAAI,EAAO,KAAK,CAAE,KAAM,OAAQ,MAAO,CAAK,CAAC,EAE1D,QACF,CAEI,OAAO,OAAO,EAAQ,EAAK,KAAK,EAClC,EAAO,KAAK,CAAE,KAAM,QAAS,MAAO,EAAO,EAAK,MAAsB,CAAC,EAEvE,EAAO,KAAK,CAAE,KAAM,OAAQ,MAAO,EAAQ,EAAK,KAAK,CAAE,CAAC,CAE5D,CAEA,OAAO,CACT"}

package/dist/_template.d.ts

@@ -1,8 +1,9 @@
+import type { Part } from './types';
 export type TemplatePart = string | {
     readonly value: string;
 };
 export type Template = readonly TemplatePart[];
 export declare function compileTemplate(value: string): Template;
 export declare function renderText(parts: Template, values: Record<string, unknown>, missing: (name: string) => string): string;
-export declare function renderSegments<V>(parts: Template, values: Record<string, V | number>, missing: (name: string) => string): Array<string | number | V>;
+export declare function renderParts<V>(parts: Template, values: Record<string, V | number>, missing: (name: string) => string): Array<Part<V | number>>;
 //# sourceMappingURL=_template.d.ts.map

package/dist/_template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_template.d.ts","sourceRoot":"","sources":["../src/_template.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,MAAM,MAAM,QAAQ,GAAG,SAAS,YAAY,EAAE,CAAC;AAI/C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAgBvD;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAUR;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAClC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAc5B"}
+{"version":3,"file":"_template.d.ts","sourceRoot":"","sources":["../src/_template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,MAAM,MAAM,QAAQ,GAAG,SAAS,YAAY,EAAE,CAAC;AAI/C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAgBvD;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAUR;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAClC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAkBzB"}

package/dist/_template.js

@@ -19,14 +19,23 @@ function r(e, t, n) {
 	let r = [];
 	for (let i of e) {
 		if (typeof i == "string") {
-			i !== "" && r.push(i);
+			i !== "" && r.push({
+				type: "text",
+				value: i
+			});
 			continue;
 		}
-		r.push(Object.hasOwn(t, i.value) ? t[i.value] : n(i.value));
+		Object.hasOwn(t, i.value) ? r.push({
+			type: "value",
+			value: t[i.value]
+		}) : r.push({
+			type: "text",
+			value: n(i.value)
+		});
 	}
 	return r;
 }
 //#endregion
-export { t as compileTemplate, r as renderSegments, n as renderText };
+export { t as compileTemplate, r as renderParts, n as renderText };
 
 //# sourceMappingURL=_template.js.map

package/dist/_template.js.map

@@ -1 +1 @@
-{"version":3,"file":"_template.js","names":[],"sources":["../src/_template.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\nexport function renderSegments<V>(\n  parts: Template,\n  values: Record<string, V | number>,\n  missing: (name: string) => string,\n): Array<string | number | V> {\n  const result: Array<string | number | V> = [];\n\n  for (const part of parts) {\n    if (typeof part === 'string') {\n      if (part !== '') result.push(part);\n\n      continue;\n    }\n\n    result.push(Object.hasOwn(values, part.value) ? values[part.value]! : missing(part.value));\n  }\n\n  return result;\n}\n"],"mappings":";AAGA,IAAM,IAAgB;AAEtB,SAAgB,EAAgB,GAAyB;CACvD,IAAM,IAAwB,CAAC,GAC3B,IAAS;CAEb,KAAK,IAAM,KAAS,EAAM,SAAS,CAAa,GAAG;EACjD,IAAM,IAAQ,EAAM,SAAS;EAK7B,AAHI,IAAQ,KAAQ,EAAM,KAAK,EAAM,MAAM,GAAQ,CAAK,CAAC,GAEzD,EAAM,KAAK,EAAE,OAAO,EAAM,GAAG,CAAC,GAC9B,IAAS,IAAQ,EAAM,EAAE,CAAC;CAC5B;CAIA,OAFI,IAAS,EAAM,UAAQ,EAAM,KAAK,EAAM,MAAM,CAAM,CAAC,GAElD;AACT;AAEA,SAAgB,EACd,GACA,GACA,GACQ;CACR,OAAO,EACJ,KAAK,MAAS;EACb,IAAI,OAAO,KAAS,UAAU,OAAO;EAErC,IAAM,IAAQ,OAAO,OAAO,GAAQ,EAAK,KAAK,IAAI,EAAO,EAAK,SAAS,KAAA;EAEvE,OAAO,KAAS,OAAO,EAAQ,EAAK,KAAK,IAAI,OAAO,CAAK;CAC3D,CAAC,CAAC,CACD,KAAK,EAAE;AACZ;AAEA,SAAgB,EACd,GACA,GACA,GAC4B;CAC5B,IAAM,IAAqC,CAAC;CAE5C,KAAK,IAAM,KAAQ,GAAO;EACxB,IAAI,OAAO,KAAS,UAAU;GAC5B,AAAI,MAAS,MAAI,EAAO,KAAK,CAAI;GAEjC;EACF;EAEA,EAAO,KAAK,OAAO,OAAO,GAAQ,EAAK,KAAK,IAAI,EAAO,EAAK,SAAU,EAAQ,EAAK,KAAK,CAAC;CAC3F;CAEA,OAAO;AACT"}
+{"version":3,"file":"_template.js","names":[],"sources":["../src/_template.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"],"mappings":";AAKA,IAAM,IAAgB;AAEtB,SAAgB,EAAgB,GAAyB;CACvD,IAAM,IAAwB,CAAC,GAC3B,IAAS;CAEb,KAAK,IAAM,KAAS,EAAM,SAAS,CAAa,GAAG;EACjD,IAAM,IAAQ,EAAM,SAAS;EAK7B,AAHI,IAAQ,KAAQ,EAAM,KAAK,EAAM,MAAM,GAAQ,CAAK,CAAC,GAEzD,EAAM,KAAK,EAAE,OAAO,EAAM,GAAG,CAAC,GAC9B,IAAS,IAAQ,EAAM,EAAE,CAAC;CAC5B;CAIA,OAFI,IAAS,EAAM,UAAQ,EAAM,KAAK,EAAM,MAAM,CAAM,CAAC,GAElD;AACT;AAEA,SAAgB,EACd,GACA,GACA,GACQ;CACR,OAAO,EACJ,KAAK,MAAS;EACb,IAAI,OAAO,KAAS,UAAU,OAAO;EAErC,IAAM,IAAQ,OAAO,OAAO,GAAQ,EAAK,KAAK,IAAI,EAAO,EAAK,SAAS,KAAA;EAEvE,OAAO,KAAS,OAAO,EAAQ,EAAK,KAAK,IAAI,OAAO,CAAK;CAC3D,CAAC,CAAC,CACD,KAAK,EAAE;AACZ;AAEA,SAAgB,EACd,GACA,GACA,GACyB;CACzB,IAAM,IAAkC,CAAC;CAEzC,KAAK,IAAM,KAAQ,GAAO;EACxB,IAAI,OAAO,KAAS,UAAU;GAC5B,AAAI,MAAS,MAAI,EAAO,KAAK;IAAE,MAAM;IAAQ,OAAO;GAAK,CAAC;GAE1D;EACF;EAEA,AAAI,OAAO,OAAO,GAAQ,EAAK,KAAK,IAClC,EAAO,KAAK;GAAE,MAAM;GAAS,OAAO,EAAO,EAAK;EAAsB,CAAC,IAEvE,EAAO,KAAK;GAAE,MAAM;GAAQ,OAAO,EAAQ,EAAK,KAAK;EAAE,CAAC;CAE5D;CAEA,OAAO;AACT"}

package/dist/catalog.cjs

@@ -1,2 +1,2 @@
-const e=require("./_catalog.cjs");function t(t){let n=typeof t==`object`&&t&&`serialize`in t&&`getSnapshot`in t?t.serialize().catalogs[t.locale]:t;return[...e.compileCatalog(n).keys()]}exports.catalogKeys=t;
+const e=require("./errors.cjs"),t=require("./_catalog.cjs");function n(n){if(typeof n==`object`&&n&&`serialize`in n&&`getSnapshot`in n){let r=n,i=r.serialize().catalogs[r.locale];if(!i)throw new e.LinguaMissingCatalogError(`No catalog loaded for locale "${r.locale}".`);return[...t.compileCatalog(i).keys()]}return[...t.compileCatalog(n).keys()]}exports.catalogKeys=n;
 //# sourceMappingURL=catalog.cjs.map

package/dist/catalog.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.cjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import { compileCatalog } from './_catalog';\nimport type { TranslationStore } from './i18n';\nimport type { Catalog, TextKey } 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 `TextKey<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 a `TranslationStore` to enumerate keys from its current locale catalog\n *  without specifying a locale explicitly.\n *\n *  @example\n *  ```ts\n *  const messages = {\n *    nav: { home: '...', settings: '...' },\n *  };\n *  const keys = catalogKeys(messages); // ['nav.home', 'nav.settings']\n *\n *  // From a translation store — uses current locale's catalog\n *  const i18n = createTranslationStore({ catalogs: { en: messages }, locale: 'en' });\n *  const allKeys = catalogKeys(i18n);\n *  ```\n */\nexport function catalogKeys<C extends Catalog>(store: TranslationStore<C>): ReadonlyArray<TextKey<C>>;\nexport function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<TextKey<C>>;\nexport function catalogKeys(source: unknown): ReadonlyArray<TextKey<Catalog>> {\n  const catalog =\n    typeof source === 'object' && source !== null && 'serialize' in source && 'getSnapshot' in source\n      ? (source as TranslationStore).serialize().catalogs[(source as TranslationStore).locale]\n      : (source as Catalog);\n\n  return [...compileCatalog(catalog).keys()] as unknown as ReadonlyArray<TextKey<Catalog>>;\n}\n"],"mappings":"kCA4BA,SAAgB,EAAY,EAAkD,CAC5E,IAAM,EACJ,OAAO,GAAW,UAAY,GAAmB,cAAe,GAAU,gBAAiB,EACtF,EAA4B,UAAU,CAAC,CAAC,SAAU,EAA4B,QAC9E,EAEP,MAAO,CAAC,GAAG,EAAA,eAAe,CAAO,CAAC,CAAC,KAAK,CAAC,CAC3C"}
+{"version":3,"file":"catalog.cjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import { compileCatalog } from './_catalog';\nimport { LinguaMissingCatalogError } from './errors';\nimport type { I18n } from './i18n';\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 an `I18n` instance to enumerate keys from its current locale catalog\n *  without specifying a locale explicitly.\n *\n *  @example\n *  ```ts\n *  const messages = {\n *    nav: { home: '...', settings: '...' },\n *  };\n *  const keys = catalogKeys(messages); // ['nav.home', 'nav.settings']\n *\n *  // From an i18n instance — uses current locale's catalog\n *  const i18n = createI18n({ catalogs: { en: messages }, locale: 'en' });\n *  const allKeys = catalogKeys(i18n);\n *  ```\n */\nexport function catalogKeys<C extends Catalog>(i18n: I18n<C>): ReadonlyArray<MessageKey<C>>;\nexport function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<MessageKey<C>>;\nexport function catalogKeys(source: unknown): ReadonlyArray<MessageKey<Catalog>> {\n  if (typeof source === 'object' && source !== null && 'serialize' in source && 'getSnapshot' in source) {\n    const i18n = source as I18n;\n    const catalog = i18n.serialize().catalogs[i18n.locale];\n\n    if (!catalog) throw new LinguaMissingCatalogError(`No catalog loaded for locale \"${i18n.locale}\".`);\n\n    return [...compileCatalog(catalog).keys()] as unknown as ReadonlyArray<MessageKey<Catalog>>;\n  }\n\n  return [...compileCatalog(source as Catalog).keys()] as unknown as ReadonlyArray<MessageKey<Catalog>>;\n}\n"],"mappings":"4DA6BA,SAAgB,EAAY,EAAqD,CAC/E,GAAI,OAAO,GAAW,UAAY,GAAmB,cAAe,GAAU,gBAAiB,EAAQ,CACrG,IAAM,EAAO,EACP,EAAU,EAAK,UAAU,CAAC,CAAC,SAAS,EAAK,QAE/C,GAAI,CAAC,EAAS,MAAM,IAAI,EAAA,0BAA0B,iCAAiC,EAAK,OAAO,GAAG,EAElG,MAAO,CAAC,GAAG,EAAA,eAAe,CAAO,CAAC,CAAC,KAAK,CAAC,CAC3C,CAEA,MAAO,CAAC,GAAG,EAAA,eAAe,CAAiB,CAAC,CAAC,KAAK,CAAC,CACrD"}

package/dist/catalog.d.ts

@@ -1,13 +1,13 @@
-import type { TranslationStore } from './i18n';
-import type { Catalog, TextKey } from './types';
+import type { I18n } from './i18n';
+import type { Catalog, MessageKey } from './types';
 /** Enumerate every message key in a catalog as a dotted path.
  *
  *  Traverses nested grouping objects and explicit `{ plural: ... }` messages,
- *  producing the same dotted paths that `TextKey<C>` represents at the type
+ *  producing the same dotted paths that `MessageKey<C>` represents at the type
  *  level. Use this to derive key arrays from the catalog itself instead of
  *  maintaining a parallel list that can go stale.
  *
- *  Pass a `TranslationStore` to enumerate keys from its current locale catalog
+ *  Pass an `I18n` instance to enumerate keys from its current locale catalog
  *  without specifying a locale explicitly.
  *
  *  @example
@@ -17,11 +17,11 @@ import type { Catalog, TextKey } from './types';
  *  };
  *  const keys = catalogKeys(messages); // ['nav.home', 'nav.settings']
  *
- *  // From a translation store — uses current locale's catalog
- *  const i18n = createTranslationStore({ catalogs: { en: messages }, locale: 'en' });
+ *  // From an i18n instance — uses current locale's catalog
+ *  const i18n = createI18n({ catalogs: { en: messages }, locale: 'en' });
  *  const allKeys = catalogKeys(i18n);
  *  ```
  */
-export declare function catalogKeys<C extends Catalog>(store: TranslationStore<C>): ReadonlyArray<TextKey<C>>;
-export declare function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<TextKey<C>>;
+export declare function catalogKeys<C extends Catalog>(i18n: I18n<C>): ReadonlyArray<MessageKey<C>>;
+export declare function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<MessageKey<C>>;
 //# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACtG,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5F,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/catalog.js

@@ -1,10 +1,15 @@
-import { compileCatalog as e } from "./_catalog.js";
+import { LinguaMissingCatalogError as e } from "./errors.js";
+import { compileCatalog as t } from "./_catalog.js";
 //#region src/catalog.ts
-function t(t) {
-	let n = typeof t == "object" && t && "serialize" in t && "getSnapshot" in t ? t.serialize().catalogs[t.locale] : t;
-	return [...e(n).keys()];
+function n(n) {
+	if (typeof n == "object" && n && "serialize" in n && "getSnapshot" in n) {
+		let r = n, i = r.serialize().catalogs[r.locale];
+		if (!i) throw new e(`No catalog loaded for locale "${r.locale}".`);
+		return [...t(i).keys()];
+	}
+	return [...t(n).keys()];
 }
 //#endregion
-export { t as catalogKeys };
+export { n as catalogKeys };
 
 //# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import { compileCatalog } from './_catalog';\nimport type { TranslationStore } from './i18n';\nimport type { Catalog, TextKey } 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 `TextKey<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 a `TranslationStore` to enumerate keys from its current locale catalog\n *  without specifying a locale explicitly.\n *\n *  @example\n *  ```ts\n *  const messages = {\n *    nav: { home: '...', settings: '...' },\n *  };\n *  const keys = catalogKeys(messages); // ['nav.home', 'nav.settings']\n *\n *  // From a translation store — uses current locale's catalog\n *  const i18n = createTranslationStore({ catalogs: { en: messages }, locale: 'en' });\n *  const allKeys = catalogKeys(i18n);\n *  ```\n */\nexport function catalogKeys<C extends Catalog>(store: TranslationStore<C>): ReadonlyArray<TextKey<C>>;\nexport function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<TextKey<C>>;\nexport function catalogKeys(source: unknown): ReadonlyArray<TextKey<Catalog>> {\n  const catalog =\n    typeof source === 'object' && source !== null && 'serialize' in source && 'getSnapshot' in source\n      ? (source as TranslationStore).serialize().catalogs[(source as TranslationStore).locale]\n      : (source as Catalog);\n\n  return [...compileCatalog(catalog).keys()] as unknown as ReadonlyArray<TextKey<Catalog>>;\n}\n"],"mappings":";;AA4BA,SAAgB,EAAY,GAAkD;CAC5E,IAAM,IACJ,OAAO,KAAW,YAAY,KAAmB,eAAe,KAAU,iBAAiB,IACtF,EAA4B,UAAU,CAAC,CAAC,SAAU,EAA4B,UAC9E;CAEP,OAAO,CAAC,GAAG,EAAe,CAAO,CAAC,CAAC,KAAK,CAAC;AAC3C"}
+{"version":3,"file":"catalog.js","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["import { compileCatalog } from './_catalog';\nimport { LinguaMissingCatalogError } from './errors';\nimport type { I18n } from './i18n';\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 an `I18n` instance to enumerate keys from its current locale catalog\n *  without specifying a locale explicitly.\n *\n *  @example\n *  ```ts\n *  const messages = {\n *    nav: { home: '...', settings: '...' },\n *  };\n *  const keys = catalogKeys(messages); // ['nav.home', 'nav.settings']\n *\n *  // From an i18n instance — uses current locale's catalog\n *  const i18n = createI18n({ catalogs: { en: messages }, locale: 'en' });\n *  const allKeys = catalogKeys(i18n);\n *  ```\n */\nexport function catalogKeys<C extends Catalog>(i18n: I18n<C>): ReadonlyArray<MessageKey<C>>;\nexport function catalogKeys<C extends Catalog>(catalog: C): ReadonlyArray<MessageKey<C>>;\nexport function catalogKeys(source: unknown): ReadonlyArray<MessageKey<Catalog>> {\n  if (typeof source === 'object' && source !== null && 'serialize' in source && 'getSnapshot' in source) {\n    const i18n = source as I18n;\n    const catalog = i18n.serialize().catalogs[i18n.locale];\n\n    if (!catalog) throw new LinguaMissingCatalogError(`No catalog loaded for locale \"${i18n.locale}\".`);\n\n    return [...compileCatalog(catalog).keys()] as unknown as ReadonlyArray<MessageKey<Catalog>>;\n  }\n\n  return [...compileCatalog(source as Catalog).keys()] as unknown as ReadonlyArray<MessageKey<Catalog>>;\n}\n"],"mappings":";;;AA6BA,SAAgB,EAAY,GAAqD;CAC/E,IAAI,OAAO,KAAW,YAAY,KAAmB,eAAe,KAAU,iBAAiB,GAAQ;EACrG,IAAM,IAAO,GACP,IAAU,EAAK,UAAU,CAAC,CAAC,SAAS,EAAK;EAE/C,IAAI,CAAC,GAAS,MAAM,IAAI,EAA0B,iCAAiC,EAAK,OAAO,GAAG;EAElG,OAAO,CAAC,GAAG,EAAe,CAAO,CAAC,CAAC,KAAK,CAAC;CAC3C;CAEA,OAAO,CAAC,GAAG,EAAe,CAAiB,CAAC,CAAC,KAAK,CAAC;AACrD"}

package/dist/errors.cjs

@@ -1,2 +1,2 @@
-var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{constructor(){super(`Operation called on a disposed translation store.`)}},n=class extends e{},r=class extends e{},i=class extends e{},a=class extends e{},o=class extends e{};exports.LinguaDisposedError=t,exports.LinguaError=e,exports.LinguaInvalidCatalogError=n,exports.LinguaInvalidLocaleError=r,exports.LinguaInvalidPluralCountError=i,exports.LinguaInvalidStateError=a,exports.LinguaMissingCatalogError=o;
+var e=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},t=class extends e{constructor(){super(`Operation called on a disposed i18n instance.`)}},n=class extends e{},r=class extends e{},i=class extends e{},a=class extends e{},o=class extends e{},s=class extends e{},c=class extends e{};exports.LinguaDisposedError=t,exports.LinguaError=e,exports.LinguaInvalidCatalogError=n,exports.LinguaInvalidLocaleError=r,exports.LinguaInvalidPluralCountError=i,exports.LinguaInvalidStateError=a,exports.LinguaMissingCatalogError=o,exports.LinguaMissingKeyError=s,exports.LinguaMissingValueError=c;
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["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 translation store.');\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 {}\n"],"mappings":"AAAA,IAAa,EAAb,cAAiC,KAAM,CACrC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,EAAb,cAAyC,CAAY,CACnD,aAAc,CACZ,MAAM,mDAAmD,CAC3D,CACF,EAEa,EAAb,cAA+C,CAAY,CAAC,EAC/C,EAAb,cAA8C,CAAY,CAAC,EAC9C,EAAb,cAAmD,CAAY,CAAC,EACnD,EAAb,cAA6C,CAAY,CAAC,EAC7C,EAAb,cAA+C,CAAY,CAAC"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["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"],"mappings":"AAAA,IAAa,EAAb,cAAiC,KAAM,CACrC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,EAAb,cAAyC,CAAY,CACnD,aAAc,CACZ,MAAM,+CAA+C,CACvD,CACF,EAEa,EAAb,cAA+C,CAAY,CAAC,EAC/C,EAAb,cAA8C,CAAY,CAAC,EAC9C,EAAb,cAAmD,CAAY,CAAC,EACnD,EAAb,cAA6C,CAAY,CAAC,EAC7C,EAAb,cAA+C,CAAY,CAAC,EAC/C,EAAb,cAA2C,CAAY,CAAC,EAC3C,EAAb,cAA6C,CAAY,CAAC"}

package/dist/errors.d.ts

@@ -14,4 +14,8 @@ export declare class LinguaInvalidStateError extends LinguaError {
 }
 export declare class LinguaMissingCatalogError extends LinguaError {
 }
+export declare class LinguaMissingKeyError extends LinguaError {
+}
+export declare class LinguaMissingValueError extends LinguaError {
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAKjD;AAED,qBAAa,mBAAoB,SAAQ,WAAW;;CAInD;AAED,qBAAa,yBAA0B,SAAQ,WAAW;CAAG;AAC7D,qBAAa,wBAAyB,SAAQ,WAAW;CAAG;AAC5D,qBAAa,6BAA8B,SAAQ,WAAW;CAAG;AACjE,qBAAa,uBAAwB,SAAQ,WAAW;CAAG;AAC3D,qBAAa,yBAA0B,SAAQ,WAAW;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAKjD;AAED,qBAAa,mBAAoB,SAAQ,WAAW;;CAInD;AAED,qBAAa,yBAA0B,SAAQ,WAAW;CAAG;AAC7D,qBAAa,wBAAyB,SAAQ,WAAW;CAAG;AAC5D,qBAAa,6BAA8B,SAAQ,WAAW;CAAG;AACjE,qBAAa,uBAAwB,SAAQ,WAAW;CAAG;AAC3D,qBAAa,yBAA0B,SAAQ,WAAW;CAAG;AAC7D,qBAAa,qBAAsB,SAAQ,WAAW;CAAG;AACzD,qBAAa,uBAAwB,SAAQ,WAAW;CAAG"}

package/dist/errors.js

@@ -5,10 +5,10 @@ var e = class extends Error {
 	}
 }, t = class extends e {
 	constructor() {
-		super("Operation called on a disposed translation store.");
+		super("Operation called on a disposed i18n instance.");
 	}
-}, n = class extends e {}, r = class extends e {}, i = class extends e {}, a = class extends e {}, o = class extends e {};
+}, n = class extends e {}, r = class extends e {}, i = class extends e {}, a = class extends e {}, o = class extends e {}, s = class extends e {}, c = class extends e {};
 //#endregion
-export { t as LinguaDisposedError, e as LinguaError, n as LinguaInvalidCatalogError, r as LinguaInvalidLocaleError, i as LinguaInvalidPluralCountError, a as LinguaInvalidStateError, o as LinguaMissingCatalogError };
+export { t as LinguaDisposedError, e as LinguaError, n as LinguaInvalidCatalogError, r as LinguaInvalidLocaleError, i as LinguaInvalidPluralCountError, a as LinguaInvalidStateError, o as LinguaMissingCatalogError, s as LinguaMissingKeyError, c as LinguaMissingValueError };
 
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["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 translation store.');\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 {}\n"],"mappings":";AAAA,IAAa,IAAb,cAAiC,MAAM;CACrC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAEa,IAAb,cAAyC,EAAY;CACnD,cAAc;EACZ,MAAM,mDAAmD;CAC3D;AACF,GAEa,IAAb,cAA+C,EAAY,CAAC,GAC/C,IAAb,cAA8C,EAAY,CAAC,GAC9C,IAAb,cAAmD,EAAY,CAAC,GACnD,IAAb,cAA6C,EAAY,CAAC,GAC7C,IAAb,cAA+C,EAAY,CAAC"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["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"],"mappings":";AAAA,IAAa,IAAb,cAAiC,MAAM;CACrC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAEa,IAAb,cAAyC,EAAY;CACnD,cAAc;EACZ,MAAM,+CAA+C;CACvD;AACF,GAEa,IAAb,cAA+C,EAAY,CAAC,GAC/C,IAAb,cAA8C,EAAY,CAAC,GAC9C,IAAb,cAAmD,EAAY,CAAC,GACnD,IAAb,cAA6C,EAAY,CAAC,GAC7C,IAAb,cAA+C,EAAY,CAAC,GAC/C,IAAb,cAA2C,EAAY,CAAC,GAC3C,IAAb,cAA6C,EAAY,CAAC"}

package/dist/i18n.cjs

@@ -1,2 +1,2 @@
-require("./_dev.cjs");const e=require("./errors.cjs"),t=require("./_locale.cjs"),n=require("./_resources.cjs"),r=require("./translator.cjs");function i(i){let a=n.createCatalogStore(i.catalogs),o=i.fallback,s=(Array.isArray(o)?o:o?[o]:[]).map(t.canonicalLocale),c=new AbortController,l=new Set,u=!1,d=t.canonicalLocale(i.locale??`en`),f=0,p=()=>({locale:d,revision:f,translator:r.createTranslatorFromCompiled(a.catalogMap(),{...i,fallback:o,locale:d})}),m=p(),h=()=>{if(u)throw new e.LinguaDisposedError},g=()=>{u||(u=!0,l.clear(),c.abort())},_=e=>{try{e(m)}catch{}},v=()=>{f++,m=p();for(let e of[...l])_(e)},y=e=>t.localeChain(d,s).includes(e);return{get disposalSignal(){return c.signal},dispose:g,get disposed(){return u},getSnapshot(){return m},isLoaded(e){return!u&&a.isLoaded(e?.locale??d)},async load(e){h();let n=t.canonicalLocale(e?.locale??d),r=await a.load(n);!u&&r&&y(n)&&v()},get locale(){return d},segments(e,t){return m.translator.segmentsDynamic(e,t)},segmentsDynamic(e,t){return m.translator.segmentsDynamic(e,t)},serialize(){return h(),a.state(d)},async setLocale(e){h();let n=t.canonicalLocale(e);n!==d&&(d=n,v())},subscribe(e,t){if(h(),t?.signal?.aborted)return()=>{};let n=()=>{l.delete(e),t?.signal?.removeEventListener(`abort`,n)};return t?.signal?.addEventListener(`abort`,n,{once:!0}),l.add(e),t?.immediate&&_(e),n},[Symbol.dispose]:g,translate(e,t={}){return m.translator.translateDynamic(e,t)},translateDynamic(e,t){return m.translator.translateDynamic(e,t)}}}function a(t,n){if(t.version!==3)throw new e.LinguaInvalidStateError(`Unsupported lingua state version: ${String(t.version)}.`);return i({...n,catalogs:t.catalogs,locale:t.locale})}exports.createTranslationStore=i,exports.hydrateTranslationStore=a;
+require("./_dev.cjs");const e=require("./errors.cjs"),t=require("./_locale.cjs"),n=require("./_resources.cjs"),r=require("./translator.cjs");function i(i){if(i.state&&i.state.version!==4)throw new e.LinguaInvalidStateError(`Unsupported lingua state version: ${String(i.state.version)}.`);let a=i.fallback,o=(Array.isArray(a)?a:a?[a]:[]).map(t.canonicalLocale),s=new AbortController,c=new Set,l=!1,u=t.canonicalLocale(i.locale??i.state?.locale??`en`),d=0,f=0,p=n.createCatalogStore({catalogs:i.catalogs,loadCatalog:i.loadCatalog});if(i.state)for(let[e,t]of Object.entries(i.state.catalogs))p.hydrate(e,t);let m=async e=>{let t=[];for(let n of new Set([e,...o]))await p.load(n)&&t.push(n);return t},h=()=>{let n=t.localeChain(u,o).some(p.isLoaded)?i.missing:()=>{throw new e.LinguaMissingCatalogError(`No catalog loaded for locale "${u}". Call load() before translating.`)};return{locale:u,revision:d,translator:r.createTranslatorFromCompiled(p.catalogMap(),{fallback:a,locale:u,missing:n})}},g=h(),_=()=>{if(l)throw new e.LinguaDisposedError},v=()=>{l||(l=!0,c.clear(),s.abort())},y=e=>{try{e(g)}catch{}},b=()=>{d++,g=h();for(let e of[...c])y(e)},x=e=>t.localeChain(u,o).includes(e);return{get disposalSignal(){return s.signal},dispose:v,get disposed(){return l},getSnapshot(){return g},isLoaded(e){return!l&&p.isLoaded(e?.locale??u)},async load(e){_();let n=t.canonicalLocale(e?.locale??u),r=await m(n);_(),r.some(x)&&b()},get locale(){return u},parts(e,t){return g.translator.partsDynamic(e,t)},partsDynamic(e,t){return g.translator.partsDynamic(e,t)},serialize(){return _(),p.state(u)},async setLocale(e){_();let n=t.canonicalLocale(e),r=++f,i=await m(n);if(_(),r===f){if(n===u){i.some(x)&&b();return}u=n,b()}},subscribe(e,t){if(_(),t?.signal?.aborted)return()=>{};let n=()=>{c.delete(e),t?.signal?.removeEventListener(`abort`,n)};return t?.signal?.addEventListener(`abort`,n,{once:!0}),c.add(e),t?.immediate&&y(e),n},[Symbol.dispose]:v,translate(e,t={}){return g.translator.translateDynamic(e,t)},translateDynamic(e,t){return g.translator.translateDynamic(e,t)}}}exports.createI18n=i;
 //# sourceMappingURL=i18n.cjs.map

package/dist/i18n.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.cjs","names":[],"sources":["../src/i18n.ts"],"sourcesContent":["import { error as logError } from './_dev';\nimport { canonicalLocale, localeChain } from './_locale';\nimport { createCatalogStore } from './_resources';\nimport { LinguaDisposedError, LinguaInvalidStateError } from './errors';\nimport { createTranslatorFromCompiled, type Translator } from './translator';\nimport type { Catalog, Locale, SubscribeOptions, TranslationState, TranslationStoreOptions } from './types';\n\nexport type TranslationSnapshot<C extends Catalog = Catalog> = {\n  readonly locale: Locale;\n  readonly revision: number;\n  readonly translator: Translator<C>;\n};\n\nexport type TranslationStore<C extends Catalog = Catalog> = Translator<C> & {\n  [Symbol.dispose](): void;\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  getSnapshot(): TranslationSnapshot<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: TranslationSnapshot<C>) => void, options?: SubscribeOptions): () => void;\n};\n\nexport function createTranslationStore<C extends Catalog>(options: TranslationStoreOptions<C>): TranslationStore<C> {\n  const catalogs = createCatalogStore(options.catalogs);\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: TranslationSnapshot<C>) => void>();\n  let disposed = false;\n  let locale = canonicalLocale(options.locale ?? 'en');\n  let revision = 0;\n\n  const buildSnapshot = (): TranslationSnapshot<C> => ({\n    locale,\n    revision,\n    translator: createTranslatorFromCompiled<C>(catalogs.catalogMap(), { ...options, fallback, locale }),\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: TranslationSnapshot<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 catalogs.load(targetLocale);\n\n      if (!disposed && changed && relevant(targetLocale)) notify();\n    },\n    get locale() {\n      return locale;\n    },\n    segments(key: string, translateOptions) {\n      return snapshot.translator.segmentsDynamic(key, translateOptions);\n    },\n    segmentsDynamic(key, translateOptions) {\n      return snapshot.translator.segmentsDynamic(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\n      if (next === locale) return;\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 TranslationStore<C>;\n}\n\nexport function hydrateTranslationStore<C extends Catalog>(\n  state: TranslationState<C>,\n  options?: Omit<TranslationStoreOptions<C>, 'locale' | 'catalogs'>,\n): TranslationStore<C> {\n  if (state.version !== 3) {\n    throw new LinguaInvalidStateError(`Unsupported lingua state version: ${String(state.version)}.`);\n  }\n\n  return createTranslationStore({ ...options, catalogs: state.catalogs, locale: state.locale });\n}\n"],"mappings":"6IA0BA,SAAgB,EAA0C,EAA0D,CAClH,IAAM,EAAW,EAAA,mBAAmB,EAAQ,QAAQ,EAC9C,EAAW,EAAQ,SACnB,GAAmB,MAAM,QAAQ,CAAQ,EAAI,EAAW,EAAW,CAAC,CAAQ,EAAI,CAAC,EAAA,CAAG,IAAI,EAAA,eAAe,EACvG,EAAa,IAAI,gBACjB,EAAc,IAAI,IACpB,EAAW,GACX,EAAS,EAAA,gBAAgB,EAAQ,QAAU,IAAI,EAC/C,EAAW,EAET,OAA+C,CACnD,SACA,WACA,WAAY,EAAA,6BAAgC,EAAS,WAAW,EAAG,CAAE,GAAG,EAAS,WAAU,QAAO,CAAC,CACrG,GACI,EAAW,EAAc,EAEvB,MAAyB,CAC7B,GAAI,EAAU,MAAM,IAAI,EAAA,mBAC1B,EAEM,MAAsB,CACtB,IAEJ,EAAW,GACX,EAAY,MAAM,EAClB,EAAW,MAAM,EACnB,EAEM,EAAY,GAA2D,CAC3E,GAAI,CACF,EAAS,CAAQ,CACnB,MAAgB,CAEhB,CACF,EAEM,MAAqB,CACzB,IACA,EAAW,EAAc,EAEzB,IAAK,IAAM,IAAY,CAAC,GAAG,CAAW,EAAG,EAAS,CAAQ,CAC5D,EAEM,EAAY,GAA+B,EAAA,YAAY,EAAQ,CAAe,CAAC,CAAC,SAAS,CAAS,EAExG,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAO,EAAW,MACpB,EACA,UACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,aAAc,CACZ,OAAO,CACT,EACA,SAAS,EAAa,CACpB,MAAO,CAAC,GAAY,EAAS,SAAS,GAAa,QAAU,CAAM,CACrE,EACA,MAAM,KAAK,EAAa,CACtB,EAAW,EAEX,IAAM,EAAe,EAAA,gBAAgB,GAAa,QAAU,CAAM,EAC5D,EAAU,MAAM,EAAS,KAAK,CAAY,EAE5C,CAAC,GAAY,GAAW,EAAS,CAAY,GAAG,EAAO,CAC7D,EACA,IAAI,QAAS,CACX,OAAO,CACT,EACA,SAAS,EAAa,EAAkB,CACtC,OAAO,EAAS,WAAW,gBAAgB,EAAK,CAAgB,CAClE,EACA,gBAAgB,EAAK,EAAkB,CACrC,OAAO,EAAS,WAAW,gBAAgB,EAAK,CAAgB,CAClE,EACA,WAAY,CAGV,OAFA,EAAW,EAEJ,EAAS,MAAM,CAAM,CAC9B,EACA,MAAM,UAAU,EAAY,CAC1B,EAAW,EAEX,IAAM,EAAO,EAAA,gBAAgB,CAAU,EAEnC,IAAS,IAEb,EAAS,EACT,EAAO,EACT,EACA,UAAU,EAAU,EAAkB,CAGpC,GAFA,EAAW,EAEP,GAAkB,QAAQ,QAAS,UAAa,CAAC,EAErD,IAAM,MAA0B,CAC9B,EAAY,OAAO,CAAQ,EAC3B,GAAkB,QAAQ,oBAAoB,QAAS,CAAW,CACpE,EAOA,OALA,GAAkB,QAAQ,iBAAiB,QAAS,EAAa,CAAE,KAAM,EAAK,CAAC,EAC/E,EAAY,IAAI,CAAQ,EAEpB,GAAkB,WAAW,EAAS,CAAQ,EAE3C,CACT,GACC,OAAO,SAAU,EAClB,UAAU,EAAa,EAAmB,CAAC,EAAG,CAC5C,OAAO,EAAS,WAAW,iBAAiB,EAAK,CAAgB,CACnE,EACA,iBAAiB,EAAK,EAAkB,CACtC,OAAO,EAAS,WAAW,iBAAiB,EAAK,CAAgB,CACnE,CACF,CACF,CAEA,SAAgB,EACd,EACA,EACqB,CACrB,GAAI,EAAM,UAAY,EACpB,MAAM,IAAI,EAAA,wBAAwB,qCAAqC,OAAO,EAAM,OAAO,EAAE,EAAE,EAGjG,OAAO,EAAuB,CAAE,GAAG,EAAS,SAAU,EAAM,SAAU,OAAQ,EAAM,MAAO,CAAC,CAC9F"}
+{"version":3,"file":"i18n.cjs","names":[],"sources":["../src/i18n.ts"],"sourcesContent":["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  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 !== 4) {\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 buildSnapshot = (): I18nSnapshot<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 {\n      locale,\n      revision,\n      translator: createTranslatorFromCompiled<C>(catalogs.catalogMap(), { fallback, locale, missing }),\n    };\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":"6IA0BA,SAAgB,EAA8B,EAAkC,CAC9E,GAAI,EAAQ,OAAS,EAAQ,MAAM,UAAY,EAC7C,MAAM,IAAI,EAAA,wBAAwB,qCAAqC,OAAO,EAAQ,MAAM,OAAO,EAAE,EAAE,EAGzG,IAAM,EAAW,EAAQ,SACnB,GAAmB,MAAM,QAAQ,CAAQ,EAAI,EAAW,EAAW,CAAC,CAAQ,EAAI,CAAC,EAAA,CAAG,IAAI,EAAA,eAAe,EACvG,EAAa,IAAI,gBACjB,EAAc,IAAI,IACpB,EAAW,GACX,EAAS,EAAA,gBAAgB,EAAQ,QAAU,EAAQ,OAAO,QAAU,IAAI,EACxE,EAAW,EACX,EAAa,EAEX,EAAW,EAAA,mBAAsB,CAAE,SAAU,EAAQ,SAAU,YAAa,EAAQ,WAAY,CAAC,EAGvG,GAAI,EAAQ,MACV,IAAK,GAAM,CAAC,EAAa,KAAY,OAAO,QAAQ,EAAQ,MAAM,QAAQ,EACxE,EAAS,QAAQ,EAAa,CAAO,EAIzC,IAAM,EAAc,KAAO,IAA+C,CACxE,IAAM,EAAoB,CAAC,EAE3B,IAAK,IAAM,KAAa,IAAI,IAAI,CAAC,EAAQ,GAAG,CAAe,CAAC,EACtD,MAAM,EAAS,KAAK,CAAS,GAAG,EAAQ,KAAK,CAAS,EAG5D,OAAO,CACT,EAEM,MAAuC,CAE3C,IAAM,EADQ,EAAA,YAAY,EAAQ,CAAe,CAAC,CAAC,KAAK,EAAS,QACjD,EACZ,EAAQ,YACF,CACJ,MAAM,IAAI,EAAA,0BACR,iCAAiC,EAAO,mCAC1C,CACF,EAEJ,MAAO,CACL,SACA,WACA,WAAY,EAAA,6BAAgC,EAAS,WAAW,EAAG,CAAE,WAAU,SAAQ,SAAQ,CAAC,CAClG,CACF,EACI,EAAW,EAAc,EAEvB,MAAyB,CAC7B,GAAI,EAAU,MAAM,IAAI,EAAA,mBAC1B,EAEM,MAAsB,CACtB,IAEJ,EAAW,GACX,EAAY,MAAM,EAClB,EAAW,MAAM,EACnB,EAEM,EAAY,GAAoD,CACpE,GAAI,CACF,EAAS,CAAQ,CACnB,MAAgB,CAEhB,CACF,EAEM,MAAqB,CACzB,IACA,EAAW,EAAc,EAEzB,IAAK,IAAM,IAAY,CAAC,GAAG,CAAW,EAAG,EAAS,CAAQ,CAC5D,EAEM,EAAY,GAA+B,EAAA,YAAY,EAAQ,CAAe,CAAC,CAAC,SAAS,CAAS,EAExG,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAO,EAAW,MACpB,EACA,UACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,aAAc,CACZ,OAAO,CACT,EACA,SAAS,EAAa,CACpB,MAAO,CAAC,GAAY,EAAS,SAAS,GAAa,QAAU,CAAM,CACrE,EACA,MAAM,KAAK,EAAa,CACtB,EAAW,EAEX,IAAM,EAAe,EAAA,gBAAgB,GAAa,QAAU,CAAM,EAC5D,EAAU,MAAM,EAAY,CAAY,EAE9C,EAAW,EACP,EAAQ,KAAK,CAAQ,GAAG,EAAO,CACrC,EACA,IAAI,QAAS,CACX,OAAO,CACT,EACA,MAAM,EAAa,EAAkB,CACnC,OAAO,EAAS,WAAW,aAAa,EAAK,CAAgB,CAC/D,EACA,aAAa,EAAK,EAAkB,CAClC,OAAO,EAAS,WAAW,aAAa,EAAK,CAAgB,CAC/D,EACA,WAAY,CAGV,OAFA,EAAW,EAEJ,EAAS,MAAM,CAAM,CAC9B,EACA,MAAM,UAAU,EAAY,CAC1B,EAAW,EAEX,IAAM,EAAO,EAAA,gBAAgB,CAAU,EACjC,EAAU,EAAE,EACZ,EAAU,MAAM,EAAY,CAAI,EAEtC,KAAW,EACP,IAAY,EAEhB,IAAI,IAAS,EAAQ,CACf,EAAQ,KAAK,CAAQ,GAAG,EAAO,EAEnC,MACF,CAEA,EAAS,EACT,EAAO,CAHP,CAIF,EACA,UAAU,EAAU,EAAkB,CAGpC,GAFA,EAAW,EAEP,GAAkB,QAAQ,QAAS,UAAa,CAAC,EAErD,IAAM,MAA0B,CAC9B,EAAY,OAAO,CAAQ,EAC3B,GAAkB,QAAQ,oBAAoB,QAAS,CAAW,CACpE,EAOA,OALA,GAAkB,QAAQ,iBAAiB,QAAS,EAAa,CAAE,KAAM,EAAK,CAAC,EAC/E,EAAY,IAAI,CAAQ,EAEpB,GAAkB,WAAW,EAAS,CAAQ,EAE3C,CACT,GACC,OAAO,SAAU,EAClB,UAAU,EAAa,EAAmB,CAAC,EAAG,CAC5C,OAAO,EAAS,WAAW,iBAAiB,EAAK,CAAgB,CACnE,EACA,iBAAiB,EAAK,EAAkB,CACtC,OAAO,EAAS,WAAW,iBAAiB,EAAK,CAAgB,CACnE,CACF,CACF"}

package/dist/i18n.d.ts

@@ -1,16 +1,16 @@
 import { type Translator } from './translator';
-import type { Catalog, Locale, SubscribeOptions, TranslationState, TranslationStoreOptions } from './types';
-export type TranslationSnapshot<C extends Catalog = Catalog> = {
+import type { Catalog, I18nOptions, Locale, SubscribeOptions, TranslationState } from './types';
+export type I18nSnapshot<C extends Catalog = Catalog> = {
     readonly locale: Locale;
     readonly revision: number;
     readonly translator: Translator<C>;
 };
-export type TranslationStore<C extends Catalog = Catalog> = Translator<C> & {
+export type I18n<C extends Catalog = Catalog> = Translator<C> & {
     [Symbol.dispose](): void;
     readonly disposalSignal: AbortSignal;
     dispose(): void;
     readonly disposed: boolean;
-    getSnapshot(): TranslationSnapshot<C>;
+    getSnapshot(): I18nSnapshot<C>;
     isLoaded(options?: {
         locale?: Locale;
     }): boolean;
@@ -19,8 +19,7 @@ export type TranslationStore<C extends Catalog = Catalog> = Translator<C> & {
     }): Promise<void>;
     serialize(): TranslationState<C>;
     setLocale(locale: Locale): Promise<void>;
-    subscribe(listener: (snapshot: TranslationSnapshot<C>) => void, options?: SubscribeOptions): () => void;
+    subscribe(listener: (snapshot: I18nSnapshot<C>) => void, options?: SubscribeOptions): () => void;
 };
-export declare function createTranslationStore<C extends Catalog>(options: TranslationStoreOptions<C>): TranslationStore<C>;
-export declare function hydrateTranslationStore<C extends Catalog>(state: TranslationState<C>, options?: Omit<TranslationStoreOptions<C>, 'locale' | 'catalogs'>): TranslationStore<C>;
+export declare function createI18n<C extends Catalog>(options: I18nOptions<C>): I18n<C>;
 //# 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":"AAIA,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE5G,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG;IAC1E,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,WAAW,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IACjD,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,SAAS,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;CACzG,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAqHlH;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,OAAO,EACvD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,GAChE,gBAAgB,CAAC,CAAC,CAAC,CAMrB"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhG,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG;IAC9D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,WAAW,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IACjD,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,SAAS,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;CAClG,CAAC;AAEF,wBAAgB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAiK9E"}