@huanban/rulego-editor-core 1.3.18 → 1.4.0

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

@@ -1,141 +1,51 @@
-/**
- * @file rule-chain.ts
- * @description RuleGo 规则链数据格式类型定义
- *
- * 对应 RuleGo 后端的 JSON 数据结构，用于前后端数据交互。
- * 包含规则链元信息、节点定义、连接定义等完整类型。
- *
- * 数据结构需与当前后端 JSON 协议保持一致。
- */
-/**
- * 节点在画布上的布局信息
- * 存储于 additionalInfo 中，用于还原节点位置
- */
 export interface LayoutInfo {
-    /** 节点 X 坐标 */
     layoutX: number;
-    /** 节点 Y 坐标 */
     layoutY: number;
 }
-/**
- * 节点附加信息
- * 用于存储与业务逻辑无关的元数据（如布局、描述、自定义属性）
- */
 export interface AdditionalInfo extends LayoutInfo {
-    /** 节点描述 */
     description?: string;
-    /** 其他自定义属性 */
     [key: string]: unknown;
 }
-/**
- * 规则链头部配置
- * 定义规则链的基本标识信息
- */
 export interface RuleChainConfig {
-    /** 规则链唯一 ID (UUID 格式) */
     id: string;
-    /** 规则链名称 */
     name?: string;
-    /** 是否为根规则链 */
     root?: boolean;
-    /** 是否启用调试模式 */
     debugMode?: boolean;
-    /** 附加配置 */
     additionalInfo?: Record<string, unknown>;
-    /** 是否禁用 (disabled=true 表示停用中) */
     disabled?: boolean;
-    /** 创建时间 (ISO 8601) */
     createTime?: string;
-    /** 更新时间 (ISO 8601) */
     updateTime?: string;
 }
-/**
- * 规则链中的节点定义
- * 对应 metadata.nodes[] 中的每一项
- */
 export interface RuleNodeConfig {
-    /** 节点唯一 ID (格式: node_1, node_2, ...) */
     id: string;
-    /** 节点类型 (对应注册的组件类型, 如 jsFilter, restApiCall 等) */
     type: string;
-    /** 节点显示名称 */
     name: string;
-    /** 节点配置参数 (JSON 格式, 根据节点类型不同有不同结构) */
     configuration?: Record<string, unknown>;
-    /** 节点附加信息 (包含布局位置等) */
     additionalInfo?: AdditionalInfo;
-    /** 是否启用调试 */
     debugMode?: boolean;
 }
-/**
- * 节点间的连接定义
- * 对应 metadata.connections[] 中的每一项
- */
 export interface RuleConnectionConfig {
-    /** 源节点 ID */
     fromId: string;
-    /** 目标节点 ID */
     toId: string;
-    /** 关系类型 (如 True, False, Success, Failure) */
     type: string;
 }
-/**
- * 端点 (Endpoint) 节点定义
- * 对应 metadata.endpoints[] 中的每一项
- * 端点是规则链的输入/输出接口 (如 HTTP、MQTT、Cron 等)
- */
 export interface RuleEndpointConfig {
-    /** 端点节点 ID (格式: node_N) */
     id: string;
-    /** 端点类型 (如 endpoint/http, endpoint/mqtt) */
     type: string;
-    /** 端点显示名称 */
     name: string;
-    /** 端点配置参数 */
     configuration?: Record<string, unknown>;
-    /** 附加信息 (包含布局位置等) */
     additionalInfo?: AdditionalInfo;
-    /** 是否启用调试 */
     debugMode?: boolean;
-    /** 路由配置 (HTTP 端点特有) */
     routers?: unknown[];
-    /** 处理器列表 */
     processors?: unknown[] | null;
 }
-/**
- * 规则链元数据
- * 包含所有节点和连接信息
- */
 export interface RuleChainMetadata {
-    /** 节点列表 */
     nodes: RuleNodeConfig[];
-    /** 连接列表 */
     connections: RuleConnectionConfig[];
-    /** 端点列表 (输入/输出接口节点) */
     endpoints?: RuleEndpointConfig[];
-    /** 第一个节点的索引 (指向 nodes 数组中的下标) */
     firstNodeIndex?: number;
 }
