@huanban/rulego-editor-core 1.0.0

package/dist/standalone/logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * logger.ts
+ * =========
+ * 功能：编辑器统一调试日志工具
+ *
+ * 提供带模块前缀的日志输出，通过全局开关控制是否输出。
+ * 默认关闭，可通过以下方式开启：
+ * 1. 编辑器初始化时设置 opts.debug = true
+ * 2. 运行时调用 setDebug(true)
+ * 3. URL 参数 ?debug=1
+ * 4. localStorage 设置 huanban_debug = '1'
+ */
+/**
+ * 设置调试模式开关
+ * @param enabled - true 开启调试日志, false 关闭
+ */
+export declare function setDebug(enabled: boolean): void;
+/**
+ * 获取当前调试模式状态
+ * @returns 是否开启调试日志
+ */
+export declare function isDebug(): boolean;
+/**
+ * 输出调试日志 — 仅在 debug 模式下输出
+ * @param module - 模块名称，会作为前缀 [module]
+ * @param args - 日志内容（与 console.log 参数一致）
+ *
+ * @example
+ * ```ts
+ * debugLog('custom-nodes', 'simple-node 注册成功')
+ * // 输出: [custom-nodes] simple-node 注册成功
+ * ```
+ */
+export declare function debugLog(module: string, ...args: any[]): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/standalone/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/standalone/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkCH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAG7D"}

package/dist/standalone/node-definitions.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @file standalone/node-definitions.ts
+ * @description 节点组件的分类配置 + 国际化适配器
+ *
+ * 【架构说明】
+ * - 分类配置 (CATEGORY_CONFIG) — 定义各分类的背景色，用于侧边栏渲染
+ * - 分类排序 (CATEGORY_ORDER) — 定义分类在侧边栏 / 管理列表中的显示顺序
+ * - 分类路径映射 (CATEGORY_PATH_MAP) — 将 github.com/... 长路径映射到简短分类键
+ * - 分类工具函数 (getCategoryKey / getCategoryConfig) — 提取和获取分类信息
+ * - 国际化适配器 (adapterComponentsLocal) — 将 fallback 翻译应用到组件上
+ *
+ * 组件的本地化数据 (DEFAULT_NODE_VIEWS) 已拆分到 node-views-data.ts:
+ * - 这些数据是**备用默认值**（源自原版 local_zh.js）
+ * - 生产环境中，组件定义应由后端 API 动态返回
+ * - 仅在 API 数据缺少 label/desc 时作为 fallback
+ *
+ * 使用方式:
+ *   import { CATEGORY_CONFIG, getCategoryKey, getCategoryConfig, adapterComponentsLocal } from './node-definitions'
+ *   import { DEFAULT_NODE_VIEWS } from './node-views-data'  // 需要数据时直接引入
+ */
+export { DEFAULT_NODE_VIEWS } from './node-views-data';
+/** 分类颜色映射（label 通过 i18n 动态获取） */
+export declare const CATEGORY_CONFIG: Record<string, {
+    bg: string;
+}>;
+/**
+ * 分类在侧边栏 / 管理列表中的显示顺序
+ * 不在此列表中的分类会排到末尾（按字母序）
+ *
+ * 顺序: 输入端 → 公共 → 过滤器 → 转换器 → 动作
+ *       → 外部集成 → AI → CI/CD → IoT → 子规则链
+ *       → 流式计算 → 文件 → 自定义
+ */
+export declare const CATEGORY_ORDER: ReadonlyArray<string>;
+/**
+ * 长路径分类映射 — 将 github.com/... 等长路径映射到简短分类名
+ * 用于 getCategoryKey() 函数提取分类键
+ */
+export declare const CATEGORY_PATH_MAP: Record<string, string>;
+/**
+ * 从原始 category 字符串提取分类键
+ * - 普通分类: 'external/file' → 'external'
+ * - 长路径:   'github.com/rulego/rulego-components-ai/ai/action' → 'ai'
+ * - stats:    'stats/streamsql' → 'stats'
+ * - endpoint: 'endpoint/fasthttp' → 'endpoint'
+ *
+ * @param rawCat - 原始分类字符串
+ * @returns 标准化的分类键
+ */
+export declare function getCategoryKey(rawCat: string): string;
+/**
+ * 获取分类配置 (未知分类用默认色 #86B4E5FF)
+ * @param cat - 分类键
+ * @returns 分类配置对象 { bg: 颜色 }
+ */
+export declare function getCategoryConfig(cat: string): {
+    bg: string;
+};
+/**
+ * 组件国际化适配器
+ * 将 fallback 翻译数据应用到组件对象上。
+ *
+ * 工作流程:
+ * 1. 后端 API 返回组件数据（包含 type、fields 等）
+ * 2. 本函数检查 DEFAULT_NODE_VIEWS 中是否有对应类型的翻译
+ * 3. 如有，则覆盖组件的 label、desc、icon
+ * 4. 同时递归处理字段级别的翻译（fields 和嵌套 struct 子字段）
+ *
+ * @param component - 从 API 获取的组件数据
+ * @param customViews - 可选，外部传入的自定义本地化定义，优先于默认值
+ *                      调用方可传入自己的翻译字典来覆盖内置默认值
+ */
+export declare function adapterComponentsLocal(component: any, customViews?: Record<string, any>): void;
+//# sourceMappingURL=node-definitions.d.ts.map

