kor-mapi 0.1.0

package/dist/core.d.ts

@@ -0,0 +1,206 @@
+import { l as MapProvider, f as KorMapConfig, L as LatLng, j as LatLngBounds, e as FitBoundsOptions, r as PanOptions, m as MapTypeId, i as KorMapFeature, h as KorMapEvent, A as AnyEventHandler, E as EventListener, q as MarkerOptions, O as OverlayEvent, I as InfoWindowOptions, u as PolylineOptions, t as PolygonOptions, a as CircleOptions, R as RectangleOptions, d as CustomOverlayOptions, y as TileLayerOptions, k as MapProjection } from './types-BWnSkE6e.js';
+export { C as ClusterOptions, b as ClusterStyle, c as ConfigurationError, F as FillStyle, K as KorMapApiKey, g as KorMapError, M as MapMouseEvent, n as MarkerAnimation, o as MarkerIcon, p as MarkerLabel, P as Padding, s as Point, v as ProviderLoadError, w as ProviderNotSupportedError, S as Size, x as StrokeStyle, T as TileCoord } from './types-BWnSkE6e.js';
+
+/**
+ * The contract every provider adapter must implement.
+ *
+ * All zoom values crossing this interface are in the facade's 0–22 scale
+ * (Google-style, 0 = world view, 22 = building level). Adapters are
+ * responsible for translating to/from their native scale internally.
+ *
+ * All coordinate values are WGS84 LatLng.
+ */
+interface IMapProvider {
+    readonly provider: MapProvider;
+    /** Initialize the native map inside the given container element. */
+    init(container: HTMLElement, config: KorMapConfig): Promise<void>;
+    /** Destroy the map and release all resources. */
+    destroy(): void;
+    setCenter(latlng: LatLng): void;
+    getCenter(): LatLng;
+    /** @param zoom Facade zoom level 0–22 */
+    setZoom(zoom: number): void;
+    /** @returns Facade zoom level 0–22 */
+    getZoom(): number;
+    getBounds(): LatLngBounds;
+    fitBounds(bounds: LatLngBounds, options?: FitBoundsOptions): void;
+    panTo(latlng: LatLng, options?: PanOptions): void;
+    panBy(x: number, y: number): void;
+    setMapType(type: MapTypeId): void;
+    getMapType(): MapTypeId;
+    supports(feature: KorMapFeature): boolean;
+    on(event: KorMapEvent, handler: AnyEventHandler): EventListener;
+    once(event: KorMapEvent, handler: AnyEventHandler): EventListener;
+    off(event: KorMapEvent, listener: EventListener): void;
+    addMarker(options: MarkerOptions): NativeMarkerHandle;
+    removeMarker(handle: NativeMarkerHandle): void;
+    updateMarker(handle: NativeMarkerHandle, options: Partial<MarkerOptions>): void;
+    addMarkerEvent(handle: NativeMarkerHandle, event: OverlayEvent, handler: AnyEventHandler): EventListener;
+    removeMarkerEvent(handle: NativeMarkerHandle, event: OverlayEvent, listener: EventListener): void;
+    openInfoWindow(options: InfoWindowOptions, anchor?: NativeMarkerHandle): NativeInfoWindowHandle;
+    closeInfoWindow(handle: NativeInfoWindowHandle): void;
+    updateInfoWindow(handle: NativeInfoWindowHandle, options: Partial<InfoWindowOptions>): void;
+    isInfoWindowOpen(handle: NativeInfoWindowHandle): boolean;
+    addPolyline(options: PolylineOptions): NativeOverlayHandle;
+    removePolyline(handle: NativeOverlayHandle): void;
+    updatePolyline(handle: NativeOverlayHandle, options: Partial<PolylineOptions>): void;
+    addPolygon(options: PolygonOptions): NativeOverlayHandle;
+    removePolygon(handle: NativeOverlayHandle): void;
+    updatePolygon(handle: NativeOverlayHandle, options: Partial<PolygonOptions>): void;
+    addCircle(options: CircleOptions): NativeOverlayHandle;
+    removeCircle(handle: NativeOverlayHandle): void;
+    updateCircle(handle: NativeOverlayHandle, options: Partial<CircleOptions>): void;
+    addRectangle(options: RectangleOptions): NativeOverlayHandle;
+    removeRectangle(handle: NativeOverlayHandle): void;
+    updateRectangle(handle: NativeOverlayHandle, options: Partial<RectangleOptions>): void;
+    addCustomOverlay(options: CustomOverlayOptions): NativeOverlayHandle;
+    removeCustomOverlay(handle: NativeOverlayHandle): void;
+    addTileLayer(options: TileLayerOptions): NativeOverlayHandle;
+    removeTileLayer(handle: NativeOverlayHandle): void;
+    getProjection(): MapProjection;
+    /** The raw underlying map object. Type depends on provider. */
+    readonly nativeMap: unknown;
+}
+/**
+ * Opaque handle referencing a native marker instance inside an adapter.
+ * The adapter stores the actual native object and looks it up by handle id.
+ */
+interface NativeMarkerHandle {
+    readonly _handleId: number;
+}
+/**
+ * Opaque handle referencing a native overlay (polyline, polygon, circle, etc.)
+ * or info window inside an adapter.
+ */
+interface NativeOverlayHandle {
+    readonly _handleId: number;
+}
+/** Opaque handle referencing a native info window instance. */
+interface NativeInfoWindowHandle {
+    readonly _handleId: number;
+}
+
+/**
+ * The main facade. Create via `KorMap.create(config)`.
+ *
+ * Type parameter P narrows the type of `map.native`:
+ *   const map = await KorMap.create<'naver'>({ provider: 'naver', ... });
+ *   map.native  // typed as naver.maps.Map
+ */
+declare class KorMap<P extends MapProvider = MapProvider> {
+    private readonly adapter;
+    private constructor();
+    /**
+     * Async factory. Loads the provider SDK and initializes the map.
+     */
+    static create<P extends MapProvider = MapProvider>(config: KorMapConfig<P>): Promise<KorMap<P>>;
+    getProvider(): P;
+    supports(feature: KorMapFeature): boolean;
+    /**
+     * The raw underlying map object.
+     * Typed via generic when the provider is known at compile time:
+     *   const map = await KorMap.create<'naver'>({ provider: 'naver', ... });
+     *   map.native  // → naver.maps.Map
+     */
+    get native(): P extends 'naver' ? typeof window.naver.maps.Map.prototype : P extends 'kakao' ? typeof window.kakao.maps.Map.prototype : P extends 'google' ? typeof window.google.maps.Map.prototype : unknown;
+    setCenter(latlng: LatLng): void;
+    getCenter(): LatLng;
+    setZoom(zoom: number): void;
+    getZoom(): number;
+    getBounds(): LatLngBounds;
+    fitBounds(bounds: LatLngBounds, options?: FitBoundsOptions): void;
+    panTo(latlng: LatLng, options?: PanOptions): void;
+    panBy(x: number, y: number): void;
+    setMapType(type: MapTypeId): void;
+    getMapType(): MapTypeId;
+    on(event: KorMapEvent, handler: AnyEventHandler): EventListener;
+    once(event: KorMapEvent, handler: AnyEventHandler): EventListener;
+    off(event: KorMapEvent, listener: EventListener): void;
+    destroy(): void;
+    /** @internal */
+    _adapter(): IMapProvider;
+}
+
+declare class Marker {
+    private options;
+    private handle;
+    private currentMap;
+    constructor(options: MarkerOptions);
+    setMap(map: KorMap | null): void;
+    getMap(): KorMap | null;
+    setPosition(latlng: LatLng): void;
+    getPosition(): LatLng;
+    setVisible(visible: boolean): void;
+    setOpacity(opacity: number): void;
+    setZIndex(zIndex: number): void;
+    setDraggable(draggable: boolean): void;
+    setIcon(icon: MarkerOptions['icon']): void;
+    setOptions(options: Partial<MarkerOptions>): void;
+    on(event: OverlayEvent, handler: AnyEventHandler): EventListener | null;
+    off(event: OverlayEvent, listener: EventListener): void;
+}
+declare class InfoWindow {
+    private options;
+    private handle;
+    private currentMap;
+    constructor(options: InfoWindowOptions);
+    open(map: KorMap, anchor?: Marker): void;
+    close(): void;
+    setContent(content: string | HTMLElement): void;
+    getContent(): string | HTMLElement;
+    setPosition(latlng: LatLng): void;
+    isOpen(): boolean;
+}
+declare class Polyline {
+    private options;
+    private handle;
+    private currentMap;
+    constructor(options: PolylineOptions);
+    setMap(map: KorMap | null): void;
+    setOptions(options: Partial<PolylineOptions>): void;
+}
+declare class Polygon {
+    private options;
+    private handle;
+    private currentMap;
+    constructor(options: PolygonOptions);
+    setMap(map: KorMap | null): void;
+    setOptions(options: Partial<PolygonOptions>): void;
+}
+declare class Circle {
+    private options;
+    private handle;
+    private currentMap;
+    constructor(options: CircleOptions);
+    setMap(map: KorMap | null): void;
+    setOptions(options: Partial<CircleOptions>): void;
+}
+declare class Rectangle {
+    private options;
+    private handle;
+    private currentMap;
+    constructor(options: RectangleOptions);
+    setMap(map: KorMap | null): void;
+    setOptions(options: Partial<RectangleOptions>): void;
+}
+declare abstract class CustomOverlay {
+    protected options: CustomOverlayOptions;
+    private handle;
+    private currentMap;
+    constructor(options: CustomOverlayOptions);
+    abstract onAdd(): void;
+    abstract onRemove(): void;
+    abstract draw(): void;
+    setMap(map: KorMap | null): void;
+    setPosition(latlng: LatLng): void;
+    getPosition(): LatLng;
+}
+declare class TileLayer {
+    private options;
+    private handle;
+    private currentMap;
+    constructor(options: TileLayerOptions);
+    setMap(map: KorMap | null): void;
+}
+
+export { AnyEventHandler, Circle, CircleOptions, CustomOverlay, CustomOverlayOptions, EventListener, FitBoundsOptions, InfoWindow, InfoWindowOptions, KorMap, KorMapConfig, KorMapEvent, KorMapFeature, LatLng, LatLngBounds, MapProjection, MapProvider, MapTypeId, Marker, MarkerOptions, OverlayEvent, PanOptions, Polygon, PolygonOptions, Polyline, PolylineOptions, Rectangle, RectangleOptions, TileLayer, TileLayerOptions };

