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

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

@@ -24,7 +24,6 @@ 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

@@ -45,6 +45,7 @@ export interface WoongKonvaMarkerProps<T> extends Pick<MarkerOptions, 'zIndex' |
  * 비교 전략:
  * 1. markers 배열 비교
  * 2. selectedItems 배열 비교 (외부 제어)
+ * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
  *
  * 주의: JSON.stringify() 사용 금지! (매우 느림)
  */

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

@@ -131,6 +131,12 @@ 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 (캐싱 & 최적화)
   // --------------------------------------------------------------------------
 
@@ -420,10 +426,16 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var doRenderEvent = function () {
-    if (!onClick && !onMouseOver && !onMouseOut) return;
-    if (!renderEvent) return;
     var layer = eventLayerRef.current;
-    if (!layer) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
+    if (!layer) return; // 이벤트 핸들러가 없으면 Event Layer를 완전히 지움
+
+    if (!onClickRef.current && !onMouseOverRef.current && !onMouseOutRef.current) {
+      layer.destroyChildren();
+      layer.batchDraw();
+      return;
+    }
+
+    if (!renderEvent) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
 
     var shape = layer.findOne('.event-render-shape');
 
@@ -621,7 +633,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var setHovered = function (data) {
-    if (!onMouseOver && !onMouseOut) return;
+    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
     hoveredItemRef.current = data;
 
     if (draggingRef.current) {
@@ -646,7 +658,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleLocalClick = function (data) {
-    if (!onClick) return; // 1. 선택 상태 업데이트
+    if (!onClickRef.current) return; // 1. 선택 상태 업데이트
 
     if (enableMultiSelect) {
       // 다중 선택: Set과 Map 동시 업데이트
@@ -697,7 +709,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleClick = function (event) {
     var _a;
 
-    if (!onClick) return;
+    if (!onClickRef.current) return;
     if (context$1 || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -706,7 +718,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (data) {
         handleLocalClick(data);
-        onClick(data, selectedIdsRef.current);
+        onClickRef.current(data, selectedIdsRef.current);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleClick error:', error);
@@ -720,7 +732,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleMouseMove = function (event) {
     var _a;
 
-    if (!onMouseOver && !onMouseOut) return;
+    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
     if (context$1 || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -730,8 +742,8 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (prevHovered !== hoveredItem) {
         setHovered(hoveredItem);
-        if (prevHovered && onMouseOut) onMouseOut(prevHovered);
-        if (hoveredItem && onMouseOver) onMouseOver(hoveredItem);
+        if (prevHovered && onMouseOutRef.current) onMouseOutRef.current(prevHovered);
+        if (hoveredItem && onMouseOverRef.current) onMouseOverRef.current(hoveredItem);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleMouseMove error:', error);
@@ -761,7 +773,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleMouseLeave = function () {
-    if (!onMouseOver && !onMouseOut) return;
+    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
     var prevHovered = hoveredItemRef.current;
 
     if (prevHovered) {
@@ -769,8 +781,8 @@ var WoongKonvaMarkerComponent = function (_a) {
       controller.setMapCursor('grab');
       doRenderEvent();
 
-      if (onMouseOut) {
-        onMouseOut(prevHovered);
+      if (onMouseOutRef.current) {
+        onMouseOutRef.current(prevHovered);
       }
     }
   }; // --------------------------------------------------------------------------
@@ -871,13 +883,20 @@ var WoongKonvaMarkerComponent = function (_a) {
     controller.addEventListener('IDLE', handleIdle);
     controller.addEventListener('ZOOMSTART', handleZoomStart);
     controller.addEventListener('ZOOM_CHANGED', handleZoomEnd);
-    controller.addEventListener('CENTER_CHANGED', handleCenterChanged);
-    controller.addEventListener('CLICK', handleClick);
-    controller.addEventListener('MOUSEMOVE', handleMouseMove);
-    controller.addEventListener('DRAGSTART', handleDragStart);
-    controller.addEventListener('DRAGEND', handleDragEnd); // 맵 컨테이너에 mouseleave 이벤트 추가
+    controller.addEventListener('CENTER_CHANGED', handleCenterChanged); // onClick이 있을 때만 CLICK 이벤트 등록
+
+    if (onClick) {
+      controller.addEventListener('CLICK', handleClick);
+    } // onMouseOver/onMouseOut이 있을 때만 MOUSEMOVE 이벤트 등록
 
-    mapDiv.addEventListener('mouseleave', handleMouseLeave);
+
+    if (onMouseOver || onMouseOut) {
+      controller.addEventListener('MOUSEMOVE', handleMouseMove);
+      mapDiv.addEventListener('mouseleave', handleMouseLeave);
+    }
+
+    controller.addEventListener('DRAGSTART', handleDragStart);
+    controller.addEventListener('DRAGEND', handleDragEnd);
     renderAllImmediate(); // Context 사용 시 컴포넌트 등록 (다중 인스턴스 관리)
 
     var componentInstance = null;
@@ -920,10 +939,13 @@ var WoongKonvaMarkerComponent = function (_a) {
         controller.removeEventListener('CLICK', handleClick);
       }
 
-      controller.removeEventListener('MOUSEMOVE', handleMouseMove);
+      if (onMouseOver || onMouseOut) {
+        controller.removeEventListener('MOUSEMOVE', handleMouseMove);
+        mapDiv.removeEventListener('mouseleave', handleMouseLeave);
+      }
+
       controller.removeEventListener('DRAGSTART', handleDragStart);
-      controller.removeEventListener('DRAGEND', handleDragEnd);
-      mapDiv.removeEventListener('mouseleave', handleMouseLeave); // Context 정리
+      controller.removeEventListener('DRAGEND', handleDragEnd); // Context 정리
 
       if (context$1 && componentInstance) {
         context$1.unregisterComponent(componentInstance);
@@ -940,6 +962,18 @@ 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 동기화
   // --------------------------------------------------------------------------
 
@@ -1030,14 +1064,23 @@ 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%'
     }
-  }), divElement);
+  })), divElement);
 };
 /**
  * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -1045,33 +1088,29 @@ var WoongKonvaMarkerComponent = function (_a) {
  * 비교 전략:
  * 1. markers 배열 비교
  * 2. selectedItems 배열 비교 (외부 제어)
+ * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
  *
  * 주의: JSON.stringify() 사용 금지! (매우 느림)
  */
 
 
 var WoongKonvaMarker = React__default["default"].memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
-  // 1. markers 비교
-  var prevMarkers = prevProps.markers;
-  var nextMarkers = nextProps.markers; // 참조가 같으면 스킵
+  // markers 배열 비교 (참조 비교)
+  if (prevProps.markers !== nextProps.markers) return false; // selectedItems 배열 비교 (참조 비교)
 
-  if (prevMarkers !== nextMarkers) {
-    // 길이가 다르면 변경됨
-    if (prevMarkers.length !== nextMarkers.length) return false; // 각 마커의 ID 비교
+  if (prevProps.selectedItems !== nextProps.selectedItems) return false; // selectedItem 비교 (참조 비교)
 
-    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는 변경되지 않는다고 가정
 
-  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;
+    var marker = markerRef.current; //console.log('onMouseOverHandler', marker);
 
     if (marker) {
       var mouseOverHandler = (_a = options === null || options === void 0 ? void 0 : options.event) === null || _a === void 0 ? void 0 : _a.get('mouseover');
@@ -185,25 +185,6 @@ 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
 
 
@@ -221,12 +202,10 @@ 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,7 +28,6 @@ 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,10 +340,6 @@ 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,7 +31,6 @@ 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,10 +348,6 @@ 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,12 +27,9 @@ 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,54 +340,20 @@ function (_super) {
     }
   };
 
-  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) {
-        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;
+      var parent_1 = marker.element.parentElement;
 
-      if (parent_2) {
-        parent_2.style.zIndex = String(zIndex);
+      if (parent_1) {
+        parent_1.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;
+    var marker = markerRef.current; //console.log('onMouseOverHandler', marker);
 
     if (marker) {
       var mouseOverHandler = (_a = options === null || options === void 0 ? void 0 : options.event) === null || _a === void 0 ? void 0 : _a.get('mouseover');
@@ -2763,25 +2763,6 @@ 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
 
 
@@ -2799,12 +2780,10 @@ 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);
@@ -5481,6 +5460,12 @@ 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 (캐싱 & 최적화)
   // --------------------------------------------------------------------------
 
@@ -5770,10 +5755,16 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var doRenderEvent = function () {
-    if (!onClick && !onMouseOver && !onMouseOut) return;
-    if (!renderEvent) return;
     var layer = eventLayerRef.current;
-    if (!layer) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
+    if (!layer) return; // 이벤트 핸들러가 없으면 Event Layer를 완전히 지움
+
+    if (!onClickRef.current && !onMouseOverRef.current && !onMouseOutRef.current) {
+      layer.destroyChildren();
+      layer.batchDraw();
+      return;
+    }
+
+    if (!renderEvent) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
 
     var shape = layer.findOne('.event-render-shape');
 
@@ -5971,7 +5962,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var setHovered = function (data) {
-    if (!onMouseOver && !onMouseOut) return;
+    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
     hoveredItemRef.current = data;
 
     if (draggingRef.current) {
@@ -5996,7 +5987,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleLocalClick = function (data) {
-    if (!onClick) return; // 1. 선택 상태 업데이트
+    if (!onClickRef.current) return; // 1. 선택 상태 업데이트
 
     if (enableMultiSelect) {
       // 다중 선택: Set과 Map 동시 업데이트
@@ -6047,7 +6038,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleClick = function (event) {
     var _a;
 
-    if (!onClick) return;
+    if (!onClickRef.current) return;
     if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -6056,7 +6047,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (data) {
         handleLocalClick(data);
-        onClick(data, selectedIdsRef.current);
+        onClickRef.current(data, selectedIdsRef.current);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleClick error:', error);
@@ -6070,7 +6061,7 @@ var WoongKonvaMarkerComponent = function (_a) {
   var handleMouseMove = function (event) {
     var _a;
 
-    if (!onMouseOver && !onMouseOut) return;
+    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
     if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
     try {
@@ -6080,8 +6071,8 @@ var WoongKonvaMarkerComponent = function (_a) {
 
       if (prevHovered !== hoveredItem) {
         setHovered(hoveredItem);
-        if (prevHovered && onMouseOut) onMouseOut(prevHovered);
-        if (hoveredItem && onMouseOver) onMouseOver(hoveredItem);
+        if (prevHovered && onMouseOutRef.current) onMouseOutRef.current(prevHovered);
+        if (hoveredItem && onMouseOverRef.current) onMouseOverRef.current(hoveredItem);
       }
     } catch (error) {
       console.error('[WoongKonvaMarker] handleMouseMove error:', error);
@@ -6111,7 +6102,7 @@ var WoongKonvaMarkerComponent = function (_a) {
 
 
   var handleMouseLeave = function () {
-    if (!onMouseOver && !onMouseOut) return;
+    if (!onMouseOverRef.current && !onMouseOutRef.current) return;
     var prevHovered = hoveredItemRef.current;
 
     if (prevHovered) {
@@ -6119,8 +6110,8 @@ var WoongKonvaMarkerComponent = function (_a) {
       controller.setMapCursor('grab');
       doRenderEvent();
 
-      if (onMouseOut) {
-        onMouseOut(prevHovered);
+      if (onMouseOutRef.current) {
+        onMouseOutRef.current(prevHovered);
       }
     }
   }; // --------------------------------------------------------------------------
@@ -6221,13 +6212,20 @@ var WoongKonvaMarkerComponent = function (_a) {
     controller.addEventListener('IDLE', handleIdle);
     controller.addEventListener('ZOOMSTART', handleZoomStart);
     controller.addEventListener('ZOOM_CHANGED', handleZoomEnd);
-    controller.addEventListener('CENTER_CHANGED', handleCenterChanged);
-    controller.addEventListener('CLICK', handleClick);
-    controller.addEventListener('MOUSEMOVE', handleMouseMove);
-    controller.addEventListener('DRAGSTART', handleDragStart);
-    controller.addEventListener('DRAGEND', handleDragEnd); // 맵 컨테이너에 mouseleave 이벤트 추가
+    controller.addEventListener('CENTER_CHANGED', handleCenterChanged); // onClick이 있을 때만 CLICK 이벤트 등록
+
+    if (onClick) {
+      controller.addEventListener('CLICK', handleClick);
+    } // onMouseOver/onMouseOut이 있을 때만 MOUSEMOVE 이벤트 등록
+
 
-    mapDiv.addEventListener('mouseleave', handleMouseLeave);
+    if (onMouseOver || onMouseOut) {
+      controller.addEventListener('MOUSEMOVE', handleMouseMove);
+      mapDiv.addEventListener('mouseleave', handleMouseLeave);
+    }
+
+    controller.addEventListener('DRAGSTART', handleDragStart);
+    controller.addEventListener('DRAGEND', handleDragEnd);
     renderAllImmediate(); // Context 사용 시 컴포넌트 등록 (다중 인스턴스 관리)
 
     var componentInstance = null;
@@ -6270,10 +6268,13 @@ var WoongKonvaMarkerComponent = function (_a) {
         controller.removeEventListener('CLICK', handleClick);
       }
 
-      controller.removeEventListener('MOUSEMOVE', handleMouseMove);
+      if (onMouseOver || onMouseOut) {
+        controller.removeEventListener('MOUSEMOVE', handleMouseMove);
+        mapDiv.removeEventListener('mouseleave', handleMouseLeave);
+      }
+
       controller.removeEventListener('DRAGSTART', handleDragStart);
-      controller.removeEventListener('DRAGEND', handleDragEnd);
-      mapDiv.removeEventListener('mouseleave', handleMouseLeave); // Context 정리
+      controller.removeEventListener('DRAGEND', handleDragEnd); // Context 정리
 
       if (context && componentInstance) {
         context.unregisterComponent(componentInstance);
@@ -6290,6 +6291,18 @@ 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 동기화
   // --------------------------------------------------------------------------
 
@@ -6380,14 +6393,23 @@ 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%'
     }
-  }), divElement);
+  })), divElement);
 };
 /**
  * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -6395,33 +6417,29 @@ var WoongKonvaMarkerComponent = function (_a) {
  * 비교 전략:
  * 1. markers 배열 비교
  * 2. selectedItems 배열 비교 (외부 제어)
+ * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
  *
  * 주의: JSON.stringify() 사용 금지! (매우 느림)
  */
 
 
 var WoongKonvaMarker = React.memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
-  // 1. markers 비교
-  var prevMarkers = prevProps.markers;
-  var nextMarkers = nextProps.markers; // 참조가 같으면 스킵
+  // markers 배열 비교 (참조 비교)
+  if (prevProps.markers !== nextProps.markers) return false; // selectedItems 배열 비교 (참조 비교)
 
-  if (prevMarkers !== nextMarkers) {
-    // 길이가 다르면 변경됨
-    if (prevMarkers.length !== nextMarkers.length) return false; // 각 마커의 ID 비교
+  if (prevProps.selectedItems !== nextProps.selectedItems) return false; // selectedItem 비교 (참조 비교)
 
-    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는 변경되지 않는다고 가정
 
-  return true; // 같음 → 리렌더링 스킵
+  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}";
@@ -7164,54 +7182,20 @@ function (_super) {
     }
   };
 
-  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) {
-        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;
+      var parent_1 = marker.element.parentElement;
 
-      if (parent_2) {
-        parent_2.style.zIndex = String(zIndex);
+      if (parent_1) {
+        parent_1.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;
 
@@ -7966,10 +7950,6 @@ 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) {
@@ -8692,10 +8672,6 @@ 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;
+      var marker = markerRef.current; //console.log('onMouseOverHandler', marker);
 
       if (marker) {
         var mouseOverHandler = (_a = options === null || options === void 0 ? void 0 : options.event) === null || _a === void 0 ? void 0 : _a.get('mouseover');
@@ -2767,25 +2767,6 @@
 
         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
 
 
@@ -2803,12 +2784,10 @@
       }); //드래그 여부 초기화를 먼저 수행하기 위해 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);
@@ -5485,6 +5464,12 @@
       x: 0,
       y: 0
     }); // --------------------------------------------------------------------------
+    // Event Handler Refs (클로저 문제 방지)
+    // --------------------------------------------------------------------------
+
+    var onClickRef = React.useRef(onClick);
+    var onMouseOverRef = React.useRef(onMouseOver);
+    var onMouseOutRef = React.useRef(onMouseOut); // --------------------------------------------------------------------------
     // Performance Refs (캐싱 & 최적화)
     // --------------------------------------------------------------------------
 
@@ -5774,10 +5759,16 @@
 
 
     var doRenderEvent = function () {
-      if (!onClick && !onMouseOver && !onMouseOut) return;
-      if (!renderEvent) return;
       var layer = eventLayerRef.current;
-      if (!layer) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
+      if (!layer) return; // 이벤트 핸들러가 없으면 Event Layer를 완전히 지움
+
+      if (!onClickRef.current && !onMouseOverRef.current && !onMouseOutRef.current) {
+        layer.destroyChildren();
+        layer.batchDraw();
+        return;
+      }
+
+      if (!renderEvent) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
 
       var shape = layer.findOne('.event-render-shape');
 
@@ -5975,7 +5966,7 @@
 
 
     var setHovered = function (data) {
-      if (!onMouseOver && !onMouseOut) return;
+      if (!onMouseOverRef.current && !onMouseOutRef.current) return;
       hoveredItemRef.current = data;
 
       if (draggingRef.current) {
@@ -6000,7 +5991,7 @@
 
 
     var handleLocalClick = function (data) {
-      if (!onClick) return; // 1. 선택 상태 업데이트
+      if (!onClickRef.current) return; // 1. 선택 상태 업데이트
 
       if (enableMultiSelect) {
         // 다중 선택: Set과 Map 동시 업데이트
@@ -6051,7 +6042,7 @@
     var handleClick = function (event) {
       var _a;
 
-      if (!onClick) return;
+      if (!onClickRef.current) return;
       if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
       try {
@@ -6060,7 +6051,7 @@
 
         if (data) {
           handleLocalClick(data);
-          onClick(data, selectedIdsRef.current);
+          onClickRef.current(data, selectedIdsRef.current);
         }
       } catch (error) {
         console.error('[WoongKonvaMarker] handleClick error:', error);
@@ -6074,7 +6065,7 @@
     var handleMouseMove = function (event) {
       var _a;
 
-      if (!onMouseOver && !onMouseOut) return;
+      if (!onMouseOverRef.current && !onMouseOutRef.current) return;
       if (context || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
 
       try {
@@ -6084,8 +6075,8 @@
 
         if (prevHovered !== hoveredItem) {
           setHovered(hoveredItem);
-          if (prevHovered && onMouseOut) onMouseOut(prevHovered);
-          if (hoveredItem && onMouseOver) onMouseOver(hoveredItem);
+          if (prevHovered && onMouseOutRef.current) onMouseOutRef.current(prevHovered);
+          if (hoveredItem && onMouseOverRef.current) onMouseOverRef.current(hoveredItem);
         }
       } catch (error) {
         console.error('[WoongKonvaMarker] handleMouseMove error:', error);
@@ -6115,7 +6106,7 @@
 
 
     var handleMouseLeave = function () {
-      if (!onMouseOver && !onMouseOut) return;
+      if (!onMouseOverRef.current && !onMouseOutRef.current) return;
       var prevHovered = hoveredItemRef.current;
 
       if (prevHovered) {
@@ -6123,8 +6114,8 @@
         controller.setMapCursor('grab');
         doRenderEvent();
 
-        if (onMouseOut) {
-          onMouseOut(prevHovered);
+        if (onMouseOutRef.current) {
+          onMouseOutRef.current(prevHovered);
         }
       }
     }; // --------------------------------------------------------------------------
@@ -6225,13 +6216,20 @@
       controller.addEventListener('IDLE', handleIdle);
       controller.addEventListener('ZOOMSTART', handleZoomStart);
       controller.addEventListener('ZOOM_CHANGED', handleZoomEnd);
-      controller.addEventListener('CENTER_CHANGED', handleCenterChanged);
-      controller.addEventListener('CLICK', handleClick);
-      controller.addEventListener('MOUSEMOVE', handleMouseMove);
-      controller.addEventListener('DRAGSTART', handleDragStart);
-      controller.addEventListener('DRAGEND', handleDragEnd); // 맵 컨테이너에 mouseleave 이벤트 추가
+      controller.addEventListener('CENTER_CHANGED', handleCenterChanged); // onClick이 있을 때만 CLICK 이벤트 등록
+
+      if (onClick) {
+        controller.addEventListener('CLICK', handleClick);
+      } // onMouseOver/onMouseOut이 있을 때만 MOUSEMOVE 이벤트 등록
+
 
-      mapDiv.addEventListener('mouseleave', handleMouseLeave);
+      if (onMouseOver || onMouseOut) {
+        controller.addEventListener('MOUSEMOVE', handleMouseMove);
+        mapDiv.addEventListener('mouseleave', handleMouseLeave);
+      }
+
+      controller.addEventListener('DRAGSTART', handleDragStart);
+      controller.addEventListener('DRAGEND', handleDragEnd);
       renderAllImmediate(); // Context 사용 시 컴포넌트 등록 (다중 인스턴스 관리)
 
       var componentInstance = null;
@@ -6274,10 +6272,13 @@
           controller.removeEventListener('CLICK', handleClick);
         }
 
-        controller.removeEventListener('MOUSEMOVE', handleMouseMove);
+        if (onMouseOver || onMouseOut) {
+          controller.removeEventListener('MOUSEMOVE', handleMouseMove);
+          mapDiv.removeEventListener('mouseleave', handleMouseLeave);
+        }
+
         controller.removeEventListener('DRAGSTART', handleDragStart);
-        controller.removeEventListener('DRAGEND', handleDragEnd);
-        mapDiv.removeEventListener('mouseleave', handleMouseLeave); // Context 정리
+        controller.removeEventListener('DRAGEND', handleDragEnd); // Context 정리
 
         if (context && componentInstance) {
           context.unregisterComponent(componentInstance);
@@ -6294,6 +6295,18 @@
         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 동기화
     // --------------------------------------------------------------------------
 
@@ -6384,14 +6397,23 @@
 
       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%'
       }
-    }), divElement);
+    })), divElement);
   };
   /**
    * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
@@ -6399,33 +6421,29 @@
    * 비교 전략:
    * 1. markers 배열 비교
    * 2. selectedItems 배열 비교 (외부 제어)
+   * 3. 이벤트 핸들러 비교 (onClick, onMouseOver, onMouseOut)
    *
    * 주의: JSON.stringify() 사용 금지! (매우 느림)
    */
 
 
   var WoongKonvaMarker = React__default["default"].memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
-    // 1. markers 비교
-    var prevMarkers = prevProps.markers;
-    var nextMarkers = nextProps.markers; // 참조가 같으면 스킵
+    // markers 배열 비교 (참조 비교)
+    if (prevProps.markers !== nextProps.markers) return false; // selectedItems 배열 비교 (참조 비교)
 
-    if (prevMarkers !== nextMarkers) {
-      // 길이가 다르면 변경됨
-      if (prevMarkers.length !== nextMarkers.length) return false; // 각 마커의 ID 비교
+    if (prevProps.selectedItems !== nextProps.selectedItems) return false; // selectedItem 비교 (참조 비교)
 
-      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는 변경되지 않는다고 가정
 
-    return true; // 같음 → 리렌더링 스킵
+    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}";
@@ -7168,54 +7186,20 @@
       }
     };
 
-    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) {
-          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;
+        var parent_1 = marker.element.parentElement;
 
-        if (parent_2) {
-          parent_2.style.zIndex = String(zIndex);
+        if (parent_1) {
+          parent_1.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;
 
@@ -7970,10 +7954,6 @@
       }
     };
 
-    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) {
@@ -8696,10 +8676,6 @@
       }
     };
 
-    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.7",
+  "version": "1.2.0-test.8",
   "main": "./dist/index.js",
   "module": "./dist/index.es.js",
   "browser": "./dist/index.umd.js",