@nywqs/scada-engine 1.1.30 → 2.0.0

package/dist/src/scada-components/svg/core/types.d.ts

@@ -0,0 +1,297 @@
+/**
+ * SVG 组件类型定义
+ * 支持外部数据驱动的内部局部动画
+ */
+/**
+ * 动画模板类型（预设的业务语义动画）
+ */
+export declare enum AnimationTemplateType {
+    /** 开度 → 旋转 (0~1 → 0~90°) */
+    OPENING_ROTATE = "opening-rotate",
+    /** 液位 → 高度 (0~100 → 填充高度) */
+    LEVEL_HEIGHT = "level-height",
+    /** 状态 → 颜色 (枚举/布尔 → 颜色映射) */
+    STATUS_COLOR = "status-color",
+    /** 数值 → 位置 (0~1 → 滑块位移) */
+    VALUE_POSITION = "value-position",
+    /** 速度 → 流动 (0~100 → stroke-dashoffset 动画速度) */
+    SPEED_FLOW = "speed-flow",
+    /** 透明度映射 (0~1 → opacity) */
+    VALUE_OPACITY = "value-opacity",
+    /** 字符串 → 文本内容 (直接显示) */
+    VALUE_TEXT = "value-text",
+    /** 自定义 (用户完全自定义) */
+    CUSTOM = "custom"
+}
+/**
+ * 内部 SVG 部件定义
+ */
+export interface SVGPart {
+    /** 部件 ID（对应 SVG 中的 id 属性） */
+    id: string;
+    /** 部件名称（可读） */
+    name?: string;
+    /** SVG 元素类型 */
+    elementType?: 'g' | 'rect' | 'circle' | 'path' | 'polygon' | 'text' | 'line';
+    /** 部件描述 */
+    description?: string;
+}
+/**
+ * 内部动画配置
+ */
+export interface InternalAnimationConfig {
+    /** 动画 ID */
+    id: string;
+    /** 目标 SVG 部件 ID */
+    partId: string;
+    /** 驱动字段（node.data 中的字段名） */
+    driverProperty: string;
+    /** 动画模板类型 */
+    templateType: AnimationTemplateType;
+    /** 模板参数（根据不同模板有不同结构） */
+    templateParams?: AnimationTemplateParams;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 过渡时长（ms） */
+    transitionDuration?: number;
+    /** 缓动函数 */
+    easing?: 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';
+}
+/**
+ * 动画模板参数（联合类型）
+ */
+export type AnimationTemplateParams = OpeningRotateParams | LevelHeightParams | StatusColorParams | ValuePositionParams | SpeedFlowParams | ValueOpacityParams | ValueTextParams | CustomParams;
+/**
+ * 开度 → 旋转 参数
+ */
+export interface OpeningRotateParams {
+    type: AnimationTemplateType.OPENING_ROTATE;
+    /** 输入范围 */
+    inputRange: {
+        min: number;
+        max: number;
+    };
+    /** 输出角度范围（度） */
+    outputRange: {
+        min: number;
+        max: number;
+    };
+    /** 旋转中心 */
+    origin?: 'center' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | string;
+}
+/**
+ * 液位 → 高度 参数
+ */
+export interface LevelHeightParams {
+    type: AnimationTemplateType.LEVEL_HEIGHT;
+    /** 输入范围 */
+    inputRange: {
+        min: number;
+        max: number;
+    };
+    /** 填充方向 */
+    direction?: 'bottom-up' | 'top-down' | 'left-right' | 'right-left';
+    /** 容器高度/宽度（默认使用元素自身尺寸） */
+    containerSize?: number;
+}
+/**
+ * 状态 → 颜色 参数
+ */
+export interface StatusColorParams {
+    type: AnimationTemplateType.STATUS_COLOR;
+    /** 颜色映射表 */
+    colorMap: Record<string | number, string>;
+    /** 默认颜色 */
+    defaultColor?: string;
+    /** 应用到的属性 */
+    applyTo?: 'fill' | 'stroke' | 'both';
+}
+/**
+ * 数值 → 位置 参数
+ */
+export interface ValuePositionParams {
+    type: AnimationTemplateType.VALUE_POSITION;
+    /** 输入范围 */
+    inputRange: {
+        min: number;
+        max: number;
+    };
+    /** 移动方向和距离 */
+    movement: {
+        axis: 'x' | 'y';
+        distance: number;
+    };
+}
+/**
+ * 速度 → 流动 参数
+ */
+export interface SpeedFlowParams {
+    type: AnimationTemplateType.SPEED_FLOW;
+    /** 输入范围 */
+    inputRange: {
+        min: number;
+        max: number;
+    };
+    /** 流动速度范围（px/s） */
+    speedRange: {
+        min: number;
+        max: number;
+    };
+    /** 虚线图案长度 */
+    dashLength?: number;
+}
+/**
+ * 透明度 参数
+ */
+export interface ValueOpacityParams {
+    type: AnimationTemplateType.VALUE_OPACITY;
+    /** 输入范围 */
+    inputRange: {
+        min: number;
+        max: number;
+    };
+    /** 输出透明度范围 */
+    outputRange: {
+        min: number;
+        max: number;
+    };
+}
+/**
+ * 字符串 → 文本内容 参数
+ */
+export interface ValueTextParams {
+    type: AnimationTemplateType.VALUE_TEXT;
+    /** 默认文本（空值时显示） */
+    defaultText?: string;
+}
+/**
+ * 自定义参数
+ */
+export interface CustomParams {
+    type: AnimationTemplateType.CUSTOM;
+    /** 自定义映射函数（序列化的函数体） */
+    mappingFunction?: string;
+    /** 其他自定义配置 */
+    [key: string]: any;
+}
+/**
+ * SVG 组件元数据（扩展标准 ComponentMetadata）
+ */
+export interface SVGComponentMetadata {
+    /** 组件 ID */
+    id: string;
+    /** 组件名称 */
+    name: string;
+    /** 组件分类 */
+    category: 'basic' | 'iot' | 'chart' | 'custom';
+    /** 图标 */
+    icon: string;
+    /** 描述 */
+    description?: string;
+    /** 版本 */
+    version?: string;
+    /** 作者 */
+    author?: string;
+    /** SVG 来源信息 */
+    svgSource?: {
+        /** 原始文件名 */
+        fileName?: string;
+        /** 上传时间 */
+        uploadTime?: string;
+    };
+}
+/**
+ * SVG 组件配置（完整）
+ */
+export interface SVGComponentConfig {
+    /** 元数据 */
+    metadata: SVGComponentMetadata;
+    /** 组件尺寸 */
+    size: {
+        width: number;
+        height: number;
+    };
+    /** SVG 内容（清理后的 SVG 字符串，去除 metadata 标签） */
+    svgContent: string;
+    /** 内部部件列表（自动提取 part-* 的元素） */
+    parts: SVGPart[];
+    /** 内部动画配置（可由组态工程师配置） */
+    internalAnimations?: InternalAnimationConfig[];
+    /** 默认数据（包含默认驱动字段） */
+    defaultData?: Record<string, any>;
+    /** 预设绑定（官方组件可提供） */
+    presetBindings?: Array<{
+        partId: string;
+        /** 驱动字段英文名（用于 data.xxx 字段） */
+        suggestedDriverProperty: string;
+        suggestedTemplate: AnimationTemplateType;
+        suggestedParams?: AnimationTemplateParams;
+        /** 可选：属性中文名称，用于属性面板显示 */
+        label?: string;
+        /** 可选：字段值类型，用于属性编辑器渲染 */
+        valueType?: 'number' | 'boolean' | 'string';
+        /** 如果是布尔型，可配置备选值列表（如 0/1, open/closed 等） */
+        booleanOptions?: Array<{
+            value: string | number | boolean;
+            label: string;
+        }>;
+    }>;
+    /** 接线柱配置（从 SVG 文件的 metadata 中读取） */
+    ports?: Array<{
+        id: string;
+        group: 'top' | 'bottom' | 'left' | 'right';
+        args?: {
+            x?: number | string;
+            y?: number | string;
+        };
+    }>;
+}
+/**
+ * SVG 文件元数据格式（在 SVG 的 <metadata> 中）
+ */
+export interface SVGFileMetadata {
+    /** 组件元数据 */
+    component: {
+        id: string;
+        name: string;
+        category?: string;
+        icon?: string;
+        description?: string;
+        version?: string;
+        author?: string;
+    };
+    /** 默认尺寸 */
+    size?: {
+        width: number;
+        height: number;
+    };
+    /** 预设绑定（可选，官方组件提供） */
+    presetBindings?: Array<{
+        partId: string;
+        /** 驱动字段英文名（用于 data.xxx 字段） */
+        suggestedDriverProperty: string;
+        suggestedTemplate: AnimationTemplateType;
+        suggestedParams?: any;
+        /** 可选：属性中文名称，用于属性面板显示 */
+        label?: string;
+        /** 可选：字段值类型，用于属性编辑器渲染 */
+        valueType?: 'number' | 'boolean' | 'string';
+        /** 如果是布尔型，可配置备选值列表（如 0/1, open/closed 等） */
+        booleanOptions?: Array<{
+            value: string | number | boolean;
+            label: string;
+        }>;
+    }>;
+    /** 接线柱配置（可选） */
+    ports?: Array<{
+        /** 接线柱 ID */
+        id: string;
+        /** 位置组 */
+        group: 'top' | 'bottom' | 'left' | 'right';
+        /** 自定义位置（可选，覆盖 group 的默认位置） */
+        args?: {
+            x?: number | string;
+            y?: number | string;
+        };
+    }>;
+}

