@antv/aimapui 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { BaiduMap } from '@antv/l7-maps';
 import { Component } from 'react';
 import { default as default_2 } from 'react';
 import { default as default_3 } from 'node_modules/@antv/l7-maps/es/amap-next';
+import { Feature } from 'geojson';
 import { GoogleMap } from '@antv/l7-maps';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { Map as Map_2 } from '@antv/l7-maps';
@@ -885,7 +886,7 @@ export declare interface ArcFlowDataItem {
  * />
  * ```
  */
-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 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, showTooltip, showNodePopup, activeColor, onArcHover, onArcClick, onNodeClick, style: extraStyle, }: ArcFlowLayerProps): JSX_2.Element;
 
 export declare interface ArcFlowLayerProps {
     /** OD 数据源 — JSON 数组 */
@@ -939,6 +940,10 @@ export declare interface ArcFlowLayerProps {
     nodeSizeRange?: [number, number];
     /** 是否显示节点呼吸脉冲动画，默认 false */
     nodePulse?: boolean;
+    /** 是否在 hover 弧线时显示 Tooltip，默认 true */
+    showTooltip?: boolean;
+    /** 是否在点击节点时显示 Popup，默认 true */
+    showNodePopup?: boolean;
     /** hover 高亮色 */
     activeColor?: string;
     /** 弧线 hover 事件 */
@@ -1059,12 +1064,6 @@ export declare interface BubbleLayerProps extends Omit<LayerSchema, 'type' | 'so
     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;
@@ -1073,6 +1072,15 @@ export declare interface BusinessDataItem {
     [key: string]: unknown;
 }
 
+/** 配准阶段 */
+export declare type CalibrationPhase = 'idle' | 'calibrating' | 'confirmed';
+
+/** 配准结果 */
+export declare interface CalibrationResult {
+    corners: GeoCorners;
+    extent: [number, number, number, number];
+}
+
 /**
  * 中国行政区划图层（ChinaDistrict）
  *
@@ -1248,7 +1256,7 @@ export declare interface ControlSchema {
     options?: Record<string, unknown>;
 }
 
-export declare type ControlType = 'zoom' | 'scale' | 'fullscreen' | 'geoLocate' | 'mapTheme' | 'mouseLocation' | 'exportImage' | 'layerSwitch';
+export declare type ControlType = 'zoom' | 'scale' | 'fullscreen' | 'geoLocate' | 'mapTheme' | 'mouseLocation' | 'exportImage' | 'layerSwitch' | 'draw' | 'imageCalibration';
 
 /**
  * 底图工厂 — 根据配置创建 L7 Map 实例
@@ -1327,6 +1335,156 @@ export declare const DEFAULT_PROVINCE_SOURCE = "https://mdn.alipayobjects.com/an
  */
 export declare function diffSchema(prev: AiMapSchema, next: AiMapSchema): SchemaDiffResult;
 
+/** 基础绘制模式（产生要素的模式） */
+declare type DrawBasicMode = 'point' | 'polyline' | 'polygon' | 'rectangle' | 'circle';
+
+export declare const DrawControl: default_2.ForwardRefExoticComponent<DrawControlProps & default_2.RefAttributes<DrawControlHandle>>;
+
+export declare interface DrawControlHandle {
+    setMode: (mode: DrawMode) => void;
+    addFeatures: (features: DrawFeature[]) => void;
+    deleteFeature: (id: string) => void;
+    clearAll: () => void;
+    getFeatures: () => DrawFeature[];
+    selectFeature: (id: string | null) => void;
+}
+
+/** DrawControl 组件 Props */
+export declare interface DrawControlProps {
+    /** 控件位置，默认 topright */
+    position?: L7ControlPosition;
+    /** 初始要素（非受控模式） */
+    defaultFeatures?: DrawFeature[];
+    /** 受控要素 */
+    features?: DrawFeature[];
+    /** 工具栏显示的模式，默认全部显示 */
+    modes?: DrawToolMode[];
+    /** 是否显示删除/清除按钮，默认 true */
+    showDelete?: boolean;
+    /** 自定义样式配置 */
+    styles?: DrawStyleConfig;
+    /** 吸附配置 */
+    snap?: DrawSnapConfig | boolean;
+    className?: string;
+    style?: React.CSSProperties;
+    /** 创建要素回调 */
+    onDrawCreate?: (features: DrawFeature[]) => void;
+    /** 更新要素回调（移动/编辑顶点） */
+    onDrawUpdate?: (feature: DrawFeature) => void;
+    /** 删除要素回调 */
+    onDrawDelete?: (feature: DrawFeature) => void;
+    /** 选中/取消选中要素回调 */
+    onDrawSelect?: (feature: DrawFeature | null) => void;
+    /** 模式切换回调 */
+    onModeChange?: (mode: DrawMode) => void;
+    /** 要素集合变化回调 */
+    onChange?: (features: DrawFeature[]) => void;
+}
+
+/** 绘制中的临时图形（rubber-band）样式 */
+declare interface DrawDrawingStyle {
+    fill?: string;
+    fillOpacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
+    /** 虚线（橡皮筋引导线）颜色 */
+    dashStroke?: string;
+    /** 虚线宽度 */
+    dashWidth?: number;
+    /** 虚线 dash-array 模式 */
+    dashArray?: [number, number];
+}
+
+/** 绘制要素（扩展 GeoJSON Feature，携带 id 和 drawType） */
+export declare interface DrawFeature extends Feature {
+    id: string;
+    properties: {
+        /** 创建该要素的绘制模式 */
+        drawType: DrawGeometryMode;
+        [key: string]: unknown;
+    };
+}
+
+/** 绘制模式对应的绘制类型（仅产生要素的模式） */
+declare type DrawGeometryMode = DrawBasicMode;
+
+/** 线要素样式 */
+declare interface DrawLineStyle {
+    color?: string;
+    size?: number;
+    opacity?: number;
+}
+
+/** 绘制模式 */
+export declare type DrawMode = 'point' | 'polyline' | 'polygon' | 'rectangle' | 'circle' | 'edit' | 'split' | 'merge' | 'none';
+
+/** 点要素样式 */
+declare interface DrawPointStyle {
+    color?: string;
+    size?: number;
+    strokeColor?: string;
+    strokeWidth?: number;
+}
+
+/** 面要素样式 */
+declare interface DrawPolygonStyle {
+    fill?: string;
+    fillOpacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
+}
+
+/** 选中要素高亮样式 */
+declare interface DrawSelectedStyle {
+    stroke?: string;
+    strokeWidth?: number;
+    fill?: string;
+    fillOpacity?: number;
+    /** 选中边框虚线模式（编辑态） */
+    dashArray?: [number, number];
+}
+
+/** 吸附配置 */
+export declare interface DrawSnapConfig {
+    /** 是否启用吸附，默认 true */
+    enabled?: boolean;
+    /** 吸附像素阈值，默认 8px */
+    threshold?: number;
+    /** 是否启用顶点吸附，默认 true */
+    vertex?: boolean;
+    /** 是否启用边吸附，默认 true */
+    edge?: boolean;
+}
+
+/** 绘制控件完整样式配置 */
+export declare interface DrawStyleConfig {
+    point?: DrawPointStyle;
+    line?: DrawLineStyle;
+    polygon?: DrawPolygonStyle;
+    drawing?: DrawDrawingStyle;
+    selected?: DrawSelectedStyle;
+    vertex?: DrawVertexStyle;
+}
+
+/** 工具栏显示的绘制模式（不含 none） */
+export declare type DrawToolMode = Exclude<DrawMode, 'none'>;
+
+/** 编辑模式顶点句柄样式 */
+declare interface DrawVertexStyle {
+    /** 固定点填充色（白色） */
+    color?: string;
+    /** 固定点半径 */
+    size?: number;
+    /** 固定点描边色 */
+    strokeColor?: string;
+    /** 固定点描边宽度 */
+    strokeWidth?: number;
+    /** 活动点（选中/拖拽）颜色 */
+    activeColor?: string;
+    /** 活动点半径 */
+    activeSize?: number;
+}
+
 /** 下钻路径节点 */
 export declare interface DrillPathNode {
     level: AdministrativeLevel;
@@ -1408,6 +1566,22 @@ export declare interface EventSchema {
     markerDragEnd?: EventIdentifier;
 }
 
+/** 导出配置 */
+export declare interface ExportConfig {
+    /** 输出图片总宽度(px)，默认原图宽度 */
+    outputWidth?: number;
+    /** 输出图片总高度(px)，默认原图高度 */
+    outputHeight?: number;
+    /** 切片列数，默认 1（不切分） */
+    cols?: number;
+    /** 切片行数，默认 1（不切分） */
+    rows?: number;
+    /** 图片格式 */
+    format?: string;
+    /** 图片质量 0-1 */
+    quality?: number;
+}
+
 export declare function ExportImageControl({ position, format, onExport, className, style, }: ExportImageControlProps): JSX_2.Element;
 
 /**
@@ -1430,12 +1604,34 @@ export declare interface ExportImageControlProps {
     onExport?: (base64: string) => void;
 }
 
+/** 导出选项（向后兼容） */
+export declare interface ExportOptions {
+    maxWidth?: number;
+    format?: string;
+    quality?: number;
+}
+
+/** 导出结果 */
+export declare interface ExportResult {
+    /** 切片列表 */
+    tiles: TileResult[];
+    /** 完整图片的总 extent */
+    extent: [number, number, number, number];
+    /** 完整图片的预览 URL */
+    previewUrl: string;
+    /** 完整图片 Blob */
+    blob: Blob;
+    /** 输出尺寸 */
+    outputWidth: number;
+    outputHeight: number;
+}
+
 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 function FillLayer({ source, sourceType, colorMapping, showStroke, strokeColor, strokeWidth, hoverEffect, clickEffect, stickySelection, tooltipEffect, tooltipFields, tooltipTemplate, regionIdField, highlightStrokeColor, highlightStrokeWidth, zoomToRegionOnClick, clickZoomPadding, clickZoomDelta, onRegionClick, onDrilldown, onLayerCreated, 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'];
@@ -1458,6 +1654,7 @@ export declare interface FillLayerProps extends Omit<LayerSchema, 'type' | 'sour
     clickZoomDelta?: number;
     onRegionClick?: (payload: LayerEventPayload) => void;
     onDrilldown?: (feature: Record<string, unknown>) => void;
+    onLayerCreated?: (layer: any) => void;
     showLabel?: boolean;
     labelField?: string;
     labelColor?: string;
@@ -1496,6 +1693,26 @@ export declare interface FullscreenControlProps {
  */
 export declare const GAODE_THEME_PRESETS: ThemeOption[];
 
+/** 4个角点地理坐标 [topLeft, topRight, bottomRight, bottomLeft]，每项 [lng, lat] */
+export declare type GeoCorners = [
+[
+number,
+number
+],
+[
+number,
+number
+],
+[
+number,
+number
+],
+[
+number,
+number
+]
+];
+
 export declare function GeoLocateControl({ position, transform, className, style, }: GeoLocateControlProps): JSX_2.Element;
 
 /**
@@ -1528,8 +1745,7 @@ export declare interface GestureConfig {
  *
  * 支持 Material Symbols Outlined 及自定义 iconfont 字体：
  * - Material Symbols: 页面已加载 Google 字体，组件自动注册映射表，开箱即用
- * - 内置 iconfont: at.alicdn.com 天气字体，内置 5 个图标
- * - 自定义: 传入 iconFontFamily + iconFontPath + iconFontMap
+ * - 自定义: 传入 iconFontFamily + iconFontPath + iconFontMap（通过 scene.addFontFace / addIconFonts 注册）
  *
  * 特性：
  * - SDF 渲染确保任意缩放下边缘锐利
@@ -1549,13 +1765,13 @@ export declare interface GlyphLayerProps extends Omit<LayerSchema, 'type' | 'sou
     /**
      * 字体族模式
      * - 'material-symbols'（默认）：使用 Material Symbols Outlined 字体，图标名需使用官方名称（如 sunny / flight / restaurant）
-     * - 'iconfont'：使用 at.alicdn.com 内置 iconfont 字体，图标名需使用 BUILTIN_ICON_FONTS 中的名称
      * - 自定义字符串：自行通过 scene.addFontFace / addIconFonts 注册的字体族名
+     * @deprecated 不再使用 'iconfont' 值指向 alicdn 天气字体，请使用 Material Symbols 中的天气图标或自定义字体
      */
     iconFontFamily?: string;
     /**
      * 自定义字体文件 URL，仅在 iconFontFamily 为自定义字符串时需要
-     * Material Symbols 自动从页面已加载的字体中获取；iconfont 使用内置 URL
+     * Material Symbols 自动从页面已加载的字体中获取
      */
     iconFontPath?: string;
     /**
@@ -1628,7 +1844,7 @@ export declare interface GlyphLayerProps extends Omit<LayerSchema, 'type' | 'sou
  *
  * 支持悬停高亮交互（对齐蜂窝热力图设计规范）
  */
-export declare function HeatmapLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: HeatmapLayerProps): JSX_2.Element | null;
+export declare function HeatmapLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, onLayerCreated, ...rest }: HeatmapLayerProps): JSX_2.Element | null;
 
 export declare interface HeatmapLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     source: LayerSchema['source'];
@@ -1642,6 +1858,8 @@ export declare interface HeatmapLayerProps extends Omit<LayerSchema, 'type' | 's
     onMouseEnter?: (payload: LayerEventPayload) => void;
     /** 鼠标离开事件 */
     onMouseLeave?: (payload: LayerEventPayload) => void;
+    /** L7 图层实例创建回调 */
+    onLayerCreated?: (layer: any) => void;
 }
 
 /**
@@ -1731,6 +1949,50 @@ export declare interface IconLayerProps extends Omit<LayerSchema, 'type' | 'sour
     onMouseLeave?: (payload: LayerEventPayload) => void;
 }
 
+export declare const ImageCalibrationControl: default_2.ForwardRefExoticComponent<ImageCalibrationControlProps & default_2.RefAttributes<ImageCalibrationHandle>>;
+
+/** ImageCalibrationControl 组件 Props */
+export declare interface ImageCalibrationControlProps {
+    /** 控件位置 */
+    position?: L7ControlPosition;
+    /** 受控模式：外部传入角点 */
+    corners?: GeoCorners;
+    /** 非受控模式：初始角点 */
+    defaultCorners?: GeoCorners;
+    /** 图片来源 (URL/base64/File) */
+    imageSource?: ImageSource;
+    /** 覆盖层透明度 0-1，默认 0.7 */
+    opacity?: number;
+    /** 接受的文件类型，默认 'image/*' */
+    accept?: string;
+    /** 额外 className */
+    className?: string;
+    /** 额外 style */
+    style?: React.CSSProperties;
+    /** 角点变化回调 */
+    onCornersChange?: (corners: GeoCorners) => void;
+    /** 确认配准回调 */
+    onCalibrate?: (result: CalibrationResult) => void;
+    /** 导出完成回调 */
+    onExport?: (result: ExportResult) => void;
+    /** 图片加载完成回调 */
+    onImageLoad?: (dimensions: {
+        width: number;
+        height: number;
+    }) => void;
+    /** 清除回调 */
+    onClear?: () => void;
+}
+
+/** 命令式 Handle */
+export declare interface ImageCalibrationHandle {
+    getCorners(): GeoCorners | null;
+    setCorners(corners: GeoCorners): void;
+    setImage(source: ImageSource): void;
+    exportImage(config?: ExportConfig): Promise<ExportResult>;
+    clear(): void;
+}
+
 /**
  * 图片图层组件
  */
@@ -1743,6 +2005,9 @@ export declare interface ImageLayerProps extends Omit<LayerSchema, 'type' | 'sou
     onClick?: (payload: LayerEventPayload) => void;
 }
 
+/** 图片来源 */
+declare type ImageSource = string | File;
+
 /**
  * 独立 Map (L7 内置) 主题预设
  */
@@ -1925,6 +2190,15 @@ export declare interface LegendCategoriesSchema {
     grid?: boolean;
 }
 
+export declare function LegendControl({ position, className, style, children, }: LegendControlProps): JSX_2.Element | null;
+
+export declare interface LegendControlProps {
+    position?: L7ControlPosition;
+    className?: string;
+    style?: default_2.CSSProperties;
+    children?: default_2.ReactNode;
+}
+
 /**
  * 发散图例 — 双极渐变色条
  *
@@ -2188,7 +2462,7 @@ export declare interface LegendThresholdSchema {
  * </AiMap>
  * ```
  */
-export declare function LineLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: LineLayerProps): JSX_2.Element | null;
+export declare function LineLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, onLayerCreated, ...rest }: LineLayerProps): JSX_2.Element | null;
 
 export declare interface LineLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     source: LayerSchema['source'];
