ngx-vflow 1.7.1 → 1.8.0

package/lib/vflow/components/vflow/vflow.component.d.ts

@@ -1,11 +1,10 @@
-import { OnInit } from '@angular/core';
 import { DynamicNode, Node } from '../../interfaces/node.interface';
 import { MapContextDirective } from '../../directives/map-context.directive';
 import { NodeModel } from '../../models/node.model';
 import { Edge } from '../../interfaces/edge.interface';
 import { EdgeModel } from '../../models/edge.model';
 import { ConnectionTemplateDirective, EdgeLabelHtmlTemplateDirective, EdgeTemplateDirective, GroupNodeTemplateDirective, NodeHtmlTemplateDirective, NodeSvgTemplateDirective } from '../../directives/template.directive';
-import { Point } from '../../interfaces/point.interface';
+import { SpacePoint, Point } from '../../interfaces/point.interface';
 import { ViewportState } from '../../interfaces/viewport.interface';
 import { ConnectionModel } from '../../models/connection.model';
 import { NodeChange } from '../../types/node-change.type';
@@ -15,10 +14,11 @@ import { SpacePointContextDirective } from '../../directives/space-point-context
 import { FitViewOptions } from '../../interfaces/fit-view-options.interface';
 import { Optimization } from '../../interfaces/optimization.interface';
 import { KeyboardShortcuts } from '../../types/keyboard-action.type';
+import { IntersectingNodesOptions } from '../../interfaces/intersecting-nodes-options.interface';
 import * as i0 from "@angular/core";
 import * as i1 from "../../directives/changes-controller.directive";
 import * as i2 from "../../interfaces/connection-settings.interface";
