@konce-pt/angular 0.7.11 → 0.7.12

package/src/lib/select/llms.txt

@@ -1,40 +1,40 @@
 # KptSelect (kpt-select)
 
-Lista wyboru na własnym panelu (CDK Overlay), Signal Forms. Warianty: pojedynczy,
-z wyszukiwarką (`filter`) i wielokrotny (`multiple`, chipy; wartość `T[]`).
+A selection list on a custom panel (CDK Overlay), Signal Forms. Variants: single,
+with a search field (`filter`) and multiple (`multiple`, chips; the value is `T[]`).
 Import: `import { KptSelect, KptOption } from '@konce-pt/angular';`
 
-Wymaga stylów overlay CDK w aplikacji: `import '@angular/cdk/overlay-prebuilt.css';`
+Requires the CDK overlay styles in the application: `import '@angular/cdk/overlay-prebuilt.css';`
 
-## Użycie
+## Usage
     roles: KptOption<string>[] = [{label:'Admin',value:'admin'}, ...];
-    <kpt-select [formField]="f.role" [options]="roles" placeholder="Wybierz…" />
-    <kpt-select [formField]="f.city" [options]="cities" filter placeholder="Szukaj…" />
+    <kpt-select [formField]="f.role" [options]="roles" placeholder="Choose…" />
+    <kpt-select [formField]="f.city" [options]="cities" filter placeholder="Search…" />
     <kpt-select [formField]="f.tags" [options]="tags" multiple filter />   <!-- value: string[] -->
 
-## Wejścia
-- `value`: model (T lub T[] przy multiple); `options`: KptOption<T>[]; `placeholder`: string
-- `filter`: boolean — pole wyszukiwania; `multiple`: boolean — wybór wielu (chipy)
-- `disabled`/`invalid`/`touched`: boolean; output `touch`.
-- `open`: model (dwukierunkowe `[(open)]`, output `(openChange)`) — stan panelu. Pozwala otworzyć
-  listę z zewnątrz i wiedzieć, kiedy user skończył wybierać. Do tego drugiego **nie używaj `touch`**:
-  leci on także z blur triggera, czyli już przy naciśnięciu myszy na opcji w panelu (panel jest
-  w kontenerze CDK Overlay przy `<body>`, poza DOM-em kontrolki). Tak robi edycja inline
-  w `kpt-data-table` — patrz `data-table/llms.txt`.
-- Klawiatura: Enter/↓ otwiera, ↑/↓ nawigacja, Enter wybiera, Esc zamyka.
-
-## Float Label
-W `kpt-form-field` z `labelType` `over`/`in`/`on` etykieta unosi się także po wybraniu opcji —
-select dostarcza token `KPT_FORM_FIELD_CONTROL` z sygnałem `filled` (wartości w overlayu nie da
-się odczytać z DOM). Nic nie trzeba konfigurować:
-
-    <kpt-form-field label="Kraj" labelType="on">
+## Inputs
+- `value`: model (T, or T[] with multiple); `options`: KptOption<T>[]; `placeholder`: string
+- `filter`: boolean — a search field; `multiple`: boolean — multi-select (chips)
+- `disabled`/`invalid`/`touched`: boolean; the `touch` output.
+- `open`: model (two-way `[(open)]`, the `(openChange)` output) — the panel state. It lets you open
+  the list from outside and know when the user is done choosing. For the latter **do not use `touch`**:
+  it also fires on the trigger's blur, that is, the moment the mouse goes down on an option in the panel (the panel
+  lives in a CDK Overlay container next to `<body>`, outside the control's DOM). That is what inline editing
+  in `kpt-data-table` does — see `data-table/llms.txt`.
+- Keyboard: Enter/↓ opens, ↑/↓ navigate, Enter selects, Esc closes.
+
+## Float label
+In a `kpt-form-field` with `labelType` `over`/`in`/`on` the label also floats once an option is chosen —
+the select provides the `KPT_FORM_FIELD_CONTROL` token with a `filled` signal (a value in an overlay cannot
+be read from the DOM). Nothing needs configuring:
+
+    <kpt-form-field label="Country" labelType="on">
       <kpt-select [formField]="f.country" [options]="countries" />
     </kpt-form-field>
 
 ## i18n
