@konce-pt/angular 0.11.2 → 0.14.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 (116) hide show
  1. package/CHANGELOG.md +792 -333
  2. package/README.md +111 -55
  3. package/charts/src/lib/llms.txt +23 -15
  4. package/chat/src/lib/llms.txt +68 -33
  5. package/fesm2022/konce-pt-angular-charts.mjs +149 -68
  6. package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
  7. package/fesm2022/konce-pt-angular-chat.mjs +296 -135
  8. package/fesm2022/konce-pt-angular-chat.mjs.map +1 -1
  9. package/fesm2022/konce-pt-angular-grid.mjs +16 -16
  10. package/fesm2022/konce-pt-angular-grid.mjs.map +1 -1
  11. package/fesm2022/konce-pt-angular-icons.mjs +5 -5
  12. package/fesm2022/konce-pt-angular-icons.mjs.map +1 -1
  13. package/fesm2022/konce-pt-angular-map.mjs +360 -293
  14. package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
  15. package/fesm2022/konce-pt-angular-roadmap.mjs +120 -34
  16. package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
  17. package/fesm2022/konce-pt-angular.mjs +7117 -3373
  18. package/fesm2022/konce-pt-angular.mjs.map +1 -1
  19. package/grid/src/lib/llms.txt +18 -18
  20. package/map/src/lib/llms.txt +142 -140
  21. package/package.json +14 -12
  22. package/roadmap/src/lib/llms.txt +37 -27
  23. package/src/lib/accordion/llms.txt +18 -6
  24. package/src/lib/alert/llms.txt +5 -4
  25. package/src/lib/app-shell/llms.txt +25 -22
  26. package/src/lib/auth/llms.txt +26 -22
  27. package/src/lib/autocomplete/llms.txt +18 -4
  28. package/src/lib/avatar/llms.txt +3 -3
  29. package/src/lib/avatar-group/llms.txt +5 -5
  30. package/src/lib/backdrop/llms.txt +35 -35
  31. package/src/lib/badge/llms.txt +7 -7
  32. package/src/lib/bottom-sheet/llms.txt +6 -3
  33. package/src/lib/breadcrumb/llms.txt +9 -1
  34. package/src/lib/breakpoint/llms.txt +8 -8
  35. package/src/lib/button/llms.txt +26 -18
  36. package/src/lib/button-group/llms.txt +40 -31
  37. package/src/lib/card/llms.txt +19 -19
  38. package/src/lib/carousel/llms.txt +6 -6
  39. package/src/lib/checkbox/llms.txt +17 -2
  40. package/src/lib/chip/llms.txt +6 -6
  41. package/src/lib/chips-input/llms.txt +14 -4
  42. package/src/lib/color-picker/llms.txt +7 -4
  43. package/src/lib/confirm/llms.txt +9 -3
  44. package/src/lib/context-menu/llms.txt +7 -4
  45. package/src/lib/data-table/llms.txt +280 -227
  46. package/src/lib/data-view/llms.txt +25 -4
  47. package/src/lib/date-range/llms.txt +37 -18
  48. package/src/lib/datepicker/llms.txt +46 -29
  49. package/src/lib/dialog/llms.txt +29 -26
  50. package/src/lib/divider/llms.txt +2 -1
  51. package/src/lib/drawer/llms.txt +9 -6
  52. package/src/lib/empty/llms.txt +4 -4
  53. package/src/lib/fab/llms.txt +6 -2
  54. package/src/lib/fieldset/llms.txt +22 -4
  55. package/src/lib/file-upload/llms.txt +3 -0
  56. package/src/lib/form-field/llms.txt +33 -19
  57. package/src/lib/galleria/llms.txt +3 -3
  58. package/src/lib/i18n/llms.txt +15 -8
  59. package/src/lib/icon/llms.txt +9 -9
  60. package/src/lib/icon-button/llms.txt +8 -3
  61. package/src/lib/image/llms.txt +4 -4
  62. package/src/lib/input/llms.txt +21 -7
  63. package/src/lib/input-mask/llms.txt +5 -2
  64. package/src/lib/input-number/llms.txt +18 -15
  65. package/src/lib/input-otp/llms.txt +15 -4
  66. package/src/lib/knob/llms.txt +14 -7
  67. package/src/lib/listbox/llms.txt +8 -5
  68. package/src/lib/loader/llms.txt +72 -0
  69. package/src/lib/megamenu/llms.txt +16 -5
  70. package/src/lib/mention/llms.txt +15 -15
  71. package/src/lib/menu/llms.txt +12 -12
  72. package/src/lib/menubar/llms.txt +16 -5
  73. package/src/lib/meter-group/llms.txt +7 -7
  74. package/src/lib/order-list/llms.txt +20 -5
  75. package/src/lib/paginator/llms.txt +5 -5
  76. package/src/lib/panel/llms.txt +20 -8
  77. package/src/lib/password/llms.txt +17 -5
  78. package/src/lib/peek/llms.txt +11 -11
  79. package/src/lib/pick-list/llms.txt +28 -5
  80. package/src/lib/popover/llms.txt +9 -6
  81. package/src/lib/progress/llms.txt +16 -16
  82. package/src/lib/radio-group/llms.txt +13 -3
  83. package/src/lib/rating/llms.txt +13 -6
  84. package/src/lib/rich-text/llms.txt +42 -24
  85. package/src/lib/scroll-top/llms.txt +3 -3
  86. package/src/lib/select/llms.txt +23 -13
  87. package/src/lib/sidenav/llms.txt +8 -8
  88. package/src/lib/slider/llms.txt +23 -7
  89. package/src/lib/speech/llms.txt +108 -0
  90. package/src/lib/speed-dial/llms.txt +9 -3
  91. package/src/lib/spinner/llms.txt +2 -2
  92. package/src/lib/split-button/llms.txt +14 -8
  93. package/src/lib/splitter/llms.txt +8 -8
  94. package/src/lib/stepper/llms.txt +26 -7
  95. package/src/lib/switch/llms.txt +13 -3
  96. package/src/lib/switch-group/llms.txt +12 -9
  97. package/src/lib/tabs/llms.txt +7 -4
  98. package/src/lib/textarea/llms.txt +16 -5
  99. package/src/lib/timeline/llms.txt +1 -1
  100. package/src/lib/toast/llms.txt +36 -5
  101. package/src/lib/toolbar/llms.txt +3 -3
  102. package/src/lib/tooltip/llms.txt +13 -10
  103. package/src/lib/tree/llms.txt +19 -5
  104. package/src/lib/update/llms.txt +52 -0
  105. package/types/konce-pt-angular-charts.d.ts +11 -0
  106. package/types/konce-pt-angular-charts.d.ts.map +1 -1
  107. package/types/konce-pt-angular-chat.d.ts +98 -40
  108. package/types/konce-pt-angular-chat.d.ts.map +1 -1
  109. package/types/konce-pt-angular-grid.d.ts +14 -14
  110. package/types/konce-pt-angular-icons.d.ts +3 -3
  111. package/types/konce-pt-angular-map.d.ts +147 -119
  112. package/types/konce-pt-angular-map.d.ts.map +1 -1
  113. package/types/konce-pt-angular-roadmap.d.ts +34 -9
  114. package/types/konce-pt-angular-roadmap.d.ts.map +1 -1
  115. package/types/konce-pt-angular.d.ts +1774 -651
  116. package/types/konce-pt-angular.d.ts.map +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,464 @@
1
1
  # @konce-pt/angular
2
2
 