package/dist/standalone/node-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-definitions.d.ts","sourceRoot":"","sources":["../../src/standalone/node-definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAMtD,iCAAiC;AACjC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAgB1D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,MAAM,CAchD,CAAA;AAMD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMpD,CAAA;AAMD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM;QAxFM,MAAM;EA0FxD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CA6B9F"}

package/dist/standalone/node-views-data.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file standalone/node-views-data.ts
+ * @description 节点组件本地化默认值 — 纯数据字典
+ *
+ * 【重要说明】
+ * 这些数据是**备用默认值**，主要用于：
+ * 1. API 未返回组件 label/desc 时的 fallback 显示
+ * 2. 离线模式下的基本功能支持
+ * 3. 开发调试时的快速预览
+ *
+ * 生产环境中，组件定义应由后端 API 动态返回，
+ * 编辑器会优先使用 API 数据，仅在缺失时回退到本文件中的定义。
+ *
+ * 按分类拆分为多个子对象，最终合并导出为 DEFAULT_NODE_VIEWS。
+ */
+/**
+ * 组件本地化默认值 — 合并所有分类的数据
+ * 按分类拆分后通过展开运算符合并
+ */
+export declare const DEFAULT_NODE_VIEWS: Record<string, any>;
+//# sourceMappingURL=node-views-data.d.ts.map

package/dist/standalone/node-views-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-views-data.d.ts","sourceRoot":"","sources":["../../src/standalone/node-views-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA8xBH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAYlD,CAAA"}

