@konce-pt/angular 0.7.10 → 0.7.12

package/src/lib/menu/llms.txt

@@ -1,28 +1,28 @@
 # KptMenu (kpt-menu)
 
-Menu rozwijane (dropdown) na CDK Overlay. Trigger przez projekcję, pozycje przez `items`.
-Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+A dropdown menu on CDK Overlay. The trigger comes through projection, the entries through `items`.
+Requires `import '@angular/cdk/overlay-prebuilt.css';`
 Import: `import { KptMenu, KptMenuItem } from '@konce-pt/angular';`
 
-## Wejścia / wyjścia
+## Inputs / outputs
 - `items`: KptMenuItem[]
-- `selected`: output<KptMenuItem> — emitowany tylko dla zwykłych pozycji (nie dla nagłówków)
+- `selected`: output<KptMenuItem> — emitted only for regular entries (not for headers)
 
 ## KptMenuItem
 - `label?`, `value?`, `icon?`, `disabled?`, `danger?`, `separator?`
-- `description?: string` — druga linia tekstu (e-mail, rola, opis akcji)
-- `badge?: string | number` — odznaka po prawej stronie pozycji; `badgeVariant?: KptBadgeVariant`
-  (domyślnie `primary`). Renderowana przez `kpt-badge`, więc liczby powyżej 99 skracają się do `99+`.
-- `avatar?: { src?, name?, icon? }` — awatar po lewej (`kpt-avatar`, rozmiar `sm`); `name` bez `src`
-  daje inicjały. Używany w wierszu nagłówkowym.
-- `header?: boolean` — wiersz nagłówkowy: nieklikalny blok tekstu zamiast pozycji menu. Mieści dane
-  zalogowanego użytkownika (`avatar` + `label` + `description`) albo opis funkcji menu. Renderowany
-  jako `<div role="presentation">` — nie łapie fokusu i nie jest `menuitem`.
-- `items?`, `url?` — używane przez menubar / megamenu
-
-Pola `header`, `description`, `badge` i `avatar` honorują też `kpt-context-menu` i `kpt-split-button`.
-
-## Przykład
+- `description?: string` — a second line of text (an e-mail, a role, an action description)
+- `badge?: string | number` — a badge on the right side of the entry; `badgeVariant?: KptBadgeVariant`
+  (default `primary`). Rendered through `kpt-badge`, so numbers above 99 collapse to `99+`.
+- `avatar?: { src?, name?, icon? }` — an avatar on the left (`kpt-avatar`, size `sm`); `name` without `src`
+  produces initials. Used in the header row.
+- `header?: boolean` — a header row: a non-clickable block of text instead of a menu entry. It holds the
+  signed-in user's details (`avatar` + `label` + `description`) or a description of what the menu does. Rendered
+  as a `<div role="presentation">` — it does not take focus and is not a `menuitem`.
+- `items?`, `url?` — used by the menubar / megamenu
+
+The `header`, `description`, `badge` and `avatar` fields are honored by `kpt-context-menu` and `kpt-split-button` too.
+
+## Example
     <kpt-menu [items]="items" (selected)="onSelect($event)">
       <kpt-avatar name="Anna Kowalska" />
     </kpt-menu>
