@huanban/rulego-editor-core 1.3.18 → 1.4.0

package/dist/standalone/editor-dialogs.d.ts

@@ -1,49 +1,32 @@
-/**
- * @file standalone/editor-dialogs.ts
- * @description 弹窗/面板模块 — 从 HuanbanRulegoEditor.ts 中提取
- *
- * 包含以下弹窗功能:
- * - 规则链选择器弹窗 (showRuleChainSelector)
- * - 导出 DSL 弹窗 (showExportDialog)
- * - 运行面板 Drawer (showRunPanel)
- * - 组件管理弹窗 (showComponentManage)
- *
- * 每个函数接收 editor 实例作为参数 (EditorContext 接口),
- * 避免与主类产生循环依赖。
- */
-/**
- * 弹窗模块需要访问的编辑器上下文接口
- * 使用接口而非直接引用 HuanbanRulegoEditor 类, 避免循环依赖
- */
+import { ApiProvider } from '../api/ApiProvider';
+import type { EditorTestCasesStore } from '../core/test-cases';
 export interface EditorContext {
-    /** LogicFlow 实例 */
     lf: any;
-    /** EditorCore 数据引擎实例 */
     core: any;
-    /** 编辑器配置选项 */
     opts: any;
-    /** 编辑器根容器 */
+    apiProvider?: ApiProvider;
+    serverStatus?: import('../core/server-status').ServerStatusStore;
+    capabilities?: import('../core/editor-capabilities').EditorCapabilities;
+    connectionStatus?: import('../core/connection-status').ConnectionStatusStore;
     rootEl?: HTMLElement;
-    /** 组件列表 */
+    _activeDrawerWrapper?: HTMLElement | null;
+    _activeModalWrapper?: HTMLElement | null;
     components: any[];
-    /** 侧边栏展开的分组集合 */
+    testCases?: EditorTestCasesStore;
     expandedGroups: Set<string>;
-    /** 节点组件映射 (类型 → 定义) */
     _nodeComponents: Record<string, any>;
-    /** 国际化翻译方法 */
     t(key: string, params?: Record<string, string>): string;
-    /** 导出当前画布数据 */
     exportData(): any;
-    /** 加载规则链数据 */
     loadData(data: any): void;
-    /** 渲染侧边栏 */
     renderSidebar(): void;
-    /** HTML 转义 */
     _escapeHtml(str: string): string;
-    /** 关闭 Drawer */
     _closeDrawer(): void;
-    /** 关闭 Modal */
     _closeModal(): void;
+    updateOptions?(patch: Record<string, unknown>): unknown;
+    reloadComponents?(options?: {
+        forceRefresh?: boolean;
+    }): Promise<boolean>;
+    acquireSharedConnectionStatuses?(): () => void;
 }
 export interface RunPanelOptions {
     fromNodeId?: string;
@@ -53,49 +36,16 @@ export interface RunPanelOptions {
     section?: string;
 }
 export type SettingsDialogTab = 'user' | 'setting' | 'ai' | 'skills';
+export type ComponentManageDialogTab = 'installed' | 'market' | 'dsl' | 'shared';
 export interface SettingsDialogOptions {
-    /** Keep the current drawer mounted while settings opens, avoiding canvas reflow flicker. */
     preserveDrawer?: boolean;
-    /** Open settings as fullscreen. Defaults to a large dialog. */
     fullscreen?: boolean;
 }
 export declare function normalizeComponentMarketItems(raw: unknown): any[];
 export declare function normalizeComponentsListItems(raw: unknown): any[];
-/**
- * 显示规则链选择器左侧抽屉 — 支持主链/子链 Tab、搜索、分页、远程 API。
- * 数据来源优先级: apiBase / rulesApi 真实后端 → opts.ruleItems 本地兜底。
- * @param ctx - 编辑器上下文
- */
 export declare function showRuleChainSelector(ctx: EditorContext): void;
-/**
- * 显示设置弹窗 — 对齐官方 SettingDialog 的账号设置、系统设置、AI 助手、全局技能入口。
- * 若宿主提供 onSettingsClick，则保持组件化 slot 能力，由宿主完全接管。
- */
 export declare function showSettingsDialog(ctx: EditorContext, initialTab?: SettingsDialogTab, options?: SettingsDialogOptions): void;
-/**
- * 显示导入 DSL 弹窗。
- * 支持文件选择、拖拽、粘贴 JSON，并复用与导出编辑一致的校验和 loadData 路径。
- */
 export declare function showImportDialog(ctx: EditorContext): void;
-/**
- * 显示导出 DSL 弹窗。
- * 支持下载 JSON、下载画布 PNG 截图、复制 JSON，以及编辑当前规则链 JSON 后应用到画布。
- * slot: onExportDSL 可劫持, 传入 { json, imageDataUrl }
- * @param ctx - 编辑器上下文
- */
 export declare function showExportDialog(ctx: EditorContext): void;
-/**
- * 显示运行面板
- * 可发送消息到规则链并查看响应
- * slot: onRunClick 可劫持
- * @param ctx - 编辑器上下文
- */
 export declare function showRunPanel(ctx: EditorContext, options?: RunPanelOptions): void;
-/**
- * 显示组件管理弹窗
- * 已安装列表 + 组件市场（搜索/安装）
- * slot: onComponentManage 可劫持
- * @param ctx - 编辑器上下文
- */
-export declare function showComponentManage(ctx: EditorContext): void;
-//# sourceMappingURL=editor-dialogs.d.ts.map
+export declare function showComponentManage(ctx: EditorContext, initialTab?: ComponentManageDialogTab): void;

package/dist/standalone/editor-events.d.ts

@@ -1,29 +1,2 @@
-/**
- * @file standalone/editor-events.ts
- * @description LogicFlow 事件桥接模块
- *
- * 从 HuanbanRulegoEditor 主文件中提取的事件桥接逻辑，
- * 负责将 LogicFlow 画布事件（节点点击/双击/添加/删除、边事件等）
- * 桥接到 EditorCore 事件总线和外部回调。
- *
- * @param editor - HuanbanRulegoEditor 实例引用
- */
 export { showEditorToast } from './editor-toast';
-/**
- * 桥接 LogicFlow 画布事件到 EditorCore + 外部回调
- *
- * 桥接的事件包括:
- * - editor:data-loaded → 渲染画布 + 自适应视图
- * - graph:transform → 隐藏节点操作菜单
- * - blank:click → 清除选中状态
- * - node:click → 显示快捷编辑条
- * - node:dbclick → 打开属性编辑 Drawer
- * - node:add / node:delete → 状态更新
- * - node:dnd-add → 拖拽添加节点
- * - edge:click / edge:add / edge:delete / edge:dbclick → 边事件
- * - node:drop → 更新布局信息
- *
- * @param editor - 编辑器实例 (需要含 lf / core / opts 等属性)
- */
 export declare function bridgeEvents(editor: any): () => void;
-//# sourceMappingURL=editor-events.d.ts.map

package/dist/standalone/editor-overlays.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentDefinition } from '../types/component';
+export interface NodePickerOpenOptions {
+    clientX?: number;
+    clientY?: number;
+    sourceNodeId?: string;
+    edgeId?: string;
+    excludeInputNodes?: boolean;
+    onSelect?: (component: ComponentDefinition, node: unknown) => void;
+}
+export declare function openCommandPalette(editor: any): void;
+export declare function openShortcutHelp(editor: any): void;
+export declare function openNodePicker(editor: any, options?: NodePickerOpenOptions): void;
+export declare function openComponentDocs(editor: any, initialType?: string): Promise<void>;
+export declare function closeSharedOverlay(editor: any): void;

