@angflow/angular 0.0.1

package/dist/esm/lib/services/ng-flow.service.d.ts

@@ -0,0 +1,186 @@
+import { type Signal } from '@angular/core';
+import { type XYPosition, type SnapGrid, type Viewport, type Rect, type FitViewOptionsBase, type HandleConnection, type ConnectionState } from '@angflow/system';
+import type { Node, Edge, InternalNode, DeleteElementsOptions } from '../types';
+import * as i0 from "@angular/core";
+export declare class NgFlowService<NodeType extends Node = Node, EdgeType extends Edge = Edge> {
+    private store;
+    private destroyRef;
+    /** Reactive access to all nodes. */
+    readonly nodes: Signal<NodeType[]>;
+    /** Reactive access to all edges. */
+    readonly edges: Signal<EdgeType[]>;
+    /** Reactive access to the current viewport (x, y, zoom). */
+    readonly viewport: Signal<Viewport>;
+    /** Reactive access to currently selected nodes. */
+    readonly selectedNodes: Signal<NodeType[]>;
+    /** Reactive access to currently selected edges. */
+    readonly selectedEdges: Signal<EdgeType[]>;
+    /** Reactive access to the current connection state during drag-connect. Null when idle. */
+    readonly connection: Signal<ConnectionState>;
+    /** Reactive signal indicating whether all nodes have been measured and positioned. */
+    readonly nodesInitialized: Signal<boolean>;
+    /**
+     * Returns a reactive signal containing the data property of specified nodes.
+     * Call once and store the reference — do not call repeatedly in templates.
+     */
+    nodesData(nodeIds: string[]): Signal<{
+        id: string;
+        data: Record<string, unknown>;
+        type?: string;
+    }[]>;
+    zoomIn(options?: {
+        duration?: number;
+    }): Promise<boolean>;
+    zoomOut(options?: {
+        duration?: number;
+    }): Promise<boolean>;
+    zoomTo(zoomLevel: number, options?: {
+        duration?: number;
+    }): Promise<boolean>;
+    fitView(options?: FitViewOptionsBase<NodeType>): Promise<boolean>;
+    setViewport(viewport: Viewport, options?: {
+        duration?: number;
+    }): Promise<void>;
+    getViewport(): Viewport;
+    getZoom(): number;
+    setCenter(x: number, y: number, options?: {
+        zoom?: number;
+        duration?: number;
+    }): Promise<boolean>;
+    fitBounds(bounds: Rect, options?: {
+        padding?: number;
+        duration?: number;
+    }): Promise<boolean>;
+    screenToFlowPosition(clientPosition: XYPosition, options?: {
+        snapToGrid?: boolean;
+        snapGrid?: SnapGrid;
+    }): XYPosition;
+    flowToScreenPosition(flowPosition: XYPosition): XYPosition;
+    getNode(id: string): NodeType | undefined;
+    getNodes(ids?: string[]): NodeType[];
+    getInternalNode(id: string): InternalNode<NodeType> | undefined;
+    setNodes(nodes: NodeType[]): void;
+    addNodes(nodes: NodeType | NodeType[]): void;
+    updateNode(id: string, nodeUpdate: Partial<NodeType> | ((node: NodeType) => Partial<NodeType>)): void;
+    updateNodeData(id: string, dataUpdate: Record<string, unknown> | ((data: NodeType['data']) => Record<string, unknown>)): void;
+    getEdge(id: string): EdgeType | undefined;
+    getEdges(): EdgeType[];
+    setEdges(edges: EdgeType[]): void;
+    addEdges(edges: EdgeType | EdgeType[]): void;
+    updateEdge(id: string, edgeUpdate: Partial<EdgeType> | ((edge: EdgeType) => Partial<EdgeType>)): void;
+    updateEdgeData(id: string, dataUpdate: Record<string, unknown> | ((data: EdgeType['data']) => Record<string, unknown>)): void;
+    deleteElements(params: DeleteElementsOptions): Promise<{
+        deletedNodes: NodeType[];
+        deletedEdges: EdgeType[];
+    }>;
+    getIntersectingNodes(node: NodeType, partially?: boolean): NodeType[];
+    isNodeIntersecting(node: NodeType, area: Rect, partially?: boolean): boolean;
+    getNodesBounds(nodes: NodeType[]): Rect;
+    getConnectedEdges(nodeIds: string | string[]): EdgeType[];
+    getHandleConnections(params: {
+        nodeId: string;
+        type: 'source' | 'target';
+        id?: string;
+    }): HandleConnection[];
+    getNodeConnections(nodeId: string): HandleConnection[];
+    toObject(): {
+        nodes: NodeType[];
+        edges: EdgeType[];
+        viewport: Viewport;
+    };
+    /**
+     * Returns a signal containing the data for specific node(s).
+     * Equivalent to React's `useNodesData()`.
+     */
+    selectNodesData(nodeIds: string | string[]): Signal<{
+        id: string;
+        data: Record<string, unknown>;
+        type?: string;
+    }[]>;
+    /**
+     * Returns a signal containing all connections for a node.
+     * Equivalent to React's `useNodeConnections()`.
+     */
+    selectNodeConnections(nodeId: string): Signal<HandleConnection[]>;
+    /**
+     * Returns a signal containing connections for a specific handle.
+     * Equivalent to React's `useHandleConnections()`.
+     */
+    selectHandleConnections(params: {
+        nodeId: string;
+        type: 'source' | 'target';
+        id?: string;
+    }): Signal<HandleConnection[]>;
+    /**
+     * Returns a signal with the internal node for a given ID.
+     * Equivalent to React's `useInternalNode()`.
+     */
+    selectInternalNode(nodeId: string): Signal<InternalNode<NodeType> | undefined>;
+    /**
+     * Returns a signal indicating whether all nodes have been initialized (have measured dimensions).
+     * Equivalent to React's `useNodesInitialized()`.
+     */
+    selectNodesInitialized(): Signal<boolean>;
+    /**
+     * Triggers a recalculation of node internals (e.g., after handle positions change).
+     * Equivalent to React's `useUpdateNodeInternals()`.
+     */
+    updateNodeInternals(nodeIds: string | string[]): void;
+    /**
+     * Returns a reactive signal of the current viewport.
+     * Equivalent to React's `useViewport()` / `useOnViewportChange()`.
+     */
+    selectViewport(): Signal<Viewport>;
+    /**
+     * Returns a reactive signal of the currently selected nodes and edges.
+     * Equivalent to React's `useOnSelectionChange()`.
+     */
+    selectSelectedElements(): Signal<{
+        nodes: NodeType[];
+        edges: EdgeType[];
+    }>;
+    /**
+     * Returns a signal that tracks whether a specific key (or any key in an array) is currently pressed.
+     * Equivalent to React's `useKeyPress()`.
+     * Automatically cleaned up when the service is destroyed.
+     */
+    selectKeyPressed(keyCode: string | string[]): Signal<boolean>;
+    /**
+     * Whether the viewport/panZoom has been initialized.
+     */
+    get viewportInitialized(): boolean;
+    /**
+     * Returns a signal containing the data for specific edge(s).
+     */
+    selectEdgesData(edgeIds: string | string[]): Signal<{
+        id: string;
+        data: Record<string, unknown>;
+        type?: string;
+    }[]>;
+    /**
+     * Returns a reactive signal of the outgoing neighbor nodes for a given node ID.
+     */
+    selectOutgoers(nodeId: string): Signal<NodeType[]>;
+    /**
+     * Returns a reactive signal of the incoming neighbor nodes for a given node ID.
+     */
+    selectIncomers(nodeId: string): Signal<NodeType[]>;
+    /**
+     * Returns a reactive signal of all edges connected to a given node ID (as source or target).
+     */
+    selectConnectedEdges(nodeId: string): Signal<EdgeType[]>;
+    /**
+     * Registers middleware that intercepts node changes before they are applied.
+     * Returns an unregister function.
+     */
+    onNodesChangeMiddleware(id: string, fn: (changes: import('@angflow/system').NodeChange<NodeType>[]) => import('@angflow/system').NodeChange<NodeType>[]): () => void;
+    /**
+     * Registers middleware that intercepts edge changes before they are applied.
+     * Returns an unregister function.
+     */
+    onEdgesChangeMiddleware(id: string, fn: (changes: import('@angflow/system').EdgeChange<EdgeType>[]) => import('@angflow/system').EdgeChange<EdgeType>[]): () => void;
+    private getViewportForBoundsInternal;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgFlowService<any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NgFlowService<any, any>>;
+}
+//# sourceMappingURL=ng-flow.service.d.ts.map

package/dist/esm/lib/services/ng-flow.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-flow.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/ng-flow.service.ts"],"names":[],"mappings":"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"}