@huanban/rulego-editor-core 1.0.0

package/dist/core/ValidationEngine.d.ts

@@ -0,0 +1,139 @@
+/**
+ * @file ValidationEngine.ts
+ * @description 图验证引擎 — 验证规则链的合法性
+ *
+ * 提供可扩展的验证规则系统:
+ * - 内置验证规则 (孤立节点检测、起始连接检查等)
+ * - 自定义验证规则注册
+ * - 保存前自动验证
+ *
+ * 验证结果包含错误列表，每个错误关联到具体的节点或边，
+ * 方便 UI 层高亮显示问题元素。
+ */
+import type { LFGraphData } from './DataAdapter';
+/**
+ * 验证错误
+ */
+export interface ValidationError {
+    /** 规则名称 */
+    rule: string;
+    /** 错误级别 */
+    level: 'error' | 'warning' | 'info';
+    /** 错误消息 */
+    message: string;
+    /** 关联的元素 ID (节点或边) */
+    elementId?: string;
+    /** 关联的元素类型 */
+    elementType?: 'node' | 'edge';
+}
+/**
+ * 验证结果
+ */
+export interface ValidationResult {
+    /** 是否验证通过 (无 error 级别错误) */
+    valid: boolean;
+    /** 错误列表 */
+    errors: ValidationError[];
+    /** 警告列表 */
+    warnings: ValidationError[];
+}
+/**
+ * 验证规则接口
+ */
+export interface ValidationRule {
+    /** 规则名称 (唯一标识) */
+    name: string;
+    /** 规则描述 */
+    description?: string;
+    /** 是否启用 (默认: true) */
+    enabled?: boolean;
+    /**
+     * 验证函数
+     *
+     * @param graphData - LogicFlow 图数据
+     * @param context - 验证上下文 (包含内部配置)
+     * @returns 验证错误列表
+     */
+    validate(graphData: LFGraphData, context: ValidationContext): ValidationError[];
+}
+/**
+ * 验证上下文 (传递给验证规则的额外信息)
+ */
+export interface ValidationContext {
+    /** 起始节点 ID */
+    startNodeId: string;
+}
+/**
+ * 图验证引擎
+ *
+ * @example
+ * ```typescript
+ * const engine = new ValidationEngine()
+ *
+ * // 使用内置规则
+ * engine.registerBuiltinRules()
+ *
+ * // 添加自定义规则
+ * engine.register({
+ *   name: 'max-nodes',
+ *   validate(data) {
+ *     if (data.nodes.length > 100) {
+ *       return [{ rule: 'max-nodes', level: 'warning', message: '节点数超过100' }]
+ *     }
+ *     return []
+ *   }
+ * })
+ *
+ * // 执行验证
+ * const result = engine.validate(graphData, { startNodeId: '$node_start_input' })
+ * if (!result.valid) {
+ *   console.error('验证失败:', result.errors)
+ * }
+ * ```
+ */
+export declare class ValidationEngine {
+    /** 已注册的验证规则 */
+    private rules;
+    /**
+     * 注册验证规则
+     *
+     * @param rule - 验证规则
+     * @param overwrite - 是否覆盖同名规则 (默认: true)
+     */
+    register(rule: ValidationRule, overwrite?: boolean): void;
+    /**
+     * 注销验证规则
+     *
+     * @param name - 规则名称
+     */
+    unregister(name: string): void;
+    /**
+     * 启用/禁用指定规则
+     */
+    setEnabled(name: string, enabled: boolean): void;
+    /**
+     * 注册所有内置验证规则
+     */
+    registerBuiltinRules(): void;
+    /**
+     * 执行验证
+     *
+     * @param graphData - LogicFlow 图数据
+     * @param context - 验证上下文
+     * @returns 验证结果
+     */
+    validate(graphData: LFGraphData, context: ValidationContext): ValidationResult;
+    /**
+     * 获取所有已注册规则的信息
+     */
+    getRules(): Array<{
+        name: string;
+        description?: string;
+        enabled: boolean;
+    }>;
+    /**
+     * 清空所有规则
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ValidationEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationEngine.d.ts","sourceRoot":"","sources":["../../src/core/ValidationEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAMhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,WAAW;IACX,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,OAAO,CAAA;IACd,WAAW;IACX,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,WAAW;IACX,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;OAMG;IACH,QAAQ,CACN,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,iBAAiB,GACzB,eAAe,EAAE,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc;IACd,WAAW,EAAE,MAAM,CAAA;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,gBAAgB;IAC3B,eAAe;IACf,OAAO,CAAC,KAAK,CAAyC;IAEtD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,UAAO,GAAG,IAAI;IAQtD;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOhD;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,QAAQ,CACN,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,iBAAiB,GACzB,gBAAgB;IAgCnB;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAQ3E;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file core/index.ts
+ * @description 核心模块统一导出入口
+ *
+ * 所有核心子系统均从此处导出:
+ * - StateStore: 框架无关的响应式状态容器
+ * - EventBus: 类型安全的事件总线
+ * - DataAdapter: RuleGo ↔ LogicFlow 数据格式转换
+ * - ComponentRegistry: 组件注册表
+ * - HistoryManager: 撤销/重做管理
+ * - ValidationEngine: 图验证引擎
+ * - ThemeManager: 主题切换管理
+ * - I18nManager: 国际化管理
+ * - EditorCore: 核心引擎 (整合以上所有子系统)
+ */
+export { StateStore } from './StateStore';
+export { EventBus } from './EventBus';
+export { DataAdapter } from './DataAdapter';
+export type { LFNodeData, LFEdgeData, LFGraphData, LFPoint } from './DataAdapter';
+export { ComponentRegistry } from './ComponentRegistry';
+export { HistoryManager, BatchCommand } from './HistoryManager';
+export type { Command } from './HistoryManager';
+export { ValidationEngine } from './ValidationEngine';
+export type { ValidationError, ValidationResult, ValidationRule, ValidationContext, } from './ValidationEngine';
+export { ThemeManager, THEME_LIGHT, THEME_DARK, THEME_BLUE } from './ThemeManager';
+export type { ThemeVariables, ThemeDefinition } from './ThemeManager';
+export { I18nManager } from './I18nManager';
+export type { LocaleMessages } from './I18nManager';
+export { EditorCore } from './EditorCore';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;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,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/D,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAClF,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}

