bigmap-plugin 1.0.3

package/dist/index.d.ts

@@ -0,0 +1,3063 @@
+import { ComponentOptionsMixin } from 'vue';
+import { ComponentProvideOptions } from 'vue';
+import { ComputedRef } from 'vue';
+import { DefineComponent } from 'vue';
+import { ExtractPropTypes } from 'vue';
+import { PropType } from 'vue';
+import { PublicProps } from 'vue';
+import { Ref } from 'vue';
+
+export declare interface AddWaveParams {
+    position: [number, number, number];
+    config?: CircleWaveConfig;
+}
+
+/** 动画持续时间（秒 / 毫秒） */
+export declare const ANIMATION_DURATION: {
+    readonly FLY_TO: 2;
+    readonly MORPH: 0.8;
+    readonly WAVE: 3000;
+};
+
+/** AppButton 组件 */
+export declare const AppButton: DefineComponent<ExtractPropTypes<    {
+type: {
+type: StringConstructor;
+default: string;
+};
+size: {
+type: StringConstructor;
+default: string;
+};
+disabled: {
+type: BooleanConstructor;
+default: boolean;
+};
+loading: {
+type: BooleanConstructor;
+default: boolean;
+};
+block: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, "click"[], "click", PublicProps, Readonly<ExtractPropTypes<    {
+type: {
+type: StringConstructor;
+default: string;
+};
+size: {
+type: StringConstructor;
+default: string;
+};
+disabled: {
+type: BooleanConstructor;
+default: boolean;
+};
+loading: {
+type: BooleanConstructor;
+default: boolean;
+};
+block: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>> & Readonly<{
+onClick?: ((...args: any[]) => any) | undefined;
+}>, {
+type: string;
+size: string;
+disabled: boolean;
+loading: boolean;
+block: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 组件属性 */
+export declare interface AppButtonProps {
+    /** 按钮类型 */
+    type?: ButtonType;
+    /** 按钮尺寸 */
+    size?: ButtonSize;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否显示加载中 */
+    loading?: boolean;
+    /** 是否块级展示 */
+    block?: boolean;
+}
+
+/** AppIcon 组件 */
+export declare const AppIcon: DefineComponent<ExtractPropTypes<    {
+name: {
+type: StringConstructor;
+required: true;
+};
+size: {
+type: (NumberConstructor | StringConstructor)[];
+default: number;
+};
+color: {
+type: StringConstructor;
+default: string;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
+name: {
+type: StringConstructor;
+required: true;
+};
+size: {
+type: (NumberConstructor | StringConstructor)[];
+default: number;
+};
+color: {
+type: StringConstructor;
+default: string;
+};
+}>> & Readonly<{}>, {
+color: string;
+size: string | number;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 组件属性 */
+export declare interface AppIconProps {
+    /** 图标名称 */
+    name: IconName;
+    /** 图标尺寸（px），默认 16 */
+    size?: number | string;
+    /** 图标颜色，默认继承 currentColor */
+    color?: string;
+}
+
+/** AppInput 组件 */
+export declare const AppInput: DefineComponent<ExtractPropTypes<    {
+modelValue: {
+type: StringConstructor;
+default: string;
+};
+placeholder: {
+type: StringConstructor;
+default: string;
+};
+clearable: {
+type: BooleanConstructor;
+default: boolean;
+};
+prefixIcon: {
+type: StringConstructor;
+default: string;
+};
+disabled: {
+type: BooleanConstructor;
+default: boolean;
+};
+autofocus: {
+type: BooleanConstructor;
+default: boolean;
+};
+ariaLabel: {
+type: StringConstructor;
+default: string;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("clear" | "input" | "update:modelValue" | "focus" | "blur" | "keydown")[], "clear" | "input" | "update:modelValue" | "focus" | "blur" | "keydown", PublicProps, Readonly<ExtractPropTypes<    {
+modelValue: {
+type: StringConstructor;
+default: string;
+};
+placeholder: {
+type: StringConstructor;
+default: string;
+};
+clearable: {
+type: BooleanConstructor;
+default: boolean;
+};
+prefixIcon: {
+type: StringConstructor;
+default: string;
+};
+disabled: {
+type: BooleanConstructor;
+default: boolean;
+};
+autofocus: {
+type: BooleanConstructor;
+default: boolean;
+};
+ariaLabel: {
+type: StringConstructor;
+default: string;
+};
+}>> & Readonly<{
+onFocus?: ((...args: any[]) => any) | undefined;
+onBlur?: ((...args: any[]) => any) | undefined;
+onInput?: ((...args: any[]) => any) | undefined;
+onKeydown?: ((...args: any[]) => any) | undefined;
+onClear?: ((...args: any[]) => any) | undefined;
+"onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+}>, {
+modelValue: string;
+placeholder: string;
+clearable: boolean;
+prefixIcon: string;
+disabled: boolean;
+autofocus: boolean;
+ariaLabel: string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 组件属性 */
+export declare interface AppInputProps {
+    /** 绑定值（v-model） */
+    modelValue: string;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 是否显示清除按钮 */
+    clearable?: boolean;
+    /** 前缀图标名称 */
+    prefixIcon?: AppIconProps['name'];
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否自动聚焦 */
+    autofocus?: boolean;
+    /** 无障碍名称（placeholder 不应作为唯一标签） */
+    ariaLabel?: string;
+}
+
+/** AppSpinner 组件 */
+export declare const AppSpinner: DefineComponent<ExtractPropTypes<    {
+size: {
+type: (NumberConstructor | StringConstructor)[];
+default: number;
+};
+color: {
+type: StringConstructor;
+default: string;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
+size: {
+type: (NumberConstructor | StringConstructor)[];
+default: number;
+};
+color: {
+type: StringConstructor;
+default: string;
+};
+}>> & Readonly<{}>, {
+color: string;
+size: string | number;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * AppSpinner - Apple 风格加载指示器
+ * 提供环形旋转加载动画，可指定尺寸与颜色。
+ */
+/** 组件属性 */
+export declare interface AppSpinnerProps {
+    /** 尺寸（px），默认 24 */
+    size?: number | string;
+    /** 颜色，默认继承 currentColor */
+    color?: string;
+}
+
+/** 异步回调 */
+export declare type AsyncCallback<T = any> = (data: T) => Promise<void>;
+
+/** 基础配置项 */
+export declare interface BaseOptions {
+    id?: string;
+    name?: string;
+    visible?: boolean;
+}
+
+/** 点位基础配置 */
+export declare interface BasePointConfig {
+    id: string | number;
+    lng: number;
+    lat: number;
+    altitude?: number;
+    icon?: string;
+    scale?: number;
+    properties?: Record<string, any>;
+    attr?: Record<string, unknown>;
+}
+
+/**
+ * bmgl 全局对象（window.bmgl）类型
+ * 显式声明本项目高频使用的成员；索引签名兜底罕见成员（受控边界）。
+ */
+declare interface Bmgl {
+    /** 三维坐标 */
+    Cartesian3: BmglCartesian3Static;
+    /** 二维向量 */
+    Cartesian2: new (x?: number, y?: number) => BmglCartesian2;
+    /** 经纬度（弧度制） */
+    Cartographic: BmglCartographicStatic;
+    /** 颜色 */
+    Color: BmglColorStatic;
+    /** 矩形 */
+    Rectangle: BmglRectangleStatic;
+    /** 数学工具 */
+    Math: BmglMathStatic;
+    /** 按视距缩放参数 */
+    NearFarScalar: new (near?: number, nearValue?: number, far?: number, farValue?: number) => BmglNearFarScalar;
+    /** 实体 */
+    Entity: new (options?: Record<string, unknown>) => BmglEntity;
+    /** 点集合 */
+    BillboardCollection: new (options?: Record<string, unknown>) => BmglBillboardCollection;
+    /** 地图视图构造器 */
+    Viewer: new (container: string | HTMLElement, options?: Record<string, unknown>) => MapViewer;
+    /** 屏幕空间事件句柄构造器 */
+    ScreenSpaceEventHandler: new (element?: unknown) => BmglScreenSpaceEventHandler;
+    /** 场景模式枚举（SCENE2D / SCENE3D / COLUMBUS_VIEW） */
+    SceneMode: {
+        SCENE2D: number;
+        SCENE3D: number;
+        COLUMBUS_VIEW: number;
+        [key: string]: any;
+    };
+    /** 屏幕空间事件类型枚举 */
+    ScreenSpaceEventType: {
+        [key: string]: any;
+    };
+    /** 垂直对齐枚举 */
+    VerticalOrigin: {
+        BOTTOM: number;
+        CENTER: number;
+        TOP: number;
+        [key: string]: any;
+    };
+    /** 水平对齐枚举 */
+    HorizontalOrigin: {
+        CENTER: number;
+        LEFT: number;
+        RIGHT: number;
+        [key: string]: any;
+    };
+    /** 高度参考枚举 */
+    HeightReference: {
+        [key: string]: any;
+    };
+    /** 分类类型枚举 */
+    ClassificationType: {
+        [key: string]: any;
+    };
+    /** 值判空工具 */
+    defined(value: unknown): boolean;
+    /** 请求调度器（瓦片并发控制） */
+    RequestScheduler: {
+        [key: string]: any;
+    };
+    /** 罕见成员兜底（受控边界：新增高频成员应显式声明） */
+    [key: string]: any;
+}
+
+/** bmgl Billboard（点位图标/名称标签）最小类型 */
+declare interface BmglBillboard {
+    /** 关联的原始点位数据（点击拾取时经 primitive.pointData 读回） */
+    pointData?: unknown;
+    /** 图标地址（URL 或 Canvas 纹理，与 Cesium billboard.image 语义一致） */
+    image?: string | HTMLCanvasElement;
+    /** 图标宽度（px） */
+    width?: number;
+    /** 图标高度（px） */
+    height?: number;
+    /** 世界坐标位置 */
+    position?: BmglCartesian3;
+    [key: string]: any;
+}
+
+/** bmgl BillboardCollection 最小类型（点位图标与名称标签均基于同一集合类） */
+declare interface BmglBillboardCollection {
+    /** 新增 billboard/标签，返回对应对象 */
+    add(options: Record<string, unknown>): BmglBillboard;
+    /** 移除集合内指定元素（成功移除返回 true） */
+    remove(billboard: BmglBillboard): boolean;
+    /** 清空集合内全部元素 */
+    removeAll(): void;
+    /** 集合整体显隐 */
+    show: boolean;
+    [key: string]: any;
+}
+
+/** bmgl Cartesian2（二维向量/屏幕坐标，受控不透明） */
+declare interface BmglCartesian2 {
+    x?: number;
+    y?: number;
+    [key: string]: any;
+}
+
+/** bmgl Cartesian3（三维坐标，受控不透明） */
+declare interface BmglCartesian3 {
+    x?: number;
+    y?: number;
+    z?: number;
+    [key: string]: any;
+}
+
+/** Cartesian3 静态成员 */
+declare interface BmglCartesian3Static {
+    new (x?: number, y?: number, z?: number): BmglCartesian3;
+    fromDegrees(longitude: number, latitude: number, height?: number, ellipsoid?: unknown): BmglCartesian3;
+    fromRadians(longitude: number, latitude: number, height?: number, ellipsoid?: unknown): BmglCartesian3;
+    [key: string]: any;
+}
+
+/** bmgl Cartographic（经纬度+高度，弧度制；fromCartesian 结果字段恒存在，受控不透明） */
+declare interface BmglCartographic {
+    longitude: number;
+    latitude: number;
+    height: number;
+    [key: string]: any;
+}
+
+/** Cartographic 静态成员 */
+declare interface BmglCartographicStatic {
+    fromDegrees(longitude: number, latitude: number, height?: number, ellipsoid?: unknown): BmglCartographic;
+    fromCartesian(cartesian: BmglCartesian3, ellipsoid?: unknown, result?: BmglCartographic): BmglCartographic;
+    [key: string]: any;
+}
+
+/** bmgl Color（受控不透明） */
+declare interface BmglColor {
+    withAlpha(alpha: number): BmglColor;
+    [key: string]: any;
+}
+
+/** Color 静态成员 */
+declare interface BmglColorStatic {
+    new (red?: number, green?: number, blue?: number, alpha?: number): BmglColor;
+    fromCssColorString(css: string): BmglColor;
+    fromAlpha(color: BmglColor, alpha: number): BmglColor;
+    [key: string]: any;
+}
+
+/** bmgl Ellipsoid（受控不透明） */
+declare interface BmglEllipsoid {
+    [key: string]: any;
+}
+
+/** bmgl Entity（受控不透明；常用字段显式声明便于业务读写，子对象均为可变包） */
+declare interface BmglEntity {
+    id?: string;
+    name?: string;
+    show?: boolean;
+    position?: {
+        [key: string]: any;
+    };
+    polyline?: {
+        [key: string]: any;
+    };
+    polygon?: {
+        [key: string]: any;
+    };
+    billboard?: {
+        [key: string]: any;
+    };
+    label?: {
+        [key: string]: any;
+    };
+    point?: {
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+
+/** bmgl 影像图层（受控不透明） */
+declare interface BmglImageryLayer {
+    provider?: {
+        [key: string]: any;
+    };
+    show?: boolean;
+    [key: string]: any;
+}
+
+/** bmgl 影像图层集合（viewer.imageryLayers） */
+declare interface BmglImageryLayerCollection {
+    /** 添加图层并原样返回（泛型保留具体类型） */
+    add<T>(layer: T): T;
+    /** 移除指定图层（destroy 控制是否销毁图层资源） */
+    remove(layer: unknown, destroy?: boolean): boolean;
+    /** 移除全部图层 */
+    removeAll(): void;
+    [key: string]: any;
+}
+
+/** bmgl 材质（受控不透明） */
+declare interface BmglMaterial {
+    [key: string]: any;
+}
+
+/** 数学工具静态成员 */
+declare interface BmglMathStatic {
+    toRadians(degrees: number): number;
+    toDegrees(radians: number): number;
+    clamp(value: number, min: number, max: number): number;
+    [key: string]: any;
+}
+
+/** bmgl NearFarScalar（按视距缩放参数，受控不透明） */
+declare interface BmglNearFarScalar {
+    [key: string]: any;
+}
+
+/** bmgl PrimitiveCollection（scene.primitives） */
+declare interface BmglPrimitiveCollection {
+    /** 添加 primitive 并原样返回（泛型保留具体类型） */
+    add<T>(primitive: T): T;
+    /** 移除指定 primitive */
+    remove(primitive: unknown): boolean;
+    /** 移除全部 primitive */
+    removeAll(): void;
+    [key: string]: any;
+}
+
+/** bmgl Rectangle（受控不透明） */
+declare interface BmglRectangle {
+    [key: string]: any;
+}
+
+/** Rectangle 静态成员 */
+declare interface BmglRectangleStatic {
+    fromDegrees(west: number, south: number, east: number, north: number): BmglRectangle;
+    [key: string]: any;
+}
+
+/** scene.pick 拾取结果（受控不透明） */
+declare interface BmglScenePick {
+    /** 拾取到的 primitive（点位 billboard 经 pointData 读回业务点位数据） */
+    primitive?: {
+        pointData?: Record<string, any>;
+        id?: unknown;
+    } & {
+        [key: string]: any;
+    };
+    /** 拾取到的实体 id（Entity 拾取场景；bmgl 实体内部 id 存于 _id） */
+    id?: {
+        _id?: string;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+
+/** bmgl ScreenSpaceEventHandler（屏幕空间事件句柄；movement 结构随事件类型而异，由调用方自行约束） */
+declare interface BmglScreenSpaceEventHandler {
+    setInputAction(action: (movement: any) => void, type: unknown): void;
+    removeInputAction(type: unknown): void;
+    destroy(): void;
+    isDestroyed(): boolean;
+    [key: string]: any;
+}
+
+/** 边界范围 */
+export declare interface Bounds {
+    west: number;
+    east: number;
+    south: number;
+    north: number;
+}
+
+/** 组装带令牌的 WMTS 请求 URL */
+export declare function buildGeoServerWmtsUrl(config: GeoServerSourceConfig, token: string): string;
+
+/** 海量点位更新配置 */
+export declare interface BulkUpdateConfig {
+    add?: BasePointConfig[];
+    update?: Array<{
+        id: string | number;
+    } & Partial<BasePointConfig>>;
+    remove?: (string | number)[];
+    batchSize?: number;
+    throttleTime?: number;
+}
+
+/** 按钮尺寸 */
+export declare type ButtonSize = 'small' | 'medium' | 'large';
+
+/**
+ * AppButton - Apple 风格按钮组件
+ * 支持主要/次要/危险三种风格，圆角 8px、系统蓝主色、按压缩放反馈。
+ */
+/** 按钮类型 */
+export declare type ButtonType = 'primary' | 'secondary' | 'danger';
+
+/** 回调函数类型 */
+export declare type Callback<T = any> = (data: T) => void;
+
+/** 相机默认姿态（heading / pitch / roll，弧度制） */
+export declare const CAMERA_CONFIG: {
+    readonly heading: 6.267876539812834;
+    readonly pitch: -1.3962634015954636;
+    readonly roll: 0.00016118230151462853;
+};
+
+/** 相机位置 */
+export declare interface CameraPosition extends Position {
+    heading: number;
+    pitch: number;
+    roll: number;
+}
+
+/**
+ * 由 Coordinate 经纬度构造 Cartesian3（BMGL 未就绪时返回 null）
+ */
+export declare function cartesianFromCoord(coord: Coordinate, height?: number): BmglCartesian3 | null;
+
+/**
+ * 将 Cartesian3 转为十进制度 { lng, lat }
+ */
+export declare function cartesianToDegrees(cartesian: BmglCartesian3): {
+    lng: number;
+    lat: number;
+} | null;
+
+/**
+ * 将 Cartographic 转为十进制度 { lng, lat }（BMGL 未就绪时返回 null）
+ */
+export declare function cartographicToDegrees(cart: BmglCartographic): {
+    lng: number;
+    lat: number;
+} | null;
+
+export declare interface CircleWaveConfig {
+    color?: string;
+    radius?: number;
+    duration?: number;
+    /** 生命周期（ms）：到期自动移除波纹，防止实体与每帧动画开销只增不减；0 表示不自动过期 */
+    ttl?: number;
+}
+
+/** 清理函数（可同步或异步） */
+export declare type CleanupFn = () => void | Promise<void>;
+
+/**
+ * 闭合多边形坐标：若首尾不一致则追加首点
+ * 同时支持 Coordinate[] 与 [number, number][] 两种坐标格式
+ */
+export declare function closeCoordinates<T extends Coordinate | [number, number]>(coords: T[]): T[];
+
+/** 颜色配置 */
+export declare interface ColorConfig {
+    color: string;
+    alpha?: number;
+}
+
+export declare class ConfigManager {
+    private config;
+    constructor(userConfig: Partial<MapConfig>);
+    /**
+     * 获取配置
+     */
+    get<K extends keyof MapConfig>(key: K): MapConfig[K];
+    /**
+     * 设置配置
+     */
+    set<K extends keyof MapConfig>(key: K, value: MapConfig[K]): void;
+    /**
+     * 获取所有配置
+     */
+    getAll(): Readonly<MapConfig>;
+    /**
+     * 更新配置（复用与构造一致的合并语义：剔除 undefined、geoserver 深合并）
+     */
+    update(updates: Partial<MapConfig>): void;
+    /**
+     * 重置为默认配置
+     */
+    reset(): void;
+}
+
+/** 等高线显示配置（3D 模式"等高线"开关参数，源自官方地形示例） */
+declare interface ContourConfig {
+    /** 等高线间距（m，默认 150） */
+    spacing?: number;
+    /** 等高线线宽（px，默认 2） */
+    width?: number;
+}
+
+/**
+ * 通用类型定义
+ */
+/** 坐标点 */
+export declare interface Coordinate {
+    lng: number;
+    lat: number;
+    altitude?: number;
+}
+
+/** 创建基于静态配置的 WMTS URL 提供器（使用业务方传入的令牌，不再内部获取） */
+export declare function createGeoServerWmtsProvider(config: GeoServerSourceConfig): () => Promise<string>;
+
+/**
+ * 由绘制事件数据构建空间查询形状
+ * - 多边形/矩形/三角形：使用坐标数组（data.path 为 [lng, lat][]）
+ * - 圆形：使用圆心与半径（负半径取绝对值）
+ *
+ * @param event 绘制事件数据（draw-end / draw-delete 等）
+ * @returns 可传入 searchByShape 的 SearchShape；无法构建时返回 null
+ */
+export declare function createSearchShapeFromDrawEvent(event: DrawEventData | null | undefined): SearchShape | null;
+
+/** 默认等高线配置（源自官方地形示例，仅等高线不叠加高程色带，可按 contourConfig 覆盖） */
+export declare const DEFAULT_CONTOUR_CONFIG: Required<ContourConfig>;
+
+/** 默认本地库文件路径（随包发布的 bigemap-plot / circleWave 等） */
+export declare const DEFAULT_LIBS_URL = "/libs";
+
+/** 默认地图配置 */
+export declare const DEFAULT_MAP_CONFIG: Partial<MapConfig>;
+
+/** 默认遮罩反选配置（可按 setMask 传入的 config 覆盖） */
+export declare const DEFAULT_MASK_CONFIG: NormalizedMaskConfig;
+
+/** 默认地图中心位置 */
+export declare const DEFAULT_POSITION: Position;
+
+/** 默认绘制工具列表（右侧工具栏，由绘制工具注册表派生，可经 tools 配置覆盖） */
+export declare const DEFAULT_TOOLS: ToolItem[];
+
+/** 默认轨迹回放配置（可按 load 传入的 config 覆盖） */
+export declare const DEFAULT_TRAJECTORY_CONFIG: Required<TrajectoryConfig>;
+
+/** 默认事件映射（未指定泛型时退化为宽松字符串事件，保持向后兼容） */
+declare type DefaultEventMap = Record<string, any>;
+
+/** 绘图回调函数类型 */
+export declare type DrawCallback = (event: DrawEventData) => void;
+
+/** 绘图配置接口 */
+export declare interface DrawConfig {
+    /** 填充颜色，默认 '#369' */
+    fillColor?: string;
+    /** 填充透明度，默认 0.6 */
+    fillAlpha?: number;
+    /** 边框颜色，默认 '#fff' */
+    borderColor?: string;
+    /** 边框透明度，默认 0.8 */
+    borderAlpha?: number;
+    /** 线条宽度，默认 2 */
+    lineWidth?: number;
+    /** 标签字体，默认 '14px arial' */
+    labelFont?: string;
+    /** 箭头宽度，默认 20 */
+    arrowWidth?: number;
+}
+
+/** 绘制数据类型 */
+export declare interface DrawData {
+    vertices?: Array<{
+        lng: number;
+        lat: number;
+    }>;
+    bounds?: Array<{
+        lng: number;
+        lat: number;
+    }>;
+    center?: {
+        lng: number;
+        lat: number;
+    };
+    radius?: number;
+    area?: number;
+    distance?: number;
+    bearing?: number;
+    length?: number;
+    [key: string]: unknown;
+}
+
+/** 绘制图形元素 */
+export declare interface DrawElement {
+    id: string;
+    type: DrawType;
+    coordinates: Coordinate[];
+    properties?: Record<string, any>;
+}
+
+/** 绘制事件数据 */
+export declare interface DrawEventData {
+    type: DrawType;
+    operation: OperationType;
+    id?: string;
+    data: any;
+    rawData: any;
+    /** 清空操作时携带被清除的图形数量 */
+    count?: number;
+}
+
+/** 绘制事件 */
+export declare interface DrawEvents {
+    'draw:start': {
+        type: DrawType;
+    };
+    'draw:end': DrawEventData;
+    'draw:edit': DrawEventData;
+    'draw:cancel': void;
+    'draw:delete': string;
+}
+
+/** 绘制配置 */
+export declare interface DrawStyleConfig extends StyleConfig {
+    labelFont?: string;
+    arrowWidth?: number;
+}
+
+/** 绘制配置构建上下文（由 DrawConfigManager 预计算共享样式后传入） */
+export declare interface DrawToolBuildContext {
+    bmgl: Bmgl;
+    config: Required<DrawConfig>;
+    /** 预计算的共享样式（供各绘制配置构建器复用；材质为 bmgl 不透明对象，透传即可） */
+    shared: {
+        fill: unknown;
+        border: unknown;
+        label: Record<string, unknown>;
+        width: number;
+    };
+}
+
+/** 绘制工具配置 */
+export declare interface DrawToolConfig {
+    icon: DrawType;
+    name: string;
+    size?: number;
+}
+
+/** 绘制工具注册项 */
+export declare interface DrawToolRegistryEntry {
+    /** 绘制类型（与 DrawType 对齐；自定义类型需 as DrawType 收敛） */
+    type: DrawType;
+    /** 工具名称（工具栏显示） */
+    name: string;
+    /** 默认图标尺寸（tools 配置未指定尺寸时使用） */
+    defaultSize: number;
+    /** 图标名称（与 assets/icons 对齐） */
+    icon: IconName;
+    /** 是否进入默认工具栏（false 表示仅编程式可绘制、不展示按钮，如 triangle） */
+    inDefaultToolbar?: boolean;
+    /** 默认工具栏展示顺序（升序；未指定时排末尾） */
+    toolbarOrder?: number;
+    /** 绘制配置构建器：产出 bmgl Plot.Draw enable(type) 使用的配置片段 */
+    buildConfig?: (ctx: DrawToolBuildContext) => unknown;
+}
+
+/** 绘制类型 */
+export declare type DrawType = 'polygon' | 'rectangle' | 'circle' | 'polyline' | 'area' | 'ruler' | 'azimuth' | 'triangle';
+
+/** 实体事件 */
+export declare interface EntityEvents {
+    'entity:created': EntityInfo;
+    'entity:updated': EntityInfo;
+    'entity:deleted': string;
+    'entity:clicked': EntityInfo;
+    'entity:hover': EntityInfo;
+}
+
+/** 实体信息 */
+export declare interface EntityInfo {
+    id: string;
+    type: EntityType;
+    options: EntityOptions;
+    nativeEntity: any;
+    coordinates?: any;
+}
+
+/** 实体配置 */
+export declare interface EntityOptions extends BaseOptions, StyleConfig {
+    type: EntityType;
+    coordinates?: Coordinate[];
+    lineCoordinates?: number[];
+    center?: Coordinate;
+    radius?: number;
+    point?: Coordinate;
+    pixelSize?: number;
+    pointColor?: string;
+}
+
+/** 实体类型 */
+export declare type EntityType = 'polygon' | 'line' | 'circle' | 'rectangle' | 'point';
+
+/** 错误类型 */
+export declare enum ErrorCode {
+    INIT_FAILED = "INIT_FAILED",
+    LOAD_SCRIPT_FAILED = "LOAD_SCRIPT_FAILED",
+    INVALID_PARAMS = "INVALID_PARAMS",
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    OPERATION_FAILED = "OPERATION_FAILED"
+}
+
+export declare class EventBus<TEventMap extends Record<string, any> = DefaultEventMap> {
+    private events;
+    /**
+     * 订阅事件（返回取消订阅函数）
+     */
+    on<K extends keyof TEventMap>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
+    /**
+     * 订阅一次性事件（包裹函数回挂原始引用，支持以原始引用 off）
+     */
+    once<K extends keyof TEventMap>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
+    /**
+     * 取消订阅（支持以 once 的原始处理器引用匹配包裹函数）
+     */
+    off<K extends keyof TEventMap>(event: K, handler?: EventHandler<TEventMap[K]>): void;
+    /**
+     * 触发事件
+     * 同步快速路径：全部 handler 同步返回时不进入异步管道（高频事件低开销）；
+     * 存在异步 handler 时才 await 收尾。单个处理器异常仅记录，不影响其他处理器。
+     */
+    emit<K extends keyof TEventMap>(event: K, data?: TEventMap[K]): Promise<void>;
+    /**
+     * 清空所有事件
+     */
+    clear(): void;
+    /**
+     * 获取事件统计
+     */
+    getStats(): {
+        event: string;
+        handlerCount: number;
+    }[];
+}
+
+/**
+ * 全局事件总线单例
+ * @deprecated 内部已改为每地图独立 EventBus（经 MapManager.getEventBus 获取）；
+ * 多地图场景使用全局单例会串台。仅为存量外部代码兼容保留，v2.0 移除。
+ */
+export declare const eventBus: EventBus<DefaultEventMap>;
+
+/**
+ * 事件总线 - 统一事件管理
+ * 泛型化事件地图：传入 TEventMap 后 on/emit 的事件名与载荷获得编译期约束，
+ * 防止事件名拼写错误与 payload 类型错配。
+ */
+/** 事件处理器 */
+declare type EventHandler<T = any> = (data: T) => void | Promise<void>;
+
+/** 飞行选项 */
+export declare interface FlyToOptions {
+    destination: BmglCartesian3;
+    orientation?: {
+        heading?: number;
+        pitch?: number;
+        roll?: number;
+    };
+    duration?: number;
+}
+
+/** GameLoading 组件 */
+export declare const GameLoading: DefineComponent<ExtractPropTypes<    {
+visible: {
+type: BooleanConstructor;
+default: boolean;
+};
+title: {
+type: StringConstructor;
+default: string;
+};
+subtitle: {
+type: StringConstructor;
+default: string;
+};
+}>, () => JSX.Element | null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
+visible: {
+type: BooleanConstructor;
+default: boolean;
+};
+title: {
+type: StringConstructor;
+default: string;
+};
+subtitle: {
+type: StringConstructor;
+default: string;
+};
+}>> & Readonly<{}>, {
+visible: boolean;
+title: string;
+subtitle: string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 地图几何常量 */
+export declare const GEOMETRY_CONFIG: {
+    /** 纬度每度对应米数（圆形搜索/网格计算，较精确） */
+    readonly METERS_PER_DEGREE_LAT: 111320;
+    /** 纬度每度对应米数（相机高度估算，近似值） */
+    readonly METERS_PER_DEGREE_LAT_APPROX: 111000;
+    /** 相机默认视野角（°） */
+    readonly CAMERA_FOV_DEGREES: 60;
+    /** 相机最小高度（m） */
+    readonly MIN_CAMERA_HEIGHT: 1000;
+};
+
+/**
+ * GeoServer（物探）底图源配置：配置后启用生产/物探底图切换。
+ * 令牌由业务方获取后经 token 传入，插件核心不再耦合业务鉴权逻辑。
+ */
+export declare interface GeoServerSourceConfig {
+    /** WMTS 服务地址，形如 http://host:port/geoMap/geoserver/gwc/service/wmts */
+    baseUrl: string;
+    /** WMTS 图层名（默认 PostGIS:dommap） */
+    layer?: string;
+    /** 访问令牌：由业务方在调用侧获取后传入（业务逻辑与地图解耦） */
+    token?: string;
+}
+
+/**
+ * 获取 bmgl 实例
+ * 优先返回已缓存的实例；若未缓存则尝试从 window.bmgl 读取并缓存
+ * 若都不存在返回 null
+ */
+export declare function getBmgl(): Bmgl | null;
+
+/** 获取默认工具栏注册项（inDefaultToolbar !== false，按 toolbarOrder 升序） */
+export declare function getDefaultToolbarEntries(): DrawToolRegistryEntry[];
+
+/** 派生默认工具栏工具列表（DEFAULT_TOOLS 单一来源） */
+export declare function getDefaultTools(): ToolItem[];
+
+/** 获取全部注册项（含非工具栏类型） */
+export declare function getDrawToolEntries(): DrawToolRegistryEntry[];
+
+/** 获取指定类型的注册项 */
+export declare function getDrawToolEntry(type: DrawType): DrawToolRegistryEntry | undefined;
+
+/**
+ * 根据原生实体属性判断绘图类型
+ * 与 useMapDraw 内部判断逻辑保持一致
+ */
+export declare function getEntityType(entity: BmglEntity | null | undefined): DrawType;
+
+/** 获取当前日志级别 */
+export declare function getLogLevel(): LogLevel;
+
+/** 获取状态信息 */
+export declare const getStatusInfo: (status: number | string) => {
+    color: string;
+    text: string;
+};
+
+/** 获取指定名称的 SVG（可指定颜色） */
+export declare function getSvg(name: IconName, color?: string): string;
+
+/** 图标名称 -> SVG 字符串 映射表 */
+export declare const ICON_MAP: Record<IconName, string>;
+
+/** 图标基础配置 */
+export declare interface IconBaseConfig {
+    /** 图标尺寸（px），默认 32 */
+    iconSize?: number;
+    /** 文字配置 */
+    textConfig?: IconTextConfig;
+    /** 图标缓存条目上限（LRU 淘汰），默认 8000；海量唯一名称图标场景需覆盖单批去重后的配置量级 */
+    maxIconCache?: number;
+}
+
+/** 批量创建条目 */
+export declare interface IconBatchItem {
+    status: string | number;
+    text?: string;
+    id?: string | number;
+}
+
+/** 缓存条目 */
+export declare interface IconCacheItem {
+    icon: IconImagePayload;
+    width: number;
+    height: number;
+    type: 'base' | 'text';
+    text?: string;
+    /** 状态值 */
+    status: string | number;
+    /** 状态对应颜色 */
+    color: string;
+    /** 退化标记：图片未就绪（超时/失败）生成了色块替代，不应写入缓存 */
+    degraded?: boolean;
+}
+
+/** 图标高度信息 */
+export declare interface IconHeightInfo {
+    iconHeight: number;
+    textHeight: number;
+    totalHeight: number;
+}
+
+/** 图标图片载荷：基础图标为 SVG data URL（字符串），合成文字图标为 HTMLCanvasElement。
+ *   bmgl/cesium 原生支持 HTMLCanvasElement 作为 billboard image，无需 PNG 编码，
+ *   从而避免海量唯一文字图标被逐一带像素转码成 data URL 的性能损耗。 */
+declare type IconImagePayload = string | HTMLCanvasElement;
+
+export declare class IconManager {
+    private static instance;
+    /** 图标缓存条目默认上限（LRU 淘汰，防止 data URL 无界增长；
+     *  需覆盖单批去重后的唯一配置量级，如 10 万点位/每 20 命名 = 5000 唯一名称图标） */
+    private static readonly DEFAULT_MAX_ICON_CACHE;
+    /** 图标缓存条目上限（可经 initialize 的 maxIconCache 覆盖） */
+    private maxIconCache;
+    /** 任务期缓存上限：任务进行中不淘汰，避免"先生成的图标在任务内被后续批次淘汰"导致重复合成 */
+    private static readonly TASK_MAX_ICON_CACHE;
+    /** 活跃图标任务计数（beginIconTask / endIconTask 成对维护） */
+    private activeTasks;
+    /** 图标缓存：缓存键 -> 缓存项（Map 迭代序即新近度序，命中时重插） */
+    private iconCache;
+    /** 颜色 SVG 缓存：状态 -> 替换颜色后的 SVG */
+    private colorCache;
+    /** 基础 SVG 单例缓存："SVG标识 \u0001 颜色" -> 已编码基础图标（同一"SVG|颜色"全任务只生成一次） */
+    private baseSvgCache;
+    /** SVG 源实例列表与标识映射：保证同一模板复用同一缓存条目，同时支持多个不同基础 SVG */
+    private svgKeys;
+    /** 存活基础 SVG 模板的总数（含 rawSvg 默认模板） */
+    private svgCount;
+    /** 复合文字图标缓存："SVG标识 \u0001 颜色 \u0001 文字" -> 缓存项。
+     *  支持多基础 SVG 的文字合成，且跨批次复用；主线程 canvas 直传（无 PNG 编码）。 */
+    private compositeCache;
+    /** 复合文字图标缓存条目常规上限（任务期不淘汰，仅结束后裁剪） */
+    private static readonly COMPOSITE_CACHE_CAP;
+    /** 性能基准统计（自上次重置累计）：文字图标命中/生成数 */
+    private runtimeStats;
+    /** 设备像素比 */
+    private dpr;
+    /** 原始 SVG 模板 */
+    private rawSvg;
+    /** 默认图标配置 */
+    private defaultConfig;
+    private constructor();
+    /** 当前生效的图标缓存上限（有活跃任务时放宽到任务上限，保证任务内不淘汰） */
+    private get effectiveCacheLimit();
+    /** LRU 触碰：命中缓存时重插到末尾（Map 迭代序头部为最旧） */
+    private touchCache;
+    /** LRU 淘汰：超出上限时从迭代序头部（最旧）删除 */
+    private evictCacheIfNeeded;
+    /** 获取单例实例 */
+    static getInstance(): IconManager;
+    /**
+     * 开始一个图标任务周期
+     * 任务期间图标缓存不触发 LRU 淘汰，保证首批生成的图标可被后续批次复用；
+     * 应与 endIconTask 成对调用（建议 try/finally）。
+     */
+    beginIconTask(): void;
+    /**
+     * 结束一个图标任务周期，释放任务期缓存
+     * 仅当全部任务结束时回落常规上限并裁剪多余缓存，回收内存。
+     */
+    endIconTask(): void;
+    /** 归一某 SVG 源到稳定标识，同一模板复用同一标识（支持多基础 SVG 扩展） */
+    private resolveSvgKey;
+    /** 初始化：注入 SVG 模板与配置，预生成颜色 SVG */
+    initialize(rawSvg: string, config?: Partial<IconBaseConfig>): void;
+    /** 预生成所有状态对应的颜色 SVG */
+    private preGenerateBaseColors;
+    /** 确保某状态标识的颜色 SVG 已生成（状态标识可为业务 status 或 color: 前缀的直接颜色） */
+    private ensureColoredSvg;
+    /** 生成指定颜色的 SVG（着色失败时回退圆点占位图） */
+    private buildColoredSvg;
+    /** 文字归一：去除首尾空白；undefined 保持 undefined（区分「不显示」与「空文字」） */
+    private normalizeText;
+    /** 基础图标单例生成（"SVG|颜色" 只生成一次并缓存，全任务复用；
+     *  支持点位携带不同 SVG 模板实现多基础图标扩展 */
+    private buildBaseIcon;
+    /** 创建基础图标缓存项（按指定的 SVG 模板 + 颜色单例生成） */
+    private createBaseIconCore;
+    /** 按指定 SVG 模板 + 颜色创建基础图标缓存项（多基础 SVG 扩展；对外/批量路径用） */
+    createBaseIconBySvg(svg: string, color: string): IconCacheItem;
+    /** 复合文字图标缓存键（按 SVG|色|文 归一，支持多基础 SVG） */
+    private compositeKey;
+    /** 只读探测复合文字图标缓存（不触发触碰；命中间隔读命中统计） */
+    peekTextIconBySvg(svg: string, color: string, text: string): IconResult | undefined;
+    /** 创建（含缓存）指定 SVG+色+文的复合文字图标：主线程 canvas 直传，无 PNG 编码；
+     *  结果写入 compositeCache，跨批次复用；任务期内不淘汰，结束后回落上限裁剪。 */
+    createTextIconBySvg(svg: string, color: string, text: string): Promise<IconResult>;
+    /** 复合文字图标缓存 LRU 淘汰（常规上限；任务期不触发） */
+    private evictCompositeCacheIfNeeded;
+    /** 缓存是否命中且匹配请求 */
+    private matchCache;
+    /** 创建图标（带缓存；退化结果不缓存，下次调用重试生成） */
+    createIcon(status: string | number, text?: string): Promise<IconResult>;
+    /** 按直接颜色创建图标（不经过状态色映射；缓存键与业务 status 隔离） */
+    createIconByColor(color: string, text?: string): Promise<IconResult>;
+    /** 创建图标核心流程（状态标识 + 已解析颜色；带缓存，退化结果不缓存） */
+    private createIconCore;
+    /** 批量创建图标（按状态分组 + 分片并发） */
+    batchCreateIcons(items: IconBatchItem[]): Promise<Map<string, IconResult>>;
+    /**
+     * 面向点位的批量图标创建（调用方仅需传入点位信息数组）
+     *
+     * 智能复用：按「颜色 + 合成文字」去重，相同配置的点位共享同一 icon 引用；
+     * 文字图标主线程 canvas 直传合成，无 PNG 编码。
+     * 结果直接回填到入参对象（icon/width/height），可直接传给 loadPoints。
+     *
+     * @param points 点位信息数组（如 [{ ...点位基础信息, color, showName }]）
+     * @returns 与输入同序、已回填 icon/width/height 的点位数组
+     */
+    batchCreatePointIcons<T extends PointIconItem>(points: T[]): Promise<(T & Pick<IconResult, 'icon' | 'width' | 'height'>)[]>;
+    /** 根据条件创建图标：条件返回文字则显示文字，否则仅基础图标 */
+    createConditionalIcon(status: string | number, condition: () => string | null | undefined): Promise<IconResult>;
+    /** 获取图标高度信息（图标 + 文字区域） */
+    getIconHeightInfo(): IconHeightInfo;
+    /** 清空全部缓存并重建颜色 SVG（同时重读设备像素比，适配跨屏拖动场景） */
+    clearCache(): void;
+    /** 清除某状态的所有相关缓存 */
+    clearCacheByStatus(status: string | number): void;
+    /** 清除指定文字的图标缓存 */
+    clearTextIconCache(status: string | number, text: string): void;
+    /** 获取缓存统计 */
+    getCacheStats(): {
+        iconCache: number;
+        colorCache: number;
+        baseSvg: number;
+        composite: number;
+        total: number;
+    };
+    /** 获取性能基准统计（文字图标命中/生成累计；clearCache 时重置） */
+    getRuntimeStats(): {
+        textHits: number;
+        textGenerated: number;
+        uniqueText: number;
+    };
+    /** 获取当前配置 */
+    getConfig(): IconBaseConfig;
+    /** 更新状态颜色映射（入参为「状态 -> 颜色」纯色映射） */
+    updateStatusColorMap(newMap: StatusColorMap): void;
+    /** 获取当前状态颜色映射（纯色形式） */
+    getStatusColorMap(): StatusColorMap;
+    /** 回退文字图标（供 canvas 内部异常时使用） */
+    buildFallbackTextIcon(base: IconCacheItem, text: string): IconCacheItem;
+}
+
+/** 图标管理器单例 */
+export declare const iconManager: IconManager;
+
+/**
+ * 图标注册表
+ * 静态引入全部 SVG 资源（经 Vite ?raw 内联为字符串），
+ * 供 AppIcon 组件按名称渲染并支持颜色替换。
+ */
+/** 图标名称联合类型 */
+export declare type IconName = '2d' | '3d' | 'area' | 'aim' | 'azimuth' | 'base' | 'circle' | 'clear' | 'contour' | 'delete' | 'location' | 'polygon' | 'polyline' | 'rectangle' | 'ruler' | 'search' | 'track' | 'triangle' | 'view' | 'weather';
+
+/** 图标生成结果 */
+export declare interface IconResult {
+    /** 图标图片载荷（SVG data URL 或合成后的 canvas） */
+    icon: IconImagePayload;
+    /** 图标宽度（像素） */
+    width: number;
+    /** 图标高度（像素） */
+    height: number;
+    /** 图标类型：'base' 基础图标 | 'text' 带文字图标 */
+    type: 'base' | 'text';
+    /** 若带文字则包含文字内容 */
+    text?: string;
+}
+
+/** 文字图标文本配置 */
+export declare interface IconTextConfig {
+    /** 字号（px），默认 12 */
+    fontSize?: number;
+    /** 文字颜色，默认 #FFFFFF */
+    textColor?: string;
+    /** 文字背景色，默认 rgba(0,0,0,0.6) */
+    textBgColor?: string;
+    /** 文字内边距（px），默认 4 */
+    padding?: number;
+    /** 是否圆角背景，默认 true */
+    rounded?: boolean;
+    /** 背景圆角半径（px），默认 4 */
+    borderRadius?: number;
+}
+
+/** 判断是否为合法的图标名称 */
+export declare function isIconName(name: string): name is IconName;
+
+/** 图层配置 */
+export declare interface LayerConfig {
+    id: string;
+    type: 'imagery' | 'wmts' | 'geojson';
+    url: string;
+    visible?: boolean;
+    opacity?: number;
+    zIndex?: number;
+}
+
+/**
+ * 脚本加载器
+ * 用于动态加载 BigMap/Cesium 相关脚本与样式，支持依赖解析、去重与并发控制。
+ */
+/** 库资源配置 */
+export declare interface LibConfig {
+    /** 库名称 */
+    name: string;
+    /** 资源路径（以 /libs 开头为随包发布的本地库，以 / 开头拼接到 serverUrl） */
+    path: string;
+    /** 是否为 CSS 资源 */
+    isCss?: boolean;
+    /** 依赖的库键名 */
+    dependencies?: string[];
+}
+
+/** 预定义库配置 */
+export declare const LIBRARIES: Record<string, LibConfig>;
+
+/** 3D 光源配置 */
+export declare interface LightingConfig {
+    /** 是否开启光源自动设置（按系统时间判断白天/黄昏/夜晚，默认 false） */
+    enabled?: boolean;
+    /** 白天起始小时（0-23，默认 6；[dayStartHour, duskStartHour) 为白天） */
+    dayStartHour?: number;
+    /** 黄昏起始小时（0-23，默认 18；[duskStartHour, nightStartHour) 为黄昏） */
+    duskStartHour?: number;
+    /** 夜晚起始小时（0-23，默认 20；其余为夜晚） */
+    nightStartHour?: number;
+    /** 当前时间提供器（默认读取系统时间；测试/演示可注入） */
+    now?: () => Date;
+}
+
+/**
+ * 3D 光源（时间光照）类型定义
+ * 依据当前系统时间自动判定周期（白天/黄昏/夜晚）并切换 3D 场景光源，
+ * 基于 git 示例 scripts/2D天气.html 中的光照思路（SunLight / 黄昏暖色 / 月光）。
+ */
+/** 光照周期：白天 / 黄昏 / 夜晚 */
+export declare type LightingPeriod = 'day' | 'dusk' | 'night';
+
+/** 3D 光源状态（响应式） */
+export declare interface LightingState {
+    /** 是否开启光源（默认 false，不开启保持地图默认光照） */
+    enabled: boolean;
+    /** 周期来源：auto=按系统时间自动判断；manual=手动指定周期 */
+    mode: 'auto' | 'manual';
+    /** 当前生效的日期周期 */
+    period: LightingPeriod;
+    /** auto 模式判定使用的小时（0-23） */
+    hour: number;
+}
+
+/** 统一日志器（API 与 console 对齐，替换成本最低） */
+export declare const logger: {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+
+/**
+ * 统一日志器
+ * 收敛全库散落的 console 调用：级别开关 + 统一前缀。
+ * 默认级别：生产环境（NODE_ENV=production）仅输出 warn 及以上；其余环境输出全部。
+ * 宿主可通过 setLogLevel 运行时调整（如调试时开启 debug、CI 中静默为 silent）。
+ */
+/** 日志级别（silent 表示完全静默） */
+export declare type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+
+/** MapView 从 MapConfig 消费的字段清单（单一来源：MapViewProps 类型与组件 config 映射均由此派生） */
+declare const MAP_VIEW_CONFIG_KEYS: readonly ["containerId", "position", "serverUrl", "libsUrl", "showSearch", "showControls", "showDeleteControls", "showStatus", "tools", "searchDebounceTime", "wmtsUrlProvider", "geoserver", "contourConfig", "lightingConfig"];
+
+/** 地图实例 API（MapContainer/MapView 组件 expose 的完整能力集） */
+export declare interface MapApi {
+    /** 地图实例 */
+    map: Ref<MapViewer | null>;
+    /** 地图状态 */
+    state: Ref<MapState>;
+    /** 飞行到指定经纬度（高度缺省时使用默认高度） */
+    setView: (lng: number, lat: number, height?: number) => void;
+    /** 批量加载点位（带加载态；mode 为 replace 时先清空再加载） */
+    loadPoints: (points: Record<string, any>[], config?: PointConfig, searchFields?: string[], mode?: 'replace' | 'append') => Promise<void>;
+    /** 文本搜索点位（多字段任一命中即返回） */
+    searchByText: (config: TextSearchConfig) => PointData[];
+    /** 形状搜索点位（矩形/圆形/多边形/三角形） */
+    searchByShape: (shape: SearchShape) => PointData[];
+    /** 更新点位（图标/尺寸） */
+    updatePoints: (points: Record<string, any>[]) => Promise<void>;
+    /** 清空全部点位 */
+    clearPoints: () => Promise<void>;
+    /** 开始绘制指定图形 */
+    startDrawing: (drawType: DrawType) => void;
+    /** 停止当前绘制 */
+    stopDrawing: () => void;
+    /** 清除全部绘制图形 */
+    clearDrawings: () => void;
+    /** 移除指定绘制图形（不传则取消当前绘制） */
+    removeDrawing: (targetId?: string) => void;
+    /** 绘制实体（返回实体 ID，失败返回 null） */
+    drawEntity: (options: EntityOptions) => Promise<string | null>;
+    /** 删除实体（不传 ID 则删除全部） */
+    deleteEntity: (id?: string) => boolean;
+    /** 切换"地图名称"注记开关 */
+    setMapNameVisible: (visible: boolean) => void;
+    /** 切换等高线显示（仅 3D 模式有效，2D 自动关闭） */
+    setContourVisible: (visible: boolean) => void;
+    /** 轨迹回放状态（响应式：status/currentTime/duration/progress/pointCount） */
+    trajectoryState: Ref<TrajectoryState>;
+    /** 加载轨迹并创建可视化（2D/3D 均可用；成功且 autoPlay 时自动播放） */
+    loadTrajectory: (track: TrackPoint[], config?: Partial<TrajectoryConfig>) => void;
+    /** 开始/继续轨迹回放 */
+    playTrajectory: () => void;
+    /** 暂停轨迹回放 */
+    pauseTrajectory: () => void;
+    /** 停止轨迹回放并回到起点 */
+    stopTrajectory: () => void;
+    /** 调整轨迹回放速度倍率 */
+    setTrajectorySpeed: (speed: number) => void;
+    /** 跳转到指定时间点（秒） */
+    jumpTrajectoryTo: (time: number) => void;
+    /** 移除轨迹可视化并复位状态 */
+    clearTrajectory: () => void;
+    /** 遮罩反选状态（响应式：visible/hasMask/boundaryCount） */
+    maskState: Ref<MaskState>;
+    /** 设置遮罩反选（boundary 为保留区域边界环；遮罩其外区域，2D/3D 均可用，模式切换自动重建） */
+    setMask: (boundary: Coordinate[], config?: Partial<MaskConfig>) => void;
+    /** 切换遮罩显隐（保留边界数据） */
+    setMaskVisible: (visible: boolean) => void;
+    /** 清除遮罩并复位状态 */
+    clearMask: () => void;
+    /** 天气状态（响应式：type/active） */
+    weatherState: Ref<WeatherState>;
+    /** 切换天气特效（clear=晴/无；rain=下雨；snow=下雪），2D/3D 通用 */
+    setWeather: (type: WeatherType, config?: Partial<WeatherConfig>) => void;
+    /** 清除天气特效 */
+    clearWeather: () => void;
+    /** 3D 光源状态（响应式：enabled/mode/period/hour） */
+    lightingState: Ref<LightingState>;
+    /** 开/关光源（auto 模式按系统时间判断白天/黄昏/夜晚；默认关闭，仅 3D 模式生效，关闭还原开启前光照） */
+    setLightingEnabled: (enabled: boolean) => void;
+    /** 设置光源周期来源：'auto'=按系统时间自动判断；或手动指定 day/dusk/night */
+    setLightingPeriod: (period: LightingPeriod | 'auto') => void;
+    /** 切换主题（浅色/暗色） */
+    setTheme: (theme: Theme) => void;
+}
+
+/** 事件回调集（聚合配置时使用） */
+export declare interface MapCallbacks {
+    onInit?: (mapInstance: MapViewer | null) => void;
+    onClick?: (position: {
+        lng: number;
+        lat: number;
+    }, data?: Record<string, unknown>) => void;
+    onMouseMove?: (position: {
+        lng: number;
+        lat: number;
+    }) => void;
+    onDrawEnd?: (event: DrawEventData) => void;
+    onPointClick?: (point: BasePointConfig) => void;
+    onPointMouseOver?: (point: BasePointConfig) => void;
+    onLayerChange?: (layers: LayerConfig[]) => void;
+}
+
+/** 地图配置 */
+export declare interface MapConfig {
+    /** 容器ID */
+    containerId?: string;
+    /** 地图资源/瓦片服务器地址（由使用方传入，用于加载地图库与瓦片数据） */
+    serverUrl?: string;
+    /** 库文件地址 */
+    libsUrl?: string;
+    /** 地图类型 */
+    mapType?: MapType;
+    /** 初始位置 */
+    position?: Position;
+    /** 地图ID */
+    mapId?: string;
+    /** 地形ID */
+    terrainId?: string;
+    /** 是否显示加载动画 */
+    showLoading?: boolean;
+    /** 是否显示顶部搜索组件 */
+    showSearch?: boolean;
+    /** 是否显示右侧工具栏（整体显隐，默认 true） */
+    showControls?: boolean;
+    /** 是否显示清除绘制按钮 */
+    showDeleteControls?: boolean;
+    /** 是否显示底部 FPS 状态组件 */
+    showStatus?: boolean;
+    /** 右侧工具栏绘制工具列表 */
+    tools?: ToolItem[];
+    /** 搜索防抖延迟（ms） */
+    searchDebounceTime?: number;
+    /** 生产底图 WMTS URL 提供器（优先于 geoserver 静态配置） */
+    wmtsUrlProvider?: () => Promise<string>;
+    /** GeoServer（物探）底图源配置：配置后启用生产/物探底图切换 */
+    geoserver?: GeoServerSourceConfig;
+    /** 等高线显示配置（3D 模式"等高线"开关参数，可选项，默认见 DEFAULT_CONTOUR_CONFIG） */
+    contourConfig?: Partial<ContourConfig>;
+    /** 是否开启光源自动设置（按当前系统时间判断白天/黄昏/夜晚；默认 false，仅 3D 模式生效） */
+    lightingConfig?: boolean;
+    /** 自定义扩展库配置：按库键名覆盖默认库（路径/依赖）或新增自有依赖库（如自定义绘图插件），无需改包内代码 */
+    extraLibs?: Record<string, Partial<LibConfig>>;
+}
+
+export declare const MapContainer: DefineComponent<ExtractPropTypes<    {
+/**
+* 是否显示搜索栏（旧版命名，语义反转保留兼容）
+* @deprecated v2.0 移除，请使用 showSearch
+*/
+hideSearch: {
+type: BooleanConstructor;
+default: undefined;
+};
+theme: {
+type: PropType<Theme | undefined>;
+default: string;
+};
+popupConfig: {
+type: PropType<PopupDisplayConfig | undefined>;
+default: () => undefined;
+};
+position: {
+type: PropType<Position | undefined>;
+default: undefined;
+};
+containerId: {
+type: PropType<string | undefined>;
+default: undefined;
+};
+serverUrl: {
+type: PropType<string | undefined>;
+default: undefined;
+};
+libsUrl: {
+type: PropType<string | undefined>;
+default: undefined;
+};
+showSearch: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+showControls: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+showDeleteControls: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+showStatus: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+tools: {
+type: PropType<ToolItem[] | undefined>;
+default: undefined;
+};
+searchDebounceTime: {
+type: PropType<number | undefined>;
+default: undefined;
+};
+wmtsUrlProvider: {
+type: PropType<(() => Promise<string>) | undefined>;
+default: undefined;
+};
+geoserver: {
+type: PropType<GeoServerSourceConfig | undefined>;
+default: undefined;
+};
+contourConfig: {
+type: PropType<Partial<ContourConfig> | undefined>;
+default: undefined;
+};
+lightingConfig: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+config: {
+type: PropType<Partial<MapConfig>>;
+default: undefined;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("error" | "clear-button-click" | "clear-draw" | "expose" | "draw-end" | "draw-delete" | "draw-clear" | "ready" | "init" | "point-click")[], "error" | "clear-button-click" | "clear-draw" | "expose" | "draw-end" | "draw-delete" | "draw-clear" | "ready" | "init" | "point-click", PublicProps, Readonly<ExtractPropTypes<    {
+/**
+* 是否显示搜索栏（旧版命名，语义反转保留兼容）
+* @deprecated v2.0 移除，请使用 showSearch
+*/
+hideSearch: {
+type: BooleanConstructor;
+default: undefined;
+};
+theme: {
+type: PropType<Theme | undefined>;
+default: string;
+};
+popupConfig: {
+type: PropType<PopupDisplayConfig | undefined>;
+default: () => undefined;
+};
+position: {
+type: PropType<Position | undefined>;
+default: undefined;
+};
+containerId: {
+type: PropType<string | undefined>;
+default: undefined;
+};
+serverUrl: {
+type: PropType<string | undefined>;
+default: undefined;
+};
+libsUrl: {
+type: PropType<string | undefined>;
+default: undefined;
+};
+showSearch: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+showControls: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+showDeleteControls: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+showStatus: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+tools: {
+type: PropType<ToolItem[] | undefined>;
+default: undefined;
+};
+searchDebounceTime: {
+type: PropType<number | undefined>;
+default: undefined;
+};
+wmtsUrlProvider: {
+type: PropType<(() => Promise<string>) | undefined>;
+default: undefined;
+};
+geoserver: {
+type: PropType<GeoServerSourceConfig | undefined>;
+default: undefined;
+};
+contourConfig: {
+type: PropType<Partial<ContourConfig> | undefined>;
+default: undefined;
+};
+lightingConfig: {
+type: PropType<boolean | undefined>;
+default: undefined;
+};
+config: {
+type: PropType<Partial<MapConfig>>;
+default: undefined;
+};
+}>> & Readonly<{
+onError?: ((...args: any[]) => any) | undefined;
+"onClear-button-click"?: ((...args: any[]) => any) | undefined;
+"onClear-draw"?: ((...args: any[]) => any) | undefined;
+onExpose?: ((...args: any[]) => any) | undefined;
+"onDraw-end"?: ((...args: any[]) => any) | undefined;
+"onDraw-delete"?: ((...args: any[]) => any) | undefined;
+"onDraw-clear"?: ((...args: any[]) => any) | undefined;
+onReady?: ((...args: any[]) => any) | undefined;
+onInit?: ((...args: any[]) => any) | undefined;
+"onPoint-click"?: ((...args: any[]) => any) | undefined;
+}>, {
+position: Position | undefined;
+config: Partial<MapConfig>;
+containerId: string | undefined;
+serverUrl: string | undefined;
+libsUrl: string | undefined;
+showSearch: boolean | undefined;
+showControls: boolean | undefined;
+showDeleteControls: boolean | undefined;
+showStatus: boolean | undefined;
+tools: ToolItem[] | undefined;
+searchDebounceTime: number | undefined;
+wmtsUrlProvider: (() => Promise<string>) | undefined;
+geoserver: GeoServerSourceConfig | undefined;
+contourConfig: Partial<ContourConfig> | undefined;
+lightingConfig: boolean | undefined;
+theme: Theme | undefined;
+popupConfig: PopupDisplayConfig | undefined;
+hideSearch: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * 组件属性：地图配置字段（单一类型源 MapViewProps，字段新增只需改一处）
+ * + 统一 config 对象（默认值 → config → 显式 props 覆盖）+ hideSearch 旧版兼容。
+ */
+export declare interface MapContainerProps extends MapViewProps {
+    /** 统一配置对象（默认值 → config → 显式 props 覆盖） */
+    config?: Partial<MapConfig>;
+    /**
+     * 是否显示搜索栏（旧版命名，语义反转保留兼容）
+     * @deprecated v2.0 移除，请使用 showSearch
+     */
+    hideSearch?: boolean;
+}
+
+/** MapControls 组件 */
+export declare const MapControls: DefineComponent<ExtractPropTypes<    {
+showDeleteControls: {
+type: BooleanConstructor;
+default: boolean;
+};
+mapType: {
+type: StringConstructor;
+default: string;
+};
+mapBase: {
+type: StringConstructor;
+default: string;
+};
+currentDrawType: {
+type: StringConstructor;
+default: null;
+};
+mapNameVisible: {
+type: BooleanConstructor;
+default: boolean;
+};
+contourVisible: {
+type: BooleanConstructor;
+default: boolean;
+};
+tools: {
+type: PropType<ToolItem[]>;
+default: () => ToolItem[];
+};
+showBaseSwitch: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("delete" | "toggle-map-type" | "toggle-map-base" | "start-drawing" | "toggle-map-view" | "toggle-map-name" | "toggle-contour")[], "delete" | "toggle-map-type" | "toggle-map-base" | "start-drawing" | "toggle-map-view" | "toggle-map-name" | "toggle-contour", PublicProps, Readonly<ExtractPropTypes<    {
+showDeleteControls: {
+type: BooleanConstructor;
+default: boolean;
+};
+mapType: {
+type: StringConstructor;
+default: string;
+};
+mapBase: {
+type: StringConstructor;
+default: string;
+};
+currentDrawType: {
+type: StringConstructor;
+default: null;
+};
+mapNameVisible: {
+type: BooleanConstructor;
+default: boolean;
+};
+contourVisible: {
+type: BooleanConstructor;
+default: boolean;
+};
+tools: {
+type: PropType<ToolItem[]>;
+default: () => ToolItem[];
+};
+showBaseSwitch: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>> & Readonly<{
+onDelete?: ((...args: any[]) => any) | undefined;
+"onToggle-map-type"?: ((...args: any[]) => any) | undefined;
+"onToggle-map-base"?: ((...args: any[]) => any) | undefined;
+"onStart-drawing"?: ((...args: any[]) => any) | undefined;
+"onToggle-map-view"?: ((...args: any[]) => any) | undefined;
+"onToggle-map-name"?: ((...args: any[]) => any) | undefined;
+"onToggle-contour"?: ((...args: any[]) => any) | undefined;
+}>, {
+mapType: string;
+showDeleteControls: boolean;
+tools: ToolItem[];
+contourVisible: boolean;
+mapBase: string;
+currentDrawType: string;
+mapNameVisible: boolean;
+showBaseSwitch: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 组件属性 */
+export declare interface MapControlsProps {
+    /** 是否显示清除绘制按钮 */
+    showDeleteControls?: boolean;
+    /** 当前地图类型 */
+    mapType?: '3d' | '2d';
+    /** 当前底图类型 */
+    mapBase?: 'bigemap' | 'geoserver';
+    /** 当前激活的绘制类型 */
+    currentDrawType?: DrawType | null;
+    /** 是否显示地图名称注记图层（"地图名称"开关状态，默认关闭） */
+    mapNameVisible?: boolean;
+    /** 等高线开关状态（仅 3D 模式显示与生效） */
+    contourVisible?: boolean;
+    /** 绘制工具列表 */
+    tools?: MapToolItem[];
+    /** 是否启用生产/物探底图切换（已配置生产地图源信息时为 true） */
+    showBaseSwitch?: boolean;
+}
+
+/** MapError 组件 */
+export declare const MapError: DefineComponent<ExtractPropTypes<    {
+visible: {
+type: BooleanConstructor;
+default: boolean;
+};
+title: {
+type: StringConstructor;
+default: string;
+};
+message: {
+type: StringConstructor;
+default: string;
+};
+}>, () => JSX.Element | null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, "retry"[], "retry", PublicProps, Readonly<ExtractPropTypes<    {
+visible: {
+type: BooleanConstructor;
+default: boolean;
+};
+title: {
+type: StringConstructor;
+default: string;
+};
+message: {
+type: StringConstructor;
+default: string;
+};
+}>> & Readonly<{
+onRetry?: ((...args: any[]) => any) | undefined;
+}>, {
+visible: boolean;
+title: string;
+message: string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 自定义错误类 */
+export declare class MapErrorClass extends Error {
+    code: ErrorCode;
+    details?: any;
+    constructor(message: string, code: ErrorCode, details?: any);
+}
+
+/**
+ * MapError - 地图错误状态组件（TSX）
+ * 初始化失败等致命错误时替换加载动画展示：图标 + 标题 + 描述 + 重试按钮。
+ * 视觉语言与 GameLoading 一致（暗色卡片 / 系统蓝强调 / 双层阴影）。
+ */
+/** 组件属性 */
+export declare interface MapErrorProps {
+    /** 是否显示 */
+    visible?: boolean;
+    /** 错误标题 */
+    title?: string;
+    /** 错误描述 */
+    message?: string;
+}
+
+/** 地图事件类型 */
+export declare interface MapEvents {
+    'map:ready': void;
+    'map:click': MousePosition;
+    'map:move': MousePosition;
+    'map:camera-changed': CameraPosition;
+    'map:zoom-end': {
+        zoom: number;
+    };
+    'map:mode-changed': MapType;
+    'map:bounds-changed': Bounds;
+    'map:error': Error;
+}
+
+/** 地图实例入参（支持 Ref 或直接实例） */
+declare type MapInput = Ref<MapViewer | null> | MapViewer | null | undefined;
+
+export declare class MapManager {
+    private static instance;
+    private entries;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): MapManager;
+    /**
+     * 注册地图实例
+     */
+    register(id: string, map: MapViewer, eventBus: EventBus, resourceManager: ResourceManager): void;
+    /**
+     * 获取地图实例
+     */
+    get(id: string): MapViewer | undefined;
+    /**
+     * 检查指定 ID 的地图实例是否已注册
+     * 用于 re-entry 场景检测残留条目
+     */
+    has(id: string): boolean;
+    /**
+     * 获取事件总线
+     */
+    getEventBus(id: string): EventBus | undefined;
+    /**
+     * 获取资源管理器
+     */
+    getResourceManager(id: string): ResourceManager | undefined;
+    /**
+     * 注销地图实例
+     */
+    unregister(id: string): Promise<void>;
+    /**
+     * 获取所有地图ID
+     */
+    getAllMapIds(): string[];
+    /**
+     * 清理所有地图
+     */
+    cleanupAll(): Promise<void>;
+}
+
+export declare const mapManager: MapManager;
+
+/** 地图模式 */
+export declare type MapMode = 'normal' | 'satellite' | 'terrain';
+
+/** 地图状态 */
+export declare interface MapState {
+    isReady: boolean;
+    isLoading: boolean;
+    mapType: MapType;
+    cameraPosition: CameraPosition;
+    bounds: Bounds | null;
+    error: Error | null;
+}
+
+/** MapStatus 组件 */
+export declare const MapStatus: DefineComponent<ExtractPropTypes<    {
+map: {
+type: PropType<MapViewer | Ref<MapViewer | null, MapViewer | null> | null>;
+default: null;
+};
+mapBase: {
+type: StringConstructor;
+default: string;
+};
+visible: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>, () => JSX.Element | null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
+map: {
+type: PropType<MapViewer | Ref<MapViewer | null, MapViewer | null> | null>;
+default: null;
+};
+mapBase: {
+type: StringConstructor;
+default: string;
+};
+visible: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>> & Readonly<{}>, {
+visible: boolean;
+map: MapViewer | Ref<MapViewer | null, MapViewer | null> | null;
+mapBase: string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 组件属性 */
+export declare interface MapStatusProps {
+    /** 地图实例（Ref） */
+    map: Ref<MapViewer | null> | MapViewer | null;
+    /** 当前底图源（2D 模式显示图层名） */
+    mapBase?: 'bigemap' | 'geoserver';
+    /** 是否显示 */
+    visible?: boolean;
+}
+
+/** 工具项定义（兼容旧命名导出） */
+export declare type MapToolItem = ToolItem;
+
+/** MapTools 组件 */
+export declare const MapTools: DefineComponent<ExtractPropTypes<    {
+showSearch: {
+type: BooleanConstructor;
+default: boolean;
+};
+theme: {
+type: PropType<Theme>;
+default: string;
+};
+filteredList: {
+type: PropType<SearchResultItem[]>;
+default: () => never[];
+};
+showResults: {
+type: BooleanConstructor;
+default: boolean;
+};
+input: {
+type: StringConstructor;
+default: string;
+};
+isSearching: {
+type: BooleanConstructor;
+default: boolean;
+};
+searchError: {
+type: BooleanConstructor;
+default: boolean;
+};
+highlightIndex: {
+type: NumberConstructor;
+default: number;
+};
+selectedIndex: {
+type: NumberConstructor;
+default: number;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("result-click" | "result-hover" | "result-leave" | "search-input" | "search-focus" | "search-clear" | "search-close" | "search-navigate" | "search-select")[], "result-click" | "result-hover" | "result-leave" | "search-input" | "search-focus" | "search-clear" | "search-close" | "search-navigate" | "search-select", PublicProps, Readonly<ExtractPropTypes<    {
+showSearch: {
+type: BooleanConstructor;
+default: boolean;
+};
+theme: {
+type: PropType<Theme>;
+default: string;
+};
+filteredList: {
+type: PropType<SearchResultItem[]>;
+default: () => never[];
+};
+showResults: {
+type: BooleanConstructor;
+default: boolean;
+};
+input: {
+type: StringConstructor;
+default: string;
+};
+isSearching: {
+type: BooleanConstructor;
+default: boolean;
+};
+searchError: {
+type: BooleanConstructor;
+default: boolean;
+};
+highlightIndex: {
+type: NumberConstructor;
+default: number;
+};
+selectedIndex: {
+type: NumberConstructor;
+default: number;
+};
+}>> & Readonly<{
+"onResult-click"?: ((...args: any[]) => any) | undefined;
+"onResult-hover"?: ((...args: any[]) => any) | undefined;
+"onResult-leave"?: ((...args: any[]) => any) | undefined;
+"onSearch-input"?: ((...args: any[]) => any) | undefined;
+"onSearch-focus"?: ((...args: any[]) => any) | undefined;
+"onSearch-clear"?: ((...args: any[]) => any) | undefined;
+"onSearch-close"?: ((...args: any[]) => any) | undefined;
+"onSearch-navigate"?: ((...args: any[]) => any) | undefined;
+"onSearch-select"?: ((...args: any[]) => any) | undefined;
+}>, {
+showSearch: boolean;
+input: string;
+theme: Theme;
+highlightIndex: number;
+selectedIndex: number;
+filteredList: SearchResultItem[];
+showResults: boolean;
+isSearching: boolean;
+searchError: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 组件属性 */
+export declare interface MapToolsProps {
+    /** 是否显示搜索栏（正向语义；旧版 hideSearch 兼容已由 MapContainer 归一化） */
+    showSearch?: boolean;
+    /** 主题（浅色/暗色），透传给 Teleport 至 body 的结果面板以应用主题变量 */
+    theme?: Theme;
+    /** 过滤后的结果列表 */
+    filteredList?: SearchResultItem[];
+    /** 是否显示结果面板 */
+    showResults?: boolean;
+    /** 当前搜索词（受控） */
+    input?: string;
+    /** 是否搜索中 */
+    isSearching?: boolean;
+    /** 搜索是否失败（展示错误文案而非"无结果"） */
+    searchError?: boolean;
+    /** 高亮索引 */
+    highlightIndex?: number;
+    /** 选中索引 */
+    selectedIndex?: number;
+}
+
+/** 地图类型 */
+export declare type MapType = '2d' | '3d';
+
+/** MapView 组件 */
+export declare const MapView: DefineComponent<ExtractPropTypes<    {
+/** 统一地图配置（由 MapContainer 归一化后传入，单一配置源） */
+config: {
+type: PropType<Partial<MapConfig>>;
+default: undefined;
+};
+theme: {
+type: PropType<Theme | undefined>;
+default: string;
+};
+popupConfig: {
+type: PropType<PopupDisplayConfig | undefined>;
+default: () => undefined;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("error" | "clear-button-click" | "clear-draw" | "expose" | "draw-end" | "draw-delete" | "draw-clear" | "ready" | "init" | "point-click" | "error-retry")[], "error" | "clear-button-click" | "clear-draw" | "expose" | "draw-end" | "draw-delete" | "draw-clear" | "ready" | "init" | "point-click" | "error-retry", PublicProps, Readonly<ExtractPropTypes<    {
+/** 统一地图配置（由 MapContainer 归一化后传入，单一配置源） */
+config: {
+type: PropType<Partial<MapConfig>>;
+default: undefined;
+};
+theme: {
+type: PropType<Theme | undefined>;
+default: string;
+};
+popupConfig: {
+type: PropType<PopupDisplayConfig | undefined>;
+default: () => undefined;
+};
+}>> & Readonly<{
+onError?: ((...args: any[]) => any) | undefined;
+"onClear-button-click"?: ((...args: any[]) => any) | undefined;
+"onClear-draw"?: ((...args: any[]) => any) | undefined;
+onExpose?: ((...args: any[]) => any) | undefined;
+"onDraw-end"?: ((...args: any[]) => any) | undefined;
+"onDraw-delete"?: ((...args: any[]) => any) | undefined;
+"onDraw-clear"?: ((...args: any[]) => any) | undefined;
+onReady?: ((...args: any[]) => any) | undefined;
+onInit?: ((...args: any[]) => any) | undefined;
+"onPoint-click"?: ((...args: any[]) => any) | undefined;
+"onError-retry"?: ((...args: any[]) => any) | undefined;
+}>, {
+config: Partial<MapConfig>;
+theme: Theme | undefined;
+popupConfig: PopupDisplayConfig | undefined;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** MapView 消费的 MapConfig 字段联合类型 */
+declare type MapViewConfigKey = (typeof MAP_VIEW_CONFIG_KEYS)[number];
+
+/** 地图实例接口（成员类型对接 bmgl.types 受控不透明类型） */
+export declare interface MapViewer {
+    scene: {
+        canvas: HTMLCanvasElement;
+        globe: {
+            ellipsoid: BmglEllipsoid;
+            tilesLoaded: boolean;
+            tileLoadProgressEvent: {
+                [key: string]: any;
+            };
+            depthTestAgainstTerrain: boolean;
+            /** 地表材质（等高线功能经此切换，undefined 表示默认地表） */
+            material?: BmglMaterial;
+            [key: string]: any;
+        };
+        primitives: BmglPrimitiveCollection;
+        pick: (position: BmglCartesian2) => BmglScenePick | undefined;
+        [key: string]: any;
+    };
+    camera: {
+        position: BmglCartesian3;
+        changed: {
+            [key: string]: any;
+        };
+        pickEllipsoid: (position: BmglCartesian2, ellipsoid?: BmglEllipsoid) => BmglCartesian3 | undefined;
+        flyTo: (options: FlyToOptions) => void;
+        setView: (options: SetViewOptions) => void;
+        computeViewRectangle: () => BmglRectangle | undefined;
+        [key: string]: any;
+    };
+    entities: {
+        add: (entity: BmglEntity) => BmglEntity;
+        remove: (entity: BmglEntity) => void;
+        removeAll: () => void;
+        getById: (id: string) => BmglEntity | undefined;
+        [key: string]: any;
+    };
+    screenSpaceEventHandler: BmglScreenSpaceEventHandler;
+    imageryLayers: BmglImageryLayerCollection;
+    destroy: () => void;
+    isDestroyed?: () => boolean;
+    [key: string]: any;
+}
+
+/** 组件钩子（事件与实例暴露） */
+export declare interface MapViewHooks {
+    emit: (event: string, ...args: unknown[]) => void;
+    /** 暴露地图实例 API（受 MapApi 类型约束，新增方法时编译器强制契约同步） */
+    expose: (exposed: MapApi) => void;
+    onPointClick: (point: Record<string, any>) => void;
+}
+
+/** 组件外部属性：从 MapConfig 派生 UI 相关字段（单一配置源），补充视图编排专有字段 */
+export declare interface MapViewProps extends Pick<MapConfig, MapViewConfigKey> {
+    /** 主题（浅色/暗色，默认暗色） */
+    theme?: Theme;
+    /** 弹窗展示配置（字段/主题色） */
+    popupConfig?: PopupDisplayConfig;
+}
+
+/** 遮罩反选配置（全部可选，缺省值见 DEFAULT_MASK_CONFIG） */
+export declare interface MaskConfig {
+    /** 遮罩填充色，默认 #000000 */
+    fillColor?: string;
+    /** 遮罩填充透明度（0 ~ 1），默认 0.8 */
+    fillAlpha?: number;
+    /** 保留区域边界发光线颜色，默认 #44d5ff */
+    outlineColor?: string;
+    /** 保留区域边界发光线透明度，默认 1 */
+    outlineAlpha?: number;
+    /** 保留区域边界发光线宽（px），默认 4 */
+    outlineWidth?: number;
+    /** 是否绘制保留区域边界发光线，默认 true */
+    showOutline?: boolean;
+    /** 遮罩覆盖范围外环：默认根据保留区域边界自动外扩推导（避开整环球无法渲染）；可显式指定更大覆盖（含全球） */
+    outerRing?: Coordinate[];
+}
+
+/** 遮罩反选对外状态（响应式） */
+export declare interface MaskState {
+    /** 遮罩是否显示中 */
+    visible: boolean;
+    /** 是否已设置遮罩边界 */
+    hasMask: boolean;
+    /** 保留区域边界顶点数 */
+    boundaryCount: number;
+}
+
+/** 切换到 3D 模式后设置视图的延迟（ms） */
+export declare const MORPH_3D_DELAY = 800;
+
+/** 鼠标位置 */
+export declare interface MousePosition extends Position {
+    position: BmglCartesian3;
+    screenX?: number;
+    screenY?: number;
+}
+
+/** NoResultsPanel 组件 */
+export declare const NoResultsPanel: DefineComponent<ExtractPropTypes<    {
+keyword: {
+type: StringConstructor;
+default: string;
+};
+error: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, "clear"[], "clear", PublicProps, Readonly<ExtractPropTypes<    {
+keyword: {
+type: StringConstructor;
+default: string;
+};
+error: {
+type: BooleanConstructor;
+default: boolean;
+};
+}>> & Readonly<{
+onClear?: ((...args: any[]) => any) | undefined;
+}>, {
+error: boolean;
+keyword: string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * NoResultsPanel - 无结果/查询失败提示面板（TSX）
+ * 搜索无匹配结果时展示空状态提示（含后续引导），
+ * 查询失败（error）时展示错误文案供用户排障，供 MapTools 通过 Teleport 使用。
+ */
+/** 组件属性 */
+export declare interface NoResultsPanelProps {
+    /** 搜索关键字 */
+    keyword: string;
+    /** 是否为查询失败（区别于无匹配结果） */
+    error?: boolean;
+}
+
+/** 归一化后的遮罩配置（outerRing 可选，运行时按保留区域自动推导） */
+declare type NormalizedMaskConfig = Omit<Required<MaskConfig>, 'outerRing'> & {
+    /** 遮罩覆盖范围外环：默认根据保留区域边界自动外扩推导（避开整环球无法渲染）；可显式指定更大覆盖（含全球） */
+    outerRing?: Coordinate[];
+};
+
+/** 合并默认遮罩配置 */
+export declare function normalizeMaskConfig(config?: Partial<MaskConfig>): NormalizedMaskConfig;
+
+/** 合并默认轨迹配置 */
+export declare function normalizeTrajectoryConfig(config?: Partial<TrajectoryConfig>): Required<TrajectoryConfig>;
+
+/** 操作类型 */
+export declare type OperationType = 'draw' | 'edit' | 'select' | 'cancel' | 'delete' | 'clear';
+
+/** 性能配置 */
+export declare const PERFORMANCE_CONFIG: {
+    /** 点位批量加载批次大小（批内含 Canvas 标签纹理绘制，过大易阻塞主线程） */
+    readonly BATCH_SIZE: 200;
+    /** 点位加载让出主线程的时间预算（ms）：累计执行达预算才让出，
+     *  避免无标签等轻量点位场景下"让出开销 > 批内工作开销"拖慢整体加载 */
+    readonly YIELD_BUDGET_MS: 8;
+    /** 搜索输入防抖延迟（ms） */
+    readonly DEBOUNCE_DELAY: 300;
+    /** 点位网格索引的网格尺寸（经纬度） */
+    readonly GRID_SIZE: 0.1;
+};
+
+/** 点位点击事件 */
+export declare interface PointClickEvent {
+    point: BasePointConfig;
+    position: {
+        lng: number;
+        lat: number;
+        altitude?: number;
+    };
+    screenPosition?: {
+        x: number;
+        y: number;
+    };
+}
+
+/** 点位配置 */
+export declare interface PointConfig {
+    width?: number;
+    height?: number;
+    fieldMapping?: {
+        lng?: string;
+        lat?: string;
+        altitude?: string;
+        id?: string;
+        [key: string]: string | undefined;
+    };
+}
+
+/** 点位数据 */
+export declare interface PointData extends Coordinate {
+    id: string;
+    /** 图标图片载荷：基础图标为 SVG data URL，合成文字图标为 HTMLCanvasElement */
+    icon: string | HTMLCanvasElement;
+    name?: string;
+    status?: number | string;
+    [key: string]: any;
+}
+
+/** 点位事件 */
+export declare interface PointEvents {
+    'point:loaded': PointData[];
+    'point:clicked': PointData;
+    'point:hover': PointData;
+    'point:updated': PointData[];
+}
+
+/** 点位悬停事件 */
+export declare interface PointHoverEvent {
+    point: BasePointConfig;
+    position: {
+        lng: number;
+        lat: number;
+        altitude?: number;
+    };
+    screenPosition?: {
+        x: number;
+        y: number;
+    };
+    type: 'enter' | 'leave';
+}
+
+/** 面向点位的批量图标创建条目（随点位基础信息传入） */
+export declare interface PointIconItem {
+    /** 点位标识（用于结果回填定位，可选） */
+    id?: string | number;
+    /** 直接指定图标颜色（优先于 status 映射） */
+    color?: string;
+    /** 业务状态：未传 color 时按状态色映射取色 */
+    status?: string | number;
+    /** 点位名称 */
+    name?: string;
+    /** 是否将名称合成进图标（文字在上、图标在下）；为 true 且 name 非空时生效 */
+    showName?: boolean;
+    /** 可选：覆盖基础 SVG 模板（默认使用 iconManager.initialize 注入的模板）；
+     *  支持同一任务内使用多个不同基础 SVG 图标（按 "SVG|颜色" 独立去重并单例生成） */
+    svg?: string;
+}
+
+/** DivLayer 点击事件载荷（position/detail 为 bmgl 不透明对象） */
+declare interface PopupClickEvent {
+    position: unknown;
+    detail: unknown;
+}
+
+/**
+ * 弹窗类型定义
+ */
+/** 弹窗配置 */
+export declare interface PopupConfig {
+    /** 弹窗水平偏移量（像素） */
+    offsetX?: number;
+    /** 弹窗垂直偏移量（像素） */
+    offsetY?: number;
+    /** 自定义 CSS 类名 */
+    className?: string;
+}
+
+/** 弹窗展示配置（外部可配置字段与主题色） */
+declare interface PopupDisplayConfig {
+    /** 展示字段列表（未配置时使用内置点位字段） */
+    fields?: PopupFieldConfig[];
+    /** 弹窗主题色（十六进制或任意 CSS 色值，用于顶部色条、详情按钮等强调元素） */
+    themeColor?: string;
+}
+
+/** 弹窗展示字段配置（外部可配置弹窗内容） */
+declare interface PopupFieldConfig {
+    /** 字段 key（取点位数据属性） */
+    key: string;
+    /** 显示标签 */
+    label: string;
+    /** 值格式化：内置格式（经纬度/高程/默认）或自定义函数 */
+    format?: 'default' | 'lng' | 'lat' | 'altitude' | ((value: unknown, data: PopupPointData) => string);
+}
+
+/** 弹窗点位数据 */
+export declare interface PopupPointData {
+    /** 线名 */
+    lineCode?: string;
+    /** 线号 */
+    lineNo?: string;
+    /** 点号 */
+    pointNo?: string;
+    /** 状态编码 */
+    status?: number;
+    /** 经度 */
+    lng?: number;
+    /** 纬度 */
+    lat?: number;
+    /** 高程 */
+    altitude?: number;
+    /** 扩展数据（仅在回调时返回） */
+    ext?: Record<string, unknown>;
+    /** 其他任意字段 */
+    [key: string]: any;
+}
+
+/** 位置信息 */
+export declare interface Position extends Coordinate {
+    height?: number;
+}
+
+/** 地图就绪后的延迟（ms），用于等待渲染稳定 */
+export declare const READY_DELAY = 500;
+
+/**
+ * 由矩形的两个对角点生成 5 点闭合路径（[lng, lat][] 格式）
+ */
+export declare function rectangleToPath(point1: {
+    lng: number;
+    lat: number;
+}, point2: {
+    lng: number;
+    lat: number;
+}): [number, number][];
+
+/** 注册自定义绘制工具（或覆盖内置工具元数据 / 配置） */
+export declare function registerDrawTool(entry: DrawToolRegistryEntry): void;
+
+/** 根据配置解析资源的完整 URL（serverUrl 由使用方传入，缺失时给出明确报错） */
+export declare function resolveUrl(config: LibConfig, serverUrl: string, libsUrl: string): string;
+
+export declare class ResourceManager {
+    private resources;
+    /**
+     * 注册资源清理函数
+     */
+    register(cleanup: CleanupFn): void;
+    /**
+     * 注销资源清理函数
+     */
+    unregister(cleanup: CleanupFn): void;
+    /**
+     * 清理所有资源
+     * 等待所有（含异步）清理函数完成后再清空集合
+     */
+    cleanup(): Promise<void>;
+    /**
+     * 获取资源数量
+     */
+    getResourceCount(): number;
+}
+
+/** 脚本加载器类 */
+export declare class ScriptLoader {
+    /** 已加载完成的资源 URL */
+    private loaded;
+    /** 正在加载中的资源 Promise */
+    private pending;
+    /** 加载单个 JS 资源（带超时；失败时移除标签，保证重试不会因残留 DOM 假成功） */
+    private loadJs;
+    /** 加载单个 CSS 资源（带超时；失败时移除标签） */
+    private loadCss;
+    /** 加载单个资源（去重 + 并发去重） */
+    private loadResource;
+    /** 递归加载依赖后加载当前资源 */
+    private loadWithDependencies;
+    /** 批量加载多个脚本（顶层无依赖的库并行加载，依赖链内部保持顺序；共享依赖经 pending 去重） */
+    loadScripts(scriptKeys: string[], serverUrl?: string, libsUrl?: string, customConfigs?: Record<string, Partial<LibConfig>>): Promise<void>;
+    /** 检查某资源是否已加载 */
+    isLoaded(scriptKey: string, serverUrl?: string, libsUrl?: string): boolean;
+    /** 清空已加载记录（测试与热重载使用） */
+    clearLoaded(): void;
+}
+
+/** 脚本加载器单例 */
+export declare const scriptLoader: ScriptLoader;
+
+export declare interface SearchCircle {
+    type: 'circle';
+    center: [number, number];
+    radius: number;
+}
+
+/** 搜索结果项 */
+declare interface SearchItem {
+    id?: string | number;
+    name?: string;
+    lng?: number;
+    lat?: number;
+    altitude?: number;
+    [key: string]: any;
+}
+
+export declare interface SearchPolygon {
+    /** polygon / triangle 均以顶点序列表示（搜索语义一致） */
+    type: 'polygon' | 'triangle';
+    coordinates: [number, number][];
+}
+
+export declare interface SearchRectangle {
+    type: 'rectangle';
+    coordinates: [number, number][];
+}
+
+/**
+ * 地图搜索工具类型定义
+ */
+/** 搜索结果项 */
+export declare interface SearchResultItem {
+    id?: string | number;
+    name?: string;
+    lng?: number;
+    lat?: number;
+    altitude?: number;
+    [key: string]: any;
+}
+
+/** SearchResultsPanel 组件 */
+export declare const SearchResultsPanel: DefineComponent<ExtractPropTypes<    {
+list: {
+type: PropType<SearchResultItem[]>;
+default: () => never[];
+};
+highlightIndex: {
+type: NumberConstructor;
+default: number;
+};
+selectedIndex: {
+type: NumberConstructor;
+default: number;
+};
+}>, () => JSX.Element, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("result-click" | "result-hover" | "result-leave")[], "result-click" | "result-hover" | "result-leave", PublicProps, Readonly<ExtractPropTypes<    {
+list: {
+type: PropType<SearchResultItem[]>;
+default: () => never[];
+};
+highlightIndex: {
+type: NumberConstructor;
+default: number;
+};
+selectedIndex: {
+type: NumberConstructor;
+default: number;
+};
+}>> & Readonly<{
+"onResult-click"?: ((...args: any[]) => any) | undefined;
+"onResult-hover"?: ((...args: any[]) => any) | undefined;
+"onResult-leave"?: ((...args: any[]) => any) | undefined;
+}>, {
+list: SearchResultItem[];
+highlightIndex: number;
+selectedIndex: number;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/** 组件属性 */
+export declare interface SearchResultsPanelProps {
+    /** 结果列表 */
+    list: SearchResultItem[];
+    /** 高亮索引 */
+    highlightIndex: number;
+    /** 选中索引 */
+    selectedIndex: number;
+}
+
+/** 搜索形状 */
+export declare type SearchShape = SearchRectangle | SearchCircle | SearchPolygon;
+
+/**
+ * 设置 bmgl 实例（通常在脚本加载完成后由 useMap 调用）
+ */
+export declare function setBmgl(instance: Bmgl): void;
+
+/** 设置日志级别 */
+export declare function setLogLevel(level: LogLevel): void;
+
+/** 视图设置选项 */
+export declare interface SetViewOptions {
+    destination: BmglCartesian3;
+    orientation?: {
+        heading: number;
+        pitch: number;
+        roll: number;
+    };
+}
+
+/** 状态颜色映射 */
+export declare const STATUS_COLOR_MAP: Record<number | string, {
+    color: string;
+    text: string;
+}>;
+
+/**
+ * 图标管理器类型定义
+ * 定义图标生成相关的配置、结果与缓存数据结构。
+ */
+/** 状态颜色映射：状态 -> 颜色 */
+export declare interface StatusColorMap {
+    [key: string]: string;
+    [key: number]: string;
+    default: string;
+}
+
+/** 样式配置 */
+export declare interface StyleConfig {
+    fillColor?: string;
+    fillAlpha?: number;
+    strokeColor?: string;
+    strokeAlpha?: number;
+    strokeWidth?: number;
+}
+
+/** 文本搜索配置 */
+export declare interface TextSearchConfig {
+    /** 搜索字段，支持单个字段或字段数组（任一字段命中即返回） */
+    field: string | string[];
+    keyword: string;
+    limit?: number;
+    caseSensitive?: boolean;
+}
+
+/** 主题类型：浅色 / 暗色 */
+export declare type Theme = 'dark' | 'light';
+
+/** 工具栏工具项定义 */
+declare interface ToolItem {
+    /** 绘制类型（图标名） */
+    icon: DrawType;
+    /** 工具名称 */
+    name: string;
+    /** 图标尺寸 */
+    size: number;
+}
+export { ToolItem as MapToolItemType }
+export { ToolItem }
+
+/**
+ * 轨迹回放类型定义
+ * TrackPoint / TrajectoryConfig / TrajectoryState 等统一由外部（types 出口 / MapApi）消费。
+ */
+/** 轨迹采样点（lng/lat 必填；altitude 可选；time 可选秒，缺省按 interval 推断） */
+export declare interface TrackPoint {
+    lng: number;
+    lat: number;
+    altitude?: number;
+    /** 相对轨迹起点的秒数（可缺省，缺省时按 interval 等间隔推断） */
+    time?: number;
+}
+
+/** 轨迹回放配置（全部可选，缺省值见 DEFAULT_TRAJECTORY_CONFIG） */
+export declare interface TrajectoryConfig {
+    /** 加载后自动播放，默认 false */
+    autoPlay?: boolean;
+    /** 播放速度倍率，默认 1 */
+    speed?: number;
+    /** 循环播放（到达终点后回到起点继续），默认 false */
+    loop?: boolean;
+    /** 相机跟随标记（顶视垂直跟随），默认 false */
+    follow?: boolean;
+    /** 跟随视角相机高度（m），默认 2000 */
+    followHeight?: number;
+    /** 已走过尾迹时长（秒）；0 表示保留起点到当前的整段，默认 10 */
+    trailTime?: number;
+    /** 总时长（秒）覆盖；缺省按时间表推算 */
+    duration?: number;
+    /** 无 time 字段时点间间隔（秒），默认 1 */
+    interval?: number;
+    /** 移动标记颜色，默认 #ff3b30 */
+    markerColor?: string;
+    /** 移动标记大小（px），默认 12 */
+    markerSize?: number;
+    /** 可选移动标记图片 URL（缺省为圆点）；图标保持图片原始朝向（车头朝右），与官方示例一致 */
+    markerIcon?: string;
+    /** 路径线颜色，默认 #0a84ff */
+    lineColor?: string;
+    /** 路径线宽（px），默认 4 */
+    lineWidth?: number;
+    /** 显示折线抽稀上限（点数过多时按等距步长抽稀，保证渲染性能），默认 20000 */
+    maxPoints?: number;
+}
+
+/** 轨迹回放所需的库加载参数（serverUrl/libsUrl 透传至 ScriptLoader 解析本地库路径） */
+declare interface TrajectoryDeps {
+    /** 地图资源服务器地址（本地库不依赖，可省略） */
+    serverUrl?: string;
+    /** 本地库路径前缀，默认 /libs */
+    libsUrl?: string;
+}
+
+/** 轨迹回放对外状态（响应式） */
+export declare interface TrajectoryState {
+    /** 回放状态 */
+    status: TrajectoryStatus;
+    /** 当前已播放秒（0 ~ duration） */
+    currentTime: number;
+    /** 总时长（秒） */
+    duration: number;
+    /** 播放进度（0 ~ 1） */
+    progress: number;
+    /** 有效采样点数 */
+    pointCount: number;
+}
+
+/** 轨迹回放状态 */
+export declare type TrajectoryStatus = 'idle' | 'playing' | 'paused' | 'ended';
+
+/**
+ * 地图核心 Hook
+ *
+ * @param config 地图配置
+ * @returns 地图状态与操作方法集合
+ */
+export declare function useMap(config: MapConfig): {
+    map: Ref<MapViewer | null, MapViewer | null>;
+    state: Ref<MapState, MapState>;
+    initMap: () => Promise<void>;
+    setView: (lng: number, lat: number, height?: number) => void;
+    toggleMapType: () => void;
+    destroy: () => Promise<void>;
+    on: <K extends string>(event: K, handler: EventHandler<any>) => () => void;
+    once: <K_1 extends string>(event: K_1, handler: EventHandler<any>) => () => void;
+    off: <K_2 extends string>(event: K_2, handler?: EventHandler<any> | undefined) => void;
+    emit: <K_3 extends string>(event: K_3, data?: any) => Promise<void>;
+};
+
+export declare function useMapCircleWave(map: Ref<MapViewer | null> | MapViewer | null): {
+    addWave: (params: AddWaveParams) => string;
+    removeWave: (waveId: string) => boolean;
+};
+
+/**
+ * 等高线显示控制
+ * @param map    地图实例引用
+ * @param config 等高线配置（可选项，未配置使用默认常量）
+ */
+export declare function useMapContour(map: Ref<MapViewer | null>, config?: Partial<ContourConfig>): UseMapContourResult;
+
+/** useMapContour 返回值 */
+declare interface UseMapContourResult {
+    /** 等高线开关状态 */
+    contourVisible: Ref<boolean>;
+    /** 切换等高线显隐（立即应用/移除材质） */
+    setContourVisible: (visible: boolean) => void;
+    /** 按当前开关状态重新应用材质（切回 3D 时恢复等高线） */
+    reapply: () => void;
+    /** 移除等高线材质（切到 2D 时调用，不改开关状态） */
+    remove: () => void;
+}
+
+/**
+ * 地图绘图工具 Hook
+ *
+ * @param map - 地图实例（支持 Ref 或直接实例）
+ * @param config - 绘图配置
+ * @returns 绘图工具 API
+ */
+export declare function useMapDraw(map: Ref<any> | any, config?: DrawConfig): {
+    startDrawing: (drawType: DrawType) => void;
+    cancelDrawing: () => void;
+    removeDrawing: (targetId?: string) => void;
+    clearAllDrawings: () => void;
+    setCallback: (callback: DrawCallback) => void;
+    getDrawingStatus: () => {
+        isDrawing: boolean;
+        isEditing: boolean;
+        currentDrawId: string;
+        currentDrawType: DrawType | null;
+        drawInstance: boolean;
+        editInstance: boolean;
+    };
+    getIsDrawing: () => boolean;
+    initialize: () => void;
+    cleanup: () => void;
+};
+
+/** 实体管理 Hook */
+export declare function useMapEntity(map: Ref<MapViewer | null>): {
+    drawEntity: (options: EntityOptions) => Promise<string | null>;
+    updateEntity: (entityId: string, updates: Partial<EntityOptions>) => Promise<boolean>;
+    deleteEntity: (id?: string) => boolean;
+    redrawAllEntities: () => void;
+    getCurrentEntityId: () => string;
+};
+
+/**
+ * 地图图层管理 Hook
+ *
+ * @param map - 地图实例 Ref
+ * @returns 图层管理 API
+ */
+export declare function useMapLayers(map: Ref<MapViewer | null>): {
+    addImageryLayer: (mapId: string) => BmglImageryLayer;
+    addWmtsLayer: (url: string, layerName?: string) => BmglImageryLayer;
+    removeLayer: (layerOrName: string | BmglImageryLayer) => boolean;
+    removeAllLayers: () => void;
+    setLayerVisible: (layerOrName: string | BmglImageryLayer, visible: boolean) => boolean;
+    setLayerOpacity: (layerOrName: string | BmglImageryLayer, opacity: number) => boolean;
+    getAllLayers: () => {
+        name: string;
+        layer: BmglImageryLayer;
+    }[];
+};
+
+/**
+ * 3D 自动光源控制
+ * @param map    地图实例引用
+ * @param config 默认配置（enabled 默认 false；周期边界与当前时间提供器可覆盖）
+ * @param options 运行选项（is3D 判定）
+ */
+export declare function useMapLighting(map: Ref<MapViewer | null>, config?: Partial<LightingConfig>, options?: UseMapLightingOptions): UseMapLightingResult;
+
+/** useMapLighting 选项 */
+declare interface UseMapLightingOptions {
+    /** 是否处于 3D 模式（光源仅在 3D 生效）；缺省视为始终 3D */
+    is3D?: Ref<boolean>;
+}
+
+/** useMapLighting 返回值 */
+export declare interface UseMapLightingResult {
+    /** 光源状态（响应式：enabled/mode/period/hour） */
+    state: Ref<LightingState>;
+    /** 开启/关闭光源（auto 模式按系统时间智能判定周期；关闭还原开启前光照） */
+    setEnabled: (enabled: boolean) => void;
+    /** 周期来源：'auto'=按系统时间自动判断；或手动指定 day/dusk/night */
+    setPeriod: (period: LightingPeriod | 'auto') => void;
+    /** 按当前时间与环境重应用（模式切换/初始化后调用以生效） */
+    apply: () => void;
+    /** 彻底清理（还原默认光照并关闭开关） */
+    destroy: () => void;
+}
+
+/**
+ * 遮罩反选控制
+ * @param map    地图实例引用
+ * @param config 默认配置（可选项，setMask 时可按边界单独覆盖）
+ */
+export declare function useMapMask(map: Ref<MapViewer | null>, config?: Partial<MaskConfig>): UseMapMaskResult;
+
+/** useMapMask 返回值 */
+export declare interface UseMapMaskResult {
+    /** 遮罩状态（响应式） */
+    state: Ref<MaskState>;
+    /** 设置遮罩反选（boundary 为保留区域边界环，可覆盖默认配置） */
+    setMask: (boundary: Coordinate[], config?: Partial<MaskConfig>) => void;
+    /** 切换遮罩显隐（保留边界数据） */
+    setVisible: (visible: boolean) => void;
+    /** 移除遮罩并复位状态 */
+    clear: () => void;
+    /** 按当前模式重建可视化（模式切换后由内部自动调用，也支持手动调用） */
+    reapply: () => void;
+    /** 移除可视化实体（保留边界数据与显隐状态，供卸载等场景） */
+    remove: () => void;
+    /** 彻底清理（移除实体 + 取消模式监听 + 复位状态） */
+    destroy: () => void;
+}
+
+/** 点位管理 Hook */
+export declare function useMapPoint(map: Ref<MapViewer | null>): {
+    loadPoints: (points: Record<string, any>[], config?: PointConfig, _searchFields?: string[], mode?: 'replace' | 'append') => Promise<void>;
+    searchByShape: (shape: SearchShape) => PointData[];
+    searchByText: (config: TextSearchConfig) => PointData[];
+    updatePoints: (points: Record<string, any>[]) => Promise<void>;
+    clearPoints: () => Promise<void>;
+};
+
+/**
+ * 地图弹窗管理工具 Hook
+ *
+ * @param map - 地图实例（支持 Ref 或直接实例）
+ * @param event - DivLayer 点击事件回调
+ * @param options - 可选配置（展示字段/主题色等）
+ * @returns 弹窗管理工具 API
+ */
+export declare function useMapPopup(map?: MapInput, event?: (pos: PopupClickEvent) => void, options?: {
+    displayConfig?: PopupDisplayConfig;
+}): {
+    showPointPopup: (data: PopupPointData, config?: PopupConfig) => Promise<void>;
+    removePopup: () => void;
+    isPopupVisible: () => boolean;
+    getCurrentPopupData: () => PopupPointData | null;
+};
+
+/**
+ * 轨迹回放控制
+ * @param map    地图实例引用
+ * @param config 默认配置（可选项，load 时可按轨迹单独覆盖）
+ * @param deps   按需加载辅助库所需参数（moveMarker / bm.geometryutil / bmgl-header）
+ */
+export declare function useMapTrajectory(map: Ref<MapViewer | null>, config?: Partial<TrajectoryConfig>, deps?: TrajectoryDeps): UseMapTrajectoryResult;
+
+/** useMapTrajectory 返回值 */
+export declare interface UseMapTrajectoryResult {
+    /** 回放状态（响应式） */
+    state: Ref<TrajectoryState>;
+    /** 加载轨迹并创建可视化（2D/3D 均可用；成功且 autoPlay 时自动播放） */
+    load: (track: TrackPoint[], config?: Partial<TrajectoryConfig>) => void;
+    /** 开始/继续播放 */
+    play: () => void;
+    /** 暂停播放 */
+    pause: () => void;
+    /** 停止并回到起点 */
+    stop: () => void;
+    /** 调整播放速度倍率 */
+    setSpeed: (speed: number) => void;
+    /** 跳转到指定时间点（秒，0 ~ duration） */
+    jumpTo: (time: number) => void;
+    /** 移除轨迹可视化并复位状态（保留已加载轨迹数据前需再 load） */
+    clear: () => void;
+    /** 模式切换后按当前模式重建可视化（保留已加载轨迹与播放状态） */
+    reapply: () => void;
+    /** 移除可视化实体（保留轨迹数据与播放状态，供卸载等场景） */
+    remove: () => void;
+    /** 彻底清理（取消 rAF + 移除实体 + 复位状态） */
+    destroy: () => void;
+}
+
+/** 地图视图编排 Hook */
+export declare function useMapView(props: MapViewProps, hooks: MapViewHooks): {
+    state: Ref<MapState, MapState>;
+    map: Ref<MapViewer | null, MapViewer | null>;
+    showSearch: ComputedRef<boolean>;
+    showControls: ComputedRef<boolean>;
+    showDeleteControls: ComputedRef<boolean>;
+    showStatus: ComputedRef<boolean>;
+    wmtsEnabled: ComputedRef<boolean>;
+    search: {
+        searchInput: Ref<string, string>;
+        searchList: Ref<    {
+        [x: string]: any;
+        id?: string | number | undefined;
+        name?: string | undefined;
+        lng?: number | undefined;
+        lat?: number | undefined;
+        altitude?: number | undefined;
+        }[], SearchItem[] | {
+        [x: string]: any;
+        id?: string | number | undefined;
+        name?: string | undefined;
+        lng?: number | undefined;
+        lat?: number | undefined;
+        altitude?: number | undefined;
+        }[]>;
+        showResults: Ref<boolean, boolean>;
+        isSearching: Ref<boolean, boolean>;
+        searchError: Ref<boolean, boolean>;
+        highlightIndex: Ref<number, number>;
+        selectedIndex: Ref<number, number>;
+        filteredList: ComputedRef<SearchItem[]>;
+        handleInputSearch: (value: string) => void;
+        handleResultClick: (item: SearchItem, index: number) => void;
+        moveHighlight: (delta: 1 | -1) => void;
+        selectHighlighted: () => void;
+        closeResults: () => void;
+        clearSearch: () => void;
+    };
+    onDelete: () => void;
+    handleStartDrawing: (drawType: DrawType) => void;
+    setMapNameVisible: (visible: boolean) => void;
+    setContourVisible: (visible: boolean) => void;
+    contourVisible: Ref<boolean, boolean>;
+    trajectoryState: Ref<TrajectoryState, TrajectoryState>;
+    maskState: Ref<MaskState, MaskState>;
+    weatherState: Ref<WeatherState, WeatherState>;
+    lightingState: Ref<LightingState, LightingState>;
+    setTheme: (theme: Theme) => void;
+    toggleMapType: () => void;
+    resetView: () => void;
+    toggleMapBaseLayer: () => Promise<void>;
+    init: () => Promise<void>;
+    mapType: Ref<"2d" | "3d", "2d" | "3d">;
+    mapBase: Ref<"geoserver" | "bigemap", "geoserver" | "bigemap">;
+    currentDrawType: Ref<DrawType | null, DrawType | null>;
+    loadingTitle: Ref<string, string>;
+    loadingSubtitle: Ref<string, string>;
+    theme: Ref<Theme, Theme>;
+    mapNameVisible: Ref<boolean, boolean>;
+};
+
+/**
+ * 天气效果控制
+ * @param map    地图实例引用
+ * @param config 默认配置（可选项，setWeather 时可按次覆盖）
+ */
+export declare function useMapWeather(map: Ref<MapViewer | null>, config?: Partial<WeatherConfig>): UseMapWeatherResult;
+
+/** useMapWeather 返回值 */
+export declare interface UseMapWeatherResult {
+    /** 天气状态（响应式） */
+    state: Ref<WeatherState>;
+    /** 切换天气（clear=晴/无特效；rain=下雨；snow=下雪；可按调用再覆盖 opacity） */
+    setWeather: (type: WeatherType, config?: Partial<WeatherConfig>) => void;
+    /** 移除天气特效并复位状态 */
+    clear: () => void;
+    /** 彻底清理（同 clear） */
+    destroy: () => void;
+}
+
+/**
+ * 等待 bmgl 就绪
+ * 若已就绪立即返回；否则轮询 window.bmgl 直到超时
+ *
+ * @param timeout 超时时间（毫秒），默认 3000
+ * @throws Error 超时后抛出错误
+ */
+export declare function waitForBmgl(timeout?: number): Promise<Bmgl>;
+
+/** 搜索结果波纹效果移除延迟（ms） */
+export declare const WAVE_REMOVE_DELAY = 10000;
+
+/** 天气效果配置 */
+export declare interface WeatherConfig {
+    /** 特效混合强度（透明度，0 ~ 1）；缺省时按类型使用内置默认（雨 0.5 / 雪 0.3） */
+    opacity?: number;
+}
+
+/** 天气状态（响应式） */
+export declare interface WeatherState {
+    /** 当前天气类型 */
+    type: WeatherType;
+    /** 是否有天气特效运行中 */
+    active: boolean;
+}
+
+/**
+ * 天气效果类型定义
+ * 基于 bmgl 全屏后处理着色器（PostProcessStage）实现，2D/3D 场景通用。
+ */
+/** 天气类型 */
+export declare type WeatherType = 'clear' | 'rain' | 'snow';
+
+export { }