@konce-pt/angular 0.3.0 → 0.4.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konce-pt/angular",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Open-source Angular 22 component library on Signals & Signal Forms — 70+ components, rich data table, zoneless, fully tokenized. Selektory kpt-*, klasy Kpt*.",
   "license": "MIT",
   "author": "konce.pt",

package/dist/src/lib/confirm/llms.txt

@@ -11,6 +11,10 @@ Import: `import { KptConfirmService, KptConfirmContainer } from '@konce-pt/angul
 - `message`: string (wymagane); `header?`: string
 - `acceptLabel?`/`rejectLabel?`: string; `variant?`: 'filled' | 'danger'; `icon?`: string
 
+## i18n
+Domyślne etykiety (nagłówek, Potwierdź, Anuluj) z i18n (namespace `confirm`); pola opcji mają priorytet.
+Domyślnie EN; konfiguracja przez `provideKptI18n` — patrz `i18n/llms.txt`.
+
 ## Przykład
     const ok = await this.confirm.confirm({
       message: 'Usunąć rekord?', variant: 'danger', acceptLabel: 'Usuń', icon: 'alert-triangle',

package/dist/src/lib/data-table/llms.txt

@@ -32,7 +32,7 @@ Filtry `select`/`dateRange` wymagają `import '@angular/cdk/overlay-prebuilt.css
 - `pageSizeOptions`: number[] (domyślnie [5,10,20,50])
 - `selectable`: 'none' | 'single' | 'multiple'
 - `loading`: boolean — wiersz „Ładowanie…"
