@konce-pt/angular 0.2.0 → 0.4.0

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

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, OnDestroy } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, TemplateRef, OnDestroy } from '@angular/core';
 import { FormValueControl, WithOptionalFieldTree, ValidationError, FormCheckboxControl } from '@angular/forms/signals';
 import { ConnectedPosition } from '@angular/cdk/overlay';
 import * as _konce_pt_angular from '@konce-pt/angular';
@@ -99,6 +99,259 @@ declare class KptFab {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFab, "kpt-fab", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "extended": { "alias": "extended"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Kod języka. Otwarty string — EN/PL mają podpowiedzi, ale dozwolony dowolny. */
+type KptLocale = 'en' | 'pl' | (string & {});
+/** Pełny słownik etykiet UI używanych przez komponenty biblioteki. */
+interface KptMessages {
+    /** Etykiety współdzielone przez wiele komponentów (przyciski ikonowe itp.). */
+    common: {
+        close: string;
+        remove: string;
+        previous: string;
+        next: string;
+        clear: string;
+        done: string;
+        all: string;
+    };
+    paginator: {
+        rowsPerPage: string;
+        /** Interpolacja: {start}, {end}, {total}. */
+        range: string;
+        prevPage: string;
+        nextPage: string;
+    };
+    select: {
+        search: string;
+        noResults: string;
+        removeChip: string;
+    };
+    listbox: {
+        search: string;
+        empty: string;
+    };
+    dataView: {
+        list: string;
+        grid: string;
+        empty: string;
+        /** Interpolacja: {count}. */
+        count: string;
+    };
+    dataTable: {
+        search: string;
+        exportCsv: string;
+        loading: string;
+        empty: string;
+        selectAll: string;
+        selectRow: string;
+        expandRow: string;
+        /** Interpolacja: {column}. */
+        filter: string;
+        /** Interpolacja: {column}. */
+        filterMin: string;
+        /** Interpolacja: {column}. */
+        filterMax: string;
+        all: string;
+        dateRange: string;
+        min: string;
+        max: string;
+    };
+    confirm: {
+        header: string;
+        accept: string;
+        reject: string;
+    };
+    fileUpload: {
+        /** Może zawierać `<strong>…</strong>`. */
+        hint: string;
+        remove: string;
+    };
+    chipsInput: {
+        placeholder: string;
+    };
+    dateRange: {
+        placeholder: string;
+        from: string;
+        to: string;
+        fromTime: string;
+        toTime: string;
+    };
+    datepicker: {
+        prevMonth: string;
+        nextMonth: string;
+        prevYear: string;
+        nextYear: string;
+        prevYears: string;
+        nextYears: string;
+        calendar: string;
+        month: string;
+        time: string;
+    };
+    pickList: {
+        available: string;
+        selected: string;
+        moveAllRight: string;
+        moveRight: string;
+        moveLeft: string;
+        moveAllLeft: string;
+    };
+    orderList: {
+        up: string;
+        down: string;
+    };
+    inputNumber: {
+        decrement: string;
+        increment: string;
+    };
+    password: {
+        show: string;
+        hide: string;
+        /** Etykiety miernika siły (indeksy 0–4). */
+        strength: [string, string, string, string, string];
+    };
+    spinner: {
+        label: string;
+    };
+    speedDial: {
+        actions: string;
+    };
+    scrollTop: {
+        label: string;
+    };
+    splitButton: {
+        more: string;
+    };
+    panel: {
+        toggle: string;
+    };
+    breadcrumb: {
+        label: string;
+    };
+    galleria: {
+        /** Interpolacja: {index}. */
+        image: string;
+    };
+    carousel: {
+        /** Interpolacja: {index}. */
+        slide: string;
+    };
+    richText: {
+        copy: string;
+        paste: string;
+        pasteText: string;
+        heading: string;
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        ul: string;
+        ol: string;
+        foreColor: string;
+        backColor: string;
+        alignLeft: string;
+        alignCenter: string;
+        alignRight: string;
+        alignJustify: string;
+        link: string;
+        table: string;
+        clear: string;
+        html: string;
+        /** Styl bloku „Normalny" (select). */
+        styleNormal: string;
+        /** Interpolacja: {level}. */
+        styleHeading: string;
+        linkPrompt: string;
+        htmlSource: string;
+        /** Etykieta „Własny…" przy pickerze koloru. */
+        paletteCustom: string;
+        /** Menu kontekstowe tabeli. */
+        menu: {
+            column: string;
+            row: string;
+            cell: string;
+            insertLeft: string;
+            insertRight: string;
+            headerColumn: string;
+            deleteColumn: string;
+            insertAbove: string;
+            insertBelow: string;
+            headerRow: string;
+            deleteRow: string;
+            cellBackground: string;
+            alignLeft: string;
+            alignCenter: string;
+            alignRight: string;
+            mergeCells: string;
+            splitCell: string;
+            border: string;
+            deleteTable: string;
+        };
+        /** Popover obramowania. */
+        border: {
+            table: string;
+            cell: string;
+            none: string;
+            thin: string;
+            medium: string;
+            thick: string;
+            customColor: string;
+        };
+    };
+}
+declare const KPT_MESSAGES_EN: KptMessages;
+declare const KPT_MESSAGES_PL: KptMessages;
+
+/** Głęboko-opcjonalna wersja typu — dla nadpisań/częściowych słowników. */
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/** Konfiguracja i18n przekazywana do `provideKptI18n`. */
+interface KptI18nConfig {
+    /** Język początkowy (domyślnie 'en'). */
+    locale?: KptLocale;
+    /**
+     * Słowniki do zarejestrowania lub nadpisania, kluczowane kodem języka.
+     * Może dodać nowy język (`{ de: {...} }`) lub nadpisać istniejący
+     * (`{ en: { paginator: { rowsPerPage: 'Rows:' } } }`). Deep-merge z bazą EN/PL.
+     */
+    messages?: Record<string, DeepPartial<KptMessages>>;
+}
+/** Token konfiguracji i18n. Konsumowany przez `KptI18n`. */
+declare const KPT_I18N_CONFIG: InjectionToken<KptI18nConfig>;
+
+/**
+ * Serwis tłumaczeń Koncept UI. Trzyma rejestr słowników per język, bieżący locale
+ * (sygnał) i funkcję `t()` z interpolacją. Skonfiguruj przez `provideKptI18n(...)`.
+ *
+ * Domyślnie EN. Języki bazowe: EN, PL. Dowolny inny język dodaje się jednym
+ * słownikiem (`registerMessages` lub `provideKptI18n({ messages: { de } })`);
+ * brakujące klucze spadają na EN.
+ */
+declare class KptI18n {
+    /** Rejestr słowników: język → pełny `KptMessages`. */
+    private readonly registry;
+    private readonly _locale;
+    /** Bieżący język (tylko do odczytu). */
+    readonly locale: _angular_core.Signal<KptLocale>;
+    /** Aktywny słownik (z fallbackiem na EN, gdy język nieznany). */
+    readonly messages: _angular_core.Signal<KptMessages>;
+    constructor();
+    /** Ustawia bieżący język. Zmiana jest reaktywna dla wszystkich komponentów. */
+    setLocale(locale: KptLocale): void;
+    /**
+     * Rejestruje lub nadpisuje słownik języka. Częściowy słownik deep-merge'uje się
+     * na istniejący (lub EN dla nowego języka) → brakujące klucze mają wartość EN.
+     */
+    registerMessages(locale: KptLocale, patch: DeepPartial<KptMessages>): void;
+    /**
+     * Tłumaczy klucz w notacji kropkowej (np. `'paginator.range'`), z opcjonalną
+     * interpolacją `{name}`. Brakujący klucz spada na EN, a w ostateczności zwraca sam klucz.
+     */
+    t(key: string, params?: Record<string, string | number>): string;
+    private lookup;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptI18n, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<KptI18n>;
+}
+
 interface KptMenuItem<T = unknown> {
     label?: string;
     value?: T;
@@ -145,6 +398,7 @@ declare class KptSplitButton<T = unknown> {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly primaryClick: _angular_core.OutputEmitterRef<void>;
     readonly select: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
+    protected readonly i18n: KptI18n;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly positions: ConnectedPosition[];
     protected pick(item: KptMenuItem<T>): void;
@@ -193,7 +447,28 @@ declare class KptIconRegistry {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<KptIconRegistry>;
 }
 
-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';
+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';
+
+/**
+ * Konfiguruje i18n Koncept UI. Ustawia język początkowy i rejestruje/nadpisuje
+ * słowniki. Języki bazowe (EN, PL) są dostępne bez konfiguracji.
+ *
+ * @example
+ * // main.ts — polski interfejs
+ * bootstrapApplication(App, {
+ *   providers: [provideKptI18n({ locale: 'pl' })],
+ * });
+ *
+ * @example
+ * // Własny język jednym plikiem JSON (brakujące klucze → EN)
+ * import de from './i18n/de.json';
+ * provideKptI18n({ locale: 'de', messages: { de } });
+ *
+ * @example
+ * // Nadpisanie pojedynczych etykiet istniejącego języka
+ * provideKptI18n({ messages: { en: { paginator: { rowsPerPage: 'Rows per page:' } } } });
+ */
+declare function provideKptI18n(config?: KptI18nConfig): EnvironmentProviders;
 
 type KptBadgeVariant = 'neutral' | 'primary' | 'success' | 'danger' | 'warning' | 'info';
 /**
@@ -228,6 +503,7 @@ declare class KptChip {
     readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly removed: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptChip, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptChip, "kpt-chip", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
 }
@@ -262,7 +538,10 @@ declare class KptAvatar {
  */
 declare class KptSpinner {
     readonly size: _angular_core.InputSignal<string>;
-    readonly label: _angular_core.InputSignal<string>;
+    /** Etykieta a11y; bez wartości używa i18n (`spinner.label`). */
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    private readonly i18n;
+    protected readonly effectiveLabel: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSpinner, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSpinner, "kpt-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -312,10 +591,21 @@ declare class KptSkeleton {
  * kontrolki (np. `kpt-input`). Prezentacyjny — stan błędu przekazuje się przez `error`
  * (zwykle z pola Signal Forms). Wygląd sterowany tokenami `--kpt-form-field-*`.
  *
+ * Etykieta ma 4 warianty (`labelType`): `fixed` (domyślny, nad kontrolką) oraz trzy warianty
+ * unoszącej się etykiety (Float Label) z animowanym przejściem: `over` (nad obramowaniem),
+ * `in` (u góry wewnątrz pola) i `on` (na obramowaniu, notch). Uniesienie następuje przy focusie
+ * (CSS `:focus-within`) lub gdy pole jest wypełnione (wykrywane po zdarzeniach `input`/`change`
+ * oraz wartości początkowej) — bez wymogu placeholdera na kontrolce.
+ *
  * @example
  * <kpt-form-field label="E-mail" [error]="emailError()" hint="Firmowy adres">
  *   <kpt-input [control]="f.email" type="email" />
  * </kpt-form-field>
+ *
+ * @example
+ * <kpt-form-field label="E-mail" labelType="over">
+ *   <kpt-input />
+ * </kpt-form-field>
  */
 declare class KptFormField {
     /** Tekst etykiety. */
@@ -328,8 +618,20 @@ declare class KptFormField {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Id kontrolki dla powiązania `label[for]`. */
     readonly controlId: _angular_core.InputSignal<string>;
+    /**
+     * Wariant etykiety: `fixed` (domyślnie, statyczna nad kontrolką) lub Float Label —
+     * `over` (nad obramowaniem), `in` (u góry wewnątrz pola), `on` (na obramowaniu, notch).
+     * Uniesienie następuje przy focusie lub wypełnieniu pola.
+     */
+    readonly labelType: _angular_core.InputSignal<"fixed" | "over" | "in" | "on">;
+    private readonly host;
+    /** Czy projektowana kontrolka ma wartość — steruje uniesieniem etykiety w wariantach float. */
+    protected readonly filled: _angular_core.WritableSignal<boolean>;
+    constructor();
+    /** Odczytuje wartość projektowanego `input`/`textarea` i aktualizuje stan `filled`. */
+    protected updateFilled(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptFormField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFormField, "kpt-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFormField, "kpt-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "labelType": { "alias": "labelType"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 type KptInputType = 'text' | 'email' | 'password' | 'number' | 'search' | 'tel' | 'url';
@@ -382,6 +684,10 @@ declare class KptCheckbox implements FormCheckboxControl {
 /**
  * Przełącznik (switch/toggle) zintegrowany z Signal Forms (`FormCheckboxControl`).
  * `<kpt-switch [formField]="f.notifications" label="Powiadomienia" />`
+ *
+ * Wariant z tekstem stanu: `onLabel`/`offLabel` — wyświetlany tekst zmienia się
+ * przy przełączaniu (np. „Włączony”/„Wyłączony”).
+ * `<kpt-switch [(checked)]="on" onLabel="Włączony" offLabel="Wyłączony" />`
  */
 declare class KptSwitch implements FormCheckboxControl {
     readonly checked: _angular_core.ModelSignal<boolean>;
@@ -390,8 +696,51 @@ declare class KptSwitch implements FormCheckboxControl {
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
     readonly label: _angular_core.InputSignal<string>;
+    /** Pozycja etykiety `label` względem przełącznika: 'end' (prawo, domyślnie) lub 'start' (lewo). */
+    readonly labelPosition: _angular_core.InputSignal<"start" | "end">;
+    /** Tekst stanu włączonego (wyświetlany, gdy `checked`). */
+    readonly onLabel: _angular_core.InputSignal<string>;
+    /** Tekst stanu wyłączonego (wyświetlany, gdy nie `checked`). */
+    readonly offLabel: _angular_core.InputSignal<string>;
+    protected readonly hasStateLabels: _angular_core.Signal<boolean>;
+    /** Tekst zależny od stanu przełącznika. */
+    protected readonly stateLabel: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSwitch, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSwitch, "kpt-switch", never, { "checked": { "alias": "checked"; "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; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touch": "touch"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSwitch, "kpt-switch", never, { "checked": { "alias": "checked"; "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; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "onLabel": { "alias": "onLabel"; "required": false; "isSignal": true; }; "offLabel": { "alias": "offLabel"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "touch": "touch"; }, never, ["*"], true, never>;
+}
+
+/**
+ * Grupa przełączników. Domyślnie pojedynczy wybór (wzajemnie wykluczające się) —
+ * włączenie jednego wyłącza pozostałe, a wartość to `value` wybranej opcji (lub `null`).
+ * Z `multiple` przechodzi w tryb wielokrotny — wartość to tablica `T[]` zaznaczonych opcji.
+ * Zintegrowana z Signal Forms (`FormValueControl<T | T[] | null>`).
+ *
+ * @example
+ * <kpt-switch-group [(value)]="plan" [options]="plans" />
+ * <kpt-switch-group multiple [(value)]="tags" [options]="tagOptions" />
+ */
+declare class KptSwitchGroup<T = unknown> implements FormValueControl<unknown> {
+    readonly value: _angular_core.ModelSignal<unknown>;
+    readonly options: _angular_core.InputSignal<KptOption<T>[]>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    /** Układ: 'vertical' (domyślnie) lub 'horizontal'. */
+    readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
+    /** Tryb wielokrotnego wyboru — wartość to tablica `T[]` zaznaczonych opcji. Domyślnie false (pojedynczy wybór). */
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Czy ponowne kliknięcie aktywnej opcji ją odznacza (value = null). Dotyczy tylko trybu pojedynczego —
+     * w trybie `multiple` odznaczanie jest zawsze dozwolone. Domyślnie tak.
+     */
+    readonly allowDeselect: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Aktualna wartość jako tablica (tryb multiple) — normalizuje `null`/pojedynczą wartość. */
+    private readonly selectedValues;
+    protected isChecked(optValue: T): boolean;
+    protected onToggle(opt: KptOption<T>, checked: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSwitchGroup<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSwitchGroup<any>, "kpt-switch-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "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; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "allowDeselect": { "alias": "allowDeselect"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 /**
@@ -430,6 +779,7 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown> {
     /** Wartość: pojedyncza (T) lub tablica (T[]) w trybie multiple. */
     readonly value: _angular_core.ModelSignal<unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly filterText: _angular_core.WritableSignal<string>;
     protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -459,12 +809,26 @@ interface DayCell$1 {
     selected: boolean;
     disabled: boolean;
 }
+interface GridCell {
+    label: string;
+    value: string;
+    selected: boolean;
+    disabled: boolean;
+}
+/** Granulacja wyboru. */
+type KptDatepickerMode = 'date' | 'monthYear' | 'year' | 'month' | 'datetime' | 'time';
 /**
- * Wybór daty z własnym kalendarzem (CDK Overlay), Signal Forms. Wartość ISO 'RRRR-MM-DD'.
+ * Wybór daty/godziny z własnym kalendarzem (CDK Overlay), Signal Forms.
+ * Granulacja przez `selectionMode`: data, miesiąc+rok, rok, miesiąc, data+godzina, sama godzina.
+ * Godzina na tarczy zegara (dwa etapy: godziny → minuty), format 12/24h przez `hourFormat`.
+ * Format wartości zależy od trybu: 'RRRR-MM-DD' / 'RRRR-MM' / 'RRRR' / 'MM'
+ * / 'RRRR-MM-DDTHH:mm' (datetime) / 'HH:mm' (time). Czas przechowywany zawsze 24h.
  * Wymaga stylów overlay CDK: `import '@angular/cdk/overlay-prebuilt.css';`
  *
  * @example
  * <kpt-datepicker [formField]="f.birthDate" minDate="1900-01-01" />
+ * <kpt-datepicker selectionMode="datetime" [hourFormat]="12" [(value)]="meetingAt" />
+ * <kpt-datepicker selectionMode="time" [(value)]="alarm" />
  */
 declare class KptDatepicker implements FormValueControl<string> {
     readonly value: _angular_core.ModelSignal<string>;
@@ -473,25 +837,108 @@ declare class KptDatepicker implements FormValueControl<string> {
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
     readonly placeholder: _angular_core.InputSignal<string>;
+    readonly displayFormat: _angular_core.InputSignal<"pl" | "iso">;
+    /** Granulacja wyboru. */
+    readonly selectionMode: _angular_core.InputSignal<KptDatepickerMode>;
+    /** Prezentacja miesiąca w trybie 'month': słownie ('long') lub liczbą ('number'). */
+    readonly monthDisplay: _angular_core.InputSignal<"number" | "long">;
+    /** Format godziny: 24 lub 12 (z AM/PM). */
+    readonly hourFormat: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Krok minut (snap na tarczy). */
+    readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
     readonly minDate: _angular_core.InputSignal<string | null>;
     readonly maxDate: _angular_core.InputSignal<string | null>;
-    protected readonly weekdays: string[];
+    protected readonly effectivePlaceholder: _angular_core.Signal<string>;
+    protected readonly i18n: KptI18n;
+    protected readonly weekdays: _angular_core.Signal<string[]>;
+    private readonly months;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     private readonly today;
     private readonly view;
+    protected readonly timeStr: _angular_core.WritableSignal<string>;
+    protected readonly dtView: _angular_core.WritableSignal<"calendar" | "clock">;
+    private readonly pendingDate;
     protected readonly positions: ConnectedPosition[];
+    protected readonly viewYear: _angular_core.Signal<number>;
     protected readonly monthLabel: _angular_core.Signal<string>;
+    protected readonly yearPageStart: _angular_core.Signal<number>;
+    protected readonly yearRangeLabel: _angular_core.Signal<string>;
+    private formatTime;
+    /** Etykieta czasu na pasku trybu datetime (uwzględnia AM/PM). */
+    protected readonly timeBarLabel: _angular_core.Signal<string>;
     protected readonly display: _angular_core.Signal<string>;
+    private readonly selectedDateIso;
     protected readonly weeks: _angular_core.Signal<DayCell$1[][]>;
-    private parse;
+    protected readonly monthCells: _angular_core.Signal<GridCell[]>;
+    protected readonly yearCells: _angular_core.Signal<GridCell[]>;
+    private parseDate;
+    private parseTime;
+    private parseDateTime;
+    private isYearDisabled;
+    private isMonthYearDisabled;
+    private initialView;
+    private syncTimeFromValue;
     protected toggleOpen(): void;
     protected close(): void;
     protected selectDay(cell: DayCell$1): void;
+    protected selectCell(cell: GridCell): void;
+    protected openClock(): void;
+    protected backToCalendar(): void;
+    protected commit(): void;
     protected prevMonth(): void;
     protected nextMonth(): void;
+    protected prevYear(): void;
+    protected nextYear(): void;
+    protected prevYearPage(): void;
+    protected nextYearPage(): void;
     protected clear(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDatepicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDatepicker, "kpt-datepicker", never, { "value": { "alias": "value"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDatepicker, "kpt-datepicker", never, { "value": { "alias": "value"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "displayFormat": { "alias": "displayFormat"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "monthDisplay": { "alias": "monthDisplay"; "required": false; "isSignal": true; }; "hourFormat": { "alias": "hourFormat"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+}
+
+interface ClockMark {
+    label: string;
+    hour24: number;
+    x: number;
+    y: number;
+    inner: boolean;
+    selected: boolean;
+}
+/**
+ * Tarcza zegara (wybór godziny) — dwa etapy: godziny → minuty, klik lub przeciąganie.
+ * Format 12/24h (`hourFormat`); w 24h dodatkowy wewnętrzny pierścień 13–00, w 12h AM/PM.
+ * Wartość `HH:mm` (zawsze 24h). Używana przez `kpt-datepicker` i `kpt-date-range`.
+ *
+ * @example
+ * <kpt-clock [(value)]="time" [hourFormat]="12" [minuteStep]="5" />
+ */
+declare class KptClock {
+    readonly value: _angular_core.ModelSignal<string>;
+    readonly hourFormat: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
+    protected readonly hour: _angular_core.WritableSignal<number>;
+    protected readonly minute: _angular_core.WritableSignal<number>;
+    protected readonly clockPhase: _angular_core.WritableSignal<"hours" | "minutes">;
+    constructor();
+    private parse;
+    private emit;
+    protected readonly ampm: _angular_core.Signal<"AM" | "PM">;
+    protected readonly hour12: _angular_core.Signal<number>;
+    protected readonly hourLabel: _angular_core.Signal<string>;
+    protected readonly minuteLabel: _angular_core.Signal<string>;
+    private from12h;
+    protected readonly hourMarks: _angular_core.Signal<ClockMark[]>;
+    protected readonly minuteMarks: _angular_core.Signal<ClockMark[]>;
+    protected readonly handAngle: _angular_core.Signal<number>;
+    protected readonly handInner: _angular_core.Signal<boolean>;
+    protected setPhase(phase: 'hours' | 'minutes'): void;
+    protected setAmpm(target: 'AM' | 'PM'): void;
+    protected pickHour(mark: ClockMark): void;
+    protected pickMinute(mark: ClockMark): void;
+    protected onDialPointer(event: PointerEvent, face: HTMLElement): void;
+    protected onDialUp(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptClock, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptClock, "kpt-clock", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "hourFormat": { "alias": "hourFormat"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 /**
@@ -518,50 +965,171 @@ 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 = 'bold' | 'italic' | 'underline' | 'strike' | 'ul' | 'ol' | 'link' | 'clear';
+type KptRichTool = 'copy' | 'paste' | 'pasteText' | 'heading' | 'bold' | 'italic' | 'underline' | 'strike' | 'ul' | 'ol' | '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[][];
 /**
- * Lekki edytor tekstu sformatowanego (contenteditable) z konfigurowalnym paskiem przycisków.
- * Wartość = HTML. Bez zależności zewnętrznych. Signal Forms.
+ * Lekki edytor tekstu sformatowanego (contenteditable) z konfigurowalnym paskiem sekcji.
+ * Narzędzia: schowek (kopiuj / wklej / wklej bez formatowania), styl (nagłówki H1–H6 / paragraf),
+ * bold/italic/underline/strike/ul/ol, kolor tekstu i tła (popover), wyrównania, link, czyszczenie.
+ * `toolbar` przyjmuje płaską listę lub grupy (sekcje). Wartość = HTML. Signal Forms.
+ * Wymaga stylów overlay CDK (popover kolorów): `import '@angular/cdk/overlay-prebuilt.css';`
  *
  * @example
- * <kpt-rich-text [formField]="f.body" [toolbar]="['bold','italic','ul','link']" />
+ * <kpt-rich-text [formField]="f.body" />
+ * <kpt-rich-text [(value)]="v" [toolbar]="[['bold','italic'],['ul','ol'],['link']]" />
  */
 declare class KptRichText implements FormValueControl<string> {
     readonly value: _angular_core.ModelSignal<string>;
-    readonly toolbar: _angular_core.InputSignal<KptRichTool[]>;
+    readonly toolbar: _angular_core.InputSignal<KptRichToolbar>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
+    protected readonly swatches: string[];
     private readonly editor;
+    private savedRange;
+    protected readonly colorOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly colorKind: _angular_core.WritableSignal<"foreColor" | "backColor" | "cellBg">;
+    protected readonly sourceView: _angular_core.WritableSignal<boolean>;
+    protected readonly styleOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly tableOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly gridR: _angular_core.WritableSignal<number>;
+    protected readonly gridC: _angular_core.WritableSignal<number>;
+    protected readonly gridRows: number[];
+    protected readonly gridCols: number[];
+    protected readonly menuOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly menuPoint: _angular_core.WritableSignal<{
+        x: number;
+        y: number;
+    }>;
+    protected readonly borderOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly borderTarget: _angular_core.WritableSignal<"table" | "cell">;
+    private ctxCell;
+    private resize;
+    protected readonly selCount: _angular_core.WritableSignal<number>;
+    private selCells;
+    private selAnchor;
+    private selecting;
+    private canSplitCtx;
+    protected readonly styleOptions: _angular_core.Signal<{
+        tag: string;
+        label: string;
+    }[]>;
+    protected readonly styleLabel: _angular_core.Signal<string>;
+    protected readonly activeCmds: _angular_core.WritableSignal<Set<string>>;
+    protected readonly currentBlock: _angular_core.WritableSignal<string>;
+    protected readonly positions: ConnectedPosition[];
+    /** Sekcje paska (normalizacja płaskiej listy do jednej grupy). */
+    protected readonly sections: _angular_core.Signal<KptRichTool[][]>;
     constructor();
     protected icon(item: KptRichTool): KptIconName;
+    protected aria(item: KptRichTool): string;
+    protected isActive(item: KptRichTool): boolean;
+    private inEditor;
+    private refreshState;
     protected onInput(): void;
+    protected onSource(event: Event): void;
+    private focusEditor;
+    private saveSelection;
+    private restoreSelection;
     protected exec(item: KptRichTool): void;
+    protected openStyle(): void;
+    protected closeStyle(): void;
+    protected pickStyle(tag: string): void;
+    protected openColor(kind: 'foreColor' | 'backColor'): void;
+    protected closeColor(): void;
+    protected applyColor(color: string): void;
+    protected onColorInput(event: Event): void;
+    private pasteRich;
+    private pastePlain;
+    /** Natywne wklejanie — oczyść (bez śmieci z Worda/WWW). */
+    protected onPaste(event: ClipboardEvent): void;
+    protected closeTable(): void;
+    protected gridHover(r: number, c: number): void;
+    protected insertTable(rows: number, cols: number): void;
+    protected onContextMenu(event: MouseEvent): void;
+    protected closeMenu(): void;
+    private ctxTable;
+    private afterTableOp;
+    protected insertColumn(dir: 'left' | 'right'): void;
+    protected deleteColumn(): void;
+    protected insertRow(dir: 'above' | 'below'): void;
+    protected deleteRow(): void;
+    /** Zamień komórki wiersza między `<td>` a `<th>` (wiersz nagłówka). */
+    protected toggleHeaderRow(): void;
+    /** Zamień komórki kolumny między `<td>` a `<th>` (kolumna nagłówka). */
+    protected toggleHeaderColumn(): void;
+    private swapCellTag;
+    protected deleteTable(): void;
+    protected alignCell(a: 'left' | 'center' | 'right'): void;
+    /** Komórki objęte operacją: zaznaczenie (jeśli jest) lub bieżąca komórka menu. */
+    private activeCells;
+    protected openCellBg(): void;
+    protected openBorder(): void;
+    protected closeBorder(): void;
+    private borderCells;
+    protected setBorderWidth(w: 'none' | 'thin' | 'medium' | 'thick'): void;
+    protected setBorderColor(color: string): void;
+    protected onBorderColorInput(event: Event): void;
+    private normalizeColWidths;
+    protected onEditorMouseDown(event: MouseEvent): void;
+    protected onEditorMouseMove(event: MouseEvent): void;
+    private onResizeMove;
+    private onResizeEnd;
+    private buildGrid;
+    private selectRegion;
+    private clearSelection;
+    protected mergeCells(): void;
+    protected splitCell(): void;
+    /** Komórka w wierszu, przed którą wstawić (pierwsza o origin-col > gridCol), lub null (na koniec). */
+    private cellBeforeGridCol;
+    protected canMerge(): boolean;
+    protected canSplit(): boolean;
+    private sanitizeHtml;
     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>;
 }
 
+/** Wartość suwaka: pojedyncza liczba lub para `[min, max]` w trybie `range`. */
+type KptSliderValue = number | [number, number];
 /**
  * Suwak wartości (slider) na Signal Forms.
+ * W trybie `range` udostępnia dwa uchwyty, a wartość jest parą `[min, max]`.
  *
  * @example
  * <kpt-slider [formField]="f.volume" [min]="0" [max]="100" [step]="5" showValue />
- */
-declare class KptSlider implements FormValueControl<number> {
-    readonly value: _angular_core.ModelSignal<number>;
-    readonly min: _angular_core.InputSignal<number | undefined>;
-    readonly max: _angular_core.InputSignal<number | undefined>;
+ * <kpt-slider range [(value)]="zakres" [min]="0" [max]="100" showValue />
+ */
+declare class KptSlider implements FormValueControl<KptSliderValue> {
+    readonly value: _angular_core.ModelSignal<KptSliderValue>;
+    /** Tryb zakresu: dwa uchwyty; wartość jako para `[min, max]`. */
+    readonly range: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly min: _angular_core.InputSignal<KptSliderValue | undefined>;
+    readonly max: _angular_core.InputSignal<KptSliderValue | undefined>;
     readonly step: _angular_core.InputSignal<number>;
     readonly showValue: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
-    protected readonly percent: _angular_core.Signal<number>;
+    private toNum;
+    protected readonly minN: _angular_core.Signal<number>;
+    protected readonly maxN: _angular_core.Signal<number>;
+    /** Bieżąca para `[low, high]` — również dla trybu pojedynczego (low = min). */
+    private readonly pair;
+    protected readonly single: _angular_core.Signal<number>;
+    protected readonly low: _angular_core.Signal<number>;
+    protected readonly high: _angular_core.Signal<number>;
+    protected setLow(v: number): void;
+    protected setHigh(v: number): void;
+    private pct;
+    protected readonly lowPct: _angular_core.Signal<number>;
+    protected readonly highPct: _angular_core.Signal<number>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSlider, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSlider, "kpt-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "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<KptSlider, "kpt-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "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>;
 }
 
 /**
@@ -600,6 +1168,7 @@ declare class KptFileUpload implements FormValueControl<File[]> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly dragover: _angular_core.WritableSignal<boolean>;
     protected onSelect(event: Event): void;
     protected onDragOver(event: DragEvent): void;
@@ -633,6 +1202,8 @@ interface KptDateRangeValue {
     start: string;
     end: string;
 }
+/** Granulacja zakresu: same daty, daty z godziną, same godziny. */
+type KptDateRangeMode = 'date' | 'datetime' | 'time';
 interface DayCell {
     day: number;
     iso: string;
@@ -644,11 +1215,14 @@ interface DayCell {
 }
 /**
  * Wybór zakresu dat z kalendarzem (CDK Overlay), Signal Forms.
- * Wartość: `{ start: 'RRRR-MM-DD', end: 'RRRR-MM-DD' }`.
+ * `mode`: 'date' (domyślnie), 'datetime' (data+godzina, tarcza zegara), 'time' (sama godzina).
+ * Wartość: `{ start, end }` — daty 'RRRR-MM-DD', datetime 'RRRR-MM-DDTHH:mm', godziny 'HH:mm'.
  * Wymaga `import '@angular/cdk/overlay-prebuilt.css';`
  *
  * @example
  * <kpt-date-range [formField]="f.period" />
+ * <kpt-date-range mode="datetime" [hourFormat]="12" [(value)]="span" />
+ * <kpt-date-range mode="time" [(value)]="hours" />
  */
 declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
     readonly value: _angular_core.ModelSignal<KptDateRangeValue>;
@@ -656,23 +1230,41 @@ declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
-    readonly placeholder: _angular_core.InputSignal<string>;
-    protected readonly weekdays: string[];
+    /** Placeholder; bez wartości używa i18n (`dateRange.placeholder`). */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly displayFormat: _angular_core.InputSignal<"pl" | "iso">;
+    readonly mode: _angular_core.InputSignal<KptDateRangeMode>;
+    readonly hourFormat: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
+    protected readonly i18n: KptI18n;
+    protected readonly weekdays: _angular_core.Signal<string[]>;
+    private readonly months;
+    protected readonly effectivePlaceholder: _angular_core.Signal<string>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     private readonly today;
     private readonly view;
+    protected readonly startTime: _angular_core.WritableSignal<string>;
+    protected readonly endTime: _angular_core.WritableSignal<string>;
+    protected readonly timeEnd: _angular_core.WritableSignal<"start" | "end">;
+    private readonly startDate;
+    private readonly endDate;
     protected readonly positions: ConnectedPosition[];
     protected readonly monthLabel: _angular_core.Signal<string>;
+    private datePart;
+    private timePart;
+    private fmtDate;
+    private fmtTime;
     protected readonly display: _angular_core.Signal<string>;
     protected readonly weeks: _angular_core.Signal<DayCell[][]>;
     protected toggleOpen(): void;
     protected close(): void;
     protected selectDay(cell: DayCell): void;
+    protected commit(): void;
     protected prevMonth(): void;
     protected nextMonth(): void;
     protected clear(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDateRange, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDateRange, "kpt-date-range", never, { "value": { "alias": "value"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDateRange, "kpt-date-range", never, { "value": { "alias": "value"; "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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "displayFormat": { "alias": "displayFormat"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "hourFormat": { "alias": "hourFormat"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 /**
@@ -692,6 +1284,7 @@ declare class KptInputNumber implements FormValueControl<number | null> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly display: _angular_core.Signal<string>;
     protected readonly canInc: _angular_core.Signal<boolean>;
     protected readonly canDec: _angular_core.Signal<boolean>;
@@ -720,6 +1313,7 @@ declare class KptPassword implements FormValueControl<string> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     protected readonly strength: _angular_core.Signal<Strength>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptPassword, never>;
@@ -761,12 +1355,15 @@ declare class KptInputOtp implements FormValueControl<string> {
  */
 declare class KptChipsInput implements FormValueControl<string[]> {
     readonly value: _angular_core.ModelSignal<string[]>;
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Placeholder; bez wartości używa i18n (`chipsInput.placeholder`). */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
     readonly allowDuplicates: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
+    protected readonly effectivePlaceholder: _angular_core.Signal<string>;
     protected onKeydown(event: KeyboardEvent): void;
     protected commit(el: HTMLInputElement): void;
     protected removeAt(index: number): void;
@@ -812,6 +1409,7 @@ declare class KptListbox<T = unknown> implements FormValueControl<T | T[] | null
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly query: _angular_core.WritableSignal<string>;
     protected readonly visible: _angular_core.Signal<KptOption<T>[]>;
     protected isSelected(v: T): boolean;
@@ -858,7 +1456,9 @@ type KptCardVariant = 'elevated' | 'outlined';
 /**
  * Karta Koncept UI — powierzchnia z wyniesieniem (elevated) lub obramowaniem (outlined).
  * Opcjonalny nagłówek przez `header`; treść przez projekcję. Stopkę wstaw z atrybutem
- * `kptCardFooter`.
+ * `kptCardFooter`. Dla bogatych układów (media/profil) ustaw `flush` (body bez paddingu)
+ * i użyj reużywalnych klas: `kpt-card__media`, `__lead`, `__title`, `__subtitle`,
+ * `__section`, `__tags`, `__meta`, `__avatar`, `__actions`.
  *
  * @example
  * <kpt-card header="Ustawienia">
@@ -871,8 +1471,10 @@ declare class KptCard {
     readonly variant: _angular_core.InputSignal<KptCardVariant>;
     /** Opcjonalny tekst nagłówka. */
     readonly header: _angular_core.InputSignal<string>;
+    /** Body bez wewnętrznego paddingu — dla układów zarządzających własnymi sekcjami. */
+    readonly flush: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptCard, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptCard, "kpt-card", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; }, {}, never, ["*", "[kptCardFooter]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptCard, "kpt-card", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "flush": { "alias": "flush"; "required": false; "isSignal": true; }; }, {}, never, ["*", "[kptCardFooter]"], true, never>;
 }
 
 type KptDividerOrientation = 'horizontal' | 'vertical';
@@ -958,8 +1560,11 @@ declare class KptPanel {
     readonly header: _angular_core.InputSignal<string>;
     readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly collapsed: _angular_core.ModelSignal<boolean>;
+    readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animationDuration: _angular_core.InputSignal<number>;
+    protected readonly i18n: KptI18n;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptPanel, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPanel, "kpt-panel", never, { "header": { "alias": "header"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["[kptPanelActions]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPanel, "kpt-panel", never, { "header": { "alias": "header"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["[kptPanelActions]", "*"], true, never>;
 }
 
 /**
@@ -972,8 +1577,10 @@ declare class KptFieldset {
     readonly legend: _angular_core.InputSignal<string>;
     readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly collapsed: _angular_core.ModelSignal<boolean>;
+    readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animationDuration: _angular_core.InputSignal<number>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptFieldset, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFieldset, "kpt-fieldset", never, { "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFieldset, "kpt-fieldset", never, { "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["*"], true, never>;
 }
 
 type KptSplitterOrientation = 'horizontal' | 'vertical';
@@ -1011,6 +1618,7 @@ declare class KptSplitter {
 declare class KptScrollTop {
     readonly threshold: _angular_core.InputSignal<number>;
     readonly target: _angular_core.InputSignal<string | null>;
+    protected readonly i18n: KptI18n;
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     private scroller;
     constructor();
@@ -1031,6 +1639,7 @@ declare class KptImage {
     readonly alt: _angular_core.InputSignal<string>;
     readonly width: _angular_core.InputSignal<string | null>;
     readonly preview: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected openPreview(): void;
     protected close(): void;
@@ -1127,10 +1736,19 @@ declare class KptTab {
 declare class KptTabs {
     protected readonly tabs: _angular_core.Signal<readonly KptTab[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
+    readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animationDuration: _angular_core.InputSignal<number>;
+    private readonly tabBtns;
+    protected readonly inkX: _angular_core.WritableSignal<number>;
+    protected readonly inkW: _angular_core.WritableSignal<number>;
+    protected readonly direction: _angular_core.WritableSignal<number>;
     protected readonly activeTab: _angular_core.Signal<KptTab>;
+    protected readonly activePanels: _angular_core.Signal<KptTab[]>;
+    constructor();
+    protected measureInk(): void;
     protected select(index: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptTabs, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptTabs, "kpt-tabs", never, { "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; }, ["tabs"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptTabs, "kpt-tabs", never, { "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; }, ["tabs"], never, true, never>;
 }
 
 /**
@@ -1141,6 +1759,7 @@ declare class KptAccordionPanel {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly expanded: _angular_core.ModelSignal<boolean>;
     private readonly accordion;
+    protected readonly animMs: _angular_core.Signal<string>;
     protected toggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAccordionPanel, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAccordionPanel, "kpt-accordion-panel", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["*"], true, never>;
@@ -1157,11 +1776,13 @@ declare class KptAccordionPanel {
  */
 declare class KptAccordion {
     readonly multi: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animationDuration: _angular_core.InputSignal<number>;
     private readonly panels;
     /** Wywoływane przez panel przy otwarciu — zamyka pozostałe, gdy nie `multi`. */
     onOpen(opened: KptAccordionPanel): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAccordion, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAccordion, "kpt-accordion", never, { "multi": { "alias": "multi"; "required": false; "isSignal": true; }; }, {}, ["panels"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAccordion, "kpt-accordion", never, { "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, {}, ["panels"], ["*"], true, never>;
 }
 
 interface KptBreadcrumbItem {
@@ -1176,6 +1797,7 @@ interface KptBreadcrumbItem {
  */
 declare class KptBreadcrumb {
     readonly items: _angular_core.InputSignal<KptBreadcrumbItem[]>;
+    protected readonly i18n: KptI18n;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBreadcrumb, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBreadcrumb, "kpt-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -1206,12 +1828,16 @@ declare class KptStep {
 declare class KptStepper {
     protected readonly steps: _angular_core.Signal<readonly KptStep[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
+    readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animationDuration: _angular_core.InputSignal<number>;
+    protected readonly direction: _angular_core.WritableSignal<number>;
     protected readonly activeStep: _angular_core.Signal<KptStep>;
+    protected readonly activePanels: _angular_core.Signal<KptStep[]>;
     goTo(index: number): void;
     next(): void;
     prev(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptStepper, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptStepper, "kpt-stepper", never, { "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; }, ["steps"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptStepper, "kpt-stepper", never, { "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; }, ["steps"], never, true, never>;
 }
 
 /**
@@ -1229,9 +1855,11 @@ declare class KptPaginator {
     readonly pageIndex: _angular_core.ModelSignal<number>;
     /** Dostępne rozmiary strony. */
     readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
+    protected readonly i18n: KptI18n;
     readonly totalPages: _angular_core.Signal<number>;
     readonly rangeStart: _angular_core.Signal<number>;
     readonly rangeEnd: _angular_core.Signal<number>;
+    protected readonly rangeLabel: _angular_core.Signal<string>;
     readonly canPrev: _angular_core.Signal<boolean>;
     readonly canNext: _angular_core.Signal<boolean>;
     constructor();
@@ -1242,6 +1870,23 @@ declare class KptPaginator {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPaginator, "kpt-paginator", never, { "length": { "alias": "length"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageIndex": { "alias": "pageIndex"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "pageIndex": "pageIndexChange"; }, never, never, true, never>;
 }
 
+/** Rodzaj kontrolki filtra w nagłówku kolumny. */
+type KptColumnFilterType = 'text' | 'number' | 'select' | 'dateRange' | 'numberRange' | 'slider';
+interface KptColumnFilter {
+    type: KptColumnFilterType;
+    /** Opcje dla `type: 'select'`. */
+    options?: KptOption<unknown>[];
+    /** Wielokrotny wybór dla `type: 'select'`. */
+    multiple?: boolean;
+    /** Placeholder kontrolki. */
+    placeholder?: string;
+    /** Dolna granica dla `type: 'slider'` (domyślnie 0). */
+    min?: number;
+    /** Górna granica dla `type: 'slider'` (domyślnie 100). */
+    max?: number;
+    /** Krok dla `type: 'slider'` (domyślnie 1). */
+    step?: number;
+}
 interface KptColumn {
     /** Nazwa pola w wierszu. */
     field: string;
@@ -1255,6 +1900,8 @@ interface KptColumn {
     width?: string;
     /** Zamrożenie (sticky) — obsługiwane dla wiodących, sąsiadujących kolumn. */
     frozen?: boolean;
+    /** Filtr kolumny w wierszu nagłówka (input/number/select/zakres dat). */
+    filter?: KptColumnFilter;
 }
 type SortDir = 'asc' | 'desc' | null;
 /** Stan przekazywany w trybie lazy przy każdej zmianie sortowania/filtra/strony. */
@@ -1264,6 +1911,8 @@ interface KptTableLazyState {
     sortField: string | null;
     sortDir: SortDir;
     filter: string;
+    /** Wartości filtrów per kolumna (pole → wartość kontrolki). */
+    columnFilters: Record<string, unknown>;
 }
 /**
  * Flagowa tabela danych Koncept UI: kolumny konfiguracją, sortowanie,
@@ -1282,12 +1931,15 @@ declare class KptDataTable<T = Record<string, unknown>> {
     readonly columns: _angular_core.InputSignal<readonly KptColumn[]>;
     readonly data: _angular_core.InputSignal<readonly T[]>;
     readonly filterable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Pozycja wiersza filtrów kolumn względem etykiet: nad ('top') lub pod ('bottom'). */
+    readonly filterRowPosition: _angular_core.InputSignal<"bottom" | "top">;
     /** Rozmiar strony; 0 wyłącza paginację. */
     readonly pageSize: _angular_core.InputSignal<number>;
     readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
     readonly selectable: _angular_core.InputSignal<"none" | "single" | "multiple">;
     readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly emptyMessage: _angular_core.InputSignal<string>;
+    /** Komunikat pustej tabeli; bez wartości używa i18n (`dataTable.empty`). */
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
     /** Pole identyfikujące wiersz (dla zaznaczania). Bez niego — porównanie po referencji. */
     readonly rowKey: _angular_core.InputSignal<string | null>;
     /** Wysokość przewijalnego obszaru (np. '400px'); sticky header pozostaje widoczny. */
@@ -1306,16 +1958,27 @@ declare class KptDataTable<T = Record<string, unknown>> {
     readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Łączna liczba rekordów (wymagane w trybie lazy dla paginacji). */
     readonly totalRecords: _angular_core.InputSignal<number | null>;
+    /** Rozwijane wiersze: dodaje kolumnę z przełącznikiem i renderuje szablon `kptRowDetail`. */
+    readonly expandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Zezwala na rozwinięcie wielu wierszy naraz (domyślnie tak). */
+    readonly multiExpand: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly selection: _angular_core.ModelSignal<T[]>;
+    /** Rozwinięte wiersze (dwukierunkowo). */
+    readonly expandedRows: _angular_core.ModelSignal<T[]>;
     readonly rowClick: _angular_core.OutputEmitterRef<T>;
     /** Emitowane w trybie lazy przy zmianie sortowania/filtra/strony. */
     readonly lazyLoad: _angular_core.OutputEmitterRef<KptTableLazyState>;
+    protected readonly i18n: KptI18n;
+    /** Komunikat pustej tabeli (input albo domyślny z i18n). */
+    protected readonly emptyText: _angular_core.Signal<string>;
     /** Kolumny w bieżącej kolejności (po ewentualnym przestawieniu). */
     protected readonly orderedColumns: _angular_core.WritableSignal<readonly KptColumn[]>;
     private readonly scrollEl;
     protected readonly scrollTop: _angular_core.WritableSignal<number>;
     protected readonly viewportHeight: _angular_core.WritableSignal<number>;
     private readonly buffer;
+    private readonly theadEl;
+    protected readonly theadOffset: _angular_core.WritableSignal<number>;
     constructor();
     protected onScroll(event: Event): void;
     protected readonly virtualStart: _angular_core.Signal<number>;
@@ -1324,19 +1987,45 @@ declare class KptDataTable<T = Record<string, unknown>> {
     protected readonly topPad: _angular_core.Signal<number>;
     protected readonly bottomPad: _angular_core.Signal<number>;
     protected readonly dragIndex: _angular_core.WritableSignal<number | null>;
+    /** Kolumna przeciągalna tylko gdy `reorderable` i nie jest zamrożona (frozen musi zostać wiodąca). */
+    protected isColDraggable(col: KptColumn): boolean;
+    /** Liczba wiodących kolumn zamrożonych — poza nie wolno upuszczać ani ich przesuwać. */
+    private frozenLeadCount;
     protected onColDragStart(index: number, event: DragEvent): void;
-    protected onColDragOver(event: DragEvent): void;
+    protected onColDragOver(index: number, event: DragEvent): void;
     protected onColDrop(index: number, event: DragEvent): void;
     protected onColDragEnd(): void;
     exportCsv(): void;
     private readonly cellDefs;
     private readonly cellMap;
     protected cellTemplate(field: string): TemplateRef<unknown> | null;
+    private readonly rowDetailDef;
+    protected readonly rowDetailTpl: _angular_core.Signal<TemplateRef<any> | null>;
+    /** Kolumna z przełącznikiem widoczna, gdy włączono `expandable` i podano szablon `kptRowDetail`. */
+    protected readonly hasRowDetail: _angular_core.Signal<boolean>;
+    protected isExpanded(row: T): boolean;
+    protected toggleExpand(row: T): void;
     protected readonly filterText: _angular_core.WritableSignal<string>;
+    protected readonly columnFilters: _angular_core.WritableSignal<Record<string, unknown>>;
     protected readonly sortField: _angular_core.WritableSignal<string | null>;
     protected readonly sortDir: _angular_core.WritableSignal<SortDir>;
     protected readonly pageIndex: _angular_core.WritableSignal<number>;
     protected readonly pageSizeState: _angular_core.WritableSignal<number>;
+    protected readonly hasColumnFilters: _angular_core.Signal<boolean>;
+    protected setColumnFilter(field: string, value: unknown): void;
+    /** Input liczbowy — pozostaw tylko cyfry i zsynchronizuj DOM z wartością. */
+    protected onNumberFilter(field: string, event: Event): void;
+    /** Bieżąca wartość filtra zakresu liczbowego (min/max) dla kolumny. */
+    protected rangeVal(field: string): {
+        min: string;
+        max: string;
+    };
+    /** Aktualizuj jedną granicę zakresu (min/max), pozostawiając tylko cyfry. */
+    protected setRangeFilter(field: string, bound: 'min' | 'max', event: Event): void;
+    /** Bieżąca para `[lo, hi]` filtra suwakowego dla kolumny (domyślnie pełen zakres). */
+    protected sliderVal(col: KptColumn): [number, number];
+    private static toIso;
+    private matchesColumnFilters;
     private readonly filtered;
     private readonly sorted;
     protected readonly filteredCount: _angular_core.Signal<number>;
@@ -1345,8 +2034,14 @@ declare class KptDataTable<T = Record<string, unknown>> {
     protected readonly displayCount: _angular_core.Signal<number>;
     private parseWidthPx;
     /** Mapa pole → przesunięcie left (px) dla wiodących zamrożonych kolumn. */
+    /** Suma szerokości wiodących kolumn systemowych (rozwijanie + zaznaczanie) w px. */
+    private readonly leadingStickyWidth;
     private readonly frozenOffsets;
     protected readonly hasFrozen: _angular_core.Signal<boolean>;
+    /** Sticky-left kolumny rozwijania (px) — 0, gdy tabela ma kolumny zamrożone. */
+    protected readonly expanderStickyLeft: _angular_core.Signal<0 | null>;
+    /** Sticky-left kolumny zaznaczania (px) — za kolumną rozwijania, jeśli obecna. */
+    protected readonly checkboxStickyLeft: _angular_core.Signal<number | null>;
     protected frozenLeft(field: string): number | null;
     protected isFrozen(field: string): boolean;
     protected toggleSort(col: KptColumn): void;
@@ -1357,12 +2052,13 @@ declare class KptDataTable<T = Record<string, unknown>> {
     protected isSelected(row: T): boolean;
     protected toggleRow(row: T): void;
     protected readonly pageAllSelected: _angular_core.Signal<boolean>;
+    protected readonly pageSomeSelected: _angular_core.Signal<boolean>;
     protected toggleAllOnPage(): void;
     protected onRowClick(row: T): void;
     protected getValue(row: T, field: string): unknown;
     protected trackRow: (row: T) => unknown;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDataTable<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDataTable<any>, "kpt-data-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "filterable": { "alias": "filterable"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "rowKey": { "alias": "rowKey"; "required": false; "isSignal": true; }; "scrollHeight": { "alias": "scrollHeight"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "exportable": { "alias": "exportable"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "rowClick": "rowClick"; "lazyLoad": "lazyLoad"; }, ["cellDefs"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDataTable<any>, "kpt-data-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "filterable": { "alias": "filterable"; "required": false; "isSignal": true; }; "filterRowPosition": { "alias": "filterRowPosition"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "rowKey": { "alias": "rowKey"; "required": false; "isSignal": true; }; "scrollHeight": { "alias": "scrollHeight"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "exportable": { "alias": "exportable"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "multiExpand": { "alias": "multiExpand"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "expandedRows": { "alias": "expandedRows"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "expandedRows": "expandedRowsChange"; "rowClick": "rowClick"; "lazyLoad": "lazyLoad"; }, ["cellDefs", "rowDetailDef"], never, true, never>;
 }
 
 /**
@@ -1384,6 +2080,23 @@ declare class KptCellDef {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptCellDef, "ng-template[kptCell]", never, { "kptCell": { "alias": "kptCell"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Szablon rozwijanego wiersza (row detail) dla `kpt-data-table`. Renderowany pod
+ * wierszem po rozwinięciu. Kontekst: `$implicit` = wiersz. Wymaga `expandable`.
+ *
+ * @example
+ * <kpt-data-table [columns]="cols" [data]="rows" expandable>
+ *   <ng-template kptRowDetail let-row>
+ *     <div class="szczegoly">{{ row.opis }}</div>
+ *   </ng-template>
+ * </kpt-data-table>
+ */
+declare class KptRowDetailDef {
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptRowDetailDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptRowDetailDef, "ng-template[kptRowDetail]", never, {}, {}, never, never, true, never>;
+}
+
 interface KptTreeNode<T = unknown> {
     label: string;
     value?: T;
@@ -1443,6 +2156,7 @@ declare class KptTimeline {
 declare class KptCarousel<T = unknown> {
     readonly items: _angular_core.InputSignal<T[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
+    protected readonly i18n: KptI18n;
     protected readonly slideTpl: _angular_core.Signal<TemplateRef<any>>;
     next(): void;
     prev(): void;
@@ -1465,6 +2179,7 @@ declare class KptDataView<T = unknown> {
     readonly layout: _angular_core.ModelSignal<"list" | "grid">;
     readonly pageSize: _angular_core.InputSignal<number>;
     readonly paginated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected readonly itemTpl: _angular_core.Signal<TemplateRef<any>>;
     protected readonly pageIndex: _angular_core.ModelSignal<number>;
     protected readonly showPager: _angular_core.Signal<boolean>;
@@ -1485,9 +2200,14 @@ declare class KptDataView<T = unknown> {
 declare class KptPickList<T = unknown> {
     readonly source: _angular_core.ModelSignal<T[]>;
     readonly target: _angular_core.ModelSignal<T[]>;
-    readonly sourceHeader: _angular_core.InputSignal<string>;
-    readonly targetHeader: _angular_core.InputSignal<string>;
+    /** Nagłówek listy źródłowej; bez wartości używa i18n (`pickList.available`). */
+    readonly sourceHeader: _angular_core.InputSignal<string | undefined>;
+    /** Nagłówek listy docelowej; bez wartości używa i18n (`pickList.selected`). */
+    readonly targetHeader: _angular_core.InputSignal<string | undefined>;
     protected readonly itemTpl: _angular_core.Signal<TemplateRef<any>>;
+    protected readonly i18n: KptI18n;
+    protected readonly effectiveSourceHeader: _angular_core.Signal<string>;
+    protected readonly effectiveTargetHeader: _angular_core.Signal<string>;
     protected readonly selSource: _angular_core.WritableSignal<Set<T>>;
     protected readonly selTarget: _angular_core.WritableSignal<Set<T>>;
     protected toggle(side: 'source' | 'target', item: T): void;
@@ -1508,6 +2228,7 @@ declare class KptPickList<T = unknown> {
 declare class KptOrderList<T = unknown> {
     readonly items: _angular_core.ModelSignal<T[]>;
     readonly header: _angular_core.InputSignal<string>;
+    protected readonly i18n: KptI18n;
     protected readonly itemTpl: _angular_core.Signal<TemplateRef<any>>;
     protected readonly selected: _angular_core.WritableSignal<number | null>;
     protected moveSelected(dir: -1 | 1): void;
@@ -1530,6 +2251,7 @@ declare class KptGalleria {
     readonly items: _angular_core.InputSignal<KptGalleriaItem[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
     readonly showThumbnails: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected readonly current: _angular_core.Signal<KptGalleriaItem>;
     protected next(): void;
     protected prev(): void;
@@ -1549,6 +2271,7 @@ declare class KptAlert {
     readonly title: _angular_core.InputSignal<string>;
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     protected iconName(): KptIconName;
     protected dismiss(): void;
@@ -1575,6 +2298,7 @@ declare class KptDialog {
     readonly header: _angular_core.InputSignal<string>;
     /** Pozwala zamknąć klawiszem Esc / przyciskiem ×. */
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     private readonly dialogRef;
     constructor();
     protected onCancel(event: Event): void;
@@ -1616,6 +2340,7 @@ declare class KptToastService {
  */
 declare class KptToastContainer {
     private readonly service;
+    protected readonly i18n: KptI18n;
     protected readonly toasts: _angular_core.Signal<_konce_pt_angular.KptToast[]>;
     protected dismiss(id: number): void;
     protected icon(variant: KptAlertVariant): KptIconName;
@@ -1708,6 +2433,7 @@ declare class KptDrawer {
     readonly header: _angular_core.InputSignal<string>;
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected onBackdrop(): void;
     protected close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDrawer, never>;
@@ -1737,6 +2463,9 @@ declare class KptContextMenu<T = unknown> {
 
 /**
  * Pozioma belka menu z rozwijanymi pod-menu. Pozycje bez `items` działają jak akcje/linki.
+ * Pod-menu renderowane przez CDK Overlay (doczepiane do `body`), więc nie są przycinane
+ * przez rodzica z `overflow: hidden`. Wymaga stylów overlay CDK:
+ * `import '@angular/cdk/overlay-prebuilt.css';`
  *
  * @example
  * <kpt-menubar [items]="items" (select)="onSelect($event)" />
@@ -1745,6 +2474,7 @@ declare class KptMenubar<T = unknown> {
     readonly items: _angular_core.InputSignal<KptMenuItem<T>[]>;
     readonly select: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
     protected readonly openIndex: _angular_core.WritableSignal<number | null>;
+    protected readonly positions: ConnectedPosition[];
     protected toggle(i: number, item: KptMenuItem<T>): void;
     protected pick(item: KptMenuItem<T>): void;
     protected closeAll(): void;
@@ -1755,6 +2485,9 @@ declare class KptMenubar<T = unknown> {
 /**
  * Mega-menu — pozioma belka z szerokim, wielokolumnowym panelem.
  * Struktura: pozycja górna → `items` (kolumny) → każda kolumna `items` (odnośniki).
+ * Panel renderowany przez CDK Overlay (doczepiony do `body`), więc nie jest przycinany
+ * przez rodzica z `overflow: hidden`. Wymaga stylów overlay CDK:
+ * `import '@angular/cdk/overlay-prebuilt.css';`
  *
  * @example
  * <kpt-megamenu [items]="items" (select)="onSelect($event)" />
@@ -1763,6 +2496,7 @@ declare class KptMegamenu<T = unknown> {
     readonly items: _angular_core.InputSignal<KptMenuItem<T>[]>;
     readonly select: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
     protected readonly openIndex: _angular_core.WritableSignal<number | null>;
+    protected readonly positions: ConnectedPosition[];
     protected activeColumns(): KptMenuItem<T>[];
     protected toggle(i: number): void;
     protected pick(link: KptMenuItem<T>): void;
@@ -1807,6 +2541,7 @@ declare class KptConfirmService {
  * Umieść raz w aplikacji (np. obok `<kpt-toast-container />`).
  */
 declare class KptConfirmContainer {
+    protected readonly i18n: KptI18n;
     protected readonly service: KptConfirmService;
     protected readonly req: _angular_core.Signal<_konce_pt_angular.KptConfirmRequest | null>;
     protected readonly isOpen: _angular_core.Signal<boolean>;
@@ -1827,6 +2562,7 @@ declare class KptBottomSheet {
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly header: _angular_core.InputSignal<string>;
     readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected onBackdrop(): void;
     protected close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBottomSheet, never>;
@@ -1844,8 +2580,11 @@ declare class KptSpeedDial<T = unknown> {
     readonly items: _angular_core.InputSignal<KptMenuItem<T>[]>;
     readonly direction: _angular_core.InputSignal<KptSpeedDialDirection>;
     readonly icon: _angular_core.InputSignal<string>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Etykieta a11y FAB (stan zamknięty); bez wartości używa i18n (`speedDial.actions`). */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly select: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
+    protected readonly i18n: KptI18n;
+    protected readonly effectiveAriaLabel: _angular_core.Signal<string>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected toggle(): void;
     protected close(): void;
@@ -1854,5 +2593,5 @@ 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; }; }, { "select": "select"; }, never, never, true, never>;
 }
 
-export { KptAccordion, KptAccordionPanel, KptAlert, KptAppShell, KptAutocomplete, KptAvatar, KptAvatarGroup, KptBadge, KptBottomSheet, KptBreadcrumb, KptButton, KptButtonGroup, KptCard, KptCarousel, KptCellDef, KptCheckbox, KptChip, KptChipsInput, KptColorPicker, KptConfirmContainer, KptConfirmService, KptContextMenu, KptDataTable, KptDataView, KptDateRange, KptDatepicker, KptDialog, KptDivider, KptDrawer, KptEmpty, KptFab, KptFieldset, KptFileUpload, KptFormField, KptGalleria, KptIcon, KptIconButton, KptIconRegistry, KptImage, KptInput, KptInputMask, KptInputNumber, KptInputOtp, KptKnob, KptListbox, KptMegamenu, KptMenu, KptMenubar, KptMeterGroup, KptOrderList, KptPaginator, KptPanel, KptPassword, KptPickList, KptPopover, KptProgress, KptRadioGroup, KptRating, KptRichText, KptScrollTop, KptSelect, KptSidenav, KptSkeleton, KptSlider, KptSpeedDial, KptSpinner, KptSplitButton, KptSplitter, KptStep, KptStepper, KptSwitch, KptTab, KptTabs, KptTextarea, KptTimeline, KptToastContainer, KptToastService, KptToolbar, KptTooltip, KptTree };
-export type { KptAlertVariant, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeVariant, KptBreadcrumbItem, KptButtonSize, KptButtonVariant, KptCardVariant, KptChipVariant, KptColumn, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDividerOrientation, KptDrawerPosition, KptGalleriaItem, KptIconName, KptInputType, KptMenuItem, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptSidenavMode, KptSkeletonVariant, KptSpeedDialDirection, KptSplitterOrientation, KptTableLazyState, KptTimelineItem, KptToast, KptToastOptions, KptTooltipPosition, KptTreeNode };
+export { KPT_I18N_CONFIG, KPT_MESSAGES_EN, KPT_MESSAGES_PL, KptAccordion, KptAccordionPanel, KptAlert, KptAppShell, KptAutocomplete, KptAvatar, KptAvatarGroup, KptBadge, KptBottomSheet, KptBreadcrumb, KptButton, KptButtonGroup, KptCard, KptCarousel, KptCellDef, 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, KptSidenav, KptSkeleton, KptSlider, KptSpeedDial, KptSpinner, KptSplitButton, KptSplitter, KptStep, KptStepper, KptSwitch, KptSwitchGroup, KptTab, KptTabs, KptTextarea, KptTimeline, KptToastContainer, KptToastService, KptToolbar, KptTooltip, KptTree, provideKptI18n };
+export type { DeepPartial, KptAlertVariant, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeVariant, KptBreadcrumbItem, KptButtonSize, KptButtonVariant, KptCardVariant, KptChipVariant, KptColumn, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDividerOrientation, KptDrawerPosition, KptGalleriaItem, KptI18nConfig, KptIconName, KptInputType, KptLocale, KptMenuItem, KptMessages, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitterOrientation, KptTableLazyState, KptTimelineItem, KptToast, KptToastOptions, KptTooltipPosition, KptTreeNode };