3
+ ## 0.14.0
4
+
5
+ ### Minor Changes
6
+
7
+ - de1ccc9: Ruch w sekcji "Przyciski" (oba porty, wspólny SCSS): `kpt-button`, `kpt-icon-button`, `kpt-fab`,
8
+ `kpt-split-button` i akcje `kpt-speed-dial` zgniatają się przy wciśnięciu i odbijają przy puszczeniu
9
+ (mixin `styles/_press.scss`); spinner ładowania wskakuje w miejsce ikony. `link` się nie zgniata (kolor, podkreślenie, przygaszenie),
10
+ `elevated` dociska cień przy wciśnięciu. Poprawka: wciśnięte `elevated`, `link` i warianty statusów
11
+ dostawały ciemne tło wciśnięcia wariantu `filled` - teraz biorą kolor hover własnego wariantu. `kpt-button-group`: tło wyboru
12
+ przejeżdża na nową pozycję na sprężynie (`playIndicatorMotion` w `@konce-pt/motion`, za `toggle`).
13
+ `kpt-speed-dial`: akcje wysuwają się kaskadą i chowają w odwrotnej kolejności. `kpt-split-button`:
14
+ strzałka obraca się przy otwarciu, menu wysuwa się spod przycisku.
15
+ - 6a1d594: `kpt-data-table` z `virtualScroll` wirtualizuje teraz wiersze i kolumny - 20 000 wierszy x 100 kolumn
16
+ trzyma w DOM-ie kilkaset komórek. Tryb wirtualny przechodzi na `table-layout: fixed`: szerokości kolumn
17
+ bez `width` w `px`/`rem`/`em` bierze nowe wejście `columnWidth` (domyślnie `10rem`). Wyszukiwanie globalne
18
+ na dużych zbiorach ma indeks rozgrzewany w tle i debounce, zaznaczanie i rozwijanie działa na `Set`
19
+ kluczy, a separator kolumn zamrożonych nie zostawia już kresek przy przewijaniu w poziomie.
20
+
21
+ `@konce-pt/table`: `createGlobalFilter` (z `prepare`), `sortRows`, `virtualRange`, `columnOffsets`,
22
+ `virtualColumnRange` i szybka ścieżka ASCII w `foldText`.
23
+
24
+ `@konce-pt/react`: `KptDataTable` dostaje to samo - wirtualizację wierszy i kolumn z `columnWidth`, odczyt
25
+ przewinięcia raz na klatkę (render tylko przy zmianie okna), indeks wyszukiwania z debounce, `sortRows`
26
+ i zaznaczanie na `Set`.
27
+
28
+ - 6a1d594: `kpt-data-table`: nowe wejście `frozenSystemColumns` przykleja kolumny zaznaczania i rozwijania do lewej
29
+ krawędzi także wtedy, gdy żadna kolumna danych nie jest `frozen` - checkboxy zostają pod ręką, a wszystkie
30
+ dane przewijają się w poziomie. W trybie wirtualnym okno kolumn liczy się od faktycznej krawędzi
31
+ przyklejonej części.
32
+ - 33b47cc: `kpt-fieldset`: wariant `variant="filled"` - grupa na własnym tle powierzchni (np. sekcje w szarym
33
+ panelu). Legenda bierze tło grupy i ma zaokrąglone końce, więc w miejscu, gdzie przecina ramkę,
34
+ nie rozpada się na pasek w dwóch kolorach.
35
+ - 46b6c13: Nowe komponenty `kpt-loader` / `KptLoader` i `kpt-update` / `KptUpdate`.
36
+
37
+ `kpt-loader` to loader z charakterem w sześciu wariantach (`bubbles`, `bridge`, `shapes`, `ring`,
38
+ `wave`, `bounce`), który po `status` `success` albo `error` gra krótki wynik i zostawia znak zamiast
39
+ znikać. `ring` i `wave` rysują postęp (`value` / `min` / `max`), `ring` przyjmuje ikonę w środku.
40
+ W pełni konfigurowalny: `size` (wspólna skala rysunku), `colors` (role motywu albo kolory CSS),
41
+ `successColor`, `errorColor`, `speed`, napisy `label` / `successLabel` / `errorLabel` idące za językiem
42
+ na żywo, `announce` i zdarzenie `settled` / `onSettled`. Wersja z ograniczonym ruchem przy
43
+ `prefers-reduced-motion` i `provideKptMotion({ enabled: false })`.
44
+
45
+ `kpt-update` to wiersz aktualizacji aplikacji zbudowany na pierścieniu: nazwa, linia stanu z bajtami
46
+ ("0,4 MB z 24 MB"), przycisk idący za stanem (`pending`, `downloading`, `success`, `error`) i zdarzenie
47
+ `action` / `onAction`. Napisy przenikają się przy zmianie stanu.
48
+
49
+ Rdzeń w `@konce-pt/motion`: geometria i fizyka wariantów z testami (`loader.ts`) oraz wspólna dla
50
+ portów warstwa DOM `createLoader`, `swapText`, `setText`. `@konce-pt/i18n` dostaje słowniki
51
+ `loader.*` i `update.*` (EN, PL) oraz `formatBytes` / `byteUnitOf`.
52
+
53
+ - 653e5f9: Ruch w Koncept UI ma jedno ustawienie dla całej aplikacji: `provideKptMotion({ enabled, layout })`
54
+ w Angularze i `<KptMotionProvider enabled layout>` w Reakcie. `enabled: false` wyłącza przejścia CSS
55
+ wszystkich komponentów (atrybut `data-kpt-motion="off"` i mnożnik `--kpt-motion-scale` na `:root`),
56
+ a wskaźniki ładowania zwalniają zamiast stanąć. Czasy wpisane w komponentach idą teraz przez
57
+ `calc(<czas> * var(--kpt-motion-scale, 1))` - bez konfiguracji nic się nie zmienia.
58
+
59
+ `kpt-data-view` / `KptDataView` dostaje `layoutMotion`: `spring` (domyślnie), `arc`, `morph` (View
60
+ Transitions) albo `none` - animowana zmiana układu i gęstości z paska, z kontr-skalowaną treścią
61
+ i obsługą przerwania w trakcie lotu. Treść elementu siedzi teraz w `.kpt-data-view__body`.
62
+
63
+ `kpt-pick-list` / `KptPickList` dostaje ten sam `layoutMotion` dla przenoszenia i przestawiania:
64
+ wiersz przechodzący na drugą listę leci nad panelami, sąsiedzi domykają lukę, a lista docelowa
65
+ przewija się do miejsca lądowania.
66
+
67
+ `kpt-accordion`, `kpt-fieldset` i `kpt-panel` (oba porty) dostają `collapseMotion`: `spring`
68
+ (domyślnie - wysokość na sprężynie, treść wjeżdża z rozmycia, przy zwijaniu najpierw gaśnie),
69
+ `fade` albo `none`, z domyślną wartością w `provideKptMotion({ collapse })`. Strzałka w fieldsecie
70
+ i panelu jest teraz jedną ikoną obracaną zamiast podmiany `chevron-down`/`chevron-up`.
71
+
72
+ `kpt-order-list` dostaje `layoutMotion` (przestawiana pozycja leci nad sąsiadami), `kpt-tree` -
73
+ `collapseMotion` (gałąź rozwija się z kaskadą dzieci, zwijana zostaje w DOM jako `inert` na czas
74
+ animacji). Czat (`kpt-chat`, `kpt-chat-message`, `kpt-chat-dock`, oba porty) dostaje `enterMotion`
75
+ z domyślną wartością w `provideKptMotion({ enter })`: nowa wiadomość wyrasta od pola pisania albo od
76
+ strony nadawcy, reakcja wskakuje, licznik i status zmieniają się jak na bębnie, okno docka wyrasta
77
+ z przycisku. Kropki pisania przy wyłączonym ruchu pulsują wolniej zamiast stanąć.
78
+
79
+ Formularze: `kpt-form-field` (oba porty) dostaje `enterMotion` - komunikat i błąd wjeżdżają z rozmycia
80
+ przy każdej zmianie, kontrolka potrząsa się przy przejściu w błąd, etykieta float unosi się na sprężynie.
81
+ Powierzchnia każdej kontrolki z grupy "Formularze" (ramka, fokus, tło) zmienia się teraz płynnie
82
+ (wspólny mixin `styles/_field-motion.scss`).
83
+
84
+ `kpt-checkbox`, `kpt-radio-group` i `kpt-switch` (oba porty) dostają `toggleMotion` z domyślną wartością
85
+ w `provideKptMotion({ toggle })`: pole wskakuje, ptaszek rysuje się kreską, kropka radia wskakuje na
86
+ sprężynie, kciuk przełącznika jedzie na sprężynie i rozciąga się w ruchu.
87
+
88
+ `kpt-rating` (oba porty) da się przeciągać po gwiazdkach - myszą i palcem, z połówkami i RTL - a zapalane
89
+ gwiazdki wskakują. `kpt-knob` i `kpt-slider` reagują na chwycenie: kursor `grabbing`, powiększenie
90
+ i poświata uchwytu. Kliknięcie w tor `kpt-slider` przesuwa uchwyt i wypełnienie płynnie zamiast przeskoczyć
91
+ (pojedynczy suwak rysuje teraz tor, wypełnienie i uchwyt obok przezroczystego natywnego inputu). Checkbox przechodzący w błąd
92
+ dostaje pierścień w kolorze błędu i krótkie potrząśnięcie (w błędnym `kpt-form-field` sam pierścień).
93
+
94
+ Nowa paczka `@konce-pt/motion`: krzywe sprężyn do `linear()`, plany lotów FLIP i reguła
95
+ pierwszeństwa konfiguracji, czysty TS z testami.
96
+
97
+ `kpt-password` (oba porty): miernik siły wjeżdża, segmenty wypełniają się falą w kolorze oceny, podpis
98
+ wjeżdża przy każdej zmianie, a przejście w błąd daje pierścień i potrząśnięcie pola (za `enter`).
99
+
100
+ `kpt-chips-input` (oba porty): dodany tag wskakuje, usunięty gaśnie w miejscu, a reszta i pole dosuwają
101
+ się na sprężynie (`prepareFlowMotion` w `@konce-pt/motion`, za `enter`). To samo chipy `kpt-select multiple`
102
+ (pozycję zmiany liczy `flowChangeOf`).
103
+
104
+ - feb9f88: `kpt-slider` w trybie `range`: kliknięcie toru obok uchwytów - przed zakresem, za nim albo w środku -
105
+ przesuwa w to miejsce najbliższy uchwyt, daje mu fokus i ciągnie go do puszczenia przycisku. Dotąd
106
+ tor zakresu nie reagował, bo nałożone inputy łapały wskaźnik tylko kciukami. Zakres rysuje tor,
107
+ pasek i uchwyty tak jak pojedynczy suwak, więc skok po kliknięciu jedzie płynnie, a dwa uchwyty
108
+ dosunięte do maksimum da się z powrotem rozsunąć.
109
+ - 6ce3e24: `kpt-speech-button`: dyktowanie przyciskiem mikrofonu na Web Speech API. Klik zamienia ikonę
110
+ w "stop", obok wjeżdża animowana fala (`kpt-speech-wave` - poziom głosu z mikrofonu na desktopie,
111
+ animacja CSS na telefonach), a słowa płyną na żywo do celu: textarea, inputu, contenteditable,
112
+ zwykłego elementu albo funkcji. Tekst tymczasowy widać w polu, ale do modelu i Signal Forms trafia
113
+ wyłącznie zatwierdzony. Tryby `insert`, `append` i `replace` (czyszczenie pola w chwili startu),
114
+ jedna sesja na stronę, `flush()` przed wysyłką, stała nazwa z `aria-pressed` i region statusu bez
115
+ treści dyktowania. W trakcie nasłuchu "stop" i fala mają kolor motywu; `listeningColor` wybiera
116
+ inną rolę (`danger`, `success`, `warning`, `info`), a `--kpt-speech-color` i `--kpt-speech-on-color`
117
+ - dowolny kolor, także dla mikrofonów wbudowanych w pola.
118
+
119
+ Słownik dostaje grupę `speech` (EN i PL), a zestaw wbudowanych ikon - `microphone` i `player-stop`
120
+ (98 ikon).
121
+
122
+ - d9eefda: Pola z wbudowanym mikrofonem przyjmują kolor nasłuchu: `speechColor` w `kpt-input`, `kpt-textarea`,
123
+ `kpt-chat-composer`, `kpt-rich-text`, `kpt-autocomplete` i `kpt-map-search`, `filterSpeechColor`
124
+ w `kpt-data-table` oraz `searchSpeechColor` w `kpt-map` - w obu portach. Wartości jak
125
+ `listeningColor` przycisku (`primary`, `danger`, `success`, `warning`, `info`), domyślnie kolor motywu.
126
+ - b942f3e: `kpt-input`, `kpt-textarea` i `kpt-chat-composer` dostają wbudowany mikrofon: `speech` (z `speechLang`
127
+ i `speechMode`). W inpucie mikrofon stoi na końcu pola, w textarea w górnym rogu (dolny zostaje dla
128
+ uchwytu zmiany rozmiaru), w kompozytorze między polem a wysyłką - a Enter albo "Wyślij" w trakcie
129
+ dyktowania wysyła dokładnie to, co widać. Bez wsparcia przeglądarki mikrofon się nie pokazuje,
130
+ a pole nie rezerwuje na niego miejsca (`available()` na `kpt-speech-button`).
131
+
132
+ `@konce-pt/speech`: tekst tymczasowy w polu przeżywa przerysowanie pola przez framework (wraca
133
+ w następnej klatce), a zakres tymczasowy jest sprawdzany przed każdą podmianą - wstawka w środku
134
+ tekstu nie może już naruszyć znaków za kursorem.
135
+
136
+ - 6c93db6: `kpt-rich-text` dostaje narzędzie `dictate` (poza domyślnym paskiem): dyktowanie w miejsce kursora,
137
+ tekst zatwierdzony wchodzi przez `insertText` z natywnym undo, a tymczasowy jest nakładką przy kursorze
138
+ i nie trafia do HTML-a. Język ustawia `speechLang`. Widok źródła HTML i blokada pola przerywają
139
+ dyktowanie, a bez wsparcia przeglądarki narzędzia nie ma.
140
+
141
+ `kpt-icon-button` i `kpt-speech-button` dostają `tabIndex` - dla pasków z jednym przystankiem Tab.
142
+
143
+ - 5a89580: Wyszukiwanie głosem: `kpt-autocomplete` dostaje `speech` (domyślnie `speechMode="replace"` - podyktowana
144
+ wartość zastępuje poprzednią i otwiera podpowiedzi), `kpt-data-table` - `filterSpeech` przy filtrze
145
+ globalnym (pole filtra stoi teraz w `.kpt-data-table__search`), a `kpt-map-search` - `speech`, który
146
+ `kpt-map` przekazuje przez `searchSpeech`. Wyszukiwarki czyszczą się w chwili kliknięcia mikrofonu
147
+ i słuchają jednej wypowiedzi; słowa tymczasowe nie wywołują zapytań.
148
+ - 2a4b156: `kpt-stepper` (oba porty): zmiana kroku jako płynący kolor - linia nalewa się z szarego ze świecącą
149
+ kometą na czele, znacznik zalewa się i dostaje ptaszek dopiero, gdy dotrze do niego kolor, nowy krok
150
+ wypuszcza falę i zostaje z poświatą; skok o kilka kroków przejeżdża odcinki po kolei. Treść wjeżdża od
151
+ strony ruchu z rozmycia, stara wychodzi jako duch, wysokość zmienia się płynnie. Nowe w `@konce-pt/motion`:
152
+ `stepperSchedule` i `stepperScheduleOptions` (z testami), `playStepperLight`, `preparePanelSwap`.
153
+ `animationDuration` ustawia tempo całego ruchu (treść i linia), nie tylko treści.
154
+
155
+ Poprawka (Angular): treść kroku nie animowała się wcale - `@for ... track activeIndex()` dawał staremu
156
+ i nowemu panelowi ten sam klucz, więc panel był używany ponownie zamiast tworzony na nowo.
157
+
158
+ - e95689f: Toasty: położenie, zamykanie bez X, pasek czasu i wariant wypełniony.
159
+
160
+ - `position` kontenera (`top-start`, `top-center`, `top-end`, `bottom-start`, `bottom-center`,
161
+ `bottom-end` - domyślny) i opcja `position` pojedynczego toastu. Każdy róg to osobny stos, najnowszy
162
+ toast stoi przy krawędzi i od niej wjeżdża; odstęp `--kpt-toast-offset` plus bezpieczny obszar telefonu.
163
+ - `closable: false` chowa przycisk zamknięcia. Toast bez X, bez akcji i z `duration: 0` dostaje 5000 ms,
164
+ bo inaczej nie dałoby się go zamknąć.
165
+ - `progress: true` - animowany pasek czasu, który staje razem z licznikiem pod wskaźnikiem i fokusem.
166
+ - `appearance: 'filled'` - całe tło w barwie wariantu, treść w `--kpt-color-<rola>-contrast`.
167
+ - Wartości domyślne całej aplikacji: `provideKptToast(...)` w Angularze, `kptToast.configure(...)`
168
+ w Reakcie.
169
+ - Ikona, tekst, akcja i X wyrównane do środka w pionie; przycisk zamknięcia ma cel kliknięcia 28 px.
170
+
171
+ ### Patch Changes
172
+
173
+ - e317715: Poprawki: panel `kpt-autocomplete` ma szerokość pola (wcześniej kurczył się do treści), a `<main>`
174
+ `kpt-app-shell` jest zarejestrowany jako `cdkScrollable` - otwarte nakładki jadą za przewijaną treścią.
175
+ - 6a1d594: `kpt-data-table`: etykieta wiersza podsumowania ("Razem") jest wyrównana do lewej, a przy kolumnach
176
+ zamrożonych kończy się na ich granicy - nie zmienia już szerokości przy przestawianiu kolumn i nie
177
+ zasłania kolumn przewijanych. Podpis tabeli (`caption`) ma wcięcie jak komórki i przy przewijaniu
178
+ w poziomie zostaje przy lewej krawędzi.
179
+
180
+ Kontrolki wiersza filtrów (pole tekstowe, liczba, zakres, select, zakres dat) mają jedną wysokość, a sam
181
+ wiersz trzyma ją przy przewijaniu w poziomie - wcześniej zapadał się, gdy w oknie kolumn nie było filtra.
182
+
183
+ Przyklejony nagłówek i kolumny zamrożone nie przepuszczają już treści przewijanych wierszy przy skali
184
+ ekranu innej niż 100% (`border-collapse: separate` i dokładna wysokość pierwszego wiersza nagłówka).
185
+
186
+ `@konce-pt/react`: zmiana propa `pageSize` w trakcie działania zmienia rozmiar strony (wcześniej liczył się tylko
187
+ pierwszy render) - tak jak w Angularze.
188
+
189
+ - a0cce5f: Port Reacta: `KptInput`, `KptTextarea` i `KptChatComposer` dostają wbudowany mikrofon - `speech`
190
+ (z `speechLang` i `speechMode` w polach). Ten sam układ i te same klasy co w Angularze: mikrofon na
191
+ końcu inputu, w górnym rogu textarea (pole stoi wtedy w `.kpt-textarea__box`), między polem a wysyłką
192
+ w kompozytorze, gdzie Enter albo "Wyślij" w trakcie dyktowania wysyła dokładnie widoczny tekst.
193
+ `useKptSpeechRecognition` dostaje opcję `enabled` - przy `false` nie tworzy sesji ani nasłuchów strony.
194
+
195
+ `.kpt-textarea__box` ma teraz `display: block` (w Angularze to `div`, więc bez zmian w wyglądzie).
196
+
197
+ - b76a98c: Teksty interfejsu w zapisie ASCII: wielokropek jako "..." (np. "Szukaj..."), zakresy z łącznikiem
198
+ ("1-10 z 100", "pn-pt", zakresy dat), zwykłe cudzysłowy w komunikatach. Przyciski przybliżania mapy
199
+ pokazują ikony plus/minus zamiast znaków. Dokumentacja (llms.txt) opisuje klawisze nazwami
200
+ (ArrowUp, ArrowLeft) zamiast strzałek. Skrót cytatu w czacie kończy się "...", nagłówek CSS z eksportu
201
+ motywu i komunikaty CLI nie mają znaków typograficznych ani symboli.
202
+ - Updated dependencies [de1ccc9]
203
+ - Updated dependencies [6a1d594]
204
+ - Updated dependencies [46b6c13]
205
+ - Updated dependencies [653e5f9]
206
+ - Updated dependencies [6ce3e24]
207
+ - Updated dependencies [936ef52]
208
+ - Updated dependencies [b942f3e]
209
+ - Updated dependencies [05b169e]
210
+ - Updated dependencies [2a4b156]
211
+ - Updated dependencies [b76a98c]
212
+ - @konce-pt/motion@0.14.0
213
+ - @konce-pt/table@0.14.0
214
+ - @konce-pt/i18n@0.14.0
215
+ - @konce-pt/icons@0.14.0
216
+ - @konce-pt/speech@0.14.0
217
+ - @konce-pt/datetime@0.14.0
218
+ - @konce-pt/map@0.14.0
219
+ - @konce-pt/roadmap@0.14.0
220
+ - @konce-pt/chat@0.14.0
221
+ - @konce-pt/backdrop@0.14.0
222
+ - @konce-pt/chart@0.14.0
223
+ - @konce-pt/mention@0.14.0
224
+
225
+ ## 0.12.0
226
+
227
+ ### Minor Changes
228
+
229
+ - 8b7ba94: `kpt-input-otp` / `KptInputOtp` dzieli pola na grupy: `groupSize` (co ile pól, od lewej)
230
+ i `groupSeparator` (domyślnie `-`). `[length]="9" groupSize="3"` daje `[][][]-[][][]-[][][]`.
231
+ Separator jest tylko wizualny - wartość to same znaki (`"123456789"`), pola zachowują nazwy
232
+ "Znak 4 z 9", a strzałki i Backspace przeskakują separator.
233
+ - 5570297: `kpt-breadcrumb`, `kpt-menubar` i `kpt-megamenu` mają output `navigate` (w React prop `onNavigate`),
234
+ który daje haczyk dla routera aplikacji. Odnośniki to zwykłe `<a href>`, więc w aplikacji SPA każdy klik
235
+ przeładowywał całą stronę. Zdarzenie `KptNavigateEvent` z `{ item, url, event }` leci przy zwykłym
236
+ kliku. Aplikacja woła `event.preventDefault()` i nawiguje swoim routerem, a kliki z Ctrl, Cmd, Shift albo
237
+ środkowym przyciskiem zostają natywne. Biblioteka nadal nie zależy od żadnego routera. Dokumentacja
238
+ menu opisuje, kiedy rola `menubar` jest właściwa, a kiedy dla nawigacji witryny lepszy jest wzorzec
239
+ disclosure.
240
+
241
+ ### Patch Changes
242
+
243
+ - c3923a8: `kpt-auth` pokazuje pola ze slotu `[kptAuthFields]` także w rejestracji. Dwa `<ng-content>` o tym
244
+ samym selektorze były dwoma osobnymi slotami, a treść trafiała tylko do pierwszego, czyli do
245
+ logowania. Przycisk wysyłki w obu portach nie jest już wyłączany przy niepoprawnym formularzu:
246
+ naciśnięcie oznacza pola jako dotknięte i pokazuje, czego brakuje, zamiast zostawiać martwy
247
+ przycisk. Zdarzenia `signIn`/`signUp`/`resetPassword` lecą jak dotąd tylko dla poprawnych danych,
248
+ a w trakcie `busy` wysyłka jest zablokowana. Opis `busy` mówi teraz prawdę: pola zostają edytowalne.
249
+ - 81f30bd: `kpt-chart` (w React `KptChart`) ma alternatywę tekstową. SVG `role="img"` dostaje nazwę z nowego
250
+ pola `config.ariaLabel`, z tytułu albo z i18n (`chart.label`), opcjonalne `config.description` trafia
251
+ do `aria-describedby`, a dane wykresu leżą w ukrytej wizualnie tabeli, po której czytnik ekranu
252
+ przechodzi wartość po wartości. Dotąd czytnik słyszał samo "obraz", a liczby były dostępne tylko
253
+ w dymku pod wskaźnikiem. Tabelę i nazwę składają `chartDataTable()` i `chartAccessibleName()`
254
+ z `@konce-pt/chart`.
255
+ - bf13bf5: Czat w obu portach. Przewijana historia rozmowy jest przystankiem Tab z nazwą (`chat.history`), więc
256
+ klawiatura przewinie ją także wtedy, gdy w wiadomościach nie ma nic fokusowalnego. Licznik "nowe
257
+ wiadomości" podaje, ile wiadomości naprawdę przyszło, zamiast liczyć przebiegi renderu. Wskaźnik
258
+ pisania nie jest już ogłaszany jak nowa wiadomość. Doklejenie starszej historii zostawia widok
259
+ w miejscu także w Safari, a pigułka dnia mierzy się raz na klatkę zamiast przy każdym zdarzeniu
260
+ przewijania. Kompozytor zgłasza "piszę" przy pierwszym znaku, a potem najwyżej co 3 s
261
+ (`KPT_CHAT_TYPING_THROTTLE_MS` w `@konce-pt/chat`), nie przy każdym znaku. Własne opcje reakcji
262
+ mogą mieć `label`.
263
+ - 704d42a: `kpt-checkbox`, `kpt-radio-group`, `kpt-switch` i próbnik `kpt-color-picker` znów reagują na klik.
264
+ Blokada trybu `readonly` zwracała z handlera `false`, gdy pole nie było tylko do odczytu, a Angular
265
+ traktuje `false` zwrócone z obsługi zdarzenia jak `preventDefault()` - natywne pole nie zmieniało
266
+ stanu.
267
+ - e6154c7: `KptConfirmService.confirm()` wywołane przy otwartym oknie rozstrzyga poprzednie żądanie jako
268
+ `false`, zanim pokaże nowe. Dotąd pierwsza obietnica nie rozstrzygała się nigdy, więc czekający
269
+ `await` wisiał na zawsze. Port React działał tak od początku. W obu portach tryb deweloperski
270
+ ostrzega w konsoli, gdy potwierdzenie pada bez zamontowanego kontenera.
271
+ - 9016c4d: `kpt-data-table` (w React `KptDataTable`) da się obsłużyć bez myszy. Sortowalny nagłówek jest
272
+ przyciskiem, uchwyt przestawiania kolumny reaguje na strzałki i ogłasza nową pozycję, a nowe wejście
273
+ `clickableRows` (w React domyślnie włączone przy `onRowClick`) robi z wierszy przystanki Tab
274
+ aktywowane Enterem. Komórka edytowalna zachowuje wartość jako nazwę, a "Edytuj: kolumna" trafia do
275
+ opisu. Pole filtra ma nazwę dostępną, tabela dostaje `aria-busy` przy ładowaniu oraz wejścia
276
+ `ariaLabel` i `caption`, a wybór jednego wiersza renderuje radia. Kolumny zamrożone z szerokością
277
+ w `%` albo `ch` dostają poprawne przesunięcie z pomiaru zamiast liczenia jak `rem`.
278
+
279
+ Filtr globalny i tekstowy pomijają wielkość liter i znaki diakrytyczne ("lodz" znajduje "Łódź"),
280
+ sortowanie używa `Intl.Collator` dla aktywnego języka z naturalną kolejnością liczb, a eksport CSV
281
+ ma końce wierszy CRLF. Ta logika siedzi w `@konce-pt/table` (`matchesGlobalFilter`,
282
+ `createRowComparator`, `buildCsv`, `cssLengthToPx`, `foldText`) i jest pokryta testami. Nieposortowana
283
+ kolumna ma własną ikonę `selector`, nową w zestawie wbudowanym `@konce-pt/icons`. Słownik
284
+ `@konce-pt/i18n` dostał klucze `dataTable.moveColumn` i `dataTable.columnMoved`.
285
+
286
+ - 6a7667d: `kpt-divider` / `KptDivider` dostał `decorative`: linia czysto ozdobna traci `role="separator"`
287
+ i znika z drzewa dostępności. Drzewo ma `ariaLabel`, który trafia na element `role="tree"` (bez nazwy
288
+ czytnik ogłaszał samo "drzewo"). Dokumentacja opisuje, kiedy alert zostanie ogłoszony (dodany po
289
+ akcji - tak; obecny od wczytania strony - nie niezawodnie) i że stepper oraz zakładki niszczą
290
+ nieaktywną treść razem z jej stanem lokalnym. JSDoc `kpt-mention` przestał obiecywać zachowanie,
291
+ którego komponent nie ma - wzmiankę bez karty oznacza się `disabled`.
292
+ - ccf9840: Seria drobnych poprawek w obu portach. Karuzela i galeria przycinają pokazywany indeks do listy,
293
+ więc po skróceniu `items` (filtr) widok nie zostaje pusty. Zakładki mierzą wskaźnik
294
+ `ResizeObserverem` na pasku (zmiana szerokości kontenera bez zmiany okna przestała go rozjeżdżać),
295
+ a wyłączona zakładka nie wygląda już na wybraną - pokazywana jest pierwsza dostępna. Splitter sprząta
296
+ nasłuch po `pointercancel` (dotyk przerwany przez system) i w RTL przeciąga oraz reaguje na strzałki
297
+ zgodnie z kierunkiem. Paginator nie daje nieskończonej liczby stron przy `pageSize` 0 i ogłasza
298
+ zakres po zmianie strony. Zwijany fieldset ma `aria-controls`, a accordion i fieldset nie dublują
299
+ `aria-hidden` obok `inert`. Okrągły `kpt-fab` bez `ariaLabel` nie wypisuje pustego `aria-label`
300
+ i ostrzega w trybie deweloperskim.
301
+ - d20223f: `kpt-alert`, `kpt-empty`, `kpt-accordion-panel` i legenda `kpt-chart` zdejmują atrybut `title` z hosta.
302
+ To wejście jest tu nagłówkiem, ale statyczny atrybut (`<kpt-alert title="Zapisano">`) zostawał w DOM
303
+ i dawał natywny dymek nad całym komponentem. `kpt-mention` nie wystawia już identyfikatora osoby jako
304
+ DOM `id` hosta (ta sama osoba wzmiankowana dwa razy dawała zdublowane `id`); trafia on do `data-id`.
305
+ `kpt-textarea` tworzy `ResizeObserver` po renderze, więc nie wywraca renderowania po stronie serwera,
306
+ a `kpt-input` przyjmuje `disabled`, `readonly`, `required`, `invalid` i `touched` jako atrybuty
307
+ statyczne (`<kpt-input disabled />`), tak jak każda inna kontrolka.
308
+ - 5d32e07: `KptI18n.registerMessages()` wywołane po starcie aplikacji (na przykład dla leniwie ładowanego JSON-a)
309
+ przerysowuje komponenty od razu, także dla aktywnego języka. Dotąd nowe tłumaczenia pojawiały się
310
+ dopiero przy następnej zmianie języka. `t()` w obu portach przyjmuje nowy typ `KptMessageKey` z
311
+ `@konce-pt/i18n`, który daje podpowiedzi kluczy w edytorze. Dowolny napis nadal przechodzi, ale klucz
312
+ nieobecny w żadnym słowniku ostrzega w trybie deweloperskim, zamiast po cichu pokazywać sam klucz.
313
+ - d95dc06: `weekdayNames()` i `monthNames()` z `@konce-pt/i18n` formatują w UTC, czyli w tej samej strefie,
314
+ w której powstają ich daty wzorcowe. Dotąd na zachód od Greenwich nazwy przesuwały się o jeden:
315
+ w Nowym Jorku nagłówek siatki `kpt-datepicker` i `kpt-date-range` zaczynał się od "Sun" nad
316
+ poniedziałkiem, a styczeń był podpisany "December". Dotyczyło to obu portów. Test biegnie
317
+ w strefie `America/New_York`, bo w Warszawie błąd jest niewidoczny.
318
+ - 351c3b8: `kpt-input-number` / `KptInputNumber`: wpisana z klawiatury liczba znów trafia do modelu. Wzorzec
319
+ rozpoznający zapis dziesiętny zgubił w poprzedniej poprawce ukośniki i odrzucał każdą cyfrę -
320
+ działały tylko strzałki i przyciski.
321
+ - 1816edd: `kpt-input-number` (w React `KptInputNumber`) zaokrągla krok do precyzji kroku albo bieżącej
322
+ wartości, zależnie od tego, która jest drobniejsza. Dotąd strzałka przy `step=1` zamieniała `1.25`
323
+ na `2` i po cichu gubiła wpisaną część ułamkową. Pole przyjmuje przy pisaniu tylko zwykłą liczbę
324
+ dziesiętną (`0x1A`, `1e3` i `Infinity` są pomijane), pokazuje cyfry łacińskie także w locale
325
+ z własnymi cyframi i ma wejście `readonly` (`readOnly` w React), które blokuje pisanie, strzałki
326
+ i przyciski. To samo `readonly` dostało `kpt-knob`, a pokrętło przyciąga teraz wartość do siatki
327
+ liczonej od `min`: przy `min=1, step=2` mysz i klawiatura dają te same wartości 1, 3, 5..., a nie
328
+ dwie różne siatki. Doszły też `PageUp`/`PageDown` o dziesięć kroków.
329
+ - db3c3f0: Kalendarze i zegar w obu portach. Tarcza zegara ma segmenty godzin i minut jako `role="spinbutton"`:
330
+ strzałki, `PageUp`/`PageDown` i `Home`/`End` ustawiają każdą minutę, nie tylko znaczniki co pięć,
331
+ a etykiety AM/PM pochodzą z `Intl` w języku interfejsu. `kpt-datepicker` i `kpt-date-range` zaczynają
332
+ tydzień wg języka (en-US od niedzieli; `firstDayOfWeek` nadpisuje), mają format `displayFormat="locale"`,
333
+ placeholder z literami w języku interfejsu zamiast zawsze polskiego "RRRR", wejścia `readonly`
334
+ i `required` oraz pole `role="combobox"`, które niesie `aria-required`, `aria-readonly` i `aria-invalid`.
335
+ Przyciski tytułu mają nazwę zaczynającą się od widocznego tekstu, przewinięcie miesiąca jest
336
+ ogłaszane, "dziś" liczy się przy każdym otwarciu, a wyczyszczenie wartości dotyka pola.
337
+ `kpt-date-range` wystawia `open` jako model (w React `open`/`onOpenChange`), tak jak datepicker.
338
+ - 55baa03: Porządki wskazane przez nowy lint. Linki zewnętrzne w karcie miejsca na mapie (`kpt-map-poi-card`,
339
+ `KptMapPoiCard`) dostają `rel="noopener noreferrer"`, tak jak `kpt-button`. Raport importu DTCG
340
+ z `@konce-pt/theme` zapisuje nieodczytaną wartość złożonego tokenu jako JSON zamiast
341
+ "[object Object]". CLI `konce` wypisuje stos błędu tylko dla prawdziwych wyjątków. Z portu React
342
+ zniknęły nieużywane importy, a `KptSidenavProps` jest aliasem typu zamiast pustego interfejsu -
343
+ dla konsumenta to ten sam typ.
344
+ - dd9536a: Lista porządkowana i pick-list w obu portach ogłaszają zmiany czytnikowi ekranu: przestawienie
345
+ pozycji (`orderList.moved`: "Przeniesiono na pozycję 3 z 7") i przeniesienie między listami
346
+ (`pickList.moved`: "Przeniesiono 2 do: Wybrane"). Nowe klucze są w słownikach EN i PL. Przyciski
347
+ przenoszenia w pick-list mają `aria-disabled`, gdy nie ma czego przenieść, i zostają fokusowalne,
348
+ więc fokus nie spada na `<body>`, gdy po przeniesieniu zniknie zaznaczenie. Przypięcie karty
349
+ `kpt-peek` przenosi fokus do panelu po renderze (`afterNextRender`), a nie w `setTimeout`.
350
+ - d331614: Mapa w obu portach. Nieudany start silnika (brak paczki `leaflet`, odrzucony klucz Google) nie jest
351
+ już "Uncaught (in promise)": trafia do konsoli i do nowego `engineError` (Angular) / `onEngineError`
352
+ (React). Zniszczenie komponentu Angulara w trakcie `init()` czeka na koniec montażu, zamiast
353
+ zostawiać mapę zbudowaną na odpiętym kontenerze i podpinać zdarzenia po zniszczeniu. W React
354
+ `followUser` i callbacki pozycji są czytane na świeżo przy każdym odczycie (wcześniej działała
355
+ wartość z chwili włączenia nasłuchu), a stan wyszukiwarki i formularza "dodaj lokalizację" liczy
356
+ się w renderze zamiast w efektach. Wyszukiwarka przestała restartować odliczanie przy każdym
357
+ ruchu mapy, a `aria-controls` pola wskazuje listę wyników (`role="listbox"`), nie panel z notą.
358
+ - 9309235: Menu kontekstowe ma `tabindex="-1"` na panelu `role="menu"`, więc fokus przenoszony programowo
359
+ zawsze na nim ląduje. W React popover kotwiczy panel do wyzwalacza ze stanu zamiast z refa
360
+ czytanego w renderze - przy pierwszym otwarciu panel nie startuje już bez kotwicy.
361
+ - bd47977: Poprawki nakładek w obu portach.
362
+
363
+ - **Tooltip.** Dymek `kptTooltip` (w React `KptTooltip`) jest widoczny w modalnym `kpt-dialog`, bo
364
+ doklejany jest do otwartego okna albo popovera, a nie do `body` pod warstwą szczytową. Wygląd daje
365
+ mu klasa `.kpt-tooltip` w `@konce-pt/styles` (warstwa `kpt.components`), więc da się go przestylować
366
+ bez `!important`. Pod wskaźnikiem pokazuje się po 300 ms, a zmiana tekstu przy widocznym dymku
367
+ go aktualizuje.
368
+ - **Okna.** `kpt-dialog`, `kpt-drawer`, `kpt-bottom-sheet` i podgląd `kpt-image` blokują przewijanie
369
+ strony pod spodem, ze wspólnym licznikiem dla zagnieżdżonych okien. Dialog z `dismissible=false`
370
+ nie daje się już zamknąć drugim Escape w Chromium. Szuflada, arkusz i `kpt-popover` mają
371
+ `ariaLabel` na wypadek braku nagłówka.
372
+ - **Toast.** Toast z `action` domyślnie nie znika sam.
373
+ - **Context-menu.** `kpt-context-menu` otwiera się w warstwie szczytowej, więc przodek z `transform`
374
+ albo `backdrop-filter` go nie przesuwa. Przewinięcie strony zamyka menu.
375
+ - **Tylko React.** Escape w nakładce zamyka tylko najwyższą i nie zamyka już otaczającego
376
+ `KptDialog`. Pułapki fokusu szuflady i arkusza nie walczą o Tab przy dwóch otwartych panelach.
377
+
378
+ - 2af99e1: Miernik siły w `kpt-password` (w React `KptPassword`) ocenia hasło przede wszystkim po długości,
379
+ a nie po regułach składu. Dotąd `Password1!` dostawał ocenę "silne" za to, że ma wielką literę, cyfrę
380
+ i znak specjalny, a trzydzieści małych liter - "słabe". Polskie litery liczyły się przy tym jako znaki
381
+ specjalne. Teraz wynik to przybliżona entropia z klas znaków, które naprawdę wystąpiły, obcinana za
382
+ powtórzenia, ciągi (`abcd`, `qwerty`) i schemat "Słowo + cyfry + znak". Nadal bez słownika: to
383
+ podpowiedź, nie zabezpieczenie.
384
+ - 37c9c15: Karta podglądu (`kpt-peek` / `KptPeek`) otwarta najechaniem albo fokusem zamyka się Escape-em
385
+ na samym wyzwalaczu, bez przenoszenia fokusu (WCAG 1.4.13). Przy zamkniętej karcie klawisz idzie
386
+ dalej, więc nadal zamyka otaczające okno. Shell aplikacji nie zamyka już nakładki nawigacji
387
+ Escape-em, którym użytkownik zamyka okno, menu albo popover otwarte nad nim, a panel nawigacji jest
388
+ elementem `<nav>` zamiast `<aside role="navigation">`. Jeśli Twój CSS celował w `aside` w shellu,
389
+ przełącz go na klasę `.kpt-app-shell__sidenav`.
390
+ - 620d2e0: Komponenty złożone w React (`KptTabs`, `KptStepper`, `KptAccordion`, `KptSplitter`, `KptCard`,
391
+ `KptDialog`, `KptPanel`, `KptSidenav`, `KptAuth`) widzą sloty owinięte we fragment - `<>...</>`
392
+ z warunku przestał chować zakładki i kroki. Komponenty przyjmujące wyłącznie sloty ostrzegają
393
+ w buildzie deweloperskim o pominiętym dziecku. Menu, megamenu, menubar i split-button kotwiczą panel
394
+ do wyzwalacza ze stanu (przy pierwszym otwarciu panel nie startuje już bez kotwicy), a panele
395
+ `role="menu"` w obu portach mają `tabindex="-1"`. Drzewo, lista porządkowana i pick-list przenoszą
396
+ fokus bez dodatkowego przebiegu renderu. `KptBackdrop` czyta `prefers-reduced-motion` przez
397
+ `useSyncExternalStore`, więc nie startuje animacji na jedną klatkę przed odczytem preferencji.
398
+ - 7cad9dc: Każda kontrolka formularza przyjmuje `readonly` (w React `readOnly`), więc reguła `readonly(p.pole)`
399
+ ze schematu Signal Forms nie jest już po cichu ignorowana. Wartość zostaje widoczna i fokusowalna,
400
+ a zmiana jest zablokowana, z `aria-readonly` tam, gdzie rola na to pozwala. `required` dostały
401
+ `button-group`, `color-picker`, `input-otp` i `switch`.
402
+
403
+ Przy okazji poprawki w tych samych kontrolkach. `kpt-button-group` jest grupą radiową (`radiogroup`
404
+ z `radio`, jeden przystanek Tab, strzałki przenoszą wybór), ma `ariaLabel`, `id` i widoczny stan błędu.
405
+ `kpt-input-otp` zapisuje znaki bez dziur (`"13"` zamiast `"1 3"`), a pusta komórka zostaje pusta na
406
+ ekranie. W `kpt-slider` uchwyty zakresu już się nie mijają, a `kpt-switch-group` z `allowDeselect=false`
407
+ przywraca wyłączony przełącznik. `kpt-input-mask` trzyma kursor w miejscu edycji i przyjmuje litery
408
+ spoza ASCII, a `kpt-color-picker` przyjmuje `fff` i `#fff`, nie skacze kursorem i liczy wybór presetu
409
+ jako dotknięcie. `kpt-select` filtruje bez diakrytyków i nie mierzy pola przy każdym przebiegu, a
410
+ `kpt-listbox` ma `Shift+strzałki` i `Shift+klik` w wyborze wielokrotnym. W obu tych komponentach
411
+ komunikat "brak wyników" stoi obok listy, a nie w niej. `kpt-chips-input` nie zatwierdza tagu
412
+ w trakcie kompozycji IME i ponownie ogłasza powtórzony komunikat. `kpt-file-upload` ma `id`
413
+ i `ariaLabel`, spina się z `kpt-form-field`, a przycisk usuwania podaje nazwę pliku. Jego podpowiedź
414
+ jest zwykłym tekstem: klucz `fileUpload.hint` z `{action}` i nowy `fileUpload.hintAction`. Własne
415
+ słowniki, które wstawiały do `hint` HTML, trzeba przepisać na ten zapis. W React zniknęło przez to
416
+ `dangerouslySetInnerHTML`.
417
+
418
+ - 6492578: `kpt-rich-text` (w React `KptRichText`) da się obsłużyć z klawiatury w całości. Styl akapitu to lista
419
+ z `aria-activedescendant` obsługiwana strzałkami, siatkę wstawiania tabeli steruje się strzałkami
420
+ z ogłaszanym rozmiarem, a paleta kolorów przejmuje fokus po otwarciu, ma strzałki między próbkami
421
+ i krąży Tabem w środku. `Escape` w każdym panelu oddaje fokus narzędziu. Dotąd te trzy panele
422
+ działały tylko myszą, bo wisiały w kontenerze nakładek na końcu strony.
423
+
424
+ Sanityzator dostał jedną allowlistę adresów dla narzędzia linku i dla wklejonego HTML: `data:`,
425
+ `vbscript:` i `blob:` w `href` już nie przechodzą. Atrybut `class` zostaje tylko z klasami samego
426
+ edytora, link z `target` dostaje `rel="noopener noreferrer"`, a gdy sanityzator coś usunął,
427
+ oczyszczona treść wraca też do wartości modelu. Kod sanityzatora w porcie Angulara wyprowadził się
428
+ z komponentu do `rich-text/sanitize.ts`, lustra pliku z portu React.
429
+
430
+ - 5c96a98: Edytor tekstu sformatowanego w obu portach: pole edycji ma jawne `tabindex`, a menu tabeli jest
431
+ fokusowalne programowo (`tabindex="-1"`), więc fokus przenoszony z klawiatury zawsze ma dokąd
432
+ trafić. W React pozycja "Podziel komórkę" liczy swoją dostępność ze stanu zamiast z refa czytanego
433
+ w renderze - wcześniej potrafiła pokazać stan sprzed otwarcia menu.
434
+ - 009a81d: Roadmapa w obu portach. Paski i kamienie milowe mają `role="button"` i nazwę dostępną z etykiety,
435
+ zakresu dat i postępu (nowy klucz `roadmap.progress`), zamiast dymka, którego czytnik nie widzi;
436
+ koniec zakresu jest wyłączny, więc ogłaszany jest ostatni zajęty dzień. Siatka pasków to jeden
437
+ przystanek Tab: strzałki chodzą po wierszu i między wierszami, Home/End skaczą na skraj wiersza,
438
+ a z Ctrl na skraj roadmapy; przy `virtual` wiersz spoza okna jest najpierw przewijany. Wyłączone
439
+ elementy dostają `aria-disabled`. Przełącznik grupy ma za nazwę nazwę grupy, a "Rozwiń/Zwiń grupę"
440
+ zostało jego dymkiem. Rdzeń `@konce-pt/roadmap` eksportuje `roadmapNavTarget` i `roadmapItemDates`.
441
+ - Updated dependencies [81f30bd]
442
+ - Updated dependencies [bf13bf5]
443
+ - Updated dependencies [9016c4d]
444
+ - Updated dependencies [0ad95ef]
445
+ - Updated dependencies [5d32e07]
446
+ - Updated dependencies [d95dc06]
447
+ - Updated dependencies [db3c3f0]
448
+ - Updated dependencies [dd9536a]
449
+ - Updated dependencies [7cad9dc]
450
+ - Updated dependencies [009a81d]
451
+ - @konce-pt/chart@0.12.0
452
+ - @konce-pt/i18n@0.12.0
453
+ - @konce-pt/chat@0.12.0
454
+ - @konce-pt/table@0.12.0
455
+ - @konce-pt/icons@0.12.0
456
+ - @konce-pt/datetime@0.12.0
457
+ - @konce-pt/roadmap@0.12.0
458
+ - @konce-pt/backdrop@0.12.0
459
+ - @konce-pt/map@0.12.0
460
+ - @konce-pt/mention@0.12.0
461
+
3
462
  ## 0.11.2
4
463
 
5
464
  ### Patch Changes
@@ -30,7 +489,7 @@
30
489
 
31
490
  - 2653c2f: `kpt-textarea` z `autoResize` dopasowuje wysokość także do wartości ustawionej z formularza
32
491
  (edycja istniejącego wpisu), a nie tylko do wpisywanej z klawiatury. Pole ukryte przy pierwszym
33
- renderze — w zamkniętym dialogu albo zwiniętej sekcji — nie zwija się już do zera: zostaje
492
+ renderze - w zamkniętym dialogu albo zwiniętej sekcji - nie zwija się już do zera: zostaje
34
493
  wysokość z `rows`, a pomiar wraca, gdy pole staje się widoczne. Port React działał tak od początku.
35
494
  - @konce-pt/backdrop@0.11.1
36
495
  - @konce-pt/chart@0.11.1
@@ -53,13 +512,13 @@
53
512
  przesuwa łuk płynnie, a liczba odlicza się do celu. Przeciąganie idzie za kursorem bez opóźnienia,
54
513
  `prefers-reduced-motion` wyłącza animację, a `aria-valuenow` zawsze podaje wartość docelową.
55
514
  - 11b1231: Lista `kpt-select` nie wsuwa już tekstu pod znacznik zaznaczenia. Panel miał szerokość pola
56
- wymuszoną na sztywno, więc w wąskim selecie opcja dłuższa od pola wylewała się pod ✓. Szerokość
515
+ wymuszoną na sztywno, więc w wąskim selecie opcja dłuższa od pola wylewała się pod znacznik wyboru. Szerokość
57
516
  pola jest teraz minimum: panel rośnie do najdłuższej opcji (do krawędzi okna, dalej etykieta się
58
517
  zawija), a znacznik stoi 1rem od tekstu. W porcie React `KptOverlay` dostał do tego opcję
59
518
  `minAnchorWidth`; `matchAnchorWidth` (szerokość dokładnie jak wyzwalacz) działa jak dotąd.
60
519
  - f5b7dbb: Ukryte regiony ogłoszeń `kpt-toast-container` nie wydłużają już strony. Kontener stoi zwykle na końcu
61
520
  treści, a region z `position: absolute` brał za blok zawierający przodka spoza przewijanego obszaru
62
- (w `kpt-app-shell` — `.kpt-app-shell__body`). Uciekał wtedy spod przycięcia, siadał setki pikseli
521
+ (w `kpt-app-shell` - `.kpt-app-shell__body`). Uciekał wtedy spod przycięcia, siadał setki pikseli
63
522
  pod oknem i dokładał drugi pasek przewijania na `body`. Region jest teraz przypięty do okna.
64
523
  - @konce-pt/backdrop@0.11.0
65
524
  - @konce-pt/chart@0.11.0
@@ -82,13 +541,13 @@
82
541
  `ariaLabel` (okno bez nagłówka), `ariaDescribedby` i `alert` (`role="alertdialog"`); w React te same
83
542
  atrybuty przechodzą wprost jako propsy `<dialog>`.
84
543
  - `kpt-confirm-container`: okno to `alertdialog` z treścią pytania w `aria-describedby`, a fokus
85
- startuje na przycisku odmowy zamiast na „×”.
544
+ startuje na przycisku odmowy zamiast na "x".
86
545
  - `kpt-splitter`: uchwyt ma nazwę (input/prop `ariaLabel`, domyślnie nowy klucz `splitter.resize`),
87
546
  `aria-valuemin`/`aria-valuemax`, `aria-controls`, obsługę `Home`/`End` i poprawne
88
547
  `aria-orientation` (linia uchwytu, nie układ). Host ma `height: 100%`, więc wysokość rodzica
89
- dociera do paneli — **splitter w rodzicu o ustalonej wysokości wypełni ją teraz w całości**.
548
+ dociera do paneli - **splitter w rodzicu o ustalonej wysokości wypełni ją teraz w całości**.
90
549
  - `kpt-stepper`: znaczniki mają nazwy z nowych kluczy `stepper.step` / `stepper.stepDone`
91
- („Krok 2: Dostawa, ukończony”) zamiast samego numeru.
550
+ ("Krok 2: Dostawa, ukończony") zamiast samego numeru.
92
551
  - `kpt-panel`: przełącznik z `header` mówi, który panel zwija (nowy klucz `panel.toggleNamed`),
93
552
  i wskazuje treść przez `aria-controls`.
94
553
  - `kpt-accordion`: nagłówek ma `aria-controls`, treść to `region` nazwany nagłówkiem.
@@ -98,31 +557,31 @@
98
557
  z `aria-current="page"` jest podświetlony.
99
558
  - `kpt-app-shell`: otwarcie nakładki przenosi fokus do panelu, zamknięcie oddaje go na przycisk menu.
100
559
  - `kpt-menubar`, `kpt-megamenu`: pozycja z `url` (bez dzieci, niewyłączona) renderuje się jako
101
- `<a href>` — wcześniej pole było opisane, ale pomijane.
560
+ `<a href>` - wcześniej pole było opisane, ale pomijane.
102
561
 
103
562
  - a7525af: `kpt-file-upload` i `kptTooltip` działają z klawiatury i czytnika ekranu.
104
563
 
105
564
  `kpt-file-upload` (oba porty): strefa upuszczania była `<div>` reagującym wyłącznie na kliknięcie,
