@konce-pt/angular 0.7.10 → 0.7.12

package/src/lib/tooltip/llms.txt

@@ -1,33 +1,33 @@
 # KptTooltip (kptTooltip)
 
-Dyrektywa dymka podpowiedzi pokazywanego na hover/focus. Lekka — element dodawany do
-`body`, pozycjonowany względem hosta (działa w trybie zoneless).
+A directive for a tooltip shown on hover/focus. Lightweight — the element is appended to
+`body` and positioned relative to the host (works in zoneless mode).
 Import: `import { KptTooltip } from '@konce-pt/angular';`
 
-## Selektor (atrybut)
+## Selector (attribute)
 `[kptTooltip]`
 
-## Wejścia
-- `kptTooltip`: string (treść, wymagane) — pusta treść wyłącza dymek
-- `kptTooltipPosition`: 'top'|'bottom'|'left'|'right' (domyślnie 'top')
-- `kptTooltipOnlyWhenTruncated`: boolean (domyślnie false) — pokazuje dymek tylko wtedy,
-  gdy treść nie mieści się w elemencie (jest ucięta wielokropkiem)
+## Inputs
+- `kptTooltip`: string (the content, required) — empty content disables the tooltip
+- `kptTooltipPosition`: 'top'|'bottom'|'left'|'right' (default 'top')
+- `kptTooltipOnlyWhenTruncated`: boolean (default false) — shows the tooltip only when
+  the content does not fit the element (it is cut off with an ellipsis)
 
-## Dymek tylko dla przyciętego tekstu
-Przy `kptTooltipOnlyWhenTruncated` podpowiedź nie powtarza tekstu, który i tak widać.
-Przepełnienie sprawdzane jest na hoście **oraz jego bezpośrednich dzieciach** — `text-overflow:
-ellipsis` siedzi zwykle na wewnętrznym elemencie, a taki element kurczy się do dostępnej szerokości
-i nie rozpycha rodzica, więc pomiar samego hosta niczego by nie wykrył. Gdy tekst jest głębiej niż
-jeden poziom, dyrektywę trzeba osadzić na jego bezpośrednim rodzicu.
+## A tooltip only for truncated text
+With `kptTooltipOnlyWhenTruncated` the tooltip does not repeat text that is visible anyway.
+Overflow is measured on the host **and on its direct children** — `text-overflow:
+ellipsis` usually sits on an inner element, and such an element shrinks to the available width
+without stretching its parent, so measuring the host alone would detect nothing. When the text is deeper
+than one level, put the directive on its direct parent.
 
-Sprawdzenie następuje w chwili najechania (lub focusu), nie przy renderze — wynik jest więc zawsze
-aktualny po zmianie szerokości, powiększenia czy układu, bez `ResizeObserver`.
+The check happens at hover (or focus) time, not at render — so the result is always
+current after a change in width, zoom or layout, with no `ResizeObserver`.
 
     <span class="ellipsis" [kptTooltip]="name" kptTooltipOnlyWhenTruncated>{{ name }}</span>
 
-## Przykład
-    <kpt-button kptTooltip="Zapisz zmiany" kptTooltipPosition="bottom">Zapisz</kpt-button>
-    <span kptTooltip="Więcej informacji">?</span>
+## Example
+    <kpt-button kptTooltip="Save changes" kptTooltipPosition="bottom">Save</kpt-button>
+    <span kptTooltip="More information">?</span>
 
-## Tokeny
-Tło `--kpt-color-on-surface`, tekst `--kpt-color-surface` (kontrast w obu motywach), `--kpt-elevation-2`.
+## Tokens
+Background `--kpt-color-on-surface`, text `--kpt-color-surface` (contrast in both themes), `--kpt-elevation-2`.

package/src/lib/tree/llms.txt

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

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

@@ -1,5 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { InjectionToken, Signal, EnvironmentProviders, TemplateRef, OnDestroy } from '@angular/core';
+import * as _angular_forms_signals from '@angular/forms/signals';
 import { FormValueControl, WithOptionalFieldTree, ValidationError, FormCheckboxControl } from '@angular/forms/signals';
 import { ConnectedPosition } from '@angular/cdk/overlay';
 import * as _konce_pt_angular from '@konce-pt/angular';
