@konce-pt/angular 0.1.0

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

@@ -0,0 +1,14 @@
+# KptSkeleton (kpt-skeleton)
+
+Placeholder ładowania (shimmer). Import: `import { KptSkeleton } from '@konce-pt/angular';`
+
+## Wejścia
+- `variant`: 'text'|'circle'|'rect'; `width`: string; `height`: string; `lines`: number (dla text)
+
+## Przykłady
+    <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`.

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

@@ -0,0 +1,13 @@
+# KptSlider (kpt-slider)
+
+Suwak wartości na Signal Forms. Import: `import { KptSlider } from '@konce-pt/angular';`
+
+## Wejścia
+- `value`: model<number>; `min`/`max`: number (zgodne z FormValueControl); `step`: number
+- `showValue`: boolean; `disabled`/`invalid`/`touched`; `touch`
+
+## Przykład
+    <kpt-slider [formField]="f.volume" [min]="0" [max]="100" [step]="5" showValue />
+
+## Tokeny
+Track wypełniany `--kpt-color-primary`, tło `--kpt-color-surface-variant`.

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

@@ -0,0 +1,16 @@
+# KptSpeedDial (kpt-speed-dial)
+
+Speed dial — FAB rozwijający zestaw akcji. Buduje na `kpt-fab`.
+Import: `import { KptSpeedDial } from '@konce-pt/angular';`
+
+## Wejścia / wyjścia
+- `items`: KptMenuItem<T>[] — akcje (label, icon)
+- `direction`: 'up' | 'down' | 'left' | 'right' (KptSpeedDialDirection)
+- `icon`: string (domyślnie 'plus', obraca się o 45° po otwarciu); `ariaLabel`: string
+- `select`: KptMenuItem<T>
+
+## Przykład
+    <kpt-speed-dial [items]="actions" direction="up" (select)="onAction($event)" />
+
+## Tokeny
+FAB główny z `kpt-fab`; akcje `--kpt-color-surface-raised`, `--kpt-elevation-2`.

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

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

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

@@ -0,0 +1,26 @@
+# KptSplitButton (kpt-split-button)
+
+Przycisk dzielony — akcja główna + rozwijane menu akcji dodatkowych (CDK Overlay).
+Import: `import { KptSplitButton } from '@konce-pt/angular';`
+Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
+
+## Wejścia
+- `variant`: KptButtonVariant (domyślnie 'filled')
+- `items`: KptMenuItem<T>[] — { label, value?, icon?, danger?, disabled?, separator? }
+- `disabled`: boolean
+
+## Wyjścia
+- `primaryClick`: void — klik przycisku głównego
+- `select`: KptMenuItem<T> — wybór pozycji z menu
+
+## Przykład
+    <kpt-split-button [items]="items" (primaryClick)="save()" (select)="onItem($event)">Zapisz</kpt-split-button>
+
+    items: KptMenuItem[] = [
+      { label: 'Zapisz jako szkic', value: 'draft' },
+      { separator: true },
+      { label: 'Odrzuć', value: 'discard', danger: true },
+    ];
+
+## Tokeny
+Kolory dziedziczone z przycisku; panel `--kpt-color-surface-raised`, `--kpt-elevation-3`.

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

@@ -0,0 +1,21 @@
+# KptSplitter (kpt-splitter)
+
+Dwa panele z przeciąganym uchwytem. Panele przez sloty `[kptSplitStart]` i `[kptSplitEnd]`.
+Import: `import { KptSplitter } from '@konce-pt/angular';`
+
+## Wejścia / model
+- `orientation`: 'horizontal' | 'vertical' (KptSplitterOrientation)
+- `startSize`: model<number> — rozmiar pierwszego panelu w % (dwukierunkowe)
+- `minSize`: number (%) — minimalny rozmiar panelu
+
+## Dostępność
+Uchwyt `role="separator"`, strzałki zmieniają rozmiar; przeciąganie myszą.
+
+## Przykład
+    <kpt-splitter orientation="horizontal" [(startSize)]="size">
+      <div kptSplitStart>Lewy</div>
+      <div kptSplitEnd>Prawy</div>
+    </kpt-splitter>
+
+## Tokeny
+Uchwyt `--kpt-color-border` → `--kpt-color-primary` (hover/focus).

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

@@ -0,0 +1,19 @@
+# KptStepper (kpt-stepper) + KptStep (kpt-step)
+
+Kreator kroków. Nagłówek z numerowanymi krokami + aktywna treść (leniwa).
+Import: `import { KptStepper, KptStep } from '@konce-pt/angular';`
+
+## KptStepper
+- `activeIndex`: model<number>; metody publiczne: `next()`, `prev()`, `goTo(i)`
+
+## KptStep
+- `label`: string (wymagane)
+
+## Przykład
+    <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-stepper>
+
+## Tokeny
+Aktywny/ukończony krok: `--kpt-color-primary` (marker, konektor).

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

@@ -0,0 +1,13 @@
+# KptSwitch (kpt-switch)
+
+Przełącznik (toggle) na Signal Forms (`FormCheckboxControl`, model `checked`). `role="switch"`.
+Import: `import { KptSwitch } from '@konce-pt/angular';`
+
+## Użycie
+    <kpt-switch [formField]="f.notifications" label="Powiadomienia" />
+
+## Wejścia
+- `checked`: model<boolean>; `label`: string; `disabled`/`invalid`/`touched`: boolean; output `touch`.
+
+## Tokeny
+`--kpt-color-primary`, `--kpt-color-border-strong`, `--kpt-color-surface`, `--kpt-elevation-1`.

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

@@ -0,0 +1,19 @@
+# KptTabs (kpt-tabs) + KptTab (kpt-tab)
+
+Zakładki. Treść zakładek renderowana leniwie (tylko aktywna).
+Import: `import { KptTabs, KptTab } from '@konce-pt/angular';`
+
+## KptTabs
+- `activeIndex`: model<number> (dwukierunkowe)
+
+## KptTab
+- `label`: string (wymagane); `disabled`: boolean
+
+## Przykład
+    <kpt-tabs [(activeIndex)]="tab">
+      <kpt-tab label="Ogólne">…</kpt-tab>
+      <kpt-tab label="Zaawansowane">…</kpt-tab>
+    </kpt-tabs>
+
+## Tokeny
+Aktywna zakładka: `--kpt-color-primary` (tekst + dolna krawędź).

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

@@ -0,0 +1,14 @@
+# KptTextarea (kpt-textarea)
+
+Pole wieloliniowe na Signal Forms, z opcjonalnym auto-resize.
+Import: `import { KptTextarea } from '@konce-pt/angular';`
+
+## Wejścia
+- `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 />
+
+## Tokeny
+`--kpt-form-field-*`.

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

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

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

