@antv/aimapui 0.3.1 → 0.3.3

package/dist/index.d.ts

@@ -1080,6 +1080,8 @@ export declare interface BottomSheetProps {
 
 export declare type BottomSheetSnap = 'collapsed' | 'half' | 'expanded';
 
+export declare const BUBBLE_SIZE_LEVELS: readonly [8, 16, 32, 48, 64];
+
 declare type BubbleAnchor = 'center' | 'top' | 'right' | 'bottom' | 'left' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 
 /**
@@ -1331,9 +1333,8 @@ export declare type ControlType = 'zoom' | 'scale' | 'fullscreen' | 'geoLocate'
 
 /**
  * 底图工厂 — 根据配置创建 L7 Map 实例
- * 动态导入各底图模块，避免未使用时打包
  */
-export declare function createBasemap(schema: MapSchema): Promise<unknown>;
+export declare function createBasemap(schema: MapSchema): unknown;
 
 /**
  * 创建 EventBus 实例
@@ -1653,28 +1654,33 @@ export declare interface ExportConfig {
     quality?: number;
 }
 
-export declare function ExportImageControl({ position, format, onExport, className, style, }: ExportImageControlProps): JSX_2.Element;
+export declare const ExportImageControl: default_2.ForwardRefExoticComponent<ExportImageControlProps & default_2.RefAttributes<ExportImageHandle>>;
 
 /**
  * ExportImage 导出图片控件
  *
- * 遵循 L7 的 ButtonControl 规范 + Material Design 3 玻璃态风格：
- * - CSS 类名: .l7-control .l7-button-control
- * - 玻璃态: glass-effect + surface/90 背景
- * - 位置默认: topright
- * - API: mapsService.exportMap() + scene.exportPng()，然后合并图片
+ * 导图为底图（高德）和可视化图层（L7）的合并图。
+ * 优先使用 L7 API（exportMap + exportPng），
+ * 失败时回退到直接抓取 map 容器内的所有 canvas 合并。
+ *
+ * ```tsx
+ * const ref = useRef<ExportImageHandle>(null);
+ * <ExportImageControl ref={ref} />
+ * const base64 = await ref.current?.exportImage();
+ * ```
  */
 export declare interface ExportImageControlProps {
-    /** 控件位置，默认 topright */
     position?: L7ControlPosition;
-    /** 图片格式，默认 png */
     format?: 'png' | 'jpg';
     className?: string;
     style?: default_2.CSSProperties;
-    /** 导出回调 */
     onExport?: (base64: string) => void;
 }
 
+export declare interface ExportImageHandle {
+    exportImage(format?: 'png' | 'jpg'): Promise<string | undefined>;
+}
+
 /** 导出选项（向后兼容） */
 export declare interface ExportOptions {
     maxWidth?: number;
@@ -1917,6 +1923,32 @@ 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): JSX_2.Element;
+
+export declare interface H3LayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig' | 'shape' | 'shapeField' | 'shapeValues'> {
+    source: H3DataItem[];
+    h3Field?: string;
+    showStroke?: boolean;
+    strokeColor?: string;
+    strokeWidth?: number;
+    hoverEffect?: boolean;
+    clickEffect?: boolean;
+    showLabel?: boolean;
+    labelField?: string;
+    labelColor?: string;
+    labelSize?: number;
+    onClick?: (payload: LayerEventPayload) => void;
+    onMouseMove?: (payload: LayerEventPayload) => void;
+    onMouseEnter?: (payload: LayerEventPayload) => void;
+    onMouseLeave?: (payload: LayerEventPayload) => void;
+}
+
 /**
  * 热力图图层组件
  *
@@ -2068,18 +2100,18 @@ export declare interface ImageCalibrationControlProps {
     /** 额外 style */
     style?: React.CSSProperties;
     /** 角点变化回调 */
-    onCornersChange?: (corners: GeoCorners) => void;
+    onCornersChange?: (imageId: string, corners: GeoCorners) => void;
     /** 确认配准回调 */
-    onCalibrate?: (result: CalibrationResult) => void;
+    onCalibrate?: (imageId: string, result: CalibrationResult) => void;
     /** 导出完成回调 */
