@html-graph/html-graph 0.0.53 → 0.0.54

package/dist/main.d.ts

@@ -2,7 +2,7 @@ export declare interface AddEdgeRequest {
     id?: unknown;
     from: string;
     to: string;
-    options?: EdgeShape;
+    options?: EdgeShape_2;
     priority?: number;
 }
 
@@ -33,7 +33,7 @@ declare type BackgroundOptions = {
     readonly drawingFn: BackgroundDrawingFn;
 };
 
-export declare class BezierEdgeShape implements EdgeController {
+export declare class BezierEdgeShape implements EdgeShape {
     private readonly color;
     private readonly width;
     private readonly curvature;
@@ -114,11 +114,11 @@ export declare interface Canvas {
     /**
      * applies transformation for viewport
      */
-    patchViewportState(request: PatchViewportRequest): Canvas;
+    patchViewportState(request: PatchTransformRequest): Canvas;
     /**
-     * moves viewport to nodes
+     * applies transformation for content
      */
-    moveToNodes(nodeIds: readonly string[]): Canvas;
+    patchContentState(request: PatchTransformRequest): Canvas;
     /**
      * attaches canvas to given element
      */
@@ -160,8 +160,8 @@ export declare class CanvasCore implements Canvas {
     addEdge(edge: AddEdgeRequest): CanvasCore;
     updateEdge(edgeId: unknown, request: UpdateEdgeRequest): CanvasCore;
     removeEdge(edgeId: unknown): CanvasCore;
-    patchViewportState(request: PatchViewportRequest): CanvasCore;
-    moveToNodes(nodeIds: readonly string[]): CanvasCore;
+    patchViewportState(request: PatchTransformRequest): CanvasCore;
+    patchContentState(request: PatchTransformRequest): CanvasCore;
     clear(): CanvasCore;
     attach(element: HTMLElement): CanvasCore;
     detach(): CanvasCore;
@@ -212,7 +212,7 @@ export declare interface CoreOptions {
         /**
          * specifies default controller
          */
-        readonly shape?: EdgeShape;
+        readonly shape?: EdgeShape_2;
         /**
          * specifies default z-index value
          */
@@ -283,7 +283,7 @@ declare interface CustomEdgeShape {
 
 declare type CustomPriority = PriorityFn;
 
-export declare class CycleCircleEdgeShape implements EdgeController {
+export declare class CycleCircleEdgeShape implements EdgeShape {
     private readonly color;
     private readonly width;
     private readonly arrowLength;
@@ -298,7 +298,7 @@ export declare class CycleCircleEdgeShape implements EdgeController {
     update(x: number, y: number, _width: number, _height: number, from: PortPayload): void;
 }
 
-export declare class CycleSquareEdgeShape implements EdgeController {
+export declare class CycleSquareEdgeShape implements EdgeShape {
     private readonly color;
     private readonly width;
     private readonly arrowLength;
@@ -315,7 +315,7 @@ export declare class CycleSquareEdgeShape implements EdgeController {
     update(x: number, y: number, _width: number, _height: number, from: PortPayload): void;
 }
 
-export declare class DetourStraightEdgeShape implements EdgeController {
+export declare class DetourStraightEdgeShape implements EdgeShape {
     private readonly color;
     private readonly width;
     private readonly arrowLength;
@@ -341,21 +341,21 @@ export declare interface DragOptions {
     };
 }
 
-export declare interface EdgeController {
-    readonly svg: SVGSVGElement;
-    update(x: number, y: number, width: number, height: number, from: PortPayload, to: PortPayload): void;
-}
-
 declare interface EdgePayload {
     from: string;
     to: string;
-    shape: EdgeController;
+    shape: EdgeShape;
     priority: number;
 }
 
-declare type EdgeShape = BezierEdgeShape_2 | StraightEdgeShape_2 | CustomEdgeShape | HorizontalEdgeShape_2 | VerticalEdgeShape_2;
+export declare interface EdgeShape {
+    readonly svg: SVGSVGElement;
+    update(x: number, y: number, width: number, height: number, from: PortPayload, to: PortPayload): void;
+}
+
+declare type EdgeShape_2 = BezierEdgeShape_2 | StraightEdgeShape_2 | CustomEdgeShape | HorizontalEdgeShape_2 | VerticalEdgeShape_2;
 
-declare type EdgeShapeFactory = (type: EdgeType) => EdgeController;
+declare type EdgeShapeFactory = (type: EdgeType) => EdgeShape;
 
 export declare enum EdgeType {
     Regular = "regular",
@@ -399,7 +399,7 @@ declare class GraphStore {
     getPort(portId: unknown): PortPayload | undefined;
     getPortNode(portId: string): unknown | undefined;
     removePort(portId: string): void;
-    addEdge(edgeId: unknown, fromPortId: string, toPortId: string, shape: EdgeController, priority: number): void;
+    addEdge(edgeId: unknown, fromPortId: string, toPortId: string, shape: EdgeShape, priority: number): void;
     getEdge(edgeId: unknown): EdgePayload | undefined;
     removeEdge(edgeId: unknown): void;
     getPortAdjacentEdges(portId: string): readonly unknown[];
@@ -413,7 +413,7 @@ declare class GraphStore {
     getNodeCycleEdges(nodeId: unknown): readonly unknown[];
 }
 
-export declare class HorizontalEdgeShape implements EdgeController {
+export declare class HorizontalEdgeShape implements EdgeShape {
     private readonly color;
     private readonly width;
     private readonly arrowLength;
@@ -487,7 +487,7 @@ declare interface NodePayload {
     priority: number;
 }
 
-export declare interface PatchViewportRequest {
+export declare interface PatchTransformRequest {
     scale?: number;
     x?: number;
     y?: number;
@@ -506,10 +506,10 @@ export declare type PriorityFn = () => number;
 declare class PublicGraphStore {
     private readonly graphStore;
     constructor(graphStore: GraphStore);
-    getNode(nodeId: unknown): GraphNode | undefined;
-    getPort(portId: unknown): GraphPort | undefined;
-    getPortNode(portId: string): unknown | undefined;
-    getEdge(edgeId: unknown): GraphEdge | undefined;
+    getNode(nodeId: unknown): GraphNode | null;
+    getPort(portId: unknown): GraphPort | null;
+    getPortNode(portId: string): unknown | null;
+    getEdge(edgeId: unknown): GraphEdge | null;
     getPortAdjacentEdges(portId: string): readonly unknown[];
     getNodeAdjacentEdges(nodeId: unknown): readonly unknown[];
     getPortIncomingEdges(portId: unknown): readonly unknown[];
@@ -523,31 +523,13 @@ declare class PublicGraphStore {
 export declare class PublicViewportTransformer {
     private readonly transformer;
     constructor(transformer: ViewportTransformer);
-    /**
-     * for given absolute coordinates returns viewport coordinates
-     * viewport coordinated represent actual coordinates on screen for given absolute coordinates
-     */
-    getViewCoords(xa: number, ya: number): [number, number];
-    /**
-     * returns viewport scale
-     * it represents scale at which entities on canvas should be scaled to fit current scale
-     */
-    getViewScale(): number;
-    /**
-     * for given viewport coordinates returns absolute coordinates
-     * absolute coordinates represent actual coordinates, which stay constant even for transformed canvas
-     */
-    getAbsCoords(xv: number, yv: number): [number, number];
-    /**
-     * returns absolute scale
-     * it represents scale at which current viewport was scaled compared to initial state
-     */
-    getAbsScale(): number;
+    getViewportMatrix(): TransformState;
+    getContentMatrix(): TransformState;
 }
 
 declare type SharedIncrementalPriority = "shared-incremental";
 
-export declare class StraightEdgeShape implements EdgeController {
+export declare class StraightEdgeShape implements EdgeShape {
     private readonly color;
     private readonly width;
     private readonly arrowLength;
@@ -600,8 +582,14 @@ export declare interface TransformPayload {
     readonly y: number;
 }
 
+declare interface TransformState {
+    scale: number;
+    x: number;
+    y: number;
+}
+
 export declare interface UpdateEdgeRequest {
-    readonly controller?: EdgeController;
+    readonly controller?: EdgeShape;
     readonly priority?: number;
 }
 
@@ -645,8 +633,8 @@ export declare class UserDraggableNodesCanvas implements Canvas {
     addEdge(edge: AddEdgeRequest): UserDraggableNodesCanvas;
     updateEdge(edgeId: unknown, request: UpdateEdgeRequest): UserDraggableNodesCanvas;
     removeEdge(edgeId: unknown): UserDraggableNodesCanvas;
-    patchViewportState(request: PatchViewportRequest): UserDraggableNodesCanvas;
-    moveToNodes(nodeIds: readonly string[]): UserDraggableNodesCanvas;
+    patchViewportState(request: PatchTransformRequest): UserDraggableNodesCanvas;
+    patchContentState(request: PatchTransformRequest): UserDraggableNodesCanvas;
     clear(): UserDraggableNodesCanvas;
     attach(element: HTMLElement): UserDraggableNodesCanvas;
     detach(): UserDraggableNodesCanvas;
@@ -689,8 +677,8 @@ export declare class UserTransformableCanvas implements Canvas {
     addEdge(edge: AddEdgeRequest): UserTransformableCanvas;
     updateEdge(edgeId: unknown, request: UpdateEdgeRequest): UserTransformableCanvas;
     removeEdge(edgeId: unknown): UserTransformableCanvas;
-    patchViewportState(request: PatchViewportRequest): UserTransformableCanvas;
-    moveToNodes(nodeIds: readonly string[]): UserTransformableCanvas;
+    patchViewportState(request: PatchTransformRequest): UserTransformableCanvas;
+    patchContentState(request: PatchTransformRequest): UserTransformableCanvas;
     clear(): UserTransformableCanvas;
     attach(element: HTMLElement): UserTransformableCanvas;
     detach(): UserTransformableCanvas;
@@ -701,7 +689,7 @@ export declare class UserTransformableCanvas implements Canvas {
     private scaleViewport;
 }
 
-export declare class VerticalEdgeShape implements EdgeController {
+export declare class VerticalEdgeShape implements EdgeShape {
     private readonly color;
     private readonly width;
     private readonly arrowLength;
@@ -733,12 +721,13 @@ declare interface VerticalEdgeShape_2 {
 }
 
 declare class ViewportTransformer {
-    private state;
-    getViewCoords(xa: number, ya: number): [number, number];
-    getViewScale(): number;
-    getAbsCoords(xv: number, yv: number): [number, number];
-    getAbsScale(): number;
-    patchState(scale: number | null, x: number | null, y: number | null): void;
+    private viewportMatrix;
+    private contentMatrix;
+    getViewportMatrix(): TransformState;
+    getContentMatrix(): TransformState;
+    patchViewportState(scale: number | null, x: number | null, y: number | null): void;
+    patchContentState(scale: number | null, x: number | null, y: number | null): void;
+    private calculateReverseMatrix;
 }
 
 export { }