@huanban/rulego-editor-react 1.0.15 → 1.1.2

package/dist/components/LogViewer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @file LogViewer.tsx
+ * @description 支持虚拟滚动的高性能调试日志面板
+ */
+import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
+/**
+ * 日志实体接口定义
+ * @interface LogEntry
+ */
+export interface LogEntry {
+    /** 唯一日志标识 UUID */
+    id: string;
+    /** 产生日志的毫秒时间戳 */
+    timestamp: number;
+    /** 日志级别 */
+    level: 'info' | 'warn' | 'error' | 'debug';
+    /** 实际文本内容 */
+    message: string;
+}
+/**
+ * 日志面板组件属性
+ * @interface LogViewerProps
+ */
+export interface LogViewerProps {
+    /** 从外层 WebSocket 接收并维护的日志数组 */
+    logs: LogEntry[];
+    /** Current locale. Defaults to zh-CN. */
+    locale?: string;
+    /** Extra locale messages merged into the selected locale. */
+    messages?: LocaleMessages;
+    /** Host-provided translation function. */
+    t?: EditorTranslate;
+}
+/**
+ * 高性能调试日志控制台 (LogViewer)
+ *
+ * @component
+ * @description 专为高并发/海量报文调试设计的面板。
+ * 考虑到不引入额外的庞大虚拟列表库（如 react-window），此处实现了基础的数组切片限流策略。
+ * 始终保证 DOM 树内仅渲染最新 200 条节点，彻底根除由于 `DOM Nodes` 暴增导致的浏览器卡顿问题。
+ */
+export declare const LogViewer: React.FC<LogViewerProps>;
+//# sourceMappingURL=LogViewer.d.ts.map

package/dist/components/MiniMap.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @file components/MiniMap.tsx
+ * @description 小地图导航组件 — React 实现
+ *
+ * 功能：
+ *   - 显示画布全局缩略视图
+ *   - 标记所有节点位置（按类型着色）
+ *   - 标记当前视口范围（拖拽移动）
+ *   - 标记选中节点（高亮）
+ *   - 可折叠/展开
+ *   - 零 UI 框架依赖（纯 React + CSS）
+ *
+ * @see MiniMapProps — 参数类型
+ */
+import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
+/** 小地图中的节点数据 */
+export interface MiniMapNode {
+    /** 节点 ID */
+    id: string;
+    /** X 坐标 */
+    x: number;
+    /** Y 坐标 */
+    y: number;
+    /** 宽度 */
+    width?: number;
+    /** 高度 */
+    height?: number;
+    /** 节点类型 */
+    type?: string;
+    /** 是否选中 */
+    selected?: boolean;
+    /** 显示颜色 */
+    color?: string;
+}
+/** 小地图中的视口数据 */
+export interface MiniMapViewport {
+    /** 视口左上角 X */
+    x: number;
+    /** 视口左上角 Y */
+    y: number;
+    /** 视口宽度 */
+    width: number;
+    /** 视口高度 */
+    height: number;
+}
+/** MiniMap Props */
+export interface MiniMapProps {
+    /** 所有节点列表 */
+    nodes: MiniMapNode[];
+    /** 当前视口范围 */
+    viewport?: MiniMapViewport;
+    /** 小地图宽度（默认 200） */
+    width?: number;
+    /** 小地图高度（默认 150） */
+    height?: number;
+    /** 是否默认折叠 */
+    defaultCollapsed?: boolean;
+    /** 位置（右下角/左下角/右上角/左上角） */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** 视口拖拽回调 — 返回画布坐标 */
+    onViewportChange?: (center: {
+        x: number;
+        y: number;
+    }) => void;
+    /** 节点点击回调 */
+    onNodeClick?: (nodeId: string) => 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;
+}
+/**
+ * MiniMap 组件
+ *
+ * 显示画布全局缩略图，方便大型规则链的导航。
+ */
+declare const MiniMap: React.FC<MiniMapProps>;
+export default MiniMap;
+//# sourceMappingURL=MiniMap.d.ts.map

