@ray-js/robot-map-sdk 0.0.17-beta.8 → 0.1.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/dist/constant/methods.js +1 -1
  2. package/dist/index.d.ts +161 -1
  3. package/dist/index.rjs.js +1 -1
  4. package/dist-app/assets/index-CGI0HmQU.js +1 -0
  5. package/dist-app/index.html +1 -1
  6. package/dist-docs/404.html +2 -2
  7. package/dist-docs/assets/{app.BFSpQp-P.js → app.DA7jnJ_k.js} +1 -1
  8. package/dist-docs/assets/chunks/@localSearchIndexroot.C7PYZQrC.js +1 -0
  9. package/dist-docs/assets/chunks/{BitmapFont.OdYtupSe.js → BitmapFont.ga4S-mSe.js} +1 -1
  10. package/dist-docs/assets/chunks/{BufferResource.B-0As3l7.js → BufferResource.DaBoo8RA.js} +4 -4
  11. package/dist-docs/assets/chunks/{CanvasRenderer.W2zUqVi6.js → CanvasRenderer.vEsk0ehs.js} +1 -1
  12. package/dist-docs/assets/chunks/{RenderTargetSystem.jb8ykiKY.js → RenderTargetSystem.DokPFeg4.js} +1 -1
  13. package/dist-docs/assets/chunks/{VPLocalSearchBox.BY3UiHRR.js → VPLocalSearchBox.nW9U6a8I.js} +1 -1
  14. package/dist-docs/assets/chunks/{WebGLRenderer.CD7EdgzR.js → WebGLRenderer.DDBDE-SE.js} +1 -1
  15. package/dist-docs/assets/chunks/{WebGPURenderer.DgGZ32Cv.js → WebGPURenderer.CrTlLNt7.js} +1 -1
  16. package/dist-docs/assets/chunks/browserAll.ZTT3ke0G.js +14 -0
  17. package/dist-docs/assets/chunks/index.BD_SMmlU.js +744 -0
  18. package/dist-docs/assets/chunks/theme.DhH3-Q9Y.js +4 -0
  19. package/dist-docs/assets/chunks/{webworkerAll.CSwmESqx.js → webworkerAll.n0O5aLP1.js} +2 -2
  20. package/dist-docs/assets/{guide_getting-started.md.DdQF2dYx.js → guide_getting-started.md.DpcKgvcS.js} +2 -2
  21. package/dist-docs/assets/guide_getting-started.md.DpcKgvcS.lean.js +1 -0
  22. package/dist-docs/assets/{reference_methods.md.CXtsI5Rx.js → reference_methods.md.BUNT8YBG.js} +26 -2
  23. package/dist-docs/assets/reference_methods.md.BUNT8YBG.lean.js +1 -0
  24. package/dist-docs/guide/advanced-usage.html +3 -3
  25. package/dist-docs/guide/concepts.html +3 -3
  26. package/dist-docs/guide/getting-started.html +5 -5
  27. package/dist-docs/guide/mcp.html +3 -3
  28. package/dist-docs/guide/spot-room-binding.html +3 -3
  29. package/dist-docs/hashmap.json +1 -1
  30. package/dist-docs/index.html +3 -3
  31. package/dist-docs/plans/2026-03-04-detected-objects-visibility-design.html +3 -3
  32. package/dist-docs/plans/2026-03-04-show-detected-objects-implementation-plan.html +3 -3
  33. package/dist-docs/plans/2026-03-10-simulator-debug-design.html +3 -3
  34. package/dist-docs/plans/2026-03-10-simulator-events-console-design.html +3 -3
  35. package/dist-docs/plans/2026-03-10-simulator-events-console-implementation-plan.html +3 -3
  36. package/dist-docs/plans/2026-03-10-simulator-runtime-controls-design.html +3 -3
  37. package/dist-docs/plans/2026-03-10-simulator-runtime-controls-implementation-plan.html +3 -3
  38. package/dist-docs/plans/2026-03-10-testing-rollout-next-steps-plan.html +3 -3
  39. package/dist-docs/plans/2026-03-11-simulator-logger-dump-implementation-plan.html +3 -3
  40. package/dist-docs/reference/callbacks.html +3 -3
  41. package/dist-docs/reference/config.html +3 -3
  42. package/dist-docs/reference/data.html +3 -3
  43. package/dist-docs/reference/methods.html +29 -5
  44. package/dist-docs/reference/runtime.html +3 -3
  45. package/dist-docs/reference/types.html +3 -3
  46. package/dist-docs/reference/utils.html +3 -3
  47. package/dist-docs/simulator/index.html +3 -3
  48. package/package.json +1 -1
  49. package/dist-app/assets/index-CWkiQ9Lk.js +0 -1
  50. package/dist-docs/assets/chunks/@localSearchIndexroot.BiihW6sw.js +0 -1
  51. package/dist-docs/assets/chunks/browserAll.MWFc2Ux2.js +0 -14
  52. package/dist-docs/assets/chunks/index.CKspi49Y.js +0 -744
  53. package/dist-docs/assets/chunks/theme.QnUXQOkw.js +0 -4
  54. package/dist-docs/assets/guide_getting-started.md.DdQF2dYx.lean.js +0 -1
  55. package/dist-docs/assets/reference_methods.md.CXtsI5Rx.lean.js +0 -1
