@dxos/plugin-deck 0.8.1-staging.5be625a → 0.8.1-staging.9eaf14f

package/dist/types/src/types.d.ts

@@ -1,39 +1,27 @@
 import { S } from '@dxos/echo-schema';
-import { type Node } from '@dxos/plugin-graph';
-import { type Label } from '@dxos/react-ui';
-import { type Position } from '@dxos/util';
+export { ATTENDABLE_PATH_SEPARATOR } from '@dxos/react-ui-attention';
+export declare const PLANK_COMPANION_TYPE = "dxos.org/plugin/deck/plank-companion";
+export declare const DECK_COMPANION_TYPE = "dxos.org/plugin/deck/deck-companion";
 export declare const NewPlankPositions: readonly ["start", "end"];
 export type NewPlankPositioning = (typeof NewPlankPositions)[number];
 export declare const OverscrollOptions: readonly ["none", "centering"];
 export type Overscroll = (typeof OverscrollOptions)[number];
 export type Part = 'solo' | 'deck' | 'complementary';
 export type ResolvedPart = Part | 'solo-primary' | 'solo-companion';
-export type Panel = {
-    id: string;
-    label: Label;
-    icon: string;
-    position?: Position;
-    /**
-     * If true, the panel will now be wrapped in a scroll area.
-     */
-    fixed?: boolean;
-    filter?: (node: Node) => boolean;
-};
 export declare const DeckSettingsSchema: S.mutable<S.Struct<{
-    showHints: typeof S.Boolean;
-    enableNativeRedirect: typeof S.Boolean;
-    enableStatusbar: typeof S.Boolean;
-    newPlankPositioning: S.Literal<["start", "end"]>;
-    overscroll: S.Literal<["none", "centering"]>;
+    showHints: S.optional<typeof S.Boolean>;
+    enableDeck: S.optional<typeof S.Boolean>;
+    enableNativeRedirect: S.optional<typeof S.Boolean>;
+    enableStatusbar: S.optional<typeof S.Boolean>;
+    newPlankPositioning: S.optional<S.Literal<["start", "end"]>>;
+    overscroll: S.optional<S.Literal<["none", "centering"]>>;
 }>>;
 export type DeckSettingsProps = S.Schema.Type<typeof DeckSettingsSchema>;
-declare const LayoutMode: S.Union<[S.Literal<["deck"]>, S.Literal<["solo"]>, S.Literal<["fullscreen"]>]>;
-export declare const isLayoutMode: (value: any) => value is LayoutMode;
-export type LayoutMode = S.Schema.Type<typeof LayoutMode>;
 export declare const PlankSizing: S.Record$<typeof S.String, typeof S.Number>;
 export type PlankSizing = S.Schema.Type<typeof PlankSizing>;
