@mint-ui/map 1.2.0-test.8 → 1.2.0-test.9

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/advanced/woongCanvas/WoongKonvaMarker.d.ts

@@ -38,6 +38,7 @@ export interface WoongKonvaMarkerProps<T> extends Pick<MarkerOptions, 'zIndex' |
     selectedItems?: KonvaCanvasMarkerData<T>[];
     /** 외부에서 전달된 단일 선택 아이템 (특별한 효과용) */
     selectedItem?: KonvaCanvasMarkerData<T> | null;
+    disablePointerEvents?: boolean;
 }
 /**
  * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -45,9 +46,8 @@ export interface WoongKonvaMarkerProps<T> extends Pick<MarkerOptions, 'zIndex' |
  * 비교 전략:
  * 1. markers 배열 비교
  * 2. selectedItems 배열 비교 (외부 제어)
- * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
  *
  * 주의: JSON.stringify() 사용 금지! (매우 느림)
  */
-declare const WoongKonvaMarker: <T>({ markers, dataType, onClick, onMouseOver, onMouseOut, renderBase, renderAnimation, renderEvent, enableMultiSelect, topOnHover, enableViewportCulling, cullingMargin, maxCacheSize, selectedItems: externalSelectedItems, selectedItem: externalSelectedItem, ...options }: WoongKonvaMarkerProps<T>) => React.ReactPortal;
+declare const WoongKonvaMarker: <T>({ markers, dataType, onClick, onMouseOver, onMouseOut, renderBase, renderAnimation, renderEvent, enableMultiSelect, topOnHover, enableViewportCulling, cullingMargin, maxCacheSize, selectedItems: externalSelectedItems, selectedItem: externalSelectedItem, disablePointerEvents, ...options }: WoongKonvaMarkerProps<T>) => React.ReactPortal;
 export default WoongKonvaMarker;

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

@@ -56,7 +56,9 @@ var WoongKonvaMarkerComponent = function (_a) {
       maxCacheSize = _f === void 0 ? performance.DEFAULT_MAX_CACHE_SIZE : _f,
       externalSelectedItems = _a.selectedItems,
       externalSelectedItem = _a.selectedItem,
-      options = tslib.__rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem"]); // --------------------------------------------------------------------------
+      _g = _a.disablePointerEvents,
+      disablePointerEvents = _g === void 0 ? false : _g,
+      options = tslib.__rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem", "disablePointerEvents"]); // --------------------------------------------------------------------------
   // Hooks & Context
   // --------------------------------------------------------------------------
 
@@ -131,12 +133,6 @@ var WoongKonvaMarkerComponent = function (_a) {
     x: 0,
     y: 0
   }); // --------------------------------------------------------------------------
-  // Event Handler Refs (클로저 문제 방지)
-  // --------------------------------------------------------------------------
-
-  var onClickRef = React.useRef(onClick);
-  var onMouseOverRef = React.useRef(onMouseOver);
-  var onMouseOutRef = React.useRef(onMouseOut); // --------------------------------------------------------------------------
   // Performance Refs (캐싱 & 최적화)
   // --------------------------------------------------------------------------
 
