expo-gaode-map 1.0.1 → 1.0.2

package/build/ExpoGaodeMap.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMap.types.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMap.types.ts"],"names":[],"mappings":"AAYA,cAAc,SAAS,CAAC;AAGxB,YAAY,EAEV,MAAM,EACN,KAAK,EACL,cAAc,EACd,YAAY,EACZ,MAAM,EAGN,YAAY,EACZ,WAAW,EAGX,WAAW,EACX,SAAS,EACT,eAAe,EAGf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAE1C;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACrE,CAAC;AAEF;;GAEG;AACH,YAAY,EAAE,YAAY,IAAI,qBAAqB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"ExpoGaodeMap.types.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMap.types.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AAGxB,YAAY,EAEV,MAAM,EACN,KAAK,EACL,cAAc,EACd,YAAY,EACZ,MAAM,EAGN,YAAY,EACZ,WAAW,EAGX,WAAW,EACX,SAAS,EACT,eAAe,EAGf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAE1C;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACrE,CAAC;AAEF;;GAEG;AACH,YAAY,EAAE,YAAY,IAAI,qBAAqB,EAAE,MAAM,SAAS,CAAC"}

package/build/ExpoGaodeMap.types.js

@@ -1,13 +1,3 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:03:56
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:30:00
- * @FilePath     : /expo-gaode-map/src/ExpoGaodeMap.types.ts
- * @Description  : 高德地图 Expo Module 主类型定义文件
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 // 导出所有类型定义
 export * from './types';
 export { MapType, LocationMode, LocationAccuracy, CoordinateType, } from './types';

package/build/ExpoGaodeMap.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMap.types.js","sourceRoot":"","sources":["../src/ExpoGaodeMap.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,WAAW;AACX,cAAc,SAAS,CAAC;AA8BxB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:03:56\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-13 14:30:00\n * @FilePath     : /expo-gaode-map/src/ExpoGaodeMap.types.ts\n * @Description  : 高德地图 Expo Module 主类型定义文件\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\n// 导出所有类型定义\nexport * from './types';\n\n// 重新导出常用类型，方便直接从主模块导入\nexport type {\n  // 通用类型\n  LatLng,\n  Point,\n  CameraPosition,\n  LatLngBounds,\n  MapPoi,\n  \n  // 地图视图\n  MapViewProps,\n  CameraEvent,\n  \n  // 定位\n  Coordinates,\n  ReGeocode,\n  LocationOptions,\n  \n  // 覆盖物\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n  CircleProps,\n  HeatMapProps,\n  MultiPointProps,\n  ClusterProps,\n} from './types';\n\nexport {\n  MapType,\n  LocationMode,\n  LocationAccuracy,\n  CoordinateType,\n} from './types';\n\n/**\n * Expo 模块事件类型\n */\nexport type ExpoGaodeMapModuleEvents = {\n  /**\n   * 定位更新事件\n   */\n  onLocationUpdate: (location: any) => void;\n  \n  /**\n   * 定位错误事件\n   */\n  onLocationError: (error: { code: number; message: string }) => void;\n};\n\n/**\n * Expo 地图视图属性（用于主视图组件）\n */\nexport type { MapViewProps as ExpoGaodeMapViewProps } from './types';\n"]}
+{"version":3,"file":"ExpoGaodeMap.types.js","sourceRoot":"","sources":["../src/ExpoGaodeMap.types.ts"],"names":[],"mappings":"AAEA,WAAW;AACX,cAAc,SAAS,CAAC;AA8BxB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC","sourcesContent":["\n\n// 导出所有类型定义\nexport * from './types';\n\n// 重新导出常用类型，方便直接从主模块导入\nexport type {\n  // 通用类型\n  LatLng,\n  Point,\n  CameraPosition,\n  LatLngBounds,\n  MapPoi,\n  \n  // 地图视图\n  MapViewProps,\n  CameraEvent,\n  \n  // 定位\n  Coordinates,\n  ReGeocode,\n  LocationOptions,\n  \n  // 覆盖物\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n  CircleProps,\n  HeatMapProps,\n  MultiPointProps,\n  ClusterProps,\n} from './types';\n\nexport {\n  MapType,\n  LocationMode,\n  LocationAccuracy,\n  CoordinateType,\n} from './types';\n\n/**\n * Expo 模块事件类型\n */\nexport type ExpoGaodeMapModuleEvents = {\n  /**\n   * 定位更新事件\n   */\n  onLocationUpdate: (location: any) => void;\n  \n  /**\n   * 定位错误事件\n   */\n  onLocationError: (error: { code: number; message: string }) => void;\n};\n\n/**\n * Expo 地图视图属性（用于主视图组件）\n */\nexport type { MapViewProps as ExpoGaodeMapViewProps } from './types';\n"]}