@@ -30,17 +30,17 @@ Pola `header`, `description`, `badge` i `avatar` honorują też `kpt-context-men
     items: KptMenuItem[] = [
       { header: true, avatar: { src: '/u/anna.jpg' }, label: 'Anna Kowalska', description: 'anna@example.com' },
       { separator: true },
-      { label: 'Profil', value: 'profile', icon: 'user' },
-      { label: 'Powiadomienia', value: 'notif', icon: 'bell', badge: 4, badgeVariant: 'success' },
+      { label: 'Profile', value: 'profile', icon: 'user' },
+      { label: 'Notifications', value: 'notif', icon: 'bell', badge: 4, badgeVariant: 'success' },
       { separator: true },
-      { label: 'Wyloguj', value: 'logout', icon: 'logout', danger: true },
+      { label: 'Sign out', value: 'logout', icon: 'logout', danger: true },
     ];
 
-## Tokeny
-Panel `--kpt-color-surface-raised`, `--kpt-elevation-3`; pozycja danger `--kpt-color-danger`;
-opis i ikony `--kpt-color-on-surface-muted`, `--kpt-font-size-xs`.
+## Tokens
+The panel `--kpt-color-surface-raised`, `--kpt-elevation-3`; a danger entry `--kpt-color-danger`;
+descriptions and icons `--kpt-color-on-surface-muted`, `--kpt-font-size-xs`.
 
 ## A11y
-Panel `role="menu"`, pozycje `role="menuitem"` (natywne `<button>` — obsługa klawiatury bez
-dodatkowego kodu). Nagłówek jest poza nawigacją klawiaturą. Wartość odznaki wchodzi w nazwę dostępną
-pozycji („Powiadomienia 4").
+The panel is `role="menu"`, entries are `role="menuitem"` (native `<button>` elements — keyboard support with no
+extra code). The header sits outside keyboard navigation. The badge value becomes part of the entry's accessible
+name ("Notifications 4").

package/src/lib/menubar/llms.txt

@@ -1,21 +1,21 @@
 # KptMenubar (kpt-menubar)
 
-Pozioma belka menu z rozwijanymi pod-menu. Pozycje bez `items` działają jak akcje.
-Pod-menu na CDK Overlay (doczepiane do `body`, nieprzycinane przez `overflow: hidden`).
-Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+A horizontal menu bar with drop-down submenus. Entries without `items` act as actions.
+Submenus sit on CDK Overlay (attached to `body`, never clipped by `overflow: hidden`).
+Requires `import '@angular/cdk/overlay-prebuilt.css';`
 Import: `import { KptMenubar } from '@konce-pt/angular';`
 
-## Wejścia / wyjścia
-- `items`: KptMenuItem<T>[] — pozycje górne; pod-menu w `items?` każdej pozycji
+## Inputs / outputs
+- `items`: KptMenuItem<T>[] — the top-level entries; submenus live in each entry's `items?`
 - `selected`: KptMenuItem<T>
 
-## Przykład
+## Example
     <kpt-menubar [items]="items" (selected)="onSelect($event)" />
 
     items: KptMenuItem[] = [
-      { label: 'Plik', items: [{ label: 'Nowy' }, { separator: true }, { label: 'Zamknij', danger: true }] },
-      { label: 'Pomoc' },
+      { label: 'File', items: [{ label: 'New' }, { separator: true }, { label: 'Close', danger: true }] },
+      { label: 'Help' },
     ];
 
-## Tokeny
-Belka `--kpt-color-surface-raised`; dropdown `--kpt-elevation-3`.
+## Tokens
+The bar `--kpt-color-surface-raised`; the dropdown `--kpt-elevation-3`.

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

@@ -1,15 +1,15 @@
 # KptMeterGroup (kpt-meter-group)
 
-Wielosegmentowy miernik (meter group) z opcjonalną legendą.
+A multi-segment meter group with an optional legend.
 Import: `import { KptMeterGroup } from '@konce-pt/angular';`
 
-## Wejścia
+## Inputs
 - `values`: KptMeterItem[] — { label, value, color? }
-- `max`: number | undefined — suma odniesienia (domyślnie suma wartości = 100%)
-- `showLegend`: boolean (domyślnie true)
+- `max`: number | undefined — the reference total (by default the sum of the values = 100%)
+- `showLegend`: boolean (default true)
 
-## Przykład
-    <kpt-meter-group [values]="[{label:'Użyte', value:70}, {label:'Wolne', value:30}]" />
+## Example
+    <kpt-meter-group [values]="[{label:'Used', value:70}, {label:'Free', value:30}]" />
 
-## Tokeny
-Segmenty: paleta `--kpt-color-{primary,info,success,warning,danger}` lub własny `color`.
+## Tokens
+Segments: the `--kpt-color-{primary,info,success,warning,danger}` palette or a custom `color`.

package/src/lib/order-list/llms.txt

@@ -1,17 +1,17 @@
 # KptOrderList (kpt-order-list)
 
-Lista z ręcznym porządkowaniem elementów (w górę/dół). Zaznacz element i przesuń przyciskami.
-Szablon elementu przez projekcję `<ng-template let-item>`.
+A list with manual reordering (up/down). Select an item and move it with the buttons.
+The item template comes through projection: `<ng-template let-item>`.
 Import: `import { KptOrderList } from '@konce-pt/angular';`
 
-## Wejścia / model
-- `items`: model<T[]> (dwukierunkowe — zwraca nową kolejność)
+## Inputs / model
+- `items`: model<T[]> (two-way — returns the new order)
 - `header`: string
 
-## Przykład
-    <kpt-order-list [(items)]="tasks" header="Kolejność">
+## Example
+    <kpt-order-list [(items)]="tasks" header="Order">
       <ng-template let-item>{{ item.name }}</ng-template>
     </kpt-order-list>
 
-## Tokeny
-Zaznaczenie `--kpt-color-primary`; przyciski `--kpt-color-surface-raised`.
+## Tokens
+Selection `--kpt-color-primary`; buttons `--kpt-color-surface-raised`.

package/src/lib/paginator/llms.txt

@@ -1,22 +1,22 @@
 # KptPaginator (kpt-paginator)
 
-Paginator sterowany sygnałami. Import: `import { KptPaginator } from '@konce-pt/angular';`
+A paginator driven by signals. Import: `import { KptPaginator } from '@konce-pt/angular';`
 
-## Selektor
+## Selector
 `kpt-paginator`
 
-## Wejścia / modele
-- `length`: number (wymagane) — łączna liczba elementów
-- `pageSize`: model<number> (domyślnie 10) — dwukierunkowe
-- `pageIndex`: model<number> od 0 (domyślnie 0) — dwukierunkowe
-- `pageSizeOptions`: number[] (domyślnie [5,10,20,50])
+## Inputs / models
+- `length`: number (required) — the total number of items
+- `pageSize`: model<number> (default 10) — two-way
+- `pageIndex`: model<number> from 0 (default 0) — two-way
+- `pageSizeOptions`: number[] (default [5,10,20,50])
 
-## Przykład
+## Example
     <kpt-paginator [length]="total()" [(pageIndex)]="page" [(pageSize)]="size" />
 
-Pokazuje „X–Y z Z", wybór rozmiaru strony oraz przyciski poprzednia/następna.
-Przy zmianie długości/rozmiaru samoczynnie koryguje `pageIndex` (effect).
+It shows "X–Y of Z", the page size selector and previous/next buttons.
+When the length or the size changes it corrects `pageIndex` on its own (an 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`.
+The labels ("Rows:", the range separator, the page aria labels) come from i18n (the `paginator` namespace).
+English by default; switch or override it through `provideKptI18n` — see `i18n/llms.txt`.