-export declare const Deck: S.Struct<{
-    initialized: S.SchemaClass<boolean, boolean, never>;
+export declare const DeckState: S.Struct<{
+    /** If false, the deck has not yet left solo mode and new planks should be soloed. */
+    initialized: typeof S.Boolean;
     active: S.mutable<S.Array$<typeof S.String>>;
     activeCompanions: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.String>>>;
     inactive: S.mutable<S.Array$<typeof S.String>>;
@@ -42,35 +30,24 @@ export declare const Deck: S.Struct<{
     plankSizing: S.mutable<S.Record$<typeof S.String, typeof S.Number>>;
     companionFrameSizing: S.mutable<S.Record$<typeof S.String, typeof S.Number>>;
 }>;
-export type Deck = S.Schema.Type<typeof Deck>;
-export declare const defaultDeck: {
-    initialized: false;
-    active: never[];
-    activeCompanions: {};
-    inactive: never[];
-    fullscreen: false;
-    solo: undefined;
-    plankSizing: {};
-    companionFrameSizing: {};
-};
-export declare const surfaceVariantSeparator = "--";
-export declare const surfaceVariant: (id: string) => string;
-export declare const DeckState: S.mutable<S.Struct<{
+export type DeckState = S.Schema.Type<typeof DeckState>;
+export declare const defaultDeck: DeckState;
+declare const LayoutMode: S.Literal<["deck", "solo", "fullscreen"]>;
+export type LayoutMode = S.Schema.Type<typeof LayoutMode>;
+export declare const isLayoutMode: (value: any) => value is LayoutMode;
+export declare const getMode: (deck: DeckState) => LayoutMode;
+export declare const DeckPluginState: S.mutable<S.Struct<{
     sidebarState: S.Literal<["closed", "collapsed", "expanded"]>;
     complementarySidebarState: S.Literal<["closed", "collapsed", "expanded"]>;
     complementarySidebarPanel: S.optional<typeof S.String>;
     dialogOpen: typeof S.Boolean;
-    /**
-     * Data to be passed to the dialog Surface.
-     */
+    /** Data to be passed to the dialog Surface. */
     dialogContent: S.optional<typeof S.Any>;
     dialogBlockAlign: S.optional<S.Literal<["start", "center", "end"]>>;
     dialogType: S.optional<S.Literal<["default", "alert"]>>;
     popoverOpen: typeof S.Boolean;
     popoverSide: S.optional<S.Literal<["top", "right", "bottom", "left"]>>;
-    /**
-     * Data to be passed to the popover Surface.
-     */
+    /** Data to be passed to the popover Surface. */
     popoverContent: S.optional<typeof S.Any>;
     popoverAnchorId: S.optional<typeof S.String>;
     toasts: S.mutable<S.Array$<S.Struct<{
@@ -103,7 +80,8 @@ export declare const DeckState: S.mutable<S.Struct<{
     activeDeck: typeof S.String;
     previousDeck: typeof S.String;
     decks: S.mutable<S.Record$<typeof S.String, S.mutable<S.Struct<{
-        initialized: S.SchemaClass<boolean, boolean, never>;
+        /** If false, the deck has not yet left solo mode and new planks should be soloed. */
+        initialized: typeof S.Boolean;
         active: S.mutable<S.Array$<typeof S.String>>;
         activeCompanions: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.String>>>;
         inactive: S.mutable<S.Array$<typeof S.String>>;
@@ -112,9 +90,10 @@ export declare const DeckState: S.mutable<S.Struct<{
         plankSizing: S.mutable<S.Record$<typeof S.String, typeof S.Number>>;
         companionFrameSizing: S.mutable<S.Record$<typeof S.String, typeof S.Number>>;
     }>>>>;
-    previousMode: S.mutable<S.Record$<typeof S.String, S.Union<[S.Literal<["deck"]>, S.Literal<["solo"]>, S.Literal<["fullscreen"]>]>>>;
+    previousMode: S.mutable<S.Record$<typeof S.String, S.Literal<["deck", "solo", "fullscreen"]>>>;
     deck: S.mutable<S.Struct<{
-        initialized: S.SchemaClass<boolean, boolean, never>;
+        /** If false, the deck has not yet left solo mode and new planks should be soloed. */
+        initialized: typeof S.Boolean;
         active: S.mutable<S.Array$<typeof S.String>>;
         activeCompanions: S.optional<S.mutable<S.Record$<typeof S.String, typeof S.String>>>;
         inactive: S.mutable<S.Array$<typeof S.String>>;
@@ -123,21 +102,17 @@ export declare const DeckState: S.mutable<S.Struct<{
         plankSizing: S.mutable<S.Record$<typeof S.String, typeof S.Number>>;
         companionFrameSizing: S.mutable<S.Record$<typeof S.String, typeof S.Number>>;
     }>>;
-    /**
-     * The identifier of a component to scroll into view when it is mounted.
-     */
+    /** The identifier of a component to scroll into view when it is mounted. */
     scrollIntoView: S.optional<typeof S.String>;
 }>>;
-export type DeckState = S.Schema.Type<typeof DeckState>;
-export declare const getMode: (deck: Deck) => LayoutMode;
-export declare const SLUG_PATH_SEPARATOR = "~";
+export type DeckPluginState = S.Schema.Type<typeof DeckPluginState>;
 export declare const DECK_ACTION: string;
 export declare namespace DeckAction {
-    const PartAdjustmentSchema: S.Union<[S.Literal<["close"]>, S.Literal<["solo"]>, S.Literal<["increment-start"]>, S.Literal<["increment-end"]>]>;
+    const PartAdjustmentSchema: S.Union<[S.Literal<["close"]>, S.Literal<["companion"]>, S.Literal<["solo"]>, S.Literal<["increment-start"]>, S.Literal<["increment-end"]>]>;
     export type PartAdjustment = S.Schema.Type<typeof PartAdjustmentSchema>;
     export const Adjustment: S.mutable<S.Struct<{
         id: typeof S.String;
-        type: S.Union<[S.Literal<["close"]>, S.Literal<["solo"]>, S.Literal<["increment-start"]>, S.Literal<["increment-end"]>]>;
+        type: S.Union<[S.Literal<["close"]>, S.Literal<["companion"]>, S.Literal<["solo"]>, S.Literal<["increment-start"]>, S.Literal<["increment-end"]>]>;
     }>>;
     export type Adjustment = S.Schema.Type<typeof Adjustment>;
     const Adjust_base: S.TaggedClass<Adjust, `${string}/adjust`, {
@@ -145,13 +120,10 @@ export declare namespace DeckAction {
     } & {
         input: S.mutable<S.Struct<{
             id: typeof S.String;
-            type: S.Union<[S.Literal<["close"]>, S.Literal<["solo"]>, S.Literal<["increment-start"]>, S.Literal<["increment-end"]>]>;
+            type: S.Union<[S.Literal<["close"]>, S.Literal<["companion"]>, S.Literal<["solo"]>, S.Literal<["increment-start"]>, S.Literal<["increment-end"]>]>;
         }>>;
         output: typeof S.Void;
     }>;
-    /**
-     * An atomic transaction to apply to the deck, describing which element to move to which location.
-     */
     export class Adjust extends Adjust_base {
     }
     const UpdatePlankSize_base: S.TaggedClass<UpdatePlankSize, `${string}/update-plank-size`, {
@@ -178,5 +150,4 @@ export declare namespace DeckAction {
     }
     export {};
 }
-export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/src/util/index.d.ts

@@ -3,4 +3,5 @@ export * from './set-active';
 export * from './useBreakpoints';
 export * from './layoutAppliesTopbar';
 export * from './useHoistStatusbar';
+export * from './useCompanions';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/types/src/util/set-active.d.ts

@@ -1,8 +1,8 @@
 import { type AttentionManager } from '@dxos/plugin-attention';
-import { type DeckState } from '../types';
+import { type DeckPluginState } from '../types';
 export type SetActiveOptions = {
     next: string[];
-    state: DeckState;
+    state: DeckPluginState;
     attention?: AttentionManager;
 };
 export declare const setActive: ({ next, state, attention }: SetActiveOptions) => string | undefined;

package/dist/types/src/util/set-active.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-active.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,SAAS,+BAAgC,gBAAgB,uBA8BrE,CAAC"}
+{"version":3,"file":"set-active.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,SAAS,+BAAgC,gBAAgB,uBA8BrE,CAAC"}

package/dist/types/src/util/useCompanions.d.ts

@@ -0,0 +1,8 @@
+export declare const useCompanions: (id?: string) => Readonly<{
+    id: string;
+    type: string;
+    cacheable?: string[];
+    properties: Readonly<Record<string, any>>;
+    data: any;
+}>[];
+//# sourceMappingURL=useCompanions.d.ts.map

package/dist/types/src/util/useCompanions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompanions.d.ts","sourceRoot":"","sources":["../../../../src/util/useCompanions.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,aAAa,QAAS,MAAM;;;;;;IAKxC,CAAC"}

package/dist/types/src/util/useHoistStatusbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHoistStatusbar.d.ts","sourceRoot":"","sources":["../../../../src/util/useHoistStatusbar.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,iBAAiB,eAAgB,MAAM,YAOnD,CAAC"}
+{"version":3,"file":"useHoistStatusbar.d.ts","sourceRoot":"","sources":["../../../../src/util/useHoistStatusbar.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,iBAAiB,eAAgB,MAAM,KAAG,OAOtD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-deck",
-  "version": "0.8.1-staging.5be625a",
+  "version": "0.8.1-staging.9eaf14f",
   "description": "DXOS Surface plugin for the main application layout.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -35,29 +35,28 @@
     "@preact/signals-core": "^1.6.0",
     "effect": "3.13.3",
     "immer": "^10.1.1",
-    "@dxos/app-framework": "0.8.1-staging.5be625a",
-    "@dxos/artifact": "0.8.1-staging.5be625a",
-    "@dxos/debug": "0.8.1-staging.5be625a",
-    "@dxos/async": "0.8.1-staging.5be625a",
-    "@dxos/echo-signals": "0.8.1-staging.5be625a",
-    "@dxos/invariant": "0.8.1-staging.5be625a",
-    "@dxos/echo-schema": "0.8.1-staging.5be625a",
-    "@dxos/keyboard": "0.8.1-staging.5be625a",
-    "@dxos/live-object": "0.8.1-staging.5be625a",
-    "@dxos/local-storage": "0.8.1-staging.5be625a",
-    "@dxos/log": "0.8.1-staging.5be625a",
-    "@dxos/plugin-attention": "0.8.1-staging.5be625a",
-    "@dxos/plugin-client": "0.8.1-staging.5be625a",
-    "@dxos/plugin-graph": "0.8.1-staging.5be625a",
-    "@dxos/plugin-observability": "0.8.1-staging.5be625a",
-    "@dxos/plugin-theme": "0.8.1-staging.5be625a",
-    "@dxos/react-client": "0.8.1-staging.5be625a",
-    "@dxos/react-ui-attention": "0.8.1-staging.5be625a",
-    "@dxos/react-ui-form": "0.8.1-staging.5be625a",
-    "@dxos/react-ui-text-tooltip": "0.8.1-staging.5be625a",
-    "@dxos/react-ui-tabs": "0.8.1-staging.5be625a",
-    "@dxos/util": "0.8.1-staging.5be625a",
-    "@dxos/react-ui-stack": "0.8.1-staging.5be625a"
+    "@dxos/app-framework": "0.8.1-staging.9eaf14f",
+    "@dxos/artifact": "0.8.1-staging.9eaf14f",
+    "@dxos/async": "0.8.1-staging.9eaf14f",
+    "@dxos/echo-schema": "0.8.1-staging.9eaf14f",
+    "@dxos/debug": "0.8.1-staging.9eaf14f",
+    "@dxos/echo-signals": "0.8.1-staging.9eaf14f",
+    "@dxos/invariant": "0.8.1-staging.9eaf14f",
+    "@dxos/keyboard": "0.8.1-staging.9eaf14f",
+    "@dxos/live-object": "0.8.1-staging.9eaf14f",
+    "@dxos/log": "0.8.1-staging.9eaf14f",
+    "@dxos/plugin-attention": "0.8.1-staging.9eaf14f",
+    "@dxos/plugin-graph": "0.8.1-staging.9eaf14f",
+    "@dxos/local-storage": "0.8.1-staging.9eaf14f",
+    "@dxos/plugin-observability": "0.8.1-staging.9eaf14f",
+    "@dxos/plugin-theme": "0.8.1-staging.9eaf14f",
+    "@dxos/react-ui-attention": "0.8.1-staging.9eaf14f",
+    "@dxos/react-client": "0.8.1-staging.9eaf14f",
+    "@dxos/react-ui-form": "0.8.1-staging.9eaf14f",
+    "@dxos/react-ui-tabs": "0.8.1-staging.9eaf14f",
+    "@dxos/react-ui-stack": "0.8.1-staging.9eaf14f",
+    "@dxos/react-ui-text-tooltip": "0.8.1-staging.9eaf14f",
+    "@dxos/util": "0.8.1-staging.9eaf14f"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -66,16 +65,16 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/react-ui": "0.8.1-staging.5be625a",
-    "@dxos/react-ui-theme": "0.8.1-staging.5be625a",
-    "@dxos/storybook-utils": "0.8.1-staging.5be625a"
+    "@dxos/react-ui-theme": "0.8.1-staging.9eaf14f",
+    "@dxos/react-ui": "0.8.1-staging.9eaf14f",
+    "@dxos/storybook-utils": "0.8.1-staging.9eaf14f"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.0.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.1-staging.5be625a",
-    "@dxos/react-ui-theme": "0.8.1-staging.5be625a"
+    "@dxos/react-ui": "0.8.1-staging.9eaf14f",
+    "@dxos/react-ui-theme": "0.8.1-staging.9eaf14f"
   },
   "publishConfig": {
     "access": "public"

package/src/DeckPlugin.ts

@@ -56,7 +56,6 @@ export const DeckPlugin = () =>
     defineModule({
       id: `${meta.id}/module/react-root`,
       activatesOn: Events.Startup,
-      activatesBefore: [DeckEvents.SetupComplementaryPanels],
       activate: ReactRoot,
     }),
     defineModule({

package/src/capabilities/capabilities.ts

@@ -6,10 +6,9 @@ import { defineCapability } from '@dxos/app-framework';
 import { type DeepReadonly } from '@dxos/util';
 
 import { DECK_PLUGIN } from '../meta';
-import { type DeckState, type Panel } from '../types';
+import { type DeckPluginState } 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`);
+  export const DeckState = defineCapability<DeepReadonly<DeckPluginState>>(`${DECK_PLUGIN}/capability/state`);
+  export const MutableDeckState = defineCapability<DeckPluginState>(`${DECK_PLUGIN}/capability/state`);
 }

package/src/capabilities/intent-resolver.ts

@@ -20,13 +20,22 @@ import { invariant } from '@dxos/invariant';
 import { isReactiveObject } from '@dxos/live-object';
 import { log } from '@dxos/log';
 import { AttentionCapabilities } from '@dxos/plugin-attention';
+import { type Node } from '@dxos/plugin-graph';
 import { ObservabilityAction } from '@dxos/plugin-observability/types';
-import { isNonNullable } from '@dxos/util';
+import { byPosition, isNonNullable } from '@dxos/util';
 
 import { DeckCapabilities } from './capabilities';
-import { closeEntry, incrementPlank, openEntry } from '../layout';
+import { closeEntry, createEntryId, incrementPlank, openEntry } from '../layout';
 import { DECK_PLUGIN } from '../meta';
-import { DeckAction, type LayoutMode, type DeckSettingsProps, isLayoutMode, getMode, defaultDeck } from '../types';
+import {
+  DeckAction,
+  type LayoutMode,
+  type DeckSettingsProps,
+  isLayoutMode,
+  getMode,
+  defaultDeck,
+  PLANK_COMPANION_TYPE,
+} from '../types';
 import { setActive } from '../util';
 
 export default (context: PluginsContext) =>
@@ -240,13 +249,14 @@ export default (context: PluginsContext) =>
         const previouslyOpenIds = new Set<string>(state.deck.solo ? [state.deck.solo] : state.deck.active);
         batch(() => {
           const next = state.deck.solo
-            ? (subject as string[])
+            ? (subject as string[]).map((id) => createEntryId(id, options?.variant))
             : subject.reduce(
                 (acc, entryId) =>
                   openEntry(acc, entryId, {
                     key: options?.key,
                     positioning: options?.positioning ?? settings?.newPlankPositioning,
                     pivotId: options?.pivotId,
+                    variant: options?.variant,
                   }),
                 state.deck.active,
               );
@@ -263,13 +273,13 @@ export default (context: PluginsContext) =>
               ? [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;
+            ...newlyOpen.map((subjectId) => {
+              const active = graph?.findNode(subjectId)?.data;
               const typename = isReactiveObject(active) ? getTypename(active) : undefined;
               return createIntent(ObservabilityAction.SendEvent, {
                 name: 'navigation.activate',
                 properties: {
-                  id,
+                  subjectId,
                   typename,
                 },
               });
@@ -352,6 +362,7 @@ export default (context: PluginsContext) =>
       resolve: (adjustment) => {
         const state = context.requestCapability(DeckCapabilities.MutableDeckState);
         const attention = context.requestCapability(AttentionCapabilities.Attention);
+        const { graph } = context.requestCapability(Capabilities.AppGraph);
 
         return batch(() => {
           if (adjustment.type === 'increment-end' || adjustment.type === 'increment-start') {
@@ -362,6 +373,23 @@ export default (context: PluginsContext) =>
             });
           }
 
+          if (adjustment.type === 'companion') {
+            const node = graph.findNode(adjustment.id);
+            const [companion] = node
+              ? graph
+                  .nodes(node, { filter: (n): n is Node<any> => n.type === PLANK_COMPANION_TYPE })
+                  .toSorted((a, b) => byPosition(a.properties, b.properties))
+              : [];
+            if (companion) {
+              return {
+                intents: [
+                  // TODO(wittjosiah): This should remember the previously selected companion.
+                  createIntent(DeckAction.ChangeCompanion, { primary: adjustment.id, companion: companion.id }),
+                ],
+              };
+            }
+          }
+
           if (adjustment.type === 'solo') {
             const entryId = adjustment.id;
             if (!state.deck.solo) {

package/src/capabilities/react-root.tsx

@@ -9,14 +9,12 @@ import { Capabilities, contributes, useCapability } from '@dxos/app-framework';
 import { DeckCapabilities } from './capabilities';
 import { DeckLayout } from '../components';
 import { DECK_PLUGIN } from '../meta';
-import { type DeckSettingsProps } from '../types';
 
 export default () =>
   contributes(Capabilities.ReactRoot, {
     id: DECK_PLUGIN,
     root: () => {
       const layout = useCapability(DeckCapabilities.MutableDeckState);
-      const settings = useCapability(Capabilities.SettingsStore).getStore<DeckSettingsProps>(DECK_PLUGIN)!.value;
 
       const handleDismissToast = useCallback(
         (id: string) => {
@@ -35,12 +33,6 @@ export default () =>
         [layout.toasts],
       );
 
-      return (
-        <DeckLayout
-          showHints={settings.showHints}
-          overscroll={settings.overscroll}
-          onDismissToast={handleDismissToast}
-        />
-      );
+      return <DeckLayout onDismissToast={handleDismissToast} />;
     },
   });

package/src/capabilities/react-surface.tsx

@@ -7,19 +7,18 @@ import React from 'react';
 import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
 import { SettingsStore } from '@dxos/local-storage';
 
-import { LayoutSettings } from '../components';
-import { Banner } from '../components/DeckLayout/Banner';
+import { DeckSettings, Banner } from '../components';
 import { DECK_PLUGIN } from '../meta';
 import { type DeckSettingsProps } from '../types';
 
 export default () =>
   contributes(Capabilities.ReactSurface, [
     createSurface({
-      id: `${DECK_PLUGIN}/settings`,
+      id: `${DECK_PLUGIN}/plugin-settings`,
       role: 'article',
       filter: (data): data is { subject: SettingsStore<DeckSettingsProps> } =>
         data.subject instanceof SettingsStore && data.subject.prefix === DECK_PLUGIN,
-      component: ({ data: { subject } }) => <LayoutSettings settings={subject.value} />,
+      component: ({ data: { subject } }) => <DeckSettings settings={subject.value} />,
     }),
     createSurface({
       id: `${DECK_PLUGIN}/banner`,

package/src/capabilities/settings.ts

@@ -11,11 +11,16 @@ import { DeckSettingsSchema, type DeckSettingsProps } from '../types';
 export default () => {
   const settings = create<DeckSettingsProps>({
     showHints: false,
+    enableDeck: true,
     enableNativeRedirect: false,
-    enableStatusbar: true,
+    enableStatusbar: false,
     newPlankPositioning: 'start',
     overscroll: 'none',
   });
 
-  return contributes(Capabilities.Settings, { schema: DeckSettingsSchema, prefix: DECK_PLUGIN, value: settings });
+  return contributes(Capabilities.Settings, {
+    schema: DeckSettingsSchema,
+    prefix: DECK_PLUGIN,
+    value: settings,
+  });
 };

package/src/capabilities/state.ts

@@ -10,7 +10,7 @@ import { type SidebarState } from '@dxos/react-ui';
 
 import { DeckCapabilities } from './capabilities';
 import { DECK_PLUGIN } from '../meta';
-import { getMode, type Deck, type DeckState, defaultDeck } from '../types';
+import { getMode, type DeckState, type DeckPluginState, defaultDeck } from '../types';
 
 const boolean = /true|false/;
 
@@ -32,7 +32,7 @@ const migrateSidebarState = () => {
 export default () => {
   migrateSidebarState();
 
-  const state = new LocalStorageStore<DeckState>(DECK_PLUGIN, {
+  const state = new LocalStorageStore<DeckPluginState>(DECK_PLUGIN, {
     sidebarState: 'expanded',
     complementarySidebarState: 'collapsed',
     complementarySidebarPanel: undefined,
@@ -63,7 +63,7 @@ export default () => {
     .prop({ key: 'sidebarState', type: LocalStorageStore.enum<SidebarState>() })
     .prop({ key: 'complementarySidebarState', type: LocalStorageStore.enum<SidebarState>() })
     .prop({ key: 'complementarySidebarPanel', type: LocalStorageStore.string({ allowUndefined: true }) })
-    .prop({ key: 'decks', type: LocalStorageStore.json<Record<string, Deck>>() })
+    .prop({ key: 'decks', type: LocalStorageStore.json<Record<string, DeckState>>() })
     .prop({ key: 'activeDeck', type: LocalStorageStore.string() })
     .prop({ key: 'previousDeck', type: LocalStorageStore.string() });
 

package/src/components/DeckLayout/ActiveNode.tsx

@@ -5,9 +5,10 @@
 import React from 'react';
 
 import { Surface, useAppGraph } from '@dxos/app-framework';
+import { useNode } from '@dxos/plugin-graph';
 import { useAttended } from '@dxos/react-ui-attention';
 
-import { useNode, useNodeActionExpander } from '../../hooks';
+import { useNodeActionExpander } from '../../hooks';
 
 // TODO(burdon): Factor out to effect in plugin set document title.
 export const ActiveNode = () => {

package/src/components/DeckLayout/Banner.tsx

@@ -5,12 +5,14 @@
 import React from 'react';
 
 import { Surface } from '@dxos/app-framework';
-import { type ThemedClassName } from '@dxos/react-ui';
+import { useTranslation, type ThemedClassName } from '@dxos/react-ui';
 import { mx } from '@dxos/react-ui-theme';
 
-import { CloseSidebarButton, ToggleSidebarButton } from './SidebarButton';
+import { DECK_PLUGIN } from '../../meta';
+import { CloseSidebarButton, ToggleSidebarButton } from '../Sidebar';
 
 export const Banner = ({ variant, classNames }: ThemedClassName<{ variant?: 'topbar' | 'sidebar' }>) => {
+  const { t } = useTranslation(DECK_PLUGIN);
   return (
     <header
       className={mx(
@@ -21,7 +23,7 @@ export const Banner = ({ variant, classNames }: ThemedClassName<{ variant?: 'top
       )}
     >
       {variant === 'sidebar' ? <CloseSidebarButton /> : <ToggleSidebarButton />}
-      <span className='self-center grow mis-1'>Composer</span>
+      <span className='self-center grow mis-1'>{t('current app name', { ns: 'appkit' })}</span>
       {variant === 'topbar' && (
         <div role='none' className='absolute inset-0 pointer-events-none'>
           <div role='none' className='grid bs-full pointer-fine:p-1 max-is-md mli-auto pointer-events-auto'>

package/src/components/DeckLayout/ContentEmpty.tsx

@@ -6,8 +6,8 @@ import React from 'react';
 
 import { Surface } from '@dxos/app-framework';
 
-import { ToggleSidebarButton } from './SidebarButton';
 import { layoutAppliesTopbar, useBreakpoints } from '../../util';
+import { ToggleSidebarButton } from '../Sidebar';
 import { fixedSidebarToggleStyles } from '../fragments';
 
 export const ContentEmpty = () => {