@konce-pt/angular 0.11.1 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/CHANGELOG.md +261 -0
  2. package/charts/src/lib/llms.txt +8 -0
  3. package/chat/src/lib/llms.txt +9 -0
  4. package/fesm2022/konce-pt-angular-charts.mjs +141 -60
  5. package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
  6. package/fesm2022/konce-pt-angular-chat.mjs +70 -18
  7. package/fesm2022/konce-pt-angular-chat.mjs.map +1 -1
  8. package/fesm2022/konce-pt-angular-icons.mjs.map +1 -1
  9. package/fesm2022/konce-pt-angular-map.mjs +62 -23
  10. package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
  11. package/fesm2022/konce-pt-angular-roadmap.mjs +103 -17
  12. package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
  13. package/fesm2022/konce-pt-angular.mjs +3613 -2119
  14. package/fesm2022/konce-pt-angular.mjs.map +1 -1
  15. package/map/src/lib/llms.txt +1 -0
  16. package/package.json +11 -11
  17. package/roadmap/src/lib/llms.txt +11 -1
  18. package/src/lib/alert/llms.txt +1 -0
  19. package/src/lib/app-shell/llms.txt +3 -2
  20. package/src/lib/auth/llms.txt +6 -2
  21. package/src/lib/autocomplete/llms.txt +3 -0
  22. package/src/lib/bottom-sheet/llms.txt +3 -0
  23. package/src/lib/breadcrumb/llms.txt +8 -0
  24. package/src/lib/button-group/llms.txt +33 -29
  25. package/src/lib/checkbox/llms.txt +3 -0
  26. package/src/lib/chips-input/llms.txt +3 -0
  27. package/src/lib/color-picker/llms.txt +3 -0
  28. package/src/lib/confirm/llms.txt +6 -0
  29. package/src/lib/context-menu/llms.txt +3 -0
  30. package/src/lib/data-table/llms.txt +22 -10
  31. package/src/lib/date-range/llms.txt +20 -1
  32. package/src/lib/datepicker/llms.txt +21 -4
  33. package/src/lib/dialog/llms.txt +3 -0
  34. package/src/lib/divider/llms.txt +1 -0
  35. package/src/lib/drawer/llms.txt +3 -0
  36. package/src/lib/file-upload/llms.txt +3 -0
  37. package/src/lib/i18n/llms.txt +7 -0
  38. package/src/lib/icon/llms.txt +1 -1
  39. package/src/lib/input-mask/llms.txt +3 -0
  40. package/src/lib/input-number/llms.txt +5 -2
  41. package/src/lib/input-otp/llms.txt +11 -0
  42. package/src/lib/knob/llms.txt +4 -2
  43. package/src/lib/listbox/llms.txt +3 -0
  44. package/src/lib/megamenu/llms.txt +11 -0
  45. package/src/lib/menubar/llms.txt +11 -0
  46. package/src/lib/order-list/llms.txt +3 -0
  47. package/src/lib/password/llms.txt +5 -1
  48. package/src/lib/peek/llms.txt +1 -1
  49. package/src/lib/pick-list/llms.txt +3 -0
  50. package/src/lib/popover/llms.txt +3 -0
  51. package/src/lib/radio-group/llms.txt +3 -0
  52. package/src/lib/rich-text/llms.txt +13 -0
  53. package/src/lib/select/llms.txt +3 -0
  54. package/src/lib/slider/llms.txt +3 -0
  55. package/src/lib/stepper/llms.txt +3 -0
  56. package/src/lib/switch/llms.txt +3 -0
  57. package/src/lib/switch-group/llms.txt +3 -0
  58. package/src/lib/tabs/llms.txt +3 -0
  59. package/src/lib/toast/llms.txt +3 -0
  60. package/src/lib/tooltip/llms.txt +55 -44
  61. package/src/lib/tree/llms.txt +1 -0
  62. package/types/konce-pt-angular-charts.d.ts +11 -0
  63. package/types/konce-pt-angular-charts.d.ts.map +1 -1
  64. package/types/konce-pt-angular-chat.d.ts +16 -1
  65. package/types/konce-pt-angular-chat.d.ts.map +1 -1
  66. package/types/konce-pt-angular-map.d.ts +14 -2
  67. package/types/konce-pt-angular-map.d.ts.map +1 -1
  68. package/types/konce-pt-angular-roadmap.d.ts +26 -1
  69. package/types/konce-pt-angular-roadmap.d.ts.map +1 -1
  70. package/types/konce-pt-angular.d.ts +518 -153
  71. package/types/konce-pt-angular.d.ts.map +1 -1
@@ -1,14 +1,14 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { EnvironmentProviders, Signal, InjectionToken, TemplateRef, ModelSignal, WritableSignal, OnDestroy, ElementRef } from '@angular/core';
2
+ import { EnvironmentProviders, Signal, InjectionToken, TemplateRef, ModelSignal, WritableSignal, ElementRef } from '@angular/core';
3
+ import * as _konce_pt_angular from '@konce-pt/angular';
3
4
  import * as _angular_forms_signals from '@angular/forms/signals';
4
5
  import { FormValueControl, WithOptionalFieldTree, ValidationError, FormCheckboxControl } from '@angular/forms/signals';
5
6
  import { ConnectedPosition } from '@angular/cdk/overlay';
6
- import { KptLocale, KptMessages, DeepPartial, KptI18nConfig } from '@konce-pt/i18n';
7
+ import { KptLocale, KptMessages, DeepPartial, KptMessageKey, KptI18nConfig } from '@konce-pt/i18n';
7
8
  export { DeepPartial, KPT_MESSAGES_EN, KPT_MESSAGES_PL, KptI18nConfig, KptLocale, KptMessages } from '@konce-pt/i18n';
8
9
  import { KptIconInput, KptIconName } from '@konce-pt/icons';
9
10
  export { KptIconDef, KptIconInput, KptIconName, renderKptIconSvg } from '@konce-pt/icons';
10
- import * as _konce_pt_angular from '@konce-pt/angular';
11
- import { KptDateSelectionMode, KptCalendarView, KptDayCell, KptGridCell, KptClockMark, KptDateRangeValue, KptDateRangeMode, KptMonthPanel, KptRangeDayCell } from '@konce-pt/datetime';
11
+ import { KptDateDisplayFormat, KptFirstDayOfWeek, KptDateSelectionMode, KptCalendarView, KptDayCell, KptGridCell, KptClockMark, KptDateRangeValue, KptDateRangeMode, KptMonthPanel, KptRangeDayCell } from '@konce-pt/datetime';
12
12
  export { KptDateRangeValue } from '@konce-pt/datetime';
13
13
  import { KptMentionItem, KptMentionSegment } from '@konce-pt/mention';
14
14
  export { KPT_MENTION_LIMIT, KptMentionItem, KptMentionQuery, KptMentionSegment, applyMention, collectMentions, filterMentions, foldMentionText, mentionQuery, mentionToken, parseMentionText } from '@konce-pt/mention';
@@ -111,12 +111,31 @@ interface KptOption<T = unknown> {
111
111
  /** Nazwa ikony z rejestru. Renderuje ją dziś wyłącznie `kpt-button-group`. */
112
112
  icon?: string;
113
113
  }
114
+ /**
115
+ * Klik w odnośnik komponentu nawigacji (`kpt-breadcrumb`, `kpt-menubar`, `kpt-megamenu`). Linki
116
+ * są zwykłym `<a href>`, więc bez routera klik przeładowuje stronę. Aplikacja z routerem łapie to
117
+ * zdarzenie, woła `event.preventDefault()` i nawiguje sama — biblioteka nie zależy od żadnego routera.
118
+ * Zdarzenie leci tylko dla zwykłego kliku: Ctrl/⌘/Shift/środkowy przycisk i `target="_blank"`
119
+ * zostają natywne (nowa karta, nowe okno).
120
+ */
121
+ interface KptNavigateEvent<T = unknown> {
122
+ /** Pozycja, w którą kliknięto. */
123
+ item: T;
124
+ /** Adres z `href`. */
125
+ url: string;
126
+ /** Oryginalne zdarzenie — `preventDefault()` zatrzymuje przeładowanie strony. */
127
+ event: MouseEvent;
128
+ }
114
129
 
115
130
  /**
116
131
  * Segmentowana grupa przycisków (toggle) — pojedynczy wybór z opcji. Signal Forms.
117
132
  *
118
133
  * Pozycja może mieć ikonę (`KptOption.icon`); `iconOnly` chowa etykietę, ale zostawia ją
119
- * w nazwie dostępnej, więc czytnik ekranu dalej wie, co wybiera.
134
+ * w nazwie dostępnej, więc czytnik ekranu dalej wie, co wybiera, a myszka dostaje `kptTooltip`.
135
+ *
136
+ * Wybór jest wyłączny, więc grupa to `role="radiogroup"` z pozycjami `role="radio"` (APG) —
137
+ * czytnik ogłasza „2 z 3”. Jeden przystanek Tab (wybrana pozycja), strzałki przenoszą wybór,
138
+ * `Home`/`End` na skrajne. W `kpt-form-field` grupa dostaje nazwę z etykiety pola.
120
139
  *
121
140
  * @example
122
141
  * <kpt-button-group [(value)]="view" [options]="[{label:'Lista',value:'list'},{label:'Siatka',value:'grid'}]" />
@@ -128,14 +147,31 @@ declare class KptButtonGroup<T = unknown> implements FormValueControl<T> {
128
147
  readonly value: _angular_core.ModelSignal<T>;
129
148
  readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
130
149
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
150
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — wybór widać, nie da się go zmienić. */
151
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
152
+ /** Pole wymagane — `aria-required` (zasila je `required()` w schemacie). */
153
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
154
+ /** Id grupy; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
155
+ readonly id: _angular_core.InputSignal<string | null>;
156
+ /** Nazwa dostępna grupy, gdy nie opisuje jej etykieta (`kpt-form-field`). */
157
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
131
158
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
132
159
  readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
133
- /** Chowa etykiety — zostaje sama ikona, a `label` zasila `aria-label` i `title`. */
160
+ /** Stan nieprawidłowy pokazujemy dopiero po dotknięciu — jak natywne `:user-invalid`. */
161
+ protected readonly showInvalid: _angular_core.Signal<boolean>;
162
+ /** Grupa nie dostaje nazwy z `label[for]` — stąd `aria-labelledby` na etykietę wrappera. */
163
+ protected readonly field: _konce_pt_angular.KptFieldA11y;
164
+ private readonly disabledMap;
165
+ /** Jedyny przystanek Tab: wybrana pozycja, a bez wyboru pierwsza dozwolona. */
166
+ protected readonly tabStop: _angular_core.Signal<number>;
167
+ /** Chowa etykiety — zostaje sama ikona, a `label` zasila `aria-label` i dymek `kptTooltip`. */
134
168
  readonly iconOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
135
169
  readonly touch: _angular_core.OutputEmitterRef<void>;
136
170
  protected select(opt: KptOption<T>): void;
171
+ /** Strzałki (pion traktowany jak poziom), `Home`/`End`: fokus i wybór idą razem — wzorzec radia. */
172
+ protected onKeydown(event: KeyboardEvent): void;
137
173
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptButtonGroup<any>, never>;
138
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptButtonGroup<any>, "kpt-button-group", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "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; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
174
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptButtonGroup<any>, "kpt-button-group", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
139
175
  }
140
176
 
141
177
  /**
@@ -161,6 +197,7 @@ declare class KptFab {
161
197
  readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
162
198
  /** Id elementu, który FAB rozwija — para dla `ariaExpanded`. */
163
199
  readonly ariaControls: _angular_core.InputSignal<string | null>;
200
+ constructor();
164
201
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptFab, never>;
165
202
  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; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
166
203
  }
@@ -177,8 +214,14 @@ declare class KptFab {
177
214
  * używa port React, więc oba frameworki tłumaczą identycznie.
178
215
  */
179
216
  declare class KptI18n {
180
- /** Rejestr słowników: język → pełny `KptMessages`. */
217
+ /**
218
+ * Rejestr słowników: język → pełny `KptMessages`. Sygnał, nie zwykła `Map`: dociągnięcie
219
+ * tłumaczeń aktywnego języka w trakcie działania (leniwie ładowany JSON) ma przerysować
220
+ * komponenty od razu, a nie dopiero przy następnej zmianie języka.
221
+ */
181
222
  private readonly registry;
223
+ /** Klucze, o których brak już ostrzegaliśmy — jedno ostrzeżenie na klucz. */
224
+ private readonly warnedKeys;
182
225
  private readonly _locale;
183
226
  /** Bieżący język (tylko do odczytu). */
184
227
  readonly locale: _angular_core.Signal<KptLocale>;
@@ -194,9 +237,11 @@ declare class KptI18n {
194
237
  registerMessages(locale: KptLocale, patch: DeepPartial<KptMessages>): void;
195
238
  /**
196
239
  * Tłumaczy klucz w notacji kropkowej (np. `'paginator.range'`), z opcjonalną
197
- * interpolacją `{name}`. Brakujący klucz spada na EN, a w ostateczności zwraca sam klucz.
240
+ * interpolacją `{name}`. Brakujący klucz spada na EN, a w ostateczności zwraca sam klucz —
241
+ * w trybie deweloperskim z jednym ostrzeżeniem w konsoli, żeby literówka nie przeszła po cichu.
242
+ * `KptMessageKey` daje podpowiedzi kluczy bazowych; dowolny napis nadal przechodzi.
198
243
  */
199
- t(key: string, params?: Record<string, string | number>): string;
244
+ t(key: KptMessageKey | (string & {}), params?: Record<string, string | number>): string;
200
245
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptI18n, never>;
201
246
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<KptI18n>;
202
247
  }
@@ -807,12 +852,17 @@ type KptInputType = 'text' | 'email' | 'password' | 'number' | 'search' | 'tel'
807
852
  declare class KptInput implements FormValueControl<string> {
808
853
  /** Wartość pola (wymagane przez kontrakt FormValueControl). */
809
854
  readonly value: _angular_core.ModelSignal<string>;
810
- readonly disabled: _angular_core.InputSignal<boolean>;
811
- readonly readonly: _angular_core.InputSignal<boolean>;
812
- readonly required: _angular_core.InputSignal<boolean>;
813
- readonly invalid: _angular_core.InputSignal<boolean>;
855
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
856
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
857
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
858
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
859
+ /**
860
+ * Błędy walidacji z `FormField`. Kontrolka ich nie wyświetla — komunikat pokazuje `kpt-form-field`
861
+ * (`[error]`) i podpina go do `aria-describedby` pola; wejście istnieje, żeby dyrektywa mogła je
862
+ * przekazać bez błędu wiązania.
863
+ */
814
864
  readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
815
- readonly touched: _angular_core.InputSignal<boolean>;
865
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
816
866
  /** Stan nieprawidłowy pokazujemy dopiero po dotknięciu pola — jak natywne `:user-invalid`. */
817
867
  protected readonly showInvalid: _angular_core.Signal<boolean>;
818
868
  /** Emitowane na `blur` — oznacza pole jako dotknięte. */
@@ -844,6 +894,11 @@ declare class KptCheckbox implements FormCheckboxControl {
844
894
  readonly indeterminate: _angular_core.ModelSignal<boolean>;
845
895
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
846
896
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
897
+ /**
898
+ * Tylko do odczytu (także z `readonly()` w schemacie Signal Forms) — stan widać i da się na nim
899
+ * stanąć fokusem, ale nie zmienić (`aria-readonly`).
900
+ */
901
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
847
902
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
848
903
  readonly id: _angular_core.InputSignal<string | null>;
849
904
  /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `kpt-form-field`). */
@@ -858,7 +913,7 @@ declare class KptCheckbox implements FormCheckboxControl {
858
913
  readonly label: _angular_core.InputSignal<string>;
859
914
  protected onChange(checked: boolean): void;
860
915
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptCheckbox, never>;
861
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptCheckbox, "kpt-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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"; "indeterminate": "indeterminateChange"; "touch": "touch"; }, never, ["*"], true, never>;
916
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptCheckbox, "kpt-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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"; "indeterminate": "indeterminateChange"; "touch": "touch"; }, never, ["*"], true, never>;
862
917
  }
863
918
 
864
919
  /**
@@ -872,6 +927,13 @@ declare class KptCheckbox implements FormCheckboxControl {
872
927
  declare class KptSwitch implements FormCheckboxControl {
873
928
  readonly checked: _angular_core.ModelSignal<boolean>;
874
929
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
930
+ /**
931
+ * Tylko do odczytu (także z `readonly()` w schemacie Signal Forms) — stan widać i da się na nim
932
+ * stanąć fokusem, ale nie zmienić (`aria-readonly`).
933
+ */
934
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
935
+ /** Pole wymagane — `aria-required` (zasila je `required()` w schemacie). */
936
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
875
937
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
876
938
  readonly id: _angular_core.InputSignal<string | null>;
877
939
  /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `kpt-form-field`). */
