@ngx-runtime-i18n/core 2.0.0 → 2.1.0

package/README.md

@@ -41,16 +41,16 @@ formatIcu('en', 'cart.items', catalog, { count: 2 }); // "2 items"
 
 ### `formatIcu(lang, key, catalog, params?, onMissingKey?)`
 
-- **`lang: string`** — current language (for plural rules and future features).
-- **`key: string`** — dotted path into the catalog.
-- **`catalog: Catalog`** — a nested object of strings/objects.
-- **`params?: Record<string, unknown>`** — interpolation values.
-- **`onMissingKey?: (key: string) => string`** — transform for missing keys (defaults to returning the key).
+- **`lang: string`**: current language (for plural rules and future features).
+- **`key: string`**: dotted path into the catalog.
+- **`catalog: Catalog`**: a nested object of strings/objects.
+- **`params?: Record<string, unknown>`**: interpolation values.
+- **`onMissingKey?: (key: string) => string`**: transform for missing keys (defaults to returning the key).
 
 ### Types
 
-- **`Catalog`** — `Record<string, unknown>` (nested object).
-- **`RuntimeI18nConfig`** — shape shared with the Angular wrapper for consistency.
+- **`Catalog`**: `Record<string, unknown>` (nested object).
+- **`RuntimeI18nConfig`**: shape shared with the Angular wrapper for consistency.
 
 ---
 
@@ -71,7 +71,7 @@ formatIcu('en', 'cart.items', catalog, { count: 2 }); // "2 items"
 
 - Not a full ICU implementation; aims to cover common 80% with a tiny footprint.
 - If you need Angular binding or SSR helpers, prefer `@ngx-runtime-i18n/angular`.
-- Keep your catalogs **flat-ish and predictable** to avoid fragile deep paths.
+- Keep your catalogs flat-ish and predictable to avoid fragile deep paths.
 
 ---
 

package/fesm2022/ngx-runtime-i18n-core.mjs

@@ -1,27 +1,13 @@
 // Tokens may include dots or hyphens so nested object keys like "user.name" are practical.
 const INTERPOLATION_PATTERN = /\{([a-zA-Z_][a-zA-Z0-9_.-]*)\}/g;