package/src/lib/panel/llms.txt

@@ -1,20 +1,20 @@
 # KptPanel (kpt-panel)
 
-Panel z nagłówkiem i opcjonalnym zwijaniem. Import: `import { KptPanel } from '@konce-pt/angular';`
+A panel with a header and optional collapsing. Import: `import { KptPanel } from '@konce-pt/angular';`
 
-## Wejścia / model
+## Inputs / model
 - `header`: string
-- `toggleable`: boolean — pokazuje przycisk zwijania
-- `collapsed`: model<boolean> (dwukierunkowe)
-- `animated`: boolean (domyślnie true) — animacja zwijania (CSS grid, czysty CSS)
-- `animationDuration`: number (domyślnie 500) — czas animacji w ms
-- Akcje nagłówka: projekcja `[kptPanelActions]`. Treść: `<ng-content>`.
+- `toggleable`: boolean — shows the collapse button
+- `collapsed`: model<boolean> (two-way)
+- `animated`: boolean (default true) — the collapse animation (CSS grid, pure CSS)
+- `animationDuration`: number (default 500) — animation time in ms
+- Header actions: the `[kptPanelActions]` projection. Content: `<ng-content>`.
 
-## Przykład
-    <kpt-panel header="Ustawienia" toggleable>
+## Example
+    <kpt-panel header="Settings" toggleable>
       <button kptPanelActions>…</button>
