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

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

@@ -0,0 +1,4 @@
+export * from '../shared';
+export * from './types';
+export * from './CanvasMarkerLayer';
+export { default as CanvasMarkerLayer } from './CanvasMarkerLayer';

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

@@ -0,0 +1,280 @@
+import type { MarkerOptions, Offset } from '../../../types';
+import type { CanvasData, CustomRenderBase, CustomRenderEvent } from '../shared';
+/**
+ * CanvasMarkerLayer Props (renderEvent가 없는 경우 - 인터랙션 불가)
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export interface CanvasMarkerLayerPropsWithoutEvent<T> extends Pick<MarkerOptions, 'zIndex' | 'anchor' | 'visible'> {
+    /** 렌더링할 마커 데이터 배열 */
+    data: CanvasData<T>[];
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** Queue 캐시 최대 크기 (기본값: 30000) */
+    maxCacheSize?: number;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수가 없으면 인터랙션 관련 props 사용 불가 */
+    renderEvent?: never;
+    /** 인터랙션 관련 props는 renderEvent가 있을 때만 사용 가능 */
+    onClick?: never;
+    onMouseOver?: never;
+    onMouseOut?: never;
+    topOnHover?: never;
+    selectedItems?: never;
+    selectedItem?: never;
+    disableInteraction?: never;
+    topStageZIndex?: never;
+    /** 최적화 데이터 콜백 (디버깅/모니터링용) */
+    onOptimizationDataUpdate?: (data: {
+        cacheSize: number;
+        cacheEntries: Array<[string, number[][][][] | Offset]>;
+        spatialGridCells: Map<string, CanvasData<T>[]>;
+    }) => void;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * selectedItem이 있는 경우
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export interface CanvasMarkerLayerPropsWithEventWithSelectedItem<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;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** Queue 캐시 최대 크기 (기본값: 30000) */
+    maxCacheSize?: number;
+    /** 외부에서 전달된 단일 선택 아이템 */
+    selectedItem: CanvasData<T> | null;
+    /** 외부에서 제어하는 선택된 항목 배열 (selectedItem과 공존 불가) */
+    selectedItems?: never;
+    /** 상호작용 비활성화 여부 (기본값: false) */
+    disableInteraction?: boolean;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어) */
+    topStageZIndex?: never;
+    /** 최적화 데이터 콜백 (디버깅/모니터링용) */
+    onOptimizationDataUpdate?: (data: {
+        cacheSize: number;
+        cacheEntries: Array<[string, number[][][][] | Offset]>;
+        spatialGridCells: Map<string, CanvasData<T>[]>;
+    }) => void;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * selectedItems가 있는 경우
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export interface CanvasMarkerLayerPropsWithEventWithSelectedItems<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;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** Queue 캐시 최대 크기 (기본값: 30000) */
+    maxCacheSize?: number;
+    /** 외부에서 제어하는 선택된 항목 배열 */
+    selectedItems: CanvasData<T>[];
+    /** 외부에서 전달된 단일 선택 아이템 (selectedItems와 공존 불가) */
+    selectedItem?: never;
+    /** 상호작용 비활성화 여부 (기본값: false) */
+    disableInteraction?: boolean;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어) */
+    topStageZIndex?: never;
+    /** 최적화 데이터 콜백 (디버깅/모니터링용) */
+    onOptimizationDataUpdate?: (data: {
+        cacheSize: number;
+        cacheEntries: Array<[string, number[][][][] | Offset]>;
+        spatialGridCells: Map<string, CanvasData<T>[]>;
+    }) => void;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * selectedItem과 selectedItems 둘 다 없는 경우
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export interface CanvasMarkerLayerPropsWithEventWithoutSelection<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;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** Queue 캐시 최대 크기 (기본값: 30000) */
+    maxCacheSize?: number;
+    /** 외부에서 제어하는 선택된 항목 배열 */
+    selectedItems?: never;
+    /** 외부에서 전달된 단일 선택 아이템 */
+    selectedItem?: never;
+    /** 상호작용 비활성화 여부 (기본값: false) */
+    disableInteraction?: boolean;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어) */
+    topStageZIndex?: never;
+    /** 최적화 데이터 콜백 (디버깅/모니터링용) */
+    onOptimizationDataUpdate?: (data: {
+        cacheSize: number;
+        cacheEntries: Array<[string, number[][][][] | Offset]>;
+        spatialGridCells: Map<string, CanvasData<T>[]>;
+    }) => void;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * topStageZIndex가 있을 때
+ * selectedItem이 있는 경우
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export interface CanvasMarkerLayerPropsWithEventWithTopStageWithSelectedItem<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;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** Queue 캐시 최대 크기 (기본값: 30000) */
+    maxCacheSize?: number;
+    /** 외부에서 전달된 단일 선택 아이템 */
+    selectedItem: CanvasData<T> | null;
+    /** 외부에서 제어하는 선택된 항목 배열 (selectedItem과 공존 불가) */
+    selectedItems?: never;
+    /** 상호작용 비활성화 여부 (기본값: false) */
+    disableInteraction?: boolean;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어) */
+    topStageZIndex: number;
+    /** 최적화 데이터 콜백 (디버깅/모니터링용) */
+    onOptimizationDataUpdate?: (data: {
+        cacheSize: number;
+        cacheEntries: Array<[string, number[][][][] | Offset]>;
+        spatialGridCells: Map<string, CanvasData<T>[]>;
+    }) => void;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * topStageZIndex가 있을 때
+ * selectedItems가 있는 경우
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export interface CanvasMarkerLayerPropsWithEventWithTopStageWithSelectedItems<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;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** Queue 캐시 최대 크기 (기본값: 30000) */
+    maxCacheSize?: number;
+    /** 외부에서 제어하는 선택된 항목 배열 */
+    selectedItems: CanvasData<T>[];
+    /** 외부에서 전달된 단일 선택 아이템 (selectedItems와 공존 불가) */
+    selectedItem?: never;
+    /** 상호작용 비활성화 여부 (기본값: false) */
+    disableInteraction?: boolean;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어) */
+    topStageZIndex: number;
+    /** 최적화 데이터 콜백 (디버깅/모니터링용) */
+    onOptimizationDataUpdate?: (data: {
+        cacheSize: number;
+        cacheEntries: Array<[string, number[][][][] | Offset]>;
+        spatialGridCells: Map<string, CanvasData<T>[]>;
+    }) => void;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ * topStageZIndex가 있을 때
+ * selectedItem과 selectedItems 둘 다 없는 경우
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export interface CanvasMarkerLayerPropsWithEventWithTopStageWithoutSelection<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;
+    /** 뷰포트 컬링 여유 공간 (픽셀 단위, 기본값: 100) */
+    cullingMargin?: number;
+    /** Queue 캐시 최대 크기 (기본값: 30000) */
+    maxCacheSize?: number;
+    /** 외부에서 제어하는 선택된 항목 배열 */
+    selectedItems?: never;
+    /** 외부에서 전달된 단일 선택 아이템 */
+    selectedItem?: never;
+    /** 상호작용 비활성화 여부 (기본값: false) */
+    disableInteraction?: boolean;
+    /** Base Layer 렌더링 함수 (필수) */
+    renderBase: CustomRenderBase<T>;
+    /** Event Layer 렌더링 함수 (필수 - 인터랙션 사용 시) */
+    renderEvent: CustomRenderEvent<T>;
+    /** Top Layer의 zIndex (hover된 항목을 최상단에 렌더링하기 위한 레이어) */
+    topStageZIndex: number;
+    /** 최적화 데이터 콜백 (디버깅/모니터링용) */
+    onOptimizationDataUpdate?: (data: {
+        cacheSize: number;
+        cacheEntries: Array<[string, number[][][][] | Offset]>;
+        spatialGridCells: Map<string, CanvasData<T>[]>;
+    }) => void;
+}
+/**
+ * CanvasMarkerLayer Props (renderEvent가 있는 경우 - 인터랙션 가능)
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export declare type CanvasMarkerLayerPropsWithEvent<T> = CanvasMarkerLayerPropsWithEventWithSelectedItem<T> | CanvasMarkerLayerPropsWithEventWithSelectedItems<T> | CanvasMarkerLayerPropsWithEventWithoutSelection<T> | CanvasMarkerLayerPropsWithEventWithTopStageWithSelectedItem<T> | CanvasMarkerLayerPropsWithEventWithTopStageWithSelectedItems<T> | CanvasMarkerLayerPropsWithEventWithTopStageWithoutSelection<T>;
+/**
+ * CanvasMarkerLayer Props
+ *
+ * renderEvent가 없으면 인터랙션 관련 props를 사용할 수 없습니다.
+ * renderEvent가 있으면 모든 인터랙션 관련 props를 사용할 수 있습니다.
+ *
+ * @template T 마커 데이터의 추가 속성 타입
+ */
+export declare type CanvasMarkerLayerProps<T> = CanvasMarkerLayerPropsWithoutEvent<T> | CanvasMarkerLayerPropsWithEvent<T>;

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { CanvasPolygonLayerProps } from './types';
+export { CanvasProvider, QueueCache, RenderSource, SpatialHashGrid } from '../shared';
+export type { CanvasData, CanvasOption, CustomRenderEvent, RenderUtils } from '../shared';
+export type { CanvasPolygonLayerBaseProps, CanvasPolygonLayerProps, CanvasPolygonLayerPropsWithCustomStyle, CanvasPolygonLayerPropsWithIndividualStyles, CanvasPolygonLayerPropsWithObjectStyle, PolygonStyle, PolygonStyleContext, PolygonStyleCustomizer, PolygonStyleCustomizerWithDeps, PolygonStyleObject } from './types';
+declare const CanvasPolygonLayer: <T>(props: CanvasPolygonLayerProps<T>) => React.ReactPortal;
+/**
+ * CanvasPolygonLayer - Konva 기반 고성능 폴리곤 렌더링 컴포넌트
+ *
+ * 세 가지 스타일 지정 방식을 지원합니다 (mutually exclusive):
+ * 1. 개별 props 방식: baseFillColor, baseStrokeColor, baseLineWidth 등 개별 props 사용
+ * 2. 객체 방식: renderStyle 객체로 상태별 스타일 정의
+ * 3. 함수 방식: customStyle 함수로 완전한 커스터마이징 (스타일을 반환하지 않으면 그리지 않음)
+ *
+ * @template T 폴리곤 데이터의 추가 속성 타입
+ */
+export default CanvasPolygonLayer;