@konce-pt/angular 0.1.0

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

@@ -0,0 +1,18 @@
+# KptFab (kpt-fab)
+
+Floating Action Button — okrągły, wyniesiony przycisk akcji. Import: `import { KptFab } from '@konce-pt/angular';`
+
+## Wejścia
+- `variant`: 'filled' | 'tonal' (domyślnie 'filled')
+- `size`: 'md' | 'mini' (domyślnie 'md')
+- `extended`: boolean (pigułka z tekstem)
+- `disabled`: boolean; `type`: 'button' | 'submit' | 'reset'
+- `ariaLabel`: string (wymagane dla wariantu okrągłego, bez tekstu)
+
+## Przykład
+    <kpt-fab ariaLabel="Dodaj"><kpt-icon name="plus" /></kpt-fab>
+    <kpt-fab extended><kpt-icon name="plus" /> Nowy</kpt-fab>
+    <kpt-fab variant="tonal" size="mini" ariaLabel="Edytuj"><kpt-icon name="copy" /></kpt-fab>
+
+## Tokeny
+Tło `--kpt-color-primary` / `--kpt-color-primary-container` (tonal); cień `--kpt-elevation-3`.

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

@@ -0,0 +1,15 @@
+# KptFieldset (kpt-fieldset)
+
+Grupa pól z legendą (`<fieldset>`+`<legend>`), opcjonalnie zwijana.
+Import: `import { KptFieldset } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `legend`: string
+- `toggleable`: boolean; `collapsed`: model<boolean>
+- Treść: `<ng-content>`.
+
+## Przykład
+    <kpt-fieldset legend="Dane osobowe" toggleable>…</kpt-fieldset>
+
+## Tokeny
+Ramka `--kpt-color-border`; radius `--kpt-radius-md`.

package/dist/src/lib/file-upload/llms.txt

@@ -0,0 +1,23 @@
+# KptFileUpload (kpt-file-upload)
+
+Wgrywanie plików (drag-drop + wybór) na Signal Forms. Wartość = File[].
+Import: `import { KptFileUpload } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `value`: model<File[]> (lub `formField`)
+- `accept`: string (np. 'image/*')
+- `multiple`: boolean
+- `disabled`/`invalid`/`touched`: boolean; `touch`: output
+
+## Przykład
+    <kpt-file-upload [formField]="f.files" accept="image/*" multiple />
+    <kpt-file-upload [(value)]="files" />
+
+    files = signal<File[]>([]);
+
+## Zachowanie
+Strefa reaguje na klik i na przeciągnięcie plików. Przy `multiple=false` przechowuje tylko pierwszy plik.
+Lista plików pokazuje nazwę, rozmiar i przycisk usuwania.
+
+## Tokeny
+Strefa `--kpt-form-field-border` (przerywana), stan dragover `--kpt-color-primary`.

package/dist/src/lib/form-field/llms.txt

@@ -0,0 +1,37 @@
+# KptFormField (kpt-form-field)
+
+Wrapper pola formularza: etykieta, podpowiedź i komunikat błędu wokół dowolnej kontrolki
+(np. `kpt-input`). Prezentacyjny — stan błędu przekazuje się przez `error`.
+Import: `import { KptFormField } from '@konce-pt/angular';`
+
+## Selektor
+`kpt-form-field`
+
+## Wejścia (input signals)
+- `label`: string — tekst etykiety
+- `hint`: string — podpowiedź (ukrywana, gdy jest błąd)
+- `error`: string | null — komunikat błędu; gdy niepusty, pole jest oznaczone jako nieprawidłowe
+- `required`: boolean — gwiazdka przy etykiecie
+- `controlId`: string — id kontrolki dla powiązania `label[for]`
+
+## Projekcja
+Kontrolkę umieszcza się w treści (ng-content):
+
+    <kpt-form-field label="E-mail" [error]="emailError()" hint="Adres firmowy" required controlId="f-email">
+      <kpt-input [formField]="loginForm.email" type="email" id="f-email" />
+    </kpt-form-field>
+
+## Integracja z Signal Forms
+`error` zwykle pochodzi z pola formularza, np.:
+
+    emailError = computed(() => {
+      const s = loginForm.email();
+      return s.touched() && s.invalid() ? s.errors()[0]?.message ?? null : null;
+    });
+
+## Tokeny
+`--kpt-form-field-label`, `--kpt-form-field-hint`, `--kpt-form-field-error`, `--kpt-color-danger`.
+
+## Dostępność
+- Komunikat błędu ma `role="alert"`.
+- Powiąż `controlId` z `id` kontrolki, aby etykieta była klikalna (`label[for]`).

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

