@ray-js/robot-map-sdk 0.0.9 → 0.0.11

package/dist/index.d.ts

@@ -1,48 +1,9 @@
-import { AnimatedSprite } from 'pixi.js';
-import { AppContainer as AppContainer_2 } from './AppContainer';
-import { Application } from 'pixi.js';
 import { ApplicationOptions } from 'pixi.js';
-import { BackgroundGradient as BackgroundGradient_2 } from '..';
-import { BackgroundImage as BackgroundImage_2 } from '..';
 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 { FurnitureConfig as FurnitureConfig_2 } from '..';
-import { FurnitureManager } from '../managers/FurnitureManager';
-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 { Point as Point_2 } from '..';
 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';
 
 /**
  * 地图静态配置
@@ -575,89 +536,6 @@ export declare type AppConfig = {
     }
 }
 
-/**
- * AppContainer 同时作为应用的主容器和层级管理器
- * 管理所有地图相关的层级和组件
- */
-declare class AppContainer extends Container {
-    private appService;
-    private layers;
-    private mapRotation;
-    private backgroundGraphics;
-    private lastBackgroundState;
-    constructor(appService: AppService);
-    /**
-     * 初始化所有预定义的层级
-     */
-    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;
-    /**
-     * 设置地图旋转角度
-     * @param angle 旋转角度（度数）
-     */
-    setMapRotation(angle: number): void;
-    /**
-     * 获取当前地图旋转角度
-     * @returns 旋转角度（度数）
-     */
-    getMapRotation(): number;
-    /**
-     * 获取当前地图旋转弧度
-     * @returns 旋转角度（弧度）
-     */
-    getMapRotationRadians(): number;
-    /**
-     * 获取用于截图的完整边界
-     * 会合并所有可见图层的局部边界，确保截图能覆盖所有内容（包括超出初始地图范围的禁区等）
-     */
-    getSnapshotBounds(): Rectangle;
-    /**
-     * 更新截图背景（主渲染器显示版本）
-     * @param color 背景颜色
-     * @param visible 是否可见
-     */
-    updateBackground(color: ColorSource, visible: boolean): void;
-}
-
 /**
  * 应用程序选项配置
  * 包含事件回调、配置和运行时状态
@@ -671,426 +549,6 @@ 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 config(): AppConfig;
-    get gloalConfig(): {
-        containerTop: string;
-        containerLeft: string;
-        containerWidth: string;
-        containerHeight: string;
-        backgroundColor?: ColorSource;
-        backgroundGradient?: BackgroundGradient_2;
-        backgroundImage?: BackgroundImage_2;
-        backgroundAlpha: number;
-        performanceMode: boolean;
-        resolution: number;
-        enableLogger: boolean;
-    };
-    get mapConfig(): {
-        autoPaddingVerticalPercent: number;
-        autoPaddingHorizontalPercent: number;
-        adjacencyThreshold: number;
-        originChangeAutoFitThreshold: number;
-        sizeChangeAutoFitThreshold: number;
-        obstacleColor: ColorSource;
-        freeColor: ColorSource;
-        autoFitOffset?: {
-            x: number;
-            y: number;
-        };
-    };
-    get roomConfig(): {
-        colors: {
-            sortBy: "index" | "area";
-            strategy: "priority" | "balanced";
-            active: string[];
-            inactive: string[];
-            normal?: string[];
-            name: string[];
-            nameInactive?: string[];
-            nameNormal?: string[];
-            propertyTheme: string[];
-            propertyThemeInactive?: string[];
-            propertyThemeNormal?: string[];
-            selectionIndicatorBackground: string[];
-            selectionIndicatorIcon: string[];
-            NO_ROOM_DATA: string;
-            ROOM_GAP: string;
-            OBSTACLE_ROOM: string;
-            UNKNOWN_ROOM: string;
-            VERSION0_ROOM: string;
-        };
-        nameLabel: {
-            fontSize: number;
-            fontFamily: string;
-            fontWeight: TextStyleFontWeight;
-        };
-        type: {
-            assets: string[];
-            iconSize: number;
-            gap: number;
-            position: "left" | "right";
-            container: {
-                visible: boolean;
-                size: number;
-                borderRadius: number;
-            };
-        };
-        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;
-        };
-        mopPath: {
-            lineVisible: boolean;
-            lineColor: ColorSource;
-            lineWidth: number;
-            trackVisible: boolean;
-            trackColor: ColorSource;
-            trackAlpha: number;
-            trackWidth: 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;
-        enableRobotClick?: boolean;
-        enableChargingStationClick?: boolean;
-    };
-    get controlsConfig(): ControlsConfig_2;
-    get furnitureConfig(): FurnitureConfig_2;
-    get dividerConfig(): DividerConfig_2;
-    get detectedObjectConfig(): {
-        height: number;
-        width: number;
-        interactive: boolean;
-        anchor: Point_2;
-    };
-    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 furnitureManager(): FurnitureManager;
-    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 editingFurnitureIds: readonly string[];
-        readonly mapRotation: number;
-        readonly roomPropertyFoldIds: readonly number[];
-        readonly roomSelectionMode: "checkmark" | "order";
-        readonly showRoomName: boolean;
-        readonly showRoomType: 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 showDetectedObjects: boolean;
-        readonly selectRoomIds: readonly number[];
-        readonly showChargingStationRing: boolean;
-        readonly showRobotRing: boolean;
-        readonly showRobotSleepAnimation: boolean;
-        readonly showRobotPulseCircle: boolean;
-        readonly selectedCarpetIds: readonly string[];
-    };
-    /**
-     * 检查是否启用交互
-     * 供其他组件使用，用于判断是否应该响应交互事件
-     * @returns 是否启用交互
-     */
-    isInteractionEnabled(): boolean;
-    /**
-     * 修复浮点数精度误差
-     * @param value 数字、点或点数组
-     * @param precision 保留小数位数，默认 2
-     */
-    fixPrecision<T>(value: T, precision?: number): T;
-    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;
-    };
-    mapRotationUpdate: number;
-    }>;
-    /**
-     * 获取充电桩位置（机器坐标系）
-     * @returns 充电桩位置坐标，如果地图未初始化则返回 null
-     */
-    getChargerPosition(): {
-        x: number;
-        y: number;
-    } | null;
-    /**
-     * 获取机器人当前位置（机器坐标系）
-     * @returns 机器人位置坐标，如果路径未绘制或机器人位置不可用则返回 null
-     */
-    getRobotPosition(): {
-        x: number;
-        y: number;
-    } | null;
-}
-
-/**
- * 背景组件
- * 支持纯色背景、渐变背景和图片背景
- * 优先级：图片背景 > 渐变背景 > 纯色背景
- */
-declare class Background extends Container {
-    private graphics;
-    private sprite;
-    private viewportBounds;
-    private lastConfig;
-    private onImageLoaded?;
-    constructor(config: AppConfig['global'], viewportBounds: {
-        width: number;
-        height: number;
-    }, onImageLoaded?: () => void);
-    /**
-     * 渲染背景（根据优先级）
-     */
-    private render;
-    /**
-     * 清空背景内容
-     */
-    private clear;
-    /**
-     * 渲染纯色背景
-     */
-    private renderSolidColor;
-    /**
-     * 渲染渐变背景
-     */
-    private renderGradient;
-    /**
-     * 渲染图片背景
-     */
-    private renderImage;
-    /**
-     * 动态更新背景配置
-     */
-    update(config: AppConfig['global']): Promise<void>;
-    /**
-     * 销毁组件
-     */
-    destroy(): void;
-}
-
 /**
  * 渐变背景配置
  */
@@ -1129,50 +587,6 @@ export declare type BackgroundImage = {
     repeat?: boolean
 }
 
-declare abstract class BaseControlButton<T extends BaseControlButtonOptions = BaseControlButtonOptions> extends FixedSizeContainer {
-    protected appService: AppService;
-    protected background: Graphics;
-    protected icon: EnhancedSprite;
-    protected options: T;
-    constructor(appService: AppService, options: T);
-    /**
-     * 抽象方法：子类需要实现具体的事件监听逻辑
-     */
-    protected abstract setupEvents(): void;
-    /**
-     * 设置点击热区
-     */
-    private setupHitArea;
-    /**
-     * 渲染按钮
-     */
-    private render;
-    /**
-     * 渲染背景
-     */
-    protected renderBackground(): void;
-    /**
-     * 渲染图标
-     */
-    protected renderIcon(): Promise<void>;
-    /**
-     * 销毁组件
-     */
-    destroy(): void;
-}
-
-declare type BaseControlButtonOptions = {
-    iconAlias: string;
-    backgroundColor: ColorSource;
-    config?: {
-        iconWrapperWidth: number;
-        iconWrapperHeight: number;
-        iconWrapperBorderRadius: number;
-        iconWidth: number;
-        iconHeight: number;
-    };
-};
-
 /**
  * 基础自定义元素参数（所有类型共享）
  */
@@ -1256,97 +670,18 @@ export declare type Bounds = {
     maxY: number
 }
 
-declare class Carpet extends Container {
-    private appService;
-    private carpetSprite;
-    private carpetMask;
-    constructor(appService: AppService);
-    /**
-     * 创建地毯纹理覆盖（栅格数据）
-     * @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;
-}
-
 /** 地毯配置 */
 export declare type CarpetConfig = BaseZoneConfig & {
     /** 是否开启自由旋转模式 */
     enableFreeRotate: boolean
 }
 
-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;
-    private clickHandler?;
-    constructor(appService: AppService);
-    draw({ x, y, rotation }: IconPoint): Promise<void>;
-    /**
-     * 初始化点击处理器状态
-     * 根据静态配置启用充电桩点击交互
-     */
-    private initClickInteraction;
-    destroy(): void;
-}
-
-declare class ChargingStationIcon extends EnhancedSprite {
-    protected appService: AppService;
-    constructor(appService: AppService);
-    initializeSprite(): Promise<void>;
-    draw({ x, y, rotation }: IconPoint): Promise<void>;
-}
-
 /** 组件属性类型 */
 export declare type ComponentPropsApp = {
     /** 地图应用实例 */
-    app: MapApplication
+    app: MapApplicationInstance
 }
 
-/** 组件类型定义 */
-declare type Components = {
-    viewportContainer: ViewportContainer;
-    background: Background;
-    appContainer: AppContainer;
-    interaction: Interaction_2;
-};
-
 /** 控制层内可排序元素 */
 export declare type ControlRenderItem =
 | 'forbiddenSweepZone'
@@ -1408,496 +743,20 @@ export declare type ControlsConfig = {
     wayPoint: WayPointConfig
 }
 
