@dxos/plugin-navtree 0.8.4-main.b97322e → 0.8.4-main.bc674ce

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "@dxos/plugin-navtree",
-  "version": "0.8.4-main.b97322e",
+  "version": "0.8.4-main.bc674ce",
   "description": "DXOS Surface plugin for a tree view visualization of the graph.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs"
     }
@@ -23,65 +28,62 @@
     "src"
   ],
   "dependencies": {
-    "@atlaskit/pragmatic-drag-and-drop": "^1.4.0",
-    "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.0.3",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.9.0",
+    "@atlaskit/pragmatic-drag-and-drop": "1.7.7",
+    "@atlaskit/pragmatic-drag-and-drop-hitbox": "1.1.0",
     "@radix-ui/react-dismissable-layer": "1.1.5",
     "@radix-ui/react-use-controllable-state": "1.1.0",
     "date-fns": "^3.3.1",
-    "effect": "3.17.0",
-    "@dxos/app-framework": "0.8.4-main.b97322e",
-    "@dxos/app-graph": "0.8.4-main.b97322e",
-    "@dxos/debug": "0.8.4-main.b97322e",
-    "@dxos/async": "0.8.4-main.b97322e",
-    "@dxos/echo": "0.8.4-main.b97322e",
-    "@dxos/invariant": "0.8.4-main.b97322e",
-    "@dxos/echo-schema": "0.8.4-main.b97322e",
-    "@dxos/live-object": "0.8.4-main.b97322e",
-    "@dxos/local-storage": "0.8.4-main.b97322e",
-    "@dxos/log": "0.8.4-main.b97322e",
-    "@dxos/keyboard": "0.8.4-main.b97322e",
-    "@dxos/plugin-graph": "0.8.4-main.b97322e",
-    "@dxos/plugin-observability": "0.8.4-main.b97322e",
-    "@dxos/protocols": "0.8.4-main.b97322e",
-    "@dxos/plugin-deck": "0.8.4-main.b97322e",
-    "@dxos/react-client": "0.8.4-main.b97322e",
-    "@dxos/react-ui-attention": "0.8.4-main.b97322e",
-    "@dxos/react-ui-menu": "0.8.4-main.b97322e",
-    "@dxos/react-ui-stack": "0.8.4-main.b97322e",
-    "@dxos/react-ui-searchlist": "0.8.4-main.b97322e",
-    "@dxos/react-ui-list": "0.8.4-main.b97322e",
-    "@dxos/util": "0.8.4-main.b97322e",
-    "@dxos/react-ui-tabs": "0.8.4-main.b97322e"
+    "@dxos/app-framework": "0.8.4-main.bc674ce",
+    "@dxos/async": "0.8.4-main.bc674ce",
+    "@dxos/app-graph": "0.8.4-main.bc674ce",
+    "@dxos/debug": "0.8.4-main.bc674ce",
+    "@dxos/echo": "0.8.4-main.bc674ce",
+    "@dxos/invariant": "0.8.4-main.bc674ce",
+    "@dxos/keyboard": "0.8.4-main.bc674ce",
+    "@dxos/lit-ui": "0.8.4-main.bc674ce",
+    "@dxos/log": "0.8.4-main.bc674ce",
+    "@dxos/operation": "0.8.4-main.bc674ce",
+    "@dxos/plugin-deck": "0.8.4-main.bc674ce",
+    "@dxos/plugin-graph": "0.8.4-main.bc674ce",
+    "@dxos/plugin-observability": "0.8.4-main.bc674ce",
+    "@dxos/protocols": "0.8.4-main.bc674ce",
+    "@dxos/react-client": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-attention": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-menu": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-list": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-mosaic": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-stack": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-tabs": "0.8.4-main.bc674ce",
+    "@dxos/react-ui-searchlist": "0.8.4-main.bc674ce",
+    "@dxos/util": "0.8.4-main.bc674ce"
   },
   "devDependencies": {
-    "@effect-rx/rx-react": "0.38.0",
-    "@effect/platform": "0.89.0",
-    "@types/react": "~18.2.0",
-    "@types/react-dom": "~18.2.0",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/echo-signals": "0.8.4-main.b97322e",
-    "@dxos/plugin-attention": "0.8.4-main.b97322e",
-    "@dxos/plugin-client": "0.8.4-main.b97322e",
-    "@dxos/plugin-space": "0.8.4-main.b97322e",
-    "@dxos/plugin-storybook-layout": "0.8.4-main.b97322e",
-    "@dxos/plugin-theme": "0.8.4-main.b97322e",
-    "@dxos/random": "0.8.4-main.b97322e",
-    "@dxos/react-ui": "0.8.4-main.b97322e",
-    "@dxos/storybook-utils": "0.8.4-main.b97322e",
-    "@dxos/react-ui-theme": "0.8.4-main.b97322e"
+    "@effect-atom/atom-react": "^0.4.6",
+    "@effect/platform": "0.93.6",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.19.11",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "7.1.9",
+    "@dxos/plugin-client": "0.8.4-main.bc674ce",
+    "@dxos/plugin-attention": "0.8.4-main.bc674ce",
+    "@dxos/plugin-space": "0.8.4-main.bc674ce",
+    "@dxos/random": "0.8.4-main.bc674ce",
+    "@dxos/plugin-theme": "0.8.4-main.bc674ce",
+    "@dxos/react-ui": "0.8.4-main.bc674ce",
+    "@dxos/storybook-utils": "0.8.4-main.bc674ce",
+    "@dxos/plugin-testing": "0.8.4-main.bc674ce",
+    "@dxos/ui-theme": "0.8.4-main.bc674ce"
   },
   "peerDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.4-main.b97322e",