package/build/ExpoGaodeMapModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,OAAO,kBAAmB,SAAQ,YAAY,CAAC,wBAAwB,CAAC;CAG9E;;AAGD,wBAAuE"}
+{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,OAAO,kBAAmB,SAAQ,YAAY,CAAC,wBAAwB,CAAC;CAG9E;;AAGD,wBAAuE"}

package/build/ExpoGaodeMapModule.js

@@ -1,13 +1,3 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:03:56
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:58:00
- * @FilePath     : /expo-gaode-map/src/ExpoGaodeMapModule.ts
- * @Description  :
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 import { requireNativeModule } from 'expo';
 // This call loads the native module object from the JSI.
 export default requireNativeModule('ExpoGaodeMap');

package/build/ExpoGaodeMapModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AASzD,yDAAyD;AACzD,eAAe,mBAAmB,CAAqB,cAAc,CAAC,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:03:56\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-13 14:58:00\n * @FilePath     : /expo-gaode-map/src/ExpoGaodeMapModule.ts\n * @Description  : \n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\nimport { NativeModule, requireNativeModule } from 'expo';\nimport type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';\n\n\ndeclare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  // 地图控制方法已移至 MapView 的 ref 调用\n  // 使用方式: mapRef.current.moveCamera() 等\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');\n"]}
+{"version":3,"file":"ExpoGaodeMapModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AASzD,yDAAyD;AACzD,eAAe,mBAAmB,CAAqB,cAAc,CAAC,CAAC","sourcesContent":["\nimport { NativeModule, requireNativeModule } from 'expo';\nimport type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';\n\n\ndeclare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  // 地图控制方法已移至 MapView 的 ref 调用\n  // 使用方式: mapRef.current.moveCamera() 等\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');\n"]}

package/build/ExpoGaodeMapView.d.ts

@@ -3,28 +3,22 @@ import type { MapViewProps, MapViewRef } from './types';
 export type { MapViewRef } from './types';
 export declare const MapContext: React.Context<React.RefObject<MapViewRef | null> | null>;
 /**
- * 高德地图视图组件
+ * 高德地图视图组件，提供地图操作API和覆盖物管理功能
  *
- * @example
- * ```tsx
- * import { MapView } from 'expo-gaode-map';
+ * @param props - 组件属性
+ * @param ref - 外部ref引用，用于访问地图API方法
+ * @returns 返回包含地图视图和上下文提供者的React组件
  *
- * function MyMap() {
- *   const mapRef = React.useRef(null);
+ * @remarks
+ * 该组件内部维护两个ref：
+ * - nativeRef: 指向原生地图视图的引用
+ * - internalRef: 内部使用的API引用，通过MapContext共享
  *
- *   return (
- *     <MapView
- *       ref={mapRef}
- *       style={{ flex: 1 }}
- *       initialCameraPosition={{
- *         target: { latitude: 39.9, longitude: 116.4 },
- *         zoom: 10,
- *       }}
- *       onLoad={() => console.log('地图加载完成')}
- *     />
- *   );
- * }
- * ```
+ * 提供的主要API功能包括：
+ * - 相机控制（移动、缩放、获取当前位置）
+ * - 覆盖物管理（添加/删除/更新标记、折线、多边形、圆形等）
+ *
+ * 所有API方法都会检查地图是否已初始化，未初始化时抛出错误
  */
 declare const ExpoGaodeMapView: React.ForwardRefExoticComponent<MapViewProps & React.RefAttributes<MapViewRef>>;
 export default ExpoGaodeMapView;

package/build/ExpoGaodeMapView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EASX,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C,eAAO,MAAM,UAAU,0DAAuE,CAAC;AAE/F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,QAAA,MAAM,gBAAgB,iFAuFpB,CAAC;AAIH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"ExpoGaodeMapView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EASX,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C,eAAO,MAAM,UAAU,0DAAuE,CAAC;AAE/F;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,gBAAgB,iFA8MpB,CAAC;AAIH,eAAe,gBAAgB,CAAC"}

package/build/ExpoGaodeMapView.js

