@huanban/rulego-editor-core 1.3.18 → 1.4.0

package/dist/standalone/HuanbanRulegoEditor.d.ts

@@ -1,220 +1,207 @@
-/**
- * @file standalone/HuanbanRulegoEditor.ts
- * @description HuanbanRulegoEditor — 零框架依赖，一行代码启动完整编辑器
- *
- * 核心职责:
- * 1. 创建完整 DOM 布局 (工具栏 + 侧边栏 + 画布 + 属性面板)
- * 2. 初始化 LogicFlow 画布 (带 nodeTextDraggable: false 等关键配置)
- * 3. 初始化 EditorCore 数据引擎
- * 4. 渲染 Node-RED 风格的组件侧边栏 (带分类折叠、搜索、拖拽)
- * 5. 提供简洁 API: loadData / exportData / loadComponents / destroy
- *
- * 所有 CSS class 使用 huanban_rulego_editor 前缀, 避免与宿主项目冲突。
- *
- * 使用方式:
- * ```html
- * <div id="editor" style="height:100vh"></div>
- * <script src="editor-core.umd.js"></script>
- * <script>
- *   const editor = new RuleGoEditorCore.HuanbanRulegoEditor({
- *     container: '#editor',
- *     apiBase: 'http://127.0.0.1:9090',
- *     onReady: ({ lf, core }) => console.log('就绪'),
- *     onNodeClick: (node) => console.log('点击节点', node),
- *   })
- * </script>
- * ```
- *
- * @see EditorCore 核心引擎
- * @see DataAdapter 数据转换
- */
 import LogicFlow from '@logicflow/core';
 import { EditorCore } from '../core/EditorCore';
 import { I18nManager } from '../core/I18nManager';
+import { EditorDockStore } from '../core/editor-dock';
+import type { EditorDockPersistenceState, EditorPersistenceAdapter, EditorPersistenceMigrationContext, EditorPersistenceNamespace } from '../core/editor-dock';
+import { EditorPanelRegistry } from '../core/editor-panel';
+import { RecentComponentsStore } from '../core/recent-components';
+import type { RecentComponentsPersistenceOptions } from '../core/recent-components';
+import { EditorTestCasesStore } from '../core/test-cases';
+import type { EditorTestCasesOptions } from '../core/test-cases';
+import type { EditorPanelPersistenceState } from '../core/editor-panel';
+import { EditorWorkspace } from '../core/EditorWorkspace';
+import { ServerStatusStore } from '../core/server-status';
+import { ConnectionStatusController, ConnectionStatusStore } from '../core/connection-status';
+import type { EditorCapabilities, EditorCapabilitiesOverride, EditorMode } from '../core/editor-capabilities';
 import type { AiProviderOption, EditorOptions } from '../types/editor';
+import type { FieldChangeHandler } from '../core/FieldChangeRegistry';
 import type { RuleChainData } from '../types/rule-chain';
 import type { ComponentDefinition, RawComponentData } from '../types/component';
-import type { SettingsDialogTab } from './editor-dialogs';
+import type { DiagnosticItem } from '../core/topology-rules';
+import type { ComponentManageDialogTab, SettingsDialogTab } from './editor-dialogs';
+import type { CanvasGridType } from './canvas-view';
 import type { AutoLayoutOptions } from '../core/AutoLayout';
+import { ApiProvider } from '../api/ApiProvider';
+import type { ApiCacheKey } from '../api/types';
+import type { ApiAuthRequiredHandler } from '../api/types';
+import type { EditorActionSource } from '../core/ActionRegistry';
+import { type NodePickerOpenOptions } from './editor-overlays';
 export declare function normalizeComponentsRawPayload(data: unknown): unknown;
 export declare function normalizeComponentsPayload(data: unknown): ComponentDefinition[];
 export declare function applyComponentsRuntimePayloadOptions(opts: Record<string, any>, data: unknown): unknown;
