@ray-js/robot-map-sdk 0.0.6-beta.4 → 0.0.6-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"],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"];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"],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"];export{e as MAP_API_METHODS,o as MAP_CALLBACK_METHODS};

package/dist/index.d.ts

@@ -81,6 +81,8 @@ export declare type AppConfig = {
         obstacleColor: ColorSource
         /** 自由区域颜色 */
         freeColor: ColorSource
+        /** 地图自适应时的偏移量（像素) */
+        autoFitOffset?: { x: number; y: number }
     }
 
     /** 热力图配置 */
@@ -465,6 +467,10 @@ export declare type AppConfig = {
         enable: boolean
         /** 是否启用双击缩放功能 */
         enableDoubleTapZoom: boolean
+        /** 是否启用机器人点击功能 */
+        enableRobotClick?: boolean
+        /** 是否启用充电桩点击功能 */
+        enableChargingStationClick?: boolean
     }
 
     /** 控制元素配置 */
@@ -639,6 +645,10 @@ declare class AppService {
         sizeChangeAutoFitThreshold: number;
         obstacleColor: ColorSource;
         freeColor: ColorSource;
+        autoFitOffset?: {
+            x: number;
+            y: number;
+        };
     };
     get roomConfig(): {
         colors: {
@@ -812,6 +822,8 @@ declare class AppService {
         fitMaxScale: number;
         enable: boolean;
         enableDoubleTapZoom: boolean;
+        enableRobotClick?: boolean;
+        enableChargingStationClick?: boolean;
     };
     get controlsConfig(): ControlsConfig_2;
     get dividerConfig(): DividerConfig_2;
@@ -876,6 +888,12 @@ declare class AppService {
      * @returns 是否启用交互
      */
     isInteractionEnabled(): boolean;
+    /**
+     * 修复浮点数精度误差
+     * @param value 数字、点或点数组
+     * @param precision 保留小数位数，默认 2
+     */
+    fixPrecision<T>(value: T, precision?: number): T;
     get events(): MapCallbacks_2 | undefined;
     get baseScale(): number;
     get currentScale(): number;
@@ -1105,8 +1123,14 @@ declare class ChargingStation extends Container {
     chargingStation: ChargingStationIcon;
     ring: Ring;
     private unsubscribeFns;
+    private clickHandler?;
     constructor(appService: AppService);
     draw({ x, y, rotation }: IconPoint): Promise<void>;
+    /**
+     * 初始化点击处理器状态
+     * 根据静态配置启用充电桩点击交互
+     */
+    private initClickInteraction;
     destroy(): void;
 }
 
@@ -1985,8 +2009,10 @@ declare class EditControlLayer extends Container {
     private calculateVerticalScaleButtonRotation;
     /**
      * 更新点集（公共方法）
+     * @param points 点集
+     * @param updateText 是否更新文本
      */
-    updatePoints(points: Point[]): void;
+    updatePoints(points: Point[], updateText?: boolean): void;
     /**
      * 更新轮廓边框
      */
@@ -1997,8 +2023,9 @@ declare class EditControlLayer extends Container {
     updateMoveLine(): void;
     /**
      * 更新尺寸文本
+     * @param updateText 是否更新文本内容
      */
-    updateSizeText(): void;
+    updateSizeText(updateText?: boolean): void;
     /**
      * 更新尺寸文本位置
      */
@@ -2784,7 +2811,7 @@ declare type Managers = {
 
 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"];
 
-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"];
+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"];
 
 /**
  * 地图 API 接口定义
@@ -3862,6 +3889,18 @@ export declare interface MapCallbacks {
      * 当用户结束手势交互时触发。
      */
     onGestureEnd?: () => void;
+    /**
+     * 点击机器人回调
+     *
+     * @param point - 机器人当前位置和朝向
+     */
+    onClickRobot?: (point: IconPoint) => void;
+    /**
+     * 点击充电桩回调
+     *
+     * @param point - 充电桩当前位置和朝向
+     */
+    onClickChargingStation?: (point: IconPoint) => void;
 }
 
 /**
@@ -4508,6 +4547,7 @@ declare class Robot extends Container {
     pulseCircle: PulseCircle;
     sleepAnimation: SleepAnimation | null;
     private unsubscribeFns;
+    private clickHandler?;
     private targetPosition;
     private targetRotation;
     private isMoving;
@@ -4526,6 +4566,11 @@ declare class Robot extends Container {
      * 立即绘制到指定位置（无动画）
      */
     draw({ x, y, rotation }: IconPoint): Promise<void>;
+    /**
+     * 初始化点击处理器状态
+     * 根据配置启用机器人点击交互
+     */
+    private initClickInteraction;
     /**
      * 获取机器人当前位置（相对坐标系）
      * @returns 机器人当前位置，如果尚未绘制则返回 null
@@ -4987,6 +5032,8 @@ export declare type SpotConfig = {
     iconSrc: string
     /** 图标大小 */
     iconSize: number
+    /** 图标尺寸是否固定（不跟随地图缩放） */
+    iconSizeFixed: boolean
     /** 尺寸 (米) */
     size: number
     /** 描边颜色 */
@@ -5012,6 +5059,8 @@ export declare type SpotConfig = {
         dashArray: [number, number]
         /** 是否显示图标 */
         showIcon: boolean
+        /** 是否显示框体（填充和边框） */
+        showFrame: boolean
     }
     /** 普通模式样式 */
     normal: {
@@ -5021,6 +5070,8 @@ export declare type SpotConfig = {
         dashArray: [number, number]
         /** 是否显示图标 */
         showIcon: boolean
+        /** 是否显示框体（填充和边框） */
+        showFrame: boolean
     }
 }