@huanban/rulego-editor-core 1.0.0

package/README.md

@@ -0,0 +1,211 @@
+# @huanban/editor-core
+
+> RuleGo 规则链编辑器核心库 — 框架无关的 Headless 编辑器引擎 + API 抽象层
+
+[![npm version](https://img.shields.io/npm/v/@huanban/editor-core.svg)](https://www.npmjs.com/package/@huanban/editor-core)
+[![license](https://img.shields.io/npm/l/@huanban/editor-core.svg)](https://github.com/openclaw/rulego-editor/blob/main/LICENSE)
+
+## ✨ 特性
+
+- **框架无关** — 纯 TypeScript 实现，不依赖任何前端框架（React / Vue / Angular 均可）
+- **Headless 架构** — 核心逻辑与 UI 完全解耦，可自由定制界面
+- **API 抽象层** — 提供 `WorkflowFetcher` 接口 + `RuleChainAPI` 默认实现
+- **路径可配置** — 所有 API 端点均通过 `RuleChainRoutes` 自定义
+- **基于 LogicFlow** — 底层使用 LogicFlow 流程图引擎，提供强大的节点编排能力
+- **完整事件系统** — EventBus 事件总线，支持节点/边/编辑器事件监听
+- **状态管理** — 内置 StateStore 响应式状态管理
+- **6 套主题** — 经典(Classic) / 暗夜(Dark) / 自然(Nature) / 优雅(Elegant) / 科技(Tech) / 现代(Modern)
+- **国际化** — 中/英文双语支持，一键切换
+- **撤销/重做** — 内置 undo/redo 操作历史
+- **调试日志** — 内置调试开关，默认关闭，可按需开启
+- **节点分组** — DynamicGroup 容器节点，支持拖入/折叠/调整大小
+
+## 📦 安装
+
+```bash
+npm install @huanban/editor-core
+# 或
+pnpm add @huanban/editor-core
+```
+
+## 🚀 快速开始
+
+### 独立编辑器（推荐）
+
+```html
+<script src="dist/index.umd.js"></script>
+<script>
+  const editor = new RuleGoEditorCore.HuanbanRulegoEditor('#editor', {
+    apiBase: 'http://127.0.0.1:9090/api/v1',
+    onReady: ({ lf, core }) => console.log('就绪'),
+    onNodeClick: (node) => console.log('点击节点', node),
+  })
+</script>
+```
+
+### ESM 模块化用法
+
+```typescript
+import { HuanbanRulegoEditor } from '@huanban/editor-core'
+
+const editor = new HuanbanRulegoEditor('#editor', {
+  apiBase: 'http://127.0.0.1:9090/api/v1',
+  lang: 'zh-CN',
+  theme: 'modern',
+})
+```
+
+### API 客户端
+
+```typescript
+import { RuleChainAPI } from '@huanban/editor-core'
+
+const api = new RuleChainAPI({
+  apiBase: 'http://127.0.0.1:9090/api/v1',
+})
+
+// 获取列表
+const list = await api.list(1, 10)
+
+// 获取内容
+const content = await api.getContent('chain-001')
+```
+
+## 🔧 调试日志
+
+调试日志**默认关闭**，可通过以下方式开启：
+
+```javascript
+// 方式1: 静态方法（推荐）
+HuanbanRulegoEditor.setDebug(true)
+
+// 方式2: URL 参数
+// 浏览器地址栏加 ?debug=1
+
+// 方式3: localStorage 持久化
+localStorage.setItem('huanban_debug', '1')
+
+// 方式4: ESM 直接导入
+import { setDebug } from '@huanban/editor-core'
+setDebug(true)
+```
+
+## 📁 包结构
+
+```
+src/
+├── index.ts              # 包入口（统一导出）
+├── iconRegistry.ts       # 90 个 SVG 图标内联注册
+├── core/                 # 核心引擎模块
+│   ├── EditorCore.ts       # 编辑器主引擎
+│   ├── EventBus.ts         # 类型安全事件总线
+│   ├── StateStore.ts       # 响应式状态容器
+│   ├── DataAdapter.ts      # RuleGo ↔ LogicFlow 数据转换
+│   ├── ComponentRegistry.ts # 组件注册表
+│   ├── HistoryManager.ts   # 撤销/重做管理
+│   ├── ThemeManager.ts     # 6 套主题管理
+│   ├── I18nManager.ts      # 国际化管理
+│   └── ValidationEngine.ts # 图验证引擎
+├── standalone/           # 独立编辑器（全功能 UMD 打包）
+│   ├── HuanbanRulegoEditor.ts  # 主类入口
+│   ├── editor-events.ts     # 事件桥接
+│   ├── editor-toolbar.ts    # 工具栏逻辑
+│   ├── editor-sidebar.ts    # 侧边栏渲染
+│   ├── editor-dialogs.ts    # 弹窗/面板
+│   ├── editor-property-drawers.ts # 属性 Drawer
+│   ├── editor-chain-info.ts # 链信息面板
+│   ├── editor-context-menu.ts # 右键菜单
+│   ├── editor-debug-ws.ts   # WebSocket 调试
+│   ├── editor-styles.ts     # CSS 动态注入
+│   ├── custom-nodes.ts      # 自定义节点注册
+│   ├── group-node.ts        # 分组容器节点
+│   ├── themes.ts            # 主题定义（6 套）
+│   ├── node-definitions.ts  # 节点分类配置
+│   ├── node-views-data.ts   # 节点视觉数据
+│   ├── code-editor.ts       # CodeMirror 集成
+│   ├── icon-utils.ts        # 图标工具
+│   └── logger.ts            # 调试日志工具
+├── api/                  # API 客户端
+│   ├── RuleChainAPI.ts     # 默认 HTTP 客户端
+│   └── types.ts            # WorkflowFetcher 接口
+├── types/                # TypeScript 类型定义
+│   ├── editor.ts           # 编辑器配置/状态类型
+│   ├── rule-chain.ts       # 规则链数据类型
+│   ├── component.ts        # 组件定义类型
+│   └── events.ts           # 事件映射类型
+├── defaults/             # 默认数据
+│   ├── components.ts       # 内置组件定义
+│   ├── locale-zh-CN.ts     # 中文语言包
+│   └── locale-en-US.ts     # 英文语言包
+├── utils/                # 工具函数
+│   ├── helpers.ts          # 通用辅助函数
+│   └── pinyin-search.ts    # 拼音搜索
+├── styles/               # CSS 样式文件
+│   ├── editor.css          # 编辑器主样式
+│   ├── info-panel.css      # 信息面板样式
+│   └── list.css            # 列表组件样式
+└── icons/                # 90 个 SVG 图标源文件
+```
+
+## 📖 核心模块
+
+| 模块 | 说明 |
+|------|------|
+| `EditorCore` | 编辑器主类，管理生命周期和数据流 |
+| `HuanbanRulegoEditor` | 独立编辑器主类，全功能即开即用 |
+| `RuleChainAPI` | 默认 API 客户端，实现 `WorkflowFetcher` 接口 |
+| `DEFAULT_ROUTES` | 默认 API 路径映射 (RuleGo 标准路径) |
+| `EventBus` | 事件总线，支持 on / off / emit 模式 |
+| `StateStore` | 响应式状态容器，支持 subscribe |
+| `ThemeManager` | 主题管理器，6 套主题自由切换 |
+| `I18nManager` | 国际化管理器，中英文切换 |
+| `ValidationEngine` | 规则链验证引擎 |
+| `setDebug` / `isDebug` | 调试日志开关 |
+
+## 📋 导出类型
+
+```typescript
+// 数据类型
+WorkflowItem          // 工作流列表项
+PagedResponse<T>      // 分页响应
+ApiResult             // 操作结果
+
+// 请求抽象
+WorkflowFetcher       // 请求适配器接口（8 个方法）
+RuleChainAPIOptions   // API 客户端配置
+RuleChainRoutes       // 路径映射（支持函数式路由）
+
+// UI 自定义
+WorkflowListIcons     // 列表组件图标映射
+WorkflowInfoIcons     // 信息面板图标映射
+WorkflowTheme         // 主题类型
+
+// 编辑器类型
+EditorOptions, RuleChainData, RuleChainConfig
+RuleNodeConfig, RuleConnectionConfig, RuleEndpointConfig
+ComponentDefinition, ComponentGroup, ComponentField
+EditorEventMap, EditorEventName
+HuanbanRulegoEditorOptions
+```
+
+## 🏗️ 构建产物
+
+| 格式 | 文件 | 说明 |
+|------|------|------|
+| ESM | `dist/index.esm.js` | 现代打包工具 (Vite/Webpack) |
+| CJS | `dist/index.cjs.js` | Node.js / 旧项目 |
+| UMD | `dist/index.umd.js` | `<script>` 标签直接引入，暴露 `window.RuleGoEditorCore` |
+
+> 所有格式均全量打包 LogicFlow + CodeMirror，无需额外安装。
+> CSS 通过 `editor-styles.ts` 动态注入，无需单独引入样式文件。
+
+## 🔗 相关包
+
+| 包 | 说明 |
+|---|---|
+| [`@huanban/editor-react`](../editor-react) | React 适配层 (Hooks + 组件) |
+| [`@huanban/editor-vue`](../editor-vue) | Vue 3 适配层 |
+
+## 📄 协议
+
+Apache-2.0

package/dist/api/RuleChainAPI.d.ts

@@ -0,0 +1,163 @@
+/**
+ * @file api/RuleChainAPI.ts
+ * @description 规则链 API 客户端 — 框架无关，纯 fetch 实现
+ *
+ * 功能:
+ *   - 列表查询（分页 + 搜索）
+ *   - CRUD（创建/读取/更新/删除）
+ *   - 上线/下线操作
+ *   - 变量/秘钥管理
+ *   - 复制规则链
+ *
+ * 该类实现了 WorkflowFetcher 接口，可直接作为默认请求层使用。
+ * 消费者也可以传入自定义 fetcher 来替换整个请求层。
+ *
+ * 所有方法均为实例方法，使用原生 fetch + AbortController 超时。
+ *
+ * 使用方式:
+ * ```ts
+ * import { RuleChainAPI } from '@huanban/rulego-editor-core'
+ *
+ * // 方式1: 直接用 RuleChainAPI
+ * const api = new RuleChainAPI({ apiBase: 'http://127.0.0.1:9090/api/v1' })
+ * const data = await api.list(1, 20, 'test')
+ *
+ * // 方式2: 作为 fetcher 传给组件
+ * <WorkflowList fetcher={new RuleChainAPI({ apiBase: '...' })} />
+ * ```
+ *
+ * @module @huanban/rulego-editor-core/api
+ */
+import type { WorkflowItem, PagedResponse, ApiResult, WorkflowFetcher, RuleChainAPIOptions } from './types';
+/**
+ * 规则链 API 客户端
+ *
+ * @description 封装所有规则链相关的 REST API 调用，
+ * 实现 WorkflowFetcher 接口，可整体替换。
+ * 使用原生 fetch，不依赖任何框架。
+ *
+ * @example
+ * ```ts
+ * const api = new RuleChainAPI({ apiBase: 'http://localhost:9090/api/v1' })
+ *
+ * // 作为 WorkflowFetcher 使用
+ * const list = await api.list(1, 20, '')
+ * const chain = await api.getContent('chain-123')
+ *
+ * // 直接传给组件
+ * <WorkflowList fetcher={api} />
+ * ```
+ */
+export declare class RuleChainAPI implements WorkflowFetcher {
+    /** API 基础地址 */
+    private apiBase;
+    /** 请求超时（毫秒） */
+    private timeout;
+    /** 自定义请求头 */
+    private headers;
+    /** 路由映射（支持自定义 API 路径） */
+    private routes;
+    /**
+     * 创建 API 客户端实例
+     *
+     * @param options - 配置项
+     * @param options.apiBase - API 基础地址（如 'http://127.0.0.1:9090/api/v1'）
+     * @param options.timeout - 请求超时毫秒数，默认 8000
+     * @param options.headers - 自定义请求头
+     * @param options.authToken - Bearer Token
+     */
+    constructor(options: RuleChainAPIOptions);
+    /**
+     * 发起 fetch 请求（带超时控制）
+     *
+     * @param path - API 路径（相对 apiBase）
+     * @param init - fetch 配置
+     * @returns 解析后的 JSON
+     */
+    private request;
+    /**
+     * 将后端 RuleChain DSL 对象转为前端扁平化 WorkflowItem
+     *
+     * @description 后端返回 { ruleChain: { id, name, root, disabled, additionalInfo }, metadata: {...} }
+     * 前端通过此方法转换为扁平化结构。
+     *
+     * @param raw - 后端原始对象
+     * @returns 扁平化的 WorkflowItem
+     */
+    static parseRuleChain(raw: unknown): WorkflowItem;
+    /**
+     * 生成随机规则链 ID（12 位字母数字）
+     * @returns 生成的 ID
+     */
+    static generateChainId(): string;
+    /**
+     * 查询规则链列表（分页 + 搜索）
+     *
+     * @param page - 页码（从 1 开始）
+     * @param size - 每页条数
+     * @param keywords - 搜索关键词
+     * @returns 分页结果
+     */
+    list(page?: number, size?: number, keywords?: string): Promise<PagedResponse<WorkflowItem>>;
+    /**
+     * 创建规则链
+     *
+     * @param data - 规则链 DSL 数据
+     * @returns 操作结果
+     */
+    create(data: Record<string, unknown>): Promise<ApiResult>;
+    /**
+     * 删除规则链
+     *
+     * @param id - 规则链 ID
+     * @returns 操作结果
+     */
+    remove(id: string): Promise<ApiResult>;
+    /**
+     * 上线/下线规则链
+     *
+     * @param id - 规则链 ID
+     * @param type - 'start'（上线）| 'stop'（下线）
+     * @returns 操作结果
+     */
+    operate(id: string, type: 'start' | 'stop'): Promise<ApiResult>;
+    /**
+     * 复制规则链
+     *
+     * @description 获取完整内容 → 修改名称和 ID → 创建新的
+     * @param id - 原始规则链 ID
+     * @param newName - 新名称（不传则自动加 _副本）
+     * @returns 操作结果
+     */
+    copy(id: string, newName?: string): Promise<ApiResult>;
+    /**
+     * 获取规则链完整内容（包含 metadata）
+     *
+     * @param id - 规则链 ID
+     * @returns 完整的 RuleChain DSL
+     */
+    getContent(id: string): Promise<Record<string, unknown>>;
+    /**
+     * 保存/更新规则链基础信息
+     *
+     * @param id - 规则链 ID
+     * @param info - 基础信息字段（name/description 等）
+     * @returns 操作结果
+     */
+    saveBaseInfo(id: string, info: Record<string, unknown>): Promise<ApiResult>;
+    /**
+     * 保存规则链配置（变量或秘钥）
+     *
+     * @param id - 规则链 ID
+     * @param configType - 'vars'（变量）| 'secrets'（秘钥）
+     * @param data - key-value 配置数据
+     * @returns 操作结果
+     */
+    saveConfig(id: string, configType: 'vars' | 'secrets', data: Record<string, string>): Promise<ApiResult>;
+    /**
+     * 获取当前 API 基础地址
+     * @returns apiBase
+     */
+    getApiBase(): string;
+}
+//# sourceMappingURL=RuleChainAPI.d.ts.map

package/dist/api/RuleChainAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuleChainAPI.d.ts","sourceRoot":"","sources":["../../src/api/RuleChainAPI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,eAAe,EACf,mBAAmB,EAEpB,MAAM,SAAS,CAAA;AAOhB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAa,YAAW,eAAe;IAClD,eAAe;IACf,OAAO,CAAC,OAAO,CAAQ;IACvB,eAAe;IACf,OAAO,CAAC,OAAO,CAAQ;IACvB,aAAa;IACb,OAAO,CAAC,OAAO,CAAwB;IACvC,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAiB;IAE/B;;;;;;;;OAQG;gBACS,OAAO,EAAE,mBAAmB;IAkBxC;;;;;;OAMG;YACW,OAAO;IA2BrB;;;;;;;;OAQG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY;IAkBjD;;;OAGG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;IAahC;;;;;;;OAOG;IACG,IAAI,CAAC,IAAI,SAAI,EAAE,IAAI,SAAK,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IA8BpF;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAY/D;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAS5C;;;;;;OAMG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IASrE;;;;;;;OAOG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAmB5D;;;;;OAKG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI9D;;;;;;OAMG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAYjF;;;;;;;OAOG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAgB9G;;;OAGG;IACH,UAAU,IAAI,MAAM;CAGrB"}

package/dist/api/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file api/index.ts
+ * @description API 模块 barrel 导出
+ *
+ * 导出内容:
+ * - RuleChainAPI: 内置请求实现（纯 fetch）
+ * - WorkflowFetcher: 请求适配器接口（用于替换请求层）
+ * - RuleChainRoutes / DEFAULT_ROUTES: 路由映射（用于替换 API 路径）
+ * - WorkflowListIcons / WorkflowInfoIcons: 图标映射接口
+ * - 数据类型: WorkflowItem / PagedResponse / ApiResult
+ */
+export { RuleChainAPI } from './RuleChainAPI';
+export { DEFAULT_ROUTES } from './types';
+export type { WorkflowItem, PagedResponse, ApiResult, WorkflowFetcher, RuleChainAPIOptions, RuleChainRoutes, WorkflowListIcons, WorkflowInfoIcons, WorkflowTheme, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAA"}

package/dist/api/types.d.ts

@@ -0,0 +1,244 @@
+/**
+ * @file api/types.ts
+ * @description 规则链 API 通用类型定义 — 框架无关
+ *
+ * 这些类型在 editor-core / editor-react / editor-vue 三个包之间共享。
+ * 消费者通过实现 WorkflowFetcher 接口来替换默认的请求实现。
+ *
+ * @module @huanban/rulego-editor-core/api
+ */
+/**
+ * 工作流列表项（前端扁平化结构）
+ *
+ * @description 后端返回嵌套 { ruleChain: {...}, metadata: {...} }，
+ * 经过 parseRuleChain() 转换为此扁平结构供 UI 消费。
+ */
+export interface WorkflowItem {
+    /** 规则链 ID */
+    id: string;
+    /** 规则链名称 */
+    name: string;
+    /** 是否为根规则链 */
+    root: boolean;
+    /** 是否禁用 */
+    disabled: boolean;
+    /** 是否开启调试模式 */
+    debugMode: boolean;
+    /** 描述 */
+    description: string;
+    /** 附加信息（保留原始字段） */
+    additionalInfo: Record<string, unknown>;
+    /** 创建时间 */
+    createTime: string;
+    /** 更新时间 */
+    updateTime: string;
+    /** 是否已部署 (disabled=false → deployed=true) */
+    deployed: boolean;
+}
+/**
+ * 分页响应
+ */
+export interface PagedResponse<T> {
+    /** 数据列表 */
+    items: T[];
+    /** 总记录数 */
+    total: number;
+    /** 当前页码 */
+    page: number;
+    /** 每页条数 */
+    pageSize: number;
+}
+/**
+ * API 操作结果
+ */
+export interface ApiResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 消息 */
+    msg?: string;
+    /** 可选数据 */
+    data?: unknown;
+}
+/**
+ * 工作流请求适配器接口
+ *
+ * @description 消费者可实现此接口来替换包的默认请求方式。
+ * 不传 fetcher 时，包会用内置的 RuleChainAPI (纯 fetch) 实现。
+ * 传了 fetcher 后，apiBase 参数不再生效。
+ *
+ * @example 使用 axios 替换:
+ * ```ts
+ * const myFetcher: WorkflowFetcher = {
+ *   list: async (page, size, kw) => {
+ *     const res = await axios.get('/api/v1/rules', { params: { page, size, keywords: kw } })
+ *     return res.data
+ *   },
+ *   create: async (data) => {
+ *     await axios.post('/api/v1/rules', data)
+ *     return { success: true }
+ *   },
+ *   // ...
+ * }
+ * ```
+ *
+ * @example 使用 systemGateway (HuanbanClaw):
+ * ```ts
+ * const myFetcher: WorkflowFetcher = {
+ *   list: (p, s, kw) => systemGateway.getRuleChains(p, s, kw),
+ *   create: (data) => systemGateway.createRuleChain(data),
+ *   remove: (id) => systemGateway.deleteRuleChain(id),
+ *   operate: (id, type) => systemGateway.operateRuleChain(id, type),
+ *   copy: (id) => systemGateway.copyRuleChain(id),
+ *   getContent: (id) => systemGateway.getRuleChainContent(id),
+ *   saveBaseInfo: (id, data) => systemGateway.saveRuleChainBaseInfo(id, data),
+ *   saveConfig: (id, type, data) => systemGateway.saveRuleChainConfig(id, type, data),
+ * }
+ * ```
+ */
+export interface WorkflowFetcher {
+    /** 查询列表（分页 + 搜索） */
+    list: (page: number, size: number, keywords: string) => Promise<PagedResponse<WorkflowItem>>;
+    /** 创建规则链 */
+    create: (data: Record<string, unknown>) => Promise<ApiResult>;
+    /** 删除规则链 */
+    remove: (id: string) => Promise<ApiResult>;
+    /** 上线/下线 */
+    operate: (id: string, type: 'start' | 'stop') => Promise<ApiResult>;
+    /** 复制规则链 */
+    copy: (id: string, newName?: string) => Promise<ApiResult>;
+    /** 获取完整内容 */
+    getContent: (id: string) => Promise<Record<string, unknown>>;
+    /** 保存基础信息 */
+    saveBaseInfo: (id: string, info: Record<string, unknown>) => Promise<ApiResult>;
+    /** 保存配置（变量或秘钥） */
+    saveConfig: (id: string, configType: 'vars' | 'secrets', data: Record<string, string>) => Promise<ApiResult>;
+}
+/**
+ * 工作流列表图标映射
+ *
+ * @description 消费者可传入自定义图标（React/Vue 节点或字符串）。
+ * 不传时使用包内置的 emoji 图标（零依赖）。
+ *
+ * 在 原生 JS 中传 HTML 字符串:
+ * ```js
+ * icons: { design: '<svg>...</svg>', delete: '🗑' }
+ * ```
+ *
+ * 在 React 中传 JSX:
+ * ```tsx
+ * icons={{ design: <EditOutlined />, delete: <DeleteOutlined /> }}
+ * ```
+ */
+export interface WorkflowListIcons {
+    /** 设计按钮图标 */
+    design?: unknown;
+    /** 信息按钮图标 */
+    info?: unknown;
+    /** 上线按钮图标 */
+    start?: unknown;
+    /** 下线按钮图标 */
+    stop?: unknown;
+    /** 复制按钮图标 */
+    copy?: unknown;
+    /** 删除按钮图标 */
+    delete?: unknown;
+    /** 搜索图标 */
+    search?: unknown;
+    /** 刷新图标 */
+    refresh?: unknown;
+    /** 添加图标 */
+    add?: unknown;
+    /** 工作流图标 */
+    workflow?: unknown;
+    /** 记录图标 */
+    logs?: unknown;
+}
+/**
+ * 工作流信息面板图标映射
+ */
+export interface WorkflowInfoIcons {
+    /** 变量图标 */
+    variable?: unknown;
+    /** 秘钥图标 */
+    secret?: unknown;
+    /** API 集成图标 */
+    api?: unknown;
+    /** MCP 集成图标 */
+    mcp?: unknown;
+    /** 复制图标 */
+    copy?: unknown;
+    /** 删除图标 */
+    delete?: unknown;
+    /** 添加图标 */
+    add?: unknown;
+    /** 保存图标 */
+    save?: unknown;
+}
+/**
+ * 支持的主题类型
+ */
+export type WorkflowTheme = 'light' | 'dark' | string;
+/**
+ * API 路由映射
+ *
+ * @description 消费者可逐个覆盖 API 路径。
+ * 支持字符串模板或函数两种形式，函数接收动态参数返回完整路径。
+ *
+ * @example 自定义路由:
+ * ```ts
+ * const routes: Partial<RuleChainRoutes> = {
+ *   list: '/my-api/chains',                    // 字符串
+ *   getContent: (id) => `/my-api/chains/${id}`, // 函数
+ *   operate: (id, type) => `/my-api/chains/${id}/action/${type}`,
+ *   saveBaseInfo: (id) => `/custom/${id}/info`,
+ * }
+ * ```
+ */
+export interface RuleChainRoutes {
+    /** 列表路径，默认 '/rules' */
+    list: string;
+    /** 创建路径，默认 '/rules' */
+    create: string;
+    /** 删除路径，接收 (id) => string，默认 '/rules/:id' */
+    remove: (id: string) => string;
+    /** 上线/下线路径，接收 (id, type) => string，默认 '/rules/:id/:type' */
+    operate: (id: string, type: string) => string;
+    /** 获取内容路径，接收 (id) => string，默认 '/rules/:id' */
+    getContent: (id: string) => string;
+    /** 保存基础信息路径，接收 (id) => string，默认 '/rules/:id/base' */
+    saveBaseInfo: (id: string) => string;
+    /** 保存配置路径，接收 (id, configType) => string，默认 '/rules/:id/config/:configType' */
+    saveConfig: (id: string, configType: string) => string;
+}
+/**
+ * 默认路由映射
+ *
+ * @description 对应 RuleGo 原生 API 路径
+ */
+export declare const DEFAULT_ROUTES: RuleChainRoutes;
+/**
+ * 内置 API 客户端配置
+ */
+export interface RuleChainAPIOptions {
+    /** API 基础地址（如 'http://127.0.0.1:9090/api/v1'） */
+    apiBase: string;
+    /** 请求超时毫秒数，默认 8000 */
+    timeout?: number;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+    /** 认证 Token */
+    authToken?: string;
+    /**
+     * 自定义路由映射（可部分覆盖）
+     *
+     * @example
+     * ```ts
+     * routes: {
+     *   list: '/my-custom/chains',
+     *   remove: (id) => `/my-custom/chains/${id}`,
+     * }
+     * ```
+     */
+    routes?: Partial<RuleChainRoutes>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"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"}