106
- a natywne pole pliku jest ukryte — z klawiatury nie dało się wybrać pliku w ogóle. Strefa jest teraz
565
+ a natywne pole pliku jest ukryte - z klawiatury nie dało się wybrać pliku w ogóle. Strefa jest teraz
107
566
  `role="button"` z przystankiem Tab, a `Enter` i spacja otwierają okno wyboru. W Angularze `disabled`
108
- zmieniał tylko wygląd i kliknięcie nadal otwierało okno — teraz blokuje wybór i wyjmuje strefę
567
+ zmieniał tylko wygląd i kliknięcie nadal otwierało okno - teraz blokuje wybór i wyjmuje strefę
109
568
  z kolejności Tab (`aria-disabled`). Stan `invalid` dostał wygląd (ramka `--kpt-color-danger`,
110
569
  `aria-invalid`), widoczny po dotknięciu pola. Pozycje listy mają ikonę według typu (`photo` dla
111
570
  obrazów, `paperclip` dla reszty) zamiast zawsze ikony zdjęcia, a lista nie gubi już plików o tej
112
571
  samej nazwie.
113
572
 
114
- `kptTooltip` (Angular): nasłuchiwał `focus`/`blur` na hoście, a te zdarzenia nie bąbelkują — na
573
+ `kptTooltip` (Angular): nasłuchiwał `focus`/`blur` na hoście, a te zdarzenia nie bąbelkują - na
115
574
  `kpt-button` i `kpt-icon-button` fokus dostaje wewnętrzny `<button>`, więc podpowiedź nie pojawiała
116
575
  się z klawiatury. Teraz `focusin`/`focusout`. W obu portach: tekst trafia do czytników przez trwały,
117
576
  ukryty opis powiązany `aria-describedby` z elementem przyjmującym fokus (pomijany, gdy powtarzałby
118
577
  jego nazwę, i przy `onlyWhenTruncated`), `Escape` zamyka dymek, a wskaźnik może na niego przejść bez
119
- zniknięcia — wymagania WCAG 1.4.13.
578
+ zniknięcia - wymagania WCAG 1.4.13.
120
579
 
121
580
  - 094a654: Drobne poprawki dostępności i wygody w kontrolkach formularzy.
122
581
 
123
582
  - `kpt-input-otp`: `autocomplete="one-time-code"` na pierwszej komórce (telefon podpowiada kod z SMS);
124
583
  kod wpisany do jednej komórki naraz rozkłada się jak wklejenie; `touch` przy wyjściu z grupy.
125
- - `kpt-input-mask`: `inputmode` z maski (same `9` → klawiatura numeryczna), nowe `inputMode`
584
+ - `kpt-input-mask`: `inputmode` z maski (same `9` -> klawiatura numeryczna), nowe `inputMode`
126
585
  i `autocomplete`.
127
586
  - `kpt-autocomplete`: `aria-autocomplete`, `aria-controls`, `aria-activedescendant`, liczba podpowiedzi
128
587
  w regionie `polite`, dopasowanie bez diakrytyków, `Escape` zamyka, a drugi czyści pole.
@@ -137,15 +596,15 @@
137
596
  - `kpt-color-picker`: nazwane gotowe kolory (`{ value, label }`, typ `KptColorPreset`, domyślna paleta
138
597
  z i18n), `aria-pressed`, pole hex przyjmuje tylko pełny kod i oznacza niepełny `aria-invalid`.
139
598
  - `kpt-input-number`: wartość w zapisie aktywnego języka (PL `12,5`).
140
- - `kpt-rating`: połówki gwiazdek (`allowHalf`) — każda połówka to osobne `radio`, strzałki co 0,5;
141
- tylko do odczytu gwiazdki pokazują wartość zaokrągloną do połówki, a nazwa dokładną („4,3 z 5”).
599
+ - `kpt-rating`: połówki gwiazdek (`allowHalf`) - każda połówka to osobne `radio`, strzałki co 0,5;
600
+ tylko do odczytu gwiazdki pokazują wartość zaokrągloną do połówki, a nazwa dokładną ("4,3 z 5").
142
601
  - `kpt-rich-text`: okienko adresu linku zamiast `window.prompt()`, menu kontekstowe tabeli jako
143
602
  `role="menu"` z klawiaturą (klawisz menu / `Shift+F10`, strzałki, `Escape`, powrót fokusu), nazwy
144
603
  próbek kolorów z i18n.
145
604
  - `@konce-pt/i18n`: przestrzenie `autocomplete`, nowe klucze `chipsInput.*`, `colorPicker.*`
146
605
  (nazwy kolorów), `richText.linkApply`, `richText.swatches.*`.
147
606
 
148
- - 094a654: Kontrolki formularzy same wiążą się z `kpt-form-field` — etykieta, podpowiedź i błąd docierają
607
+ - 094a654: Kontrolki formularzy same wiążą się z `kpt-form-field` - etykieta, podpowiedź i błąd docierają
149
608
  do czytnika bez ręcznego `controlId`.
150
609
 
151
610
  - `kpt-form-field` daje zawartości kontekst (Angular: token `KPT_FORM_FIELD` i pomocnik
@@ -154,38 +613,38 @@
154
613
  `aria-labelledby` na etykietę, bo `label[for]` ich nie nazywa. Widoczna podpowiedź albo błąd ma `id`
155
614
  i trafia do `aria-describedby` kontrolki. Jawny `controlId` nadal wygrywa.
156
615
  - `id` i `ariaLabel` we wszystkich kontrolkach formularzy (`id` zawsze na elemencie fokusowalnym,
157
- nigdy na hoście); `required` → `aria-required` tam, gdzie go brakowało (textarea, password, select,
616
+ nigdy na hoście); `required` -> `aria-required` tam, gdzie go brakowało (textarea, password, select,
158
617
  chips-input, checkbox, input-number, radio-group, rich-text).
159
- - `kpt-password`: `id` nie zostaje już na hoście — wcześniej strona miała dwa elementy o tym samym id,
618
+ - `kpt-password`: `id` nie zostaje już na hoście - wcześniej strona miała dwa elementy o tym samym id,
160
619
  a etykieta wskazywała `kpt-password` zamiast pola. Doszły `aria-invalid`, `aria-required`,
161
620
  `readonly`, a ocena siły jest w `aria-describedby`.
162
621
  - `kpt-slider`: nazwy uchwytów zakresu z i18n (`slider.min`/`slider.max`) zamiast zaszytych
163
- „Minimum”/„Maksimum”, łączone z etykietą pola.
622
+ "Minimum"/"Maksimum", łączone z etykietą pola.
164
623
  - `kpt-knob`: `aria-valuetext` z `suffix`, wyłączone pokrętło wypada z kolejności Tab.
165
- - `kpt-input-otp`: komórki w nazwanej grupie, każda z nazwą „Znak 2 z 6” (`inputOtp.cell`).
624
+ - `kpt-input-otp`: komórki w nazwanej grupie, każda z nazwą "Znak 2 z 6" (`inputOtp.cell`).
166
625
  - `kpt-color-picker`: nazwy próbnika i pola z kodem (`colorPicker.picker`/`colorPicker.hex`).
167
626
  - React: `id` kontrolek na hoście `div` (datepicker, date-range, color-picker, chips-input,
168
627
  input-number, input-otp, slider, knob, grupy, rich-text) trafia teraz na element fokusowalny,
169
- nie na hosta — jak w porcie Angulara.
628
+ nie na hosta - jak w porcie Angulara.
170
629
 
171
630
  - 094a654: Klawiatura w kontrolkach formularzy z panelem: `kpt-select`, `kpt-datepicker` i `kpt-date-range`
172
631
  dało się dotąd w praktyce obsłużyć tylko myszą.
173
632
 
174
- - `kpt-select`: wzorzec combobox bez wpisywania — fokus zostaje na wyzwalaczu, aktywną opcję ogłasza
633
+ - `kpt-select`: wzorzec combobox bez wpisywania - fokus zostaje na wyzwalaczu, aktywną opcję ogłasza
175
634
  `aria-activedescendant` (z `aria-controls` i `aria-haspopup="listbox"`). Strzałki, `Home`/`End`,
176
635
  `PageUp`/`PageDown` z pominięciem wyłączonych opcji, wyszukiwanie po literach bez względu na
177
636
  diakrytyki, `Enter`/`Spacja` wybiera, `Escape`/`Tab` zamyka, a pojedynczy wybór oddaje fokus
178
637
  wyzwalaczowi. Z `filter` fokus przechodzi do pola wyszukiwania. W trybie `multiple`
179
638
  `Backspace`/`Delete` usuwa ostatni chip, a przyciski chipów mają nazwę opcji. Nowy input `ariaLabel`.
180
- - `kpt-datepicker`: wzorzec „date picker dialog” — pole ma `aria-haspopup="dialog"`/`aria-expanded`
181
- i otwiera się też `Spacją` i `↓`; panel to nazwany dialog z fokusem na wybranym albo dzisiejszym dniu.
639
+ - `kpt-datepicker`: wzorzec "date picker dialog" - pole ma `aria-haspopup="dialog"`/`aria-expanded`
640
+ i otwiera się też `Spacją` i `ArrowDown`; panel to nazwany dialog z fokusem na wybranym albo dzisiejszym dniu.
182
641
  Strzałki o dzień i tydzień, `Home`/`End` tydzień, `PageUp`/`PageDown` miesiąc (z `Shift` rok),
183
642
  strzałki w siatkach miesięcy, lat i dekad; `Tab` krąży w panelu, `Escape` i wybór oddają fokus polu,
184
643
  `Delete`/`Backspace` czyści. Dni mają pełną nazwę daty z `Intl` i `aria-current="date"`.
185
644
  - `kpt-date-range`: ta sama klawiatura przez wszystkie panele, nazwy dni z rolą w zakresie
186
- („…, początek zakresu”) zamiast samego koloru i komunikat `polite` po wyborze początku. Nowe inputy
645
+ ("..., początek zakresu") zamiast samego koloru i komunikat `polite` po wyborze początku. Nowe inputy
187
646
  `minDate`/`maxDate` i `ariaLabel`.
188
- - We wszystkich trzech `touch` nie leci już z blur pola, gdy fokus przechodzi do otwartego panelu —
647
+ - We wszystkich trzech `touch` nie leci już z blur pola, gdy fokus przechodzi do otwartego panelu -
189
648
  wcześniej błąd wymaganego pola pokazywał się w trakcie wybierania. Zamknięcie panelu nadal go wysyła.
190
649
  - `@konce-pt/datetime`: `moveFocusDate`, `moveCellIndex`, `initialFocusDate`, `clampIso`
191
650
  i `KPT_DAY_GRID_KEYS` (klawiatura siatek kalendarza) oraz `minDate`/`maxDate` w `buildRangeGrid`.
@@ -193,99 +652,99 @@
193
652
 
194
653
  - a7525af: Listy wyboru, drzewo i paginator dają się obsłużyć z klawiatury i czytnika ekranu.
195
654
 
196
- `kpt-pick-list` i `kpt-order-list` (w obu portach) miały pozycje zaznaczane wyłącznie kliknięciem —
197
- wiersze nie przyjmowały fokusu, więc z klawiatury działały tylko przyciski „przenieś wszystko”,
655
+ `kpt-pick-list` i `kpt-order-list` (w obu portach) miały pozycje zaznaczane wyłącznie kliknięciem -
656
+ wiersze nie przyjmowały fokusu, więc z klawiatury działały tylko przyciski "przenieś wszystko",
198
657
  a listy kolejności nie dało się przestawić wcale. `llms.txt` twierdził przy tym, że przyciski są
199
658
  pełną ścieżką klawiaturową. Teraz każda lista to `listbox` z jednym przystankiem Tab:
200
659
  strzałki, `Home` i `End` chodzą po pozycjach, w PickList spacja zaznacza, a `Enter` przenosi
201
- pozycję na drugą stronę (jak dwuklik); w OrderList zaznaczenie idzie za fokusem, a `Alt`+↑/↓
660
+ pozycję na drugą stronę (jak dwuklik); w OrderList zaznaczenie idzie za fokusem, a `Alt`+ArrowUp/ArrowDown
202
661
  przestawia pozycję. Pozycje niosą `role="option"` i `aria-selected`, listy nazwę z nagłówka.
203
662
 
204
- `kpt-tree` (w obu portach) ma klawiaturę według wzorca WAI-ARIA „tree view”: jeden przystanek Tab,
205
- strzałki po widocznych wierszach, → / ← rozwijają, zwijają i chodzą między rodzicem a dzieckiem,
663
+ `kpt-tree` (w obu portach) ma klawiaturę według wzorca WAI-ARIA "tree view": jeden przystanek Tab,
664
+ strzałki po widocznych wierszach, -> / <- rozwijają, zwijają i chodzą między rodzicem a dzieckiem,
206
665
  `Enter` / spacja działają jak kliknięcie. Wiersze dostały `aria-selected`, `aria-level`
207
666
  i `aria-disabled`, a pierścień fokusa rysuje się na wierszu. Strzałka rozwijania jest teraz tylko dla
208
- myszy (`aria-hidden`) — przycisk w środku `treeitem` był zagnieżdżoną kontrolką i drugim przystankiem
667
+ myszy (`aria-hidden`) - przycisk w środku `treeitem` był zagnieżdżoną kontrolką i drugim przystankiem
209
668
  Tab na wiersz. Port Angulara przestał też pisać `expanded` do obiektów węzłów aplikacji: stan
210
669
  rozwinięcia trzyma komponent (jak w React), więc dwa drzewa na tych samych węzłach nie rozwijają
211
- się już razem. `expanded` w danych to — jak było opisane — stan początkowy.
670
+ się już razem. `expanded` w danych to - jak było opisane - stan początkowy.
212
671
 
213
672
  `kpt-button` (Angular) ma wejście `ariaLabel`, które trafia na wewnętrzny `<button>`/`<a>`.
214
673
  `kpt-paginator` stawiał `[attr.aria-label]` na hoście `<kpt-button>`, który nie ma roli przycisku,
215
- więc przyciski „poprzednia / następna strona” były dla czytnika ekranu bez nazwy. Port React był
216
- tu poprawny — `aria-label` przechodzi tam na wewnętrzny element.
674
+ więc przyciski "poprzednia / następna strona" były dla czytnika ekranu bez nazwy. Port React był
675
+ tu poprawny - `aria-label` przechodzi tam na wewnętrzny element.
217
676
 
218
677
  - 094a654: Wzorce klawiatury w czterech kontrolkach formularzy.
219
678
 
220
- - `kpt-listbox`: wzorzec WAI-ARIA „listbox” — lista to jeden przystanek Tab z `aria-activedescendant`
679
+ - `kpt-listbox`: wzorzec WAI-ARIA "listbox" - lista to jeden przystanek Tab z `aria-activedescendant`
221
680
  (wcześniej każda opcja była osobnym przyciskiem i przystankiem). Strzałki, `Home`/`End`,
222
681
  `PageUp`/`PageDown` z pominięciem wyłączonych, wyszukiwanie po literach, `Spacja`/`Enter` wybiera,
223
- `Ctrl`/`⌘`+`A` zaznacza wszystkie widoczne w trybie `multiple`. Pole filtra stoi przed listą (nie
224
- w `listbox`), ma nazwę, `↓` przenosi z niego do listy i pomija diakrytyki. Nowe: `id`, `ariaLabel`,
682
+ `Ctrl`/`Cmd`+`A` zaznacza wszystkie widoczne w trybie `multiple`. Pole filtra stoi przed listą (nie
683
+ w `listbox`), ma nazwę, `ArrowDown` przenosi z niego do listy i pomija diakrytyki. Nowe: `id`, `ariaLabel`,
225
684
  `required`; `touch` leci na blur listy. Opcje to `div[role=option]` zamiast `button`.
226
- - `kpt-rating`: grupa radiowa zamiast `role="slider"` z przyciskami w środku — jeden przystanek Tab,
685
+ - `kpt-rating`: grupa radiowa zamiast `role="slider"` z przyciskami w środku - jeden przystanek Tab,
227
686
  gwiazdki z `aria-checked`, strzałki zmieniają ocenę (w RTL odwrócone), `Home`/`End`,
228
- `Delete`/`Backspace` zeruje. `readonly` to `role="img"` z nazwą „4 z 5” zamiast wyłączonych
687
+ `Delete`/`Backspace` zeruje. `readonly` to `role="img"` z nazwą "4 z 5" zamiast wyłączonych
229
688
  przycisków. Nowe: `id`, `ariaLabel`, `required`, `invalid`; `touch` leci, gdy fokus opuszcza grupę.
230
689
  - `kpt-input-number`: `role="spinbutton"` z `aria-valuemin/max/now` i `aria-valuetext` (z sufiksem),
231
- `↑`/`↓` krok, `PageUp`/`PageDown` dziesięć kroków, krok zaokrąglany do precyzji `step`. Wpisywana
232
- liczba nie jest już przycinana w trakcie pisania („150” przy `max` 99 stawało się „99”) — granice
233
- działają przy krokowaniu i na blur. Przyciski `−`/`+` poza kolejnością Tab nie zabierają fokusu polu.
234
- - `kpt-rich-text`: pasek narzędzi ma nazwę (`richText.toolbar`) i jeden przystanek Tab — strzałki
690
+ `ArrowUp`/`ArrowDown` krok, `PageUp`/`PageDown` dziesięć kroków, krok zaokrąglany do precyzji `step`. Wpisywana
691
+ liczba nie jest już przycinana w trakcie pisania ("150" przy `max` 99 stawało się "99") - granice
692
+ działają przy krokowaniu i na blur. Przyciski `-`/`+` poza kolejnością Tab nie zabierają fokusu polu.
693
+ - `kpt-rich-text`: pasek narzędzi ma nazwę (`richText.toolbar`) i jeden przystanek Tab - strzałki
235
694
  i `Home`/`End` chodzą po narzędziach, a Tab z paska idzie od razu do edytora.
236
695
 
237
696
  - dcdb1b4: Nazwy i etykiety dla czytników ekranu w dziewięciu komponentach.
238
697
 
239
- - `kpt-alert`: rola idzie za wagą — `info`/`success` to `role="status"`, `warning`/`danger` to
698
+ - `kpt-alert`: rola idzie za wagą - `info`/`success` to `role="status"`, `warning`/`danger` to
240
699
  `role="alert"` (wcześniej zawsze `alert`). Nowy model `visible` (Angular `[(visible)]`, React
241
700
  `visible`/`onVisibleChange`) pozwala pokazać zamknięty alert ponownie.
242
- - `kpt-badge`: nowy `label` („3 nieprzeczytane”, „dostępny”) czytany zamiast samej liczby albo
701
+ - `kpt-badge`: nowy `label` ("3 nieprzeczytane", "dostępny") czytany zamiast samej liczby albo
243
702
  kropki, i `hideZero`, który chowa plakietkę przy `0`/`null`.
244
- - `kpt-chip`: przycisk usuwania ma nazwę „Usuń <etykieta>” (`aria-labelledby`), a `Backspace`/`Delete`
703
+ - `kpt-chip`: przycisk usuwania ma nazwę "Usuń <etykieta>" (`aria-labelledby`), a `Backspace`/`Delete`
245
704
  działają jak kliknięcie. Etykieta siedzi teraz w `.kpt-chip__label`. Dotyczy też `kpt-chips-input`.
246
705
  - `kpt-meter-group`: nazwa (`label`, domyślnie nowy klucz `meterGroup.label`), `aria-valuemin`,
247
706
  poprawne `aria-valuemax` także bez `max` i `aria-valuetext` z podziałem. Legenda może pokazywać
248
707
  wartości z jednostką (`legendValue="value"`, `unit`).
249
708
  - `kpt-avatar`: zdjęcie, które się nie wczyta, ustępuje inicjałom; nowy `decorative` ukrywa awatar
250
709
  przed czytnikiem, gdy imię stoi obok.
251
- - `kpt-avatar-group`: nowy `label` robi z rzędu nazwaną grupę, licznik „+N” jest czytany jako
252
- „i 2 więcej” (nowy klucz `avatarGroup.more`) i pokazuje ukryte imiona w podpowiedzi. Nakładanie
710
+ - `kpt-avatar-group`: nowy `label` robi z rzędu nazwaną grupę, licznik "+N" jest czytany jako
711
+ "i 2 więcej" (nowy klucz `avatarGroup.more`) i pokazuje ukryte imiona w podpowiedzi. Nakładanie
253
712
  idzie przez `margin-inline-start` (RTL), licznik przy `xl` ma 4rem jak awatar.
254
713
  - `kpt-spinner`: pierścień jest `aria-hidden`, a etykieta trafia do osobnego, ukrytego regionu
255
- `role="status"` klatkę po pojawieniu się — dzięki temu czytniki ją ogłaszają.
714
+ `role="status"` klatkę po pojawieniu się - dzięki temu czytniki ją ogłaszają.
256
715
  - `kpt-icon`: nowy `label` nadaje ikonie `role="img"` z nazwą; nieznana nazwa w trybie
257
716
  deweloperskim daje jedno ostrzeżenie w konsoli.
258
717
  - `kpt-empty`: nowy `headingLevel` robi z tytułu nagłówek strony.
259
718
 
260
719
  - dcdb1b4: `kpt-image`, `kpt-carousel`, `kpt-galleria` i toasty działają z klawiaturą i czytnikiem ekranu.
261
720
 
262
- - `kpt-image`: z `preview` miniatura jest przyciskiem („Pokaż w pełnym rozmiarze: …”), a podgląd
263
- otwiera się na natywnym `<dialog>` przez `showModal()` — pułapka fokusu, `Escape`, bezwładna strona,
721
+ - `kpt-image`: z `preview` miniatura jest przyciskiem ("Pokaż w pełnym rozmiarze: ..."), a podgląd
722
+ otwiera się na natywnym `<dialog>` przez `showModal()` - pułapka fokusu, `Escape`, bezwładna strona,
264
723
  blokada przewijania i powrót fokusu na miniaturę. Podgląd leży w górnej warstwie, więc przodek
265
- z `transform` go nie przesuwa. Tło idzie za `--kpt-color-overlay-scrim`, przycisk × za tokenami
724
+ z `transform` go nie przesuwa. Tło idzie za `--kpt-color-overlay-scrim`, przycisk x za tokenami
266
725
  powierzchni i właściwościami logicznymi. **Zmienia się DOM**: wyzwalacz to `<button>`, podgląd
267
726
  to `<dialog class="kpt-image__overlay">` zamiast `<div>`.
268
727
  - `kpt-carousel`: region z `aria-roledescription="karuzela"` i nowym inputem/propem `label`, slajdy
269
- jako grupy „Slajd 2 z 4”, niewidoczne slajdy `inert`, zmiana ogłaszana uprzejmie. Aktywna kropka
728
+ jako grupy "Slajd 2 z 4", niewidoczne slajdy `inert`, zmiana ogłaszana uprzejmie. Aktywna kropka
270
729
  ma `aria-current`, a pole kliknięcia kropki 24 px. Strzałki na końcach dostają `aria-disabled`
271
730
  zamiast `disabled`, więc nie gubią fokusu. Przejście wyłącza się przy `prefers-reduced-motion`,
272
731
  a w RTL tor i chevrony idą za kierunkiem czytania.
273
732
  - `kpt-galleria`: miniatury mają nazwę z `alt` i `aria-current`, strzałki/`Home`/`End` przełączają
274
- obraz (fokus idzie za miniaturą), zmiana jest ogłaszana („Obraz 2 z 4: …”), przyciski nawigacji
733
+ obraz (fokus idzie za miniaturą), zmiana jest ogłaszana ("Obraz 2 z 4: ..."), przyciski nawigacji
275
734
  nie gubią fokusu i używają właściwości logicznych.
276
- - Toasty: ogłaszanie przez dwa stałe regiony na żywo — uprzejmy i natychmiastowy dla `danger` —
735
+ - Toasty: ogłaszanie przez dwa stałe regiony na żywo - uprzejmy i natychmiastowy dla `danger` -
277
736
  zamiast zagnieżdżonych `aria-live` + `role="status"`. Wskaźnik albo fokus na stosie wstrzymuje
278
737
  liczniki (nowe `pause()`/`resume()`), a wznowienie odlicza pozostały czas. Nowa opcja
279
- `action: { label, run }` dodaje przycisk, np. „Cofnij”.
738
+ `action: { label, run }` dodaje przycisk, np. "Cofnij".
280
739
  - i18n: nowe klucze `carousel.{label,slideOf,roleCarousel,roleSlide}`, `galleria.position`,
281
740
  `image.{preview,previewOf}`, `toast.region`.
282
741
 
283
742
  - a7525af: Menu, przycisk dzielony i speed dial dają się obsłużyć z klawiatury i poprawnie ogłaszają swój stan.
284
743
 
285
- `kpt-menu` i `kpt-split-button` (w obu portach) działają według wzorca „menu button”. Strzałka
744
+ `kpt-menu` i `kpt-split-button` (w obu portach) działają według wzorca "menu button". Strzałka
286
745
  w dół lub w górę na wyzwalaczu otwiera menu z fokusem na pierwszej albo ostatniej pozycji,
287
746
  w środku strzałki przechodzą między pozycjami z zawijaniem, `Home`/`End` skaczą na końce,
288
- a `Escape` i `Tab` zamykają menu. Po zamknięciu i po wyborze fokus wraca na wyzwalacz — wcześniej
747
+ a `Escape` i `Tab` zamykają menu. Po zamknięciu i po wyborze fokus wraca na wyzwalacz - wcześniej
289
748
  spadał na `<body>`, więc użytkownik klawiatury lądował na początku strony. Pozycje mają
290
749
  `tabindex="-1"`, więc otwarte menu to jeden przystanek Tab. Wyzwalacz dostaje `aria-controls`
291
750
  obok `aria-expanded`; rozwijacz przycisku dzielonego wcześniej nie miał ani jednego, ani drugiego.
@@ -296,7 +755,7 @@
296
755
  `KptSplitButtonVariant` (`'filled' | 'tonal' | 'outline' | 'text'`), eksportowany w obu portach.
297
756
 
298
757
  `kpt-speed-dial`: zamknięte akcje były tylko przezroczyste, więc zostawały w kolejności Tab
299
- i w drzewie dostępności — teraz dostają `visibility: hidden` po zgaśnięciu. Główny przycisk niesie
758
+ i w drzewie dostępności - teraz dostają `visibility: hidden` po zgaśnięciu. Główny przycisk niesie
300
759
  `aria-expanded` i `aria-controls`, a `Escape` zamyka wachlarz i zwraca fokus na przycisk.
301
760
  Żeby to było możliwe w Angularze, `kpt-fab` ma nowe wejścia `ariaExpanded` i `ariaControls`
302
761
  (trafiają na wewnętrzny `<button>`, wzorem `kpt-icon-button`).
@@ -310,11 +769,11 @@
310
769
  `kpt-drawer` i `kpt-bottom-sheet` (oba porty): ogłaszały `aria-modal="true"`, ale fokus zostawał
311
770
  na stronie pod tłem. Otwarcie przenosi go teraz do panelu, `Tab` i `Shift+Tab` zawijają się
312
771
  w środku, a zamknięcie oddaje fokus elementowi, który panel otworzył. Panel dostaje nazwę z `header`
313
- (`aria-labelledby`). W `kpt-drawer` `Escape` respektuje `dismissible` — wcześniej zamykał też panel,
772
+ (`aria-labelledby`). W `kpt-drawer` `Escape` respektuje `dismissible` - wcześniej zamykał też panel,
314
773
  którego nie dało się zamknąć przyciskiem. Tło obu paneli idzie teraz za `--kpt-color-overlay-scrim`,
315
774
  jak w `kpt-dialog`, zamiast stałych 45% czerni.
316
775
 
317
- `kpt-popover` (oba porty): `placement` był zadeklarowany, ale pomijany — teraz wybiera preferowaną
776
+ `kpt-popover` (oba porty): `placement` był zadeklarowany, ale pomijany - teraz wybiera preferowaną
318
777
  stronę. Angular dostał model `[(open)]` (React miał już `open`/`onOpenChange`), więc dymek da się
319
778
  zamknąć z kodu. Kontrolka wyzwalacza ogłasza `aria-haspopup="dialog"`, `aria-expanded` i `aria-controls`,
320
779
  otwarcie przenosi fokus do pierwszego interaktywnego elementu dymka, a zamknięcie oddaje go
@@ -334,14 +793,14 @@
334
793
 
335
794
  `kpt-menubar` (oba porty): belka nie miała klawiatury. Teraz to jeden przystanek Tab, strzałki
336
795
  w lewo/prawo chodzą po pozycjach górnych, strzałka w dół (i `Enter`/spacja) otwiera pod-menu
337
- z fokusem na pierwszej pozycji, w górę — na ostatniej, a w otwartym pod-menu strzałki w bok
796
+ z fokusem na pierwszej pozycji, w górę - na ostatniej, a w otwartym pod-menu strzałki w bok
338
797
  przechodzą do sąsiedniego. `Escape` oddaje fokus belce. Pozycje górne ogłaszają `aria-haspopup`,
339
- `aria-expanded` i `aria-controls`. `role="menubar"` przeniósł się z `<nav>` na `<div>` — wcześniej
798
+ `aria-expanded` i `aria-controls`. `role="menubar"` przeniósł się z `<nav>` na `<div>` - wcześniej
340
799
  nadpisywał rolę punktu orientacyjnego. Nowy input/prop `ariaLabel` nazywa belkę.
341
800
 
342
801
  `kpt-megamenu` (oba porty): ta sama klawiatura co w `kpt-menubar`. Odnośniki w panelu dostały
343
802
  `role="menuitem"`, kolumny są grupami nazwanymi tytułem, a panel ma nazwę otwartej pozycji.
344
- Pozycja górna bez kolumn działa jak akcja — emituje `selected` zamiast otwierać pusty panel —
803
+ Pozycja górna bez kolumn działa jak akcja - emituje `selected` zamiast otwierać pusty panel -
345
804
  i nie pokazuje strzałki. Nowy input/prop `ariaLabel`.
346
805
 
347
806
  - dcdb1b4: Kontrast, kierunek pisania i porządki w sześciu komponentach.
@@ -349,15 +808,15 @@
349
808
  - `kpt-scroll-top` (Angular): nasłuch przewijania jest zdejmowany przy zniszczeniu komponentu
350
809
  (wcześniej zostawał podpięty do okna) i podpinany od nowa po zmianie `target`/`threshold`.
351
810
  W obu portach: przycisk stoi w rogu po stronie końca (`inset-inline-end`), więc w RTL przenosi się
352
- na lewo, a przy `prefers-reduced-motion` przewijanie to skok, a pojawienie się — bez przejścia.
811
+ na lewo, a przy `prefers-reduced-motion` przewijanie to skok, a pojawienie się - bez przejścia.
353
812
  - `kpt-skeleton`: baza `--kpt-color-muted` zamiast `--kpt-color-surface-variant`, który w jasnym
354
813
  motywie był prawie niewidoczny na powierzchni. Pojedyncza linia (`lines=1`) ma pełną szerokość.
355
814
  - `kpt-badge`: tekst wariantów `success`/`warning`/`info`/`danger` idzie za tokenami `*-contrast`,
356
- tymi samymi co w `kpt-button` — wcześniej `--kpt-color-surface`, ciemny w ciemnym motywie.
815
+ tymi samymi co w `kpt-button` - wcześniej `--kpt-color-surface`, ciemny w ciemnym motywie.
357
816
  - `kpt-spinner`: grubość pierścienia rośnie z rozmiarem (8%, co najmniej 2px).
358
817
  - `kpt-galleria`: strzałki na tokenach powierzchni zamiast stałej czerni z bielą.
359
818
  - `kpt-image`: maska po najechaniu na `--kpt-color-overlay-scrim`, lupa na krążku w kolorach
360
- powierzchni — czytelna w obu motywach.
819
+ powierzchni - czytelna w obu motywach.
361
820
  - llms: pełna lista 95 wbudowanych ikon, poprawny opis koloru spinnera (domyślnie primary,
362
821
  `color: inherit` dla koloru otoczenia), domyślny wariant plakietki.
363
822
 
@@ -385,7 +844,7 @@
385
844
 
386
845
  - f6999a7: `KptBackdrop` nie wywraca już renderowania po stronie serwera.
387
846
 
388
- Komponent buduje się w `afterNextRender`, więc na serwerze nie powstawało nic — ale niszczenie
847
+ Komponent buduje się w `afterNextRender`, więc na serwerze nie powstawało nic - ale niszczenie
389
848
  wykonuje się i tam, bo Angular tworzy komponent, zbiera z niego HTML i od razu go niszczy.
390
849
  Sprzątanie zdejmowało nasłuch `visibilitychange` bezwarunkowo, a `document` nie istnieje wtedy
391
850
  jako zmienna globalna: platforma serwerowa podaje go przez wstrzykiwanie zależności.
@@ -396,8 +855,8 @@
396
855
 
397
856
  Drugą rzeczą z tej samej rodziny jest `getContext('2d')`. Wbrew nazwie `afterNextRender`
398
857
  wykonuje się przy prerenderingu, a tamtejsza atrapa DOM canvasu nie implementuje i **rzuca**,
399
- zamiast zwrócić `null` — więc stojąca tuż niżej bramka na brak kontekstu sama nie wystarczała.
400
- Wyjątek lądował w logu jako gołe „NotYetImplemented" i nie wskazywał na nic. Płótno, na którym
858
+ zamiast zwrócić `null` - więc stojąca tuż niżej bramka na brak kontekstu sama nie wystarczała.
859
+ Wyjątek lądował w logu jako gołe "NotYetImplemented" i nie wskazywał na nic. Płótno, na którym
401
860
  nie da się rysować, jest teraz traktowane jak brak płótna: nie ma czego budować.
402
861
  - @konce-pt/backdrop@0.9.1
403
862
  - @konce-pt/chart@0.9.1
@@ -416,32 +875,32 @@
416
875
 
417
876
  - 45b2f99: `KptButton` dostaje ikony, wariant link, `<a>` i pełną paletę statusów.
418
877
 
419
- Wsparcie ikon w przycisku do tej pory nie istniało — przykłady działały przypadkiem. `.kpt-button__content`
420
- było zwykłym inline `<span>` bez `display:flex` i bez `gap`, więc odstęp ikona↔tekst brał się z literalnej
878
+ Wsparcie ikon w przycisku do tej pory nie istniało - przykłady działały przypadkiem. `.kpt-button__content`
879
+ było zwykłym inline `<span>` bez `display:flex` i bez `gap`, więc odstęp ikona<->tekst brał się z literalnej
421
880
  spacji w szablonie: wystarczyło sformatować szablon na dwie linie i odstęp znikał. Token
422
881
  `--kpt-button-gap` był przy tym martwy, bo `gap` siedział na `.kpt-button`, który bez `loading` miał jedno
423
882
  dziecko. Ikona siadała na linii bazowej zamiast na środku, a jej rozmiar szedł za `font-size` przycisku,
424
- czyli 13 px przy `size="sm"` — zupełnie inna skala niż w `kpt-icon-button`.
883
+ czyli 13 px przy `size="sm"` - zupełnie inna skala niż w `kpt-icon-button`.
425
884
 
426
885
  Teraz są dwie drogi i jeden wynik. `icon` i `iconEnd` biorą nazwę z rejestru i renderuje je komponent;
427
886
  to, co wstawisz do slotu, układa się tak samo. Jedno i drugie dostaje odstęp z tokena i rozmiar idący za
428
887
  `size` (0.875rem przy `xs` do 1.5rem przy `xl`). `iconClass` / `iconEndClass` (w React `iconClassName` /
429
888
  `iconEndClassName`) dokładają klasę obok stałego haka `.kpt-button__icon`.
430
889
 
431
- `loading` podmienia ikonę wiodącą na spinner, zamiast stawać obok niej — wcześniej dostawało się spinner,
890
+ `loading` podmienia ikonę wiodącą na spinner, zamiast stawać obok niej - wcześniej dostawało się spinner,
432
891
  ikonę i tekst w jednym rzędzie. Spinner bierze przy tym rozmiar ikony, więc etykieta nie przeskakuje
433
892
  w momencie wejścia w ładowanie; w przycisku bez ikony spinner urósł z 1em do skali ikony i to jedyna
434
893
  widoczna zmiana w istniejących użyciach.
435
894
 
436
895
  Doszło pięć wariantów: `elevated` (cień z `--kpt-shadow-sm`, na hover `md`), `link` (podkreślenie,
437
- przezroczyste tło, zero paddingu bocznego — inaczej niż `text`, który ma tło na hover) oraz `success`,
896
+ przezroczyste tło, zero paddingu bocznego - inaczej niż `text`, który ma tło na hover) oraz `success`,
438
897
  `warning` i `info`. Tokeny semantyczne na te trzy statusy istniały w bibliotece od dawna, tylko przycisk