-Etykiety „Szukaj…", „Brak wyników" i aria usuwania chipa z i18n (namespace `select`).
-Domyślnie EN; konfiguracja przez `provideKptI18n` — patrz `i18n/llms.txt`.
+The "Search…" and "No results" labels and the chip-removal aria text come from i18n (the `select` namespace).
+English by default; configured through `provideKptI18n` — see `i18n/llms.txt`.
 
-## Tokeny
+## Tokens
 `--kpt-form-field-{bg,text,border,border-hover,border-focus,border-error,radius}`.

package/src/lib/sidenav/llms.txt

@@ -1,26 +1,26 @@
 # KptSidenav (kpt-sidenav)
 
-Panel boczny — stylowany kontener nawigacji, zwykle w slocie `kptShellSidenav`
-komponentu `kpt-app-shell`. Import: `import { KptSidenav } from '@konce-pt/angular';`
+A side panel — a styled navigation container, usually in the `kptShellSidenav` slot
+of `kpt-app-shell`. Import: `import { KptSidenav } from '@konce-pt/angular';`
 
-## Selektor
+## Selector
 `kpt-sidenav`
 
-## Treść
-Dowolna zawartość (ng-content) — ląduje w obszarze przewijanym. Elementy `<a>` mają wbudowane
-style pozycji nawigacji (hover z `--kpt-color-muted`).
+## Content
+Anything (ng-content) — it lands in the scrollable area. `<a>` elements come with built-in
+navigation-entry styling (hover with `--kpt-color-muted`).
 
-## Stopka — `kptSidenavFooter`
-Element z tym atrybutem trafia poza obszar przewijany i zostaje przyklejony do dołu panelu,
-niezależnie od długości nawigacji. Dostaje górną kreskę (`--kpt-sidenav-border`) na pełną
-szerokość panelu i ten sam padding co nawigacja. Typowe zastosowanie: blok zalogowanego
-użytkownika, przełącznik motywu, wersja aplikacji. To płaski atrybut, nie dyrektywa — nic nie
-trzeba importować.
+## The footer — `kptSidenavFooter`
+An element carrying this attribute lands outside the scrollable area and stays stuck to the bottom of the
+panel, no matter how long the navigation is. It gets a top rule (`--kpt-sidenav-border`) across the panel's
+full width and the same padding as the navigation. Typical uses: the signed-in user block,
+a theme toggle, the application version. It is a plain attribute, not a directive — there is nothing
+to import.
 
-## Przykład
+## Example
     <kpt-sidenav kptShellSidenav>
-      <a href="#">Pulpit</a>
-      <a href="#">Ustawienia</a>
+      <a href="#">Dashboard</a>
+      <a href="#">Settings</a>
 
       <div kptSidenavFooter>
         <kpt-avatar name="Anna Kowalska" size="sm" />
@@ -28,16 +28,16 @@ trzeba importować.
       </div>
     </kpt-sidenav>
 
-W szynie ikon opatrz tekst stopki atrybutem `kptNavLabel` — zwinięty panel zostawi sam awatar.
+In the icon rail, mark the footer text with the `kptNavLabel` attribute — the collapsed panel then leaves just the avatar.
 
-## Szyna ikon (kpt-app-shell)
-Jeśli shell ma włączone `sidenavRailBreakpoint`, opatrz tekst pozycji atrybutem `kptNavLabel`,
-a nagłówek grupy `kptNavSection` — w zwiniętej szynie zostaje sama ikona, a etykieta jest
-chowana technicznie (visually hidden), więc czytnik ekranu wciąż zna nazwę pozycji:
+## The icon rail (kpt-app-shell)
+If the shell has `sidenavRailBreakpoint` enabled, mark an entry's text with the `kptNavLabel` attribute
+and a group heading with `kptNavSection` — in the collapsed rail only the icon remains, and the label is
+hidden technically (visually hidden), so a screen reader still knows the entry's name:
 
