scada-engine 1.0.0

package/dist/src/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' | 'color';
+        /** 如果是布尔型，可配置备选值列表（如 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' | 'color';
+        /** 如果是布尔型，可配置备选值列表（如 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/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/svg/helpers/index.d.ts

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

package/dist/src/svg/helpers/utils.d.ts

@@ -0,0 +1,25 @@
+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/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/svg/rendering/SVGRenderer.d.ts

@@ -0,0 +1,22 @@
+import { SVGComponentConfig } from '../core/types';
+
+/**
+ * Props
+ */
+interface Props {
+    /** X6 节点对象 */
+    node?: any;
+    /** SVG 组件配置（从解析器来） */
+    config?: SVGComponentConfig;
+}
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/src/svg/rendering/animationTemplates.d.ts

@@ -0,0 +1,82 @@
+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/svg/rendering/index.d.ts

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

package/dist/src/utils/authCrypto.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SCADA引擎授权加密解密工具
+ * 基于 AES-256-CBC + OpenSSL 格式
+ * 兼容 Node.js authkey_tool.js
+ */
+export declare function validateSignedLicense(token: string, publicKeyPem: string): Promise<boolean>;
+export declare function getSignedAuthInfo(token: string, publicKeyPem: string): Promise<{
+    company: any;
+    expiryDate: any;
+    isValid: boolean;
+} | null>;
+declare const _default: {
+    validateSignedLicense: typeof validateSignedLicense;
+    getSignedAuthInfo: typeof getSignedAuthInfo;
+};
+export default _default;

package/dist/src/utils/dracoLoader.d.ts

@@ -0,0 +1,3 @@
+import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
+
+export declare function getDracoLoader(): DRACOLoader;

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

@@ -0,0 +1,29 @@
+/**
+ * 工具函数统一导出
+ * 便于其他模块使用
+ *
+ * 注意：许多工具已移动到新的模块结构
+ * - 共享工具 -> shared/utils/
+ * - 共享管理器 -> shared/managers/
+ * - 动画系统 -> shared/animation/
+ * - Canvas操作 -> features/canvas/
+ */
+export * from '../shared/utils/nodePropertyUtils';
+export * from '../shared/utils/eventUtils';
+export * from '../shared/utils/storageUtils';
+export * from '../shared/utils/fileUtils';
+export * from '../shared/utils/commonUtils';
+export * from '../shared/utils/messageUtils';
+export * from '../shared/managers/eventManager';
+export * from '../shared/managers/contextMenuManager';
+export * from '../shared/managers/workerManager';
+export * from '../shared/animation/animationScheduler';
+export * from '../features/canvas/operations/graphOperations';
+export * from '../features/canvas/operations/nodeOperations';
+export * from '../features/canvas/operations/edgeOperations';
+export * from '../features/canvas/managers/configWatcher';
+export * from '../features/canvas/managers/layerManager';
+export * from '../features/data-source/services/dataBindingService';
+export * from './viewportCulling';
+export * from './dracoLoader';
+export * from './authCrypto';

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/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;
+}