439
898
  po nie nie sięgał. Przy okazji `danger` przestał liczyć kolory `color-mix` w SCSS i dostał własne tokeny
440
899
  komponentowe, jak każdy inny wariant.
441
900
 
442
901
  Skala rozmiarów rozszerza się o `xs` i `xl`; `md` zostaje bez zmiany.
443
902
 
444
- `href` renderuje `<a class="kpt-button">` zamiast `<button>` — to domyka jedyną asymetrię portów w tym
903
+ `href` renderuje `<a class="kpt-button">` zamiast `<button>` - to domyka jedyną asymetrię portów w tym
445
904
  komponencie, bo React miał `asChild`, a Angular nie miał nic i `<a>` ze stylem przycisku wymagał własnego
446
905
  CSS-a (z podkreśleniem z resetu w gratisie). Wyłączony odnośnik traci `href`, a nie tylko dostaje atrybut,
447
906
  więc nie da się go kliknąć ani wejść na niego Tabem; dostaje też `aria-disabled` i `tabindex="-1"`.
@@ -449,8 +908,8 @@
449
908
  przed `href`. Wygląd wyłączenia bierze się teraz z `:is(:disabled, [aria-disabled='true'])`, bo `<a>` nie
450
909
  matchuje `:disabled`.
451
910
 
452
- `KptButtonGroup` renderował wyłącznie `{{ opt.label }}`, choć segmentowany przełącznik — widok listy czy
453
- siatki, wyrównanie tekstu — jest najbardziej „ikonowym" komponentem rodziny. `KptOption` dostaje
911
+ `KptButtonGroup` renderował wyłącznie `{{ opt.label }}`, choć segmentowany przełącznik - widok listy czy
912
+ siatki, wyrównanie tekstu - jest najbardziej "ikonowym" komponentem rodziny. `KptOption` dostaje
454
913
  opcjonalne pole `icon`, a grupa je rysuje w tej samej skali co przycisk. Nowe wejście `iconOnly` chowa
455
914
  etykiety i przenosi je do `aria-label` oraz `title`, a pozycje robią się kwadratami.
456
915
 
@@ -463,8 +922,8 @@
463
922
 
464
923
  - 120d1b0: `KptDialog` dostaje szerokość, a jego stopka przestaje ucinać przyciski.
465
924
 
466
- Okno miało dotąd jedną szerokość — `min(32rem, calc(100vw - 2rem))` — wpisaną na sztywno w arkusz,
467
- bez żadnego wejścia, które by ją zmieniło, w obu portach. 512 px wystarcza na pytanie „usunąć?"
925
+ Okno miało dotąd jedną szerokość - `min(32rem, calc(100vw - 2rem))` - wpisaną na sztywno w arkusz,
926
+ bez żadnego wejścia, które by ją zmieniło, w obu portach. 512 px wystarcza na pytanie "usunąć?"
468
927
  i dwa przyciski, ale nie na treść, której nie da się sensownie zwęzić: kod, tabelę, porównanie
469
928
  dwóch kolumn. Jedyną drogą było sięgnięcie z aplikacji do wnętrza komponentu selektorem, czyli
470
929
  dokładnie to, czego zabrania kontrakt bloków.
@@ -472,47 +931,47 @@
472
931
  Nowe wejście `size`: `sm` 24rem, `md` 32rem, `lg` 48rem. Domyślne `md` to **dzisiejsza wartość**,
473
932
  więc żadne istniejące okno nie zmienia szerokości. Przycięcie do okna przeglądarki obowiązuje
474
933
  w każdym rozmiarze, bo to ono, a nie stała, decyduje na telefonie. Szerokość idzie przez prywatne
475
- `--_width`, zgodnie z kontraktem komponentu — warianty przestawiają jedną liczbę zamiast powtarzać
934
+ `--_width`, zgodnie z kontraktem komponentu - warianty przestawiają jedną liczbę zamiast powtarzać
476
935
  całe `min()`.
477
936
 
478
937
  **Stopka zawija.** `[kptDialogFooter]` dostaje `flex-wrap: wrap` i to jest naprawa błędu, nie
479
938
  kosmetyka. Przeglądarka daje `<dialog>` własny kontener przewijania (`overflow: auto` z jej
480
- arkusza), więc przyciski, które nie mieszczą się w szerokości okna, **nie wystają — zostają
939
+ arkusza), więc przyciski, które nie mieszczą się w szerokości okna, **nie wystają - zostają
481
940
  ucięte**. Cztery przyciski w oknie `sm` wystarczały, żeby pierwszy z nich stał się nieczytelny
482
941
  i nie do klikniecia, bez żadnego sygnału, że coś jest nie tak. Teraz przechodzą do drugiego rzędu.
483
942
 
484
943
  Typ `KptDialogSize` eksportowany z obu portów. Arkusz jest wspólny, więc `@konce-pt/styles/components`
485
- niesie warianty dla Reacta bez osobnego kodu — stąd ta paczka na liście.
944
+ niesie warianty dla Reacta bez osobnego kodu - stąd ta paczka na liście.
486
945
 
487
946
  - 269238e: `KptProgress` pokazuje wartość, buforuje i porządnie się kręci.
488
947
 
489
- Pasek postępu mówił dotąd wyłącznie geometrią. Użytkownik widział, że jest „gdzieś koło trzech
948
+ Pasek postępu mówił dotąd wyłącznie geometrią. Użytkownik widział, że jest "gdzieś koło trzech
490
949
  czwartych", ale nie wiedział, czy to 73% czy 78%, ani ile z ilu. Doszedł obszar etykiety: `showValue`
491
- go otwiera, a `valueFormat` decyduje o treści — `percent` daje `80%`, `fraction` składa `152 / 160`
950
+ go otwiera, a `valueFormat` decyduje o treści - `percent` daje `80%`, `fraction` składa `152 / 160`
492
951
  z `value` i `max`, `none` zostawia pusto. Oba napisy idą przez słownik (`progress.percent`,
493
952
  `progress.fraction`), więc nowy język może im zmienić kształt. `label` dokłada tekst opisowy obok
494
953
  paska, a `labelPosition` sadza wiersz nad paskiem, pod nim albo w tej samej linii.
495
954
 
496
955
  Rzutowana treść (`ng-content` / `children`) zastępuje sformatowaną wartość zamiast się do niej
497
- dokładać — tak w środku koła staje duża liczba nad podpisem, zamiast samego procentu.
956
+ dokładać - tak w środku koła staje duża liczba nad podpisem, zamiast samego procentu.
498
957
 
499
958
  Skala przestała być zaszyta: `min` i `max` opisują dowolny zakres, a wartości spoza niego są
500
- przycinane, nie odrzucane. Domyślne 0–100 zachowują dotychczasowe zachowanie co do znaku.
959
+ przycinane, nie odrzucane. Domyślne 0-100 zachowują dotychczasowe zachowanie co do znaku.
501
960
 
502
- `bufferValue` rysuje drugi, przygaszony pasek za głównym — pobrane, ale jeszcze nieodtworzone.
961
+ `bufferValue` rysuje drugi, przygaszony pasek za głównym - pobrane, ale jeszcze nieodtworzone.
503
962
  Bufor nigdy nie cofa się za pasek główny, bo wyglądałby wtedy jak błąd renderowania.
504
963
 
505
964
  `size` (`sm`/`md`/`lg`) steruje grubością szyny i szerokością łuku; `md` to dotychczasowa grubość,
506
965
  więc istniejące paski wyglądają tak samo.
507
966
 
508
- Tryb nieokreślony dostał własne klatki animacji zamiast pożyczonych z `kpt-spinner` — pasek liniowy
967
+ Tryb nieokreślony dostał własne klatki animacji zamiast pożyczonych z `kpt-spinner` - pasek liniowy
509
968
  rozciąga się i kurczy w przebiegu, łuk kołowy obraca się razem z pulsującą długością. Przy
510
969
  `prefers-reduced-motion: reduce` animacja zwalnia, zamiast się zatrzymać: zamrożony wskaźnik postępu
511
- czyta się jak zawieszona aplikacja. Zniknął też hack `width: 40% !important` — nieokreślony pasek po
970
+ czyta się jak zawieszona aplikacja. Zniknął też hack `width: 40% !important` - nieokreślony pasek po
512
971
  prostu nie dostaje już szerokości z szablonu.
513
972
 
514
973
  Dostępność: doszły `aria-valuemin` i `aria-valuemax`, przy `valueFormat="fraction"` także
515
- `aria-valuetext` (czytnik mówi „152 / 160", a nie odczytuje surowej liczby jako procentu), widoczna
974
+ `aria-valuetext` (czytnik mówi "152 / 160", a nie odczytuje surowej liczby jako procentu), widoczna
516
975
  wartość ma `aria-hidden`, a nazwa dostępna bierze się z `label` albo ze słownika.
517
976
 
518
977
  Nowe tokeny komponentowe: `--kpt-progress-track-bg`, `--kpt-progress-thickness-sm|md|lg`,
@@ -521,17 +980,17 @@
521
980
 
522
981
  Zmiana w DOM: `data-variant` przeniósł się z elementu wewnętrznego na hosta, gdzie dołączyły mu
523
982
  `data-type`, `data-size` i `data-label-position`. Arkusz dostał to samo przepięcie, więc styl
524
- biblioteczny działa bez zmian — ale aplikacja celująca własnym CSS-em w `.kpt-progress__linear[data-variant]`
983
+ biblioteczny działa bez zmian - ale aplikacja celująca własnym CSS-em w `.kpt-progress__linear[data-variant]`
525
984
  musi przepiąć selektor na hosta.
526
985
 
527
986
  ### Patch Changes
528
987
 
529
988
  - 457112a: Stonowane tła liczone z koloru akcentowego przestają wpadać w róż.
530
989
 
531
- Siedem miejsc w bibliotece mieszało barwę akcentową z powierzchnią przez `color-mix(in oklch, …)`.
532
- OKLCH interpoluje **odcień**, a barwa achromatyczna też ma odcień — biel to `oklch(1 0 0)`, czyli
990
+ Siedem miejsc w bibliotece mieszało barwę akcentową z powierzchnią przez `color-mix(in oklch, ...)`.
991
+ OKLCH interpoluje **odcień**, a barwa achromatyczna też ma odcień - biel to `oklch(1 0 0)`, czyli
533
992
  kąt 0. Zmieszanie 10% błękitu (255°) z bielą szło więc po kole odcieni od 0 w stronę 255 i przy tak
534
- małym udziale zatrzymywało się na 349,5° — różu. Tak samo zieleń (150°) wychodziła na 15°,
993
+ małym udziale zatrzymywało się na 349,5° - różu. Tak samo zieleń (150°) wychodziła na 15°,
535
994
  a bursztyn (60°) na 6°.
536
995
 
537
996
  Skutek był widoczny gołym okiem i mylący: **wszystkie cztery warianty `kpt-alert` miały to samo
@@ -539,13 +998,13 @@
539
998
  znaczyć. To samo dotyczyło tła wybranego chipa, strefy upuszczania pliku, zaznaczenia w roadmapie
540
999
  i stanu hover przycisku ikonowego w wariancie niebezpiecznym.
541
1000
 
542
- Naprawa to zmiana przestrzeni na `oklab` — ta sama przestrzeń percepcyjna, ale we współrzędnych
1001
+ Naprawa to zmiana przestrzeni na `oklab` - ta sama przestrzeń percepcyjna, ale we współrzędnych
543
1002
  prostokątnych, więc mieszanie nie przechodzi przez kąt i barwa achromatyczna niczego nie ciągnie.
544
1003
  Po zmianie tła niosą odcień swojego akcentu: info 255°, success 150°, warning 60°, danger 27°.
545
- Idiom jest w repozytorium ustalony — `auth.component.scss` używał `in oklab` od początku, a te
1004
+ Idiom jest w repozytorium ustalony - `auth.component.scss` używał `in oklab` od początku, a te
546
1005
  siedem miejsc było odstępstwem.
547
1006
 
548
- Pozostałe 54 wystąpienia `color-mix(in oklch, …)` zostają bez zmian i **są poprawne**: mieszają
1007
+ Pozostałe 54 wystąpienia `color-mix(in oklch, ...)` zostają bez zmian i **są poprawne**: mieszają
549
1008
  z `transparent`, a przy przezroczystym końcu CSS premnaża alfę, więc kanały barwy nie są
550
1009
  interpolowane i odcień przeżywa.
551
1010
 
@@ -570,33 +1029,33 @@
570
1029
  - f615e93: Nowe wejście `adaptive` w `KptBackdrop`: barwy wpisane na sztywno przenoszą się na powierzchnię
571
1030
  bieżącego motywu.
572
1031
 
573
- Literał z założenia stoi w miejscu i tak ma być — `#5b8af2` to barwa marki, a nie sugestia.
1032
+ Literał z założenia stoi w miejscu i tak ma być - `#5b8af2` to barwa marki, a nie sugestia.
574
1033
  Ale sekcja z `color="#000000"` na `background="#ffffff"` w motywie ciemnym zostawała białą kartą
575
1034
  wyciętą w ciemnej stronie, razem z treścią dobraną do tamtego tła. Do tej pory jedynym wyjściem
576
1035
  było przepisanie wejść na tokeny; teraz wystarczy `[adaptive]="true"`.
577
1036
 
578
1037
  Adaptacja przenosi `color`, `colors` i `background` na powierzchnię bieżącego motywu, zachowując
579
1038
  odległość każdej barwy od tej powierzchni: czerń dobrana do bieli wychodzi bielą na tle
580
- `neutral-950`, a białe tło wychodzi w jasności samej powierzchni. Rusza wyłącznie jasność — `a`
1039
+ `neutral-950`, a białe tło wychodzi w jasności samej powierzchni. Rusza wyłącznie jasność - `a`
581
1040
  i `b` w OKLab zostają nietknięte, więc odcień i nasycenie przeżywają i barwa marki nie zmienia się
582
1041
  w inną barwę, tylko dobiera jasność do tła. Jasność wypychająca wynik poza sRGB zostaje przycięta
583
1042
  w drodze powrotnej, co kosztuje około trzech stopni odcienia i dziesiątą część nasycenia; za tłem
584
1043
  sekcji to niewidoczne, a własne mapowanie gamutu byłoby kosztem bez pokrycia.
585
1044
 
586
- Rusza wyłącznie literały. Puste wejście bierze token, a zapis przez `var()` też sięga po token —
1045
+ Rusza wyłącznie literały. Puste wejście bierze token, a zapis przez `var()` też sięga po token -
587
1046
  jedno i drugie już idzie za motywem i adaptacja odwróciłaby je drugi raz, czyli z powrotem.
588
1047
  Punktem odniesienia jest motyw jasny, bo biblioteka trzyma jasny w `:root`, a ciemny jako
589
1048
  nadpisanie; to jedyne założenie, jakie ta zamiana robi.
590
1049
 
591
- W rdzeniu doszły `adaptLightness()` i `adaptToSurface()` — czysta arytmetyka z testami
592
- `node --test` — oraz `readBackdropSurface()` i `adaptBackdropValue()` spinające je z drzewem.
1050
+ W rdzeniu doszły `adaptLightness()` i `adaptToSurface()` - czysta arytmetyka z testami
1051
+ `node --test` - oraz `readBackdropSurface()` i `adaptBackdropValue()` spinające je z drzewem.
593
1052
  Strażnik przebudowy liczy teraz kolor wiodący tą samą drogą co budowa; inaczej porównywałby
594
1053
  wartość sprzed adaptacji z zapamiętaną po adaptacji i przebudowywał renderer bez końca.
595
1054
 
596
1055
  - f615e93: Sekcja z własnym tłem dobiera kolor treści do tego tła i ogłasza ton atrybutem `data-tone`.
597
1056
 
598
1057
  Host malował `--kpt-color-surface` i zostawiał treści `--kpt-color-on-surface`. To jest słuszne,
599
- dopóki sekcja nie dostanie własnego `background` — wtedy ten token opisuje stronę dookoła, a nie
1058
+ dopóki sekcja nie dostanie własnego `background` - wtedy ten token opisuje stronę dookoła, a nie
600
1059
  to, na czym treść naprawdę leży. Sekcja z ciemnym tłem w motywie jasnym miała `color` prawie czarny
601
1060
  na prawie czarnym tle, czyli treść niewidoczną. Każdy konsument musiał to obchodzić sam; demo
602
1061
  playgroundu obchodziło, licząc jasność tła po swojej stronie, więc błąd nie był widoczny akurat
@@ -604,48 +1063,48 @@
604
1063
 
605
1064
  Teraz komponent liczy to sam: `color` na hoście idzie pod tło, które sekcja naprawdę maluje,
606
1065
  a wynik wychodzi na zewnątrz jako `data-tone` (`light` przy jasnym tle, `dark` przy ciemnym).
607
- Napis bierze kolor dziedziczeniem, a to, czemu sam kolor tekstu nie wystarcza — przyciski i inne
608
- komponenty w sekcji — podwiesza własne tokeny pod atrybut:
1066
+ Napis bierze kolor dziedziczeniem, a to, czemu sam kolor tekstu nie wystarcza - przyciski i inne
1067
+ komponenty w sekcji - podwiesza własne tokeny pod atrybut:
609
1068
 
610
1069
  :where(kpt-backdrop[data-tone='light']) .hero { --kpt-button-filled-bg: #15181a; }
611
1070
 
612
1071
  Ton liczy się po adaptacji, więc pod `adaptive` zgadza się z tłem malowanym, a nie z wpisanym
613
1072
  w szablonie. Sekcja bez własnego `background` nie ogłasza nic i treść zostaje na
614
- `--kpt-color-on-surface` — dla niej nic się nie zmienia.
1073
+ `--kpt-color-on-surface` - dla niej nic się nie zmienia.
615
1074
 
616
1075
  O kontraście rozstrzyga jasność względna WCAG (`relativeLuminance`, `prefersDarkContent`
617
1076
  w rdzeniu, z testami), a nie jasność OKLab: pierwsza mówi, ile z barwy wychodzi światła, druga jak
618
1077
  jasno barwa wygląda, i tylko na pierwszej stoi rachunek kontrastu.
619
1078
 
620
- Playground dostał przełącznik „Idź za motywem" dla `adaptive` i przestał liczyć jasność tła po
621
- swojej stronie — podpina się pod `data-tone` komponentu, więc jedna polityka zamiast dwóch.
1079
+ Playground dostał przełącznik "Idź za motywem" dla `adaptive` i przestał liczyć jasność tła po
1080
+ swojej stronie - podpina się pod `data-tone` komponentu, więc jedna polityka zamiast dwóch.
622
1081
 
623
1082
  - f615e93: Rampa `colors` w `KptBackdrop` przyjmuje dowolny zapis CSS, nie tylko heksadecymalny.
624
1083
 
625
1084
  Wstęga miesza barwy po biegunowej postaci OKLab, ale dostawały się tam dotąd wyłącznie przystanki
626
- sparsowane przez `parseHexColor` — czyli `#rgb` i `#rrggbb`. `oklch()`, `color-mix()`, `rgb()`,
1085
+ sparsowane przez `parseHexColor` - czyli `#rgb` i `#rrggbb`. `oklch()`, `color-mix()`, `rgb()`,
627
1086
  nazwy własne i `var(--kpt-*)` wypadały z rampy, a gdy wypadły wszystkie, renderer schodził do
628
- `IDLE` i **kadr zostawał pusty bez żadnego sygnału**. Tym dotkliwiej, że rampa domyślna — ta,
629
- której się nie podaje — od początku szła przez `readCssColor` i rozumiała każdy zapis, bo tokeny
1087
+ `IDLE` i **kadr zostawał pusty bez żadnego sygnału**. Tym dotkliwiej, że rampa domyślna - ta,
1088
+ której się nie podaje - od początku szła przez `readCssColor` i rozumiała każdy zapis, bo tokeny
630
1089
  biblioteki są zapisane w OKLCH. Podana rampa miała gorszy parser niż niepodana.
631
1090
 
632
1091
  Teraz obie idą tą samą drogą: o znaczenie każdego przystanku pytamy przeglądarkę, a do renderera
633
- trafia już sam hex — jego kontrakt się nie zmienia. Przystanek, którego przeglądarka nie przyjmuje,
1092
+ trafia już sam hex - jego kontrakt się nie zmienia. Przystanek, którego przeglądarka nie przyjmuje,
634
1093
  wypada z rampy; gdy wypadną wszystkie, wchodzi rampa wyprowadzona z koloru wiodącego, zamiast gasić
635
1094
  sekcję. Najczęstsza pomyłka, `var(--kpt-color-primary)` w rampie, i tak celuje w ten właśnie kolor,
636
1095
  więc użytkownik dostaje niemal to, o co mu chodziło, plus jedno ostrzeżenie w konsoli w buildzie
637
- dev. Wartość alfa wypada — tablica barw wstęgi jest RGB.
1096
+ dev. Wartość alfa wypada - tablica barw wstęgi jest RGB.
638
1097
 
639
1098
  `readCssColor()` zwraca `null` na wartości, której przeglądarka nie uznaje za kolor. Dotąd dawała
640
- czerń, bo `fillStyle` odrzuca taki zapis po cichu i zostaje przy poprzednim — nie dało się odróżnić
1099
+ czerń, bo `fillStyle` odrzuca taki zapis po cichu i zostaje przy poprzednim - nie dało się odróżnić
641
1100
  śmiecia od legalnej czerni ani o czymkolwiek ostrzec. Rozstrzyga to para różnych wartowników: przy
642
1101
  wartości nieprawidłowej każdy zostaje na swoim miejscu i oba przebiegi się rozchodzą. Przy okazji
643
- sonda jest czyszczona przed każdym odczytem — barwa z kanałem alfa mieszała się z tym, co zostawiło
1102
+ sonda jest czyszczona przed każdym odczytem - barwa z kanałem alfa mieszała się z tym, co zostawiło
644
1103
  poprzednie wywołanie.
645
1104
 
646
1105
  - f615e93: Wejścia koloru `KptBackdrop` rozumieją `var()`, więc barwa podana w szablonie może iść za motywem.
647
1106
 
648
- Kolor wiodący był dotąd brany z wejścia bez zmian, a sonda 1×1 jest oderwana od drzewa — zapis
1107
+ Kolor wiodący był dotąd brany z wejścia bez zmian, a sonda 1x1 jest oderwana od drzewa - zapis
649
1108
  `color="var(--kpt-color-primary)"` nie miał prawa zadziałać i lądował w ostrzeżeniu. Zamrożenie
650
1109
  literału jest poprawne (`#5b8af2` ma zostać `#5b8af2`), ale odcinało jedyny zapis, który sam
651
1110
  wiedziałby, co zrobić przy przełączeniu motywu: wyrażenie odwołujące się do tokenów.
@@ -657,40 +1116,40 @@
657
1116
  <kpt-backdrop color="color-mix(in oklab, #5b8af2, var(--kpt-color-surface) 30%)">
658
1117
 
659
1118
  daje kwadraciki, które jaśnieją na jasnej powierzchni i ciemnieją na ciemnej, przy jednej wartości
660
- w szablonie — przeliczane istniejącym już nasłuchem motywu. To samo działa dla przystanków rampy
661
- `colors`. Biblioteka nie zgaduje przy tym, jaki kolor jest „odpowiedni" w drugim motywie: decyduje
1119
+ w szablonie - przeliczane istniejącym już nasłuchem motywu. To samo działa dla przystanków rampy
1120
+ `colors`. Biblioteka nie zgaduje przy tym, jaki kolor jest "odpowiedni" w drugim motywie: decyduje
662
1121
  autor wyrażenia. Zapis bez `var()` omija całą ścieżkę, więc literał nie płaci za nic.
663
1122
 
664
- Sonda musi pisać poza zasięgiem nasłuchu motywu, bo ten ogląda `style` hosta i jego przodków —
1123
+ Sonda musi pisać poza zasięgiem nasłuchu motywu, bo ten ogląda `style` hosta i jego przodków -
665
1124
  zapis na hoście budziłby nasłuch, ten sięgałby po kolor na nowo i pętla nie miałaby końca. Stąd
666
1125
  `resolveBackdropColors()` i `readBackdropLead()` dostają teraz canvas komponentu, a nie hosta;
667
1126
  tokeny czytają się z niego tak samo, bo `--_dot` dziedziczy się w dół.
668
1127
 
669
- Nazwa zmiennej, która nic nie daje, schodzi przy `color` do tokenu — tego chce autor literówki —
1128
+ Nazwa zmiennej, która nic nie daje, schodzi przy `color` do tokenu - tego chce autor literówki -
670
1129
  a przy `colors` wypada z rampy i trafia do istniejącego ostrzeżenia w buildzie dev.
671
1130
 
672
- - c1f8885: Nowe animowane tło `KptBackdrop` (`kpt-backdrop`) i pod nim nowa paczka `@konce-pt/backdrop` —
1131
+ - c1f8885: Nowe animowane tło `KptBackdrop` (`kpt-backdrop`) i pod nim nowa paczka `@konce-pt/backdrop` -
673
1132
  rdzeń pure-TS z testami `node --test`. Komponent jest opakowaniem sekcji: canvas leży pod spodem,
674
1133
  rzutowana treść warstwę wyżej i zachowuje się zwyczajnie, więc pod hero z nagłówkiem i przyciskami
675
1134
  nie trzeba układać niczego ręcznie.
676
1135
 
677
- Efekt `signal-grid` to drobna siatka kwadratów, które cicho migoczą — gęsta przy krawędzi wskazanej
1136
+ Efekt `signal-grid` to drobna siatka kwadratów, które cicho migoczą - gęsta przy krawędzi wskazanej
678
1137
  przez `anchor`, wygasająca do pustki przy przeciwnej. Gradient bierze się z tego, **ile** kwadratów
679
1138
  się pali, a nie z przezroczystości nałożonej na równomierną siatkę: to różnica między czymś, co
680
1139
  czyta się jak sygnał, a fakturą z maską na wierzchu. Sterują tym `density` (udział zapalonych
681
1140
  komórek przy kotwicy) i `falloff` (jak szybko to gaśnie), a rozstawem `cell` i `gap`.
682
1141
 
683
- Każda komórka wylicza swoje losowania — czy się pali, fazę i tempo migotania — z własnej kolumny
1142
+ Każda komórka wylicza swoje losowania - czy się pali, fazę i tempo migotania - z własnej kolumny
684
1143
  i wiersza przez `kptHash01()`. Siatka nie może trzymać stanu między klatkami, bo przy zmianie
685
1144
  rozmiaru komórki wędrują i tablica `Math.random()` rozsypałaby cały obraz; przy losowaniu
686
1145
  z pozycji układ przeżywa zmianę rozmiaru okna zamiast tasować się od nowa. Tempa są rozstrzelone
687
- w przedziale 0,45–1,55, bo przy jednym tempie cała siatka pulsuje zgodnie i zamiast migotania
688
- wychodzi oddech. Siatka celowo wychodzi poza obszar, a nadmiar jest ucinany — siatka kończąca się
1146
+ w przedziale 0,45-1,55, bo przy jednym tempie cała siatka pulsuje zgodnie i zamiast migotania
1147
+ wychodzi oddech. Siatka celowo wychodzi poza obszar, a nadmiar jest ucinany - siatka kończąca się
689
1148
  przed krawędzią wygląda na uciętą.
690
1149
 
691
1150
  Rysowanie stoi, gdy nie ma czego oglądać: sekcja poza ekranem (`IntersectionObserver`), karta w tle,
692
1151
  ustawione `paused`, `speed` równe zeru albo `prefers-reduced-motion`, o który komponent pyta sam.
693
- Zostaje wtedy jedna statyczna klatka ze zróżnicowaną jasnością, nie pustka — efekt jest częścią
1152
+ Zostaje wtedy jedna statyczna klatka ze zróżnicowaną jasnością, nie pustka - efekt jest częścią
694
1153
  kompozycji, nie ozdobą. `speed` wchodzi w zegar (`clock += krok * speed`), a nie w fazę, więc suwak
695
1154
  prędkości przyspiesza obraz zamiast go przeskakiwać.
696
1155
 
@@ -698,19 +1157,19 @@
698
1157
  wejściami `color` i `background` albo własnościami `--kpt-backdrop-color` i `--kpt-backdrop-surface`,
699
1158
  bo sekcja promocyjna bywa w kolorach spoza palety aplikacji. Canvas nie rozwija `var()`, więc token
700
1159
  odczytuje się z wyliczonego stylu hosta i na nowo po zmianie motywu. Canvas nosi `aria-hidden="true"`
701
- i `pointer-events: none` — to dekoracja bez treści i bez niczego do trafienia.
1160
+ i `pointer-events: none` - to dekoracja bez treści i bez niczego do trafienia.
702
1161
 
703
1162
  Rdzeń (`buildSignalGrid`, `signalGridAlpha`, `signalGridDensity`, `kptHash01`) jest re-eksportowany
704
1163
  z `@konce-pt/angular`, więc aplikacja nie instaluje paczki samodzielnie, a ten sam efekt da się
705
1164
  narysować własnym rendererem. Port Reacta dostanie komponent osobno.
706
1165
 
707
- - c1f8885: Drugi efekt tła — `wave` — i `KptBackdrop` w porcie Reacta.
1166
+ - c1f8885: Drugi efekt tła - `wave` - i `KptBackdrop` w porcie Reacta.
708
1167
 
709
1168
  `wave` to jedna miękka wstęga światła płynąca przez kadr, z barwami przesuwającymi się wzdłuż niej
710
1169
  i bez twardej krawędzi w całym obrazie. Linia środkowa jest sumą harmonicznych o niewspółmiernych
711
1170
  częstotliwościach, więc prąd faluje bez powtarzalnego wzoru; jasność opada od niej krzywą Gaussa
712
1171
  i to opadanie odróżnia prąd światła od paska. Nowe wejścia: `colors` (rampa barw), `rotation`
713
- (kąt, pod jakim prąd przecina kadr — odpowiednik `anchor` z signal-grid, tyle że płynny), `band`
1172
+ (kąt, pod jakim prąd przecina kadr - odpowiednik `anchor` z signal-grid, tyle że płynny), `band`
714
1173
  i `amplitude`. Wejście nienależące do bieżącego efektu po prostu nie jest czytane.
715
1174
 
716
1175
  Rampa barw jest zamknięta w pętlę i mieszana po **biegunowej** postaci OKLab. Interpolacja sRGB
@@ -718,13 +1177,13 @@
718
1177
  dla przeciwnych odcieni: w połowie drogi z niebieskiego w żółty zostaje szarość dokładnie tam,
719
1178
  gdzie prąd świeci najmocniej. Odcień idzie krótszym łukiem, a przystanek bez nasycenia przejmuje
720
1179
  odcień sąsiada, bo `atan2` na zerowym nasyceniu zwraca kąt przypadkowy. Bez podanego `colors` rampą
721
- jest `--kpt-color-primary` i dwie barwy wyprowadzone z niego obrotem odcienia — paleta biblioteki
1180
+ jest `--kpt-color-primary` i dwie barwy wyprowadzone z niego obrotem odcienia - paleta biblioteki
722
1181
  jest neutralna, więc sięganie po tokeny statusowe do celów dekoracyjnych byłoby użyciem semantyki
723
1182
  nie na miejscu.
724
1183
 
725
1184
  Wstęga liczy się w buforze o dłuższym boku 160 px i jest skalowana w górę: miękkość bierze się
726
1185
  z interpolacji przeglądarki, więc kilka tysięcy pikseli na klatkę obsługuje kadr dowolnej
727
- wielkości. Krótszy bok ma osobną podłogę 72 próbek — przy proporcjonalnym skalowaniu szeroki kadr
1186
+ wielkości. Krótszy bok ma osobną podłogę 72 próbek - przy proporcjonalnym skalowaniu szeroki kadr
728
1187
  miałby kilkadziesiąt wierszy i prąd obrócony blisko kąta prostego łamałby się właśnie wzdłuż tej
729
1188
  osi.
730
1189
 
@@ -733,8 +1192,8 @@
733
1192
  i stałe cyklu życia) mieszka teraz w rdzeniu, a komponent w obu portach jest samym cyklem życia:
734
1193
  rAF, `ResizeObserver`, `IntersectionObserver`, zapytanie o ograniczony ruch i obserwator motywu.
735
1194
  Te same wejścia dają dzięki temu tę samą klatkę w Angularze i w Reakcie. Doszedł też
736
- `readCssColor()` — tokeny są zapisane w OKLCH, a rampę trzeba wymieszać, nie tylko podać dalej,
737
- więc o znaczenie zapisu pytamy przeglądarkę, malując kolor na canvasie 1×1.
1195
+ `readCssColor()` - tokeny są zapisane w OKLCH, a rampę trzeba wymieszać, nie tylko podać dalej,
1196
+ więc o znaczenie zapisu pytamy przeglądarkę, malując kolor na canvasie 1x1.
738
1197
 
739
1198
  `@konce-pt/react` dostaje `KptBackdrop` z kompletem propsów obu efektów, ten sam DOM i ten sam
740
1199
  arkusz `components.css`. Zmianę `colors` śledzi po treści tablicy, nie po jej tożsamości, więc
@@ -742,24 +1201,24 @@
742
1201
 
743
1202
  - ce34ab3: Nowa rodzina `KptChat` w subpathu `@konce-pt/angular/chat`: `kpt-chat` (lista rozmowy),
744
1203
  `kpt-chat-message` (bąbel), `kpt-chat-typing` (wskaźnik pisania), `kpt-chat-composer` (pole
745
- pisania) i `kpt-chat-dock` (pływający panel w rogu, zbudowany na `kpt-fab`). Subpath, nie rdzeń —
1204
+ pisania) i `kpt-chat-dock` (pływający panel w rogu, zbudowany na `kpt-fab`). Subpath, nie rdzeń -
746
1205
  aplikacje bez czatu nie mają powodu pobierać docka razem z logiką breakpointów.
