scada-engine 1.0.0

package/dist/src/scada-components/canvas/manager.d.ts

@@ -0,0 +1,95 @@
+import { CanvasConfig } from './types';
+
+/**
+ * 画布配置管理器
+ */
+declare class CanvasConfigManager {
+    private config;
+    constructor();
+    /**
+     * 获取完整配置
+     */
+    getConfig(): CanvasConfig;
+    /**
+     * 更新配置
+     */
+    updateConfig(updates: Partial<CanvasConfig>): void;
+    /**
+     * 通过路径更新配置值
+     */
+    updateByPath(path: string, value: any): void;
+    /**
+     * 通过路径获取配置值
+     */
+    getByPath(path: string): any;
+    /**
+     * 设置画布尺寸
+     */
+    setSize(width: number, height: number, preset?: string): void;
+    /**
+     * 更新画布尺寸（别名）
+     */
+    updateSize(size: {
+        width: number;
+        height: number;
+    }): void;
+    /**
+     * 设置缩放
+     */
+    setZoom(scale: number): void;
+    /**
+     * 设置偏移
+     */
+    setOffset(x: number, y: number): void;
+    /**
+     * 设置背景颜色
+     */
+    setBackgroundColor(color: string): void;
+    /**
+     * 更新背景配置（别名）
+     */
+    updateBackground(bg: {
+        color?: string;
+        image?: string;
+        size?: string;
+        repeat?: string;
+    }): void;
+    /**
+     * 设置背景图片
+     */
+    setBackgroundImage(url: string): void;
+    /**
+     * 切换网格显示
+     */
+    toggleGrid(enabled?: boolean): void;
+    /**
+     * 设置网格大小
+     */
+    setGridSize(size: number): void;
+    /**
+     * 切换对齐
+     */
+    toggleSnap(enabled?: boolean): void;
+    /**
+     * 切换参考线
+     */
+    toggleGuides(enabled?: boolean): void;
+    /**
+     * 切换吸附
+     */
+    toggleMagnetism(enabled?: boolean): void;
+    /**
+     * 重置配置
+     */
+    reset(): void;
+    /**
+     * 导出配置
+     */
+    export(): string;
+    /**
+     * 导入配置
+     */
+    import(configJson: string): void;
+}
+export declare const canvasConfigManager: CanvasConfigManager;
+export {};

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

@@ -0,0 +1,77 @@
+/**
+ * 画布配置类型定义
+ */
+/**
+ * 画布尺寸预设
+ */
+export type CanvasSizePreset = '1920*1080' | '1366*768' | '1280*720' | '800*600' | 'custom';
+/**
+ * 背景尺寸模式
+ */
+export type BackgroundSize = 'origin' | 'contain' | 'cover' | 'stretch';
+/**
+ * 图像重复模式
+ */
+export type BackgroundRepeat = 'repeat' | 'repeat-x' | 'repeat-y' | 'no-repeat';
+/**
+ * 画布配置接口
+ */
+export interface CanvasConfig {
+    size: {
+        width: number;
+        height: number;
+        preset?: CanvasSizePreset;
+    };
+    zoom: {
+        scale: number;
+        min?: number;
+        max?: number;
+    };
+    offset: {
+        x: number;
+        y: number;
+    };
+    background: {
+        color?: string;
+        image?: string;
+        size?: BackgroundSize;
+        repeat?: BackgroundRepeat;
+    };
+    grid: {
+        enabled: boolean;
+        size: number;
+        color?: string;
+        type?: 'dot' | 'mesh';
+    };
+    snap: {
+        enabled: boolean;
+        threshold?: number;
+    };
+    guides: {
+        enabled: boolean;
+        color?: string;
+    };
+    magnetism: {
+        enabled: boolean;
+        threshold?: number;
+    };
+}
+/**
+ * 画布配置项定义
+ */
+export interface CanvasConfigItem {
+    key: string;
+    label: string;
+    type: 'select' | 'number' | 'color' | 'boolean' | 'slider' | 'image';
+    category: 'basic' | 'transform' | 'background' | 'assist';
+    path: string;
+    defaultValue: any;
+    options?: Array<{
+        label: string;
+        value: any;
+    }>;
+    min?: number;
+    max?: number;
+    step?: number;
+    description?: string;
+}

