@baidumap/vue-bmap 1.0.0

package/dist/composables/index.d.ts

@@ -0,0 +1,12 @@
+export { useMap } from './useMap';
+export { useMapEvent } from './useMapEvent';
+export { useMapReady } from './useMapReady';
+export { useDriver } from './useDriver';
+export { useMapRef } from './useMapRef';
+export { useCapabilities } from './useCapabilities';
+export { useSymbol } from './useSymbol';
+export { useIcon } from './useIcon';
+export { useGeocoder } from './useGeocoder';
+export type { GeocoderHookResult } from './useGeocoder';
+export { useServiceTimeout, serviceTimeoutError, SERVICE_TIMEOUT_MS } from './useServiceTimeout';
+export type { ServiceTimeoutControl } from './useServiceTimeout';

package/dist/composables/useCapabilities.d.ts

@@ -0,0 +1,5 @@
+import { ComputedRef } from 'vue';
+import { Capability } from '../types';
+
+/** 显式能力检测（driver 内部已自动处理；这里用于提前分支）。响应式集合。 */
+export declare function useCapabilities(): ComputedRef<ReadonlySet<Capability>>;

package/dist/composables/useDriver.d.ts

@@ -0,0 +1,5 @@
+import { ComputedRef } from 'vue';
+import { BMapDriver } from '../drivers/types';
+
+/** 拿当前版本的 driver（响应式，未就绪时为 null）。做版本/能力分支或用 rawSDK 取原生命名空间。 */
+export declare function useDriver(): ComputedRef<BMapDriver | null>;

package/dist/composables/useGeocoder.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+import { Point } from '../types';
+import { GeocoderResult } from '../types/results';
+
+export interface GeocoderHookResult {
+    data: Ref<GeocoderResult | Point | undefined>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    getPoint: (address: string, city?: string) => void;
+    getLocation: (point: Point, options?: unknown) => void;
+    getPoints: (addresses: string[], city?: string) => Promise<(Point | null)[]>;
+    getLocations: (points: Point[], options?: unknown) => Promise<(GeocoderResult | null)[]>;
+    setOptions: (options: Record<string, unknown>) => void;
+    cancel: () => void;
+}
+export declare function useGeocoder(): GeocoderHookResult;

package/dist/composables/useIcon.d.ts

@@ -0,0 +1,5 @@
+import { ShallowRef } from 'vue';
+import { OverlayHandle } from '../types';
+import { IconProps } from '../components/Overlay/types';
+
+export declare function useIcon(props: IconProps): ShallowRef<OverlayHandle | null>;

package/dist/composables/useMap.d.ts

@@ -0,0 +1,8 @@
+import { ComputedRef } from 'vue';
+import { MapHandle } from '../types';
+
+/**
+ * 拿当前 <Map> 的 MapHandle（响应式，可能为 null）。
+ * 地图首帧渲染完成前为 null；<Map> 内部子组件拿到时通常已就绪。
+ */
+export declare function useMap(): ComputedRef<MapHandle | null>;

package/dist/composables/useMapEvent.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 订阅 Map 事件。handler 始终读最新引用；map 就绪后自动绑定，卸载时退订。
+ */
+export declare function useMapEvent(type: string, handler: (raw: unknown) => void): void;

package/dist/composables/useMapReady.d.ts

@@ -0,0 +1,11 @@
+import { MapHandle } from '../types';
+
+/**
+ * 哨兵 composable：在 `<Map>` **内部**使用，地图就绪后回调，把 MapHandle 上提到外层。
+ *
+ * 典型用途：service composable 挂在 `<Map>` 外层时，其 renderOptions.map 需要一个已就绪的 handle。
+ * 与 `<Map @ready="...">` 等价，区别是它写在子组件里而非挂在 `<Map>` 的事件上。
+ *
+ * @param onReady 地图就绪时回调（handle 非 null）。
+ */
+export declare function useMapReady(onReady: (map: MapHandle) => void): void;

package/dist/composables/useMapRef.d.ts

