@dxos/plugin-deck 0.8.4-main.406dc2a → 0.8.4-main.4668b7de9b

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

@@ -2,142 +2,126 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Rx } from '@effect-rx/rx-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 { Capabilities, Capability } from '@dxos/app-framework';
+import { AppCapabilities, AppNode, LayoutOperation } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
 import { AttentionCapabilities } from '@dxos/plugin-attention';
-import { ROOT_ID, createExtension, rxFromSignal } from '@dxos/plugin-graph';
+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: 'notFound',
+        match: NodeMatcher.whenRoot,
+        connector: () => Effect.succeed([AppNode.makeNotFound()]),
+      }),
 
-export default (context: PluginContext) =>
-  contributes(
-    Capabilities.AppGraphBuilder,
-    createExtension({
-      id: meta.id,
-      actions: (node) =>
-        Rx.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(
-                      rxFromSignal(() =>
-                        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: 'last',
+                l0Breakpoint: 'lg',
+              },
+            };
+
+            return !deck?.solo ? [closeCurrent, closeOthers, closeAll, toggleSidebar] : [toggleSidebar];
+          }),
+      }),
+    ]);
 
-              return get(
-                rxFromSignal(() =>
-                  !state.deck.solo ? [closeCurrent, closeOthers, closeAll, toggleSidebar] : [toggleSidebar],
-                ),
-              );
-            }),
-            Option.getOrElse(() => []),
-          ),
-        ),
-    }),
-  );
+    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions.flat());
+  }),
+);

package/src/capabilities/check-app-scheme.ts

@@ -2,39 +2,138 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Capabilities, type PluginContext, contributes } from '@dxos/app-framework';
+import * as Effect from 'effect/Effect';
 
-import { meta } from '../meta';
-import { type DeckSettingsProps } from '../types';
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { APP_SCHEME, AppCapabilities, LayoutOperation } from '@dxos/app-toolkit';
+import { runAndForwardErrors } from '@dxos/effect';
+import { isTauri } from '@dxos/util';
 
-const isSocket = !!(globalThis as any).__args;
+import { DeckCapabilities } from '#types';
 
-// TODO(mjamesderocher): Can we get this directly from Socket?
-const appScheme = 'composer://';
+/** Identifier for the native redirect dialog surface (defined in welcome plugin). */
+const NATIVE_REDIRECT_DIALOG = 'org.dxos.plugin.welcome.component.native-redirect-dialog';
 