@@ -0,0 +1,15 @@
+# KptGalleria (kpt-galleria)
+
+Duży podgląd obrazu z paskiem miniatur i nawigacją.
+Import: `import { KptGalleria } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `items`: KptGalleriaItem[] — { src, thumbnail?, alt? }
+- `activeIndex`: model<number> (dwukierunkowe)
+- `showThumbnails`: boolean (domyślnie true)
+
+## Przykład
+    <kpt-galleria [items]="photos" [(activeIndex)]="idx" />
+
+## Tokeny
+Scena `--kpt-color-muted`; aktywna miniatura `--kpt-color-primary`.

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

@@ -0,0 +1,34 @@
+# KptIcon (kpt-icon)
+
+Ikona inline SVG (zestaw Tabler Icons — MIT). Rozmiar dziedziczy z `font-size` (1em),
+kolor z `currentColor`. Import: `import { KptIcon } from '@konce-pt/angular';`
+
+## Selektor
+`kpt-icon`
+
+## Wejścia
+- `name`: KptIconName (wymagane) — nazwa ikony z rejestru
+- `size`: string (opcjonalnie, np. '1.25rem') — inaczej dziedziczy z font-size
+
+## Dostępne nazwy (wbudowane)
+menu, x, chevron-up, chevron-down, chevron-left, chevron-right, check, search,
+grip-vertical, info, alert-triangle, circle-check, circle-x, calendar, copy, link, code.
+
+## Pełny zestaw (5130 ikon Tabler)
+Opcjonalny entry point `@konce-pt/angular/icons` (pobierany tylko przy imporcie):
+
+    import { provideKptTablerIcons } from '@konce-pt/angular/icons';
+    bootstrapApplication(App, { providers: [provideKptTablerIcons()] });
+    // potem: <kpt-icon name="rocket" />, <kpt-icon name="arrow-left" /> …
+
+Można też rejestrować własne przez `KptIconRegistry.register({ nazwa: 'inner svg' })`.
+`kpt-icon` reaguje na późną rejestrację (sygnał `version`).
+
+## Przykład
+    <kpt-icon name="check" />
+    <kpt-icon name="chevron-down" size="1.25rem" />
+    <button><kpt-icon name="x" /></button>
+
+## Licencja ikon
+Tabler Icons (MIT). Ikony wyodrębnione inline do `icons.ts`. Zob. ICONS-LICENSE w root.
+Dodanie ikony: dołóż wpis do `KPT_ICONS`/`KptIconName` (siatka 24×24, stroke 2px).

package/dist/src/lib/icon-button/llms.txt

@@ -0,0 +1,15 @@
+# KptIconButton (kpt-icon-button)
+
+Przycisk ikonowy (tylko ikona). Wymaga `ariaLabel`.
+Import: `import { KptIconButton } from '@konce-pt/angular';`
+
+## Wejścia
+- `variant`: 'filled'|'tonal'|'outline'|'text'|'danger'; `size`: 'sm'|'md'|'lg'; `shape`: 'round'|'square'
+- `type`, `disabled`, `loading`, `ariaLabel` (wymagane)
+
+## Przykłady
+    <kpt-icon-button ariaLabel="Ustawienia"><kpt-icon name="menu" /></kpt-icon-button>
+    <kpt-icon-button variant="danger" shape="square" ariaLabel="Usuń"><kpt-icon name="x" /></kpt-icon-button>
+
+## Tokeny
+Współdzieli z kpt-button (`--kpt-color-primary`, `--kpt-color-muted`, …).

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

@@ -0,0 +1,15 @@
+# KptImage (kpt-image)
+
+Obraz z opcjonalnym podglądem pełnoekranowym (zoom).
+Import: `import { KptImage } from '@konce-pt/angular';`
+
+## Wejścia
+- `src`: string (wymagane); `alt`: string
+- `width`: string | null (np. '240px')
+- `preview`: boolean — klik otwiera overlay z powiększeniem
+
+## Przykład
+    <kpt-image src="/foto.jpg" alt="Zdjęcie" preview width="240px" />
+
+## Tokeny
+Maska podglądu półprzezroczysta; ikona `zoom-in`; overlay ciemny.

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

@@ -0,0 +1,38 @@
+# KptInput (kpt-input)
+
+Pole tekstowe Koncept UI zintegrowane z Angular Signal Forms. Implementuje
+`FormValueControl<string>` — wiąż dyrektywą `FormField` (`@angular/forms/signals`).
+Bez `ControlValueAccessor`. Import: `import { KptInput } from '@konce-pt/angular';`
+
+## Selektor
+`kpt-input`
+
+## Użycie z Signal Forms
+
+    import { form, FormField, required, email } from '@angular/forms/signals';
+
+    model = signal({ email: '' });
+    loginForm = form(this.model, (p) => {
+      required(p.email, { message: 'E-mail jest wymagany' });
+      email(p.email, { message: 'Podaj poprawny adres e-mail' });
+    });
+
+    // szablon (imports: [KptInput, FormField])
+    <kpt-input [formField]="loginForm.email" type="email" id="f-email" />
+
+## Wejścia prezentacyjne
+- `type`: 'text'|'email'|'password'|'number'|'search'|'tel'|'url' (domyślnie 'text')
+- `placeholder`: string
+- `id`: string — trafia na wewnętrzny `<input>` (do `label[for]`); host go nie nosi
+- `ariaLabel`: string | null
+
+## Stan wiązany automatycznie przez FormField
+`value` (model, wymagane), `disabled`, `readonly`, `required`, `invalid`, `errors`,
+`touched`; output `touch` (emitowany na blur). Nie ustawiaj ich ręcznie przy użyciu z formularzem.
+
+## Tokeny
+`--kpt-form-field-{bg,text,placeholder,border,border-hover,border-focus,border-error,radius}`.
+
+## Dostępność
+- `aria-invalid="true"` przy nieprawidłowym stanie; `blur` oznacza pole jako dotknięte.
+- Komunikaty błędów wyświetla zwykle `kpt-form-field` (`role="alert"`).

package/dist/src/lib/input-mask/llms.txt

@@ -0,0 +1,20 @@
+# KptInputMask (kpt-input-mask)
+
+Pole z maską znakową na Signal Forms. Wartość = string.
+Import: `import { KptInputMask } from '@konce-pt/angular';`
+
+## Tokeny maski
+- `9` = cyfra, `a` = litera, `*` = alfanumeryczny. Pozostałe znaki maski to literały (spacje, nawiasy, myślniki).
+
+## Wejścia / model
+- `value`: model<string> (lub `formField`)
+- `mask`: string (np. `(999) 999-99-99`)
+- `placeholder`: string (domyślnie = maska)
+- `disabled`/`invalid`/`touched`: boolean; `touch`: output
+
+## Przykład
+    <kpt-input-mask [formField]="f.phone" mask="(999) 999-99-99" />
+    <kpt-input-mask [(value)]="zip" mask="99-999" />
+
+## Tokeny
+Pole `--kpt-form-field-*`.

package/dist/src/lib/input-number/llms.txt

@@ -0,0 +1,17 @@
+# KptInputNumber (kpt-input-number)
+
+Pole liczbowe ze strzałkami krokowania na Signal Forms. Wartość = number | null.
+Import: `import { KptInputNumber } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `value`: model<number | null> (lub `formField`)
+- `min`/`max`: number | undefined; `step`: number (domyślnie 1)
+- `suffix`: string (np. ' %'); `placeholder`: string
+- `disabled`/`invalid`/`touched`: boolean; `touch`: output
+
+## Przykład
+    <kpt-input-number [formField]="f.qty" [min]="0" [max]="99" [step]="1" />
+    <kpt-input-number [(value)]="qty" suffix=" szt." />
+
+## Tokeny
+Pole `--kpt-form-field-*`; przyciski `--kpt-color-muted`.