-    <a href="#"><kpt-icon name="list" /> <span kptNavLabel>Pulpit</span></a>
+    <a href="#"><kpt-icon name="list" /> <span kptNavLabel>Dashboard</span></a>
 
-To płaskie atrybuty, nie dyrektywy — nic nie trzeba importować. Bez ikony szyna będzie pusta.
+These are plain attributes, not directives — there is nothing to import. Without an icon the rail will be empty.
 
-## Tokeny
-`--kpt-sidenav-{bg,fg,border,width,rail-width}` (szerokość ustawia `kpt-app-shell`).
+## Tokens
+`--kpt-sidenav-{bg,fg,border,width,rail-width}` (the width is set by `kpt-app-shell`).

package/src/lib/skeleton/llms.txt

@@ -1,14 +1,14 @@
 # KptSkeleton (kpt-skeleton)
 
-Placeholder ładowania (shimmer). Import: `import { KptSkeleton } from '@konce-pt/angular';`
+A loading placeholder (shimmer). Import: `import { KptSkeleton } from '@konce-pt/angular';`
 
-## Wejścia
-- `variant`: 'text'|'circle'|'rect'; `width`: string; `height`: string; `lines`: number (dla text)
+## Inputs
+- `variant`: 'text'|'circle'|'rect'; `width`: string; `height`: string; `lines`: number (for text)
 
-## Przykłady
+## Examples
     <kpt-skeleton variant="text" [lines]="3" />
     <kpt-skeleton variant="circle" width="3rem" height="3rem" />
     <kpt-skeleton variant="rect" width="100%" height="8rem" />
 
-## Tokeny
-Gradient na `--kpt-color-surface-variant`.
+## Tokens
+A gradient over `--kpt-color-surface-variant`.

package/src/lib/slider/llms.txt

@@ -1,25 +1,25 @@
 # KptSlider (kpt-slider)
 
-Suwak wartości na Signal Forms. Import: `import { KptSlider } from '@konce-pt/angular';`
+A value slider on Signal Forms. Import: `import { KptSlider } from '@konce-pt/angular';`
 
-## Wejścia
-- `value`: model<number | [number, number]> — w trybie `range` para `[min, max]`, inaczej pojedyncza liczba
-- `range`: boolean — dwa uchwyty (zakres); `min`/`max`: number (zgodne z FormValueControl); `step`: number
-- Pod `[formField]` granic NIE bindujemy — deklarują je `min()`/`max()` w `form()`, a `FormField`
-  sam wstrzykuje je w wejścia `min`/`max`; `[min]`/`[max]` obok `[formField]` to błąd kompilacji
-  (FORM_FIELD_UNSUPPORTED_BINDING). Tryb `range` (wartość `[number, number]`) nie ma odpowiednika
-  wśród walidatorów (`min()`/`max()` przyjmują tylko pola liczbowe), więc łączy się go z `[(value)]`.
+## Inputs
+- `value`: model<number | [number, number]> — in `range` mode a `[min, max]` pair, otherwise a single number
+- `range`: boolean — two handles (a range); `min`/`max`: number (per FormValueControl); `step`: number
+- Under `[formField]` do NOT bind the bounds — they are declared by `min()`/`max()` in `form()`, and `FormField`
+  injects them into the `min`/`max` inputs itself; `[min]`/`[max]` next to `[formField]` is a compilation error
+  (FORM_FIELD_UNSUPPORTED_BINDING). The `range` mode (a `[number, number]` value) has no counterpart
+  among the validators (`min()`/`max()` only accept numeric fields), so it is paired with `[(value)]`.
 - `showValue`: boolean; `disabled`/`invalid`/`touched`; `touch`
 
-## Przykład
-    <kpt-slider [formField]="f.volume" [step]="5" showValue />   <!-- zakres z min()/max() w form() -->
+## Example
+    <kpt-slider [formField]="f.volume" [step]="5" showValue />   <!-- bounds from min()/max() in form() -->
     <kpt-slider [(value)]="volume" [min]="0" [max]="100" [step]="5" showValue />
