@ray-js/robot-map-sdk 0.0.16-beta.6 → 0.0.16-beta.8

package/dist/constant/methods.js

@@ -1 +1 @@
-const e=["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","getCustomCarpetPointsByViewportCenter","getRectPointsByCenter","getFurnitures","drawCustomZones","getCustomZones","clearCustomZones","setEditingCustomZones"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onRoomsDrawed","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","onRemoveCustomZone","onUpdateCustomZone","onClickCustomZone","onUpdatePurifyPoint","onClickPurifyPoint"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};
+const e=["areRoomsAdjacent","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getSpots","getRoomAnchors","getWayPoints","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","isWallIntersectsAnyRoom","isZoneIntersectsAnyRoom","resetPanZoom","snapshot","snapshotByData","getCustomCarpets","forceEndGesture","getFurniturePointsByViewportCenter","getCustomCarpetPointsByViewportCenter","getRectPointsByCenter","getFurnitures","drawCustomZones","getCustomZones","clearCustomZones","setEditingCustomZones"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onRoomsDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateSpot","onUpdateRoomAnchor","onUpdateWayPoint","onUpdateDivider","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickSpot","onClickRoomAnchor","onClickWayPoint","onClickDetectedObject","onClickCustomElement","onClickMap","onClickCarpet","onDeleteCarpet","onUpdateCustomCarpet","onDeleteCustomCarpet","onGestureStart","onGestureEnd","onClickRobot","onClickChargingStation","onRemoveFurniture","onUpdateFurniture","onClickFurniture","onRemoveCustomZone","onUpdateCustomZone","onClickCustomZone"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};

package/dist/index.d.ts

@@ -746,7 +746,7 @@ export declare type ControlRenderItem =
 | 'cleanZone'
 | 'virtualWall'
 | 'spot'
-| 'purifyPoint'
+| 'roomAnchor'
 | 'wayPoint'
 | 'divider'
 // Allow any string for custom zone types while keeping IDE autocomplete
@@ -801,8 +801,12 @@ export declare type ControlsConfig = {
     virtualWall: VirtualWallConfig
     /** 定点清扫配置 */
     spot: SpotConfig
-    /** 净化点配置 */
-    purifyPoint: PurifyPointConfig
+    /**
+     * 房间锚点配置。房间锚点是一路由外侧主动上报的独立数据源（类似禁区/划框），
+     * 复用定点（Spot）渲染，但拥有独立配置：默认尖端对齐坐标、默认不展示，
+     * 需 `show` 为 true 才渲染。不影响普通定点（controls.spot）的行为。
+     */
+    roomAnchor: RoomAnchorConfig
     wayPoint: WayPointConfig
 }
 
@@ -1086,9 +1090,9 @@ export declare type LoggerPayload = {
     ts: number
 }
 
-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", "getCustomCarpetPointsByViewportCenter", "getRectPointsByCenter", "getFurnitures", "drawCustomZones", "getCustomZones", "clearCustomZones", "setEditingCustomZones"];
+export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getRoomAnchors", "getWayPoints", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "isWallIntersectsAnyRoom", "isZoneIntersectsAnyRoom", "resetPanZoom", "snapshot", "snapshotByData", "getCustomCarpets", "forceEndGesture", "getFurniturePointsByViewportCenter", "getCustomCarpetPointsByViewportCenter", "getRectPointsByCenter", "getFurnitures", "drawCustomZones", "getCustomZones", "clearCustomZones", "setEditingCustomZones"];
 
-export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onRoomsDrawed", "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", "onRemoveCustomZone", "onUpdateCustomZone", "onClickCustomZone", "onUpdatePurifyPoint", "onClickPurifyPoint"];
+export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onRoomsDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateSpot", "onUpdateRoomAnchor", "onUpdateWayPoint", "onUpdateDivider", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickSpot", "onClickRoomAnchor", "onClickWayPoint", "onClickDetectedObject", "onClickCustomElement", "onClickMap", "onClickCarpet", "onDeleteCarpet", "onUpdateCustomCarpet", "onDeleteCustomCarpet", "onGestureStart", "onGestureEnd", "onClickRobot", "onClickChargingStation", "onRemoveFurniture", "onUpdateFurniture", "onClickFurniture", "onRemoveCustomZone", "onUpdateCustomZone", "onClickCustomZone"];
 
 /**
  * 地图 API 接口定义
@@ -1233,6 +1237,15 @@ export declare interface MapApi {
      * @returns 定点清扫数据数组
      */
     getSpots(): SpotParam[];
+    /**
+     * 获取当前地图上所有房间锚点数据
+     *
+     * 房间锚点是由外侧主动上报的独立数据源，与定点相互独立。返回值以数据缓存为准，
+     * 不受 `controls.roomAnchor.show` 当前显隐状态影响。
+     *
+     * @returns 房间锚点数据数组
+     */
+    getRoomAnchors(): RoomAnchorParam[];
     /**
      * 获取当前地图上所有家具数据
      *
@@ -1701,6 +1714,15 @@ export declare interface MapCallbacks {
      * @param.en spot - Updated spot clean data
      */
     onUpdateSpot?: (spot: SpotParam) => void;
+    /**
+     * @description.zh 更新房间锚点的回调
+     * @description.en Callback when updating room anchor
+     * @description.zh 当用户操作房间锚点位置后触发（房间锚点复用定点渲染，可编辑时生效）。
+     * @description.en Triggered when user operates room anchor position (room anchors reuse spot rendering; effective when editable).
+     * @param.zh point - 更新后的房间锚点数据
+     * @param.en point - Updated room anchor data
+     */
+    onUpdateRoomAnchor?: (point: RoomAnchorParam) => void;
     /**
      * @description.zh 更新途经点的回调
      * @description.en Callback when updating way point
@@ -1765,23 +1787,14 @@ export declare interface MapCallbacks {
      */
     onClickSpot?: (spot: SpotParam) => void;
     /**
-     * @description.zh 更新净化点的回调
-     * @description.en Callback when updating purify point
-     * @description.zh 当用户拖动净化点位置后触发。
-     * @description.en Triggered when user drags the purify point position.
-     * @param.zh purifyPoint - 更新后的净化点数据
-     * @param.en purifyPoint - Updated purify point data
-     */
-    onUpdatePurifyPoint?: (purifyPoint: PurifyPointParam) => void;
-    /**
-     * @description.zh 点击净化点回调
-     * @description.en Callback when clicking purify point
-     * @description.zh 当用户点击净化点时触发。
-     * @description.en Triggered when user clicks the purify point.
-     * @param.zh purifyPoint - 被点击的净化点数据
-     * @param.en purifyPoint - Clicked purify point data
+     * @description.zh 点击房间锚点回调
+     * @description.en Callback when clicking room anchor
+     * @description.zh 当用户点击房间锚点时触发。
+     * @description.en Triggered when user clicks room anchor.
+     * @param.zh point - 被点击的房间锚点数据
+     * @param.en point - Clicked room anchor data
      */
-    onClickPurifyPoint?: (purifyPoint: PurifyPointParam) => void;
+    onClickRoomAnchor?: (point: RoomAnchorParam) => void;
     /**
      * @description.zh 点击检测物体回调
      * @description.en Callback when clicking detected object
@@ -2117,39 +2130,6 @@ export declare type ProcessedRasterData = {
     totalPixels: number
 }
 
-/**
- * 净化点配置
- *
- * 净化点是一种独立的控制元素：只渲染一个与定点清扫（Spot）同款的中心图标，
- * 没有外框、填充区域，也没有名称文案。
- */
-export declare type PurifyPointConfig = {
-    /** 中心图标资源地址（默认与定点同款） */
-    iconSrc: string
-    /** 图标尺寸（像素） */
-    iconSize: number
-    /** 图标尺寸是否固定（不跟随地图缩放） */
-    iconSizeFixed: boolean
-    /** 拖出所属房间时的图标着色（出界飘红提示，缺省时不着色） */
-    outOfBoundsTint?: ColorSource
-}
-
-/** 净化点参数 */
-export declare type PurifyPointParam = {
-    /** 净化点ID */
-    id: string
-    /** 点坐标 */
-    point: Point
-    /** 可选显示名称 */
-    name?: string
-    /**
-     * 可选所属房间 ID。设置后，编辑态拖拽会被约束在该房间内：
-     * 拖出房间时圆点飘红提示，松手时回弹到房间内最后一个合法位置。
-     * 不设置则不做房间约束（自由拖拽）。
-     */
-    roomId?: number
-}
-
 /**
  * 点阵房间数据
  */
@@ -2211,6 +2191,43 @@ export declare type Room = {
     colorIndex?: number
 }
 
+/**
+ * 房间锚点配置。
+ *
+ * 房间锚点复用定点（Spot）的全部渲染能力，因此其配置就是一份 {@link SpotConfig}，
+ * 额外增加一个 `show` 开关：
+ * - `show` 默认 `false`，房间锚点默认不展示；置为 `true` 后才渲染（类似 showName 的显隐能力）。
+ *
+ * 房间锚点数据由外侧主动上报（见 `drawRoomAnchors`），与普通定点相互独立，
+ * 互不影响。默认 `iconAnchor` 为 `{ x: 0.5, y: 1 }`（尖端对齐坐标），
+ * 而普通定点默认居中，因此两者可拥有不同视觉表现。
+ */
+export declare type RoomAnchorConfig = SpotConfig & {
+    /** 是否展示房间锚点，默认 false；关闭时不渲染任何房间锚点 */
+    show: boolean
+}
+
+/**
+ * 房间锚点参数。
+ *
+ * 房间锚点是与定点（{@link SpotParam}）完全独立的一类元素，拥有自己的数据类型，
+ * 二者互不耦合、互不影响。字段结构目前与定点相近，但可各自独立演进。
+ */
+export declare type RoomAnchorParam = {
+    /** 房间锚点ID */
+    id: string
+    /** 点坐标 */
+    point: Point
+    /** 可选显示名称 */
+    name?: string
+    /**
+     * 可选所属房间 ID。设置后该房间锚点即与房间关联：编辑态拖拽被硬约束在该房间内，
+     * 无法拖出房间边界（拖到房间外的位置会被拒绝，停留在最后一个合法位置）。
+     * 不设置则为普通房间锚点，可自由拖拽。
+     */
+    roomId?: number
+}
+
 /**
  * 房间中心点信息
  *
@@ -2320,8 +2337,8 @@ export declare type RuntimeConfig = {
     editingVirtualWallIds: string[]
     /** 正在编辑的定点清扫ID列表 */
     editingSpotIds: string[]
-    /** 正在编辑的净化点ID列表 */
-    editingPurifyPointIds?: string[]
+    /** 正在编辑的房间锚点ID列表（独立于 editingSpotIds，互不影响） */
+    editingRoomAnchorIds: string[]
     /** 正在编辑的途径点ID列表 */
     editingWayPointIds: string[]
     /** 正在编辑的地毯ID列表 */
@@ -2384,6 +2401,16 @@ export declare type SpotConfig = {
     iconSize: number
     /** 图标尺寸是否固定（不跟随地图缩放） */
     iconSizeFixed: boolean
+    /**
+     * 图标锚点位置
+     *
+     * 定义中心图标相对于坐标点的对齐方式
+     * - {x: 0, y: 0} 表示左上角
+     * - {x: 0.5, y: 0.5} 表示中心（默认）
+     * - {x: 0.5, y: 1} 表示底部中心（适用于气泡/水滴形状的图标）
+     * - {x: 1, y: 1} 表示右下角
+     */
+    iconAnchor: Point
     /** 尺寸 (米) */
     size: number
     /** 描边颜色 */
@@ -2434,8 +2461,10 @@ export declare type SpotConfig = {
         dashArray: [number, number]
         /** 是否显示图标 */
         showIcon: boolean
-        /** 是否显示框体（填充和边框） */
+        /** 是否显示框体（边框；同时作为填充的默认开关） */
         showFrame: boolean
+        /** 是否显示填充面积（缺省时回退到 showFrame） */
+        showFill?: boolean
     }
     /** 普通模式样式 */
     normal: {
@@ -2445,8 +2474,10 @@ export declare type SpotConfig = {
         dashArray: [number, number]
         /** 是否显示图标 */
         showIcon: boolean
-        /** 是否显示框体（填充和边框） */
+        /** 是否显示框体（边框；同时作为填充的默认开关） */
         showFrame: boolean
+        /** 是否显示填充面积（缺省时回退到 showFrame） */
+        showFill?: boolean
     }
 }
 
@@ -2458,6 +2489,12 @@ export declare type SpotParam = {
     point: Point
     /** 可选显示名称 */
     name?: string
+    /**
+     * 可选所属房间 ID。设置后该定点即与房间关联：编辑态拖拽被硬约束在该房间内，
+     * 无法拖出房间边界（拖到房间外的位置会被拒绝，停留在最后一个合法位置）。
+     * 不设置则为普通定点，可自由拖拽。
+     */
+    roomId?: number
 }
 
 /** 虚拟墙配置 */