@huanban/rulego-editor-core 1.3.18 → 1.4.0

package/dist/core/HistoryManager.d.ts

@@ -1,166 +1,43 @@
-/**
- * @file HistoryManager.ts
- * @description 基于 Command 模式的撤销/重做系统
- *
- * 实现完整的 Undo/Redo 功能，核心概念:
- * - Command: 封装一个可执行和可撤销的操作
- * - UndoStack: 记录已执行的命令
- * - RedoStack: 记录已撤销的命令
- * - BatchCommand: 将多个命令组合为一个原子操作
- *
- * 原版编辑器通过 LogicFlow 的 history:change 事件维护 undos/redos 数组,
- * 这里改为独立的 HistoryManager 以支持更细粒度的操作控制。
- */
-/**
- * 命令接口
- * 每个可撤销的操作都实现此接口
- */
 export interface Command {
-    /** 执行操作 */
     execute(): void;
-    /** 撤销操作 */
     undo(): void;
-    /** 操作描述 (用于调试和 UI 提示) */
     description: string;
 }
-/**
- * 历史记录变更回调
- */
 type HistoryChangeCallback = (state: {
     canUndo: boolean;
     canRedo: boolean;
     undoCount: number;
     redoCount: number;
 }) => void;
-/**
- * 撤销/重做管理器
- *
- * @example
- * ```typescript
- * const history = new HistoryManager({ maxHistory: 50 })
- *
- * // 监听变更
- * history.onChange((state) => {
- *   updateUndoButton(state.canUndo)
- *   updateRedoButton(state.canRedo)
- * })
- *
- * // 执行命令
- * history.execute(new AddNodeCommand(editor, nodeData))
- *
- * // 撤销
- * history.undo()
- *
- * // 重做
- * history.redo()
- * ```
- */
 export declare class HistoryManager {
-    /** 撤销栈 (最近执行的命令在顶部) */
     private undoStack;
-    /** 重做栈 (最近撤销的命令在顶部) */
     private redoStack;
-    /** 最大历史记录数 */
     private maxHistory;
-    /** 变更回调列表 */
     private changeCallbacks;
-    /** 是否暂停记录 (批量操作时使用) */
     private paused;
-    /**
-     * 创建历史管理器
-     *
-     * @param options - 配置选项
-     * @param options.maxHistory - 最大历史记录数 (默认: 50)
-     */
     constructor(options?: {
         maxHistory?: number;
     });
-    /**
-     * 执行一个命令并记录到撤销栈
-     *
-     * 执行新命令后会清空重做栈 (与所有编辑器的标准行为一致)
-     *
-     * @param command - 要执行的命令
-     */
     execute(command: Command): void;
-    /**
-     * 撤销最近的命令
-     *
-     * @returns 是否成功撤销
-     */
     undo(): boolean;
-    /**
-     * 重做最近撤销的命令
-     *
-     * @returns 是否成功重做
-     */
     redo(): boolean;
-    /**
-     * 是否可以撤销
-     */
     canUndo(): boolean;
-    /**
-     * 是否可以重做
-     */
     canRedo(): boolean;
-    /**
-     * 获取撤销栈中的命令描述列表 (用于调试/UI显示)
-     */
     getUndoDescriptions(): string[];
-    /**
-     * 获取重做栈中的命令描述列表
-     */
     getRedoDescriptions(): string[];
-    /**
-     * 批量执行多个命令 (作为一个原子操作记录)
-     *
-     * 在批量执行期间暂停单独记录, 执行完成后创建 BatchCommand 统一记录
-     *
-     * @param commands - 要执行的命令列表
-     * @param description - 批量操作描述
-     */
     executeBatch(commands: Command[], description: string): void;
-    /**
-     * 监听历史记录变更
-     *
-     * @param callback - 变更回调
-     * @returns 取消监听的函数
-     */
     onChange(callback: HistoryChangeCallback): () => void;
-    /**
-     * 清空所有历史记录
-     */
     clear(): void;
-    /**
-     * 暂停历史记录 (执行一些不需要撤销的操作时)
-     */
     pause(): void;
-    /**
-     * 恢复历史记录
-     */
     resume(): void;
-    /**
-     * 销毁管理器
-     */
     destroy(): void;
-    /**
-     * 通知所有监听器状态变更
-     */
     private notifyChange;
 }
-/**
- * 批量命令 - 将多个命令组合为一个原子操作
- */
 export declare class BatchCommand implements Command {
-    /** 子命令列表 */
     private commands;
-    /** 批量操作描述 */
     description: string;
     constructor(commands: Command[], description: string);
-    /** 按顺序执行所有子命令 */
     execute(): void;
-    /** 按逆序撤销所有子命令 */
     undo(): void;
 }
 export {};
