@ray-js/robot-map-sdk 0.0.3-beta-46 → 0.0.3-beta-48

package/dist/constant/methods.js

@@ -1 +1 @@
-const e=["areRoomsAdjacent","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getSpots","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","resetPanZoom","snapshot","snapshotByData"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateSpot","onUpdateDivider","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickSpot","onClickDetectedObject","onClickCustomElement"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};
+const e=["areRoomsAdjacent","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getSpots","getWayPoints","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","resetPanZoom","snapshot","snapshotByData"],o=["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"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};

package/dist/index.d.ts

@@ -202,8 +202,14 @@ export declare type AppConfig = {
             containerHeight: number
             /** 描边宽度 */
             strokeWidth: number
-            /** 描边颜色 */
-            strokeColor: ColorSource
+            /**
+             * 描边颜色
+             *
+             * 支持以下值：
+             * - 颜色值（ColorSource）：固定颜色，如 '#ffffff'
+             * - 'auto'：自动跟随 selectionIndicatorBackground 的颜色
+             */
+            strokeColor: ColorSource | 'auto'
             /** 边框圆角 */
             borderRadius: number
             /** X轴偏移 */
@@ -643,6 +649,8 @@ export declare type ControlsConfig = {
     textFontFamily: string
     /** 文本字体粗细 */
     textFontWeight: TextStyleFontWeight
+    /** 单位 */
+    unit: MeasurementUnit
     /** 单位标签 */
     unitLabel: string
     /** 禁扫区域配置 */
@@ -655,6 +663,7 @@ export declare type ControlsConfig = {
     virtualWall: VirtualWallConfig
     /** 定点清扫配置 */
     spot: SpotConfig
+    wayPoint: WayPointConfig
 }
 
 declare class ControlsManager {
@@ -663,6 +672,7 @@ declare class ControlsManager {
     private cleanZoneMap;
     private virtualWallMap;
     private spotMap;
+    private wayPointMap;
     private divider;
     private unsubscribeFns;
     constructor();
@@ -798,6 +808,43 @@ declare class ControlsManager {
      * 比较两个定点清扫数据是否相等
      */
     private isSpotDataEqual;
+    /**
+     * 绘制途径点
+     * @param wayPoints 途径点数组
+     */
+    drawWayPoints(wayPoints: WayPointParam[]): void;
+    /**
+     * 清除所有途径点
+     */
+    clearAllWayPoints(): void;
+    /**
+     * 获取所有途径点数据
+     */
+    getWayPoints(): WayPointParam[];
+    /**
+     * 添加新途径点到 LAYER_CONTROLS
+     */
+    private addNewWayPoint;
+    /**
+     * 移除途径点
+     */
+    private removeWayPoint;
+    /**
+     * 获取途径点数据
+     */
+    private getWayPointsData;
+    /**
+     * 清除所有途径点
+     */
+    private clearAllWayPointsInternal;
+    /**
+     * 更新途径点编辑状态
+     */
+    private updateWayPointsEditState;
+    /**
+     * 比较两个途径点数据是否相等
+     */
+    private isWayPointDataEqual;
     /**
      * 处理分割房间ID变化
      */
@@ -1416,6 +1463,11 @@ declare class Interaction extends Container {
     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;
@@ -1423,6 +1475,7 @@ declare class Interaction extends Container {
     private viewportBounds;
     private boundResetAnimation;
     private debouncedStopWheelRender;
+    private debouncedLogWheelScale;
     private interactionState;
     private throttledAntiScale;
     constructor();
@@ -1463,6 +1516,10 @@ declare class Interaction extends Container {
      * 销毁时清理事件监听
      */
     destroy(): void;
+    /**
+     * 处理抑制地图点击事件
+     */
+    private handleSuppressMapClick;
     /**
      * 处理手势劫持
      */
@@ -1485,6 +1542,7 @@ declare class Interaction extends Container {
     private onPointerDown;
     private onPointerUp;
     private detectDoubleTap;
+    private detectMapClick;
     private handleDoubleTap;
     private onPointerMove;
     private applyPan;
@@ -1507,9 +1565,9 @@ declare type Managers = {
     roomsManager: RoomManager;
 };
 
-export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "resetPanZoom", "snapshot", "snapshotByData"];
+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", "resetPanZoom", "snapshot", "snapshotByData"];
 
-export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickDetectedObject", "onClickCustomElement"];
+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"];
 
 /**
  * 地图 API 接口定义
@@ -1856,6 +1914,11 @@ declare class MapApplication extends Application implements MapApi {
      * @param spots - 定点清扫参数数组
      */
     drawSpots(spots: SpotParam[]): void;
+    /**
+     * 绘制途径点
+     * @param wayPoints - 途径点参数数组
+     */
+    drawWayPoints(wayPoints: WayPointParam[]): void;
     /**
      * 绘制检测到的物体
      * @param objects - 检测物体参数数组
@@ -1896,6 +1959,12 @@ declare class MapApplication extends Application implements MapApi {
      * @returns 定点清扫数据数组
      */
     getSpots(): SpotParam[];
+    /**
+     * 获取当前地图上所有途径点数据
+     *
+     * @returns 途径点数据数组
+     */
+    getWayPoints(): WayPointParam[];
     /**
      * 获取分割线有效端点
      * @returns 分割线有效端点
@@ -2335,6 +2404,24 @@ export declare interface MapCallbacks {
      *
      */
     onUpdateSpot?: (spot: SpotParam) => void;
+    /**
+     * 更新途径点的回调
+     *
+     * 当用户操作途径点位置后触发。
+     *
+     * @param wayPoint - 更新后的途径点数据
+     *
+     */
+    onUpdateWayPoint?: (wayPoint: WayPointParam) => void;
+    /**
+     * 点击途径点的回调
+     *
+     * 当用户点击途径点时触发。
+     *
+     * @param wayPoint - 被点击的途径点数据
+     *
+     */
+    onClickWayPoint?: (wayPoint: WayPointParam) => void;
     /**
      * 点击禁扫区域回调
      *
@@ -2407,6 +2494,16 @@ export declare interface MapCallbacks {
      *
      */
     onUpdateDivider?: (divider: Point[]) => void;
+    /**
+     * 地图点击回调
+     *
+     * 当启用地图点击捕获（enableMapClickCapture）后，用户点击地图时触发。
+     * 返回点击位置的地图坐标（基于原点坐标系）。
+     *
+     * @param point - 点击位置的地图坐标
+     *
+     */
+    onClickMap?: (point: Point) => void;
 }
 
 /**
@@ -2602,6 +2699,9 @@ export declare type MapState = {
  */
 export declare type MapType = 'structured' | 'raster'
 
+/** 测量单位 */
+export declare type MeasurementUnit = 'meter' | 'feet' | 'centimeter'
+
 declare class Obstacle extends Graphics {
     constructor();
     /**
@@ -3259,6 +3359,10 @@ export declare type RuntimeConfig = {
     editingVirtualWallIds: string[]
     /** 正在编辑的定点清扫ID列表 */
     editingSpotIds: string[]
+    /** 正在编辑的途径点ID列表 */
+    editingWayPointIds: string[]
+    /** 启用地图点击坐标捕获 */
+    enableMapClickCapture: boolean
     /** 地图旋转角度（度） */
     mapRotation: number
     /** 房间属性折叠的房间ID列表 */
@@ -3369,6 +3473,8 @@ export declare type SpotConfig = {
     strokeWidth: number
     /** 填充颜色 */
     fillColor: ColorSource
+    /** 是否显示文本 */
+    showText: boolean
     /** 文本颜色 */
     textColor: ColorSource
     /** 文本位置 */
@@ -3382,6 +3488,8 @@ export declare type SpotConfig = {
         isDashed: boolean
         /** 虚线数组 */
         dashArray: [number, number]
+        /** 是否显示图标 */
+        showIcon: boolean
     }
     /** 普通模式样式 */
     normal: {
@@ -3389,6 +3497,8 @@ export declare type SpotConfig = {
         isDashed: boolean
         /** 虚线数组 */
         dashArray: [number, number]
+        /** 是否显示图标 */
+        showIcon: boolean
     }
 }
 
@@ -3493,6 +3603,78 @@ export declare type VirtualWallParam = {
     points: Point[]
 }
 
+/** 途径点配置 */
+export declare type WayPointConfig = {
+    /** 是否显示序号 */
+    showOrder: boolean
+    /** 编辑模式样式 */
+    editing: {
+        /** 图标资源路径 */
+        iconSrc: string
+        /** 图标大小 */
+        iconSize: number
+        /** 序号文本样式 */
+        orderText: {
+            /** 字体大小 */
+            fontSize: number
+            /** 字体名称 */
+            fontFamily: string
+            /** 字体粗细 */
+            fontWeight: TextStyleFontWeight
+            /** 字体颜色 */
+            color: ColorSource
+        }
+        /** 序号容器样式 */
+        orderContainer: {
+            /** 容器大小（圆形直径） */
+            size: number
+            /** 背景颜色 */
+            backgroundColor: ColorSource
+            /** 垂直偏移量 */
+            offsetY: number
+            /** 水平偏移量 */
+            offsetX: number
+        }
+    }
+    /** 普通模式样式 */
+    normal: {
+        /** 图标资源路径 */
+        iconSrc: string
+        /** 图标大小 */
+        iconSize: number
+        /** 序号文本样式 */
+        orderText: {
+            /** 字体大小 */
+            fontSize: number
+            /** 字体名称 */
+            fontFamily: string
+            /** 字体粗细 */
+            fontWeight: TextStyleFontWeight
+            /** 字体颜色 */
+            color: ColorSource
+        }
+        /** 序号容器样式 */
+        orderContainer: {
+            /** 容器大小（圆形直径） */
+            size: number
+            /** 背景颜色 */
+            backgroundColor: ColorSource
+            /** 垂直偏移量 */
+            offsetY: number
+            /** 水平偏移量 */
+            offsetX: number
+        }
+    }
+}
+
+/** 途径点参数 */
+export declare type WayPointParam = {
+    /** 途径点ID */
+    id: string
+    /** 点坐标 */
+    point: Point
+}
+
 /** 区域配置 */
 export declare type ZoneConfig = {
     /** 最小尺寸 (米) */