@@ -0,0 +1,22 @@
+# KptToast (kpt-toast-container + KptToastService)
+
+Powiadomienia (toasty) sterowane serwisem. Kontener renderuje je fixed w rogu.
+Import: `import { KptToastService, KptToastContainer } from '@konce-pt/angular';`
+
+## Ustawienie
+Umieść kontener raz w aplikacji: `<kpt-toast-container />`.
+
+## Serwis (KptToastService, providedIn: root)
+    private toast = inject(KptToastService);
+    toast.success('Zapisano', { title: 'OK' });
+    toast.error('Błąd połączenia');
+    toast.info(msg, opts); toast.warning(msg, opts);
+    toast.show(msg, { variant, title, duration }); // duration ms, 0 = bez auto-zamykania
+    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`.

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

@@ -0,0 +1,23 @@
+# KptToolbar (kpt-toolbar)
+
+Górny pasek (toolbar) — pozioma belka na treść aplikacji.
+Import: `import { KptToolbar } from '@konce-pt/angular';`
+
+## Selektor
+`kpt-toolbar`
+
+## Wejścia
+- `elevated`: boolean — cień pod paskiem
+
+## Odstęp
+Element z atrybutem `kptToolbarSpacer` dostaje `flex: 1` i rozpycha zawartość.
+
+## Przykład
+    <kpt-toolbar elevated>
+      <strong>Koncept UI</strong>
+      <span kptToolbarSpacer></span>
+      <kpt-button variant="text">Wyloguj</kpt-button>
+    </kpt-toolbar>
+
+## Tokeny
+`--kpt-toolbar-{bg,fg,border,height}`.

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

@@ -0,0 +1,19 @@
+# KptTooltip (kptTooltip)
+
+Dyrektywa dymka podpowiedzi pokazywanego na hover/focus. Lekka — element dodawany do
+`body`, pozycjonowany względem hosta (działa w trybie zoneless).
+Import: `import { KptTooltip } from '@konce-pt/angular';`
+
+## Selektor (atrybut)
+`[kptTooltip]`
+
+## Wejścia
+- `kptTooltip`: string (treść, wymagane)
+- `kptTooltipPosition`: 'top'|'bottom'|'left'|'right' (domyślnie 'top')
+
+## Przykład
+    <kpt-button kptTooltip="Zapisz zmiany" kptTooltipPosition="bottom">Zapisz</kpt-button>
+    <span kptTooltip="Więcej informacji">?</span>
+
+## Tokeny
+Tło `--kpt-color-on-surface`, tekst `--kpt-color-surface` (kontrast w obu motywach), `--kpt-elevation-2`.

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

@@ -0,0 +1,17 @@
+# KptTree (kpt-tree)
+
+Drzewo hierarchiczne (rozwijanie, zaznaczanie, ikony). Rekurencyjny render.
+Import: `import { KptTree, KptTreeNode } from '@konce-pt/angular';`
+
+## Model węzła (KptTreeNode)
+`{ label: string; value?: T; icon?: string; children?: KptTreeNode[]; expanded?: boolean; disabled?: boolean }`
+
+## Wejścia / wyjścia
+- `nodes`: KptTreeNode[]; `selectable`: boolean
+- `selected`: model<KptTreeNode|null>; `nodeClick`: output<KptTreeNode>
+
+## Przykład
+    <kpt-tree [nodes]="tree" selectable [(selected)]="node" (nodeClick)="open($event)" />
+
+## Tokeny
+Wiersz hover `--kpt-color-surface-variant`; zaznaczony `--kpt-color-primary`.

package/dist/types/konce-pt-angular-icons.d.ts

@@ -0,0 +1,18 @@
+import { EnvironmentProviders } from '@angular/core';
+
+declare const KPT_TABLER_ICONS: Record<string, string>;
+declare const KPT_TABLER_ICON_NAMES: readonly string[];
+
+/**
+ * Rejestruje pełny zestaw Tabler Icons (5130) w `KptIconRegistry`, dzięki czemu
+ * `kpt-icon` może użyć dowolnej ikony po nazwie.
+ *
+ * @example
+ * // main.ts
+ * bootstrapApplication(App, {
+ *   providers: [provideKptTablerIcons()],
+ * });
+ */
+declare function provideKptTablerIcons(): EnvironmentProviders;
+
+export { KPT_TABLER_ICONS, KPT_TABLER_ICON_NAMES, provideKptTablerIcons };