-//# sourceMappingURL=HistoryManager.d.ts.map

package/dist/core/I18nManager.d.ts

@@ -1,148 +1,28 @@
-/**
- * @file I18nManager.ts
- * @description 国际化管理器 — 多语言支持
- *
- * 轻量级的 i18n 实现, 基于嵌套对象路径查找。
- * 支持:
- * - 多语言包注册
- * - 动态切换语言
- * - 路径式 key 查找 (如 'sidebar.search', 'category.filter')
- * - 变量插值 (如 'hello {{name}}')
- * - 回退语言 (找不到翻译时用回退语言)
- *
- * 框架适配层可以将其桥接到 vue-i18n 或 react-intl 等框架级方案。
- */
-/**
- * 语言包类型 (支持嵌套)
- */
 export type LocaleMessages = Record<string, string | Record<string, unknown>>;
-/**
- * 可提供翻译能力的对象或函数。
- *
- * I18nManager.t 在缺少 key 时会返回 key 本身；UI 代码需要区分“真实翻译”
- * 和“缺失 key”，否则 `t(key) || fallback` 这类写法永远不会触发 fallback。
- */
 export type TranslationSource = {
     t?: (key: string, params?: Record<string, string | number>) => string;
 } | ((key: string, params?: Record<string, string | number>) => string) | null | undefined;
-/**
- * 获取带 fallback 的翻译文本。
- *
- * @param source - I18nManager、带 t 方法的对象，或翻译函数
- * @param key - 翻译 key
- * @param fallback - 缺少翻译时使用的文本
- * @param params - 插值变量
- */
 export declare function i18nText(source: TranslationSource, key: string, fallback: string, params?: Record<string, string | number>): string;
-/**
- * 语言变更回调
- */
 type LocaleChangeCallback = (locale: string) => void;
-/**
- * 国际化管理器
- *
- * @example
- * ```typescript
- * const i18n = new I18nManager({ locale: 'zh-CN', fallback: 'en-US' })
- *
- * // 注册语言包
- * i18n.register('zh-CN', {
- *   sidebar: {
- *     search: '搜索组件...',
- *     title: '组件列表',
- *   },
- *   category: {
- *     filter: '过滤器',
- *     transform: '转换器',
- *   }
- * })
- *
- * // 翻译
- * i18n.t('sidebar.search')  // => '搜索组件...'
- * i18n.t('category.filter') // => '过滤器'
- *
- * // 变量插值
- * i18n.t('hello', { name: 'World' }) // => 'Hello World'
- * ```
- */
 export declare class I18nManager {
-    /** 当前语言 */
     private locale;
-    /** 回退语言 */
     private fallback;
-    /** 已注册的语言包: locale => messages */
     private messages;
-    /** 语言变更回调 */
     private changeCallbacks;
-    /**
-     * 创建国际化管理器
-     *
-     * @param options - 配置选项
-     */
     constructor(options?: {
         locale?: string;
         fallback?: string;
     });
-    /**
-     * 注册语言包
-     *
-     * @param locale - 语言标识 (如 zh-CN, en-US)
-     * @param messages - 语言包内容 (支持嵌套对象)
-     * @param merge - 是否与已有语言包合并 (默认: true)
-     */
     register(locale: string, messages: LocaleMessages, merge?: boolean): void;
-    /**
-     * 获取翻译文本
-     *
-     * @param key - 翻译 key (支持点分路径, 如 'sidebar.search')
-     * @param params - 插值变量
-     * @returns 翻译后的文本, 找不到返回 key 本身
-     */
     t(key: string, params?: Record<string, string | number>): string;
-    /**
-     * 切换语言
-     *
-     * @param locale - 目标语言
-     */
     setLocale(locale: string): void;
-    /**
-     * 获取当前语言
-     */
     getLocale(): string;
-    /**
-     * 获取所有已注册的语言列表
-     */
     getAvailableLocales(): string[];
-    /**
-     * 监听语言变更
-     *
-     * @param callback - 变更回调
-     * @returns 取消监听函数
-     */
     onLocaleChange(callback: LocaleChangeCallback): () => void;
-    /**
-     * 检查是否存在某个 key 的翻译
-     *
-     * @param key - 翻译 key
-     * @param locale - 指定语言 (默认: 当前语言)
-     */
     has(key: string, locale?: string): boolean;
-    /**
-     * 销毁
-     */
     destroy(): void;
-    /**
-     * 从语言包中按路径查找翻译
-     */
     private lookup;
-    /**
-     * 变量插值: 将 {{key}} 替换为对应值
-     */
     private interpolate;
-    /**
-     * 深合并两个对象
-     */
     private deepMerge;
 }
 export {};