-      Treść…
+      Content…
     </kpt-panel>
 
-## Tokeny
-Nagłówek `--kpt-color-surface-variant`; ramka `--kpt-color-border`.
+## Tokens
+The header `--kpt-color-surface-variant`; the border `--kpt-color-border`.

package/src/lib/password/llms.txt

@@ -1,20 +1,23 @@
 # KptPassword (kpt-password)
 
-Pole hasła z przełącznikiem widoczności i opcjonalnym miernikiem siły. Signal Forms.
+A password field with a visibility toggle and an optional strength meter. Signal Forms.
 Import: `import { KptPassword } from '@konce-pt/angular';`
 
-## Wejścia / model
-- `value`: model<string> (lub `formField`)
-- `feedback`: boolean — pokazuje miernik siły (4 paski + etykieta)
+## Inputs / model
+- `value`: model<string> (or `formField`)
+- `feedback`: boolean — shows the strength meter (4 bars + a label)
 - `placeholder`: string
+- `id`: string — the id of the native field; ties the label to `kpt-form-field [controlId]`
+- `autocomplete`: string | null = 'current-password' — in sign-up and reset flows set it to
+  `new-password`, otherwise the password manager fills in the old password instead of proposing a new one
 - `disabled`/`invalid`/`touched`: boolean; `touch`: output
 
-## Siła hasła
-Punktacja 0–4: długość ≥8, małe+wielkie litery, cyfra, znak specjalny. Kolory: danger→warning→info→success.
+## Password strength
+A 0–4 score: length ≥8, lower+upper case, a digit, a special character. Colors: danger→warning→info→success.
 
-## Przykład
+## Example
     <kpt-password [formField]="f.password" feedback />
     <kpt-password [(value)]="pass" />
 
-## Tokeny
-Pole `--kpt-form-field-*`; paski miernika `--kpt-color-{danger,warning,info,success}`.
+## Tokens
+The field `--kpt-form-field-*`; the meter bars `--kpt-color-{danger,warning,info,success}`.

package/src/lib/pick-list/llms.txt

@@ -1,17 +1,17 @@
 # KptPickList (kpt-pick-list)
 
-Transfer elementów między dwiema listami (źródło ↔ cel). Zaznacz i przenieś (pojedynczo/wszystko).
-Szablon elementu przez projekcję `<ng-template let-item>`.
+Transfers items between two lists (source and target). Select and move them (one at a time or all).
+The item template comes through projection: `<ng-template let-item>`.
 Import: `import { KptPickList } from '@konce-pt/angular';`
 
-## Wejścia / model
-- `source`: model<T[]>; `target`: model<T[]> (oba dwukierunkowe)
+## Inputs / model
+- `source`: model<T[]>; `target`: model<T[]> (both two-way)
 - `sourceHeader`/`targetHeader`: string
 
-## Przykład
-    <kpt-pick-list [(source)]="available" [(target)]="selected" sourceHeader="Dostępne" targetHeader="Wybrane">
+## Example
+    <kpt-pick-list [(source)]="available" [(target)]="selected" sourceHeader="Available" targetHeader="Selected">
       <ng-template let-item>{{ item.name }}</ng-template>
     </kpt-pick-list>
 
-## Tokeny
-Zaznaczenie `--kpt-color-primary`; nagłówki `--kpt-color-surface-variant`.
+## Tokens
+Selection `--kpt-color-primary`; headers `--kpt-color-surface-variant`.

package/src/lib/popover/llms.txt

@@ -1,17 +1,17 @@
 # KptPopover (kpt-popover)
 
-Popover — dowolna treść w dymku na CDK Overlay (bogatszy niż tooltip).
-Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+A popover — arbitrary content in a bubble on CDK Overlay (richer than a tooltip).
+Requires `import '@angular/cdk/overlay-prebuilt.css';`
 Import: `import { KptPopover } from '@konce-pt/angular';`
 
-## Sloty
-- element z atrybutem `kptPopoverTrigger` = wyzwalacz; reszta treści = panel
+## Slots
+- the element carrying the `kptPopoverTrigger` attribute = the trigger; everything else = the panel
 
