@mint-ui/map 1.2.0-test.2 → 1.2.0-test.4

package/README.md

@@ -129,7 +129,7 @@ npm pack
 #### 5. NPM에 배포
 스코프 패키지(`@mint-ui/map`)는 기본적으로 private이므로 public으로 배포해야 합니다.
 ```bash
-npm publish --access public
+npm publish 
 ```
 
 #### 6. 배포 완료 확인
@@ -154,7 +154,7 @@ npm version patch
 npm pack
 
 # 5단계: 배포
-npm publish --access public
+npm publish 
 ```
 
 ### 현재 패키지 정보
@@ -185,7 +185,7 @@ npm publish --access public
    npm run build
 
    # test tag로 배포
-   npm publish --access public --tag test
+   npm publish  --tag test
    ```
 
 3. **변경사항 커밋 및 푸시**
@@ -202,7 +202,7 @@ npm publish --access public
 
    # 빌드 및 배포
    npm run build
-   npm publish --access public --tag test
+   npm publish  --tag test
 
    # 커밋 및 푸시
    git add .
@@ -215,7 +215,7 @@ npm publish --access public
    git checkout -b 1.2.0-test.2
    npm version 1.2.0-test.2 --no-git-tag-version
    npm run build
-   npm publish --access public --tag test
+   npm publish  --tag test
    git add .
    git commit -m "chore: release 1.2.0-test.2"
    git push origin 1.2.0-test.2
@@ -234,7 +234,7 @@ npm publish --access public
 
    # 빌드 및 배포
    npm run build
-   npm publish --access public
+   npm publish 
 
    # main에 푸시
    git push origin main
@@ -267,5 +267,5 @@ npm install @mint-ui/map@1.2.0-test.1
 ### 주의사항
 - 배포하기 전에 반드시 `npm run build`를 실행해야 합니다
 - 버전은 한 번 배포하면 되돌릴 수 없으니 신중하게 결정하세요
-- 스코프 패키지는 `--access public` 옵션을 반드시 붙여야 합니다
+- 스코프 패키지는 `` 옵션을 반드시 붙여야 합니다
 - test tag로 배포할 때는 `--no-git-tag-version` 옵션을 사용하여 git tag 생성을 방지합니다

package/dist/components/mint-map/core/MintMapController.d.ts

