@html-graph/html-graph 9.0.0 → 9.2.0

package/dist/html-graph.d.ts

@@ -187,6 +187,7 @@ export declare class CanvasBuilder {
     private backgroundConfig;
     private connectablePortsConfig;
     private draggableEdgesConfig;
+    private rectangularSelectionConfig;
     private virtualScrollConfig;
     private layoutConfig;
     private animatedLayoutConfig;
@@ -199,6 +200,7 @@ export declare class CanvasBuilder {
     private hasBackground;
     private hasUserConnectablePorts;
     private hasUserDraggableEdges;
+    private hasRectangularSelection;
     private hasAnimatedLayout;
     private hasLayout;
     private readonly boxRenderingTrigger;
@@ -215,6 +217,7 @@ export declare class CanvasBuilder {
     enableBackground(config?: BackgroundConfig | undefined): CanvasBuilder;
     enableUserConnectablePorts(config?: ConnectablePortsConfig | undefined): CanvasBuilder;
     enableUserDraggableEdges(config?: DraggableEdgesConfig | undefined): CanvasBuilder;
+    enableRectangularSelection(config?: RectangularSelectionConfig | undefined): CanvasBuilder;
     enableLayout(config?: LayoutConfig | undefined): CanvasBuilder;
     enableAnimatedLayout(config?: AnimatedLayoutConfig | undefined): CanvasBuilder;
     enableUserSelectableNodes(config: UserSelectableNodesConfig): CanvasBuilder;
@@ -259,13 +262,15 @@ export declare interface CenterConfig {
 export declare type CenterFn = (width: number, height: number) => Point;
 
 export declare interface ConnectablePortsConfig {
-    readonly edgeShape?: EdgeShapeConfig;
-    readonly connectionTypeResolver?: ConnectionTypeResolver;
-    readonly connectionAllowedVerifier?: ConnectionAllowedVerifier;
-    readonly connectionPreprocessor?: ConnectionPreprocessor;
-    readonly mouseDownEventVerifier?: MouseEventVerifier;
-    readonly mouseUpEventVerifier?: MouseEventVerifier;
-    readonly dragPortDirection?: DraggingPortDirectionConfig;
+    readonly edgeShape?: EdgeShapeConfig | undefined;
+    readonly connectionTypeResolver?: ConnectionTypeResolver | undefined;
+    readonly connectionAllowedVerifier?: ConnectionAllowedVerifier | undefined;
+    readonly connectionPreprocessor?: ConnectionPreprocessor | undefined;
+    readonly mouseDownEventVerifier?: MouseEventVerifier | undefined;
+    readonly mouseUpEventVerifier?: MouseEventVerifier | undefined;
+    readonly dragPortDirection?: DraggingPortDirectionConfig | undefined;
+    readonly grabbedPortIdResolver?: PortIdResolver | undefined;
+    readonly releasedPortIdResolver?: PortIdResolver | undefined;
     readonly events?: {
         readonly onAfterEdgeCreated?: (edgeId: Identifier) => void;
         readonly onEdgeCreationInterrupted?: (params: EdgeCreationInProgressParams) => void;
@@ -343,13 +348,15 @@ declare interface DotsRenderer {
 }
 
 export declare interface DraggableEdgesConfig {
-    readonly connectionPreprocessor?: ConnectionPreprocessor;
-    readonly connectionAllowedVerifier?: ConnectionAllowedVerifier;
-    readonly mouseDownEventVerifier?: MouseEventVerifier;
-    readonly mouseUpEventVerifier?: MouseEventVerifier;
-    readonly draggingEdgeResolver?: DraggingEdgeResolver;
-    readonly draggingEdgeShape?: EdgeShapeConfig;
-    readonly dragPortDirection?: DraggingPortDirectionConfig;
+    readonly connectionPreprocessor?: ConnectionPreprocessor | undefined;
+    readonly connectionAllowedVerifier?: ConnectionAllowedVerifier | undefined;
+    readonly mouseDownEventVerifier?: MouseEventVerifier | undefined;
+    readonly mouseUpEventVerifier?: MouseEventVerifier | undefined;
+    readonly draggingEdgeResolver?: DraggingEdgeResolver | undefined;
+    readonly draggingEdgeShape?: EdgeShapeConfig | undefined;
+    readonly dragPortDirection?: DraggingPortDirectionConfig | undefined;
+    readonly grabbedPortIdResolver?: PortIdResolver | undefined;
+    readonly releasedPortIdResolver?: PortIdResolver | undefined;
     readonly events?: {
         readonly onAfterEdgeReattached?: (edgeId: Identifier) => void;
         readonly onEdgeReattachInterrupted?: (edge: GraphEdge & {
@@ -385,6 +392,8 @@ export declare interface EdgeCreationInProgressParams {
     readonly isDirect: boolean;
 }
 
+export declare type EdgeElement = HTMLElement | SVGSVGElement;
+
 declare interface EdgePath {
     readonly path: string;
     readonly midpoint: Point;
@@ -405,7 +414,7 @@ export declare interface EdgeRenderPort {
 }
 
 export declare interface EdgeShape {
-    readonly element: SVGSVGElement;
+    readonly element: EdgeElement;
     render(params: EdgeRenderParams): void;
 }
 
@@ -643,7 +652,7 @@ export declare interface InteractiveEdgeParams {
 
 export declare class InteractiveEdgeShape implements StructuredEdgeShape {
     private readonly baseEdge;
-    readonly element: SVGSVGElement;
+    readonly element: EdgeElement;
     readonly group: SVGGElement;
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
@@ -726,7 +735,7 @@ export declare class MidpointEdgeShape implements StructuredEdgeShape {
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
     readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
-    readonly element: SVGSVGElement;
+    readonly element: EdgeElement;
     constructor(baseShape: StructuredEdgeShape, midpointElement: SVGElement);
     render(params: EdgeRenderParams): void;
 }
@@ -802,6 +811,8 @@ export declare interface Point {
 
 export declare type PortElement = HTMLElement | SVGElement;
 
+export declare type PortIdResolver = (portIds: readonly Identifier[]) => Identifier | null;
+
 export declare type PortOffset = number | PortOffsetFn | "box";
 
 export declare type PortOffsetFn = (params: PortOffsetFnParams) => number;
@@ -820,6 +831,26 @@ export declare interface Radii {
     readonly vertical: number;
 }
 
+declare interface RectangularSelectionConfig {
+    readonly rectangleElement?: Element;
+    readonly mouseDownEventVerifier?: MouseEventVerifier;
+    readonly mouseUpEventVerifier?: MouseEventVerifier;
+    readonly onSelectionStarted?: () => void;
+    readonly onSelectionChange?: (selectionRectangle: DOMRect) => void;
+    readonly onSelectionInterrupted?: (selectionRectangle: DOMRect) => void;
+    readonly onSelectionFinished?: (selectionRectangle: DOMRect) => void;
+}
+
+export declare interface RectangularSelectionParams {
+    readonly rectangleElement: Element;
+    readonly mouseDownEventVerifier: MouseEventVerifier;
+    readonly mouseUpEventVerifier: MouseEventVerifier;
+    readonly onSelectionStarted: () => void;
+    readonly onSelectionChange: (selectionRectangle: DOMRect) => void;
+    readonly onSelectionInterrupted: (selectionRectangle: DOMRect) => void;
+    readonly onSelectionFinished: (selectionRectangle: DOMRect) => void;
+}
+
 export declare interface ScaleLimitPreprocessorParams {
     readonly minContentScale: number | null;
     readonly maxContentScale: number | null;
@@ -1044,7 +1075,7 @@ declare class ViewportController {
     constructor(graphStore: GraphStore, viewportStore: ViewportStore, params: ViewportControllerParams, win: Window);
     patchViewportMatrix(request: PatchMatrixRequest): void;
     patchContentMatrix(request: PatchMatrixRequest): void;
-    center(target: Point, config?: CenterConfig | undefined): void;
+    center(target: Point, config: CenterConfig | undefined): void;
     focus(config?: FocusConfig | undefined): void;
     destroy(): void;
     private navigate;