@mint-ui/map 1.2.0-test.1 → 1.2.0-test.10

package/dist/index.es.js

@@ -5,6 +5,7 @@ import styleInject from 'style-inject';
 import { v4 } from 'uuid';
 import { ObjectPool } from '@mint-ui/tools';
 import { createPortal } from 'react-dom';
+import Konva from 'konva';
 
 var css_248z$2 = ".MintMap-module_loading-point-container__znk6l {\n  display: flex;\n  justify-content: center;\n  align-items: center;\n  width: 100%;\n  height: 100%;\n}\n\n.MintMap-module_ani-blink__K89JK {\n  animation: MintMap-module_blink__mqfeV infinite 0.6s;\n}\n\n@keyframes MintMap-module_blink__mqfeV {\n  0% {\n    opacity: 1;\n  }\n  50% {\n    opacity: 0.3;\n  }\n  100% {\n    opacity: 1;\n  }\n}\n.MintMap-module_ani-fade-in__lpHuy {\n  animation: MintMap-module_fade-in__jHpv1 1s;\n}\n\n@keyframes MintMap-module_fade-in__jHpv1 {\n  0% {\n    opacity: 0;\n  }\n  100% {\n    opacity: 1;\n  }\n}\n.MintMap-module_ani-fade-out__5-esw {\n  animation: MintMap-module_fade-out__CIjGe 1s;\n}\n\n@keyframes MintMap-module_fade-out__CIjGe {\n  0% {\n    opacity: 1;\n  }\n  100% {\n    opacity: 0;\n  }\n}\n.MintMap-module_ani-expansion__S2vOZ {\n  animation: MintMap-module_expansion__WMo5- ease 0.6s;\n}\n\n@keyframes MintMap-module_expansion__WMo5- {\n  0% {\n    width: 0%;\n  }\n  100% {\n    width: 100%;\n  }\n}";
 var styles$2 = {"loading-point-container":"MintMap-module_loading-point-container__znk6l","ani-blink":"MintMap-module_ani-blink__K89JK","blink":"MintMap-module_blink__mqfeV","ani-fade-in":"MintMap-module_ani-fade-in__lpHuy","fade-in":"MintMap-module_fade-in__jHpv1","ani-fade-out":"MintMap-module_ani-fade-out__5-esw","fade-out":"MintMap-module_fade-out__CIjGe","ani-expansion":"MintMap-module_ani-expansion__S2vOZ","expansion":"MintMap-module_expansion__WMo5-"};
@@ -649,6 +650,17 @@ var css_248z$1 = ".MintMapCore-module_mint-map-root__SMfwn {\n  position: relati
 var styles$1 = {"mint-map-root":"MintMapCore-module_mint-map-root__SMfwn","mint-map-container":"MintMapCore-module_mint-map-container__8MIIr"};
 styleInject(css_248z$1);
 
