@huanban/rulego-editor-core 1.3.18 → 1.4.0

package/dist/standalone/ai-model-policy.d.ts

@@ -58,4 +58,3 @@ export declare function modelProfileFromModelsDev(model: string, meta: ModelsDev
 export declare function fallbackAiModelProfile(model: string, context?: Partial<AiModelProfile>): AiModelProfile;
 export declare const AI_BUILTIN_PARAM_KEYS: readonly ["temperature", "topP", "presencePenalty", "frequencyPenalty", "maxTokens", "maxCompletionTokens", "n"];
 export declare function buildAiParamPolicy(profile: AiModelProfile): AiParamPolicy;
-//# sourceMappingURL=ai-model-policy.d.ts.map

package/dist/standalone/ai-providers.d.ts

@@ -4,4 +4,3 @@ export declare const DEFAULT_AI_PROVIDERS: AiProviderOption[];
 export declare function getGlobalProviderList(name: 'rulegoAiProviders' | 'rulegoAiEmbeddingProviders'): AiProviderOption[];
 export declare function getAiProviders(providers?: AiProviderOption[]): AiProviderOption[];
 export declare function getAiEmbeddingProviders(providers?: AiProviderOption[]): AiProviderOption[];
-//# sourceMappingURL=ai-providers.d.ts.map

package/dist/standalone/auth-fetch.d.ts

@@ -1,53 +1,9 @@
-/**
- * @file standalone/auth-fetch.ts
- * @description 统一的 fetch 请求封装 — 支持自定义 headers（如 Token 认证）和完全替换 fetch 函数
- *
- * 核心职责:
- * 1. 提供 authFetch 函数，在所有 API 请求中自动注入配置的 headers
- * 2. 支持 customFetch — 完全替换原生 fetch（用于自定义认证、拦截器等）
- * 3. 提供 getAuthHeaders 从编辑器实例获取认证 headers 的工具函数
- * 4. 集中管理请求超时、错误处理逻辑
- *
- * 使用方式:
- *   import { authFetch, getAuthHeaders } from './auth-fetch'
- *   const resp = await authFetch(url, { method: 'GET' }, editor)
- *
- * 自定义 fetch 函数:
- *   <RuleGoEditor customFetch={(url, init) => myAuthFetch(url, init)} />
- *   当配置了 customFetch 时，authFetch 会直接使用它替代原生 fetch，
- *   此时 fetchHeaders 仍会合并到 init.headers 中（如果同时配置了的话）
- */
-/**
- * 从编辑器实例获取自定义请求头
- * 支持 fetchHeaders 为静态对象或函数（动态获取 token）
- *
- * @param editor - HuanbanRulegoEditor 实例（需要 opts.fetchHeaders）
- * @returns 合并后的 headers 对象
- */
-export declare function getAuthHeaders(editor: any): Record<string, string>;
+export declare function getAuthHeaders(editor: any, opts?: any): Record<string, string>;
 export interface AuthFetchOptions {
     timeoutMs?: number;
     allowedOrigins?: string[];
     sensitiveHeaderNames?: string[];
-    /**
-     * Keep enabled by default for RuleGo backend APIs. Set to false for
-     * user-configured third-party endpoints that must not receive host auth.
-     */
+    streamResponse?: boolean;
     includeAuthHeaders?: boolean;
 }
-/**
- * 带认证的 fetch 封装
- *
- * 优先级:
- * 1. 如果 editor.opts.customFetch 存在 → 使用自定义 fetch 函数
- * 2. 否则 → 使用原生 fetch + 自动注入 fetchHeaders
- *
- * 两种模式下，fetchHeaders 都会被合并到请求头中
- *
- * @param url - 请求地址
- * @param init - fetch RequestInit 配置
- * @param editor - HuanbanRulegoEditor 实例
- * @returns fetch Response
- */
 export declare function authFetch(url: string, init: RequestInit | undefined, editor: any, options?: AuthFetchOptions): Promise<Response>;
-//# sourceMappingURL=auth-fetch.d.ts.map

package/dist/standalone/browser-assets.d.ts

@@ -1,14 +1,6 @@
-/**
- * Stable editor browser assets.
- *
- * The SVG files are shipped by @huanban/rulego-editor-core under assets/images.
- * Examples use data URIs for in-app logos and normal favicon.svg files for
- * browser tab icons.
- */
 export declare const HUANBAN_LOGO_SVG_PATH = "assets/images/logo.svg";
 export declare const HUANBAN_FAVICON_SVG_PATH = "assets/images/favicon.svg";
 export declare const HUANBAN_LOGO_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 64 64\" role=\"img\" aria-label=\"Huanban workflow logo\">\n  <defs>\n    <linearGradient id=\"ink\" x1=\"14\" y1=\"8\" x2=\"50\" y2=\"56\" gradientUnits=\"userSpaceOnUse\">\n      <stop offset=\"0\" stop-color=\"#0f172a\"/>\n      <stop offset=\"1\" stop-color=\"#27364a\"/>\n    </linearGradient>\n    <linearGradient id=\"teal\" x1=\"12\" y1=\"12\" x2=\"52\" y2=\"52\" gradientUnits=\"userSpaceOnUse\">\n      <stop offset=\"0\" stop-color=\"#2dd4bf\"/>\n      <stop offset=\"1\" stop-color=\"#0f766e\"/>\n    </linearGradient>\n    <linearGradient id=\"gold\" x1=\"45\" y1=\"10\" x2=\"20\" y2=\"56\" gradientUnits=\"userSpaceOnUse\">\n      <stop offset=\"0\" stop-color=\"#fde68a\"/>\n      <stop offset=\"1\" stop-color=\"#f59e0b\"/>\n    </linearGradient>\n    <filter id=\"soft-shadow\" x=\"-20%\" y=\"-20%\" width=\"140%\" height=\"140%\">\n      <feDropShadow dx=\"0\" dy=\"2\" stdDeviation=\"2\" flood-color=\"#0f172a\" flood-opacity=\".16\"/>\n    </filter>\n  </defs>\n  <g fill=\"none\" filter=\"url(#soft-shadow)\">\n    <circle cx=\"32\" cy=\"32\" r=\"29\" stroke=\"url(#ink)\" stroke-width=\"3\"/>\n    <circle cx=\"32\" cy=\"32\" r=\"25.5\" fill=\"#f8fafc\" stroke=\"#ffffff\" stroke-width=\"1.5\"/>\n    <path d=\"M32 6.5a25.5 25.5 0 1 1 0 51 12.75 12.75 0 1 0 0-25.5 12.75 12.75 0 1 1 0-25.5Z\" fill=\"url(#ink)\"/>\n    <circle cx=\"32\" cy=\"19.25\" r=\"5.6\" fill=\"#f8fafc\" stroke=\"url(#teal)\" stroke-width=\"2.5\"/>\n    <circle cx=\"32\" cy=\"44.75\" r=\"5.6\" fill=\"#111827\" stroke=\"url(#gold)\" stroke-width=\"2.5\"/>\n    <path d=\"M17.5 32c3.6-7.5 8.5-11.2 14.5-11.2S43 24.5 46.5 32c-3.6 7.5-8.5 11.2-14.5 11.2S21 39.5 17.5 32Z\" stroke=\"#2563eb\" stroke-width=\"2.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\" opacity=\".72\"/>\n    <circle cx=\"17.5\" cy=\"32\" r=\"3.4\" fill=\"#2563eb\" stroke=\"#f8fafc\" stroke-width=\"1.6\"/>\n    <circle cx=\"46.5\" cy=\"32\" r=\"3.4\" fill=\"#14b8a6\" stroke=\"#f8fafc\" stroke-width=\"1.6\"/>\n    <circle cx=\"32\" cy=\"8.5\" r=\"2.4\" fill=\"#f59e0b\"/>\n    <circle cx=\"48.6\" cy=\"15.4\" r=\"2.4\" fill=\"#14b8a6\"/>\n    <circle cx=\"55.5\" cy=\"32\" r=\"2.4\" fill=\"#2563eb\"/>\n    <circle cx=\"48.6\" cy=\"48.6\" r=\"2.4\" fill=\"#f59e0b\"/>\n    <circle cx=\"32\" cy=\"55.5\" r=\"2.4\" fill=\"#14b8a6\"/>\n    <circle cx=\"15.4\" cy=\"48.6\" r=\"2.4\" fill=\"#2563eb\"/>\n    <circle cx=\"8.5\" cy=\"32\" r=\"2.4\" fill=\"#f59e0b\"/>\n    <circle cx=\"15.4\" cy=\"15.4\" r=\"2.4\" fill=\"#14b8a6\"/>\n  </g>\n</svg>";
 export declare const HUANBAN_FAVICON_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 64 64\" role=\"img\" aria-label=\"Huanban workflow icon\">\n  <defs>\n    <linearGradient id=\"ink\" x1=\"14\" y1=\"8\" x2=\"50\" y2=\"56\" gradientUnits=\"userSpaceOnUse\">\n      <stop offset=\"0\" stop-color=\"#0f172a\"/>\n      <stop offset=\"1\" stop-color=\"#27364a\"/>\n    </linearGradient>\n    <linearGradient id=\"teal\" x1=\"12\" y1=\"12\" x2=\"52\" y2=\"52\" gradientUnits=\"userSpaceOnUse\">\n      <stop offset=\"0\" stop-color=\"#2dd4bf\"/>\n      <stop offset=\"1\" stop-color=\"#0f766e\"/>\n    </linearGradient>\n    <linearGradient id=\"gold\" x1=\"45\" y1=\"10\" x2=\"20\" y2=\"56\" gradientUnits=\"userSpaceOnUse\">\n      <stop offset=\"0\" stop-color=\"#fde68a\"/>\n      <stop offset=\"1\" stop-color=\"#f59e0b\"/>\n    </linearGradient>\n  </defs>\n  <circle cx=\"32\" cy=\"32\" r=\"29\" fill=\"#f8fafc\" stroke=\"url(#ink)\" stroke-width=\"3\"/>\n  <path d=\"M32 6.5a25.5 25.5 0 1 1 0 51 12.75 12.75 0 1 0 0-25.5 12.75 12.75 0 1 1 0-25.5Z\" fill=\"url(#ink)\"/>\n  <circle cx=\"32\" cy=\"19.25\" r=\"5.6\" fill=\"#f8fafc\" stroke=\"url(#teal)\" stroke-width=\"2.5\"/>\n  <circle cx=\"32\" cy=\"44.75\" r=\"5.6\" fill=\"#111827\" stroke=\"url(#gold)\" stroke-width=\"2.5\"/>\n  <path d=\"M17.5 32c3.6-7.5 8.5-11.2 14.5-11.2S43 24.5 46.5 32c-3.6 7.5-8.5 11.2-14.5 11.2S21 39.5 17.5 32Z\" stroke=\"#2563eb\" stroke-width=\"2.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\" opacity=\".78\"/>\n  <circle cx=\"17.5\" cy=\"32\" r=\"3.4\" fill=\"#2563eb\" stroke=\"#f8fafc\" stroke-width=\"1.6\"/>\n  <circle cx=\"46.5\" cy=\"32\" r=\"3.4\" fill=\"#14b8a6\" stroke=\"#f8fafc\" stroke-width=\"1.6\"/>\n</svg>";
 export declare const HUANBAN_LOGO_DATA_URI: string;
 export declare const HUANBAN_FAVICON_DATA_URI: string;
-//# sourceMappingURL=browser-assets.d.ts.map

package/dist/standalone/canvas-view.d.ts

@@ -0,0 +1,6 @@
+export type CanvasGridType = 'mesh' | 'dot';
+export declare function getCanvasGridType(lf: any): CanvasGridType;
+export declare function setCanvasGridType(lf: any, type: CanvasGridType): boolean;
+export declare function areCanvasEdgeLabelsHidden(lf: any): boolean;
+export declare function setCanvasEdgeLabelsHidden(lf: any, hidden: boolean): boolean;
+export declare function syncCanvasLevelOfDetail(lf: any): 0 | 1 | 2;

package/dist/standalone/code-editor-language-loaders.d.ts

@@ -0,0 +1,2 @@
+export declare function loadPythonLanguage(): Promise<typeof import("@codemirror/lang-python")>;
+export declare function loadLuaLanguage(): Promise<typeof import("@codemirror/legacy-modes/mode/lua")>;

package/dist/standalone/code-editor-language-loaders.legacy.d.ts

@@ -0,0 +1,7 @@
+import { python } from '@codemirror/lang-python';
+export declare function loadPythonLanguage(): Promise<{
+    python: typeof python;
+}>;
+export declare function loadLuaLanguage(): Promise<{
+    lua: import("@codemirror/language").StreamParser<unknown>;
+}>;

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

@@ -1,31 +1,6 @@
-/**
- * @file standalone/code-editor.ts
- * @description CodeMirror 6 代码编辑器集成模块
- *
- * 功能:
- * - 创建 CodeMirror 6 编辑器实例 (替代 textarea)
- * - 支持 JavaScript / JSON / Lua / Plain 四种语言模式
- * - 内置暗色主题 (oneDark)、行号、代码折叠、自动补全
- * - 自动语法校验 (JS: linter, JSON: linter, Lua: 基础括号匹配, Plain: 不阻断)
- * - 获取/设置编辑器内容
- * - 统一销毁管理，避免内存泄漏
- *
- * 被 editor-property-drawers.ts 调用，用于节点属性中的
- * jsScript / script / json 类型字段编辑。
- *
- * @input  createCodeEditor(options) → CodeEditorInstance
- * @output CodeEditorInstance { getValue, setValue, destroy, view }
- */
 import { EditorView } from '@codemirror/view';
 import { type CompletionSource } from '@codemirror/autocomplete';
-/**
- * 代码编辑器语言类型
- * - js: JavaScript 脚本
- * - json: JSON 数据
- * - lua: Lua 脚本 (仅基础高亮, 无内置 linter)
- * - plain: SQL/表达式/未知代码类型，统一编辑器外观但不做语法阻断
- */
-export type CodeEditorLang = 'js' | 'json' | 'lua' | 'plain';
+export type CodeEditorLang = 'js' | 'json' | 'python' | 'lua' | 'plain';
 export type CodeEditorCompletionMode = 'js' | 'sql' | 'plain';
 export interface CodeEditorCompletionItem {
     label?: string;
@@ -33,99 +8,40 @@ export interface CodeEditorCompletionItem {
     detail?: string;
     type?: string;
 }
-/**
- * 创建代码编辑器的配置选项
- */
 export interface CodeEditorOptions {
-    /** 挂载的 DOM 容器元素 */
     parent: HTMLElement;
-    /** 初始代码内容 */
     value?: string;
-    /** 语言类型: js / json / lua / plain */
     lang?: CodeEditorLang;
-    /** 是否只读 */
     readOnly?: boolean;
-    /** 内容变化回调 (防抖后触发) */
     onChange?: (value: string) => void;
-    /** 语法校验状态回调: true=通过, string=错误信息 */
     onValidate?: (result: true | string) => void;
-    /** 编辑器最小高度 (px), 默认 200 */
     minHeight?: number;
-    /** 编辑器最大高度 (px), 默认 500 */
     maxHeight?: number;
-    /** Tab 缩进空格数, 默认 2 */
     tabSize?: number;
-    /** RuleGo 官方补全模式: js / sql / plain */
     completionMode?: CodeEditorCompletionMode;
-    /** 当前规则链 additionalInfo.inputSchema 解析出的 msg.* 字段 */
     schemaCompletions?: CodeEditorCompletionItem[];
-    /** LogicFlow 全局变量，用于 ${global.*} 补全 */
+    getSchemaCompletions?: () => CodeEditorCompletionItem[] | undefined;
     globalVars?: Array<string | {
         label?: string;
         value?: string;
         name?: string;
     }>;
 }
-/**
- * 代码编辑器实例 — 对外提供的操作接口
- */
 export interface CodeEditorInstance {
-    /** 获取当前编辑器内容 */
     getValue(): string;
-    /** 设置编辑器内容 (会触发 onChange 回调) */
     setValue(value: string): void;
-    /** 销毁编辑器实例，释放 DOM 和事件 */
     destroy(): void;
-    /** CodeMirror EditorView 实例 (高级用法) */
     view: EditorView;
 }
-/**
- * 创建 RuleGo 官方补全源。
- * 覆盖官方 PropertyCodeEditor.vue 中的触发协议:
- * - `${global.` → lf.globalVars
- * - `${` → `global.` 前缀
- * - `msg.` → ruleChain.additionalInfo.inputSchema.properties
- * - SQL 模式 → StreamSQL 函数/关键字
- */
 export declare function createRulegoCompletionSource(options?: {
     mode?: CodeEditorCompletionMode;
     schemaCompletions?: CodeEditorCompletionItem[];
+    getSchemaCompletions?: () => CodeEditorCompletionItem[] | undefined;
     globalVars?: Array<string | {
         label?: string;
         value?: string;
         name?: string;
     }>;
 }): CompletionSource;
-/**
- * 创建 CodeMirror 6 代码编辑器实例
- *
- * @param options - 编辑器配置 (语言、初始值、回调等)
- * @returns CodeEditorInstance — 包含 getValue / setValue / destroy 方法
- *
- * @example
- * ```ts
- * const editor = createCodeEditor({
- *   parent: document.getElementById('code-container')!,
- *   value: 'function hello() { return "world"; }',
- *   lang: 'js',
- *   onChange: (val) => console.log('内容变化:', val),
- *   onValidate: (result) => {
- *     if (result === true) console.log('语法正确');
- *     else console.log('语法错误:', result);
- *   },
- * });
- * // 获取值
- * const code = editor.getValue();
- * // 销毁
- * editor.destroy();
- * ```
- */
 export declare function createCodeEditor(options: CodeEditorOptions): CodeEditorInstance;
-/**
- * 校验代码语法
- * @param code  - 代码内容
- * @param lang  - 语言类型
- * @returns true 表示通过, string 表示错误信息
- */
 export declare function validateCode(code: string, lang: CodeEditorLang): true | string;
-//# sourceMappingURL=code-editor.d.ts.map

package/dist/standalone/connection-status-binding.d.ts

@@ -0,0 +1,8 @@
+import type { ConnectionStatusState, ConnectionStatusStore } from '../core/connection-status';
+export interface ConnectionStatusBindingHost {
+    lf: any;
+    connectionStatus: ConnectionStatusStore;
+    t?: (key: string) => string;
+}
+export declare function applyConnectionStatusSnapshot(host: ConnectionStatusBindingHost, state: ConnectionStatusState): void;
+export declare function bindConnectionStatusToLogicFlow(host: ConnectionStatusBindingHost): () => void;

package/dist/standalone/custom-nodes.d.ts

@@ -1,29 +1,3 @@
-/**
- * custom-nodes.ts
- * ===============
- * 功能：LogicFlow 自定义图元注册
- *
- * 完全照搬原版 RuleGo Editor v1.2.0 的节点/边类型:
- * - BaseNode (RedNode / RedNodeModel): 基础矩形节点
- * - SimpleNode: 带图标的标准节点
- * - StartNode: 起始节点 (不可移动, 只有右锚点)
- * - EndpointNode: 端点节点 (只有右锚点)
- * - ChainNode: 子规则链节点 (只有左锚点)
- * - AgentNode / AgentOrchestrationNode: AI 智能体节点
- * - FlowLink: 贝塞尔曲线连线
- *
- * 所有节点采用 Node-RED 风格:
- * 120x30 矩形, 左侧30px图标区, 左右锚点连接
- *
- * 使用方式:
- *   import { registerCustomElements } from './custom-nodes'
- *   registerCustomElements(lf)
- */
 import LogicFlow from '@logicflow/core';
 export type CustomNodeTranslator = (key: string, fallback: string) => string;
-/**
- * 注册所有自定义图元到 LogicFlow 实例
- * @param lf - LogicFlow 画布实例
- */
 export declare function registerCustomElements(lf: LogicFlow, translate?: CustomNodeTranslator): void;
-//# sourceMappingURL=custom-nodes.d.ts.map

package/dist/standalone/drawer-unsaved-guard.d.ts

@@ -1,20 +1,13 @@
-/**
- * Shared guard for editable right-side drawers.
- *
- * The guard intentionally tracks only real form controls. Debug filters, search
- * boxes, transient picker inputs, and tab state are excluded so browsing a
- * drawer does not trigger an unsaved-change prompt.
- */
 export type DrawerCloseDecision = 'save' | 'discard' | 'cancel';
 export interface DrawerGuardI18nContext {
     t(key: string, params?: Record<string, string>): string;
+    _activeDrawerWrapper?: HTMLElement | null;
 }
 export interface DrawerSnapshotOptions {
     selector?: string;
-    extra?: unknown;
+    extra?: unknown | (() => unknown);
     beforeCapture?: () => void;
 }
 export declare function captureDrawerFormSnapshot(root: ParentNode, options?: DrawerSnapshotOptions): string;
 export declare function isDrawerFormDirty(root: ParentNode, initialSnapshot: string, options?: DrawerSnapshotOptions): boolean;
 export declare function confirmDrawerUnsavedClose(ctx: DrawerGuardI18nContext): Promise<DrawerCloseDecision>;
-//# sourceMappingURL=drawer-unsaved-guard.d.ts.map

package/dist/standalone/edge-label-quick-editor.d.ts

@@ -0,0 +1,2 @@
+export declare function applyEdgeLabelValues(editor: any, edgeModel: any, values: string[]): boolean;
+export declare function setupEdgeLabelQuickEditor(editor: any): () => void;

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

@@ -0,0 +1,4 @@
+import type { EditorActionSource, EditorSelectionSnapshot } from '../core/ActionRegistry';
+export declare function getEditorSelectionSnapshot(editor: any): EditorSelectionSnapshot;
+export declare function registerDefaultEditorActions(editor: any): void;
+export declare function invokeEditorAction(editor: any, id: string, source?: EditorActionSource): Promise<boolean>;

package/dist/standalone/editor-chain-info.d.ts

@@ -1,47 +1,14 @@
-/**
- * @file standalone/editor-chain-info.ts
- * @description 链信息 Drawer 模块 — 从 HuanbanRulegoEditor.ts 中提取
- *
- * 包含以下功能:
- * - 链信息 Drawer (showChainInfoDrawer) — 基础信息、输入定义、变量、应用集成
- * - 新增变量/密钥弹窗 (showAddVarDialog)
- *
- * 每个函数接收 editor 实例作为参数 (ChainInfoContext 接口),
- * 避免与主类产生循环依赖。
- */
-/**
- * 链信息模块需要访问的编辑器上下文接口
- * 使用接口而非直接引用 HuanbanRulegoEditor 类, 避免循环依赖
- */
 export interface ChainInfoContext {
-    /** EditorCore 数据引擎实例 */
     core: any;
-    /** 编辑器配置选项 (需要 apiBase, onChange 等) */
     opts: any;
-    /** 国际化翻译方法 */
     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;
+    _markSavedSnapshot?(data?: any): void;
 }
-/**
- * 显示链信息 Drawer (默认实现)
- * 对齐原版 RuleGo Server 的信息面板:
- * 1. 基础信息 — ID、名称、根规则链、调试模式、分类、描述
- * 2. 输入定义 — additionalInfo.inputSchema 可视化/JSON 编辑
- * 3. 变量 — vars / secrets 表格
- * 4. 应用集成 — 同步/异步/OpenAI/MCP 调用接口
- *
- * @param ctx - 编辑器上下文
- * @param chain - 当前规则链数据对象
- */
 export declare function showChainInfoDrawer(ctx: ChainInfoContext, chain: any): void;
-/**
- * 显示新增变量/密钥弹窗
- * @param ctx - 编辑器上下文
- * @param chain - 当前规则链数据
- * @param isSecret - true=密钥, false=变量
- */
 export declare function showAddVarDialog(ctx: ChainInfoContext, chain: any, isSecret: boolean): void;
-//# sourceMappingURL=editor-chain-info.d.ts.map

package/dist/standalone/editor-context-menu.d.ts

@@ -1,22 +1 @@
-/**
- * @file standalone/editor-context-menu.ts
- * @description 画布右键菜单模块
- *
- * 功能:
- * - 画布空白处右键: 全选 / 适应画布 / 重置缩放 / 粘贴节点
- * - 节点右键: 编辑 / 复制 / 从此节点开始执行 / 仅执行此节点 / 删除 / 断开连接
- * - 连线右键: 编辑 / 删除
- * - 自动定位在鼠标位置
- * - 点击菜单外自动关闭
- *
- * @param editor - HuanbanRulegoEditor 实例
- */
-/**
- * 初始化右键菜单事件绑定
- * 在 HuanbanRulegoEditor.init() 中调用一次
- *
- * @param editor - 编辑器实例
- * @returns 清理函数
- */
 export declare function setupContextMenu(editor: any): () => void;
-//# sourceMappingURL=editor-context-menu.d.ts.map

package/dist/standalone/editor-debug-ws.d.ts

@@ -1,190 +1,82 @@
-/**
- * @file editor-debug-ws.ts
- * @description WebSocket 实时调试日志管理模块
- *
- * 职责:
- * 1. 建立 WebSocket 连接，接收后端推送的实时调试日志
- * 2. 管理连接生命周期（连接、断线重连、销毁）
- * 3. 将日志消息渲染到终端面板
- *
- * API 端点:
- *   ws(s)://<apiBase>/logs/ws/<chainId>/<clientId>
- *   (apiBase 已包含 /api/v1 前缀)
- *
- * 消息格式 (每条 JSON):
- *   { ts (UnixMilli), flowType, relationType, nodeId, msg: RuleMsg, err }
- *
- * 使用方式:
- *   const ws = new DebugWebSocket(apiBase, chainId, nodeId, { onMessage, onStatus })
- *   ws.connect()
- *   // ... 关闭 Drawer 时
- *   ws.destroy()
- */
-/**
- * WebSocket 连接状态
- */
-export type WsStatus = 'connecting' | 'live' | 'disconnected' | 'error';
-/**
- * WebSocket 回调选项
- * @property onMessage  - 收到日志消息时触发
- * @property onStatus   - 连接状态变化时触发
- */
+export type WsStatus = 'connecting' | 'live' | 'reconnecting' | 'disconnected' | 'error';
+export type DebugWsStatusReason = 'connecting' | 'connected' | 'socket-error' | 'socket-closed' | 'reconnecting' | 'max-reconnects' | 'manual-stop' | 'destroy';
+export interface DebugWsStatusDetails {
+    reconnectAttempt: number;
+    lifetimeReconnectAttempt: number;
+    maxReconnects: number;
+    maxLifetimeReconnects: number;
+    closeCode: number | null;
+    intentional: boolean;
+    reason: DebugWsStatusReason;
+}
+export interface DebugWebSocketOptions {
+    wsUrl?: string;
+    wsBase?: string;
+    wsRoot?: string;
+    maxReconnects?: number;
+    maxLifetimeReconnects?: number;
+    reconnectBaseDelayMs?: number;
+    reconnectMaxDelayMs?: number;
+}
+export declare const DEFAULT_DEBUG_WS_MAX_RECONNECTS = 5;
+export declare const DEFAULT_DEBUG_WS_MAX_LIFETIME_RECONNECTS = 20;
+export declare const DEFAULT_DEBUG_WS_STABLE_RESET_DELAY_MS = 10000;
 export interface DebugWsCallbacks {
-    /** 收到一条新日志时调用 */
     onMessage: (item: any) => void;
-    /** 连接状态变化时调用 */
-    onStatus: (status: WsStatus) => void;
+    onStatus: (status: WsStatus, closeCode?: number | null, details?: DebugWsStatusDetails) => void;
 }
 export interface LiveTerminalRendererOptions {
     getNodeName?: (nodeId: string) => string;
 }
-/**
- * 调试日志 WebSocket 管理器
- *
- * 特性:
- * - 自动重连（指数退避 1s → 2s → 4s → ... 最大 16s）
- * - 最多重连 5 次后停止
- * - destroy() 后不再重连
- * - 心跳 ping（每 30 秒发送 "ping"，保活）
- */
 export declare class DebugWebSocket {
-    /** HTTP(S) API 基础路径，如 http://localhost:9090/api/v1 */
     private apiBase;
-    /** 规则链 ID */
     private chainId;
-    /** 客户端 ID (用于服务端标识连接，断开时移除 observer) */
     private clientId;
-    /** 回调函数 */
     private callbacks;
-    /** WebSocket 实例 */
+    private options;
     private ws;
-    /** 是否已主动销毁 */
     private destroyed;
-    /** 重连次数计数 */
+    private stopped;
+    private started;
+    private lastStatus;
     private reconnectCount;
-    /** 最大重连次数 */
-    private maxReconnects;
-    /** 重连定时器 */
+    private lifetimeReconnectCount;
     private reconnectTimer;
-    /** 心跳定时器 */
     private pingTimer;
-    /**
-     * 构造函数
-     * @param apiBase   - API 基础路径 (http(s)://host/api/v1)
-     * @param chainId   - 规则链 ID
-     * @param clientId  - 客户端标识 (唯一，服务端用于管理 observer)
-     * @param callbacks - 回调函数
-     */
-    constructor(apiBase: string, chainId: string, clientId: string, callbacks: DebugWsCallbacks);
-    /**
-     * 建立 WebSocket 连接
-     * 如果已连接则先关闭旧连接再重连
-     */
+    private stableResetTimer;
+    constructor(apiBase: string, chainId: string, clientId: string, callbacks: DebugWsCallbacks, options?: DebugWebSocketOptions);
     connect(): void;
-    /**
-     * 主动断开连接，不再重连
-     * 通常在 Drawer 关闭时调用
-     */
+    stop(): void;
+    private connectInternal;
     destroy(): void;
-    /**
-     * 获取当前连接状态
-     */
     isConnected(): boolean;
-    /**
-     * 构建 WebSocket URL
-     * 将 http(s) 替换为 ws(s)，拼接调试日志 WebSocket 路径
-     *
-     * RuleGo Server 路径: /api/v1/logs/ws/:chainId/:clientId
-     *
-     * @returns WebSocket URL 字符串
-     */
     private buildWsUrl;
-    /**
-     * 处理收到的消息
-     * 支持单条 JSON 和批量 JSON (每行一条)
-     *
-     * @param data - 原始消息数据
-     */
     private handleMessage;
-    /**
-     * 安排断线重连（指数退避）
-     */
     private scheduleReconnect;
-    /**
-     * 关闭当前 WebSocket 连接
-     */
+    private emitStatus;
+    private clearReconnectTimer;
+    private clearStableResetTimer;
     private closeSocket;
-    /**
-     * 启动心跳 ping (每 30 秒发送一次)
-     */
     private startPing;
-    /**
-     * 停止心跳 ping
-     */
     private stopPing;
 }
-/**
- * 实时日志终端 — 将 WebSocket 推送的日志渲染到终端面板
- *
- * 特性:
- * - 最大保留 500 条日志 (FIFO)
- * - 自动滚动到最新
- * - 支持清空
- */
+export declare function resolveDebugWsUrl(apiBase: string, chainId: string, clientId: string, options?: Pick<DebugWebSocketOptions, 'wsUrl' | 'wsBase' | 'wsRoot'>): string;
 export declare class LiveTerminalRenderer {
-    /** 终端面板 DOM 元素 */
     private container;
-    /** 日志缓冲区 */
     private buffer;
-    /** IN 日志时间索引，用于按官方 chainId + msgId + nodeId 计算 OUT 耗时 */
     private inTsByMsgNode;
-    /** 最大缓冲条数 */
     private maxLines;
-    /** 渲染选项 */
     private options;
-    /** 已安排但尚未执行的终端渲染帧 */
     private pendingRenderFrame;
-    /** requestAnimationFrame 不可用时的降级渲染定时器 */
     private pendingRenderTimer;
-    /** 是否已经销毁，销毁后不再追加或渲染 */
     private destroyed;
-    /**
-     * @param container  - 终端面板元素
-     * @param _escapeHtml - 兼容旧构造签名；当前渲染使用 textContent，不再需要 HTML 字符串转义
-     */
     constructor(container: HTMLElement, _escapeHtml: (text: string) => string, options?: LiveTerminalRendererOptions);
-    /**
-     * 追加一条日志消息
-     * @param item - 日志条目对象
-     */
     appendLog(item: any): void;
-    /**
-     * 清空所有日志
-     */
     clear(): void;
-    /**
-     * 销毁渲染器，释放待渲染帧、DOM 内容和内部索引。
-     */
     destroy(): void;
-    /**
-     * 获取当前日志条数
-     */
     getCount(): number;
-    /**
-     * 重新渲染终端内容并自动滚动到底部
-     */
     private render;
-    /**
-     * 格式化单条日志为终端结构化文本
-     *
-     * @param item - 日志条目
-     * @returns 终端行数据
-     */
     private formatLogLine;
-    /**
-     * 高频 WebSocket 日志下按帧合并渲染，避免每条消息全量 replaceChildren。
-     */
     private scheduleRender;
     private cancelScheduledRender;
 }
-//# sourceMappingURL=editor-debug-ws.d.ts.map

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

@@ -6,4 +6,3 @@ export declare function confirmGraphElementsDelete(editor: any, nodes?: any[], e
 export declare function canDeleteNodesWithInputGuard(editor: any, selectedNodes: any[]): boolean;
 export declare function deleteGraphElementsWithInputGuard(editor: any, nodes?: any[], edges?: any[], options?: DeleteGraphElementsOptions): boolean;
 export declare function deleteSelectedElementsWithInputGuard(editor: any): boolean;
-//# sourceMappingURL=editor-delete.d.ts.map