-export declare class VflowComponent implements OnInit {
+export declare class VflowComponent {
     private viewportService;
     private flowEntitiesService;
     private nodesChangeService;
@@ -132,7 +132,6 @@ export declare class VflowComponent implements OnInit {
     readonly edgesChange$: import("rxjs").Observable<EdgeChange[]>;
     protected markers: import("@angular/core").Signal<Map<number, import("ngx-vflow").Marker>>;
     protected minimap: import("@angular/core").WritableSignal<import("../../models/minimap.model").MinimapModel | null>;
-    ngOnInit(): void;
     /**
      * Change viewport to specified state
      *
@@ -166,9 +165,36 @@ export declare class VflowComponent implements OnInit {
      * Convert point received from document to point on the flow
      */
     documentPointToFlowPoint(point: Point): Point;
+    documentPointToFlowPoint(point: Point, options?: {
+        spaces: false;
+    }): Point;
+    /**
+     * Convert point received from document to a stack of space points on the flow
+     * Space point has a spaceNodeId, coordinates are relative to this node
+     */
+    documentPointToFlowPoint(point: Point, options?: {
+        spaces: true;
+    }): SpacePoint[];
+    /**
+     * Gets nodes that intersect with the specified node
+     *
+     * @template T - The type of data associated with the nodes
+     * @param nodeId - The ID of the node to check intersections for
+     * @param options.partially - If true, returns nodes that partially intersect. If false, only returns fully intersecting nodes
+     * @returns An array of nodes that intersect with the specified node
+     */
+    getIntesectingNodes<T>(nodeId: string, options?: IntersectingNodesOptions): Node<T>[] | DynamicNode<T>[];
+    /**
+     * Converts a node's position to the coordinate space of another node
+     *
+     * @param nodeId - The ID of the node whose position should be converted
+     * @param spaceNodeId - The ID of the node that defines the target coordinate space.
+     *                      If null, returns the position in global coordinates
+     * @returns {Point} The converted position. Returns {x: Infinity, y: Infinity} if either node is not found
+     */
+    toNodeSpace(nodeId: string, spaceNodeId: string | null): Point;
     protected trackNodes(idx: number, { rawNode: node }: NodeModel): Node<unknown> | DynamicNode<unknown>;
     protected trackEdges(idx: number, { edge }: EdgeModel): Edge<unknown>;
-    private setInitialNodesOrder;
     static ɵfac: i0.ɵɵFactoryDeclaration<VflowComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<VflowComponent, "vflow", never, { "view": { "alias": "view"; "required": false; }; "minZoom": { "alias": "minZoom"; "required": false; }; "maxZoom": { "alias": "maxZoom"; "required": false; }; "background": { "alias": "background"; "required": false; }; "optimization": { "alias": "optimization"; "required": false; "isSignal": true; }; "entitiesSelectable": { "alias": "entitiesSelectable"; "required": false; }; "keyboardShortcuts": { "alias": "keyboardShortcuts"; "required": false; }; "connection": { "alias": "connection"; "required": false; }; "snapGrid": { "alias": "snapGrid"; "required": false; }; "elevateNodesOnSelect": { "alias": "elevateNodesOnSelect"; "required": false; }; "elevateEdgesOnSelect": { "alias": "elevateEdgesOnSelect"; "required": false; }; "nodes": { "alias": "nodes"; "required": true; }; "edges": { "alias": "edges"; "required": false; }; }, { "onComponentNodeEvent": "onComponentNodeEvent"; }, ["nodeTemplateDirective", "nodeSvgTemplateDirective", "groupNodeTemplateDirective", "edgeTemplateDirective", "edgeLabelHtmlDirective", "connectionTemplateDirective"], never, true, [{ directive: typeof i1.ChangesControllerDirective; inputs: {}; outputs: { "onNodesChange": "onNodesChange"; "onNodesChange.position": "onNodesChange.position"; "onNodesChange.position.single": "onNodesChange.position.single"; "onNodesChange.position.many": "onNodesChange.position.many"; "onNodesChange.size": "onNodesChange.size"; "onNodesChange.size.single": "onNodesChange.size.single"; "onNodesChange.size.many": "onNodesChange.size.many"; "onNodesChange.add": "onNodesChange.add"; "onNodesChange.add.single": "onNodesChange.add.single"; "onNodesChange.add.many": "onNodesChange.add.many"; "onNodesChange.remove": "onNodesChange.remove"; "onNodesChange.remove.single": "onNodesChange.remove.single"; "onNodesChange.remove.many": "onNodesChange.remove.many"; "onNodesChange.select": "onNodesChange.select"; "onNodesChange.select.single": "onNodesChange.select.single"; "onNodesChange.select.many": "onNodesChange.select.many"; "onEdgesChange": "onEdgesChange"; "onEdgesChange.detached": "onEdgesChange.detached"; "onEdgesChange.detached.single": "onEdgesChange.detached.single"; "onEdgesChange.detached.many": "onEdgesChange.detached.many"; "onEdgesChange.add": "onEdgesChange.add"; "onEdgesChange.add.single": "onEdgesChange.add.single"; "onEdgesChange.add.many": "onEdgesChange.add.many"; "onEdgesChange.remove": "onEdgesChange.remove"; "onEdgesChange.remove.single": "onEdgesChange.remove.single"; "onEdgesChange.remove.many": "onEdgesChange.remove.many"; "onEdgesChange.select": "onEdgesChange.select"; "onEdgesChange.select.single": "onEdgesChange.select.single"; "onEdgesChange.select.many": "onEdgesChange.select.many"; }; }]>;
     static ngAcceptInputType_connection: i2.ConnectionSettings;

package/lib/vflow/interfaces/intersecting-nodes-options.interface.d.ts

@@ -0,0 +1,3 @@
+export interface IntersectingNodesOptions {
+    partially: boolean;
+}

package/lib/vflow/interfaces/point.interface.d.ts

@@ -2,3 +2,6 @@ export interface Point {
     x: number;
     y: number;
 }
+export interface SpacePoint extends Point {
+    spaceNodeId: string | null;
+}

package/lib/vflow/services/node-changes.service.d.ts

@@ -4,11 +4,7 @@ import { NodeChange } from '../types/node-change.type';
 import * as i0 from "@angular/core";
 export declare class NodesChangeService {
     protected entitiesService: FlowEntitiesService;
-    protected nodesPositionChange$: Observable<{
-        type: "position";
-        id: string;
-        point: import("ngx-vflow").Point;
-    }[]>;
+    protected nodesPositionChange$: Observable<NodeChange[]>;
     protected nodeSizeChange$: Observable<{
         type: "size";
         id: string;

package/lib/vflow/testing-utils/component-mocks/vflow-mock.component.d.ts

@@ -1,7 +1,7 @@
 import { WritableSignal, OnInit } from '@angular/core';
 import { Node, DynamicNode } from '../../interfaces/node.interface';
 import { Edge } from '../../interfaces/edge.interface';
-import { Point } from '../../interfaces/point.interface';
+import { SpacePoint, Point } from '../../interfaces/point.interface';
 import { Background } from '../../types/background.type';
 import { Optimization } from '../../interfaces/optimization.interface';
 import { KeyboardShortcuts } from '../../types/keyboard-action.type';
@@ -13,6 +13,7 @@ import { ConnectionTemplateMockDirective, EdgeLabelHtmlTemplateMockDirective, Ed
 import { VflowComponent } from '../../components/vflow/vflow.component';
 import { ConnectionModel } from '../../models/connection.model';
 import { AsInterface } from '../types';
+import { IntersectingNodesOptions } from '../../interfaces/intersecting-nodes-options.interface';
 import * as i0 from "@angular/core";
 import * as i1 from "../../interfaces/connection-settings.interface";
 export declare class VflowMockComponent implements AsInterface<VflowComponent>, OnInit {
@@ -52,7 +53,14 @@ export declare class VflowMockComponent implements AsInterface<VflowComponent>,
     zoomTo(zoom: number): void;
     panTo(point: Point): void;
     fitView(options?: FitViewOptions): void;
-    documentPointToFlowPoint(point: Point): Point;
+    documentPointToFlowPoint(point: Point, options?: {
+        spaces: false;
+    }): Point;
+    documentPointToFlowPoint(point: Point, options: {
+        spaces: true;
+    }): SpacePoint[];
+    getIntesectingNodes(nodeId: string, options?: IntersectingNodesOptions): Node[] | DynamicNode[];
+    toNodeSpace(nodeId: string, spaceNodeId: string): Point;
     getNode<T = unknown>(id: string): Node<T> | DynamicNode<T> | undefined;
     getDetachedEdges(): Edge[];
     protected createSignal<T>(value: T): WritableSignal<T>;

package/lib/vflow/utils/get-overlapping-area.d.ts

@@ -0,0 +1,2 @@
+import { Rect } from '../interfaces/rect';
+export declare const getOverlappingArea: (rectA: Rect, rectB: Rect) => number;

package/lib/vflow/utils/get-space-points.d.ts

@@ -0,0 +1,10 @@
+import { SpacePoint, Point } from '../interfaces/point.interface';
+import { NodeModel } from '../models/node.model';
+/**
+ * @todo handle regular nodes
+ *
+ * @param point global point in flow coordinates
+ * @param groups sorted array of groups
+ * @returns
+ */
+export declare function getSpacePoints(point: Point, groups: NodeModel[]): SpacePoint[];

package/lib/vflow/utils/nodes.d.ts

@@ -1,3 +1,6 @@
+import { IntersectingNodesOptions } from '../interfaces/intersecting-nodes-options.interface';
 import { Rect } from '../interfaces/rect';
 import { NodeModel } from '../models/node.model';
 export declare function getNodesBounds(nodes: NodeModel[]): Rect;
+export declare function getIntesectingNodes(nodeId: string, nodes: NodeModel[], options?: IntersectingNodesOptions): NodeModel[];
+export declare function nodeToRect(node: NodeModel): Rect;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-vflow",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "license": "MIT",
   "homepage": "https://www.ngx-vflow.org/",
   "author": "Artem Mangilev",

package/public-api.d.ts

@@ -11,6 +11,7 @@ export { ViewportState } from './lib/vflow/interfaces/viewport.interface';
 export * from './lib/vflow/interfaces/component-node-event.interface';
 export * from './lib/vflow/interfaces/fit-view-options.interface';
 export * from './lib/vflow/interfaces/optimization.interface';
+export * from './lib/vflow/interfaces/intersecting-nodes-options.interface';
 export * from './lib/vflow/types/node-change.type';
 export * from './lib/vflow/types/edge-change.type';
 export * from './lib/vflow/types/position.type';