-## Przykład
+## Example
     <kpt-popover>
-      <kpt-button kptPopoverTrigger variant="outline">Szczegóły</kpt-button>
-      <div>Bogata treść popovera…</div>
+      <kpt-button kptPopoverTrigger variant="outline">Details</kpt-button>
+      <div>Rich popover content…</div>
     </kpt-popover>
 
-## Tokeny
+## Tokens
 `--kpt-color-surface-raised`, `--kpt-elevation-3`.

package/src/lib/progress/llms.txt

@@ -1,16 +1,16 @@
 # KptProgress (kpt-progress)
 
-Wskaźnik postępu — liniowy lub kołowy, określony (0–100) lub nieokreślony (`value`=null).
+A progress indicator — linear or circular, determinate (0–100) or indeterminate (`value`=null).
 Import: `import { KptProgress } from '@konce-pt/angular';`
 
-## Wejścia
+## Inputs
 - `value`: number|null (null = indeterminate); `type`: 'linear'|'circular'
-- `variant`: 'primary'|'success'|'danger'|'warning'|'info'; `diameter`: number (kołowy)
+- `variant`: 'primary'|'success'|'danger'|'warning'|'info'; `diameter`: number (circular)
 
-## Przykłady
+## Examples
     <kpt-progress [value]="60" />
     <kpt-progress type="circular" [value]="75" variant="success" />
     <kpt-progress [value]="null" />
 
-## Tokeny
-`--kpt-color-{primary,success,danger,warning,info}`, tło `--kpt-color-surface-variant`.
+## Tokens
+`--kpt-color-{primary,success,danger,warning,info}`, the track `--kpt-color-surface-variant`.

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

@@ -1,15 +1,15 @@
 # KptRadioGroup (kpt-radio-group)
 
-Grupa przycisków opcji na Signal Forms (`FormValueControl<T>`). Opcje przez `options`.
+A radio button group on Signal Forms (`FormValueControl<T>`). Options through `options`.
 Import: `import { KptRadioGroup, KptOption } from '@konce-pt/angular';`
 
-## Użycie
+## Usage
     plans: KptOption<string>[] = [{label:'Free',value:'free'},{label:'Pro',value:'pro'}];
     <kpt-radio-group [formField]="f.plan" [options]="plans" />
 
-## Wejścia
+## Inputs
 - `value`: model<T>; `options`: KptOption<T>[] `{ label, value, disabled? }`
-- `disabled`/`invalid`/`touched`: boolean; `name`: string (auto); output `touch`.
+- `disabled`/`invalid`/`touched`: boolean; `name`: string (automatic); the `touch` output.
 
-## Tokeny
+## Tokens
 `--kpt-color-primary`, `--kpt-form-field-border`.

package/src/lib/rating/llms.txt

@@ -1,14 +1,14 @@
 # KptRating (kpt-rating)
 
-Ocena gwiazdkami na Signal Forms. Import: `import { KptRating } from '@konce-pt/angular';`
+A star rating on Signal Forms. Import: `import { KptRating } from '@konce-pt/angular';`
 
-## Wejścia
-- `value`: model<number>; `count`: number (liczba gwiazdek, domyślnie 5)
+## Inputs
+- `value`: model<number>; `count`: number (number of stars, default 5)
 - `readonly`/`disabled`/`touched`: boolean; `touch`: output
 
-## Przykład
+## Example
     <kpt-rating [formField]="f.score" [count]="5" />
     <kpt-rating [value]="4" readonly />
 
-## Tokeny
-Wypełnione gwiazdki `--kpt-color-warning`; puste `--kpt-color-border-strong`.
+## Tokens
+Filled stars `--kpt-color-warning`; empty ones `--kpt-color-border-strong`.

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

@@ -1,45 +1,64 @@
 # KptRichText (kpt-rich-text)
 
