@html-graph/html-graph 8.15.1 → 8.17.0

package/dist/html-graph.d.ts

@@ -191,6 +191,7 @@ export declare class CanvasBuilder {
     private layoutConfig;
     private animatedLayoutConfig;
     private userSelectableNodesConfig;
+    private userSelectableEdgesConfig;
     private userSelectableCanvasConfig;
     private hasDraggableNodes;
     private hasTransformableViewport;
@@ -204,6 +205,7 @@ export declare class CanvasBuilder {
     private readonly window;
     private readonly animationStaticNodes;
     private readonly pointInsideVerifier;
+    private readonly eventTagger;
     constructor(element: HTMLElement);
     setDefaults(defaults: CanvasDefaults): CanvasBuilder;
     enableUserDraggableNodes(config?: DraggableNodesConfig | undefined): CanvasBuilder;
@@ -216,6 +218,7 @@ export declare class CanvasBuilder {
     enableLayout(config?: LayoutConfig | undefined): CanvasBuilder;
     enableAnimatedLayout(config?: AnimatedLayoutConfig | undefined): CanvasBuilder;
     enableUserSelectableNodes(config: UserSelectableNodesConfig): CanvasBuilder;
+    enableUserSelectableEdges(config: UserSelectableEdgesConfig): CanvasBuilder;
     enableUserSelectableCanvas(config: UserSelectableCanvasConfig): CanvasBuilder;
     build(): Canvas;
     private createHtmlView;
@@ -289,6 +292,7 @@ export declare interface ConnectablePortsConfig {
     readonly edgeShape?: EdgeShapeConfig;
     readonly connectionTypeResolver?: ConnectionTypeResolver;
     readonly connectionPreprocessor?: ConnectionPreprocessor;
+    readonly connectionAllowedVerifier?: ConnectionAllowedVerifier;
     readonly mouseDownEventVerifier?: MouseEventVerifier;
     readonly mouseUpEventVerifier?: MouseEventVerifier;
     readonly dragPortDirection?: number | undefined;
@@ -302,13 +306,26 @@ export declare interface ConnectablePortsConfig {
     };
 }
 
+export declare type ConnectionAllowedVerifier = (request: ConnectionAllowedVerifierRequest) => boolean;
+
+export declare interface ConnectionAllowedVerifierRequest {
+    readonly from: Identifier;
+    readonly to: Identifier;
+}
+
 export declare enum ConnectionCategory {
     Line = "line",
     NodeCycle = "node-cycle",
     PortCycle = "port-cycle"
 }
 
-export declare type ConnectionPreprocessor = (request: AddEdgeRequest) => AddEdgeRequest | null;
+export declare type ConnectionPreprocessor = (request: AddEdgeRequest) => AddEdgeRequest | ConnectionPreprocessorNullResponse;
+
+/**
+ * @deprecated
+ * connection preprocessor should not return null
+ */
+declare type ConnectionPreprocessorNullResponse = null;
 
 export declare type ConnectionTypeResolver = (portId: Identifier) => "direct" | "reverse" | null;
 
@@ -365,6 +382,7 @@ declare interface DotsRenderer {
 
 declare interface DraggableEdgesConfig {
     readonly connectionPreprocessor?: ConnectionPreprocessor;
+    readonly connectionAllowedVerifier?: ConnectionAllowedVerifier;
     readonly mouseDownEventVerifier?: MouseEventVerifier;
     readonly mouseUpEventVerifier?: MouseEventVerifier;
     readonly draggingEdgeResolver?: DraggingEdgeResolver;
@@ -481,6 +499,7 @@ export declare class Graph {
     getAllEdgeIds(): readonly Identifier[];
     hasEdge(edgeId: Identifier): boolean;
     getEdge(edgeId: Identifier): GraphEdge;
+    findEdgeIdByElement(element: Element): Identifier | undefined;
     getPortIncomingEdgeIds(portId: Identifier): readonly Identifier[];
     getPortOutgoingEdgeIds(portId: Identifier): readonly Identifier[];
     getPortCycleEdgeIds(portId: Identifier): readonly Identifier[];
@@ -568,6 +587,7 @@ declare class GraphStore {
     private readonly portOutgoingEdges;
     private readonly portCycleEdges;
     private readonly elementPorts;
+    private readonly edgesElementsMap;
     private readonly afterNodeAddedEmitter;
     readonly onAfterNodeAdded: EventHandler<Identifier>;
     private readonly afterNodeUpdatedEmitter;
@@ -612,6 +632,7 @@ declare class GraphStore {
     removePort(portId: Identifier): void;
     hasEdge(edgeId: Identifier): boolean;
     getEdge(edgeId: Identifier): StoreEdge;
+    findEdgeIdByElement(element: Element): Identifier | undefined;
     addEdge(request: AddEdgeRequest_2): void;
     updateEdge(edgeId: Identifier, request: UpdateEdgeRequest_2): void;
     getAllEdgeIds(): readonly Identifier[];
@@ -701,6 +722,10 @@ export declare class InteractiveEdgeShape implements StructuredEdgeShape {
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
+    /**
+     * @deprecated
+     * do use shape.svg instead
+     */
     readonly handle: SVGGElement;
     readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
     private readonly interactiveLine;
@@ -1013,6 +1038,13 @@ export declare interface UserSelectableCanvasConfig {
     readonly movementThreshold?: number | undefined;
 }
 
+export declare interface UserSelectableEdgesConfig {
+    readonly onEdgeSelected: (edgeId: Identifier) => void;
+    readonly mouseDownEventVerifier?: MouseEventVerifier | undefined;
+    readonly mouseUpEventVerifier?: MouseEventVerifier | undefined;
+    readonly movementThreshold?: number | undefined;
+}
+
 export declare interface UserSelectableNodesConfig {
     readonly onNodeSelected: (nodeId: Identifier) => void;
     readonly mouseDownEventVerifier?: MouseEventVerifier | undefined;