@huanban/rulego-editor-core 1.3.18 → 1.4.0

package/dist/standalone/json-diff.d.ts

@@ -42,4 +42,3 @@ export declare function createUnifiedJsonDiff(beforeJson: string, afterJson: str
 };
 export declare function createJsonDiffResult(beforeRaw: unknown, afterRaw: unknown): JsonDiffResult;
 export declare function validateRuleChainJsonIntegrity(data: unknown): RuleChainJsonValidationResult;
-//# sourceMappingURL=json-diff.d.ts.map

package/dist/standalone/keyboard-events.d.ts

@@ -1,3 +1,2 @@
 export declare function isEditableShortcutTarget(target: EventTarget | null): boolean;
 export declare function isCodeEditorOwnedShortcut(event: KeyboardEvent): boolean;
-//# sourceMappingURL=keyboard-events.d.ts.map

package/dist/standalone/layout-scheduler.d.ts

@@ -5,12 +5,6 @@ export interface ScheduleEditorResizeOptions {
     delayMs?: number;
     args?: any[];
 }
-/**
- * Coalesces LogicFlow resize calls into one animation-frame pass plus an optional
- * delayed pass for CSS transitions. This prevents drawer/settings toggles from
- * issuing several resize calls in the same layout frame.
- */
 export declare function scheduleEditorResize(target: ResizeTarget | null | undefined, options?: ScheduleEditorResizeOptions): void;
 export declare function cancelScheduledEditorResize(target: ResizeTarget | null | undefined): void;
 export {};
-//# sourceMappingURL=layout-scheduler.d.ts.map

package/dist/standalone/lifecycle.d.ts

