@huanban/rulego-editor-react 1.1.0 → 1.1.3

package/dist/components/NodePropertyDrawer.d.ts

@@ -12,18 +12,92 @@
  * @see ComponentField — 字段定义类型
  */
 import React from 'react';
+import type { AiProviderOption, LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
+export type FieldOption = string | {
+    label?: string;
+    value?: string;
+    name?: string;
+    id?: string;
+    [key: string]: unknown;
+};
+export interface GraphNodeOptionSource {
+    id?: string;
+    nodeId?: string;
+    name?: string;
+    text?: string | {
+        value?: string;
+    };
+    type?: string;
+    properties?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface RuleChainOptionSource {
+    id?: string;
+    value?: string;
+    name?: string;
+    label?: string;
+    desc?: string;
+    description?: string;
+    root?: boolean;
+    ruleChain?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface RuleChainFetchParams {
+    root: boolean;
+    keywords: string;
+    page: number;
+    size: number;
+    signal?: AbortSignal;
+}
+export interface RuleChainFetchResult {
+    items?: RuleChainOptionSource[];
+    records?: RuleChainOptionSource[];
+    rows?: RuleChainOptionSource[];
+    list?: RuleChainOptionSource[];
+    total?: number;
+    page?: number;
+    current?: number;
+    size?: number;
+    pageSize?: number;
+    data?: unknown;
+    [key: string]: unknown;
+}
 /** 组件字段定义 */
 export interface FieldDef {
     /** 字段名 */
     name: string;
     /** 字段类型 */
-    type: string;
+    type?: string;
     /** 显示标签 */
     label?: string;
     /** 字段描述 */
     desc?: string;
     /** 默认值 */
     defaultValue?: unknown;
+    /** component 协议 */
+    component?: {
+        type?: string;
+        caseType?: string;
+        source?: string;
+        options?: FieldOption[];
+        multiple?: boolean;
+        filterable?: boolean;
+        allowCreate?: boolean;
+        placeholder?: string;
+        disabled?: boolean;
+        rows?: number;
+    };
+    /** 兼容旧字段选项协议 */
+    options?: FieldOption[];
+    /** 嵌套字段定义，struct/table/switch 类字段会使用 */
+    fields?: FieldDef[];
+    /** ref 协议：primary/shared 字段会随连接模式联动隐藏 */
+    ref?: string;
+    /** providerType 协议：embedding 字段使用 embedding provider 预设 */
+    providerType?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
     /** 校验规则 */
     rules?: unknown[];
 }
@@ -71,6 +145,48 @@ export interface NodePropertyDrawerProps {
     onSubmit: (model: NodeModel) => void;
     /** 关闭回调 */
     onClose: () => void;
+    /** Current locale. Defaults to zh-CN. */
+    locale?: string;
+    /** Extra locale messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. */
+    t?: EditorTranslate;
+    /** Current graph nodes for component.source=nodes hydration. */
+    graphNodes?: GraphNodeOptionSource[];
+    /** Rule chain list for component.source=ruleChains hydration. */
+    ruleItems?: RuleChainOptionSource[];
+    /** Current rule chain used to avoid selecting itself in rule-chain fields. */
+    currentRuleChain?: RuleChainOptionSource | null;
+    /** Explicit /rules endpoint. If omitted, apiBase + /rules is used. */
+    rulesApi?: string;
+    /** API base ending at /api/v1 for remote rule-chain selector loading. */
+    apiBase?: string;
+    /** Page size for rule-chain selector modal. Defaults to 12. */
+    rulePageSize?: number;
+    /** Host override for remote rule-chain selector loading. */
+    fetchRuleChains?: (params: RuleChainFetchParams) => Promise<RuleChainFetchResult | RuleChainOptionSource[] | unknown>;
+    /** Components API payload, used for builtins["ai/tools"].tools and skillPath parity. */
+    componentsPayload?: Record<string, unknown>;
+    /** Legacy alias for componentsPayload. */
+    componentPayload?: Record<string, unknown>;
+    /** Host-provided builtin AI tools. Accepts the original /components builtins["ai/tools"].tools rows. */
+    builtinTools?: unknown[];
+    /** Official editorOptions.tools alias. */
+    tools?: unknown[];
+    /** Global skill directory returned by /components. */
+    skillPath?: string;
+    /** Host override for loading /components payload or builtin tools. */
+    fetchBuiltinTools?: (params: {
+        signal?: AbortSignal;
+    }) => Promise<unknown>;
+    /** Open the AI assistant or skill manager from a builtin skill tool helper. */
+    onOpenAiAssistant?: (options: {
+        section?: string;
+    }) => void;
+    /** AI provider presets, aligned with editorOptions.aiProviders. */
+    aiProviders?: AiProviderOption[];
+    /** Embedding provider presets, aligned with editorOptions.aiEmbeddingProviders. */
+    aiEmbeddingProviders?: AiProviderOption[];
 }
 /**
  * NodePropertyDrawer 组件

package/dist/components/RuleChainSettings.d.ts

@@ -12,6 +12,8 @@
  * @see RuleChainSettingsProps — 设置参数
  */
 import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
 /** 规则链设置数据 */
 export interface RuleChainSettingsData {
     /** 规则链 ID */
@@ -63,6 +65,12 @@ export interface RuleChainSettingsProps {
     onSave?: (data: RuleChainSettingsData) => void;
     /** 取消 / 关闭 */
     onClose: () => void;
+    /** Current locale. Defaults to zh-CN. */
+    locale?: string;
+    /** Extra locale messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. */
+    t?: EditorTranslate;
 }
 /**
  * RuleChainSettings 组件

package/dist/components/RuleGoEditor.d.ts

@@ -29,8 +29,9 @@
  */
 import React from 'react';
 import { HuanbanRulegoEditor } from '@huanban/rulego-editor-core';
+import type { AIAssistantOpenOptions, HuanbanRulegoEditorOptions } from '@huanban/rulego-editor-core';
 import type { EditorCore } from '@huanban/rulego-editor-core';
-import type { RuleChainData, ComponentDefinition } from '@huanban/rulego-editor-core';
+import type { RuleChainData, RawComponentData } from '@huanban/rulego-editor-core';
 import LogicFlow from '@logicflow/core';
 /**
  * RuleGoEditor 组件 Props
@@ -61,15 +62,19 @@ export interface RuleGoEditorProps {
      * 当需要自定义请求逻辑（如统一认证拦截、请求签名、错误重试等）时使用
      * 函数签名: (url: string, init: RequestInit) => Promise<Response>
      */
-    customFetch?: (url: string, init: RequestInit) => Promise<Response>;
+    customFetch?: (url: string, init?: RequestInit) => Promise<Response>;
     /** 初始规则链数据 */
     data?: RuleChainData | null;
-    /** 初始组件列表 */
-    components?: ComponentDefinition[];
+    /** 初始组件列表，支持数组或 /api/v1/components 分段返回 */
+    components?: RawComponentData;
     /** 是否显示工具栏, 默认 true */
     showToolbar?: boolean;
     /** 工具栏左侧标题 */
     toolbarTitle?: string;
+    /** 是否显示工具栏按钮文字，默认 false；设为 true 时显示图标 + 文字 */
+    showToolbarButtonLabels?: boolean;
+    /** 工具栏是否只显示图标，默认 true；显式 false 时可显示文字 */
+    toolbarIconOnly?: boolean;
     /** 是否显示侧边栏, 默认 true */
     showSidebar?: boolean;
     /** 侧边栏宽度, 默认 220 */
@@ -78,6 +83,16 @@ export interface RuleGoEditorProps {
     sidebarCollapsed?: boolean;
     /** 是否显示信息按钮 */
     showInfoButton?: boolean;
+    /** 是否显示 AI 助手按钮 */
+    showAiChatButton?: boolean;
+    /** 是否显示设置按钮 */
+    showSettingsButton?: boolean;
+    /** 是否显示调试面板按钮 */
+    showDebugConsoleButton?: boolean;
+    /** 是否显示清除调试高亮按钮 */
+    showClearDebugHighlightButton?: boolean;
+    /** 是否显示框选按钮 */
+    showSelectionButton?: boolean;
     /** 是否显示导出按钮, 默认 true */
     showExportDialog?: boolean;
     /** 是否显示运行按钮 */
@@ -96,19 +111,31 @@ export interface RuleGoEditorProps {
     showDebugTab?: boolean;
     /** 语言设置, 默认 'zh_cn' */
     locale?: string;
+    /** 初始/受控主题；支持 default/dark/nature/elegant/tech/modern，兼容 light/blue */
+    theme?: string;
     /** LogicFlow 额外配置 (与默认配置合并) */
     lfOptions?: Record<string, unknown>;
     /** LogicFlow 插件数组 */
     lfPlugins?: any[];
     /** EditorCore 额外配置 */
     coreOptions?: Record<string, unknown>;
+    /** 直接透传给 HuanbanRulegoEditor 的扩展配置，显式 props 会覆盖这里的同名字段 */
+    options?: Partial<HuanbanRulegoEditorOptions>;
     /** 编辑器就绪 */
     onReady?: (ctx: {
         lf: LogicFlow;
         core: EditorCore;
     }) => void;
     /** 保存回调 */
-    onSave?: (data: unknown) => void;
+    onSave?: (data: unknown) => void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    } | Promise<void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    }>;
     /** 节点点击 */
     onNodeClick?: (data: unknown) => void;
     /** 节点双击 */
@@ -133,7 +160,15 @@ export interface RuleGoEditorProps {
     /** 语言切换回调 */
     onLocaleChange?: (locale: string) => void;
     /** 劫持部署 */
-    onDeploy?: (chainId: string, action: 'deploy' | 'undeploy' | 'reload') => void;
+    onDeploy?: (chainId: string, action: 'deploy' | 'undeploy' | 'reload') => void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    } | Promise<void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    }>;
     /** 选择规则链 */
     onSelectRuleChain?: (ruleChain: any) => void;
     /** 删除规则链 */
@@ -144,6 +179,12 @@ export interface RuleGoEditorProps {
     ruleItems?: any[];
     /** 规则链 API 地址 */
     rulesApi?: string;
+    /**
+     * 自定义无头节点渲染器
+     * 当使用 HeadlessHtmlNode 时，核心引擎会派发 `node:html-mount` 事件。
+     * React 适配层会捕获该事件并调用本函数，将返回的 React 节点通过 Portal 挂载到画布内部。
+     */
+    renderNode?: (type: string, data: any, model: any) => React.ReactNode;
 }
 /**
  * RuleGoEditor 的命令式 API
@@ -159,13 +200,21 @@ export interface RuleGoEditorRef {
     /** 重新加载数据 */
     loadData: (data: RuleChainData) => void;
     /** 重新加载组件 */
-    loadComponents: (components: ComponentDefinition[]) => void;
+    loadComponents: (components: RawComponentData) => void;
     /** 导出数据 */
     exportData: () => RuleChainData | null;
     /** 切换小地图 */
     toggleMiniMap: () => void;
     /** 手动触发自动排版 — 基于 DAG 拓扑排序重新排列节点 */
     autoLayout: () => void;
+    /** 打开独立设置弹窗 */
+    openSettings: (initialTab?: 'user' | 'setting' | 'ai' | 'skills') => void;
+    /** 打开 AI 助手侧栏 */
+    openAiAssistant: (options?: AIAssistantOpenOptions) => void;
+    /** 关闭 AI 助手侧栏 */
+    closeAiAssistant: () => void;
+    /** 切换编辑器主题 */
+    setTheme: (theme: string) => void;
 }
 /**
  * RuleGoEditor — React 封装组件

package/dist/components/RuleMaintenancePanel.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { EditorTranslate } from '../i18n';
+import type { LocaleMessages, WorkflowFetcher, WorkflowItem } from '@huanban/rulego-editor-core';
+export interface RuleMaintenancePanelProps {
+    workflow: WorkflowItem;
+    fetcher: WorkflowFetcher | null;
+    content: Record<string, unknown> | null;
+    onError?: (error: Error) => void;
+    locale?: string;
+    messages?: LocaleMessages;
+    t?: EditorTranslate;
+}
+export declare const RuleMaintenancePanel: React.FC<RuleMaintenancePanelProps>;
+export default RuleMaintenancePanel;
+//# sourceMappingURL=RuleMaintenancePanel.d.ts.map

package/dist/components/SearchPanel.d.ts

@@ -15,6 +15,8 @@
  *   - 通过回调 props 处理节点定位
  */
 import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
 /** 搜索结果项 */
 export interface SearchResultItem {
     /** 节点 ID */
@@ -38,6 +40,12 @@ export interface SearchPanelProps {
     onClose: () => void;
     /** 面板位置 */
     position?: 'top-center' | 'top-right';
+    /** Current locale. Defaults to zh-CN. */
+    locale?: string;
+    /** Extra locale messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. */
+    t?: EditorTranslate;
 }
 /**
  * SearchPanel 组件

package/dist/components/SearchableSelect.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+export interface SearchableSelectOption {
+    label: string;
+    value: string;
+    description?: string;
+}
+export interface SearchableSelectProps {
+    name?: string;
+    value?: string;
+    values?: string[];
+    options?: SearchableSelectOption[];
+    multiple?: boolean;
+    allowCreate?: boolean;
+    disabled?: boolean;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    noMatchText?: string;
+    createOptionText?: string;
+    selectedCountText?: string;
+    resultCountText?: string;
+    moreOptionsText?: string;
+    className?: string;
+    threshold?: number;
+    maxVisibleOptions?: number;
+    onChange: (value: string) => void;
+    onMultiChange?: (values: string[]) => void;
+}
+export declare const SearchableSelect: React.FC<SearchableSelectProps>;
+//# sourceMappingURL=SearchableSelect.d.ts.map

package/dist/components/ValidationPanel.d.ts

@@ -13,6 +13,8 @@
  * @see ValidationPanelProps — 面板参数
  */
 import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
 /** 验证错误项 */
 export interface ValidationItem {
     /** 规则名称 */
@@ -46,6 +48,12 @@ export interface ValidationPanelProps {
     onClose?: () => void;
     /** 清除验证结果 */
     onClear?: () => void;
+    /** Current locale. Defaults to zh-CN. */
+    locale?: string;
+    /** Extra locale messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. */
+    t?: EditorTranslate;
 }
 /**
  * ValidationPanel 组件

package/dist/components/WorkflowInfoPanel.d.ts

@@ -19,7 +19,8 @@
  * @module @huanban/rulego-editor-react
  */
 import React from 'react';
-import type { WorkflowItem, WorkflowFetcher, WorkflowInfoIcons, WorkflowTheme, RuleChainAPIOptions } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
+import type { LocaleMessages, WorkflowItem, WorkflowFetcher, WorkflowInfoIcons, WorkflowTheme, RuleChainAPIOptions } from '@huanban/rulego-editor-core';
 /** 自定义 Tab 定义 */
 export interface ExtraTab {
     key: string;
@@ -52,6 +53,21 @@ export interface WorkflowInfoPanelProps {
     onError?: (error: Error) => void;
     /** 请求刷新外部数据 */
     onRefresh?: () => void;
+    /** Current locale. Defaults to zh-CN. */
+    locale?: string;
+    /** Extra locale messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. */
+    t?: EditorTranslate;
 }
+export interface WorkflowIntegrationUrls {
+    executeUrl: string;
+    notifyUrl: string;
+    mcpSseUrl: string;
+    debugWsUrl: string;
+    runtimeWsUrl: string;
+    endpointWsHint: string;
+}
+export declare function buildWorkflowIntegrationUrls(apiBase: string | undefined, workflowId: string): WorkflowIntegrationUrls;
 export declare const WorkflowInfoPanel: React.FC<WorkflowInfoPanelProps>;
 //# sourceMappingURL=WorkflowInfoPanel.d.ts.map

package/dist/components/WorkflowList.d.ts

@@ -28,7 +28,8 @@
  * @module @huanban/rulego-editor-react
  */
 import React from 'react';
-import type { WorkflowItem, WorkflowFetcher, WorkflowListIcons, WorkflowTheme, RuleChainAPIOptions } from '@huanban/rulego-editor-core';
+import type { WorkflowItem, WorkflowFetcher, WorkflowListIcons, WorkflowTheme, RuleChainAPIOptions, LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
 /**
  * WorkflowList 组件 Props
  */
@@ -55,6 +56,12 @@ export interface WorkflowListProps {
     showCreate?: boolean;
     /** 是否显示刷新按钮，默认 true */
     showRefresh?: boolean;
+    /** Current locale. Defaults to zh-CN. */
+    locale?: string;
+    /** Extra locale messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. */
+    t?: EditorTranslate;
     /** 替换标题栏区域 */
     renderHeader?: (defaultHeader: React.ReactNode) => React.ReactNode;
     /** 替换每行操作按钮 */

package/dist/components/properties/AgentOrchestrationProperties.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../../i18n';
+interface Props {
+    nodeData: any;
+    onUpdate: (properties: any) => void;
+    locale?: string;
+    messages?: LocaleMessages;
+    t?: EditorTranslate;
+}
+export declare const AgentOrchestrationProperties: React.FC<Props>;
+export {};
+//# sourceMappingURL=AgentOrchestrationProperties.d.ts.map

package/dist/i18n.d.ts

@@ -0,0 +1,14 @@
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+export type EditorTranslate = (key: string, params?: Record<string, string | number>) => string;
+export interface FrameworkI18nProps {
+    /** Current locale. Supports zh-CN/zh_cn/zh and en-US/en_us/en. */
+    locale?: string;
+    /** Extra messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. It takes priority over built-in messages. */
+    t?: EditorTranslate;
+}
+export declare function normalizeFrameworkLocale(locale?: string): 'zh-CN' | 'en-US';
+export declare function createFrameworkTranslator(options?: FrameworkI18nProps): (key: string, fallback?: string, params?: Record<string, string | number>) => string;
+export declare function relationTypeLabel(translate: (key: string, fallback?: string, params?: Record<string, string | number>) => string, value: string): string;
+//# sourceMappingURL=i18n.d.ts.map