@huanban/rulego-editor-react 1.0.0

package/dist/components/ValidationPanel.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @file components/ValidationPanel.tsx
+ * @description 规则链验证面板 — React 实现
+ *
+ * 功能：
+ *   - 显示验证结果（错误/警告/信息）
+ *   - 按级别分组展示
+ *   - 点击错误项高亮对应节点/边
+ *   - 支持手动触发验证
+ *   - 统计信息展示
+ *   - 零 UI 框架依赖（纯 React + CSS）
+ *
+ * @see ValidationPanelProps — 面板参数
+ */
+import React from 'react';
+/** 验证错误项 */
+export interface ValidationItem {
+    /** 规则名称 */
+    rule: string;
+    /** 错误级别 */
+    level: 'error' | 'warning' | 'info';
+    /** 错误消息 */
+    message: string;
+    /** 关联的元素 ID */
+    elementId?: string;
+    /** 关联的元素类型 */
+    elementType?: 'node' | 'edge';
+}
+/** ValidationPanel Props */
+export interface ValidationPanelProps {
+    /** 验证结果列表 */
+    items: ValidationItem[];
+    /** 是否验证通过 */
+    isValid?: boolean;
+    /** 是否可见 */
+    visible?: boolean;
+    /** 是否正在验证中 */
+    loading?: boolean;
+    /** 面板标题 */
+    title?: string;
+    /** 手动触发验证 */
+    onValidate?: () => void;
+    /** 点击验证项（跳转到对应元素） */
+    onItemClick?: (item: ValidationItem) => void;
+    /** 关闭面板 */
+    onClose?: () => void;
+    /** 清除验证结果 */
+    onClear?: () => void;
+}
+/**
+ * ValidationPanel 组件
+ *
+ * 显示规则链校验结果，支持点击跳转到问题元素。
+ */
+declare const ValidationPanel: React.FC<ValidationPanelProps>;
+export default ValidationPanel;
+//# sourceMappingURL=ValidationPanel.d.ts.map

package/dist/components/ValidationPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationPanel.d.ts","sourceRoot":"","sources":["../../src/components/ValidationPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAA4B,MAAM,OAAO,CAAA;AAIhD,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,WAAW;IACX,OAAO,EAAE,MAAM,CAAA;IACf,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC9B;AAED,4BAA4B;AAC5B,MAAM,WAAW,oBAAoB;IACnC,aAAa;IACb,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,aAAa;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IAGd,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,qBAAqB;IACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;IAC5C,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAWD;;;;GAIG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAkInD,CAAA;AAID,eAAe,eAAe,CAAA"}

