@html-graph/html-graph 7.9.0 → 8.0.0

package/dist/html-graph.d.ts

@@ -43,11 +43,13 @@ declare interface AddPortRequest {
 }
 
 export declare interface AnimatedLayoutAlgorithm {
-    /**
-     * TODO: v8
-     * make single parameter object
-     */
-    calculateNextCoordinates(graph: Graph, dt: number, viewport: Viewport): ReadonlyMap<Identifier, Point>;
+    calculateNextCoordinates(params: AnimatedLayoutAlgorithmParams): ReadonlyMap<Identifier, Point>;
+}
+
+export declare interface AnimatedLayoutAlgorithmParams {
+    readonly graph: Graph;
+    readonly dt: number;
+    readonly viewport: Viewport;
 }
 
 export declare interface AnimatedLayoutConfig {
@@ -62,16 +64,6 @@ export declare interface AnimatedLayoutConfig {
         readonly edgeEquilibriumLength?: number;
         readonly edgeStiffness?: number;
         readonly seed?: string;
-        /**
-         * @deprecated
-         * use convergenceVelocity instead
-         */
-        readonly effectiveDistance?: number;
-        /**
-         * @deprecated
-         * use convergenceVelocity instead
-         */
-        readonly convergenceDelta?: number;
         readonly convergenceVelocity?: number;
         readonly maxForce?: number;
         readonly nodeForceCoefficient?: number;
@@ -561,35 +553,25 @@ export declare class Graph {
     readonly onBeforeClear: EventHandler<void>;
     constructor(graphStore: GraphStore);
     hasNode(nodeId: Identifier): boolean;
-    getNode(nodeId: Identifier): GraphNode | null;
-    findNodeIdByElement(element: HTMLElement): Identifier | null;
-    /**
-     * @deprecated
-     * use findNodeIdByElement instead
-     */
-    getElementNodeId(element: HTMLElement): Identifier | null;
+    getNode(nodeId: Identifier): GraphNode;
+    findNodeIdByElement(element: HTMLElement): Identifier | undefined;
     getAllNodeIds(): readonly Identifier[];
     hasPort(portId: Identifier): boolean;
-    getPort(portId: Identifier): GraphPort | null;
+    getPort(portId: Identifier): GraphPort;
     getAllPortIds(): readonly Identifier[];
-    getNodePortIds(nodeId: Identifier): readonly Identifier[] | null;
-    /**
-     * @deprecated
-     * use findPortIdsByElement instead
-     */
-    getElementPortIds(element: HTMLElement): readonly Identifier[];
+    getNodePortIds(nodeId: Identifier): readonly Identifier[];
     findPortIdsByElement(element: HTMLElement): readonly Identifier[];
     getAllEdgeIds(): readonly Identifier[];
     hasEdge(edgeId: Identifier): boolean;
-    getEdge(edgeId: Identifier): GraphEdge | null;
-    getPortIncomingEdgeIds(portId: Identifier): readonly Identifier[] | null;
-    getPortOutgoingEdgeIds(portId: Identifier): readonly Identifier[] | null;
-    getPortCycleEdgeIds(portId: Identifier): readonly Identifier[] | null;
-    getPortAdjacentEdgeIds(portId: Identifier): readonly Identifier[] | null;
-    getNodeIncomingEdgeIds(nodeId: Identifier): readonly Identifier[] | null;
-    getNodeOutgoingEdgeIds(nodeId: Identifier): readonly Identifier[] | null;
-    getNodeCycleEdgeIds(nodeId: Identifier): readonly Identifier[] | null;
-    getNodeAdjacentEdgeIds(nodeId: Identifier): readonly Identifier[] | null;
+    getEdge(edgeId: Identifier): GraphEdge;
+    getPortIncomingEdgeIds(portId: Identifier): readonly Identifier[];
+    getPortOutgoingEdgeIds(portId: Identifier): readonly Identifier[];
+    getPortCycleEdgeIds(portId: Identifier): readonly Identifier[];
+    getPortAdjacentEdgeIds(portId: Identifier): readonly Identifier[];
+    getNodeIncomingEdgeIds(nodeId: Identifier): readonly Identifier[];
+    getNodeOutgoingEdgeIds(nodeId: Identifier): readonly Identifier[];
+    getNodeCycleEdgeIds(nodeId: Identifier): readonly Identifier[];
+    getNodeAdjacentEdgeIds(nodeId: Identifier): readonly Identifier[];
 }
 
 export declare interface GraphEdge {
@@ -650,34 +632,22 @@ declare class GraphStore {
     readonly onBeforeClear: EventHandler<void>;
     constructor();
     hasNode(nodeId: Identifier): boolean;
-    /**
-     * TODO: v8
-     * throw error when node does not exist
-     */
-    getNode(nodeId: Identifier): StoreNode | undefined;
+    getNode(nodeId: Identifier): StoreNode;
     addNode(request: AddNodeRequest_2): void;
     getAllNodeIds(): readonly Identifier[];
     findNodeIdByElement(element: HTMLElement): Identifier | undefined;
     updateNode(nodeId: Identifier, request: UpdateNodeRequest_2): void;
     removeNode(nodeId: Identifier): void;
     hasPort(portId: Identifier): boolean;
-    /**
-     * TODO: v8
-     * throw error when port does not exist
-     */
-    getPort(portId: Identifier): StorePort | undefined;
+    getPort(portId: Identifier): StorePort;
     addPort(request: AddPortRequest): void;
     updatePort(portId: Identifier, request: UpdatePortRequest_2): void;
     getAllPortIds(): readonly Identifier[];
     findPortIdsByElement(element: HTMLElement): readonly Identifier[];
-    getNodePortIds(nodeId: Identifier): readonly Identifier[] | undefined;
+    getNodePortIds(nodeId: Identifier): readonly Identifier[];
     removePort(portId: Identifier): void;
     hasEdge(edgeId: Identifier): boolean;
-    /**
-     * TODO: v8
-     * throw error when edge does not exist
-     */
-    getEdge(edgeId: Identifier): StoreEdge | undefined;
+    getEdge(edgeId: Identifier): StoreEdge;
     addEdge(request: AddEdgeRequest_2): void;
     updateEdge(edgeId: Identifier, request: UpdateEdgeRequest_2): void;
     getAllEdgeIds(): readonly Identifier[];
@@ -777,11 +747,7 @@ export declare class InteractiveEdgeShape implements StructuredEdgeShape {
 }
 
 export declare interface LayoutAlgorithm {
-    /**
-     * TODO: v8
-     * make single parameter object
-     */
-    calculateCoordinates(graph: Graph, viewport: Viewport): ReadonlyMap<Identifier, Point>;
+    calculateCoordinates(params: LayoutAlgorithmParams): ReadonlyMap<Identifier, Point>;
 }
 
 declare type LayoutAlgorithmConfig = {
@@ -796,16 +762,6 @@ declare type LayoutAlgorithmConfig = {
     readonly nodeMass?: number;
     readonly edgeEquilibriumLength?: number;
     readonly edgeStiffness?: number;
-    /**
-     * @deprecated
-     * use convergenceVelocity instead
-     */
-    readonly effectiveDistance?: number;
-    /**
-     * @deprecated
-     * use convergenceVelocity instead
-     */
-    readonly convergenceDelta?: number;
     readonly convergenceVelocity?: number;
     readonly maxForce?: number;
     readonly nodeForceCoefficient?: number;
@@ -815,13 +771,12 @@ declare type LayoutAlgorithmConfig = {
     };
 };
 
+export declare interface LayoutAlgorithmParams {
+    readonly graph: Graph;
+    readonly viewport: Viewport;
+}
+
 export declare type LayoutApplyOn = {
-    /**
-     * @deprecated
-     * use "topologyChangeMacrotask" instead
-     */
-    type: "topologyChangeTimeout";
-} | {
     type: "topologyChangeMacrotask";
 } | {
     type: "topologyChangeMicrotask";