package/dist/src/lib/input-otp/llms.txt

@@ -0,0 +1,19 @@
+# KptInputOtp (kpt-input-otp)
+
+Pole kodu jednorazowego (OTP/PIN) — N osobnych pól z autofocusem i wklejaniem. Signal Forms.
+Wartość = string (sklejone znaki). Import: `import { KptInputOtp } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `value`: model<string> (lub `formField`)
+- `length`: number (domyślnie 6)
+- `integerOnly`: boolean — tylko cyfry
+- `disabled`/`invalid`/`touched`: boolean; `touch`: output
+
+## Zachowanie
+Wpisanie znaku przechodzi do następnego pola; Backspace cofa; wklejenie rozkłada kod na pola.
+
+## Przykład
+    <kpt-input-otp [formField]="f.code" [length]="6" integerOnly />
+
+## Tokeny
+Komórki `--kpt-form-field-*`.

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

@@ -0,0 +1,20 @@
+# KptKnob (kpt-knob)
+
+Pokrętło (knob) — wybór wartości po łuku SVG, myszką (drag) lub klawiszami strzałek. Signal Forms.
+Import: `import { KptKnob } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `value`: model<number> (lub `formField`)
+- `min`/`max`: number | undefined (0/100); `step`: number
+- `size`: px (domyślnie 96); `stroke`: px (10); `suffix`: string
+- `showValue`: boolean (domyślnie true)
+- `disabled`/`invalid`/`touched`: boolean; `touch`: output
+
+## Dostępność
+`role="slider"` + aria-valuemin/max/now; strzałki, Home/End.
+
+## Przykład
+    <kpt-knob [formField]="f.level" [min]="0" [max]="100" [step]="5" />
+
+## Tokeny
+Łuk tła `--kpt-color-border`; wartość `--kpt-color-primary`; tekst `--kpt-color-on-surface`.

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

