@vielzeug/lingua 1.1.3 → 2.0.0

package/dist/i18n-types.d.ts

@@ -1,250 +0,0 @@
-import type { Messages } from './_catalog';
-import type { LocaleSource } from './_catalog-store';
-import type { NamespaceFactory } from './_namespace-store';
-import type { Formatter } from './format';
-export type Locale = string;
-export type Unsubscribe = () => void;
-export type { Messages } from './_catalog';
-export type { Loader, LocaleSource } from './_catalog-store';
-export type { NamespaceFactory } from './_namespace-store';
-export type TranslateVars = Record<string, unknown>;
-/**
- * A snapshot of the i18n instance state at a point in time.
- * Object identity changes on every observable change (locale switch, catalog load).
- * `t` and `tp` are bound to the locale captured in this snapshot.
- */
-export type I18nSnapshot = {
-    readonly locale: Locale;
-    /** @security Returns raw, unsanitized strings. Sanitize before `innerHTML` insertion. */
-    readonly t: (key: string, vars?: TranslateVars) => string;
-    readonly tp: (key: string, count: number, options?: TpOptions) => string;
-};
-/** Shape of the serialised state produced by `serializeI18n()`. Pass to `hydrateI18n()` on the client. */
-export type I18nState = {
-    readonly catalogs: Record<Locale, Record<string, string>>;
-    readonly locale: Locale;
-};
-export type SubscribeOptions = {
-    immediate?: boolean;
-    /** AbortSignal — automatically unsubscribes when the signal is aborted. */
-    signal?: AbortSignal;
-};
-export type TpOptions = {
-    /** Use ordinal plural rules (1st, 2nd, 3rd) instead of cardinal (default: `false`). */
-    ordinal?: boolean;
-    /** Inject additional interpolation variables alongside the automatically injected `count`. */
-    vars?: TranslateVars;
-};
-export type ScopedI18n = {
-    /** Intl formatter inherited from the parent instance. Follows locale changes automatically. */
-    readonly fmt: Formatter;
-    has(key: string): boolean;
-    t(key: string, vars?: TranslateVars): string;
-    tp(key: string, count: number, options?: TpOptions): string;
-};
-type Depth = [never, 0, 1, 2, 3, 4, 5, 6];
-export type MessageLeafKeys<T, P extends string = '', D extends number = 7> = [D] extends [0] ? never : T extends string ? P : T extends Record<string, unknown> ? {
-    [K in string & keyof T]: MessageLeafKeys<T[K], P extends '' ? K : `${P}.${K}`, Depth[D]>;
-}[string & keyof T] : never;
-export type MessageBranchKeys<T, P extends string = '', D extends number = 7> = [D] extends [0] ? never : T extends Record<string, unknown> ? {
-    [K in string & keyof T]: T[K] extends string ? never : (P extends '' ? K : `${P}.${K}`) | MessageBranchKeys<T[K], P extends '' ? K : `${P}.${K}`, Depth[D]>;
-}[string & keyof T] : never;
-export type I18nOptions<M extends Messages = Messages> = {
-    /** Locale registry. Values can be static message objects or async loaders. */
-    catalogs?: Record<Locale, LocaleSource<M>>;
-    /** Locale(s) to search when the active locale is missing a key. Subtags are expanded automatically (e.g. `en-US` → `en`). */
-    fallback?: Locale | Locale[];
-    /** Initial active locale. Defaults to `"en"`. Canonicalized via `Intl.getCanonicalLocales`. */
-    locale?: Locale;
-    /**
-     * Called when a translation key is missing.
-     * Defaults to returning the key string.
-     *
-     * @security The default handler returns `key` verbatim. Do not render the return value as HTML
-     * if keys are constructed from untrusted user input.
-     */
-    onMissingKey?: (key: string, locale: Locale) => string;
-    /**
-     * Called when an interpolation variable is missing.
-     * Defaults to returning `{varName}`.
-     */
-    onMissingVar?: (varName: string, key: string, locale: Locale) => string;
-    /**
-     * Called when a subscriber callback throws. Defaults to `console.error`.
-     * Override in production to route errors to a structured logger rather than the browser console.
-     */
-    onSubscriberError?: (error: unknown) => void;
-};
-export type I18n<M extends Messages = Messages> = {
-    /** Delegates to `dispose()`. Enables `using` declarations. */
-    [Symbol.dispose](): void;
-    /** `AbortSignal` aborted when `dispose()` is called. Use to tie external lifetimes to this instance. */
-    readonly disposalSignal: AbortSignal;
-    /**
-     * Disposes this i18n instance: removes all subscribers and clears catalog, loader, and namespace state.
-     * After disposal, all mutation methods throw `LinguaDisposedError` and translation methods
-     * fall back to `onMissingKey` for every key. Idempotent.
-     */
-    dispose(): void;
-    /** `true` after `dispose()` has been called. */
-    readonly disposed: boolean;
-    /**
-     * Registers a namespace factory and immediately starts loading it for the given locale
-     * (defaults to the active locale). Deduplicates concurrent and repeated calls.
-     *
-     * @remarks
-     * Call `registerNamespace()` first if you only want to register without loading.
-     * `extend()` is a convenience that does both in one call.
-     *
-     * @throws `LinguaDisposedError` if called on a disposed instance.
-     *
-     * @example
-     * await i18n.extend('settings', (locale) =>
-     *   import(`./locales/${locale}/settings.json`).then((m) => m.default),
-     * );
-     */
-    extend(ns: string, factory: NamespaceFactory, locale?: Locale): Promise<void>;
-    /** Intl formatter bound to this instance's locale. Follows locale changes automatically. */
-    readonly fmt: Formatter;
-    /**
-     * Creates a derived instance that inherits the current catalog snapshot, loaders,
-     * namespace registry, and loaded-namespace markers, but has its own locale, fallback chain,
-     * and subscribers. Catalog mutations on the fork do not affect the parent.
-     *
-     * Resolved catalog entries are shared by reference (no template re-compilation), making
-     * `fork()` cheap for SSR fork-per-request patterns with large catalogs.
-     *
-     * @example
-     * // SSR: per-request locale without touching the shared instance
-     * const reqI18n = i18n.fork({ locale: req.locale });
-     */
-    fork(overrides?: Omit<I18nOptions<M>, 'catalogs'>): I18n<M>;
-    /** Returns the current snapshot. Object identity changes on every observable change. */
-    getSnapshot(): I18nSnapshot;
-    /**
-     * Extracts a serializable snapshot of all loaded catalogs and the active locale.
-     * Pass the result to `hydrateI18n()` on the client.
-     *
-     * **Warning:** Only fully resolved catalogs are included. Loader-only locales not yet
-     * preloaded are omitted. Use `i18n.isLoaded(locale)` to verify before calling.
-     *
-     * **Warning:** The namespace registry is **not** serialized — factory functions cannot
-     * be converted to JSON. After `hydrateI18n()`, call `extend()` again for each namespace
-     * before relying on namespace-patched keys.
-     */
-    getState(): I18nState;
-    /**
-     * Returns all registered locales.
-     * - Default (no argument): locales in registration order.
-     * - `getSupportedLocales(true)`: sorted in ascending code-point order.
-     */
-    getSupportedLocales(sorted?: boolean): Locale[];
-    /**
-     * Returns `true` if the given key exists in the active fallback chain — either as a leaf
-     * string key or as a plural branch (any key under `key.` prefix).
-     *
-     * @example
-     * i18n.has('inbox')       // true for leaf or pipe-plural expanded branch
-     * i18n.has('inbox.one')   // true for explicit sub-key
-     */
-    has(key: MessageLeafKeys<M> | MessageBranchKeys<M> | (string & {})): boolean;
-    /**
-     * Returns `true` if the catalog for `locale` is fully resolved.
-     * Returns `false` for locales registered as async loaders not yet preloaded, and for unknown locales.
-     */
-    isLoaded(locale: Locale): boolean;
-    /**
-     * Returns `true` if the namespace has been fully loaded for the given locale.
-     * Returns `false` if it is not registered or not yet loaded for this locale.
-     */
-    isNamespaceLoaded(ns: string, locale?: Locale): boolean;
-    /**
-     * Returns `true` if a namespace factory is registered under the given name.
-     */
-    isNamespaceRegistered(ns: string): boolean;
-    /**
-     * Returns `true` if `locale` is in the known locale registry — either resolved or pending loader.
-     * Returns `false` for locales that have never been registered.
-     */
-    isRegistered(locale: Locale): boolean;
-    /**
-     * Loads a previously registered namespace for the given locale (defaults to the active locale).
-     * Deduplicates concurrent and repeated calls.
-     *
-     * @throws `LinguaNamespaceMissingError` if the namespace has not been registered with `registerNamespace()` first.
-     * @throws `LinguaDisposedError` if called on a disposed instance.
-     */
-    loadNamespace(ns: string, locale?: Locale): Promise<void>;
-    readonly locale: Locale;
-    preload(locale: Locale): Promise<void>;
-    /**
-     * Registers (or replaces) a locale source. If the source is an async loader, it is loaded
-     * immediately and this method returns a Promise that resolves when the load is complete.
-     * If the source is a static message object, it is synchronously registered and the returned
-     * Promise resolves immediately.
-     *
-     * @throws `LinguaDisposedError` if called on a disposed instance.
-     */
-    register(locale: Locale, source: LocaleSource<M>): Promise<void>;
-    /**
-     * Registers a namespace factory without loading it. Use `loadNamespace()` to trigger loading,
-     * or use `extend()` to register and load in one call.
-     *
-     * @remarks
-     * Re-registering a namespace updates the factory for future loads but does **not** reload
-     * the namespace if it is already loaded. The new factory takes effect the next time the
-     * namespace marker is cleared (by a `register()` or `restoreState()` call).
-     *
-     * @throws `LinguaDisposedError` if called on a disposed instance.
-     */
-    registerNamespace(ns: string, factory: NamespaceFactory): void;
-    /**
-     * Hydrates this instance with pre-loaded state (e.g. from a server-rendered payload).
-     *
-     * @remarks The namespace registry is **not** included in `I18nState`. After restoring,
-     * call `extend()` for each namespace before relying on namespace-patched keys.
-     *
-     * @throws `LinguaDisposedError` if called on a disposed instance.
-     * @throws `LinguaRestoreError` if the state's locale has no catalog.
-     */
-    restoreState(state: I18nState): void;
-    /**
-     * Returns a scoped translator. All `t()` / `tp()` calls are automatically prefixed with `${prefix}.`.
-     * The returned object is memoized — calling `scope(prefix)` with the same string always returns the
-     * same reference.
-     *
-     * @example
-     * const nav = i18n.scope('nav');
-     * nav.t('home');      // i18n.t('nav.home')
-     * nav.tp('items', 3); // i18n.tp('nav.items', 3)
-     */
-    scope(prefix: MessageBranchKeys<M> | (string & {})): ScopedI18n;
-    /**
-     * Switches the active locale. Loads the locale if it is registered as an async loader.
-     * Last concurrent call wins; stale responses are discarded.
-     * If loading fails, the active locale is unchanged.
-     *
-     * @throws `LinguaMissingLocaleError` if the locale is not registered.
-     * @throws `LinguaDisposedError` if called on a disposed instance.
-     */
-    setLocale(locale: Locale): Promise<void>;
-    /**
-     * Subscribes to locale/catalog changes.
-     * - `{ immediate: true }`: fires immediately and on every change.
-     * - `{ signal }`: unsubscribes when the AbortSignal fires.
-     *
-     * @throws `LinguaDisposedError` if called on a disposed instance.
-     */
-    subscribe(callback: (snapshot: I18nSnapshot) => void, options?: SubscribeOptions): Unsubscribe;
-    /** @security Returns raw, unsanitized strings. Sanitize before `innerHTML` insertion. */
-    t(key: MessageLeafKeys<M> | (string & {}), vars?: TranslateVars): string;
-    /**
-     * Translates a plural branch key. `count` is injected automatically.
-     *
-     * @throws `LinguaInvalidCountError` if `count` is not finite.
-     * @throws `LinguaCountInVarsError` if `options.vars.count` is set.
-     * @security Returns raw, unsanitized strings.
-     */
-    tp(key: MessageBranchKeys<M> | (string & {}), count: number, options?: TpOptions): string;
-};
-//# sourceMappingURL=i18n-types.d.ts.map

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

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

