@vielzeug/lingua 3.0.0 → 26.10.0

package/dist/ripple.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple.cjs","names":[],"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":"qGAyBA,SAAgB,mBAAsC,EAAgC,CACpF,IAAM,GAAA,EAAS,EAAA,iBAAA,CAAyB,CACtC,gBAAmB,EAAK,OACxB,UAAY,GAAa,EAAK,cAAgB,EAAS,CAAC,CAC1D,CAAC,EAED,MAAO,CACL,OACA,SACA,WAAY,EAAK,KACf,EAAY,MACL,EAAK,iBAAiB,EAAK,CAAO,GAE3C,kBAAmB,EAAK,KACtB,EAAY,MACL,EAAK,iBAAiB,EAAK,CAAO,EAE7C,CACF"}

package/dist/ripple.d.ts

@@ -0,0 +1,24 @@
+import { type Readable } from '@vielzeug/ripple';
+import type { I18n } from './i18n';
+import type { Catalog, Locale, MessageKey, PluralOptions, TranslateOptions } 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). */
+    readonly i18n: I18n<C>;
+    /** 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;
+}
+/**
+ * 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.
+ */
+export declare function createReactiveI18n<C extends Catalog>(i18n: I18n<C>): ReactiveI18n<C>;
+//# sourceMappingURL=ripple.d.ts.map

package/dist/ripple.d.ts.map

@@ -0,0 +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,wFAAwF;IACxF,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"}

package/dist/ripple.js

@@ -0,0 +1,2 @@
+import{fromSubscribable as e}from"@vielzeug/ripple";function createReactiveI18n(t){let n=e({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))}}export{createReactiveI18n};
+//# sourceMappingURL=ripple.js.map

package/dist/ripple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple.js","names":[],"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":"oDAyBA,SAAgB,mBAAsC,EAAgC,CACpF,IAAM,EAAS,EAAyB,CACtC,gBAAmB,EAAK,OACxB,UAAY,GAAa,EAAK,cAAgB,EAAS,CAAC,CAC1D,CAAC,EAED,MAAO,CACL,OACA,SACA,WAAY,EAAK,KACf,EAAY,MACL,EAAK,iBAAiB,EAAK,CAAO,GAE3C,kBAAmB,EAAK,KACtB,EAAY,MACL,EAAK,iBAAiB,EAAK,CAAO,EAE7C,CACF"}

package/dist/translator.cjs

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

package/dist/translator.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"translator.cjs","names":[],"sources":["../src/translator.ts"],"sourcesContent":["import { type CompiledCatalog, type CompiledMessage, compileCatalog } from './_catalog';\nimport { 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\nconst isDev = !(globalThis as { __LINGUA_PROD__?: boolean }).__LINGUA_PROD__;\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":"oHAuCA,SAAS,EAAe,EAAuC,EAA2B,CACxF,GAAI,IAAa,QACf,MAAM,EAAK,KACP,IAAI,EAAA,wBACF,gCAAgC,EAAK,KAAK,aAAa,EAAK,IAAI,eAAe,EAAK,OAAO,GAC7F,EACA,IAAI,EAAA,sBAAsB,4BAA4B,EAAK,IAAI,eAAe,EAAK,OAAO,GAAG,EAcnG,OAXI,OAAO,GAAa,WAAmB,EAAS,CAAI,EAWjD,EAAK,KAAO,IAAI,EAAK,KAAK,GAAK,EAAK,GAC7C,CAIA,SAAgB,EACd,EACA,EAA2B,CAAC,EACb,CACf,IAAM,EAAS,EAAA,gBAAgB,EAAQ,QAAU,IAAI,EAC/C,GACJ,MAAM,QAAQ,EAAQ,QAAQ,EAAI,EAAQ,SAAW,EAAQ,SAAW,CAAC,EAAQ,QAAQ,EAAI,CAAC,EAAA,CAC9F,IAAI,EAAA,eAAe,EACf,EAAQ,EAAA,YAAY,EAAQ,CAAQ,EACpC,EAAU,EAAQ,QAElB,EAAc,GAAwB,EAAe,EAAS,CAAE,MAAK,QAAO,CAAC,EAC7E,GAAgB,EAAc,IAAwB,EAAe,EAAS,CAAE,MAAK,SAAQ,MAAK,CAAC,EAEnG,EAAW,GAA6C,CAC5D,IAAK,IAAM,KAAa,EAAO,CAC7B,IAAM,EAAU,EAAS,IAAI,CAAS,CAAC,EAAE,IAAI,CAAG,EAEhD,GAAI,EAAS,MAAO,CAAE,OAAQ,EAAW,SAAQ,CACnD,CAGF,EAEM,GACJ,EACA,IACoD,CACpD,IAAM,EAAQ,EAAQ,CAAG,EAEzB,GAAI,CAAC,EAAO,OAEZ,GAAI,EAAM,QAAQ,OAAS,OAGzB,MAFI,UAAW,EAAS,OAEjB,CAAE,MAAK,SAAU,EAAM,QAAQ,QAAS,EAGjD,GAAI,EAAE,UAAW,IAAY,CAAC,OAAO,SAAS,EAAQ,KAAK,EAAG,CAC5D,GAAI,UAAW,EAAS,MAAM,IAAI,EAAA,8BAA8B,kCAAkC,EAElG,MACF,CAEA,IAAM,EACJ,EAAQ,QAAU,GAAK,CAAC,EAAQ,QAC5B,OACA,EAAA,eAAe,EAAM,OAAQ,EAAQ,MAAO,EAAQ,SAAW,EAAK,EACpE,EAAW,EAAM,QAAQ,MAAM,IAAI,CAAQ,GAAK,EAAM,QAAQ,MAAM,IAAI,OAAO,EAErF,OAAO,EAAW,CAAE,MAAK,UAAS,EAAI,IAAA,EACxC,EAEM,EAAa,GACjB,UAAW,EAAU,CAAE,MAAO,EAAQ,MAAO,GAAG,EAAQ,MAAO,EAAK,EAAQ,QAAU,CAAC,EAEnF,GACJ,EACA,IAC4B,CAC5B,IAAM,EAAQ,EAAY,EAAK,CAAO,EAItC,OAFK,EAEE,EAAA,YAAY,EAAM,SAAU,EAAU,CAAO,EAAkC,GACpF,EAAa,EAAM,EAAM,GAAG,CAC9B,EAJmB,CAAC,CAAE,KAAM,OAAQ,MAAO,EAAW,CAAG,CAAE,CAAC,CAK9D,EAEM,GAAoB,EAAa,EAA4C,CAAC,IAAc,CAChG,IAAM,EAAQ,EAAY,EAAK,CAAO,EAItC,OAFK,EAEE,EAAA,WAAW,EAAM,SAAU,EAAU,CAAO,EAAI,GAAS,EAAa,EAAM,EAAM,GAAG,CAAC,EAF1E,EAAW,CAAG,CAGnC,EAEA,MAAO,CACL,SACA,MAAM,EAAa,EAAoF,CACrG,OAAO,EAAa,EAAK,CAAO,CAClC,EACA,eACA,UAAU,EAAa,EAA4C,CAAC,EAAG,CACrE,OAAO,EAAiB,EAAK,CAAO,CACtC,EACA,kBACF,CACF,CAGA,SAAgB,EAAoC,EAAY,EAA4C,CAC1G,IAAM,EAAS,EAAA,gBAAgB,GAAS,QAAU,IAAI,EAGtD,OAAO,EAAgC,IAFlB,IAA6B,CAAC,CAAC,EAAQ,EAAA,eAAe,CAAO,CAAC,CAAC,CAE7C,EAAU,CAAE,GAAG,EAAS,QAAO,CAAC,CACzE"}
+{"version":3,"file":"translator.cjs","names":[],"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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"}

