@html-graph/html-graph 3.8.0 → 3.10.0

package/dist/html-graph.d.ts

@@ -65,9 +65,6 @@ export declare interface BezierEdgeParams {
     readonly detourDirection?: number | undefined;
 }
 
-/**
- * Responsibility: Providing edge shape connecting ports with bezier line
- */
 export declare class BezierEdgeShape implements StructuredEdgeShape {
     readonly svg: SVGSVGElement;
     readonly group: SVGGElement;
@@ -95,9 +92,6 @@ declare type BezierEdgeShapeConfig = {
     readonly type?: "bezier" | undefined;
 } & BezierEdgeParams;
 
-/**
- * Responsibility: provides graph rendering API for end user
- */
 export declare class Canvas {
     /**
      * @deprecated access element directly instead
@@ -199,9 +193,6 @@ export declare class Canvas {
     destroy(): void;
 }
 
-/**
- * Responsibility: Constructs canvas based on specified configuration
- */
 export declare class CanvasBuilder {
     private element;
     private canvasDefaults;
@@ -347,6 +338,37 @@ declare interface Defaults {
     };
 }
 
+export declare interface DirectEdgeParams {
+    readonly color?: string | undefined;
+    readonly width?: number | undefined;
+    readonly arrowLength?: number | undefined;
+    readonly arrowWidth?: number | undefined;
+    readonly hasSourceArrow?: boolean | undefined;
+    readonly hasTargetArrow?: boolean | undefined;
+    readonly sourceOffset?: number | undefined;
+    readonly targetOffset?: number | undefined;
+}
+
+export declare class DirectEdgeShape implements StructuredEdgeShape {
+    readonly svg: SVGSVGElement;
+    readonly group: SVGGElement;
+    readonly line: SVGPathElement;
+    readonly sourceArrow: SVGPathElement | null;
+    readonly targetArrow: SVGPathElement | null;
+    private readonly color;
+    private readonly width;
+    private readonly arrowLength;
+    private readonly arrowWidth;
+    private readonly sourceOffset;
+    private readonly targetOffset;
+    constructor(params?: DirectEdgeParams);
+    render(params: EdgeRenderParams): void;
+}
+
+declare type DirectEdgeShapeConfig = {
+    readonly type: "direct";
+} & DirectEdgeParams;
+
 declare interface DotsRenderer {
     readonly radius?: number;
     readonly color?: string;
@@ -354,6 +376,7 @@ declare interface DotsRenderer {
 
 declare interface DraggableNodesConfig {
     readonly moveOnTop?: boolean;
+    readonly moveEdgesOnTop?: boolean;
     readonly mouse?: {
         readonly dragCursor?: string | null;
         readonly mouseDownEventVerifier?: MouseEventVerifier;
@@ -390,36 +413,24 @@ export declare interface EdgeRenderPort {
     readonly nodeId: unknown;
 }
 
-/**
- * Responsibility: Rendering edge via SVG
- */
 export declare interface EdgeShape {
     readonly svg: SVGSVGElement;
     render(params: EdgeRenderParams): void;
 }
 
-declare type EdgeShapeConfig = BezierEdgeShapeConfig | StraightEdgeShapeConfig | HorizontalEdgeShapeConfig | VerticalEdgeShapeConfig | EdgeShapeFactory;
+declare type EdgeShapeConfig = BezierEdgeShapeConfig | StraightEdgeShapeConfig | HorizontalEdgeShapeConfig | VerticalEdgeShapeConfig | DirectEdgeShapeConfig | EdgeShapeFactory;
 
 declare type EdgeShapeFactory = (edgeId: unknown) => EdgeShape;
 
-/**
- * Responsibility: Provides a way to trigger events
- */
 export declare interface EventEmitter<T> {
     emit(payload: T): void;
 }
 
-/**
- * Responsibility: Provides a way to handle events
- */
 export declare interface EventHandler<T> {
     subscribe(callback: (payload: T) => void): void;
     unsubscribe(callback: (payload: T) => void): void;
 }
 
-/**
- * Responsibility: Connects events and event handlers
- */
 export declare class EventSubject<T> implements EventEmitter<T>, EventHandler<T> {
     private readonly callbacks;
     subscribe(callback: (payload: T) => void): void;
@@ -427,9 +438,6 @@ export declare class EventSubject<T> implements EventEmitter<T>, EventHandler<T>
     emit(payload: T): void;
 }
 
-/**
- * Responsibility: Provides access to graph model for end user
- */
 export declare class Graph {
     private readonly graphStore;
     readonly onAfterNodeAdded: EventHandler<unknown>;
@@ -485,9 +493,6 @@ export declare interface GraphPort {
     readonly nodeId: unknown;
 }
 
-/**
- * Responsibility: Store state of graph
- */
 declare class GraphStore {
     private readonly nodes;
     private readonly ports;
@@ -569,10 +574,6 @@ export declare interface HorizontalEdgeParams {
     readonly detourDirection?: number | undefined;
 }
 
-/**
- * Responsibility: Providing edge shape connecting ports with horizontal angled
- * line
- */
 export declare class HorizontalEdgeShape implements StructuredEdgeShape {
     readonly svg: SVGSVGElement;
     readonly group: SVGGElement;
@@ -600,17 +601,10 @@ declare type HorizontalEdgeShapeConfig = {
     readonly type: "horizontal";
 } & HorizontalEdgeParams;
 
-/**
- * Responsibility: Library specific error to throw when unexpected action
- * occured
- */
 export declare class HtmlGraphError extends Error {
     readonly name = "HtmlGraphError";
 }
 
-/**
- * Responsibility: Provides access to DOM modifications
- */
 declare interface HtmlView {
     attachNode(nodeId: unknown): void;
     detachNode(nodeId: unknown): void;
@@ -638,10 +632,6 @@ export declare interface InteractiveEdgeParams {
     readonly width?: number;
 }
 
-/**
- * Responsibility: Providing handle for attaching interactive behavior to an
- * edge
- */
 export declare class InteractiveEdgeShape implements StructuredEdgeShape {
     private readonly structuredEdge;
     readonly svg: SVGSVGElement;
@@ -669,9 +659,6 @@ export declare interface LineEdgeParams {
     readonly createLinePath: CreatePathFn;
 }
 
-/**
- * Responsibility: Providing low level core for single line structured edges
- */
 export declare class LineEdgeShape implements StructuredEdgeShape {
     private readonly params;
     readonly svg: SVGSVGElement;
@@ -726,9 +713,6 @@ declare interface PatchTransformRequest {
     readonly y?: number;
 }
 
-/**
- * Responsibility: Specifies point coordinates
- */
 export declare interface Point {
     readonly x: number;
     readonly y: number;
@@ -742,9 +726,6 @@ declare interface PortPayload {
 
 declare type Priority = ConstantPriority | IncrementalPriority | CustomPriority;
 
-/**
- * Responsibility: Specifies how to determine Z-index of an entity in DOM
- */
 export declare type PriorityFn = () => number;
 
 export declare interface RenderingBox {
@@ -780,9 +761,6 @@ export declare interface StraightEdgeParams {
     readonly detourDirection?: number | undefined;
 }
 
-/**
- * Responsibility: Providing edge shape connecting ports with straight line
- */
 export declare class StraightEdgeShape implements StructuredEdgeShape {
     readonly svg: SVGSVGElement;
     readonly group: SVGGElement;
@@ -810,9 +788,6 @@ declare type StraightEdgeShapeConfig = {
     readonly type: "straight";
 } & StraightEdgeParams;
 
-/**
- * Responsibility: Specifying EdgeShape with a standard visual structure
- */
 export declare interface StructuredEdgeShape extends EdgeShape {
     readonly group: SVGGElement;
     readonly line: SVGPathElement;
@@ -903,10 +878,6 @@ export declare interface VerticalEdgeParams {
     readonly detourDirection?: number | undefined;
 }
 
-/**
- * Responsibility: Providing edge shape connecting ports with vertical angled
- * line
- */
 export declare class VerticalEdgeShape implements StructuredEdgeShape {
     readonly svg: SVGSVGElement;
     readonly group: SVGGElement;
@@ -934,9 +905,6 @@ declare type VerticalEdgeShapeConfig = {
     readonly type: "vertical";
 } & VerticalEdgeParams;
 
-/**
- * Responsibility: Provides access to viewport state for end user
- */
 export declare class Viewport {
     private readonly viewportStore;
     readonly onBeforeUpdated: EventHandler<void>;
@@ -946,9 +914,6 @@ export declare class Viewport {
     getContentMatrix(): TransformState;
 }
 
-/**
- * Responsibility: Stores viewport transformation state
- */
 declare class ViewportStore {
     private viewportMatrix;
     private contentMatrix;