@@ -0,0 +1,17 @@
+# KptListbox (kpt-listbox)
+
+Lista wyboru (listbox) na Signal Forms. Pojedynczy lub wielokrotny wybór, opcjonalny filtr.
+Wartość: `T` (single) lub `T[]` (multiple). Import: `import { KptListbox } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `value`: model<T | T[] | null> (lub `formField`)
+- `options`: KptOption<T>[] — { label, value, disabled? }
+- `multiple`: boolean; `filter`: boolean (pole wyszukiwania)
+- `disabled`/`invalid`/`touched`: boolean; `touch`: output
+
+## Przykład
+    <kpt-listbox [formField]="f.role" [options]="roles" filter />
+    <kpt-listbox [(value)]="tags" [options]="tagOptions" multiple />
+
+## Tokeny
+Ramka `--kpt-form-field-*`; zaznaczenie `--kpt-color-primary`.

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

@@ -0,0 +1,21 @@
+# KptMegamenu (kpt-megamenu)
+
+Mega-menu — pozioma belka z szerokim, wielokolumnowym panelem.
+Struktura: pozycja górna → `items` (kolumny) → każda kolumna `items` (odnośniki).
+Import: `import { KptMegamenu } from '@konce-pt/angular';`
+
+## Wejścia / wyjścia
+- `items`: KptMenuItem<T>[] (3 poziomy: top → kolumny → linki)
+- `select`: KptMenuItem<T> (kliknięty odnośnik)
+
+## Przykład
+    items = [{
+      label: 'Produkty',
+      items: [
+        { label: 'Komponenty', items: [{ label: 'Formularze' }, { label: 'Tabele' }] },
+        { label: 'Szablony', items: [{ label: 'Dashboard' }] },
+      ],
+    }];
+
+## Tokeny
+Panel `--kpt-color-surface-raised`, `--kpt-elevation-3`.

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

@@ -0,0 +1,17 @@
+# KptMenu (kpt-menu)
+
+Menu rozwijane (dropdown) na CDK Overlay. Trigger przez projekcję, pozycje przez `items`.
+Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+Import: `import { KptMenu, KptMenuItem } from '@konce-pt/angular';`
+
+## Wejścia / wyjścia
+- `items`: KptMenuItem[] `{ label?, value?, icon?, disabled?, danger?, separator? }`
+- `select`: output<KptMenuItem>
+
+## Przykład
+    <kpt-menu [items]="items" (select)="onSelect($event)">
+      <kpt-button variant="outline">Opcje</kpt-button>
+    </kpt-menu>
+
+## Tokeny
+Panel `--kpt-color-surface-raised`, `--kpt-elevation-3`; pozycja danger `--kpt-color-danger`.

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

@@ -0,0 +1,19 @@
+# KptMenubar (kpt-menubar)
+
+Pozioma belka menu z rozwijanymi pod-menu. Pozycje bez `items` działają jak akcje.
+Import: `import { KptMenubar } from '@konce-pt/angular';`
+
+## Wejścia / wyjścia
+- `items`: KptMenuItem<T>[] — pozycje górne; pod-menu w `items?` każdej pozycji
+- `select`: KptMenuItem<T>
+
+## Przykład
+    <kpt-menubar [items]="items" (select)="onSelect($event)" />
+
+    items: KptMenuItem[] = [
+      { label: 'Plik', items: [{ label: 'Nowy' }, { separator: true }, { label: 'Zamknij', danger: true }] },
+      { label: 'Pomoc' },
+    ];
+
+## Tokeny
+Belka `--kpt-color-surface-raised`; dropdown `--kpt-elevation-3`.

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

@@ -0,0 +1,15 @@
+# KptMeterGroup (kpt-meter-group)
+
+Wielosegmentowy miernik (meter group) z opcjonalną legendą.
+Import: `import { KptMeterGroup } from '@konce-pt/angular';`
+
+## Wejścia
+- `values`: KptMeterItem[] — { label, value, color? }
+- `max`: number | undefined — suma odniesienia (domyślnie suma wartości = 100%)
+- `showLegend`: boolean (domyślnie true)
+
+## Przykład
+    <kpt-meter-group [values]="[{label:'Użyte', value:70}, {label:'Wolne', value:30}]" />
+
+## Tokeny
+Segmenty: paleta `--kpt-color-{primary,info,success,warning,danger}` lub własny `color`.

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

@@ -0,0 +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>`.
+Import: `import { KptOrderList } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `items`: model<T[]> (dwukierunkowe — zwraca nową kolejność)
+- `header`: string
+
+## Przykład
+    <kpt-order-list [(items)]="tasks" header="Kolejność">
+      <ng-template let-item>{{ item.name }}</ng-template>
+    </kpt-order-list>
+
+## Tokeny
+Zaznaczenie `--kpt-color-primary`; przyciski `--kpt-color-surface-raised`.

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

@@ -0,0 +1,18 @@
+# KptPaginator (kpt-paginator)
+
+Paginator sterowany sygnałami. Import: `import { KptPaginator } from '@konce-pt/angular';`
+
+## Selektor
+`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])
+
+## Przykład
+    <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).

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

