@blueking/flow-canvas 0.0.1-beta.4 → 0.0.1

package/dist/index.d.ts

@@ -320,6 +320,7 @@ interface InsertNodeOptions {
     gap?: number;
     source?: CommandSource;
     label?: string;
+    direction?: InsertDirection;
 }
 interface CanvasApi {
     zoomIn(): void;
@@ -345,10 +346,9 @@ interface CanvasApi {
     /** 收集所有插件为指定坐标提供的右键菜单项，由消费方自行渲染菜单 UI */
     getContextMenuItems(position: ScreenPosition): ContextMenuItem[];
     /**
-     * 在 sourceNode 右侧插入新节点。
-     * - 位置：水平 = sourceNode.right + gap，垂直居中对齐
-     * - autoWireEdges=true 时：若 sourceNode 的 right 端口已有出边，
-     *   删除该出边并创建 source→new 和 new→target 两条新边；
+     * 默认在 sourceNode 右侧插入新节点，也可通过 options.direction 指定 top/right/bottom/left。
+     * - 位置：根据 direction 沿对应方向插入，并在垂直/水平方向居中对齐
+     * - autoWireEdges=true 时：优先使用 direction 对应的 source 端口与新节点的反向端口自动连线；
      *   否则只创建 source→new 一条边
      * - 所有命令打包在一个 CommandEnvelope 中原子执行
      */
@@ -371,11 +371,20 @@ type ConnectionValidateResult = {
     reason?: string;
 };
 type ConnectionValidator = (ctx: ConnectionValidateContext) => ConnectionValidateResult;
+type InsertDirection = 'top' | 'right' | 'bottom' | 'left';
+type QuickAddPortResolver = (node: FlowNodeModel, ports: FlowPortModel[]) => string | FlowPortModel | null | undefined;
+type QuickAddInsertDirectionResolver = (node: FlowNodeModel, port: FlowPortModel | null) => InsertDirection | null | undefined;
 interface QuickAddConfig {
     /** 全局开关，默认 true */
     enabled?: boolean;
     /** "+"按钮 hover 时的 tooltip 文案 */
     tooltipText?: string;
+    /** quick-add 绑定的端口分组，默认 'right'；节点不存在该分组端口时将不显示 quick-add */
+    portGroup?: string;
+    /** 精确指定 quick-add 使用哪个端口；优先级高于 portGroup */
+    getPort?: QuickAddPortResolver;
+    /** 点击 quick-add 插入节点时使用的方向；默认跟随绑定 port 的标准方向，不可推断时回退为 'right' */
+    insertDirection?: InsertDirection | QuickAddInsertDirectionResolver;
 }
 interface NodePaletteItem {
     type: string;
@@ -733,6 +742,7 @@ interface DefaultToolbarItemsOptions {
  */
 declare function createDefaultToolbarItems(options?: DefaultToolbarItemsOptions): CanvasToolbarItem[];
 
+type BuiltinEdgeType = 'manhattan' | 'bezier';
 interface DefaultNodeTypeConfig {
     label?: string;
     icon?: string;
@@ -750,6 +760,7 @@ interface DefaultSchemaResult {
     schema: CanvasSchema;
     paletteItems: NodePaletteItem[];
 }
+declare function createBuiltinEdgeTypes(): Record<BuiltinEdgeType, CanvasEdgeDefinition>;
 /**
  * 创建内置的默认 Schema，提供开箱即用的节点与边类型。
  *
@@ -804,5 +815,5 @@ declare function clipboardPlugin(): CanvasPlugin;
 
 declare function generateId(): string;
 
-export { CanvasConstraintError, _default$5 as CanvasLayout, _default$3 as CanvasNodePalette, _default$6 as CanvasRuntime, CanvasSchemaError, _default$4 as CanvasToolbar, _default$2 as DefaultNode, _default$1 as NodeActionsToolbar, _default as NodeQuickAddPopover, applyCanvasCommand, clipboardPlugin, connectionValidatorPlugin, createCanvasHistory, createDefaultSchema, createDefaultToolbarItems, createEmptyFlowModel, generateId, minimapPlugin, selectionPlugin, snaplinePlugin, useCanvasEditor };
-export type { BuiltinToolbarType, CanvasApi, CanvasCallbackContext, CanvasCommand, CanvasEdgeDefinition, CanvasEditorContext, CanvasEditorOptions, CanvasHistory, CanvasHistoryOptions, CanvasMode, CanvasNodeDefinition, CanvasPlugin, CanvasPosition, CanvasSchema, CanvasSelection, CanvasToolbarItem, CanvasUiEvent, CommandEnvelope, CommandExecutionError, CommandExecutionResult, CommandPreview, CommandRejection, CommandSource, ConnectionValidateContext, ConnectionValidateResult, ConnectionValidator, ContextMenuItem, DefaultNodeTypeConfig, DefaultSchemaOptions, DefaultSchemaResult, DefaultToolbarItemsOptions, EdgeDecoration, EdgeRenderState, EdgeStyle, EditorPluginContext, ExportOptions, FlowEdgeLabelModel, FlowEdgeModel, FlowModel, FlowModelChangeEvent, FlowNodeModel, FlowPortModel, InsertNodeOptions, MinimapPluginOptions, NodeActionsConfig, NodeBehaviorConfig, NodeDecoration, NodePaletteItem, OverlayManager, QuickAddConfig, RuntimePluginContext, ScreenPosition, SelectionPluginOptions, SnaplinePluginOptions };
+export { CanvasConstraintError, _default$5 as CanvasLayout, _default$3 as CanvasNodePalette, _default$6 as CanvasRuntime, CanvasSchemaError, _default$4 as CanvasToolbar, _default$2 as DefaultNode, _default$1 as NodeActionsToolbar, _default as NodeQuickAddPopover, applyCanvasCommand, clipboardPlugin, connectionValidatorPlugin, createBuiltinEdgeTypes, createCanvasHistory, createDefaultSchema, createDefaultToolbarItems, createEmptyFlowModel, generateId, minimapPlugin, selectionPlugin, snaplinePlugin, useCanvasEditor };
+export type { BuiltinEdgeType, BuiltinToolbarType, CanvasApi, CanvasCallbackContext, CanvasCommand, CanvasEdgeDefinition, CanvasEditorContext, CanvasEditorOptions, CanvasHistory, CanvasHistoryOptions, CanvasMode, CanvasNodeDefinition, CanvasPlugin, CanvasPosition, CanvasSchema, CanvasSelection, CanvasToolbarItem, CanvasUiEvent, CommandEnvelope, CommandExecutionError, CommandExecutionResult, CommandPreview, CommandRejection, CommandSource, ConnectionValidateContext, ConnectionValidateResult, ConnectionValidator, ContextMenuItem, DefaultNodeTypeConfig, DefaultSchemaOptions, DefaultSchemaResult, DefaultToolbarItemsOptions, EdgeDecoration, EdgeRenderState, EdgeStyle, EditorPluginContext, ExportOptions, FlowEdgeLabelModel, FlowEdgeModel, FlowModel, FlowModelChangeEvent, FlowNodeModel, FlowPortModel, InsertDirection, InsertNodeOptions, MinimapPluginOptions, NodeActionsConfig, NodeBehaviorConfig, NodeDecoration, NodePaletteItem, OverlayManager, QuickAddConfig, QuickAddInsertDirectionResolver, QuickAddPortResolver, RuntimePluginContext, ScreenPosition, SelectionPluginOptions, SnaplinePluginOptions };