@konce-pt/i18n 0.16.0 → 0.17.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI - Angular component library" width="100%" />
+  <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI" width="100%" />
 </p>
 
 # @konce-pt/i18n
@@ -24,6 +24,9 @@ translate(KPT_MESSAGES_PL, 'paginator.range', { start: 1, end: 10, total: 42 });
 
 translate(KPT_MESSAGES_PL, 'nope.missing');
 // 'nope.missing' - brak klucza spada na EN, a potem na sam klucz
+
+translate(KPT_MESSAGES_PL, 'dataView.count', { count: 5 }, 'pl');
+// '5 elementów' - liczba mnoga ICU, formę wybiera `Intl.PluralRules` dla podanego języka
 ```
 
 ## API
@@ -33,12 +36,14 @@ translate(KPT_MESSAGES_PL, 'nope.missing');
 | `KptMessages` | `interface` | Kontrakt wszystkich etykiet UI biblioteki |
 | `KptLocale` | `type` | `'en' \| 'pl' \| (string & {})` - otwarty kod języka |
 | `KPT_MESSAGES_EN` / `KPT_MESSAGES_PL` | `KptMessages` | Słowniki bazowe |
-| `translate(dict, key, params?)` | `string` | Klucz kropkowy + interpolacja `{name}`, fallback -> EN -> klucz |
+| `translate(dict, key, params?, locale?)` | `string` | Klucz kropkowy + interpolacja `{name}` i liczba mnoga ICU (`{count, plural, ...}`, reguły z `locale`, domyślnie `'en'`), fallback -> EN -> klucz |
 | `lookup(dict, key)` | `string \| undefined` | Surowa wartość spod klucza kropkowego |
 | `deepMerge(base, patch)` | `T` | Nakłada częściowy słownik na pełny |
 | `weekdayNames(locale)` | `string[]` | Skrócone nazwy dni, od poniedziałku |
 | `monthNames(locale)` | `string[]` | Pełne nazwy miesięcy |
-| `DeepPartial<T>`, `KptI18nConfig` | `type` | Typy używane przez wiązania frameworkowe |
+| `formatBytes(bytes, locale, unit?, fixed?)`, `byteUnitOf(bytes)` | `string`, `KptByteUnit` | Rozmiar pliku w języku interfejsu (podstawa 1024) i jednostka, w której go zapisać |
+| `KptMessageKey` | `type` | Unia kluczy kropkowych słownika bazowego - podpowiedzi w edytorze |
+| `DeepPartial<T>`, `KptI18nConfig`, `KptByteUnit` | `type` | Typy używane przez wiązania frameworkowe |
 
 Nazw dni i miesięcy nie ma w słowniku - wyliczają się z `Intl` dla aktywnego locale, więc
 kalendarze działają także w języku, którego nikt nie tłumaczył ręcznie.
@@ -46,6 +51,12 @@ kalendarze działają także w języku, którego nikt nie tłumaczył ręcznie.
 Pełny opis: [`llms.txt`](https://ui.konce.pt/llms/i18n/llms.txt) (EN)
 i [`llms-pl.txt`](https://ui.konce.pt/llms/i18n/llms-pl.txt) (PL).
 
+## Testy
+
+```bash
+pnpm --filter @konce-pt/i18n exec node --test "src/**/*.test.ts"
+```
+
 ## Licencja
 
 MIT © konce.pt

package/dist/messages.d.ts

@@ -268,6 +268,11 @@ export interface KptMessages {
         /** Ogłoszenie po przestawieniu. Interpolacja: {position}, {total}. */
         moved: string;
     };
+    /** Pole tekstowe (kpt-input). */
+    input: {
+        /** Przycisk czyszczenia pola - nazwa dla czytnika ekranu. */
+        clear: string;
+    };
     inputNumber: {
         decrement: string;
         increment: string;
@@ -381,6 +386,10 @@ export interface KptMessages {
         image: string;
         /** Ogłoszenie zmiany obrazu. Interpolacja: {index}, {total}. */
         position: string;
+        /** Strzałka paska miniatur - przewija pasek w stronę początku. */
+        scrollBack: string;
+        /** Strzałka paska miniatur - przewija pasek w stronę końca. */
+        scrollForward: string;
     };
     carousel: {
         /** Interpolacja: {index}. */

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',
@@ -99,9 +99,9 @@ export const KPT_MESSAGES_EN = {
             results: 'Address suggestions',
             clear: 'Clear the search',
             noResults: 'No matching places',
-            minLength: 'Type at least {count} characters',
+            minLength: '{count, plural, one {Type at least # character} other {Type at least # characters}}',
             searching: 'Searching...',
-            found: '{count} suggestions',
+            found: '{count, plural, one {# suggestion} other {# suggestions}}',
         },
         field: {
             invalidEmail: 'Enter a valid e-mail address',
@@ -216,6 +216,9 @@ export const KPT_MESSAGES_EN = {
         down: 'Down',
         moved: 'Moved to position {position} of {total}',
     },
+    input: {
+        clear: 'Clear the field',
+    },
     inputNumber: {
         decrement: 'Decrease',
         increment: 'Increase',
@@ -306,6 +309,8 @@ export const KPT_MESSAGES_EN = {
     galleria: {
         image: 'Image {index}',
         position: 'Image {index} of {total}',
+        scrollBack: 'Scroll thumbnails back',
+        scrollForward: 'Scroll thumbnails forward',
     },
     carousel: {
         slide: 'Slide {index}',
@@ -447,7 +452,7 @@ export const KPT_MESSAGES_EN = {
         today: 'Today',
         yesterday: 'Yesterday',
         typing: '{name} is typing...',
-        typingMany: '{count} people are typing...',
+        typingMany: '{count, plural, one {# person is typing...} other {# people are typing...}}',
         sending: 'Sending',
         sent: 'Sent',
         delivered: 'Delivered',
@@ -457,7 +462,7 @@ export const KPT_MESSAGES_EN = {
         offline: 'No connection',
         pending: '{count} waiting to be sent',
         queue: 'Queue',
-        newMessages: '{count} new messages',
+        newMessages: '{count, plural, one {# new message} other {# new messages}}',
         unread: 'Unread messages',
         empty: 'No messages yet',
         history: 'Conversation history',
@@ -475,7 +480,7 @@ export const KPT_MESSAGES_EN = {
         reactSad: 'Sad',
         open: 'Open chat',
         close: 'Close chat',
-        unreadBadge: '{count} unread messages',
+        unreadBadge: '{count, plural, one {# unread message} other {# unread messages}}',
     },
     speech: {
         dictate: 'Dictate',
@@ -526,7 +531,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',
@@ -702,6 +707,9 @@ export const KPT_MESSAGES_PL = {
         down: 'W dół',
         moved: 'Przeniesiono na pozycję {position} z {total}',
     },
+    input: {
+        clear: 'Wyczyść pole',
+    },
     inputNumber: {
         decrement: 'Zmniejsz',
         increment: 'Zwiększ',
@@ -792,6 +800,8 @@ export const KPT_MESSAGES_PL = {
     galleria: {
         image: 'Obraz {index}',
         position: 'Obraz {index} z {total}',
+        scrollBack: 'Przewiń miniatury wstecz',
+        scrollForward: 'Przewiń miniatury dalej',
     },
     carousel: {
         slide: 'Slajd {index}',
@@ -933,7 +943,7 @@ export const KPT_MESSAGES_PL = {
         today: 'Dziś',
         yesterday: 'Wczoraj',
         typing: '{name} pisze...',
-        typingMany: '{count} osoby piszą...',
+        typingMany: '{count, plural, one {# osoba pisze...} few {# osoby piszą...} many {# osób pisze...} other {# osoby pisze...}}',
         sending: 'Wysyłanie',
         sent: 'Wysłano',
         delivered: 'Dostarczono',
@@ -941,9 +951,9 @@ export const KPT_MESSAGES_PL = {
         failed: 'Nie wysłano',
         retry: 'Wyślij ponownie',
         offline: 'Brak połączenia',
-        pending: '{count} czeka na wysłanie',
+        pending: '{count, plural, one {# czeka na wysłanie} few {# czekają na wysłanie} many {# czeka na wysłanie} other {# czeka na wysłanie}}',
         queue: 'Do kolejki',
-        newMessages: '{count} nowych wiadomości',
+        newMessages: '{count, plural, one {# nowa wiadomość} few {# nowe wiadomości} many {# nowych wiadomości} other {# nowej wiadomości}}',
         unread: 'Nieprzeczytane',
         empty: 'Brak wiadomości',
         history: 'Historia rozmowy',
@@ -961,7 +971,7 @@ export const KPT_MESSAGES_PL = {
         reactSad: 'Smutek',
         open: 'Otwórz czat',
         close: 'Zamknij czat',
-        unreadBadge: '{count} nieprzeczytanych wiadomości',
+        unreadBadge: '{count, plural, one {# nieprzeczytana wiadomość} few {# nieprzeczytane wiadomości} many {# nieprzeczytanych wiadomości} other {# nieprzeczytanej wiadomości}}',
     },
     speech: {
         dictate: 'Dyktuj',

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.16.0",
+  "version": "0.17.0",
   "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",