@@ -1 +1 @@
1
- const e=["areRoomsAdjacent","getAdjacentRoomIds","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getThresholds","getRamps","getSpots","getRoomAnchors","getWayPoints","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getThresholdPointsByViewportCenter","getRampPointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","isWallIntersectsAnyRoom","isZoneIntersectsAnyRoom","resetPanZoom","snapshot","snapshotByData","getCustomCarpets","forceEndGesture","getFurniturePointsByViewportCenter","getCustomCarpetPointsByViewportCenter","getRectPointsByCenter","getFurnitures","drawCustomZones","getCustomZones","clearCustomZones","setEditingCustomZones","setDisabledCustomZones"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onRoomsDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onRemoveThreshold","onRemoveRamp","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateThreshold","onUpdateRamp","onUpdateSpot","onUpdateRoomAnchor","onUpdateWayPoint","onUpdateDivider","onDividerOutOfRoom","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickThreshold","onClickRamp","onClickSpot","onClickRoomAnchor","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};
1
+ const e=["getDiagnostics","areRoomsAdjacent","getAdjacentRoomIds","getForbiddenSweepZones","getForbiddenMopZones","getCleanZones","getVirtualWalls","getThresholds","getRamps","getSpots","getRoomAnchors","getWayPoints","getViewportCenterPoint","getMapCenterPoint","getWallPointsByViewportCenter","getForbiddenSweepZonePointsByViewportCenter","getForbiddenMopZonePointsByViewportCenter","getCleanZonePointsByViewportCenter","getThresholdPointsByViewportCenter","getRampPointsByViewportCenter","getSpotPointByViewportCenter","getEffectiveDividerPoints","getDividerEndPoints","isNearChargerOrRobot","isPointInAnyRoom","isWallIntersectsAnyRoom","isZoneIntersectsAnyRoom","resetPanZoom","snapshot","snapshotByData","getCustomCarpets","forceEndGesture","getFurniturePointsByViewportCenter","getCustomCarpetPointsByViewportCenter","getRectPointsByCenter","getFurnitures","drawCustomZones","getCustomZones","clearCustomZones","setEditingCustomZones","setDisabledCustomZones"],o=["onMapFirstDrawed","onMapDrawed","onPathDrawed","onRoomPropertiesDrawed","onRoomsDrawed","onClickRoom","onClickRoomProperties","onRemoveForbiddenSweepZone","onRemoveForbiddenMopZone","onRemoveCleanZone","onRemoveVirtualWall","onRemoveThreshold","onRemoveRamp","onUpdateForbiddenSweepZone","onUpdateForbiddenMopZone","onUpdateCleanZone","onUpdateVirtualWall","onUpdateThreshold","onUpdateRamp","onUpdateSpot","onUpdateRoomAnchor","onUpdateWayPoint","onUpdateDivider","onDividerOutOfRoom","onClickForbiddenSweepZone","onClickForbiddenMopZone","onClickCleanZone","onClickVirtualWall","onClickThreshold","onClickRamp","onClickSpot","onClickRoomAnchor","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 CHANGED
@@ -1036,6 +1036,70 @@ export declare type DetectedObjectParam = {
1036
1036
  customData?: Record<string, any>
1037
1037
  }
1038
1038
 
1039
+ export declare type DiagnosticEvent = {
1040
+ sequence: number;
1041
+ capturedAt: number;
1042
+ type: string;
1043
+ detail: unknown;
1044
+ /** High-frequency inputs represented by this record; pending counts are exposed by events. */
1045
+ aggregation?: {
1046
+ policy: 'first-per-window' | 'state-change-or-first-per-window';
1047
+ windowMs: number;
1048
+ count: number;
1049
+ suppressed: number;
1050
+ from: number;
1051
+ to: number;
1052
+ };
1053
+ };
1054
+
1055
+ export declare type DiagnosticsDescriptor = {
1056
+ instanceId: string;
1057
+ instanceKey: string;
1058
+ generation: number;
1059
+ role: 'main' | 'snapshot' | 'auxiliary';
1060
+ lifecycle: 'created' | 'ready' | 'destroyed';
1061
+ renderer: 'pixi-2d';
1062
+ };
1063
+
1064
+ export declare type DiagnosticsRequest = {
1065
+ operation: 'describe' | 'inspect' | 'events' | 'locate';
1066
+ instanceId?: string;
1067
+ generation?: number;
1068
+ sections?: DiagnosticsSection[];
1069
+ after?: number;
1070
+ limit?: number;
1071
+ types?: string[];
1072
+ target?: {
1073
+ type: string;
1074
+ id?: string | number;
1075
+ part?: string;
1076
+ };
1077
+ budget?: {
1078
+ maxBytes?: number;
1079
+ maxEntities?: number;
1080
+ maxPoints?: number;
1081
+ };
1082
+ };
1083
+
1084
+ export declare type DiagnosticsResponse = {
1085
+ schemaVersion: 1;
1086
+ sdkVersion: 'unknown';
1087
+ instanceId: string | null;
1088
+ generation: number | null;
1089
+ capturedAt: number;
1090
+ status: DiagnosticsStatus;
1091
+ source: 'sdk-state';
1092
+ data?: unknown;
1093
+ error?: {
1094
+ code: string;
1095
+ message: string;
1096
+ };
1097
+ };
1098
+
1099
+ export declare type DiagnosticsSection = 'map' | 'config' | 'runtime' | 'entities' | 'interaction' | 'viewport' | 'render' | 'errors';
1100
+
1101
+ export declare type DiagnosticsStatus = 'available' | 'partial' | 'unsupported' | 'unknown' | 'error';
1102
+
1039
1103
  /** 方向 */
1040
1104
  export declare type Direction = 'horizontal' | 'vertical'
1041
1105
 
@@ -1295,7 +1359,7 @@ export declare type LoggerPayload = {
1295
1359
  ts: number
1296
1360
  }
1297
1361
 
1298
- export declare const MAP_API_METHODS: readonly ["areRoomsAdjacent", "getAdjacentRoomIds", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getThresholds", "getRamps", "getSpots", "getRoomAnchors", "getWayPoints", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getThresholdPointsByViewportCenter", "getRampPointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "isWallIntersectsAnyRoom", "isZoneIntersectsAnyRoom", "resetPanZoom", "snapshot", "snapshotByData", "getCustomCarpets", "forceEndGesture", "getFurniturePointsByViewportCenter", "getCustomCarpetPointsByViewportCenter", "getRectPointsByCenter", "getFurnitures", "drawCustomZones", "getCustomZones", "clearCustomZones", "setEditingCustomZones", "setDisabledCustomZones"];
1362
+ export declare const MAP_API_METHODS: readonly ["getDiagnostics", "areRoomsAdjacent", "getAdjacentRoomIds", "getForbiddenSweepZones", "getForbiddenMopZones", "getCleanZones", "getVirtualWalls", "getThresholds", "getRamps", "getSpots", "getRoomAnchors", "getWayPoints", "getViewportCenterPoint", "getMapCenterPoint", "getWallPointsByViewportCenter", "getForbiddenSweepZonePointsByViewportCenter", "getForbiddenMopZonePointsByViewportCenter", "getCleanZonePointsByViewportCenter", "getThresholdPointsByViewportCenter", "getRampPointsByViewportCenter", "getSpotPointByViewportCenter", "getEffectiveDividerPoints", "getDividerEndPoints", "isNearChargerOrRobot", "isPointInAnyRoom", "isWallIntersectsAnyRoom", "isZoneIntersectsAnyRoom", "resetPanZoom", "snapshot", "snapshotByData", "getCustomCarpets", "forceEndGesture", "getFurniturePointsByViewportCenter", "getCustomCarpetPointsByViewportCenter", "getRectPointsByCenter", "getFurnitures", "drawCustomZones", "getCustomZones", "clearCustomZones", "setEditingCustomZones", "setDisabledCustomZones"];
1299
1363
 
1300
1364
  export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapDrawed", "onPathDrawed", "onRoomPropertiesDrawed", "onRoomsDrawed", "onClickRoom", "onClickRoomProperties", "onRemoveForbiddenSweepZone", "onRemoveForbiddenMopZone", "onRemoveCleanZone", "onRemoveVirtualWall", "onRemoveThreshold", "onRemoveRamp", "onUpdateForbiddenSweepZone", "onUpdateForbiddenMopZone", "onUpdateCleanZone", "onUpdateVirtualWall", "onUpdateThreshold", "onUpdateRamp", "onUpdateSpot", "onUpdateRoomAnchor", "onUpdateWayPoint", "onUpdateDivider", "onDividerOutOfRoom", "onClickForbiddenSweepZone", "onClickForbiddenMopZone", "onClickCleanZone", "onClickVirtualWall", "onClickThreshold", "onClickRamp", "onClickSpot", "onClickRoomAnchor", "onClickWayPoint", "onClickDetectedObject", "onClickCustomElement", "onClickMap", "onClickCarpet", "onDeleteCarpet", "onUpdateCustomCarpet", "onDeleteCustomCarpet", "onGestureStart", "onGestureEnd", "onClickRobot", "onClickChargingStation", "onRemoveFurniture", "onUpdateFurniture", "onClickFurniture", "onRemoveCustomZone", "onUpdateCustomZone", "onClickCustomZone"];
1301
1365
 
@@ -1308,6 +1372,8 @@ export declare const MAP_CALLBACK_METHODS: readonly ["onMapFirstDrawed", "onMapD
1308
1372
  *
1309
1373
  */
1310
1374
  export declare interface MapApi {
1375
+ /** Read-only 2D WebView diagnostics; no image capture or input mutation. */
1376
+ getDiagnostics(request: DiagnosticsRequest): DiagnosticsResponse;
1311
1377
  /** 地图是否绘制完成 */
1312
1378
  isMapDrawn: boolean;
1313
1379
  /**
@@ -3366,8 +3432,67 @@ export declare type VirtualWallParam = {
3366
3432
 
3367
3433
  /** 途径点配置 */
3368
3434
  export declare type WayPointConfig = {
3435
+ /**
3436
+ * 途经点形态:
3437
+ * - 'pin': 水滴形图钉(默认,带尖角与序号圆圈)
3438
+ * - 'dot': 矢量圆点(非编辑态绿点,编辑态红点)
3439
+ */
3440
+ shape?: 'pin' | 'dot'
3441
+ /** 圆点形态样式配置(当 shape === 'dot' 时生效) */
3442
+ dot?: {
3443
+ /** 普通态样式 */
3444
+ normal?: WayPointDotStyle
3445
+ /** 编辑态样式 */
3446
+ editing?: WayPointDotStyle
3447
+ }
3369
3448
  /** 是否显示序号 */
3370
3449
  showOrder: boolean
3450
+ /**
3451
+ * 是否允许拖拽移动,默认 true。
3452
+ * 若置为 false,则处于编辑/选中态时仅展示高亮图标与样式,禁止手势拖拽(适用于首页/监控页只读选中场景)
3453
+ */
3454
+ canDrag?: boolean
3455
+ /** 名称标签配置 */
3456
+ nameLabel?: {
3457
+ /** 字体大小 */
3458
+ fontSize: number
3459
+ /** 字体名称 */
3460
+ fontFamily: string
3461
+ /** 字体粗细 */
3462
+ fontWeight: TextStyleFontWeight
3463
+ /** 文本颜色(可被 editing.color / normal.color 覆盖) */
3464
+ color?: ColorSource
3465
+ /** 文本位置,默认 bottom */
3466
+ position?: 'top' | 'right' | 'bottom' | 'left'
3467
+ /** 文本偏移量,默认 4 */
3468
+ offset?: number
3469
+ /** 编辑模式显示配置 */
3470
+ editing?: {
3471
+ /** 是否显示 */
3472
+ visible?: boolean
3473
+ /** 字体颜色 */
3474
+ color?: ColorSource
3475
+ /** 字体大小(默认继承外层 fontSize) */
3476
+ fontSize?: number
3477
+ /** 字体粗细(默认继承外层 fontWeight) */
3478
+ fontWeight?: TextStyleFontWeight
3479
+ /** 字体名称(默认继承外层 fontFamily) */
3480
+ fontFamily?: string
3481
+ }
3482
+ /** 普通模式显示配置 */
3483
+ normal?: {
3484
+ /** 是否显示 */
3485
+ visible?: boolean
3486
+ /** 字体颜色 */
3487
+ color?: ColorSource
3488
+ /** 字体大小(默认继承外层 fontSize) */
3489
+ fontSize?: number
3490
+ /** 字体粗细(默认继承外层 fontWeight) */
3491
+ fontWeight?: TextStyleFontWeight
3492
+ /** 字体名称(默认继承外层 fontFamily) */
3493
+ fontFamily?: string
3494
+ }
3495
+ }
3371
3496
  /** 编辑模式样式 */
3372
3497
  editing: {
3373
3498
  /** 图标资源路径 */
@@ -3428,12 +3553,47 @@ export declare type WayPointConfig = {
3428
3553
  }
3429
3554
  }
3430
3555
 
3556
+ /** 途径点圆点外光晕/聚焦环配置 */
3557
+ export declare type WayPointDotHalo = {
3558
+ /** 光晕半径(外径),默认编辑态 10 (radius + 4) */
3559
+ radius?: number
3560
+ /** 光晕填充颜色,默认继承圆点颜色 */
3561
+ color?: ColorSource
3562
+ /** 光晕透明度 (0 ~ 1),默认 0.2;置为 0 时不绘制光晕 */
3563
+ alpha?: number
3564
+ }
3565
+
3566
+ /** 途径点圆点样式配置 */
3567
+ export declare type WayPointDotStyle = {
3568
+ /** 圆点半径,默认普通态与编辑态均为 6 (保持切换时尺寸稳定) */
3569
+ radius?: number
3570
+ /** 圆点填充颜色,默认普通态 '#00B578' (通透绿),编辑态 '#ff4d4f' (珊瑚红) */
3571
+ color?: ColorSource
3572
+ /** 描边颜色,默认 '#ffffff' */
3573
+ strokeColor?: ColorSource
3574
+ /** 描边宽度,默认 2 */
3575
+ strokeWidth?: number
3576
+ /**
3577
+ * 外光晕/聚焦环配置(可选):
3578
+ * 编辑态默认开启(半径 11,透明度 0.2),增加地图聚焦感与层级感;
3579
+ * 可通过 `halo: false` 或 `{ alpha: 0 }` 显式关闭。
3580
+ */
3581
+ halo?: WayPointDotHalo | false
3582
+ }
3583
+
3431
3584
  /** 途径点参数 */
3432
3585
  export declare type WayPointParam = {
3433
3586
  /** 途径点ID */
3434
3587
  id: string
3435
3588
  /** 点坐标 */
3436
3589
  point: Point
3590
+ /** 途径点展示名称 */
3591
+ name?: string
3592
+ /**
3593
+ * 是否允许拖拽移动,默认继承 WayPointConfig.canDrag(即 true)。
3594
+ * 若置为 false,则即使进入编辑/选中态也仅展示高亮图标与样式,不可拖拽移动(适用于首页/巡航只读选中场景)
3595
+ */
3596
+ canDrag?: boolean
3437
3597
  }
3438
3598
 
3439
3599
  /**