747
1206
 
748
- Nowa paczka `@konce-pt/chat` — rdzeń pure-TS z testami `node --test`. `buildChatRows()` zamienia
1207
+ Nowa paczka `@konce-pt/chat` - rdzeń pure-TS z testami `node --test`. `buildChatRows()` zamienia
749
1208
  płaską listę wiadomości na wiersze do wyrenderowania: separatory dni, dzielnik nieprzeczytanych
750
1209
  i pozycję w grupie, z której wynika zapadnięty narożnik, ogonek, awatar i wiersz z godziną.
751
1210
  Grupa łamie się na zmianie autora, przerwie powyżej pięciu minut, granicy doby kalendarzowej,
752
1211
  wiadomości systemowej i dzielniku nieprzeczytanych. Doba liczona jest od północy do północy,
753
- a nie odejmowaniem znaczników czasu — doba ze zmianą czasu ma 23 albo 25 godzin, więc „wczoraj
1212
+ a nie odejmowaniem znaczników czasu - doba ze zmianą czasu ma 23 albo 25 godzin, więc "wczoraj
754
1213
  o 23:30" wypadałoby raz do roku o dzień obok.
755
1214
 
756
1215
  Nieudana wysyłka umie o sobie powiedzieć: `status: 'failed'` obwodzi bąbel kolorem
757
1216
  `--kpt-color-danger-border` i stawia strzałkę ponowienia **poza** nim, po zewnętrznej stronie
758
- listy. Taki bąbel pokazuje wiersz meta nawet w środku grupy — strzałka bez niczego, co ją
1217
+ listy. Taki bąbel pokazuje wiersz meta nawet w środku grupy - strzałka bez niczego, co ją
759
1218
  tłumaczy, byłaby zagadką. Pasek `[offline]` liczy wiadomości czekające na wysłanie przez
760
1219
  `pendingCount()`. Potwierdzenia z serwera przychodzą nie po kolei, więc `mergeStatus()` zostawia
761
- wyższy stopień: spóźnione „dostarczone" nie cofnie `read`. Wyjątkiem jest `failed`, który wygrywa
762
- zawsze — wiadomość odrzucona po wysłaniu nie może zostać na zawsze „wysłana".
1220
+ wyższy stopień: spóźnione "dostarczone" nie cofnie `read`. Wyjątkiem jest `failed`, który wygrywa
1221
+ zawsze - wiadomość odrzucona po wysłaniu nie może zostać na zawsze "wysłana".
763
1222
 
764
1223
  Transport zostaje w aplikacji: komponent przyjmuje wiadomości i tylko zgłasza `(retry)`
765
1224
  oraz `(loadMore)`.
@@ -771,58 +1230,58 @@
771
1230
  `--kpt-color-muted`, przez co własny i cudzy bąbel były nie do odróżnienia. Wariant `primary`
772
1231
  zostaje jako cichsza opcja dla własnych wiadomości; wariant `muted` zniknął, bo po tej zmianie
773
1232
  powielał `neutral`. Przyklejona pigułka separatora dnia przejeżdża nad wiadomościami, więc dostała
774
- podniesione tło, ramkę i cień — bez nich zlewała się z bąblem, po którym właśnie jechała.
1233
+ podniesione tło, ramkę i cień - bez nich zlewała się z bąblem, po którym właśnie jechała.
775
1234
 
776
1235
  `kpt-scroll-top` przykleja się dokładnie w to samo miejsce co dock, z tym samym `--kpt-z-overlay`,
777
- i połykał FAB czatu w całości — wystawała sama plakietka nieprzeczytanych, a przycisku nie dało się
1236
+ i połykał FAB czatu w całości - wystawała sama plakietka nieprzeczytanych, a przycisku nie dało się
778
1237
  kliknąć. Arkusz rozwiązuje to teraz sam: przy docku `bottom-end` przycisk powrotu na górę ustępuje
779
- w bok o szerokość FAB-a. W bok, nie do góry, bo nad FAB-em stoi panel rozmowy — przesunięcie
1238
+ w bok o szerokość FAB-a. W bok, nie do góry, bo nad FAB-em stoi panel rozmowy - przesunięcie
780
1239
  w pionie zamieniłoby jedną kolizję na gorszą. Do tego `kpt-chat-dock` dostaje `offset` na wypadek
781
1240
  innych widgetów w tym rogu.
782
1241
 
783
1242
  Słownik `@konce-pt/i18n` dostaje sekcję `chat` (EN i PL). Rdzeń zwraca **rodzaj** etykiety dnia
784
- (`{ kind: 'today' }`), a nie napis — brzmienie należy do słownika, nazwa dnia tygodnia do `Intl`,
1243
+ (`{ kind: 'today' }`), a nie napis - brzmienie należy do słownika, nazwa dnia tygodnia do `Intl`,
785
1244
  a paczka bez zależności nie ma po co wozić tłumaczeń.
786
1245
 
787
1246
  Port Reacta dostaje subpath `@konce-pt/react/chat` z kompletem pięciu komponentów na tym samym
788
- rdzeniu i tym samym arkuszu `components.css` — te same klasy `kpt-*` i te same atrybuty `data-*`,
1247
+ rdzeniu i tym samym arkuszu `components.css` - te same klasy `kpt-*` i te same atrybuty `data-*`,
789
1248
  więc oba porty renderują identycznie. `model()` z Angulara rozpada się na pary
790
1249
  controlled/uncontrolled (`value`/`defaultValue`/`onValueChange`, `open`/`defaultOpen`/`onOpenChange`),
791
1250
  a `<ng-template let-message>` na `renderMessage(message, row)`.
792
1251
 
793
1252
  Zestaw wbudowany `@konce-pt/icons` rośnie z 86 do 92 ikon: `checks`, `paperclip`, `send`,
794
1253
  `message-circle`, `corner-up-left`, `mood-smile`. Bez `checks` nie dałoby się odróżnić
795
- „dostarczono" od „wysłano", a komponenty biblioteki muszą działać bez `provideKptTablerIcons()`.
1254
+ "dostarczono" od "wysłano", a komponenty biblioteki muszą działać bez `provideKptTablerIcons()`.
796
1255
 
797
1256
  - 7626e71: `KptChip` dostaje wejście `textTransform` (`'none' | 'capitalize' | 'uppercase' | 'lowercase'`,
798
1257
  domyślnie `'none'`) w obu portach. Ląduje jako `data-text-transform` na `.kpt-chip` i tam ustawia
799
1258
  `text-transform`, więc etykieta zostaje w treści zapisana po swojemu, a o sposobie jej wyświetlenia
800
- decyduje chip — pigułka nad nagłówkiem hero wygląda tak samo niezależnie od tego, czy tekst
1259
+ decyduje chip - pigułka nad nagłówkiem hero wygląda tak samo niezależnie od tego, czy tekst
801
1260
  przyszedł ze słownika, z CMS-a czy z API.
802
1261
 