package/dist/template.cjs

@@ -1,2 +0,0 @@
-const e=require("./_dev.cjs");var t={2:[`one`,`other`],3:[`zero`,`one`,`other`],6:[`zero`,`one`,`two`,`few`,`many`,`other`]};function n(n){if(n.indexOf(`|`)===-1)return null;let r=n.split(`|`),i=t[r.length];if(!i)return e.warn(`Pipe-plural shorthand with ${r.length} parts is not recognized (valid counts: 2, 3, 6). Treating as a plain string: "${n.slice(0,60)}${n.length>60?`…`:``}"`),null;if(r.some(e=>e.trim()===``))return null;let a={};for(let e=0;e<r.length;e++)a[i[e]]=r[e];return a}var r=/\{([\p{ID_Continue}-]+)\}/gu;function i(e){let t=[],n=0;for(let i of e.matchAll(r)){let{index:r}=i,a=r??0;a>n&&t.push(e.slice(n,a)),t.push({var:i[1]}),n=a+i[0].length}return n<e.length&&t.push(e.slice(n)),t}function a(e,t,n,r,i){let a=``;for(let o of e)if(typeof o==`string`)a+=o;else{let e=t?.[o.var];a+=e==null?i(o.var,n,r):String(e)}return a}exports.INTERPOLATION_PATTERN=r,exports.compileTemplate=i,exports.parsePipePlural=n,exports.renderTemplate=a;
-//# sourceMappingURL=template.cjs.map