package/dist/src/scada-components/svg/helpers/demo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SVG 组件系统演示和测试
+ * 在浏览器控制台运行以下代码进行测试
+ */
+/**
+ * 演示1：加载示例 SVG 组件
+ */
+export declare function demo1_loadExamples(): Promise<void>;
+/**
+ * 演示2：从字符串加载自定义 SVG
+ */
+export declare function demo2_loadCustomSvg(): void;
+/**
+ * 演示3：配置内部动画
+ */
+export declare function demo3_configureAnimation(nodeId: string): void;
+/**
+ * 演示4：模拟数据驱动动画
+ */
+export declare function demo4_simulateDataDrive(): void;

package/dist/src/scada-components/svg/helpers/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SVG 辅助工具模块
+ * 包含工具函数和演示代码
+ */
+export { loadExampleSvgComponents, getAnimationTemplateName, getAnimationTemplateDescription, createDefaultTemplateParams, validateInternalAnimation } from './utils';

package/dist/src/scada-components/svg/helpers/utils.d.ts

@@ -0,0 +1,24 @@
+import { AnimationTemplateType } from '../core/types';
+/**
+ * 从目录批量加载示例 SVG 组件
+ */
+export declare function loadExampleSvgComponents(): Promise<void>;
+/**
+ * 获取动画模板的友好名称
+ */
+export declare function getAnimationTemplateName(templateType: AnimationTemplateType): string;
+/**
+ * 获取动画模板的描述
+ */
+export declare function getAnimationTemplateDescription(templateType: AnimationTemplateType): string;
+/**
+ * 创建默认的动画模板参数
+ */
+export declare function createDefaultTemplateParams(templateType: AnimationTemplateType): any;
+/**
+ * 验证内部动画配置
+ */
+export declare function validateInternalAnimation(config: any): {
+    valid: boolean;
+    errors: string[];
+};