-    <!-- zakres: wartość jest tablicą [min, max] -->
-    <kpt-slider range [(value)]="zakres" [min]="0" [max]="100" showValue />
+    <!-- range: the value is a [min, max] array -->
+    <kpt-slider range [(value)]="span" [min]="0" [max]="100" showValue />
 
-## Uwagi
-- Tryb `range` używa dwóch nałożonych `input[type=range]`; `pointer-events` aktywne tylko na uchwytach (szyna nie przechwytuje).
-- Uchwyty nie mogą się „minąć” — dolny jest klampowany do górnego i odwrotnie.
+## Notes
+- The `range` mode uses two stacked `input[type=range]` elements; `pointer-events` are active only on the handles (the track does not intercept them).
+- The handles cannot cross — the lower one is clamped to the upper one and vice versa.
 
-## Tokeny
-Track wypełniany `--kpt-color-primary`, tło `--kpt-color-surface-variant`.
+## Tokens
+The track is filled with `--kpt-color-primary`, the background is `--kpt-color-surface-variant`.

package/src/lib/speed-dial/llms.txt

@@ -1,16 +1,16 @@
 # KptSpeedDial (kpt-speed-dial)
 
-Speed dial — FAB rozwijający zestaw akcji. Buduje na `kpt-fab`.
+A speed dial — a FAB that fans out a set of actions. Built on `kpt-fab`.
 Import: `import { KptSpeedDial } from '@konce-pt/angular';`
 
-## Wejścia / wyjścia
-- `items`: KptMenuItem<T>[] — akcje (label, icon)
+## Inputs / outputs
+- `items`: KptMenuItem<T>[] — the actions (label, icon)
 - `direction`: 'up' | 'down' | 'left' | 'right' (KptSpeedDialDirection)
-- `icon`: string (domyślnie 'plus', obraca się o 45° po otwarciu); `ariaLabel`: string
+- `icon`: string (default 'plus', rotates 45° when open); `ariaLabel`: string
 - `selected`: KptMenuItem<T>
 
-## Przykład
+## Example
     <kpt-speed-dial [items]="actions" direction="up" (selected)="onAction($event)" />
 
-## Tokeny
-FAB główny z `kpt-fab`; akcje `--kpt-color-surface-raised`, `--kpt-elevation-2`.
+## Tokens
+The main FAB comes from `kpt-fab`; the actions use `--kpt-color-surface-raised`, `--kpt-elevation-2`.

package/src/lib/spinner/llms.txt

@@ -1,10 +1,10 @@
 # KptSpinner (kpt-spinner)
 
-Wskaźnik ładowania. Kolor z `currentColor`. Import: `import { KptSpinner } from '@konce-pt/angular';`
+Loading indicator. Color from `currentColor`. Import: `import { KptSpinner } from '@konce-pt/angular';`
 
-## Wejścia
-- `size`: string (np. '2rem', domyślnie '1.5rem'); `label`: string (aria)
+## Inputs
+- `size`: string (e.g. '2rem', default '1.5rem'); `label`: string (aria)
 
-## Przykład
+## Example
     <kpt-spinner />
-    <kpt-spinner size="2rem" label="Wczytywanie…" />
+    <kpt-spinner size="2rem" label="Loading…" />

package/src/lib/split-button/llms.txt

@@ -1,28 +1,28 @@
 # KptSplitButton (kpt-split-button)
 
-Przycisk dzielony — akcja główna + rozwijane menu akcji dodatkowych (CDK Overlay).
+A split button — a primary action + a drop-down menu of secondary actions (CDK Overlay).
 Import: `import { KptSplitButton } from '@konce-pt/angular';`
-Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+Requires `import '@angular/cdk/overlay-prebuilt.css';`
 
-## Wejścia
-- `variant`: KptButtonVariant (domyślnie 'filled')
+## Inputs
+- `variant`: KptButtonVariant (default 'filled')
 - `items`: KptMenuItem<T>[] — { label, value?, icon?, danger?, disabled?, separator? }
