@nywqs/scada-engine 1.1.0

package/dist/types/binding.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 数据绑定和映射配置类型定义
+ */
+/**
+ * 映射类型
+ */
+export declare enum MappingType {
+    DIRECT = "direct",// 直接映射
+    BOOLEAN = "boolean",// 布尔映射
+    RANGE = "range",// 范围映射
+    ENUM = "enum"
+}
+/**
+ * 值类型（与点位数据类型对应）
+ */
+export declare enum ValueType {
+    BOOLEAN = "boolean",// 布尔型
+    NUMBER = "number",// 数值型
+    STRING = "string"
+}
+/**
+ * 范围映射规则
+ */
+export interface RangeRule {
+    /** 最小值（包含） */
+    min: number;
+    /** 最大值（包含） */
+    max: number;
+    /** 映射值 */
+    value: any;
+    /** 标签（可选） */
+    label?: string;
+    /** 单位（可选） */
+    unit?: string;
+}
+/**
+ * 映射配置
+ */
+export interface MappingConfig {
+    /** 映射类型 */
+    type: MappingType;
+    /** 值类型（必填） */
+    valueType: ValueType;
+    /** 布尔映射 - true时的值 */
+    trueValue?: any;
+    /** 布尔映射 - false时的值 */
+    falseValue?: any;
+    /** 范围映射 - 规则列表 */
+    rangeRules?: RangeRule[];
+    /** 枚举映射 - 键值对 */
+    enumMappings?: Record<string, any>;
+    /** 保留原始值的单位（可选） */
+    keepOriginalUnit?: boolean;
+    /** 自定义单位（可选，会覆盖点位单位） */
+    customUnit?: string;
+}
+/**
+ * 绑定配置
+ */
+export interface BindingConfig {
+    /** 绑定ID */
+    id?: string;
+    /** 设备点位ID（格式: deviceId:pointId） */
+    devicePointId?: string;
+    /** 目标节点属性 */
+    targetProperty?: string;
+    /** 映射配置 */
+    mapping?: MappingConfig;
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/**
+ * 应用映射规则，将点位值转换为目标值
+ */
+export declare function applyMapping(value: any, mapping: MappingConfig): any;

package/dist/types/device.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 设备点位数据结构定义
+ */
+/**
+ * 点位数据类型
+ */
+export declare enum PointDataType {
+    BOOLEAN = "boolean",// 布尔值
+    NUMBER = "number",// 数值
+    STRING = "string"
+}
+/**
+ * 点位访问权限
+ */
+export declare enum PointAccessMode {
+    READ = "read",// 只读
+    WRITE = "write",// 只写
+    READ_WRITE = "readWrite"
+}
+/**
+ * 设备点位
+ */
+export interface DevicePoint {
+    /** 点位ID */
+    id: string;
+    /** 点位名称 */
+    name: string;
+    /** 点位编码（设备内部地址） */
+    code: string;
+    /** 点位描述 */
+    description?: string;
+    /** 数据类型 */
+    dataType: PointDataType;
+    /** 访问权限 */
+    accessMode: PointAccessMode;
+    /** 当前值 */
+    value?: any;
+    /** 单位 */
+    unit?: string;
+    /** 最小值 */
+    minValue?: number;
+    /** 最大值 */
+    maxValue?: number;
+    /** 精度（小数位数） */
+    precision?: number;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 更新时间 */
+    updateTime?: string;
+    /** 质量戳（good/bad/uncertain） */
+    quality?: 'good' | 'bad' | 'uncertain';
+}
+/**
+ * 设备状态
+ */
+export declare enum DeviceStatus {
+    ONLINE = "online",// 在线
+    OFFLINE = "offline",// 离线
+    ERROR = "error",// 故障
+    MAINTENANCE = "maintenance"
+}
+/**
+ * 设备类型
+ */
+export declare enum DeviceType {
+    PLC = "plc",// PLC设备
+    SENSOR = "sensor",// 传感器
+    ACTUATOR = "actuator",// 执行器
+    METER = "meter",// 仪表
+    CAMERA = "camera",// 摄像头
+    OTHER = "other"
+}
+/**
+ * 设备
+ */
+export interface Device {
+    /** 设备ID */
+    id: string;
+    /** 设备名称 */
+    name: string;
+    /** 设备编码 */
+    code: string;
+    /** 设备类型 */
+    type: DeviceType;
+    /** 设备描述 */
+    description?: string;
+    /** 设备状态 */
+    status: DeviceStatus;
+    /** 设备IP地址 */
+    ipAddress?: string;
+    /** 设备端口 */
+    port?: number;
+    /** 通信协议 */
+    protocol?: string;
+    /** 点位列表 */
+    points: DevicePoint[];
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 创建时间 */
+    createTime?: string;
+    /** 更新时间 */
+    updateTime?: string;
+    /** 标签 */
+    tags?: string[];
+    /** 扩展属性 */
+    properties?: Record<string, any>;
+}
+/**
+ * 设备列表
+ */
+export interface DeviceList {
+    /** 设备列表 */
+    devices: Device[];
+    /** 总数 */
+    total: number;
+}
+/**
+ * 点位值更新事件
+ */
+export interface PointValueUpdate {
+    /** 设备ID */
+    deviceId: string;
+    /** 点位ID */
+    pointId: string;
+    /** 新值 */
+    value: any;
+    /** 更新时间 */
+    timestamp: string;
+    /** 质量戳 */
+    quality: 'good' | 'bad' | 'uncertain';
+}

package/dist/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/utils/animationEngine.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 动画执行引擎
+ * 负责处理组件的各种动画效果
+ */
+export type AnimationType = 'none' | 'blink' | 'scale' | 'rotate' | 'float' | 'pulse';
+export interface AnimationConfig {
+    type: AnimationType;
+    duration: number;
+    loop: boolean;
+}
+/**
+ * 动画管理器
+ */
+declare class AnimationEngine {
+    animations: Map<string, any>;
+    /**
+     * 启动节点动画
+     * @param node X6 节点
+     * @param config 动画配置
+     */
+    startAnimation(node: any, config: AnimationConfig): void;
+    /**
+     * 停止节点动画
+     * @param nodeId 节点ID
+     */
+    stopAnimation(nodeId: string): void;
+    /**
+     * 创建闪烁动画
+     */
+    createBlinkAnimation(node: any, config: AnimationConfig): {
+        intervalId: NodeJS.Timeout;
+        stop: () => void;
+    };
+    /**
+     * 创建缩放动画
+     */
+    createScaleAnimation(node: any, config: AnimationConfig): {
+        intervalId: NodeJS.Timeout;
+        stop: () => void;
+    };
+    /**
+     * 创建旋转动画
+     */
+    createRotateAnimation(node: any, config: AnimationConfig): {
+        intervalId: NodeJS.Timeout;
+        stop: () => void;
+    };
+    /**
+     * 创建浮动动画
+     */
+    createFloatAnimation(node: any, config: AnimationConfig): {
+        intervalId: NodeJS.Timeout;
+        stop: () => void;
+    };
+    /**
+     * 创建脉冲动画
+     */
+    createPulseAnimation(node: any, config: AnimationConfig): {
+        intervalId: NodeJS.Timeout;
+        stop: () => void;
+    };
+    /**
+     * 清除所有动画
+     */
+    clearAll(): void;
+}
+export declare const animationEngine: AnimationEngine;
+export {};

package/dist/utils/authCrypto.d.ts

@@ -0,0 +1,45 @@
+interface DecryptResult {
+    success: boolean;
+    company?: string;
+    expiryDate?: string;
+    machineId?: string;
+    parts?: string[];
+    error?: string;
+}
+/**
+ * 解密授权码
+ * @param hexString - Hex格式的授权码
+ * @param password - 解密密码
+ * @returns 解密结果
+ */
+export declare function decryptAuthKey(hexString: string, password?: string): DecryptResult;
+/**
+ * 验证授权码有效性
+ * @param authCode - Hex格式的授权码
+ * @param password - 解密密码
+ * @returns 是否有效
+ */
+export declare function validateAuthKey(authCode: string, password?: string): boolean;
+/**
+ * 获取授权信息
+ * @param authCode - Hex格式的授权码
+ * @param password - 解密密码
+ * @returns 授权信息对象
+ */
+export declare function getAuthInfo(authCode: string, password?: string): {
+    company: string;
+    expiryDate: string | undefined;
+    isValid: boolean;
+} | null;
+/**
+ * 生成测试授权码的辅助函数
+ * 注意：此函数仅用于开发测试，生产环境应使用 Node.js 版本的 authkey_tool.js
+ */
+export declare function generateTestAuthCode(company: string, expiryDate?: string): string;
+declare const _default: {
+    decryptAuthKey: typeof decryptAuthKey;
+    validateAuthKey: typeof validateAuthKey;
+    getAuthInfo: typeof getAuthInfo;
+    generateTestAuthCode: typeof generateTestAuthCode;
+};
+export default _default;

package/dist/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/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/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/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 工具函数统一导出
+ * 便于其他模块使用
+ */
+export * from './nodePropertyUtils';
+export * from './eventUtils';
+export * from './storageUtils';
+export * from './fileUtils';
+export * from './commonUtils';
+export * from './messageUtils';