@nywqs/scada-engine 1.1.28 → 1.1.29

package/dist/src/scada-components/registry.d.ts

@@ -1,35 +1,79 @@
 import { ComponentRegistry, ComponentConfig, ComponentCategory } from './types';
 
+type ComponentLoader = () => Promise<{
+    default: ComponentConfig;
+}>;
 /**
  * 组件注册表
  */
 declare class ComponentRegistryManager {
     private registry;
+    private lazyRegistry;
+    private loadingPromises;
     constructor();
     /**
-     * 注册默认组件
+     * 注册默认组件(立即加载)
      */
     private registerDefaultComponents;
+    /**
+     * 注册懒加载组件（零配置 - 基于约定自动发现）
+     * 约定：所有 ./iot/industrial-*.ts 文件自动注册为懒加载组件
+     * 策略：延迟加载 - 首次请求组件时才加载整个模块，并注册模块内的所有组件
+     */
+    private registerLazyComponents;
+    /**
+     * 注册 Vue Shape 到 X6
+     */
+    private registerVueShape;
     /**
      * 注册组件
      */
     register(config: ComponentConfig): void;
+    /**
+     * 注册懒加载组件
+     */
+    registerLazy(id: string, loader: ComponentLoader): void;
     /**
      * 批量注册组件
      */
     registerBatch(configs: ComponentConfig[]): void;
     /**
-     * 获取组件配置
+     * 获取组件配置(支持懒加载)
+     */
+    getComponent(id: string): Promise<ComponentConfig | undefined>;
+    /**
+     * 同步获取组件(仅已加载的)
+     */
+    getComponentSync(id: string): ComponentConfig | undefined;
+    /**
+     * 加载懒加载组件
+     */
+    private loadComponent;
+    /**
+     * 预加载组件
+     */
+    preloadComponent(id: string): Promise<boolean>;
+    /**
+     * 批量预加载组件
      */
-    getComponent(id: string): ComponentConfig | undefined;
+    preloadComponents(ids: string[]): Promise<void>;
+    /**
+     * 预加载所有组件
+     * 包括模块级别的懒加载（以 __module__ 开头）
+     */
+    preloadAllComponents(): Promise<void>;
     /**
      * 通过shape获取组件配置
      */
     getComponentByShape(shape: string): ComponentConfig | undefined;
     /**
-     * 获取所有组件
+     * 获取所有组件(仅已加载)
      */
     getAllComponents(): ComponentRegistry;
+    /**
+     * 获取所有组件ID(包括未加载)
+     */
+    getAllComponentIds(): string[];
     /**
      * 按分类获取组件
      */
@@ -50,6 +94,19 @@ declare class ComponentRegistryManager {
      * 获取组件数量
      */
     getCount(): number;
+    /**
+     * 获取已加载组件数量
+     */
+    getLoadedCount(): number;
+    /**
+     * 获取懒加载统计
+     */
+    getLazyLoadStats(): {
+        total: number;
+        loaded: number;
+        pending: number;
+        loadRate: string;
+    };
     /**
      * 清空注册表
      */

package/dist/src/utils/animationScheduler.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 统一动画调度器
+ * 解决多个组件独立使用 requestAnimationFrame 导致的性能问题
+ *
+ * 优势:
+ * 1. 统一时间步进,避免动画不同步
+ * 2. 减少 RAF 调用次数,降低浏览器开销
+ * 3. 集中管理所有动画,便于调试和性能监控
+ * 4. 支持动画暂停/恢复/销毁
+ */
+export interface AnimationTask {
+    id: string;
+    callback: (deltaTime: number, currentTime: number) => void;
+    enabled: boolean;
+    lastTime: number;
+}
+declare class AnimationScheduler {
+    private tasks;
+    private rafId;
+    private isRunning;
+    private lastFrameTime;
+    private frameCount;
+    private fpsUpdateTime;
+    private currentFps;
+    /**
+     * 注册动画任务
+     * @param id 唯一标识符(通常使用组件 nodeId)
+     * @param callback 动画回调函数 (deltaTime: 距上次调用的毫秒数, currentTime: 当前时间戳)
+     */
+    register(id: string, callback: (deltaTime: number, currentTime: number) => void): void;
+    /**
+     * 注销动画任务
+     * @param id 任务标识符
+     */
+    unregister(id: string): void;
+    /**
+     * 启用/禁用特定任务
+     * @param id 任务标识符
+     * @param enabled 是否启用
+     */
+    setEnabled(id: string, enabled: boolean): void;
+    /**
+     * 启动调度器
+     */
+    private start;
+    /**
+     * 停止调度器
+     */
+    private stop;
+    /**
+     * 动画帧循环
+     */
+    private tick;
+    /**
+     * 获取当前 FPS
+     */
+    getFps(): number;
+    /**
+     * 获取活跃任务数量
+     */
+    getActiveTaskCount(): number;
+    /**
+     * 暂停所有动画
+     */
+    pauseAll(): void;
+    /**
+     * 恢复所有动画
+     */
+    resumeAll(): void;
+    /**
+     * 清除所有任务并停止调度器
+     */
+    destroy(): void;
+    /**
+     * 获取调度器状态(用于调试)
+     */
+    getStatus(): {
+        isRunning: boolean;
+        taskCount: number;
+        activeTaskCount: number;
+        fps: number;
+    };
+}
+export declare const animationScheduler: AnimationScheduler;
+export {};

package/dist/src/utils/canvasLayerManager.d.ts

@@ -0,0 +1,88 @@
+import { Graph } from '@antv/x6';
+
+export declare enum CanvasLayer {
+    BACKGROUND = "background",
+    STATIC = "static",
+    ANIMATION = "animation",
+    INTERACTION = "interaction",
+    HIGHLIGHT = "highlight"
+}
+export declare class CanvasLayerManager {
+    private graph;
+    private layers;
+    private layerConfig;
+    private containerElement;
+    private dirtyLayers;
+    private renderScheduled;
+    private staticNodes;
+    private animationNodes;
+    /**
+     * 初始化分层系统
+     */
+    init(graph: Graph, container: HTMLElement): void;
+    /**
+     * 创建图层 Canvas
+     */
+    private createLayer;
+    /**
+     * 附加事件监听器
+     */
+    private attachEventListeners;
+    /**
+     * 标记图层为脏(需要重绘)
+     */
+    markDirty(layer: CanvasLayer): void;
+    /**
+     * 调度渲染
+     */
+    private scheduleRender;
+    /**
+     * 渲染所有脏图层
+     */
+    private render;
+    /**
+     * 渲染单个图层
+     */
+    private renderLayer;
+    /**
+     * 渲染背景层
+     */
+    private renderBackground;
+    /**
+     * 渲染静态层
+     */
+    private renderStatic;
+    /**
+     * 渲染动画层
+     */
+    private renderAnimation;
+    /**
+     * 渲染交互层
+     */
+    private renderInteraction;
+    /**
+     * 渲染高亮层
+     */
+    private renderHighlight;
+    /**
+     * 标记节点为动画节点
+     */
+    markAsAnimation(nodeId: string): void;
+    /**
+     * 标记节点为静态节点
+     */
+    markAsStatic(nodeId: string): void;
+    /**
+     * 获取性能统计
+     */
+    getStats(): {
+        staticNodes: number;
+        animationNodes: number;
+        dirtyLayers: number;
+    };
+    /**
+     * 销毁分层系统
+     */
+    destroy(): void;
+}
+export declare const canvasLayerManager: CanvasLayerManager;

package/dist/src/utils/dataBindingService.d.ts

@@ -7,6 +7,9 @@ import { BindingConfig } from '../types/binding';
 export declare class DataBindingService {
     private graph;
     private dataCallbackRegistered;
+    private updateQueue;
+    private flushTimer;
+    private readonly FLUSH_DELAY;
     /**
      * 设置 Graph 实例
      */
@@ -23,6 +26,18 @@ export declare class DataBindingService {
      * 更新单个节点的数据
      */
     private updateNodeData;
+    /**
+     * 将更新添加到队列
+     */
+    private queueUpdates;
+    /**
+     * 调度批量刷新
+     */
+    private scheduleFlush;
+    /**
+     * 执行批量更新
+     */
+    private flush;
     /**
      * 从原始数据中提取点位值
      *

package/dist/src/utils/index.d.ts

@@ -16,3 +16,7 @@ export * from './dataBindingService';
 export * from './eventManager';
 export * from './contextMenuManager';
 export * from './canvasConfigWatcher';
+export * from './animationScheduler';
+export * from './viewportCulling';
+export * from './workerManager';
+export * from './canvasLayerManager';

package/dist/src/utils/nodeOperations.d.ts

@@ -20,7 +20,7 @@ export declare class NodeOperations {
     addNode(type: string, position?: {
         x: number;
         y: number;
-    }): Node | null;
+    }): Promise<Node | null>;
     /**
      * 更新节点属性
      */

package/dist/src/utils/viewportCulling.d.ts

@@ -0,0 +1,63 @@
+import { Graph } from '@antv/x6';
+
+interface ViewportConfig {
+    enabled: boolean;
+    padding: number;
+    updateThrottle: number;
+}
+declare class ViewportCullingService {
+    private graph;
+    private config;
+    private updateTimer;
+    private isUpdating;
+    private nodeVisibilityCache;
+    private stats;
+    /**
+     * 初始化服务
+     */
+    init(graph: Graph, config?: Partial<ViewportConfig>): void;
+    /**
+     * 调度更新(节流)
+     */
+    private scheduleUpdate;
+    /**
+     * 更新节点可见性
+     */
+    private updateVisibility;
+    /**
+     * 获取视口矩形区域
+     */
+    private getViewportRect;
+    /**
+     * 判断节点是否在视口内
+     */
+    private isNodeInViewport;
+    /**
+     * 强制更新所有节点可见性
+     */
+    forceUpdate(): void;
+    /**
+     * 启用/禁用视口裁剪
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * 显示所有节点
+     */
+    private showAllNodes;
+    /**
+     * 获取性能统计
+     */
+    getStats(): {
+        totalNodes: number;
+        visibleNodes: number;
+        culledNodes: number;
+        cullRate: string;
+        lastUpdateTime: number;
+    };
+    /**
+     * 销毁服务
+     */
+    destroy(): void;
+}
+export declare const viewportCulling: ViewportCullingService;
+export {};

package/dist/src/utils/workerManager.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Worker 管理器
+ * 管理 WebWorker 生命周期和消息通信
+ */
+export declare class WorkerManager {
+    private worker;
+    private pendingTasks;
+    private messageIdCounter;
+    private readonly TASK_TIMEOUT;
+    /**
+     * 初始化 Worker
+     */
+    init(): void;
+    /**
+     * 处理 Worker 消息
+     */
+    private handleMessage;
+    /**
+     * 处理 Worker 错误
+     */
+    private handleError;
+    /**
+     * 发送消息到 Worker
+     */
+    private sendMessage;
+    /**
+     * 主线程回退处理
+     */
+    private fallbackProcess;
+    /**
+     * 解析设备数据
+     */
+    parseDeviceData(rawData: any): Promise<any>;
+    /**
+     * 转换绑定数据
+     */
+    transformBindingData(bindings: any[], deviceData: any): Promise<any[]>;
+    /**
+     * 批量计算
+     */
+    batchCalculate(calculations: Array<{
+        type: string;
+        params: any;
+    }>): Promise<any[]>;
+    /**
+     * 获取 Worker 状态
+     */
+    getStatus(): {
+        isActive: boolean;
+        pendingTasks: number;
+    };
+    /**
+     * 终止 Worker
+     */
+    terminate(): void;
+}
+export declare const workerManager: WorkerManager;

package/dist/src/views/workflow/components/ElementSelector.d.ts

@@ -1,13 +1,5 @@
-export interface ElementInfo {
-    id: string;
-    name: string;
-    type: string;
-    icon: string;
-    properties: Array<{
-        key: string;
-        label: string;
-    }>;
-}
+import { ElementInfo } from '../types/element';
+
 interface Props {
     visible: boolean;
     elements?: ElementInfo[];

package/dist/src/views/workflow/services/canvasElementService.d.ts

@@ -1,5 +1,5 @@
 import { Graph } from '@antv/x6';
-import { ElementInfo } from '../components/ElementSelector';
+import { ElementInfo } from '../types/element';
 
 /**
  * 画布图元服务类
@@ -13,7 +13,7 @@ declare class CanvasElementService {
     /**
      * 获取画布所有图元
      */
-    getElements(): ElementInfo[];
+    getElements(): Promise<ElementInfo[]>;
     /**
      * 获取图元的可配置属性列表（仅返回组件 props 中定义的属性）
      */
@@ -21,11 +21,11 @@ declare class CanvasElementService {
     /**
      * 根据ID获取图元
      */
-    getElementById(id: string): ElementInfo | null;
+    getElementById(id: string): Promise<ElementInfo | null>;
     /**
      * 搜索图元
      */
-    searchElements(keyword: string): ElementInfo[];
+    searchElements(keyword: string): Promise<ElementInfo[]>;
 }
 export declare const canvasElementService: CanvasElementService;
 export {};

package/dist/src/views/workflow/types/element.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 画布图元类型定义
+ */
+/**
+ * 图元信息
+ */
+export interface ElementInfo {
+    id: string;
+    name: string;
+    type: string;
+    icon: string;
+    properties: Array<{
+        key: string;
+        label: string;
+    }>;
+}

package/dist/src/workers/dataProcessor.worker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 数据处理 Worker
+ * 在后台线程处理复杂数据转换,避免阻塞主线程
+ */
+export declare enum WorkerMessageType {
+    PARSE_DEVICE_DATA = "PARSE_DEVICE_DATA",
+    TRANSFORM_BINDING_DATA = "TRANSFORM_BINDING_DATA",
+    BATCH_CALCULATE = "BATCH_CALCULATE",
+    ERROR = "ERROR"
+}
+export interface WorkerMessage {
+    id: string;
+    type: WorkerMessageType;
+    payload: any;
+}
+export interface WorkerResponse {
+    id: string;
+    type: WorkerMessageType;
+    result?: any;
+    error?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nywqs/scada-engine",
-  "version": "1.1.28",
+  "version": "1.1.29",
   "description": "自研 SCADA 组态引擎 - 基于 AntV X6",
   "type": "module",
   "main": "./dist/scada-engine.umd.js",