@ray-js/robot-map-sdk 0.0.3-beta-19 → 0.0.3-beta-21

package/dist/index.d.ts

@@ -765,7 +765,8 @@ export declare type BaseCustomElementParam = {
     /** 是否可交互 */
     interactive?: boolean
     /** 自定义数据 */
-    customData?: Record<string, unknown>
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    customData?: Record<string, any>
     /** 尺寸是否固定 */
     sizeFixed?: boolean
 }
@@ -1197,6 +1198,9 @@ export declare type DetectedObjectParam = {
     height?: number
     /** 宽度 */
     width?: number
+    /** 自定义数据 */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    customData?: Record<string, any>
 }
 
 /** 方向 */
@@ -1739,7 +1743,7 @@ declare type Managers = {
     roomsManager: RoomManager;
 };
 
-export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "resetPanZoom", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "snapshot", "snapshotByData"];
+export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getSpots", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "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"];
 
@@ -1907,6 +1911,17 @@ export declare interface MapApi {
      * @returns 是否所有指定的房间都相邻（连通）
      */
     areRoomsAdjacent(roomIds: number[]): boolean;
+    /**
+     * 判断一个点是否在任意房间内
+     *
+     * 接受原点坐标系的点（相对于origin的坐标），遍历所有房间，
+     * 判断该点是否在某个房间内。支持结构化地图和点阵地图两种协议。
+     * 方法内部会自动将原点坐标系转换为地图坐标系进行检测。
+     *
+     * @param point - 待检测的点坐标（原点坐标系，与Zone、VirtualWall等使用相同的坐标系）
+     * @returns 如果点在某个房间内，返回该房间的RoomData；否则返回null
+     */
+    isPointInAnyRoom(point: Point): RoomData | null;
     /**
      * 地图截图
      *
@@ -2287,14 +2302,22 @@ export declare class MapApplication extends Application implements MapApi {
      * @param roomIds - 要检测的房间ID数组
      * @returns 是否所有指定的房间都相邻（连通）
      *
-     * @example
-     * ```typescript
-     * // 判断两个房间是否相邻
-     * const isAdjacent = mapApi.areRoomsAdjacent([1, 2])
-     *
-     * ```
      */
     areRoomsAdjacent(roomIds: number[]): boolean;
+    /**
+     * 判断一个点是否在任意房间内
+     *
+     * 接受原点坐标系的点（相对于origin的坐标），遍历所有房间，
+     * 判断该点是否在某个房间内。支持结构化地图和点阵地图两种协议。
+     * 方法内部会自动将原点坐标系转换为地图坐标系进行检测。
+     *
+     * @param point - 待检测的点坐标（原点坐标系，与Zone、VirtualWall等使用相同的坐标系）
+     * @returns 如果点在某个房间内，返回该房间的RoomData；否则返回null
+     *
+     */
+    isPointInAnyRoom(point: Point): RoomData | null;
+    /* Excluded from this release type: isPointInAnyRoomStructuredInternal */
+    /* Excluded from this release type: isPointInAnyRoomRasterInternal */
     /* Excluded from this release type: areStructuredRoomsAdjacentInternal */
     /* Excluded from this release type: areRasterRoomsAdjacentInternal */
     /**
@@ -2687,6 +2710,10 @@ declare class MapManager {
      * 根据ID查找房间几何信息
      */
     getRoomById(id: number): Room | undefined;
+    /**
+     * 获取所有房间的几何信息
+     */
+    getAllRooms(): Room[];
     /**
      * 清空地图组件
      */
@@ -2751,8 +2778,19 @@ export declare type MapState = {
      * 地图协议版本号
      */
     version?: number
+    /**
+     * 地图类型
+     * - 'structured': 结构化地图（基于轮廓点）
+     * - 'raster': 点阵地图（基于像素）
+     */
+    mapType: MapType
 }
 
+/**
+ * 地图类型
+ */
+export declare type MapType = 'structured' | 'raster'
+
 declare class Obstacle extends Graphics {
     constructor();
     /**
@@ -2771,6 +2809,15 @@ declare class Obstacle extends Graphics {
     destroy(options?: DestroyOptions | boolean): void;
 }
 
+/**
+ * 对点位进行偏移，避免与已存在的点位重叠
+ * 使用递增偏移策略，每次偏移5个单位，直到找到不重叠的位置
+ * @param points 需要偏移的点位数组
+ * @param existingPointsArray 已存在的点位数组
+ * @param maxAttempts 最大尝试次数，默认20次（最多偏移100个单位）
+ */
+export declare const offsetPointsToAvoidOverlap: (points: Point[], existingPointsArray: Point[][], maxAttempts?: number) => Point[];
+
 /**
  * 解析后的点阵地图数据
  */
@@ -3583,6 +3630,8 @@ export declare type ZoneConfig = {
     outlineDashed: boolean
     /** 轮廓虚线数组 */
     outlineDashArray: [number, number]
+    /** 是否显示旋转图标 */
+    showRotateButton: boolean
     /** 文本颜色 */
     textColor: ColorSource
     /** 文本位置 */

package/dist/index.js

@@ -1 +1 @@
-import{decodeRoomProperties as o}from"./utils/index.js";import{MapApplication as p}from"./application/MapApplication.js";import{AppContext as i,useAppService as t}from"./application/AppService.js";import{MAP_API_METHODS as r,MAP_CALLBACK_METHODS as m}from"./constant/methods.js";export{i as AppContext,r as MAP_API_METHODS,m as MAP_CALLBACK_METHODS,p as MapApplication,o as decodeRoomProperties,t as useAppService};
+import{decodeRoomProperties as o,offsetPointsToAvoidOverlap as p}from"./utils/index.js";import{MapApplication as i}from"./application/MapApplication.js";import{AppContext as t,useAppService as r}from"./application/AppService.js";import{MAP_API_METHODS as m,MAP_CALLBACK_METHODS as a}from"./constant/methods.js";export{t as AppContext,m as MAP_API_METHODS,a as MAP_CALLBACK_METHODS,i as MapApplication,o as decodeRoomProperties,p as offsetPointsToAvoidOverlap,r as useAppService};