@nywqs/scada-engine 1.1.27 → 1.1.29

package/dist/src/types/dataAdapter.d.ts

@@ -0,0 +1,184 @@
+/**
+ * 组件数据适配器类型定义
+ * 负责将原始数据转换为组件需要的格式
+ */
+/**
+ * 数据提取器函数类型
+ * 用于从原始数据中提取需要的值
+ */
+export type DataExtractor = (rawData: any) => any;
+/**
+ * 数据转换器函数类型
+ * 用于将提取的数据转换为组件需要的格式
+ */
+export type DataTransformer = (value: any, componentConfig?: any) => any;
+/**
+ * 数据验证器函数类型
+ * 用于验证数据格式是否符合组件要求
+ */
+export type DataValidator = (value: any) => boolean;
+/**
+ * 组件数据适配器配置
+ */
+export interface ComponentDataAdapter {
+    /**
+     * 数据转换函数（必需）
+     * 将提取的数据转换为组件需要的格式
+     *
+     * @param value - 从原始数据中提取的值
+     * @param componentConfig - 组件的配置（可选）
+     * @returns 组件需要的数据格式
+     *
+     * @example
+     * // 数值转仪表盘格式
+     * transform: (value, config) => ({
+     *   value: Number(value),
+     *   min: config.min || 0,
+     *   max: config.max || 100
+     * })
+     */
+    transform: DataTransformer;
+    /**
+     * 数据验证函数（可选）
+     * 验证数据是否符合要求
+     *
+     * @param value - 需要验证的值
+     * @returns 验证是否通过
+     *
+     * @example
+     * validate: (value) => typeof value === 'number'
+     */
+    validate?: DataValidator;
+    /**
+     * 默认值（可选）
+     * 当数据为空或验证失败时使用
+     */
+    defaultValue?: any;
+    /**
+     * 错误处理函数（可选）
+     * 当转换失败时调用
+     */
+    onError?: (error: Error, value: any) => any;
+}
+/**
+ * 数据绑定配置（增强版）
+ */
+export interface DataBindingConfig {
+    /**
+     * 数据源 ID
+     */
+    dataSourceId: string;
+    /**
+     * 目标属性（组件的哪个属性）
+     */
+    targetProperty: string;
+    /**
+     * 数据路径（JSONPath 或点分隔路径）
+     * 用于从原始数据中提取值
+     *
+     * @example
+     * 'temperature'
+     * 'sensors[0].data.temp'
+     * 'payload.devices.find(d => d.id === "001").value'
+     */
+    dataPath?: string;
+    /**
+     * 自定义数据提取器
+     * 当 dataPath 不够灵活时使用
+     */
+    extractor?: DataExtractor;
+    /**
+     * 映射配置（保留向后兼容）
+     */
+    mapping?: MappingConfig;
+    /**
+     * 是否启用
+     */
+    enabled?: boolean;
+}
+/**
+ * 映射配置（保留向后兼容）
+ */
+export interface MappingConfig {
+    type: 'direct' | 'boolean' | 'range' | 'enum' | 'custom';
+    trueValue?: any;
+    falseValue?: any;
+    rangeRules?: Array<{
+        min: number;
+        max: number;
+        value: any;
+    }>;
+    enumMappings?: Record<string, any>;
+    customFunction?: string;
+}
+/**
+ * 数据适配器工具类
+ */
+export declare class DataAdapterUtils {
+    /**
+     * 从原始数据中提取值（使用数据路径）
+     *
+     * @param rawData - 原始数据
+     * @param dataPath - 数据路径（点分隔或数组索引）
+     * @returns 提取的值
+     *
+     * @example
+     * extractByPath({ a: { b: { c: 1 } } }, 'a.b.c') // 返回 1
+     * extractByPath({ arr: [1, 2, 3] }, 'arr[1]') // 返回 2
+     */
+    static extractByPath(rawData: any, dataPath: string): any;
+    /**
+     * 使用提取器从原始数据中提取值
+     *
+     * @param rawData - 原始数据
+     * @param extractor - 提取器函数
+     * @returns 提取的值
+     */
+    static extractByFunction(rawData: any, extractor: DataExtractor): any;
+    /**
+     * 应用数据适配器
+     *
+     * @param value - 提取的值
+     * @param adapter - 数据适配器
+     * @param componentConfig - 组件配置
+     * @returns 转换后的值
+     */
+    static applyAdapter(value: any, adapter: ComponentDataAdapter | undefined, componentConfig?: any): any;
+    /**
+     * 应用旧版映射配置（向后兼容）
+     */
+    static applyMapping(value: any, mapping: MappingConfig | undefined): any;
+}
+/**
+ * 预设的数据适配器
+ */
+export declare const PresetDataAdapters: {
+    /**
+     * 直传适配器（不做任何转换）
+     */
+    passthrough: ComponentDataAdapter;
+    /**
+     * 数值适配器（转换为数字）
+     */
+    number: ComponentDataAdapter;
+    /**
+     * 字符串适配器
+     */
+    string: ComponentDataAdapter;
+    /**
+     * 布尔适配器
+     */
+    boolean: ComponentDataAdapter;
+    /**
+     * 百分比适配器（0-1 转换为 0-100）
+     */
+    percentage: ComponentDataAdapter;
+    /**
+     * 仪表盘适配器
+     */
+    gauge: ComponentDataAdapter;
+    /**
+     * 颜色映射适配器
+     */
+    colorMap: ComponentDataAdapter;
+};

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

