@huanban/rulego-editor-core 1.3.18 → 1.4.0

package/dist/core/server-status.d.ts

@@ -0,0 +1,34 @@
+export type ServerStatus = 'unknown' | 'checking' | 'online' | 'unauthorized' | 'forbidden' | 'offline' | 'error';
+export type ServerApiStatus = 'unknown' | 'checking' | 'online' | 'unauthorized' | 'forbidden' | 'offline' | 'error';
+export type ServerWsStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
+export type ServerWsEventStatus = ServerWsStatus | 'live' | 'disconnected';
+export interface ServerStatusState extends Record<string, unknown> {
+    api: ServerApiStatus;
+    ws: ServerWsStatus;
+    status: ServerStatus;
+    baseUrl: string;
+    wsUrl: string;
+    httpStatus: number | null;
+    wsCloseCode: number | null;
+    reconnectAttempt: number;
+    lastChangedAt: number | null;
+    errorMessage?: string;
+}
+export interface ServerStatusOptions {
+    baseUrl?: string;
+    wsUrl?: string;
+}
+export declare function deriveWsUrl(baseUrl: string, path?: string): string;
+export declare class ServerStatusStore {
+    private readonly store;
+    private destroyed;
+    constructor(options?: ServerStatusOptions);
+    getState(): Readonly<ServerStatusState>;
+    subscribe(listener: (state: Readonly<ServerStatusState>, previousState: Readonly<ServerStatusState>) => void): () => void;
+    setServerUrl(baseUrl: string, wsUrl?: string): void;
+    setServerStatus(status: ServerStatus, details?: Partial<ServerStatusState>): void;
+    recordHttpStatus(statusCode: number, message?: string): ServerStatus;
+    recordWebSocketStatus(eventStatus: ServerWsEventStatus, closeCode?: number | null, message?: string): ServerStatus;
+    setReconnectAttempt(attempt: number): void;
+    destroy(): void;
+}

package/dist/core/simple-array.d.ts

@@ -0,0 +1,4 @@
+export declare const SIMPLE_ARRAY_DELIMITER: RegExp;
+export declare function parseSimpleArrayInput(value: string): string[];
+export declare function normalizeSimpleArrayValues(value: unknown): string[];
+export declare function mergeSimpleArrayValues(existing: unknown, input: string): string[];

package/dist/core/table-protocol.d.ts

@@ -0,0 +1,36 @@
+import type { ComponentField } from '../types/component';
+export type TableRow = Record<string, unknown>;
+export interface TablePage<T = TableRow> {
+    items: T[];
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+}
+export interface PointGenerationOptions {
+    prefix?: string;
+    start: number;
+    count: number;
+    step?: number;
+    type?: unknown;
+    namePrefix?: string;
+    existing?: TableRow[];
+}
+export declare function coerceTableCellValue(field: Pick<ComponentField, 'type' | 'component'> | undefined, value: unknown): unknown;
+export interface PointTableImportDecision {
+    mode: 'replace';
+    requiresConfirmation: boolean;
+}
+export declare function isPointTableFields(fields: ComponentField[] | null | undefined): boolean;
+export declare function normalizeTableRows(value: unknown): TableRow[];
+export declare function decodeTableRowsForEditing(fields: ComponentField[] | null | undefined, value: unknown): TableRow[];
+export declare function encodeTableRowsForStorage(fields: ComponentField[] | null | undefined, value: unknown): TableRow[];
+export declare function getTableColumns(fields: ComponentField[] | null | undefined, rows?: TableRow[]): string[];
+export declare function getTableDetailFields(fields: ComponentField[] | null | undefined): ComponentField[];
+export declare function createEmptyTableRow(fields: ComponentField[] | null | undefined, columns?: string[]): TableRow;
+export declare function paginateTableRows<T>(rows: T[], page?: number, pageSize?: number): TablePage<T>;
+export declare function findDuplicateRowValues(rows: TableRow[], field?: string): Set<string>;
+export declare function getPointTableImportDecision(existingRows: TableRow[] | null | undefined, incomingRows: TableRow[] | null | undefined): PointTableImportDecision;
+export declare function generatePointRows(options: PointGenerationOptions): TableRow[];
+export declare function parseCsvTable(text: string): TableRow[];
+export declare function serializeCsvTable(rows: TableRow[], columns?: string[]): string;

package/dist/core/table-spreadsheet.d.ts

