@huanban/rulego-editor-core 1.3.18 → 1.4.0

package/dist/core/ThemeManager.d.ts

@@ -1,175 +1,34 @@
-/**
- * @file core/ThemeManager.ts
- * @description 主题管理器 — 支持多主题动态切换
- *
- * 基于 CSS 自定义属性 (CSS Variables) 实现运行时主题切换,
- * 无需重新加载页面或重新编译样式。
- *
- * 核心设计:
- * - 所有样式值都通过 CSS 变量定义 (如 --rg-bg-primary)
- * - 切换主题 = 批量更新 CSS 变量值
- * - 支持自定义主题注册 (只需提供变量映射)
- * - 自动检测系统深色模式偏好
- *
- * 内置主题:
- * - light: 明亮主题 (默认) — 清爽专业
- * - dark: 暗色主题 — 护眼模式
- * - blue: 蓝色主题 — 科技感
- *
- * 使用方式:
- * ```typescript
- * import { ThemeManager } from '@huanban/rulego-editor-core'
- *
- * const theme = new ThemeManager()
- *
- * // 切换到暗色主题
- * theme.setTheme('dark')
- *
- * // 注册自定义主题
- * theme.register('ocean', {
- *   '--rg-bg-primary': '#0a192f',
- *   '--rg-text-primary': '#ccd6f6',
- *   // ...更多变量
- * })
- *
- * // 跟随系统主题
- * theme.followSystem()
- *
- * // 监听主题变更
- * theme.onChange((themeName) => {
- *   console.log('主题切换为:', themeName)
- * })
- * ```
- *
- * CSS 变量命名规范:
- * - --rg-bg-*    : 背景色
- * - --rg-text-*  : 文字色
- * - --rg-border-*: 边框色
- * - --rg-shadow-*: 阴影
- * - --rg-node-*  : 节点专用 (按分类)
- * - --rg-edge-*  : 连接线专用
- * - --rg-ui-*    : UI 组件 (按钮、面板等)
- *
- * @see styles/variables.css 完整的 CSS 变量列表
- */
-/**
- * 主题变量映射
- * key: CSS 变量名 (如 '--rg-bg-primary')
- * value: 对应的值 (如 '#ffffff')
- */
 export type ThemeVariables = Record<string, string>;
-/**
- * 主题定义
- */
 export interface ThemeDefinition {
-    /** 主题名称 */
     name: string;
-    /** 显示标签 */
     label: string;
-    /** 是否为暗色主题 (影响 data-theme 属性) */
     isDark: boolean;
-    /** CSS 变量映射 */
     variables: ThemeVariables;
 }
-/** 主题变更回调 */
 type ThemeChangeCallback = (themeName: string, isDark: boolean) => void;
-/**
- * 主题管理器
- *
- * 通过修改容器元素的 CSS 自定义属性实现主题切换。
- * 每套主题定义一组 CSS 变量值, 切换时批量更新。
- */
 export declare class ThemeManager {
-    /** 已注册的主题 */
     private themes;
-    /** 当前主题名 */
     private currentTheme;
-    /** CSS 变量挂载的目标元素 (默认: document.documentElement) */
     private targetElement;
-    /** 变更回调 */
     private changeCallbacks;
-    /** 系统主题监听器 */
     private systemThemeQuery;
-    /** 系统主题监听处理函数 */
     private systemThemeHandler;
     constructor();
-    /**
-     * 注册主题
-     *
-     * @param theme - 主题定义
-     * @param overwrite - 是否覆盖已有同名主题 (默认: true)
-     */
     register(theme: ThemeDefinition, overwrite?: boolean): void;
-    /**
-     * 切换主题
-     *
-     * @param name - 主题名称
-     * @param container - CSS 变量挂载的容器元素 (可选, 默认 document.documentElement)
-     */
     setTheme(name: string, container?: HTMLElement): void;
-    /**
-     * 获取当前主题名称
-     */
     getTheme(): string;
-    /**
-     * 获取当前主题定义
-     */
     getThemeDefinition(): ThemeDefinition | undefined;
-    /**
-     * 获取所有可用主题
-     */
     getAvailableThemes(): Array<{
         name: string;
         label: string;
         isDark: boolean;
     }>;
-    /**
-     * 跟随系统主题 (自动检测深色/浅色模式)
-     *
-     * - 系统为深色模式 → 使用 'dark' 主题
-     * - 系统为浅色模式 → 使用 'light' 主题
-     *
-     * @param darkTheme - 深色模式使用的主题名 (默认: 'dark')
-     * @param lightTheme - 浅色模式使用的主题名 (默认: 'light')
-     */
     followSystem(darkTheme?: string, lightTheme?: string): void;
-    /**
-     * 停止跟随系统主题
-     */
     unfollowSystem(): void;
-    /**
-     * 监听主题变更
-     *
-     * @param callback - 变更回调 (themeName, isDark)
-     * @returns 取消监听函数
-     */
     onChange(callback: ThemeChangeCallback): () => void;
-    /**
-     * 销毁主题管理器
-     */
     destroy(): void;
 }
