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

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"];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","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};

package/dist/index.d.ts

@@ -746,6 +746,7 @@ export declare type ControlRenderItem =
 | 'cleanZone'
 | 'virtualWall'
 | 'spot'
+| 'purifyPoint'
 | 'wayPoint'
 | 'divider'
 // Allow any string for custom zone types while keeping IDE autocomplete
@@ -800,6 +801,8 @@ export declare type ControlsConfig = {
     virtualWall: VirtualWallConfig
     /** 定点清扫配置 */
     spot: SpotConfig
+    /** 净化点配置 */
+    purifyPoint: PurifyPointConfig
     wayPoint: WayPointConfig
 }
 
@@ -1085,7 +1088,7 @@ export declare type LoggerPayload = {
 
 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_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"];
+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"];
 
 /**
  * 地图 API 接口定义
@@ -1761,6 +1764,24 @@ export declare interface MapCallbacks {
      * @param.en spot - Clicked spot clean data
      */
     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
+     */
+    onClickPurifyPoint?: (purifyPoint: PurifyPointParam) => void;
     /**
      * @description.zh 点击检测物体回调
      * @description.en Callback when clicking detected object
@@ -2096,6 +2117,39 @@ 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
+}
+
 /**
  * 点阵房间数据
  */
@@ -2266,6 +2320,8 @@ export declare type RuntimeConfig = {
     editingVirtualWallIds: string[]
     /** 正在编辑的定点清扫ID列表 */
     editingSpotIds: string[]
+    /** 正在编辑的净化点ID列表 */
+    editingPurifyPointIds?: string[]
     /** 正在编辑的途径点ID列表 */
     editingWayPointIds: string[]
     /** 正在编辑的地毯ID列表 */