@@ -0,0 +1,3 @@
+import { type TableRow } from './table-protocol';
+export declare function parseExcelTable(data: ArrayBuffer | Uint8Array): Promise<TableRow[]>;
+export declare function serializeExcelTable(rows: TableRow[], columns?: string[]): Promise<Uint8Array>;

package/dist/core/test-cases.d.ts

@@ -0,0 +1,54 @@
+import { type EditorPersistenceAdapter, type EditorPersistenceNamespace } from './editor-dock';
+export interface EditorTestCasePayload {
+    msgType: string;
+    dataType?: string;
+    body: string;
+    metadata: string;
+    headers: string;
+    fromNodeId: string;
+    onlyThisNode: boolean;
+    waitResult: boolean;
+}
+export interface EditorTestCaseEntry {
+    name: string;
+    payload: EditorTestCasePayload;
+    updatedAt: number;
+}
+export interface EditorTestCasesPersistenceOptions {
+    adapter: EditorPersistenceAdapter;
+    namespace: EditorPersistenceNamespace;
+}
+export interface EditorTestCasesOptions {
+    persistence?: EditorTestCasesPersistenceOptions;
+    maxEntries?: number;
+    now?: () => number;
+}
+export interface EditorTestCasesResult {
+    ok: boolean;
+    persisted: boolean;
+    entries: EditorTestCaseEntry[];
+}
+export declare class EditorTestCasesStore {
+    private readonly adapter?;
+    private readonly storageKey;
+    private readonly persistenceIdentity;
+    private readonly maxEntries;
+    private readonly now;
+    private state;
+    private activeChainId;
+    private destroyed;
+    private readonly listeners;
+    constructor(options?: EditorTestCasesOptions);
+    setChainId(chainId: string): void;
+    getChainId(): string;
+    list(chainId?: string): EditorTestCaseEntry[];
+    save(name: string, payload: EditorTestCasePayload, chainId?: string): EditorTestCasesResult;
+    remove(name: string, chainId?: string): EditorTestCasesResult;
+    clear(chainId?: string): EditorTestCasesResult;
+    subscribe(listener: (entries: EditorTestCaseEntry[]) => void): () => void;
+    destroy(): void;
+    private removeAll;
+    private notify;
+    private readState;
+    private writeState;
+}

package/dist/core/toolbar-icons.d.ts

@@ -0,0 +1,4 @@
+export type EditorToolbarIconName = 'file-plus' | 'add' | 'edit' | 'copy' | 'cut' | 'paste' | 'package' | 'store' | 'save' | 'import' | 'export' | 'undo' | 'redo' | 'delete' | 'delete-reconnect' | 'disconnect' | 'play' | 'play-single' | 'select-all' | 'arrange' | 'link' | 'docs' | 'command' | 'grid' | 'reset-zoom' | 'zoom-in' | 'zoom-out' | 'fit' | 'auto-layout' | 'expand-all' | 'collapse-all' | 'validate' | 'search' | 'refresh' | 'stop' | 'key' | 'send' | 'error' | 'warning' | 'debug' | 'data' | 'bot' | 'terminal' | 'pin' | 'inbox' | 'map' | 'image' | 'format' | 'settings' | 'fullscreen' | 'fullscreen-exit';
+export declare function getEditorToolbarIconSvg(name: string): string | null;
+export declare function isEditorToolbarIconName(name: string): name is EditorToolbarIconName;
+export declare function renderEditorToolbarIcon(name: string): string;

package/dist/core/topology-rules.d.ts

@@ -0,0 +1,17 @@
+import type { LFGraphData } from './DataAdapter';
+import type { ComponentDefinition } from '../types/component';
+export interface DiagnosticItem {
+    id: string;
+    rule: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    elementId?: string;
+    elementType?: 'node' | 'edge' | 'chain';
+    blocking: boolean;
+    details?: Record<string, unknown>;
+}
+export interface TopologyContext {
+    nodeComponents?: Record<string, ComponentDefinition>;
+}
+export declare function validateTopology(graphData: LFGraphData, context?: TopologyContext): DiagnosticItem[];
+export declare function groupDiagnosticsByElement(items: DiagnosticItem[]): Map<string, DiagnosticItem[]>;

package/dist/core/virtual-window.d.ts

