@ray-js/robot-map-sdk 0.0.3-beta-22 → 0.0.3-beta-24

package/dist/index.d.ts

@@ -1,40 +1,22 @@
 import { AnimatedSprite } from 'pixi.js';
-import { AppContainer as AppContainer_2 } from './AppContainer';
 import { Application } from 'pixi.js';
 import { ApplicationOptions } from 'pixi.js';
 import { ColorSource } from 'pixi.js';
 import { Container } from 'pixi.js';
-import { ControlsConfig as ControlsConfig_2 } from '..';
-import { ControlsManager as ControlsManager_2 } from '../managers/ControlsManager';
-import { CustomElementsManager as CustomElementsManager_2 } from '../managers/CustomElementsManager';
 import { DestroyOptions } from 'pixi.js';
-import { DetectedObjectManager as DetectedObjectManager_2 } from '../managers/DetectedObjectManager';
-import { DividerConfig as DividerConfig_2 } from '..';
 import { Emitter } from 'mitt';
 import { FederatedPointerEvent } from 'pixi.js';
 import { Graphics } from 'pixi.js';
-import { HeatmapManager as HeatmapManager_2 } from '../managers/HeatmapManager';
-import { Interaction as Interaction_2 } from './Interaction';
-import { MapCallbacks as MapCallbacks_2 } from '..';
 import { MapData } from '@ray-js/robot-protocol';
 import { MapHeader } from '@ray-js/robot-protocol';
-import { MapManager as MapManager_2 } from '../managers/MapManager';
-import { MapState as MapState_2 } from '..';
 import { ParsedRasterMapData as ParsedRasterMapData_2 } from '@ray-js/robot-protocol';
 import { PathData } from '@ray-js/robot-protocol';
-import { PathManager as PathManager_2 } from '../managers/PathManager';
 import { Rectangle } from 'pixi.js';
-import { RingConfig as RingConfig_2 } from '..';
-import { RoomData as RoomData_2 } from '..';
-import { RoomManager as RoomManager_2 } from '../managers/RoomManager';
-import { RuntimeConfig as RuntimeConfig_2 } from '..';
 import { SPECIAL_ROOM_IDS } from '@ray-js/robot-protocol';
 import { SpecialRoomId } from '@ray-js/robot-protocol';
 import { Sprite } from 'pixi.js';
 import { TextStyleFontWeight } from 'pixi.js';
 import { Texture } from 'pixi.js';
