@flowgram.ai/free-layout-core 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/index.d.ts

@@ -1,21 +1,24 @@
-import { PlaygroundConfigEntity, EntityData } from '@flowgram.ai/core';
-export { bindConfigEntity, useConfigEntity, useEntities, useEntityDataFromContext, useEntityFromContext, useListenEvents, usePlayground, usePlaygroundContainer, usePlaygroundContext, usePlaygroundLatest, useRefresh, useService } from '@flowgram.ai/core';
+import { PlaygroundConfigEntity, CommandService, PlaygroundDragEvent, EntityData } from '@flowgram.ai/core';
+export { bindConfigEntity, useConfigEntity, useEntities, useEntityDataFromContext, useEntityFromContext, useListenEvents, usePlayground, usePlaygroundContainer, usePlaygroundContext, useRefresh, useService } from '@flowgram.ai/core';
 import { NodeFormProps } from '@flowgram.ai/node';
-import { FlowNodeEntity } from '@flowgram.ai/document';
-import { W as WorkflowPortEntity, a as WorkflowDocument, b as WorkflowPorts, c as WorkflowPortType, d as WorkflowPort, e as WorkflowLineEntity, L as LineRenderType, f as WorkflowLineRenderContribution, g as LinePosition } from './workflow-line-entity-CEitdjhk.js';
-export { t as LINE_HOVER_DISTANCE, q as LineColor, r as LineColors, p as LineType, N as NodesDragEndEvent, C as NodesDragEvent, O as OnDragLineEnd, P as POINT_RADIUS, x as PORT_SIZE, i as WORKFLOW_LINE_ENTITY, A as WorkfloEntityHoverable, m as WorkflowContentChangeEvent, l as WorkflowContentChangeType, H as WorkflowDocumentOptions, I as WorkflowDocumentOptionsDefault, F as WorkflowDocumentProvider, E as WorkflowDragService, B as WorkflowHoverService, k as WorkflowJSON, v as WorkflowLineEntityOpts, w as WorkflowLineInfo, u as WorkflowLinePortInfo, s as WorkflowLineRenderContributionFactory, G as WorkflowLinesManager, o as WorkflowNodeJSON, n as WorkflowNodeMeta, y as WorkflowPortEntityOpts, z as WorkflowSelectService, j as domReactToBounds, h as getPortEntityId, D as onDragLineEndParams } from './workflow-line-entity-CEitdjhk.js';
-import { W as WorkflowNodeEntity } from './workflow-sub-canvas-DOVla1mw.js';
-export { a as WorkflowSubCanvas } from './workflow-sub-canvas-DOVla1mw.js';
+import { FlowNodeType, FlowOperationBaseServiceImpl, FlowNodeEntityOrId, FlowNodeEntity } from '@flowgram.ai/document';
+import { W as WorkflowJSON, L as LineCenterPoint, a as WorkflowDocument, b as WorkflowNodeEntity, c as WorkflowHoverService, d as WorkflowLinesManager, e as WorkflowSelectService, f as WorkflowDocumentOptions, g as LineEventProps, N as NodesDragEvent, h as WorkflowNodeJSON, i as WorkflowPortEntity, j as WorkflowLineEntity, O as OnDragLineEnd, k as LineRenderType, l as WorkflowLineRenderContribution, m as LinePosition } from './workflow-node-entity-DWVtlA2a.js';
+export { X as HoverPosition, F as LINE_HOVER_DISTANCE, x as LineColor, y as LineColors, w as LinePoint, v as LinePointLocation, u as LineType, C as NodesDragEndEvent, B as NodesDragStartEvent, D as NodesDraggingEvent, P as POINT_RADIUS, K as PORT_SIZE, p as WORKFLOW_LINE_ENTITY, Y as WorkfloEntityHoverable, s as WorkflowContentChangeEvent, r as WorkflowContentChangeType, _ as WorkflowDocumentOptionsDefault, Z as WorkflowDocumentProvider, V as WorkflowEntityHoverable, H as WorkflowLineEntityOpts, I as WorkflowLineInfo, G as WorkflowLinePortInfo, z as WorkflowLineRenderContributionFactory, J as WorkflowLineUIState, T as WorkflowNodeLines, U as WorkflowNodeLinesData, t as WorkflowNodeMeta, S as WorkflowNodePortsData, M as WorkflowPort, R as WorkflowPortEntityOpts, n as WorkflowPortType, Q as WorkflowPorts, A as WorkflowSubCanvas, q as domReactToBounds, o as getPortEntityId, E as onDragLineEndParams } from './workflow-node-entity-DWVtlA2a.js';
 import * as _flowgram_ai_utils from '@flowgram.ai/utils';