-  Honoruje też `header` (nieklikalny wiersz z `avatar`/`label`/`description`), `description`
-  (druga linia) i `badge` + `badgeVariant` (odznaka po prawej) — pełny opis w menu/llms.txt.
+  It also honors `header` (a non-clickable row with `avatar`/`label`/`description`), `description`
+  (a second line) and `badge` + `badgeVariant` (a badge on the right) — described in full in menu/llms.txt.
 - `disabled`: boolean
 
-## Wyjścia
-- `primaryClick`: void — klik przycisku głównego
-- `selected`: KptMenuItem<T> — wybór pozycji z menu
+## Outputs
+- `primaryClick`: void — a click on the primary button
+- `selected`: KptMenuItem<T> — an entry picked from the menu
 
-## Przykład
-    <kpt-split-button [items]="items" (primaryClick)="save()" (selected)="onItem($event)">Zapisz</kpt-split-button>
+## Example
+    <kpt-split-button [items]="items" (primaryClick)="save()" (selected)="onItem($event)">Save</kpt-split-button>
 
     items: KptMenuItem[] = [
-      { label: 'Zapisz jako szkic', value: 'draft' },
+      { label: 'Save as draft', value: 'draft' },
       { separator: true },
-      { label: 'Odrzuć', value: 'discard', danger: true },
+      { label: 'Discard', value: 'discard', danger: true },
     ];
 
-## Tokeny
-Kolory dziedziczone z przycisku; panel `--kpt-color-surface-raised`, `--kpt-elevation-3`.
+## Tokens
+Colors inherited from the button; the panel `--kpt-color-surface-raised`, `--kpt-elevation-3`.

package/src/lib/splitter/llms.txt

@@ -1,21 +1,21 @@
 # KptSplitter (kpt-splitter)
 
-Dwa panele z przeciąganym uchwytem. Panele przez sloty `[kptSplitStart]` i `[kptSplitEnd]`.
+Two panes with a draggable handle. The panes go into the `[kptSplitStart]` and `[kptSplitEnd]` slots.
 Import: `import { KptSplitter } from '@konce-pt/angular';`
 
-## Wejścia / model
+## Inputs / model
 - `orientation`: 'horizontal' | 'vertical' (KptSplitterOrientation)
-- `startSize`: model<number> — rozmiar pierwszego panelu w % (dwukierunkowe)
-- `minSize`: number (%) — minimalny rozmiar panelu
+- `startSize`: model<number> — the size of the first pane in % (two-way)
+- `minSize`: number (%) — the minimum pane size
 
-## Dostępność
-Uchwyt `role="separator"`, strzałki zmieniają rozmiar; przeciąganie myszą.
+## Accessibility
+The handle is a `role="separator"`, arrow keys resize it; dragging works with the mouse.
 
-## Przykład
+## Example
     <kpt-splitter orientation="horizontal" [(startSize)]="size">
-      <div kptSplitStart>Lewy</div>
-      <div kptSplitEnd>Prawy</div>
+      <div kptSplitStart>Left</div>
+      <div kptSplitEnd>Right</div>
     </kpt-splitter>
 
-## Tokeny
-Uchwyt `--kpt-color-border` → `--kpt-color-primary` (hover/focus).
+## Tokens
+The handle `--kpt-color-border` → `--kpt-color-primary` (hover/focus).

package/src/lib/stepper/llms.txt

@@ -1,21 +1,21 @@
 # KptStepper (kpt-stepper) + KptStep (kpt-step)
 
-Kreator kroków. Nagłówek z numerowanymi krokami + aktywna treść (leniwa).
+A step wizard. A header with numbered steps + the active content (lazy).
 Import: `import { KptStepper, KptStep } from '@konce-pt/angular';`
 
 ## KptStepper
-- `activeIndex`: model<number>; metody publiczne: `next()`, `prev()`, `goTo(i)`
-- `animated`: boolean (domyślnie true) — animacja przejścia (fade+slide, czysty CSS)
-- `animationDuration`: number (domyślnie 500) — czas animacji w ms
+- `activeIndex`: model<number>; public methods: `next()`, `prev()`, `goTo(i)`
+- `animated`: boolean (default true) — the transition animation (fade+slide, pure CSS)
+- `animationDuration`: number (default 500) — animation time in ms
 
 ## KptStep
