@html-graph/html-graph 3.10.0 → 3.11.1

package/README.md

@@ -63,27 +63,27 @@ class Application {
   }
 
   createNode({ name, x, y, frontPortId, backPortId }) {
-    const node = document.createElement("div");
+    const nodeElement = document.createElement("div");
     const text = document.createElement("div");
-    const frontPort = document.createElement("div");
-    const backPort = document.createElement("div");
+    const frontPortElement = document.createElement("div");
+    const backPortElement = document.createElement("div");
 
-    node.classList.add("node");
-    frontPort.classList.add("port");
-    backPort.classList.add("port");
+    nodeElement.classList.add("node");
+    frontPortElement.classList.add("port");
+    backPortElement.classList.add("port");
     text.innerText = name;
 
-    node.appendChild(frontPort);
-    node.appendChild(text);
-    node.appendChild(backPort);
+    nodeElement.appendChild(frontPortElement);
+    nodeElement.appendChild(text);
+    nodeElement.appendChild(backPortElement);
 
     return {
-      element: node,
+      element: nodeElement,
       x: x,
       y: y,
       ports: [
-        { id: frontPortId, element: frontPort },
-        { id: backPortId, element: backPort },
+        { id: frontPortId, element: frontPortElement },
+        { id: backPortId, element: backPortElement },
       ],
     };
   }

package/dist/html-graph.d.ts