+/**
+ * 캔버스 데이터 타입 Enum
+ * 마커인지 폴리곤인지 구분하는 상수
+ */
+var CanvasDataType;
+
+(function (CanvasDataType) {
+  CanvasDataType["MARKER"] = "MARKER";
+  CanvasDataType["POLYGON"] = "POLYGON";
+})(CanvasDataType || (CanvasDataType = {}));
+
 var Drawable =
 /** @class */
 function () {
@@ -782,6 +794,157 @@ function () {
   return MapUIEvent;
 }();
 
+/**
+ * 폴리곤 offset 계산
+ */
+
+var computePolygonOffsets = function (polygonData, controller) {
+  var paths = polygonData.paths;
+
+  if (!paths || paths.type !== 'MultiPolygon' || !paths.coordinates) {
+    return null;
+  }
+
+  var result = [];
+
+  for (var _i = 0, _a = paths.coordinates; _i < _a.length; _i++) {
+    var multiPolygon = _a[_i];
+    var multiPolygonOffsets = [];
+
+    for (var _b = 0, multiPolygon_1 = multiPolygon; _b < multiPolygon_1.length; _b++) {
+      var polygonGroup = multiPolygon_1[_b];
+      var polygonOffsets = [];
+
+      for (var _c = 0, polygonGroup_1 = polygonGroup; _c < polygonGroup_1.length; _c++) {
+        var coord = polygonGroup_1[_c];
+        var pos = new Position(coord[1], coord[0]);
+        var offset = controller.positionToOffset(pos);
+        polygonOffsets.push([offset.x, offset.y]);
+      }
+
+      multiPolygonOffsets.push(polygonOffsets);
+    }
+
+    result.push(multiPolygonOffsets);
+  }
+
+  return result;
+};
+/**
+ * 마커 offset 계산
+ */
+
+var computeMarkerOffset = function (markerData, controller) {
+  if (!markerData.position) {
+    return null;
+  }
+
+  return controller.positionToOffset(markerData.position);
+};
+/**
+ * Point-in-Polygon 알고리즘
+ */
+
+var isPointInPolygon = function (point, polygon) {
+  var inside = false;
+
+  for (var i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+    var xi = polygon[i][0],
+        yi = polygon[i][1];
+    var xj = polygon[j][0],
+        yj = polygon[j][1];
+    var intersect = yi > point.y !== yj > point.y && point.x < (xj - xi) * (point.y - yi) / (yj - yi) + xi;
+    if (intersect) inside = !inside;
+  }
+
+  return inside;
+};
+/**
+ * 폴리곤 히트 테스트 (도넛 폴리곤 지원)
+ *
+ * 로직:
+ * 1. 외부 폴리곤(첫 번째): 내부에 있어야 함
+ * 2. 내부 구멍들(나머지): 내부에 있으면 안 됨 (evenodd 규칙)
+ *
+ * 중요: 도넛 폴리곤과 내부 폴리곤은 별개의 polygonData로 처리됨
+ * - 도넛 폴리곤 A: isDonutPolygon=true
+ * - 내부 폴리곤 B: isDonutPolygon=false (별도 데이터)
+ */
+
+var isPointInPolygonData = function (clickedOffset, polygonData, getPolygonOffsets) {
+  var polygonOffsets = getPolygonOffsets(polygonData);
+  if (!polygonOffsets) return false; // 🍩 도넛 폴리곤 처리 (isDonutPolygon === true)
+
+  if (polygonData.isDonutPolygon) {
+    for (var _i = 0, polygonOffsets_1 = polygonOffsets; _i < polygonOffsets_1.length; _i++) {
+      var multiPolygon = polygonOffsets_1[_i];
+      if (multiPolygon.length === 0) continue; // 외부 폴리곤만 있는 경우 (구멍 없음) - 일반 폴리곤처럼 처리
+
+      if (multiPolygon.length === 1) {
+        if (isPointInPolygon(clickedOffset, multiPolygon[0])) {
+          return true;
+        }
+
+        continue;
+      } // 1. 외부 폴리곤(첫 번째)에 포함되는지 확인
+
+
+      var outerPolygon = multiPolygon[0];
+
+      if (!isPointInPolygon(clickedOffset, outerPolygon)) {
+        continue; // 외부 폴리곤 밖이면 다음 multiPolygon 확인
+      } // 2. 내부 구멍들(나머지)에 포함되는지 확인
+
+
+      for (var i = 1; i < multiPolygon.length; i++) {
+        var hole = multiPolygon[i];
+
+        if (isPointInPolygon(clickedOffset, hole)) {
+          // ❌ 구멍 안에 있음 → 이 도넛 폴리곤은 히트 안 됨
+          // 다른 multiPolygon 체크하지 않고 바로 false 반환
+          // (도넛 폴리곤의 구멍 안은 무조건 클릭 불가)
+          return false;
+        }
+      } // ✅ 외부 폴리곤 안 + 구멍 밖 = 히트!
+
+
+      return true;
+    }
+
+    return false;
+  } // 일반 폴리곤 처리 (isDonutPolygon === false 또는 undefined)
+
+
+  for (var _a = 0, polygonOffsets_2 = polygonOffsets; _a < polygonOffsets_2.length; _a++) {
+    var multiPolygon = polygonOffsets_2[_a];
+
+    for (var _b = 0, multiPolygon_2 = multiPolygon; _b < multiPolygon_2.length; _b++) {
+      var polygonGroup = multiPolygon_2[_b];
+      if (polygonGroup.length === 0) continue;
+
+      if (isPointInPolygon(clickedOffset, polygonGroup)) {
+        return true;
+      }
+    }
+  }
+
+  return false;
+};
+/**
+ * 마커 히트 테스트
+ */
+
+var isPointInMarkerData = function (clickedOffset, markerData, getMarkerOffset) {
+  var markerOffset = getMarkerOffset(markerData);
+  if (!markerOffset) return false;
+  var boxWidth = markerData.boxWidth || 50;
+  var boxHeight = markerData.boxHeight || 28;
+  var tailHeight = 6;
+  var x = markerOffset.x - boxWidth / 2;
+  var y = markerOffset.y - boxHeight - tailHeight;
+  return clickedOffset.x >= x && clickedOffset.x <= x + boxWidth && clickedOffset.y >= y && clickedOffset.y <= y + boxHeight;
+};
+
 var KonvaMarkerContext = createContext(null);
 var KonvaMarkerProvider = function (_a) {
   var children = _a.children;
@@ -828,7 +991,9 @@ var KonvaMarkerProvider = function (_a) {
     var clickedOffset = controller.positionToOffset(event.param.position); // zIndex 순서대로 순회 (높은 것부터)
 
     for (var _i = 0, _b = componentsRef.current; _i < _b.length; _i++) {
-      var component = _b[_i];
+      var component = _b[_i]; // 🚫 상호작용이 비활성화된 컴포넌트는 스킵
+
+      if (component.isInteractionDisabled()) continue;
       var data = component.findData(clickedOffset);
 
       if (data) {
@@ -856,7 +1021,9 @@ var KonvaMarkerProvider = function (_a) {
     var newHoveredData = null;
 
     for (var _i = 0, _b = componentsRef.current; _i < _b.length; _i++) {
-      var component = _b[_i];
+      var component = _b[_i]; // 🚫 상호작용이 비활성화된 컴포넌트는 스킵
+
+      if (component.isInteractionDisabled()) continue;
       var data = component.findData(mouseOffset);
 
       if (data) {
@@ -928,6 +1095,344 @@ var KonvaMarkerProvider = function (_a) {
     value: contextValue
   }, children);
 };
+var useKonvaMarkerContext = function () {
+  var context = useContext(KonvaMarkerContext);
+  return context;
+};
+
+// ============================================================================
+// 성능 최적화 상수 (30,000개 마커/폴리곤 기준 최적화)
+// ============================================================================
+
+/**
+ * 공간 인덱스 그리드 셀 크기 (px)
+ *
+ * 최적값 계산:
+ * - 목표: 클릭 시 셀당 10~30개 항목만 체크 (빠른 Hit Test)
+ * - 화면 크기: 1920×1080 기준
+ * - 30,000개 항목 → 50px 셀 크기 = 약 800개 셀 = 셀당 ~37개
+ *
+ * 성능 비교 (30,000개 기준):
+ * - 200px: 셀당 ~577개 → Hit Test O(577) ❌ 느림
+ * - 50px:  셀당 ~37개  → Hit Test O(37)  ✅ 15배 빠름!
+ *
+ * 트레이드오프:
+ * - 작을수록: Hit Test 빠름, 메모리 사용량 증가
+ * - 클수록: 메모리 효율적, Hit Test 느림
+ */
+var SPATIAL_GRID_CELL_SIZE = 50;
+/**
+ * 뷰포트 컬링 여유 공간 (px)
+ *
+ * 화면 밖 100px까지 렌더링하여 스크롤 시 부드러운 전환
+ * 30,000개 중 실제 렌더링: 화면에 보이는 1,000~3,000개만
+ */
+
+var DEFAULT_CULLING_MARGIN = 100;
+/**
+ * LRU 캐시 최대 항목 수
+ *
+ * 좌표 변환 결과 캐싱 (positionToOffset 연산 비용 절약)
+ *
+ * 최적값 계산:
+ * - 전체 항목: 30,000개
+ * - 캐시 크기: 30,000개 → 100% 히트율 (메모리: ~2.4MB)
+ *
+ * 메모리 사용량 (항목당 ~80 bytes):
+ * - 10,000개: ~800KB  → 캐시 히트율 33% ❌
+ * - 30,000개: ~2.4MB  → 캐시 히트율 100% ✅
+ *
+ * zoom/pan 시 어차피 clear() 호출되므로 메모리 누적 없음
+ */
+
+var DEFAULT_MAX_CACHE_SIZE = 30000;
+/**
+ * LRU (Least Recently Used) Cache
+ * 메모리 제한을 위한 캐시 구현 (최적화 버전)
+ *
+ * 개선 사항:
+ * 1. get() 성능 향상: 접근 빈도 추적 없이 단순 조회만 수행 (delete+set 제거)
+ * 2. set() 버그 수정: 기존 키 업데이트 시 maxSize 체크 로직 개선
+ * 3. 메모리 효율: 단순 FIFO 캐시로 동작하여 오버헤드 최소화
+ */
+
+var LRUCache =
+/** @class */
+function () {
+  function LRUCache(maxSize) {
+    if (maxSize === void 0) {
+      maxSize = 10000;
+    }
+
+    this.cache = new Map();
+    this.maxSize = maxSize;
+  }
+  /**
+   * 캐시에서 값 조회
+   *
+   * 최적화: delete+set 제거
+   * - 이전: 매번 delete+set으로 LRU 갱신 (해시 재계산 비용)
+   * - 현재: 단순 조회만 수행 (O(1) 해시 조회)
+   *
+   * 트레이드오프:
+   * - 장점: 읽기 성능 대폭 향상 (10,000번 get → 이전보다 2배 빠름)
+   * - 단점: 접근 빈도가 아닌 삽입 순서 기반 eviction (FIFO)
+   *
+   * WoongKonvaMarker 사용 사례에 최적:
+   * - 좌표 변환 결과는 zoom/pan 시 어차피 전체 초기화
+   * - 접근 빈도 추적보다 빠른 조회가 더 중요
+   */
+
+
+  LRUCache.prototype.get = function (key) {
+    return this.cache.get(key);
+  };
+  /**
+   * 캐시에 값 저장 (버그 수정 + 최적화)
+   *
+   * 수정 사항:
+   * 1. 기존 키 업데이트 시 크기 체크 누락 버그 수정
+   * 2. 로직 명확화: 기존 항목/신규 항목 분리 처리
+   */
+
+
+  LRUCache.prototype.set = function (key, value) {
+    var exists = this.cache.has(key);
+
+    if (exists) {
+      // 기존 항목 업데이트: 단순 덮어쓰기 (크기 변화 없음)
+      this.cache.set(key, value);
+    } else {
+      // 신규 항목 추가: 크기 체크 필요
+      if (this.cache.size >= this.maxSize) {
+        // 가장 오래된 항목 제거 (Map의 첫 번째 항목)
+        var firstKey = this.cache.keys().next().value;
+
+        if (firstKey !== undefined) {
+          this.cache.delete(firstKey);
+        }
+      }
+
+      this.cache.set(key, value);
+    }
+  };
+
+  LRUCache.prototype.clear = function () {
+    this.cache.clear();
+  };
+
+  LRUCache.prototype.size = function () {
+    return this.cache.size;
+  };
+
+  LRUCache.prototype.has = function (key) {
+    return this.cache.has(key);
+  };
+
+  return LRUCache;
+}();
+/**
+ * Spatial Hash Grid (공간 해시 그리드)
+ * 공간 인덱싱을 위한 그리드 기반 자료구조 (개선 버전)
+ *
+ * 개선 사항:
+ * 1. 중복 삽입 방지: 같은 항목을 여러 번 insert 해도 안전
+ * 2. 메모리 누수 방지: 기존 항목 자동 제거
+ * 3. 성능 최적화: 불필요한 배열 생성 최소화
+ *
+ * 사용 사례:
+ * - 빠른 Hit Test (마우스 클릭 시 어떤 마커/폴리곤인지 찾기)
+ * - 30,000개 항목 → 클릭 위치 주변 ~10개만 체크 (3,000배 빠름)
+ */
+
+var SpatialHashGrid =
+/** @class */
+function () {
+  function SpatialHashGrid(cellSize) {
+    if (cellSize === void 0) {
+      cellSize = 200;
+    }
+
+    this.cellSize = cellSize;
+    this.grid = new Map();
+    this.itemToCells = new Map();
+  }
+  /**
+   * 셀 키 생성 (x, y 좌표 → 그리드 셀 ID)
+   */
+
+
+  SpatialHashGrid.prototype.getCellKey = function (x, y) {
+    var cellX = Math.floor(x / this.cellSize);
+    var cellY = Math.floor(y / this.cellSize);
+    return "".concat(cellX, ",").concat(cellY);
+  };
+  /**
+   * 바운딩 박스가 걸치는 모든 셀 키 배열 반환
+   */
+
+
+  SpatialHashGrid.prototype.getCellsForBounds = function (minX, minY, maxX, maxY) {
+    var cells = [];
+    var startCellX = Math.floor(minX / this.cellSize);
+    var startCellY = Math.floor(minY / this.cellSize);
+    var endCellX = Math.floor(maxX / this.cellSize);
+    var endCellY = Math.floor(maxY / this.cellSize);
+
+    for (var x = startCellX; x <= endCellX; x++) {
+      for (var y = startCellY; y <= endCellY; y++) {
+        cells.push("".concat(x, ",").concat(y));
+      }
+    }
+
+    return cells;
+  };
+  /**
+   * 항목 추가 (바운딩 박스 기반)
+   *
+   * 개선 사항:
+   * - 중복 삽입 방지: 기존 항목이 있으면 먼저 제거 후 재삽입
+   * - 메모리 누수 방지: 이전 셀 참조 완전 제거
+   */
+
+
+  SpatialHashGrid.prototype.insert = function (item, minX, minY, maxX, maxY) {
+    // 1. 기존 항목 제거 (중복 방지)
+    this.remove(item); // 2. 새 위치에 삽입
+
+    var cells = this.getCellsForBounds(minX, minY, maxX, maxY);
+    this.itemToCells.set(item, cells);
+
+    for (var _i = 0, cells_1 = cells; _i < cells_1.length; _i++) {
+      var cell = cells_1[_i];
+
+      if (!this.grid.has(cell)) {
+        this.grid.set(cell, []);
+      }
+
+      this.grid.get(cell).push(item);
+    }
+  };
+  /**
+   * 항목 제거
+   *
+   * 추가된 메서드: 메모리 누수 방지 및 업데이트 지원
+   */
+
+
+  SpatialHashGrid.prototype.remove = function (item) {
+    var prevCells = this.itemToCells.get(item);
+    if (!prevCells) return; // 각 셀에서 항목 제거
+
+    for (var _i = 0, prevCells_1 = prevCells; _i < prevCells_1.length; _i++) {
+      var cell = prevCells_1[_i];
+      var cellItems = this.grid.get(cell);
+
+      if (cellItems) {
+        var index = cellItems.indexOf(item);
+
+        if (index !== -1) {
+          cellItems.splice(index, 1);
+        } // 빈 셀 정리 (메모리 효율)
+
+
+        if (cellItems.length === 0) {
+          this.grid.delete(cell);
+        }
+      }
+    }
+
+    this.itemToCells.delete(item);
+  };
+  /**
+   * 항목 위치 업데이트
+   *
+   * 추가된 메서드: remove + insert의 편의 함수
+   */
+
+
+  SpatialHashGrid.prototype.update = function (item, minX, minY, maxX, maxY) {
+    this.insert(item, minX, minY, maxX, maxY);
+  };
+  /**
+   * 점 주변의 항목 조회 (1개 셀만)
+   *
+   * 성능: O(해당 셀의 항목 수) - 보통 ~10개
+   */
+
+
+  SpatialHashGrid.prototype.queryPoint = function (x, y) {
+    var cellKey = this.getCellKey(x, y);
+    var items = this.grid.get(cellKey); // 빈 배열 재사용 (메모리 할당 최소화)
+
+    return items || [];
+  };
+  /**
+   * 영역 내 항목 조회
+   *
+   * 성능: O(셀 개수 × 셀당 평균 항목 수)
+   * Set으로 중복 제거 보장
+   */
+
+
+  SpatialHashGrid.prototype.queryBounds = function (minX, minY, maxX, maxY) {
+    var cells = this.getCellsForBounds(minX, minY, maxX, maxY);
+    var results = new Set();
+
+    for (var _i = 0, cells_2 = cells; _i < cells_2.length; _i++) {
+      var cell = cells_2[_i];
+      var items = this.grid.get(cell);
+
+      if (items) {
+        for (var _a = 0, items_1 = items; _a < items_1.length; _a++) {
+          var item = items_1[_a];
+          results.add(item);
+        }
+      }
+    }
+
+    return Array.from(results);
+  };
+  /**
+   * 항목 존재 여부 확인
+   *
+   * 추가된 메서드: 빠른 존재 여부 체크
+   */
+
+
+  SpatialHashGrid.prototype.has = function (item) {
+    return this.itemToCells.has(item);
+  };
+  /**
+   * 전체 초기화
+   */
+
+
+  SpatialHashGrid.prototype.clear = function () {
+    this.grid.clear();
+    this.itemToCells.clear();
+  };
+  /**
+   * 통계 정보
+   *
+   * 개선: totalItems는 실제 고유 항목 수를 정확히 반환
+   */
+
+
+  SpatialHashGrid.prototype.stats = function () {
+    var totalCellItems = 0;
+    this.grid.forEach(function (items) {
+      totalCellItems += items.length;
+    });
+    return {
+      totalCells: this.grid.size,
+      totalItems: this.itemToCells.size,
+      avgItemsPerCell: this.grid.size > 0 ? totalCellItems / this.grid.size : 0
+    };
+  };
+
+  return SpatialHashGrid;
+}();
 
 var cn$3 = classNames.bind(styles$1);
 function MintMapCore(_a) {
@@ -4848,6 +5353,1106 @@ function LoadingImage(_a) {
   }))));
 }
 
+// 메인 컴포넌트
+// ============================================================================
+
+/**
+ * Konva 기반 고성능 마커/폴리곤 렌더링 컴포넌트
+ *
+ * 특징:
+ * - Base/Event 레이어 분리로 성능 최적화
+ * - LRU 캐시로 좌표 변환 결과 캐싱
+ * - Spatial Hash Grid로 빠른 Hit Test
+ * - Viewport Culling으로 보이는 영역만 렌더링
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+
+var WoongKonvaMarkerComponent = function (_a) {
+  var markers = _a.markers,
+      dataType = _a.dataType,
+      onClick = _a.onClick,
+      onMouseOver = _a.onMouseOver,
+      onMouseOut = _a.onMouseOut,
+      renderBase = _a.renderBase,
+      renderAnimation = _a.renderAnimation,
+      renderEvent = _a.renderEvent,
+      _b = _a.enableMultiSelect,
+      enableMultiSelect = _b === void 0 ? false : _b,
+      _c = _a.topOnHover,
+      topOnHover = _c === void 0 ? false : _c,
+      _d = _a.enableViewportCulling,
+      enableViewportCulling = _d === void 0 ? true : _d,
+      _e = _a.cullingMargin,
+      cullingMargin = _e === void 0 ? DEFAULT_CULLING_MARGIN : _e,
+      _f = _a.maxCacheSize,
+      maxCacheSize = _f === void 0 ? DEFAULT_MAX_CACHE_SIZE : _f,
+      externalSelectedItems = _a.selectedItems,
+      externalSelectedItem = _a.selectedItem,
+      _g = _a.disableInteraction,
+      disableInteraction = _g === void 0 ? false : _g,
+      options = __rest(_a, ["markers", "dataType", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem", "disableInteraction"]); // --------------------------------------------------------------------------
+  // Hooks & Context
+  // --------------------------------------------------------------------------
+
+
+  var controller = useMintMapController();
+  var context = useKonvaMarkerContext();
+  var currentZIndex = options.zIndex !== undefined ? options.zIndex : 0; // --------------------------------------------------------------------------
+  // DOM Refs
+  // --------------------------------------------------------------------------
+
+  var divRef = useRef(document.createElement('div'));
+  var divElement = divRef.current;
+  var containerRef = useRef(null);
+  var markerRef = useRef(); // --------------------------------------------------------------------------
+  // Konva Refs
+  // --------------------------------------------------------------------------
+
+  var stageRef = useRef(null);
+  var baseLayerRef = useRef(null);
+  var animationLayerRef = useRef(null);
+  var eventLayerRef = useRef(null); // --------------------------------------------------------------------------
+  // Data Refs - 선택 및 Hover 상태 관리
+  // --------------------------------------------------------------------------
+
+  /** markers prop을 ref로 추적 (stale closure 방지, useEffect에서 동기화) */
+
+  var markersRef = useRef(markers); // --------------------------------------------------------------------------
+  // State Refs - 선택 및 Hover 상태 관리
+  // --------------------------------------------------------------------------
+
+  /** 상호작용 비활성화 상태 (Ref로 관리하여 클로저 문제 해결) */
+
+  var disableInteractionRef = useRef(disableInteraction);
+  /** 현재 Hover 중인 항목 */
+
+  var hoveredItemRef = useRef(null);
+  /** 외부에서 전달된 선택 항목 (Ref로 관리하여 클로저 문제 해결) */
+
+  var selectedItemRef = useRef(externalSelectedItem);
+  /**
+   * 선택된 항목의 ID Set
+   *
+   * 용도:
+   * 1. onClick 콜백에 전달 - onClick(data, selectedIdsRef.current)
+   * 2. 선택 여부 빠른 체크 - selectedIdsRef.current.has(id)
+   * 3. 메모리 효율 - ID만 저장 (작음)
+   *
+   * selectedItemsMapRef와 차이:
+   * - selectedIdsRef: ID만 저장 { "id1", "id2" }
+   * - selectedItemsMapRef: 전체 객체 저장 { id1: {...}, id2: {...} }
+   *
+   * 둘 다 필요: ID만 필요한 곳은 이것, 전체 데이터 필요한 곳은 Map
+   */
+
+  var selectedIdsRef = useRef(new Set());
+  /**
+   * 선택된 항목의 실제 데이터 Map (핵심 성능 최적화!)
+   *
+   * 목적: doRenderEvent에서 filter() 순회 제거
+   * - 이전: markersRef.current.filter() → O(전체 마커 수)
+   * - 현재: Map.values() → O(선택된 항목 수)
+   *
+   * 성능 개선: 10,000개 중 1개 선택 시
+   * - 이전: 10,000번 체크
+   * - 현재: 1번 접근 (10,000배 빠름!)
+   */
+
+  var selectedItemsMapRef = useRef(new Map()); // --------------------------------------------------------------------------
+  // Drag Refs
+  // --------------------------------------------------------------------------
+
+  var draggingRef = useRef(false);
+  var prevCenterOffsetRef = useRef(null);
+  var accumTranslateRef = useRef({
+    x: 0,
+    y: 0
+  }); // --------------------------------------------------------------------------
+  // Performance Refs (캐싱 & 최적화)
+  // --------------------------------------------------------------------------
+
+  /** 좌표 변환 결과 LRU 캐시 */
+
+  var offsetCacheRef = useRef(new LRUCache(maxCacheSize));
+  /** 공간 인덱스 (빠른 Hit Test) */
+
+  var spatialIndexRef = useRef(new SpatialHashGrid(SPATIAL_GRID_CELL_SIZE));
+  /** 바운딩 박스 캐시 (Viewport Culling 최적화) */
+
+  var boundingBoxCacheRef = useRef(new Map());
+  /** 뷰포트 경계 캐시 (Viewport Culling) */
+
+  var viewportRef = useRef(null); // --------------------------------------------------------------------------
+  // 유틸리티 함수: 뷰포트 관리
+  // --------------------------------------------------------------------------
+
+  /**
+   * 현재 뷰포트 영역 계산
+   */
+
+  var updateViewport = function () {
+    if (!stageRef.current) return;
+    var stage = stageRef.current;
+    viewportRef.current = {
+      minX: -cullingMargin,
+      maxX: stage.width() + cullingMargin,
+      minY: -cullingMargin,
+      maxY: stage.height() + cullingMargin
+    };
+  };
+  /**
+   * 아이템이 현재 뷰포트 안에 있는지 확인 (바운딩 박스 캐싱)
+   */
+
+
+  var isInViewport = function (item) {
+    if (!enableViewportCulling || !viewportRef.current) return true;
+    var viewport = viewportRef.current; // 캐시된 바운딩 박스 확인
+
+    var bbox = boundingBoxCacheRef.current.get(item.id);
+
+    if (!bbox) {
+      // 폴리곤인 경우
+      if (dataType === CanvasDataType.POLYGON) {
+        var offsets = getOrComputePolygonOffsets(item);
+        if (!offsets) return false; // 바운딩 박스 계산 (최적화: 직접 비교)
+
+        var minX = Infinity,
+            minY = Infinity,
+            maxX = -Infinity,
+            maxY = -Infinity;
+
+        for (var _i = 0, offsets_1 = offsets; _i < offsets_1.length; _i++) {
+          var multiPolygon = offsets_1[_i];
+
+          for (var _a = 0, multiPolygon_1 = multiPolygon; _a < multiPolygon_1.length; _a++) {
+            var polygonGroup = multiPolygon_1[_a];
+
+            for (var _b = 0, polygonGroup_1 = polygonGroup; _b < polygonGroup_1.length; _b++) {
+              var _c = polygonGroup_1[_b],
+                  x = _c[0],
+                  y = _c[1];
+              if (x < minX) minX = x;
+              if (y < minY) minY = y;
+              if (x > maxX) maxX = x;
+              if (y > maxY) maxY = y;
+            }
+          }
+        }
+
+        bbox = {
+          minX: minX,
+          minY: minY,
+          maxX: maxX,
+          maxY: maxY
+        };
+        boundingBoxCacheRef.current.set(item.id, bbox);
+      } // 마커인 경우
+      else {
+        var offset = getOrComputeMarkerOffset(item);
+        if (!offset) return false;
+        var boxWidth = item.boxWidth || 50;
+        var boxHeight = item.boxHeight || 28;
+        bbox = {
+          minX: offset.x - boxWidth / 2,
+          minY: offset.y - boxHeight - 6,
+          maxX: offset.x + boxWidth / 2,
+          maxY: offset.y
+        };
+        boundingBoxCacheRef.current.set(item.id, bbox);
+      }
+    } // 바운딩 박스와 viewport 교차 체크
+
+
+    return !(bbox.maxX < viewport.minX || bbox.minX > viewport.maxX || bbox.maxY < viewport.minY || bbox.minY > viewport.maxY);
+  }; // --------------------------------------------------------------------------
+  // 유틸리티 함수: 좌표 변환 캐싱
+  // --------------------------------------------------------------------------
+
+  /**
+   * 폴리곤 좌표 변환 결과를 캐시하고 반환
+   * @param polygonData 폴리곤 데이터
+   * @returns 변환된 좌표 배열 또는 null
+   */
+
+
+  var getOrComputePolygonOffsets = function (polygonData) {
+    var cached = offsetCacheRef.current.get(polygonData.id);
+    if (cached && Array.isArray(cached)) return cached;
+    var result = computePolygonOffsets(polygonData, controller);
+
+    if (result) {
+      offsetCacheRef.current.set(polygonData.id, result);
+    }
+
+    return result;
+  };
+  /**
+   * 마커 좌표 변환 결과를 캐시하고 반환
+   * @param markerData 마커 데이터
+   * @returns 변환된 좌표 또는 null
+   */
+
+
+  var getOrComputeMarkerOffset = function (markerData) {
+    var cached = offsetCacheRef.current.get(markerData.id);
+    if (cached && !Array.isArray(cached)) return cached;
+    var result = computeMarkerOffset(markerData, controller);
+
+    if (result) {
+      offsetCacheRef.current.set(markerData.id, result);
+    }
+
+    return result;
+  }; // --------------------------------------------------------------------------
+  // 유틸리티 함수: 공간 인덱싱
+  // --------------------------------------------------------------------------
+
+  /**
+   * 공간 인덱스 빌드 (빠른 Hit Test를 위한 자료구조)
+   */
+
+
+  var buildSpatialIndex = function () {
+    var spatial = spatialIndexRef.current;
+    spatial.clear();
+    var currentMarkers = markersRef.current;
+
+    for (var _i = 0, currentMarkers_1 = currentMarkers; _i < currentMarkers_1.length; _i++) {
+      var item = currentMarkers_1[_i];
+
+      if (dataType === CanvasDataType.POLYGON) {
+        // 폴리곤: 바운딩 박스 계산 (최적화: 직접 비교)
+        var offsets = getOrComputePolygonOffsets(item);
+
+        if (offsets) {
+          var minX = Infinity,
+              minY = Infinity,
+              maxX = -Infinity,
+              maxY = -Infinity;
+
+          for (var _a = 0, offsets_2 = offsets; _a < offsets_2.length; _a++) {
+            var multiPolygon = offsets_2[_a];
+
+            for (var _b = 0, multiPolygon_2 = multiPolygon; _b < multiPolygon_2.length; _b++) {
+              var polygonGroup = multiPolygon_2[_b];
+
+              for (var _c = 0, polygonGroup_2 = polygonGroup; _c < polygonGroup_2.length; _c++) {
+                var _d = polygonGroup_2[_c],
+                    x = _d[0],
+                    y = _d[1];
+                if (x < minX) minX = x;
+                if (y < minY) minY = y;
+                if (x > maxX) maxX = x;
+                if (y > maxY) maxY = y;
+              }
+            }
+          }
+
+          spatial.insert(item, minX, minY, maxX, maxY);
+        }
+      } else {
+        // 마커: 점 기반 바운딩 박스
+        var offset = getOrComputeMarkerOffset(item);
+
+        if (offset) {
+          var boxWidth = item.boxWidth || 50;
+          var boxHeight = item.boxHeight || 28;
+          var tailHeight = 6;
+          var minX = offset.x - boxWidth / 2;
+          var minY = offset.y - boxHeight - tailHeight;
+          var maxX = offset.x + boxWidth / 2;
+          var maxY = offset.y;
+          spatial.insert(item, minX, minY, maxX, maxY);
+        }
+      }
+    }
+  }; // --------------------------------------------------------------------------
+  // 렌더링 함수
+  // --------------------------------------------------------------------------
+
+  /**
+   * 외부 렌더링 함수에 전달할 유틸리티 객체
+   */
+
+
+  var renderUtils = {
+    getOrComputePolygonOffsets: getOrComputePolygonOffsets,
+    getOrComputeMarkerOffset: getOrComputeMarkerOffset
+  };
+  /** Base Layer에서 사용할 빈 Set (재사용) */
+
+  useRef(new Set());
+  /**
+   * Base 레이어 렌더링 (뷰포트 컬링 적용, 선택된 마커 제외)
+   *
+   * 🔥 최적화:
+   * 1. Shape 재사용으로 객체 생성/파괴 오버헤드 제거
+   * 2. sceneFunc 한 번만 설정 (함수 재생성 제거)
+   * 3. 클로저로 최신 데이터 참조
+   */
+
+  var doRenderBase = function () {
+    var layer = baseLayerRef.current;
+    if (!layer) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
+
+    var shape = layer.findOne('.base-render-shape');
+
+    if (!shape) {
+      // 최초 생성 (한 번만 실행됨)
+      // sceneFunc도 여기서 한 번만 설정 (클로저로 최신 데이터 참조)
+      shape = new Konva.Shape({
+        name: 'base-render-shape',
+        sceneFunc: function (context, shape) {
+          var ctx = context; // 클로저로 최신 ref 값 참조
+
+          var visibleMarkers = enableViewportCulling ? markersRef.current.filter(function (item) {
+            return isInViewport(item);
+          }) : markersRef.current;
+          renderBase({
+            ctx: ctx,
+            items: visibleMarkers,
+            selectedIds: selectedIdsRef.current,
+            utils: renderUtils
+          });
+        },
+        perfectDrawEnabled: false,
+        listening: false,
+        hitStrokeWidth: 0
+      });
+      layer.add(shape);
+    } // sceneFunc는 이미 설정되어 있으므로 다시 그리기만
+
+
+    layer.batchDraw();
+  };
+  /**
+   * Animation 레이어 렌더링 (선택된 마커 애니메이션)
+   *
+   * 🔥 최적화: sceneFunc 내부에서 최신 items 참조
+   * - 선택 변경 시에만 재생성
+   * - 지도 이동 시에는 기존 Animation 계속 실행
+   */
+
+
+  var doRenderAnimation = function () {
+    if (!renderAnimation) return;
+    var layer = animationLayerRef.current;
+    if (!layer) return;
+    renderAnimation({
+      layer: layer,
+      selectedIds: selectedIdsRef.current,
+      items: markersRef.current,
+      utils: renderUtils
+    });
+  };
+  /**
+   * Event 레이어 렌더링 (hover + 선택 상태 표시)
+   *
+   * 🔥 최적화:
+   * 1. Shape 재사용으로 객체 생성/파괴 오버헤드 제거
+   * 2. sceneFunc 한 번만 설정 (함수 재생성 제거)
+   * 3. 클로저로 최신 데이터 참조
+   */
+
+
+  var doRenderEvent = function () {
+    var layer = eventLayerRef.current;
+    if (!layer) return;
+
+    if (!onClick && !onMouseOver && !onMouseOut) {
+      layer.destroyChildren();
+      layer.batchDraw();
+      return;
+    }
+
+    if (!renderEvent) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
+
+    var shape = layer.findOne('.event-render-shape');
+
+    if (!shape) {
+      // 최초 생성 (한 번만 실행됨)
+      // sceneFunc도 여기서 한 번만 설정 (클로저로 최신 데이터 참조)
+      shape = new Konva.Shape({
+        name: 'event-render-shape',
+        sceneFunc: function (context, shape) {
+          var ctx = context; // 클로저로 최신 ref 값 참조
+
+          var selectedItems = Array.from(selectedItemsMapRef.current.values());
+          renderEvent({
+            ctx: ctx,
+            hoveredItem: hoveredItemRef.current,
+            utils: renderUtils,
+            selectedItems: selectedItems,
+            selectedItem: selectedItemRef.current
+          });
+        },
+        perfectDrawEnabled: false,
+        listening: false,
+        hitStrokeWidth: 0
+      });
+      layer.add(shape);
+    } // sceneFunc는 이미 설정되어 있으므로 다시 그리기만
+
+
+    layer.batchDraw();
+  };
+  /**
+   * 전체 즉시 렌더링 (IDLE 시 호출)
+   */
+
+
+  var renderAllImmediate = function () {
+    updateViewport();
+    buildSpatialIndex();
+    doRenderBase();
+    doRenderAnimation();
+    doRenderEvent();
+  }; // --------------------------------------------------------------------------
+  // 이벤트 핸들러: 지도 이벤트
+  // --------------------------------------------------------------------------
+
+  /**
+   * 지도 이동/줌 완료 시 처리
+   */
+
+
+  var handleIdle = function () {
+    prevCenterOffsetRef.current = null;
+    accumTranslateRef.current = {
+      x: 0,
+      y: 0
+    }; // 2. 캐시 정리 (지도 이동/줌으로 좌표 변환 결과가 바뀜)
+
+    offsetCacheRef.current.clear();
+    boundingBoxCacheRef.current.clear(); // 3. 마커 위치 업데이트
+
+    var bounds = controller.getCurrBounds();
+
+    var markerOptions = __assign({
+      position: bounds.nw
+    }, options);
+
+    markerRef.current && controller.updateMarker(markerRef.current, markerOptions); // 4. transform 제거 전에 새 데이터로 즉시 렌더링 (겹침 방지)
+
+    if (containerRef.current) {
+      containerRef.current.style.transform = '';
+      containerRef.current.style.visibility = '';
+    } // 5. 새 위치에서 렌더링
+
+
+    renderAllImmediate();
+  };
+  /**
+   * 줌 시작 시 처리 (일시적으로 숨김)
+   */
+
+
+  var handleZoomStart = function () {
+    if (containerRef.current) {
+      containerRef.current.style.visibility = 'hidden';
+    }
+  };
+  /**
+   * 줌 종료 시 처리 (다시 표시)
+   */
+
+
+  var handleZoomEnd = function () {
+    if (containerRef.current) {
+      containerRef.current.style.visibility = '';
+    }
+  };
+  /**
+   * 지도 중심 변경 시 처리 (transform으로 이동 추적)
+   */
+
+
+  var handleCenterChanged = function () {
+    var center = controller.getCurrBounds().getCenter();
+    var curr = controller.positionToOffset(center);
+    var prev = prevCenterOffsetRef.current;
+
+    if (!prev) {
+      prevCenterOffsetRef.current = {
+        x: curr.x,
+        y: curr.y
+      };
+      return;
+    }
+
+    var dx = prev.x - curr.x;
+    var dy = prev.y - curr.y;
+    accumTranslateRef.current = {
+      x: accumTranslateRef.current.x + dx,
+      y: accumTranslateRef.current.y + dy
+    };
+    prevCenterOffsetRef.current = {
+      x: curr.x,
+      y: curr.y
+    };
+
+    if (containerRef.current) {
+      containerRef.current.style.transform = "translate(".concat(accumTranslateRef.current.x, "px, ").concat(accumTranslateRef.current.y, "px)");
+    }
+  }; // --------------------------------------------------------------------------
+  // Hit Test & 상태 관리
+  // --------------------------------------------------------------------------
+
+  /**
+   * 특정 좌표의 마커/폴리곤 데이터 찾기 (Spatial Index 사용)
+   *
+   * topOnHover가 true일 때:
+   * - 현재 hover된 항목을 최우선으로 체크
+   * - 시각적으로 최상단에 있는 항목이 hit test에서도 우선됨
+   *
+   * @param offset 검사할 좌표
+   * @returns 찾은 마커/폴리곤 데이터 또는 null
+   */
+
+
+  var findData = function (offset) {
+    // topOnHover가 true이고 현재 hover된 항목이 있으면, 그것을 먼저 체크
+    if (topOnHover && hoveredItemRef.current) {
+      var hovered = hoveredItemRef.current; // 폴리곤인 경우
+
+      if (dataType === CanvasDataType.POLYGON) {
+        if (isPointInPolygonData(offset, hovered, getOrComputePolygonOffsets)) {
+          return hovered; // 여전히 hover된 항목 위에 있음
+        }
+      } // 마커인 경우
+      else {
+        if (isPointInMarkerData(offset, hovered, getOrComputeMarkerOffset)) {
+          return hovered; // 여전히 hover된 항목 위에 있음
+        }
+      }
+    } // Spatial Index로 후보 항목만 빠르게 추출 (30,000개 → ~10개)
+
+
+    var candidates = spatialIndexRef.current.queryPoint(offset.x, offset.y); // 데이터 타입에 따라 적절한 히트 테스트 수행
+
+    if (dataType === CanvasDataType.MARKER) {
+      // 마커 체크
+      for (var i = candidates.length - 1; i >= 0; i--) {
+        var item = candidates[i];
+
+        if (isPointInMarkerData(offset, item, getOrComputeMarkerOffset)) {
+          return item;
+        }
+      }
+    } else {
+      // 폴리곤 체크
+      for (var i = candidates.length - 1; i >= 0; i--) {
+        var item = candidates[i];
+
+        if (isPointInPolygonData(offset, item, getOrComputePolygonOffsets)) {
+          return item;
+        }
+      }
+    }
+
+    return null;
+  };
+  /**
+   * Hover 상태 설정 및 Event 레이어 렌더링
+   *
+   * @param data hover된 마커/폴리곤 데이터 또는 null
+   *
+   * 최적화: RAF 제거하여 즉시 렌더링 (16ms 지연 제거)
+   * topOnHover가 true일 때는 Base 레이어도 다시 그려서 z-order 변경
+   */
+
+
+  var setHovered = function (data) {
+    if (!onMouseOver && !onMouseOut) return;
+    hoveredItemRef.current = data;
+
+    if (draggingRef.current) {
+      controller.setMapCursor('grabbing');
+    } else {
+      controller.setMapCursor(data ? 'pointer' : 'grab');
+    } // 즉시 렌더링 (RAF 없이)
+    // topOnHover는 Event Layer에서만 처리 (Base Layer 재렌더링 제거로 성능 향상)
+
+
+    doRenderEvent();
+  };
+  /**
+   * 클릭 처리 (단일/다중 선택)
+   *
+   * @param data 클릭된 마커/폴리곤 데이터
+   *
+   * 🔥 최적화: 단일 Shape 렌더링으로 Base Layer 재렌더링 속도 향상
+   * - sceneFunc에서 selectedIds를 체크하여 선택된 마커만 스킵
+   * - 객체 생성 오버헤드 제거로 1000개 이상도 부드럽게 처리
+   */
+
+
+  var handleLocalClick = function (data) {
+    if (!onClick) return; // 1. 선택 상태 업데이트
+
+    if (enableMultiSelect) {
+      // 다중 선택: Set과 Map 동시 업데이트
+      var newSelected = new Set(selectedIdsRef.current);
+
+      if (newSelected.has(data.id)) {
+        newSelected.delete(data.id);
+        selectedItemsMapRef.current.delete(data.id);
+      } else {
+        newSelected.add(data.id);
+        selectedItemsMapRef.current.set(data.id, data);
+      }
+
+      selectedIdsRef.current = newSelected;
+    } else {
+      // 단일 선택: 토글
+      var newSelected = new Set();
+
+      if (!selectedIdsRef.current.has(data.id)) {
+        newSelected.add(data.id);
+        selectedItemsMapRef.current.clear();
+        selectedItemsMapRef.current.set(data.id, data);
+      } else {
+        selectedItemsMapRef.current.clear();
+      }
+
+      selectedIdsRef.current = newSelected;
+    }
+
+    if (!!renderAnimation) {
+      // 2. Base Layer 재렌더링 (단일 Shape로 최적화되어 빠름)
+      doRenderBase(); // 3. Animation Layer 렌더링 (선택된 마커 애니메이션)
+
+      doRenderAnimation();
+    } // 4. Event Layer 렌더링 (hover 처리)
+
+
+    doRenderEvent();
+  }; // --------------------------------------------------------------------------
+  // 이벤트 핸들러: UI 이벤트
+  // --------------------------------------------------------------------------
+
+  /**
+   * 클릭 이벤트 처리
+   */
+
+
+  var handleClick = function (event) {
+    var _a;
+
+    if (disableInteractionRef.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 {
+      var clickedOffset = controller.positionToOffset(event.param.position);
+      var data = findData(clickedOffset);
+
+      if (data) {
+        handleLocalClick(data);
+        onClick(data, selectedIdsRef.current);
+      }
+    } catch (error) {
+      console.error('[WoongKonvaMarker] handleClick error:', error);
+    }
+  };
+  /**
+   * 마우스 이동 이벤트 처리 (hover 감지)
+   */
+
+
+  var handleMouseMove = function (event) {
+    var _a;
+
+    if (disableInteractionRef.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 {
+      var mouseOffset = controller.positionToOffset(event.param.position);
+      var hoveredItem = findData(mouseOffset);
+      var prevHovered = hoveredItemRef.current;
+
+      if (prevHovered !== hoveredItem) {
+        setHovered(hoveredItem);
+        if (prevHovered && onMouseOut) onMouseOut(prevHovered);
+        if (hoveredItem && onMouseOver) onMouseOver(hoveredItem);
+      }
+    } catch (error) {
+      console.error('[WoongKonvaMarker] handleMouseMove error:', error);
+    }
+  };
+  /**
+   * 드래그 시작 처리 (커서를 grabbing으로 변경)
+   */
+
+
+  var handleDragStart = function () {
+    draggingRef.current = true;
+    controller.setMapCursor('grabbing');
+  };
+  /**
+   * 드래그 종료 처리 (커서를 기본으로 복원)
+   */
+
+
+  var handleDragEnd = function () {
+    draggingRef.current = false;
+    controller.setMapCursor('grab');
+  };
+  /**
+   * 마우스가 canvas를 벗어날 때 hover cleanup
+   */
+
+
+  var handleMouseLeave = function () {
+    if (disableInteractionRef.current) return; // 🚫 상호작용 비활성화 시 즉시 반환
+
+    if (!onMouseOver && !onMouseOut) return;
+    var prevHovered = hoveredItemRef.current;
+
+    if (prevHovered) {
+      hoveredItemRef.current = null;
+      controller.setMapCursor('grab');
+      doRenderEvent();
+
+      if (onMouseOut) {
+        onMouseOut(prevHovered);
+      }
+    }
+  }; // --------------------------------------------------------------------------
+  // Lifecycle: DOM 초기화
+  // --------------------------------------------------------------------------
+
+
+  useEffect(function () {
+    divElement.style.width = 'fit-content';
+    return function () {
+      if (markerRef.current) {
+        controller.clearDrawable(markerRef.current);
+        markerRef.current = undefined;
+      }
+    };
+  }, []); // --------------------------------------------------------------------------
+  // Lifecycle: 마커 생성/업데이트
+  // --------------------------------------------------------------------------
+
+  useEffect(function () {
+    if (options) {
+      var bounds = controller.getCurrBounds();
+
+      var markerOptions = __assign({
+        position: bounds.nw
+      }, options);
+
+      if (markerRef.current) {
+        controller.updateMarker(markerRef.current, markerOptions);
+      } else {
+        markerRef.current = new Marker(markerOptions);
+        markerRef.current.element = divElement;
+        controller.createMarker(markerRef.current);
+
+        if (divElement.parentElement) {
+          divElement.parentElement.style.pointerEvents = 'none';
+        }
+
+        if (options.zIndex !== undefined) {
+          controller.setMarkerZIndex(markerRef.current, options.zIndex);
+        }
+      }
+    }
+  }, [options]); // --------------------------------------------------------------------------
+  // Lifecycle: Konva 초기화 및 이벤트 리스너 등록
+  // --------------------------------------------------------------------------
+
+  useEffect(function () {
+    var mapDiv = controller.mapDivElement;
+    var stage = new Konva.Stage({
+      container: containerRef.current,
+      width: mapDiv.offsetWidth,
+      height: mapDiv.offsetHeight
+    });
+    stageRef.current = stage; // 레이어 최적화 설정
+
+    var baseLayer = new Konva.Layer({
+      listening: false // 이벤트 리스닝 비활성화로 성능 향상
+
+    });
+    var animationLayer = new Konva.Layer({
+      listening: false
+    });
+    var eventLayer = new Konva.Layer({
+      listening: false
+    });
+    baseLayerRef.current = baseLayer;
+    animationLayerRef.current = animationLayer;
+    eventLayerRef.current = eventLayer;
+    stage.add(baseLayer);
+
+    if (renderAnimation) {
+      stage.add(animationLayer);
+    }
+
+    stage.add(eventLayer); // 초기 뷰포트 설정
+
+    updateViewport(); // ResizeObserver (맵 크기 변경 감지)
+
+    var resizeRafId = null;
+    var resizeObserver = new ResizeObserver(function () {
+      // RAF로 다음 프레임에 한 번만 실행 (debounce 효과)
+      if (resizeRafId !== null) {
+        cancelAnimationFrame(resizeRafId);
+      }
+
+      resizeRafId = requestAnimationFrame(function () {
+        stage.width(mapDiv.offsetWidth);
+        stage.height(mapDiv.offsetHeight);
+        offsetCacheRef.current.clear();
+        boundingBoxCacheRef.current.clear();
+        updateViewport();
+        renderAllImmediate();
+        resizeRafId = null;
+      });
+    });
+    resizeObserver.observe(mapDiv);
+    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 이벤트 추가
+
+    mapDiv.addEventListener('mouseleave', handleMouseLeave);
+    renderAllImmediate(); // Context 사용 시 컴포넌트 등록 (다중 인스턴스 관리)
+
+    var componentInstance = null;
+
+    if (context) {
+      componentInstance = {
+        zIndex: currentZIndex,
+        hitTest: function (offset) {
+          return findData(offset) !== null;
+        },
+        onClick: onClick,
+        onMouseOver: onMouseOver,
+        onMouseOut: onMouseOut,
+        findData: findData,
+        setHovered: setHovered,
+        handleLocalClick: handleLocalClick,
+        getSelectedIds: function () {
+          return selectedIdsRef.current;
+        },
+        isInteractionDisabled: function () {
+          return disableInteractionRef.current;
+        } // 🚫 상호작용 비활성화 여부 반환
+
+      };
+      context.registerComponent(componentInstance);
+    } // Cleanup 함수
+
+
+    return function () {
+      // RAF 정리
+      if (resizeRafId !== null) {
+        cancelAnimationFrame(resizeRafId);
+      } // 옵저버 정리
+
+
+      resizeObserver.disconnect(); // 이벤트 리스너 정리
+
+      controller.removeEventListener('IDLE', handleIdle);
+      controller.removeEventListener('ZOOMSTART', handleZoomStart);
+      controller.removeEventListener('ZOOM_CHANGED', handleZoomEnd);
+      controller.removeEventListener('CENTER_CHANGED', handleCenterChanged);
+      controller.removeEventListener('CLICK', handleClick);
+      controller.removeEventListener('MOUSEMOVE', handleMouseMove);
+      controller.removeEventListener('DRAGSTART', handleDragStart);
+      controller.removeEventListener('DRAGEND', handleDragEnd);
+      mapDiv.removeEventListener('mouseleave', handleMouseLeave); // Context 정리
+
+      if (context && componentInstance) {
+        context.unregisterComponent(componentInstance);
+      } // Konva 리소스 정리
+
+
+      baseLayer.destroyChildren();
+      animationLayer.destroyChildren();
+      eventLayer.destroyChildren();
+      stage.destroy(); // 캐시 정리
+
+      offsetCacheRef.current.clear();
+      boundingBoxCacheRef.current.clear();
+      spatialIndexRef.current.clear();
+    };
+  }, []); // 초기화는 한 번만
+  // --------------------------------------------------------------------------
+  // Lifecycle: disableInteraction 동기화
+  // --------------------------------------------------------------------------
+
+  useEffect(function () {
+    disableInteractionRef.current = disableInteraction;
+  }, [disableInteraction]); // --------------------------------------------------------------------------
+  // Lifecycle: 외부 selectedItems 동기화
+  // --------------------------------------------------------------------------
+
+  useEffect(function () {
+    if (!stageRef.current) return; // externalSelectedItems가 undefined면 외부 제어 안 함
+
+    if (externalSelectedItems === undefined) return; // 외부에서 전달된 selectedItems로 동기화
+
+    var newSelectedIds = new Set();
+    var newSelectedItemsMap = new Map();
+    externalSelectedItems.forEach(function (item) {
+      newSelectedIds.add(item.id);
+      newSelectedItemsMap.set(item.id, item);
+    });
+    selectedIdsRef.current = newSelectedIds;
+    selectedItemsMapRef.current = newSelectedItemsMap; // 렌더링
+
+    doRenderBase();
+    doRenderAnimation();
+    doRenderEvent();
+  }, [externalSelectedItems]); // 배열 자체를 dependency로 사용
+  // --------------------------------------------------------------------------
+  // Lifecycle: 외부 selectedItem 변경 시 Event Layer 리렌더링
+  // --------------------------------------------------------------------------
+
+  useEffect(function () {
+    if (!stageRef.current) return; // Ref 동기화
+
+    selectedItemRef.current = externalSelectedItem; // selectedItem이 변경되면 Event Layer만 다시 그림
+
+    doRenderEvent();
+  }, [externalSelectedItem]); // --------------------------------------------------------------------------
+  // Lifecycle: 마커 데이터 변경 시 렌더링
+  // --------------------------------------------------------------------------
+
+  useEffect(function () {
+    if (!stageRef.current) return; // markersRef 동기화
+
+    markersRef.current = markers; // 데이터 변경 시 즉시 transform 제거 및 캐시 정리 (겹침 방지)
+
+    if (containerRef.current) {
+      containerRef.current.style.transform = '';
+    }
+
+    prevCenterOffsetRef.current = null;
+    accumTranslateRef.current = {
+      x: 0,
+      y: 0
+    }; // 캐시 정리 (새 데이터이므로 기존 캐시는 무효)
+
+    offsetCacheRef.current.clear();
+    boundingBoxCacheRef.current.clear();
+    /**
+     * 선택 상태 동기화 (최적화 버전)
+     *
+     * markers가 변경되면 selectedItemsMapRef도 업데이트 필요
+     * (참조가 바뀌므로 기존 Map의 데이터는 stale 상태)
+     *
+     * 🔥 중요: 화면 밖 마커도 선택 상태 유지!
+     * - 현재 markers에 있으면 최신 데이터로 업데이트
+     * - 없으면 기존 selectedItemsMapRef의 데이터 유지
+     *
+     * 최적화: markers를 Map으로 먼저 변환하여 find() 순회 제거
+     * - O(전체 마커 수 + 선택된 개수) - 매우 효율적
+     */
+
+    var markersMap = new Map(markers.map(function (m) {
+      return [m.id, m];
+    }));
+    var newSelectedItemsMap = new Map();
+    selectedIdsRef.current.forEach(function (id) {
+      // 현재 markers에 있으면 최신 데이터 사용
+      var currentItem = markersMap.get(id);
+
+      if (currentItem) {
+        newSelectedItemsMap.set(id, currentItem);
+      } else {
+        // 화면 밖이면 기존 데이터 유지
+        var prevItem = selectedItemsMapRef.current.get(id);
+
+        if (prevItem) {
+          newSelectedItemsMap.set(id, prevItem);
+        }
+      }
+    }); // selectedIdsRef는 그대로 유지 (화면 밖 마커도 선택 상태 유지)
+
+    selectedItemsMapRef.current = newSelectedItemsMap; // 즉시 렌더링
+
+    renderAllImmediate();
+  }, [markers]);
+  return createPortal(React.createElement("div", {
+    ref: containerRef,
+    style: __assign({
+      position: 'absolute',
+      width: '100%',
+      height: '100%'
+    }, disableInteraction && {
+      pointerEvents: 'none'
+    })
+  }), divElement);
+};
+/**
+ * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
+ *
+ * 비교 전략:
+ * 1. markers 배열 비교
+ * 2. selectedItems 배열 비교 (외부 제어)
+ *
+ * 주의: JSON.stringify() 사용 금지! (매우 느림)
+ */
+
+
+var WoongKonvaMarker = React.memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
+  // 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.onClick !== nextProps.onClick) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  if (prevProps.onMouseOver !== nextProps.onMouseOver) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  if (prevProps.onMouseOut !== nextProps.onMouseOut) {
+    return false; // 변경됨 → 리렌더링
+  }
+
+  if (prevProps.disableInteraction !== nextProps.disableInteraction) {
+    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}";
 var styles = {"mint-map-control-wrapper-container":"MintMapWrapper-module_mint-map-control-wrapper-container__DONh7","mint-map-overlay-wrapper":"MintMapWrapper-module_mint-map-overlay-wrapper__Jn4wV"};
 styleInject(css_248z);
@@ -7637,4 +9242,4 @@ function MintMap(_a) {
   }), loading));
 }
 