-// TODO(mjamesderocher): Factor out as part of NavigationPlugin.
-const checkAppScheme = (url: string) => {
-  const iframe = document.createElement('iframe');
-  iframe.style.display = 'none';
-  document.body.appendChild(iframe);
+const SCHEME_TIMEOUT_MS = 500;
 
-  iframe.src = url + window.location.pathname.replace(/^\/+/, '') + window.location.search;
+const isSafari = (): boolean => {
+  const ua = navigator.userAgent;
+  return ua.includes('Safari') && !ua.includes('Chrome') && !ua.includes('Chromium');
+};
+
+/** Check if the current page URL can be converted to a valid custom scheme URL. */
+const canRedirectToScheme = (): boolean => {
+  try {
+    const schemeUrl = APP_SCHEME + window.location.pathname.replace(/^\/+/, '') + window.location.search;
+    new URL(schemeUrl);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * Try to open the native app via custom scheme.
+ * Resolves `true` if the app opened (page lost focus), `false` if it didn't within the timeout.
+ */
+const tryOpenNativeApp = (): Promise<boolean> => {
+  return new Promise((resolve) => {
+    let resolved = false;
+
+    const onBlur = () => {
+      if (!resolved) {
+        resolved = true;
+        cleanup();
+        resolve(true);
+      }
+    };
+
+    const cleanup = () => {
+      window.removeEventListener('blur', onBlur);
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+    };
 
-  const timer = setTimeout(() => {
-    document.body.removeChild(iframe);
-  }, 3000);
+    const onVisibilityChange = () => {
+      if (document.hidden) {
+        onBlur();
+      }
+    };
 
-  window.addEventListener('pagehide', (event) => {
-    clearTimeout(timer);
-    document.body.removeChild(iframe);
+    window.addEventListener('blur', onBlur);
+    document.addEventListener('visibilitychange', onVisibilityChange);
+
+    // Try the scheme via hidden iframe.
+    const schemeUrl = APP_SCHEME + window.location.pathname.replace(/^\/+/, '') + window.location.search;
+    const iframe = document.createElement('iframe');
+    iframe.style.display = 'none';
+    iframe.src = schemeUrl;
+    document.body.appendChild(iframe);
+    setTimeout(() => iframe.remove(), 3000);
+
+    // If no blur within timeout, the app isn't running.
+    setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        cleanup();
+        resolve(false);
+      }
+    }, SCHEME_TIMEOUT_MS);
   });
 };
 
-export default async (context: PluginContext) => {
-  const settings = context.getCapability(Capabilities.SettingsStore).getStore<DeckSettingsProps>(meta.id)?.value;
-  if (!isSocket && settings?.enableNativeRedirect) {
-    checkAppScheme(appScheme);
-  }
+/** Dispatch all NavigationHandler contributions with the current page URL. */
+const dispatchNavigationHandlers = Effect.fn(function* () {
+  const url = new URL(window.location.href);
+  const handlers = yield* Capability.getAll(AppCapabilities.NavigationHandler);
+  yield* Effect.all(
+    handlers.map((handler) => handler(url)),
+    { concurrency: 'unbounded' },
+  );
+});
 
-  return contributes(Capabilities.Null, null);
+/**
+ * Checks whether the native redirect setting is enabled and the redirect should be attempted.
+ * Exported for the URL handler to decide whether to defer NavigationHandler dispatch.
+ */
+export const shouldDeferNavigationHandlers = (): boolean => {
+  return !isTauri() && !isSafari() && !import.meta.env.DEV && canRedirectToScheme();
 };
+
+/**
+ * When running in a web browser (not Tauri) with native redirect enabled,
+ * tries to open the native app via custom scheme. Defers NavigationHandlers
+ * to prevent the web app from consuming one-time tokens before the native app.
+ *
+ * If the app opens: shows dialog with "Open here" callback that dispatches handlers.
+ * If the app doesn't open: dispatches handlers immediately.
+ * In Safari: universal links handle this natively, so the check is skipped.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const capabilities = yield* Capability.Service;
+    const { invoke } = yield* Capability.get(Capabilities.OperationInvoker);
+    const settings = yield* Capabilities.getAtomValue(DeckCapabilities.Settings);
+
+    if (!settings?.enableNativeRedirect || !shouldDeferNavigationHandlers()) {
+      return;
+    }
+
+    const appOpened = yield* Effect.promise(() => tryOpenNativeApp());
+    if (appOpened) {
+      const onOpenHere = () =>
+        Effect.gen(function* () {
+          yield* dispatchNavigationHandlers();
+          yield* invoke(LayoutOperation.UpdateDialog, { state: false });
+        }).pipe(Effect.provideService(Capability.Service, capabilities), runAndForwardErrors);
+
+      yield* invoke(LayoutOperation.UpdateDialog, {
+        subject: NATIVE_REDIRECT_DIALOG,
+        type: 'alert',
+        overlayClasses: 'dark bg-neutral-950!',
+        props: { onOpenHere },
+      });
+    } else {
+      yield* dispatchNavigationHandlers();
+    }
+  }),
+);

package/src/capabilities/index.ts

@@ -2,18 +2,18 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
+import { Capability } from '@dxos/app-framework';
+import { OperationHandlerSet } from '@dxos/compute';
 
-export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
-export const CheckAppScheme = lazy(() => import('./check-app-scheme'));
-export const DeckSettings = lazy(() => import('./settings'));
-export const DeckState = lazy(() => import('./state'));
-export const LayoutIntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactRoot = lazy(() => import('./react-root'));
-export const ReactSurface = lazy(() => import('./react-surface'));
-// export const Tools = lazy(() => import('./tools'));
-export const Toolkit = lazy(() => import('./toolkit'));
-export const UrlHandler = lazy(() => import('./url-handler'));
-
-export * from './capabilities';
-export * from './state';
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));
+export const CheckAppScheme = Capability.lazy('CheckAppScheme', () => import('./check-app-scheme'));
+export const NotificationTracker = Capability.lazy('NotificationTracker', () => import('./notification-tracker'));
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);
+export const ReactRoot = Capability.lazy('ReactRoot', () => import('./react-root'));
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
+export const DeckSettings = Capability.lazy('DeckSettings', () => import('./settings'));
+export const DeckState = Capability.lazy('DeckState', () => import('./state'));
+export const UrlHandler = Capability.lazy('UrlHandler', () => import('./url-handler'));

package/src/capabilities/notification-tracker.ts

@@ -0,0 +1,132 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import * as Fiber from 'effect/Fiber';
+import * as Stream from 'effect/Stream';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { type LayoutOperation } from '@dxos/app-toolkit';
+import { Process } from '@dxos/compute';
+
+import { meta } from '#meta';
+import { DeckCapabilities } from '#types';
+
+const NOTIFY_TOAST_DURATION = 5_000;
+const ERROR_TOAST_DURATION = 10_000;
+const UNDO_TOAST_DURATION = 10_000;
+
+/**
+ * The single producer of toasts driven by operation invocations:
+ * - Per-invoke notifications ride the process monitor: each invocation spawns a process carrying the
+ *   caller's `notify` config on its params; this tracker watches process state transitions and toasts
+ *   on start / success / failure.
+ * - Undo toasts come from the history tracker's `undoable` stream (it owns the undo registry lookup);
+ *   the toast action triggers `historyTracker.undoPromise()`.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const capabilities = yield* Capability.Service;
+    const registry = yield* Capability.get(Capabilities.AtomRegistry);
+    const ephemeralAtom = yield* Capability.get(DeckCapabilities.EphemeralState);
+    const monitor = yield* Capability.get(Capabilities.ProcessMonitor);
+
+    const addToast = (toast: LayoutOperation.Toast) => {
+      const state = registry.get(ephemeralAtom);
+      registry.set(ephemeralAtom, { ...state, toasts: [...state.toasts, toast] });
+    };
+
+    //
+    // Notifications — driven by the process monitor.
+    //
+
+    // Tracks the last-seen state per process so we only toast on transitions.
+    const lastState = new Map<Process.ID, Process.State>();
+
+    const handleProcesses = (processes: readonly Process.Info[]) => {
+      const seen = new Set<Process.ID>();
+      for (const process of processes) {
+        seen.add(process.pid);
+        const previous = lastState.get(process.pid);
+        lastState.set(process.pid, process.state);
+        if (previous === process.state) {
+          continue;
+        }
+
+        const notify = process.params.notify;
+        if (!notify) {
+          continue;
+        }
+
+        // Transition into RUNNING (the first snapshot may be a pre-RUNNING state like IDLE/HYBERNATING).
+        if (previous !== Process.State.RUNNING && process.state === Process.State.RUNNING && notify.start) {
+          addToast({ id: `notify-start-${process.pid}`, title: notify.start, duration: NOTIFY_TOAST_DURATION });
+        } else if (process.state === Process.State.SUCCEEDED && notify.success) {
+          addToast({ id: `notify-success-${process.pid}`, title: notify.success, duration: NOTIFY_TOAST_DURATION });
+        } else if (process.state === Process.State.FAILED && notify.error) {
+          addToast({
+            id: `notify-error-${process.pid}`,
+            title: notify.error,
+            ...(process.error ? { description: process.error } : {}),
+            icon: 'ph--warning--regular',
+            duration: ERROR_TOAST_DURATION,
+          });
+        }
+      }
+
+      // Drop bookkeeping for processes that have left the tree.
+      for (const pid of lastState.keys()) {
+        if (!seen.has(pid)) {
+          lastState.delete(pid);
+        }
+      }
+    };
+
+    const unsubscribeMonitor = registry.subscribe(monitor.processTreeAtom, handleProcesses);
+
+    //
+    // Undo — driven by the history tracker's `undoable` stream (it owns the registry lookup).
+    //
+
+    const showUndoToast = (message: LayoutOperation.Toast['title'], onUndo: () => void) => {
+      const undoId = `notify-undo-${crypto.randomUUID()}`;
+      const state = registry.get(ephemeralAtom);
+      // Replace the previous undo toast (only the most recent action can be undone).
+      const toasts = state.currentUndoId
+        ? state.toasts.filter((toast) => toast.id !== state.currentUndoId)
+        : state.toasts;
+      const toast: LayoutOperation.Toast = {
+        id: undoId,
+        title: message ?? ['undo-available.label', { ns: meta.id }],
+        duration: UNDO_TOAST_DURATION,
+        actionLabel: ['undo-action.label', { ns: meta.id }],
+        actionAlt: ['undo-action.alt', { ns: meta.id }],
+        closeLabel: ['undo-close.label', { ns: meta.id }],
+        onAction: onUndo,
+      };
+      registry.set(ephemeralAtom, { ...state, currentUndoId: undoId, toasts: [...toasts, toast] });
+    };
+
+    // The history tracker is contributed on ProcessManagerReady, possibly after this module activates;
+    // `waitFor` resolves it once available, then we observe its undoable stream.
+    const undoFiber = Effect.runFork(
+      Effect.gen(function* () {
+        const historyTracker = yield* Capability.waitFor(Capabilities.HistoryTracker);
+        yield* Stream.fromPubSub(historyTracker.undoable).pipe(
+          Stream.runForEach((event) =>
+            Effect.sync(() => showUndoToast(event.message, () => void historyTracker.undoPromise())),
+          ),
+        );
+      }).pipe(Effect.provideService(Capability.Service, capabilities)),
+    );
+
+    // Track both subscriptions so they are torn down when the module deactivates.
+    return Capability.contributes(Capabilities.Null, null, () =>
+      Effect.gen(function* () {
+        unsubscribeMonitor();
+        yield* Fiber.interrupt(undoFiber);
+      }),
+    );
+  }),
+);

package/src/capabilities/operation-handler.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import type { OperationHandlerSet } from '@dxos/compute';
+
+import { DeckOperationHandlerSet } from '#operations';
+
+export default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(Capabilities.OperationHandler, DeckOperationHandlerSet);
+  }),
+);