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