@@ -359,6 +360,8 @@ interface KptMessages {
         strike: string;
         ul: string;
         ol: string;
+        indent: string;
+        outdent: string;
         foreColor: string;
         backColor: string;
         alignLeft: string;
@@ -410,6 +413,49 @@ interface KptMessages {
             customColor: string;
         };
     };
+    /** Ekran uwierzytelniania (kpt-auth). */
+    auth: {
+        signInTitle: string;
+        signInSubtitle: string;
+        signUpTitle: string;
+        signUpSubtitle: string;
+        forgotTitle: string;
+        forgotSubtitle: string;
+        name: string;
+        email: string;
+        emailPlaceholder: string;
+        password: string;
+        /** Interpolacja: {min} — minimalna długość hasła. */
+        passwordHint: string;
+        confirmPassword: string;
+        remember: string;
+        terms: string;
+        forgotLink: string;
+        backToSignIn: string;
+        signInSubmit: string;
+        signUpSubmit: string;
+        resetSubmit: string;
+        orContinueWith: string;
+        /** Interpolacja: {provider} — nazwa dostawcy (etykieta przycisku). */
+        continueWith: string;
+        noAccount: string;
+        haveAccount: string;
+        signInSwitch: string;
+        signUpSwitch: string;
+        errorRequired: string;
+        errorEmail: string;
+        /** Interpolacja: {min}. */
+        errorMinLength: string;
+        errorMismatch: string;
+        errorInvalid: string;
+        /** Treść panelu promocyjnego — zachęca do trybu przeciwnego niż bieżący. */
+        promo: {
+            signInTitle: string;
+            signInText: string;
+            signUpTitle: string;
+            signUpText: string;
+        };
+    };
 }
 declare const KPT_MESSAGES_EN: KptMessages;
 declare const KPT_MESSAGES_PL: KptMessages;
