kor-mapi 0.1.0

package/dist/types-BWnSkE6e.d.ts

@@ -0,0 +1,221 @@
+interface LatLng {
+    lat: number;
+    lng: number;
+}
+interface LatLngBounds {
+    sw: LatLng;
+    ne: LatLng;
+}
+interface Point {
+    x: number;
+    y: number;
+}
+interface Size {
+    width: number;
+    height: number;
+}
+interface Padding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+type MapProvider = 'naver' | 'kakao' | 'google';
+declare enum MapTypeId {
+    ROADMAP = "roadmap",
+    SATELLITE = "satellite",
+    HYBRID = "hybrid",
+    TERRAIN = "terrain"
+}
+type KorMapFeature = 'tilt' | 'heading' | 'mapStyles' | 'elevation' | 'streetview' | 'trafficLayer' | 'heatmap' | 'drawing' | 'transit' | 'adminBoundaries';
+interface KorMapApiKey {
+    /** Naver Maps: NCP client ID */
+    clientId?: string;
+    /** Kakao Maps: app key */
+    appKey?: string;
+    /** Google Maps: API key */
+    apiKey?: string;
+}
+interface KorMapConfig<P extends MapProvider = MapProvider> {
+    provider: P;
+    container: HTMLElement | string;
+    apiKey: string | KorMapApiKey;
+    locale?: 'ko' | 'en';
+    center?: LatLng;
+    /** Facade zoom level 0–22 (Google-style). Default: 10 */
+    zoom?: number;
+    mapType?: MapTypeId;
+    /** Google Maps: Map ID required for AdvancedMarkerElement. Defaults to 'DEMO_MAP_ID' for development. */
+    mapId?: string;
+    /** Proxy URL for Naver/Kakao routing REST calls (required for routing on these providers) */
+    proxyUrl?: string;
+}
+type KorMapEvent = 'click' | 'dblclick' | 'rightclick' | 'mousemove' | 'mouseover' | 'mouseout' | 'dragstart' | 'drag' | 'dragend' | 'zoom_changed' | 'center_changed' | 'bounds_changed' | 'maptype_changed' | 'idle' | 'tilesloaded' | 'load';
+type OverlayEvent = 'click' | 'dblclick' | 'rightclick' | 'mouseover' | 'mouseout' | 'mousemove' | 'dragstart' | 'drag' | 'dragend' | 'position_changed' | 'visible_changed';
+interface MapMouseEvent {
+    latlng: LatLng;
+    point?: Point;
+    domEvent?: MouseEvent;
+}
+/** Opaque token returned by on() / once(), used to call off() */
+interface EventListener {
+    readonly _type: string;
+    readonly _id: number;
+}
+type MapEventHandler = (event: MapMouseEvent) => void;
+type GenericEventHandler = () => void;
+type AnyEventHandler = MapEventHandler | GenericEventHandler;
+declare enum MarkerAnimation {
+    BOUNCE = "bounce",
+    DROP = "drop"
+}
+interface MarkerIcon {
+    url: string;
+    size?: Size;
+    scaledSize?: Size;
+    /** Offset from top-left of icon image to the pin point */
+    anchor?: Point;
+    /** Origin within a sprite sheet */
+    origin?: Point;
+}
+interface MarkerLabel {
+    text: string;
+    color?: string;
+    fontSize?: string;
+    fontWeight?: string;
+}
+interface MarkerOptions {
+    position: LatLng;
+    icon?: MarkerIcon | string;
+    title?: string;
+    zIndex?: number;
+    visible?: boolean;
+    draggable?: boolean;
+    opacity?: number;
+    label?: MarkerLabel;
+    clickable?: boolean;
+    animation?: MarkerAnimation;
+}
+interface InfoWindowOptions {
+    content: string | HTMLElement;
+    position?: LatLng;
+    maxWidth?: number;
+    disableAutoPan?: boolean;
+    zIndex?: number;
+}
+interface StrokeStyle {
+    strokeColor?: string;
+    strokeOpacity?: number;
+    strokeWeight?: number;
+    strokeStyle?: 'solid' | 'shortdash' | 'dot' | 'dashdot';
+}
+interface FillStyle {
+    fillColor?: string;
+    fillOpacity?: number;
+}
+interface PolylineOptions extends StrokeStyle {
+    path: LatLng[] | LatLng[][];
+    geodesic?: boolean;
+    clickable?: boolean;
+    zIndex?: number;
+    visible?: boolean;
+}
+interface PolygonOptions extends StrokeStyle, FillStyle {
+    /** First array = outer ring; subsequent arrays = holes */
+    paths: LatLng[] | LatLng[][];
+    geodesic?: boolean;
+    clickable?: boolean;
+    zIndex?: number;
+    visible?: boolean;
+}
+interface CircleOptions extends StrokeStyle, FillStyle {
+    center: LatLng;
+    /** Radius in meters */
+    radius: number;
+    clickable?: boolean;
+    zIndex?: number;
+    visible?: boolean;
+}
+interface RectangleOptions extends StrokeStyle, FillStyle {
+    bounds: LatLngBounds;
+    clickable?: boolean;
+    zIndex?: number;
+    visible?: boolean;
+}
+interface CustomOverlayOptions {
+    position: LatLng;
+    content: HTMLElement;
+    zIndex?: number;
+    visible?: boolean;
+    clickable?: boolean;
+}
+interface MapProjection {
+    fromLatLngToPoint(latlng: LatLng): Point;
+    fromPointToLatLng(point: Point): LatLng;
+    fromLatLngToDivPixel(latlng: LatLng): Point;
+}
+interface TileCoord {
+    x: number;
+    y: number;
+}
+interface TileLayerOptions {
+    getTileUrl: (coord: TileCoord, zoom: number) => string;
+    tileSize?: number;
+    minZoom?: number;
+    maxZoom?: number;
+    opacity?: number;
+    zIndex?: number;
+    attribution?: string;
+}
+interface FitBoundsOptions {
+    padding?: Partial<Padding> | number;
+    animate?: boolean;
+}
+interface PanOptions {
+    animate?: boolean;
+    duration?: number;
+}
+interface ClusterStyle {
+    /** Custom icon URL. If omitted, a default filled circle is rendered. */
+    url?: string;
+    width: number;
+    height: number;
+    textColor?: string;
+    textSize?: number;
+    backgroundColor?: string;
+    /** Pixel offset [x, y] from the anchor point to the top-left of the element. */
+    anchor?: [number, number];
+}
+interface ClusterOptions {
+    /** Minimum number of markers required to form a cluster. Default: 2 */
+    minClusterSize?: number;
+    /** Above this facade zoom level, clustering is disabled. Default: 15 */
+    maxZoom?: number;
+    /** Size of each grid cell in pixels. Default: 60 */
+    gridSize?: number;
+    /** Per-tier styles (index 0 = small, 1 = medium, 2 = large). Defaults to built-in circles. */
+    styles?: ClusterStyle[];
+    /** Place cluster pin at centroid of its markers. Default: false (uses first marker position) */
+    averageCenter?: boolean;
+}
+
+declare class KorMapError extends Error {
+    readonly provider: MapProvider | undefined;
+    readonly originalError: unknown;
+    constructor(message: string, options?: {
+        provider?: MapProvider;
+        cause?: unknown;
+    });
+}
+declare class ProviderLoadError extends KorMapError {
+    constructor(provider: MapProvider, cause?: unknown);
+}
+declare class ProviderNotSupportedError extends KorMapError {
+    readonly feature: KorMapFeature;
+    constructor(provider: MapProvider, feature: KorMapFeature);
+}
+declare class ConfigurationError extends KorMapError {
+    constructor(message: string);
+}
+
+export { type AnyEventHandler as A, type ClusterOptions as C, type EventListener as E, type FillStyle as F, type GenericEventHandler as G, type InfoWindowOptions as I, type KorMapApiKey as K, type LatLng as L, type MapMouseEvent as M, type OverlayEvent as O, type Padding as P, type RectangleOptions as R, type Size as S, type TileCoord as T, type CircleOptions as a, type ClusterStyle as b, ConfigurationError as c, type CustomOverlayOptions as d, type FitBoundsOptions as e, type KorMapConfig as f, KorMapError as g, type KorMapEvent as h, type KorMapFeature as i, type LatLngBounds as j, type MapProjection as k, type MapProvider as l, MapTypeId as m, MarkerAnimation as n, type MarkerIcon as o, type MarkerLabel as p, type MarkerOptions as q, type PanOptions as r, type Point as s, type PolygonOptions as t, type PolylineOptions as u, ProviderLoadError as v, ProviderNotSupportedError as w, type StrokeStyle as x, type TileLayerOptions as y, type MapEventHandler as z };

package/dist/types.d.ts

@@ -0,0 +1 @@
+export { A as AnyEventHandler, a as CircleOptions, c as ConfigurationError, d as CustomOverlayOptions, E as EventListener, F as FillStyle, e as FitBoundsOptions, G as GenericEventHandler, I as InfoWindowOptions, K as KorMapApiKey, f as KorMapConfig, g as KorMapError, h as KorMapEvent, i as KorMapFeature, L as LatLng, j as LatLngBounds, z as MapEventHandler, 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';

package/dist/types.js

@@ -0,0 +1,3 @@
+export { MapTypeId, MarkerAnimation } from './chunk-HUS54ONW.js';
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "kor-mapi",
+  "version": "0.1.0",
+  "description": "Provider-agnostic Korean map facade for Naver Maps, Kakao Maps, and Google Maps",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./core": {
+      "import": "./dist/core.js",
+      "types": "./dist/core.d.ts"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "demo": "vite demo --port 3000"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "tsup": "^8.0.0",
+    "vitest": "^2.0.0",
+    "vite": "^5.0.0"
+  }
+}