@huanban/rulego-editor-core 1.1.1 → 1.1.2

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

@@ -22,6 +22,8 @@ export interface EditorContext {
     core: any;
     /** 编辑器配置选项 */
     opts: any;
+    /** 编辑器根容器 */
+    rootEl?: HTMLElement;
     /** 组件列表 */
     components: any[];
     /** 侧边栏展开的分组集合 */
@@ -43,12 +45,33 @@ export interface EditorContext {
     /** 关闭 Modal */
     _closeModal(): void;
 }
+export interface RunPanelOptions {
+    fromNodeId?: string;
+    onlyThisNode?: boolean;
+    initialMode?: 'form' | 'chat';
+    initialTab?: 'response' | 'resp_headers' | 'debug' | 'history' | 'integration';
+    section?: string;
+}
+export type SettingsDialogTab = 'user' | 'setting' | 'ai' | 'skills';
+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[];
 /**
- * 显示规则链选择器弹窗 — 支持搜索和分页
- * 数据来源: opts.ruleItems (初始传入) 或远程 API
+ * 显示规则链选择器左侧抽屉 — 支持主链/子链 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 数据 + 下载画布 PNG 截图
@@ -57,12 +80,12 @@ export declare function showRuleChainSelector(ctx: EditorContext): void;
  */
 export declare function showExportDialog(ctx: EditorContext): void;
 /**
- * 显示运行面板 Drawer
+ * 显示运行面板
  * 可发送消息到规则链并查看响应
  * slot: onRunClick 可劫持
  * @param ctx - 编辑器上下文
  */
-export declare function showRunPanel(ctx: EditorContext): void;
+export declare function showRunPanel(ctx: EditorContext, options?: RunPanelOptions): void;
 /**
  * 显示组件管理弹窗
  * 已安装列表 + 组件市场（搜索/安装）

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

@@ -8,6 +8,7 @@
  *
  * @param editor - HuanbanRulegoEditor 实例引用
  */
+export { showEditorToast } from './editor-toast';
 /**
  * 桥接 LogicFlow 画布事件到 EditorCore + 外部回调
  *
@@ -24,5 +25,5 @@
  *
  * @param editor - 编辑器实例 (需要含 lf / core / opts 等属性)
  */
-export declare function bridgeEvents(editor: any): void;
+export declare function bridgeEvents(editor: any): () => void;
 //# sourceMappingURL=editor-events.d.ts.map

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

@@ -52,7 +52,33 @@ export declare function renderDebugTerminal(ctx: PropertyDrawerContext, wrapper:
  * @param wrapper - drawer 外层 DOM
  * @param msg     - 显示的提示文本
  */
-export declare function renderDebugEmpty(ctx: PropertyDrawerContext, wrapper: HTMLElement, msg: string): void;
+export declare function renderDebugEmpty(_ctx: PropertyDrawerContext, wrapper: HTMLElement, msg: string): void;
+interface DebugLogPage {
+    items: any[];
+    total: number;
+    page: number;
+    size: number;
+}
+interface DebugTerminalFilters {
+    showIn: boolean;
+    showOut: boolean;
+}
+export declare function normalizeDebugLogPage(raw: unknown, fallbackPage?: number, fallbackSize?: number): DebugLogPage;
+export declare function normalizeDebugLogItems(raw: unknown): any[];
+export declare function filterDebugLogTerminalItems(items: any[], filters: DebugTerminalFilters): any[];
+export interface NodeRelationSummaryRow {
+    label: string;
+    value: string;
+}
+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: 详情、调试日志、帮助
@@ -73,6 +99,8 @@ export declare function showNodePropertyDrawer(ctx: PropertyDrawerContext, model
  * @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[]): void;
+export declare function showEdgePropertyDrawer(ctx: 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

@@ -23,6 +23,55 @@
  * @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 RouteTableRenderOptions {
+    nodeType: string;
+    pathLabel: string;
+    hideFromProcessors: boolean;
+    hideToProcessors: boolean;
+    supportsWait: boolean;
+    isMcp: boolean;
+    isUniquePath?: boolean;
+    labels: {
+        preProcessor: string;
+        postProcessor: string;
+        wait: string;
+        toolDesc: string;
+        operate: string;
+        edit: string;
+        delete: string;
+        empty: string;
+        yes: string;
+        no: string;
+    };
+}
+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 renderRouteTableHeader(row: Element, options: RouteTableRenderOptions): void;
+export declare function renderRouteTableBody(tbody: Element, routers: RouterItem[], options: RouteTableRenderOptions, startIndex?: number): void;
 /**
  * 将路由设置内容渲染到指定的 Tab 容器中
  *

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

@@ -9,6 +9,15 @@
  *
  * @param editor - HuanbanRulegoEditor 实例引用
  */
+import type { ComponentDefinition } from '../types/component';
+export interface DragNodeData {
+    type: string;
+    text: string;
+    properties: {
+        model: Record<string, unknown>;
+        view: ComponentDefinition;
+    };
+}
 /**
  * 渲染侧边栏组件列表
  * 按 category 分组展示，支持搜索过滤、折叠/展开
@@ -16,4 +25,6 @@
  * @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-toast.d.ts

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

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

@@ -14,6 +14,12 @@
  *
  * @param editor - HuanbanRulegoEditor 实例引用
  */
+type ExternalOperationResult = void | boolean | {
+    success?: boolean;
+    msg?: string;
+    message?: string;
+};
+export declare function isExternalOperationSuccess(result: ExternalOperationResult): boolean;
 /**
  * 工具栏按钮点击事件处理
  * 根据 data-action 分发到对应的处理函数
@@ -22,6 +28,11 @@
  * @param e - 原始点击事件
  */
 export declare function handleToolbarClick(editor: any, e: Event): void;
+export declare function updateToolbarHistoryState(editor: any, state?: {
+    undoAble?: boolean;
+    redoAble?: boolean;
+}): void;
+export declare function bindFullscreenState(editor: any): () => void;
 /**
  * 切换语言（中英文互切）并刷新工具栏 + 侧边栏文本
  * 不销毁重建 UI，仅精准更新 DOM 内的按钮文字
@@ -62,7 +73,7 @@ export declare function applyTheme(editor: any, themeId: string): void;
  *
  * @param editor - 编辑器实例
  */
-export declare function toggleThemeMenu(editor: any): void;
+export declare function toggleThemeMenu(editor: any, target?: Element | null): void;
 /**
  * 关闭主题下拉菜单
  *
@@ -86,4 +97,5 @@ export declare function refreshThemeDropdown(editor: any): void;
  * @returns 清理函数 (用于 destroy 时移除监听)
  */
 export declare function setupKeyboardShortcuts(editor: any): () => void;
+export {};
 //# sourceMappingURL=editor-toolbar.d.ts.map

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

@@ -37,6 +37,13 @@ import LogicFlow from '@logicflow/core';
  * 这些组件在画布上会展示为可包含子节点的容器
  */
 export declare const GROUP_NODE_TYPES: string[];
+type GroupNodeTranslator = (key: 'onlyRightAnchorOut' | 'notToInput' | 'onlyLeftAnchorIn', fallback: string) => string;
+export declare function isGroupAppendAllowed(nodeData: {
+    type?: string;
+} | 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 实例
  *
@@ -49,5 +56,6 @@ export declare const GROUP_NODE_TYPES: string[];
  *
  * @param lf - LogicFlow 画布实例
  */
-export declare function registerGroupNode(lf: LogicFlow): void;
+export declare function registerGroupNode(lf: LogicFlow, translate?: GroupNodeTranslator): void;
+export {};
 //# sourceMappingURL=group-node.d.ts.map

package/dist/standalone/index.d.ts

@@ -2,8 +2,10 @@
  * @file standalone/index.ts
  * @description HuanbanRulegoEditor 入口的 barrel 导出
  */
-export { HuanbanRulegoEditor } from './HuanbanRulegoEditor';
-export type { HuanbanRulegoEditorOptions } from './HuanbanRulegoEditor';
+export { HuanbanRulegoEditor, applyComponentsRuntimePayloadOptions, normalizeComponentsPayload, normalizeComponentsRawPayload, } from './HuanbanRulegoEditor';
+export type { AIAssistantOpenOptions, HuanbanRulegoEditorOptions } from './HuanbanRulegoEditor';
 /** 调试日志工具 — 可通过 setDebug(true) 开启编辑器内部调试日志 */
 export { debugLog, setDebug, isDebug } from './logger';
+export { escapeHtml, escapeAttr, setSafeText, safeUrl, safeImageUrl, safeCssColor, sanitizeRichHtml, sanitizeDescription, redactSensitive, formatJsonBounded, parseJsonBounded, } from './security-utils';
+export type { RichHtmlPolicy, RedactOptions, FormatJsonBoundedOptions, ParseJsonBoundedOptions, } from './security-utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/standalone/layout-scheduler.d.ts

@@ -0,0 +1,16 @@
+type ResizeTarget = {
+    resize?: (...args: any[]) => void;
+};
+export interface ScheduleEditorResizeOptions {
+    delayMs?: number;
+    args?: any[];
+}
+/**
+ * Coalesces LogicFlow resize calls into one animation-frame pass plus an optional
+ * delayed pass for CSS transitions. This prevents drawer/settings toggles from
+ * issuing several resize calls in the same layout frame.
+ */
+export declare function scheduleEditorResize(target: ResizeTarget | null | undefined, options?: ScheduleEditorResizeOptions): void;
+export declare function cancelScheduledEditorResize(target: ResizeTarget | null | undefined): void;
+export {};
+//# sourceMappingURL=layout-scheduler.d.ts.map

package/dist/standalone/lifecycle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file standalone/lifecycle.ts
+ * @description Small cleanup registry for standalone DOM and runtime resources.
+ */
+export type Cleanup = () => void;
+export declare class CleanupBag {
+    private cleanups;
+    add(cleanup: Cleanup | null | undefined | void): void;
+    listen(target: EventTarget | null | undefined, type: string, handler: EventListenerOrEventListenerObject, options?: AddEventListenerOptions | boolean): void;
+    timeout(id: ReturnType<typeof setTimeout> | null | undefined): void;
+    interval(id: ReturnType<typeof setInterval> | null | undefined): void;
+    frame(id: number | null | undefined): void;
+    dispose(): void;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/standalone/models-dev-catalog.d.ts

@@ -0,0 +1,53 @@
+import type { AiProviderOption } from '../types/editor';
+export declare const MODELS_DEV_API_URL = "https://models.dev/api.json";
+export declare const MODELS_DEV_CACHE_KEY = "huanban.rulego-editor.models-dev.catalog.v1";
+export declare const MODELS_DEV_CACHE_TTL_MS: number;
+export declare const MODELS_DEV_MAX_PROVIDERS = 260;
+export declare const MODELS_DEV_MAX_MODELS_PER_PROVIDER = 800;
+export interface ModelsDevCatalogModel {
+    id: string;
+    name: string;
+    description?: string;
+    family?: string;
+    status?: string;
+    reasoning?: boolean;
+    toolCall?: boolean;
+    attachment?: boolean;
+    inputModalities?: string[];
+    outputModalities?: string[];
+    contextLimit?: number;
+    outputLimit?: number;
+    inputCost?: number;
+    outputCost?: number;
+    cacheReadCost?: number;
+    cacheWriteCost?: number;
+    lastUpdated?: string;
+    releaseDate?: string;
+}
+export interface ModelsDevCatalogProvider {
+    id: string;
+    name: string;
+    api: string;
+    doc?: string;
+    env?: string[];
+    models: ModelsDevCatalogModel[];
+}
+export interface ModelsDevCatalog {
+    fetchedAt: number;
+    providers: ModelsDevCatalogProvider[];
+}
+export interface ModelsDevLoadResult {
+    catalog: ModelsDevCatalog | null;
+    source: 'memory' | 'cache' | 'network' | 'unavailable';
+    error?: string;
+}
+export declare function normalizeModelsDevCatalog(raw: unknown, fetchedAt?: number): ModelsDevCatalog;
+export declare function modelsDevProvidersToAiProviders(catalog: ModelsDevCatalog | null): AiProviderOption[];
+export declare function mergeAiProvidersWithModelsDev(baseProviders: AiProviderOption[], catalog: ModelsDevCatalog | null): AiProviderOption[];
+export declare function loadModelsDevProviderCatalog(options?: {
+    force?: boolean;
+    fetcher?: typeof fetch;
+    maxAgeMs?: number;
+}): Promise<ModelsDevLoadResult>;
+export declare function clearModelsDevCatalogMemoryForTest(): void;
+//# sourceMappingURL=models-dev-catalog.d.ts.map

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

@@ -18,11 +18,15 @@
  *   import { CATEGORY_CONFIG, getCategoryKey, getCategoryConfig, adapterComponentsLocal } from './node-definitions'
  *   import { DEFAULT_NODE_VIEWS } from './node-views-data'  // 需要数据时直接引入
  */
+import { type AiProviderOption } from './ai-providers';
 export { DEFAULT_NODE_VIEWS } from './node-views-data';
-/** 分类颜色映射（label 通过 i18n 动态获取） */
-export declare const CATEGORY_CONFIG: Record<string, {
+interface CategoryConfig {
     bg: string;
-}>;
+    label?: string;
+    nodeType?: string;
+}
+/** 分类颜色映射（label 通过 i18n 动态获取） */
+export declare const CATEGORY_CONFIG: Record<string, CategoryConfig>;
 /**
  * 分类在侧边栏 / 管理列表中的显示顺序
  * 不在此列表中的分类会排到末尾（按字母序）
@@ -48,14 +52,25 @@ export declare const CATEGORY_PATH_MAP: Record<string, string>;
  * @returns 标准化的分类键
  */
 export declare function getCategoryKey(rawCat: string): string;
+export declare function resolveRuntimeCategoryKey(component: any, isEndpoint?: boolean): string;
 /**
  * 获取分类配置 (未知分类用默认色 #86B4E5FF)
  * @param cat - 分类键
  * @returns 分类配置对象 { bg: 颜色 }
  */
-export declare function getCategoryConfig(cat: string): {
-    bg: string;
-};
+export declare function getCategoryConfig(cat: string): CategoryConfig;
+export declare function adapterRelationTypeLabel(relationTypes: any, translate?: (value: string) => string): any;
+export declare function adapterEndpointDefaults(component: any, isEndpoint?: boolean): void;
+export declare function ensureStartNodeComponent(components: any[], label?: string): void;
+export interface RuntimeComponentAdapterOptions {
+    builtins?: any;
+    aiProviders?: AiProviderOption[];
+    translateRelationType?: (value: string) => string;
+    translateCategory?: (categoryKey: string) => string;
+    inferNodeType?: (component: any) => string;
+    defaultBackground?: string;
+}
+export declare function adapterRuntimeComponent(component: any, options?: RuntimeComponentAdapterOptions): string;
 /**
  * 组件国际化适配器
  * 将 fallback 翻译数据应用到组件对象上。
@@ -70,5 +85,8 @@ export declare function getCategoryConfig(cat: string): {
  * @param customViews - 可选，外部传入的自定义本地化定义，优先于默认值
  *                      调用方可传入自己的翻译字典来覆盖内置默认值
  */
-export declare function adapterComponentsLocal(component: any, customViews?: Record<string, any>): void;
+export declare function adapterComponentsLocal(component: any, customViews?: Record<string, any>, translateRelationType?: (value: string) => string): void;
+export declare function injectProviderField(component: any, providers?: AiProviderOption[]): void;
+export declare function adapterBuiltins(component: any, builtins: any, categoryName?: string): void;
+export declare function adapterRules(component: any): void;
 //# sourceMappingURL=node-definitions.d.ts.map

package/dist/standalone/official-node-view-patches.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file official-node-view-patches.ts
+ * @description 官方 RuleGo editor zh i18n 节点渲染协议补丁。
+ *
+ * 生成来源:
+ * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/index.js
+ * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/endpoint.js
+ * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/extend.js
+ * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/ai.js
+ *
+ * 注意: 原官方 loadData 函数被归一化为 component.source，用于 standalone 渲染器
+ * 在运行时从当前画布或规则链列表补齐 options。
+ */
+export declare const OFFICIAL_NODE_VIEW_PATCHES: Record<string, any>;
+//# sourceMappingURL=official-node-view-patches.d.ts.map

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

@@ -0,0 +1,45 @@
+/**
+ * @file standalone/security-utils.ts
+ * @description Browser-side safety helpers for text, URLs, bounded JSON, and redaction.
+ */
+export type RichHtmlPolicy = {
+    allowRichDescription?: boolean;
+    allowedLinkOrigins?: string[];
+    maxRichHtmlChars?: number;
+};
+export type RedactOptions = {
+    maxDepth?: number;
+    maxString?: number;
+    maxArray?: number;
+    sensitiveKeys?: RegExp[];
+};
+export type FormatJsonBoundedOptions = RedactOptions & {
+    maxChars?: number;
+    redact?: boolean;
+    space?: number;
+};
+export type ParseJsonBoundedOptions = {
+    maxBytes?: number;
+    label?: string;
+};
+export declare function escapeHtml(value: unknown): string;
+export declare function escapeAttr(value: unknown): string;
+export declare function setSafeText(el: Element | null | undefined, value: unknown): void;
+export declare function safeUrl(value: unknown, opts?: {
+    allowRelative?: boolean;
+    allowedProtocols?: string[];
+    allowedOrigins?: string[];
+    base?: string;
+}): string | null;
+export declare function safeImageUrl(value: unknown, opts?: {
+    allowDataImage?: boolean;
+    allowedOrigins?: string[];
+    builtInResolver?: (value: string) => string | null;
+}): string | null;
+export declare function safeCssColor(value: unknown, fallback?: string): string;
+export declare function sanitizeDescription(value: unknown, policy?: RichHtmlPolicy): string;
+export declare function sanitizeRichHtml(value: unknown, policy?: RichHtmlPolicy): string;
+export declare function redactSensitive<T>(value: T, opts?: RedactOptions): T;
+export declare function formatJsonBounded(value: unknown, opts?: FormatJsonBoundedOptions): string;
+export declare function parseJsonBounded<T = unknown>(raw: string, opts?: ParseJsonBoundedOptions): T;
+//# sourceMappingURL=security-utils.d.ts.map

package/dist/test/setup-dom.d.ts

@@ -0,0 +1,3 @@
+declare function createEmptyDomRect(): DOMRect;
+declare function createEmptyDomRectList(): DOMRectList;
+//# sourceMappingURL=setup-dom.d.ts.map

package/dist/types/component.d.ts

@@ -107,7 +107,16 @@ export interface ComponentGroup {
  * 从后端 API 返回的原始组件数据
  * 可能需要经过 adapterComponents 转换后才能使用
  */
-export type RawComponentData = ComponentDefinition[];
+export interface RawComponentPayloadSections {
+    endpoints?: ComponentDefinition[];
+    nodes?: ComponentDefinition[];
+    components?: ComponentDefinition[];
+    builtins?: Record<string, unknown>;
+    skillPath?: string;
+    data?: unknown;
+    [key: string]: unknown;
+}
+export type RawComponentData = ComponentDefinition[] | RawComponentPayloadSections;
 /**
  * 组件注册表选项
  */

package/dist/types/editor.d.ts

@@ -73,6 +73,40 @@ export interface GridConfig {
         color: string;
     };
 }
+/**
+ * AI 供应商预设选项
+ * 与官方 RuleGo editorOptions.aiProviders / aiEmbeddingProviders 协议保持兼容。
+ */
+export interface AiProviderOption {
+    /** 供应商 ID */
+    id?: string;
+    /** 兼容 select value 写法 */
+    value?: string;
+    /** 展示名称 */
+    label?: string;
+    /** 兼容 name 写法 */
+    name?: string;
+    /** OpenAI 兼容 API 地址 */
+    url?: string;
+    /** 默认模型 */
+    defaultModel?: string;
+    /** 模型下拉选项 */
+    models?: Array<string | {
+        label?: string;
+        value?: string;
+        [key: string]: unknown;
+    }>;
+    /** 数据来源，如 builtin、models.dev 或宿主自定义 */
+    source?: string;
+    /** 文档地址 */
+    doc?: string;
+    /** 推荐环境变量名 */
+    env?: string[];
+    /** 供应商模型数量，用于大目录检索展示 */
+    modelCount?: number;
+    /** 保留宿主扩展字段 */
+    [key: string]: unknown;
+}
 /**
  * 编辑器初始化选项
  * 创建编辑器实例时传入，合并默认值后使用
@@ -94,8 +128,20 @@ export interface EditorOptions {
     startX?: number;
     /** 起始节点的 Y 坐标 (默认: 280) */
     startY?: number;
-    /** 预加载的组件列表 (如果提供则不从 API 加载) */
-    components?: ComponentDefinition[];
+    /** 预加载的组件列表，支持数组或官方 /api/v1/components 分段返回 */
+    components?: RawComponentData;
+    /** AI 供应商预设；对齐官方 editorOptions.aiProviders */
+    aiProviders?: AiProviderOption[];
+    /** 是否显示工具栏按钮文字，默认 false；设为 true 时显示图标 + 文字 */
+    showToolbarButtonLabels?: boolean;
+    /** 工具栏是否只显示图标，默认 true；显式 false 时可显示文字 */
+    toolbarIconOnly?: boolean;
+    /** 运行面板 AI 对话发送到 /rules/{chainId}/v1/chat/completions 的模型名 */
+    runChatModel?: string;
+    /** 兼容旧集成命名；未设置 runChatModel 时作为运行面板 AI 对话默认模型 */
+    defaultChatModel?: string;
+    /** Embedding AI 供应商预设；对齐官方 window.rulegoAiEmbeddingProviders 扩展 */
+    aiEmbeddingProviders?: AiProviderOption[];
     /** 组件列表格式转换函数 */
     adapterComponents?: (data: RawComponentData) => ComponentGroup[];
     /** 初始规则链数据 (如果提供则直接渲染) */

package/dist/types/events.d.ts

@@ -126,6 +126,18 @@ export interface EditorEventMap {
         id: string;
         properties: Record<string, unknown>;
     };
+    /** Headless HTML 节点挂载，用于 Vue/React Portal 渲染 */
+    'node:html-mount': {
+        id: string;
+        type: string;
+        data: unknown;
+        model: unknown;
+        el: HTMLElement;
+    };
+    /** Headless HTML 节点卸载 */
+    'node:html-unmount': {
+        id: string;
+    };
     /** 边被点击 */
     'edge:click': EdgeEventPayload;
     /** 边被双击 (触发编辑) */
@@ -189,6 +201,8 @@ export interface EditorEventMap {
     'history:change': HistoryChangePayload;
     /** 验证完成 */
     'validation:complete': ValidationPayload;
+    /** 调试日志写入 */
+    'debug:log': unknown;
 }
 /**
  * 事件名称联合类型

package/dist/types/rule-chain.d.ts

@@ -5,7 +5,7 @@
  * 对应 RuleGo 后端的 JSON 数据结构，用于前后端数据交互。
  * 包含规则链元信息、节点定义、连接定义等完整类型。
  *
- * @see https://rulego.cc/pages/a2a7a9/ RuleGo 官方文档
+ * 数据结构需与当前后端 JSON 协议保持一致。
  */
 /**
  * 节点在画布上的布局信息

package/dist/utils/GraphUtils.d.ts

@@ -0,0 +1,24 @@
+export interface GraphData {
+    nodes: any[];
+    edges: any[];
+}
+export declare class GraphUtils {
+    /**
+     * 洗白并重新分配图数据中的 ID，避免复制粘贴时与现有图产生 ID 冲突
+     * @param data 要处理的图数据（剪贴板中读取的原始数据）
+     * @param counters 引用计数器
+     * @returns 洗白后的安全图数据
+     */
+    static sanitizeGraphData(data: GraphData, counters: {
+        nodeCount: number;
+        edgeCount: number;
+    }): GraphData;
+    /**
+     * 刷新整个画布节点的全局计数器
+     */
+    static refreshCounters(data: GraphData, counters: {
+        nodeCount: number;
+        edgeCount: number;
+    }): void;
+}
+//# sourceMappingURL=GraphUtils.d.ts.map

package/dist/utils/index.d.ts

@@ -3,4 +3,5 @@
  * @description 工具函数统一导出入口
  */
 export { getNodeByID, getEdgeBySourceNodeIdAndTargetNodeId, getNodeSeq, getBytesLength, generateUUID, adapterComponents, toComponentMap, defaultIdGenerator, } from './helpers';
+export { GraphUtils, type GraphData } from './GraphUtils';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/relation-utils.d.ts

@@ -0,0 +1,13 @@
+export interface RelationOption {
+    label: string;
+    value: string;
+}
+export declare function normalizeRelationOptions(relationTypes: unknown): RelationOption[];
+export declare function getSwitchCaseRelationOptions(nodeModel: any): RelationOption[];
+export declare function getMsgTypeSwitchRelationOptions(nodeModel: any): RelationOption[];
+export declare function getEndpointRouterRelationOptions(nodeModel: any): RelationOption[];
+export declare function getRelationOptionsForNode(nodeView: any, nodeModel: any): RelationOption[];
+export declare function resolveRelationLabel(value: unknown, nodeView?: any, nodeModel?: any): string;
+export declare function parseRelationValues(value: unknown, splitToken?: string, relationOptions?: RelationOption[]): string[];
+export declare function parseNodeIds(value: unknown): string[];
+//# sourceMappingURL=relation-utils.d.ts.map