package/dist/components/WorkflowInfoPanel.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @file components/WorkflowInfoPanel.tsx
+ * @description 工作流信息面板组件 — 支持独立引用
+ *
+ * 六大替换能力:
+ *   1. 请求替换: fetcher prop 或 apiBase
+ *   2. CSS 替换: huanban_rulego_info__ 前缀 + CSS 变量
+ *   3. Slot 插槽: renderBaseInfo / renderVarsSecrets / renderIntegration / renderExtraTabs
+ *   4. 图标替换: icons prop
+ *   5. 主题切换: theme prop
+ *   6. 事件回调: onSave / onError / onRefresh
+ *
+ * Tab 页:
+ *   - 基础信息（名称/描述/状态）
+ *   - 变量与秘钥（key-value 编辑）
+ *   - 应用集成（API/MCP 地址展示）
+ *   - 自定义 Tab（通过 renderExtraTabs 扩展）
+ *
+ * @module @huanban/rulego-editor-react
+ */
+import React from 'react';
+import type { WorkflowItem, WorkflowFetcher, WorkflowInfoIcons, WorkflowTheme, RuleChainAPIOptions } from '@huanban/rulego-editor-core';
+/** 自定义 Tab 定义 */
+export interface ExtraTab {
+    key: string;
+    label: React.ReactNode;
+    children: React.ReactNode;
+}
+export interface WorkflowInfoPanelProps {
+    apiBase?: string;
+    apiOptions?: Partial<RuleChainAPIOptions>;
+    fetcher?: WorkflowFetcher;
+    /** 当前工作流数据 */
+    workflow: WorkflowItem | null;
+    theme?: WorkflowTheme;
+    className?: string;
+    style?: React.CSSProperties;
+    icons?: Partial<WorkflowInfoIcons>;
+    /** 默认激活的 Tab，默认 'base' */
+    defaultTab?: string;
+    /** 替换基础信息面板 */
+    renderBaseInfo?: (workflow: WorkflowItem, defaultPanel: React.ReactNode) => React.ReactNode;
+    /** 替换变量/秘钥面板 */
+    renderVarsSecrets?: (workflow: WorkflowItem, defaultPanel: React.ReactNode) => React.ReactNode;
+    /** 替换集成面板 */
+    renderIntegration?: (workflow: WorkflowItem, apiBase: string, defaultPanel: React.ReactNode) => React.ReactNode;
+    /** 追加自定义 Tab */
+    renderExtraTabs?: (workflow: WorkflowItem) => ExtraTab[];
+    /** 保存成功 */
+    onSave?: (type: string) => void;
+    /** 出错 */
+    onError?: (error: Error) => void;
+    /** 请求刷新外部数据 */
+    onRefresh?: () => void;
+}
+export declare const WorkflowInfoPanel: React.FC<WorkflowInfoPanelProps>;
+//# sourceMappingURL=WorkflowInfoPanel.d.ts.map

package/dist/components/WorkflowInfoPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowInfoPanel.d.ts","sourceRoot":"","sources":["../../src/components/WorkflowInfoPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAA;AAEvE,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACpB,MAAM,6BAA6B,CAAA;AAqBpC,iBAAiB;AACjB,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAMD,MAAM,WAAW,sBAAsB;IAErC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACzC,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,cAAc;IACd,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAG7B,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAClC,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IAGnB,eAAe;IACf,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAA;IAC3F,gBAAgB;IAChB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAA;IAC9F,aAAa;IACb,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAA;IAC/G,gBAAgB;IAChB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,QAAQ,EAAE,CAAA;IAGxD,WAAW;IACX,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,SAAS;IACT,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AA0DD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAgR9D,CAAA"}

