expo-gaode-map 2.2.3-next.1 → 2.2.3

package/build/components/overlays/Marker.js

@@ -6,7 +6,7 @@ const NativeMarkerView = requireNativeViewManager('MarkerView');
  *
  * 支持：
  * - 自定义图标（icon）
- * - 自定义内容（children）
+ * - 自定义内容（children）- 自动测量尺寸
  * - 大头针样式（pinColor）
  * - 拖拽功能
  * - 所有事件回调
@@ -14,14 +14,14 @@ const NativeMarkerView = requireNativeViewManager('MarkerView');
 function Marker(props) {
     // 从 props 中排除 position 属性，避免传递到原生层
     const { position, customViewWidth, customViewHeight, iconWidth, iconHeight, children, ...restProps } = props;
-    // 🔑 性能优化：使用常量避免重复计算
     // 根据是否有 children 来决定使用哪个尺寸属性
     const hasChildren = !!children;
+    // 智能尺寸计算
     const finalIconWidth = hasChildren
-        ? (customViewWidth && customViewWidth > 0 ? customViewWidth : 200)
+        ? (customViewWidth && customViewWidth > 0 ? customViewWidth : 0)
         : (iconWidth && iconWidth > 0 ? iconWidth : 40);
     const finalIconHeight = hasChildren
-        ? (customViewHeight && customViewHeight > 0 ? customViewHeight : 40)
+        ? (customViewHeight && customViewHeight > 0 ? customViewHeight : 0)
         : (iconHeight && iconHeight > 0 ? iconHeight : 40);
     return (<NativeMarkerView latitude={position.latitude} longitude={position.longitude} iconWidth={finalIconWidth} iconHeight={finalIconHeight} customViewWidth={finalIconWidth} customViewHeight={finalIconHeight} {...restProps}>
       {children}

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

@@ -1 +1 @@
-{"version":3,"file":"Marker.js","sourceRoot":"","sources":["../../../src/components/overlays/Marker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,SAAS,MAAM,CAAC,KAAkB;IAChC,mCAAmC;IACnC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IAE7G,qBAAqB;IACrB,6BAA6B;IAC7B,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,MAAM,cAAc,GAAG,WAAW;QAChC,CAAC,CAAC,CAAC,eAAe,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC;QAClE,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,WAAW;QACjC,CAAC,CAAC,CAAC,gBAAgB,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,CAAC,CAAC,CAAC,UAAU,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAErD,OAAO,CACL,CAAC,gBAAgB,CACf,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC5B,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC9B,SAAS,CAAC,CAAC,cAAc,CAAC,CAC1B,UAAU,CAAC,CAAC,eAAe,CAAC,CAC5B,eAAe,CAAC,CAAC,cAAc,CAAC,CAChC,gBAAgB,CAAC,CAAC,eAAe,CAAC,CAClC,IAAI,SAAS,CAAC,CAEd;MAAA,CAAC,QAAQ,CACX;IAAA,EAAE,gBAAgB,CAAC,CACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,SAAsB,EAAE,SAAsB;IACnE,0BAA0B;IAC1B,IACE,SAAS,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,CAAC,QAAQ;QAC3D,SAAS,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,QAAQ,CAAC,SAAS,EAC7D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0CAA0C;IAC1C,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6BAA6B;IAC7B,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED,WAAW;AACX,eAAe,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC","sourcesContent":["import * as React from 'react';\nimport { requireNativeViewManager } from 'expo-modules-core';\nimport type { MarkerProps } from '../../types';\n\nconst NativeMarkerView = requireNativeViewManager('MarkerView');\n\n/**\n * Marker 组件 - 完全声明式 API\n *\n * 支持：\n * - 自定义图标（icon）\n * - 自定义内容（children）\n * - 大头针样式（pinColor）\n * - 拖拽功能\n * - 所有事件回调\n */\nfunction Marker(props: MarkerProps) {\n  // 从 props 中排除 position 属性，避免传递到原生层\n  const { position, customViewWidth, customViewHeight, iconWidth, iconHeight, children, ...restProps } = props;\n  \n  // 🔑 性能优化：使用常量避免重复计算\n  // 根据是否有 children 来决定使用哪个尺寸属性\n  const hasChildren = !!children;\n  const finalIconWidth = hasChildren\n    ? (customViewWidth && customViewWidth > 0 ? customViewWidth : 200)\n    : (iconWidth && iconWidth > 0 ? iconWidth : 40);\n  const finalIconHeight = hasChildren\n    ? (customViewHeight && customViewHeight > 0 ? customViewHeight : 40)\n    : (iconHeight && iconHeight > 0 ? iconHeight : 40);\n  \n  return (\n    <NativeMarkerView\n      latitude={position.latitude}\n      longitude={position.longitude}\n      iconWidth={finalIconWidth}\n      iconHeight={finalIconHeight}\n      customViewWidth={finalIconWidth}\n      customViewHeight={finalIconHeight}\n      {...restProps}\n    >\n      {children}\n    </NativeMarkerView>\n  );\n}\n\n/**\n * 🔑 性能优化：极简比较函数\n * 只检查最常变化的关键属性,减少 JS 线程开销\n */\nfunction arePropsEqual(prevProps: MarkerProps, nextProps: MarkerProps): boolean {\n  // 快速路径：比较 position (最常变化)\n  if (\n    prevProps.position.latitude !== nextProps.position.latitude ||\n    prevProps.position.longitude !== nextProps.position.longitude\n  ) {\n    return false;\n  }\n  \n  // 比较 cacheKey (如果提供了 cacheKey,其他属性理论上不会变)\n  if (prevProps.cacheKey !== nextProps.cacheKey) {\n    return false;\n  }\n  \n  // 比较 children (如果有 children)\n  if (prevProps.children !== nextProps.children) {\n    return false;\n  }\n  \n  // 其他属性相同,不重新渲染\n  return true;\n}\n\n// 导出优化后的组件\nexport default React.memo(Marker, arePropsEqual);"]}
+{"version":3,"file":"Marker.js","sourceRoot":"","sources":["../../../src/components/overlays/Marker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,SAAS,MAAM,CAAC,KAAkB;IAChC,mCAAmC;IACnC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IAE7G,6BAA6B;IAC7B,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC;IAE/B,SAAS;IACT,MAAM,cAAc,GAAG,WAAW;QAChC,CAAC,CAAC,CAAC,eAAe,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG,WAAW;QACjC,CAAC,CAAC,CAAC,gBAAgB,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC,UAAU,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAErD,OAAO,CACL,CAAC,gBAAgB,CACf,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC5B,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC9B,SAAS,CAAC,CAAC,cAAc,CAAC,CAC1B,UAAU,CAAC,CAAC,eAAe,CAAC,CAC5B,eAAe,CAAC,CAAC,cAAc,CAAC,CAChC,gBAAgB,CAAC,CAAC,eAAe,CAAC,CAClC,IAAI,SAAS,CAAC,CAEd;MAAA,CAAC,QAAQ,CACX;IAAA,EAAE,gBAAgB,CAAC,CACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,SAAsB,EAAE,SAAsB;IACnE,0BAA0B;IAC1B,IACE,SAAS,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,CAAC,QAAQ;QAC3D,SAAS,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,QAAQ,CAAC,SAAS,EAC7D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0CAA0C;IAC1C,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6BAA6B;IAC7B,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED,WAAW;AACX,eAAe,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC","sourcesContent":["import * as React from 'react';\nimport { requireNativeViewManager } from 'expo-modules-core';\nimport type { MarkerProps } from '../../types';\n\nconst NativeMarkerView = requireNativeViewManager('MarkerView');\n\n/**\n * Marker 组件 - 完全声明式 API\n *\n * 支持：\n * - 自定义图标（icon）\n * - 自定义内容（children）- 自动测量尺寸\n * - 大头针样式（pinColor）\n * - 拖拽功能\n * - 所有事件回调\n */\nfunction Marker(props: MarkerProps) {\n  // 从 props 中排除 position 属性，避免传递到原生层\n  const { position, customViewWidth, customViewHeight, iconWidth, iconHeight, children, ...restProps } = props;\n  \n  // 根据是否有 children 来决定使用哪个尺寸属性\n  const hasChildren = !!children;\n  \n  // 智能尺寸计算\n  const finalIconWidth = hasChildren\n    ? (customViewWidth && customViewWidth > 0 ? customViewWidth : 0)\n    : (iconWidth && iconWidth > 0 ? iconWidth : 40);\n    \n  const finalIconHeight = hasChildren\n    ? (customViewHeight && customViewHeight > 0 ? customViewHeight : 0)\n    : (iconHeight && iconHeight > 0 ? iconHeight : 40);\n  \n  return (\n    <NativeMarkerView\n      latitude={position.latitude}\n      longitude={position.longitude}\n      iconWidth={finalIconWidth}\n      iconHeight={finalIconHeight}\n      customViewWidth={finalIconWidth}\n      customViewHeight={finalIconHeight}\n      {...restProps}\n    >\n      {children}\n    </NativeMarkerView>\n  );\n}\n\n/**\n * 🔑 性能优化：极简比较函数\n * 只检查最常变化的关键属性,减少 JS 线程开销\n */\nfunction arePropsEqual(prevProps: MarkerProps, nextProps: MarkerProps): boolean {\n  // 快速路径：比较 position (最常变化)\n  if (\n    prevProps.position.latitude !== nextProps.position.latitude ||\n    prevProps.position.longitude !== nextProps.position.longitude\n  ) {\n    return false;\n  }\n  \n  // 比较 cacheKey (如果提供了 cacheKey,其他属性理论上不会变)\n  if (prevProps.cacheKey !== nextProps.cacheKey) {\n    return false;\n  }\n  \n  // 比较 children (如果有 children)\n  if (prevProps.children !== nextProps.children) {\n    return false;\n  }\n  \n  // 其他属性相同,不重新渲染\n  return true;\n}\n\n// 导出优化后的组件\nexport default React.memo(Marker, arePropsEqual);"]}

package/build/hooks/useMapPreload.d.ts

@@ -2,35 +2,7 @@
  * 地图预加载 Hook
  * 提供便捷的 React Hook 来管理地图预加载
  */
-import { PreloadConfig, PreloadStatus } from '../utils/MapPreloader';
-/**
- * Hook 返回值
- */
-export interface UseMapPreloadReturn {
-    /** 当前预加载状态 */
-    status: PreloadStatus;
-    /** 是否正在预加载 */
-    isLoading: boolean;
-    /** 是否已准备就绪 */
-    isReady: boolean;
-    /** 是否发生错误 */
-    hasError: boolean;
-    /** 预加载统计信息 */
-    stats: {
-        total: number;
-        ready: number;
-        loading: number;
-        error: number;
-    };
-    /** 手动开始预加载 */
-    startPreload: () => void;
-    /** 停止预加载 */
-    stopPreload: () => void;
-    /** 清理预加载实例 */
-    clearInstances: () => void;
-    /** 获取一个预加载实例 */
-    getPreloadedInstance: () => string | null;
-}
+import { PreloadConfig, UseMapPreloadReturn } from '../types/preload.types';
 /**
  * 地图预加载 Hook
  *

package/build/hooks/useMapPreload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMapPreload.d.ts","sourceRoot":"","sources":["../../src/hooks/useMapPreload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAgB,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc;IACd,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc;IACd,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY;IACZ,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc;IACd,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB;IAChB,oBAAoB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,aAAa,EACtB,SAAS,GAAE,OAAc,GACxB,mBAAmB,CAwFrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAGnE"}
+{"version":3,"file":"useMapPreload.d.ts","sourceRoot":"","sources":["../../src/hooks/useMapPreload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAgB,mBAAmB,EAAC,MAAM,wBAAwB,CAAC;AAGzF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,aAAa,EACtB,SAAS,GAAE,OAAc,GACxB,mBAAmB,CAwFrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAGnE"}

package/build/hooks/useMapPreload.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMapPreload.js","sourceRoot":"","sources":["../../src/hooks/useMapPreload.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 地图预加载 Hook\n * 提供便捷的 React Hook 来管理地图预加载\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport { MapPreloader, PreloadConfig, PreloadStatus } from '../utils/MapPreloader';\n\n/**\n * Hook 返回值\n */\nexport interface UseMapPreloadReturn {\n  /** 当前预加载状态 */\n  status: PreloadStatus;\n  /** 是否正在预加载 */\n  isLoading: boolean;\n  /** 是否已准备就绪 */\n  isReady: boolean;\n  /** 是否发生错误 */\n  hasError: boolean;\n  /** 预加载统计信息 */\n  stats: {\n    total: number;\n    ready: number;\n    loading: number;\n    error: number;\n  };\n  /** 手动开始预加载 */\n  startPreload: () => void;\n  /** 停止预加载 */\n  stopPreload: () => void;\n  /** 清理预加载实例 */\n  clearInstances: () => void;\n  /** 获取一个预加载实例 */\n  getPreloadedInstance: () => string | null;\n}\n\n/**\n * 地图预加载 Hook\n * \n * @param config 预加载配置\n * @param autoStart 是否自动开始预加载，默认为 true\n * @returns 预加载状态和控制方法\n * \n * @example\n * ```tsx\n * function App() {\n *   const { status, isReady, startPreload } = useMapPreload({\n *     poolSize: 2,\n *     delay: 1000,\n *   });\n * \n *   return (\n *     <View>\n *       <Text>预加载状态: {status}</Text>\n *       {isReady && <MapView />}\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useMapPreload(\n  config?: PreloadConfig,\n  autoStart: boolean = true\n): UseMapPreloadReturn {\n  const [status, setStatus] = useState<PreloadStatus>(() => MapPreloader.getStatus());\n  const [stats, setStats] = useState(() => MapPreloader.getStats());\n  const configRef = useRef(config);\n  const autoStartRef = useRef(autoStart);\n\n  // 更新配置引用\n  useEffect(() => {\n    configRef.current = config;\n  }, [config]);\n\n  // 更新自动启动引用\n  useEffect(() => {\n    autoStartRef.current = autoStart;\n  }, [autoStart]);\n\n  // 更新统计信息\n  const updateStats = useCallback(() => {\n    setStats(MapPreloader.getStats());\n  }, []);\n\n  // 监听状态变化\n  useEffect(() => {\n    const unsubscribe = MapPreloader.addListener((newStatus) => {\n      setStatus(newStatus);\n      updateStats();\n    });\n\n    return () => {\n      unsubscribe();\n    };\n  }, [updateStats]);\n\n  // 配置并自动启动预加载\n  useEffect(() => {\n    if (configRef.current) {\n      MapPreloader.configure(configRef.current);\n    }\n\n    if (autoStartRef.current) {\n      MapPreloader.startPreload();\n    }\n\n    // 组件卸载时清理\n    return () => {\n      if (autoStartRef.current) {\n        MapPreloader.stopPreload();\n      }\n    };\n  }, []); // 只在挂载时执行一次\n\n  // 手动开始预加载\n  const startPreload = useCallback(() => {\n    if (configRef.current) {\n      MapPreloader.configure(configRef.current);\n    }\n    MapPreloader.startPreload();\n  }, []);\n\n  // 停止预加载\n  const stopPreload = useCallback(() => {\n    MapPreloader.stopPreload();\n  }, []);\n\n  // 清理预加载实例\n  const clearInstances = useCallback(() => {\n    MapPreloader.clearPreloadedInstances();\n    updateStats();\n  }, [updateStats]);\n\n  // 获取预加载实例\n  const getPreloadedInstance = useCallback(() => {\n    const instance = MapPreloader.getPreloadedInstance();\n    updateStats();\n    return instance;\n  }, [updateStats]);\n\n  return {\n    status,\n    isLoading: status === 'loading',\n    isReady: status === 'ready',\n    hasError: status === 'error',\n    stats,\n    startPreload,\n    stopPreload,\n    clearInstances,\n    getPreloadedInstance,\n  };\n}\n\n/**\n * 简化版 Hook - 只返回预加载状态\n * \n * @param config 预加载配置\n * @returns 预加载状态\n * \n * @example\n * ```tsx\n * function App() {\n *   const isReady = useMapPreloadStatus({ poolSize: 1 });\n * \n *   if (!isReady) {\n *     return <LoadingScreen />;\n *   }\n * \n *   return <MapView />;\n * }\n * ```\n */\nexport function useMapPreloadStatus(config?: PreloadConfig): boolean {\n  const { isReady } = useMapPreload(config, true);\n  return isReady;\n}"]}
+{"version":3,"file":"useMapPreload.js","sourceRoot":"","sources":["../../src/hooks/useMapPreload.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 地图预加载 Hook\n * 提供便捷的 React Hook 来管理地图预加载\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport { MapPreloader } from '../utils/MapPreloader';\nimport { PreloadConfig,PreloadStatus ,UseMapPreloadReturn} from '../types/preload.types';\n\n\n/**\n * 地图预加载 Hook\n * \n * @param config 预加载配置\n * @param autoStart 是否自动开始预加载，默认为 true\n * @returns 预加载状态和控制方法\n * \n * @example\n * ```tsx\n * function App() {\n *   const { status, isReady, startPreload } = useMapPreload({\n *     poolSize: 2,\n *     delay: 1000,\n *   });\n * \n *   return (\n *     <View>\n *       <Text>预加载状态: {status}</Text>\n *       {isReady && <MapView />}\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useMapPreload(\n  config?: PreloadConfig,\n  autoStart: boolean = true\n): UseMapPreloadReturn {\n  const [status, setStatus] = useState<PreloadStatus>(() => MapPreloader.getStatus());\n  const [stats, setStats] = useState(() => MapPreloader.getStats());\n  const configRef = useRef(config);\n  const autoStartRef = useRef(autoStart);\n\n  // 更新配置引用\n  useEffect(() => {\n    configRef.current = config;\n  }, [config]);\n\n  // 更新自动启动引用\n  useEffect(() => {\n    autoStartRef.current = autoStart;\n  }, [autoStart]);\n\n  // 更新统计信息\n  const updateStats = useCallback(() => {\n    setStats(MapPreloader.getStats());\n  }, []);\n\n  // 监听状态变化\n  useEffect(() => {\n    const unsubscribe = MapPreloader.addListener((newStatus) => {\n      setStatus(newStatus);\n      updateStats();\n    });\n\n    return () => {\n      unsubscribe();\n    };\n  }, [updateStats]);\n\n  // 配置并自动启动预加载\n  useEffect(() => {\n    if (configRef.current) {\n      MapPreloader.configure(configRef.current);\n    }\n\n    if (autoStartRef.current) {\n      MapPreloader.startPreload();\n    }\n\n    // 组件卸载时清理\n    return () => {\n      if (autoStartRef.current) {\n        MapPreloader.stopPreload();\n      }\n    };\n  }, []); // 只在挂载时执行一次\n\n  // 手动开始预加载\n  const startPreload = useCallback(() => {\n    if (configRef.current) {\n      MapPreloader.configure(configRef.current);\n    }\n    MapPreloader.startPreload();\n  }, []);\n\n  // 停止预加载\n  const stopPreload = useCallback(() => {\n    MapPreloader.stopPreload();\n  }, []);\n\n  // 清理预加载实例\n  const clearInstances = useCallback(() => {\n    MapPreloader.clearPreloadedInstances();\n    updateStats();\n  }, [updateStats]);\n\n  // 获取预加载实例\n  const getPreloadedInstance = useCallback(() => {\n    const instance = MapPreloader.getPreloadedInstance();\n    updateStats();\n    return instance;\n  }, [updateStats]);\n\n  return {\n    status,\n    isLoading: status === 'loading',\n    isReady: status === 'ready',\n    hasError: status === 'error',\n    stats,\n    startPreload,\n    stopPreload,\n    clearInstances,\n    getPreloadedInstance,\n  };\n}\n\n/**\n * 简化版 Hook - 只返回预加载状态\n * \n * @param config 预加载配置\n * @returns 预加载状态\n * \n * @example\n * ```tsx\n * function App() {\n *   const isReady = useMapPreloadStatus({ poolSize: 1 });\n * \n *   if (!isReady) {\n *     return <LoadingScreen />;\n *   }\n * \n *   return <MapView />;\n * }\n * ```\n */\nexport function useMapPreloadStatus(config?: PreloadConfig): boolean {\n  const { isReady } = useMapPreload(config, true);\n  return isReady;\n}"]}

package/build/index.d.ts

@@ -7,11 +7,9 @@ export type { MapViewRef } from './ExpoGaodeMapView';
 export { Marker, Polyline, Polygon, Circle, HeatMap, MultiPoint, Cluster, } from './components/overlays';
 export { requireModule, OptionalModules, getInstalledModules, printModuleInfo, createLazyLoader, } from './utils/ModuleLoader';
 export { MapPreloader, preloadMap, getPreloadStatus, clearPreloadedMaps, } from './utils/MapPreloader';
-export type { PreloadConfig, PreloadStatus } from './utils/MapPreloader';
+export type { PreloadConfig, PreloadStatus, UseMapPreloadReturn, MapPreloaderProps } from './types/preload.types';
 export { useMapPreload, useMapPreloadStatus } from './hooks/useMapPreload';
-export type { UseMapPreloadReturn } from './hooks/useMapPreload';
 export { default as MapPreloaderComponent } from './components/MapPreloader';
-export type { MapPreloaderProps } from './components/MapPreloader';
 export { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';
 export { default } from './ExpoGaodeMapModule';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AAGhH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI3E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAI7E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAKrE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,UAAU;AACV,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG7E,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["\n// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块 - 直接使用，无需封装\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 从 ExpoGaodeMapModule 重新导出类型，方便使用\nexport type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 导出模块检测工具\nexport {\n  requireModule,\n  OptionalModules,\n  getInstalledModules,\n  printModuleInfo,\n  createLazyLoader,\n} from './utils/ModuleLoader';\n\n// 导出地图预加载功能\nexport {\n  MapPreloader,\n  preloadMap,\n  getPreloadStatus,\n  clearPreloadedMaps,\n} from './utils/MapPreloader';\nexport type { PreloadConfig, PreloadStatus } from './utils/MapPreloader';\n\n// 导出预加载 Hook\nexport { useMapPreload, useMapPreloadStatus } from './hooks/useMapPreload';\nexport type { UseMapPreloadReturn } from './hooks/useMapPreload';\n\n// 导出预加载组件\nexport { default as MapPreloaderComponent } from './components/MapPreloader';\nexport type { MapPreloaderProps } from './components/MapPreloader';\n\n// 导出便捷读取的 SDK 配置与 webKey\nexport { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAKrE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAI9B,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,UAAU;AACV,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG7E,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["\n// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块 - 直接使用，无需封装\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 从 ExpoGaodeMapModule 重新导出类型，方便使用\nexport type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 导出模块检测工具\nexport {\n  requireModule,\n  OptionalModules,\n  getInstalledModules,\n  printModuleInfo,\n  createLazyLoader,\n} from './utils/ModuleLoader';\n\n// 导出地图预加载功能\nexport {\n  MapPreloader,\n  preloadMap,\n  getPreloadStatus,\n  clearPreloadedMaps,\n} from './utils/MapPreloader';\n\nexport type { PreloadConfig, PreloadStatus ,UseMapPreloadReturn,MapPreloaderProps} from './types/preload.types';\n\n// 导出预加载 Hook\nexport { useMapPreload, useMapPreloadStatus } from './hooks/useMapPreload';\n\n\n// 导出预加载组件\nexport { default as MapPreloaderComponent } from './components/MapPreloader';\n\n\n// 导出便捷读取的 SDK 配置与 webKey\nexport { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}

package/build/types/index.d.ts

@@ -8,4 +8,5 @@ export type { LocationEvent, CameraEvent, MapViewProps, MapViewMethods, MapViewR
 export type { Coordinates, ReGeocode, LocationOptions, LocationListener, GeoLanguage, LocationProtocol, } from './location.types';
 export { LocationAccuracy, LocationMode, CoordinateType, } from './location.types';
 export type { MarkerProps, PolylineProps, PolygonProps, CircleProps, HeatMapProps, MultiPointItem, MultiPointProps, ClusterParams, ClusterPoint, ClusterProps, } from './overlays.types';
+export type { PreloadConfig, PreloadStatus, PreloadStrategy, PreloadInstance, UseMapPreloadReturn, MapPreloaderProps } from './preload.types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,KAAK,EACL,MAAM,EACN,MAAM,EACN,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAGH,YAAY,EACV,KAAK,EACL,MAAM,EACN,MAAM,EACN,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC"}

package/build/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAqBzC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC","sourcesContent":["/**\n * 高德地图 Expo Module 类型定义统一导出\n * 基于 Expo Modules API 重新设计\n */\n\n// 通用类型\nexport type {\n  Point,\n  LatLng,\n  MapPoi,\n  LatLngBounds,\n  CameraPosition,\n  ColorValue,\n} from './common.types';\n\nexport { MapType } from './common.types';\n\n// 地图视图类型\nexport type {\n  LocationEvent,\n  CameraEvent,\n  MapViewProps,\n  MapViewMethods,\n  MapViewRef,\n} from './map-view.types';\n\n// 定位类型\nexport type {\n  Coordinates,\n  ReGeocode,\n  LocationOptions,\n  LocationListener,\n  GeoLanguage,\n  LocationProtocol,\n} from './location.types';\n\nexport {\n  LocationAccuracy,\n  LocationMode,\n  CoordinateType,\n} from './location.types';\n\n// 覆盖物类型\nexport type {\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n  CircleProps,\n  HeatMapProps,\n  MultiPointItem,\n  MultiPointProps,\n  ClusterParams,\n  ClusterPoint,\n  ClusterProps,\n} from './overlays.types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAYH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAqBzC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC","sourcesContent":["\n\n/**\n * 高德地图 Expo Module 类型定义统一导出\n * 基于 Expo Modules API 重新设计\n */\n\n// 通用类型\nexport type {\n  Point,\n  LatLng,\n  MapPoi,\n  LatLngBounds,\n  CameraPosition,\n  ColorValue,\n} from './common.types';\n\nexport { MapType } from './common.types';\n\n// 地图视图类型\nexport type {\n  LocationEvent,\n  CameraEvent,\n  MapViewProps,\n  MapViewMethods,\n  MapViewRef,\n} from './map-view.types';\n\n// 定位类型\nexport type {\n  Coordinates,\n  ReGeocode,\n  LocationOptions,\n  LocationListener,\n  GeoLanguage,\n  LocationProtocol,\n} from './location.types';\n\nexport {\n  LocationAccuracy,\n  LocationMode,\n  CoordinateType,\n} from './location.types';\n\n// 覆盖物类型\nexport type {\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n  CircleProps,\n  HeatMapProps,\n  MultiPointItem,\n  MultiPointProps,\n  ClusterParams,\n  ClusterPoint,\n  ClusterProps,\n} from './overlays.types';\n\n//预加载类型\nexport type {\n  PreloadConfig,\n  PreloadStatus,\n  PreloadStrategy,\n  PreloadInstance,\n  UseMapPreloadReturn,\n  MapPreloaderProps\n} from './preload.types';"]}

package/build/types/location.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"location.types.js","sourceRoot":"","sources":["../../src/types/location.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2HH;;;GAGG;AACH,MAAM,CAAN,IAAY,gBA8BX;AA9BD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,iFAAqB,CAAA;IAErB;;OAEG;IACH,uDAAQ,CAAA;IAER;;OAEG;IACH,+EAAoB,CAAA;IAEpB;;OAEG;IACH,yEAAiB,CAAA;IAEjB;;OAEG;IACH,iEAAa,CAAA;IAEb;;OAEG;IACH,6EAAmB,CAAA;AACrB,CAAC,EA9BW,gBAAgB,KAAhB,gBAAgB,QA8B3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,YAeX;AAfD,WAAY,YAAY;IACtB;;OAEG;IACH,+DAAgB,CAAA;IAEhB;;OAEG;IACH,iEAAiB,CAAA;IAEjB;;OAEG;IACH,iEAAiB,CAAA;AACnB,CAAC,EAfW,YAAY,KAAZ,YAAY,QAevB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAwCX;AAxCD,WAAY,cAAc;IACxB;;OAEG;IACH,oDAAS,CAAA;IAET;;OAEG;IACH,qDAAS,CAAA;IAET;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,yDAAW,CAAA;IAEX;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,iDAAO,CAAA;AACT,CAAC,EAxCW,cAAc,KAAd,cAAc,QAwCzB","sourcesContent":["/**\n * 高德地图定位相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { LatLng } from './common.types';\n\n/**\n * 坐标信息（基础定位）\n */\nexport interface Coordinates extends LatLng {\n  /**\n   * 海拔高度（米）\n   */\n  altitude: number;\n\n  /**\n   * 水平精度（米）\n   */\n  accuracy: number;\n\n  /**\n   * 移动方向（度，需要 GPS）\n   */\n  heading: number;\n\n  /**\n   * 移动速度（米/秒，需要 GPS）\n   */\n  speed: number;\n\n  /**\n   * 时间戳\n   */\n  timestamp: number;\n\n  /**\n   * 是否有可用坐标\n   * @platform ios\n   */\n  isAvailableCoordinate?: boolean;\n\n  /**\n   * 格式化地址（仅在启用逆地理编码时可用）\n   */\n  address?: string;\n}\n\n/**\n * 逆地理编码信息\n */\nexport interface ReGeocode extends Coordinates {\n  /**\n   * 格式化地址\n   */\n  address: string;\n\n  /**\n   * 国家\n   */\n  country: string;\n\n  /**\n   * 省/直辖市，如 `湖北省`\n   */\n  province: string;\n\n  /**\n   * 市，如 `武汉市`\n   */\n  city: string;\n\n  /**\n   * 区，如 `武昌区`\n   */\n  district: string;\n\n  /**\n   * 城市编码\n   */\n  cityCode: string;\n\n  /**\n   * 区域编码\n   */\n  adCode: string;\n\n  /**\n   * 街道名称\n   */\n  street: string;\n\n  /**\n   * 门牌号\n   */\n  streetNumber: string;\n\n  /**\n   * 兴趣点名称\n   */\n  poiName: string;\n\n  /**\n   * 所属兴趣点名称\n   */\n  aoiName: string;\n\n  /**\n   * 定位信息描述\n   * @platform android\n   */\n  description?: string;\n\n  /**\n   * 坐标系类型\n   * @platform android\n   */\n  coordType?: 'GCJ02' | 'WGS84';\n\n  /**\n   * 室内定位建筑物ID\n   * @platform android\n   */\n  buildingId?: string;\n}\n\n/**\n * 定位精度级别\n * @platform ios\n */\nexport enum LocationAccuracy {\n  /**\n   * 最适合导航\n   */\n  BestForNavigation = 0,\n\n  /**\n   * 最高精度（约10米，耗时约10秒）\n   */\n  Best = 1,\n\n  /**\n   * 10米精度\n   */\n  NearestTenMeters = 2,\n\n  /**\n   * 100米精度（推荐）\n   */\n  HundredMeters = 3,\n\n  /**\n   * 1公里精度\n   */\n  Kilometer = 4,\n\n  /**\n   * 3公里精度\n   */\n  ThreeKilometers = 5,\n}\n\n/**\n * 定位模式\n * @platform android\n */\nexport enum LocationMode {\n  /**\n   * 高精度模式（网络+卫星）\n   */\n  HighAccuracy = 1,\n\n  /**\n   * 低功耗模式（仅网络）\n   */\n  BatterySaving = 2,\n\n  /**\n   * 仅设备模式（仅卫星）\n   */\n  DeviceSensors = 3,\n}\n\n/**\n * 坐标系类型\n */\nexport enum CoordinateType {\n  /**\n   * 高德坐标系\n   */\n  AMap = -1,\n\n  /**\n   * 百度坐标系\n   */\n  Baidu = 0,\n\n  /**\n   * MapBar坐标系\n   */\n  MapBar = 1,\n\n  /**\n   * MapABC坐标系\n   */\n  MapABC = 2,\n\n  /**\n   * 搜搜地图坐标系\n   */\n  SoSoMap = 3,\n\n  /**\n   * 阿里云坐标系\n   */\n  AliYun = 4,\n\n  /**\n   * 谷歌坐标系\n   */\n  Google = 5,\n\n  /**\n   * GPS坐标系\n   */\n  GPS = 6,\n}\n\n/**\n * 地理语言\n */\nexport type GeoLanguage = 'DEFAULT' | 'EN' | 'ZH';\n\n/**\n * 网络协议\n * @platform android\n */\nexport type LocationProtocol = 'HTTP' | 'HTTPS';\n\n/**\n * 定位配置选项\n */\nexport interface LocationOptions {\n  /**\n   * 是否返回逆地理信息\n   * @default true\n   */\n  withReGeocode?: boolean;\n\n  /**\n   * 定位精度\n   * @platform ios\n   */\n  accuracy?: LocationAccuracy;\n\n  /**\n   * 定位模式\n   * @platform android\n   */\n  mode?: LocationMode;\n\n  /**\n   * 是否单次定位\n   * @platform android\n   * @default false\n   */\n  onceLocation?: boolean;\n\n  /**\n   * 定位间隔（毫秒）\n   * @platform android\n   * @default 2000\n   */\n  interval?: number;\n\n  /**\n   * 定位超时时间（秒）\n   * @platform ios\n   * @default 10\n   */\n  timeout?: number;\n\n  /**\n   * 逆地理编码超时时间（秒）\n   * @platform ios\n   * @default 2\n   */\n  reGeocodeTimeout?: number;\n\n  /**\n   * 最小更新距离（米）\n   * @platform ios\n   */\n  distanceFilter?: number;\n\n  /**\n   * 是否启用设备传感器\n   * @platform android\n   * @default false\n   */\n  sensorEnable?: boolean;\n\n  /**\n   * 是否允许WIFI刷新\n   * @platform android\n   * @default true\n   */\n  wifiScan?: boolean;\n\n  /**\n   * 是否GPS优先\n   * @platform android\n   * @default false\n   */\n  gpsFirst?: boolean;\n\n  /**\n   * 是否等待WIFI列表刷新\n   * 定位精度会更高，但是定位速度会变慢1-3秒\n   * @platform android\n   * @default false\n   */\n  onceLocationLatest?: boolean;\n\n  /**\n   * 逆地理语言\n   */\n  geoLanguage?: GeoLanguage;\n\n  /**\n   * 是否允许后台定位\n   * @default false\n   */\n  allowsBackgroundLocationUpdates?: boolean;\n\n  /**\n   * 是否自动暂停定位\n   * @platform ios\n   * @default false\n   */\n  pausesLocationUpdatesAutomatically?: boolean;\n\n  /**\n   * 是否使用缓存策略\n   * @platform android\n   * @default true\n   */\n  locationCacheEnable?: boolean;\n\n  /**\n   * 网络请求超时时间（毫秒）\n   * @platform android\n   * @default 30000\n   */\n  httpTimeout?: number;\n\n  /**\n   * 网络协议\n   * @platform android\n   * @default 'HTTP'\n   */\n  protocol?: LocationProtocol;\n}\n\n/**\n * 定位事件监听器\n */\nexport type LocationListener = (location: Coordinates | ReGeocode) => void;\n"]}
+{"version":3,"file":"location.types.js","sourceRoot":"","sources":["../../src/types/location.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2HH;;;GAGG;AACH,MAAM,CAAN,IAAY,gBA8BX;AA9BD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,iFAAqB,CAAA;IAErB;;OAEG;IACH,uDAAQ,CAAA;IAER;;OAEG;IACH,+EAAoB,CAAA;IAEpB;;OAEG;IACH,yEAAiB,CAAA;IAEjB;;OAEG;IACH,iEAAa,CAAA;IAEb;;OAEG;IACH,6EAAmB,CAAA;AACrB,CAAC,EA9BW,gBAAgB,KAAhB,gBAAgB,QA8B3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,YAeX;AAfD,WAAY,YAAY;IACtB;;OAEG;IACH,+DAAgB,CAAA;IAEhB;;OAEG;IACH,iEAAiB,CAAA;IAEjB;;OAEG;IACH,iEAAiB,CAAA;AACnB,CAAC,EAfW,YAAY,KAAZ,YAAY,QAevB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAwCX;AAxCD,WAAY,cAAc;IACxB;;OAEG;IACH,oDAAS,CAAA;IAET;;OAEG;IACH,qDAAS,CAAA;IAET;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,yDAAW,CAAA;IAEX;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,iDAAO,CAAA;AACT,CAAC,EAxCW,cAAc,KAAd,cAAc,QAwCzB","sourcesContent":["/**\n * 高德地图定位相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { LatLng } from './common.types';\n\n/**\n * 坐标信息（基础定位）\n */\nexport interface Coordinates extends LatLng {\n  /**\n   * 海拔高度（米）\n   */\n  altitude: number;\n\n  /**\n   * 水平精度（米）\n   */\n  accuracy: number;\n\n  /**\n   * 移动方向（度，需要 GPS）\n   */\n  heading: number;\n\n  /**\n   * 移动速度（米/秒，需要 GPS）\n   */\n  speed: number;\n\n  /**\n   * 时间戳\n   */\n  timestamp: number;\n\n  /**\n   * 是否有可用坐标\n   * @platform ios\n   */\n  isAvailableCoordinate?: boolean;\n\n  /**\n   * 格式化地址（仅在启用逆地理编码时可用）\n   */\n  address?: string;\n}\n\n/**\n * 逆地理编码信息\n */\nexport interface ReGeocode extends Coordinates {\n  /**\n   * 格式化地址\n   */\n  address: string;\n\n  /**\n   * 国家\n   */\n  country: string;\n\n  /**\n   * 省/直辖市，如 `湖北省`\n   */\n  province: string;\n\n  /**\n   * 市，如 `武汉市`\n   */\n  city: string;\n\n  /**\n   * 区，如 `武昌区`\n   */\n  district: string;\n\n  /**\n   * 城市编码\n   */\n  cityCode: string;\n\n  /**\n   * 区域编码\n   */\n  adCode: string;\n\n  /**\n   * 街道名称\n   */\n  street: string;\n\n  /**\n   * 门牌号\n   */\n  streetNumber: string;\n\n  /**\n   * 兴趣点名称\n   */\n  poiName: string;\n\n  /**\n   * 所属兴趣点名称\n   */\n  aoiName: string;\n\n  /**\n   * 定位信息描述\n   * @platform android\n   */\n  description?: string;\n\n  /**\n   * 坐标系类型\n   * @platform android\n   */\n  coordType?: 'GCJ02' | 'WGS84';\n\n  /**\n   * 室内定位建筑物ID\n   * @platform android\n   */\n  buildingId?: string;\n}\n\n/**\n * 定位精度级别\n * @platform ios\n */\nexport enum LocationAccuracy {\n  /**\n   * 最适合导航\n   */\n  BestForNavigation = 0,\n\n  /**\n   * 最高精度（约10米，耗时约10秒）\n   */\n  Best = 1,\n\n  /**\n   * 10米精度\n   */\n  NearestTenMeters = 2,\n\n  /**\n   * 100米精度（推荐）\n   */\n  HundredMeters = 3,\n\n  /**\n   * 1公里精度\n   */\n  Kilometer = 4,\n\n  /**\n   * 3公里精度\n   */\n  ThreeKilometers = 5,\n}\n\n/**\n * 定位模式\n * @platform android\n */\nexport enum LocationMode {\n  /**\n   * 高精度模式（网络+卫星）\n   */\n  HighAccuracy = 1,\n\n  /**\n   * 低功耗模式（仅网络）\n   */\n  BatterySaving = 2,\n\n  /**\n   * 仅设备模式（仅卫星）\n   */\n  DeviceSensors = 3,\n}\n\n/**\n * 坐标系类型\n */\nexport enum CoordinateType {\n  /**\n   * 高德坐标系\n   */\n  AMap = -1,\n\n  /**\n   * 百度坐标系\n   */\n  Baidu = 0,\n\n  /**\n   * MapBar坐标系\n   */\n  MapBar = 1,\n\n  /**\n   * MapABC坐标系\n   */\n  MapABC = 2,\n\n  /**\n   * 搜搜地图坐标系\n   */\n  SoSoMap = 3,\n\n  /**\n   * 阿里云坐标系\n   */\n  AliYun = 4,\n\n  /**\n   * 谷歌坐标系\n   */\n  Google = 5,\n\n  /**\n   * GPS坐标系\n   */\n  GPS = 6,\n}\n\n/**\n * 地理语言\n */\nexport type GeoLanguage = 'DEFAULT' | 'EN' | 'ZH';\n\n/**\n * 网络协议\n * @platform android\n */\nexport type LocationProtocol = 'HTTP' | 'HTTPS';\n\n/**\n * 定位配置选项\n */\nexport interface LocationOptions {\n  /**\n   * 是否返回逆地理信息\n   * @default true\n   */\n  withReGeocode?: boolean;\n\n  /**\n   * 定位精度\n   * @platform ios\n   */\n  accuracy?: LocationAccuracy;\n\n  /**\n   * 定位模式\n   * @platform android\n   */\n  mode?: LocationMode;\n\n  /**\n   * 是否单次定位\n   * @platform android\n   * @default false\n   */\n  onceLocation?: boolean;\n\n  /**\n   * 定位间隔（毫秒）\n   * @platform android\n   * @default 2000\n   */\n  interval?: number;\n\n  /**\n   * 定位超时时间（秒）\n   * @platform ios\n   * @default 10\n   */\n  timeout?: number;\n\n  /**\n   * 逆地理编码超时时间（秒）\n   * @platform ios\n   * @default 2\n   */\n  reGeocodeTimeout?: number;\n\n  /**\n   * 最小更新距离（米）\n   * @platform ios\n   */\n  distanceFilter?: number;\n\n  /**\n   * 是否启用设备传感器\n   * @platform android\n   * @default false\n   */\n  sensorEnable?: boolean;\n\n  /**\n   * 是否允许WIFI刷新\n   * @platform android\n   * @default true\n   */\n  wifiScan?: boolean;\n\n  /**\n   * 是否GPS优先\n   * @platform android\n   * @default false\n   */\n  gpsFirst?: boolean;\n\n  /**\n   * 是否等待WIFI列表刷新\n   * 定位精度会更高，但是定位速度会变慢1-3秒\n   * @platform android\n   * @default false\n   */\n  onceLocationLatest?: boolean;\n\n  /**\n   * 逆地理语言\n   */\n  geoLanguage?: GeoLanguage;\n\n  /**\n   * 是否允许后台定位\n   * @default false\n   */\n  allowsBackgroundLocationUpdates?: boolean;\n\n  /**\n   * 是否自动暂停定位\n   * @platform ios\n   * @default false\n   */\n  pausesLocationUpdatesAutomatically?: boolean;\n\n  /**\n   * 是否使用缓存策略\n   * @platform android\n   * @default true\n   */\n  locationCacheEnable?: boolean;\n\n  /**\n   * 网络请求超时时间（毫秒）\n   * @platform android\n   * @default 30000\n   */\n  httpTimeout?: number;\n\n  /**\n   * 网络协议\n   * @platform android\n   * @default 'HTTP'\n   */\n  protocol?: LocationProtocol;\n}\n\n/**\n * 定位事件监听器\n */\nexport type LocationListener = (location: Coordinates | ReGeocode) => void;\n\n\n\n\n"]}

package/build/types/map-view.types.d.ts

@@ -81,6 +81,37 @@ export interface MapViewProps {
         imageWidth?: number;
         /** 定位图标高度(像素) */
         imageHeight?: number;
+        /**
+         * 是否显示定位蓝点 @default true
+         * - iOS: 对应 mapView.showsUserLocation
+         * - Android: 对应 MyLocationStyle.showMyLocation() (5.1.0+)
+         */
+        showMyLocation?: boolean;
+        /** 定位图标锚点 U 坐标 (0.0-1.0) @platform android */
+        anchorU?: number;
+        /** 定位图标锚点 V 坐标 (0.0-1.0) @platform android */
+        anchorV?: number;
+        /**
+         * 定位蓝点展现模式 @platform android
+         * @default 'LOCATION_ROTATE' (连续定位、定位点旋转、移动到中心)
+         *
+         * 🧭 **方向指示说明**：
+         * - Android 通过 locationType 实现方向指示（定位点依照设备方向旋转）
+         * - iOS 通过 showsHeadingIndicator 实现方向指示（显示扇形方向指示器）
+         *
+         * 📱 **Android 方向指示模式**（推荐使用以下两种）：
+         * - 'LOCATION_ROTATE': 定位点依照设备方向旋转，视角跟随移动到中心（默认）⭐
+         * - 'LOCATION_ROTATE_NO_CENTER': 定位点依照设备方向旋转，视角不移动到中心 ⭐
+         *
+         * 🗺️ **其他模式**：
+         * - 'SHOW': 只定位一次
+         * - 'LOCATE': 定位一次，且将视角移动到地图中心点
+         * - 'FOLLOW': 连续定位、跟随移动，但定位点不旋转
+         * - 'MAP_ROTATE': 地图依照设备方向旋转（而非定位点旋转）
+         * - 'FOLLOW_NO_CENTER': 连续定位、不移动到中心，定位点不旋转
+         * - 'MAP_ROTATE_NO_CENTER': 地图依照设备方向旋转，不移动到中心
+         */
+        locationType?: 'SHOW' | 'LOCATE' | 'FOLLOW' | 'MAP_ROTATE' | 'LOCATION_ROTATE' | 'LOCATION_ROTATE_NO_CENTER' | 'FOLLOW_NO_CENTER' | 'MAP_ROTATE_NO_CENTER';
     };
     /**
      * 是否显示室内地图
@@ -151,6 +182,32 @@ export interface MapViewProps {
      * @platform ios
      */
     headingFilter?: number;
+    /**
+     * 自定义地图样式
+     *
+     * 支持两种方式：
+     * 1. 在线样式：提供 styleId（从高德开放平台获取）
+     * 2. 本地样式：提供 styleDataPath 和可选的 extraStyleDataPath
+     *
+     * @example
+     * // 使用在线样式
+     * customMapStyle={{ styleId: "your-style-id" }}
+     *
+     * @example
+     * // 使用本地样式文件
+     * customMapStyle={{
+     *   styleDataPath: "path/to/style.data",
+     *   extraStyleDataPath: "path/to/extra.data"
+     * }}
+     */
+    customMapStyle?: {
+        /** 在线样式ID（从高德开放平台获取） */
+        styleId?: string;
+        /** 本地样式文件路径 */
+        styleDataPath?: string;
+        /** 额外样式文件路径（可选） */
+        extraStyleDataPath?: string;
+    };
     /**
      * 样式
      */

package/build/types/map-view.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-view.types.d.ts","sourceRoot":"","sources":["../../src/types/map-view.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"map-view.types.d.ts","sourceRoot":"","sources":["../../src/types/map-view.types.ts"],"names":[],"mappings":"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"}

package/build/types/map-view.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-view.types.js","sourceRoot":"","sources":["../../src/types/map-view.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图视图相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { StyleProp, ViewStyle, NativeSyntheticEvent } from 'react-native';\nimport type { CameraPosition, LatLng, LatLngBounds, MapPoi, MapType, Point } from './common.types';\n\n/**\n * 定位事件数据\n */\nexport interface LocationEvent {\n  /**\n   * 纬度\n   */\n  latitude: number;\n  \n  /**\n   * 经度\n   */\n  longitude: number;\n  \n  /**\n   * 定位精度（米）\n   */\n  accuracy: number;\n}\n\n\n/**\n * 地图相机事件\n */\nexport interface CameraEvent {\n  /**\n   * 相机位置\n   */\n  cameraPosition: CameraPosition;\n\n  /**\n   * 可见区域边界\n   */\n  latLngBounds: LatLngBounds;\n}\n\n/**\n * 地图视图属性\n */\nexport interface MapViewProps {\n  /**\n   * 地图类型\n   */\n  mapType?: MapType;\n\n  /**\n   * 初始相机位置\n   */\n  initialCameraPosition?: CameraPosition;\n\n  /**\n   * 是否显示当前定位\n   */\n  myLocationEnabled?: boolean;\n\n  /**\n   * 是否跟随用户位置\n   * @default false\n   */\n  followUserLocation?: boolean;\n\n  /**\n   * 定位蓝点配置\n   */\n  userLocationRepresentation?: {\n    /** 精度圈是否显示 @default true */\n    showsAccuracyRing?: boolean;\n    /** 是否显示方向指示 @default true @platform ios */\n    showsHeadingIndicator?: boolean;\n    /** 精度圈填充颜色 支持 '#RRGGBB'、'red' 或 ARGB 数字 */\n    fillColor?: string | number;\n    /** 精度圈边线颜色 */\n    strokeColor?: string | number;\n    /** 精度圈边线宽度 @default 0 */\n    lineWidth?: number;\n    /** 内部蓝色圆点是否使用律动效果 @default true @platform ios */\n    enablePulseAnimation?: boolean;\n    /** 定位点背景色 @default 'white' @platform ios */\n    locationDotBgColor?: string | number;\n    /** 定位点蓝色圆点颜色 @default 'blue' @platform ios */\n    locationDotFillColor?: string | number;\n    /** 定位图标 支持网络图片(http/https)、本地文件(file://)或资源名称 */\n    image?: string;\n    /** 定位图标宽度(像素) */\n    imageWidth?: number;\n    /** 定位图标高度(像素) */\n    imageHeight?: number;\n  };\n\n  /**\n   * 是否显示室内地图\n   * \n   */\n  indoorViewEnabled?: boolean;\n\n  /**\n   * 是否显示3D建筑\n   */\n  buildingsEnabled?: boolean;\n\n  /**\n   * 是否显示标注\n   */\n  labelsEnabled?: boolean;\n\n  /**\n   * 是否显示指南针\n   */\n  compassEnabled?: boolean;\n\n  /**\n   * 是否显示缩放按钮\n   * @platform android\n   */\n  zoomControlsEnabled?: boolean;\n\n  /**\n   * 是否显示比例尺\n   */\n  scaleControlsEnabled?: boolean;\n\n  /**\n   * 是否显示定位按钮\n   * @platform android\n   */\n  myLocationButtonEnabled?: boolean;\n\n  /**\n   * 是否显示路况\n   */\n  trafficEnabled?: boolean;\n\n  /**\n   * 最大缩放级别\n   */\n  maxZoom?: number;\n\n  /**\n   * 最小缩放级别\n   */\n  minZoom?: number;\n\n  /**\n   * 是否启用缩放手势\n   */\n  zoomGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用滑动手势\n   */\n  scrollGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用旋转手势\n   */\n  rotateGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用倾斜手势\n   */\n  tiltGesturesEnabled?: boolean;\n\n  /**\n   * 定位的最小更新距离（米）\n   * @platform ios\n   */\n  distanceFilter?: number;\n\n  /**\n   * 最小更新角度（度）\n   * @platform ios\n   */\n  headingFilter?: number;\n\n  /**\n   * 样式\n   */\n  style?: StyleProp<ViewStyle>;\n\n  /**\n   * 点击地图事件\n   */\n  onMapPress?: (event: NativeSyntheticEvent<LatLng>) => void;\n\n  /**\n   * 点击标注点事件\n   */\n  onPressPoi?: (event: NativeSyntheticEvent<MapPoi>) => void;\n\n  /**\n   * 长按地图事件\n   */\n  onMapLongPress?: (event: NativeSyntheticEvent<LatLng>) => void;\n\n  /**\n   * 地图状态改变事件（实时触发）\n   */\n  onCameraMove?: (event: NativeSyntheticEvent<CameraEvent>) => void;\n\n  /**\n   * 地图状态改变完成事件\n   */\n  onCameraIdle?: (event: NativeSyntheticEvent<CameraEvent>) => void;\n\n  /**\n   * 地图加载完成事件\n   */\n  onLoad?: (event: NativeSyntheticEvent<{}>) => void;\n\n  /**\n   * 地图定位更新事件\n   */\n  onLocation?: (event: NativeSyntheticEvent<LocationEvent>) => void;\n\n  /**\n   * 子组件\n   */\n  children?: React.ReactNode;\n}\n\n/**\n * 地图视图方法\n */\nexport interface MapViewMethods {\n  /**\n   * 移动相机\n   * @param cameraPosition 目标相机位置\n   * @param duration 动画时长（毫秒）\n   */\n  moveCamera(cameraPosition: CameraPosition, duration?: number): void;\n\n  /**\n   * 将屏幕坐标转换为地理坐标\n   * @param point 屏幕坐标\n   * @returns 地理坐标\n   */\n  getLatLng(point: Point): Promise<LatLng>;\n\n  /**\n   * 设置地图中心点\n   * @param center 中心点\n   * @param animated 是否启用动画\n   */\n  setCenter(center: LatLng, animated?: boolean): void;\n\n  /**\n   * 设置地图缩放级别\n   * @param zoom 缩放级别\n   * @param animated 是否启用动画\n   */\n  setZoom(zoom: number, animated?: boolean): void;\n\n  /**\n   * 获取相机位置\n   * @returns 相机位置\n   */\n  getCameraPosition(): Promise<CameraPosition>;\n\n  \n}\n\n/**\n * MapView Ref 公开接口（用户使用）\n */\nexport interface MapViewRef {\n  moveCamera(position: CameraPosition, duration?: number): Promise<void>;\n  getLatLng(point: Point): Promise<LatLng>;\n  setCenter(center: LatLng, animated?: boolean): Promise<void>;\n  setZoom(zoom: number, animated?: boolean): Promise<void>;\n  getCameraPosition(): Promise<CameraPosition>;\n\n}\n\n"]}
+{"version":3,"file":"map-view.types.js","sourceRoot":"","sources":["../../src/types/map-view.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图视图相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { StyleProp, ViewStyle, NativeSyntheticEvent } from 'react-native';\nimport type { CameraPosition, LatLng, LatLngBounds, MapPoi, MapType, Point } from './common.types';\n\n/**\n * 定位事件数据\n */\nexport interface LocationEvent {\n  /**\n   * 纬度\n   */\n  latitude: number;\n  \n  /**\n   * 经度\n   */\n  longitude: number;\n  \n  /**\n   * 定位精度（米）\n   */\n  accuracy: number;\n}\n\n\n/**\n * 地图相机事件\n */\nexport interface CameraEvent {\n  /**\n   * 相机位置\n   */\n  cameraPosition: CameraPosition;\n\n  /**\n   * 可见区域边界\n   */\n  latLngBounds: LatLngBounds;\n}\n\n/**\n * 地图视图属性\n */\nexport interface MapViewProps {\n  /**\n   * 地图类型\n   */\n  mapType?: MapType;\n\n  /**\n   * 初始相机位置\n   */\n  initialCameraPosition?: CameraPosition;\n\n  /**\n   * 是否显示当前定位\n   */\n  myLocationEnabled?: boolean;\n\n  /**\n   * 是否跟随用户位置\n   * @default false\n   */\n  followUserLocation?: boolean;\n\n  /**\n   * 定位蓝点配置\n   */\n  userLocationRepresentation?: {\n    /** 精度圈是否显示 @default true */\n    showsAccuracyRing?: boolean;\n    /** 是否显示方向指示 @default true @platform ios */\n    showsHeadingIndicator?: boolean;\n    /** 精度圈填充颜色 支持 '#RRGGBB'、'red' 或 ARGB 数字 */\n    fillColor?: string | number;\n    /** 精度圈边线颜色 */\n    strokeColor?: string | number;\n    /** 精度圈边线宽度 @default 0 */\n    lineWidth?: number;\n    /** 内部蓝色圆点是否使用律动效果 @default true @platform ios */\n    enablePulseAnimation?: boolean;\n    /** 定位点背景色 @default 'white' @platform ios */\n    locationDotBgColor?: string | number;\n    /** 定位点蓝色圆点颜色 @default 'blue' @platform ios */\n    locationDotFillColor?: string | number;\n    /** 定位图标 支持网络图片(http/https)、本地文件(file://)或资源名称 */\n    image?: string;\n    /** 定位图标宽度(像素) */\n    imageWidth?: number;\n    /** 定位图标高度(像素) */\n    imageHeight?: number;\n    /**\n     * 是否显示定位蓝点 @default true\n     * - iOS: 对应 mapView.showsUserLocation\n     * - Android: 对应 MyLocationStyle.showMyLocation() (5.1.0+)\n     */\n    showMyLocation?: boolean;\n    /** 定位图标锚点 U 坐标 (0.0-1.0) @platform android */\n    anchorU?: number;\n    /** 定位图标锚点 V 坐标 (0.0-1.0) @platform android */\n    anchorV?: number;\n    /**\n     * 定位蓝点展现模式 @platform android\n     * @default 'LOCATION_ROTATE' (连续定位、定位点旋转、移动到中心)\n     *\n     * 🧭 **方向指示说明**：\n     * - Android 通过 locationType 实现方向指示（定位点依照设备方向旋转）\n     * - iOS 通过 showsHeadingIndicator 实现方向指示（显示扇形方向指示器）\n     *\n     * 📱 **Android 方向指示模式**（推荐使用以下两种）：\n     * - 'LOCATION_ROTATE': 定位点依照设备方向旋转，视角跟随移动到中心（默认）⭐\n     * - 'LOCATION_ROTATE_NO_CENTER': 定位点依照设备方向旋转，视角不移动到中心 ⭐\n     *\n     * 🗺️ **其他模式**：\n     * - 'SHOW': 只定位一次\n     * - 'LOCATE': 定位一次，且将视角移动到地图中心点\n     * - 'FOLLOW': 连续定位、跟随移动，但定位点不旋转\n     * - 'MAP_ROTATE': 地图依照设备方向旋转（而非定位点旋转）\n     * - 'FOLLOW_NO_CENTER': 连续定位、不移动到中心，定位点不旋转\n     * - 'MAP_ROTATE_NO_CENTER': 地图依照设备方向旋转，不移动到中心\n     */\n    locationType?: 'SHOW' | 'LOCATE' | 'FOLLOW' | 'MAP_ROTATE' | 'LOCATION_ROTATE' |\n                   'LOCATION_ROTATE_NO_CENTER' | 'FOLLOW_NO_CENTER' | 'MAP_ROTATE_NO_CENTER';\n  };\n\n  /**\n   * 是否显示室内地图\n   * \n   */\n  indoorViewEnabled?: boolean;\n\n  /**\n   * 是否显示3D建筑\n   */\n  buildingsEnabled?: boolean;\n\n  /**\n   * 是否显示标注\n   */\n  labelsEnabled?: boolean;\n\n  /**\n   * 是否显示指南针\n   */\n  compassEnabled?: boolean;\n\n  /**\n   * 是否显示缩放按钮\n   * @platform android\n   */\n  zoomControlsEnabled?: boolean;\n\n  /**\n   * 是否显示比例尺\n   */\n  scaleControlsEnabled?: boolean;\n\n  /**\n   * 是否显示定位按钮\n   * @platform android\n   */\n  myLocationButtonEnabled?: boolean;\n\n  /**\n   * 是否显示路况\n   */\n  trafficEnabled?: boolean;\n\n  /**\n   * 最大缩放级别\n   */\n  maxZoom?: number;\n\n  /**\n   * 最小缩放级别\n   */\n  minZoom?: number;\n\n  /**\n   * 是否启用缩放手势\n   */\n  zoomGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用滑动手势\n   */\n  scrollGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用旋转手势\n   */\n  rotateGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用倾斜手势\n   */\n  tiltGesturesEnabled?: boolean;\n\n  /**\n   * 定位的最小更新距离（米）\n   * @platform ios\n   */\n  distanceFilter?: number;\n\n  /**\n   * 最小更新角度（度）\n   * @platform ios\n   */\n  headingFilter?: number;\n\n  /**\n   * 自定义地图样式\n   *\n   * 支持两种方式：\n   * 1. 在线样式：提供 styleId（从高德开放平台获取）\n   * 2. 本地样式：提供 styleDataPath 和可选的 extraStyleDataPath\n   *\n   * @example\n   * // 使用在线样式\n   * customMapStyle={{ styleId: \"your-style-id\" }}\n   *\n   * @example\n   * // 使用本地样式文件\n   * customMapStyle={{\n   *   styleDataPath: \"path/to/style.data\",\n   *   extraStyleDataPath: \"path/to/extra.data\"\n   * }}\n   */\n  customMapStyle?: {\n    /** 在线样式ID（从高德开放平台获取） */\n    styleId?: string;\n    /** 本地样式文件路径 */\n    styleDataPath?: string;\n    /** 额外样式文件路径（可选） */\n    extraStyleDataPath?: string;\n  };\n\n  /**\n   * 样式\n   */\n  style?: StyleProp<ViewStyle>;\n\n  /**\n   * 点击地图事件\n   */\n  onMapPress?: (event: NativeSyntheticEvent<LatLng>) => void;\n\n  /**\n   * 点击标注点事件\n   */\n  onPressPoi?: (event: NativeSyntheticEvent<MapPoi>) => void;\n\n  /**\n   * 长按地图事件\n   */\n  onMapLongPress?: (event: NativeSyntheticEvent<LatLng>) => void;\n\n  /**\n   * 地图状态改变事件（实时触发）\n   */\n  onCameraMove?: (event: NativeSyntheticEvent<CameraEvent>) => void;\n\n  /**\n   * 地图状态改变完成事件\n   */\n  onCameraIdle?: (event: NativeSyntheticEvent<CameraEvent>) => void;\n\n  /**\n   * 地图加载完成事件\n   */\n  onLoad?: (event: NativeSyntheticEvent<{}>) => void;\n\n  /**\n   * 地图定位更新事件\n   */\n  onLocation?: (event: NativeSyntheticEvent<LocationEvent>) => void;\n\n  /**\n   * 子组件\n   */\n  children?: React.ReactNode;\n}\n\n\n/**\n * 地图视图方法\n */\nexport interface MapViewMethods {\n  /**\n   * 移动相机\n   * @param cameraPosition 目标相机位置\n   * @param duration 动画时长（毫秒）\n   */\n  moveCamera(cameraPosition: CameraPosition, duration?: number): void;\n\n  /**\n   * 将屏幕坐标转换为地理坐标\n   * @param point 屏幕坐标\n   * @returns 地理坐标\n   */\n  getLatLng(point: Point): Promise<LatLng>;\n\n  /**\n   * 设置地图中心点\n   * @param center 中心点\n   * @param animated 是否启用动画\n   */\n  setCenter(center: LatLng, animated?: boolean): void;\n\n  /**\n   * 设置地图缩放级别\n   * @param zoom 缩放级别\n   * @param animated 是否启用动画\n   */\n  setZoom(zoom: number, animated?: boolean): void;\n\n  /**\n   * 获取相机位置\n   * @returns 相机位置\n   */\n  getCameraPosition(): Promise<CameraPosition>;\n\n  \n}\n\n/**\n * MapView Ref 公开接口（用户使用）\n */\nexport interface MapViewRef {\n  moveCamera(position: CameraPosition, duration?: number): Promise<void>;\n  getLatLng(point: Point): Promise<LatLng>;\n  setCenter(center: LatLng, animated?: boolean): Promise<void>;\n  setZoom(zoom: number, animated?: boolean): Promise<void>;\n  getCameraPosition(): Promise<CameraPosition>;\n\n}\n\n"]}

package/build/types/preload.types.d.ts

@@ -0,0 +1,83 @@
+import { MapViewProps } from "./map-view.types";
+/**
+ * 预加载配置
+ */
+export interface PreloadConfig {
+    /** 预加载的地图数量，默认为 1 */
+    poolSize?: number;
+    /** 预加载延迟时间（毫秒），默认为 0（立即预加载） */
+    delay?: number;
+    /** 是否启用预加载，默认为 true */
+    enabled?: boolean;
+    /** 预加载超时时间（毫秒），默认为 15000（15秒） */
+    timeout?: number;
+    /** 预加载策略：'native' | 'js' | 'auto' | 'hybrid'，默认为 'auto' */
+    strategy?: PreloadStrategy;
+    /** 超时后是否自动回退到 JS 预加载，默认为 true */
+    fallbackOnTimeout?: boolean;
+}
+/**
+ * 预加载状态
+ */
+export type PreloadStatus = 'idle' | 'loading' | 'ready' | 'error';
+/**
+ * 预加载策略
+ * - 'native': 仅使用原生预加载
+ * - 'js': 仅使用 JS 层预加载
+ * - 'auto': 自动选择（优先原生，不可用时用 JS）
+ * - 'hybrid': 同时启动原生和 JS，谁先完成用谁（最快最可靠）
+ */
+export type PreloadStrategy = 'native' | 'js' | 'auto' | 'hybrid';
+/**
+ * 预加载实例信息
+ */
+export interface PreloadInstance {
+    id: string;
+    status: PreloadStatus;
+    timestamp: number;
+    error?: Error;
+}
+/**
+ * Hook 返回值
+ */
+export interface UseMapPreloadReturn {
+    /** 当前预加载状态 */
+    status: PreloadStatus;
+    /** 是否正在预加载 */
+    isLoading: boolean;
+    /** 是否已准备就绪 */
+    isReady: boolean;
+    /** 是否发生错误 */
+    hasError: boolean;
+    /** 预加载统计信息 */
+    stats: {
+        total: number;
+        ready: number;
+        loading: number;
+        error: number;
+    };
+    /** 手动开始预加载 */
+    startPreload: () => void;
+    /** 停止预加载 */
+    stopPreload: () => void;
+    /** 清理预加载实例 */
+    clearInstances: () => void;
+    /** 获取一个预加载实例 */
+    getPreloadedInstance: () => string | null;
+}
+/**
+ * 预加载组件属性
+ */
+export interface MapPreloaderProps {
+    /** 预加载配置 */
+    config?: PreloadConfig;
+    /** 预加载的地图视图属性 */
+    mapProps?: Partial<MapViewProps>;
+    /** 是否启用预加载，默认为 true */
+    enabled?: boolean;
+    /** 预加载完成回调 */
+    onPreloadComplete?: () => void;
+    /** 预加载失败回调 */
+    onPreloadError?: (error: Error) => void;
+}
+//# sourceMappingURL=preload.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preload.types.d.ts","sourceRoot":"","sources":["../../src/types/preload.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAGD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc;IACd,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc;IACd,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY;IACZ,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc;IACd,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB;IAChB,oBAAoB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC3C;AAGD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACjC,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc;IACd,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC"}

package/build/types/preload.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preload.types.js.map

package/build/types/preload.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.types.js","sourceRoot":"","sources":["../../src/types/preload.types.ts"],"names":[],"mappings":"","sourcesContent":["import { MapViewProps } from \"./map-view.types\";\n\n/**\n * 预加载配置\n */\nexport interface PreloadConfig {\n  /** 预加载的地图数量，默认为 1 */\n  poolSize?: number;\n  /** 预加载延迟时间（毫秒），默认为 0（立即预加载） */\n  delay?: number;\n  /** 是否启用预加载，默认为 true */\n  enabled?: boolean;\n  /** 预加载超时时间（毫秒），默认为 15000（15秒） */\n  timeout?: number;\n  /** 预加载策略：'native' | 'js' | 'auto' | 'hybrid'，默认为 'auto' */\n  strategy?: PreloadStrategy;\n  /** 超时后是否自动回退到 JS 预加载，默认为 true */\n  fallbackOnTimeout?: boolean;\n}\n\n/**\n * 预加载状态\n */\nexport type PreloadStatus = 'idle' | 'loading' | 'ready' | 'error';\n\n/**\n * 预加载策略\n * - 'native': 仅使用原生预加载\n * - 'js': 仅使用 JS 层预加载\n * - 'auto': 自动选择（优先原生，不可用时用 JS）\n * - 'hybrid': 同时启动原生和 JS，谁先完成用谁（最快最可靠）\n */\nexport type PreloadStrategy = 'native' | 'js' | 'auto' | 'hybrid';\n\n/**\n * 预加载实例信息\n */\nexport interface PreloadInstance {\n  id: string;\n  status: PreloadStatus;\n  timestamp: number;\n  error?: Error;\n}\n\n\n/**\n * Hook 返回值\n */\nexport interface UseMapPreloadReturn {\n  /** 当前预加载状态 */\n  status: PreloadStatus;\n  /** 是否正在预加载 */\n  isLoading: boolean;\n  /** 是否已准备就绪 */\n  isReady: boolean;\n  /** 是否发生错误 */\n  hasError: boolean;\n  /** 预加载统计信息 */\n  stats: {\n    total: number;\n    ready: number;\n    loading: number;\n    error: number;\n  };\n  /** 手动开始预加载 */\n  startPreload: () => void;\n  /** 停止预加载 */\n  stopPreload: () => void;\n  /** 清理预加载实例 */\n  clearInstances: () => void;\n  /** 获取一个预加载实例 */\n  getPreloadedInstance: () => string | null;\n}\n\n\n/**\n * 预加载组件属性\n */\nexport interface MapPreloaderProps {\n  /** 预加载配置 */\n  config?: PreloadConfig;\n  /** 预加载的地图视图属性 */\n  mapProps?: Partial<MapViewProps>;\n  /** 是否启用预加载，默认为 true */\n  enabled?: boolean;\n  /** 预加载完成回调 */\n  onPreloadComplete?: () => void;\n  /** 预加载失败回调 */\n  onPreloadError?: (error: Error) => void;\n}"]}

package/build/utils/MapPreloader.d.ts

@@ -4,35 +4,7 @@
  * - 如果原生预加载可用，优先使用原生方案（性能提升 60-80%）
  * - 否则回退到 JS 层预加载（性能提升 5-25%）
  */
-/**
- * 预加载配置
- */
-export interface PreloadConfig {
-    /** 预加载的地图数量，默认为 1 */
-    poolSize?: number;
-    /** 预加载延迟时间（毫秒），默认为 0（立即预加载） */
-    delay?: number;
-    /** 是否启用预加载，默认为 true */
-    enabled?: boolean;
-    /** 预加载超时时间（毫秒），默认为 15000（15秒） */
-    timeout?: number;
-    /** 预加载策略：'native' | 'js' | 'auto' | 'hybrid'，默认为 'auto' */
-    strategy?: PreloadStrategy;
-    /** 超时后是否自动回退到 JS 预加载，默认为 true */
-    fallbackOnTimeout?: boolean;
-}
-/**
- * 预加载状态
- */
-export type PreloadStatus = 'idle' | 'loading' | 'ready' | 'error';
-/**
- * 预加载策略
- * - 'native': 仅使用原生预加载
- * - 'js': 仅使用 JS 层预加载
- * - 'auto': 自动选择（优先原生，不可用时用 JS）
- * - 'hybrid': 同时启动原生和 JS，谁先完成用谁（最快最可靠）
- */
-export type PreloadStrategy = 'native' | 'js' | 'auto' | 'hybrid';
+import { PreloadConfig, PreloadStatus } from "../types/preload.types";
 /**
  * 地图预加载管理器类
  * 单例模式，管理地图实例的预加载
@@ -50,6 +22,7 @@ declare class MapPreloaderManager {
     private isPreloading;
     private activeCheckInterval;
     private activeTimeoutTimer;
+    private performanceMetrics;
     private constructor();
     /**
      * 检测并处理热重载
@@ -72,6 +45,14 @@ declare class MapPreloaderManager {
      * 检查原生预加载是否可用
      */
     private checkNativePreloadAvailable;
+    /**
+     * 清理过期的预加载实例
+     */
+    private cleanupExpiredInstances;
+    /**
+     * 记录性能指标
+     */
+    private recordPerformanceMetric;
     /**
      * 获取当前配置
      */
@@ -130,6 +111,22 @@ declare class MapPreloaderManager {
      * 检查原生预加载是否可用
      */
     isNativePreloadAvailable(): boolean;
+    /**
+     * 获取性能统计信息
+     */
+    getPerformanceMetrics(): {
+        successRate: number;
+        totalPreloads: number;
+        successfulPreloads: number;
+        failedPreloads: number;
+        nativePreloads: number;
+        jsPreloads: number;
+        hybridPreloads: number;
+        averageDuration: number;
+        totalDuration: number;
+        instancesUsed: number;
+        instancesExpired: number;
+    };
     /**
      * 获取预加载实例数量统计
      */

package/build/utils/MapPreloader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapPreloader.d.ts","sourceRoot":"","sources":["../../src/utils/MapPreloader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MapPreloader.d.ts","sourceRoot":"","sources":["../../src/utils/MapPreloader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,aAAa,EAAkB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAWvG;;;GAGG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,MAAM,CAYZ;IACF,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,sBAAsB,CAAwB;IACtD,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,SAAS,CAAmD;IACpE,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,mBAAmB,CAA+C;IAC1E,OAAO,CAAC,kBAAkB,CAA8C;IAGxE,OAAO,CAAC,kBAAkB,CAWxB;IAEF,OAAO;IAUP;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgBhC;;OAEG;WACW,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAY7C;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAI3C;;;OAGG;IACI,YAAY,IAAI,IAAI;IAkC3B;;OAEG;YACW,oBAAoB;IA6ClC;;OAEG;YACW,0BAA0B;IA6ExC;;OAEG;YACW,sBAAsB;IAiDpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;YACW,oBAAoB;IA6GlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACI,WAAW,IAAI,IAAI;IAS1B;;OAEG;IACI,uBAAuB,IAAI,IAAI;IAOtC;;;OAGG;IACI,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAuB5C;;OAEG;IACI,SAAS,IAAI,aAAa;IAwCjC;;OAEG;IACI,kBAAkB,IAAI,QAAQ,GAAG,IAAI,GAAG,QAAQ;IAIvD;;OAEG;IACI,wBAAwB,IAAI,OAAO;IAO1C;;OAEG;IACI,qBAAqB;;;;;;;;;;;;;IAS5B;;OAEG;IACI,QAAQ,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAAC;KACtC;IAmDD;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAOzE;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,qBAAoC,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAKvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}