@mint-ui/map 1.2.0-test.42 → 1.2.0-test.44

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

@@ -55,20 +55,19 @@ export interface CanvasOption {
  * };
  *
  * // ✅ 올바른 사용 (헬퍼 함수 사용)
- * const dataArray = createCanvasDataArray([serverData], (item) => ({
- *   id: String(item.id),
+ * const data = createCanvasData(serverData, {
+ *   id: String(serverData.id),
  *   position: new Position(lat, lng)
- * }));
- * const data = dataArray[0]; // 단일 항목이 필요한 경우
+ * });
  * ```
  */
 export declare type CanvasData<T = {}> = T & CanvasOption;
 /**
- * 서버 데이터 배열을 CanvasData 배열로 변환하는 헬퍼 함수
+ * 서버 데이터를 CanvasData로 변환하는 헬퍼 함수들
  *
- * @see createCanvasDataArray in ./utils.ts
+ * @see createCanvasData, createCanvasDataArray in ./utils.ts
  */
-export { createCanvasDataArray } from './utils';
+export { createCanvasData, createCanvasDataArray } from './utils';
 /**
  * 렌더링 유틸리티 함수들 (좌표 변환)
  *

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

@@ -14,4 +14,5 @@ exports.CanvasDataType = void 0;
   CanvasDataType["POLYGON"] = "POLYGON";
 })(exports.CanvasDataType || (exports.CanvasDataType = {}));
 
+exports.createCanvasData = utils.createCanvasData;
 exports.createCanvasDataArray = utils.createCanvasDataArray;

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

@@ -60,6 +60,39 @@ export declare const calculateTextBoxWidth: ({ text, fontConfig, padding, minWid
     padding: number;
     minWidth: number;
 }) => number;
+/**
+ * 서버 데이터를 CanvasData로 변환하는 헬퍼 함수
+ *
+ * 서버 데이터의 필드가 CanvasOption과 충돌하는 경우 (예: id, position 등),
+ * 이 함수를 사용하여 명시적으로 매핑할 수 있습니다.
+ *
+ * @template T 서버에서 받은 원본 데이터 타입
+ * @param serverData 서버에서 받은 원본 데이터
+ * @param canvasOptions CanvasOption 필드들 (충돌하는 필드는 여기서 명시적으로 지정)
+ * @returns CanvasData<T> 타입의 데이터
+ *
+ * @example
+ * ```typescript
+ * interface ServerData {
+ *   id: number;  // CanvasOption의 id와 충돌
+ *   name: string;
+ * }
+ *
+ * const serverData: ServerData = { id: 123, name: "Test" };
+ *
+ * // ✅ 올바른 사용
+ * const canvasData = createCanvasData(serverData, {
+ *   id: String(serverData.id),  // 명시적으로 변환
+ *   position: new Position(37.5, 127.0)
+ * });
+ *
+ * // canvasData는 CanvasData<ServerData> 타입이며:
+ * // - id: string (CanvasOption의 id)
+ * // - name: string (서버 데이터의 name)
+ * // - position: Position (CanvasOption의 position)
+ * ```
+ */
+export declare function createCanvasData<T extends Record<string, any>>(serverData: T, canvasOptions: CanvasOption): CanvasData<T>;
 /**
  * 서버 데이터 배열을 CanvasData 배열로 변환하는 헬퍼 함수
  *

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

@@ -212,6 +212,44 @@ var calculateTextBoxWidth = function (_a) {
   var textWidth = tempCtx.measureText(text).width;
   return Math.max(minWidth, textWidth + padding);
 };
+/**
+ * 서버 데이터를 CanvasData로 변환하는 헬퍼 함수
+ *
+ * 서버 데이터의 필드가 CanvasOption과 충돌하는 경우 (예: id, position 등),
+ * 이 함수를 사용하여 명시적으로 매핑할 수 있습니다.
+ *
+ * @template T 서버에서 받은 원본 데이터 타입
+ * @param serverData 서버에서 받은 원본 데이터
+ * @param canvasOptions CanvasOption 필드들 (충돌하는 필드는 여기서 명시적으로 지정)
+ * @returns CanvasData<T> 타입의 데이터
+ *
+ * @example
+ * ```typescript
+ * interface ServerData {
+ *   id: number;  // CanvasOption의 id와 충돌
+ *   name: string;
+ * }
+ *
+ * const serverData: ServerData = { id: 123, name: "Test" };
+ *
+ * // ✅ 올바른 사용
+ * const canvasData = createCanvasData(serverData, {
+ *   id: String(serverData.id),  // 명시적으로 변환
+ *   position: new Position(37.5, 127.0)
+ * });
+ *
+ * // canvasData는 CanvasData<ServerData> 타입이며:
+ * // - id: string (CanvasOption의 id)
+ * // - name: string (서버 데이터의 name)
+ * // - position: Position (CanvasOption의 position)
+ * ```
+ */
+
+function createCanvasData(serverData, canvasOptions) {
+  // 서버 데이터와 CanvasOption을 결합
+  // CanvasOption의 필드가 우선되므로 충돌하는 필드는 canvasOptions의 값이 사용됨
+  return tslib.__assign(tslib.__assign({}, serverData), canvasOptions);
+}
 /**
  * 서버 데이터 배열을 CanvasData 배열로 변환하는 헬퍼 함수
  *
@@ -249,16 +287,15 @@ var calculateTextBoxWidth = function (_a) {
 
 function createCanvasDataArray(serverDataArray, getCanvasOptions) {
   return serverDataArray.map(function (serverData, index) {
-    var canvasOptions = getCanvasOptions(serverData, index); // 서버 데이터와 CanvasOption을 결합
-    // CanvasOption의 필드가 우선되므로 충돌하는 필드는 canvasOptions의 값이 사용됨
-
-    return tslib.__assign(tslib.__assign({}, serverData), canvasOptions);
+    var canvasOptions = getCanvasOptions(serverData, index);
+    return createCanvasData(serverData, canvasOptions);
   });
 }
 
 exports.calculateTextBoxWidth = calculateTextBoxWidth;
 exports.computeMarkerOffset = computeMarkerOffset;
 exports.computePolygonOffsets = computePolygonOffsets;
+exports.createCanvasData = createCanvasData;
 exports.createCanvasDataArray = createCanvasDataArray;
 exports.hexToRgba = hexToRgba;
 exports.isPointInMarkerData = isPointInMarkerData;

package/dist/index.es.js

@@ -988,6 +988,44 @@ var calculateTextBoxWidth = function (_a) {
   var textWidth = tempCtx.measureText(text).width;
   return Math.max(minWidth, textWidth + padding);
 };
+/**
+ * 서버 데이터를 CanvasData로 변환하는 헬퍼 함수
+ *
+ * 서버 데이터의 필드가 CanvasOption과 충돌하는 경우 (예: id, position 등),
+ * 이 함수를 사용하여 명시적으로 매핑할 수 있습니다.
+ *
+ * @template T 서버에서 받은 원본 데이터 타입
+ * @param serverData 서버에서 받은 원본 데이터
+ * @param canvasOptions CanvasOption 필드들 (충돌하는 필드는 여기서 명시적으로 지정)
+ * @returns CanvasData<T> 타입의 데이터
+ *
+ * @example
+ * ```typescript
+ * interface ServerData {
+ *   id: number;  // CanvasOption의 id와 충돌
+ *   name: string;
+ * }
+ *
+ * const serverData: ServerData = { id: 123, name: "Test" };
+ *
+ * // ✅ 올바른 사용
+ * const canvasData = createCanvasData(serverData, {
+ *   id: String(serverData.id),  // 명시적으로 변환
+ *   position: new Position(37.5, 127.0)
+ * });
+ *
+ * // canvasData는 CanvasData<ServerData> 타입이며:
+ * // - id: string (CanvasOption의 id)
+ * // - name: string (서버 데이터의 name)
+ * // - position: Position (CanvasOption의 position)
+ * ```
+ */
+
+function createCanvasData(serverData, canvasOptions) {
+  // 서버 데이터와 CanvasOption을 결합
+  // CanvasOption의 필드가 우선되므로 충돌하는 필드는 canvasOptions의 값이 사용됨
+  return __assign(__assign({}, serverData), canvasOptions);
+}
 /**
  * 서버 데이터 배열을 CanvasData 배열로 변환하는 헬퍼 함수
  *
@@ -1025,10 +1063,8 @@ var calculateTextBoxWidth = function (_a) {
 
 function createCanvasDataArray(serverDataArray, getCanvasOptions) {
   return serverDataArray.map(function (serverData, index) {
-    var canvasOptions = getCanvasOptions(serverData, index); // 서버 데이터와 CanvasOption을 결합
-    // CanvasOption의 필드가 우선되므로 충돌하는 필드는 canvasOptions의 값이 사용됨
-
-    return __assign(__assign({}, serverData), canvasOptions);
+    var canvasOptions = getCanvasOptions(serverData, index);
+    return createCanvasData(serverData, canvasOptions);
   });
 }
 
@@ -9885,4 +9921,4 @@ function MintMap(_a) {
   }), loading));
 }
 
-export { AnimationPlayer, Bounds, CanvasDataType, CanvasMarker, CanvasMarkerClaude, CanvasMarkerHanquf, CircleMarker, DEFAULT_CULLING_MARGIN, DEFAULT_MAX_CACHE_SIZE, Drawable, GeoCalulator, GoogleMintMapController, LRUCache, MapBuildingProjection, MapCanvasMarkerWrapper, MapCanvasWrapper, MapControlWrapper, MapEvent, MapLoadingWithImage, MapMarkerWrapper, MapPolygonWrapper, MapPolylineWrapper, MapUIEvent, Marker, MintMap, MintMapCanvasRenderer, MintMapController, MintMapCore, MintMapProvider, NaverMintMapController, Offset, PointLoading, Polygon, PolygonCalculator, PolygonMarker, Polyline, Position, SPATIAL_GRID_CELL_SIZE, SVGCircle, SVGPolygon, SVGRect, Spacing, SpatialHashGrid, Status, WoongCanvasMarker, WoongCanvasPolygon, WoongCanvasProvider, buildSpatialIndex, calculateTextBoxWidth, computeMarkerOffset, computePolygonOffsets, createCanvasDataArray, createMapEventHandlers, getClusterInfo, getMapOfType, hexToRgba, isInViewport, isPointInMarkerData, isPointInPolygon, isPointInPolygonData, log, mapValuesToArray, syncExternalSelectedItems, syncSelectedItems, updateViewport, useMarkerMoving, useMintMapController, useWoongCanvasContext, validateEvent, waiting };
+export { AnimationPlayer, Bounds, CanvasDataType, CanvasMarker, CanvasMarkerClaude, CanvasMarkerHanquf, CircleMarker, DEFAULT_CULLING_MARGIN, DEFAULT_MAX_CACHE_SIZE, Drawable, GeoCalulator, GoogleMintMapController, LRUCache, MapBuildingProjection, MapCanvasMarkerWrapper, MapCanvasWrapper, MapControlWrapper, MapEvent, MapLoadingWithImage, MapMarkerWrapper, MapPolygonWrapper, MapPolylineWrapper, MapUIEvent, Marker, MintMap, MintMapCanvasRenderer, MintMapController, MintMapCore, MintMapProvider, NaverMintMapController, Offset, PointLoading, Polygon, PolygonCalculator, PolygonMarker, Polyline, Position, SPATIAL_GRID_CELL_SIZE, SVGCircle, SVGPolygon, SVGRect, Spacing, SpatialHashGrid, Status, WoongCanvasMarker, WoongCanvasPolygon, WoongCanvasProvider, buildSpatialIndex, calculateTextBoxWidth, computeMarkerOffset, computePolygonOffsets, createCanvasData, createCanvasDataArray, createMapEventHandlers, getClusterInfo, getMapOfType, hexToRgba, isInViewport, isPointInMarkerData, isPointInPolygon, isPointInPolygonData, log, mapValuesToArray, syncExternalSelectedItems, syncSelectedItems, updateViewport, useMarkerMoving, useMintMapController, useWoongCanvasContext, validateEvent, waiting };

package/dist/index.js

@@ -72,6 +72,7 @@ Object.defineProperty(exports, 'CanvasDataType', {
 exports.calculateTextBoxWidth = utils.calculateTextBoxWidth;
 exports.computeMarkerOffset = utils.computeMarkerOffset;
 exports.computePolygonOffsets = utils.computePolygonOffsets;
+exports.createCanvasData = utils.createCanvasData;
 exports.createCanvasDataArray = utils.createCanvasDataArray;
 exports.hexToRgba = utils.hexToRgba;
 exports.isPointInMarkerData = utils.isPointInMarkerData;

package/dist/index.umd.js

@@ -992,6 +992,44 @@
     var textWidth = tempCtx.measureText(text).width;
     return Math.max(minWidth, textWidth + padding);
   };
+  /**
+   * 서버 데이터를 CanvasData로 변환하는 헬퍼 함수
+   *
+   * 서버 데이터의 필드가 CanvasOption과 충돌하는 경우 (예: id, position 등),
+   * 이 함수를 사용하여 명시적으로 매핑할 수 있습니다.
+   *
+   * @template T 서버에서 받은 원본 데이터 타입
+   * @param serverData 서버에서 받은 원본 데이터
+   * @param canvasOptions CanvasOption 필드들 (충돌하는 필드는 여기서 명시적으로 지정)
+   * @returns CanvasData<T> 타입의 데이터
+   *
+   * @example
+   * ```typescript
+   * interface ServerData {
+   *   id: number;  // CanvasOption의 id와 충돌
+   *   name: string;
+   * }
+   *
+   * const serverData: ServerData = { id: 123, name: "Test" };
+   *
+   * // ✅ 올바른 사용
+   * const canvasData = createCanvasData(serverData, {
+   *   id: String(serverData.id),  // 명시적으로 변환
+   *   position: new Position(37.5, 127.0)
+   * });
+   *
+   * // canvasData는 CanvasData<ServerData> 타입이며:
+   * // - id: string (CanvasOption의 id)
+   * // - name: string (서버 데이터의 name)
+   * // - position: Position (CanvasOption의 position)
+   * ```
+   */
+
+  function createCanvasData(serverData, canvasOptions) {
+    // 서버 데이터와 CanvasOption을 결합
+    // CanvasOption의 필드가 우선되므로 충돌하는 필드는 canvasOptions의 값이 사용됨
+    return tslib.__assign(tslib.__assign({}, serverData), canvasOptions);
+  }
   /**
    * 서버 데이터 배열을 CanvasData 배열로 변환하는 헬퍼 함수
    *
@@ -1029,10 +1067,8 @@
 
   function createCanvasDataArray(serverDataArray, getCanvasOptions) {
     return serverDataArray.map(function (serverData, index) {
-      var canvasOptions = getCanvasOptions(serverData, index); // 서버 데이터와 CanvasOption을 결합
-      // CanvasOption의 필드가 우선되므로 충돌하는 필드는 canvasOptions의 값이 사용됨
-
-      return tslib.__assign(tslib.__assign({}, serverData), canvasOptions);
+      var canvasOptions = getCanvasOptions(serverData, index);
+      return createCanvasData(serverData, canvasOptions);
     });
   }
 
@@ -9939,6 +9975,7 @@
   exports.calculateTextBoxWidth = calculateTextBoxWidth;
   exports.computeMarkerOffset = computeMarkerOffset;
   exports.computePolygonOffsets = computePolygonOffsets;
+  exports.createCanvasData = createCanvasData;
   exports.createCanvasDataArray = createCanvasDataArray;
   exports.createMapEventHandlers = createMapEventHandlers;
   exports.getClusterInfo = getClusterInfo;

package/package.json

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