@mint-ui/map 1.2.0-test.38 → 1.2.0-test.39

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

@@ -1,9 +1,23 @@
 /**
  * 공간 인덱스 그리드 셀 크기 (픽셀 단위)
  *
- * @default 50
+ * @default 100
+ *
+ * @remarks
+ * 셀 크기는 평균 마커 크기의 1.5~2배가 적절합니다.
+ * - 마커가 50px 이하: 50px 권장
+ * - 마커가 60-80px: 100px 권장 (현재 설정)
+ * - 마커가 100px 이상: 150-200px 권장
+ *
+ * 셀 크기가 너무 작으면:
+ * - 한 마커가 여러 셀에 등록되어 메모리 사용량 증가
+ * - 인덱스 빌드 비용 증가
+ *
+ * 셀 크기가 너무 크면:
+ * - 한 셀에 많은 마커가 들어가서 Hit Test 시 후보 항목이 많아짐
+ * - Hit Test 성능 저하
  */
-export declare const SPATIAL_GRID_CELL_SIZE = 50;
+export declare const SPATIAL_GRID_CELL_SIZE = 100;
 /**
  * 뷰포트 컬링 여유 공간 (픽셀 단위)
  *

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

@@ -5,9 +5,23 @@ Object.defineProperty(exports, '__esModule', { value: true });
 /**
  * 공간 인덱스 그리드 셀 크기 (픽셀 단위)
  *
- * @default 50
+ * @default 100
+ *
+ * @remarks
+ * 셀 크기는 평균 마커 크기의 1.5~2배가 적절합니다.
+ * - 마커가 50px 이하: 50px 권장
+ * - 마커가 60-80px: 100px 권장 (현재 설정)
+ * - 마커가 100px 이상: 150-200px 권장
+ *
+ * 셀 크기가 너무 작으면:
+ * - 한 마커가 여러 셀에 등록되어 메모리 사용량 증가
+ * - 인덱스 빌드 비용 증가
+ *
+ * 셀 크기가 너무 크면:
+ * - 한 셀에 많은 마커가 들어가서 Hit Test 시 후보 항목이 많아짐
+ * - Hit Test 성능 저하
  */
-var SPATIAL_GRID_CELL_SIZE = 50;
+var SPATIAL_GRID_CELL_SIZE = 100;
 /**
  * 뷰포트 컬링 여유 공간 (픽셀 단위)
  *
@@ -98,7 +112,7 @@ var SpatialHashGrid =
 function () {
   function SpatialHashGrid(cellSize) {
     if (cellSize === void 0) {
-      cellSize = 200;
+      cellSize = SPATIAL_GRID_CELL_SIZE;
     }
 
     this.cellSize = cellSize;

package/dist/index.es.js

@@ -1136,9 +1136,23 @@ var useWoongCanvasContext = function () {
 /**
  * 공간 인덱스 그리드 셀 크기 (픽셀 단위)
  *
- * @default 50
+ * @default 100
+ *
+ * @remarks
+ * 셀 크기는 평균 마커 크기의 1.5~2배가 적절합니다.
+ * - 마커가 50px 이하: 50px 권장
+ * - 마커가 60-80px: 100px 권장 (현재 설정)
+ * - 마커가 100px 이상: 150-200px 권장
+ *
+ * 셀 크기가 너무 작으면:
+ * - 한 마커가 여러 셀에 등록되어 메모리 사용량 증가
+ * - 인덱스 빌드 비용 증가
+ *
+ * 셀 크기가 너무 크면:
+ * - 한 셀에 많은 마커가 들어가서 Hit Test 시 후보 항목이 많아짐
+ * - Hit Test 성능 저하
  */
-var SPATIAL_GRID_CELL_SIZE = 50;
+var SPATIAL_GRID_CELL_SIZE = 100;
 /**
  * 뷰포트 컬링 여유 공간 (픽셀 단위)
  *
@@ -1229,7 +1243,7 @@ var SpatialHashGrid =
 function () {
   function SpatialHashGrid(cellSize) {
     if (cellSize === void 0) {
-      cellSize = 200;
+      cellSize = SPATIAL_GRID_CELL_SIZE;
     }
 
     this.cellSize = cellSize;

package/dist/index.umd.js

@@ -1140,9 +1140,23 @@
   /**
    * 공간 인덱스 그리드 셀 크기 (픽셀 단위)
    *
-   * @default 50
+   * @default 100
+   *
+   * @remarks
+   * 셀 크기는 평균 마커 크기의 1.5~2배가 적절합니다.
+   * - 마커가 50px 이하: 50px 권장
+   * - 마커가 60-80px: 100px 권장 (현재 설정)
+   * - 마커가 100px 이상: 150-200px 권장
+   *
+   * 셀 크기가 너무 작으면:
+   * - 한 마커가 여러 셀에 등록되어 메모리 사용량 증가
+   * - 인덱스 빌드 비용 증가
+   *
+   * 셀 크기가 너무 크면:
+   * - 한 셀에 많은 마커가 들어가서 Hit Test 시 후보 항목이 많아짐
+   * - Hit Test 성능 저하
    */
-  var SPATIAL_GRID_CELL_SIZE = 50;
+  var SPATIAL_GRID_CELL_SIZE = 100;
   /**
    * 뷰포트 컬링 여유 공간 (픽셀 단위)
    *
@@ -1233,7 +1247,7 @@
   function () {
     function SpatialHashGrid(cellSize) {
       if (cellSize === void 0) {
-        cellSize = 200;
+        cellSize = SPATIAL_GRID_CELL_SIZE;
       }
 
       this.cellSize = cellSize;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mint-ui/map",
-  "version": "1.2.0-test.38",
+  "version": "1.2.0-test.39",
   "main": "./dist/index.js",
   "module": "./dist/index.es.js",
   "browser": "./dist/index.umd.js",