@@ -1,136 +1,239 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:03:56
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-15 01:50:18
- * @FilePath     : /expo-gaode-map/src/ExpoGaodeMapView.tsx
- * @Description  : 高德地图视图组件
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
 const NativeView = requireNativeViewManager('ExpoGaodeMap');
 // 创建 Context 用于子组件访问 MapRef
 export const MapContext = React.createContext(null);
 /**
- * 高德地图视图组件
+ * 高德地图视图组件，提供地图操作API和覆盖物管理功能
+ *
+ * @param props - 组件属性
+ * @param ref - 外部ref引用，用于访问地图API方法
+ * @returns 返回包含地图视图和上下文提供者的React组件
  *
- * @example
- * ```tsx
- * import { MapView } from 'expo-gaode-map';
+ * @remarks
+ * 该组件内部维护两个ref：
+ * - nativeRef: 指向原生地图视图的引用
+ * - internalRef: 内部使用的API引用，通过MapContext共享
  *
- * function MyMap() {
- *   const mapRef = React.useRef(null);
+ * 提供的主要API功能包括：
+ * - 相机控制（移动、缩放、获取当前位置）
+ * - 覆盖物管理（添加/删除/更新标记、折线、多边形、圆形等）
  *
- *   return (
- *     <MapView
- *       ref={mapRef}
- *       style={{ flex: 1 }}
- *       initialCameraPosition={{
- *         target: { latitude: 39.9, longitude: 116.4 },
- *         zoom: 10,
- *       }}
- *       onLoad={() => console.log('地图加载完成')}
- *     />
- *   );
- * }
- * ```
+ * 所有API方法都会检查地图是否已初始化，未初始化时抛出错误
  */
 const ExpoGaodeMapView = React.forwardRef((props, ref) => {
     const nativeRef = React.useRef(null);
     const internalRef = React.useRef(null);
     const apiRef = React.useMemo(() => ({
+        /**
+         * 移动地图相机到指定位置
+         * @param position 相机位置参数对象，包含目标经纬度、缩放级别等信息
+         * @param duration 动画持续时间（毫秒），默认300毫秒
+         * @throws 如果地图视图未初始化则抛出错误
+         * @returns Promise<void> 异步操作完成后的Promise
+         */
         moveCamera: async (position, duration = 300) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.moveCamera(position, duration);
         },
+        /**
+         * 将屏幕坐标点转换为地理坐标（经纬度）
+         * @param point 屏幕坐标点 {x: number, y: number}
+         * @returns 返回Promise，解析为对应的地理坐标 {latitude: number, longitude: number}
+         * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'
+         */
         getLatLng: async (point) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.getLatLng(point);
         },
+        /**
+         * 设置地图中心点坐标
+         * @param center 要设置的中心点坐标(LatLng格式)
+         * @param animated 是否使用动画效果移动地图(默认为false)
+         * @throws 如果地图视图未初始化则抛出错误
+         */
         setCenter: async (center, animated = false) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.setCenter(center, animated);
         },
+        /**
+         * 设置地图的缩放级别
+         * @param zoom 目标缩放级别
+         * @param animated 是否使用动画过渡效果，默认为false
+         * @throws 如果地图视图未初始化，抛出错误
+         */
         setZoom: async (zoom, animated = false) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.setZoom(zoom, animated);
         },
+        /**
+         * 获取当前地图的相机位置（视角中心点、缩放级别、倾斜角度等）
+         * @returns 返回一个Promise，解析为当前相机位置的对象
+         * @throws 如果地图视图未初始化，则抛出错误
+         */
         getCameraPosition: async () => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.getCameraPosition();
         },
+        /**
+         * 在地图上添加圆形覆盖物
+         * @param id - 圆形覆盖物的唯一标识符
+         * @param props - 圆形覆盖物的属性配置
+         * @returns Promise<void> 添加操作的异步结果
+         * @throws 如果地图视图未初始化，抛出错误'MapView not initialized'
+         */
         addCircle: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.addCircle(id, props);
         },
+        /**
+         * 从地图上移除指定的圆形覆盖物
+         * @param id - 要移除的圆形覆盖物的唯一标识符
+         * @throws 如果地图视图未初始化，抛出错误
+         * @returns Promise<void> 异步操作完成
+         */
         removeCircle: async (id) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.removeCircle(id);
         },
+        /**
+         * 更新地图上的圆形覆盖物
+         * @param id 要更新的圆形覆盖物的唯一标识符
+         * @param props 要更新的圆形属性（部分属性）
+         * @throws 如果地图视图未初始化，抛出错误
+         * @returns Promise<void> 表示更新操作完成
+         */
         updateCircle: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.updateCircle(id, props);
         },
+        /**
+         * 添加一个标记点到地图上
+         * @param id 标记点的唯一标识符
+         * @param props 标记点的配置属性
+         * @returns Promise<void> 添加操作完成后的Promise
+         * @throws 如果地图视图未初始化则抛出错误
+         */
         addMarker: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.addMarker(id, props);
         },
+        /**
+         * 从地图上移除指定ID的标记点
+         * @param id 要移除的标记点ID
+         * @throws 如果地图视图未初始化则抛出错误
+         * @returns Promise<void> 异步操作完成
+         */
         removeMarker: async (id) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.removeMarker(id);
         },
+        /**
+         * 更新地图上指定ID的标记点属性
+         * @param id - 要更新的标记点唯一标识符
+         * @param props - 需要更新的标记点属性对象（部分属性）
+         * @throws 如果地图视图未初始化则抛出错误
+         * @returns Promise对象，表示异步更新操作
+         */
         updateMarker: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.updateMarker(id, props);
         },
+        /**
+         * 添加折线覆盖物到地图
+         * @param id - 折线的唯一标识符
+         * @param props - 折线的配置属性
+         * @returns Promise<void> 添加操作的异步结果
+         * @throws 如果地图视图未初始化则抛出错误
+         */
         addPolyline: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.addPolyline(id, props);
         },
+        /**
+         * 移除地图上的指定折线
+         * @param id - 要移除的折线的唯一标识符
+         * @throws 如果地图视图未初始化，抛出错误
+         * @returns Promise<void>
+         */
         removePolyline: async (id) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.removePolyline(id);
         },
+        /**
+         * 更新地图上的折线覆盖物
+         *
+         * @param id 要更新的折线覆盖物的唯一标识符
+         * @param props 要更新的折线属性，包含部分PolylineProps属性
+         * @returns Promise<void> 异步操作结果
+         * @throws 如果地图视图未初始化，抛出错误
+         */
         updatePolyline: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.updatePolyline(id, props);
         },
+        /**
+         * 向地图添加多边形覆盖物
+         * @param id - 多边形的唯一标识符
+         * @param props - 多边形的配置属性
+         * @returns Promise<void> 添加操作的异步结果
+         * @throws 如果地图视图未初始化则抛出错误
+         */
         addPolygon: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.addPolygon(id, props);
         },
