@flowgram.ai/document 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as _flowgram_ai_utils from '@flowgram.ai/utils';
 import { Disposable, Emitter, IPoint, Rectangle, Event, PaddingSchema, SizeSchema as SizeSchema$1, ScrollSchema, PositionSchema as PositionSchema$1, DisposableCollection } from '@flowgram.ai/utils';
-import { EntityManager, EntityDataRegistry, EntityData, SizeSchema, TransformData, PositionSchema, EntityOpts, Entity, ConfigEntity, OriginSchema } from '@flowgram.ai/core';
+import { EntityManager, EntityDataRegistry, EntityData, SizeSchema, TransformData, PositionSchema, Entity, EntityOpts, ConfigEntity, OriginSchema } from '@flowgram.ai/core';
 import { ContainerModule } from 'inversify';
 
 /**
@@ -9,6 +9,7 @@ import { ContainerModule } from 'inversify';
  */
 declare class FlowVirtualTree<T extends {
     id: string;
+    flowNodeType?: FlowNodeType;
 }> implements Disposable {
     readonly root: T;
     protected onTreeChangeEmitter: Emitter<void>;
@@ -45,7 +46,7 @@ declare class FlowVirtualTree<T extends {
      */
     fireTreeChange(): void;
     get size(): number;
-    toString(): string;
+    toString(showType?: boolean): string;
 }
 declare namespace FlowVirtualTree {
     interface NodeInfo<T> {
@@ -56,6 +57,11 @@ declare namespace FlowVirtualTree {
     }
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Render Tree 会只读模式，不具备操作 tree 结构元素
  */
@@ -105,6 +111,11 @@ declare class FlowRenderTree<T extends FlowNodeEntity> extends FlowVirtualTree<T
     removeParent(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const FlowDocumentOptions: unique symbol;
 /**
  * 流程画布配置
@@ -119,10 +130,11 @@ interface FlowDocumentOptions {
      */
     allNodesDefaultExpanded?: boolean;
     toNodeJSON?(node: FlowNodeEntity): FlowNodeJSON;
-    fromNodeJSON?(node: FlowNodeEntity, json: FlowNodeJSON): void;
+    fromNodeJSON?(node: FlowNodeEntity, json: FlowNodeJSON, isFirstCreate: boolean): void;
     constants?: Record<string, any>;
     formatNodeLines?: (node: FlowNodeEntity, lines: FlowTransitionLine[]) => FlowTransitionLine[];
     formatNodeLabels?: (node: FlowNodeEntity, lines: FlowTransitionLabel[]) => FlowTransitionLabel[];
+    preNodeCreate?: (node: FlowNodeEntity) => void;
     /**
      * 获取默认的节点配置
      */
@@ -156,7 +168,14 @@ declare const ConstantKeys: {
      * 线条、label 激活后的颜色
      */
     BASE_ACTIVATED_COLOR: string;
+    /**
+     * Branch bottom margin
+     * 分支下边距
+     */
+    INLINE_BLOCKS_PADDING_TOP: string;
     NODE_SPACING: string;
+    BRANCH_SPACING: string;
+    ROUNDED_LINE_RADIUS: string;
     ROUNDED_LINE_X_RADIUS: string;
     ROUNDED_LINE_Y_RADIUS: string;
     INLINE_BLOCKS_PADDING_BOTTOM: string;
@@ -164,6 +183,11 @@ declare const ConstantKeys: {
     HOVER_AREA_WIDTH: string;
 };
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const FlowDocumentContribution: unique symbol;
 interface FlowDocumentContribution<T extends FlowDocument = FlowDocument> {
     /**
@@ -178,6 +202,10 @@ interface FlowDocumentContribution<T extends FlowDocument = FlowDocument> {
     loadDocument?(document: T): Promise<void>;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare const FlowDocumentConfigDefaultData: unique symbol;
 /**
  * 用于文档扩展配置
@@ -212,11 +240,21 @@ declare class FlowDocument<T = FlowDocumentJSON> implements Disposable {
     protected currentLayoutKey: string;
     protected onNodeUpdateEmitter: Emitter<{
         node: FlowNodeEntity;
+        /**
+         * use 'json' instead
+         * @deprecated
+         */
         data: FlowNodeJSON;
+        json: FlowNodeJSON;
     }>;
     protected onNodeCreateEmitter: Emitter<{
         node: FlowNodeEntity;
+        /**
+         * use 'json' instead
+         * @deprecated
+         */
         data: FlowNodeJSON;
+        json: FlowNodeJSON;
     }>;
     protected onNodeDisposeEmitter: Emitter<{
         node: FlowNodeEntity;
@@ -224,16 +262,27 @@ declare class FlowDocument<T = FlowDocumentJSON> implements Disposable {
     protected onLayoutChangeEmitter: Emitter<FlowLayout>;
     readonly onNodeUpdate: _flowgram_ai_utils.Event<{
         node: FlowNodeEntity;
+        /**
+         * use 'json' instead
+         * @deprecated
+         */
         data: FlowNodeJSON;
+        json: FlowNodeJSON;
     }>;
     readonly onNodeCreate: _flowgram_ai_utils.Event<{
         node: FlowNodeEntity;
+        /**
+         * use 'json' instead
+         * @deprecated
+         */
         data: FlowNodeJSON;
+        json: FlowNodeJSON;
     }>;
     readonly onNodeDispose: _flowgram_ai_utils.Event<{
         node: FlowNodeEntity;
     }>;
     readonly onLayoutChange: _flowgram_ai_utils.Event<FlowLayout>;
+    private _disposed;
     root: FlowNodeEntity;
     /**
      * 原始的 tree 结构
@@ -248,6 +297,10 @@ declare class FlowDocument<T = FlowDocumentJSON> implements Disposable {
      * 渲染后的 tree 结构
      */
     renderTree: FlowRenderTree<FlowNodeEntity>;
+    /**
+     *
+     */
+    get disposed(): boolean;
     init(): void;
     /**
      * 从数据初始化 O(n)
@@ -278,7 +331,7 @@ declare class FlowDocument<T = FlowDocumentJSON> implements Disposable {
      * @param data
      * @param addedNodes
      */
-    addNode(data: AddNodeData, addedNodes?: FlowNodeEntity[], ignoreCreateEvent?: boolean): FlowNodeEntity;
+    addNode(data: AddNodeData, addedNodes?: FlowNodeEntity[]): FlowNodeEntity;
     addBlocksAsChildren(parent: FlowNodeEntity, blocks: FlowNodeJSON[], addedNodes?: FlowNodeEntity[]): void;
     /**
      * block 格式：
@@ -312,6 +365,18 @@ declare class FlowDocument<T = FlowDocumentJSON> implements Disposable {
      * @param registries
      */
     registerFlowNodes<T extends FlowNodeRegistry<any>>(...registries: T[]): void;
+    /**
+     * Check node extend
+     * @param currentType
+     * @param extendType
+     */
+    isExtend(currentType: FlowNodeType, extendType: FlowNodeType): boolean;
+    /**
+     * Check node type
+     * @param currentType
+     * @param extendType
+     */
+    isTypeOrExtendType(currentType: FlowNodeType, extendType: FlowNodeType): boolean;
     /**
      * 导出数据，可以重载
      */
@@ -359,11 +424,12 @@ declare class FlowDocument<T = FlowDocumentJSON> implements Disposable {
     get size(): number;
     hasNode(nodeId: string): boolean;
     getAllNodes(): FlowNodeEntity[];
-    toString(): string;
+    toString(showType?: boolean): string;
     /**
      * 返回需要渲染的数据
      */
     getRenderDatas<T extends EntityData>(dataRegistry: EntityDataRegistry<T>, containHiddenNodes?: boolean): T[];
+    toNodeJSON(node: FlowNodeEntity): FlowNodeJSON;
     /**
      * 移动节点
      * @param param0
@@ -409,6 +475,7 @@ interface FlowNodeRenderSchema {
     activated: boolean;
     hovered: boolean;
     dragging: boolean;
+    stackIndex: number;
     extInfo?: Record<string, any>;
 }
 /**
@@ -428,7 +495,7 @@ declare class FlowNodeRenderData extends EntityData<FlowNodeRenderSchema> {
     }>;
     get key(): string;
     getDefaultData(): FlowNodeRenderSchema;
-    updateExtInfo(info: Record<string, any>): void;
+    updateExtInfo(info: Record<string, any>, fullUpdate?: boolean): void;
     getExtInfo(): Record<string, any> | undefined;
     constructor(entity: FlowNodeEntity);
     get addable(): boolean;
@@ -447,6 +514,8 @@ declare class FlowNodeRenderData extends EntityData<FlowNodeRenderSchema> {
     set dragging(dragging: boolean);
     set activated(activated: boolean);
     get activated(): boolean;
+    get stackIndex(): number;
+    set stackIndex(index: number);
     get lineActivated(): boolean;
     get node(): HTMLDivElement;
     dispose(): void;
@@ -475,6 +544,7 @@ declare class FlowNodeTransformData extends EntityData<FlowNodeTransformSchema>
      */
     get size(): SizeSchema;
     get position(): PositionSchema;
+    set position(position: PositionSchema);
     set size(size: SizeSchema);
     get inputPoint(): IPoint;
     get defaultInputPoint(): IPoint;
@@ -551,6 +621,11 @@ declare class FlowNodeTransitionData extends EntityData<FlowNodeTransitionSchema
     get isNodeEnd(): boolean;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface FlowNodeEntityConfig extends EntityOpts {
     document: FlowDocument;
     flowNodeType: FlowNodeType;
@@ -617,7 +692,9 @@ declare class FlowNodeEntity extends Entity<FlowNodeEntityConfig> {
     get pre(): FlowNodeEntity | undefined;
     get next(): FlowNodeEntity | undefined;
     get parent(): FlowNodeEntity | undefined;
-    getNodeRegistry<M extends FlowNodeRegistry = FlowNodeRegistry>(): M;
+    getNodeRegistry<M extends FlowNodeRegistry = FlowNodeRegistry & {
+        meta: FlowNodeMeta;
+    }>(): M;
     /**
      * @deprecated
      * use getNodeRegistry instead
@@ -681,7 +758,7 @@ declare class FlowNodeEntity extends Entity<FlowNodeEntityConfig> {
      * 修改节点扩展信息
      * @param info
      */
-    updateExtInfo<T extends Record<string, any> = Record<string, any>>(extInfo: T): void;
+    updateExtInfo<T extends Record<string, any> = Record<string, any>>(extInfo: T, fullUpdate?: boolean): void;
     /**
      * 获取节点扩展信息
      */
@@ -702,6 +779,15 @@ declare class FlowNodeEntity extends Entity<FlowNodeEntityConfig> {
      * 获取节点的位置及大小矩形
      */
     get bounds(): Rectangle;
+    /**
+     * Check node extend type
+     */
+    isExtend(parentType: FlowNodeType): boolean;
+    /**
+     * Check node type
+     * @param parentType
+     */
+    isTypeOrExtendType(parentType: FlowNodeType): boolean;
 }
 declare namespace FlowNodeEntity {
     function is(obj: Entity): obj is FlowNodeEntity;
@@ -742,6 +828,11 @@ declare class FlowDocumentTransformerEntity extends ConfigEntity<{
     refresh(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface FlowRendererStateEntityConfig extends EntityOpts {
 }
 interface FlowRendererState {
@@ -751,6 +842,8 @@ interface FlowRendererState {
     nodeDragIds?: string[];
     nodeDragIdsWithChildren?: string[];
     dragLabelSide?: LABEL_SIDE_TYPE;
+    dragging?: boolean;
+    isBranch?: boolean;
 }
 /**
  * 渲染相关的全局状态管理
@@ -761,6 +854,10 @@ declare class FlowRendererStateEntity extends ConfigEntity<FlowRendererState, Fl
     constructor(conf: FlowRendererStateEntityConfig);
     getNodeHovered(): FlowNodeEntity | undefined;
     setNodeHovered(node: FlowNodeEntity | undefined): void;
+    get dragging(): boolean | undefined;
+    setDragging(dragging: boolean): void;
+    get isBranch(): boolean | undefined;
+    setIsBranch(isBranch: boolean): void;
     getDragLabelSide(): LABEL_SIDE_TYPE | undefined;
     setDragLabelSide(dragLabelSide?: LABEL_SIDE_TYPE): void;
     getNodeDroppingId(): string | undefined;
@@ -772,12 +869,17 @@ declare class FlowRendererStateEntity extends ConfigEntity<FlowRendererState, Fl
     onNodeHoveredChange(fn: (hoveredNode: FlowNodeEntity | undefined) => void, debounceTime?: number): Disposable;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare enum FlowTransitionLineEnum {
-    STRAIGHT_LINE = 0,
-    DIVERGE_LINE = 1,
-    MERGE_LINE = 2,
-    ROUNDED_LINE = 3,
-    CUSTOM_LINE = 4,
+    STRAIGHT_LINE = 0,// 直线
+    DIVERGE_LINE = 1,// 分支线 (一种 ROUNDED_LINE)
+    MERGE_LINE = 2,// 汇聚线 (一种 ROUNDED_LINE)
+    ROUNDED_LINE = 3,// 自定义圆角转弯线
+    CUSTOM_LINE = 4,// 自定义，用于处理循环节点等自定义线条
     DRAGGING_LINE = 5
 }
 interface Vertex extends IPoint {
@@ -785,6 +887,10 @@ interface Vertex extends IPoint {
     radiusY?: number;
     moveX?: number;
     moveY?: number;
+    /**
+     * Strategy for handling arc curvature when space is insufficient, defaults to compress
+     */
+    radiusOverflow?: 'compress' | 'truncate';
 }
 interface FlowTransitionLine {
     type: FlowTransitionLineEnum;
@@ -794,16 +900,18 @@ interface FlowTransitionLine {
     arrow?: boolean;
     renderKey?: string;
     isHorizontal?: boolean;
+    isDraggingLine?: boolean;
     activated?: boolean;
     side?: LABEL_SIDE_TYPE;
     style?: React.CSSProperties;
+    lineId?: string;
 }
 declare enum FlowTransitionLabelEnum {
-    ADDER_LABEL = 0,
-    TEXT_LABEL = 1,
-    COLLAPSE_LABEL = 2,
-    COLLAPSE_ADDER_LABEL = 3,
-    CUSTOM_LABEL = 4,
+    ADDER_LABEL = 0,// 添加按钮
+    TEXT_LABEL = 1,// 文本标签
+    COLLAPSE_LABEL = 2,// 复合节点收起的展开标签
+    COLLAPSE_ADDER_LABEL = 3,// 复合节点收起 + 加号复合标签
+    CUSTOM_LABEL = 4,// 自定义，用于处理循环节点等自定义标签
     BRANCH_DRAGGING_LABEL = 5
 }
 interface FlowTransitionLabel {
@@ -812,7 +920,16 @@ interface FlowTransitionLabel {
     offset: IPoint;
     width?: number;
     rotate?: string;
+    /**
+     * Anchor point for positioning, relative to the label's bounding box
+     * 重心偏移量，相对于标签边界框
+     *
+     * Format: [x, y] / 格式：[x, y]
+     * Default Value: [0.5, 0.5] indicates center / 默认值：[0.5, 0.5] 表示居中
+     */
+    origin?: [number, number];
     props?: Record<string, any>;
+    labelId?: string;
 }
 interface AdderProps {
     node: FlowNodeEntity;
@@ -839,8 +956,13 @@ interface DragNodeProps {
     node: FlowNodeEntity;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare enum FlowLayoutDefault {
-    VERTICAL_FIXED_LAYOUT = "vertical-fixed-layout",
+    VERTICAL_FIXED_LAYOUT = "vertical-fixed-layout",// 垂直固定布局
     HORIZONTAL_FIXED_LAYOUT = "horizontal-fixed-layout"
 }
 declare namespace FlowLayoutDefault {
@@ -891,6 +1013,11 @@ interface FlowLayout {
     getDefaultNodeOrigin(): IPoint;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * 节点渲染相关配置信息，可扩展
  */
@@ -905,13 +1032,13 @@ interface FlowNodeMeta {
     addDisable?: boolean;
     hidden?: boolean;
     size?: SizeSchema;
+    autoResizeDisable?: boolean;
     /**
      * @deprecated 使用 NodeRegister.getOrigin 代替
      */
     origin?: OriginSchema;
     defaultExpanded?: boolean;
     defaultCollapsed?: boolean;
-    expandedSize?: SizeSchema;
     spacing?: number | ((transform: FlowNodeTransformData) => number);
     padding?: PaddingSchema | ((transform: FlowNodeTransformData) => PaddingSchema);
     inlineSpacingPre?: number | ((transform: FlowNodeTransformData) => number);
@@ -930,6 +1057,14 @@ declare const DefaultSpacingKey: {
      * 普通节点间距。垂直 / 水平
      */
     NODE_SPACING: string;
+    /**
+     * 分支节点间距
+     */
+    BRANCH_SPACING: string;
+    /**
+     * 圆弧线条拐角 radius
+     */
+    ROUNDED_LINE_RADIUS: string;
     /**
      * 圆弧线条 x radius
      */
@@ -956,8 +1091,18 @@ declare const DefaultSpacingKey: {
  * 默认一些间隔参数
  */
 declare const DEFAULT_SPACING: {
-    [x: string]: number;
+    [DefaultSpacingKey.NODE_SPACING]: number;
+    [DefaultSpacingKey.BRANCH_SPACING]: number;
+    [DefaultSpacingKey.INLINE_BLOCKS_PADDING_BOTTOM]: number;
+    [DefaultSpacingKey.COLLAPSED_SPACING]: number;
+    [DefaultSpacingKey.ROUNDED_LINE_RADIUS]: number;
+    [DefaultSpacingKey.ROUNDED_LINE_X_RADIUS]: number;
+    [DefaultSpacingKey.ROUNDED_LINE_Y_RADIUS]: number;
+    [DefaultSpacingKey.HOVER_AREA_WIDTH]: number;
     NULL: number;
+    /**
+     * @deprecated use 'BRANCH_SPACING' instead
+     */
     MARGIN_RIGHT: number;
     INLINE_BLOCK_PADDING_BOTTOM: number;
     INLINE_BLOCKS_PADDING_TOP: number;
@@ -1082,6 +1227,7 @@ interface FlowNodeRegistry<M extends FlowNodeMeta = FlowNodeMeta> {
      */
     extendChildRegistries?: FlowNodeRegistry[];
     /**
+     * @deprecated
      * 自定义子节点添加逻辑
      * @param node 节点
      * @param json 添加的节点 JSON
@@ -1092,23 +1238,33 @@ interface FlowNodeRegistry<M extends FlowNodeMeta = FlowNodeMeta> {
         hidden?: boolean;
         index?: number;
     }) => FlowNodeEntity;
+    /**
+     * 内部用于继承逻辑判断，不要使用
+     */
+    __extends__?: FlowNodeType[];
     /**
      * 扩展注册器
      */
     [key: string]: any;
 }
 declare namespace FlowNodeRegistry {
+    function mergeChildRegistries(r1?: FlowNodeRegistry[], r2?: FlowNodeRegistry[]): FlowNodeRegistry[];
     function merge(registry1: FlowNodeRegistry, registry2: FlowNodeRegistry, finalType: FlowNodeType): FlowNodeRegistry;
     function extend(registry: FlowNodeRegistry, extendRegistries: FlowNodeRegistry[]): FlowNodeRegistry;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FlowNodeType = string | number;
 /**
  * Flow node json data
  */
 interface FlowNodeJSON {
     id: string;
-    type?: FlowNodeType;
+    type?: FlowNodeBaseType | FlowNodeSplitType | FlowNodeType;
     data?: Record<string, any>;
     meta?: FlowNodeMeta;
     blocks?: FlowNodeJSON[];
@@ -1117,21 +1273,29 @@ type FlowDocumentJSON = {
     nodes: FlowNodeJSON[];
 };
 declare enum FlowNodeBaseType {
-    START = "start",
-    DEFAULT = "default",
-    ROOT = "root",
-    EMPTY = "empty",
-    INLINE_BLOCKS = "inlineBlocks",
-    BLOCK_ICON = "blockIcon",
-    BLOCK = "block",
-    BLOCK_ORDER_ICON = "blockOrderIcon",
-    GROUP = "group",
-    END = "end",
-    CONDITION = "condition",
-    SUB_CANVAS = "subCanvas"
+    START = "start",// 开始节点
+    DEFAULT = "default",// 默认节点类型
+    ROOT = "root",// 根节点
+    EMPTY = "empty",// 空节点，宽和高为 0
+    INLINE_BLOCKS = "inlineBlocks",// 所有块合并为 InlineBlocks
+    BLOCK_ICON = "blockIcon",// 图标节点，如条件分支的头部的 菱形图标
+    BLOCK = "block",// 块节点
+    BLOCK_ORDER_ICON = "blockOrderIcon",// 带顺序的图标节点，一般为 block 第一个分支节点
+    GROUP = "group",// 分组节点
+    END = "end",// 结束节点
+    BREAK = "break",// 分支结束
+    CONDITION = "condition",// 可以连接多条线的条件判断节点，目前只支持横向布局
+    SUB_CANVAS = "subCanvas",// 自由布局子画布
+    MULTI_INPUTS = "multiInputs",// 多输入
+    MULTI_OUTPUTS = "multiOutputs",// 多输出
+    INPUT = "input",// 输入节点
+    OUTPUT = "output",// 输出节点
+    SLOT = "slot",// 插槽节点
+    SLOT_BLOCK = "slotBlock"
 }
 declare enum FlowNodeSplitType {
-    DYNAMIC_SPLIT = "dynamicSplit",
+    SIMPLE_SPLIT = "simpleSplit",// 无 BlockOrderIcon
+    DYNAMIC_SPLIT = "dynamicSplit",// 动态分支
     STATIC_SPLIT = "staticSplit"
 }
 declare enum FlowDocumentConfigEnum {
@@ -1145,6 +1309,11 @@ type AddNodeData = FlowNodeJSON & {
     index?: number;
 };
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare enum OperationType {
     addFromNode = "addFromNode",
     deleteFromNode = "deleteFromNode",
@@ -1157,7 +1326,6 @@ declare enum OperationType {
     moveChildNodes = "moveChildNodes",
     addNodes = "addNodes",
     deleteNodes = "deleteNodes",
-    changeNode = "changeNode",
     addChildNode = "addChildNode",
     deleteChildNode = "deleteChildNode",
     addNode = "addNode",
@@ -1227,16 +1395,6 @@ interface DeleteNodesOperation {
     type: OperationType.deleteNodes;
     value: AddOrDeleteNodesOperationValue;
 }
-interface ChangeNodeOperationValue {
-    id: string;
-    path: string;
-    oldValue: any;
-    value: any;
-}
-interface ChangeNodeOperation {
-    type: OperationType.changeNode;
-    value: ChangeNodeOperationValue;
-}
 interface MoveChildNodesOperationValue {
     nodeIds: string[];
     fromParentId: string;
@@ -1288,7 +1446,7 @@ interface AddOrDeleteNodeValue {
     index?: number;
     hidden?: boolean;
 }
-type FlowOperation = AddFromNodeOperation | DeleteFromNodeOperation | AddBlockOperation | DeleteBlockOperation | CreateGroupOperation | UngroupOperation | MoveNodesOperation | AddNodesOperation | DeleteNodesOperation | ChangeNodeOperation | MoveBlockOperation | AddChildNodeOperation | DeleteChildNodeOperation | MoveChildNodesOperation | AddNodeOperation | DeleteNodeOperation;
+type FlowOperation = AddFromNodeOperation | DeleteFromNodeOperation | AddBlockOperation | DeleteBlockOperation | CreateGroupOperation | UngroupOperation | MoveNodesOperation | AddNodesOperation | DeleteNodesOperation | MoveBlockOperation | AddChildNodeOperation | DeleteChildNodeOperation | MoveChildNodesOperation | AddNodeOperation | DeleteNodeOperation;
 type FlowNodeEntityOrId = string | FlowNodeEntity;
 type AddNodeConfig = {
     parent?: FlowNodeEntityOrId;
@@ -1316,6 +1474,16 @@ interface OnNodeAddEvent {
     node: FlowNodeEntity;
     data: AddNodeData;
 }
+/**
+ * 节点移动事件
+ */
+interface OnNodeMoveEvent {
+    node: FlowNodeEntity;
+    fromParent: FlowNodeEntity;
+    fromIndex: number;
+    toParent: FlowNodeEntity;
+    toIndex: number;
+}
 interface FlowOperationBaseService extends Disposable {
     /**
      * 执行操作
@@ -1374,13 +1542,26 @@ interface FlowOperationBaseService extends Disposable {
      * 添加节点的回调
      */
     onNodeAdd: Event<OnNodeAddEvent>;
+    /**
+     * 节点移动的回调
+     */
+    onNodeMove: Event<OnNodeMoveEvent>;
 }
 declare const FlowOperationBaseService: unique symbol;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 interface FlowGroupJSON {
     nodeIDs: string[];
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const FlowDocumentContainerModule: ContainerModule;
 
 /**
@@ -1394,10 +1575,12 @@ declare class FlowDragService {
     protected onDropEmitter: Emitter<{
         dropNode: FlowNodeEntity;
         dragNodes: FlowNodeEntity[];
+        dragJSON?: FlowNodeJSON;
     }>;
     readonly onDrop: _flowgram_ai_utils.Event<{
         dropNode: FlowNodeEntity;
         dragNodes: FlowNodeEntity[];
+        dragJSON?: FlowNodeJSON;
     }>;
     get renderState(): FlowRendererStateEntity;
     get dragStartNode(): FlowNodeEntity;
@@ -1411,6 +1594,11 @@ declare class FlowDragService {
      * 放置到目标分支
      */
     dropBranch(): void;
+    /**
+     * 移动并且创建节点
+     * Move and create node
+     */
+    dropCreateNode(json: FlowNodeJSON, onCreateNode?: (json: FlowNodeJSON, dropEntity: FlowNodeEntity) => Promise<FlowNodeEntity>): Promise<void>;
     /**
      * 移动到目标节点
      */
@@ -1436,6 +1624,8 @@ declare class FlowOperationBaseServiceImpl implements FlowOperationBaseService {
     protected onNodeAddEmitter: Emitter<OnNodeAddEvent>;
     readonly onNodeAdd: _flowgram_ai_utils.Event<OnNodeAddEvent>;
     protected toDispose: DisposableCollection;
+    private onNodeMoveEmitter;
+    readonly onNodeMove: _flowgram_ai_utils.Event<OnNodeMoveEvent>;
     protected init(): void;
     addNode(nodeJSON: FlowNodeJSON, config?: AddNodeConfig): FlowNodeEntity;
     addFromNode(fromNode: FlowNodeEntityOrId, nodeJSON: FlowNodeJSON): FlowNodeEntity;
@@ -1470,21 +1660,11 @@ declare class FlowOperationBaseServiceImpl implements FlowOperationBaseService {
     protected doMoveNode(node: FlowNodeEntity, newParent: FlowNodeEntity, index: number): void;
 }
 
-declare class FlowGroupService {
-    readonly entityManager: EntityManager;
-    readonly operationService: FlowOperationBaseService;
-    /** 创建分组节点 */
-    createGroup(nodes: FlowNodeEntity[]): FlowNodeEntity | undefined;
-    /** 删除分组 */
-    deleteGroup(groupNode: FlowNodeEntity): void;
-    /** 取消分组 */
-    ungroup(groupNode: FlowNodeEntity): void;
-    /** 返回所有分组节点 */
-    getAllGroups(): FlowGroupController[];
-    /** 获取分组控制器*/
-    groupController(group: FlowNodeEntity): FlowGroupController | undefined;
-    static validate(nodes: FlowNodeEntity[]): boolean;
-}
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /** 分组控制器 */
 declare class FlowGroupController {
     readonly groupNode: FlowNodeEntity;
@@ -1508,20 +1688,34 @@ declare class FlowGroupController {
     set hovered(hovered: boolean);
     get hovered(): boolean;
     static create(groupNode?: FlowNodeEntity): FlowGroupController | undefined;
-    /** 判断节点能否组成分组 */
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare class FlowGroupService {
+    readonly entityManager: EntityManager;
+    readonly operationService: FlowOperationBaseService;
+    /** 创建分组节点 */
+    createGroup(nodes: FlowNodeEntity[]): FlowNodeEntity | undefined;
+    /** 删除分组 */
+    deleteGroup(groupNode: FlowNodeEntity): void;
+    /** 取消分组 */
+    ungroup(groupNode: FlowNodeEntity): void;
+    /** 返回所有分组节点 */
+    getAllGroups(): FlowGroupController[];
+    /** 获取分组控制器*/
+    groupController(group: FlowNodeEntity): FlowGroupController | undefined;
     static validate(nodes: FlowNodeEntity[]): boolean;
-    /** 获取节点分组控制 */
-    static getNodeGroupController(node?: FlowNodeEntity): FlowGroupController | undefined;
-    /** 向上递归查找分组递归控制 */
-    static getNodeRecursionGroupController(node?: FlowNodeEntity): FlowGroupController | undefined;
-    /** 是否分组节点 */
-    static isGroupNode(group: FlowNodeEntity): boolean;
-    /** 找到节点所有上级 */
-    private static findNodeParents;
-    /** 节点是否处于分组中 */
-    private static isNodeInGroup;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  *
  * @param node 节点 entity
@@ -1531,4 +1725,4 @@ declare class FlowGroupController {
  */
 declare const getDefaultSpacing: (node: FlowNodeEntity, key: string, defaultSpacing?: number) => any;
 
-export { type AddBlockConfig, type AddBlockOperation, type AddChildNodeOperation, type AddFromNodeOperation, type AddNodeConfig, type AddNodeData, type AddNodeOperation, type AddNodesOperation, type AddOrDeleteBlockValue, type AddOrDeleteChildNodeValue, type AddOrDeleteFromNodeOperationValue, type AddOrDeleteNodeOperationValue, type AddOrDeleteNodeValue, type AddOrDeleteNodesOperationValue, type AdderProps, type ChangeNodeOperation, type ChangeNodeOperationValue, type CollapseAdderProps, type CollapseProps, ConstantKeys, type CreateGroupOperation, type CustomLabelProps, DEFAULT_FLOW_NODE_META, DEFAULT_SIZE, DEFAULT_SPACING, DRAGGING_TYPE, DefaultSpacingKey, type DeleteBlockOperation, type DeleteChildNodeOperation, type DeleteFromNodeOperation, type DeleteNodeOperation, type DeleteNodesOperation, type DragNodeProps, FLOW_DEFAULT_HIDDEN_TYPES, FlowDocument, FlowDocumentConfig, FlowDocumentConfigDefaultData, FlowDocumentConfigEnum, FlowDocumentContainerModule, FlowDocumentContribution, type FlowDocumentJSON, FlowDocumentOptions, FlowDocumentOptionsDefault, FlowDocumentProvider, FlowDocumentTransformerEntity, FlowDragService, FlowGroupController, type FlowGroupJSON, FlowGroupService, FlowLayout, FlowLayoutContribution, FlowLayoutDefault, FlowNodeBaseType, FlowNodeEntity, type FlowNodeEntityConfig, type FlowNodeEntityOrId, type FlowNodeInitData, type FlowNodeJSON, type FlowNodeMeta, FlowNodeRegistry, FlowNodeRenderData, type FlowNodeRenderSchema, FlowNodeSplitType, FlowNodeTransformData, type FlowNodeTransformSchema, FlowNodeTransitionData, type FlowNodeTransitionSchema, type FlowNodeType, type FlowOperation, FlowOperationBaseService, FlowOperationBaseServiceImpl, FlowRendererStateEntity, type FlowTransitionLabel, FlowTransitionLabelEnum, type FlowTransitionLine, FlowTransitionLineEnum, FlowVirtualTree, LABEL_SIDE_TYPE, type MoveBlockOperation, type MoveBlockOperationValue, type MoveChildNodesOperation, type MoveChildNodesOperationValue, type MoveNodeConfig, type MoveNodesOperation, type MoveNodesOperationValue, type OnNodeAddEvent, OperationType, type UngroupOperation, type Vertex, type createOrUngroupValue, drawLineToBottom, drawLineToNext, getDefaultSpacing };
+export { type AddBlockConfig, type AddBlockOperation, type AddChildNodeOperation, type AddFromNodeOperation, type AddNodeConfig, type AddNodeData, type AddNodeOperation, type AddNodesOperation, type AddOrDeleteBlockValue, type AddOrDeleteChildNodeValue, type AddOrDeleteFromNodeOperationValue, type AddOrDeleteNodeOperationValue, type AddOrDeleteNodeValue, type AddOrDeleteNodesOperationValue, type AdderProps, type CollapseAdderProps, type CollapseProps, ConstantKeys, type CreateGroupOperation, type CustomLabelProps, DEFAULT_FLOW_NODE_META, DEFAULT_SIZE, DEFAULT_SPACING, DRAGGING_TYPE, DefaultSpacingKey, type DeleteBlockOperation, type DeleteChildNodeOperation, type DeleteFromNodeOperation, type DeleteNodeOperation, type DeleteNodesOperation, type DragNodeProps, FLOW_DEFAULT_HIDDEN_TYPES, FlowDocument, FlowDocumentConfig, FlowDocumentConfigDefaultData, FlowDocumentConfigEnum, FlowDocumentContainerModule, FlowDocumentContribution, type FlowDocumentJSON, FlowDocumentOptions, FlowDocumentOptionsDefault, FlowDocumentProvider, FlowDocumentTransformerEntity, FlowDragService, FlowGroupController, type FlowGroupJSON, FlowGroupService, FlowLayout, FlowLayoutContribution, FlowLayoutDefault, FlowNodeBaseType, FlowNodeEntity, type FlowNodeEntityConfig, type FlowNodeEntityOrId, type FlowNodeInitData, type FlowNodeJSON, type FlowNodeMeta, FlowNodeRegistry, FlowNodeRenderData, type FlowNodeRenderSchema, FlowNodeSplitType, FlowNodeTransformData, type FlowNodeTransformSchema, FlowNodeTransitionData, type FlowNodeTransitionSchema, type FlowNodeType, type FlowOperation, FlowOperationBaseService, FlowOperationBaseServiceImpl, FlowRendererStateEntity, type FlowTransitionLabel, FlowTransitionLabelEnum, type FlowTransitionLine, FlowTransitionLineEnum, FlowVirtualTree, LABEL_SIDE_TYPE, type MoveBlockOperation, type MoveBlockOperationValue, type MoveChildNodesOperation, type MoveChildNodesOperationValue, type MoveNodeConfig, type MoveNodesOperation, type MoveNodesOperationValue, type OnNodeAddEvent, type OnNodeMoveEvent, OperationType, type UngroupOperation, type Vertex, type createOrUngroupValue, drawLineToBottom, drawLineToNext, getDefaultSpacing };