-/**
- * HuanbanRulegoEditor 配置选项
- */
+export type EditorSaveMode = 'builtin' | 'host';
+export type ExternalDataUpdatePolicy = 'replace' | 'preserve-dirty';
+export interface EditorShellPersistenceOptions {
+    adapter: EditorPersistenceAdapter;
+    namespace: EditorPersistenceNamespace;
+    migrateFromVersions?: ReadonlyArray<string | number>;
+    dockMigrate?: (state: unknown, context: EditorPersistenceMigrationContext) => EditorDockPersistenceState | null | undefined;
+    panelMigrate?: (state: unknown, context: EditorPersistenceMigrationContext) => EditorPanelPersistenceState | null | undefined;
+}
+export interface EditorRecentComponentsOptions {
+    persistence?: RecentComponentsPersistenceOptions;
+    maxEntries?: number;
+    topN?: number;
+    halfLifeDays?: number;
+}
+export interface EditorRunTestCasesOptions extends Omit<EditorTestCasesOptions, 'persistence'> {
+    persistence?: EditorTestCasesOptions['persistence'];
+}
+export interface EditorSaveResult {
+    success: boolean;
+    mode: EditorSaveMode;
+    data: RuleChainData;
+    chainId: string;
+    message?: string;
+    verified?: boolean;
+    error?: unknown;
+}
+export interface EditorSaveConflictContext {
+    chainId: string;
+    baseline: RuleChainData;
+    remote: unknown;
+    current: RuleChainData;
+}
+export interface EditorOptionsUpdateResult {
+    appliedKeys: string[];
+    structuralKeys: string[];
+    dataConflict: boolean;
+}
+export type EditorSaveHandlerResult = void | boolean | {
+    success?: boolean;
+    msg?: string;
+    message?: string;
+};
+export type EditorSaveHandler = (data: RuleChainData) => EditorSaveHandlerResult | Promise<EditorSaveHandlerResult>;
 export interface HuanbanRulegoEditorOptions {
-    /** 容器 — CSS 选择器字符串 或 DOM 元素 */
     container: string | HTMLElement;
-    /** API 基础地址 (如 'http://127.0.0.1:9090/api/v1')，用于 HuanbanRulegoEditor.fetchData */
     apiBase?: string;
-    /** 请求超时毫秒数, 默认 5000 */
+    wsUrl?: string;
+    wsBase?: string;
+    wsRoot?: string;
+    debugWsUrl?: string;
+    debugWsBase?: string;
+    debugWsOptions?: Record<string, unknown>;
+    debugWsMaxReconnects?: number;
+    debugWsMaxLifetimeReconnects?: number;
+    debugWsReconnectBaseDelayMs?: number;
+    debugWsReconnectMaxDelayMs?: number;
     fetchTimeout?: number;
-    /**
-     * 自定义请求 headers — 用于 API 认证 (如 Bearer Token)
-     *
-     * 支持两种形式:
-     * 1. 静态对象: { Authorization: 'Bearer xxx' }
-     * 2. 动态函数: () => ({ Authorization: `Bearer ${localStorage.getItem('token')}` })
-     *
-     * 所有编辑器内部的 fetch 请求（保存、部署、组件加载等）都会自动携带这些 headers
-     */
     fetchHeaders?: Record<string, string> | (() => Record<string, string>);
-    /**
-     * 自定义 fetch 函数 — 完全替换原生 fetch
-     *
-     * 当需要自定义请求逻辑（如统一认证拦截、请求签名、错误重试等）时使用。
-     * 函数签名与原生 fetch 一致: (url, init) => Promise<Response>
-     *
-     * 注意: fetchHeaders 仍会合并到 init.headers 中（如果同时配置了的话）
-     *
-     * @example
-     * customFetch: (url, init) => {
-     *   init.headers = { ...init.headers, Authorization: `Bearer ${getToken()}` }
-     *   return fetch(url, init)
-     * }
-     */
+    apiCacheKey?: ApiCacheKey;
     customFetch?: (url: string, init?: RequestInit) => Promise<Response>;
-    /** 允许携带敏感 headers 的 API origin 白名单；默认包含同源和 apiBase origin */
     allowedApiOrigins?: string[];
-    /** 请求返回 401/403 时触发，宿主可在此刷新登录态 */
     onAuthExpired?: (response: Response) => void;
-    /** 请求返回 401/403 时触发，宿主可在此清理本地 token */
+    onApiAuthRequired?: ApiAuthRequiredHandler;
     clearToken?: () => void;
-    /** 初始规则链数据 */
+    enableConnectionStatus?: boolean;
     data?: RuleChainData | null;
-    /** 初始组件列表，支持数组或 /api/v1/components 分段返回 */
+    dataUpdatePolicy?: ExternalDataUpdatePolicy;
     components?: RawComponentData;
-    /** AI 供应商预设；兼容 editorOptions.aiProviders */
     aiProviders?: AiProviderOption[];
-    /** 运行面板 AI 对话发送到 /rules/{chainId}/v1/chat/completions 的模型名 */
     runChatModel?: string;
-    /** 兼容旧集成命名；未设置 runChatModel 时作为运行面板 AI 对话默认模型 */
     defaultChatModel?: string;
-    /** Embedding AI 供应商预设；供本地意图识别等 providerType=embedding 字段使用 */
     aiEmbeddingProviders?: AiProviderOption[];
-    /** /components 原始载荷，保留 builtins、skillPath 等属性抽屉需要的附加协议 */
     componentsPayload?: unknown;
-    /** 兼容历史命名：部分集成方使用 componentPayload 传入 /components 原始载荷 */
     componentPayload?: unknown;
-    /** 内置 AI 工具列表；默认从 componentsPayload.builtins['ai/tools'].tools 提取 */
     builtinTools?: any[];
-    /** 兼容旧版顶层 tools 字段 */
     tools?: any[];
-    /** 后端返回的技能目录路径，用于 skill 内置工具提示 */
     skillPath?: string;
-    /** LogicFlow 额外配置 (会与默认配置合并) */
     lfOptions?: Record<string, unknown>;
-    /** LogicFlow 插件数组 (不传则自动从全局获取) */
     lfPlugins?: any[];
-    /** EditorCore 额外配置 */
     coreOptions?: Partial<EditorOptions>;
-    /** 是否显示工具栏, 默认 true */
+    canvasGridType?: CanvasGridType;
+    hideEdgeLabels?: boolean;
+    fieldChangeContributions?: Record<string, FieldChangeHandler>;
+    persistence?: EditorShellPersistenceOptions;
+    recentComponents?: EditorRecentComponentsOptions;
+    testCases?: EditorRunTestCasesOptions;
+    mode?: EditorMode;
+    capabilities?: EditorCapabilitiesOverride;
+    disabled?: boolean;
     showToolbar?: boolean;
-    /** 工具栏左侧标题 (不设置则不显示标题区域) */
     toolbarTitle?: string;
-    /** 是否显示工具栏按钮文字，默认 false；设为 true 时显示图标 + 文字 */
     showToolbarButtonLabels?: boolean;
-    /** 工具栏是否只显示图标，默认 true；显式 false 时可显示文字 */
     toolbarIconOnly?: boolean;
-    /** 是否显示侧边栏, 默认 true */
     showSidebar?: boolean;
-    /** 侧边栏宽度, 默认 220 */
     sidebarWidth?: number;
-    /** 侧边栏是否默认收起, 默认 false */
     sidebarCollapsed?: boolean;
-    /** 是否在画布右上工具条显示「信息」按钮, 默认 true */
+    sidebarVirtualization?: {
+        enabled?: boolean;
+        threshold?: number;
+        itemHeight?: number;
+        viewportHeight?: number;
+        overscan?: number;
+    };
     showInfoButton?: boolean;
-    /** 是否在画布右上工具条显示「AI 助手」按钮, 默认 true */
     showAiChatButton?: boolean;
-    /** 是否在画布右上工具条显示「调试面板」按钮, 默认 true */
     showDebugConsoleButton?: boolean;
-    /** 是否在画布右上工具条显示「清除调试高亮」按钮, 默认 true */
     showClearDebugHighlightButton?: boolean;
-    /** 是否在画布右上工具条显示「框选」按钮, 默认 false */
     showSelectionButton?: boolean;
-    /** 是否在顶部工具栏显示「设置」按钮, 默认 true */
+    showDiagnosticsButton?: boolean;
     showSettingsButton?: boolean;
-    /** 编辑器就绪 */
     onReady?: (ctx: {
         lf: LogicFlow;
         core: EditorCore;
     }) => void;
-    /** 保存回调 */
-    onSave?: (data: any) => void | boolean | {
-        success?: boolean;
-        msg?: string;
-        message?: string;
-    } | Promise<void | boolean | {
-        success?: boolean;
-        msg?: string;
-        message?: string;
-    }>;
-    /** 节点点击 */
+    saveMode?: EditorSaveMode;
+    saveHandler?: EditorSaveHandler;
+    onSave?: EditorSaveHandler;
+    onSaveRequest?: (data: RuleChainData) => void;
+    onSaveSuccess?: (result: EditorSaveResult) => void;
+    onSaveError?: (result: EditorSaveResult) => void;
+    onSaveConflict?: (ctx: EditorSaveConflictContext) => boolean | Promise<boolean>;
+    onExternalDataConflict?: (ctx: {
+        current: RuleChainData | null;
+        incoming: RuleChainData;
+    }) => void;
     onNodeClick?: (data: unknown) => void;
-    /** 节点双击 */
     onNodeDbClick?: (data: unknown) => void;
-    /** 边点击 */
     onEdgeClick?: (data: unknown) => void;
-    /** 数据变化 */
     onChange?: () => void;
-    /**
-     * 点击「信息」按钮的回调 (slot 概念)
-     * 包只提供链数据, 布局渲染由调用方决定
-     * @param chainInfo 当前规则链的配置信息 (ruleChain 对象)
-     */
     onInfoClick?: (chainInfo: any) => void;
-    /** 劫持默认设置弹窗，供 Vue/React 宿主使用自定义组件化设置页 */
     onSettingsClick?: (ctx: {
         initialTab?: SettingsDialogTab;
         apiBase?: string;
         baseUrl?: string;
         browserConsoleLog?: boolean;
     }) => void;
-    /** 内置设置弹窗保存系统设置后触发 */
     onSettingsSubmit?: (data: {
         apiBase: string;
         baseUrl: string;
         browserConsoleLog?: boolean;
     }) => void;
-    /** 示例/宿主调试日志是否允许输出到浏览器 console；核心仅在设置弹窗中透传该偏好 */
     browserConsoleLog?: boolean;
-    /** 内置设置弹窗点击登录时触发；未提供时仅提示宿主接入 */
     onLoginClick?: () => void;
-    /** 是否在工具栏显示「导出」按钮, 默认 true (已有导出功能则显示增强弹窗) */
     showExportDialog?: boolean;
-    /** 劫持导出行为, 调用方自行处理; 不设则使用内置弹窗 */
     onExportDSL?: (data: {
         json: string;
         imageDataUrl?: string;
     }) => void;
-    /** 劫持导入行为; 不设则使用内置 loadData 导入当前规则链 */
     onImportDSL?: (data: RuleChainData) => void;
-    /** 是否在画布右上工具条显示「运行」按钮, 默认 true */
     showRunButton?: boolean;
-    /** 劫持运行行为; 不设则使用内置运行 Drawer */
     onRunClick?: (chainId: string) => void;
-    /** 是否在工具栏显示「链追溯」按钮, 默认 false */
     showTraceButton?: boolean;
-    /** 点击「链追溯」按钮回调，回传当前完整的规则链数据 (用于构建追溯底图) */
     onTraceClick?: (chainInfo: any) => void;
-    /** 是否在工具栏显示「组件管理」按钮, 默认 false */
     showComponentManage?: boolean;
-    /** 劫持组件管理; 不设则使用内置弹窗 */
-    onComponentManage?: () => void;
-    /** 语言设置, 默认 'zh_cn' */
+    onComponentManage?: (initialTab?: ComponentManageDialogTab) => void;
     locale?: string;
-    /** 初始主题；支持 default/dark/nature/elegant/tech/modern，兼容 light/blue 旧写法 */
     theme?: string;
-    /** 劫持语言切换 */
     onLocaleChange?: (locale: string) => void;
-    /** 是否在节点 Drawer 中显示调试日志 Tab, 默认 true (有 apiBase 时) */
     showDebugTab?: boolean;
-    /** 是否在工具栏显示「部署」按钮, 默认 true */
     showDeployButton?: boolean;
-    /** 是否显示兼容保留的「重载」按钮, 默认 false；后端不保证支持 operate/reload */
+    showRestartButton?: boolean;
     showReloadButton?: boolean;
-    /** 劫持部署/下线行为；action 使用后端 operate 协议：start=部署/启动，stop=下线 */
-    onDeploy?: (chainId: string, action: 'start' | 'stop' | 'reload') => void | boolean | {
+    onDeploy?: (chainId: string, action: 'start' | 'stop') => void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    } | Promise<void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    }>;
+    onRestart?: (chainId: string) => void | boolean | {
         success?: boolean;
         msg?: string;
         message?: string;
@@ -223,284 +210,167 @@ export interface HuanbanRulegoEditorOptions {
         msg?: string;
         message?: string;
     }>;
-    /** 规则链列表数据 (初始传入, 用于弹窗列表展示) */
+    onRestartConfirm?: (context: {
+        chainId: string;
+        dirty: boolean;
+        effects: string[];
+    }) => boolean | Promise<boolean>;
     ruleItems?: any[];
-    /** 规则链 API 地址 (如 '/rules'), 用于远程加载规则链列表 */
     rulesApi?: string;
-    /** 选择规则链后的回调 */
     onSelectRuleChain?: (ruleChain: any) => void;
-    /** 劫持删除规则链; 不设则使用内置 API 调用 */
     onDeleteRuleChain?: (chainId: string) => void;
-    /** 是否在工具栏显示「运行记录」按钮, 默认 true (有 apiBase 时) */
     showRunHistory?: boolean;
-    /** 劫持运行记录; 不设则根据 runHistoryUrl 打开新窗口 */
     onRunHistory?: (chainId: string) => void;
-    /** 运行记录页面 URL (支持 {chainId} 占位符), 如 'http://xxx/ui/#/workflow/runs?chainId={chainId}' */
     runHistoryUrl?: string;
 }
 export interface AIAssistantOpenOptions {
-    /** 打开后默认从此节点上下文发起对话/调试 */
     fromNodeId?: string;
-    /** 仅使用指定节点上下文 */
     onlyThisNode?: boolean;
-    /** 宿主或内部入口标识，例如 skills/components/debug */
     section?: string;
 }
