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