-- `label`: string (wymagane)
+- `label`: string (required)
 
-## Przykład
+## Example
     <kpt-stepper #s [(activeIndex)]="step">
-      <kpt-step label="Konto">…<kpt-button (click)="s.next()">Dalej</kpt-button></kpt-step>
-      <kpt-step label="Profil">…</kpt-step>
+      <kpt-step label="Account">…<kpt-button (click)="s.next()">Next</kpt-button></kpt-step>
+      <kpt-step label="Profile">…</kpt-step>
     </kpt-stepper>
 
-## Tokeny
-Aktywny/ukończony krok: `--kpt-color-primary` (marker, konektor).
+## Tokens
+The active/completed step: `--kpt-color-primary` (marker, connector).

package/src/lib/switch/llms.txt

@@ -1,17 +1,17 @@
 # KptSwitch (kpt-switch)
 
-Przełącznik (toggle) na Signal Forms (`FormCheckboxControl`, model `checked`). `role="switch"`.
+A toggle switch on Signal Forms (`FormCheckboxControl`, the `checked` model). `role="switch"`.
 Import: `import { KptSwitch } from '@konce-pt/angular';`
 
-## Użycie
-    <kpt-switch [formField]="f.notifications" label="Powiadomienia" />
-    <!-- tekst stanu zmienia się przy przełączaniu -->
-    <kpt-switch [(checked)]="on" onLabel="Włączony" offLabel="Wyłączony" />
+## Usage
+    <kpt-switch [formField]="f.notifications" label="Notifications" />
+    <!-- the state text changes as it is toggled -->
+    <kpt-switch [(checked)]="on" onLabel="On" offLabel="Off" />
 
-## Wejścia
-- `checked`: model<boolean>; `label`: string (statyczny); `disabled`/`invalid`/`touched`: boolean; output `touch`.
-- `labelPosition`: 'start' | 'end' (domyślnie 'end') — etykieta `label` z lewej lub z prawej przełącznika.
-- `onLabel`/`offLabel`: string — tekst stanu; wyświetlany wg `checked` (włączony podświetlony `--kpt-color-primary`). Można łączyć ze statycznym `label`.
+## Inputs
+- `checked`: model<boolean>; `label`: string (static); `disabled`/`invalid`/`touched`: boolean; the `touch` output.
+- `labelPosition`: 'start' | 'end' (default 'end') — the `label` to the left or to the right of the switch.
+- `onLabel`/`offLabel`: string — the state text; shown according to `checked` (the on state highlighted with `--kpt-color-primary`). Can be combined with a static `label`.
 
-## Tokeny
+## Tokens
 `--kpt-color-primary`, `--kpt-color-border-strong`, `--kpt-color-surface`, `--kpt-elevation-1`.

package/src/lib/switch-group/llms.txt

@@ -1,24 +1,24 @@
 # KptSwitchGroup (kpt-switch-group)
 
-Grupa przełączników. Domyślnie pojedynczy wybór (wzajemnie wykluczające się) — włączenie jednego wyłącza pozostałe.
-Z `multiple` przechodzi w tryb wielokrotny (wartość to tablica zaznaczonych opcji).
-Na Signal Forms (`FormValueControl<T | T[] | null>`, model `value`). Import: `import { KptSwitchGroup } from '@konce-pt/angular';`
+A group of switches. Single choice by default (mutually exclusive) — turning one on turns the others off.
+With `multiple` it switches to multi-select mode (the value is an array of the selected options).
+Built on Signal Forms (`FormValueControl<T | T[] | null>`, the `value` model). Import: `import { KptSwitchGroup } from '@konce-pt/angular';`
 
-## Użycie
+## Usage
     <kpt-switch-group [(value)]="plan" [options]="plans" />
