@huanban/rulego-editor-core 1.0.0

package/dist/core/ComponentRegistry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @file ComponentRegistry.ts
+ * @description 组件注册表 — 管理所有可用的节点组件
+ *
+ * 负责:
+ * - 注册和管理组件定义 (来自后端 API 或内置默认)
+ * - 按分类分组 (filter/transform/action/external/flow)
+ * - 提供按 type 快速查询
+ * - 适配后端返回的原始数据格式
+ * - 合并本地化信息 (标签、描述、图标等)
+ *
+ * @see default.js - 内置组件定义
+ * @see local_zh.js - 中文本地化
+ * @see util.js - adapterComponents 转换函数
+ */
+import type { ComponentDefinition, ComponentGroup, RawComponentData, ComponentRegistryOptions } from '../types/component';
+/**
+ * 组件注册表
+ *
+ * 管理编辑器中所有可用的节点组件定义。
+ * 支持按 type 查找、按 category 分组、动态注册/注销等操作。
+ *
+ * @example
+ * ```typescript
+ * const registry = new ComponentRegistry()
+ *
+ * // 从后端 API 数据加载组件
+ * registry.loadFromRawData(apiData)
+ *
+ * // 按 type 查找
+ * const filterNode = registry.getByType('jsFilter')
+ *
+ * // 获取分组 (用于侧边栏渲染)
+ * const groups = registry.getGroups()
+ *
+ * // 动态注册自定义组件
+ * registry.register({
+ *   type: 'myCustomNode',
+ *   category: 'action',
+ *   label: 'My Custom Node',
+ *   ...
+ * })
+ * ```
+ */
+export declare class ComponentRegistry {
+    /** 组件映射表: type => ComponentDefinition */
+    private components;
+    /** 自定义分类定义 */
+    private categories;
+    /** 自定义适配器函数 */
+    private adapter?;
+    /**
+     * 创建组件注册表
+     *
+     * @param options - 初始化选项
+     */
+    constructor(options?: ComponentRegistryOptions);
+    /**
+     * 注册单个组件
+     *
+     * @param definition - 组件定义
+     * @param overwrite - 如果已存在是否覆盖 (默认: true)
+     */
+    register(definition: ComponentDefinition, overwrite?: boolean): void;
+    /**
+     * 批量注册组件
+     *
+     * @param definitions - 组件定义列表
+     * @param overwrite - 如果已存在是否覆盖
+     */
+    registerAll(definitions: ComponentDefinition[], overwrite?: boolean): void;
+    /**
+     * 注销组件
+     *
+     * @param type - 组件类型标识
+     * @returns 是否成功移除
+     */
+    unregister(type: string): boolean;
+    /**
+     * 根据类型获取组件定义
+     *
+     * @param type - 组件类型标识
+     * @returns 组件定义, 不存在返回 undefined
+     */
+    getByType(type: string): ComponentDefinition | undefined;
+    /**
+     * 获取所有组件的扁平列表
+     *
+     * @returns 所有已注册组件的数组
+     */
+    getAll(): ComponentDefinition[];
+    /**
+     * 获取组件映射表 (type => definition)
+     * 用于快速查找, 对应原版的 nodeComponents 对象
+     *
+     * @returns type => ComponentDefinition 的映射
+     */
+    getMap(): Record<string, ComponentDefinition>;
+    /**
+     * 获取按分类分组的组件列表
+     * 用于侧边栏渲染
+     *
+     * @returns 分组后的组件列表
+     */
+    getGroups(): ComponentGroup[];
+    /**
+     * 从后端 API 返回的原始数据加载组件
+     *
+     * 如果设置了自定义 adapter 则使用自定义逻辑，
+     * 否则使用内置的默认适配逻辑。
+     *
+     * @param rawData - 后端返回的原始组件数据
+     * @returns 分组后的组件列表
+     */
+    loadFromRawData(rawData: RawComponentData): ComponentGroup[];
+    /**
+     * 注册自定义分类
+     *
+     * @param category - 分类标识
+     * @param info - 分类信息 (标签和颜色)
+     */
+    registerCategory(category: string, info: {
+        label: string;
+        color: string;
+    }): void;
+    /**
+     * 获取组件总数
+     */
+    get size(): number;
+    /**
+     * 检查组件是否已注册
+     *
+     * @param type - 组件类型标识
+     */
+    has(type: string): boolean;
+    /**
+     * 清空所有已注册组件
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ComponentRegistry.d.ts.map

package/dist/core/ComponentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ComponentRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,oBAAoB,CAAA;AAc3B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,iBAAiB;IAC5B,yCAAyC;IACzC,OAAO,CAAC,UAAU,CAA8C;IAChE,cAAc;IACd,OAAO,CAAC,UAAU,CAAkD;IACpE,eAAe;IACf,OAAO,CAAC,OAAO,CAAC,CAA8C;IAE9D;;;;OAIG;gBACS,OAAO,CAAC,EAAE,wBAAwB;IAU9C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,mBAAmB,EAAE,SAAS,UAAO,GAAG,IAAI;IAgBjE;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,mBAAmB,EAAE,EAAE,SAAS,UAAO,GAAG,IAAI;IAIvE;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIxD;;;;OAIG;IACH,MAAM,IAAI,mBAAmB,EAAE;IAI/B;;;;;OAKG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAQ7C;;;;;OAKG;IACH,SAAS,IAAI,cAAc,EAAE;IA8B7B;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,EAAE;IAgB5D;;;;;OAKG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACrC,IAAI;IAIP;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/DataAdapter.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @file DataAdapter.ts
+ * @description 数据格式转换器 — adapterIn / adapterOut
+ *
+ * 负责 RuleGo JSON 格式 <-> LogicFlow 内部格式 的双向转换。
+ *
+ * adapterIn:  RuleChainData → LogicFlowGraphData (用于渲染)
+ * adapterOut: LogicFlowGraphData → RuleChainData (用于保存)
+ *
+ * 这是原版 RuleGoEditor.vue 中最核心的业务逻辑之一，
+ * 从框架层抽取到 core 中后，Vue/React/原生 JS 都可以复用。
+ *
+ * @see RuleGoEditor.vue 的 lf.adapterIn 和 lf.adapterOut 方法
+ */
+import type { RuleChainData, RuleChainConfig, RuleNodeConfig, RuleConnectionConfig } from '../types/rule-chain';
+import type { ComponentDefinition } from '../types/component';
+import type { EditorInternalData } from '../types/editor';
+/**
+ * LogicFlow 节点数据
+ */
+export interface LFNodeData {
+    /** 节点 ID */
+    id: string;
+    /** 节点类型 (simple-node, start-node, chain-node, group-node) */
+    type: string;
+    /** X 坐标 */
+    x: number;
+    /** Y 坐标 */
+    y: number;
+    /** 节点显示文本 */
+    text?: string;
+    /** 节点属性 */
+    properties: {
+        /** RuleGo 节点配置 */
+        model?: RuleNodeConfig;
+        /** 组件视图定义 */
+        view?: ComponentDefinition;
+    };
+}
+/**
+ * LogicFlow 连接点数据
+ */
+export interface LFPoint {
+    x: number;
+    y: number;
+}
+/**
+ * LogicFlow 边数据
+ */
+export interface LFEdgeData {
+    /** 边 ID */
+    id: string;
+    /** 边类型 */
+    type: string;
+    /** 源节点 ID */
+    sourceNodeId: string;
+    /** 目标节点 ID */
+    targetNodeId: string;
+    /** 起点坐标 */
+    startPoint: LFPoint;
+    /** 终点坐标 */
+    endPoint: LFPoint;
+    /** 显示文本 */
+    text?: string;
+    /** 边属性 */
+    properties: {
+        /** 连接配置数据 */
+        model: Partial<RuleConnectionConfig> & Record<string, unknown>;
+    };
+}
+/**
+ * LogicFlow 图数据 (完整的画布数据)
+ */
+export interface LFGraphData {
+    /** 节点列表 */
+    nodes: LFNodeData[];
+    /** 边列表 */
+    edges: LFEdgeData[];
+}
+/**
+ * 数据格式转换器
+ * 实现 RuleGo JSON 与 LogicFlow 格式的双向转换
+ */
+export declare class DataAdapter {
+    /**
+     * 将 RuleGo 数据转换为 LogicFlow 格式 (用于渲染)
+     *
+     * 转换逻辑:
+     * 1. 添加固定的 Start 节点
+     * 2. 将 metadata.nodes 转换为 LF 节点 (带布局位置)
+     * 3. 根据 firstNodeIndex 创建 Start -> 第一个节点的边
+     * 4. 将 metadata.connections 转换为 LF 边 (合并同源同目标的多关系)
+     *
+     * @param userData - RuleGo 规则链 JSON 数据
+     * @param nodeComponents - 组件注册表 (type => definition)
+     * @param internalData - 编辑器内部运行时数据 (计数器等)
+     * @param options - 额外选项 (如起始坐标)
+     * @returns LogicFlow 格式的图数据
+     */
+    adapterIn(userData: RuleChainData, nodeComponents: Record<string, ComponentDefinition>, internalData: EditorInternalData, options: {
+        startX: number;
+        startY: number;
+    }): LFGraphData;
+    /**
+     * 将 LogicFlow 数据转换回 RuleGo 格式 (用于保存)
+     *
+     * 转换逻辑:
+     * 1. 遍历边, 过滤掉 Start 节点的出边, 将合并的关系类型拆分为多条连接
+     * 2. 遍历节点, 过滤掉 Start 节点, 更新布局信息
+     * 3. 确定第一个节点 (Start 节点连接的目标节点)
+     * 4. 组装 RuleChainData 返回
+     *
+     * @param logicFlowData - LogicFlow 的图数据
+     * @param ruleChain - 当前规则链配置
+     * @param internalData - 编辑器内部运行时数据
+     * @param getNodeModelById - 从 LogicFlow 获取节点 Model 的函数
+     * @returns RuleGo 规则链 JSON 数据
+     */
+    adapterOut(logicFlowData: LFGraphData, ruleChain: RuleChainConfig, internalData: EditorInternalData, getNodeModelById: (id: string) => LFNodeData | null): RuleChainData;
+    /**
+     * 根据 LogicFlow 节点 ID 查找对应的 RuleGo 自定义节点 ID
+     *
+     * @param lfNodeId - LogicFlow 内部节点 ID
+     * @param getNodeModelById - 获取节点数据的函数
+     * @returns 自定义节点 ID, 找不到返回空字符串
+     */
+    private lfNodeId2CustomNodeId;
+}
+//# sourceMappingURL=DataAdapter.d.ts.map

package/dist/core/DataAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataAdapter.d.ts","sourceRoot":"","sources":["../../src/core/DataAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,oBAAoB,EACrB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAOzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,CAAC,EAAE,MAAM,CAAA;IACT,WAAW;IACX,CAAC,EAAE,MAAM,CAAA;IACT,aAAa;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW;IACX,UAAU,EAAE;QACV,kBAAkB;QAClB,KAAK,CAAC,EAAE,cAAc,CAAA;QACtB,aAAa;QACb,IAAI,CAAC,EAAE,mBAAmB,CAAA;KAC3B,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,UAAU;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW;IACX,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW;IACX,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU;IACV,UAAU,EAAE;QACV,aAAa;QACb,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC/D,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,UAAU;IACV,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAMD;;;GAGG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CACP,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACnD,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC1C,WAAW;IA6Md;;;;;;;;;;;;;;OAcG;IACH,UAAU,CACR,aAAa,EAAE,WAAW,EAC1B,SAAS,EAAE,eAAe,EAC1B,YAAY,EAAE,kBAAkB,EAChC,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,GAClD,aAAa;IAkHhB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/core/EditorCore.d.ts

@@ -0,0 +1,251 @@
+/**
+ * @file core/EditorCore.ts
+ * @description 编辑器核心引擎 — 整合所有子系统的主入口
+ *
+ * EditorCore 是整个编辑器的中枢, 它:
+ * 1. 持有并协调所有子系统 (StateStore, EventBus, ComponentRegistry 等)
+ * 2. 管理 LogicFlow 实例的生命周期 (初始化 / 数据加载 / 事件桥接)
+ * 3. 提供统一的 API 供框架适配层 (Vue/React/原生 JS) 调用
+ * 4. 不包含任何框架特定代码 (无 Vue ref, 无 React useState)
+ *
+ * 框架适配层职责:
+ * - 将 EditorCore 的状态/事件桥接到框架的响应式系统
+ * - 渲染 UI 组件 (工具栏、侧边栏、属性面板)
+ * - 处理 DOM 挂载/卸载生命周期
+ *
+ * 使用方式 (原生 JS):
+ * ```typescript
+ * import { EditorCore } from '@huanban/rulego-editor-core'
+ *
+ * const editor = new EditorCore({
+ *   container: document.getElementById('editor'),
+ *   url: 'http://127.0.0.1:9090',  // 通过 url 参数传入实际地址
+ * })
+ *
+ * // 初始化 (DOM 就绪后)
+ * editor.init(lfInstance)
+ *
+ * // 加载规则链数据
+ * editor.loadData(ruleChainData)
+ *
+ * // 导出数据
+ * const data = editor.exportData(lfGraphData, getNodeModelById)
+ *
+ * // 监听事件
+ * editor.on('node:click', (data) => { ... })
+ *
+ * // 销毁
+ * editor.destroy()
+ * ```
+ *
+ * 使用方式 (Vue 适配层):
+ * ```typescript
+ * // 在 @huanban/editor-vue 的 composable 中
+ * import { EditorCore } from '@huanban/rulego-editor-core'
+ *
+ * export function useEditorCore(options) {
+ *   const core = new EditorCore(options)
+ *   // 将 core.store 桥接到 Vue 的 reactive/ref
+ *   // 将 core.eventBus 桥接到 Vue 的 emit
+ *   return core
+ * }
+ * ```
+ *
+ * @see StateStore 状态管理
+ * @see EventBus 事件总线
+ * @see ComponentRegistry 组件注册表
+ * @see DataAdapter 数据格式转换
+ * @see HistoryManager 撤销/重做
+ * @see ValidationEngine 图验证
+ * @see ThemeManager 主题管理
+ * @see I18nManager 国际化
+ *
+ * @see 原版 RuleGoEditor.vue — 所有 initLf / save / deleteSelects 逻辑的来源
+ */
+import { StateStore } from './StateStore';
+import { EventBus } from './EventBus';
+import { DataAdapter } from './DataAdapter';
+import type { LFGraphData, LFNodeData } from './DataAdapter';
+import { ComponentRegistry } from './ComponentRegistry';
+import { HistoryManager } from './HistoryManager';
+import { ValidationEngine } from './ValidationEngine';
+import { ThemeManager } from './ThemeManager';
+import { I18nManager } from './I18nManager';
+import type { EditorOptions, EditorInternalData, EditorPlugin } from '../types/editor';
+import type { EditorEventMap, EditorEventName } from '../types/events';
+import type { RuleChainData, RuleChainConfig, RuleNodeConfig, RuleConnectionConfig } from '../types/rule-chain';
+import type { ComponentDefinition, ComponentGroup } from '../types/component';
+/**
+ * 编辑器内部使用的状态结构
+ *
+ * 使用 Record<string, unknown> 兼容的形式,
+ * 区别于 types/editor.ts 中严格的 EditorState 接口。
+ * 严格类型由框架适配层在包装时保证。
+ */
+interface CoreState extends Record<string, unknown> {
+    /** 编辑器是否已就绪 */
+    isReady: boolean;
+    /** 数据是否已修改 (有未保存的更改) */
+    isDirty: boolean;
+    /** 是否正在加载 */
+    isLoading: boolean;
+    /** 当前选中的节点数据 */
+    selectedNode: RuleNodeConfig | null;
+    /** 当前选中的边数据 */
+    selectedEdge: RuleConnectionConfig | null;
+    /** 规则链配置 */
+    ruleChain: RuleChainConfig | null;
+    /** 组件注册表 (type => definition 映射) */
+    nodeComponents: Record<string, ComponentDefinition>;
+    /** 按分类分组的组件列表 */
+    componentGroups: ComponentGroup[];
+    /** 当前正在编辑的节点视图定义 */
+    currentNodeView: ComponentDefinition | null;
+    /** 当前正在编辑的节点配置数据 */
+    currentNodeModel: Record<string, unknown>;
+    /** 当前正在编辑的边配置数据 */
+    currentEdgeModel: Record<string, unknown>;
+    /** 是否可以撤销 */
+    canUndo: boolean;
+    /** 是否可以重做 */
+    canRedo: boolean;
+}
+/**
+ * 编辑器核心引擎
+ *
+ * 生命周期:
+ * 1. constructor    — 创建所有子系统
+ * 2. init()         — 初始化 LogicFlow, 加载组件, 注册事件
+ * 3. loadData()     — 加载规则链数据并渲染
+ * 4. exportData()   — 从画布导出数据
+ * 5. destroy()      — 销毁所有资源
+ */
+export declare class EditorCore {
+    /** 状态容器 — 编辑器的全局状态 */
+    readonly store: StateStore<CoreState>;
+    /** 事件总线 — 编辑器级别的事件 */
+    readonly eventBus: EventBus;
+    /** 数据适配器 — RuleGo JSON ↔ LogicFlow 格式转换 */
+    readonly dataAdapter: DataAdapter;
+    /** 组件注册表 — 管理可用的节点组件 */
+    readonly componentRegistry: ComponentRegistry;
+    /** 历史管理器 — 撤销/重做 */
+    readonly history: HistoryManager;
+    /** 验证引擎 — 图合法性检查 */
+    readonly validation: ValidationEngine;
+    /** 主题管理器 — 多主题切换 */
+    readonly theme: ThemeManager;
+    /** 国际化 — 多语言支持 */
+    readonly i18n: I18nManager;
+    /** 编辑器配置选项 */
+    private options;
+    /** 内部运行时数据 (计数器、常量配置等) */
+    private internalData;
+    /** LogicFlow 实例引用 (由外部传入或在 init 时创建) */
+    private lfInstance;
+    /** 已安装的插件列表 */
+    private plugins;
+    /** 是否已初始化 */
+    private initialized;
+    /**
+     * 创建编辑器核心实例
+     *
+     * @param options - 编辑器配置选项
+     * @see EditorOptions 完整的配置说明
+     */
+    constructor(options: EditorOptions);
+    /**
+     * 初始化编辑器
+     *
+     * 这个方法在 DOM 容器准备好之后调用 (框架适配层的 mounted/useEffect 中)。
+     * 它负责:
+     * 1. 保存 LogicFlow 实例引用
+     * 2. 应用初始主题
+     * 3. 通知插件
+     * 4. 触发 editor:ready 事件
+     *
+     * @param lfInstance - 外部创建的 LogicFlow 实例 (可选)
+     */
+    init(lfInstance?: unknown): void;
+    /**
+     * 销毁编辑器, 释放所有资源
+     *
+     * 必须在组件卸载时调用 (框架适配层的 unmounted/useEffect cleanup 中)
+     */
+    destroy(): void;
+    /**
+     * 加载规则链数据并渲染到画布
+     *
+     * 转换流程:
+     * RuleChainData → DataAdapter.adapterIn → LogicFlow.render
+     *
+     * @param ruleChainData - RuleGo 规则链 JSON 数据
+     * @see DataAdapter.adapterIn 数据转换详情
+     */
+    loadData(ruleChainData: RuleChainData): void;
+    /**
+     * 从画布导出 RuleGo 格式数据 (用于保存)
+     *
+     * 转换流程:
+     * LogicFlow.getGraphData → DataAdapter.adapterOut → RuleChainData
+     *
+     * @param lfGraphData - LogicFlow 当前图数据
+     * @param getNodeModelById - LogicFlow 节点查询函数
+     * @returns RuleGo 格式的规则链数据
+     * @see DataAdapter.adapterOut 数据转换详情
+     */
+    exportData(lfGraphData: LFGraphData, getNodeModelById: (id: string) => LFNodeData | null): RuleChainData;
+    /**
+     * 验证当前图数据
+     *
+     * @param lfGraphData - LogicFlow 当前图数据
+     * @returns 验证结果
+     * @see ValidationEngine.validate
+     */
+    validateGraph(lfGraphData: LFGraphData): import("./ValidationEngine").ValidationResult;
+    /**
+     * 监听编辑器事件
+     *
+     * @param event - 事件名
+     * @param handler - 事件处理函数
+     * @returns 取消监听函数
+     * @see EditorEventMap 所有可监听事件及其载荷类型
+     */
+    on<K extends EditorEventName>(event: K, handler: (payload: EditorEventMap[K]) => void): () => void;
+    /**
+     * 触发编辑器事件
+     *
+     * @param event - 事件名
+     * @param args - 事件载荷
+     */
+    emit<K extends EditorEventName>(event: K, ...args: EditorEventMap[K] extends void ? [] : [EditorEventMap[K]]): void;
+    /**
+     * 安装插件
+     *
+     * 插件可以在编辑器生命周期的各个阶段注入自定义逻辑:
+     * - onInit: 编辑器初始化后
+     * - beforeDataLoad: 数据加载前 (可修改数据)
+     * - beforeDataSave: 数据保存前 (可修改数据)
+     * - onDestroy: 编辑器销毁前
+     *
+     * @param plugin - 插件实例
+     * @see EditorPlugin 插件接口
+     */
+    use(plugin: EditorPlugin): void;
+    /**
+     * 获取内部运行时数据 (只读)
+     * 主要供 DataAdapter 和框架适配层使用
+     */
+    getInternalData(): Readonly<EditorInternalData>;
+    /**
+     * 获取 LogicFlow 实例引用
+     * 供框架适配层在需要直接操作 LogicFlow 时使用
+     */
+    getLfInstance(): unknown;
+    /**
+     * 获取编辑器配置选项
+     */
+    getOptions(): Readonly<EditorOptions>;
+}
+export {};
+//# sourceMappingURL=EditorCore.d.ts.map

package/dist/core/EditorCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditorCore.d.ts","sourceRoot":"","sources":["../../src/core/EditorCore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACb,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAU7E;;;;;;GAMG;AACH,UAAU,SAAU,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjD,eAAe;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,gBAAgB;IAChB,YAAY,EAAE,cAAc,GAAG,IAAI,CAAA;IACnC,eAAe;IACf,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACzC,YAAY;IACZ,SAAS,EAAE,eAAe,GAAG,IAAI,CAAA;IACjC,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IACnD,iBAAiB;IACjB,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC,oBAAoB;IACpB,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC3C,oBAAoB;IACpB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,mBAAmB;IACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,aAAa;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa;IACb,OAAO,EAAE,OAAO,CAAA;CACjB;AAoCD;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IACrC,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,wBAAwB;IACxB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,oBAAoB;IACpB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAE1B,cAAc;IACd,OAAO,CAAC,OAAO,CAAe;IAC9B,0BAA0B;IAC1B,OAAO,CAAC,YAAY,CAAoB;IACxC,wCAAwC;IACxC,OAAO,CAAC,UAAU,CAAgB;IAClC,eAAe;IACf,OAAO,CAAC,OAAO,CAAqB;IACpC,aAAa;IACb,OAAO,CAAC,WAAW,CAAQ;IAE3B;;;;;OAKG;gBACS,OAAO,EAAE,aAAa;IAkDlC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI;IAuChC;;;;OAIG;IACH,OAAO,IAAI,IAAI;IA6Bf;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IA+B5C;;;;;;;;;;OAUG;IACH,UAAU,CACR,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,GAClD,aAAa;IAchB;;;;;;OAMG;IACH,aAAa,CAAC,WAAW,EAAE,WAAW;IAUtC;;;;;;;OAOG;IACH,EAAE,CAAC,CAAC,SAAS,eAAe,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAC5C,MAAM,IAAI;IAIb;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,eAAe,EAC5B,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACjE,IAAI;IAQP;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAkB/B;;;OAGG;IACH,eAAe,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAI/C;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,aAAa,CAAC;CAGtC"}

package/dist/core/EventBus.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @file EventBus.ts
+ * @description 类型安全的事件总线
+ *
+ * 基于 EditorEventMap 提供强类型的事件发布/订阅。
+ * 与 LogicFlow 的 eventCenter 分工:
+ * - LogicFlow eventCenter: 处理画布级别的原生事件 (node:click, edge:add 等)
+ * - EventBus: 处理编辑器业务级别的事件 (editor:save, history:change 等)
+ *
+ * 特性:
+ * - 强类型: 事件名和负载类型在编译期绑定
+ * - 一次性监听: once() 方法只触发一次
+ * - 安全清理: destroy() 清除所有监听器
+ * - 调试模式: 可选事件追踪日志
+ */
+import type { EditorEventMap, EditorEventName } from '../types/events';
+/**
+ * 事件监听器函数类型
+ */
+type Listener<T> = (payload: T) => void;
+/**
+ * 类型安全的事件总线
+ *
+ * @example
+ * ```typescript
+ * const bus = new EventBus()
+ *
+ * // 订阅事件 (有类型提示)
+ * bus.on('node:click', (payload) => {
+ *   // payload 的类型自动推断为 NodeEventPayload
+ *   console.log(payload.id, payload.type)
+ * })
+ *
+ * // 触发事件
+ * bus.emit('node:click', { id: 'node_1', type: 'simple-node', ... })
+ *
+ * // 取消订阅
+ * const off = bus.on('editor:save', handler)
+ * off() // 取消
+ * ```
+ */
+export declare class EventBus {
+    /** 事件监听器映射: 事件名 => 监听器列表 */
+    private listeners;
+    /** 是否启用调试模式 */
+    private debug;
+    /**
+     * 创建事件总线
+     * @param debug - 是否启用调试日志 (默认: false)
+     */
+    constructor(debug?: boolean);
+    /**
+     * 订阅事件
+     *
+     * @param event - 事件名称
+     * @param callback - 事件回调函数
+     * @returns 取消订阅的函数
+     */
+    on<E extends EditorEventName>(event: E, callback: Listener<EditorEventMap[E]>): () => void;
+    /**
+     * 一次性订阅事件 (只触发一次后自动取消)
+     *
+     * @param event - 事件名称
+     * @param callback - 事件回调函数
+     * @returns 取消订阅的函数
+     */
+    once<E extends EditorEventName>(event: E, callback: Listener<EditorEventMap[E]>): () => void;
+    /**
+     * 取消订阅事件
+     *
+     * @param event - 事件名称
+     * @param callback - 要移除的回调函数
+     */
+    off<E extends EditorEventName>(event: E, callback: Listener<EditorEventMap[E]>): void;
+    /**
+     * 触发事件，通知所有订阅者
+     *
+     * @param event - 事件名称
+     * @param payload - 事件负载数据
+     */
+    emit<E extends EditorEventName>(event: E, ...args: EditorEventMap[E] extends void ? [] : [EditorEventMap[E]]): void;
+    /**
+     * 移除指定事件的所有监听器
+     *
+     * @param event - 事件名称 (不传则移除所有事件的监听器)
+     */
+    removeAll(event?: EditorEventName): void;
+    /**
+     * 获取指定事件的监听器数量 (用于调试)
+     *
+     * @param event - 事件名称
+     * @returns 监听器数量
+     */
+    listenerCount(event: EditorEventName): number;
+    /**
+     * 销毁事件总线, 清除所有监听器
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/core/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/core/EventBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtE;;GAEG;AACH,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AAYvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,QAAQ;IACnB,4BAA4B;IAC5B,OAAO,CAAC,SAAS,CAAmD;IACpE,eAAe;IACf,OAAO,CAAC,KAAK,CAAS;IAEtB;;;OAGG;gBACS,KAAK,UAAQ;IAIzB;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,eAAe,EAC1B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACpC,MAAM,IAAI;IAiBb;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,SAAS,eAAe,EAC5B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACpC,MAAM,IAAI;IAgBb;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,eAAe,EAC3B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACpC,IAAI;IAiBP;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,eAAe,EAC5B,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACjE,IAAI;IA0CP;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI;IAQxC;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAI7C;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}