-import { Ticker } from 'pixi.js';
-import { ViewportContainer as ViewportContainer_2 } from './ViewportContainer';
 
 /**
  * 地图静态配置
@@ -125,8 +107,14 @@ export declare type AppConfig = {
         }
         /** 房间属性配置 */
         property: {
-            /** 显示顺序 */
-            displayOrders: ('cleanMode' | 'suction' | 'cistern' | 'cleanTimes')[]
+            /** 显示顺序（支持内置字段和自定义字段名） */
+            displayOrders: (
+            | 'cleanMode'
+            | 'suction'
+            | 'cistern'
+            | 'cleanTimes'
+            | string
+            )[]
             /** 图标宽度 */
             iconWidth: number
             /** 图标高度 */
@@ -187,6 +175,8 @@ export declare type AppConfig = {
                 /** 右侧间隔 */
                 gapRight: number
             }
+            /** 自定义属性资源配置 */
+            customAssets?: Record<string, string[]>
         }
         /** 选择指示器配置 */
         selectionIndicator: {
@@ -449,51 +439,6 @@ declare class AppContainer extends Container {
     getLayerVisibility(name: LayerName): boolean;
 }
 
-/**
- * 应用上下文管理 - 基于 React Context 思想
- * 通过组件树的层级关系来传播上下文，每个组件都能自动获取到最近的 Provider 提供的值
- */
-export declare class AppContext {
-    private static contextStack;
-    private static instanceMap;
-    private static serviceCache;
-    /**
-     * 类似 React.createContext() - 注册实例
-     */
-    static registerInstance(instanceKey: string, app: AppInstance): void;
-    /**
-     * 取消注册实例
-     */
-    static unregisterInstance(instanceKey: string): void;
-    /**
-     * 获取 AppService 实例
-     * @returns AppService 实例
-     */
-    static getService(): AppService;
-    /**
-     * 类似 <Context.Provider value={app}> - 提供上下文
-     */
-    static provide<T>(app: AppInstance, fn: () => T): T;
-    /**
-     * 异步版本的 provide
-     */
-    static provideAsync<T>(app: AppInstance, fn: () => Promise<T>): Promise<T>;
-    /**
-     * 类似 useContext(Context) - 获取当前上下文
-     */
-    static useContext(): AppInstance;
-    /**
-     * 检查是否有活跃的上下文
-     */
-    static hasContext(): boolean;
-    /**
-     * 清空所有上下文（主要用于测试）
-     */
-    static clear(): void;
-}
-
-declare type AppInstance = MapApplication;
-
 /**
  * 应用程序选项配置
  * 包含事件回调、配置和运行时状态
@@ -507,247 +452,6 @@ export declare type AppOptions = {
     runtime: DeepPartialRuntimeConfig
 }
 
-declare class AppService {
-    getApp(): MapApplication;
-    getConfig(): AppConfig;
-    getRoomData(roomId: number): RoomData_2 | undefined;
-    /**
-     * 将米转换为像素（委托给 MapApplication）
-     */
-    metersToPixels(meters: number): number;
-    /**
-     * 将像素转换为米（委托给 MapApplication）
-     */
-    pixelsToMeters(pixels: number): number;
-    get ticker(): Ticker;
-    get mapState(): MapState_2 | null;
-    get gloalConfig(): {
-        containerTop: string;
-        containerLeft: string;
-        containerWidth: string;
-        containerHeight: string;
-        backgroundColor: ColorSource;
-    };
-    get mapConfig(): {
-        autoPaddingPercent: number;
-        adjacencyThreshold: number;
-        obstacleColor: ColorSource;
-        freeColor: ColorSource;
-    };
-    get roomConfig(): {
-        colors: {
-            active: string[];
-            inactive: string[];
-            name: string[];
-            propertyTheme: string[];
-            selectionIndicatorBackground: string[];
-            selectionIndicatorIcon: string[];
-            NO_ROOM_DATA: string;
-            ROOM_GAP: string;
-            OBSTACLE_ROOM: string;
-            UNKNOWN_ROOM: string;
-        };
-        nameLabel: {
-            fontSize: number;
-            fontFamily: string;
-            fontWeight: TextStyleFontWeight;
-        };
-        property: {
-            displayOrders: ("cleanMode" | "suction" | "cistern" | "cleanTimes")[];
-            iconWidth: number;
-            iconHeight: number;
-            foldable: boolean;
-            offsetX: number;
-            offsetY: number;
-            iconGap: number;
-            container: {
-                backgroundColor: ColorSource;
-                paddingVertical: number;
-                paddingHorizontal: number;
-                borderRadius: number;
-                tailHeight: number;
-                tailWidth: number;
-            };
-            suction: {
-                assets: string[];
-            };
-            cistern: {
-                assets: string[];
-            };
-            cleanMode: {
-                assets: string[];
-            };
-            cleanTimes: {
-                assets: string[];
-            };
-            cleanOrder: {
-                color: ColorSource;
-                fontFamily: string;
-                fontWeight: TextStyleFontWeight;
-                fontSize: number;
-                gapRight: number;
-            };
-        };
-        selectionIndicator: {
-            iconSrc: string;
-            iconWidth: number;
-            iconHeight: number;
-            containerWidth: number;
-            containerHeight: number;
-            strokeWidth: number;
-            strokeColor: ColorSource;
-            borderRadius: number;
-            offsetX: number;
-            offsetY: number;
-            tailHeight: number;
-            tailWidth: number;
-        };
-        floorType: {
-            assets: string[];
-            opacity: number;
-            scale: number;
-        };
-    };
-    get heatMapConfig(): {
-        cellSize: number;
-        maxDistance: number;
-        smoothIterations: number;
-        heatmapAlpha: number;
-        colorGradients: [ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource];
-    };
-    get pathConfig(): {
-        lineWidthFixed: boolean;
-        incrementalThreshold: number;
-        commonPath: {
-            visible: boolean;
-            color: ColorSource;
-            width: number;
-        };
-        transitionPath: {
-            visible: boolean;
-            color: ColorSource;
-            width: number;
-        };
-        chargePath: {
-            visible: boolean;
-            color: ColorSource;
-            width: number;
-        };
-    };
-    get carpetConfig(): {
-        src: string;
-        opacity: number;
-        scale: number;
-    };
-    get robotConfig(): {
-        icon: {
-            sizeFixed: boolean;
-            width: number;
-            height: number;
-            src: string;
-        };
-        speed: number;
-        rotationCorrection: number;
-        sleepAnimation: {
-            jsonSrc: string;
-            framePrefix: string;
-            width: number;
-            height: number;
-            sizeFixed: boolean;
-            frameCount: number;
-            offsetX: number;
-            offsetY: number;
-        };
-    } & RingConfig_2;
-    get chargingStationConfig(): {
-        icon: {
-            sizeFixed: boolean;
-            width: number;
-            height: number;
-            src: string;
-        };
-        rotationCorrection: number;
-    } & RingConfig_2;
-    get interactionConfig(): {
-        zoomRange: {
-            min: number;
-            max: number;
-        };
-        fitMinScale: number;
-        fitMaxScale: number;
-        enableDoubleTapZoom: boolean;
-    };
-    get controlsConfig(): ControlsConfig_2;
-    get dividerConfig(): DividerConfig_2;
-    get detectedObjectConfig(): {
-        height: number;
-        width: number;
-        interactive: boolean;
-    };
-    get snapshotConfig(): {
-        format: "png" | "jpg" | "webp";
-        quality: number;
-        antialias: boolean;
-        resolution: number;
-    };
-    get appContainer(): AppContainer_2;
-    get interaction(): Interaction_2;
-    get viewportContainer(): ViewportContainer_2;
-    get mapManager(): MapManager_2;
-    get pathManager(): PathManager_2;
-    get heatmapManager(): HeatmapManager_2;
-    get controlsManager(): ControlsManager_2;
-    get detectedObjectManager(): DetectedObjectManager_2;
-    get customElementsManager(): CustomElementsManager_2;
-    get roomsManager(): RoomManager_2;
-    get runtime(): RuntimeConfig_2;
-    get runtimeSnapshot(): {
-        readonly dividingRoomId: number | null | undefined;
-        readonly enableRoomSelection: boolean;
-        readonly editingForbiddenSweepZoneIds: readonly string[];
-        readonly editingForbiddenMopZoneIds: readonly string[];
-        readonly editingCleanZoneIds: readonly string[];
-        readonly editingVirtualWallIds: readonly string[];
-        readonly editingSpotIds: readonly string[];
-        readonly roomPropertyFoldIds: readonly number[];
-        readonly roomSelectionMode: "checkmark" | "order";
-        readonly showRoomName: boolean;
-        readonly showRoomProperty: boolean;
-        readonly showRoomOrder: boolean;
-        readonly showPath: boolean;
-        readonly showChargingStation: boolean;
-        readonly showRoomFloorType: boolean;
-        readonly showCarpet: boolean;
-        readonly selectRoomIds: readonly number[];
-        readonly showChargingStationRing: boolean;
-        readonly showRobotRing: boolean;
-        readonly showRobotSleepAnimation: boolean;
-    };
-    get events(): MapCallbacks_2 | undefined;
-    get baseScale(): number;
-    get currentScale(): number;
-    get emitter(): Emitter<    {
-    antiScale: number;
-    gestureHijackStart: FederatedPointerEvent;
-    gestureHijackPointerMove: FederatedPointerEvent;
-    gestureHijackPointerUp: FederatedPointerEvent;
-    gestureHijackCancel: void;
-    robotPositionUpdate: {
-    x: number;
-    y: number;
-    pathType?: string;
-    };
-    robotAnimationComplete: void;
-    pathSegmentComplete: {
-    fromX: number;
-    fromY: number;
-    toX: number;
-    toY: number;
-    pathType?: string;
-    };
-    }>;
-}
-
 /**
  * 基础自定义元素参数（所有类型共享）
  */
@@ -1966,7 +1670,7 @@ export declare interface MapApi {
  * 地图应用的核心类，继承自 PIXI.Application，提供完整的地图渲染、交互和管理功能。
  * 支持扫地机器人地图的显示、路径绘制、房间管理、控制元素（禁区、虚拟墙等）等功能。
  */
-export declare class MapApplication extends Application implements MapApi {
+declare class MapApplication extends Application implements MapApi {
     /** 地图状态对象 */
     mapState: MapState | null;
     /* Excluded from this release type: components */
@@ -3508,11 +3212,6 @@ export declare type SpotParam = {
     point: Point
 }
 
-/**
- * 获取 AppService 实例
- */
-export declare function useAppService(): AppService;
-
 declare class ViewportContainer extends Container {
     private viewportBounds;
     private maskGraphics;

package/dist/index.js

@@ -1 +1 @@
-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};
+import{decodeRoomProperties as o,offsetPointsToAvoidOverlap as t}from"./utils/index.js";import{MAP_API_METHODS as m,MAP_CALLBACK_METHODS as r}from"./constant/methods.js";export{m as MAP_API_METHODS,r as MAP_CALLBACK_METHODS,o as decodeRoomProperties,t as offsetPointsToAvoidOverlap};