@@ -0,0 +1,8 @@
+import { ComputedRef } from 'vue';
+import { MapRef } from '../components/Map/MapRef';
+
+/**
+ * 命令式操作地图的句柄（已转发 driver 全量方法，是日常首选）。
+ * 响应式：map/driver 就绪后自动可用，未就绪时为 null。
+ */
+export declare function useMapRef(): ComputedRef<MapRef | null>;

package/dist/composables/useServiceTimeout.d.ts

@@ -0,0 +1,7 @@
+export declare const SERVICE_TIMEOUT_MS = 10000;
+export declare function serviceTimeoutError(): Error;
+export interface ServiceTimeoutControl {
+    arm: (onTimeout: () => void, ms?: number) => void;
+    clear: () => void;
+}
+export declare function useServiceTimeout(): ServiceTimeoutControl;

package/dist/composables/useSymbol.d.ts

@@ -0,0 +1,5 @@
+import { ShallowRef } from 'vue';
+import { OverlayHandle } from '../types';
+import { SymbolProps } from '../components/Overlay/types';
+
+export declare function useSymbol(props: SymbolProps): ShallowRef<OverlayHandle | null>;

package/dist/const/index.d.ts

@@ -0,0 +1,19 @@
+import { MarkerAnimation } from '../constants';
+
+export * from '../constants';
+/** @deprecated 用 BMAP_ANCHOR_LEFT_CENTER */
+export declare const BMAP_ANCHOR_MIDDLE_LEFT = 6;
+/** @deprecated 用 BMAP_ANCHOR_RIGHT_CENTER */
+export declare const BMAP_ANCHOR_MIDDLE_RIGHT = 7;
+/** @deprecated 用 BMAP_LANGUAGE_ZH */
+export declare const BMAP_LANG_CN = "zh";
+/** @deprecated 用 BMAP_LANGUAGE_EN */
+export declare const BMAP_LANG_EN = "en";
+/** @deprecated 用 BMAP_SHAPE_RECT */
+export declare const BMAP_SHAPE_RECTANGLE = 2;
+/** @deprecated 用 MarkerAnimation */
+export type Animation = MarkerAnimation;
+/**
+ * 从 SDK 全局对象获取运行时常量（v3/v4 值可能不同），回退到静态值。
+ */
+export declare function getSdkConstant(name: string, fallback: number): number;

package/dist/constants/index.d.ts