-/**
- * 完整的规则链数据结构
- * 用于前后端数据交互的顶层结构
- *
- * @example
- * ```json
- * {
- *   "ruleChain": { "id": "xxx", "name": "test" },
- *   "metadata": {
- *     "nodes": [...],
- *     "connections": [...],
- *     "firstNodeIndex": 0
- *   }
- * }
- * ```
- */
 export interface RuleChainData {
-    /** 规则链头部配置 */
     ruleChain: RuleChainConfig;
-    /** 规则链元数据 (节点和连接) */
     metadata: RuleChainMetadata;
 }
-//# sourceMappingURL=rule-chain.d.ts.map

package/dist/utils/GraphUtils.d.ts

@@ -3,22 +3,12 @@ export interface GraphData {
     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/helpers.d.ts

@@ -1,100 +1,20 @@
-/**
- * @file utils/helpers.ts
- * @description 通用工具函数
- *
- * 从原版 util.js 移植的功能函数, 去除 Vue 依赖。
- * 包含:
- * - 文本宽度计算
- * - 节点/边查找
- * - 节点 ID 序号提取
- * - UUID 生成
- *
- * @see 原版: src/components/utils/util.js
- */
 import type { ComponentDefinition, ComponentGroup, RawComponentData } from '../types/component';
-/**
- * 从节点数组中根据 ID 查找节点
- *
- * @param nodes - 节点数组
- * @param id - 目标节点 ID
- * @returns 找到的节点, 未找到返回 undefined
- */
 export declare function getNodeByID<T extends {
     id: string;
 }>(nodes: T[], id: string): T | undefined;
-/**
- * 从边数组中根据源/目标节点 ID 查找边
- *
- * @param edges - 边数组
- * @param sourceNodeId - 源节点 ID
- * @param targetNodeId - 目标节点 ID
- * @returns 找到的边, 未找到返回 undefined
- */
 export declare function getEdgeBySourceNodeIdAndTargetNodeId<T extends {
     sourceNodeId: string;
     targetNodeId: string;
 }>(edges: T[], sourceNodeId: string, targetNodeId: string): T | undefined;
-/**
- * 从节点 ID 中提取序号
- *
- * 节点 ID 格式: node_1, node_23 等
- * 返回数字部分, 如果格式不匹配返回 0
- *
- * @param nodeId - 节点 ID
- * @returns 序号数字
- */
 export declare function getNodeSeq(nodeId: string): number;
-/**
- * 计算字符串的字节长度 (中文算 2, 英文算 1)
- * 用于估算节点文本的显示宽度
- *
- * @param str - 输入字符串
- * @returns 字节长度
- */
 export declare function getBytesLength(str: string): number;
-/**
- * 生成 UUID v4
- *
- * 如果浏览器支持 crypto.randomUUID() 则优先使用,
- * 否则使用 Math.random() 回退方案。
- *
- * @returns UUID 字符串
- */
 export declare function generateUUID(): string;
-/**
- * 将后端 API 返回的原始组件数据转换为按分类分组的格式
- *
- * 对应原版 util.js 中的 adapterComponents 函数。
- * 按 category 字段分组, 并附加分类颜色和标签信息。
- *
- * @param rawData - 后端返回的原始组件列表
- * @param categoryConfig - 自定义分类配置 (可选)
- * @returns 分组后的组件列表
- */
 export declare function adapterComponents(rawData: RawComponentData, categoryConfig?: Record<string, {
     label: string;
     color: string;
 }>): ComponentGroup[];
-/**
- * 将分组后的组件列表转换为扁平的 type => definition 映射
- *
- * 对应原版的 toComponentList 函数。
- *
- * @param componentGroups - 分组后的组件列表
- * @returns type => ComponentDefinition 的映射
- */
 export declare function toComponentMap(componentGroups: ComponentGroup[]): Record<string, ComponentDefinition>;
-/**
- * 默认的 ID 生成器
- *
- * 基于计数器的简单 ID 生成 (对应原版 options.idGenerator)
- *
- * @param type - 元素类型 ('flow-link' 为边, 其他为节点)
- * @param counters - 计数器引用 (nodeCount, edgeCount)
- * @returns 生成的 ID 字符串
- */
 export declare function defaultIdGenerator(type: string, counters: {
     nodeCount: number;
     edgeCount: number;
 }): string;
-//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/index.d.ts

@@ -1,7 +1,2 @@
-/**
- * @file utils/index.ts
- * @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/pinyin-search.d.ts

@@ -1,60 +1,3 @@
-/**
- * @file utils/pinyin-search.ts
- * @description 拼音搜索工具 — 支持中文拼音首字母和模糊匹配
- *
- * 功能:
- * - 中文汉字 → 拼音首字母映射（轻量级，无需外部依赖）
- * - 模糊匹配（支持关键字分词、首字母匹配）
- * - 用于侧边栏组件搜索的增强搜索
- *
- * 使用方式:
- * ```typescript
- * import { fuzzyMatch } from './pinyin-search'
- *
- * fuzzyMatch('JS过滤器', 'jsgl')   // true (首字母匹配)
- * fuzzyMatch('JS过滤器', '过滤')    // true (中文包含)
- * fuzzyMatch('JS过滤器', 'guolv')   // true (拼音匹配)
- * fuzzyMatch('数据库', 'sjk')       // true (首字母)
- * ```
- */
-/**
- * 获取单个汉字的拼音首字母
- *
- * @param char - 单个汉字
- * @returns 拼音首字母（小写），非汉字返回原字符
- */
 export declare function getCharPinyin(char: string): string;
-/**
- * 获取字符串的拼音首字母串
- * 中文提取首字母，英文/数字保持原样
- *
- * @param str - 输入字符串
- * @returns 拼音首字母组成的字符串（全小写）
- *
- * @example
- * getPinyinInitials('JS过滤器')  // 'jsglq'
- * getPinyinInitials('数据库')     // 'sjk'
- * getPinyinInitials('REST')       // 'rest'
- */
 export declare function getPinyinInitials(str: string): string;
-/**
- * 模糊匹配函数 — 支持多种匹配策略
- *
- * 匹配策略（按优先级）:
- * 1. 精确包含匹配（原文包含关键字）
- * 2. 拼音首字母匹配（关键字 = 拼音首字母缩写）
- * 3. 分词匹配（关键字以空格分隔，每个词都需要匹配）
- *
- * @param text - 被搜索的文本
- * @param keyword - 搜索关键字（已小写化）
- * @returns 是否匹配
- *
- * @example
- * fuzzyMatch('JS过滤器', 'jsgl')    // true — 拼音首字母
- * fuzzyMatch('JS过滤器', '过滤')     // true — 包含匹配
- * fuzzyMatch('数据库', 'sjk')        // true — 拼音首字母
- * fuzzyMatch('REST API', 'rest')     // true — 包含匹配
- * fuzzyMatch('发邮件', 'fy')         // true — 拼音首字母
- */
 export declare function fuzzyMatch(text: string, keyword: string): boolean;
-//# sourceMappingURL=pinyin-search.d.ts.map

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

@@ -10,4 +10,3 @@ export declare function getRelationOptionsForNode(nodeView: any, nodeModel: any)
 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

package/dist/utils/textUtils.d.ts

@@ -1,13 +1 @@
-/**
- * @file textUtils.ts
- * @description 文本处理相关工具库
- */
-/**
- * 获取字符串的字节长度
- * 中文/全角字符算作 2 个长度，其他算 1 个
- *
- * @param str 输入字符串
- * @returns 长度
- */
 export declare function getBytesLength(str: string): number;
-//# sourceMappingURL=textUtils.d.ts.map

package/dist/version.d.ts

@@ -1,3 +1,2 @@
-export declare const HUANBAN_RULEGO_EDITOR_VERSION = "1.3.18";
-export declare const EDITOR_VERSION = "1.3.18";
-//# sourceMappingURL=version.d.ts.map
+export declare const HUANBAN_RULEGO_EDITOR_VERSION = "1.4.0";
+export declare const EDITOR_VERSION = "1.4.0";