@konce-pt/i18n 0.15.1 → 0.16.1

package/dist/messages.js

@@ -40,7 +40,7 @@ export const KPT_MESSAGES_EN = {
         grid: 'Grid',
         columns: 'Columns',
         empty: 'No items',
-        count: '{count} items',
+        count: '{count, plural, one {# item} other {# items}}',
     },
     roadmap: {
         empty: 'No items on the roadmap',
@@ -526,7 +526,7 @@ export const KPT_MESSAGES_PL = {
         grid: 'Siatka',
         columns: 'Kolumny',
         empty: 'Brak elementów',
-        count: '{count} elementów',
+        count: '{count, plural, one {# element} few {# elementy} many {# elementów} other {# elementu}}',
     },
     roadmap: {
         empty: 'Brak elementów na roadmapie',

package/dist/translate.d.ts

@@ -7,5 +7,8 @@ export declare function lookup(dict: KptMessages, key: string): string | undefin
 /**
  * Tłumaczy klucz w notacji kropkowej (np. `'paginator.range'`), z opcjonalną
  * interpolacją `{name}`. Brakujący klucz spada na EN, a w ostateczności zwraca sam klucz.
+ *
+ * Liczbę mnogą zapisuje się blokiem ICU `{count, plural, one {# item} other {# items}}`;
+ * `locale` wybiera reguły odmiany (domyślnie `'en'`). Porty przekazują tu bieżący język.
  */
-export declare function translate(dict: KptMessages, key: string, params?: Record<string, string | number>): string;
+export declare function translate(dict: KptMessages, key: string, params?: Record<string, string | number>, locale?: string): string;

package/dist/translate.js

@@ -33,13 +33,85 @@ export function lookup(dict, key) {
     }
     return typeof node === 'string' ? node : undefined;
 }
+/** Pozycja zamykającego `}` dla `{` stojącego na `open`, z liczeniem zagnieżdżeń; -1 bez pary. */
+function closingBrace(text, open) {
+    let depth = 0;
+    for (let i = open; i < text.length; i++) {
+        if (text[i] === '{')
+            depth++;
+        else if (text[i] === '}' && --depth === 0)
+            return i;
+    }
+    return -1;
+}
+/** Gałęzie bloku liczby mnogiej: `one {...} few {...} =0 {...}` -> mapa selektor -> tekst. */
+function pluralBranches(body) {
+    const branches = new Map();
+    let i = 0;
+    while (i < body.length) {
+        const match = /^\s*(=\d+|zero|one|two|few|many|other)\s*\{/.exec(body.slice(i));
+        if (!match)
+            return body.slice(i).trim() === '' ? branches : null;
+        const open = i + match[0].length - 1;
+        const close = closingBrace(body, open);
+        if (close < 0)
+            return null;
+        branches.set(match[1], body.slice(open + 1, close));
+        i = close + 1;
+    }
+    return branches;
+}
+/** Reguły liczby mnogiej per język - `Intl.PluralRules` jest drogi w tworzeniu, więc raz na język. */
+const pluralRules = new Map();
+function pluralCategory(locale, value) {
+    let rules = pluralRules.get(locale);
+    if (!rules) {
+        try {
+            rules = new Intl.PluralRules(locale);
+        }
+        catch {
+            // Nieznany tag języka (własny słownik pod umowną nazwą) - reguły angielskie zamiast wyjątku.
+            rules = new Intl.PluralRules('en');
+        }
+        pluralRules.set(locale, rules);
+    }
+    return rules.select(value);
+}
+/**
+ * Rozwija bloki `{name, plural, one {...} few {...} many {...} other {...}}` (podzbiór składni ICU).
+ *
+ * Formę wybiera `Intl.PluralRules` dla `locale`, więc słownik podaje tylko formy, a reguły
+ * (`2 elementy`, ale `5 elementów` i `22 elementy`) zna przeglądarka. Dokładne dopasowanie `=N`
+ * wygrywa z kategorią, `other` jest obowiązkowym zapasem. `#` w gałęzi to sama liczba.
+ * Blok z nieznanym parametrem albo bez pary nawiasów zostaje w tekście bez zmian.
+ */
+function expandPlurals(text, params, locale) {
+    const head = /\{(\w+),\s*plural,/g;
+    let out = '';
+    let from = 0;
+    for (let match = head.exec(text); match; match = head.exec(text)) {
+        const close = closingBrace(text, match.index);
+        const value = Number(params[match[1]]);
+        const branches = close < 0 ? null : pluralBranches(text.slice(match.index + match[0].length, close));
+        if (close < 0 || !branches || params[match[1]] === undefined || Number.isNaN(value))
+            continue;
+        const chosen = branches.get(`=${value}`) ?? branches.get(pluralCategory(locale, value)) ?? branches.get('other') ?? '';
+        out += text.slice(from, match.index) + chosen.replace(/#/g, String(params[match[1]]));
+        from = close + 1;
+        head.lastIndex = from;
+    }
+    return out + text.slice(from);
+}
 /**
  * Tłumaczy klucz w notacji kropkowej (np. `'paginator.range'`), z opcjonalną
  * interpolacją `{name}`. Brakujący klucz spada na EN, a w ostateczności zwraca sam klucz.
+ *
+ * Liczbę mnogą zapisuje się blokiem ICU `{count, plural, one {# item} other {# items}}`;
+ * `locale` wybiera reguły odmiany (domyślnie `'en'`). Porty przekazują tu bieżący język.
  */
-export function translate(dict, key, params) {
+export function translate(dict, key, params, locale = 'en') {
     const raw = lookup(dict, key) ?? lookup(KPT_MESSAGES_EN, key) ?? key;
     if (!params)
         return raw;
-    return raw.replace(/\{(\w+)\}/g, (_, name) => String(params[name] ?? `{${name}}`));
+    return expandPlurals(raw, params, locale).replace(/\{(\w+)\}/g, (_, name) => String(params[name] ?? `{${name}}`));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konce-pt/i18n",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "description": "Translation contract and base dictionaries (EN, PL) for Koncept UI - shared by the Angular and React ports. Pure TypeScript, zero runtime dependencies.",
   "license": "MIT",
   "author": "konce.pt",