@ray-js/robot-map-sdk 0.0.6-beta.1 → 0.0.6-beta.2

package/dist/index.d.ts

@@ -1,23 +1,43 @@
 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 } from '../managers/ControlsManager';
+import { CustomElementsManager } from '../managers/CustomElementsManager';
 import { DestroyOptions } from 'pixi.js';
+import { DetectedObjectManager } from '../managers/DetectedObjectManager';
+import { DividerConfig as DividerConfig_2 } from '..';
+import { EditControlManager } from '../managers/EditControlManager';
 import { Emitter } from 'mitt';
 import { FederatedPointerEvent } from 'pixi.js';
 import { Graphics } from 'pixi.js';
+import { HeatmapManager } from '../managers/HeatmapManager';
+import { Interaction } 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 { MapState as MapState_2 } from '..';
+import { MeasurementUnit as MeasurementUnit_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 { Rectangle } from 'pixi.js';
+import { RingConfig as RingConfig_2 } from '..';
+import { RoomData as RoomData_2 } from '..';
+import { RoomManager } 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 { StructuredMapDataSource } from '@ray-js/robot-protocol';
 import { TextStyleFontWeight } from 'pixi.js';
 import { Texture } from 'pixi.js';
+import { Ticker } from 'pixi.js';
+import { ViewportContainer as ViewportContainer_2 } from './ViewportContainer';
 
 /**
  * 地图静态配置
@@ -38,6 +58,10 @@ export declare type AppConfig = {
         backgroundColor: ColorSource
         /** 背景透明度 */
         backgroundAlpha: number
+        /** 是否启用高性能模式（强制关闭抗锯齿等） */
+        performanceMode: boolean
+        /** 渲染分辨率，默认为 window.devicePixelRatio */
+        resolution: number
         /** 是否启用日志输出，默认开发环境开启，生产环境关闭 */
         enableLogger: boolean
     }
@@ -437,6 +461,8 @@ export declare type AppConfig = {
         fitMinScale: number
         /** 自适应缩放时的最大比例，避免超小地图放太大 */
         fitMaxScale: number
+        /** 是否启用交互 */
+        enable: boolean
         /** 是否启用双击缩放功能 */
         enableDoubleTapZoom: boolean
     }
