@konce-pt/angular 0.7.5 → 0.7.7

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

@@ -253,6 +253,8 @@ interface KptMessages {
         dateRange: string;
         min: string;
         max: string;
+        /** Interpolacja: {column}. Aria-label edytowalnej komórki. */
+        editCell: string;
     };
     confirm: {
         header: string;
@@ -457,10 +459,53 @@ declare class KptI18n {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<KptI18n>;
 }
 
+type KptBadgeVariant = 'neutral' | 'primary' | 'success' | 'danger' | 'warning' | 'info';
+type KptBadgeSize = 'sm' | 'md' | 'lg';
+/**
+ * Znacznik (badge) — licznik lub kropka statusu. Standalone lub nałożony na treść (`overlay`).
+ *
+ * @example
+ * <kpt-badge [value]="3" variant="danger" />
+ * <kpt-badge [value]="4" size="sm" variant="success" />
+ * <kpt-badge [value]="128" overlay><kpt-icon name="menu" /></kpt-badge>
+ * <kpt-badge dot variant="success" overlay><kpt-avatar name="AK" /></kpt-badge>
+ */
+declare class KptBadge {
+    readonly value: _angular_core.InputSignal<string | number | null>;
+    readonly variant: _angular_core.InputSignal<KptBadgeVariant>;
+    /** Rozmiar — `sm` mieści się w wierszu tekstu, `md` to domyślny licznik. */
+    readonly size: _angular_core.InputSignal<KptBadgeSize>;
+    readonly dot: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly overlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly max: _angular_core.InputSignal<number>;
+    protected readonly display: _angular_core.Signal<string | number>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBadge, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBadge, "kpt-badge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; "overlay": { "alias": "overlay"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/** Awatar wiersza nagłówkowego — te same dane, które przyjmuje `kpt-avatar`. */
+interface KptMenuItemAvatar {
+    src?: string;
+    name?: string;
+    icon?: string;
+}
 interface KptMenuItem<T = unknown> {
     label?: string;
     value?: T;
     icon?: string;
+    /** Druga linia tekstu: e-mail, rola, opis akcji. */
+    description?: string;
+    /** Odznaka po prawej stronie pozycji (licznik lub krótka etykieta). */
+    badge?: string | number;
+    /** Wariant odznaki — domyślnie `primary`. */
+    badgeVariant?: KptBadgeVariant;
+    /** Awatar po lewej — typowo w wierszu nagłówka menu użytkownika. */
+    avatar?: KptMenuItemAvatar;
+    /**
+     * Wiersz nagłówkowy: nieklikalny blok tekstu zamiast pozycji menu. Mieści dane zalogowanego
+     * użytkownika (`avatar` + `label` + `description`) albo opis funkcji menu.
+     */
+    header?: boolean;
     disabled?: boolean;
     danger?: boolean;
     separator?: boolean;
@@ -543,7 +588,14 @@ declare class KptIconRegistry {
     private readonly _version;
     /** Rośnie po każdej rejestracji — pozwala `kpt-icon` reagować na późne dodanie ikon. */
     readonly version: _angular_core.Signal<number>;
-    /** Rejestruje (lub nadpisuje) ikony: `{ nazwa: 'inner svg' }`. */
+    /**
+     * Rejestruje (lub nadpisuje) ikony: `{ nazwa: 'inner svg' }`.
+     *
+     * Treść jest sanityzowana do allowlisty geometrii SVG (`path`/`circle`/`rect`/`g`/`line`/
+     * `polygon`/`polyline`/`ellipse` i ich atrybutów kształtu/stylu) — mimo to `register()` wolno
+     * wołać wyłącznie z treścią kontrolowaną przez developera (build-time), nigdy bezpośrednio
+     * z danych runtime/CMS/uploadu bez własnej walidacji domenowej wyżej w stosie.
+     */
     register(icons: Record<string, string>): void;
     /** Zwraca wewnętrzny SVG ikony lub undefined. */
     get(name: string): string | undefined;
@@ -560,7 +612,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';
+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';
 
 /** Nazwa breakpointa z tokenów `--kpt-breakpoint-*` (mobile-first). */
 type KptBreakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
@@ -622,26 +674,6 @@ declare class KptBreakpointObserver {
  */
 declare function provideKptI18n(config?: KptI18nConfig): EnvironmentProviders;
 
-type KptBadgeVariant = 'neutral' | 'primary' | 'success' | 'danger' | 'warning' | 'info';
-/**
- * Znacznik (badge) — licznik lub kropka statusu. Standalone lub nałożony na treść (`overlay`).
- *
- * @example
- * <kpt-badge [value]="3" variant="danger" />
- * <kpt-badge [value]="128" overlay><kpt-icon name="menu" /></kpt-badge>
- * <kpt-badge dot variant="success" overlay><kpt-avatar name="AK" /></kpt-badge>
- */
-declare class KptBadge {
-    readonly value: _angular_core.InputSignal<string | number | null>;
-    readonly variant: _angular_core.InputSignal<KptBadgeVariant>;
-    readonly dot: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly overlay: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly max: _angular_core.InputSignal<number>;
-    protected readonly display: _angular_core.Signal<string | number>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBadge, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBadge, "kpt-badge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; "overlay": { "alias": "overlay"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
-}
-
 type KptChipVariant = 'neutral' | 'primary' | 'success' | 'danger' | 'warning' | 'info';
 /**
  * Chip / tag — etykieta, opcjonalnie usuwalna.
@@ -665,6 +697,11 @@ type KptAvatarShape = 'circle' | 'square';
 /**
  * Awatar — obraz, inicjały (z `name`) lub ikona.
  *
+ * `name` trafia do natywnego `title` (podpowiedź spod kursora — inicjały same w sobie
+ * nie mówią, kto to jest). Bez `src` awatar dostaje dodatkowo `role="img"` i `aria-label`,
+ * a same inicjały są `aria-hidden`, żeby czytnik nie przeczytał „AK" litera po literze.
+ * Przy `src` etykietę niesie już `alt` obrazu — nie dublujemy jej.
+ *
  * @example
  * <kpt-avatar src="/u/anna.jpg" />
  * <kpt-avatar name="Anna Kowalska" size="lg" />
@@ -971,10 +1008,15 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown>, KptFo
     readonly value: _angular_core.ModelSignal<unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
     protected readonly i18n: KptI18n;
-    protected readonly open: _angular_core.WritableSignal<boolean>;
+    /**
+     * Stan panelu (dwukierunkowy). Pozwala otworzyć listę z zewnątrz i — co ważniejsze — wiedzieć,
+     * kiedy user skończył wybierać. `touch` się do tego nie nadaje: leci też z blur triggera.
+     */
+    readonly open: _angular_core.ModelSignal<boolean>;
     protected readonly filterText: _angular_core.WritableSignal<string>;
     protected readonly activeIndex: _angular_core.WritableSignal<number>;
     protected readonly positions: ConnectedPosition[];
+    constructor();
     private readonly selectedValues;
     protected readonly selectedOptions: _angular_core.Signal<KptOption<T>[]>;
     protected readonly filteredOptions: _angular_core.Signal<KptOption<T>[]>;
@@ -993,7 +1035,7 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown>, KptFo
     protected onTriggerKeydown(event: KeyboardEvent): void;
     protected onPanelKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSelect<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSelect<any>, "kpt-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "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": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSelect<any>, "kpt-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "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": { "alias": "value"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "open": "openChange"; }, never, never, true, never>;
 }
 
 interface DayCell$1 {
@@ -1051,13 +1093,18 @@ declare class KptDatepicker implements FormValueControl<string> {
     protected readonly i18n: KptI18n;
     protected readonly weekdays: _angular_core.Signal<string[]>;
     private readonly months;
-    protected readonly open: _angular_core.WritableSignal<boolean>;
+    /**
+     * Stan kalendarza (dwukierunkowy). Pozwala otworzyć go z zewnątrz i — co ważniejsze — wiedzieć,
+     * kiedy user skończył wybierać. `touch` się do tego nie nadaje: leci też z blur triggera.
+     */
+    readonly open: _angular_core.ModelSignal<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[];
+    constructor();
     protected readonly viewYear: _angular_core.Signal<number>;
     protected readonly monthLabel: _angular_core.Signal<string>;
     protected readonly yearPageStart: _angular_core.Signal<number>;
@@ -1092,7 +1139,7 @@ declare class KptDatepicker implements FormValueControl<string> {
     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; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
+    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; }; "ariaLabel": { "alias": "ariaLabel"; "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; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "open": "openChange"; }, never, never, true, never>;
 }
 
 interface ClockMark {
@@ -1291,6 +1338,12 @@ declare class KptRichText implements FormValueControl<string> {
     private cellBeforeGridCol;
     protected canMerge(): boolean;
     protected canSplit(): boolean;
+    /**
+     * Waliduje URL z narzędzia „link" (blocklista jest obchodzalna, np. `javascript:`).
+     * Brak schematu → dopisz `https://` (spójne z zachowaniem `normalizeUrl` w mapie); `#`/`/`
+     * przechodzą bez zmian; schemat spoza `SAFE_URL_SCHEME` → `null` (link nie zostaje wstawiony).
+     */
+    private sanitizeUrl;
     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>;
@@ -1302,8 +1355,13 @@ 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]`.
  *
+ * Pod `[formField]` zakres bierze się ze schematu (`min(path.volume, 0)`,
+ * `max(path.volume, 100)`) — `[min]`/`[max]` obok `[formField]` to błąd kompilacji.
+ * Tryb `range` (wartość `[number, number]`) łączy się więc tylko z `[(value)]`.
+ *
  * @example
- * <kpt-slider [formField]="f.volume" [min]="0" [max]="100" [step]="5" showValue />
+ * <kpt-slider [formField]="f.volume" [step]="5" showValue />
+ * <kpt-slider [(value)]="volume" [min]="0" [max]="100" [step]="5" showValue />
  * <kpt-slider range [(value)]="zakres" [min]="0" [max]="100" showValue />
  */
 declare class KptSlider implements FormValueControl<KptSliderValue> {
@@ -1339,7 +1397,7 @@ declare class KptSlider implements FormValueControl<KptSliderValue> {
  * Ocena gwiazdkami (rating) na Signal Forms.
  *
  * @example
- * <kpt-rating [formField]="f.score" [max]="5" />
+ * <kpt-rating [formField]="f.score" [count]="5" />
  * <kpt-rating [value]="4" readonly />
  */
 declare class KptRating implements FormValueControl<number> {
@@ -1477,8 +1535,13 @@ declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
  * `showButtons="false"` chowa strzałki — wariant do zakresów „od–do", gdzie krokowanie
  * nie ma sensu, a pole ma wyglądać jak zwykłe `kpt-input` obok.
  *
+ * Pod `[formField]` granic NIE bindujemy w szablonie — `[min]`/`[max]` obok `[formField]`
+ * to błąd kompilacji. Deklaruje je schemat (`min(path.qty, 0)`, `max(path.qty, 99)`),
+ * a dyrektywa `FormField` sama wstrzykuje je w wejścia `min`/`max`.
+ *
  * @example
- * <kpt-input-number [formField]="f.qty" [min]="0" [max]="99" [step]="1" />
+ * <kpt-input-number [formField]="f.qty" [step]="1" />
+ * <kpt-input-number [(value)]="qty" [min]="0" [max]="99" suffix=" szt." />
  * <kpt-input-number [formField]="f.priceFrom" [showButtons]="false" suffix=" zł" />
  */
 declare class KptInputNumber implements FormValueControl<number | null> {
@@ -1643,8 +1706,12 @@ declare class KptListbox<T = unknown> implements FormValueControl<T | T[] | null
 /**
  * Pokrętło (knob) — wybór wartości po łuku, myszką lub strzałkami. Signal Forms.
  *
+ * Pod `[formField]` zakres bierze się ze schematu (`min(path.level, 0)`,
+ * `max(path.level, 100)`) — `[min]`/`[max]` obok `[formField]` to błąd kompilacji.
+ *
  * @example
- * <kpt-knob [formField]="f.level" [min]="0" [max]="100" [step]="1" />
+ * <kpt-knob [formField]="f.level" [step]="1" />
+ * <kpt-knob [(value)]="level" [min]="0" [max]="100" [step]="1" />
  */
 declare class KptKnob implements FormValueControl<number> {
     private readonly host;
@@ -1746,15 +1813,22 @@ declare class KptToolbar {
  * Panel boczny (sidenav) — stylowany kontener nawigacji, zwykle umieszczany w slocie
  * `kptShellSidenav` komponentu `kpt-app-shell`.
  *
+ * Treść domyślna ląduje w obszarze przewijanym. Element opatrzony atrybutem `kptSidenavFooter`
+ * trafia do stopki stojącej **poza** tym obszarem, więc zostaje przyklejony do dołu panelu
+ * niezależnie od długości nawigacji (blok użytkownika, wersja aplikacji, przełącznik motywu).
+ *
  * @example
  * <kpt-sidenav kptShellSidenav>
  *   <a href="#">Pulpit</a>
  *   <a href="#">Ustawienia</a>
+ *   <div kptSidenavFooter>
+ *     <kpt-avatar name="Anna Kowalska" size="sm" />
+ *   </div>
  * </kpt-sidenav>
  */
 declare class KptSidenav {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSidenav, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSidenav, "kpt-sidenav", never, {}, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSidenav, "kpt-sidenav", never, {}, {}, never, ["*", "[kptSidenavFooter]"], true, never>;
 }
 
 /**
@@ -2204,6 +2278,18 @@ interface KptColumnFilter {
     /** Krok dla `type: 'slider'` (domyślnie 1). */
     step?: number;
 }
+/** Rodzaj kontrolki edycji inline komórki. */
+type KptColumnEditType = 'text' | 'number' | 'date' | 'select' | 'multiselect';
+interface KptColumnEdit {
+    type: KptColumnEditType;
+    /** Opcje dla `type: 'select'` / `'multiselect'`. */
+    options?: KptOption<unknown>[];
+    placeholder?: string;
+    /** Dla `type: 'number'`. */
+    min?: number;
+    max?: number;
+    step?: number;
+}
 interface KptColumn {
     /** Nazwa pola w wierszu. */
     field: string;
@@ -2219,6 +2305,18 @@ interface KptColumn {
     frozen?: boolean;
     /** Filtr kolumny w wierszu nagłówka (input/number/select/zakres dat). */
     filter?: KptColumnFilter;
+    /** Włącza edycję inline (klik w komórkę zamienia wartość na kontrolkę tego typu). */
+    edit?: KptColumnEdit;
+}
+/** Zdarzenie po zatwierdzeniu edycji komórki. */
+interface KptCellEditEvent<T> {
+    /** Wiersz sprzed zmiany. */
+    row: T;
+    field: string;
+    /** Nowa wartość. */
+    value: unknown;
+    /** Wiersz po scaleniu ze zmienioną wartością — gotowe body PUT/PATCH. */
+    updatedRow: T;
 }
 type SortDir = 'asc' | 'desc' | null;
 /** Stan przekazywany w trybie lazy przy każdej zmianie sortowania/filtra/strony. */
@@ -2282,20 +2380,38 @@ declare class KptDataTable<T = Record<string, unknown>> {
     readonly selection: _angular_core.ModelSignal<T[]>;
     /** Rozwinięte wiersze (dwukierunkowo). */
     readonly expandedRows: _angular_core.ModelSignal<T[]>;
+    /**
+     * Pola (`KptColumn.field`) aktualnie ukrytych kolumn (dwukierunkowo). Sam komponent nie
+     * dostarcza UI do zarządzania tym stanem — to hak do podpięcia zewnętrznego przełącznika
+     * kolumn (patrz przykład „Dostosowywanie kolumn" w playground).
+     */
+    readonly hiddenFields: _angular_core.ModelSignal<readonly string[]>;
     readonly rowClick: _angular_core.OutputEmitterRef<T>;
     /** Emitowane w trybie lazy przy zmianie sortowania/filtra/strony. */
     readonly lazyLoad: _angular_core.OutputEmitterRef<KptTableLazyState>;
+    /** Emitowane po zatwierdzeniu edycji komórki (tylko gdy wartość faktycznie się zmieniła). */
+    readonly cellEdit: _angular_core.OutputEmitterRef<KptCellEditEvent<T>>;
     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[]>;
+    /** Kolumny w bieżącej kolejności, bez tych ukrytych przez `hiddenFields` — do renderowania i eksportu. */
+    protected readonly visibleOrderedColumns: _angular_core.Signal<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>;
+    protected readonly editingCell: _angular_core.WritableSignal<{
+        row: T;
+        field: string;
+    } | null>;
+    protected readonly editingValue: _angular_core.WritableSignal<unknown>;
+    /** Czy panel edytora overlayowego (date/select/multiselect) jest otwarty. */
+    protected readonly editorPanelOpen: _angular_core.WritableSignal<boolean>;
+    private readonly editorHost;
     constructor();
     protected onScroll(event: Event): void;
     protected readonly virtualStart: _angular_core.Signal<number>;
@@ -2303,19 +2419,47 @@ declare class KptDataTable<T = Record<string, unknown>> {
     protected readonly virtualRows: _angular_core.Signal<T[]>;
     protected readonly topPad: _angular_core.Signal<number>;
     protected readonly bottomPad: _angular_core.Signal<number>;
-    protected readonly dragIndex: _angular_core.WritableSignal<number | null>;
+    /**
+     * Pole przeciąganej kolumny (nie indeks — przy ukrytych kolumnach `$index` z pętli
+     * `visibleOrderedColumns()` nie odpowiada pozycji w pełnej `orderedColumns()`).
+     */
+    protected readonly dragField: _angular_core.WritableSignal<string | 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ć. */
+    /** Liczba wiodących widocznych kolumn zamrożonych — poza nie wolno upuszczać ani ich przesuwać. */
     private frozenLeadCount;
-    protected onColDragStart(index: number, event: DragEvent): void;
-    protected onColDragOver(index: number, event: DragEvent): void;
-    protected onColDrop(index: number, event: DragEvent): void;
+    protected onColDragStart(field: string, event: DragEvent): void;
+    protected onColDragOver(field: string, event: DragEvent): void;
+    protected onColDrop(field: string, event: DragEvent): void;
     protected onColDragEnd(): void;
     exportCsv(): void;
     private readonly cellDefs;
     private readonly cellMap;
     protected cellTemplate(field: string): TemplateRef<unknown> | null;
+    private readonly cellEditDefs;
+    private readonly cellEditMap;
+    protected cellEditTemplate(field: string): TemplateRef<unknown> | null;
+    protected isEditable(col: KptColumn): boolean;
+    protected isEditingCell(row: T, field: string): boolean;
+    protected startEdit(row: T, col: KptColumn, event: Event): void;
+    /**
+     * Panel edytora zamknięty (wybór, klik poza, Esc) → zatwierdź. Celowo NIE wieszamy tego na
+     * `touch`: ten leci też z blur triggera, czyli już przy naciśnięciu myszy na opcji w panelu —
+     * edytor ginąłby, zanim kliknięcie zdąży wybrać wartość.
+     */
+    protected onEditorPanelToggle(open: boolean): void;
+    /**
+     * Edytory bez overlaya (text/number, własne `kptCellEdit`) zatwierdza dopiero wyjście fokusu
+     * **poza cały edytor**. Nie wystarczy `touch`/blur samej kontrolki: `kpt-input-number` ma
+     * fokusowalne strzałki `+`/`-` obok pola (i dodatkowo emituje `touch` w `step_()`), więc każde
+     * kliknięcie strzałki zamykałoby edycję, zanim zdąży zmienić wartość.
+     */
+    protected onEditorFocusOut(event: FocusEvent): void;
+    /** Zatwierdza bieżącą edycję — emituje `cellEdit` tylko gdy wartość faktycznie się zmieniła. */
+    protected commitEdit(): void;
+    /** Dla własnych szablonów (`kptCellEdit`): ustaw wartość i od razu zatwierdź. */
+    protected readonly commitEditValue: (value: unknown) => void;
+    protected cancelEdit(): void;
     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`. */
@@ -2375,7 +2519,7 @@ declare class KptDataTable<T = Record<string, unknown>> {
     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; }; "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>;
+    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; }; "hiddenFields": { "alias": "hiddenFields"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "expandedRows": "expandedRowsChange"; "hiddenFields": "hiddenFieldsChange"; "rowClick": "rowClick"; "lazyLoad": "lazyLoad"; "cellEdit": "cellEdit"; }, ["cellDefs", "cellEditDefs", "rowDetailDef"], ["[kptPaginatorActions]"], true, never>;
 }
 
 /**
@@ -2397,6 +2541,26 @@ declare class KptCellDef {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptCellDef, "ng-template[kptCell]", never, { "kptCell": { "alias": "kptCell"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Własny szablon edytora komórki dla kolumny `kpt-data-table` (gdy wbudowane typy
+ * `KptColumnEdit.type` nie wystarczają). Kontekst: `$implicit` = bieżąca wartość edycji,
+ * `row` = wiersz, `commit(value)` = zatwierdź wartość i zamknij edytor, `cancel()` = odrzuć.
+ *
+ * @example
+ * <kpt-data-table [columns]="cols" [data]="rows">
+ *   <ng-template kptCellEdit="team" let-value let-commit="commit">
+ *     <my-custom-picker [value]="value" (valueChange)="commit($event)" />
+ *   </ng-template>
+ * </kpt-data-table>
+ */
+declare class KptCellEditDef {
+    /** Nazwa pola kolumny, dla której obowiązuje szablon edytora. */
+    readonly kptCellEdit: _angular_core.InputSignal<string>;
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptCellEditDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptCellEditDef, "ng-template[kptCellEdit]", never, { "kptCellEdit": { "alias": "kptCellEdit"; "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`.
@@ -2942,6 +3106,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; }; }, { "select": "select"; }, 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, 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, KptBadgeVariant, KptBreadcrumbItem, KptBreakpoint, KptButtonSize, KptButtonVariant, KptCardVariant, KptChipVariant, KptColumn, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDividerOrientation, KptDrawerPosition, KptFormFieldControl, KptGalleriaItem, KptI18nConfig, KptIconName, KptInputType, KptLocale, KptMenuItem, KptMessages, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitterOrientation, 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, 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, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDividerOrientation, KptDrawerPosition, KptFormFieldControl, KptGalleriaItem, KptI18nConfig, KptIconName, KptInputType, KptLocale, KptMenuItem, KptMessages, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitterOrientation, KptTableLazyState, KptTimelineItem, KptToast, KptToastOptions, KptTooltipPosition, KptTreeNode };
 //# sourceMappingURL=konce-pt-angular.d.ts.map