@dxos/plugin-deck 0.6.13 → 0.6.14-main.7bd9c89

package/dist/lib/browser/index.mjs

@@ -1,15 +1,15 @@
 import {
   DECK_PLUGIN,
   meta_default
-} from "./chunk-YVHGFQQR.mjs";
+} from "./chunk-GVOGPULO.mjs";
 
 // packages/plugins/plugin-deck/src/DeckPlugin.tsx
-import { ArrowsOut } from "@phosphor-icons/react";
-import { batch, effect } from "@preact/signals-core";
+import { batch } from "@preact/signals-core";
 import { setAutoFreeze } from "immer";
 import React15 from "react";
-import { IntentAction, LayoutAction as LayoutAction3, NavigationAction as NavigationAction3, parseGraphPlugin, parseIntentPlugin, resolvePlugin, Toast as ToastSchema, SLUG_PATH_SEPARATOR as SLUG_PATH_SEPARATOR5, isLayoutParts, isLayoutAdjustment, isLayoutMode, openIds as openIds2 } from "@dxos/app-framework";
+import { IntentAction, LayoutAction as LayoutAction3, NavigationAction as NavigationAction4, parseGraphPlugin, parseIntentPlugin, resolvePlugin, Toast as ToastSchema, SLUG_PATH_SEPARATOR as SLUG_PATH_SEPARATOR4, isLayoutParts, isLayoutAdjustment, isLayoutMode, openIds as openIds2 } from "@dxos/app-framework";
 import { create, getTypename, isReactiveObject } from "@dxos/echo-schema";
+import { scheduledEffect } from "@dxos/echo-signals/core";
 import { LocalStorageStore } from "@dxos/local-storage";
 import { log } from "@dxos/log";
 import { parseAttentionPlugin } from "@dxos/plugin-attention";
@@ -18,7 +18,6 @@ import { createExtension } from "@dxos/plugin-graph";
 import { ObservabilityAction } from "@dxos/plugin-observability/meta";
 import { fullyQualifiedId } from "@dxos/react-client/echo";
 import { translations as deckTranslations } from "@dxos/react-ui-deck";
-import { Mosaic } from "@dxos/react-ui-mosaic";
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/constants.ts
 var NAV_ID = "NavTree";
@@ -26,11 +25,12 @@ var SURFACE_PREFIX = "surface:";
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/DeckLayout.tsx
 import { Sidebar as MenuIcon } from "@phosphor-icons/react";
-import React13, { useCallback as useCallback2, useEffect as useEffect5, useMemo as useMemo2, useRef as useRef2, useState as useState3, useLayoutEffect as useLayoutEffect2 } from "react";
-import { SLUG_PATH_SEPARATOR as SLUG_PATH_SEPARATOR3, Surface as Surface9, firstIdInPart, usePlugin } from "@dxos/app-framework";
-import { Button as Button3, Dialog, Main as Main3, Popover as Popover2, useTranslation as useTranslation5 } from "@dxos/react-ui";
+import React13, { useCallback as useCallback2, useEffect as useEffect5, useMemo as useMemo3, useRef as useRef2 } from "react";
+import { Surface as Surface9, firstIdInPart, usePlugin } from "@dxos/app-framework";
+import { Button as Button3, Dialog, Main as Main3, Popover as Popover2, useOnTransition, useTranslation as useTranslation5 } from "@dxos/react-ui";
+import { useAttended as useAttended3 } from "@dxos/react-ui-attention";
 import { Deck } from "@dxos/react-ui-deck";
-import { getSize } from "@dxos/react-ui-theme";
+import { getSize, mainPaddingTransitions as mainPaddingTransitions2 } from "@dxos/react-ui-theme";
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/ActiveNode.tsx
 import React from "react";