package/dist/core.js

@@ -0,0 +1,4 @@
+export { Circle, ConfigurationError, CustomOverlay, InfoWindow, KorMap, KorMapError, Marker, Polygon, Polyline, ProviderLoadError, ProviderNotSupportedError, Rectangle, TileLayer } from './chunk-222QLGRB.js';
+export { MapTypeId, MarkerAnimation } from './chunk-HUS54ONW.js';
+//# sourceMappingURL=core.js.map
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"core.js"}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import { KorMap, Marker } from './core.js';
+export { Circle, CustomOverlay, InfoWindow, Polygon, Polyline, Rectangle, TileLayer } from './core.js';
+import { C as ClusterOptions } from './types-BWnSkE6e.js';
+export { A as AnyEventHandler, a as CircleOptions, b as ClusterStyle, c as ConfigurationError, d as CustomOverlayOptions, E as EventListener, F as FillStyle, e as FitBoundsOptions, I as InfoWindowOptions, K as KorMapApiKey, f as KorMapConfig, g as KorMapError, h as KorMapEvent, i as KorMapFeature, L as LatLng, j as LatLngBounds, M as MapMouseEvent, k as MapProjection, l as MapProvider, m as MapTypeId, n as MarkerAnimation, o as MarkerIcon, p as MarkerLabel, q as MarkerOptions, O as OverlayEvent, P as Padding, r as PanOptions, s as Point, t as PolygonOptions, u as PolylineOptions, v as ProviderLoadError, w as ProviderNotSupportedError, R as RectangleOptions, S as Size, x as StrokeStyle, T as TileCoord, y as TileLayerOptions } from './types-BWnSkE6e.js';
+
+/**
+ * Grid-based marker clusterer that works across all three providers.
+ *
+ * Clusters are rendered as `CustomOverlay` div elements so no external
+ * dependencies or provider-specific clustering plugins are needed.
+ *
+ * On each `idle` event the visible viewport is re-gridded using a self-contained
+ * Web Mercator projection (provider-agnostic). Markers whose world-pixel
+ * coordinates fall in the same `gridSize×gridSize` cell are collapsed into a
+ * single cluster badge. Clicking a cluster badge calls `fitBounds()` over its
+ * markers so the map zooms in to reveal them.
+ */
+declare class MarkerClusterer {
+    private currentMap;
+    private readonly _markers;
+    private readonly _clusters;
+    private idleListener;
+    private readonly opts;
+    constructor(map: KorMap, markers?: Marker[], options?: ClusterOptions);
+    addMarker(marker: Marker, redraw?: boolean): void;
+    addMarkers(markers: Marker[]): void;
+    removeMarker(marker: Marker, redraw?: boolean): boolean;
+    clearMarkers(): void;
+    setMap(map: KorMap | null): void;
+    getMarkers(): Marker[];
+    getTotalMarkers(): number;
+    /** Force a full re-cluster pass. Call after programmatic map changes if needed. */
+    redraw(): void;
+    private _register;
+    private _bind;
+    private _redraw;
+    private _addClusterOverlay;
+    private _clearClusters;
+}
+
+export { ClusterOptions, KorMap, Marker, MarkerClusterer };