-//# sourceMappingURL=I18nManager.d.ts.map

package/dist/core/Optimizations.d.ts

@@ -1,16 +1,2 @@
-/**
- * @file Optimizations.ts
- * @description 针对 LogicFlow 在复杂编排场景下（大批量算子重绘）的性能优化策略及内存泄漏防护。
- */
 import LogicFlow from '@logicflow/core';
-/**
- * 彻底销毁 LogicFlow 实例，阻断由于闭包引起的内存泄漏
- *
- * 核心优化：
- * 官方的 RuleGoEditor 在生命周期销毁时仅调用了 `lf.destroy()`。
- * 若在单页应用 (Vue/React) 中频繁切换路由，底层的 Mouse/Keyboard Listener 可能未被彻底释放。
- *
- * @param lf 实例
- */
 export declare const destroyEditor: (lf: LogicFlow | null) => void;
-//# sourceMappingURL=Optimizations.d.ts.map

package/dist/core/OptionSourceRegistry.d.ts

@@ -0,0 +1,38 @@
+import type { ComponentField, ComponentFieldOption } from '../types/component';
+export interface OptionSourceContext {
+    field: ComponentField;
+    configuration: Record<string, unknown>;
+    currentNodeId?: string;
+    graphNodes?: Array<{
+        id: string;
+        name?: string;
+        type?: string;
+    }>;
+    query?: string;
+    params?: Record<string, unknown>;
+    signal?: AbortSignal;
+    [key: string]: unknown;
+}
+export interface OptionSourceResolveContext {
+    configuration: Record<string, unknown>;
+    currentNodeId?: string;
+    graphNodes?: Array<{
+        id: string;
+        name?: string;
+        type?: string;
+    }>;
+    query?: string;
+    signal?: AbortSignal;
+    [key: string]: unknown;
+}
+export type OptionSourceResolver = (context: OptionSourceContext) => ComponentFieldOption[] | Promise<ComponentFieldOption[]>;
+export declare function buildOptionSourceRequestKey(fields: ComponentField[], context: OptionSourceResolveContext): string;
+export declare class OptionSourceRegistry {
+    private resolvers;
+    constructor();
+    register(name: string, resolver: OptionSourceResolver, overwrite?: boolean): void;
+    unregister(name: string): boolean;
+    has(name: string): boolean;
+    resolve(field: ComponentField, context: OptionSourceResolveContext): Promise<ComponentFieldOption[]>;
+    clear(): void;
+}

package/dist/core/RuleChainChatManager.d.ts

@@ -1,53 +1,16 @@
-/**
- * @file RuleChainChatManager.ts
- * @description 管理 AI 对话窗口状态，支持多规则链开窗的隔离状态
- */
-/**
- * 聊天消息实体接口
- * @interface ChatMessage
- */
 export interface ChatMessage {
-    /** 消息发送方角色 */
     role: 'user' | 'assistant';
-    /** 消息文本内容 */
     content: string;
-    /** 发送时间戳 (毫秒) */
     timestamp: number;
 }
-/**
- * AI Copilot 对话管理器
- *
- * @class RuleChainChatManager
- * @description 负责集中化管理 AI 对话面板的状态。
- * 该管理器支持多个规则链各自持有独立的对话历史（通过 ruleChainId 隔离隔离）。
- * 底层利用 `localStorage` 自动落盘，刷新页面对话状态不丢失。
- */
 export declare class RuleChainChatManager {
     private chatStates;
     private storagePrefix;
-    /**
-     * 构造函数：初始化时自动恢复历史状态
-     */
     constructor();
-    /**
-     * 获取指定规则链的全部聊天记录
-     * @param ruleChainId 规则链唯一标识
-     * @returns 聊天记录数组
-     */
     getMessages(ruleChainId: string): ChatMessage[];
-    /**
-     * 向指定规则链对话追加一条消息
-     * @param ruleChainId 规则链唯一标识
-     * @param message 消息实体对象
-     */
     addMessage(ruleChainId: string, message: ChatMessage): void;
-    /**
-     * 清除指定规则链的聊天记录 (包括本地存储)
-     * @param ruleChainId 规则链唯一标识
-     */
     clear(ruleChainId: string): void;
     private saveState;
     private restoreAll;
 }
 export declare const ruleChainChatManager: RuleChainChatManager;
-//# sourceMappingURL=RuleChainChatManager.d.ts.map

package/dist/core/RuleChainValidator.d.ts

