@huanban/rulego-editor-core 1.0.0

package/dist/types/events.d.ts

@@ -0,0 +1,199 @@
+/**
+ * @file events.ts
+ * @description 编辑器事件类型定义 - 强类型事件系统
+ *
+ * 定义编辑器所有事件的名称和对应的负载类型。
+ * 通过 TypeScript 泛型约束，确保事件触发和监听的类型安全。
+ *
+ * 事件分类:
+ * - 节点事件 (node:*)
+ * - 边事件 (edge:*)
+ * - 画布事件 (canvas:*)
+ * - 编辑器事件 (editor:*)
+ * - 历史事件 (history:*)
+ */
+import type { RuleNodeConfig, RuleConnectionConfig, RuleChainData, RuleChainConfig } from './rule-chain';
+import type { ComponentGroup } from './component';
+/**
+ * 节点点击/选择事件的负载
+ */
+export interface NodeEventPayload {
+    /** 节点的 LogicFlow ID */
+    id: string;
+    /** 节点类型 (simple-node, start-node, chain-node, group-node) */
+    type: string;
+    /** 节点 X 坐标 */
+    x: number;
+    /** 节点 Y 坐标 */
+    y: number;
+    /** 节点显示文本 */
+    text: string;
+    /** 节点属性 (包含 model 和 view) */
+    properties: {
+        model: RuleNodeConfig;
+        view?: Record<string, unknown>;
+    };
+}
+/**
+ * 边点击/选择事件的负载
+ */
+export interface EdgeEventPayload {
+    /** 边的 LogicFlow ID */
+    id: string;
+    /** 边类型 */
+    type: string;
+    /** 源节点 ID */
+    sourceNodeId: string;
+    /** 目标节点 ID */
+    targetNodeId: string;
+    /** 边显示文本 */
+    text: string;
+    /** 边属性 (包含 model) */
+    properties: {
+        model: RuleConnectionConfig;
+    };
+}
+/**
+ * 保存事件负载
+ */
+export interface SaveEventPayload {
+    /** 保存的规则链数据 */
+    data: RuleChainData;
+    /** 是否保存成功 */
+    success: boolean;
+    /** 错误信息 (如果失败) */
+    error?: Error;
+}
+/**
+ * 历史变更事件负载
+ */
+export interface HistoryChangePayload {
+    /** 是否可以撤销 */
+    canUndo: boolean;
+    /** 是否可以重做 */
+    canRedo: boolean;
+    /** 撤销栈深度 */
+    undoCount: number;
+    /** 重做栈深度 */
+    redoCount: number;
+}
+/**
+ * 验证事件负载
+ */
+export interface ValidationPayload {
+    /** 验证是否通过 */
+    valid: boolean;
+    /** 验证错误列表 */
+    errors: Array<{
+        /** 规则名称 */
+        rule: string;
+        /** 错误消息 */
+        message: string;
+        /** 相关的节点/边 ID */
+        elementId?: string;
+    }>;
+}
+/**
+ * 编辑器事件映射表
+ * Key 为事件名称, Value 为事件负载类型
+ *
+ * @example
+ * ```typescript
+ * // 使用:
+ * editor.on('node:click', (payload: NodeEventPayload) => { ... })
+ * editor.emit('editor:save', { data, success: true })
+ * ```
+ */
+export interface EditorEventMap {
+    /** 节点被点击 */
+    'node:click': NodeEventPayload;
+    /** 节点被双击 (触发编辑) */
+    'node:dbclick': NodeEventPayload;
+    /** 节点被选中 */
+    'node:selected': NodeEventPayload;
+    /** 节点被拖入画布 (外部拖入) */
+    'node:dnd-add': NodeEventPayload;
+    /** 节点被添加到画布 */
+    'node:add': NodeEventPayload;
+    /** 节点被删除 */
+    'node:delete': {
+        id: string;
+    };
+    /** 节点被拖动/移动 */
+    'node:drop': NodeEventPayload;
+    /** 节点属性被更新 */
+    'node:property-update': {
+        id: string;
+        properties: Record<string, unknown>;
+    };
+    /** 边被点击 */
+    'edge:click': EdgeEventPayload;
+    /** 边被双击 (触发编辑) */
+    'edge:dbclick': EdgeEventPayload;
+    /** 边被添加 */
+    'edge:add': EdgeEventPayload;
+    /** 边被删除 */
+    'edge:delete': {
+        id: string;
+    };
+    /** 边属性被更新 */
+    'edge:property-update': {
+        id: string;
+        properties: Record<string, unknown>;
+    };
+    /** 画布空白区被点击 (取消选择) */
+    'blank:click': void;
+    /** 画布缩放 */
+    'canvas:zoom': {
+        scale: number;
+    };
+    /** 组件列表加载完成 */
+    'editor:components-loaded': ComponentGroup[];
+    /** 数据加载完成 (通知适配层渲染 LogicFlow 数据) */
+    'editor:data-loaded': {
+        lfData: import('../core/DataAdapter').LFGraphData;
+        ruleChain: RuleChainConfig;
+    };
+    /** 编辑器就绪 */
+    'editor:ready': void;
+    /** 编辑器销毁 */
+    'editor:destroy': void;
+    /** 保存请求 */
+    'editor:save': SaveEventPayload;
+    /** 保存成功 */
+    'editor:save-ok': RuleChainData;
+    /** 保存失败 */
+    'editor:save-error': {
+        data: RuleChainData;
+        error: Error;
+    };
+    /** 新建规则链 */
+    'editor:new': RuleChainConfig;
+    /** 打开规则链 */
+    'editor:open': RuleChainData;
+    /** 配置变更 */
+    'editor:setting': Record<string, unknown>;
+    /** 全屏切换 */
+    'editor:fullscreen': void;
+    /** 重置 */
+    'editor:reset': void;
+    /** 删除选中元素 */
+    'editor:delete-selected': void;
+    /** 元素已被删除 */
+    'editor:deleted': void;
+    /** 编辑面板请求 */
+    'editor:show-edit-panel': void;
+    /** 历史记录变更 */
+    'history:change': HistoryChangePayload;
+    /** 验证完成 */
+    'validation:complete': ValidationPayload;
+}
+/**
+ * 事件名称联合类型
+ */
+export type EditorEventName = keyof EditorEventMap;
+/**
+ * 通用事件监听器类型
+ */
+export type EventListener<T = unknown> = (payload: T) => void;
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file types/index.ts
+ * @description 类型统一导出入口
+ *
+ * 所有类型定义从这里集中导出，
+ * 方便外部使用: import type { RuleChainData, EditorOptions } from '@huanban/rulego-editor-core'
+ */
+export type { LayoutInfo, AdditionalInfo, RuleChainConfig, RuleNodeConfig, RuleConnectionConfig, RuleEndpointConfig, RuleChainMetadata, RuleChainData, } from './rule-chain';
+export type { FieldValidation, ComponentField, ComponentCategory, ComponentDefinition, ComponentGroup, RawComponentData, ComponentRegistryOptions, } from './component';
+export type { ApiEndpoints, RequestConfig, ToolbarConfig, GridConfig, EditorOptions, PanelType, EditorState, EditorPlugin, EditorInternalData, } from './editor';
+export type { NodeEventPayload, EdgeEventPayload, SaveEventPayload, HistoryChangePayload, ValidationPayload, EditorEventMap, EditorEventName, EventListener, } from './events';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,cAAc,CAAA;AAGrB,YAAY,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,aAAa,CAAA;AAGpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,SAAS,EACT,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAGjB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAA"}

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

