scada-engine 1.0.0

package/dist/src/shared/types/workflow.d.ts

@@ -0,0 +1,195 @@
+/**
+ * 流程编排相关类型定义
+ */
+/**
+ * 流程节点类型
+ */
+export declare enum WorkflowNodeType {
+    START = "start",// 开始节点
+    END = "end",// 结束节点
+    CONDITION = "condition",// 条件判断
+    ACTION = "action",// 执行动作
+    DELAY = "delay",// 延时节点
+    LOOP = "loop",// 循环节点
+    PARALLEL = "parallel",// 并行节点
+    MERGE = "merge"
+}
+/**
+ * 条件运算符
+ */
+export declare enum ConditionOperator {
+    EQUAL = "==",// 等于
+    NOT_EQUAL = "!=",// 不等于
+    GREATER = ">",// 大于
+    GREATER_EQUAL = ">=",// 大于等于
+    LESS = "<",// 小于
+    LESS_EQUAL = "<=",// 小于等于
+    CONTAINS = "contains",// 包含
+    NOT_CONTAINS = "not_contains"
+}
+/**
+ * 动作类型
+ */
+export declare enum ActionType {
+    SET_POINT = "setPoint",// 设置点位值
+    TRIGGER_EVENT = "triggerEvent",// 触发事件
+    SEND_ALARM = "sendAlarm",// 发送告警
+    CALL_API = "callApi",// 调用API
+    EXECUTE_SCRIPT = "executeScript"
+}
+/**
+ * 条件配置
+ */
+export interface ConditionConfig {
+    /** 左操作数（设备点位ID或变量） */
+    leftOperand: string;
+    /** 运算符 */
+    operator: ConditionOperator;
+    /** 右操作数（值或设备点位ID） */
+    rightOperand: string | number | boolean;
+    /** 逻辑关系（用于多条件组合） */
+    logic?: 'AND' | 'OR';
+}
+/**
+ * 动作配置
+ */
+export interface ActionConfig {
+    /** 动作类型 */
+    type: ActionType;
+    /** 目标设备点位ID */
+    targetPointId?: string;
+    /** 设置的值 */
+    value?: any;
+    /** API地址 */
+    apiUrl?: string;
+    /** 请求方法 */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** 请求参数 */
+    params?: Record<string, any>;
+    /** 脚本代码 */
+    script?: string;
+    /** 告警内容 */
+    alarmMessage?: string;
+    /** 告警级别 */
+    alarmLevel?: 'info' | 'warning' | 'error' | 'critical';
+}
+/**
+ * 流程节点
+ */
+export interface WorkflowNode {
+    /** 节点ID */
+    id: string;
+    /** 节点类型 */
+    type: WorkflowNodeType;
+    /** 节点名称 */
+    name: string;
+    /** 节点描述 */
+    description?: string;
+    /** 节点位置 */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** 条件配置（条件节点） */
+    conditions?: ConditionConfig[];
+    /** 动作配置（动作节点） */
+    actions?: ActionConfig[];
+    /** 延时时间（延时节点，单位：毫秒） */
+    delay?: number;
+    /** 循环次数（循环节点） */
+    loopCount?: number;
+    /** 循环条件（循环节点） */
+    loopCondition?: ConditionConfig;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 自定义数据 */
+    data?: Record<string, any>;
+}
+/**
+ * 流程连线
+ */
+export interface WorkflowEdge {
+    /** 连线ID */
+    id: string;
+    /** 源节点ID */
+    source: string;
+    /** 目标节点ID */
+    target: string;
+    /** 源节点输出端口 */
+    sourceHandle?: string;
+    /** 目标节点输入端口 */
+    targetHandle?: string;
+    /** 连线标签（如：true/false分支） */
+    label?: string;
+    /** 连线类型 */
+    type?: 'default' | 'success' | 'fail' | 'always';
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/**
+ * 流程配置
+ */
+export interface WorkflowConfig {
+    /** 流程ID */
+    id: string;
+    /** 流程名称 */
+    name: string;
+    /** 流程描述 */
+    description?: string;
+    /** 流程节点列表 */
+    nodes: WorkflowNode[];
+    /** 流程连线列表 */
+    edges: WorkflowEdge[];
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 触发方式 */
+    trigger?: {
+        /** 触发类型（manual手动、schedule定时、event事件） */
+        type: 'manual' | 'schedule' | 'event';
+        /** 定时表达式（cron） */
+        cron?: string;
+        /** 事件源（设备点位ID） */
+        eventSource?: string;
+        /** 事件条件 */
+        eventCondition?: ConditionConfig;
+    };
+    /** 创建时间 */
+    createTime?: string;
+    /** 更新时间 */
+    updateTime?: string;
+    /** 创建者 */
+    creator?: string;
+}
+/**
+ * 流程执行记录
+ */
+export interface WorkflowExecutionLog {
+    /** 执行ID */
+    id: string;
+    /** 流程ID */
+    workflowId: string;
+    /** 流程名称 */
+    workflowName: string;
+    /** 开始时间 */
+    startTime: string;
+    /** 结束时间 */
+    endTime?: string;
+    /** 执行状态 */
+    status: 'running' | 'success' | 'failed' | 'cancelled';
+    /** 当前执行节点ID */
+    currentNodeId?: string;
+    /** 执行结果 */
+    result?: any;
+    /** 错误信息 */
+    error?: string;
+    /** 节点执行详情 */
+    nodeExecutions?: {
+        nodeId: string;
+        nodeName: string;
+        startTime: string;
+        endTime?: string;
+        status: 'success' | 'failed' | 'skipped';
+        result?: any;
+        error?: string;
+    }[];
+}

package/dist/src/shared/utils/commonUtils.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 通用工具函数
+ * 包含ID生成、消息提示等常用功能
+ */
+/**
+ * 生成唯一ID
+ * @param prefix 前缀，默认为空
+ * @returns 唯一ID字符串
+ */
+export declare const generateUniqueId: (prefix?: string) => string;
+/**
+ * 生成事件ID
+ * @returns 事件ID
+ */
+export declare const generateEventId: () => string;
+/**
+ * 生成节点ID
+ * @returns 节点ID
+ */
+export declare const generateNodeId: () => string;
+/**
+ * 防抖函数
+ * @param func 要执行的函数
+ * @param wait 等待时间（毫秒）
+ * @returns 防抖后的函数
+ */
+export declare const debounce: <T extends (...args: any[]) => any>(func: T, wait: number) => ((...args: Parameters<T>) => void);
+/**
+ * 节流函数
+ * @param func 要执行的函数
+ * @param limit 时间限制（毫秒）
+ * @returns 节流后的函数
+ */
+export declare const throttle: <T extends (...args: any[]) => any>(func: T, limit: number) => ((...args: Parameters<T>) => void);
+/**
+ * 深拷贝对象
+ * @param obj 要拷贝的对象
+ * @returns 拷贝后的对象
+ */
+export declare const deepClone: <T>(obj: T) => T;
+/**
+ * 格式化时间戳
+ * @param timestamp 时间戳（毫秒）
+ * @param format 格式字符串，默认 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的时间字符串
+ */
+export declare const formatTimestamp: (timestamp: number, format?: string) => string;
+/**
+ * 获取当前时间戳
+ * @returns 当前时间戳（毫秒）
+ */
+export declare const getCurrentTimestamp: () => number;
+/**
+ * 生成随机数
+ * @param min 最小值
+ * @param max 最大值
+ * @returns 随机数
+ */
+export declare const randomNumber: (min: number, max: number) => number;
+/**
+ * 生成随机位置
+ * @param offsetX X偏移量，默认50
+ * @param offsetY Y偏移量，默认50
+ * @param rangeX X范围，默认400
+ * @param rangeY Y范围，默认300
+ * @returns 位置对象 {x, y}
+ */
+export declare const randomPosition: (offsetX?: number, offsetY?: number, rangeX?: number, rangeY?: number) => {
+    x: number;
+    y: number;
+};
+/**
+ * 判断对象是否为空
+ * @param obj 对象
+ * @returns 是否为空
+ */
+export declare const isEmpty: (obj: any) => boolean;
+/**
+ * 延迟执行
+ * @param ms 延迟时间（毫秒）
+ * @returns Promise
+ */
+export declare const sleep: (ms: number) => Promise<void>;

package/dist/src/shared/utils/edgeAnimationUtils.d.ts

@@ -0,0 +1,16 @@
+import { Edge } from '@antv/x6';
+
+/**
+ * 边动画配置接口
+ */
+export interface EdgeAnimationConfig {
+    enabled: boolean;
+    duration?: number;
+    type?: string;
+}
+/**
+ * 应用边动画
+ * @param edge X6 边对象
+ * @param animation 动画配置
+ */
+export declare function applyEdgeAnimation(edge: Edge, animation: EdgeAnimationConfig): void;

package/dist/src/shared/utils/eventUtils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 事件处理工具函数
+ * 用于处理节点事件的条件检查和动作执行
+ */
+/**
+ * 检查事件触发条件
+ * @param node X6 节点
+ * @param event 事件配置
+ * @returns 条件是否满足
+ */
+export declare const checkEventCondition: (node: any, event: any) => boolean;
+/**
+ * 执行属性变更动作
+ * @param node X6 节点
+ * @param params 动作参数
+ */
+export declare const executeAttributeChange: (node: any, params: any) => void;
+/**
+ * 执行自定义代码动作
+ * @param node X6 节点
+ * @param event 事件配置
+ * @param params 动作参数
+ */
+export declare const executeCustomCode: (node: any, event: any, params: any) => void;
+/**
+ * 执行调用流程动作
+ * @param node X6 节点
+ * @param event 事件配置
+ * @param params 动作参数
+ */
+export declare const executeCallProcess: (node: any, _event: any, params: any) => void;
+/**
+ * 执行事件动作
+ * @param node X6 节点
+ * @param event 事件配置
+ */
+export declare const executeEvent: (node: any, event: any) => void;
+/**
+ * 为节点注册事件监听器
+ * @param graph X6 Graph 实例
+ * @param node X6 节点
+ */
+export declare const registerNodeEvents: (graph: any, node: any) => void;

package/dist/src/shared/utils/fileUtils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 文件操作工具函数
+ * 用于文件的导入导出、下载等操作
+ */
+/**
+ * 导出数据为 JSON 文件
+ * @param data 要导出的数据对象
+ * @param filename 文件名（不含扩展名）
+ * @returns 是否导出成功
+ */
+export declare const exportToJSON: (data: any, filename: string) => boolean;
+/**
+ * 从 JSON 文件导入数据
+ * @param file 文件对象
+ * @returns Promise，成功返回数据对象，失败返回 null
+ */
+export declare const importFromJSON: <T = any>(file: File) => Promise<T | null>;
+/**
+ * 下载文本文件
+ * @param content 文本内容
+ * @param filename 文件名
+ * @param mimeType MIME 类型，默认为 text/plain
+ */
+export declare const downloadTextFile: (content: string, filename: string, mimeType?: string) => void;
+/**
+ * 触发文件选择对话框
+ * @param accept 接受的文件类型，如 '.json'
+ * @param multiple 是否允许多选
+ * @returns Promise，返回选中的文件列表
+ */
+export declare const selectFiles: (accept?: string, multiple?: boolean) => Promise<FileList | null>;
+/**
+ * 读取文件内容为文本
+ * @param file 文件对象
+ * @returns Promise，返回文件文本内容
+ */
+export declare const readFileAsText: (file: File) => Promise<string | null>;
+/**
+ * 读取文件内容为 Data URL
+ * @param file 文件对象
+ * @returns Promise，返回 Data URL
+ */
+export declare const readFileAsDataURL: (file: File) => Promise<string | null>;

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

@@ -0,0 +1,7 @@
+export * from './commonUtils';
+export * from './fileUtils';
+export * from './messageUtils';
+export * from './storageUtils';
+export * from './nodePropertyUtils';
+export * from './eventUtils';
+export * from './edgeAnimationUtils';

package/dist/src/shared/utils/messageUtils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 消息提示工具函数
+ * 统一管理消息提示、确认对话框等
+ */
+export type MessageType = 'success' | 'error' | 'warning' | 'info';
+/**
+ * 显示提示消息
+ * @param message 消息内容
+ * @param type 消息类型
+ * @param duration 显示时长（毫秒），默认3000
+ */
+export declare const showMessage: (message: string, type?: MessageType, duration?: number) => void;
+/**
+ * 显示成功消息
+ * @param message 消息内容
+ * @param duration 显示时长（毫秒）
+ */
+export declare const showSuccess: (message: string, duration?: number) => void;
+/**
+ * 显示错误消息
+ * @param message 消息内容
+ * @param duration 显示时长（毫秒）
+ */
+export declare const showError: (message: string, duration?: number) => void;
+/**
+ * 显示警告消息
+ * @param message 消息内容
+ * @param duration 显示时长（毫秒）
+ */
+export declare const showWarning: (message: string, duration?: number) => void;
+/**
+ * 显示信息消息
+ * @param message 消息内容
+ * @param duration 显示时长（毫秒）
+ */
+export declare const showInfo: (message: string, duration?: number) => void;
+/**
+ * 显示确认对话框
+ * @param message 提示消息
+ * @param title 对话框标题
+ * @returns Promise<boolean> 用户确认返回true，取消返回false
+ */
+export declare const showConfirm: (message: string, title?: string) => Promise<boolean>;
+/**
+ * 显示输入对话框
+ * @param message 提示消息
+ * @param defaultValue 默认值
+ * @returns Promise<string | null> 用户输入的值，取消返回null
+ */
+export declare const showPrompt: (message: string, defaultValue?: string) => Promise<string | null>;
+/**
+ * 显示加载提示
+ * @param message 加载消息
+ * @returns 返回关闭函数
+ */
+export declare const showLoading: (message?: string) => (() => void);

package/dist/src/shared/utils/nodePropertyUtils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 节点属性操作工具函数
+ * 用于处理节点属性的获取、设置等操作
+ */
+/**
+ * 获取嵌套对象的值
+ * @param obj 对象
+ * @param path 路径，使用.分隔，如 'a.b.c'
+ * @returns 属性值
+ */
+export declare const getNestedValue: (obj: any, path: string) => any;
+/**
+ * 设置嵌套对象的值
+ * @param obj 对象
+ * @param path 路径，使用.分隔，如 'a.b.c'
+ * @param value 要设置的值
+ */
+export declare const setNestedValue: (obj: any, path: string, value: any) => void;
+/**
+ * 根据 props 配置获取节点属性值
+ * @param node X6 节点
+ * @param propertyKey 属性键（在 props 中定义的 key）
+ * @returns 属性值
+ */
+export declare const getNodePropertyValue: (node: any, propertyKey: string) => any;
+/**
+ * 根据 props 配置设置节点属性值
+ * @param node X6 节点
+ * @param propertyKey 属性键（在 props 中定义的 key）
+ * @param value 要设置的值
+ * @returns 是否设置成功
+ */
+export declare const setNodePropertyValue: (node: any, propertyKey: string, value: any) => boolean;

package/dist/src/shared/utils/storageUtils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 存储工具函数
+ * 统一使用 localStorage 进行数据持久化
+ */
+/**
+ * LocalStorage 键名常量
+ */
+export declare const STORAGE_KEYS: {
+    readonly SCADA_EDITOR_DATA: "scada_editor_data";
+};
+/**
+ * 保存数据到 localStorage
+ * @param key 键名
+ * @param data 数据对象
+ * @returns 是否保存成功
+ */
+export declare const saveToLocal: <T = any>(key: string, data: T) => boolean;
+/**
+ * 从 localStorage 读取数据
+ * @param key 键名
+ * @returns 数据对象，失败返回 null
+ */
+export declare const loadFromLocal: <T = any>(key: string) => T | null;
+/**
+ * 从 localStorage 删除数据
+ * @param key 键名
+ */
+export declare const removeFromLocal: (key: string) => void;
+/**
+ * 清空 localStorage
+ */
+export declare const clearLocal: () => void;

package/dist/src/svg/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SVG 核心模块
+ * 包含加载器、解析器和类型定义
+ */
+export * from './types';
+export { SVGParser } from './parser';
+export { svgLoader, SVGLoader } from './loader';

package/dist/src/svg/core/loader.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SVG 组件加载器
+ * 负责加载 SVG 文件并注册到组件注册表
+ */
+/**
+ * SVG 组件加载器类
+ */
+export declare class SVGLoader {
+    /**
+     * 从字符串加载 SVG 组件
+     * @param svgContent SVG 文件内容
+     * @param fileName 文件名（可选）
+     * @returns 是否加载成功
+     */
+    loadFromString(svgContent: string, fileName?: string): boolean;
+    /**
+     * 从文件加载 SVG 组件
+     * @param file File 对象
+     * @returns Promise<boolean>
+     */
+    loadFromFile(file: File): Promise<boolean>;
+    /**
+     * 批量加载 SVG 组件
+     * @param files File 对象数组
+     * @returns Promise<加载成功的数量>
+     */
+    loadBatch(files: File[]): Promise<number>;
+    /**
+     * 从 URL 加载 SVG 组件
+     * @param url SVG 文件 URL
+     * @returns Promise<boolean>
+     */
+    loadFromUrl(url: string): Promise<boolean>;
+    /**
+     * 转换 SVGComponentConfig 为 ComponentConfig
+     */
+    private convertToComponentConfig;
+    /**
+     * 从 presetBindings 生成 InternalAnimations
+     */
+    private generateInternalAnimations;
+    /**
+     * 生成默认的驱动字段值
+     */
+    private generateDefaultDriverValues;
+    /**
+     * 生成接线柱配置
+     * 接线柱向组件内侧偏移（dx/dy）使圆心落在组件边界上，避免显示在组件外
+     */
+    private generatePorts;
+    /**
+     * 生成组件属性配置
+     * 多个 presetBinding 共享同一 driverProperty 时只生成一个 prop（去重）
+     */
+    private generateProps;
+    /**
+     * 根据数值范围推断合理的 step
+     */
+    private inferStep;
+    /**
+     * 根据 SVG 配置生成组件点位定义
+     * 主要用于数据绑定面板中的“组件数据点位”列表
+     * 多个 presetBinding 共享同一 driverProperty 时只生成一个点位（去重）
+     */
+    private generatePoints;
+    /**
+     * 读取文件为文本
+     */
+    private readFileAsText;
+}
+export declare const svgLoader: SVGLoader;

package/dist/src/svg/core/parser.d.ts

@@ -0,0 +1,41 @@
+import { SVGComponentConfig } from './types';
+
+/**
+ * SVG 解析器类
+ */
+export declare class SVGParser {
+    /**
+     * 解析 SVG 字符串
+     * @param svgContent SVG 文件内容
+     * @param fileName 文件名（可选）
+     * @returns 解析后的组件配置
+     */
+    static parse(svgContent: string, fileName?: string): SVGComponentConfig | null;
+    /**
+     * 提取元数据（从 <metadata><scada-config> 中）
+     */
+    private static extractMetadata;
+    /**
+     * 生成默认元数据（当 SVG 没有配置时）
+     */
+    private static generateDefaultMetadata;
+    /**
+     * 提取尺寸信息
+     */
+    private static extractSize;
+    /**
+     * 提取内部部件（自动扫描 id="part-*" 的元素）
+     */
+    private static extractParts;
+    /**
+     * 清理 SVG 内容（移除 metadata 等不需要渲染的标签）
+     */
+    private static cleanSvgContent;
+    /**
+     * 验证 SVG 配置
+     */
+    static validate(config: SVGComponentConfig): {
+        valid: boolean;
+        errors: string[];
+    };
+}