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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +7 -7
  2. package/dist/components/mint-map/core/MintMapController.d.ts +1 -0
  3. package/dist/components/mint-map/core/MintMapCore.js +2 -2
  4. package/dist/components/mint-map/core/advanced/index.d.ts +1 -4
  5. package/dist/components/mint-map/core/advanced/woongCanvas/WoongCanvasLayer.d.ts +227 -0
  6. package/dist/components/mint-map/core/advanced/woongCanvas/{WoongKonvaMarker.js → WoongCanvasLayer.js} +338 -237
  7. package/dist/components/mint-map/core/advanced/woongCanvas/index.d.ts +12 -1
  8. package/dist/components/mint-map/core/advanced/woongCanvas/shared/context.d.ts +81 -12
  9. package/dist/components/mint-map/core/advanced/woongCanvas/shared/context.js +85 -14
  10. package/dist/components/mint-map/core/advanced/woongCanvas/shared/index.d.ts +11 -0
  11. package/dist/components/mint-map/core/advanced/woongCanvas/shared/performance.d.ts +62 -13
  12. package/dist/components/mint-map/core/advanced/woongCanvas/shared/performance.js +62 -13
  13. package/dist/components/mint-map/core/advanced/woongCanvas/shared/renderer.d.ts +115 -0
  14. package/dist/components/mint-map/core/advanced/woongCanvas/shared/renderer.js +288 -0
  15. package/dist/components/mint-map/core/advanced/woongCanvas/shared/types.d.ts +138 -16
  16. package/dist/components/mint-map/core/advanced/woongCanvas/shared/types.js +20 -0
  17. package/dist/components/mint-map/core/advanced/woongCanvas/shared/utils.d.ts +162 -10
  18. package/dist/components/mint-map/core/advanced/woongCanvas/shared/utils.js +235 -14
  19. package/dist/components/mint-map/core/wrapper/MapMarkerWrapper.js +22 -1
  20. package/dist/components/mint-map/google/GoogleMintMapController.d.ts +1 -0
  21. package/dist/components/mint-map/google/GoogleMintMapController.js +7 -1
  22. package/dist/components/mint-map/kakao/KakaoMintMapController.d.ts +1 -0
  23. package/dist/components/mint-map/kakao/KakaoMintMapController.js +7 -1
  24. package/dist/components/mint-map/naver/NaverMintMapController.d.ts +3 -0
  25. package/dist/components/mint-map/naver/NaverMintMapController.js +40 -4
  26. package/dist/index.es.js +1078 -283
  27. package/dist/index.js +35 -15
  28. package/dist/index.umd.js +1091 -283
  29. package/package.json +1 -1
  30. package/.claude/settings.local.json +0 -16
  31. package/dist/components/mint-map/core/advanced/woongCanvas/ClusterMarker.d.ts +0 -11
  32. package/dist/components/mint-map/core/advanced/woongCanvas/WoongKonvaMarker.d.ts +0 -48
@@ -10,9 +10,11 @@ var MapDrawables = require('../../../types/MapDrawables.js');
10
10
  require('../../../types/MapTypes.js');
11
11
  require('../../../types/MapEventTypes.js');
12
12
  var reactDom = require('react-dom');
13
+ var types = require('./shared/types.js');
13
14
  var utils = require('./shared/utils.js');
14
15
  var context = require('./shared/context.js');
15
16
  var performance = require('./shared/performance.js');
17
+ var renderer = require('./shared/renderer.js');
16
18
 
17
19
  function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
18
20
 
@@ -22,38 +24,27 @@ var Konva__default = /*#__PURE__*/_interopDefaultLegacy(Konva);
22
24
  // 메인 컴포넌트
23
25
  // ============================================================================
24
26
 