-/**
- * 基础 CSS 变量列表 (所有主题共用的变量名)
- * 每套主题只需要覆盖这些变量的值
- */
-/**
- * 🌤 明亮主题 (默认)
- * 设计风格: 清爽、专业、高对比度
- * 适合: 日间使用、正式场合、打印
- */
 export declare const THEME_LIGHT: ThemeDefinition;
-/**
- * 🌙 暗色主题
- * 设计风格: 深邃、护眼、高级感
- * 适合: 夜间使用、长时间工作
- */
 export declare const THEME_DARK: ThemeDefinition;
-/**
- * 🔵 蓝色科技主题
- * 设计风格: 科技感、IoT 风格、专业
- * 适合: 物联网控制台、监控场景、技术演示
- */
 export declare const THEME_BLUE: ThemeDefinition;
 export {};
-//# sourceMappingURL=ThemeManager.d.ts.map

package/dist/core/ValidationEngine.d.ts

@@ -1,139 +1,36 @@
-/**
- * @file ValidationEngine.ts
- * @description 图验证引擎 — 验证规则链的合法性
- *
- * 提供可扩展的验证规则系统:
- * - 内置验证规则 (孤立节点检测、起始连接检查等)
- * - 自定义验证规则注册
- * - 保存前自动验证
- *
- * 验证结果包含错误列表，每个错误关联到具体的节点或边，
- * 方便 UI 层高亮显示问题元素。
- */
 import type { LFGraphData } from './DataAdapter';
-/**
- * 验证错误
- */
 export interface ValidationError {
-    /** 规则名称 */
     rule: string;
-    /** 错误级别 */
     level: 'error' | 'warning' | 'info';
-    /** 错误消息 */
     message: string;
-    /** 关联的元素 ID (节点或边) */
     elementId?: string;
-    /** 关联的元素类型 */
     elementType?: 'node' | 'edge';
 }
-/**
- * 验证结果
- */
 export interface ValidationResult {
-    /** 是否验证通过 (无 error 级别错误) */
     valid: boolean;
-    /** 错误列表 */
     errors: ValidationError[];
-    /** 警告列表 */
     warnings: ValidationError[];
 }
-/**
- * 验证规则接口
- */
 export interface ValidationRule {
-    /** 规则名称 (唯一标识) */
     name: string;
-    /** 规则描述 */
     description?: string;
-    /** 是否启用 (默认: true) */
     enabled?: boolean;
-    /**
-     * 验证函数
-     *
-     * @param graphData - LogicFlow 图数据
-     * @param context - 验证上下文 (包含内部配置)
-     * @returns 验证错误列表
-     */
     validate(graphData: LFGraphData, context: ValidationContext): ValidationError[];
 }
-/**
- * 验证上下文 (传递给验证规则的额外信息)
- */
 export interface ValidationContext {
-    /** 起始节点 ID */
     startNodeId: string;
 }
-/**
- * 图验证引擎
- *
- * @example
- * ```typescript
- * const engine = new ValidationEngine()
- *
- * // 使用内置规则
- * engine.registerBuiltinRules()
- *
- * // 添加自定义规则
- * engine.register({
- *   name: 'max-nodes',
- *   validate(data) {
- *     if (data.nodes.length > 100) {
- *       return [{ rule: 'max-nodes', level: 'warning', message: '节点数超过100' }]
- *     }
- *     return []
- *   }
- * })
- *
- * // 执行验证
- * const result = engine.validate(graphData, { startNodeId: '$node_start_input' })
- * if (!result.valid) {
- *   console.error('验证失败:', result.errors)
- * }
- * ```
- */
 export declare class ValidationEngine {
-    /** 已注册的验证规则 */
     private rules;
-    /**
-     * 注册验证规则
-     *
-     * @param rule - 验证规则
-     * @param overwrite - 是否覆盖同名规则 (默认: true)
-     */
     register(rule: ValidationRule, overwrite?: boolean): void;
-    /**
-     * 注销验证规则
-     *
-     * @param name - 规则名称
-     */
     unregister(name: string): void;
-    /**
-     * 启用/禁用指定规则
-     */
     setEnabled(name: string, enabled: boolean): void;
-    /**
-     * 注册所有内置验证规则
-     */
     registerBuiltinRules(): void;
-    /**
-     * 执行验证
-     *
-     * @param graphData - LogicFlow 图数据
-     * @param context - 验证上下文
-     * @returns 验证结果
-     */
     validate(graphData: LFGraphData, context: ValidationContext): ValidationResult;
-    /**
-     * 获取所有已注册规则的信息
-     */
     getRules(): Array<{
         name: string;
         description?: string;
         enabled: boolean;
     }>;
-    /**
-     * 清空所有规则
-     */
     clear(): void;
 }