@@ -1,4 +1,5 @@
 import { Graph } from '@antv/x6';
+import { BindingConfig } from '../types/binding';
 
 /**
  * 数据绑定服务类
@@ -6,6 +7,9 @@ import { Graph } from '@antv/x6';
 export declare class DataBindingService {
     private graph;
     private dataCallbackRegistered;
+    private updateQueue;
+    private flushTimer;
+    private readonly FLUSH_DELAY;
     /**
      * 设置 Graph 实例
      */
@@ -13,30 +17,70 @@ export declare class DataBindingService {
     /**
      * 初始化数据绑定监听
      */
-    initDataBinding(): void;
+    private initDataBinding;
     /**
-     * 同步数据到节点
+     * 处理数据源更新
      */
-    private syncDataToNodes;
+    private handleDataUpdate;
     /**
-     * 根据设备数据更新节点
+     * 更新单个节点的数据
      */
-    private updateNodeFromDeviceData;
+    private updateNodeData;
     /**
-     * 应用映射规则
+     * 将更新添加到队列
      */
-    private applyMapping;
+    private queueUpdates;
     /**
-     * 手动更新设备数据（用于外部传入的设备数据）
+     * 调度批量刷新
      */
-    updateDeviceData(deviceData: any): void;
+    private scheduleFlush;
+    /**
+     * 执行批量更新
+     */
+    private flush;
+    /**
+     * 从原始数据中提取点位值
+     *
+     * @param rawData 原始数据（后端返回的JSON）
+     * @param pointId 点位ID（如 "liquid_level"）
+     * @returns 点位值
+     */
+    private extractPointValue;
+    /**
+     * 应用值映射转换
+     *
+     * @param value 原始值
+     * @param mapping 映射配置
+     * @returns 转换后的值
+     */
+    private applyValueMapping;
+    /**
+     * 布尔映射
+     */
+    private applyBooleanMapping;
+    /**
+     * 范围映射
+     */
+    private applyRangeMapping;
+    /**
+     * 枚举映射
+     */
+    private applyEnumMapping;
+    /**
+     * 应用更新到节点
+     */
+    private applyUpdatesToNode;
     /**
      * 获取节点的绑定配置
      */
-    getNodeBindings(nodeId: string): any[];
+    getNodeBindings(nodeId: string): BindingConfig[];
     /**
      * 更新节点的绑定配置
      */
-    updateNodeBindings(nodeId: string, bindings: any[]): boolean;
+    updateNodeBindings(nodeId: string, bindings: BindingConfig[]): boolean;
+    /**
+     * 清理资源
+     */
+    destroy(): void;
 }
 export declare const dataBindingService: DataBindingService;

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/components/WorkflowToolbar.d.ts

@@ -8,9 +8,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     close: () => void;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>> & Readonly<{
     onSave?: (() => any) | undefined;
+    onValidate?: (() => any) | undefined;
     onClear?: (() => any) | undefined;
     onClose?: (() => any) | undefined;
-    onValidate?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;
 type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;

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.27",
+  "version": "1.1.29",
   "description": "自研 SCADA 组态引擎 - 基于 AntV X6",
   "type": "module",
   "main": "./dist/scada-engine.umd.js",