package/dist/src/scada-components/chart/echarts-gauge/EChartsGauge.d.ts

@@ -0,0 +1,14 @@
+interface Props {
+    node?: any;
+}
+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/scada-components/chart/echarts-gauge/index.d.ts

@@ -0,0 +1,6 @@
+import { ComponentConfig } from '../../types';
+
+/**
+ * ECharts 仪表盘组件配置
+ */
+export declare const EChartsGaugeComponent: ComponentConfig;

package/dist/src/scada-components/chart/echarts-gauge/presets.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ECharts 仪表盘预设样式配置
+ * 优化版本：减少拥挤感，增加留白和可读性
+ */
+export interface GaugePreset {
+    id: string;
+    name: string;
+    config: any;
+}
+export declare const gaugePresets: GaugePreset[];
+/**
+ * 根据预设ID获取预设配置
+ */
+export declare function getPresetById(presetId: string): GaugePreset | undefined;
+/**
+ * 应用预设配置到节点数据
+ */
+export declare function applyPresetConfig(presetId: string): any;

package/dist/src/scada-components/chart/echarts-line/EChartsLine.d.ts

@@ -0,0 +1,14 @@
+interface Props {
+    node?: any;
+}
+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/scada-components/chart/echarts-line/index.d.ts

@@ -0,0 +1,6 @@
+import { ComponentConfig } from '../../types';
+
+/**
+ * ECharts 折线图组件配置
+ */
+export declare const EChartsLineComponent: ComponentConfig;

package/dist/src/scada-components/chart/echarts-line/presets.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ECharts 折线图预设样式配置
+ */
+export interface LinePreset {
+    id: string;
+    name: string;
+    config: any;
+}
+export declare const linePresets: LinePreset[];
+/**
+ * 根据预设ID获取预设配置
+ */
+export declare function getLinePresetById(presetId: string): LinePreset | undefined;

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

@@ -0,0 +1,5 @@
+/**
+ * IoT 组件导出
+ */
+export { EChartsGaugeComponent } from './echarts-gauge';
+export { EChartsLineComponent } from './echarts-line';

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

@@ -0,0 +1,7 @@
+/**
+ * SCADA 组件系统统一导出
+ */
+export { componentRegistry } from './registry';
+export * from './canvas';
+export type { ComponentConfig, ComponentRegistry, ComponentCategory, ComponentMetadata, ComponentProp, ComponentData, NodeAttrs, PropType } from './types';
+export * as IoTComponents from './chart';

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

