@baidumap/vue-bmap 1.0.0

package/dist/loader/index.d.ts

@@ -0,0 +1,21 @@
+import { BMapVersion, LoadKeyComponents } from '../types';
+
+export interface LoaderResult {
+    rawSDK: unknown;
+    version: BMapVersion;
+    loadKey: string;
+}
+/**
+ * 加载 JSAPI 的统一入口。
+ *
+ * - 通过 @baidumap/jsapi-loader 加载。
+ * - 缓存以 loadKey 去重，不重复注入脚本。
+ * - 冲突（不同 loadKey）触发 onLoadConflict，返回已加载的 entry。
+ * - **不修改 window.BMap / BMapGL 原型、不做命名空间别名**。
+ */
+export declare function loadJSAPI(components: LoadKeyComponents, opts: {
+    protocol?: 'http' | 'https';
+    timeout?: number;
+    globalConfig?: Record<string, unknown>;
+    onLoadConflict?: (current: LoadKeyComponents, requested: LoadKeyComponents) => void;
+}): Promise<LoaderResult>;

package/dist/loader/registry.d.ts

@@ -0,0 +1,13 @@
+import { BMapVersion, LoadKeyComponents } from '../types';
+
+interface RegistryEntry {
+    promise: Promise<unknown>;
+    loadKey: string;
+    components: LoadKeyComponents;
+}
+export declare function buildLoadKey(c: LoadKeyComponents): string;
+export declare function getExisting(loadKey: string): RegistryEntry | undefined;
+export declare function register(loadKey: string, components: LoadKeyComponents, promise: Promise<unknown>): void;
+export declare function getAllEntries(): RegistryEntry[];
+export declare function detectConflict(loadKey: string, requested: LoadKeyComponents): LoadKeyComponents | null;
+export type { BMapVersion, LoadKeyComponents };

package/dist/loader/stableHash.d.ts

@@ -0,0 +1,2 @@
+/** 稳定 hash，做 loader 缓存 key */
+export declare function stableHash(value: unknown): string;

package/dist/provider/BMapProvider.d.ts