-//# sourceMappingURL=ValidationEngine.d.ts.map

package/dist/core/component-palette.d.ts

@@ -0,0 +1,20 @@
+import type { ComponentDefinition, ComponentGroup } from '../types/component';
+export declare const DEFAULT_COMPONENT_CATEGORY_ORDER: readonly string[];
+export interface ComponentPaletteSubgroup {
+    id: string;
+    label: string;
+    description?: string;
+    order?: number;
+    components: ComponentDefinition[];
+}
+export interface ComponentPaletteGroup extends ComponentGroup {
+    subgroups: ComponentPaletteSubgroup[];
+}
+export interface ComponentPaletteBuildOptions {
+    categoryOrder?: readonly string[];
+    categoryLabel?: (category: string, components: ComponentDefinition[]) => string | undefined;
+    subgroupLabel?: (category: string, subgroup: string, components: ComponentDefinition[]) => string | undefined;
+    componentSearchText?: (component: ComponentDefinition) => string | string[] | undefined;
+}
+export declare function normalizeComponentCategory(component: ComponentDefinition): ComponentDefinition;
+export declare function buildComponentPalette(components: ComponentDefinition[], query?: string, options?: ComponentPaletteBuildOptions): ComponentPaletteGroup[];

package/dist/core/component-payload.d.ts

@@ -1,12 +1,3 @@
 import type { ComponentDefinition } from '../types/component';
-/**
- * Normalize common RuleGo /api/v1/components payload wrappers without losing
- * builtin metadata such as builtins and skillPath.
- */
 export declare function normalizeComponentsRawPayload(data: unknown): unknown;
-/**
- * Flatten official segmented component payloads into the component list used by
- * the registry and sidebar. Legacy arrays are returned unchanged.
- */
 export declare function normalizeComponentsPayload(data: unknown): ComponentDefinition[];
-//# sourceMappingURL=component-payload.d.ts.map

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

@@ -0,0 +1,77 @@
+export type NodeConnectionState = 'none' | 'connected' | 'reconnecting' | 'disconnected' | 'error' | 'unknown';
+export interface NodeConnectionStatus {
+    status: NodeConnectionState;
+    message?: string;
+}
+export type ConnectionStatusMap = Readonly<Record<string, Readonly<NodeConnectionStatus>>>;
+export type ConnectionStatusPhase = 'idle' | 'loading' | 'ready' | 'stale' | 'unsupported' | 'unauthorized' | 'error';
+export interface ConnectionStatusState extends Record<string, unknown> {
+    chainId: string | null;
+    nodes: ConnectionStatusMap;
+    shared: ConnectionStatusMap;
+    chainPhase: ConnectionStatusPhase;
+    sharedPhase: ConnectionStatusPhase;
+    chainUpdatedAt: number | null;
+    sharedUpdatedAt: number | null;
+    chainError?: string;
+    sharedError?: string;
+}
+export interface ConnectionStatusProvider {
+    getChainStatuses(chainId: string, signal?: AbortSignal): Promise<unknown>;
+    getSharedNodeStatuses(signal?: AbortSignal): Promise<unknown>;
+}
+export interface ConnectionStatusControllerOptions {
+    enabled?: boolean;
+    pollIntervalMs?: number;
+    now?: () => number;
+}
+export type ConnectionStatusSemanticKind = 'success' | 'warning' | 'danger' | 'neutral';
+export interface ConnectionStatusView {
+    visible: boolean;
+    state: NodeConnectionState;
+    label: string;
+    tooltip: string;
+    kind: ConnectionStatusSemanticKind;
+    stale: boolean;
+}
+export type ConnectionStatusTranslator = (key: string, fallback: string) => string;
+export declare function normalizeConnectionStatusMap(raw: unknown): ConnectionStatusMap;
+export declare class ConnectionStatusStore {
+    private readonly store;
+    private destroyed;
+    getState(): Readonly<ConnectionStatusState>;
+    subscribe(listener: (state: Readonly<ConnectionStatusState>, previous: Readonly<ConnectionStatusState>) => void): () => void;
+    update(patch: Partial<ConnectionStatusState>): void;
+    reset(): void;
+    destroy(): void;
+}
+export declare class ConnectionStatusController {
+    private readonly store;
+    private readonly provider;
+    private readonly pollIntervalMs;
+    private readonly now;
+    private enabled;
+    private chainTimer;
+    private sharedTimer;
+    private chainRequest;
+    private sharedRequest;
+    private chainGeneration;
+    private sharedGeneration;
+    private sharedConsumers;
+    private destroyed;
+    constructor(store: ConnectionStatusStore, provider: ConnectionStatusProvider, options?: ConnectionStatusControllerOptions);
+    setEnabled(enabled: boolean): void;
+    setChain(chainId: string | null | undefined): void;
+    restartCurrentChain(): void;
+    restartShared(): void;
+    acquireShared(): () => void;
+    releaseShared(): void;
+    private pollChain;
+    private pollShared;
+    private isCurrentChain;
+    private isCurrentShared;
+    private stopChainRequest;
+    private stopSharedRequest;
+    destroy(): void;
+}
+export declare function resolveConnectionStatusView(info: NodeConnectionStatus | undefined, stale?: boolean, translate?: ConnectionStatusTranslator): ConnectionStatusView | null;

