@ray-js/robot-map 0.0.2-beta-3

package/README.md

@@ -0,0 +1,21 @@
+English | [简体中文](./README-zh_CN.md)
+
+# @ray-js/robot-map
+
+[![latest](https://img.shields.io/npm/v/@ray-js/robot-map/latest.svg)](https://www.npmjs.com/package/@ray-js/robot-map) [![download](https://img.shields.io/npm/dt/@ray-js/robot-map.svg)](https://www.npmjs.com/package/@ray-js/robot-map)
+
+> Robot map component
+
+## Installation
+
+```sh
+$ yarn add @ray-js/robot-map
+// or
+$ npm install @ray-js/robot-map
+```
+
+## Document
+
+```sh
+$ npx serve node_modules/@ray-js/robot-map-sdk/dist-docs
+```

package/lib/RobotMap.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { AppOptions } from '@ray-js/robot-map-sdk';
+import { RobotMapProps } from './props';
+declare const RobotMap: {
+    ({ map, path, roomProperties, forbiddenSweepZones, forbiddenMopZones, cleanZones, virtualWalls, spots, detectedObjects, customElements, onMapReady, config, runtime, ...callbacks }: RobotMapProps & AppOptions['events']): React.JSX.Element;
+    defaultProps: RobotMapProps;
+    displayName: string;
+};
+export default RobotMap;

package/lib/RobotMap.js

@@ -0,0 +1,195 @@
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
+const _excluded = ["map", "path", "roomProperties", "forbiddenSweepZones", "forbiddenMopZones", "cleanZones", "virtualWalls", "spots", "detectedObjects", "customElements", "onMapReady", "config", "runtime"];
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.for-each.js";
+import "core-js/modules/esnext.iterator.map.js";
+import "core-js/modules/esnext.iterator.reduce.js";
+import "core-js/modules/web.dom-collections.iterator.js";
+/* eslint-disable @typescript-eslint/no-empty-function */
+import React, { useCallback, useEffect, useRef, useState } from 'react';
+import createInvoke from '@ray-js/webview-invoke/native';
+import { createWebviewContext, WebView } from '@ray-js/ray';
+import { MAP_API_METHODS, MAP_CALLBACK_METHODS } from '@ray-js/robot-map-sdk';
+import { nanoid } from 'nanoid/non-secure';
+import { robotMapDefaultProps } from './props';
+
+// 回调名到事件名的映射
+const CALLBACK_TO_EVENT_MAP = _objectSpread({
+  onInitialized: 'onInitialized'
+}, MAP_CALLBACK_METHODS.reduce((acc, methodName) => {
+  acc[methodName] = methodName;
+  return acc;
+}, {}));
+const RobotMap = _ref => {
+  let {
+      map,
+      path,
+      roomProperties,
+      forbiddenSweepZones,
+      forbiddenMopZones,
+      cleanZones,
+      virtualWalls,
+      spots,
+      detectedObjects,
+      customElements,
+      onMapReady,
+      config = {},
+      runtime = {}
+    } = _ref,
+    callbacks = _objectWithoutProperties(_ref, _excluded);
+  const [mapApi, setMapApi] = useState(null);
+  const webviewId = useRef(nanoid()).current;
+  const webviewContext = useRef(null);
+  const invoke = useRef(null);
+  const callbacksRef = useRef(callbacks);
+  const triggersRef = useRef({
+    onReceiveMap: () => {},
+    onReceivePath: () => {},
+    onReceiveRoomProperties: () => {},
+    onReceiveForbiddenSweepZones: () => {},
+    onReceiveForbiddenMopZones: () => {},
+    onReceiveCleanZones: () => {},
+    onReceiveVirtualWalls: () => {},
+    onReceiveSpots: () => {},
+    onReceiveDetectedObjects: () => {},
+    onReceiveCustomElements: () => {},
+    onUpdateRuntime: () => {}
+  });
+  const handleMessage = useCallback(event => {
+    if (invoke.current) {
+      invoke.current.listener(event);
+    }
+  }, []);
+
+  // 事件分发函数 - 这个函数是稳定的，不会随渲染变化
+  const eventDispatcher = useCallback(function (eventName) {
+    const propName = CALLBACK_TO_EVENT_MAP[eventName];
+    if (propName && callbacksRef.current[propName]) {
+      for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+        args[_key - 1] = arguments[_key];
+      }
+      // 调用最新的prop回调
+      callbacksRef.current[propName](...args);
+    }
+  }, []);
+  useEffect(() => {
+    // 更新回调引用
+    callbacksRef.current = callbacks;
+  });
+  useEffect(() => {
+    webviewContext.current = createWebviewContext(webviewId);
+    Object.defineProperty(webviewContext.current, 'platform', {
+      value: 'mini',
+      writable: false
+    });
+    invoke.current = createInvoke(() => webviewContext.current);
+    invoke.current.define('onDocumentReady', () => {
+      invoke.current.bind('initApp')({
+        options: config,
+        runtime
+      });
+    });
+    triggersRef.current.onReceiveMap = invoke.current.bind('onReceiveMap');
+    triggersRef.current.onReceivePath = invoke.current.bind('onReceivePath');
+    triggersRef.current.onReceiveRoomProperties = invoke.current.bind('onReceiveRoomProperties');
+    triggersRef.current.onReceiveForbiddenSweepZones = invoke.current.bind('onReceiveForbiddenSweepZones');
+    triggersRef.current.onReceiveForbiddenMopZones = invoke.current.bind('onReceiveForbiddenMopZones');
+    triggersRef.current.onReceiveCleanZones = invoke.current.bind('onReceiveCleanZones');
+    triggersRef.current.onReceiveVirtualWalls = invoke.current.bind('onReceiveVirtualWalls');
+    triggersRef.current.onReceiveSpots = invoke.current.bind('onReceiveSpots');
+    triggersRef.current.onReceiveDetectedObjects = invoke.current.bind('onReceiveDetectedObjects');
+    triggersRef.current.onReceiveCustomElements = invoke.current.bind('onReceiveCustomElements');
+    triggersRef.current.onUpdateRuntime = invoke.current.bind('onUpdateRuntime');
+
+    // 为每个需要的事件定义分发函数
+    Object.keys(CALLBACK_TO_EVENT_MAP).forEach(eventName => {
+      invoke.current.define(eventName, function () {
+        if (eventName === 'onInitialized') {
+          const mapApi = MAP_API_METHODS.reduce((acc, methodName) => {
+            acc[methodName] = invoke.current.bind(methodName);
+            return acc;
+          }, {});
+          setMapApi(mapApi);
+          onMapReady === null || onMapReady === void 0 || onMapReady(mapApi);
+        }
+        for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+          args[_key2] = arguments[_key2];
+        }
+        eventDispatcher(eventName, ...args);
+      });
+    });
+  }, []);
+  useEffect(() => {
+    if (mapApi && map) {
+      triggersRef.current.onReceiveMap(map);
+    }
+  }, [map, mapApi]);
+  useEffect(() => {
+    if (mapApi && path) {
+      triggersRef.current.onReceivePath(path);
+    }
+  }, [path, mapApi]);
+  useEffect(() => {
+    if (mapApi && roomProperties) {
+      triggersRef.current.onReceiveRoomProperties(roomProperties);
+    }
+  }, [roomProperties, mapApi]);
+  useEffect(() => {
+    if (mapApi && forbiddenSweepZones) {
+      triggersRef.current.onReceiveForbiddenSweepZones(forbiddenSweepZones);
+    }
+  }, [forbiddenSweepZones, mapApi]);
+  useEffect(() => {
+    if (mapApi && forbiddenMopZones) {
+      triggersRef.current.onReceiveForbiddenMopZones(forbiddenMopZones);
+    }
+  }, [forbiddenMopZones, mapApi]);
+  useEffect(() => {
+    if (mapApi && cleanZones) {
+      triggersRef.current.onReceiveCleanZones(cleanZones);
+    }
+  }, [cleanZones, mapApi]);
+  useEffect(() => {
+    if (mapApi && virtualWalls) {
+      triggersRef.current.onReceiveVirtualWalls(virtualWalls);
+    }
+  }, [virtualWalls, mapApi]);
+  useEffect(() => {
+    if (mapApi && spots) {
+      triggersRef.current.onReceiveSpots(spots);
+    }
+  }, [spots, mapApi]);
+  useEffect(() => {
+    if (mapApi && detectedObjects) {
+      triggersRef.current.onReceiveDetectedObjects(detectedObjects);
+    }
+  }, [detectedObjects, mapApi]);
+  useEffect(() => {
+    if (mapApi && customElements) {
+      triggersRef.current.onReceiveCustomElements(customElements);
+    }
+  }, [customElements, mapApi]);
+  useEffect(() => {
+    if (mapApi && runtime) {
+      triggersRef.current.onUpdateRuntime(runtime);
+    }
+  }, [runtime, mapApi]);
+  useEffect(() => {
+    if (mapApi) {
+      setTimeout(() => {
+        mapApi.getCleanZones();
+      }, 2000);
+    }
+  }, [mapApi]);
+  return /*#__PURE__*/React.createElement(WebView, {
+    src: "webview://node_modules/@ray-js/robot-map-sdk/dist-app/index.html"
+    // src="http://127.0.0.1:3000"
+    ,
+    id: webviewId,
+    onMessage: handleMessage
+  });
+};
+RobotMap.defaultProps = robotMapDefaultProps;
+RobotMap.displayName = 'RobotMap';
+export default RobotMap;

