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

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

@@ -129,6 +129,8 @@ export interface RenderEventParams<T> {
     utils: RenderUtils<T>;
     selectedItems?: CanvasData<T>[];
     selectedItem?: CanvasData<T> | null;
+    /** hover 시 마커를 최상단으로 표시할지 여부 (기본값: false) */
+    topOnHover?: boolean;
 }
 /**
  * 커스텀 렌더링 함수 타입 - Event Layer

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

@@ -1,3 +1,4 @@
+import type { MarkerBoundingBox } from './types';
 import { CanvasData, CanvasOption } from './types';
 import { Offset } from '../../../types';
 import { MintMapController } from '../../MintMapController';
@@ -128,3 +129,45 @@ export declare function createCanvasData<T extends Record<string, any>>(serverDa
  * ```
  */
 export declare function createCanvasDataArray<T extends Record<string, any>>(serverDataArray: T[], getCanvasOptions: (serverData: T, index: number) => CanvasOption): CanvasData<T>[];
+/**
+ * 마커 바운딩 박스 좌표 계산 (위도/경도)
+ *
+ * 마커의 중심 좌표와 크기를 기반으로 현재 뷰포트에서의 바운딩 박스 좌표를 계산합니다.
+ *
+ * @param params 계산 파라미터
+ * @param params.lat 마커의 중심 위도
+ * @param params.lng 마커의 중심 경도
+ * @param params.width 마커의 너비 (픽셀 단위, boxWidth)
+ * @param params.height 마커의 높이 (픽셀 단위, boxHeight)
+ * @param params.controller MintMapController 인스턴스 (뷰포트 상태를 알기 위해 필요)
+ * @param params.tailHeight 마커 꼬리 높이 (픽셀 단위, 기본값: 0)
+ * @param params.offsetX 마커 오프셋 X (픽셀 단위, 기본값: 0)
+ * @param params.offsetY 마커 오프셋 Y (픽셀 단위, 기본값: 0)
+ * @returns 마커 바운딩 박스 좌표 (위도/경도) 또는 null
+ *
+ * @example
+ * ```typescript
+ * const boundingBox = calculateMarkerBoundingBox({
+ *   lat: 37.5665,
+ *   lng: 126.9780,
+ *   width: 100,
+ *   height: 50,
+ *   controller: mintMapController
+ * });
+ *
+ * if (boundingBox) {
+ *   console.log('왼쪽 상단:', boundingBox.leftTop);
+ *   console.log('우측 하단:', boundingBox.bottomRight);
+ * }
+ * ```
+ */
+export declare const calculateMarkerBoundingBox: (params: {
+    lat: number;
+    lng: number;
+    width: number;
+    height: number;
+    controller: MintMapController;
+    tailHeight?: number;
+    offsetX?: number;
+    offsetY?: number;
+}) => MarkerBoundingBox | null;

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

@@ -299,7 +299,78 @@ function createCanvasDataArray(serverDataArray, getCanvasOptions) {
     return createCanvasData(serverData, canvasOptions);
   });
 }
+/**
+ * 마커 바운딩 박스 좌표 계산 (위도/경도)
+ *
+ * 마커의 중심 좌표와 크기를 기반으로 현재 뷰포트에서의 바운딩 박스 좌표를 계산합니다.
+ *
+ * @param params 계산 파라미터
+ * @param params.lat 마커의 중심 위도
+ * @param params.lng 마커의 중심 경도
+ * @param params.width 마커의 너비 (픽셀 단위, boxWidth)
+ * @param params.height 마커의 높이 (픽셀 단위, boxHeight)
+ * @param params.controller MintMapController 인스턴스 (뷰포트 상태를 알기 위해 필요)
+ * @param params.tailHeight 마커 꼬리 높이 (픽셀 단위, 기본값: 0)
+ * @param params.offsetX 마커 오프셋 X (픽셀 단위, 기본값: 0)
+ * @param params.offsetY 마커 오프셋 Y (픽셀 단위, 기본값: 0)
+ * @returns 마커 바운딩 박스 좌표 (위도/경도) 또는 null
+ *
+ * @example
+ * ```typescript
+ * const boundingBox = calculateMarkerBoundingBox({
+ *   lat: 37.5665,
+ *   lng: 126.9780,
+ *   width: 100,
+ *   height: 50,
+ *   controller: mintMapController
+ * });
+ *
+ * if (boundingBox) {
+ *   console.log('왼쪽 상단:', boundingBox.leftTop);
+ *   console.log('우측 하단:', boundingBox.bottomRight);
+ * }
+ * ```
+ */
+
+var calculateMarkerBoundingBox = function (params) {
+  try {
+    var lat = params.lat,
+        lng = params.lng,
+        width = params.width,
+        height = params.height,
+        controller = params.controller,
+        _a = params.tailHeight,
+        tailHeight = _a === void 0 ? 0 : _a,
+        _b = params.offsetX,
+        offsetX = _b === void 0 ? 0 : _b,
+        _c = params.offsetY,
+        offsetY = _c === void 0 ? 0 : _c; // 마커의 중심 좌표를 화면 좌표로 변환
+
+    var markerPosition = new MapTypes.Position(lat, lng);
+    var markerOffset = controller.positionToOffset(markerPosition);
+    if (!markerOffset) return null; // 바운딩 박스의 화면 좌표 계산
+
+    var minX = markerOffset.x + offsetX - width / 2;
+    var minY = markerOffset.y + offsetY - height - tailHeight;
+    var maxX = markerOffset.x + offsetX + width / 2;
+    var maxY = markerOffset.y + offsetY; // 왼쪽 상단 좌표를 위도/경도로 변환
+
+    var leftTopOffset = new MapTypes.Offset(minX, minY);
+    var leftTop = controller.offsetToPosition(leftTopOffset); // 우측 하단 좌표를 위도/경도로 변환
+
+    var bottomRightOffset = new MapTypes.Offset(maxX, maxY);
+    var bottomRight = controller.offsetToPosition(bottomRightOffset);
+    return {
+      bottomRight: bottomRight,
+      leftTop: leftTop
+    };
+  } catch (error) {
+    console.error('[calculateMarkerBoundingBox] error:', error);
+    return null;
+  }
+};
 
+exports.calculateMarkerBoundingBox = calculateMarkerBoundingBox;
 exports.calculateTextBoxWidth = calculateTextBoxWidth;
 exports.computeMarkerOffset = computeMarkerOffset;
 exports.computePolygonOffsets = computePolygonOffsets;