-- `emptyMessage`: string (domyślnie „Brak danych")
+- `emptyMessage`: string — bez wartości używa i18n (`dataTable.empty`); input ma priorytet
 - `rowKey`: string | null — pole identyfikujące wiersz (dla zaznaczania); bez niego porównanie po referencji
 - `reorderable`: boolean — przestawianie kolumn przeciągnij-i-upuść (natywny HTML5 DnD); kolumny `frozen` są wyłączone z przenoszenia (pozostają wiodące) i nie można upuszczać innych kolumn przed nie
 - `exportable`: boolean — przycisk „Eksport CSV" w toolbarze
@@ -82,6 +82,11 @@ Niezależne od `selectable` (można łączyć z zaznaczaniem). Nieaktywne przy `
 - Zaznaczanie 'multiple': nagłówkowy checkbox zaznacza/odznacza bieżącą stronę.
 - Sticky header, stany pusty/ładowanie, wyrównanie i szerokości per kolumna.
 
+## i18n
+Etykiety toolbaru/stanów/aria (Szukaj, Eksport CSV, Ładowanie, Brak danych, zaznaczanie, filtry kolumn:
+Filtr/Filtr min/Filtr max z `{column}`, Wszystkie, min, max, Zakres dat) pochodzą z i18n (namespace `dataTable`).
+Domyślnie EN; konfiguracja przez `provideKptI18n` — patrz `i18n/llms.txt`.
+
 ## Tokeny
 `--kpt-table-{bg,fg,border,radius,header-bg,header-fg,row-hover,row-selected,cell-padding}`.
 Rozwijany wiersz: `--kpt-table-detail-bg` (fallback: surface-variant → row-hover).

package/dist/src/lib/date-range/llms.txt

@@ -11,7 +11,7 @@ Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
 - `mode`: 'date' | 'datetime' | 'time' (domyślnie 'date')
 - `hourFormat`: 12 | 24 (domyślnie 24) — tarcza z AM/PM lub 24h; czas zawsze 24h w wartości
 - `minuteStep`: number (domyślnie 1) — snap minut na tarczy
-- `placeholder`: string (domyślnie 'Wybierz zakres')
+- `placeholder`: string — bez wartości używa i18n (`dateRange.placeholder`); input ma priorytet
 - `displayFormat`: 'pl' | 'iso' (domyślnie 'pl') — format wyświetlania start/end
 - `disabled`/`invalid`/`touched`: boolean; `touch`: output
 
@@ -25,5 +25,9 @@ Tryby datetime/time: przełącznik „Od / Koniec" + tarcza zegara, zatwierdzeni
 
     period = signal<KptDateRangeValue>({ start: '', end: '' });
 
+## i18n
+Nazwy dni/miesięcy z `Intl` wg locale; etykiety („Od/Koniec", nawigacja, „Gotowe", placeholder) z i18n
+(namespace `dateRange` + `datepicker`/`common`). Domyślnie EN — patrz `i18n/llms.txt`.
+
 ## Tokeny
 Pole `--kpt-form-field-*`; kalendarz `--kpt-color-surface-raised`, zakres `--kpt-color-primary`.

package/dist/src/lib/datepicker/llms.txt

@@ -25,5 +25,11 @@ Import: `import { KptDatepicker } from '@konce-pt/angular';`
 - `disabled`/`invalid`/`touched`: boolean; output `touch`.
 - Panel: nawigacja (‹ ›) miesięcy/lat/dekad wg trybu; tarcza zegara z „Gotowe"; przycisk czyszczenia (×).
 
+## i18n
+Nazwy dni tygodnia i miesięcy są wyliczane z `Intl` wg aktywnego locale i18n (nie ze słownika).
+Etykiety nawigacji/aria i „Gotowe" z i18n (namespace `datepicker` + `common`). Domyślnie EN;
+konfiguracja przez `provideKptI18n` — patrz `i18n/llms.txt`. Uwaga: `displayFormat` ('pl'/'iso')
+steruje wyłącznie formatem daty i jest niezależny od języka etykiet.
+
 ## Tokeny
 `--kpt-form-field-{bg,text,border,border-focus,border-error,radius}`.

package/dist/src/lib/i18n/llms.txt

@@ -0,0 +1,35 @@
+# i18n (provideKptI18n / KptI18n)
+
+Tłumaczenia etykiet komponentów. Języki bazowe: EN (domyślny), PL. Oparte o sygnały (zoneless-friendly), bez zależności zewnętrznych.
+Import: `import { provideKptI18n, KptI18n } from '@konce-pt/angular';`
+
+## Konfiguracja (provider)
+- `provideKptI18n({ locale?, messages? }): EnvironmentProviders` — w `bootstrapApplication`.
+- `locale`: 'en' | 'pl' | dowolny string (domyślnie 'en').
+- `messages`: `Record<locale, DeepPartial<KptMessages>>` — rejestruje nowy język lub nadpisuje istniejący (deep-merge, brakujące klucze → EN).
+
+## Serwis KptI18n (providedIn: 'root')
+- `locale: Signal<KptLocale>` — bieżący język.
+- `setLocale(locale)` — zmiana w runtime (reaktywna dla wszystkich komponentów).
+- `registerMessages(locale, patch)` — dodaje/nadpisuje słownik w runtime.
+- `t(key, params?)` — tłumaczy klucz w notacji kropkowej (`'paginator.range'`) z interpolacją `{name}`.
+
+## Dodanie własnego języka (jeden plik JSON)
+    import de from './i18n/de.json'; // kształt = interfejs KptMessages
+    provideKptI18n({ locale: 'de', messages: { de } });
+    // runtime: inject(KptI18n).registerMessages('de', de); inject(KptI18n).setLocale('de');
+
+## Przełączanie języka w runtime
+    const i18n = inject(KptI18n);
+    i18n.setLocale('pl');
+
+## Kontrakt kluczy (KptMessages)
+Namespace'y: `common` (close/remove/previous/next/clear/done/all), `paginator` (rowsPerPage/range/prevPage/nextPage),
+`select`, `listbox`, `dataView`, `dataTable`, `confirm`, `fileUpload`, `chipsInput`, `dateRange`, `datepicker`,
+`pickList`, `orderList`, `inputNumber`, `password`, `spinner`, `speedDial`, `scrollTop`, `splitButton`, `panel`,
+`breadcrumb`, `richText`. Interpolacje: `paginator.range` ({start},{end},{total}), `dataTable.filter*` ({column}),
+`richText.styleHeading` ({level}). Nazwy dni/miesięcy w kalendarzach są wyliczane z `Intl` wg locale (nie ze słownika).
+
+## Uwaga
+Pojedyncze etykiety można też nadpisać per-komponent przez odpowiedni `input()` (np. `emptyMessage`, `acceptLabel`) —
+input ma priorytet nad słownikiem i18n.

package/dist/src/lib/paginator/llms.txt

@@ -16,3 +16,7 @@ Paginator sterowany sygnałami. Import: `import { KptPaginator } from '@konce-pt
 
 Pokazuje „X–Y z Z", wybór rozmiaru strony oraz przyciski poprzednia/następna.
 Przy zmianie długości/rozmiaru samoczynnie koryguje `pageIndex` (effect).
+
+## i18n
+Etykiety („Wierszy:", separator zakresu, aria stron) pochodzą z i18n (namespace `paginator`).
+Domyślny język EN; przełączenie/nadpisanie przez `provideKptI18n` — patrz `i18n/llms.txt`.

package/dist/src/lib/rich-text/llms.txt

@@ -30,6 +30,11 @@ Import: `import { KptRichText, KptRichTool, KptRichToolbar } from '@konce-pt/ang
     <kpt-rich-text [formField]="f.body" />  <!-- pełny pasek -->
     <kpt-rich-text [(value)]="v" [toolbar]="[['bold','italic'],['ul','ol'],['link']]" />
 
+## i18n
+Wszystkie etykiety (aria narzędzi, style „Normalny/Nagłówek N", prompt linku, menu kontekstowe tabeli,
+popover obramowania, „Własny…") pochodzą z i18n (namespace `richText`, w tym `richText.menu.*`,
+`richText.border.*`). Domyślnie EN — patrz `i18n/llms.txt`.
+
 ## Uwagi
 Formatowanie przez document.execCommand; aktywne narzędzia podświetlane (queryCommandState).
 Wklejanie (natywne i przyciskami) jest sanityzowane (allowlista tagów/stylów; usuwa script/on*/javascript:).

package/dist/src/lib/select/llms.txt

@@ -18,5 +18,9 @@ Wymaga stylów overlay CDK w aplikacji: `import '@angular/cdk/overlay-prebuilt.c
 - `disabled`/`invalid`/`touched`: boolean; output `touch`.
 - Klawiatura: Enter/↓ otwiera, ↑/↓ nawigacja, Enter wybiera, Esc zamyka.
 
+## i18n
+Etykiety „Szukaj…", „Brak wyników" i aria usuwania chipa z i18n (namespace `select`).
+Domyślnie EN; konfiguracja przez `provideKptI18n` — patrz `i18n/llms.txt`.
+
 ## Tokeny
 `--kpt-form-field-{bg,text,border,border-hover,border-focus,border-error,radius}`.