package/dist/components/NodePropertyDrawer.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @file components/NodePropertyDrawer.tsx
+ * @description 节点属性编辑抽屉 — React 实现
+ *
+ * 功能：
+ *   - 双击节点弹出侧边抽屉，编辑节点配置
+ *   - 根据组件 fields 定义动态渲染表单（string/bool/int/float/map/array/script）
+ *   - 支持节点 ID、名称、调试模式、描述等基础字段
+ *   - 提交后通过 onSubmit 回调更新节点属性
+ *   - 零 UI 框架依赖（纯 React + CSS）
+ *
+ * @see ComponentField — 字段定义类型
+ */
+import React from 'react';
+import type { 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;
+    /** 显示标签 */
+    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;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 校验规则 */
+    rules?: unknown[];
+}
+/** 节点模型数据 */
+export interface NodeModel {
+    /** LogicFlow 节点 ID */
+    id: string;
+    /** RuleGo 节点 ID */
+    nodeId?: string;
+    /** 节点类型 */
+    type: string;
+    /** 节点名称 */
+    name: string;
+    /** 调试模式 */
+    debugMode?: boolean;
+    /** 节点配置 */
+    configuration?: Record<string, unknown>;
+    /** 附加信息（描述等） */
+    additionalInfo?: Record<string, unknown>;
+    /** 额外属性 */
+    [key: string]: unknown;
+}
+/** 节点视图定义（组件定义） */
+export interface NodeView {
+    /** 组件类型 */
+    type: string;
+    /** 显示标签 */
+    label?: string;
+    /** 描述 */
+    desc?: string;
+    /** 字段定义列表 */
+    fields?: FieldDef[];
+    /** 额外属性 */
+    [key: string]: unknown;
+}
+/** NodePropertyDrawer Props */
+export interface NodePropertyDrawerProps {
+    /** 是否显示 */
+    visible: boolean;
+    /** 节点模型数据 */
+    nodeModel: NodeModel | null;
+    /** 节点视图/组件定义 */
+    nodeView: NodeView | null;
+    /** 提交回调 */
+    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 official component.source=nodes hydration. */
+    graphNodes?: GraphNodeOptionSource[];
+    /** Rule chain list for official 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>;
+}
+/**
+ * NodePropertyDrawer 组件
+ *
+ * 纯 React 实现的节点属性编辑抽屉，无 antd 依赖。
+ * 根据组件 fields 动态渲染表单，支持多种字段类型。
+ */
+declare const NodePropertyDrawer: React.FC<NodePropertyDrawerProps>;
+export default NodePropertyDrawer;
+//# sourceMappingURL=NodePropertyDrawer.d.ts.map

package/dist/components/RuleChainSettings.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @file components/RuleChainSettings.tsx
+ * @description 规则链设置对话框 — React 实现
+ *
+ * 功能：
+ *   - 编辑规则链元数据（名称/描述/调试模式等）
+ *   - 管理规则链全局配置
+ *   - 模态对话框展示
+ *   - 表单验证
+ *   - 零 UI 框架依赖（纯 React + CSS）
+ *
+ * @see RuleChainSettingsProps — 设置参数
+ */
+import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
+/** 规则链设置数据 */
+export interface RuleChainSettingsData {
+    /** 规则链 ID */
+    id?: string;
+    /** 规则链名称 */
+    name: string;
+    /** 是否为根链 */
+    root?: boolean;
+    /** 是否开启调试模式 */
+    debugMode?: boolean;
+    /** 描述 */
+    description?: string;
+    /** 额外配置（JSON） */
+    additionalInfo?: Record<string, unknown>;
+    /** 自定义字段 */
+    [key: string]: unknown;
+}
+/** RuleChainSettings Props */
+export interface RuleChainSettingsProps {
+    /** 是否可见 */
+    visible: boolean;
+    /** 当前设置数据 */
+    data: RuleChainSettingsData;
+    /** 是否只读 */
+    readOnly?: boolean;
+    /** 对话框标题 */
+    title?: string;
+    /** 额外的自定义字段定义 */
+    customFields?: Array<{
+        /** 字段名 */
+        key: string;
+        /** 显示名称 */
+        label: string;
+        /** 字段类型 */
+        type: 'text' | 'number' | 'select' | 'textarea' | 'switch';
+        /** select 的选项 */
+        options?: Array<{
+            label: string;
+            value: string;
+        }>;
+        /** 默认值 */
+        defaultValue?: unknown;
+        /** 提示 */
+        placeholder?: string;
+        /** 帮助文本 */
+        help?: string;
+    }>;
+    /** 保存回调 */
+    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 组件
+ *
+ * 模态对话框形式的规则链设置面板。
+ */
+declare const RuleChainSettings: React.FC<RuleChainSettingsProps>;
+export default RuleChainSettings;
+//# sourceMappingURL=RuleChainSettings.d.ts.map

package/dist/components/RuleGoEditor.d.ts

@@ -0,0 +1,230 @@
+/**
+ * @file components/RuleGoEditor.tsx
+ * @description React 薄封装 — 直接复用 @huanban/rulego-editor-core 的 HuanbanRulegoEditor
+ *
+ * 设计理念:
+ * - 所有编辑器核心逻辑（工具栏、侧边栏、组件列表、上下文菜单、属性面板、
+ *   小地图、键盘快捷键等）全部在 editor-core 的 HuanbanRulegoEditor 中实现
+ * - React 版只负责: 挂载 DOM → 创建实例 → 代理 Props → 卸载时销毁
+ * - 这样 React / Vue / Angular 的封装都只需 ~100 行, 功能自动与 JS 版对齐
+ *
+ * @example
+ * ```tsx
+ * import { RuleGoEditor } from '@huanban/rulego-editor-react'
+ *
+ * function App() {
+ *   return (
+ *     <RuleGoEditor
+ *       apiBase="http://127.0.0.1:9090/api/v1"
+ *       data={ruleChainData}
+ *       components={componentsList}
+ *       onSave={(data) => console.log('保存', data)}
+ *       onReady={({ lf, core }) => console.log('就绪')}
+ *     />
+ *   )
+ * }
+ * ```
+ *
+ * @see HuanbanRulegoEditor — 核心引擎 (editor-core)
+ */
+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, RawComponentData } from '@huanban/rulego-editor-core';
+import LogicFlow from '@logicflow/core';
+/**
+ * RuleGoEditor 组件 Props
+ *
+ * 大部分选项直接透传给 HuanbanRulegoEditor (editor-core)
+ * React 特有的只有: className, style, width, height, ref
+ */
+export interface RuleGoEditorProps {
+    /** 容器高度, 默认 '100%' */
+    height?: string | number;
+    /** 容器宽度, 默认 '100%' */
+    width?: string | number;
+    /** className */
+    className?: string;
+    /** style */
+    style?: React.CSSProperties;
+    /** API 基础地址 (如 'http://127.0.0.1:9090/api/v1') */
+    apiBase?: string;
+    /** 请求超时毫秒数, 默认 5000 */
+    fetchTimeout?: number;
+    /**
+     * 自定义请求头 — 用于注入 Authorization Token 等认证信息
+     * 支持静态对象或动态函数（每次请求时调用获取最新 Token）
+     */
+    fetchHeaders?: Record<string, string> | (() => Record<string, string>);
+    /**
+     * 自定义 fetch 函数 — 完全替换原生 fetch
+     * 当需要自定义请求逻辑（如统一认证拦截、请求签名、错误重试等）时使用
+     * 函数签名: (url: string, init: RequestInit) => Promise<Response>
+     */
+    customFetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    /** 初始规则链数据 */
+    data?: RuleChainData | null;
+    /** 初始组件列表，支持数组或官方 /api/v1/components 分段返回 */
+    components?: RawComponentData;
+    /** 是否显示工具栏, 默认 true */
+    showToolbar?: boolean;
+    /** 工具栏左侧标题 */
+    toolbarTitle?: string;
+    /** 是否显示工具栏按钮文字，默认 false；设为 true 时显示图标 + 文字 */
+    showToolbarButtonLabels?: boolean;
+    /** 工具栏是否只显示图标，默认 true；显式 false 时可显示文字 */
+    toolbarIconOnly?: boolean;
+    /** 是否显示侧边栏, 默认 true */
+    showSidebar?: boolean;
+    /** 侧边栏宽度, 默认 220 */
+    sidebarWidth?: number;
+    /** 侧边栏是否默认收起 */
+    sidebarCollapsed?: boolean;
+    /** 是否显示信息按钮 */
+    showInfoButton?: boolean;
+    /** 是否显示 AI 助手按钮 */
+    showAiChatButton?: boolean;
+    /** 是否显示设置按钮 */
+    showSettingsButton?: boolean;
+    /** 是否显示调试面板按钮 */
+    showDebugConsoleButton?: boolean;
+    /** 是否显示清除调试高亮按钮 */
+    showClearDebugHighlightButton?: boolean;
+    /** 是否显示框选按钮 */
+    showSelectionButton?: boolean;
+    /** 是否显示导出按钮, 默认 true */
+    showExportDialog?: boolean;
+    /** 是否显示运行按钮 */
+    showRunButton?: boolean;
+    /** 是否显示组件管理按钮 */
+    showComponentManage?: boolean;
+    /** 是否显示部署按钮, 默认 true */
+    showDeployButton?: boolean;
+    /** 是否显示运行记录按钮 */
+    showRunHistory?: boolean;
+    /** 运行记录 URL (支持 {chainId} 占位符) */
+    runHistoryUrl?: string;
+    /** 是否在工具栏显示「链追溯」按钮, 默认 false */
+    showTraceButton?: boolean;
+    /** 是否显示调试日志 Tab */
+    showDebugTab?: boolean;
+    /** 语言设置, 默认 'zh_cn' */
+    locale?: 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 | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    } | Promise<void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    }>;
+    /** 节点点击 */
+    onNodeClick?: (data: unknown) => void;
+    /** 节点双击 */
+    onNodeDbClick?: (data: unknown) => void;
+    /** 边点击 */
+    onEdgeClick?: (data: unknown) => void;
+    /** 数据变化 */
+    onChange?: () => void;
+    /** 点击信息按钮 */
+    onInfoClick?: (chainInfo: any) => void;
+    /** 劫持导出 */
+    onExportDSL?: (data: {
+        json: string;
+        imageDataUrl?: string;
+    }) => void;
+    /** 劫持运行 */
+    onRunClick?: (chainId: string) => void;
+    /** 点击「链追溯」按钮回调，回传当前完整的规则链数据 (用于构建追溯底图) */
+    onTraceClick?: (chainInfo: any) => void;
+    /** 劫持组件管理 */
+    onComponentManage?: () => void;
+    /** 语言切换回调 */
+    onLocaleChange?: (locale: string) => 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;
+    /** 删除规则链 */
+    onDeleteRuleChain?: (chainId: string) => void;
+    /** 劫持运行记录 */
+    onRunHistory?: (chainId: string) => void;
+    /** 规则链列表数据 */
+    ruleItems?: any[];
+    /** 规则链 API 地址 */
+    rulesApi?: string;
+    /**
+     * 自定义无头节点渲染器
+     * 当使用 HeadlessHtmlNode 时，核心引擎会派发 `node:html-mount` 事件。
+     * React 适配层会捕获该事件并调用本函数，将返回的 React 节点通过 Portal 挂载到画布内部。
+     */
+    renderNode?: (type: string, data: any, model: any) => React.ReactNode;
+}
+/**
+ * RuleGoEditor 的命令式 API
+ * 通过 useRef + forwardRef 暴露给父组件
+ */
+export interface RuleGoEditorRef {
+    /** HuanbanRulegoEditor 实例 (editor-core) */
+    editor: HuanbanRulegoEditor | null;
+    /** LogicFlow 实例 */
+    lf: LogicFlow | null;
+    /** EditorCore 实例 */
+    core: EditorCore | null;
+    /** 重新加载数据 */
+    loadData: (data: RuleChainData) => 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;
+}
+/**
+ * RuleGoEditor — React 封装组件
+ *
+ * 内部直接使用 editor-core 的 HuanbanRulegoEditor,
+ * 所有功能与原生 JS 版完全一致:
+ * - 工具栏 (保存/撤销/重做/导出/部署/运行/语言/主题)
+ * - 组件侧边栏 (分类折叠/搜索/拖拽添加)
+ * - 画布 (LogicFlow 2.x)
+ * - 右键菜单
+ * - 节点/边属性抽屉
+ * - 小地图
+ * - 键盘快捷键
+ */
+declare const RuleGoEditor: React.ForwardRefExoticComponent<RuleGoEditorProps & React.RefAttributes<RuleGoEditorRef>>;
+export default RuleGoEditor;
+//# sourceMappingURL=RuleGoEditor.d.ts.map

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

