@ray-js/robot-map-sdk 0.0.15-beta.9 → 0.0.16-beta.1

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","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"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};

package/dist/index.d.ts

@@ -622,6 +622,23 @@ export declare type BaseCustomElementParam = {
     customData?: Record<string, any>
     /** 尺寸是否固定 */
     sizeFixed?: boolean
+    /**
+     * 屏幕像素偏移（仅 `sizeFixed: true` 生效）
+     *
+     * 在元素锚定到 (x, y) 之后，再按「屏幕像素」平移指定距离。该偏移不随地图
+     * 缩放或旋转变化，始终对应相同的屏幕位移——与房间属性气泡停留在房间名上方
+     * 的行为一致。适合把图标稳定贴在气泡旁边等固定相对位置。
+     *
+     * 坐标约定（与 PIXI 屏幕坐标及 `getWallPointsByViewportCenter` 等 offset API 一致）：
+     * - `x` 正值向右，负值向左
+     * - `y` 正值向下，负值向上
+     *
+     * 例：贴在房间属性气泡上方 → `pixelOffset: { x: 12, y: -10 }`。
+     *
+     * 注意：`sizeFixed` 为 `false` 或未设置时该字段被忽略（随缩放变化的尺寸与
+     * 固定像素偏移没有自洽语义）。
+     */
+    pixelOffset?: Point
 }
 
 /** 区域和地毯配置的基础类型 */
@@ -1024,8 +1041,6 @@ export declare type ImageCustomElementParam = BaseCustomElementParam & {
 
 export declare type LoggerConfig = {
     enabled: boolean
-    hostSinkEnabled: boolean
-    hostLevels: LoggerLevel[]
     /** 是否启用 App 原生日志通道（ty.getLogManager），独立于 console 与 host 桥 */
     appLogEnabled: boolean
     /** 转发到 App 原生日志的级别 */
@@ -1045,7 +1060,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", "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"];
 
 /**
  * 地图 API 接口定义
@@ -1544,6 +1559,21 @@ export declare interface MapCallbacks {
      * @param.en rooms - Array of room property information
      */
     onRoomPropertiesDrawed?: (rooms: RoomProperty[]) => void;
+    /**
+     * @description.zh 房间中心点绘制完成回调
+     * @description.en Callback when room center points are drawn
+     * @description.zh 由地图几何驱动，每次 drawMap / drawRasterMap 绘制完成后触发，
+     * 抛出当前所有房间的中心点（同时提供地图坐标系与机器坐标系两种表达）。
+     * 与属性驱动、仅在 drawRoomProperty 时触发的 onRoomPropertiesDrawed 不同；
+     * 地图被清空时以空数组触发。
+     * @description.en Triggered after every drawMap / drawRasterMap completes, driven by
+     * map geometry. Emits the center points of all current rooms (in both map and robot
+     * coordinate systems). Unlike onRoomPropertiesDrawed, which is property-driven and only
+     * fires on drawRoomProperty. Fires with an empty array when the map is cleared.
+     * @param.zh rooms - 房间中心点信息数组
+     * @param.en rooms - Array of room center point information
+     */
+    onRoomsDrawed?: (rooms: RoomCenterInfo[]) => void;
     /**
      * @description.zh 点击房间回调
      * @description.en Callback when clicking on a room
@@ -2102,13 +2132,36 @@ export declare type Room = {
     colorIndex?: number
 }
 
+/**
+ * 房间中心点信息
+ *
+ * 由地图几何驱动，随 onRoomsDrawed 回调抛出。同时提供两种坐标表达，
+ * 消费方按需取用，无需自行处理 origin 偏移。
+ */
+export declare type RoomCenterInfo = {
+    /** 房间ID */
+    id: number
+    /** 中心点（地图坐标系，绝对坐标） */
+    centerPoint: Point
+    /** 中心点（机器坐标系，相对于 origin，与 Zone / VirtualWall 一致） */
+    relativeCenterPoint: Point
+}
+
 /**
  * 房间显示数据
  * 扩展房间属性，包含显示相关的信息
  */
 export declare type RoomData = RoomProperty & {
-    /** 可选的中心点，用于显示房间名称 */
+    /** 可选的中心点（地图坐标系，绝对坐标），用于显示房间名称 */
     centerPoint: Point | null
+    /**
+     * 房间中心点（机器坐标系，相对于 origin）
+     *
+     * 与 Zone / VirtualWall / isPointInAnyRoom / getMapCenterPoint 使用同一坐标系，
+     * 可直接用于下发指令或 drawCustomElements 等以机器坐标系为入参的 API。
+     * 当房间属性匹配不到几何数据时为 null。
+     */
+    relativeCenterPoint: Point | null
     /** 索引 */
     index: number
     /** 颜色索引（用于四色算法） */