@konce-pt/angular 0.7.12 → 0.8.0

package/types/konce-pt-angular-map.d.ts

@@ -1,374 +1,12 @@
 import * as _angular_core from '@angular/core';
 import { TemplateRef, InjectionToken, Provider, WritableSignal } from '@angular/core';
 import { KptI18n, KptOption } from '@konce-pt/angular';
+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';
+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';
 import { Observable } from 'rxjs';
 import * as _angular_forms_signals from '@angular/forms/signals';
 import { FormValueControl } from '@angular/forms/signals';
 
-/** Punkt geograficzny w stopniach (WGS 84). */
-interface KptLatLng {
-    lat: number;
-    lng: number;
-}
-/** Prostokąt geograficzny. `south < north`; `west`/`east` w stopniach. */
-interface KptMapBounds {
-    south: number;
-    west: number;
-    north: number;
-    east: number;
-}
-/** Punkt w pikselach — kontenera mapy albo świata, zależnie od kontekstu. */
-interface KptMapPoint {
-    x: number;
-    y: number;
-}
-/**
- * Kolor znacznika: rola z warstwy semantycznej tokenów albo gotowe `var(--kpt-*)`.
- * Literały (`#c00`, `rgb(...)`) są celowo niedozwolone — kontrakt repo wymaga tokenów.
- */
-type KptMapColorRole = 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'muted';
-type KptMapColor = KptMapColorRole | `var(--kpt-${string})`;
-/** Kształt znacznika. */
-type KptMapMarkerShape = 'pin' | 'dot' | 'square';
-/** Typ pola w schemie formularza „dodaj lokalizację". */
-type KptMapFieldType = 'text' | 'textarea' | 'number' | 'date' | 'select' | 'multiselect' | 'checkbox' | 'tel' | 'email' | 'url'
-/** Zdjęcie: wybór pliku (wartość jako `data:`) albo wklejony adres. */
- | 'image'
-/** Tygodniowy rozkład godzin otwarcia; wartość to `KptMapOpeningHours`. */
- | 'hours';
-/** Opcja listy wyboru w polu `select` / `multiselect`. */
-interface KptMapFieldOption {
-    value: unknown;
-    label: string;
-}
-/** Definicja jednego pola formularza dodawania lokalizacji. */
-interface KptMapFieldDef {
-    /** Klucz w obiekcie wartości formularza. */
-    key: string;
-    type: KptMapFieldType;
-    label: string;
-    required?: boolean;
-    placeholder?: string;
-    /** Tekst pomocniczy pod polem. */
-    hint?: string;
-    /** Wymagane dla `select` i `multiselect`. */
-    options?: KptMapFieldOption[];
-    /** Dolna granica dla `number`; dla `date` data w formacie ISO. */
-    min?: number | string;
-    /** Górna granica dla `number`; dla `date` data w formacie ISO. */
-    max?: number | string;
-    /** Wartość początkowa; bez niej pole startuje puste (`''`, `null`, `[]`, `false`). */
-    initial?: unknown;
-    /**
-     * Część adresu, którą wypełnić z geokodowania wstecznego współrzędnych kliknięcia.
-     * Działa tylko dla pól tekstowych i tylko gdy aplikacja poda port `KPT_MAP_GEOCODER`.
-     * Nigdy nie nadpisuje tego, co użytkownik już wpisał.
-     */
-    autofill?: KptMapAddressPart;
-}
-/** Rozbiór adresu zwracany przez geokoder. Wszystko opcjonalne — źródła bywają dziurawe. */
-interface KptMapAddress {
-    /** Nazwa ulicy bez numeru. */
-    street?: string;
-    houseNumber?: string;
-    /** Ulica z numerem, gotowa do jednego pola „Adres". */
-    address?: string;
-    city?: string;
-    postcode?: string;
-    /** Województwo / region. */
-    state?: string;
-    /** Powiat / hrabstwo. */
-    county?: string;
-    country?: string;
-    /** Kod ISO 3166-1 alpha-2, wielkimi literami. */
-    countryCode?: string;
-    /** Pełny adres jednym ciągiem, tak jak podał go geokoder. */
-    label?: string;
-}
-/** Pole `KptMapAddress`, którym można wypełnić kontrolkę formularza. */
-type KptMapAddressPart = keyof KptMapAddress;
-/**
- * Podpowiedź z listy wyszukiwarki adresów (geokodowanie wprost: tekst → miejsce).
- *
- * Pochodzi z portu `KPT_MAP_GEOCODER`, więc kształt jest wspólny dla dowolnego
- * dostawcy — Nominatim, instancji własnej i komercyjnej.
- */
-interface KptMapSuggestion {
-    /** Stabilny w obrębie jednej odpowiedzi — służy za klucz `track` listy podpowiedzi. */
-    id: string;
-    /** Pełna nazwa jednym ciągiem; to widzi użytkownik na liście. */
-    label: string;
-    /**
-     * Współrzędne, **gdy dostawca podaje je już na liście** — tak robi każdy geokoder
-     * pytany wprost (Nominatim, Photon, Google Geocoding API).
-     *
-     * Brak wartości znaczy, że podpowiedź trzeba jeszcze uzupełnić metodą `resolve()`
-     * portu. Tak działa Google Places Autocomplete: zwraca `placeId` i tekst, a `lat`/`lng`
-     * dociąga się osobnym Place Details — jedno wywołanie na *wybór* użytkownika, a nie
-     * na każdy naciśnięty klawisz. Na tym stoi jego rozliczanie sesyjne, więc to nie jest
-     * dziwactwo jednego dostawcy, tylko wzorzec, który port musi umieć wyrazić.
-     */
-    at?: KptLatLng;
-    /**
-     * Zasięg obiektu, gdy dostawca go podaje. Miasto trafia wtedy w kadr w całości,
-     * zamiast dostać punktowy zoom w środek rynku.
-     */
-    bounds?: KptMapBounds;
-    /** Rozbiór adresu, gdy dostawca go podaje — ten sam typ, co przy geokodowaniu wstecznym. */
-    address?: KptMapAddress;
-}
-/**
- * Wybrane miejsce — podpowiedź z **pewnymi** współrzędnymi.
- *
- * To ten typ wychodzi z `selected` pola wyszukiwania i z `searchSelect` mapy: zanim
- * zdarzenie poleci, brakujące `at` zostaje dociągnięte przez `resolve()`. Aplikacja
- * nigdy nie musi sprawdzać, czy współrzędne są.
- */
-interface KptMapSearchResult extends KptMapSuggestion {
-    at: KptLatLng;
-}
-/** Kategoria obiektu — kolor, ikona i schema formularza. */
-interface KptMapCategory {
-    id: string;
-    /** Etykieta w legendzie i domyślnym popupie. */
-    label: string;
-    color: KptMapColor;
-    /** Nazwa ikony z `KptIconRegistry`; bez niej znacznik nie ma glifu. */
-    icon?: string;
-    /** Domyślnie `'pin'`. */
-    shape?: KptMapMarkerShape;
-    /** Schema formularza „dodaj lokalizację" dla tej kategorii. */
-    fields?: KptMapFieldDef[];
-    /** Pokazać w legendzie. Domyślnie `true`. */
-    legend?: boolean;
-}
-/** Pojedyncza lokalizacja na mapie. */
-interface KptMapLocation<T = unknown> {
-    id: string;
-    at: KptLatLng;
-    categoryId: string;
-    /** Tytuł w popupie oraz `aria-label` znacznika — bez niego znacznik jest niedostępny. */
-    title: string;
-    /** Dowolne dane aplikacji; trafiają do szablonu popupu jako `data`. */
-    data?: T;
-}
-/** Grupa lokalizacji zwinięta w jeden znacznik z licznikiem. */
-interface KptMapCluster<T = unknown> {
-    /** Stabilny w obrębie zoomu: `c:{zoom}:{cellX}:{cellY}`. */
-    id: string;
-    /** Środek ciężkości grupy. */
-    at: KptLatLng;
-    count: number;
-    /** Najliczniejsza kategoria w grupie — źródło koloru przy `clusterColorBy: 'dominant'`. */
-    dominantCategoryId: string;
-    items: KptMapLocation<T>[];
-    /** Zasięg grupy — do `fitBounds` po kliknięciu. */
-    bounds: KptMapBounds;
-}
-/** Element wyniku grupowania: albo grupa, albo pojedyncza lokalizacja. */
-type KptMapClusterEntry<T = unknown> = KptMapCluster<T> | KptMapLocation<T>;
-/** Zawęża wynik `clusterLocations` do grupy. */
-declare function isCluster<T>(entry: KptMapClusterEntry<T>): entry is KptMapCluster<T>;
-/** Pozycja użytkownika z geolokalizacji. */
-interface KptMapUserPosition {
-    at: KptLatLng;
-    /** Promień niepewności w metrach (`GeolocationCoordinates.accuracy`). */
-    accuracy: number;
-    /** Znacznik czasu odczytu. */
-    timestamp: number;
-}
-/** Powód niepowodzenia geolokalizacji. */
-type KptMapGeolocationErrorKind = 'denied' | 'unavailable' | 'timeout' | 'unsupported';
-interface KptMapGeolocationError {
-    kind: KptMapGeolocationErrorKind;
-    message: string;
-}
-/** Zdarzenie utworzenia lokalizacji przez formularz. */
-interface KptMapCreateEvent {
-    at: KptLatLng;
-    categoryId: string;
-    /** Wartości pól wg schemy kategorii (albo z własnego szablonu formularza). */
-    value: Record<string, unknown>;
-}
-/** Widok mapy — środek i zoom. */
-interface KptMapView {
-    center: KptLatLng;
-    zoom: number;
-}
-/** Dzień tygodnia wg ISO-8601: 1 = poniedziałek … 7 = niedziela. */
-type KptMapWeekday = 1 | 2 | 3 | 4 | 5 | 6 | 7;
-/**
- * Przedział otwarcia w dobie, `HH:MM` w czasie lokalnym miejsca.
- *
- * `to` mniejsze albo równe `from` znaczy „przez północ" — przedział kończy się
- * następnego dnia. `24:00` to prawidłowy koniec doby i nie jest przejściem przez północ.
- */
-interface KptMapHoursRange {
-    from: string;
-    to: string;
-}
-/** Godziny jednego dnia tygodnia. */
-interface KptMapDayHours {
-    day: KptMapWeekday;
-    /** Zamknięte przez całą dobę — `ranges` jest wtedy ignorowane. */
-    closed?: boolean;
-    ranges: KptMapHoursRange[];
-}
-/** Tygodniowy rozkład godzin. Brakujący dzień znaczy „zamknięte". */
-type KptMapOpeningHours = KptMapDayHours[];
-/** Wiersz „ikona + etykieta + wartość" w karcie miejsca. */
-interface KptMapPoiFact {
-    /** Nazwa ikony z `KptIconRegistry`; bez niej wiersz jest bez glifu. */
-    icon?: string;
-    label: string;
-    value: string;
-}
-/**
- * Dane karty miejsca (`kpt-map-poi-card`). Aplikacja mapuje na to swój
- * `KptMapLocation.data` — biblioteka nie narzuca kształtu danych domenowych.
- */
-interface KptMapPoi {
-    title: string;
-    /** Drugi wiersz nagłówka, obok dystansu. */
-    address?: string;
-    /** Adres zdjęcia albo `data:`; karta nie rozróżnia. Puste = zastępnik z ikoną. */
-    photo?: string;
-    photoAlt?: string;
-    hours?: KptMapOpeningHours;
-    phone?: string;
-    email?: string;
-    website?: string;
-    /** Wiersz współrzędnych; bez tego się nie renderuje. */
-    at?: KptLatLng;
-    /** Dodatkowe wiersze informacyjne, bez akcji. */
-    facts?: KptMapPoiFact[];
-}
-
-interface KptClusterOptions {
-    /** Aktualny zoom mapy — decyduje o gęstości siatki. */
-    zoom: number;
-    /** Bok komórki siatki w pikselach ekranu. Domyślnie 60. */
-    gridSize?: number;
-    /** Powyżej tego zoomu grupowanie jest wyłączone. Domyślnie 16. */
-    maxZoom?: number;
-    /** Ile punktów musi trafić do komórki, żeby powstała grupa. Domyślnie 2. */
-    minPoints?: number;
-    /**
-     * Kolejność kategorii — rozstrzyga remis przy wyborze kategorii dominującej.
-     * Bez niej remis rozstrzyga kolejność wystąpienia w danych.
-     */
-    categoryOrder?: readonly string[];
-}
-declare const KPT_CLUSTER_DEFAULTS: {
-    readonly gridSize: 60;
-    readonly maxZoom: 16;
-    readonly minPoints: 2;
-};
-/**
- * Zwija bliskie sobie lokalizacje w grupy. Zwraca listę mieszaną: grupy i pojedyncze punkty.
- *
- * Środek grupy uśredniamy w przestrzeni pikseli, nie w stopniach. Mercator rozciąga
- * stopnie tym mocniej, im dalej od równika, więc średnia w stopniach wypada obok
- * wizualnego środka kropek na ekranie — a to jego ma pilnować znacznik grupy.
- */
-declare function clusterLocations<T>(locations: readonly KptMapLocation<T>[], options: KptClusterOptions): KptMapClusterEntry<T>[];
-/**
- * Najliczniejsza kategoria w grupie. Remis rozstrzyga `categoryOrder`, a bez niej
- * kolejność pierwszego wystąpienia — w obu wypadkach wynik jest deterministyczny.
- */
-declare function dominantCategory<T>(items: readonly KptMapLocation<T>[], categoryOrder?: readonly string[]): string;
-/** Zlicza lokalizacje w rozbiciu na kategorie — licznik obok pozycji legendy. */
-declare function countByCategory<T>(locations: readonly KptMapLocation<T>[]): Record<string, number>;
-/**
- * Czy grupa da się rozbić przybliżeniem. Punkty o tej samej współrzędnej zostaną razem
- * na każdym zoomie — wtedy kliknięcie ma otworzyć listę zamiast zoomować w nieskończoność.
- */
-declare function isSplittable<T>(cluster: KptMapCluster<T>): boolean;
-
-/** Rodzaj silnika — trafia do `data-engine` na hoście, przydatne w testach i stylach. */
-type KptMapEngineKind = 'leaflet' | 'google';
-interface KptMapEngineInit {
-    center: KptLatLng;
-    zoom: number;
-    minZoom?: number;
-    maxZoom?: number;
-    /** Blokada panningu poza prostokąt. */
-    maxBounds?: KptMapBounds | null;
-    /** Szablon URL kafli, np. `https://tile.openstreetmap.org/{z}/{x}/{y}.png`. */
-    tileUrl: string;
-    /** Tekst atrybucji — wymagany licencyjnie przy OSM. */
-    attribution: string;
-    /** Silnik nie rysuje własnych kontrolek zoomu — robi to warstwa Angulara. */
-    interactive?: boolean;
-}
-/** Znacznik gotowy do narysowania — HTML pochodzi z `marker-html.ts`. */
-interface KptMapRenderedMarker {
-    /** Stabilne id: `id` lokalizacji albo `id` grupy. */
-    id: string;
-    at: KptLatLng;
-    html: string;
-    /** Rozmiar ikony w pikselach — silnik potrzebuje go do zakotwiczenia. */
-    size: {
-        width: number;
-        height: number;
-    };
-    /** Punkt zakotwiczenia względem lewego górnego rogu ikony. */
-    anchor: KptMapPoint;
-    /** Kolejność rysowania — grupy nad pojedynczymi punktami. */
-    zIndex?: number;
-}
-interface KptMapPointerEvent {
-    at: KptLatLng;
-    /** Piksele względem kontenera mapy. */
-    point: KptMapPoint;
-    /** Zdarzenie źródłowe, gdy trzeba zatrzymać propagację. */
-    originalEvent?: Event;
-}
-interface KptMapEngineEvents {
-    /** Pan i zoom w toku — używane do przeliczania pozycji popupu. */
-    move: () => void;
-    /** Koniec ruchu — dopiero tu warto emitować `viewChange`. */
-    moveend: () => void;
-    zoomend: () => void;
-    click: (event: KptMapPointerEvent) => void;
-    contextmenu: (event: KptMapPointerEvent) => void;
-    /** Kliknięcie w znacznik; `id` jak w `KptMapRenderedMarker`. */
-    markerclick: (id: string, event: KptMapPointerEvent) => void;
-}
-interface KptMapEngine {
-    readonly kind: KptMapEngineKind;
-    /** Tworzy mapę w kontenerze. Wywoływane po pierwszym renderze, nigdy na SSR. */
-    init(host: HTMLElement, opts: KptMapEngineInit): Promise<void>;
-    destroy(): void;
-    setView(center: KptLatLng, zoom: number, animate?: boolean): void;
-    fitBounds(bounds: KptMapBounds, paddingPx?: number): void;
-    panBy(offset: KptMapPoint): void;
-    getCenter(): KptLatLng;
-    getZoom(): number;
-    getBounds(): KptMapBounds;
-    getSize(): {
-        width: number;
-        height: number;
-    };
-    /** Współrzędne → piksele WZGLĘDEM kontenera (pozycjonowanie popupu). */
-    project(at: KptLatLng): KptMapPoint;
-    unproject(point: KptMapPoint): KptLatLng;
-    /** Pełna wymiana zestawu znaczników; diff po `id` robi implementacja. */
-    setMarkers(markers: readonly KptMapRenderedMarker[]): void;
-    /** `null` chowa znacznik użytkownika i krąg dokładności. */
-    setUserPosition(position: KptMapUserPosition | null, html: string): void;
-    setTileSource(tileUrl: string, attribution: string): void;
-    setMaxBounds(bounds: KptMapBounds | null): void;
-    /** Kontener zmienił rozmiar — bez tego Leaflet zostawia szare pola. */
-    invalidateSize(): void;
-    on<K extends keyof KptMapEngineEvents>(event: K, handler: KptMapEngineEvents[K]): void;
-}
-/** Fabryka silnika — to ją dostarcza DI, żeby każda mapa miała własną instancję. */
-type KptMapEngineFactory = () => KptMapEngine;
-/** Domyślne źródło kafli. Do produkcji podstaw własny serwer — patrz llms.txt. */
-declare const KPT_MAP_DEFAULT_TILE_URL = "https://tile.openstreetmap.org/{z}/{x}/{y}.png";
-declare const KPT_MAP_DEFAULT_ATTRIBUTION = "&copy; <a href=\"https://www.openstreetmap.org/copyright\">OpenStreetMap</a> contributors";
-
 /** Kontekst szablonu popupu — `$implicit` to lokalizacja. */
 interface KptMapPopupContext<T = unknown> {
     $implicit: KptMapLocation<T>;
@@ -1086,47 +724,6 @@ declare class KptMapCreateDialog {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapCreateDialog, "kpt-map-create-dialog", never, { "category": { "alias": "category"; "required": true; "isSignal": true; }; "at": { "alias": "at"; "required": true; "isSignal": true; }; "geocoder": { "alias": "geocoder"; "required": false; "isSignal": true; }; }, { "save": "save"; "cancelled": "cancelled"; }, never, never, true, never>;
 }
 
-/** Minuta doby dla `HH:MM`; `24:00` to 1440. `null`, gdy zapis jest nieprawidłowy. */
-declare function parseTime(value: string): number | null;
-/** `HH:MM` z minuty doby. 1440 wraca jako `24:00`, nie `00:00`. */
-declare function formatTime(minutes: number): string;
-/** Dzień tygodnia wg ISO (1 = poniedziałek) z natywnej daty. */
-declare function isoWeekday(date: Date): KptMapWeekday;
-/**
- * Czy miejsce jest otwarte w danym momencie.
- *
- * Sprawdza dwa dni: bieżący oraz poprzedni, bo przedział przez północ
- * (`22:00 – 01:00`) obejmuje wczesne godziny dnia następnego.
- */
-declare function isOpenAt(hours: KptMapOpeningHours | undefined, date: Date): boolean;
-/** Czy rozkład to pełna doba przez siedem dni — wtedy karta pisze po prostu „24/7". */
-declare function isAlwaysOpen(hours: KptMapOpeningHours | undefined): boolean;
-/** Najbliższa zmiana stanu otwarte/zamknięte albo `null`, gdy w ciągu tygodnia jej nie ma. */
-declare function nextChange(hours: KptMapOpeningHours | undefined, date: Date): {
-    open: boolean;
-    at: Date;
-} | null;
-/** Skrócona nazwa dnia z `Intl` — bez słownika, więc działa dla dowolnego locale. */
-declare function weekdayName(day: KptMapWeekday, locale: string): string;
-/** Wiersz rozkładu: jeden dzień albo sklejony zakres dni o identycznych godzinach. */
-interface KptMapHoursGroup {
-    /** `pon.` albo `wt.–sob.`, wg locale. */
-    label: string;
-    days: KptMapWeekday[];
-    closed: boolean;
-    /** Sformatowane przedziały, np. `['11:00 – 24:00']`. Puste, gdy zamknięte. */
-    ranges: string[];
-}
-/**
- * Rozkład tygodnia z sąsiadującymi dniami sklejonymi w jeden wiersz.
- *
- * Niedziela i poniedziałek się nie sklejają, choć w tablicy sąsiadują — tydzień
- * czyta się liniowo od poniedziałku i zawijanie byłoby mylące.
- */
-declare function groupWeek(hours: KptMapOpeningHours | undefined, locale: string, separator?: string): KptMapHoursGroup[];
-/** Siedem dni oznaczonych jako zamknięte — wartość startowa pola `hours` w formularzu. */
-declare function emptyWeek(): KptMapOpeningHours;
-
 /** Wiersz kontaktu: wartość, akcja właściwa i kopiowanie do schowka. */
 interface ContactRow {
     kind: 'phone' | 'email' | 'website' | 'coords';
@@ -1305,70 +902,6 @@ declare class KptMapImageField implements FormValueControl<string> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptMapImageField, "kpt-map-image-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; }; "maxBytes": { "alias": "maxBytes"; "required": false; "isSignal": true; }; "files": { "alias": "files"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; "files": "filesChange"; }, never, never, true, never>;
 }
 
-/**
- * Namespace `google.maps`. Świadomie `any` — pełne typy przychodzą z opcjonalnego
- * `@types/google.maps`, a biblioteka nie może od nich zależeć przy kompilacji.
- */
-type KptGoogleMapsApi = any;
-interface KptGoogleOptions {
-    /** Klucz API z Google Cloud. Wymagany. */
-    apiKey: string;
-    /**
-     * Identyfikator stylu mapy z konsoli Google (*Map management → Create Map ID*).
-     *
-     * **Wymagany.** Bez niego nie działa `AdvancedMarkerElement`, a znaczniki tej biblioteki
-     * to gotowy HTML z `marker-html.ts` — starsze `Marker` nie umie go przyjąć.
-     */
-    mapId: string;
-    /** Wersja API. Domyślnie `weekly`. */
-    version?: string;
-    /** Język etykiet na mapie (kod ISO 639-1). Domyślnie język przeglądarki. */
-    language?: string;
-    /** Region wpływający na nazewnictwo i granice sporne (ISO 3166-1 alpha-2). */
-    region?: string;
-    /** Dolny limit zoomu. Domyślnie 2 — niżej świat powtarza się w poziomie. */
-    minZoom?: number;
-    /** Górny limit zoomu. Domyślnie 21. */
-    maxZoom?: number;
-    /** Zoom kółkiem myszy. Domyślnie włączony. */
-    scrollWheelZoom?: boolean;
-}
-/**
- * Tyle z `KptGoogleOptions`, ile trzeba do wczytania samego API. Bez `mapId` — ten dotyczy
- * wyglądu mapy, a API potrzebują też usługi, które żadnej mapy nie rysują.
- */
-type KptGoogleLoadOptions = Pick<KptGoogleOptions, 'apiKey' | 'version' | 'language' | 'region'>;
-/**
- * Ładuje Google Maps JavaScript API raz na aplikację. Gdy `google.maps` już istnieje — bo
- * aplikacja wstawiła skrypt sama albo stoi tu druga mapa — korzystamy z tego, co jest: drugie
- * wczytanie Google i tak odrzuca, wypisując ostrzeżenie do konsoli.
- *
- * Publiczne, bo silnik nie jest jedynym, kto tego API potrzebuje. Geokoder Google **musi**
- * iść przez SDK, a nie przez REST: web service `/maps/api/geocode/json` odrzuca klucze
- * z restrykcją `Referer` („API keys with referer restrictions cannot be used with this API"),
- * a to jedyna restrykcja, jaką da się sensownie nałożyć na klucz leżący w bundlu przeglądarki.
- * Wywołania z załadowanego SDK autoryzują się tak samo jak sama mapa.
- *
- * Adaptera geokodera biblioteka nadal nie dostarcza — tylko drogę do API, którą i tak
- * otwiera silnikowi. Powody stoją przy `provideKptGoogleMap` i w `llms.txt`.
- */
-declare function loadGoogleMapsApi(options: KptGoogleLoadOptions): Promise<KptGoogleMapsApi>;
-/** Fabryka silnika — każda mapa dostaje własną instancję. */
-declare function createGoogleEngine(options: KptGoogleOptions): KptMapEngine;
-
-interface KptLeafletOptions {
-    /** Dolny limit zoomu. Domyślnie 2 — niżej świat powtarza się w poziomie. */
-    minZoom?: number;
-    /** Górny limit zoomu. Domyślnie 19 (tyle daje OSM). */
-    maxZoom?: number;
-    /** Bezwładność po przeciągnięciu. Domyślnie włączona. */
-    inertia?: boolean;
-    /** Zoom kółkiem myszy. Domyślnie włączony. */
-    scrollWheelZoom?: boolean;
-}
-/** Fabryka silnika — każda mapa dostaje własną instancję. */
-declare function createLeafletEngine(options?: KptLeafletOptions): KptMapEngine;
-
 /**
  * Fabryka silnika mapy. Fabryka, a nie gotowa instancja — każda mapa na stronie
  * potrzebuje własnego obiektu, a provider jest jeden.
@@ -1443,144 +976,6 @@ declare class KptMapGeolocationStub implements KptMapGeolocationPort {
  */
 declare function provideKptMapGeolocationStub(at: KptLatLng, accuracy?: number): Provider;
 
-interface KptMapCountryPreset {
-    /** Kod ISO 3166-1 alpha-2 (albo `EU` dla całego kontynentu). */
-    code: string;
-    center: KptLatLng;
-    /** Zoom, przy którym kraj mieści się na typowym kontenerze (~1000×600 px). */
-    zoom: number;
-    bounds: KptMapBounds;
-}
-/** Kod kraju użyty, gdy aplikacja nie poda żadnego. */
-declare const KPT_MAP_DEFAULT_COUNTRY = "PL";
-/**
- * Zasięgi lądowe (bez terytoriów zamorskich) zaokrąglone do dwóch miejsc —
- * to widok startowy, nie granica administracyjna.
- */
-declare const KPT_MAP_COUNTRIES: Record<string, KptMapCountryPreset>;
-/** Preset kraju po kodzie (wielkość liter bez znaczenia); `undefined`, gdy nieznany. */
-declare function countryPreset(code: string): KptMapCountryPreset | undefined;
-/** Kody wszystkich presetów — do listy wyboru w aplikacji. */
-declare function countryCodes(): string[];
-/**
- * Widok startowy: preset kraju, a przy nieznanym kodzie preset domyślny.
- * Zawsze zwraca coś sensownego — mapa nigdy nie startuje na `[0, 0]`.
- */
-declare function resolveCountryView(code: string | null | undefined): KptMapCountryPreset;
-/** Środek prostokąta kraju — pomocnicze przy własnych `bounds`. */
-declare function centerOfBounds(bounds: KptMapBounds): KptLatLng;
-
-/** Bok kafla w pikselach — stała obu silników. */
-declare const KPT_TILE_SIZE = 256;
-/**
- * Granica szerokości w Mercatorze. Powyżej niej projekcja ucieka do nieskończoności,
- * więc obie biblioteki przycinają świat dokładnie w tym miejscu.
- */
-declare const KPT_MAX_LATITUDE = 85.05112877980659;
-/** Promień Ziemi w metrach (sfera, jak w Leaflet `L.CRS.Earth`). */
-declare const KPT_EARTH_RADIUS = 6378137;
-/** Przycina szerokość do zakresu obsługiwanego przez Mercator. */
-declare function clampLat(lat: number): number;
-/**
- * Zawija długość geograficzną do zakresu [-180, 180].
- *
- * Wartości już w zakresie wracają nietknięte — także -180, bo w projekcji jest to
- * lewa krawędź świata (x = 0), a nie ta sama kolumna pikseli co +180. Zawijanie
- * dotyczy wyłącznie tego, co wychodzi poza zakres: 540° to ten sam południk co 180°.
- */
-declare function normalizeLng(lng: number): number;
-/** Liczba pikseli świata na danym zoomie. */
-declare function worldSize(zoom: number): number;
-/** Współrzędne → piksele świata na danym zoomie (origin w lewym górnym rogu). */
-declare function project(at: KptLatLng, zoom: number): KptMapPoint;
-/** Piksele świata → współrzędne. Odwrotność `project`. */
-declare function unproject(point: KptMapPoint, zoom: number): KptLatLng;
-/** Najmniejszy prostokąt obejmujący wszystkie punkty. Pusta lista → `null`. */
-declare function boundsOf(points: readonly KptLatLng[]): KptMapBounds | null;
-/**
- * Najmniejszy zasięg w stopniach, przy którym `fitBounds` ma jeszcze sens (~100 m).
- *
- * Geokodery obrysowują pojedynczy adres prostokątem rzędu 0,0001°. Wpasowanie takiego
- * w kadr wjeżdża na górny limit zoomu, a wynik zależy od tego, jak dostawca obrysował
- * budynek — dwa sąsiednie adresy lądują w różnych przybliżeniach.
- */
-declare const KPT_MIN_FIT_SPAN = 0.001;
-/**
- * Czy prostokąt warto wpasowywać w kadr, zamiast potraktować go jak punkt.
- *
- * `false` dla zasięgu zdegenerowanego albo ciaśniejszego niż `minSpan` w OBU osiach —
- * długa, wąska ulica ma jeden wymiar mikroskopijny i dalej zasługuje na `fitBounds`.
- */
-declare function isFittableBounds(bounds: KptMapBounds, minSpan?: number): boolean;
-/** Środek prostokąta. */
-declare function boundsCenter(bounds: KptMapBounds): KptLatLng;
-/** Czy punkt leży w prostokącie (granice włącznie). */
-declare function boundsContain(bounds: KptMapBounds, at: KptLatLng): boolean;
-/** Rozszerza prostokąt o zadaną liczbę stopni w każdą stronę. */
-declare function padBounds(bounds: KptMapBounds, degrees: number): KptMapBounds;
-/** Odległość po wielkim kole w metrach. */
-declare function haversine(a: KptLatLng, b: KptLatLng): number;
-/**
- * Ile metrów przypada na piksel na danej szerokości i zoomie.
- * Potrzebne, żeby krąg dokładności geolokalizacji miał realny promień.
- */
-declare function metersPerPixel(lat: number, zoom: number): number;
-/**
- * Największy zoom, przy którym `bounds` mieści się w kontenerze o zadanym rozmiarze.
- * Zwraca liczbę zmiennoprzecinkową — zaokrąglenie w dół zostawiamy wołającemu.
- */
-declare function zoomForBounds(bounds: KptMapBounds, size: {
-    width: number;
-    height: number;
-}, paddingPx?: number): number;
-
-/** Rola koloru → zmienna CSS. Gotowe `var(--kpt-*)` przechodzi bez zmian; cokolwiek spoza tego
- *  kontraktu dostaje bezpieczny fallback zamiast trafić surowo do wyjścia. */
-declare function colorVarOf(color: KptMapColor): string;
-/** Kolor treści na tle `color` — dla ról znany, dla własnych zmiennych fallback na biel tokenową. */
-declare function contrastVarOf(color: KptMapColor): string;
-declare function foregroundVarOf(color: KptMapColor): string;
-interface KptMarkerHtmlInput {
-    shape?: KptMapMarkerShape;
-    color: KptMapColor;
-    /** Inner-SVG ikony (bez wrappera `<svg>`); bez niego znacznik nie ma glifu. */
-    iconSvgInner?: string;
-    /** Tekst dla czytnika ekranu — zwykle tytuł lokalizacji. */
-    label: string;
-    /** Znacznik wybrany (otwarty popup) — dostaje klasę modyfikującą. */
-    selected?: boolean;
-}
-declare function renderMarkerHtml(input: KptMarkerHtmlInput): string;
-interface KptClusterHtmlInput {
-    count: number;
-    color: KptMapColor;
-    /** Gotowy tekst dla czytnika (i18n rozwiązane po stronie Angulara). */
-    label: string;
-}
-/** Koło z licznikiem; rozmiar rośnie schodkowo z liczebnością grupy. */
-declare function renderClusterHtml(input: KptClusterHtmlInput): string;
-/** Próg wielkości grupy — trzy stopnie wystarczą, żeby zobaczyć różnicę bez skalowania ciągłego. */
-declare function clusterTier(count: number): 'sm' | 'md' | 'lg';
-/** Znacznik pozycji użytkownika — ikona podawana z zewnątrz, jak przy zwykłym znaczniku. */
-declare function renderUserMarkerHtml(input: {
-    label: string;
-    iconSvgInner?: string;
-}): string;
-
-/**
- * Dystans po ludzku: poniżej kilometra w metrach zaokrąglonych do dziesiątek,
- * wyżej w kilometrach z jednym miejscem po przecinku (`6,2 km` w `pl-PL`).
- *
- * Wartość ujemna albo nieskończona daje `null` — wołający chowa wtedy wiersz,
- * zamiast malować „NaN km".
- */
-declare function formatDistance(metres: number | null | undefined, locale: string): string | null;
-/** Współrzędne do wiersza karty — pięć miejsc po przecinku to ok. metr. */
-declare function formatLatLng(at: {
-    lat: number;
-    lng: number;
-}, digits?: number): string;
-
-export { KPT_CLUSTER_DEFAULTS, KPT_EARTH_RADIUS, KPT_MAP_COUNTRIES, KPT_MAP_DEFAULT_ATTRIBUTION, KPT_MAP_DEFAULT_COUNTRY, KPT_MAP_DEFAULT_TILE_URL, KPT_MAP_ENGINE, KPT_MAP_GEOCODER, KPT_MAP_GEOLOCATION, KPT_MAX_LATITUDE, KPT_MIN_FIT_SPAN, KPT_TILE_SIZE, KptBrowserGeolocation, KptMap, KptMapCreateDialog, KptMapCreateFormTemplate, KptMapGeocoderStub, KptMapGeolocationFailure, KptMapGeolocationStub, KptMapHoursField, KptMapImageField, KptMapLegend, KptMapPoiCard, KptMapPopupTemplate, KptMapSearch, KptNominatimGeocoder, 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, provideKptGoogleMap, provideKptLeafletMap, provideKptMapGeocoderStub, provideKptMapGeolocationStub, provideKptNominatimGeocoder, renderClusterHtml, renderMarkerHtml, renderUserMarkerHtml, resolveCountryView, unproject, weekdayName, worldSize, zoomForBounds };
-export type { KptClusterOptions, KptGoogleLoadOptions, KptGoogleMapsApi, KptGoogleOptions, KptLatLng, KptLeafletOptions, KptMapAddress, KptMapAddressPart, KptMapBounds, KptMapCategory, KptMapCluster, KptMapClusterEntry, KptMapColor, KptMapColorRole, KptMapCountryPreset, KptMapCreateEvent, KptMapCreateFormApi, KptMapCreateFormContext, KptMapDayHours, KptMapEngine, KptMapEngineEvents, KptMapEngineFactory, KptMapEngineInit, KptMapEngineKind, KptMapFieldDef, KptMapFieldOption, KptMapFieldType, KptMapGeocoderPort, KptMapGeocoderStubOptions, KptMapGeolocationError, KptMapGeolocationErrorKind, KptMapGeolocationPort, KptMapHoursGroup, KptMapHoursRange, KptMapLocation, KptMapMarkerShape, KptMapOpeningHours, KptMapPoi, KptMapPoiFact, KptMapPoint, KptMapPointerEvent, KptMapPopupContext, KptMapRenderedMarker, KptMapSearchOptions, KptMapSearchResult, KptMapSuggestion, KptMapUserPosition, KptMapView, KptMapWeekday, KptNominatimOptions };
+export { KPT_MAP_ENGINE, KPT_MAP_GEOCODER, KPT_MAP_GEOLOCATION, KptBrowserGeolocation, KptMap, KptMapCreateDialog, KptMapCreateFormTemplate, KptMapGeocoderStub, KptMapGeolocationFailure, KptMapGeolocationStub, KptMapHoursField, KptMapImageField, KptMapLegend, KptMapPoiCard, KptMapPopupTemplate, KptMapSearch, KptNominatimGeocoder, provideKptGoogleMap, provideKptLeafletMap, provideKptMapGeocoderStub, provideKptMapGeolocationStub, provideKptNominatimGeocoder };
+export type { KptMapCreateFormApi, KptMapCreateFormContext, KptMapGeocoderPort, KptMapGeocoderStubOptions, KptMapGeolocationPort, KptMapPopupContext, KptMapSearchOptions, KptNominatimOptions };
 //# sourceMappingURL=konce-pt-angular-map.d.ts.map