@@ -893,7 +955,7 @@ declare class KptSwitch implements FormCheckboxControl {
893
955
  /** Tekst zależny od stanu przełącznika. */
894
956
  protected readonly stateLabel: _angular_core.Signal<string>;
895
957
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSwitch, never>;
896
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSwitch, "kpt-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
958
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSwitch, "kpt-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
897
959
  }
898
960
 
899
961
  /**
@@ -910,6 +972,8 @@ declare class KptSwitchGroup<T = unknown> implements FormValueControl<unknown> {
910
972
  readonly value: _angular_core.ModelSignal<unknown>;
911
973
  readonly options: _angular_core.InputSignal<readonly KptOption<T>[]>;
912
974
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
975
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — przełączniki widać, nie da się ich zmienić. */
976
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
913
977
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
914
978
  readonly id: _angular_core.InputSignal<string | null>;
915
979
  /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `kpt-form-field`). */
@@ -930,12 +994,13 @@ declare class KptSwitchGroup<T = unknown> implements FormValueControl<unknown> {
930
994
  * w trybie `multiple` odznaczanie jest zawsze dozwolone. Domyślnie tak.
931
995
  */
932
996
  readonly allowDeselect: _angular_core.InputSignalWithTransform<boolean, unknown>;
997
+ private readonly switches;
933
998
  /** Aktualna wartość jako tablica (tryb multiple) — normalizuje `null`/pojedynczą wartość. */
934
999
  private readonly selectedValues;
935
1000
  protected isChecked(optValue: T): boolean;
936
1001
  protected onToggle(opt: KptOption<T>, checked: boolean): void;
937
1002
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSwitchGroup<any>, never>;
938
- 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; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
1003
+ 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; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
939
1004
  }
940
1005
 
941
1006
  /**
@@ -947,6 +1012,11 @@ declare class KptRadioGroup<T = unknown> implements FormValueControl<T> {
947
1012
  readonly options: _angular_core.InputSignal<readonly KptOption<T>[]>;
948
1013
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
949
1014
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1015
+ /**
1016
+ * Tylko do odczytu (także z `readonly()` w schemacie Signal Forms) — stan widać i da się na nim
1017
+ * stanąć fokusem, ale nie zmienić (`aria-readonly`).
1018
+ */
1019
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
950
1020
  /** Układ opcji: pod sobą (domyślnie) albo w rzędzie, z zawijaniem. */
951
1021
  readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
952
1022
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
@@ -960,9 +1030,11 @@ declare class KptRadioGroup<T = unknown> implements FormValueControl<T> {
960
1030
  readonly touch: _angular_core.OutputEmitterRef<void>;
961
1031
  /** Grupa nie dostaje nazwy z `label[for]` — stąd `aria-labelledby` na etykietę wrappera. */
962
1032
  protected readonly field: _konce_pt_angular.KptFieldA11y;
1033
+ /** W trybie tylko do odczytu strzałki nie przestawiają wyboru (natywnie przenoszą zaznaczenie). */
1034
+ protected onKeydown(event: KeyboardEvent): void;
963
1035
  readonly name: _angular_core.InputSignal<string>;
964
1036
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptRadioGroup<any>, never>;
965
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptRadioGroup<any>, "kpt-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
1037
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptRadioGroup<any>, "kpt-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
966
1038
  }
967
1039
 
968
1040
  /**
@@ -994,6 +1066,8 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown>, KptFo
994
1066
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
995
1067
  readonly id: _angular_core.InputSignal<string | null>;
996
1068
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1069
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — wybór widać, panel się nie otwiera. */
1070
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
997
1071
  /** Stan nieprawidłowy pokazujemy dopiero po dotknięciu pola — jak natywne `:user-invalid`. */
998
1072
  protected readonly showInvalid: _angular_core.Signal<boolean>;
999
1073
  /** Wartość: pojedyncza (T) lub tablica (T[]) w trybie multiple. */
@@ -1015,6 +1089,7 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown>, KptFo
1015
1089
  private readonly searchEl;
1016
1090
  private readonly injector;
1017
1091
  private readonly typeahead;
1092
+ protected readonly panelMinWidth: _angular_core.WritableSignal<number>;
1018
1093
  protected readonly positions: ConnectedPosition[];
1019
1094
  constructor();
1020
1095
  protected optionId(i: number): string;
@@ -1043,7 +1118,7 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown>, KptFo
1043
1118
  protected onKeydown(event: KeyboardEvent, source: 'trigger' | 'search'): void;
1044
1119
  private jumpTo;
1045
1120
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSelect<any>, never>;
1046
- 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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "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>;
1121
+ 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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "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>;
1047
1122
  }
1048
1123
 
1049
1124
  /**
@@ -1070,6 +1145,11 @@ type KptDatepickerView = KptCalendarView;
1070
1145
  * w panelu, `Escape` zamyka go, a wybór i zamknięcie oddają fokus polu. `Delete`/`Backspace` na polu
1071
1146
  * czyści wartość.
1072
1147
  *
1148
+ * Pole to `role="combobox"` z `aria-haspopup="dialog"` (wzorzec APG „select-only combobox”), więc
1149
+ * niesie `aria-required`, `aria-readonly` i `aria-invalid` — rola `button` żadnego z nich nie zna.
1150
+ * Tydzień zaczyna się wg języka `KptI18n` (en-US: niedziela), chyba że podano `firstDayOfWeek`.
1151
+ * Przewinięcie miesiąca strzałką ‹ › jest ogłaszane uprzejmie.
1152
+ *
1073
1153
  * @example
1074
1154
  * <kpt-datepicker [formField]="f.birthDate" startView="decade" minDate="1900-01-01" />
1075
1155
  * <kpt-datepicker selectionMode="datetime" [hourFormat]="12" [(value)]="meetingAt" />
@@ -1078,6 +1158,10 @@ type KptDatepickerView = KptCalendarView;
1078
1158
  declare class KptDatepicker implements FormValueControl<string> {
1079
1159
  readonly value: _angular_core.ModelSignal<string>;
1080
1160
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1161
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — wartość widać, panel się nie otwiera. */
1162
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1163
+ /** Pole wymagane — `aria-required` (zasila je `required()` w schemacie). */
1164
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1081
1165
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1082
1166
  readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1083
1167
  /** Stan nieprawidłowy pokazujemy dopiero po dotknięciu pola — jak natywne `:user-invalid`. */