package/dist/components/WorkflowList.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @file components/WorkflowList.tsx
+ * @description 工作流列表组件 — 支持独立引用
+ *
+ * 六大替换能力:
+ *   1. 请求替换: fetcher prop（实现 WorkflowFetcher 接口）或 apiBase（用内置 fetch）
+ *   2. CSS 替换: 所有 class 用 huanban_rulego_list__ 前缀 + CSS 变量，可完全覆盖
+ *   3. Slot 插槽: renderHeader / renderActions / renderEmpty / renderCreateForm / renderRow
+ *   4. 图标替换: icons prop（传入自定义图标 ReactNode）
+ *   5. 主题切换: theme prop（'light' | 'dark'）
+ *   6. 事件回调: onDesign / onInfo / onViewLogs / onChange / onError / onCreateSuccess
+ *
+ * 使用方式:
+ * ```tsx
+ * // 最简用法（内置 fetch）
+ * <WorkflowList apiBase="http://127.0.0.1:9090/api/v1" />
+ *
+ * // 完整自定义
+ * <WorkflowList
+ *   fetcher={myFetcher}
+ *   icons={{ design: <EditOutlined /> }}
+ *   theme="dark"
+ *   renderActions={(wf, defaults) => <>{defaults}<MyBtn /></>}
+ *   onDesign={(id) => navigate(`/editor/${id}`)}
+ * />
+ * ```
+ *
+ * @module @huanban/rulego-editor-react
+ */
+import React from 'react';
+import type { WorkflowItem, WorkflowFetcher, WorkflowListIcons, WorkflowTheme, RuleChainAPIOptions } from '@huanban/rulego-editor-core';
+/**
+ * WorkflowList 组件 Props
+ */
+export interface WorkflowListProps {
+    /** API 基础地址（用内置 RuleChainAPI） */
+    apiBase?: string;
+    /** API 配置（传给内置 RuleChainAPI 的完整配置） */
+    apiOptions?: Partial<RuleChainAPIOptions>;
+    /** 自定义请求适配器（传了就忽略 apiBase） */
+    fetcher?: WorkflowFetcher;
+    /** 每页条数，默认 10 */
+    pageSize?: number;
+    /** 主题 */
+    theme?: WorkflowTheme;
+    /** 额外 CSS 类名 */
+    className?: string;
+    /** 行内样式 */
+    style?: React.CSSProperties;
+    /** 自定义图标映射 */
+    icons?: Partial<WorkflowListIcons>;
+    /** 是否显示搜索框，默认 true */
+    showSearch?: boolean;
+    /** 是否显示新建按钮，默认 true */
+    showCreate?: boolean;
+    /** 是否显示刷新按钮，默认 true */
+    showRefresh?: boolean;
+    /** 替换标题栏区域 */
+    renderHeader?: (defaultHeader: React.ReactNode) => React.ReactNode;
+    /** 替换每行操作按钮 */
+    renderActions?: (workflow: WorkflowItem, defaultActions: React.ReactNode) => React.ReactNode;
+    /** 替换空状态 */
+    renderEmpty?: () => React.ReactNode;
+    /** 替换新建表单内容 */
+    renderCreateForm?: (defaultForm: React.ReactNode, handlers: {
+        close: () => void;
+        submit: (data: Record<string, unknown>) => void;
+    }) => React.ReactNode;
+    /** 替换行渲染 */
+    renderRow?: (workflow: WorkflowItem, index: number, defaultRow: React.ReactNode) => React.ReactNode;
+    /** 点击设计按钮 */
+    onDesign?: (chainId: string) => void;
+    /** 点击信息按钮 */
+    onInfo?: (workflow: WorkflowItem) => void;
+    /** 点击查看日志 */
+    onViewLogs?: (chainId: string) => void;
+    /** 列表数据变化（增删改后） */
+    onChange?: () => void;
+    /** 发生错误 */
+    onError?: (error: Error) => void;
+    /** 创建成功 */
+    onCreateSuccess?: (chainId: string) => void;
+}
+/**
+ * 工作流列表组件
+ *
+ * @description 支持独立引用，所有功能在包里实现。
+ * CSS 类名前缀 huanban_rulego_list__，不会污染宿主项目。
+ */
+export declare const WorkflowList: React.FC<WorkflowListProps>;
+//# sourceMappingURL=WorkflowList.d.ts.map

package/dist/components/WorkflowList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowList.d.ts","sourceRoot":"","sources":["../../src/components/WorkflowList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAA;AAEvE,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EAEpB,MAAM,6BAA6B,CAAA;AAyBpC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAGhC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACzC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,eAAe,CAAA;IAIzB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS;IACT,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW;IACX,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,cAAc;IACd,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAClC,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,uBAAuB;IACvB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,uBAAuB;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IAIrB,cAAc;IACd,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAA;IAClE,eAAe;IACf,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAA;IAC5F,YAAY;IACZ,WAAW,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAA;IACnC,eAAe;IACf,gBAAgB,CAAC,EAAE,CACjB,WAAW,EAAE,KAAK,CAAC,SAAS,EAC5B,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;KAAE,KAC7E,KAAK,CAAC,SAAS,CAAA;IACpB,YAAY;IACZ,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAA;IAInG,aAAa;IACb,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;IACzC,aAAa;IACb,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW;IACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,WAAW;IACX,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C;AAMD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6XpD,CAAA"}