package/dist/defaults/components.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file defaults/components.ts
+ * @description 内置组件定义 — 默认可用的节点类型
+ *
+ * 从原版 default.js 移植, 包含 RuleGo 标准的节点类型定义:
+ * - filter: 过滤器 (jsFilter, jsSwitch, fieldFilter, groupFilter, msgTypeSwitch)
+ * - transform: 转换器 (jsTransform)
+ * - action: 动作 (log, delay, restApiCall, sendMail, mqttClient,
+ *           dbClient, ssh, for, groupAction, delay)
+ * - external: 外部集成 (restApiCall, mqttClient, dbClient 等)
+ * - flow: 流程控制 (flow/子规则链)
+ *
+ * @see 原版: src/components/utils/default.js
+ */
+import type { ComponentDefinition } from '../types/component';
+/**
+ * RuleGo 默认内置组件列表
+ *
+ * 这些组件对应 RuleGo 后端支持的标准节点类型。
+ * 每个组件包含:
+ * - type: 节点类型标识
+ * - category: 所属分类
+ * - fields: 配置表单字段
+ * - label: 显示名称
+ * - desc: 描述
+ * - icon: 图标
+ * - relationTypes: 允许的关系类型
+ */
+export declare const defaultComponents: ComponentDefinition[];
+//# sourceMappingURL=components.d.ts.map

package/dist/defaults/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/defaults/components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,EAygBlD,CAAA"}

package/dist/defaults/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file defaults/index.ts
+ * @description 默认数据统一导出入口
+ *
+ * 导出项:
+ * - defaultComponents: 内置组件定义列表
+ * - localeZhCN: 中文语言包
+ * - localeEnUS: 英文语言包
+ *
+ * 使用方式:
+ * ```typescript
+ * import { defaultComponents, localeZhCN, localeEnUS } from '@huanban/rulego-editor-core'
+ * ```
+ */
+export { defaultComponents } from './components';
+export { localeZhCN } from './locale-zh-CN';
+export { localeEnUS } from './locale-en-US';
+//# sourceMappingURL=index.d.ts.map