803
- `capitalize` podnosi pierwszą literę każdego słowa — **także po dywizie** („Agent-Ready"), bo CSS
1262
+ `capitalize` podnosi pierwszą literę każdego słowa - **także po dywizie** ("Agent-Ready"), bo CSS
804
1263
  nie wie, gdzie kończy się wyraz złożony. Przy etykietach z myślnikiem pewniejszy jest zapis wprost
805
1264
  w treści; to samo ograniczenie ma każde `text-transform: capitalize`, a nie ta implementacja.
806
1265
 
807
- - a1c5468: `KptDataView` dostaje `pageSizeOptions`, a rozmiar strony staje się sterowalny — w Angularze
1266
+ - a1c5468: `KptDataView` dostaje `pageSizeOptions`, a rozmiar strony staje się sterowalny - w Angularze
808
1267
  `pageSize` to teraz `model`, w React dochodzą `defaultPageSize` i `onPageSizeChange`. Do tej pory
809
- komponent podawał paginatorowi `[pageSize()]` jako jedyną opcję, więc select „Wierszy" był martwą
1268
+ komponent podawał paginatorowi `[pageSize()]` jako jedyną opcję, więc select "Wierszy" był martwą
810
1269
  kontrolką: pokazywał liczbę, której nie dało się zmienić. Pager zostaje widoczny także wtedy, gdy
811
- wszystko mieści się na jednej stronie, o ile jest w czym wybierać — inaczej wybranie największego
1270
+ wszystko mieści się na jednej stronie, o ile jest w czym wybierać - inaczej wybranie największego
812
1271
  rozmiaru chowałoby select, którego użytkownik właśnie użył.
813
1272
 
814
1273
  Pasek paginatora w `KptDataView` znów stoi w jednym rzędzie po prawej. Opakowanie ustawiało
815
1274
  `.kpt-data-view .kpt-paginator { display: block }`, a selektor potomka bije `.kpt-paginator
816
- { display: flex }` z tej samej warstwy — trzy bloki paginatora rozpadały się na trzy linie.
1275
+ { display: flex }` z tej samej warstwy - trzy bloki paginatora rozpadały się na trzy linie.
817
1276
 
818
1277
  `KptDataView` pozwala ustawić gęstość siatki: `gridColumns` (dwukierunkowe), `gridColumnsOptions`
819
1278
  i `gridMinWidth`. Przy więcej niż jednej opcji w układzie siatki pasek narzędzi dostaje drugą grupę
820
- segmentową z ikoną `grid-dots`. Wybrana liczba jest sufitem, nie sztywną liczbą — minimum ścieżki
1279
+ segmentową z ikoną `grid-dots`. Wybrana liczba jest sufitem, nie sztywną liczbą - minimum ścieżki
821
1280
  rośnie do szerokości jednej z N kolumn, więc wąski kontener schodzi niżej, zamiast ściskać karty
822
1281
  poniżej `gridMinWidth`. Do tej pory o gęstości decydował wyłącznie arkusz aplikacji, bo komponent
823
1282
  miał `minmax(10rem, 1fr)` wpisane na sztywno.
824
1283
 
825
- Przyciski przełącznika układu niosą wreszcie `aria-pressed` — czytnik ekranu nie ogłaszał, który
1284
+ Przyciski przełącznika układu niosą wreszcie `aria-pressed` - czytnik ekranu nie ogłaszał, który
826
1285
  układ jest włączony.
827
1286
 
828
1287
  Przycisk siatki w przełączniku układu rysuje `layout-grid` zamiast `menu`: hamburger to
@@ -831,7 +1290,7 @@
831
1290
 
832
1291
  - 0daa856: Nowa karta podglądu `KptPeek` (`kpt-peek` + `kptPeekTrigger`) i na niej wzmianki w tekście:
833
1292
  `KptMention` (pojedyncza wzmianka) oraz `KptMentions` (akapit rozbity na treść i wzmianki).
834
- Obie rzeczy w rdzeniu biblioteki, nie w subpathu — karta jest mała i przyda się wszędzie tam,
1293
+ Obie rzeczy w rdzeniu biblioteki, nie w subpathu - karta jest mała i przyda się wszędzie tam,
835
1294
  gdzie tooltip za mało niesie, a popover za dużo zasłania.
836
1295
 
837
1296
  `kptTooltip` ma `pointer-events: none`, więc linku w jego środku nie da się kliknąć, a `kpt-popover`
@@ -843,34 +1302,34 @@
843
1302
  w ogóle, więc interaktywna karta zostaje osiągalna na dotyku i z klawiatury. Escape zamyka i oddaje
844
1303
  fokus triggerowi.
845
1304
 
846
- Nowa paczka `@konce-pt/mention` — rdzeń pure-TS z testami `node --test`. `parseMentionText()`
1305
+ Nowa paczka `@konce-pt/mention` - rdzeń pure-TS z testami `node --test`. `parseMentionText()`
847
1306
  rozbija akapit na treść i wzmianki (`@id` albo `@[Nazwa ze spacją](id)`), `mentionQuery()` mówi,
848
- czy kursor stoi w zapytaniu `@…`, a `filterMentions()` dopasowuje podpowiedzi. Sklejenie segmentów
849
- wraca do oryginału znak w znak — podgląd rozjeżdżający się z zapisaną treścią byłby gorszy niż brak
1307
+ czy kursor stoi w zapytaniu `@...`, a `filterMentions()` dopasowuje podpowiedzi. Sklejenie segmentów
1308
+ wraca do oryginału znak w znak - podgląd rozjeżdżający się z zapisaną treścią byłby gorszy niż brak
850
1309
  podglądu. `mail@example.com` wzmianką nie jest: `@` musi stać na początku tekstu albo po znaku,
851
1310
  który nie jest literą, cyfrą ani podkreśleniem. Dopasowanie zdejmuje diakrytyki, a litery z kreską
852
- mapuje ręcznie — `ł` to osobny znak Unicode, nie `l` ze znakiem diakrytycznym, więc samo NFD
853
- zostawiłoby „Łukasza" poza zasięgiem zapytania „lukasz".
1311
+ mapuje ręcznie - `ł` to osobny znak Unicode, nie `l` ze znakiem diakrytycznym, więc samo NFD
1312
+ zostawiłoby "Łukasza" poza zasięgiem zapytania "lukasz".
854
1313
 
855
1314
  W treści zapisuje się **identyfikator**, nie nazwa: `id` przeżyje zmianę nazwiska, a etykieta
856
- bierze się z listy pozycji. Identyfikator spoza listy też się renderuje — etykietą zostaje wtedy on
1315
+ bierze się z listy pozycji. Identyfikator spoza listy też się renderuje - etykietą zostaje wtedy on
857
1316
  sam, bo notatka ma dać się przeczytać także wtedy, gdy ktoś odszedł z zespołu. `kpt-mentions` nie
858
1317
  renderuje HTML-a: akapit wchodzi jako zwykły napis, a wzmianka jest elementem, który biblioteka sama
859
- zbudowała — aplikacja nie musi przepuszczać przez sanitizer treści pisanej przez użytkowników tylko
1318
+ zbudowała - aplikacja nie musi przepuszczać przez sanitizer treści pisanej przez użytkowników tylko
860
1319
  po to, żeby wyszły z niej wzmianki. Bez szablonu karty wzmianka jest wyróżnionym słowem, a nie
861
1320
  przyciskiem: nie ma czego otworzyć, więc niczego nie udaje.
862
1321
 
863
1322
  `kpt-rich-text` dostaje `mentions`, `mentionLimit` i `(mentioned)`: napisanie `@` otwiera listę
864
1323
  podpowiedzi zaczepioną w miejscu kursora, strzałki po niej chodzą, Enter albo Tab wstawia, Escape
865
- zamyka. Zapytanie czytamy z węzła tekstowego przy kursorze, nie z HTML-a — w treści siedzą tagi,
1324
+ zamyka. Zapytanie czytamy z węzła tekstowego przy kursorze, nie z HTML-a - w treści siedzą tagi,
866
1325
  a `@` ma widzieć tylko to, co naprawdę napisano w tym miejscu. Wstawiona wzmianka to
867
1326
  `<span class="kpt-mention" data-mention="id" contenteditable="false">` plus twarda spacja:
868
1327
  identyfikator przeżywa obieg przez wartość, `contenteditable="false"` trzyma wzmiankę w jednym
869
1328
  kawałku (bez tego kursor wchodzi w środek nazwiska), a spacja daje mu gdzie stanąć za blokiem,
870
- w który nie da się wejść. Oba atrybuty weszły na allowlistę sanitizera w obu portach — są bierne,
1329
+ w który nie da się wejść. Oba atrybuty weszły na allowlistę sanitizera w obu portach - są bierne,
871
1330
  nie wykonują niczego i nie wskazują zasobów.
872
1331
 
873
- `KptIconButton` w porcie Angulara dostaje `ariaExpanded` — jak `ariaPressed` musi zjechać na
1332
+ `KptIconButton` w porcie Angulara dostaje `ariaExpanded` - jak `ariaPressed` musi zjechać na
874
1333
  wewnętrzny `<button>`, bo host nie ma roli przycisku. Słownik `@konce-pt/i18n` dostaje
875
1334
  `richText.mentions` (EN i PL) na etykietę listy podpowiedzi.
876
1335
 
@@ -879,7 +1338,7 @@
879
1338
  `KptPeek` lądują na samym elemencie podanym w `trigger` (klon z doklejonymi handlerami), więc
880
1339
  `aria-expanded` siedzi tam, gdzie czytnik ekranu naprawdę je przeczyta.
881
1340
 
882
- - `KptPickList` i `KptOrderList` dostają przeciąganie i dwuklik — w obu portach.
1341
+ - `KptPickList` i `KptOrderList` dostają przeciąganie i dwuklik - w obu portach.
883
1342
 
884
1343
  Nowe wejście `dragdrop` jest domyślnie wyłączone, tak samo jak `reorderable` w tabeli danych:
885
1344
  przeciąganie to zachowanie, na które trzeba się zgodzić, a nie takie, które ma się włączyć samo
@@ -887,7 +1346,7 @@
887
1346
  przenosi je także między panelami, na wskazane miejsce. Upuszczenie na pusty obszar listy dopina
888
1347
  element na koniec.
889
1348
 
890
- Upuszczony element ląduje **na pozycji tego, na który go upuszczono** — nie zamienia się z nim
1349
+ Upuszczony element ląduje **na pozycji tego, na który go upuszczono** - nie zamienia się z nim
891
1350
  miejscami. To ten sam wzór co przestawianie kolumn w tabeli; zamiana miejscami wygląda przy
892
1351
  dłuższej liście na przypadek, bo element skacze w dwa miejsca naraz.
893
1352
 
@@ -895,7 +1354,7 @@
895
1354
  od zaznaczenia. Nie wymaga `dragdrop`, bo dwa kliknięcia pod spodem i tak się znoszą.
896
1355
 
897
1356
  Pod spodem natywny HTML5 drag and drop, nie CDK. Port React ma mieć to samo zachowanie i ten sam
898
- arkusz stylów, a dla CDK nie byłoby tam odpowiednika — jedna implementacja zamiast dwóch
1357
+ arkusz stylów, a dla CDK nie byłoby tam odpowiednika - jedna implementacja zamiast dwóch
899
1358
  rozjeżdżających się. Przyciski zostają pełną ścieżką z klawiatury, bo przeciąganie nie ma
900
1359
  klawiaturowego odpowiednika i bez nich sortowanie stałoby się niedostępne.
901
1360
 
@@ -903,19 +1362,19 @@
903
1362
 
904
1363
  - f615e93: `KptBackdrop` idzie za tokenami, a nie za samym atrybutem motywu.
905
1364
 
906
- Canvas nie rozwija `var()`, więc kolor wiodący jest odczytywany raz i zapiekany w rendererze —
1365
+ Canvas nie rozwija `var()`, więc kolor wiodący jest odczytywany raz i zapiekany w rendererze -
907
1366
  zmianę tokenów trzeba zauważyć i odczytać je na nowo. Dotąd nasłuch obejmował `data-theme`
908
1367
  i `class` na `<html>`, co wystarczało na przełącznik jasny/ciemny i zostawiało trzy dziury:
909
- nadpisanie tokenu inline (konfigurator marki ustawia `--kpt-color-primary` na `<html>` — reszta
1368
+ nadpisanie tokenu inline (konfigurator marki ustawia `--kpt-color-primary` na `<html>` - reszta
910
1369
  strony się przemalowywała, tło zostawało na starej barwie), motyw zakresowy (`[data-theme="dark"]`
911
1370
  nie jest przywiązany do `:root`, więc niesie go dowolny przodek) oraz aplikację trzymającą ciemne
912
1371
  tokeny w media query zamiast w atrybucie.
913
1372
 
914
1373
  Nasłuch idzie teraz po łańcuchu od hosta aż do `<html>` i patrzy u każdego przodka na `data-theme`,
915
1374
  `class` i `style`, a obok tego na zapytanie `prefers-color-scheme`. Szersza sieć łapie też zmiany
916
- niemające nic wspólnego z barwą — klasa nakładki na `<html>` przy otwarciu dialogu, dowolny zapis
917
- inline — więc renderer przebudowuje się dopiero wtedy, gdy odczyt naprawdę dał inny kolor. Sam
918
- strażnik jest tańszy niż dawna bezwarunkowa przebudowa: jeden `getComputedStyle`, bez sondy 1×1
1375
+ niemające nic wspólnego z barwą - klasa nakładki na `<html>` przy otwarciu dialogu, dowolny zapis
1376
+ inline - więc renderer przebudowuje się dopiero wtedy, gdy odczyt naprawdę dał inny kolor. Sam
1377
+ strażnik jest tańszy niż dawna bezwarunkowa przebudowa: jeden `getComputedStyle`, bez sondy 1x1
919
1378
  i bez arytmetyki OKLab.
920
1379
 
921
1380
  W rdzeniu doszły `readBackdropLead()` (sam kolor wiodący, wydzielony z `resolveBackdropColors()`)
@@ -949,10 +1408,10 @@
949
1408
 
950
1409
  - 8f9e7e2: Placeholder pola e-mail w słownikach EN/PL wskazuje `example.com` zamiast `company.com`
951
1410
  i `firma.pl`. Obie dotychczasowe domeny są realnie zarejestrowane, a RFC 2606 rezerwuje
952
- `example.com` właśnie na przykłady — przy okazji `@konce-pt/i18n` znika z alertu
953
- „URL strings" skanerów łańcucha dostaw.
1411
+ `example.com` właśnie na przykłady - przy okazji `@konce-pt/i18n` znika z alertu
1412
+ "URL strings" skanerów łańcucha dostaw.
954
1413
 
955
- Do dokumentacji dochodzi sekcja „Skanery bezpieczeństwa" (korzeniowy arkusz projektu oraz
1414
+ Do dokumentacji dochodzi sekcja "Skanery bezpieczeństwa" (korzeniowy arkusz projektu oraz
956
1415
  arkusze `@konce-pt/react` i `@konce-pt/map`, wzmianka w README obu paczek publikowanych).
957
1416
  Tłumaczy trzy alerty Socket.dev, z których każdy jest dopasowaniem stringów, nie znaleziskiem
958
1417
  w kodzie: klucze i18n czytane jak domeny (`.email`, `.today`, `.save` i reszta to prawdziwe
@@ -974,20 +1433,20 @@
974
1433
  ### Minor Changes
975
1434
 
976
1435
  - Zestaw wbudowany rośnie z 58 do 84 ikon o staple powłoki aplikacji (`sun`, `moon`, `bell`,
977
- `settings`, `users`, `logout`, `layout-dashboard`…). Wcześniej brakowało ich na tyle, że
978
- pierwszym odruchem był pełny Tabler i 1,2 MB w bundlu — typowy panel administracyjny nie
1436
+ `settings`, `users`, `logout`, `layout-dashboard`...). Wcześniej brakowało ich na tyle, że
1437
+ pierwszym odruchem był pełny Tabler i 1,2 MB w bundlu - typowy panel administracyjny nie
979
1438
  potrzebuje już niczego poza zestawem startowym.
980
1439
 
981
1440
  Sam Tabler przestaje być jednym literałem: każda z 5130 ikon to osobny eksport niosący własną
982
1441
  nazwę rejestru (PascalCase, bo camelCase zderza się z `function`/`package`/`switch`, a odwrotna
983
1442
  konwersja jest niejednoznaczna dla `BrandHtml5`). Podzbiór rejestruje `provideKptIcons([...])`
984
- w Angularze i `registerKptIcons([...])` w Reakcie — obie z rdzenia, bo subpath ikon importuje
1443
+ w Angularze i `registerKptIcons([...])` w Reakcie - obie z rdzenia, bo subpath ikon importuje
985
1444
  komplet statycznie i parametr nic by tam nie odchudził. Adnotacje `@__PURE__` na eksportach
986
1445
  zbiorczych są konieczne, nie kosmetyczne: bez nich bundler trzyma tablicę `ALL`, a przez nią
987
1446
  wszystkie stałe. Zmierzone esbuildem: import dwóch ikon to 658 B zamiast 1 290 823 B.
988
1447
 
989
1448
  - Trigger menu nie miał `aria-haspopup` ani `aria-expanded` w żadnym z portów. Atrybuty trafiają
990
- na kontrolkę wewnątrz slotu, nie na opakowanie `.kpt-menu__trigger` — nadanie roli opakowaniu
1449
+ na kontrolkę wewnątrz slotu, nie na opakowanie `.kpt-menu__trigger` - nadanie roli opakowaniu
991
1450
  zrobiłoby zagnieżdżoną kontrolkę i drugi tab stop.
992
1451
 
993
1452
  `open` w Angularze przestaje być `protected` i staje się `model<boolean>()`, co domyka parytet
@@ -996,7 +1455,7 @@
996
1455
  ### Patch Changes
997
1456
 
998
1457
  - Dyrektywa przełącznika nawigacji nakładała `aria-expanded`/`aria-controls` wyłącznie na natywny
999
- `<button>`, żeby nie naruszyć `aria-allowed-attr`. Na `kpt-icon-button` — czyli w typowym użyciu —
1458
+ `<button>`, żeby nie naruszyć `aria-allowed-attr`. Na `kpt-icon-button` - czyli w typowym użyciu -
1000
1459
  nie zostawało nic i czytnik ekranu nie wiedział, czy panel jest otwarty. Gdy host nie jest natywną
1001
1460
  kontrolką, atrybuty schodzą na jego wewnętrzny `<button>`; etykieta zostaje przy komponencie.
1002
1461
  - Panel promocyjny ekranu logowania ustawiał tylko `color`, więc komponenty wstawione
@@ -1005,32 +1464,32 @@
1005
1464
  więc slot wygląda poprawnie w obu motywach. Arkusz jest wspólny, więc poprawka dotyczy też portu
1006
1465
  React.
1007
1466
  - Detekcja breakpointów sprawdza obecność `matchMedia`, nie samo środowisko. jsdom melduje się jako
1008
- przeglądarka i dostarcza `window`, ale `matchMedia` nie implementuje — każdy test aplikacji
1467
+ przeglądarka i dostarcza `window`, ale `matchMedia` nie implementuje - każdy test aplikacji
1009
1468
  dotykający `KptAppShell` wywalał się na TypeError i wymagał stubu po stronie konsumenta.
1010
1469
  W porcie React zastępczy magazyn nie trafia już do cache, więc stub podstawiony później zostaje
1011
1470
  podchwycony.
1012
- - Uzupełnienia dokumentacji. `kptCardFooter` musi być bezpośrednim dzieckiem `kpt-card` — projekcja
1471
+ - Uzupełnienia dokumentacji. `kptCardFooter` musi być bezpośrednim dzieckiem `kpt-card` - projekcja
1013
1472
  treści nie sięga głębiej, więc stopka zamknięta w `<form>` cicho lądowała w body i nic o tym nie
1014
1473
  ostrzegało. W wykresach `font-size: 11px` wewnątrz SVG to 11 jednostek viewBoxa, nie pikseli, więc
1015
1474
  `width`/`height` są skalą tekstu, a nie samymi proporcjami.
1016
1475
 
1017
1476
  README `@konce-pt/react` dostaje pełną wersję angielską z odznakami npm (wersja, pobrania, rozmiar
1018
- minzip, typy, licencja) i polskie lustro poniżej — tak jak README portu Angulara. `homepage` paczki
1477
+ minzip, typy, licencja) i polskie lustro poniżej - tak jak README portu Angulara. `homepage` paczki
1019
1478
  wskazuje playground Reacta pod `ui.konce.pt/react`.
1020
1479
 
1021
- - Angular renderował `E-mail *`, React `E-mail*` — różnicę robił węzeł tekstowy z szablonu, który
1480
+ - Angular renderował `E-mail *`, React `E-mail*` - różnicę robił węzeł tekstowy z szablonu, który
1022
1481
  JSX usuwa. Odstęp przed gwiazdką pola wymaganego daje teraz wyłącznie `margin-inline-start`, więc
1023
1482
  oba porty wyglądają identycznie.
1024
1483
  - `pageSize` spoza `pageSizeOptions` nie miał odpowiadającej opcji w selekcie: kontrolka pokazywała
1025
1484
  pierwszą pozycję, a tabela stronicowała po innej liczbie. Bieżąca wartość dokłada się teraz do
1026
1485
  listy opcji. React przy okazji przestaje ostrzegać w konsoli o `value` bez dopasowania.
1027
1486
  - `readonly KptTimelineItem[]` i podobne stałe aplikacji nie przechodziły przez inputy (TS4104), bo
1028
- te deklarowały tablice mutowalne — mimo że komponenty ich nie mutują. Rozszerzone są wyłącznie
1487
+ te deklarowały tablice mutowalne - mimo że komponenty ich nie mutują. Rozszerzone są wyłącznie
1029
1488
  `input<T[]>`; `model<T[]>` zostaje nietknięte, bo `ModelSignal` jest inwariantny i `readonly`
1030
1489
  zerwałoby two-way binding u konsumentów. Przy okazji zagnieżdżone `KptMenuItem.items`,
1031
1490
  `KptTreeNode.children` i `KptColumnEdit.options`.
1032
1491
  - 18 reguł wspólnego arkusza celowało w custom elementy Angulara (`kpt-icon`, `kpt-paginator`,
1033
- `kpt-select`, `kpt-date-range`), których port React nie renderuje — znikały tam po cichu, m.in.
1492
+ `kpt-select`, `kpt-date-range`), których port React nie renderuje - znikały tam po cichu, m.in.
1034
1493
  wyrównanie paginatora i kolor ikon w menu. Hosty Angulara i tak noszą odpowiednie klasy, więc
1035
1494
  selektor klasowy działa w obu portach. Generator arkusza dostaje bramkę: goły selektor elementowy
1036
1495
  `kpt-*` wywala build.
@@ -1055,7 +1514,7 @@
1055
1514
  do tarballa. Arkusze `llms.txt` i `llms-pl.txt` każdej paczki są teraz publikowane
1056
1515
  pod `https://ui.konce.pt/llms/<paczka>/`, a README linkują do tych adresów.
1057
1516
 
1058
- Każda publikowana paczka ma też własny plik `LICENSE` — dotąd treść licencji
1517
+ Każda publikowana paczka ma też własny plik `LICENSE` - dotąd treść licencji
1059
1518
  niosły tylko tarbally angular/grid/styles/tokens, mimo `"license": "MIT"`
1060
1519
  w każdym `package.json`.
1061
1520
 
@@ -1077,39 +1536,39 @@
1077
1536
  a to są miejsca, w których błąd jest cichy: wykres kłamiący o danych, filtr chowający
1078
1537
  wiersz, kalendarz gubiący zmianę czasu.
1079
1538
 
1080
- - `@konce-pt/datetime` — siatki dni, miesięcy, lat i dekad, przewijanie z `minDate`/`maxDate`,
1539
+ - `@konce-pt/datetime` - siatki dni, miesięcy, lat i dekad, przewijanie z `minDate`/`maxDate`,
1081
1540
  protokół klikania zakresu, znaczniki tarczy zegara.
1082
- - `@konce-pt/table` — dopasowanie filtrów kolumn, agregacje podsumowania, escapowanie CSV.
1083
- - `@konce-pt/chart` — skale i „ładne" podziałki, ścieżki linii i obszaru, układ słupków,
1541
+ - `@konce-pt/table` - dopasowanie filtrów kolumn, agregacje podsumowania, escapowanie CSV.
1542
+ - `@konce-pt/chart` - skale i "ładne" podziałki, ścieżki linii i obszaru, układ słupków,
1084
1543
  łuki kołowych i polarnych, siatka radaru.
1085
- - `@konce-pt/roadmap` — arytmetyka kalendarzowa ISO, model osi czasu, pakowanie pasów,
1544
+ - `@konce-pt/roadmap` - arytmetyka kalendarzowa ISO, model osi czasu, pakowanie pasów,
1086
1545
  geometria zależności.
1087
- - `@konce-pt/icons` — dane ikon, sanitizer i `renderKptIconSvg`; pełny Tabler w subpathu
1546
+ - `@konce-pt/icons` - dane ikon, sanitizer i `renderKptIconSvg`; pełny Tabler w subpathu
1088
1547
  `/tabler`.
1089
1548
 
1090
- Każda ma własne testy na `node --test`. Publiczne API `@konce-pt/angular` bez zmian —
1549
+ Każda ma własne testy na `node --test`. Publiczne API `@konce-pt/angular` bez zmian -
1091
1550
  komponenty re-eksportują typy rdzeni, a `KptIconRegistry` i `provideKptTablerIcons()`
1092
1551
  działają jak dotąd.
1093
1552
 
1094
1553
  - 3a3b859: Mapa jako subpath `map/` w obu portach, na wspólnym rdzeniu `@konce-pt/map`: odwzorowanie
1095
1554
  Web Mercator, arytmetyka prostokątów, klastrowanie znaczników, godziny otwarcia, HTML
1096
- znaczników i klastrów. Obok rdzenia stoją adaptery silników (Leaflet, Google) — jedyne
1555
+ znaczników i klastrów. Obok rdzenia stoją adaptery silników (Leaflet, Google) - jedyne
1097
1556
  miejsce w repo, które zna typy biblioteki mapowej.
1098
1557
 
1099
1558
  `leaflet` jest peerem **opcjonalnym**, ładowanym dynamicznym `import()`, więc kto nie używa
1100
- mapy, nie płaci za nią rozmiarem ani instalacją. Aplikacja dostarcza `leaflet.css` sama —
1559
+ mapy, nie płaci za nią rozmiarem ani instalacją. Aplikacja dostarcza `leaflet.css` sama -
1101
1560
  i dlatego nadpisania `.leaflet-*` w SCSS mapy celowo stoją poza `@layer kpt.components`.
1102
1561
 
1103
1562
  ### Patch Changes
1104
1563
 
1105
- - 3a3b859: `KptIconButton` przyjmuje `ariaPressed` — stan przycisku-przełącznika trafia wreszcie na
1564
+ - 3a3b859: `KptIconButton` przyjmuje `ariaPressed` - stan przycisku-przełącznika trafia wreszcie na
1106
1565
  wewnętrzny `<button>`. Postawione na znaczniku `[attr.aria-pressed]` lądowało na hoście
1107
1566
  `<kpt-icon-button>`, który nie ma roli przycisku, więc czytnik ekranu nie miał czego
1108
1567
  ogłosić. Domyślne `null` nie wypisuje atrybutu w ogóle.
1109
1568
 
1110
- Karta miejsca (`KptMapPoiCard`) korzysta z nowego wejścia, a stan „w ulubionych" naprawdę
1569
+ Karta miejsca (`KptMapPoiCard`) korzysta z nowego wejścia, a stan "w ulubionych" naprawdę
1111
1570
  podświetla gwiazdkę: reguła `[data-on]` celowała dotąd w hosta, gdzie `color` przegrywał
1112
- z kolorem przycisku, a `border-color` się nie dziedziczy — podświetlenie nie działało
1571
+ z kolorem przycisku, a `border-color` się nie dziedziczy - podświetlenie nie działało
1113
1572
  w żadnym z portów.
1114
1573
 
1115
1574
  - Updated dependencies [3a3b859]
@@ -1129,14 +1588,14 @@
1129
1588
 
1130
1589
  - Dokumentacja `llms.txt` jest teraz po angielsku i to ona jest wersją kanoniczną. 81 plików
1131
1590
  z `packages/angular/**` trafia do tarballa npm, czyli do `node_modules` u konsumentów
1132
- biblioteki, gdzie czyta je ich asystent — polskie API sheety były ostatnią niekonsekwencją
1591
+ biblioteki, gdzie czyta je ich asystent - polskie API sheety były ostatnią niekonsekwencją
1133
1592
  w paczce, której README i opisy w `package.json` są angielskie od początku.
1134
1593
 
1135
1594
  Dotychczasowa polska treść żyje w repozytorium obok, jako `llms-pl.txt`, i do paczki nie
1136
1595
  trafia. Wersja angielska przejmuje istniejącą nazwę pliku, więc dla konsumenta nic się nie
1137
1596
  przesuwa: `node_modules/@konce-pt/angular/**/llms.txt` leży dokładnie tam, gdzie leżał.
1138
1597
 
1139
- Identyfikatory, tokeny i klucze i18n przechodzą bez zmian — przetłumaczone są proza,
1598
+ Identyfikatory, tokeny i klucze i18n przechodzą bez zmian - przetłumaczone są proza,
1140
1599
  komentarze i napisy widoczne dla użytkownika w przykładach. Polszczyzna zostaje tam, gdzie
1141
1600
  jest tematem: walidatory NIP/REGON/PESEL, `displayFormat: 'pl'` i przykłady słownika PL.
1142
1601
 
@@ -1144,34 +1603,34 @@
1144
1603
 
1145
1604
  ### Minor Changes
1146
1605
 
1147
- - 1fd009a: Nowy komponent `kpt-auth` — ekran logowania, rejestracji i odzyskiwania hasła w jednym miejscu.
1606
+ - 1fd009a: Nowy komponent `kpt-auth` - ekran logowania, rejestracji i odzyskiwania hasła w jednym miejscu.
1148
1607
  Dwa układy (przesuwany panel promocyjny i split-screen), trzy tryby, walidacja na Signal Forms
1149
1608
  i lista dostawców zewnętrznych: `providers` + `providerSelect`, układ listy albo siatki ikon,
1150
- a dla logo, których nie da się oddać ikoną z rejestru — szablon `ng-template[kptAuthProvider]`.
1609
+ a dla logo, których nie da się oddać ikoną z rejestru - szablon `ng-template[kptAuthProvider]`.
1151
1610
  Sloty `[kptAuthBrand]`, `[kptAuthPromo]`, `[kptAuthSso]`, `[kptAuthFields]`, `[kptAuthFooter]`.
1152
1611
 
1153
1612
  W drzewie żyje wyłącznie formularz aktywnego trybu (żadnych elementów niewidocznych, ale
1154
1613
  fokusowalnych), nagłówek panelu dostaje fokus po zmianie trybu, a animacje respektują
1155
1614
  `prefers-reduced-motion`.
1156
1615
 
1157
- Przy okazji: `kpt-input` dostaje wejście `autocomplete`, a `kpt-password` — `autocomplete` (dotąd
1616
+ Przy okazji: `kpt-input` dostaje wejście `autocomplete`, a `kpt-password` - `autocomplete` (dotąd
1158
1617
  zaszyte na `current-password`, błędne w rejestracji i resecie) oraz `id`, bez którego
1159
1618
  `kpt-form-field [controlId]` nie wiązał etykiety z polem.
1160
1619
 
1161
- - 2b63b59: kpt-rich-text: wcięcia list — Tab / Shift+Tab w punkcie listy zagnieżdża go i cofa o poziom
1620
+ - 2b63b59: kpt-rich-text: wcięcia list - Tab / Shift+Tab w punkcie listy zagnieżdża go i cofa o poziom
1162
1621
  (zamiast wyprowadzać fokus z edytora), a pasek dostaje narzędzia `indent` / `outdent`.
1163
1622
  Głębokość ogranicza nowe wejście `maxListLevel` (domyślnie 6). Tab / Shift+Tab w komórce tabeli
1164
1623
  przechodzi do sąsiedniej komórki. Poza listą i tabelą Tab pozostaje natywny, żeby edytor nie był
1165
1624
  pułapką klawiaturową. Nowe ikony `indent-increase` / `indent-decrease` w zestawie wbudowanym.
1166
1625
 
1167
- Znaczniki zagnieżdżonych list w edytorze cyklują co 3 poziomy (`ol`: 1. → a. → i., `ul`: • → ○ → ▪); ten sam cykl wystawia
1626
+ Znaczniki zagnieżdżonych list w edytorze cyklują co 3 poziomy (`ol`: 1. -> a. -> i., `ul`: - -> o -> -); ten sam cykl wystawia
1168
1627
  `@konce-pt/styles` jako `.kpt-rich-content` dla treści renderowanej poza edytorem.
1169
1628
 
1170
1629
  ## 0.7.10
1171
1630
 
1172
1631
  ### Minor Changes
1173
1632
 
1174
- - 8b827e1: **Breaking:** output `select` zmienia nazwę na `selected` w komponentach menu — `kpt-menu`,
1633
+ - 8b827e1: **Breaking:** output `select` zmienia nazwę na `selected` w komponentach menu - `kpt-menu`,
1175
1634
  `kpt-menubar`, `kpt-megamenu`, `kpt-context-menu`, `kpt-split-button` i `kpt-speed-dial`.
1176
1635
 
1177
1636
  `select` to standardowe zdarzenie DOM (zaznaczenie tekstu w `<input>`/`<textarea>`), więc
@@ -1196,8 +1655,8 @@
1196
1655
  zebrana w jedną funkcję pozycjonującą znacznik, a obsługa wskaźnika tarczy liczy sam kąt
1197
1656
  i oddaje ustawianie wartości osobnym metodom. Zachowanie i API bez zmian.
1198
1657
  - ea37d33: `kpt-data-table`: komórka z zwykłym obiektem nie jest już zamieniana na `'[object Object]'`
1199
- przy filtrowaniu, sortowaniu i w wierszu podsumowania — daje pusty tekst. Wcześniej filtr
1200
- tekstowy „obj" dopasowywał każdy wiersz z obiektem w takiej kolumnie, a sortowanie uznawało
1658
+ przy filtrowaniu, sortowaniu i w wierszu podsumowania - daje pusty tekst. Wcześniej filtr
1659
+ tekstowy "obj" dopasowywał każdy wiersz z obiektem w takiej kolumnie, a sortowanie uznawało
1201
1660
  je wszystkie za równe. Prymitywy, `Date` i tablice bez zmian.
1202
1661
 
1203
1662
  Do `@konce-pt/angular` dołączają brakujące eksporty typów `KptColumnFilter`
@@ -1209,19 +1668,19 @@
1209
1668
 
1210
1669
  - kpt-data-table: wiersz podsumowania nad paginatorem
1211
1670
 
1212
- Kolumna z nowym polem `summary` jest agregowana w `<tfoot>` — ostatnim wierszu tabeli, przyklejonym
1213
- do dołu obszaru przewijania. Etykieta (`summaryLabel`, bez wartości i18n `dataTable.total` →
1214
- „Total”/„Razem”) renderuje się w komórce scalonej od początku wiersza do pierwszej liczonej kolumny
1671
+ Kolumna z nowym polem `summary` jest agregowana w `<tfoot>` - ostatnim wierszu tabeli, przyklejonym
1672
+ do dołu obszaru przewijania. Etykieta (`summaryLabel`, bez wartości i18n `dataTable.total` ->
1673
+ "Total"/"Razem") renderuje się w komórce scalonej od początku wiersza do pierwszej liczonej kolumny
1215
1674
  i jest wyrównana do prawej; colspan obejmuje też kolumny systemowe (rozwijanie, zaznaczanie).
1216
1675
 
1217
1676
  Agregacje `sum`, `avg`, `min`, `max`, `count` albo własna funkcja `(rows) => unknown`; `format`
1218
- formatuje wynik (np. `Intl.NumberFormat`). Liczone są z całego zbioru po filtrach — ze wszystkich
1219
- stron, nie tylko z widocznej — więc wynik zgadza się z licznikiem paginatora. `data` jest zwykłym
1677
+ formatuje wynik (np. `Intl.NumberFormat`). Liczone są z całego zbioru po filtrach - ze wszystkich
1678
+ stron, nie tylko z widocznej - więc wynik zgadza się z licznikiem paginatora. `data` jest zwykłym
1220
1679
  inputem, więc podmiana tablicy w sygnale po `cellEdit` przelicza podsumowanie natychmiast: tabela
1221
1680
  liczy na żywo przy edycji inline.
1222
1681
 
1223
- W trybie `lazy` tabela ma tylko bieżącą stronę i nie liczy nic sama — wartości podaje konsument
1224
- przez `summaryValues` (pole → wartość), które poza `lazy` nadpisuje wyliczenia.
1682
+ W trybie `lazy` tabela ma tylko bieżącą stronę i nie liczy nic sama - wartości podaje konsument
1683
+ przez `summaryValues` (pole -> wartość), które poza `lazy` nadpisuje wyliczenia.
1225
1684
 
1226
1685
  Nowe typy `KptColumnSummary` i `KptSummaryFn` są eksportowane z `@konce-pt/angular`. Tło wiersza
1227
1686
  bierze `--kpt-table-summary-bg` (fallback: header-bg). Klucz i18n `dataTable.total` doszedł do EN i PL.
@@ -1232,25 +1691,25 @@
1232
1691
 
1233
1692
  - 40a5d04: kpt-date-range: kilka miesięcy obok siebie (`visibleMonths`) i ciągłe pasmo zakresu
1234
1693
 
1235
- Nowy input `visibleMonths` (domyślnie 1, przycinany do 1–3) pokazuje sąsiednie miesiące obok
1236
- siebie. Strzałki ‹ › stoją na skrajnych panelach i przesuwają całość o jeden miesiąc. Przy więcej
1237
- niż jednym panelu dni sąsiednich miesięcy są ukrywane do pustych slotów — inaczej ta sama data
1694
+ Nowy input `visibleMonths` (domyślnie 1, przycinany do 1-3) pokazuje sąsiednie miesiące obok
1695
+ siebie. Strzałki < > stoją na skrajnych panelach i przesuwają całość o jeden miesiąc. Przy więcej
1696
+ niż jednym panelu dni sąsiednich miesięcy są ukrywane do pustych slotów - inaczej ta sama data
1238
1697
  byłaby klikalna w dwóch panelach naraz, a pasmo zakresu malowałoby się w obu miejscach.
1239
1698
 
1240
1699
  Zakres podświetla teraz ciągłe pasmo biegnące przez wszystkie panele: dni skrajne mają plamę
1241
1700
  zaznaczenia, a pasmo wychodzi z ich środka i zaokrągla się na krańcach wiersza siatki. Wcześniej
1242
1701
  pasmo urywało się na dniach skrajnych, bo zasłaniało je pełne tło komórki.
1243
1702
 
1244
- - a843fd6: kpt-datepicker: nawigacja drill-down po panelu — dekady → lata → miesiące → dni
1703
+ - a843fd6: kpt-datepicker: nawigacja drill-down po panelu - dekady -> lata -> miesiące -> dni
1245
1704
 
1246
1705
  Panel kalendarza jest teraz stosem widoków: klik w komórkę schodzi poziom niżej, klik w tytuł
1247
1706
  nagłówka wchodzi poziom wyżej. Nowy input `startView` ('day' | 'month' | 'year' | 'decade' | null)
1248
- ustawia poziom startowy — `startView="decade"` daje wybór daty urodzenia w czterech kliknięciach.
1707
+ ustawia poziom startowy - `startView="decade"` daje wybór daty urodzenia w czterech kliknięciach.
1249
1708
  Domyślne `null` zachowuje dotychczasowe zachowanie każdego `selectionMode`.
1250
1709
 
1251
- Zmiana zachowania: strona siatki lat to pełna dekada (10 lat, „1970 – 1979”) zamiast dotychczasowego
1252
- bloku 12-letniego — dotyczy też istniejącego `selectionMode="year"`. Strona dekad obejmuje 12 dekad
1253
- („1920 – 2039”). Strzałki ‹ › są wyłączane, gdy cała sąsiednia strona wypada poza `minDate`/`maxDate`.
1710
+ Zmiana zachowania: strona siatki lat to pełna dekada (10 lat, "1970 - 1979") zamiast dotychczasowego
1711
+ bloku 12-letniego - dotyczy też istniejącego `selectionMode="year"`. Strona dekad obejmuje 12 dekad
1712
+ ("1920 - 2039"). Strzałki < > są wyłączane, gdy cała sąsiednia strona wypada poza `minDate`/`maxDate`.
1254
1713
 
1255
1714
  Typy `KptDatepickerMode` i `KptDatepickerView` są eksportowane z `@konce-pt/angular`.
1256
1715
 
@@ -1258,23 +1717,23 @@
1258
1717
 
1259
1718
  ### Minor Changes
1260
1719
 
1261
- - 47ada55: `kpt-data-table` — edycja inline komórek, a przy okazji publiczny stan panelu w `kpt-select`
1720
+ - 47ada55: `kpt-data-table` - edycja inline komórek, a przy okazji publiczny stan panelu w `kpt-select`
1262
1721
  i `kpt-datepicker`.
1263
1722
 
1264
1723
  - `KptColumn.edit` (`{ type, options?, placeholder?, min?, max?, step? }`) włącza edycję kolumny.
1265
- Klik w komórkę (albo Enter — komórka edytowalna ma `tabindex="0"`) zamienia wartość na kontrolkę:
1266
- `text` → `kpt-input`, `number` → `kpt-input-number`, `date` → `kpt-datepicker`, `select`
1267
- i `multiselect` → `kpt-select` (drugi z `multiple filter`). Dla edytorów na overlayu panel otwiera
1724
+ Klik w komórkę (albo Enter - komórka edytowalna ma `tabindex="0"`) zamienia wartość na kontrolkę:
1725
+ `text` -> `kpt-input`, `number` -> `kpt-input-number`, `date` -> `kpt-datepicker`, `select`
1726
+ i `multiselect` -> `kpt-select` (drugi z `multiple filter`). Dla edytorów na overlayu panel otwiera
1268
1727
  się od razu, więc wybór to jedno kliknięcie.
1269
1728
  - `cellEdit` (`output<KptCellEditEvent<T>>`) emituje `{ row, field, value, updatedRow }` po
1270
1729
  zatwierdzeniu i tylko wtedy, gdy wartość faktycznie się zmieniła (tablice porównywane po
1271
1730
  zawartości, więc powrót do tego samego zestawu nic nie wysyła). `updatedRow` to gotowe body
1272
- żądania — tabela sama nic nie zapisuje, jak przy `lazyLoad`.
1273
- - `kptCellEdit` — dyrektywa szablonu własnego edytora, gdy wbudowane typy nie wystarczają.
1731
+ żądania - tabela sama nic nie zapisuje, jak przy `lazyLoad`.
1732
+ - `kptCellEdit` - dyrektywa szablonu własnego edytora, gdy wbudowane typy nie wystarczają.
1274
1733
  Kontekst: `$implicit` = wartość, `row`, `commit(value)`, `cancel()`.
1275
- - `open` w `kpt-select` i `kpt-datepicker` jest teraz publicznym `model(false)` — dwukierunkowe
1734
+ - `open` w `kpt-select` i `kpt-datepicker` jest teraz publicznym `model(false)` - dwukierunkowe
1276
1735
  `[(open)]` i `(openChange)`, spójnie z `kpt-dialog`/`kpt-drawer`. Bez tego nie da się z zewnątrz
1277
- odróżnić „user skończył wybierać" od „pole straciło fokus": `touch` leci również z blur triggera,
1736
+ odróżnić "user skończył wybierać" od "pole straciło fokus": `touch` leci również z blur triggera,
1278
1737
  czyli już przy naciśnięciu myszy na opcji w panelu (panel żyje w kontenerze CDK Overlay przy
1279
1738
  `<body>`). Inicjalizacja panelu przy otwarciu przeniosła się z `toggleOpen()` do efektu na `open`,
1280
1739
  żeby otwarcie z zewnątrz ustawiało widok kalendarza i resetowało filtr tak samo jak klik w trigger.
@@ -1282,16 +1741,16 @@
1282
1741
  `exportCsv()` i eksport nie zmieniają zachowania. Kolumny bez `edit` (i tabele bez `cellEdit`)
1283
1742
  działają dokładnie jak dotąd.
1284
1743
 
1285
- - `kpt-data-table` — ukrywanie kolumn przez `hiddenFields` i slot `kptPaginatorActions`.
1744
+ - `kpt-data-table` - ukrywanie kolumn przez `hiddenFields` i slot `kptPaginatorActions`.
1286
1745
 
1287
1746
  - `hiddenFields` (`model<readonly string[]>`, dwukierunkowe) trzyma pola ukrytych kolumn.
1288
- Komponent celowo nie dostarcza UI do zarządzania widocznością — to minimalny hak do podpięcia
1747
+ Komponent celowo nie dostarcza UI do zarządzania widocznością - to minimalny hak do podpięcia
1289
1748
  własnego przełącznika. Renderowanie (nagłówek, wiersz filtrów, wiersze, `colspan`, sticky-offsety
1290
1749
  kolumn zamrożonych) i `exportCsv()` respektują ukryte kolumny; ukrycie nie wyłącza kolumny
1291
1750
  z globalnego wyszukiwania ani z filtrów per-kolumna, a kolejność zapamiętana przez `reorderable`
1292
1751
  przeżywa ukrycie i pokazanie z powrotem.
1293
1752
  - Wiersz paginatora dostał slot projekcji `[kptPaginatorActions]` po lewej stronie `kpt-paginator`
1294
- (który ma teraz `flex: 1 1 auto`, więc bez projekcji wygląda dokładnie jak dotąd) — miejsce na
1753
+ (który ma teraz `flex: 1 1 auto`, więc bez projekcji wygląda dokładnie jak dotąd) - miejsce na
1295
1754
  kompaktowy przycisk obok paginatora.
1296
1755
  - Ikona `adjustments-horizontal` doszła do wbudowanego rejestru, więc przycisk dostosowywania
1297
1756
  kolumn nie wymaga `provideKptTablerIcons()`.
@@ -1301,7 +1760,7 @@
1301
1760
  po `field`.
1302
1761
 
1303
1762
  Gotowe UI dostosowywania kolumn (przycisk, dialog z checkboxami, zapis w `localStorage`) żyje jako
1304
- przykład w playgroundzie — nie wchodzi do biblioteki.
1763
+ przykład w playgroundzie - nie wchodzi do biblioteki.
1305
1764
 
1306
1765
  ### Patch Changes
1307
1766
 
@@ -1313,15 +1772,15 @@
1313
1772
  a dyrektywa sama wstrzykuje go w wejścia. Jawne `[min]`/`[max]` należą do wariantu z `[(value)]`.
1314
1773
  Sama implementacja bez zmian.
1315
1774
 
1316
- - Domknięcie dwóch bliźniaczych luk, których pierwszy audyt nie objął — znalezionych przy
1775
+ - Domknięcie dwóch bliźniaczych luk, których pierwszy audyt nie objął - znalezionych przy
1317
1776
  ponownej weryfikacji już naprawionych funkcji.
1318
1777
 
1319
1778
  - `renderMarkerHtml()` w mapie escapuje teraz również `shape`. Poprzednia poprawka objęła
1320
- `color` i `contrast`, ale `shape` — trzecie pole trafiające do sklejanego HTML — wciąż szło
1779
+ `color` i `contrast`, ale `shape` - trzecie pole trafiające do sklejanego HTML - wciąż szło
1321
1780
  surowo do atrybutu `class`, więc wartość z CMS-a czy API bez walidacji runtime mogła wyrwać się
1322
1781
  z atrybutu tym samym mechanizmem. Trzy legalne wartości (`pin`, `dot`, `square`) nie zawierają
1323
1782
  znaków specjalnych HTML, więc wygląd jest bez zmian.
1324
- - Tooltip wykresu wiązał kolor kropki przez `[style.background]` — shorthand akceptujący `url()` —
1783
+ - Tooltip wykresu wiązał kolor kropki przez `[style.background]` - shorthand akceptujący `url()` -
1325
1784
  zasilany niewalidowanym `KptChartSeries.color`. Zamiana na `background-color`, czyli ten sam fix,
1326
1785
  który wcześniej dostały `color-picker`, `meter-group`, `roadmap` i legenda mapy.
1327
1786
 
@@ -1330,11 +1789,11 @@
1330
1789
 
1331
1790
  - `kpt-rich-text` zapisywał `value` wprost do `innerHTML` bez sanitizera wszędzie poza ścieżką
1332
1791
  wklejania. Efekt synchronizujący sanityzuje teraz **każdy** zewnętrzny zapis wartości.
1333
- - `marker-html.ts` (mapa) wstawiał kolor kategorii surowo do atrybutu `style` — `colorVarOf`
1792
+ - `marker-html.ts` (mapa) wstawiał kolor kategorii surowo do atrybutu `style` - `colorVarOf`
1334
1793
  i `foregroundVarOf` mają whitelistę `var(--kpt-*)`, co zamyka naraz wyrwanie się z atrybutu
1335
1794
  i wstrzyknięcie CSS średnikiem.
1336
1795
  - `KptIconRegistry.register()` przyjmował dowolny SVG jako string. Teraz sanityzuje do allowlisty
1337
- geometrii (`path`, `circle`, `rect`, `g`, `line`, `polygon`, `polyline`, `ellipse`) — bez zmian
1796
+ geometrii (`path`, `circle`, `rect`, `g`, `line`, `polygon`, `polyline`, `ellipse`) - bez zmian
1338
1797
  dla zestawu wbudowanego i pełnego Tablera (5130 ikon), bo oba używają wyłącznie `<path>`.
1339
1798
  - Eksport CSV z `kpt-data-table` poprzedza apostrofem komórki zaczynające się od `=`, `+`, `-`, `@`
1340
1799
  (formula injection), a filtr `javascript:` w narzędziu linku, `normalizeUrl` w mapie i tła CSS
@@ -1344,22 +1803,22 @@
1344
1803
  żeby dało się je testować przez `node --test`.
1345
1804
 
1346
1805
  Dla danych zgodnych z kontraktem zachowanie jest bez zmian. Dwa świadome wyjątki: URL bez schematu
1347
- dostaje prefiks `https://`, a komórki CSV zaczynające się od znaku formuły — wiodący apostrof.
1806
+ dostaje prefiks `https://`, a komórki CSV zaczynające się od znaku formuły - wiodący apostrof.
1348
1807
 
1349
1808
  ## 0.7.6
1350
1809
 
1351
1810
  ### Minor Changes
1352
1811
 
1353
- - 1e20c5e: `kpt-badge` — nowe wejście `size` (`'sm' | 'md' | 'lg'`, domyślnie `'md'`).
1812
+ - 1e20c5e: `kpt-badge` - nowe wejście `size` (`'sm' | 'md' | 'lg'`, domyślnie `'md'`).
1354
1813
 
1355
1814
  Wysokość (`1rem` / `1.25rem` / `1.5rem`) steruje resztą geometrii: krój to `calc(--_size * 0.6)`,
1356
1815
  wcięcie boczne i średnica kropki skalują się razem z nią. `md` wychodzi identycznie jak dotąd
1357
1816
  (0.75rem kroju, kropka 0.65rem), więc istniejące użycia nie zmieniają wyglądu.
1358
1817
 
1359
- `sm` jest po to, żeby wstawić odznakę w wiersz tekstu — przy etykiecie, w pozycji menu, w komórce
1360
- tabeli — bez rozpychania wiersza.
1818
+ `sm` jest po to, żeby wstawić odznakę w wiersz tekstu - przy etykiecie, w pozycji menu, w komórce
1819
+ tabeli - bez rozpychania wiersza.
1361
1820
 
1362
- - 8dd8e41: `KptMenuItem` — wiersz nagłówkowy i odznaka na pozycji.
1821
+ - 8dd8e41: `KptMenuItem` - wiersz nagłówkowy i odznaka na pozycji.
1363
1822
 
1364
1823
  - `header: true` zamienia pozycję w nieklikalny blok tekstu: `avatar` (`{ src?, name?, icon? }`,
1365
1824
  renderowany przez `kpt-avatar`), `label` w półgrubym kroju i `description` drugą linią. Pokrywa
@@ -1367,43 +1826,43 @@
1367
1826
  funkcji menu. To `<div role="presentation">`, więc nie wchodzi do nawigacji klawiaturą i nie
1368
1827
  narusza kontraktu dzieci `role="menu"`.
1369
1828
  - `badge` (`string | number`) plus `badgeVariant` dokładają odznakę wyrównaną do prawej krawędzi
1370
- pozycji — licznik powiadomień, status. Renderuje ją `kpt-badge`, więc wartości powyżej `max`
1829
+ pozycji - licznik powiadomień, status. Renderuje ją `kpt-badge`, więc wartości powyżej `max`
1371
1830
  skracają się do `99+`, a wartość wchodzi w nazwę dostępną pozycji.
1372
- - `description` działa też na zwykłych pozycjach — dwuwierszowa pozycja menu.
1831
+ - `description` działa też na zwykłych pozycjach - dwuwierszowa pozycja menu.
1373
1832
 
1374
1833
  Pola honorują `kpt-menu`, `kpt-context-menu` i `kpt-split-button`. `kpt-menubar`, `kpt-megamenu`
1375
- i `kpt-speed-dial` dzielą typ, ale renderowania nie zmieniają. Wszystkie pola są opcjonalne —
1834
+ i `kpt-speed-dial` dzielą typ, ale renderowania nie zmieniają. Wszystkie pola są opcjonalne -
1376
1835
  istniejące `items` działają bez zmian.
1377
1836
 
1378
- - d67fde2: `kpt-sidenav` — slot stopki `kptSidenavFooter` przyklejonej do dołu panelu.
1837
+ - d67fde2: `kpt-sidenav` - slot stopki `kptSidenavFooter` przyklejonej do dołu panelu.
1379
1838
 
1380
1839
  Element z tym atrybutem trafia poza obszar przewijany, więc zostaje na dole niezależnie od długości
1381
- nawigacji — blok zalogowanego użytkownika, przełącznik motywu czy numer wersji nie odjeżdżają razem
1840
+ nawigacji - blok zalogowanego użytkownika, przełącznik motywu czy numer wersji nie odjeżdżają razem
1382
1841
  z listą pozycji. Stopka dostaje górną kreskę na pełną szerokość panelu i ten sam padding co nawigacja.
1383
1842
  W szynie ikon (`sidenavRailBreakpoint`) tekst stopki chowa się tym samym atrybutem `kptNavLabel`
1384
1843
  co etykiety pozycji.
1385
1844
 
1386
- Wewnątrz komponentu `padding`, `gap` i `overflow-y` przeniosły się z hosta do obszaru przewijanego —
1845
+ Wewnątrz komponentu `padding`, `gap` i `overflow-y` przeniosły się z hosta do obszaru przewijanego -
1387
1846
  panele bez stopki wyglądają identycznie jak dotąd. Zmiana dotyka tylko aplikacji, które celowały
1388
1847
  w `kpt-sidenav > *` selektorem dziecka bezpośredniego.
1389
1848
 
1390
1849
  ### Patch Changes
1391
1850
 
1392
- - Migotanie przycisków i paneli na pierwszej klatce — poprawki `kpt-button`, `kpt-drawer`
1851
+ - Migotanie przycisków i paneli na pierwszej klatce - poprawki `kpt-button`, `kpt-drawer`
1393
1852
  i `kpt-bottom-sheet`.
1394
1853
 
1395
1854
  Wspólna przyczyna: reguły stylu warunkowane atrybutem `[attr.data-*]`, który Angular ustawia
1396
1855
  dopiero w przebiegu aktualizacji. Przez jedną klatkę komponent stał więc w stanie bazowym
1397
1856
  i dopiero potem animował się do właściwego.
1398
1857
 
1399
- - **Przyciski** — sprzężenie zwrotne hovera i aktywności niesie pseudoelement `::after`
1400
- (`opacity` 0 → 1) zamiast animowanego `background-color`. Warstwa startuje przezroczysta,
1858
+ - **Przyciski** - sprzężenie zwrotne hovera i aktywności niesie pseudoelement `::after`
1859
+ (`opacity` 0 -> 1) zamiast animowanego `background-color`. Warstwa startuje przezroczysta,
1401
1860
  więc zmiana jej koloru na pierwszej klatce jest niewidoczna. `inset: 0` trzyma ją wewnątrz
1402
1861
  ramki, dzięki czemu obrys wariantu `outline` zostaje widoczny pod kursorem. Ten sam wzorzec
1403
1862
  dostają `kpt-icon-button`, `kpt-fab` i `kpt-split-button`.
1404
- - **`kpt-drawer`** — geometria pozycji domyślnej i przesunięcie poza ekran wróciły do reguły
1863
+ - **`kpt-drawer`** - geometria pozycji domyślnej i przesunięcie poza ekran wróciły do reguły
1405
1864
  bazowej, więc zamknięty panel nie pokazuje się na moment przed animacją.
1406
- - **`kpt-drawer` i `kpt-bottom-sheet`** — zamknięty panel wypada z kolejki Tab i z drzewa
1865
+ - **`kpt-drawer` i `kpt-bottom-sheet`** - zamknięty panel wypada z kolejki Tab i z drzewa
1407
1866
  dostępności przez `visibility: hidden`, nie przez `inert`. Jest poprawny już na pierwszej
1408
1867
  klatce, bez czekania na JavaScript, a animacja wjazdu zostaje (czego `display: none`
1409
1868
  by nie pozwolił).
@@ -1417,7 +1876,7 @@
1417
1876
  - Responsywny `kpt-app-shell`: nakładka, szyna ikon i panel zadokowany
1418
1877
 
1419
1878
  `kpt-app-shell` sam dobiera układ do szerokości okna. Nowy tryb `auto` (od `sidenavBreakpoint`,
1420
- domyślnie `lg`, panel jest zadokowany; poniżej — nakładka ze scrimem, domyślnie zamknięta),
1879
+ domyślnie `lg`, panel jest zadokowany; poniżej - nakładka ze scrimem, domyślnie zamknięta),
1421
1880
  opcjonalna szyna ikon w paśmie do `sidenavRailBreakpoint`, `Escape` zamykające nakładkę,
1422
1881
  `inert` na treści pod nią, poprawny kierunek wysuwu w RTL i wysokość `100dvh`.
1423
1882
 
@@ -1425,14 +1884,14 @@
1425
1884
 
1426
1885
  **Zmiana zachowania:** domyślną wartością `sidenavMode` jest teraz `'auto'` zamiast `'side'`.
1427
1886
  Jeśli aplikacja sama zarządza responsywnością szkieletu (własne `@media` i własny hamburger),
1428
- ustaw jawnie `sidenavMode="side"` — inaczej dostaniesz dwie warstwy tej samej logiki.
1887
+ ustaw jawnie `sidenavMode="side"` - inaczej dostaniesz dwie warstwy tej samej logiki.
1429
1888
  Tryby `'side'` i `'over'` działają dokładnie jak wcześniej.
1430
1889
 
1431
1890
  Nowe API:
1432
1891
 
1433
- - `KptBreakpointObserver` — media query jako sygnały (`up`, `down`, `matches`), spięte
1892
+ - `KptBreakpointObserver` - media query jako sygnały (`up`, `down`, `matches`), spięte
1434
1893
  z tokenami `--kpt-breakpoint-*`; poza przeglądarką zwraca `false`.
1435
- - `KptShellNavToggle` (`[kptShellNavToggle]`) — hamburger, który sam trafia w stan właściwy
1894
+ - `KptShellNavToggle` (`[kptShellNavToggle]`) - hamburger, który sam trafia w stan właściwy
1436
1895
  dla bieżącego układu i dokłada `aria-expanded` / `aria-controls` / etykietę z i18n.
1437
1896
  - `kpt-app-shell`: `sidenavCompactOpen`, `sidenavBreakpoint`, `sidenavRailBreakpoint`,
1438
1897
  `sidenavLabel`, `sidenavId`, `isOverlay()`, `isSidenavOpen()`,
@@ -1445,57 +1904,57 @@
1445
1904
  Poprawka: `kpt-drawer` używał fallbacku `--kpt-z-overlay: 1000` (wartość `z.dropdown`)
1446
1905
  zamiast `1100`.
1447
1906
 
1448
- - Nowy komponent `KptMap` (kpt-map) w subpathu `@konce-pt/angular/map` — interaktywna mapa
1907
+ - Nowy komponent `KptMap` (kpt-map) w subpathu `@konce-pt/angular/map` - interaktywna mapa
1449
1908
  z konfigurowalnymi znacznikami, na silniku Leaflet + OpenStreetMap.
1450
1909
 
1451
1910
  - Kategorie obiektów z kolorem (rola semantyczna tokenów, nie literał) i ikoną z `KptIconRegistry`;
1452
1911
  kształty `pin` / `dot` / `square`.
1453
- - Grupowanie znaczników z licznikiem — własny rdzeń pure TS (siatka w przestrzeni pikseli, O(n),
1912
+ - Grupowanie znaczników z licznikiem - własny rdzeń pure TS (siatka w przestrzeni pikseli, O(n),
1454
1913
  deterministyczna), wspólny dla obu silników i przenośny do portu React. Bez `leaflet.markercluster`.
1455
1914
  - Popup szczegółów o szablonie zależnym od kategorii (`ng-template kptMapPopup`), renderowany
1456
- przez Angulara i pozycjonowany przez `engine.project()` — pełne komponenty `kpt-*` w treści.
1457
- Kontekst szablonu niesie też `distance` — odległość punktu w metrach od `[distanceFrom]`,
1915
+ przez Angulara i pozycjonowany przez `engine.project()` - pełne komponenty `kpt-*` w treści.
1916
+ Kontekst szablonu niesie też `distance` - odległość punktu w metrach od `[distanceFrom]`,
1458
1917
  a bez niego od pozycji użytkownika.
1459
1918
  - **Karta miejsca `KptMapPoiCard` (kpt-map-poi-card)**: dystans, zdjęcie 16:9, przycisk główny
1460
1919
  z udostępnianiem i ulubionymi, wiersz kategorii, rozwijane godziny otwarcia ze statusem
1461
1920
  otwarte/zamknięte i wiersze kontaktowe (telefon, www, e-mail, współrzędne) z kopiowaniem
1462
1921
  do schowka. Sterowana danymi: bierze `KptMapPoi`, nie model domenowy aplikacji.
1463
- - `[popupLayout]="'card'"` oddaje popup w całości treści — bez paddingu, szerszy, przewijalny
1922
+ - `[popupLayout]="'card'"` oddaje popup w całości treści - bez paddingu, szerszy, przewijalny
1464
1923
  i bez wbudowanego krzyżyka (daje go karta). Domyślne `plain` zostaje bez zmian.
1465
1924
  - Nagłówek karty (tytuł, krzyżyk, dystans i adres) stoi nieruchomo; przewija się wyłącznie
1466
1925
  reszta treści, w osobnym `.kpt-map-poi__scroll`. Przewijanie schodzi w tym celu z popupu
1467
- do karty — `popupLayout="card"` daje `.kpt-map__popup-body` `display: flex` i `overflow:
1926
+ do karty - `popupLayout="card"` daje `.kpt-map__popup-body` `display: flex` i `overflow:
1468
1927
  hidden`, a karcie pełną wysokość. Sam popup zostaje bez `overflow: hidden`, bo ucięłby
1469
1928
  strzałkę `::after` wiszącą na `top: 100%`. Karta poza popupem, bez limitu wysokości,
1470
1929
  nie przewija się wcale.
1471
- - Pasek „Anuluj / Zapisz" w formularzu dodawania jest przypięty do dołu (`position: sticky`),
1930
+ - Pasek "Anuluj / Zapisz" w formularzu dodawania jest przypięty do dołu (`position: sticky`),
1472
1931
  więc nie ucieka na koniec długiej listy pól.
1473
1932
  - Legenda jako filtr: `KptMapLegend` (kpt-map-legend) z `aria-pressed`, liczniki per kategoria,
1474
1933
  ukrycie kategorii usuwa ją także z grup.
1475
1934
  - Dodawanie lokalizacji prawym przyciskiem myszy: formularz budowany ze schemy `category.fields`
1476
1935
  na Signal Forms albo własny `ng-template kptMapCreateForm`. Poza `text`/`textarea`/`number`/
1477
1936
  `date`/`select`/`multiselect`/`checkbox` schema przyjmuje `tel`, `email` i `url` (z walidacją
1478
- formatu), `image` — wybór pliku czytany jako `data:` **albo** wklejony adres, oraz `hours` —
1937
+ formatu), `image` - wybór pliku czytany jako `data:` **albo** wklejony adres, oraz `hours` -
1479
1938
  edytor tygodnia dający `KptMapOpeningHours`.
1480
1939
  Plik zdjęcia zostaje w przeglądarce: biblioteka nigdzie go nie wysyła i nie ma wiedzy
1481
- o storage'u aplikacji. Limit 2 MB jest realny — data URL puchnie o ~⅓, a cała wartość
1940
+ o storage'u aplikacji. Limit 2 MB jest realny - data URL puchnie o ~1/3, a cała wartość
1482
1941
  leci w `locationCreate`.
1483
1942
  - Widok startowy z presetu kraju (`KPT_MAP_COUNTRIES`, domyślnie Polska) oraz opcjonalne
1484
1943
  ograniczenie przesuwania do jego zasięgu.
1485
1944
  - Znacznik własnego położenia z geolokalizacji wraz z kręgiem dokładności i kontrolką
1486
- „wyśrodkuj na mnie"; źródło pozycji przez port DI `KPT_MAP_GEOLOCATION`
1945
+ "wyśrodkuj na mnie"; źródło pozycji przez port DI `KPT_MAP_GEOLOCATION`
1487
1946
  (`provideKptMapGeolocationStub()` dla Storybooka i testów).
1488
- - Silnik za interfejsem `KptMapEngine` — `provideKptLeafletMap()` dziś, adapter Google Maps
1947
+ - Silnik za interfejsem `KptMapEngine` - `provideKptLeafletMap()` dziś, adapter Google Maps
1489
1948
  bez zmian w API komponentu.
1490
1949
  - Rdzeń pure TS w publicznym API: `clusterLocations`, `countryPreset`, projekcja Mercatora
1491
1950
  (`project`/`unproject`/`boundsOf`/`haversine`/`metersPerPixel`/`zoomForBounds`),
1492
1951
  generatory HTML znaczników, formatowanie (`formatDistance`, `formatLatLng`) oraz godziny
1493
1952
  otwarcia (`isOpenAt`, `isAlwaysOpen`, `nextChange`, `groupWeek`, `weekdayName`, `emptyWeek`,
1494
1953
  `parseTime`, `formatTime`). Testy: `packages/angular/map/src/core/*.test.ts`.
1495
- `isOpenAt()` liczy dwa dni — bieżący i poprzedni — więc przedział `22:00–01:00` obejmuje
1954
+ `isOpenAt()` liczy dwa dni - bieżący i poprzedni - więc przedział `22:00-01:00` obejmuje
1496
1955
  wczesne godziny dnia następnego; `24:00` to koniec doby, a nie przejście przez północ.
1497
- `groupWeek()` skleja sąsiadujące dni o identycznym rozkładzie w `pon.–pt.`, ale nie zawija
1498
- tygodnia przez granicę niedziela–poniedziałek. Nazwy dni idą z `Intl`, nie ze słownika —
1956
+ `groupWeek()` skleja sąsiadujące dni o identycznym rozkładzie w `pon.-pt.`, ale nie zawija
1957
+ tygodnia przez granicę niedziela-poniedziałek. Nazwy dni idą z `Intl`, nie ze słownika -
1499
1958
  karta i edytor godzin działają dla dowolnego locale bez dopisywania tłumaczeń.
1500
1959
  - Nowe tokeny komponentowe `--kpt-map-*` (w tym `popup-width`, `popup-width-card`,
1501
1960
  `popup-max-height`, `poi-media-radius`, `poi-row-hover`) oraz klucze i18n `map.*`,
@@ -1505,38 +1964,38 @@ hidden`, a karcie pełną wysokość. Sam popup zostaje bez `overflow: hidden`,
1505
1964
  wymagać `provideKptTablerIcons()`.
1506
1965
  - `KptInput` przyjmuje `type="time"`.
1507
1966
  - `KptDatepicker` dostaje wejście `ariaLabel` (nazwa dostępna tam, gdzie pola nie opisuje
1508
- `<label for>` — np. dwie godziny w jednym wierszu) i w trybie `time` rysuje w polu ikonę
1967
+ `<label for>` - np. dwie godziny w jednym wierszu) i w trybie `time` rysuje w polu ikonę
1509
1968
  zegara zamiast kalendarza. Godziny otwarcia wybiera się właśnie nim
1510
1969
  (`selectionMode="time"`, `minuteStep=5`), a nie natywnym `<input type="time">`: tamten
1511
1970
  otwiera systemowy dropdown, którego nie da się ostylować.
1512
1971
  - **Naprawiony kolor ikony kategorii `muted` poza mapą.** Legenda malowała glif zaszytą
1513
- bielą na tle koloru roli, a `--kpt-color-muted` to neutral-100 — token tła, nie treści.
1972
+ bielą na tle koloru roli, a `--kpt-color-muted` to neutral-100 - token tła, nie treści.
1514
1973
  Kategoria `muted` miała więc w legendzie ikonę praktycznie niewidoczną, choć jej znacznik
1515
1974
  na mapie był poprawny (ten bierze `contrastVarOf()`). Legenda używa teraz `contrastVarOf()`,
1516
1975
  a nowe `foregroundVarOf()` w publicznym API daje kolor glifu stojącego wprost na powierzchni
1517
- (bez własnego tła) — z niego korzysta wiersz kategorii w karcie miejsca.
1518
- - `renderKptIconSvg()` wydzielone z `kpt-icon` do publicznego API — mapa buduje z niego
1976
+ (bez własnego tła) - z niego korzysta wiersz kategorii w karcie miejsca.
1977
+ - `renderKptIconSvg()` wydzielone z `kpt-icon` do publicznego API - mapa buduje z niego
1519
1978
  znaczniki poza Angularem, więc oba miejsca mają jedno źródło prawdy.
1520
1979
 
1521
1980
  **Nowa zależność opcjonalna:** `leaflet` jako `peerDependencies` + `peerDependenciesMeta.optional`.
1522
1981
  To pierwsza zależność runtime biblioteki. Ładowana dynamicznym `import()`, więc aplikacje bez mapy
1523
1982
  jej nie pobierają. Użycie mapy wymaga `pnpm add leaflet` i dołączenia `leaflet/dist/leaflet.css`
1524
- (Angular CLI: `angular.json → styles[]`, nie `import` w `main.ts`).
1983
+ (Angular CLI: `angular.json -> styles[]`, nie `import` w `main.ts`).
1525
1984
 
1526
- **Uwaga o kaskadzie:** nadpisania `.leaflet-*` w `map.component.scss` stoją poza `@layer` — celowo
1985
+ **Uwaga o kaskadzie:** nadpisania `.leaflet-*` w `map.component.scss` stoją poza `@layer` - celowo
1527
1986
  i jako jedyne w bibliotece. `leaflet.css` nie jest warstwowany, a CSS spoza warstw wygrywa z każdą
1528
1987
  regułą w `@layer` niezależnie od specyficzności.
1529
1988
 
1530
- - Podpowiadanie adresu w formularzu „dodaj lokalizację": pole z `autofill` (`city`, `address`,
1989
+ - Podpowiadanie adresu w formularzu "dodaj lokalizację": pole z `autofill` (`city`, `address`,
1531
1990
  `street`, `houseNumber`, `postcode`, `state`, `county`, `country`, `countryCode`, `label`)
1532
1991
  wypełnia się z geokodowania wstecznego współrzędnych kliknięcia. Źródło przez port DI
1533
- `KPT_MAP_GEOCODER`; gotowy adapter `provideKptNominatimGeocoder()` jest **opt-in** —
1992
+ `KPT_MAP_GEOCODER`; gotowy adapter `provideKptNominatimGeocoder()` jest **opt-in** -
1534
1993
  biblioteka nie odpytuje cudzego serwera bez zgody aplikacji. Podpowiedź wypełnia wyłącznie
1535
1994
  pola puste, więc nigdy nie kasuje tego, co użytkownik wpisał.
1536
1995
 
1537
1996
  **Uwaga o kaflach:** domyślne `tile.openstreetmap.org` to usługa best-effort bez SLA, z wymogiem
1538
1997
  widocznej atrybucji i zakazem pre-fetchowania. Do produkcji podstaw własny serwer przez `[tileUrl]`.
1539
- To samo dotyczy Nominatim (jedno zapytanie na sekundę, zakaz masowego odpytywania) — adapter sam
1998
+ To samo dotyczy Nominatim (jedno zapytanie na sekundę, zakaz masowego odpytywania) - adapter sam
1540
1999
  trzyma odstęp, ale produkcja powinna mieć własną instancję albo dostawcę komercyjnego.
1541
2000
 
1542
2001
  ***
@@ -1544,45 +2003,45 @@ hidden`, a karcie pełną wysokość. Sam popup zostaje bez `overflow: hidden`,
1544
2003
  Przy okazji naprawiony **utajony błąd `KptDialog`**: kontrolki na CDK Overlay (`kpt-select`,
1545
2004
  `kpt-datepicker`, `kpt-autocomplete`, `kpt-menu`) otwierały się w środku okna modalnego
1546
2005
  niewidoczne. `showModal()` wynosi `<dialog>` do warstwy szczytowej przeglądarki, ponad całe
1547
- drzewo dokumentu, a kontener CDK Overlay wisi na `<body>` — żaden `z-index` tego nie przebija.
2006
+ drzewo dokumentu, a kontener CDK Overlay wisi na `<body>` - żaden `z-index` tego nie przebija.
1548
2007
  `kpt-dialog` przenosi teraz kontener overlayów do wnętrza okna na czas jego otwarcia i oddaje
1549
2008
  go na miejsce przy zamknięciu.
1550
2009
 
1551
2010
  Błąd był w bibliotece od początku, ale nieuruchomiony: żaden przykład nie umieszczał kontrolki
1552
- overlayowej w oknie modalnym. Ujawnił go formularz „dodaj lokalizację" z pól `date` i `select`.
2011
+ overlayowej w oknie modalnym. Ujawnił go formularz "dodaj lokalizację" z pól `date` i `select`.
1553
2012
 
1554
2013
  **Nieruchomy nagłówek okna.** `.kpt-dialog` jest teraz kolumną flex: nagłówek z krzyżykiem
1555
2014
  i stopka `[kptDialogFooter]` stoją, a pasek przewijania biegnie wyłącznie wzdłuż
1556
2015
  `.kpt-dialog__body`. Wcześniej okno przewijało się w całości, razem z nagłówkiem. Treść
1557
- dostaje `flex: 0 1 auto` + `min-height: 0`, celowo nie `flex: 1` — krótkie okno (`kpt-confirm`)
2016
+ dostaje `flex: 0 1 auto` + `min-height: 0`, celowo nie `flex: 1` - krótkie okno (`kpt-confirm`)
1558
2017
  dalej kurczy się do treści, zamiast rozciągać na `max-height`. `display: flex` jest scopowane
1559
2018
  `&[open]`: regułę `dialog:not([open]) { display: none }` daje arkusz przeglądarki, a każda
1560
- deklaracja autorska ją bije — także z `@layer`, więc bez scopingu zamknięte okna zostałyby
2019
+ deklaracja autorska ją bije - także z `@layer`, więc bez scopingu zamknięte okna zostałyby
1561
2020
  widoczne. `overflow: hidden` na oknie celowo nie ma: przycięłoby panele CDK Overlay
1562
2021
  przeniesione do jego wnętrza.
1563
2022
 
1564
2023
  `.kpt-map .leaflet-container` dostaje `z-index: 0`, żeby zamknąć skalę z-index Leafleta
1565
- (panes 200–700, kontrolki 800) we własnym kontekście układania — bez tego popup, kontrolki
2024
+ (panes 200-700, kontrolki 800) we własnym kontekście układania - bez tego popup, kontrolki
1566
2025
  zoomu i menu prawego przycisku są malowane pod kaflami.
1567
2026
 
1568
2027
  ***
1569
2028
 
1570
2029
  Naprawiony też **utajony błąd `KptSwitch`, `KptCheckbox` i `KptRadioGroup`**: ukryty `<input>`
1571
2030
  tych kontrolek jest `position: absolute`, ale ich element główny nie był pozycjonowany. Blokiem
1572
- zawierającym stawał się więc najbliższy pozycjonowany przodek — w praktyce kontener aplikacji —
2031
+ zawierającym stawał się więc najbliższy pozycjonowany przodek - w praktyce kontener aplikacji -
1573
2032
  przez co input uciekał poza przewijany obszar i rozpychał dokument, dając **drugi pasek
1574
2033
  przewijania** obok paska treści. Kontrolki zatrzymują teraz swój input u siebie
1575
2034
  (`position: relative` na elemencie głównym).
1576
2035
 
1577
2036
  Widoczne dopiero, gdy któraś z tych kontrolek trafi dostatecznie nisko w długiej, przewijanej
1578
- stronie — stąd ujawniło się na stronie mapy, która ma pięć przełączników.
2037
+ stronie - stąd ujawniło się na stronie mapy, która ma pięć przełączników.
1579
2038
 
1580
- - Geokoder per mapa — nowe wejście `[geocoder]` w `kpt-map`, symetryczne do `[engine]`.
2039
+ - Geokoder per mapa - nowe wejście `[geocoder]` w `kpt-map`, symetryczne do `[engine]`.
1581
2040
 
1582
2041
  - `[geocoder]` przyjmuje `KptMapGeocoderPort` i wygrywa nad `KPT_MAP_GEOCODER` z DI. Trafia do
1583
2042
  obu konsumentów portu naraz: wyszukiwarki adresów i podpowiadania adresu w formularzu
1584
- „dodaj lokalizację". To samo wejście mają `kpt-map-search` i `kpt-map-create-dialog`, gdy stoją
1585
- poza mapą. Bez niego nic się nie zmienia — port przychodzi z DI, jak dotąd.
2043
+ "dodaj lokalizację". To samo wejście mają `kpt-map-search` i `kpt-map-create-dialog`, gdy stoją
2044
+ poza mapą. Bez niego nic się nie zmienia - port przychodzi z DI, jak dotąd.
1586
2045
  - **Po co.** Service Specific Terms §6.2 i §14.2 wiążą geokoder Google z **mapą** Google, a nie
1587
2046
  z aplikacją. Odkąd `[engine]` pozwala postawić dwa silniki na jednej stronie, globalny provider
1588
2047
  nie umiał tej reguły dotrzymać: musiałby złamać ją po jednej ze stron. Teraz mapa Leafleta
@@ -1590,16 +2049,16 @@ hidden`, a karcie pełną wysokość. Sam popup zostaje bez `overflow: hidden`,
1590
2049
  - W odróżnieniu od `[engine]` port czytany jest **reaktywnie**: podmiana zeruje listę podpowiedzi
1591
2050
  i od następnej frazy pyta nowego dostawcę.
1592
2051
  - `loadGoogleMapsApi(options)` wyeksportowany z `@konce-pt/angular/map` (plus typy
1593
- `KptGoogleLoadOptions` i `KptGoogleMapsApi`) — ten sam loader, którego używa silnik. Adapter
2052
+ `KptGoogleLoadOptions` i `KptGoogleMapsApi`) - ten sam loader, którego używa silnik. Adapter
1594
2053
  geokodera Google **musi** iść przez SDK, a nie przez REST: web service
1595
2054
  `maps.googleapis.com/maps/api/geocode/json` odrzuca klucze ograniczone po `Referer`
1596
- („API keys with referer restrictions cannot be used with this API"), a to jedyna restrykcja
2055
+ ("API keys with referer restrictions cannot be used with this API"), a to jedyna restrykcja
1597
2056
  mająca sens dla klucza leżącego jawnie w bundlu przeglądarki. CORS na tym endpoincie działa,
1598
- więc odmowa przychodzi jako `200` z `REQUEST_DENIED` w treści — łatwo ją przeoczyć.
2057
+ więc odmowa przychodzi jako `200` z `REQUEST_DENIED` w treści - łatwo ją przeoczyć.
1599
2058
  Samego adaptera biblioteka nadal nie dostarcza; przykład od początku do końca stoi
1600
2059
  w playgroundzie.
1601
2060
 
1602
- - Drugi silnik mapy — Google Maps — i wybór silnika per instancja przez wejście `[engine]`.
2061
+ - Drugi silnik mapy - Google Maps - i wybór silnika per instancja przez wejście `[engine]`.
1603
2062
 
1604
2063
  - `provideKptGoogleMap({ apiKey, mapId, language?, region?, version?, minZoom?, maxZoom?,
1605
2064
  scrollWheelZoom? })` obok `provideKptLeafletMap()`. **Zero nowych zależności npm**: Google Maps
@@ -1607,12 +2066,12 @@ scrollWheelZoom? })` obok `provideKptLeafletMap()`. **Zero nowych zależności n
1607
2066
  `import()`. Paczka `@googlemaps/js-api-loader` dokładałaby wersję do pilnowania w zamian za te
1608
2067
  same kilkanaście linijek.
1609
2068
  - **`mapId` jest wymagany.** Bez niego nie działa `AdvancedMarkerElement`, a znaczniki tej
1610
- biblioteki to gotowy HTML z `marker-html.ts` — starsze `Marker` go nie przyjmie.
2069
+ biblioteki to gotowy HTML z `marker-html.ts` - starsze `Marker` go nie przyjmie.
1611
2070
  - Nowe wejście **`[engine]`** (`KptMapEngineFactory | null`) wygrywa nad `KPT_MAP_ENGINE` z DI.
1612
2071
  Dwie mapy o różnych silnikach mieszczą się dzięki temu na jednej stronie bez komponentów-opakowań.
1613
2072
  `KPT_MAP_ENGINE` staje się wstrzykiwany opcjonalnie, a brak silnika w obu źródłach daje czytelny
1614
2073
  komunikat z instrukcją zamiast `NullInjectorError` z nazwą tokenu.
1615
- - Kontrakt `KptMapEngine` **nie zmienił się o ani jedną sygnaturę** — to był cel tego interfejsu
2074
+ - Kontrakt `KptMapEngine` **nie zmienił się o ani jedną sygnaturę** - to był cel tego interfejsu
1616
2075
  i teraz się zweryfikował. Grupowanie, popup, legenda, menu prawego przycisku, wyszukiwarka
1617
2076
  i formularz dodawania działają w obu silnikach z tego samego kodu.
1618
2077
  - Adapter Google liczy `project()`/`unproject()` **rdzeniem** (`core/geo.ts`), a nie
@@ -1628,18 +2087,18 @@ scrollWheelZoom? })` obok `provideKptLeafletMap()`. **Zero nowych zależności n
1628
2087
  przyjmuje kolory w opcjach, a kontrakt repo wymaga stylowania tokenami `var(--kpt-*)`. Średnicę
1629
2088
  liczy `metersPerPixel()` z rdzenia i odświeża na `zoom_changed`. Silnik trafia na host jako
1630
2089
  `[data-engine]`, więc różnicę widać w jednej regule SCSS.
1631
- - `[tileUrl]` i `[attribution]` są przy silniku Google **ignorowane** — kafle i atrybucję dostarcza
2090
+ - `[tileUrl]` i `[attribution]` są przy silniku Google **ignorowane** - kafle i atrybucję dostarcza
1632
2091
  Google, a jej zasłonięcie albo usunięcie łamie warunki usługi. `setTileSource()` i
1633
2092
  `invalidateSize()` to tam świadome no-opy.
1634
2093
 
1635
2094
  **Dlaczego to w ogóle powstało.** Google Maps Platform Service Specific Terms §6.2 (Geocoding API)
1636
- i §14.2 (Places API) zabraniają używać ich wyników „in conjunction with a non-Google map".
2095
+ i §14.2 (Places API) zabraniają używać ich wyników "in conjunction with a non-Google map".
1637
2096
  Dopóki `kpt-map` umiał tylko Leaflet z kaflami OSM, każdy adapter Google pod `KPT_MAP_GEOCODER`
1638
2097
  był niezgodny z umową. Silnik Google zdejmuje to u źródła. Sama biblioteka adaptera geokodera
1639
- Google **nie dostarcza** — jego miejsce jest w aplikacji, bo wolno go użyć tylko z jednym
2098
+ Google **nie dostarcza** - jego miejsce jest w aplikacji, bo wolno go użyć tylko z jednym
1640
2099
  z dwóch silników.
1641
2100
 
1642
- - Wyszukiwarka adresów w `kpt-map` — `[search]` (domyślnie wyłączona) pokazuje w rogu mapy pole
2101
+ - Wyszukiwarka adresów w `kpt-map` - `[search]` (domyślnie wyłączona) pokazuje w rogu mapy pole
1643
2102
  z podpowiedziami; wybór podpowiedzi przenosi widok na znalezione miejsce.
1644
2103
 
1645
2104
  - Port `KPT_MAP_GEOCODER` dostaje **opcjonalną** metodę `search(query, options)` obok istniejącego
@@ -1647,65 +2106,65 @@ scrollWheelZoom? })` obok `provideKptLeafletMap()`. **Zero nowych zależności n
1647
2106
  bez zmian, a `kpt-map` bez niej po prostu nie renderuje pola. Nowe typy `KptMapSuggestion`
1648
2107
  (`{ id, label, at?, bounds?, address? }`), `KptMapSearchResult` (to samo z wymaganym `at`)
1649
2108
  i `KptMapSearchOptions` w publicznym API; `address` to ten sam `KptMapAddress`, co przy
1650
- geokodowaniu wstecznym — bez drugiego modelu adresu.
2109
+ geokodowaniu wstecznym - bez drugiego modelu adresu.
1651
2110
  - `KptNominatimGeocoder` implementuje `search()` na `/search` i wchodzi w **tę samą kolejkę**
1652
2111
  co `reverse()`: polityka Nominatim liczy jedno zapytanie na sekundę na całego klienta,
1653
2112
  a nie na metodę.
1654
2113
  - **Kolejka adaptera Nominatim liczy odstęp od zegara**, a nie stałym `delay(1000)` przed każdym
1655
2114
  zapytaniem. Wcześniej pierwsze zapytanie po dowolnie długiej bezczynności też płaciło sekundę
1656
- — przy podpowiadaniu w trakcie pisania to różnica między „działa" a „zacina się". Zmiana
1657
- dotyczy także istniejącego `reverse()`; górna granica jednego zapytania na sekundę
1658
- zostaje nienaruszona.
2115
+ - przy podpowiadaniu w trakcie pisania to różnica między "działa" a "zacina się". Zmiana
2116
+ dotyczy także istniejącego `reverse()`; górna granica jednego zapytania na sekundę
2117
+ zostaje nienaruszona.
1659
2118
  - Nowe w rdzeniu (pure TS, publiczne API): `isFittableBounds(bounds, minSpan?)` i `KPT_MIN_FIT_SPAN`
1660
- (0,001°, ~100 m) — czy prostokąt warto wpasowywać w kadr, czy potraktować jak punkt.
2119
+ (0,001°, ~100 m) - czy prostokąt warto wpasowywać w kadr, czy potraktować jak punkt.
1661
2120
  Geokodery obrysowują pojedynczy adres prostokątem rzędu 0,0001°, więc `fitBounds` wjeżdżałby
1662
2121
  na nim na górny limit zoomu, a dwa sąsiednie adresy lądowałyby w różnych przybliżeniach.
1663
- Próg wystarczy przekroczyć w jednej osi — długa, wąska ulica dalej zasługuje na `fitBounds`.
2122
+ Próg wystarczy przekroczyć w jednej osi - długa, wąska ulica dalej zasługuje na `fitBounds`.
1664
2123
  Testy: `packages/angular/map/src/core/geo.test.ts`.
1665
2124
  - Nowe wejścia `kpt-map`: `search`, `searchPlaceholder`, `searchOptions`
1666
2125
  (`minLength` = 3, `debounce` = 300 ms, `limit` = 5, `countryCodes`), `searchZoom` = 16,
1667
2126
  `searchMarker` = true. Nowe wyjście `searchSelect`.
1668
2127
  - Wynik z własnym zasięgiem (miasto, region) wchodzi w kadr przez `fitBounds`, a pojedynczy
1669
- punkt dostaje `[searchZoom]` — dzięki temu każdy adres ląduje w tym samym, przewidywalnym
2128
+ punkt dostaje `[searchZoom]` - dzięki temu każdy adres ląduje w tym samym, przewidywalnym
1670
2129
  przybliżeniu, niezależnie od tego, jak dostawca obrysował budynek.
1671
2130
  - Zapytania są nachylone ku presetowi `[country]` (albo `[bounds]`) przez `viewbox`. To sam
1672
- bias — przestawia kolejność wyników i niczego nie odcina; adres z zagranicy dalej da się
2131
+ bias - przestawia kolejność wyników i niczego nie odcina; adres z zagranicy dalej da się
1673
2132
  znaleźć. Twarde `countrycodes` dokłada się dopiero przy `restrictToCountry` (mapa i tak nie
1674
2133
  pozwoli przesunąć widoku poza kraj) albo jawnie przez `searchOptions.countryCodes`.
1675
- - Tymczasowa pinezka wyniku idzie tą samą drogą co reszta znaczników — przez
1676
- `engine.setMarkers()` — więc przesuwa się z mapą klatka po klatce i **nie wymaga niczego
2134
+ - Tymczasowa pinezka wyniku idzie tą samą drogą co reszta znaczników - przez
2135
+ `engine.setMarkers()` - więc przesuwa się z mapą klatka po klatce i **nie wymaga niczego
1677
2136
  od silnika**. Nie należy do wyniku grupowania, więc kliknięcie w nią nic nie otwiera.
1678
2137
  Znika po wyczyszczeniu pola i po kliknięciu w mapę.
1679
- - Nowy komponent `KptMapSearch` (kpt-map-search) w publicznym API — jak legenda, do postawienia
2138
+ - Nowy komponent `KptMapSearch` (kpt-map-search) w publicznym API - jak legenda, do postawienia
1680
2139
  także poza mapą. Świadomie **nie** stoi na `kpt-autocomplete`: tamten filtruje opcje po stronie
1681
2140
  klienta (`includes(q)`), więc wynik geokodera tolerancyjny na literówki wypadałby z listy;
1682
2141
  jego wartością jest sam `string`, więc nie ma czym przewieźć współrzędnych; i wymaga CDK
1683
2142
  Overlay, którego mapa poza tym nie potrzebuje. Panel podpowiedzi rysuje więc warstwa Angulara
1684
2143
  nad mapą, tak samo jak popup i menu prawego przycisku (`z-index: 5`, nad tamtymi).
1685
- - Wzorzec combobox z `aria-activedescendant` (fokus zostaje w `<input>`), klawiatura ↑/↓/Enter,
1686
- pierwszy Esc zamyka listę, drugi czyści pole; liczba wyników i „brak wyników" w `aria-live`.
2144
+ - Wzorzec combobox z `aria-activedescendant` (fokus zostaje w `<input>`), klawiatura ArrowUp/ArrowDown/Enter,
2145
+ pierwszy Esc zamyka listę, drugi czyści pole; liczba wyników i "brak wyników" w `aria-live`.
1687
2146
  - **Port przyjmuje dostawców, którzy nie podają współrzędnych na liście.** `search()` zwraca teraz
1688
2147
  `KptMapSuggestion` (`at` opcjonalne) zamiast `KptMapSearchResult`, a port może dopisać
1689
2148
  `resolve(suggestion)`, które dokłada `lat`/`lng` **po wybraniu pozycji**. Tak działa Google Places
1690
- Autocomplete: oddaje `placeId` i tekst, a współrzędne dociąga osobny Place Details — na tym stoi
2149
+ Autocomplete: oddaje `placeId` i tekst, a współrzędne dociąga osobny Place Details - na tym stoi
1691
2150
  jego rozliczanie sesyjne, więc bez tego kroku podpowiadanie z Google kosztowałoby pięć wywołań
1692
2151
  Place Details na każdy zestaw podpowiedzi zamiast jednego na wybór.
1693
2152
  Zmiana jest **wstecznie zgodna**: `KptMapSearchResult` to teraz `KptMapSuggestion` z wymaganym
1694
2153
  `at`, więc adaptery zwracające pełne wyniki (Nominatim, Photon, każdy geokoder pytany wprost)
1695
2154
  spełniają interfejs bez zmiany linijki, a `selected`/`searchSelect` dalej mają ten sam typ.
1696
- - Obsługa `resolve()` siedzi w `KptMapSearch`, nie w `kpt-map` — dzięki temu **`selected`
2155
+ - Obsługa `resolve()` siedzi w `KptMapSearch`, nie w `kpt-map` - dzięki temu **`selected`
1697
2156
  i `searchSelect` zawsze niosą współrzędne**, także gdy pole stoi poza mapą, i aplikacja nigdy
1698
2157
  nie musi sprawdzać, czy `at` jest. Podpowiedź ze współrzędnymi emituje się natychmiast (zero
1699
- opóźnienia dla Nominatima); bez nich panel pokazuje „Szukam…" i `aria-busy`, a nieudane
2158
+ opóźnienia dla Nominatima); bez nich panel pokazuje "Szukam..." i `aria-busy`, a nieudane
1700
2159
  dociągnięcie zostawia etykietę w polu i wraca do listy zamiast wywracać pole. Gdy port nie ma
1701
- `resolve()`, podpowiedzi bez `at` w ogóle nie trafiają na listę — pozycja, której kliknięcie
2160
+ `resolve()`, podpowiedzi bez `at` w ogóle nie trafiają na listę - pozycja, której kliknięcie
1702
2161
  nie miałoby dokąd polecieć, jest gorsza niż jej brak.
1703
- - **`KptNominatimOptions.minIntervalMs`** — sekundowy odstęp przestał być stałą w kodzie.
2162
+ - **`KptNominatimOptions.minIntervalMs`** - sekundowy odstęp przestał być stałą w kodzie.
1704
2163
  Domyślna zależy od `baseUrl`: publiczna instancja OSM dostaje 1000 ms jak dotąd, własna 0,
1705
2164
  bo regulamin OSMF nie obowiązuje na cudzym serwerze. `0` zdejmuje też kolejkowanie.
1706
2165
  Wcześniej własna instancja Nominatima płaciła sekundę za każdą podpowiedź bez żadnego powodu
1707
2166
  i nie dało się tego wyłączyć opcją.
1708
- - `provideKptMapGeocoderStub(address, results?, options?)` przyjmuje teraz listę podpowiedzi —
2167
+ - `provideKptMapGeocoderStub(address, results?, options?)` przyjmuje teraz listę podpowiedzi -
1709
2168
  Storybook i testy dostają wyszukiwarkę bez ruchu sieciowego. Trzeci argument
1710
2169
  (`{ deferCoordinates: true }`) każe atrapie udawać dostawcę bez współrzędnych na liście, żeby
1711
2170
  ścieżkę `resolve()` dało się pokazać bez prawdziwego klucza API. Sygnatura wstecznie zgodna.
@@ -1714,44 +2173,44 @@ scrollWheelZoom? })` obok `provideKptLeafletMap()`. **Zero nowych zależności n
1714
2173
  - Wyszukiwarkę pozycjonuje **opakowanie** `<div class="kpt-map__search">`, a nie klasa
1715
2174
  postawiona wprost na `<kpt-map-search>`. Jeden element z obiema klasami znaczył dwie reguły
1716
2175
  o identycznej specyficzności (0,1,0) w tej samej warstwie `kpt.components`, więc rozstrzygała
1717
- kolejność wstrzyknięcia stylów — a Angular wstrzykuje style dziecka po stylach rodzica.
2176
+ kolejność wstrzyknięcia stylów - a Angular wstrzykuje style dziecka po stylach rodzica.
1718
2177
  `.kpt-map-search { position: relative }` (blok zawierający dla panelu podpowiedzi) wygrywało
1719
2178
  z `absolute` rodzica, pole wypadało do normalnego przepływu za `.kpt-map__canvas`
1720
2179
  (`height: 100%`) i znikało przycięte przez `overflow: hidden` widoku. Element był w DOM
1721
- z poprawnymi atrybutami — usterkę widać wyłącznie na zrzucie ekranu.
2180
+ z poprawnymi atrybutami - usterkę widać wyłącznie na zrzucie ekranu.
1722
2181
 
1723
2182
  **Uwaga o polityce Nominatim.** Podpowiadanie w trakcie pisania z natury generuje serie zapytań,
1724
2183
  więc pole broni się progiem `minLength` i `debounce`, a adapter wspólną kolejką i przerywaniem
1725
2184
  porzuconych zapytań przez `AbortController`. Do produkcji dalej obowiązuje własna instancja
1726
- (`baseUrl`) albo dostawca komercyjny pod `KPT_MAP_GEOCODER` — publiczna instancja OSM zabrania
2185
+ (`baseUrl`) albo dostawca komercyjny pod `KPT_MAP_GEOCODER` - publiczna instancja OSM zabrania
1727
2186
  masowego odpytywania i może zablokować ruch bez uprzedzenia.
1728
2187
 
1729
2188
  ## 0.7.0
1730
2189
 
1731
2190
  ### Minor Changes
1732
2191
 
1733
- - Nowy komponent `KptRoadmap` (`kpt-roadmap`) w subpathu `@konce-pt/angular/roadmap` — zadania na
2192
+ - Nowy komponent `KptRoadmap` (`kpt-roadmap`) w subpathu `@konce-pt/angular/roadmap` - zadania na
1734
2193
  poziomej osi czasu w widoku typu Gantt. Przyklejona kolumna etykiet i nagłówek osi, przewijanie
1735
2194
  w obu osiach, opcjonalna stała wysokość. Zoom: rok / kwartał / miesiąc / tydzień / dzień / godzina,
1736
2195
  z oknem godzin roboczych. Numeracja tygodni wg ISO 8601 wraz z realnym zakresem dat; zmiana roku
1737
2196
  oznaczona mocniejszą linią i czarnym znacznikiem. Kolumny zachowują równą szerokość mimo zmiany
1738
2197
  czasu i różnej długości miesięcy. Grupy zwijane z paskiem zbiorczym, kamienie milowe, zależności
1739
- FS/SS/FF/SF z wykrywaniem naruszeń, wirtualizacja wierszy. Rdzeń obliczeń jako pure TS — subpath
2198
+ FS/SS/FF/SF z wykrywaniem naruszeń, wirtualizacja wierszy. Rdzeń obliczeń jako pure TS - subpath
1740
2199
  eksportuje `buildTimeline`, `buildRows`, `resolveLinks`, `autoRange` i pomocniki kalendarza ISO.
1741
2200
  Nowe klucze i18n `roadmap.*` (EN + PL).
1742
- - `KptTooltip`: nowe wejście `kptTooltipOnlyWhenTruncated` — dymek pojawia się wyłącznie wtedy, gdy
2201
+ - `KptTooltip`: nowe wejście `kptTooltipOnlyWhenTruncated` - dymek pojawia się wyłącznie wtedy, gdy
1743
2202
  treść nie mieści się w elemencie i jest ucięta wielokropkiem. Przepełnienie sprawdzane jest przy
1744
2203
  najechaniu (nie przy renderze), więc wynik pozostaje aktualny po zmianie szerokości czy powiększenia
1745
2204
  bez użycia `ResizeObserver`. Pomiar obejmuje hosta i jego bezpośrednie dzieci, bo `text-overflow`
1746
2205
  zwykle siedzi na wewnętrznym elemencie.
1747
- - `KptTooltip`: dymek podąża za hostem przy przewijaniu zagnieżdżonych kontenerów — wcześniej
2206
+ - `KptTooltip`: dymek podąża za hostem przy przewijaniu zagnieżdżonych kontenerów - wcześniej
1748
2207
  zostawał w miejscu, gdy host przesuwał się we własnym obszarze przewijania.
1749
2208
 
1750
2209
  ## 0.6.1
1751
2210
 
1752
2211
  ### Patch Changes
1753
2212
 
1754
- - Wydanie porządkowe — wyrównanie wersji paczek. Bez zmian w API.
2213
+ - Wydanie porządkowe - wyrównanie wersji paczek. Bez zmian w API.
1755
2214
 
1756
2215
  ## 0.6.0
1757
2216
 
@@ -1772,7 +2231,7 @@ scrollWheelZoom? })` obok `provideKptLeafletMap()`. **Zero nowych zależności n
1772
2231
 
1773
2232
  ### Patch Changes
1774
2233
 
1775
- - Naprawa dokumentacji ładowania stylów: metodą główną dla Angular CLI jest `angular.json → styles[]`
2234
+ - Naprawa dokumentacji ładowania stylów: metodą główną dla Angular CLI jest `angular.json -> styles[]`
1776
2235
  (import '...css' w main.ts zostaje jako wariant dla Vite/webpack). Tokeny SCSS dostają mixiny
1777
2236
  `kpt-root-tokens`/`kpt-dark-tokens` emitujące custom properties w runtime. Wejścia CSS dostają
1778
2237
  warunek `types` + stub `.d.ts` (usuwa TS2882 w projektach z tsc). Bez zmian w API komponentów.
@@ -1789,6 +2248,6 @@ scrollWheelZoom? })` obok `provideKptLeafletMap()`. **Zero nowych zależności n
1789
2248
  ### Minor Changes
1790
2249
 
1791
2250
  - Pierwsze wydanie Koncept UI: design tokeny (OKLCH, motyw jasny/ciemny), bazowy CSS,
1792
- oraz komponenty Angular 22 — layout (app-shell/toolbar/sidenav/card/divider), formularze
2251
+ oraz komponenty Angular 22 - layout (app-shell/toolbar/sidenav/card/divider), formularze
1793
2252
  na Signal Forms (input/select/checkbox/radio/switch/datepicker/form-field), flagowa tabela
1794
2253
  danych (kpt-data-table) z paginatorem, oraz feedback (alert/dialog/toast/tooltip).