@@ -0,0 +1,60 @@
+/**
+ * @file SearchPanel.tsx
+ * @description 节点搜索面板
+ *
+ * 功能：
+ *   - 按名称、类型、ID 搜索规则链中的节点
+ *   - 实时过滤和高亮匹配结果
+ *   - 点击搜索结果定位到对应节点
+ *   - 支持快捷键触发 (Ctrl/Cmd + F)
+ *   - 支持搜索历史记录（会话内）
+ *
+ * 设计：
+ *   - 纯 React + CSS，无外部 UI 库依赖
+ *   - rge- 前缀 CSS 类名避免冲突
+ *   - 通过回调 props 处理节点定位
+ */
+import React from 'react';
+import type { LocaleMessages } from '@huanban/rulego-editor-core';
+import type { EditorTranslate } from '../i18n';
+/** 搜索结果项 */
+export interface SearchResultItem {
+    /** 节点 ID */
+    id: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点类型 */
+    type: string;
+    /** 组件类型显示名 */
+    typeLabel?: string;
+    /** 附加信息 (如配置片段) */
+    extra?: string;
+}
+/** SearchPanel 属性 */
+export interface SearchPanelProps {
+    /** 所有可搜索的节点列表 */
+    nodes: SearchResultItem[];
+    /** 点击搜索结果回调 — 定位到对应节点 */
+    onSelectNode?: (nodeId: string) => void;
+    /** 关闭搜索面板回调 */
+    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 组件
+ *
+ * @description
+ * 提供节点搜索功能。输入关键词后实时过滤匹配节点，
+ * 点击搜索结果可定位到画布中对应的节点。
+ * 使用 ESC 键或关闭按钮关闭面板。
+ */
+declare const SearchPanel: React.FC<SearchPanelProps>;
+export default SearchPanel;
+//# sourceMappingURL=SearchPanel.d.ts.map