@antv/aimapui 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -885,7 +885,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 +939,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 +1063,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;
@@ -1435,7 +1433,7 @@ 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 +1456,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;
@@ -1528,8 +1527,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 +1547,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 +1626,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 +1640,8 @@ export declare interface HeatmapLayerProps extends Omit<LayerSchema, 'type' | 's
     onMouseEnter?: (payload: LayerEventPayload) => void;
     /** 鼠标离开事件 */
     onMouseLeave?: (payload: LayerEventPayload) => void;
+    /** L7 图层实例创建回调 */
+    onLayerCreated?: (layer: any) => void;
 }
 
 /**
@@ -1925,6 +1925,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 +2197,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 +2207,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 +2537,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 +2554,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 +2571,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 +2760,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 +2769,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 +2795,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 +2817,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 +2867,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>;