@antv/aimapui 0.3.5 → 0.4.2

package/dist/index.d.ts

@@ -7,6 +7,7 @@ import { Scene } from '@antv/l7';
 
 export declare type ActiveConfig = boolean | {
     color: string;
+    duration?: number;
 };
 
 /**
@@ -1095,7 +1096,7 @@ declare type BubbleAnchor = 'center' | 'top' | 'right' | 'bottom' | 'left' | 'to
  * - bubbleAnchor='center', labelAnchor='center' — 标签居中覆盖气泡（适合短文本）
  * - bubbleAnchor='bottom', labelAnchor='top' — 标签在气泡上方（经典布局）
  */
-export declare function BubbleLayer({ source, sourceType, sourceConfig, labelField, labelColor, labelSize, showLabel, labelOffset, sizeDomain, bubbleAnchor, labelAnchor, hoverEffect, clickEffect, tooltipEffect, tooltipFields, tooltipTemplate, semanticColorField, color, size, sizeField, sizeValues, style, active, select, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: BubbleLayerProps): default_2.JSX.Element;
+export declare function BubbleLayer({ source, sourceType, sourceConfig, labelField, labelColor, labelSize, showLabel, labelOffset, sizeDomain, sizeRange, bubbleAnchor, labelAnchor, hoverEffect, clickEffect, tooltipEffect, tooltipFields, tooltipTemplate, semanticColorField, colorScheme, color, size, sizeField, sizeValues, style, active, select, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: BubbleLayerProps): default_2.JSX.Element;
 
 export declare interface BubbleLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     source: LayerSchema['source'];
@@ -1110,6 +1111,8 @@ export declare interface BubbleLayerProps extends Omit<LayerSchema, 'type' | 'so
     labelOffset?: [number, number];
     /** sizeField 为离散值时，对应每个 sizeValues 的域值顺序（默认 1..N） */
     sizeDomain?: Array<string | number>;
+    /** 连续数值尺寸范围 [min, max]，与 sizeField 配合使用。提供时自动线性映射 */
+    sizeRange?: [number, number];
     /** 气泡锚点，决定标签相对气泡的连接参考点 */
     bubbleAnchor?: BubbleAnchor;
     /** 文本锚点，映射到 textAnchor */
@@ -1126,6 +1129,8 @@ export declare interface BubbleLayerProps extends Omit<LayerSchema, 'type' | 'so
     tooltipTemplate?: string;
     /** 语义色板映射字段，例如 status: primary|warning|error|success */
     semanticColorField?: string;
+    /** 色板预设，默认 'categorical'。当无 semanticColorField 且无 colorValues 时使用 */
+    colorScheme?: ColorScheme;
     /** 点击事件 */
     onClick?: (payload: LayerEventPayload) => void;
     /** 鼠标移动事件 */
@@ -1153,6 +1158,9 @@ export declare interface CalibrationResult {
     extent: [number, number, number, number];
 }
 
+/** 分类色板 — 适用于离散类别，色盲安全 */
+export declare const CATEGORICAL_COLORS: readonly ["#2563eb", "#f59e0b", "#ef4444", "#10b981", "#8b5cf6", "#14b8a6", "#f97316", "#64748b"];
+
 /**
  * 中国行政区划图层（ChinaDistrict）
  *
@@ -1255,6 +1263,14 @@ declare interface ColorConfig {
     values?: string[] | string;
 }
 
+/**
+ * 语义化色板预设
+ *
+ * 基于 ColorBrewer 推荐，色盲安全。
+ * 参考: https://colorbrewer2.org/
+ */
+export declare type ColorScheme = 'sequential' | 'diverging' | 'categorical';
+
 /**
  * L7 规范的控件容器，将子控件按 position 分组到四角自动排列
  *
@@ -1408,6 +1424,9 @@ export declare const DEFAULT_PROVINCE_SOURCE = "https://mdn.alipayobjects.com/an
  */
 export declare function diffSchema(prev: AiMapSchema, next: AiMapSchema): SchemaDiffResult;
 
+/** 发散色板（红-白-绿）— 适用于有中心点的双向数据 */
+export declare const DIVERGING_COLORS: readonly ["#dc2626", "#fca5a5", "#e5e7eb", "#86efac", "#16a34a"];
+
 /** 基础绘制模式（产生要素的模式） */
 declare type DrawBasicMode = 'point' | 'polyline' | 'polygon' | 'rectangle' | 'circle';
 
@@ -1725,12 +1744,12 @@ declare interface ExportUploadData {
     outputHeight: number;
 }
 
-declare type FillColorMapping = 'sequential' | 'diverging' | 'categorical';
+declare type FillColorMapping = ColorScheme;
 
 /**
  * 填充图组件（填充 + 描边 + 文字）
  */
-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): default_2.JSX.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, onMouseMove, onMouseLeave, onLayerCreated, showLabel, labelField, labelColor, labelSize, labelAreaThreshold, labelHaloWidth, minLabelZoom, valueField, percentageField, nameField, color, colorField, colorValues, active, select, events, style, ...rest }: FillLayerProps): default_2.JSX.Element;
 
 export declare interface FillLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     source: LayerSchema['source'];