package/dist/hooks/useClipboard.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @file useClipboard.ts
+ * @description 规则链编辑器剪贴板管理 Hook
+ *
+ * 功能：
+ *   - 复制节点（单个/多个）到内部剪贴板
+ *   - 粘贴节点（自动偏移位置防重叠）
+ *   - 剪切节点（复制 + 删除）
+ *   - 全选节点
+ *   - 支持 Ctrl/Cmd + C/V/X/A 快捷键
+ *
+ * 设计：
+ *   - 使用内存剪贴板（不使用系统剪贴板，避免权限问题）
+ *   - 粘贴时自动生成新 ID，避免 ID 冲突
+ *   - 粘贴位置自动偏移 (30px, 30px)
+ */
+/** 剪贴板中的节点数据 */
+export interface ClipboardNode {
+    /** 原始节点 ID */
+    originalId: string;
+    /** 节点类型 */
+    type: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点位置 X */
+    x: number;
+    /** 节点位置 Y */
+    y: number;
+    /** 节点属性数据 */
+    properties: Record<string, unknown>;
+    /** 节点的完整配置快照 */
+    config?: Record<string, unknown>;
+}
+/** 剪贴板操作回调 */
+export interface ClipboardCallbacks {
+    /** 获取当前选中的节点 */
+    getSelectedNodes?: () => ClipboardNode[];
+    /** 删除指定节点（剪切用） */
+    onDeleteNodes?: (nodeIds: string[]) => void;
+    /** 添加新节点（粘贴用） */
+    onAddNodes?: (nodes: ClipboardNode[]) => void;
+    /** 全选所有节点 */
+    onSelectAll?: () => void;
+    /** 通知消息 */
+    onNotify?: (type: 'success' | 'info', message: string) => void;
+}
+/** useClipboard 返回值 */
+export interface ClipboardManager {
+    /** 复制选中节点 */
+    copy: () => void;
+    /** 剪切选中节点 */
+    cut: () => void;
+    /** 粘贴剪贴板节点 */
+    paste: () => void;
+    /** 全选 */
+    selectAll: () => void;
+    /** 剪贴板是否有内容 */
+    hasContent: boolean;
+    /** 剪贴板中节点数量 */
+    clipboardCount: number;
+    /** 清空剪贴板 */
+    clear: () => void;
+}
+/**
+ * useClipboard Hook
+ *
+ * @description
+ * 管理编辑器的复制/剪切/粘贴/全选操作。
+ * 使用内存剪贴板存储节点数据，粘贴时自动生成新 ID 并偏移位置。
+ *
+ * @param callbacks - 操作回调
+ * @returns 剪贴板管理器
+ *
+ * @example
+ * ```tsx
+ * const clipboard = useClipboard({
+ *   getSelectedNodes: () => selectedNodes,
+ *   onDeleteNodes: (ids) => deleteNodes(ids),
+ *   onAddNodes: (nodes) => addNodes(nodes),
+ *   onSelectAll: () => selectAllNodes(),
+ * })
+ *
+ * // 在键盘事件中调用
+ * clipboard.copy()
+ * clipboard.paste()
+ * ```
+ */
+export declare function useClipboard(callbacks: ClipboardCallbacks): ClipboardManager;
+//# sourceMappingURL=useClipboard.d.ts.map

package/dist/hooks/useClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useClipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,CAAC,EAAE,MAAM,CAAA;IACT,aAAa;IACb,CAAC,EAAE,MAAM,CAAA;IACT,aAAa;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,gBAAgB;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,gBAAgB,CAAC,EAAE,MAAM,aAAa,EAAE,CAAA;IACxC,kBAAkB;IAClB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAC3C,iBAAiB;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;IAC7C,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,WAAW;IACX,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/D;AAED,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,aAAa;IACb,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,aAAa;IACb,GAAG,EAAE,MAAM,IAAI,CAAA;IACf,cAAc;IACd,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,SAAS;IACT,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,eAAe;IACf,UAAU,EAAE,OAAO,CAAA;IACnB,eAAe;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY;IACZ,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAqBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,kBAAkB,GAAG,gBAAgB,CA8F5E"}