-declare class ControlsManager_2 {
-    private appService;
-    private forbiddenSweepZoneMap;
-    private forbiddenMopZoneMap;
-    private cleanZoneMap;
-    private virtualWallMap;
-    private spotMap;
-    private wayPointMap;
-    private divider;
-    private controlContainers;
-    private unsubscribeFns;
-    constructor(appService: AppService);
-    /**
-     * 根据地图原点更新所有区域位置
-     */
-    updatePositionByOrigin(x: number, y: number): void;
-    updateRenderOrder(): void;
-    private initializeControlContainers;
-    private applyRenderOrder;
-    private addToControlLayer;
-    /**
-     * 绘制扫地禁区
-     */
-    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;
-    /**
-     * 添加新区域到 controls 子容器
-     */
-    private addNewZone;
-    /**
-     * 移除区域
-     */
-    private removeZone;
-    /**
-     * 获取区域数据
-     */
-    private getZonesData;
-    /**
-     * 清除所有区域
-     */
-    private clearAllZones;
-    /**
-     * 更新区域编辑状态
-     */
-    private updateZonesEditState;
-    /**
-     * 更新虚拟墙编辑状态
-     */
-    private updateVirtualWallsEditState;
-    /**
-     * 比较两个区域数据是否相等
-     */
-    private isZoneDataEqual;
-    /**
-     * 获取虚拟墙数据
-     */
-    private getWallsData;
-    /**
-     * 清除所有虚拟墙
-     */
-    private clearAllWalls;
-    /**
-     * 比较两个虚拟墙是否相同
-     */
-    private isWallDataEqual;
-    /**
-     * 添加新定点清扫到 controls 子容器
-     */
-    private addNewSpot;
-    /**
-     * 移除定点清扫
-     */
-    private removeSpot;
-    /**
-     * 获取定点清扫数据
-     */
-    private getSpotsData;
-    /**
-     * 清除所有定点清扫
-     */
-    private clearAllSpotsInternal;
-    /**
-     * 更新定点清扫编辑状态
-     */
-    private updateSpotsEditState;
-    /**
-     * 比较两个定点清扫数据是否相等
-     */
-    private isSpotDataEqual;
-    /**
-     * 绘制途径点
-     * @param wayPoints 途径点数组
-     */
-    drawWayPoints(wayPoints: WayPointParam[]): void;
-    /**
-     * 清除所有途径点
-     */
-    clearAllWayPoints(): void;
-    /**
-     * 获取所有途径点数据
-     */
-    getWayPoints(): WayPointParam[];
-    /**
-     * 添加新途径点到 controls 子容器
-     */
-    private addNewWayPoint;
-    /**
-     * 移除途径点
-     */
-    private removeWayPoint;
-    /**
-     * 获取途径点数据
-     */
-    private getWayPointsData;
-    /**
-     * 清除所有途径点
-     */
-    private clearAllWayPointsInternal;
-    /**
-     * 更新途径点编辑状态
-     */
-    private updateWayPointsEditState;
-    /**
-     * 比较两个途径点数据是否相等
-     */
-    private isWayPointDataEqual;
-    /**
-     * 处理分割房间ID变化
-     */
-    private handleDividingRoomIdChange;
-    /**
-     * 获取房间几何信息
-     */
-    private getRoomGeometry;
-    /**
-     * 创建默认分割线
-     */
-    private createDefaultDivider;
-    /**
-     * 清除分割线
-     */
-    private clearDivider;
-    /**
-     * 获取分割线数据
-     */
-    getDividerEndPoints(): Point[] | null;
-    /**
-     * 获取分割线有效端点
-     */
-    getEffectiveDividerPoints(): Point[] | null;
-    /**
-     * 处理单位变化
-     * 当 unit 或 unitLabel 改变时，刷新所有显示尺寸的组件
-     */
-    private handleUnitChange;
-    /**
-     * 销毁管理器
-     */
-    destroy(): void;
-}
-
-declare class CustomCarpet extends Container {
-    private carpetData;
-    private carpetConfig;
-    private controlsConfig;
-    private carpetEvents;
-    private appService;
-    private controlFill;
-    private editControlLayer;
-    private clickHandler;
-    private maskContainer;
-    private maskGraphics;
-    private texture;
-    private textureMap;
-    private tilingSprite;
-    private initialZonePoints;
-    private unsubscribeFns;
-    constructor(options: CarpetOptions);
-    /**
-     * 处理地毯数据（点集合）
-     */
-    private processCarpetData;
-    /**
-     * 获取控制元素配置
-     */
-    private getControlsConfig;
-    /**
-     * 获取当前编辑状态（是否在 editingCarpetIds 中）
-     */
-    private isEditingEnabled;
-    /**
-     * 获取当前选中状态（是否在 selectedCarpetIds 中）
-     */
-    private isSelected;
-    /**
-     * 是否应该显示编辑框（在 editingCarpetIds 或 selectedCarpetIds 中）
-     */
-    private shouldShowEditControl;
-    /**
-     * 初始化组件
-     */
-    private initializeComponents;
-    /**
-     * 创建遮罩容器（用于地毯纹理）
-     */
-    private createMaskContainer;
-    /**
-     * 创建控制填充组件
-     */
-    private createControlFill;
-    /**
-     * 创建编辑控制层（通过 EditControlManager）
-     */
-    private createEditControlLayer;
-    /**
-     * 设置点击处理器（用于非编辑状态下的点击）
-     */
-    private setupClickHandler;
-    /**
-     * 设置 enableRoomSelection 监听器
-     */
-    private setupEnableRoomSelectionListener;
-    /**
-     * 检查是否启用了房间选择模式
-     */
-    private isRoomSelectionEnabled;
-    /**
-     * 更新点击处理器状态
-     */
-    private updateClickHandlerState;
-    /**
-     * 计算地毯边界
-     */
-    private calculateBounds;
-    /**
-     * 计算自定义形状的外接矩形点集
-     */
-    private calculateBoundingRectanglePoints;
-    /**
-     * 更新遮罩形状
-     */
-    private updateMaskShape;
-    /**
-     * 异步加载地毯纹理
-     */
-    private loadTexture;
-    /**
-     * 创建平铺纹理精灵
-     */
-    private createTilingSprite;
-    /**
-     * 更新平铺纹理位置和大小
-     */
-    private updateTilingSprite;
-    /**
-     * 处理拖拽开始
-     */
-    private handleDragStart;
-    /**
-     * 处理拖拽移动
-     */
-    private handleDragMove;
-    private handleDragEnd;
-    private handleMoveStart;
-    /**
-     * 处理移动过程
-     */
-    private handleMove;
-    /**
-     * 处理移动结束
-     */
-    private handleMoveEnd;
-    /**
-     * 应用平移变换（拖拽和移动的公共方法）
-     */
-    private applyTranslation;
-    /**
-     * 处理旋转开始
-     */
-    private handleRotationStart;
-    /**
-     * 处理旋转移动
-     */
-    private handleRotationMove;
-    /**
-     * 处理旋转结束
-     */
-    private handleRotationEnd;
-    /**
-     * 处理缩放开始
-     */
-    private handleScaleStart;
-    /**
-     * 处理缩放移动
-     */
-    private handleScaleMove;
-    /**
-     * 处理水平缩放移动
-     */
-    private handleScaleMoveHorizontal;
-    /**
-     * 处理垂直缩放移动
-     */
-    private handleScaleMoveVertical;
-    /**
-     * 处理缩放结束
-     */
-    private handleScaleEnd;
-    /**
-     * 处理删除操作
-     */
-    private handleDelete;
-    /**
-     * 处理点击事件
-     */
-    private handleClick;
-    /**
-     * 处理点集更新
-     */
-    private handlePointsUpdate;
-    /**
-     * 绘制地毯
-     */
-    private drawCarpet;
-    /**
-     * 更新编辑状态（公共方法）
-     */
-    updateEditState(): void;
-    /**
-     * 更新地毯数据
-     */
-    updateCarpetData(newData: CustomCarpetParam): void;
-    /**
-     * 获取当前地毯数据
-     */
-    getCarpetData(): CustomCarpetParam;
-    /**
-     * 刷新显示（用于单位变化等场景）
-     */
-    refreshDisplay(): void;
-    /**
-     * 销毁组件
-     */
-    destroy(): void;
-}
-
-declare type CustomCarpetEvents = {
-    onRemove?: (id: string) => void;
-    onUpdate?: (zone: CustomCarpetParam) => void;
-    onClick?: (zone: CustomCarpetParam) => void;
-};
-
-declare class CustomCarpetManager {
-    private appService;
-    private customCarpetMap;
-    private unsubscribeFns;
-    private textureMap;
-    private texturesLoaded;
-    private texturesLoadingPromise;
-    constructor(appService: AppService);
-    /**
-     * 加载材质纹理
-     * 如果已经加载过，直接返回已完成的 Promise
-     * 如果正在加载，返回正在进行的 Promise
-     * 如果未加载，开始加载并返回 Promise
-     */
-    loadTextures(): Promise<void>;
-    /**
-     * 内部方法：实际加载纹理
-     */
-    private _loadTextures;
-    /**
-     * 根据地图原点更新所有自定义地毯位置
-     */
-    updatePositionByOrigin(x: number, y: number): void;
-    /**
-     * 绘制自定义地毯
-     */
-    drawCustomCarpets(carpets: CustomCarpetParam[]): Promise<void>;
-    /**
-     * 获取所有自定义地毯数据
-     */
-    getCustomCarpets(): CustomCarpetParam[];
-    /**
-     * 根据 ID 获取自定义地毯
-     */
-    getCustomCarpetById(id: string): CustomCarpet | undefined;
-    /**
-     * 清除所有自定义地毯
-     */
-    clearAllCustomCarpets(): void;
-    /**
-     * 添加新自定义地毯到 LAYER_CUSTOM_CARPET
-     */
-    private addNewCustomCarpet;
-    /**
-     * 移除自定义地毯
-     */
-    private removeCustomCarpet;
-    /**
-     * 更新自定义地毯编辑状态
-     */
-    private updateCarpetsEditState;
-    /**
-     * 比较两个地毯数据是否相等
-     */
-    private isCarpetDataEqual;
-    /**
-     * 刷新显示（单位变化时调用）
-     */
-    refreshDisplay(): void;
-    /**
-     * 销毁管理器
-     */
-    destroy(): void;
-}
-
-/** 自定义地毯参数 */
-export declare type CustomCarpetParam = {
-    /** 地毯ID */
-    id: string
-    /** 地毯材质 */
-    type: number
-    /** 点集合（用于矩形和圆形） */
-    points?: Point[]
-
-    /** 形状 */
-    shape: 'rectangle' | 'round' | 'custom'
-
-    /** 自定义数据 */
-    customData?: Record<string, any>
+/** 自定义地毯参数 */
+export declare type CustomCarpetParam = {
+    /** 地毯ID */
+    id: string
+    /** 地毯材质 */
+    type: number
+    /** 点集合（用于矩形和圆形） */
+    points?: Point[]
+
+    /** 形状 */
+    shape: 'rectangle' | 'round' | 'custom'
+
+    /** 自定义数据 */
+    customData?: Record<string, any>
 }
 
 /**
@@ -1908,62 +767,6 @@ export declare type CustomElementParam =
 | GifCustomElementParam
 | HtmlCustomElementParam
 
-declare class CustomElementsManager_2 {
-    private appService;
-    private customElementsMap;
-    private gifTicker;
-    private gifElements;
-    constructor(appService: AppService);
-    /**
-     * 根据地图原点更新所有自定义元素位置
-     */
-    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 地图数据
@@ -1989,38 +792,6 @@ export declare type DeepPartialAppConfig = DeepPartial<AppConfig>
 /** 深度可选的运行时配置类型 */
 export declare type DeepPartialRuntimeConfig = DeepPartial<RuntimeConfig>
 
-declare class DetectedObjectManager_2 {
-    private appService;
-    private detectedObjectMap;
-    private unsubscribeShowDetectedObjects;
-    constructor(appService: AppService);
-    /**
-     * 根据地图原点更新所有检测物体位置
-     */
-    updatePositionByOrigin(x: number, y: number): void;
-    /**
-     * 绘制检测物体
-     */
-    drawDetectedObjects(objects: DetectedObjectParam[]): Promise<void>;
-    private applyLayerVisibility;
-    /**
-     * 清除所有检测物体
-     */
-    clearAllDetectedObjects(): void;
-    /**
-     * 添加新的检测物体
-     */
-    private addNewDetectedObject;
-    /**
-     * 移除检测物体
-     */
-    private removeDetectedObject;
-    /**
-     * 销毁管理器
-     */
-    destroy(): void;
-}
-
 /**
  * 检测物体参数
  */
@@ -2073,1720 +844,315 @@ export declare type DividerConfig = {
     defaultDirection: Direction
 }
 
-declare type EditControlConfig = {
-    outlineStrokeColor: ColorSource;
-    outlineStrokeWidth: number;
-    outlineDashed: boolean;
-    outlineDashArray: [number, number];
-    outlineFillColor?: ColorSource;
-    outlineOffset: number;
-    iconWrapperFillColor: ColorSource;
-    showRotateButton: boolean;
-    showScaleButton?: boolean;
-    showRadialScaleButton?: boolean;
-    showDeleteButton?: boolean;
-    showMoveButton?: boolean;
-    textColor: ColorSource;
-    textPosition: 'top' | 'right' | 'bottom' | 'left';
-    textOffset: number;
-    moveButtonOffset: number;
-    textFontSize: number;
-    textFontFamily: string;
-    textFontWeight: TextStyleFontWeight;
-};
+/** 家具素材配置 */
+export declare type FurnitureAsset = {
+    /** 家具类型编号，匹配 FurnitureParam.furnitureType */
+    type: number
+    /** 图片 URL */
+    src: string
+    /** 默认宽度 (米，用于生成初始 points，内部根据 resolution 转换为像素) */
+    width: number
+    /** 默认高度 (米，用于生成初始 points，内部根据 resolution 转换为像素) */
+    height: number
+}
+
+/** 家具配置 */
+export declare type FurnitureConfig = {
+    /** 家具素材列表 */
+    assets: FurnitureAsset[]
+    /** 全局透明度 (0-1, 默认 1) */
+    opacity: number
+    /** 图标容器填充颜色 */
+    iconWrapperFillColor: ColorSource
+    /** 轮廓偏移 */
+    outlineOffset: number
+    /** 轮廓描边颜色 */
+    outlineStrokeColor: ColorSource
+    /** 轮廓描边宽度 */
+    outlineStrokeWidth: number
+    /** 轮廓填充颜色 */
+    outlineFillColor: ColorSource
+    /** 轮廓是否虚线 */
+    outlineDashed: boolean
+    /** 轮廓虚线数组 */
+    outlineDashArray: [number, number]
+    /** 是否显示尺寸文本 */
+    showSizeText: boolean
+    /** 文本颜色 */
+    textColor: ColorSource
+    /** 文本位置 */
+    textPosition: 'top' | 'right' | 'bottom' | 'left'
+    /** 文本偏移 */
+    textOffset: number
+    /** 缩放按钮允许的最小缩放倍数 (相对初始尺寸, 默认 0.5; 设为 0 表示不限制最小) */
+    minScaleRatio: number
+    /** 缩放按钮允许的最大缩放倍数 (相对初始尺寸, 默认 2; 设为 Infinity 表示不限制最大) */
+    maxScaleRatio: number
+    /** 点击旋转方向: 'cw' 顺时针 | 'ccw' 逆时针 (默认 'cw') */
+    rotateDirection: 'cw' | 'ccw'
+}
 
-declare type EditControlEvents = {
-    onRemove?: () => void;
-    onRotateStart?: (rotationCenter: Point) => void;
-    onRotateMove?: (newPoints?: Point[]) => void;
-    onRotateEnd?: () => void;
-    onClickRotate?: (newPoints?: Point[]) => void;
-    onScaleStart?: () => void;
-    onScaleMove?: (newPoints?: Point[]) => void;
-    onScaleMoveHorizontal?: (newPoints?: Point[]) => void;
-    onScaleMoveVertical?: (newPoints?: Point[]) => void;
-    onScaleEnd?: () => void;
-    onMoveStart?: () => void;
-    onMoveMove?: (event: FederatedPointerEvent) => void;
-    onMoveEnd?: () => void;
-    onClick?: () => void;
-    onPointsUpdate?: (newPoints: Point[]) => void;
-};
+/** 家具参数 */
+export declare type FurnitureParam = {
+    /** 家具ID */
+    id: string
+    /** 家具类型编号，匹配 config.furniture.assets 中的 type */
+    furnitureType: number
+    /** 四个顶点坐标 (顺时针: 左上→右上→右下→左下) */
+    points: Point[]
+}
 
 /**
- * 编辑控制层组件
- * 统一管理编辑状态下的控制按钮、轮廓边框、移动延长线和尺寸文本
+ * GIF 类型自定义元素参数
+ * 保持现有逻辑
  */
-declare class EditControlLayer extends Container {
-    private appService;
-    private config;
-    private events;
-    private zonePoints;
-    private outlinePoints;
-    private minSize;
-    private initialZonePoints;
-    private scaleCache;
-    private rotationCache;
-    private outlineBorder;
-    private moveLine;
-    private sizeText;
-    private controlButtons;
-    private deleteButton;
-    private rotateButton;
-    private scaleButton;
-    private moveButton;
-    private horizontalScaleButton;
-    private verticalScaleButton;
-    private horizontalScaleInitialPosition;
-    private verticalScaleInitialPosition;
-    private clickHandler;
-    private throttledUpdateOutline;
-    constructor(appService: AppService, options: EditControlLayerOptions);
-    /**
-     * 初始化组件
-     */
-    private initializeComponents;
-    /**
-     * 创建轮廓边框
-     */
-    private createOutlineBorder;
-    /**
-     * 创建移动按钮延长线
-     */
-    private createMoveLine;
-    /**
-     * 创建尺寸文本
-     */
-    private createSizeText;
-    private createDeleteButton;
-    private createRotateButton;
-    private onClickRotateButton;
-    private createScaleButton;
-    private createHorizontalScaleButton;
-    private createVerticalScaleButton;
-    private createMoveButton;
-    /**
-     * 创建并添加按钮到容器
-     */
-    private createAndAddButton;
-    /**
-     * 创建控制按钮
-     */
-    private createControlButtons;
-    /**
-     * 计算轮廓边框的点
-     */
-    private calculateOutlinePoints;
-    /**
-     * 计算移动按钮的位置（在 MOVE 点的延长线上）
-     * 使用角平分线算法计算按钮位置，使其位于 MOVE、SCALE、REMOVE 三个点形成的角的角平分线上
-     */
-    private calculateMoveButtonPosition;
-    /**
-     * 计算移动按钮延长线的点
-     * 返回从 MOVE 点到移动按钮位置的线段
-     */
-    private calculateMoveLinePoints;
-    /**
-     * 计算区域尺寸文本（宽x高格式）
-     */
-    private calculateSizeText;
-    /**
-     * 计算边的中点
-     */
-    private getEdgeCenter;
+export declare type GifCustomElementParam = BaseCustomElementParam & {
+    /** 元素类型 */
+    type: 'gif'
+    /** GIF资源路径 */
+    src: string
+    /** GIF宽度（必需 - GIF 需要明确尺寸） */
+    width: number
+    /** GIF高度（必需 - GIF 需要明确尺寸） */
+    height: number
     /**
-     * 计算垂直于边的偏移方向
-     * @param start 边的起点
-     * @param end 边的终点
-     * @param offset 偏移距离
-     * @param reverseNormal 是否反转法向量方向（用于 bottom case）
+     * 锚点位置
+     *
+     * 定义GIF的锚点位置，用于控制GIF相对于坐标点的对齐方式
+     * - {x: 0, y: 0} 表示左上角
+     * - {x: 0.5, y: 0.5} 表示中心点（默认）
+     * - {x: 0.5, y: 1} 表示底部中心（适用于气泡图标）
+     * - {x: 1, y: 1} 表示右下角
      */
-    private calculatePerpendicularOffset;
-    /**
-     * 计算尺寸文本位置（基于textPosition）
-     */
-    private calculateSizeTextPosition;
-    /**
-     * 计算尺寸文本旋转角度（与对应边平行）
-     */
-    private calculateSizeTextRotation;
-    /**
-     * 计算水平缩放按钮旋转角度（与右侧边平行）
-     */
-    private calculateHorizontalScaleButtonRotation;
-    /**
-     * 计算垂直缩放按钮旋转角度（与底边平行）
-     */
-    private calculateVerticalScaleButtonRotation;
-    /**
-     * 更新点集（公共方法）
-     * @param points 点集
-     * @param updateText 是否更新文本
-     */
-    updatePoints(points: Point[], updateText?: boolean): void;
-    /**
-     * 更新轮廓边框
-     */
-    updateOutlineBorder(): void;
-    /**
-     * 更新移动按钮延长线
-     */
-    updateMoveLine(): void;
-    /**
-     * 更新尺寸文本
-     * @param updateText 是否更新文本内容
-     */
-    updateSizeText(updateText?: boolean): void;
-    /**
-     * 更新尺寸文本位置
-     */
-    updateSizeTextPosition(): void;
-    /**
-     * 更新控制按钮位置
-     */
-    updateControlButtonsPosition(): void;
-    /**
-     * 设置点击处理器
-     */
-    private setupClickHandler;
-    /**
-     * 注册缩放事件监听
-     */
-    private registerScaleListener;
-    /**
-     * 处理缩放变化时的outline更新
-     */
-    private updateOutlineForScale;
-    /**
-     * 初始化缩放计算缓存
-     */
-    private initializeScaleCache;
-    /**
-     * 处理内部缩放移动
-     * @param deltaX X 方向的偏移量
-     * @param deltaY Y 方向的偏移量
-     * @returns 计算后的新点集，如果无法缩放则返回 null
-     */
-    private handleInternalScaleMove;
-    /**
-     * 重置缩放状态
-     */
-    private resetScaleState;
-    /**
-     * 处理内部水平缩放移动
-     * @param deltaX X 方向的偏移量
-     * @param deltaY Y 方向的偏移量
-     * @returns 计算后的新点集，如果无法缩放则返回 null
-     */
-    private handleInternalHorizontalScaleMove;
-    /**
-     * 处理内部垂直缩放移动
-     * @param deltaX X 方向的偏移量
-     * @param deltaY Y 方向的偏移量
-     * @returns 计算后的新点集，如果无法缩放则返回 null
-     */
-    private handleInternalVerticalScaleMove;
-    /**
-     * 根据缩放比例计算新的点集
-     */
-    private calculatePointsFromScale;
-    /**
-     * 初始化旋转计算缓存
-     */
-    private initializeRotationCache;
-    /**
-     * 处理内部旋转移动
-     * 优化：基于初始点集和累计角度计算，避免累积误差
-     * @returns 计算后的新点集，如果无法旋转则返回 null
-     */
-    private handleInternalRotationMove;
-    /**
-     * 重置旋转状态
-     */
-    private resetRotationState;
-    /**
-     * 计算旋转中心（用于点击旋转）
-     */
-    private calculateRotationCenter;
-    /**
-     * 更新编辑状态
-     * @param options 控制各个元素显示/隐藏的选项
-     */
-    updateEditState({ showRotateButton, showScaleButton, showRadialScaleButton, showDeleteButton, showMoveButton, showBorder, showSizeText, borderStyle, }: {
-        showRotateButton?: boolean;
-        showScaleButton?: boolean;
-        showRadialScaleButton?: boolean;
-        showDeleteButton?: boolean;
-        showMoveButton?: boolean;
-        showBorder?: boolean;
-        showSizeText?: boolean;
-        borderStyle?: {
-            isDashed: boolean;
-            dashArray?: [number, number];
-        };
-    }): void;
-    /**
-     * 获取操作状态
-     */
-    getOperationState(): OperationState;
-    /**
-     * 停止所有操作
-     */
-    stopAllOperations(): void;
-    /**
-     * 获取控制按钮容器（供外部添加额外按钮）
-     */
-    getControlButtonsContainer(): Container;
-    /**
-     * 获取移动按钮（供外部调用）
-     */
-    getMoveButton(): MoveControlButton | null;
-    /**
-     * 计算指定边的中点位置
-     * @param startIndex 起始点索引
-     * @param endIndex 结束点索引
-     */
-    calculateEdgeMidpoint(startIndex: number, endIndex: number): Point;
-    /**
-     * 销毁组件
-     */
-    destroy(): void;
-}
-
-declare type EditControlLayerOptions = {
-    config: EditControlConfig;
-    zonePoints: Point[];
-    events?: EditControlEvents;
-    minSize?: number;
-};
-
-/**
- * 编辑控制管理器
- * 统一管理所有编辑控制层，将它们放在最顶层以确保始终可见
- */
-declare class EditControlManager_2 {
-    private appService;
-    private editControlLayers;
-    constructor(appService: AppService);
-    /**
-     * 注册编辑控制层
-     * @param id 组件唯一标识（如 Zone ID、Carpet ID）
-     * @param options 编辑控制层配置
-     * @returns 创建的 EditControlLayer 实例
-     */
-    registerEditControl(id: string | number, options: EditControlLayerOptions): EditControlLayer;
-    /**
-     * 注销编辑控制层
-     * @param id 组件唯一标识
-     */
-    unregisterEditControl(id: string | number): void;
-    /**
-     * 获取编辑控制层
-     * @param id 组件唯一标识
-     * @returns EditControlLayer 实例，如果不存在则返回 undefined
-     */
-    getEditControl(id: string | number): EditControlLayer | undefined;
-    /**
-     * 更新编辑控制层状态
-     * @param id 组件唯一标识
-     * @param options 控制各个元素显示/隐藏的选项
-     */
-    updateEditState(id: string | number, options: {
-        showRotateButton?: boolean;
-        showScaleButton?: boolean;
-        showRadialScaleButton?: boolean;
-        showDeleteButton?: boolean;
-        showMoveButton?: boolean;
-        showBorder?: boolean;
-        showSizeText?: boolean;
-        borderStyle?: {
-            isDashed: boolean;
-            dashArray?: [number, number];
-        };
-    }): void;
-    /**
-     * 清空所有编辑控制层
-     */
-    clearAll(): void;
-    /**
-     * 获取所有编辑控制层
-     * @returns 所有编辑控制层的数组
-     */
-    getAllEditControls(): EditControlLayer[];
-    updatePositionByOrigin(x: number, y: number): void;
-    /**
-     * 检查是否存在编辑控制层
-     * @param id 组件唯一标识
-     * @returns 是否存在
-     */
-    hasEditControl(id: string | number): boolean;
-}
-
-/**
- * 固定大小动画精灵基类
- * 基于 EnhancedSprite 扩展，支持帧动画播放
- *
- * 两种模式：
- * 1. sizeFixed: true - 固定屏幕像素大小，不受地图缩放影响
- * 2. sizeFixed: false - 以地图scale=1为基准，跟随地图缩放
- */
-declare class EnhancedAnimatedSprite extends AnimatedSprite {
-    protected appService: AppService;
-    private throttledUpdateScale;
-    private fixedWidth;
-    private fixedHeight;
-    private isFixedSizeSet;
-    private sizeFixed;
-    private baselineScale;
-    private static animationTicker;
-    private static animatedSprites;
-    constructor(appService: AppService, 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 imageSrc 动画图片资源路径
-     * @param framePrefix 帧名称前缀，例如 "sleep_"
-     * @param frameCount 帧数量
-     * @returns Promise<Texture[]> 纹理数组
-     */
-    static loadAnimationTextures(jsonSrc: string, imageSrc: 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 {
-    protected appService: AppService;
-    private throttledUpdateScale;
-    private fixedWidth;
-    private fixedHeight;
-    private isFixedSizeSet;
-    private sizeFixed;
-    private baselineScale;
-    constructor(appService: AppService, 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 FixedSizeContainer extends Container {
-    protected appService: AppService;
-    private throttledUpdateScale;
-    constructor(appService: AppService);
-    /**
-     * 注册缩放事件监听
-     */
-    private registerScaleListener;
-    /**
-     * 更新元素缩放，以保持固定大小
-     */
-    protected updateScale(scale: number): void;
-    /**
-     * 组件销毁时清理资源
-     */
-    destroy(options?: {
-        children?: boolean;
-        texture?: boolean;
-        baseTexture?: boolean;
-    }): void;
-}
-
-declare class Free extends Graphics {
-    private appService;
-    constructor(appService: AppService);
-    /**
-     * 绘制结构化自由区域数据
-     * @param free 自由区域数据数组
-     */
-    draw(free: {
-        coordinates: number[];
-    }[]): void;
-    destroy(options?: DestroyOptions | boolean): void;
-}
-
-/** 家具素材配置 */
-export declare type FurnitureAsset = {
-    /** 家具类型编号，匹配 FurnitureParam.furnitureType */
-    type: number
-    /** 图片 URL */
-    src: string
-    /** 默认宽度 (米，用于生成初始 points，内部根据 resolution 转换为像素) */
-    width: number
-    /** 默认高度 (米，用于生成初始 points，内部根据 resolution 转换为像素) */
-    height: number
-}
-
-/** 家具配置 */
-export declare type FurnitureConfig = {
-    /** 家具素材列表 */
-    assets: FurnitureAsset[]
-    /** 全局透明度 (0-1, 默认 1) */
-    opacity: number
-    /** 图标容器填充颜色 */
-    iconWrapperFillColor: ColorSource
-    /** 轮廓偏移 */
-    outlineOffset: number
-    /** 轮廓描边颜色 */
-    outlineStrokeColor: ColorSource
-    /** 轮廓描边宽度 */
-    outlineStrokeWidth: number
-    /** 轮廓填充颜色 */
-    outlineFillColor: ColorSource
-    /** 轮廓是否虚线 */
-    outlineDashed: boolean
-    /** 轮廓虚线数组 */
-    outlineDashArray: [number, number]
-    /** 是否显示尺寸文本 */
-    showSizeText: boolean
-    /** 文本颜色 */
-    textColor: ColorSource
-    /** 文本位置 */
-    textPosition: 'top' | 'right' | 'bottom' | 'left'
-    /** 文本偏移 */
-    textOffset: number
-    /** 缩放按钮允许的最小缩放倍数 (相对初始尺寸, 默认 0.5; 设为 0 表示不限制最小) */
-    minScaleRatio: number
-    /** 缩放按钮允许的最大缩放倍数 (相对初始尺寸, 默认 2; 设为 Infinity 表示不限制最大) */
-    maxScaleRatio: number
-    /** 点击旋转方向: 'cw' 顺时针 | 'ccw' 逆时针 (默认 'cw') */
-    rotateDirection: 'cw' | 'ccw'
-}
-
-declare class FurnitureManager_2 {
-    private appService;
-    private furnitureMap;
-    private unsubscribeFns;
-    constructor(appService: AppService);
-    updatePositionByOrigin(x: number, y: number): void;
-    drawFurnitures(items: FurnitureParam[]): Promise<void>;
-    private addFurniture;
-    private removeFurniture;
-    private clearAll;
-    private updateEditState;
-    private isDataEqual;
-    destroy(): void;
-}
-
-/** 家具参数 */
-export declare type FurnitureParam = {
-    /** 家具ID */
-    id: string
-    /** 家具类型编号，匹配 config.furniture.assets 中的 type */
-    furnitureType: number
-    /** 四个顶点坐标 (顺时针: 左上→右上→右下→左下) */
-    points: Point[]
-}
-
-/**
- * GIF 类型自定义元素参数
- * 保持现有逻辑
- */
-export declare type GifCustomElementParam = BaseCustomElementParam & {
-    /** 元素类型 */
-    type: 'gif'
-    /** GIF资源路径 */
-    src: string
-    /** GIF宽度（必需 - GIF 需要明确尺寸） */
-    width: number
-    /** GIF高度（必需 - GIF 需要明确尺寸） */
-    height: number
-    /**
-     * 锚点位置
-     *
-     * 定义GIF的锚点位置，用于控制GIF相对于坐标点的对齐方式
-     * - {x: 0, y: 0} 表示左上角
-     * - {x: 0.5, y: 0.5} 表示中心点（默认）
-     * - {x: 0.5, y: 1} 表示底部中心（适用于气泡图标）
-     * - {x: 1, y: 1} 表示右下角
-     */
-    anchor?: Point
-}
-
-declare class Heatmap extends Container {
-    private appService;
-    colorGradients: Array<string>;
-    cellSize: number;
-    constructor(appService: AppService);
-    /**
-     * 绘制热力图
-     * @param grid 处理好的热力数据 每个网格的信号强度 和 坐标
-     * @param useGradient 是否使用渐变绘制
-     */
-    draw(grid: Array<Array<{
-        x: number;
-        y: number;
-        signal: number;
-        hasPoint: boolean;
-    }>>, heatmapAlpha?: number): void;
-    /**
-     * 裁剪热力图 仅显示房间区域
-     * 根据roomFill图层的子元素 组合Graphics生成大Graphics裁剪
-     * @param heatmap 热力图mesh
-     */
-    private croppingHeatmap;
-    /**
-     * 网格绘制热力图 我网格模式
-     * @param grid 处理好的热力数据 每个网格的信号强度 和 坐标
-     * @returns 网格热力图mesh
-     */
-    private gridDrawing;
-    /**
-     * 渐变绘制热力图
-     * @param grid 处理好的热力数据 每个网格的信号强度 和 坐标
-     * @returns 渐变热力图mesh
-     */
-    private gradientDrawing;
-    /**
-     * 更新位置
-     * @param x
-     * @param y
-     */
-    updatePositionByOrigin(x: number, y: number): void;
-    /**
-     * 销毁热力图
-     */
-    destroy(): void;
-}
-
-declare class HeatmapManager_2 {
-    private appService;
-    heatmap: Heatmap;
-    pointsTopLeftOrigin: HeatmapPoint[];
-    signalGrid: Array<Array<{
-        x: number;
-        y: number;
-        signal: number;
-        hasPoint: boolean;
-    }>>;
-    cellSize: number;
-    maxDistance: number;
-    smoothIterations: number;
-    heatmapAlpha: number;
-    isHeatmapDrawn: boolean;
-    private loadTimer;
-    constructor(appService: AppService);
-    /**
-     * 绘制热力图
-     * @param mapData 地图数据
-     * @param heatmapPoints 热力图点
-     * @returns
-     */
-    private pendingPoints;
-    /**
-     * 绘制热力图
-     * @param mapData 地图数据
-     * @param heatmapPoints 热力图点
-     * @returns
-     */
-    draw(heatmapPoints: HeatmapPoint[]): void;
-    /**
-     * 地图加载完成回调
-     */
-    onMapLoaded(): void;
-    /**
-     * 插值计算信号网格
-     * @param pointsTopLeftOrigin 热力图路径点
-     * @returns 信号网格
-     */
-    calculateInterpolatedSignal(pointsTopLeftOrigin: HeatmapPoint[]): {
-        x: number;
-        y: number;
-        signal: number;
-        hasPoint: boolean;
-    }[][];
-    /**
-     * 更新热力图位置
-     * @param x
-     * @param y
-     */
-    updatePositionByOrigin(x: number, y: number): void;
-    /**
-     * 销毁热力图
-     */
-    destroy(): void;
-}
-
-/** 热力图点 */
-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
-    /**
-     * 锚点位置
-     *
-     * 定义图片的锚点位置，用于控制图片相对于坐标点的对齐方式
-     * - {x: 0, y: 0} 表示左上角
-     * - {x: 0.5, y: 0.5} 表示中心点（默认）
-     * - {x: 0.5, y: 1} 表示底部中心（适用于气泡图标）
-     * - {x: 1, y: 1} 表示右下角
-     */
-    anchor?: Point
-}
-
-/* Excluded from this release type: InstanceEvents */
-
-declare class Interaction_2 extends Container {
-    private appService;
-    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;
-    taintedPointers: Set<number>;
-    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 mapClickStartPosition;
-    private mapClickStartTime;
-    private readonly mapClickTimeThreshold;
-    private readonly mapClickMoveThreshold;
-    private shouldSuppressMapClick;
-    private isGestureHijacked;
-    private hijackedPointerId;
-    private isHijackPaused;
-    private interactionGraphics;
-    private viewportBounds;
-    private boundResetAnimation;
-    private debouncedStopWheelRender;
-    private debouncedLogWheelScale;
-    private interactionState;
-    private throttledAntiScale;
-    private unsubscribeEnableInteraction;
-    constructor(appService: AppService);
-    /**
-     * 更新交互模式
-     * @param enabled 是否启用交互
-     */
-    private updateInteractionMode;
-    setupInteraction(): void;
-    /**
-     * 处理全局取消或失去焦点事件
-     */
-    private handleGlobalCancel;
-    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 handleSuppressMapClick;
-    /**
-     * 处理手势劫持
-     */
-    private handleGestureHijacked;
-    /**
-     * 退出手势劫持模式
-     */
-    private exitGestureHijacked;
-    /**
-     * 强制结束当前正在进行的手势交互
-     */
-    forceEndGesture(): void;
-    /**
-     * 暂停手势劫持（双指模式）
-     */
-    private pauseGestureHijack;
-    /**
-     * 恢复手势劫持（回到单指模式）
-     */
-    private resumeGestureHijack;
-    private antiScale;
-    private resetAnimation;
-    private onWheel;
-    private onPointerDown;
-    private onPointerUp;
-    private detectDoubleTap;
-    private detectMapClick;
-    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_2;
-    heatmapManager: HeatmapManager_2;
-    pathManager: PathManager_2;
-    controlsManager: ControlsManager_2;
-    detectedObjectManager: DetectedObjectManager_2;
-    customElementsManager: CustomElementsManager_2;
-    roomsManager: RoomManager_2;
-    customCarpetManager: CustomCarpetManager;
-    furnitureManager: FurnitureManager_2;
-    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", "getFurniturePointsByViewportCenter"];
-
-export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateWayPoint", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickWayPoint", "onClickDetectedObject", "onClickCustomElement", "onClickMap", "onClickCarpet", "onDeleteCarpet", "onUpdateCustomCarpet", "onDeleteCustomCarpet", "onGestureStart", "onGestureEnd", "onClickRobot", "onClickChargingStation", "onRemoveFurniture", "onUpdateFurniture", "onClickFurniture"];
-
-/**
- * 地图 API 接口定义
- *
- * 这个接口定义了所有可供调用的地图操作方法。
- *
- * 通过onMapReady回调获得的 `mapApi` 对象实现了这个接口。
- *
- */
-export declare interface MapApi {
-    /** 地图是否绘制完成 */
-    isMapDrawn: boolean;
-    /**
-     * 重置地图的平移和缩放状态
-     *
-     * 将地图的缩放和平移状态重置到初始位置，使地图完整显示在视口中。
-     */
-    resetPanZoom(): void;
-    /**
-     * 强制结束当前正在进行的手势交互
-     *
-     * 当小程序侧检测到 touchend 或其他需要强制结束手势的情况时调用。
-     */
-    forceEndGesture(): void;
-    /**
-     * 更新运行时配置
-     *
-     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
-     *
-     * @param runtime - 要更新的运行时配置
-     */
-    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
-    /**
-     * 动态更新静态配置
-     *
-     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
-     * 主要用于主题切换、颜色调整等场景。
-     *
-     * @param partialConfig - 部分配置对象，支持深度增量更新
-     *
-     * @example
-     * ```typescript
-     * // 切换背景颜色
-     * mapApp.updateConfig({
-     *   global: { backgroundColor: '#1a1a1a' }
-     * })
-     *
-     * // 切换房间颜色主题
-     * mapApp.updateConfig({
-     *   room: {
-     *     colors: {
-     *       active: ['#ff6b6b', '#4ecdc4', '#45b7d1', '#ffa07a'],
-     *       inactive: ['#ffcccb', '#b4f8c8', '#a0e7e5', '#ffdab9'],
-     *     }
-     *   }
-     * })
-     *
-     * // 更新路径样式
-     * mapApp.updateConfig({
-     *   path: {
-     *     commonPath: { color: '#00ff00', width: 0.8 }
-     *   }
-     * })
-     * ```
-     */
-    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
-    /**
-     * 更新运行时配置
-     *
-     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
-     *
-     * @param runtime - 要更新的运行时配置
-     */
-    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
-    /**
-     * 动态更新静态配置
-     *
-     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
-     * 主要用于主题切换、颜色调整等场景。
-     *
-     * @param partialConfig - 部分配置对象，支持深度增量更新
-     *
-     * @example
-     * ```typescript
-     * // 切换背景颜色
-     * mapApp.updateConfig({
-     *   global: { backgroundColor: '#1a1a1a' }
-     * })
-     *
-     * // 切换房间颜色主题
-     * mapApp.updateConfig({
-     *   room: {
-     *     colors: {
-     *       active: ['#ff6b6b', '#4ecdc4', '#45b7d1', '#ffa07a'],
-     *       inactive: ['#ffcccb', '#b4f8c8', '#a0e7e5', '#ffdab9'],
-     *     }
-     *   }
-     * })
-     *
-     * // 更新路径样式
-     * mapApp.updateConfig({
-     *   path: {
-     *     commonPath: { color: '#00ff00', width: 0.8 }
-     *   }
-     * })
-     * ```
-     */
-    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
-    /**
-     * 获取当前地图上所有禁扫区域数据
-     *
-     * @returns 区域数据数组
-     */
-    getForbiddenSweepZones(): ZoneParam[];
-    /**
-     * 获取当前地图上所有禁拖区域数据
-     *
-     * @returns 区域数据数组
-     */
-    getForbiddenMopZones(): ZoneParam[];
-    /**
-     * 获取当前地图上所有清扫区域数据
-     *
-     * @returns 区域数据数组
-     */
-    getCleanZones(): ZoneParam[];
-    /**
-     * 获取当前地图上所有自定义地毯数据
-     *
-     * @returns 地毯数据数组
-     */
-    getCustomCarpets(): CustomCarpetParam[];
-    /**
-     * 获取当前地图上所有虚拟墙数据
-     *
-     * @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[];
-    /**
-     * 绘制家具
-     *
-     * 通过 diff 机制驱动家具的增删改：
-     * - 新 ID 会被添加
-     * - 已有 ID 的数据变化会被更新
-     * - 不在列表中的已有 ID 会被移除
-     * - 传入空数组即清空所有家具
-     *
-     * @param items - 家具数据数组
-     */
-    drawFurnitures(items: FurnitureParam[]): void;
-    /**
-     * 基于视口中心生成家具顶点坐标
-     *
-     * 根据当前视口中心位置和指定的家具类型，生成家具的四个顶点坐标。
-     * 初始尺寸来源于 config.furniture.assets 中对应类型的 width/height。
-     *
-     * @param options - 配置选项
-     * @param options.furnitureType - 家具类型编号，匹配 config.furniture.assets 中的 type
-     * @param options.offsetX - X方向像素偏移，默认为 0
-     * @param options.offsetY - Y方向像素偏移，默认为 0
-     * @returns 家具的四个顶点坐标数组
-     */
-    getFurniturePointsByViewportCenter(options?: {
-        furnitureType?: 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;
-    /**
-     * 判断指定的房间是否相邻（连通）
-     *
-     * 支持结构化地图和点阵地图两种协议。对于多个房间，使用连通性算法判断：
-     * 只要房间之间能通过相邻关系连接起来，就认为它们是相邻的。
-     * 例如：房间A和B相邻，房间B和C相邻，则认为A、B、C三个房间都相邻。
-     *
-     * @param roomIds - 要检测的房间ID数组
-     * @returns 是否所有指定的房间都相邻（连通）
-     */
-    areRoomsAdjacent(roomIds: number[]): boolean;
-    /**
-     * 判断一个点是否与充电桩或机器人距离小于阈值。
-     *
-     * @param points - 点坐标数组
-     * @param thresholdMeters - 阈值距离，单位米
-     * @param options - 配置选项
-     * @param options.checkCharger - 是否检查与充电桩的距离，默认为 true
-     * @param options.checkRobot - 是否检查与机器人的距离，默认为 false
-     * @returns 是否在判定范围内（true 表示过近，false 表示距离足够）
-     */
-    isNearChargerOrRobot(points: Point[], thresholdMeters: number, options?: {
-        checkCharger?: boolean;
-        checkRobot?: boolean;
-    }): boolean;
-    /**
-     * 判断一个点是否在任意房间内
-     *
-     * 接受机器坐标系的点（相对于origin的坐标），遍历所有房间，
-     * 判断该点是否在某个房间内。支持结构化地图和点阵地图两种协议。
-     * 方法内部会自动将机器坐标系转换为地图坐标系进行检测。
-     *
-     * @param point - 待检测的点坐标（机器坐标系，与Zone、VirtualWall等使用相同的坐标系）
-     * @returns 如果点在某个房间内，返回该房间的RoomData；否则返回null
-     */
-    isPointInAnyRoom(point: Point): RoomData | null;
-    /**
-     * 判断墙体（线段）是否与任意房间有交集
-     *
-     * 接受机器坐标系的墙体端点（相对于origin的坐标），遍历所有房间，
-     * 判断墙体是否与某个房间有交集。支持结构化地图和点阵地图两种协议。
-     * 方法内部会自动将机器坐标系转换为地图坐标系进行检测。
-     *
-     * @param points - 墙体的两个端点坐标（机器坐标系，与VirtualWall等使用相同的坐标系）
-     * @returns 如果有交集返回 true，否则返回 false
-     */
-    isWallIntersectsAnyRoom(points: [Point, Point]): boolean;
-    /**
-     * 判断区域（矩形）是否与任意房间有交集
-     *
-     * 接受机器坐标系的区域顶点（相对于origin的坐标），遍历所有房间，
-     * 判断区域是否与某个房间有交集。支持结构化地图和点阵地图两种协议。
-     * 方法内部会自动将机器坐标系转换为地图坐标系进行检测。
-     *
-     * @param points - 区域的四个顶点坐标（机器坐标系，与Zone等使用相同的坐标系）
-     * @returns 如果有交集返回 true，否则返回 false
-     */
-    isZoneIntersectsAnyRoom(points: [Point, Point, Point, Point]): boolean;
-    /**
-     * 地图截图
-     *
-     * 将当前地图状态导出为图片。截图过程中会自动添加一个临时的背景层，
-     * 确保禁区等半透明元素在截图中能够正确显示颜色。
-     *
-     * @param options - 截图配置选项
-     * @param options.backgroundColor - 指定截图时的背景颜色。若不指定，将默认使用 `global.config.backgroundColor`。支持颜色字符串、十六进制数值或 RGB 数组。
-     * @returns Promise<string> Base64 格式的图片数据 (Data URL)
-     */
-    snapshot(options?: {
-        backgroundColor?: ColorSource;
-    }): Promise<string>;
+    anchor?: Point
+}
+
+/** 热力图点 */
+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
     /**
-     * 使用自定义地图数据生成截图
-     *
-     * 基于提供的地图、路径、区域等数据生成截图，通常用于多地图管理界面的缩略图预览。
-     * 此方法会创建一个临时的离屏渲染实例，不会影响当前正在运行的地图显示状态。
+     * 锚点位置
      *
-     * @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 - 可选的 AI 物体检测数据数组
-     * @param data.furnitures - 可选的家具数据数组
-     * @param runtime - 可选的运行时配置 (如是否显示机器人、充电桩等状态)
-     * @param options - 截图配置选项
-     * @param options.backgroundColor - 指定生成截图时的背景颜色。若不指定，将默认使用 `global.config.backgroundColor`。
-     * @returns Promise<string> Base64 格式的图片数据 (Data URL)
+     * 定义图片的锚点位置，用于控制图片相对于坐标点的对齐方式
+     * - {x: 0, y: 0} 表示左上角
+     * - {x: 0.5, y: 0.5} 表示中心点（默认）
+     * - {x: 0.5, y: 1} 表示底部中心（适用于气泡图标）
+     * - {x: 1, y: 1} 表示右下角
      */
-    snapshotByData(data: {
-        map: string;
-        path?: string;
-        roomProperties?: RoomProperty[];
-        customElements?: CustomElementParam[];
-        forbiddenSweepZones?: ZoneParam[];
-        forbiddenMopZones?: ZoneParam[];
-        virtualWalls?: VirtualWallParam[];
-        detectedObjects?: DetectedObjectParam[];
-        furnitures?: FurnitureParam[];
-    }, runtime?: DeepPartialRuntimeConfig, options?: {
-        backgroundColor?: ColorSource;
-    }): Promise<string>;
+    anchor?: Point
 }
 
+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", "getFurniturePointsByViewportCenter"];
+
+export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateWayPoint", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickWayPoint", "onClickDetectedObject", "onClickCustomElement", "onClickMap", "onClickCarpet", "onDeleteCarpet", "onUpdateCustomCarpet", "onDeleteCustomCarpet", "onGestureStart", "onGestureEnd", "onClickRobot", "onClickChargingStation", "onRemoveFurniture", "onUpdateFurniture", "onClickFurniture"];
+
 /**
- * 地图应用核心类
+ * 地图 API 接口定义
+ *
+ * 这个接口定义了所有可供调用的地图操作方法。
+ *
+ * 通过onMapReady回调获得的 `mapApi` 对象实现了这个接口。
  *
- * 地图应用的核心类，继承自 PIXI.Application，提供完整的地图渲染、交互和管理功能。
- * 支持扫地机器人地图的显示、路径绘制、房间管理、控制元素（禁区、虚拟墙等）等功能。
  */
-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: appService */
-    /* 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: containerElement */
-    /* Excluded from this release type: emitter */
-    /* Excluded from this release type: tickerState */
-    private pendingAsyncRender;
-    private isFirstMapDraw;
+export declare interface MapApi {
     /** 地图是否绘制完成 */
     isMapDrawn: boolean;
-    /* 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>;
+    resetPanZoom(): void;
     /**
-     * 绘制结构化地图数据
-     *
-     * 根据结构化的地图数据源绘制地图，包括房间、障碍物、充电桩等元素。
-     *
-     * @param mapData - 结构化地图数据源
-     * @returns Promise<void>
+     * 强制结束当前正在进行的手势交互
      *
+     * 当小程序侧检测到 touchend 或其他需要强制结束手势的情况时调用。
      */
-    drawMap(mapData: StructuredMapDataSource): Promise<void>;
+    forceEndGesture(): void;
     /**
-     * 绘制栅格地图数据
-     *
-     * 根据点阵地图数据绘制地图，支持点阵格式的地图数据。
+     * 更新运行时配置
      *
-     * @param rasterMapData - 栅格地图数据对象
-     * @param rasterMapData.mapHeader - 地图头部信息，包含分辨率、原点等
-     * @param rasterMapData.mapData - 地图像素数据
-     * @returns Promise<void>
+     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
      *
+     * @param runtime - 要更新的运行时配置
      */
-    drawRasterMap(rasterMapData: {
-        mapHeader: MapHeader;
-        mapData: MapData;
-    }): Promise<void>;
+    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
     /**
-     * 绘制机器人路径
-     *
-     * 根据路径数据绘制机器人的移动轨迹，包括普通路径、充电路径等不同类型。
-     *
-     * @param pathData - 路径数据对象
-     * @returns void
+     * 动态更新静态配置
      *
-     */
-    drawPath(pathData: PathData): void;
-    /**
-     * 绘制房间属性信息
+     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
+     * 主要用于主题切换、颜色调整等场景。
      *
-     * 绘制房间的详细属性信息，如吸力、水量、清扫次数等。
+     * @param partialConfig - 部分配置对象，支持深度增量更新
      *
-     * @param roomInfos - 房间属性信息数组
-     * @returns void
+     * @example
+     * ```typescript
+     * // 切换背景颜色
+     * mapApp.updateConfig({
+     *   global: { backgroundColor: '#1a1a1a' }
+     * })
      *
-     */
-    drawRoomProperty(roomInfos: RoomProperty[]): Promise<void>;
-    /**
-     * 绘制自定义地毯
-     * @param carpets 自定义地毯数组
-     * @returns void
-     */
-    drawCustomCarpets(carpets: CustomCarpetParam[]): Promise<void>;
-    /**
-     * 绘制家具
-     * @param items - 家具参数数组
-     */
-    drawFurnitures(items: FurnitureParam[]): Promise<void>;
-    /**
-     * 绘制热力图
-     * @param param - 绘制参数
-     * @returns void
+     * // 切换房间颜色主题
+     * mapApp.updateConfig({
+     *   room: {
+     *     colors: {
+     *       active: ['#ff6b6b', '#4ecdc4', '#45b7d1', '#ffa07a'],
+     *       inactive: ['#ffcccb', '#b4f8c8', '#a0e7e5', '#ffdab9'],
+     *     }
+     *   }
+     * })
      *
+     * // 更新路径样式
+     * mapApp.updateConfig({
+     *   path: {
+     *     commonPath: { color: '#00ff00', width: 0.8 }
+     *   }
+     * })
+     * ```
      */
-    drawHeatmap(heatmapPoints: HeatmapPoint[]): 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 wayPoints - 途径点参数数组
-     */
-    drawWayPoints(wayPoints: WayPointParam[]): void;
-    /**
-     * 绘制检测到的物体
-     * @param objects - 检测物体参数数组
-     */
-    drawDetectedObjects(objects: DetectedObjectParam[]): Promise<void>;
-    /**
-     * 绘制自定义地毯
-     * @param customCarpet - 自定义地毯参数数组
-     */
-    drawCustomCarpet(customCarpet: CustomCarpetParam[]): void;
-    /**
-     * 绘制自定义元素
-     * @param elements - 自定义元素参数数组
-     */
-    drawCustomElements(elements: CustomElementParam[]): Promise<void>;
+    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
     /**
-     * 获取当前地图上所有禁扫区域数据
+     * 更新运行时配置
      *
-     * @returns 区域数据数组
-     */
-    getForbiddenSweepZones(): ZoneParam[];
-    /**
-     * 获取当前地图上所有禁拖区域数据
+     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
      *
-     * @returns 区域数据数组
+     * @param runtime - 要更新的运行时配置
      */
-    getForbiddenMopZones(): ZoneParam[];
+    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
     /**
-     * 获取当前地图上所有清扫区域数据
+     * 动态更新静态配置
      *
-     * @returns 区域数据数组
-     */
-    getCleanZones(): ZoneParam[];
-    /**
-     * 获取当前地图上所有虚拟墙数据
+     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
+     * 主要用于主题切换、颜色调整等场景。
      *
-     * @returns 虚拟墙数据数组
-     */
-    getVirtualWalls(): VirtualWallParam[];
-    /**
-     * 获取当前地图上所有定点清扫数据
+     * @param partialConfig - 部分配置对象，支持深度增量更新
      *
-     * @returns 定点清扫数据数组
-     */
-    getSpots(): SpotParam[];
-    /**
-     * 获取当前地图上所有途径点数据
+     * @example
+     * ```typescript
+     * // 切换背景颜色
+     * mapApp.updateConfig({
+     *   global: { backgroundColor: '#1a1a1a' }
+     * })
      *
-     * @returns 途径点数据数组
-     */
-    getWayPoints(): WayPointParam[];
-    /**
-     * 获取分割线有效端点
-     * @returns 分割线有效端点
-     */
-    getEffectiveDividerPoints(): Point[] | null;
-    /**
-     * 获取当前地图上所有自定义地毯数据
-     * @returns 地毯数据数组
-     */
-    getCustomCarpets(): CustomCarpetParam[];
-    /**
-     * 获取分割线端点
-     * @returns 分割线端点
+     * // 切换房间颜色主题
+     * mapApp.updateConfig({
+     *   room: {
+     *     colors: {
+     *       active: ['#ff6b6b', '#4ecdc4', '#45b7d1', '#ffa07a'],
+     *       inactive: ['#ffcccb', '#b4f8c8', '#a0e7e5', '#ffdab9'],
+     *     }
+     *   }
+     * })
      *
+     * // 更新路径样式
+     * mapApp.updateConfig({
+     *   path: {
+     *     commonPath: { color: '#00ff00', width: 0.8 }
+     *   }
+     * })
+     * ```
      */
-    getDividerEndPoints(): Point[] | null;
+    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
     /**
-     * 重置地图的平移和缩放状态
+     * 获取当前地图上所有禁扫区域数据
      *
-     * 将地图的缩放和平移状态重置到初始位置，使地图完整显示在视口中。
+     * @returns 区域数据数组
      */
-    resetPanZoom(): void;
+    getForbiddenSweepZones(): ZoneParam[];
     /**
-     * 强制结束当前正在进行的手势交互
+     * 获取当前地图上所有禁拖区域数据
      *
-     * 当小程序侧检测到 touchend 或其他需要强制结束手势的情况时调用。
-     */
-    forceEndGesture(): void;
-    /**
-     * 将地图适配到视图中，居中并缩放
-     * @param mapBounds 地图边界信息
-     * @param animate 是否使用动画过渡，默认为 false
-     */
-    fitMapToView(mapBounds: Bounds, animate?: boolean): void;
-    /* Excluded from this release type: calculateRotatedBounds */
-    /**
-     * 获取视口边界（供 Interaction 等组件使用）
+     * @returns 区域数据数组
      */
-    getViewportBounds(): {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
+    getForbiddenMopZones(): ZoneParam[];
     /**
-     * 更新运行时配置
-     *
-     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
+     * 获取当前地图上所有清扫区域数据
      *
-     * @param runtime - 要更新的运行时配置
+     * @returns 区域数据数组
      */
-    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
+    getCleanZones(): ZoneParam[];
     /**
-     * 动态更新静态配置
-     *
-     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
-     * 主要用于主题切换、颜色调整等场景。
+     * 获取当前地图上所有自定义地毯数据
      *
-     * @param partialConfig - 部分配置对象，支持深度增量更新
+     * @returns 地毯数据数组
      */
-    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
+    getCustomCarpets(): CustomCarpetParam[];
     /**
-     * 将米转换为像素
-     *
-     * 根据地图分辨率将米单位转换为像素单位。
+     * 获取当前地图上所有虚拟墙数据
      *
-     * @param meters - 米数值
-     * @returns 像素值
+     * @returns 虚拟墙数据数组
      */
-    metersToPixels(meters: number): number;
+    getVirtualWalls(): VirtualWallParam[];
     /**
-     * 将像素转换为米
-     *
-     * 根据地图分辨率将像素单位转换为米单位。
+     * 获取当前地图上所有定点清扫数据
      *
-     * @param pixels - 像素值
-     * @returns 米数值
+     * @returns 定点清扫数据数组
      */
-    pixelsToMeters(pixels: number): number;
+    getSpots(): SpotParam[];
     /**
-     * 将基础尺寸转换为固定显示尺寸（不受缩放影响）
-     *
-     * 基础尺寸是基于 scale=1 的标准尺寸，需要根据当前缩放级别进行调整。
-     *
-     * @param baseSize - 基础尺寸
-     * @param currentScale - 当前缩放级别，不传则自动获取
-     * @returns 固定显示尺寸
+     * 获取分割线有效端点
+     * @returns 分割线有效端点
      */
-    toFixedSize(baseSize: number, currentScale?: number): number;
+    getEffectiveDividerPoints(): Point[] | null;
     /**
-     * 将固定显示尺寸转换为基础尺寸（反向转换）
-     *
-     * @param fixedSize - 固定显示尺寸
-     * @param currentScale - 当前缩放级别，不传则自动获取
-     * @returns 基础尺寸
+     * 获取分割线端点
+     * @returns 分割线端点
      */
-    fromFixedSize(fixedSize: number, currentScale?: number): number;
+    getDividerEndPoints(): Point[] | null;
     /**
      * 获取当前视口中心点坐标
      *
@@ -3871,6 +1237,35 @@ declare class MapApplication extends Application implements MapApi {
         offsetX?: number;
         offsetY?: number;
     }): Point[];
+    /**
+     * 绘制家具
+     *
+     * 通过 diff 机制驱动家具的增删改：
+     * - 新 ID 会被添加
+     * - 已有 ID 的数据变化会被更新
+     * - 不在列表中的已有 ID 会被移除
+     * - 传入空数组即清空所有家具
+     *
+     * @param items - 家具数据数组
+     */
+    drawFurnitures(items: FurnitureParam[]): void;
+    /**
+     * 基于视口中心生成家具顶点坐标
+     *
+     * 根据当前视口中心位置和指定的家具类型，生成家具的四个顶点坐标。
+     * 初始尺寸来源于 config.furniture.assets 中对应类型的 width/height。
+     *
+     * @param options - 配置选项
+     * @param options.furnitureType - 家具类型编号，匹配 config.furniture.assets 中的 type
+     * @param options.offsetX - X方向像素偏移，默认为 0
+     * @param options.offsetY - Y方向像素偏移，默认为 0
+     * @returns 家具的四个顶点坐标数组
+     */
+    getFurniturePointsByViewportCenter(options?: {
+        furnitureType?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
     /**
      * 基于视口中心生成定点清扫的点坐标
      *
@@ -3885,14 +1280,6 @@ declare class MapApplication extends Application implements MapApi {
         offsetX?: number;
         offsetY?: number;
     }): Point;
-    /**
-     * 基于视口中心生成家具顶点坐标
-     */
-    getFurniturePointsByViewportCenter(options?: {
-        furnitureType?: number;
-        offsetX?: number;
-        offsetY?: number;
-    }): Point[];
     /**
      * 判断指定的房间是否相邻（连通）
      *
@@ -3902,9 +1289,22 @@ declare class MapApplication extends Application implements MapApi {
      *
      * @param roomIds - 要检测的房间ID数组
      * @returns 是否所有指定的房间都相邻（连通）
-     *
      */
     areRoomsAdjacent(roomIds: number[]): boolean;
+    /**
+     * 判断一个点是否与充电桩或机器人距离小于阈值。
+     *
+     * @param points - 点坐标数组
+     * @param thresholdMeters - 阈值距离，单位米
+     * @param options - 配置选项
+     * @param options.checkCharger - 是否检查与充电桩的距离，默认为 true
+     * @param options.checkRobot - 是否检查与机器人的距离，默认为 false
+     * @returns 是否在判定范围内（true 表示过近，false 表示距离足够）
+     */
+    isNearChargerOrRobot(points: Point[], thresholdMeters: number, options?: {
+        checkCharger?: boolean;
+        checkRobot?: boolean;
+    }): boolean;
     /**
      * 判断一个点是否在任意房间内
      *
@@ -3914,7 +1314,6 @@ declare class MapApplication extends Application implements MapApi {
      *
      * @param point - 待检测的点坐标（机器坐标系，与Zone、VirtualWall等使用相同的坐标系）
      * @returns 如果点在某个房间内，返回该房间的RoomData；否则返回null
-     *
      */
     isPointInAnyRoom(point: Point): RoomData | null;
     /**
@@ -3926,9 +1325,8 @@ declare class MapApplication extends Application implements MapApi {
      *
      * @param points - 墙体的两个端点坐标（机器坐标系，与VirtualWall等使用相同的坐标系）
      * @returns 如果有交集返回 true，否则返回 false
-     *
      */
-    isWallIntersectsAnyRoom(points: Point[]): boolean;
+    isWallIntersectsAnyRoom(points: [Point, Point]): boolean;
     /**
      * 判断区域（矩形）是否与任意房间有交集
      *
@@ -3938,61 +1336,43 @@ declare class MapApplication extends Application implements MapApi {
      *
      * @param points - 区域的四个顶点坐标（机器坐标系，与Zone等使用相同的坐标系）
      * @returns 如果有交集返回 true，否则返回 false
-     *
-     */
-    isZoneIntersectsAnyRoom(points: Point[]): boolean;
-    /**
-     * 判断点、墙体或区域是否距离充电桩或机器人位置过近
-     *
-     * 根据给定的坐标集合（点1个、墙体2个点或区域4个点）和判定阈值，
-     * 计算其与充电桩和/或机器人位置的最小距离，判断是否在阈值范围内。
-     *
-     * @param points - 点（1个）、墙体（2个点）或区域（4个点）的坐标集合（机器坐标系）
-     * @param thresholdMeters - 判定阈值，单位为米
-     * @param options - 配置选项
-     * @param options.checkCharger - 是否检查与充电桩的距离，默认为 true
-     * @param options.checkRobot - 是否检查与机器人的距离，默认为 false
-     * @returns 是否在判定范围内（true 表示过近，false 表示距离足够）
-     *
      */
-    isNearChargerOrRobot(points: Point[], thresholdMeters: number, options?: {
-        checkCharger?: boolean;
-        checkRobot?: boolean;
-    }): boolean;
+    isZoneIntersectsAnyRoom(points: [Point, Point, Point, Point]): boolean;
     /**
      * 地图截图
      *
-     * 将当前地图状态导出为图片。截图过程中使用离屏渲染技术，
-     * 确保禁区等半透明元素在截图中能够正确显示颜色，同时避免主视图闪烁。
+     * 将当前地图状态导出为图片。截图过程中会自动添加一个临时的背景层，
+     * 确保禁区等半透明元素在截图中能够正确显示颜色。
      *
      * @param options - 截图配置选项
      * @param options.backgroundColor - 指定截图时的背景颜色。若不指定，将默认使用 `global.config.backgroundColor`。支持颜色字符串、十六进制数值或 RGB 数组。
      * @returns Promise<string> Base64 格式的图片数据 (Data URL)
-     *
      */
     snapshot(options?: {
         backgroundColor?: ColorSource;
     }): 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 格式的图片数据
+     * 使用自定义地图数据生成截图
      *
+     * 基于提供的地图、路径、区域等数据生成截图，通常用于多地图管理界面的缩略图预览。
+     * 此方法会创建一个临时的离屏渲染实例，不会影响当前正在运行的地图显示状态。
+     *
+     * @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 - 可选的 AI 物体检测数据数组
+     * @param data.furnitures - 可选的家具数据数组
+     * @param runtime - 可选的运行时配置 (如是否显示机器人、充电桩等状态)
+     * @param options - 截图配置选项
+     * @param options.backgroundColor - 指定生成截图时的背景颜色。若不指定，将默认使用 `global.config.backgroundColor`。
+     * @returns Promise<string> Base64 格式的图片数据 (Data URL)
      */
-    snapshotByData({ map, path, roomProperties, customElements, forbiddenSweepZones, forbiddenMopZones, virtualWalls, detectedObjects, furnitures, }: {
+    snapshotByData(data: {
         map: string;
         path?: string;
         roomProperties?: RoomProperty[];
@@ -4005,40 +1385,24 @@ declare class MapApplication extends Application implements MapApi {
     }, runtime?: DeepPartialRuntimeConfig, options?: {
         backgroundColor?: ColorSource;
     }): 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;
-    /* Excluded from this release type: setupMapRotationListener */
-    /* Excluded from this release type: applyMapRotation */
-    private onVisibilityChange;
+}
+
+/**
+ * MapApplication 实例公开能力（供宿主应用与调试工具使用）
+ */
+export declare type MapApplicationInstance = {
+    canvas: HTMLCanvasElement
+    runtime: RuntimeConfig
+    events?: AppOptions['events']
+    initialize: (
+    options: Partial<ApplicationOptions> & AppOptions,
+    ) => Promise<void>
+    destroy: () => void
+    drawMap: (mapData: unknown) => Promise<void>
+    drawRasterMap: (mapData: unknown) => Promise<void>
+    drawPath: (pathData: unknown) => void
+    drawRoomProperty: (roomData: unknown[]) => Promise<void>
+    updateRuntime: (runtime: DeepPartialRuntimeConfig) => void
 }
 
 /**
@@ -4420,143 +1784,6 @@ export declare type MapDataSource = {
     version: string
 }
 
-declare class MapManager_2 {
-    private appService;
-    obstacle: Obstacle;
-    free: Free;
-    roomFill: RoomFill;
-    carpet: Carpet;
-    chargingStation: ChargingStation;
-    mapBounds: Bounds;
-    private lastMapId;
-    private lastOrigin;
-    private lastSize;
-    private lastStatus;
-    private roomGeometryMap;
-    private rasterRoomPixelsMap;
-    private fourColorCache;
-    private carpetData;
-    private unsubscribeFns;
-    constructor(appService: AppService);
-    /**
-     * 处理结构化地图数据（房间形状、障碍物等）
-     */
-    drawMap(mapData: StructuredMapDataSource): Promise<boolean>;
-    /**
-     * 处理栅格地图数据
-     * @param mapPointsStr 栅格数据字符串
-     * @param width 地图宽度
-     * @param height 地图高度
-     * @param charger 充电桩信息
-     */
-    drawRasterMap(rasterData: ParsedRasterMapData_2, mapState: MapState): Promise<boolean>;
-    /**
-     * 重置几何数据和边界
-     */
-    private resetGeometryData;
-    /**
-     * 判断是否需要触发fitMapToView
-     * @param currentMapId 当前地图ID
-     * @param currentStatus 当前地图状态
-     * @param currentOrigin 当前地图原点
-     * @returns 是否需要触发fitMapToView
-     */
-    private shouldFitMapToView;
-    /**
-     * 将栅格数据转换为结构化数据格式
-     * @param carpetPixels 地毯像素数据
-     * @param mapWidth 地图宽度
-     * @returns 结构化地毯数据数组
-     */
-    private convertRasterToStructuredData;
-    /**
-     * 更新地毯显示
-     * 类似于RoomFloorType的模式，根据当前状态决定是否重建地毯
-     */
-    private createCarpet;
-    /**
-     * 处理房间几何数据，计算所有需要的几何信息
-     * 返回所有房间的几何数据（包括正常房间和未知房间）
-     */
-    private processRoomsGeometry;
-    /**
-     * 合并所有图层的边界
-     */
-    private mergeLayerBounds;
-    /**
-     * 根据ID查找房间几何信息
-     */
-    getRoomById(id: number): Room | undefined;
-    /**
-     * 获取所有房间的几何信息
-     */
-    getAllRooms(): Room[];
-    /**
-     * 判断墙体（线段）是否与任意房间有交集
-     * @param points 墙体的两个端点坐标（机器坐标系）
-     * @returns 如果有交集返回 true，否则返回 false
-     */
-    isWallIntersectsAnyRoom(points: Point[]): boolean;
-    /**
-     * 判断区域（矩形）是否与任意房间有交集
-     * @param points 区域的四个顶点坐标（机器坐标系）
-     * @returns 如果有交集返回 true，否则返回 false
-     */
-    isZoneIntersectsAnyRoom(points: Point[]): boolean;
-    /**
-     * 判断指定的房间是否相邻（连通）
-     * @param roomIds 要检测的房间ID数组
-     * @returns 是否所有指定的房间都相邻（连通）
-     */
-    areRoomsAdjacent(roomIds: number[]): boolean;
-    /* Excluded from this release type: areStructuredRoomsAdjacentInternal */
-    /* Excluded from this release type: areRasterRoomsAdjacentInternal */
-    /**
-     * 判断一个点是否在任意房间内
-     * @param point 待检测的点坐标（机器坐标系）
-     * @returns 如果点在某个房间内，返回该房间的RoomData；否则返回null
-     */
-    isPointInAnyRoom(point: Point): RoomData | null;
-    /* Excluded from this release type: isPointInAnyRoomStructuredInternal */
-    /* Excluded from this release type: isPointInAnyRoomRasterInternal */
-    /**
-     * 清空地图组件
-     */
-    private clearComponents;
-    /**
-     * 处理栅格数据，统一处理排序和颜色分配
-     * @param rasterData 原始栅格数据
-     * @returns 处理后的栅格数据，包含排序和颜色信息
-     */
-    private processRasterData;
-    /**
-     * 为栅格地图生成房间几何信息供 RoomManager 使用
-     * @param rasterData 解析后的栅格数据
-     */
-    private generateRoomGeometryFromRaster;
-    /**
-     * 获取点阵房间的像素数据
-     * @param roomId 房间ID
-     * @returns 像素索引数组，如果不存在则返回 undefined
-     */
-    getRasterRoomPixels(roomId: number): Uint32Array | undefined;
-    /**
-     * 验证颜色配置
-     * @private
-     */
-    private validateColorConfig;
-    /**
-     * 使用四色算法分配房间颜色
-     * @param roomData 房间数据数组
-     * @param colorCount 可用颜色数量
-     * @param mapType 地图类型
-     * @returns 房间ID到颜色索引的映射
-     * @private
-     */
-    private assignColorsUsingFourColorAlgorithm;
-    destroy(): void;
-}
-
 /**
  * 地图状态对象
  *
@@ -4578,106 +1805,26 @@ export declare type MapState = {
     /** 充电桩坐标 */
     charger: Point
     /** 充电桩方向 */
-    chargerDirection: number
-    /**
-     * 地图协议版本号
-     */
-    version?: number
-    /**
-     * 地图类型
-     * - 'structured': 结构化地图（基于轮廓点）
-     * - 'raster': 点阵地图（基于像素）
-     */
-    mapType?: MapType
-}
-
-/**
- * 地图类型
- */
-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(appService: AppService, options: MoveControlButtonOptions);
-    /**
-     * 设置移动事件监听
-     */
-    private setupMoveEventListeners;
-    /**
-     * 清理移动事件监听
-     */
-    private cleanupMoveEventListeners;
-    /**
-     * 设置手势事件监听
-     */
-    protected setupEvents(): void;
-    /**
-     * 处理指针按下事件（开始移动）
-     */
-    private handlePointerDown;
-    /**
-     * 开始移动
-     */
-    private startMoving;
-    /**
-     * 处理移动过程中的指针移动
-     */
-    private handleMovePointerMove;
-    /**
-     * 处理移动结束
-     */
-    private handleMovePointerUp;
-    /**
-     * 处理移动取消（多点触控干扰）
-     */
-    private handleMoveCancel;
-    /**
-     * 获取是否正在移动
-     */
-    isCurrentlyMoving(): boolean;
-    /**
-     * 获取拖拽开始位置
-     */
-    getDragStartPosition(): Point | null;
+    chargerDirection: number
     /**
-     * 强制停止移动（用于清理）
+     * 地图协议版本号
      */
-    stopMoving(): void;
+    version?: number
     /**
-     * 销毁组件
+     * 地图类型
+     * - 'structured': 结构化地图（基于轮廓点）
+     * - 'raster': 点阵地图（基于像素）
      */
-    destroy(): void;
+    mapType?: MapType
 }
 
-declare type MoveControlButtonOptions = BaseControlButtonOptions & {
-    onMoveStart?: () => void;
-    onMoveMove?: (event: FederatedPointerEvent) => void;
-    onMoveEnd?: () => void;
-};
+/**
+ * 地图类型
+ */
+export declare type MapType = 'structured' | 'raster'
 
-declare class Obstacle extends Graphics {
-    private appService;
-    constructor(appService: AppService);
-    /**
-     * 绘制结构化障碍物数据
-     * @param obstacles 障碍物数据数组
-     */
-    draw(obstacles: {
-        coordinates: number[];
-    }[]): void;
-    /**
-     * 绘制栅格障碍物数据
-     * @param obstacleIndices 障碍物像素点索引数组
-     * @param width 地图宽度
-     */
-    drawRaster(obstacleIndices: Uint32Array, width: number): void;
-    destroy(options?: DestroyOptions | boolean): void;
-}
+/** 测量单位 */
+export declare type MeasurementUnit = 'meter' | 'feet' | 'centimeter'
 
 /**
  * 对点位进行偏移，避免与已存在的点位重叠
@@ -4688,14 +1835,6 @@ declare class Obstacle extends Graphics {
  */
 export declare const offsetPointsToAvoidOverlap: (points: Point[], existingPointsArray: Point[][], maxAttempts?: number) => Point[];
 
-declare type OperationState = {
-    isDragging: boolean;
-    isScaling: boolean;
-    isRotating: boolean;
-    isMoving: boolean;
-    hasAnyOperation: boolean;
-};
-
 /**
  * 解析后的点阵地图数据
  */
@@ -4714,135 +1853,6 @@ export declare type ParsedRasterMapData = {
     totalPixels: number
 }
 
-declare class Path extends Container {
-    private appService;
-    private commonPath;
-    private chargePath;
-    private transitionsPath;
-    private mopPath;
-    private mopPathTrack;
-    private mopPathTrackContainer;
-    private debugPoints;
-    private pathData;
-    private lastPointCount;
-    private lastDrawnPosition;
-    private isRealTimeDrawing;
-    private throttledUpdateLineWidth;
-    private throttledHandleRobotPosition;
-    private unsubscribeFns;
-    constructor(appService: AppService);
-    /**
-     * 注册事件监听
-     */
-    private registerEventListeners;
-    /**
-     * 处理机器人动画完成事件
-     */
-    private handleRobotAnimationComplete;
-    /**
-     * 实际处理机器人位置更新的方法
-     */
-    private handleRobotPositionUpdate;
-    /**
-     * 更新线宽以响应缩放变化
-     */
-    private updateLineWidth;
-    /**
-     * 重新绘制路径，应用适当的线宽
-     * @param pathData 路径数据
-     */
-    private redrawPaths;
-    /**
-     * 设置各类路径的样式
-     */
-    private setupPathStyles;
-    /**
-     * 绘制路径线段
-     * @param pathPoints 路径点数组
-     */
-    private drawPathSegments;
-    /**
-     * 调试模式下绘制路径点方块
-     * @param pathPoints 路径点数组
-     */
-    private drawDebugPoints;
-    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;
-    /**
-     * 清除所有路径数据
-     */
-    clear(): void;
-    destroy(options?: {
-        children?: boolean;
-        texture?: boolean;
-        baseTexture?: boolean;
-    }): void;
-}
-
-declare class PathManager_2 {
-    private appService;
-    path: Path;
-    robot: Robot;
-    private unsubscribeFns;
-    private lastDrawnPathData;
-    constructor(appService: AppService);
-    /**
-     * 绘制路径和机器人
-     */
-    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;
-    /**
-     * 清除路径和机器人数据
-     */
-    clear(): void;
-    destroy(): void;
-}
-
 /**
  * 路径状态对象
  * 描述机器人路径的状态信息
@@ -4890,55 +1900,6 @@ export declare type ProcessedRasterData = {
     totalPixels: number
 }
 
-declare class PulseCircle extends Graphics {
-    private appService;
-    private currentPosition;
-    private animationStartTime;
-    private isAnimating;
-    constructor(appService: AppService);
-    /**
-     * 设置反向缩放监听，保持描边宽度固定
-     */
-    private setupAntiScaleListener;
-    /**
-     * 反向缩放事件处理
-     */
-    private handleScaleChange;
-    /**
-     * 绘制脉冲圆圈
-     * @param position 圆圈中心位置
-     */
-    draw(position: Point): void;
-    /**
-     * 启动呼吸动画
-     */
-    private startAnimation;
-    /**
-     * 停止呼吸动画
-     */
-    private stopAnimation;
-    /**
-     * 动画更新函数
-     */
-    private updateAnimation;
-    /**
-     * 重新绘制（当配置变化或缩放变化时调用）
-     */
-    redraw(): void;
-    /**
-     * 清除脉冲圆圈
-     */
-    clearCircle(): void;
-    /**
-     * 完全停止并清除
-     */
-    remove(): void;
-    /**
-     * 销毁组件
-     */
-    destroy(): void;
-}
-
 /**
  * 点阵房间数据
  */
@@ -4955,38 +1916,6 @@ export declare type RasterRoomData = {
     colorIndex?: number
 }
 
-declare class Ring extends Graphics {
-    private appService;
-    private currentPosition;
-    private config;
-    constructor(appService: AppService, options: RingOptions);
-    /**
-     * 设置反向缩放监听，保持描边宽度固定
-     */
-    private setupAntiScaleListener;
-    /**
-     * 反向缩放事件处理
-     */
-    private handleScaleChange;
-    /**
-     * 绘制预警圈
-     * @param position 充电桩位置信息
-     */
-    draw(position: Point): void;
-    /**
-     * 绘制虚线圆形
-     */
-    private drawDashedCircle;
-    /**
-     * 重新绘制（当配置变化时调用）
-     */
-    redraw(): void;
-    /**
-     * 销毁组件
-     */
-    destroy(): void;
-}
-
 /** 预警圈配置 */
 export declare type RingConfig = {
     /** 大小(米) */
@@ -5003,103 +1932,6 @@ export declare type RingConfig = {
     strokeDashArray: [number, number]
 }
 
-declare type RingOptions = {
-    config: RingConfig;
-};
-
-declare class Robot extends Container {
-    private appService;
-    robot: RobotIcon;
-    ring: Ring;
-    pulseCircle: PulseCircle;
-    sleepAnimation: SleepAnimation | null;
-    private unsubscribeFns;
-    private clickHandler?;
-    private targetPosition;
-    private targetRotation;
-    private isMoving;
-    private pathQueue;
-    private lastPosition;
-    private currentPathType;
-    private lastUpdateTime;
-    private isCleared;
-    constructor(appService: AppService);
-    /**
-     * 异步初始化睡眠动画
-     */
-    private initializeSleepAnimation;
-    updatePositionByOrigin(x: number, y: number): void;
-    /**
-     * 立即绘制到指定位置（无动画）
-     */
-    draw({ x, y, rotation }: IconPoint): Promise<void>;
-    /**
-     * 初始化点击处理器状态
-     * 根据配置启用机器人点击交互
-     */
-    private initClickInteraction;
-    /**
-     * 获取机器人当前位置（相对坐标系）
-     * @returns 机器人当前位置，如果尚未绘制则返回 null
-     */
-    getCurrentPosition(): {
-        x: number;
-        y: number;
-    } | null;
-    /**
-     * 添加移动目标到队列（带动画）
-     */
-    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;
-    /**
-     * 清除机器人显示（隐藏所有子组件）
-     */
-    clear(): void;
-    destroy(options?: {
-        children?: boolean;
-        texture?: boolean;
-        baseTexture?: boolean;
-    }): void;
-}
-
-declare class RobotIcon extends EnhancedSprite {
-    protected appService: AppService;
-    constructor(appService: AppService);
-    initializeSprite(): Promise<void>;
-    draw({ x, y, rotation }: IconPoint): Promise<void>;
-}
-
 /** 机器人点 */
 export declare type RobotPoint = IconPoint & {
     /** 点类型 */
@@ -5142,196 +1974,6 @@ export declare type RoomData = RoomProperty & {
     colorIndex?: number
 }
 
-declare class RoomFill extends Container {
-    private appService;
-    private roomGraphicsMap;
-    private roomContextMap;
-    private roomClickHandlerMap;
-    private unsubscribeFns;
-    private mapWidth;
-    private rasterRoomDataMap;
-    private structuredRoomGeometry;
-    constructor(appService: AppService);
-    /**
-     * 绘制结构化协议地图房间
-     * @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;
-    /**
-     * 判断墙体（线段）是否与任意房间有交集
-     * @param points 墙体的两个端点坐标（机器坐标系）
-     * @returns 如果有交集返回 true，否则返回 false
-     */
-    isWallIntersectsAnyRoom(points: Point[]): boolean;
-    /**
-     * 判断区域（矩形）是否与任意房间有交集
-     * @param points 区域的四个顶点坐标（机器坐标系）
-     * @returns 如果有交集返回 true，否则返回 false
-     */
-    isZoneIntersectsAnyRoom(points: Point[]): boolean;
-    /**
-     * 栅格地图：判断线段是否与任意房间有交集
-     */
-    private isWallIntersectsAnyRoomRaster;
-    /**
-     * 结构化地图：判断线段是否与任意房间有交集
-     */
-    private isWallIntersectsAnyRoomStructured;
-    /**
-     * 栅格地图：判断矩形是否与任意房间有交集
-     * 优化方案：先检查4条边，如果都失败再检查包含关系
-     */
-    private isZoneIntersectsAnyRoomRaster;
-    /**
-     * 结构化地图：判断矩形是否与任意房间有交集
-     */
-    private isZoneIntersectsAnyRoomStructured;
-    /**
-     * 获取线段覆盖的像素点索引
-     */
-    private getLinePixels;
-    /**
-     * 获取矩形覆盖的像素点索引
-     */
-    private getZonePixels;
-    /**
-     * 刷新所有房间的颜色（不重新计算几何）
-     */
-    private refreshRoomColors;
-    /**
-     * 清除所有房间
-     */
-    clearRooms(): void;
-    /**
-     * 销毁时清理资源
-     */
-    destroy(): void;
-}
-
-declare class RoomManager_2 {
-    private appService;
-    private unsubscribeFns;
-    private roomInfoContainer;
-    private roomInfoMap;
-    private roomDisplayMap;
-    private roomFloorType;
-    constructor(appService: AppService);
-    /**
-     * 设置房间属性数据（房间名称、清洁模式等）
-     * 一次性获取并存储所有必要的显示数据
-     */
-    drawRoomProperty(properties: RoomProperty[]): Promise<boolean>;
-    /**
-     * 更新房间信息显示
-     * 直接使用已存储的完整显示数据
-     */
-    private updateRoomInfoDisplay;
-    /**
-     * 创建单个房间的信息组件
-     */
-    private createRoomInfo;
-    /**
-     * 更新特定房间的名称
-     */
-    updateRoomName(roomId: number, name: string): void;
-    /**
-     * 更新特定房间的类型
-     */
-    updateRoomType(roomId: number, type: number | null): Promise<void>;
-    /**
-     * 更新特定房间的位置
-     */
-    updateRoomPosition(roomId: number, centerPoint: Point): void;
-    /**
-     * 清除所有房间信息
-     */
-    private clearRoomInfos;
-    /**
-     * 根据ID查找房间显示数据
-     */
-    getRoomPropertyById(id: number): RoomData | undefined;
-    /**
-     * 当房间几何数据更新时，刷新房间信息显示
-     * 这个方法由 MapManager 在房间几何数据更新后调用
-     */
-    refresh(): Promise<void>;
-    /**
-     * 更新所有房间属性的可见性
-     */
-    private updateAllRoomPropertyVisibility;
-    /**
-     * 更新所有房间名称的可见性
-     */
-    private updateAllRoomNameVisibility;
-    /**
-     * 更新所有房间类型图标的可见性
-     */
-    private updateAllRoomTypeVisibility;
-    /**
-     * 更新所有房间选择指示器的可见性
-     */
-    private updateAllRoomSelectionIndicatorVisibility;
-    /**
-     * 刷新所有房间颜色
-     */
-    private refreshAllRoomColors;
-    /**
-     * 更新地板材质
-     * 在房间几何数据或属性数据更新后调用
-     */
-    private updateFloorTypes;
-    clear(): void;
-    destroy(): void;
-}
-
 /**
  * 房间属性信息
  */
@@ -5453,71 +2095,6 @@ export declare type RuntimeConfig = {
     selectedCarpetIds: string[]
 }
 
-/**
- * 机器人睡眠动画组件
- * TODO
- * 暂时不开放这个组件，得找到合适的动画
- * 基于 FixedSizeAnimatedSprite，显示机器人睡眠状态的动画效果
- */
-declare class SleepAnimation extends EnhancedAnimatedSprite {
-    protected appService: AppService;
-    private unsubscribeFns;
-    private throttledUpdateOffset;
-    private fixedOffsetX;
-    private fixedOffsetY;
-    constructor(appService: AppService, textures: Texture[]);
-    /**
-     * 静态创建方法
-     */
-    static create(appService: AppService): 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 = {
     /** 图标资源路径 */
@@ -5575,46 +2152,6 @@ export declare type SpotParam = {
     point: Point
 }
 
-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 = {
     /** 图标容器填充颜色 */