@@ -1753,6 +1772,8 @@ export declare interface FillLayerProps extends Omit<LayerSchema, 'type' | 'sour
     clickZoomDelta?: number;
     onRegionClick?: (payload: LayerEventPayload) => void;
     onDrilldown?: (feature: Record<string, unknown>) => void;
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    onMouseLeave?: (payload: LayerEventPayload) => void;
     onLayerCreated?: (layer: any) => void;
     showLabel?: boolean;
     labelField?: string;
@@ -1839,6 +1860,9 @@ export declare interface GestureConfig {
     dragRotate?: boolean;
 }
 
+/** 根据 colorScheme 获取对应色板 */
+export declare function getColorPalette(scheme: ColorScheme): readonly string[];
+
 /**
  * 根据控件 position 计算弹出面板的初始方向
  * - top* → 向下弹出, bottom* → 向上弹出
@@ -1945,17 +1969,17 @@ export declare interface GlyphLayerProps extends Omit<LayerSchema, 'type' | 'sou
     onMouseLeave?: (payload: LayerEventPayload) => void;
 }
 
-export declare const H3_SEQUENTIAL_COLORS: readonly ["#dbeafe", "#93c5fd", "#60a5fa", "#3b82f6", "#2563eb"];
-
 export declare interface H3DataItem {
     [key: string]: unknown;
 }
 
-export declare function H3Layer({ source, h3Field, color, colorField, colorValues, opacity, showStroke, strokeColor, strokeWidth, hoverEffect, clickEffect, showLabel, labelField, labelColor, labelSize, active, select, style, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: H3LayerProps): default_2.JSX.Element;
+export declare function H3Layer({ source, h3Field, color, colorField, colorValues, colorScheme, opacity, showStroke, strokeColor, strokeWidth, hoverEffect, clickEffect, showLabel, labelField, labelColor, labelSize, active, select, style, onClick, onMouseMove, onMouseEnter, onMouseLeave, ...rest }: H3LayerProps): default_2.JSX.Element;
 
 export declare interface H3LayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig' | 'shape' | 'shapeField' | 'shapeValues'> {
     source: H3DataItem[];
     h3Field?: string;
+    /** 色板预设，默认 'sequential' */
+    colorScheme?: ColorScheme;
     showStroke?: boolean;
     strokeColor?: string;
     strokeWidth?: number;
@@ -2003,7 +2027,7 @@ export declare interface HeatmapLayerProps extends Omit<LayerSchema, 'type' | 's
  * - 默认 hexSize=20（屏幕空间 20-40px 范围）
  * - 支持 hover 高亮反馈
  */
-declare function HexagonLayer({ source, sourceType, sourceConfig, mode, hexSize, weightField, weightMethod, showStroke, strokeColor, strokeWidth, hoverEffect, activeColor, onClick, onMouseMove, onMouseEnter, onMouseLeave, style, ...rest }: HexagonLayerProps): default_2.JSX.Element;
+declare function HexagonLayer({ source, sourceType, sourceConfig, mode, hexSize, weightField, weightMethod, showStroke, strokeColor, strokeWidth, hoverEffect, activeColor, colorScheme, onClick, onMouseMove, onMouseEnter, onMouseLeave, style, ...rest }: HexagonLayerProps): default_2.JSX.Element;
 export { HexagonLayer as HeatmapHexagonLayer }
 export { HexagonLayer }
 