@@ -0,0 +1,108 @@
+import { PropType } from 'vue';
+import { BMapVersion, LoadKeyComponents, UnsupportedBehavior } from '../types';
+
+export declare const BMapProvider: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    ak: {
+        type: StringConstructor;
+        required: true;
+    };
+    version: {
+        type: PropType<BMapVersion>;
+        default: string;
+    };
+    protocol: {
+        type: PropType<"http" | "https">;
+        default: any;
+    };
+    serviceHost: {
+        type: StringConstructor;
+        default: any;
+    };
+    language: {
+        type: StringConstructor;
+        default: any;
+    };
+    plugins: {
+        type: PropType<string[]>;
+        default: any;
+    };
+    timeout: {
+        type: NumberConstructor;
+        default: any;
+    };
+    globalConfig: {
+        type: PropType<Record<string, unknown>>;
+        default: any;
+    };
+    unsupportedBehavior: {
+        type: PropType<UnsupportedBehavior>;
+        default: string;
+    };
+    onError: {
+        type: PropType<(err: Error) => void>;
+        default: any;
+    };
+    onLoadConflict: {
+        type: PropType<(current: LoadKeyComponents, requested: LoadKeyComponents) => void>;
+        default: any;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[], {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    ak: {
+        type: StringConstructor;
+        required: true;
+    };
+    version: {
+        type: PropType<BMapVersion>;
+        default: string;
+    };
+    protocol: {
+        type: PropType<"http" | "https">;
+        default: any;
+    };
+    serviceHost: {
+        type: StringConstructor;
+        default: any;
+    };
+    language: {
+        type: StringConstructor;
+        default: any;
+    };
+    plugins: {
+        type: PropType<string[]>;
+        default: any;
+    };
+    timeout: {
+        type: NumberConstructor;
+        default: any;
+    };
+    globalConfig: {
+        type: PropType<Record<string, unknown>>;
+        default: any;
+    };
+    unsupportedBehavior: {
+        type: PropType<UnsupportedBehavior>;
+        default: string;
+    };
+    onError: {
+        type: PropType<(err: Error) => void>;
+        default: any;
+    };
+    onLoadConflict: {
+        type: PropType<(current: LoadKeyComponents, requested: LoadKeyComponents) => void>;
+        default: any;
+    };
+}>> & Readonly<{}>, {
+    version: BMapVersion;
+    unsupportedBehavior: UnsupportedBehavior;
+    plugins: string[];
+    serviceHost: string;
+    protocol: "http" | "https";
+    timeout: number;
+    globalConfig: Record<string, unknown>;
+    language: string;
+    onError: (err: Error) => void;
+    onLoadConflict: (current: LoadKeyComponents, requested: LoadKeyComponents) => void;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export type BMapProviderProps = InstanceType<typeof BMapProvider>['$props'];

package/dist/types/core.d.ts

@@ -0,0 +1,82 @@
+import { Point, Bounds } from '../index';
+
+export interface DisplayOptions {
+    indoor?: boolean;
+    sky?: boolean;
+    water?: boolean;
+    land?: boolean;
+    building?: boolean;
+    label?: boolean;
+    road?: boolean;
+    boundary?: boolean;
+    regionText?: boolean;
+    street?: boolean;
+    poi?: boolean;
+    poiText?: boolean;
+    poiIcon?: boolean;
+    overlayIcon?: boolean;
+    overlayText?: boolean;
+}
+export interface Viewport {
+    center: Point;
+    zoom: number;
+    bounds?: Bounds;
+}
+export interface ViewportOptions {
+    margins?: [number, number, number, number];
+    zoomFactor?: number;
+    icon?: unknown;
+}
+export interface MapStyleConfig {
+    features?: Array<{
+        featureType: string;
+        stylers?: Record<string, unknown>;
+    }>;
+    style?: string;
+}
+export interface MapStyleV2Options {
+    styleJson?: unknown[];
+    styleId?: string;
+}
+export interface MapLabel {
+    text?: string;
+    point?: Point;
+    fontColor?: string;
+    fontSize?: number;
+    bgColor?: string;
+    bdColor?: string;
+    bdWidth?: number;
+}
+export interface MapPanes {
+    floatPane?: HTMLElement;
+    markerMouseTarget?: HTMLElement;
+    markerPane?: HTMLElement;
+    markerShadow?: HTMLElement;
+    mapPane?: HTMLElement;
+}
+export interface ViewAnimationOptions {
+    duration?: number;
+    transition?: number;
+    delay?: number;
+    iterationCount?: number;
+    direction?: string;
+    easing?: string;
+}
+export interface ViewAnimationKeyFrames {
+    center?: Point;
+    zoom?: number;
+    heading?: number;
+    tilt?: number;
+}
+export interface ViewAnimation {
+    keyFrames?: Array<ViewAnimationKeyFrames>;
+    options?: ViewAnimationOptions;
+}
+export interface Projection {
+    lngLatToPoint?(point: Point): Point;
+    pointToLngLat?(point: Point): Point;
+}
+export interface PredictDate {
+    weekday: number;
+    hour: number;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 核心类型定义。
+ *
+ * 类型来源：bmap-jsapi-dts（src 目录下的 .d.ts 文件）。
+ * 本文件只重新组织「库内部需要」的类型形态，不重复 dts 的完整 API 描述。
+ * 具体 SDK 类（Map/Marker/...）的成员在 dts 中查阅，库内部用 brand handle 包装。
+ */
+export interface Point {
+    lng: number;
+    lat: number;
+}
+export interface Pixel {
+    x: number;
+    y: number;
+}
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface Bounds {
+    sw: Point;
+    ne: Point;
+}
+export interface MapHandle {
+    readonly __brand: 'MapHandle';
+    readonly raw: unknown;
+}
+export interface OverlayHandle {
+    readonly __brand: 'OverlayHandle';
+    readonly raw: unknown;
+    readonly type: string;
+}
+export interface ControlHandle {
+    readonly __brand: 'ControlHandle';
+    readonly raw: unknown;
+    readonly type: string;
+}
+export interface LayerHandle {
+    readonly __brand: 'LayerHandle';
+    readonly raw: unknown;
+    readonly kind: LayerKind;
+}
+export interface ServiceHandle {
+    readonly __brand: 'ServiceHandle';
+    readonly raw: unknown;
+    readonly isNull: boolean;
+}
+export type LayerKind = 'tile' | 'normal' | 'geojson' | 'district' | 'traffic' | 'custom' | 'canvas';
+/**
+ * JSAPI 版本。
+ *
+ * 框架显式支持 '3.0' 与 '4.0'，但允许传入任意字符串（如未来的 '4.1'、'5.0'）。
+ * - '3.0'：使用 v3Driver
+ * - 其它任何值（'4.0' / '4.1' / '5.0' / ...）：使用 v4Driver，按 4.0 baseline 处理
+ * - jsapi-loader 始终按用户传入的 version 加载
+ *
+ * `(string & {})` 是 TS 的常见技巧：既允许任意字符串，又能在 IDE 里给出 '3.0' / '4.0' 的补全提示。
+ */
+export type BMapVersion = '3.0' | '4.0' | (string & {});
+export type UnsupportedBehavior = 'throw' | 'warn' | 'ignore';
+/**
+ * 能力标识。
+ *
+ * 完整清单由 scripts/gen-capability-matrix.ts 从 bmap-jsapi-dts 的
+ * @since / @removed 自动生成。此处仅手写常见项作为种子。
+ * 真正的能力矩阵见 src/drivers/capabilityMatrix.ts。
+ */
+export type Capability = string;
+export interface BMapEvent<T = unknown> {
+    type: string;
+    target: MapHandle | OverlayHandle | ControlHandle | null;
+    point?: Point;
+    pixel?: Pixel;
+    overlay?: OverlayHandle;
+    raw: T;
+}
+/** Map 鼠标/触摸事件（click, dblclick, rightclick, mousemove, mousedown, mouseup, mouseover, mouseout, touchstart, touchmove, touchend, longpress） */
+export interface MapMouseEvent {
+    type: string;
+    target: MapHandle;
+    point: Point;
+    pixel: Pixel;
+    overlay?: OverlayHandle;
+}
+/** Map 移动/拖拽事件（dragstart, dragging, dragend, movestart, moving, moveend） */
+export interface MapMoveEvent {
+    type: string;
+    target: MapHandle;
+    point: Point;
+    center?: Point;
+}
+/** Map 缩放事件（zoomstart, zooming, zoomend） */
+export interface MapZoomEvent {
+    type: string;
+    target: MapHandle;
+    zoom?: number;
+}
+/** Map 通用事件（resize, tilesloaded, maptypechange） */
+export interface MapEvent {
+    type: string;
+    target: MapHandle;
+    [key: string]: unknown;
+}
+export type LoaderStatus = 'loading' | 'ready' | 'error';
+export interface LoadKeyComponents {
+    version: BMapVersion;
+    ak: string;
+    serviceHost?: string;
+    language?: string;
+    plugins?: string[];
+}

package/dist/types/results.d.ts

@@ -0,0 +1,171 @@
+import { Point } from '../types';
+
+export interface LocalResultPoi {
+    title: string;
+    point: Point;
+    address: string;
+    phoneNumber: string;
+    tags?: string[];
+    url?: string;
+}
+export interface LocalResult {
+    keyword: string;
+    getCurrentNumPois(): number;
+    getPoi(i: number): LocalResultPoi;
+    getNumPois(): number;
+    getNumPages(): number;
+    getCurrentPage(): number;
+    city: string;
+}
+export interface AddressComponent {
+    province: string;
+    city: string;
+    district: string;
+    street: string;
+    streetNumber: string;
+}
+export interface GeocoderResult {
+    point: Point;
+    address: string;
+    addressComponents: AddressComponent;
+    surroundingPoi?: LocalResultPoi[];
+    business: string;
+}
+export interface Step {
+    point: Point;
+    distance: number;
+    duration: number;
+    instructions: string;
+}
+export interface Route {
+    getDistance(includeTraffic?: boolean): {
+        value: number;
+    };
+    getNumSteps(): number;
+    getStep(i: number): Step;
+    getPath(): Point[];
+}
+export interface RoutePlan {
+    getNumRoutes(): number;
+    getRoute(i: number): Route;
+    getDistance(includeTraffic?: boolean): {
+        value: number;
+    };
+    getDuration(includeTraffic?: boolean): {
+        value: number;
+    };
+}
+export interface DrivingRouteResult {
+    policy?: number;
+    taxiFare?: TaxiFare;
+    getNumPlans(): number;
+    getPlan(i: number): RoutePlan;
+}
+export type WalkingRouteResult = DrivingRouteResult;
+export type RidingRouteResult = DrivingRouteResult;
+export interface TransitLine {
+    title: string;
+    getNumStops?(): number;
+}
+export interface TransitPlan {
+    getNumLines(): number;
+    getLine(i: number): TransitLine;
+    getDistance(includeTraffic?: boolean): {
+        value: number;
+    };
+    getDuration(includeTraffic?: boolean): {
+        value: number;
+    };
+}
+export interface TransitRouteResult {
+    policy?: number;
+    getNumPlans(): number;
+    getPlan(i: number): TransitPlan;
+}
+export interface BusStation {
+    name: string;
+    point: Point;
+}
+export interface BusLine {
+    name: string;
+    uid?: string;
+    getNumStations?(): number;
+}
+export interface BusListItem {
+    uid?: string;
+    name: string;
+}
+export interface BusListResult {
+    getNumBusList(): number;
+    getBusListItem(i: number): BusListItem;
+}
+export interface AutocompleteResultPoi {
+    business?: string;
+    city?: string;
+    district?: string;
+    uid?: string;
+    address?: string;
+    point?: Point;
+}
+export interface AutocompleteResult {
+    getList?(): AutocompleteResultPoi[];
+}
+export interface GeolocationResult {
+    point: Point;
+    accuracy?: number;
+    address?: string;
+}
+export interface LocalCityResult {
+    center: Point;
+    level: number;
+    name: string;
+    code?: number;
+}
+export interface TranslateResults {
+    status?: number;
+    points?: Point[];
+    size?(): number;
+}
+export interface TaxiFareDetail {
+    day?: {
+        totalPrice?: number;
+        distance?: number;
+        duration?: number;
+        detail?: unknown;
+    };
+    night?: {
+        totalPrice?: number;
+        distance?: number;
+        duration?: number;
+        detail?: unknown;
+    };
+}
+export interface TaxiFare {
+    distance: number;
+    duration: number;
+    detail: TaxiFareDetail;
+}
+export interface PanoramaData {
+    id?: string;
+    links?: unknown[];
+    pov?: {
+        heading?: number;
+        pitch?: number;
+        zoom?: number;
+    };
+}
+export interface BoundaryResult {
+    boundaries: string[];
+}
+export interface RenderOptions {
+    map?: unknown;
+    panel?: string | HTMLElement;
+    selectFirstResult?: boolean;
+    autoViewport?: boolean;
+    highlightMode?: number;
+    viewportOptions?: ViewportOptions;
+}
+export interface ViewportOptions {
+    margins?: number[];
+    zoomFactor?: number;
+}

package/dist/types-skd.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SDK 类型的占位（开发时按 bmap-jsapi-dts 全量替换）。
+ *
+ * 当前为框架占位类型，避免组件实现阻塞。
+ */
+export interface Icon {
+    __iconBrand?: 'BMap.Icon';
+    url?: string;
+    size?: import('.').Size;
+    [k: string]: unknown;
+}
+export type Size = {
+    width: number;
+    height: number;
+};
+export type ControlAnchor = number;
+export interface Label {
+    __labelBrand?: 'BMap.Label';
+    content?: string;
+    [k: string]: unknown;
+}

package/dist/utils/createComponent.d.ts

@@ -0,0 +1,51 @@
+import { OverlayTargetType } from '../context';
+import { BMapDriver } from '../drivers/types';
+import { ControlHandle, LayerHandle, OverlayHandle } from '../types';
+
+export interface OverlayComponentConfig<P> {
+    factory: (driver: BMapDriver, props: P) => OverlayHandle | null;
+    positionProp?: keyof P & string;
+    pathProp?: keyof P & string;
+    optionProps?: Array<keyof P & string>;
+    ctorOnlyProps?: Array<keyof P & string>;
+    supportsChildren?: boolean;
+    childTargetType?: OverlayTargetType;
+    attachToMarkerAsLabel?: boolean;
+    events?: Array<{
+        sdk: string;
+        prop: keyof P & string;
+    }>;
+    displayName?: string;
+    skipMount?: boolean;
+}
+export interface ControlComponentConfig<P> {
+    factory: (driver: BMapDriver, props: P) => ControlHandle | null;
+    optionProps?: Array<keyof P & string>;
+    ctorOnlyProps?: Array<keyof P & string>;
+    events?: Array<{
+        sdk: string;
+        prop: keyof P & string;
+    }>;
+    displayName?: string;
+}
+export interface LayerComponentConfig<P> {
+    factory: (driver: BMapDriver, props: P) => LayerHandle | null;
+    addMethod?: keyof BMapDriver;
+    removeMethod?: keyof BMapDriver;
+    events?: ReadonlyArray<{
+        sdk: string;
+        prop: keyof P & string;
+    }>;
+    displayName?: string;
+}
+export declare function createOverlayComponent<P extends Record<string, any>>(config: OverlayComponentConfig<P>): import('vue').DefineComponent<{}, () => any, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {} | {
+    [x: string]: any;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export declare function createControlComponent<P extends Record<string, any>>(config: ControlComponentConfig<P>): import('vue').DefineComponent<{}, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[], {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {} | {
+    [x: string]: any;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export declare function createLayerComponent<P extends Record<string, any>>(config: LayerComponentConfig<P>): import('vue').DefineComponent<{}, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[], {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/utils/debugWarn.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 开发期非抛出型告警。
+ *
+ * 用途：包住那些「用户明确要求某个操作、但 SDK 静默失败」的 catch —— 例如
+ * Layer.setData 没渲染、Map 的属性 setter 没生效。这些位置以前是 `catch { /* noop *\/ }`，
+ * 故障被完全吞掉，开发时无从排查。
+ *
+ * 设计约束：
+ * - 只在非 production 打印（对齐 v4Driver 里的 env 判断），避免污染线上 console。
+ * - 绝不抛异常：这些 catch 多在 React effect 回调里，抛出会破坏渲染树。日志本身也 try 兜底。
+ * - 不走 reportUnsupported：那是「能力不支持」语义、且 throw 模式会抛错；这里是
+ *   受支持操作的运行时失败，只需可观测，不改变控制流。
+ */
+export declare function debugWarn(context: string, cause?: unknown): void;
+/**
+ * 开发期提示（原文输出，不追加「调用失败」）。
+ *
+ * 用途：不是调用失败、但用户几乎一定会误解的场景 —— 例如把某个 option prop 改回
+ * undefined，框架没有 SDK 默认值可以还原，只能保持原状。这类「符合实现、但违背直觉」
+ * 的行为不说出来就是静默失效。
+ */
+export declare function devWarn(message: string, cause?: unknown): void;

package/dist/utils/event.d.ts

@@ -0,0 +1,7 @@
+import { BMapEvent } from '../types';
+
+/**
+ * 把 SDK 原始事件包装成统一 BMapEvent。
+ * raw 字段始终保留原始事件对象。
+ */
+export declare function wrapEvent<T = unknown>(raw: T, target?: unknown): BMapEvent<T>;

package/dist/utils/handle.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Brand handle 工具。
+ *
+ * 框架对外暴露的 Map/Overlay/... 都是 brand handle（`{ __brand, raw }`），
+ * 传给 SDK 前需要解包出内部的 raw 实例。集中在此处理，
+ * 避免在各 hook / 组件里散落 `(x as any).__brand` / `(x as any).raw`。
+ */
+interface BrandHandle {
+    readonly __brand: string;
+    readonly raw: unknown;
+}
+/** 判断值是否为 brand handle。 */
+export declare function isHandle(value: unknown): value is BrandHandle;
+/** 若是 brand handle 则解包出内部 raw SDK 实例，否则原样返回。 */
+export declare function unwrapHandle(value: unknown): unknown;
+export {};

package/dist/utils/pointEquals.d.ts

@@ -0,0 +1,7 @@
+import { Point } from '../types';
+
+/**
+ * 经纬度误差容忍比较，避免浮点误差导致受控循环。
+ */
+export declare function pointEquals(a: Point | null | undefined, b: Point | null | undefined, eps?: number): boolean;
+export declare function pointToPlain(p: unknown): Point | null;

package/dist/utils/sdk.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 全局 BMap SDK 访问入口。
+ *
+ * SDK 脚本由 jsapi-loader 注入到全局（v3 为 `BMap`，v4 的 `BMapGL` 出于兼容
+ * 也会挂 `BMap` 别名）。这里集中收敛对全局对象的类型断言，
+ * 避免在各 hook / 组件里散落 `(globalThis as any).BMap`。
+ *
+ * 构造器签名直接取自官方类型包 `@baidumap/jsapi-v4-types` 的全局 `BMap` 命名空间，
+ * 所以 `new SDK.Point(...)` 得到的是真正的 `BMap.Point`，而不是 `unknown`。
+ */
+/// <reference types="@baidumap/jsapi-v4-types" />
+/**
+ * 官方类型包尚未声明、但本库运行时确实会用到的构造器。
+ *
+ * 这里只补「官方缺、我们用」的部分 —— 官方补齐后应当从此处删掉，
+ * 而不是让手写声明和官方声明长期并存。
+ */
+interface BMapSDKExtras {
+    /** v4 的地图遮罩层，官方类型包未声明；见 components/Overlay/MapMask.tsx */
+    readonly MapMask: new (points: BMap.Point[], opts?: Record<string, unknown>) => unknown;
+    /** v4 的简易信息窗，官方类型包未声明；见 components/Overlay/SimpleInfoWindow.tsx */
+    readonly SimpleInfoWindow: new (content: string | HTMLElement, opts?: Record<string, unknown>) => unknown;
+}
+/**
+ * 运行时全局 SDK 对象的类型。
+ *
+ * - `typeof BMap`：官方命名空间里的全部构造器与常量，带完整参数/返回值签名
+ * - `BMapSDKExtras`：补齐官方尚未声明的成员
+ * - 索引签名：v3/v4 之间成员存在差异，未知成员以 `unknown` 兜底，由调用方自行断言
+ *
+ * 交集类型下，已声明的成员优先于索引签名解析，因此 `SDK.Point` 仍是精确类型。
+ */
+export type BMapSDK = typeof BMap & BMapSDKExtras & {
+    readonly [key: string]: unknown;
+};
+/**
+ * 获取全局 BMap SDK 对象；若脚本尚未注入则抛出清晰错误。
+ * 适用于随后直接访问 `SDK.Point` 等构造器的调用方 —— 相比原先返回
+ * undefined 后触发的 `Cannot read properties of undefined`，这里给出可读的失败原因。
+ */
+export declare function getSDK(): BMapSDK;
+/**
+ * 获取全局 BMap SDK 对象；未注入时返回 undefined。
+ * 供可优雅降级的调用方使用（如运行时常量回退、组件在 SDK 缺失时静默跳过）。
+ */
+export declare function tryGetSDK(): BMapSDK | undefined;
+export {};