@blueking/flow-canvas 0.0.10 → 0.0.12

package/dist/index.d.ts

@@ -162,6 +162,12 @@ type CanvasUiEvent = {
 } | {
     type: 'node.dblclick';
     nodeId: string;
+} | {
+    type: 'node.mouseenter';
+    nodeId: string;
+} | {
+    type: 'node.mouseleave';
+    nodeId: string;
 } | {
     type: 'node.contextmenu';
     nodeId: string;
@@ -236,7 +242,16 @@ interface CanvasHistoryOptions {
 }
 
 interface OverlayManager {
+    /**
+     * 获取节点在 graph 容器内的 DOMRect（local-to-graph 坐标）。
+     * 适合用于同样渲染在 graph 容器内部的 overlay 定位。
+     */
     getNodeScreenRect(nodeId: string): DOMRect | null;
+    /**
+     * 获取节点在视口（viewport / client）中的 DOMRect。
+     * 适合用于 Teleport 到 body 的 position: fixed overlay 定位。
+     */
+    getNodeViewportRect(nodeId: string): DOMRect | null;
 }
 
 declare function generateId(): string;
@@ -365,11 +380,12 @@ interface InsertNodeOptions {
     label?: string;
     direction?: InsertDirection;
 }
+type ZoomToFitOptions = Parameters<Graph['zoomToFit']>[0];
 interface CanvasApi {
     zoomIn(): void;
     zoomOut(): void;
     zoomTo(value: number): void;
-    zoomToFit(): void;
+    zoomToFit(options?: ZoomToFitOptions): void;
     getZoom(): number;
     centerContent(): void;
     scrollToOrigin(): void;
@@ -427,6 +443,10 @@ interface QuickAddConfig {
     getPort?: QuickAddPortResolver;
     /** 点击 quick-add 插入节点时使用的方向；默认跟随绑定 port 的标准方向，不可推断时回退为 'right' */
     insertDirection?: InsertDirection | QuickAddInsertDirectionResolver;
+    /** 弹出 quick-add 面板时，如右侧超出浏览器可视区，则自动左移画布，默认 true */
+    autoPanOnOpen?: boolean;
+    /** autoPanOnOpen 生效时，弹层与浏览器右边缘保留的安全间距，默认 16px */
+    autoPanPadding?: number;
 }
 interface EdgeDropConfig {
     /** 全局开关，默认 false */
@@ -784,6 +804,8 @@ declare const _default$1: typeof __VLS_export$1;
 type __VLS_Props = {
     node: FlowNodeModel;
     portPosition: ScreenPosition;
+    autoPanOnOpen?: boolean;
+    autoPanPadding?: number;
 };
 declare function closePopover(): void;
 declare var __VLS_7: {};
@@ -798,12 +820,14 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
     mouseleave: () => any;
     open: (nodeId: string) => any;
     "start-drag": (nodeId: string) => any;
+    "viewport-overflow-right": (overflowRight: number) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
     onMouseenter?: (() => any) | undefined;
     onMouseleave?: (() => any) | undefined;
     onOpen?: ((nodeId: string) => any) | undefined;
     "onStart-drag"?: ((nodeId: string) => any) | undefined;
+    "onViewport-overflow-right"?: ((overflowRight: number) => any) | undefined;
 }>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
@@ -915,4 +939,4 @@ declare function minimapPlugin(options?: MinimapPluginOptions): CanvasPlugin;
 declare function clipboardPlugin(): CanvasPlugin;
 
 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, searchPlugin, 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, CoreToolbarType, DefaultNodeTypeConfig, DefaultSchemaOptions, DefaultSchemaResult, DefaultToolbarItemsOptions, DeleteSelectionOptions, EdgeDecoration, EdgeDropConfig, EdgeRenderState, EdgeStyle, EditorPluginContext, ExportOptions, FlowEdgeLabelModel, FlowEdgeModel, FlowModel, FlowModelChangeEvent, FlowNodeModel, FlowPortModel, GraphWithSelection, IdGenerator, InsertDirection, InsertNodeOptions, MinimapPluginOptions, NodeActionsConfig, NodeBehaviorConfig, NodeDecoration, NodePaletteItem, OverlayManager, PluginManagedToolbarType, QuickAddConfig, QuickAddInsertDirectionResolver, QuickAddPortResolver, RuntimePluginContext, ScreenPosition, SearchNodeMeta, SearchPluginOptions, SelectionPluginOptions, SnaplinePluginOptions };
+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, CoreToolbarType, DefaultNodeTypeConfig, DefaultSchemaOptions, DefaultSchemaResult, DefaultToolbarItemsOptions, DeleteSelectionOptions, EdgeDecoration, EdgeDropConfig, EdgeRenderState, EdgeStyle, EditorPluginContext, ExportOptions, FlowEdgeLabelModel, FlowEdgeModel, FlowModel, FlowModelChangeEvent, FlowNodeModel, FlowPortModel, GraphWithSelection, IdGenerator, InsertDirection, InsertNodeOptions, MinimapPluginOptions, NodeActionsConfig, NodeBehaviorConfig, NodeDecoration, NodePaletteItem, OverlayManager, PluginManagedToolbarType, QuickAddConfig, QuickAddInsertDirectionResolver, QuickAddPortResolver, RuntimePluginContext, ScreenPosition, SearchNodeMeta, SearchPluginOptions, SelectionPluginOptions, SnaplinePluginOptions, ZoomToFitOptions };