@ray-js/robot-map-sdk 0.0.3-beta-8 → 0.0.3-beta-10

package/dist/index.d.ts

@@ -1,26 +1,40 @@
-import { AppContainer } from './AppContainer';
+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 { ControlsManager } from '../managers/ControlsManager';
-import { CustomElementsManager } from '../managers/CustomElementsManager';
-import { DetectedObjectManager } from '../managers/DetectedObjectManager';
+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 { DestroyOptions } from 'pixi.js';
+import { DetectedObjectManager as DetectedObjectManager_2 } from '../managers/DetectedObjectManager';
+import { DividerConfig as DividerConfig_2 } from '..';
 import { Emitter } from 'mitt';
 import { FederatedPointerEvent } from 'pixi.js';
-import { HeatmapManager } from '../managers/HeatmapManager';
-import { Interaction } from './Interaction';
+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 } from '../managers/MapManager';
+import { MapManager as MapManager_2 } from '../managers/MapManager';
+import { MapState as MapState_2 } from '..';
+import { ParsedRasterMapData as ParsedRasterMapData_2 } from '@ray-js/robot-protocol';
 import { PathData } from '@ray-js/robot-protocol';
-import { PathManager } from '../managers/PathManager';
+import { PathManager as PathManager_2 } from '../managers/PathManager';
 import { Rectangle } from 'pixi.js';
-import { RoomManager } from '../managers/RoomManager';
+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 { SPECIAL_ROOM_IDS } from '@ray-js/robot-protocol';
 import { SpecialRoomId } from '@ray-js/robot-protocol';
+import { Sprite } from 'pixi.js';
 import { TextStyleFontWeight } from 'pixi.js';
+import { Texture } from 'pixi.js';
 import { Ticker } from 'pixi.js';
-import { ViewportContainer } from './ViewportContainer';
+import { ViewportContainer as ViewportContainer_2 } from './ViewportContainer';
 
 /**
  * 地图静态配置
@@ -374,6 +388,59 @@ export declare type AppConfig = {
     }
 }
 
+/**
+ * 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 提供的值
@@ -435,7 +502,7 @@ export declare type AppOptions = {
 declare class AppService {
     getApp(): MapApplication;
     getConfig(): AppConfig;
-    getRoomData(roomId: number): RoomData | undefined;
+    getRoomData(roomId: number): RoomData_2 | undefined;
     /**
      * 将米转换为像素（委托给 MapApplication）
      */
@@ -445,7 +512,7 @@ declare class AppService {
      */
     pixelsToMeters(pixels: number): number;
     get ticker(): Ticker;
-    get mapState(): MapState | null;
+    get mapState(): MapState_2 | null;
     get gloalConfig(): {
         containerTop: string;
         containerLeft: string;
@@ -579,7 +646,7 @@ declare class AppService {
             offsetX: number;
             offsetY: number;
         };
-    } & RingConfig;
+    } & RingConfig_2;
     get chargingStationConfig(): {
         icon: {
             sizeFixed: boolean;
@@ -588,7 +655,7 @@ declare class AppService {
             src: string;
         };
         rotationCorrection: number;
-    } & RingConfig;
+    } & RingConfig_2;
     get interactionConfig(): {
         zoomRange: {
             min: number;
@@ -598,8 +665,8 @@ declare class AppService {
         fitMaxScale: number;
         enableDoubleTapZoom: boolean;
     };
-    get controlsConfig(): ControlsConfig;
-    get dividerConfig(): DividerConfig;
+    get controlsConfig(): ControlsConfig_2;
+    get dividerConfig(): DividerConfig_2;
     get detectedObjectConfig(): {
         height: number;
         width: number;
@@ -611,17 +678,17 @@ declare class AppService {
         antialias: boolean;
         resolution: number;
     };
-    get appContainer(): AppContainer;
-    get interaction(): Interaction;
-    get viewportContainer(): ViewportContainer;
-    get mapManager(): MapManager;
-    get pathManager(): PathManager;
-    get heatmapManager(): HeatmapManager;
-    get controlsManager(): ControlsManager;
-    get detectedObjectManager(): DetectedObjectManager;
-    get customElementsManager(): CustomElementsManager;
-    get roomsManager(): RoomManager;
-    get runtime(): RuntimeConfig;
+    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;
@@ -644,28 +711,28 @@ declare class AppService {
         readonly showRobotRing: boolean;
         readonly showRobotSleepAnimation: boolean;
     };
-    get events(): MapCallbacks | undefined;
+    get events(): MapCallbacks_2 | undefined;
     get baseScale(): number;
     get currentScale(): number;
     get emitter(): Emitter<    {
-        antiScale: 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;
-        };
+    antiScale: 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;
+    };
     }>;
 }
 