package/dist/hooks/useEditorCore.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @file hooks/useEditorCore.ts
+ * @description React Hook — 将 EditorCore 桥接到 React 状态系统
+ *
+ * 兼容性:
+ * - React 16.8+ (hooks 引入版本)
+ * - React 17.x
+ * - React 18.x / 19.x
+ * - Next.js Pages Router 和 App Router
+ *
+ * 设计决策:
+ * - 使用 useEffect + useState 而非 React 18 的 useSyncExternalStore,
+ *   以确保对 React 16.8+ 的兼容性
+ * - 对于 Next.js SSR, EditorCore 实例仅在 useEffect 中创建 (客户端)
+ *
+ * 使用方式:
+ * ```tsx
+ * import { useEditorCore } from '@huanban/rulego-editor-react'
+ *
+ * function MyEditor() {
+ *   const {
+ *     core,
+ *     isReady,
+ *     isDirty,
+ *     selectedNode,
+ *     componentGroups,
+ *     on,
+ *     loadData,
+ *   } = useEditorCore({ url: 'http://127.0.0.1:9090' })  // 通过 url 参数传入实际地址
+ *
+ *   return <div ref={canvasRef} />
+ * }
+ * ```
+ *
+ * Next.js 兼容用法:
+ * ```tsx
+ * // 在 Next.js 中, 使用动态导入避免 SSR 报错
+ * import dynamic from 'next/dynamic'
+ * const Editor = dynamic(() => import('./Editor'), { ssr: false })
+ * ```
+ *
+ * @see EditorCore — 编辑器核心引擎
+ */
+import { EditorCore } from '@huanban/rulego-editor-core';
+import type { EditorOptions, EditorEventMap, EditorEventName, RuleChainData, RuleNodeConfig, RuleConnectionConfig, ComponentDefinition, ComponentGroup } from '@huanban/rulego-editor-core';
+/**
+ * Hook 内部管理的状态
+ */
+interface EditorState {
+    /** 编辑器是否就绪 */
+    isReady: boolean;
+    /** 数据是否已修改 */
+    isDirty: boolean;
+    /** 是否正在加载 */
+    isLoading: boolean;
+    /** 当前选中的节点 */
+    selectedNode: RuleNodeConfig | null;
+    /** 当前选中的边 */
+    selectedEdge: RuleConnectionConfig | null;
+    /** 组件分组 */
+    componentGroups: ComponentGroup[];
+    /** 当前编辑的节点视图 */
+    currentNodeView: ComponentDefinition | null;
+    /** 当前编辑的节点模型 */
+    currentNodeModel: Record<string, unknown>;
+    /** 是否可撤销 */
+    canUndo: boolean;
+    /** 是否可重做 */
+    canRedo: boolean;
+}
+/**
+ * useEditorCore 返回的 Hook 接口
+ */
+export interface UseEditorCoreReturn extends EditorState {
+    /** EditorCore 原始实例 */
+    core: EditorCore | null;
+    /** 加载规则链数据 */
+    loadData: (data: RuleChainData) => void;
+    /** 监听事件 (在组件卸载时自动清理) */
+    on: <E extends EditorEventName>(event: E, handler: (payload: EditorEventMap[E]) => void) => void;
+    /** 发送事件 */
+    emit: <E extends EditorEventName>(event: E, ...args: EditorEventMap[E] extends void ? [] : [EditorEventMap[E]]) => void;
+    /** 初始化 (传入 LogicFlow 实例) */
+    init: (lfInstance: unknown) => void;
+    /** 手动触发保存 */
+    save: () => void;
+}
+/**
+ * React Hook — 创建和管理 EditorCore
+ *
+ * @param options - 编辑器选项 (仅在首次渲染时使用)
+ * @returns 编辑器状态和操作方法
+ *
+ * 内部原理:
+ * - 使用 useRef 持有 EditorCore 实例 (避免重复创建)
+ * - 使用 useState 维护状态 (确保 React 重渲染)
+ * - 使用 useEffect 进行状态订阅和清理
+ * - 避免使用 React 18 专有 API, 确保 16.8+ 兼容性
+ */
+export declare function useEditorCore(options?: Partial<EditorOptions>): UseEditorCoreReturn;
+export {};
+//# sourceMappingURL=useEditorCore.d.ts.map

