@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.
- package/CHANGELOG.md +792 -333
- package/README.md +111 -55
- package/charts/src/lib/llms.txt +23 -15
- package/chat/src/lib/llms.txt +68 -33
- package/fesm2022/konce-pt-angular-charts.mjs +149 -68
- package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-chat.mjs +296 -135
- package/fesm2022/konce-pt-angular-chat.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-grid.mjs +16 -16
- package/fesm2022/konce-pt-angular-grid.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-icons.mjs +5 -5
- package/fesm2022/konce-pt-angular-icons.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-map.mjs +360 -293
- package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-roadmap.mjs +120 -34
- package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
- package/fesm2022/konce-pt-angular.mjs +7117 -3373
- package/fesm2022/konce-pt-angular.mjs.map +1 -1
- package/grid/src/lib/llms.txt +18 -18
- package/map/src/lib/llms.txt +142 -140
- package/package.json +14 -12
- package/roadmap/src/lib/llms.txt +37 -27
- package/src/lib/accordion/llms.txt +18 -6
- package/src/lib/alert/llms.txt +5 -4
- package/src/lib/app-shell/llms.txt +25 -22
- package/src/lib/auth/llms.txt +26 -22
- package/src/lib/autocomplete/llms.txt +18 -4
- package/src/lib/avatar/llms.txt +3 -3
- package/src/lib/avatar-group/llms.txt +5 -5
- package/src/lib/backdrop/llms.txt +35 -35
- package/src/lib/badge/llms.txt +7 -7
- package/src/lib/bottom-sheet/llms.txt +6 -3
- package/src/lib/breadcrumb/llms.txt +9 -1
- package/src/lib/breakpoint/llms.txt +8 -8
- package/src/lib/button/llms.txt +26 -18
- package/src/lib/button-group/llms.txt +40 -31
- package/src/lib/card/llms.txt +19 -19
- package/src/lib/carousel/llms.txt +6 -6
- package/src/lib/checkbox/llms.txt +17 -2
- package/src/lib/chip/llms.txt +6 -6
- package/src/lib/chips-input/llms.txt +14 -4
- package/src/lib/color-picker/llms.txt +7 -4
- package/src/lib/confirm/llms.txt +9 -3
- package/src/lib/context-menu/llms.txt +7 -4
- package/src/lib/data-table/llms.txt +280 -227
- package/src/lib/data-view/llms.txt +25 -4
- package/src/lib/date-range/llms.txt +37 -18
- package/src/lib/datepicker/llms.txt +46 -29
- package/src/lib/dialog/llms.txt +29 -26
- package/src/lib/divider/llms.txt +2 -1
- package/src/lib/drawer/llms.txt +9 -6
- package/src/lib/empty/llms.txt +4 -4
- package/src/lib/fab/llms.txt +6 -2
- package/src/lib/fieldset/llms.txt +22 -4
- package/src/lib/file-upload/llms.txt +3 -0
- package/src/lib/form-field/llms.txt +33 -19
- package/src/lib/galleria/llms.txt +3 -3
- package/src/lib/i18n/llms.txt +15 -8
- package/src/lib/icon/llms.txt +9 -9
- package/src/lib/icon-button/llms.txt +8 -3
- package/src/lib/image/llms.txt +4 -4
- package/src/lib/input/llms.txt +21 -7
- package/src/lib/input-mask/llms.txt +5 -2
- package/src/lib/input-number/llms.txt +18 -15
- package/src/lib/input-otp/llms.txt +15 -4
- package/src/lib/knob/llms.txt +14 -7
- package/src/lib/listbox/llms.txt +8 -5
- package/src/lib/loader/llms.txt +72 -0
- package/src/lib/megamenu/llms.txt +16 -5
- package/src/lib/mention/llms.txt +15 -15
- package/src/lib/menu/llms.txt +12 -12
- package/src/lib/menubar/llms.txt +16 -5
- package/src/lib/meter-group/llms.txt +7 -7
- package/src/lib/order-list/llms.txt +20 -5
- package/src/lib/paginator/llms.txt +5 -5
- package/src/lib/panel/llms.txt +20 -8
- package/src/lib/password/llms.txt +17 -5
- package/src/lib/peek/llms.txt +11 -11
- package/src/lib/pick-list/llms.txt +28 -5
- package/src/lib/popover/llms.txt +9 -6
- package/src/lib/progress/llms.txt +16 -16
- package/src/lib/radio-group/llms.txt +13 -3
- package/src/lib/rating/llms.txt +13 -6
- package/src/lib/rich-text/llms.txt +42 -24
- package/src/lib/scroll-top/llms.txt +3 -3
- package/src/lib/select/llms.txt +23 -13
- package/src/lib/sidenav/llms.txt +8 -8
- package/src/lib/slider/llms.txt +23 -7
- package/src/lib/speech/llms.txt +108 -0
- package/src/lib/speed-dial/llms.txt +9 -3
- package/src/lib/spinner/llms.txt +2 -2
- package/src/lib/split-button/llms.txt +14 -8
- package/src/lib/splitter/llms.txt +8 -8
- package/src/lib/stepper/llms.txt +26 -7
- package/src/lib/switch/llms.txt +13 -3
- package/src/lib/switch-group/llms.txt +12 -9
- package/src/lib/tabs/llms.txt +7 -4
- package/src/lib/textarea/llms.txt +16 -5
- package/src/lib/timeline/llms.txt +1 -1
- package/src/lib/toast/llms.txt +36 -5
- package/src/lib/toolbar/llms.txt +3 -3
- package/src/lib/tooltip/llms.txt +13 -10
- package/src/lib/tree/llms.txt +19 -5
- package/src/lib/update/llms.txt +52 -0
- package/types/konce-pt-angular-charts.d.ts +11 -0
- package/types/konce-pt-angular-charts.d.ts.map +1 -1
- package/types/konce-pt-angular-chat.d.ts +98 -40
- package/types/konce-pt-angular-chat.d.ts.map +1 -1
- package/types/konce-pt-angular-grid.d.ts +14 -14
- package/types/konce-pt-angular-icons.d.ts +3 -3
- package/types/konce-pt-angular-map.d.ts +147 -119
- package/types/konce-pt-angular-map.d.ts.map +1 -1
- package/types/konce-pt-angular-roadmap.d.ts +34 -9
- package/types/konce-pt-angular-roadmap.d.ts.map +1 -1
- package/types/konce-pt-angular.d.ts +1774 -651
- 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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
117
|
-
* przed jej powstaniem dalej się kompilowały
|
|
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
|
|
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
|
|
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
|
|
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**
|
|
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
|
|
160
|
+
* sekundowa zwłoka jest różnicą między "działa" a "zacina się".
|
|
161
161
|
*
|
|
162
|
-
* `0` zdejmuje też kolejkowanie
|
|
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
|
|
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
|
|
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()`
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
243
|
-
* w
|
|
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
|
|
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
|
|
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<"
|
|
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)
|
|
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
|
|
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()`**
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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ć
|
|
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
|
|
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
|
|
454
|
+
/** Kategorie oferowane w menu "dodaj" - ukryte w legendzie odpadają. */
|
|
440
455
|
protected readonly creatableCategories: _angular_core.Signal<KptMapCategory[]>;
|
|
441
|
-
/** Czy jest czym szukać
|
|
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
|
-
*
|
|
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
|
|
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
|
|
495
|
+
/** Gotowa referencja dla kontekstu szablonu - szablon nie ma jak zrobić `bind`. */
|
|
480
496
|
protected readonly closePopupFn: () => void;
|
|
481
|
-
/** Pozycja z grupy nierozdzielalnej
|
|
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]`
|
|
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
|
|
510
|
+
/** Wraca do widoku startowego - po zabłądzeniu na drugim końcu świata. */
|
|
495
511
|
protected resetView(): void;
|
|
496
|
-
/** Zasięg wszystkich widocznych lokalizacji
|
|
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
|
|
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 }`
|
|
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
|
|
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ć
|
|
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()`**
|
|
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)
|
|
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
|
-
*
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
640
|
+
/** Nie udało się ustalić miejsca wybranej podpowiedzi - komunikat zamiast cichej ciszy. */
|
|
613
641
|
private readonly unresolved;
|
|
614
|
-
/** Komunikat dla `aria-live`
|
|
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
|
|
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
|
|
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
|
|
678
|
+
* Treść dialogu "dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
|
|
651
679
|
*
|
|
652
|
-
* Przy dynamicznej schemie typowanie pól znika
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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ń
|
|
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
|
|
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
|
|
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
|
|
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`
|
|
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'"`
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
837
|
-
* Skrót
|
|
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
|
|
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ń
|
|
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
|
|
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
|
|
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
|
|
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
|
|
921
|
-
* mapie
|
|
922
|
-
* (*Map management
|
|
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`
|
|
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
|
|
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
|
|
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
|
|
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;
|