@konce-pt/angular 0.11.2 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/CHANGELOG.md +792 -333
  2. package/README.md +111 -55
  3. package/charts/src/lib/llms.txt +23 -15
  4. package/chat/src/lib/llms.txt +68 -33
  5. package/fesm2022/konce-pt-angular-charts.mjs +149 -68
  6. package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
  7. package/fesm2022/konce-pt-angular-chat.mjs +296 -135
  8. package/fesm2022/konce-pt-angular-chat.mjs.map +1 -1
  9. package/fesm2022/konce-pt-angular-grid.mjs +16 -16
  10. package/fesm2022/konce-pt-angular-grid.mjs.map +1 -1
  11. package/fesm2022/konce-pt-angular-icons.mjs +5 -5
  12. package/fesm2022/konce-pt-angular-icons.mjs.map +1 -1
  13. package/fesm2022/konce-pt-angular-map.mjs +360 -293
  14. package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
  15. package/fesm2022/konce-pt-angular-roadmap.mjs +120 -34
  16. package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
  17. package/fesm2022/konce-pt-angular.mjs +7117 -3373
  18. package/fesm2022/konce-pt-angular.mjs.map +1 -1
  19. package/grid/src/lib/llms.txt +18 -18
  20. package/map/src/lib/llms.txt +142 -140
  21. package/package.json +14 -12
  22. package/roadmap/src/lib/llms.txt +37 -27
  23. package/src/lib/accordion/llms.txt +18 -6
  24. package/src/lib/alert/llms.txt +5 -4
  25. package/src/lib/app-shell/llms.txt +25 -22
  26. package/src/lib/auth/llms.txt +26 -22
  27. package/src/lib/autocomplete/llms.txt +18 -4
  28. package/src/lib/avatar/llms.txt +3 -3
  29. package/src/lib/avatar-group/llms.txt +5 -5
  30. package/src/lib/backdrop/llms.txt +35 -35
  31. package/src/lib/badge/llms.txt +7 -7
  32. package/src/lib/bottom-sheet/llms.txt +6 -3
  33. package/src/lib/breadcrumb/llms.txt +9 -1
  34. package/src/lib/breakpoint/llms.txt +8 -8
  35. package/src/lib/button/llms.txt +26 -18
  36. package/src/lib/button-group/llms.txt +40 -31
  37. package/src/lib/card/llms.txt +19 -19
  38. package/src/lib/carousel/llms.txt +6 -6
  39. package/src/lib/checkbox/llms.txt +17 -2
  40. package/src/lib/chip/llms.txt +6 -6
  41. package/src/lib/chips-input/llms.txt +14 -4
  42. package/src/lib/color-picker/llms.txt +7 -4
  43. package/src/lib/confirm/llms.txt +9 -3
  44. package/src/lib/context-menu/llms.txt +7 -4
  45. package/src/lib/data-table/llms.txt +280 -227
  46. package/src/lib/data-view/llms.txt +25 -4
  47. package/src/lib/date-range/llms.txt +37 -18
  48. package/src/lib/datepicker/llms.txt +46 -29
  49. package/src/lib/dialog/llms.txt +29 -26
  50. package/src/lib/divider/llms.txt +2 -1
  51. package/src/lib/drawer/llms.txt +9 -6
  52. package/src/lib/empty/llms.txt +4 -4
  53. package/src/lib/fab/llms.txt +6 -2
  54. package/src/lib/fieldset/llms.txt +22 -4
  55. package/src/lib/file-upload/llms.txt +3 -0
  56. package/src/lib/form-field/llms.txt +33 -19
  57. package/src/lib/galleria/llms.txt +3 -3
  58. package/src/lib/i18n/llms.txt +15 -8
  59. package/src/lib/icon/llms.txt +9 -9
  60. package/src/lib/icon-button/llms.txt +8 -3
  61. package/src/lib/image/llms.txt +4 -4
  62. package/src/lib/input/llms.txt +21 -7
  63. package/src/lib/input-mask/llms.txt +5 -2
  64. package/src/lib/input-number/llms.txt +18 -15
  65. package/src/lib/input-otp/llms.txt +15 -4
  66. package/src/lib/knob/llms.txt +14 -7
  67. package/src/lib/listbox/llms.txt +8 -5
  68. package/src/lib/loader/llms.txt +72 -0
  69. package/src/lib/megamenu/llms.txt +16 -5
  70. package/src/lib/mention/llms.txt +15 -15
  71. package/src/lib/menu/llms.txt +12 -12
  72. package/src/lib/menubar/llms.txt +16 -5
  73. package/src/lib/meter-group/llms.txt +7 -7
  74. package/src/lib/order-list/llms.txt +20 -5
  75. package/src/lib/paginator/llms.txt +5 -5
  76. package/src/lib/panel/llms.txt +20 -8
  77. package/src/lib/password/llms.txt +17 -5
  78. package/src/lib/peek/llms.txt +11 -11
  79. package/src/lib/pick-list/llms.txt +28 -5
  80. package/src/lib/popover/llms.txt +9 -6
  81. package/src/lib/progress/llms.txt +16 -16
  82. package/src/lib/radio-group/llms.txt +13 -3
  83. package/src/lib/rating/llms.txt +13 -6
  84. package/src/lib/rich-text/llms.txt +42 -24
  85. package/src/lib/scroll-top/llms.txt +3 -3
  86. package/src/lib/select/llms.txt +23 -13
  87. package/src/lib/sidenav/llms.txt +8 -8
  88. package/src/lib/slider/llms.txt +23 -7
  89. package/src/lib/speech/llms.txt +108 -0
  90. package/src/lib/speed-dial/llms.txt +9 -3
  91. package/src/lib/spinner/llms.txt +2 -2
  92. package/src/lib/split-button/llms.txt +14 -8
  93. package/src/lib/splitter/llms.txt +8 -8
  94. package/src/lib/stepper/llms.txt +26 -7
  95. package/src/lib/switch/llms.txt +13 -3
  96. package/src/lib/switch-group/llms.txt +12 -9
  97. package/src/lib/tabs/llms.txt +7 -4
  98. package/src/lib/textarea/llms.txt +16 -5
  99. package/src/lib/timeline/llms.txt +1 -1
  100. package/src/lib/toast/llms.txt +36 -5
  101. package/src/lib/toolbar/llms.txt +3 -3
  102. package/src/lib/tooltip/llms.txt +13 -10
  103. package/src/lib/tree/llms.txt +19 -5
  104. package/src/lib/update/llms.txt +52 -0
  105. package/types/konce-pt-angular-charts.d.ts +11 -0
  106. package/types/konce-pt-angular-charts.d.ts.map +1 -1
  107. package/types/konce-pt-angular-chat.d.ts +98 -40
  108. package/types/konce-pt-angular-chat.d.ts.map +1 -1
  109. package/types/konce-pt-angular-grid.d.ts +14 -14
  110. package/types/konce-pt-angular-icons.d.ts +3 -3
  111. package/types/konce-pt-angular-map.d.ts +147 -119
  112. package/types/konce-pt-angular-map.d.ts.map +1 -1
  113. package/types/konce-pt-angular-roadmap.d.ts +34 -9
  114. package/types/konce-pt-angular-roadmap.d.ts.map +1 -1
  115. package/types/konce-pt-angular.d.ts +1774 -651
  116. package/types/konce-pt-angular.d.ts.map +1 -1