@@ -0,0 +1,195 @@
+/**
+ * 全量 BMAP_* 常量 — 从 bmap-jsapi-dts/src/const/*.d.ts 转录。
+ */
+export declare const BMAP_ANCHOR_TOP_LEFT = 0;
+export declare const BMAP_ANCHOR_TOP_RIGHT = 1;
+export declare const BMAP_ANCHOR_BOTTOM_LEFT = 2;
+export declare const BMAP_ANCHOR_BOTTOM_RIGHT = 3;
+export declare const BMAP_ANCHOR_TOP_CENTER = 4;
+export declare const BMAP_ANCHOR_BOTTOM_CENTER = 5;
+export declare const BMAP_ANCHOR_LEFT_CENTER = 6;
+export declare const BMAP_ANCHOR_RIGHT_CENTER = 7;
+export declare const BMAP_ANCHOR_CENTER = 8;
+export type ControlAnchor = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+export declare const BMAP_NORMAL_MAP = "B_NORMAL_MAP";
+export declare const BMAP_SATELLITE_MAP = "B_SATELLITE_MAP";
+export declare const BMAP_HYBRID_MAP = "B_STREET_MAP";
+export declare const BMAP_EARTH_MAP = "B_EARTH_MAP";
+export type MapTypeId = string;
+export declare const BMAP_NAVIGATION_CONTROL_LARGE = 0;
+export declare const BMAP_NAVIGATION_CONTROL_SMALL = 1;
+export declare const BMAP_NAVIGATION_CONTROL_PAN = 2;
+export declare const BMAP_NAVIGATION_CONTROL_ZOOM = 3;
+export type NavigationControlType = 0 | 1 | 2 | 3;
+export declare const BMAP_MAPTYPE_CONTROL_HORIZONTAL = 0;
+export declare const BMAP_MAPTYPE_CONTROL_DROPDOWN = 1;
+export declare const BMAP_MAPTYPE_CONTROL_MAP = 2;
+export type MapTypeControlType = 0 | 1 | 2;
+export declare const BMAP_ANIMATION_DROP = 1;
+export declare const BMAP_ANIMATION_BOUNCE = 2;
+export type MarkerAnimation = 1 | 2;
+export declare const BMAP_STATUS_SUCCESS = 0;
+export declare const BMAP_STATUS_CITY_LIST = 1;
+export declare const BMAP_STATUS_UNKNOWN_LOCATION = 2;
+export declare const BMAP_STATUS_UNKNOWN_ROUTE = 3;
+export declare const BMAP_STATUS_INVALID_KEY = 4;
+export declare const BMAP_STATUS_INVALID_REQUEST = 5;
+export declare const BMAP_STATUS_PERMISSION_DENIED = 6;
+export declare const BMAP_STATUS_SERVICE_UNAVAILABLE = 7;
+export declare const BMAP_STATUS_TIMEOUT = 8;
+export type ServiceStatus = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+export declare const BMAP_DRIVING_POLICY_DEFAULT = 0;
+export declare const BMAP_DRIVING_POLICY_DESTANCE = 2;
+export declare const BMAP_DRIVING_POLICY_AVOID_HIGHWAYS = 3;
+export declare const BMAP_DRIVING_POLICY_FIRST_HIGHWAYS = 4;
+export declare const BMAP_DRIVING_POLICY_AVOID_CONGESTION = 5;
+export declare const BMAP_DRIVING_POLICY_AVOID_PAY = 6;
+export declare const BMAP_DRIVING_POLICY_HIGHWAYS_AVOID_CONGESTION = 7;
+export declare const BMAP_DRIVING_POLICY_AVOID_HIGHWAYS_CONGESTION = 8;
+export declare const BMAP_DRIVING_POLICY_AVOID_CONGESTION_PAY = 9;
+export declare const BMAP_DRIVING_POLICY_AVOID_HIGHWAYS_CONGESTION_PAY = 10;
+export declare const BMAP_DRIVING_POLICY_AVOID_HIGHWAYS_PAY = 11;
+export declare const BMAP_DRIVING_POLICY_DISTANCE_PRIORITY = 12;
+export declare const BMAP_DRIVING_POLICY_TIME_PRIORITY = 13;
+export type DrivingPolicy = 0 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13;
+export declare const BMAP_TRANSIT_POLICY_RECOMMEND = 0;
+export declare const BMAP_TRANSIT_POLICY_LEAST_TRANSFER = 1;
+export declare const BMAP_TRANSIT_POLICY_LEAST_WALKING = 2;
+export declare const BMAP_TRANSIT_POLICY_AVOID_SUBWAYS = 3;
+export declare const BMAP_TRANSIT_POLICY_LEAST_TIME = 4;
+export declare const BMAP_TRANSIT_POLICY_FIRST_SUBWAYS = 5;
+export type TransitPolicy = 0 | 1 | 2 | 3 | 4 | 5;
+export declare const BMAP_TRANSIT_TYPE_IN_CITY = 0;
+export declare const BMAP_TRANSIT_TYPE_CROSS_CITY = 1;
+export type TransitType = 0 | 1;
+export declare const BMAP_TRANSIT_TYPE_POLICY_TRAIN = 0;
+export declare const BMAP_TRANSIT_TYPE_POLICY_AIRPLANE = 1;
+export declare const BMAP_TRANSIT_TYPE_POLICY_COACH = 2;
+export type TransitVehicleType = 0 | 1 | 2;
+export declare const BMAP_TRANSIT_PLAN_TYPE_ROUTE = 0;
+export declare const BMAP_TRANSIT_PLAN_TYPE_LINE = 1;
+export type TransitPlanType = 0 | 1;
+export declare const BMAP_INTERCITY_POLICY_LEAST_TIME = 0;
+export declare const BMAP_INTERCITY_POLICY_EARLY_START = 1;
+export declare const BMAP_INTERCITY_POLICY_CHEAP_PRICE = 2;
+export type IntercityPolicy = 0 | 1 | 2;
+export declare const BMAP_LANGUAGE_ZH = "zh";
+export declare const BMAP_LANGUAGE_EN = "en";
+export declare const BMAP_LANGUAGE_ZH_TW = "zh-TW";
+export declare const BMAP_LANGUAGE_ES = "es";
+export declare const BMAP_LANGUAGE_PT = "pt";
+export declare const BMAP_LANGUAGE_FR = "fr";
+export declare const BMAP_LANGUAGE_DE = "de";
+export declare const BMAP_LANGUAGE_TH = "th";
+export declare const BMAP_LANGUAGE_JA = "ja";
+export declare const BMAP_LANGUAGE_KO = "ko";
+export declare const BMAP_LANGUAGE_TR = "tr";
+export declare const BMAP_LANGUAGE_IT = "it";
+export declare const BMAP_LANGUAGE_RU = "ru";
+export declare const BMAP_LANGUAGE_MS = "ms";
+export declare const BMAP_LANGUAGE_VI = "vi";
+export declare const BMAP_LANGUAGE_ID = "id";
+export type Language = string;
+export declare const BMAP_UNIT_METRIC = "metric";
+export declare const BMAP_UNIT_IMPERIAL = "us";
+export type LengthUnit = 'metric' | 'us';
+export declare const BMAP_COORD_MERCATOR = "BMAP_COORD_MERCATOR";
+export declare const BMAP_COORD_GCJ02 = "BMAP_COORD_GCJ02";
+export declare const BMAP_COORD_BD09 = "BMAP_COORD_BD09";
+export declare const BMAP_COORD_GCJ02MERCATOR = "BMAP_COORD_GCJ02MERCATOR";
+export declare const BMAP_COORD_WGS84 = "BMAP_COORD_WGS84";
+export declare const BMAP_COORD_EPSG3857 = "BMAP_COORD_EPSG3857";
+export type CoordType = string;
+export declare const BMap_Symbol_SHAPE_CIRCLE = 1;
+export declare const BMap_Symbol_SHAPE_RECTANGLE = 2;
+export declare const BMap_Symbol_SHAPE_RHOMBUS = 3;
+export declare const BMap_Symbol_SHAPE_STAR = 4;
+export declare const BMap_Symbol_SHAPE_BACKWARD_CLOSED_ARROW = 5;
+export declare const BMap_Symbol_SHAPE_FORWARD_CLOSED_ARROW = 6;
+export declare const BMap_Symbol_SHAPE_BACKWARD_OPEN_ARROW = 7;
+export declare const BMap_Symbol_SHAPE_FORWARD_OPEN_ARROW = 8;
+export declare const BMap_Symbol_SHAPE_POINT = 9;
+export declare const BMap_Symbol_SHAPE_PLANE = 10;
+export declare const BMap_Symbol_SHAPE_CAMERA = 11;
+export declare const BMap_Symbol_SHAPE_WARNING = 12;
+export declare const BMap_Symbol_SHAPE_SMILE = 13;
+export declare const BMap_Symbol_SHAPE_CLOCK = 14;
+export type SymbolShapeType = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14;
+export declare const BMAP_POINT_SHAPE_STAR = 1;
+export declare const BMAP_POINT_SHAPE_WATERDROP = 2;
+export declare const BMAP_POINT_SHAPE_CIRCLE = 3;
+export declare const BMAP_POINT_SHAPE_SQUARE = 4;
+export declare const BMAP_POINT_SHAPE_RHOMBUS = 5;
+export type ShapeType = 1 | 2 | 3 | 4 | 5;
+export declare const BMAP_POINT_SHAPE_LAYER_CIRCLE = 0;
+export declare const BMAP_POINT_SHAPE_LAYER_SQUARE = 1;
+export declare const BMAP_POINT_SHAPE_LAYER_TRIANGLE = 2;
+export declare const BMAP_POINT_SHAPE_LAYER_DIAMOND = 3;
+export declare const BMAP_POINT_SHAPE_LAYER_CROSS = 4;
+export declare const BMAP_POINT_SHAPE_LAYER_ARROW = 5;
+export declare const BMAP_POINT_SHAPE_LAYER_ARROW_TAIL = 6;
+export declare const BMAP_POINT_SHAPE_LAYER_STAR = 7;
+export declare const BMAP_POINT_SHAPE_LAYER_WATERDROP = 9;
+export type PointShapeLayerShapeType = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 9;
+export declare const BMAP_POINT_SIZE_TINY = 1;
+export declare const BMAP_POINT_SIZE_SMALLER = 2;
+export declare const BMAP_POINT_SIZE_SMALL = 3;
+export declare const BMAP_POINT_SIZE_NORMAL = 4;
+export declare const BMAP_POINT_SIZE_BIG = 5;
+export declare const BMAP_POINT_SIZE_BIGGER = 6;
+export declare const BMAP_POINT_SIZE_HUGE = 7;
+export type SizeType = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export declare const BMAP_SHAPE_CIRCLE = 1;
+export declare const BMAP_SHAPE_RECT = 2;
+export type Marker3DShapeType = 1 | 2;
+export declare const BMAP_HIGHLIGHT_STEP = 1;
+export declare const BMAP_HIGHLIGHT_ROUTE = 2;
+export type HighlightMode = 1 | 2;
+export declare const BMAP_POI_TYPE_NORMAL = 0;
+export declare const BMAP_POI_TYPE_BUSSTOP = 1;
+export declare const BMAP_POI_TYPE_BUSLINE = 2;
+export declare const BMAP_POI_TYPE_SUBSTOP = 3;
+export declare const BMAP_POI_TYPE_SUBLINE = 4;
+export type POIType = 0 | 1 | 2 | 3 | 4;
+export declare const BMAP_MODE_DRIVING = "driving";
+export declare const BMAP_MODE_TRANSIT = "transit";
+export declare const BMAP_MODE_WALKING = "walking";
+export declare const BMAP_MODE_NAVIGATION = "navigation";
+export type Mode = 'driving' | 'transit' | 'walking' | 'navigation';
+export declare const BMAP_ROUTE_STATUS_NORMAL = 0;
+export declare const BMAP_ROUTE_STATUS_EMPTY = 1;
+export declare const BMAP_ROUTE_STATUS_ADDRESS = 2;
+export type RouteStatus = 0 | 1 | 2;
+export declare const BMAP_ROUTE_TYPE_WALKING = 2;
+export declare const BMAP_ROUTE_TYPE_DRIVING = 3;
+export declare const BMAP_ROUTE_TYPE_RIDING = 6;
+export type RouteType = 2 | 3 | 6;
+export declare const BMAP_TRAFFICE_STATUS_NONE = 0;
+export declare const BMAP_TRAFFICE_STATUS_NORMAL = 1;
+export declare const BMAP_TRAFFICE_STATUS_SLOW = 2;
+export declare const BMAP_TRAFFICE_STATUS_JAM = 3;
+export type TrafficStatus = 0 | 1 | 2 | 3;
+export declare const BMAP_POINT_DENSITY_HIGH = 200;
+export declare const BMAP_POINT_DENSITY_MEDIUM = 100;
+export declare const BMAP_POINT_DENSITY_LOW = 50;
+export type PointDensityType = 200 | 100 | 50;
+export declare const BMAP_CONTEXT_MENU_ICON_ZOOMIN: string;
+export declare const BMAP_CONTEXT_MENU_ICON_ZOOMOUT: string;
+export type ContextMenuIcon = string;
+export declare const BMAP_LINE_TYPE_BUS = 0;
+export declare const BMAP_LINE_TYPE_SUBWAY = 1;
+export declare const BMAP_LINE_TYPE_FERRY = 2;
+export declare const BMAP_LINE_TYPE_TRAIN = 3;
+export declare const BMAP_LINE_TYPE_AIRPLANE = 4;
+export declare const BMAP_LINE_TYPE_COACH = 5;
+export type LineType = 0 | 1 | 2 | 3 | 4 | 5;
+export declare const BMAP_PANORAMA_POI_HOTEL = "hotel";
+export declare const BMAP_PANORAMA_POI_CATERING = "catering";
+export declare const BMAP_PANORAMA_POI_MOVIE = "movie";
+export declare const BMAP_PANORAMA_POI_TRANSIT = "transit";
+export declare const BMAP_PANORAMA_POI_INDOOR_SCENE = "indoor_scene";
+export declare const BMAP_PANORAMA_POI_NONE = "none";
+export type PanoramaPOIType = 'hotel' | 'catering' | 'movie' | 'transit' | 'indoor_scene' | 'none';
+export declare const BMAP_PANORAMA_STREET_SCENE = "street";
+export declare const BMAP_PANORAMA_INDOOR_SCENE = "inter";
+export type PanoramaSceneType = 'street' | 'inter';