-    "@dxos/react-ui-theme": "0.8.4-main.b97322e"
+    "@effect-atom/atom-react": "^0.4.6",
+    "@effect/platform": "0.93.6",
+    "effect": "3.19.11",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.bc674ce",
+    "@dxos/ui-theme": "0.8.4-main.bc674ce"
   },
   "publishConfig": {
     "access": "public"

package/src/NavTreePlugin.tsx

@@ -2,94 +2,76 @@
 // Copyright 2025 DXOS.org
 //
 
-import {
-  definePlugin,
-  defineModule,
-  Events,
-  contributes,
-  Capabilities,
-  allOf,
-  createIntent,
-  LayoutAction,
-} from '@dxos/app-framework';
+import * as Effect from 'effect/Effect';
+
+import { ActivationEvent, Capability, Common, Plugin } from '@dxos/app-framework';
+import { Graph } from '@dxos/plugin-graph';
 import { type TreeData } from '@dxos/react-ui-list';
 
-import { AppGraphBuilder, IntentResolver, Keyboard, ReactSurface, State } from './capabilities';
+import { AppGraphBuilder, Keyboard, OperationResolver, ReactSurface, State } from './capabilities';
 import { NODE_TYPE } from './components';
-import { NavTreeEvents } from './events';
 import { meta } from './meta';
 import { translations } from './translations';
+import { NavTreeEvents } from './types';
 
-export const NavTreePlugin = () =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/state`,
-      activatesOn: Events.LayoutReady,
-      activatesAfter: [NavTreeEvents.StateReady],
-      activate: State,
-    }),
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, translations),
-    }),
-    defineModule({
-      id: `${meta.id}/module/metadata`,
-      activatesOn: Events.SetupMetadata,
-      activate: () =>
-        contributes(Capabilities.Metadata, {
-          id: NODE_TYPE,
-          metadata: {
-            parse: ({ item }: TreeData, type: string) => {
-              switch (type) {
-                case 'node':
-                  return item;
-                case 'object':
-                  return item.data;
-                case 'view-object':
-                  return { id: `${item.id}-view`, object: item.data };
-              }
-            },
-          },
-        }),
-    }),
-    defineModule({
-      id: `${meta.id}/module/expose`,
-      activatesOn: allOf(Events.DispatcherReady, Events.AppGraphReady, Events.LayoutReady, NavTreeEvents.StateReady),
-      activate: async (context) => {
-        const layout = context.getCapability(Capabilities.Layout);
-        const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
-        const { graph } = context.getCapability(Capabilities.AppGraph);
-        if (dispatch && layout.active.length === 1) {
-          // TODO(wittjosiah): This should really be fired once the navtree renders for the first time.
-          //   That is the point at which the graph is expanded and the path should be available.
-          void graph
-            .waitForPath({ target: layout.active[0] }, { timeout: 30_000 })
-            .then(() => dispatch(createIntent(LayoutAction.Expose, { part: 'navigation', subject: layout.active[0] })))
-            .catch(() => {});
-        }
-
-        return [];
+export const NavTreePlugin = Plugin.define(meta).pipe(
+  Plugin.addModule({
+    id: 'state',
+    activatesOn: Common.ActivationEvent.LayoutReady,
+    activatesAfter: [NavTreeEvents.StateReady],
+    activate: State,
+  }),
+  Common.Plugin.addTranslationsModule({ translations }),
+  Common.Plugin.addMetadataModule({
+    metadata: {
+      id: NODE_TYPE,
+      metadata: {
+        parse: ({ item }: TreeData, type: string) => {
+          switch (type) {
+            case 'node':
+              return item;
+            case 'object':
+              return item.data;
+            case 'view-object':
+              return { id: `${item.id}-view`, object: item.data };
+          }
+        },
       },
+    },
+  }),
+  Plugin.addModule({
+    id: 'expose',
+    activatesOn: ActivationEvent.allOf(
+      Common.ActivationEvent.OperationInvokerReady,
+      Common.ActivationEvent.AppGraphReady,
+      Common.ActivationEvent.LayoutReady,
+      NavTreeEvents.StateReady,
+    ),
+    activate: Effect.fnUntraced(function* () {
+      const layout = yield* Common.Capability.getAtomValue(Common.Capability.Layout);
+      const { invokePromise } = yield* Capability.get(Common.Capability.OperationInvoker);
+      const { graph } = yield* Capability.get(Common.Capability.AppGraph);
+      if (invokePromise && layout.active.length === 1) {
+        // TODO(wittjosiah): This should really be fired once the navtree renders for the first time.
+        //   That is the point at which the graph is expanded and the path should be available.
+        void Graph.waitForPath(graph, { target: layout.active[0] }, { timeout: 30_000 })
+          .then(() => invokePromise(Common.LayoutOperation.Expose, { subject: layout.active[0] }))
+          .catch(() => {});
+      }
+
+      return [];
     }),
-    defineModule({
-      id: `${meta.id}/module/keyboard`,
-      activatesOn: Events.AppGraphReady,
-      activate: Keyboard,
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      activate: ReactSurface,
-    }),
-    defineModule({
-      id: `${meta.id}/module/intent-resolver`,
-      activatesOn: Events.SetupIntentResolver,
-      activate: IntentResolver,
-    }),
-    defineModule({
-      id: `${meta.id}/module/app-graph-builder`,
-      activatesOn: Events.SetupAppGraph,
-      activate: AppGraphBuilder,
-    }),
-  ]);
+  }),
+  Plugin.addModule({
+    id: 'keyboard',
+    activatesOn: ActivationEvent.allOf(
+      Common.ActivationEvent.AppGraphReady,
+      Common.ActivationEvent.OperationInvokerReady,
+    ),
+    activate: Keyboard,
+  }),
+  Common.Plugin.addSurfaceModule({ activate: ReactSurface }),
+  Common.Plugin.addOperationResolverModule({ activate: OperationResolver }),
+  Common.Plugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  Plugin.make,
+);

package/src/capabilities/app-graph-builder/app-graph-builder.ts

@@ -0,0 +1,41 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Common } from '@dxos/app-framework';
+import { Operation } from '@dxos/operation';
+import { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';
+
+import { COMMANDS_DIALOG, meta } from '../../meta';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const extensions = yield* GraphBuilder.createExtension({
+      id: meta.id,
+      match: NodeMatcher.whenRoot,
+      actions: () =>
+        Effect.succeed([
+          {
+            id: COMMANDS_DIALOG,
+            data: () =>
+              Operation.invoke(Common.LayoutOperation.UpdateDialog, {
+                subject: COMMANDS_DIALOG,
+                blockAlign: 'start',
+              }),
+            properties: {
+              label: ['open commands label', { ns: meta.id }],
+              icon: 'ph--magnifying-glass--regular',
+              keyBinding: {
+                macos: 'meta+k',
+                windows: 'ctrl+k',
+              },
+            },
+          },
+        ]),
+    });
+
+    return Capability.contributes(Common.Capability.AppGraphBuilder, extensions);
+  }),
+);

package/src/capabilities/app-graph-builder/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));

package/src/capabilities/index.ts

@@ -2,12 +2,8 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
-
-export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const Keyboard = lazy(() => import('./keyboard'));
-export const ReactSurface = lazy(() => import('./react-surface'));
-export const State = lazy(() => import('./state'));
-
-export * from './capabilities';
+export * from './app-graph-builder';
+export * from './keyboard';
+export * from './operation-resolver';
+export * from './react-surface';
+export * from './state';

package/src/capabilities/keyboard/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const Keyboard = Capability.lazy('Keyboard', () => import('./keyboard'));

package/src/capabilities/keyboard/keyboard.ts

@@ -0,0 +1,65 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Common } from '@dxos/app-framework';
+import { debounce } from '@dxos/async';
+import { Keyboard } from '@dxos/keyboard';
+import { Graph, Node, runAction } from '@dxos/plugin-graph';
+import { getHostPlatform } from '@dxos/util';
+
+import { KEY_BINDING } from '../../meta';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const { graph } = yield* Capability.get(Common.Capability.AppGraph);
+    const invoker = yield* Capability.get(Common.Capability.OperationInvoker);
+    const pluginContext = yield* Capability.Service;
+
+    // TODO(wittjosiah): Factor out.
+    // TODO(wittjosiah): Handle removal of actions.
+    const visitor = (node: Node.Node, path: string[]) => {
+      let shortcut: string | undefined;
+      if (typeof node.properties.keyBinding === 'object') {
+        const availablePlatforms = Object.keys(node.properties.keyBinding);
+        const platform = getHostPlatform();
+        shortcut = availablePlatforms.includes(platform)
+          ? node.properties.keyBinding[platform]
+          : platform === 'ios'
+            ? node.properties.keyBinding.macos // Fallback to macos if ios-specific bindings not provided.
+            : platform === 'linux' || platform === 'unknown'
+              ? node.properties.keyBinding.windows // Fallback to windows if platform-specific bindings not provided.
+              : undefined;
+      } else {
+        shortcut = node.properties.keyBinding;
+      }
+
+      if (shortcut && Node.isAction(node)) {
+        Keyboard.singleton.getContext(path.slice(0, -1).join('/')).bind({
+          shortcut,
+          handler: () => void runAction(invoker, pluginContext, node, { parent: node, caller: KEY_BINDING }),
+          data: node.properties.label,
+        });
+      }
+    };
+
+    const eventHandler = debounce(() => {
+      Graph.traverse(graph, { visitor });
+    }, 500);
+
+    const unsubscribe = graph.onNodeChanged.on(eventHandler);
+
+    // TODO(burdon): Create context and plugin.
+    Keyboard.singleton.initialize();
+    Keyboard.singleton.setCurrentContext(Node.RootId);
+
+    return Capability.contributes(Common.Capability.Null, null, () =>
+      Effect.sync(() => {
+        unsubscribe();
+        Keyboard.singleton.destroy();
+      }),
+    );
+  }),
+);

package/src/capabilities/operation-resolver/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const OperationResolver = Capability.lazy('OperationResolver', () => import('./operation-resolver'));

package/src/capabilities/operation-resolver/operation-resolver.ts

@@ -0,0 +1,41 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Common } from '@dxos/app-framework';
+import { log } from '@dxos/log';
+import { OperationResolver } from '@dxos/operation';
+import { Graph } from '@dxos/plugin-graph';
+
+import { NavTreeCapabilities } from '../../types';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(Common.Capability.OperationResolver, [
+      OperationResolver.make({
+        operation: Common.LayoutOperation.Expose,
+        handler: Effect.fnUntraced(function* ({ subject }) {
+          const { graph } = yield* Capability.get(Common.Capability.AppGraph);
+          const { getItem, setItem } = yield* Capability.get(NavTreeCapabilities.State);
+          yield* Effect.tryPromise(() => Graph.waitForPath(graph, { target: subject }, { timeout: 1_000 })).pipe(
+            Effect.andThen((path) => {
+              [...Array(path.length)].forEach((_, index) => {
+                const subpath = path.slice(0, index);
+                const value = getItem(subpath);
+                if (!value.open) {
+                  setItem(subpath, 'open', true);
+                }
+              });
+            }),
+            Effect.catchAll(() => {
+              log('Path to node not found', { subject });
+              return Effect.void;
+            }),
+          );
+        }),
+      }),
+    ]);
+  }),
+);

package/src/capabilities/react-surface/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface/react-surface.tsx

@@ -0,0 +1,54 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { Capability, Common } from '@dxos/app-framework';
+import { Node } from '@dxos/plugin-graph';
+
+import { CommandsDialogContent, CommandsTrigger, NavTreeContainer, NavTreeDocumentTitle } from '../../components';
+import { COMMANDS_DIALOG, meta } from '../../meta';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Common.Capability.ReactSurface, [
+      Common.createSurface({
+        id: COMMANDS_DIALOG,
+        role: 'dialog',
+        filter: (data): data is { props: { selected?: string } } => data.component === COMMANDS_DIALOG,
+        component: ({ data, ref }) => <CommandsDialogContent {...data.props} ref={ref} />,
+      }),
+      Common.createSurface({
+        id: `${meta.id}/navigation`,
+        role: 'navigation',
+        filter: (data): data is { popoverAnchorId?: string; topbar: boolean; current: string } =>
+          typeof data.current === 'string',
+        component: ({ data, ref }) => {
+          return (
+            <NavTreeContainer
+              tab={data.current}
+              popoverAnchorId={data.popoverAnchorId as string | undefined}
+              topbar={data.topbar as boolean}
+              ref={ref}
+            />
+          );
+        },
+      }),
+      Common.createSurface({
+        id: `${meta.id}/document-title`,
+        role: 'document-title',
+        component: ({ data }) => (
+          <NavTreeDocumentTitle node={Node.isGraphNode(data.subject) ? data.subject : undefined} />
+        ),
+      }),
+      Common.createSurface({
+        id: `${meta.id}/search-input`,
+        role: 'search-input',
+        position: 'fallback',
+        component: () => <CommandsTrigger />,
+      }),
+    ]),
+  ),
+);

package/src/capabilities/state/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const State = Capability.lazy('State', () => import('./state'));