package/dist/hooks/useEditorCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditorCore.d.ts","sourceRoot":"","sources":["../../src/hooks/useEditorCore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACf,MAAM,6BAA6B,CAAA;AAMpC;;GAEG;AACH,UAAU,WAAW;IACnB,cAAc;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc;IACd,YAAY,EAAE,cAAc,GAAG,IAAI,CAAA;IACnC,aAAa;IACb,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACzC,WAAW;IACX,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC,gBAAgB;IAChB,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC3C,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,YAAY;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAoBD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,sBAAsB;IACtB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IACvB,cAAc;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IACvC,wBAAwB;IACxB,EAAE,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,IAAI,CAAA;IAChG,WAAW;IACX,IAAI,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACvH,4BAA4B;IAC5B,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;IACnC,aAAa;IACb,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,mBAAmB,CAmHrB"}

package/dist/hooks/useEditorI18n.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file hooks/useEditorI18n.ts
+ * @description React Hook — 国际化
+ *
+ * 兼容 React 16.8+, 不使用 React 18 专有 API。
+ *
+ * 使用方式:
+ * ```tsx
+ * const { t, locale, setLocale } = useEditorI18n(core)
+ *
+ * return <button>{t('toolbar.save')}</button>
+ * ```
+ */
+import type { EditorCore } from '@huanban/rulego-editor-core';
+/**
+ * useEditorI18n 返回类型
+ */
+export interface UseEditorI18nReturn {
+    /** 翻译函数 */
+    t: (key: string, params?: Record<string, string>) => string;
+    /** 当前语言 */
+    locale: string;
+    /** 切换语言 */
+    setLocale: (locale: string) => void;
+}
+/**
+ * 国际化 Hook
+ *
+ * @param core - EditorCore 实例 (可空, SSR 安全)
+ * @returns 翻译函数和语言操作
+ */
+export declare function useEditorI18n(core: EditorCore | null): UseEditorI18nReturn;
+//# sourceMappingURL=useEditorI18n.d.ts.map

package/dist/hooks/useEditorI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditorI18n.d.ts","sourceRoot":"","sources":["../../src/hooks/useEditorI18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;IAC3D,WAAW;IACX,MAAM,EAAE,MAAM,CAAA;IACd,WAAW;IACX,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,mBAAmB,CA4B1E"}

package/dist/hooks/useEditorTheme.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file hooks/useEditorTheme.ts
+ * @description React Hook — 主题管理
+ *
+ * 兼容 React 16.8+, 不使用 React 18 专有 API。
+ *
+ * 使用方式:
+ * ```tsx
+ * const { currentTheme, setTheme, themes } = useEditorTheme(core)
+ *
+ * return (
+ *   <select value={currentTheme} onChange={e => setTheme(e.target.value)}>
+ *     {themes.map(t => <option key={t}>{t}</option>)}
+ *   </select>
+ * )
+ * ```
+ */
+import type { EditorCore } from '@huanban/rulego-editor-core';
+/**
+ * useEditorTheme 返回类型
+ */
+export interface UseEditorThemeReturn {
+    /** 当前主题名称 */
+    currentTheme: string;
+    /** 可用主题列表 */
+    themes: string[];
+    /** 切换主题 */
+    setTheme: (name: string) => void;
+}
+/**
+ * 主题管理 Hook
+ *
+ * @param core - EditorCore 实例 (可空, SSR 安全)
+ * @returns 主题状态和操作
+ */
+export declare function useEditorTheme(core: EditorCore | null): UseEditorThemeReturn;
+//# sourceMappingURL=useEditorTheme.d.ts.map