package/dist/context/index.d.ts

@@ -0,0 +1,31 @@
+import { InjectionKey, ShallowRef } from 'vue';
+import { BMapVersion, LoaderStatus, MapHandle, OverlayHandle } from '../types';
+import { BMapDriver } from '../drivers/types';
+
+export interface BMapContextValue {
+    status: LoaderStatus;
+    driver: BMapDriver | null;
+    version: BMapVersion;
+    error: Error | null;
+}
+export interface MapContextValue {
+    map: MapHandle | null;
+    driver: BMapDriver;
+}
+export type OverlayTargetType = 'clusterer' | 'overlay' | 'marker' | 'map';
+export interface OverlayTargetStore {
+    type: OverlayTargetType;
+    /** 父级 handle（父级尚未挂载时为 null）；响应式，子级 watch 即可感知就绪 */
+    handle: ShallowRef<OverlayHandle | MapHandle | null>;
+    addOverlay?: (overlay: OverlayHandle) => void;
+    removeOverlay?: (overlay: OverlayHandle) => void;
+}
+export declare const BMAP_KEY: InjectionKey<ShallowRef<BMapContextValue>>;
+export declare const MAP_KEY: InjectionKey<ShallowRef<MapContextValue | null>>;
+export declare const OVERLAY_TARGET_KEY: InjectionKey<OverlayTargetStore>;
+/** 读取 Provider 状态；不在 Provider 内时返回 loading 兜底。 */
+export declare function useBMapContext(): ShallowRef<BMapContextValue>;
+/** 读取当前 <Map> 上下文；不在 <Map> 内时返回 null（供检索类 composable 安全回退）。 */
+export declare function useMapContextOptional(): ShallowRef<MapContextValue | null> | null;
+/** 读取当前 <Map> 上下文；不在 <Map> 内时抛错。 */
+export declare function useMapContext(): ShallowRef<MapContextValue | null>;

