@dxos/plugin-graph 0.8.4-main.8342792842 → 0.8.4-main.8360d9e660

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-graph",
-  "version": "0.8.4-main.8342792842",
+  "version": "0.8.4-main.8360d9e660",
   "description": "DXOS Surface plugin for constructing knowledge graphs",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -29,14 +29,14 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/app-toolkit": "0.8.4-main.8342792842",
-    "@dxos/app-framework": "0.8.4-main.8342792842",
-    "@dxos/async": "0.8.4-main.8342792842",
-    "@dxos/debug": "0.8.4-main.8342792842",
-    "@dxos/app-graph": "0.8.4-main.8342792842",
-    "@dxos/util": "0.8.4-main.8342792842",
-    "@dxos/effect": "0.8.4-main.8342792842",
-    "@dxos/operation": "0.8.4-main.8342792842"
+    "@dxos/app-toolkit": "0.8.4-main.8360d9e660",
+    "@dxos/async": "0.8.4-main.8360d9e660",
+    "@dxos/debug": "0.8.4-main.8360d9e660",
+    "@dxos/effect": "0.8.4-main.8360d9e660",
+    "@dxos/operation": "0.8.4-main.8360d9e660",
+    "@dxos/util": "0.8.4-main.8360d9e660",
+    "@dxos/app-framework": "0.8.4-main.8360d9e660",
+    "@dxos/app-graph": "0.8.4-main.8360d9e660"
   },
   "devDependencies": {
     "@effect-atom/atom-react": "^0.5.0",
@@ -46,9 +46,9 @@
     "effect": "3.19.16",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "7.1.9",
-    "@dxos/react-client": "0.8.4-main.8342792842",
-    "@dxos/storybook-utils": "0.8.4-main.8342792842"
+    "vite": "^7.1.11",
+    "@dxos/react-client": "0.8.4-main.8360d9e660",
+    "@dxos/storybook-utils": "0.8.4-main.8360d9e660"
   },
   "peerDependencies": {
     "@effect-atom/atom-react": "^0.5.0",

package/src/graph.ts

@@ -12,7 +12,7 @@ import { AppCapabilities } from '@dxos/app-toolkit';
 // TODO(wittjosiah): Remove or restore graph caching.
 // import { meta } from './meta';
 
-// const KEY = `${meta.id}/app-graph`;
+// const KEY = `${meta.id}.app-graph`;
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
@@ -37,7 +37,7 @@ export default Capability.makeModule(
     );
 
     // await builder.initialize();
-    void Graph.expand(builder.graph, Node.RootId);
+    void Graph.expand(builder.graph, Node.RootId, 'child');
 
     setupDevtools(builder.graph);
 

package/src/hooks/useNode.ts

@@ -4,6 +4,7 @@
 
 import { useAtomValue } from '@effect-atom/atom-react';
 import * as Option from 'effect/Option';
+import { useMemo } from 'react';
 
 import { type Graph, type Node } from '@dxos/app-graph';
 
@@ -17,13 +18,38 @@ import { type Graph, type Node } from '@dxos/app-graph';
  */
 // TODO(wittjosiah): Factor out to @dxos/app-graph/react.
 export const useNode = <T = any>(graph: Graph.ReadableGraph, id?: string): Node.Node<T> | undefined => {
-  return Option.getOrElse(useAtomValue(graph.node(id ?? '')), () => undefined);
+  const atom = useMemo(() => graph.node(id ?? ''), [graph, id]);
+  return Option.getOrElse(useAtomValue(atom), () => undefined);
 };
 
-export const useConnections = (graph: Graph.ReadableGraph, id?: string, relation?: Node.Relation): Node.Node[] => {
+export const useConnections = (
+  graph: Graph.ReadableGraph,
+  id: string | undefined,
+  relation: Node.RelationInput,
+): Node.Node[] => {
   return useAtomValue(graph.connections(id ?? '', relation));
 };
 
+/**
+ * React hook to get actions available for a node.
+ *
+ * @param graph Graph containing the node.
+ * @param id Id of the node.
+ * @returns Actions available for the node.
+ */
 export const useActions = (graph: Graph.ReadableGraph, id?: string): Node.Node[] => {
-  return useAtomValue(graph.actions(id ?? ''));
+  const atom = useMemo(() => graph.actions(id ?? ''), [graph, id]);
+  return useAtomValue(atom);
+};
+
+/**
+ * Subscribe to just the edge topology (inbound/outbound IDs) of a node without subscribing to node content.
+ *
+ * @param graph Graph containing the node.
+ * @param id Id of the node.
+ * @returns Edge topology for the node.
+ */
+export const useEdges = (graph: Graph.ReadableGraph, id?: string): Graph.Edges => {
+  const atom = useMemo(() => graph.edges(id ?? ''), [graph, id]);
+  return useAtomValue(atom);
 };

package/src/meta.ts

@@ -6,7 +6,7 @@ import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
 export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/graph',
+  id: 'org.dxos.plugin.graph',
   name: 'Graph',
   description: trim`
     Graph database layer providing relationship modeling and queries for workspace objects.