package/dist/index.js

@@ -0,0 +1,232 @@
+export { Circle, ConfigurationError, CustomOverlay, InfoWindow, KorMap, KorMapError, Marker, Polygon, Polyline, ProviderLoadError, ProviderNotSupportedError, Rectangle, TileLayer } from './chunk-222QLGRB.js';
+export { MapTypeId, MarkerAnimation } from './chunk-HUS54ONW.js';
+
+// src/modules/clustering/MarkerClusterer.ts
+var DEFAULT_STYLES = [
+  { width: 36, height: 36, textColor: "#ffffff", textSize: 12, backgroundColor: "#3b82f6" },
+  { width: 44, height: 44, textColor: "#ffffff", textSize: 13, backgroundColor: "#f59e0b" },
+  { width: 52, height: 52, textColor: "#ffffff", textSize: 14, backgroundColor: "#ef4444" }
+];
+var DEFAULTS = {
+  minClusterSize: 2,
+  maxZoom: 15,
+  gridSize: 60,
+  averageCenter: false
+};
+function toWorldPixel(lat, lng, zoom) {
+  const scale = 256 * Math.pow(2, zoom);
+  const x = (lng + 180) / 360 * scale;
+  const siny = Math.min(Math.max(Math.sin(lat * Math.PI / 180), -0.9999), 0.9999);
+  const y = (0.5 - Math.log((1 + siny) / (1 - siny)) / (4 * Math.PI)) * scale;
+  return { x, y };
+}
+function toBounds(positions) {
+  let minLat = Infinity, maxLat = -Infinity, minLng = Infinity, maxLng = -Infinity;
+  for (const p of positions) {
+    if (p.lat < minLat) minLat = p.lat;
+    if (p.lat > maxLat) maxLat = p.lat;
+    if (p.lng < minLng) minLng = p.lng;
+    if (p.lng > maxLng) maxLng = p.lng;
+  }
+  return {
+    sw: { lat: minLat, lng: minLng },
+    ne: { lat: maxLat, lng: maxLng }
+  };
+}
+function pickStyle(count, styles) {
+  const s0 = styles[0];
+  const s1 = styles[1];
+  const s2 = styles[2];
+  if (count < 10) return s0 ?? DEFAULT_STYLES[0];
+  if (count < 100) return s1 ?? s0 ?? DEFAULT_STYLES[1];
+  return s2 ?? s1 ?? s0 ?? DEFAULT_STYLES[2];
+}
+function cellKey(px, py, gridSize) {
+  return `${Math.floor(px / gridSize)},${Math.floor(py / gridSize)}`;
+}
+function centroid(positions) {
+  if (positions.length === 0) return { lat: 0, lng: 0 };
+  const lat = positions.reduce((s, p) => s + p.lat, 0) / positions.length;
+  const lng = positions.reduce((s, p) => s + p.lng, 0) / positions.length;
+  return { lat, lng };
+}
+function createClusterElement(count, style) {
+  const el = document.createElement("div");
+  const w = style.width;
+  const h = style.height;
+  const bg = style.backgroundColor ?? DEFAULT_STYLES[0].backgroundColor ?? "#3b82f6";
+  const color = style.textColor ?? "#ffffff";
+  const fontSize = style.textSize ?? 13;
+  el.style.cssText = [
+    `width:${w}px`,
+    `height:${h}px`,
+    `line-height:${h}px`,
+    `border-radius:50%`,
+    `text-align:center`,
+    `cursor:pointer`,
+    `font-weight:bold`,
+    `box-shadow:0 2px 6px rgba(0,0,0,.3)`,
+    `transform:translate(-50%,-50%)`,
+    `color:${color}`,
+    `font-size:${fontSize}px`,
+    style.url ? `background:url(${style.url}) center/cover` : `background-color:${bg}`
+  ].join(";");
+  el.textContent = String(count);
+  return el;
+}
+var MarkerClusterer = class {
+  currentMap;
+  _markers = [];
+  _clusters = [];
+  idleListener = null;
+  opts;
+  constructor(map, markers = [], options = {}) {
+    this.currentMap = map;
+    this.opts = {
+      ...DEFAULTS,
+      ...options,
+      styles: options.styles ?? DEFAULT_STYLES
+    };
+    this._bind(map);
+    for (const m of markers) {
+      this._markers.push(m);
+      if (m.getMap() !== map) m.setMap(map);
+    }
+    this._redraw();
+  }
+  // -------------------------------------------------------------------------
+  // Public API
+  // -------------------------------------------------------------------------
+  addMarker(marker, redraw = true) {
+    if (this._register(marker) && redraw) this._redraw();
+  }
+  addMarkers(markers) {
+    for (const m of markers) this._register(m);
+    this._redraw();
+  }
+  removeMarker(marker, redraw = true) {
+    const idx = this._markers.indexOf(marker);
+    if (idx === -1) return false;
+    this._markers.splice(idx, 1);
+    marker.setVisible(true);
+    if (redraw) this._redraw();
+    return true;
+  }
+  clearMarkers() {
+    this._clearClusters();
+    for (const m of this._markers) m.setVisible(true);
+    this._markers.length = 0;
+  }
+  setMap(map) {
+    if (this.currentMap && this.idleListener) {
+      this.currentMap.off("idle", this.idleListener);
+      this.idleListener = null;
+    }
+    this._clearClusters();
+    if (map === null) {
+      for (const m of this._markers) m.setVisible(true);
+    }
+    this.currentMap = map;
+    if (map) {
+      this._bind(map);
+      this._redraw();
+    }
+  }
+  getMarkers() {
+    return [...this._markers];
+  }
+  getTotalMarkers() {
+    return this._markers.length;
+  }
+  /** Force a full re-cluster pass. Call after programmatic map changes if needed. */
+  redraw() {
+    this._redraw();
+  }
+  // -------------------------------------------------------------------------
+  // Private
+  // -------------------------------------------------------------------------
+  _register(marker) {
+    if (this._markers.includes(marker)) return false;
+    this._markers.push(marker);
+    if (this.currentMap && marker.getMap() !== this.currentMap) {
+      marker.setMap(this.currentMap);
+    }
+    return true;
+  }
+  _bind(map) {
+    if (this.idleListener) return;
+    this.idleListener = map.on("idle", () => {
+      this._redraw();
+    });
+  }
+  _redraw() {
+    const map = this.currentMap;
+    if (!map) return;
+    this._clearClusters();
+    const zoom = map.getZoom();
+    if (zoom > this.opts.maxZoom) {
+      for (const m of this._markers) m.setVisible(true);
+      return;
+    }
+    for (const m of this._markers) {
+      if (m.getMap()) m.setVisible(false);
+    }
+    const cells = /* @__PURE__ */ new Map();
+    for (const marker of this._markers) {
+      if (!marker.getMap()) continue;
+      const { lat, lng } = marker.getPosition();
+      const pt = toWorldPixel(lat, lng, zoom);
+      const key = cellKey(pt.x, pt.y, this.opts.gridSize);
+      const existing = cells.get(key);
+      if (existing !== void 0) {
+        existing.push(marker);
+      } else {
+        cells.set(key, [marker]);
+      }
+    }
+    for (const group of cells.values()) {
+      if (group.length >= this.opts.minClusterSize) {
+        this._addClusterOverlay(map, group);
+      } else {
+        for (const m of group) m.setVisible(true);
+      }
+    }
+  }
+  _addClusterOverlay(map, group) {
+    const positions = group.map((m) => m.getPosition());
+    const firstPos = positions[0];
+    const center = this.opts.averageCenter ? centroid(positions) : firstPos ?? { lat: 0, lng: 0 };
+    const style = pickStyle(group.length, this.opts.styles);
+    const el = createClusterElement(group.length, style);
+    el.addEventListener("click", (e) => {
+      e.stopPropagation();
+      const bounds = toBounds(positions);
+      if (bounds.sw.lat === bounds.ne.lat && bounds.sw.lng === bounds.ne.lng) {
+        map.setCenter(bounds.sw);
+        map.setZoom(this.opts.maxZoom + 1);
+      } else {
+        map.fitBounds(bounds, { padding: 60 });
+      }
+    });
+    const handle = map._adapter().addCustomOverlay({
+      position: center,
+      content: el,
+      zIndex: 200,
+      clickable: true
+    });
+    this._clusters.push({ handle, markers: group });
+  }
+  _clearClusters() {
+    const map = this.currentMap;
+    if (map) {
+      for (const c of this._clusters) {
+        map._adapter().removeCustomOverlay(c.handle);
+      }
+    }
+    this._clusters.length = 0;
+  }
+};
+
+export { MarkerClusterer };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/clustering/MarkerClusterer.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { KorMap } from '../../core/KorMap.js';\nimport type { NativeOverlayHandle } from '../../providers/base/IMapProvider.js';\nimport type { ClusterOptions, ClusterStyle, EventListener, LatLng, LatLngBounds } from '../../core/types.js';\nimport { Marker } from '../../core/overlays.js';\n\n// ---------------------------------------------------------------------------\n// Default tier styles (small / medium / large by cluster count)\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_STYLES: [ClusterStyle, ClusterStyle, ClusterStyle] = [\n  { width: 36, height: 36, textColor: '#ffffff', textSize: 12, backgroundColor: '#3b82f6' },\n  { width: 44, height: 44, textColor: '#ffffff', textSize: 13, backgroundColor: '#f59e0b' },\n  { width: 52, height: 52, textColor: '#ffffff', textSize: 14, backgroundColor: '#ef4444' },\n];\n\nconst DEFAULTS = {\n  minClusterSize: 2,\n  maxZoom: 15,\n  gridSize: 60,\n  averageCenter: false,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Internal types\n// ---------------------------------------------------------------------------\n\ninterface ClusterData {\n  handle: NativeOverlayHandle;\n  markers: Marker[];\n}\n\ninterface ResolvedOptions {\n  minClusterSize: number;\n  maxZoom: number;\n  gridSize: number;\n  styles: ClusterStyle[];\n  averageCenter: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Pure helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a LatLng to a Mercator world pixel coordinate at the given zoom level.\n *\n * Uses the standard Web Mercator (EPSG:3857) formula: at zoom Z the world is\n * 256×2^Z pixels wide. This is provider-agnostic and gives consistent grid\n * cell assignments regardless of whether the adapter's getProjection() is a\n * stub or a full implementation.\n */\nexport function toWorldPixel(lat: number, lng: number, zoom: number): { x: number; y: number } {\n  const scale = 256 * Math.pow(2, zoom);\n  const x = (lng + 180) / 360 * scale;\n  const siny = Math.min(Math.max(Math.sin(lat * Math.PI / 180), -0.9999), 0.9999);\n  const y = (0.5 - Math.log((1 + siny) / (1 - siny)) / (4 * Math.PI)) * scale;\n  return { x, y };\n}\n\n/** Compute the LatLngBounds that tightly contains all given positions. */\nexport function toBounds(positions: LatLng[]): LatLngBounds {\n  let minLat = Infinity, maxLat = -Infinity, minLng = Infinity, maxLng = -Infinity;\n  for (const p of positions) {\n    if (p.lat < minLat) minLat = p.lat;\n    if (p.lat > maxLat) maxLat = p.lat;\n    if (p.lng < minLng) minLng = p.lng;\n    if (p.lng > maxLng) maxLng = p.lng;\n  }\n  return {\n    sw: { lat: minLat, lng: minLng },\n    ne: { lat: maxLat, lng: maxLng },\n  };\n}\n\n/** Pick a style tier based on cluster size. Falls back through tiers gracefully. */\nexport function pickStyle(count: number, styles: ClusterStyle[]): ClusterStyle {\n  const s0 = styles[0];\n  const s1 = styles[1];\n  const s2 = styles[2];\n  if (count < 10) return s0 ?? DEFAULT_STYLES[0];\n  if (count < 100) return s1 ?? s0 ?? DEFAULT_STYLES[1];\n  return s2 ?? s1 ?? s0 ?? DEFAULT_STYLES[2];\n}\n\n/** Assign a pixel coordinate to a grid cell key. */\nexport function cellKey(px: number, py: number, gridSize: number): string {\n  return `${Math.floor(px / gridSize)},${Math.floor(py / gridSize)}`;\n}\n\n/** Compute the centroid of an array of LatLng positions. */\nexport function centroid(positions: LatLng[]): LatLng {\n  if (positions.length === 0) return { lat: 0, lng: 0 };\n  const lat = positions.reduce((s, p) => s + p.lat, 0) / positions.length;\n  const lng = positions.reduce((s, p) => s + p.lng, 0) / positions.length;\n  return { lat, lng };\n}\n\nfunction createClusterElement(count: number, style: ClusterStyle): HTMLElement {\n  const el = document.createElement('div');\n  const w = style.width;\n  const h = style.height;\n  const bg = style.backgroundColor ?? DEFAULT_STYLES[0].backgroundColor ?? '#3b82f6';\n  const color = style.textColor ?? '#ffffff';\n  const fontSize = style.textSize ?? 13;\n\n  // transform centers the element on the anchor point (position LatLng)\n  el.style.cssText = [\n    `width:${w}px`,\n    `height:${h}px`,\n    `line-height:${h}px`,\n    `border-radius:50%`,\n    `text-align:center`,\n    `cursor:pointer`,\n    `font-weight:bold`,\n    `box-shadow:0 2px 6px rgba(0,0,0,.3)`,\n    `transform:translate(-50%,-50%)`,\n    `color:${color}`,\n    `font-size:${fontSize}px`,\n    style.url\n      ? `background:url(${style.url}) center/cover`\n      : `background-color:${bg}`,\n  ].join(';');\n\n  el.textContent = String(count);\n  return el;\n}\n\n// ---------------------------------------------------------------------------\n// MarkerClusterer\n// ---------------------------------------------------------------------------\n\n/**\n * Grid-based marker clusterer that works across all three providers.\n *\n * Clusters are rendered as `CustomOverlay` div elements so no external\n * dependencies or provider-specific clustering plugins are needed.\n *\n * On each `idle` event the visible viewport is re-gridded using a self-contained\n * Web Mercator projection (provider-agnostic). Markers whose world-pixel\n * coordinates fall in the same `gridSize×gridSize` cell are collapsed into a\n * single cluster badge. Clicking a cluster badge calls `fitBounds()` over its\n * markers so the map zooms in to reveal them.\n */\nexport class MarkerClusterer {\n  private currentMap: KorMap | null;\n  private readonly _markers: Marker[] = [];\n  private readonly _clusters: ClusterData[] = [];\n  private idleListener: EventListener | null = null;\n  private readonly opts: ResolvedOptions;\n\n  constructor(map: KorMap, markers: Marker[] = [], options: ClusterOptions = {}) {\n    this.currentMap = map;\n    this.opts = {\n      ...DEFAULTS,\n      ...options,\n      styles: options.styles ?? DEFAULT_STYLES,\n    };\n\n    this._bind(map);\n\n    for (const m of markers) {\n      this._markers.push(m);\n      if (m.getMap() !== map) m.setMap(map);\n    }\n\n    this._redraw();\n  }\n\n  // -------------------------------------------------------------------------\n  // Public API\n  // -------------------------------------------------------------------------\n\n  addMarker(marker: Marker, redraw = true): void {\n    if (this._register(marker) && redraw) this._redraw();\n  }\n\n  addMarkers(markers: Marker[]): void {\n    for (const m of markers) this._register(m);\n    this._redraw();\n  }\n\n  removeMarker(marker: Marker, redraw = true): boolean {\n    const idx = this._markers.indexOf(marker);\n    if (idx === -1) return false;\n    this._markers.splice(idx, 1);\n    marker.setVisible(true); // restore before returning ownership to caller\n    if (redraw) this._redraw();\n    return true;\n  }\n\n  clearMarkers(): void {\n    this._clearClusters();\n    for (const m of this._markers) m.setVisible(true);\n    this._markers.length = 0;\n  }\n\n  setMap(map: KorMap | null): void {\n    if (this.currentMap && this.idleListener) {\n      this.currentMap.off('idle', this.idleListener);\n      this.idleListener = null;\n    }\n    this._clearClusters();\n    if (map === null) {\n      for (const m of this._markers) m.setVisible(true);\n    }\n    this.currentMap = map;\n    if (map) {\n      this._bind(map);\n      this._redraw();\n    }\n  }\n\n  getMarkers(): Marker[] {\n    return [...this._markers];\n  }\n\n  getTotalMarkers(): number {\n    return this._markers.length;\n  }\n\n  /** Force a full re-cluster pass. Call after programmatic map changes if needed. */\n  redraw(): void {\n    this._redraw();\n  }\n\n  // -------------------------------------------------------------------------\n  // Private\n  // -------------------------------------------------------------------------\n\n  private _register(marker: Marker): boolean {\n    if (this._markers.includes(marker)) return false;\n    this._markers.push(marker);\n    if (this.currentMap && marker.getMap() !== this.currentMap) {\n      marker.setMap(this.currentMap);\n    }\n    return true;\n  }\n\n  private _bind(map: KorMap): void {\n    if (this.idleListener) return; // already bound to this map\n    this.idleListener = map.on('idle', () => { this._redraw(); });\n  }\n\n  private _redraw(): void {\n    const map = this.currentMap;\n    if (!map) return;\n\n    this._clearClusters();\n\n    const zoom = map.getZoom();\n    if (zoom > this.opts.maxZoom) {\n      for (const m of this._markers) m.setVisible(true);\n      return;\n    }\n\n    // Hide all managed markers; we'll selectively re-show unclustered ones below.\n    for (const m of this._markers) {\n      if (m.getMap()) m.setVisible(false);\n    }\n\n    const cells = new Map<string, Marker[]>();\n\n    for (const marker of this._markers) {\n      if (!marker.getMap()) continue;\n      const { lat, lng } = marker.getPosition();\n      // Use self-contained Mercator world pixels — provider-agnostic and\n      // consistent regardless of adapter getProjection() implementation.\n      const pt = toWorldPixel(lat, lng, zoom);\n      const key = cellKey(pt.x, pt.y, this.opts.gridSize);\n      const existing = cells.get(key);\n      if (existing !== undefined) {\n        existing.push(marker);\n      } else {\n        cells.set(key, [marker]);\n      }\n    }\n\n    for (const group of cells.values()) {\n      if (group.length >= this.opts.minClusterSize) {\n        this._addClusterOverlay(map, group);\n      } else {\n        for (const m of group) m.setVisible(true);\n      }\n    }\n  }\n\n  private _addClusterOverlay(map: KorMap, group: Marker[]): void {\n    const positions = group.map(m => m.getPosition());\n    const firstPos = positions[0];\n    const center = this.opts.averageCenter\n      ? centroid(positions)\n      : (firstPos ?? { lat: 0, lng: 0 });\n\n    const style = pickStyle(group.length, this.opts.styles);\n    const el = createClusterElement(group.length, style);\n\n    // Click expands the cluster by fitting the map to its markers' bounds.\n    el.addEventListener('click', (e) => {\n      e.stopPropagation();\n      const bounds = toBounds(positions);\n      // If all markers are at the same point, just zoom past maxZoom instead.\n      if (bounds.sw.lat === bounds.ne.lat && bounds.sw.lng === bounds.ne.lng) {\n        map.setCenter(bounds.sw);\n        map.setZoom(this.opts.maxZoom + 1);\n      } else {\n        map.fitBounds(bounds, { padding: 60 });\n      }\n    });\n\n    const handle = map._adapter().addCustomOverlay({\n      position: center,\n      content: el,\n      zIndex: 200,\n      clickable: true,\n    });\n\n    this._clusters.push({ handle, markers: group });\n  }\n\n  private _clearClusters(): void {\n    const map = this.currentMap;\n    if (map) {\n      for (const c of this._clusters) {\n        map._adapter().removeCustomOverlay(c.handle);\n      }\n    }\n    this._clusters.length = 0;\n  }\n}\n"]}