@@ -2029,6 +2053,8 @@ declare interface HexagonLayerProps extends Omit<LayerSchema, 'type' | 'shape' |
     hoverEffect?: boolean;
     /** hover 高亮色，默认 '#fbbf24' (secondary) */
     activeColor?: string;
+    /** 色板预设，默认 'sequential'。用于生成 heatmap rampColors */
+    colorScheme?: ColorScheme;
     onClick?: (payload: LayerEventPayload) => void;
     onMouseMove?: (payload: LayerEventPayload) => void;
     onMouseEnter?: (payload: LayerEventPayload) => void;
@@ -2070,7 +2096,7 @@ declare type IconAnchor_2 = 'center' | 'top' | 'bottom' | 'left' | 'right';
  * - 缩放适配：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): default_2.JSX.Element | null;
+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, accuracy, ...rest }: IconLayerProps): default_2.JSX.Element | null;
 
 export declare interface IconLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     source: LayerSchema['source'];
@@ -2115,6 +2141,12 @@ export declare interface IconLayerProps extends Omit<LayerSchema, 'type' | 'sour
     onClick?: (payload: LayerEventPayload) => void;
     onMouseEnter?: (payload: LayerEventPayload) => void;
     onMouseLeave?: (payload: LayerEventPayload) => void;