@@ -1090,7 +1174,14 @@ declare class KptDatepicker implements FormValueControl<string> {
1090
1174
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1091
1175
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
1092
1176
  readonly id: _angular_core.InputSignal<string | null>;
1093
- readonly displayFormat: _angular_core.InputSignal<"pl" | "iso">;
1177
+ /**
1178
+ * Zapis daty w polu: `'pl'` (DD.MM.RRRR, domyślnie), `'iso'` (RRRR-MM-DD) albo `'locale'` —
1179
+ * kolejność i separatory z `Intl` dla języka `KptI18n` (en-US: MM/DD/YYYY). Placeholder idzie
1180
+ * za formatem, a jego litery za językiem (EN `YYYY`, PL `RRRR`).
1181
+ */
1182
+ readonly displayFormat: _angular_core.InputSignal<KptDateDisplayFormat>;
1183
+ /** Pierwszy dzień tygodnia (1 = poniedziałek … 7 = niedziela); `null` = wg języka `KptI18n`. */
1184
+ readonly firstDayOfWeek: _angular_core.InputSignal<KptFirstDayOfWeek | null>;
1094
1185
  /** Granulacja wyboru. */
1095
1186
  readonly selectionMode: _angular_core.InputSignal<KptDateSelectionMode>;
1096
1187
  /**
@@ -1108,17 +1199,25 @@ declare class KptDatepicker implements FormValueControl<string> {
1108
1199
  readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
1109
1200
  readonly minDate: _angular_core.InputSignal<string | null>;
1110
1201
  readonly maxDate: _angular_core.InputSignal<string | null>;
1202
+ /** Litery placeholdera w języku interfejsu. */
1203
+ private readonly tokens;
1111
1204
  protected readonly effectivePlaceholder: _angular_core.Signal<string>;
1112
1205
  protected readonly i18n: KptI18n;
1206
+ /** Początek tygodnia: jawny albo z języka interfejsu. */
1207
+ private readonly firstDay;
1113
1208
  protected readonly weekdays: _angular_core.Signal<string[]>;
1209
+ private readonly periods;
1114
1210
  private readonly months;
1115
1211
  /**
1116
1212
  * Stan kalendarza (dwukierunkowy). Pozwala otworzyć go z zewnątrz i — co ważniejsze — wiedzieć,
1117
1213
  * kiedy user skończył wybierać. `touch` się do tego nie nadaje: leci też z blur triggera.
1118
1214
  */
1119
1215
  readonly open: _angular_core.ModelSignal<boolean>;
1120
- private readonly today;
1121
- private readonly todayIso;
1216
+ /** „Dziś” liczone przy każdym otwarciu — panel otwarty po północy nie pokazuje wczorajszego dnia. */
1217
+ private today;
1218
+ private todayIso;
1219
+ /** Ogłoszenie strony kalendarza po przewinięciu strzałką ‹ › (APG: `aria-live` na nagłówku). */
1220
+ protected readonly pageAnnouncement: _angular_core.WritableSignal<string>;
1122
1221
  private readonly uid;
1123
1222
  protected readonly panelId: string;
1124
1223
  private readonly triggerEl;
@@ -1160,7 +1259,14 @@ declare class KptDatepicker implements FormValueControl<string> {
1160
1259
  private closeAndFocus;
1161
1260
  protected readonly viewYear: _angular_core.Signal<number>;
1162
1261
  protected readonly monthName: _angular_core.Signal<string>;
1262
+ /**
1263
+ * Nazwy przycisków tytułu zaczynają się od widocznego tekstu (WCAG 2.5.3 Label in Name):
1264
+ * „Październik, Wybierz miesiąc”, a nie samo „Wybierz miesiąc” nad napisem „Październik”.
1265
+ */
1266
+ protected readonly monthTitleLabel: _angular_core.Signal<string>;
1267
+ protected readonly yearTitleLabel: _angular_core.Signal<string>;
1163
1268
  protected readonly yearRangeLabel: _angular_core.Signal<string>;
1269
+ protected readonly decadeTitleLabel: _angular_core.Signal<string>;
1164
1270
  protected readonly decadeRangeLabel: _angular_core.Signal<string>;
1165
1271
  /** Tryb 'month' nie ma po czym nawigować — siatka miesięcy jest kompletna. */
1166
1272
  protected readonly hasNav: _angular_core.Signal<boolean>;
@@ -1177,11 +1283,9 @@ declare class KptDatepicker implements FormValueControl<string> {
1177
1283
  * trybu daje pusty string (trigger nie pokazuje śmieci, np. po ręcznej podmianie modelu).
1178
1284
  */
1179
1285
  protected readonly display: _angular_core.Signal<string>;
1180
- private displayMonthYear;
1181
1286
  private displayMonth;
1182
1287
  private displayTime;
1183
1288
  private displayDateTime;
1184
- private displayDate;
1185
1289
  private readonly selectedDateIso;
1186
1290
  protected readonly weeks: _angular_core.Signal<KptDayCell[][]>;
1187
1291
  /** Rok/miesiąc bieżącej wartości — zaznaczenie w siatkach wyższych poziomów. */
@@ -1208,17 +1312,24 @@ declare class KptDatepicker implements FormValueControl<string> {
1208
1312
  protected commit(): void;
1209
1313
  /** Strzałki ‹ › — krok zależny od poziomu (miesiąc, rok, dekada, strona dekad). */
1210
1314
  private page;
1315
+ /** Tytuł bieżącej strony panelu do ogłoszenia — miesiąc z rokiem, rok albo zakres lat. */
1316
+ private pageTitle;
1211
1317
  protected pagePrev(): void;
1212
1318
  protected pageNext(): void;
1213
1319
  protected clear(event: Event): void;
1214
1320
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDatepicker, never>;
1215
- 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; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "displayFormat": { "alias": "displayFormat"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "startView": { "alias": "startView"; "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>;
1321
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDatepicker, "kpt-datepicker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "displayFormat": { "alias": "displayFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "startView": { "alias": "startView"; "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>;
1216
1322
  }
1217
1323
 
1218
1324
  /**
1219
1325
  * Tarcza zegara (wybór godziny) — dwa etapy: godziny → minuty, klik lub przeciąganie.
1220
- * Format 12/24h (`hourFormat`); w 24h dodatkowy wewnętrzny pierścień 13–00, w 12h AM/PM.
1221
- * Wartość `HH:mm` (zawsze 24h). Używana przez `kpt-datepicker` i `kpt-date-range`.
1326
+ * Format 12/24h (`hourFormat`); w 24h dodatkowy wewnętrzny pierścień 13–00, w 12h AM/PM
1327
+ * (etykiety pory dnia z `Intl` w języku `KptI18n`). Wartość `HH:mm` (zawsze 24h).
1328
+ * Używana przez `kpt-datepicker` i `kpt-date-range`.
1329
+ *
1330
+ * Klawiatura: segmenty godzin i minut to `role="spinbutton"` — `↑`/`↓` o jeden krok (minuty
1331
+ * o `minuteStep`), `PageUp`/`PageDown` o pięć, `Home`/`End` do granic. Tak da się ustawić każdą
1332
+ * minutę, także spoza znaczników tarczy co pięć.
1222
1333
  *
1223
1334
  * @example
1224
1335
  * <kpt-clock [(value)]="time" [hourFormat]="12" [minuteStep]="5" />
@@ -1227,14 +1338,21 @@ declare class KptClock {
1227
1338
  readonly value: _angular_core.ModelSignal<string>;
1228
1339
  readonly hourFormat: _angular_core.InputSignalWithTransform<number, unknown>;
1229
1340
  readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
1341
+ protected readonly i18n: KptI18n;
1230
1342
  protected readonly hour: _angular_core.WritableSignal<number>;
1231
1343
  protected readonly minute: _angular_core.WritableSignal<number>;
1232
1344
  protected readonly clockPhase: _angular_core.WritableSignal<"hours" | "minutes">;
1233
- constructor();
1234
1345
  private emit;
1346
+ /** Etykiety pory dnia w języku interfejsu (`Intl`), nie zaszyte „AM”/„PM”. */
1347
+ protected readonly periods: _angular_core.Signal<{
1348
+ am: string;
1349
+ pm: string;
1350
+ }>;
1235
1351
  protected readonly ampm: _angular_core.Signal<"AM" | "PM">;
1236
1352
  protected readonly hour12: _angular_core.Signal<number>;
1237
1353
  protected readonly hourLabel: _angular_core.Signal<string>;
1354
+ /** W 12h czytnik słyszy godzinę z porą dnia („9 PM”), nie samą liczbę 21. */
1355
+ protected readonly hourText: _angular_core.Signal<string>;
1238
1356
  protected readonly minuteLabel: _angular_core.Signal<string>;
1239
1357
  /** Znaczniki tarczy — jeden pierścień w 12h, dwa w 24h (patrz `@konce-pt/datetime`). */
1240
1358
  protected readonly hourMarks: _angular_core.Signal<KptClockMark[]>;
@@ -1245,6 +1363,8 @@ declare class KptClock {
1245
1363
  protected setAmpm(target: 'AM' | 'PM'): void;
1246
1364
  protected pickHour(mark: KptClockMark): void;
1247
1365
  protected pickMinute(mark: KptClockMark): void;
1366
+ /** Strzałki, PageUp/PageDown i Home/End na segmencie godzin albo minut. */
1367
+ protected onSegmentKey(part: 'hours' | 'minutes', event: KeyboardEvent): void;
1248
1368
  protected onDialPointer(event: PointerEvent, face: HTMLElement): void;
1249
1369
  protected onDialUp(): void;
1250
1370
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptClock, never>;
@@ -1355,6 +1475,10 @@ declare class KptRichText implements FormValueControl<string> {
1355
1475
  /** Maksymalna głębokość zagnieżdżenia list (Tab / „Dodaj wcięcie"). */
1356
1476
  readonly maxListLevel: _angular_core.InputSignalWithTransform<number, unknown>;
1357
1477
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1478
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — treść da się zaznaczyć i skopiować, nie edytować. */
1479
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1480
+ /** Edycja zablokowana: wyłączone pole albo tylko do odczytu — narzędzia i skróty nie działają. */
1481
+ protected readonly locked: _angular_core.Signal<boolean>;
1358
1482
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1359
1483
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
1360
1484
  readonly id: _angular_core.InputSignal<string | null>;
@@ -1438,6 +1562,9 @@ declare class KptRichText implements FormValueControl<string> {
1438
1562
  protected readonly sourceView: _angular_core.WritableSignal<boolean>;
1439
1563
  protected readonly styleOpen: _angular_core.WritableSignal<boolean>;
1440
1564
  protected readonly tableOpen: _angular_core.WritableSignal<boolean>;
1565
+ /** Aktywna opcja listy stylów (aria-activedescendant). */
1566
+ protected readonly styleActive: _angular_core.WritableSignal<number>;
1567
+ private readonly host;
1441
1568
  protected readonly gridR: _angular_core.WritableSignal<number>;
1442
1569
  protected readonly gridC: _angular_core.WritableSignal<number>;
1443
1570
  protected readonly gridRows: number[];
@@ -1446,6 +1573,8 @@ declare class KptRichText implements FormValueControl<string> {
1446
1573
  protected readonly linkOpen: _angular_core.WritableSignal<boolean>;
1447
1574
  protected readonly linkDraft: _angular_core.WritableSignal<string>;
1448
1575
  protected readonly linkInputId: _angular_core.Signal<string>;
1576
+ protected readonly gridLabelId: _angular_core.Signal<string>;
1577
+ protected styleOptionId(index: number): string;
1449
1578
  protected readonly menuPoint: _angular_core.WritableSignal<{
1450
1579
  x: number;
1451
1580
  y: number;
@@ -1536,12 +1665,23 @@ declare class KptRichText implements FormValueControl<string> {
1536
1665
  /** Przeskok do sąsiedniej komórki z zaznaczeniem jej treści; `false` = koniec tabeli. */
1537
1666
  private moveCell;
1538
1667
  protected openStyle(): void;
1668
+ /**
1669
+ * Panel narzędzia jest w kontenerze nakładek na końcu `<body>` — bez przeniesienia fokusu Tab
1670
+ * musiałby przejść przez całą stronę, żeby do niego dojść (WCAG 2.1.1).
1671
+ */
1672
+ protected focusPanel(selector: string): void;
1673
+ /** Powrót fokusu na przycisk narzędzia po zamknięciu jego panelu z klawiatury. */
1674
+ private focusTool;
1675
+ /** Lista stylów: strzałki, Home/End, Enter/Spacja wybiera, Escape i Tab zamykają. */
1676
+ protected onStyleKeydown(event: KeyboardEvent): void;
1539
1677
  protected closeStyle(): void;
1540
1678
  protected pickStyle(tag: string): void;
1541
1679
  protected openColor(kind: 'foreColor' | 'backColor'): void;
1542
1680
  protected closeColor(): void;
1543
1681
  protected applyColor(color: string): void;
1544
1682
  protected onColorInput(event: Event): void;
1683
+ /** Paleta: strzałki po próbkach, Tab krąży w panelu, Escape zamyka i oddaje fokus narzędziu. */
1684
+ protected onPaletteKeydown(event: KeyboardEvent): void;
1545
1685
  /** Kopiowanie przez async Clipboard API (jak wklejanie); fallback na starą komendę. */
1546
1686
  private copySelection;
1547
1687
  private pasteRich;
@@ -1550,6 +1690,10 @@ declare class KptRichText implements FormValueControl<string> {
1550
1690
  protected onPaste(event: ClipboardEvent): void;
1551
1691
  protected closeTable(): void;
1552
1692
  protected gridHover(r: number, c: number): void;
1693
+ /** Otwarcie siatki: fokus na siatkę i rozmiar 1 × 1, żeby strzałki miały od czego zacząć. */
1694
+ protected onGridAttach(): void;
1695
+ /** Siatka tabeli z klawiatury: strzałki zmieniają rozmiar (1–8), Enter wstawia, Escape wraca. */
1696
+ protected onGridKeydown(event: KeyboardEvent): void;
1553
1697
  protected insertTable(rows: number, cols: number): void;
1554
1698
  protected onContextMenu(event: MouseEvent): void;
1555
1699
  protected closeMenu(): void;
@@ -1605,11 +1749,6 @@ declare class KptRichText implements FormValueControl<string> {
1605
1749
  private cellBeforeGridCol;
1606
1750
  protected canMerge(): boolean;
1607
1751
  protected canSplit(): boolean;
1608
- /**
1609
- * Waliduje URL z narzędzia „link" (blocklista jest obchodzalna, np. `javascript:`).
1610
- * Brak schematu → dopisz `https://` (spójne z zachowaniem `normalizeUrl` w mapie); `#`/`/`
1611
- * przechodzą bez zmian; schemat spoza `SAFE_URL_SCHEME` → `null` (link nie zostaje wstawiony).
1612
- */
1613
1752
  /**
1614
1753
  * Sprawdza, czy kursor stoi w zapytaniu `@…`, i ustawia listę podpowiedzi.
1615
1754
  *
@@ -1633,15 +1772,8 @@ declare class KptRichText implements FormValueControl<string> {
1633
1772
  */
1634
1773
  protected insertMention(item: KptMentionItem): void;
1635
1774
  protected closeMention(): void;
1636
- private sanitizeUrl;
1637
- private sanitizeHtml;
1638
- /** Tag spoza allowlisty rozwijamy do dzieci; atrybuty czyścimy po kolei. */
1639
- private sanitizeElement;
1640
- private sanitizeAttribute;
1641
- /** Deklaracje `style` z allowlisty; `null`, gdy nie zostaje nic. */
1642
- private sanitizeStyleAttr;
1643
1775
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptRichText, never>;
1644
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptRichText, "kpt-rich-text", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "maxListLevel": { "alias": "maxListLevel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "mentions": { "alias": "mentions"; "required": false; "isSignal": true; }; "mentionLimit": { "alias": "mentionLimit"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "mentioned": "mentioned"; }, never, never, true, never>;
1776
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptRichText, "kpt-rich-text", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "maxListLevel": { "alias": "maxListLevel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "mentions": { "alias": "mentions"; "required": false; "isSignal": true; }; "mentionLimit": { "alias": "mentionLimit"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "mentioned": "mentioned"; }, never, never, true, never>;
1645
1777
  }
1646
1778
 
1647
1779
  /** Wartość suwaka: pojedyncza liczba lub para `[min, max]` w trybie `range`. */
@@ -1670,6 +1802,11 @@ declare class KptSlider implements FormValueControl<KptSliderValue> {
1670
1802
  /** Jednostka za liczbą („ zł”, „%”, „ km”) — w pokazanej wartości i w `aria-valuetext`. */
1671
1803
  readonly suffix: _angular_core.InputSignal<string>;
1672
1804
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1805
+ /**
1806
+ * Tylko do odczytu (także z `readonly()` w schemacie Signal Forms) — stan widać i da się na nim
1807
+ * stanąć fokusem, ale nie zmienić (`aria-readonly`).
1808
+ */
1809
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1673
1810
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
1674
1811
  readonly id: _angular_core.InputSignal<string | null>;
1675
1812
  /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `kpt-form-field`). */
@@ -1693,13 +1830,20 @@ declare class KptSlider implements FormValueControl<KptSliderValue> {
1693
1830
  protected readonly single: _angular_core.Signal<number>;
1694
1831
  protected readonly low: _angular_core.Signal<number>;
1695
1832
  protected readonly high: _angular_core.Signal<number>;
1696
- protected setLow(v: number): void;
1697
- protected setHigh(v: number): void;
1833
+ /**
1834
+ * Uchwyty zakresu nie mogą się minąć. Model dostaje wartość przyciętą, ale natywny suwak zostałby
1835
+ * na tej nieprzyciętej: `[value]` się nie zmienia (przycięta = poprzednia), więc Angular nie
1836
+ * nadpisze DOM-u — uchwyt jechałby dalej, a pasek stał. Stąd ręczny zapis `el.value`.
1837
+ * W trybie tylko do odczytu ten sam zapis cofa ruch.
1838
+ */
1839
+ protected onLow(el: HTMLInputElement): void;
1840
+ protected onHigh(el: HTMLInputElement): void;
1841
+ protected onSingle(el: HTMLInputElement): void;
1698
1842
  private pct;
1699
1843
  protected readonly lowPct: _angular_core.Signal<number>;
1700
1844
  protected readonly highPct: _angular_core.Signal<number>;
1701
1845
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSlider, never>;
1702
- 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; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
1846
+ 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; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
1703
1847
  }
1704
1848
 
1705
1849
  /** Wypełnienie jednej gwiazdki. */
@@ -1785,6 +1929,12 @@ declare class KptFileUpload implements FormValueControl<File[]> {
1785
1929
  readonly accept: _angular_core.InputSignal<string>;
1786
1930
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
1787
1931
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1932
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — listę plików widać, nie da się jej zmienić. */
1933
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1934
+ /** Id strefy; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
1935
+ readonly id: _angular_core.InputSignal<string | null>;
1936
+ /** Nazwa dostępna, gdy strefy nie opisuje etykieta (`kpt-form-field`). */
1937
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
1788
1938
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1789
1939
  readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1790
1940
  readonly touch: _angular_core.OutputEmitterRef<void>;
@@ -1793,6 +1943,10 @@ declare class KptFileUpload implements FormValueControl<File[]> {
1793
1943
  /** Błąd pokazujemy po dotknięciu — bramka żyje w prezentacji, nie w walidatorze. */
1794
1944
  protected readonly showError: _angular_core.Signal<boolean>;
1795
1945
  protected readonly iconOf: typeof fileIcon;
1946
+ /** `div` z rolą nie dostaje nazwy z `label[for]` — stąd `aria-labelledby` na etykietę wrappera. */
1947
+ protected readonly field: _konce_pt_angular.KptFieldA11y;
1948
+ /** Podpowiedź rozcięta w miejscu `{action}` — pogrubienie robi szablon, nie HTML ze słownika. */
1949
+ protected readonly hint: _angular_core.Signal<readonly [string, string]>;
1796
1950
  protected open(input: HTMLInputElement): void;
1797
1951
  /** `Enter` / spacja na strefie — spacja bez `preventDefault` przewinęłaby stronę. */
1798
1952
  protected onKey(event: Event, input: HTMLInputElement): void;
@@ -1800,10 +1954,11 @@ declare class KptFileUpload implements FormValueControl<File[]> {
1800
1954
  protected onDragOver(event: DragEvent): void;
1801
1955
  protected onDrop(event: DragEvent): void;
1802
1956
  private addFiles;
1803
- protected remove(file: File, event: Event): void;
1957
+ /** Przycisk znika razem z pozycją — fokus wraca na strefę, a nie spada na `<body>`. */
1958
+ protected remove(file: File, event: Event, zone: HTMLElement): void;
1804
1959
  protected size(file: File): string;
1805
1960
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptFileUpload, never>;
1806
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFileUpload, "kpt-file-upload", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "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>;
1961
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFileUpload, "kpt-file-upload", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
1807
1962
  }
1808
1963
 
1809
1964
  /** Gotowy kolor z nazwą — nazwa trafia do `aria-label` próbki. */
@@ -1825,6 +1980,10 @@ declare class KptColorPicker implements FormValueControl<string> {
1825
1980
  */
1826
1981
  readonly presets: _angular_core.InputSignal<readonly (string | KptColorPreset)[]>;
1827
1982
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1983
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — kolor widać, nie da się go zmienić. */
1984
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1985
+ /** Pole wymagane — `aria-required` na polu kodu (zasila je `required()` w schemacie). */
1986
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1828
1987
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
1829
1988
  readonly id: _angular_core.InputSignal<string | null>;
1830
1989
  /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `kpt-form-field`). */
@@ -1836,7 +1995,11 @@ declare class KptColorPicker implements FormValueControl<string> {
1836
1995
  readonly touch: _angular_core.OutputEmitterRef<void>;
1837
1996
  protected readonly i18n: KptI18n;
1838
1997
  protected readonly field: _konce_pt_angular.KptFieldA11y;
1839
- /** Tekst w polu hex, dopóki nie jest poprawnym kodem — wartość zmienia się dopiero na `#rrggbb`. */
1998
+ /**
1999
+ * Tekst w polu hex dokładnie tak, jak go wpisano, do wyjścia z pola. Wartość zmienia się, gdy tekst
2000
+ * staje się poprawnym kodem, ale pole nie jest przepisywane w trakcie pisania (doklejenie `#`
2001
+ * przenosiło kursor na koniec przy edycji w środku).
2002
+ */
1840
2003
  protected readonly hexDraft: _angular_core.WritableSignal<string | null>;
1841
2004
  protected readonly hexInvalid: _angular_core.Signal<boolean>;
1842
2005
  protected readonly presetList: _angular_core.Signal<{
@@ -1844,12 +2007,14 @@ declare class KptColorPicker implements FormValueControl<string> {
1844
2007
  label: string;
1845
2008
  }[]>;
1846
2009
  protected isActive(color: string): boolean;
2010
+ /** Wybór presetem albo próbnikiem to też dotknięcie pola — inaczej błąd walidacji nigdy by się nie pokazał. */
1847
2011
  protected pickPreset(color: string): void;
2012
+ protected onPicker(el: HTMLInputElement): void;
1848
2013
  protected onHex(event: Event): void;
1849
- /** Wyjście z pola z niepełnym kodem zostawia go widocznym i oznaczonym `aria-invalid`. */
2014
+ /** Wyjście z pola: poprawny albo pusty kod chowa szkic, niepełny zostaje widoczny z `aria-invalid`. */
1850
2015
  protected onHexBlur(): void;
1851
2016
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptColorPicker, never>;
1852
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptColorPicker, "kpt-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2017
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptColorPicker, "kpt-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
1853
2018
  }
1854
2019
 
1855
2020
  /**
@@ -1863,7 +2028,10 @@ declare class KptColorPicker implements FormValueControl<string> {
1863
2028
  * Klawiatura jak w `kpt-datepicker`: `Enter`/`Spacja`/`↓` otwierają panel z fokusem na początku
1864
2029
  * zakresu (albo dziś), strzałki, `Home`/`End` i `PageUp`/`PageDown` (z `Shift` — rok) chodzą po
1865
2030
  * dniach przez wszystkie panele, `Tab` krąży w panelu, `Escape` i wybór końca oddają fokus polu.
1866
- * Krańce i środek zakresu są w nazwie dnia („…, początek zakresu”), a wybór ogłasza region `polite`.
2031
+ * Krańce i środek zakresu są w nazwie dnia („…, początek zakresu”), a wybór i przewinięcie miesiąca
2032
+ * ogłasza region `polite`. Pole to `role="combobox"` z `aria-haspopup="dialog"`, więc niesie
2033
+ * `aria-required`, `aria-readonly` i `aria-invalid`. Tydzień zaczyna się wg języka `KptI18n`,
2034
+ * chyba że podano `firstDayOfWeek`.
1867
2035
  *
1868
2036
  * @example
1869
2037
  * <kpt-date-range [formField]="f.period" />
@@ -1874,6 +2042,10 @@ declare class KptColorPicker implements FormValueControl<string> {
1874
2042
  declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
1875
2043
  readonly value: _angular_core.ModelSignal<KptDateRangeValue>;
1876
2044
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2045
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — wartość widać, panel się nie otwiera. */
2046
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2047
+ /** Pole wymagane — `aria-required` (zasila je `required()` w schemacie). */
2048
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1877
2049
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1878
2050
  readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1879
2051
  /** Stan nieprawidłowy pokazujemy dopiero po dotknięciu pola — jak natywne `:user-invalid`. */
@@ -1883,7 +2055,10 @@ declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
1883
2055
  protected readonly field: _konce_pt_angular.KptFieldA11y;
1884
2056
  /** Placeholder; bez wartości używa i18n (`dateRange.placeholder`). */
1885
2057
  readonly placeholder: _angular_core.InputSignal<string | undefined>;
1886
- readonly displayFormat: _angular_core.InputSignal<"pl" | "iso">;
2058
+ /** Zapis dat: `'pl'` (domyślnie), `'iso'` albo `'locale'` (`Intl` dla języka `KptI18n`). */
2059
+ readonly displayFormat: _angular_core.InputSignal<KptDateDisplayFormat>;
2060
+ /** Pierwszy dzień tygodnia (1 = poniedziałek … 7 = niedziela); `null` = wg języka `KptI18n`. */
2061
+ readonly firstDayOfWeek: _angular_core.InputSignal<KptFirstDayOfWeek | null>;
1887
2062
  readonly mode: _angular_core.InputSignal<KptDateRangeMode>;
1888
2063
  /** Liczba miesięcy obok siebie (1–3; domyślnie 1). Ignorowana w trybie 'time'. */
1889
2064
  readonly visibleMonths: _angular_core.InputSignalWithTransform<number, unknown>;
@@ -1898,11 +2073,18 @@ declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
1898
2073
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
1899
2074
  readonly id: _angular_core.InputSignal<string | null>;
1900
2075
  protected readonly i18n: KptI18n;
2076
+ private readonly firstDay;
1901
2077
  protected readonly weekdays: _angular_core.Signal<string[]>;
2078
+ private readonly periods;
1902
2079
  private readonly months;
1903
2080
  protected readonly effectivePlaceholder: _angular_core.Signal<string>;
1904
- protected readonly open: _angular_core.WritableSignal<boolean>;
1905
- private readonly today;
2081
+ /**
2082
+ * Stan panelu (dwukierunkowy), jak w `kpt-datepicker`: można go otworzyć z zewnątrz
2083
+ * i wiedzieć, kiedy użytkownik skończył wybierać.
2084
+ */
2085
+ readonly open: _angular_core.ModelSignal<boolean>;
2086
+ /** „Dziś” liczone przy każdym otwarciu — panel otwarty po północy nie pokazuje wczorajszego dnia. */
2087
+ private today;
1906
2088
  private readonly view;
1907
2089
  private readonly uid;
1908
2090
  protected readonly panelId: string;
@@ -1942,17 +2124,22 @@ declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
1942
2124
  private revealMonth;
1943
2125
  private closeAndFocus;
1944
2126
  protected toggleOpen(): void;
2127
+ /** Stan panelu przy otwarciu — także otwarciu z zewnątrz (`[(open)]`), stąd efekt w konstruktorze. */
2128
+ private prepareOpen;
2129
+ constructor();
1945
2130
  protected close(): void;
1946
2131
  protected selectDay(cell: KptRangeDayCell): void;
1947
2132
  private announce;
1948
2133
  protected commit(): void;
1949
2134
  protected prevMonth(): void;
1950
2135
  protected nextMonth(): void;
2136
+ /** Przewinięcie strzałką ‹ › ogłasza widoczne miesiące (APG: `aria-live` na nagłówku). */
2137
+ private announcePage;
1951
2138
  /** Strzałki ‹ ›: fokus zostaje na strzałce, ale przystanek siatki idzie za stroną. */
1952
2139
  private followPage;
1953
2140
  protected clear(event: Event): void;
1954
2141
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDateRange, never>;
1955
- 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; }; "visibleMonths": { "alias": "visibleMonths"; "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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
2142
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDateRange, "kpt-date-range", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "displayFormat": { "alias": "displayFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "visibleMonths": { "alias": "visibleMonths"; "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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "open": "openChange"; }, never, never, true, never>;
1956
2143
  }
1957
2144
 
1958
2145
  /**
@@ -1985,6 +2172,8 @@ declare class KptInputNumber implements FormValueControl<number | null> {
1985
2172
  /** Pokaż przyciski krokowania. `false` daje samo pole — wariant do zakresów „od–do". */
1986
2173
  readonly showButtons: _angular_core.InputSignalWithTransform<boolean, unknown>;
1987
2174
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2175
+ /** Tylko do odczytu — wartość widać i da się ją zaznaczyć, ale nie zmienić (także strzałkami). */
2176
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1988
2177
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1989
2178
  /** Id natywnego pola; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
1990
2179
  readonly id: _angular_core.InputSignal<string | null>;
@@ -2015,11 +2204,14 @@ declare class KptInputNumber implements FormValueControl<number | null> {
2015
2204
  private stepBy;
2016
2205
  private clamp;
2017
2206
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptInputNumber, never>;
2018
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInputNumber, "kpt-input-number", 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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "showButtons": { "alias": "showButtons"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2207
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInputNumber, "kpt-input-number", 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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "showButtons": { "alias": "showButtons"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2019
2208
  }
2020
2209
 
2210
+ /** 0 = bardzo słabe … 4 = silne. */
2211
+ type KptPasswordScore = 0 | 1 | 2 | 3 | 4;
2212
+
2021
2213
  interface Strength {
2022
- score: 0 | 1 | 2 | 3 | 4;
2214
+ score: KptPasswordScore;
2023
2215
  label: string;
2024
2216
  }
2025
2217
  /**
@@ -2031,7 +2223,6 @@ interface Strength {
2031
2223
  declare class KptPassword implements FormValueControl<string> {
2032
2224
  readonly value: _angular_core.ModelSignal<string>;
2033
2225
  readonly placeholder: _angular_core.InputSignal<string>;
2034
- /** Id natywnego pola — pozwala związać etykietę przez `kpt-form-field [controlId]`. */
2035
2226
  /** Id natywnego pola; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
2036
2227
  readonly id: _angular_core.InputSignal<string | null>;
2037
2228
  /** Nazwa dostępna, gdy pola nie opisuje `<label for>`. */
@@ -2067,12 +2258,24 @@ declare class KptPassword implements FormValueControl<string> {
2067
2258
  *
2068
2259
  * @example
2069
2260
  * <kpt-input-otp [formField]="f.code" [length]="6" integerOnly />
2261
+ * <kpt-input-otp [formField]="f.code" [length]="9" groupSize="3" /> <!-- [][][]–[][][]–[][][] -->
2070
2262
  */
2071
2263
  declare class KptInputOtp implements FormValueControl<string> {
2072
2264
  readonly value: _angular_core.ModelSignal<string>;
2073
2265
  readonly length: _angular_core.InputSignal<number>;
2074
2266
  readonly integerOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2267
+ /**
2268
+ * Co ile komórek wstawić separator, licząc od lewej (`3` przy `length` 9 → `[][][]–[][][]–[][][]`).
2269
+ * `0` (domyślnie) — bez grup. Separator jest wyłącznie wizualny: wartość to same znaki.
2270
+ */
2271
+ readonly groupSize: _angular_core.InputSignalWithTransform<number, unknown>;
2272
+ /** Znak między grupami komórek. */
2273
+ readonly groupSeparator: _angular_core.InputSignal<string>;
2075
2274
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2275
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — kod widać, nie da się go zmienić. */
2276
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2277
+ /** Pole wymagane — `aria-required` na komórkach; rola `group` go nie przyjmuje. */
2278
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2076
2279
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
2077
2280
  readonly id: _angular_core.InputSignal<string | null>;
2078
2281
  /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `kpt-form-field`). */
@@ -2085,7 +2288,16 @@ declare class KptInputOtp implements FormValueControl<string> {
2085
2288
  protected readonly i18n: KptI18n;
2086
2289
  protected readonly field: _konce_pt_angular.KptFieldA11y;
2087
2290
  protected readonly slots: _angular_core.Signal<number[]>;
2291
+ /**
2292
+ * Komórki na ekranie. Wartość modelu to wpisane znaki **bez dziur** (`'13'`, nie `'1 3'`): walidator
2293
+ * długości i backend widzą tyle znaków, ile naprawdę wpisano. Komórki trzymają układ osobno —
2294
+ * wyczyszczenie środkowej zostawia w niej pustkę, zamiast przesuwać resztę kodu w lewo.
2295
+ * Zmiana wartości z zewnątrz (inna niż złożenie bieżących komórek) układa znaki od początku.
2296
+ */
2297
+ private readonly cells;
2088
2298
  protected charAt(i: number): string;
2299
+ /** Zapis komórek i złożonej z nich wartości — jedno miejsce, żeby układ i model się nie rozjechały. */
2300
+ private commitCells;
2089
2301
  protected onInput(i: number, event: Event): void;
2090
2302
  protected onKeydown(i: number, event: KeyboardEvent): void;
2091
2303
  protected onPaste(event: ClipboardEvent): void;
@@ -2094,9 +2306,12 @@ declare class KptInputOtp implements FormValueControl<string> {
2094
2306
  /** Wpisuje `text` od komórki `start` (bez spacji i — przy `integerOnly` — bez nie-cyfr). */
2095
2307
  private fillFrom;
2096
2308
  private setChar;
2309
+ /** Czy za komórką `i` kończy się grupa (a nie cały kod). */
2310
+ protected separatorAfter(i: number): boolean;
2311
+ /** Następna/poprzednia komórka — po polach, nie po rodzeństwie, bo między grupami stoi separator. */
2097
2312
  private focusSibling;
2098
2313
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptInputOtp, never>;
2099
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInputOtp, "kpt-input-otp", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "integerOnly": { "alias": "integerOnly"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2314
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInputOtp, "kpt-input-otp", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "integerOnly": { "alias": "integerOnly"; "required": false; "isSignal": true; }; "groupSize": { "alias": "groupSize"; "required": false; "isSignal": true; }; "groupSeparator": { "alias": "groupSeparator"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2100
2315
  }
2101
2316
 
2102
2317
  /**
@@ -2112,6 +2327,8 @@ declare class KptChipsInput implements FormValueControl<string[]> {
2112
2327
  readonly placeholder: _angular_core.InputSignal<string | undefined>;
2113
2328
  readonly allowDuplicates: _angular_core.InputSignalWithTransform<boolean, unknown>;
2114
2329
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2330
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — tagi widać, nie da się ich dodać ani usunąć. */
2331
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2115
2332
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2116
2333
  /** Id natywnego pola; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
2117
2334
  readonly id: _angular_core.InputSignal<string | null>;
@@ -2127,11 +2344,16 @@ declare class KptChipsInput implements FormValueControl<string[]> {
2127
2344
  protected readonly effectivePlaceholder: _angular_core.Signal<string>;
2128
2345
  /** Komunikat regionu `polite`: dodanie, usunięcie albo odrzucony duplikat. */
2129
2346
  protected readonly announcement: _angular_core.WritableSignal<string>;
2347
+ /**
2348
+ * Ten sam komunikat dwa razy z rzędu (drugi odrzucony duplikat) nie zmieniłby treści regionu
2349
+ * i czytnik by go nie ogłosił — doklejamy niewidoczną spację, żeby tekst się różnił.
2350
+ */
2351
+ private announce;
2130
2352
  protected onKeydown(event: KeyboardEvent): void;
2131
2353
  protected commit(el: HTMLInputElement): void;
2132
2354
  protected removeAt(index: number): void;
2133
2355
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptChipsInput, never>;
2134
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptChipsInput, "kpt-chips-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2356
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptChipsInput, "kpt-chips-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2135
2357
  }
2136
2358
 
2137
2359
  /**
@@ -2153,6 +2375,8 @@ declare class KptInputMask implements FormValueControl<string> {
2153
2375
  /** Podpowiedź autouzupełniania (`tel`, `postal-code`, `cc-number`…), żeby przeglądarka mogła wypełnić pole. */
2154
2376
  readonly autocomplete: _angular_core.InputSignal<string | null>;
2155
2377
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2378
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — natywne `readonly` pola. */
2379
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2156
2380
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2157
2381
  /** Id natywnego pola; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
2158
2382
  readonly id: _angular_core.InputSignal<string | null>;
@@ -2166,9 +2390,8 @@ declare class KptInputMask implements FormValueControl<string> {
2166
2390
  protected readonly field: _konce_pt_angular.KptFieldA11y;
2167
2391
  protected readonly effectiveInputMode: _angular_core.Signal<string | null>;
2168
2392
  protected onInput(event: Event): void;
2169
- private applyMask;
2170
2393
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptInputMask, never>;
2171
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInputMask, "kpt-input-mask", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2394
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptInputMask, "kpt-input-mask", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2172
2395
  }
2173
2396
 
2174
2397
  /**
@@ -2192,6 +2415,11 @@ declare class KptListbox<T = unknown> implements FormValueControl<T | T[] | null
2192
2415
  readonly filter: _angular_core.InputSignalWithTransform<boolean, unknown>;
2193
2416
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2194
2417
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2418
+ /**
2419
+ * Tylko do odczytu (także z `readonly()` w schemacie) — po liście da się chodzić i czytać wybór,
2420
+ * ale nie da się go zmienić (`aria-readonly`).
2421
+ */
2422
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2195
2423
  /** Id listy; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
2196
2424
  readonly id: _angular_core.InputSignal<string | null>;
2197
2425
  /** Nazwa dostępna listy, gdy nie opisuje jej etykieta (`kpt-form-field`). */
@@ -2216,14 +2444,18 @@ declare class KptListbox<T = unknown> implements FormValueControl<T | T[] | null
2216
2444
  protected optionId(index: number): string;
2217
2445
  protected isSelected(v: T): boolean;
2218
2446
  protected toggle(v: T): void;
2219
- protected pick(index: number): void;
2447
+ /** Ostatnio kliknięta opcja — początek zakresu dla `Shift+klik` w trybie `multiple`. */
2448
+ private anchorIndex;
2449
+ protected pick(index: number, extend?: boolean): void;
2450
+ /** Zaznacza (dokłada) dozwolone opcje między dwoma indeksami włącznie — `Shift+klik` (APG). */
2451
+ private selectRange;
2220
2452
  /** Wejście fokusem: aktywna zostaje wybrana opcja, a bez niej pierwsza dozwolona. */
2221
2453
  protected onFocus(): void;
2222
2454
  protected onQuery(text: string): void;
2223
2455
  protected onFilterKeydown(event: KeyboardEvent): void;
2224
2456
  protected onKeydown(event: KeyboardEvent): void;
2225
2457
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptListbox<any>, never>;
2226
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptListbox<any>, "kpt-listbox", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "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; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2458
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptListbox<any>, "kpt-listbox", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "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; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2227
2459
  }
2228
2460
 
2229
2461
  /**
@@ -2231,7 +2463,8 @@ declare class KptListbox<T = unknown> implements FormValueControl<T | T[] | null
2231
2463
  *
2232
2464
  * Skok wartości (strzałka, `Home`/`End`, klik w łuk, zmiana z zewnątrz) łuk i licznik pokonują
2233
2465
  * płynnie; przy przeciąganiu idą za kursorem bez opóźnienia, żeby nie było poczucia lagu.
2234
- * `prefers-reduced-motion` wyłącza animację. `aria-valuenow` zawsze niesie wartość docelową,
2466
+ * `PageUp`/`PageDown` skaczą o dziesięć kroków. Wartości leżą na siatce `min + k·step`, tak samo
2467
+ * dla myszy i klawiatury. `prefers-reduced-motion` wyłącza animację. `aria-valuenow` zawsze niesie wartość docelową,
2235
2468
  * nie pośrednią — czytnik nie ogłasza kolejnych klatek.
2236
2469
  *
2237
2470
  * Pod `[formField]` zakres bierze się ze schematu (`min(path.level, 0)`,
@@ -2252,6 +2485,8 @@ declare class KptKnob implements FormValueControl<number> {
2252
2485
  readonly suffix: _angular_core.InputSignal<string>;
2253
2486
  readonly showValue: _angular_core.InputSignalWithTransform<boolean, unknown>;
2254
2487
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2488
+ /** Tylko do odczytu — pokrętło widać i da się na nim stanąć, ale nie zmienić wartości. */
2489
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
2255
2490
  /** Id elementu fokusowalnego; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
2256
2491
  readonly id: _angular_core.InputSignal<string | null>;
2257
2492
  /** Nazwa dostępna, gdy kontrolki nie opisuje etykieta (`<label for>` albo `kpt-form-field`). */
@@ -2284,7 +2519,7 @@ declare class KptKnob implements FormValueControl<number> {
2284
2519
  private applyRatio;
2285
2520
  protected onKeydown(event: KeyboardEvent): void;
2286
2521
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptKnob, never>;
2287
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptKnob, "kpt-knob", 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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "stroke": { "alias": "stroke"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2522
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptKnob, "kpt-knob", 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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "stroke": { "alias": "stroke"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
2288
2523
  }
2289
2524
 
2290
2525
  type KptCardVariant = 'elevated' | 'outlined';
@@ -2328,14 +2563,20 @@ type KptDividerOrientation = 'horizontal' | 'vertical';
2328
2563
  * <kpt-divider />
2329
2564
  * <kpt-divider orientation="vertical" />
2330
2565
  * <kpt-divider inset />
2566
+ * <kpt-divider decorative /> <!-- sama ozdoba, np. między kartami — czytnik jej nie ogłasza -->
2331
2567
  */
2332
2568
  declare class KptDivider {
2333
2569
  /** Orientacja linii. */
2334
2570
  readonly orientation: _angular_core.InputSignal<KptDividerOrientation>;
2335
2571
  /** Wcięcie (odstęp od krawędzi kontenera). */
2336
2572
  readonly inset: _angular_core.InputSignalWithTransform<boolean, unknown>;
2573
+ /**
2574
+ * Linia czysto ozdobna (np. między kartami, które i tak są osobnymi regionami) — bez
2575
+ * `role="separator"`, ukryta przed czytnikiem. Domyślnie separator jest ogłaszany.
2576
+ */
2577
+ readonly decorative: _angular_core.InputSignalWithTransform<boolean, unknown>;
2337
2578
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDivider, never>;
2338
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDivider, "kpt-divider", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "inset": { "alias": "inset"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2579
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDivider, "kpt-divider", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "inset": { "alias": "inset"; "required": false; "isSignal": true; }; "decorative": { "alias": "decorative"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2339
2580
  }
2340
2581
 
2341
2582
  /**
@@ -2392,30 +2633,6 @@ declare class KptSidenav {
2392
2633
  * - `over` — zawsze nakładka nad treścią.
2393
2634
  */
2394
2635
  type KptSidenavMode = 'side' | 'over' | 'auto';
2395
- /**
2396
- * Szkielet aplikacji: pasek u góry, panel boczny i treść. Sloty projekcji:
2397
- * `[kptShellToolbar]`, `[kptShellSidenav]` oraz treść domyślna.
2398
- *
2399
- * Domyślny tryb `auto` jest responsywny bez konfiguracji: od `sidenavBreakpoint` w górę
2400
- * panel jest zadokowany, poniżej zachowuje się jak nakładka ze scrimem i startuje zamknięty.
2401
- * Opcjonalny `sidenavRailBreakpoint` wstawia między te pasma szynę ikon.
2402
- *
2403
- * O układzie decyduje wyłącznie CSS — nic nie migocze przed hydracją i nic nie zależy od
2404
- * `matchMedia`. JavaScript odpowiada tylko za to, KTÓRY stan przełącza przycisk.
2405
- *
2406
- * Panel ma dwa niezależne stany otwarcia (`sidenavOpen` dla układu zadokowanego,
2407
- * `sidenavCompactOpen` dla nakładki), więc intencja z desktopu przeżywa zwężenie
2408
- * i ponowne rozszerzenie okna.
2409
- *
2410
- * @example
2411
- * <kpt-app-shell [(sidenavOpen)]="navOpen">
2412
- * <kpt-toolbar kptShellToolbar>
2413
- * <button kptShellNavToggle type="button"><kpt-icon name="menu" /></button>
2414
- * </kpt-toolbar>
2415
- * <kpt-sidenav kptShellSidenav>…</kpt-sidenav>
2416
- * <router-outlet />
2417
- * </kpt-app-shell>
2418
- */
2419
2636
  declare class KptAppShell {
2420
2637
  private static nextId;
2421
2638
  private readonly breakpoints;
@@ -2464,7 +2681,11 @@ declare class KptAppShell {
2464
2681
  /** Zamyka panel w bieżącym układzie. */
2465
2682
  closeSidenav(): void;
2466
2683
  protected onScrimClick(): void;
2467
- protected onEscape(): void;
2684
+ /**
2685
+ * Escape zamyka nakładkę nawigacji — ale nie wtedy, gdy zamyka nim coś otwartego nad shellem
2686
+ * (okno, menu, popover). Te albo wołają `preventDefault()`, albo trzymają fokus w sobie.
2687
+ */
2688
+ protected onEscape(event: Event): void;
2468
2689
  private usesCompactState;
2469
2690
  private setSidenavOpen;
2470
2691
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAppShell, never>;
@@ -2652,6 +2873,30 @@ declare class KptBackdrop {
2652
2873
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBackdrop, "kpt-backdrop", never, { "effect": { "alias": "effect"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "speed": { "alias": "speed"; "required": false; "isSignal": true; }; "seed": { "alias": "seed"; "required": false; "isSignal": true; }; "paused": { "alias": "paused"; "required": false; "isSignal": true; }; "adaptive": { "alias": "adaptive"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "anchor": { "alias": "anchor"; "required": false; "isSignal": true; }; "cell": { "alias": "cell"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "falloff": { "alias": "falloff"; "required": false; "isSignal": true; }; "colors": { "alias": "colors"; "required": false; "isSignal": true; }; "rotation": { "alias": "rotation"; "required": false; "isSignal": true; }; "band": { "alias": "band"; "required": false; "isSignal": true; }; "amplitude": { "alias": "amplitude"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2653
2874
  }
2654
2875
 
2876
+ /**
2877
+ * Własny szablon przycisku jednego dostawcy logowania w `kpt-auth`. Kontekst: `$implicit` =
2878
+ * obiekt dostawcy, `select` = funkcja zgłaszająca wybór (emituje `providerSelect`).
2879
+ *
2880
+ * Przydatne, gdy logo marki nie przechodzi przez rejestr ikon (gradienty i `fill-rule` są
2881
+ * wycinane przy sanityzacji) albo gdy przycisk ma mieć inny układ niż wbudowany.
2882
+ *
2883
+ * @example
2884
+ * <kpt-auth [providers]="providers">
2885
+ * <ng-template kptAuthProvider="google" let-p let-select="select">
2886
+ * <button type="button" class="my-google" (click)="select()">
2887
+ * <img src="/google.svg" alt="" /> {{ p.label }}
2888
+ * </button>
2889
+ * </ng-template>
2890
+ * </kpt-auth>
2891
+ */
2892
+ declare class KptAuthProviderDef {
2893
+ /** Identyfikator dostawcy, dla którego obowiązuje szablon. */
2894
+ readonly kptAuthProvider: _angular_core.InputSignal<string>;
2895
+ readonly template: TemplateRef<any>;
2896
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAuthProviderDef, never>;
2897
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptAuthProviderDef, "ng-template[kptAuthProvider]", never, { "kptAuthProvider": { "alias": "kptAuthProvider"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
2898
+ }
2899
+
2655
2900
  /** Tryb ekranu — logowanie, rejestracja, odzyskiwanie hasła. */
2656
2901
  type KptAuthMode = 'signIn' | 'signUp' | 'forgot';
2657
2902
  /**
@@ -2693,6 +2938,11 @@ interface KptAuthResetValue {
2693
2938
  email: string;
2694
2939
  }
2695
2940
 
2941
+ /** Kontekst szablonu własnego dostawcy (`<ng-template kptAuthProvider="…" let-provider let-select="select">`). */
2942
+ interface KptAuthProviderContext {
2943
+ $implicit: KptAuthProvider;
2944
+ select: () => void;
2945
+ }
2696
2946
  /**
2697
2947
  * Ekran uwierzytelniania: logowanie, rejestracja i odzyskiwanie hasła w jednym komponencie,
2698
2948
  * z panelem promocyjnym i listą dostawców zewnętrznych (OAuth/SSO).
@@ -2732,7 +2982,10 @@ declare class KptAuth {
2732
2982
  readonly requireTerms: _angular_core.InputSignalWithTransform<boolean, unknown>;
2733
2983
  /** Przełącznik „zapamiętaj mnie" przy logowaniu. */
2734
2984
  readonly showRemember: _angular_core.InputSignalWithTransform<boolean, unknown>;
2735
- /** Operacja w toku — przyciski w stanie ładowania, pola zablokowane. */
2985
+ /**
2986
+ * Operacja w toku — przycisk wysyłki w stanie ładowania (wysyłka zablokowana), dostawcy
2987
+ * zablokowani. Pola zostają edytowalne: wpisany tekst nie znika i można go poprawić po błędzie.
2988
+ */
2736
2989
  readonly busy: _angular_core.InputSignalWithTransform<boolean, unknown>;
2737
2990
  /** Komunikat błędu z serwera (np. „nieprawidłowe dane logowania"). */
2738
2991
  readonly error: _angular_core.InputSignal<string | null>;
@@ -2756,6 +3009,8 @@ declare class KptAuth {
2756
3009
  protected readonly i18n: KptI18n;
2757
3010
  private readonly injector;
2758
3011
  private readonly uid;
3012
+ /** Minimalna długość hasła — dla podpowiedzi pola w szablonie. */
3013
+ protected readonly minPassword = 8;
2759
3014
  /** Nagłówek panelu dostaje fokus po zmianie trybu — inaczej zmiana nie zostaje ogłoszona. */
2760
3015
  private readonly headings;
2761
3016
  private readonly providerDefs;
@@ -2792,9 +3047,6 @@ declare class KptAuth {
2792
3047
  }, string | number, "writable">;
2793
3048
  private readonly resetModel;
2794
3049
  protected readonly resetForm: _angular_forms_signals.FieldTree<KptAuthResetValue, string | number, "writable">;
2795
- protected readonly signInInvalid: _angular_core.Signal<boolean>;
2796
- protected readonly signUpInvalid: _angular_core.Signal<boolean>;
2797
- protected readonly resetInvalid: _angular_core.Signal<boolean>;
2798
3050
  protected readonly signInEmailError: _angular_core.Signal<string | null>;
2799
3051
  protected readonly signInPasswordError: _angular_core.Signal<string | null>;
2800
3052
  protected readonly signUpNameError: _angular_core.Signal<string | null>;
@@ -2813,39 +3065,18 @@ declare class KptAuth {
2813
3065
  protected onSignIn(): void;
2814
3066
  protected onSignUp(): void;
2815
3067
  protected onReset(): void;
2816
- protected templateFor(provider: KptAuthProvider): _angular_core.TemplateRef<any> | null;
3068
+ /**
3069
+ * Własne szablony dostawców z kontekstem, liczone raz na zmianę danych. Kontekst jest stałym
3070
+ * obiektem — tworzony w szablonie przy każdym przebiegu sprawiałby, że `ngTemplateOutlet` za
3071
+ * każdym razem uznaje go za nowy. `$implicit` = dostawca, `select` = zgłoszenie wyboru.
3072
+ */
3073
+ protected readonly providerTemplates: _angular_core.Signal<Map<string, {
3074
+ template: KptAuthProviderDef["template"];
3075
+ context: KptAuthProviderContext;
3076
+ }>>;
2817
3077
  protected selectProvider(provider: KptAuthProvider): void;
2818
- /** Kontekst szablonu własnego dostawcy: `$implicit` = dostawca, `select` = zgłoszenie wyboru. */
2819
- protected providerContext(provider: KptAuthProvider): {
2820
- $implicit: KptAuthProvider;
2821
- select: () => void;
2822
- };
2823
3078
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAuth, never>;
2824
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAuth, "kpt-auth", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "providers": { "alias": "providers"; "required": false; "isSignal": true; }; "providerLayout": { "alias": "providerLayout"; "required": false; "isSignal": true; }; "showName": { "alias": "showName"; "required": false; "isSignal": true; }; "requireTerms": { "alias": "requireTerms"; "required": false; "isSignal": true; }; "showRemember": { "alias": "showRemember"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "notice": { "alias": "notice"; "required": false; "isSignal": true; }; "promoTitle": { "alias": "promoTitle"; "required": false; "isSignal": true; }; "promoText": { "alias": "promoText"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "mode": "modeChange"; "signIn": "signIn"; "signUp": "signUp"; "resetPassword": "resetPassword"; "providerSelect": "providerSelect"; }, ["providerDefs"], ["[kptAuthBrand]", "[kptAuthFields]", "[kptAuthFields]", "[kptAuthSso]", "[kptAuthFooter]", "[kptAuthPromo]"], true, never>;
2825
- }
2826
-
2827
- /**
2828
- * Własny szablon przycisku jednego dostawcy logowania w `kpt-auth`. Kontekst: `$implicit` =
2829
- * obiekt dostawcy, `select` = funkcja zgłaszająca wybór (emituje `providerSelect`).
2830
- *
2831
- * Przydatne, gdy logo marki nie przechodzi przez rejestr ikon (gradienty i `fill-rule` są
2832
- * wycinane przy sanityzacji) albo gdy przycisk ma mieć inny układ niż wbudowany.
2833
- *
2834
- * @example
2835
- * <kpt-auth [providers]="providers">
2836
- * <ng-template kptAuthProvider="google" let-p let-select="select">
2837
- * <button type="button" class="my-google" (click)="select()">
2838
- * <img src="/google.svg" alt="" /> {{ p.label }}
2839
- * </button>
2840
- * </ng-template>
2841
- * </kpt-auth>
2842
- */
2843
- declare class KptAuthProviderDef {
2844
- /** Identyfikator dostawcy, dla którego obowiązuje szablon. */
2845
- readonly kptAuthProvider: _angular_core.InputSignal<string>;
2846
- readonly template: TemplateRef<any>;
2847
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAuthProviderDef, never>;
2848
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptAuthProviderDef, "ng-template[kptAuthProvider]", never, { "kptAuthProvider": { "alias": "kptAuthProvider"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
3079
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAuth, "kpt-auth", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "providers": { "alias": "providers"; "required": false; "isSignal": true; }; "providerLayout": { "alias": "providerLayout"; "required": false; "isSignal": true; }; "showName": { "alias": "showName"; "required": false; "isSignal": true; }; "requireTerms": { "alias": "requireTerms"; "required": false; "isSignal": true; }; "showRemember": { "alias": "showRemember"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "notice": { "alias": "notice"; "required": false; "isSignal": true; }; "promoTitle": { "alias": "promoTitle"; "required": false; "isSignal": true; }; "promoText": { "alias": "promoText"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "mode": "modeChange"; "signIn": "signIn"; "signUp": "signUp"; "resetPassword": "resetPassword"; "providerSelect": "providerSelect"; }, ["providerDefs"], ["[kptAuthFields]", "[kptAuthBrand]", "[kptAuthSso]", "[kptAuthFooter]", "[kptAuthPromo]"], true, never>;
2849
3080
  }
2850
3081
 
2851
3082
  /**
@@ -2880,6 +3111,8 @@ declare class KptFieldset {
2880
3111
  readonly collapsed: _angular_core.ModelSignal<boolean>;
2881
3112
  readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
2882
3113
  readonly animationDuration: _angular_core.InputSignal<number>;
3114
+ /** Cel `aria-controls` przełącznika — czytnik wie, którą treść zwija przycisk. */
3115
+ protected readonly bodyId: string;
2883
3116
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptFieldset, never>;
2884
3117
  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>;
2885
3118
  }
@@ -2959,7 +3192,8 @@ declare class KptImage {
2959
3192
  private readonly dialog;
2960
3193
  private readonly trigger;
2961
3194
  /** Wartość `overflow` dokumentu sprzed otwarcia — oddajemy ją po zamknięciu. */
2962
- private savedOverflow;
3195
+ /** Zdjęcie blokady przewijania strony (wspólny licznik z oknami i szufladami). */
3196
+ private releaseScroll;
2963
3197
  /** Miniatura z `alt` mówi, co powiększa; bez niego — samą czynność. */
2964
3198
  protected readonly triggerLabel: _angular_core.Signal<string>;
2965
3199
  constructor();
@@ -2969,7 +3203,6 @@ declare class KptImage {
2969
3203
  protected onClosed(): void;
2970
3204
  /** Okno wypełnia cały ekran, więc kliknięcie w nie samo (a nie w zdjęcie) to kliknięcie w tło. */
2971
3205
  protected onDialogClick(event: MouseEvent): void;
2972
- private lockScroll;
2973
3206
  private unlockScroll;
2974
3207
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptImage, never>;
2975
3208
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptImage, "kpt-image", never, { "src": { "alias": "src"; "required": true; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "preview": { "alias": "preview"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -3055,7 +3288,7 @@ declare class KptEmpty {
3055
3288
  * Robi z tytułu nagłówek strony (`role="heading"` z `aria-level`), żeby pusty stan pojawił się
3056
3289
  * w strukturze dokumentu — np. gdy zastępuje całą sekcję. Bez tego tytuł to sam tekst.
3057
3290
  */
3058
- readonly headingLevel: _angular_core.InputSignal<3 | 1 | 2 | 4 | 5 | 6 | null>;
3291
+ readonly headingLevel: _angular_core.InputSignal<2 | 1 | 4 | 3 | 5 | 6 | null>;
3059
3292
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptEmpty, never>;
3060
3293
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptEmpty, "kpt-empty", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "headingLevel": { "alias": "headingLevel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
3061
3294
  }
@@ -3099,7 +3332,10 @@ declare class KptTabs {
3099
3332
  protected readonly baseId: string;
3100
3333
  /** Disabled każdej zakładki — wejście dla nawigacji strzałkami. */
3101
3334
  private readonly disabledMap;
3102
- /** Jedyna zakładka w kolejności Tab: aktywna, a gdy ta jest wyłączona — pierwsza dostępna. */
3335
+ /**
3336
+ * Zakładka pokazywana i jedyna w kolejności Tab: aktywna, a gdy ta jest wyłączona — pierwsza
3337
+ * dostępna. Wyłączona zakładka nie może wyglądać na wybraną (ani mieć swojego panelu).
3338
+ */
3103
3339
  protected readonly tabStop: _angular_core.Signal<number>;
3104
3340
  protected readonly activeTab: _angular_core.Signal<KptTab>;
3105
3341
  protected readonly activePanels: _angular_core.Signal<KptTab[]>;
@@ -3156,16 +3392,23 @@ interface KptBreadcrumbItem {
3156
3392
  url?: string;
3157
3393
  }
3158
3394
  /**
3159
- * Ścieżka nawigacji (breadcrumbs).
3395
+ * Ścieżka nawigacji (breadcrumbs). Odnośniki to zwykłe `<a href>`; aplikacja z routerem łapie
3396
+ * `navigate`, woła `event.preventDefault()` i nawiguje sama, bez przeładowania strony.
3397
+ *
3398
+ * @example
3399
+ * <kpt-breadcrumb [items]="crumbs" (navigate)="$event.event.preventDefault(); router.navigateByUrl($event.url)" />
3160
3400
  *
3161
3401
  * @example
3162
3402
  * <kpt-breadcrumb [items]="[{label:'Start',url:'/'},{label:'Ustawienia'}]" />
3163
3403
  */
3164
3404
  declare class KptBreadcrumb {
3165
3405
  readonly items: _angular_core.InputSignal<readonly KptBreadcrumbItem[]>;
3406
+ /** Zwykły klik w odnośnik — hak dla routera aplikacji (patrz `KptNavigateEvent`). */
3407
+ readonly navigate: _angular_core.OutputEmitterRef<KptNavigateEvent<KptBreadcrumbItem>>;
3166
3408
  protected readonly i18n: KptI18n;
3409
+ protected onLink(event: MouseEvent, item: KptBreadcrumbItem): void;
3167
3410
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBreadcrumb, never>;
3168
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBreadcrumb, "kpt-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
3411
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBreadcrumb, "kpt-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, never, never, true, never>;
3169
3412
  }
3170
3413
 
3171
3414
  /**
@@ -3229,6 +3472,8 @@ declare class KptPaginator {
3229
3472
  * pokazuje pierwszą pozycję i cicho kłamie o stanie, po którym tabela naprawdę stronicuje.
3230
3473
  */
3231
3474
  protected readonly sizeOptions: _angular_core.Signal<readonly number[]>;
3475
+ /** Rozmiar strony do rachunków — `0` albo ujemny dawałby `Infinity` stron i wieczne „dalej”. */
3476
+ private readonly step;
3232
3477
  readonly totalPages: _angular_core.Signal<number>;
3233
3478
  readonly rangeStart: _angular_core.Signal<number>;
3234
3479
  readonly rangeEnd: _angular_core.Signal<number>;
@@ -3264,7 +3509,10 @@ interface KptColumn {
3264
3509
  sortable?: boolean;
3265
3510
  /** Wyrównanie zawartości. */
3266
3511
  align?: 'start' | 'center' | 'end';
3267
- /** Szerokość kolumny (np. '10rem', '20%'). Wymagane dla kolumn zamrożonych. */
3512
+ /**
3513
+ * Szerokość kolumny (np. '10rem', '20%'). Kolumny zamrożone potrzebują jej do przesunięć:
3514
+ * `px`/`rem`/`em` liczą się od razu, inne jednostki (`%`, `ch`) są mierzone po renderze.
3515
+ */
3268
3516
  width?: string;
3269
3517
  /** Zamrożenie (sticky) — obsługiwane dla wiodących, sąsiadujących kolumn. */
3270
3518
  frozen?: boolean;
@@ -3315,12 +3563,23 @@ declare class KptDataTable<T = Record<string, unknown>> {
3315
3563
  readonly data: _angular_core.InputSignal<readonly T[]>;
3316
3564
  readonly filterable: _angular_core.InputSignalWithTransform<boolean, unknown>;
3317
3565
  /** Pozycja wiersza filtrów kolumn względem etykiet: nad ('top') lub pod ('bottom'). */
3318
- readonly filterRowPosition: _angular_core.InputSignal<"bottom" | "top">;
3566
+ readonly filterRowPosition: _angular_core.InputSignal<"top" | "bottom">;
3319
3567
  /** Rozmiar strony; 0 wyłącza paginację. */
3320
3568
  readonly pageSize: _angular_core.InputSignal<number>;
3321
3569
  readonly pageSizeOptions: _angular_core.InputSignal<readonly number[]>;
3322
3570
  readonly selectable: _angular_core.InputSignal<"none" | "single" | "multiple">;
3571
+ /** Trwa ładowanie — tabela dostaje `aria-busy`, a ciało pokazuje komunikat `dataTable.loading`. */
3323
3572
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
3573
+ /** Nazwa dostępna tabeli, gdy nie ma widocznego podpisu (`caption`). */
3574
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
3575
+ /** Widoczny podpis tabeli (`<caption>`) — zarazem jej nazwa dla czytnika. */
3576
+ readonly caption: _angular_core.InputSignal<string | null>;
3577
+ /**
3578
+ * Wiersze jako akcja: fokusowalne (Tab) i aktywowane Enterem/Spacją, które emitują `rowClick`.
3579
+ * Bez tego `rowClick` działa wyłącznie myszą — włącz, gdy klik w wiersz coś robi (np. otwiera
3580
+ * szczegóły), a w wierszu nie ma innego linku ani przycisku do tej samej akcji.
3581
+ */
3582
+ readonly clickableRows: _angular_core.InputSignalWithTransform<boolean, unknown>;
3324
3583
  /** Komunikat pustej tabeli; bez wartości używa i18n (`dataTable.empty`). */
3325
3584
  readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
3326
3585
  /** Pole identyfikujące wiersz (dla zaznaczania). Bez niego — porównanie po referencji. */
@@ -3362,11 +3621,21 @@ declare class KptDataTable<T = Record<string, unknown>> {
3362
3621
  */
3363
3622
  readonly hiddenFields: _angular_core.ModelSignal<readonly string[]>;
3364
3623
  readonly rowClick: _angular_core.OutputEmitterRef<T>;
3365
- /** Emitowane w trybie lazy przy zmianie sortowania/filtra/strony. */
3624
+ /**
3625
+ * Emitowane w trybie lazy przy zmianie sortowania/filtra/strony — także raz na starcie
3626
+ * (pierwsza strona) i po każdej zmianie `pageSize` przez rodzica.
3627
+ */
3366
3628
  readonly lazyLoad: _angular_core.OutputEmitterRef<KptTableLazyState>;
3367
3629
  /** Emitowane po zatwierdzeniu edycji komórki (tylko gdy wartość faktycznie się zmieniła). */
3368
3630
  readonly cellEdit: _angular_core.OutputEmitterRef<KptCellEditEvent<T>>;
3369
3631
  protected readonly i18n: KptI18n;
3632
+ private readonly uid;
3633
+ /** Wspólna nazwa radia w trybie `selectable="single"` — jedna grupa na tabelę. */
3634
+ protected readonly radioName: string;
3635
+ /** Id opisu „Edytuj: …” dla komórek kolumny o danym indeksie. */
3636
+ protected editHintId(index: number): string;
3637
+ /** Ogłoszenie po przestawieniu kolumny z klawiatury. */
3638
+ protected readonly moveAnnouncement: _angular_core.WritableSignal<string>;
3370
3639
  /** Komunikat pustej tabeli (input albo domyślny z i18n). */
3371
3640
  protected readonly emptyText: _angular_core.Signal<string>;
3372
3641
  /** Kolumny w bieżącej kolejności (po ewentualnym przestawieniu). */
@@ -3374,9 +3643,13 @@ declare class KptDataTable<T = Record<string, unknown>> {
3374
3643
  /** Kolumny w bieżącej kolejności, bez tych ukrytych przez `hiddenFields` — do renderowania i eksportu. */
3375
3644
  protected readonly visibleOrderedColumns: _angular_core.Signal<KptColumn[]>;
3376
3645
  private readonly scrollEl;
3646
+ private readonly injector;
3377
3647
  protected readonly scrollTop: _angular_core.WritableSignal<number>;
3378
3648
  protected readonly viewportHeight: _angular_core.WritableSignal<number>;
3379
3649
  private readonly buffer;
3650
+ private readonly destroyRef;
3651
+ /** Zmierzone szerokości kolumn zamrożonych bez szerokości liczalnej z jednostki. */
3652
+ private readonly measuredWidths;
3380
3653
  private readonly theadEl;
3381
3654
  protected readonly theadOffset: _angular_core.WritableSignal<number>;
3382
3655
  protected readonly editingCell: _angular_core.WritableSignal<{
@@ -3407,6 +3680,9 @@ declare class KptDataTable<T = Record<string, unknown>> {
3407
3680
  protected onColDragOver(field: string, event: DragEvent): void;
3408
3681
  protected onColDrop(field: string, event: DragEvent): void;
3409
3682
  protected onColDragEnd(): void;
3683
+ /** Strzałki na uchwycie przestawiają kolumnę o jedno miejsce — alternatywa dla przeciągania. */
3684
+ protected onGripKeydown(field: string, event: KeyboardEvent): void;
3685
+ /** Pobiera widoczne kolumny i przefiltrowane wiersze jako CSV (`;`, CRLF, BOM — patrz `buildCsv`). */
3410
3686
  exportCsv(): void;
3411
3687
  private readonly cellDefs;
3412
3688
  private readonly cellMap;
@@ -3493,7 +3769,8 @@ declare class KptDataTable<T = Record<string, unknown>> {
3493
3769
  private readonly summaryTexts;
3494
3770
  private formatSummary;
3495
3771
  protected summaryText(field: string): string;
3496
- private parseWidthPx;
3772
+ /** Szerokość kolumny zamrożonej: z jednostki, potem z pomiaru, a do pierwszego pomiaru 8 rem. */
3773
+ private widthPx;
3497
3774
  /** Mapa pole → przesunięcie left (px) dla wiodących zamrożonych kolumn. */
3498
3775
  /** Suma szerokości wiodących kolumn systemowych (rozwijanie + zaznaczanie) w px. */
3499
3776
  private readonly leadingStickyWidth;
@@ -3516,10 +3793,12 @@ declare class KptDataTable<T = Record<string, unknown>> {
3516
3793
  protected readonly pageSomeSelected: _angular_core.Signal<boolean>;
3517
3794
  protected toggleAllOnPage(): void;
3518
3795
  protected onRowClick(row: T): void;
3796
+ /** Enter/Spacja na wierszu (`clickableRows`) — tylko na samym wierszu, nie na jego kontrolkach. */
3797
+ protected onRowKeydown(row: T, event: KeyboardEvent): void;
3519
3798
  protected getValue(row: T, field: string): unknown;
3520
3799
  protected trackRow: (row: T) => unknown;
3521
3800
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDataTable<any>, never>;
3522
- 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; }; "summaryLabel": { "alias": "summaryLabel"; "required": false; "isSignal": true; }; "summaryValues": { "alias": "summaryValues"; "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>;
3801
+ 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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "clickableRows": { "alias": "clickableRows"; "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; }; "summaryLabel": { "alias": "summaryLabel"; "required": false; "isSignal": true; }; "summaryValues": { "alias": "summaryValues"; "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>;
3523
3802
  }
3524
3803
 
3525
3804
  /**
@@ -3604,6 +3883,8 @@ interface KptTreeNode<T = unknown> {
3604
3883
  declare class KptTree<T = unknown> {
3605
3884
  readonly nodes: _angular_core.InputSignal<readonly KptTreeNode<T>[]>;
3606
3885
  readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
3886
+ /** Nazwa drzewa dla czytnika (`role="tree"` bez nazwy to samo „drzewo”), np. „Pliki projektu”. */
3887
+ readonly ariaLabel: _angular_core.InputSignal<string>;
3607
3888
  readonly selected: _angular_core.ModelSignal<KptTreeNode<T> | null>;
3608
3889
  readonly nodeClick: _angular_core.OutputEmitterRef<KptTreeNode<T>>;
3609
3890
  private readonly host;
@@ -3631,7 +3912,7 @@ declare class KptTree<T = unknown> {
3631
3912
  /** Fokus na wiersz po renderze — `tabindex` musi już wskazywać nowy przystanek. */
3632
3913
  private moveFocus;
3633
3914
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptTree<any>, never>;
3634
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptTree<any>, "kpt-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; "nodeClick": "nodeClick"; }, never, never, true, never>;
3915
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptTree<any>, "kpt-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; "nodeClick": "nodeClick"; }, never, never, true, never>;
3635
3916
  }
3636
3917
 
3637
3918
  interface KptTimelineItem {
@@ -3669,6 +3950,12 @@ declare class KptTimeline {
3669
3950
  declare class KptCarousel<T = unknown> {
3670
3951
  readonly items: _angular_core.InputSignal<readonly T[]>;
3671
3952
  readonly activeIndex: _angular_core.ModelSignal<number>;
3953
+ /**
3954
+ * Indeks faktycznie pokazywany — przycięty do listy. Gdy `items` się skróci (filtr), model może
3955
+ * wskazywać poza koniec; widok nie zostaje wtedy pusty, a następny ruch zapisuje już poprawny indeks.
3956
+ * Bez efektu przepisującego model (zapis z efektu = emisja `activeIndexChange` w trakcie CD).
3957
+ */
3958
+ protected readonly index: _angular_core.Signal<number>;
3672
3959
  /** Nazwa regionu dla czytników ekranu, np. „Nowości”; domyślnie `carousel.label`. */
3673
3960
  readonly label: _angular_core.InputSignal<string>;
3674
3961
  protected readonly i18n: KptI18n;
@@ -3757,6 +4044,8 @@ declare class KptPickList<T = unknown> {
3757
4044
  protected readonly effectiveSourceHeader: _angular_core.Signal<string>;
3758
4045
  protected readonly effectiveTargetHeader: _angular_core.Signal<string>;
3759
4046
  protected readonly selSource: WritableSignal<Set<T>>;
4047
+ /** Treść regionu `aria-live` po przeniesieniu. */
4048
+ protected readonly announcement: WritableSignal<string>;
3760
4049
  protected readonly selTarget: WritableSignal<Set<T>>;
3761
4050
  private readonly host;
3762
4051
  private readonly injector;
@@ -3791,6 +4080,11 @@ declare class KptPickList<T = unknown> {
3791
4080
  private other;
3792
4081
  protected toggle(side: KptPickListSide, item: T): void;
3793
4082
  protected move(from: KptPickListSide, all: boolean): void;
4083
+ /**
4084
+ * Ogłasza przeniesienie. Ten sam tekst drugi raz pod rząd nie zostałby przeczytany (region
4085
+ * reaguje na zmianę), więc naprzemiennie dokładamy niewidoczną spację.
4086
+ */
4087
+ private announce;
3794
4088
  /** Dwuklik: przenosi wyłącznie klikniętą pozycję, niezależnie od zaznaczenia. */
3795
4089
  protected moveOne(from: KptPickListSide, item: T): void;
3796
4090
  protected onDragStart(side: KptPickListSide, index: number, event: DragEvent): void;
@@ -3827,6 +4121,8 @@ declare class KptOrderList<T = unknown> {
3827
4121
  protected readonly i18n: KptI18n;
3828
4122
  protected readonly itemTpl: _angular_core.Signal<TemplateRef<any>>;
3829
4123
  protected readonly selected: _angular_core.WritableSignal<number | null>;
4124
+ /** Treść regionu `aria-live` po przestawieniu. */
4125
+ protected readonly announcement: _angular_core.WritableSignal<string>;
3830
4126
  private readonly host;
3831
4127
  private readonly injector;
3832
4128
  /** Przystanek Tab: zaznaczona pozycja albo pierwsza. */
@@ -3841,6 +4137,11 @@ declare class KptOrderList<T = unknown> {
3841
4137
  /** Kursor nad pustym obszarem listy — upuszczenie tam dopina na koniec. */
3842
4138
  protected readonly listOver: _angular_core.WritableSignal<boolean>;
3843
4139
  protected moveSelected(dir: -1 | 1): void;
4140
+ /**
4141
+ * Ogłasza nową pozycję. Ten sam tekst drugi raz pod rząd nie zostałby przeczytany (region reaguje
4142
+ * na zmianę), więc naprzemiennie dokładamy niewidoczną spację.
4143
+ */
4144
+ private announce;
3844
4145
  protected onDragStart(index: number, event: DragEvent): void;
3845
4146
  protected onDragOver(index: number, event: DragEvent): void;
3846
4147
  protected onDrop(index: number, event: DragEvent): void;
@@ -3870,6 +4171,12 @@ interface KptGalleriaItem {
3870
4171
  declare class KptGalleria {
3871
4172
  readonly items: _angular_core.InputSignal<readonly KptGalleriaItem[]>;
3872
4173
  readonly activeIndex: _angular_core.ModelSignal<number>;
4174
+ /**
4175
+ * Indeks faktycznie pokazywany — przycięty do listy. Gdy `items` się skróci (filtr), model może
4176
+ * wskazywać poza koniec; widok nie zostaje wtedy pusty, a następny ruch zapisuje już poprawny indeks.
4177
+ * Bez efektu przepisującego model (zapis z efektu = emisja `activeIndexChange` w trakcie CD).
4178
+ */
4179
+ protected readonly index: _angular_core.Signal<number>;
3873
4180
  readonly showThumbnails: _angular_core.InputSignalWithTransform<boolean, unknown>;
3874
4181
  protected readonly i18n: KptI18n;
3875
4182
  protected readonly current: _angular_core.Signal<KptGalleriaItem>;
@@ -3954,7 +4261,17 @@ declare class KptDialog {
3954
4261
  private readonly overlayContainer;
3955
4262
  /** Miejsce, z którego zabraliśmy kontener overlayów — żeby go tam oddać. */
3956
4263
  private overlayHome;
4264
+ /** Zdjęcie blokady przewijania strony — ustawiane przy otwarciu. */
4265
+ private releaseScroll;
3957
4266
  constructor();
4267
+ private afterClosed;
4268
+ /**
4269
+ * `close` przychodzi z każdej drogi. Przy `dismissible=false` zamknąć wolno tylko z kodu:
4270
+ * Chromium z CloseWatcherem pozwala anulować `cancel` jedynie po aktywacji użytkownika, więc drugi
4271
+ * Escape z rzędu zamyka okno mimo `preventDefault` — wtedy otwieramy je z powrotem. Nowe
4272
+ * przeglądarki dostają też `closedby="none"`, które w ogóle wyłącza zamykanie gestem.
4273
+ */
4274
+ protected onClose(): void;
3958
4275
  /**
3959
4276
  * Przenosi kontener CDK Overlay do wnętrza `<dialog>` na czas, gdy okno jest otwarte.
3960
4277
  *
@@ -3980,7 +4297,11 @@ interface KptToast {
3980
4297
  message: string;
3981
4298
  title?: string;
3982
4299
  variant: KptAlertVariant;
3983
- /** Czas życia w ms; 0 = bez auto-zamykania. */
4300
+ /**
4301
+ * Czas życia w ms; 0 = bez auto-zamykania. Domyślnie 4000 ms, a dla toastu z `action` — 0:
4302
+ * użytkownik klawiatury albo czytnika nie zdąży dojść do przycisku „Cofnij” w kontenerze na końcu
4303
+ * strony, zanim toast zniknie (WCAG 2.2.1). Jawne `duration` zawsze wygrywa.
4304
+ */
3984
4305
  duration: number;
3985
4306
  action?: KptToastAction;
3986
4307
  }
@@ -4053,7 +4374,9 @@ declare class KptToastContainer {
4053
4374
  type KptTooltipPosition = 'top' | 'bottom' | 'left' | 'right';
4054
4375
  /**
4055
4376
  * Dymek podpowiedzi (tooltip) pokazywany na hover/focus hosta. Lekki — element dodawany
4056
- * do `body` i pozycjonowany względem hosta (działa w trybie zoneless).
4377
+ * do `body` (albo do otwartego `<dialog>`/popovera hosta, żeby był widoczny w warstwie szczytowej)
4378
+ * i pozycjonowany względem hosta (działa w trybie zoneless). Wygląd daje klasa `.kpt-tooltip`
4379
+ * z `@konce-pt/styles` w warstwie `kpt.components` — aplikacja nadpisuje ją bez `!important`.
4057
4380
  *
4058
4381
  * Dostępność:
4059
4382
  * - fokus łapiemy przez `focusin`/`focusout`, bo `focus`/`blur` nie bąbelkują — na
@@ -4070,7 +4393,7 @@ type KptTooltipPosition = 'top' | 'bottom' | 'left' | 'right';
4070
4393
  * @example Dymek tylko wtedy, gdy tekst nie mieści się w elemencie:
4071
4394
  * <span class="ellipsis" [kptTooltip]="name" kptTooltipOnlyWhenTruncated>{{ name }}</span>
4072
4395
  */
4073
- declare class KptTooltip implements OnDestroy {
4396
+ declare class KptTooltip {
4074
4397
  readonly text: _angular_core.InputSignal<string>;
4075
4398
  readonly position: _angular_core.InputSignal<KptTooltipPosition>;
4076
4399
  readonly onlyWhenTruncated: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -4082,13 +4405,16 @@ declare class KptTooltip implements OnDestroy {
4082
4405
  /** Element, któremu dopisaliśmy `aria-describedby` — żeby go potem zdjąć. */
4083
4406
  private describedEl?;
4084
4407
  private hideTimer?;
4408
+ private showTimer?;
4085
4409
  private readonly follow;
4086
4410
  private readonly onKeydown;
4087
4411
  constructor();
4412
+ protected scheduleShow(): void;
4088
4413
  protected show(): void;
4089
4414
  /** Fokus przeszedł do innego elementu w obrębie hosta — dymek zostaje. */
4090
4415
  protected onFocusOut(event: FocusEvent): void;
4091
4416
  protected scheduleHide(): void;
4417
+ private cancelShow;
4092
4418
  private cancelHide;
4093
4419
  protected hide(): void;
4094
4420
  /** Trwały opis dla czytników albo jego usunięcie, gdy nie jest potrzebny. */
@@ -4099,7 +4425,6 @@ declare class KptTooltip implements OnDestroy {
4099
4425
  private focusTarget;
4100
4426
  private isTruncated;
4101
4427
  private reposition;
4102
- ngOnDestroy(): void;
4103
4428
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptTooltip, never>;
4104
4429
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KptTooltip, "[kptTooltip]", never, { "text": { "alias": "kptTooltip"; "required": true; "isSignal": true; }; "position": { "alias": "kptTooltipPosition"; "required": false; "isSignal": true; }; "onlyWhenTruncated": { "alias": "kptTooltipOnlyWhenTruncated"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
4105
4430
  }
@@ -4122,7 +4447,9 @@ declare class KptTooltip implements OnDestroy {
4122
4447
  */
4123
4448
  declare class KptPopover {
4124
4449
  /** Preferowana strona dymka; gdy brakuje miejsca, CDK przerzuca go na drugą. */
4125
- readonly placement: _angular_core.InputSignal<"bottom" | "top">;
4450
+ readonly placement: _angular_core.InputSignal<"top" | "bottom">;
4451
+ /** Nazwa panelu (`role="dialog"`) — okno bez nazwy czytnik ogłasza jako samo „okno dialogowe”. */
4452
+ readonly ariaLabel: _angular_core.InputSignal<string>;
4126
4453
  /** Czy dymek jest otwarty (dwukierunkowe) — aplikacja może go zamknąć z kodu. */
4127
4454
  readonly open: _angular_core.ModelSignal<boolean>;
4128
4455
  private readonly host;
@@ -4137,7 +4464,7 @@ declare class KptPopover {
4137
4464
  protected onAttach(): void;
4138
4465
  private control;
4139
4466
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptPopover, never>;
4140
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPopover, "kpt-popover", never, { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[kptPopoverTrigger]", "*"], true, never>;
4467
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPopover, "kpt-popover", never, { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[kptPopoverTrigger]", "*"], true, never>;
4141
4468
  }
4142
4469
 
4143
4470
  /** Z której strony triggera wychodzi karta. */
@@ -4191,6 +4518,7 @@ declare class KptPeek {
4191
4518
  readonly panelId: string;
4192
4519
  private readonly panel;
4193
4520
  private readonly host;
4521
+ private readonly injector;
4194
4522
  private readonly open;
4195
4523
  /** Przypięta karta zostaje po zjeździe kursora — przypina ją klik, Enter albo dotyk. */
4196
4524
  private readonly pinnedState;
@@ -4209,6 +4537,12 @@ declare class KptPeek {
4209
4537
  focusOut(): void;
4210
4538
  /** Klik, Enter albo dotyk: karta zostaje i przyjmuje fokus. */
4211
4539
  pin(): void;
4540
+ /**
4541
+ * Escape na wyzwalaczu: karta otwarta najechaniem albo fokusem musi dać się odprawić bez
4542
+ * przenoszenia fokusu (WCAG 1.4.13 — treść na hover/focus ma być „dismissible”). Zamknięta karta
4543
+ * przepuszcza klawisz dalej, żeby Escape nadal zamykał otaczające okno.
4544
+ */
4545
+ escapeFromTrigger(event: Event): void;
4212
4546
  /** Escape: zamyka i oddaje fokus tam, skąd karta wyszła. */
4213
4547
  dismiss(): void;
4214
4548
  close(): void;
@@ -4226,8 +4560,8 @@ declare class KptPeek {
4226
4560
  * kartę podglądu z resztą powiązań. Treść karty daje aplikacja przez projekcję: biblioteka
4227
4561
  * nie wie, czym jest wzmiankowana rzecz, a osoba, zadanie i dokument wyglądają inaczej.
4228
4562
  *
4229
- * Bez rzutowanej treści wzmianka zostaje samym napisem z podkreśleniem: nie ma czego pokazać,
4230
- * więc trigger nie udaje, że coś się pod nim kryje.
4563
+ * Karta to rzutowana treść. Wzmianka bez karty (np. osoba spoza katalogu) powinna dostać
4564
+ * `disabled` — wtedy zostaje samym napisem z podkreśleniem, bez przycisku otwierającego pustą kartę.
4231
4565
  *
4232
4566
  * Trigger jest `<button>`, a nie `<span>`: karta otwiera się też z klawiatury i dotyku
4233
4567
  * (przypięcie), a to wymaga elementu, na który da się wejść Tabem. Z `href` staje się linkiem,
@@ -4312,6 +4646,8 @@ declare class KptAutocomplete implements FormValueControl<string> {
4312
4646
  readonly placeholder: _angular_core.InputSignal<string>;
4313
4647
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4314
4648
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4649
+ /** Tylko do odczytu (także z `readonly()` w schemacie) — wartość widać, podpowiedzi się nie otwierają. */
4650
+ readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
4315
4651
  /** Id natywnego pola; bez niego generowane (w `kpt-form-field` — `controlId` wrappera). */
4316
4652
  readonly id: _angular_core.InputSignal<string | null>;
4317
4653
  /** Nazwa dostępna, gdy pola nie opisuje `<label for>`. */
@@ -4341,7 +4677,7 @@ declare class KptAutocomplete implements FormValueControl<string> {
4341
4677
  protected pick(opt: string): void;
4342
4678
  protected onKeydown(event: KeyboardEvent): void;
4343
4679
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptAutocomplete, never>;
4344
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAutocomplete, "kpt-autocomplete", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
4680
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptAutocomplete, "kpt-autocomplete", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "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>;
4345
4681
  }
4346
4682
 
4347
4683
  type KptDrawerPosition = 'left' | 'right' | 'top' | 'bottom';
@@ -4357,19 +4693,25 @@ declare class KptDrawer {
4357
4693
  readonly open: _angular_core.ModelSignal<boolean>;
4358
4694
  readonly position: _angular_core.InputSignal<KptDrawerPosition>;
4359
4695
  readonly header: _angular_core.InputSignal<string>;
4696
+ /**
4697
+ * Nazwa panelu bez `header` — okno dialogowe bez nazwy czytnik ogłasza jako samo „okno
4698
+ * dialogowe” (WCAG 4.1.2). Z nagłówkiem nazwą jest nagłówek (`aria-labelledby`).
4699
+ */
4700
+ readonly ariaLabel: _angular_core.InputSignal<string>;
4360
4701
  readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
4361
4702
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
4362
4703
  protected readonly i18n: KptI18n;
4363
4704
  protected readonly titleId: string;
4364
4705
  private readonly panel;
4365
4706
  private readonly modalFocus;
4707
+ private releaseScroll;
4366
4708
  constructor();
4367
4709
  /** `Escape` zamyka tylko panel, który da się zamknąć — jak `×`. */
4368
4710
  protected onEscape(): void;
4369
4711
  protected onBackdrop(): void;
4370
4712
  protected close(): void;
4371
4713
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDrawer, never>;
4372
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDrawer, "kpt-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
4714
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptDrawer, "kpt-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
4373
4715
  }
4374
4716
 
4375
4717
  /**
@@ -4394,9 +4736,12 @@ declare class KptContextMenu<T = unknown> {
4394
4736
  protected readonly y: _angular_core.WritableSignal<number>;
4395
4737
  private readonly injector;
4396
4738
  private readonly panel;
4739
+ private readonly layer;
4397
4740
  /** Element, który miał fokus przed otwarciem — tam fokus wraca po zamknięciu. */
4398
4741
  private returnTo;
4742
+ constructor();
4399
4743
  protected onContext(event: MouseEvent): void;
4744
+ private unlisten;
4400
4745
  protected onPanelKeydown(event: KeyboardEvent): void;
4401
4746
  protected close(): void;
4402
4747
  protected pick(item: KptMenuItem<T>): void;
@@ -4426,6 +4771,9 @@ declare class KptMenubar<T = unknown> {
4426
4771
  /** Nazwa belki dla czytników ekranu, np. „Menu edytora”. */
4427
4772
  readonly ariaLabel: _angular_core.InputSignal<string>;
4428
4773
  readonly selected: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
4774
+ /** Zwykły klik w pozycję z `url` — hak dla routera aplikacji (patrz `KptNavigateEvent`). */
4775
+ readonly navigate: _angular_core.OutputEmitterRef<KptNavigateEvent<KptMenuItem<T>>>;
4776
+ protected onLink(event: MouseEvent, item: KptMenuItem<T>): void;
4429
4777
  protected readonly openIndex: _angular_core.WritableSignal<number | null>;
4430
4778
  /** Ostatnio skupiona pozycja górna — ona jest przystankiem Tab belki. */
4431
4779
  protected readonly focusIndex: _angular_core.WritableSignal<number>;
@@ -4461,7 +4809,7 @@ declare class KptMenubar<T = unknown> {
4461
4809
  /** Fokus wraca na pozycję górną — inaczej po zniknięciu pod-menu spadłby na `<body>`. */
4462
4810
  private closeAndFocusTop;
4463
4811
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMenubar<any>, never>;
4464
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMenubar<any>, "kpt-menubar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "selected": "selected"; }, never, never, true, never>;
4812
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMenubar<any>, "kpt-menubar", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "navigate": "navigate"; }, never, never, true, never>;
4465
4813
  }
4466
4814
 
4467
4815
  /**
@@ -4487,6 +4835,9 @@ declare class KptMegamenu<T = unknown> {
4487
4835
  /** Nazwa belki dla czytników ekranu, np. „Menu główne”. */
4488
4836
  readonly ariaLabel: _angular_core.InputSignal<string>;
4489
4837
  readonly selected: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
4838
+ /** Zwykły klik w pozycję z `url` — hak dla routera aplikacji (patrz `KptNavigateEvent`). */
4839
+ readonly navigate: _angular_core.OutputEmitterRef<KptNavigateEvent<KptMenuItem<T>>>;
4840
+ protected onLink(event: MouseEvent, item: KptMenuItem<T>): void;
4490
4841
  protected readonly openIndex: _angular_core.WritableSignal<number | null>;
4491
4842
  /** Ostatnio skupiona pozycja górna — ona jest przystankiem Tab belki. */
4492
4843
  protected readonly focusIndex: _angular_core.WritableSignal<number>;
@@ -4521,7 +4872,7 @@ declare class KptMegamenu<T = unknown> {
4521
4872
  private openAt;
4522
4873
  private focusTop;
4523
4874
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMegamenu<any>, never>;
4524
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMegamenu<any>, "kpt-megamenu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "selected": "selected"; }, never, never, true, never>;
4875
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMegamenu<any>, "kpt-megamenu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "navigate": "navigate"; }, never, never, true, never>;
4525
4876
  }
4526
4877
 
4527
4878
  interface KptConfirmOptions {
@@ -4541,6 +4892,10 @@ interface KptConfirmRequest extends KptConfirmOptions {
4541
4892
  * Serwis potwierdzeń. Wstrzyknij i wywołaj `confirm(...)` (zwraca Promise<boolean>);
4542
4893
  * umieść `<kpt-confirm-container />` raz w aplikacji.
4543
4894
  *
4895
+ * Jedno żądanie naraz: kolejne wywołanie przy otwartym oknie odrzuca poprzednie (`false`), żeby
4896
+ * jego obietnica nigdy nie została nierozstrzygnięta — czekający `await` wisiałby inaczej na zawsze.
4897
+ * Tak samo działa `kptConfirm` w porcie React.
4898
+ *
4544
4899
  * @example
4545
4900
  * if (await confirm.confirm({ message: 'Usunąć rekord?', variant: 'danger' })) { ... }
4546
4901
  */
@@ -4548,7 +4903,11 @@ declare class KptConfirmService {
4548
4903
  private readonly _current;
4549
4904
  readonly current: _angular_core.Signal<KptConfirmRequest | null>;
4550
4905
  private seq;
4906
+ /** Liczba zamontowanych kontenerów — bez żadnego obietnica nie miałaby kto rozstrzygnąć. */
4907
+ private containers;
4551
4908
  confirm(options: KptConfirmOptions): Promise<boolean>;
4909
+ /** Rejestracja kontenera; zwraca funkcję wyrejestrowania. Woła ją `KptConfirmContainer`. */
4910
+ attachContainer(): () => void;
4552
4911
  accept(): void;
4553
4912
  reject(): void;
4554
4913
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptConfirmService, never>;
@@ -4587,16 +4946,22 @@ declare class KptConfirmContainer {
4587
4946
  declare class KptBottomSheet {
4588
4947
  readonly open: _angular_core.ModelSignal<boolean>;
4589
4948
  readonly header: _angular_core.InputSignal<string>;
4949
+ /**
4950
+ * Nazwa panelu bez `header` — okno dialogowe bez nazwy czytnik ogłasza jako samo „okno
4951
+ * dialogowe” (WCAG 4.1.2). Z nagłówkiem nazwą jest nagłówek (`aria-labelledby`).
4952
+ */
4953
+ readonly ariaLabel: _angular_core.InputSignal<string>;
4590
4954
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
4591
4955
  protected readonly i18n: KptI18n;
4592
4956
  protected readonly titleId: string;
4593
4957
  private readonly panel;
4594
4958
  private readonly modalFocus;
4959
+ private releaseScroll;
4595
4960
  constructor();
4596
4961
  protected onBackdrop(): void;
4597
4962
  protected close(): void;
4598
4963
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBottomSheet, never>;
4599
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBottomSheet, "kpt-bottom-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
4964
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBottomSheet, "kpt-bottom-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
4600
4965
  }
4601
4966
 
4602
4967
  type KptSpeedDialDirection = 'up' | 'down' | 'left' | 'right';
@@ -4628,5 +4993,5 @@ declare class KptSpeedDial<T = unknown> {
4628
4993
  }
4629
4994
 
4630
4995
  export { KPT_BREAKPOINTS, KPT_FORM_FIELD, KPT_FORM_FIELD_CONTROL, KPT_I18N_CONFIG, KptAccordion, KptAccordionPanel, KptAlert, KptAppShell, KptAuth, KptAuthProviderDef, KptAutocomplete, KptAvatar, KptAvatarGroup, KptBackdrop, 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, KptMention, KptMentions, KptMenu, KptMenubar, KptMeterGroup, KptOrderList, KptPaginator, KptPanel, KptPassword, KptPeek, KptPeekTrigger, 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, kptFieldA11y, provideKptI18n, provideKptIcons };
4631
- export type { KptAlertVariant, KptAuthLayout, KptAuthMode, KptAuthProvider, KptAuthProviderLayout, KptAuthResetValue, KptAuthSignInValue, KptAuthSignUpValue, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeSize, KptBadgeVariant, KptBreadcrumbItem, KptBreakpoint, KptButtonSize, KptButtonVariant, KptCardHeadingLevel, KptCardVariant, KptCellEditEvent, KptChipTextTransform, KptChipVariant, KptColorPreset, KptColumn, KptColumnEdit, KptColumnEditType, KptConfirmOptions, KptConfirmRequest, KptDatepickerMode, KptDatepickerView, KptDialogSize, KptDividerOrientation, KptDrawerPosition, KptFieldA11y, KptFormFieldContext, KptFormFieldControl, KptGalleriaItem, KptInputType, KptMenuItem, KptMeterItem, KptOption, KptPeekPlacement, KptProgressLabelPosition, KptProgressSize, KptProgressType, KptProgressValueFormat, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitButtonVariant, KptSplitterOrientation, KptTableLazyState, KptTimelineItem, KptToast, KptToastAction, KptToastOptions, KptTooltipPosition, KptTreeNode };
4996
+ export type { KptAlertVariant, KptAuthLayout, KptAuthMode, KptAuthProvider, KptAuthProviderLayout, KptAuthResetValue, KptAuthSignInValue, KptAuthSignUpValue, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeSize, KptBadgeVariant, KptBreadcrumbItem, KptBreakpoint, KptButtonSize, KptButtonVariant, KptCardHeadingLevel, KptCardVariant, KptCellEditEvent, KptChipTextTransform, KptChipVariant, KptColorPreset, KptColumn, KptColumnEdit, KptColumnEditType, KptConfirmOptions, KptConfirmRequest, KptDatepickerMode, KptDatepickerView, KptDialogSize, KptDividerOrientation, KptDrawerPosition, KptFieldA11y, KptFormFieldContext, KptFormFieldControl, KptGalleriaItem, KptInputType, KptMenuItem, KptMeterItem, KptNavigateEvent, KptOption, KptPeekPlacement, KptProgressLabelPosition, KptProgressSize, KptProgressType, KptProgressValueFormat, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitButtonVariant, KptSplitterOrientation, KptTableLazyState, KptTimelineItem, KptToast, KptToastAction, KptToastOptions, KptTooltipPosition, KptTreeNode };
4632
4997
  //# sourceMappingURL=konce-pt-angular.d.ts.map