@@ -0,0 +1,117 @@
+import { ComponentRegistry, ComponentConfig, ComponentCategory } from './types';
+
+type ComponentLoader = () => Promise<{
+    default: ComponentConfig;
+}>;
+/**
+ * 组件注册表
+ */
+declare class ComponentRegistryManager {
+    private registry;
+    private lazyRegistry;
+    private loadingPromises;
+    constructor();
+    /**
+     * 注册默认组件(立即加载)
+     */
+    private registerDefaultComponents;
+    /**
+     * 注册懒加载组件（零配置 - 基于约定自动发现）
+     * 约定：所有 iot/industrial-* 目录下的 index.ts 文件自动注册为懒加载组件
+     * 策略：延迟加载 - 首次请求组件时才加载整个模块，并注册模块内的所有组件
+     */
+    private registerLazyComponents;
+    /**
+     * 注册 Vue Shape 到 X6
+     */
+    private registerVueShape;
+    /**
+     * 注册组件
+     */
+    register(config: ComponentConfig): void;
+    /**
+     * 注册懒加载组件
+     */
+    registerLazy(id: string, loader: ComponentLoader): void;
+    /**
+     * 批量注册组件
+     */
+    registerBatch(configs: ComponentConfig[]): void;
+    /**
+     * 获取组件配置(支持懒加载)
+     */
+    getComponent(id: string): Promise<ComponentConfig | undefined>;
+    /**
+     * 同步获取组件(仅已加载的)
+     */
+    getComponentSync(id: string): ComponentConfig | undefined;
+    /**
+     * 加载懒加载组件
+     */
+    private loadComponent;
+    /**
+     * 预加载组件
+     */
+    preloadComponent(id: string): Promise<boolean>;
+    /**
+     * 批量预加载组件
+     */
+    preloadComponents(ids: string[]): Promise<void>;
+    /**
+     * 预加载所有组件
+     * 包括模块级别的懒加载（以 __module__ 开头）
+     */
+    preloadAllComponents(): Promise<void>;
+    /**
+     * 通过shape获取组件配置
+     */
+    getComponentByShape(shape: string): ComponentConfig | undefined;
+    /**
+     * 获取所有组件(仅已加载)
+     */
+    getAllComponents(): ComponentRegistry;
+    /**
+     * 获取所有组件ID(包括未加载)
+     */
+    getAllComponentIds(): string[];
+    /**
+     * 按分类获取组件
+     */
+    getComponentsByCategory(category: ComponentCategory): ComponentConfig[];
+    /**
+     * 获取组件列表
+     */
+    getComponentList(): ComponentConfig[];
+    /**
+     * 检查组件是否存在
+     */
+    hasComponent(id: string): boolean;
+    /**
+     * 注销组件
+     */
+    unregister(id: string): boolean;
+    /**
+     * 获取组件数量
+     */
+    getCount(): number;
+    /**
+     * 获取已加载组件数量
+     */
+    getLoadedCount(): number;
+    /**
+     * 获取懒加载统计
+     */
+    getLazyLoadStats(): {
+        total: number;
+        loaded: number;
+        pending: number;
+        loadRate: string;
+    };
+    /**
+     * 清空注册表
+     */
+    clear(): void;
+}
+export declare const componentRegistry: ComponentRegistryManager;
+export type { ComponentConfig, ComponentRegistry, ComponentCategory };
+export * from './types';

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