package/dist/defaults/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/defaults/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/defaults/locale-en-US.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @file defaults/locale-en-US.ts
+ * @description 英文语言包 — 编辑器所有 UI 文本的英文翻译
+ *
+ * 与 locale-zh-CN.ts 结构完全对应, 提供英文版本。
+ * 作为默认的 fallback 语言使用。
+ *
+ * 使用方式:
+ * ```typescript
+ * import { localeEnUS, I18nManager } from '@huanban/rulego-editor-core'
+ *
+ * const i18n = new I18nManager({ locale: 'en-US', fallback: 'en-US' })
+ * i18n.register('en-US', localeEnUS)
+ * ```
+ *
+ * @see locale-zh-CN.ts 中文对照版本
+ * @see I18nManager 国际化管理器
+ */
+import type { LocaleMessages } from '../core/I18nManager';
+/**
+ * 英文语言包
+ *
+ * 结构与 localeZhCN 完全相同, 所有 key 一一对应
+ */
+export declare const localeEnUS: LocaleMessages;
+//# sourceMappingURL=locale-en-US.d.ts.map

package/dist/defaults/locale-en-US.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-en-US.d.ts","sourceRoot":"","sources":["../../src/defaults/locale-en-US.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,cA8hBxB,CAAA"}

package/dist/defaults/locale-zh-CN.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file defaults/locale-zh-CN.ts
+ * @description 中文语言包 — 编辑器所有 UI 文本的中文翻译
+ *
+ * 移植自原版 local_zh.js, 并扩展了编辑器 UI 层所需的所有文本。
+ * 原版仅包含组件名称和字段标签的映射, 这里增加了:
+ * - 编辑器 UI 文本 (工具栏、侧边栏、对话框等)
+ * - 验证消息
+ * - 操作提示
+ * - HuanbanRulegoEditor 弹窗/面板/状态栏文本
+ *
+ * 使用方式:
+ * ```typescript
+ * import { localeZhCN } from '@huanban/rulego-editor-core'
+ * import { I18nManager } from '@huanban/rulego-editor-core'
+ *
+ * const i18n = new I18nManager({ locale: 'zh-CN' })
+ * i18n.register('zh-CN', localeZhCN)
+ *
+ * // 使用翻译
+ * i18n.t('editor.toolbar.save')  // => '保存'
+ * i18n.t('components.jsFilter')  // => 'JS过滤器'
+ * ```
+ *
+ * @see 原版: src/components/utils/local_zh.js
+ * @see I18nManager 用于加载和查询翻译
+ */
+import type { LocaleMessages } from '../core/I18nManager';
+/**
+ * 中文语言包
+ *
+ * 结构说明:
+ * - editor.*     : 编辑器 UI 层文本 (工具栏、侧边栏、对话框、面板、状态栏)
+ * - components.* : 组件类型的中文名称 (type => 中文标签)
+ * - fields.*     : 组件字段的中文标签 (fieldName => 中文标签)
+ * - category.*   : 分类名称
+ * - validation.* : 验证提示消息
+ * - action.*     : 操作相关提示 (保存、删除、创建等)
+ */
+export declare const localeZhCN: LocaleMessages;
+//# sourceMappingURL=locale-zh-CN.d.ts.map

package/dist/defaults/locale-zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-zh-CN.d.ts","sourceRoot":"","sources":["../../src/defaults/locale-zh-CN.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,cA6jBxB,CAAA"}

package/dist/iconRegistry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 自动生成的图标注册表 — 所有 SVG 图标以 data URL 形式内联
+ * 生成时间: 2026-03-21 13:01:41
+ * 图标数量: 90
+ *
+ * 用法: import { ICON_REGISTRY } from './iconRegistry'
+ *       const url = ICON_REGISTRY['delay'] // => data:image/svg+xml;base64,...
+ */
+export declare const ICON_REGISTRY: Record<string, string>;
+/**
+ * 根据图标名称获取图标 URL
+ * @param name - 图标名称（不含 .svg 扩展名），如 'delay', 'action'
+ * @param fallbackPath - 找不到时的降级路径，如 'images/delay.svg'
+ * @returns data URL 或降级路径
+ */
+export declare function getIconUrl(name: string, fallbackPath?: string): string;
+//# sourceMappingURL=iconRegistry.d.ts.map

package/dist/iconRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconRegistry.d.ts","sourceRoot":"","sources":["../src/iconRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2FhD,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE"}