@@ -40,8 +40,11 @@ import { useGraph } from "@dxos/plugin-graph";
 // packages/plugins/plugin-deck/src/hooks/useNode.ts
 import { useEffect, useState } from "react";
 var useNode = (graph, id, timeout) => {
-  const [nodeState, setNodeState] = useState(id ? graph.findNode(id) : void 0);
+  const [nodeState, setNodeState] = useState(id ? graph.findNode(id, false) : void 0);
   useEffect(() => {
+    if (!id && nodeState) {
+      setNodeState(void 0);
+    }
     if (nodeState?.id === id || !id) {
       return;
     }
@@ -113,36 +116,25 @@ var ActiveNode = ({ id }) => {
 };
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/ComplementarySidebar.tsx
-import React5 from "react";
-import { SLUG_PATH_SEPARATOR as SLUG_PATH_SEPARATOR2, Surface as Surface3 } from "@dxos/app-framework";
+import React5, { useMemo } from "react";
+import { NavigationAction as NavigationAction2, SLUG_PATH_SEPARATOR as SLUG_PATH_SEPARATOR2, Surface as Surface3, useIntentDispatcher as useIntentDispatcher2 } from "@dxos/app-framework";
 import { useGraph as useGraph3 } from "@dxos/plugin-graph";
 import { Main } from "@dxos/react-ui";
-import { createAttendableAttributes } from "@dxos/react-ui-attention";
+import { useAttended } from "@dxos/react-ui-attention";
 import { deckGrid } from "@dxos/react-ui-deck";
 import { mx as mx2 } from "@dxos/react-ui-theme";
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/NodePlankHeading.tsx
-import { Placeholder } from "@phosphor-icons/react";
 import React2, { Fragment, useEffect as useEffect3 } from "react";
-import { LayoutAction, NavigationAction, SLUG_COLLECTION_INDICATOR, SLUG_PATH_SEPARATOR, Surface as Surface2, useIntentDispatcher, indexInPart, partLength } from "@dxos/app-framework";
+import { LayoutAction, NavigationAction, SLUG_PATH_SEPARATOR, Surface as Surface2, useIntentDispatcher, indexInPart, partLength } from "@dxos/app-framework";
 import { useGraph as useGraph2 } from "@dxos/plugin-graph";
-import { Popover, toLocalizedString, useMediaQuery, useTranslation } from "@dxos/react-ui";
-import { PlankHeading, plankHeadingIconProps } from "@dxos/react-ui-deck";
+import { Icon, Popover, toLocalizedString, useMediaQuery, useTranslation } from "@dxos/react-ui";
+import { PlankHeading } from "@dxos/react-ui-deck";
 import { TextTooltip } from "@dxos/react-ui-text-tooltip";
-var NodePlankHeading = ({
-  node,
-  id,
-  layoutParts,
-  layoutPart,
-  // TODO(wittjosiah): Unused?
-  layoutEntry,
-  popoverAnchorId,
-  pending,
-  flatDeck
-}) => {
+var NodePlankHeading = ({ node, id, layoutParts, layoutPart, popoverAnchorId, pending, flatDeck, actions = [] }) => {
   const { t } = useTranslation(DECK_PLUGIN);
   const { graph } = useGraph2();
-  const Icon = node?.properties?.icon ?? Placeholder;
+  const icon = node?.properties?.icon ?? "ph--placeholder--regular";
   const label = pending ? t("pending heading") : toLocalizedString(node?.properties?.label ?? [
     "plank heading fallback label",
     {
@@ -172,10 +164,14 @@ var NodePlankHeading = ({
   return /* @__PURE__ */ React2.createElement(PlankHeading.Root, (layoutPart !== "main" || !flatDeck) && {
     classNames: "pie-1 border-b border-separator"
   }, /* @__PURE__ */ React2.createElement(ActionRoot, null, node ? /* @__PURE__ */ React2.createElement(PlankHeading.ActionsMenu, {
-    Icon,
+    icon,
+    related: layoutPart === "complementary",
     attendableId,
     triggerLabel: t("actions menu label"),
-    actions: graph.actions(node),
+    actions: [
+      actions,
+      graph.actions(node)
+    ].filter((a) => a.length > 0),
     onAction: (action) => typeof action.data === "function" && action.data?.({
       node: action,
       caller: DECK_PLUGIN
@@ -187,11 +183,15 @@ var NodePlankHeading = ({
     }
   })) : /* @__PURE__ */ React2.createElement(PlankHeading.Button, null, /* @__PURE__ */ React2.createElement("span", {
     className: "sr-only"
-  }, label), /* @__PURE__ */ React2.createElement(Icon, plankHeadingIconProps))), /* @__PURE__ */ React2.createElement(TextTooltip, {
+  }, label), /* @__PURE__ */ React2.createElement(Icon, {
+    icon,
+    size: 5
+  }))), /* @__PURE__ */ React2.createElement(TextTooltip, {
     text: label,
     onlyWhenTruncating: true
   }, /* @__PURE__ */ React2.createElement(PlankHeading.Label, {
-    attendableId: node?.id,
+    attendableId,
+    related: layoutPart === "complementary",
     ...pending && {
       classNames: "text-description"
     }
@@ -237,9 +237,6 @@ var NodePlankHeading = ({
         action: NavigationAction.CLOSE,
         data: {
           activeParts: {
-            complementary: [
-              `${id}${SLUG_PATH_SEPARATOR}comments${SLUG_COLLECTION_INDICATOR}`
-            ],
             [layoutPart]: [
               id
             ]
@@ -253,7 +250,7 @@ var NodePlankHeading = ({
         }
       });
     },
-    close: layoutCoordinate?.part === "complementary" ? "minify-end" : true
+    close: layoutPart === "complementary" ? "minify-end" : true
   }));
 };
 
@@ -314,13 +311,64 @@ var LayoutContext = createContext(null);
 var useLayout = () => useContext(LayoutContext) ?? raise(new Error("Missing LayoutContext"));
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/ComplementarySidebar.tsx
-var ComplementarySidebar = ({ id, layoutParts, flatDeck }) => {
+var panels = [
+  {
+    id: "settings",
+    icon: "ph--gear--regular"
+  },
+  {
+    id: "comments",
+    icon: "ph--chat-text--regular"
+  },
+  {
+    id: "automation",
+    icon: "ph--atom--regular"
+  },
+  {
+    id: "debug",
+    icon: "ph--bug--regular"
+  }
+];
+var getPanel = (id) => {
+  const panel = panels.find((p) => p.id === id) ?? panels[0];
+  return panel.id;
+};
+var ComplementarySidebar = ({ layoutParts, flatDeck }) => {
   const { popoverAnchorId } = useLayout();
+  const attended = useAttended();
+  const part = getPanel(layoutParts.complementary?.[0].id);
+  const id = attended[0] ? `${attended[0]}${SLUG_PATH_SEPARATOR2}${part}` : void 0;
   const { graph } = useGraph3();
   const node = useNode(graph, id);
-  const complementaryAttrs = createAttendableAttributes(id?.split(SLUG_PATH_SEPARATOR2)[0] ?? "never");
+  const dispatch = useIntentDispatcher2();
   useNodeActionExpander(node);
-  return /* @__PURE__ */ React5.createElement(Main.ComplementarySidebar, complementaryAttrs, node ? /* @__PURE__ */ React5.createElement("div", {
+  const actions = useMemo(() => panels.map(({ id: id2, icon }) => ({
+    id: `complementary-${id2}`,
+    data: () => {
+      void dispatch({
+        action: NavigationAction2.OPEN,
+        data: {
+          activeParts: {
+            complementary: id2
+          }
+        }
+      });
+    },
+    properties: {
+      label: [
+        `open ${id2} label`,
+        {
+          ns: DECK_PLUGIN
+        }
+      ],
+      icon,
+      menuItemType: "toggle",
+      isChecked: part === id2
+    }
+  })), [
+    part
+  ]);
+  return /* @__PURE__ */ React5.createElement(Main.ComplementarySidebar, null, /* @__PURE__ */ React5.createElement("div", {
     role: "none",
     className: mx2(deckGrid, "grid-cols-1 bs-full")
   }, /* @__PURE__ */ React5.createElement(NodePlankHeading, {
@@ -329,18 +377,19 @@ var ComplementarySidebar = ({ id, layoutParts, flatDeck }) => {
     layoutParts,
     layoutPart: "complementary",
     popoverAnchorId,
-    flatDeck
-  }), /* @__PURE__ */ React5.createElement(Surface3, {
-    role: "article",
+    flatDeck,
+    actions
+  }), /* @__PURE__ */ React5.createElement("div", {
+    className: "row-span-2 divide-y divide-separator"
+  }, node && /* @__PURE__ */ React5.createElement(Surface3, {
+    role: `complementary--${part}`,
     data: {
-      subject: node.data,
-      part: "complementary",
+      subject: node.properties.object,
       popoverAnchorId
     },
-    limit: 1,
     fallback: PlankContentError,
     placeholder: /* @__PURE__ */ React5.createElement(PlankLoading, null)
-  })) : null);
+  }))));
 };
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/ContentEmpty.tsx
@@ -401,11 +450,11 @@ var Fullscreen = ({ id }) => {
 // packages/plugins/plugin-deck/src/components/DeckLayout/Plank.tsx
 import { Plus } from "@phosphor-icons/react";
 import React9, { useCallback, useLayoutEffect, useRef } from "react";
-import { LayoutAction as LayoutAction2, NavigationAction as NavigationAction2, Surface as Surface6, useIntentDispatcher as useIntentDispatcher2 } from "@dxos/app-framework";
+import { LayoutAction as LayoutAction2, NavigationAction as NavigationAction3, Surface as Surface6, useIntentDispatcher as useIntentDispatcher3 } from "@dxos/app-framework";
 import { debounce } from "@dxos/async";
 import { useGraph as useGraph5 } from "@dxos/plugin-graph";
 import { Button, Tooltip, useTranslation as useTranslation4 } from "@dxos/react-ui";
-import { createAttendableAttributes as createAttendableAttributes2 } from "@dxos/react-ui-attention";
+import { useAttendableAttributes } from "@dxos/react-ui-attention";
 import { Plank as NaturalPlank } from "@dxos/react-ui-deck";
 import { mainIntrinsicSize } from "@dxos/react-ui-theme";
 
@@ -418,14 +467,14 @@ var useDeckContext = () => useContext2(DeckContext) ?? raise2(new Error("Missing
 // packages/plugins/plugin-deck/src/components/DeckLayout/Plank.tsx
 var Plank = ({ entry, layoutParts, part, flatDeck, searchEnabled, layoutMode }) => {
   const { t } = useTranslation4(DECK_PLUGIN);
-  const dispatch = useIntentDispatcher2();
+  const dispatch = useIntentDispatcher3();
   const { popoverAnchorId, scrollIntoView } = useLayout();
   const { plankSizing } = useDeckContext();
   const { graph } = useGraph5();
   const node = useNode(graph, entry.id);
   const rootElement = useRef(null);
   const resizeable = layoutMode === "deck";
-  const attendableAttrs = createAttendableAttributes2(entry.id);
+  const attendableAttrs = useAttendableAttributes(entry.id);
   const coordinate = {
     part,
     entryId: entry.id
@@ -463,7 +512,7 @@ var Plank = ({ entry, layoutParts, part, flatDeck, searchEnabled, layoutMode })
     layoutMode
   ]);
   const isSolo = layoutMode === "solo" && part === "solo";
-  const isSuppressed = layoutMode === "solo" && part !== "solo";
+  const isSuppressed = layoutMode === "solo" && part !== "solo" || layoutMode === "deck" && part === "solo";
   const sizeAttrs = useMainSize();
   return /* @__PURE__ */ React9.createElement(NaturalPlank.Root, {
     size,
@@ -529,7 +578,7 @@ var Plank = ({ entry, layoutParts, part, flatDeck, searchEnabled, layoutMode })
           component: "dxos.org/plugin/search/Dialog",
           dialogBlockAlign: "start",
           subject: {
-            action: NavigationAction2.SET,
+            action: NavigationAction3.SET,
             position: "add-after",
             coordinate
           }
@@ -549,12 +598,14 @@ var Plank = ({ entry, layoutParts, part, flatDeck, searchEnabled, layoutMode })
 };
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/Sidebar.tsx
-import React10, { useMemo } from "react";
+import React10, { useMemo as useMemo2 } from "react";
 import { openIds, Surface as Surface7 } from "@dxos/app-framework";
 import { Main as Main2 } from "@dxos/react-ui";
-var Sidebar = ({ attention, layoutParts }) => {
+import { useAttended as useAttended2 } from "@dxos/react-ui-attention";
+var Sidebar = ({ layoutParts }) => {
   const { layoutMode, popoverAnchorId } = useLayout();
-  const activeIds = useMemo(() => {
+  const attended = useAttended2();
+  const activeIds = useMemo2(() => {
     if (layoutMode === "solo") {
       return new Set(layoutParts?.solo?.map((e) => e.id) ?? []);
     } else if (layoutMode === "deck") {
@@ -565,14 +616,14 @@ var Sidebar = ({ attention, layoutParts }) => {
     layoutParts,
     layoutMode
   ]);
-  const navigationData = useMemo(() => ({
+  const navigationData = useMemo2(() => ({
     popoverAnchorId,
     activeIds,
-    attended: attention.attended
+    attended
   }), [
     popoverAnchorId,
     activeIds,
-    attention.attended
+    attended
   ]);
   return /* @__PURE__ */ React10.createElement(Main2.NavigationSidebar, null, /* @__PURE__ */ React10.createElement(Surface7, {
     role: "navigation",
@@ -586,14 +637,19 @@ var Sidebar = ({ attention, layoutParts }) => {
 // packages/plugins/plugin-deck/src/components/DeckLayout/StatusBar.tsx
 import React11 from "react";
 import { Surface as Surface8 } from "@dxos/app-framework";
-import { mainPadding, mx as mx4 } from "@dxos/react-ui-theme";
-var StatusBar = () => {
+import { mainPadding, mainPaddingTransitions, mx as mx4 } from "@dxos/react-ui-theme";
+var StatusBar = ({ showHints }) => {
   const sizeAttrs = useMainSize();
   return /* @__PURE__ */ React11.createElement("div", {
     role: "none",
     ...sizeAttrs,
-    className: mx4("fixed block-end-0 inset-inline-0 z-[2]", mainPadding)
-  }, /* @__PURE__ */ React11.createElement(Surface8, {
+    className: mx4("fixed flex justify-between block-end-0 inset-inline-0 items-center border-bs border-separator z-[2]", mainPadding, mainPaddingTransitions)
+  }, /* @__PURE__ */ React11.createElement("div", {
+    role: "none"
+  }, showHints && /* @__PURE__ */ React11.createElement(Surface8, {
+    role: "hints",
+    limit: 1
+  })), /* @__PURE__ */ React11.createElement(Surface8, {
     role: "status-bar",
     limit: 1
   }));
@@ -601,15 +657,19 @@ var StatusBar = () => {
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/Toast.tsx
 import React12 from "react";
-import { Button as Button2, Toast as NaturalToast } from "@dxos/react-ui";
+import { Button as Button2, Icon as Icon2, Toast as NaturalToast } from "@dxos/react-ui";
 var Toast = ({ id, title, description, icon, duration, actionLabel, actionAlt, closeLabel, onAction, onOpenChange }) => {
   return /* @__PURE__ */ React12.createElement(NaturalToast.Root, {
     "data-testid": id,
     defaultOpen: true,
     duration,
     onOpenChange
-  }, /* @__PURE__ */ React12.createElement(NaturalToast.Body, null, /* @__PURE__ */ React12.createElement(NaturalToast.Title, null, icon?.({
-    className: "inline mr-1"
+  }, /* @__PURE__ */ React12.createElement(NaturalToast.Body, null, /* @__PURE__ */ React12.createElement(NaturalToast.Title, {
+    classNames: "items-center"
+  }, /* @__PURE__ */ React12.createElement(Icon2, {
+    icon,
+    size: 5,
+    classNames: "inline mr-1"
   }), /* @__PURE__ */ React12.createElement("span", null, title)), description && /* @__PURE__ */ React12.createElement(NaturalToast.Description, null, description)), /* @__PURE__ */ React12.createElement(NaturalToast.Actions, null, onAction && actionAlt && actionLabel && /* @__PURE__ */ React12.createElement(NaturalToast.Action, {
     altText: actionAlt,
     asChild: true
@@ -646,7 +706,10 @@ var getEffectivePart = (partName, layoutMode) => layoutMode === "solo" && partNa
 import { PLANK_DEFAULTS } from "@dxos/react-ui-deck";
 var calculateOverscroll = (planks, plankSizing, sidebarOpen, complementarySidebarOpen) => {
   if (!planks?.length) {
-    return;
+    return {
+      paddingInlineStart: 0,
+      paddingInlineEnd: 0
+    };
   }
   const sidebarWidth = sidebarOpen ? "270px" : "0px";
   const complementarySidebarWidth = complementarySidebarOpen ? "360px" : "0px";
@@ -656,8 +719,8 @@ var calculateOverscroll = (planks, plankSizing, sidebarOpen, complementarySideba
     const plankSize = getPlankSize(plank.id);
     const overscrollPadding = `max(0px, calc(((100dvw - ${sidebarWidth} - ${complementarySidebarWidth} - (${plankSize} + 20px)) / 2)))`;
     return {
-      paddingLeft: overscrollPadding,
-      paddingRight: overscrollPadding
+      paddingInlineStart: overscrollPadding,
+      paddingInlineEnd: overscrollPadding
     };
   } else {
     const first = planks[0];
@@ -665,27 +728,33 @@ var calculateOverscroll = (planks, plankSizing, sidebarOpen, complementarySideba
     const last = planks[planks.length - 1];
     const lastSize = getPlankSize(last.id);
     return {
-      paddingLeft: `max(0px, calc(((100dvw - (${firstSize} + 20px)) / 2) - ${sidebarWidth}))`,
-      paddingRight: `max(0px, calc(((100dvw - (${lastSize} + 20px)) / 2) - ${complementarySidebarWidth}))`
+      paddingInlineStart: `max(0px, calc(((100dvw - (${firstSize} + 20px)) / 2) - ${sidebarWidth}))`,
+      paddingInlineEnd: `max(0px, calc(((100dvw - (${lastSize} + 20px)) / 2) - ${complementarySidebarWidth}))`
     };
   }
 };
 
 // packages/plugins/plugin-deck/src/components/DeckLayout/DeckLayout.tsx
-var DeckLayout = ({ layoutParts, attention, toasts, flatDeck, overscroll, showHintsFooter, slots, onDismissToast }) => {
+var DeckLayout = ({ layoutParts, toasts, flatDeck, overscroll, showHints, slots, onDismissToast }) => {
   const context = useLayout();
   const { layoutMode, sidebarOpen, complementarySidebarOpen, dialogOpen, dialogContent, dialogBlockAlign, popoverOpen, popoverContent, popoverAnchorId } = context;
   const { t } = useTranslation5(DECK_PLUGIN);
   const { plankSizing } = useDeckContext();
+  const attended = useAttended3();
   const searchPlugin = usePlugin("dxos.org/plugin/search");
-  const fullScreenSlug = useMemo2(() => firstIdInPart(layoutParts, "fullScreen"), [
+  const fullScreenSlug = useMemo3(() => firstIdInPart(layoutParts, "fullScreen"), [
     layoutParts
   ]);
-  const [scrollLeft, setScrollLeft] = useState3(null);
+  const scrollLeftRef = useRef2();
   const deckRef = useRef2(null);
-  const restoreScrollRef = useRef2(false);
+  useEffect5(() => {
+    const firstId = layoutMode === "solo" ? firstIdInPart(layoutParts, "solo") : firstIdInPart(layoutParts, "main");
+    if (attended.length === 0 && firstId) {
+      document.querySelector(`article[data-attendable-id="${firstId}"] button`)?.focus();
+    }
+  }, []);
   const handleResize = useCallback2(() => {
-    setScrollLeft(null);
+    scrollLeftRef.current = null;
   }, []);
   useEffect5(() => {
     window.addEventListener("resize", handleResize);
@@ -693,36 +762,20 @@ var DeckLayout = ({ layoutParts, attention, toasts, flatDeck, overscroll, showHi
   }, [
     handleResize
   ]);
-  useLayoutEffect2(() => {
-    if (layoutMode !== "deck") {
-      restoreScrollRef.current = true;
-    } else if (restoreScrollRef.current && deckRef.current && scrollLeft) {
-      deckRef.current.scrollLeft = scrollLeft;
-      restoreScrollRef.current = false;
+  const restoreScroll = useCallback2(() => {
+    if (deckRef.current && scrollLeftRef.current != null) {
+      deckRef.current.scrollLeft = scrollLeftRef.current;
     }
-  }, [
-    layoutMode,
-    deckRef.current,
-    scrollLeft
-  ]);
+  }, []);
+  useOnTransition(layoutMode, (mode) => mode !== "deck", "deck", restoreScroll);
   const handleScroll = useCallback2((event) => {
     if (layoutMode === "deck" && event.currentTarget === event.target) {
-      setScrollLeft(event.target.scrollLeft);
+      scrollLeftRef.current = event.target.scrollLeft;
     }
   }, [
     layoutMode
   ]);
-  const complementarySlug = useMemo2(() => {
-    const entry = layoutParts.complementary?.at(0);
-    if (entry) {
-      return entry.path ? `${entry.id}${SLUG_PATH_SEPARATOR3}${entry.path}` : entry.id;
-    }
-  }, [
-    layoutParts
-  ]);
-  const firstAttendedId = useMemo2(() => Array.from(attention.attended ?? [])[0], [
-    attention.attended
-  ]);
+  const firstAttendedId = attended[0];
   useEffect5(() => {
     if (layoutMode === "deck" && firstAttendedId) {
     }
@@ -730,21 +783,20 @@ var DeckLayout = ({ layoutParts, attention, toasts, flatDeck, overscroll, showHi
     layoutMode,
     firstAttendedId
   ]);
-  const parts = useMemo2(() => {
-    const parts2 = [
-      ...layoutParts.main ?? []
-    ];
-    for (const part of layoutParts.solo ?? []) {
-      if (!parts2.find((entry) => entry.id === part.id)) {
-        parts2.push(part);
-      }
+  const isEmpty = layoutParts.main?.length === 0 && layoutParts.solo?.length === 0;
+  const padding = useMemo3(() => {
+    if (layoutMode === "deck" && overscroll === "centering") {
+      return calculateOverscroll(layoutParts.main, plankSizing, sidebarOpen, complementarySidebarOpen);
     }
-    return parts2;
+    return {};
   }, [
+    layoutMode,
+    overscroll,
     layoutParts.main,
-    layoutParts.solo
+    plankSizing,
+    sidebarOpen,
+    complementarySidebarOpen
   ]);
-  const padding = layoutMode === "deck" && overscroll === "centering" ? calculateOverscroll(layoutParts.main, plankSizing, sidebarOpen, complementarySidebarOpen) : {};
   if (layoutMode === "fullscreen") {
     return /* @__PURE__ */ React13.createElement(Fullscreen, {
       id: fullScreenSlug
@@ -766,19 +818,13 @@ var DeckLayout = ({ layoutParts, attention, toasts, flatDeck, overscroll, showHi
   }), /* @__PURE__ */ React13.createElement(Main3.Root, {
     navigationSidebarOpen: context.sidebarOpen,
     onNavigationSidebarOpenChange: (next) => context.sidebarOpen = next,
-    ...complementarySidebarOpen !== null && {
-      complementarySidebarOpen: (
-        /* complementaryAvailable && */
-        context.complementarySidebarOpen
-      ),
-      onComplementarySidebarOpenChange: (next) => context.complementarySidebarOpen = next
-    }
+    complementarySidebarOpen: context.complementarySidebarOpen,
+    onComplementarySidebarOpenChange: (next) => context.complementarySidebarOpen = next
   }, /* @__PURE__ */ React13.createElement(Main3.Notch, {
     classNames: "z-[21]"
   }, /* @__PURE__ */ React13.createElement(Surface9, {
     role: "notch-start"
   }), /* @__PURE__ */ React13.createElement(Button3, {
-    // disabled={!sidebarAvailable}
     onClick: () => context.sidebarOpen = !context.sidebarOpen,
     variant: "ghost",
     classNames: "p-1"
@@ -788,7 +834,6 @@ var DeckLayout = ({ layoutParts, attention, toasts, flatDeck, overscroll, showHi
     weight: "light",
     className: getSize(5)
   })), /* @__PURE__ */ React13.createElement(Button3, {
-    // disabled={!complementaryAvailable}
     onClick: () => context.complementarySidebarOpen = !context.complementarySidebarOpen,
     variant: "ghost",
     classNames: "p-1"
@@ -801,15 +846,14 @@ var DeckLayout = ({ layoutParts, attention, toasts, flatDeck, overscroll, showHi
   })), /* @__PURE__ */ React13.createElement(Surface9, {
     role: "notch-end"
   })), /* @__PURE__ */ React13.createElement(Sidebar, {
-    attention,
     layoutParts
   }), /* @__PURE__ */ React13.createElement(ComplementarySidebar, {
-    id: complementarySlug,
+    context: "comments",
     layoutParts,
     flatDeck
-  }), /* @__PURE__ */ React13.createElement(Main3.Overlay, null), parts.length === 0 && /* @__PURE__ */ React13.createElement(Main3.Content, {
+  }), /* @__PURE__ */ React13.createElement(Main3.Overlay, null), isEmpty && /* @__PURE__ */ React13.createElement(Main3.Content, {
     handlesFocus: true
-  }, /* @__PURE__ */ React13.createElement(ContentEmpty, null)), parts.length !== 0 && /* @__PURE__ */ React13.createElement(Main3.Content, {
+  }, /* @__PURE__ */ React13.createElement(ContentEmpty, null)), !isEmpty && /* @__PURE__ */ React13.createElement(Main3.Content, {
     bounce: true,
     classNames: "grid block-end-[--statusbar-size]",
     handlesFocus: true
@@ -820,26 +864,33 @@ var DeckLayout = ({ layoutParts, attention, toasts, flatDeck, overscroll, showHi
     style: padding,
     classNames: [
       !flatDeck && "bg-deck",
+      mainPaddingTransitions2,
       "absolute inset-0",
       slots?.wallpaper?.classNames
     ],
     solo: layoutMode === "solo",
     onScroll: handleScroll,
     ref: deckRef
-  }, parts.map((layoutEntry) => /* @__PURE__ */ React13.createElement(Plank, {
+  }, /* @__PURE__ */ React13.createElement(Plank, {
+    entry: layoutParts.solo?.[0] ?? {
+      id: "unknown-solo"
+    },
+    layoutParts,
+    part: "solo",
+    layoutMode,
+    flatDeck,
+    searchEnabled: !!searchPlugin
+  }), layoutParts.main?.map((layoutEntry) => /* @__PURE__ */ React13.createElement(Plank, {
     key: layoutEntry.id,
     entry: layoutEntry,
     layoutParts,
-    part: layoutMode === "solo" && layoutEntry.id === layoutParts.solo?.[0]?.id ? "solo" : "main",
+    part: "main",
     layoutMode,
     flatDeck,
     searchEnabled: !!searchPlugin
-  }))))), /* @__PURE__ */ React13.createElement(StatusBar, null), showHintsFooter && /* @__PURE__ */ React13.createElement("div", {
-    className: "fixed bottom-0 left-0 right-0 h-[32px] z-[1] flex justify-center"
-  }, /* @__PURE__ */ React13.createElement(Surface9, {
-    role: "hints",
-    limit: 1
-  })), /* @__PURE__ */ React13.createElement(Popover2.Portal, null, /* @__PURE__ */ React13.createElement(Popover2.Content, {
+  }))))), /* @__PURE__ */ React13.createElement(StatusBar, {
+    showHints
+  }), /* @__PURE__ */ React13.createElement(Popover2.Portal, null, /* @__PURE__ */ React13.createElement(Popover2.Content, {
     classNames: "z-[60]",
     onEscapeKeyDown: () => {
       context.popoverOpen = false;
@@ -908,31 +959,31 @@ var LayoutSettings = ({ settings }) => {
     key: option,
     value: option
   }, t(`settings overscroll ${option} label`)))))))), /* @__PURE__ */ React14.createElement(SettingsValue, {
-    label: t("settings show footer label")
+    label: t("settings show hints label")
   }, /* @__PURE__ */ React14.createElement(Input.Switch, {
-    checked: settings.showFooter,
-    onCheckedChange: (checked) => settings.showFooter = !!checked
+    checked: settings.showHints,
+    onCheckedChange: (checked) => settings.showHints = checked
   })), !isSocket && /* @__PURE__ */ React14.createElement(SettingsValue, {
     label: t("settings native redirect label")
   }, /* @__PURE__ */ React14.createElement(Input.Switch, {
     checked: settings.enableNativeRedirect,
-    onCheckedChange: (checked) => settings.enableNativeRedirect = !!checked
+    onCheckedChange: (checked) => settings.enableNativeRedirect = checked
   })), /* @__PURE__ */ React14.createElement(SettingsValue, {
     label: t("settings custom slots")
   }, /* @__PURE__ */ React14.createElement(Input.Switch, {
     checked: settings.customSlots,
-    onCheckedChange: (checked) => settings.customSlots = !!checked
+    onCheckedChange: (checked) => settings.customSlots = checked
   })), /* @__PURE__ */ React14.createElement(SettingsValue, {
     label: t("settings flat deck")
   }, /* @__PURE__ */ React14.createElement(Input.Switch, {
     checked: settings.flatDeck,
-    onCheckedChange: (checked) => settings.flatDeck = !!checked
+    onCheckedChange: (checked) => settings.flatDeck = checked
   })));
 };
 
 // packages/plugins/plugin-deck/src/layout.ts
 import { produce } from "immer";
-import { SLUG_ENTRY_SEPARATOR, SLUG_KEY_VALUE_SEPARATOR, SLUG_LIST_SEPARATOR, SLUG_PATH_SEPARATOR as SLUG_PATH_SEPARATOR4 } from "@dxos/app-framework";
+import { SLUG_ENTRY_SEPARATOR, SLUG_KEY_VALUE_SEPARATOR, SLUG_LIST_SEPARATOR, SLUG_PATH_SEPARATOR as SLUG_PATH_SEPARATOR3 } from "@dxos/app-framework";
 var partsThatSupportIncrement = [
   "main"
 ];
@@ -1045,7 +1096,7 @@ var mergeLayoutParts = (...layoutParts) => {
   }), {});
 };
 var parseLayoutEntry = (itemString) => {
-  const [id, path] = itemString.split(SLUG_PATH_SEPARATOR4);
+  const [id, path] = itemString.split(SLUG_PATH_SEPARATOR3);
   const entry = {
     id
   };
@@ -1072,7 +1123,7 @@ var soloPartToUri = (layout) => {
     return "";
   }
   const entry = soloPart[0];
-  return `${entry.id}${entry.path ? SLUG_PATH_SEPARATOR4 + entry.path : ""}`;
+  return `${entry.id}${entry.path ? SLUG_PATH_SEPARATOR3 + entry.path : ""}`;
 };
 
 // packages/plugins/plugin-deck/src/translations.ts
@@ -1083,12 +1134,11 @@ var translations_default = [
         "main header label": "Main header",
         "open navigation sidebar label": "Open navigation sidebar.",
         "open complementary sidebar label": "Open complementary sidebar.",
-        "open settings label": "Show settings",
         "plugin error message": "Content failed to render.",
         "content fallback message": "Unsupported",
         "content fallback description": "No plugin had a response for the address you navigated\xA0to. Double-check the URL, and ensure you\u2019ve enabled a plugin that supports the\xA0object.",
         "toggle fullscreen label": "Toggle fullscreen",
-        "settings show footer label": "Show footer (experimental)",
+        "settings show hints label": "Show hints",
         "settings native redirect label": "Enable native url redirect (experimental)",
         "settings custom slots": "Theme option (experimental)",
         "settings new plank position start label": "Start",
@@ -1099,7 +1149,6 @@ var translations_default = [
         "undo action label": "Undo",
         "undo action alt": "Undo previous action",
         "undo close label": "Dismiss",
-        "open comments label": "Open comments",
         "error fallback message": "Unable to open this item",
         "plank heading fallback label": "Untitled",
         "actions menu label": "Options",
@@ -1112,7 +1161,12 @@ var translations_default = [
         "select overscroll placeholder": "Select plank overscrolling behavior",
         "settings overscroll centering label": "Centering",
         "settings overscroll none label": "None",
-        "settings flat deck": "Flatten deck appearance"
+        "settings flat deck": "Flatten deck appearance",
+        // ComplementarySidebar
+        "open settings label": "Show settings",
+        "open comments label": "Show Comments",
+        "open automation label": "Show Automation",
+        "open debug label": "Show Debug"
       }
     }
   }
@@ -1142,7 +1196,7 @@ var DeckPlugin = ({ observability } = {}) => {
   let currentUndoId;
   let handleNavigation;
   const settings = new LocalStorageStore("dxos.org/settings/layout", {
-    showFooter: false,
+    showHints: false,
     customSlots: false,
     flatDeck: false,
     enableNativeRedirect: false,
@@ -1227,6 +1281,22 @@ var DeckPlugin = ({ observability } = {}) => {
       }
     }
   };
+  const handleSetLocation = (next) => {
+    if (attentionPlugin) {
+      const attended = attentionPlugin.provides.attention.attended;
+      const [attendedId] = Array.from(attended);
+      const ids = (layout.values.layoutMode === "deck" ? next.main : next.solo)?.map(({ id }) => id) ?? [];
+      const isAttendedAvailable = !!attendedId && ids.includes(attendedId);
+      if (!isAttendedAvailable) {
+        requestAnimationFrame(() => {
+          const nextAttended = layout.values.layoutMode === "solo" ? next.solo?.[0].id : next.main?.[0]?.id;
+          const article = document.querySelector(`article[data-attendable-id="${nextAttended}"]`);
+          article?.focus();
+        });
+      }
+    }
+    location.values.active = next;
+  };
   return {
     meta: meta_default,
     ready: async (plugins) => {
@@ -1267,8 +1337,8 @@ var DeckPlugin = ({ observability } = {}) => {
         deck.expunge();
       }));
       settings.prop({
-        key: "showFooter",
-        storageKey: "show-footer",
+        key: "showHints",
+        storageKey: "show-hints",
         type: LocalStorageStore.bool()
       }).prop({
         key: "customSlots",
@@ -1301,13 +1371,13 @@ var DeckPlugin = ({ observability } = {}) => {
       handleNavigation = async () => {
         const pathname = window.location.pathname;
         if (pathname === "/reset") {
-          location.values.active = {
+          handleSetLocation({
             sidebar: [
               {
                 id: NAV_ID
               }
             ]
-          };
+          });
           location.values.closed = [];
           layout.values.layoutMode = "solo";
           window.location.pathname = "/";
@@ -1318,26 +1388,16 @@ var DeckPlugin = ({ observability } = {}) => {
           return;
         }
         const startingLayout = removePart(location.values.active, "solo");
-        location.values.active = mergeLayoutParts(layoutFromUri, startingLayout);
+        handleSetLocation(mergeLayoutParts(layoutFromUri, startingLayout));
         layout.values.layoutMode = "solo";
       };
       await handleNavigation();
       window.addEventListener("popstate", handleNavigation);
-      unsubscriptionCallbacks.push(effect(() => {
-        const selectedPath = soloPartToUri(location.values.active);
+      unsubscriptionCallbacks.push(scheduledEffect(() => ({
+        selectedPath: soloPartToUri(location.values.active)
+      }), ({ selectedPath }) => {
         history.pushState(null, "", `/${selectedPath}${window.location.search}`);
       }));
-      unsubscriptionCallbacks.push(effect(() => {
-        const soloId = location.values.active.solo?.[0].id;
-        if (layout.values.layoutMode === "solo" && soloId && layout.values.scrollIntoView !== soloId) {
-          void intentPlugin?.provides.intent.dispatch({
-            action: LayoutAction3.SCROLL_INTO_VIEW,
-            data: {
-              id: soloId
-            }
-          });
-        }
-      }));
       layoutModeHistory.values.push(`${layout.values.layoutMode}`);
     },
     unload: async () => {
@@ -1380,8 +1440,7 @@ var DeckPlugin = ({ observability } = {}) => {
                       ns: DECK_PLUGIN
                     }
                   ],
-                  icon: (props) => /* @__PURE__ */ React15.createElement(ArrowsOut, props),
-                  iconSymbol: "ph--arrows-out--regular",
+                  icon: "ph--arrows-out--regular",
                   keyBinding: {
                     macos: "ctrl+meta+f",
                     windows: "shift+ctrl+f"
@@ -1398,12 +1457,9 @@ var DeckPlugin = ({ observability } = {}) => {
         value: deck.values
       }, props.children)),
       root: () => {
-        return /* @__PURE__ */ React15.createElement(Mosaic.Root, null, /* @__PURE__ */ React15.createElement(DeckLayout, {
-          attention: attentionPlugin?.provides.attention ?? {
-            attended: /* @__PURE__ */ new Set()
-          },
+        return /* @__PURE__ */ React15.createElement(DeckLayout, {
           layoutParts: location.values.active,
-          showHintsFooter: settings.values.showFooter,
+          showHints: settings.values.showHints,
           overscroll: settings.values.overscroll,
           flatDeck: settings.values.flatDeck,
           slots: settings.values.customSlots ? customSlots : void 0,
@@ -1419,7 +1475,7 @@ var DeckPlugin = ({ observability } = {}) => {
               }, 1e3);
             }
           }
-        }), /* @__PURE__ */ React15.createElement(Mosaic.DragOverlay, null));
+        });
       },
       surface: {
         component: ({ data, role }) => {
@@ -1455,7 +1511,7 @@ var DeckPlugin = ({ observability } = {}) => {
                 } else {
                   log.warn("Invalid layout mode", intent?.data?.layoutMode, {
                     F: __dxlog_file,
-                    L: 390,
+                    L: 404,
                     S: void 0,
                     C: (f, a) => f(...a)
                   });
@@ -1501,7 +1557,7 @@ var DeckPlugin = ({ observability } = {}) => {
                 data: true
               };
             }
-            case NavigationAction3.OPEN: {
+            case NavigationAction4.OPEN: {
               const previouslyOpenIds = new Set(openIds2(location.values.active));
               const layoutMode = layout.values.layoutMode;
               batch(() => {
@@ -1510,7 +1566,7 @@ var DeckPlugin = ({ observability } = {}) => {
                 }
                 const processLayoutEntry = (partName, entryString, currentLayout) => {
                   const toggle = true;
-                  const [id, path] = entryString.split(SLUG_PATH_SEPARATOR5);
+                  const [id, path] = entryString.split(SLUG_PATH_SEPARATOR4);
                   const layoutEntry = {
                     id,
                     ...path ? {
@@ -1539,7 +1595,7 @@ var DeckPlugin = ({ observability } = {}) => {
                     newLayout = processLayoutEntry(partName, layoutEntries, newLayout);
                   }
                 });
-                location.values.active = newLayout;
+                handleSetLocation(newLayout);
               });
               const ids = openIds2(location.values.active);
               const newlyOpen = ids.filter((i) => !previouslyOpenIds.has(i));
@@ -1558,7 +1614,7 @@ var DeckPlugin = ({ observability } = {}) => {
                   ] : [],
                   intent.data?.object ? [
                     {
-                      action: NavigationAction3.EXPOSE,
+                      action: NavigationAction4.EXPOSE,
                       data: {
                         id: fullyQualifiedId(intent.data.object)
                       }
@@ -1581,16 +1637,16 @@ var DeckPlugin = ({ observability } = {}) => {
                 ]
               };
             }
-            case NavigationAction3.ADD_TO_ACTIVE: {
+            case NavigationAction4.ADD_TO_ACTIVE: {
               const data = intent.data;
               const layoutEntry = {
                 id: data.id
               };
               const effectivePart = getEffectivePart(data.part, layout.values.layoutMode);
-              location.values.active = openEntry(location.values.active, effectivePart, layoutEntry, {
+              handleSetLocation(openEntry(location.values.active, effectivePart, layoutEntry, {
                 positioning: data.positioning ?? settings.values.newPlankPositioning,
                 pivotId: data.pivotId
-              });
+              }));
               const intents = [];
               if (data.scrollIntoView && layout.values.layoutMode === "deck") {
                 intents.push([
@@ -1607,7 +1663,7 @@ var DeckPlugin = ({ observability } = {}) => {
                 intents
               };
             }
-            case NavigationAction3.CLOSE: {
+            case NavigationAction4.CLOSE: {
               return batch(() => {
                 if (!intent.data) {
                   return;
@@ -1632,32 +1688,32 @@ var DeckPlugin = ({ observability } = {}) => {
                     });
                   }
                 });
-                location.values.active = newLayout;
+                handleSetLocation(newLayout);
                 return {
                   data: true
                 };
               });
             }
             // TODO(wittjosiah): Factor out.
-            case NavigationAction3.SET: {
+            case NavigationAction4.SET: {
               return batch(() => {
                 if (isLayoutParts(intent.data?.activeParts)) {
-                  location.values.active = intent.data.activeParts;
+                  handleSetLocation(intent.data.activeParts);
                 }
                 return {
                   data: true
                 };
               });
             }
-            case NavigationAction3.ADJUST: {
+            case NavigationAction4.ADJUST: {
               return batch(() => {
                 if (isLayoutAdjustment(intent.data)) {
                   const adjustment = intent.data;
                   if (adjustment.type === "increment-end" || adjustment.type === "increment-start") {
-                    location.values.active = incrementPlank(location.values.active, {
+                    handleSetLocation(incrementPlank(location.values.active, {
                       type: adjustment.type,
                       layoutCoordinate: adjustment.layoutCoordinate
-                    });
+                    }));
                   }
                   if (adjustment.type === "solo") {
                     const entryId = adjustment.layoutCoordinate.entryId;
@@ -1673,7 +1729,7 @@ var DeckPlugin = ({ observability } = {}) => {
                               }
                             },
                             {
-                              action: NavigationAction3.OPEN,
+                              action: NavigationAction4.OPEN,
                               data: {
                                 activeParts: {
                                   solo: [
@@ -1697,7 +1753,7 @@ var DeckPlugin = ({ observability } = {}) => {
                               }
                             },
                             {
-                              action: NavigationAction3.CLOSE,
+                              action: NavigationAction4.CLOSE,
                               data: {
                                 activeParts: {
                                   solo: [
@@ -1707,7 +1763,7 @@ var DeckPlugin = ({ observability } = {}) => {
                               }
                             },
                             {
-                              action: NavigationAction3.OPEN,
+                              action: NavigationAction4.OPEN,
                               data: {
                                 noToggle: true,
                                 activeParts: {