@dxos/plugin-deck 0.8.4-main.70d3990 → 0.8.4-main.74a063c4e0

package/package.json

@@ -1,28 +1,51 @@
 {
   "name": "@dxos/plugin-deck",
-  "version": "0.8.4-main.70d3990",
+  "version": "0.8.4-main.74a063c4e0",
   "description": "DXOS Surface plugin for the main application layout.",
   "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",
+  "imports": {
+    "#capabilities": "./src/capabilities/index.ts",
+    "#components": "./src/components/index.ts",
+    "#containers": "./src/containers/index.ts",
+    "#hooks": "./src/hooks/index.ts",
+    "#meta": "./src/meta.ts",
+    "#operations": "./src/operations/index.ts",
+    "#types": "./src/types/index.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs"
     },
+    "./operations": {
+      "source": "./src/operations/index.ts",
+      "types": "./dist/types/src/operations/index.d.ts",
+      "browser": "./dist/lib/browser/operations/index.mjs",
+      "node": "./dist/lib/node-esm/operations/index.mjs"
+    },
     "./types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
-      "browser": "./dist/lib/browser/types/index.mjs"
+      "browser": "./dist/lib/browser/types/index.mjs",
+      "node": "./dist/lib/node-esm/types/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
+      "operations": [
+        "dist/types/src/operations/index.d.ts"
+      ],
       "types": [
         "dist/types/src/types/index.d.ts"
       ]
@@ -33,59 +56,74 @@
     "src"
   ],
   "dependencies": {
-    "@effect/ai": "0.29.1",
-    "@effect/experimental": "0.56.0",
-    "@fluentui/react-tabster": "^9.24.2",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.12.1",
+    "@effect-atom/atom": "^0.5.1",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/ai": "0.33.2",
+    "@effect/experimental": "0.58.0",
+    "@fluentui/react-tabster": "9.26.11",
     "@radix-ui/react-context": "1.1.1",
+    "@tauri-apps/plugin-deep-link": "^2.2.0",
     "immer": "^10.1.1",
-    "@dxos/ai": "0.8.4-main.70d3990",
-    "@dxos/assistant": "0.8.4-main.70d3990",
-    "@dxos/blueprints": "0.8.4-main.70d3990",
-    "@dxos/async": "0.8.4-main.70d3990",
-    "@dxos/debug": "0.8.4-main.70d3990",
-    "@dxos/echo": "0.8.4-main.70d3990",
-    "@dxos/echo-signals": "0.8.4-main.70d3990",
-    "@dxos/invariant": "0.8.4-main.70d3990",
-    "@dxos/keyboard": "0.8.4-main.70d3990",
-    "@dxos/live-object": "0.8.4-main.70d3990",
-    "@dxos/local-storage": "0.8.4-main.70d3990",
-    "@dxos/app-framework": "0.8.4-main.70d3990",
-    "@dxos/log": "0.8.4-main.70d3990",
-    "@dxos/plugin-observability": "0.8.4-main.70d3990",
-    "@dxos/plugin-graph": "0.8.4-main.70d3990",
-    "@dxos/plugin-attention": "0.8.4-main.70d3990",
-    "@dxos/react-client": "0.8.4-main.70d3990",
-    "@dxos/plugin-theme": "0.8.4-main.70d3990",
-    "@dxos/react-ui-attention": "0.8.4-main.70d3990",
-    "@dxos/react-ui-form": "0.8.4-main.70d3990",
-    "@dxos/react-ui-stack": "0.8.4-main.70d3990",
-    "@dxos/react-ui-tabs": "0.8.4-main.70d3990",
-    "@dxos/react-ui-text-tooltip": "0.8.4-main.70d3990",
-    "@dxos/util": "0.8.4-main.70d3990"
+    "@dxos/ai": "0.8.4-main.74a063c4e0",
+    "@dxos/app-framework": "0.8.4-main.74a063c4e0",
+    "@dxos/app-toolkit": "0.8.4-main.74a063c4e0",
+    "@dxos/assistant": "0.8.4-main.74a063c4e0",
+    "@dxos/async": "0.8.4-main.74a063c4e0",
+    "@dxos/blueprints": "0.8.4-main.74a063c4e0",
+    "@dxos/context": "0.8.4-main.74a063c4e0",
+    "@dxos/echo": "0.8.4-main.74a063c4e0",
+    "@dxos/debug": "0.8.4-main.74a063c4e0",
+    "@dxos/effect": "0.8.4-main.74a063c4e0",
+    "@dxos/errors": "0.8.4-main.74a063c4e0",
+    "@dxos/invariant": "0.8.4-main.74a063c4e0",
+    "@dxos/keyboard": "0.8.4-main.74a063c4e0",
+    "@dxos/operation": "0.8.4-main.74a063c4e0",
+    "@dxos/log": "0.8.4-main.74a063c4e0",
+    "@dxos/plugin-attention": "0.8.4-main.74a063c4e0",
+    "@dxos/plugin-client": "0.8.4-main.74a063c4e0",
+    "@dxos/plugin-graph": "0.8.4-main.74a063c4e0",
+    "@dxos/plugin-observability": "0.8.4-main.74a063c4e0",
+    "@dxos/plugin-theme": "0.8.4-main.74a063c4e0",
+    "@dxos/react-client": "0.8.4-main.74a063c4e0",
+    "@dxos/react-error-boundary": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-attention": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-form": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-menu": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-mosaic": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-tabs": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-stack": "0.8.4-main.74a063c4e0",
+    "@dxos/ui-types": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-text-tooltip": "0.8.4-main.74a063c4e0",
+    "@dxos/util": "0.8.4-main.74a063c4e0",
+    "@dxos/app-graph": "0.8.4-main.74a063c4e0"
   },
   "devDependencies": {
-    "@effect-atom/atom-react": "^0.3.4",
-    "@effect/platform": "0.92.1",
-    "@types/react": "~19.2.2",
-    "@types/react-dom": "~19.2.2",
-    "effect": "3.18.3",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
-    "vite": "7.1.9",
-    "@dxos/react-ui": "0.8.4-main.70d3990",
-    "@dxos/storybook-utils": "0.8.4-main.70d3990",
-    "@dxos/react-ui-theme": "0.8.4-main.70d3990"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "^7.1.11",
+    "@dxos/plugin-testing": "0.8.4-main.74a063c4e0",
+    "@dxos/react-hooks": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.74a063c4e0",
+    "@dxos/react-ui": "0.8.4-main.74a063c4e0",
+    "@dxos/schema": "0.8.4-main.74a063c4e0",
+    "@dxos/storybook-utils": "0.8.4-main.74a063c4e0",
+    "@dxos/ui-theme": "0.8.4-main.74a063c4e0",
+    "@dxos/random": "0.8.4-main.74a063c4e0",
+    "@dxos/types": "0.8.4-main.74a063c4e0"
   },
   "peerDependencies": {
-    "@effect-atom/atom-react": "^0.3.4",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@dxos/react-ui": "0.8.4-main.70d3990",
-    "@dxos/react-ui-theme": "0.8.4-main.70d3990"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.74a063c4e0",
+    "@dxos/ui-theme": "0.8.4-main.74a063c4e0"
   },
   "publishConfig": {
     "access": "public"

package/src/DeckPlugin.ts

@@ -4,7 +4,8 @@
 
 import { setAutoFreeze } from 'immer';
 
-import { Capabilities, Events, allOf, contributes, defineModule, definePlugin, oneOf } from '@dxos/app-framework';
+import { ActivationEvent, ActivationEvents, Plugin } from '@dxos/app-framework';
+import { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';
 import { translations as stackTranslations } from '@dxos/react-ui-stack';
 
 import {
@@ -12,14 +13,14 @@ import {
   CheckAppScheme,
   DeckSettings,
   DeckState,
-  LayoutIntentResolver,
+  OperationHandler,
   ReactRoot,
   ReactSurface,
-  Toolkit,
   UrlHandler,
-} from './capabilities';
-import { DeckEvents } from './events';
-import { meta } from './meta';
+} from '#capabilities';
+import { meta } from '#meta';
+import { DeckEvents } from '#types';
+
 import { translations } from './translations';
 
 // NOTE(Zan): When producing values with immer, we shouldn't auto-freeze them because
@@ -27,65 +28,39 @@ import { translations } from './translations';
 // TODO(Zan): Move this to a more global location if we use immer more broadly.
 setAutoFreeze(false);
 
-export const DeckPlugin = definePlugin(meta, () => [
-  defineModule({
-    id: `${meta.id}/module/check-app-scheme`,
-    activatesOn: Events.SettingsReady,
-    activate: CheckAppScheme,
-  }),
-  defineModule({
-    id: `${meta.id}/module/settings`,
-    activatesOn: Events.SetupSettings,
+export const DeckPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations: [...translations, ...stackTranslations] }),
+  Plugin.addModule({
+    activatesOn: AppActivationEvents.SetupSettings,
+    activatesAfter: [DeckEvents.SettingsReady],
     activate: DeckSettings,
   }),
-  defineModule({
-    id: `${meta.id}/module/layout`,
+  Plugin.addModule({
+    activatesOn: ActivationEvent.allOf(DeckEvents.SettingsReady, ActivationEvents.OperationInvokerReady),
+    activate: CheckAppScheme,
+  }),
+  Plugin.addModule({
     // TODO(wittjosiah): Does not integrate with settings store.
     //   Should this be a different event?
     //   Should settings store be renamed to be more generic?
-    activatesOn: oneOf(Events.SetupSettings, Events.SetupAppGraph),
-    activatesAfter: [Events.LayoutReady, DeckEvents.StateReady],
+    activatesOn: ActivationEvent.oneOf(AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph),
+    activatesAfter: [AppActivationEvents.LayoutReady, DeckEvents.StateReady],
     activate: DeckState,
   }),
-  defineModule({
-    id: `${meta.id}/module/translations`,
-    activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, [...translations, ...stackTranslations]),
-  }),
-  defineModule({
-    id: `${meta.id}/module/react-root`,
-    activatesOn: Events.Startup,
+  Plugin.addModule({
+    activatesOn: ActivationEvents.Startup,
     activate: ReactRoot,
   }),
-  defineModule({
-    id: `${meta.id}/module/react-surface`,
-    activatesOn: Events.SetupReactSurface,
-    activate: ReactSurface,
-  }),
-  defineModule({
-    id: `${meta.id}/module/layout-intent-resolver`,
-    activatesOn: Events.SetupIntentResolver,
-    activate: LayoutIntentResolver,
-  }),
-  defineModule({
-    id: `${meta.id}/module/app-graph-builder`,
-    activatesOn: Events.SetupAppGraph,
-    activate: AppGraphBuilder,
-  }),
-  // defineModule({
-  //   id: `${meta.id}/module/tools`,
+  // Plugin.addModule({
   //   activatesOn: Events.SetupArtifactDefinition,
   //   activate: Tools,
   // }),
-  defineModule({
-    id: `${meta.id}/module/toolkit`,
-    // TODO(wittjosiah): Shouldn't use the startup event.
-    activatesOn: Events.Startup,
-    activate: Toolkit,
-  }),
-  defineModule({
-    id: `${meta.id}/module/url`,
-    activatesOn: allOf(Events.DispatcherReady, DeckEvents.StateReady),
+  Plugin.addModule({
+    activatesOn: ActivationEvent.allOf(ActivationEvents.OperationInvokerReady, DeckEvents.StateReady),
     activate: UrlHandler,
   }),
-]);
+  Plugin.make,
+);

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

@@ -2,142 +2,126 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Atom } from '@effect-atom/atom-react';
-import * as Function from 'effect/Function';
-import * as Option from 'effect/Option';
+import * as Effect from 'effect/Effect';
 
-import { Capabilities, LayoutAction, type PluginContext, contributes, createIntent } from '@dxos/app-framework';
-import { AttentionCapabilities } from '@dxos/plugin-attention';
-import { ROOT_ID, atomFromSignal, createExtension } from '@dxos/plugin-graph';
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { AppCapabilities, AppNode, LayoutOperation } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/operation';
+import { AttentionCapabilities } from '@dxos/plugin-attention/types';
+import { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';
 
-import { meta } from '../meta';
+import { meta } from '#meta';
+import { DeckCapabilities } from '#types';
 
-import { DeckCapabilities } from './capabilities';
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const extensions = yield* Effect.all([
+      GraphBuilder.createExtension({
+        id: 'not-found',
+        match: NodeMatcher.whenRoot,
+        connector: () => Effect.succeed([AppNode.makeNotFound()]),
+      }),
 
-export default (context: PluginContext) =>
-  contributes(
-    Capabilities.AppGraphBuilder,
-    createExtension({
-      id: meta.id,
-      actions: (node) =>
-        Atom.make((get) =>
-          Function.pipe(
-            get(node),
-            Option.flatMap((node) => (node.id === ROOT_ID ? Option.some(node) : Option.none())),
-            Option.map(() => {
-              const state = context.getCapability(DeckCapabilities.MutableDeckState);
+      GraphBuilder.createExtension({
+        id: 'root',
+        match: NodeMatcher.whenRoot,
+        actions: (_node, get) =>
+          Effect.gen(function* () {
+            // NOTE(Zan): This is currently disabled.
+            // TODO(Zan): Fullscreen needs to know the active node and provide that to the layout part.
+            // const _fullscreen = {
+            //   id: `${LayoutAction.UpdateLayout._tag}/fullscreen`,
+            //   data: async () => {
+            //     const { dispatchPromise: dispatch } = context.get(Capabilities.IntentDispatcher);
+            //     await dispatch(
+            //       createIntent(LayoutAction.SetLayoutMode, { part: 'mode', options: { mode: 'fullscreen' } }),
+            //     );
+            //   },
+            //   properties: {
+            //     label: ['toggle fullscreen label', { ns: meta.id }],
+            //     icon: 'ph--arrows-out--regular',
+            //     keyBinding: {
+            //       macos: 'ctrl+meta+f',
+            //       windows: 'shift+ctrl+f',
+            //     },
+            //   },
+            // };
 
-              // NOTE(Zan): This is currently disabled.
-              // TODO(Zan): Fullscreen needs to know the active node and provide that to the layout part.
-              // const _fullscreen = {
-              //   id: `${LayoutAction.UpdateLayout._tag}/fullscreen`,
-              //   data: async () => {
-              //     const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
-              //     await dispatch(
-              //       createIntent(LayoutAction.SetLayoutMode, { part: 'mode', options: { mode: 'fullscreen' } }),
-              //     );
-              //   },
-              //   properties: {
-              //     label: ['toggle fullscreen label', { ns: meta.id }],
-              //     icon: 'ph--arrows-out--regular',
-              //     keyBinding: {
-              //       macos: 'ctrl+meta+f',
-              //       windows: 'shift+ctrl+f',
-              //     },
-              //   },
-              // };
+            const closeCurrent = {
+              id: `${LayoutOperation.Close.meta.key}.current`,
+              data: Effect.fnUntraced(function* () {
+                const attention = yield* Capability.get(AttentionCapabilities.Attention);
+                const attended = attention.getCurrent().at(-1);
+                if (attended) {
+                  yield* Operation.invoke(LayoutOperation.Close, { subject: [attended] });
+                }
+              }),
+              properties: {
+                label: ['close-current.label', { ns: meta.id }],
+                icon: 'ph--x--regular',
+              },
+            };
 
-              const closeCurrent = {
-                id: `${LayoutAction.Close._tag}/current`,
-                data: async () => {
-                  const attention = context.getCapability(AttentionCapabilities.Attention);
-                  const attended = attention.current.at(-1);
-                  if (attended) {
-                    const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
-                    await dispatch(
-                      createIntent(LayoutAction.Close, {
-                        part: 'main',
-                        subject: [attended],
-                        options: { state: false },
-                      }),
-                    );
-                  }
-                },
-                properties: {
-                  label: ['close current label', { ns: meta.id }],
-                  icon: 'ph--x--regular',
-                },
-              };
+            const closeOthers = {
+              id: `${LayoutOperation.Close.meta.key}.others`,
+              data: Effect.fnUntraced(function* () {
+                const attention = yield* Capability.get(AttentionCapabilities.Attention);
+                const deck = yield* DeckCapabilities.getDeck();
+                const attended = attention.getCurrent().at(-1);
+                const ids = deck.active.filter((id: string) => id !== attended) ?? [];
+                yield* Operation.invoke(LayoutOperation.Close, { subject: ids });
+              }),
+              properties: {
+                label: ['close-others.label', { ns: meta.id }],
+                icon: 'ph--x-square--regular',
+              },
+            };
 
-              const closeOthers = {
-                id: `${LayoutAction.Close._tag}/others`,
-                data: async () => {
-                  const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
-                  const attention = context.getCapability(AttentionCapabilities.Attention);
-                  const attended = attention.current.at(-1);
-                  const ids = state.deck.active.filter((id) => id !== attended) ?? [];
-                  await dispatch(
-                    createIntent(LayoutAction.Close, { part: 'main', subject: ids, options: { state: false } }),
-                  );
-                },
-                properties: {
-                  label: ['close others label', { ns: meta.id }],
-                  icon: 'ph--x-square--regular',
-                },
-              };
+            const closeAll = {
+              id: `${LayoutOperation.Close.meta.key}.all`,
+              data: Effect.fnUntraced(function* () {
+                const deck = yield* DeckCapabilities.getDeck();
+                yield* Operation.invoke(LayoutOperation.Close, { subject: deck.active });
+              }),
+              properties: {
+                label: ['close-all.label', { ns: meta.id }],
+                icon: 'ph--x-circle--regular',
+              },
+            };
 
-              const closeAll = {
-                id: `${LayoutAction.Close._tag}/all`,
-                data: async () => {
-                  const { dispatchPromise: dispatch } = context.getCapability(Capabilities.IntentDispatcher);
-                  await dispatch(
-                    createIntent(LayoutAction.Close, {
-                      part: 'main',
-                      subject: state.deck.active,
-                      options: { state: false },
-                    }),
-                  );
-                },
-                properties: {
-                  label: ['close all label', { ns: meta.id }],
-                  icon: 'ph--x-circle--regular',
-                },
-              };
+            const state = get(yield* Capability.get(DeckCapabilities.State));
+            const deck = state.decks[state.activeDeck];
 
-              const toggleSidebar = {
-                id: `${LayoutAction.UpdateSidebar._tag}/nav`,
-                data: async () => {
-                  state.sidebarState = state.sidebarState === 'expanded' ? 'collapsed' : 'expanded';
+            const toggleSidebar = {
+              id: `${LayoutOperation.UpdateSidebar.meta.key}.nav`,
+              data: Effect.fnUntraced(function* () {
+                yield* Capabilities.updateAtomValue(DeckCapabilities.State, (s) => ({
+                  ...s,
+                  sidebarState: s.sidebarState === 'expanded' ? ('collapsed' as const) : ('expanded' as const),
+                }));
+              }),
+              properties: {
+                label: [
+                  state.sidebarState === 'expanded'
+                    ? 'collapse navigation sidebar label'
+                    : 'open navigation sidebar label',
+                  { ns: meta.id },
+                ],
+                icon: 'ph--sidebar--regular',
+                keyBinding: {
+                  macos: "meta+'",
                 },
-                properties: {
-                  label: [
-                    get(
-                      atomFromSignal(() =>
-                        state.sidebarState === 'expanded'
-                          ? 'collapse navigation sidebar label'
-                          : 'open navigation sidebar label',
-                      ),
-                    ),
-                    { ns: meta.id },
-                  ],
-                  icon: 'ph--sidebar--regular',
-                  keyBinding: {
-                    macos: "meta+'",
-                  },
-                  disposition: 'pin-end',
-                  position: 'hoist',
-                  l0Breakpoint: 'lg',
-                },
-              };
+                disposition: 'pin-end',
+                position: 'hoist',
+                l0Breakpoint: 'lg',
+              },
+            };
+
+            return !deck?.solo ? [closeCurrent, closeOthers, closeAll, toggleSidebar] : [toggleSidebar];
+          }),
+      }),
+    ]);
 
-              return get(
-                atomFromSignal(() =>
-                  !state.deck.solo ? [closeCurrent, closeOthers, closeAll, toggleSidebar] : [toggleSidebar],
-                ),
-              );
-            }),
-            Option.getOrElse(() => []),
-          ),
-        ),
-    }),
-  );
+    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions.flat());
+  }),
+);