package/dist/template.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.cjs","names":[],"sources":["../src/template.ts"],"sourcesContent":["// ─── Template helpers ─────────────────────────────────────────────────────────\n// Shared by i18n.ts — extracted for navigability. Not part of the public API.\n\nimport { warn } from './_dev';\n\ntype Locale = string;\ntype TranslateVars = Record<string, unknown>;\n\ninterface Messages {\n  [key: string]: string | Messages;\n}\n\n// ─── Pipe-plural shorthand (F1) ───────────────────────────────────────────────\n// A leaf string containing '|' is parsed as a pipe-delimited plural shorthand.\n// Supported part counts and their form mappings (positional, left-to-right):\n//   2 parts → one | other\n//   3 parts → zero | one | other\n//   6 parts → zero | one | two | few | many | other\n// Any other part count is treated as a plain string with no expansion.\n\nconst PIPE_FORM_MAPS: Readonly<Partial<Record<number, readonly string[]>>> = {\n  2: ['one', 'other'],\n  3: ['zero', 'one', 'other'],\n  6: ['zero', 'one', 'two', 'few', 'many', 'other'],\n};\n\nexport function parsePipePlural(value: string): Messages | null {\n  const pipeIdx = value.indexOf('|');\n\n  if (pipeIdx === -1) return null;\n\n  const parts = value.split('|');\n  const forms = PIPE_FORM_MAPS[parts.length];\n\n  if (!forms) {\n    warn(\n      `Pipe-plural shorthand with ${parts.length} parts is not recognized (valid counts: 2, 3, 6). Treating as a plain string: \"${value.slice(0, 60)}${value.length > 60 ? '…' : ''}\"`,\n    );\n\n    return null;\n  }\n\n  // An empty part is almost certainly a catalog authoring error.\n  // Treat the whole value as a plain string rather than silently producing an empty form.\n  if (parts.some((p) => p.trim() === '')) return null;\n\n  const result: Messages = {};\n\n  for (let i = 0; i < parts.length; i++) {\n    result[forms[i]] = parts[i];\n  }\n\n  return result;\n}\n\n// ─── Template compilation ─────────────────────────────────────────────────────\n// Message strings are parsed once at registration time into a pre-compiled form:\n// an array of static strings and variable names. Rendering a compiled template\n// skips the regex entirely.\n\ntype TemplatePart = string | { var: string };\nexport type CompiledTemplate = TemplatePart[];\n\nexport const INTERPOLATION_PATTERN = /\\{([\\p{ID_Continue}-]+)\\}/gu;\n\nexport function compileTemplate(template: string): CompiledTemplate {\n  const parts: CompiledTemplate = [];\n  let lastIndex = 0;\n\n  for (const match of template.matchAll(INTERPOLATION_PATTERN)) {\n    const { index } = match;\n    const start = index ?? 0;\n\n    if (start > lastIndex) {\n      parts.push(template.slice(lastIndex, start));\n    }\n\n    parts.push({ var: match[1] });\n    lastIndex = start + match[0].length;\n  }\n\n  if (lastIndex < template.length) {\n    parts.push(template.slice(lastIndex));\n  }\n\n  return parts;\n}\n\nexport function renderTemplate(\n  parts: CompiledTemplate,\n  vars: TranslateVars | undefined,\n  key: string,\n  locale: Locale,\n  onMissingVar: (varName: string, key: string, locale: Locale) => string,\n): string {\n  let result = '';\n\n  for (const part of parts) {\n    if (typeof part === 'string') {\n      result += part;\n    } else {\n      const value = vars?.[part.var];\n\n      result += value == null ? onMissingVar(part.var, key, locale) : String(value);\n    }\n  }\n\n  return result;\n}\n"],"mappings":"8BAoBA,IAAM,EAAuE,CAC3E,EAAG,CAAC,MAAO,OAAO,EAClB,EAAG,CAAC,OAAQ,MAAO,OAAO,EAC1B,EAAG,CAAC,OAAQ,MAAO,MAAO,MAAO,OAAQ,OAAO,CAClD,EAEA,SAAgB,EAAgB,EAAgC,CAG9D,GAFgB,EAAM,QAAQ,GAE1B,IAAY,GAAI,OAAO,KAE3B,IAAM,EAAQ,EAAM,MAAM,GAAG,EACvB,EAAQ,EAAe,EAAM,QAEnC,GAAI,CAAC,EAKH,OAJA,EAAA,KACE,8BAA8B,EAAM,OAAO,iFAAiF,EAAM,MAAM,EAAG,EAAE,IAAI,EAAM,OAAS,GAAK,IAAM,GAAG,EAChL,EAEO,KAKT,GAAI,EAAM,KAAM,GAAM,EAAE,KAAK,IAAM,EAAE,EAAG,OAAO,KAE/C,IAAM,EAAmB,CAAC,EAE1B,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,OAAQ,IAChC,EAAO,EAAM,IAAM,EAAM,GAG3B,OAAO,CACT,CAUA,IAAa,EAAwB,8BAErC,SAAgB,EAAgB,EAAoC,CAClE,IAAM,EAA0B,CAAC,EAC7B,EAAY,EAEhB,IAAK,IAAM,KAAS,EAAS,SAAS,CAAqB,EAAG,CAC5D,GAAM,CAAE,SAAU,EACZ,EAAQ,GAAS,EAEnB,EAAQ,GACV,EAAM,KAAK,EAAS,MAAM,EAAW,CAAK,CAAC,EAG7C,EAAM,KAAK,CAAE,IAAK,EAAM,EAAG,CAAC,EAC5B,EAAY,EAAQ,EAAM,EAAE,CAAC,MAC/B,CAMA,OAJI,EAAY,EAAS,QACvB,EAAM,KAAK,EAAS,MAAM,CAAS,CAAC,EAG/B,CACT,CAEA,SAAgB,EACd,EACA,EACA,EACA,EACA,EACQ,CACR,IAAI,EAAS,GAEb,IAAK,IAAM,KAAQ,EACjB,GAAI,OAAO,GAAS,SAClB,GAAU,MACL,CACL,IAAM,EAAQ,IAAO,EAAK,KAE1B,GAAU,GAAS,KAAO,EAAa,EAAK,IAAK,EAAK,CAAM,EAAI,OAAO,CAAK,CAC9E,CAGF,OAAO,CACT"}