@@ -1,103 +1,24 @@
-/**
- * @file core/RuleChainValidator.ts
- * @description 规则链校验器 — 保存前检测配置问题，防止后台运行时报错
- *
- * 校验内容：
- * 1. 关联值校验 — 引用的节点ID是否存在
- *    - for/while 的 do 字段
- *    - groupFilter/groupAction 的 nodeIds 字段
- * 2. 必填项校验 — 关键配置是否缺失
- *    - switch 至少一个 case
- *    - for 需要 range 和 do
- *    - while 需要 condition 和 do
- *    - groupFilter/groupAction 需要 nodeIds
- * 3. 连接校验 — 锚点方向是否正确
- *    - chain-node (end/break) 不应有输出连接
- *    - start-node 必须连接到首个节点
- *
- * 使用方式：
- *   import { RuleChainValidator } from './RuleChainValidator'
- *   const result = RuleChainValidator.validate(ruleChainData)
- *   if (!result.valid) { ... result.warnings / result.errors ... }
- */
 import type { RuleChainData } from '../types/rule-chain';
-/** 校验问题的严重级别 */
 export type IssueSeverity = 'error' | 'warning';
-/** 单条校验问题 */
 export interface ValidationIssue {
-    /** 严重级别 */
     severity: IssueSeverity;
-    /** 关联的节点 ID (可选) */
     nodeId?: string;
-    /** 节点名称 (可选，方便展示) */
     nodeName?: string;
-    /** 节点类型 */
     nodeType?: string;
-    /** 问题描述 */
     message: string;
-    /** 问题分类 */
     category: 'missing_config' | 'invalid_reference' | 'connection' | 'deprecated';
 }
-/** 校验结果 */
 export interface ValidationResult {
-    /** 是否通过校验 (无 error 级别问题) */
     valid: boolean;
-    /** 所有问题列表 */
     issues: ValidationIssue[];
-    /** 便捷访问: 仅 error 级别 */
     errors: ValidationIssue[];
-    /** 便捷访问: 仅 warning 级别 */
     warnings: ValidationIssue[];
 }
-/**
- * 规则链校验器
- * 在保存/导出前检测配置问题，提前发现后台运行时会报错的情况
- */
 export declare class RuleChainValidator {
-    /**
-     * 校验完整的规则链数据
-     * @param data - RuleGo 规则链 JSON 数据
-     * @returns 校验结果
-     */
     static validate(data: RuleChainData): ValidationResult;
-    /**
-     * 校验单个节点的配置
-     * @param node - 节点配置
-     * @param nodeIdSet - 所有节点 ID 集合
-     * @param issues - 问题列表 (会被修改)
-     */
     private static _validateNode;
-    /**
-     * 校验节点引用是否有效
-     * 支持 "nodeId" 直接引用和 "chain:chainId" 外部链引用
-     *
-     * @param refValue - 引用值
-     * @param node - 当前节点
-     * @param field - 字段名
-     * @param nodeIdSet - 节点 ID 集合
-     * @param issues - 问题列表
-     */
     private static _validateNodeRef;
-    /**
-     * 校验连接的合理性
-     * @param connections - 连接列表
-     * @param nodes - 节点列表
-     * @param nodeIdSet - 节点 ID 集合
-     * @param issues - 问题列表
-     */
     private static _validateConnections;
-    /**
-     * 校验首节点配置
-     * @param data - 规则链数据
-     * @param nodeIdSet - 节点 ID 集合
-     * @param issues - 问题列表
-     */
     private static _validateFirstNode;
-    /**
-     * 解析 nodeIds — 支持逗号分隔字符串或数组
-     * @param nodeIds - 原始值
-     * @returns 节点 ID 列表
-     */
     private static _parseNodeIds;
 }
-//# sourceMappingURL=RuleChainValidator.d.ts.map

package/dist/core/StateStore.d.ts

@@ -1,160 +1,24 @@
-/**
- * @file StateStore.ts
- * @description 框架无关的响应式状态容器
- *
- * 设计灵感来自 zustand/vanilla 和 nanostores。
- * 提供发布-订阅模式的状态管理，支持:
- * - 部分状态更新 (partial update)
- * - 选择性订阅 (selector subscription, 只在特定字段变化时通知)
- * - 快照获取 (get snapshot)
- * - 自动清理 (unsubscribe 返回值模式)
- *
- * 各框架适配器可以包装为:
- * - Vue: ref()/watch() 响应式
- * - React: useSyncExternalStore() hook
- * - 原生 JS: 直接 subscribe 回调
- *
- * @example
- * ```typescript
- * const store = new StateStore<EditorState>(initialState)
- *
- * // 订阅全部状态变化
- * const unsubscribe = store.subscribe((state, prevState) => {
- *   console.log('状态变更:', state)
- * })
- *
- * // 选择性订阅
- * const nodeSelector = store.select(s => s.selectedNode)
- * nodeSelector.subscribe((node) => {
- *   console.log('选中节点变化:', node)
- * })
- *
- * // 更新状态
- * store.setState({ selectedNode: someNode })
- *
- * // 函数式更新
- * store.setState(prev => ({ isDirty: !prev.isDirty }))
- * ```
- */
-/**
- * 状态变更监听器类型
- * @param state - 新状态
- * @param prevState - 旧状态
- */
 type StateListener<T> = (state: T, prevState: T) => void;
