@ray-js/robot-map-sdk 0.0.2-beta-1

package/dist/index.d.ts

@@ -0,0 +1,3501 @@
+import { AnimatedSprite } from 'pixi.js';
+import { AppContainer as AppContainer_2 } from './AppContainer';
+import { Application } from 'pixi.js';
+import { ApplicationOptions } from 'pixi.js';
+import { ColorSource } from 'pixi.js';
+import { Container } from 'pixi.js';
+import { ControlsConfig as ControlsConfig_2 } from '..';
+import { ControlsManager as ControlsManager_2 } from '../managers/ControlsManager';
+import { CustomElementsManager as CustomElementsManager_2 } from '../managers/CustomElementsManager';
+import { DetectedObjectManager as DetectedObjectManager_2 } from '../managers/DetectedObjectManager';
+import { DividerConfig as DividerConfig_2 } from '..';
+import { Emitter } from 'mitt';
+import { FederatedPointerEvent } from 'pixi.js';
+import { Graphics } from 'pixi.js';
+import { HeatmapManager as HeatmapManager_2 } from '../managers/HeatmapManager';
+import { Interaction as Interaction_2 } from './Interaction';
+import { MapCallbacks as MapCallbacks_2 } from '..';
+import { MapData } from '@ray-js/robot-protocol';
+import { MapHeader } from '@ray-js/robot-protocol';
+import { MapManager as MapManager_2 } from '../managers/MapManager';
+import { MapState as MapState_2 } from '..';
+import { PathData } from '@ray-js/robot-protocol';
+import { PathManager as PathManager_2 } from '../managers/PathManager';
+import { Rectangle } from 'pixi.js';
+import { RingConfig as RingConfig_2 } from '..';
+import { RoomData as RoomData_2 } from '..';
+import { RoomManager as RoomManager_2 } from '../managers/RoomManager';
+import { RuntimeConfig as RuntimeConfig_2 } from '..';
+import { Sprite } from 'pixi.js';
+import { TextStyleFontWeight } from 'pixi.js';
+import { Texture } from 'pixi.js';
+import { Ticker } from 'pixi.js';
+import { ViewportContainer as ViewportContainer_2 } from './ViewportContainer';
+
+/**
+ * 地图静态配置
+ * 定义了视觉样式、素材资源、交互行为等一次性配置项
+ */
+export declare type AppConfig = {
+    /** 全局配置 */
+    global: {
+        /** 容器距离顶部位置 */
+        containerTop: string
+        /** 容器距离左侧位置 */
+        containerLeft: string
+        /** 容器宽度 */
+        containerWidth: string
+        /** 容器高度 */
+        containerHeight: string
+        /** 背景颜色 */
+        backgroundColor: ColorSource
+    }
+    /** 地图基础配置 */
+    map: {
+        /** 自动填充百分比 */
+        autoPaddingPercent: number
+        /** 障碍点颜色 */
+        obstacleColor: ColorSource
+    }
+
+    /** 热力图配置 */
+    heatmap: {
+        /** 热力图单元格大小 */
+        cellSize: number
+        /** 最大距离 */
+        maxDistance: number
+        /** 平滑迭代次数 */
+        smoothIterations: number
+        /** 热力图透明度 */
+        heatmapAlpha: number
+        /** 颜色渐变配置 */
+        colorGradients: [
+        ColorSource,
+        ColorSource,
+        ColorSource,
+        ColorSource,
+        ColorSource,
+        ColorSource,
+        ColorSource,
+        ColorSource,
+        ]
+    }
+
+    /** 房间配置 */
+    room: {
+        /** 房间颜色配置 */
+        colors: {
+            /** 激活状态颜色 */
+            active: string[]
+            /** 非激活状态颜色 */
+            inactive: string[]
+            /** 房间名称颜色 */
+            name: string[]
+            /** 属性主题颜色 */
+            propertyTheme: string[]
+            /** 选择指示器背景颜色 */
+            selectionIndicatorBackground: string[]
+            /** 选择指示器图标颜色 */
+            selectionIndicatorIcon: string[]
+            /** 无房间数据特殊颜色 */
+            [SPECIAL_ROOM_IDS.NO_ROOM_DATA]: string
+            /** 房间间隙特殊颜色 */
+            [SPECIAL_ROOM_IDS.ROOM_GAP]: string
+            /** 障碍物房间特殊颜色 */
+            [SPECIAL_ROOM_IDS.OBSTACLE_ROOM]: string
+            /** 未知房间特殊颜色 */
+            [SPECIAL_ROOM_IDS.UNKNOWN_ROOM]: string
+        }
+        /** 房间名称配置 */
+        nameLabel: {
+            /** 字体大小 */
+            fontSize: number
+            /** 字体名称 */
+            fontFamily: string
+            /** 字体粗细 */
+            fontWeight: TextStyleFontWeight
+        }
+        /** 房间属性配置 */
+        property: {
+            /** 显示顺序 */
+            displayOrders: ('cleanMode' | 'suction' | 'cistern' | 'cleanTimes')[]
+            /** 图标宽度 */
+            iconWidth: number
+            /** 图标高度 */
+            iconHeight: number
+            /** 是否可折叠 */
+            foldable: boolean
+            /** X轴偏移 */
+            offsetX: number
+            /** Y轴偏移 */
+            offsetY: number
+            /** 图标间距 */
+            iconGap: number
+            /** 容器样式 */
+            container: {
+                /** 背景颜色 */
+                backgroundColor: ColorSource
+                /** 垂直内边距 */
+                paddingVertical: number
+                /** 水平内边距 */
+                paddingHorizontal: number
+                /** 边框圆角 */
+                borderRadius: number
+                /** 气泡箭头高度 */
+                tailHeight: number
+                /** 气泡箭头宽度 */
+                tailWidth: number
+            }
+            /** 吸力配置 */
+            suction: {
+                /** 资源数组 */
+                assets: string[]
+            }
+            /** 水量配置 */
+            cistern: {
+                /** 资源数组 */
+                assets: string[]
+            }
+            /** 清扫模式配置 */
+            cleanMode: {
+                /** 资源数组 */
+                assets: string[]
+            }
+            /** 清扫次数配置 */
+            cleanTimes: {
+                /** 资源数组 */
+                assets: string[]
+            }
+            /** 清扫顺序配置 */
+            cleanOrder: {
+                /** 颜色 */
+                color: ColorSource
+                /** 字体名称 */
+                fontFamily: string
+                /** 字体粗细 */
+                fontWeight: TextStyleFontWeight
+                /** 字体大小 */
+                fontSize: number
+                /** 右侧间隔 */
+                gapRight: number
+            }
+        }
+        /** 选择指示器配置 */
+        selectionIndicator: {
+            /** 图标资源路径 */
+            iconSrc: string
+            /** 图标宽度 */
+            iconWidth: number
+            /** 图标高度 */
+            iconHeight: number
+            /** 容器宽度 */
+            containerWidth: number
+            /** 容器高度 */
+            containerHeight: number
+            /** 描边宽度 */
+            strokeWidth: number
+            /** 描边颜色 */
+            strokeColor: ColorSource
+            /** 边框圆角 */
+            borderRadius: number
+            /** X轴偏移 */
+            offsetX: number
+            /** Y轴偏移 */
+            offsetY: number
+            /** 气泡箭头高度 */
+            tailHeight: number
+            /** 气泡箭头宽度 */
+            tailWidth: number
+        }
+        /** 地板材质配置 */
+        floorType: {
+            /** 资源数组(建议使用材质的最小重复单元) */
+            assets: string[]
+            /** 透明度 */
+            opacity: number
+            /** 缩放系数 */
+            scale: number
+        }
+    }
+
+    /** 路径配置 */
+    path: {
+        /** 线条宽度是否固定 (不跟随地图缩放变化) */
+        lineWidthFixed: boolean
+        /**
+         * 增量阈值
+         *
+         * 当路径点数量变化超过该阈值时，使用全量绘制，否则使用增量绘制。
+         *
+         * 设置为0时，不使用增量绘制。
+         *
+         * */
+        incrementalThreshold: number
+        /** 清扫路径配置 */
+        commonPath: {
+            /** 颜色 */
+            color: ColorSource
+            /** 宽度 */
+            width: number
+        }
+        /** 转场路径配置 */
+        transitionPath: {
+            /** 颜色 */
+            color: ColorSource
+            /** 宽度 */
+            width: number
+        }
+        /** 回充路径配置 */
+        chargePath: {
+            /** 颜色 */
+            color: ColorSource
+            /** 宽度 */
+            width: number
+        }
+    }
+
+    /** 地毯配置 */
+    carpet: {
+        /** 地毯资源路径 */
+        src: string
+        /** 透明度 */
+        opacity: number
+        /** 缩放系数 */
+        scale: number
+    }
+
+    /** 机器人配置 */
+    robot: {
+        /** 图标配置 */
+        icon: {
+            /** 尺寸是否固定 */
+            sizeFixed: boolean
+            /** 宽度 */
+            width: number
+            /** 高度 */
+            height: number
+            /** 图标资源路径 */
+            src: string
+        }
+        /** 机器人移动速度（米/秒） */
+        speed: number
+        /** 角度校正（度）
+         *
+         * 用于校正图标默认朝向，0度表示图标朝右
+         *
+         */
+        rotationCorrection: number
+        /** 睡眠动画配置 */
+        sleepAnimation: {
+            /**
+             * 睡眠动画JSON资源路径
+             *
+             * 使用TexturePacker生成的JSON文件
+             */
+            jsonSrc: string
+            /**
+             * 帧名称前缀
+             *
+             * 用于指定动画帧的名称前缀，例如 "sleep_"
+             *
+             */
+            framePrefix: string
+            /** 宽度 */
+            width: number
+            /** 高度 */
+            height: number
+            /** 尺寸是否固定 */
+            sizeFixed: boolean
+            /** 总帧数 */
+            frameCount: number
+            /** X轴偏移 */
+            offsetX: number
+            /** Y轴偏移 */
+            offsetY: number
+        }
+    } & RingConfig
+
+    /** 充电桩配置 */
+    chargingStation: {
+        icon: {
+            /** 尺寸是否固定 */
+            sizeFixed: boolean
+            /** 宽度 */
+            width: number
+            /** 高度 */
+            height: number
+            /** 图标资源路径 */
+            src: string
+        }
+        /**
+         * 角度校正（度）
+         *
+         * 用于校正图标默认朝向，0度表示图标朝右
+         *
+         */
+        rotationCorrection: number
+    } & RingConfig
+
+    /** 交互配置 */
+    interaction: {
+        /** 缩放范围 */
+        zoomRange: {
+            /** 最小缩放比例 */
+            min: number
+            /** 最大缩放比例 */
+            max: number
+        }
+        /** 是否启用双击缩放功能 */
+        enableDoubleTapZoom: boolean
+    }
+
+    /** 控制元素配置 */
+    controls: ControlsConfig
+
+    /** 分割线配置 */
+    divider: DividerConfig
+
+    /** AI物体配置 */
+    detectedObject: {
+        /** 高度 */
+        height: number
+        /** 宽度 */
+        width: number
+        /** 是否可交互 */
+        interactive: boolean
+    }
+
+    /** 截图配置 */
+    snapshot: {
+        /** 格式 */
+        format: 'png' | 'jpg' | 'webp'
+        /** 质量 */
+        quality: number
+        /** 抗锯齿 */
+        antialias: boolean
+        /** 分辨率 */
+        resolution: number
+    }
+}
+
+/**
+ * AppContainer 同时作为应用的主容器和层级管理器
+ * 管理所有地图相关的层级和组件
+ */
+declare class AppContainer extends Container {
+    private layers;
+    constructor();
+    /**
+     * 初始化所有预定义的层级
+     */
+    private initializeLayers;
+    /**
+     * 获取指定名称的层容器
+     * @param name 层名称
+     * @returns 对应的容器，如果不存在则返回undefined
+     */
+    getLayer(name: LayerName): Container | undefined;
+    /**
+     * 向指定层添加元素
+     * @param name 层名称
+     * @param element 要添加的元素
+     * @param zIndex 可选的元素z索引
+     * @returns 是否添加成功
+     */
+    addToLayer(name: LayerName, element: Container, zIndex?: number): boolean;
+    /**
+     * 从指定层移除元素
+     * @param name 层名称
+     * @param element 要移除的元素
+     * @returns 是否移除成功
+     */
+    removeFromLayer(name: LayerName, element: Container): boolean;
+    /**
+     * 清空指定层的所有内容
+     * @param name 层名称
+     * @returns 是否清空成功
+     */
+    clearLayer(name: LayerName): boolean;
+    /**
+     * 设置指定层的可见性
+     * @param name 层名称
+     * @param visible 是否可见
+     * @returns 是否设置成功
+     */
+    setLayerVisibility(name: LayerName, visible: boolean): boolean;
+    /**
+     * 获取指定层的可见性
+     * @param name 层名称
+     * @returns 层的可见性状态，不存在则返回false
+     */
+    getLayerVisibility(name: LayerName): boolean;
+}
+
+/**
+ * 应用上下文管理 - 基于 React Context 思想
+ * 通过组件树的层级关系来传播上下文，每个组件都能自动获取到最近的 Provider 提供的值
+ */
+export declare class AppContext {
+    private static contextStack;
+    private static instanceMap;
+    private static serviceCache;
+    /**
+     * 类似 React.createContext() - 注册实例
+     */
+    static registerInstance(instanceKey: string, app: AppInstance): void;
+    /**
+     * 取消注册实例
+     */
+    static unregisterInstance(instanceKey: string): void;
+    /**
+     * 获取 AppService 实例
+     * @returns AppService 实例
+     */
+    static getService(): AppService;
+    /**
+     * 类似 <Context.Provider value={app}> - 提供上下文
+     */
+    static provide<T>(app: AppInstance, fn: () => T): T;
+    /**
+     * 异步版本的 provide
+     */
+    static provideAsync<T>(app: AppInstance, fn: () => Promise<T>): Promise<T>;
+    /**
+     * 类似 useContext(Context) - 获取当前上下文
+     */
+    static useContext(): AppInstance;
+    /**
+     * 检查是否有活跃的上下文
+     */
+    static hasContext(): boolean;
+    /**
+     * 清空所有上下文（主要用于测试）
+     */
+    static clear(): void;
+}
+
+declare type AppInstance = MapApplication;
+
+/**
+ * 应用程序选项配置
+ * 包含事件回调、配置和运行时状态
+ */
+export declare type AppOptions = {
+    /** 事件回调配置 */
+    events?: MapCallbacks
+    /** 应用配置 */
+    config: DeepPartialAppConfig
+    /** 运行时配置 */
+    runtime: DeepPartialRuntimeConfig
+}
+
+declare class AppService {
+    getApp(): MapApplication;
+    getConfig(): AppConfig;
+    getRoomProperty(roomId: number): RoomData_2 | undefined;
+    /**
+     * 将米转换为像素（委托给 MapApplication）
+     */
+    metersToPixels(meters: number): number;
+    /**
+     * 将像素转换为米（委托给 MapApplication）
+     */
+    pixelsToMeters(pixels: number): number;
+    get ticker(): Ticker;
+    get mapState(): MapState_2 | null;
+    get gloalConfig(): {
+        containerTop: string;
+        containerLeft: string;
+        containerWidth: string;
+        containerHeight: string;
+        backgroundColor: ColorSource;
+    };
+    get mapConfig(): {
+        autoPaddingPercent: number;
+        obstacleColor: ColorSource;
+    };
+    get roomConfig(): {
+        colors: {
+            active: string[];
+            inactive: string[];
+            name: string[];
+            propertyTheme: string[];
+            selectionIndicatorBackground: string[];
+            selectionIndicatorIcon: string[];
+            NO_ROOM_DATA: string;
+            ROOM_GAP: string;
+            OBSTACLE_ROOM: string;
+            UNKNOWN_ROOM: string;
+        };
+        nameLabel: {
+            fontSize: number;
+            fontFamily: string;
+            fontWeight: TextStyleFontWeight;
+        };
+        property: {
+            displayOrders: ("cleanMode" | "suction" | "cistern" | "cleanTimes")[];
+            iconWidth: number;
+            iconHeight: number;
+            foldable: boolean;
+            offsetX: number;
+            offsetY: number;
+            iconGap: number;
+            container: {
+                backgroundColor: ColorSource;
+                paddingVertical: number;
+                paddingHorizontal: number;
+                borderRadius: number;
+                tailHeight: number;
+                tailWidth: number;
+            };
+            suction: {
+                assets: string[];
+            };
+            cistern: {
+                assets: string[];
+            };
+            cleanMode: {
+                assets: string[];
+            };
+            cleanTimes: {
+                assets: string[];
+            };
+            cleanOrder: {
+                color: ColorSource;
+                fontFamily: string;
+                fontWeight: TextStyleFontWeight;
+                fontSize: number;
+                gapRight: number;
+            };
+        };
+        selectionIndicator: {
+            iconSrc: string;
+            iconWidth: number;
+            iconHeight: number;
+            containerWidth: number;
+            containerHeight: number;
+            strokeWidth: number;
+            strokeColor: ColorSource;
+            borderRadius: number;
+            offsetX: number;
+            offsetY: number;
+            tailHeight: number;
+            tailWidth: number;
+        };
+        floorType: {
+            assets: string[];
+            opacity: number;
+            scale: number;
+        };
+    };
+    get heatMapConfig(): {
+        cellSize: number;
+        maxDistance: number;
+        smoothIterations: number;
+        heatmapAlpha: number;
+        colorGradients: [ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource];
+    };
+    get pathConfig(): {
+        lineWidthFixed: boolean;
+        incrementalThreshold: number;
+        commonPath: {
+            color: ColorSource;
+            width: number;
+        };
+        transitionPath: {
+            color: ColorSource;
+            width: number;
+        };
+        chargePath: {
+            color: ColorSource;
+            width: number;
+        };
+    };
+    get carpetConfig(): {
+        src: string;
+        opacity: number;
+        scale: number;
+    };
+    get robotConfig(): {
+        icon: {
+            sizeFixed: boolean;
+            width: number;
+            height: number;
+            src: string;
+        };
+        speed: number;
+        rotationCorrection: number;
+        sleepAnimation: {
+            jsonSrc: string;
+            framePrefix: string;
+            width: number;
+            height: number;
+            sizeFixed: boolean;
+            frameCount: number;
+            offsetX: number;
+            offsetY: number;
+        };
+    } & RingConfig_2;
+    get chargingStationConfig(): {
+        icon: {
+            sizeFixed: boolean;
+            width: number;
+            height: number;
+            src: string;
+        };
+        rotationCorrection: number;
+    } & RingConfig_2;
+    get interactionConfig(): {
+        zoomRange: {
+            min: number;
+            max: number;
+        };
+        enableDoubleTapZoom: boolean;
+    };
+    get controlsConfig(): ControlsConfig_2;
+    get dividerConfig(): DividerConfig_2;
+    get detectedObjectConfig(): {
+        height: number;
+        width: number;
+        interactive: boolean;
+    };
+    get snapshotConfig(): {
+        format: "png" | "jpg" | "webp";
+        quality: number;
+        antialias: boolean;
+        resolution: number;
+    };
+    get appContainer(): AppContainer_2;
+    get interaction(): Interaction_2;
+    get viewportContainer(): ViewportContainer_2;
+    get mapManager(): MapManager_2;
+    get pathManager(): PathManager_2;
+    get heatmapManager(): HeatmapManager_2;
+    get controlsManager(): ControlsManager_2;
+    get detectedObjectManager(): DetectedObjectManager_2;
+    get customElementsManager(): CustomElementsManager_2;
+    get roomsManager(): RoomManager_2;
+    get runtime(): RuntimeConfig_2;
+    get runtimeSnapshot(): {
+        readonly dividingRoomId: number | null | undefined;
+        readonly enableRoomSelection: boolean;
+        readonly editingForbiddenSweepZoneIds: readonly string[];
+        readonly editingForbiddenMopZoneIds: readonly string[];
+        readonly editingCleanZoneIds: readonly string[];
+        readonly editingVirtualWallIds: readonly string[];
+        readonly editingSpotIds: readonly string[];
+        readonly roomPropertyFoldIds: readonly number[];
+        readonly roomSelectionMode: "checkmark" | "order";
+        readonly showRoomName: boolean;
+        readonly showRoomProperty: boolean;
+        readonly showRoomOrder: boolean;
+        readonly showPath: boolean;
+        readonly showChargingStation: boolean;
+        readonly showRoomFloorType: boolean;
+        readonly showCarpet: boolean;
+        readonly selectRoomIds: readonly number[];
+        readonly showChargingStationRing: boolean;
+        readonly showRobotRing: boolean;
+        readonly showRobotSleepAnimation: boolean;
+    };
+    get events(): MapCallbacks_2 | undefined;
+    get baseScale(): number;
+    get currentScale(): number;
+    get emitter(): Emitter<    {
+    antiScale: number;
+    cacheAsTexture: number;
+    gestureHijackStart: FederatedPointerEvent;
+    gestureHijackPointerMove: FederatedPointerEvent;
+    gestureHijackPointerUp: FederatedPointerEvent;
+    gestureHijackCancel: void;
+    robotPositionUpdate: {
+    x: number;
+    y: number;
+    pathType?: string;
+    };
+    robotAnimationComplete: void;
+    pathSegmentComplete: {
+    fromX: number;
+    fromY: number;
+    toX: number;
+    toY: number;
+    pathType?: string;
+    };
+    }>;
+}
+
+/**
+ * 基础自定义元素参数（所有类型共享）
+ */
+export declare type BaseCustomElementParam = {
+    /** ID */
+    id: string
+    /** X坐标 */
+    x: number
+    /** Y坐标 */
+    y: number
+    /** 旋转角度 */
+    rotation?: number
+    /** 透明度 */
+    opacity?: number
+    /** 是否可交互 */
+    interactive?: boolean
+    /** 自定义数据 */
+    customData?: Record<string, unknown>
+    /** 尺寸是否固定 */
+    sizeFixed?: boolean
+}
+
+/** 边界框 */
+export declare type Bounds = {
+    /** 最小X坐标 */
+    minX: number
+    /** 最小Y坐标 */
+    minY: number
+    /** 最大X坐标 */
+    maxX: number
+    /** 最大Y坐标 */
+    maxY: number
+}
+
+declare class Carpet extends Container {
+    private carpetSprite;
+    private carpetMask;
+    constructor();
+    /**
+     * 创建地毯纹理覆盖（栅格数据）
+     * @param carpetPixels 地毯像素数据
+     * @param mapWidth 地图宽度
+     */
+    createCarpetFromRasterData(carpetPixels: Uint32Array, mapWidth: number): Promise<void>;
+    /**
+     * 创建地毯的Graphics作为mask
+     * @param carpetPixels 地毯像素数据
+     * @param mapWidth 地图宽度
+     * @returns Graphics对象
+     */
+    private createCarpetGraphics;
+    /**
+     * 清除地毯
+     */
+    clearCarpet(): void;
+    /**
+     * 创建地毯纹理覆盖（结构化数据）
+     * @param carpetData 结构化地毯数据数组
+     */
+    createCarpetFromStructuredData(carpetData: Array<{
+        coordinates: number[];
+    }>): Promise<void>;
+    /**
+     * 创建地毯的Graphics作为mask（结构化数据）
+     * @param carpetData 结构化地毯数据数组
+     * @returns Graphics对象
+     */
+    private createCarpetGraphicsFromStructuredData;
+    /**
+     * 销毁时清理资源
+     */
+    destroy(): void;
+}
+
+declare class ChargingStation extends Container {
+    chargingStation: ChargingStationIcon;
+    ring: Ring;
+    private unsubscribeFns;
+    constructor();
+    draw({ x, y, rotation }: IconPoint): Promise<void>;
+    destroy(): void;
+}
+
+declare class ChargingStationIcon extends EnhancedSprite {
+    constructor();
+    initializeSprite(): Promise<void>;
+    draw({ x, y, rotation }: IconPoint): Promise<void>;
+}
+
+/** 组件属性类型 */
+export declare type ComponentPropsApp = {
+    /** 地图应用实例 */
+    app: MapApplication
+}
+
+/** 组件类型定义 */
+declare type Components = {
+    viewportContainer: ViewportContainer;
+    appContainer: AppContainer;
+    interaction: Interaction;
+};
+
+/**
+ * 控制元素配置
+ */
+export declare type ControlsConfig = {
+    /** 图标容器宽度 */
+    iconWrapperWidth: number
+    /** 图标容器高度 */
+    iconWrapperHeight: number
+    /** 图标容器边框圆角 */
+    iconWrapperBorderRadius: number
+    /** 图标宽度 */
+    iconWidth: number
+    /** 图标高度 */
+    iconHeight: number
+    /** 删除图标资源路径 */
+    deleteIconSrc: string
+    /** 旋转图标资源路径 */
+    rotateIconSrc: string
+    /** 缩放图标资源路径 */
+    scaleIconSrc: string
+    /** 移动图标资源路径 */
+    moveIconSrc: string
+    /** 移动按钮偏移 */
+    moveButtonOffset: number
+    /** 文本字体大小 */
+    textFontSize: number
+    /** 文本字体名称 */
+    textFontFamily: string
+    /** 文本字体粗细 */
+    textFontWeight: TextStyleFontWeight
+    /** 单位标签 */
+    unitLabel: string
+    /** 禁扫区域配置 */
+    forbiddenSweepZone: ZoneConfig
+    /** 禁拖区域配置 */
+    forbiddenMopZone: ZoneConfig
+    /** 清扫区域配置 */
+    cleanZone: ZoneConfig
+    /** 虚拟墙配置 */
+    virtualWall: VirtualWallConfig
+    /** 定点清扫配置 */
+    spot: SpotConfig
+}
+
+declare class ControlsManager {
+    private forbiddenSweepZoneMap;
+    private forbiddenMopZoneMap;
+    private cleanZoneMap;
+    private virtualWallMap;
+    private spotMap;
+    private divider;
+    private unsubscribeFns;
+    constructor();
+    /**
+     * 根据地图原点更新所有区域位置
+     */
+    updatePositionByOrigin(x: number, y: number): void;
+    /**
+     * 绘制扫地禁区
+     */
+    drawForbiddenSweepZones(zones: ZoneParam[]): void;
+    /**
+     * 获取所有扫地禁区数据
+     */
+    getForbiddenSweepZones(): ZoneParam[];
+    /**
+     * 清除所有扫地禁区
+     */
+    clearAllForbiddenSweepZones(): void;
+    /**
+     * 绘制拖地禁区
+     */
+    drawForbiddenMopZones(zones: ZoneParam[]): void;
+    /**
+     * 获取所有拖地禁区数据
+     */
+    getForbiddenMopZones(): ZoneParam[];
+    /**
+     * 清除所有拖地禁区
+     */
+    clearAllForbiddenMopZones(): void;
+    /**
+     * 绘制清扫区域
+     */
+    drawCleanZones(zones: ZoneParam[]): void;
+    /**
+     * 获取所有清扫区域数据
+     */
+    getCleanZones(): ZoneParam[];
+    /**
+     * 清除所有清扫区域
+     */
+    clearAllCleanZones(): void;
+    /**
+     * 绘制虚拟墙
+     */
+    drawVirtualWalls(walls: VirtualWallParam[]): void;
+    /**
+     * 获取所有虚拟墙数据
+     */
+    getVirtualWalls(): VirtualWallParam[];
+    /**
+     * 清除所有虚拟墙
+     */
+    clearAllVirtualWalls(): void;
+    /**
+     * 绘制定点清扫
+     */
+    drawSpots(spots: SpotParam[]): void;
+    /**
+     * 获取所有定点清扫数据
+     */
+    getSpots(): SpotParam[];
+    /**
+     * 清除所有定点清扫
+     */
+    clearAllSpots(): void;
+    /**
+     * 通用的绘制区域方法
+     */
+    private drawZones;
+    /**
+     * 添加新区域到 LAYER_CONTROLS
+     */
+    private addNewZone;
+    /**
+     * 移除区域
+     */
+    private removeZone;
+    /**
+     * 获取区域数据
+     */
+    private getZonesData;
+    /**
+     * 清除所有区域
+     */
+    private clearAllZones;
+    /**
+     * 更新区域编辑状态
+     */
+    private updateZonesEditState;
+    /**
+     * 更新虚拟墙编辑状态
+     */
+    private updateVirtualWallsEditState;
+    /**
+     * 比较两个区域数据是否相等
+     */
+    private isZoneDataEqual;
+    /**
+     * 获取虚拟墙数据
+     */
+    private getWallsData;
+    /**
+     * 清除所有虚拟墙
+     */
+    private clearAllWalls;
+    /**
+     * 比较两个虚拟墙是否相同
+     */
+    private isWallDataEqual;
+    /**
+     * 添加新定点清扫到 LAYER_CONTROLS
+     */
+    private addNewSpot;
+    /**
+     * 移除定点清扫
+     */
+    private removeSpot;
+    /**
+     * 获取定点清扫数据
+     */
+    private getSpotsData;
+    /**
+     * 清除所有定点清扫
+     */
+    private clearAllSpotsInternal;
+    /**
+     * 更新定点清扫编辑状态
+     */
+    private updateSpotsEditState;
+    /**
+     * 比较两个定点清扫数据是否相等
+     */
+    private isSpotDataEqual;
+    /**
+     * 处理分割房间ID变化
+     */
+    private handleDividingRoomIdChange;
+    /**
+     * 获取房间几何信息
+     */
+    private getRoomGeometry;
+    /**
+     * 创建默认分割线
+     */
+    private createDefaultDivider;
+    /**
+     * 清除分割线
+     */
+    private clearDivider;
+    /**
+     * 获取分割线数据
+     */
+    getDividerEndPoints(): Point[] | null;
+    /**
+     * 获取分割线有效端点
+     */
+    getEffectiveDividerPoints(): Point[] | null;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}
+
+/**
+ * 自定义元素参数
+ */
+export declare type CustomElementParam =
+| ImageCustomElementParam
+| GifCustomElementParam
+| HtmlCustomElementParam
+
+declare class CustomElementsManager {
+    private customElementsMap;
+    private gifTicker;
+    private gifElements;
+    constructor();
+    /**
+     * 根据地图原点更新所有自定义元素位置
+     */
+    updatePositionByOrigin(x: number, y: number): void;
+    /**
+     * 绘制自定义元素
+     */
+    drawCustomElements(elements: CustomElementParam[]): Promise<void>;
+    /**
+     * 清除所有自定义元素
+     */
+    clearAllCustomElements(): void;
+    /**
+     * 添加新的自定义元素
+     */
+    private addNewCustomElement;
+    /**
+     * 移除自定义元素
+     */
+    private removeCustomElement;
+    /**
+     * 检查数据是否相同（类型安全的辅助方法）
+     */
+    private isSameData;
+    /**
+     * 更新元素数据（类型安全的辅助方法）
+     */
+    private updateElementData;
+    /**
+     * 更新 GIF Ticker 状态
+     */
+    private updateGifTicker;
+    /**
+     * 启动 GIF Ticker
+     */
+    private startGifTicker;
+    /**
+     * 停止 GIF Ticker
+     */
+    private stopGifTicker;
+    /**
+     * 渲染 GIF 容器
+     */
+    private renderGifContainer;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}
+
+/**
+ * 递归地将类型的所有属性变为可选的
+ * @template T - 要处理的类型
+ */
+export declare type DeepPartial<T> =
+T extends Array<infer U>
+? Array<DeepPartial<U>>
+: T extends object
+? { [K in keyof T]?: DeepPartial<T[K]> }
+: T
+
+/** 深度可选的应用配置类型 */
+export declare type DeepPartialAppConfig = DeepPartial<AppConfig>
+
+/** 深度可选的运行时配置类型 */
+export declare type DeepPartialRuntimeConfig = DeepPartial<RuntimeConfig>
+
+declare class DetectedObjectManager {
+    private detectedObjectMap;
+    /**
+     * 根据地图原点更新所有检测物体位置
+     */
+    updatePositionByOrigin(x: number, y: number): void;
+    /**
+     * 绘制检测物体
+     */
+    drawDetectedObjects(objects: DetectedObjectParam[]): Promise<void>;
+    /**
+     * 清除所有检测物体
+     */
+    clearAllDetectedObjects(): void;
+    /**
+     * 添加新的检测物体
+     */
+    private addNewDetectedObject;
+    /**
+     * 移除检测物体
+     */
+    private removeDetectedObject;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}
+
+/**
+ * 检测物体参数
+ */
+export declare type DetectedObjectParam = {
+    /** ID */
+    id: string
+    /** 图片资源路径 */
+    src: string
+    /** X坐标 */
+    x: number
+    /** Y坐标 */
+    y: number
+    /** 高度 */
+    height?: number
+    /** 宽度 */
+    width?: number
+}
+
+/** 方向 */
+export declare type Direction = 'horizontal' | 'vertical'
+
+/** 分割线配置 */
+export declare type DividerConfig = {
+    /** 线条颜色 */
+    lineColor: ColorSource
+    /** 虚线线条宽度 */
+    dashLineWidth: number
+    /** 虚线线条配置 */
+    dashLineDashArray: [number, number]
+    /** 实线线条宽度 */
+    solidLineWidth: number
+    /** 端点大小 */
+    endPointSize: number
+    /** 端点颜色 */
+    endPointColor: ColorSource
+    /** 端点描边颜色 */
+    endPointStrokeColor: ColorSource
+    /** 端点描边宽度 */
+    endPointStrokeWidth: number
+    /** 热区厚度 */
+    hitAreaThickness: number
+    /** 当分割线完全处在房间外的时候是否重置分割线 */
+    resetDividerWhenOutOfRoom: boolean
+    /** 默认生成的分割线超出房间包围盒的像素值 */
+    defaultExtension: number
+    /** 默认生成的分割线方向 */
+    defaultDirection: Direction
+}
+
+/**
+ * 固定大小动画精灵基类
+ * 基于 EnhancedSprite 扩展，支持帧动画播放
+ *
+ * 两种模式：
+ * 1. sizeFixed: true - 固定屏幕像素大小，不受地图缩放影响
+ * 2. sizeFixed: false - 以地图scale=1为基准，跟随地图缩放
+ */
+declare class EnhancedAnimatedSprite extends AnimatedSprite {
+    private throttledUpdateScale;
+    private fixedWidth;
+    private fixedHeight;
+    private isFixedSizeSet;
+    private sizeFixed;
+    private baselineScale;
+    private static animationTicker;
+    private static animatedSprites;
+    constructor(textures?: Texture[]);
+    /**
+     * 设置固定的屏幕像素大小
+     * @param width 屏幕上显示的固定宽度（像素）
+     * @param height 屏幕上显示的固定高度（像素）
+     */
+    setFixedSize(width: number, height: number): void;
+    /**
+     * 设置是否启用固定大小模式
+     * @param enabled 是否启用固定大小模式
+     */
+    setSizeFixed(enabled: boolean): void;
+    /**
+     * 重写 width setter，确保使用固定大小逻辑
+     */
+    set width(value: number);
+    /**
+     * 重写 height setter，确保使用固定大小逻辑
+     */
+    set height(value: number);
+    /**
+     * 重写 width getter，返回固定宽度
+     */
+    get width(): number;
+    /**
+     * 重写 height getter，返回固定高度
+     */
+    get height(): number;
+    /**
+     * 注册缩放事件监听
+     */
+    private registerScaleListener;
+    /**
+     * 应用大小（统一处理两种模式）
+     */
+    private applySize;
+    /**
+     * 更新元素缩放，以保持正确大小
+     */
+    protected updateScale(scale: number): void;
+    /**
+     * 静态方法：加载动画纹理
+     * @param jsonSrc 动画JSON资源路径
+     * @param framePrefix 帧名称前缀，例如 "sleep_"
+     * @param frameCount 帧数量
+     * @returns Promise<Texture[]> 纹理数组
+     */
+    static loadAnimationTextures(jsonSrc: string, framePrefix?: string, frameCount?: number): Promise<Texture[]>;
+    /**
+     * 设置动画配置
+     * @param iconConfig 图标配置
+     */
+    setupAnimation(iconConfig: IconConfig): void;
+    /**
+     * 通用绘制方法
+     * @param params 绘制参数
+     * @param visibilityCondition 可选的可见性条件函数
+     */
+    draw(params: IconPoint, visibilityCondition?: () => boolean): void;
+    /**
+     * 开始播放动画
+     */
+    play(): void;
+    /**
+     * 停止播放动画
+     */
+    stop(): void;
+    /**
+     * 重写 textures setter，在设置新纹理后重新应用固定大小
+     */
+    set textures(value: Texture[]);
+    /**
+     * 重写 textures getter
+     */
+    get textures(): Texture[];
+    /**
+     * 启动动画 Ticker
+     */
+    private static startAnimationTicker;
+    /**
+     * 更新动画 Ticker 状态
+     */
+    private static updateAnimationTicker;
+    /**
+     * 停止动画 Ticker
+     */
+    private static stopAnimationTicker;
+    /**
+     * 更新所有动画
+     */
+    private static updateAnimations;
+    /**
+     * 组件销毁时清理资源
+     */
+    destroy(options?: {
+        children?: boolean;
+        texture?: boolean;
+        baseTexture?: boolean;
+    }): void;
+}
+
+/**
+ * 固定大小精灵基类
+ * 用于创建在地图缩放时保持固定视觉大小的精灵元素
+ *
+ * 两种模式：
+ * 1. sizeFixed: true - 固定屏幕像素大小，不受地图缩放影响
+ * 2. sizeFixed: false - 以地图scale=1为基准，跟随地图缩放
+ */
+declare class EnhancedSprite extends Sprite {
+    private throttledUpdateScale;
+    private fixedWidth;
+    private fixedHeight;
+    private isFixedSizeSet;
+    private sizeFixed;
+    private baselineScale;
+    constructor(texture?: Texture);
+    /**
+     * 设置固定的屏幕像素大小
+     * @param width 屏幕上显示的固定宽度（像素）
+     * @param height 屏幕上显示的固定高度（像素）
+     */
+    setFixedSize(width: number, height: number): void;
+    /**
+     * 设置是否启用固定大小模式
+     * @param enabled 是否启用固定大小模式
+     */
+    setSizeFixed(enabled: boolean): void;
+    /**
+     * 重写 width setter，确保使用固定大小逻辑
+     */
+    set width(value: number);
+    /**
+     * 重写 height setter，确保使用固定大小逻辑
+     */
+    set height(value: number);
+    /**
+     * 重写 width getter，返回固定宽度
+     */
+    get width(): number;
+    /**
+     * 重写 height getter，返回固定高度
+     */
+    get height(): number;
+    /**
+     * 注册缩放事件监听
+     */
+    private registerScaleListener;
+    /**
+     * 应用大小（统一处理两种模式）
+     */
+    private applySize;
+    /**
+     * 更新元素缩放，以保持正确大小
+     */
+    protected updateScale(scale: number): void;
+    /**
+     * 异步加载纹理并设置大小
+     * @param assetKey 资源键名 或 资源src
+     * @param iconConfig 图标配置（需要包含sizeFixed属性）
+     */
+    loadTextureAndSetSize(src: string, iconConfig: IconConfig): Promise<void>;
+    /**
+     * 通用绘制方法
+     * @param params 绘制参数
+     * @param visibilityCondition 可选的可见性条件函数
+     */
+    draw(params: IconPoint, visibilityCondition?: () => boolean): void;
+    /**
+     * 重写 texture setter，在设置新纹理后重新应用固定大小
+     */
+    set texture(value: Texture);
+    /**
+     * 重写 texture getter
+     */
+    get texture(): Texture;
+    /**
+     * 组件销毁时清理资源
+     */
+    destroy(options?: {
+        children?: boolean;
+        texture?: boolean;
+        baseTexture?: boolean;
+    }): void;
+}
+
+/**
+ * GIF 类型自定义元素参数
+ * 保持现有逻辑
+ */
+export declare type GifCustomElementParam = BaseCustomElementParam & {
+    /** 元素类型 */
+    type: 'gif'
+    /** GIF资源路径 */
+    src: string
+    /** GIF宽度（必需 - GIF 需要明确尺寸） */
+    width: number
+    /** GIF高度（必需 - GIF 需要明确尺寸） */
+    height: number
+}
+
+declare class Heatmap extends Container {
+    colorGradients: Array<string>;
+    cellSize: number;
+    constructor();
+    /**
+     * 绘制热力图
+     * @param grid 处理好的热力数据 每个网格的信号强度 和 坐标
+     * @param useGradient 是否使用渐变绘制
+     */
+    draw(grid: Array<Array<{
+        x: number;
+        y: number;
+        signal: number;
+        hasPoint: boolean;
+    }>>, useGradient?: boolean, heatmapAlpha?: number): void;
+    /**
+     * 裁剪热力图 仅显示房间区域
+     * 根据roomFill图层的子元素 组合Graphics生成大Graphics裁剪
+     * @param heatmap 热力图mesh
+     */
+    private croppingHeatmap;
+    /**
+     * 网格绘制热力图 我网格模式
+     * @param grid 处理好的热力数据 每个网格的信号强度 和 坐标
+     * @returns 网格热力图mesh
+     */
+    private gridDrawing;
+    /**
+     * 渐变绘制热力图
+     * @param grid 处理好的热力数据 每个网格的信号强度 和 坐标
+     * @returns 渐变热力图mesh
+     */
+    private gradientDrawing;
+    /**
+     * 关闭纹理缓存
+     */
+    closeCacheAsTexture(): void;
+}
+
+declare class HeatmapManager {
+    heatmap: Heatmap;
+    pointsTopLeftOrigin: HeatmapPoint[];
+    signalGrid: Array<Array<{
+        x: number;
+        y: number;
+        signal: number;
+        hasPoint: boolean;
+    }>>;
+    cellSize: number;
+    maxDistance: number;
+    smoothIterations: number;
+    heatmapAlpha: number;
+    constructor();
+    /**
+     * 绘制热力图
+     * @param mapData 地图数据
+     * @param heatmapPoints 热力图点
+     * @param useGradient 是否使用渐变绘制
+     * @returns
+     */
+    draw({ mapData, heatmapPoints, useGradient, }: {
+        mapData: MapDataSource;
+        heatmapPoints: HeatmapPoint[];
+        useGradient?: boolean;
+    }): void;
+    /**
+     * 插值计算信号网格
+     * @param pointsTopLeftOrigin 热力图路径点
+     * @returns 信号网格
+     */
+    calculateInterpolatedSignal(pointsTopLeftOrigin: HeatmapPoint[]): {
+        x: number;
+        y: number;
+        signal: number;
+        hasPoint: boolean;
+    }[][];
+}
+
+/** 热力图点 */
+export declare type HeatmapPoint = Point & {
+    /** 信号强度 */
+    signal: number
+}
+
+/**
+ * HTML 类型自定义元素参数
+ * 支持动态尺寸
+ */
+export declare type HtmlCustomElementParam = BaseCustomElementParam & {
+    /** 元素类型 */
+    type: 'html'
+    /** HTML内容 */
+    htmlContent: string
+    /** 宽度 */
+    width?: number
+    /** 高度 */
+    height?: number
+}
+
+/** 图标配置 */
+export declare type IconConfig = IconSize & {
+    /** 尺寸是否固定 */
+    sizeFixed?: boolean
+}
+
+/**
+ * 图标坐标点
+ * 包含位置和可选的旋转角度
+ */
+export declare type IconPoint = Point & {
+    /** 旋转角度（度） */
+    rotation?: number
+}
+
+/** 图标尺寸 */
+export declare type IconSize = {
+    /** 宽度 */
+    width: number
+    /** 高度 */
+    height: number
+}
+
+/**
+ * Image 类型自定义元素参数
+ * 保持现有逻辑
+ */
+export declare type ImageCustomElementParam = BaseCustomElementParam & {
+    /** 元素类型 */
+    type: 'image'
+    /** 图片资源路径 */
+    src: string
+    /** 图片宽度（必需 - 图片需要明确尺寸） */
+    width: number
+    /** 图片高度（必需 - 图片需要明确尺寸） */
+    height: number
+}
+
+/* Excluded from this release type: InstanceEvents */
+
+declare class Interaction extends Container {
+    dragStart: {
+        x: number;
+        y: number;
+    } | null;
+    initialTouchDistance: number | null;
+    initialScale: {
+        x: number;
+        y: number;
+    } | null;
+    activeTouches: Map<number, {
+        x: number;
+        y: number;
+    }>;
+    firstTouchId: number | null;
+    secondTouchId: number | null;
+    zoomFactor: number;
+    scaleMin: number;
+    scaleMax: number;
+    originalPosition: {
+        x: number;
+        y: number;
+    };
+    targetPosition: {
+        x: number;
+        y: number;
+    };
+    centerPosition: {
+        x: number;
+        y: number;
+    };
+    originalScale: {
+        x: number;
+        y: number;
+    };
+    targetScale: {
+        x: number;
+        y: number;
+    };
+    defaultScale: {
+        x: number;
+        y: number;
+    };
+    transitionDuration: number;
+    transitionStartTime: number | null;
+    initialPinchCenter: Point | null;
+    isGestureValid: boolean;
+    lastTapTime: number;
+    doubleTapDelay: number;
+    doubleTapZoomFactor: number;
+    lastTapPosition: Point | null;
+    tapDistanceThreshold: number;
+    tapDetectionEnabled: boolean;
+    private isGestureHijacked;
+    private hijackedPointerId;
+    private isHijackPaused;
+    private interactionGraphics;
+    private viewportBounds;
+    private boundResetAnimation;
+    private debouncedStopWheelRender;
+    private interactionState;
+    constructor();
+    setupInteraction(): void;
+    resetPan(targetPosition: {
+        x: number;
+        y: number;
+    }): void;
+    /**
+     * 设置地图的位置和缩放，可选择是否使用动画过渡
+     * @param options 缩放和位置选项
+     * @param animate 是否使用动画，默认为 true
+     */
+    setPanZoom({ targetPosition, targetScale, setCenter, setScale, }?: {
+        targetPosition?: {
+            x: number;
+            y: number;
+        };
+        targetScale?: {
+            x: number;
+            y: number;
+        };
+        setCenter?: boolean;
+        setScale?: boolean;
+    }, animate?: boolean): void;
+    clearTouches(): void;
+    /**
+     * 检查事件监听器状态 - 调试用
+     */
+    checkEventListeners(): {
+        wheel: number;
+        pointerdown: number;
+        pointerup: number;
+        pointerupoutside: number;
+        pointermove: number;
+    };
+    /**
+     * 销毁时清理事件监听
+     */
+    destroy(): void;
+    /**
+     * 处理手势劫持
+     */
+    private handleGestureHijacked;
+    /**
+     * 退出手势劫持模式
+     */
+    private exitGestureHijacked;
+    /**
+     * 暂停手势劫持（双指模式）
+     */
+    private pauseGestureHijack;
+    /**
+     * 恢复手势劫持（回到单指模式）
+     */
+    private resumeGestureHijack;
+    private antiScale;
+    private resetAnimation;
+    private onWheel;
+    private onPointerDown;
+    private onPointerUp;
+    private detectDoubleTap;
+    private handleDoubleTap;
+    private onPointerMove;
+    private applyPan;
+    private applyPinchZoom;
+    private setInitialScaleAndDistance;
+}
+
+declare type LayerName = (typeof LAYERS)[number];
+
+declare const LAYERS: string[];
+
+/** 管理器类型定义 */
+declare type Managers = {
+    mapManager: MapManager;
+    heatmapManager: HeatmapManager;
+    pathManager: PathManager;
+    controlsManager: ControlsManager;
+    detectedObjectManager: DetectedObjectManager;
+    customElementsManager: CustomElementsManager;
+    roomsManager: RoomManager;
+};
+
+export declare const MAP_API_METHODS: readonly ["resetPanZoom", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "snapshot", "snapshotByData"];
+
+export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickDetectedObject", "onClickCustomElement"];
+
+/**
+ * 地图 API 接口定义
+ *
+ * 这个接口定义了所有可供调用的地图操作方法。
+ *
+ * 通过onMapReady回调获得的 `mapApi` 对象实现了这个接口。
+ *
+ */
+export declare interface MapApi {
+    /**
+     * 重置地图的平移和缩放状态
+     *
+     * 将地图的缩放和平移状态重置到初始位置，使地图完整显示在视口中。
+     */
+    resetPanZoom(): void;
+    /**
+     * 获取当前地图上所有禁扫区域数据
+     *
+     * @returns 区域数据数组
+     */
+    getForbiddenSweepZones(): ZoneParam[];
+    /**
+     * 获取当前地图上所有禁拖区域数据
+     *
+     * @returns 区域数据数组
+     */
+    getForbiddenMopZones(): ZoneParam[];
+    /**
+     * 获取当前地图上所有清扫区域数据
+     *
+     * @returns 区域数据数组
+     */
+    getCleanZones(): ZoneParam[];
+    /**
+     * 获取当前地图上所有虚拟墙数据
+     *
+     * @returns 虚拟墙数据数组
+     */
+    getVirtualWalls(): VirtualWallParam[];
+    /**
+     * 获取当前地图上所有定点清扫数据
+     *
+     * @returns 定点清扫数据数组
+     */
+    getSpots(): SpotParam[];
+    /**
+     * 获取分割线有效端点
+     * @returns 分割线有效端点
+     */
+    getEffectiveDividerPoints(): Point[] | null;
+    /**
+     * 获取分割线端点
+     * @returns 分割线端点
+     */
+    getDividerEndPoints(): Point[] | null;
+    /**
+     * 获取当前视口中心点坐标
+     *
+     * 返回当前视口中心点在地图坐标系中的位置，坐标相对于地图原点。
+     * 该坐标可以直接用于创建禁区、虚拟墙等控制元素。
+     *
+     * @returns 视口中心的相对坐标，如果地图未初始化则返回 null
+     */
+    getViewportCenterPoint(): Point | null;
+    /**
+     * 获取地图中心点坐标
+     *
+     * 返回地图包围盒中心点在地图坐标系中的位置，坐标相对于地图原点。
+     * 该坐标基于地图边界计算，可以直接用于创建控制元素。
+     *
+     * @returns 地图中心的相对坐标，如果地图未初始化则返回 null
+     */
+    getMapCenterPoint(): Point | null;
+    /**
+     * 基于视口中心生成虚拟墙端点坐标
+     *
+     * 根据当前视口中心位置生成虚拟墙的两个端点坐标，支持自定义长度、方向和偏移。
+     *
+     * @param options - 配置选项
+     * @param options.width - 虚拟墙长度，单位米，默认使用配置中的最小宽度
+     * @param options.direction - 虚拟墙方向，'horizontal' 或 'vertical'，默认为 'horizontal'
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 虚拟墙的两个端点坐标数组
+     */
+    getWallPointsByViewportCenter(options?: {
+        width?: number;
+        direction?: Direction;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成禁扫区域顶点坐标
+     *
+     * 根据当前视口中心位置生成禁扫区域的四个顶点坐标。
+     *
+     * @param options - 配置选项
+     * @param options.size - 区域大小，单位米，默认使用配置中的最小尺寸
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 禁扫区域的四个顶点坐标数组
+     */
+    getForbiddenSweepZonePointsByViewportCenter(options?: {
+        size?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成禁拖区域顶点坐标
+     *
+     * 根据当前视口中心位置生成禁拖区域的四个顶点坐标。
+     *
+     * @param options - 配置选项
+     * @param options.size - 区域大小，单位米，默认使用配置中的最小尺寸
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 禁拖区域的四个顶点坐标数组
+     */
+    getForbiddenMopZonePointsByViewportCenter(options?: {
+        size?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成清扫区域顶点坐标
+     *
+     * 根据当前视口中心位置生成清扫区域的四个顶点坐标。
+     *
+     * @param options - 配置选项
+     * @param options.size - 区域大小，单位米，默认使用配置中的最小尺寸
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 清扫区域的四个顶点坐标数组
+     */
+    getCleanZonePointsByViewportCenter(options?: {
+        size?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成定点清扫的点坐标
+     *
+     * 根据当前视口中心位置生成定点清扫的坐标点。
+     *
+     * @param options - 配置选项
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 定点清扫的坐标点
+     */
+    getSpotPointByViewportCenter(options?: {
+        offsetX?: number;
+        offsetY?: number;
+    }): Point;
+    /**
+     * 地图截图
+     *
+     * 将当前地图状态导出为图片，支持多种格式和质量设置。
+     *
+     * @returns Promise<string> Base64 格式的图片数据
+     */
+    snapshot(): Promise<string>;
+    /**
+     * 使用其他地图数据进行截图
+     *
+     * 基于提供的地图数据生成截图，主要用于多地图场景或预览功能。
+     * 不会影响当前地图的显示状态。
+     *
+     * @param data - 地图数据对象
+     * @param data.map - 地图字符串数据
+     * @param data.path - 可选的路径数据
+     * @param data.roomProperties - 可选的房间属性数据
+     * @param data.customElements - 可选的自定义元素数据
+     * @param data.forbiddenSweepZones - 可选的禁扫区域数据
+     * @param data.forbiddenMopZones - 可选的禁拖区域数据
+     * @param data.virtualWalls - 可选的虚拟墙数据
+     * @param data.detectedObjects - 可选的检测物体数据
+     * @param runtime - 可选的运行时配置
+     * @returns Promise<string> Base64 格式的图片数据
+     */
+    snapshotByData(data: {
+        map: string;
+        path?: string;
+        roomProperties?: RoomProperty[];
+        customElements?: CustomElementParam[];
+        forbiddenSweepZones?: ZoneParam[];
+        forbiddenMopZones?: ZoneParam[];
+        virtualWalls?: VirtualWallParam[];
+        detectedObjects?: DetectedObjectParam[];
+    }, runtime?: DeepPartialRuntimeConfig): Promise<string>;
+}
+
+/**
+ * 地图应用核心类
+ *
+ * 地图应用的核心类，继承自 PIXI.Application，提供完整的地图渲染、交互和管理功能。
+ * 支持扫地机器人地图的显示、路径绘制、房间管理、控制元素（禁区、虚拟墙等）等功能。
+ */
+export declare class MapApplication extends Application implements MapApi {
+    /** 地图状态对象 */
+    mapState: MapState | null;
+    /* Excluded from this release type: components */
+    /* Excluded from this release type: managers */
+    /* Excluded from this release type: config */
+    /* Excluded from this release type: runtime */
+    /* Excluded from this release type: scaleMin */
+    /* Excluded from this release type: scaleMax */
+    /* Excluded from this release type: events */
+    /* Excluded from this release type: instanceKey */
+    /* Excluded from this release type: emitter */
+    /* Excluded from this release type: tickerState */
+    private pendingAsyncRender;
+    private isFirstMapDraw;
+    /* Excluded from this release type: __constructor */
+    /**
+     * 初始化地图应用
+     *
+     * 设置应用配置、运行时参数、事件处理器，并初始化所有必要的组件和管理器。
+     *
+     * @param options - 初始化选项，包含PIXI应用选项和地图应用选项
+     * @param options.resizeTo - 画布大小调整目标元素
+     * @param options.events - 事件回调
+     * @param options.config - 静态配置
+     * @param options.runtime - 运行时
+     * @returns Promise<void>
+     *
+     */
+    initialize(options: Partial<ApplicationOptions> & AppOptions): Promise<void>;
+    /**
+     * 绘制结构化地图数据
+     *
+     * 根据结构化的地图数据源绘制地图，包括房间、障碍物、充电桩等元素。
+     *
+     * @param mapData - 结构化地图数据源
+     * @returns Promise<void>
+     *
+     */
+    drawMap(mapData: MapDataSource): Promise<void>;
+    /**
+     * 绘制栅格地图数据
+     *
+     * 根据点阵地图数据绘制地图，支持点阵格式的地图数据。
+     *
+     * @param rasterMapData - 栅格地图数据对象
+     * @param rasterMapData.mapHeader - 地图头部信息，包含分辨率、原点等
+     * @param rasterMapData.mapData - 地图像素数据
+     * @returns Promise<void>
+     *
+     */
+    drawRasterMap(rasterMapData: {
+        mapHeader: MapHeader;
+        mapData: MapData;
+    }): Promise<void>;
+    /**
+     * 绘制机器人路径
+     *
+     * 根据路径数据绘制机器人的移动轨迹，包括普通路径、充电路径等不同类型。
+     *
+     * @param pathData - 路径数据对象
+     * @returns void
+     *
+     */
+    drawPath(pathData: PathData): void;
+    /**
+     * 绘制房间属性信息
+     *
+     * 绘制房间的详细属性信息，如吸力、水量、清扫次数等。
+     *
+     * @param roomInfos - 房间属性信息数组
+     * @returns void
+     *
+     */
+    drawRoomProperty(roomInfos: RoomProperty[]): Promise<void>;
+    /**
+     * 绘制热力图
+     * @param param - 绘制参数
+     * @returns void
+     *
+     */
+    drawHeatmap({ mapData, heatmapPoints, useGradient, }: {
+        mapData: MapDataSource;
+        heatmapPoints: HeatmapPoint[];
+        useGradient?: boolean;
+    }): void;
+    /**
+     * 绘制禁扫区域
+     * @param zones - 禁扫区域参数数组
+     */
+    drawForbiddenSweepZones(zones: ZoneParam[]): void;
+    /**
+     * 绘制禁拖区域
+     * @param zones - 禁拖区域参数数组
+     */
+    drawForbiddenMopZones(zones: ZoneParam[]): void;
+    /**
+     * 绘制清扫区域
+     * @param zones - 清扫区域参数数组
+     */
+    drawCleanZones(zones: ZoneParam[]): void;
+    /**
+     * 绘制虚拟墙
+     * @param walls - 虚拟墙参数数组
+     */
+    drawVirtualWalls(walls: VirtualWallParam[]): void;
+    /**
+     * 绘制定点清扫点
+     * @param spots - 定点清扫参数数组
+     */
+    drawSpots(spots: SpotParam[]): void;
+    /**
+     * 绘制检测到的物体
+     * @param objects - 检测物体参数数组
+     */
+    drawDetectedObjects(objects: DetectedObjectParam[]): Promise<void>;
+    /**
+     * 绘制自定义元素
+     * @param elements - 自定义元素参数数组
+     */
+    drawCustomElements(elements: CustomElementParam[]): Promise<void>;
+    /**
+     * 获取当前地图上所有禁扫区域数据
+     *
+     * @returns 区域数据数组
+     */
+    getForbiddenSweepZones(): ZoneParam[];
+    /**
+     * 获取当前地图上所有禁拖区域数据
+     *
+     * @returns 区域数据数组
+     */
+    getForbiddenMopZones(): ZoneParam[];
+    /**
+     * 获取当前地图上所有清扫区域数据
+     *
+     * @returns 区域数据数组
+     */
+    getCleanZones(): ZoneParam[];
+    /**
+     * 获取当前地图上所有虚拟墙数据
+     *
+     * @returns 虚拟墙数据数组
+     */
+    getVirtualWalls(): VirtualWallParam[];
+    /**
+     * 获取当前地图上所有定点清扫数据
+     *
+     * @returns 定点清扫数据数组
+     */
+    getSpots(): SpotParam[];
+    /**
+     * 获取分割线有效端点
+     * @returns 分割线有效端点
+     */
+    getEffectiveDividerPoints(): Point[] | null;
+    /**
+     * 获取分割线端点
+     * @returns 分割线端点
+     *
+     */
+    getDividerEndPoints(): Point[] | null;
+    /**
+     * 重置地图的平移和缩放状态
+     *
+     * 将地图的缩放和平移状态重置到初始位置，使地图完整显示在视口中。
+     */
+    resetPanZoom(): void;
+    /**
+     * 将地图适配到视图中，居中并缩放
+     * @param mapBounds 地图边界信息
+     * @param animate 是否使用动画过渡，默认为 false
+     * @param shouldCache 是否缓存为纹理，默认为 true
+     */
+    fitMapToView(mapBounds: Bounds, animate?: boolean, shouldCache?: boolean): void;
+    /**
+     * 获取视口边界（供 Interaction 等组件使用）
+     */
+    getViewportBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * 更新运行时配置
+     *
+     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
+     *
+     * @param runtime - 要更新的运行时配置
+     */
+    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
+    /**
+     * 将米转换为像素
+     *
+     * 根据地图分辨率将米单位转换为像素单位。
+     *
+     * @param meters - 米数值
+     * @returns 像素值
+     */
+    metersToPixels(meters: number): number;
+    /**
+     * 将像素转换为米
+     *
+     * 根据地图分辨率将像素单位转换为米单位。
+     *
+     * @param pixels - 像素值
+     * @returns 米数值
+     */
+    pixelsToMeters(pixels: number): number;
+    /**
+     * 将基础尺寸转换为固定显示尺寸（不受缩放影响）
+     *
+     * 基础尺寸是基于 scale=1 的标准尺寸，需要根据当前缩放级别进行调整。
+     *
+     * @param baseSize - 基础尺寸
+     * @param currentScale - 当前缩放级别，不传则自动获取
+     * @returns 固定显示尺寸
+     */
+    toFixedSize(baseSize: number, currentScale?: number): number;
+    /**
+     * 将固定显示尺寸转换为基础尺寸（反向转换）
+     *
+     * @param fixedSize - 固定显示尺寸
+     * @param currentScale - 当前缩放级别，不传则自动获取
+     * @returns 基础尺寸
+     */
+    fromFixedSize(fixedSize: number, currentScale?: number): number;
+    /**
+     * 获取当前视口中心点坐标
+     *
+     * 返回当前视口中心点在地图坐标系中的位置，坐标相对于地图原点。
+     * 该坐标可以直接用于创建禁区、虚拟墙等控制元素。
+     *
+     * @returns 视口中心的相对坐标，如果地图未初始化则返回 null
+     */
+    getViewportCenterPoint(): Point | null;
+    /**
+     * 获取地图中心点坐标
+     *
+     * 返回地图包围盒中心点在地图坐标系中的位置，坐标相对于地图原点。
+     * 该坐标基于地图边界计算，可以直接用于创建控制元素。
+     *
+     * @returns 地图中心的相对坐标，如果地图未初始化则返回 null
+     */
+    getMapCenterPoint(): Point | null;
+    /**
+     * 基于视口中心生成虚拟墙端点坐标
+     *
+     * 根据当前视口中心位置生成虚拟墙的两个端点坐标，支持自定义长度、方向和偏移。
+     *
+     * @param options - 配置选项
+     * @param options.width - 虚拟墙长度，单位米，默认使用配置中的最小宽度
+     * @param options.direction - 虚拟墙方向，'horizontal' 或 'vertical'，默认为 'horizontal'
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 虚拟墙的两个端点坐标数组
+     */
+    getWallPointsByViewportCenter(options?: {
+        width?: number;
+        direction?: Direction;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成禁扫区域顶点坐标
+     *
+     * 根据当前视口中心位置生成禁扫区域的四个顶点坐标。
+     *
+     * @param options - 配置选项
+     * @param options.size - 区域大小，单位米，默认使用配置中的最小尺寸
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 禁扫区域的四个顶点坐标数组
+     */
+    getForbiddenSweepZonePointsByViewportCenter(options?: {
+        size?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成禁拖区域顶点坐标
+     *
+     * 根据当前视口中心位置生成禁拖区域的四个顶点坐标。
+     *
+     * @param options - 配置选项
+     * @param options.size - 区域大小，单位米，默认使用配置中的最小尺寸
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 禁拖区域的四个顶点坐标数组
+     */
+    getForbiddenMopZonePointsByViewportCenter(options?: {
+        size?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成清扫区域顶点坐标
+     *
+     * 根据当前视口中心位置生成清扫区域的四个顶点坐标。
+     *
+     * @param options - 配置选项
+     * @param options.size - 区域大小，单位米，默认使用配置中的最小尺寸
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 清扫区域的四个顶点坐标数组
+     */
+    getCleanZonePointsByViewportCenter(options?: {
+        size?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于视口中心生成定点清扫的点坐标
+     *
+     * 根据当前视口中心位置生成定点清扫的坐标点。
+     *
+     * @param options - 配置选项
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 定点清扫的坐标点
+     */
+    getSpotPointByViewportCenter(options?: {
+        offsetX?: number;
+        offsetY?: number;
+    }): Point;
+    /**
+     * 地图截图
+     *
+     * 将当前地图状态导出为图片，支持多种格式和质量设置。
+     *
+     * @returns Promise<string> Base64 格式的图片数据
+     *
+     */
+    snapshot(): Promise<string>;
+    /**
+     * 使用其他地图数据进行截图
+     *
+     * 基于提供的地图数据生成截图，主要用于多地图场景或预览功能。
+     * 不会影响当前地图的显示状态。
+     *
+     * @param data - 地图数据对象
+     * @param data.map - 地图字符串数据
+     * @param data.path - 可选的路径数据
+     * @param data.roomProperties - 可选的房间属性数据
+     * @param data.customElements - 可选的自定义元素数据
+     * @param data.forbiddenSweepZones - 可选的禁扫区域数据
+     * @param data.forbiddenMopZones - 可选的禁拖区域数据
+     * @param data.virtualWalls - 可选的虚拟墙数据
+     * @param data.detectedObjects - 可选的检测物体数据
+     * @param runtime - 可选的运行时配置
+     * @returns Promise<string> Base64 格式的图片数据
+     *
+     */
+    snapshotByData({ map, path, roomProperties, customElements, forbiddenSweepZones, forbiddenMopZones, virtualWalls, detectedObjects, }: {
+        map: string;
+        path?: string;
+        roomProperties?: RoomProperty[];
+        customElements?: CustomElementParam[];
+        forbiddenSweepZones?: ZoneParam[];
+        forbiddenMopZones?: ZoneParam[];
+        virtualWalls?: VirtualWallParam[];
+        detectedObjects?: DetectedObjectParam[];
+    }, runtime?: DeepPartialRuntimeConfig): Promise<string>;
+    /* Excluded from this release type: renderOnce */
+    /* Excluded from this release type: renderOnceNextFrame */
+    /* Excluded from this release type: requestRender */
+    /* Excluded from this release type: stopRender */
+    /**
+     * 销毁地图应用实例
+     *
+     * 清理所有资源、事件监听器和管理器，确保内存不泄漏。
+     */
+    destroy(): void;
+    /**
+     * 初始化视口容器
+     */
+    private initializeViewportContainer;
+    /**
+     * 初始化应用容器
+     */
+    private initializeAppContainer;
+    private initializeInteraction;
+    /**
+     * 智能 Ticker 管理 - 延迟停止渲染
+     */
+    private scheduleStopRender;
+    /**
+     * 通用的Zone点生成逻辑
+     */
+    private generateZonePoints;
+    /**
+     * 预加载应用所需的资源
+     */
+    private preloadAssets;
+    private onVisibilityChange;
+}
+
+/**
+ * 地图事件回调接口
+ *
+ * 定义了地图组件的所有事件回调函数，用于处理地图的各种交互和状态变化。
+ * 开发者可以通过传入这些回调函数来响应地图的各种事件。
+ *
+ */
+export declare interface MapCallbacks {
+    /**
+     * 地图首次绘制完成回调
+     *
+     * 当地图首次加载并绘制完成后触发，通常用于移除Loading状态。
+     * 与 onMapDrawed 不同，此回调只在首次绘制时触发一次。
+     *
+     * @param mapState - 地图状态信息，包含地图ID、原点、尺寸等信息
+     */
+    onMapFirstDrawed?: (mapState: MapState) => void;
+    /**
+     * 地图绘制完成回调
+     *
+     * 当地图数据解析并绘制完成后触发。
+     *
+     * @param mapState - 地图状态信息，包含地图ID、原点、尺寸等信息
+     *
+     */
+    onMapDrawed?: (mapState: MapState) => void;
+    /**
+     * 路径绘制完成回调
+     *
+     * 当机器人路径数据绘制完成后触发。
+     *
+     * @param pathState - 路径状态信息，包含路径ID、类型、机器人位置等
+     *
+     */
+    onPathDrawed?: (pathState: PathState) => void;
+    /**
+     * 房间信息绘制完成回调
+     *
+     * 当房间属性信息绘制完成后触发。
+     *
+     * @param rooms - 房间属性信息数组
+     *
+     */
+    onRoomPropertiesDrawed?: (rooms: RoomProperty[]) => void;
+    /**
+     * 点击房间回调
+     *
+     * 当用户点击地图上的房间区域时触发。
+     *
+     * @param room - 被点击的房间信息
+     *
+     */
+    onClickRoom?: (room: Partial<RoomData>) => void;
+    /**
+     * 点击房间信息回调
+     *
+     * 当用户点击房间的属性信息图标时触发。
+     *
+     * @param room - 被点击的房间信息
+     *
+     */
+    onClickRoomProperties?: (room: Partial<RoomData>) => void;
+    /**
+     * 点击禁扫区域删除按钮的回调
+     *
+     * 当用户点击禁扫区域删除按钮时触发。
+     *
+     * @param id - 被删除的禁扫区域ID
+     *
+     */
+    onRemoveForbiddenSweepZone?: (id: string) => void;
+    /**
+     * 点击禁拖区域删除按钮的回调
+     *
+     * 当用户点击禁拖区域删除按钮时触发。
+     *
+     * @param id - 被删除的禁拖区域ID
+     *
+     */
+    onRemoveForbiddenMopZone?: (id: string) => void;
+    /**
+     * 点击清扫区域删除按钮的回调
+     *
+     * 当用户点击清扫区域删除按钮时触发。
+     *
+     * @param id - 被删除的清扫区域ID
+     *
+     */
+    onRemoveCleanZone?: (id: string) => void;
+    /**
+     * 点击虚拟墙删除按钮的回调
+     *
+     * 当用户点击虚拟墙删除按钮时触发。
+     *
+     * @param id - 被删除的虚拟墙ID
+     *
+     */
+    onRemoveVirtualWall?: (id: string) => void;
+    /**
+     * 更新禁扫区域的回调
+     *
+     * 当用户操作禁扫区域（如拖拽、缩放）后触发。
+     *
+     * @param zone - 更新后的禁扫区域数据
+     *
+     */
+    onUpdateForbiddenSweepZone?: (zone: ZoneParam) => void;
+    /**
+     * 更新禁拖区域的回调
+     *
+     * 当用户操作禁拖区域（如拖拽、缩放）后触发。
+     *
+     * @param zone - 更新后的禁拖区域数据
+     *
+     */
+    onUpdateForbiddenMopZone?: (zone: ZoneParam) => void;
+    /**
+     * 更新清扫区域的回调
+     *
+     * 当用户操作清扫区域（如拖拽、缩放）后触发。
+     *
+     * @param zone - 更新后的清扫区域数据
+     *
+     */
+    onUpdateCleanZone?: (zone: ZoneParam) => void;
+    /**
+     * 更新虚拟墙的回调
+     *
+     * 当用户操作虚拟墙（如拖拽、旋转）后触发。
+     *
+     * @param wall - 更新后的虚拟墙数据
+     *
+     */
+    onUpdateVirtualWall?: (wall: VirtualWallParam) => void;
+    /**
+     * 更新定点清扫的回调
+     *
+     * 当用户操作定点清扫位置后触发。
+     *
+     * @param spot - 更新后的定点清扫数据
+     *
+     */
+    onUpdateSpot?: (spot: SpotParam) => void;
+    /**
+     * 点击禁扫区域回调
+     *
+     * 当用户点击禁扫区域时触发。
+     *
+     * @param zone - 被点击的禁扫区域数据
+     *
+     */
+    onClickForbiddenSweepZone?: (zone: ZoneParam) => void;
+    /**
+     * 点击禁拖区域回调
+     *
+     * 当用户点击禁拖区域时触发。
+     *
+     * @param zone - 被点击的禁拖区域数据
+     *
+     */
+    onClickForbiddenMopZone?: (zone: ZoneParam) => void;
+    /**
+     * 点击清扫区域回调
+     *
+     * 当用户点击清扫区域时触发。
+     *
+     * @param zone - 被点击的清扫区域数据
+     *
+     */
+    onClickCleanZone?: (zone: ZoneParam) => void;
+    /**
+     * 点击虚拟墙回调
+     *
+     * 当用户点击虚拟墙时触发。
+     *
+     * @param wall - 被点击的虚拟墙数据
+     *
+     */
+    onClickVirtualWall?: (wall: VirtualWallParam) => void;
+    /**
+     * 点击定点清扫回调
+     *
+     * 当用户点击定点清扫点时触发。
+     *
+     * @param spot - 被点击的定点清扫数据
+     *
+     */
+    onClickSpot?: (spot: SpotParam) => void;
+    /**
+     * 点击检测物体回调
+     *
+     * 当用户点击地图上的检测物体时触发。
+     *
+     * @param object - 被点击的检测物体数据
+     *
+     */
+    onClickDetectedObject?: (object: DetectedObjectParam) => void;
+    /**
+     * 点击自定义元素回调
+     *
+     * 当用户点击自定义元素时触发。
+     *
+     * @param element - 被点击的自定义元素数据
+     *
+     */
+    onClickCustomElement?: (element: CustomElementParam) => void;
+    /**
+     * 更新分割线回调
+     *
+     * 当用户操作分割线（如拖拽端点、移动整条线）后触发。
+     *
+     * @param divider - 更新后的分割线数据
+     *
+     */
+    onUpdateDivider?: (divider: Point[]) => void;
+}
+
+/**
+ * 结构化协议地图原始数据
+ */
+export declare type MapDataSource = {
+    /** 地图ID */
+    id: number
+    /** 状态 */
+    status: number
+    /** 分辨率 */
+    resolution: number
+    /** 尺寸 [宽度, 高度] */
+    size: [number, number]
+    /** 原点坐标 [x, y] */
+    origin: [number, number]
+    /** 充电桩信息 */
+    charger: {
+        /** 坐标 [x, y] */
+        coordinate: [number, number]
+        /** 充电桩朝向 */
+        angle: number
+    }
+    /** 地毯数据 */
+    carpet: Array<{
+        /** 坐标数组 */
+        coordinates: number[]
+        /** 类型 */
+        types: number
+    }>
+    /** 障碍物数据 */
+    obstacles: Array<{
+        /** 坐标数组 */
+        coordinates: number[]
+        /** 类型 */
+        types: number
+    }>
+    /** 自由区域数据 */
+    free: Array<{
+        /** 坐标数组 */
+        coordinates: number[]
+        /** 类型 */
+        types: number
+    }>
+    /** 房间数据 */
+    rooms: {
+        [roomId: string]: {
+            /** 坐标数组 */
+            coordinates: number[]
+        }
+    }
+    /** 版本 */
+    version: string
+}
+
+declare class MapManager {
+    obstacle: Obstacle;
+    roomFill: RoomFill;
+    carpet: Carpet;
+    chargingStation: ChargingStation;
+    mapBounds: Bounds;
+    private hasAutoFitted;
+    private roomGeometryMap;
+    private carpetData;
+    private unsubscribeFns;
+    constructor();
+    /**
+     * 处理结构化地图数据（房间形状、障碍物等）
+     */
+    drawMap(mapData: MapDataSource): Promise<boolean>;
+    /**
+     * 处理栅格地图数据
+     * @param mapPointsStr 栅格数据字符串
+     * @param width 地图宽度
+     * @param height 地图高度
+     * @param charger 充电桩信息
+     */
+    drawRasterMap(mapPointsStr: string, mapState: MapState): Promise<boolean>;
+    /**
+     * 重置几何数据和边界
+     */
+    private resetGeometryData;
+    /**
+     * 更新地毯显示
+     * 类似于RoomFloorType的模式，根据当前状态决定是否重建地毯
+     */
+    private createCarpet;
+    /**
+     * 处理房间几何数据，计算所有需要的几何信息
+     */
+    private processRoomsGeometry;
+    /**
+     * 合并所有图层的边界
+     */
+    private mergeLayerBounds;
+    /**
+     * 根据ID查找房间几何信息
+     */
+    getRoomById(id: number): Room | undefined;
+    /**
+     * 清空地图组件
+     */
+    private clearComponents;
+    /**
+     * 处理栅格数据，统一处理排序和颜色分配
+     * @param rasterData 原始栅格数据
+     * @returns 处理后的栅格数据，包含排序和颜色信息
+     */
+    private processRasterData;
+    /**
+     * 为栅格地图生成房间几何信息供 RoomManager 使用
+     * @param rasterData 解析后的栅格数据
+     */
+    private generateRoomGeometryFromRaster;
+    destroy(): void;
+}
+
+/**
+ * 地图状态对象
+ *
+ * 描述地图的基本信息和状态
+ */
+export declare type MapState = {
+    /** 地图ID */
+    id: number
+    /** 地图状态 */
+    status: boolean
+    /** 分辨率 */
+    resolution: number
+    /** 宽度 */
+    width: number
+    /** 高度 */
+    height: number
+    /** 原点坐标 */
+    origin: Point
+    /** 充电桩坐标 */
+    charger: Point
+    /** 充电桩方向 */
+    chargerDirection: number
+    /**
+     * 地图协议版本号
+     */
+    version?: number
+}
+
+declare class Obstacle extends Graphics {
+    constructor();
+    /**
+     * 绘制结构化障碍物数据
+     * @param obstacles 障碍物数据数组
+     */
+    draw(obstacles: {
+        coordinates: number[];
+    }[]): void;
+    /**
+     * 绘制栅格障碍物数据
+     * @param obstacleIndices 障碍物像素点索引数组
+     * @param width 地图宽度
+     */
+    drawRaster(obstacleIndices: Uint32Array, width: number): void;
+}
+
+/**
+ * 解析后的点阵地图数据
+ */
+export declare type ParsedRasterMapData = {
+    /** 障碍物像素点索引数组 */
+    obstacles: Uint32Array
+    /** 地毯像素点索引数组 */
+    carpet: Uint32Array
+    /** 房间ID -> 像素点索引数组（支持特殊房间ID） */
+    rooms: Map<number | SpecialRoomId, Uint32Array>
+    /** 地图宽度 */
+    width: number
+    /** 地图高度 */
+    height: number
+    /** 总像素数 */
+    totalPixels: number
+}
+
+declare class Path extends Container {
+    private commonPath;
+    private chargePath;
+    private transitionsPath;
+    private mopPath;
+    private pathData;
+    private lastPointCount;
+    private lastDrawnPosition;
+    private isRealTimeDrawing;
+    private throttledUpdateLineWidth;
+    private throttledHandleRobotPosition;
+    constructor();
+    /**
+     * 注册事件监听
+     */
+    private registerEventListeners;
+    /**
+     * 处理机器人动画完成事件
+     */
+    private handleRobotAnimationComplete;
+    /**
+     * 实际处理机器人位置更新的方法
+     */
+    private handleRobotPositionUpdate;
+    /**
+     * 更新线宽以响应缩放变化
+     */
+    private updateLineWidth;
+    /**
+     * 重新绘制路径，应用适当的线宽
+     * @param pathData 路径数据
+     */
+    private redrawPaths;
+    /**
+     * 设置各类路径的样式
+     */
+    private setupPathStyles;
+    /**
+     * 绘制路径线段
+     * @param pathPoints 路径点数组
+     */
+    private drawPathSegments;
+    updatePositionByOrigin(x: number, y: number): void;
+    /**
+     * 全量绘制路径
+     * @param pathData 路径数据
+     */
+    drawFull(pathData: PathData): void;
+    /**
+     * 增量绘制路径（启用实时绘制模式）
+     * @param pathData 路径数据
+     */
+    drawIncremental(pathData: PathData): void;
+    /**
+     * 直接绘制新增的路径段（用于速度为0的情况）
+     * @param newPoints 新增的路径点
+     * @param lastCount 上次绘制的点数
+     * @param allPoints 所有路径点
+     */
+    private drawNewPathSegments;
+    /**
+     * 停止实时绘制模式
+     */
+    stopRealTimeDrawing(): void;
+    destroy(options?: {
+        children?: boolean;
+        texture?: boolean;
+        baseTexture?: boolean;
+    }): void;
+}
+
+declare class PathManager {
+    path: Path;
+    robot: Robot;
+    private unsubscribeFns;
+    private lastDrawnPathData;
+    constructor();
+    /**
+     * 绘制路径和机器人
+     */
+    draw(pathData: PathData): void;
+    /**
+     * 判断是否应该使用增量绘制
+     */
+    private shouldUseIncrementalDraw;
+    /**
+     * 全量绘制模式：完整绘制路径和机器人（初始绘制和不满足增量条件时使用）
+     */
+    private fullDraw;
+    /**
+     * 转换PathPoint为RobotPoint
+     */
+    private convertToRobotPoint;
+    /**
+     * 处理机器人移动到指定点
+     */
+    private moveRobotToPoint;
+    /**
+     * 增量绘制模式：只绘制新增部分，机器人平滑动画到新位置
+     */
+    private incrementalDraw;
+    /**
+     * 批量处理机器人动画队列（用于快速跳转）
+     */
+    batchProcessRobotQueue(jumpToLatest?: boolean): void;
+    updatePositionByOrigin(x: number, y: number): void;
+    destroy(): void;
+}
+
+/**
+ * 路径状态对象
+ * 描述机器人路径的状态信息
+ */
+export declare type PathState = {
+    /** 路径ID */
+    id: number
+    /** 路径类型 */
+    type: number
+    /** 机器人朝向 */
+    direction: number
+    /** 路径点数量 */
+    count: number
+    /** 初始化标志 */
+    initFlag: number
+    /** 机器人当前位置 */
+    robotPosition: Point | null
+}
+
+/**
+ * 二维坐标点
+ */
+export declare type Point = {
+    /** X坐标 */
+    x: number
+    /** Y坐标 */
+    y: number
+}
+
+/**
+ * 处理后的点阵数据
+ */
+export declare type ProcessedRasterData = {
+    /** 障碍物像素点索引数组 */
+    obstacles: Uint32Array
+    /** 地毯像素点索引数组 */
+    carpet: Uint32Array
+    /** 已排序的房间数据，包含颜色信息 */
+    sortedRooms: RasterRoomData[]
+    /** 地图宽度 */
+    width: number
+    /** 地图高度 */
+    height: number
+    /** 总像素数 */
+    totalPixels: number
+}
+
+/**
+ * 点阵房间数据
+ */
+export declare type RasterRoomData = {
+    /** 房间ID */
+    roomId: number | SpecialRoomId
+    /** 像素点索引数组 */
+    pixelIndices: Uint32Array
+    /** 激活状态颜色 */
+    activeColor: string
+    /** 非激活状态颜色 */
+    inactiveColor: string
+}
+
+declare class Ring extends Graphics {
+    private currentPosition;
+    private config;
+    constructor(options: RingOptions);
+    /**
+     * 设置反向缩放监听，保持描边宽度固定
+     */
+    private setupAntiScaleListener;
+    /**
+     * 反向缩放事件处理
+     */
+    private handleScaleChange;
+    /**
+     * 绘制预警圈
+     * @param position 充电桩位置信息
+     */
+    draw(position: Point): void;
+    /**
+     * 绘制虚线圆形
+     */
+    private drawDashedCircle;
+    /**
+     * 重新绘制（当配置变化时调用）
+     */
+    redraw(): void;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+}
+
+/** 预警圈配置 */
+export declare type RingConfig = {
+    /** 大小(米) */
+    ringSize: number
+    /** 填充颜色 */
+    ringColor: ColorSource
+    /** 描边宽度 */
+    ringStrokeWidth: number
+    /** 描边颜色 */
+    ringStrokeColor: ColorSource
+    /** 描边是否虚线 */
+    ringStrokeDashed: boolean
+    /** 描边虚线数组 */
+    ringStrokeDashArray: [number, number]
+}
+
+declare type RingOptions = {
+    config: RingConfig;
+};
+
+declare class Robot extends Container {
+    robot: RobotIcon;
+    ring: Ring;
+    sleepAnimation: SleepAnimation | null;
+    private unsubscribeFns;
+    private targetPosition;
+    private targetRotation;
+    private isMoving;
+    private pathQueue;
+    private lastPosition;
+    private currentPathType;
+    private lastUpdateTime;
+    constructor();
+    /**
+     * 异步初始化睡眠动画
+     */
+    private initializeSleepAnimation;
+    updatePositionByOrigin(x: number, y: number): void;
+    /**
+     * 立即绘制到指定位置（无动画）
+     */
+    draw({ x, y, rotation }: IconPoint): Promise<void>;
+    /**
+     * 添加移动目标到队列（带动画）
+     */
+    moveTo(point: RobotPoint): void;
+    /**
+     * 批量处理队列（快速跳转）
+     */
+    batchProcessQueue(jumpToLatest?: boolean): void;
+    /**
+     * 处理队列中的下一个路径点
+     */
+    private processNextPathPoint;
+    /**
+     * 动画更新循环
+     */
+    private update;
+    /**
+     * 启动机器人动画渲染（只控制 Ticker start/stop，不 add/remove）
+     */
+    private startRobotAnimation;
+    /**
+     * 重写 visible setter，确保睡眠动画能响应机器人可见性变化
+     */
+    set visible(value: boolean);
+    /**
+     * 重写 visible getter
+     */
+    get visible(): boolean;
+    /**
+     * 停止机器人动画渲染（只控制 Ticker start/stop，不 add/remove）
+     */
+    private stopRobotAnimation;
+    /**
+     * 清除机器人动画状态
+     */
+    remove(): void;
+    destroy(options?: {
+        children?: boolean;
+        texture?: boolean;
+        baseTexture?: boolean;
+    }): void;
+}
+
+declare class RobotIcon extends EnhancedSprite {
+    constructor();
+    initializeSprite(): Promise<void>;
+    draw({ x, y, rotation }: IconPoint): Promise<void>;
+}
+
+/** 机器人点 */
+export declare type RobotPoint = IconPoint & {
+    /** 点类型 */
+    type: RobotPointType
+}
+
+/** 机器人点类型 */
+export declare type RobotPointType = 'common' | 'charge' | 'transitions' | 'mop'
+
+/** 房间数据 */
+export declare type Room = {
+    /** 房间ID */
+    id: number
+    /** 颜色 */
+    color: ColorSource
+    /** 边界框 */
+    boundingBox: Rectangle
+    /** 原始点集 */
+    points: Point[]
+    /** 轮廓点集 */
+    outlinePoints: Point[]
+    /** 轮廓点集（poly绘制格式） */
+    polyPoints: number[]
+    /** 中心点 */
+    centerPoint: Point
+}
+
+/**
+ * 房间显示数据
+ * 扩展房间属性，包含显示相关的信息
+ */
+export declare type RoomData = RoomProperty & {
+    /** 可选的中心点，用于显示房间名称 */
+    centerPoint: Point | null
+    /** 索引 */
+    index: number
+}
+
+declare class RoomFill extends Container {
+    private roomGraphicsMap;
+    private roomContextMap;
+    private roomClickHandlerMap;
+    private unsubscribeFns;
+    private mapWidth;
+    private rasterRoomDataMap;
+    constructor();
+    /**
+     * 绘制结构化协议地图房间
+     * @param rooms 房间数据
+     */
+    draw(rooms: Room[]): void;
+    /**
+     * 绘制栅格房间数据
+     * @param processedData 处理后的栅格数据，包含排序和颜色信息
+     */
+    drawRaster(processedData: ProcessedRasterData): void;
+    /**
+     * 绘制栅格房间（统一方法，处理数字房间和特殊房间）
+     */
+    private drawRasterRoom;
+    /**
+     * 分批绘制像素点
+     */
+    private drawPixelPointsInBatches;
+    /**
+     * 处理房间点击事件
+     */
+    private handleRoomClick;
+    /**
+     * 根据选中的房间ID数组设置房间状态
+     * @param selectRoomIds 选中的房间ID数组
+     */
+    setRoomStateBySelectIds(selectRoomIds: readonly number[]): void;
+    /**
+     * 切换单个房间的状态
+     * @param roomId 房间ID
+     * @param isActive 是否为激活状态
+     */
+    setRoomState(roomId: number | SpecialRoomId, isActive: boolean): void;
+    /**
+     * 设置所有房间为同一状态
+     * @param isActive 是否为激活状态
+     */
+    setAllRoomsState(isActive: boolean): void;
+    /**
+     * 获取数字房间的Graphics映射（用于地板材质创建）
+     * @returns 房间ID到Graphics的映射
+     */
+    getRoomGraphicsMap(): Map<number, Graphics>;
+    /**
+     * 获取栅格房间数据（用于精确碰撞检测）
+     * @param roomId 房间ID
+     * @returns 栅格房间数据或null
+     */
+    getRasterRoomData(roomId: number | SpecialRoomId): RasterRoomData | null;
+    /**
+     * 获取地图宽度（用于像素索引转换）
+     */
+    getMapWidth(): number;
+    /**
+     * 清除所有房间
+     */
+    private clearRooms;
+    /**
+     * 销毁时清理资源
+     */
+    destroy(): void;
+}
+
+declare class RoomManager {
+    private unsubscribeFns;
+    private roomInfoContainer;
+    private roomInfoMap;
+    private roomDisplayMap;
+    private roomFloorType;
+    constructor();
+    /**
+     * 设置房间属性数据（房间名称、清洁模式等）
+     * 一次性获取并存储所有必要的显示数据
+     */
+    drawRoomProperty(properties: RoomProperty[]): boolean;
+    /**
+     * 更新房间信息显示
+     * 直接使用已存储的完整显示数据
+     */
+    private updateRoomInfoDisplay;
+    /**
+     * 创建单个房间的信息组件
+     */
+    private createRoomInfo;
+    /**
+     * 更新特定房间的名称
+     */
+    updateRoomName(roomId: number, name: string): void;
+    /**
+     * 更新特定房间的位置
+     */
+    updateRoomPosition(roomId: number, centerPoint: Point): void;
+    /**
+     * 清除所有房间信息
+     */
+    private clearRoomInfos;
+    /**
+     * 根据ID查找房间显示数据
+     */
+    getRoomPropertyById(id: number): RoomData | undefined;
+    /**
+     * 当房间几何数据更新时，刷新房间信息显示
+     * 这个方法由 MapManager 在房间几何数据更新后调用
+     */
+    refresh(): void;
+    /**
+     * 更新地板材质
+     * 在房间几何数据或属性数据更新后调用
+     */
+    private updateFloorTypes;
+    destroy(): void;
+}
+
+/**
+ * 房间属性信息
+ */
+export declare type RoomProperty = {
+    /** 房间ID */
+    id: number
+    /**
+     * 吸力等级
+     *
+     * null表示不显示
+     */
+    suction?: number | null
+    /** 房间名称 */
+    name: string
+    /**
+     * 水量等级
+     *
+     * null表示不显示
+     */
+    cistern?: number | null
+    /**
+     * 清扫模式
+     *
+     * null表示不显示
+     */
+    cleanMode?: number | null
+    /**
+     * 清扫次数
+     */
+    cleanTimes: number
+    /** 清扫顺序 */
+    order: number
+    /** 地板类型 */
+    floorType: number
+    /** 拖地模式 */
+    yMop: number
+}
+
+/**
+ * 运行时状态对象
+ *
+ * 控制地图在运行时的各种行为状态
+ */
+export declare type RuntimeConfig = {
+    /** 正在分割的房间ID */
+    dividingRoomId: number | null | undefined
+    /**
+     * 是否进入房间选择模式
+     *
+     * 进入房间选择模式后，房间颜色会根据selectRoomIds是否包含该房间ID来变化
+     */
+    enableRoomSelection: boolean
+    /** 正在编辑的禁扫区域ID列表 */
+    editingForbiddenSweepZoneIds: string[]
+    /** 正在编辑的禁拖区域ID列表 */
+    editingForbiddenMopZoneIds: string[]
+    /** 正在编辑的清洁区域ID列表 */
+    editingCleanZoneIds: string[]
+    /** 正在编辑的虚拟墙ID列表 */
+    editingVirtualWallIds: string[]
+    /** 正在编辑的定点清扫ID列表 */
+    editingSpotIds: string[]
+    /** 房间属性折叠的房间ID列表 */
+    roomPropertyFoldIds: number[]
+    /** 房间选择的气泡显示模式 */
+    roomSelectionMode: 'checkmark' | 'order'
+    /** 是否显示房间名称 */
+    showRoomName: boolean
+    /** 是否显示房间属性 */
+    showRoomProperty: boolean
+    /** 是否显示房间顺序 */
+    showRoomOrder: boolean
+    /** 是否显示路径 */
+    showPath: boolean
+    /** 是否显示充电桩 */
+    showChargingStation: boolean
+    /** 是否显示房间地板材质 */
+    showRoomFloorType: boolean
+    /** 是否显示地毯 */
+    showCarpet: boolean
+    /** 选中的房间ID列表 */
+    selectRoomIds: number[]
+    /** 是否显示充电桩预警圈 */
+    showChargingStationRing: boolean
+    /** 是否显示机器人预警圈 */
+    showRobotRing: boolean
+    /** 是否显示机器人睡眠动画 */
+    showRobotSleepAnimation: boolean
+}
+
+/**
+ * 机器人睡眠动画组件
+ * TODO
+ * 暂时不开放这个组件，得找到合适的动画
+ * 基于 FixedSizeAnimatedSprite，显示机器人睡眠状态的动画效果
+ */
+declare class SleepAnimation extends EnhancedAnimatedSprite {
+    private unsubscribeFns;
+    private throttledUpdateOffset;
+    private fixedOffsetX;
+    private fixedOffsetY;
+    constructor(textures: Texture[]);
+    /**
+     * 静态创建方法
+     */
+    static create(): Promise<SleepAnimation>;
+    /**
+     * 初始化睡眠动画
+     */
+    private initializeAnimation;
+    /**
+     * 判断是否应该显示睡眠动画
+     * 显示条件：
+     * 1. 配置中启用睡眠动画
+     * 2. 机器人容器可见
+     * 3. 机器人图标已经绘制（有位置信息）
+     */
+    private shouldShow;
+    /**
+     * 更新可见性状态
+     */
+    private updateVisibility;
+    /**
+     * 更新偏移量以保持固定大小
+     * @param _scale 当前地图缩放比例
+     */
+    private updateOffset;
+    /**
+     * 绘制睡眠动画
+     * @param params 绘制参数
+     */
+    draw(params: IconPoint): void;
+    /**
+     * 当机器人图标可见性变化时调用
+     */
+    onRobotVisibilityChanged(): void;
+    /**
+     * 重写 visible setter，确保动画播放状态与可见性同步
+     */
+    set visible(value: boolean);
+    /**
+     * 重写 visible getter
+     */
+    get visible(): boolean;
+    /**
+     * 组件销毁时清理资源
+     */
+    destroy(options?: {
+        children?: boolean;
+        texture?: boolean;
+        baseTexture?: boolean;
+    }): void;
+}
+
+declare const SPECIAL_ROOM_IDS: {
+    readonly NO_ROOM_DATA: "NO_ROOM_DATA";
+    readonly ROOM_GAP: "ROOM_GAP";
+    readonly OBSTACLE_ROOM: "OBSTACLE_ROOM";
+    readonly UNKNOWN_ROOM: "UNKNOWN_ROOM";
+};
+
+declare type SpecialRoomId = (typeof SPECIAL_ROOM_IDS)[keyof typeof SPECIAL_ROOM_IDS];
+
+/** 定点清扫配置 */
+export declare type SpotConfig = {
+    /** 图标资源路径 */
+    iconSrc: string
+    /** 图标大小 */
+    iconSize: number
+    /** 尺寸 (米) */
+    size: number
+    /** 描边颜色 */
+    strokeColor: ColorSource
+    /** 描边宽度 */
+    strokeWidth: number
+    /** 填充颜色 */
+    fillColor: ColorSource
+    /** 文本颜色 */
+    textColor: ColorSource
+    /** 文本位置 */
+    textPosition: 'top' | 'right' | 'bottom' | 'left'
+    /** 文本偏移 */
+    textOffset: number
+
+    /** 编辑模式样式 */
+    editing: {
+        /** 是否虚线 */
+        isDashed: boolean
+        /** 虚线数组 */
+        dashArray: [number, number]
+    }
+    /** 普通模式样式 */
+    normal: {
+        /** 是否虚线 */
+        isDashed: boolean
+        /** 虚线数组 */
+        dashArray: [number, number]
+    }
+}
+
+/** 定点清扫参数 */
+export declare type SpotParam = {
+    /** 定点清扫ID */
+    id: string
+    /** 点坐标 */
+    point: Point
+}
+
+/**
+ * 获取 AppService 实例
+ */
+export declare function useAppService(): AppService;
+
+declare class ViewportContainer extends Container {
+    private viewportBounds;
+    private maskGraphics;
+    constructor(config: AppConfig);
+    /**
+     * 计算视口边界
+     */
+    private calculateViewportBounds;
+    /**
+     * 创建遮罩限制内容在视口内
+     */
+    private createMask;
+    /**
+     * 解析尺寸参数
+     */
+    private parseSize;
+    /**
+     * 获取视口边界
+     */
+    getViewportBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * 更新视口配置
+     */
+    updateViewport(config: AppConfig): void;
+    /**
+     * 添加内容到视口容器
+     */
+    addContent(content: Container): void;
+}
+
+/** 虚拟墙配置 */
+export declare type VirtualWallConfig = {
+    /** 图标容器填充颜色 */
+    iconWrapperFillColor: ColorSource
+    /** 线条宽度 */
+    lineWidth: number
+    /** 线条颜色 */
+    lineColor: ColorSource
+    /** 碰撞区域厚度 */
+    hitAreaThickness: number
+    /** 轮廓偏移 */
+    outlineOffset: number
+    /** 轮廓描边颜色 */
+    outlineStrokeColor: ColorSource
+    /** 轮廓描边宽度 */
+    outlineStrokeWidth: number
+    /** 轮廓是否虚线 */
+    outlineDashed: boolean
+    /** 轮廓虚线数组 */
+    outlineDashArray: [number, number]
+    /** 轮廓填充颜色 */
+    outlineFillColor: ColorSource
+    /** 文本颜色 */
+    textColor: ColorSource
+    /** 文本偏移 */
+    textOffset: number
+    /** 最小宽度 (米) */
+    minWidth: number
+
+    /** 编辑模式样式 */
+    editing: {
+        /** 是否虚线 */
+        isDashed: boolean
+        /** 虚线数组 */
+        dashArray: [number, number]
+    }
+    /** 普通模式样式 */
+    normal: {
+        /** 是否虚线 */
+        isDashed: boolean
+        /** 虚线数组 */
+        dashArray: [number, number]
+    }
+}
+
+/** 虚拟墙参数 */
+export declare type VirtualWallParam = {
+    /** 虚拟墙ID */
+    id: string
+    /** 点集合 */
+    points: Point[]
+}
+
+/** 区域配置 */
+export declare type ZoneConfig = {
+    /** 最小尺寸 (米) */
+    minSize: number
+    /** 图标容器填充颜色 */
+    iconWrapperFillColor: ColorSource
+    /** 描边颜色 */
+    strokeColor: ColorSource
+    /** 描边宽度 */
+    strokeWidth: number
+    /** 填充颜色 */
+    fillColor: ColorSource
+    /** 轮廓偏移 */
+    outlineOffset: number
+    /** 轮廓描边颜色 */
+    outlineStrokeColor: ColorSource
+    /** 轮廓描边宽度 */
+    outlineStrokeWidth: number
+    /** 轮廓填充颜色 */
+    outlineFillColor: ColorSource
+    /** 轮廓是否虚线 */
+    outlineDashed: boolean
+    /** 轮廓虚线数组 */
+    outlineDashArray: [number, number]
+    /** 文本颜色 */
+    textColor: ColorSource
+    /** 文本位置 */
+    textPosition: 'top' | 'right' | 'bottom' | 'left'
+    /** 文本偏移 */
+    textOffset: number
+    /** 编辑模式样式 */
+    editing: {
+        /** 是否虚线 */
+        isDashed: boolean
+        /** 虚线数组 */
+        dashArray: [number, number]
+    }
+    /** 普通模式样式 */
+    normal: {
+        /** 是否虚线 */
+        isDashed: boolean
+        /** 虚线数组 */
+        dashArray: [number, number]
+    }
+}
+
+/** 区域参数 */
+export declare type ZoneParam = {
+    /** 区域ID */
+    id: string
+    /** 点集合 */
+    points: Point[]
+}
+
+export { }