@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
@@ -1,13 +1,13 @@
1
1
  import * as _angular_core from '@angular/core';
2
2
  import { TemplateRef, InjectionToken, Provider, WritableSignal } from '@angular/core';
3
- import { KptI18n, KptOption } from '@konce-pt/angular';
3
+ import { KptSpeechColor, KptI18n, KptOption } from '@konce-pt/angular';
4
4
  import { KptLatLng, KptMapCategory, KptMapLocation, KptMapAddress, KptMapBounds, KptMapSuggestion, KptMapSearchResult, KptMapView, KptClusterOptions, KptMapEngineFactory, KptMapCluster, KptMapCreateEvent, KptMapUserPosition, KptMapGeolocationError, KptMapPoint, KptMapFieldDef, KptMapPoi, KptMapHoursGroup, KptMapOpeningHours, KptMapWeekday, KptGoogleOptions, KptLeafletOptions } from '@konce-pt/map';
5
5
  export { KPT_CLUSTER_DEFAULTS, KPT_EARTH_RADIUS, KPT_MAP_COUNTRIES, KPT_MAP_DEFAULT_ATTRIBUTION, KPT_MAP_DEFAULT_COUNTRY, KPT_MAP_DEFAULT_TILE_URL, KPT_MAX_LATITUDE, KPT_MIN_FIT_SPAN, KPT_TILE_SIZE, KptClusterOptions, KptGoogleLoadOptions, KptGoogleMapsApi, KptGoogleOptions, KptLatLng, KptLeafletOptions, KptMapAddress, KptMapAddressPart, KptMapBounds, KptMapCategory, KptMapCluster, KptMapClusterEntry, KptMapColor, KptMapColorRole, KptMapCountryPreset, KptMapCreateEvent, KptMapDayHours, KptMapEngine, KptMapEngineEvents, KptMapEngineFactory, KptMapEngineInit, KptMapEngineKind, KptMapFieldDef, KptMapFieldOption, KptMapFieldType, KptMapGeolocationError, KptMapGeolocationErrorKind, KptMapHoursGroup, KptMapHoursRange, KptMapLocation, KptMapMarkerShape, KptMapOpeningHours, KptMapPoi, KptMapPoiFact, KptMapPoint, KptMapPointerEvent, KptMapRenderedMarker, KptMapSearchResult, KptMapSuggestion, KptMapUserPosition, KptMapView, KptMapWeekday, boundsCenter, boundsContain, boundsOf, centerOfBounds, clampLat, clusterLocations, clusterTier, colorVarOf, contrastVarOf, countByCategory, countryCodes, countryPreset, createGoogleEngine, createLeafletEngine, dominantCategory, emptyWeek, foregroundVarOf, formatDistance, formatLatLng, formatTime, groupWeek, haversine, isAlwaysOpen, isCluster, isFittableBounds, isOpenAt, isSplittable, isoWeekday, loadGoogleMapsApi, metersPerPixel, nextChange, normalizeLng, padBounds, parseTime, project, renderClusterHtml, renderMarkerHtml, renderUserMarkerHtml, resolveCountryView, unproject, weekdayName, worldSize, zoomForBounds } from '@konce-pt/map';
6
6
  import { Observable } from 'rxjs';
7
7
  import * as _angular_forms_signals from '@angular/forms/signals';
8
8
  import { FormValueControl } from '@angular/forms/signals';
9
9
 