@@ -703,12 +770,74 @@ export declare type Bounds = {
     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;
+};
+
 /**
  * 控制元素配置
  */
@@ -753,6 +882,177 @@ export declare type ControlsConfig = {
     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;
+}
+
 /**
  * 自定义元素参数
  */
@@ -761,6 +1061,61 @@ export declare type CustomElementParam =
 | 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;
+}
+
 /**
  * 解析结构化协议的地图房间属性
  * @param map 地图数据
@@ -786,6 +1141,34 @@ 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;
+}
+
 /**
  * 检测物体参数
  */
@@ -835,6 +1218,221 @@ export declare type DividerConfig = {
     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;
+}
+
+declare class Free extends Graphics {
+    constructor();
+    /**
+     * 绘制结构化自由区域数据
+     * @param free 自由区域数据数组
+     */
+    draw(free: {
+        coordinates: number[];
+    }[]): void;
+    destroy(options?: DestroyOptions | boolean): void;
+}
+
 /**
  * GIF 类型自定义元素参数
  * 保持现有逻辑
@@ -850,6 +1448,80 @@ export declare type GifCustomElementParam = BaseCustomElementParam & {
     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;
+}
+
+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 & {
     /** 信号强度 */
@@ -886,30 +1558,176 @@ export declare type IconPoint = Point & {
     rotation?: number
 }
 
-/** 图标尺寸 */
-export declare type IconSize = {
-    /** 宽度 */
-    width: number
-    /** 高度 */
-    height: 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;
+    private throttledAntiScale;
+    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];
 
-/**
- * Image 类型自定义元素参数
- * 保持现有逻辑
- */
-export declare type ImageCustomElementParam = BaseCustomElementParam & {
-    /** 元素类型 */
-    type: 'image'
-    /** 图片资源路径 */
-    src: string
-    /** 图片宽度（必需 - 图片需要明确尺寸） */
-    width: number
-    /** 图片高度（必需 - 图片需要明确尺寸） */
-    height: number
-}
+declare const LAYERS: string[];
 
-export declare const MAP_API_METHODS: readonly ["resetPanZoom", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "snapshot", "snapshotByData"];
+/** 管理器类型定义 */
+declare type Managers = {
+    mapManager: MapManager;
+    heatmapManager: HeatmapManager;
+    pathManager: PathManager;
+    controlsManager: ControlsManager;
+    detectedObjectManager: DetectedObjectManager;
+    customElementsManager: CustomElementsManager;
+    roomsManager: RoomManager;
+};
+
+export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "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"];
 
@@ -1066,6 +1884,18 @@ export declare interface MapApi {
         offsetX?: number;
         offsetY?: number;
     }): Point;