@@ -475,11 +501,12 @@ export declare type AppConfig = {
  * 管理所有地图相关的层级和组件
  */
 declare class AppContainer extends Container {
+    private appService;
     private layers;
     private mapRotation;
     private backgroundGraphics;
     private lastBackgroundState;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 初始化所有预定义的层级
      */
@@ -565,11 +592,339 @@ export declare type AppOptions = {
     runtime: DeepPartialRuntimeConfig
 }
 
+declare class AppService {
+    private app;
+    constructor(app: MapApplication);
+    getApp(): MapApplication;
+    getConfig(): AppConfig;
+    /**
+     * 获取调试模式
+     * @returns 是否为调试模式
+     */
+    getDebuggerMode(): boolean;
+    getRoomData(roomId: number): RoomData_2 | undefined;
+    /**
+     * 将米转换为像素（委托给 MapApplication）
+     */
+    metersToPixels(meters: number): number;
+    /**
+     * 将像素转换为米（委托给 MapApplication）
+     */
+    pixelsToMeters(pixels: number): number;
+    /**
+     * 将米转换为配置的单位
+     * @param meters - 米数值
+     * @returns 转换后的数值
+     */
+    metersToDisplayUnit(meters: number): number;
+    get ticker(): Ticker;
+    get mapState(): MapState_2 | null;
+    get isMapDrawn(): boolean;
+    get gloalConfig(): {
+        containerTop: string;
+        containerLeft: string;
+        containerWidth: string;
+        containerHeight: string;
+        backgroundColor: ColorSource;
+        backgroundAlpha: number;
+        performanceMode: boolean;
+        resolution: number;
+        enableLogger: boolean;
+    };
+    get mapConfig(): {
+        autoPaddingVerticalPercent: number;
+        autoPaddingHorizontalPercent: number;
+        adjacencyThreshold: number;
+        originChangeAutoFitThreshold: number;
+        sizeChangeAutoFitThreshold: number;
+        obstacleColor: ColorSource;
+        freeColor: ColorSource;
+    };
+    get roomConfig(): {
+        colors: {
+            sortBy: "index" | "area";
+            strategy: "priority" | "balanced";
+            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" | string)[];
+            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 | "auto";
+                fontFamily: string;
+                fontWeight: TextStyleFontWeight;
+                fontSize: number;
+                gapRight: number;
+            };
+            customAssets?: Record<string, string[]>;
+        };
+        selectionIndicator: {
+            iconSrc: string;
+            iconWidth: number;
+            iconHeight: number;
+            containerWidth: number;
+            containerHeight: number;
+            strokeWidth: number;
+            strokeColor: ColorSource | "auto";
+            borderRadius: number;
+            offsetX: number;
+            offsetY: number;
+            tailHeight: number;
+            tailWidth: number;
+        };
+        floorType: {
+            assets: string[];
+            opacity: number;
+            scale: number;
+        };
+        enableElasticScale: boolean;
+        elasticMinScale: number;
+        elasticMaxScale: number;
+    };
+    get heatMapConfig(): {
+        cellSize: number;
+        maxDistance: number;
+        smoothIterations: number;
+        heatmapAlpha: number;
+        useGradient: boolean;
+        colorGradients: [ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource];
+    };
+    get pathConfig(): {
+        lineWidthFixed: boolean;
+        incrementalThreshold: number;
+        commonPath: {
+            visible: boolean;
+            color: ColorSource;
+            width: number;
+        };
+        transitionPath: {
+            visible: boolean;
+            color: ColorSource;
+            width: number;
+        };
+        chargePath: {
+            visible: boolean;
+            color: ColorSource;
+            width: number;
+        };
+    };
+    get carpetConfig(): {
+        src: string;
+        opacity: number;
+        scale: number;
+        material?: {
+            type: number;
+            src: string;
+            opacity: number;
+            scale: number;
+        }[];
+        enableEdit?: boolean;
+    };
+    get robotConfig(): {
+        icon: {
+            sizeFixed: boolean;
+            width: number;
+            height: number;
+            src: string;
+        };
+        speed: number;
+        rotationCorrection: number;
+        sleepAnimation: {
+            jsonSrc: string;
+            imageSrc: string;
+            framePrefix: string;
+            width: number;
+            height: number;
+            sizeFixed: boolean;
+            frameCount: number;
+            offsetX: number;
+            offsetY: number;
+        };
+        pulseCircle: {
+            size: number;
+            color: ColorSource;
+            strokeWidth: number;
+            strokeColor: ColorSource;
+            duration: number;
+            sizeFixed: boolean;
+            minScale: number;
+            maxScale: number;
+            minAlpha: number;
+            maxAlpha: number;
+        };
+        ring: RingConfig_2;
+    };
+    get chargingStationConfig(): {
+        icon: {
+            sizeFixed: boolean;
+            width: number;
+            height: number;
+            src: string;
+        };
+        rotationCorrection: number;
+        ring: RingConfig_2;
+    };
+    get interactionConfig(): {
+        zoomRange: {
+            min: number;
+            max: number;
+        };
+        fitMinScale: number;
+        fitMaxScale: number;
+        enable: boolean;
+        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;
+    get viewportContainer(): ViewportContainer_2;
+    get mapManager(): MapManager;
+    get pathManager(): PathManager;
+    get heatmapManager(): HeatmapManager;
+    get controlsManager(): ControlsManager;
+    get detectedObjectManager(): DetectedObjectManager;
+    get customElementsManager(): CustomElementsManager;
+    get roomsManager(): RoomManager;
+    get editControlManager(): EditControlManager;
+    get runtime(): RuntimeConfig_2;
+    get runtimeSnapshot(): {
+        readonly dividingRoomId: number;
+        readonly enableRoomSelection: boolean;
+        readonly enableInteraction: boolean;
+        readonly enableMapClickCapture: boolean;
+        readonly editingForbiddenSweepZoneIds: readonly string[];
+        readonly editingForbiddenMopZoneIds: readonly string[];
+        readonly editingCleanZoneIds: readonly string[];
+        readonly editingVirtualWallIds: readonly string[];
+        readonly editingSpotIds: readonly string[];
+        readonly editingWayPointIds: readonly string[];
+        readonly editingCarpetIds: readonly string[];
+        readonly mapRotation: number;
+        readonly roomPropertyFoldIds: readonly number[];
+        readonly roomSelectionMode: "checkmark" | "order";
+        readonly showRoomName: boolean;
+        readonly unit: MeasurementUnit_2;
+        readonly unitLabel: string;
+        readonly showRoomProperty: boolean;
+        readonly showRoomOrder: boolean;
+        readonly showPath: boolean;
+        readonly showRobot: boolean;
+        readonly showChargingStation: boolean;
+        readonly showRoomFloorType: boolean;
+        readonly showCarpet: boolean;
+        readonly selectRoomIds: readonly number[];
+        readonly showChargingStationRing: boolean;
+        readonly showRobotRing: boolean;
+        readonly showRobotSleepAnimation: boolean;
+        readonly showRobotPulseCircle: boolean;
+        readonly selectedCarpetIds: readonly string[];
+    };
+    /**
+     * 检查是否启用交互
+     * 供其他组件使用，用于判断是否应该响应交互事件
+     * @returns 是否启用交互
+     */
+    isInteractionEnabled(): boolean;
+    get events(): MapCallbacks_2 | undefined;
+    get baseScale(): number;
+    get currentScale(): number;
+    get emitter(): Emitter<    {
+    antiScale: number;
+    gestureHijackStart: FederatedPointerEvent;
+    gestureHijackPointerMove: FederatedPointerEvent;
+    gestureHijackPointerUp: FederatedPointerEvent;
+    gestureHijackCancel: void;
+    gestureHijackEnd: void;
+    suppressMapClick: void;
+    robotPositionUpdate: {
+    x: number;
+    y: number;
+    pathType?: string;
+    };
+    robotAnimationComplete: void;
+    pathSegmentComplete: {
+    fromX: number;
+    fromY: number;
+    toX: number;
+    toY: number;
+    pathType?: string;
+    };
+    }>;
+    /**
+     * 获取充电桩位置（机器坐标系）
+     * @returns 充电桩位置坐标，如果地图未初始化则返回 null
+     */
+    getChargerPosition(): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * 获取机器人当前位置（机器坐标系）
+     * @returns 机器人位置坐标，如果路径未绘制或机器人位置不可用则返回 null
+     */
+    getRobotPosition(): {
+        x: number;
+        y: number;
+    } | null;
+}
+
 declare abstract class BaseControlButton<T extends BaseControlButtonOptions = BaseControlButtonOptions> extends FixedSizeContainer {
+    protected appService: AppService;
     protected background: Graphics;
     protected icon: EnhancedSprite;
     protected options: T;
-    constructor(options: T);
+    constructor(appService: AppService, options: T);
     /**
      * 抽象方法：子类需要实现具体的事件监听逻辑
      */
@@ -692,9 +1047,10 @@ export declare type Bounds = {
 }
 
 declare class Carpet extends Container {
+    private appService;
     private carpetSprite;
     private carpetMask;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 创建地毯纹理覆盖（栅格数据）
      * @param carpetPixels 地毯像素数据
@@ -738,22 +1094,25 @@ export declare type CarpetConfig = BaseZoneConfig & {
 }
 
 declare type CarpetOptions = {
+    appService: AppService;
     carpetData: CustomCarpetParam;
     textureMap: Map<number, Texture>;
     events?: CustomCarpetEvents;
 };
 
 declare class ChargingStation extends Container {
+    private appService;
     chargingStation: ChargingStationIcon;
     ring: Ring;
     private unsubscribeFns;
-    constructor();
+    constructor(appService: AppService);
     draw({ x, y, rotation }: IconPoint): Promise<void>;
     destroy(): void;
 }
 
 declare class ChargingStationIcon extends EnhancedSprite {
-    constructor();
+    protected appService: AppService;
+    constructor(appService: AppService);
     initializeSprite(): Promise<void>;
     draw({ x, y, rotation }: IconPoint): Promise<void>;
 }
@@ -768,7 +1127,7 @@ export declare type ComponentPropsApp = {
 declare type Components = {
     viewportContainer: ViewportContainer;
     appContainer: AppContainer;
-    interaction: Interaction;
+    interaction: Interaction_2;
 };
 
 /**
@@ -820,7 +1179,8 @@ export declare type ControlsConfig = {
     wayPoint: WayPointConfig
 }
 
-declare class ControlsManager {
+declare class ControlsManager_2 {
+    private appService;
     private forbiddenSweepZoneMap;
     private forbiddenMopZoneMap;
     private cleanZoneMap;
@@ -829,7 +1189,7 @@ declare class ControlsManager {
     private wayPointMap;
     private divider;
     private unsubscribeFns;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 根据地图原点更新所有区域位置
      */
@@ -1039,6 +1399,7 @@ declare class CustomCarpet extends Container {
     private carpetConfig;
     private controlsConfig;
     private carpetEvents;
+    private appService;
     private controlFill;
     private editControlLayer;
     private clickHandler;
@@ -1134,13 +1495,7 @@ declare class CustomCarpet extends Container {
      * 处理拖拽移动
      */
     private handleDragMove;
-    /**
-     * 处理拖拽结束
-     */
     private handleDragEnd;
-    /**
-     * 处理移动开始
-     */
     private handleMoveStart;
     /**
      * 处理移动过程
@@ -1231,12 +1586,13 @@ declare type CustomCarpetEvents = {
 };
 
 declare class CustomCarpetManager {
+    private appService;
     private customCarpetMap;
     private unsubscribeFns;
     private textureMap;
     private texturesLoaded;
     private texturesLoadingPromise;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 加载材质纹理
      * 如果已经加载过，直接返回已完成的 Promise
@@ -1318,11 +1674,12 @@ export declare type CustomElementParam =
 | GifCustomElementParam
 | HtmlCustomElementParam
 
-declare class CustomElementsManager {
+declare class CustomElementsManager_2 {
+    private appService;
     private customElementsMap;
     private gifTicker;
     private gifElements;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 根据地图原点更新所有自定义元素位置
      */
@@ -1398,8 +1755,10 @@ export declare type DeepPartialAppConfig = DeepPartial<AppConfig>
 /** 深度可选的运行时配置类型 */
 export declare type DeepPartialRuntimeConfig = DeepPartial<RuntimeConfig>
 
-declare class DetectedObjectManager {
+declare class DetectedObjectManager_2 {
+    private appService;
     private detectedObjectMap;
+    constructor(appService: AppService);
     /**
      * 根据地图原点更新所有检测物体位置
      */
@@ -1523,6 +1882,7 @@ declare type EditControlEvents = {
  * 统一管理编辑状态下的控制按钮、轮廓边框、移动延长线和尺寸文本
  */
 declare class EditControlLayer extends Container {
+    private appService;
     private config;
     private events;
     private zonePoints;
@@ -1545,7 +1905,7 @@ declare class EditControlLayer extends Container {
     private verticalScaleInitialPosition;
     private clickHandler;
     private throttledUpdateOutline;
-    constructor(options: EditControlLayerOptions);
+    constructor(appService: AppService, options: EditControlLayerOptions);
     /**
      * 初始化组件
      */
@@ -1766,9 +2126,10 @@ declare type EditControlLayerOptions = {
  * 编辑控制管理器
  * 统一管理所有编辑控制层，将它们放在最顶层以确保始终可见
  */
-declare class EditControlManager {
+declare class EditControlManager_2 {
+    private appService;
     private editControlLayers;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 注册编辑控制层
      * @param id 组件唯一标识（如 Zone ID、Carpet ID）
@@ -1832,6 +2193,7 @@ declare class EditControlManager {
  * 2. sizeFixed: false - 以地图scale=1为基准，跟随地图缩放
  */
 declare class EnhancedAnimatedSprite extends AnimatedSprite {
+    protected appService: AppService;
     private throttledUpdateScale;
     private fixedWidth;
     private fixedHeight;
@@ -1840,7 +2202,7 @@ declare class EnhancedAnimatedSprite extends AnimatedSprite {
     private baselineScale;
     private static animationTicker;
     private static animatedSprites;
-    constructor(textures?: Texture[]);
+    constructor(appService: AppService, textures?: Texture[]);
     /**
      * 设置固定的屏幕像素大小
      * @param width 屏幕上显示的固定宽度（像素）
@@ -1951,13 +2313,14 @@ declare class EnhancedAnimatedSprite extends AnimatedSprite {
  * 2. sizeFixed: false - 以地图scale=1为基准，跟随地图缩放
  */
 declare class EnhancedSprite extends Sprite {
+    protected appService: AppService;
     private throttledUpdateScale;
     private fixedWidth;
     private fixedHeight;
     private isFixedSizeSet;
     private sizeFixed;
     private baselineScale;
-    constructor(texture?: Texture);
+    constructor(appService: AppService, texture?: Texture);
     /**
      * 设置固定的屏幕像素大小
      * @param width 屏幕上显示的固定宽度（像素）
@@ -2032,8 +2395,9 @@ declare class EnhancedSprite extends Sprite {
  * 用于创建在地图缩放时保持固定视觉大小的元素
  */
 declare class FixedSizeContainer extends Container {
+    protected appService: AppService;
     private throttledUpdateScale;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 注册缩放事件监听
      */
@@ -2053,7 +2417,8 @@ declare class FixedSizeContainer extends Container {
 }
 
 declare class Free extends Graphics {
-    constructor();
+    private appService;
+    constructor(appService: AppService);
     /**
      * 绘制结构化自由区域数据
      * @param free 自由区域数据数组
@@ -2080,9 +2445,10 @@ export declare type GifCustomElementParam = BaseCustomElementParam & {
 }
 
 declare class Heatmap extends Container {
+    private appService;
     colorGradients: Array<string>;
     cellSize: number;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 绘制热力图
      * @param grid 处理好的热力数据 每个网格的信号强度 和 坐标
@@ -2124,7 +2490,8 @@ declare class Heatmap extends Container {
     destroy(): void;
 }
 
-declare class HeatmapManager {
+declare class HeatmapManager_2 {
+    private appService;
     heatmap: Heatmap;
     pointsTopLeftOrigin: HeatmapPoint[];
     signalGrid: Array<Array<{
@@ -2139,7 +2506,7 @@ declare class HeatmapManager {
     heatmapAlpha: number;
     isHeatmapDrawn: boolean;
     private loadTimer;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 绘制热力图
      * @param mapData 地图数据
@@ -2242,7 +2609,8 @@ export declare type ImageCustomElementParam = BaseCustomElementParam & {
 
 /* Excluded from this release type: InstanceEvents */
 
-declare class Interaction extends Container {
+declare class Interaction_2 extends Container {
+    private appService;
     dragStart: {
         x: number;
         y: number;
@@ -2312,7 +2680,7 @@ declare class Interaction extends Container {
     private interactionState;
     private throttledAntiScale;
     private unsubscribeEnableInteraction;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 更新交互模式
      * @param enabled 是否启用交互
@@ -2403,15 +2771,15 @@ declare const LAYERS: string[];
 
 /** 管理器类型定义 */
 declare type Managers = {
-    mapManager: MapManager;
-    heatmapManager: HeatmapManager;
-    pathManager: PathManager;
-    controlsManager: ControlsManager;
-    detectedObjectManager: DetectedObjectManager;
-    customElementsManager: CustomElementsManager;
-    roomsManager: RoomManager;
+    mapManager: MapManager_2;
+    heatmapManager: HeatmapManager_2;
+    pathManager: PathManager_2;
+    controlsManager: ControlsManager_2;
+    detectedObjectManager: DetectedObjectManager_2;
+    customElementsManager: CustomElementsManager_2;
+    roomsManager: RoomManager_2;
     customCarpetManager: CustomCarpetManager;
-    editControlManager: EditControlManager;
+    editControlManager: EditControlManager_2;
 };
 
 export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getWayPoints", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "isWallIntersectsAnyRoom", "isZoneIntersectsAnyRoom", "resetPanZoom", "snapshot", "snapshotByData", "getCustomCarpets", "forceEndGesture"];
@@ -2703,6 +3071,7 @@ declare class MapApplication extends Application implements MapApi {
     /* Excluded from this release type: managers */
     /* Excluded from this release type: config */
     /* Excluded from this release type: runtime */
+    /* Excluded from this release type: appService */
     /* Excluded from this release type: scaleMin */
     /* Excluded from this release type: scaleMax */
     /* Excluded from this release type: events */
@@ -3548,7 +3917,8 @@ export declare type MapDataSource = {
     version: string
 }
 
-declare class MapManager {
+declare class MapManager_2 {
+    private appService;
     obstacle: Obstacle;
     free: Free;
     roomFill: RoomFill;
@@ -3564,7 +3934,7 @@ declare class MapManager {
     private fourColorCache;
     private carpetData;
     private unsubscribeFns;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 处理结构化地图数据（房间形状、障碍物等）
      */
@@ -3727,9 +4097,10 @@ export declare type MapType = 'structured' | 'raster'
 export declare type MeasurementUnit = 'meter' | 'feet' | 'centimeter'
 
 declare class MoveControlButton extends BaseControlButton<MoveControlButtonOptions> {
+    protected appService: AppService;
     private isMoving;
     private dragStartPosition;
-    constructor(options: MoveControlButtonOptions);
+    constructor(appService: AppService, options: MoveControlButtonOptions);
     /**
      * 设置移动事件监听
      */
@@ -3787,7 +4158,8 @@ declare type MoveControlButtonOptions = BaseControlButtonOptions & {
 };
 
 declare class Obstacle extends Graphics {
-    constructor();
+    private appService;
+    constructor(appService: AppService);
     /**
      * 绘制结构化障碍物数据
      * @param obstacles 障碍物数据数组
@@ -3840,6 +4212,7 @@ export declare type ParsedRasterMapData = {
 }
 
 declare class Path extends Container {
+    private appService;
     private commonPath;
     private chargePath;
     private transitionsPath;
@@ -3851,7 +4224,7 @@ declare class Path extends Container {
     private isRealTimeDrawing;
     private throttledUpdateLineWidth;
     private throttledHandleRobotPosition;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 注册事件监听
      */
@@ -3921,12 +4294,13 @@ declare class Path extends Container {
     }): void;
 }
 
-declare class PathManager {
+declare class PathManager_2 {
+    private appService;
     path: Path;
     robot: Robot;
     private unsubscribeFns;
     private lastDrawnPathData;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 绘制路径和机器人
      */
@@ -4011,10 +4385,11 @@ export declare type ProcessedRasterData = {
 }
 
 declare class PulseCircle extends Graphics {
+    private appService;
     private currentPosition;
     private animationStartTime;
     private isAnimating;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 设置反向缩放监听，保持描边宽度固定
      */
@@ -4075,9 +4450,10 @@ export declare type RasterRoomData = {
 }
 
 declare class Ring extends Graphics {
+    private appService;
     private currentPosition;
     private config;
-    constructor(options: RingOptions);
+    constructor(appService: AppService, options: RingOptions);
     /**
      * 设置反向缩放监听，保持描边宽度固定
      */
@@ -4126,6 +4502,7 @@ declare type RingOptions = {
 };
 
 declare class Robot extends Container {
+    private appService;
     robot: RobotIcon;
     ring: Ring;
     pulseCircle: PulseCircle;
@@ -4139,7 +4516,7 @@ declare class Robot extends Container {
     private currentPathType;
     private lastUpdateTime;
     private isCleared;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 异步初始化睡眠动画
      */
@@ -4205,7 +4582,8 @@ declare class Robot extends Container {
 }
 
 declare class RobotIcon extends EnhancedSprite {
-    constructor();
+    protected appService: AppService;
+    constructor(appService: AppService);
     initializeSprite(): Promise<void>;
     draw({ x, y, rotation }: IconPoint): Promise<void>;
 }
@@ -4253,13 +4631,14 @@ export declare type RoomData = RoomProperty & {
 }
 
 declare class RoomFill extends Container {
+    private appService;
     private roomGraphicsMap;
     private roomContextMap;
     private roomClickHandlerMap;
     private unsubscribeFns;
     private mapWidth;
     private rasterRoomDataMap;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 绘制结构化协议地图房间
      * @param rooms 房间数据
@@ -4360,13 +4739,14 @@ declare class RoomFill extends Container {
     destroy(): void;
 }
 
-declare class RoomManager {
+declare class RoomManager_2 {
+    private appService;
     private unsubscribeFns;
     private roomInfoContainer;
     private roomInfoMap;
     private roomDisplayMap;
     private roomFloorType;
-    constructor();
+    constructor(appService: AppService);
     /**
      * 设置房间属性数据（房间名称、清洁模式等）
      * 一次性获取并存储所有必要的显示数据
@@ -4543,15 +4923,16 @@ export declare type RuntimeConfig = {
  * 基于 FixedSizeAnimatedSprite，显示机器人睡眠状态的动画效果
  */
 declare class SleepAnimation extends EnhancedAnimatedSprite {
+    protected appService: AppService;
     private unsubscribeFns;
     private throttledUpdateOffset;
     private fixedOffsetX;
     private fixedOffsetY;
-    constructor(textures: Texture[]);
+    constructor(appService: AppService, textures: Texture[]);
     /**
      * 静态创建方法
      */
-    static create(): Promise<SleepAnimation>;
+    static create(appService: AppService): Promise<SleepAnimation>;
     /**
      * 初始化睡眠动画
      */