@@ -427,9 +423,9 @@ var WoongKonvaMarkerComponent = function (_a) {
 
   var doRenderEvent = function () {
     var layer = eventLayerRef.current;
-    if (!layer) return; // 이벤트 핸들러가 없으면 Event Layer를 완전히 지움
+    if (!layer) return;
 
-    if (!onClickRef.current && !onMouseOverRef.current && !onMouseOutRef.current) {
+    if (!onClick && !onMouseOver && !onMouseOut) {
       layer.destroyChildren();
       layer.batchDraw();
       return;
@@ -633,7 +629,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var setHovered = function (data) {
-    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+    if (!onMouseOver && !onMouseOut) return;
     hoveredItemRef.current = data;
 
     if (draggingRef.current) {
@@ -658,7 +654,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleLocalClick = function (data) {
-    if (!onClickRef.current) return; // 1. 선택 상태 업데이트
+    if (!onClick) return; // 1. 선택 상태 업데이트
 
     if (enableMultiSelect) {
       // 다중 선택: Set과 Map 동시 업데이트
@@ -709,7 +705,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleClick = function (event) {
     var _a;
 
-    if (!onClickRef.current) return;
+    if (!onClick) return;
     if (context$1 || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -718,7 +714,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (data) {
         handleLocalClick(data);
-        onClickRef.current(data, selectedIdsRef.current);
+        onClick(data, selectedIdsRef.current);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleClick error:', error);
@@ -732,7 +728,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleMouseMove = function (event) {
     var _a;
 
-    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+    if (!onMouseOver && !onMouseOut) return;
     if (context$1 || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -742,8 +738,8 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (prevHovered !== hoveredItem) {
         setHovered(hoveredItem);
-        if (prevHovered && onMouseOutRef.current) onMouseOutRef.current(prevHovered);
-        if (hoveredItem && onMouseOverRef.current) onMouseOverRef.current(hoveredItem);
+        if (prevHovered && onMouseOut) onMouseOut(prevHovered);
+        if (hoveredItem && onMouseOver) onMouseOver(hoveredItem);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleMouseMove error:', error);
@@ -773,7 +769,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleMouseLeave = function () {
-    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+    if (!onMouseOver && !onMouseOut) return;
     var prevHovered = hoveredItemRef.current;
 
     if (prevHovered) {
@@ -781,8 +777,8 @@ var WoongKonvaMarkerComponent = function (_a) {
       controller.setMapCursor('grab');
       doRenderEvent();
 
-      if (onMouseOutRef.current) {
-        onMouseOutRef.current(prevHovered);
+      if (onMouseOut) {
+        onMouseOut(prevHovered);
       }
     }
   }; // --------------------------------------------------------------------------
@@ -883,20 +879,13 @@ var WoongKonvaMarkerComponent = function (_a) {
     controller.addEventListener('IDLE', handleIdle);
     controller.addEventListener('ZOOMSTART', handleZoomStart);
     controller.addEventListener('ZOOM_CHANGED', handleZoomEnd);
-    controller.addEventListener('CENTER_CHANGED', handleCenterChanged); // onClick이 있을 때만 CLICK 이벤트 등록
-
-    if (onClick) {
-      controller.addEventListener('CLICK', handleClick);
-    } // onMouseOver/onMouseOut이 있을 때만 MOUSEMOVE 이벤트 등록
-
-
-    if (onMouseOver || onMouseOut) {
-      controller.addEventListener('MOUSEMOVE', handleMouseMove);
-      mapDiv.addEventListener('mouseleave', handleMouseLeave);
-    }
-
+    controller.addEventListener('CENTER_CHANGED', handleCenterChanged);
+    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;
@@ -934,18 +923,11 @@ var WoongKonvaMarkerComponent = function (_a) {
       controller.removeEventListener('ZOOMSTART', handleZoomStart);
       controller.removeEventListener('ZOOM_CHANGED', handleZoomEnd);
       controller.removeEventListener('CENTER_CHANGED', handleCenterChanged);
-
-      if (onClick) {
-        controller.removeEventListener('CLICK', handleClick);
-      }
-
-      if (onMouseOver || onMouseOut) {
-        controller.removeEventListener('MOUSEMOVE', handleMouseMove);
-        mapDiv.removeEventListener('mouseleave', handleMouseLeave);
-      }
-
+      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);
@@ -962,18 +944,6 @@ var WoongKonvaMarkerComponent = function (_a) {
       spatialIndexRef.current.clear();
     };
   }, []); // --------------------------------------------------------------------------
-  // Lifecycle: 이벤트 핸들러 ref 동기화
-  // --------------------------------------------------------------------------
-
-  React.useEffect(function () {
-    onClickRef.current = onClick;
-    onMouseOverRef.current = onMouseOver;
-    onMouseOutRef.current = onMouseOut; // Event Layer 다시 렌더링 (이벤트 핸들러 변경 반영)
-
-    if (stageRef.current) {
-      doRenderEvent();
-    }
-  }, [onClick, onMouseOver, onMouseOut]); // --------------------------------------------------------------------------
   // Lifecycle: 외부 selectedItems 동기화
   // --------------------------------------------------------------------------
 
@@ -1064,23 +1034,15 @@ var WoongKonvaMarkerComponent = function (_a) {
 
     renderAllImmediate();
   }, [markers]);
-  var hasAnyHandler = onClick || onMouseOver || onMouseOut;
   return reactDom.createPortal(React__default["default"].createElement("div", {
-    style: {
-      zIndex: options.zIndex !== undefined ? options.zIndex + 1 : 9999,
-      position: 'absolute',
-      width: '100%',
-      height: '100%',
-      pointerEvents: hasAnyHandler ? 'none' : 'auto'
-    }
-  }, React__default["default"].createElement("div", {
     ref: containerRef,
     style: {
       position: 'absolute',
       width: '100%',
-      height: '100%'
+      height: '100%',
+      pointerEvents: disablePointerEvents ? 'none' : 'auto'
     }
-  })), divElement);
+  }), divElement);
 };
 /**
  * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -1088,29 +1050,53 @@ var WoongKonvaMarkerComponent = function (_a) {
  * 비교 전략:
  * 1. markers 배열 비교
  * 2. selectedItems 배열 비교 (외부 제어)
- * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
  *
  * 주의: JSON.stringify() 사용 금지! (매우 느림)
  */
 
 
 var WoongKonvaMarker = React__default["default"].memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
-  // markers 배열 비교 (참조 비교)
-  if (prevProps.markers !== nextProps.markers) return false; // selectedItems 배열 비교 (참조 비교)
+  // 1. markers 비교
+  var prevMarkers = prevProps.markers;
+  var nextMarkers = nextProps.markers; // 참조가 같으면 스킵
+
+  if (prevMarkers !== nextMarkers) {
+    // 길이가 다르면 변경됨
+    if (prevMarkers.length !== nextMarkers.length) return false; // 각 마커의 ID 비교
+
+    for (var i = 0; i < prevMarkers.length; i++) {
+      if (prevMarkers[i].id !== nextMarkers[i].id) {
+        return false; // 변경됨 → 리렌더링
+      }
+    }
+  } // 2. selectedItems 비교 (참조만 비교)
+
+
+  if (prevProps.selectedItems !== nextProps.selectedItems) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  if (prevProps.selectedItem !== nextProps.selectedItem) {
+    return false; // 변경됨 → 리렌더링
+  }
 
-  if (prevProps.selectedItems !== nextProps.selectedItems) return false; // selectedItem 비교 (참조 비교)
+  if (prevProps.onClick !== nextProps.onClick) {
+    return false; // 변경됨 → 리렌더링
+  }
 
-  if (prevProps.selectedItem !== nextProps.selectedItem) return false; // 이벤트 핸들러 비교 (참조 비교)
+  if (prevProps.onMouseOver !== nextProps.onMouseOver) {
+    return false; // 변경됨 → 리렌더링
+  }
 
-  if (prevProps.onClick !== nextProps.onClick) return false;
-  if (prevProps.onMouseOver !== nextProps.onMouseOver) return false;
-  if (prevProps.onMouseOut !== nextProps.onMouseOut) return false; // renderBase, renderEvent 등 함수 비교
+  if (prevProps.onMouseOut !== nextProps.onMouseOut) {
+    return false; // 변경됨 → 리렌더링
+  }
 
-  if (prevProps.renderBase !== nextProps.renderBase) return false;
-  if (prevProps.renderEvent !== nextProps.renderEvent) return false;
-  if (prevProps.renderAnimation !== nextProps.renderAnimation) return false; // 나머지 props는 변경되지 않는다고 가정
+  if (prevProps.disablePointerEvents !== nextProps.disablePointerEvents) {
+    return false; // 변경됨 → 리렌더링
+  }
 
-  return true;
+  return true; // 같음 → 리렌더링 스킵
 });
 
 Object.defineProperty(exports, 'CanvasDataType', {

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

@@ -340,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

@@ -348,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;

package/dist/components/mint-map/naver/NaverMintMapController.js

@@ -340,20 +340,54 @@ function (_super) {
     }
   };
 
-  NaverMintMapController.prototype.setMarkerZIndex = function (marker, zIndex) {
+  NaverMintMapController.prototype.getCurrentZIndex = function (marker) {
     if (this.map && marker.element && marker.element instanceof HTMLElement) {
       var parent_1 = marker.element.parentElement;
 
-      if (parent_1) {
-        parent_1.style.zIndex = String(zIndex);
+      if (parent_1 && parent_1.style.zIndex) {
+        var zIndex = Number(parent_1.style.zIndex);
+        return isNaN(zIndex) ? undefined : zIndex;
+      }
+    }
+
+    return undefined;
+  };
+
+  NaverMintMapController.prototype.setMarkerZIndex = function (marker, zIndex) {
+    if (this.map && marker.element && marker.element instanceof HTMLElement) {
+      var parent_2 = marker.element.parentElement;
+
+      if (parent_2) {
+        parent_2.style.zIndex = String(zIndex);
       }
     }
   };
 
   NaverMintMapController.prototype.markerToTheTop = function (marker) {
+    // 이미 최상위로 올라간 상태면 (원래 zIndex가 이미 저장됨) 중복 실행 방지
+    if (this.markerOriginalZIndex !== undefined) {
+      return;
+    }
+
+    var currentZIndex = this.getCurrentZIndex(marker); // undefined면 null로 저장 (원래 zIndex가 없었음을 표시)
+
+    this.markerOriginalZIndex = currentZIndex !== undefined ? currentZIndex : null;
     this.setMarkerZIndex(marker, this.getMaxZIndex(1));
   };
 
+  NaverMintMapController.prototype.restoreMarkerZIndex = function (marker) {
+    if (this.markerOriginalZIndex !== undefined) {
+      if (this.markerOriginalZIndex === null) {
+        // 원래 zIndex가 없었으면 제거 (또는 초기값 0으로)
+        this.setMarkerZIndex(marker, 0);
+      } else {
+        this.setMarkerZIndex(marker, this.markerOriginalZIndex);
+      }
+
+      this.markerOriginalZIndex = undefined;
+    }
+  };
+
   NaverMintMapController.prototype.clearDrawable = function (drawable) {
     var _a;
 

package/dist/index.es.js

@@ -2750,7 +2750,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');
@@ -2763,6 +2763,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
 
 
@@ -2780,10 +2799,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);
@@ -5385,7 +5406,9 @@ var WoongKonvaMarkerComponent = function (_a) {
       maxCacheSize = _f === void 0 ? DEFAULT_MAX_CACHE_SIZE : _f,
       externalSelectedItems = _a.selectedItems,
       externalSelectedItem = _a.selectedItem,
-      options = __rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem"]); // --------------------------------------------------------------------------
+      _g = _a.disablePointerEvents,
+      disablePointerEvents = _g === void 0 ? false : _g,
+      options = __rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem", "disablePointerEvents"]); // --------------------------------------------------------------------------
   // Hooks & Context
   // --------------------------------------------------------------------------
 
@@ -5460,12 +5483,6 @@ var WoongKonvaMarkerComponent = function (_a) {
     x: 0,
     y: 0
   }); // --------------------------------------------------------------------------
-  // Event Handler Refs (클로저 문제 방지)
-  // --------------------------------------------------------------------------
-
-  var onClickRef = useRef(onClick);
-  var onMouseOverRef = useRef(onMouseOver);
-  var onMouseOutRef = useRef(onMouseOut); // --------------------------------------------------------------------------
   // Performance Refs (캐싱 & 최적화)
   // --------------------------------------------------------------------------
 
@@ -5756,9 +5773,9 @@ var WoongKonvaMarkerComponent = function (_a) {
 
   var doRenderEvent = function () {
     var layer = eventLayerRef.current;
-    if (!layer) return; // 이벤트 핸들러가 없으면 Event Layer를 완전히 지움
+    if (!layer) return;
 
-    if (!onClickRef.current && !onMouseOverRef.current && !onMouseOutRef.current) {
+    if (!onClick && !onMouseOver && !onMouseOut) {
       layer.destroyChildren();
       layer.batchDraw();
       return;
@@ -5962,7 +5979,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var setHovered = function (data) {
-    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+    if (!onMouseOver && !onMouseOut) return;
     hoveredItemRef.current = data;
 
     if (draggingRef.current) {
@@ -5987,7 +6004,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleLocalClick = function (data) {
-    if (!onClickRef.current) return; // 1. 선택 상태 업데이트
+    if (!onClick) return; // 1. 선택 상태 업데이트
 
     if (enableMultiSelect) {
       // 다중 선택: Set과 Map 동시 업데이트
@@ -6038,7 +6055,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleClick = function (event) {
     var _a;
 
-    if (!onClickRef.current) return;
+    if (!onClick) return;
     if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -6047,7 +6064,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (data) {
         handleLocalClick(data);
-        onClickRef.current(data, selectedIdsRef.current);
+        onClick(data, selectedIdsRef.current);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleClick error:', error);
@@ -6061,7 +6078,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleMouseMove = function (event) {
     var _a;
 
-    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+    if (!onMouseOver && !onMouseOut) return;
     if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -6071,8 +6088,8 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (prevHovered !== hoveredItem) {
         setHovered(hoveredItem);
-        if (prevHovered && onMouseOutRef.current) onMouseOutRef.current(prevHovered);
-        if (hoveredItem && onMouseOverRef.current) onMouseOverRef.current(hoveredItem);
+        if (prevHovered && onMouseOut) onMouseOut(prevHovered);
+        if (hoveredItem && onMouseOver) onMouseOver(hoveredItem);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleMouseMove error:', error);
@@ -6102,7 +6119,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleMouseLeave = function () {
-    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+    if (!onMouseOver && !onMouseOut) return;
     var prevHovered = hoveredItemRef.current;
 
     if (prevHovered) {
@@ -6110,8 +6127,8 @@ var WoongKonvaMarkerComponent = function (_a) {
       controller.setMapCursor('grab');
       doRenderEvent();
 
-      if (onMouseOutRef.current) {
-        onMouseOutRef.current(prevHovered);
+      if (onMouseOut) {
+        onMouseOut(prevHovered);
       }
     }
   }; // --------------------------------------------------------------------------
@@ -6212,20 +6229,13 @@ var WoongKonvaMarkerComponent = function (_a) {
     controller.addEventListener('IDLE', handleIdle);
     controller.addEventListener('ZOOMSTART', handleZoomStart);
     controller.addEventListener('ZOOM_CHANGED', handleZoomEnd);
-    controller.addEventListener('CENTER_CHANGED', handleCenterChanged); // onClick이 있을 때만 CLICK 이벤트 등록
-
-    if (onClick) {
-      controller.addEventListener('CLICK', handleClick);
-    } // onMouseOver/onMouseOut이 있을 때만 MOUSEMOVE 이벤트 등록
-
-
-    if (onMouseOver || onMouseOut) {
-      controller.addEventListener('MOUSEMOVE', handleMouseMove);
-      mapDiv.addEventListener('mouseleave', handleMouseLeave);
-    }
-
+    controller.addEventListener('CENTER_CHANGED', handleCenterChanged);
+    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;
@@ -6263,18 +6273,11 @@ var WoongKonvaMarkerComponent = function (_a) {
       controller.removeEventListener('ZOOMSTART', handleZoomStart);
       controller.removeEventListener('ZOOM_CHANGED', handleZoomEnd);
       controller.removeEventListener('CENTER_CHANGED', handleCenterChanged);
-
-      if (onClick) {
-        controller.removeEventListener('CLICK', handleClick);
-      }
-
-      if (onMouseOver || onMouseOut) {
-        controller.removeEventListener('MOUSEMOVE', handleMouseMove);
-        mapDiv.removeEventListener('mouseleave', handleMouseLeave);
-      }
-
+      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 && componentInstance) {
         context.unregisterComponent(componentInstance);
@@ -6291,18 +6294,6 @@ var WoongKonvaMarkerComponent = function (_a) {
       spatialIndexRef.current.clear();
     };
   }, []); // --------------------------------------------------------------------------
-  // Lifecycle: 이벤트 핸들러 ref 동기화
-  // --------------------------------------------------------------------------
-
-  useEffect(function () {
-    onClickRef.current = onClick;
-    onMouseOverRef.current = onMouseOver;
-    onMouseOutRef.current = onMouseOut; // Event Layer 다시 렌더링 (이벤트 핸들러 변경 반영)
-
-    if (stageRef.current) {
-      doRenderEvent();
-    }
-  }, [onClick, onMouseOver, onMouseOut]); // --------------------------------------------------------------------------
   // Lifecycle: 외부 selectedItems 동기화
   // --------------------------------------------------------------------------
 
@@ -6393,23 +6384,15 @@ var WoongKonvaMarkerComponent = function (_a) {
 
     renderAllImmediate();
   }, [markers]);
-  var hasAnyHandler = onClick || onMouseOver || onMouseOut;
   return createPortal(React.createElement("div", {
-    style: {
-      zIndex: options.zIndex !== undefined ? options.zIndex + 1 : 9999,
-      position: 'absolute',
-      width: '100%',
-      height: '100%',
-      pointerEvents: hasAnyHandler ? 'none' : 'auto'
-    }
-  }, React.createElement("div", {
     ref: containerRef,
     style: {
       position: 'absolute',
       width: '100%',
-      height: '100%'
+      height: '100%',
+      pointerEvents: disablePointerEvents ? 'none' : 'auto'
     }
-  })), divElement);
+  }), divElement);
 };
 /**
  * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -6417,29 +6400,53 @@ var WoongKonvaMarkerComponent = function (_a) {
  * 비교 전략:
  * 1. markers 배열 비교
  * 2. selectedItems 배열 비교 (외부 제어)
- * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
  *
  * 주의: JSON.stringify() 사용 금지! (매우 느림)
  */
 
 
 var WoongKonvaMarker = React.memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
-  // markers 배열 비교 (참조 비교)
-  if (prevProps.markers !== nextProps.markers) return false; // selectedItems 배열 비교 (참조 비교)
+  // 1. markers 비교
+  var prevMarkers = prevProps.markers;
+  var nextMarkers = nextProps.markers; // 참조가 같으면 스킵
 
-  if (prevProps.selectedItems !== nextProps.selectedItems) return false; // selectedItem 비교 (참조 비교)
+  if (prevMarkers !== nextMarkers) {
+    // 길이가 다르면 변경됨
+    if (prevMarkers.length !== nextMarkers.length) return false; // 각 마커의 ID 비교
+
+    for (var i = 0; i < prevMarkers.length; i++) {
+      if (prevMarkers[i].id !== nextMarkers[i].id) {
+        return false; // 변경됨 → 리렌더링
+      }
+    }
+  } // 2. selectedItems 비교 (참조만 비교)
 
-  if (prevProps.selectedItem !== nextProps.selectedItem) return false; // 이벤트 핸들러 비교 (참조 비교)
 
-  if (prevProps.onClick !== nextProps.onClick) return false;
-  if (prevProps.onMouseOver !== nextProps.onMouseOver) return false;
-  if (prevProps.onMouseOut !== nextProps.onMouseOut) return false; // renderBase, renderEvent 등 함수 비교
+  if (prevProps.selectedItems !== nextProps.selectedItems) {
+    return false; // 변경됨 → 리렌더링
+  }
 
-  if (prevProps.renderBase !== nextProps.renderBase) return false;
-  if (prevProps.renderEvent !== nextProps.renderEvent) return false;
-  if (prevProps.renderAnimation !== nextProps.renderAnimation) return false; // 나머지 props는 변경되지 않는다고 가정
+  if (prevProps.selectedItem !== nextProps.selectedItem) {
+    return false; // 변경됨 → 리렌더링
+  }
 
-  return true;
+  if (prevProps.onClick !== nextProps.onClick) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  if (prevProps.onMouseOver !== nextProps.onMouseOver) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  if (prevProps.onMouseOut !== nextProps.onMouseOut) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  if (prevProps.disablePointerEvents !== nextProps.disablePointerEvents) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  return true; // 같음 → 리렌더링 스킵
 });
 
 var css_248z = ".MintMapWrapper-module_mint-map-control-wrapper-container__DONh7 {\n  position: absolute;\n  width: 100%;\n  height: 100%;\n  display: flex;\n  pointer-events: none;\n  z-index: 101;\n}\n\n.MintMapWrapper-module_mint-map-overlay-wrapper__Jn4wV {\n  position: absolute;\n  z-index: 1;\n}";
@@ -7182,20 +7189,54 @@ function (_super) {
     }
   };
 
-  NaverMintMapController.prototype.setMarkerZIndex = function (marker, zIndex) {
+  NaverMintMapController.prototype.getCurrentZIndex = function (marker) {
     if (this.map && marker.element && marker.element instanceof HTMLElement) {
       var parent_1 = marker.element.parentElement;
 
-      if (parent_1) {
-        parent_1.style.zIndex = String(zIndex);
+      if (parent_1 && parent_1.style.zIndex) {
+        var zIndex = Number(parent_1.style.zIndex);
+        return isNaN(zIndex) ? undefined : zIndex;
+      }
+    }
+
+    return undefined;
+  };
+
+  NaverMintMapController.prototype.setMarkerZIndex = function (marker, zIndex) {
+    if (this.map && marker.element && marker.element instanceof HTMLElement) {
+      var parent_2 = marker.element.parentElement;
+
+      if (parent_2) {
+        parent_2.style.zIndex = String(zIndex);
       }
     }
   };
 
   NaverMintMapController.prototype.markerToTheTop = function (marker) {
+    // 이미 최상위로 올라간 상태면 (원래 zIndex가 이미 저장됨) 중복 실행 방지
+    if (this.markerOriginalZIndex !== undefined) {
+      return;
+    }
+
+    var currentZIndex = this.getCurrentZIndex(marker); // undefined면 null로 저장 (원래 zIndex가 없었음을 표시)
+
+    this.markerOriginalZIndex = currentZIndex !== undefined ? currentZIndex : null;
     this.setMarkerZIndex(marker, this.getMaxZIndex(1));
   };
 
+  NaverMintMapController.prototype.restoreMarkerZIndex = function (marker) {
+    if (this.markerOriginalZIndex !== undefined) {
+      if (this.markerOriginalZIndex === null) {
+        // 원래 zIndex가 없었으면 제거 (또는 초기값 0으로)
+        this.setMarkerZIndex(marker, 0);
+      } else {
+        this.setMarkerZIndex(marker, this.markerOriginalZIndex);
+      }
+
+      this.markerOriginalZIndex = undefined;
+    }
+  };
+
   NaverMintMapController.prototype.clearDrawable = function (drawable) {
     var _a;
 
@@ -7950,6 +7991,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) {
@@ -8672,6 +8717,10 @@ function (_super) {
     }
   };
 
+  KakaoMintMapController.prototype.restoreMarkerZIndex = function (marker) {// Kakao Maps에서는 restoreMarkerZIndex 기능을 지원하지 않습니다.
+    // 이 기능은 Naver Maps에서만 사용 가능합니다.
+  };
+
   KakaoMintMapController.prototype.clearDrawable = function (drawable) {
     var _this = this;
 

package/dist/index.umd.js

@@ -2754,7 +2754,7 @@
     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');
@@ -2767,6 +2767,25 @@
 
         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
 
 
@@ -2784,10 +2803,12 @@
       }); //드래그 여부 초기화를 먼저 수행하기 위해 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);
@@ -5389,7 +5410,9 @@
         maxCacheSize = _f === void 0 ? DEFAULT_MAX_CACHE_SIZE : _f,
         externalSelectedItems = _a.selectedItems,
         externalSelectedItem = _a.selectedItem,
-        options = tslib.__rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem"]); // --------------------------------------------------------------------------
+        _g = _a.disablePointerEvents,
+        disablePointerEvents = _g === void 0 ? false : _g,
+        options = tslib.__rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem", "disablePointerEvents"]); // --------------------------------------------------------------------------
     // Hooks & Context
     // --------------------------------------------------------------------------
 
@@ -5464,12 +5487,6 @@
       x: 0,
       y: 0
     }); // --------------------------------------------------------------------------
-    // Event Handler Refs (클로저 문제 방지)
-    // --------------------------------------------------------------------------
-
-    var onClickRef = React.useRef(onClick);
-    var onMouseOverRef = React.useRef(onMouseOver);
-    var onMouseOutRef = React.useRef(onMouseOut); // --------------------------------------------------------------------------
     // Performance Refs (캐싱 & 최적화)
     // --------------------------------------------------------------------------
 
@@ -5760,9 +5777,9 @@
 
     var doRenderEvent = function () {
       var layer = eventLayerRef.current;
-      if (!layer) return; // 이벤트 핸들러가 없으면 Event Layer를 완전히 지움
+      if (!layer) return;
 
-      if (!onClickRef.current && !onMouseOverRef.current && !onMouseOutRef.current) {
+      if (!onClick && !onMouseOver && !onMouseOut) {
         layer.destroyChildren();
         layer.batchDraw();
         return;
@@ -5966,7 +5983,7 @@
 
 
     var setHovered = function (data) {
-      if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+      if (!onMouseOver && !onMouseOut) return;
       hoveredItemRef.current = data;
 
       if (draggingRef.current) {
@@ -5991,7 +6008,7 @@
 
 
     var handleLocalClick = function (data) {
-      if (!onClickRef.current) return; // 1. 선택 상태 업데이트
+      if (!onClick) return; // 1. 선택 상태 업데이트
 
       if (enableMultiSelect) {
         // 다중 선택: Set과 Map 동시 업데이트
@@ -6042,7 +6059,7 @@
     var handleClick = function (event) {
       var _a;
 
-      if (!onClickRef.current) return;
+      if (!onClick) return;
       if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
       try {
@@ -6051,7 +6068,7 @@
 
         if (data) {
           handleLocalClick(data);
-          onClickRef.current(data, selectedIdsRef.current);
+          onClick(data, selectedIdsRef.current);
         }
       } catch (error) {
         console.error('[WoongKonvaMarker] handleClick error:', error);
@@ -6065,7 +6082,7 @@
     var handleMouseMove = function (event) {
       var _a;
 
-      if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+      if (!onMouseOver && !onMouseOut) return;
       if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
       try {
@@ -6075,8 +6092,8 @@
 
         if (prevHovered !== hoveredItem) {
           setHovered(hoveredItem);
-          if (prevHovered && onMouseOutRef.current) onMouseOutRef.current(prevHovered);
-          if (hoveredItem && onMouseOverRef.current) onMouseOverRef.current(hoveredItem);
+          if (prevHovered && onMouseOut) onMouseOut(prevHovered);
+          if (hoveredItem && onMouseOver) onMouseOver(hoveredItem);
         }
       } catch (error) {
         console.error('[WoongKonvaMarker] handleMouseMove error:', error);
@@ -6106,7 +6123,7 @@
 
 
     var handleMouseLeave = function () {
-      if (!onMouseOverRef.current && !onMouseOutRef.current) return;
+      if (!onMouseOver && !onMouseOut) return;
       var prevHovered = hoveredItemRef.current;
 
       if (prevHovered) {
@@ -6114,8 +6131,8 @@
         controller.setMapCursor('grab');
         doRenderEvent();
 
-        if (onMouseOutRef.current) {
-          onMouseOutRef.current(prevHovered);
+        if (onMouseOut) {
+          onMouseOut(prevHovered);
         }
       }
     }; // --------------------------------------------------------------------------
@@ -6216,20 +6233,13 @@
       controller.addEventListener('IDLE', handleIdle);
       controller.addEventListener('ZOOMSTART', handleZoomStart);
       controller.addEventListener('ZOOM_CHANGED', handleZoomEnd);
-      controller.addEventListener('CENTER_CHANGED', handleCenterChanged); // onClick이 있을 때만 CLICK 이벤트 등록
-
-      if (onClick) {
-        controller.addEventListener('CLICK', handleClick);
-      } // onMouseOver/onMouseOut이 있을 때만 MOUSEMOVE 이벤트 등록
-
-
-      if (onMouseOver || onMouseOut) {
-        controller.addEventListener('MOUSEMOVE', handleMouseMove);
-        mapDiv.addEventListener('mouseleave', handleMouseLeave);
-      }
-
+      controller.addEventListener('CENTER_CHANGED', handleCenterChanged);
+      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;
@@ -6267,18 +6277,11 @@
         controller.removeEventListener('ZOOMSTART', handleZoomStart);
         controller.removeEventListener('ZOOM_CHANGED', handleZoomEnd);
         controller.removeEventListener('CENTER_CHANGED', handleCenterChanged);
-
-        if (onClick) {
-          controller.removeEventListener('CLICK', handleClick);
-        }
-
-        if (onMouseOver || onMouseOut) {
-          controller.removeEventListener('MOUSEMOVE', handleMouseMove);
-          mapDiv.removeEventListener('mouseleave', handleMouseLeave);
-        }
-
+        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 && componentInstance) {
           context.unregisterComponent(componentInstance);
@@ -6295,18 +6298,6 @@
         spatialIndexRef.current.clear();
       };
     }, []); // --------------------------------------------------------------------------
-    // Lifecycle: 이벤트 핸들러 ref 동기화
-    // --------------------------------------------------------------------------
-
-    React.useEffect(function () {
-      onClickRef.current = onClick;
-      onMouseOverRef.current = onMouseOver;
-      onMouseOutRef.current = onMouseOut; // Event Layer 다시 렌더링 (이벤트 핸들러 변경 반영)
-
-      if (stageRef.current) {
-        doRenderEvent();
-      }
-    }, [onClick, onMouseOver, onMouseOut]); // --------------------------------------------------------------------------
     // Lifecycle: 외부 selectedItems 동기화
     // --------------------------------------------------------------------------
 
@@ -6397,23 +6388,15 @@
 
       renderAllImmediate();
     }, [markers]);
-    var hasAnyHandler = onClick || onMouseOver || onMouseOut;
     return reactDom.createPortal(React__default["default"].createElement("div", {
-      style: {
-        zIndex: options.zIndex !== undefined ? options.zIndex + 1 : 9999,
-        position: 'absolute',
-        width: '100%',
-        height: '100%',
-        pointerEvents: hasAnyHandler ? 'none' : 'auto'
-      }
-    }, React__default["default"].createElement("div", {
       ref: containerRef,
       style: {
         position: 'absolute',
         width: '100%',
-        height: '100%'
+        height: '100%',
+        pointerEvents: disablePointerEvents ? 'none' : 'auto'
       }
-    })), divElement);
+    }), divElement);
   };
   /**
    * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -6421,29 +6404,53 @@
    * 비교 전략:
    * 1. markers 배열 비교
    * 2. selectedItems 배열 비교 (외부 제어)
-   * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
    *
    * 주의: JSON.stringify() 사용 금지! (매우 느림)
    */
 
 
   var WoongKonvaMarker = React__default["default"].memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
-    // markers 배열 비교 (참조 비교)
-    if (prevProps.markers !== nextProps.markers) return false; // selectedItems 배열 비교 (참조 비교)
+    // 1. markers 비교
+    var prevMarkers = prevProps.markers;
+    var nextMarkers = nextProps.markers; // 참조가 같으면 스킵
 
-    if (prevProps.selectedItems !== nextProps.selectedItems) return false; // selectedItem 비교 (참조 비교)
+    if (prevMarkers !== nextMarkers) {
+      // 길이가 다르면 변경됨
+      if (prevMarkers.length !== nextMarkers.length) return false; // 각 마커의 ID 비교
+
+      for (var i = 0; i < prevMarkers.length; i++) {
+        if (prevMarkers[i].id !== nextMarkers[i].id) {
+          return false; // 변경됨 → 리렌더링
+        }
+      }
+    } // 2. selectedItems 비교 (참조만 비교)
 
-    if (prevProps.selectedItem !== nextProps.selectedItem) return false; // 이벤트 핸들러 비교 (참조 비교)
 
-    if (prevProps.onClick !== nextProps.onClick) return false;
-    if (prevProps.onMouseOver !== nextProps.onMouseOver) return false;
-    if (prevProps.onMouseOut !== nextProps.onMouseOut) return false; // renderBase, renderEvent 등 함수 비교
+    if (prevProps.selectedItems !== nextProps.selectedItems) {
+      return false; // 변경됨 → 리렌더링
+    }
 
-    if (prevProps.renderBase !== nextProps.renderBase) return false;
-    if (prevProps.renderEvent !== nextProps.renderEvent) return false;
-    if (prevProps.renderAnimation !== nextProps.renderAnimation) return false; // 나머지 props는 변경되지 않는다고 가정
+    if (prevProps.selectedItem !== nextProps.selectedItem) {
+      return false; // 변경됨 → 리렌더링
+    }
 
-    return true;
+    if (prevProps.onClick !== nextProps.onClick) {
+      return false; // 변경됨 → 리렌더링
+    }
+
+    if (prevProps.onMouseOver !== nextProps.onMouseOver) {
+      return false; // 변경됨 → 리렌더링
+    }
+
+    if (prevProps.onMouseOut !== nextProps.onMouseOut) {
+      return false; // 변경됨 → 리렌더링
+    }
+
+    if (prevProps.disablePointerEvents !== nextProps.disablePointerEvents) {
+      return false; // 변경됨 → 리렌더링
+    }
+
+    return true; // 같음 → 리렌더링 스킵
   });
 
   var css_248z = ".MintMapWrapper-module_mint-map-control-wrapper-container__DONh7 {\n  position: absolute;\n  width: 100%;\n  height: 100%;\n  display: flex;\n  pointer-events: none;\n  z-index: 101;\n}\n\n.MintMapWrapper-module_mint-map-overlay-wrapper__Jn4wV {\n  position: absolute;\n  z-index: 1;\n}";
@@ -7186,20 +7193,54 @@
       }
     };
 
-    NaverMintMapController.prototype.setMarkerZIndex = function (marker, zIndex) {
+    NaverMintMapController.prototype.getCurrentZIndex = function (marker) {
       if (this.map && marker.element && marker.element instanceof HTMLElement) {
         var parent_1 = marker.element.parentElement;
 
-        if (parent_1) {
-          parent_1.style.zIndex = String(zIndex);
+        if (parent_1 && parent_1.style.zIndex) {
+          var zIndex = Number(parent_1.style.zIndex);
+          return isNaN(zIndex) ? undefined : zIndex;
+        }
+      }
+
+      return undefined;
+    };
+
+    NaverMintMapController.prototype.setMarkerZIndex = function (marker, zIndex) {
+      if (this.map && marker.element && marker.element instanceof HTMLElement) {
+        var parent_2 = marker.element.parentElement;
+
+        if (parent_2) {
+          parent_2.style.zIndex = String(zIndex);
         }
       }
     };
 
     NaverMintMapController.prototype.markerToTheTop = function (marker) {
+      // 이미 최상위로 올라간 상태면 (원래 zIndex가 이미 저장됨) 중복 실행 방지
+      if (this.markerOriginalZIndex !== undefined) {
+        return;
+      }
+
+      var currentZIndex = this.getCurrentZIndex(marker); // undefined면 null로 저장 (원래 zIndex가 없었음을 표시)
+
+      this.markerOriginalZIndex = currentZIndex !== undefined ? currentZIndex : null;
       this.setMarkerZIndex(marker, this.getMaxZIndex(1));
     };
 
+    NaverMintMapController.prototype.restoreMarkerZIndex = function (marker) {
+      if (this.markerOriginalZIndex !== undefined) {
+        if (this.markerOriginalZIndex === null) {
+          // 원래 zIndex가 없었으면 제거 (또는 초기값 0으로)
+          this.setMarkerZIndex(marker, 0);
+        } else {
+          this.setMarkerZIndex(marker, this.markerOriginalZIndex);
+        }
+
+        this.markerOriginalZIndex = undefined;
+      }
+    };
+
     NaverMintMapController.prototype.clearDrawable = function (drawable) {
       var _a;
 
@@ -7954,6 +7995,10 @@
       }
     };
 
+    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) {
@@ -8676,6 +8721,10 @@
       }
     };
 
+    KakaoMintMapController.prototype.restoreMarkerZIndex = function (marker) {// Kakao Maps에서는 restoreMarkerZIndex 기능을 지원하지 않습니다.
+      // 이 기능은 Naver Maps에서만 사용 가능합니다.
+    };
+
     KakaoMintMapController.prototype.clearDrawable = function (drawable) {
       var _this = this;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mint-ui/map",
-  "version": "1.2.0-test.8",
+  "version": "1.2.0-test.9",
   "main": "./dist/index.js",
   "module": "./dist/index.es.js",
   "browser": "./dist/index.umd.js",