@konce-pt/angular 0.12.0 → 0.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +591 -369
- package/README.md +111 -55
- package/charts/src/lib/llms.txt +17 -17
- package/chat/src/lib/llms.txt +61 -35
- package/fesm2022/konce-pt-angular-charts.mjs +11 -11
- package/fesm2022/konce-pt-angular-charts.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-chat.mjs +236 -127
- 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 +308 -280
- package/fesm2022/konce-pt-angular-map.mjs.map +1 -1
- package/fesm2022/konce-pt-angular-roadmap.mjs +23 -23
- package/fesm2022/konce-pt-angular-roadmap.mjs.map +1 -1
- package/fesm2022/konce-pt-angular.mjs +4410 -2128
- package/fesm2022/konce-pt-angular.mjs.map +1 -1
- package/grid/src/lib/llms.txt +18 -18
- package/map/src/lib/llms.txt +142 -141
- package/package.json +14 -12
- package/roadmap/src/lib/llms.txt +27 -27
- package/src/lib/accordion/llms.txt +18 -6
- package/src/lib/alert/llms.txt +5 -5
- package/src/lib/app-shell/llms.txt +23 -21
- package/src/lib/auth/llms.txt +22 -22
- package/src/lib/autocomplete/llms.txt +15 -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 +4 -4
- package/src/lib/breadcrumb/llms.txt +2 -2
- package/src/lib/breakpoint/llms.txt +8 -8
- package/src/lib/button/llms.txt +26 -18
- package/src/lib/button-group/llms.txt +37 -31
- package/src/lib/card/llms.txt +19 -19
- package/src/lib/carousel/llms.txt +6 -6
- package/src/lib/checkbox/llms.txt +15 -3
- package/src/lib/chip/llms.txt +6 -6
- package/src/lib/chips-input/llms.txt +11 -4
- package/src/lib/color-picker/llms.txt +4 -4
- package/src/lib/confirm/llms.txt +5 -5
- package/src/lib/context-menu/llms.txt +4 -4
- package/src/lib/data-table/llms.txt +280 -239
- package/src/lib/data-view/llms.txt +25 -4
- package/src/lib/date-range/llms.txt +27 -27
- package/src/lib/datepicker/llms.txt +34 -34
- package/src/lib/dialog/llms.txt +27 -27
- package/src/lib/divider/llms.txt +2 -2
- package/src/lib/drawer/llms.txt +7 -7
- 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 +1 -1
- package/src/lib/form-field/llms.txt +33 -19
- package/src/lib/galleria/llms.txt +3 -3
- package/src/lib/i18n/llms.txt +9 -9
- package/src/lib/icon/llms.txt +8 -8
- 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 +2 -2
- package/src/lib/input-number/llms.txt +14 -14
- package/src/lib/input-otp/llms.txt +6 -6
- package/src/lib/knob/llms.txt +11 -6
- package/src/lib/listbox/llms.txt +6 -6
- package/src/lib/loader/llms.txt +72 -0
- package/src/lib/megamenu/llms.txt +7 -7
- package/src/lib/mention/llms.txt +15 -15
- package/src/lib/menu/llms.txt +12 -12
- package/src/lib/menubar/llms.txt +7 -7
- package/src/lib/meter-group/llms.txt +7 -7
- package/src/lib/order-list/llms.txt +18 -6
- package/src/lib/paginator/llms.txt +5 -5
- package/src/lib/panel/llms.txt +20 -8
- package/src/lib/password/llms.txt +14 -6
- package/src/lib/peek/llms.txt +10 -10
- package/src/lib/pick-list/llms.txt +26 -6
- package/src/lib/popover/llms.txt +7 -7
- package/src/lib/progress/llms.txt +16 -16
- package/src/lib/radio-group/llms.txt +10 -3
- package/src/lib/rating/llms.txt +13 -6
- package/src/lib/rich-text/llms.txt +34 -29
- package/src/lib/scroll-top/llms.txt +3 -3
- package/src/lib/select/llms.txt +20 -13
- package/src/lib/sidenav/llms.txt +8 -8
- package/src/lib/slider/llms.txt +21 -8
- 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 +24 -8
- package/src/lib/switch/llms.txt +10 -3
- package/src/lib/switch-group/llms.txt +10 -10
- package/src/lib/tabs/llms.txt +5 -5
- package/src/lib/textarea/llms.txt +16 -5
- package/src/lib/timeline/llms.txt +1 -1
- package/src/lib/toast/llms.txt +33 -5
- package/src/lib/toolbar/llms.txt +3 -3
- package/src/lib/tooltip/llms.txt +10 -10
- package/src/lib/tree/llms.txt +19 -6
- package/src/lib/update/llms.txt +52 -0
- package/types/konce-pt-angular-charts.d.ts +2 -2
- package/types/konce-pt-angular-chat.d.ts +87 -44
- 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 +137 -121
- package/types/konce-pt-angular-map.d.ts.map +1 -1
- package/types/konce-pt-angular-roadmap.d.ts +13 -13
- package/types/konce-pt-angular.d.ts +1383 -625
- 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>;
|
|
@@ -291,18 +291,18 @@ declare class KptMap<T = unknown> {
|
|
|
291
291
|
readonly clusterColorBy: _angular_core.InputSignal<"none" | "dominant">;
|
|
292
292
|
/** Renderuje legendę pod mapą. Wyłącz, jeśli chcesz ją umieścić gdzie indziej. */
|
|
293
293
|
readonly legend: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
294
|
-
/** Identyfikatory ukrytych kategorii (dwukierunkowe)
|
|
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>>;
|
|
@@ -377,7 +383,7 @@ declare class KptMap<T = unknown> {
|
|
|
377
383
|
readonly userPositionChange: _angular_core.OutputEmitterRef<KptMapUserPosition | null>;
|
|
378
384
|
readonly userLocationError: _angular_core.OutputEmitterRef<KptMapGeolocationError>;
|
|
379
385
|
/**
|
|
380
|
-
* Silnika nie udało się uruchomić
|
|
386
|
+
* Silnika nie udało się uruchomić - brak fabryki, brak paczki `leaflet`, odrzucony klucz Google.
|
|
381
387
|
* Bez słuchacza błąd ląduje w konsoli; ze słuchaczem aplikacja może pokazać własny komunikat.
|
|
382
388
|
*/
|
|
383
389
|
readonly engineError: _angular_core.OutputEmitterRef<unknown>;
|
|
@@ -386,7 +392,7 @@ declare class KptMap<T = unknown> {
|
|
|
386
392
|
/** Opcjonalny, bo silnik może przyjść wejściem `[engine]` zamiast z DI. */
|
|
387
393
|
private readonly engineFactory;
|
|
388
394
|
private readonly geolocation;
|
|
389
|
-
/** Opcjonalny
|
|
395
|
+
/** Opcjonalny - wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
|
|
390
396
|
private readonly injectedGeocoder;
|
|
391
397
|
private readonly destroyRef;
|
|
392
398
|
private readonly injector;
|
|
@@ -397,7 +403,7 @@ declare class KptMap<T = unknown> {
|
|
|
397
403
|
private readonly popupTemplates;
|
|
398
404
|
protected readonly createFormTemplate: _angular_core.Signal<KptMapCreateFormTemplate | undefined>;
|
|
399
405
|
private mapEngine;
|
|
400
|
-
/** Komponent zniszczony
|
|
406
|
+
/** Komponent zniszczony - `initEngine()` po `await` nie może już podpinać zdarzeń ani obserwatorów. */
|
|
401
407
|
private destroyed;
|
|
402
408
|
/** Trwający montaż silnika; zniszczenie czeka na jego koniec (patrz konstruktor). */
|
|
403
409
|
private engineInit;
|
|
@@ -405,7 +411,7 @@ declare class KptMap<T = unknown> {
|
|
|
405
411
|
protected readonly ready: _angular_core.WritableSignal<boolean>;
|
|
406
412
|
/** Zoom trzymamy w sygnale, bo od niego zależy wynik grupowania. */
|
|
407
413
|
private readonly zoom;
|
|
408
|
-
/** Rośnie przy każdym ruchu mapy
|
|
414
|
+
/** Rośnie przy każdym ruchu mapy - wymusza przeliczenie pozycji popupu. */
|
|
409
415
|
private readonly viewportTick;
|
|
410
416
|
protected readonly popup: _angular_core.WritableSignal<PopupState<T> | null>;
|
|
411
417
|
protected readonly contextTarget: _angular_core.WritableSignal<{
|
|
@@ -418,47 +424,47 @@ declare class KptMap<T = unknown> {
|
|
|
418
424
|
} | null>;
|
|
419
425
|
protected readonly createOpen: _angular_core.WritableSignal<boolean>;
|
|
420
426
|
protected readonly userPosition: _angular_core.WritableSignal<KptMapUserPosition | null>;
|
|
421
|
-
/** Ostatni wybrany wynik wyszukiwania
|
|
427
|
+
/** Ostatni wybrany wynik wyszukiwania - źródło tymczasowej pinezki. */
|
|
422
428
|
protected readonly searchPin: _angular_core.WritableSignal<KptMapSearchResult | null>;
|
|
423
429
|
protected readonly locationBlocked: _angular_core.WritableSignal<boolean>;
|
|
424
430
|
private readonly categoryById;
|
|
425
431
|
/** Lokalizacje po odfiltrowaniu kategorii ukrytych w legendzie. */
|
|
426
432
|
private readonly visibleLocations;
|
|
427
433
|
protected readonly counts: _angular_core.Signal<Record<string, number> | null>;
|
|
428
|
-
/** Wynik grupowania dla aktualnego zoomu
|
|
434
|
+
/** Wynik grupowania dla aktualnego zoomu - grupy i punkty pojedyncze. */
|
|
429
435
|
private readonly entries;
|
|
430
436
|
/** Znaczniki gotowe dla silnika. HTML powstaje w rdzeniu, poza Angularem. */
|
|
431
437
|
private readonly markers;
|
|
432
|
-
/** Szablon popupu dla kategorii; bez dopasowania
|
|
438
|
+
/** Szablon popupu dla kategorii; bez dopasowania - szablon zapasowy (bez `category`). */
|
|
433
439
|
private readonly popupTemplateFor;
|
|
434
440
|
protected readonly popupTemplate: _angular_core.Signal<KptMapPopupTemplate<T> | null>;
|
|
435
441
|
protected readonly popupCategory: _angular_core.Signal<KptMapCategory | undefined>;
|
|
436
442
|
/**
|
|
437
443
|
* Odległość otwartego punktu od `distanceFrom` (albo od użytkownika) w metrach.
|
|
438
|
-
* `null`, gdy nie ma od czego liczyć
|
|
444
|
+
* `null`, gdy nie ma od czego liczyć - szablon chowa wtedy wiersz dystansu,
|
|
439
445
|
* zamiast pokazywać zero.
|
|
440
446
|
*/
|
|
441
447
|
protected readonly popupDistance: _angular_core.Signal<number | null>;
|
|
442
448
|
/**
|
|
443
449
|
* Pozycja popupu w pikselach kontenera. Zależy od `viewportTick`, więc przelicza się
|
|
444
|
-
* przy każdym ruchu mapy
|
|
450
|
+
* przy każdym ruchu mapy - jeden sygnał zamiast nasłuchu w szablonie.
|
|
445
451
|
*/
|
|
446
452
|
protected readonly popupPosition: _angular_core.Signal<KptMapPoint | null>;
|
|
447
453
|
protected readonly contextPosition: _angular_core.Signal<KptMapPoint | null>;
|
|
448
|
-
/** Kategorie oferowane w menu
|
|
454
|
+
/** Kategorie oferowane w menu "dodaj" - ukryte w legendzie odpadają. */
|
|
449
455
|
protected readonly creatableCategories: _angular_core.Signal<KptMapCategory[]>;
|
|
450
|
-
/** Czy jest czym szukać
|
|
456
|
+
/** Czy jest czym szukać - port bez `search()` nie zasługuje na pole, które nic nie robi. */
|
|
451
457
|
protected readonly searchEnabled: _angular_core.Signal<boolean>;
|
|
452
458
|
/**
|
|
453
|
-
* Prostokąt preferowanych wyników. Bierzemy zasięg jawny, a bez niego preset kraju
|
|
454
|
-
*
|
|
459
|
+
* Prostokąt preferowanych wyników. Bierzemy zasięg jawny, a bez niego preset kraju -
|
|
460
|
+
* "Kwiatowa" ma trafiać w tę pod nosem, nie w tę z drugiego końca świata. To sam bias:
|
|
455
461
|
* adresu z zagranicy dalej da się poszukać.
|
|
456
462
|
*/
|
|
457
463
|
protected readonly searchViewbox: _angular_core.Signal<KptMapBounds>;
|
|
458
464
|
/**
|
|
459
465
|
* Twarde zawężenie do krajów. Jawne `searchOptions.countryCodes` wygrywa; bez niego
|
|
460
466
|
* odcinamy zagranicę dopiero przy `restrictToCountry`, bo tam mapa i tak nie pozwoli
|
|
461
|
-
* przesunąć widoku poza kraj
|
|
467
|
+
* przesunąć widoku poza kraj - znaleziony adres byłby nie do pokazania.
|
|
462
468
|
*/
|
|
463
469
|
protected readonly searchCountryCodes: _angular_core.Signal<readonly string[] | null>;
|
|
464
470
|
protected readonly createFormApi: _angular_core.Signal<KptMapCreateFormApi | null>;
|
|
@@ -486,28 +492,28 @@ declare class KptMap<T = unknown> {
|
|
|
486
492
|
* Bez tego znacznik przy górnej krawędzi otwiera popup poza widokiem.
|
|
487
493
|
*/
|
|
488
494
|
private autoPanToPopup;
|
|
489
|
-
/** Gotowa referencja dla kontekstu szablonu
|
|
495
|
+
/** Gotowa referencja dla kontekstu szablonu - szablon nie ma jak zrobić `bind`. */
|
|
490
496
|
protected readonly closePopupFn: () => void;
|
|
491
|
-
/** Pozycja z grupy nierozdzielalnej
|
|
497
|
+
/** Pozycja z grupy nierozdzielalnej - przełącza popup bez ruszania mapy. */
|
|
492
498
|
protected selectFromGroup(location: KptMapLocation<T>): void;
|
|
493
499
|
protected startCreate(category: KptMapCategory): void;
|
|
494
500
|
protected closeCreate(): void;
|
|
495
501
|
protected emitCreate(value: Record<string, unknown>): void;
|
|
496
502
|
/**
|
|
497
503
|
* Przenosi widok na wybrany wynik. Zasięg (miasto, region) wpasowujemy w kadr,
|
|
498
|
-
* a pojedynczy punkt dostaje `[searchZoom]`
|
|
504
|
+
* a pojedynczy punkt dostaje `[searchZoom]` - inaczej każdy adres lądowałby
|
|
499
505
|
* w innym przybliżeniu, zależnym od tego, jak dostawca obrysował budynek.
|
|
500
506
|
*/
|
|
501
507
|
protected onSearchSelect(result: KptMapSearchResult): void;
|
|
502
508
|
protected zoomBy(delta: number): void;
|
|
503
509
|
protected centreOnUser(): void;
|
|
504
|
-
/** Wraca do widoku startowego
|
|
510
|
+
/** Wraca do widoku startowego - po zabłądzeniu na drugim końcu świata. */
|
|
505
511
|
protected resetView(): void;
|
|
506
|
-
/** Zasięg wszystkich widocznych lokalizacji
|
|
512
|
+
/** Zasięg wszystkich widocznych lokalizacji - `null`, gdy nie ma żadnej. */
|
|
507
513
|
protected readonly dataBounds: _angular_core.Signal<KptMapBounds | null>;
|
|
508
514
|
protected fitToData(): void;
|
|
509
515
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMap<any>, never>;
|
|
510
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMap<any>, "kpt-map", never, { "locations": { "alias": "locations"; "required": true; "isSignal": true; }; "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "country": { "alias": "country"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "restrictToCountry": { "alias": "restrictToCountry"; "required": false; "isSignal": true; }; "bounds": { "alias": "bounds"; "required": false; "isSignal": true; }; "cluster": { "alias": "cluster"; "required": false; "isSignal": true; }; "clusterOptions": { "alias": "clusterOptions"; "required": false; "isSignal": true; }; "clusterColorBy": { "alias": "clusterColorBy"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "hiddenCategories": { "alias": "hiddenCategories"; "required": false; "isSignal": true; }; "legendCounts": { "alias": "legendCounts"; "required": false; "isSignal": true; }; "showUserLocation": { "alias": "showUserLocation"; "required": false; "isSignal": true; }; "followUser": { "alias": "followUser"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchOptions": { "alias": "searchOptions"; "required": false; "isSignal": true; }; "searchZoom": { "alias": "searchZoom"; "required": false; "isSignal": true; }; "searchMarker": { "alias": "searchMarker"; "required": false; "isSignal": true; }; "popupLayout": { "alias": "popupLayout"; "required": false; "isSignal": true; }; "distanceFrom": { "alias": "distanceFrom"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "tileUrl": { "alias": "tileUrl"; "required": false; "isSignal": true; }; "attribution": { "alias": "attribution"; "required": false; "isSignal": true; }; "engine": { "alias": "engine"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "hiddenCategories": "hiddenCategoriesChange"; "locationClick": "locationClick"; "clusterClick": "clusterClick"; "locationCreate": "locationCreate"; "searchSelect": "searchSelect"; "viewChange": "viewChange"; "userPositionChange": "userPositionChange"; "userLocationError": "userLocationError"; "engineError": "engineError"; }, ["popupTemplates", "createFormTemplate"], never, true, never>;
|
|
516
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMap<any>, "kpt-map", never, { "locations": { "alias": "locations"; "required": true; "isSignal": true; }; "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "country": { "alias": "country"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "restrictToCountry": { "alias": "restrictToCountry"; "required": false; "isSignal": true; }; "bounds": { "alias": "bounds"; "required": false; "isSignal": true; }; "cluster": { "alias": "cluster"; "required": false; "isSignal": true; }; "clusterOptions": { "alias": "clusterOptions"; "required": false; "isSignal": true; }; "clusterColorBy": { "alias": "clusterColorBy"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "hiddenCategories": { "alias": "hiddenCategories"; "required": false; "isSignal": true; }; "legendCounts": { "alias": "legendCounts"; "required": false; "isSignal": true; }; "showUserLocation": { "alias": "showUserLocation"; "required": false; "isSignal": true; }; "followUser": { "alias": "followUser"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchOptions": { "alias": "searchOptions"; "required": false; "isSignal": true; }; "searchZoom": { "alias": "searchZoom"; "required": false; "isSignal": true; }; "searchMarker": { "alias": "searchMarker"; "required": false; "isSignal": true; }; "searchSpeech": { "alias": "searchSpeech"; "required": false; "isSignal": true; }; "searchSpeechLang": { "alias": "searchSpeechLang"; "required": false; "isSignal": true; }; "searchSpeechColor": { "alias": "searchSpeechColor"; "required": false; "isSignal": true; }; "popupLayout": { "alias": "popupLayout"; "required": false; "isSignal": true; }; "distanceFrom": { "alias": "distanceFrom"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "tileUrl": { "alias": "tileUrl"; "required": false; "isSignal": true; }; "attribution": { "alias": "attribution"; "required": false; "isSignal": true; }; "engine": { "alias": "engine"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "hiddenCategories": "hiddenCategoriesChange"; "locationClick": "locationClick"; "clusterClick": "clusterClick"; "locationCreate": "locationCreate"; "searchSelect": "searchSelect"; "viewChange": "viewChange"; "userPositionChange": "userPositionChange"; "userLocationError": "userLocationError"; "engineError": "engineError"; }, ["popupTemplates", "createFormTemplate"], never, true, never>;
|
|
511
517
|
}
|
|
512
518
|
|
|
513
519
|
interface LegendEntry {
|
|
@@ -519,7 +525,7 @@ interface LegendEntry {
|
|
|
519
525
|
count: number | null;
|
|
520
526
|
}
|
|
521
527
|
/**
|
|
522
|
-
* Legenda mapy
|
|
528
|
+
* Legenda mapy - lista kategorii ze znacznikiem koloru i ikoną. Pozycje są przyciskami:
|
|
523
529
|
* kliknięcie chowa i pokazuje kategorię (`hidden` dwukierunkowe).
|
|
524
530
|
*
|
|
525
531
|
* `kpt-map` renderuje ją sam pod mapą przy `[legend]="true"`; kto chce ją gdzie indziej,
|
|
@@ -532,10 +538,10 @@ declare class KptMapLegend {
|
|
|
532
538
|
readonly categories: _angular_core.InputSignal<readonly KptMapCategory[]>;
|
|
533
539
|
/** Identyfikatory ukrytych kategorii (dwukierunkowe). */
|
|
534
540
|
readonly hidden: _angular_core.ModelSignal<string[]>;
|
|
535
|
-
/** Opcjonalne liczniki `{ categoryId: liczba }`
|
|
541
|
+
/** Opcjonalne liczniki `{ categoryId: liczba }` - pokazywane przy etykiecie. */
|
|
536
542
|
readonly counts: _angular_core.InputSignal<Record<string, number> | null>;
|
|
537
543
|
readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
|
|
538
|
-
/** Wyłącza chowanie kategorii
|
|
544
|
+
/** Wyłącza chowanie kategorii - legenda staje się czysto informacyjna. */
|
|
539
545
|
readonly interactive: _angular_core.InputSignal<boolean>;
|
|
540
546
|
protected readonly i18n: KptI18n;
|
|
541
547
|
protected readonly entries: _angular_core.Signal<LegendEntry[]>;
|
|
@@ -547,9 +553,9 @@ declare class KptMapLegend {
|
|
|
547
553
|
|
|
548
554
|
/**
|
|
549
555
|
* Wyszukiwarka adresów: pole z podpowiedziami z geokodera. Wynik wyboru leci w `selected`,
|
|
550
|
-
* a co z nim zrobić
|
|
556
|
+
* a co z nim zrobić - decyduje rodzic (`kpt-map` przenosi na niego widok).
|
|
551
557
|
*
|
|
552
|
-
* Wymaga portu `KPT_MAP_GEOCODER` **z metodą `search()`**
|
|
558
|
+
* Wymaga portu `KPT_MAP_GEOCODER` **z metodą `search()`** - biblioteka nie odpytuje cudzego
|
|
553
559
|
* serwera bez zgody aplikacji. Bez portu pole renderuje się wyłączone, zamiast udawać, że
|
|
554
560
|
* coś znajdzie; `kpt-map` idzie dalej i w ogóle go wtedy nie pokazuje.
|
|
555
561
|
*
|
|
@@ -570,13 +576,23 @@ declare class KptMapSearch {
|
|
|
570
576
|
readonly debounce: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
571
577
|
/** Ile podpowiedzi najwyżej. */
|
|
572
578
|
readonly limit: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
573
|
-
/** Zawężenie twarde do krajów (ISO 3166-1 alpha-2)
|
|
579
|
+
/** Zawężenie twarde do krajów (ISO 3166-1 alpha-2) - wyniki spoza nich nie wrócą. */
|
|
574
580
|
readonly countryCodes: _angular_core.InputSignal<readonly string[] | null>;
|
|
575
581
|
/** Preferowany prostokąt wyników. Nie odcina reszty świata, tylko przesuwa ją niżej. */
|
|
576
582
|
readonly viewbox: _angular_core.InputSignal<KptMapBounds | null>;
|
|
577
583
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
578
584
|
/**
|
|
579
|
-
*
|
|
585
|
+
* Mikrofon w polu (Web Speech API): kliknięcie czyści frazę, a jedna podyktowana wypowiedź
|
|
586
|
+
* staje się zapytaniem - z tym samym `debounce` i `minLength` co pisanie. Bez wsparcia
|
|
587
|
+
* przeglądarki się nie pokazuje.
|
|
588
|
+
*/
|
|
589
|
+
readonly speech: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
590
|
+
/** Język dyktowania (BCP 47); bez niego z języka interfejsu. */
|
|
591
|
+
readonly speechLang: _angular_core.InputSignal<string | null>;
|
|
592
|
+
/** Kolor "stop" i fali w trakcie nasłuchu; domyślnie kolor motywu. */
|
|
593
|
+
readonly speechColor: _angular_core.InputSignal<KptSpeechColor>;
|
|
594
|
+
/**
|
|
595
|
+
* Geokoder tego pola. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI - `kpt-map` podaje tędy
|
|
580
596
|
* port swojej mapy, bo geokoder jest per mapa, a nie per aplikacja. Bez niego wszystko
|
|
581
597
|
* działa jak dotąd: port przychodzi z DI.
|
|
582
598
|
*/
|
|
@@ -586,7 +602,7 @@ declare class KptMapSearch {
|
|
|
586
602
|
* pole najpierw uzupełnia przez `resolve()` portu, a dopiero potem emituje.
|
|
587
603
|
*/
|
|
588
604
|
readonly selected: _angular_core.OutputEmitterRef<KptMapSearchResult>;
|
|
589
|
-
/** Pole wyczyszczone
|
|
605
|
+
/** Pole wyczyszczone - rodzic sprząta po sobie (np. chowa tymczasową pinezkę). */
|
|
590
606
|
readonly cleared: _angular_core.OutputEmitterRef<void>;
|
|
591
607
|
protected readonly i18n: KptI18n;
|
|
592
608
|
private readonly injectedGeocoder;
|
|
@@ -597,7 +613,7 @@ declare class KptMapSearch {
|
|
|
597
613
|
protected readonly query: _angular_core.WritableSignal<string>;
|
|
598
614
|
/**
|
|
599
615
|
* Fraza do odpytania geokodera. Osobna od `query`, bo wybór podpowiedzi zmienia treść
|
|
600
|
-
* pola
|
|
616
|
+
* pola - a to nie może wywołać kolejnego zapytania o coś, co już znaleźliśmy.
|
|
601
617
|
*/
|
|
602
618
|
private readonly term;
|
|
603
619
|
protected readonly results: _angular_core.WritableSignal<readonly KptMapSuggestion[]>;
|
|
@@ -607,23 +623,23 @@ declare class KptMapSearch {
|
|
|
607
623
|
* `loading`, bo to inny moment: tam czekamy na listę, tu na jedno konkretne miejsce.
|
|
608
624
|
*/
|
|
609
625
|
protected readonly resolving: _angular_core.WritableSignal<boolean>;
|
|
610
|
-
/** Subskrypcja `resolve()` w locie
|
|
626
|
+
/** Subskrypcja `resolve()` w locie - kolejny wybór i czyszczenie pola ją przerywają. */
|
|
611
627
|
private pending;
|
|
612
|
-
/** Czy jakieś zapytanie już wróciło
|
|
628
|
+
/** Czy jakieś zapytanie już wróciło - bez tego "brak wyników" mignąłby przed pierwszym. */
|
|
613
629
|
protected readonly searched: _angular_core.WritableSignal<boolean>;
|
|
614
630
|
protected readonly open: _angular_core.WritableSignal<boolean>;
|
|
615
631
|
protected readonly activeIndex: _angular_core.WritableSignal<number>;
|
|
616
|
-
/** Fraza za krótka, ale niepusta
|
|
632
|
+
/** Fraza za krótka, ale niepusta - zamiast ciszy pokazujemy, ile znaków brakuje. */
|
|
617
633
|
protected readonly tooShort: _angular_core.Signal<boolean>;
|
|
618
634
|
protected readonly hasPanel: _angular_core.Signal<boolean>;
|
|
619
|
-
/** Cokolwiek leci do geokodera
|
|
635
|
+
/** Cokolwiek leci do geokodera - lista albo pojedyncze miejsce. Jeden stan dla szablonu. */
|
|
620
636
|
protected readonly busy: _angular_core.Signal<boolean>;
|
|
621
|
-
/** Panel pokazuje listę (a nie notę)
|
|
637
|
+
/** Panel pokazuje listę (a nie notę) - tylko wtedy `aria-controls` ma na co wskazać. */
|
|
622
638
|
protected readonly listShown: _angular_core.Signal<boolean>;
|
|
623
639
|
protected readonly canSearch: _angular_core.Signal<boolean>;
|
|
624
|
-
/** Nie udało się ustalić miejsca wybranej podpowiedzi
|
|
640
|
+
/** Nie udało się ustalić miejsca wybranej podpowiedzi - komunikat zamiast cichej ciszy. */
|
|
625
641
|
private readonly unresolved;
|
|
626
|
-
/** Komunikat dla `aria-live`
|
|
642
|
+
/** Komunikat dla `aria-live` - czytnik dostaje stan, którego wzrokowo nie da się przegapić. */
|
|
627
643
|
protected readonly status: _angular_core.Signal<string>;
|
|
628
644
|
protected readonly placeholderText: _angular_core.Signal<string>;
|
|
629
645
|
constructor();
|
|
@@ -633,7 +649,7 @@ declare class KptMapSearch {
|
|
|
633
649
|
* Debounce stoi na `setTimeout`, a nie na operatorach rxjs: porty tego pakietu używają
|
|
634
650
|
* wyłącznie `Observable`/`of`, a rxjs nie jest zadeklarowany jako `peerDependency`
|
|
635
651
|
* biblioteki (wchodzi tranzytywnie przez `@angular/core`). `onCleanup` kasuje zarówno
|
|
636
|
-
* niewystrzelony timer, jak i zapytanie w locie
|
|
652
|
+
* niewystrzelony timer, jak i zapytanie w locie - adapter Nominatim przerywa wtedy
|
|
637
653
|
* `fetch` własnym `AbortController`.
|
|
638
654
|
*/
|
|
639
655
|
private watchTerm;
|
|
@@ -643,33 +659,33 @@ declare class KptMapSearch {
|
|
|
643
659
|
protected onFocus(): void;
|
|
644
660
|
protected onBlur(): void;
|
|
645
661
|
/**
|
|
646
|
-
* Wybór podpowiedzi. Dostawca, który podał współrzędne na liście, emituje natychmiast
|
|
662
|
+
* Wybór podpowiedzi. Dostawca, który podał współrzędne na liście, emituje natychmiast -
|
|
647
663
|
* dla Nominatima i każdego geokodera pytanego wprost nic się nie zmienia.
|
|
648
664
|
*
|
|
649
665
|
* Podpowiedź bez `at` (Google Places Autocomplete) trzeba najpierw uzupełnić: jedno
|
|
650
666
|
* wywołanie `resolve()` na *wybór*, nigdy w trakcie pisania. Panel zostaje otwarty
|
|
651
|
-
* z komunikatem
|
|
667
|
+
* z komunikatem "Szukam...", żeby czekanie nie wyglądało na zawieszenie pola.
|
|
652
668
|
*/
|
|
653
669
|
protected pick(suggestion: KptMapSuggestion): void;
|
|
654
670
|
private applyResolved;
|
|
655
671
|
protected clear(): void;
|
|
656
672
|
protected onKeydown(event: KeyboardEvent): void;
|
|
657
673
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMapSearch, never>;
|
|
658
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapSearch, "kpt-map-search", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "countryCodes": { "alias": "countryCodes"; "required": false; "isSignal": true; }; "viewbox": { "alias": "viewbox"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "cleared": "cleared"; }, never, never, true, never>;
|
|
674
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapSearch, "kpt-map-search", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "countryCodes": { "alias": "countryCodes"; "required": false; "isSignal": true; }; "viewbox": { "alias": "viewbox"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "speech": { "alias": "speech"; "required": false; "isSignal": true; }; "speechLang": { "alias": "speechLang"; "required": false; "isSignal": true; }; "speechColor": { "alias": "speechColor"; "required": false; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "cleared": "cleared"; }, never, never, true, never>;
|
|
659
675
|
}
|
|
660
676
|
|
|
661
677
|
/**
|
|
662
|
-
* Treść dialogu
|
|
678
|
+
* Treść dialogu "dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
|
|
663
679
|
*
|
|
664
|
-
* Przy dynamicznej schemie typowanie pól znika
|
|
680
|
+
* Przy dynamicznej schemie typowanie pól znika - model to `Record<string, unknown>`,
|
|
665
681
|
* a ścieżki walidatorów trzeba rzutować. Reszta kontraktu Signal Forms zostaje bez zmian:
|
|
666
|
-
* walidatory deklarujemy raz, a bramka
|
|
682
|
+
* walidatory deklarujemy raz, a bramka "nie strasz czerwienią" siedzi w prezentacji.
|
|
667
683
|
*/
|
|
668
684
|
declare class KptMapCreateDialog {
|
|
669
685
|
readonly category: _angular_core.InputSignal<KptMapCategory>;
|
|
670
686
|
readonly at: _angular_core.InputSignal<KptLatLng>;
|
|
671
687
|
/**
|
|
672
|
-
* Geokoder tego formularza. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI
|
|
688
|
+
* Geokoder tego formularza. Podany wygrywa nad `KPT_MAP_GEOCODER` z DI - `kpt-map` podaje
|
|
673
689
|
* tędy port swojej mapy, bo geokoder jest per mapa, a nie per aplikacja.
|
|
674
690
|
*/
|
|
675
691
|
readonly geocoder: _angular_core.InputSignal<KptMapGeocoderPort | null>;
|
|
@@ -677,11 +693,11 @@ declare class KptMapCreateDialog {
|
|
|
677
693
|
readonly cancelled: _angular_core.OutputEmitterRef<void>;
|
|
678
694
|
protected readonly i18n: KptI18n;
|
|
679
695
|
private readonly injector;
|
|
680
|
-
/** Opcjonalny
|
|
696
|
+
/** Opcjonalny - wejście `[geocoder]` i tak ma nad nim pierwszeństwo. */
|
|
681
697
|
private readonly injectedGeocoder;
|
|
682
698
|
/** Rozstrzygnięty port: wejście przed DI. Bez obu formularz po prostu nie podpowiada adresu. */
|
|
683
699
|
private readonly port;
|
|
684
|
-
/** Trwa zapytanie do geokodera
|
|
700
|
+
/** Trwa zapytanie do geokodera - szablon pokazuje wtedy notkę zamiast ciszy. */
|
|
685
701
|
protected readonly geocoding: WritableSignal<boolean>;
|
|
686
702
|
/** Ostatnio ustalony adres; `label` bywa czytelniejszy niż suma pól. */
|
|
687
703
|
protected readonly address: WritableSignal<KptMapAddress | null>;
|
|
@@ -692,12 +708,12 @@ declare class KptMapCreateDialog {
|
|
|
692
708
|
* Model i formularz dla aktualnej kategorii. Budowane w efekcie, nie w `computed()`,
|
|
693
709
|
* bo `form()` zakłada dwie rzeczy, których ciało `computed()` nie spełnia:
|
|
694
710
|
*
|
|
695
|
-
* - wstrzykuje sobie zależności
|
|
711
|
+
* - wstrzykuje sobie zależności -> stąd `runInInjectionContext`;
|
|
696
712
|
* - zakłada własny `effect()`, a tego nie wolno tworzyć w kontekście reaktywnym
|
|
697
|
-
* (NG0602)
|
|
713
|
+
* (NG0602) -> stąd `untracked`, które zdejmuje aktywnego konsumenta.
|
|
698
714
|
*
|
|
699
715
|
* Zależność od `fields()` zostaje śledzona na zewnątrz `untracked`, więc zmiana
|
|
700
|
-
* kategorii przebudowuje formularz
|
|
716
|
+
* kategorii przebudowuje formularz - inny zestaw pól to inny formularz, a Signal Forms
|
|
701
717
|
* wiąże schemę tylko raz, przy tworzeniu.
|
|
702
718
|
*/
|
|
703
719
|
private readonly built;
|
|
@@ -705,7 +721,7 @@ declare class KptMapCreateDialog {
|
|
|
705
721
|
/**
|
|
706
722
|
* Podpowiada adres z geokodowania wstecznego współrzędnych kliknięcia.
|
|
707
723
|
*
|
|
708
|
-
* Wypełnia wyłącznie pola z `autofill` i wyłącznie te, które są jeszcze puste
|
|
724
|
+
* Wypełnia wyłącznie pola z `autofill` i wyłącznie te, które są jeszcze puste -
|
|
709
725
|
* podpowiedź nigdy nie kasuje tego, co użytkownik zdążył wpisać. Brak portu
|
|
710
726
|
* `KPT_MAP_GEOCODER` albo nieudane zapytanie to nie błąd: pola zostają puste.
|
|
711
727
|
*/
|
|
@@ -713,20 +729,20 @@ declare class KptMapCreateDialog {
|
|
|
713
729
|
/** `null` tylko między utworzeniem komponentu a pierwszym przebiegiem efektu. */
|
|
714
730
|
protected readonly formRoot: _angular_core.Signal<_angular_forms_signals.FieldTree<Record<string, unknown>, string | number, "writable"> | null>;
|
|
715
731
|
protected readonly formInvalid: _angular_core.Signal<boolean>;
|
|
716
|
-
/** Kontrolka pola po kluczu
|
|
732
|
+
/** Kontrolka pola po kluczu - szablon podaje ją do `[formField]`. */
|
|
717
733
|
protected fieldOf(key: string): unknown;
|
|
718
|
-
/** Komunikat pokazujemy dopiero po dotknięciu pola
|
|
734
|
+
/** Komunikat pokazujemy dopiero po dotknięciu pola - bramka żyje w prezentacji. */
|
|
719
735
|
protected errorOf(key: string): string | null;
|
|
720
736
|
/**
|
|
721
737
|
* Dzień otwarty musi mieć obie godziny i różne od siebie. Dzień oznaczony jako
|
|
722
|
-
* zamknięty przechodzi bez zastrzeżeń
|
|
738
|
+
* zamknięty przechodzi bez zastrzeżeń - to prawidłowa odpowiedź, a nie brak danych.
|
|
723
739
|
*/
|
|
724
740
|
private hoursError;
|
|
725
741
|
protected optionsOf(def: KptMapFieldDef): KptOption<unknown>[];
|
|
726
742
|
protected controlId(def: KptMapFieldDef): string;
|
|
727
743
|
/** Czy pole renderuje jeden `<input>`, na który może wskazać `label[for]`. */
|
|
728
744
|
protected hasOwnInput(def: KptMapFieldDef): boolean;
|
|
729
|
-
/** Współrzędne z prawego kliknięcia
|
|
745
|
+
/** Współrzędne z prawego kliknięcia - pokazujemy je, ale nie pozwalamy edytować. */
|
|
730
746
|
protected readonly coords: _angular_core.Signal<{
|
|
731
747
|
lat: string;
|
|
732
748
|
lng: string;
|
|
@@ -742,7 +758,7 @@ interface ContactRow {
|
|
|
742
758
|
icon: string;
|
|
743
759
|
/** Tekst pokazywany użytkownikowi. */
|
|
744
760
|
text: string;
|
|
745
|
-
/** Tekst kopiowany do schowka
|
|
761
|
+
/** Tekst kopiowany do schowka - dla współrzędnych inny niż wyświetlany. */
|
|
746
762
|
copyValue: string;
|
|
747
763
|
/** `href` akcji właściwej; `null` dla współrzędnych (nie ma dokąd prowadzić). */
|
|
748
764
|
href: string | null;
|
|
@@ -752,14 +768,14 @@ interface ContactRow {
|
|
|
752
768
|
actionLabel: string;
|
|
753
769
|
}
|
|
754
770
|
/**
|
|
755
|
-
* Karta miejsca do popupu mapy
|
|
771
|
+
* Karta miejsca do popupu mapy - dystans od użytkownika, zdjęcie, akcje, kategoria,
|
|
756
772
|
* rozwijane godziny otwarcia i wiersze kontaktowe z kopiowaniem.
|
|
757
773
|
*
|
|
758
774
|
* Komponent jest sterowany danymi: bierze `KptMapPoi`, a nie model domenowy aplikacji.
|
|
759
|
-
* Mapowanie `KptMapLocation.data`
|
|
775
|
+
* Mapowanie `KptMapLocation.data` -> `KptMapPoi` robi aplikacja, dzięki czemu karta nie
|
|
760
776
|
* wie nic o tym, czy pokazuje ładowarkę, restaurację, czy punkt serwisowy.
|
|
761
777
|
*
|
|
762
|
-
* Sam popup `kpt-map` trzeba przełączyć na `[popupLayout]="'card'"`
|
|
778
|
+
* Sam popup `kpt-map` trzeba przełączyć na `[popupLayout]="'card'"` - inaczej karta
|
|
763
779
|
* dostanie 20 rem szerokości i padding przeznaczony dla treści tekstowej.
|
|
764
780
|
*
|
|
765
781
|
* @example
|
|
@@ -795,10 +811,10 @@ declare class KptMapPoiCard {
|
|
|
795
811
|
protected readonly i18n: KptI18n;
|
|
796
812
|
/** Identyfikator regionu godzin; kart na stronie bywa więcej niż jedna. */
|
|
797
813
|
protected readonly hoursId: string;
|
|
798
|
-
/** Rośnie przy każdym otwarciu karty i przy zmianie danych
|
|
814
|
+
/** Rośnie przy każdym otwarciu karty i przy zmianie danych - odświeża status godzin. */
|
|
799
815
|
private readonly now;
|
|
800
816
|
/**
|
|
801
|
-
* Ikona kategorii stoi wprost na powierzchni karty, bez własnego tła
|
|
817
|
+
* Ikona kategorii stoi wprost na powierzchni karty, bez własnego tła - stąd
|
|
802
818
|
* `foregroundVarOf()`, a nie `colorVarOf()`: rola `muted` ma kolor tła, nie treści.
|
|
803
819
|
*/
|
|
804
820
|
protected readonly categoryColor: _angular_core.Signal<string | null>;
|
|
@@ -808,10 +824,10 @@ declare class KptMapPoiCard {
|
|
|
808
824
|
protected readonly open: _angular_core.Signal<boolean>;
|
|
809
825
|
protected readonly hoursGroups: _angular_core.Signal<KptMapHoursGroup[]>;
|
|
810
826
|
protected readonly statusLabel: _angular_core.Signal<string>;
|
|
811
|
-
/** Dopisek
|
|
827
|
+
/** Dopisek "otwarcie o 11:00" - nie ma go dla 24/7 ani gdy zmiana jest dalej niż doba. */
|
|
812
828
|
protected readonly statusHint: _angular_core.Signal<string | null>;
|
|
813
829
|
protected readonly rows: _angular_core.Signal<ContactRow[]>;
|
|
814
|
-
/** Klucz wiersza, którego wartość właśnie skopiowano
|
|
830
|
+
/** Klucz wiersza, którego wartość właśnie skopiowano - przełącza ikonę na "check". */
|
|
815
831
|
protected readonly justCopied: _angular_core.WritableSignal<string | null>;
|
|
816
832
|
private copyTimer;
|
|
817
833
|
/** Bez API schowka przycisk kopiowania w ogóle się nie renderuje. */
|
|
@@ -832,7 +848,7 @@ declare class KptMapPoiCard {
|
|
|
832
848
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapPoiCard, "kpt-map-poi-card", never, { "poi": { "alias": "poi"; "required": true; "isSignal": true; }; "distance": { "alias": "distance"; "required": false; "isSignal": true; }; "category": { "alias": "category"; "required": false; "isSignal": true; }; "primaryLabel": { "alias": "primaryLabel"; "required": false; "isSignal": true; }; "showShare": { "alias": "showShare"; "required": false; "isSignal": true; }; "showFavourite": { "alias": "showFavourite"; "required": false; "isSignal": true; }; "favourite": { "alias": "favourite"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "hoursExpanded": { "alias": "hoursExpanded"; "required": false; "isSignal": true; }; }, { "favourite": "favouriteChange"; "hoursExpanded": "hoursExpandedChange"; "primaryAction": "primaryAction"; "closed": "closed"; "shared": "shared"; }, never, never, true, never>;
|
|
833
849
|
}
|
|
834
850
|
|
|
835
|
-
/** Wiersz edytora
|
|
851
|
+
/** Wiersz edytora - dzień z nazwą i przedziałami dopełnionymi do pustych pól. */
|
|
836
852
|
interface HoursRow {
|
|
837
853
|
day: KptMapWeekday;
|
|
838
854
|
name: string;
|
|
@@ -843,10 +859,10 @@ interface HoursRow {
|
|
|
843
859
|
}[];
|
|
844
860
|
}
|
|
845
861
|
/**
|
|
846
|
-
* Pole
|
|
862
|
+
* Pole "godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
|
|
847
863
|
*
|
|
848
|
-
* Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem
|
|
849
|
-
* 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
|
|
850
866
|
* najczęstszy przypadek, a bez niego wypełnienie formularza to czternaście pól.
|
|
851
867
|
*
|
|
852
868
|
* Nazwy dni idą z `Intl`, nie ze słownika `KptMessages`: rozkład tygodnia jest
|
|
@@ -862,7 +878,7 @@ declare class KptMapHoursField implements FormValueControl<KptMapOpeningHours> {
|
|
|
862
878
|
protected readonly i18n: KptI18n;
|
|
863
879
|
protected readonly maxRanges = 2;
|
|
864
880
|
protected readonly minuteStep = 5;
|
|
865
|
-
/** Skrót
|
|
881
|
+
/** Skrót "tak samo przez cały tydzień" - trzymany w modelu, nie w wartości. */
|
|
866
882
|
readonly sameAllWeek: _angular_core.ModelSignal<boolean>;
|
|
867
883
|
protected readonly rows: _angular_core.Signal<HoursRow[]>;
|
|
868
884
|
/** Dni poza poniedziałkiem są zablokowane, gdy tydzień jest jednakowy. */
|
|
@@ -874,20 +890,20 @@ declare class KptMapHoursField implements FormValueControl<KptMapOpeningHours> {
|
|
|
874
890
|
protected removeRange(row: HoursRow, index: number): void;
|
|
875
891
|
/** Zmiana jednego dnia; przy jednakowym tygodniu poniedziałek rozlewa się na resztę. */
|
|
876
892
|
private patch;
|
|
877
|
-
/** Zapis zawsze przez pełny, uporządkowany tydzień
|
|
893
|
+
/** Zapis zawsze przez pełny, uporządkowany tydzień - model nie ma dziur. */
|
|
878
894
|
private write;
|
|
879
895
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptMapHoursField, never>;
|
|
880
896
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapHoursField, "kpt-map-hours-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "sameAllWeek": { "alias": "sameAllWeek"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "sameAllWeek": "sameAllWeekChange"; }, never, never, true, never>;
|
|
881
897
|
}
|
|
882
898
|
|
|
883
899
|
/**
|
|
884
|
-
* Pole
|
|
900
|
+
* Pole "zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
|
|
885
901
|
*
|
|
886
902
|
* Wartością jest zawsze **string**: albo `data:` z wybranego pliku, albo adres wklejony
|
|
887
903
|
* przez użytkownika. Karta miejsca nie rozróżnia jednego od drugiego, więc formularz
|
|
888
904
|
* nie musi decydować za aplikację, gdzie zdjęcia mieszkają.
|
|
889
905
|
*
|
|
890
|
-
* Plik czytamy w przeglądarce i nigdzie nie wysyłamy
|
|
906
|
+
* Plik czytamy w przeglądarce i nigdzie nie wysyłamy - biblioteka nie ma i nie chce
|
|
891
907
|
* mieć wiedzy o storage'u aplikacji.
|
|
892
908
|
*/
|
|
893
909
|
declare class KptMapImageField implements FormValueControl<string> {
|
|
@@ -915,7 +931,7 @@ declare class KptMapImageField implements FormValueControl<string> {
|
|
|
915
931
|
}
|
|
916
932
|
|
|
917
933
|
/**
|
|
918
|
-
* Fabryka silnika mapy. Fabryka, a nie gotowa instancja
|
|
934
|
+
* Fabryka silnika mapy. Fabryka, a nie gotowa instancja - każda mapa na stronie
|
|
919
935
|
* potrzebuje własnego obiektu, a provider jest jeden.
|
|
920
936
|
*/
|
|
921
937
|
declare const KPT_MAP_ENGINE: InjectionToken<KptMapEngineFactory>;
|
|
@@ -929,9 +945,9 @@ declare const KPT_MAP_ENGINE: InjectionToken<KptMapEngineFactory>;
|
|
|
929
945
|
*/
|
|
930
946
|
declare function provideKptLeafletMap(options?: KptLeafletOptions): Provider[];
|
|
931
947
|
/**
|
|
932
|
-
* Silnik Google Maps. Nie wymaga żadnej paczki npm
|
|
933
|
-
* mapie
|
|
934
|
-
* (*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ą.
|
|
935
951
|
*
|
|
936
952
|
* Różnice wobec Leafleta: `[tileUrl]` i `[attribution]` są bez znaczenia (kafle i atrybucję
|
|
937
953
|
* dostarcza Google i nie wolno ich zasłonić), wczytanie mapy liczy się do SKU Dynamic Maps
|
|
@@ -948,7 +964,7 @@ declare function provideKptLeafletMap(options?: KptLeafletOptions): Provider[];
|
|
|
948
964
|
declare function provideKptGoogleMap(options: KptGoogleOptions): Provider[];
|
|
949
965
|
|
|
950
966
|
/**
|
|
951
|
-
* Źródło pozycji użytkownika. Port, a nie bezpośrednie `navigator.geolocation`
|
|
967
|
+
* Źródło pozycji użytkownika. Port, a nie bezpośrednie `navigator.geolocation` - dzięki
|
|
952
968
|
* temu Storybook i testy podstawiają stałą pozycję zamiast pytać przeglądarkę o zgodę.
|
|
953
969
|
*/
|
|
954
970
|
interface KptMapGeolocationPort {
|
|
@@ -959,7 +975,7 @@ interface KptMapGeolocationPort {
|
|
|
959
975
|
watch(options?: PositionOptions): Observable<KptMapUserPosition | null>;
|
|
960
976
|
}
|
|
961
977
|
declare const KPT_MAP_GEOLOCATION: InjectionToken<KptMapGeolocationPort>;
|
|
962
|
-
/** Błąd geolokalizacji rozpoznany po kodzie
|
|
978
|
+
/** Błąd geolokalizacji rozpoznany po kodzie - rzucany strumieniem, nie wyjątkiem. */
|
|
963
979
|
declare class KptMapGeolocationFailure extends Error {
|
|
964
980
|
readonly detail: KptMapGeolocationError;
|
|
965
981
|
constructor(detail: KptMapGeolocationError);
|
|
@@ -968,12 +984,12 @@ declare class KptMapGeolocationFailure extends Error {
|
|
|
968
984
|
* Domyślna implementacja na `navigator.geolocation.watchPosition`.
|
|
969
985
|
*
|
|
970
986
|
* Uwaga: Geolocation API działa wyłącznie w bezpiecznym kontekście (HTTPS albo
|
|
971
|
-
* `localhost`). Na `http://` z adresem IP przeglądarka odmówi
|
|
987
|
+
* `localhost`). Na `http://` z adresem IP przeglądarka odmówi - to nie jest błąd mapy.
|
|
972
988
|
*/
|
|
973
989
|
declare class KptBrowserGeolocation implements KptMapGeolocationPort {
|
|
974
990
|
watch(options?: PositionOptions): Observable<KptMapUserPosition | null>;
|
|
975
991
|
}
|
|
976
|
-
/** Stała pozycja
|
|
992
|
+
/** Stała pozycja - Storybook, testy, demo bez pytania o zgodę. */
|
|
977
993
|
declare class KptMapGeolocationStub implements KptMapGeolocationPort {
|
|
978
994
|
private readonly at;
|
|
979
995
|
private readonly accuracy;
|