@@ -0,0 +1,18 @@
+# KptPanel (kpt-panel)
+
+Panel z nagłówkiem i opcjonalnym zwijaniem. Import: `import { KptPanel } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `header`: string
+- `toggleable`: boolean — pokazuje przycisk zwijania
+- `collapsed`: model<boolean> (dwukierunkowe)
+- Akcje nagłówka: projekcja `[kptPanelActions]`. Treść: `<ng-content>`.
+
+## Przykład
+    <kpt-panel header="Ustawienia" toggleable>
+      <button kptPanelActions>…</button>
+      Treść…
+    </kpt-panel>
+
+## Tokeny
+Nagłówek `--kpt-color-surface-variant`; ramka `--kpt-color-border`.

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

@@ -0,0 +1,20 @@
+# KptPassword (kpt-password)
+
+Pole hasła z przełącznikiem widoczności i opcjonalnym miernikiem siły. 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)
+- `placeholder`: string
+- `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.
+
+## Przykład
+    <kpt-password [formField]="f.password" feedback />
+    <kpt-password [(value)]="pass" />
+
+## Tokeny
+Pole `--kpt-form-field-*`; paski miernika `--kpt-color-{danger,warning,info,success}`.

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

@@ -0,0 +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>`.
+Import: `import { KptPickList } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `source`: model<T[]>; `target`: model<T[]> (oba dwukierunkowe)
+- `sourceHeader`/`targetHeader`: string
+
+## Przykład
+    <kpt-pick-list [(source)]="available" [(target)]="selected" sourceHeader="Dostępne" targetHeader="Wybrane">
+      <ng-template let-item>{{ item.name }}</ng-template>
+    </kpt-pick-list>
+
+## Tokeny
+Zaznaczenie `--kpt-color-primary`; nagłówki `--kpt-color-surface-variant`.

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