@@ -0,0 +1,108 @@
+import { ComponentDataAdapter } from '../types/dataAdapter';
+
+/**
+ * 属性配置类型
+ */
+export type PropType = 'text' | 'number' | 'color' | 'boolean' | 'select' | 'slider';
+/**
+ * 属性配置项
+ */
+export interface ComponentProp {
+    key: string;
+    label: string;
+    type: PropType;
+    path: string;
+    defaultValue?: any;
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: Array<{
+        label: string;
+        value: any;
+    }>;
+    description?: string;
+    bindable?: boolean;
+}
+/**
+ * 组件分类
+ */
+export type ComponentCategory = 'basic' | 'iot' | 'chart' | 'custom';
+/**
+ * 组件元数据
+ */
+export interface ComponentMetadata {
+    id: string;
+    name: string;
+    category: ComponentCategory;
+    icon: string;
+    description?: string;
+    version?: string;
+    author?: string;
+}
+/**
+ * X6 节点属性
+ */
+export interface NodeAttrs {
+    body?: Record<string, any>;
+    label?: Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * 组件数据
+ */
+export interface ComponentData {
+    type: string;
+    deviceId?: string;
+    property?: string;
+    [key: string]: any;
+}
+/**
+ * 组件点位定义（组件预定义的数据点）
+ */
+export interface ComponentPoint {
+    /** 点位ID（组件内部标识） */
+    id: string;
+    /** 点位名称 */
+    name: string;
+    /** 点位描述 */
+    description?: string;
+    /** 数据类型 */
+    dataType: 'boolean' | 'number' | 'string' | 'json';
+    /** 单位 */
+    unit?: string;
+    /** 默认值 */
+    defaultValue?: any;
+    /** 是否必需 */
+    required?: boolean;
+    /** 数值范围（仅number类型） */
+    range?: {
+        min?: number;
+        max?: number;
+    };
+}
+/**
+ * 组件配置
+ */
+export interface ComponentConfig {
+    metadata: ComponentMetadata;
+    shape: string;
+    width: number;
+    height: number;
+    label: string;
+    attrs: NodeAttrs;
+    data?: ComponentData;
+    ports?: any;
+    props: ComponentProp[];
+    component?: any;
+    dataAdapter?: ComponentDataAdapter;
+    points?: ComponentPoint[];
+}
+/**
+ * 组件注册表
+ */
+export type ComponentRegistry = Record<string, ComponentConfig>;
+/**
+ * 公共动画属性配置
+ * 可以在任何组件中复用
+ */
+export declare const COMMON_ANIMATION_PROPS: ComponentProp[];

package/dist/src/shared/animation/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/src/shared/animation/animationScheduler.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 统一动画调度器
+ * 解决多个组件独立使用 requestAnimationFrame 导致的性能问题
+ *
+ * 优势:
+ * 1. 统一时间步进,避免动画不同步
+ * 2. 减少 RAF 调用次数,降低浏览器开销
+ * 3. 集中管理所有动画,便于调试和性能监控
+ * 4. 支持动画暂停/恢复/销毁
+ */
+export interface AnimationTask {
+    id: string;
+    callback: (deltaTime: number, currentTime: number) => void;
+    enabled: boolean;
+    lastTime: number;
+}
+declare class AnimationScheduler {
+    private tasks;
+    private rafId;
+    private isRunning;
+    private lastFrameTime;
+    private frameCount;
+    private fpsUpdateTime;
+    private currentFps;
+    /**
+     * 注册动画任务
+     * @param id 唯一标识符(通常使用组件 nodeId)
+     * @param callback 动画回调函数 (deltaTime: 距上次调用的毫秒数, currentTime: 当前时间戳)
+     */
+    register(id: string, callback: (deltaTime: number, currentTime: number) => void): void;
+    /**
+     * 注销动画任务
+     * @param id 任务标识符
+     */
+    unregister(id: string): void;
+    /**
+     * 启用/禁用特定任务
+     * @param id 任务标识符
+     * @param enabled 是否启用
+     */
+    setEnabled(id: string, enabled: boolean): void;
+    /**
+     * 启动调度器
+     */
+    private start;
+    /**
+     * 停止调度器
+     */
+    private stop;
+    /**
+     * 动画帧循环
+     */
+    private tick;
+    /**
+     * 获取当前 FPS
+     */
+    getFps(): number;
+    /**
+     * 获取活跃任务数量
+     */
+    getActiveTaskCount(): number;
+    /**
+     * 暂停所有动画
+     */
+    pauseAll(): void;
+    /**
+     * 恢复所有动画
+     */
+    resumeAll(): void;
+    /**
+     * 清除所有任务并停止调度器
+     */
+    destroy(): void;
+    /**
+     * 获取调度器状态(用于调试)
+     */
+    getStatus(): {
+        isRunning: boolean;
+        taskCount: number;
+        activeTaskCount: number;
+        fps: number;
+    };
+}
+export declare const animationScheduler: AnimationScheduler;
+export {};

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

@@ -0,0 +1,2 @@
+export * from './animationEngine';
+export * from './animationScheduler';

package/dist/src/shared/components/ComponentLibrary.d.ts

@@ -0,0 +1,34 @@
+interface Props {
+    isCollapsed?: boolean;
+}
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    isCollapsed: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    addComponent: (type: string) => void;
+    "update:collapsed": (value: boolean) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    isCollapsed: boolean;
+}>>> & Readonly<{
+    onAddComponent?: ((type: string) => any) | undefined;
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+}>, {
+    isCollapsed: boolean;
+}, {}, {}, {}, 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;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};