package/lib/index.config.d.ts

@@ -0,0 +1,4 @@
+export declare const tuya: {
+    backgroundColor: string;
+    navigationBarTitleText: string;
+};

package/lib/index.config.js

@@ -0,0 +1,4 @@
+export const tuya = {
+  backgroundColor: '#f2f4f6',
+  navigationBarTitleText: 'Ray 跨端组件'
+};

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { default as RobotMap } from './RobotMap';
+export * from '@ray-js/robot-map-sdk';

package/lib/index.js

@@ -0,0 +1,2 @@
+export { default as RobotMap } from './RobotMap';
+export * from '@ray-js/robot-map-sdk';

package/lib/props.d.ts

@@ -0,0 +1,309 @@
+import { DeepPartialAppConfig, DeepPartialRuntimeConfig, MapApi, RoomProperty, ZoneParam, VirtualWallParam, DetectedObjectParam, CustomElementParam, MapState, PathState, Point, RoomData, SpotParam } from '@ray-js/robot-map-sdk';
+/**
+ * 机器人地图组件属性接口
+ *
+ * 定义了机器人地图组件的所有属性，包括地图数据、配置选项、事件回调等。
+ * Robot map component props interface that defines all properties including map data, configuration options, event callbacks, etc.
+ */
+export interface RobotMapProps {
+    /**
+     * @description.zh 地图数据
+     * @description.en Map data
+     * @description.zh 通常来源于p2p通道的数据，分为结构化协议和点阵协议两种协议格式。
+     * @description.en Usually from the p2p channel data, divided into two protocol formats: structured protocol and raster protocol.
+     */
+    map: string;
+    /**
+     * @description.zh 路径数据
+     * @description.en Path data
+     * @description.zh 通常来源于p2p通道的数据，包含机器人的历史轨迹和当前位置。
+     * @description.en Usually from the p2p channel data, containing the historical trajectory and current position of the robot.
+     */
+    path?: string;
+    /**
+     * @description.zh 房间属性
+     * @description.en Room properties
+     * @description.zh 房间的属性信息数组，包含房间ID、名称、清扫状态等信息。
+     * @description.en Array of room property information including room ID, name, cleaning status, etc.
+     */
+    roomProperties?: RoomProperty[];
+    /**
+     * @description.zh 禁扫区域
+     * @description.en Forbidden sweep zones
+     * @description.zh 定义机器人不允许清扫的区域，机器人在这些区域内不会进行清扫作业。
+     * @description.en Defines areas where the robot is not allowed to sweep, the robot will not perform cleaning operations in these areas.
+     */
+    forbiddenSweepZones?: ZoneParam[];
+    /**
+     * @description.zh 禁拖区域
+     * @description.en Forbidden mop zones
+     * @description.zh 定义机器人不允许拖地的区域，机器人在这些区域内不会进行拖地作业。
+     * @description.en Defines areas where the robot is not allowed to mop, the robot will not perform mopping operations in these areas.
+     */
+    forbiddenMopZones?: ZoneParam[];
+    /**
+     * @description.zh 清扫区域
+     * @description.en Clean zones
+     * @description.zh 定义机器人清扫的区域，机器人在这些区域内进行清扫作业。
+     * @description.en Defines areas where the robot performs cleaning operations.
+     */
+    cleanZones?: ZoneParam[];
+    /**
+     * @description.zh 虚拟墙
+     * @description.en Virtual walls
+     * @description.zh 虚拟障碍物，机器人将其视为实体墙壁，不会穿越这些区域。
+     * @description.en Virtual obstacles that the robot treats as physical walls and will not cross these areas.
+     */
+    virtualWalls?: VirtualWallParam[];
+    /**
+     * @description.zh 定点清扫点
+     * @description.en Spot clean points
+     * @description.zh 定点清扫点，机器人将在这些点进行清扫作业。
+     * @description.en Spot clean points, the robot will perform cleaning operations at these points.
+     */
+    spots?: SpotParam[];
+    /**
+     * @description.zh 检测对象
+     * @description.en Detected objects
+     * @description.zh 机器人检测到的物体信息，如家具、障碍物等，用图标的方式呈现。
+     * @description.en Information about objects detected by the robot, such as furniture, obstacles, etc. presented in icon form.
+     */
+    detectedObjects?: DetectedObjectParam[];
+    /**
+     * @description.zh 自定义元素
+     * @description.en Custom elements
+     * @description.zh 用户自定义的地图元素，支持图片、GIF和HTML三种格式。
+     * @description.en User-defined map elements, which can be images, GIFs, and HTML.
+     */
+    customElements?: CustomElementParam[];
+    /**
+     * @description.zh 配置项
+     * @description.en Configuration options
+     * @description.zh 地图组件的配置选项，用于定义视觉样式、素材资源和交互行为等一次性的配置
+     * @description.en Configuration options for the map component to customize map display and behavior.
+     */
+    config?: DeepPartialAppConfig;
+    /**
+     * @description.zh 运行时
+     * @description.en Runtime
+     * @description.zh 控制地图在运行时的各种行为状态
+     * @description.en Control the various behavior states of the map at runtime
+     */
+    runtime?: DeepPartialRuntimeConfig;
+    /**
+     * @description.zh 地图初始化完成，API准备就绪的回调
+     * @description.en Callback when the map is initialized and the API is ready
+     * @description.zh 当地图组件初始化完成并且所有API功能可用时触发的回调函数。
+     * @description.en Callback function triggered when the map component is initialized and all API functions are available.
+     * @param mapApi - 可供使用的地图 API 函数对象 / Available map API functions object
+     */
+    onMapReady?: (mapApi: MapApi) => void;
+    /**
+     * @description.zh 地图首次绘制完成回调
+     * @description.en Callback when the map is first drawn
+     * @description.zh 当地图首次加载并绘制完成后触发，通常用于移除Loading状态。与 onMapDrawed 不同，此回调只在首次绘制时触发一次。
+     * @description.en Triggered when the map is first loaded and drawn, usually used to remove the loading state. Unlike onMapDrawed, this callback is only triggered once on the first draw.
+     * @param.zh mapState - 地图状态信息，包含地图ID、原点、尺寸等信息
+     * @param.en mapState - Map state information including map ID, origin, dimensions, etc.
+     */
+    onMapFirstDrawed?: (mapState: MapState) => void;
+    /**
+     * @description.zh 地图绘制完成回调
+     * @description.en Callback when the map is drawn
+     * @description.zh 当地图数据解析并绘制完成后触发。
+     * @description.en Triggered when map data is parsed and drawn.
+     * @param.zh mapState - 地图状态信息，包含地图ID、原点、尺寸等信息
+     * @param.en mapState - Map state information including map ID, origin, dimensions, etc.
+     */
+    onMapDrawed?: (mapState: MapState) => void;
+    /**
+     * @description.zh 路径绘制完成回调
+     * @description.en Callback when the path is drawn
+     * @description.zh 当机器人路径数据绘制完成后触发。
+     * @description.en Triggered when robot path data is drawn.
+     * @param.zh pathState - 路径状态信息，包含路径ID、类型、机器人位置等
+     * @param.en pathState - Path state information including path ID, type, robot position, etc.
+     */
+    onPathDrawed?: (pathState: PathState) => void;
+    /**
+     * @description.zh 房间信息绘制完成回调
+     * @description.en Callback when room properties are drawn
+     * @description.zh 当房间属性信息绘制完成后触发。
+     * @description.en Triggered when room property information is drawn.
+     * @param.zh rooms - 房间属性信息数组
+     * @param.en rooms - Array of room property information
+     */
+    onRoomPropertiesDrawed?: (rooms: RoomProperty[]) => void;
+    /**
+     * @description.zh 点击房间回调
+     * @description.en Callback when clicking on a room
+     * @description.zh 当用户点击地图上的房间区域时触发。
+     * @description.en Triggered when user clicks on a room area on the map.
+     * @param.zh room - 被点击的房间信息
+     * @param.en room - Clicked room information
+     */
+    onClickRoom?: (room: Partial<RoomData>) => void;
+    /**
+     * @description.zh 点击房间信息回调
+     * @description.en Callback when clicking on room properties
+     * @description.zh 当用户点击房间的属性信息图标时触发。
+     * @description.en Triggered when user clicks on the room property information icon.
+     * @param.zh room - 被点击的房间信息
+     * @param.en room - Clicked room information
+     */
+    onClickRoomProperties?: (room: Partial<RoomData>) => void;
+    /**
+     * @description.zh 点击禁扫区域删除按钮的回调
+     * @description.en Callback when clicking the delete button of forbidden sweep zone
+     * @description.zh 当用户点击禁扫区域删除按钮时触发。
+     * @description.en Triggered when user clicks the delete button of forbidden sweep zone.
+     * @param.zh id - 被删除的禁扫区域ID
+     * @param.en id - ID of the deleted forbidden sweep zone
+     */
+    onRemoveForbiddenSweepZone?: (id: string) => void;
+    /**
+     * @description.zh 点击禁拖区域删除按钮的回调
+     * @description.en Callback when clicking the delete button of forbidden mop zone
+     * @description.zh 当用户点击禁拖区域删除按钮时触发。
+     * @description.en Triggered when user clicks the delete button of forbidden mop zone.
+     * @param.zh id - 被删除的禁拖区域ID
+     * @param.en id - ID of the deleted forbidden mop zone
+     */
+    onRemoveForbiddenMopZone?: (id: string) => void;
+    /**
+     * @description.zh 点击清扫区域删除按钮的回调
+     * @description.en Callback when clicking the delete button of clean zone
+     * @description.zh 当用户点击清扫区域删除按钮时触发。
+     * @description.en Triggered when user clicks the delete button of clean zone.
+     * @param.zh id - 被删除的清扫区域ID
+     * @param.en id - ID of the deleted clean zone
+     */
+    onRemoveCleanZone?: (id: string) => void;
+    /**
+     * @description.zh 点击虚拟墙删除按钮的回调
+     * @description.en Callback when clicking the delete button of virtual wall
+     * @description.zh 当用户点击虚拟墙删除按钮时触发。
+     * @description.en Triggered when user clicks the delete button of virtual wall.
+     * @param.zh id - 被删除的虚拟墙ID
+     * @param.en id - ID of the deleted virtual wall
+     */
+    onRemoveVirtualWall?: (id: string) => void;
+    /**
+     * @description.zh 更新禁扫区域的回调
+     * @description.en Callback when updating forbidden sweep zone
+     * @description.zh 当用户操作禁扫区域（如拖拽、缩放）后触发。
+     * @description.en Triggered when user operates forbidden sweep zone (such as dragging, scaling).
+     * @param.zh zone - 更新后的禁扫区域数据
+     * @param.en zone - Updated forbidden sweep zone data
+     */
+    onUpdateForbiddenSweepZone?: (zone: ZoneParam) => void;
+    /**
+     * @description.zh 更新禁拖区域的回调
+     * @description.en Callback when updating forbidden mop zone
+     * @description.zh 当用户操作禁拖区域（如拖拽、缩放）后触发。
+     * @description.en Triggered when user operates forbidden mop zone (such as dragging, scaling).
+     * @param.zh zone - 更新后的禁拖区域数据
+     * @param.en zone - Updated forbidden mop zone data
+     */
+    onUpdateForbiddenMopZone?: (zone: ZoneParam) => void;
+    /**
+     * @description.zh 更新清扫区域的回调
+     * @description.en Callback when updating clean zone
+     * @description.zh 当用户操作清扫区域（如拖拽、缩放）后触发。
+     * @description.en Triggered when user operates clean zone (such as dragging, scaling).
+     * @param.zh zone - 更新后的清扫区域数据
+     * @param.en zone - Updated clean zone data
+     */
+    onUpdateCleanZone?: (zone: ZoneParam) => void;
+    /**
+     * @description.zh 更新虚拟墙的回调
+     * @description.en Callback when updating virtual wall
+     * @description.zh 当用户操作虚拟墙（如拖拽、旋转）后触发。
+     * @description.en Triggered when user operates virtual wall (such as dragging, rotating).
+     * @param.zh wall - 更新后的虚拟墙数据
+     * @param.en wall - Updated virtual wall data
+     */
+    onUpdateVirtualWall?: (wall: VirtualWallParam) => void;
+    /**
+     * @description.zh 更新定点清扫的回调
+     * @description.en Callback when updating spot clean
+     * @description.zh 当用户操作定点清扫位置后触发。
+     * @description.en Triggered when user operates spot clean position.
+     * @param.zh spot - 更新后的定点清扫数据
+     * @param.en spot - Updated spot clean data
+     */
+    onUpdateSpot?: (spot: SpotParam) => void;
+    /**
+     * @description.zh 点击禁扫区域回调
+     * @description.en Callback when clicking forbidden sweep zone
+     * @description.zh 当用户点击禁扫区域时触发。
+     * @description.en Triggered when user clicks forbidden sweep zone.
+     * @param.zh zone - 被点击的禁扫区域数据
+     * @param.en zone - Clicked forbidden sweep zone data
+     */
+    onClickForbiddenSweepZone?: (zone: ZoneParam) => void;
+    /**
+     * @description.zh 点击禁拖区域回调
+     * @description.en Callback when clicking forbidden mop zone
+     * @description.zh 当用户点击禁拖区域时触发。
+     * @description.en Triggered when user clicks forbidden mop zone.
+     * @param.zh zone - 被点击的禁拖区域数据
+     * @param.en zone - Clicked forbidden mop zone data
+     */
+    onClickForbiddenMopZone?: (zone: ZoneParam) => void;
+    /**
+     * @description.zh 点击清扫区域回调
+     * @description.en Callback when clicking clean zone
+     * @description.zh 当用户点击清扫区域时触发。
+     * @description.en Triggered when user clicks clean zone.
+     * @param.zh zone - 被点击的清扫区域数据
+     * @param.en zone - Clicked clean zone data
+     */
+    onClickCleanZone?: (zone: ZoneParam) => void;
+    /**
+     * @description.zh 点击虚拟墙回调
+     * @description.en Callback when clicking virtual wall
+     * @description.zh 当用户点击虚拟墙时触发。
+     * @description.en Triggered when user clicks virtual wall.
+     * @param.zh wall - 被点击的虚拟墙数据
+     * @param.en wall - Clicked virtual wall data
+     */
+    onClickVirtualWall?: (wall: VirtualWallParam) => void;
+    /**
+     * @description.zh 点击定点清扫回调
+     * @description.en Callback when clicking spot clean
+     * @description.zh 当用户点击定点清扫点时触发。
+     * @description.en Triggered when user clicks spot clean point.
+     * @param.zh spot - 被点击的定点清扫数据
+     * @param.en spot - Clicked spot clean data
+     */
+    onClickSpot?: (spot: SpotParam) => void;
+    /**
+     * @description.zh 点击检测物体回调
+     * @description.en Callback when clicking detected object
+     * @description.zh 当用户点击地图上的检测物体时触发。
+     * @description.en Triggered when user clicks detected object on the map.
+     * @param.zh object - 被点击的检测物体数据
+     * @param.en object - Clicked detected object data
+     */
+    onClickDetectedObject?: (object: DetectedObjectParam) => void;
+    /**
+     * @description.zh 点击自定义元素回调
+     * @description.en Callback when clicking custom element
+     * @description.zh 当用户点击自定义元素时触发。
+     * @description.en Triggered when user clicks custom element.
+     * @param.zh element - 被点击的自定义元素数据
+     * @param.en element - Clicked custom element data
+     */
+    onClickCustomElement?: (element: CustomElementParam) => void;
+    /**
+     * @description.zh 更新分割线回调
+     * @description.en Callback when updating divider
+     * @description.zh 当用户操作分割线（如拖拽端点、移动整条线）后触发。
+     * @description.en Triggered when user operates divider (such as dragging endpoints, moving the entire line).
+     * @param.zh divider - 更新后的分割线数据
+     * @param.en divider - Updated divider data
+     */
+    onUpdateDivider?: (divider: Point[]) => void;
+}
+export declare const robotMapDefaultProps: RobotMapProps;