-export { AnimationPlayer, Bounds, CanvasMarker, CanvasMarkerClaude, CanvasMarkerHanquf, CircleMarker, Drawable, GeoCalulator, GoogleMintMapController, MapBuildingProjection, MapCanvasMarkerWrapper, MapCanvasWrapper, MapControlWrapper, MapEvent, MapLoadingWithImage, MapMarkerWrapper, MapPolygonWrapper, MapPolylineWrapper, MapUIEvent, Marker, MintMap, MintMapCanvasRenderer, MintMapController, MintMapCore, MintMapProvider, NaverMintMapController, Offset, PointLoading, Polygon, PolygonCalculator, PolygonMarker, Polyline, Position, SVGCircle, SVGPolygon, SVGRect, Spacing, Status, getClusterInfo, getMapOfType, log, useMarkerMoving, useMintMapController, waiting };
+export { AnimationPlayer, Bounds, CanvasDataType, CanvasMarker, CanvasMarkerClaude, CanvasMarkerHanquf, CircleMarker, DEFAULT_CULLING_MARGIN, DEFAULT_MAX_CACHE_SIZE, Drawable, GeoCalulator, GoogleMintMapController, KonvaMarkerProvider, LRUCache, MapBuildingProjection, MapCanvasMarkerWrapper, MapCanvasWrapper, MapControlWrapper, MapEvent, MapLoadingWithImage, MapMarkerWrapper, MapPolygonWrapper, MapPolylineWrapper, MapUIEvent, Marker, MintMap, MintMapCanvasRenderer, MintMapController, MintMapCore, MintMapProvider, NaverMintMapController, Offset, PointLoading, Polygon, PolygonCalculator, PolygonMarker, Polyline, Position, SPATIAL_GRID_CELL_SIZE, SVGCircle, SVGPolygon, SVGRect, Spacing, SpatialHashGrid, Status, WoongKonvaMarker, computeMarkerOffset, computePolygonOffsets, getClusterInfo, getMapOfType, isPointInMarkerData, isPointInPolygon, isPointInPolygonData, log, useKonvaMarkerContext, useMarkerMoving, useMintMapController, waiting };