+    /**
+     * 判断指定的房间是否相邻（连通）
+     *
+     * 支持结构化地图和点阵地图两种协议。对于多个房间，使用连通性算法判断：
+     * 只要房间之间能通过相邻关系连接起来，就认为它们是相邻的。
+     * 例如：房间A和B相邻，房间B和C相邻，则认为A、B、C三个房间都相邻。
+     *
+     * @param roomIds - 要检测的房间ID数组
+     * @param threshold - 距离阈值（像素），默认为5。两个房间的边界点距离小于等于此阈值时认为相邻
+     * @returns 是否所有指定的房间都相邻（连通）
+     */
+    areRoomsAdjacent(roomIds: number[], threshold?: number): boolean;
     /**
      * 地图截图
      *
@@ -1436,6 +2266,29 @@ export declare class MapApplication extends Application implements MapApi {
         offsetX?: number;
         offsetY?: number;
     }): Point;
+    /**
+     * 判断指定的房间是否相邻（连通）
+     *
+     * 支持结构化地图和点阵地图两种协议。对于多个房间，使用连通性算法判断：
+     * 只要房间之间能通过相邻关系连接起来，就认为它们是相邻的。
+     * 例如：房间A和B相邻，房间B和C相邻，则认为A、B、C三个房间都相邻。
+     *
+     * @param roomIds - 要检测的房间ID数组
+     * @param threshold - 距离阈值（像素），默认为3。两个房间的边界点距离小于等于此阈值时认为相邻
+     * @returns 是否所有指定的房间都相邻（连通）
+     *
+     * @example
+     * ```typescript
+     * // 判断两个房间是否相邻
+     * const isAdjacent = mapApi.areRoomsAdjacent([1, 2])
+     *
+     * // 判断三个房间是否相邻（连通），使用自定义阈值
+     * const isAdjacent = mapApi.areRoomsAdjacent([1, 2, 3], 8)
+     * ```
+     */
+    areRoomsAdjacent(roomIds: number[], threshold?: number): boolean;
+    /* Excluded from this release type: areStructuredRoomsAdjacentInternal */
+    /* Excluded from this release type: areRasterRoomsAdjacentInternal */
     /**
      * 地图截图
      *
@@ -1778,6 +2631,77 @@ export declare type MapDataSource = {
     version: string
 }
 
+declare class MapManager {
+    obstacle: Obstacle;
+    free: Free;
+    roomFill: RoomFill;
+    carpet: Carpet;
+    chargingStation: ChargingStation;
+    mapBounds: Bounds;
+    private lastMapId;
+    private roomGeometryMap;
+    private rasterRoomPixelsMap;
+    private carpetData;
+    private unsubscribeFns;
+    constructor();
+    /**
+     * 处理结构化地图数据（房间形状、障碍物等）
+     */
+    drawMap(mapData: MapDataSource): Promise<boolean>;
+    /**
+     * 处理栅格地图数据
+     * @param mapPointsStr 栅格数据字符串
+     * @param width 地图宽度
+     * @param height 地图高度
+     * @param charger 充电桩信息
+     */
+    drawRasterMap(rasterData: ParsedRasterMapData_2, 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;
+    /**
+     * 获取点阵房间的像素数据
+     * @param roomId 房间ID
+     * @returns 像素索引数组，如果不存在则返回 undefined
+     */
+    getRasterRoomPixels(roomId: number): Uint32Array | undefined;
+    destroy(): void;
+}
+
 /**
  * 地图状态对象
  *
@@ -1806,6 +2730,24 @@ export declare type MapState = {
     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;
+    destroy(options?: DestroyOptions | boolean): void;
+}
+
 /**
  * 解析后的点阵地图数据
  */
@@ -1824,6 +2766,116 @@ export declare type ParsedRasterMapData = {
     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 所有路径点（新数据）
+     * @param oldPoints 旧的路径点数据（用于获取连接点）
+     */
+    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;
+}
+
 /**
  * 路径状态对象
  * 描述机器人路径的状态信息
@@ -1885,6 +2937,37 @@ export declare type RasterRoomData = {
     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 = {
     /** 大小(米) */
@@ -1901,6 +2984,81 @@ export declare type RingConfig = {
     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 & {
     /** 点类型 */
@@ -1939,6 +3097,139 @@ export declare type RoomData = RoomProperty & {
     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 updateAllRoomPropertyVisibility;
+    /**
+     * 更新所有房间名称的可见性
+     */
+    private updateAllRoomNameVisibility;
+    /**
+     * 更新所有房间选择指示器的可见性
+     */
+    private updateAllRoomSelectionIndicatorVisibility;
+    /**
+     * 更新地板材质
+     * 在房间几何数据或属性数据更新后调用
+     */
+    private updateFloorTypes;
+    destroy(): void;
+}
+
 /**
  * 房间属性信息
  */
@@ -2032,6 +3323,70 @@ export declare type RuntimeConfig = {
     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;
+}
+
 /** 定点清扫配置 */
 export declare type SpotConfig = {
     /** 图标资源路径 */
@@ -2082,6 +3437,46 @@ export declare type SpotParam = {
  */
 export declare function useAppService(): AppService;
 
+declare class ViewportContainer extends Container {
+    private viewportBounds;
+    private maskGraphics;
+    private containerElement;
+    constructor(config: AppConfig, containerElement?: HTMLElement | Window);
+    /**
+     * 计算视口边界
+     */
+    private calculateViewportBounds;
+    /**
+     * 获取容器尺寸
+     */
+    private getContainerSize;
+    /**
+     * 创建遮罩限制内容在视口内
+     */
+    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 = {
     /** 图标容器填充颜色 */