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

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","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","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

@@ -41,6 +41,8 @@ export declare type AppConfig = {
         /** 渲染器偏好，默认 'webgpu' */
         rendererPreference: 'webgpu' | 'webgl'
     }
+    /** 日志配置 */
+    logger: LoggerConfig
     /** 地图基础配置 */
     map: {
         /** 自动填充垂直百分比 */
@@ -685,7 +687,15 @@ export declare type Bounds = {
 }
 
 /** 地毯配置 */
-export declare type CarpetConfig = Omit<BaseZoneConfig, 'strokeColor' | 'strokeWidth'>
+export declare type CarpetConfig = Omit<
+BaseZoneConfig,
+'strokeColor' | 'strokeWidth'
+> & {
+    /** 删除图标容器填充颜色，缺省时回退到 iconWrapperFillColor */
+    deleteIconWrapperFillColor?: ColorSource
+    rotateMode: 'step' | 'free'
+    scaleMode: 'free' | 'ratioLocked'
+}
 
 /** 组件属性类型 */
 export declare type ComponentPropsApp = {
@@ -1012,7 +1022,26 @@ export declare type ImageCustomElementParam = BaseCustomElementParam & {
     anchor?: Point
 }
 
-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", "getFurnitures", "drawCustomZones", "getCustomZones", "clearCustomZones", "setEditingCustomZones"];
+export declare type LoggerConfig = {
+    enabled: boolean
+    /** 是否启用 App 原生日志通道（ty.getLogManager），独立于 console 与 host 桥 */
+    appLogEnabled: boolean
+    /** 转发到 App 原生日志的级别 */
+    appLogLevels: LoggerLevel[]
+    tag: string
+}
+
+export declare type LoggerLevel = 'info' | 'warn' | 'error' | 'debug'
+
+export declare type LoggerPayload = {
+    level: LoggerLevel
+    message: string
+    data: unknown[]
+    tag: string
+    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_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"];
 
@@ -1288,6 +1317,47 @@ export declare interface MapApi {
         offsetX?: number;
         offsetY?: number;
     }): Point[];
+    /**
+     * 基于视口中心生成自定义地毯可用的四个顶点坐标
+     *
+     * 返回的点集既可用于 `shape: 'rectangle'`，也可用于
+     * `shape: 'round'`。默认宽高和尺寸约束来自
+     * `controls.carpet.minSize` / `controls.carpet.maxSize`。
+     *
+     * @param options - 配置选项
+     * @param options.width - 地毯宽度，单位米。未传且只传了 height 时跟随 height
+     * @param options.height - 地毯高度，单位米。未传且只传了 width 时跟随 width
+     * @param options.offsetX - X方向像素偏移，支持负数，默认为 0
+     * @param options.offsetY - Y方向像素偏移，支持负数，默认为 0
+     * @returns 四个顶点坐标，顺时针顺序：[左上, 右上, 右下, 左下]
+     */
+    getCustomCarpetPointsByViewportCenter(options?: {
+        width?: number;
+        height?: number;
+        offsetX?: number;
+        offsetY?: number;
+    }): Point[];
+    /**
+     * 基于任意中心点生成矩形的四个顶点坐标
+     *
+     * 与 *ByViewportCenter 家族的区别：调用方自己提供中心点，
+     * 而不是默认取视口中心。
+     *
+     * @param options - 配置选项
+     * @param options.center - 中心点，地图坐标系（与其他返回顶点的方法同一坐标系）
+     * @param options.width - 矩形宽度，单位米
+     * @param options.height - 矩形高度，单位米
+     * @param options.applyMapRotation - 是否按当前地图旋转做逆旋转补偿，
+     *   使矩形在屏幕上视觉正放。默认 true，与现有 *ByViewportCenter 家族行为一致。
+     *   传 false 表示在地图坐标系里生成纯轴对齐矩形，不读取地图旋转。
+     * @returns 四个顶点坐标，顺时针顺序：[左上, 右上, 右下, 左下]
+     */
+    getRectPointsByCenter(options: {
+        center: Point;
+        width: number;
+        height: number;
+        applyMapRotation?: boolean;
+    }): Point[];
     /**
      * 基于视口中心生成定点清扫的点坐标
      *
@@ -1389,6 +1459,7 @@ export declare interface MapApi {
      * @param data.virtualWalls - 可选的虚拟墙数组
      * @param data.detectedObjects - 可选的 AI 物体检测数据数组
      * @param data.furnitures - 可选的家具数据数组
+     * @param data.carpets - 可选的自定义地毯数组
      * @param runtime - 可选的运行时配置 (如是否显示机器人、充电桩等状态)
      * @param options - 截图配置选项
      * @param options.backgroundColor - 指定生成截图时的背景颜色。若不指定，将默认使用 `global.config.backgroundColor`。
@@ -1404,6 +1475,7 @@ export declare interface MapApi {
         virtualWalls?: VirtualWallParam[];
         detectedObjects?: DetectedObjectParam[];
         furnitures?: FurnitureParam[];
+        carpets?: CustomCarpetParam[];
     }, runtime?: DeepPartialRuntimeConfig, options?: {
         backgroundColor?: ColorSource;
     }): Promise<string>;
@@ -2192,6 +2264,31 @@ export declare type SpotConfig = {
     textPosition: 'top' | 'right' | 'bottom' | 'left'
     /** 文本偏移 */
     textOffset: number
+    /** 名称标签配置 */
+    nameLabel?: {
+        /** 字体大小 */
+        fontSize: number
+        /** 字体名称 */
+        fontFamily: string
+        /** 字体粗细 */
+        fontWeight: TextStyleFontWeight
+        /** 文本颜色 */
+        color: ColorSource
+        /** 文本位置 */
+        position: 'top' | 'right' | 'bottom' | 'left'
+        /** 文本偏移 */
+        offset: number
+        /** 编辑模式显示配置 */
+        editing: {
+            /** 是否显示 */
+            visible: boolean
+        }
+        /** 普通模式显示配置 */
+        normal: {
+            /** 是否显示 */
+            visible: boolean
+        }
+    }
 
     /** 编辑模式样式 */
     editing: {
@@ -2223,6 +2320,8 @@ export declare type SpotParam = {
     id: string
     /** 点坐标 */
     point: Point
+    /** 可选显示名称 */
+    name?: string
 }
 
 /** 虚拟墙配置 */