@@ -0,0 +1,17 @@
+# KptPopover (kpt-popover)
+
+Popover — dowolna treść w dymku na CDK Overlay (bogatszy niż tooltip).
+Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+Import: `import { KptPopover } from '@konce-pt/angular';`
+
+## Sloty
+- element z atrybutem `kptPopoverTrigger` = wyzwalacz; reszta treści = panel
+
+## Przykład
+    <kpt-popover>
+      <kpt-button kptPopoverTrigger variant="outline">Szczegóły</kpt-button>
+      <div>Bogata treść popovera…</div>
+    </kpt-popover>
+
+## Tokeny
+`--kpt-color-surface-raised`, `--kpt-elevation-3`.

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

@@ -0,0 +1,16 @@
+# KptProgress (kpt-progress)
+
+Wskaźnik postępu — liniowy lub kołowy, określony (0–100) lub nieokreślony (`value`=null).
+Import: `import { KptProgress } from '@konce-pt/angular';`
+
+## Wejścia
+- `value`: number|null (null = indeterminate); `type`: 'linear'|'circular'
+- `variant`: 'primary'|'success'|'danger'|'warning'|'info'; `diameter`: number (kołowy)
+
+## Przykłady
+    <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`.

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

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

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

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

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

@@ -0,0 +1,16 @@
+# KptRichText (kpt-rich-text)
+
+Lekki edytor tekstu sformatowanego (contenteditable) z konfigurowalnym paskiem.
+Wartość = HTML. Bez zależności zewnętrznych. Signal Forms.
+Import: `import { KptRichText, KptRichTool } from '@konce-pt/angular';`
+
+## Wejścia
+- `value`: model<string> (HTML)
+- `toolbar`: KptRichTool[] = 'bold'|'italic'|'underline'|'strike'|'ul'|'ol'|'link'|'clear'
+- `placeholder`: string; `disabled`/`invalid`/`touched`: boolean; `touch`: output
+
+## Przykład
+    <kpt-rich-text [formField]="f.body" [toolbar]="['bold','italic','ul','link']" />
+
+## Uwagi
+Formatowanie przez document.execCommand (przeglądarkowe). Ikony paska z wbudowanego rejestru.

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

@@ -0,0 +1,15 @@
+# KptScrollTop (kpt-scroll-top)
+
+Przycisk „do góry" — pojawia się po przewinięciu ponad `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
+
+## Przykład
+    <kpt-scroll-top [threshold]="300" />
+    <kpt-scroll-top target="#panel" />
+
+## Tokeny
+Przycisk `--kpt-color-primary` / `--kpt-color-on-primary`, `--kpt-elevation-3`.

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

@@ -0,0 +1,22 @@
+# KptSelect (kpt-select)
+
+Lista wyboru na własnym panelu (CDK Overlay), Signal Forms. Warianty: pojedynczy,
+z wyszukiwarką (`filter`) i wielokrotny (`multiple`, chipy; wartość `T[]`).
+Import: `import { KptSelect, KptOption } from '@konce-pt/angular';`
+
+Wymaga stylów overlay CDK w aplikacji: `import '@angular/cdk/overlay-prebuilt.css';`
+
+## Użycie
+    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.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`.
+- Klawiatura: Enter/↓ otwiera, ↑/↓ nawigacja, Enter wybiera, Esc zamyka.
+
+## Tokeny
+`--kpt-form-field-{bg,text,border,border-hover,border-focus,border-error,radius}`.

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

@@ -0,0 +1,20 @@
+# KptSidenav (kpt-sidenav)
+
+Panel boczny — stylowany kontener nawigacji, zwykle w slocie `kptShellSidenav`
+komponentu `kpt-app-shell`. Import: `import { KptSidenav } from '@konce-pt/angular';`
+
+## Selektor
+`kpt-sidenav`
+
+## Treść
+Dowolna zawartość (ng-content). Elementy `<a>` mają wbudowane style pozycji nawigacji
+(hover z `--kpt-color-muted`).
+
+## Przykład
+    <kpt-sidenav kptShellSidenav>
+      <a href="#">Pulpit</a>
+      <a href="#">Ustawienia</a>
+    </kpt-sidenav>
+
+## Tokeny
+`--kpt-sidenav-{bg,fg,border,width}` (szerokość ustawia `kpt-app-shell`).