+        /**
+         * 移除地图上的多边形覆盖物
+         * @param id - 要移除的多边形覆盖物的唯一标识符
+         * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'
+         * @returns Promise<void> 异步操作完成
+         */
         removePolygon: async (id) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.removePolygon(id);
         },
+        /**
+         * 更新多边形覆盖物的属性
+         *
+         * @param id - 要更新的多边形覆盖物的唯一标识符
+         * @param props - 要更新的多边形属性对象，包含需要更新的部分属性
+         * @throws {Error} 当地图视图未初始化时抛出错误
+         * @returns Promise<void> 异步操作完成后的Promise
+         */
         updatePolygon: async (id, props) => {
             if (!nativeRef.current)
                 throw new Error('MapView not initialized');
             return nativeRef.current.updatePolygon(id, props);
         },
     }), []);
-    // 设置 internalRef 和外部 ref
+    /**
+     * 将传入的apiRef赋值给internalRef.current
+     * 用于在组件内部保存对地图API实例的引用
+     */
     React.useEffect(() => {
         internalRef.current = apiRef;
     }, [apiRef]);
+    /**
+     * 获取当前地图实例的API引用
+     * @returns 返回地图API的引用对象，可用于调用地图相关方法
+     */
     React.useImperativeHandle(ref, () => apiRef, [apiRef]);
     return (<MapContext.Provider value={internalRef}>
       <NativeView ref={nativeRef} {...props}/>

package/build/ExpoGaodeMapView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:03:56\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-15 01:50:18\n * @FilePath     : /expo-gaode-map/src/ExpoGaodeMapView.tsx\n * @Description  : 高德地图视图组件\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport { requireNativeViewManager } from 'expo-modules-core';\nimport * as React from 'react';\n\nimport type { \n  MapViewProps, \n  MapViewRef,\n  NativeMapViewRef,\n  CameraPosition, \n  LatLng, \n  Point, \n  CircleProps,\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n} from './types';\n\n// 重新导出 MapViewRef 供外部使用\nexport type { MapViewRef } from './types';\n\nconst NativeView: React.ComponentType<MapViewProps & { ref?: React.Ref<NativeMapViewRef> }> = requireNativeViewManager('ExpoGaodeMap');\n\n// 创建 Context 用于子组件访问 MapRef\nexport const MapContext = React.createContext<React.RefObject<MapViewRef | null> | null>(null);\n\n/**\n * 高德地图视图组件\n * \n * @example\n * ```tsx\n * import { MapView } from 'expo-gaode-map';\n * \n * function MyMap() {\n *   const mapRef = React.useRef(null);\n *   \n *   return (\n *     <MapView\n *       ref={mapRef}\n *       style={{ flex: 1 }}\n *       initialCameraPosition={{\n *         target: { latitude: 39.9, longitude: 116.4 },\n *         zoom: 10,\n *       }}\n *       onLoad={() => console.log('地图加载完成')}\n *     />\n *   );\n * }\n * ```\n */\nconst ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref) => {\n  const nativeRef = React.useRef<NativeMapViewRef>(null);\n  const internalRef = React.useRef<MapViewRef | null>(null);\n\n  const apiRef: MapViewRef = React.useMemo(() => ({\n    moveCamera: async (position: CameraPosition, duration: number = 300) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.moveCamera(position, duration);\n    },\n    getLatLng: async (point: Point) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.getLatLng(point);\n    },\n    setCenter: async (center: LatLng, animated: boolean = false) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.setCenter(center, animated);\n    },\n    setZoom: async (zoom: number, animated: boolean = false) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.setZoom(zoom, animated);\n    },\n    getCameraPosition: async () => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.getCameraPosition();\n    },\n    addCircle: async (id: string, props: CircleProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addCircle(id, props);\n    },\n    removeCircle: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removeCircle(id);\n    },\n    updateCircle: async (id: string, props: Partial<CircleProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updateCircle(id, props);\n    },\n    addMarker: async (id: string, props: MarkerProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addMarker(id, props);\n    },\n    removeMarker: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removeMarker(id);\n    },\n    updateMarker: async (id: string, props: Partial<MarkerProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updateMarker(id, props);\n    },\n    addPolyline: async (id: string, props: PolylineProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addPolyline(id, props);\n    },\n    removePolyline: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removePolyline(id);\n    },\n    updatePolyline: async (id: string, props: Partial<PolylineProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updatePolyline(id, props);\n    },\n    addPolygon: async (id: string, props: PolygonProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addPolygon(id, props);\n    },\n    removePolygon: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removePolygon(id);\n    },\n    updatePolygon: async (id: string, props: Partial<PolygonProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updatePolygon(id, props);\n    },\n  }), []);\n\n  // 设置 internalRef 和外部 ref\n  React.useEffect(() => {\n    internalRef.current = apiRef;\n  }, [apiRef]);\n\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n\n  return (\n    <MapContext.Provider value={internalRef}>\n      <NativeView ref={nativeRef} {...props} />\n    </MapContext.Provider>\n  );\n});\n\nExpoGaodeMapView.displayName = 'ExpoGaodeMapView';\n\nexport default ExpoGaodeMapView;\n"]}
+{"version":3,"file":"ExpoGaodeMapView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"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","sourcesContent":["import { requireNativeViewManager } from 'expo-modules-core';\nimport * as React from 'react';\n\nimport type {\n  MapViewProps,\n  MapViewRef,\n  NativeMapViewRef,\n  CameraPosition,\n  LatLng,\n  Point,\n  CircleProps,\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n} from './types';\n\n// 重新导出 MapViewRef 供外部使用\nexport type { MapViewRef } from './types';\n\nconst NativeView: React.ComponentType<MapViewProps & { ref?: React.Ref<NativeMapViewRef> }> = requireNativeViewManager('ExpoGaodeMap');\n\n// 创建 Context 用于子组件访问 MapRef\nexport const MapContext = React.createContext<React.RefObject<MapViewRef | null> | null>(null);\n\n/**\n * 高德地图视图组件，提供地图操作API和覆盖物管理功能\n * \n * @param props - 组件属性\n * @param ref - 外部ref引用，用于访问地图API方法\n * @returns 返回包含地图视图和上下文提供者的React组件\n * \n * @remarks\n * 该组件内部维护两个ref：\n * - nativeRef: 指向原生地图视图的引用\n * - internalRef: 内部使用的API引用，通过MapContext共享\n * \n * 提供的主要API功能包括：\n * - 相机控制（移动、缩放、获取当前位置）\n * - 覆盖物管理（添加/删除/更新标记、折线、多边形、圆形等）\n * \n * 所有API方法都会检查地图是否已初始化，未初始化时抛出错误\n */\nconst ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref) => {\n  const nativeRef = React.useRef<NativeMapViewRef>(null);\n  const internalRef = React.useRef<MapViewRef | null>(null);\n\n  const apiRef: MapViewRef = React.useMemo(() => ({\n    /**\n     * 移动地图相机到指定位置\n     * @param position 相机位置参数对象，包含目标经纬度、缩放级别等信息\n     * @param duration 动画持续时间（毫秒），默认300毫秒\n     * @throws 如果地图视图未初始化则抛出错误\n     * @returns Promise<void> 异步操作完成后的Promise\n     */\n    moveCamera: async (position: CameraPosition, duration: number = 300) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.moveCamera(position, duration);\n    },\n    /**\n     * 将屏幕坐标点转换为地理坐标（经纬度）\n     * @param point 屏幕坐标点 {x: number, y: number}\n     * @returns 返回Promise，解析为对应的地理坐标 {latitude: number, longitude: number}\n     * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'\n     */\n    getLatLng: async (point: Point) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.getLatLng(point);\n    },\n    /**\n     * 设置地图中心点坐标\n     * @param center 要设置的中心点坐标(LatLng格式)\n     * @param animated 是否使用动画效果移动地图(默认为false)\n     * @throws 如果地图视图未初始化则抛出错误\n     */\n    setCenter: async (center: LatLng, animated: boolean = false) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.setCenter(center, animated);\n    },\n    /**\n     * 设置地图的缩放级别\n     * @param zoom 目标缩放级别\n     * @param animated 是否使用动画过渡效果，默认为false\n     * @throws 如果地图视图未初始化，抛出错误\n     */\n    setZoom: async (zoom: number, animated: boolean = false) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.setZoom(zoom, animated);\n    },\n    /**\n     * 获取当前地图的相机位置（视角中心点、缩放级别、倾斜角度等）\n     * @returns 返回一个Promise，解析为当前相机位置的对象\n     * @throws 如果地图视图未初始化，则抛出错误\n     */\n    getCameraPosition: async () => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.getCameraPosition();\n    },\n    /**\n     * 在地图上添加圆形覆盖物\n     * @param id - 圆形覆盖物的唯一标识符\n     * @param props - 圆形覆盖物的属性配置\n     * @returns Promise<void> 添加操作的异步结果\n     * @throws 如果地图视图未初始化，抛出错误'MapView not initialized'\n     */\n    addCircle: async (id: string, props: CircleProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addCircle(id, props);\n    },\n    /**\n     * 从地图上移除指定的圆形覆盖物\n     * @param id - 要移除的圆形覆盖物的唯一标识符\n     * @throws 如果地图视图未初始化，抛出错误\n     * @returns Promise<void> 异步操作完成\n     */\n    removeCircle: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removeCircle(id);\n    },\n    /**\n     * 更新地图上的圆形覆盖物\n     * @param id 要更新的圆形覆盖物的唯一标识符\n     * @param props 要更新的圆形属性（部分属性）\n     * @throws 如果地图视图未初始化，抛出错误\n     * @returns Promise<void> 表示更新操作完成\n     */\n    updateCircle: async (id: string, props: Partial<CircleProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updateCircle(id, props);\n    },\n    /**\n     * 添加一个标记点到地图上\n     * @param id 标记点的唯一标识符\n     * @param props 标记点的配置属性\n     * @returns Promise<void> 添加操作完成后的Promise\n     * @throws 如果地图视图未初始化则抛出错误\n     */\n    addMarker: async (id: string, props: MarkerProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addMarker(id, props);\n    },\n    /**\n     * 从地图上移除指定ID的标记点\n     * @param id 要移除的标记点ID\n     * @throws 如果地图视图未初始化则抛出错误\n     * @returns Promise<void> 异步操作完成\n     */\n    removeMarker: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removeMarker(id);\n    },\n    /**\n     * 更新地图上指定ID的标记点属性\n     * @param id - 要更新的标记点唯一标识符\n     * @param props - 需要更新的标记点属性对象（部分属性）\n     * @throws 如果地图视图未初始化则抛出错误\n     * @returns Promise对象，表示异步更新操作\n     */\n    updateMarker: async (id: string, props: Partial<MarkerProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updateMarker(id, props);\n    },\n    /**\n     * 添加折线覆盖物到地图\n     * @param id - 折线的唯一标识符\n     * @param props - 折线的配置属性\n     * @returns Promise<void> 添加操作的异步结果\n     * @throws 如果地图视图未初始化则抛出错误\n     */\n    addPolyline: async (id: string, props: PolylineProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addPolyline(id, props);\n    },\n    /**\n     * 移除地图上的指定折线\n     * @param id - 要移除的折线的唯一标识符\n     * @throws 如果地图视图未初始化，抛出错误\n     * @returns Promise<void>\n     */\n    removePolyline: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removePolyline(id);\n    },\n    /**\n     * 更新地图上的折线覆盖物\n     * \n     * @param id 要更新的折线覆盖物的唯一标识符\n     * @param props 要更新的折线属性，包含部分PolylineProps属性\n     * @returns Promise<void> 异步操作结果\n     * @throws 如果地图视图未初始化，抛出错误\n     */\n    updatePolyline: async (id: string, props: Partial<PolylineProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updatePolyline(id, props);\n    },\n    /**\n     * 向地图添加多边形覆盖物\n     * @param id - 多边形的唯一标识符\n     * @param props - 多边形的配置属性\n     * @returns Promise<void> 添加操作的异步结果\n     * @throws 如果地图视图未初始化则抛出错误\n     */\n    addPolygon: async (id: string, props: PolygonProps) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.addPolygon(id, props);\n    },\n    /**\n     * 移除地图上的多边形覆盖物\n     * @param id - 要移除的多边形覆盖物的唯一标识符\n     * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'\n     * @returns Promise<void> 异步操作完成\n     */\n    removePolygon: async (id: string) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.removePolygon(id);\n    },\n    /**\n     * 更新多边形覆盖物的属性\n     * \n     * @param id - 要更新的多边形覆盖物的唯一标识符\n     * @param props - 要更新的多边形属性对象，包含需要更新的部分属性\n     * @throws {Error} 当地图视图未初始化时抛出错误\n     * @returns Promise<void> 异步操作完成后的Promise\n     */\n    updatePolygon: async (id: string, props: Partial<PolygonProps>) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.updatePolygon(id, props);\n    },\n  }), []);\n\n  /**\n   * 将传入的apiRef赋值给internalRef.current\n   * 用于在组件内部保存对地图API实例的引用\n   */\n  React.useEffect(() => {\n    internalRef.current = apiRef;\n  }, [apiRef]);\n\n  /**\n   * 获取当前地图实例的API引用\n   * @returns 返回地图API的引用对象，可用于调用地图相关方法\n   */\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n\n  return (\n    <MapContext.Provider value={internalRef}>\n      <NativeView ref={nativeRef} {...props} />\n    </MapContext.Provider>\n  );\n});\n\nExpoGaodeMapView.displayName = 'ExpoGaodeMapView';\n\nexport default ExpoGaodeMapView;\n"]}

package/build/components/overlays/Circle.d.ts

@@ -1,18 +1,23 @@
 import type { CircleProps } from '../../types';
 /**
- * 地图圆形组件
+ * Circle 组件 - 高德地图圆形覆盖物
  *
- * @example
- * ```tsx
- * <MapView>
- *   <Circle
- *     center={{ latitude: 39.9, longitude: 116.4 }}
- *     radius={1000}
- *     fillColor={0x440000FF}
- *     strokeColor={0xFFFF0000}
- *   />
- * </MapView>
- * ```
+ * 该组件用于在高德地图上绘制圆形覆盖物，支持动态更新圆形属性。
+ *
+ * @param {CircleProps} props - 圆形属性配置
+ * @param {LatLng} props.center - 圆形中心点坐标
+ * @param {number} props.radius - 圆形半径（米）
+ * @param {string} props.fillColor - 填充颜色（十六进制或RGBA）
+ * @param {string} props.strokeColor - 边框颜色（十六进制或RGBA）
+ * @param {number} props.strokeWidth - 边框宽度（像素）
+ *
+ * @returns {null} 该组件不渲染任何UI元素
+ *
+ * @remarks
+ * 1. 组件挂载时自动添加圆形到地图
+ * 2. 组件卸载时自动移除圆形
+ * 3. 当中心点、半径、颜色等属性变化时自动更新圆形
+ * 4. 使用 React Context 获取地图实例引用
  */
 export default function Circle(props: CircleProps): null;
 //# sourceMappingURL=Circle.d.ts.map

package/build/components/overlays/Circle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Circle.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,WAAW,QA0ChD"}
+{"version":3,"file":"Circle.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Circle.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,WAAW,QA+ChD"}

package/build/components/overlays/Circle.js

@@ -1,29 +1,24 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:02:00
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:43:00
- * @FilePath     : /expo-gaode-map/src/components/overlays/Circle.tsx
- * @Description  : 地图圆形组件 - 使用命令式 API
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 import * as React from 'react';
 import { MapContext } from '../../ExpoGaodeMapView';
 /**
- * 地图圆形组件
+ * Circle 组件 - 高德地图圆形覆盖物
+ *
+ * 该组件用于在高德地图上绘制圆形覆盖物，支持动态更新圆形属性。
+ *
+ * @param {CircleProps} props - 圆形属性配置
+ * @param {LatLng} props.center - 圆形中心点坐标
+ * @param {number} props.radius - 圆形半径（米）
+ * @param {string} props.fillColor - 填充颜色（十六进制或RGBA）
+ * @param {string} props.strokeColor - 边框颜色（十六进制或RGBA）
+ * @param {number} props.strokeWidth - 边框宽度（像素）
+ *
+ * @returns {null} 该组件不渲染任何UI元素
  *
- * @example
- * ```tsx
- * <MapView>
- *   <Circle
- *     center={{ latitude: 39.9, longitude: 116.4 }}
- *     radius={1000}
- *     fillColor={0x440000FF}
- *     strokeColor={0xFFFF0000}
- *   />
- * </MapView>
- * ```
+ * @remarks
+ * 1. 组件挂载时自动添加圆形到地图
+ * 2. 组件卸载时自动移除圆形
+ * 3. 当中心点、半径、颜色等属性变化时自动更新圆形
+ * 4. 使用 React Context 获取地图实例引用
  */
 export default function Circle(props) {
     const mapRef = React.useContext(MapContext);
@@ -49,7 +44,11 @@ export default function Circle(props) {
             }
         };
     }, []);