@@ -619,7 +665,7 @@ declare class KptIconRegistry {
  */
 declare function renderKptIconSvg(inner: string | undefined, cssClass?: string): string;
 
-type KptIconName = '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' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'list' | 'list-numbers' | 'clear-formatting' | 'star' | 'plus' | 'upload' | 'dots-vertical' | 'photo' | 'trash' | 'eye' | 'eye-off' | 'minus' | 'arrow-up' | 'arrow-down' | 'zoom-in' | 'info-circle' | 'phone' | 'map-pin' | 'world' | 'clock' | 'align-left' | 'align-center' | 'align-right' | 'align-justified' | 'palette' | 'highlight' | 'clipboard' | 'clipboard-text' | 'table' | 'pencil' | 'mail' | 'share' | 'external-link' | 'crosshair' | 'adjustments-horizontal';
+type KptIconName = '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' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'list' | 'list-numbers' | 'indent-increase' | 'indent-decrease' | 'clear-formatting' | 'star' | 'plus' | 'upload' | 'dots-vertical' | 'photo' | 'trash' | 'eye' | 'eye-off' | 'minus' | 'arrow-up' | 'arrow-down' | 'zoom-in' | 'info-circle' | 'phone' | 'map-pin' | 'world' | 'clock' | 'align-left' | 'align-center' | 'align-right' | 'align-justified' | 'palette' | 'highlight' | 'clipboard' | 'clipboard-text' | 'table' | 'pencil' | 'mail' | 'share' | 'external-link' | 'crosshair' | 'adjustments-horizontal';
 
 /** Nazwa breakpointa z tokenów `--kpt-breakpoint-*` (mobile-first). */
 type KptBreakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
@@ -884,9 +930,11 @@ declare class KptInput implements FormValueControl<string> {
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly id: _angular_core.InputSignal<string>;
     readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Podpowiedź autouzupełniania dla przeglądarki i menedżera haseł (np. 'email', 'current-password'). */
+    readonly autocomplete: _angular_core.InputSignal<string | null>;
     protected onInput(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptInput, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInput, "kpt-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInput, "kpt-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 /**
@@ -1284,7 +1332,7 @@ declare class KptTextarea implements FormValueControl<string> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptTextarea, "kpt-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "autoResize": { "alias": "autoResize"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
-type KptRichTool = 'copy' | 'paste' | 'pasteText' | 'heading' | 'bold' | 'italic' | 'underline' | 'strike' | 'ul' | 'ol' | 'foreColor' | 'backColor' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'link' | 'table' | 'clear' | 'html';
+type KptRichTool = 'copy' | 'paste' | 'pasteText' | 'heading' | 'bold' | 'italic' | 'underline' | 'strike' | 'ul' | 'ol' | 'indent' | 'outdent' | 'foreColor' | 'backColor' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'link' | 'table' | 'clear' | 'html';
 /** Pasek: płaska lista narzędzi lub grupy (sekcje rozdzielone separatorem). */
 type KptRichToolbar = KptRichTool[] | KptRichTool[][];
 /**
@@ -1302,6 +1350,8 @@ declare class KptRichText implements FormValueControl<string> {
     readonly value: _angular_core.ModelSignal<string>;
     readonly toolbar: _angular_core.InputSignal<KptRichToolbar>;
     readonly placeholder: _angular_core.InputSignal<string>;
+    /** Maksymalna głębokość zagnieżdżenia list (Tab / „Dodaj wcięcie"). */
+    readonly maxListLevel: _angular_core.InputSignalWithTransform<number, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1341,6 +1391,8 @@ declare class KptRichText implements FormValueControl<string> {
     }[]>;
     protected readonly styleLabel: _angular_core.Signal<string>;
     protected readonly activeCmds: _angular_core.WritableSignal<Set<string>>;
+    protected readonly canIndent: _angular_core.WritableSignal<boolean>;
+    protected readonly canOutdent: _angular_core.WritableSignal<boolean>;
     protected readonly currentBlock: _angular_core.WritableSignal<string>;
     protected readonly positions: ConnectedPosition[];
     /** Sekcje paska (normalizacja płaskiej listy do jednej grupy). */
@@ -1349,7 +1401,23 @@ declare class KptRichText implements FormValueControl<string> {
     protected icon(item: KptRichTool): KptIconName;
     protected aria(item: KptRichTool): string;
     protected isActive(item: KptRichTool): boolean;
+    /** `aria-pressed` tylko dla przełączników — wcięcia są akcjami, nie stanem. */
+    protected pressed(item: KptRichTool): boolean | null;
+    /** Wcięcia są aktywne wyłącznie tam, gdzie faktycznie coś zrobią (kursor w liście). */
+    protected enabled(item: KptRichTool): boolean;
     private inEditor;
+    /**
+     * Jedyne wywołanie `document.execCommand` w komponencie. API jest formalnie deprecated, ale nie
+     * ma zamiennika: to jedyny sposób formatowania, który trafia do natywnego stosu undo przeglądarki
+     * (Ctrl+Z). Własna implementacja komend wymagałaby własnej historii — czyli przepisania edytora.
+     */
+    private legacyExec;
+    /** Stan komendy dla podświetlenia narzędzi; nieobsługiwana komenda → `false`. */
+    private legacyState;
+    /** Komendy aktywne dla bieżącego zaznaczenia (podświetlenie narzędzi). */
+    private activeCommands;
+    /** Tag bloku, w którym stoi kursor (dla selecta stylu); domyślnie paragraf. */
+    private blockTag;
     private refreshState;
     protected onInput(): void;
     protected onSource(event: Event): void;
@@ -1357,6 +1425,33 @@ declare class KptRichText implements FormValueControl<string> {
     private saveSelection;
     private restoreSelection;
     protected exec(item: KptRichTool): void;
+    /** Najbliższy punkt listy zawierający węzeł (tylko wewnątrz edytora). */
+    private closestItem;
+    /** Poziom punktu w obrębie edytora (1 = najwyższy). */
+    private level;
+    /** Najgłębszy poziom w poddrzewie punktu — wcięcie przenosi podpunkty razem z rodzicem. */
+    private deepest;
+    private canIndentItem;
+    private canOutdentItem;
+    /**
+     * Punkty listy objęte zaznaczeniem. Przy zaznaczeniu wielu punktów operujemy na ich wspólnym
+     * poziomie zagnieżdżenia — inaczej podpunkt dostałby wcięcie dwa razy (raz sam, raz z rodzicem).
+     */
+    private listItems;
+    /** Zagnieżdża punkt w podliście poprzedniego punktu (poprawne `li > ul > li`). */
+    private indentItem;
+    /** Wyciąga punkt poziom wyżej; rodzeństwo po nim trafia do jego podlisty (kolejność bez zmian). */
+    private outdentItem;
+    /** Zwraca `true`, gdy DOM faktycznie się zmienił — od tego zależy `preventDefault()` dla Taba. */
+    private shiftItems;
+    /**
+     * Tab: wcięcie w liście, przeskok komórki w tabeli (lista w komórce ma pierwszeństwo; gdy nie da
+     * się już wciąć — przechodzimy do sąsiedniej komórki). Poza nimi i na krawędziach zostawiamy Tab
+     * natywny — inaczej edytor byłby pułapką klawiaturową (WCAG 2.1.2).
+     */
+    protected onKeydown(event: KeyboardEvent): void;
+    /** Przeskok do sąsiedniej komórki z zaznaczeniem jej treści; `false` = koniec tabeli. */
+    private moveCell;
     protected openStyle(): void;
     protected closeStyle(): void;
     protected pickStyle(tag: string): void;
@@ -1364,6 +1459,8 @@ declare class KptRichText implements FormValueControl<string> {
     protected closeColor(): void;
     protected applyColor(color: string): void;
     protected onColorInput(event: Event): void;
+    /** Kopiowanie przez async Clipboard API (jak wklejanie); fallback na starą komendę. */
+    private copySelection;
     private pasteRich;
     private pastePlain;
     /** Natywne wklejanie — oczyść (bez śmieci z Worda/WWW). */
@@ -1401,6 +1498,10 @@ declare class KptRichText implements FormValueControl<string> {
     private onResizeMove;
     private onResizeEnd;
     private buildGrid;
+    /** Jeden przebieg rozszerzania granic o komórki wystające poza region; `true` = coś się zmieniło. */
+    private growBounds;
+    /** Komórki leżące w prostokącie siatki (scalone trafiają raz — to `Set`). */
+    private cellsInRegion;
     private selectRegion;
     private clearSelection;
     protected mergeCells(): void;
@@ -1416,8 +1517,13 @@ declare class KptRichText implements FormValueControl<string> {
      */
     private sanitizeUrl;
     private sanitizeHtml;
+    /** Tag spoza allowlisty rozwijamy do dzieci; atrybuty czyścimy po kolei. */
+    private sanitizeElement;
+    private sanitizeAttribute;
+    /** Deklaracje `style` z allowlisty; `null`, gdy nie zostaje nic. */
+    private sanitizeStyleAttr;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptRichText, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptRichText, "kpt-rich-text", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptRichText, "kpt-rich-text", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "maxListLevel": { "alias": "maxListLevel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 /** Wartość suwaka: pojedyncza liczba lub para `[min, max]` w trybie `range`. */
@@ -1678,6 +1784,13 @@ interface Strength {
 declare class KptPassword implements FormValueControl<string> {
     readonly value: _angular_core.ModelSignal<string>;
     readonly placeholder: _angular_core.InputSignal<string>;
+    /** Id natywnego pola — pozwala związać etykietę przez `kpt-form-field [controlId]`. */
+    readonly id: _angular_core.InputSignal<string>;
+    /**
+     * Podpowiedź autouzupełniania. Rejestracja i reset hasła wymagają `new-password` — inaczej
+     * menedżer haseł podstawia stare hasło zamiast zaproponować nowe.
+     */
+    readonly autocomplete: _angular_core.InputSignal<string | null>;
     readonly feedback: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1689,7 +1802,7 @@ declare class KptPassword implements FormValueControl<string> {
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     protected readonly strength: _angular_core.Signal<Strength>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptPassword, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPassword, "kpt-password", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "feedback": { "alias": "feedback"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPassword, "kpt-password", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "feedback": { "alias": "feedback"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 /**
@@ -2036,6 +2149,202 @@ declare class KptShellNavToggle {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptShellNavToggle, "[kptShellNavToggle]", never, { "label": { "alias": "kptShellNavToggle"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Tryb ekranu — logowanie, rejestracja, odzyskiwanie hasła. */
+type KptAuthMode = 'signIn' | 'signUp' | 'forgot';
+/**
+ * Układ ekranu:
+ * - `slider` — panel promo przesuwa się nad formularzami przy zmianie trybu,
+ * - `split` — panel promo stoi w miejscu, zmienia się tylko formularz.
+ */
+type KptAuthLayout = 'slider' | 'split';
+/** Układ przycisków dostawców: pełnowymiarowa lista albo siatka ikon z podpisami. */
+type KptAuthProviderLayout = 'list' | 'grid';
+/** Dostawca logowania zewnętrznego (OAuth/SSO/dowolny własny). */
+interface KptAuthProvider {
+    /** Identyfikator zwracany w `providerSelect` i wiążący własny szablon `kptAuthProvider`. */
+    id: string;
+    /** Widoczna etykieta — jednocześnie nazwa dostępna przycisku. */
+    label: string;
+    /** Nazwa ikony z rejestru `kpt-icon` (np. `brand-google` z pełnego zestawu Tabler). */
+    icon?: string;
+    /** Alternatywa dla `icon`: adres obrazka (wierne, wielokolorowe logo marki). */
+    iconUrl?: string;
+    /** Drugi wiersz opisu — tylko w układzie `list`. */
+    description?: string;
+}
+/** Wartość formularza logowania. */
+interface KptAuthSignInValue {
+    email: string;
+    password: string;
+    remember: boolean;
+}
+/** Wartość formularza rejestracji. */
+interface KptAuthSignUpValue {
+    name: string;
+    email: string;
+    password: string;
+    terms: boolean;
+}
+/** Wartość formularza odzyskiwania hasła. */
+interface KptAuthResetValue {
+    email: string;
+}
+
+/**
+ * Ekran uwierzytelniania: logowanie, rejestracja i odzyskiwanie hasła w jednym komponencie,
+ * z panelem promocyjnym i listą dostawców zewnętrznych (OAuth/SSO).
+ *
+ * Komponent jest prezentacyjny — nie woła API ani nie nawiguje. Wywołania backendu podpina
+ * aplikacja pod `signIn` / `signUp` / `resetPassword` / `providerSelect`, a stan operacji
+ * podaje z powrotem przez `busy`, `error` i `notice`.
+ *
+ * Układ `slider` przesuwa panel promocyjny nad formularzami przy zmianie trybu; `split`
+ * zostawia go nieruchomo i przełącza sam formularz. Poniżej breakpointu `md` oba układy
+ * schodzą do jednej kolumny.
+ *
+ * @example
+ * <kpt-auth
+ *   [providers]="[{ id: 'google', label: 'Google', icon: 'brand-google' }]"
+ *   [busy]="loading()"
+ *   [error]="serverError()"
+ *   (signIn)="login($event)"
+ *   (providerSelect)="oauth($event.id)"
+ * >
+ *   <img kptAuthBrand src="/logo.svg" alt="Konce" />
+ *   <div kptAuthPromo><h3>Witaj ponownie</h3><p>Zaloguj się, by wrócić do pracy.</p></div>
+ * </kpt-auth>
+ */
+declare class KptAuth {
+    /** Aktywny tryb ekranu (dwukierunkowy — aplikacja może go wymusić po nawigacji). */
+    readonly mode: _angular_core.ModelSignal<KptAuthMode>;
+    /** Układ: przesuwany panel promocyjny albo nieruchomy split-screen. */
+    readonly layout: _angular_core.InputSignal<KptAuthLayout>;
+    /** Dostawcy logowania zewnętrznego. */
+    readonly providers: _angular_core.InputSignal<KptAuthProvider[]>;
+    /** Układ przycisków dostawców: lista pełnej szerokości albo siatka ikon. */
+    readonly providerLayout: _angular_core.InputSignal<KptAuthProviderLayout>;
+    /** Pole „imię i nazwisko" w rejestracji. */
+    readonly showName: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Wymagana zgoda na regulamin w rejestracji. */
+    readonly requireTerms: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Przełącznik „zapamiętaj mnie" przy logowaniu. */
+    readonly showRemember: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Operacja w toku — przyciski w stanie ładowania, pola zablokowane. */
+    readonly busy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Komunikat błędu z serwera (np. „nieprawidłowe dane logowania"). */
+    readonly error: _angular_core.InputSignal<string | null>;
+    /** Komunikat powodzenia (np. „wysłaliśmy link na podany adres"). */
+    readonly notice: _angular_core.InputSignal<string | null>;
+    /**
+     * Tytuł panelu promocyjnego. `null` (domyślnie) = tekst z i18n zależny od trybu,
+     * `''` = brak tytułu (miejsce dla slotu `[kptAuthPromo]`).
+     */
+    readonly promoTitle: _angular_core.InputSignal<string | null>;
+    /** Tekst panelu promocyjnego; zasady jak w `promoTitle`. */
+    readonly promoText: _angular_core.InputSignal<string | null>;
+    /** Animacja przejścia między trybami. */
+    readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Czas animacji w ms. */
+    readonly animationDuration: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly signIn: _angular_core.OutputEmitterRef<KptAuthSignInValue>;
+    readonly signUp: _angular_core.OutputEmitterRef<KptAuthSignUpValue>;
+    readonly resetPassword: _angular_core.OutputEmitterRef<KptAuthResetValue>;
+    readonly providerSelect: _angular_core.OutputEmitterRef<KptAuthProvider>;
+    protected readonly i18n: KptI18n;
+    private readonly injector;
+    private readonly uid;
+    /** Nagłówek panelu dostaje fokus po zmianie trybu — inaczej zmiana nie zostaje ogłoszona. */
+    private readonly headings;
+    private readonly providerDefs;
+    protected readonly ids: {
+        signIn: string;
+        signUp: string;
+        forgot: string;
+        email: string;
+        password: string;
+        name: string;
+        regEmail: string;
+        regPassword: string;
+        regConfirm: string;
+        resetEmail: string;
+    };
+    /** W trybie `signUp` formularz i panel promocyjny zamieniają się stronami. */
+    protected readonly signUpActive: _angular_core.Signal<boolean>;
+    protected readonly headingId: _angular_core.Signal<string>;
+    protected readonly title: _angular_core.Signal<string>;
+    protected readonly subtitle: _angular_core.Signal<string>;
+    /** Panel promocyjny zachęca do trybu przeciwnego do bieżącego. */
+    protected readonly promoMode: _angular_core.Signal<KptAuthMode>;
+    protected readonly promoHeading: _angular_core.Signal<string>;
+    protected readonly promoBody: _angular_core.Signal<string>;
+    private readonly signInModel;
+    protected readonly signInForm: _angular_forms_signals.FieldTree<KptAuthSignInValue, string | number, "writable">;
+    private readonly signUpModel;
+    protected readonly signUpForm: _angular_forms_signals.FieldTree<{
+        name: string;
+        email: string;
+        password: string;
+        confirm: string;
+        terms: boolean;
+    }, string | number, "writable">;
+    private readonly resetModel;
+    protected readonly resetForm: _angular_forms_signals.FieldTree<KptAuthResetValue, string | number, "writable">;
+    protected readonly signInInvalid: _angular_core.Signal<boolean>;
+    protected readonly signUpInvalid: _angular_core.Signal<boolean>;
+    protected readonly resetInvalid: _angular_core.Signal<boolean>;
+    protected readonly signInEmailError: _angular_core.Signal<string | null>;
+    protected readonly signInPasswordError: _angular_core.Signal<string | null>;
+    protected readonly signUpNameError: _angular_core.Signal<string | null>;
+    protected readonly signUpEmailError: _angular_core.Signal<string | null>;
+    protected readonly signUpPasswordError: _angular_core.Signal<string | null>;
+    protected readonly signUpConfirmError: _angular_core.Signal<string | null>;
+    protected readonly signUpTermsError: _angular_core.Signal<string | null>;
+    protected readonly resetEmailError: _angular_core.Signal<string | null>;
+    /**
+     * Komunikat błędu składamy z `kind` w chwili renderowania, a nie w walidatorze — dzięki temu
+     * zmiana języka w runtime przerysowuje komunikaty (walidatory tworzą się raz, przy starcie).
+     * Bramka „nie strasz czerwienią świeżego pola" żyje tu, w prezentacji.
+     */
+    private errorText;
+    protected setMode(mode: KptAuthMode): void;
+    protected onSignIn(): void;
+    protected onSignUp(): void;
+    protected onReset(): void;
+    protected templateFor(provider: KptAuthProvider): _angular_core.TemplateRef<any> | null;
+    protected selectProvider(provider: KptAuthProvider): void;
+    /** Kontekst szablonu własnego dostawcy: `$implicit` = dostawca, `select` = zgłoszenie wyboru. */
+    protected providerContext(provider: KptAuthProvider): {
+        $implicit: KptAuthProvider;
+        select: () => void;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAuth, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAuth, "kpt-auth", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "providers": { "alias": "providers"; "required": false; "isSignal": true; }; "providerLayout": { "alias": "providerLayout"; "required": false; "isSignal": true; }; "showName": { "alias": "showName"; "required": false; "isSignal": true; }; "requireTerms": { "alias": "requireTerms"; "required": false; "isSignal": true; }; "showRemember": { "alias": "showRemember"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "notice": { "alias": "notice"; "required": false; "isSignal": true; }; "promoTitle": { "alias": "promoTitle"; "required": false; "isSignal": true; }; "promoText": { "alias": "promoText"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "mode": "modeChange"; "signIn": "signIn"; "signUp": "signUp"; "resetPassword": "resetPassword"; "providerSelect": "providerSelect"; }, ["providerDefs"], ["[kptAuthBrand]", "[kptAuthFields]", "[kptAuthFields]", "[kptAuthSso]", "[kptAuthFooter]", "[kptAuthPromo]"], true, never>;
+}
+
+/**
+ * Własny szablon przycisku jednego dostawcy logowania w `kpt-auth`. Kontekst: `$implicit` =
+ * obiekt dostawcy, `select` = funkcja zgłaszająca wybór (emituje `providerSelect`).
+ *
+ * Przydatne, gdy logo marki nie przechodzi przez rejestr ikon (gradienty i `fill-rule` są
+ * wycinane przy sanityzacji) albo gdy przycisk ma mieć inny układ niż wbudowany.
+ *
+ * @example
+ * <kpt-auth [providers]="providers">
+ *   <ng-template kptAuthProvider="google" let-p let-select="select">
+ *     <button type="button" class="my-google" (click)="select()">
+ *       <img src="/google.svg" alt="" /> {{ p.label }}
+ *     </button>
+ *   </ng-template>
+ * </kpt-auth>
+ */
+declare class KptAuthProviderDef {
+    /** Identyfikator dostawcy, dla którego obowiązuje szablon. */
+    readonly kptAuthProvider: _angular_core.InputSignal<string>;
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAuthProviderDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptAuthProviderDef, "ng-template[kptAuthProvider]", never, { "kptAuthProvider": { "alias": "kptAuthProvider"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Panel z nagłówkiem i opcjonalnym zwijaniem. Akcje nagłówka: atrybut `kptPanelActions`.
  *
@@ -3248,6 +3557,6 @@ declare class KptSpeedDial<T = unknown> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSpeedDial<any>, "kpt-speed-dial", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "selected": "selected"; }, never, never, true, never>;
 }
 
-export { KPT_BREAKPOINTS, KPT_FORM_FIELD_CONTROL, KPT_I18N_CONFIG, KPT_MESSAGES_EN, KPT_MESSAGES_PL, KptAccordion, KptAccordionPanel, KptAlert, KptAppShell, KptAutocomplete, KptAvatar, KptAvatarGroup, KptBadge, KptBottomSheet, KptBreadcrumb, KptBreakpointObserver, KptButton, KptButtonGroup, KptCard, KptCarousel, KptCellDef, KptCellEditDef, KptCheckbox, KptChip, KptChipsInput, KptClock, KptColorPicker, KptConfirmContainer, KptConfirmService, KptContextMenu, KptDataTable, KptDataView, KptDateRange, KptDatepicker, KptDialog, KptDivider, KptDrawer, KptEmpty, KptFab, KptFieldset, KptFileUpload, KptFormField, KptGalleria, KptI18n, KptIcon, KptIconButton, KptIconRegistry, KptImage, KptInput, KptInputMask, KptInputNumber, KptInputOtp, KptKnob, KptListbox, KptMegamenu, KptMenu, KptMenubar, KptMeterGroup, KptOrderList, KptPaginator, KptPanel, KptPassword, KptPickList, KptPopover, KptProgress, KptRadioGroup, KptRating, KptRichText, KptRowDetailDef, KptScrollTop, KptSelect, KptShellNavToggle, KptSidenav, KptSkeleton, KptSlider, KptSpeedDial, KptSpinner, KptSplitButton, KptSplitter, KptStep, KptStepper, KptSwitch, KptSwitchGroup, KptTab, KptTabs, KptTextarea, KptTimeline, KptToastContainer, KptToastService, KptToolbar, KptTooltip, KptTree, provideKptI18n, renderKptIconSvg };
-export type { DeepPartial, KptAlertVariant, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeSize, KptBadgeVariant, KptBreadcrumbItem, KptBreakpoint, KptButtonSize, KptButtonVariant, KptCardVariant, KptCellEditEvent, KptChipVariant, KptColumn, KptColumnEdit, KptColumnEditType, KptColumnFilter, KptColumnFilterType, KptColumnSummary, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDatepickerMode, KptDatepickerView, KptDividerOrientation, KptDrawerPosition, KptFormFieldControl, KptGalleriaItem, KptI18nConfig, KptIconName, KptInputType, KptLocale, KptMenuItem, KptMessages, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitterOrientation, KptSummaryFn, KptTableLazyState, KptTimelineItem, KptToast, KptToastOptions, KptTooltipPosition, KptTreeNode };
+export { KPT_BREAKPOINTS, KPT_FORM_FIELD_CONTROL, KPT_I18N_CONFIG, KPT_MESSAGES_EN, KPT_MESSAGES_PL, KptAccordion, KptAccordionPanel, KptAlert, KptAppShell, KptAuth, KptAuthProviderDef, KptAutocomplete, KptAvatar, KptAvatarGroup, KptBadge, KptBottomSheet, KptBreadcrumb, KptBreakpointObserver, KptButton, KptButtonGroup, KptCard, KptCarousel, KptCellDef, KptCellEditDef, KptCheckbox, KptChip, KptChipsInput, KptClock, KptColorPicker, KptConfirmContainer, KptConfirmService, KptContextMenu, KptDataTable, KptDataView, KptDateRange, KptDatepicker, KptDialog, KptDivider, KptDrawer, KptEmpty, KptFab, KptFieldset, KptFileUpload, KptFormField, KptGalleria, KptI18n, KptIcon, KptIconButton, KptIconRegistry, KptImage, KptInput, KptInputMask, KptInputNumber, KptInputOtp, KptKnob, KptListbox, KptMegamenu, KptMenu, KptMenubar, KptMeterGroup, KptOrderList, KptPaginator, KptPanel, KptPassword, KptPickList, KptPopover, KptProgress, KptRadioGroup, KptRating, KptRichText, KptRowDetailDef, KptScrollTop, KptSelect, KptShellNavToggle, KptSidenav, KptSkeleton, KptSlider, KptSpeedDial, KptSpinner, KptSplitButton, KptSplitter, KptStep, KptStepper, KptSwitch, KptSwitchGroup, KptTab, KptTabs, KptTextarea, KptTimeline, KptToastContainer, KptToastService, KptToolbar, KptTooltip, KptTree, provideKptI18n, renderKptIconSvg };
+export type { DeepPartial, KptAlertVariant, KptAuthLayout, KptAuthMode, KptAuthProvider, KptAuthProviderLayout, KptAuthResetValue, KptAuthSignInValue, KptAuthSignUpValue, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeSize, KptBadgeVariant, KptBreadcrumbItem, KptBreakpoint, KptButtonSize, KptButtonVariant, KptCardVariant, KptCellEditEvent, KptChipVariant, KptColumn, KptColumnEdit, KptColumnEditType, KptColumnFilter, KptColumnFilterType, KptColumnSummary, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDatepickerMode, KptDatepickerView, KptDividerOrientation, KptDrawerPosition, KptFormFieldControl, KptGalleriaItem, KptI18nConfig, KptIconName, KptInputType, KptLocale, KptMenuItem, KptMessages, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitterOrientation, KptSummaryFn, KptTableLazyState, KptTimelineItem, KptToast, KptToastOptions, KptTooltipPosition, KptTreeNode };
 //# sourceMappingURL=konce-pt-angular.d.ts.map