@konce-pt/i18n

Kontrakt tłumaczeń i słowniki bazowe (EN, PL) dla Koncept UI. Czysty TypeScript, zero zależności runtime, bez wiązania z frameworkiem — jedno źródło prawdy dla @konce-pt/angular i @konce-pt/react.

Zwykle nie instalujesz tego pakietu samodzielnie: biblioteki komponentów re-eksportują jego API (provideKptI18n / KptI18n w Angularze, KptI18nProvider / useKptI18n w Reakcie). Sięgnij po niego wprost, gdy piszesz własny słownik albo własne wiązanie frameworkowe.

npm i @konce-pt/i18n

import { KPT_MESSAGES_PL, translate } from '@konce-pt/i18n';

translate(KPT_MESSAGES_PL, 'paginator.range', { start: 1, end: 10, total: 42 });
// '1–10 z 42'

translate(KPT_MESSAGES_PL, 'nope.missing');
// 'nope.missing' — brak klucza spada na EN, a potem na sam klucz

API

| Eksport | Typ | Opis | |---|---|---| | 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 | | 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 |

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.

Pełny opis: llms.txt (EN) i llms-pl.txt (PL).

Licencja

MIT © konce.pt