@@ -71,6 +71,7 @@ export declare class BezierEdgeShape implements StructuredEdgeShape {
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
     private readonly arrowLength;
     private readonly arrowWidth;
     private readonly curvature;
@@ -80,7 +81,7 @@ export declare class BezierEdgeShape implements StructuredEdgeShape {
     private readonly detourDistance;
     private readonly hasSourceArrow;
     private readonly hasTargetArrow;
-    private readonly lineShape;
+    private readonly pathShape;
     private readonly createCyclePath;
     private readonly createDetourPath;
     private readonly createLinePath;
@@ -320,8 +321,6 @@ export declare type ConnectionTypeResolver = (portId: unknown) => "direct" | "re
 
 declare type ConstantPriority = number;
 
-export declare type CreatePathFn = (sourceDirection: Point, targetDirection: Point, to: Point, flipX: number, flipY: number) => string;
-
 declare type CustomPriority = PriorityFn;
 
 declare interface Defaults {
@@ -361,6 +360,8 @@ export declare class DirectEdgeShape implements StructuredEdgeShape {
     private readonly arrowWidth;
     private readonly sourceOffset;
     private readonly targetOffset;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
+    private readonly afterRenderEmitter;
     constructor(params?: DirectEdgeParams);
     render(params: EdgeRenderParams): void;
 }
@@ -391,6 +392,13 @@ declare interface DraggableNodesConfig {
 export { DraggableNodesConfig as DragOptions }
 export { DraggableNodesConfig }
 
+declare interface EdgePath {
+    readonly path: string;
+    readonly median: Point;
+}
+
+declare type EdgePathFactory = (sourceDirection: Point, targetDirection: Point, to: Point, flipX: number, flipY: number) => EdgePath;
+
 declare interface EdgePayload {
     readonly from: unknown;
     readonly to: unknown;
@@ -580,6 +588,7 @@ export declare class HorizontalEdgeShape implements StructuredEdgeShape {
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
     private readonly arrowLength;
     private readonly arrowWidth;
     private readonly arrowOffset;
@@ -589,7 +598,7 @@ export declare class HorizontalEdgeShape implements StructuredEdgeShape {
     private readonly detourDistance;
     private readonly hasSourceArrow;
     private readonly hasTargetArrow;
-    private readonly lineShape;
+    private readonly pathShape;
     private readonly createCyclePath;
     private readonly createDetourPath;
     private readonly createLinePath;
@@ -633,17 +642,18 @@ export declare interface InteractiveEdgeParams {
 }
 
 export declare class InteractiveEdgeShape implements StructuredEdgeShape {
-    private readonly structuredEdge;
+    private readonly baseEdge;
     readonly svg: SVGSVGElement;
     readonly group: SVGGElement;
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
     readonly handle: SVGGElement;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
     private readonly interactiveLine;
     private readonly interactiveSourceArrow;
     private readonly interactiveTargetArrow;
-    constructor(structuredEdge: StructuredEdgeShape, params?: InteractiveEdgeParams);
+    constructor(baseEdge: StructuredEdgeShape, params?: InteractiveEdgeParams);
     render(params: EdgeRenderParams): void;
 }
 
@@ -654,9 +664,9 @@ export declare interface LineEdgeParams {
     readonly arrowWidth: number;
     readonly hasSourceArrow: boolean;
     readonly hasTargetArrow: boolean;
-    readonly createCyclePath: CreatePathFn;
-    readonly createDetourPath: CreatePathFn;
-    readonly createLinePath: CreatePathFn;
+    readonly createCyclePath: EdgePathFactory;
+    readonly createDetourPath: EdgePathFactory;
+    readonly createLinePath: EdgePathFactory;
 }
 
 export declare class LineEdgeShape implements StructuredEdgeShape {
@@ -666,6 +676,8 @@ export declare class LineEdgeShape implements StructuredEdgeShape {
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
+    private readonly afterRenderEmitter;
     constructor(params: LineEdgeParams);
     render(params: EdgeRenderParams): void;
 }
@@ -683,6 +695,19 @@ export declare interface MarkPortRequest {
     readonly direction?: number;
 }
 
+export declare class MedianEdgeShape implements StructuredEdgeShape {
+    private readonly baseShape;
+    readonly medianElement: SVGElement;
+    readonly group: SVGGElement;
+    readonly line: SVGPathElement;
+    readonly sourceArrow: SVGPathElement | null;
+    readonly targetArrow: SVGPathElement | null;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
+    readonly svg: SVGSVGElement;
+    constructor(baseShape: StructuredEdgeShape, medianElement: SVGElement);
+    render(params: EdgeRenderParams): void;
+}
+
 export declare type MouseEventVerifier = (event: MouseEvent) => boolean;
 
 export declare interface NodeDragPayload {
@@ -767,6 +792,7 @@ export declare class StraightEdgeShape implements StructuredEdgeShape {
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
     private readonly arrowLength;
     private readonly arrowWidth;
     private readonly arrowOffset;
@@ -776,7 +802,7 @@ export declare class StraightEdgeShape implements StructuredEdgeShape {
     private readonly detourDistance;
     private readonly hasSourceArrow;
     private readonly hasTargetArrow;
-    private readonly lineShape;
+    private readonly pathShape;
     private readonly createCyclePath;
     private readonly createDetourPath;
     private readonly createLinePath;
@@ -788,11 +814,18 @@ declare type StraightEdgeShapeConfig = {
     readonly type: "straight";
 } & StraightEdgeParams;
 
+export declare interface StructuredEdgeRenderModel {
+    readonly edgePath: EdgePath;
+    readonly sourceArrowPath: string | null;
+    readonly targetArrowPath: string | null;
+}
+
 export declare interface StructuredEdgeShape extends EdgeShape {
     readonly group: SVGGElement;
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
 }
 
 export declare interface TransformPayload {
@@ -884,6 +917,7 @@ export declare class VerticalEdgeShape implements StructuredEdgeShape {
     readonly line: SVGPathElement;
     readonly sourceArrow: SVGPathElement | null;
     readonly targetArrow: SVGPathElement | null;
+    readonly onAfterRender: EventHandler<StructuredEdgeRenderModel>;
     private readonly arrowLength;
     private readonly arrowWidth;
     private readonly arrowOffset;
@@ -893,7 +927,7 @@ export declare class VerticalEdgeShape implements StructuredEdgeShape {
     private readonly detourDistance;
     private readonly hasSourceArrow;
     private readonly hasTargetArrow;
-    private readonly lineShape;
+    private readonly pathShape;
     private readonly createCyclePath;
     private readonly createDetourPath;
     private readonly createLinePath;