package/lib/props.js

@@ -0,0 +1,10 @@
+/**
+ * 机器人地图组件属性接口
+ *
+ * 定义了机器人地图组件的所有属性，包括地图数据、配置选项、事件回调等。
+ * Robot map component props interface that defines all properties including map data, configuration options, event callbacks, etc.
+ */
+
+export const robotMapDefaultProps = {
+  map: ''
+};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@ray-js/robot-map",
+  "version": "0.0.2-beta-3",
+  "description": "机器人地图组件",
+  "main": "lib/index",
+  "files": [
+    "lib"
+  ],
+  "license": "MIT",
+  "types": "lib/index.d.ts",
+  "maintainers": [
+    "tuya_npm",
+    {
+      "name": "tuyafe",
+      "email": "tuyafe@tuya.com"
+    }
+  ],
+  "scripts": {
+    "lint": "eslint src --ext .js,.jsx,.ts,.tsx --fix",
+    "lint:style": "stylelint \"src/**/*.less\" --fix",
+    "build": "ray build --type=component",
+    "dev": "ray start --type=component",
+    "build:tuya": "ray build -t tuya ./example",
+    "build:web": "ray build ./example --target=web",
+    "start:tuya": "ray start -t tuya ./example",
+    "start:web": "ray start ./example -t web",
+    "prepublishOnly": "yarn build",
+    "release-it": "standard-version",
+    "copy-sdk": "node scripts/copy-sdk.js"
+  },
+  "peerDependencies": {
+    "@ray-js/ray": "^1.7.39"
+  },
+  "dependencies": {
+    "@ray-js/robot-map-sdk": "0.0.2",
+    "clsx": "^1.2.1",
+    "nanoid": "^5.1.6"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^7.2.1",
+    "@commitlint/config-conventional": "^9.0.1",
+    "@ray-js/cli": "^1.7.39",
+    "@ray-js/panel-sdk": "^1.13.10",
+    "@ray-js/ray": "^1.7.39",
+    "@vant/stylelint-config": "^1.4.2",
+    "core-js": "^3.19.1",
+    "eslint-config-tuya-panel": "^0.4.2",
+    "fs-extra": "^11.3.0",
+    "husky": "^1.2.0",
+    "lint-staged": "^10.2.11",
+    "standard-version": "9.3.2",
+    "stylelint": "^13.0.0"
+  },
+  "husky": {
+    "hooks": {
+      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS --config commitlint.config.js",
+      "pre-commit": "lint-staged"
+    }
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx}": [
+      "eslint --fix",
+      "git add"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write",
+      "git add"
+    ]
+  }
+}