-    // 当 props 变化时更新圆形
+    /**
+     * 当Circle组件的props发生变化时，更新地图上的圆形覆盖物
+     * 如果圆形ID和地图引用都存在，则调用地图实例的updateCircle方法更新圆形
+     * 更新成功后会打印日志确认
+     */
     React.useEffect(() => {
         console.log('Circle props 变化，更新圆形');
         if (circleIdRef.current && mapRef?.current) {

package/build/components/overlays/Circle.js.map

@@ -1 +1 @@
-{"version":3,"file":"Circle.js","sourceRoot":"","sources":["../../../src/components/overlays/Circle.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAkB;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEtD,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAEzD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE1C,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,OAAO;QACP,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACzD,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;QAE/B,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElC,cAAc;QACd,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC/C,IAAI,WAAW,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,kBAAkB;IAClB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,IAAI,WAAW,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAExF,WAAW;IACX,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 15:02:00\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-13 18:43:00\n * @FilePath     : /expo-gaode-map/src/components/overlays/Circle.tsx\n * @Description  : 地图圆形组件 - 使用命令式 API\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport * as React from 'react';\nimport type { CircleProps } from '../../types';\nimport { MapContext } from '../../ExpoGaodeMapView';\n\n/**\n * 地图圆形组件\n * \n * @example\n * ```tsx\n * <MapView>\n *   <Circle\n *     center={{ latitude: 39.9, longitude: 116.4 }}\n *     radius={1000}\n *     fillColor={0x440000FF}\n *     strokeColor={0xFFFF0000}\n *   />\n * </MapView>\n * ```\n */\nexport default function Circle(props: CircleProps) {\n  const mapRef = React.useContext(MapContext);\n  const circleIdRef = React.useRef<string | null>(null);\n  \n  console.log('Circle 组件渲染，props:', JSON.stringify(props));\n  \n  React.useEffect(() => {\n    console.log('Circle useEffect - 添加圆形到地图');\n    \n    if (!mapRef?.current) {\n      console.warn('MapRef 不可用');\n      return;\n    }\n    \n    // 添加圆形\n    const circleId = `circle_${Date.now()}_${Math.random()}`;\n    circleIdRef.current = circleId;\n    \n    mapRef.current.addCircle(circleId, props);\n    console.log('✅ 圆形已添加:', circleId);\n    \n    // 清理函数 - 移除圆形\n    return () => {\n      console.log('Circle useEffect cleanup - 移除圆形');\n      if (circleIdRef.current && mapRef?.current) {\n        mapRef.current.removeCircle(circleIdRef.current);\n        console.log('✅ 圆形已移除:', circleIdRef.current);\n      }\n    };\n  }, []);\n  \n  // 当 props 变化时更新圆形\n  React.useEffect(() => {\n    console.log('Circle props 变化，更新圆形');\n    if (circleIdRef.current && mapRef?.current) {\n      mapRef.current.updateCircle(circleIdRef.current, props);\n      console.log('✅ 圆形已更新:', circleIdRef.current);\n    }\n  }, [props.center, props.radius, props.fillColor, props.strokeColor, props.strokeWidth]);\n  \n  // 不渲染任何 UI\n  return null;\n}\n"]}
+{"version":3,"file":"Circle.js","sourceRoot":"","sources":["../../../src/components/overlays/Circle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAkB;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEtD,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAEzD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE1C,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,OAAO;QACP,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACzD,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;QAE/B,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElC,cAAc;QACd,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC/C,IAAI,WAAW,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAGP;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,IAAI,WAAW,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAExF,WAAW;IACX,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import * as React from 'react';\nimport type { CircleProps } from '../../types';\nimport { MapContext } from '../../ExpoGaodeMapView';\n\n/**\n * Circle 组件 - 高德地图圆形覆盖物\n * \n * 该组件用于在高德地图上绘制圆形覆盖物，支持动态更新圆形属性。\n * \n * @param {CircleProps} props - 圆形属性配置\n * @param {LatLng} props.center - 圆形中心点坐标\n * @param {number} props.radius - 圆形半径（米）\n * @param {string} props.fillColor - 填充颜色（十六进制或RGBA）\n * @param {string} props.strokeColor - 边框颜色（十六进制或RGBA）\n * @param {number} props.strokeWidth - 边框宽度（像素）\n * \n * @returns {null} 该组件不渲染任何UI元素\n * \n * @remarks\n * 1. 组件挂载时自动添加圆形到地图\n * 2. 组件卸载时自动移除圆形\n * 3. 当中心点、半径、颜色等属性变化时自动更新圆形\n * 4. 使用 React Context 获取地图实例引用\n */\nexport default function Circle(props: CircleProps) {\n  const mapRef = React.useContext(MapContext);\n  const circleIdRef = React.useRef<string | null>(null);\n  \n  console.log('Circle 组件渲染，props:', JSON.stringify(props));\n  \n  React.useEffect(() => {\n    console.log('Circle useEffect - 添加圆形到地图');\n    \n    if (!mapRef?.current) {\n      console.warn('MapRef 不可用');\n      return;\n    }\n    \n    // 添加圆形\n    const circleId = `circle_${Date.now()}_${Math.random()}`;\n    circleIdRef.current = circleId;\n    \n    mapRef.current.addCircle(circleId, props);\n    console.log('✅ 圆形已添加:', circleId);\n    \n    // 清理函数 - 移除圆形\n    return () => {\n      console.log('Circle useEffect cleanup - 移除圆形');\n      if (circleIdRef.current && mapRef?.current) {\n        mapRef.current.removeCircle(circleIdRef.current);\n        console.log('✅ 圆形已移除:', circleIdRef.current);\n      }\n    };\n  }, []);\n\n\n  /**\n   * 当Circle组件的props发生变化时，更新地图上的圆形覆盖物\n   * 如果圆形ID和地图引用都存在，则调用地图实例的updateCircle方法更新圆形\n   * 更新成功后会打印日志确认\n   */\n  React.useEffect(() => {\n    console.log('Circle props 变化，更新圆形');\n    if (circleIdRef.current && mapRef?.current) {\n      mapRef.current.updateCircle(circleIdRef.current, props);\n      console.log('✅ 圆形已更新:', circleIdRef.current);\n    }\n  }, [props.center, props.radius, props.fillColor, props.strokeColor, props.strokeWidth]);\n  \n  // 不渲染任何 UI\n  return null;\n}\n"]}

package/build/components/overlays/Cluster.d.ts

@@ -1,22 +1,10 @@
 import * as React from 'react';
 import type { ClusterProps } from '../../types';
 /**
- * 地图点聚合组件
- * 将相近的标记点聚合显示，提高大量标记的展示性能
+ * 高德地图点聚合组件
  *
- * @example
- * ```tsx
- * <MapView>
- *   <Cluster
- *     points={[
- *       { latitude: 39.9, longitude: 116.4, id: '1' },
- *       { latitude: 39.91, longitude: 116.41, id: '2' },
- *     ]}
- *     radius={60}
- *     minClusterSize={2}
- *   />
- * </MapView>
- * ```
+ * @param props 点聚合组件的属性配置
+ * @returns 渲染原生点聚合组件
  */
 export default function Cluster(props: ClusterProps): React.JSX.Element;
 //# sourceMappingURL=Cluster.d.ts.map

package/build/components/overlays/Cluster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cluster.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Cluster.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,KAAK,EAAE,YAAY,qBAElD"}
+{"version":3,"file":"Cluster.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Cluster.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,KAAK,EAAE,YAAY,qBAElD"}

package/build/components/overlays/Cluster.js

@@ -1,33 +1,11 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:02:50
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:19:20
- * @FilePath     : /expo-gaode-map/src/components/overlays/Cluster.tsx
- * @Description  : 地图点聚合组件
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
 const NativeCluster = requireNativeViewManager('ExpoGaodeMap_ClusterView');
 /**
- * 地图点聚合组件
- * 将相近的标记点聚合显示，提高大量标记的展示性能
+ * 高德地图点聚合组件
  *
- * @example
- * ```tsx
- * <MapView>
- *   <Cluster
- *     points={[
- *       { latitude: 39.9, longitude: 116.4, id: '1' },
- *       { latitude: 39.91, longitude: 116.41, id: '2' },
- *     ]}
- *     radius={60}
- *     minClusterSize={2}
- *   />
- * </MapView>
- * ```
+ * @param props 点聚合组件的属性配置
+ * @returns 渲染原生点聚合组件
  */
 export default function Cluster(props) {
     return <NativeCluster {...props}/>;