package/dist/standalone/editor-property-drawers.d.ts

@@ -1,59 +1,27 @@
-/**
- * @file standalone/editor-property-drawers.ts
- * @description 属性编辑 Drawer 模块 — 从 HuanbanRulegoEditor.ts 中提取
- *
- * 包含以下功能:
- * - 节点属性编辑 Drawer (showNodePropertyDrawer) — 详情 / 调试日志 / 帮助 三个 Tab
- * - 边属性编辑 Drawer (showEdgePropertyDrawer) — 链接标签的 checkbox 或文本输入
- * - 调试日志渲染 (renderDebugTable / renderDebugTerminal / renderDebugEmpty)
- * - CodeMirror 6 代码编辑器集成 (JS/JSON/Lua 语法高亮+校验)
- *
- * 每个函数接收 editor 实例作为参数 (PropertyDrawerContext 接口),
- * 避免与主类产生循环依赖。
- */
-/**
- * 属性 Drawer 模块需要访问的编辑器上下文接口
- */
+import type { ServerStatus, ServerStatusState } from '../core/server-status';
 export interface PropertyDrawerContext {
-    /** LogicFlow 实例 */
     lf: any;
-    /** EditorCore 数据引擎实例 */
     core: any;
-    /** 编辑器配置选项 (需要 apiBase, showDebugLog 等) */
     opts: any;
-    /** 国际化翻译方法 */
+    serverStatus?: {
+        recordWebSocketStatus: (status: string, closeCode?: number | null, message?: string) => ServerStatus | void;
+        setReconnectAttempt?: (attempt: number) => unknown;
+        setServerStatus?: (status: ServerStatus, details?: Partial<ServerStatusState>) => unknown;
+    };
     t(key: string, params?: Record<string, string>): string;
-    /** HTML 转义工具方法 */
     _escapeHtml(str: string): string;
-    /** 关闭 Drawer */
+    _activeDrawerWrapper?: HTMLElement | null;
+    _activeModalWrapper?: HTMLElement | null;
     _closeDrawer(): void;
-    /** 标记画布存在未保存修改 */
+    _closeModal?(): void;
     _markDirty?(reason?: string): void;
-    /** 当前正在添加的节点 (可变状态, 供取消时删除) */
     _currentAddNode: any;
-    /** 当前正在添加的边 (可变状态, 供取消时删除) */
     _currentAddEdge: any;
+    _propertyOptionsController?: AbortController;
+    _propertyDrawerRequestGeneration?: number;
 }
