@nywqs/scada-engine 1.1.27 → 1.1.28

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

@@ -1,4 +1,5 @@
 import { Graph } from '@antv/x6';
+import { BindingConfig } from '../types/binding';
 
 /**
  * 数据绑定服务类
@@ -13,30 +14,58 @@ export declare class DataBindingService {
     /**
      * 初始化数据绑定监听
      */
-    initDataBinding(): void;
+    private initDataBinding;
     /**
-     * 同步数据到节点
+     * 处理数据源更新
      */
-    private syncDataToNodes;
+    private handleDataUpdate;
     /**
-     * 根据设备数据更新节点
+     * 更新单个节点的数据
      */
-    private updateNodeFromDeviceData;
+    private updateNodeData;
     /**
-     * 应用映射规则
+     * 从原始数据中提取点位值
+     *
+     * @param rawData 原始数据（后端返回的JSON）
+     * @param pointId 点位ID（如 "liquid_level"）
+     * @returns 点位值
      */
-    private applyMapping;
+    private extractPointValue;
     /**
-     * 手动更新设备数据（用于外部传入的设备数据）
+     * 应用值映射转换
+     *
+     * @param value 原始值
+     * @param mapping 映射配置
+     * @returns 转换后的值
      */
-    updateDeviceData(deviceData: any): void;
+    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/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/package.json

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