package/dist/src/scada-components/svg/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SVG 组件系统统一导出
+ */
+export * from './core/types';
+export { SVGParser } from './core/parser';
+export { svgLoader, SVGLoader } from './core/loader';
+export { animationTemplateEngine, AnimationTemplateEngine } from './rendering/animationTemplates';
+export { default as SVGRenderer } from './rendering/SVGRenderer';
+export { loadExampleSvgComponents, getAnimationTemplateName, getAnimationTemplateDescription, createDefaultTemplateParams, validateInternalAnimation } from './helpers/utils';

package/dist/src/scada-components/svg/rendering/SVGRenderer.d.ts

@@ -0,0 +1,14 @@
+import { SVGComponentConfig } from '../core/types';
+/**
+ * Props
+ */
+interface Props {
+    /** X6 节点对象 */
+    node?: any;
+    /** SVG 组件配置（从解析器来） */
+    config?: SVGComponentConfig;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    svgRef: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/src/scada-components/svg/rendering/animationTemplates.d.ts

@@ -0,0 +1,81 @@
+import { AnimationTemplateType, AnimationTemplateParams } from '../core/types';
+/**
+ * 动画模板引擎类
+ */
+export declare class AnimationTemplateEngine {
+    private states;
+    /**
+     * 应用动画模板
+     * @param element SVG 元素
+     * @param templateType 模板类型
+     * @param params 模板参数
+     * @param driverValue 驱动值（来自 node.data）
+     * @param options 动画选项
+     */
+    applyTemplate(element: SVGGraphicsElement, templateType: AnimationTemplateType, params: AnimationTemplateParams, driverValue: any, options?: {
+        transitionDuration?: number;
+        easing?: string;
+        stateKey?: string;
+    }): void;
+    /**
+     * 开度 → 旋转
+     */
+    private applyOpeningRotate;
+    /**
+     * 液位 → 高度
+     */
+    private applyLevelHeight;
+    /**
+     * 对矩形应用液位
+     */
+    private applyLevelToRect;
+    /**
+     * 对路径应用液位（使用 clip-path）
+     */
+    private applyLevelToPath;
+    /**
+     * 使用 clip-path 应用液位
+     */
+    private applyLevelWithClipPath;
+    /**
+     * 状态 → 颜色
+     */
+    private applyStatusColor;
+    /**
+     * 数值 → 位置
+     */
+    private applyValuePosition;
+    /**
+     * 速度 → 流动
+     */
+    private applySpeedFlow;
+    /**
+     * 透明度映射
+     */
+    private applyValueOpacity;
+    /**
+     * 字符串 → 文本内容
+     */
+    private applyValueText;
+    /**
+     * 值映射（线性插值）
+     */
+    private mapRange;
+    /**
+     * 获取变换原点
+     */
+    private getTransformOrigin;
+    /**
+     * 确保流动动画的 CSS 已定义
+     */
+    private ensureFlowAnimation;
+    /**
+     * 清理状态
+     */
+    clearState(stateKey: string): void;
+    /**
+     * 清理所有状态
+     */
+    clearAllStates(): void;
+}
+export declare const animationTemplateEngine: AnimationTemplateEngine;

package/dist/src/scada-components/svg/rendering/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SVG 渲染模块
+ * 包含渲染器和动画模板引擎
+ */
+export { default as SVGRenderer } from './SVGRenderer';
+export { animationTemplateEngine, AnimationTemplateEngine } from './animationTemplates';

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

@@ -1,5 +1,4 @@
 import { ComponentDataAdapter } from '../types/dataAdapter';
-
 /**
  * 属性配置类型
  */

package/dist/src/types/context-menu.d.ts

@@ -0,0 +1,13 @@
+import { Component } from 'vue';
+/**
+ * 菜单项接口
+ */
+export interface MenuItem {
+    key: string;
+    label?: string;
+    icon?: Component;
+    hotkey?: string;
+    disabled?: boolean;
+    divider?: boolean;
+    onClick?: () => void;
+}

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

@@ -0,0 +1,106 @@
+/**
+ * 3D 模型相关类型定义
+ */
+/**
+ * 3D 向量
+ */
+export interface Vector3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * 3D 模型来源类型
+ */
+export type Model3DType = 'procedural' | 'gltf' | 'glb' | 'fbx';
+/**
+ * 3D 模型配置（组件级别）
+ */
+export interface Model3DConfig {
+    /** 模型类型 */
+    type: Model3DType;
+    /** 模型文件 URL 或 Blob URL */
+    source?: string;
+    /** 默认缩放 */
+    scale?: number;
+    /** 初始位置 */
+    position?: Vector3;
+    /** 初始旋转（弧度） */
+    rotation?: Vector3;
+}
+/**
+ * 已加载模型的元数据
+ */
+export interface ModelMetadata {
+    /** 顶点数 */
+    vertexCount: number;
+    /** 材质数 */
+    materialCount: number;
+    /** 包围盒 */
+    boundingBox: {
+        min: Vector3;
+        max: Vector3;
+    };
+    /** 是否包含动画 */
+    hasAnimations: boolean;
+    /** 动画名称列表 */
+    animationNames: string[];
+    /** 文件大小(bytes) */
+    fileSize?: number;
+}
+/**
+ * 加载后的模型数据
+ */
+export interface LoadedModel {
+    /** Three.js Object3D 实例 */
+    object3D: any;
+    /** 模型元数据 */
+    metadata: ModelMetadata;
+    /** 动画片段列表 */
+    animations: any[];
+}
+/**
+ * 标准化后的模型
+ */
+export interface NormalizedModel extends LoadedModel {
+    /** 标准化缩放因子（已应用） */
+    normalizeScale: number;
+    /** 原始包围盒中心偏移（已应用） */
+    centerOffset: Vector3;
+}
+/**
+ * 模型缓存条目
+ */
+export interface ModelCacheEntry {
+    /** 缓存键 */
+    key: string;
+    /** 已加载的模型 */
+    model: LoadedModel;
+    /** 最后访问时间戳 */
+    lastAccess: number;
+    /** 文件大小(bytes) */
+    size: number;
+}
+/**
+ * 3D 场景配置
+ */
+export interface Scene3DConfig {
+    /** 背景色 */
+    backgroundColor?: string;
+    /** 环境光强度 (0-1) */
+    ambientLightIntensity?: number;
+    /** 主光源强度 (0-1) */
+    directionalLightIntensity?: number;
+    /** 是否启用阴影 */
+    enableShadows?: boolean;
+    /** 是否启用抗锯齿 */
+    antialias?: boolean;
+    /** 相机初始位置 */
+    cameraPosition?: Vector3;
+    /** 相机观察目标 */
+    cameraTarget?: Vector3;
+}
+/**
+ * 默认3D场景配置
+ */
+export declare const defaultScene3DConfig: Scene3DConfig;

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

@@ -0,0 +1,54 @@
+/**
+ * 分区系统类型定义
+ */
+/**
+ * 分区布局模式
+ */
+export type ZoneLayoutMode = 'single-2d' | 'horizontal' | 'vertical';
+/**
+ * 分区布局配置
+ */
+export interface ZoneLayoutConfig {
+    /** 布局模式: single-2d(仅2D) / horizontal(左右分屏) / vertical(上下分屏) */
+    mode: ZoneLayoutMode;
+    /** 2D区域占比 (0.3 - 0.7)，默认 0.5 */
+    splitRatio: number;
+    /** 区域最小尺寸(px)，默认 300 */
+    minZoneSize: number;
+}
+/**
+ * 默认分区布局配置
+ */
+export declare const defaultZoneLayoutConfig: ZoneLayoutConfig;
+/**
+ * 区域类型标识
+ */
+export type ZoneType = '2d' | '3d';
+/**
+ * 跨区域事件类型定义
+ */
+export interface ZoneEvents {
+    /** 组件被选中 */
+    'component:selected': {
+        id: string;
+        source: ZoneType;
+    };
+    /** 组件取消选中 */
+    'component:deselected': {
+        source: ZoneType;
+    };
+    /** 组件数据更新 */
+    'data:updated': {
+        componentId: string;
+        data: Record<string, any>;
+    };
+    /** 布局模式变化 */
+    'layout:changed': {
+        mode: ZoneLayoutMode;
+    };
+    /** 组件被删除 */
+    'component:deleted': {
+        id: string;
+        source: ZoneType;
+    };
+}

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

@@ -0,0 +1,6 @@
+/**
+ * 动画系统模块
+ * 包含动画引擎和动画调度器
+ */
+export * from './animation-engine';
+export * from './animation-scheduler';