package/dist/template.d.ts

@@ -1,15 +0,0 @@
-type Locale = string;
-type TranslateVars = Record<string, unknown>;
-interface Messages {
-    [key: string]: string | Messages;
-}
-export declare function parsePipePlural(value: string): Messages | null;
-type TemplatePart = string | {
-    var: string;
-};
-export type CompiledTemplate = TemplatePart[];
-export declare const INTERPOLATION_PATTERN: RegExp;
-export declare function compileTemplate(template: string): CompiledTemplate;
-export declare function renderTemplate(parts: CompiledTemplate, vars: TranslateVars | undefined, key: string, locale: Locale, onMissingVar: (varName: string, key: string, locale: Locale) => string): string;
-export {};
-//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAKA,KAAK,MAAM,GAAG,MAAM,CAAC;AACrB,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,UAAU,QAAQ;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAClC;AAgBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CA2B9D;AAOD,KAAK,YAAY,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7C,MAAM,MAAM,gBAAgB,GAAG,YAAY,EAAE,CAAC;AAE9C,eAAO,MAAM,qBAAqB,QAAgC,CAAC;AAEnE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAqBlE;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GACrE,MAAM,CAcR"}

package/dist/template.js

@@ -1,49 +0,0 @@
-import { warn as e } from "./_dev.js";
-//#region src/template.ts
-var t = {
-	2: ["one", "other"],
-	3: [
-		"zero",
-		"one",
-		"other"
-	],
-	6: [
-		"zero",
-		"one",
-		"two",
-		"few",
-		"many",
-		"other"
-	]
-};
-function n(n) {
-	if (n.indexOf("|") === -1) return null;
-	let r = n.split("|"), i = t[r.length];
-	if (!i) return e(`Pipe-plural shorthand with ${r.length} parts is not recognized (valid counts: 2, 3, 6). Treating as a plain string: "${n.slice(0, 60)}${n.length > 60 ? "…" : ""}"`), null;
-	if (r.some((e) => e.trim() === "")) return null;
-	let a = {};
-	for (let e = 0; e < r.length; e++) a[i[e]] = r[e];
-	return a;
-}
-var r = /\{([\p{ID_Continue}-]+)\}/gu;
-function i(e) {
-	let t = [], n = 0;
-	for (let i of e.matchAll(r)) {
-		let { index: r } = i, a = r ?? 0;
-		a > n && t.push(e.slice(n, a)), t.push({ var: i[1] }), n = a + i[0].length;
-	}
-	return n < e.length && t.push(e.slice(n)), t;
-}
-function a(e, t, n, r, i) {
-	let a = "";
-	for (let o of e) if (typeof o == "string") a += o;
-	else {
-		let e = t?.[o.var];
-		a += e == null ? i(o.var, n, r) : String(e);
-	}
-	return a;
-}
-//#endregion
-export { r as INTERPOLATION_PATTERN, i as compileTemplate, n as parsePipePlural, a as renderTemplate };
-
-//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.js","names":[],"sources":["../src/template.ts"],"sourcesContent":["// ─── Template helpers ─────────────────────────────────────────────────────────\n// Shared by i18n.ts — extracted for navigability. Not part of the public API.\n\nimport { warn } from './_dev';\n\ntype Locale = string;\ntype TranslateVars = Record<string, unknown>;\n\ninterface Messages {\n  [key: string]: string | Messages;\n}\n\n// ─── Pipe-plural shorthand (F1) ───────────────────────────────────────────────\n// A leaf string containing '|' is parsed as a pipe-delimited plural shorthand.\n// Supported part counts and their form mappings (positional, left-to-right):\n//   2 parts → one | other\n//   3 parts → zero | one | other\n//   6 parts → zero | one | two | few | many | other\n// Any other part count is treated as a plain string with no expansion.\n\nconst PIPE_FORM_MAPS: Readonly<Partial<Record<number, readonly string[]>>> = {\n  2: ['one', 'other'],\n  3: ['zero', 'one', 'other'],\n  6: ['zero', 'one', 'two', 'few', 'many', 'other'],\n};\n\nexport function parsePipePlural(value: string): Messages | null {\n  const pipeIdx = value.indexOf('|');\n\n  if (pipeIdx === -1) return null;\n\n  const parts = value.split('|');\n  const forms = PIPE_FORM_MAPS[parts.length];\n\n  if (!forms) {\n    warn(\n      `Pipe-plural shorthand with ${parts.length} parts is not recognized (valid counts: 2, 3, 6). Treating as a plain string: \"${value.slice(0, 60)}${value.length > 60 ? '…' : ''}\"`,\n    );\n\n    return null;\n  }\n\n  // An empty part is almost certainly a catalog authoring error.\n  // Treat the whole value as a plain string rather than silently producing an empty form.\n  if (parts.some((p) => p.trim() === '')) return null;\n\n  const result: Messages = {};\n\n  for (let i = 0; i < parts.length; i++) {\n    result[forms[i]] = parts[i];\n  }\n\n  return result;\n}\n\n// ─── Template compilation ─────────────────────────────────────────────────────\n// Message strings are parsed once at registration time into a pre-compiled form:\n// an array of static strings and variable names. Rendering a compiled template\n// skips the regex entirely.\n\ntype TemplatePart = string | { var: string };\nexport type CompiledTemplate = TemplatePart[];\n\nexport const INTERPOLATION_PATTERN = /\\{([\\p{ID_Continue}-]+)\\}/gu;\n\nexport function compileTemplate(template: string): CompiledTemplate {\n  const parts: CompiledTemplate = [];\n  let lastIndex = 0;\n\n  for (const match of template.matchAll(INTERPOLATION_PATTERN)) {\n    const { index } = match;\n    const start = index ?? 0;\n\n    if (start > lastIndex) {\n      parts.push(template.slice(lastIndex, start));\n    }\n\n    parts.push({ var: match[1] });\n    lastIndex = start + match[0].length;\n  }\n\n  if (lastIndex < template.length) {\n    parts.push(template.slice(lastIndex));\n  }\n\n  return parts;\n}\n\nexport function renderTemplate(\n  parts: CompiledTemplate,\n  vars: TranslateVars | undefined,\n  key: string,\n  locale: Locale,\n  onMissingVar: (varName: string, key: string, locale: Locale) => string,\n): string {\n  let result = '';\n\n  for (const part of parts) {\n    if (typeof part === 'string') {\n      result += part;\n    } else {\n      const value = vars?.[part.var];\n\n      result += value == null ? onMissingVar(part.var, key, locale) : String(value);\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;AAoBA,IAAM,IAAuE;CAC3E,GAAG,CAAC,OAAO,OAAO;CAClB,GAAG;EAAC;EAAQ;EAAO;CAAO;CAC1B,GAAG;EAAC;EAAQ;EAAO;EAAO;EAAO;EAAQ;CAAO;AAClD;AAEA,SAAgB,EAAgB,GAAgC;CAG9D,IAFgB,EAAM,QAAQ,GAE1B,MAAY,IAAI,OAAO;CAE3B,IAAM,IAAQ,EAAM,MAAM,GAAG,GACvB,IAAQ,EAAe,EAAM;CAEnC,IAAI,CAAC,GAKH,OAJA,EACE,8BAA8B,EAAM,OAAO,iFAAiF,EAAM,MAAM,GAAG,EAAE,IAAI,EAAM,SAAS,KAAK,MAAM,GAAG,EAChL,GAEO;CAKT,IAAI,EAAM,MAAM,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO;CAE/C,IAAM,IAAmB,CAAC;CAE1B,KAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAChC,EAAO,EAAM,MAAM,EAAM;CAG3B,OAAO;AACT;AAUA,IAAa,IAAwB;AAErC,SAAgB,EAAgB,GAAoC;CAClE,IAAM,IAA0B,CAAC,GAC7B,IAAY;CAEhB,KAAK,IAAM,KAAS,EAAS,SAAS,CAAqB,GAAG;EAC5D,IAAM,EAAE,aAAU,GACZ,IAAQ,KAAS;EAOvB,AALI,IAAQ,KACV,EAAM,KAAK,EAAS,MAAM,GAAW,CAAK,CAAC,GAG7C,EAAM,KAAK,EAAE,KAAK,EAAM,GAAG,CAAC,GAC5B,IAAY,IAAQ,EAAM,EAAE,CAAC;CAC/B;CAMA,OAJI,IAAY,EAAS,UACvB,EAAM,KAAK,EAAS,MAAM,CAAS,CAAC,GAG/B;AACT;AAEA,SAAgB,EACd,GACA,GACA,GACA,GACA,GACQ;CACR,IAAI,IAAS;CAEb,KAAK,IAAM,KAAQ,GACjB,IAAI,OAAO,KAAS,UAClB,KAAU;MACL;EACL,IAAM,IAAQ,IAAO,EAAK;EAE1B,KAAU,KAAS,OAAO,EAAa,EAAK,KAAK,GAAK,CAAM,IAAI,OAAO,CAAK;CAC9E;CAGF,OAAO;AACT"}