+    /**
+     * 定位精度模式
+     * - precise: 精确地址，使用尖头 pin 图标（默认）
+     * - general: 模糊区域，使用圆形标记，避免误导用户以为精确定位
+     */
+    accuracy?: 'precise' | 'general';
 }
 
 declare interface ImageAnnotationProperties extends AnnotationPropertiesBase {
@@ -2343,6 +2375,8 @@ export declare interface LayerSchema {
     size?: number;
     sizeField?: string;
     sizeValues?: number[];
+    /** 连续数值尺寸范围 [min, max]，与 sizeField 配合使用 */
+    sizeRange?: [number, number];
     shape?: string;
     shapeField?: string;
     shapeValues?: string[] | string;
@@ -3088,7 +3122,7 @@ export declare interface PolygonLayerProps extends Omit<LayerSchema, 'type' | 's
     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;
+export declare function Popup({ longitude, latitude, content, closeButton, size: sizeProp, placement: placementProp, offset, layout, header, attributes, actions, visible: visibleProp, singleton, overlayContainer, onClose, className, }: PopupProps): default_2.ReactPortal | null;
 
 /**
  * Popup 操作按钮
@@ -3151,6 +3185,14 @@ export declare interface PopupProps extends Omit<PopupSchema, 'type' | 'content'
     placement?: PopupPlacement;
     /** 弹出框偏移量（像素），默认 8px，正数远离锚点 */
     offset?: number;
+    /**
+     * 布局预设 — 快速选择信息排布方式，自动映射到 size + 内部样式
+     * - simple:    纯文本/HTML，compact 尺寸
+     * - card:      标题 + 属性列表，standard 尺寸
+     * - rich:      封面图 + 标题 + 属性 + 操作按钮，detailed 尺寸
+     * 传入后仍可被 size/header/attributes/actions 单独覆盖
+     */
+    layout?: 'simple' | 'card' | 'rich';
     /** 结构化标题栏（可选，传入后覆盖简单内容模式） */
     header?: PopupHeader;
     /** 属性列表（可选，"标签-值"对齐模式） */
@@ -3250,6 +3292,32 @@ declare interface RegisteredImage {
     croppedRevokeUrl: (() => void) | null;
 }
 
+export declare function ResetViewControl({ position, icon, title, initialView, className, style, }: ResetViewControlProps): default_2.JSX.Element;
+
+/**
+ * ResetView 控件 — 一键重置地图到初始视图
+ *
+ * 遵循 L7 Control 规范 + Material Design 3 玻璃态风格。
+ * 点击后将地图中心、缩放级别、旋转角、俯仰角恢复到初始状态。
+ */
+export declare interface ResetViewControlProps {
+    /** 控件位置，默认 bottomright */
+    position?: L7ControlPosition;
+    /** 按钮图标，默认 Material Symbols "center_focus_strong" */
+    icon?: default_2.ReactNode;
+    /** 按钮标题/tooltip */
+    title?: string;
+    /** 自定义初始视图参数。不传时使用 scene 创建时的初始值 */
+    initialView?: {
+        center?: [number, number];
+        zoom?: number;
+        pitch?: number;
+        rotation?: number;
+    };
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
 declare type ResolvedMapSchema = MapSchema & {
     basemap: NonNullable<MapSchema['basemap']>;
     center: NonNullable<MapSchema['center']>;
@@ -3282,9 +3350,7 @@ export declare interface ResponsiveSchema {
  *
  * 遵循设计规范：
  * - 序列化途经点 (Numbered Stops)
- * - 路径发光效果
  * - 分段着色（路况/属性）
- * - 流动动画
  *
  * @example
  * ```tsx
@@ -3294,12 +3360,10 @@ export declare interface ResponsiveSchema {
  *     { lng: 120.15, lat: 30.28, name: '西湖' },
  *     { lng: 120.17, lat: 30.25, name: '灵隐寺' },
  *   ]}
- *   animate
- *   glow
  * />
  * ```
  */
-export declare function RouteLayer({ path, segments, stops, routeType, onRouteQuery, onRouteResult, color, lineWidth, opacity, glow, animate, animateSpeed, stopSize, stopColor, endColor, showStopIndex, showStopName, stopNameColor, stopNameSize, stopRenderer, stopMarkerVariant, stopIconMap, stopIconField, stopIconSize, stopIconAnchor, showStopPopup, activeColor, onPathClick, onStopClick, }: RouteLayerProps): default_2.JSX.Element | null;
+export declare function RouteLayer({ path, segments, stops, routeType, onRouteQuery, onRouteResult, color, lineWidth, opacity, stopSize, stopColor, endColor, showStopIndex, showStopName, stopNameColor, stopNameSize, stopRenderer, stopMarkerVariant, stopIconMap, stopIconField, stopIconSize, stopIconAnchor, showStopPopup, activeColor, onPathClick, onStopClick, zIndex, ...rest }: RouteLayerProps): default_2.JSX.Element | null;
 
 export declare interface RouteLayerProps {
     /** 路径坐标 — 完整线坐标或分段 */
@@ -3320,12 +3384,6 @@ export declare interface RouteLayerProps {
     lineWidth?: number;
     /** 路径透明度，默认 0.9 */
     opacity?: number;
-    /** 是否显示发光效果，默认 true */
-    glow?: boolean;
-    /** 是否启用流动动画，默认 false */
-    animate?: boolean;
-    /** 动画速度，默认 1 */
-    animateSpeed?: number;
     /** 途经点大小，默认 14 */
     stopSize?: number;
     /** 途经点颜色（默认跟随路径色） */
@@ -3360,6 +3418,8 @@ export declare interface RouteLayerProps {
     onPathClick?: (payload: LayerEventPayload) => void;
     /** 途经点点击 */
     onStopClick?: (payload: LayerEventPayload) => void;
+    /** 图层层级 */
+    zIndex?: number;
 }
 
 /** 交通路线查询参数 */
@@ -3602,8 +3662,14 @@ export declare interface SearchBarProps {
 
 export declare type SelectConfig = boolean | {
     color: string;
+    duration?: number;
 };
 
+/** 顺序色板（蓝）— 适用于单调递增/递减数据 */
+declare const SEQUENTIAL_COLORS: readonly ["#dbeafe", "#93c5fd", "#60a5fa", "#3b82f6", "#2563eb"];
+export { SEQUENTIAL_COLORS as H3_SEQUENTIAL_COLORS }
+export { SEQUENTIAL_COLORS }
+
 declare interface ShapeConfig {
     field?: string;
     values?: string[] | string;
@@ -3612,6 +3678,8 @@ declare interface ShapeConfig {
 declare interface SizeConfig {
     field?: string;
     values?: number[] | number;
+    /** 连续数值尺寸范围 [min, max]，与 field 配合使用 */
+    range?: [number, number];
 }
 
 export declare interface SourceConfig {