-/**
- * 原生 JS 编辑器 — 一行代码启动完整的 RuleGo 规则链编辑器
- *
- * 内部创建完整的 DOM 布局、LogicFlow 画布、EditorCore 引擎、
- * 以及 Node-RED 风格的组件侧边栏。
- *
- * @example
- * ```js
- * const editor = new HuanbanRulegoEditor({
- *   container: '#editor',
- *   data: ruleChainJSON,
- *   components: componentsArray,
- * })
- * ```
- */
+export interface HuanbanRulegoEditorLoadOptions {
+    allowDuplicateWorkspaceTab?: boolean;
+    preserveWorkspaceTab?: boolean;
+}
 export declare class HuanbanRulegoEditor {
-    /** LogicFlow 画布实例 */
     lf: LogicFlow | null;
-    /** EditorCore 数据引擎 */
     core: EditorCore | null;
-    /** DOM 元素引用 (子模块通过 editor 实例访问) */
-    /** @internal */ rootEl: HTMLElement | null;
-    /** @internal */ canvasEl: HTMLElement | null;
-    /** @internal */ sidebarEl: HTMLElement | null;
-    /** @internal */ sidebarGroupsEl: HTMLElement | null;
-    /** @internal */ searchInputEl: HTMLInputElement | null;
+    readonly workspace: EditorWorkspace;
+    readonly dock: EditorDockStore;
+    readonly panels: EditorPanelRegistry;
+    readonly serverStatus: ServerStatusStore;
+    readonly connectionStatus: ConnectionStatusStore;
+    readonly connectionStatusController: ConnectionStatusController;
+    readonly apiProvider: ApiProvider;
+    capabilities: EditorCapabilities;
+    rootEl: HTMLElement | null;
+    canvasEl: HTMLElement | null;
+    sidebarEl: HTMLElement | null;
+    sidebarGroupsEl: HTMLElement | null;
+    searchInputEl: HTMLInputElement | null;
+    _activeDrawerWrapper: HTMLElement | null;
+    _activeModalWrapper: HTMLElement | null;
     private statusNodes;
     private statusEdges;
-    /** 状态栏 — 更新时间元素 */
     private statusUpdateTime;
-    /** 状态栏 — 运行状态元素 */
     private statusRunState;
-    /** 侧边栏是否折叠 */
     private sidebarCollapsed;
-    /** 工具栏图标定义；画布浮动工具条需要在 LogicFlow 初始化后重建一次 */
     private toolbarIcons;
     private aiAssistantOpen;
     private aiAssistantUnread;
+    private workspaceTabId;
     private savedSnapshotJson;
+    private isFlushingPendingDrawer;
     private isLoadingDataIntoCanvas;
-    /** 组件数据 @internal */
+    private diagnosticItems;
+    private diagnosticTimer;
+    private readyTimer;
+    private autoLoadComponentsController;
+    private initialDataLoadTimer;
+    private initialDataCompletion;
+    private initialDataLoaded;
+    private componentRebindEligible;
+    private destroyed;
+    private transportGeneration;
     components: ComponentDefinition[];
-    /** 左侧分组展开状态 @internal */
+    readonly recentComponents: RecentComponentsStore;
+    readonly testCases: EditorTestCasesStore;
     expandedGroups: Set<string>;
-    /** 配置 @internal */
     opts: HuanbanRulegoEditorOptions;
-    /** 国际化管理器 @internal */
     i18n: I18nManager;
-    /** 当前主题标识 @internal */
     _currentTheme: string;
-    /** 键盘快捷键清理函数 @internal */
     private _cleanupShortcuts;
-    /** 右键菜单清理函数 @internal */
     private _cleanupContextMenu;
-    /** LogicFlow/Core 事件桥接清理函数 @internal */
+    private _cleanupEdgeLabelQuickEditor;
     private _cleanupBridgeEvents;
-    /** 全屏状态监听清理函数 */
+    private _cleanupCoreState;
+    private _cleanupConnectionStatus;
     private _cleanupFullscreenState;
-    /** 小地图是否可见 @internal */
+    _themeMenuBindTimer: ReturnType<typeof setTimeout> | null;
+    _themeMenuOutsideClickHandler: ((event: MouseEvent) => void) | null;
     _miniMapVisible: boolean;
-    /** 内部剪贴板 (用于 Ctrl+C/V 复制粘贴节点) @internal */
     _clipboard: any[];
-    /** 自动排版进行中标志 — edge:add 事件检查此标志，跳过弹窗 @internal */
     _isAutoLayouting: boolean;
-    /** 数据加载后是否需要自动优化布局 @internal */
     _pendingAutoOptimize: boolean;
     constructor(options: HuanbanRulegoEditorOptions);
-    /**
-     * 翻译便捷方法 — 从当前语言包获取文本
-     * @param key 翻译键 (如 'editor.toolbar.save')
-     * @param params 插值变量
-     * @returns 翻译后的文本
-     */
     t(key: string, params?: Record<string, string | number>): string;
-    /**
-     * 切换语言
-     * @param locale 语言标识 (zh_cn / en 等)
-     */
     setLocale(locale: string): void;
-    /**
-     * 切换主题。
-     * 供 React/Vue/原生宿主用代码控制主题，与内置主题下拉使用同一套逻辑。
-     */
     setTheme(theme: string): void;
-    /** 获取当前主题标识 */
+    registerFieldChangeHandler(name: string, handler: FieldChangeHandler, overwrite?: boolean): void;
+    unregisterFieldChangeHandler(name: string): boolean;
     getTheme(): string;
-    /**
-     * 获取 I18nManager 实例 (供外部扩展语言包)
-     */
+    _getTransportGeneration(): number;
     getI18n(): I18nManager;
-    /**
-     * 切换小地图 (MiniMap) 的显示/隐藏
-     * 使用 LogicFlow 内置 MiniMap 扩展
-     */
+    get runtimeFields(): import("..").RuntimeFieldDictionary | null;
+    updateOptions(patch: Partial<Omit<HuanbanRulegoEditorOptions, 'container'>>): EditorOptionsUpdateResult;
+    private _syncRuntimeOptionUi;
     toggleMiniMap(): void;
-    /**
-     * 切换画布节点搜索栏的显示/隐藏
-     * 搜索匹配的节点会被高亮并定位
-     */
     toggleNodeSearch(): void;
-    /**
-     * 在画布中搜索节点 — 匹配节点文本/类型/属性名
-     * 匹配节点添加高亮样式，自动聚焦第一个匹配节点
-     * @param keyword - 搜索关键词
-     * @returns 匹配的节点数量
-     * @internal
-     */
     _searchNodes(keyword: string): number;
-    /**
-     * 清除画布节点搜索高亮
-     * @internal
-     */
     _clearNodeSearchHighlight(): void;
-    /**
-     * 编辑器初始化入口 — 创建 DOM、LogicFlow、EditorCore 并桥接事件
-     * 在构造函数中被调用
-     */
     private init;
+    private _startInitialDataLoadGate;
+    private _bindCoreStateSync;
+    private _prepareForChainSwitch;
     private createDOM;
-    /** 渲染画布右上浮动工具条；LogicFlow 初始化会清空画布容器，因此 init 后也会调用一次 */
     private _renderCanvasToolbar;
-    /** 工具栏按钮点击事件 — 实现已提取到 editor-toolbar.ts */
     private handleToolbarClick;
-    /**
-     * 更新缩放百分比标签 — 从 LogicFlow 获取当前 transform.SCALE_X
-     * @internal
-     */
     _updateZoomLabel(): void;
-    /** 获取当前主题标签 (供 createDOM 使用) */
     private _currentThemeLabel;
-    /** 事件桥接 — 实现已提取到 editor-events.ts */
     private bridgeEvents;
-    /** 渲染侧边栏组件列表 — 实现已提取到 editor-sidebar.ts */
     renderSidebar(): void;
-    /** 当前选中的节点/边/正在添加的节点/边 @internal */
     _currentNode: any;
     _currentEdge: any;
     _currentAddNode: any;
     _currentAddEdge: any;
-    /** 操作栏关联的节点数据缓存，防止 blank:click 清空 _currentNode 后丢失引用 @internal */
+    _propertyOptionsController?: AbortController;
+    _propertyDrawerRequestGeneration: number;
     _operateNodeData: any;
-    /** 操作栏关联的连线数据缓存，防止 blank:click 清空 _currentEdge 后丢失引用 @internal */
     _operateEdgeData: any;
-    /** 操作栏正在交互标志 — blank:click 检测到此标志时跳过清空 @internal */
     _operateBarInteracting: boolean;
-    /** nodeComponents: 组件类型 → 组件定义 @internal */
     _nodeComponents: Record<string, any>;
-    /**
-     * 处理编辑元素 — 照搬原版 handleEditElement
-     * @param fromAdd 是否从拖入/新增触发
-     */
     private _handleEditElement;
-    /** @internal 子模块(editor-events)使用 */
     _showNodeOperate(data: any): void;
-    /** @internal 子模块(editor-events)使用 */
     _showEdgeOperate(data: any): void;
     private _hideNodeOperate;
-    /**
-     * 显示节点属性编辑 Drawer
-     * 实现已提取到 editor-property-drawers.ts
-     */
     private _showNodePropertyDrawer;
-    /**
-     * 显示边属性编辑 Drawer
-     * 实现已提取到 editor-property-drawers.ts
-     */
     private _showEdgePropertyDrawer;
-    /** 关闭 Drawer */
-    /** @internal 子模块(editor-property-drawers)使用 */
     _closeDrawer(): void;
-    /** 关闭弹窗 */
-    /** @internal 子模块(editor-dialogs)使用 */
     _closeModal(): void;
-    /** 标记画布存在未保存修改。供事件桥接和属性抽屉复用。 */
-    /** @internal */
     _markDirty(reason?: string): void;
-    /** 保存或加载完成后记录前端 diff 的基线快照。 */
-    /** @internal */
     _markSavedSnapshot(data?: RuleChainData | null): void;
-    /** 在 LogicFlow 完成渲染后用画布导出结果作为 clean 基线。 */
-    /** @internal */
+    _getSavedSnapshot(): RuleChainData | null;
     _markSavedSnapshotFromCanvas(): void;
-    /** 刷新保存按钮和 diff 按钮的未保存状态。 */
+    private _flushPendingDrawerChanges;
+    _syncChainLifecycle(action: 'start' | 'stop'): void;
+    private _scheduleTopologyDiagnostics;
+    runDiagnostics(): DiagnosticItem[];
+    openDiagnostics(): void;
+    private _renderDiagnosticsPanel;
+    private _applyDiagnosticMarkers;
     private _updateDirtySaveUi;
-    /** 打开前端规则链 JSON 变更 diff 弹窗。 */
     showUnsavedDiffDialog(): void;
-    /**
-     * 显示规则链选择器弹窗 — 支持搜索和分页
-     * 实现已提取到 editor-dialogs.ts
-     */
-    /** @internal 子模块(editor-toolbar)使用 */
     _showRuleChainSelector(): void;
-    /** @internal 子模块(editor-events)使用 */
     updateStatusBar(): void;
-    /**
-     * 加载组件列表
-     * @param components 组件定义数组或 /api/v1/components 分段返回
-     */
     loadComponents(components: RawComponentData): void;
-    /**
-     * 加载规则链数据
-     * @param data RuleGo 规则链 JSON 数据
-     */
-    loadData(data: RuleChainData): void;
-    /**
-     * 自动排版 — 重新计算节点位置，连线从锚点重新连接
-     *
-     * 核心思路：
-     *  1. 用 DAG 拓扑排序算法计算每个节点的目标坐标
-     *  2. 删除边的 startPoint/endPoint/pointsList，保留 sourceAnchorId/targetAnchorId
-     *  3. 用 lf.render() 重新渲染图数据，强制 LogicFlow 从锚点重新计算连线路径
-     *  4. 边的文本只保留内容值，位置由 LogicFlow 在新路径上自动计算
-     *
-     * 为什么不用 moveNode：
-     *  moveNode 只做坐标平移（startPoint += deltaX），不会重新绑定到锚点，
-     *  导致贝塞尔曲线的起止点和控制点错位，连线无法正确连到节点锚点。
-     *
-     * @param options - 可选排版参数 (层间距、节点间距等)
-     */
+    reloadComponents(options?: {
+        forceRefresh?: boolean;
+    }): Promise<boolean>;
+    refreshConnectionStatuses(): void;
+    acquireSharedConnectionStatuses(): () => void;
+    private _requestConnectionStatuses;
+    loadData(data: RuleChainData, options?: HuanbanRulegoEditorLoadOptions): void;
+    activateWorkspaceTab(tabId: string): boolean;
+    loadImportedData(data: RuleChainData): void;
     autoLayout(options?: AutoLayoutOptions): void;
-    /**
-     * 更新状态栏中的「更新时间」和「运行状态」
-     * @param ruleChain 规则链配置信息 (含 updateTime / disabled 字段)
-     * @internal
-     */
     _updateChainStatus(ruleChain?: import('../types/rule-chain').RuleChainConfig | null): void;
-    /**
-     * 导出当前画布数据为 RuleGo 格式
-     * @returns RuleGo 规则链 JSON 数据
-     */
+    _updateDeployToolbarAction(ruleChain?: import('../types/rule-chain').RuleChainConfig | null): void;
     exportData(): RuleChainData | null;
-    /** 导出并在控制台输出 */
-    /** @internal 子模块(editor-toolbar)使用 */
     exportAndLog(): void;
-    /** 切换侧边栏折叠/展开 */
     toggleSidebar(): void;
-    /** 适应画布 */
     fitView(): void;
-    /**
-     * 显示导入 DSL 弹窗
-     * 实现已提取到 editor-dialogs.ts
-     */
-    /** @internal 子模块(editor-toolbar)使用 */
     _showImportDialog(): void;
-    /**
-     * 显示导出 DSL 弹窗
-     * 实现已提取到 editor-dialogs.ts
-     */
-    /** @internal 子模块(editor-toolbar)使用 */
     _showExportDialog(): void;
-    /**
-     * 显示运行面板 Drawer
-     * 实现已提取到 editor-dialogs.ts
-     */
-    /** @internal 子模块(editor-toolbar)使用 */
     _showRunPanel(options?: {
         fromNodeId?: string;
         onlyThisNode?: boolean;
@@ -508,97 +378,28 @@ export declare class HuanbanRulegoEditor {
         initialTab?: 'response' | 'resp_headers' | 'debug' | 'history' | 'integration';
         section?: string;
     }): void;
-    /** @internal 子模块(editor-toolbar)使用 */
     _showSettingsDialog(initialTab?: SettingsDialogTab): void;
-    /** 公开打开设置弹窗；Vue/React 包可用该方法保持设置入口协议一致 */
     openSettings(initialTab?: SettingsDialogTab): void;
-    /**
-     * 公开打开 AI 助手。
-     *
-     * 该方法是 core / Vue / React / UMD 的统一入口。框架组件、属性抽屉、
-     * 画布按钮和宿主系统都应调用这个方法，而不是直接依赖内部运行面板实现。
-     */
+    invokeAction(id: string, source?: EditorActionSource): Promise<boolean>;
+    openCommandPalette(): void;
+    openShortcutHelp(): void;
+    startTour(): boolean;
+    closeTour(): void;
+    openNodePicker(options?: NodePickerOpenOptions): void;
+    openComponentDocs(initialType?: string): Promise<void>;
+    closeOverlay(): void;
+    closeAllOverlays(): void;
     openAiAssistant(options?: AIAssistantOpenOptions): void;
-    /** 关闭当前 AI 助手/运行面板 Drawer */
     closeAiAssistant(): void;
-    /**
-     * 显示组件管理弹窗
-     * 实现已提取到 editor-dialogs.ts
-     */
-    /** @internal 子模块(editor-toolbar)使用 */
-    _showComponentManage(): void;
-    /**
-     * 获取当前规则链信息 (公开 API)
-     * 调用方可随时获取当前加载的链数据
-     * @returns 当前规则链配置对象, 未加载时返回 null
-     */
+    _showComponentManage(initialTab?: ComponentManageDialogTab): void;
+    openComponentManager(initialTab?: ComponentManageDialogTab): void;
     getChainInfo(): any | null;
-    /**
-     * 显示链信息 (公开 API)
-     * 如果配置了 onInfoClick 回调, 则将链数据传给回调由调用方渲染
-     * 如果没有配置回调, 则使用内置的简单 Drawer 展示
-     */
     showChainInfo(): void;
-    /**
-     * 内置的链信息 Drawer (默认实现)
-     * 完整展示规则链信息面板:
-     * 1. 基础信息 — ID、名称、根规则链、调试模式、描述
-     * 2. 输入定义 — additionalInfo.inputSchema 可视化/JSON 编辑
-     * 3. 变量和秘钥 — configuration.vars / configuration.secrets 表格
-     * 4. 平台集成 — 同步/异步调用接口 + MCP 集成
-     */
     private _showChainInfoDrawer;
-    /** HTML 转义工具方法 */
-    /** @internal 子模块(editor-property-drawers)使用 */
     _escapeHtml(text: string): string;
-    /** 销毁编辑器 */
     destroy(): void;
-    /**
-     * 从 API 自动加载组件列表
-     * 在 init() 中调用, 当没有传入 components 且有 apiBase 时触发
-     * @internal
-     */
     private _autoLoadComponents;
-    /**
-     * 通用数据请求方法 — 只从真实 API 加载，失败直接 reject。
-     *
-     * @param apiBase - API 基础地址 (如 'http://127.0.0.1:9090/api/v1')
-     * @param path    - 请求路径 (如 '/components')
-     * @param legacyFallbackFile - 旧版本兼容参数，当前不再读取本地替代数据
-     * @param timeout - 超时毫秒数, 默认 5000
-     * @param headers - 可选的自定义请求头 (如认证 Token)
-     * @returns Promise<any> 解析后的 JSON 数据
-     *
-     * @example
-     * ```js
-     * HuanbanRulegoEditor.fetchData('http://api.example.com/api/v1', '/components')
-     *   .then(data => console.log(data))
-     * ```
-     */
     static fetchData(apiBase: string, path: string, legacyFallbackFile?: string, timeout?: number, headers?: Record<string, string>): Promise<unknown>;
-    /**
-     * 开启/关闭编辑器内部调试日志
-     *
-     * 调试日志默认关闭，开启后会在控制台输出编辑器内部的事件桥接、
-     * 节点注册、画布渲染等详细调试信息。
-     *
-     * @param enabled - true: 开启调试日志, false: 关闭
-     *
-     * @example
-     * ```js
-     * // UMD 用法
-     * RuleGoEditorCore.HuanbanRulegoEditor.setDebug(true)
-     *
-     * // ESM 用法
-     * import { HuanbanRulegoEditor } from '@huanban/rulego-editor-core'
-     * HuanbanRulegoEditor.setDebug(true)
-     * ```
-     */
     static setDebug(enabled: boolean): void;
-    /**
-     * 查询调试日志是否开启
-     * @returns 当前调试模式是否开启
-     */
     static isDebug(): boolean;
 }
-//# sourceMappingURL=HuanbanRulegoEditor.d.ts.map