-Lekki edytor tekstu sformatowanego (contenteditable) z konfigurowalnym paskiem sekcji.
-Wartość = HTML. Bez zależności zewnętrznych. Signal Forms.
-Popover kolorów na CDK Overlay — wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+A lightweight rich text editor (contenteditable) with a configurable, sectioned toolbar.
+The value is HTML. No external dependencies. Signal Forms.
+The color popover sits on CDK Overlay — requires `import '@angular/cdk/overlay-prebuilt.css';`
 Import: `import { KptRichText, KptRichTool, KptRichToolbar } from '@konce-pt/angular';`
 
-## Wejścia
+## Inputs
 - `value`: model<string> (HTML)
-- `toolbar`: KptRichToolbar = KptRichTool[] | KptRichTool[][] (płaska lista lub grupy=sekcje).
-  Pominięcie narzędzia/grupy je wyłącza; między grupami separator. Domyślnie pełny pasek w 5 sekcjach.
+- `toolbar`: KptRichToolbar = KptRichTool[] | KptRichTool[][] (a flat list, or groups = sections).
+  Leaving a tool or a group out disables it; groups are separated by a divider. The full toolbar in 5 sections by default.
 - `placeholder`: string; `disabled`/`invalid`/`touched`: boolean; `touch`: output
+- `maxListLevel`: number = 6 — the maximum list nesting depth. The limit applies to interaction
+  (Tab and the `indent`/`outdent` tools); pasted content is not flattened, so that no data is lost.
 
-## Narzędzia (KptRichTool)
-- Schowek: `copy`, `paste` (z formatowaniem, oczyszczone), `pasteText` (bez formatowania)
-- Styl: `heading` (select: Normalny/paragraf + Nagłówek 1–6)
+## Tools (KptRichTool)
+- Clipboard: `copy`, `paste` (with formatting, sanitized), `pasteText` (without formatting)
+- Style: `heading` (a select: Normal/paragraph + Heading 1–6)
 - Format: `bold`, `italic`, `underline`, `strike`, `ul`, `ol`