-import { IPoint, Rectangle } from '@flowgram.ai/utils';
+import { IPoint, Rectangle, DisposableCollection, Disposable } from '@flowgram.ai/utils';
 export { compose, composeAsync, delay } from '@flowgram.ai/utils';
 export { URLParams } from './typings/index.js';
+import React$1 from 'react';
+import { WorkflowOperationBaseService, NodePostionUpdateEvent } from './typings/workflow-operation.js';
 import { ContainerModule } from 'inversify';
 export { WorkflowEdgeJSON } from './typings/workflow-edge.js';
 export { WorkflowNodeFormMeta, WorkflowNodeRegistry, WorkflowNodeRenderProps } from './typings/workflow-registry.js';
 import '@flowgram.ai/form-core';
-import 'react';
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare enum WorkflowCommands {
     DELETE_NODES = "DELETE_NODES",
     COPY_NODES = "COPY_NODES",
@@ -26,6 +29,162 @@ declare enum WorkflowCommands {
     REDO = "REDO"
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare const buildGroupJSON: (json: WorkflowJSON) => WorkflowJSON;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare function getLineCenter(from: IPoint, to: IPoint, bbox: Rectangle, linePadding: number): LineCenterPoint;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+declare function nanoid(n?: number): string;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare const fitView: (doc: WorkflowDocument, playgroundConfig: PlaygroundConfigEntity, easing?: boolean) => Promise<void>;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * 获取没有碰撞的位置
+ * 距离很小时，xy 各偏移 30
+ * @param position
+ */
+declare function getAntiOverlapPosition(doc: WorkflowDocument, position: IPoint, containerNode?: WorkflowNodeEntity): IPoint;
+
+declare class WorkflowDragService {
+    protected playgroundConfig: PlaygroundConfigEntity;
+    protected hoverService: WorkflowHoverService;
+    protected document: WorkflowDocument;
+    protected linesManager: WorkflowLinesManager;
+    protected commandService: CommandService;
+    protected selectService: WorkflowSelectService;
+    protected operationService: WorkflowOperationBaseService;
+    readonly options: WorkflowDocumentOptions;
+    private _onDragLineEventEmitter;
+    readonly onDragLineEventChange: _flowgram_ai_utils.Event<LineEventProps>;
+    isDragging: boolean;
+    private _nodesDragEmitter;
+    readonly onNodesDrag: _flowgram_ai_utils.Event<NodesDragEvent>;
+    protected _toDispose: DisposableCollection;
+    private _droppableTransforms;
+    private _dropNode?;
+    private posAdjusters;
+    private _onDragLineEndCallbacks;
+    init(): void;
+    dispose(): void;
+    /**
+     * 拖拽选中节点
+     * @param triggerEvent
+     */
+    startDragSelectedNodes(triggerEvent: MouseEvent | React$1.MouseEvent): Promise<boolean>;
+    /**
+     * 通过拖入卡片添加
+     * @param type
+     * @param event
+     * @param data 节点数据
+     */
+    dropCard(type: string, event: {
+        clientX: number;
+        clientY: number;
+    }, data?: Partial<WorkflowNodeJSON>, parent?: WorkflowNodeEntity): Promise<WorkflowNodeEntity | undefined>;
+    /**
+     * 拖拽卡片到画布
+     * 返回创建结果
+     * @param type
+     * @param event
+     */
+    startDragCard(type: string, event: React$1.MouseEvent, data: Partial<WorkflowNodeJSON>, cloneNode?: (e: PlaygroundDragEvent) => HTMLDivElement): Promise<WorkflowNodeEntity | undefined>;
+    /**
+     * 如果存在容器节点，且传入鼠标坐标，需要用容器的坐标减去传入的鼠标坐标
+     */
+    adjustSubNodePosition(subNodeType?: string, containerNode?: WorkflowNodeEntity, mousePos?: IPoint): IPoint;
+    /**
+     * 注册位置调整
+     */
+    registerPosAdjuster(adjuster: (params: {
+        selectedNodes: WorkflowNodeEntity[];
+        position: IPoint;
+    }) => IPoint): {
+        dispose: () => boolean;
+    };
+    /**
+     * 判断是否可以放置节点
+     */
+    canDropToNode(params: {
+        dragNodeType?: FlowNodeType;
+        dragNode?: WorkflowNodeEntity;
+        dropNode?: WorkflowNodeEntity;
+        dropNodeType?: FlowNodeType;
+    }): {
+        allowDrop: boolean;
+        message?: string;
+        dropNode?: WorkflowNodeEntity;
+    };
+    /**
+     * 获取拖拽偏移
+     */
+    private getDragPosOffset;
+    private updateDroppableTransforms;
+    /** 是否容器节点 */
+    private isContainer;
+    /**
+     * 获取节点整体位置
+     */
+    private getNodesPosition;
+    private nodeSelectable;
+    private updateDropNode;
+    private clearDrop;
+    private setLineColor;
+    private checkDraggingPort;
+    /**
+     * 容器内子节点总体位置重置为0
+     */
+    private resetContainerInternalPosition;
+    private childrenOfContainer;
+    /**
+     * 绘制线条
+     * @param opts
+     * @param event
+     */
+    startDrawingLine(port: WorkflowPortEntity, event: {
+        clientX: number;
+        clientY: number;
+    }, originLine?: WorkflowLineEntity): Promise<{
+        dragSuccess?: boolean;
+        newLine?: WorkflowLineEntity;
+    }>;
+    private updateDrawingLine;
+    /**
+     * 重新连接线条
+     * @param line
+     * @param e
+     */
+    resetLine(line: WorkflowLineEntity, e: MouseEvent): Promise<void>;
+    /** 线条拖拽结束 */
+    onDragLineEnd(callback: OnDragLineEnd): Disposable;
+    /** 能否建立容器连线 */
+    private canBuildContainerLine;
+    /** 获取最近的 port */
+    private getNearestPort;
+}
+
 type PositionMap = Record<string, IPoint>;
 /**
  * 重置布局服务
@@ -67,11 +226,75 @@ declare class WorkflowResetLayoutService {
     dispose(): void;
 }
 
+declare class WorkflowOperationBaseServiceImpl extends FlowOperationBaseServiceImpl implements WorkflowOperationBaseService {
+    protected document: WorkflowDocument;
+    linesManager: WorkflowLinesManager;
+    private onNodePostionUpdateEmitter;
+    readonly onNodePostionUpdate: _flowgram_ai_utils.Event<NodePostionUpdateEvent>;
+    updateNodePosition(nodeOrId: FlowNodeEntityOrId, position: IPoint): void;
+    fromJSON(json: WorkflowJSON): void;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface WorkflowLineRenderDataSchema {
+    version: string;
+    contributions: Map<LineRenderType, WorkflowLineRenderContribution>;
+    position: LinePosition;
+}
+declare class WorkflowLineRenderData extends EntityData<WorkflowLineRenderDataSchema> {
+    static type: string;
+    entity: WorkflowLineEntity;
+    constructor(entity: WorkflowLineEntity);
+    getDefaultData(): WorkflowLineRenderDataSchema;
+    get renderVersion(): string;
+    get position(): LinePosition;
+    get path(): string;
+    calcDistance(pos: IPoint): number;
+    get bounds(): Rectangle;
+    /**
+     * 更新数据
+     * WARNING: 这个方法，必须在 requestAnimationFrame / useLayoutEffect 中调用，否则会引起浏览器强制重排
+     */
+    update(): void;
+    private get lineType();
+    /**
+     * 获取 center 位置
+     */
+    get center(): LineCenterPoint;
+    /**
+     * 更新版本
+     * WARNING: 这个方法，必须在 requestAnimationFrame / useLayoutEffect 中调用，否则会引起浏览器强制重排
+     */
+    private updatePosition;
+    private get currentLine();
+    private syncContributions;
+    private registerContribution;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface NodeRenderReturnType {
+    id: string;
+    type: string | number;
     /**
      * 当前节点
      */
     node: FlowNodeEntity;
+    /**
+     * 节点 data 数据
+     */
+    data: any;
+    /**
+     * 更新节点 data 数据
+     */
+    updateData: (newData: any) => void;
     /**
      * 节点选中
      */
@@ -134,7 +357,7 @@ interface NodeRenderReturnType {
      * 更新节点的扩展数据
      * @param extInfo
      */
-    updateExtInfo<T = any>(extInfo: T): void;
+    updateExtInfo<T = any>(extInfo: T, fullUpdate?: boolean): void;
     /**
      * 展开/收起节点
      * @param expanded
@@ -142,36 +365,52 @@ interface NodeRenderReturnType {
     toggleExpand(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function useNodeRender(nodeFromProps?: WorkflowNodeEntity): NodeRenderReturnType;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 /**
  * 获取当前渲染的 dom 节点
  */
 declare function useCurrentDomNode(): HTMLDivElement;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * 获取当前节点
  */
 declare function useCurrentEntity(): WorkflowNodeEntity;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function useWorkflowDocument(): WorkflowDocument;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 /**
  * 获取 readonly 状态
  */
 declare function usePlaygroundReadonlyState(listenChange?: boolean): boolean;
 
-declare function nanoid(n?: number): string;
-
-declare const fitView: (doc: WorkflowDocument, playgroundConfig: PlaygroundConfigEntity, easing?: boolean) => Promise<void>;
-
 /**
- * 获取没有碰撞的位置
- * 距离很小时，xy 各偏移 30
- * @param position
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
  */
-declare function getAntiOverlapPosition(doc: WorkflowDocument, position: IPoint, containerNode?: WorkflowNodeEntity): IPoint;
-
 declare enum EditorCursorState {
     GRAB = "GRAB",
     SELECT = "SELECT"
@@ -184,177 +423,10 @@ declare enum InteractiveType {
 }
 
 /**
- * 节点的点位信息
- * portsData 只监听点位的数目和类型，不监听点位的 position 变化
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
  */
-declare class WorkflowNodePortsData extends EntityData {
-    static readonly type = "WorkflowNodePortsData";
-    readonly entity: WorkflowNodeEntity;
-    /** 静态的 ports 数据 */
-    protected _staticPorts: WorkflowPorts;
-    /** 存储 port 实体的 id，用于判断 port 是否存在 */
-    protected _portIDSet: Set<string>;
-    /** 上一次的 ports 数据，用于判断 ports 是否发生变化 */
-    protected _prePorts: WorkflowPorts;
-    constructor(entity: WorkflowNodeEntity);
-    getDefaultData(): any;
-    /**
-     * 更新静态的 ports 数据
-     */
-    updateStaticPorts(ports: WorkflowPorts): void;
-    /**
-     * 动态计算点位，通过 dom 的 data-port-key
-     */
-    updateDynamicPorts(): void;
-    /**
-     * 根据 key 获取 port 实体
-     */
-    getPortEntityByKey(portType: WorkflowPortType, portKey?: string | number): WorkflowPortEntity;
-    /**
-     * 更新 ports 数据
-     */
-    updatePorts(ports: WorkflowPorts): void;
-    /**
-     * 获取所有 port entities
-     */
-    get allPorts(): WorkflowPortEntity[];
-    /**
-     * 获取输入点位
-     */
-    get inputPorts(): WorkflowPortEntity[];
-    /**
-     * 获取输出点位
-     */
-    get outputPorts(): WorkflowPortEntity[];
-    /**
-     * 获取输入点位置
-     */
-    get inputPoints(): IPoint[];
-    /**
-     * 获取输出点位置
-     */
-    get outputPoints(): IPoint[];
-    /**
-     * 根据 key 获取 输入点位置
-     */
-    getInputPoint(key?: string | number): IPoint;
-    /**
-     * 根据 key 获取输出点位置
-     */
-    getOutputPoint(key?: string | number): IPoint;
-    /**
-     * 获取 port 实体
-     */
-    protected getPortEntity(portId: string): WorkflowPortEntity | undefined;
-    /**
-     * 拼接 port 实体的 id
-     */
-    protected getPortId(portType: WorkflowPortType, portKey?: string | number): string;
-    /**
-     * 创建 port 实体
-     */
-    protected createPortEntity(portInfo: WorkflowPort): WorkflowPortEntity;
-    /**
-     * 获取或创建 port 实体
-     */
-    protected getOrCreatePortEntity(portInfo: WorkflowPort): WorkflowPortEntity;
-    /**
-     * 更新 port 实体
-     */
-    protected updatePortEntity(portInfo: WorkflowPort): WorkflowPortEntity;
-}
-
-interface WorkflowNodeLines {
-    inputLines: WorkflowLineEntity[];
-    outputLines: WorkflowLineEntity[];
-}
-/**
- * 节点的关联的线条
- */
-declare class WorkflowNodeLinesData extends EntityData<WorkflowNodeLines> {
-    static type: string;
-    entity: WorkflowNodeEntity;
-    getDefaultData(): WorkflowNodeLines;
-    constructor(entity: WorkflowNodeEntity);
-    /**
-     * 输入线条
-     */
-    get inputLines(): WorkflowLineEntity[];
-    /**
-     * 输出线条
-     */
-    get outputLines(): WorkflowLineEntity[];
-    /**
-     * 输入节点
-     */
-    get inputNodes(): WorkflowNodeEntity[];
-    /**
-     * 所有输入节点
-     */
-    get allInputNodes(): WorkflowNodeEntity[];
-    /**
-     * 输出节点
-     */
-    get outputNodes(): WorkflowNodeEntity[];
-    /**
-     * 输入输出节点
-     */
-    get allOutputNodes(): WorkflowNodeEntity[];
-    addLine(line: WorkflowLineEntity): void;
-    removeLine(line: WorkflowLineEntity): void;
-}
-
-interface WorkflowLineRenderDataSchema {
-    version: string;
-    contributions: Map<LineRenderType, WorkflowLineRenderContribution>;
-    position: LinePosition;
-}
-declare class WorkflowLineRenderData extends EntityData<WorkflowLineRenderDataSchema> {
-    static type: string;
-    entity: WorkflowLineEntity;
-    constructor(entity: WorkflowLineEntity);
-    getDefaultData(): WorkflowLineRenderDataSchema;
-    get renderVersion(): string;
-    get position(): LinePosition;
-    get path(): string;
-    calcDistance(pos: IPoint): number;
-    get bounds(): Rectangle;
-    /**
-     * 更新数据
-     * WARNING: 这个方法，必须在 requestAnimationFrame / useLayoutEffect 中调用，否则会引起浏览器强制重排
-     */
-    update(): void;
-    private get lineType();
-    /**
-     * 更新版本
-     * WARNING: 这个方法，必须在 requestAnimationFrame / useLayoutEffect 中调用，否则会引起浏览器强制重排
-     */
-    private updatePosition;
-    private get currentLine();
-    private syncContributions;
-    private registerContribution;
-}
 
 declare const WorkflowDocumentContainerModule: ContainerModule;
 
-interface StraightData {
-    points: IPoint[];
-    path: string;
-    bbox: Rectangle;
-}
-declare class WorkflowSimpleLineContribution implements WorkflowLineRenderContribution {
-    static type: string;
-    entity: WorkflowLineEntity;
-    constructor(entity: WorkflowLineEntity);
-    private data?;
-    get path(): string;
-    calcDistance(pos: IPoint): number;
-    get bounds(): Rectangle;
-    update(params: {
-        fromPos: IPoint;
-        toPos: IPoint;
-    }): void;
-    private projectPointOnLine;
-}
-
-export { EditorCursorState, InteractiveType, LinePosition, LineRenderType, type NodeRenderReturnType, type PositionMap, type StraightData, WorkflowCommands, WorkflowDocument, WorkflowDocumentContainerModule, WorkflowLineEntity, WorkflowLineRenderContribution, WorkflowLineRenderData, type WorkflowLineRenderDataSchema, WorkflowNodeEntity, type WorkflowNodeLines, WorkflowNodeLinesData, WorkflowNodePortsData, WorkflowPort, WorkflowPortEntity, WorkflowPortType, WorkflowPorts, WorkflowResetLayoutService, WorkflowSimpleLineContribution, fitView, getAntiOverlapPosition, nanoid, useCurrentDomNode, useCurrentEntity, useNodeRender, usePlaygroundReadonlyState, useWorkflowDocument };
+export { EditorCursorState, InteractiveType, LineCenterPoint, LineEventProps, LinePosition, LineRenderType, NodePostionUpdateEvent, type NodeRenderReturnType, NodesDragEvent, OnDragLineEnd, type PositionMap, WorkflowCommands, WorkflowDocument, WorkflowDocumentContainerModule, WorkflowDocumentOptions, WorkflowDragService, WorkflowHoverService, WorkflowJSON, WorkflowLineEntity, WorkflowLineRenderContribution, WorkflowLineRenderData, type WorkflowLineRenderDataSchema, WorkflowLinesManager, WorkflowNodeEntity, WorkflowNodeJSON, WorkflowOperationBaseService, WorkflowOperationBaseServiceImpl, WorkflowPortEntity, WorkflowResetLayoutService, WorkflowSelectService, buildGroupJSON, fitView, getAntiOverlapPosition, getLineCenter, nanoid, useCurrentDomNode, useCurrentEntity, useNodeRender, usePlaygroundReadonlyState, useWorkflowDocument };