25
- /**
26
- * Konva 기반 고성능 마커/폴리곤 렌더링 컴포넌트
27
- *
28
- * 특징:
29
- * - Base/Event 레이어 분리로 성능 최적화
30
- * - LRU 캐시로 좌표 변환 결과 캐싱
31
- * - Spatial Hash Grid로 빠른 Hit Test
32
- * - Viewport Culling으로 보이는 영역만 렌더링
33
- *
34
- * @template T 마커 데이터의 추가 속성 타입
35
- */
36
-
37
- var WoongKonvaMarkerComponent = function (_a) {
38
- var markers = _a.markers,
39
- onClick = _a.onClick,
40
- onMouseOver = _a.onMouseOver,
41
- onMouseOut = _a.onMouseOut,
42
- renderBase = _a.renderBase,
43
- renderAnimation = _a.renderAnimation,
44
- renderEvent = _a.renderEvent,
45
- _b = _a.enableMultiSelect,
46
- enableMultiSelect = _b === void 0 ? false : _b,
47
- _c = _a.topOnHover,
48
- topOnHover = _c === void 0 ? false : _c,
49
- _d = _a.enableViewportCulling,
50
- enableViewportCulling = _d === void 0 ? true : _d,
51
- _e = _a.cullingMargin,
52
- cullingMargin = _e === void 0 ? performance.DEFAULT_CULLING_MARGIN : _e,
53
- _f = _a.maxCacheSize,
54
- maxCacheSize = _f === void 0 ? performance.DEFAULT_MAX_CACHE_SIZE : _f,
55
- externalSelectedItems = _a.selectedItems,
56
- options = tslib.__rest(_a, ["markers", "onClick", "onMouseOver", "onMouseOut", "renderBase", "renderAnimation", "renderEvent", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems"]); // --------------------------------------------------------------------------
27
+ var WoongCanvasLayer = function (props) {
28
+ var data = props.data,
29
+ dataType = props.dataType,
30
+ onClick = props.onClick,
31
+ onMouseOver = props.onMouseOver,
32
+ onMouseOut = props.onMouseOut,
33
+ _a = props.enableMultiSelect,
34
+ enableMultiSelect = _a === void 0 ? false : _a,
35
+ _b = props.topOnHover,
36
+ topOnHover = _b === void 0 ? false : _b,
37
+ _c = props.enableViewportCulling,
38
+ enableViewportCulling = _c === void 0 ? true : _c,
39
+ _d = props.cullingMargin,
40
+ cullingMargin = _d === void 0 ? performance.DEFAULT_CULLING_MARGIN : _d,
41
+ _e = props.maxCacheSize,
42
+ maxCacheSize = _e === void 0 ? performance.DEFAULT_MAX_CACHE_SIZE : _e,
43
+ externalSelectedItems = props.selectedItems,
44
+ externalSelectedItem = props.selectedItem,
45
+ _f = props.disableInteraction,
46
+ disableInteraction = _f === void 0 ? false : _f,
47
+ options = tslib.__rest(props, ["data", "dataType", "onClick", "onMouseOver", "onMouseOut", "enableMultiSelect", "topOnHover", "enableViewportCulling", "cullingMargin", "maxCacheSize", "selectedItems", "selectedItem", "disableInteraction"]); // --------------------------------------------------------------------------
57
48
  // Hooks & Context
58
49
  // --------------------------------------------------------------------------
59
50
 
@@ -68,25 +59,31 @@ var WoongKonvaMarkerComponent = function (_a) {
68
59
  var divElement = divRef.current;
69
60
  var containerRef = React.useRef(null);
70
61
  var markerRef = React.useRef(); // --------------------------------------------------------------------------
71
- // Konva Refs
62
+ // Konva Refs - Multi-Layer 아키텍처
72
63
  // --------------------------------------------------------------------------
73
64
 
74
65
  var stageRef = React.useRef(null);
75
66
  var baseLayerRef = React.useRef(null);
76
67
  var animationLayerRef = React.useRef(null);
77
68
  var eventLayerRef = React.useRef(null); // --------------------------------------------------------------------------
78
- // Data Refs - 선택Hover 상태 관리
69
+ // Data Refs - 데이터 동기화 및 상태 관리
79
70
  // --------------------------------------------------------------------------
80
71
 
81
- /** markers prop을 ref로 추적 (stale closure 방지, useEffect에서 동기화) */
72
+ /** data prop을 ref로 추적 (stale closure 방지, useEffect에서 동기화) */
82
73
 
83
- var markersRef = React.useRef(markers); // --------------------------------------------------------------------------
84
- // State Refs - 선택 및 Hover 상태 관리
74
+ var dataRef = React.useRef(data); // --------------------------------------------------------------------------
75
+ // State Refs - 선택 및 Hover 상태 관리 (성능 최적화)
85
76
  // --------------------------------------------------------------------------
86
77
 
78
+ /** 상호작용 비활성화 상태 (Ref로 관리하여 클로저 문제 해결) */
79
+
80
+ var disableInteractionRef = React.useRef(disableInteraction);
87
81
  /** 현재 Hover 중인 항목 */
88
82
 
89
83
  var hoveredItemRef = React.useRef(null);
84
+ /** 외부에서 전달된 선택 항목 (Ref로 관리하여 클로저 문제 해결) */
85
+
86
+ var selectedItemRef = React.useRef(externalSelectedItem);
90
87
  /**
91
88
  * 선택된 항목의 ID Set
92
89
  *
@@ -116,7 +113,7 @@ var WoongKonvaMarkerComponent = function (_a) {
116
113
  */
117
114
 
118
115
  var selectedItemsMapRef = React.useRef(new Map()); // --------------------------------------------------------------------------
119
- // Drag Refs
116
+ // Drag Refs - 지도 드래그 상태 관리
120
117
  // --------------------------------------------------------------------------
121
118
 
122
119
  var draggingRef = React.useRef(false);
@@ -125,7 +122,7 @@ var WoongKonvaMarkerComponent = function (_a) {
125
122
  x: 0,
126
123
  y: 0
127
124
  }); // --------------------------------------------------------------------------
128
- // Performance Refs (캐싱 & 최적화)
125
+ // Performance Refs - 성능 최적화 (캐싱 & 인덱싱)
129
126
  // --------------------------------------------------------------------------
130
127
 
131
128
  /** 좌표 변환 결과 LRU 캐시 */
@@ -140,7 +137,7 @@ var WoongKonvaMarkerComponent = function (_a) {
140
137
  /** 뷰포트 경계 캐시 (Viewport Culling) */
141
138
 
142
139
  var viewportRef = React.useRef(null); // --------------------------------------------------------------------------
143
- // 유틸리티 함수: 뷰포트 관리
140
+ // 유틸리티 함수: 뷰포트 관리 (Viewport Culling)
144
141
  // --------------------------------------------------------------------------
145
142
 
146
143
  /**
@@ -169,55 +166,11 @@ var WoongKonvaMarkerComponent = function (_a) {
169
166
  var bbox = boundingBoxCacheRef.current.get(item.id);
170
167
 
171
168
  if (!bbox) {
172
- // 폴리곤인 경우
173
- if (item.paths) {
174
- var offsets = getOrComputePolygonOffsets(item);
175
- if (!offsets) return false; // 바운딩 박스 계산 (최적화: 직접 비교)
176
-
177
- var minX = Infinity,
178
- minY = Infinity,
179
- maxX = -Infinity,
180
- maxY = -Infinity;
181
-
182
- for (var _i = 0, offsets_1 = offsets; _i < offsets_1.length; _i++) {
183
- var multiPolygon = offsets_1[_i];
184
-
185
- for (var _a = 0, multiPolygon_1 = multiPolygon; _a < multiPolygon_1.length; _a++) {
186
- var polygonGroup = multiPolygon_1[_a];
187
-
188
- for (var _b = 0, polygonGroup_1 = polygonGroup; _b < polygonGroup_1.length; _b++) {
189
- var _c = polygonGroup_1[_b],
190
- x = _c[0],
191
- y = _c[1];
192
- if (x < minX) minX = x;
193
- if (y < minY) minY = y;
194
- if (x > maxX) maxX = x;
195
- if (y > maxY) maxY = y;
196
- }
197
- }
198
- }
199
-
200
- bbox = {
201
- minX: minX,
202
- minY: minY,
203
- maxX: maxX,
204
- maxY: maxY
205
- };
206
- boundingBoxCacheRef.current.set(item.id, bbox);
207
- } // 마커인 경우
208
- else {
209
- var offset = getOrComputeMarkerOffset(item);
210
- if (!offset) return false;
211
- var boxWidth = item.boxWidth || 50;
212
- var boxHeight = item.boxHeight || 28;
213
- bbox = {
214
- minX: offset.x - boxWidth / 2,
215
- minY: offset.y - boxHeight - 6,
216
- maxX: offset.x + boxWidth / 2,
217
- maxY: offset.y
218
- };
219
- boundingBoxCacheRef.current.set(item.id, bbox);
220
- }
169
+ // 바운딩 박스 계산 (공통 함수 사용)
170
+ var computed = computeBoundingBox(item);
171
+ if (!computed) return false;
172
+ bbox = computed;
173
+ boundingBoxCacheRef.current.set(item.id, bbox);
221
174
  } // 바운딩 박스와 viewport 교차 체크
222
175
 
223
176
 
@@ -246,6 +199,7 @@ var WoongKonvaMarkerComponent = function (_a) {
246
199
  };
247
200
  /**
248
201
  * 마커 좌표 변환 결과를 캐시하고 반환
202
+ *
249
203
  * @param markerData 마커 데이터
250
204
  * @returns 변환된 좌표 또는 null
251
205
  */
@@ -262,6 +216,71 @@ var WoongKonvaMarkerComponent = function (_a) {
262
216
 
263
217
  return result;
264
218
  }; // --------------------------------------------------------------------------
219
+ // 유틸리티 함수: 바운딩 박스 계산 (Viewport Culling 최적화)
220
+ // --------------------------------------------------------------------------
221
+
222
+ /**
223
+ * 아이템의 바운딩 박스 계산 (폴리곤/마커 공통)
224
+ *
225
+ * 🎯 마커의 경우:
226
+ * - boxHeight: 본체만 (Hit Test 영역)
227
+ * - tailHeight: 꼬리 높이 (Viewport Culling용, 화면에 보이는 전체 영역)
228
+ *
229
+ * @param item 마커 또는 폴리곤 데이터
230
+ * @returns 바운딩 박스 또는 null
231
+ */
232
+
233
+
234
+ var computeBoundingBox = function (item) {
235
+ if (dataType === types.CanvasDataType.POLYGON) {
236
+ // 폴리곤: 모든 좌표의 최소/최대값 계산
237
+ var offsets = getOrComputePolygonOffsets(item);
238
+ if (!offsets) return null;
239
+ var minX = Infinity,
240
+ minY = Infinity,
241
+ maxX = -Infinity,
242
+ maxY = -Infinity;
243
+
244
+ for (var _i = 0, offsets_1 = offsets; _i < offsets_1.length; _i++) {
245
+ var multiPolygon = offsets_1[_i];
246
+
247
+ for (var _a = 0, multiPolygon_1 = multiPolygon; _a < multiPolygon_1.length; _a++) {
248
+ var polygonGroup = multiPolygon_1[_a];
249
+
250
+ for (var _b = 0, polygonGroup_1 = polygonGroup; _b < polygonGroup_1.length; _b++) {
251
+ var _c = polygonGroup_1[_b],
252
+ x = _c[0],
253
+ y = _c[1];
254
+ if (x < minX) minX = x;
255
+ if (y < minY) minY = y;
256
+ if (x > maxX) maxX = x;
257
+ if (y > maxY) maxY = y;
258
+ }
259
+ }
260
+ }
261
+
262
+ return {
263
+ minX: minX,
264
+ minY: minY,
265
+ maxX: maxX,
266
+ maxY: maxY
267
+ };
268
+ } else {
269
+ // 마커: 중심점 기준 박스 크기 계산 (꼬리 포함)
270
+ var offset = getOrComputeMarkerOffset(item);
271
+ if (!offset) return null;
272
+ var boxWidth = item.boxWidth || 50;
273
+ var boxHeight = item.boxHeight || 28;
274
+ var tailHeight = item.tailHeight || 0; // 🎯 tailHeight 사용 (Viewport Culling용)
275
+
276
+ return {
277
+ minX: offset.x - boxWidth / 2,
278
+ minY: offset.y - boxHeight - tailHeight,
279
+ maxX: offset.x + boxWidth / 2,
280
+ maxY: offset.y
281
+ };
282
+ }
283
+ }; // --------------------------------------------------------------------------
265
284
  // 유틸리티 함수: 공간 인덱싱
266
285
  // --------------------------------------------------------------------------
267
286
 
@@ -273,59 +292,19 @@ var WoongKonvaMarkerComponent = function (_a) {
273
292
  var buildSpatialIndex = function () {
274
293
  var spatial = spatialIndexRef.current;
275
294
  spatial.clear();
276
- var currentMarkers = markersRef.current;
277
-
278
- for (var _i = 0, currentMarkers_1 = currentMarkers; _i < currentMarkers_1.length; _i++) {
279
- var item = currentMarkers_1[_i];
280
-
281
- if (item.paths) {
282
- // 폴리곤: 바운딩 박스 계산 (최적화: 직접 비교)
283
- var offsets = getOrComputePolygonOffsets(item);
284
-
285
- if (offsets) {
286
- var minX = Infinity,
287
- minY = Infinity,
288
- maxX = -Infinity,
289
- maxY = -Infinity;
290
-
291
- for (var _a = 0, offsets_2 = offsets; _a < offsets_2.length; _a++) {
292
- var multiPolygon = offsets_2[_a];
293
-
294
- for (var _b = 0, multiPolygon_2 = multiPolygon; _b < multiPolygon_2.length; _b++) {
295
- var polygonGroup = multiPolygon_2[_b];
296
-
297
- for (var _c = 0, polygonGroup_2 = polygonGroup; _c < polygonGroup_2.length; _c++) {
298
- var _d = polygonGroup_2[_c],
299
- x = _d[0],
300
- y = _d[1];
301
- if (x < minX) minX = x;
302
- if (y < minY) minY = y;
303
- if (x > maxX) maxX = x;
304
- if (y > maxY) maxY = y;
305
- }
306
- }
307
- }
295
+ var currentData = dataRef.current;
308
296
 
309
- spatial.insert(item, minX, minY, maxX, maxY);
310
- }
311
- } else {
312
- // 마커: 기반 바운딩 박스
313
- var offset = getOrComputeMarkerOffset(item);
314
-
315
- if (offset) {
316
- var boxWidth = item.boxWidth || 50;
317
- var boxHeight = item.boxHeight || 28;
318
- var tailHeight = 6;
319
- var minX = offset.x - boxWidth / 2;
320
- var minY = offset.y - boxHeight - tailHeight;
321
- var maxX = offset.x + boxWidth / 2;
322
- var maxY = offset.y;
323
- spatial.insert(item, minX, minY, maxX, maxY);
324
- }
297
+ for (var _i = 0, currentData_1 = currentData; _i < currentData_1.length; _i++) {
298
+ var item = currentData_1[_i]; // 바운딩 박스 계산 (공통 함수 사용)
299
+
300
+ var bbox = computeBoundingBox(item);
301
+
302
+ if (bbox) {
303
+ spatial.insert(item, bbox.minX, bbox.minY, bbox.maxX, bbox.maxY);
325
304
  }
326
305
  }
327
306
  }; // --------------------------------------------------------------------------
328
- // 렌더링 함수
307
+ // 렌더링 함수 결정 (dataType에 따라)
329
308
  // --------------------------------------------------------------------------
330
309
 
331
310
  /**
@@ -340,13 +319,32 @@ var WoongKonvaMarkerComponent = function (_a) {
340
319
  /** Base Layer에서 사용할 빈 Set (재사용) */
341
320
 
342
321
  React.useRef(new Set());
322
+ /**
323
+ * 실제 사용할 렌더링 함수 결정
324
+ * - MARKER: 외부에서 전달받은 renderBase 사용 (필수)
325
+ * - POLYGON: renderer.ts의 팩토리 함수로 생성 (props 기반)
326
+ */
327
+
328
+ var renderBase = dataType === types.CanvasDataType.MARKER ? props.renderBase : renderer.renderPolygonBase(props.baseFillColor, props.baseStrokeColor, props.baseLineWidth);
329
+ var renderAnimation = dataType === types.CanvasDataType.MARKER ? props.renderAnimation : undefined;
330
+ var renderEvent = dataType === types.CanvasDataType.MARKER ? props.renderEvent : function () {
331
+ var polygonProps = props;
332
+ return renderer.renderPolygonEvent(polygonProps.baseFillColor, polygonProps.baseStrokeColor, polygonProps.baseLineWidth, polygonProps.selectedFillColor, polygonProps.selectedStrokeColor, polygonProps.selectedLineWidth, polygonProps.activeFillColor, polygonProps.activeStrokeColor, polygonProps.activeLineWidth, polygonProps.hoveredFillColor, polygonProps.hoveredStrokeColor, polygonProps.hoveredLineWidth);
333
+ }(); // --------------------------------------------------------------------------
334
+ // 렌더링 함수: Base Layer (기본 상태 렌더링)
335
+ // --------------------------------------------------------------------------
336
+
343
337
  /**
344
338
  * Base 레이어 렌더링 (뷰포트 컬링 적용, 선택된 마커 제외)
345
339
  *
346
- * 🔥 최적화:
340
+ * 🔥 성능 최적화:
347
341
  * 1. Shape 재사용으로 객체 생성/파괴 오버헤드 제거
348
342
  * 2. sceneFunc 한 번만 설정 (함수 재생성 제거)
349
343
  * 3. 클로저로 최신 데이터 참조
344
+ *
345
+ * 🎯 topOnHover 지원:
346
+ * - renderEvent가 없을 때 Base Layer에서 hover 처리 (fallback)
347
+ * - renderEvent가 있으면 Event Layer에서 처리 (성능 최적화)
350
348
  */
351
349
 
352
350
  var doRenderBase = function () {
@@ -361,17 +359,40 @@ var WoongKonvaMarkerComponent = function (_a) {
361
359
  shape = new Konva__default["default"].Shape({
362
360
  name: 'base-render-shape',
363
361
  sceneFunc: function (context, shape) {
364
- var ctx = context; // 클로저로 최신 ref 값 참조
362
+ var ctx = context;
363
+ var hovered = hoveredItemRef.current; // 클로저로 최신 ref 값 참조
365
364
 
366
- var visibleMarkers = enableViewportCulling ? markersRef.current.filter(function (item) {
365
+ var visibleItems = enableViewportCulling ? dataRef.current.filter(function (item) {
367
366
  return isInViewport(item);
368
- }) : markersRef.current;
367
+ }) : dataRef.current; // topOnHover가 true이고 renderEvent가 없으면 Base Layer에서 hover 처리
368
+
369
+ if (topOnHover && !renderEvent && hovered) {
370
+ // hover된 항목 제외하고 렌더링
371
+ visibleItems = visibleItems.filter(function (item) {
372
+ return item.id !== hovered.id;
373
+ });
374
+ } // 일반 항목 렌더링
375
+
376
+
369
377
  renderBase({
370
378
  ctx: ctx,
371
- items: visibleMarkers,
379
+ items: visibleItems,
372
380
  selectedIds: selectedIdsRef.current,
373
381
  utils: renderUtils
374
- });
382
+ }); // hover된 항목을 최상단에 렌더링 (renderEvent가 없을 때만)
383
+
384
+ if (topOnHover && !renderEvent && hovered) {
385
+ var isHoveredInViewport = enableViewportCulling ? isInViewport(hovered) : true;
386
+
387
+ if (isHoveredInViewport) {
388
+ renderBase({
389
+ ctx: ctx,
390
+ items: [hovered],
391
+ selectedIds: selectedIdsRef.current,
392
+ utils: renderUtils
393
+ });
394
+ }
395
+ }
375
396
  },
376
397
  perfectDrawEnabled: false,
377
398
  listening: false,
@@ -382,11 +403,14 @@ var WoongKonvaMarkerComponent = function (_a) {
382
403
 
383
404
 
384
405
  layer.batchDraw();
385
- };
406
+ }; // --------------------------------------------------------------------------
407
+ // 렌더링 함수: Animation Layer (선택된 항목 애니메이션)
408
+ // --------------------------------------------------------------------------
409
+
386
410
  /**
387
411
  * Animation 레이어 렌더링 (선택된 마커 애니메이션)
388
412
  *
389
- * 🔥 최적화: sceneFunc 내부에서 최신 items 참조
413
+ * 🔥 성능 최적화: sceneFunc 내부에서 최신 items 참조
390
414
  * - 선택 변경 시에만 재생성
391
415
  * - 지도 이동 시에는 기존 Animation 계속 실행
392
416
  */
@@ -399,23 +423,33 @@ var WoongKonvaMarkerComponent = function (_a) {
399
423
  renderAnimation({
400
424
  layer: layer,
401
425
  selectedIds: selectedIdsRef.current,
402
- items: markersRef.current,
426
+ items: dataRef.current,
403
427
  utils: renderUtils
404
428
  });
405
- };
429
+ }; // --------------------------------------------------------------------------
430
+ // 렌더링 함수: Event Layer (상호작용 상태 렌더링)
431
+ // --------------------------------------------------------------------------
432
+
406
433
  /**
407
434
  * Event 레이어 렌더링 (hover + 선택 상태 표시)
408
435
  *
409
- * 🔥 최적화:
436
+ * 🔥 성능 최적화:
410
437
  * 1. Shape 재사용으로 객체 생성/파괴 오버헤드 제거
411
438
  * 2. sceneFunc 한 번만 설정 (함수 재생성 제거)
412
439
  * 3. 클로저로 최신 데이터 참조
440
+ *
441
+ * 🎯 topOnHover + renderEvent 조합 지원:
442
+ * - topOnHover가 true이고 renderEvent가 있으면:
443
+ * 1. 먼저 hover된 항목을 제외한 나머지 항목들 렌더링
444
+ * 2. 그 다음 hover된 항목을 최상단에 렌더링 (시각적 우선순위)
445
+ * - topOnHover가 false이거나 renderEvent가 없으면 일반 렌더링
413
446
  */
414
447
 
415
448
 
416
449
  var doRenderEvent = function () {
417
450
  var layer = eventLayerRef.current;
418
- if (!layer) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
451
+ if (!layer) return;
452
+ if (!renderEvent) return; // 🔥 Shape 재사용: 이미 존재하면 재사용, 없으면 생성
419
453
 
420
454
  var shape = layer.findOne('.event-render-shape');
421
455
 
@@ -425,15 +459,45 @@ var WoongKonvaMarkerComponent = function (_a) {
425
459
  shape = new Konva__default["default"].Shape({
426
460
  name: 'event-render-shape',
427
461
  sceneFunc: function (context, shape) {
428
- var ctx = context; // 클로저로 최신 ref 값 참조
462
+ var ctx = context; // 클로저로 최신 ref 값 참조 (안전한 처리)
429
463
 
430
464
  var selectedItems = Array.from(selectedItemsMapRef.current.values());
431
- renderEvent({
432
- ctx: ctx,
433
- hoveredItem: hoveredItemRef.current,
434
- utils: renderUtils,
435
- selectedItems: selectedItems
436
- });
465
+ var hovered = hoveredItemRef.current;
466
+ var selectedItem = selectedItemRef.current; // topOnHover가 true이면 hover된 항목을 최상단에 렌더링
467
+
468
+ if (topOnHover && hovered) {
469
+ // 1. 먼저 일반 항목들 렌더링 (hover된 항목 제외)
470
+ renderEvent({
471
+ ctx: ctx,
472
+ hoveredItem: null,
473
+ utils: renderUtils,
474
+ selectedItems: selectedItems.filter(function (item) {
475
+ return item && item.id !== hovered.id;
476
+ }),
477
+ selectedItem: selectedItem
478
+ }); // 2. hover된 항목을 최상단에 렌더링
479
+
480
+ var isHoveredInViewport = enableViewportCulling ? isInViewport(hovered) : true;
481
+
482
+ if (isHoveredInViewport) {
483
+ renderEvent({
484
+ ctx: ctx,
485
+ hoveredItem: hovered,
486
+ utils: renderUtils,
487
+ selectedItems: selectedItems,
488
+ selectedItem: selectedItem
489
+ });
490
+ }
491
+ } else {
492
+ // topOnHover가 false이거나 hover된 항목이 없으면 일반 렌더링
493
+ renderEvent({
494
+ ctx: ctx,
495
+ hoveredItem: hovered,
496
+ utils: renderUtils,
497
+ selectedItems: selectedItems,
498
+ selectedItem: selectedItem
499
+ });
500
+ }
437
501
  },
438
502
  perfectDrawEnabled: false,
439
503
  listening: false,
@@ -544,7 +608,7 @@ var WoongKonvaMarkerComponent = function (_a) {
544
608
  containerRef.current.style.transform = "translate(".concat(accumTranslateRef.current.x, "px, ").concat(accumTranslateRef.current.y, "px)");
545
609
  }
546
610
  }; // --------------------------------------------------------------------------
547
- // Hit Test & 상태 관리
611
+ // Hit Test & 상태 관리 (이벤트 처리)
548
612
  // --------------------------------------------------------------------------
549
613
 
550
614
  /**
@@ -564,7 +628,7 @@ var WoongKonvaMarkerComponent = function (_a) {
564
628
  if (topOnHover && hoveredItemRef.current) {
565
629
  var hovered = hoveredItemRef.current; // 폴리곤인 경우
566
630
 
567
- if (hovered.paths) {
631
+ if (dataType === types.CanvasDataType.POLYGON) {
568
632
  if (utils.isPointInPolygonData(offset, hovered, getOrComputePolygonOffsets)) {
569
633
  return hovered; // 여전히 hover된 항목 위에 있음
570
634
  }
@@ -577,23 +641,22 @@ var WoongKonvaMarkerComponent = function (_a) {
577
641
  } // Spatial Index로 후보 항목만 빠르게 추출 (30,000개 → ~10개)
578
642
 
579
643
 
580
- var candidates = spatialIndexRef.current.queryPoint(offset.x, offset.y); // 마커 우선 체크 (마커가 폴리곤 위에 표시됨)
644
+ var candidates = spatialIndexRef.current.queryPoint(offset.x, offset.y); // 데이터 타입에 따라 적절한 히트 테스트 수행
581
645
 
582
- for (var i = candidates.length - 1; i >= 0; i--) {
583
- var item = candidates[i];
646
+ if (dataType === types.CanvasDataType.MARKER) {
647
+ // 마커 체크
648
+ for (var i = candidates.length - 1; i >= 0; i--) {
649
+ var item = candidates[i];
584
650
 
585
- if (!item.paths) {
586
651
  if (utils.isPointInMarkerData(offset, item, getOrComputeMarkerOffset)) {
587
652
  return item;
588
653
  }
589
654
  }
590
- } // 폴리곤 체크
591
-
592
-
593
- for (var i = candidates.length - 1; i >= 0; i--) {
594
- var item = candidates[i];
655
+ } else {
656
+ // 폴리곤 체크
657
+ for (var i = candidates.length - 1; i >= 0; i--) {
658
+ var item = candidates[i];
595
659
 
596
- if (item.paths) {
597
660
  if (utils.isPointInPolygonData(offset, item, getOrComputePolygonOffsets)) {
598
661
  return item;
599
662
  }
@@ -603,12 +666,15 @@ var WoongKonvaMarkerComponent = function (_a) {
603
666
  return null;
604
667
  };
605
668
  /**
606
- * Hover 상태 설정 및 Event 레이어 렌더링
669
+ * Hover 상태 설정 및 레이어 렌더링
607
670
  *
608
671
  * @param data hover된 마커/폴리곤 데이터 또는 null
609
672
  *
610
673
  * 최적화: RAF 제거하여 즉시 렌더링 (16ms 지연 제거)
611
- * topOnHover가 true일 때는 Base 레이어도 다시 그려서 z-order 변경
674
+ *
675
+ * 🎯 topOnHover 지원:
676
+ * - renderEvent가 있으면: Event Layer에서만 처리 (성능 최적화)
677
+ * - renderEvent가 없고 topOnHover=true면: Base Layer에서 처리
612
678
  */
613
679
 
614
680
 
@@ -620,10 +686,15 @@ var WoongKonvaMarkerComponent = function (_a) {
620
686
  } else {
621
687
  controller.setMapCursor(data ? 'pointer' : 'grab');
622
688
  } // 즉시 렌더링 (RAF 없이)
623
- // topOnHover는 Event Layer에서만 처리 (Base Layer 재렌더링 제거로 성능 향상)
624
689
 
625
690
 
626
- doRenderEvent();
691
+ if (renderEvent) {
692
+ // renderEvent가 있으면 Event Layer에서만 처리 (성능 최적화)
693
+ doRenderEvent();
694
+ } else if (topOnHover) {
695
+ // renderEvent가 없고 topOnHover가 true면 Base Layer에서 처리
696
+ doRenderBase();
697
+ }
627
698
  };
628
699
  /**
629
700
  * 클릭 처리 (단일/다중 선택)
@@ -687,28 +758,35 @@ var WoongKonvaMarkerComponent = function (_a) {
687
758
  var handleClick = function (event) {
688
759
  var _a;
689
760
 
761
+ if (disableInteractionRef.current) return; // 🚫 상호작용 비활성화 시 즉시 반환
762
+
690
763
  if (context$1 || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
691
764
 
692
765
  try {
693
766
  var clickedOffset = controller.positionToOffset(event.param.position);
694
- var data = findData(clickedOffset);
767
+ var data_1 = findData(clickedOffset);
768
+
769
+ if (data_1) {
770
+ handleLocalClick(data_1);
695
771
 
696
- if (data) {
697
- handleLocalClick(data);
698
- if (onClick) onClick(data, selectedIdsRef.current);
772
+ if (onClick) {
773
+ onClick(data_1, selectedIdsRef.current);
774
+ }
699
775
  }
700
776
  } catch (error) {
701
777
  console.error('[WoongKonvaMarker] handleClick error:', error);
702
778
  }
703
779
  };
704
780
  /**
705
- * 마우스 이동 이벤트 처리 (hover 감지)
781
+ * 마우스 이동 이벤트 처리 (hover 감지 및 상태 업데이트)
706
782
  */
707
783
 
708
784
 
709
785
  var handleMouseMove = function (event) {
710
786
  var _a;
711
787
 
788
+ if (disableInteractionRef.current) return; // 🚫 상호작용 비활성화 시 즉시 반환
789
+
712
790
  if (context$1 || !((_a = event === null || event === void 0 ? void 0 : event.param) === null || _a === void 0 ? void 0 : _a.position)) return;
713
791
 
714
792
  try {
@@ -742,6 +820,26 @@ var WoongKonvaMarkerComponent = function (_a) {
742
820
  var handleDragEnd = function () {
743
821
  draggingRef.current = false;
744
822
  controller.setMapCursor('grab');
823
+ };
824
+ /**
825
+ * 마우스가 canvas를 벗어날 때 hover 상태 정리
826
+ */
827
+
828
+
829
+ var handleMouseLeave = function () {
830
+ if (disableInteractionRef.current) return; // 🚫 상호작용 비활성화 시 즉시 반환
831
+
832
+ var prevHovered = hoveredItemRef.current;
833
+
834
+ if (prevHovered) {
835
+ hoveredItemRef.current = null;
836
+ controller.setMapCursor('grab');
837
+ doRenderEvent();
838
+
839
+ if (onMouseOut) {
840
+ onMouseOut(prevHovered);
841
+ }
842
+ }
745
843
  }; // --------------------------------------------------------------------------
746
844
  // Lifecycle: DOM 초기화
747
845
  // --------------------------------------------------------------------------
@@ -784,7 +882,7 @@ var WoongKonvaMarkerComponent = function (_a) {
784
882
  }
785
883
  }
786
884
  }, [options]); // --------------------------------------------------------------------------
787
- // Lifecycle: Konva 초기화 및 이벤트 리스너 등록
885
+ // Lifecycle: Konva 초기화 및 이벤트 리스너 등록 (컴포넌트 마운트)
788
886
  // --------------------------------------------------------------------------
789
887
 
790
888
  React.useEffect(function () {
@@ -844,7 +942,9 @@ var WoongKonvaMarkerComponent = function (_a) {
844
942
  controller.addEventListener('CLICK', handleClick);
845
943
  controller.addEventListener('MOUSEMOVE', handleMouseMove);
846
944
  controller.addEventListener('DRAGSTART', handleDragStart);
847
- controller.addEventListener('DRAGEND', handleDragEnd);
945
+ controller.addEventListener('DRAGEND', handleDragEnd); // 맵 컨테이너에 mouseleave 이벤트 추가
946
+
947
+ mapDiv.addEventListener('mouseleave', handleMouseLeave);
848
948
  renderAllImmediate(); // Context 사용 시 컴포넌트 등록 (다중 인스턴스 관리)
849
949
 
850
950
  var componentInstance = null;
@@ -863,7 +963,11 @@ var WoongKonvaMarkerComponent = function (_a) {
863
963
  handleLocalClick: handleLocalClick,
864
964
  getSelectedIds: function () {
865
965
  return selectedIdsRef.current;
866
- }
966
+ },
967
+ isInteractionDisabled: function () {
968
+ return disableInteractionRef.current;
969
+ } // 🚫 상호작용 비활성화 여부 반환
970
+
867
971
  };
868
972
  context$1.registerComponent(componentInstance);
869
973
  } // Cleanup 함수
@@ -885,7 +989,8 @@ var WoongKonvaMarkerComponent = function (_a) {
885
989
  controller.removeEventListener('CLICK', handleClick);
886
990
  controller.removeEventListener('MOUSEMOVE', handleMouseMove);
887
991
  controller.removeEventListener('DRAGSTART', handleDragStart);
888
- controller.removeEventListener('DRAGEND', handleDragEnd); // Context 정리
992
+ controller.removeEventListener('DRAGEND', handleDragEnd);
993
+ mapDiv.removeEventListener('mouseleave', handleMouseLeave); // Context 정리
889
994
 
890
995
  if (context$1 && componentInstance) {
891
996
  context$1.unregisterComponent(componentInstance);
@@ -901,21 +1006,34 @@ var WoongKonvaMarkerComponent = function (_a) {
901
1006
  boundingBoxCacheRef.current.clear();
902
1007
  spatialIndexRef.current.clear();
903
1008
  };
904
- }, []); // --------------------------------------------------------------------------
905
- // Lifecycle: 외부 selectedItems 동기화
1009
+ }, []); // 초기화는 한 번만
1010
+ // --------------------------------------------------------------------------
1011
+ // Lifecycle: disableInteraction 동기화 (상호작용 상태 관리)
1012
+ // --------------------------------------------------------------------------
1013
+
1014
+ React.useEffect(function () {
1015
+ disableInteractionRef.current = disableInteraction;
1016
+ }, [disableInteraction]); // --------------------------------------------------------------------------
1017
+ // Lifecycle: 외부 selectedItems 동기화 (선택 상태 관리)
906
1018
  // --------------------------------------------------------------------------
907
1019
 
908
1020
  React.useEffect(function () {
909
1021
  if (!stageRef.current) return; // externalSelectedItems가 undefined면 외부 제어 안 함
910
1022
 
911
- if (externalSelectedItems === undefined) return; // 외부에서 전달된 selectedItems로 동기화
1023
+ if (externalSelectedItems === undefined) return; // 외부에서 전달된 selectedItems로 동기화 (안전한 처리)
912
1024
 
913
1025
  var newSelectedIds = new Set();
914
- var newSelectedItemsMap = new Map();
915
- externalSelectedItems.forEach(function (item) {
916
- newSelectedIds.add(item.id);
917
- newSelectedItemsMap.set(item.id, item);
918
- });
1026
+ var newSelectedItemsMap = new Map(); // selectedItems가 배열인지 확인하고 안전하게 처리
1027
+
1028
+ if (Array.isArray(externalSelectedItems)) {
1029
+ externalSelectedItems.forEach(function (item) {
1030
+ if (item && item.id) {
1031
+ newSelectedIds.add(item.id);
1032
+ newSelectedItemsMap.set(item.id, item);
1033
+ }
1034
+ });
1035
+ }
1036
+
919
1037
  selectedIdsRef.current = newSelectedIds;
920
1038
  selectedItemsMapRef.current = newSelectedItemsMap; // 렌더링
921
1039
 
@@ -924,13 +1042,23 @@ var WoongKonvaMarkerComponent = function (_a) {
924
1042
  doRenderEvent();
925
1043
  }, [externalSelectedItems]); // 배열 자체를 dependency로 사용
926
1044
  // --------------------------------------------------------------------------
927
- // Lifecycle: 마커 데이터 변경 시 렌더링
1045
+ // Lifecycle: 외부 selectedItem 변경 시 Event Layer 리렌더링 (단일 선택 관리)
928
1046
  // --------------------------------------------------------------------------
929
1047
 
930
1048
  React.useEffect(function () {
931
- if (!stageRef.current) return; // markersRef 동기화
1049
+ if (!stageRef.current) return; // Ref 동기화 (안전한 처리)
932
1050
 
933
- markersRef.current = markers; // 데이터 변경 즉시 transform 제거 및 캐시 정리 (겹침 방지)
1051
+ selectedItemRef.current = externalSelectedItem || null; // selectedItem이 변경되면 Event Layer만 다시 그림
1052
+
1053
+ doRenderEvent();
1054
+ }, [externalSelectedItem]); // --------------------------------------------------------------------------
1055
+ // Lifecycle: 데이터 변경 시 렌더링 (데이터 동기화 및 최적화)
1056
+ // --------------------------------------------------------------------------
1057
+
1058
+ React.useEffect(function () {
1059
+ if (!stageRef.current) return; // dataRef 동기화
1060
+
1061
+ dataRef.current = data; // 데이터 변경 시 즉시 transform 제거 및 캐시 정리 (겹침 방지)
934
1062
 
935
1063
  if (containerRef.current) {
936
1064
  containerRef.current.style.transform = '';
@@ -947,24 +1075,24 @@ var WoongKonvaMarkerComponent = function (_a) {
947
1075
  /**
948
1076
  * 선택 상태 동기화 (최적화 버전)
949
1077
  *
950
- * markers가 변경되면 selectedItemsMapRef도 업데이트 필요
1078
+ * data가 변경되면 selectedItemsMapRef도 업데이트 필요
951
1079
  * (참조가 바뀌므로 기존 Map의 데이터는 stale 상태)
952
1080
  *
953
- * 🔥 중요: 화면 밖 마커도 선택 상태 유지!
954
- * - 현재 markers에 있으면 최신 데이터로 업데이트
1081
+ * 🔥 중요: 화면 밖 데이터도 선택 상태 유지!
1082
+ * - 현재 data에 있으면 최신 데이터로 업데이트
955
1083
  * - 없으면 기존 selectedItemsMapRef의 데이터 유지
956
1084
  *
957
- * 최적화: markers를 Map으로 먼저 변환하여 find() 순회 제거
958
- * - O(전체 마커 수 + 선택된 개수) - 매우 효율적
1085
+ * 최적화: data를 Map으로 먼저 변환하여 find() 순회 제거
1086
+ * - O(전체 데이터 수 + 선택된 개수) - 매우 효율적
959
1087
  */
960
1088
 
961
- var markersMap = new Map(markers.map(function (m) {
1089
+ var dataMap = new Map(data.map(function (m) {
962
1090
  return [m.id, m];
963
1091
  }));
964
1092
  var newSelectedItemsMap = new Map();
965
1093
  selectedIdsRef.current.forEach(function (id) {
966
- // 현재 markers에 있으면 최신 데이터 사용
967
- var currentItem = markersMap.get(id);
1094
+ // 현재 data에 있으면 최신 데이터 사용
1095
+ var currentItem = dataMap.get(id);
968
1096
 
969
1097
  if (currentItem) {
970
1098
  newSelectedItemsMap.set(id, currentItem);
@@ -976,12 +1104,15 @@ var WoongKonvaMarkerComponent = function (_a) {
976
1104
  newSelectedItemsMap.set(id, prevItem);
977
1105
  }
978
1106
  }
979
- }); // selectedIdsRef는 그대로 유지 (화면 밖 마커도 선택 상태 유지)
1107
+ }); // selectedIdsRef는 그대로 유지 (화면 밖 항목도 선택 상태 유지)
980
1108
 
981
1109
  selectedItemsMapRef.current = newSelectedItemsMap; // 즉시 렌더링
982
1110
 
983
1111
  renderAllImmediate();
984
- }, [markers]);
1112
+ }, [data]); // --------------------------------------------------------------------------
1113
+ // Render - React Portal을 통한 DOM 렌더링
1114
+ // --------------------------------------------------------------------------
1115
+
985
1116
  return reactDom.createPortal(React__default["default"].createElement("div", {
986
1117
  ref: containerRef,
987
1118
  style: {
@@ -991,42 +1122,12 @@ var WoongKonvaMarkerComponent = function (_a) {
991
1122
  }
992
1123
  }), divElement);
993
1124
  };
994
- /**
995
- * 🔥 React.memo 최적화: 마커 배열과 selectedItems 변경 체크
996
- *
997
- * 비교 전략:
998
- * 1. markers 배열 비교
999
- * 2. selectedItems 배열 비교 (외부 제어)
1000
- *
1001
- * 주의: JSON.stringify() 사용 금지! (매우 느림)
1002
- */
1003
-
1004
-
1005
- var WoongKonvaMarker = React__default["default"].memo(WoongKonvaMarkerComponent, function (prevProps, nextProps) {
1006
- // 1. markers 비교
1007
- var prevMarkers = prevProps.markers;
1008
- var nextMarkers = nextProps.markers; // 참조가 같으면 스킵
1009
-
1010
- if (prevMarkers !== nextMarkers) {
1011
- // 길이가 다르면 변경됨
1012
- if (prevMarkers.length !== nextMarkers.length) return false; // 각 마커의 ID 비교
1013
-
1014
- for (var i = 0; i < prevMarkers.length; i++) {
1015
- if (prevMarkers[i].id !== nextMarkers[i].id) {
1016
- return false; // 변경됨 → 리렌더링
1017
- }
1018
- }
1019
- } // 2. selectedItems 비교 (참조만 비교)
1020
1125
 
1021
-
1022
- if (prevProps.selectedItems !== nextProps.selectedItems) {
1023
- return false; // 변경됨 리렌더링
1024
- }
1025
-
1026
- return true; // 같음 → 리렌더링 스킵
1126
+ Object.defineProperty(exports, 'CanvasDataType', {
1127
+ enumerable: true,
1128
+ get: function () { return types.CanvasDataType; }
1027
1129
  });
1028
-
1029
1130
  exports.KonvaMarkerProvider = context.KonvaMarkerProvider;
1030
1131
  exports.LRUCache = performance.LRUCache;
1031
1132
  exports.SpatialHashGrid = performance.SpatialHashGrid;
1032
- exports["default"] = WoongKonvaMarker;
1133
+ exports["default"] = WoongCanvasLayer;