@dxos/plugin-deck 0.7.5-main.499c70c → 0.7.5-main.5ae2ba8

package/src/DeckPlugin.ts

@@ -0,0 +1,87 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { setAutoFreeze } from 'immer';
+
+import { allOf, Capabilities, contributes, defineModule, definePlugin, Events, oneOf } from '@dxos/app-framework';
+import { translations as stackTranslations } from '@dxos/react-ui-stack';
+
+import {
+  AppGraphBuilder,
+  CheckAppScheme,
+  DeckSettings,
+  DeckState,
+  LayoutIntentResolver,
+  ReactRoot,
+  ReactSurface,
+  Tools,
+  UrlHandler,
+} from './capabilities';
+import { DeckEvents } from './events';
+import { meta } from './meta';
+import translations from './translations';
+
+// NOTE(Zan): When producing values with immer, we shouldn't auto-freeze them because
+//   our signal implementation needs to add some hidden properties to the produced values.
+// 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,
+      activate: DeckSettings,
+    }),
+    defineModule({
+      id: `${meta.id}/module/layout`,
+      // 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],
+      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,
+      activatesBefore: [DeckEvents.SetupComplementaryPanels],
+      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`,
+      activatesOn: Events.SetupArtifactDefinition,
+      activate: Tools,
+    }),
+    defineModule({
+      id: `${meta.id}/module/url`,
+      activatesOn: allOf(Events.DispatcherReady, DeckEvents.StateReady),
+      activate: UrlHandler,
+    }),
+  ]);

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

@@ -0,0 +1,113 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, createIntent, LayoutAction, type PluginsContext } from '@dxos/app-framework';
+import { AttentionCapabilities } from '@dxos/plugin-attention';
+import { createExtension, type Node, ROOT_ID } from '@dxos/plugin-graph';
+
+import { DeckCapabilities } from './capabilities';
+import { DECK_PLUGIN } from '../meta';
+
+export default (context: PluginsContext) =>
+  contributes(
+    Capabilities.AppGraphBuilder,
+    createExtension({
+      id: DECK_PLUGIN,
+      filter: (node): node is Node<null> => node.id === ROOT_ID,
+      actions: () => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+
+        // 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.requestCapability(Capabilities.IntentDispatcher);
+            await dispatch(createIntent(LayoutAction.SetLayoutMode, { part: 'mode', options: { mode: 'fullscreen' } }));
+          },
+          properties: {
+            label: ['toggle fullscreen label', { ns: DECK_PLUGIN }],
+            icon: 'ph--arrows-out--regular',
+            keyBinding: {
+              macos: 'ctrl+meta+f',
+              windows: 'shift+ctrl+f',
+            },
+          },
+        };
+
+        const closeCurrent = {
+          id: `${LayoutAction.Close._tag}/current`,
+          data: async () => {
+            const attention = context.requestCapability(AttentionCapabilities.Attention);
+            const attended = attention.current.at(-1);
+            if (attended) {
+              const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
+              await dispatch(
+                createIntent(LayoutAction.Close, { part: 'main', subject: [attended], options: { state: false } }),
+              );
+            }
+          },
+          properties: {
+            label: ['close current label', { ns: DECK_PLUGIN }],
+            icon: 'ph--x--regular',
+          },
+        };
+
+        const closeOthers = {
+          id: `${LayoutAction.Close._tag}/others`,
+          data: async () => {
+            const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
+            const attention = context.requestCapability(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: DECK_PLUGIN }],
+            icon: 'ph--x-square--regular',
+          },
+        };
+
+        const closeAll = {
+          id: `${LayoutAction.Close._tag}/all`,
+          data: async () => {
+            const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
+            await dispatch(
+              createIntent(LayoutAction.Close, {
+                part: 'main',
+                subject: state.deck.active,
+                options: { state: false },
+              }),
+            );
+          },
+          properties: {
+            label: ['close all label', { ns: DECK_PLUGIN }],
+            icon: 'ph--x-circle--regular',
+          },
+        };
+
+        const toggleSidebar = {
+          id: `${LayoutAction.UpdateSidebar._tag}/nav`,
+          data: async () => {
+            state.sidebarState = state.sidebarState === 'expanded' ? 'collapsed' : 'expanded';
+          },
+          properties: {
+            label: [
+              state.sidebarState === 'expanded' ? 'collapse navigation sidebar label' : 'open navigation sidebar label',
+              { ns: DECK_PLUGIN },
+            ],
+            icon: 'ph--sidebar--regular',
+            keyBinding: {
+              macos: 'meta+b',
+            },
+            disposition: 'pin-end',
+            position: 'hoist',
+            l0Breakpoint: 'lg',
+          },
+        };
+
+        return !state.deck.solo ? [closeCurrent, closeOthers, closeAll, toggleSidebar] : [toggleSidebar];
+      },
+    }),
+  );

package/src/capabilities/capabilities.ts

@@ -0,0 +1,15 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { defineCapability } from '@dxos/app-framework';
+import { type DeepReadonly } from '@dxos/util';
+
+import { DECK_PLUGIN } from '../meta';
+import { type DeckState, type Panel } from '../types';
+
+export namespace DeckCapabilities {
+  export const DeckState = defineCapability<DeepReadonly<DeckState>>(`${DECK_PLUGIN}/capability/state`);
+  export const MutableDeckState = defineCapability<DeckState>(`${DECK_PLUGIN}/capability/state`);
+  export const ComplementaryPanel = defineCapability<Panel>(`${DECK_PLUGIN}/capability/complementary-panel`);
+}

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

@@ -0,0 +1,44 @@
+//
+// Copyright 2025 DXOS.org
+//
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, type PluginsContext } from '@dxos/app-framework';
+
+import { DECK_PLUGIN } from '../meta';
+import { type DeckSettingsProps } from '../types';
+
+const isSocket = !!(globalThis as any).__args;
+
+// TODO(mjamesderocher): Can we get this directly from Socket?
+const appScheme = 'composer://';
+
+// 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);
+
+  iframe.src = url + window.location.pathname.replace(/^\/+/, '') + window.location.search;
+
+  const timer = setTimeout(() => {
+    document.body.removeChild(iframe);
+  }, 3000);
+
+  window.addEventListener('pagehide', (event) => {
+    clearTimeout(timer);
+    document.body.removeChild(iframe);
+  });
+};
+
+export default async (context: PluginsContext) => {
+  const settingsStore = context.requestCapability(Capabilities.SettingsStore);
+  const settings = settingsStore.getStore<DeckSettingsProps>(DECK_PLUGIN)?.value;
+  if (!isSocket && settings?.enableNativeRedirect) {
+    checkAppScheme(appScheme);
+  }
+
+  return contributes(Capabilities.Null, null);
+};

package/src/capabilities/index.ts

@@ -0,0 +1,17 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { lazy } from '@dxos/app-framework';
+
+export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
+export const CheckAppScheme = lazy(() => import('./check-app-scheme'));
+export const LayoutIntentResolver = lazy(() => import('./intent-resolver'));
+export const ReactRoot = lazy(() => import('./react-root'));
+export const ReactSurface = lazy(() => import('./react-surface'));
+export const DeckSettings = lazy(() => import('./settings'));
+export const DeckState = lazy(() => import('./state'));
+export const Tools = lazy(() => import('./tools'));
+export const UrlHandler = lazy(() => import('./url-handler'));
+
+export * from './capabilities';

package/src/capabilities/intent-resolver.ts

@@ -0,0 +1,368 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { batch } from '@preact/signals-core';
+import { pipe } from 'effect';
+
+import {
+  Capabilities,
+  createResolver,
+  contributes,
+  IntentAction,
+  LayoutAction,
+  type PluginsContext,
+  createIntent,
+  chain,
+} from '@dxos/app-framework';
+import { getTypename, S } from '@dxos/echo-schema';
+import { isReactiveObject } from '@dxos/live-object';
+import { log } from '@dxos/log';
+import { AttentionCapabilities } from '@dxos/plugin-attention';
+import { ObservabilityAction } from '@dxos/plugin-observability/types';
+import { isNonNullable } from '@dxos/util';
+
+import { DeckCapabilities } from './capabilities';
+import { closeEntry, incrementPlank, openEntry } from '../layout';
+import { DECK_PLUGIN } from '../meta';
+import { DeckAction, type LayoutMode, type DeckSettingsProps, isLayoutMode, getMode } from '../types';
+import { setActive } from '../util';
+
+export default (context: PluginsContext) =>
+  contributes(Capabilities.IntentResolver, [
+    createResolver({
+      intent: IntentAction.ShowUndo,
+      resolve: (data) => {
+        const layout = context.requestCapability(DeckCapabilities.MutableDeckState);
+        const { undoPromise: undo } = context.requestCapability(Capabilities.IntentDispatcher);
+
+        // TODO(wittjosiah): Support undoing further back than the last action.
+        if (layout.currentUndoId) {
+          layout.toasts = layout.toasts.filter((toast) => toast.id !== layout.currentUndoId);
+        }
+        layout.currentUndoId = `${IntentAction.ShowUndo._tag}-${Date.now()}`;
+        layout.toasts = [
+          ...layout.toasts,
+          {
+            id: layout.currentUndoId,
+            title: data.message ?? ['undo available label', { ns: DECK_PLUGIN }],
+            duration: 10_000,
+            actionLabel: ['undo action label', { ns: DECK_PLUGIN }],
+            actionAlt: ['undo action alt', { ns: DECK_PLUGIN }],
+            closeLabel: ['undo close label', { ns: DECK_PLUGIN }],
+            onAction: () => undo(),
+          },
+        ];
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      // TODO(wittjosiah): This should be able to just be `S.is(LayoutAction.UpdateSidebar.fields.input)`
+      //  but the filter is not being applied correctly.
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.UpdateSidebar.fields.input> =>
+        S.is(LayoutAction.UpdateSidebar.fields.input)(data),
+      resolve: ({ options }) => {
+        const layout = context.requestCapability(DeckCapabilities.MutableDeckState);
+        const next = options?.state ?? layout.sidebarState;
+        if (next !== layout.sidebarState) {
+          layout.sidebarState = next;
+        }
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      // TODO(wittjosiah): This should be able to just be `S.is(LayoutAction.UpdateComplementary.fields.input)`
+      //  but the filter is not being applied correctly.
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.UpdateComplementary.fields.input> =>
+        S.is(LayoutAction.UpdateComplementary.fields.input)(data),
+      resolve: ({ subject, options }) => {
+        const layout = context.requestCapability(DeckCapabilities.MutableDeckState);
+
+        if (layout.complementarySidebarPanel !== subject) {
+          layout.complementarySidebarPanel = subject;
+        }
+
+        const next = subject ? 'expanded' : options?.state ?? layout.complementarySidebarState;
+        if (next !== layout.complementarySidebarState) {
+          layout.complementarySidebarState = next;
+        }
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      // TODO(wittjosiah): This should be able to just be `S.is(LayoutAction.UpdateDialog.fields.input)`
+      //  but the filter is not being applied correctly.
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.UpdateDialog.fields.input> =>
+        S.is(LayoutAction.UpdateDialog.fields.input)(data),
+      resolve: ({ subject, options }) => {
+        const layout = context.requestCapability(DeckCapabilities.MutableDeckState);
+        layout.dialogOpen = options.state ?? Boolean(subject);
+        layout.dialogContent = subject ? { component: subject, props: options.props } : null;
+        layout.dialogBlockAlign = options.blockAlign ?? 'center';
+        layout.dialogType = options.type ?? 'default';
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      // TODO(wittjosiah): This should be able to just be `S.is(LayoutAction.UpdatePopover.fields.input)`
+      //  but the filter is not being applied correctly.
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.UpdatePopover.fields.input> =>
+        S.is(LayoutAction.UpdatePopover.fields.input)(data),
+      resolve: ({ subject, options }) => {
+        const layout = context.requestCapability(DeckCapabilities.MutableDeckState);
+        layout.popoverOpen = options.state ?? Boolean(subject);
+        layout.popoverContent = subject ? { component: subject, props: options.props } : null;
+        layout.popoverAnchorId = options.anchorId;
+        layout.popoverSide = options.side;
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      // TODO(wittjosiah): This should be able to just be `S.is(LayoutAction.AddToast.fields.input)`
+      //  but the filter is not being applied correctly.
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.AddToast.fields.input> =>
+        S.is(LayoutAction.AddToast.fields.input)(data),
+      resolve: ({ subject }) => {
+        const layout = context.requestCapability(DeckCapabilities.MutableDeckState);
+        layout.toasts.push(subject);
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      // TODO(wittjosiah): This should be able to just be `S.is(LayoutAction.SetLayoutMode.fields.input)`
+      //  but the filter is not being applied correctly.
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.SetLayoutMode.fields.input> => {
+        if (!S.is(LayoutAction.SetLayoutMode.fields.input)(data)) {
+          return false;
+        }
+
+        if ('mode' in data.options) {
+          return isLayoutMode(data.options.mode);
+        }
+
+        return true;
+      },
+      resolve: ({ subject, options }) => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+
+        const setMode = (mode: LayoutMode) => {
+          const deck = state.deck;
+          const current = deck.solo ? [deck.solo] : deck.active;
+          // When un-soloing, the solo entry is added to the deck.
+          const next = (
+            mode !== 'deck' ? [subject ?? deck.solo ?? deck.active[0]] : [...deck.active, deck.solo]
+          ).filter(isNonNullable);
+
+          const removed = current.filter((id) => !next.includes(id));
+          const closed = Array.from(new Set([...deck.inactive.filter((id) => !next.includes(id)), ...removed]));
+          deck.inactive = closed;
+
+          if (mode !== 'deck' && next[0]) {
+            deck.solo = next[0];
+          } else if (mode === 'deck' && deck.solo) {
+            deck.solo = undefined;
+            deck.initialized = true;
+          }
+
+          if (mode === 'fullscreen' && !deck.fullscreen) {
+            deck.fullscreen = true;
+          } else if (mode !== 'fullscreen' && deck.fullscreen) {
+            deck.fullscreen = false;
+          }
+        };
+
+        return batch(() => {
+          if ('mode' in options) {
+            const current = getMode(state.deck);
+            if (current !== options.mode) {
+              state.previousMode[state.activeDeck] = current;
+            }
+            setMode(options.mode as LayoutMode);
+          } else if ('revert' in options) {
+            const last = state.previousMode[state.activeDeck];
+            setMode(last ?? 'solo');
+          } else {
+            log.warn('Invalid layout mode', options);
+          }
+        });
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.SwitchWorkspace.fields.input> =>
+        S.is(LayoutAction.SwitchWorkspace.fields.input)(data),
+      resolve: ({ subject }) => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+        batch(() => {
+          // TODO(wittjosiah): This is a hack to prevent the previous deck from being set for pinned items.
+          //  Ideally this should be worked into the data model in a generic way.
+          if (!state.activeDeck.startsWith('!')) {
+            state.previousDeck = state.activeDeck;
+          }
+          state.activeDeck = subject;
+          if (!state.decks[subject]) {
+            state.decks[subject] = { initialized: false, active: [], inactive: [], fullscreen: false, plankSizing: {} };
+          }
+        });
+
+        const first = state.deck.solo ? state.deck.solo : state.deck.active[0];
+        if (first) {
+          return {
+            intents: [createIntent(LayoutAction.ScrollIntoView, { part: 'current', subject: first })],
+          };
+        }
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.RevertWorkspace.fields.input> =>
+        S.is(LayoutAction.RevertWorkspace.fields.input)(data),
+      resolve: () => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+        return {
+          intents: [createIntent(LayoutAction.SwitchWorkspace, { part: 'workspace', subject: state.previousDeck })],
+        };
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.Open.fields.input> =>
+        S.is(LayoutAction.Open.fields.input)(data),
+      resolve: ({ subject, options }) => {
+        const { graph } = context.requestCapability(Capabilities.AppGraph);
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+        const attention = context.requestCapability(AttentionCapabilities.Attention);
+        const settings = context
+          .requestCapabilities(Capabilities.SettingsStore)[0]
+          ?.getStore<DeckSettingsProps>(DECK_PLUGIN)?.value;
+
+        const previouslyOpenIds = new Set<string>(state.deck.solo ? [state.deck.solo] : state.deck.active);
+        batch(() => {
+          const next = state.deck.solo
+            ? (subject as string[])
+            : subject.reduce(
+                (acc, entryId) =>
+                  openEntry(acc, entryId, {
+                    key: options?.key,
+                    positioning: options?.positioning ?? settings?.newPlankPositioning,
+                    pivotId: options?.pivotId,
+                  }),
+                state.deck.active,
+              );
+
+          return setActive({ next, state, attention });
+        });
+
+        const ids = state.deck.solo ? [state.deck.solo] : state.deck.active;
+        const newlyOpen = ids.filter((i) => !previouslyOpenIds.has(i));
+
+        return {
+          intents: [
+            ...(options?.scrollIntoView !== false
+              ? [createIntent(LayoutAction.ScrollIntoView, { part: 'current', subject: newlyOpen[0] ?? subject[0] })]
+              : []),
+            createIntent(LayoutAction.Expose, { part: 'navigation', subject: newlyOpen[0] ?? subject[0] }),
+            ...newlyOpen.map((id) => {
+              const active = graph?.findNode(id)?.data;
+              const typename = isReactiveObject(active) ? getTypename(active) : undefined;
+              return createIntent(ObservabilityAction.SendEvent, {
+                name: 'navigation.activate',
+                properties: {
+                  id,
+                  typename,
+                },
+              });
+            }),
+          ],
+        };
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.Close.fields.input> =>
+        S.is(LayoutAction.Close.fields.input)(data),
+      resolve: ({ subject }) => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+        const attention = context.requestCapability(AttentionCapabilities.Attention);
+        const active = state.deck.solo ? [state.deck.solo] : state.deck.active;
+        const next = subject.reduce((acc, id) => closeEntry(acc, id), active);
+        const toAttend = setActive({ next, state, attention });
+        return {
+          intents: toAttend ? [createIntent(LayoutAction.ScrollIntoView, { part: 'current', subject: toAttend })] : [],
+        };
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.Set.fields.input> =>
+        S.is(LayoutAction.Set.fields.input)(data),
+      resolve: ({ subject }) => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+        const attention = context.requestCapability(AttentionCapabilities.Attention);
+        const toAttend = setActive({ next: subject as string[], state, attention });
+        return {
+          intents: toAttend ? [createIntent(LayoutAction.ScrollIntoView, { part: 'current', subject: toAttend })] : [],
+        };
+      },
+    }),
+    createResolver({
+      intent: LayoutAction.UpdateLayout,
+      filter: (data): data is S.Schema.Type<typeof LayoutAction.ScrollIntoView.fields.input> =>
+        S.is(LayoutAction.ScrollIntoView.fields.input)(data),
+      resolve: ({ subject }) => {
+        const layout = context.requestCapability(DeckCapabilities.MutableDeckState);
+        layout.scrollIntoView = subject;
+      },
+    }),
+    createResolver({
+      intent: DeckAction.UpdatePlankSize,
+      resolve: (data) => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+        state.deck.plankSizing[data.id] = data.size;
+      },
+    }),
+    createResolver({
+      intent: DeckAction.Adjust,
+      resolve: (adjustment) => {
+        const state = context.requestCapability(DeckCapabilities.MutableDeckState);
+        const attention = context.requestCapability(AttentionCapabilities.Attention);
+
+        return batch(() => {
+          if (adjustment.type === 'increment-end' || adjustment.type === 'increment-start') {
+            setActive({
+              next: incrementPlank(state.deck.active, adjustment),
+              state,
+              attention,
+            });
+          }
+
+          if (adjustment.type === 'solo') {
+            const entryId = adjustment.id;
+            if (!state.deck.solo) {
+              // Solo the entry.
+              return {
+                intents: [
+                  createIntent(LayoutAction.SetLayoutMode, {
+                    part: 'mode',
+                    subject: entryId,
+                    options: { mode: 'solo' },
+                  }),
+                ],
+              };
+            } else {
+              // Un-solo the current entry.
+              return {
+                intents: [
+                  // NOTE: The order of these is important.
+                  pipe(
+                    createIntent(LayoutAction.SetLayoutMode, { part: 'mode', options: { mode: 'deck' } }),
+                    chain(LayoutAction.Open, { part: 'main', subject: [entryId] }),
+                  ),
+                ],
+              };
+            }
+          }
+        });
+      },
+    }),
+  ]);