10
- /** Kontekst szablonu popupu — `$implicit` to lokalizacja. */
10
+ /** Kontekst szablonu popupu - `$implicit` to lokalizacja. */
11
11
  interface KptMapPopupContext<T = unknown> {
12
12
  $implicit: KptMapLocation<T>;
13
13
  /** Skrót do `location.data`, żeby nie pisać `loc.data.x` w każdym wierszu. */
@@ -15,7 +15,7 @@ interface KptMapPopupContext<T = unknown> {
15
15
  category: KptMapCategory | undefined;
16
16
  /**
17
17
  * Odległość punktu w metrach od `[distanceFrom]`, a bez niego od pozycji użytkownika.
18
- * `null`, gdy nie ma punktu odniesienia — geolokalizacja jest wyłączona albo odmówiona.
18
+ * `null`, gdy nie ma punktu odniesienia - geolokalizacja jest wyłączona albo odmówiona.
19
19
  */
20
20
  distance: number | null;
21
21
  close: () => void;
@@ -26,7 +26,7 @@ interface KptMapPopupContext<T = unknown> {
26
26
  *
27
27
  * Typ `data` domyślnie jest luźny (jak `let-row` w tabeli CDK), bo Angular nie potrafi
28
28
  * przenieść generyka z `kpt-map` na dyrektywę osadzoną w jego treści. Kto chce pełnego
29
- * wnioskowania, wiąże `[kptMapPopupTypeFor]` z tą samą tablicą, którą karmi mapę —
29
+ * wnioskowania, wiąże `[kptMapPopupTypeFor]` z tą samą tablicą, którą karmi mapę -
30
30
  * wtedy `data` dostaje konkretny typ.
31
31
  *
32
32
  * @example
@@ -45,7 +45,7 @@ declare class KptMapPopupTemplate<T = any> {
45
45
  /** Kategoria, do której szablon się stosuje; pusta wartość = szablon zapasowy. */
46
46
  readonly category: _angular_core.InputSignal<string>;
47
47
  /**
48
- * Nośnik typu — w runtime nieużywany. Jedyne zadanie: pozwolić Angularowi wywnioskować
48
+ * Nośnik typu - w runtime nieużywany. Jedyne zadanie: pozwolić Angularowi wywnioskować
49
49
  * `T` z tablicy lokalizacji, tak jak `ngFor` wnioskuje typ elementu z bindowanej kolekcji.
50
50
  */
51
51
  readonly typeFor: _angular_core.InputSignal<readonly KptMapLocation<T>[] | undefined>;
@@ -70,7 +70,7 @@ interface KptMapCreateFormApi {
70
70
  submit: (value: Record<string, unknown>) => void;
71
71
  }
72
72
  /**
73
- * Własny formularz „dodaj lokalizację". Jego obecność wyłącza formularz budowany
73
+ * Własny formularz "dodaj lokalizację". Jego obecność wyłącza formularz budowany
74
74
  * ze schemy kategorii.
75
75
  *
76
76
  * @example
@@ -86,20 +86,20 @@ declare class KptMapCreateFormTemplate {
86
86
  }
87
87
 
88
88
  /**
89
- * Geokodowanie wsteczne: współrzędne → adres. Port, a nie sztywne wywołanie usługi —
89
+ * Geokodowanie wsteczne: współrzędne -> adres. Port, a nie sztywne wywołanie usługi -
90
90
  * biblioteka nie może po cichu odpytywać cudzego serwera, a aplikacje mają własnych dostawców.
91
91
  *
92
- * Nie jest rejestrowany domyślnie. Bez niego formularz „dodaj lokalizację" po prostu
92
+ * Nie jest rejestrowany domyślnie. Bez niego formularz "dodaj lokalizację" po prostu
93
93
  * nie podpowiada adresu.
94
94
  */
95
95
  interface KptMapSearchOptions {
96
96
  /** Język odpowiedzi. Domyślnie to, co ustawi dostawca. */
97
97
  language?: string;
98
98
  signal?: AbortSignal;
99
- /** Ile wyników najwyżej. Domyślnie 5 — to lista podpowiedzi, nie wyszukiwarka pełnotekstowa. */
99
+ /** Ile wyników najwyżej. Domyślnie 5 - to lista podpowiedzi, nie wyszukiwarka pełnotekstowa. */
100
100
  limit?: number;
101
101
  /**
102
- * Preferuj wyniki z tego prostokąta. **Nie odcina** reszty świata — adres z zagranicy
102
+ * Preferuj wyniki z tego prostokąta. **Nie odcina** reszty świata - adres z zagranicy
103
103
  * dalej da się znaleźć, tylko wypada niżej na liście.
104
104
  */
105
105
  viewbox?: KptMapBounds;
@@ -113,22 +113,22 @@ interface KptMapGeocoderPort {
113
113
  signal?: AbortSignal;
114
114
  }): Observable<KptMapAddress | null>;
115
115
  /**
116
- * Geokodowanie wprost: tekst → miejsca. Metoda jest **opcjonalna**, żeby porty napisane
117
- * przed jej powstaniem dalej się kompilowały — bez niej `kpt-map` po prostu nie pokazuje
116
+ * Geokodowanie wprost: tekst -> miejsca. Metoda jest **opcjonalna**, żeby porty napisane
117
+ * przed jej powstaniem dalej się kompilowały - bez niej `kpt-map` po prostu nie pokazuje
118
118
  * wyszukiwarki. Strumień powinien dać jedną wartość i zakończyć się.
119
119
  *
120
- * Zwracać `KptMapSearchResult[]` (ze współrzędnymi) wolno i jest to najprostsza droga —
120
+ * Zwracać `KptMapSearchResult[]` (ze współrzędnymi) wolno i jest to najprostsza droga -
121
121
  * `KptMapSuggestion` jest tylko szerszy o brak `at`. Jeśli Twój dostawca współrzędnych
122
122
  * na liście nie podaje, **musisz** dopisać `resolve()`.
123
123
  */
124
124
  search?(query: string, options?: KptMapSearchOptions): Observable<readonly KptMapSuggestion[]>;
125
125
  /**
126
- * Uzupełnia podpowiedź o współrzędne. Wołane **raz, po wybraniu pozycji z listy** —
126
+ * Uzupełnia podpowiedź o współrzędne. Wołane **raz, po wybraniu pozycji z listy** -
127
127
  * nigdy w trakcie pisania.
128
128
  *
129
129
  * Wymagane wyłącznie od dostawców, których `search()` nie zwraca `at` (Google Places:
130
130
  * Autocomplete daje `placeId`, Place Details dokłada `lat`/`lng`). Kto zwraca współrzędne
131
- * od razu, tej metody nie potrzebuje — pole wyszukiwania nawet jej nie zawoła.
131
+ * od razu, tej metody nie potrzebuje - pole wyszukiwania nawet jej nie zawoła.
132
132
  *
133
133
  * `null` = nie udało się ustalić miejsca. Strumień powinien dać jedną wartość i zakończyć się.
134
134
  */
@@ -140,7 +140,7 @@ interface KptMapGeocoderPort {
140
140
  declare const KPT_MAP_GEOCODER: InjectionToken<KptMapGeocoderPort>;
141
141
  interface KptNominatimOptions {
142
142
  /**
143
- * Adres instancji Nominatim. Domyślnie publiczna instancja OSM — patrz ostrzeżenie
143
+ * Adres instancji Nominatim. Domyślnie publiczna instancja OSM - patrz ostrzeżenie
144
144
  * przy `provideKptNominatimGeocoder`.
145
145
  */
146
146
  baseUrl?: string;
@@ -148,18 +148,18 @@ interface KptNominatimOptions {
148
148
  language?: string;
149
149
  /**
150
150
  * Szczegółowość: 18 to poziom budynku, 16 ulicy, 10 miasta.
151
- * Domyślnie 18 — potrzebujemy numeru domu.
151
+ * Domyślnie 18 - potrzebujemy numeru domu.
152
152
  */
153
153
  zoom?: number;
154
154
  /**
155
155
  * Najmniejszy odstęp między zapytaniami w milisekundach.
156
156
  *
157
157
  * Sekunda nie jest cechą Nominatima, tylko wymogiem regulaminu **publicznej instancji
158
- * OSM** — dlatego domyślna zależy od `baseUrl`: bez niego 1000 ms, z własnym adresem 0.
158
+ * OSM** - dlatego domyślna zależy od `baseUrl`: bez niego 1000 ms, z własnym adresem 0.
159
159
  * Na swoim serwerze nie ma czego respektować, a przy podpowiadaniu w trakcie pisania
160
- * sekundowa zwłoka jest różnicą między „działa" a „zacina się".
160
+ * sekundowa zwłoka jest różnicą między "działa" a "zacina się".
161
161
  *
162
- * `0` zdejmuje też kolejkowanie — zapytania lecą równolegle. Podstawiając cudzą,
162
+ * `0` zdejmuje też kolejkowanie - zapytania lecą równolegle. Podstawiając cudzą,
163
163
  * współdzieloną instancję ustaw wartość jawnie.
164
164
  */
165
165
  minIntervalMs?: number;
@@ -170,7 +170,7 @@ interface KptNominatimOptions {
170
170
  */
171
171
  declare class KptNominatimGeocoder implements KptMapGeocoderPort {
172
172
  private readonly options;
173
- /** Ogon kolejki — każde kolejne zapytanie czeka na swoją kolej. */
173
+ /** Ogon kolejki - każde kolejne zapytanie czeka na swoją kolej. */
174
174
  private next;
175
175
  /** Kiedy wystrzeliło poprzednie zapytanie. `0` = jeszcze żadne. */
176
176
  private lastAt;
@@ -184,9 +184,9 @@ declare class KptNominatimGeocoder implements KptMapGeocoderPort {
184
184
  * Rezerwuje miejsce w kolejce: czeka na poprzednie zapytanie, a potem tylko tyle,
185
185
  * ile brakuje do pełnego odstępu od jego wystrzału.
186
186
  *
187
- * Odstęp liczony od zegara, a nie stałym `delay()` przed każdym zapytaniem —
187
+ * Odstęp liczony od zegara, a nie stałym `delay()` przed każdym zapytaniem -
188
188
  * inaczej pierwsza podpowiedź po minucie bezczynności też płaciłaby sekundę, a przy
189
- * podpowiadaniu w trakcie pisania to jest różnica między „działa" a „zacina się".
189
+ * podpowiadaniu w trakcie pisania to jest różnica między "działa" a "zacina się".
190
190
  * Górna granica jednego zapytania na sekundę zostaje nienaruszona.
191
191
  *
192
192
  * Bez odstępu nie ma czego kolejkować: łańcuch obietnic zostaje nietknięty, żeby
@@ -198,7 +198,7 @@ declare class KptNominatimGeocoder implements KptMapGeocoderPort {
198
198
  signal?: AbortSignal;
199
199
  }): Observable<KptMapAddress | null>;
200
200
  /**
201
- * Podpowiedzi adresowe. Wchodzi w **tę samą** kolejkę co `reverse()` — polityka Nominatim
201
+ * Podpowiedzi adresowe. Wchodzi w **tę samą** kolejkę co `reverse()` - polityka Nominatim
202
202
  * liczy jedno zapytanie na sekundę na całego klienta, a nie na metodę.
203
203
  */
204
204
  search(query: string, options?: KptMapSearchOptions): Observable<readonly KptMapSearchResult[]>;
@@ -206,7 +206,7 @@ declare class KptNominatimGeocoder implements KptMapGeocoderPort {
206
206
  private fetchAddress;
207
207
  }
208
208
  /**
209
- * Włącza podpowiadanie adresu z Nominatim (OpenStreetMap) w formularzu „dodaj lokalizację".
209
+ * Włącza podpowiadanie adresu z Nominatim (OpenStreetMap) w formularzu "dodaj lokalizację".
210
210
  *
211
211
  * **Polityka użycia.** Publiczna instancja `nominatim.openstreetmap.org` dopuszcza
212
212
  * maksymalnie jedno zapytanie na sekundę, wymaga rozpoznawalnego `Referer`/`User-Agent`
@@ -215,7 +215,7 @@ declare class KptNominatimGeocoder implements KptMapGeocoderPort {
215
215
  * podstaw własną instancję (`baseUrl`) albo komercyjnego dostawcę przez własny
216
216
  * `KPT_MAP_GEOCODER`.
217
217
  *
218
- * Podanie `baseUrl` **zdejmuje sekundowy odstęp** (`minIntervalMs` domyślnie 0) — regulamin
218
+ * Podanie `baseUrl` **zdejmuje sekundowy odstęp** (`minIntervalMs` domyślnie 0) - regulamin
219
219
  * publicznej instancji nie obowiązuje na Twoim serwerze. Cudzą, współdzieloną instancję
220
220
  * podstawiaj z jawnym `minIntervalMs`.
221
221
  *
@@ -237,10 +237,10 @@ interface KptMapGeocoderStubOptions {
237
237
  deferCoordinates?: boolean;
238
238
  }
239
239
  /**
240
- * Stały adres i stała lista podpowiedzi — Storybook i testy, bez ruchu sieciowego.
240
+ * Stały adres i stała lista podpowiedzi - Storybook i testy, bez ruchu sieciowego.
241
241
  *
242
- * Podpowiedzi filtruje po `label` bez znaków diakrytycznych, żeby „warszawa" trafiało
243
- * w „Warszawa". Prawdziwy geokoder dopasowuje po swojemu — atrapa tylko udaje, że umie.
242
+ * Podpowiedzi filtruje po `label` bez znaków diakrytycznych, żeby "warszawa" trafiało
243
+ * w "Warszawa". Prawdziwy geokoder dopasowuje po swojemu - atrapa tylko udaje, że umie.
244
244
  */
245
245
  declare class KptMapGeocoderStub implements KptMapGeocoderPort {
246
246
  private readonly address;
@@ -255,7 +255,7 @@ declare function provideKptMapGeocoderStub(address: KptMapAddress | null, result
255
255
 
256
256
  interface PopupState<T> {
257
257
  location: KptMapLocation<T>;
258
- /** Grupa, z której popup został otwarty — lista nierozdzielalnych punktów. */
258
+ /** Grupa, z której popup został otwarty - lista nierozdzielalnych punktów. */
259
259
  group: KptMapCluster<T> | null;
260
260
  }
261
261
  /**
@@ -277,7 +277,7 @@ interface PopupState<T> {
277
277
  declare class KptMap<T = unknown> {
278
278
  readonly locations: _angular_core.InputSignal<readonly KptMapLocation<T>[]>;
279
279
  readonly categories: _angular_core.InputSignal<readonly KptMapCategory[]>;
280
- /** Kod kraju z presetów (`PL`, `DE`, `EU`…). Nieznany kod cofa się do Polski. */
280
+ /** Kod kraju z presetów (`PL`, `DE`, `EU`...). Nieznany kod cofa się do Polski. */
281
281
  readonly country: _angular_core.InputSignal<string>;
282
282
  /** Jawny widok startowy; nadpisuje `country`. */
283
283
  readonly view: _angular_core.InputSignal<KptMapView | null>;
@@ -291,18 +291,18 @@ declare class KptMap<T = unknown> {
291
291
  readonly clusterColorBy: _angular_core.InputSignal<"none" | "dominant">;
292
292
  /** Renderuje legendę pod mapą. Wyłącz, jeśli chcesz ją umieścić gdzie indziej. */
293
293
  readonly legend: _angular_core.InputSignalWithTransform<boolean, unknown>;
294
- /** Identyfikatory ukrytych kategorii (dwukierunkowe) — legenda je przełącza. */
294
+ /** Identyfikatory ukrytych kategorii (dwukierunkowe) - legenda je przełącza. */
295
295
  readonly hiddenCategories: _angular_core.ModelSignal<string[]>;
296
296
  /** Pokazuje liczniki przy pozycjach legendy. */
297
297
  readonly legendCounts: _angular_core.InputSignalWithTransform<boolean, unknown>;
298
298
  readonly showUserLocation: _angular_core.InputSignalWithTransform<boolean, unknown>;
299
299
  /** Przy każdej nowej pozycji centruje mapę na użytkowniku. */
300
300
  readonly followUser: _angular_core.InputSignalWithTransform<boolean, unknown>;
301
- /** Włącza menu „Dodaj lokalizację" pod prawym przyciskiem myszy. */
301
+ /** Włącza menu "Dodaj lokalizację" pod prawym przyciskiem myszy. */
302
302
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
303
303
  /**
304
304
  * Pokazuje wyszukiwarkę adresów w rogu mapy. Wymaga portu `KPT_MAP_GEOCODER`
305
- * **z metodą `search()`** — bez niego pole się nie renderuje, bo biblioteka nie
305
+ * **z metodą `search()`** - bez niego pole się nie renderuje, bo biblioteka nie
306
306
  * odpytuje cudzego serwera bez zgody aplikacji.
307
307
  */
308
308
  readonly search: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -318,11 +318,17 @@ declare class KptMap<T = unknown> {
318
318
  }>;
319
319
  /**
320
320
  * Zoom, na jaki mapa wchodzi po wybraniu wyniku bez własnego zasięgu (pojedynczy adres).
321
- * Wynik z zasięgiem — miasto, region — dostaje `fitBounds` zamiast tego.
321
+ * Wynik z zasięgiem - miasto, region - dostaje `fitBounds` zamiast tego.
322
322
  */
323
323
  readonly searchZoom: _angular_core.InputSignalWithTransform<number, unknown>;
324
324
  /** Zostawia tymczasową pinezkę w znalezionym punkcie. */
325
325
  readonly searchMarker: _angular_core.InputSignalWithTransform<boolean, unknown>;
326
+ /** Mikrofon w wyszukiwarce - adres podyktowany zamiast wpisanego (patrz `kpt-map-search`). */
327
+ readonly searchSpeech: _angular_core.InputSignalWithTransform<boolean, unknown>;
328
+ /** Język dyktowania adresu (BCP 47); bez niego z języka interfejsu. */
329
+ readonly searchSpeechLang: _angular_core.InputSignal<string | null>;
330
+ /** Kolor "stop" i fali w trakcie nasłuchu; domyślnie kolor motywu. */
331
+ readonly searchSpeechColor: _angular_core.InputSignal<KptSpeechColor>;
326
332
  /**
327
333
  * Wygląd popupu. `plain` to wąska ramka na treść tekstową (domyślna),
328
334
  * `card` oddaje całą szerokość i wysokość karcie miejsca: bez paddingu,
@@ -331,37 +337,37 @@ declare class KptMap<T = unknown> {
331
337
  readonly popupLayout: _angular_core.InputSignal<"plain" | "card">;
332
338
  /**
333
339
  * Punkt odniesienia dystansu podawanego szablonowi popupu jako `distance`.
334
- * `null` znaczy „pozycja użytkownika z `KPT_MAP_GEOLOCATION`", więc domyślnie
340
+ * `null` znaczy "pozycja użytkownika z `KPT_MAP_GEOLOCATION`", więc domyślnie
335
341
  * jest to odległość od miejsca, w którym stoi patrzący. Aplikacja może podstawić
336
- * inny punkt — wyszukany adres, siedzibę firmy, stałą pozycję w demie.
342
+ * inny punkt - wyszukany adres, siedzibę firmy, stałą pozycję w demie.
337
343
  */
338
344
  readonly distanceFrom: _angular_core.InputSignal<KptLatLng | null>;
339
345
  readonly height: _angular_core.InputSignal<string>;
340
- /** Bez znaczenia dla silnika Google — kafle i atrybucję dostarcza tam Google. */
346
+ /** Bez znaczenia dla silnika Google - kafle i atrybucję dostarcza tam Google. */
341
347
  readonly tileUrl: _angular_core.InputSignal<string | null>;
342
348
  readonly attribution: _angular_core.InputSignal<string | null>;
343
349
  /**
344
350
  * Silnik **tej** mapy. Podany wygrywa nad `KPT_MAP_ENGINE` z DI, więc dwie mapy o różnych
345
351
  * silnikach mieszczą się na jednej stronie bez komponentów-opakowań. Bez niego wszystko
346
- * działa jak dotąd — silnik przychodzi z DI.
352
+ * działa jak dotąd - silnik przychodzi z DI.
347
353
  *
348
354
  * Fabryka, a nie gotowa instancja: każda mapa potrzebuje własnego obiektu. Czytany raz,
349
- * przy inicjalizacji — podmiana po starcie nie przeładowuje mapy.
355
+ * przy inicjalizacji - podmiana po starcie nie przeładowuje mapy.
350
356
  *
351
357
  * @example
352
358
  * readonly google: KptMapEngineFactory = () => createGoogleEngine({ apiKey, mapId });
353
359
  */
354
360
  readonly engine: _angular_core.InputSignal<KptMapEngineFactory | null>;
355
361
  /**
356
- * Geokoder **tej** mapy. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI — tak samo jak
362
+ * Geokoder **tej** mapy. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI - tak samo jak
357
363
  * `[engine]` nad `KPT_MAP_ENGINE` i z tego samego powodu: Service Specific Terms wiążą
358
364
  * geokoder Google z **mapą** Google, a nie z aplikacją. Na stronie z dwoma silnikami
359
365
  * globalny provider nie umiałby tej reguły dotrzymać; wejście umie.
360
366
  *
361
- * Trafia i do wyszukiwarki, i do formularza „dodaj lokalizację" — jeden port na oba kierunki.
367
+ * Trafia i do wyszukiwarki, i do formularza "dodaj lokalizację" - jeden port na oba kierunki.
362
368
  *
363
369
  * @example
364
- * <kpt-map [engine]="google" [geocoder]="googleGeocoder" … />
370
+ * <kpt-map [engine]="google" [geocoder]="googleGeocoder" ... />
365
371
  */
366
372
  readonly geocoder: _angular_core.InputSignal<KptMapGeocoderPort | null>;
367
373
  readonly locationClick: _angular_core.OutputEmitterRef<KptMapLocation<T>>;
@@ -377,7 +383,7 @@ declare class KptMap<T = unknown> {
377
383
  readonly userPositionChange: _angular_core.OutputEmitterRef<KptMapUserPosition | null>;
378
384
  readonly userLocationError: _angular_core.OutputEmitterRef<KptMapGeolocationError>;
379
385
  /**
380
- * Silnika nie udało się uruchomić — brak fabryki, brak paczki `leaflet`, odrzucony klucz Google.
386
+ * Silnika nie udało się uruchomić - brak fabryki, brak paczki `leaflet`, odrzucony klucz Google.
381
387
  * Bez słuchacza błąd ląduje w konsoli; ze słuchaczem aplikacja może pokazać własny komunikat.
382
388
  */
383
389
  readonly engineError: _angular_core.OutputEmitterRef<unknown>;
@@ -386,7 +392,7 @@ declare class KptMap<T = unknown> {
386
392
  /** Opcjonalny, bo silnik może przyjść wejściem `[engine]` zamiast z DI. */
387
393
  private readonly engineFactory;
388
394
  private readonly geolocation;
389
- /** Opcjonalny — wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
395
+ /** Opcjonalny - wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
390
396
  private readonly injectedGeocoder;
391
397
  private readonly destroyRef;
392
398
  private readonly injector;
@@ -397,7 +403,7 @@ declare class KptMap<T = unknown> {
397
403
  private readonly popupTemplates;
398
404
  protected readonly createFormTemplate: _angular_core.Signal<KptMapCreateFormTemplate | undefined>;
399
405
  private mapEngine;
400
- /** Komponent zniszczony — `initEngine()` po `await` nie może już podpinać zdarzeń ani obserwatorów. */
406
+ /** Komponent zniszczony - `initEngine()` po `await` nie może już podpinać zdarzeń ani obserwatorów. */
401
407
  private destroyed;
402
408
  /** Trwający montaż silnika; zniszczenie czeka na jego koniec (patrz konstruktor). */
403
409
  private engineInit;
@@ -405,7 +411,7 @@ declare class KptMap<T = unknown> {
405
411
  protected readonly ready: _angular_core.WritableSignal<boolean>;
406
412
  /** Zoom trzymamy w sygnale, bo od niego zależy wynik grupowania. */
407
413
  private readonly zoom;
408
- /** Rośnie przy każdym ruchu mapy — wymusza przeliczenie pozycji popupu. */
414
+ /** Rośnie przy każdym ruchu mapy - wymusza przeliczenie pozycji popupu. */
409
415
  private readonly viewportTick;
410
416
  protected readonly popup: _angular_core.WritableSignal<PopupState<T> | null>;
411
417
  protected readonly contextTarget: _angular_core.WritableSignal<{
@@ -418,47 +424,47 @@ declare class KptMap<T = unknown> {
418
424
  } | null>;
419
425
  protected readonly createOpen: _angular_core.WritableSignal<boolean>;
420
426
  protected readonly userPosition: _angular_core.WritableSignal<KptMapUserPosition | null>;
421
- /** Ostatni wybrany wynik wyszukiwania — źródło tymczasowej pinezki. */
427
+ /** Ostatni wybrany wynik wyszukiwania - źródło tymczasowej pinezki. */
422
428
  protected readonly searchPin: _angular_core.WritableSignal<KptMapSearchResult | null>;
423
429
  protected readonly locationBlocked: _angular_core.WritableSignal<boolean>;
424
430
  private readonly categoryById;
425
431
  /** Lokalizacje po odfiltrowaniu kategorii ukrytych w legendzie. */
426
432
  private readonly visibleLocations;
427
433
  protected readonly counts: _angular_core.Signal<Record<string, number> | null>;
428
- /** Wynik grupowania dla aktualnego zoomu — grupy i punkty pojedyncze. */
434
+ /** Wynik grupowania dla aktualnego zoomu - grupy i punkty pojedyncze. */
429
435
  private readonly entries;
430
436
  /** Znaczniki gotowe dla silnika. HTML powstaje w rdzeniu, poza Angularem. */
431
437
  private readonly markers;
432
- /** Szablon popupu dla kategorii; bez dopasowania — szablon zapasowy (bez `category`). */
438
+ /** Szablon popupu dla kategorii; bez dopasowania - szablon zapasowy (bez `category`). */
433
439
  private readonly popupTemplateFor;
434
440
  protected readonly popupTemplate: _angular_core.Signal<KptMapPopupTemplate<T> | null>;
435
441
  protected readonly popupCategory: _angular_core.Signal<KptMapCategory | undefined>;
436
442
  /**
437
443
  * Odległość otwartego punktu od `distanceFrom` (albo od użytkownika) w metrach.
438
- * `null`, gdy nie ma od czego liczyć — szablon chowa wtedy wiersz dystansu,
444
+ * `null`, gdy nie ma od czego liczyć - szablon chowa wtedy wiersz dystansu,
439
445
  * zamiast pokazywać zero.
440
446
  */
441
447
  protected readonly popupDistance: _angular_core.Signal<number | null>;
442
448
  /**
443
449
  * Pozycja popupu w pikselach kontenera. Zależy od `viewportTick`, więc przelicza się
444
- * przy każdym ruchu mapy — jeden sygnał zamiast nasłuchu w szablonie.
450
+ * przy każdym ruchu mapy - jeden sygnał zamiast nasłuchu w szablonie.
445
451
  */
446
452
  protected readonly popupPosition: _angular_core.Signal<KptMapPoint | null>;
447
453
  protected readonly contextPosition: _angular_core.Signal<KptMapPoint | null>;
448
- /** Kategorie oferowane w menu „dodaj" — ukryte w legendzie odpadają. */
454
+ /** Kategorie oferowane w menu "dodaj" - ukryte w legendzie odpadają. */
449
455
  protected readonly creatableCategories: _angular_core.Signal<KptMapCategory[]>;
450
- /** Czy jest czym szukać — port bez `search()` nie zasługuje na pole, które nic nie robi. */
456
+ /** Czy jest czym szukać - port bez `search()` nie zasługuje na pole, które nic nie robi. */
451
457
  protected readonly searchEnabled: _angular_core.Signal<boolean>;
452
458
  /**
453
- * Prostokąt preferowanych wyników. Bierzemy zasięg jawny, a bez niego preset kraju —
454
- * „Kwiatowa" ma trafiać w tę pod nosem, nie w tę z drugiego końca świata. To sam bias:
459
+ * Prostokąt preferowanych wyników. Bierzemy zasięg jawny, a bez niego preset kraju -
460
+ * "Kwiatowa" ma trafiać w tę pod nosem, nie w tę z drugiego końca świata. To sam bias:
455
461
  * adresu z zagranicy dalej da się poszukać.
456
462
  */
457
463
  protected readonly searchViewbox: _angular_core.Signal<KptMapBounds>;
458
464
  /**
459
465
  * Twarde zawężenie do krajów. Jawne `searchOptions.countryCodes` wygrywa; bez niego
460
466
  * odcinamy zagranicę dopiero przy `restrictToCountry`, bo tam mapa i tak nie pozwoli
461
- * przesunąć widoku poza kraj — znaleziony adres byłby nie do pokazania.
467
+ * przesunąć widoku poza kraj - znaleziony adres byłby nie do pokazania.
462
468
  */
463
469
  protected readonly searchCountryCodes: _angular_core.Signal<readonly string[] | null>;
464
470
  protected readonly createFormApi: _angular_core.Signal<KptMapCreateFormApi | null>;
@@ -486,28 +492,28 @@ declare class KptMap<T = unknown> {
486
492
  * Bez tego znacznik przy górnej krawędzi otwiera popup poza widokiem.
487
493
  */
488
494
  private autoPanToPopup;
489
- /** Gotowa referencja dla kontekstu szablonu — szablon nie ma jak zrobić `bind`. */
495
+ /** Gotowa referencja dla kontekstu szablonu - szablon nie ma jak zrobić `bind`. */
490
496
  protected readonly closePopupFn: () => void;
491
- /** Pozycja z grupy nierozdzielalnej — przełącza popup bez ruszania mapy. */
497
+ /** Pozycja z grupy nierozdzielalnej - przełącza popup bez ruszania mapy. */
492
498
  protected selectFromGroup(location: KptMapLocation<T>): void;
493
499
  protected startCreate(category: KptMapCategory): void;
494
500
  protected closeCreate(): void;
495
501
  protected emitCreate(value: Record<string, unknown>): void;
496
502
  /**
497
503
  * Przenosi widok na wybrany wynik. Zasięg (miasto, region) wpasowujemy w kadr,
498
- * a pojedynczy punkt dostaje `[searchZoom]` — inaczej każdy adres lądowałby
504
+ * a pojedynczy punkt dostaje `[searchZoom]` - inaczej każdy adres lądowałby
499
505
  * w innym przybliżeniu, zależnym od tego, jak dostawca obrysował budynek.
500
506
  */
501
507
  protected onSearchSelect(result: KptMapSearchResult): void;
502
508
  protected zoomBy(delta: number): void;
503
509
  protected centreOnUser(): void;
504
- /** Wraca do widoku startowego — po zabłądzeniu na drugim końcu świata. */
510
+ /** Wraca do widoku startowego - po zabłądzeniu na drugim końcu świata. */
505
511
  protected resetView(): void;
506
- /** Zasięg wszystkich widocznych lokalizacji — `null`, gdy nie ma żadnej. */
512
+ /** Zasięg wszystkich widocznych lokalizacji - `null`, gdy nie ma żadnej. */
507
513
  protected readonly dataBounds: _angular_core.Signal<KptMapBounds | null>;
508
514
  protected fitToData(): void;
509
515
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMap<any>, never>;
510
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMap<any>, "kpt-map", never, { "locations": { "alias": "locations"; "required": true; "isSignal": true; }; "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "country": { "alias": "country"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "restrictToCountry": { "alias": "restrictToCountry"; "required": false; "isSignal": true; }; "bounds": { "alias": "bounds"; "required": false; "isSignal": true; }; "cluster": { "alias": "cluster"; "required": false; "isSignal": true; }; "clusterOptions": { "alias": "clusterOptions"; "required": false; "isSignal": true; }; "clusterColorBy": { "alias": "clusterColorBy"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "hiddenCategories": { "alias": "hiddenCategories"; "required": false; "isSignal": true; }; "legendCounts": { "alias": "legendCounts"; "required": false; "isSignal": true; }; "showUserLocation": { "alias": "showUserLocation"; "required": false; "isSignal": true; }; "followUser": { "alias": "followUser"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchOptions": { "alias": "searchOptions"; "required": false; "isSignal": true; }; "searchZoom": { "alias": "searchZoom"; "required": false; "isSignal": true; }; "searchMarker": { "alias": "searchMarker"; "required": false; "isSignal": true; }; "popupLayout": { "alias": "popupLayout"; "required": false; "isSignal": true; }; "distanceFrom": { "alias": "distanceFrom"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "tileUrl": { "alias": "tileUrl"; "required": false; "isSignal": true; }; "attribution": { "alias": "attribution"; "required": false; "isSignal": true; }; "engine": { "alias": "engine"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "hiddenCategories": "hiddenCategoriesChange"; "locationClick": "locationClick"; "clusterClick": "clusterClick"; "locationCreate": "locationCreate"; "searchSelect": "searchSelect"; "viewChange": "viewChange"; "userPositionChange": "userPositionChange"; "userLocationError": "userLocationError"; "engineError": "engineError"; }, ["popupTemplates", "createFormTemplate"], never, true, never>;
516
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMap<any>, "kpt-map", never, { "locations": { "alias": "locations"; "required": true; "isSignal": true; }; "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "country": { "alias": "country"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "restrictToCountry": { "alias": "restrictToCountry"; "required": false; "isSignal": true; }; "bounds": { "alias": "bounds"; "required": false; "isSignal": true; }; "cluster": { "alias": "cluster"; "required": false; "isSignal": true; }; "clusterOptions": { "alias": "clusterOptions"; "required": false; "isSignal": true; }; "clusterColorBy": { "alias": "clusterColorBy"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "hiddenCategories": { "alias": "hiddenCategories"; "required": false; "isSignal": true; }; "legendCounts": { "alias": "legendCounts"; "required": false; "isSignal": true; }; "showUserLocation": { "alias": "showUserLocation"; "required": false; "isSignal": true; }; "followUser": { "alias": "followUser"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchOptions": { "alias": "searchOptions"; "required": false; "isSignal": true; }; "searchZoom": { "alias": "searchZoom"; "required": false; "isSignal": true; }; "searchMarker": { "alias": "searchMarker"; "required": false; "isSignal": true; }; "searchSpeech": { "alias": "searchSpeech"; "required": false; "isSignal": true; }; "searchSpeechLang": { "alias": "searchSpeechLang"; "required": false; "isSignal": true; }; "searchSpeechColor": { "alias": "searchSpeechColor"; "required": false; "isSignal": true; }; "popupLayout": { "alias": "popupLayout"; "required": false; "isSignal": true; }; "distanceFrom": { "alias": "distanceFrom"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "tileUrl": { "alias": "tileUrl"; "required": false; "isSignal": true; }; "attribution": { "alias": "attribution"; "required": false; "isSignal": true; }; "engine": { "alias": "engine"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "hiddenCategories": "hiddenCategoriesChange"; "locationClick": "locationClick"; "clusterClick": "clusterClick"; "locationCreate": "locationCreate"; "searchSelect": "searchSelect"; "viewChange": "viewChange"; "userPositionChange": "userPositionChange"; "userLocationError": "userLocationError"; "engineError": "engineError"; }, ["popupTemplates", "createFormTemplate"], never, true, never>;
511
517
  }
512
518
 
513
519
  interface LegendEntry {
@@ -519,7 +525,7 @@ interface LegendEntry {
519
525
  count: number | null;
520
526
  }
521
527
  /**
522
- * Legenda mapy — lista kategorii ze znacznikiem koloru i ikoną. Pozycje są przyciskami:
528
+ * Legenda mapy - lista kategorii ze znacznikiem koloru i ikoną. Pozycje są przyciskami:
523
529
  * kliknięcie chowa i pokazuje kategorię (`hidden` dwukierunkowe).
524
530
  *
525
531
  * `kpt-map` renderuje ją sam pod mapą przy `[legend]="true"`; kto chce ją gdzie indziej,
@@ -532,10 +538,10 @@ declare class KptMapLegend {
532
538
  readonly categories: _angular_core.InputSignal<readonly KptMapCategory[]>;
533
539
  /** Identyfikatory ukrytych kategorii (dwukierunkowe). */
534
540
  readonly hidden: _angular_core.ModelSignal<string[]>;
535
- /** Opcjonalne liczniki `{ categoryId: liczba }` — pokazywane przy etykiecie. */
541
+ /** Opcjonalne liczniki `{ categoryId: liczba }` - pokazywane przy etykiecie. */
536
542
  readonly counts: _angular_core.InputSignal<Record<string, number> | null>;
537
543
  readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
538
- /** Wyłącza chowanie kategorii — legenda staje się czysto informacyjna. */
544
+ /** Wyłącza chowanie kategorii - legenda staje się czysto informacyjna. */
539
545
  readonly interactive: _angular_core.InputSignal<boolean>;
540
546
  protected readonly i18n: KptI18n;
541
547
  protected readonly entries: _angular_core.Signal<LegendEntry[]>;
@@ -547,9 +553,9 @@ declare class KptMapLegend {
547
553
 
548
554
  /**
549
555
  * Wyszukiwarka adresów: pole z podpowiedziami z geokodera. Wynik wyboru leci w `selected`,
550
- * a co z nim zrobić — decyduje rodzic (`kpt-map` przenosi na niego widok).
556
+ * a co z nim zrobić - decyduje rodzic (`kpt-map` przenosi na niego widok).
551
557
  *
552
- * Wymaga portu `KPT_MAP_GEOCODER` **z metodą `search()`** — biblioteka nie odpytuje cudzego
558
+ * Wymaga portu `KPT_MAP_GEOCODER` **z metodą `search()`** - biblioteka nie odpytuje cudzego
553
559
  * serwera bez zgody aplikacji. Bez portu pole renderuje się wyłączone, zamiast udawać, że
554
560
  * coś znajdzie; `kpt-map` idzie dalej i w ogóle go wtedy nie pokazuje.
555
561
  *
@@ -570,13 +576,23 @@ declare class KptMapSearch {
570
576
  readonly debounce: _angular_core.InputSignalWithTransform<number, unknown>;
571
577
  /** Ile podpowiedzi najwyżej. */
572
578
  readonly limit: _angular_core.InputSignalWithTransform<number, unknown>;
573
- /** Zawężenie twarde do krajów (ISO 3166-1 alpha-2) — wyniki spoza nich nie wrócą. */
579
+ /** Zawężenie twarde do krajów (ISO 3166-1 alpha-2) - wyniki spoza nich nie wrócą. */
574
580
  readonly countryCodes: _angular_core.InputSignal<readonly string[] | null>;
575
581
  /** Preferowany prostokąt wyników. Nie odcina reszty świata, tylko przesuwa ją niżej. */
576
582
  readonly viewbox: _angular_core.InputSignal<KptMapBounds | null>;
577
583
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
578
584
  /**
579
- * Geokoder tego pola. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI — `kpt-map` podaje tędy
585
+ * Mikrofon w polu (Web Speech API): kliknięcie czyści frazę, a jedna podyktowana wypowiedź
586
+ * staje się zapytaniem - z tym samym `debounce` i `minLength` co pisanie. Bez wsparcia
587
+ * przeglądarki się nie pokazuje.
588
+ */
589
+ readonly speech: _angular_core.InputSignalWithTransform<boolean, unknown>;
590
+ /** Język dyktowania (BCP 47); bez niego z języka interfejsu. */
591
+ readonly speechLang: _angular_core.InputSignal<string | null>;
592
+ /** Kolor "stop" i fali w trakcie nasłuchu; domyślnie kolor motywu. */
593
+ readonly speechColor: _angular_core.InputSignal<KptSpeechColor>;
594
+ /**
595
+ * Geokoder tego pola. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI - `kpt-map` podaje tędy
580
596
  * port swojej mapy, bo geokoder jest per mapa, a nie per aplikacja. Bez niego wszystko
581
597
  * działa jak dotąd: port przychodzi z DI.
582
598
  */
@@ -586,7 +602,7 @@ declare class KptMapSearch {
586
602
  * pole najpierw uzupełnia przez `resolve()` portu, a dopiero potem emituje.
587
603
  */
588
604
  readonly selected: _angular_core.OutputEmitterRef<KptMapSearchResult>;
589
- /** Pole wyczyszczone — rodzic sprząta po sobie (np. chowa tymczasową pinezkę). */
605
+ /** Pole wyczyszczone - rodzic sprząta po sobie (np. chowa tymczasową pinezkę). */
590
606
  readonly cleared: _angular_core.OutputEmitterRef<void>;
591
607
  protected readonly i18n: KptI18n;
592
608
  private readonly injectedGeocoder;
@@ -597,7 +613,7 @@ declare class KptMapSearch {
597
613
  protected readonly query: _angular_core.WritableSignal<string>;
598
614
  /**
599
615
  * Fraza do odpytania geokodera. Osobna od `query`, bo wybór podpowiedzi zmienia treść
600
- * pola — a to nie może wywołać kolejnego zapytania o coś, co już znaleźliśmy.
616
+ * pola - a to nie może wywołać kolejnego zapytania o coś, co już znaleźliśmy.
601
617
  */
602
618
  private readonly term;
603
619
  protected readonly results: _angular_core.WritableSignal<readonly KptMapSuggestion[]>;
@@ -607,23 +623,23 @@ declare class KptMapSearch {
607
623
  * `loading`, bo to inny moment: tam czekamy na listę, tu na jedno konkretne miejsce.
608
624
  */
609
625
  protected readonly resolving: _angular_core.WritableSignal<boolean>;
610
- /** Subskrypcja `resolve()` w locie — kolejny wybór i czyszczenie pola ją przerywają. */
626
+ /** Subskrypcja `resolve()` w locie - kolejny wybór i czyszczenie pola ją przerywają. */
611
627
  private pending;
612
- /** Czy jakieś zapytanie już wróciło — bez tego „brak wyników" mignąłby przed pierwszym. */
628
+ /** Czy jakieś zapytanie już wróciło - bez tego "brak wyników" mignąłby przed pierwszym. */
613
629
  protected readonly searched: _angular_core.WritableSignal<boolean>;
614
630
  protected readonly open: _angular_core.WritableSignal<boolean>;
615
631
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
616
- /** Fraza za krótka, ale niepusta — zamiast ciszy pokazujemy, ile znaków brakuje. */
632
+ /** Fraza za krótka, ale niepusta - zamiast ciszy pokazujemy, ile znaków brakuje. */
617
633
  protected readonly tooShort: _angular_core.Signal<boolean>;
618
634
  protected readonly hasPanel: _angular_core.Signal<boolean>;
619
- /** Cokolwiek leci do geokodera — lista albo pojedyncze miejsce. Jeden stan dla szablonu. */
635
+ /** Cokolwiek leci do geokodera - lista albo pojedyncze miejsce. Jeden stan dla szablonu. */
620
636
  protected readonly busy: _angular_core.Signal<boolean>;
621
- /** Panel pokazuje listę (a nie notę) — tylko wtedy `aria-controls` ma na co wskazać. */
637
+ /** Panel pokazuje listę (a nie notę) - tylko wtedy `aria-controls` ma na co wskazać. */
622
638
  protected readonly listShown: _angular_core.Signal<boolean>;
623
639
  protected readonly canSearch: _angular_core.Signal<boolean>;
624
- /** Nie udało się ustalić miejsca wybranej podpowiedzi — komunikat zamiast cichej ciszy. */
640
+ /** Nie udało się ustalić miejsca wybranej podpowiedzi - komunikat zamiast cichej ciszy. */
625
641
  private readonly unresolved;
626
- /** Komunikat dla `aria-live` — czytnik dostaje stan, którego wzrokowo nie da się przegapić. */
642
+ /** Komunikat dla `aria-live` - czytnik dostaje stan, którego wzrokowo nie da się przegapić. */
627
643
  protected readonly status: _angular_core.Signal<string>;
628
644
  protected readonly placeholderText: _angular_core.Signal<string>;
629
645
  constructor();
@@ -633,7 +649,7 @@ declare class KptMapSearch {
633
649
  * Debounce stoi na `setTimeout`, a nie na operatorach rxjs: porty tego pakietu używają
634
650
  * wyłącznie `Observable`/`of`, a rxjs nie jest zadeklarowany jako `peerDependency`
635
651
  * biblioteki (wchodzi tranzytywnie przez `@angular/core`). `onCleanup` kasuje zarówno
636
- * niewystrzelony timer, jak i zapytanie w locie — adapter Nominatim przerywa wtedy
652
+ * niewystrzelony timer, jak i zapytanie w locie - adapter Nominatim przerywa wtedy
637
653
  * `fetch` własnym `AbortController`.
638
654
  */
639
655
  private watchTerm;
@@ -643,33 +659,33 @@ declare class KptMapSearch {
643
659
  protected onFocus(): void;
644
660
  protected onBlur(): void;
645
661
  /**
646
- * Wybór podpowiedzi. Dostawca, który podał współrzędne na liście, emituje natychmiast —
662
+ * Wybór podpowiedzi. Dostawca, który podał współrzędne na liście, emituje natychmiast -
647
663
  * dla Nominatima i każdego geokodera pytanego wprost nic się nie zmienia.
648
664
  *
649
665
  * Podpowiedź bez `at` (Google Places Autocomplete) trzeba najpierw uzupełnić: jedno
650
666
  * wywołanie `resolve()` na *wybór*, nigdy w trakcie pisania. Panel zostaje otwarty
651
- * z komunikatem „Szukam…", żeby czekanie nie wyglądało na zawieszenie pola.
667
+ * z komunikatem "Szukam...", żeby czekanie nie wyglądało na zawieszenie pola.
652
668
  */
653
669
  protected pick(suggestion: KptMapSuggestion): void;
654
670
  private applyResolved;
655
671
  protected clear(): void;
656
672
  protected onKeydown(event: KeyboardEvent): void;
657
673
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMapSearch, never>;
658
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapSearch, "kpt-map-search", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "countryCodes": { "alias": "countryCodes"; "required": false; "isSignal": true; }; "viewbox": { "alias": "viewbox"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "cleared": "cleared"; }, never, never, true, never>;
674
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapSearch, "kpt-map-search", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "countryCodes": { "alias": "countryCodes"; "required": false; "isSignal": true; }; "viewbox": { "alias": "viewbox"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "speech": { "alias": "speech"; "required": false; "isSignal": true; }; "speechLang": { "alias": "speechLang"; "required": false; "isSignal": true; }; "speechColor": { "alias": "speechColor"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "cleared": "cleared"; }, never, never, true, never>;
659
675
  }
660
676
 
661
677
  /**
662
- * Treść dialogu „dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
678
+ * Treść dialogu "dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
663
679
  *
664
- * Przy dynamicznej schemie typowanie pól znika — model to `Record<string, unknown>`,
680
+ * Przy dynamicznej schemie typowanie pól znika - model to `Record<string, unknown>`,
665
681
  * a ścieżki walidatorów trzeba rzutować. Reszta kontraktu Signal Forms zostaje bez zmian:
666
- * walidatory deklarujemy raz, a bramka „nie strasz czerwienią" siedzi w prezentacji.
682
+ * walidatory deklarujemy raz, a bramka "nie strasz czerwienią" siedzi w prezentacji.
667
683
  */
668
684
  declare class KptMapCreateDialog {
669
685
  readonly category: _angular_core.InputSignal<KptMapCategory>;
670
686
  readonly at: _angular_core.InputSignal<KptLatLng>;
671
687
  /**
672
- * Geokoder tego formularza. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI — `kpt-map` podaje
688
+ * Geokoder tego formularza. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI - `kpt-map` podaje
673
689
  * tędy port swojej mapy, bo geokoder jest per mapa, a nie per aplikacja.
674
690
  */
675
691
  readonly geocoder: _angular_core.InputSignal<KptMapGeocoderPort | null>;
@@ -677,11 +693,11 @@ declare class KptMapCreateDialog {
677
693
  readonly cancelled: _angular_core.OutputEmitterRef<void>;
678
694
  protected readonly i18n: KptI18n;
679
695
  private readonly injector;
680
- /** Opcjonalny — wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
696
+ /** Opcjonalny - wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
681
697
  private readonly injectedGeocoder;
682
698
  /** Rozstrzygnięty port: wejście przed DI. Bez obu formularz po prostu nie podpowiada adresu. */
683
699
  private readonly port;
684
- /** Trwa zapytanie do geokodera — szablon pokazuje wtedy notkę zamiast ciszy. */
700
+ /** Trwa zapytanie do geokodera - szablon pokazuje wtedy notkę zamiast ciszy. */
685
701
  protected readonly geocoding: WritableSignal<boolean>;
686
702
  /** Ostatnio ustalony adres; `label` bywa czytelniejszy niż suma pól. */
687
703
  protected readonly address: WritableSignal<KptMapAddress | null>;
@@ -692,12 +708,12 @@ declare class KptMapCreateDialog {
692
708
  * Model i formularz dla aktualnej kategorii. Budowane w efekcie, nie w `computed()`,
693
709
  * bo `form()` zakłada dwie rzeczy, których ciało `computed()` nie spełnia:
694
710
  *
695
- * - wstrzykuje sobie zależności → stąd `runInInjectionContext`;
711
+ * - wstrzykuje sobie zależności -> stąd `runInInjectionContext`;
696
712
  * - zakłada własny `effect()`, a tego nie wolno tworzyć w kontekście reaktywnym
697
- * (NG0602) → stąd `untracked`, które zdejmuje aktywnego konsumenta.
713
+ * (NG0602) -> stąd `untracked`, które zdejmuje aktywnego konsumenta.
698
714
  *
699
715
  * Zależność od `fields()` zostaje śledzona na zewnątrz `untracked`, więc zmiana
700
- * kategorii przebudowuje formularz — inny zestaw pól to inny formularz, a Signal Forms
716
+ * kategorii przebudowuje formularz - inny zestaw pól to inny formularz, a Signal Forms
701
717
  * wiąże schemę tylko raz, przy tworzeniu.
702
718
  */
703
719
  private readonly built;
@@ -705,7 +721,7 @@ declare class KptMapCreateDialog {
705
721
  /**
706
722
  * Podpowiada adres z geokodowania wstecznego współrzędnych kliknięcia.
707
723
  *
708
- * Wypełnia wyłącznie pola z `autofill` i wyłącznie te, które są jeszcze puste —
724
+ * Wypełnia wyłącznie pola z `autofill` i wyłącznie te, które są jeszcze puste -
709
725
  * podpowiedź nigdy nie kasuje tego, co użytkownik zdążył wpisać. Brak portu
710
726
  * `KPT_MAP_GEOCODER` albo nieudane zapytanie to nie błąd: pola zostają puste.
711
727
  */
@@ -713,20 +729,20 @@ declare class KptMapCreateDialog {
713
729
  /** `null` tylko między utworzeniem komponentu a pierwszym przebiegiem efektu. */
714
730
  protected readonly formRoot: _angular_core.Signal<_angular_forms_signals.FieldTree<Record<string, unknown>, string | number, "writable"> | null>;
715
731
  protected readonly formInvalid: _angular_core.Signal<boolean>;
716
- /** Kontrolka pola po kluczu — szablon podaje ją do `[formField]`. */
732
+ /** Kontrolka pola po kluczu - szablon podaje ją do `[formField]`. */
717
733
  protected fieldOf(key: string): unknown;
718
- /** Komunikat pokazujemy dopiero po dotknięciu pola — bramka żyje w prezentacji. */
734
+ /** Komunikat pokazujemy dopiero po dotknięciu pola - bramka żyje w prezentacji. */
719
735
  protected errorOf(key: string): string | null;
720
736
  /**
721
737
  * Dzień otwarty musi mieć obie godziny i różne od siebie. Dzień oznaczony jako
722
- * zamknięty przechodzi bez zastrzeżeń — to prawidłowa odpowiedź, a nie brak danych.
738
+ * zamknięty przechodzi bez zastrzeżeń - to prawidłowa odpowiedź, a nie brak danych.
723
739
  */
724
740
  private hoursError;
725
741
  protected optionsOf(def: KptMapFieldDef): KptOption<unknown>[];
726
742
  protected controlId(def: KptMapFieldDef): string;
727
743
  /** Czy pole renderuje jeden `<input>`, na który może wskazać `label[for]`. */
728
744
  protected hasOwnInput(def: KptMapFieldDef): boolean;
729
- /** Współrzędne z prawego kliknięcia — pokazujemy je, ale nie pozwalamy edytować. */
745
+ /** Współrzędne z prawego kliknięcia - pokazujemy je, ale nie pozwalamy edytować. */
730
746
  protected readonly coords: _angular_core.Signal<{
731
747
  lat: string;
732
748
  lng: string;
@@ -742,7 +758,7 @@ interface ContactRow {
742
758
  icon: string;
743
759
  /** Tekst pokazywany użytkownikowi. */
744
760
  text: string;
745
- /** Tekst kopiowany do schowka — dla współrzędnych inny niż wyświetlany. */
761
+ /** Tekst kopiowany do schowka - dla współrzędnych inny niż wyświetlany. */
746
762
  copyValue: string;
747
763
  /** `href` akcji właściwej; `null` dla współrzędnych (nie ma dokąd prowadzić). */
748
764
  href: string | null;
@@ -752,14 +768,14 @@ interface ContactRow {
752
768
  actionLabel: string;
753
769
  }
754
770
  /**
755
- * Karta miejsca do popupu mapy — dystans od użytkownika, zdjęcie, akcje, kategoria,
771
+ * Karta miejsca do popupu mapy - dystans od użytkownika, zdjęcie, akcje, kategoria,
756
772
  * rozwijane godziny otwarcia i wiersze kontaktowe z kopiowaniem.
757
773
  *
758
774
  * Komponent jest sterowany danymi: bierze `KptMapPoi`, a nie model domenowy aplikacji.
759
- * Mapowanie `KptMapLocation.data` → `KptMapPoi` robi aplikacja, dzięki czemu karta nie
775
+ * Mapowanie `KptMapLocation.data` -> `KptMapPoi` robi aplikacja, dzięki czemu karta nie
760
776
  * wie nic o tym, czy pokazuje ładowarkę, restaurację, czy punkt serwisowy.
761
777
  *
762
- * Sam popup `kpt-map` trzeba przełączyć na `[popupLayout]="'card'"` — inaczej karta
778
+ * Sam popup `kpt-map` trzeba przełączyć na `[popupLayout]="'card'"` - inaczej karta
763
779
  * dostanie 20 rem szerokości i padding przeznaczony dla treści tekstowej.
764
780
  *
765
781
  * @example
@@ -795,10 +811,10 @@ declare class KptMapPoiCard {
795
811
  protected readonly i18n: KptI18n;
796
812
  /** Identyfikator regionu godzin; kart na stronie bywa więcej niż jedna. */
797
813
  protected readonly hoursId: string;
798
- /** Rośnie przy każdym otwarciu karty i przy zmianie danych — odświeża status godzin. */
814
+ /** Rośnie przy każdym otwarciu karty i przy zmianie danych - odświeża status godzin. */
799
815
  private readonly now;
800
816
  /**
801
- * Ikona kategorii stoi wprost na powierzchni karty, bez własnego tła — stąd
817
+ * Ikona kategorii stoi wprost na powierzchni karty, bez własnego tła - stąd
802
818
  * `foregroundVarOf()`, a nie `colorVarOf()`: rola `muted` ma kolor tła, nie treści.
803
819
  */
804
820
  protected readonly categoryColor: _angular_core.Signal<string | null>;
@@ -808,10 +824,10 @@ declare class KptMapPoiCard {
808
824
  protected readonly open: _angular_core.Signal<boolean>;
809
825
  protected readonly hoursGroups: _angular_core.Signal<KptMapHoursGroup[]>;
810
826
  protected readonly statusLabel: _angular_core.Signal<string>;
811
- /** Dopisek „otwarcie o 11:00" — nie ma go dla 24/7 ani gdy zmiana jest dalej niż doba. */
827
+ /** Dopisek "otwarcie o 11:00" - nie ma go dla 24/7 ani gdy zmiana jest dalej niż doba. */
812
828
  protected readonly statusHint: _angular_core.Signal<string | null>;
813
829
  protected readonly rows: _angular_core.Signal<ContactRow[]>;
814
- /** Klucz wiersza, którego wartość właśnie skopiowano — przełącza ikonę na „check". */
830
+ /** Klucz wiersza, którego wartość właśnie skopiowano - przełącza ikonę na "check". */
815
831
  protected readonly justCopied: _angular_core.WritableSignal<string | null>;
816
832
  private copyTimer;
817
833
  /** Bez API schowka przycisk kopiowania w ogóle się nie renderuje. */
@@ -832,7 +848,7 @@ declare class KptMapPoiCard {
832
848
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapPoiCard, "kpt-map-poi-card", never, { "poi": { "alias": "poi"; "required": true; "isSignal": true; }; "distance": { "alias": "distance"; "required": false; "isSignal": true; }; "category": { "alias": "category"; "required": false; "isSignal": true; }; "primaryLabel": { "alias": "primaryLabel"; "required": false; "isSignal": true; }; "showShare": { "alias": "showShare"; "required": false; "isSignal": true; }; "showFavourite": { "alias": "showFavourite"; "required": false; "isSignal": true; }; "favourite": { "alias": "favourite"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "hoursExpanded": { "alias": "hoursExpanded"; "required": false; "isSignal": true; }; }, { "favourite": "favouriteChange"; "hoursExpanded": "hoursExpandedChange"; "primaryAction": "primaryAction"; "closed": "closed"; "shared": "shared"; }, never, never, true, never>;
833
849
  }
834
850
 
835
- /** Wiersz edytora — dzień z nazwą i przedziałami dopełnionymi do pustych pól. */
851
+ /** Wiersz edytora - dzień z nazwą i przedziałami dopełnionymi do pustych pól. */
836
852
  interface HoursRow {
837
853
  day: KptMapWeekday;
838
854
  name: string;
@@ -843,10 +859,10 @@ interface HoursRow {
843
859
  }[];
844
860
  }
845
861
  /**
846
- * Pole „godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
862
+ * Pole "godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
847
863
  *
848
- * Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem „zamknięte".
849
- * Skrót „tak samo przez cały tydzień" kopiuje poniedziałek na pozostałe dni — to
864
+ * Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem "zamknięte".
865
+ * Skrót "tak samo przez cały tydzień" kopiuje poniedziałek na pozostałe dni - to
850
866
  * najczęstszy przypadek, a bez niego wypełnienie formularza to czternaście pól.
851
867
  *
852
868
  * Nazwy dni idą z `Intl`, nie ze słownika `KptMessages`: rozkład tygodnia jest
@@ -862,7 +878,7 @@ declare class KptMapHoursField implements FormValueControl<KptMapOpeningHours> {
862
878
  protected readonly i18n: KptI18n;
863
879
  protected readonly maxRanges = 2;
864
880
  protected readonly minuteStep = 5;
865
- /** Skrót „tak samo przez cały tydzień" — trzymany w modelu, nie w wartości. */
881
+ /** Skrót "tak samo przez cały tydzień" - trzymany w modelu, nie w wartości. */
866
882
  readonly sameAllWeek: _angular_core.ModelSignal<boolean>;
867
883
  protected readonly rows: _angular_core.Signal<HoursRow[]>;
868
884
  /** Dni poza poniedziałkiem są zablokowane, gdy tydzień jest jednakowy. */
@@ -874,20 +890,20 @@ declare class KptMapHoursField implements FormValueControl<KptMapOpeningHours> {
874
890
  protected removeRange(row: HoursRow, index: number): void;
875
891
  /** Zmiana jednego dnia; przy jednakowym tygodniu poniedziałek rozlewa się na resztę. */
876
892
  private patch;
877
- /** Zapis zawsze przez pełny, uporządkowany tydzień — model nie ma dziur. */
893
+ /** Zapis zawsze przez pełny, uporządkowany tydzień - model nie ma dziur. */
878
894
  private write;
879
895
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMapHoursField, never>;
880
896
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapHoursField, "kpt-map-hours-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "sameAllWeek": { "alias": "sameAllWeek"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "sameAllWeek": "sameAllWeekChange"; }, never, never, true, never>;
881
897
  }
882
898
 
883
899
  /**
884
- * Pole „zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
900
+ * Pole "zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
885
901
  *
886
902
  * Wartością jest zawsze **string**: albo `data:` z wybranego pliku, albo adres wklejony
887
903
  * przez użytkownika. Karta miejsca nie rozróżnia jednego od drugiego, więc formularz
888
904
  * nie musi decydować za aplikację, gdzie zdjęcia mieszkają.
889
905
  *
890
- * Plik czytamy w przeglądarce i nigdzie nie wysyłamy — biblioteka nie ma i nie chce
906
+ * Plik czytamy w przeglądarce i nigdzie nie wysyłamy - biblioteka nie ma i nie chce
891
907
  * mieć wiedzy o storage'u aplikacji.
892
908
  */
893
909
  declare class KptMapImageField implements FormValueControl<string> {
@@ -915,7 +931,7 @@ declare class KptMapImageField implements FormValueControl<string> {
915
931
  }
916
932
 
917
933
  /**
918
- * Fabryka silnika mapy. Fabryka, a nie gotowa instancja — każda mapa na stronie
934
+ * Fabryka silnika mapy. Fabryka, a nie gotowa instancja - każda mapa na stronie
919
935
  * potrzebuje własnego obiektu, a provider jest jeden.
920
936
  */
921
937
  declare const KPT_MAP_ENGINE: InjectionToken<KptMapEngineFactory>;
@@ -929,9 +945,9 @@ declare const KPT_MAP_ENGINE: InjectionToken<KptMapEngineFactory>;
929
945
  */
930
946
  declare function provideKptLeafletMap(options?: KptLeafletOptions): Provider[];
931
947
  /**
932
- * Silnik Google Maps. Nie wymaga żadnej paczki npm — API dogrywa się skryptem przy pierwszej
933
- * mapie — ale wymaga klucza, konta rozliczeniowego i **`mapId`** z konsoli Google
934
- * (*Map management → Create Map ID*): bez niego znaczniki się nie pojawią.
948
+ * Silnik Google Maps. Nie wymaga żadnej paczki npm - API dogrywa się skryptem przy pierwszej
949
+ * mapie - ale wymaga klucza, konta rozliczeniowego i **`mapId`** z konsoli Google
950
+ * (*Map management -> Create Map ID*): bez niego znaczniki się nie pojawią.
935
951
  *
936
952
  * Różnice wobec Leafleta: `[tileUrl]` i `[attribution]` są bez znaczenia (kafle i atrybucję
937
953
  * dostarcza Google i nie wolno ich zasłonić), wczytanie mapy liczy się do SKU Dynamic Maps
@@ -948,7 +964,7 @@ declare function provideKptLeafletMap(options?: KptLeafletOptions): Provider[];
948
964
  declare function provideKptGoogleMap(options: KptGoogleOptions): Provider[];
949
965
 
950
966
  /**
951
- * Źródło pozycji użytkownika. Port, a nie bezpośrednie `navigator.geolocation` — dzięki
967
+ * Źródło pozycji użytkownika. Port, a nie bezpośrednie `navigator.geolocation` - dzięki
952
968
  * temu Storybook i testy podstawiają stałą pozycję zamiast pytać przeglądarkę o zgodę.
953
969
  */
954
970
  interface KptMapGeolocationPort {
@@ -959,7 +975,7 @@ interface KptMapGeolocationPort {
959
975
  watch(options?: PositionOptions): Observable<KptMapUserPosition | null>;
960
976
  }
961
977
  declare const KPT_MAP_GEOLOCATION: InjectionToken<KptMapGeolocationPort>;
962
- /** Błąd geolokalizacji rozpoznany po kodzie — rzucany strumieniem, nie wyjątkiem. */
978
+ /** Błąd geolokalizacji rozpoznany po kodzie - rzucany strumieniem, nie wyjątkiem. */
963
979
  declare class KptMapGeolocationFailure extends Error {
964
980
  readonly detail: KptMapGeolocationError;
965
981
  constructor(detail: KptMapGeolocationError);
@@ -968,12 +984,12 @@ declare class KptMapGeolocationFailure extends Error {
968
984
  * Domyślna implementacja na `navigator.geolocation.watchPosition`.
969
985
  *
970
986
  * Uwaga: Geolocation API działa wyłącznie w bezpiecznym kontekście (HTTPS albo
971
- * `localhost`). Na `http://` z adresem IP przeglądarka odmówi — to nie jest błąd mapy.
987
+ * `localhost`). Na `http://` z adresem IP przeglądarka odmówi - to nie jest błąd mapy.
972
988
  */
973
989
  declare class KptBrowserGeolocation implements KptMapGeolocationPort {
974
990
  watch(options?: PositionOptions): Observable<KptMapUserPosition | null>;
975
991
  }
976
- /** Stała pozycja — Storybook, testy, demo bez pytania o zgodę. */
992
+ /** Stała pozycja - Storybook, testy, demo bez pytania o zgodę. */
977
993
  declare class KptMapGeolocationStub implements KptMapGeolocationPort {
978
994
  private readonly at;
979
995
  private readonly accuracy;