@html-graph/html-graph 1.3.0 → 2.0.0

package/dist/main.d.ts

@@ -75,35 +75,9 @@ export declare class BezierEdgeShape implements EdgeShape {
     render(params: EdgeRenderParams): void;
 }
 
-declare interface BezierEdgeShape_2 {
+declare type BezierEdgeShapeConfig = {
     readonly type?: "bezier" | undefined;
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly curvature?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleRadius?: number | undefined;
-    readonly smallCycleRadius?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
-
-declare interface BezierEdgeShape_3 {
-    readonly type?: "bezier" | undefined;
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly curvature?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleRadius?: number | undefined;
-    readonly smallCycleRadius?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
+} & BezierEdgeParams;
 
 export declare interface Canvas {
     /**
@@ -111,19 +85,9 @@ export declare interface Canvas {
      */
     readonly graph: Graph;
     /**
-     * @deprecated
-     * use "graph" property instead
-     */
-    readonly model: Graph;
-    /**
-     * provides api for canvas accessing viewport state
+     * provides api for accessing viewport state
      */
     readonly viewport: Viewport;
-    /**
-     * @deprecated
-     * use "viewport" property instead
-     */
-    readonly transformation: Viewport;
     /**
      * adds node to graph
      */
@@ -193,7 +157,7 @@ export declare interface Canvas {
     destroy(): void;
 }
 
-declare class CanvasBuilder {
+export declare class CanvasBuilder {
     private coreOptions;
     private dragOptions;
     private transformOptions;
@@ -209,79 +173,31 @@ declare class CanvasBuilder {
     /**
      * enables nodes draggable bu user
      */
-    setUserDraggableNodes(options?: DragOptions): CanvasBuilder;
-    /**
-     * @deprecated
-     * use setUserTransformableViewport instead
-     */
-    setUserTransformableCanvas(options?: TransformOptions): CanvasBuilder;
+    enableUserDraggableNodes(options?: DragOptions): CanvasBuilder;
     /**
      * enables viewport transformable by user
      */
-    setUserTransformableViewport(options?: TransformOptions): CanvasBuilder;
+    enableUserTransformableViewport(options?: TransformOptions): CanvasBuilder;
     /**
      * enables automatic edges update on node resize
      */
-    setResizeReactiveNodes(): CanvasBuilder;
+    enableResizeReactiveNodes(): CanvasBuilder;
     /**
      * sets emitter for rendering graph inside bounded area
      */
-    setBoxRenderingTrigger(trigger: EventSubject<RenderingBox>): CanvasBuilder;
-    setVirtualScroll(options: VirtualScrollOptions): CanvasBuilder;
+    enableBoxAreaRendering(trigger: EventSubject<RenderingBox>): CanvasBuilder;
+    enableVirtualScroll(options: VirtualScrollOptions): CanvasBuilder;
     /**
      * builds final canvas
      */
     build(): Canvas;
-}
-export { CanvasBuilder }
-export { CanvasBuilder as HtmlGraphBuilder }
-
-/**
- * @deprecated
- */
-export declare class CanvasCore implements Canvas {
-    readonly viewport: Viewport;
-    readonly transformation: Viewport;
-    readonly graph: Graph;
-    readonly model: Graph;
-    private readonly internalTransformation;
-    private readonly internalModel;
-    private readonly graphStoreController;
-    private readonly htmlView;
-    private readonly onAfterNodeAdded;
-    private readonly onAfterEdgeAdded;
-    private readonly onAfterEdgeShapeUpdated;
-    private readonly onAfterEdgePriorityUpdated;
-    private readonly onAfterEdgeUpdated;
-    private readonly onAfterPortUpdated;
-    private readonly onAfterNodePriorityUpdated;
-    private readonly onAfterNodeUpdated;
-    private readonly onBeforeEdgeRemoved;
-    private readonly onBeforeNodeRemoved;
-    constructor(apiOptions?: CoreOptions_2);
-    attach(element: HTMLElement): CanvasCore;
-    detach(): CanvasCore;
-    addNode(request: AddNodeRequest): CanvasCore;
-    updateNode(nodeId: unknown, request?: UpdateNodeRequest): CanvasCore;
-    removeNode(nodeId: unknown): CanvasCore;
-    addEdge(request: AddEdgeRequest): CanvasCore;
-    updateEdge(edgeId: unknown, request?: UpdateEdgeRequest): CanvasCore;
-    removeEdge(edgeId: unknown): CanvasCore;
-    markPort(request: MarkPortRequest): CanvasCore;
-    updatePort(portId: string, request?: UpdatePortRequest): CanvasCore;
-    unmarkPort(portId: string): CanvasCore;
-    patchViewportMatrix(request: PatchMatrixRequest): CanvasCore;
-    patchContentMatrix(request: PatchMatrixRequest): CanvasCore;
-    clear(): CanvasCore;
-    destroy(): void;
+    private reset;
 }
 
 export declare type CenterFn = (width: number, height: number) => Point;
 
 declare type ConstantPriority = number;
 
-declare type ConstantPriority_2 = number;
-
 export declare interface CoreOptions {
     /**
      * nodes related behavior
@@ -313,7 +229,7 @@ export declare interface CoreOptions {
         /**
          * specifies default controller
          */
-        readonly shape?: EdgeShape_2;
+        readonly shape?: EdgeShapeConfig;
         /**
          * specifies default z-index value
          */
@@ -321,49 +237,8 @@ export declare interface CoreOptions {
     };
 }
 
-declare interface CoreOptions_2 {
-    /**
-     * nodes related behavior
-     */
-    readonly nodes?: {
-        /**
-         * specifies how to determine center of node
-         * center of nodes specified in addNode method by x and y
-         */
-        readonly centerFn?: CenterFn;
-        /**
-         * specifies default z-index value
-         */
-        readonly priority?: Priority_2;
-    };
-    /**
-     * ports related behavior
-     */
-    readonly ports?: {
-        /**
-         * specifies default direction of port
-         */
-        readonly direction?: number;
-    };
-    /**
-     *edges related behavior
-     */
-    readonly edges?: {
-        /**
-         * specifies default controller
-         */
-        readonly shape?: EdgeShape_3;
-        /**
-         * specifies default z-index value
-         */
-        readonly priority?: Priority_2;
-    };
-}
-
 declare type CustomPriority = PriorityFn;
 
-declare type CustomPriority_2 = PriorityFn;
-
 export declare interface DragOptions {
     readonly moveOnTop?: boolean;
     readonly mouse?: {
@@ -405,14 +280,10 @@ export declare interface EdgeShape {
     render(params: EdgeRenderParams): void;
 }
 
-declare type EdgeShape_2 = BezierEdgeShape_2 | StraightEdgeShape_2 | HorizontalEdgeShape_2 | VerticalEdgeShape_2 | EdgeShapeFactory;
-
-declare type EdgeShape_3 = BezierEdgeShape_3 | StraightEdgeShape_3 | HorizontalEdgeShape_3 | VerticalEdgeShape_3 | EdgeShapeFactory_2;
+declare type EdgeShapeConfig = BezierEdgeShapeConfig | StraightEdgeShapeConfig | HorizontalEdgeShapeConfig | VerticalEdgeShapeConfig | EdgeShapeFactory;
 
 declare type EdgeShapeFactory = () => EdgeShape;
 
-declare type EdgeShapeFactory_2 = () => EdgeShape;
-
 declare interface EventEmitter<T> {
     emit(payload: T): void;
 }
@@ -432,7 +303,7 @@ export declare class EventSubject<T> implements EventEmitter<T>, EventHandler<T>
 /**
  * This entity is responsible for providing access to end user in a safe way
  */
-declare class Graph {
+export declare class Graph {
     private readonly graphStore;
     constructor(graphStore: GraphStore);
     getNode(nodeId: unknown): GraphNode | null;
@@ -452,8 +323,6 @@ declare class Graph {
     getNodeCycleEdgeIds(nodeId: unknown): readonly unknown[] | null;
     getNodeAdjacentEdgeIds(nodeId: unknown): readonly unknown[] | null;
 }
-export { Graph }
-export { Graph as PublicGraphStore }
 
 export declare interface GraphEdge {
     readonly from: unknown;
@@ -546,35 +415,9 @@ export declare class HorizontalEdgeShape implements EdgeShape {
     render(params: EdgeRenderParams): void;
 }
 
-declare interface HorizontalEdgeShape_2 {
+declare type HorizontalEdgeShapeConfig = {
     readonly type: "horizontal";
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly arrowOffset?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleSquareSide?: number | undefined;
-    readonly roundness?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
-
-declare interface HorizontalEdgeShape_3 {
-    readonly type: "horizontal";
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly arrowOffset?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleSquareSide?: number | undefined;
-    readonly roundness?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
+} & HorizontalEdgeParams;
 
 export declare class HtmlGraphError extends Error {
     readonly name = "HtmlGraphError";
@@ -582,8 +425,6 @@ export declare class HtmlGraphError extends Error {
 
 declare type IncrementalPriority = "incremental";
 
-declare type IncrementalPriority_2 = "incremental";
-
 export declare type MarkNodePortRequest = {
     readonly id?: unknown | undefined;
     readonly element: HTMLElement;
@@ -634,9 +475,7 @@ declare interface PortPayload {
     direction: number;
 }
 
-declare type Priority = ConstantPriority | IncrementalPriority | SharedIncrementalPriority | CustomPriority;
-
-declare type Priority_2 = ConstantPriority_2 | IncrementalPriority_2 | SharedIncrementalPriority_2 | CustomPriority_2;
+declare type Priority = ConstantPriority | IncrementalPriority | CustomPriority;
 
 export declare type PriorityFn = () => number;
 
@@ -647,44 +486,11 @@ export declare interface RenderingBox {
     readonly height: number;
 }
 
-export declare class ResizeReactiveNodesCanvas implements Canvas {
-    private readonly canvas;
-    readonly viewport: Viewport;
-    readonly transformation: Viewport;
-    readonly graph: Graph;
-    readonly model: Graph;
-    private readonly nodes;
-    private readonly nodeIdGenerator;
-    private readonly nodesResizeObserver;
-    private readonly window;
-    constructor(canvas: Canvas);
-    attach(element: HTMLElement): Canvas;
-    detach(): Canvas;
-    addNode(request: AddNodeRequest): Canvas;
-    updateNode(nodeId: unknown, request?: UpdateNodeRequest): Canvas;
-    removeNode(nodeId: unknown): Canvas;
-    markPort(port: MarkPortRequest): Canvas;
-    updatePort(portId: string, request?: UpdatePortRequest): Canvas;
-    unmarkPort(portId: string): Canvas;
-    addEdge(edge: AddEdgeRequest): Canvas;
-    updateEdge(edgeId: unknown, request?: UpdateEdgeRequest): Canvas;
-    removeEdge(edgeId: unknown): Canvas;
-    patchViewportMatrix(request: PatchMatrixRequest): Canvas;
-    patchContentMatrix(request: PatchMatrixRequest): Canvas;
-    clear(): Canvas;
-    destroy(): void;
-    private handleNodeResize;
-}
-
 export declare interface ScaleLimitPreprocessorParams {
     readonly minContentScale: number | null;
     readonly maxContentScale: number | null;
 }
 
-declare type SharedIncrementalPriority = "shared-incremental";
-
-declare type SharedIncrementalPriority_2 = "shared-incremental";
-
 export declare interface ShiftLimitPreprocessorParams {
     readonly minX: number | null;
     readonly maxX: number | null;
@@ -725,35 +531,9 @@ export declare class StraightEdgeShape implements EdgeShape {
     render(params: EdgeRenderParams): void;
 }
 
-declare interface StraightEdgeShape_2 {
+declare type StraightEdgeShapeConfig = {
     readonly type: "straight";
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly arrowOffset?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleSquareSide?: number | undefined;
-    readonly roundness?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
-
-declare interface StraightEdgeShape_3 {
-    readonly type: "straight";
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly arrowOffset?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleSquareSide?: number | undefined;
-    readonly roundness?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
+} & StraightEdgeParams;
 
 export declare interface TransformOptions {
     readonly scale?: {
@@ -772,6 +552,8 @@ export declare interface TransformOptions {
         readonly onTransformFinished?: () => void;
         readonly onBeforeTransformChange?: () => void;
         readonly onTransformChange?: () => void;
+        readonly onResizeTransformStarted?: () => void;
+        readonly onResizeTransformFinished?: () => void;
     };
 }
 
@@ -826,95 +608,6 @@ export declare interface UpdatePortRequest {
     readonly direction?: number;
 }
 
-export declare class UserDraggableNodesCanvas implements Canvas {
-    private readonly canvas;
-    readonly graph: Graph;
-    readonly model: Graph;
-    readonly viewport: Viewport;
-    readonly transformation: Viewport;
-    private maxNodePriority;
-    private readonly nodes;
-    private grabbedNodeId;
-    private readonly nodeIdGenerator;
-    private element;
-    private readonly onWindowMouseMove;
-    private readonly onWindowMouseUp;
-    private readonly onWindowTouchMove;
-    private readonly onWindowTouchFinish;
-    private previousTouchCoords;
-    private readonly window;
-    private readonly options;
-    constructor(canvas: Canvas, dragOptions?: DragOptions);
-    attach(element: HTMLElement): Canvas;
-    detach(): Canvas;
-    addNode(request: AddNodeRequest): Canvas;
-    updateNode(nodeId: unknown, request?: UpdateNodeRequest): Canvas;
-    removeNode(nodeId: unknown): Canvas;
-    markPort(port: MarkPortRequest): Canvas;
-    updatePort(portId: string, request?: UpdatePortRequest): Canvas;
-    unmarkPort(portId: string): Canvas;
-    addEdge(edge: AddEdgeRequest): Canvas;
-    updateEdge(edgeId: unknown, request?: UpdateEdgeRequest): Canvas;
-    removeEdge(edgeId: unknown): Canvas;
-    patchViewportMatrix(request: PatchMatrixRequest): Canvas;
-    patchContentMatrix(request: PatchMatrixRequest): Canvas;
-    clear(): Canvas;
-    destroy(): void;
-    private dragNode;
-    private updateMaxNodePriority;
-    private moveNodeOnTop;
-    private cancelMouseDrag;
-    private removeMouseDragListeners;
-    private cancelTouchDrag;
-    private removeTouchDragListeners;
-}
-
-declare class UserTransformableViewportCanvas implements Canvas {
-    private readonly canvas;
-    readonly graph: Graph;
-    readonly model: Graph;
-    readonly viewport: Viewport;
-    readonly transformation: Viewport;
-    private element;
-    private prevTouches;
-    private window;
-    private wheelFinishTimer;
-    private readonly onMouseDown;
-    private readonly onWindowMouseMove;
-    private readonly onWindowMouseUp;
-    private readonly onWheelScroll;
-    private readonly onTouchStart;
-    private readonly onWindowTouchMove;
-    private readonly onWindowTouchFinish;
-    private readonly observer;
-    private readonly options;
-    constructor(canvas: Canvas, transformOptions?: TransformOptions);
-    attach(element: HTMLElement): Canvas;
-    detach(): Canvas;
-    addNode(node: AddNodeRequest): Canvas;
-    updateNode(nodeId: unknown, request?: UpdateNodeRequest): Canvas;
-    removeNode(nodeId: unknown): Canvas;
-    markPort(port: MarkPortRequest): Canvas;
-    updatePort(portId: string, request?: UpdatePortRequest): Canvas;
-    unmarkPort(portId: string): Canvas;
-    addEdge(edge: AddEdgeRequest): Canvas;
-    updateEdge(edgeId: unknown, request?: UpdateEdgeRequest): Canvas;
-    removeEdge(edgeId: unknown): Canvas;
-    patchViewportMatrix(request: PatchMatrixRequest): Canvas;
-    patchContentMatrix(request: PatchMatrixRequest): Canvas;
-    clear(): Canvas;
-    destroy(): void;
-    private moveViewport;
-    private scaleViewport;
-    private stopMouseDrag;
-    private removeMouseDragListeners;
-    private stopTouchDrag;
-    private removeTouchDragListeners;
-    private performTransform;
-}
-export { UserTransformableViewportCanvas as UserTransformableCanvas }
-export { UserTransformableViewportCanvas }
-
 export declare interface VerticalEdgeParams {
     readonly color?: string | undefined;
     readonly width?: number | undefined;
@@ -948,48 +641,20 @@ export declare class VerticalEdgeShape implements EdgeShape {
     render(params: EdgeRenderParams): void;
 }
 
-declare interface VerticalEdgeShape_2 {
+declare type VerticalEdgeShapeConfig = {
     readonly type: "vertical";
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly arrowOffset?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleSquareSide?: number | undefined;
-    readonly roundness?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
-
-declare interface VerticalEdgeShape_3 {
-    readonly type: "vertical";
-    readonly color?: string | undefined;
-    readonly width?: number | undefined;
-    readonly arrowLength?: number | undefined;
-    readonly arrowWidth?: number | undefined;
-    readonly arrowOffset?: number | undefined;
-    readonly hasSourceArrow?: boolean | undefined;
-    readonly hasTargetArrow?: boolean | undefined;
-    readonly cycleSquareSide?: number | undefined;
-    readonly roundness?: number | undefined;
-    readonly detourDistance?: number | undefined;
-    readonly detourDirection?: number | undefined;
-}
+} & VerticalEdgeParams;
 
 /**
  * This entity is responsible for providing viewport transformation state to the
  * end user in a safe way
  */
-declare class Viewport {
+export declare class Viewport {
     private readonly transformer;
     constructor(transformer: ViewportTransformer);
     getViewportMatrix(): TransformState;
     getContentMatrix(): TransformState;
 }
-export { Viewport as PublicViewportTransformer }
-export { Viewport }
 
 /**
  * This entity is responsible for storing viewport transformation
@@ -1007,7 +672,7 @@ declare class ViewportTransformer {
 }
 
 declare interface VirtualScrollOptions {
-    readonly maxNodeContainingRadius: {
+    readonly nodeContainingRadius: {
         readonly vertical: number;
         readonly horizontal: number;
     };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@html-graph/html-graph",
   "author": "Dmitry Marov <d.marov94@gmail.com>",
   "private": false,
-  "version": "1.3.0",
+  "version": "2.0.0",
   "type": "module",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",