@@ -0,0 +1,141 @@
+/**
+ * @file rule-chain.ts
+ * @description RuleGo 规则链数据格式类型定义
+ *
+ * 对应 RuleGo 后端的 JSON 数据结构，用于前后端数据交互。
+ * 包含规则链元信息、节点定义、连接定义等完整类型。
+ *
+ * @see https://rulego.cc/pages/a2a7a9/ RuleGo 官方文档
+ */
+/**
+ * 节点在画布上的布局信息
+ * 存储于 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/types/rule-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-chain.d.ts","sourceRoot":"","sources":["../../src/types/rule-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,cAAc;IACd,OAAO,EAAE,MAAM,CAAA;IACf,cAAc;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,cAAc;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,eAAe;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW;IACX,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,uBAAuB;IACvB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,aAAa;IACb,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,qBAAqB;IACrB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,aAAa;IACb,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,YAAY;IACZ,UAAU,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,WAAW;IACX,WAAW,EAAE,oBAAoB,EAAE,CAAA;IACnC,uBAAuB;IACvB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAChC,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,SAAS,EAAE,eAAe,CAAA;IAC1B,qBAAqB;IACrB,QAAQ,EAAE,iBAAiB,CAAA;CAC5B"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @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/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAM/F;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAClD,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,SAAS,CAEf;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACxD,KAAK,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAMvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAalD;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAkBrC;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAChE,cAAc,EAAE,CA6BlB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,cAAc,EAAE,GAChC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAQrC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjD,MAAM,CAQR"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file utils/index.ts
+ * @description 工具函数统一导出入口
+ */
+export { getNodeByID, getEdgeBySourceNodeIdAndTargetNodeId, getNodeSeq, getBytesLength, generateUUID, adapterComponents, toComponentMap, defaultIdGenerator, } from './helpers';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,oCAAoC,EACpC,UAAU,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,WAAW,CAAA"}

package/dist/utils/pinyin-search.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @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/pinyin-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinyin-search.d.ts","sourceRoot":"","sources":["../../src/utils/pinyin-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA0DH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAqBjE"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@huanban/rulego-editor-core",
+  "version": "1.0.0",
+  "description": "RuleGo 规则链编辑器核心库 - 框架无关的 Headless 编辑器引擎 + API 抽象层 (WorkflowFetcher)",
+  "type": "module",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/rulego-editor",
+    "directory": "packages/editor-core"
+  },
+  "homepage": "https://github.com/openclaw/rulego-editor#readme",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build && tsc --emitDeclarationOnly --outDir dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@codemirror/autocomplete": "^6.20.1",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/language": "^6.12.2",
+    "@codemirror/lint": "^6.9.5",
+    "@codemirror/search": "^6.6.0",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.40.0",
+    "@logicflow/core": "2.1.11",
+    "@logicflow/extension": "2.1.11",
+    "codemirror": "^6.0.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^4.0.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "rulego",
+    "editor-core",
+    "headless",
+    "logicflow",
+    "rule-chain",
+    "rule-engine",
+    "workflow",
+    "fetcher",
+    "api-client"
+  ],
+  "author": "HuanBan Team",
+  "license": "Apache-2.0"
+}