@mint-ui/map 1.2.0-test.23 → 1.2.0-test.25

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

@@ -9,50 +9,18 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-/** 다중 레이어 관리를 위한 React Context */
-
 var KonvaMarkerContext = React.createContext(null);
-/**
- * 다중 WoongCanvasLayer 관리를 위한 Context Provider
- *
- * 여러 개의 WoongCanvasLayer가 동시에 사용될 때 이벤트 우선순위를 관리하고
- * 전역 클릭/호버 이벤트를 조정합니다.
- *
- * @param children - Provider로 감쌀 React 컴포넌트들
- * @returns Context Provider 컴포넌트
- *
- * @example
- * ```tsx
- * <KonvaMarkerProvider>
- *   <WoongCanvasLayer zIndex={1} data={markers1} ... />
- *   <WoongCanvasLayer zIndex={2} data={markers2} ... />
- * </KonvaMarkerProvider>
- * ```
- */
-
 var KonvaMarkerProvider = function (_a) {
   var children = _a.children;
-  var controller = MintMapProvider.useMintMapController(); // === Refs ===
-
-  /** 등록된 모든 컴포넌트 인스턴스들 (zIndex 내림차순 정렬) */
+  var controller = MintMapProvider.useMintMapController(); // Refs
 
   var componentsRef = React.useRef([]);
-  /** 현재 호버된 컴포넌트 인스턴스 */
-
   var currentHoveredRef = React.useRef(null);
-  /** 현재 호버된 데이터 */
-
   var currentHoveredDataRef = React.useRef(null);
-  /** 드래그/줌 중 여부 (마우스 이동 이벤트 무시용) */
-
-  var draggingRef = React.useRef(false); // === 컴포넌트 관리 함수들 ===
-
+  var draggingRef = React.useRef(false);
   /**
-   * 컴포넌트 인스턴스 등록
-   *
-   * zIndex 내림차순으로 정렬하여 높은 우선순위의 컴포넌트가 먼저 이벤트를 처리하도록 합니다.
-   *
-   * @param instance - 등록할 컴포넌트 인스턴스
+   * 컴포넌트 등록 (zIndex 내림차순 정렬)
+   * 높은 zIndex가 먼저 처리됨
    */
 
   var registerComponent = React.useCallback(function (instance) {
@@ -62,12 +30,7 @@ var KonvaMarkerProvider = function (_a) {
     });
   }, []);
   /**
-   * 컴포넌트 인스턴스 등록 해제
-   *
-   * 컴포넌트가 언마운트될 때 호출되어 Context에서 제거합니다.
-   * 현재 호버 중인 컴포넌트라면 호버 상태도 초기화합니다.
-   *
-   * @param instance - 등록 해제할 컴포넌트 인스턴스
+   * 컴포넌트 등록 해제
    */
 
   var unregisterComponent = React.useCallback(function (instance) {
@@ -80,15 +43,9 @@ var KonvaMarkerProvider = function (_a) {
     componentsRef.current = componentsRef.current.filter(function (c) {
       return c !== instance;
     });
-  }, []); // === 전역 이벤트 핸들러들 ===
-
+  }, []);
   /**
-   * 전역 클릭 이벤트 핸들러
-   *
-   * zIndex 우선순위에 따라 등록된 컴포넌트들을 순회하며 클릭된 데이터를 찾습니다.
-   * 첫 번째로 히트된 컴포넌트의 이벤트만 처리합니다.
-   *
-   * @param event - 지도 클릭 이벤트 파라미터
+   * 전역 클릭 핸들러 (zIndex 우선순위)
    */
 
   var handleGlobalClick = React.useCallback(function (event) {
@@ -98,7 +55,7 @@ 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);
@@ -115,12 +72,7 @@ var KonvaMarkerProvider = function (_a) {
     }
   }, [controller]);
   /**
-   * 전역 마우스 이동 이벤트 핸들러
-   *
-   * zIndex 우선순위에 따라 호버된 데이터를 찾고, 호버 상태가 변경되면
-   * 이전 호버를 해제하고 새로운 호버를 설정합니다.
-   *
-   * @param event - 지도 마우스 이동 이벤트 파라미터
+   * 전역 마우스 이동 핸들러 (zIndex 우선순위)
    */
 
   var handleGlobalMouseMove = React.useCallback(function (event) {
@@ -133,7 +85,7 @@ 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);
@@ -170,24 +122,19 @@ var KonvaMarkerProvider = function (_a) {
     }
   }, [controller]);
   /**
-   * 줌/드래그 시작 이벤트 핸들러
-   *
-   * 지도가 줌이나 드래그를 시작할 때 마우스 이동 이벤트를 무시하도록 설정합니다.
-   * 이는 성능 최적화와 불필요한 호버 이벤트 방지를 위한 것입니다.
+   * 줌/드래그 시작 (마우스 이동 이벤트 무시)
    */
 
   var handleZoomStart = React.useCallback(function () {
     draggingRef.current = true;
   }, []);
   /**
-   * 지도 idle 이벤트 핸들러
-   *
-   * 지도가 idle 상태가 되면 마우스 이동 이벤트를 다시 활성화합니다.
+   * 지도 idle (마우스 이동 이벤트 재개)
    */
 
   var handleIdle = React.useCallback(function () {
     draggingRef.current = false;
-  }, []); // === 이벤트 리스너 등록 ===
+  }, []); // 이벤트 리스너 등록
 
   React.useEffect(function () {
     controller.addEventListener('CLICK', handleGlobalClick);
@@ -200,7 +147,7 @@ var KonvaMarkerProvider = function (_a) {
       controller.removeEventListener('ZOOMSTART', handleZoomStart);
       controller.removeEventListener('IDLE', handleIdle);
     };
-  }, [controller, handleGlobalClick, handleGlobalMouseMove, handleZoomStart, handleIdle]); // === Context value 메모이제이션 ===
+  }, [controller, handleGlobalClick, handleGlobalMouseMove, handleZoomStart, handleIdle]); // Context value 메모이제이션
 
   var contextValue = React.useMemo(function () {
     return {
@@ -212,20 +159,6 @@ var KonvaMarkerProvider = function (_a) {
     value: contextValue
   }, children);
 };
-/**
- * KonvaMarkerContext를 사용하기 위한 Hook
- *
- * @returns Context 값 또는 null (Provider 외부에서 사용 시)
- *
- * @example
- * ```tsx
- * const context = useKonvaMarkerContext();
- * if (context) {
- *   context.registerComponent(instance);
- * }
- * ```
- */
-
 var useKonvaMarkerContext = function () {
   var context = React.useContext(KonvaMarkerContext);
   return context;

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

@@ -1,15 +1,4 @@
-/**
- * @fileoverview WoongCanvasLayer의 공유 유틸리티 모듈
- *
- * 이 파일은 WoongCanvasLayer에서 사용하는 모든 공통 타입, 유틸리티 함수,
- * 성능 최적화 클래스, Context Provider를 외부로 노출합니다.
- *
- * @version 2.2.1
- * @since 2.0.0
- * @author 박건웅
- */
 export * from './types';
 export * from './utils';
 export * from './context';
 export * from './performance';
-export * from './renderer';

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

@@ -1,18 +1,3 @@
-/**
- * @fileoverview WoongCanvasLayer 성능 최적화를 위한 상수 및 클래스
- *
- * 이 파일은 30,000개 이상의 마커/폴리곤을 60fps로 렌더링하기 위한
- * 성능 최적화 상수와 최적화된 자료구조들을 제공합니다.
- *
- * ## 주요 구성 요소
- * - **성능 최적화 상수**: 그리드 셀 크기, 캐시 크기, 컬링 여유 공간
- * - **LRUCache**: 좌표 변환 결과 캐싱을 위한 LRU 캐시 구현
- * - **SpatialHashGrid**: O(1) 수준의 빠른 Hit Test를 위한 공간 해시 그리드
- *
- * @version 2.2.1
- * @since 2.0.0
- * @author 박건웅
- */
 /**
  * 공간 인덱스 그리드 셀 크기 (px)
  *
@@ -55,29 +40,12 @@ export declare const DEFAULT_CULLING_MARGIN = 100;
 export declare const DEFAULT_MAX_CACHE_SIZE = 30000;
 /**
  * LRU (Least Recently Used) Cache
+ * 메모리 제한을 위한 캐시 구현 (최적화 버전)
  *
- * 메모리 제한을 위한 캐시 구현으로, 좌표 변환 결과를 캐싱하여
- * 성능을 최적화합니다. WoongCanvasLayer의 특성에 맞게 최적화되었습니다.
- *
- * ## 주요 특징
- * - **빠른 조회**: O(1) 해시 조회로 성능 최적화
- * - **메모리 제한**: 최대 크기 초과 시 자동 eviction
- * - **FIFO 방식**: 삽입 순서 기반 eviction (접근 빈도 추적 없음)
- *
- * ## 개선 사항
- * 1. **get() 성능 향상**: 접근 빈도 추적 없이 단순 조회만 수행
- * 2. **set() 버그 수정**: 기존 키 업데이트 시 maxSize 체크 로직 개선
- * 3. **메모리 효율**: 단순 FIFO 캐시로 동작하여 오버헤드 최소화
- *
- * @template K 캐시 키 타입
- * @template V 캐시 값 타입
- *
- * @example
- * ```typescript
- * const cache = new LRUCache<string, Offset>(1000);
- * cache.set('marker-1', { x: 100, y: 200 });
- * const offset = cache.get('marker-1'); // { x: 100, y: 200 }
- * ```
+ * 개선 사항:
+ * 1. get() 성능 향상: 접근 빈도 추적 없이 단순 조회만 수행 (delete+set 제거)
+ * 2. set() 버그 수정: 기존 키 업데이트 시 maxSize 체크 로직 개선
+ * 3. 메모리 효율: 단순 FIFO 캐시로 동작하여 오버헤드 최소화
  */
 export declare class LRUCache<K, V> {
     private cache;
@@ -113,33 +81,16 @@ export declare class LRUCache<K, V> {
 }
 /**
  * Spatial Hash Grid (공간 해시 그리드)
+ * 공간 인덱싱을 위한 그리드 기반 자료구조 (개선 버전)
  *
- * 공간 인덱싱을 위한 그리드 기반 자료구조로, 2D 공간을 격자로 나누어
- * 특정 영역에 있는 객체들을 빠르게 찾을 수 있게 해줍니다.
- *
- * ## 주요 특징
- * - **O(1) 조회**: 클릭 위치 주변의 객체들만 체크하여 성능 최적화
- * - **메모리 효율**: 격자 기반으로 필요한 영역만 인덱싱
- * - **중복 방지**: 같은 항목을 여러 번 삽입해도 안전
- *
- * ## 성능 비교
- * - **일반 검색**: 30,000개 항목 전체 체크 → O(n)
- * - **Spatial Hash**: 클릭 위치 주변 ~10개만 체크 → O(1) + O(10)
- * - **성능 향상**: 약 3,000배 빠름! 🚀
- *
- * ## 개선 사항
- * 1. **중복 삽입 방지**: 같은 항목을 여러 번 insert 해도 안전
- * 2. **메모리 누수 방지**: 기존 항목 자동 제거
- * 3. **성능 최적화**: 불필요한 배열 생성 최소화
- *
- * @template T 그리드에 저장할 객체 타입
+ * 개선 사항:
+ * 1. 중복 삽입 방지: 같은 항목을 여러 번 insert 해도 안전
+ * 2. 메모리 누수 방지: 기존 항목 자동 제거
+ * 3. 성능 최적화: 불필요한 배열 생성 최소화
  *
- * @example
- * ```typescript
- * const grid = new SpatialHashGrid<Marker>(50);
- * grid.insert(marker, { x: 100, y: 200, width: 30, height: 40 });
- * const nearby = grid.query(105, 205, 10); // (105, 205) 주변 10px 반경
- * ```
+ * 사용 사례:
+ * - 빠른 Hit Test (마우스 클릭 시 어떤 마커/폴리곤인지 찾기)
+ * - 30,000개 항목 → 클릭 위치 주변 ~10개만 체크 (3,000배 빠름)
  */
 export declare class SpatialHashGrid<T> {
     private cellSize;

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

@@ -2,21 +2,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-/**
- * @fileoverview WoongCanvasLayer 성능 최적화를 위한 상수 및 클래스
- *
- * 이 파일은 30,000개 이상의 마커/폴리곤을 60fps로 렌더링하기 위한
- * 성능 최적화 상수와 최적화된 자료구조들을 제공합니다.
- *
- * ## 주요 구성 요소
- * - **성능 최적화 상수**: 그리드 셀 크기, 캐시 크기, 컬링 여유 공간
- * - **LRUCache**: 좌표 변환 결과 캐싱을 위한 LRU 캐시 구현
- * - **SpatialHashGrid**: O(1) 수준의 빠른 Hit Test를 위한 공간 해시 그리드
- *
- * @version 2.2.1
- * @since 2.0.0
- * @author 박건웅
- */
 // ============================================================================
 // 성능 최적화 상수 (30,000개 마커/폴리곤 기준 최적화)
 // ============================================================================
@@ -65,29 +50,12 @@ var DEFAULT_CULLING_MARGIN = 100;
 var DEFAULT_MAX_CACHE_SIZE = 30000;
 /**
  * LRU (Least Recently Used) Cache
+ * 메모리 제한을 위한 캐시 구현 (최적화 버전)
  *
- * 메모리 제한을 위한 캐시 구현으로, 좌표 변환 결과를 캐싱하여
- * 성능을 최적화합니다. WoongCanvasLayer의 특성에 맞게 최적화되었습니다.
- *
- * ## 주요 특징
- * - **빠른 조회**: O(1) 해시 조회로 성능 최적화
- * - **메모리 제한**: 최대 크기 초과 시 자동 eviction
- * - **FIFO 방식**: 삽입 순서 기반 eviction (접근 빈도 추적 없음)
- *
- * ## 개선 사항
- * 1. **get() 성능 향상**: 접근 빈도 추적 없이 단순 조회만 수행
- * 2. **set() 버그 수정**: 기존 키 업데이트 시 maxSize 체크 로직 개선
- * 3. **메모리 효율**: 단순 FIFO 캐시로 동작하여 오버헤드 최소화
- *
- * @template K 캐시 키 타입
- * @template V 캐시 값 타입
- *
- * @example
- * ```typescript
- * const cache = new LRUCache<string, Offset>(1000);
- * cache.set('marker-1', { x: 100, y: 200 });
- * const offset = cache.get('marker-1'); // { x: 100, y: 200 }
- * ```
+ * 개선 사항:
+ * 1. get() 성능 향상: 접근 빈도 추적 없이 단순 조회만 수행 (delete+set 제거)
+ * 2. set() 버그 수정: 기존 키 업데이트 시 maxSize 체크 로직 개선
+ * 3. 메모리 효율: 단순 FIFO 캐시로 동작하여 오버헤드 최소화
  */
 
 var LRUCache =
@@ -167,33 +135,16 @@ function () {
 }();
 /**
  * Spatial Hash Grid (공간 해시 그리드)
+ * 공간 인덱싱을 위한 그리드 기반 자료구조 (개선 버전)
  *
- * 공간 인덱싱을 위한 그리드 기반 자료구조로, 2D 공간을 격자로 나누어
- * 특정 영역에 있는 객체들을 빠르게 찾을 수 있게 해줍니다.
- *
- * ## 주요 특징
- * - **O(1) 조회**: 클릭 위치 주변의 객체들만 체크하여 성능 최적화
- * - **메모리 효율**: 격자 기반으로 필요한 영역만 인덱싱
- * - **중복 방지**: 같은 항목을 여러 번 삽입해도 안전
- *
- * ## 성능 비교
- * - **일반 검색**: 30,000개 항목 전체 체크 → O(n)
- * - **Spatial Hash**: 클릭 위치 주변 ~10개만 체크 → O(1) + O(10)
- * - **성능 향상**: 약 3,000배 빠름! 🚀
- *
- * ## 개선 사항
- * 1. **중복 삽입 방지**: 같은 항목을 여러 번 insert 해도 안전
- * 2. **메모리 누수 방지**: 기존 항목 자동 제거
- * 3. **성능 최적화**: 불필요한 배열 생성 최소화
- *
- * @template T 그리드에 저장할 객체 타입
+ * 개선 사항:
+ * 1. 중복 삽입 방지: 같은 항목을 여러 번 insert 해도 안전
+ * 2. 메모리 누수 방지: 기존 항목 자동 제거
+ * 3. 성능 최적화: 불필요한 배열 생성 최소화
  *
- * @example
- * ```typescript
- * const grid = new SpatialHashGrid<Marker>(50);
- * grid.insert(marker, { x: 100, y: 200, width: 30, height: 40 });
- * const nearby = grid.query(105, 205, 10); // (105, 205) 주변 10px 반경
- * ```
+ * 사용 사례:
+ * - 빠른 Hit Test (마우스 클릭 시 어떤 마커/폴리곤인지 찾기)
+ * - 30,000개 항목 → 클릭 위치 주변 ~10개만 체크 (3,000배 빠름)
  */
 
 var SpatialHashGrid =

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

@@ -1,45 +1,11 @@
 /**
- * @fileoverview 폴리곤 렌더링을 위한 유틸리티 및 팩토리 함수
+ * 폴리곤 렌더링 유틸리티
  *
- * 이 파일은 WoongCanvasLayer의 POLYGON 모드에서 사용하는 폴리곤 렌더링
- * 함수들을 제공합니다. 다양한 상태(기본, 선택, 호버)에 따른 렌더링과
- * 도넛 폴리곤(구멍이 있는 폴리곤) 지원을 포함합니다.
- *
- * ## 주요 기능
- * - **폴리곤 그리기**: Canvas 2D API를 사용한 폴리곤 렌더링
- * - **도넛 폴리곤 지원**: evenodd fill rule을 사용한 구멍 처리
- * - **상태별 렌더링**: 기본/선택/호버 상태에 따른 색상 및 스타일 적용
- * - **팩토리 함수**: 렌더링 함수를 쉽게 생성할 수 있는 헬퍼
- *
- * @version 2.2.1
- * @since 2.0.0
- * @author 박건웅
+ * 이 파일은 폴리곤 렌더링을 위한 헬퍼 함수와 팩토리 함수를 제공합니다.
  */
 import { CustomRenderBase, CustomRenderEvent, KonvaCanvasData } from "./types";
 /**
- * 폴리곤 그리기 헬퍼 함수
- *
- * Canvas 2D API를 사용하여 폴리곤을 그리는 핵심 함수입니다.
- * 도넛 폴리곤(구멍이 있는 폴리곤)도 지원합니다.
- *
- * @param ctx - Canvas 2D 렌더링 컨텍스트
- * @param polygonOffsets - 변환된 폴리곤 좌표 배열
- * @param isDonutPolygon - 도넛 폴리곤 여부
- * @param fillColor - 채우기 색상
- * @param strokeColor - 테두리 색상
- * @param lineWidth - 테두리 두께
- *
- * @example
- * ```typescript
- * drawPolygon({
- *   ctx,
- *   polygonOffsets: [[[[100, 200], [200, 200], [200, 300], [100, 300]]]],
- *   isDonutPolygon: false,
- *   fillColor: 'rgba(255, 0, 0, 0.5)',
- *   strokeColor: 'rgba(255, 0, 0, 1)',
- *   lineWidth: 2
- * });
- * ```
+ * 폴리곤 그리기 헬퍼 함수 (도넛 폴리곤 지원)
  */
 export declare const drawPolygon: ({ ctx, polygonOffsets, isDonutPolygon, fillColor, strokeColor, lineWidth }: {
     ctx: CanvasRenderingContext2D;
@@ -50,58 +16,39 @@ export declare const drawPolygon: ({ ctx, polygonOffsets, isDonutPolygon, fillCo
     lineWidth: number;
 }) => void;
 /**
- * 폴리곤 Base Layer 렌더링 함수 팩토리
+ * 폴리곤 Base 렌더링 함수
  *
- * 기본 상태의 폴리곤들을 렌더링하는 함수를 생성합니다.
- * 선택된 폴리곤들은 Event Layer에서 렌더링되므로 제외됩니다.
- *
- * @param baseFillColor - 기본 폴리곤 채우기 색상
- * @param baseStrokeColor - 기본 폴리곤 테두리 색상
- * @param baseLineWidth - 기본 폴리곤 테두리 두께
+ * @param baseFillColor 기본 폴리곤 채우기 색상
+ * @param baseStrokeColor 기본 폴리곤 테두리 색상
+ * @param baseLineWidth 기본 폴리곤 테두리 두께
  * @returns Base Layer 렌더링 함수
  *
- * @template T 마커/폴리곤 데이터의 추가 속성 타입
- *
  * @example
- * ```typescript
  * const renderBase = renderPolygonBase(
- *   'rgba(255, 100, 100, 0.5)',  // 기본 채우기 색상
- *   'rgba(200, 50, 50, 0.8)',    // 기본 테두리 색상
- *   2                             // 기본 테두리 두께
+ *   'rgba(255, 100, 100, 0.5)',
+ *   'rgba(200, 50, 50, 0.8)',
+ *   2
  * );
- * ```
  */
 export declare const renderPolygonBase: <T = any>(baseFillColor: string, baseStrokeColor: string, baseLineWidth: number) => CustomRenderBase<KonvaCanvasData<T>>;
 /**
- * 폴리곤 Event Layer 렌더링 함수 팩토리
- *
- * 선택, 호버, 활성 상태의 폴리곤들을 렌더링하는 함수를 생성합니다.
- * 다양한 상태에 따른 색상과 스타일을 지원하며, fallback 메커니즘을 제공합니다.
- *
- * ## 상태별 렌더링 우선순위
- * 1. **Hovered**: 마우스가 올라간 폴리곤 (최우선)
- * 2. **Active**: 마지막으로 선택된 폴리곤
- * 3. **Selected**: 선택된 폴리곤들
- * 4. **Base**: 기본 상태 (fallback)
- *
- * @param baseFillColor - 기본 폴리곤 채우기 색상 (필수, fallback용)
- * @param baseStrokeColor - 기본 폴리곤 테두리 색상 (필수, fallback용)
- * @param baseLineWidth - 기본 폴리곤 테두리 두께 (필수, fallback용)
- * @param selectedFillColor - 선택된 폴리곤 채우기 색상 (선택, 기본값: baseFillColor)
- * @param selectedStrokeColor - 선택된 폴리곤 테두리 색상 (선택, 기본값: baseStrokeColor)
- * @param selectedLineWidth - 선택된 폴리곤 테두리 두께 (선택, 기본값: baseLineWidth)
- * @param activeFillColor - 마지막 선택된 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
- * @param activeStrokeColor - 마지막 선택된 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
- * @param activeLineWidth - 마지막 선택된 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
- * @param hoveredFillColor - Hover 시 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
- * @param hoveredStrokeColor - Hover 시 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
- * @param hoveredLineWidth - Hover 시 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
+ * 폴리곤 Event 렌더링 함수
+ *
+ * @param baseFillColor 기본 폴리곤 채우기 색상 (필수, fallback용)
+ * @param baseStrokeColor 기본 폴리곤 테두리 색상 (필수, fallback용)
+ * @param baseLineWidth 기본 폴리곤 테두리 두께 (필수, fallback용)
+ * @param selectedFillColor 선택된 폴리곤 채우기 색상 (선택, 기본값: baseFillColor)
+ * @param selectedStrokeColor 선택된 폴리곤 테두리 색상 (선택, 기본값: baseStrokeColor)
+ * @param selectedLineWidth 선택된 폴리곤 테두리 두께 (선택, 기본값: baseLineWidth)
+ * @param activeFillColor 마지막 선택된 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
+ * @param activeStrokeColor 마지막 선택된 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
+ * @param activeLineWidth 마지막 선택된 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
+ * @param hoveredFillColor Hover 시 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
+ * @param hoveredStrokeColor Hover 시 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
+ * @param hoveredLineWidth Hover 시 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
  * @returns Event Layer 렌더링 함수
  *
- * @template T 마커/폴리곤 데이터의 추가 속성 타입
- *
  * @example
- * ```typescript
  * const renderEvent = renderPolygonEvent(
  *   'rgba(255, 100, 100, 0.5)',  // baseFillColor
  *   'rgba(200, 50, 50, 0.8)',    // baseStrokeColor
@@ -110,6 +57,5 @@ export declare const renderPolygonBase: <T = any>(baseFillColor: string, baseStr
  *   'rgba(255, 152, 0, 1)',      // selectedStrokeColor
  *   4                             // selectedLineWidth
  * );
- * ```
  */
 export declare const renderPolygonEvent: <T = any>(baseFillColor: string, baseStrokeColor: string, baseLineWidth: number, selectedFillColor?: string, selectedStrokeColor?: string, selectedLineWidth?: number, activeFillColor?: string, activeStrokeColor?: string, activeLineWidth?: number, hoveredFillColor?: string, hoveredStrokeColor?: string, hoveredLineWidth?: number) => CustomRenderEvent<KonvaCanvasData<T>>;

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

@@ -3,47 +3,13 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 /**
- * @fileoverview 폴리곤 렌더링을 위한 유틸리티 및 팩토리 함수
+ * 폴리곤 렌더링 유틸리티
  *
- * 이 파일은 WoongCanvasLayer의 POLYGON 모드에서 사용하는 폴리곤 렌더링
- * 함수들을 제공합니다. 다양한 상태(기본, 선택, 호버)에 따른 렌더링과
- * 도넛 폴리곤(구멍이 있는 폴리곤) 지원을 포함합니다.
- *
- * ## 주요 기능
- * - **폴리곤 그리기**: Canvas 2D API를 사용한 폴리곤 렌더링
- * - **도넛 폴리곤 지원**: evenodd fill rule을 사용한 구멍 처리
- * - **상태별 렌더링**: 기본/선택/호버 상태에 따른 색상 및 스타일 적용
- * - **팩토리 함수**: 렌더링 함수를 쉽게 생성할 수 있는 헬퍼
- *
- * @version 2.2.1
- * @since 2.0.0
- * @author 박건웅
+ * 이 파일은 폴리곤 렌더링을 위한 헬퍼 함수와 팩토리 함수를 제공합니다.
  */
 
 /**
- * 폴리곤 그리기 헬퍼 함수
- *
- * Canvas 2D API를 사용하여 폴리곤을 그리는 핵심 함수입니다.
- * 도넛 폴리곤(구멍이 있는 폴리곤)도 지원합니다.
- *
- * @param ctx - Canvas 2D 렌더링 컨텍스트
- * @param polygonOffsets - 변환된 폴리곤 좌표 배열
- * @param isDonutPolygon - 도넛 폴리곤 여부
- * @param fillColor - 채우기 색상
- * @param strokeColor - 테두리 색상
- * @param lineWidth - 테두리 두께
- *
- * @example
- * ```typescript
- * drawPolygon({
- *   ctx,
- *   polygonOffsets: [[[[100, 200], [200, 200], [200, 300], [100, 300]]]],
- *   isDonutPolygon: false,
- *   fillColor: 'rgba(255, 0, 0, 0.5)',
- *   strokeColor: 'rgba(255, 0, 0, 1)',
- *   lineWidth: 2
- * });
- * ```
+ * 폴리곤 그리기 헬퍼 함수 (도넛 폴리곤 지원)
  */
 var drawPolygon = function (_a) {
   var ctx = _a.ctx,
@@ -114,26 +80,19 @@ var drawPolygon = function (_a) {
   }
 };
 /**
- * 폴리곤 Base Layer 렌더링 함수 팩토리
+ * 폴리곤 Base 렌더링 함수
  *
- * 기본 상태의 폴리곤들을 렌더링하는 함수를 생성합니다.
- * 선택된 폴리곤들은 Event Layer에서 렌더링되므로 제외됩니다.
- *
- * @param baseFillColor - 기본 폴리곤 채우기 색상
- * @param baseStrokeColor - 기본 폴리곤 테두리 색상
- * @param baseLineWidth - 기본 폴리곤 테두리 두께
+ * @param baseFillColor 기본 폴리곤 채우기 색상
+ * @param baseStrokeColor 기본 폴리곤 테두리 색상
+ * @param baseLineWidth 기본 폴리곤 테두리 두께
  * @returns Base Layer 렌더링 함수
  *
- * @template T 마커/폴리곤 데이터의 추가 속성 타입
- *
  * @example
- * ```typescript
  * const renderBase = renderPolygonBase(
- *   'rgba(255, 100, 100, 0.5)',  // 기본 채우기 색상
- *   'rgba(200, 50, 50, 0.8)',    // 기본 테두리 색상
- *   2                             // 기본 테두리 두께
+ *   'rgba(255, 100, 100, 0.5)',
+ *   'rgba(200, 50, 50, 0.8)',
+ *   2
  * );
- * ```
  */
 
 var renderPolygonBase = function (baseFillColor, baseStrokeColor, baseLineWidth) {
@@ -162,35 +121,23 @@ var renderPolygonBase = function (baseFillColor, baseStrokeColor, baseLineWidth)
   };
 };
 /**
- * 폴리곤 Event Layer 렌더링 함수 팩토리
- *
- * 선택, 호버, 활성 상태의 폴리곤들을 렌더링하는 함수를 생성합니다.
- * 다양한 상태에 따른 색상과 스타일을 지원하며, fallback 메커니즘을 제공합니다.
+ * 폴리곤 Event 렌더링 함수
  *
- * ## 상태별 렌더링 우선순위
- * 1. **Hovered**: 마우스가 올라간 폴리곤 (최우선)
- * 2. **Active**: 마지막으로 선택된 폴리곤
- * 3. **Selected**: 선택된 폴리곤들
- * 4. **Base**: 기본 상태 (fallback)
- *
- * @param baseFillColor - 기본 폴리곤 채우기 색상 (필수, fallback용)
- * @param baseStrokeColor - 기본 폴리곤 테두리 색상 (필수, fallback용)
- * @param baseLineWidth - 기본 폴리곤 테두리 두께 (필수, fallback용)
- * @param selectedFillColor - 선택된 폴리곤 채우기 색상 (선택, 기본값: baseFillColor)
- * @param selectedStrokeColor - 선택된 폴리곤 테두리 색상 (선택, 기본값: baseStrokeColor)
- * @param selectedLineWidth - 선택된 폴리곤 테두리 두께 (선택, 기본값: baseLineWidth)
- * @param activeFillColor - 마지막 선택된 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
- * @param activeStrokeColor - 마지막 선택된 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
- * @param activeLineWidth - 마지막 선택된 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
- * @param hoveredFillColor - Hover 시 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
- * @param hoveredStrokeColor - Hover 시 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
- * @param hoveredLineWidth - Hover 시 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
+ * @param baseFillColor 기본 폴리곤 채우기 색상 (필수, fallback용)
+ * @param baseStrokeColor 기본 폴리곤 테두리 색상 (필수, fallback용)
+ * @param baseLineWidth 기본 폴리곤 테두리 두께 (필수, fallback용)
+ * @param selectedFillColor 선택된 폴리곤 채우기 색상 (선택, 기본값: baseFillColor)
+ * @param selectedStrokeColor 선택된 폴리곤 테두리 색상 (선택, 기본값: baseStrokeColor)
+ * @param selectedLineWidth 선택된 폴리곤 테두리 두께 (선택, 기본값: baseLineWidth)
+ * @param activeFillColor 마지막 선택된 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
+ * @param activeStrokeColor 마지막 선택된 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
+ * @param activeLineWidth 마지막 선택된 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
+ * @param hoveredFillColor Hover 시 폴리곤 채우기 색상 (선택, 기본값: selectedFillColor)
+ * @param hoveredStrokeColor Hover 시 폴리곤 테두리 색상 (선택, 기본값: selectedStrokeColor)
+ * @param hoveredLineWidth Hover 시 폴리곤 테두리 두께 (선택, 기본값: selectedLineWidth)
  * @returns Event Layer 렌더링 함수
  *
- * @template T 마커/폴리곤 데이터의 추가 속성 타입
- *
  * @example
- * ```typescript
  * const renderEvent = renderPolygonEvent(
  *   'rgba(255, 100, 100, 0.5)',  // baseFillColor
  *   'rgba(200, 50, 50, 0.8)',    // baseStrokeColor
@@ -199,7 +146,6 @@ var renderPolygonBase = function (baseFillColor, baseStrokeColor, baseLineWidth)
  *   'rgba(255, 152, 0, 1)',      // selectedStrokeColor
  *   4                             // selectedLineWidth
  * );
- * ```
  */
 
 var renderPolygonEvent = function (baseFillColor, baseStrokeColor, baseLineWidth, selectedFillColor, selectedStrokeColor, selectedLineWidth, activeFillColor, activeStrokeColor, activeLineWidth, hoveredFillColor, hoveredStrokeColor, hoveredLineWidth) {