-    <!-- wielokrotny wybór: value = T[] -->
+    <!-- multi-select: value = T[] -->
     <kpt-switch-group multiple [(value)]="tags" [options]="tagOptions" />
     <!-- plans: KptOption<T>[] = [{ label, value, disabled? }, …] -->
 
-## Wejścia
-- `value`: model<T | T[] | null> — pojedynczy: wartość opcji lub `null`; multiple: tablica wartości zaznaczonych opcji.
-- `options`: KptOption<T>[] — lista opcji.
-- `multiple`: boolean (domyślnie false) — tryb wielokrotnego wyboru; wartość staje się tablicą `T[]`.
-- `orientation`: 'vertical' (domyślnie) | 'horizontal'.
-- `allowDeselect`: boolean (domyślnie true) — czy kliknięcie aktywnej opcji ją odznacza (tylko tryb pojedynczy; w multiple odznaczanie zawsze dozwolone).
-- `disabled`/`invalid`/`touched`: boolean; output `touch`.
+## Inputs
+- `value`: model<T | T[] | null> — single: the option's value or `null`; multiple: an array of the selected options' values.
+- `options`: KptOption<T>[] — the list of options.
+- `multiple`: boolean (default false) — multi-select mode; the value becomes a `T[]` array.
+- `orientation`: 'vertical' (default) | 'horizontal'.
+- `allowDeselect`: boolean (default true) — whether clicking the active option deselects it (single mode only; in multiple mode deselection is always allowed).
+- `disabled`/`invalid`/`touched`: boolean; the `touch` output.
 
-## Zasada działania
-Każdy element to `kpt-switch` z jednokierunkowym `[checked]`. W trybie pojedynczym włączenie ustawia `value` na daną
-opcję, co automatycznie gasi pozostałe. W trybie `multiple` wartość jest normalizowana do tablicy — włączenie dodaje
-wartość opcji, wyłączenie ją usuwa. Renderuje `kpt-switch`, więc dziedziczy jego wygląd/tokeny.
+## How it works
+Every entry is a `kpt-switch` with a one-way `[checked]`. In single mode turning one on sets `value` to that
+option, which switches the others off automatically. In `multiple` mode the value is normalized to an array — turning
+one on adds the option's value, turning it off removes it. It renders `kpt-switch`, so it inherits its look and tokens.

package/src/lib/tabs/llms.txt

@@ -1,21 +1,21 @@
 # KptTabs (kpt-tabs) + KptTab (kpt-tab)
 
-Zakładki. Treść zakładek renderowana leniwie (tylko aktywna).
+Tabs. Tab content is rendered lazily (only the active one).
 Import: `import { KptTabs, KptTab } from '@konce-pt/angular';`
 
 ## KptTabs
-- `activeIndex`: model<number> (dwukierunkowe)
-- `animated`: boolean (domyślnie true) — animacja przejścia (fade+slide, czysty CSS)
-- `animationDuration`: number (domyślnie 500) — czas animacji w ms
+- `activeIndex`: model<number> (two-way)
+- `animated`: boolean (default true) — the transition animation (fade+slide, pure CSS)
+- `animationDuration`: number (default 500) — animation time in ms
 
 ## KptTab
-- `label`: string (wymagane); `disabled`: boolean
+- `label`: string (required); `disabled`: boolean
 
-## Przykład
+## Example
     <kpt-tabs [(activeIndex)]="tab">
-      <kpt-tab label="Ogólne">…</kpt-tab>
-      <kpt-tab label="Zaawansowane">…</kpt-tab>
+      <kpt-tab label="General">…</kpt-tab>
+      <kpt-tab label="Advanced">…</kpt-tab>
     </kpt-tabs>
 
-## Tokeny
-Aktywna zakładka: `--kpt-color-primary` (tekst + dolna krawędź).
+## Tokens
+The active tab: `--kpt-color-primary` (text + bottom edge).

package/src/lib/textarea/llms.txt

@@ -1,14 +1,14 @@
 # KptTextarea (kpt-textarea)
 
-Pole wieloliniowe na Signal Forms, z opcjonalnym auto-resize.
+A multi-line field on Signal Forms, with optional auto-resize.
 Import: `import { KptTextarea } from '@konce-pt/angular';`
 