@@ -0,0 +1,20 @@
+export interface VirtualWindowOptions {
+    total: number;
+    itemHeight: number;
+    viewportHeight: number;
+    scrollTop?: number;
+    overscan?: number;
+}
+export interface VirtualWindow {
+    start: number;
+    end: number;
+    offsetTop: number;
+    totalHeight: number;
+    viewportHeight: number;
+    scrollTop: number;
+}
+export declare const DEFAULT_VIRTUAL_WINDOW_ITEM_HEIGHT = 38;
+export declare const DEFAULT_VIRTUAL_WINDOW_VIEWPORT_HEIGHT = 320;
+export declare const DEFAULT_VIRTUAL_WINDOW_OVERSCAN = 4;
+export declare const DEFAULT_VIRTUAL_WINDOW_THRESHOLD = 80;
+export declare function calculateVirtualWindow(options: VirtualWindowOptions): VirtualWindow;

package/dist/core/workspace-tab-actions.d.ts

@@ -0,0 +1,13 @@
+import type { EditorWorkspaceTab } from './EditorWorkspace';
+export type EditorWorkspaceTabAction = 'close' | 'close-others' | 'close-right' | 'rename' | 'toggle-pinned' | 'edit-info' | 'run-history' | 'debug' | 'toggle-disabled';
+export type EditorWorkspaceTabLifecycleState = 'undeployed' | 'stopped' | 'running';
+export interface EditorWorkspaceTabActionDescriptor {
+    id: EditorWorkspaceTabAction;
+    labelKey: string;
+    disabled: boolean;
+    dividerBefore?: boolean;
+}
+export declare function isWorkspaceTabDisabled(tab: EditorWorkspaceTab): boolean;
+export declare function isWorkspaceTabPinned(tab: EditorWorkspaceTab): boolean;
+export declare function getWorkspaceTabLifecycleState(tab: EditorWorkspaceTab): EditorWorkspaceTabLifecycleState;
+export declare function getEditorWorkspaceTabActions(tab: EditorWorkspaceTab): readonly EditorWorkspaceTabActionDescriptor[];

package/dist/defaults/components.d.ts

@@ -1,11 +1,2 @@
-/**
- * @file defaults/components.ts
- * @description 官方 RuleGo 默认组件定义。
- *
- * 该文件由参考项目 src/components/utils/default.js 机械同步，保持内置组件列表
- * 与官方默认节点协议一致。真实运行时仍优先使用 /api/v1/components 返回的后端组件定义。
- */
 import type { ComponentDefinition } from '../types/component';
-/** 官方默认内置组件列表: endpoints + nodes */
 export declare const defaultComponents: ComponentDefinition[];
-//# sourceMappingURL=components.d.ts.map

package/dist/defaults/index.d.ts

@@ -1,18 +1,3 @@
-/**
- * @file defaults/index.ts
- * @description 默认数据统一导出入口
- *
- * 导出项:
- * - defaultComponents: 内置组件定义列表
- * - localeZhCN: 中文语言包
- * - localeEnUS: 英文语言包
- *
- * 使用方式:
- * ```typescript
- * import { defaultComponents, localeZhCN, localeEnUS } from '@huanban/rulego-editor-core'
- * ```
- */
 export { defaultComponents } from './components';
 export { localeZhCN } from './locale-zh-CN';
 export { localeEnUS } from './locale-en-US';
-//# sourceMappingURL=index.d.ts.map

package/dist/defaults/locale-en-US.d.ts

@@ -1,26 +1,2 @@
-/**
- * @file defaults/locale-en-US.ts
- * @description 英文语言包 — 编辑器所有 UI 文本的英文翻译
- *
- * 与 locale-zh-CN.ts 结构完全对应, 提供英文版本。
- * 作为默认的 fallback 语言使用。
- *
- * 使用方式:
- * ```typescript
- * import { localeEnUS, I18nManager } from '@huanban/rulego-editor-core'
- *
- * const i18n = new I18nManager({ locale: 'en-US', fallback: 'en-US' })
- * i18n.register('en-US', localeEnUS)
- * ```
- *
- * @see locale-zh-CN.ts 中文对照版本
- * @see I18nManager 国际化管理器
- */
 import type { LocaleMessages } from '../core/I18nManager';
-/**
- * 英文语言包
- *
- * 结构与 localeZhCN 完全相同, 所有 key 一一对应
- */
 export declare const localeEnUS: LocaleMessages;
-//# sourceMappingURL=locale-en-US.d.ts.map

package/dist/defaults/locale-zh-CN.d.ts