package/dist/standalone/themes.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file standalone/themes.ts
+ * @description 编辑器主题定义 — 通过 CSS 自定义属性实现多风格切换
+ *
+ * 每个主题定义一组 CSS 变量值，覆盖编辑器的颜色、圆角、阴影等视觉属性。
+ * 通过在根元素上设置 data-theme="xxx" 来切换主题。
+ *
+ * 支持的主题：
+ * - default: 默认亮色（经典蓝白）
+ * - dark: 暗夜模式（深色背景，高对比度）
+ * - nature: 自然绿（温暖舒适）
+ * - elegant: 优雅紫（精致优雅）
+ * - tech: 科技蓝（未来感）
+ *
+ * @example
+ * ```ts
+ * import { THEME_PRESETS, getThemeCSS } from './themes'
+ *
+ * // 获取所有主题的 CSS 变量定义
+ * const css = getThemeCSS()
+ * ```
+ */
+/** 单个主题的变量定义 */
+export interface ThemeVars {
+    /** 主题显示名称（中文） */
+    label: string;
+    /** 主题显示名称（英文） */
+    labelEn: string;
+    /** CSS 自定义属性键值对 */
+    vars: Record<string, string>;
+}
+/**
+ * 预设主题集合
+ * key 为主题标识，对应 data-theme 属性值
+ */
+export declare const THEME_PRESETS: Record<string, ThemeVars>;
+/**
+ * 生成所有主题的 CSS 变量定义字符串
+ * 使用 [data-theme="xxx"] 选择器区分不同主题
+ * 默认主题同时作为 :root 级别的 fallback
+ *
+ * @returns 完整的 CSS 变量定义文本
+ */
+export declare function getThemeCSS(): string;
+/**
+ * 获取主题列表（用于 UI 展示）
+ * @param locale 当前语言
+ * @returns 主题选项数组
+ */
+export declare function getThemeList(locale: string): Array<{
+    id: string;
+    label: string;
+}>;
+//# sourceMappingURL=themes.d.ts.map

package/dist/standalone/themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../src/standalone/themes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,gBAAgB;AAChB,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAmRnD,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAgBpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAMjF"}