-/**
- * 渲染调试日志 — 表格视图
- * @param ctx     - 编辑器上下文 (需要 t() 和 _escapeHtml())
- * @param wrapper - drawer 外层 DOM
- * @param items   - API 返回的日志条目数组
- */
 export declare function renderDebugTable(ctx: PropertyDrawerContext, wrapper: HTMLElement, items: any[]): void;
-/**
- * 渲染调试日志 — 终端视图
- * @param ctx     - 编辑器上下文
- * @param wrapper - drawer 外层 DOM
- * @param items   - API 返回的日志条目数组
- */
 export declare function renderDebugTerminal(ctx: PropertyDrawerContext, wrapper: HTMLElement, items: any[]): void;
-/**
- * 渲染调试日志空/错误状态
- * @param ctx     - 编辑器上下文
- * @param wrapper - drawer 外层 DOM
- * @param msg     - 显示的提示文本
- */
 export declare function renderDebugEmpty(_ctx: PropertyDrawerContext, wrapper: HTMLElement, msg: string): void;
 interface DebugLogPage {
     items: any[];
@@ -76,33 +44,7 @@ export interface NodeRelationSummarySection {
     title: string;
     rows: NodeRelationSummaryRow[];
 }
-/**
- * 构建节点详情页的关系/匹配协议摘要。画布渲染保持官方 GroupNode 简洁样式，
- * 复杂协议字段集中在 Drawer 中呈现，避免导出协议值和 UI 标签混淆。
- */
 export declare function buildNodeRelationSummary(model: any, nodeView: any, ctx?: PropertyDrawerContext): NodeRelationSummarySection[];
-/**
- * 显示节点属性编辑 Drawer — 照搬原版 NodePropertyDrawer.vue + NodePropertyForm.vue
- * 包含三个 Tab: 详情、调试日志、帮助
- * 支持字段类型: Boolean, map, array, jsScript, int, float, 普通文本
- *
- * @param ctx      - 编辑器上下文
- * @param model    - 节点的 model 数据
- * @param nodeView - 组件定义 (含 fields 字段描述)
- * @param fromAdd  - 是否从拖入/新增触发
- */
-export declare function showNodePropertyDrawer(ctx: PropertyDrawerContext, model: any, nodeView: any, fromAdd: boolean): void;
-/**
- * 显示边属性编辑 Drawer — 照搬原版 EdgePropertyDrawer.vue
- * 支持 relationTypes 多选标签 (如源节点定义了 relationTypes)
- *
- * @param ctx                - 编辑器上下文
- * @param edgeModel          - 边数据
- * @param sourceNodeView     - 源节点的组件定义 (含 relationTypes)
- * @param fromAdd            - 是否从新增触发
- * @param usedRelationTypes  - 已被同源节点其他边占用的 relationTypes (用于禁用下拉选项)
- * @param sourceNodeModel    - 源节点 RuleGo model，用于动态提取 cases/router 关系
- */
-export declare function showEdgePropertyDrawer(ctx: PropertyDrawerContext, edgeModel: any, sourceNodeView: any, fromAdd: boolean, usedRelationTypes?: string[], sourceNodeModel?: any): void;
+export declare function showNodePropertyDrawer(sourceContext: PropertyDrawerContext, model: any, nodeView: any, fromAdd: boolean): void;
+export declare function showEdgePropertyDrawer(sourceContext: PropertyDrawerContext, edgeModel: any, sourceNodeView: any, fromAdd: boolean, usedRelationTypes?: string[], sourceNodeModel?: any): void;
 export {};
-//# sourceMappingURL=editor-property-drawers.d.ts.map

package/dist/standalone/editor-route-settings.d.ts

@@ -1,51 +1,24 @@
-/**
- * @file standalone/editor-route-settings.ts
- * @description 端点/定时器节点的路由设置弹窗模块
- *
- * 功能概述:
- * - 提供居中弹窗 (Modal) 用于配置端点节点的路由器 (Routers)
- * - 根据端点类型 (nodeView.router) 动态渲染:
- *   · from.path: 标签/描述/必填/placeholder 由 router 配置决定
- *   · from.processors / to.processors: 可通过 hide 控制隐藏
- *   · endpoint/http: 额外显示 HTTP 方法下拉 和 "等待执行结果" 开关
- *   · endpoint/mcpServer: 额外显示 "工具描述" 和 "入参 JsonSchema"
- * - 处理器下拉列表从 /api/v1/components 的 builtins.endpoints 中获取
- * - 支持添加/编辑/删除多条路由规则 (表格 + 弹窗编辑表单)
- * - 数据存储在 endpoint config 的 routers[] 中
- *
- * 架构参考:
- *   线上版本的 RouterPropertyTable + RouterItemForm 两层结构
- *   - RouterPropertyTable: 路由列表表格，按 router 配置动态显示列
- *   - RouterItemForm: 编辑单条路由的弹窗表单
- *
- * @see node-views-data.ts 中 ENDPOINT_VIEWS 的 router 配置
- * @see editor-property-drawers.ts 节点属性 Drawer 中通过按钮触发本模块
- * @see DataAdapter.ts 数据适配器负责 routers/processors 的持久化
- */
 import type { PropertyDrawerContext } from './editor-property-drawers';
-/**
- * 路由条目的数据结构
- * 对应线上 RuleEndpointConfig.routers[] 中每一项
- */
 export interface RouterItem {
-    /** 唯一标识 */
     id?: string;
-    /** 来源配置: path 为触发路径/主题/cron 等 */
     from?: {
         path?: string;
         processors?: string[];
         [key: string]: unknown;
     };
-    /** 目标配置: path 为目标规则链, wait 为是否等待结果 */
     to?: {
         path?: string;
         processors?: string[];
         wait?: boolean;
         [key: string]: unknown;
     };
-    /** 附加参数: [0]=HTTP方法/MCP描述, [1]=MCP inputSchema 等 */
     params?: string[];
 }
+export interface RouteSettingsTabDraft {
+    readonly model: any;
+    snapshot(): RouterItem[];
+    applyTo(targetModel: any): void;
+}
 export interface RouteTableRenderOptions {
     nodeType: string;
     pathLabel: string;
@@ -70,29 +43,8 @@ export interface RouteTableRenderOptions {
 export declare function routePathPreviewPrefix(nodeType: string, params?: string[]): string;
 export declare function isReservedHuanbanWsPath(path: string): boolean;
 export declare function normalizeRouterItemForEndpoint(nodeType: string, routerItem: RouterItem): RouterItem;
+export declare function createRouteSettingsTabDraft(model: any): RouteSettingsTabDraft;
 export declare function renderRouteTableHeader(row: Element, options: RouteTableRenderOptions): void;
 export declare function renderRouteTableBody(tbody: Element, routers: RouterItem[], options: RouteTableRenderOptions, startIndex?: number): void;
-/**
- * 将路由设置内容渲染到指定的 Tab 容器中
- *
- * 与 showRouteSettingsModal 不同，此函数不创建弹窗 overlay，
- * 而是将路由列表表格直接渲染到传入的 DOM 容器中。
- * 编辑/新增单条路由时仍然使用弹窗 (showRouterItemForm)。
- *
- * @param ctx       - 编辑器上下文
- * @param model     - 当前端点节点的 model 数据
- * @param container - 路由设置 Tab 的 DOM 容器
- */
-export declare function renderRouteSettingsTabContent(ctx: PropertyDrawerContext, model: any, container: HTMLElement): Promise<void>;
-/**
- * 显示路由设置弹窗
- *
- * 实现架构 (参照线上 RouterPropertyTable + RouterItemForm):
- * 1. 主弹窗: 路由列表表格 + 新增/编辑/删除操作
- * 2. 编辑弹窗: 单条路由的表单编辑, 字段根据 router 配置动态渲染
- *
- * @param ctx   - 编辑器上下文 (PropertyDrawerContext)
- * @param model - 当前节点的 model 数据
- */
+export declare function renderRouteSettingsTabContent(ctx: PropertyDrawerContext, model: any, container: HTMLElement, draft?: RouteSettingsTabDraft, signal?: AbortSignal): Promise<void>;
 export declare function showRouteSettingsModal(ctx: PropertyDrawerContext, model: any): Promise<void>;
-//# sourceMappingURL=editor-route-settings.d.ts.map

package/dist/standalone/editor-sidebar.d.ts

@@ -1,14 +1,3 @@
-/**
- * @file standalone/editor-sidebar.ts
- * @description 侧边栏渲染模块 — Node-RED 风格的组件节点块列表
- *
- * 从 HuanbanRulegoEditor 主文件中提取的侧边栏渲染逻辑，包含:
- * - renderSidebar: 渲染分类分组的组件列表（支持搜索过滤）
- * - 分组折叠/展开交互
- * - 节点块拖拽到画布 (lf.dnd.startDrag)
- *
- * @param editor - HuanbanRulegoEditor 实例引用
- */
 import type { ComponentDefinition } from '../types/component';
 export interface DragNodeData {
     type: string;
@@ -18,13 +7,6 @@ export interface DragNodeData {
         view: ComponentDefinition;
     };
 }
-/**
- * 渲染侧边栏组件列表
- * 按 category 分组展示，支持搜索过滤、折叠/展开
- *
- * @param editor - 编辑器实例 (需要含 sidebarGroupsEl / searchInputEl / components / expandedGroups / lf / rootEl 等)
- */
 export declare function renderSidebar(editor: any): void;
 export declare function buildDragNodeData(comp: ComponentDefinition & Record<string, any>, label?: string, allComponents?: Array<ComponentDefinition & Record<string, any>>): DragNodeData;
 export declare function inferNodeType(comp: ComponentDefinition & Record<string, any>): string;
-//# sourceMappingURL=editor-sidebar.d.ts.map

package/dist/standalone/editor-styles.d.ts

@@ -1,12 +1 @@
-/**
- * editor-styles.ts
- * ================
- * 功能：编辑器 CSS 样式注入
- *
- * 包含编辑器所有 UI 组件的 CSS 样式定义，
- * 使用 CSS 变量实现主题切换支持。
- * 所有类名以 huanban_ 前缀避免冲突。
- */
-/** 注入编辑器 CSS 到页面 */
 export declare function injectStyles(): void;
-//# sourceMappingURL=editor-styles.d.ts.map

package/dist/standalone/editor-toast.d.ts

@@ -1,2 +1 @@
-export declare function showEditorToast(editor: any, message: string, type?: 'error' | 'info'): void;
-//# sourceMappingURL=editor-toast.d.ts.map
+export declare function showEditorToast(_editor: any, message: string, type?: 'error' | 'info'): void;

package/dist/standalone/editor-toolbar.d.ts

@@ -1,104 +1,29 @@
-/**
- * @file standalone/editor-toolbar.ts
- * @description 工具栏事件处理、语言切换、主题切换
- *
- * 从 HuanbanRulegoEditor 主文件中提取的模块，包含:
- * - handleToolbarClick: 工具栏按钮点击事件分发
- * - _toggleLocale: 中英文切换
- * - _refreshToolbarTexts: 刷新工具栏按钮文字
- * - _refreshSidebarTexts: 刷新侧边栏标题和搜索框
- * - 主题相关: _currentThemeLabel / _applyTheme / _toggleThemeMenu / _closeThemeMenu / _refreshThemeDropdown
- *
- * 所有函数接收 editor 实例 (通过 this as any 传入)，
- * 通过 editor 访问 lf、core、rootEl、sidebarEl、i18n 等内部属性。
- *
- * @param editor - HuanbanRulegoEditor 实例引用
- */
 type ExternalOperationResult = void | boolean | {
     success?: boolean;
     ok?: boolean;
     code?: unknown;
     status?: unknown;
+    error?: unknown;
+    err?: unknown;
     msg?: string;
     message?: string;
 };
 export declare function isExternalOperationSuccess(result: ExternalOperationResult): boolean;
-/**
- * 工具栏按钮点击事件处理
- * 根据 data-action 分发到对应的处理函数
- *
- * @param editor - 编辑器实例
- * @param e - 原始点击事件
- */
-export declare function handleToolbarClick(editor: any, e: Event): void;
+export declare function handleToolbarClick(editor: any, e: Event): void | Promise<void>;
 export declare function updateToolbarHistoryState(editor: any, state?: {
     undoAble?: boolean;
     redoAble?: boolean;
 }): void;
 export declare function bindFullscreenState(editor: any): () => void;
-/**
- * 切换语言（中英文互切）并刷新工具栏 + 侧边栏文本
- * 不销毁重建 UI，仅精准更新 DOM 内的按钮文字
- *
- * @param editor - 编辑器实例
- */
 export declare function toggleLocale(editor: any): void;
-/**
- * 语言切换后刷新工具栏按钮文字
- * 通过 data-action 精准更新每个按钮的 textContent
- *
- * @param editor - 编辑器实例
- */
+export declare function setEditorLocale(editor: any, nextLocale: string, persist?: boolean): void;
 export declare function refreshToolbarTexts(editor: any): void;
-/**
- * 语言切换后刷新侧边栏标题和搜索框占位符
- *
- * @param editor - 编辑器实例
- */
 export declare function refreshSidebarTexts(editor: any): void;
-/**
- * 获取当前主题的显示名称（根据当前语言自动选择中/英文）
- *
- * @param editor - 编辑器实例
- * @returns 当前主题的本地化显示名称
- */
 export declare function currentThemeLabel(editor: any): string;
-/**
- * 应用指定主题 — 设置 data-theme 属性，更新 UI
- *
- * @param editor - 编辑器实例
- * @param themeId - 主题标识，如 'default'、'dark'、'nature'...
- */
 export declare function applyTheme(editor: any, themeId: string): void;
-/**
- * 切换主题下拉菜单的显示/隐藏
- * 使用 fixed 定位避免被 toolbar overflow 裁剪
- *
- * @param editor - 编辑器实例
- */
 export declare function toggleThemeMenu(editor: any, target?: Element | null): void;
-/**
- * 关闭主题下拉菜单
- *
- * @param editor - 编辑器实例
- */
 export declare function closeThemeMenu(editor: any): void;
-/**
- * 刷新主题下拉菜单的选项文本和 active 状态
- * 在语言切换时需要更新选项的显示文本
- *
- * @param editor - 编辑器实例
- */
 export declare function refreshThemeDropdown(editor: any): void;
-/**
- * 注册全局键盘快捷键
- * - Ctrl/Cmd + S: 保存
- * - Ctrl/Cmd + Z: 撤销
- * - Ctrl/Cmd + Shift + Z: 重做
- *
- * @param editor - 编辑器实例
- * @returns 清理函数 (用于 destroy 时移除监听)
- */
+export declare function cancelPendingEditorSave(editor: any): void;
 export declare function setupKeyboardShortcuts(editor: any): () => void;
 export {};
-//# sourceMappingURL=editor-toolbar.d.ts.map

package/dist/standalone/editor-tour.d.ts

@@ -0,0 +1,7 @@
+export interface EditorTourHandle {
+    close: () => void;
+    getStepIndex: () => number;
+}
+export declare function isEditorTourDone(): boolean;
+export declare function closeEditorTour(editor: object): void;
+export declare function startEditorTour(editor: any): boolean;

package/dist/standalone/editor-trace-overlay.d.ts

@@ -1,7 +1,3 @@
-/**
- * @file editor-trace-overlay.ts
- * @description 规则链追溯模式 — 在 LogicFlow 画布上叠加调试日志数据
- */
 import type { HuanbanRulegoEditor } from './HuanbanRulegoEditor';
 interface DebugLogItem {
     ts: number;
@@ -21,4 +17,3 @@ export declare function enterTraceMode(editor: HuanbanRulegoEditor, logs: DebugL
 export declare function exitTraceMode(editor: HuanbanRulegoEditor): void;
 export declare function isTraceActive(): boolean;
 export {};
-//# sourceMappingURL=editor-trace-overlay.d.ts.map

package/dist/standalone/full-json-dialog.d.ts

@@ -5,6 +5,10 @@ export interface FullJsonDialogOptions {
     fileNamePrefix?: string;
     t?: (key: string, params?: Record<string, string>) => string;
     notify?: (message: string, type?: 'success' | 'error' | 'info') => void;
+    modalOwner?: {
+        _activeModalWrapper?: HTMLElement | null;
+        _closeModal?: () => void;
+    };
+    parentOwner?: HTMLElement | null;
 }
 export declare function showFullJsonDialog(options: FullJsonDialogOptions): void;
-//# sourceMappingURL=full-json-dialog.d.ts.map

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

@@ -1,41 +1,4 @@
-/**
- * @file standalone/group-node.ts
- * @description 节点组（group-node）自定义图元注册
- *
- * 节点组是一种特殊的画布元素，不是普通的矩形节点，而是一个**容器节点**，
- * 可以包含其他子节点在内部，支持拖拽调整大小、折叠/展开等操作。
- *
- * 使用 LogicFlow 的 DynamicGroup 插件作为基类实现，视觉效果为：
- * - 虚线边框、半透明背景的大矩形容器
- * - 默认 300x200 尺寸
- * - 只有左右两个锚点
- * - 支持折叠/展开
- * - 支持自由调整大小
- * - 限制子节点不能拖出容器外
- *
- * 以下组件类型会被注册为 group-node（对应后端配置）：
- * - switch     → 条件分支 (cases[])
- * - inclusive  → 包含网关 (cases[]，继承 switch)
- * - while      → 循环 (condition, do→目标节点ID)
- * - for        → 遍历 (range, do→目标节点ID, mode)
- * - groupFilter → 过滤器组 (allMatches, nodeIds→拖入节点, timeout)
- * - groupAction → 动作组 (nodeIds→拖入节点, matchRelationType, matchNum, timeout)
- * - iterator   → 迭代器 (已弃用，用 for 替代)
- *
- * 注意: fork（并行分支）是简单的消息广播器，不是容器节点，使用 simple-node 渲染。
- *
- * 使用方式：
- *   import { registerGroupNode, GROUP_NODE_TYPES } from './group-node'
- *   registerGroupNode(lf)
- *
- * @see custom-nodes.ts 基础节点注册
- * @see DynamicGroup LogicFlow 分组插件
- */
 import LogicFlow from '@logicflow/core';
-/**
- * 需要渲染为 group-node 的组件类型列表
- * 这些组件在画布上会展示为可包含子节点的容器
- */
 export declare const GROUP_NODE_TYPES: string[];
 type GroupNodeTranslator = (key: 'onlyRightAnchorOut' | 'notToInput' | 'onlyLeftAnchorIn', fallback: string) => string;
 export declare function isGroupAppendAllowed(nodeData: {
@@ -43,19 +6,6 @@ export declare function isGroupAppendAllowed(nodeData: {
 } | null | undefined): boolean;
 export declare function fillGroupNodeFields(lf: any, groupLfId: string): void;
 export declare function setupGroupEventListeners(lf: any): void;
-export declare function restoreParentGroup(lf: any): void;
-/**
- * 注册 group-node 自定义图元到 LogicFlow 实例
- *
- * group-node 继承自 DynamicGroup 插件，拥有以下特性：
- * 1. 容器功能 — 可以包含其他子节点
- * 2. 折叠/展开 — 支持 collapsible 属性
- * 3. 自由调整大小 — 支持 resizable 属性
- * 4. 限制子节点 — 子节点不能拖出容器外
- * 5. 只有左右两个锚点
- *
- * @param lf - LogicFlow 画布实例
- */
+export declare function restoreParentGroup(lf: any): number;
 export declare function registerGroupNode(lf: LogicFlow, translate?: GroupNodeTranslator): void;
 export {};
-//# sourceMappingURL=group-node.d.ts.map

package/dist/standalone/icon-utils.d.ts

@@ -1,27 +1,7 @@
-/**
- * icon-utils.ts
- * =============
- * 功能：图标 URL 解析工具
- *
- * 提供 resolveIconUrl 函数，优先使用内联 data URL（从 ICON_REGISTRY 查找），
- * 找不到时回退到默认图标（齿轮）。
- *
- * 使用方式:
- *   import { resolveIconUrl } from './icon-utils'
- *   const url = resolveIconUrl('images/delay.svg')
- */
 import { DEFAULT_ICON_URL, normalizeIconTheme, type IconThemeName } from '../iconRegistry';
 export { DEFAULT_ICON_URL, normalizeIconTheme };
 export type { IconThemeName };
 export interface ResolveIconUrlOptions {
-    /** 当前编辑器主题；支持 ICON_THEME_NAMES 以及 light/blue/antd 等 alias */
     theme?: string | null;
 }
-/**
- * 解析图标 URL — 优先使用内联 data URL，找不到时回退到默认图标
- * @param iconPath - 图标路径，如 'images/delay.svg' 或组件自定义的 icon
- * @param optionsOrTheme - 可选主题配置，字符串会作为 theme 处理
- * @returns data URL（注册表匹配 / http(s) 链接 / 默认齿轮图标）
- */
 export declare function resolveIconUrl(iconPath: string, optionsOrTheme?: string | ResolveIconUrlOptions): string;
-//# sourceMappingURL=icon-utils.d.ts.map

package/dist/standalone/index.d.ts

@@ -1,10 +1,14 @@
-/**
- * @file standalone/index.ts
- * @description HuanbanRulegoEditor 入口的 barrel 导出
- */
 export { HuanbanRulegoEditor, applyComponentsRuntimePayloadOptions, normalizeComponentsPayload, normalizeComponentsRawPayload, } from './HuanbanRulegoEditor';
-export type { AIAssistantOpenOptions, HuanbanRulegoEditorOptions } from './HuanbanRulegoEditor';
-/** 调试日志工具 — 可通过 setDebug(true) 开启编辑器内部调试日志 */
+export type { AIAssistantOpenOptions, EditorSaveHandler, EditorSaveHandlerResult, EditorSaveConflictContext, EditorSaveMode, EditorSaveResult, EditorOptionsUpdateResult, ExternalDataUpdatePolicy, EditorShellPersistenceOptions, EditorRecentComponentsOptions, EditorRunTestCasesOptions, HuanbanRulegoEditorLoadOptions, HuanbanRulegoEditorOptions, } from './HuanbanRulegoEditor';
+export type { ComponentManageDialogTab, SettingsDialogTab } from './editor-dialogs';
+export type { NodePickerOpenOptions } from './editor-overlays';
+export { closeEditorTour, isEditorTourDone, startEditorTour } from './editor-tour';
+export type { EditorTourHandle } from './editor-tour';
+export { adapterComponentsLocal, adapterRuntimeComponent } from './node-definitions';
+export type { RuntimeComponentAdapterOptions } from './node-definitions';
+export { confirmDrawerUnsavedClose } from './drawer-unsaved-guard';
+export type { DrawerCloseDecision, DrawerGuardI18nContext } from './drawer-unsaved-guard';
+export type { DebugWsCallbacks, DebugWsStatusDetails, DebugWsStatusReason, DebugWebSocketOptions, WsStatus, } from './editor-debug-ws';
 export { debugLog, setDebug, isDebug } from './logger';
 export { escapeHtml, escapeAttr, setSafeText, safeUrl, safeImageUrl, safeCssColor, sanitizeRichHtml, sanitizeDescription, redactSensitive, formatJsonBounded, parseJsonBounded, } from './security-utils';
 export { DEFAULT_ICON_URL, normalizeIconTheme, resolveIconUrl } from './icon-utils';
@@ -13,4 +17,3 @@ export { HUANBAN_FAVICON_DATA_URI, HUANBAN_FAVICON_SVG, HUANBAN_FAVICON_SVG_PATH
 export { getThemeList, normalizeEditorTheme, THEME_PRESETS } from './themes';
 export type { ThemeVars } from './themes';
 export type { RichHtmlPolicy, RedactOptions, FormatJsonBoundedOptions, ParseJsonBoundedOptions, } from './security-utils';
-//# sourceMappingURL=index.d.ts.map