@@ -1,41 +1,2 @@
-/**
- * @file defaults/locale-zh-CN.ts
- * @description 中文语言包 — 编辑器所有 UI 文本的中文翻译
- *
- * 移植自原版 local_zh.js, 并扩展了编辑器 UI 层所需的所有文本。
- * 原版仅包含组件名称和字段标签的映射, 这里增加了:
- * - 编辑器 UI 文本 (工具栏、侧边栏、对话框等)
- * - 验证消息
- * - 操作提示
- * - HuanbanRulegoEditor 弹窗/面板/状态栏文本
- *
- * 使用方式:
- * ```typescript
- * import { localeZhCN } from '@huanban/rulego-editor-core'
- * import { I18nManager } from '@huanban/rulego-editor-core'
- *
- * const i18n = new I18nManager({ locale: 'zh-CN' })
- * i18n.register('zh-CN', localeZhCN)
- *
- * // 使用翻译
- * i18n.t('editor.toolbar.save')  // => '保存'
- * i18n.t('components.jsFilter')  // => 'JS过滤器'
- * ```
- *
- * @see 原版: src/components/utils/local_zh.js
- * @see I18nManager 用于加载和查询翻译
- */
 import type { LocaleMessages } from '../core/I18nManager';
-/**
- * 中文语言包
- *
- * 结构说明:
- * - editor.*     : 编辑器 UI 层文本 (工具栏、侧边栏、对话框、面板、状态栏)
- * - components.* : 组件类型的中文名称 (type => 中文标签)
- * - fields.*     : 组件字段的中文标签 (fieldName => 中文标签)
- * - category.*   : 分类名称
- * - validation.* : 验证提示消息
- * - action.*     : 操作相关提示 (保存、删除、创建等)
- */
 export declare const localeZhCN: LocaleMessages;
-//# sourceMappingURL=locale-zh-CN.d.ts.map

package/dist/defaults/official-component-fallbacks.d.ts

@@ -1,12 +1,4 @@
-/**
- * Official component fallbacks that exist in the upstream locale/view protocol
- * but are not always returned by older /api/v1/components backends.
- *
- * These entries are appended only when a backend/default component list does not
- * already contain the type, so live backend definitions remain authoritative.
- */
 import type { ComponentDefinition } from '../types/component';
 export declare const OFFICIAL_COMPONENT_FALLBACK_TYPES: readonly ["endpoint/beanstalkdTubeset", "iterator", "ci/exec", "x/beanstalkdTube", "x/beanstalkdWorker", "ai/transform/documentLoader", "ai/transform/textChunker", "ai/embedding/openai", "ai/indexer/milvus", "ai/indexer/redis", "ai/retriever/milvus", "ai/retriever/redis"];
 export declare function createOfficialComponentFallback(type: string): ComponentDefinition | null;
 export declare function appendOfficialComponentFallbacks<T extends ComponentDefinition>(components: T[]): ComponentDefinition[];
-//# sourceMappingURL=official-component-fallbacks.d.ts.map

package/dist/extensions/ClipboardExtension.d.ts

@@ -1,28 +1,5 @@
-/**
- * @file ClipboardExtension.ts
- * @description 画布剪贴板拦截与 ID 净化增强
- */
-/**
- * 画布剪贴板扩展插件 (RuleGoClipboard)
- *
- * @class RuleGoClipboard
- * @description 拦截 LogicFlow 原生的复制粘贴行为。
- * 官方原生 LogicFlow 在复制时，直接使用内置的数据模型进行全量克隆。
- * 在我们的业务场景下，复制一个包含算子的 Group (编排子组) 时，其内部节点的 `groupId` 与新组的 ID 会发生断裂。
- * 该插件的职责是作为中间件，拦截粘贴流，并自动向所有被粘贴的节点派发新的唯一序列化 ID（基于 getNodeSeq）。
- */
 export declare class RuleGoClipboard {
-    /** 暴露给 LogicFlow 的插件识别名 */
     static pluginName: string;
-    /**
-     * 构造函数
-     * @param options 注入的上下文参数，包含 eventCenter 等
-     */
     constructor(_options: any);
-    /**
-     * 插件装载时的生命周期钩子
-     * @param lf LogicFlow 实例对象
-     */
     install(lf: any): void;
 }
-//# sourceMappingURL=ClipboardExtension.d.ts.map

package/dist/extensions/KeyboardExtension.d.ts