package/dist/drivers/capabilityMatrix.d.ts

@@ -0,0 +1,3 @@
+import { Capability } from '../types';
+
+export declare const CAPABILITY_MATRIX: Record<'3.0' | '4.0', ReadonlySet<Capability>>;

package/dist/drivers/createDriver.d.ts

@@ -0,0 +1,18 @@
+import { BMapVersion, UnsupportedBehavior } from '../types';
+import { BMapDriver } from './types';
+import { createV4Driver } from './v4Driver';
+import { createV3Driver } from './v3Driver';
+
+/**
+ * 根据 version 选择 driver：
+ * - '3.0'：使用 v3Driver
+ * - 其它任何值（'4.0' / '4.1' / '5.0' / ...）：使用 v4Driver（按 4.0 baseline 处理）
+ *
+ * jsapi-loader 始终按用户传入的 version 加载真实 SDK，与 driver 选择无关。
+ * 未显式支持的版本统一按 4.0 处理（DESIGN.md「框架内没定义 4.0 后的版本，按 4.0 版本处理」）。
+ */
+export declare function createDriver(version: BMapVersion, rawSDK: unknown, opts: {
+    unsupportedBehavior: UnsupportedBehavior;
+}): BMapDriver;
+export { createV4Driver, createV3Driver };
+export type { BMapDriver } from './types';