-    onExport?: (result: ExportResult) => void;
+    onExport?: (imageId: string, result: ExportResult) => void;
     /** 图片加载完成回调 */
-    onImageLoad?: (dimensions: {
+    onImageLoad?: (imageId: string, dimensions: {
         width: number;
         height: number;
     }) => void;
     /** 裁剪预处理完成回调，返回裁剪后的尺寸和可选的初始坐标 */
-    onPreprocess?: (result: {
+    onPreprocess?: (imageId: string, result: {
         croppedDimensions: {
             width: number;
             height: number;
@@ -2087,16 +2119,36 @@ export declare interface ImageCalibrationControlProps {
         initialCorners: GeoCorners | null;
     }) => void;
     /** 清除回调 */
-    onClear?: () => void;
+    onClear?: (imageId: string) => void;
+    /** 图片列表变化回调 */
+    onImagesChange?: (images: RegisteredImage[]) => void;
+    /** 切换图片回调 */
+    onImageSwitch?: (imageId: string) => void;
+    /** 图片重命名回调 */
+    onImageRename?: (imageId: string, oldName: string, newName: string) => void;
+    /** 图片列表拖拽排序回调 */
+    onImagesReorder?: (images: RegisteredImage[]) => void;
+    /** 上传新图片回调 */
+    onImageAdd?: (image: RegisteredImage) => void;
+    /** 删除图片回调 */
+    onImageRemove?: (imageId: string) => void;
 }
 
 /** 命令式 Handle */
 export declare interface ImageCalibrationHandle {
     getCorners(): GeoCorners | null;
     setCorners(corners: GeoCorners): void;
-    setImage(source: ImageSource): void;
+    setImage(source: ImageSource, initialCorners?: GeoCorners | null): void;
     exportImage(config?: ExportConfig): Promise<ExportResult>;
     clear(): void;
+    /** 获取所有已注册的图片列表 */
+    getImages(): RegisteredImage[];
+    /** 切换激活图片 */
+    switchImage(id: string): void;
+    /** 删除指定图片 */
+    deleteImage(id: string): void;
+    /** 获取当前激活图片 ID */
+    getActiveImageId(): string | null;
 }
 
 /**
@@ -3103,6 +3155,31 @@ export declare interface RasterLayerProps extends Omit<LayerSchema, 'type' | 'so
  */
 export declare type RasterRenderMode = 'raster' | 'rgb' | 'ndi';
 
+/** 单张配准图片（多图管理） */
+declare interface RegisteredImage {
+    id: string;
+    name: string;
+    /** 图片来源（File 或 URL），用于重新加载 */
+    source: ImageSource;
+    /** 缩略图 URL */
+    thumbnailUrl: string;
+    /** 图片尺寸 */
+    dimensions: {
+        width: number;
+        height: number;
+    } | null;
+    /** 当前阶段 */
+    phase: CalibrationPhase;
+    /** 当前角点 */
+    corners: GeoCorners | null;
+    /** 透明度 0-1 */
+    opacity: number;
+    /** 需要释放的 ObjectURL */
+    revokeUrl: (() => void) | null;
+    /** 裁剪产生的额外 URL 需要释放 */
+    croppedRevokeUrl: (() => void) | null;
+}
+
 declare type ResolvedMapSchema = MapSchema & {
     basemap: NonNullable<MapSchema['basemap']>;
     center: NonNullable<MapSchema['center']>;
@@ -3152,7 +3229,7 @@ export declare interface ResponsiveSchema {
  * />
  * ```
  */
-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 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): JSX_2.Element | null;
 
 export declare interface RouteLayerProps {
     /** 路径坐标 — 完整线坐标或分段 */
@@ -3187,6 +3264,12 @@ export declare interface RouteLayerProps {
     endColor?: string;
     /** 是否显示途经点序号，默认 true */
     showStopIndex?: boolean;
+    /** 是否显示途经点名称，默认 true */
+    showStopName?: boolean;
+    /** 名称文字颜色，默认 '#334155' */
+    stopNameColor?: string;
+    /** 名称文字大小，默认 11 */
+    stopNameSize?: number;
     /** 停留点渲染模式，默认 'point' */
     stopRenderer?: 'point' | 'marker' | 'icon';
     /** marker 模式下的默认变体，默认 'circle' */