@@ -1,18 +1 @@
-/**
- * @file KeyboardExtension.ts
- * @description 全局快捷键注册机制
- */
-/**
- * 全局快捷键注册器
- *
- * @function registerKeyboard
- * @description 将原生的键盘按键事件转化为框架内的通用语义事件。
- * 由于我们在外部使用的是 Vue 或 React，不能直接依赖原生事件绑定。
- * 此注册器剥离了 LogicFlow 与浏览器的耦合，拦截常见快捷键。
- *
- * @param {any} lf - LogicFlow 实例对象，必须开启 keyboard 插件
- * @param {any} eventCenter - 全局事件总线，负责向外透传 ui 级别的交互事件
- * @returns {void} 无返回值
- */
 export declare const registerKeyboard: (lf: any, eventCenter: any) => void;
-//# sourceMappingURL=KeyboardExtension.d.ts.map

package/dist/extensions/MenuExtension.d.ts

@@ -1,29 +1,6 @@
-/**
- * @file MenuExtension.ts
- * @description 无头右键菜单 (Headless Context Menu) 抛出器
- */
-/**
- * 无头右键菜单扩展插件 (RuleGoMenu)
- *
- * @class RuleGoMenu
- * @description 传统基于 DOM 的插件在画布移动和缩放时，往往存在严重的错位和 DOM 节点堆积问题。
- * 本插件实施“无头化 (Headless)”策略：
- * 阻止默认事件发生，计算出画布内元素的精确屏幕绝对坐标 (e.clientX, e.clientY)，
- * 并携带目标业务数据 (node/edge) 向外层 UI 框架广播。
- */
 export declare class RuleGoMenu {
     private options;
-    /** 暴露给 LogicFlow 的插件识别名 */
     static pluginName: string;
-    /**
-     * 构造函数
-     * @param options 注入的上下文参数，包含 eventCenter 等
-     */
     constructor(options: any);
-    /**
-     * 插件装载时的生命周期钩子
-     * @param lf LogicFlow 实例对象
-     */
     install(lf: any): void;
 }
-//# sourceMappingURL=MenuExtension.d.ts.map

package/dist/iconRegistry.d.ts

@@ -1,17 +1,3 @@
-/**
- * 自动生成的图标注册表 — 使用紧凑 SVG 模板并按主题延迟生成 data URL
- * 来源: packages/editor-core/src/icons
- * 图标数量: 123
- * 主题数量: 13
- *
- * 用法: import { ICON_REGISTRY } from './iconRegistry'
- *       const url = ICON_REGISTRY['delay'] // => data:image/svg+xml,...
- */
-/**
- * 默认图标 — 用于缺少图标的新开发组件（白色问号 SVG）
- * 当组件没有注册图标或图标加载失败时，自动使用此图标替代
- * 注意: 使用预编码的 base64 字符串，避免运行时 btoa 对 Unicode 字符报错
- */
 export declare const DEFAULT_ICON_URL = "data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgMTAyNCAxMDI0IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyMDAiIGhlaWdodD0iMjAwIj48dGV4dCB4PSI1MTIiIHk9IjU2MCIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZG9taW5hbnQtYmFzZWxpbmU9ImNlbnRyYWwiIGZvbnQtZmFtaWx5PSJBcmlhbCxzYW5zLXNlcmlmIiBmb250LXdlaWdodD0iYm9sZCIgZm9udC1zaXplPSI0MDAiIGZpbGw9IiNmZmZmZmYiPj88L3RleHQ+PC9zdmc+";
 export declare const ICON_REGISTRY: Record<string, string>;
 export declare const ICON_THEME_NAMES: readonly ["default", "dark", "nature", "elegant", "tech", "modern", "colorful", "ant-blue", "material", "tailwind", "github", "vscode", "apple"];
@@ -19,12 +5,4 @@ export type IconThemeName = typeof ICON_THEME_NAMES[number];
 export declare const ICON_THEME_REGISTRY: Record<IconThemeName, Record<string, string>>;
 export declare function normalizeIconTheme(theme?: string | null): IconThemeName;
 export declare function getThemedIconUrl(name: string, theme?: string | null, fallbackPath?: string): string;
-/**
- * 根据图标名称获取图标 URL
- * @param name - 图标名称（不含 .svg 扩展名），如 'delay', 'action'
- * @param fallbackPath - 找不到时的降级路径，如 'images/delay.svg'
- * @param theme - 主题名称，如 default/dark/nature/elegant/tech/modern/colorful/ant-blue/material/tailwind/github/vscode/apple
- * @returns data URL 或降级路径
- */
 export declare function getIconUrl(name: string, fallbackPath?: string, theme?: string | null): string;
-//# sourceMappingURL=iconRegistry.d.ts.map