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

package/dist/workflow-node-entity-DH5qlw7I.d.mts

@@ -0,0 +1,1147 @@
+import { FlowNodeJSON, FlowNodeMeta, FlowDocumentOptions, FlowNodeType, FlowLayout, FlowDocumentProvider, FlowDocument, FlowNodeEntity, AddNodeData } from '@flowgram.ai/document';
+import { EntityManager, SelectionService, Playground, Entity, PlaygroundConfigEntity, PlaygroundContext, PlaygroundDragEvent, PlaygroundDrag, EntityOpts, EntityData } from '@flowgram.ai/core';
+import * as _flowgram_ai_utils from '@flowgram.ai/utils';
+import { Rectangle, IPoint, Emitter, PositionSchema, Event, PaddingSchema, SizeSchema, ScrollSchema, DisposableCollection } from '@flowgram.ai/utils';
+import React$1 from 'react';
+import { NodeEngineContext } from '@flowgram.ai/form-core';
+import { WorkflowEdgeJSON } from './typings/workflow-edge.mjs';
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+type WorkflowPortType = 'input' | 'output';
+declare const getPortEntityId: (node: WorkflowNodeEntity, portType: WorkflowPortType, portID?: string | number) => string;
+declare const WORKFLOW_LINE_ENTITY = "WorkflowLineEntity";
+declare function domReactToBounds(react: DOMRect): Rectangle;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * 子画布配置
+ */
+type WorkflowSubCanvas = {
+    isCanvas: boolean;
+    parentNode: WorkflowNodeEntity;
+    canvasNode: WorkflowNodeEntity;
+};
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * 节点 meta 信息
+ */
+interface WorkflowNodeMeta extends FlowNodeMeta {
+    position?: IPoint;
+    canvasPosition?: IPoint;
+    deleteDisable?: boolean;
+    copyDisable?: boolean;
+    inputDisable?: boolean;
+    outputDisable?: boolean;
+    defaultPorts?: WorkflowPorts;
+    useDynamicPort?: boolean;
+    subCanvas?: (node: WorkflowNodeEntity) => WorkflowSubCanvas | undefined;
+    isContainer?: boolean;
+}
+/**
+ * 节点数据
+ */
+interface WorkflowNodeJSON extends FlowNodeJSON {
+    id: string;
+    type: string | number;
+    /**
+     * ui 数据
+     */
+    meta?: WorkflowNodeMeta;
+    /**
+     * 表单数据
+     */
+    data?: any;
+    /**
+     * 子节点
+     */
+    blocks?: WorkflowNodeJSON[];
+    /**
+     * 子节点间连线
+     */
+    edges?: WorkflowEdgeJSON[];
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface WorkflowJSON {
+    nodes: WorkflowNodeJSON[];
+    edges: WorkflowEdgeJSON[];
+}
+declare enum WorkflowContentChangeType {
+    /**
+     * 添加节点
+     */
+    ADD_NODE = "ADD_NODE",
+    /**
+     * 删除节点
+     */
+    DELETE_NODE = "DELETE_NODE",
+    /**
+     * 移动节点
+     */
+    MOVE_NODE = "MOVE_NODE",
+    /**
+     * 节点数据更新 （表单引擎数据 或者 extInfo 数据）
+     */
+    NODE_DATA_CHANGE = "NODE_DATA_CHANGE",
+    /**
+     * 添加线条
+     */
+    ADD_LINE = "ADD_LINE",
+    /**
+     * 删除线条
+     */
+    DELETE_LINE = "DELETE_LINE",
+    /**
+     * 线条数据修改
+     */
+    LINE_DATA_CHANGE = "LINE_DATA_CHANGE",
+    /**
+     * 节点Meta信息变更
+     */
+    META_CHANGE = "META_CHANGE"
+}
+interface WorkflowContentChangeEvent {
+    type: WorkflowContentChangeType;
+    /**
+     * 当前触发的元素的json数据，toJSON 需要主动触发
+     */
+    toJSON: () => any;
+    /**
+     * oldValue
+     */
+    oldValue?: any;
+    entity: WorkflowNodeEntity | WorkflowLineEntity;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare const WorkflowDocumentOptions: unique symbol;
+/**
+ * 线条配置
+ */
+interface WorkflowDocumentOptions extends FlowDocumentOptions {
+    cursors?: {
+        grab?: string;
+        grabbing?: string;
+    };
+    /** 双向连接 */
+    twoWayConnection?: boolean;
+    /** 线条颜色 */
+    lineColor?: Partial<LineColor>;
+    /** 是否显示错误线条 */
+    isErrorLine?: (fromPort: WorkflowPortEntity | undefined, toPort: WorkflowPortEntity | undefined, lines: WorkflowLinesManager) => boolean;
+    /** 是否错误端口 */
+    isErrorPort?: (port: WorkflowPortEntity) => boolean;
+    /** 是否禁用端口 */
+    isDisabledPort?: (port: WorkflowPortEntity) => boolean;
+    /** 是否反转线条箭头 */
+    isReverseLine?: (line: WorkflowLineEntity) => boolean;
+    /** 是否隐藏线条箭头 */
+    isHideArrowLine?: (line: WorkflowLineEntity) => boolean;
+    /** 是否流动线条 */
+    isFlowingLine?: (line: WorkflowLineEntity) => boolean;
+    /** 是否禁用线条 */
+    isDisabledLine?: (line: WorkflowLineEntity) => boolean;
+    /** 拖拽线条结束 */
+    onDragLineEnd?: (params: onDragLineEndParams) => Promise<void>;
+    /** 获取线条渲染器 */
+    setLineRenderType?: (line: WorkflowLineEntity) => LineRenderType | undefined;
+    /** 设置线条样式 */
+    setLineClassName?: (line: WorkflowLineEntity) => string | undefined;
+    /** 能否添加线条 */
+    canAddLine?: (fromPort: WorkflowPortEntity, toPort: WorkflowPortEntity, lines: WorkflowLinesManager, silent?: boolean) => boolean;
+    /** 能否删除节点 */
+    canDeleteNode?: (node: WorkflowNodeEntity, silent?: boolean) => boolean;
+    /** 能否删除线条 */
+    canDeleteLine?: (line: WorkflowLineEntity, newLineInfo?: Required<Omit<WorkflowLinePortInfo, 'data'>>, silent?: boolean) => boolean;
+    /**
+     * @param fromPort - 开始点
+     * @param oldToPort - 旧的连接点
+     * @param newToPort - 新的连接点
+     * @param lines - 线条管理器
+     */
+    canResetLine?: (oldLine: WorkflowLineEntity, newLineInfo: Required<WorkflowLinePortInfo>, lines: WorkflowLinesManager) => boolean;
+    /**
+     * 是否允许拖入子画布 (loop or group)
+     * Whether to allow dragging into the sub-canvas (loop or group)
+     * @param params
+     */
+    canDropToNode?: (params: {
+        dragNodeType?: FlowNodeType;
+        dragNode?: WorkflowNodeEntity;
+        dropNode?: WorkflowNodeEntity;
+        dropNodeType?: FlowNodeType;
+    }) => boolean;
+}
+declare const WorkflowDocumentOptionsDefault: WorkflowDocumentOptions;
+
+/**
+ * 可 Hover 的节点 类型
+ */
+type WorkflowEntityHoverable = WorkflowNodeEntity | WorkflowLineEntity | WorkflowPortEntity;
+interface HoverPosition {
+    position: PositionSchema;
+    target?: HTMLElement;
+}
+/** @deprecated */
+type WorkfloEntityHoverable = WorkflowEntityHoverable;
+/**
+ * hover 状态管理
+ */
+declare class WorkflowHoverService {
+    protected entityManager: EntityManager;
+    protected onHoveredChangeEmitter: Emitter<string>;
+    protected onUpdateHoverPositionEmitter: Emitter<HoverPosition>;
+    readonly onHoveredChange: _flowgram_ai_utils.Event<string>;
+    readonly onUpdateHoverPosition: _flowgram_ai_utils.Event<HoverPosition>;
+    hoveredPos: PositionSchema;
+    /**
+     * 当前 hovered 的 节点或者线条或者点
+     * 1: nodeId / lineId  （节点 / 线条）
+     * 2: nodeId:portKey  （节点连接点）
+     */
+    hoveredKey: string;
+    /**
+     * 更新 hover 的内容
+     * @param hoveredKey hovered key
+     */
+    updateHoveredKey(hoveredKey: string): void;
+    updateHoverPosition(position: PositionSchema, target?: HTMLElement): void;
+    /**
+     * 清空 hover 内容
+     */
+    clearHovered(): void;
+    /**
+     *  判断是否 hover
+     * @param nodeId hoveredKey
+     * @returns 是否 hover
+     */
+    isHovered(nodeId: string): boolean;
+    isSomeHovered(): boolean;
+    /**
+     * 获取被 hover 的节点或线条
+     * @deprecated use 'someHovered' instead
+     */
+    get hoveredNode(): WorkflowEntityHoverable | undefined;
+    /**
+     * 获取被 hover 的节点或线条
+     */
+    get someHovered(): WorkflowEntityHoverable | undefined;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare class WorkflowSelectService {
+    protected selectionService: SelectionService;
+    protected playground: Playground;
+    get onSelectionChanged(): Event<void>;
+    get selection(): Entity[];
+    set selection(entities: Entity[]);
+    /**
+     * 当前激活的节点只能有一个
+     */
+    get activatedNode(): WorkflowNodeEntity | undefined;
+    isSelected(id: string): boolean;
+    isActivated(id: string): boolean;
+    /**
+     * 选中的节点
+     */
+    get selectedNodes(): WorkflowNodeEntity[];
+    /**
+     * 选中
+     * @param node
+     */
+    selectNode(node: WorkflowNodeEntity): void;
+    toggleSelect(node: WorkflowNodeEntity): void;
+    select(node: WorkfloEntityHoverable): void;
+    clear(): void;
+    /**
+     *  选中并滚动到节点
+     * @param node
+     */
+    selectNodeAndScrollToView(node: WorkflowNodeEntity, fitView?: boolean): Promise<void>;
+    selectNodeAndFocus(node: WorkflowNodeEntity): void;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * 自由画布布局
+ */
+declare class FreeLayout implements FlowLayout {
+    name: string;
+    playgroundConfig: PlaygroundConfigEntity;
+    protected documentProvider: FlowDocumentProvider;
+    get document(): FlowDocument;
+    /**
+     * 更新布局
+     */
+    update(): void;
+    syncTransform(node: FlowNodeEntity): void;
+    /**
+     * 更新所有受影响的上下游节点
+     */
+    updateAffectedTransform(node: FlowNodeEntity): void;
+    /**
+     * 获取节点的 padding 数据
+     * @param node
+     */
+    getPadding(node: FlowNodeEntity): PaddingSchema;
+    /**
+     * 默认滚动到 fitview 区域
+     * @param contentSize
+     */
+    getInitScroll(contentSize: SizeSchema): ScrollSchema;
+    /**
+     * 获取默认输入点
+     */
+    getDefaultInputPoint(node: FlowNodeEntity): IPoint;
+    /**
+     * 获取默认输出点
+     */
+    getDefaultOutputPoint(node: FlowNodeEntity): IPoint;
+    /**
+     * 水平中心点
+     */
+    getDefaultNodeOrigin(): IPoint;
+    private getAllParents;
+    private getAllBlocks;
+    private fireChange;
+}
+
+declare const WorkflowDocumentProvider: unique symbol;
+type WorkflowDocumentProvider = () => WorkflowDocument;
+declare class WorkflowDocument extends FlowDocument {
+    private _onContentChangeEmitter;
+    protected readonly onLoadedEmitter: Emitter<void>;
+    readonly onContentChange: _flowgram_ai_utils.Event<WorkflowContentChangeEvent>;
+    private _onReloadEmitter;
+    readonly onReload: _flowgram_ai_utils.Event<WorkflowDocument>;
+    /**
+     * 数据加载完成
+     */
+    readonly onLoaded: _flowgram_ai_utils.Event<void>;
+    protected _loading: boolean;
+    linesManager: WorkflowLinesManager;
+    playgroundConfig: PlaygroundConfigEntity;
+    playgroundContext: PlaygroundContext;
+    options: WorkflowDocumentOptions;
+    nodeEngineContext: NodeEngineContext;
+    selectServices: WorkflowSelectService;
+    get loading(): boolean;
+    /**
+     * use `ctx.tools.fitView()` instead
+     * @deprecated
+     * @param easing
+     */
+    fitView(easing?: boolean): Promise<void>;
+    init(): void;
+    load(): Promise<void>;
+    /**
+     * @deprecated use `ctx.operation.fromJSON` instead
+     */
+    reload(json: WorkflowJSON, delayTime?: number): Promise<void>;
+    /**
+     * 从数据加载
+     * @param json
+     */
+    fromJSON(json: Partial<WorkflowJSON>, fireRender?: boolean): void;
+    /**
+     * 清空画布
+     */
+    clear(): void;
+    /**
+     * 创建流程节点
+     * @param json
+     */
+    createWorkflowNode(json: WorkflowNodeJSON, 
+    /** @deprecated */
+    isClone?: boolean, parentID?: string): WorkflowNodeEntity;
+    /**
+     * 创建流程节点
+     * @param json
+     */
+    private _createWorkflowNode;
+    /**
+     * 添加节点，如果节点已经存在则不会重复创建
+     * @param data
+     * @param addedNodes
+     */
+    addNode(data: AddNodeData, addedNodes?: WorkflowNodeEntity[], ignoreCreateAndUpdateEvent?: boolean): WorkflowNodeEntity;
+    get layout(): FreeLayout;
+    /**
+     * 获取默认的 x y 坐标, 默认为当前画布可视区域中心
+     * @param type
+     * @protected
+     */
+    getNodeDefaultPosition(type: string | number): IPoint;
+    /**
+     * 通过类型创建节点, 如果没有提供position 则直接放在画布中间
+     * @param type
+     */
+    createWorkflowNodeByType(type: string | number, position?: IPoint, json?: Partial<WorkflowNodeJSON>, parentID?: string): WorkflowNodeEntity;
+    getAllNodes(): WorkflowNodeEntity[];
+    getAllEdges(): WorkflowLineEntity[];
+    getAllPorts(): WorkflowPortEntity[];
+    /**
+     * 获取画布中的非游离节点
+     * 1. 开始节点
+     * 2. 从开始节点出发能走到的节点
+     * 3. 结束节点
+     * 4. 默认所有子画布内节点为游离节点
+     */
+    getAssociatedNodes(): WorkflowNodeEntity[];
+    /**
+     * 触发渲染
+     */
+    fireRender(): void;
+    fireContentChange(event: WorkflowContentChangeEvent): void;
+    toNodeJSON(node: WorkflowNodeEntity): WorkflowNodeJSON;
+    /**
+     * 节点转换为JSON， 没有format的过程
+     * @param node
+     * @returns
+     */
+    private toNodeJSONFromOptions;
+    copyNode(node: WorkflowNodeEntity, newNodeId?: string | undefined, format?: (json: WorkflowNodeJSON) => WorkflowNodeJSON, position?: IPoint): WorkflowNodeEntity;
+    copyNodeFromJSON(flowNodeType: string, nodeJSON: WorkflowNodeJSON, newNodeId?: string | undefined, position?: IPoint, parentID?: string): WorkflowNodeEntity;
+    canRemove(node: WorkflowNodeEntity, silent?: boolean): boolean;
+    /**
+     * 判断端口是否为错误态
+     */
+    isErrorPort(port: WorkflowPortEntity, defaultValue?: boolean): boolean;
+    /**
+     * 导出数据
+     */
+    toJSON(): WorkflowJSON;
+    dispose(): void;
+    /**
+     * 批量添加节点
+     * @deprecated use 'batchAddFromJSON' instead
+     * @param json
+     * @param options
+     */
+    renderJSON(json: WorkflowJSON, options?: {
+        parent?: WorkflowNodeEntity;
+        /** @deprecated useless api */
+        isClone?: boolean;
+    }): {
+        nodes: WorkflowNodeEntity[];
+        edges: WorkflowLineEntity[];
+    };
+    /**
+     * 批量添加节点
+     */
+    batchAddFromJSON(json: WorkflowJSON, options?: {
+        parent?: WorkflowNodeEntity;
+        onNodeCreated?: (node: WorkflowNodeEntity) => void;
+        onEdgeCreated?: (edge: WorkflowLineEntity) => void;
+    }): {
+        nodes: WorkflowNodeEntity[];
+        edges: WorkflowLineEntity[];
+    };
+    private getNodeSubCanvas;
+    private getNodeChildren;
+    private toLineJSON;
+    private createWorkflowLine;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare enum LineType {
+    BEZIER = 0,// 贝塞尔曲线
+    LINE_CHART = 1,// 折叠线
+    STRAIGHT = 2
+}
+type LineRenderType = LineType | string;
+type LinePointLocation = 'left' | 'top' | 'right' | 'bottom';
+interface LinePoint {
+    x: number;
+    y: number;
+    location: LinePointLocation;
+}
+interface LinePosition {
+    from: LinePoint;
+    to: LinePoint;
+}
+interface LineColor {
+    hidden: string;
+    default: string;
+    drawing: string;
+    hovered: string;
+    selected: string;
+    error: string;
+    flowing: string;
+}
+declare enum LineColors {
+    HIDDEN = "var(--g-workflow-line-color-hidden,transparent)",// 隐藏线条
+    DEFUALT = "var(--g-workflow-line-color-default,#4d53e8)",
+    DRAWING = "var(--g-workflow-line-color-drawing, #5DD6E3)",// '#b5bbf8', // '#9197F1',
+    HOVER = "var(--g-workflow-line-color-hover,#37d0ff)",
+    SELECTED = "var(--g-workflow-line-color-selected,#37d0ff)",
+    ERROR = "var(--g-workflow-line-color-error,red)",
+    FLOWING = "var(--g-workflow-line-color-flowing,#4d53e8)"
+}
+interface LineCenterPoint {
+    x: number;
+    y: number;
+    labelX: number;
+    labelY: number;
+}
+interface WorkflowLineRenderContribution {
+    entity: WorkflowLineEntity;
+    path: string;
+    center?: LineCenterPoint;
+    bounds: Rectangle;
+    update: (params: {
+        fromPos: LinePoint;
+        toPos: LinePoint;
+    }) => void;
+    calcDistance: (pos: IPoint) => number;
+}
+type WorkflowLineRenderContributionFactory = (new (entity: WorkflowLineEntity) => WorkflowLineRenderContribution) & {
+    type: LineRenderType;
+};
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+interface LineEventProps {
+    type: 'onDrag' | 'onDragEnd';
+    onDragNodeId?: string;
+    event?: MouseEvent;
+}
+interface INodesDragEvent {
+    type: string;
+    nodes: FlowNodeEntity[];
+    startPositions: PositionSchema[];
+    dragEvent: PlaygroundDragEvent;
+    triggerEvent: MouseEvent | React$1.MouseEvent;
+    dragger: PlaygroundDrag;
+}
+interface NodesDragStartEvent extends INodesDragEvent {
+    type: 'onDragStart';
+}
+interface NodesDragEndEvent extends INodesDragEvent {
+    type: 'onDragEnd';
+}
+interface NodesDraggingEvent extends INodesDragEvent {
+    type: 'onDragging';
+    positions: PositionSchema[];
+}
+type NodesDragEvent = NodesDragStartEvent | NodesDraggingEvent | NodesDragEndEvent;
+type onDragLineEndParams = {
+    fromPort?: WorkflowPortEntity;
+    toPort?: WorkflowPortEntity;
+    mousePos: PositionSchema;
+    line?: WorkflowLineEntity;
+    originLine?: WorkflowLineEntity;
+    event: PlaygroundDragEvent;
+};
+type OnDragLineEnd = (params: onDragLineEndParams) => Promise<void>;
+
+/**
+ * 线条管理
+ */
+declare class WorkflowLinesManager {
+    protected document: WorkflowDocument;
+    protected toDispose: DisposableCollection;
+    protected _lineType: LineRenderType;
+    protected onAvailableLinesChangeEmitter: Emitter<WorkflowContentChangeEvent>;
+    protected onForceUpdateEmitter: Emitter<void>;
+    hoverService: WorkflowHoverService;
+    selectService: WorkflowSelectService;
+    protected readonly entityManager: EntityManager;
+    readonly options: WorkflowDocumentOptions;
+    /**
+     * 有效的线条被添加或者删除时候触发，未连上的线条不算
+     */
+    readonly onAvailableLinesChange: _flowgram_ai_utils.Event<WorkflowContentChangeEvent>;
+    /**
+     * 强制渲染 lines
+     */
+    readonly onForceUpdate: _flowgram_ai_utils.Event<void>;
+    readonly contributionFactories: WorkflowLineRenderContributionFactory[];
+    init(doc: WorkflowDocument): void;
+    forceUpdate(): void;
+    get lineType(): LineRenderType;
+    get lineColor(): LineColor;
+    switchLineType(newType?: LineRenderType): LineRenderType;
+    getAllLines(): WorkflowLineEntity[];
+    getAllAvailableLines(): WorkflowLineEntity[];
+    hasLine(portInfo: Omit<WorkflowLinePortInfo, 'data'>): boolean;
+    getLine(portInfo: Omit<WorkflowLinePortInfo, 'data'>): WorkflowLineEntity | undefined;
+    getLineById(id: string): WorkflowLineEntity | undefined;
+    replaceLine(oldPortInfo: Omit<WorkflowLinePortInfo, 'data'>, newPortInfo: Omit<WorkflowLinePortInfo, 'data'>): WorkflowLineEntity;
+    createLine(options: {
+        drawingTo?: LinePoint;
+        drawingFrom?: LinePoint;
+        key?: string;
+    } & WorkflowLinePortInfo): WorkflowLineEntity | undefined;
+    /**
+     * 获取线条中距离鼠标位置最近的线条和距离
+     * @param mousePos 鼠标位置
+     * @param minDistance 最小检测距离
+     * @returns 距离鼠标位置最近的线条 以及距离
+     */
+    getCloseInLineFromMousePos(mousePos: IPoint, minDistance?: number): WorkflowLineEntity | undefined;
+    /**
+     * 是否在调整线条
+     */
+    isDrawing: boolean;
+    dispose(): void;
+    get disposed(): boolean;
+    isErrorLine(fromPort?: WorkflowPortEntity, toPort?: WorkflowPortEntity, defaultValue?: boolean): boolean;
+    isReverseLine(line: WorkflowLineEntity, defaultValue?: boolean): boolean;
+    isHideArrowLine(line: WorkflowLineEntity, defaultValue?: boolean): boolean;
+    isFlowingLine(line: WorkflowLineEntity, defaultValue?: boolean): boolean;
+    isDisabledLine(line: WorkflowLineEntity, defaultValue?: boolean): boolean;
+    setLineRenderType(line: WorkflowLineEntity): LineRenderType | undefined;
+    setLineClassName(line: WorkflowLineEntity): string | undefined;
+    getLineColor(line: WorkflowLineEntity): string | undefined;
+    canAddLine(fromPort: WorkflowPortEntity, toPort: WorkflowPortEntity, silent?: boolean): boolean;
+    toJSON(): WorkflowEdgeJSON[];
+    getPortById(portId: string): WorkflowPortEntity | undefined;
+    canRemove(line: WorkflowLineEntity, newLineInfo?: Required<Omit<WorkflowLinePortInfo, 'data'>>, silent?: boolean): boolean;
+    canReset(oldLine: WorkflowLineEntity, newLineInfo: Required<WorkflowLinePortInfo>): boolean;
+    /**
+     * 根据鼠标位置找到 port
+     * @param pos
+     */
+    getPortFromMousePos(pos: IPoint, portType?: WorkflowPortType): WorkflowPortEntity | undefined;
+    /**
+     * 根据鼠标位置找到 node
+     * @param pos - 鼠标位置
+     */
+    getNodeFromMousePos(pos: IPoint): WorkflowNodeEntity | undefined;
+    registerContribution(factory: WorkflowLineRenderContributionFactory): this;
+    private registerData;
+    private getSortedNodes;
+    /** 获取鼠标坐标位置的所有节点（stackIndex 从小到大排序） */
+    private getContainNodesFromMousePos;
+    private getNodeIndex;
+}
+
+declare const LINE_HOVER_DISTANCE = 8;
+declare const POINT_RADIUS = 10;
+interface WorkflowLinePortInfo {
+    from?: string;
+    to?: string;
+    fromPort?: string | number;
+    toPort?: string | number;
+    data?: any;
+}
+interface WorkflowLineEntityOpts extends EntityOpts, WorkflowLinePortInfo {
+    document: WorkflowDocument;
+    linesManager: WorkflowLinesManager;
+    drawingTo?: LinePoint;
+    drawingFrom?: LinePoint;
+}
+interface WorkflowLineInfo extends WorkflowLinePortInfo {
+    drawingTo?: LinePoint;
+    drawingFrom?: LinePoint;
+}
+interface WorkflowLineUIState {
+    /**
+     * 是否出错
+     */
+    hasError: boolean;
+    /**
+     * 流动
+     */
+    flowing: boolean;
+    /**
+     * 禁用
+     */
+    disabled: boolean;
+    /**
+     * 箭头反转
+     */
+    reverse: boolean;
+    /**
+     * 隐藏箭头
+     */
+    hideArrow: boolean;
+    /**
+     * 线条宽度
+     * @default 2
+     */
+    strokeWidth?: number;
+    /**
+     * 选中后的线条宽度
+     * @default 3
+     */
+    strokeWidthSelected?: number;
+    /**
+     * 收缩
+     * @default 10
+     */
+    shrink: number;
+    /**
+     * @deprecated use `lockedColor` instead
+     */
+    highlightColor: string;
+    /**
+     * 曲率
+     * only for Bezier,
+     * @default 0.25
+     */
+    curvature: number;
+    /**
+     * Line locked color
+     */
+    lockedColor: string;
+    /**
+     * React className
+     */
+    className?: string;
+    /**
+     * React style
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 线条
+ */
+declare class WorkflowLineEntity extends Entity<WorkflowLineEntityOpts> {
+    static type: string;
+    /**
+     * 转成线条 id
+     * @param info
+     */
+    static portInfoToLineId(info: WorkflowLinePortInfo): string;
+    private _onLineDataChangeEmitter;
+    readonly document: WorkflowDocument;
+    readonly linesManager: WorkflowLinesManager;
+    readonly onLineDataChange: _flowgram_ai_utils.Event<{
+        oldValue: any;
+        newValue: any;
+    }>;
+    private _from?;
+    private _to?;
+    private _lineData;
+    private _uiState;
+    /**
+     * 线条的 UI 状态
+     */
+    get uiState(): WorkflowLineUIState;
+    /**
+     * 更新线条的 ui 状态
+     * @param newState
+     */
+    updateUIState(newState: Partial<WorkflowLineUIState>): void;
+    /**
+     * 线条的扩展数据
+     */
+    get lineData(): any;
+    /**
+     * 更新线条扩展数据
+     * @param data
+     */
+    set lineData(newValue: any);
+    stackIndex: number;
+    /**
+     * 线条数据
+     */
+    info: WorkflowLineInfo;
+    readonly isDrawing: boolean;
+    /**
+     * 线条 Portal 挂载的 div
+     */
+    private _node?;
+    constructor(opts: WorkflowLineEntityOpts);
+    /**
+     * 获取线条的前置节点
+     */
+    get from(): WorkflowNodeEntity | undefined;
+    /**
+     * 获取线条的后置节点
+     */
+    get to(): WorkflowNodeEntity | undefined;
+    get isHidden(): boolean;
+    get inContainer(): boolean;
+    /**
+     * 获取是否 testrun processing
+     * @deprecated  use `flowing` instead
+     */
+    get processing(): boolean;
+    /**
+     * 设置 testrun processing 状态
+     * @deprecated  use `flowing` instead
+     */
+    set processing(status: boolean);
+    get hasError(): boolean;
+    set hasError(hasError: boolean);
+    /**
+     * 设置线条的后置节点
+     */
+    setToPort(toPort?: WorkflowPortEntity): void;
+    setFromPort(fromPort?: WorkflowPortEntity): void;
+    /**
+     * 设置线条画线时的目标位置
+     */
+    set drawingTo(pos: LinePoint | undefined);
+    set drawingFrom(pos: LinePoint | undefined);
+    get drawingFrom(): LinePoint | undefined;
+    /**
+     * 获取线条正在画线的位置
+     */
+    get drawingTo(): LinePoint | undefined;
+    get highlightColor(): string;
+    set highlightColor(highlightColor: string);
+    get lockedColor(): string;
+    set lockedColor(lockedColor: string);
+    /**
+     * 获取线条的边框位置大小
+     */
+    get bounds(): Rectangle;
+    get center(): LineCenterPoint;
+    /**
+     * 获取点和线最接近的距离
+     */
+    getHoverDist(pos: IPoint): number;
+    get fromPort(): WorkflowPortEntity | undefined;
+    get toPort(): WorkflowPortEntity | undefined;
+    /**
+     * 获取线条真实的输入输出节点坐标
+     */
+    get position(): LinePosition;
+    /** 是否反转箭头 */
+    get reverse(): boolean;
+    /** 是否隐藏箭头 */
+    get hideArrow(): boolean;
+    /** 是否流动 */
+    get flowing(): boolean;
+    set flowing(flowing: boolean);
+    /** 是否禁用 */
+    get disabled(): boolean;
+    /**
+     * @deprecated
+     */
+    get vertical(): boolean;
+    /** 获取线条渲染器类型 */
+    get renderType(): LineRenderType | undefined;
+    /** 获取线条样式 */
+    get className(): string;
+    get color(): string | undefined;
+    /**
+     * 初始化线条
+     * @param info 线条信息
+     */
+    protected initInfo(info: WorkflowLineInfo): void;
+    validate(): void;
+    /**
+     * use `validate` instead
+     * @deprecated
+     */
+    protected validateSelf(): void;
+    is(line: WorkflowLineEntity | WorkflowLinePortInfo): boolean;
+    canRemove(newLineInfo?: Required<WorkflowLinePortInfo>): boolean;
+    get node(): HTMLDivElement;
+    toJSON(): WorkflowEdgeJSON;
+    /** 触发线条渲染 */
+    fireRender(): void;
+}
+
+declare const PORT_SIZE = 24;
+interface WorkflowPort {
+    /**
+     * 没有代表 默认连接点，默认 input 类型 为最左边中心，output 类型为最右边中心
+     */
+    portID?: string | number;
+    /**
+     * 输入或者输出点
+     */
+    type: WorkflowPortType;
+    /**
+     * 端口位置
+     */
+    location?: LinePointLocation;
+    /**
+     * 端口位置配置
+     * @example
+     *  // bottom-center
+     *  {
+     *    left: '50%',
+     *    bottom: 0
+     *  }
+     *  // right-center
+     *  {
+     *    right: 0,
+     *    top: '50%'
+     *  }
+     */
+    locationConfig?: {
+        left?: string | number;
+        top?: string | number;
+        right?: string | number;
+        bottom?: string | number;
+    };
+    /**
+     * 相对于 location 的偏移
+     */
+    offset?: IPoint;
+    /**
+     * 端口热区大小
+     */
+    size?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * 禁用端口
+     */
+    disabled?: boolean;
+    /**
+     * 将点位渲染到该父节点上
+     */
+    targetElement?: HTMLElement;
+}
+type WorkflowPorts = WorkflowPort[];
+interface WorkflowPortEntityOpts extends EntityOpts, WorkflowPort {
+    /**
+     * port 属于哪个节点
+     */
+    node: WorkflowNodeEntity;
+}
+/**
+ * Port 抽象的 Entity
+ */
+declare class WorkflowPortEntity extends Entity<WorkflowPortEntityOpts> {
+    static type: string;
+    readonly node: WorkflowNodeEntity;
+    readonly portID: string | number;
+    readonly portType: WorkflowPortType;
+    private _disabled?;
+    private _hasError;
+    private _location?;
+    private _locationConfig?;
+    private _size?;
+    private _offset?;
+    protected readonly _onErrorChangedEmitter: Emitter<void>;
+    onErrorChanged: _flowgram_ai_utils.Event<void>;
+    targetElement?: HTMLElement;
+    static getPortEntityId(node: WorkflowNodeEntity, portType: WorkflowPortType, portID?: string | number): string;
+    get position(): LinePointLocation | undefined;
+    constructor(opts: WorkflowPortEntityOpts);
+    get hasError(): boolean;
+    set hasError(hasError: boolean);
+    validate(): void;
+    isErrorPort(): boolean;
+    get location(): LinePointLocation;
+    get point(): LinePoint;
+    /**
+     * 端口热区
+     */
+    get bounds(): Rectangle;
+    isHovered(x: number, y: number): boolean;
+    /**
+     * 相对节点左上角的位置
+     */
+    get relativePosition(): IPoint;
+    updateTargetElement(el?: HTMLElement): void;
+    /**
+     * 是否被禁用
+     */
+    get disabled(): boolean;
+    /**
+     * 当前点位上连接的线条
+     * @deprecated use `availableLines` instead
+     */
+    get lines(): WorkflowLineEntity[];
+    /**
+     * 当前有效的线条，不包含正在画的线条和隐藏的线条（这个出现在线条重连会先把原来的线条隐藏）
+     */
+    get availableLines(): WorkflowLineEntity[];
+    /**
+     * 当前点位上连接的线条（包含 isDrawing === true 的线条）
+     */
+    get allLines(): WorkflowLineEntity[];
+    update(data: Exclude<WorkflowPort, 'portID' | 'type'>): void;
+    dispose(): void;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * 节点的点位信息
+ * portsData 只监听点位的数目和类型，不监听点位的 position 变化
+ */
+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;
+    /**
+     * Update all ports data, includes static ports and dynamic ports
+     * @param ports
+     */
+    updateAllPorts(ports?: WorkflowPorts): void;
+    /**
+     * @deprecated use `updateAllPorts` instead
+     */
+    updateStaticPorts(ports: WorkflowPorts): void;
+    /**
+     * 动态计算点位，通过 dom 的 data-port-key
+     */
+    updateDynamicPorts(): void;
+    /**
+     * 根据 key 获取 port 实体
+     */
+    getPortEntityByKey(portType: WorkflowPortType, portKey?: string | number): WorkflowPortEntity;
+    /**
+     * 更新 ports 数据
+     */
+    protected updatePorts(ports: WorkflowPorts): void;
+    /**
+     * 获取所有 port entities
+     */
+    get allPorts(): WorkflowPortEntity[];
+    /**
+     * 获取输入点位
+     */
+    get inputPorts(): WorkflowPortEntity[];
+    /**
+     * 获取输出点位
+     */
+    get outputPorts(): WorkflowPortEntity[];
+    /**
+     * 获取输入点位置
+     */
+    get inputPoints(): LinePoint[];
+    /**
+     * 获取输出点位置
+     */
+    get outputPoints(): LinePoint[];
+    /**
+     * 根据 key 获取 输入点位置
+     */
+    getInputPoint(key?: string | number): LinePoint;
+    /**
+     * 根据 key 获取输出点位置
+     */
+    getOutputPoint(key?: string | number): LinePoint;
+    /**
+     * 获取 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;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+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 allLines(): WorkflowLineEntity[];
+    get availableLines(): WorkflowLineEntity[];
+    /**
+     * 输入节点
+     */
+    get inputNodes(): WorkflowNodeEntity[];
+    /**
+     * 所有输入节点
+     */
+    get allInputNodes(): WorkflowNodeEntity[];
+    /**
+     * 输出节点
+     */
+    get outputNodes(): WorkflowNodeEntity[];
+    /**
+     * 输入输出节点
+     */
+    get allOutputNodes(): WorkflowNodeEntity[];
+    addLine(line: WorkflowLineEntity): void;
+    removeLine(line: WorkflowLineEntity): void;
+}
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+declare module '@flowgram.ai/document' {
+    interface FlowNodeEntity {
+        lines: WorkflowNodeLinesData;
+        ports: WorkflowNodePortsData;
+    }
+}
+type WorkflowNodeEntity = FlowNodeEntity;
+declare const WorkflowNodeEntity: typeof FlowNodeEntity;
+
+export { type WorkflowSubCanvas as A, type NodesDragStartEvent as B, type NodesDragEndEvent as C, type NodesDraggingEvent as D, type onDragLineEndParams as E, LINE_HOVER_DISTANCE as F, type WorkflowLinePortInfo as G, type WorkflowLineEntityOpts as H, type WorkflowLineInfo as I, type WorkflowLineUIState as J, PORT_SIZE as K, type LineCenterPoint as L, type WorkflowPort as M, type NodesDragEvent as N, type OnDragLineEnd as O, POINT_RADIUS as P, type WorkflowPorts as Q, type WorkflowPortEntityOpts as R, WorkflowNodePortsData as S, type WorkflowNodeLines as T, WorkflowNodeLinesData as U, type WorkflowEntityHoverable as V, type WorkflowJSON as W, type HoverPosition as X, type WorkfloEntityHoverable as Y, WorkflowDocumentProvider as Z, WorkflowDocumentOptionsDefault as _, WorkflowDocument as a, WorkflowNodeEntity as b, WorkflowHoverService as c, WorkflowLinesManager as d, WorkflowSelectService as e, WorkflowDocumentOptions as f, type LineEventProps as g, type WorkflowNodeJSON as h, WorkflowPortEntity as i, WorkflowLineEntity as j, type LineRenderType as k, type WorkflowLineRenderContribution as l, type LinePosition as m, type WorkflowPortType as n, getPortEntityId as o, WORKFLOW_LINE_ENTITY as p, domReactToBounds as q, WorkflowContentChangeType as r, type WorkflowContentChangeEvent as s, type WorkflowNodeMeta as t, LineType as u, type LinePointLocation as v, type LinePoint as w, type LineColor as x, LineColors as y, type WorkflowLineRenderContributionFactory as z };