@antv/aimapui 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3117 @@
+import { BaiduMap } from '@antv/l7-maps';
+import { Component } from 'react';
+import { default as default_2 } from 'react';
+import { default as default_3 } from '@antv/l7-maps/es/amap-next';
+import { GoogleMap } from '@antv/l7-maps';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { Map as Map_2 } from '@antv/l7-maps';
+import { Mapbox } from '@antv/l7-maps';
+import { MapLibre } from '@antv/l7-maps';
+import { ReactNode } from 'react';
+import { Scene } from '@antv/l7';
+import { TencentMap } from '@antv/l7-maps';
+import { TMap } from '@antv/l7-maps';
+
+export declare type ActiveConfig = boolean | {
+    color: string;
+};
+
+/**
+ * Heatmap 图层适配器
+ */
+export declare function adaptHeatmapLayer(schema: LayerSchema): {
+    type: "HeatmapLayer";
+    sourceConfig: {
+        data: unknown;
+        options: {
+            transforms?: Record<string, unknown>[] | undefined;
+            parser: Record<string, unknown>;
+        };
+    } | {
+        data: unknown;
+        options: {
+            transforms: Record<string, unknown>[];
+        } | undefined;
+    };
+    visual: {
+        color: ColorConfig | undefined;
+        size: {
+            field: string;
+            values: number[] | undefined;
+        } | undefined;
+        shape: ShapeConfig | undefined;
+        style: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    schema: LayerSchema;
+};
+
+/**
+ * Image 图层适配器
+ */
+export declare function adaptImageLayer(schema: LayerSchema): {
+    type: "ImageLayer";
+    sourceConfig: {
+        data: unknown;
+        options: {
+            parser: Record<string, unknown> | undefined;
+        };
+    };
+    visual: {
+        color: undefined;
+        size: undefined;
+        shape: undefined;
+        style: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    schema: LayerSchema;
+};
+
+/**
+ * Line 图层适配器
+ */
+export declare function adaptLineLayer(schema: LayerSchema): {
+    type: "LineLayer";
+    sourceConfig: SourceOutput;
+    visual: VisualConfig;
+    schema: LayerSchema;
+};
+
+/**
+ * Point 图层适配器
+ * 将 LayerSchema 转换为 L7 PointLayer 配置
+ */
+export declare function adaptPointLayer(schema: LayerSchema): {
+    type: "PointLayer";
+    sourceConfig: SourceOutput;
+    visual: VisualConfig;
+    schema: LayerSchema;
+};
+
+/**
+ * Polygon 图层适配器
+ */
+export declare function adaptPolygonLayer(schema: LayerSchema): {
+    type: "PolygonLayer";
+    sourceConfig: SourceOutput;
+    visual: VisualConfig;
+    schema: LayerSchema;
+};
+
+/**
+ * Raster 图层适配器
+ */
+export declare function adaptRasterLayer(schema: LayerSchema): {
+    type: "RasterLayer";
+    sourceConfig: {
+        data: unknown;
+        options: {
+            parser: Record<string, unknown>;
+        };
+    } | {
+        data: unknown;
+        options: {
+            parser: {
+                type: string;
+                extent: number[];
+                tileSize?: undefined;
+                zoomOffset?: undefined;
+            };
+        } | {
+            parser: {
+                type: string;
+                tileSize: number;
+                zoomOffset: number;
+                extent?: undefined;
+            };
+        } | undefined;
+    };
+    visual: {
+        color: undefined;
+        size: undefined;
+        shape: undefined;
+        style: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    schema: LayerSchema;
+};
+
+/** 色阶预设（低值到高值，确保低值区域也有足够辨识度） */
+export declare const ADMIN_SEQUENTIAL_COLORS: readonly ["#eff6ff", "#bfdbfe", "#60a5fa", "#2563eb", "#1d4ed8", "#1e3a8a"];
+
+/** 行政层级 */
+export declare type AdministrativeLevel = 'province' | 'city' | 'district';
+
+/**
+ * AiMap 主入口组件
+ *
+ * 支持两种使用模式：
+ *
+ * 1. 组件化模式（推荐 — 开发者友好，自由组合）
+ * ```tsx
+ * <AiMap map={{ basemap: 'gaode', center: [116, 39], zoom: 10 }}>
+ *   <PointLayer source={data} color="#5B8FF9" size={12} onClick={handleClick} />
+ *   <LineLayer source={flowData} color="#F6BD16" />
+ *   <ZoomControl position="topright" />
+ *   <Marker longitude={116.4} latitude={39.9} content="北京" />
+ * </AiMap>
+ * ```
+ *
+ * 2. Schema 模式（AI 生成、JSON 配置）
+ * ```tsx
+ * <AiMap schema={fullSchema} />
+ * ```
+ */
+export declare function AiMap({ map, schema, theme, onSceneReady, onLayerClick, onLayerMouseMove, onLayerMouseEnter, onLayerMouseLeave, onMapMove, onMapZoom, autoFit, events, children, className, style, }: AiMapProps): JSX_2.Element;
+
+/**
+ * JSON Schema 导出 — 供 AI / LLM 理解 Schema 结构
+ * 可用于验证、自动补全、文档生成等场景
+ */
+export declare const AiMapJSONSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly title: "AiMapSchema";
+    readonly description: "Schema-driven React map visualization component configuration";
+    readonly type: "object";
+    readonly required: readonly ["map", "layers"];
+    readonly properties: {
+        readonly map: {
+            readonly type: "object";
+            readonly required: readonly ["basemap"];
+            readonly properties: {
+                readonly basemap: {
+                    readonly type: "string";
+                    readonly enum: readonly ["gaode", "mapbox", "maplibre", "tianditu", "tencent", "baidu", "google", "map"];
+                    readonly description: "Map base tile provider";
+                };
+                readonly token: {
+                    readonly type: "string";
+                    readonly description: "API token for the map service";
+                };
+                readonly style: {
+                    readonly type: "string";
+                    readonly description: "Map style preset (light/dark/normal/darkblue/satellite) or custom URL";
+                };
+                readonly center: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                    };
+                    readonly minItems: 2;
+                    readonly maxItems: 2;
+                    readonly description: "Map center [longitude, latitude], default [105, 35]";
+                };
+                readonly zoom: {
+                    readonly type: "number";
+                    readonly description: "Map zoom level, default 4";
+                };
+                readonly pitch: {
+                    readonly type: "number";
+                    readonly description: "Map pitch in degrees, default 0";
+                };
+                readonly rotation: {
+                    readonly type: "number";
+                    readonly description: "Map rotation in degrees, default 0";
+                };
+                readonly minZoom: {
+                    readonly type: "number";
+                    readonly description: "Minimum zoom level";
+                };
+                readonly maxZoom: {
+                    readonly type: "number";
+                    readonly description: "Maximum zoom level";
+                };
+                readonly bounds: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "number";
+                        };
+                        readonly minItems: 2;
+                        readonly maxItems: 2;
+                    };
+                    readonly minItems: 2;
+                    readonly maxItems: 2;
+                    readonly description: "Initial bounds [[swLng, swLat], [neLng, neLat]]";
+                };
+                readonly gestureConfig: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly dragPan: {
+                            readonly type: "boolean";
+                        };
+                        readonly pinchZoom: {
+                            readonly type: "boolean";
+                        };
+                        readonly dragRotate: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
+            };
+        };
+        readonly layers: {
+            readonly type: "array";
+            readonly description: "Array of map layers";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["type", "source"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly description: "Unique layer ID (auto-generated if omitted)";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["point", "line", "polygon", "heatmap", "raster", "image"];
+                        readonly description: "Layer visualization type";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly description: "Human-readable layer name";
+                    };
+                    readonly visible: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                    };
+                    readonly zIndex: {
+                        readonly type: "number";
+                        readonly default: 0;
+                    };
+                    readonly minZoom: {
+                        readonly type: "number";
+                    };
+                    readonly maxZoom: {
+                        readonly type: "number";
+                    };
+                    readonly autoFit: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                    };
+                    readonly source: {
+                        readonly description: "GeoJSON, JSON array, or URL string";
+                    };
+                    readonly sourceType: {
+                        readonly type: "string";
+                        readonly enum: readonly ["geojson", "json", "csv"];
+                    };
+                    readonly sourceConfig: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "string";
+                                readonly description: "Longitude field name";
+                            };
+                            readonly y: {
+                                readonly type: "string";
+                                readonly description: "Latitude field name";
+                            };
+                            readonly x1: {
+                                readonly type: "string";
+                                readonly description: "End longitude field (for arc lines)";
+                            };
+                            readonly y1: {
+                                readonly type: "string";
+                                readonly description: "End latitude field (for arc lines)";
+                            };
+                            readonly coordinates: {
+                                readonly type: "string";
+                                readonly description: "Coordinates field";
+                            };
+                        };
+                    };
+                    readonly color: {
+                        readonly type: "string";
+                        readonly description: "Fixed color";
+                    };
+                    readonly colorField: {
+                        readonly type: "string";
+                        readonly description: "Field to map color to";
+                    };
+                    readonly colorValues: {
+                        readonly oneOf: readonly [{
+                            readonly type: "string";
+                            readonly description: "Color palette name";
+                        }, {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Array of color values";
+                        }];
+                    };
+                    readonly size: {
+                        readonly type: "number";
+                        readonly description: "Fixed size";
+                    };
+                    readonly sizeField: {
+                        readonly type: "string";
+                        readonly description: "Field to map size to";
+                    };
+                    readonly sizeValues: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "number";
+                        };
+                        readonly description: "Size range [min, max]";
+                    };
+                    readonly shape: {
+                        readonly type: "string";
+                        readonly description: "Fixed shape";
+                    };
+                    readonly shapeField: {
+                        readonly type: "string";
+                        readonly description: "Field to map shape to";
+                    };
+                    readonly shapeValues: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly style: {
+                        readonly type: "object";
+                        readonly description: "Additional style properties";
+                    };
+                    readonly filterField: {
+                        readonly type: "string";
+                    };
+                    readonly filterValues: {
+                        readonly type: "array";
+                    };
+                    readonly animate: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly enable: {
+                                readonly type: "boolean";
+                            };
+                            readonly speed: {
+                                readonly type: "number";
+                            };
+                            readonly duration: {
+                                readonly type: "number";
+                            };
+                            readonly trailLength: {
+                                readonly type: "number";
+                            };
+                            readonly repeat: {
+                                readonly type: "number";
+                            };
+                        };
+                    };
+                    readonly active: {
+                        readonly oneOf: readonly [{
+                            readonly type: "boolean";
+                        }, {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly color: {
+                                    readonly type: "string";
+                                };
+                            };
+                        }];
+                    };
+                    readonly select: {
+                        readonly oneOf: readonly [{
+                            readonly type: "boolean";
+                        }, {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly color: {
+                                    readonly type: "string";
+                                };
+                            };
+                        }];
+                    };
+                    readonly events: {
+                        readonly type: "object";
+                        readonly description: "Layer event configuration";
+                        readonly properties: {
+                            readonly click: {
+                                readonly type: "string";
+                                readonly description: "Event identifier emitted on click (via EventBus)";
+                            };
+                            readonly mousemove: {
+                                readonly type: "string";
+                                readonly description: "Event identifier emitted on mousemove";
+                            };
+                            readonly mouseenter: {
+                                readonly type: "string";
+                                readonly description: "Event identifier emitted on mouseenter";
+                            };
+                            readonly mouseleave: {
+                                readonly type: "string";
+                                readonly description: "Event identifier emitted on mouseleave";
+                            };
+                            readonly enablePopup: {
+                                readonly type: "boolean";
+                                readonly description: "Auto-show popup on click";
+                            };
+                            readonly popupFields: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Fields to show in popup";
+                            };
+                            readonly popupTemplate: {
+                                readonly type: "string";
+                                readonly description: "HTML template with {{field}} interpolation";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly controls: {
+            readonly type: "array";
+            readonly description: "Map control widgets";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["zoom", "scale", "fullscreen", "geoLocate", "mapTheme", "mouseLocation", "exportImage", "layerSwitch"];
+                    };
+                    readonly position: {
+                        readonly type: "string";
+                        readonly enum: readonly ["topleft", "topright", "bottomleft", "bottomright", "topcenter", "bottomcenter"];
+                    };
+                    readonly options: {
+                        readonly type: "object";
+                    };
+                };
+            };
+        };
+        readonly interactions: {
+            readonly type: "array";
+            readonly description: "Interactive elements (markers, popups, tooltips)";
+            readonly items: {
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly required: readonly ["type", "longitude", "latitude"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly const: "marker";
+                        };
+                        readonly longitude: {
+                            readonly type: "number";
+                        };
+                        readonly latitude: {
+                            readonly type: "number";
+                        };
+                        readonly content: {
+                            readonly type: "string";
+                        };
+                        readonly draggable: {
+                            readonly type: "boolean";
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly required: readonly ["type", "longitude", "latitude", "content"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly const: "popup";
+                        };
+                        readonly longitude: {
+                            readonly type: "number";
+                        };
+                        readonly latitude: {
+                            readonly type: "number";
+                        };
+                        readonly content: {
+                            readonly type: "string";
+                        };
+                        readonly closeButton: {
+                            readonly type: "boolean";
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly required: readonly ["type", "content"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly const: "tooltip";
+                        };
+                        readonly content: {
+                            readonly type: "string";
+                        };
+                        readonly trigger: {
+                            readonly type: "string";
+                            readonly enum: readonly ["hover", "click"];
+                        };
+                    };
+                }];
+            };
+        };
+        readonly legends: {
+            readonly type: "array";
+            readonly description: "Legend configurations";
+            readonly items: {
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly required: readonly ["type", "labels", "colors"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly const: "categories";
+                        };
+                        readonly title: {
+                            readonly type: "string";
+                        };
+                        readonly labels: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly colors: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly required: readonly ["type", "labels", "colors"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly const: "ramp";
+                        };
+                        readonly title: {
+                            readonly type: "string";
+                        };
+                        readonly labels: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly colors: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly isContinuous: {
+                            readonly type: "boolean";
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly required: readonly ["type", "labels"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly const: "proportion";
+                        };
+                        readonly title: {
+                            readonly type: "string";
+                        };
+                        readonly labels: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "number";
+                                };
+                            };
+                        };
+                        readonly fillColor: {
+                            readonly type: "string";
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly required: readonly ["type", "items"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly const: "icon";
+                        };
+                        readonly title: {
+                            readonly type: "string";
+                        };
+                        readonly items: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly icon: {
+                                        readonly type: "string";
+                                    };
+                                    readonly label: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                }];
+            };
+        };
+        readonly responsive: {
+            readonly type: "object";
+            readonly properties: {
+                readonly breakpoint: {
+                    readonly type: "number";
+                    readonly default: 768;
+                };
+                readonly mobile: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly controls: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly position: {
+                                    readonly type: "string";
+                                };
+                                readonly scale: {
+                                    readonly type: "number";
+                                };
+                                readonly hide: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                        };
+                        readonly legends: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly compact: {
+                                    readonly type: "boolean";
+                                };
+                                readonly position: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                        readonly toolbar: {
+                            readonly type: "object";
+                            readonly required: readonly ["items", "position"];
+                            readonly properties: {
+                                readonly items: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                                readonly position: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["bottom", "top"];
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly events: {
+            readonly type: "object";
+            readonly description: "Global event identifier mappings for map and interactions";
+            readonly properties: {
+                readonly mapMove: {
+                    readonly type: "string";
+                    readonly description: "Event identifier for map move";
+                };
+                readonly mapZoom: {
+                    readonly type: "string";
+                    readonly description: "Event identifier for map zoom";
+                };
+                readonly markerDragEnd: {
+                    readonly type: "string";
+                    readonly description: "Event identifier for marker drag end";
+                };
+            };
+        };
+    };
+};
+
+export declare interface AiMapProps {
+    /**
+     * 组件化模式：只传地图配置，图层/控件/交互通过子组件添加
+     *
+     * ```tsx
+     * <AiMap map={{ basemap: 'gaode', center: [116, 39], zoom: 10 }}>
+     *   <PointLayer source={data} color="#5B8FF9" size={12} />
+     *   <ZoomControl />
+     * </AiMap>
+     * ```
+     */
+    map?: MapSchema;
+    /**
+     * Schema 模式：通过完整 JSON Schema 一次性配置（AI 生成场景）
+     *
+     * ```tsx
+     * <AiMap schema={fullSchema} />
+     * ```
+     */
+    schema?: AiMapSchema;
+    /**
+     * 主题模式
+     * - `'light'`: 亮色主题（默认）
+     * - `'dark'`: 暗色主题
+     * - `'system'`: 跟随系统 prefers-color-scheme
+     */
+    theme?: MapTheme;
+    /** 场景就绪回调 */
+    onSceneReady?: (scene: Scene) => void;
+    /**
+     * 是否自动缩放至所有图层数据范围（覆盖 map.center / map.zoom）
+     *
+     * 开启后会在地图与所有图层就绪后自动调用 `scene.fitBounds`，将视野适配到全部
+     * 图层数据的外接矩形。适合数据范围未知或需要"打开页面即看到全部数据"的场景。
+     *
+     * 注意：底图必须支持 `fitBounds`（高德 / Maplibre / Mapbox / 天地图均支持）。
+     */
+    autoFit?: boolean;
+    /** 图层点击事件 */
+    onLayerClick?: (payload: LayerEventPayload) => void;
+    /** 图层鼠标移动事件 */
+    onLayerMouseMove?: (payload: LayerEventPayload) => void;
+    /** 图层鼠标进入事件 */
+    onLayerMouseEnter?: (payload: LayerEventPayload) => void;
+    /** 图层鼠标离开事件 */
+    onLayerMouseLeave?: (payload: LayerEventPayload) => void;
+    /** 地图移动事件 */
+    onMapMove?: (payload: MapEventPayload) => void;
+    /** 地图缩放事件 */
+    onMapZoom?: (payload: MapEventPayload) => void;
+    /** EventBus 事件监听 */
+    events?: Record<string, (...args: unknown[]) => void>;
+    /** 子组件（组件化模式下使用） */
+    children?: default_2.ReactNode;
+    /** 容器 className */
+    className?: string;
+    /** 容器 style */
+    style?: default_2.CSSProperties;
+}
+
+export declare interface AiMapSchema {
+    map: MapSchema;
+    layers: LayerSchema[];
+    controls?: ControlSchema[];
+    interactions?: InteractionSchema[];
+    legends?: LegendSchema[];
+    responsive?: ResponsiveSchema;
+    events?: EventSchema;
+}
+
+export declare interface AnimateConfig {
+    enable: boolean;
+    speed?: number;
+    duration?: number;
+    trailLength?: number;
+    repeat?: number;
+}
+
+export declare function applyControlDefaults(control: ControlSchema): ControlSchema;
+
+export declare function applyLayerDefaults(layer: LayerSchema): LayerSchema;
+
+export declare function applyMapDefaults(map: MapSchema): ResolvedMapSchema;
+
+/**
+ * 根据响应式配置合并 Schema
+ */
+export declare function applyResponsiveOverrides<T extends DeepMergeable>(base: T, overrides: Partial<T> | undefined): T;
+
+export declare function applySchemaDefaults(schema: AiMapSchema): AiMapSchema;
+
+/**
+ * 弧线流向色彩模式
+ * - single: 单色模式（默认 primary）
+ * - gradient: 起点色 → 终点色渐变
+ * - field: 按字段映射色板
+ */
+export declare type ArcColorMode = 'single' | 'gradient' | 'field';
+
+/**
+ * OD 数据项
+ */
+export declare interface ArcFlowDataItem {
+    /** 起点经度 */
+    fromLng: number;
+    /** 起点纬度 */
+    fromLat: number;
+    /** 终点经度 */
+    toLng: number;
+    /** 终点纬度 */
+    toLat: number;
+    /** 权重/流量值 */
+    weight?: number;
+    /** 起点名称 */
+    fromName?: string;
+    /** 终点名称 */
+    toName?: string;
+    [key: string]: unknown;
+}
+
+/**
+ * 弧线流向复合图层 (Arc & OD Flow Map)
+ *
+ * 遵循设计规范：
+ * - 弧线形态：贝塞尔 / 3D / 大圆航线
+ * - 线宽按权重映射（1~5px）
+ * - 渐变色强化流向感
+ * - 粒子/轨迹流动动画
+ * - 节点锚点 + 脉冲波纹
+ * - Hover 高亮路径 + 其余置灰
+ *
+ * @example
+ * ```tsx
+ * <ArcFlowLayer
+ *   source={odData}
+ *   shape="arc3d"
+ *   colorMode="gradient"
+ *   gradientColors={['#93c5fd', '#2563eb']}
+ *   lineWidthRange={[1, 4]}
+ *   animate
+ *   showNodes
+ *   nodePulse
+ * />
+ * ```
+ */
+export declare function ArcFlowLayer({ source, sourceType, sourceConfig, shape, color, gradientColors, colorMode, colorField, colorValues, lineWidth, lineWidthRange, weightField, opacity, blur, animate, animateSpeed, animateTrailLength, animateDuration, showNodes, nodeColor, nodeSize, nodeSizeRange, nodePulse, activeColor, onArcHover, onArcClick, onNodeClick, style: extraStyle, }: ArcFlowLayerProps): JSX_2.Element;
+
+export declare interface ArcFlowLayerProps {
+    /** OD 数据源 — JSON 数组 */
+    source: ArcFlowDataItem[] | string;
+    /** 数据源类型 */
+    sourceType?: 'json' | 'csv';
+    /** 字段映射配置（覆盖默认 fromLng/fromLat/toLng/toLat） */
+    sourceConfig?: {
+        x?: string;
+        y?: string;
+        x1?: string;
+        y1?: string;
+    };
+    /** 弧线形态，默认 'arc' */
+    shape?: ArcShape;
+    /** 弧线颜色（单色模式），默认 '#2563EB' */
+    color?: string;
+    /** 渐变色（gradient 模式）：[起点色, 终点色] */
+    gradientColors?: [string, string];
+    /** 颜色模式，默认 'single' */
+    colorMode?: ArcColorMode;
+    /** 字段映射色板时的字段名 */
+    colorField?: string;
+    /** 字段映射色板值 */
+    colorValues?: string[];
+    /** 弧线宽度，默认 1.5 */
+    lineWidth?: number;
+    /** 按权重映射宽度范围 [min, max]，例如 [1, 5] */
+    lineWidthRange?: [number, number];
+    /** 权重字段名，默认 'weight' */
+    weightField?: string;
+    /** 弧线透明度，默认 0.8 */
+    opacity?: number;
+    /** 弧线模糊度，默认 0.6（增加柔和感） */
+    blur?: number;
+    /** 是否启用流动动画，默认 false */
+    animate?: boolean;
+    /** 动画速度（数值越大越快），默认 1 */
+    animateSpeed?: number;
+    /** 动画尾迹长度 0~1，默认 0.3 */
+    animateTrailLength?: number;
+    /** 动画持续时间(ms)，默认 2000 */
+    animateDuration?: number;
+    /** 是否显示起终点节点，默认 true */
+    showNodes?: boolean;
+    /** 节点颜色，默认跟随弧线色 */
+    nodeColor?: string;
+    /** 节点大小，默认 4 */
+    nodeSize?: number;
+    /** 节点大小按权重映射范围，例如 [3, 12] */
+    nodeSizeRange?: [number, number];
+    /** 是否显示节点呼吸脉冲动画，默认 false */
+    nodePulse?: boolean;
+    /** hover 高亮色 */
+    activeColor?: string;
+    /** 弧线 hover 事件 */
+    onArcHover?: (payload: LayerEventPayload) => void;
+    /** 弧线点击事件 */
+    onArcClick?: (payload: LayerEventPayload) => void;
+    /** 节点点击事件 */
+    onNodeClick?: (payload: LayerEventPayload) => void;
+    /** 额外 style */
+    style?: Record<string, unknown>;
+}
+
+/**
+ * 弧线形态
+ * - arc: 2D 贝塞尔弧线（默认）
+ * - arc3d: 3D 弧线（适合倾斜视角）
+ * - greatcircle: 大圆航线（跨洲长距离）
+ */
+export declare type ArcShape = 'arc' | 'arc3d' | 'greatcircle';
+
+/**
+ * @antv/aimapui Schema 类型定义
+ * 纯可序列化 Schema，面向 AI 生成优化
+ */
+export declare type BasemapType = 'gaode' | 'mapbox' | 'maplibre' | 'tianditu' | 'tencent' | 'baidu' | 'google' | 'map';
+
+/**
+ * 移动端底部抽屉组件
+ *
+ * 支持三档吸附：收起（collapsed）、半展开（half）、完全展开（expanded）
+ * 手势拖拽切换，Material Design 3 风格
+ *
+ * ```tsx
+ * <BottomSheet defaultSnap="half">
+ *   <div>抽屉内容</div>
+ * </BottomSheet>
+ * ```
+ */
+export declare function BottomSheet({ children, defaultSnap, collapsedHeight, halfRatio, expandedRatio, onSnapChange, className, showHandle, borderRadius, }: BottomSheetProps): JSX_2.Element;
+
+export declare interface BottomSheetProps {
+    /** 子内容 */
+    children?: default_2.ReactNode;
+    /** 初始吸附状态 */
+    defaultSnap?: BottomSheetSnap;
+    /** 收起时的高度（px） */
+    collapsedHeight?: number;
+    /** 半展开时的高度比例（0-1），相对于容器高度 */
+    halfRatio?: number;
+    /** 完全展开时的高度比例（0-1），相对于容器高度 */
+    expandedRatio?: number;
+    /** 吸附状态变化回调 */
+    onSnapChange?: (snap: BottomSheetSnap) => void;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 是否显示拖拽手柄 */
+    showHandle?: boolean;
+    /** 圆角大小 */
+    borderRadius?: number;
+}
+
+export declare type BottomSheetSnap = 'collapsed' | 'half' | 'expanded';
+
+declare type BubbleAnchor = 'center' | 'top' | 'right' | 'bottom' | 'left' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+
+/**
+ * 气泡图组件（Bubble Map）
+ * 默认遵循设计规范：
+ * - 圆形 + 半透明填充 + 实色描边
+ * - 五级尺寸映射（8/16/32/48/64）
+ * - 默认启用 hover/click 交互反馈
+ * - 利用 L7 2.28+ anchor 参数自动布局标签，避免与气泡重叠
+ *
+ * 推荐锚点组合：
+ * - bubbleAnchor='center', labelAnchor='center' — 标签居中覆盖气泡（适合短文本）
+ * - bubbleAnchor='bottom', labelAnchor='top' — 标签在气泡上方（经典布局）
+ */
+export declare function BubbleLayer({ source, sourceType, sourceConfig, labelField, labelColor, labelSize, showLabel, labelTrigger, labelOffset, sizeDomain, bubbleAnchor, labelAnchor, hoverEffect, clickEffect, tooltipEffect, tooltipFields, tooltipTemplate, semanticColorField, color, size, sizeField, sizeValues, style, active, select, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: BubbleLayerProps): JSX_2.Element;
+
+export declare interface BubbleLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    /** 文本标签字段，默认 name */
+    labelField?: string;
+    labelColor?: string;
+    labelSize?: number;
+    showLabel?: boolean;
+    /** 文本标签触发方式：'always' 始终显示 | 'hover' 鼠标划过时显示，默认 'always' */
+    labelTrigger?: 'always' | 'hover';
+    /** 文本偏移量，默认根据气泡最大半径自动计算 */
+    labelOffset?: [number, number];
+    /** sizeField 为离散值时，对应每个 sizeValues 的域值顺序（默认 1..N） */
+    sizeDomain?: Array<string | number>;
+    /** 气泡锚点，决定标签相对气泡的连接参考点 */
+    bubbleAnchor?: BubbleAnchor;
+    /** 文本锚点，映射到 textAnchor */
+    labelAnchor?: BubbleAnchor;
+    /** 是否启用默认 hover 强化（opacity + 边框强调） */
+    hoverEffect?: boolean;
+    /** 是否启用默认 click 选中反馈 */
+    clickEffect?: boolean;
+    /** 是否启用默认 tooltip/popup（点击气泡弹出） */
+    tooltipEffect?: boolean;
+    /** tooltip 展示字段，不传则自动展示常见字段 */
+    tooltipFields?: string[];
+    /** tooltip 模板，支持 {{field}} 占位符 */
+    tooltipTemplate?: string;
+    /** 语义色板映射字段，例如 status: primary|warning|error|success */
+    semanticColorField?: string;
+    /** 点击事件 */
+    onClick?: (payload: LayerEventPayload) => void;
+    /** 鼠标移动事件 */
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    /** 鼠标进入事件 */
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    /** 鼠标离开事件 */
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 内置天气 iconfont 图标映射（at.alicdn.com 字体）
+ * key 为语义化名称，value 为 HTML 实体格式的 iconfont unicode（&#xHEX;）
+ */
+export declare const BUILTIN_ICON_FONTS: Array<[string, string]>;
+
+/** 业务数据匹配项 */
+export declare interface BusinessDataItem {
+    name?: string;
+    adcode?: string | number;
+    value?: number;
+    [key: string]: unknown;
+}
+
+/**
+ * 中国行政区划图层（ChinaDistrict）
+ *
+ * 内置全国省/市/县三级 GeoJSON 数据，支持下钻模式与业务数据关联色阶映射。
+ */
+export declare function ChinaDistrict({ provinceSource, citySource, districtSource, level, drillEnabled, drillPath: controlledDrillPath, onDrill, data, joinField, dataJoinField, valueField, colors, fillOpacity, strokeColor, strokeWidth, dimOpacity, showLabel, labelField, labelSize, hoverHighlight, clickSelect, showTooltip, tooltipFields, onRegionClick, zIndex, }: ChinaDistrictProps): JSX_2.Element | null;
+
+export declare interface ChinaDistrictProps {
+    /** 省级 GeoJSON 数据 URL 或对象，默认内置全国省级数据 */
+    provinceSource?: string | Record<string, unknown>;
+    /** 市级 GeoJSON 数据 URL 或对象，默认内置全国市级数据 */
+    citySource?: string | Record<string, unknown>;
+    /** 县级 GeoJSON 数据 URL 或对象，默认内置全国县级数据 */
+    districtSource?: string | Record<string, unknown>;
+    /** 当前显示层级（非下钻模式时使用） */
+    level?: AdministrativeLevel;
+    /** 是否启用下钻模式 */
+    drillEnabled?: boolean;
+    /** 下钻路径（受控模式） */
+    drillPath?: DrillPathNode[];
+    /** 下钻回调 */
+    onDrill?: (path: DrillPathNode[]) => void;
+    /** 业务数据，通过 name 或 adcode 与地理数据关联 */
+    data?: BusinessDataItem[];
+    /** 关联字段（地理数据属性名） */
+    joinField?: string;
+    /** 业务数据匹配字段 */
+    dataJoinField?: string;
+    /** 数值字段名（用于色阶映射） */
+    valueField?: string;
+    /** 色阶颜色数组 */
+    colors?: string[];
+    /** 填充透明度 */
+    fillOpacity?: number;
+    /** 描边颜色 */
+    strokeColor?: string;
+    /** 描边宽度 */
+    strokeWidth?: number;
+    /** 非焦点区域透明度（下钻时） */
+    dimOpacity?: number;
+    /** 是否显示标签 */
+    showLabel?: boolean;
+    /** 标签字段名 */
+    labelField?: string;
+    /** 标签字号 */
+    labelSize?: number;
+    /** hover 高亮 */
+    hoverHighlight?: boolean;
+    /** 点击选中 */
+    clickSelect?: boolean;
+    /** Tooltip 显示 */
+    showTooltip?: boolean;
+    /** Tooltip 自定义字段 */
+    tooltipFields?: string[];
+    /** 区域点击事件 */
+    onRegionClick?: (feature: Record<string, unknown>, level: AdministrativeLevel) => void;
+    /** 图层 zIndex */
+    zIndex?: number;
+}
+
+declare interface ClusterItem {
+    id: string;
+    /** supercluster 分配的 cluster ID（仅聚合点有，单点为 -1） */
+    clusterId: number;
+    lng: number;
+    lat: number;
+    /** 聚合包含的点数，单点为 1 */
+    pointCount: number;
+    isCluster: boolean;
+    properties: Record<string, unknown>;
+}
+
+declare interface ClusterPoint {
+    id: string;
+    lng: number;
+    lat: number;
+    properties: Record<string, unknown>;
+}
+
+/**
+ * 公共 Adapter 工具函数
+ * 抽取各 Layer Adapter 中重复的视觉映射和数据源构建逻辑
+ */
+declare interface ColorConfig {
+    field?: string;
+    values?: string[] | string;
+}
+
+/**
+ * L7 规范的控件容器，将子控件按 position 分组到四角自动排列
+ *
+ * 核心机制：
+ * 1. 遍历 children，识别控件组件（有 position prop 或已注册的控件类型）
+ * 2. 按 position 分组，每组放在一个 flex 容器中（.l7-control-anchor）
+ * 3. 非控件 children（如 Marker、Layer）原样渲染
+ * 4. 设置 ControlContainerContext，让子控件知道自己处于容器中，
+ *    从而跳过自身的 .l7-control-anchor 包裹
+ *
+ * 用法：
+ * ```tsx
+ * <ControlContainer>
+ *   <ZoomControl position="bottomright" />
+ *   <GeoLocateControl position="bottomright" />
+ *   <ScaleControl position="bottomleft" />
+ *   <MapThemeControl position="topright" />
+ * </ControlContainer>
+ * ```
+ */
+export declare function ControlContainer({ children, className, style }: ControlContainerProps): JSX_2.Element;
+
+declare interface ControlContainerProps {
+    children?: ReactNode;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+export declare type ControlPosition = 'topleft' | 'topright' | 'bottomleft' | 'bottomright' | 'topcenter' | 'bottomcenter' | 'lefttop' | 'leftbottom' | 'righttop' | 'rightbottom';
+
+/**
+ * 控件公共属性
+ */
+export declare interface ControlProps {
+    /** 控件位置，默认各控件有各自的默认值 */
+    position?: L7ControlPosition;
+    /** 额外 className */
+    className?: string;
+    /** 额外 style */
+    style?: React.CSSProperties;
+}
+
+/**
+ * 控件注册器 — 每个控件组件调用 mark() 标记自身
+ */
+export declare const ControlRegistry: {
+    /** 注册控件组件 */
+    mark(Comp: any): void;
+    /** 检测 child 是否为注册过的控件组件 */
+    check(child: default_2.ReactElement): boolean;
+};
+
+/**
+ * Schema 模式控件渲染器
+ *
+ * 使用 ControlContainer 包裹，按 position 自动分组排列，
+ * 同一角度的多个控件自动堆叠而不会重叠
+ */
+export declare function ControlRenderer({ controls, layers, onLayerToggle, containerRef }: ControlRendererProps): JSX_2.Element;
+
+declare interface ControlRendererProps {
+    controls: ControlSchema[];
+    layers: LayerSchema[];
+    onLayerToggle?: (layerId: string, visible: boolean) => void;
+    containerRef?: default_2.RefObject<HTMLElement | null>;
+}
+
+export declare interface ControlSchema {
+    type: ControlType;
+    position?: ControlPosition;
+    options?: Record<string, unknown>;
+}
+
+export declare type ControlType = 'zoom' | 'scale' | 'fullscreen' | 'geoLocate' | 'mapTheme' | 'mouseLocation' | 'exportImage' | 'layerSwitch';
+
+/**
+ * 底图工厂 — 根据配置创建 L7 Map 实例
+ * 动态导入各底图模块，避免未使用时打包
+ */
+export declare function createBasemap(schema: MapSchema): Promise<default_3 | Mapbox | TMap | TencentMap | BaiduMap | MapLibre | GoogleMap | Map_2>;
+
+/**
+ * 创建 EventBus 实例
+ */
+export declare function createEventBus(): EventBus;
+
+/**
+ * 合并 className（基于 clsx）
+ */
+export declare function cx(...inputs: (string | undefined | null | false)[]): string;
+
+export declare function deepMerge<T extends DeepMergeable>(target: T, source: Partial<T>): T;
+
+/**
+ * 深度合并工具函数
+ * 适用于合并 Schema 配置，如响应式覆盖
+ */
+declare type DeepMergeable = Record<string, any>;
+
+export declare const DEFAULT_CITY_SOURCE = "https://mdn.alipayobjects.com/antforest/afts/file/A*Xd8TQoduwj8AAAAAgEAAAAgAerd2AQ/original_\u4E2D\u56FD_\u5E02.json";
+
+export declare const DEFAULT_DISTRICT_SOURCE = "https://mdn.alipayobjects.com/portal_moelhz/afts/file/A*Rb96Tac1p8EAAAAAgKAAAAgAegAAAQ";
+
+/** 内置行政区划数据源 */
+export declare const DEFAULT_PROVINCE_SOURCE = "https://mdn.alipayobjects.com/antforest/afts/file/A*T2OJQ7XZzeEAAAAAgCAAAAgAerd2AQ/original_\u4E2D\u56FD_\u7701.json";
+
+/**
+ * 对比两个 Schema 的差异，返回需要更新的部分
+ */
+export declare function diffSchema(prev: AiMapSchema, next: AiMapSchema): SchemaDiffResult;
+
+/** 下钻路径节点 */
+export declare interface DrillPathNode {
+    level: AdministrativeLevel;
+    name: string;
+    adcode?: string | number;
+}
+
+/**
+ * 错误边界组件
+ *
+ * 捕获子组件树中的 JS 错误，防止整个应用崩溃。
+ * 适用于第三方地图 SDK 可能抛出异常的场景（如 key 失效、网络阻断等）。
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: default_2.ErrorInfo): void;
+    render(): string | number | boolean | Iterable<default_2.ReactNode> | JSX_2.Element | null | undefined;
+}
+
+declare interface ErrorBoundaryProps {
+    /** 出错时的降级 UI，默认显示错误信息 */
+    fallback?: default_2.ReactNode | ((error: Error) => default_2.ReactNode);
+    /** 错误回调 */
+    onError?: (error: Error, errorInfo: default_2.ErrorInfo) => void;
+    children: default_2.ReactNode;
+}
+
+declare interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+
+/**
+ * 简单事件总线，用于组件间通信
+ */
+export declare class EventBus {
+    private listeners;
+    /**
+     * 注册事件监听
+     */
+    on(event: string, callback: EventCallback): () => void;
+    /**
+     * 注册一次性事件监听
+     */
+    once(event: string, callback: EventCallback): () => void;
+    /**
+     * 触发事件
+     */
+    emit(event: string, ...args: unknown[]): void;
+    /**
+     * 移除指定事件的所有监听
+     */
+    off(event: string): void;
+    /**
+     * 清除所有监听
+     */
+    clear(): void;
+}
+
+export declare function EventBusProvider({ events, children }: EventBusProviderProps): JSX_2.Element;
+
+declare interface EventBusProviderProps {
+    /** 初始事件监听（从 AiMap events prop 传入） */
+    events?: Record<string, (...args: unknown[]) => void>;
+    children: default_2.ReactNode;
+}
+
+declare type EventCallback = (...args: unknown[]) => void;
+
+declare type EventIdentifier = string;
+
+export declare interface EventSchema {
+    /** 地图移动事件标识符 */
+    mapMove?: EventIdentifier;
+    /** 地图缩放事件标识符 */
+    mapZoom?: EventIdentifier;
+    /** Marker 拖拽结束事件标识符 */
+    markerDragEnd?: EventIdentifier;
+}
+
+export declare function ExportImageControl({ position, format, onExport, className, style, }: ExportImageControlProps): JSX_2.Element;
+
+/**
+ * ExportImage 导出图片控件
+ *
+ * 遵循 L7 的 ButtonControl 规范 + Material Design 3 玻璃态风格：
+ * - CSS 类名: .l7-control .l7-button-control
+ * - 玻璃态: glass-effect + surface/90 背景
+ * - 位置默认: topright
+ * - API: mapsService.exportMap() + scene.exportPng()，然后合并图片
+ */
+export declare interface ExportImageControlProps {
+    /** 控件位置，默认 topright */
+    position?: L7ControlPosition;
+    /** 图片格式，默认 png */
+    format?: 'png' | 'jpg';
+    className?: string;
+    style?: default_2.CSSProperties;
+    /** 导出回调 */
+    onExport?: (base64: string) => void;
+}
+
+declare type FillColorMapping = 'sequential' | 'diverging' | 'categorical';
+
+/**
+ * 填充图组件（填充 + 描边 + 文字）
+ */
+export declare function FillLayer({ source, sourceType, colorMapping, showStroke, strokeColor, strokeWidth, hoverEffect, clickEffect, stickySelection, tooltipEffect, tooltipFields, tooltipTemplate, regionIdField, highlightStrokeColor, highlightStrokeWidth, zoomToRegionOnClick, clickZoomPadding, clickZoomDelta, onRegionClick, onDrilldown, showLabel, labelField, labelColor, labelSize, labelAreaThreshold, labelHaloWidth, minLabelZoom, valueField, percentageField, nameField, color, colorField, colorValues, active, select, events, style, ...rest }: FillLayerProps): JSX_2.Element;
+
+export declare interface FillLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    colorMapping?: FillColorMapping;
+    showStroke?: boolean;
+    strokeColor?: string;
+    strokeWidth?: number;
+    hoverEffect?: boolean;
+    clickEffect?: boolean;
+    stickySelection?: boolean;
+    tooltipEffect?: boolean;
+    tooltipFields?: string[];
+    tooltipTemplate?: string;
+    regionIdField?: string;
+    highlightStrokeColor?: string;
+    highlightStrokeWidth?: number;
+    zoomToRegionOnClick?: boolean;
+    clickZoomPadding?: number;
+    clickZoomDelta?: number;
+    onRegionClick?: (payload: LayerEventPayload) => void;
+    onDrilldown?: (feature: Record<string, unknown>) => void;
+    showLabel?: boolean;
+    labelField?: string;
+    labelColor?: string;
+    labelSize?: number;
+    labelAreaThreshold?: number;
+    labelHaloWidth?: number;
+    minLabelZoom?: number;
+    valueField?: string;
+    percentageField?: string;
+    nameField?: string;
+}
+
+export declare function FullscreenControl({ position, container, className, style, }: FullscreenControlProps): JSX_2.Element;
+
+/**
+ * Fullscreen 全屏控件
+ *
+ * 遵循 L7 的 ButtonControl 规范 + Material Design 3 玻璃态风格：
+ * - CSS 类名: .l7-control .l7-button-control
+ * - 玻璃态: glass-effect + surface/90 背景
+ * - 位置默认: topright
+ * - API: ScreenFull.toggle(container)
+ * - 事件: document.fullscreenchange
+ */
+export declare interface FullscreenControlProps {
+    /** 控件位置，默认 topright */
+    position?: L7ControlPosition;
+    /** 全屏目标容器，默认使用地图容器 */
+    container?: HTMLElement | null;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * 内置高德地图主题预设
+ */
+export declare const GAODE_THEME_PRESETS: ThemeOption[];
+
+export declare function GeoLocateControl({ position, transform, className, style, }: GeoLocateControlProps): JSX_2.Element;
+
+/**
+ * GeoLocate 定位控件
+ *
+ * 遵循 L7 的 ButtonControl 规范 + Material Design 3 玻璃态风格：
+ * - CSS 类名: .l7-control .l7-button-control
+ * - 玻璃态: glass-effect + surface/90 背景
+ * - 位置默认: topright
+ * - API: navigator.geolocation + mapsService.setZoomAndCenter()
+ * - transform 回调支持坐标转换
+ */
+export declare interface GeoLocateControlProps {
+    /** 控件位置，默认 topright */
+    position?: L7ControlPosition;
+    /** 坐标转换函数 */
+    transform?: (position: [number, number]) => [number, number] | Promise<[number, number]>;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+export declare interface GestureConfig {
+    dragPan?: boolean;
+    pinchZoom?: boolean;
+    dragRotate?: boolean;
+}
+
+/**
+ * 字体图标标注图层（GlyphLayer）
+ *
+ * 支持 Material Symbols Outlined 及自定义 iconfont 字体：
+ * - Material Symbols: 页面已加载 Google 字体，组件自动注册映射表，开箱即用
+ * - 内置 iconfont: at.alicdn.com 天气字体，内置 5 个图标
+ * - 自定义: 传入 iconFontFamily + iconFontPath + iconFontMap
+ *
+ * 特性：
+ * - SDF 渲染确保任意缩放下边缘锐利
+ * - 图标 1-2px 光晕增强复杂底图辨识度
+ * - 文字 2px 光晕确保可读性
+ * - 碰撞检测：图标始终可见，仅文本被避让
+ * - 缩放适配：L1(14+) 全显示 → L2(10-13) 仅图标 → L3(<10) 降级圆点
+ */
+export declare function GlyphLayer({ source, sourceType, sourceConfig, iconField, iconFontFamily, iconFontPath, iconFontMap, iconColor, iconSize, iconHaloColor, iconHaloWidth, iconStyle, showLabel, labelField, labelColor, labelSize, labelAnchor, labelOffset, labelHaloColor, labelHaloWidth, labelStyle, textAllowOverlap, iconAllowOverlap, zoomAdaption, zoomShowLabel, zoomDegradeToPoint, onClick, onMouseEnter, onMouseLeave, ...rest }: GlyphLayerProps): JSX_2.Element | null;
+
+export declare interface GlyphLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    /** 图标内容字段（数据中每个要素的该字段值将作为图标文本渲染） */
+    iconField: string;
+    /**
+     * 字体族模式
+     * - 'material-symbols'（默认）：使用 Material Symbols Outlined 字体，图标名需使用官方名称（如 sunny / flight / restaurant）
+     * - 'iconfont'：使用 at.alicdn.com 内置 iconfont 字体，图标名需使用 BUILTIN_ICON_FONTS 中的名称
+     * - 自定义字符串：自行通过 scene.addFontFace / addIconFonts 注册的字体族名
+     */
+    iconFontFamily?: string;
+    /**
+     * 自定义字体文件 URL，仅在 iconFontFamily 为自定义字符串时需要
+     * Material Symbols 自动从页面已加载的字体中获取；iconfont 使用内置 URL
+     */
+    iconFontPath?: string;
+    /**
+     * 自定义图标映射表，仅在 iconFontFamily 为自定义字符串时需要
+     * 格式同 addIconFonts：[['iconName', '&#xHEX;'], ...]
+     * 注意：Unicode 值必须使用 HTML 实体格式 &#xHEX; ，而非 JS \uXXXX 转义
+     */
+    iconFontMap?: Array<[string, string]>;
+    /** 图标颜色，支持单色或数据驱动映射 */
+    iconColor?: LayerSchema['color'];
+    /** 图标尺寸 (16-24px)，默认 20 */
+    iconSize?: number;
+    /** 图标光晕颜色，默认白色 */
+    iconHaloColor?: string;
+    /** 图标光晕宽度 (1-2px)，默认 1 */
+    iconHaloWidth?: number;
+    /** 图标样式扩展 */
+    iconStyle?: Record<string, unknown>;
+    /** 是否显示文字标签，默认 true */
+    showLabel?: boolean;
+    /** 文字标签字段，默认取 iconField */
+    labelField?: string;
+    /** 标签颜色 */
+    labelColor?: string;
+    /** 标签字号 (10-14px)，默认 11 */
+    labelSize?: number;
+    /** 文字锚点位置（直接透传给 L7 textAnchor），默认 'top' */
+    labelAnchor?: LabelAnchor;
+    /** 标签偏移量 [x, y]，默认 [0, 0] */
+    labelOffset?: [number, number];
+    /** 标签光晕颜色，默认白色 */
+    labelHaloColor?: string;
+    /** 标签光晕宽度，默认 2px */
+    labelHaloWidth?: number;
+    /** 标签样式扩展 */
+    labelStyle?: Record<string, unknown>;
+    /** 文本标签是否允许重叠，默认 false（开启碰撞检测，仅隐藏文本） */
+    textAllowOverlap?: boolean;
+    /** 图标是否允许重叠，默认 true（图标始终保持可见） */
+    iconAllowOverlap?: boolean;
+    /** 是否开启缩放适配，默认 true */
+    zoomAdaption?: boolean;
+    /** 高缩放级阈值（显示图标+文字），默认 14 */
+    zoomShowLabel?: number;
+    /** 低缩放级阈值（降级为圆点），默认 10 */
+    zoomDegradeToPoint?: number;
+    onClick?: (payload: LayerEventPayload) => void;
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 热力图图层组件
+ *
+ * 支持悬停高亮交互（对齐蜂窝热力图设计规范）
+ */
+export declare function HeatmapLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: HeatmapLayerProps): JSX_2.Element | null;
+
+export declare interface HeatmapLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    /** 点击事件 */
+    onClick?: (payload: LayerEventPayload) => void;
+    /** 鼠标移动事件 */
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    /** 鼠标进入事件 */
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    /** 鼠标离开事件 */
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 蜂窝热力图（六边形聚合）
+ */
+declare function HexagonLayer({ source, sourceType, sourceConfig, hexSize, weightField, weightMethod, onClick, onMouseMove, style, ...rest }: HexagonLayerProps): JSX_2.Element;
+export { HexagonLayer as HeatmapHexagonLayer }
+export { HexagonLayer }
+
+declare interface HexagonLayerProps extends Omit<LayerSchema, 'type' | 'shape' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    hexSize?: number;
+    weightField?: string;
+    weightMethod?: 'sum' | 'mean' | 'min' | 'max' | 'count';
+    onClick?: (payload: LayerEventPayload) => void;
+    onMouseMove?: (payload: LayerEventPayload) => void;
+}
+export { HexagonLayerProps as HeatmapHexagonLayerProps }
+export { HexagonLayerProps }
+
+/**
+ * 将十六进制颜色转为 RGBA
+ */
+export declare function hexToRgba(hex: string, alpha?: number): string;
+
+export declare type IconAnchor = 'center' | 'top' | 'bottom' | 'left' | 'right';
+
+/**
+ * 图片标注图层（IconLayer）
+ *
+ * 按照设计规范实现的图片图标+文字标签组合图层：
+ * - 内置图标与文字两个 PointLayer，统一管理渲染时序
+ * - 图标 1px 白色描边 (Halo) 增强复杂底图辨识度
+ * - 文字 2px 光晕确保深色底图可读性
+ * - 缩放适配：Zoom15+ 全显示 → 10-14 仅图标 → <10 降级圆点
+ * - 碰撞检测：重叠时隐藏低优先级文本
+ */
+export declare function IconLayer({ source, sourceType, sourceConfig, iconField, iconMap, iconSize, iconAnchor, size, showLabel, labelField, labelColor, labelSize, labelAnchor, labelOffset, labelHaloColor, labelHaloWidth, labelStyle, textAllowOverlap, iconAllowOverlap, zoomAdaption, zoomShowLabel, zoomDegradeToPoint, onClick, onMouseEnter, onMouseLeave, ...rest }: IconLayerProps): JSX_2.Element | null;
+
+export declare interface IconLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    /** 图标映射字段 */
+    iconField: string;
+    /** 图标资源映射 { fieldValue: imageUrl } */
+    iconMap: Record<string, string>;
+    /** 图标尺寸，标准 24，紧凑 16 */
+    iconSize?: number;
+    /** 图标锚点位置，默认 'bottom' */
+    iconAnchor?: IconAnchor;
+    /** 是否显示文字标签，默认 true */
+    showLabel?: boolean;
+    /** 文字标签字段，默认取 iconField */
+    labelField?: string;
+    /** 标签颜色 */
+    labelColor?: string;
+    /** 标签字号 (12-14px) */
+    labelSize?: number;
+    /** 文字锚点位置（直接透传给 L7 textAnchor），默认 'top' */
+    labelAnchor?: LabelAnchor_2;
+    /** 标签光晕颜色，默认白色 */
+    labelHaloColor?: string;
+    /** 标签光晕宽度，默认 2px */
+    labelHaloWidth?: number;
+    /** 标签偏移量 [x, y]，默认 [0, 0] */
+    labelOffset?: [number, number];
+    /** 标签样式扩展 */
+    labelStyle?: Record<string, unknown>;
+    /** 文本是否允许重叠，默认 false（开启碰撞检测） */
+    textAllowOverlap?: boolean;
+    /** 图标是否允许重叠，默认 true */
+    iconAllowOverlap?: boolean;
+    /** 是否开启缩放适配，默认 true */
+    zoomAdaption?: boolean;
+    /** 高缩放级阈值（显示图标+文字），默认 15 */
+    zoomShowLabel?: number;
+    /** 低缩放级阈值（降级为圆点），默认 10 */
+    zoomDegradeToPoint?: number;
+    onClick?: (payload: LayerEventPayload) => void;
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 图片图层组件
+ */
+export declare function ImageLayer({ source, sourceType, sourceConfig, onClick, ...rest }: ImageLayerProps): JSX_2.Element | null;
+
+export declare interface ImageLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    onClick?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 独立 Map (L7 内置) 主题预设
+ */
+export declare const INDEPENDENT_MAP_THEME_PRESETS: ThemeOption[];
+
+/**
+ * 批量渲染交互元素（Marker / Popup）
+ * Tooltip 由图层 hover/click 事件驱动，在此不做渲染
+ *
+ * 参考 L7 实现：使用 mapsService.getMarkerContainer() 作为 Marker/Popup 的 DOM 容器
+ */
+export declare function InteractionRenderer({ interactions }: InteractionRendererProps): JSX_2.Element;
+
+declare interface InteractionRendererProps {
+    interactions: InteractionSchema[];
+}
+
+export declare type InteractionSchema = MarkerSchema | PopupSchema | TooltipSchema;
+
+/**
+ * 控件位置类型，与 L7 PositionType 一致
+ */
+export declare type L7ControlPosition = 'topleft' | 'topright' | 'bottomleft' | 'bottomright' | 'topcenter' | 'bottomcenter' | 'lefttop' | 'leftbottom' | 'righttop' | 'rightbottom' | 'rightcenter' | 'leftcenter';
+
+/** 标签锚点位置 */
+export declare type LabelAnchor = 'right' | 'bottom' | 'top' | 'left' | 'center';
+
+/** 锚点位置 */
+declare type LabelAnchor_2 = 'right' | 'bottom' | 'top' | 'left';
+
+/** 图层事件回调集合 */
+export declare interface LayerEventHandlers {
+    onClick?: (payload: LayerEventPayload) => void;
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+/** L7 图层事件回调参数 */
+export declare interface LayerEventPayload {
+    /** 触发事件的图层 ID（schema.id 或自动生成） */
+    layerId: string;
+    /** 图层类型 */
+    layerType: LayerType;
+    /** L7 原始事件对象 */
+    originalEvent: unknown;
+    /** 经度 */
+    lng: number;
+    /** 纬度 */
+    lat: number;
+    /** 命中的数据属性 */
+    feature?: Record<string, unknown>;
+}
+
+/** 图层级别事件配置 */
+export declare interface LayerEventSchema {
+    /** 点击事件标识符，触发时通过 EventBus 广播 */
+    click?: EventIdentifier;
+    /** 鼠标悬浮事件标识符 */
+    mousemove?: EventIdentifier;
+    /** 鼠标移入事件标识符 */
+    mouseenter?: EventIdentifier;
+    /** 鼠标移出事件标识符 */
+    mouseleave?: EventIdentifier;
+    /** 是否启用内置 Popup（点击显示数据） */
+    enablePopup?: boolean;
+    /** Popup 触发方式，默认 click */
+    popupTrigger?: 'click' | 'hover';
+    /** Popup 显示的字段，不设则显示所有字段 */
+    popupFields?: string[];
+    /** Popup 模板，支持 {{field}} 占位符 */
+    popupTemplate?: string;
+}
+
+/**
+ * 图层配置项 — 支持可见性切换 + 透明度
+ */
+export declare interface LayerItem {
+    /** 图层 ID */
+    id: string;
+    /** 图层名称 */
+    name?: string;
+    /** 是否可见，默认 true */
+    visible?: boolean;
+    /** 透明度 0~1，默认 1 */
+    opacity?: number;
+    /** 图层图标 (Material Symbols Outlined 名称)，默认 layers */
+    icon?: string;
+}
+
+/**
+ * 批量渲染图层
+ */
+export declare function LayerRenderer({ layers, eventHandlers }: LayerRendererProps): JSX_2.Element | null;
+
+declare interface LayerRendererProps {
+    layers: LayerSchema[];
+    /** 图层事件回调集合 */
+    eventHandlers?: LayerEventHandlers;
+}
+
+export declare interface LayerSchema {
+    id?: string;
+    type: LayerType;
+    name?: string;
+    visible?: boolean;
+    zIndex?: number;
+    minZoom?: number;
+    maxZoom?: number;
+    autoFit?: boolean;
+    source: unknown;
+    sourceType?: SourceType;
+    sourceConfig?: SourceConfig;
+    color?: string;
+    colorField?: string;
+    colorValues?: string[] | string;
+    size?: number;
+    sizeField?: string;
+    sizeValues?: number[];
+    shape?: string;
+    shapeField?: string;
+    shapeValues?: string[] | string;
+    style?: Record<string, unknown>;
+    /** 图层整体不透明度，0~1，默认 1 */
+    opacity?: number;
+    /** 图层混合模式，对齐 CSS mix-blend-mode */
+    blend?: 'normal' | 'additive' | 'subtractive' | 'max';
+    filterField?: string;
+    filterValues?: unknown[];
+    animate?: AnimateConfig;
+    active?: ActiveConfig;
+    select?: SelectConfig;
+    events?: LayerEventSchema;
+}
+
+export declare function LayerSwitchControl({ position, layers, onToggle, onOpacityChange, className, style, }: LayerSwitchControlProps): JSX_2.Element | null;
+
+export declare interface LayerSwitchControlProps {
+    /** 控件位置，默认 topright */
+    position?: L7ControlPosition;
+    /** 图层列表 */
+    layers: LayerItem[];
+    /** 可见性切换回调 */
+    onToggle: (layerId: string, visible: boolean) => void;
+    /** 透明度变化回调 */
+    onOpacityChange?: (layerId: string, opacity: number) => void;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+export declare type LayerType = 'point' | 'line' | 'polygon' | 'heatmap' | 'raster' | 'image';
+
+/**
+ * 分类图例 — 离散色块列表
+ *
+ * 视觉规范:
+ * - 色块 12×12px，支持 square (rounded-sm) 和 circle 两种形状
+ * - 垂直列表或两列网格布局（grid）
+ * - 悬停高亮：其余项 dimmed (opacity 0.35)
+ * - 点击切换：dimmed 态表示该项在地图上被隐藏
+ *
+ * @see legend.md §2 分类与枚举图例
+ */
+export declare function LegendCategories({ title, labels, colors, swatchShape, grid, className, interaction, }: LegendCategoriesProps): JSX_2.Element;
+
+declare interface LegendCategoriesProps extends LegendCategoriesSchema {
+    className?: string;
+    /** 交互回调 */
+    interaction?: LegendInteractionCallbacks;
+}
+
+export declare interface LegendCategoriesSchema {
+    type: 'categories';
+    title?: string;
+    labels: string[];
+    colors: string[];
+    /** 色块形状，默认 'square' */
+    swatchShape?: LegendSwatchShape;
+    /** 是否使用两列网格布局，默认 false */
+    grid?: boolean;
+}
+
+/**
+ * 发散图例 — 双极渐变色条
+ *
+ * 展示偏离中心点（如 0 或平均值）的对称变化。
+ * 中间位置显示中性点标签，两端向不同色调延伸。
+ *
+ * 视觉规范:
+ * - 色条高度 12px，圆角 4px
+ * - 中间竖线标记中性点
+ * - 三标签布局：左端标签、中间标签、右端标签
+ *
+ * @see legend.md §4 离散与发散图例
+ */
+export declare function LegendDiverging({ title, colors, labels, middleLabel, className, }: LegendDivergingProps): JSX_2.Element;
+
+declare interface LegendDivergingProps extends LegendDivergingSchema {
+    className?: string;
+    interaction?: LegendInteractionCallbacks;
+}
+
+/** 发散图例：双极渐变（如 红→灰→绿） */
+export declare interface LegendDivergingSchema {
+    type: 'diverging';
+    title?: string;
+    /** 渐变色列表，从左到右（如 ['#ef4444','#ccc','#10b981']） */
+    colors: string[];
+    /** [左端标签, 右端标签] */
+    labels: [string, string];
+    /** 中间值标签（如 '0' 或 'Avg'） */
+    middleLabel?: string;
+}
+
+/**
+ * 图标图例 — 图标 + 标签列表
+ *
+ * 使用自定义图标（URL 图片）和标签文本。
+ * 图片加载失败时显示 fallback 文字。
+ *
+ * 视觉规范:
+ * - 图标 20×20px
+ * - 列表项 hover 高亮，点击切换显隐
+ *
+ * @see legend.md §2 分类与枚举图例 (图标变体)
+ */
+export declare function LegendIcon({ title, items, className, interaction }: LegendIconProps): JSX_2.Element;
+
+export declare interface LegendIconItem {
+    icon: string;
+    label: string;
+}
+
+declare interface LegendIconProps extends LegendIconSchema {
+    className?: string;
+    interaction?: LegendInteractionCallbacks;
+}
+
+export declare interface LegendIconSchema {
+    type: 'icon';
+    title?: string;
+    items: LegendIconItem[];
+}
+
+/** 图例交互回调 */
+export declare interface LegendInteractionCallbacks {
+    /** 悬停高亮：传入图例项索引，-1 表示取消 */
+    onHover?: (index: number) => void;
+    /** 点击切换显隐：传入图例项索引 */
+    onToggle?: (index: number) => void;
+    /** 范围刷选：连续型图例的数据范围 [min, max] */
+    onBrush?: (range: [number, number]) => void;
+}
+
+/**
+ * 线宽图例 — 路径粗细映射
+ *
+ * 展示不同宽度的线条与对应数值的映射关系。
+ * 适用于路径、轨迹、流向等线要素的图例说明。
+ *
+ * 视觉规范:
+ * - 线宽为实际像素值，长度 28px，圆角 pill 形
+ * - 标签在右侧
+ * - 支持悬停高亮和点击显隐切换
+ *
+ * @see legend.md — LineWidth 类型图例
+ */
+export declare function LegendLineWidth({ title, color, items, className, interaction, }: LegendLineWidthProps): JSX_2.Element;
+
+declare interface LegendLineWidthProps extends LegendLineWidthSchema {
+    className?: string;
+    interaction?: LegendInteractionCallbacks;
+}
+
+/** 线宽图例 */
+export declare interface LegendLineWidthSchema {
+    type: 'lineWidth';
+    title?: string;
+    /** 线条颜色 */
+    color?: string;
+    /** 线宽项 */
+    items: Array<{
+        width: number;
+        label: string;
+    }>;
+}
+
+/**
+ * 比例图例 — 数值区间与等比圆
+ *
+ * 使用 [min, max] 区间标签和等比递增的圆形展示数据分布。
+ * 底部对齐，大小从最小到最大递增。
+ *
+ * 视觉规范（向后兼容）:
+ * - 圆直径 6px ~ 24px
+ * - 等宽字体标签
+ *
+ * @see LegendSize 为新版推荐的替代组件，提供更灵活的 items 配置
+ */
+export declare function LegendProportion({ title, labels, fillColor, className, }: LegendProportionProps): JSX_2.Element;
+
+declare interface LegendProportionProps extends LegendProportionSchema {
+    className?: string;
+    interaction?: LegendInteractionCallbacks;
+}
+
+export declare interface LegendProportionSchema {
+    type: 'proportion';
+    title?: string;
+    labels: [number, number][];
+    fillColor?: string;
+}
+
+/**
+ * 连续/分级色带图例
+ *
+ * 视觉规范:
+ * - 色条高度 12px，圆角 4px
+ * - isContinuous: 无级渐变 (linear-gradient)，否则分段色块
+ * - 标签: 两侧 min/max，多标签时显示中间值
+ * - showTicks: 刻度线
+ * - brushable: 范围刷选手柄，支持拖动筛选数据范围
+ *
+ * @see legend.md §3 连续与分级图例
+ */
+export declare function LegendRamp({ title, labels, colors, isContinuous, showTicks, brushable, className, interaction, }: LegendRampProps): JSX_2.Element;
+
+declare interface LegendRampProps extends LegendRampSchema {
+    className?: string;
+    /** 交互回调 */
+    interaction?: LegendInteractionCallbacks;
+}
+
+export declare interface LegendRampSchema {
+    type: 'ramp';
+    title?: string;
+    labels: string[];
+    colors: string[];
+    /** 连续渐变 vs 分段色块，默认 false（分段） */
+    isContinuous?: boolean;
+    /** 是否显示刻度线 */
+    showTicks?: boolean;
+    /** 是否启用范围刷选 */
+    brushable?: boolean;
+}
+
+/**
+ * 图例面板渲染器 — 统一管理多个图例的容器
+ *
+ * 功能:
+ * - 玻璃拟态面板 (bg-surface/80 backdrop-blur-md)
+ * - 自动根据 schema.type 分派到对应子组件
+ * - 多图例间自动分隔
+ * - 支持交互回调 (hover 高亮 / toggle 显隐 / brush 范围)
+ *
+ * @see legend.md §1 基础视觉准则
+ */
+export declare function LegendRenderer({ legends, className, style, interaction, }: LegendRendererProps): JSX_2.Element | null;
+
+declare interface LegendRendererProps {
+    legends: LegendSchema[];
+    /** 图例面板位置样式，默认左下角 */
+    className?: string;
+    style?: default_2.CSSProperties;
+    /** 图例交互回调 */
+    interaction?: LegendInteractionCallbacks;
+}
+
+export declare type LegendSchema = LegendCategoriesSchema | LegendRampSchema | LegendDivergingSchema | LegendThresholdSchema | LegendSizeSchema | LegendLineWidthSchema | LegendProportionSchema | LegendIconSchema;
+
+/**
+ * 比例大小图例 — 圆形大小映射
+ *
+ * 使用一组递增大小的圆形来展示数值与视觉尺寸的映射关系。
+ * 圆形底部对齐，圆直径与数据值成正比。
+ *
+ * 视觉规范:
+ * - 最大圆直径 24px，最小 6px
+ * - 圆形带 1px 内嵌阴影以区分重叠
+ * - 标签在圆下方，等宽字体
+ *
+ * @see legend.md — Size / Proportion 类型图例
+ */
+export declare function LegendSize({ title, fillColor, items, className, }: LegendSizeProps): JSX_2.Element;
+
+declare interface LegendSizeProps extends LegendSizeSchema {
+    className?: string;
+    interaction?: LegendInteractionCallbacks;
+}
+
+/** 比例大小图例：圆形大小映射 */
+export declare interface LegendSizeSchema {
+    type: 'size';
+    title?: string;
+    /** 填充色 */
+    fillColor?: string;
+    /** 大小项：圆直径 (px) + 标签 */
+    items: Array<{
+        size: number;
+        label: string;
+    }>;
+}
+
+/** 分类图例色块形状 */
+export declare type LegendSwatchShape = 'square' | 'circle';
+
+/**
+ * 阈值图例 — 自定义分段垂直列表
+ *
+ * 根据业务需求定义的非等间距区间，以垂直列表展示。
+ * 每项显示色块 + [min, max) 区间文本，支持悬停高亮与点击显隐切换。
+ *
+ * 视觉规范:
+ * - 色块 24×12px，圆角 2px
+ * - 区间标签使用 JetBrains Mono 等宽字体
+ * - 悬停其余项 dimmed，点击切换显隐
+ *
+ * @see legend.md §3.3 Threshold 自定义分段
+ */
+export declare function LegendThreshold({ title, ranges, colors, className, interaction, }: LegendThresholdProps): JSX_2.Element;
+
+declare interface LegendThresholdProps extends LegendThresholdSchema {
+    className?: string;
+    interaction?: LegendInteractionCallbacks;
+}
+
+/** 阈值图例：自定义分段垂直列表 */
+export declare interface LegendThresholdSchema {
+    type: 'threshold';
+    title?: string;
+    /** 区间定义 [min, max)，从上到下排列 */
+    ranges: [number | string, number | string][];
+    /** 每个区间对应的颜色 */
+    colors: string[];
+}
+
+/**
+ * 线图层组件
+ *
+ * ```tsx
+ * <AiMap map={{ basemap: 'gaode' }}>
+ *   <LineLayer source={flowData} sourceConfig={{ x: 'lng', y: 'lat', x1: 'lng1', y1: 'lat1' }} color="#5B8FF9" />
+ * </AiMap>
+ * ```
+ */
+export declare function LineLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: LineLayerProps): JSX_2.Element | null;
+
+export declare interface LineLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    onClick?: (payload: LayerEventPayload) => void;
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+declare interface MapEventHandlers {
+    onMove?: (payload: MapEventPayload) => void;
+    onZoom?: (payload: MapEventPayload) => void;
+}
+
+/** 地图事件回调参数 */
+export declare interface MapEventPayload {
+    /** L7 原始事件对象 */
+    originalEvent: unknown;
+    /** 当前中心点 */
+    center: [number, number];
+    /** 当前缩放级别 */
+    zoom: number;
+    /** 当前俯仰角 */
+    pitch: number;
+    /** 当前旋转角 */
+    rotation: number;
+}
+
+export declare function MapSceneRenderer({ mapSchema, children, onSceneReady, mapEventHandlers, events, className, style, }: MapSceneRendererProps): JSX_2.Element;
+
+declare interface MapSceneRendererProps {
+    mapSchema: MapSchema;
+    children?: default_2.ReactNode;
+    onSceneReady?: (scene: Scene) => void;
+    mapEventHandlers?: MapEventHandlers;
+    events?: EventSchema;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+export declare interface MapSchema {
+    basemap: BasemapType;
+    token?: string;
+    style?: MapStylePreset | string;
+    center?: [number, number];
+    zoom?: number;
+    pitch?: number;
+    rotation?: number;
+    minZoom?: number;
+    maxZoom?: number;
+    bounds?: [[number, number], [number, number]];
+    gestureConfig?: GestureConfig;
+}
+
+export declare type MapStylePreset = 'light' | 'dark' | 'normal' | 'darkblue' | 'satellite';
+
+export declare type MapTheme = 'light' | 'dark' | 'system';
+
+export declare function MapThemeControl({ position, options: propOptions, defaultValue, onThemeChange, className, style, }: MapThemeControlProps): JSX_2.Element;
+
+export declare interface MapThemeControlProps {
+    /** 控件位置，默认 topright */
+    position?: L7ControlPosition;
+    /** 自定义主题选项，默认自动获取 */
+    options?: ThemeOption[];
+    /** 默认选中的主题值 */
+    defaultValue?: string;
+    /** 主题切换回调 */
+    onThemeChange?: (value: string) => void;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+export declare function Marker({ longitude, latitude, variant, color, icon, label, content, children, draggable, className, overlayContainer, onClick, onMouseEnter, onMouseLeave, onDoubleClick, onDragEnd, onDragging, onDragStart, selected, inactive, anchor, offsets, overflowHide, }: MarkerProps): null;
+
+/**
+ * Marker 聚合图层（基于 supercluster）
+ *
+ * 性能优化策略：
+ * 1. 使用 supercluster R-tree 空间索引，O(log n) 查询
+ * 2. 仅在 zoom 变化时重新聚合（平移时 Marker 组件通过 camerachange 自行更新 DOM 位置）
+ * 3. 点击聚合使用 getClusterExpansionZoom 精确缩放
+ * 4. SpiderLine 使用 ref + 直接 DOM 操作，避免 setState 重渲染
+ *
+ * 设计规范：Cartographic Precision System v1.2.0
+ * - 视觉分级：小规模(2-99)、中规模(100-999)、大规模(1000+)
+ * - 交互：悬停放大(scale-110)、点击缩放、最大级别蜘蛛布局展开
+ */
+export declare function MarkerClusterLayer({ source, sourceType, sourceConfig, gridSize, minClusterSize, animationDuration, easing, onPointClick, onClusterClick, }: MarkerClusterLayerProps): JSX_2.Element;
+
+export declare interface MarkerClusterLayerProps {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    /** 聚合半径（像素），对应 supercluster 的 radius 参数 */
+    gridSize?: number;
+    /** 形成聚合的最小点数 */
+    minClusterSize?: number;
+    animationDuration?: number;
+    easing?: string;
+    onPointClick?: (point: ClusterPoint) => void;
+    /**
+     * 聚合点点击回调
+     * @param cluster 聚合信息
+     * @param leaves 聚合包含的所有原始要素（Supercluster 叶子节点）
+     */
+    onClusterClick?: (cluster: ClusterItem, leaves?: any[]) => void;
+}
+
+/**
+ * Marker 语义颜色
+ * - primary:  信息/默认 (#2563EB)
+ * - success:  完成/安全 (#00854D)
+ * - warning:  预警/高负载 (#943700)
+ * - error:    故障/危险 (#BA1A1A)
+ */
+export declare type MarkerColor = 'primary' | 'success' | 'warning' | 'error';
+
+export declare interface MarkerProps extends Omit<MarkerSchema, 'type' | 'content'> {
+    /** Marker 形态，默认 pin */
+    variant?: MarkerVariant;
+    /** 语义颜色，默认 primary */
+    color?: MarkerColor;
+    /** Material Symbols 图标名 (仅 variant='icon' 时生效) */
+    icon?: string;
+    /** 文本标注，显示在 Marker 下方 4px */
+    label?: string;
+    /** 自定义内容，优先级高于 variant/color/icon/label */
+    content?: default_2.ReactNode | string;
+    /** 子元素，作为自定义内容渲染 */
+    children?: default_2.ReactNode;
+    className?: string;
+    overlayContainer?: HTMLElement | null;
+    onClick?: (e: default_2.MouseEvent) => void;
+    onMouseEnter?: (e: default_2.MouseEvent) => void;
+    onMouseLeave?: (e: default_2.MouseEvent) => void;
+    onDoubleClick?: (e: default_2.MouseEvent) => void;
+    onDragEnd?: (lng: number, lat: number) => void;
+    onDragging?: (lng: number, lat: number) => void;
+    onDragStart?: (lng: number, lat: number) => void;
+    /** 选中状态 */
+    selected?: boolean;
+    /** 禁用/离线状态 */
+    inactive?: boolean;
+    anchor?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    offsets?: [number, number];
+    overflowHide?: boolean;
+}
+
+export declare interface MarkerSchema {
+    type: 'marker';
+    longitude: number;
+    latitude: number;
+    /** 标注内容，支持纯文本 / HTML 字符串 */
+    content?: string;
+    draggable?: boolean;
+}
+
+/**
+ * Marker 基础形态
+ * - pin:   水滴型 (32x40px)，默认业务点，用于 POI、站点、静态设施
+ * - circle: 圆型 (24x24px)，移动/轻量点，用于实时车辆、传感器
+ * - icon:  图标型，在 Pin 内嵌入 Material Symbols 图标
+ * - dot:   简化点 (8px)，低缩放级降级形态
+ */
+export declare type MarkerVariant = 'pin' | 'circle' | 'icon' | 'dot';
+
+export declare interface MobileConfig {
+    controls?: MobileControlConfig;
+    layers?: MobileLayerOverrides | {
+        '*': Partial<LayerSchema>;
+    };
+    legends?: MobileLegendConfig;
+    toolbar?: MobileToolbarConfig;
+}
+
+export declare interface MobileControlConfig {
+    position?: string;
+    scale?: number;
+    hide?: string[];
+}
+
+export declare interface MobileLayerOverrides {
+    [id: string]: Partial<LayerSchema>;
+}
+
+export declare interface MobileLegendConfig {
+    compact?: boolean;
+    position?: string;
+}
+
+/**
+ * 移动端底部弹出式图例
+ *
+ * 功能:
+ * - 玻璃拟态面板
+ * - 点击标题栏展开/收起
+ * - 展开时 max-h-[65vh]，收起时 max-h-14
+ * - 支持所有图例类型
+ */
+export declare function MobileSheetLegend({ legends, className, interaction, }: MobileSheetLegendProps): JSX_2.Element | null;
+
+declare interface MobileSheetLegendProps {
+    legends: LegendSchema[];
+    className?: string;
+    interaction?: LegendInteractionCallbacks;
+}
+
+/**
+ * 移动端底部工具栏
+ */
+export declare function MobileToolbar({ config, className }: MobileToolbarProps): JSX_2.Element;
+
+export declare interface MobileToolbarConfig {
+    items: string[];
+    position: 'bottom' | 'top';
+}
+
+declare interface MobileToolbarProps {
+    config: MobileToolbarConfig;
+    className?: string;
+}
+
+export declare function MouseLocationControl({ position, precision, transform, className, style, }: MouseLocationControlProps): JSX_2.Element;
+
+/**
+ * MouseLocation 鼠标坐标控件
+ *
+ * 遵循 L7 的 Control 规范 + Material Design 3 玻璃态风格：
+ * - CSS 类名: .l7-control .l7-control-mouse-location
+ * - 玻璃态: glass-effect + inverse-surface 背景
+ * - 位置默认: bottomleft
+ * - API: mapsService.on('mousemove', handler), e.lngLat || e.lnglat
+ * - transform 回调支持坐标转换
+ * - 直接操作 DOM innerText，与 L7 一致
+ */
+export declare interface MouseLocationControlProps {
+    /** 控件位置，默认 bottomleft */
+    position?: L7ControlPosition;
+    /** 精度（小数位数），默认 6 */
+    precision?: number;
+    /** 坐标转换函数，设置后 precision 无效 */
+    transform?: (position: [number, number]) => [number, number];
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * Mapbox / Maplibre 主题预设 — 基于 openfreemap 样式
+ */
+export declare const OPENFREEMAP_THEME_PRESETS: ThemeOption[];
+
+/**
+ * 解析并规范化 Schema，填充默认值
+ */
+export declare function parseSchema(schema: AiMapSchema): AiMapSchema;
+
+/**
+ * 点图层组件
+ *
+ * ```tsx
+ * <AiMap map={{ basemap: 'gaode' }}>
+ *   <PointLayer source={data} color="#5B8FF9" size={12} />
+ * </AiMap>
+ * ```
+ */
+export declare function PointLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: PointLayerProps): JSX_2.Element | null;
+
+export declare interface PointLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    /** 数据源 — JSON 数组、GeoJSON 或 URL */
+    source: LayerSchema['source'];
+    /** 数据源类型，默认 'json' */
+    sourceType?: LayerSchema['sourceType'];
+    /** 经纬度字段配置 */
+    sourceConfig?: LayerSchema['sourceConfig'];
+    /** 点击事件 */
+    onClick?: (payload: LayerEventPayload) => void;
+    /** 鼠标移动事件 */
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    /** 鼠标进入事件 */
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    /** 鼠标离开事件 */
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 面图层组件
+ */
+export declare function PolygonLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: PolygonLayerProps): JSX_2.Element | null;
+
+export declare interface PolygonLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    onClick?: (payload: LayerEventPayload) => void;
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
+export declare function Popup({ longitude, latitude, content, closeButton, size, placement: placementProp, offset, header, attributes, actions, visible: visibleProp, singleton, overlayContainer, onClose, className, }: PopupProps): default_2.ReactPortal | null;
+
+/**
+ * Popup 操作按钮
+ */
+export declare interface PopupAction {
+    /** 按钮文字 */
+    label: string;
+    /** 按钮类型：primary 主按钮 / secondary 次要按钮 */
+    variant?: 'primary' | 'secondary';
+    /** 点击回调 */
+    onClick?: () => void;
+}
+
+/**
+ * Popup 属性项
+ */
+export declare interface PopupAttribute {
+    /** 属性标签 */
+    label: string;
+    /** 属性值 */
+    value: string | number;
+    /** 值颜色（可选，默认使用 on-surface） */
+    valueColor?: string;
+    /** Material Symbols 图标名（仅 detailed 模式渲染图标容器） */
+    icon?: string;
+}
+
+/**
+ * Popup 标题栏配置
+ */
+export declare interface PopupHeader {
+    /** 标题文字 */
+    title: string;
+    /** 封面图 URL（可选，显示在顶部 aspect-video 比例） */
+    coverUrl?: string;
+    /** 状态标签（可选，显示在封面图左下角） */
+    statusLabel?: string;
+    /** 状态颜色（可选，默认 emerald-500） */
+    statusColor?: string;
+    /** 标题前的状态点颜色（可选，compact 模式标题前脉冲指示灯） */
+    statusDot?: string;
+}
+
+/**
+ * 弹出框相对于锚点的位置
+ * - auto: 根据视口边界自动选择（默认）
+ * - top: 始终在锚点上方
+ * - bottom: 始终在锚点下方
+ * - left: 始终在锚点左侧
+ * - right: 始终在锚点右侧
+ */
+export declare type PopupPlacement = 'auto' | 'top' | 'bottom' | 'left' | 'right';
+
+export declare interface PopupProps extends Omit<PopupSchema, 'type' | 'content'> {
+    /** 弹窗内容，支持纯文本 / HTML 字符串 / ReactNode。当使用 header/attributes/actions 结构化模式时可省略 */
+    content?: string | default_2.ReactNode;
+    /** 尺寸变体，默认 standard */
+    size?: PopupSize;
+    /** 弹出位置，默认 auto（自动根据视口边界选择） */
+    placement?: PopupPlacement;
+    /** 弹出框偏移量（像素），默认 8px，正数远离锚点 */
+    offset?: number;
+    /** 结构化标题栏（可选，传入后覆盖简单内容模式） */
+    header?: PopupHeader;
+    /** 属性列表（可选，"标签-值"对齐模式） */
+    attributes?: PopupAttribute[];
+    /** 底部操作按钮（可选） */
+    actions?: PopupAction[];
+    /** 受控可见性：传入时由外部控制显隐；不传或 undefined 时组件内部管理 */
+    visible?: boolean;
+    /** 是否启用互斥模式（默认 false）。启用后同一时间仅显示一个 Popup */
+    singleton?: boolean;
+    overlayContainer?: HTMLElement | null;
+    onClose?: () => void;
+    className?: string;
+}
+
+export declare interface PopupSchema {
+    type: 'popup';
+    longitude: number;
+    latitude: number;
+    /** 弹窗内容，支持纯文本 / HTML 字符串 */
+    content: string;
+    closeButton?: boolean;
+    /** 尺寸变体 */
+    size?: 'compact' | 'standard' | 'detailed';
+    /** 弹出位置，默认 auto */
+    placement?: 'auto' | 'top' | 'bottom' | 'left' | 'right';
+    /** 弹出框偏移量（像素），默认 8 */
+    offset?: number;
+    /** 是否启用互斥模式 */
+    singleton?: boolean;
+}
+
+/**
+ * Popup 尺寸变体
+ * - compact:   宽度 240px，适用于简单文字标注
+ * - standard:  宽度 320px，适用于 POI 简介等通用场景
+ * - detailed:  宽度 480px，适用于统计图表或详细参数对比
+ */
+export declare type PopupSize = 'compact' | 'standard' | 'detailed';
+
+declare type PositionCallback_2 = (x: number, y: number) => void;
+
+/**
+ * 色带配置
+ */
+export declare interface RampColors {
+    /** 插值类型 */
+    type?: 'linear' | 'quantize' | 'custom';
+    /** 色值数组 */
+    colors: string[];
+    /** 对应位置（与 domain 对齐） */
+    positions?: number[];
+}
+
+/**
+ * 栅格图层组件
+ */
+export declare function RasterLayer({ source, sourceType, sourceConfig, onClick, ...rest }: RasterLayerProps): JSX_2.Element | null;
+
+export declare interface RasterLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
+    source: LayerSchema['source'];
+    sourceType?: LayerSchema['sourceType'];
+    sourceConfig?: LayerSchema['sourceConfig'];
+    onClick?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 渲染模式
+ * - raster: 单波段伪彩色（默认）
+ * - rgb: 多波段真彩色/假彩色合成
+ * - ndi: 归一化差异指数（如 NDVI、NDBI、NDWI）
+ */
+export declare type RasterRenderMode = 'raster' | 'rgb' | 'ndi';
+
+declare type ResolvedMapSchema = MapSchema & {
+    basemap: NonNullable<MapSchema['basemap']>;
+    center: NonNullable<MapSchema['center']>;
+    zoom: NonNullable<MapSchema['zoom']>;
+    pitch: NonNullable<MapSchema['pitch']>;
+    rotation: NonNullable<MapSchema['rotation']>;
+};
+
+declare interface ResponsiveContextValue {
+    isMobile: boolean;
+    breakpoint: number;
+    width: number;
+    schema: ResponsiveSchema | undefined;
+}
+
+export declare function ResponsiveProvider({ responsive, children }: ResponsiveProviderProps): JSX_2.Element;
+
+declare interface ResponsiveProviderProps {
+    responsive?: ResponsiveSchema;
+    children: default_2.ReactNode;
+}
+
+export declare interface ResponsiveSchema {
+    breakpoint?: number;
+    mobile?: MobileConfig;
+}
+
+/**
+ * 路径地图复合图层 (Route Map)
+ *
+ * 遵循设计规范：
+ * - 序列化途经点 (Numbered Stops)
+ * - 路径发光效果
+ * - 分段着色（路况/属性）
+ * - 流动动画
+ *
+ * @example
+ * ```tsx
+ * <RouteLayer
+ *   path={[[120.15, 30.28], [120.17, 30.25], ...]}
+ *   stops={[
+ *     { lng: 120.15, lat: 30.28, name: '西湖' },
+ *     { lng: 120.17, lat: 30.25, name: '灵隐寺' },
+ *   ]}
+ *   animate
+ *   glow
+ * />
+ * ```
+ */
+export declare function RouteLayer({ path, segments, stops, color, lineWidth, opacity, glow, animate, animateSpeed, stopSize, stopColor, endColor, showStopIndex, activeColor, onPathClick, onStopClick, }: RouteLayerProps): JSX_2.Element | null;
+
+export declare interface RouteLayerProps {
+    /** 路径坐标 — 完整线坐标或分段 */
+    path?: [number, number][];
+    /** 分段路径（优先级高于 path） */
+    segments?: RouteSegment[];
+    /** 途经点列表 */
+    stops?: RouteStop[];
+    /** 路径颜色，默认 '#2563eb' */
+    color?: string;
+    /** 路径宽度，默认 4 */
+    lineWidth?: number;
+    /** 路径透明度，默认 0.9 */
+    opacity?: number;
+    /** 是否显示发光效果，默认 true */
+    glow?: boolean;
+    /** 是否启用流动动画，默认 false */
+    animate?: boolean;
+    /** 动画速度，默认 1 */
+    animateSpeed?: number;
+    /** 途经点大小，默认 14 */
+    stopSize?: number;
+    /** 途经点颜色（默认跟随路径色） */
+    stopColor?: string;
+    /** 终点颜色，默认 '#10b981' */
+    endColor?: string;
+    /** 是否显示途经点序号，默认 true */
+    showStopIndex?: boolean;
+    /** hover 高亮色 */
+    activeColor?: string;
+    /** 路径点击 */
+    onPathClick?: (payload: LayerEventPayload) => void;
+    /** 途经点点击 */
+    onStopClick?: (payload: LayerEventPayload) => void;
+}
+
+/**
+ * 路径分段数据
+ */
+export declare interface RouteSegment {
+    /** 坐标序列 [[lng, lat], [lng, lat], ...] */
+    coordinates: [number, number][];
+    /** 分段颜色（如路况着色） */
+    color?: string;
+    /** 分段宽度 */
+    width?: number;
+}
+
+/**
+ * 途经点数据
+ */
+export declare interface RouteStop {
+    /** 经度 */
+    lng: number;
+    /** 纬度 */
+    lat: number;
+    /** 名称 */
+    name: string;
+    /** 序号（自动生成，也可手动指定） */
+    index?: number;
+    /** 类型：start / end / waypoint */
+    type?: 'start' | 'end' | 'waypoint';
+}
+
+/** 提供商显示名称 */
+export declare const SATELLITE_PROVIDER_NAMES: Record<SatelliteProvider, string>;
+
+/**
+ * 卫星影像图层 — 复合组件
+ *
+ * 支持高德、天地图、谷歌三种卫星影像切换，默认高德。
+ *
+ * ```tsx
+ * <AiMap map={{ basemap: 'map', center: [116.39, 39.9], zoom: 10 }}>
+ *   <SatelliteLayer provider="gaode" />
+ * </AiMap>
+ * ```
+ */
+export declare function SatelliteLayer({ provider, zIndex, opacity, tiandituToken, visible, }: SatelliteLayerProps): JSX_2.Element | null;
+
+/** 卫星影像图层配置 */
+export declare interface SatelliteLayerProps {
+    /** 影像提供商，默认 'gaode' */
+    provider?: SatelliteProvider;
+    /** 图层层级，默认 0（底层） */
+    zIndex?: number;
+    /** 图层透明度 0~1，默认 1 */
+    opacity?: number;
+    /** 天地图 token（仅 tianditu 需要，有内置默认值） */
+    tiandituToken?: string;
+    /** 图层可见性，默认 true */
+    visible?: boolean;
+}
+
+/** 卫星影像数据源类型 */
+export declare type SatelliteProvider = 'gaode' | 'tianditu' | 'google';
+
+export declare function ScaleControl({ position, maxWidth, metric, imperial, updateWhenIdle, className, style, }: ScaleControlProps): JSX_2.Element;
+
+/**
+ * Scale 比例尺控件
+ *
+ * 遵循 L7 的 Control 规范 + Material Design 3 玻璃态风格：
+ * - CSS 类名: .l7-control .l7-control-scale
+ * - 玻璃态: glass-effect + surface/90 背景
+ * - 位置默认: bottomleft
+ * - API: mapsService.containerToLngLat() + lnglatDistance() 算法
+ * - 事件: mapsService.on('mapmove') / mapsService.on('zoomchange')
+ */
+export declare interface ScaleControlProps {
+    /** 控件位置，默认 bottomleft */
+    position?: L7ControlPosition;
+    /** 比例尺最大像素宽度，默认 100 */
+    maxWidth?: number;
+    /** 是否显示公制单位，默认 true */
+    metric?: boolean;
+    /** 是否显示英制单位，默认 false */
+    imperial?: boolean;
+    /** 是否在地图移动结束后才更新，默认 false（实时更新） */
+    updateWhenIdle?: boolean;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+export declare function SceneProvider({ scene, children }: SceneProviderProps): JSX_2.Element;
+
+declare interface SceneProviderProps {
+    scene: Scene | null;
+    children: default_2.ReactNode;
+}
+
+/**
+ * Schema diff 结果
+ */
+export declare interface SchemaDiffResult {
+    mapChanged: boolean;
+    layersAdded: LayerSchema[];
+    layersRemoved: string[];
+    layersUpdated: {
+        id: string;
+        prev: LayerSchema;
+        next: LayerSchema;
+    }[];
+    controlsAdded: ControlSchema[];
+    controlsRemoved: ControlSchema[];
+    controlsUpdated: {
+        index: number;
+        prev: ControlSchema;
+        next: ControlSchema;
+    }[];
+    interactionsChanged: boolean;
+    legendsChanged: boolean;
+}
+
+export declare function SchemaProvider({ schema, children }: SchemaProviderProps): JSX_2.Element;
+
+declare interface SchemaProviderProps {
+    schema: AiMapSchema;
+    children: default_2.ReactNode;
+}
+
+export declare interface ScreenPosition {
+    x: number;
+    y: number;
+}
+
+/**
+ * 移动端浮动搜索框组件
+ *
+ * Material Design 3 毛玻璃风格，固定在顶部
+ *
+ * ```tsx
+ * <SearchBar placeholder="搜索地点..." onSearch={(v) => console.log(v)} />
+ * ```
+ */
+export declare function SearchBar({ placeholder, onSearch, onFilter, className, trailing, }: SearchBarProps): JSX_2.Element;
+
+export declare interface SearchBarProps {
+    /** 占位文本 */
+    placeholder?: string;
+    /** 搜索值变化回调 */
+    onSearch?: (value: string) => void;
+    /** 筛选按钮点击回调 */
+    onFilter?: () => void;
+    /** 自定义样式类名 */
+    className?: string;
+    /** 右侧自定义操作区域 */
+    trailing?: default_2.ReactNode;
+}
+
+export declare type SelectConfig = boolean | {
+    color: string;
+};
+
+declare interface ShapeConfig {
+    field?: string;
+    values?: string[] | string;
+}
+
+declare interface SizeConfig {
+    field?: string;
+    values?: number[] | number;
+}
+
+export declare interface SourceConfig {
+    x?: string;
+    y?: string;
+    x1?: string;
+    y1?: string;
+    coordinates?: string;
+    parser?: Record<string, unknown>;
+    transforms?: Array<Record<string, unknown>>;
+}
+
+declare interface SourceOutput {
+    data: unknown;
+    options?: Record<string, unknown>;
+}
+
+export declare type SourceType = 'geojson' | 'json' | 'csv' | 'raster' | 'rasterTile' | 'image';
+
+declare interface ThemeContextValue {
+    /** 当前解析后的实际主题（light 或 dark） */
+    resolvedTheme: 'light' | 'dark';
+    /** 用户设置的主题偏好 */
+    theme: MapTheme;
+    /** 设置主题 */
+    setTheme: (theme: MapTheme) => void;
+    /** 切换亮/暗 */
+    toggleTheme: () => void;
+}
+
+/**
+ * 地图主题选项 — 支持预览色块
+ */
+export declare interface ThemeOption {
+    /** 主题显示名称 */
+    text: string;
+    /** 主题值（传给 mapsService.setMapStyle） */
+    value: string;
+    /** 主题预览色块，支持 CSS 渐变 */
+    preview?: string;
+}
+
+/**
+ * 地图主题 Provider
+ *
+ * 通过 CSS 变量 + data-theme 属性实现亮/暗主题切换。
+ * - `light`: 亮色主题（默认）
+ * - `dark`: 暗色主题
+ * - `system`: 跟随系统 prefers-color-scheme
+ */
+export declare function ThemeProvider({ defaultTheme, target, children, }: ThemeProviderProps): JSX_2.Element;
+
+export declare interface ThemeProviderProps {
+    /** 默认主题，默认 'light' */
+    defaultTheme?: MapTheme;
+    /** 挂载 data-theme 属性的目标元素选择器，默认挂载到最近的 .aimapui-container 或 :root */
+    target?: 'root' | 'container';
+    children: default_2.ReactNode;
+}
+
+/**
+ * GeoTIFF 栅格复合图层
+ *
+ * 内置 GeoTIFF 解析能力，支持两种渲染模式：
+ * - raster: 单波段伪彩色映射（NDVI、DEM、夜光等）
+ * - rgb: 多波段真彩色/假彩色合成（卫星影像）
+ *
+ * 遵循设计规范：
+ * - 伪彩色映射（自定义色带）
+ * - 多波段 RGB 合成
+ * - WebGL 加速渲染
+ * - NoData 透明化
+ * - 可选地理遮罩
+ *
+ * @example 单波段伪彩色
+ * ```tsx
+ * <TiffRasterLayer
+ *   url="https://example.com/ndvi.tif"
+ *   renderMode="raster"
+ *   domain={[0, 0.8]}
+ *   rampColors={{ colors: ['#78350f', '#059669'], positions: [0, 0.8] }}
+ * />
+ * ```
+ *
+ * @example 多波段 RGB 合成
+ * ```tsx
+ * <TiffRasterLayer
+ *   url="https://example.com/china.tif"
+ *   renderMode="rgb"
+ *   bands={[0, 1, 2]}
+ *   mask
+ *   maskData="https://example.com/china-boundary.json"
+ * />
+ * ```
+ */
+export declare function TiffRasterLayer({ url, extent, renderMode, bandIndex, domain, noDataValue, rampColors, clampLow, clampHigh, bands, countCut, rMinMax, gMinMax, bMinMax, opacity, mask, maskData, }: TiffRasterLayerProps): null;
+
+export declare interface TiffRasterLayerProps {
+    /** TIFF 文件 URL */
+    url: string;
+    /** 地理范围 [minLng, minLat, maxLng, maxLat] */
+    extent?: [number, number, number, number];
+    /** 渲染模式，默认 'raster'（单波段伪彩色） */
+    renderMode?: RasterRenderMode;
+    /** 波段索引，默认 0 */
+    bandIndex?: number;
+    /** 数据值域 [min, max]，用于色带映射 */
+    domain?: [number, number];
+    /** 无数据值，默认 0 */
+    noDataValue?: number;
+    /** 色带配置 */
+    rampColors?: RampColors;
+    /** 低值截断，默认 false */
+    clampLow?: boolean;
+    /** 高值截断，默认 false */
+    clampHigh?: boolean;
+    /** RGB 波段索引 [R, G, B]，默认 [0, 1, 2] */
+    bands?: [number, number] | [number, number, number];
+    /** RGB 模式：百分位裁剪 [low, high]，默认 [2, 98]。设为 [0, 100] 可跳过裁剪 */
+    countCut?: [number, number];
+    /** RGB 模式：R 通道值域 [min, max]，传入后跳过 percentile 计算（避免大数据栈溢出） */
+    rMinMax?: [number, number];
+    /** RGB 模式：G 通道值域 [min, max] */
+    gMinMax?: [number, number];
+    /** RGB 模式：B 通道值域 [min, max] */
+    bMinMax?: [number, number];
+    /** 不透明度，默认 0.8 */
+    opacity?: number;
+    /** 遮罩 GeoJSON URL 或对象 */
+    maskData?: string | Record<string, unknown>;
+    /** 是否启用遮罩，默认 false */
+    mask?: boolean;
+}
+
+export declare function Tooltip({ content, variant, longitude, latitude, targetElement, placement, offset, trigger, visible: visibleProp, title, items, overlayContainer, className, }: TooltipProps): default_2.ReactPortal | null;
+
+/**
+ * Tooltip 键值对数据项
+ */
+export declare interface TooltipItem {
+    /** 标签 */
+    label: string;
+    /** 值 */
+    value: string | number;
+}
+
+/** Tooltip 方向 */
+export declare type TooltipPlacement = 'top' | 'right' | 'bottom' | 'left';
+
+export declare interface TooltipProps {
+    /** 内容：纯文本 / ReactNode。优先级高于 title/items */
+    content?: string | default_2.ReactNode;
+    /** 视觉变体，默认 dark */
+    variant?: TooltipVariant;
+    /** 经度（地图定位模式） */
+    longitude?: number;
+    /** 纬度（地图定位模式） */
+    latitude?: number;
+    /** 目标 DOM 元素 */
+    targetElement?: HTMLElement | null;
+    /** 方向，默认 top */
+    placement?: TooltipPlacement;
+    /** 偏移距离，默认 8px */
+    offset?: number;
+    /** 触发方式，默认 hover */
+    trigger?: 'hover' | 'click';
+    /** 受控可见性 */
+    visible?: boolean;
+    /** 结构化标题 */
+    title?: string;
+    /** 结构化键值对列表 */
+    items?: TooltipItem[];
+    /** Overlay 容器 */
+    overlayContainer?: HTMLElement | null;
+    /** 自定义类名 */
+    className?: string;
+}
+
+export declare interface TooltipSchema {
+    type: 'tooltip';
+    content: string;
+    trigger?: 'hover' | 'click';
+    /** 视觉变体 */
+    variant?: 'dark' | 'glass' | 'light';
+    /** 经度（地图定位模式） */
+    longitude?: number;
+    /** 纬度（地图定位模式） */
+    latitude?: number;
+    /** 方向 */
+    placement?: 'top' | 'right' | 'bottom' | 'left';
+    /** 偏移距离 */
+    offset?: number;
+}
+
+/**
+ * Tooltip 视觉变体
+ * - dark:  深色高对比度（默认），适用于卫星图/亮色底图
+ * - glass: 玻璃拟态毛玻璃，适用于简洁数据地图
+ * - light: 浅色背景，适用于深色底图
+ */
+export declare type TooltipVariant = 'dark' | 'glass' | 'light';
+
+export declare function useControlContainer(): boolean;
+
+export declare function useEventBus(): EventBus;
+
+/**
+ * Hook: 提供 mapsService 访问 + 控件位置计算
+ *
+ * 遵循 L7 的 Control 规范：
+ * - 通过 mapsService 获取地图服务实例
+ * - 通过 scene 获取场景实例
+ * - 提供 position → 定位 CSS 类名的映射
+ */
+export declare function useMapControl(position?: L7ControlPosition): {
+    scene: Scene | null;
+    mapsService: any;
+    getMapContainer: () => any;
+    positionClassName: string;
+};
+
+/**
+ * 高性能地图位置同步 Hook
+ *
+ * 参考 L7 Marker/Popup 的直接 DOM 操作方式：
+ * - 不使用 setState 避免渲染延迟
+ * - 通过回调函数直接更新 DOM style
+ * - 使用 mapsService 事件监听地图变化
+ * - RAF 节流合并高频更新
+ *
+ * 用法：
+ * ```tsx
+ * const ref = useRef<HTMLDivElement>(null);
+ * useMapPosition(scene, lng, lat, (x, y) => {
+ *   if (ref.current) {
+ *     ref.current.style.left = x + 'px';
+ *     ref.current.style.top = y + 'px';
+ *   }
+ * });
+ * ```
+ */
+export declare function useMapPosition(scene: Scene | null, longitude: number, latitude: number, onPositionUpdate: PositionCallback_2): void;
+
+export declare function useResponsive(): ResponsiveContextValue;
+
+export declare function useScene(): Scene | null;
+
+export declare function useSchema(): AiMapSchema | null;
+
+/**
+ * 获取当前主题信息
+ */
+export declare function useTheme(): ThemeContextValue;
+
+export declare function validateAiMapSchema(schema: AiMapSchema): ValidationError[];
+
+/**
+ * 验证整个 Schema
+ */
+export declare function validateSchema(schema: AiMapSchema): {
+    valid: boolean;
+    errors: string[];
+};
+
+/**
+ * Schema 校验器
+ * 提供友好的错误消息，帮助 AI 修正 Schema
+ */
+export declare interface ValidationError {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+
+declare interface VisualConfig {
+    color?: ColorConfig;
+    size?: SizeConfig;
+    shape?: ShapeConfig;
+    style?: Record<string, unknown>;
+}
+
+export declare function ZoomControl({ position, zoomInText, zoomInTitle, zoomOutText, zoomOutTitle, showZoom, className, style, }: ZoomControlProps): JSX_2.Element;
+
+/**
+ * Zoom 控件
+ *
+ * 遵循 L7 的 Control 规范 + Material Design 3 玻璃态风格：
+ * - CSS 类名: .l7-control .l7-control-zoom
+ * - 按钮: .l7-button-control
+ * - 玻璃态: glass-effect + surface/90 背景
+ * - 位置默认: bottomright
+ * - API: mapsService.zoomIn() / zoomOut() / getZoom() / getMinZoom() / getMaxZoom()
+ * - 事件: mapsService.on('zoomend', 'zoomchange')
+ */
+export declare interface ZoomControlProps {
+    /** 控件位置，默认 bottomright */
+    position?: L7ControlPosition;
+    /** 缩放按钮图标/文本，默认使用 Material Symbols Outlined */
+    zoomInText?: default_2.ReactNode;
+    zoomInTitle?: string;
+    zoomOutText?: default_2.ReactNode;
+    zoomOutTitle?: string;
+    /** 是否显示当前缩放级别数字 */
+    showZoom?: boolean;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+export { }