-## Wejścia
+## Inputs
 - `value`: model<string>; `placeholder`: string; `rows`: number; `autoResize`: boolean
 - `disabled`/`readonly`/`invalid`/`touched`: boolean; `touch`: output
 
-## Przykład
-    <kpt-textarea [formField]="f.notes" placeholder="Notatki…" autoResize />
+## Example
+    <kpt-textarea [formField]="f.notes" placeholder="Notes…" autoResize />
 
-## Tokeny
+## Tokens
 `--kpt-form-field-*`.

package/src/lib/timeline/llms.txt

@@ -1,22 +1,22 @@
 # KptTimeline (kpt-timeline)
 
-Oś czasu — pionowa lista zdarzeń z markerami. Import: `import { KptTimeline } from '@konce-pt/angular';`
+A timeline — a vertical list of events with markers. Import: `import { KptTimeline } from '@konce-pt/angular';`
 
-## Wejścia
+## Inputs
 - `items`: KptTimelineItem[]
 
 ### KptTimelineItem
-- `title`: string (wymagane)
-- `description?`: string; `time?`: string; `icon?`: string (nazwa KptIconName)
-- `variant?`: 'neutral' | 'primary' | 'success' | 'danger' | 'warning' | 'info' (domyślnie 'primary')
+- `title`: string (required)
+- `description?`: string; `time?`: string; `icon?`: string (a KptIconName)
+- `variant?`: 'neutral' | 'primary' | 'success' | 'danger' | 'warning' | 'info' (default 'primary')
 
-## Przykład
+## Example
     <kpt-timeline [items]="events" />
 
     events: KptTimelineItem[] = [
-      { title: 'Utworzono', time: '10:00', variant: 'success', icon: 'check' },
-      { title: 'Wysłano', time: '12:30', variant: 'info' },
+      { title: 'Created', time: '10:00', variant: 'success', icon: 'check' },
+      { title: 'Sent', time: '12:30', variant: 'info' },
     ];
 
-## Tokeny
-Marker wg wariantu (`--kpt-color-{variant}`); linia `--kpt-color-border`.
+## Tokens
+The marker follows the variant (`--kpt-color-{variant}`); the line `--kpt-color-border`.

package/src/lib/toast/llms.txt

@@ -1,22 +1,22 @@
 # KptToast (kpt-toast-container + KptToastService)
 
-Powiadomienia (toasty) sterowane serwisem. Kontener renderuje je fixed w rogu.
+Notifications (toasts) driven by a service. The container renders them fixed in a corner.
 Import: `import { KptToastService, KptToastContainer } from '@konce-pt/angular';`
 
-## Ustawienie
-Umieść kontener raz w aplikacji: `<kpt-toast-container />`.
+## Setup
+Place the container once in the application: `<kpt-toast-container />`.
 
-## Serwis (KptToastService, providedIn: root)
+## The service (KptToastService, providedIn: root)
     private toast = inject(KptToastService);
-    toast.success('Zapisano', { title: 'OK' });
-    toast.error('Błąd połączenia');
+    toast.success('Saved', { title: 'OK' });
+    toast.error('Connection failed');
     toast.info(msg, opts); toast.warning(msg, opts);
-    toast.show(msg, { variant, title, duration }); // duration ms, 0 = bez auto-zamykania
+    toast.show(msg, { variant, title, duration }); // duration in ms, 0 = no auto-dismiss
     toast.dismiss(id); toast.clear();
 
 ## KptToast
 `{ id, message, title?, variant: 'info'|'success'|'warning'|'danger', duration }`
 
-## Tokeny
-`--kpt-color-surface-raised`, `--kpt-elevation-3`, akcent `--kpt-color-{info,success,warning,danger}`,
-pozycja `--kpt-z-toast`.
+## Tokens
+`--kpt-color-surface-raised`, `--kpt-elevation-3`, the accent `--kpt-color-{info,success,warning,danger}`,
+stacking `--kpt-z-toast`.