-/**
- * 选择器返回的订阅句柄
- */
 interface SelectorHandle<S> {
-    /** 获取当前选中值 */
     get: () => S;
-    /** 订阅选中值的变化 */
     subscribe: (listener: (value: S, prevValue: S) => void) => () => void;
 }
-/**
- * 框架无关的响应式状态容器
- *
- * @typeParam T - 状态对象的类型
- */
 export declare class StateStore<T extends Record<string, unknown>> {
-    /** 当前状态 (内部可变) */
     private state;
-    /** 全量订阅的监听器集合 */
     private listeners;
-    /** 状态变更版本号 (用于 React useSyncExternalStore 等对比场景) */
     private version;
-    /**
-     * 创建状态容器
-     * @param initialState - 初始状态对象
-     */
+    private batchDepth;
+    private batchPrevState;
+    private batchStartVersion;
     constructor(initialState: T);
-    /**
-     * 获取当前状态的只读快照
-     *
-     * 注意: 返回的是浅冻结对象，不应直接修改属性。
-     * 修改状态只能通过 setState 方法。
-     *
-     * @returns 当前状态的只读引用
-     */
     getState(): Readonly<T>;
-    /**
-     * 获取当前版本号
-     * 每次 setState 调用版本号 +1，用于变更检测
-     *
-     * @returns 版本号
-     */
     getVersion(): number;
-    /**
-     * 更新状态 (支持部分更新和函数式更新)
-     *
-     * 部分更新: 传入一个 Partial<T> 对象，自动与现有状态合并
-     * 函数式更新: 传入一个函数，接收当前状态，返回需要更新的部分
-     *
-     * @param partial - 部分状态对象或更新函数
-     *
-     * @example
-     * ```typescript
-     * // 对象方式
-     * store.setState({ selectedNode: node, isDirty: true })
-     *
-     * // 函数方式 (适合依赖当前状态的更新)
-     * store.setState(prev => ({
-     *   nodeCount: prev.nodeCount + 1
-     * }))
-     * ```
-     */
     setState(partial: Partial<T> | ((prev: T) => Partial<T>)): void;
-    /**
-     * 批量更新状态 (只触发一次通知)
-     *
-     * 适用于需要同时修改多个状态但只想触发一次更新的场景
-     *
-     * @param updater - 更新函数，可多次调用 setState
-     */
     batch(updater: () => void): void;
-    /**
-     * 订阅状态变化
-     *
-     * @param listener - 状态变更回调函数
-     * @returns 取消订阅函数 (调用后停止接收通知)
-     */
+    private notify;
     subscribe(listener: StateListener<T>): () => void;
-    /**
-     * 选择性订阅 (只关注特定字段的变化)
-     *
-     * 通过 selector 函数提取状态的一个切片。
-     * 只有当该切片发生变化时才触发通知，减少不必要的 UI 更新。
-     *
-     * 使用浅比较 (===) 进行变更检测，
-     * 如果 selector 返回引用类型，需注意引用是否真正发生了变化。
-     *
-     * @param selector - 状态选择器函数
-     * @returns 包含 get 和 subscribe 的句柄
-     *
-     * @example
-     * ```typescript
-     * const nodeHandle = store.select(s => s.selectedNode)
-     *
-     * // 获取当前值
-     * console.log(nodeHandle.get())
-     *
-     * // 只在 selectedNode 变化时收到通知
-     * nodeHandle.subscribe((node, prevNode) => {
-     *   console.log('节点变化:', prevNode, '->', node)
-     * })
-     * ```
-     */
     select<S>(selector: (state: T) => S): SelectorHandle<S>;
-    /**
-     * 重置状态为指定值 (全量替换)
-     *
-     * @param newState - 新的完整状态
-     */
     reset(newState: T): void;
-    /**
-     * 销毁状态容器，清除所有监听器
-     */
     destroy(): void;
 }
 export {};
-//# sourceMappingURL=StateStore.d.ts.map