@@ -2198,6 +2472,39 @@ export declare interface LineLayerProps extends Omit<LayerSchema, 'type' | 'sour
     onMouseMove?: (payload: LayerEventPayload) => void;
     onMouseEnter?: (payload: LayerEventPayload) => void;
     onMouseLeave?: (payload: LayerEventPayload) => void;
+    onLayerCreated?: (layer: any) => void;
+}
+
+export declare function LogoControl({ logos, position, className, style, }: LogoControlProps): JSX_2.Element;
+
+export declare interface LogoControlProps {
+    /** Logo 列表，支持多张 */
+    logos: LogoItem[];
+    /** 控件位置，默认 bottomleft */
+    position?: L7ControlPosition;
+    /** 额外 className */
+    className?: string;
+    /** 额外 style */
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * Logo 控件 — 在地图角落展示品牌/项目 Logo
+ *
+ * 支持传入单张或多张 Logo 图片，水平排列：
+ * - logos: Logo 配置数组，每项包含 src（图片地址）和可选的 alt、href、width
+ * - position: 控件位置，默认 bottomleft
+ * - 玻璃态风格，与 ZoomControl / ScaleControl 等视觉一致
+ */
+export declare interface LogoItem {
+    /** 图片地址 */
+    src: string;
+    /** 图片 alt 文本 */
+    alt?: string;
+    /** 点击跳转链接 */
+    href?: string;
+    /** 图片宽度（px），默认 24 */
+    width?: number;
 }
 
 export declare const MAKI_ICON_NAMES: string[];
@@ -2495,7 +2802,7 @@ export declare function parseSchema(schema: AiMapSchema): AiMapSchema;
  * </AiMap>
  * ```
  */
-export declare function PointLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: PointLayerProps): JSX_2.Element | null;
+export declare function PointLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, onLayerCreated, ...rest }: PointLayerProps): JSX_2.Element | null;
 
 export declare interface PointLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     /** 数据源 — JSON 数组、GeoJSON 或 URL */
@@ -2512,12 +2819,14 @@ export declare interface PointLayerProps extends Omit<LayerSchema, 'type' | 'sou
     onMouseEnter?: (payload: LayerEventPayload) => void;
     /** 鼠标离开事件 */
     onMouseLeave?: (payload: LayerEventPayload) => void;
+    /** L7 图层实例创建回调 */
+    onLayerCreated?: (layer: any) => void;
 }
 
 /**
  * 面图层组件
  */
-export declare function PolygonLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: PolygonLayerProps): JSX_2.Element | null;
+export declare function PolygonLayer({ source, sourceType, sourceConfig, onClick, onMouseMove, onMouseEnter, onMouseLeave, onLayerCreated, ...rest }: PolygonLayerProps): JSX_2.Element | null;
 
 export declare interface PolygonLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     source: LayerSchema['source'];
@@ -2527,6 +2836,7 @@ export declare interface PolygonLayerProps extends Omit<LayerSchema, 'type' | 's
     onMouseMove?: (payload: LayerEventPayload) => void;
     onMouseEnter?: (payload: LayerEventPayload) => void;
     onMouseLeave?: (payload: LayerEventPayload) => void;
+    onLayerCreated?: (layer: any) => 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;
@@ -2715,7 +3025,7 @@ export declare interface ResponsiveSchema {
  * />
  * ```
  */
-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 function RouteLayer({ path, segments, stops, routeType, onRouteQuery, onRouteResult, color, lineWidth, opacity, glow, animate, animateSpeed, stopSize, stopColor, endColor, showStopIndex, stopRenderer, stopMarkerVariant, stopIconMap, stopIconField, stopIconSize, stopIconAnchor, showStopPopup, activeColor, onPathClick, onStopClick, }: RouteLayerProps): JSX_2.Element | null;
 
 export declare interface RouteLayerProps {
     /** 路径坐标 — 完整线坐标或分段 */
@@ -2724,6 +3034,12 @@ export declare interface RouteLayerProps {
     segments?: RouteSegment[];
     /** 途经点列表 */
     stops?: RouteStop[];
+    /** 路径类型，默认 'straight' */
+    routeType?: RouteType;
+    /** 路线查询回调 — routeType 为 walking/cycling/driving/transit 时使用 */
+    onRouteQuery?: (params: RouteQueryParams) => Promise<RouteQueryResult>;
+    /** 路线查询完成回调 */
+    onRouteResult?: (result: RouteQueryResult) => void;
     /** 路径颜色，默认 '#2563eb' */
     color?: string;
     /** 路径宽度，默认 4 */
@@ -2744,6 +3060,20 @@ export declare interface RouteLayerProps {
     endColor?: string;
     /** 是否显示途经点序号，默认 true */
     showStopIndex?: boolean;
+    /** 停留点渲染模式，默认 'point' */
+    stopRenderer?: 'point' | 'marker' | 'icon';
+    /** marker 模式下的默认变体，默认 'circle' */
+    stopMarkerVariant?: MarkerVariant;
+    /** icon 模式下的图标资源映射；不传时会基于 stop.icon 自动生成 Maki pin 图标 */
+    stopIconMap?: Record<string, string>;
+    /** icon 模式下的图标字段名，默认 'iconValue' */
+    stopIconField?: string;
+    /** icon 模式下的图标尺寸，默认 16 */
+    stopIconSize?: number;
+    /** icon 模式下的图标锚点，默认 'bottom' */
+    stopIconAnchor?: IconAnchor;
+    /** 是否在点击途经点时显示 Popup，默认 true */
+    showStopPopup?: boolean;
     /** hover 高亮色 */
     activeColor?: string;
     /** 路径点击 */
@@ -2752,6 +3082,30 @@ export declare interface RouteLayerProps {
     onStopClick?: (payload: LayerEventPayload) => void;
 }
 
+/** 交通路线查询参数 */
+export declare interface RouteQueryParams {
+    origin: [number, number];
+    destination: [number, number];
+    waypoints?: [number, number][];
+    routeType: 'walking' | 'cycling' | 'driving' | 'transit';
+}
+
+/** 交通路线查询结果 */
+export declare interface RouteQueryResult {
+    /** 完整路径坐标 */
+    path: [number, number][];
+    /** 分段路径（可选，如返回多段路况着色路径） */
+    segments?: RouteSegment[];
+    /** 途中补充站点（可选，如公交换乘站） */
+    stops?: RouteStop[];
+    /** 路线信息 */
+    info?: {
+        distance?: number;
+        duration?: number;
+        description?: string;
+    };
+}
+
 /**
  * 路径分段数据
  */
@@ -2778,8 +3132,17 @@ export declare interface RouteStop {
     index?: number;
     /** 类型：start / end / waypoint */
     type?: 'start' | 'end' | 'waypoint';
+    /** 停留点图标名，供 stopRenderer='icon' 或 marker icon 变体使用 */
+    icon?: string;
+    /** marker 模式下的自定义变体 */
+    markerVariant?: MarkerVariant;
+    /** marker 模式下的语义颜色 */
+    markerColor?: MarkerColor;
 }
 
+/** 路径类型 */
+export declare type RouteType = 'straight' | 'arc' | 'walking' | 'cycling' | 'driving' | 'transit';
+
 /** 提供商显示名称 */
 export declare const SATELLITE_PROVIDER_NAMES: Record<SatelliteProvider, string>;
 
@@ -3052,6 +3415,24 @@ export declare interface TiffRasterLayerProps {
     mask?: boolean;
 }
 
+/** 单个切片结果 */
+export declare interface TileResult {
+    blob: Blob;
+    previewUrl: string;
+    /** 切片在网格中的行位置（从0开始） */
+    row: number;
+    /** 切片在网格中的列位置（从0开始） */
+    col: number;
+    /** 该切片对应的地理范围 [minLng, minLat, maxLng, maxLat] */
+    extent: [number, number, number, number];
+    /** 四角地理坐标 [TL, TR, BR, BL] */
+    corners: GeoCorners;
+    /** 切片像素宽度 */
+    width: number;
+    /** 切片像素高度 */
+    height: number;
+}
+
 export declare function Tooltip({ content, variant, longitude, latitude, targetElement, placement, offset, trigger, visible: visibleProp, title, items, overlayContainer, className, }: TooltipProps): default_2.ReactPortal | null;
 
 /**