package/dist/core/context-menu-position.d.ts

@@ -0,0 +1,27 @@
+export interface ContextMenuViewport {
+    width: number;
+    height: number;
+}
+export interface ContextMenuRect {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+export interface ContextMenuSize {
+    width: number;
+    height: number;
+}
+export interface ContextMenuPosition {
+    left: number;
+    top: number;
+    placement: 'left' | 'right';
+}
+export declare function resolveContextSubmenuPosition(parent: ContextMenuRect, menu: ContextMenuSize, viewport: ContextMenuViewport, gap?: number, viewportPadding?: number): ContextMenuPosition;
+export declare function clampContextMenuPosition(point: {
+    left: number;
+    top: number;
+}, menu: ContextMenuSize, viewport: ContextMenuViewport, viewportPadding?: number): {
+    left: number;
+    top: number;
+};

package/dist/core/cron-schedule.d.ts

@@ -0,0 +1,85 @@
+export type RuleGoCronPreset = {
+    kind: 'everySeconds';
+    seconds: number;
+} | {
+    kind: 'everyMinutes';
+    minutes: number;
+} | {
+    kind: 'everyHour';
+    minute: number;
+} | {
+    kind: 'daily';
+    time: string;
+} | {
+    kind: 'weekdays';
+    time: string;
+} | {
+    kind: 'weekly';
+    days: number[];
+    time: string;
+} | {
+    kind: 'monthly';
+    day: number;
+    time: string;
+} | {
+    kind: 'yearly';
+    month: number;
+    day: number;
+    time: string;
+} | {
+    kind: 'custom';
+    expression: string;
+};
+export type RuleGoCronErrorCode = 'empty' | 'field-count' | 'unsupported-token' | 'invalid-expression' | 'invalid-preset' | 'invalid-count' | 'invalid-timezone';
+export interface RuleGoCronError {
+    code: RuleGoCronErrorCode;
+    message: string;
+}
+export type RuleGoCronValidationResult = {
+    ok: true;
+    raw: string;
+    expression: string;
+    normalizedFromDescriptor: boolean;
+} | {
+    ok: false;
+    raw: string;
+    error: RuleGoCronError;
+};
+export type RuleGoCronBuildResult = {
+    ok: true;
+    expression: string;
+} | {
+    ok: false;
+    error: RuleGoCronError;
+};
+export type RuleGoCronPresetParseResult = {
+    ok: true;
+    expression: string;
+    preset: RuleGoCronPreset;
+} | {
+    ok: false;
+    raw: string;
+    error: RuleGoCronError;
+};
+export interface RuleGoCronNextRunsOptions {
+    from?: Date | string;
+    count?: number;
+    timeZone?: string;
+}
+export type RuleGoCronNextRunsResult = {
+    ok: true;
+    expression: string;
+    runs: Date[];
+    timeZone: string;
+} | {
+    ok: false;
+    raw: string;
+    runs: [];
+    timeZone: string;
+    error: RuleGoCronError;
+};
+export declare function validateRuleGoCron(raw: unknown): RuleGoCronValidationResult;
+export declare function normalizeRuleGoCron(raw: unknown): RuleGoCronValidationResult;
+export declare function cronPresetToRuleGoCron(preset: RuleGoCronPreset): RuleGoCronBuildResult;
+export declare function ruleGoCronToPreset(raw: unknown): RuleGoCronPresetParseResult;
+export declare function nextRuleGoCronRuns(raw: unknown, options?: RuleGoCronNextRunsOptions): RuleGoCronNextRunsResult;

package/dist/core/debug-panel.d.ts

@@ -0,0 +1,6 @@
+export interface DebugPanelRequestSnapshot {
+    chainId: string;
+    requestId: number;
+}
+export declare function createDebugPanelRequestSnapshot(chainId: string, requestId: number): DebugPanelRequestSnapshot;
+export declare function isDebugPanelRequestCurrent(snapshot: DebugPanelRequestSnapshot, chainId: string, requestId: number): boolean;

package/dist/core/editor-capabilities.d.ts

@@ -0,0 +1,95 @@
+export type EditorMode = 'standalone' | 'app' | 'embedded' | 'readonly';
+export interface EditorUiCapabilities {
+    toolbar: boolean;
+    sidebar: boolean;
+    minimap: boolean;
+    commandPalette: boolean;
+    contextMenu: boolean;
+    header: boolean;
+    statusBar: boolean;
+    chat: boolean;
+    tour: boolean;
+    nodeActions: boolean;
+    nodeRunFrom: boolean;
+    runFromDock: boolean;
+    legacyNodeDrawer: boolean;
+    info: boolean;
+    debugConsole: boolean;
+    clearDebugHighlight: boolean;
+    selection: boolean;
+    diagnostics: boolean;
+    settings: boolean;
+    importExport: boolean;
+    run: boolean;
+    componentManage: boolean;
+    deploy: boolean;
+    restart: boolean;
+    reload: boolean;
+    runHistory: boolean;
+    trace: boolean;
+}
+export interface EditorCapabilities {
+    mode: EditorMode;
+    ui: EditorUiCapabilities;
+    editor: {
+        readOnly: boolean;
+    };
+    features: {
+        hostOwnsChainOpen: boolean;
+    };
+    persistence: {
+        saveToServer: boolean;
+        syncUrlHash: boolean;
+        warnOnUnload: boolean;
+    };
+    workspace: {
+        topBar: boolean;
+        explorer: boolean;
+        palette: boolean;
+        sharedNodes: boolean;
+        information: boolean;
+        nodeConfigPanel: boolean;
+        problems: boolean;
+        runDebug: boolean;
+        dock: boolean;
+        tabs: boolean;
+        globalSearch: boolean;
+        chainSwitcher: boolean;
+        drafts: boolean;
+        conflictDetection: boolean;
+        sessionRestore: boolean;
+        admin: boolean;
+    };
+}
+export type EditorCapabilitiesOverride = DeepPartial<EditorCapabilities>;
+export interface EditorCapabilityInput {
+    mode?: EditorMode;
+    capabilities?: EditorCapabilitiesOverride;
+    disabled?: boolean;
+    showToolbar?: boolean;
+    showSidebar?: boolean;
+    showInfoButton?: boolean;
+    showAiChatButton?: boolean;
+    showDebugConsoleButton?: boolean;
+    showClearDebugHighlightButton?: boolean;
+    showSelectionButton?: boolean;
+    showDiagnosticsButton?: boolean;
+    showSettingsButton?: boolean;
+    showExportDialog?: boolean;
+    showRunButton?: boolean;
+    showComponentManage?: boolean;
+    showDeployButton?: boolean;
+    showRestartButton?: boolean;
+    showReloadButton?: boolean;
+    showRunHistory?: boolean;
+    showTraceButton?: boolean;
+    options?: EditorCapabilityInput;
+}
+type DeepPartial<T> = T extends (...args: never[]) => unknown ? T : T extends readonly (infer U)[] ? ReadonlyArray<DeepPartial<U>> : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export declare function resolveEditorCapabilities(input?: EditorCapabilityInput): EditorCapabilities;
+export declare const CAPABILITY_BASE: Readonly<EditorCapabilities>;
+export declare const CAPABILITY_PROFILES: Readonly<Record<EditorMode, EditorCapabilitiesOverride>>;
+export declare const resolveCapabilities: typeof resolveEditorCapabilities;
+export {};