@@ -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>;
@@ -288,21 +288,21 @@ declare class KptMap<T = unknown> {
288
288
  readonly cluster: _angular_core.InputSignalWithTransform<boolean, unknown>;
289
289
  readonly clusterOptions: _angular_core.InputSignal<Partial<Omit<KptClusterOptions, "zoom">>>;
290
290
  /** `dominant` barwi grupę kolorem najliczniejszej kategorii. */
291
- readonly clusterColorBy: _angular_core.InputSignal<"dominant" | "none">;
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>>;
@@ -376,12 +382,17 @@ declare class KptMap<T = unknown> {
376
382
  }>;
377
383
  readonly userPositionChange: _angular_core.OutputEmitterRef<KptMapUserPosition | null>;
378
384
  readonly userLocationError: _angular_core.OutputEmitterRef<KptMapGeolocationError>;
385
+ /**
386
+ * Silnika nie udało się uruchomić - brak fabryki, brak paczki `leaflet`, odrzucony klucz Google.
387
+ * Bez słuchacza błąd ląduje w konsoli; ze słuchaczem aplikacja może pokazać własny komunikat.
388
+ */
389
+ readonly engineError: _angular_core.OutputEmitterRef<unknown>;
379
390
  protected readonly i18n: KptI18n;
380
391
  private readonly icons;
381
392
  /** Opcjonalny, bo silnik może przyjść wejściem `[engine]` zamiast z DI. */
382
393
  private readonly engineFactory;
383
394
  private readonly geolocation;
384
- /** Opcjonalny — wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
395
+ /** Opcjonalny - wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
385
396
  private readonly injectedGeocoder;
386
397
  private readonly destroyRef;
387
398
  private readonly injector;
@@ -392,11 +403,15 @@ declare class KptMap<T = unknown> {
392
403
  private readonly popupTemplates;
393
404
  protected readonly createFormTemplate: _angular_core.Signal<KptMapCreateFormTemplate | undefined>;
394
405
  private mapEngine;
406
+ /** Komponent zniszczony - `initEngine()` po `await` nie może już podpinać zdarzeń ani obserwatorów. */
407
+ private destroyed;
408
+ /** Trwający montaż silnika; zniszczenie czeka na jego koniec (patrz konstruktor). */
409
+ private engineInit;
395
410
  protected readonly engineKind: _angular_core.WritableSignal<string | null>;
396
411
  protected readonly ready: _angular_core.WritableSignal<boolean>;
397
412
  /** Zoom trzymamy w sygnale, bo od niego zależy wynik grupowania. */
398
413
  private readonly zoom;
399
- /** Rośnie przy każdym ruchu mapy — wymusza przeliczenie pozycji popupu. */
414
+ /** Rośnie przy każdym ruchu mapy - wymusza przeliczenie pozycji popupu. */
400
415
  private readonly viewportTick;
401
416
  protected readonly popup: _angular_core.WritableSignal<PopupState<T> | null>;
402
417
  protected readonly contextTarget: _angular_core.WritableSignal<{
@@ -409,52 +424,53 @@ declare class KptMap<T = unknown> {
409
424
  } | null>;
410
425
  protected readonly createOpen: _angular_core.WritableSignal<boolean>;
411
426
  protected readonly userPosition: _angular_core.WritableSignal<KptMapUserPosition | null>;
412
- /** Ostatni wybrany wynik wyszukiwania — źródło tymczasowej pinezki. */
427
+ /** Ostatni wybrany wynik wyszukiwania - źródło tymczasowej pinezki. */
413
428
  protected readonly searchPin: _angular_core.WritableSignal<KptMapSearchResult | null>;
414
429
  protected readonly locationBlocked: _angular_core.WritableSignal<boolean>;
415
430
  private readonly categoryById;
416
431
  /** Lokalizacje po odfiltrowaniu kategorii ukrytych w legendzie. */
417
432
  private readonly visibleLocations;
418
433
  protected readonly counts: _angular_core.Signal<Record<string, number> | null>;
419
- /** Wynik grupowania dla aktualnego zoomu — grupy i punkty pojedyncze. */
434
+ /** Wynik grupowania dla aktualnego zoomu - grupy i punkty pojedyncze. */
420
435
  private readonly entries;
421
436
  /** Znaczniki gotowe dla silnika. HTML powstaje w rdzeniu, poza Angularem. */
422
437
  private readonly markers;
423
- /** Szablon popupu dla kategorii; bez dopasowania — szablon zapasowy (bez `category`). */
438
+ /** Szablon popupu dla kategorii; bez dopasowania - szablon zapasowy (bez `category`). */
424
439
  private readonly popupTemplateFor;
425
440
  protected readonly popupTemplate: _angular_core.Signal<KptMapPopupTemplate<T> | null>;
426
441
  protected readonly popupCategory: _angular_core.Signal<KptMapCategory | undefined>;
427
442
  /**
428
443
  * Odległość otwartego punktu od `distanceFrom` (albo od użytkownika) w metrach.
429
- * `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,
430
445
  * zamiast pokazywać zero.
431
446
  */
432
447
  protected readonly popupDistance: _angular_core.Signal<number | null>;
433
448
  /**
434
449
  * Pozycja popupu w pikselach kontenera. Zależy od `viewportTick`, więc przelicza się
435
- * 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.
436
451
  */
437
452
  protected readonly popupPosition: _angular_core.Signal<KptMapPoint | null>;
438
453
  protected readonly contextPosition: _angular_core.Signal<KptMapPoint | null>;
439
- /** Kategorie oferowane w menu „dodaj" — ukryte w legendzie odpadają. */
454
+ /** Kategorie oferowane w menu "dodaj" - ukryte w legendzie odpadają. */
440
455
  protected readonly creatableCategories: _angular_core.Signal<KptMapCategory[]>;
441
- /** 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. */
442
457
  protected readonly searchEnabled: _angular_core.Signal<boolean>;
443
458
  /**
444
- * Prostokąt preferowanych wyników. Bierzemy zasięg jawny, a bez niego preset kraju —
445
- * „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:
446
461
  * adresu z zagranicy dalej da się poszukać.
447
462
  */
448
463
  protected readonly searchViewbox: _angular_core.Signal<KptMapBounds>;
449
464
  /**
450
465
  * Twarde zawężenie do krajów. Jawne `searchOptions.countryCodes` wygrywa; bez niego
451
466
  * odcinamy zagranicę dopiero przy `restrictToCountry`, bo tam mapa i tak nie pozwoli
452
- * przesunąć widoku poza kraj — znaleziony adres byłby nie do pokazania.
467
+ * przesunąć widoku poza kraj - znaleziony adres byłby nie do pokazania.
453
468
  */
454
469
  protected readonly searchCountryCodes: _angular_core.Signal<readonly string[] | null>;
455
470
  protected readonly createFormApi: _angular_core.Signal<KptMapCreateFormApi | null>;
456
471
  constructor();
457
472
  private restrictBounds;
473
+ private reportEngineError;
458
474
  private initEngine;
459
475
  /** Bez tego Leaflet zostawia szare pola po każdej zmianie układu strony. */
460
476
  private observeResize;
@@ -476,28 +492,28 @@ declare class KptMap<T = unknown> {
476
492
  * Bez tego znacznik przy górnej krawędzi otwiera popup poza widokiem.
477
493
  */
478
494
  private autoPanToPopup;
479
- /** Gotowa referencja dla kontekstu szablonu — szablon nie ma jak zrobić `bind`. */
495
+ /** Gotowa referencja dla kontekstu szablonu - szablon nie ma jak zrobić `bind`. */
480
496
  protected readonly closePopupFn: () => void;
481
- /** Pozycja z grupy nierozdzielalnej — przełącza popup bez ruszania mapy. */
497
+ /** Pozycja z grupy nierozdzielalnej - przełącza popup bez ruszania mapy. */
482
498
  protected selectFromGroup(location: KptMapLocation<T>): void;
483
499
  protected startCreate(category: KptMapCategory): void;
484
500
  protected closeCreate(): void;
485
501
  protected emitCreate(value: Record<string, unknown>): void;
486
502
  /**
487
503
  * Przenosi widok na wybrany wynik. Zasięg (miasto, region) wpasowujemy w kadr,
488
- * 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
489
505
  * w innym przybliżeniu, zależnym od tego, jak dostawca obrysował budynek.
490
506
  */
491
507
  protected onSearchSelect(result: KptMapSearchResult): void;
492
508
  protected zoomBy(delta: number): void;
493
509
  protected centreOnUser(): void;
494
- /** 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. */
495
511
  protected resetView(): void;
496
- /** Zasięg wszystkich widocznych lokalizacji — `null`, gdy nie ma żadnej. */
512
+ /** Zasięg wszystkich widocznych lokalizacji - `null`, gdy nie ma żadnej. */
497
513
  protected readonly dataBounds: _angular_core.Signal<KptMapBounds | null>;
498
514
  protected fitToData(): void;
499
515
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMap<any>, never>;
500
- 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"; }, ["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>;
501
517
  }
502
518
 
503
519
  interface LegendEntry {
@@ -509,7 +525,7 @@ interface LegendEntry {
509
525
  count: number | null;
510
526
  }
511
527
  /**
512
- * 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:
513
529
  * kliknięcie chowa i pokazuje kategorię (`hidden` dwukierunkowe).
514
530
  *
515
531
  * `kpt-map` renderuje ją sam pod mapą przy `[legend]="true"`; kto chce ją gdzie indziej,
@@ -522,10 +538,10 @@ declare class KptMapLegend {
522
538
  readonly categories: _angular_core.InputSignal<readonly KptMapCategory[]>;
523
539
  /** Identyfikatory ukrytych kategorii (dwukierunkowe). */
524
540
  readonly hidden: _angular_core.ModelSignal<string[]>;
525
- /** Opcjonalne liczniki `{ categoryId: liczba }` — pokazywane przy etykiecie. */
541
+ /** Opcjonalne liczniki `{ categoryId: liczba }` - pokazywane przy etykiecie. */
526
542
  readonly counts: _angular_core.InputSignal<Record<string, number> | null>;
527
543
  readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
528
- /** Wyłącza chowanie kategorii — legenda staje się czysto informacyjna. */
544
+ /** Wyłącza chowanie kategorii - legenda staje się czysto informacyjna. */
529
545
  readonly interactive: _angular_core.InputSignal<boolean>;
530
546
  protected readonly i18n: KptI18n;
531
547
  protected readonly entries: _angular_core.Signal<LegendEntry[]>;
@@ -537,9 +553,9 @@ declare class KptMapLegend {
537
553
 
538
554
  /**
539
555
  * Wyszukiwarka adresów: pole z podpowiedziami z geokodera. Wynik wyboru leci w `selected`,
540
- * 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).
541
557
  *
542
- * 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
543
559
  * serwera bez zgody aplikacji. Bez portu pole renderuje się wyłączone, zamiast udawać, że
544
560
  * coś znajdzie; `kpt-map` idzie dalej i w ogóle go wtedy nie pokazuje.
545
561
  *
@@ -560,13 +576,23 @@ declare class KptMapSearch {
560
576
  readonly debounce: _angular_core.InputSignalWithTransform<number, unknown>;
561
577
  /** Ile podpowiedzi najwyżej. */
562
578
  readonly limit: _angular_core.InputSignalWithTransform<number, unknown>;
563
- /** 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ą. */
564
580
  readonly countryCodes: _angular_core.InputSignal<readonly string[] | null>;
565
581
  /** Preferowany prostokąt wyników. Nie odcina reszty świata, tylko przesuwa ją niżej. */
566
582
  readonly viewbox: _angular_core.InputSignal<KptMapBounds | null>;
567
583
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
568
584
  /**
569
- * 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
570
596
  * port swojej mapy, bo geokoder jest per mapa, a nie per aplikacja. Bez niego wszystko
571
597
  * działa jak dotąd: port przychodzi z DI.
572
598
  */
@@ -576,7 +602,7 @@ declare class KptMapSearch {
576
602
  * pole najpierw uzupełnia przez `resolve()` portu, a dopiero potem emituje.
577
603
  */
578
604
  readonly selected: _angular_core.OutputEmitterRef<KptMapSearchResult>;
579
- /** Pole wyczyszczone — rodzic sprząta po sobie (np. chowa tymczasową pinezkę). */
605
+ /** Pole wyczyszczone - rodzic sprząta po sobie (np. chowa tymczasową pinezkę). */
580
606
  readonly cleared: _angular_core.OutputEmitterRef<void>;
581
607
  protected readonly i18n: KptI18n;
582
608
  private readonly injectedGeocoder;
@@ -587,7 +613,7 @@ declare class KptMapSearch {
587
613
  protected readonly query: _angular_core.WritableSignal<string>;
588
614
  /**
589
615
  * Fraza do odpytania geokodera. Osobna od `query`, bo wybór podpowiedzi zmienia treść
590
- * 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.
591
617
  */
592
618
  private readonly term;
593
619
  protected readonly results: _angular_core.WritableSignal<readonly KptMapSuggestion[]>;
@@ -597,21 +623,23 @@ declare class KptMapSearch {
597
623
  * `loading`, bo to inny moment: tam czekamy na listę, tu na jedno konkretne miejsce.
598
624
  */
599
625
  protected readonly resolving: _angular_core.WritableSignal<boolean>;
600
- /** 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ą. */
601
627
  private pending;
602
- /** 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. */
603
629
  protected readonly searched: _angular_core.WritableSignal<boolean>;
604
630
  protected readonly open: _angular_core.WritableSignal<boolean>;
605
631
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
606
- /** 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. */
607
633
  protected readonly tooShort: _angular_core.Signal<boolean>;
608
634
  protected readonly hasPanel: _angular_core.Signal<boolean>;
609
- /** 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. */
610
636
  protected readonly busy: _angular_core.Signal<boolean>;
637
+ /** Panel pokazuje listę (a nie notę) - tylko wtedy `aria-controls` ma na co wskazać. */
638
+ protected readonly listShown: _angular_core.Signal<boolean>;
611
639
  protected readonly canSearch: _angular_core.Signal<boolean>;
612
- /** 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. */
613
641
  private readonly unresolved;
614
- /** 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ć. */
615
643
  protected readonly status: _angular_core.Signal<string>;
616
644
  protected readonly placeholderText: _angular_core.Signal<string>;
617
645
  constructor();
@@ -621,7 +649,7 @@ declare class KptMapSearch {
621
649
  * Debounce stoi na `setTimeout`, a nie na operatorach rxjs: porty tego pakietu używają
622
650
  * wyłącznie `Observable`/`of`, a rxjs nie jest zadeklarowany jako `peerDependency`
623
651
  * biblioteki (wchodzi tranzytywnie przez `@angular/core`). `onCleanup` kasuje zarówno
624
- * niewystrzelony timer, jak i zapytanie w locie — adapter Nominatim przerywa wtedy
652
+ * niewystrzelony timer, jak i zapytanie w locie - adapter Nominatim przerywa wtedy
625
653
  * `fetch` własnym `AbortController`.
626
654
  */
627
655
  private watchTerm;
@@ -631,33 +659,33 @@ declare class KptMapSearch {
631
659
  protected onFocus(): void;
632
660
  protected onBlur(): void;
633
661
  /**
634
- * 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 -
635
663
  * dla Nominatima i każdego geokodera pytanego wprost nic się nie zmienia.
636
664
  *
637
665
  * Podpowiedź bez `at` (Google Places Autocomplete) trzeba najpierw uzupełnić: jedno
638
666
  * wywołanie `resolve()` na *wybór*, nigdy w trakcie pisania. Panel zostaje otwarty
639
- * 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.
640
668
  */
641
669
  protected pick(suggestion: KptMapSuggestion): void;
642
670
  private applyResolved;
643
671
  protected clear(): void;
644
672
  protected onKeydown(event: KeyboardEvent): void;
645
673
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMapSearch, never>;
646
- 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>;
647
675
  }
648
676
 
649
677
  /**
650
- * Treść dialogu „dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
678
+ * Treść dialogu "dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
651
679
  *
652
- * 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>`,
653
681
  * a ścieżki walidatorów trzeba rzutować. Reszta kontraktu Signal Forms zostaje bez zmian:
654
- * walidatory deklarujemy raz, a bramka „nie strasz czerwienią" siedzi w prezentacji.
682
+ * walidatory deklarujemy raz, a bramka "nie strasz czerwienią" siedzi w prezentacji.
655
683
  */
656
684
  declare class KptMapCreateDialog {
657
685
  readonly category: _angular_core.InputSignal<KptMapCategory>;
658
686
  readonly at: _angular_core.InputSignal<KptLatLng>;
659
687
  /**
660
- * 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
661
689
  * tędy port swojej mapy, bo geokoder jest per mapa, a nie per aplikacja.
662
690
  */
663
691
  readonly geocoder: _angular_core.InputSignal<KptMapGeocoderPort | null>;
@@ -665,11 +693,11 @@ declare class KptMapCreateDialog {
665
693
  readonly cancelled: _angular_core.OutputEmitterRef<void>;
666
694
  protected readonly i18n: KptI18n;
667
695
  private readonly injector;
668
- /** Opcjonalny — wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
696
+ /** Opcjonalny - wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
669
697
  private readonly injectedGeocoder;
670
698
  /** Rozstrzygnięty port: wejście przed DI. Bez obu formularz po prostu nie podpowiada adresu. */
671
699
  private readonly port;
672
- /** Trwa zapytanie do geokodera — szablon pokazuje wtedy notkę zamiast ciszy. */
700
+ /** Trwa zapytanie do geokodera - szablon pokazuje wtedy notkę zamiast ciszy. */
673
701
  protected readonly geocoding: WritableSignal<boolean>;
674
702
  /** Ostatnio ustalony adres; `label` bywa czytelniejszy niż suma pól. */
675
703
  protected readonly address: WritableSignal<KptMapAddress | null>;
@@ -680,12 +708,12 @@ declare class KptMapCreateDialog {
680
708
  * Model i formularz dla aktualnej kategorii. Budowane w efekcie, nie w `computed()`,
681
709
  * bo `form()` zakłada dwie rzeczy, których ciało `computed()` nie spełnia:
682
710
  *
683
- * - wstrzykuje sobie zależności → stąd `runInInjectionContext`;
711
+ * - wstrzykuje sobie zależności -> stąd `runInInjectionContext`;
684
712
  * - zakłada własny `effect()`, a tego nie wolno tworzyć w kontekście reaktywnym
685
- * (NG0602) → stąd `untracked`, które zdejmuje aktywnego konsumenta.
713
+ * (NG0602) -> stąd `untracked`, które zdejmuje aktywnego konsumenta.
686
714
  *
687
715
  * Zależność od `fields()` zostaje śledzona na zewnątrz `untracked`, więc zmiana
688
- * 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
689
717
  * wiąże schemę tylko raz, przy tworzeniu.
690
718
  */
691
719
  private readonly built;
@@ -693,7 +721,7 @@ declare class KptMapCreateDialog {
693
721
  /**
694
722
  * Podpowiada adres z geokodowania wstecznego współrzędnych kliknięcia.
695
723
  *
696
- * 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 -
697
725
  * podpowiedź nigdy nie kasuje tego, co użytkownik zdążył wpisać. Brak portu
698
726
  * `KPT_MAP_GEOCODER` albo nieudane zapytanie to nie błąd: pola zostają puste.
699
727
  */
@@ -701,20 +729,20 @@ declare class KptMapCreateDialog {
701
729
  /** `null` tylko między utworzeniem komponentu a pierwszym przebiegiem efektu. */
702
730
  protected readonly formRoot: _angular_core.Signal<_angular_forms_signals.FieldTree<Record<string, unknown>, string | number, "writable"> | null>;
703
731
  protected readonly formInvalid: _angular_core.Signal<boolean>;
704
- /** Kontrolka pola po kluczu — szablon podaje ją do `[formField]`. */
732
+ /** Kontrolka pola po kluczu - szablon podaje ją do `[formField]`. */
705
733
  protected fieldOf(key: string): unknown;
706
- /** Komunikat pokazujemy dopiero po dotknięciu pola — bramka żyje w prezentacji. */
734
+ /** Komunikat pokazujemy dopiero po dotknięciu pola - bramka żyje w prezentacji. */
707
735
  protected errorOf(key: string): string | null;
708
736
  /**
709
737
  * Dzień otwarty musi mieć obie godziny i różne od siebie. Dzień oznaczony jako
710
- * 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.
711
739
  */
712
740
  private hoursError;
713
741
  protected optionsOf(def: KptMapFieldDef): KptOption<unknown>[];
714
742
  protected controlId(def: KptMapFieldDef): string;
715
743
  /** Czy pole renderuje jeden `<input>`, na który może wskazać `label[for]`. */
716
744
  protected hasOwnInput(def: KptMapFieldDef): boolean;
717
- /** 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ć. */
718
746
  protected readonly coords: _angular_core.Signal<{
719
747
  lat: string;
720
748
  lng: string;
@@ -730,7 +758,7 @@ interface ContactRow {
730
758
  icon: string;
731
759
  /** Tekst pokazywany użytkownikowi. */
732
760
  text: string;
733
- /** 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. */
734
762
  copyValue: string;
735
763
  /** `href` akcji właściwej; `null` dla współrzędnych (nie ma dokąd prowadzić). */
736
764
  href: string | null;
@@ -740,14 +768,14 @@ interface ContactRow {
740
768
  actionLabel: string;
741
769
  }
742
770
  /**
743
- * 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,
744
772
  * rozwijane godziny otwarcia i wiersze kontaktowe z kopiowaniem.
745
773
  *
746
774
  * Komponent jest sterowany danymi: bierze `KptMapPoi`, a nie model domenowy aplikacji.
747
- * Mapowanie `KptMapLocation.data` → `KptMapPoi` robi aplikacja, dzięki czemu karta nie
775
+ * Mapowanie `KptMapLocation.data` -> `KptMapPoi` robi aplikacja, dzięki czemu karta nie
748
776
  * wie nic o tym, czy pokazuje ładowarkę, restaurację, czy punkt serwisowy.
749
777
  *
750
- * 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
751
779
  * dostanie 20 rem szerokości i padding przeznaczony dla treści tekstowej.
752
780
  *
753
781
  * @example
@@ -783,10 +811,10 @@ declare class KptMapPoiCard {
783
811
  protected readonly i18n: KptI18n;
784
812
  /** Identyfikator regionu godzin; kart na stronie bywa więcej niż jedna. */
785
813
  protected readonly hoursId: string;
786
- /** 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. */
787
815
  private readonly now;
788
816
  /**
789
- * 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
790
818
  * `foregroundVarOf()`, a nie `colorVarOf()`: rola `muted` ma kolor tła, nie treści.
791
819
  */
792
820
  protected readonly categoryColor: _angular_core.Signal<string | null>;
@@ -796,10 +824,10 @@ declare class KptMapPoiCard {
796
824
  protected readonly open: _angular_core.Signal<boolean>;
797
825
  protected readonly hoursGroups: _angular_core.Signal<KptMapHoursGroup[]>;
798
826
  protected readonly statusLabel: _angular_core.Signal<string>;
799
- /** 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. */
800
828
  protected readonly statusHint: _angular_core.Signal<string | null>;
801
829
  protected readonly rows: _angular_core.Signal<ContactRow[]>;
802
- /** 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". */
803
831
  protected readonly justCopied: _angular_core.WritableSignal<string | null>;
804
832
  private copyTimer;
805
833
  /** Bez API schowka przycisk kopiowania w ogóle się nie renderuje. */
@@ -820,7 +848,7 @@ declare class KptMapPoiCard {
820
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>;
821
849
  }
822
850
 
823
- /** 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. */
824
852
  interface HoursRow {
825
853
  day: KptMapWeekday;
826
854
  name: string;
@@ -831,10 +859,10 @@ interface HoursRow {
831
859
  }[];
832
860
  }
833
861
  /**
834
- * Pole „godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
862
+ * Pole "godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
835
863
  *
836
- * Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem „zamknięte".
837
- * 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
838
866
  * najczęstszy przypadek, a bez niego wypełnienie formularza to czternaście pól.
839
867
  *
840
868
  * Nazwy dni idą z `Intl`, nie ze słownika `KptMessages`: rozkład tygodnia jest
@@ -850,7 +878,7 @@ declare class KptMapHoursField implements FormValueControl<KptMapOpeningHours> {
850
878
  protected readonly i18n: KptI18n;
851
879
  protected readonly maxRanges = 2;
852
880
  protected readonly minuteStep = 5;
853
- /** 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. */
854
882
  readonly sameAllWeek: _angular_core.ModelSignal<boolean>;
855
883
  protected readonly rows: _angular_core.Signal<HoursRow[]>;
856
884
  /** Dni poza poniedziałkiem są zablokowane, gdy tydzień jest jednakowy. */
@@ -862,20 +890,20 @@ declare class KptMapHoursField implements FormValueControl<KptMapOpeningHours> {
862
890
  protected removeRange(row: HoursRow, index: number): void;
863
891
  /** Zmiana jednego dnia; przy jednakowym tygodniu poniedziałek rozlewa się na resztę. */
864
892
  private patch;
865
- /** 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. */
866
894
  private write;
867
895
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMapHoursField, never>;
868
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>;
869
897
  }
870
898
 
871
899
  /**
872
- * Pole „zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
900
+ * Pole "zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
873
901
  *
874
902
  * Wartością jest zawsze **string**: albo `data:` z wybranego pliku, albo adres wklejony
875
903
  * przez użytkownika. Karta miejsca nie rozróżnia jednego od drugiego, więc formularz
876
904
  * nie musi decydować za aplikację, gdzie zdjęcia mieszkają.
877
905
  *
878
- * 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
879
907
  * mieć wiedzy o storage'u aplikacji.
880
908
  */
881
909
  declare class KptMapImageField implements FormValueControl<string> {
@@ -903,7 +931,7 @@ declare class KptMapImageField implements FormValueControl<string> {
903
931
  }
904
932
 
905
933
  /**
906
- * 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
907
935
  * potrzebuje własnego obiektu, a provider jest jeden.
908
936
  */
909
937
  declare const KPT_MAP_ENGINE: InjectionToken<KptMapEngineFactory>;
@@ -917,9 +945,9 @@ declare const KPT_MAP_ENGINE: InjectionToken<KptMapEngineFactory>;
917
945
  */
918
946
  declare function provideKptLeafletMap(options?: KptLeafletOptions): Provider[];
919
947
  /**
920
- * Silnik Google Maps. Nie wymaga żadnej paczki npm — API dogrywa się skryptem przy pierwszej
921
- * mapie — ale wymaga klucza, konta rozliczeniowego i **`mapId`** z konsoli Google
922
- * (*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ą.
923
951
  *
924
952
  * Różnice wobec Leafleta: `[tileUrl]` i `[attribution]` są bez znaczenia (kafle i atrybucję
925
953
  * dostarcza Google i nie wolno ich zasłonić), wczytanie mapy liczy się do SKU Dynamic Maps
@@ -936,7 +964,7 @@ declare function provideKptLeafletMap(options?: KptLeafletOptions): Provider[];
936
964
  declare function provideKptGoogleMap(options: KptGoogleOptions): Provider[];
937
965
 
938
966
  /**
939
- * Ź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
940
968
  * temu Storybook i testy podstawiają stałą pozycję zamiast pytać przeglądarkę o zgodę.
941
969
  */
942
970
  interface KptMapGeolocationPort {
@@ -947,7 +975,7 @@ interface KptMapGeolocationPort {
947
975
  watch(options?: PositionOptions): Observable<KptMapUserPosition | null>;
948
976
  }
949
977
  declare const KPT_MAP_GEOLOCATION: InjectionToken<KptMapGeolocationPort>;
950
- /** Błąd geolokalizacji rozpoznany po kodzie — rzucany strumieniem, nie wyjątkiem. */
978
+ /** Błąd geolokalizacji rozpoznany po kodzie - rzucany strumieniem, nie wyjątkiem. */
951
979
  declare class KptMapGeolocationFailure extends Error {
952
980
  readonly detail: KptMapGeolocationError;
953
981
  constructor(detail: KptMapGeolocationError);
@@ -956,12 +984,12 @@ declare class KptMapGeolocationFailure extends Error {
956
984
  * Domyślna implementacja na `navigator.geolocation.watchPosition`.
957
985
  *
958
986
  * Uwaga: Geolocation API działa wyłącznie w bezpiecznym kontekście (HTTPS albo
959
- * `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.
960
988
  */
961
989
  declare class KptBrowserGeolocation implements KptMapGeolocationPort {
962
990
  watch(options?: PositionOptions): Observable<KptMapUserPosition | null>;
963
991
  }
964
- /** Stała pozycja — Storybook, testy, demo bez pytania o zgodę. */
992
+ /** Stała pozycja - Storybook, testy, demo bez pytania o zgodę. */
965
993
  declare class KptMapGeolocationStub implements KptMapGeolocationPort {
966
994
  private readonly at;
967
995
  private readonly accuracy;