@mint-ui/map 1.2.0-test.62 → 1.2.0-test.63

package/dist/components/mint-map/core/advanced/CanvasMarkerLayer/CanvasMarkerLayer.d.ts

@@ -1,14 +1,44 @@
-import React from 'react';
+/// <reference types="react" />
 import { MarkerOptions } from '../../../types';
 import { CanvasData, CustomRenderBase, CustomRenderEvent } from '../shared';
 export { CanvasDataType, CanvasProvider, LRUCache, SpatialHashGrid } from '../shared';
 export type { CanvasData, CanvasOption, CustomRenderBase, CustomRenderEvent, MarkerBoundingBox, RenderBaseParams, RenderEventParams, RenderUtils } from '../shared';
 /**
- * CanvasMarkerLayer Props
+ * CanvasMarkerLayer Props (renderEvent가 없는 경우 - 인터랙션 불가)
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+interface CanvasMarkerLayerPropsWithoutEvent<T> extends Pick<MarkerOptions, 'zIndex' | 'anchor' | 'visible'> {
+    /** 렌더링할 마커 데이터 배열 */
+    data: CanvasData<T>[];
+    /** 뷰포트 컬링 활성화 여부 (기본값: false) */
+    enableViewportCulling?: boolean;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** LRU 캐시 최대 크기 (기본값: 10000) */
+    maxCacheSize?: number;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수가 없으면 인터랙션 관련 props 사용 불가 */
+    renderEvent?: never;
+    /** 인터랙션 관련 props는 renderEvent가 있을 때만 사용 가능 */
+    onClick?: never;
+    onMouseOver?: never;
+    onMouseOut?: never;
+    enableMultiSelect?: never;
+    topOnHover?: never;
+    selectedItems?: never;
+    selectedItem?: never;
+    disableInteraction?: never;
+    topStageZIndex?: never;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * topStageZIndex가 없을 때
  *
  * @template T 마커 데이터의 추가 속성 타입
  */
-export interface CanvasMarkerLayerProps<T> extends Pick<MarkerOptions, 'zIndex' | 'anchor' | 'visible'> {
+interface CanvasMarkerLayerPropsWithEventBase<T> extends Pick<MarkerOptions, 'zIndex' | 'anchor' | 'visible'> {
     /** 렌더링할 마커 데이터 배열 */
     data: CanvasData<T>[];
     /** 마커 클릭 시 호출되는 콜백 함수 */
@@ -35,10 +65,65 @@ export interface CanvasMarkerLayerProps<T> extends Pick<MarkerOptions, 'zIndex'
     disableInteraction?: boolean;
     /** Base Layer 렌더링 함수 (필수) */
     renderBase: CustomRenderBase<T>;
-    /** Event Layer 렌더링 함수 (선택) */
-    renderEvent?: CustomRenderEvent<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어, topOnHover가 true일 때만 사용 가능) */
+    topStageZIndex?: never;
 }
-declare const CanvasMarkerLayer: <T>(props: CanvasMarkerLayerProps<T>) => React.ReactPortal;
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * topStageZIndex가 있을 때 (topOnHover가 반드시 true여야 함)
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+interface CanvasMarkerLayerPropsWithEventWithTopStage<T> extends Pick<MarkerOptions, 'zIndex' | 'anchor' | 'visible'> {
+    /** 렌더링할 마커 데이터 배열 */
+    data: CanvasData<T>[];
+    /** 마커 클릭 시 호출되는 콜백 함수 */
+    onClick?: (payload: CanvasData<T>, selectedIds: Set<string>) => void;
+    /** 마커에 마우스 오버 시 호출되는 콜백 함수 */
+    onMouseOver?: (payload: CanvasData<T>) => void;
+    /** 마커에서 마우스 아웃 시 호출되는 콜백 함수 */
+    onMouseOut?: (payload: CanvasData<T>) => void;
+    /** 다중 선택 활성화 여부 (기본값: false) */
+    enableMultiSelect?: boolean;
+    /** hover 시 마커를 최상단으로 표시할지 여부 (topStageZIndex 사용 시 반드시 true) */
+    topOnHover: true;
+    /** 뷰포트 컬링 활성화 여부 (기본값: false) */
+    enableViewportCulling?: boolean;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** LRU 캐시 최대 크기 (기본값: 10000) */
+    maxCacheSize?: number;
+    /** 외부에서 제어하는 선택된 항목 배열 */
+    selectedItems?: CanvasData<T>[];
+    /** 외부에서 전달된 단일 선택 아이템 */
+    selectedItem?: CanvasData<T> | null;
+    /** 상호작용 비활성화 여부 (기본값: false) */
+    disableInteraction?: boolean;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어, topOnHover가 true일 때만 사용 가능) */
+    topStageZIndex: number;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+declare type CanvasMarkerLayerPropsWithEvent<T> = CanvasMarkerLayerPropsWithEventBase<T> | CanvasMarkerLayerPropsWithEventWithTopStage<T>;
+/**
+ * CanvasMarkerLayer Props
+ *
+ * renderEvent가 없으면 인터랙션 관련 props를 사용할 수 없습니다.
+ * renderEvent가 있으면 모든 인터랙션 관련 props를 사용할 수 있습니다.
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export declare type CanvasMarkerLayerProps<T> = CanvasMarkerLayerPropsWithoutEvent<T> | CanvasMarkerLayerPropsWithEvent<T>;
+declare const CanvasMarkerLayer: <T>(props: CanvasMarkerLayerProps<T>) => JSX.Element;
 /**
  * CanvasMarkerLayer - Konva 기반 고성능 마커 렌더링 컴포넌트
  *