-function formatIcu(_lang, key, cat, params = {}, onMissingKey) {
+function formatIcu(_lang, key, cat, params = {}, onMissingKey, pluralResolver) {
     const raw = lookup(key, cat);
     if (raw == null)
         return onMissingKey ? onMissingKey(key) : key;
     let out = String(raw);
-    // 1) Resolve {x, plural, ...} with a brace-balanced scanner.
-    out = replacePluralBlocks(out, (arg, body) => {
-        const n = Number(params[arg] ?? 0);
-        const options = parsePluralBody(body);
-        if (Number.isFinite(n)) {
-            const exact = options[`=${n}`];
-            if (exact)
-                return exact;
-            const one = options['one'];
-            if (n === 1 && one)
-                return one;
-            const other = options['other'] ?? '';
-            return other.replace(/#/g, String(n));
-        }
-        return options['other'] ?? '';
-    });
-    // 2) Simple {name} interpolation AFTER plural branch selection.
+    // 1) Resolve {x, plural, ...}, {x, select, ...}, {x, selectordinal, ...} with a brace-balanced scanner.
+    out = replaceMessageBlocks(out, _lang, params, pluralResolver);
+    // 2) Simple {name} interpolation AFTER message block selection.
     INTERPOLATION_PATTERN.lastIndex = 0;
     out = out.replace(INTERPOLATION_PATTERN, (_m, p1) => params[p1] != null ? String(params[p1]) : `{${p1}}`);
     return out;
@@ -29,12 +15,14 @@ function formatIcu(_lang, key, cat, params = {}, onMissingKey) {
 function lookup(path, obj) {
     return path
         .split('.')
-        .reduce((o, k) => (o && k in o ? o[k] : undefined), obj);
+        .reduce((o, k) => o && typeof o === 'object' && Object.prototype.hasOwnProperty.call(o, k)
+        ? o[k]
+        : undefined, obj);
 }
 /**
- * Replace all `{arg, plural, ...}` blocks in `s` using a brace-balanced scan.
+ * Replace all `{arg, plural|select|selectordinal, ...}` blocks in `s` using a brace-balanced scan.
  */
-function replacePluralBlocks(s, render) {
+function replaceMessageBlocks(s, lang, params, pluralResolver) {
     let i = 0;
     let out = '';
     while (i < s.length) {
@@ -44,19 +32,20 @@ function replacePluralBlocks(s, render) {
             break;
         }
         out += s.slice(i, start);
-        // Try to match the prefix "{arg, plural,"
-        const prefixMatch = /\{(\w+),\s*plural,\s*/y;
+        // Try to match the prefix "{arg, plural|select|selectordinal,"
+        const prefixMatch = /\{(\w+),\s*(plural|select|selectordinal),\s*/y;
         prefixMatch.lastIndex = start;
         const m = prefixMatch.exec(s);
         if (!m) {
-            // Not a plural block; copy '{' and continue scanning after it.
+            // Not a message block; copy '{' and continue scanning after it.
             out += '{';
             i = start + 1;
             continue;
         }
         const arg = m[1];
+        const keyword = m[2];
         let j = prefixMatch.lastIndex; // position after the matched prefix
-        // Find the matching closing '}' for the whole plural block with nesting.
+        // Find the matching closing '}' for the whole block with nesting.
         let depth = 1;
         while (j < s.length && depth > 0) {
             const ch = s.charAt(j++);
@@ -73,42 +62,62 @@ function replacePluralBlocks(s, render) {
         }
         // Body is the contents between prefix end and the final '}'.
         const body = s.slice(prefixMatch.lastIndex, j - 1);
-        const rendered = render(arg, body);
-        out += rendered;
-        i = j; // continue after the closing brace
+        const options = parsePluralBody(body);
+        if (keyword === 'plural' || keyword === 'selectordinal') {
+            const n = Number(params[arg] ?? 0);
+            if (Number.isFinite(n)) {
+                const exact = options[`=${n}`];
+                if (exact != null) {
+                    out += replaceHash(replaceMessageBlocks(exact, lang, params, pluralResolver), n);
+                    i = j;
+                    continue;
+                }
+                const category = pluralResolver
+                    ? pluralResolver(n, lang)
+                    : n === 1 ? 'one' : 'other';
+                const match = options[category] ?? options['other'] ?? '';
+                out += replaceHash(replaceMessageBlocks(match, lang, params, pluralResolver), n);
+            }
+            else {
+                out += replaceHash(replaceMessageBlocks(options['other'] ?? '', lang, params, pluralResolver), Number(params[arg]));
+            }
+        }
+        else {
+            // select: look up param value directly, then resolve any nested keyword blocks
+            const val = String(params[arg] ?? 'other');
+            out += replaceMessageBlocks(options[val] ?? options['other'] ?? '', lang, params, pluralResolver);
+        }
+        i = j;
     }
     return out;
 }
+function replaceHash(s, n) {
+    return s.replace(/#/g, String(n));
+}
 /**
- * Parse a simple ICU plural clause body: e.g. `one {A} other {B} =0 {C}`.
- * Only literal selectors and balanced brace bodies are supported; nested plural/select forms are intentionally skipped.
+ * Parse a simple ICU plural/select clause body: e.g. `one {A} other {B} =0 {C}`.
+ * Supports balanced brace bodies and nested forms.
  */
 function parsePluralBody(body) {
     const map = {};
     let i = 0;
     while (i < body.length) {
         // Skip whitespace between selectors.
-        while (i < body.length && /\s/.test(body.charAt(i))) {
+        while (i < body.length && /\s/.test(body.charAt(i)))
             i++;
-        }
-        if (i >= body.length) {
+        if (i >= body.length)
             break;
-        }
         const keyStart = i;
-        while (i < body.length && !/\s|\{/.test(body.charAt(i))) {
+        while (i < body.length && !/[\s{]/.test(body.charAt(i)))
             i++;
-        }
-        if (keyStart === i) {
+        if (keyStart === i)
             break;
-        }
         const key = body.slice(keyStart, i);
         // Skip whitespace before the opening brace.
-        while (i < body.length && /\s/.test(body.charAt(i))) {
+        while (i < body.length && /\s/.test(body.charAt(i)))
             i++;
-        }
-        if (body.charAt(i) !== '{') {
+        if (body.charAt(i) !== '{')
             break;
-        }
         i++; // Consume '{'
         const valueStart = i;
         let depth = 1;
@@ -124,8 +133,7 @@ function parsePluralBody(body) {
             // Unbalanced braces (malformed plural); bail out to avoid infinite loops.
             break;
         }
-        const valueEnd = i - 1;
-        map[key] = body.slice(valueStart, valueEnd);
+        map[key] = body.slice(valueStart, i - 1);
     }
     return map;
 }

package/fesm2022/ngx-runtime-i18n-core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngx-runtime-i18n-core.mjs","sources":["../../../../libs/runtime-i18n/src/lib/icu.ts","../../../../libs/runtime-i18n/src/index.ts","../../../../libs/runtime-i18n/src/ngx-runtime-i18n-core.ts"],"sourcesContent":["/**\n * Very small ICU-like formatter with interpolation and plural basics.\n * Used by the Angular service and pipe. Replace with full ICU in a later minor.\n * @experimental\n */\nimport type { Catalog } from './types';\n\n// Tokens may include dots or hyphens so nested object keys like \"user.name\" are practical.\nconst INTERPOLATION_PATTERN = /\\{([a-zA-Z_][a-zA-Z0-9_.-]*)\\}/g;\n\nexport function formatIcu(\n  _lang: string,\n  key: string,\n  cat: Catalog,\n  params: Record<string, unknown> = {},\n  onMissingKey?: (k: string) => string\n): string {\n  const raw = lookup(key, cat);\n  if (raw == null) return onMissingKey ? onMissingKey(key) : key;\n\n  let out = String(raw);\n\n  // 1) Resolve {x, plural, ...} with a brace-balanced scanner.\n  out = replacePluralBlocks(out, (arg, body) => {\n    const n = Number(params[arg] ?? 0);\n    const options = parsePluralBody(body);\n    if (Number.isFinite(n)) {\n      const exact = options[`=${n}`];\n      if (exact) return exact;\n      const one = options['one'];\n      if (n === 1 && one) return one;\n      const other = options['other'] ?? '';\n      return other.replace(/#/g, String(n));\n    }\n    return options['other'] ?? '';\n  });\n\n  // 2) Simple {name} interpolation AFTER plural branch selection.\n  INTERPOLATION_PATTERN.lastIndex = 0;\n  out = out.replace(INTERPOLATION_PATTERN, (_m: string, p1: string) =>\n    params[p1] != null ? String(params[p1]) : `{${p1}}`\n  );\n\n  return out;\n}\n\nfunction lookup(path: string, obj: any): any {\n  return path\n    .split('.')\n    .reduce((o: any, k: string) => (o && k in o ? o[k] : undefined), obj);\n}\n\n/**\n * Replace all `{arg, plural, ...}` blocks in `s` using a brace-balanced scan.\n */\nfunction replacePluralBlocks(\n  s: string,\n  render: (arg: string, body: string) => string\n): string {\n  let i = 0;\n  let out = '';\n\n  while (i < s.length) {\n    const start = s.indexOf('{', i);\n    if (start === -1) {\n      out += s.slice(i);\n      break;\n    }\n    out += s.slice(i, start);\n\n    // Try to match the prefix \"{arg, plural,\"\n    const prefixMatch = /\\{(\\w+),\\s*plural,\\s*/y;\n    prefixMatch.lastIndex = start;\n    const m = prefixMatch.exec(s);\n    if (!m) {\n      // Not a plural block; copy '{' and continue scanning after it.\n      out += '{';\n      i = start + 1;\n      continue;\n    }\n\n    const arg = m[1];\n    let j = prefixMatch.lastIndex; // position after the matched prefix\n\n    // Find the matching closing '}' for the whole plural block with nesting.\n    let depth = 1;\n    while (j < s.length && depth > 0) {\n      const ch = s.charAt(j++);\n      if (ch === '{') depth++;\n      else if (ch === '}') depth--;\n    }\n\n    if (depth !== 0) {\n      // Unbalanced; fall back to literal copy of the unmatched segment.\n      out += s.slice(start, j);\n      i = j;\n      continue;\n    }\n\n    // Body is the contents between prefix end and the final '}'.\n    const body = s.slice(prefixMatch.lastIndex, j - 1);\n    const rendered = render(arg, body);\n    out += rendered;\n    i = j; // continue after the closing brace\n  }\n\n  return out;\n}\n\n/**\n * Parse a simple ICU plural clause body: e.g. `one {A} other {B} =0 {C}`.\n * Only literal selectors and balanced brace bodies are supported; nested plural/select forms are intentionally skipped.\n */\nfunction parsePluralBody(body: string): Record<string, string> {\n  const map: Record<string, string> = {};\n  let i = 0;\n\n  while (i < body.length) {\n    // Skip whitespace between selectors.\n    while (i < body.length && /\\s/.test(body.charAt(i))) {\n      i++;\n    }\n    if (i >= body.length) {\n      break;\n    }\n\n    const keyStart = i;\n    while (i < body.length && !/\\s|\\{/.test(body.charAt(i))) {\n      i++;\n    }\n    if (keyStart === i) {\n      break;\n    }\n    const key = body.slice(keyStart, i);\n\n    // Skip whitespace before the opening brace.\n    while (i < body.length && /\\s/.test(body.charAt(i))) {\n      i++;\n    }\n    if (body.charAt(i) !== '{') {\n      break;\n    }\n    i++; // Consume '{'\n\n    const valueStart = i;\n    let depth = 1;\n    // Consume until the matching closing brace; supports nested braces for placeholders.\n    while (i < body.length && depth > 0) {\n      const ch = body.charAt(i++);\n      if (ch === '{') depth++;\n      else if (ch === '}') depth--;\n    }\n    if (depth !== 0) {\n      // Unbalanced braces (malformed plural); bail out to avoid infinite loops.\n      break;\n    }\n\n    const valueEnd = i - 1;\n    map[key] = body.slice(valueStart, valueEnd);\n  }\n\n  return map;\n}\n","/**\n * @packageDocumentation\n * Core runtime i18n primitives.\n * Keep this surface minimal and stable.\n */\n\nexport type { Catalog, RuntimeI18nConfig } from './lib/types';\n\n/**\n * Lightweight ICU-style formatter used internally by the Angular service.\n * Exposed as @experimental for advanced users or custom integrations.\n * @experimental\n */\nexport { formatIcu } from './lib/icu';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ngx-runtime-i18n-core.mjs","sources":["../../../../libs/runtime-i18n/src/lib/icu.ts","../../../../libs/runtime-i18n/src/index.ts","../../../../libs/runtime-i18n/src/ngx-runtime-i18n-core.ts"],"sourcesContent":["/**\n * ICU-style formatter with interpolation, plural, select, and selectordinal support.\n * Used by the Angular service and pipe.\n * @experimental\n */\nimport type { Catalog, PluralCategory, PluralResolver } from './types';\n\n// Tokens may include dots or hyphens so nested object keys like \"user.name\" are practical.\nconst INTERPOLATION_PATTERN = /\\{([a-zA-Z_][a-zA-Z0-9_.-]*)\\}/g;\n\nexport function formatIcu(\n  _lang: string,\n  key: string,\n  cat: Catalog,\n  params: Record<string, unknown> = {},\n  onMissingKey?: (k: string) => string,\n  pluralResolver?: PluralResolver\n): string {\n  const raw = lookup(key, cat);\n  if (raw == null) return onMissingKey ? onMissingKey(key) : key;\n\n  let out = String(raw);\n\n  // 1) Resolve {x, plural, ...}, {x, select, ...}, {x, selectordinal, ...} with a brace-balanced scanner.\n  out = replaceMessageBlocks(out, _lang, params, pluralResolver);\n\n  // 2) Simple {name} interpolation AFTER message block selection.\n  INTERPOLATION_PATTERN.lastIndex = 0;\n  out = out.replace(INTERPOLATION_PATTERN, (_m: string, p1: string) =>\n    params[p1] != null ? String(params[p1]) : `{${p1}}`\n  );\n\n  return out;\n}\n\nfunction lookup(path: string, obj: unknown): unknown {\n  return path\n    .split('.')\n    .reduce((o: unknown, k: string) =>\n      o && typeof o === 'object' && Object.prototype.hasOwnProperty.call(o, k)\n        ? (o as Record<string, unknown>)[k]\n        : undefined,\n      obj);\n}\n\n/**\n * Replace all `{arg, plural|select|selectordinal, ...}` blocks in `s` using a brace-balanced scan.\n */\nfunction replaceMessageBlocks(\n  s: string,\n  lang: string,\n  params: Record<string, unknown>,\n  pluralResolver?: PluralResolver\n): string {\n  let i = 0;\n  let out = '';\n\n  while (i < s.length) {\n    const start = s.indexOf('{', i);\n    if (start === -1) { out += s.slice(i); break; }\n    out += s.slice(i, start);\n\n    // Try to match the prefix \"{arg, plural|select|selectordinal,\"\n    const prefixMatch = /\\{(\\w+),\\s*(plural|select|selectordinal),\\s*/y;\n    prefixMatch.lastIndex = start;\n    const m = prefixMatch.exec(s);\n    if (!m) {\n      // Not a message block; copy '{' and continue scanning after it.\n      out += '{';\n      i = start + 1;\n      continue;\n    }\n\n    const arg = m[1];\n    const keyword = m[2] as 'plural' | 'select' | 'selectordinal';\n    let j = prefixMatch.lastIndex; // position after the matched prefix\n\n    // Find the matching closing '}' for the whole block with nesting.\n    let depth = 1;\n    while (j < s.length && depth > 0) {\n      const ch = s.charAt(j++);\n      if (ch === '{') depth++;\n      else if (ch === '}') depth--;\n    }\n\n    if (depth !== 0) {\n      // Unbalanced; fall back to literal copy of the unmatched segment.\n      out += s.slice(start, j);\n      i = j;\n      continue;\n    }\n\n    // Body is the contents between prefix end and the final '}'.\n    const body = s.slice(prefixMatch.lastIndex, j - 1);\n    const options = parsePluralBody(body);\n\n    if (keyword === 'plural' || keyword === 'selectordinal') {\n      const n = Number(params[arg] ?? 0);\n      if (Number.isFinite(n)) {\n        const exact = options[`=${n}`];\n        if (exact != null) {\n          out += replaceHash(replaceMessageBlocks(exact, lang, params, pluralResolver), n);\n          i = j;\n          continue;\n        }\n\n        const category: PluralCategory = pluralResolver\n          ? pluralResolver(n, lang)\n          : n === 1 ? 'one' : 'other';\n\n        const match = options[category] ?? options['other'] ?? '';\n        out += replaceHash(replaceMessageBlocks(match, lang, params, pluralResolver), n);\n      } else {\n        out += replaceHash(replaceMessageBlocks(options['other'] ?? '', lang, params, pluralResolver), Number(params[arg]));\n      }\n    } else {\n      // select: look up param value directly, then resolve any nested keyword blocks\n      const val = String(params[arg] ?? 'other');\n      out += replaceMessageBlocks(options[val] ?? options['other'] ?? '', lang, params, pluralResolver);\n    }\n\n    i = j;\n  }\n\n  return out;\n}\n\nfunction replaceHash(s: string, n: number): string {\n  return s.replace(/#/g, String(n));\n}\n\n/**\n * Parse a simple ICU plural/select clause body: e.g. `one {A} other {B} =0 {C}`.\n * Supports balanced brace bodies and nested forms.\n */\nfunction parsePluralBody(body: string): Record<string, string> {\n  const map: Record<string, string> = {};\n  let i = 0;\n\n  while (i < body.length) {\n    // Skip whitespace between selectors.\n    while (i < body.length && /\\s/.test(body.charAt(i))) i++;\n    if (i >= body.length) break;\n\n    const keyStart = i;\n    while (i < body.length && !/[\\s{]/.test(body.charAt(i))) i++;\n    if (keyStart === i) break;\n    const key = body.slice(keyStart, i);\n\n    // Skip whitespace before the opening brace.\n    while (i < body.length && /\\s/.test(body.charAt(i))) i++;\n    if (body.charAt(i) !== '{') break;\n    i++; // Consume '{'\n\n    const valueStart = i;\n    let depth = 1;\n    // Consume until the matching closing brace; supports nested braces for placeholders.\n    while (i < body.length && depth > 0) {\n      const ch = body.charAt(i++);\n      if (ch === '{') depth++;\n      else if (ch === '}') depth--;\n    }\n    if (depth !== 0) {\n      // Unbalanced braces (malformed plural); bail out to avoid infinite loops.\n      break;\n    }\n\n    map[key] = body.slice(valueStart, i - 1);\n  }\n\n  return map;\n}\n","/**\n * @packageDocumentation\n * Core runtime i18n primitives.\n * Keep this surface minimal and stable.\n */\n\nexport type {\n  Catalog,\n  RuntimeI18nConfig,\n  I18nSchema,\n  TranslationKey,\n  TranslationParams,\n  DeepKeys,\n  ExtractParams,\n  ActiveCatalogType,\n  PluralCategory,\n  PluralResolver,\n} from './lib/types';\n\n/**\n * Lightweight ICU-style formatter used internally by the Angular service.\n * Exposed as @experimental for advanced users or custom integrations.\n * @experimental\n */\nexport { formatIcu } from './lib/icu';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngx-runtime-i18n/core",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Runtime i18n core with ICU-lite formatting",
   "type": "module",
   "sideEffects": false,
@@ -21,7 +21,7 @@
   "exports": {
     ".": {
       "import": "./fesm2022/ngx-runtime-i18n-core.mjs",
-      "types": "./index.d.ts",
+      "types": "./types/ngx-runtime-i18n-core.d.ts",
       "default": "./fesm2022/ngx-runtime-i18n-core.mjs"
     },
     "./package.json": {
@@ -30,14 +30,14 @@
   },
   "publishConfig": {
     "access": "public",
-    "provenance": false
+    "provenance": true
   },
   "engines": {
     "node": ">=18"
   },
   "module": "fesm2022/ngx-runtime-i18n-core.mjs",
-  "typings": "index.d.ts",
+  "typings": "types/ngx-runtime-i18n-core.d.ts",
   "dependencies": {
     "tslib": "^2.3.0"
   }
-}
+}

package/types/ngx-runtime-i18n-core.d.ts

@@ -0,0 +1,129 @@
+/**
+ * A translation catalog is a nested object where keys are dot-addressable.
+ * Example:
+ * {
+ *   "hello": { "user": "Hello, {name}!" },
+ *   "cart": { "items": "{count, plural, one {1 item} other {# items}}" }
+ * }
+ * Keys may contain ICU message syntax.
+ * @publicApi
+ */
+type Catalog = Record<string, unknown>;
+/**
+ * Runtime i18n configuration shared across CSR and SSR.
+ * Provide via {@link @ngx-runtime-i18n/angular!provideRuntimeI18n | provideRuntimeI18n()}.
+ * @publicApi
+ */
+interface RuntimeI18nConfig {
+    /**
+     * The language to render when no user preference is known.
+     * SSR should override per request (e.g., from URL/cookie).
+     */
+    defaultLang: string;
+    /**
+     * Optional ordered list of fallback languages (per key).
+     * Missing keys resolve using: active → fallbacks → defaultLang.
+     */
+    fallbacks?: string[];
+    /**
+     * The set of allowed languages. `setLang()` will guard against values not in this list.
+     * Use BCP-47 tags (e.g., "en", "en-GB", "hi").
+     */
+    supported: string[];
+    /**
+     * Fetch a catalog at runtime. Must be idempotent and cancellable via AbortSignal.
+     * - Runs on the client only (the server should seed catalogs via TransferState).
+     * - Return a plain object (parsed JSON).
+     * - `scope` is set when loading a route-scoped catalog registered via `withI18nScope()`
+     *   (see `@ngx-runtime-i18n/angular`); build the scoped URL yourself, e.g.
+     *   `scope ? `/i18n/${scope}/${lang}.json` : `/i18n/${lang}.json``.
+     */
+    fetchCatalog: (lang: string, signal?: AbortSignal, scope?: string) => Promise<Catalog>;
+    /**
+     * Missing key handler. When omitted, the key itself is returned (useful in dev).
+     * Use to log or to inject a visible marker.
+     */
+    onMissingKey?: (key: string) => string;
+}
+/**
+ * Module-augmentation hook for typed translation keys.
+ * Augment this interface in your app to enable typed t() and pipe.
+ *
+ * @example
+ * // src/i18n.d.ts
+ * import type en from '../public/i18n/en.json';
+ * declare module '@ngx-runtime-i18n/core' {
+ *   interface I18nSchema { translations: typeof en; }
+ * }
+ * @publicApi
+ */
+interface I18nSchema {
+}
+/** @internal */
+type ActiveCatalogType = I18nSchema extends {
+    translations: infer T;
+} ? T : Record<string, unknown>;
+/** Depth guard for recursive type — prevents TypeScript slowdown on large catalogs. @internal */
+type Prev = [never, 0, 1, 2, 3, 4, ...0[]];
+/**
+ * Produces dot-notation key paths for T up to Depth levels deep.
+ * Depth cap prevents compile-time slowdown at 2000+ keys (i18next issue #1914).
+ * @publicApi
+ */
+type DeepKeys<T, Depth extends number = 4> = [
+    Depth
+] extends [never] ? never : T extends Record<string, unknown> ? {
+    [K in keyof T & string]: K | (T[K] extends Record<string, unknown> ? `${K}.${DeepKeys<T[K], Prev[Depth]>}` : never);
+}[keyof T & string] : never;
+/**
+ * The union of valid translation keys, or `string` when no schema is provided (backward compat).
+ * @publicApi
+ */
+type TranslationKey = I18nSchema extends {
+    translations: infer T;
+} ? T extends Record<string, unknown> ? DeepKeys<T> : string : string;
+/**
+ * Extracts interpolation param names from an ICU message string literal.
+ * Works for simple {name} tokens and ICU keyword blocks {count, plural, ...}.
+ * @publicApi
+ */
+type ExtractParams<S extends string> = S extends `${string}{${infer Token}}${infer Rest}` ? Token extends `${infer Arg},${infer Keyword},${string}` ? Keyword extends 'plural' | 'select' | 'selectordinal' ? {
+    [K in Arg]: number;
+} & ExtractParams<Rest> : {
+    [K in Token]: string | number;
+} & ExtractParams<Rest> : {
+    [K in Token]: string | number;
+} & ExtractParams<Rest> : Record<never, never>;
+/** @internal */
+type ResolveValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? ResolveValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+/**
+ * Resolves the interpolation params type for a given key K.
+ * Falls back to Record<string, unknown> when no schema or when value is not a string literal.
+ * @publicApi
+ */
+type TranslationParams<K extends TranslationKey> = I18nSchema extends {
+    translations: infer Cat;
+} ? Cat extends Record<string, unknown> ? K extends string ? ResolveValue<Cat, K> extends string ? ExtractParams<ResolveValue<Cat, K>> : Record<string, unknown> : Record<string, unknown> : Record<string, unknown> : Record<string, unknown>;
+/**
+ * CLDR plural categories per Unicode TR35.
+ * @publicApi
+ */
+type PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
+/**
+ * Resolves the CLDR plural category for a count in a given locale.
+ * Provide via Angular's getLocalePluralCase() or a custom implementation.
+ * Falls back to English-biased one/other logic when not provided.
+ * @publicApi
+ */
+type PluralResolver = (count: number, locale: string) => PluralCategory;
+
+/**
+ * ICU-style formatter with interpolation, plural, select, and selectordinal support.
+ * Used by the Angular service and pipe.
+ * @experimental
+ */
+
+declare function formatIcu(_lang: string, key: string, cat: Catalog, params?: Record<string, unknown>, onMissingKey?: (k: string) => string, pluralResolver?: PluralResolver): string;
+
+export { formatIcu };
+export type { ActiveCatalogType, Catalog, DeepKeys, ExtractParams, I18nSchema, PluralCategory, PluralResolver, RuntimeI18nConfig, TranslationKey, TranslationParams };

package/index.d.ts

@@ -1,55 +0,0 @@
-/**
- * A translation catalog is a nested object where keys are dot-addressable.
- * Example:
- * {
- *   "hello": { "user": "Hello, {name}!" },
- *   "cart": { "items": "{count, plural, one {1 item} other {# items}}" }
- * }
- * Keys may contain ICU message syntax.
- * @publicApi
- */
-type Catalog = Record<string, unknown>;
-/**
- * Runtime i18n configuration shared across CSR and SSR.
- * Provide via {@link @ngx-runtime-i18n/angular!provideRuntimeI18n | provideRuntimeI18n()}.
- * @publicApi
- */
-interface RuntimeI18nConfig {
-    /**
-     * The language to render when no user preference is known.
-     * SSR should override per request (e.g., from URL/cookie).
-     */
-    defaultLang: string;
-    /**
-     * Optional ordered list of fallback languages (per key).
-     * Missing keys resolve using: active → fallbacks → defaultLang.
-     */
-    fallbacks?: string[];
-    /**
-     * The set of allowed languages. `setLang()` will guard against values not in this list.
-     * Use BCP-47 tags (e.g., "en", "en-GB", "hi").
-     */
-    supported: string[];
-    /**
-     * Fetch a catalog at runtime. Must be idempotent and cancellable via AbortSignal.
-     * - Runs on the client only (the server should seed catalogs via TransferState).
-     * - Return a plain object (parsed JSON).
-     */
-    fetchCatalog: (lang: string, signal?: AbortSignal) => Promise<Catalog>;
-    /**
-     * Missing key handler. When omitted, the key itself is returned (useful in dev).
-     * Use to log or to inject a visible marker.
-     */
-    onMissingKey?: (key: string) => string;
-}
-
-/**
- * Very small ICU-like formatter with interpolation and plural basics.
- * Used by the Angular service and pipe. Replace with full ICU in a later minor.
- * @experimental
- */
-
-declare function formatIcu(_lang: string, key: string, cat: Catalog, params?: Record<string, unknown>, onMissingKey?: (k: string) => string): string;
-
-export { formatIcu };
-export type { Catalog, RuntimeI18nConfig };