@@ -24,6 +24,7 @@ export declare abstract class MintMapController {
     abstract updateMarker(marker: Marker, options: MarkerOptions): void;
     abstract clearDrawable(drawable: Drawable): boolean;
     abstract markerToTheTop(marker: Marker): void;
+    abstract restoreMarkerZIndex(marker: Marker): void;
     abstract isMapDragged(): boolean;
     abstract setMapDragged(value: boolean): void;
     abstract setMarkerZIndex(marker: Marker, zIndex: number): void;

package/dist/components/mint-map/core/MintMapCore.js

@@ -8,6 +8,7 @@ var React = require('react');
 var MapTypes = require('../types/MapTypes.js');
 var MintMapProvider = require('./provider/MintMapProvider.js');
 var MintMapCore_module = require('./MintMapCore.module.scss.js');
+require('./advanced/woongCanvas/shared/types.js');
 require('../types/MapDrawables.js');
 require('../types/MapEventTypes.js');
 var context = require('./advanced/woongCanvas/shared/context.js');

package/dist/components/mint-map/core/advanced/index.d.ts

@@ -2,7 +2,4 @@ export * from './shapes';
 export * from './canvas';
 export * from './MapBuildingProjection';
 export * from './MapLoadingComponents';
-export { default as WoongKonvaMarker } from './woongCanvas/WoongKonvaMarker';
-export type { WoongKonvaMarkerProps } from './woongCanvas/WoongKonvaMarker';
-export { KonvaMarkerProvider, LRUCache, SpatialHashGrid, useKonvaMarkerContext } from './woongCanvas/shared';
-export type { RenderUtils, CustomRenderBase, CustomRenderAnimation, CustomRenderEvent, RenderBaseParams, RenderAnimationParams, RenderEventParams } from './woongCanvas/shared';
+export * from './woongCanvas';

package/dist/components/mint-map/core/advanced/woongCanvas/WoongKonvaMarker.d.ts

@@ -1,27 +1,29 @@
 import React from "react";
 import { MarkerOptions } from "../../../types";
-import { CanvasMarkerData, CustomRenderBase, CustomRenderAnimation, CustomRenderEvent } from "./shared";
-export { KonvaMarkerProvider, LRUCache, SpatialHashGrid } from "./shared";
-export type { CanvasMarkerOption, Paths, CanvasMarkerData, CustomRenderBase, CustomRenderAnimation, CustomRenderEvent, RenderUtils, RenderBaseParams, RenderAnimationParams, RenderEventParams } from "./shared";
+import { KonvaCanvasMarkerData, CanvasDataType, CustomRenderBase, CustomRenderAnimation, CustomRenderEvent } from "./shared";
+export { KonvaMarkerProvider, LRUCache, SpatialHashGrid, CanvasDataType } from "./shared";
+export type { KonvaCanvasMarkerOption, Paths, KonvaCanvasMarkerData, CustomRenderBase, CustomRenderAnimation, CustomRenderEvent, RenderUtils, RenderBaseParams, RenderAnimationParams, RenderEventParams } from "./shared";
 /**
  * WoongKonvaMarker 컴포넌트 Props
  * @template T 마커 데이터의 추가 속성 타입
  */
 export interface WoongKonvaMarkerProps<T> extends Pick<MarkerOptions, 'zIndex' | 'anchor' | 'visible'> {
     /** 렌더링할 마커 데이터 배열 */
-    markers: CanvasMarkerData<T>[];
-    /** 마커 클릭 시 호출되는 콜백 */
-    onClick?: (payload: CanvasMarkerData<T>, selectedIds: Set<string>) => void;
-    /** 마커에 마우스 오버 시 호출되는 콜백 */
-    onMouseOver?: (payload: CanvasMarkerData<T>) => void;
-    /** 마커에서 마우스 아웃 시 호출되는 콜백 */
-    onMouseOut?: (payload: CanvasMarkerData<T>) => void;
+    markers: KonvaCanvasMarkerData<T>[];
+    /** 데이터 타입 (MARKER 또는 POLYGON) */
+    dataType: CanvasDataType;
+    /** 마커 클릭 시 호출되는 콜백 (선택) */
+    onClick?: (payload: KonvaCanvasMarkerData<T>, selectedIds: Set<string>) => void;
+    /** 마커에 마우스 오버 시 호출되는 콜백 (선택) */
+    onMouseOver?: (payload: KonvaCanvasMarkerData<T>) => void;
+    /** 마커에서 마우스 아웃 시 호출되는 콜백 (선택) */
+    onMouseOut?: (payload: KonvaCanvasMarkerData<T>) => void;
     /** Base Layer 렌더링 함수 (필수) */
     renderBase: CustomRenderBase<T>;
     /** Animation Layer 렌더링 함수 (선택, 애니메이션용) */
     renderAnimation?: CustomRenderAnimation<T>;
-    /** Event Layer 렌더링 함수 (필수) */
-    renderEvent: CustomRenderEvent<T>;
+    /** Event Layer 렌더링 함수 (선택) */
+    renderEvent?: CustomRenderEvent<T>;
     /** 다중 선택 활성화 여부 (기본: false) */
     enableMultiSelect?: boolean;
     /** hover 시 마커를 최상단으로 표시 (기본: false) */
@@ -33,7 +35,7 @@ export interface WoongKonvaMarkerProps<T> extends Pick<MarkerOptions, 'zIndex' |
     /** LRU 캐시 최대 크기 (기본: 10000) */
     maxCacheSize?: number;
     /** 외부에서 제어하는 선택된 항목 배열 (선택) */
-    selectedItems?: CanvasMarkerData<T>[];
+    selectedItems?: KonvaCanvasMarkerData<T>[];
 }
 /**
  * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -44,5 +46,5 @@ export interface WoongKonvaMarkerProps<T> extends Pick<MarkerOptions, 'zIndex' |
  *
  * 주의: JSON.stringify() 사용 금지! (매우 느림)
  */
-declare const WoongKonvaMarker: <T>({ markers, onClick, onMouseOver, onMouseOut, renderBase, renderAnimation, renderEvent, enableMultiSelect, topOnHover, enableViewportCulling, cullingMargin, maxCacheSize, selectedItems: externalSelectedItems, ...options }: WoongKonvaMarkerProps<T>) => React.ReactPortal;
+declare const WoongKonvaMarker: <T>({ markers, dataType, onClick, onMouseOver, onMouseOut, renderBase, renderAnimation, renderEvent, enableMultiSelect, topOnHover, enableViewportCulling, cullingMargin, maxCacheSize, selectedItems: externalSelectedItems, ...options }: WoongKonvaMarkerProps<T>) => React.ReactPortal;
 export default WoongKonvaMarker;

package/dist/components/mint-map/core/advanced/woongCanvas/WoongKonvaMarker.js

@@ -10,6 +10,7 @@ var MapDrawables = require('../../../types/MapDrawables.js');
 require('../../../types/MapTypes.js');
 require('../../../types/MapEventTypes.js');
 var reactDom = require('react-dom');
+var types = require('./shared/types.js');
 var utils = require('./shared/utils.js');
 var context = require('./shared/context.js');
 var performance = require('./shared/performance.js');
@@ -36,6 +37,7 @@ var Konva__default = /*#__PURE__*/_interopDefaultLegacy(Konva);
 
 var WoongKonvaMarkerComponent = function (_a) {
   var markers = _a.markers,
+      dataType = _a.dataType,
       onClick = _a.onClick,
       onMouseOver = _a.onMouseOver,
       onMouseOut = _a.onMouseOut,
@@ -53,7 +55,7 @@ var WoongKonvaMarkerComponent = function (_a) {
       _f = _a.maxCacheSize,
       maxCacheSize = _f === void 0 ? performance.DEFAULT_MAX_CACHE_SIZE : _f,
       externalSelectedItems = _a.selectedItems,
-      options = tslib.__rest(_a, ["markers", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems"]); // --------------------------------------------------------------------------
+      options = tslib.__rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems"]); // --------------------------------------------------------------------------
   // Hooks & Context
   // --------------------------------------------------------------------------
 
@@ -87,6 +89,9 @@ var WoongKonvaMarkerComponent = function (_a) {
   /** 현재 Hover 중인 항목 */
 
   var hoveredItemRef = React.useRef(null);
+  /** 마지막으로 클릭된 항목 */
+
+  var lastClickedItemRef = React.useRef(null);
   /**
    * 선택된 항목의 ID Set
    *
@@ -170,7 +175,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
     if (!bbox) {
       // 폴리곤인 경우
-      if (item.paths) {
+      if (dataType === types.CanvasDataType.POLYGON) {
         var offsets = getOrComputePolygonOffsets(item);
         if (!offsets) return false; // 바운딩 박스 계산 (최적화: 직접 비교)
 
@@ -278,7 +283,7 @@ var WoongKonvaMarkerComponent = function (_a) {
     for (var _i = 0, currentMarkers_1 = currentMarkers; _i < currentMarkers_1.length; _i++) {
       var item = currentMarkers_1[_i];
 
-      if (item.paths) {
+      if (dataType === types.CanvasDataType.POLYGON) {
         // 폴리곤: 바운딩 박스 계산 (최적화: 직접 비교)
         var offsets = getOrComputePolygonOffsets(item);
 
@@ -414,6 +419,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var doRenderEvent = function () {
+    if (!renderEvent) return;
     var layer = eventLayerRef.current;
     if (!layer) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
 
@@ -432,7 +438,8 @@ var WoongKonvaMarkerComponent = function (_a) {
             ctx: ctx,
             hoveredItem: hoveredItemRef.current,
             utils: renderUtils,
-            selectedItems: selectedItems
+            selectedItems: selectedItems,
+            lastClickedItem: lastClickedItemRef.current
           });
         },
         perfectDrawEnabled: false,
@@ -564,7 +571,7 @@ var WoongKonvaMarkerComponent = function (_a) {
     if (topOnHover && hoveredItemRef.current) {
       var hovered = hoveredItemRef.current; // 폴리곤인 경우
 
-      if (hovered.paths) {
+      if (dataType === types.CanvasDataType.POLYGON) {
         if (utils.isPointInPolygonData(offset, hovered, getOrComputePolygonOffsets)) {
           return hovered; // 여전히 hover된 항목 위에 있음
         }
@@ -577,23 +584,22 @@ var WoongKonvaMarkerComponent = function (_a) {
     } // Spatial Index로 후보 항목만 빠르게 추출 (30,000개 → ~10개)
 
 
-    var candidates = spatialIndexRef.current.queryPoint(offset.x, offset.y); // 마커 우선 체크 (마커가 폴리곤 위에 표시됨)
+    var candidates = spatialIndexRef.current.queryPoint(offset.x, offset.y); // 데이터 타입에 따라 적절한 히트 테스트 수행
 
-    for (var i = candidates.length - 1; i >= 0; i--) {
-      var item = candidates[i];
+    if (dataType === types.CanvasDataType.MARKER) {
+      // 마커 체크
+      for (var i = candidates.length - 1; i >= 0; i--) {
+        var item = candidates[i];
 
-      if (!item.paths) {
         if (utils.isPointInMarkerData(offset, item, getOrComputeMarkerOffset)) {
           return item;
         }
       }
-    } // 폴리곤 체크
-
-
-    for (var i = candidates.length - 1; i >= 0; i--) {
-      var item = candidates[i];
+    } else {
+      // 폴리곤 체크
+      for (var i = candidates.length - 1; i >= 0; i--) {
+        var item = candidates[i];
 
-      if (item.paths) {
         if (utils.isPointInPolygonData(offset, item, getOrComputePolygonOffsets)) {
           return item;
         }
@@ -637,7 +643,9 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleLocalClick = function (data) {
-    // 1. 선택 상태 업데이트
+    // 0. 마지막 클릭 항목 저장
+    lastClickedItemRef.current = data; // 1. 선택 상태 업데이트
+
     if (enableMultiSelect) {
       // 다중 선택: Set과 Map 동시 업데이트
       var newSelected = new Set(selectedIdsRef.current);
@@ -742,6 +750,24 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleDragEnd = function () {
     draggingRef.current = false;
     controller.setMapCursor('grab');
+  };
+  /**
+   * 마우스가 canvas를 벗어날 때 hover cleanup
+   */
+
+
+  var handleMouseLeave = function () {
+    var prevHovered = hoveredItemRef.current;
+
+    if (prevHovered) {
+      hoveredItemRef.current = null;
+      controller.setMapCursor('grab');
+      doRenderEvent();
+
+      if (onMouseOut) {
+        onMouseOut(prevHovered);
+      }
+    }
   }; // --------------------------------------------------------------------------
   // Lifecycle: DOM 초기화
   // --------------------------------------------------------------------------
@@ -844,7 +870,9 @@ var WoongKonvaMarkerComponent = function (_a) {
     controller.addEventListener('CLICK', handleClick);
     controller.addEventListener('MOUSEMOVE', handleMouseMove);
     controller.addEventListener('DRAGSTART', handleDragStart);
-    controller.addEventListener('DRAGEND', handleDragEnd);
+    controller.addEventListener('DRAGEND', handleDragEnd); // 맵 컨테이너에 mouseleave 이벤트 추가
+
+    mapDiv.addEventListener('mouseleave', handleMouseLeave);
     renderAllImmediate(); // Context 사용 시 컴포넌트 등록 (다중 인스턴스 관리)
 
     var componentInstance = null;
@@ -885,7 +913,8 @@ var WoongKonvaMarkerComponent = function (_a) {
       controller.removeEventListener('CLICK', handleClick);
       controller.removeEventListener('MOUSEMOVE', handleMouseMove);
       controller.removeEventListener('DRAGSTART', handleDragStart);
-      controller.removeEventListener('DRAGEND', handleDragEnd); // Context 정리
+      controller.removeEventListener('DRAGEND', handleDragEnd);
+      mapDiv.removeEventListener('mouseleave', handleMouseLeave); // Context 정리
 
       if (context$1 && componentInstance) {
         context$1.unregisterComponent(componentInstance);
@@ -1026,6 +1055,10 @@ var WoongKonvaMarker = React__default["default"].memo(WoongKonvaMarkerComponent,
   return true; // 같음 → 리렌더링 스킵
 });
 
+Object.defineProperty(exports, 'CanvasDataType', {
+    enumerable: true,
+    get: function () { return types.CanvasDataType; }
+});
 exports.KonvaMarkerProvider = context.KonvaMarkerProvider;
 exports.LRUCache = performance.LRUCache;
 exports.SpatialHashGrid = performance.SpatialHashGrid;

package/dist/components/mint-map/core/advanced/woongCanvas/index.d.ts

@@ -1,2 +1,3 @@
+export { default as WoongKonvaMarker } from "./WoongKonvaMarker";
 export * from "./WoongKonvaMarker";
 export * from "./shared";

package/dist/components/mint-map/core/advanced/woongCanvas/shared/context.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import { Offset } from "../../../../types";
-import { CanvasMarkerData } from "./types";
+import { KonvaCanvasMarkerData } from "./types";
 /**
  * 다중 WoongKonvaMarker 인스턴스를 관리하기 위한 Context
  *
@@ -12,12 +12,12 @@ import { CanvasMarkerData } from "./types";
 export interface ComponentInstance<T> {
     zIndex: number;
     hitTest: (offset: Offset) => boolean;
-    onClick?: (payload: CanvasMarkerData<T>, selectedIds: Set<string>) => void;
-    onMouseOver?: (payload: CanvasMarkerData<T>) => void;
-    onMouseOut?: (payload: CanvasMarkerData<T>) => void;
-    findData: (offset: Offset) => CanvasMarkerData<T> | null;
-    setHovered: (data: CanvasMarkerData<T> | null) => void;
-    handleLocalClick: (data: CanvasMarkerData<T>) => void;
+    onClick?: (payload: KonvaCanvasMarkerData<T>, selectedIds: Set<string>) => void;
+    onMouseOver?: (payload: KonvaCanvasMarkerData<T>) => void;
+    onMouseOut?: (payload: KonvaCanvasMarkerData<T>) => void;
+    findData: (offset: Offset) => KonvaCanvasMarkerData<T> | null;
+    setHovered: (data: KonvaCanvasMarkerData<T> | null) => void;
+    handleLocalClick: (data: KonvaCanvasMarkerData<T>) => void;
     getSelectedIds: () => Set<string>;
 }
 interface KonvaMarkerContextValue {

package/dist/components/mint-map/core/advanced/woongCanvas/shared/types.d.ts

@@ -1,5 +1,13 @@
 import Konva from "konva";
 import { Position, Offset } from "../../../../types";
+/**
+ * 캔버스 데이터 타입 Enum
+ * 마커인지 폴리곤인지 구분하는 상수
+ */
+export declare enum CanvasDataType {
+    MARKER = "MARKER",
+    POLYGON = "POLYGON"
+}
 /**
  * 폴리곤 경로 정의
  */
@@ -11,12 +19,12 @@ export interface Paths {
  * 캔버스 마커/폴리곤 기본 옵션
  */
 /**
- * 캔버스 마커/폴리곤의 기본 필수 속성
+ * Konva 캔버스 마커/폴리곤의 기본 필수 속성
  * (렌더링에 필요한 최소 정보)
  */
-export interface CanvasMarkerOption {
+export interface KonvaCanvasMarkerOption {
     id: string;
-    position: Position[];
+    position: Position;
     boxWidth?: number;
     boxHeight?: number;
     paths?: Paths;
@@ -27,16 +35,16 @@ export interface CanvasMarkerOption {
  * @template T 서버에서 받은 원본 데이터 타입 (예: Marker, Polygon)
  * @example
  * // API에서 받은 Marker 타입을 그대로 유지하면서 캔버스 렌더링 정보 추가
- * type MarkerWithCanvas = CanvasMarkerData<Marker>
+ * type MarkerWithCanvas = KonvaCanvasMarkerData<Marker>
  * // { raId, lat, lng, buildingName, totalArea } + { id, position, boxWidth, ... }
  */
-export declare type CanvasMarkerData<T = {}> = T & CanvasMarkerOption;
+export declare type KonvaCanvasMarkerData<T = {}> = T & KonvaCanvasMarkerOption;
 /**
  * 렌더링 유틸리티 함수들
  */
 export interface RenderUtils<T> {
-    getOrComputePolygonOffsets: (polygonData: CanvasMarkerData<T>) => number[][][][] | null;
-    getOrComputeMarkerOffset: (markerData: CanvasMarkerData<T>) => Offset | null;
+    getOrComputePolygonOffsets: (polygonData: KonvaCanvasMarkerData<T>) => number[][][][] | null;
+    getOrComputeMarkerOffset: (markerData: KonvaCanvasMarkerData<T>) => Offset | null;
 }
 /**
  * 커스텀 렌더링 함수 파라미터 - Base Layer
@@ -45,7 +53,7 @@ export interface RenderBaseParams<T> {
     /** Canvas 2D 렌더링 컨텍스트 (순수 Canvas API) */
     ctx: CanvasRenderingContext2D;
     /** 렌더링할 마커 데이터 배열 */
-    items: CanvasMarkerData<T>[];
+    items: KonvaCanvasMarkerData<T>[];
     /** 현재 선택된 마커 ID Set */
     selectedIds: Set<string>;
     /** 렌더링 유틸리티 함수들 */
@@ -75,7 +83,7 @@ export interface RenderAnimationParams<T> {
     /** 현재 선택된 마커 ID Set */
     selectedIds: Set<string>;
     /** 전체 마커 데이터 배열 */
-    items: CanvasMarkerData<T>[];
+    items: KonvaCanvasMarkerData<T>[];
     /** 렌더링 유틸리티 함수들 */
     utils: RenderUtils<T>;
 }
@@ -98,11 +106,13 @@ export interface RenderEventParams<T> {
     /** Canvas 2D 렌더링 컨텍스트 (순수 Canvas API) */
     ctx: CanvasRenderingContext2D;
     /** 현재 hover된 마커 데이터 */
-    hoveredItem: CanvasMarkerData<T> | null;
+    hoveredItem: KonvaCanvasMarkerData<T> | null;
     /** 렌더링 유틸리티 함수들 */
     utils: RenderUtils<T>;
     /** 현재 선택된 마커 데이터 배열 (선택 강조용) */
-    selectedItems?: CanvasMarkerData<T>[];
+    selectedItems?: KonvaCanvasMarkerData<T>[];
+    /** 마지막으로 클릭된 마커 데이터 */
+    lastClickedItem: KonvaCanvasMarkerData<T> | null;
 }
 /**
  * 커스텀 렌더링 함수 타입 - Event Layer

package/dist/components/mint-map/core/advanced/woongCanvas/shared/types.js

@@ -0,0 +1,14 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 캔버스 데이터 타입 Enum
+ * 마커인지 폴리곤인지 구분하는 상수
+ */
+exports.CanvasDataType = void 0;
+
+(function (CanvasDataType) {
+  CanvasDataType["MARKER"] = "MARKER";
+  CanvasDataType["POLYGON"] = "POLYGON";
+})(exports.CanvasDataType || (exports.CanvasDataType = {}));

package/dist/components/mint-map/core/advanced/woongCanvas/shared/utils.d.ts

@@ -1,14 +1,14 @@
 import { Offset } from "../../../../types";
 import { MintMapController } from "../../../MintMapController";
-import { CanvasMarkerData } from "./types";
+import { KonvaCanvasMarkerData } from "./types";
 /**
  * 폴리곤 offset 계산
  */
-export declare const computePolygonOffsets: (polygonData: CanvasMarkerData<any>, controller: MintMapController) => number[][][][] | null;
+export declare const computePolygonOffsets: (polygonData: KonvaCanvasMarkerData<any>, controller: MintMapController) => number[][][][] | null;
 /**
  * 마커 offset 계산
  */
-export declare const computeMarkerOffset: (markerData: CanvasMarkerData<any>, controller: MintMapController) => Offset | null;
+export declare const computeMarkerOffset: (markerData: KonvaCanvasMarkerData<any>, controller: MintMapController) => Offset | null;
 /**
  * Point-in-Polygon 알고리즘
  */
@@ -16,8 +16,8 @@ export declare const isPointInPolygon: (point: Offset, polygon: number[][]) => b
 /**
  * 폴리곤 히트 테스트
  */
-export declare const isPointInPolygonData: (clickedOffset: Offset, polygonData: CanvasMarkerData<any>, getPolygonOffsets: (data: CanvasMarkerData<any>) => number[][][][] | null) => boolean;
+export declare const isPointInPolygonData: (clickedOffset: Offset, polygonData: KonvaCanvasMarkerData<any>, getPolygonOffsets: (data: KonvaCanvasMarkerData<any>) => number[][][][] | null) => boolean;
 /**
  * 마커 히트 테스트
  */
-export declare const isPointInMarkerData: (clickedOffset: Offset, markerData: CanvasMarkerData<any>, getMarkerOffset: (data: CanvasMarkerData<any>) => Offset | null) => boolean;
+export declare const isPointInMarkerData: (clickedOffset: Offset, markerData: KonvaCanvasMarkerData<any>, getMarkerOffset: (data: KonvaCanvasMarkerData<any>) => Offset | null) => boolean;

package/dist/components/mint-map/core/advanced/woongCanvas/shared/utils.js

@@ -47,11 +47,11 @@ var computePolygonOffsets = function (polygonData, controller) {
  */
 
 var computeMarkerOffset = function (markerData, controller) {
-  if (!markerData.position || markerData.position.length === 0) {
+  if (!markerData.position) {
     return null;
   }
 
-  return controller.positionToOffset(markerData.position[0]);
+  return controller.positionToOffset(markerData.position);
 };
 /**
  * Point-in-Polygon 알고리즘

package/dist/components/mint-map/core/wrapper/MapMarkerWrapper.js

@@ -172,7 +172,7 @@ function MapMarkerWrapper(_a) {
   var onMouseOverHandler = function (e) {
     var _a;
 
-    var marker = markerRef.current; //console.log('onMouseOverHandler', marker);
+    var marker = markerRef.current;
 
     if (marker) {
       var mouseOverHandler = (_a = options === null || options === void 0 ? void 0 : options.event) === null || _a === void 0 ? void 0 : _a.get('mouseover');
@@ -185,6 +185,25 @@ function MapMarkerWrapper(_a) {
 
       next && topOnHover && controller.markerToTheTop(marker);
     }
+  }; // 20251014 | 장한별 | mouseleave 이벤트 추가, 마우스가 마커 위에서 떠날 때 원래 zindex 를 복구하기 위함
+
+
+  var onMouseLeaveHandler = function (e) {
+    var _a;
+
+    var marker = markerRef.current;
+
+    if (marker) {
+      var mouseOutHandler = (_a = options === null || options === void 0 ? void 0 : options.event) === null || _a === void 0 ? void 0 : _a.get('mouseout');
+      var next = true;
+
+      if (mouseOutHandler) {
+        var hasNext = mouseOutHandler(e);
+        hasNext !== undefined && (next = hasNext);
+      }
+
+      next && topOnHover && controller.restoreMarkerZIndex(marker);
+    }
   }; //create object
 
 
@@ -202,10 +221,12 @@ function MapMarkerWrapper(_a) {
     }); //드래그 여부 초기화를 먼저 수행하기 위해 capture : true 처리
 
     divElement.addEventListener('mouseover', onMouseOverHandler);
+    divElement.addEventListener('mouseleave', onMouseLeaveHandler);
     return function () {
       divElement.removeEventListener('click', onClickHandler);
       divElement.removeEventListener('mousedown', onMousedownHandler);
       divElement.removeEventListener('mouseover', onMouseOverHandler);
+      divElement.removeEventListener('mouseleave', onMouseLeaveHandler);
 
       if (markerRef.current) {
         controller.clearDrawable(markerRef.current);

package/dist/components/mint-map/google/GoogleMintMapController.d.ts

@@ -28,6 +28,7 @@ export declare class GoogleMintMapController extends MintMapController {
     private getMaxZIndex;
     setMarkerZIndex(marker: Marker, zIndex: number): void;
     markerToTheTop(marker: Marker): void;
+    restoreMarkerZIndex(marker: Marker): void;
     clearDrawable(drawable: Drawable): boolean;
     private dragged;
     isMapDragged(): boolean;

package/dist/components/mint-map/google/GoogleMintMapController.js

@@ -21,6 +21,7 @@ require('../naver/NaverMintMapController.js');
 require('../core/advanced/canvas/CanvasMarkerClaude.js');
 require('../core/advanced/MapLoadingComponents.js');
 require('../core/advanced/woongCanvas/WoongKonvaMarker.js');
+require('../core/advanced/woongCanvas/shared/types.js');
 require('../core/advanced/woongCanvas/shared/context.js');
 require('../core/advanced/woongCanvas/shared/performance.js');
 require('../core/wrapper/MapControlWrapper.js');
@@ -339,6 +340,10 @@ function (_super) {
     }
   };
 
+  GoogleMintMapController.prototype.restoreMarkerZIndex = function (marker) {// Google Maps에서는 restoreMarkerZIndex 기능을 지원하지 않습니다.
+    // 이 기능은 Naver Maps에서만 사용 가능합니다.
+  };
+
   GoogleMintMapController.prototype.clearDrawable = function (drawable) {
     if (drawable && drawable.native) {
       if (drawable.native instanceof google.maps.Marker || drawable.native instanceof google.maps.Polygon || drawable.native instanceof google.maps.Polyline) {

package/dist/components/mint-map/kakao/KakaoMintMapController.d.ts

@@ -31,6 +31,7 @@ export declare class KakaoMintMapController extends MintMapController {
     private getMaxZIndex;
     setMarkerZIndex(marker: Marker, zIndex: number): void;
     markerToTheTop(marker: Marker): void;
+    restoreMarkerZIndex(marker: Marker): void;
     clearDrawable(drawable: Drawable): boolean;
     private dragged;
     isMapDragged(): boolean;

package/dist/components/mint-map/kakao/KakaoMintMapController.js

@@ -22,6 +22,7 @@ require('../naver/NaverMintMapController.js');
 require('../core/advanced/canvas/CanvasMarkerClaude.js');
 require('../core/advanced/MapLoadingComponents.js');
 require('../core/advanced/woongCanvas/WoongKonvaMarker.js');
+require('../core/advanced/woongCanvas/shared/types.js');
 require('../core/advanced/woongCanvas/shared/context.js');
 require('../core/advanced/woongCanvas/shared/performance.js');
 require('../core/wrapper/MapControlWrapper.js');
@@ -347,6 +348,10 @@ function (_super) {
     }
   };
 
+  KakaoMintMapController.prototype.restoreMarkerZIndex = function (marker) {// Kakao Maps에서는 restoreMarkerZIndex 기능을 지원하지 않습니다.
+    // 이 기능은 Naver Maps에서만 사용 가능합니다.
+  };
+
   KakaoMintMapController.prototype.clearDrawable = function (drawable) {
     var _this = this;
 

package/dist/components/mint-map/naver/NaverMintMapController.d.ts

@@ -27,9 +27,12 @@ export declare class NaverMintMapController extends MintMapController {
     createMarker(marker: Marker): void;
     updateMarker(marker: Marker, options: MarkerOptions): void;
     private markerMaxZIndex;
+    private markerOriginalZIndex;
     private getMaxZIndex;
+    private getCurrentZIndex;
     setMarkerZIndex(marker: Marker, zIndex: number): void;
     markerToTheTop(marker: Marker): void;
+    restoreMarkerZIndex(marker: Marker): void;
     clearDrawable(drawable: Drawable): boolean;
     private dragged;
     isMapDragged(): boolean;