feat(core,composables): add useNodesData composable

packages/core/src/composables/useNodesData.ts

@@ -0,0 +1,44 @@
+import { computed } from 'vue'
+import type { GraphNode, Node } from '../types'
+import { useVueFlow } from './useVueFlow'
+
+/**
+ * Composable for receiving data of one or multiple nodes
+ *
+ * @public
+ * @param nodeId - The id (or ids) of the node to get the data from
+ * @param guard - Optional guard function to narrow down the node type
+ * @returns An array of data objects
+ */
+export function useNodesData<NodeType extends Node = GraphNode>(nodeId: string): NodeType['data'] | null
+export function useNodesData<NodeType extends Node = GraphNode>(nodeIds: string[]): NodeType['data'][]
+export function useNodesData<NodeType extends Node = GraphNode>(
+  nodeIds: string[],
+  guard: (node: Node) => node is NodeType,
+): NodeType['data'][]
+export function useNodesData(nodeIds: any): any {
+  const { findNode } = useVueFlow()
+
+  return computed({
+    get() {
+      if (!Array.isArray(nodeIds)) {
+        return findNode(nodeIds)?.data || null
+      }
+
+      const data = []
+
+      for (const nodeId of nodeIds) {
+        const nodeData = findNode(nodeId)?.data
+
+        if (nodeData) {
+          data.push(nodeData)
+        }
+      }
+
+      return data
+    },
+    set() {
+      console.warn('You are trying to set node data via useNodesData. This is not supported.')
+    },
+  })
+}