package/dist/types/component.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @file component.ts
+ * @description 组件定义类型 - 描述编辑器中可使用的节点组件
+ *
+ * 组件定义包含组件的类型、分类、表单字段、关系类型等信息。
+ * 这些定义来源于后端 API (/api/v1/components) 或内置的默认配置。
+ *
+ * 组件通过 ComponentRegistry 注册到编辑器中，
+ * 在侧边栏中按分类分组展示，用户可以拖拽到画布上创建节点。
+ */
+/**
+ * 字段验证规则
+ */
+export interface FieldValidation {
+    /** 是否必填 */
+    required?: boolean;
+    /** 字符串最小长度 */
+    minLength?: number;
+    /** 字符串最大长度 */
+    maxLength?: number;
+    /** 正则表达式验证 */
+    pattern?: string;
+    /** 验证失败提示消息 */
+    message?: string;
+}
+/**
+ * 组件的表单字段定义
+ * 用于动态生成节点属性编辑表单
+ */
+export interface ComponentField {
+    /** 字段名称 (对应 configuration 中的 key) */
+    name: string;
+    /** 字段类型 (string, int, bool, select, code 等) */
+    type: string;
+    /** 默认值 */
+    defaultValue: unknown;
+    /** 显示标签 */
+    label: string;
+    /** 字段描述/提示文本 */
+    desc: string;
+    /** 验证规则 (字符串格式, 旧版兼容; 或 FieldValidation 对象) */
+    validate: string | FieldValidation;
+    /** 嵌套子字段 (用于复合类型) */
+    fields: ComponentField[] | null;
+    /** 下拉选项列表 (当 type 为 select 时) */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/**
+ * 组件分类常量
+ */
+export type ComponentCategory = 'filter' | 'transform' | 'action' | 'external' | 'flow' | string;
+/**
+ * 单个组件的完整定义
+ * 描述一个可在编辑器中使用的节点类型
+ *
+ * @example
+ * ```json
+ * {
+ *   "type": "jsFilter",
+ *   "category": "filter",
+ *   "label": "JS过滤器",
+ *   "desc": "使用 JavaScript 过滤消息",
+ *   "icon": "filter-icon",
+ *   "fields": [...],
+ *   "relationTypes": ["True", "False", "Failure"]
+ * }
+ * ```
+ */
+export interface ComponentDefinition {
+    /** 组件类型标识 (唯一, 如 jsFilter, restApiCall) */
+    type: string;
+    /** 所属分类 */
+    category: ComponentCategory;
+    /** 显示标签 */
+    label: string;
+    /** 组件描述 */
+    desc: string;
+    /** 图标名称或路径 */
+    icon: string;
+    /** 表单字段列表 */
+    fields: ComponentField[] | null;
+    /** 允许的关系类型 (如 True/False/Success/Failure) */
+    relationTypes: string[];
+    /** 组件颜色 (可选, 用于自定义节点颜色) */
+    color?: string;
+}
+/**
+ * 组件分组
+ * 按分类组织的组件集合，用于侧边栏展示
+ */
+export interface ComponentGroup {
+    /** 分类标识 */
+    category: string;
+    /** 分类显示名称 */
+    label: string;
+    /** 分类颜色 */
+    color: string;
+    /** 分类图标 */
+    icon?: string;
+    /** 该分类下的组件列表 */
+    components: ComponentDefinition[];
+}
+/**
+ * 从后端 API 返回的原始组件数据
+ * 可能需要经过 adapterComponents 转换后才能使用
+ */
+export type RawComponentData = ComponentDefinition[];
+/**
+ * 组件注册表选项
+ */
+export interface ComponentRegistryOptions {
+    /** 初始组件列表 */
+    components?: ComponentDefinition[];
+    /** 自定义组件适配器 (将后端数据转为标准格式) */
+    adapter?: (data: RawComponentData) => ComponentGroup[];
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/types/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/types/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU;IACV,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAA;IAClC,qBAAqB;IACrB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAA;IAC/B,iCAAiC;IACjC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAMD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,UAAU,GACV,MAAM,GACN,MAAM,CAAA;AAEV;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAA;IAC/B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,UAAU,EAAE,mBAAmB,EAAE,CAAA;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa;IACb,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAClC,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,cAAc,EAAE,CAAA;CACvD"}

package/dist/types/editor.d.ts

@@ -0,0 +1,246 @@
+/**
+ * @file editor.ts
+ * @description 编辑器选项、状态和配置的类型定义
+ *
+ * 定义了编辑器初始化选项、运行时状态、工具栏配置、
+ * API 端点配置等核心类型。这些类型在 EditorCore 和各适配器中通用。
+ */
+import type { RuleChainConfig, RuleNodeConfig, RuleConnectionConfig, RuleChainData } from './rule-chain';
+import type { ComponentDefinition, ComponentGroup, RawComponentData } from './component';
+/**
+ * 后端 API 端点配置
+ * 支持 :id 和 :chainId 等路径参数替换
+ */
+export interface ApiEndpoints {
+    /** 组件列表接口 (默认: /api/v1/components) */
+    componentsApi: string;
+    /** 规则链保存/加载接口 (默认: /api/v1/rule/:id) */
+    ruleApi: string;
+    /** 调试数据接口 (默认: /api/v1/event/debug) */
+    debugDataApi: string;
+    /** 消息发送接口 (默认: /api/v1/msg/:chainId/:msgType) */
+    msgApi: string;
+}
+/**
+ * 通用 HTTP 请求配置
+ * 统一所有 API 调用的请求行为
+ */
+export interface RequestConfig {
+    /** 后端 API 基础 URL (默认: http://127.0.0.1:9090) */
+    baseUrl: string;
+    /** 请求超时时间 (毫秒, 默认: 8000) */
+    timeout: number;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+    /** 自定义 fetch 实现 (可用于注入认证 token 等) */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * 工具栏按钮显示配置
+ */
+export interface ToolbarConfig {
+    /** 显示测试按钮 */
+    showTest: boolean;
+    /** 显示新建/打开按钮 */
+    showNewOrOpen: boolean;
+    /** 显示数据查看按钮 */
+    showData: boolean;
+    /** 显示设置按钮 */
+    showSetting: boolean;
+    /** 显示文档按钮 */
+    showDoc: boolean;
+    /** 显示全屏按钮 */
+    showFullScreen: boolean;
+    /** 显示保存按钮 */
+    showSave: boolean;
+    /** 显示重置按钮 */
+    showReset: boolean;
+    /** 显示删除按钮 */
+    showDelete: boolean;
+}
+/**
+ * 画布网格配置
+ */
+export interface GridConfig {
+    /** 是否显示网格 */
+    visible: boolean;
+    /** 网格类型 (mesh 或 dot) */
+    type: 'mesh' | 'dot';
+    /** 网格大小 */
+    size: number;
+    /** 网格颜色配置 */
+    config: {
+        color: string;
+    };
+}
+/**
+ * 编辑器初始化选项
+ * 创建编辑器实例时传入，合并默认值后使用
+ */
+export interface EditorOptions {
+    /** 编辑器挂载的 DOM 容器 (CSS 选择器或 HTMLElement) */
+    container?: string | HTMLElement;
+    /** 后端 API 基础 URL */
+    url?: string;
+    /** API 端点配置 */
+    endpoints?: Partial<ApiEndpoints>;
+    /** HTTP 请求配置 */
+    request?: Partial<RequestConfig>;
+    /** 工具栏配置 */
+    toolbar?: Partial<ToolbarConfig>;
+    /** 画布网格配置 */
+    grid?: Partial<GridConfig>;
+    /** 起始节点的 X 坐标 (默认: 280) */
+    startX?: number;
+    /** 起始节点的 Y 坐标 (默认: 280) */
+    startY?: number;
+    /** 预加载的组件列表 (如果提供则不从 API 加载) */
+    components?: ComponentDefinition[];
+    /** 组件列表格式转换函数 */
+    adapterComponents?: (data: RawComponentData) => ComponentGroup[];
+    /** 初始规则链数据 (如果提供则直接渲染) */
+    data?: RuleChainData;
+    /** 初始规则链配置 */
+    ruleChain?: RuleChainConfig;
+    /** 是否为 headless 模式 (不渲染内置 UI) */
+    headless?: boolean;
+    /** 是否允许编辑 (只读模式) */
+    readonly?: boolean;
+    /** 是否允许拖动画布 */
+    stopMoveGraph?: boolean;
+    /** 是否显示悬停轮廓 */
+    hoverOutline?: boolean;
+    /** 是否调整边 */
+    adjustEdge?: boolean;
+    /** 是否调整边的起终点 */
+    adjustEdgeStartAndEnd?: boolean;
+    /** 是否允许双击编辑文本 */
+    textEdit?: boolean;
+    /** 撤销/重做最大步数 (默认: 50) */
+    maxHistory?: number;
+    /** 语言 (默认: zh-CN) */
+    locale?: string;
+    /** 自定义 ID 生成器 */
+    idGenerator?: (type: string) => string;
+    /** 主题名称 (内置: 'light' | 'dark' | 'blue', 也可传入自定义主题名) */
+    theme?: string;
+    /** 编辑器插件列表 */
+    plugins?: EditorPlugin[];
+}
+/**
+ * 面板显示状态枚举
+ */
+export type PanelType = 'none' | 'node-add' | 'node-edit' | 'edge-add' | 'edge-edit';
+/**
+ * 编辑器运行时状态
+ * 由 StateStore 管理，供 UI 层订阅消费
+ */
+export interface EditorState {
+    /** 编辑器是否已就绪 */
+    isReady: boolean;
+    /** 数据是否已修改 (有未保存的更改) */
+    isDirty: boolean;
+    /** 是否正在加载 */
+    isLoading: boolean;
+    /** 当前选中的节点数据 */
+    selectedNode: RuleNodeConfig | null;
+    /** 当前选中的边数据 */
+    selectedEdge: RuleConnectionConfig | null;
+    /** 当前活跃的面板类型 */
+    activePanel: PanelType;
+    /** 规则链配置 */
+    ruleChain: RuleChainConfig;
+    /** 组件注册表 (type => definition 映射) */
+    nodeComponents: Record<string, ComponentDefinition>;
+    /** 按分类分组的组件列表 */
+    componentGroups: ComponentGroup[];
+    /** 当前正在编辑的节点视图定义 (对应的 ComponentDefinition) */
+    currentNodeView: ComponentDefinition | null;
+    /** 当前正在编辑的节点配置数据 */
+    currentNodeModel: Record<string, unknown>;
+    /** 当前正在编辑的边配置数据 */
+    currentEdgeModel: Record<string, unknown>;
+    /** 是否可以撤销 */
+    canUndo: boolean;
+    /** 是否可以重做 */
+    canRedo: boolean;
+}
+/**
+ * 编辑器插件接口
+ *
+ * 用于扩展编辑器功能。插件可以在编辑器的各个生命周期阶段注入自定义逻辑。
+ *
+ * 钩子方法说明:
+ * - onInit: 编辑器实例初始化后调用 (DOM 已挂载)
+ * - onDestroy: 编辑器销毁前调用 (用于清理资源)
+ * - beforeDataLoad: 数据加载前调用 (可修改原始数据)
+ * - beforeDataSave: 数据保存前调用 (可修改导出数据)
+ * - beforeNodeAdd: 节点添加前调用 (返回 false 阻止添加)
+ * - beforeEdgeAdd: 边添加前调用 (返回 false 阻止添加)
+ *
+ * @example
+ * ```typescript
+ * const debugPlugin: EditorPlugin = {
+ *   name: 'debug',
+ *   onInit(editor) {
+ *     console.log('编辑器已初始化')
+ *   },
+ *   beforeDataSave(data) {
+ *     console.log('保存前数据:', data)
+ *     return data
+ *   },
+ * }
+ * ```
+ *
+ * @see EditorCore.use() 安装插件
+ */
+export interface EditorPlugin {
+    /** 插件名称 (唯一标识) */
+    name: string;
+    /** 插件优先级 (数字越小越先执行, 默认: 100) */
+    priority?: number;
+    /** 编辑器初始化后的回调 (此时 DOM 已挂载, LogicFlow 已就绪) */
+    onInit?(editor: unknown): void;
+    /** 编辑器销毁前的回调 (用于清理插件注册的资源) */
+    onDestroy?(editor: unknown): void;
+    /** 数据加载前回调 (可修改原始数据后返回) */
+    beforeDataLoad?(data: RuleChainData): RuleChainData;
+    /** 数据保存前回调 (可修改导出数据后返回) */
+    beforeDataSave?(data: RuleChainData): RuleChainData;
+    /** 节点添加前回调 (返回 false 阻止添加) */
+    beforeNodeAdd?(node: RuleNodeConfig): boolean | void;
+    /** 边添加前回调 (返回 false 阻止添加) */
+    beforeEdgeAdd?(edge: RuleConnectionConfig): boolean | void;
+    /**
+     * UI 渲染钩子 (可选)
+     * 用于向编辑器的特定区域注入自定义 UI 元素
+     * 每个函数接收对应区域的容器 HTMLElement
+     */
+    ui?: {
+        /** 侧边栏区域注入 */
+        sidebar?: (container: HTMLElement) => void;
+        /** 工具栏区域注入 */
+        toolbar?: (container: HTMLElement) => void;
+        /** 属性面板区域注入 */
+        panel?: (container: HTMLElement) => void;
+    };
+}
+/**
+ * 编辑器内部运行时数据
+ * 对应原版 initData 对象
+ */
+export interface EditorInternalData {
+    /** 节点计数器 (用于生成节点 ID) */
+    nodeCount: number;
+    /** 边计数器 (用于生成边 ID) */
+    edgeCount: number;
+    /** 起始节点的固定 ID */
+    startNodeId: string;
+    /** 节点默认宽度 */
+    nodeWidth: number;
+    /** 关系类型分隔符 (多关系合并显示时用 '/' 连接, 如 'True/False') */
+    relationTypeSplit: string;
+    /** 当前正在复制的节点 ID (用于 Ctrl+C / Ctrl+V, 默认空字符串) */
+    currentCloneNodeId?: string;
+}
+//# sourceMappingURL=editor.d.ts.map

package/dist/types/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/types/editor.ts"],"names":[],"mappings":"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"}