package/dist/hooks/useEditorTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditorTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useEditorTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW;IACX,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,oBAAoB,CAuB5E"}

package/dist/hooks/useKeyboardShortcuts.d.ts

@@ -0,0 +1,73 @@
+/** 快捷键配置 */
+export interface ShortcutConfig {
+    /** 按键（小写，如 's', 'z', 'delete', 'backspace'） */
+    key: string;
+    /** 是否需要 Ctrl/Cmd（自动适配 Mac） */
+    ctrl?: boolean;
+    /** 是否需要 Shift */
+    shift?: boolean;
+    /** 是否需要 Alt/Option */
+    alt?: boolean;
+    /** 是否在 input/textarea 焦点时也生效（默认 false） */
+    enableInInput?: boolean;
+    /** 描述文本（用于帮助界面） */
+    description?: string;
+    /** 处理函数 */
+    handler: (e: KeyboardEvent) => void;
+}
+/** useKeyboardShortcuts 配置 */
+export interface UseKeyboardShortcutsOptions {
+    /** 快捷键列表 */
+    shortcuts: ShortcutConfig[];
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+    /** 事件目标元素（默认 document） */
+    target?: HTMLElement | null;
+}
+/**
+ * useKeyboardShortcuts — 键盘快捷键 Hook
+ *
+ * 自动处理 Mac/Windows 快捷键差异，支持组合键。
+ *
+ * @param options - 快捷键配置
+ *
+ * @example
+ * ```tsx
+ * useKeyboardShortcuts({
+ *   shortcuts: [
+ *     { key: 's', ctrl: true, description: '保存', handler: () => save() },
+ *     { key: 'z', ctrl: true, description: '撤销', handler: () => undo() },
+ *     { key: 'z', ctrl: true, shift: true, description: '重做', handler: () => redo() },
+ *     { key: 'delete', description: '删除', handler: () => deleteSelected() },
+ *   ],
+ * })
+ * ```
+ */
+export declare function useKeyboardShortcuts(options: UseKeyboardShortcutsOptions): void;
+/**
+ * 获取快捷键显示文本
+ *
+ * @param config - 快捷键配置
+ * @returns 可读的快捷键文本（如 "⌘S" 或 "Ctrl+S"）
+ */
+export declare function getShortcutLabel(config: ShortcutConfig): string;
+/**
+ * 生成编辑器默认快捷键
+ *
+ * @param handlers - 操作回调
+ * @returns 快捷键配置列表
+ */
+export declare function getDefaultEditorShortcuts(handlers: {
+    onSave?: () => void;
+    onUndo?: () => void;
+    onRedo?: () => void;
+    onDelete?: () => void;
+    onCopy?: () => void;
+    onPaste?: () => void;
+    onSelectAll?: () => void;
+    onFitView?: () => void;
+    onZoomIn?: () => void;
+    onZoomOut?: () => void;
+    onEscape?: () => void;
+}): ShortcutConfig[];
+//# sourceMappingURL=useKeyboardShortcuts.d.ts.map

package/dist/hooks/useKeyboardShortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../src/hooks/useKeyboardShortcuts.ts"],"names":[],"mappings":"AAsBA,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sBAAsB;IACtB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW;IACX,OAAO,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;CACpC;AAED,8BAA8B;AAC9B,MAAM,WAAW,2BAA2B;IAC1C,YAAY;IACZ,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CAC5B;AA0BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CA6C/E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAgB/D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE;IAClD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,GAAG,cAAc,EAAE,CAgBnB"}