@@ -1,7 +1,3 @@
-/**
- * @file standalone/lifecycle.ts
- * @description Small cleanup registry for standalone DOM and runtime resources.
- */
 export type Cleanup = () => void;
 export declare class CleanupBag {
     private cleanups;
@@ -12,4 +8,3 @@ export declare class CleanupBag {
     frame(id: number | null | undefined): void;
     dispose(): void;
 }
-//# sourceMappingURL=lifecycle.d.ts.map

package/dist/standalone/logger.d.ts

@@ -1,35 +1,3 @@
-/**
- * logger.ts
- * =========
- * 功能：编辑器统一调试日志工具
- *
- * 提供带模块前缀的日志输出，通过全局开关控制是否输出。
- * 默认关闭，可通过以下方式开启：
- * 1. 编辑器初始化时设置 opts.debug = true
- * 2. 运行时调用 setDebug(true)
- * 3. URL 参数 ?debug=1
- * 4. localStorage 设置 huanban_debug = '1'
- */
-/**
- * 设置调试模式开关
- * @param enabled - true 开启调试日志, false 关闭
- */
 export declare function setDebug(enabled: boolean): void;
-/**
- * 获取当前调试模式状态
- * @returns 是否开启调试日志
- */
 export declare function isDebug(): boolean;
-/**
- * 输出调试日志 — 仅在 debug 模式下输出
- * @param module - 模块名称，会作为前缀 [module]
- * @param args - 日志内容（与 console.log 参数一致）
- *
- * @example
- * ```ts
- * debugLog('custom-nodes', 'simple-node 注册成功')
- * // 输出: [custom-nodes] simple-node 注册成功
- * ```
- */
 export declare function debugLog(module: string, ...args: any[]): void;
-//# sourceMappingURL=logger.d.ts.map

package/dist/standalone/models-dev-catalog.d.ts

@@ -51,4 +51,3 @@ export declare function loadModelsDevProviderCatalog(options?: {
     maxAgeMs?: number;
 }): Promise<ModelsDevLoadResult>;
 export declare function clearModelsDevCatalogMemoryForTest(): void;
-//# sourceMappingURL=models-dev-catalog.d.ts.map

package/dist/standalone/node-copy.d.ts

@@ -1,6 +1,3 @@
-/**
- * Utilities for cloning LogicFlow nodes while keeping RuleGo model identity valid.
- */
 export interface CloneNodePropertiesOptions {
     nodeId?: string;
     nodeType?: string;
@@ -10,6 +7,12 @@ export interface CloneNodePropertiesOptions {
     parentGroupId?: string | null;
     preserveParentGroupId?: boolean;
 }
+export declare const CONNECTION_STATUS_RUNTIME_PROPERTY_KEYS: readonly ["connectionState", "connectionMessage", "connectionStale", "connectionLabel", "connectionTooltip", "connectionKind"];
+export declare const NODE_THEME_RUNTIME_PROPERTY_KEY: "__huanbanTheme";
+export declare const NODE_RUNTIME_PROPERTY_KEYS: readonly ["connectionState", "connectionMessage", "connectionStale", "connectionLabel", "connectionTooltip", "connectionKind", "__huanbanTheme"];
+export declare function stripNodeRuntimeProperties<T extends {
+    properties?: Record<string, any>;
+}>(data: T): T;
+export declare const stripConnectionStatusRuntimeProperties: typeof stripNodeRuntimeProperties;
 export declare function cloneNodePropertiesForCopy(sourceProperties: Record<string, any> | undefined, options?: CloneNodePropertiesOptions): Record<string, any>;
 export declare function applyNewNodeModelIdentity(lf: any, newNode: any, options?: CloneNodePropertiesOptions): void;
-//# sourceMappingURL=node-copy.d.ts.map

package/dist/standalone/node-definitions.d.ts

@@ -1,23 +1,3 @@
-/**
- * @file standalone/node-definitions.ts
- * @description 节点组件的分类配置 + 国际化适配器
- *
- * 【架构说明】
- * - 分类配置 (CATEGORY_CONFIG) — 定义各分类的背景色，用于侧边栏渲染
- * - 分类排序 (CATEGORY_ORDER) — 定义分类在侧边栏 / 管理列表中的显示顺序
- * - 分类路径映射 (CATEGORY_PATH_MAP) — 将 github.com/... 长路径映射到简短分类键
- * - 分类工具函数 (getCategoryKey / getCategoryConfig) — 提取和获取分类信息
- * - 国际化适配器 (adapterComponentsLocal) — 将 fallback 翻译应用到组件上
- *
- * 组件的本地化数据 (DEFAULT_NODE_VIEWS) 已拆分到 node-views-data.ts:
- * - 这些数据是**备用默认值**（源自原版 local_zh.js）
- * - 生产环境中，组件定义应由后端 API 动态返回
- * - 仅在 API 数据缺少 label/desc 时作为 fallback
- *
- * 使用方式:
- *   import { CATEGORY_CONFIG, getCategoryKey, getCategoryConfig, adapterComponentsLocal } from './node-definitions'
- *   import { DEFAULT_NODE_VIEWS } from './node-views-data'  // 需要数据时直接引入
- */
 import { type AiProviderOption } from './ai-providers';
 export { DEFAULT_NODE_VIEWS } from './node-views-data';
 interface CategoryConfig {
@@ -25,39 +5,11 @@ interface CategoryConfig {
     label?: string;
     nodeType?: string;
 }
-/** 分类颜色映射（label 通过 i18n 动态获取） */
 export declare const CATEGORY_CONFIG: Record<string, CategoryConfig>;
-/**
- * 分类在侧边栏 / 管理列表中的显示顺序
- * 不在此列表中的分类会排到末尾（按字母序）
- *
- * 顺序: 输入端 → 公共 → 过滤器 → 转换器 → 动作
- *       → 外部集成 → AI → CI/CD → IoT → 子规则链
- *       → 流式计算 → 文件 → 自定义
- */
 export declare const CATEGORY_ORDER: ReadonlyArray<string>;
-/**
- * 长路径分类映射 — 将 github.com/... 等长路径映射到简短分类名
- * 用于 getCategoryKey() 函数提取分类键
- */
 export declare const CATEGORY_PATH_MAP: Record<string, string>;
-/**
- * 从原始 category 字符串提取分类键
- * - 普通分类: 'external/file' → 'external'
- * - 长路径:   'github.com/rulego/rulego-components-ai/ai/action' → 'ai'
- * - stats:    'stats/streamsql' → 'stats'
- * - endpoint: 'endpoint/fasthttp' → 'endpoint'
- *
- * @param rawCat - 原始分类字符串
- * @returns 标准化的分类键
- */
 export declare function getCategoryKey(rawCat: string): string;
 export declare function resolveRuntimeCategoryKey(component: any, isEndpoint?: boolean): string;
-/**
- * 获取分类配置 (未知分类用默认色 #86B4E5FF)
- * @param cat - 分类键
- * @returns 分类配置对象 { bg: 颜色 }
- */
 export declare function getCategoryConfig(cat: string): CategoryConfig;
 export declare function adapterRelationTypeLabel(relationTypes: any, translate?: (value: string) => string): any;
 export declare function adapterEndpointDefaults(component: any, isEndpoint?: boolean): void;
@@ -71,22 +23,7 @@ export interface RuntimeComponentAdapterOptions {
     defaultBackground?: string;
 }
 export declare function adapterRuntimeComponent(component: any, options?: RuntimeComponentAdapterOptions): string;
-/**
- * 组件国际化适配器
- * 将 fallback 翻译数据应用到组件对象上。
- *
- * 工作流程:
- * 1. 后端 API 返回组件数据（包含 type、fields 等）
- * 2. 本函数检查 DEFAULT_NODE_VIEWS 中是否有对应类型的翻译
- * 3. 如有，则覆盖组件的 label、desc、icon
- * 4. 同时递归处理字段级别的翻译（fields 和嵌套 struct 子字段）
- *
- * @param component - 从 API 获取的组件数据
- * @param customViews - 可选，外部传入的自定义本地化定义，优先于默认值
- *                      调用方可传入自己的翻译字典来覆盖内置默认值
- */
 export declare function adapterComponentsLocal(component: any, customViews?: Record<string, any>, translateRelationType?: (value: string) => string): void;
 export declare function injectProviderField(component: any, providers?: AiProviderOption[]): void;
 export declare function adapterBuiltins(component: any, builtins: any, categoryName?: string): void;
 export declare function adapterRules(component: any): void;
-//# sourceMappingURL=node-definitions.d.ts.map

package/dist/standalone/node-identity.d.ts

@@ -7,4 +7,3 @@ export interface NormalizeEditableNodeModelOptions {
     keepNodeId?: boolean;
 }
 export declare function normalizeEditableNodeModel<T extends Record<string, any>>(originalModel: T | null | undefined, submittedPatch: Record<string, any>, options?: NormalizeEditableNodeModelOptions): T;
-//# sourceMappingURL=node-identity.d.ts.map

package/dist/standalone/node-theme.d.ts

@@ -0,0 +1,8 @@
+export interface LogicFlowNodeTheme {
+    id: string;
+    isDark: boolean;
+}
+export declare function deriveDarkNodeBackground(color: string): string;
+export declare function resolveLogicFlowNodeTheme(lf: any): LogicFlowNodeTheme;
+export declare function resolveLogicFlowNodeBackground(lf: any, color: string): string;
+export declare function refreshLogicFlowNodeTheme(lf: any, themeName: string): void;

package/dist/standalone/node-views-data.d.ts

@@ -1,21 +1 @@
-/**
- * @file standalone/node-views-data.ts
- * @description 节点组件本地化默认值 — 纯数据字典
- *
- * 【重要说明】
- * 这些数据是**备用默认值**，主要用于：
- * 1. API 未返回组件 label/desc 时的 fallback 显示
- * 2. 离线模式下的基本功能支持
- * 3. 开发调试时的快速预览
- *
- * 生产环境中，组件定义应由后端 API 动态返回，
- * 编辑器会优先使用 API 数据，仅在缺失时回退到本文件中的定义。
- *
- * 按分类拆分为多个子对象，最终合并导出为 DEFAULT_NODE_VIEWS。
- */
-/**
- * 组件本地化默认值 — 合并所有分类的数据
- * 按分类拆分后通过展开运算符合并
- */
 export declare const DEFAULT_NODE_VIEWS: Record<string, any>;
-//# sourceMappingURL=node-views-data.d.ts.map

package/dist/standalone/official-node-view-patches.d.ts

@@ -1,15 +1,2 @@
-/**
- * @file official-node-view-patches.ts
- * @description 官方 RuleGo editor zh i18n 节点渲染协议补丁。
- *
- * 生成来源:
- * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/index.js
- * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/endpoint.js
- * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/extend.js
- * - 参考项目代码/rulego-editor-20260627/src/components/i18n/zh/ai.js
- *
- * 注意: 原官方 loadData 函数被归一化为 component.source，用于 standalone 渲染器
- * 在运行时从当前画布或规则链列表补齐 options。
- */
+export declare const IOT_PROTOCOL_VIEW_TYPES: readonly ["endpoint/hj212", "endpoint/modbusServer", "endpoint/snmp", "ws", "x/control/timer", "x/control/watchdog", "x/dlt645Read", "x/dlt645Write", "x/eipRead", "x/eipWrite", "x/iec104Read", "x/iec104Write", "x/influxdbQuery", "x/influxdbWrite", "x/iotRead", "x/iotWrite", "x/mcRead", "x/mcWrite", "x/modbusRead", "x/modbusWrite", "x/promremoteWrite", "x/s7Read", "x/s7Write", "x/snmpRead", "x/snmpWrite", "x/tdengineQuery", "x/tdengineWrite", "x/timescaledbQuery", "x/timescaledbWrite", "x/tsdbQuery", "x/tsdbWrite"];
 export declare const OFFICIAL_NODE_VIEW_PATCHES: Record<string, any>;
-//# sourceMappingURL=official-node-view-patches.d.ts.map

package/dist/standalone/outline-style.d.ts

@@ -0,0 +1,7 @@
+export type OutlineStyle = Record<string, unknown> & {
+    stroke?: string;
+    hover?: Record<string, unknown> & {
+        stroke?: string;
+    };
+};
+export declare function withTransparentOutline(style: OutlineStyle | null | undefined): OutlineStyle;

package/dist/standalone/run-history-format.d.ts

@@ -19,4 +19,3 @@ export declare function formatRunHistoryMessageForDetail(msg: any): string;
 export declare function formatRunHistoryMessageJsonFull(msg: any): string;
 export declare function formatRunHistoryRecordJson(item: RunHistoryRecord, maxChars?: 20000): string;
 export declare function formatRunHistoryRecordJsonFull(item: RunHistoryRecord): string;
-//# sourceMappingURL=run-history-format.d.ts.map

package/dist/standalone/security-utils.d.ts

@@ -1,7 +1,3 @@
-/**
- * @file standalone/security-utils.ts
- * @description Browser-side safety helpers for text, URLs, bounded JSON, and redaction.
- */
 export type RichHtmlPolicy = {
     allowRichDescription?: boolean;
     allowedLinkOrigins?: string[];
@@ -41,7 +37,7 @@ export declare function safeImageUrl(value: unknown, opts?: {
 export declare function safeCssColor(value: unknown, fallback?: string): string;
 export declare function sanitizeDescription(value: unknown, policy?: RichHtmlPolicy): string;
 export declare function sanitizeRichHtml(value: unknown, policy?: RichHtmlPolicy): string;
+export declare function sanitizeHtmlPreviewDocument(value: unknown): string;
 export declare function redactSensitive<T>(value: T, opts?: RedactOptions): T;
 export declare function formatJsonBounded(value: unknown, opts?: FormatJsonBoundedOptions): string;
 export declare function parseJsonBounded<T = unknown>(raw: string, opts?: ParseJsonBoundedOptions): T;
-//# sourceMappingURL=security-utils.d.ts.map

package/dist/standalone/shared-node-manager.d.ts

@@ -0,0 +1,31 @@
+import { type ConnectionStatusStore } from '../core/connection-status';
+export interface SharedNodeManagerContext {
+    opts: {
+        apiBase?: string;
+        fetchTimeout?: number;
+        fetchHeaders?: Record<string, string> | (() => Record<string, string>);
+        customFetch?: (url: string, init?: RequestInit) => Promise<Response>;
+        onApiAuthRequired?: (details: {
+            status: 401 | 403;
+            url: string;
+        }) => void;
+    };
+    components?: unknown[];
+    _nodeComponents?: Record<string, unknown>;
+    connectionStatus?: Pick<ConnectionStatusStore, 'getState' | 'subscribe'>;
+    serverStatus?: import('../core/server-status').ServerStatusStore;
+    t(key: string, params?: Record<string, string>): string;
+    acquireSharedConnectionStatuses?(): () => void;
+    reloadComponents?(options?: {
+        forceRefresh?: boolean;
+    }): Promise<boolean>;
+    _activeDrawerWrapper?: HTMLElement | null;
+}
+export interface SharedNodeManager {
+    activate(): void;
+    deactivate(): void;
+    destroy(): void;
+    isDirty(): boolean;
+    requestClose(): Promise<boolean>;
+}
+export declare function createSharedNodeManager(ctx: SharedNodeManagerContext, root: HTMLElement): SharedNodeManager;

package/dist/standalone/themes.d.ts

@@ -1,60 +1,12 @@
-/**
- * @file standalone/themes.ts
- * @description 编辑器主题定义 — 通过 CSS 自定义属性实现多风格切换
- *
- * 每个主题定义一组 CSS 变量值，覆盖编辑器的颜色、圆角、阴影等视觉属性。
- * 通过在根元素上设置 data-theme="xxx" 来切换主题。
- *
- * 支持的主题：
- * - default: 默认亮色（经典蓝白）
- * - dark: 暗夜模式（深色背景，高对比度）
- * - nature: 自然绿（温暖舒适）
- * - elegant: 优雅紫（精致优雅）
- * - tech: 科技蓝（未来感）
- * - modern/colorful/ant-blue/material/tailwind/github/vscode/apple: 常用产品化配色风格
- *
- * @example
- * ```ts
- * import { THEME_PRESETS, getThemeCSS } from './themes'
- *
- * // 获取所有主题的 CSS 变量定义
- * const css = getThemeCSS()
- * ```
- */
-/** 单个主题的变量定义 */
 export interface ThemeVars {
-    /** 主题显示名称（中文） */
     label: string;
-    /** 主题显示名称（英文） */
     labelEn: string;
-    /** CSS 自定义属性键值对 */
     vars: Record<string, string>;
 }
-/**
- * 预设主题集合
- * key 为主题标识，对应 data-theme 属性值
- */
 export declare const THEME_PRESETS: Record<string, ThemeVars>;
-/**
- * 规范化编辑器主题标识。
- * 保留历史集成里常见的 light、blue 写法，同时避免无效主题写入 data-theme。
- */
 export declare function normalizeEditorTheme(theme?: string | null): string;
-/**
- * 生成所有主题的 CSS 变量定义字符串
- * 使用 [data-theme="xxx"] 选择器区分不同主题
- * 默认主题同时作为 :root 级别的 fallback
- *
- * @returns 完整的 CSS 变量定义文本
- */
 export declare function getThemeCSS(): string;
-/**
- * 获取主题列表（用于 UI 展示）
- * @param locale 当前语言
- * @returns 主题选项数组
- */
 export declare function getThemeList(locale: string): Array<{
     id: string;
     label: string;
 }>;
-//# sourceMappingURL=themes.d.ts.map

package/dist/tools/tool-editor.d.ts

@@ -46,4 +46,3 @@ export declare function normalizeBuiltinToolOption(item: unknown): BuiltinToolOp
 export declare function extractBuiltinToolOptionsFromPayload(payload: unknown): BuiltinToolOption[];
 export declare function getBuiltinToolOptionsFromSources(...sources: unknown[]): BuiltinToolOption[];
 export declare function getSkillPathFromSources(...sources: unknown[]): string;
-//# sourceMappingURL=tool-editor.d.ts.map

package/dist/types/component.d.ts

@@ -1,112 +1,135 @@
-/**
- * @file component.ts
- * @description 组件定义类型 - 描述编辑器中可使用的节点组件
- *
- * 组件定义包含组件的类型、分类、表单字段、关系类型等信息。
- * 这些定义来源于后端 API (/api/v1/components) 或内置的默认配置。
- *
- * 组件通过 ComponentRegistry 注册到编辑器中，
- * 在侧边栏中按分类分组展示，用户可以拖拽到画布上创建节点。
- */
-/**
- * 字段验证规则
- */
 export interface FieldValidation {
-    /** 是否必填 */
     required?: boolean;
-    /** 字符串最小长度 */
     minLength?: number;
-    /** 字符串最大长度 */
     maxLength?: number;
-    /** 正则表达式验证 */
     pattern?: string;
-    /** 验证失败提示消息 */
+    noTemplateVariables?: boolean;
     message?: string;
 }
-/**
- * 组件的表单字段定义
- * 用于动态生成节点属性编辑表单
- */
-export interface ComponentField {
-    /** 字段名称 (对应 configuration 中的 key) */
+export type FieldDependencyOperator = 'notEmpty' | 'empty' | 'eq' | 'ne' | 'in' | 'prefix';
+export interface FieldDependency {
+    field: string;
+    operator: FieldDependencyOperator;
+    value?: unknown;
+}
+export interface FieldAttachment {
+    field?: string;
+    target?: string;
+    mode?: 'drawer' | 'popover';
+}
+export interface FieldOptionsSource {
     name: string;
-    /** 字段类型 (string, int, bool, select, code 等) */
-    type: string;
-    /** 默认值 */
-    defaultValue: unknown;
-    /** 显示标签 */
+    params?: Record<string, unknown>;
+    watch?: string[];
+    includeGraphNodes?: boolean;
+}
+export interface AiProviderCapability {
+    kind?: 'chat' | 'embedding';
+    providerField?: string;
+    urlField?: string;
+    modelField?: string;
+}
+export interface ComponentFieldControl {
+    type?: string;
+    caseType?: string;
+    source?: string;
+    onChange?: string;
+    options?: ComponentFieldControlOption[];
+    multiple?: boolean;
+    filterable?: boolean;
+    allowCreate?: boolean;
+    clearable?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    rows?: number;
+    [key: string]: unknown;
+}
+export interface ComponentFieldOption {
     label: string;
-    /** 字段描述/提示文本 */
-    desc: string;
-    /** 验证规则 (字符串格式, 旧版兼容; 或 FieldValidation 对象) */
-    validate: string | FieldValidation;
-    /** 嵌套子字段 (用于复合类型) */
-    fields: ComponentField[] | null;
-    /** 下拉选项列表 (当 type 为 select 时) */
-    options?: Array<{
-        label: string;
-        value: string;
-    }>;
+    value: unknown;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+export type ComponentFieldControlOption = ComponentFieldOption | ComponentField;
+export declare function isComponentFieldOption(value: ComponentFieldControlOption): value is ComponentFieldOption;
+export interface ComponentFieldGroup {
+    id: string;
+    label?: string;
+    description?: string;
+    fields?: string[];
+    collapsed?: boolean;
+    order?: number;
+    [key: string]: unknown;
+}
+export type DynamicFieldReference = string | ComponentField[] | {
+    type?: string;
+    fields?: ComponentField[];
+    [key: string]: unknown;
+};
+export interface DynamicFieldsDefinition {
+    by: string;
+    refs: Record<string, DynamicFieldReference>;
+    preserveInactive?: boolean;
+}
+export interface ComponentField {
+    name: string;
+    type?: string;
+    defaultValue?: unknown;
+    label?: string;
+    desc?: string;
+    validate?: string | FieldValidation;
+    fields?: ComponentField[] | null;
+    component?: ComponentFieldControl;
+    options?: ComponentFieldControlOption[];
+    rules?: unknown[];
+    ref?: 'primary' | 'shared' | string;
+    tableColumn?: boolean;
+    addrPrefix?: string;
+    providerType?: 'chat' | 'embedding' | string;
+    aiProvider?: AiProviderCapability;
+    dependsOn?: FieldDependency | FieldDependency[];
+    attachTo?: string | FieldAttachment;
+    optionsSource?: string | FieldOptionsSource;
+    capabilities?: Record<string, unknown>;
+    disabled?: boolean;
+    omitEmpty?: boolean;
+    [key: string]: unknown;
 }
-/**
- * 组件分类常量
- */
 export type ComponentCategory = 'filter' | 'transform' | 'action' | 'external' | 'flow' | string;
-/**
- * 单个组件的完整定义
- * 描述一个可在编辑器中使用的节点类型
- *
- * @example
- * ```json
- * {
- *   "type": "jsFilter",
- *   "category": "filter",
- *   "label": "JS过滤器",
- *   "desc": "使用 JavaScript 过滤消息",
- *   "icon": "filter-icon",
- *   "fields": [...],
- *   "relationTypes": ["True", "False", "Failure"]
- * }
- * ```
- */
 export interface ComponentDefinition {
-    /** 组件类型标识 (唯一, 如 jsFilter, restApiCall) */
     type: string;
-    /** 所属分类 */
     category: ComponentCategory;
-    /** 显示标签 */
+    categoryPath?: string;
+    subgroup?: string;
+    categorySubgroups?: Array<Record<string, unknown>>;
     label: string;
-    /** 组件描述 */
     desc: string;
-    /** 图标名称或路径 */
     icon: string;
-    /** 表单字段列表 */
     fields: ComponentField[] | null;
-    /** 允许的关系类型 (如 True/False/Success/Failure) */
+    groups?: ComponentFieldGroup[];
+    dynamicFields?: DynamicFieldsDefinition;
+    capabilities?: Record<string, unknown>;
     relationTypes: string[];
-    /** 组件颜色 (可选, 用于自定义节点颜色) */
     color?: string;
+    nodeType?: string;
+    order?: number;
+    disabled?: boolean;
+    [key: string]: unknown;
 }
-/**
- * 组件分组
- * 按分类组织的组件集合，用于侧边栏展示
- */
 export interface ComponentGroup {
-    /** 分类标识 */
     category: string;
-    /** 分类显示名称 */
     label: string;
-    /** 分类颜色 */
     color: string;
-    /** 分类图标 */
     icon?: string;
-    /** 该分类下的组件列表 */
     components: ComponentDefinition[];
+    subgroups?: Array<{
+        id: string;
+        label?: string;
+        description?: string;
+        order?: number;
+        components: ComponentDefinition[];
+    }>;
 }
-/**
- * 从后端 API 返回的原始组件数据
- * 可能需要经过 adapterComponents 转换后才能使用
- */
 export interface RawComponentPayloadSections {
     endpoints?: ComponentDefinition[];
     nodes?: ComponentDefinition[];
@@ -117,13 +140,8 @@ export interface RawComponentPayloadSections {
     [key: string]: unknown;
 }
 export type RawComponentData = ComponentDefinition[] | RawComponentPayloadSections;
-/**
- * 组件注册表选项
- */
 export interface ComponentRegistryOptions {
-    /** 初始组件列表 */
     components?: ComponentDefinition[];
-    /** 自定义组件适配器 (将后端数据转为标准格式) */
     adapter?: (data: RawComponentData) => ComponentGroup[];
+    transform?: (definition: ComponentDefinition) => ComponentDefinition;
 }
-//# sourceMappingURL=component.d.ts.map