package/dist/translator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../src/translator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAwC,MAAM,YAAY,CAAC;AAKxF,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EAEN,eAAe,EACf,IAAI,EACJ,SAAS,EACT,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;KAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;KAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9G,YAAY,CAAC,CAAC,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,gBAAgB,GAAG,aAAa,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;KAAE,GAC3E,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC/D,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7D,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,MAAM,CAAC;CACnF,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC,CAAC;AA6BF,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,OAAO,EAC5D,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,EAC9C,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAAC,CAAC,CAAC,CAqFf;AAED,iHAAiH;AACjH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAK1G"}
+{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../src/translator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAwC,MAAM,YAAY,CAAC;AAKxF,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EAEN,eAAe,EACf,IAAI,EACJ,SAAS,EACT,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;KAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;KAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9G,YAAY,CAAC,CAAC,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,gBAAgB,GAAG,aAAa,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;KAAE,GAC3E,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3B,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC/D,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7D,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,MAAM,CAAC;CACnF,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC,CAAC;AA2BF,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,OAAO,EAC5D,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,EAC9C,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAAC,CAAC,CAAC,CAqFf;AAED,iHAAiH;AACjH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAK1G"}

package/dist/translator.js

@@ -1,77 +1,2 @@
-import { renderParts as e, renderText as t } from "./_template.js";
-import { LinguaInvalidPluralCountError as n, LinguaMissingKeyError as r, LinguaMissingValueError as i } from "./errors.js";
-import { compileCatalog as a } from "./_catalog.js";
-import { canonicalLocale as o, localeChain as s, pluralCategory as c } from "./_locale.js";
-//#region src/translator.ts
-function l(e, t) {
-	if (e === "throw") throw t.name ? new i(`Missing interpolation value "${t.name}" for key "${t.key}" in locale "${t.locale}".`) : new r(`Missing translation key "${t.key}" in locale "${t.locale}".`);
-	return typeof e == "function" ? e(t) : t.name ? `{${t.name}}` : t.key;
-}
-function u(r, i = {}) {
-	let a = o(i.locale ?? "en"), u = (Array.isArray(i.fallback) ? i.fallback : i.fallback ? [i.fallback] : []).map(o), d = s(a, u), f = i.missing, p = (e) => l(f, {
-		key: e,
-		locale: a
-	}), m = (e, t) => l(f, {
-		key: t,
-		locale: a,
-		name: e
-	}), h = (e) => {
-		for (let t of d) {
-			let n = r.get(t)?.get(e);
-			if (n) return {
-				locale: t,
-				message: n
-			};
-		}
-	}, g = (e, t) => {
-		let r = h(e);
-		if (!r) return;
-		if (r.message.kind === "text") return "count" in t ? void 0 : {
-			key: e,
-			template: r.message.template
-		};
-		if (!("count" in t) || !Number.isFinite(t.count)) {
-			if ("count" in t) throw new n("`count` must be a finite number.");
-			return;
-		}
-		let i = t.count === 0 && !t.ordinal ? "zero" : c(r.locale, t.count, t.ordinal ?? !1), a = r.message.forms.get(i) ?? r.message.forms.get("other");
-		return a ? {
-			key: e,
-			template: a
-		} : void 0;
-	}, _ = (e) => "count" in e ? {
-		count: e.count,
-		...e.values
-	} : e.values ?? {}, v = (t, n) => {
-		let r = g(t, n);
-		return r ? e(r.template, _(n), (e) => m(e, r.key)) : [{
-			type: "text",
-			value: p(t)
-		}];
-	}, y = (e, n = {}) => {
-		let r = g(e, n);
-		return r ? t(r.template, _(n), (e) => m(e, r.key)) : p(e);
-	};
-	return {
-		locale: a,
-		parts(e, t) {
-			return v(e, t);
-		},
-		partsDynamic: v,
-		translate(e, t = {}) {
-			return y(e, t);
-		},
-		translateDynamic: y
-	};
-}
-function d(e, t) {
-	let n = o(t?.locale ?? "en");
-	return u(/* @__PURE__ */ new Map([[n, a(e)]]), {
-		...t,
-		locale: n
-	});
-}
-//#endregion
-export { d as createTranslator, u as createTranslatorFromCompiled };
-
+import{renderParts as e,renderText as t}from"./_template.js";import{LinguaInvalidPluralCountError as n,LinguaMissingKeyError as r,LinguaMissingValueError as i}from"./errors.js";import{compileCatalog as a}from"./_catalog.js";import"./_dev.js";import{canonicalLocale as o,localeChain as s,pluralCategory as c}from"./_locale.js";function resolveMissing(e,t){if(e===`throw`)throw t.name?new i(`Missing interpolation value "${t.name}" for key "${t.key}" in locale "${t.locale}".`):new r(`Missing translation key "${t.key}" in locale "${t.locale}".`);return typeof e==`function`?e(t):t.name?`{${t.name}}`:t.key}function createTranslatorFromCompiled(r,i={}){let a=o(i.locale??`en`),l=(Array.isArray(i.fallback)?i.fallback:i.fallback?[i.fallback]:[]).map(o),u=s(a,l),d=i.missing,missingKey=e=>resolveMissing(d,{key:e,locale:a}),missingValue=(e,t)=>resolveMissing(d,{key:t,locale:a,name:e}),resolve=e=>{for(let t of u){let n=r.get(t)?.get(e);if(n)return{locale:t,message:n}}},templateFor=(e,t)=>{let r=resolve(e);if(!r)return;if(r.message.kind===`text`)return`count`in t?void 0:{key:e,template:r.message.template};if(!(`count`in t)||!Number.isFinite(t.count)){if(`count`in t)throw new n("`count` must be a finite number.");return}let i=t.count===0&&!t.ordinal?`zero`:c(r.locale,t.count,t.ordinal??!1),a=r.message.forms.get(i)??r.message.forms.get(`other`);return a?{key:e,template:a}:void 0},valuesFor=e=>`count`in e?{count:e.count,...e.values}:e.values??{},partsDynamic=(t,n)=>{let r=templateFor(t,n);return r?e(r.template,valuesFor(n),e=>missingValue(e,r.key)):[{type:`text`,value:missingKey(t)}]},translateDynamic=(e,n={})=>{let r=templateFor(e,n);return r?t(r.template,valuesFor(n),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(e,t){let n=o(t?.locale??`en`);return createTranslatorFromCompiled(new Map([[n,a(e)]]),{...t,locale:n})}export{createTranslator,createTranslatorFromCompiled};
 //# sourceMappingURL=translator.js.map

package/dist/translator.js.map

@@ -1 +1 @@
-{"version":3,"file":"translator.js","names":[],"sources":["../src/translator.ts"],"sourcesContent":["import { type CompiledCatalog, type CompiledMessage, compileCatalog } from './_catalog';\nimport { 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\nconst isDev = !(globalThis as { __LINGUA_PROD__?: boolean }).__LINGUA_PROD__;\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":";;;;;AAuCA,SAAS,EAAe,GAAuC,GAA2B;CACxF,IAAI,MAAa,SACf,MAAM,EAAK,OACP,IAAI,EACF,gCAAgC,EAAK,KAAK,aAAa,EAAK,IAAI,eAAe,EAAK,OAAO,GAC7F,IACA,IAAI,EAAsB,4BAA4B,EAAK,IAAI,eAAe,EAAK,OAAO,GAAG;CAcnG,OAXI,OAAO,KAAa,aAAmB,EAAS,CAAI,IAWjD,EAAK,OAAO,IAAI,EAAK,KAAK,KAAK,EAAK;AAC7C;AAIA,SAAgB,EACd,GACA,IAA2B,CAAC,GACb;CACf,IAAM,IAAS,EAAgB,EAAQ,UAAU,IAAI,GAC/C,KACJ,MAAM,QAAQ,EAAQ,QAAQ,IAAI,EAAQ,WAAW,EAAQ,WAAW,CAAC,EAAQ,QAAQ,IAAI,CAAC,EAAA,CAC9F,IAAI,CAAe,GACf,IAAQ,EAAY,GAAQ,CAAQ,GACpC,IAAU,EAAQ,SAElB,KAAc,MAAwB,EAAe,GAAS;EAAE;EAAK;CAAO,CAAC,GAC7E,KAAgB,GAAc,MAAwB,EAAe,GAAS;EAAE;EAAK;EAAQ;CAAK,CAAC,GAEnG,KAAW,MAA6C;EAC5D,KAAK,IAAM,KAAa,GAAO;GAC7B,IAAM,IAAU,EAAS,IAAI,CAAS,CAAC,EAAE,IAAI,CAAG;GAEhD,IAAI,GAAS,OAAO;IAAE,QAAQ;IAAW;GAAQ;EACnD;CAGF,GAEM,KACJ,GACA,MACoD;EACpD,IAAM,IAAQ,EAAQ,CAAG;EAEzB,IAAI,CAAC,GAAO;EAEZ,IAAI,EAAM,QAAQ,SAAS,QAGzB,OAFI,WAAW,IAAS,SAEjB;GAAE;GAAK,UAAU,EAAM,QAAQ;EAAS;EAGjD,IAAI,EAAE,WAAW,MAAY,CAAC,OAAO,SAAS,EAAQ,KAAK,GAAG;GAC5D,IAAI,WAAW,GAAS,MAAM,IAAI,EAA8B,kCAAkC;GAElG;EACF;EAEA,IAAM,IACJ,EAAQ,UAAU,KAAK,CAAC,EAAQ,UAC5B,SACA,EAAe,EAAM,QAAQ,EAAQ,OAAO,EAAQ,WAAW,EAAK,GACpE,IAAW,EAAM,QAAQ,MAAM,IAAI,CAAQ,KAAK,EAAM,QAAQ,MAAM,IAAI,OAAO;EAErF,OAAO,IAAW;GAAE;GAAK;EAAS,IAAI,KAAA;CACxC,GAEM,KAAa,MACjB,WAAW,IAAU;EAAE,OAAO,EAAQ;EAAO,GAAG,EAAQ;CAAO,IAAK,EAAQ,UAAU,CAAC,GAEnF,KACJ,GACA,MAC4B;EAC5B,IAAM,IAAQ,EAAY,GAAK,CAAO;EAItC,OAFK,IAEE,EAAY,EAAM,UAAU,EAAU,CAAO,IAAkC,MACpF,EAAa,GAAM,EAAM,GAAG,CAC9B,IAJmB,CAAC;GAAE,MAAM;GAAQ,OAAO,EAAW,CAAG;EAAE,CAAC;CAK9D,GAEM,KAAoB,GAAa,IAA4C,CAAC,MAAc;EAChG,IAAM,IAAQ,EAAY,GAAK,CAAO;EAItC,OAFK,IAEE,EAAW,EAAM,UAAU,EAAU,CAAO,IAAI,MAAS,EAAa,GAAM,EAAM,GAAG,CAAC,IAF1E,EAAW,CAAG;CAGnC;CAEA,OAAO;EACL;EACA,MAAM,GAAa,GAAoF;GACrG,OAAO,EAAa,GAAK,CAAO;EAClC;EACA;EACA,UAAU,GAAa,IAA4C,CAAC,GAAG;GACrE,OAAO,EAAiB,GAAK,CAAO;EACtC;EACA;CACF;AACF;AAGA,SAAgB,EAAoC,GAAY,GAA4C;CAC1G,IAAM,IAAS,EAAgB,GAAS,UAAU,IAAI;CAGtD,OAAO,kBAAgC,IAFlB,IAA6B,CAAC,CAAC,GAAQ,EAAe,CAAO,CAAC,CAAC,CAE7C,GAAU;EAAE,GAAG;EAAS;CAAO,CAAC;AACzE"}
+{"version":3,"file":"translator.js","names":[],"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":"sUAqCA,SAAS,eAAe,EAAuC,EAA2B,CACxF,GAAI,IAAa,QACf,MAAM,EAAK,KACP,IAAI,EACF,gCAAgC,EAAK,KAAK,aAAa,EAAK,IAAI,eAAe,EAAK,OAAO,GAC7F,EACA,IAAI,EAAsB,4BAA4B,EAAK,IAAI,eAAe,EAAK,OAAO,GAAG,EAcnG,OAXI,OAAO,GAAa,WAAmB,EAAS,CAAI,EAWjD,EAAK,KAAO,IAAI,EAAK,KAAK,GAAK,EAAK,GAC7C,CAIA,SAAgB,6BACd,EACA,EAA2B,CAAC,EACb,CACf,IAAM,EAAS,EAAgB,EAAQ,QAAU,IAAI,EAC/C,GACJ,MAAM,QAAQ,EAAQ,QAAQ,EAAI,EAAQ,SAAW,EAAQ,SAAW,CAAC,EAAQ,QAAQ,EAAI,CAAC,EAAA,CAC9F,IAAI,CAAe,EACf,EAAQ,EAAY,EAAQ,CAAQ,EACpC,EAAU,EAAQ,QAElB,WAAc,GAAwB,eAAe,EAAS,CAAE,MAAK,QAAO,CAAC,EAC7E,cAAgB,EAAc,IAAwB,eAAe,EAAS,CAAE,MAAK,SAAQ,MAAK,CAAC,EAEnG,QAAW,GAA6C,CAC5D,IAAK,IAAM,KAAa,EAAO,CAC7B,IAAM,EAAU,EAAS,IAAI,CAAS,CAAC,EAAE,IAAI,CAAG,EAEhD,GAAI,EAAS,MAAO,CAAE,OAAQ,EAAW,SAAQ,CACnD,CAGF,EAEM,aACJ,EACA,IACoD,CACpD,IAAM,EAAQ,QAAQ,CAAG,EAEzB,GAAI,CAAC,EAAO,OAEZ,GAAI,EAAM,QAAQ,OAAS,OAGzB,MAFI,UAAW,EAAS,OAEjB,CAAE,MAAK,SAAU,EAAM,QAAQ,QAAS,EAGjD,GAAI,EAAE,UAAW,IAAY,CAAC,OAAO,SAAS,EAAQ,KAAK,EAAG,CAC5D,GAAI,UAAW,EAAS,MAAM,IAAI,EAA8B,kCAAkC,EAElG,MACF,CAEA,IAAM,EACJ,EAAQ,QAAU,GAAK,CAAC,EAAQ,QAC5B,OACA,EAAe,EAAM,OAAQ,EAAQ,MAAO,EAAQ,SAAW,EAAK,EACpE,EAAW,EAAM,QAAQ,MAAM,IAAI,CAAQ,GAAK,EAAM,QAAQ,MAAM,IAAI,OAAO,EAErF,OAAO,EAAW,CAAE,MAAK,UAAS,EAAI,IAAA,EACxC,EAEM,UAAa,GACjB,UAAW,EAAU,CAAE,MAAO,EAAQ,MAAO,GAAG,EAAQ,MAAO,EAAK,EAAQ,QAAU,CAAC,EAEnF,cACJ,EACA,IAC4B,CAC5B,IAAM,EAAQ,YAAY,EAAK,CAAO,EAItC,OAFK,EAEE,EAAY,EAAM,SAAU,UAAU,CAAO,EAAkC,GACpF,aAAa,EAAM,EAAM,GAAG,CAC9B,EAJmB,CAAC,CAAE,KAAM,OAAQ,MAAO,WAAW,CAAG,CAAE,CAAC,CAK9D,EAEM,kBAAoB,EAAa,EAA4C,CAAC,IAAc,CAChG,IAAM,EAAQ,YAAY,EAAK,CAAO,EAItC,OAFK,EAEE,EAAW,EAAM,SAAU,UAAU,CAAO,EAAI,GAAS,aAAa,EAAM,EAAM,GAAG,CAAC,EAF1E,WAAW,CAAG,CAGnC,EAEA,MAAO,CACL,SACA,MAAM,EAAa,EAAoF,CACrG,OAAO,aAAa,EAAK,CAAO,CAClC,EACA,aACA,UAAU,EAAa,EAA4C,CAAC,EAAG,CACrE,OAAO,iBAAiB,EAAK,CAAO,CACtC,EACA,gBACF,CACF,CAGA,SAAgB,iBAAoC,EAAY,EAA4C,CAC1G,IAAM,EAAS,EAAgB,GAAS,QAAU,IAAI,EAGtD,OAAO,6BAAgC,IAFlB,IAA6B,CAAC,CAAC,EAAQ,EAAe,CAAO,CAAC,CAAC,CAE7C,EAAU,CAAE,GAAG,EAAS,QAAO,CAAC,CACzE"}

package/dist/types.d.ts

@@ -70,7 +70,7 @@ export type SubscribeOptions = {
 export type TranslationState<C extends Catalog = Catalog> = {
     readonly catalogs: Catalogs<C>;
     readonly locale: Locale;
-    readonly version: 4;
+    readonly version: 1;
 };
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/validate.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./_catalog.cjs"),t=require("./_locale.cjs");function n(n,r){e.compileCatalog(n);let i=t.canonicalLocale(r),a=new Intl.PluralRules(i).resolvedOptions().pluralCategories,o=[],s=(t,n)=>{if(typeof t!=`string`){if(e.isPluralMessage(t)){for(let e of a)Object.hasOwn(t.plural,e)||o.push({key:n,locale:i,missing:e});return}for(let[e,r]of Object.entries(t))s(r,n?`${n}.${e}`:e)}};for(let[e,t]of Object.entries(n))s(t,e);return o}function r(t){let n=Object.keys(t),r=new Map,i=[],a=[];for(let i of n)r.set(i,new Set(e.compileCatalog(t[i]).keys()));let o=n[0],s=r.get(o);for(let e of n){if(e===o)continue;let t=r.get(e);for(let n of s)t.has(n)||i.push({key:n,locale:e});for(let n of t)s.has(n)||a.push({key:n,locale:e})}return{extra:a,missing:i}}exports.compareCatalogs=r,exports.validateCatalog=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./_catalog.cjs"),t=require("./_locale.cjs");function validateCatalog(n,r){e.compileCatalog(n);let i=t.canonicalLocale(r),a=new Intl.PluralRules(i).resolvedOptions().pluralCategories,o=[],visit=(t,n)=>{if(typeof t!=`string`){if(e.isPluralMessage(t)){for(let e of a)Object.hasOwn(t.plural,e)||o.push({key:n,locale:i,missing:e});return}for(let[e,r]of Object.entries(t))visit(r,n?`${n}.${e}`:e)}};for(let[e,t]of Object.entries(n))visit(t,e);return o}function compareCatalogs(t){let n=Object.keys(t),r=new Map,i=[],a=[];for(let i of n)r.set(i,new Set(e.compileCatalog(t[i]).keys()));let o=n[0],s=r.get(o);for(let e of n){if(e===o)continue;let t=r.get(e);for(let n of s)t.has(n)||i.push({key:n,locale:e});for(let n of t)s.has(n)||a.push({key:n,locale:e})}return{extra:a,missing:i}}exports.compareCatalogs=compareCatalogs,exports.validateCatalog=validateCatalog;
 //# sourceMappingURL=validate.cjs.map

package/dist/validate.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validate.cjs","names":[],"sources":["../src/validate.ts"],"sourcesContent":["import { compileCatalog, isPluralMessage } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport type { Catalog, CatalogNode, Catalogs, Locale } from './types';\n\nexport type ValidationIssue = {\n  key: string;\n  locale: Locale;\n  missing: Intl.LDMLPluralRule;\n};\n\nexport type CatalogComparison = {\n  readonly missing: ReadonlyArray<{ key: string; locale: Locale }>;\n  readonly extra: ReadonlyArray<{ key: string; locale: Locale }>;\n};\n\n/** Explicit tooling API. Runtime never loads validation code or emits asynchronous catalog warnings. */\nexport function validateCatalog(catalog: Catalog, locale: Locale): ValidationIssue[] {\n  compileCatalog(catalog);\n\n  const canonical = canonicalLocale(locale);\n  const categories = new Intl.PluralRules(canonical).resolvedOptions().pluralCategories;\n  const issues: ValidationIssue[] = [];\n\n  const visit = (node: CatalogNode, key: string): void => {\n    if (typeof node === 'string') return;\n\n    if (isPluralMessage(node)) {\n      for (const missing of categories) {\n        if (!Object.hasOwn(node.plural, missing)) issues.push({ key, locale: canonical, missing });\n      }\n\n      return;\n    }\n\n    for (const [childKey, child] of Object.entries(node)) visit(child, key ? `${key}.${childKey}` : childKey);\n  };\n\n  for (const [key, node] of Object.entries(catalog)) visit(node, key);\n\n  return issues;\n}\n\n/** Compares catalog key sets across locales. Reports keys missing in each target locale and keys present in targets but absent from the base. */\nexport function compareCatalogs<C extends Catalog>(catalogs: Catalogs<C>): CatalogComparison {\n  const locales = Object.keys(catalogs);\n  const keySets = new Map<Locale, Set<string>>();\n  const missing: Array<{ key: string; locale: Locale }> = [];\n  const extra: Array<{ key: string; locale: Locale }> = [];\n\n  for (const locale of locales) {\n    keySets.set(locale, new Set(compileCatalog(catalogs[locale]).keys()));\n  }\n\n  const base = locales[0];\n  const baseKeys = keySets.get(base)!;\n\n  for (const locale of locales) {\n    if (locale === base) continue;\n    const targetKeys = keySets.get(locale)!;\n\n    for (const key of baseKeys) {\n      if (!targetKeys.has(key)) missing.push({ key, locale });\n    }\n\n    for (const key of targetKeys) {\n      if (!baseKeys.has(key)) extra.push({ key, locale });\n    }\n  }\n\n  return { extra, missing };\n}\n"],"mappings":"gIAgBA,SAAgB,EAAgB,EAAkB,EAAmC,CACnF,EAAA,eAAe,CAAO,EAEtB,IAAM,EAAY,EAAA,gBAAgB,CAAM,EAClC,EAAa,IAAI,KAAK,YAAY,CAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC,iBAC/D,EAA4B,CAAC,EAE7B,GAAS,EAAmB,IAAsB,CAClD,UAAO,GAAS,SAEpB,IAAI,EAAA,gBAAgB,CAAI,EAAG,CACzB,IAAK,IAAM,KAAW,EACf,OAAO,OAAO,EAAK,OAAQ,CAAO,GAAG,EAAO,KAAK,CAAE,MAAK,OAAQ,EAAW,SAAQ,CAAC,EAG3F,MACF,CAEA,IAAK,GAAM,CAAC,EAAU,KAAU,OAAO,QAAQ,CAAI,EAAG,EAAM,EAAO,EAAM,GAAG,EAAI,GAAG,IAAa,CAAQ,CAFxG,CAGF,EAEA,IAAK,GAAM,CAAC,EAAK,KAAS,OAAO,QAAQ,CAAO,EAAG,EAAM,EAAM,CAAG,EAElE,OAAO,CACT,CAGA,SAAgB,EAAmC,EAA0C,CAC3F,IAAM,EAAU,OAAO,KAAK,CAAQ,EAC9B,EAAU,IAAI,IACd,EAAkD,CAAC,EACnD,EAAgD,CAAC,EAEvD,IAAK,IAAM,KAAU,EACnB,EAAQ,IAAI,EAAQ,IAAI,IAAI,EAAA,eAAe,EAAS,EAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAGtE,IAAM,EAAO,EAAQ,GACf,EAAW,EAAQ,IAAI,CAAI,EAEjC,IAAK,IAAM,KAAU,EAAS,CAC5B,GAAI,IAAW,EAAM,SACrB,IAAM,EAAa,EAAQ,IAAI,CAAM,EAErC,IAAK,IAAM,KAAO,EACX,EAAW,IAAI,CAAG,GAAG,EAAQ,KAAK,CAAE,MAAK,QAAO,CAAC,EAGxD,IAAK,IAAM,KAAO,EACX,EAAS,IAAI,CAAG,GAAG,EAAM,KAAK,CAAE,MAAK,QAAO,CAAC,CAEtD,CAEA,MAAO,CAAE,QAAO,SAAQ,CAC1B"}
+{"version":3,"file":"validate.cjs","names":[],"sources":["../src/validate.ts"],"sourcesContent":["import { compileCatalog, isPluralMessage } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport type { Catalog, CatalogNode, Catalogs, Locale } from './types';\n\nexport type ValidationIssue = {\n  key: string;\n  locale: Locale;\n  missing: Intl.LDMLPluralRule;\n};\n\nexport type CatalogComparison = {\n  readonly missing: ReadonlyArray<{ key: string; locale: Locale }>;\n  readonly extra: ReadonlyArray<{ key: string; locale: Locale }>;\n};\n\n/** Explicit tooling API. Runtime never loads validation code or emits asynchronous catalog warnings. */\nexport function validateCatalog(catalog: Catalog, locale: Locale): ValidationIssue[] {\n  compileCatalog(catalog);\n\n  const canonical = canonicalLocale(locale);\n  const categories = new Intl.PluralRules(canonical).resolvedOptions().pluralCategories;\n  const issues: ValidationIssue[] = [];\n\n  const visit = (node: CatalogNode, key: string): void => {\n    if (typeof node === 'string') return;\n\n    if (isPluralMessage(node)) {\n      for (const missing of categories) {\n        if (!Object.hasOwn(node.plural, missing)) issues.push({ key, locale: canonical, missing });\n      }\n\n      return;\n    }\n\n    for (const [childKey, child] of Object.entries(node)) visit(child, key ? `${key}.${childKey}` : childKey);\n  };\n\n  for (const [key, node] of Object.entries(catalog)) visit(node, key);\n\n  return issues;\n}\n\n/** Compares catalog key sets across locales. Reports keys missing in each target locale and keys present in targets but absent from the base. */\nexport function compareCatalogs<C extends Catalog>(catalogs: Catalogs<C>): CatalogComparison {\n  const locales = Object.keys(catalogs);\n  const keySets = new Map<Locale, Set<string>>();\n  const missing: Array<{ key: string; locale: Locale }> = [];\n  const extra: Array<{ key: string; locale: Locale }> = [];\n\n  for (const locale of locales) {\n    keySets.set(locale, new Set(compileCatalog(catalogs[locale]).keys()));\n  }\n\n  const base = locales[0];\n  const baseKeys = keySets.get(base)!;\n\n  for (const locale of locales) {\n    if (locale === base) continue;\n    const targetKeys = keySets.get(locale)!;\n\n    for (const key of baseKeys) {\n      if (!targetKeys.has(key)) missing.push({ key, locale });\n    }\n\n    for (const key of targetKeys) {\n      if (!baseKeys.has(key)) extra.push({ key, locale });\n    }\n  }\n\n  return { extra, missing };\n}\n"],"mappings":"gIAgBA,SAAgB,gBAAgB,EAAkB,EAAmC,CACnF,EAAA,eAAe,CAAO,EAEtB,IAAM,EAAY,EAAA,gBAAgB,CAAM,EAClC,EAAa,IAAI,KAAK,YAAY,CAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC,iBAC/D,EAA4B,CAAC,EAE7B,OAAS,EAAmB,IAAsB,CAClD,UAAO,GAAS,SAEpB,IAAI,EAAA,gBAAgB,CAAI,EAAG,CACzB,IAAK,IAAM,KAAW,EACf,OAAO,OAAO,EAAK,OAAQ,CAAO,GAAG,EAAO,KAAK,CAAE,MAAK,OAAQ,EAAW,SAAQ,CAAC,EAG3F,MACF,CAEA,IAAK,GAAM,CAAC,EAAU,KAAU,OAAO,QAAQ,CAAI,EAAG,MAAM,EAAO,EAAM,GAAG,EAAI,GAAG,IAAa,CAAQ,CAFxG,CAGF,EAEA,IAAK,GAAM,CAAC,EAAK,KAAS,OAAO,QAAQ,CAAO,EAAG,MAAM,EAAM,CAAG,EAElE,OAAO,CACT,CAGA,SAAgB,gBAAmC,EAA0C,CAC3F,IAAM,EAAU,OAAO,KAAK,CAAQ,EAC9B,EAAU,IAAI,IACd,EAAkD,CAAC,EACnD,EAAgD,CAAC,EAEvD,IAAK,IAAM,KAAU,EACnB,EAAQ,IAAI,EAAQ,IAAI,IAAI,EAAA,eAAe,EAAS,EAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAGtE,IAAM,EAAO,EAAQ,GACf,EAAW,EAAQ,IAAI,CAAI,EAEjC,IAAK,IAAM,KAAU,EAAS,CAC5B,GAAI,IAAW,EAAM,SACrB,IAAM,EAAa,EAAQ,IAAI,CAAM,EAErC,IAAK,IAAM,KAAO,EACX,EAAW,IAAI,CAAG,GAAG,EAAQ,KAAK,CAAE,MAAK,QAAO,CAAC,EAGxD,IAAK,IAAM,KAAO,EACX,EAAS,IAAI,CAAG,GAAG,EAAM,KAAK,CAAE,MAAK,QAAO,CAAC,CAEtD,CAEA,MAAO,CAAE,QAAO,SAAQ,CAC1B"}

package/dist/validate.js

@@ -1,46 +1,2 @@
-import { compileCatalog as e, isPluralMessage as t } from "./_catalog.js";
-import { canonicalLocale as n } from "./_locale.js";
-//#region src/validate.ts
-function r(r, i) {
-	e(r);
-	let a = n(i), o = new Intl.PluralRules(a).resolvedOptions().pluralCategories, s = [], c = (e, n) => {
-		if (typeof e != "string") {
-			if (t(e)) {
-				for (let t of o) Object.hasOwn(e.plural, t) || s.push({
-					key: n,
-					locale: a,
-					missing: t
-				});
-				return;
-			}
-			for (let [t, r] of Object.entries(e)) c(r, n ? `${n}.${t}` : t);
-		}
-	};
-	for (let [e, t] of Object.entries(r)) c(t, e);
-	return s;
-}
-function i(t) {
-	let n = Object.keys(t), r = /* @__PURE__ */ new Map(), i = [], a = [];
-	for (let i of n) r.set(i, new Set(e(t[i]).keys()));
-	let o = n[0], s = r.get(o);
-	for (let e of n) {
-		if (e === o) continue;
-		let t = r.get(e);
-		for (let n of s) t.has(n) || i.push({
-			key: n,
-			locale: e
-		});
-		for (let n of t) s.has(n) || a.push({
-			key: n,
-			locale: e
-		});
-	}
-	return {
-		extra: a,
-		missing: i
-	};
-}
-//#endregion
-export { i as compareCatalogs, r as validateCatalog };
-
+import{compileCatalog as e,isPluralMessage as t}from"./_catalog.js";import{canonicalLocale as n}from"./_locale.js";function validateCatalog(r,i){e(r);let a=n(i),o=new Intl.PluralRules(a).resolvedOptions().pluralCategories,s=[],visit=(e,n)=>{if(typeof e!=`string`){if(t(e)){for(let t of o)Object.hasOwn(e.plural,t)||s.push({key:n,locale:a,missing:t});return}for(let[t,r]of Object.entries(e))visit(r,n?`${n}.${t}`:t)}};for(let[e,t]of Object.entries(r))visit(t,e);return s}function compareCatalogs(t){let n=Object.keys(t),r=new Map,i=[],a=[];for(let i of n)r.set(i,new Set(e(t[i]).keys()));let o=n[0],s=r.get(o);for(let e of n){if(e===o)continue;let t=r.get(e);for(let n of s)t.has(n)||i.push({key:n,locale:e});for(let n of t)s.has(n)||a.push({key:n,locale:e})}return{extra:a,missing:i}}export{compareCatalogs,validateCatalog};
 //# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","names":[],"sources":["../src/validate.ts"],"sourcesContent":["import { compileCatalog, isPluralMessage } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport type { Catalog, CatalogNode, Catalogs, Locale } from './types';\n\nexport type ValidationIssue = {\n  key: string;\n  locale: Locale;\n  missing: Intl.LDMLPluralRule;\n};\n\nexport type CatalogComparison = {\n  readonly missing: ReadonlyArray<{ key: string; locale: Locale }>;\n  readonly extra: ReadonlyArray<{ key: string; locale: Locale }>;\n};\n\n/** Explicit tooling API. Runtime never loads validation code or emits asynchronous catalog warnings. */\nexport function validateCatalog(catalog: Catalog, locale: Locale): ValidationIssue[] {\n  compileCatalog(catalog);\n\n  const canonical = canonicalLocale(locale);\n  const categories = new Intl.PluralRules(canonical).resolvedOptions().pluralCategories;\n  const issues: ValidationIssue[] = [];\n\n  const visit = (node: CatalogNode, key: string): void => {\n    if (typeof node === 'string') return;\n\n    if (isPluralMessage(node)) {\n      for (const missing of categories) {\n        if (!Object.hasOwn(node.plural, missing)) issues.push({ key, locale: canonical, missing });\n      }\n\n      return;\n    }\n\n    for (const [childKey, child] of Object.entries(node)) visit(child, key ? `${key}.${childKey}` : childKey);\n  };\n\n  for (const [key, node] of Object.entries(catalog)) visit(node, key);\n\n  return issues;\n}\n\n/** Compares catalog key sets across locales. Reports keys missing in each target locale and keys present in targets but absent from the base. */\nexport function compareCatalogs<C extends Catalog>(catalogs: Catalogs<C>): CatalogComparison {\n  const locales = Object.keys(catalogs);\n  const keySets = new Map<Locale, Set<string>>();\n  const missing: Array<{ key: string; locale: Locale }> = [];\n  const extra: Array<{ key: string; locale: Locale }> = [];\n\n  for (const locale of locales) {\n    keySets.set(locale, new Set(compileCatalog(catalogs[locale]).keys()));\n  }\n\n  const base = locales[0];\n  const baseKeys = keySets.get(base)!;\n\n  for (const locale of locales) {\n    if (locale === base) continue;\n    const targetKeys = keySets.get(locale)!;\n\n    for (const key of baseKeys) {\n      if (!targetKeys.has(key)) missing.push({ key, locale });\n    }\n\n    for (const key of targetKeys) {\n      if (!baseKeys.has(key)) extra.push({ key, locale });\n    }\n  }\n\n  return { extra, missing };\n}\n"],"mappings":";;;AAgBA,SAAgB,EAAgB,GAAkB,GAAmC;CACnF,EAAe,CAAO;CAEtB,IAAM,IAAY,EAAgB,CAAM,GAClC,IAAa,IAAI,KAAK,YAAY,CAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC,kBAC/D,IAA4B,CAAC,GAE7B,KAAS,GAAmB,MAAsB;EAClD,WAAO,KAAS,UAEpB;OAAI,EAAgB,CAAI,GAAG;IACzB,KAAK,IAAM,KAAW,GACpB,AAAK,OAAO,OAAO,EAAK,QAAQ,CAAO,KAAG,EAAO,KAAK;KAAE;KAAK,QAAQ;KAAW;IAAQ,CAAC;IAG3F;GACF;GAEA,KAAK,IAAM,CAAC,GAAU,MAAU,OAAO,QAAQ,CAAI,GAAG,EAAM,GAAO,IAAM,GAAG,EAAI,GAAG,MAAa,CAAQ;EAFxG;CAGF;CAEA,KAAK,IAAM,CAAC,GAAK,MAAS,OAAO,QAAQ,CAAO,GAAG,EAAM,GAAM,CAAG;CAElE,OAAO;AACT;AAGA,SAAgB,EAAmC,GAA0C;CAC3F,IAAM,IAAU,OAAO,KAAK,CAAQ,GAC9B,oBAAU,IAAI,IAAyB,GACvC,IAAkD,CAAC,GACnD,IAAgD,CAAC;CAEvD,KAAK,IAAM,KAAU,GACnB,EAAQ,IAAI,GAAQ,IAAI,IAAI,EAAe,EAAS,EAAO,CAAC,CAAC,KAAK,CAAC,CAAC;CAGtE,IAAM,IAAO,EAAQ,IACf,IAAW,EAAQ,IAAI,CAAI;CAEjC,KAAK,IAAM,KAAU,GAAS;EAC5B,IAAI,MAAW,GAAM;EACrB,IAAM,IAAa,EAAQ,IAAI,CAAM;EAErC,KAAK,IAAM,KAAO,GAChB,AAAK,EAAW,IAAI,CAAG,KAAG,EAAQ,KAAK;GAAE;GAAK;EAAO,CAAC;EAGxD,KAAK,IAAM,KAAO,GAChB,AAAK,EAAS,IAAI,CAAG,KAAG,EAAM,KAAK;GAAE;GAAK;EAAO,CAAC;CAEtD;CAEA,OAAO;EAAE;EAAO;CAAQ;AAC1B"}
+{"version":3,"file":"validate.js","names":[],"sources":["../src/validate.ts"],"sourcesContent":["import { compileCatalog, isPluralMessage } from './_catalog';\nimport { canonicalLocale } from './_locale';\nimport type { Catalog, CatalogNode, Catalogs, Locale } from './types';\n\nexport type ValidationIssue = {\n  key: string;\n  locale: Locale;\n  missing: Intl.LDMLPluralRule;\n};\n\nexport type CatalogComparison = {\n  readonly missing: ReadonlyArray<{ key: string; locale: Locale }>;\n  readonly extra: ReadonlyArray<{ key: string; locale: Locale }>;\n};\n\n/** Explicit tooling API. Runtime never loads validation code or emits asynchronous catalog warnings. */\nexport function validateCatalog(catalog: Catalog, locale: Locale): ValidationIssue[] {\n  compileCatalog(catalog);\n\n  const canonical = canonicalLocale(locale);\n  const categories = new Intl.PluralRules(canonical).resolvedOptions().pluralCategories;\n  const issues: ValidationIssue[] = [];\n\n  const visit = (node: CatalogNode, key: string): void => {\n    if (typeof node === 'string') return;\n\n    if (isPluralMessage(node)) {\n      for (const missing of categories) {\n        if (!Object.hasOwn(node.plural, missing)) issues.push({ key, locale: canonical, missing });\n      }\n\n      return;\n    }\n\n    for (const [childKey, child] of Object.entries(node)) visit(child, key ? `${key}.${childKey}` : childKey);\n  };\n\n  for (const [key, node] of Object.entries(catalog)) visit(node, key);\n\n  return issues;\n}\n\n/** Compares catalog key sets across locales. Reports keys missing in each target locale and keys present in targets but absent from the base. */\nexport function compareCatalogs<C extends Catalog>(catalogs: Catalogs<C>): CatalogComparison {\n  const locales = Object.keys(catalogs);\n  const keySets = new Map<Locale, Set<string>>();\n  const missing: Array<{ key: string; locale: Locale }> = [];\n  const extra: Array<{ key: string; locale: Locale }> = [];\n\n  for (const locale of locales) {\n    keySets.set(locale, new Set(compileCatalog(catalogs[locale]).keys()));\n  }\n\n  const base = locales[0];\n  const baseKeys = keySets.get(base)!;\n\n  for (const locale of locales) {\n    if (locale === base) continue;\n    const targetKeys = keySets.get(locale)!;\n\n    for (const key of baseKeys) {\n      if (!targetKeys.has(key)) missing.push({ key, locale });\n    }\n\n    for (const key of targetKeys) {\n      if (!baseKeys.has(key)) extra.push({ key, locale });\n    }\n  }\n\n  return { extra, missing };\n}\n"],"mappings":"mHAgBA,SAAgB,gBAAgB,EAAkB,EAAmC,CACnF,EAAe,CAAO,EAEtB,IAAM,EAAY,EAAgB,CAAM,EAClC,EAAa,IAAI,KAAK,YAAY,CAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC,iBAC/D,EAA4B,CAAC,EAE7B,OAAS,EAAmB,IAAsB,CAClD,UAAO,GAAS,SAEpB,IAAI,EAAgB,CAAI,EAAG,CACzB,IAAK,IAAM,KAAW,EACf,OAAO,OAAO,EAAK,OAAQ,CAAO,GAAG,EAAO,KAAK,CAAE,MAAK,OAAQ,EAAW,SAAQ,CAAC,EAG3F,MACF,CAEA,IAAK,GAAM,CAAC,EAAU,KAAU,OAAO,QAAQ,CAAI,EAAG,MAAM,EAAO,EAAM,GAAG,EAAI,GAAG,IAAa,CAAQ,CAFxG,CAGF,EAEA,IAAK,GAAM,CAAC,EAAK,KAAS,OAAO,QAAQ,CAAO,EAAG,MAAM,EAAM,CAAG,EAElE,OAAO,CACT,CAGA,SAAgB,gBAAmC,EAA0C,CAC3F,IAAM,EAAU,OAAO,KAAK,CAAQ,EAC9B,EAAU,IAAI,IACd,EAAkD,CAAC,EACnD,EAAgD,CAAC,EAEvD,IAAK,IAAM,KAAU,EACnB,EAAQ,IAAI,EAAQ,IAAI,IAAI,EAAe,EAAS,EAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAGtE,IAAM,EAAO,EAAQ,GACf,EAAW,EAAQ,IAAI,CAAI,EAEjC,IAAK,IAAM,KAAU,EAAS,CAC5B,GAAI,IAAW,EAAM,SACrB,IAAM,EAAa,EAAQ,IAAI,CAAM,EAErC,IAAK,IAAM,KAAO,EACX,EAAW,IAAI,CAAG,GAAG,EAAQ,KAAK,CAAE,MAAK,QAAO,CAAC,EAGxD,IAAK,IAAM,KAAO,EACX,EAAS,IAAI,CAAG,GAAG,EAAM,KAAK,CAAE,MAAK,QAAO,CAAC,CAEtD,CAEA,MAAO,CAAE,QAAO,SAAQ,CAC1B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vielzeug/lingua",
-  "version": "3.0.0",
-  "description": "Explicit typed localization with pluralization, lazy locale loading, and SSR hydration",
+  "version": "26.10.0",
+  "description": "Typed i18n with pluralization and lazy locale loading",
   "repository": {
     "type": "git",
     "url": "https://github.com/helmuthdu/vielzeug",
@@ -28,6 +28,11 @@
       "require": "./dist/format.cjs",
       "types": "./dist/format.d.ts"
     },
+    "./ripple": {
+      "import": "./dist/ripple.js",
+      "require": "./dist/ripple.cjs",
+      "types": "./dist/ripple.d.ts"
+    },
     "./validate": {
       "import": "./dist/validate.js",
       "require": "./dist/validate.cjs",
@@ -39,6 +44,9 @@
       "format": [
         "dist/format.d.ts"
       ],
+      "ripple": [
+        "dist/ripple.d.ts"
+      ],
       "validate": [
         "dist/validate.d.ts"
       ]
@@ -61,10 +69,19 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "verify:exports": "node ./scripts/verify-exports.mjs"
   },
+  "peerDependencies": {
+    "@vielzeug/ripple": "^26.10.0"
+  },
+  "peerDependenciesMeta": {
+    "@vielzeug/ripple": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@types/node": "^26.4.1",
+    "@types/node": "^26.6.2",
+    "@vielzeug/ripple": "26.10.0",
     "typescript": "^6.0.3",
-    "vite": "^8.2.2",
-    "vitest": "^5.0.0"
+    "vite": "^8.3.0",
+    "vitest": "^5.0.1"
   }
 }