@konce-pt/map 0.12.0 → 0.14.0

package/README.md

@@ -1,11 +1,11 @@
 <p align="center">
-  <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI — Angular component library" width="100%" />
+  <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI - Angular component library" width="100%" />
 </p>
 
 # @konce-pt/map
 
 Rdzeń mapy [Koncept UI](https://gitlab.com/konce-pt/koncept-ui): odwzorowanie i arytmetyka
-prostokątów, klastrowanie znaczników, godziny otwarcia, HTML znaczników, formatowanie — oraz
+prostokątów, klastrowanie znaczników, godziny otwarcia, HTML znaczników, formatowanie - oraz
 adaptery silników Leaflet i Google. Czysty TypeScript, **zero zależności runtime**
 (`leaflet` to peer opcjonalny, ładowany dynamicznym `import()`).
 
@@ -20,7 +20,7 @@ npm i @konce-pt/map
 ```ts
 import { clusterLocations, zoomForBounds, isOpenAt, createLeafletEngine } from '@konce-pt/map';
 
-// Klastrowanie na siatce pikseli — wynik zależy od zoomu, nie od samych współrzędnych.
+// Klastrowanie na siatce pikseli - wynik zależy od zoomu, nie od samych współrzędnych.
 clusterLocations(locations, 12, { gridSize: 60 });
 
 // Zoom, przy którym prostokąt mieści się w kontenerze.
@@ -35,16 +35,16 @@ const engine = createLeafletEngine({ maxZoom: 19 });
 
 ## API
 
-- **Geometria** — `project`, `unproject`, `boundsOf`, `boundsCenter`, `boundsContain`, `padBounds`,
+- **Geometria** - `project`, `unproject`, `boundsOf`, `boundsCenter`, `boundsContain`, `padBounds`,
   `isFittableBounds`, `haversine`, `metersPerPixel`, `zoomForBounds`, `clampLat`, `normalizeLng`
-- **Klastry** — `clusterLocations`, `dominantCategory`, `countByCategory`, `isSplittable`
-- **Znaczniki** — `renderMarkerHtml`, `renderClusterHtml`, `renderUserMarkerHtml`, `colorVarOf`,
+- **Klastry** - `clusterLocations`, `dominantCategory`, `countByCategory`, `isSplittable`
+- **Znaczniki** - `renderMarkerHtml`, `renderClusterHtml`, `renderUserMarkerHtml`, `colorVarOf`,
   `contrastVarOf`, `foregroundVarOf`, `clusterTier`
-- **Godziny** — `parseTime`, `formatTime`, `isOpenAt`, `isAlwaysOpen`, `nextChange`, `groupWeek`
-- **Kraje i format** — `KPT_MAP_COUNTRIES`, `countryPreset`, `resolveCountryView`,
+- **Godziny** - `parseTime`, `formatTime`, `isOpenAt`, `isAlwaysOpen`, `nextChange`, `groupWeek`
+- **Kraje i format** - `KPT_MAP_COUNTRIES`, `countryPreset`, `resolveCountryView`,
   `formatDistance`, `formatLatLng`, `normalizeUrl`, `prettyUrl`
-- **Silniki** — `createLeafletEngine`, `createGoogleEngine`, `loadGoogleMapsApi`
-- **Typy** — `KptMapEngine`, `KptMapLocation`, `KptMapCategory`, `KptMapPoi` i reszta kontraktu
+- **Silniki** - `createLeafletEngine`, `createGoogleEngine`, `loadGoogleMapsApi`
+- **Typy** - `KptMapEngine`, `KptMapLocation`, `KptMapCategory`, `KptMapPoi` i reszta kontraktu
 
 Pełny opis: [`llms.txt`](https://ui.konce.pt/llms/map/llms.txt) (EN)
 i [`llms-pl.txt`](https://ui.konce.pt/llms/map/llms-pl.txt) (PL).

package/dist/cluster.d.ts

@@ -1,6 +1,6 @@
 import type { KptMapCluster, KptMapClusterEntry, KptMapLocation } from './types.ts';
 export interface KptClusterOptions {
-    /** Aktualny zoom mapy — decyduje o gęstości siatki. */
+    /** Aktualny zoom mapy - decyduje o gęstości siatki. */
     zoom: number;
     /** Bok komórki siatki w pikselach ekranu. Domyślnie 60. */
     gridSize?: number;
@@ -9,7 +9,7 @@ export interface KptClusterOptions {
     /** 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.
+     * Kolejność kategorii - rozstrzyga remis przy wyborze kategorii dominującej.
      * Bez niej remis rozstrzyga kolejność wystąpienia w danych.
      */
     categoryOrder?: readonly string[];
@@ -24,18 +24,18 @@ export declare const KPT_CLUSTER_DEFAULTS: {
  *
  * Ś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.
+ * wizualnego środka kropek na ekranie - a to jego ma pilnować znacznik grupy.
  */
 export 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.
+ * kolejność pierwszego wystąpienia - w obu wypadkach wynik jest deterministyczny.
  */
 export declare function dominantCategory<T>(items: readonly KptMapLocation<T>[], categoryOrder?: readonly string[]): string;
-/** Zlicza lokalizacje w rozbiciu na kategorie — licznik obok pozycji legendy. */
+/** Zlicza lokalizacje w rozbiciu na kategorie - licznik obok pozycji legendy. */
 export 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ść.
+ * na każdym zoomie - wtedy kliknięcie ma otworzyć listę zamiast zoomować w nieskończoność.
  */
 export declare function isSplittable<T>(cluster: KptMapCluster<T>): boolean;

package/dist/cluster.js

@@ -1,5 +1,5 @@
 /*
- * Grupowanie znaczników — siatka w przestrzeni pikseli, O(n), deterministyczna.
+ * Grupowanie znaczników - siatka w przestrzeni pikseli, O(n), deterministyczna.
  * Pure TS: ten sam kod obsługuje silnik Leaflet i Google Maps, i przenosi się do Reacta.
  */
 import { boundsOf, project, unproject } from "./geo.js";
@@ -13,7 +13,7 @@ export const KPT_CLUSTER_DEFAULTS = {
  *
  * Ś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.
+ * wizualnego środka kropek na ekranie - a to jego ma pilnować znacznik grupy.
  */
 export function clusterLocations(locations, options) {
     const gridSize = options.gridSize ?? KPT_CLUSTER_DEFAULTS.gridSize;
@@ -22,7 +22,7 @@ export function clusterLocations(locations, options) {
     const zoom = options.zoom;
     if (locations.length === 0)
         return [];
-    // Powyżej progu pokazujemy wszystko osobno — użytkownik przybliżył się celowo.
+    // Powyżej progu pokazujemy wszystko osobno - użytkownik przybliżył się celowo.
     if (zoom > maxZoom || gridSize <= 0)
         return [...locations];
     const cells = new Map();
@@ -62,7 +62,7 @@ export function clusterLocations(locations, options) {
 }
 /**
  * Najliczniejsza kategoria w grupie. Remis rozstrzyga `categoryOrder`, a bez niej
- * kolejność pierwszego wystąpienia — w obu wypadkach wynik jest deterministyczny.
+ * kolejność pierwszego wystąpienia - w obu wypadkach wynik jest deterministyczny.
  */
 export function dominantCategory(items, categoryOrder) {
     const counts = new Map();
@@ -82,7 +82,7 @@ export function dominantCategory(items, categoryOrder) {
         }
         if (count < bestCount)
             continue;
-        // Remis — niższy indeks w `categoryOrder` wygrywa, a poza nią wcześniejsze wystąpienie.
+        // Remis - niższy indeks w `categoryOrder` wygrywa, a poza nią wcześniejsze wystąpienie.
         const rank = (c) => {
             const i = categoryOrder?.indexOf(c) ?? -1;
             return i >= 0 ? i : Number.MAX_SAFE_INTEGER;
@@ -93,7 +93,7 @@ export function dominantCategory(items, categoryOrder) {
     }
     return best;
 }
-/** Zlicza lokalizacje w rozbiciu na kategorie — licznik obok pozycji legendy. */
+/** Zlicza lokalizacje w rozbiciu na kategorie - licznik obok pozycji legendy. */
 export function countByCategory(locations) {
     const out = {};
     for (const loc of locations)
@@ -102,7 +102,7 @@ export function countByCategory(locations) {
 }
 /**
  * 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ść.
+ * na każdym zoomie - wtedy kliknięcie ma otworzyć listę zamiast zoomować w nieskończoność.
  */
 export function isSplittable(cluster) {
     const { south, west, north, east } = cluster.bounds;

package/dist/countries.d.ts

@@ -3,25 +3,25 @@ export 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, przy którym kraj mieści się na typowym kontenerze (~1000x600 px). */
     zoom: number;
     bounds: KptMapBounds;
 }
 /** Kod kraju użyty, gdy aplikacja nie poda żadnego. */
 export declare const KPT_MAP_DEFAULT_COUNTRY = "PL";
 /**
- * Zasięgi lądowe (bez terytoriów zamorskich) zaokrąglone do dwóch miejsc —
+ * Zasięgi lądowe (bez terytoriów zamorskich) zaokrąglone do dwóch miejsc -
  * to widok startowy, nie granica administracyjna.
  */
 export declare const KPT_MAP_COUNTRIES: Record<string, KptMapCountryPreset>;
 /** Preset kraju po kodzie (wielkość liter bez znaczenia); `undefined`, gdy nieznany. */
 export declare function countryPreset(code: string): KptMapCountryPreset | undefined;
-/** Kody wszystkich presetów — do listy wyboru w aplikacji. */
+/** Kody wszystkich presetów - do listy wyboru w aplikacji. */
 export 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]`.
+ * Zawsze zwraca coś sensownego - mapa nigdy nie startuje na `[0, 0]`.
  */
 export declare function resolveCountryView(code: string | null | undefined): KptMapCountryPreset;
-/** Środek prostokąta kraju — pomocnicze przy własnych `bounds`. */
+/** Środek prostokąta kraju - pomocnicze przy własnych `bounds`. */
 export declare function centerOfBounds(bounds: KptMapBounds): KptLatLng;

package/dist/countries.js

@@ -1,12 +1,12 @@
 /*
- * Presety widoku bazowego — pure TS. Domyślny kraj to Polska.
+ * Presety widoku bazowego - pure TS. Domyślny kraj to Polska.
  * Kto potrzebuje kraju spoza listy, podaje `[view]` albo `[bounds]` wprost.
  */
 import { boundsCenter } from "./geo.js";
 /** Kod kraju użyty, gdy aplikacja nie poda żadnego. */
 export const KPT_MAP_DEFAULT_COUNTRY = 'PL';
 /**
- * Zasięgi lądowe (bez terytoriów zamorskich) zaokrąglone do dwóch miejsc —
+ * Zasięgi lądowe (bez terytoriów zamorskich) zaokrąglone do dwóch miejsc -
  * to widok startowy, nie granica administracyjna.
  */
 export const KPT_MAP_COUNTRIES = {
@@ -33,18 +33,18 @@ export const KPT_MAP_COUNTRIES = {
 export function countryPreset(code) {
     return KPT_MAP_COUNTRIES[code?.toUpperCase()];
 }
-/** Kody wszystkich presetów — do listy wyboru w aplikacji. */
+/** Kody wszystkich presetów - do listy wyboru w aplikacji. */
 export function countryCodes() {
     return Object.keys(KPT_MAP_COUNTRIES);
 }
 /**
  * Widok startowy: preset kraju, a przy nieznanym kodzie preset domyślny.
- * Zawsze zwraca coś sensownego — mapa nigdy nie startuje na `[0, 0]`.
+ * Zawsze zwraca coś sensownego - mapa nigdy nie startuje na `[0, 0]`.
  */
 export function resolveCountryView(code) {
     return (code ? countryPreset(code) : undefined) ?? KPT_MAP_COUNTRIES[KPT_MAP_DEFAULT_COUNTRY];
 }
-/** Środek prostokąta kraju — pomocnicze przy własnych `bounds`. */
+/** Środek prostokąta kraju - pomocnicze przy własnych `bounds`. */
 export function centerOfBounds(bounds) {
     return boundsCenter(bounds);
 }

package/dist/engine.d.ts

@@ -1,5 +1,5 @@
 import type { KptLatLng, KptMapBounds, KptMapPoint, KptMapUserPosition } from './types.ts';
-/** Rodzaj silnika — trafia do `data-engine` na hoście, przydatne w testach i stylach. */
+/** Rodzaj silnika - trafia do `data-engine` na hoście, przydatne w testach i stylach. */
 export type KptMapEngineKind = 'leaflet' | 'google';
 export interface KptMapEngineInit {
     center: KptLatLng;
@@ -10,25 +10,25 @@ export interface KptMapEngineInit {
     maxBounds?: KptMapBounds | null;
     /** Szablon URL kafli, np. `https://tile.openstreetmap.org/{z}/{x}/{y}.png`. */
     tileUrl: string;
-    /** Tekst atrybucji — wymagany licencyjnie przy OSM. */
+    /** Tekst atrybucji - wymagany licencyjnie przy OSM. */
     attribution: string;
-    /** Silnik nie rysuje własnych kontrolek zoomu — robi to warstwa Angulara. */
+    /** Silnik nie rysuje własnych kontrolek zoomu - robi to warstwa Angulara. */
     interactive?: boolean;
 }
-/** Znacznik gotowy do narysowania — HTML pochodzi z `marker-html.ts`. */
+/** Znacznik gotowy do narysowania - HTML pochodzi z `marker-html.ts`. */
 export interface KptMapRenderedMarker {
     /** Stabilne id: `id` lokalizacji albo `id` grupy. */
     id: string;
     at: KptLatLng;
     html: string;
-    /** Rozmiar ikony w pikselach — silnik potrzebuje go do zakotwiczenia. */
+    /** 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. */
+    /** Kolejność rysowania - grupy nad pojedynczymi punktami. */
     zIndex?: number;
 }
 export interface KptMapPointerEvent {
@@ -39,9 +39,9 @@ export interface KptMapPointerEvent {
     originalEvent?: Event;
 }
 export interface KptMapEngineEvents {
-    /** Pan i zoom w toku — używane do przeliczania pozycji popupu. */
+    /** Pan i zoom w toku - używane do przeliczania pozycji popupu. */
     move: () => void;
-    /** Koniec ruchu — dopiero tu warto emitować `viewChange`. */
+    /** Koniec ruchu - dopiero tu warto emitować `viewChange`. */
     moveend: () => void;
     zoomend: () => void;
     click: (event: KptMapPointerEvent) => void;
@@ -64,7 +64,7 @@ export interface KptMapEngine {
         width: number;
         height: number;
     };
-    /** Współrzędne → piksele WZGLĘDEM kontenera (pozycjonowanie popupu). */
+    /** 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. */
@@ -73,12 +73,12 @@ export interface KptMapEngine {
     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. */
+    /** 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ę. */
+/** Fabryka silnika - to ją dostarcza DI, żeby każda mapa miała własną instancję. */
 export type KptMapEngineFactory = () => KptMapEngine;
-/** Domyślne źródło kafli. Do produkcji podstaw własny serwer — patrz llms.txt. */
+/** Domyślne źródło kafli. Do produkcji podstaw własny serwer - patrz llms.txt. */
 export declare const KPT_MAP_DEFAULT_TILE_URL = "https://tile.openstreetmap.org/{z}/{x}/{y}.png";
 export declare const KPT_MAP_DEFAULT_ATTRIBUTION = "&copy; <a href=\"https://www.openstreetmap.org/copyright\">OpenStreetMap</a> contributors";

package/dist/engine.js

@@ -1,3 +1,3 @@
-/** Domyślne źródło kafli. Do produkcji podstaw własny serwer — patrz llms.txt. */
+/** Domyślne źródło kafli. Do produkcji podstaw własny serwer - patrz llms.txt. */
 export const KPT_MAP_DEFAULT_TILE_URL = 'https://tile.openstreetmap.org/{z}/{x}/{y}.png';
 export const KPT_MAP_DEFAULT_ATTRIBUTION = '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors';

package/dist/engines/google.engine.d.ts

@@ -1,6 +1,6 @@
 import type { KptMapEngine } from '../engine.ts';
 /**
- * Namespace `google.maps`. Świadomie `any` — pełne typy przychodzą z opcjonalnego
+ * 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.
  */
 export type KptGoogleMapsApi = any;
@@ -8,10 +8,10 @@ export interface KptGoogleOptions {
     /** Klucz API z Google Cloud. Wymagany. */
     apiKey: string;
     /**
-     * Identyfikator stylu mapy z konsoli Google (*Map management → Create Map ID*).
+     * 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ąć.
+     * to gotowy HTML z `marker-html.ts` - starsze `Marker` nie umie go przyjąć.
      */
     mapId: string;
     /** Wersja API. Domyślnie `weekly`. */
@@ -20,7 +20,7 @@ export interface KptGoogleOptions {
     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. */
+    /** Dolny limit zoomu. Domyślnie 2 - niżej świat powtarza się w poziomie. */
     minZoom?: number;
     /** Górny limit zoomu. Domyślnie 21. */
     maxZoom?: number;
@@ -28,24 +28,24 @@ export interface KptGoogleOptions {
     scrollWheelZoom?: boolean;
 }
 /**
- * Tyle z `KptGoogleOptions`, ile trzeba do wczytania samego API. Bez `mapId` — ten dotyczy
+ * 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ą.
  */
 export 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
+ * Ł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"),
+ * 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
+ * Adaptera geokodera biblioteka nadal nie dostarcza - tylko drogę do API, którą i tak
  * otwiera silnikowi. Powody stoją przy `provideKptGoogleMap` i w `llms.txt`.
  */
 export declare function loadGoogleMapsApi(options: KptGoogleLoadOptions): Promise<KptGoogleMapsApi>;
-/** Fabryka silnika — każda mapa dostaje własną instancję. */
+/** Fabryka silnika - każda mapa dostaje własną instancję. */
 export declare function createGoogleEngine(options: KptGoogleOptions): KptMapEngine;

package/dist/engines/google.engine.js

@@ -6,17 +6,17 @@ const LOAD_ERROR = 'kpt-map: nie udało się załadować Google Maps JavaScript
 const CALLBACK = '__kptGoogleMapsReady';
 let modulePromise = null;
 /**
- * Ł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
+ * Ł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"),
+ * 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
+ * Adaptera geokodera biblioteka nadal nie dostarcza - tylko drogę do API, którą i tak
  * otwiera silnikowi. Powody stoją przy `provideKptGoogleMap` i w `llms.txt`.
  */
 export async function loadGoogleMapsApi(options) {
@@ -52,7 +52,7 @@ export async function loadGoogleMapsApi(options) {
     });
     return modulePromise;
 }
-/** Fabryka silnika — każda mapa dostaje własną instancję. */
+/** Fabryka silnika - każda mapa dostaje własną instancję. */
 export function createGoogleEngine(options) {
     return new GoogleEngine(options);
 }
@@ -65,18 +65,18 @@ class GoogleEngine {
         this.map = null;
         this.host = null;
         this.userMarker = null;
-        /** Krąg dokładności jest własnym `<div>`, nie `google.maps.Circle` — patrz `setUserPosition`. */
+        /** Krąg dokładności jest własnym `<div>`, nie `google.maps.Circle` - patrz `setUserPosition`. */
         this.accuracyEl = null;
         this.accuracyMeters = 0;
         this.accuracyAt = null;
-        /** Znaczniki po `id` wraz z ich sprzątaniem — bez tego każdy przelicz przerysowywałby mapę. */
+        /** Znaczniki po `id` wraz z ich sprzątaniem - bez tego każdy przelicz przerysowywałby mapę. */
         this.markers = new Map();
         this.listeners = [];
         this.handlers = {};
     }
     async init(host, opts) {
         const maps = (this.maps = await loadGoogleMapsApi(this.options));
-        // Pod nazwą `Map` kryje się konstruktor Google, nie wbudowana kolekcja — stąd alias.
+        // Pod nazwą `Map` kryje się konstruktor Google, nie wbudowana kolekcja - stąd alias.
         const [{ Map: GoogleMap }, markerLib] = await Promise.all([
             maps.importLibrary('maps'),
             maps.importLibrary('marker'),
@@ -89,9 +89,9 @@ class GoogleEngine {
             minZoom: opts.minZoom ?? this.options.minZoom ?? 2,
             maxZoom: opts.maxZoom ?? this.options.maxZoom ?? 21,
             mapId: this.options.mapId,
-            // Kontrolki rysuje warstwa Angulara — te same przyciski w obu silnikach.
+            // Kontrolki rysuje warstwa Angulara - te same przyciski w obu silnikach.
             disableDefaultUI: true,
-            // POI Google przechwytywałyby kliknięcia przeznaczone dla mapy (menu „dodaj lokalizację").
+            // POI Google przechwytywałyby kliknięcia przeznaczone dla mapy (menu "dodaj lokalizację").
             clickableIcons: false,
             scrollwheel: this.options.scrollWheelZoom ?? true,
             restriction: opts.maxBounds
@@ -109,7 +109,7 @@ class GoogleEngine {
         });
         this.on_(this.map, 'click', (e) => this.emit('click', this.toPointerEvent(e)));
         this.on_(this.map, 'contextmenu', (e) => {
-            // Menu przeglądarki zasłoniłoby własne „Dodaj lokalizację".
+            // Menu przeglądarki zasłoniłoby własne "Dodaj lokalizację".
             e.domEvent?.preventDefault();
             this.emit('contextmenu', this.toPointerEvent(e));
         });
@@ -132,7 +132,7 @@ class GoogleEngine {
         for (const listener of this.listeners)
             listener.remove?.();
         this.listeners.length = 0;
-        // Google nie ma odpowiednika `map.remove()` — kontener czyścimy sami.
+        // Google nie ma odpowiednika `map.remove()` - kontener czyścimy sami.
         if (this.map)
             this.maps?.event.clearInstanceListeners(this.map);
         this.host?.replaceChildren();
@@ -165,7 +165,7 @@ class GoogleEngine {
         return this.map.getZoom();
     }
     /**
-     * Zasięg widoku. `getBounds()` bywa `undefined`, zanim mapa policzy pierwszy układ —
+     * Zasięg widoku. `getBounds()` bywa `undefined`, zanim mapa policzy pierwszy układ -
      * liczymy go wtedy z rdzenia, zamiast oddawać `null` przez kontrakt, który go nie przewiduje.
      */
     getBounds() {
@@ -185,12 +185,12 @@ class GoogleEngine {
         return { width: rect?.width ?? 0, height: rect?.height ?? 0 };
     }
     /**
-     * Współrzędne → piksele kontenera.
+     * Współrzędne -> piksele kontenera.
      *
      * Świadomie **nie** przez `map.getProjection()`: ten zwraca `null` do pierwszego
      * `projection_changed` i tak czy owak wymaga ręcznego przeliczenia na piksele kontenera.
-     * Rdzeń (`core/geo.ts`) ma dokładnie tę matematykę — tę samą, na której stoi grupowanie
-     * i adapter Leafleta — więc popup ląduje piksel w piksel tak samo w obu silnikach.
+     * Rdzeń (`core/geo.ts`) ma dokładnie tę matematykę - tę samą, na której stoi grupowanie
+     * i adapter Leafleta - więc popup ląduje piksel w piksel tak samo w obu silnikach.
      * Działa też dla zoomu ułamkowego, którego Google używa przy gestach.
      */
     project(at) {
@@ -210,7 +210,7 @@ class GoogleEngine {
         return unproject({ x: origin.x + point.x - size.width / 2, y: origin.y + point.y - size.height / 2 }, zoom);
     }
     /**
-     * Wymienia zestaw znaczników różnicowo — znaczniki o niezmienionym `id` zostają na miejscu,
+     * Wymienia zestaw znaczników różnicowo - znaczniki o niezmienionym `id` zostają na miejscu,
      * inaczej każdy przelicz gasiłby animacje i migotał.
      */
     setMarkers(next) {
@@ -241,7 +241,7 @@ class GoogleEngine {
              * `L.DomEvent.stopPropagation`: bez zatrzymania propagacji to samo kliknięcie doszłoby
              * do mapy i `onMapClick()` zamknąłby popup w tej samej klatce, w której go otwieramy.
              * Przy okazji odpada zależność od tego, jak `gmp-click` zachowuje się w danej wersji API.
-             * Dostępność bez zmian — etykietę niesie `aria-label` w HTML-u ikony.
+             * Dostępność bez zmian - etykietę niesie `aria-label` w HTML-u ikony.
              */
             const onClick = (event) => {
                 event.stopPropagation();
@@ -286,13 +286,13 @@ class GoogleEngine {
                 map: this.map,
                 position: at,
                 content: this.buildUserContent(html),
-                // Nad znacznikami lokalizacji — własne położenie ma być zawsze widoczne.
+                // Nad znacznikami lokalizacji - własne położenie ma być zawsze widoczne.
                 zIndex: 1000,
             });
         }
         this.resizeAccuracy();
     }
-    /** Google dostarcza własne kafle i własną atrybucję — nie ma czego podmieniać. */
+    /** Google dostarcza własne kafle i własną atrybucję - nie ma czego podmieniać. */
     setTileSource() {
         // celowo puste
     }
@@ -301,14 +301,14 @@ class GoogleEngine {
             restriction: bounds ? { latLngBounds: this.toLatLngBounds(bounds), strictBounds: true } : null,
         });
     }
-    /** Google sam reaguje na zmianę rozmiaru kontenera — nie ma odpowiednika `invalidateSize`. */
+    /** Google sam reaguje na zmianę rozmiaru kontenera - nie ma odpowiednika `invalidateSize`. */
     invalidateSize() {
         // celowo puste
     }
     on(event, handler) {
         (this.handlers[event] ??= []).push(handler);
     }
-    // ── prywatne ────────────────────────────────────────────────────────────────
+    // -- prywatne ----------------------------------------------------------------
     emit(event, ...args) {
         for (const handler of this.handlers[event] ?? []) {
             handler(...args);
@@ -321,7 +321,7 @@ class GoogleEngine {
     /**
      * Opakowanie znacznika. `AdvancedMarkerElement` kotwiczy treść **środkiem dolnej krawędzi**,
      * a kontrakt daje kotwicę w pikselach od lewego górnego rogu ikony. Element zewnętrzny ma
-     * więc zerowe wymiary — jego „środek dolnej krawędzi" wypada dokładnie we współrzędnych —
+     * więc zerowe wymiary - jego "środek dolnej krawędzi" wypada dokładnie we współrzędnych -
      * a wewnętrzny przesuwa ikonę o żądaną kotwicę.
      */
     buildMarkerContent(m) {
@@ -339,7 +339,7 @@ class GoogleEngine {
         inner.style.top = `${-m.anchor.y}px`;
         inner.style.width = `${m.size.width}px`;
         inner.style.height = `${m.size.height}px`;
-        // HTML pochodzi z `marker-html.ts` — z rdzenia biblioteki, nie od użytkownika.
+        // HTML pochodzi z `marker-html.ts` - z rdzenia biblioteki, nie od użytkownika.
         inner.innerHTML = m.html;
     }
     /**
@@ -383,7 +383,7 @@ class GoogleEngine {
     fromDomEvent(event, at) {
         return { at, point: this.toContainerPoint(event), originalEvent: event };
     }
-    /** Google podaje zdarzenie DOM bez pozycji w kontenerze — liczymy ją z prostokąta hosta. */
+    /** Google podaje zdarzenie DOM bez pozycji w kontenerze - liczymy ją z prostokąta hosta. */
     toContainerPoint(event) {
         const rect = this.host?.getBoundingClientRect();
         if (!event || !rect)

package/dist/engines/leaflet.engine.d.ts

@@ -1,6 +1,6 @@
 import type { KptMapEngine } from '../engine.ts';
 export interface KptLeafletOptions {
-    /** Dolny limit zoomu. Domyślnie 2 — niżej świat powtarza się w poziomie. */
+    /** 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;
@@ -9,5 +9,5 @@ export interface KptLeafletOptions {
     /** Zoom kółkiem myszy. Domyślnie włączony. */
     scrollWheelZoom?: boolean;
 }
-/** Fabryka silnika — każda mapa dostaje własną instancję. */
+/** Fabryka silnika - każda mapa dostaje własną instancję. */
 export declare function createLeafletEngine(options?: KptLeafletOptions): KptMapEngine;

package/dist/engines/leaflet.engine.js

@@ -1,10 +1,10 @@
 const MODULE_LOAD_ERROR = 'kpt-map: nie udało się załadować biblioteki `leaflet`. ' +
-    'To zależność opcjonalna — zainstaluj ją w aplikacji: `pnpm add leaflet` ' +
+    'To zależność opcjonalna - zainstaluj ją w aplikacji: `pnpm add leaflet` ' +
     '(oraz dołącz `leaflet/dist/leaflet.css`).';
 let modulePromise = null;
 /**
  * Ładuje Leaflet raz na aplikację. Leaflet 1.9 jest paczką UMD/CJS bez pola `exports`,
- * więc pod bundlerem trafia raz jako `default`, a raz jako sam namespace — stąd interop.
+ * więc pod bundlerem trafia raz jako `default`, a raz jako sam namespace - stąd interop.
  */
 async function loadLeaflet() {
     modulePromise ??= import('leaflet')
@@ -15,7 +15,7 @@ async function loadLeaflet() {
     });
     return modulePromise;
 }
-/** Fabryka silnika — każda mapa dostaje własną instancję. */
+/** Fabryka silnika - każda mapa dostaje własną instancję. */
 export function createLeafletEngine(options = {}) {
     return new LeafletEngine(options);
 }
@@ -28,7 +28,7 @@ class LeafletEngine {
         this.tiles = null;
         this.userMarker = null;
         this.userCircle = null;
-        /** Znaczniki po `id` — bez tego każdy przelicz przerysowywałby całą mapę. */
+        /** Znaczniki po `id` - bez tego każdy przelicz przerysowywałby całą mapę. */
         this.markers = new Map();
         this.handlers = {};
     }
@@ -39,7 +39,7 @@ class LeafletEngine {
             zoom: opts.zoom,
             minZoom: opts.minZoom ?? this.options.minZoom ?? 2,
             maxZoom: opts.maxZoom ?? this.options.maxZoom ?? 19,
-            // Kontrolki rysuje warstwa Angulara — domyślnych nie da się otokenizować
+            // Kontrolki rysuje warstwa Angulara - domyślnych nie da się otokenizować
             // bez walki z niewarstwowanym `leaflet.css`.
             zoomControl: false,
             attributionControl: true,
@@ -58,7 +58,7 @@ class LeafletEngine {
         this.map.on('zoomend', () => this.emit('zoomend'));
         this.map.on('click', (e) => this.emit('click', this.toPointerEvent(e)));
         this.map.on('contextmenu', (e) => {
-            // Menu przeglądarki zasłoniłoby własne „Dodaj lokalizację".
+            // Menu przeglądarki zasłoniłoby własne "Dodaj lokalizację".
             L.DomEvent.preventDefault(e.originalEvent);
             this.emit('contextmenu', this.toPointerEvent(e));
         });
@@ -108,7 +108,7 @@ class LeafletEngine {
     }
     /**
      * Wymienia zestaw znaczników różnicowo. Znaczniki, których `id` się nie zmieniło,
-     * zostają na miejscu — inaczej każdy przelicz gasiłby animacje i migotał.
+     * zostają na miejscu - inaczej każdy przelicz gasiłby animacje i migotał.
      */
     setMarkers(next) {
         if (!this.map || !this.L)
@@ -171,7 +171,7 @@ class LeafletEngine {
             this.userMarker.setIcon(icon);
         }
         else {
-            // Nad znacznikami lokalizacji — własne położenie ma być zawsze widoczne.
+            // Nad znacznikami lokalizacji - własne położenie ma być zawsze widoczne.
             this.userMarker = new L.Marker(at, { icon, alt: '', keyboard: false, zIndexOffset: 1000 }).addTo(this.map);
         }
         // Promień w metrach; L.Circle sam przelicza go na piksele przy każdym zoomie.
@@ -198,7 +198,7 @@ class LeafletEngine {
             attribution,
             maxZoom: this.options.maxZoom ?? 19,
         }).addTo(this.map);
-        // Kafle wchodzą pod znaczniki — bez tego nowa warstwa przykryłaby je.
+        // Kafle wchodzą pod znaczniki - bez tego nowa warstwa przykryłaby je.
         this.tiles.bringToBack();
     }
     setMaxBounds(bounds) {
@@ -208,7 +208,7 @@ class LeafletEngine {
         this.map.options.maxBoundsViscosity = bounds ? 1 : 0;
     }
     invalidateSize() {
-        // `animate: false` — to reakcja na zmianę layoutu, nie gest użytkownika.
+        // `animate: false` - to reakcja na zmianę layoutu, nie gest użytkownika.
         this.map?.invalidateSize({ animate: false });
     }
     on(event, handler) {

package/dist/format.d.ts

@@ -2,11 +2,11 @@
  * 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".
+ * Wartość ujemna albo nieskończona daje `null` - wołający chowa wtedy wiersz,
+ * zamiast malować "NaN km".
  */
 export declare function formatDistance(metres: number | null | undefined, locale: string): string | null;
-/** Współrzędne do wiersza karty — pięć miejsc po przecinku to ok. metr. */
+/** Współrzędne do wiersza karty - pięć miejsc po przecinku to ok. metr. */
 export declare function formatLatLng(at: {
     lat: number;
     lng: number;

package/dist/format.js

@@ -1,5 +1,5 @@
 /*
- * Formatowanie liczb dla warstwy prezentacji mapy — pure TS.
+ * Formatowanie liczb dla warstwy prezentacji mapy - pure TS.
  * Wszystko przez `Intl`, więc separator dziesiętny idzie z locale,
  * a nie z zaszytej na sztywno kropki.
  */
@@ -7,8 +7,8 @@
  * 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".
+ * Wartość ujemna albo nieskończona daje `null` - wołający chowa wtedy wiersz,
+ * zamiast malować "NaN km".
  */
 export function formatDistance(metres, locale) {
     if (metres == null || !Number.isFinite(metres) || metres < 0)
@@ -26,7 +26,7 @@ export function formatDistance(metres, locale) {
     }).format(km);
     return `${value} km`;
 }
-/** Współrzędne do wiersza karty — pięć miejsc po przecinku to ok. metr. */
+/** Współrzędne do wiersza karty - pięć miejsc po przecinku to ok. metr. */
 export function formatLatLng(at, digits = 5) {
     return `${at.lat.toFixed(digits)}, ${at.lng.toFixed(digits)}`;
 }

package/dist/geo.d.ts

@@ -1,5 +1,5 @@
 import type { KptLatLng, KptMapBounds, KptMapPoint } from './types.ts';
-/** Bok kafla w pikselach — stała obu silników. */
+/** Bok kafla w pikselach - stała obu silników. */
 export declare const KPT_TILE_SIZE = 256;
 /**
  * Granica szerokości w Mercatorze. Powyżej niej projekcja ucieka do nieskończoności,
@@ -13,31 +13,31 @@ export 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
+ * 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°.
  */
 export declare function normalizeLng(lng: number): number;
 /** Liczba pikseli świata na danym zoomie. */
 export declare function worldSize(zoom: number): number;
-/** Współrzędne → piksele świata na danym zoomie (origin w lewym górnym rogu). */
+/** Współrzędne -> piksele świata na danym zoomie (origin w lewym górnym rogu). */
 export declare function project(at: KptLatLng, zoom: number): KptMapPoint;
-/** Piksele świata → współrzędne. Odwrotność `project`. */
+/** Piksele świata -> współrzędne. Odwrotność `project`. */
 export declare function unproject(point: KptMapPoint, zoom: number): KptLatLng;
-/** Najmniejszy prostokąt obejmujący wszystkie punkty. Pusta lista → `null`. */
+/** Najmniejszy prostokąt obejmujący wszystkie punkty. Pusta lista -> `null`. */
 export 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.
+ * budynek - dwa sąsiednie adresy lądują w różnych przybliżeniach.
  */
 export 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 —
+ * `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`.
  */
 export declare function isFittableBounds(bounds: KptMapBounds, minSpan?: number): boolean;
@@ -56,7 +56,7 @@ export declare function haversine(a: KptLatLng, b: KptLatLng): number;
 export 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.
+ * Zwraca liczbę zmiennoprzecinkową - zaokrąglenie w dół zostawiamy wołającemu.
  */
 export declare function zoomForBounds(bounds: KptMapBounds, size: {
     width: number;

package/dist/geo.js

@@ -1,4 +1,4 @@
-/** Bok kafla w pikselach — stała obu silników. */
+/** Bok kafla w pikselach - stała obu silników. */
 export const KPT_TILE_SIZE = 256;
 /**
  * Granica szerokości w Mercatorze. Powyżej niej projekcja ucieka do nieskończoności,
@@ -14,7 +14,7 @@ export function clampLat(lat) {
 /**
  * Zawija długość geograficzną do zakresu [-180, 180].
  *
- * Wartości już w zakresie wracają nietknięte — także -180, bo w projekcji jest to
+ * 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°.
  */
@@ -28,7 +28,7 @@ export function normalizeLng(lng) {
 export function worldSize(zoom) {
     return KPT_TILE_SIZE * Math.pow(2, zoom);
 }
-/** Współrzędne → piksele świata na danym zoomie (origin w lewym górnym rogu). */
+/** Współrzędne -> piksele świata na danym zoomie (origin w lewym górnym rogu). */
 export function project(at, zoom) {
     const size = worldSize(zoom);
     const lat = clampLat(at.lat);
@@ -38,7 +38,7 @@ export function project(at, zoom) {
         y: size * (0.5 - Math.log((1 + sin) / (1 - sin)) / (4 * Math.PI)),
     };
 }
-/** Piksele świata → współrzędne. Odwrotność `project`. */
+/** Piksele świata -> współrzędne. Odwrotność `project`. */
 export function unproject(point, zoom) {
     const size = worldSize(zoom);
     const lng = (point.x / size - 0.5) * 360;
@@ -46,7 +46,7 @@ export function unproject(point, zoom) {
     const lat = (180 / Math.PI) * Math.atan(Math.sinh(n));
     return { lat, lng };
 }
-/** Najmniejszy prostokąt obejmujący wszystkie punkty. Pusta lista → `null`. */
+/** Najmniejszy prostokąt obejmujący wszystkie punkty. Pusta lista -> `null`. */
 export function boundsOf(points) {
     if (points.length === 0)
         return null;
@@ -71,13 +71,13 @@ export function boundsOf(points) {
  *
  * 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.
+ * budynek - dwa sąsiednie adresy lądują w różnych przybliżeniach.
  */
 export 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 —
+ * `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`.
  */
 export function isFittableBounds(bounds, minSpan = KPT_MIN_FIT_SPAN) {
@@ -122,7 +122,7 @@ export function metersPerPixel(lat, zoom) {
 }
 /**
  * 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.
+ * Zwraca liczbę zmiennoprzecinkową - zaokrąglenie w dół zostawiamy wołającemu.
  */
 export function zoomForBounds(bounds, size, paddingPx = 0) {
     const w = Math.max(1, size.width - paddingPx * 2);

package/dist/hours.d.ts

@@ -9,33 +9,33 @@ export 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.
+ * (`22:00 - 01:00`) obejmuje wczesne godziny dnia następnego.
  */
 export 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". */
+/** Czy rozkład to pełna doba przez siedem dni - wtedy karta pisze po prostu "24/7". */
 export declare function isAlwaysOpen(hours: KptMapOpeningHours | undefined): boolean;
 /** Najbliższa zmiana stanu otwarte/zamknięte albo `null`, gdy w ciągu tygodnia jej nie ma. */
 export 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. */
+/** Skrócona nazwa dnia z `Intl` - bez słownika, więc działa dla dowolnego locale. */
 export declare function weekdayName(day: KptMapWeekday, locale: string): string;
 /** Wiersz rozkładu: jeden dzień albo sklejony zakres dni o identycznych godzinach. */
 export interface KptMapHoursGroup {
-    /** `pon.` albo `wt.–sob.`, wg locale. */
+    /** `pon.` albo `wt.-sob.`, wg locale. */
     label: string;
     days: KptMapWeekday[];
     closed: boolean;
-    /** Sformatowane przedziały, np. `['11:00 – 24:00']`. Puste, gdy zamknięte. */
+    /** 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ń
+ * 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.
  */
 export declare function groupWeek(hours: KptMapOpeningHours | undefined, locale: string, separator?: string): KptMapHoursGroup[];
-/** Siedem dni oznaczonych jako zamknięte — wartość startowa pola `hours` w formularzu. */
+/** Siedem dni oznaczonych jako zamknięte - wartość startowa pola `hours` w formularzu. */
 export declare function emptyWeek(): KptMapOpeningHours;

package/dist/hours.js

@@ -1,10 +1,10 @@
 /*
- * Godziny otwarcia — pure TS, bez Angulara i bez silnika mapowego.
+ * Godziny otwarcia - pure TS, bez Angulara i bez silnika mapowego.
  * Ten plik przenosi się do portu React bez zmian.
  *
  * Umowa o czasie: `HH:MM` w czasie lokalnym miejsca, a porównania robimy
  * na lokalnym czasie przeglądarki. Miejsce w innej strefie niż użytkownik
- * pokaże więc status wg zegara użytkownika — to świadome uproszczenie,
+ * pokaże więc status wg zegara użytkownika - to świadome uproszczenie,
  * bo model nie niesie strefy. Kto potrzebuje inaczej, liczy status u siebie.
  */
 /** Minuta doby dla `HH:MM`; `24:00` to 1440. `null`, gdy zapis jest nieprawidłowy. */
@@ -50,7 +50,7 @@ function usableRanges(entry) {
  * 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.
+ * (`22:00 - 01:00`) obejmuje wczesne godziny dnia następnego.
  */
 export function isOpenAt(hours, date) {
     if (!hours || hours.length === 0)
@@ -71,7 +71,7 @@ export function isOpenAt(hours, date) {
     }
     return false;
 }
-/** Czy rozkład to pełna doba przez siedem dni — wtedy karta pisze po prostu „24/7". */
+/** Czy rozkład to pełna doba przez siedem dni - wtedy karta pisze po prostu "24/7". */
 export function isAlwaysOpen(hours) {
     if (!hours)
         return false;
@@ -117,7 +117,7 @@ export function nextChange(hours, date) {
     }
     return null;
 }
-/** Skrócona nazwa dnia z `Intl` — bez słownika, więc działa dla dowolnego locale. */
+/** Skrócona nazwa dnia z `Intl` - bez słownika, więc działa dla dowolnego locale. */
 export function weekdayName(day, locale) {
     // 2024-01-01 był poniedziałkiem, więc dzień ISO wypada na tę samą liczbę w miesiącu.
     const date = new Date(Date.UTC(2024, 0, day));
@@ -132,10 +132,10 @@ function signatureOf(entry) {
 /**
  * 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ń
+ * 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.
  */
-export function groupWeek(hours, locale, separator = ' – ') {
+export function groupWeek(hours, locale, separator = ' - ') {
     if (!hours || hours.length === 0)
         return [];
     const groups = [];
@@ -160,11 +160,11 @@ export function groupWeek(hours, locale, separator = ' – ') {
     for (const group of groups) {
         const first = weekdayName(group.days[0], locale);
         const last = weekdayName(group.days[group.days.length - 1], locale);
-        group.label = group.days.length === 1 ? first : `${first}–${last}`;
+        group.label = group.days.length === 1 ? first : `${first}-${last}`;
     }
     return groups;
 }
-/** Siedem dni oznaczonych jako zamknięte — wartość startowa pola `hours` w formularzu. */
+/** Siedem dni oznaczonych jako zamknięte - wartość startowa pola `hours` w formularzu. */
 export function emptyWeek() {
     return Array.from({ length: 7 }, (_, i) => ({
         day: (i + 1),

package/dist/index.js

@@ -1,5 +1,5 @@
 /*
- * Rdzeń mapy — pure TS, bez frameworka. Obok obliczeń (geometria, klastrowanie, godziny)
+ * Rdzeń mapy - pure TS, bez frameworka. Obok obliczeń (geometria, klastrowanie, godziny)
  * mieszkają tu adaptery silników: Leaflet i Google. Oba rozmawiają z resztą kodu wyłącznie
  * przez interfejs `KptMapEngine`, więc port Angulara i Reacta dzielą całą tę warstwę.
  */

package/dist/marker-html.d.ts

@@ -1,8 +1,8 @@
 import type { KptMapColor, KptMapMarkerShape } from './types.ts';
-/** Rola koloru → zmienna CSS. Gotowe `var(--kpt-*)` przechodzi bez zmian; cokolwiek spoza tego
+/** Rola koloru -> zmienna CSS. Gotowe `var(--kpt-*)` przechodzi bez zmian; cokolwiek spoza tego
  *  kontraktu dostaje bezpieczny fallback zamiast trafić surowo do wyjścia. */
 export declare function colorVarOf(color: KptMapColor): string;
-/** Kolor treści na tle `color` — dla ról znany, dla własnych zmiennych fallback na biel tokenową. */
+/** Kolor treści na tle `color` - dla ról znany, dla własnych zmiennych fallback na biel tokenową. */
 export declare function contrastVarOf(color: KptMapColor): string;
 export declare function foregroundVarOf(color: KptMapColor): string;
 /** Ucieka znaki, które rozbiłyby atrybut albo wstrzyknęły znacznik. */
@@ -12,9 +12,9 @@ export interface KptMarkerHtmlInput {
     color: KptMapColor;
     /** Inner-SVG ikony (bez wrappera `<svg>`); bez niego znacznik nie ma glifu. */
     iconSvgInner?: string;
-    /** Tekst dla czytnika ekranu — zwykle tytuł lokalizacji. */
+    /** Tekst dla czytnika ekranu - zwykle tytuł lokalizacji. */
     label: string;
-    /** Znacznik wybrany (otwarty popup) — dostaje klasę modyfikującą. */
+    /** Znacznik wybrany (otwarty popup) - dostaje klasę modyfikującą. */
     selected?: boolean;
 }
 export declare function renderMarkerHtml(input: KptMarkerHtmlInput): string;
@@ -26,11 +26,11 @@ export interface KptClusterHtmlInput {
 }
 /** Koło z licznikiem; rozmiar rośnie schodkowo z liczebnością grupy. */
 export declare function renderClusterHtml(input: KptClusterHtmlInput): string;
-/** Próg wielkości grupy — trzy stopnie wystarczą, żeby zobaczyć różnicę bez skalowania ciągłego. */
+/** Próg wielkości grupy - trzy stopnie wystarczą, żeby zobaczyć różnicę bez skalowania ciągłego. */
 export declare function clusterTier(count: number): 'sm' | 'md' | 'lg';
-/** Powyżej 999 licznik przestaje się mieścić — skracamy. */
+/** Powyżej 999 licznik przestaje się mieścić - skracamy. */
 export declare function formatCount(count: number): string;
-/** Znacznik pozycji użytkownika — ikona podawana z zewnątrz, jak przy zwykłym znaczniku. */
+/** Znacznik pozycji użytkownika - ikona podawana z zewnątrz, jak przy zwykłym znaczniku. */
 export declare function renderUserMarkerHtml(input: {
     label: string;
     iconSvgInner?: string;

package/dist/marker-html.js

@@ -15,14 +15,14 @@ const ROLE_CONTRAST_VARS = {
     muted: 'var(--kpt-color-on-muted)',
 };
 /**
- * Kształt jedynego wejścia spoza znanej roli, jakie kontrakt `KptMapColor` dopuszcza —
+ * Kształt jedynego wejścia spoza znanej roli, jakie kontrakt `KptMapColor` dopuszcza -
  * gotowy token `var(--kpt-*)`. Dane runtime (JSON/CMS) nie są tym kontraktem związane, więc
  * zanim trafią do atrybutu `style="..."` budowanego konkatenacją stringów w `renderMarkerHtml`/
- * `renderClusterHtml`, muszą zostać zweryfikowane — inaczej cudzysłów/`>` wyrywa się z atrybutu
+ * `renderClusterHtml`, muszą zostać zweryfikowane - inaczej cudzysłów/`>` wyrywa się z atrybutu
  * (HTML injection), a średnik wstrzykuje dodatkową deklarację CSS.
  */
 const SAFE_VAR_TOKEN = /^var\(--kpt-[\w-]+\)$/;
-/** Rola koloru → zmienna CSS. Gotowe `var(--kpt-*)` przechodzi bez zmian; cokolwiek spoza tego
+/** Rola koloru -> zmienna CSS. Gotowe `var(--kpt-*)` przechodzi bez zmian; cokolwiek spoza tego
  *  kontraktu dostaje bezpieczny fallback zamiast trafić surowo do wyjścia. */
 export function colorVarOf(color) {
     const known = ROLE_VARS[color];
@@ -30,7 +30,7 @@ export function colorVarOf(color) {
         return known;
     return SAFE_VAR_TOKEN.test(color) ? color : ROLE_VARS.muted;
 }
-/** Kolor treści na tle `color` — dla ról znany, dla własnych zmiennych fallback na biel tokenową. */
+/** Kolor treści na tle `color` - dla ról znany, dla własnych zmiennych fallback na biel tokenową. */
 export function contrastVarOf(color) {
     return ROLE_CONTRAST_VARS[color] ?? 'var(--kpt-color-text-inverse)';
 }
@@ -38,7 +38,7 @@ export function contrastVarOf(color) {
  * Kolor **glifu stojącego wprost na powierzchni**, bez własnego tła.
  *
  * Różni się od `colorVarOf()` tylko dla roli `muted`: `--kpt-color-muted` to neutral-100,
- * czyli token tła, a nie treści — goły znak w tym kolorze na jasnej powierzchni jest
+ * czyli token tła, a nie treści - goły znak w tym kolorze na jasnej powierzchni jest
  * niewidoczny. Bierzemy więc czytelny szary tekstowy. Pozostałe role są nasycone
  * i jako treść czytają się bez zmian.
  */
@@ -63,11 +63,11 @@ export function escapeHtml(value) {
 }
 /**
  * Pinezka o wysokości `--kpt-map-marker-size`, zakotwiczona czubkiem w punkcie.
- * `viewBox` 24×32: 24 szerokości koła + ogon do 32.
+ * `viewBox` 24x32: 24 szerokości koła + ogon do 32.
  */
 const PIN_PATH = 'M12 0C5.8 0 .8 5 .8 11.2c0 8 9.9 19.4 10.3 19.9a1.2 1.2 0 0 0 1.8 0c.4-.5 10.3-11.9 10.3-19.9C23.2 5 18.2 0 12 0z';
 export function renderMarkerHtml(input) {
-    // `shape` trafia do atrybutu `class="..."` konkatenacją stringów — `KptMapMarkerShape` ogranicza
+    // `shape` trafia do atrybutu `class="..."` konkatenacją stringów - `KptMapMarkerShape` ogranicza
     // to tylko compile-time, dane runtime (JSON/CMS) nie są tym związane (ten sam powód, dla którego
     // `color`/`contrast` dostały escapowanie/whitelistę wyżej w pliku).
     const shape = escapeHtml(input.shape ?? 'pin');
@@ -96,7 +96,7 @@ export function renderClusterHtml(input) {
         ` style="--_kpt-map-cluster-bg:${color};--_kpt-map-cluster-fg:${contrast}">` +
         `<span class="kpt-map__cluster-count">${formatCount(input.count)}</span></div>`);
 }
-/** Próg wielkości grupy — trzy stopnie wystarczą, żeby zobaczyć różnicę bez skalowania ciągłego. */
+/** Próg wielkości grupy - trzy stopnie wystarczą, żeby zobaczyć różnicę bez skalowania ciągłego. */
 export function clusterTier(count) {
     if (count < 10)
         return 'sm';
@@ -104,11 +104,11 @@ export function clusterTier(count) {
         return 'md';
     return 'lg';
 }
-/** Powyżej 999 licznik przestaje się mieścić — skracamy. */
+/** Powyżej 999 licznik przestaje się mieścić - skracamy. */
 export function formatCount(count) {
     return count > 999 ? '999+' : String(count);
 }
-/** Znacznik pozycji użytkownika — ikona podawana z zewnątrz, jak przy zwykłym znaczniku. */
+/** Znacznik pozycji użytkownika - ikona podawana z zewnątrz, jak przy zwykłym znaczniku. */
 export function renderUserMarkerHtml(input) {
     const label = escapeHtml(input.label);
     const glyph = input.iconSvgInner

package/dist/types.d.ts

@@ -10,20 +10,20 @@ export interface KptMapBounds {
     north: number;
     east: number;
 }
-/** Punkt w pikselach — kontenera mapy albo świata, zależnie od kontekstu. */
+/** Punkt w pikselach - kontenera mapy albo świata, zależnie od kontekstu. */
 export 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.
+ * Literały (`#c00`, `rgb(...)`) są celowo niedozwolone - kontrakt repo wymaga tokenów.
  */
 export type KptMapColorRole = 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'muted';
 export type KptMapColor = KptMapColorRole | `var(--kpt-${string})`;
 /** Kształt znacznika. */
 export type KptMapMarkerShape = 'pin' | 'dot' | 'square';
-/** Typ pola w schemie formularza „dodaj lokalizację". */
+/** Typ pola w schemie formularza "dodaj lokalizację". */
 export type KptMapFieldType = 'text' | 'textarea' | 'number' | 'date' | 'select' | 'multiselect' | 'checkbox' | 'tel' | 'email' | 'url'
 /** Zdjęcie: wybór pliku (wartość jako `data:`) albo wklejony adres. */
  | 'image'
@@ -59,12 +59,12 @@ export interface KptMapFieldDef {
      */
     autofill?: KptMapAddressPart;
 }
-/** Rozbiór adresu zwracany przez geokoder. Wszystko opcjonalne — źródła bywają dziurawe. */
+/** Rozbiór adresu zwracany przez geokoder. Wszystko opcjonalne - źródła bywają dziurawe. */
 export interface KptMapAddress {
     /** Nazwa ulicy bez numeru. */
     street?: string;
     houseNumber?: string;
-    /** Ulica z numerem, gotowa do jednego pola „Adres". */
+    /** Ulica z numerem, gotowa do jednego pola "Adres". */
     address?: string;
     city?: string;
     postcode?: string;
@@ -81,23 +81,23 @@ export interface KptMapAddress {
 /** Pole `KptMapAddress`, którym można wypełnić kontrolkę formularza. */
 export type KptMapAddressPart = keyof KptMapAddress;
 /**
- * Podpowiedź z listy wyszukiwarki adresów (geokodowanie wprost: tekst → miejsce).
+ * 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.
+ * dostawcy - Nominatim, instancji własnej i komercyjnej.
  */
 export interface KptMapSuggestion {
-    /** Stabilny w obrębie jednej odpowiedzi — służy za klucz `track` listy podpowiedzi. */
+    /** 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
+     * 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
+     * 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ć.
      */
@@ -107,11 +107,11 @@ export interface KptMapSuggestion {
      * zamiast dostać punktowy zoom w środek rynku.
      */
     bounds?: KptMapBounds;
-    /** Rozbiór adresu, gdy dostawca go podaje — ten sam typ, co przy geokodowaniu wstecznym. */
+    /** Rozbiór adresu, gdy dostawca go podaje - ten sam typ, co przy geokodowaniu wstecznym. */
     address?: KptMapAddress;
 }
 /**
- * Wybrane miejsce — podpowiedź z **pewnymi** współrzędnymi.
+ * 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
@@ -120,7 +120,7 @@ export interface KptMapSuggestion {
 export interface KptMapSearchResult extends KptMapSuggestion {
     at: KptLatLng;
 }
-/** Kategoria obiektu — kolor, ikona i schema formularza. */
+/** Kategoria obiektu - kolor, ikona i schema formularza. */
 export interface KptMapCategory {
     id: string;
     /** Etykieta w legendzie i domyślnym popupie. */
@@ -130,7 +130,7 @@ export interface KptMapCategory {
     icon?: string;
     /** Domyślnie `'pin'`. */
     shape?: KptMapMarkerShape;
-    /** Schema formularza „dodaj lokalizację" dla tej kategorii. */
+    /** Schema formularza "dodaj lokalizację" dla tej kategorii. */
     fields?: KptMapFieldDef[];
     /** Pokazać w legendzie. Domyślnie `true`. */
     legend?: boolean;
@@ -140,7 +140,7 @@ export interface KptMapLocation<T = unknown> {
     id: string;
     at: KptLatLng;
     categoryId: string;
-    /** Tytuł w popupie oraz `aria-label` znacznika — bez niego znacznik jest niedostępny. */
+    /** 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;
@@ -152,10 +152,10 @@ export interface KptMapCluster<T = unknown> {
     /** Środek ciężkości grupy. */
     at: KptLatLng;
     count: number;
-    /** Najliczniejsza kategoria w grupie — źródło koloru przy `clusterColorBy: 'dominant'`. */
+    /** Najliczniejsza kategoria w grupie - źródło koloru przy `clusterColorBy: 'dominant'`. */
     dominantCategoryId: string;
     items: KptMapLocation<T>[];
-    /** Zasięg grupy — do `fitBounds` po kliknięciu. */
+    /** Zasięg grupy - do `fitBounds` po kliknięciu. */
     bounds: KptMapBounds;
 }
 /** Element wyniku grupowania: albo grupa, albo pojedyncza lokalizacja. */
@@ -183,17 +183,17 @@ export interface KptMapCreateEvent {
     /** Wartości pól wg schemy kategorii (albo z własnego szablonu formularza). */
     value: Record<string, unknown>;
 }
-/** Widok mapy — środek i zoom. */
+/** Widok mapy - środek i zoom. */
 export interface KptMapView {
     center: KptLatLng;
     zoom: number;
 }
-/** Dzień tygodnia wg ISO-8601: 1 = poniedziałek … 7 = niedziela. */
+/** Dzień tygodnia wg ISO-8601: 1 = poniedziałek ... 7 = niedziela. */
 export 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ę
+ * `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.
  */
 export interface KptMapHoursRange {
@@ -203,13 +203,13 @@ export interface KptMapHoursRange {
 /** Godziny jednego dnia tygodnia. */
 export interface KptMapDayHours {
     day: KptMapWeekday;
-    /** Zamknięte przez całą dobę — `ranges` jest wtedy ignorowane. */
+    /** Zamknięte przez całą dobę - `ranges` jest wtedy ignorowane. */
     closed?: boolean;
     ranges: KptMapHoursRange[];
 }
-/** Tygodniowy rozkład godzin. Brakujący dzień znaczy „zamknięte". */
+/** Tygodniowy rozkład godzin. Brakujący dzień znaczy "zamknięte". */
 export type KptMapOpeningHours = KptMapDayHours[];
-/** Wiersz „ikona + etykieta + wartość" w karcie miejsca. */
+/** Wiersz "ikona + etykieta + wartość" w karcie miejsca. */
 export interface KptMapPoiFact {
     /** Nazwa ikony z `KptIconRegistry`; bez niej wiersz jest bez glifu. */
     icon?: string;
@@ -218,7 +218,7 @@ export interface KptMapPoiFact {
 }
 /**
  * Dane karty miejsca (`kpt-map-poi-card`). Aplikacja mapuje na to swój
- * `KptMapLocation.data` — biblioteka nie narzuca kształtu danych domenowych.
+ * `KptMapLocation.data` - biblioteka nie narzuca kształtu danych domenowych.
  */
 export interface KptMapPoi {
     title: string;

package/dist/types.js

@@ -1,5 +1,5 @@
 /*
- * Typy rdzenia mapy — pure TS, zero Angulara i zero silnika mapowego.
+ * Typy rdzenia mapy - pure TS, zero Angulara i zero silnika mapowego.
  * Ten plik przenosi się do portu React bez zmian.
  */
 /** Zawęża wynik `clusterLocations` do grupy. */

package/dist/url.d.ts

@@ -1,6 +1,6 @@
 /**
- * Adres bez schematu dostaje `https://` — inaczej przeglądarka potraktuje go jak ścieżkę względną.
- * Schemat spoza allowlisty (np. `javascript:`) traktujemy jak brak schematu — bezpieczny
+ * Adres bez schematu dostaje `https://` - inaczej przeglądarka potraktuje go jak ścieżkę względną.
+ * Schemat spoza allowlisty (np. `javascript:`) traktujemy jak brak schematu - bezpieczny
  * fallback zamiast przepuszczenia surowej wartości do `[href]`/`[src]`/`navigator.share()`.
  */
 export declare function normalizeUrl(value: string): string;

package/dist/url.js

@@ -1,12 +1,12 @@
 /*
- * Normalizacja adresów dla karty POI — pure TS. Wydzielone z `map-poi-card.component.ts`,
+ * Normalizacja adresów dla karty POI - pure TS. Wydzielone z `map-poi-card.component.ts`,
  * żeby dało się to testować `node --test` bez ciągnięcia Angulara.
  */
 const HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
 const SAFE_SCHEME = /^(https?:|mailto:|tel:)/i;
 /**
- * Adres bez schematu dostaje `https://` — inaczej przeglądarka potraktuje go jak ścieżkę względną.
- * Schemat spoza allowlisty (np. `javascript:`) traktujemy jak brak schematu — bezpieczny
+ * Adres bez schematu dostaje `https://` - inaczej przeglądarka potraktuje go jak ścieżkę względną.
+ * Schemat spoza allowlisty (np. `javascript:`) traktujemy jak brak schematu - bezpieczny
  * fallback zamiast przepuszczenia surowej wartości do `[href]`/`[src]`/`navigator.share()`.
  */
 export function normalizeUrl(value) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@konce-pt/map",
-  "version": "0.12.0",
-  "description": "Map core for Koncept UI — projection and bounds maths, marker clustering, opening hours, marker markup, plus the Leaflet and Google engine adapters. Framework-free TypeScript, zero runtime dependencies.",
+  "version": "0.14.0",
+  "description": "Map core for Koncept UI - projection and bounds maths, marker clustering, opening hours, marker markup, plus the Leaflet and Google engine adapters. Framework-free TypeScript, zero runtime dependencies.",
   "license": "MIT",
   "author": "konce.pt",
   "homepage": "https://ui.konce.pt/",