-- Kolory: `foreColor` (kolor tekstu), `backColor` (kolor tła) — popover z próbkami + `input type=color`
-- Wyrównanie: `alignLeft`, `alignCenter`, `alignRight`, `alignJustify`
-- `table` (wstaw tabelę: popover z siatką NxM). W komórce prawy klik = menu kontekstowe
-  (wstaw/usuń wiersz i kolumnę, nagłówek wiersza/kolumny — przełącza td↔th, kolor tła i wyrównanie
-  komórki, obramowanie tabeli/komórki — kolor + grubość (cienkie/średnie/grube) lub bez, usuń tabelę).
-  Przeciąganie po komórkach = prostokątne zaznaczenie (podświetlone); scalanie/dzielenie komórek
-  (colspan/rowspan) z menu; operacje komórki (tło, wyrównanie, obramowanie) działają na całym zaznaczeniu.
-  Przeciąganie prawej krawędzi kolumny zmienia jej szerokość.
-  Odłożone: selekcja nieregularna, Ctrl+Backspace, zbiorcze formatowanie z górnego paska.
-- `link` (prompt URL), `clear` (usuń formatowanie), `html` (przełącznik podglądu źródła HTML — edycja surowego HTML)
+- List indentation: `indent` (add an indent), `outdent` (remove one) — they work only inside an `li`,
+  nesting per the specification (`li > ul/ol > li`, a sublist inherits the parent list's type).
+  They are only active where they would do something (outside a list and at the limit the button is dimmed).
+  Level markers cycle every 3 (as in word processors): `ol` 1. → a. → i., `ul` • → ○ → ▪.
+  The `list-style-type` rules apply in the editor view (`.kpt-rich-text__editor`) down to level 6.
+  The saved HTML carries no classes — when rendering `value` outside the editor, wrap it in `.kpt-rich-content`
+  from `@konce-pt/styles` so the lists look the same.
+- Colors: `foreColor` (text color), `backColor` (background color) — a popover with swatches + an `input type=color`
+- Alignment: `alignLeft`, `alignCenter`, `alignRight`, `alignJustify`
+- `table` (insert a table: a popover with an NxM grid). Inside a cell, right-click opens a context menu
+  (insert/remove a row and a column, a row/column header — toggling td↔th, cell background color and alignment,
+  table/cell borders — color + thickness (thin/medium/thick) or none, delete the table).
+  Dragging across cells makes a rectangular selection (highlighted); merging/splitting cells
+  (colspan/rowspan) from the menu; cell operations (background, alignment, borders) apply to the whole selection.
+  Dragging a column's right edge changes its width.
+  Deferred: irregular selection, Ctrl+Backspace, bulk formatting from the top toolbar.
+- `link` (a URL prompt), `clear` (remove formatting), `html` (a toggle for the HTML source view — editing raw HTML)
 
-## Przykład
-    <kpt-rich-text [formField]="f.body" />  <!-- pełny pasek -->
+## Keyboard
+- Tab / Shift+Tab inside a list item = indent / one level up (the same as `indent`/`outdent`).
+- Tab / Shift+Tab inside a table cell = the next / previous cell (with its content selected).
+  A list inside a cell takes precedence — only once it can no longer be indented does Tab move to another cell.
+- Everywhere else — including on the first list item, at the top level, at `maxListLevel`
+  and in the last table cell — Tab stays **native** and moves focus out of the editor. That is deliberate:
+  an editor must not be a keyboard trap (WCAG 2.1.2), so `preventDefault()` is called only
+  when the operation actually changed the content.
+
+## Example
+    <kpt-rich-text [formField]="f.body" />  <!-- the full toolbar -->
     <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`.
+Every label (the tools' aria text, the "Normal/Heading N" styles, the link prompt, the table context menu,
+the border popover, "Custom…") comes from i18n (the `richText` namespace, including `richText.menu.*`,
+`richText.border.*`). English by default — see `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:).
-Sanityzacja obejmuje **każdy** zapis do DOM edytora, nie tylko paste — w tym `value` ustawione z
-zewnątrz (`[(value)]`/`formField` z aplikacji, tryb źródła HTML). Traktuj `value` na wejściu jako
-potencjalnie niezaufane (DB, inny użytkownik, CMS); na wyjściu z komponentu jest sanityzowane.
-Schowek „wklej"/„wklej bez formatowania" używa async Clipboard API (wymaga uprawnień przeglądarki).
-Tabele: odłożone na osobne zadanie.
+## Notes
+Formatting goes through document.execCommand; active tools are highlighted (queryCommandState).
+Pasting (both native and through the buttons) is sanitized (a tag/style allowlist; it strips script/on*/javascript:).
+Sanitization covers **every** write into the editor's DOM, not just paste — including a `value` set from
+outside (`[(value)]`/`formField` from the application, the HTML source mode). Treat an incoming `value` as
+potentially untrusted (a database, another user, a CMS); on the way out of the component it is sanitized.
+The "paste"/"paste without formatting" clipboard tools use the async Clipboard API (which needs browser permission).
+An exception to execCommand: list indentation is done with our own DOM code — `execCommand('indent')` produces
+invalid `ul > ul` in Chrome (or a `blockquote` with a margin, which the sanitizer would strip anyway).

package/src/lib/scroll-top/llms.txt

@@ -1,15 +1,15 @@
 # KptScrollTop (kpt-scroll-top)
 
-Przycisk „do góry" — pojawia się po przewinięciu ponad `threshold` px.
+A "back to top" button — appears after scrolling past `threshold` px.
 Import: `import { KptScrollTop } from '@konce-pt/angular';`
 
-## Wejścia
-- `threshold`: number (px, domyślnie 300)
-- `target`: string | null — selektor przewijanego elementu; domyślnie okno
+## Inputs
+- `threshold`: number (px, default 300)
+- `target`: string | null — selector of the scrolled element; the window by default
 
-## Przykład
+## Example
     <kpt-scroll-top [threshold]="300" />
     <kpt-scroll-top target="#panel" />
 
-## Tokeny
-Przycisk `--kpt-color-primary` / `--kpt-color-on-primary`, `--kpt-elevation-3`.
+## Tokens
+The button uses `--kpt-color-primary` / `--kpt-color-on-primary`, `--kpt-elevation-3`.

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}`.