@dxos/plugin-deck 0.9.0 → 0.9.1-staging.ee54ba693a

package/PLUGIN.mdl

@@ -44,8 +44,10 @@ type DeckState
     fullscreen: boolean           # true when the solo plank is displayed without any chrome
     plankSizing: Record<string, number>   # persisted plank widths in rem, keyed by item ID
     companionOpen: boolean        # whether the companion pane is visible
-    companionVariant?: string     # which companion variant to display
+    companionOrientation?: 'horizontal' | 'vertical'   # companion splitter orientation (side-by-side / stacked)
     companionFrameSizing: Record<string, number>  # companion frame widths in rem
+    # NOTE: the selected companion variant and per-orientation split size now live in react-ui-attention
+    # view state (global, localStorage), not on DeckState — see util/companion-view-state.ts.
 ```
 
 ```mdl

package/dist/lib/neutral/{DeckLayout-DEURA3KR.mjs → DeckLayout-B3RUUV5P.mjs}

@@ -1,8 +1,9 @@
 import {
   Deck,
   PlankErrorFallback
-} from "./chunk-WAXJPQJI.mjs";
-import "./chunk-GBIGQKYW.mjs";
+} from "./chunk-Z2B5RSVI.mjs";
+import "./chunk-PP32NEVY.mjs";
+import "./chunk-SONATB35.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
 // src/containers/DeckLayout/DeckLayout.tsx
@@ -86,7 +87,7 @@ import React3, { useCallback as useCallback2, useEffect, useRef, useState } from
 import { Surface as Surface3 } from "@dxos/app-framework/ui";
 import { AppSurface as AppSurface3, useObjectMenuItems } from "@dxos/app-toolkit/ui";
 import { Obj } from "@dxos/echo";
-import { Card, Popover, toLocalizedString, Toolbar, useTranslation } from "@dxos/react-ui";
+import { Card, Icon, IconButton, Popover, toLocalizedString, useMediaQuery, useTranslation } from "@dxos/react-ui";
 import { Menu } from "@dxos/react-ui-menu";
 import { useDeckState as useDeckState2 } from "#hooks";
 import { meta } from "#meta";
@@ -116,10 +117,11 @@ var PopoverRoot = ({ children }) => {
     state.popoverAnchor,
     state.popoverContent
   ]);
+  const modal = state.popoverKind === "rename";
   return /* @__PURE__ */ React3.createElement(DeckPopoverProvider, {
     setOpen
   }, /* @__PURE__ */ React3.createElement(Popover.Root, {
-    modal: false,
+    modal,
     open
   }, state.popoverAnchor && /* @__PURE__ */ React3.createElement(Popover.VirtualTrigger, {
     key: virtualIter,
@@ -127,7 +129,7 @@ var PopoverRoot = ({ children }) => {
   }), children));
 };
 var PopoverContent = () => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const { state, updateEphemeral } = useDeckState2();
   const { setOpen } = useDeckPopoverContext("PopoverContent");
   const popoverSubject = state.popoverContent && "subject" in state.popoverContent ? state.popoverContent.subject : void 0;
@@ -136,7 +138,14 @@ var PopoverContent = () => {
   const title = state.popoverTitle ? toLocalizedString(state.popoverTitle, t) : "Unknown";
   const icon = isObjectPopover ? Obj.getIcon(popoverSubject)?.icon ?? "ph--circle-dashed--regular" : void 0;
   const content = state.popoverContent;
-  const isBasePopover = state.popoverKind === "base" && !!content && "component" in content;
+  const isComponentPopover = (state.popoverKind === "base" || state.popoverKind === "rename") && !!content && "component" in content;
+  const isRename = state.popoverKind === "rename";
+  const [isLg] = useMediaQuery("lg", {
+    fallback: [
+      true
+    ]
+  });
+  const side = isRename ? isLg ? "right" : "bottom" : state.popoverSide;
   const handleClose = useCallback2(() => {
     setOpen(false);
     updateEphemeral((state2) => ({
@@ -150,25 +159,28 @@ var PopoverContent = () => {
     updateEphemeral
   ]);
   const handleInteractOutside = useCallback2((event) => {
-    if (
-      // TODO(thure): CodeMirror should not focus itself when it updates.
-      event.type === "dismissableLayer.focusOutside" && event.currentTarget?.classList.contains("cm-content")
-    ) {
+    if (event.type === "dismissableLayer.focusOutside") {
       event.preventDefault();
-    } else {
-      handleClose();
+      return;
     }
+    handleClose();
   }, [
     handleClose
   ]);
   return /* @__PURE__ */ React3.createElement(Popover.Portal, null, /* @__PURE__ */ React3.createElement(Popover.Content, {
-    side: state.popoverSide,
+    side,
     sticky: "always",
     hideWhenDetached: true,
-    onOpenAutoFocus: (event) => event.preventDefault(),
+    // Rename focuses its input; other popovers keep focus where it was.
+    onOpenAutoFocus: isRename ? void 0 : (event) => event.preventDefault(),
     onInteractOutside: handleInteractOutside,
-    onEscapeKeyDown: handleInteractOutside
-  }, /* @__PURE__ */ React3.createElement(Popover.Viewport, null, isBasePopover && content && "component" in content ? (
+    onEscapeKeyDown: handleInteractOutside,
+    // Reuse the dialog's enter/exit motion so the rename popover does not flicker on open.
+    classNames: isRename ? [
+      "data-[state=open]:animate-slide-up-and-fade",
+      "data-[state=closed]:animate-slide-down-and-fade"
+    ] : void 0
+  }, /* @__PURE__ */ React3.createElement(Popover.Viewport, null, isComponentPopover && content && "component" in content ? (
     /* Base popover: a plugin-provided component (e.g. editor link preview). */
     /* @__PURE__ */ React3.createElement(Surface3.Surface, {
       type: AppSurface3.Popover,
@@ -186,12 +198,14 @@ var PopoverContent = () => {
     /* @__PURE__ */ React3.createElement(Menu.Root, null, /* @__PURE__ */ React3.createElement(Card.Root, {
       border: false,
       classNames: "dx-card-popover"
-    }, /* @__PURE__ */ React3.createElement(Card.Header, null, /* @__PURE__ */ React3.createElement(Card.IconBlock, null, icon && /* @__PURE__ */ React3.createElement(Card.Icon, {
+    }, /* @__PURE__ */ React3.createElement(Card.Header, null, /* @__PURE__ */ React3.createElement(Card.Block, null, icon && /* @__PURE__ */ React3.createElement(Icon, {
       icon
-    })), /* @__PURE__ */ React3.createElement(Card.Title, null, title), /* @__PURE__ */ React3.createElement(Card.IconBlock, null, /* @__PURE__ */ React3.createElement(Menu.Trigger, {
+    })), /* @__PURE__ */ React3.createElement(Card.Title, null, title), /* @__PURE__ */ React3.createElement(Card.Block, {
+      end: true
+    }, /* @__PURE__ */ React3.createElement(Menu.Trigger, {
       asChild: true,
       disabled: !objectMenuItems.length
-    }, /* @__PURE__ */ React3.createElement(Toolbar.IconButton, {
+    }, /* @__PURE__ */ React3.createElement(IconButton, {
       variant: "ghost",
       density: "sm",
       icon: "ph--dots-three-vertical--regular",
@@ -200,7 +214,7 @@ var PopoverContent = () => {
     })), /* @__PURE__ */ React3.createElement(Menu.Content, {
       items: objectMenuItems
     }))), content && "subject" in content ? /* @__PURE__ */ React3.createElement(Surface3.Surface, {
-      type: AppSurface3.Card,
+      type: AppSurface3.CardContent,
       data: content,
       limit: 1
     }) : /* @__PURE__ */ React3.createElement(Card.Body, {
@@ -216,7 +230,7 @@ import React4, { useState as useState2 } from "react";
 import { Button, Toast as NaturalToast, toLocalizedString as toLocalizedString2, useTranslation as useTranslation2 } from "@dxos/react-ui";
 import { meta as meta2 } from "#meta";
 var Toast = ({ id, title, description, icon, duration, actionLabel, actionAlt, onAction, onOpenChange }) => {
-  const { t } = useTranslation2(meta2.id);
+  const { t } = useTranslation2(meta2.profile.key);
   const [open, setOpen] = useState2(true);
   const handleOpenChange = (next) => {
     setOpen(next);
@@ -288,4 +302,4 @@ export {
   NAV_ID,
   DeckLayout_default as default
 };
-//# sourceMappingURL=DeckLayout-DEURA3KR.mjs.map
+//# sourceMappingURL=DeckLayout-B3RUUV5P.mjs.map

package/dist/lib/neutral/DeckLayout-B3RUUV5P.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/containers/DeckLayout/DeckLayout.tsx", "../../../src/containers/DeckLayout/ActiveNode.tsx", "../../../src/containers/DeckLayout/Dialog.tsx", "../../../src/containers/DeckLayout/Popover.tsx", "../../../src/containers/DeckLayout/Toast.tsx", "../../../src/containers/DeckLayout/constants.ts", "../../../src/containers/DeckLayout/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { useCallback } from 'react';\n\nimport { useAtomCapability, useOperationInvoker, usePluginManager } from '@dxos/app-framework/ui';\nimport { LayoutOperation } from '@dxos/app-toolkit';\nimport { Mosaic } from '@dxos/react-ui-mosaic';\n\nimport { useDeckState } from '#hooks';\nimport { DeckCapabilities, getMode } from '#types';\n\nimport { Deck, type DeckLayoutChangeRequest } from '../Deck';\nimport { ActiveNode } from './ActiveNode';\nimport { Dialog } from './Dialog';\nimport { PopoverContent, PopoverRoot } from './Popover';\nimport { Toaster, type ToasterProps } from './Toast';\n\nexport type DeckLayoutProps = Pick<ToasterProps, 'onDismissToast'>;\n\nexport const DeckLayout = ({ onDismissToast }: DeckLayoutProps) => {\n  const settings = useAtomCapability(DeckCapabilities.Settings);\n  const pluginManager = usePluginManager();\n  const { invokePromise } = useOperationInvoker();\n  const { deck, state, updateState } = useDeckState();\n  const layoutMode = getMode(deck);\n  const { toasts } = state;\n\n  const handleLayoutChange = useCallback(\n    (request: DeckLayoutChangeRequest) => {\n      void invokePromise(LayoutOperation.SetLayoutMode, request);\n    },\n    [invokePromise],\n  );\n\n  return (\n    <Mosaic.Root>\n      <PopoverRoot>\n        <ActiveNode />\n        <Deck.Root\n          settings={settings}\n          pluginManager={pluginManager}\n          layoutMode={layoutMode}\n          deck={deck}\n          state={state}\n          updateState={updateState}\n          onLayoutChange={handleLayoutChange}\n        >\n          <Deck.Content>\n            <Deck.Viewport>\n              {deck.solo ? <Deck.SoloMode /> : deck.active.length === 0 ? <Deck.ContentEmpty /> : <Deck.MultiMode />}\n            </Deck.Viewport>\n          </Deck.Content>\n        </Deck.Root>\n        <PopoverContent />\n        <Dialog />\n        <Toaster toasts={toasts} onDismissToast={onDismissToast} />\n      </PopoverRoot>\n    </Mosaic.Root>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface, useAppGraph } from '@dxos/app-toolkit/ui';\nimport { useNode } from '@dxos/plugin-graph';\nimport { useAttended } from '@dxos/react-ui-attention';\n\nimport { useNodeActionExpander } from '#hooks';\n\n// TODO(burdon): Factor out to effect in plugin set document title.\nexport const ActiveNode = () => {\n  const [id] = useAttended();\n  const { graph } = useAppGraph();\n  const activeNode = useNode(graph, id);\n  useNodeActionExpander(activeNode);\n\n  return (\n    <div className='sr-only'>\n      {/* TODO(wittjosiah): Weird that this is a surface, feel like it's not really render logic.\n            Probably this lives in React-land currently in order to access translations? */}\n      <Surface.Surface\n        type={AppSurface.DocumentTitle}\n        data={{ subject: activeNode } satisfies AppSurface.DocumentTitleData}\n        limit={1}\n      />\n    </div>\n  );\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { useCallback } from 'react';\n\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { AlertDialog, Dialog as NaturalDialog } from '@dxos/react-ui';\n\nimport { useDeckState } from '#hooks';\n\nimport { PlankErrorFallback } from '../Deck/PlankFallback';\n\nexport const Dialog = () => {\n  const { state, updateEphemeral } = useDeckState();\n  const { dialogOpen, dialogType, dialogBlockAlign, dialogOverlayClasses, dialogOverlayStyle, dialogContent } = state;\n  const Root = dialogType === 'alert' ? AlertDialog.Root : NaturalDialog.Root;\n  const Overlay = dialogType === 'alert' ? AlertDialog.Overlay : NaturalDialog.Overlay;\n\n  const handleOpenChange = useCallback(\n    (nextOpen: boolean) => {\n      updateEphemeral((s) => ({ ...s, dialogOpen: nextOpen }));\n    },\n    [updateEphemeral],\n  );\n\n  // TODO(thure): End block alignment affecting `modal` and whether the surface renders in an overlay is tailored to the needs of the ambient chat dialog. As the feature matures, consider separating concerns.\n  return (\n    <Root modal={dialogBlockAlign !== 'end'} open={dialogOpen} onOpenChange={handleOpenChange}>\n      {dialogBlockAlign === 'end' ? (\n        // TODO(burdon): Placeholder creates a suspense boundary; replace with defaults.\n        <Surface.Surface\n          type={AppSurface.Dialog}\n          data={dialogContent ?? undefined}\n          limit={1}\n          fallback={PlankErrorFallback}\n          placeholder={<div />}\n        />\n      ) : (\n        <Overlay blockAlign={dialogBlockAlign} classNames={dialogOverlayClasses} style={dialogOverlayStyle}>\n          <Surface.Surface\n            type={AppSurface.Dialog}\n            data={dialogContent ?? undefined}\n            limit={1}\n            fallback={PlankErrorFallback}\n          />\n        </Overlay>\n      )}\n    </Root>\n  );\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from '@radix-ui/react-context';\nimport React, { type PropsWithChildren, useCallback, useEffect, useRef, useState } from 'react';\n\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface, useObjectMenuItems } from '@dxos/app-toolkit/ui';\nimport { Obj } from '@dxos/echo';\nimport {\n  Card,\n  Icon,\n  IconButton,\n  Popover,\n  type PopoverContentInteractOutsideEvent,\n  toLocalizedString,\n  useMediaQuery,\n  useTranslation,\n} from '@dxos/react-ui';\nimport { Menu } from '@dxos/react-ui-menu';\n\nimport { useDeckState } from '#hooks';\nimport { meta } from '#meta';\n\nconst DEBOUNCE_DELAY = 40;\n\ntype DeckPopoverContextValue = {\n  setOpen: (open: boolean) => void;\n};\n\nconst [DeckPopoverProvider, useDeckPopoverContext] = createContext<DeckPopoverContextValue>('DeckPopover');\n\nexport type PopoverRootProps = PropsWithChildren;\n\nexport const PopoverRoot = ({ children }: PopoverRootProps) => {\n  const { state } = useDeckState();\n  const virtualRef = useRef<HTMLButtonElement | null>(null);\n  const [virtualIter, setVirtualIter] = useState(0);\n  const [open, setOpen] = useState(false);\n  const debounceRef = useRef<NodeJS.Timeout | null>(null);\n\n  // TODO(thure): This is a workaround for the race condition between displaying a Popover and either rendering\n  //  the anchor further down the tree or measuring the virtual trigger's client rect.\n  useEffect(() => {\n    setOpen(false);\n    if (state.popoverOpen) {\n      if (debounceRef.current) {\n        clearTimeout(debounceRef.current);\n      }\n      if (state.popoverAnchor && virtualRef.current !== state.popoverAnchor) {\n        virtualRef.current = state.popoverAnchor ?? null;\n        setVirtualIter((iter) => iter + 1);\n      }\n      debounceRef.current = setTimeout(() => setOpen(true), DEBOUNCE_DELAY);\n    }\n  }, [state.popoverOpen, state.popoverAnchorId, state.popoverAnchor, state.popoverContent]);\n\n  // The rename popover is modal so other navtree item menus are inert while it is open.\n  const modal = state.popoverKind === 'rename';\n\n  return (\n    <DeckPopoverProvider setOpen={setOpen}>\n      <Popover.Root modal={modal} open={open}>\n        {state.popoverAnchor && <Popover.VirtualTrigger key={virtualIter} virtualRef={virtualRef} />}\n        {children}\n      </Popover.Root>\n    </DeckPopoverProvider>\n  );\n};\n\nexport const PopoverContent = () => {\n  const { t } = useTranslation(meta.profile.key);\n  const { state, updateEphemeral } = useDeckState();\n  const { setOpen } = useDeckPopoverContext('PopoverContent');\n  const popoverSubject =\n    state.popoverContent && 'subject' in state.popoverContent ? state.popoverContent.subject : undefined;\n  const isObjectPopover = Obj.isObject(popoverSubject);\n  const objectMenuItems = useObjectMenuItems(popoverSubject);\n  const title = state.popoverTitle ? toLocalizedString(state.popoverTitle, t) : 'Unknown';\n  const icon = isObjectPopover ? (Obj.getIcon(popoverSubject)?.icon ?? 'ph--circle-dashed--regular') : undefined;\n  const content = state.popoverContent;\n  // Base and rename popovers render a plugin-provided component; everything else falls through to the card.\n  const isComponentPopover =\n    (state.popoverKind === 'base' || state.popoverKind === 'rename') && !!content && 'component' in content;\n  const isRename = state.popoverKind === 'rename';\n\n  // Anchor to the right of the row on wide displays; drop centered below on narrow ones.\n  const [isLg] = useMediaQuery('lg', { fallback: [true] });\n  const side = isRename ? (isLg ? 'right' : 'bottom') : state.popoverSide;\n\n  const handleClose = useCallback(() => {\n    setOpen(false);\n    updateEphemeral((state) => ({\n      ...state,\n      popoverOpen: false,\n      popoverAnchor: undefined,\n      popoverAnchorId: undefined,\n      popoverSide: undefined,\n    }));\n  }, [updateEphemeral]);\n\n  const handleInteractOutside = useCallback(\n    (event: KeyboardEvent | PopoverContentInteractOutsideEvent) => {\n      // Focus leaving the popover (clicking into the card surfaces a portaled menu, or CodeMirror\n      // re-focusing itself) must not dismiss it — only a pointer-down genuinely outside the card, or\n      // Escape, closes. (Clicks inside the card never reach here; Radix scopes them to the content.)\n      if (event.type === 'dismissableLayer.focusOutside') {\n        event.preventDefault();\n        return;\n      }\n      handleClose();\n    },\n    [handleClose],\n  );\n\n  return (\n    <Popover.Portal>\n      <Popover.Content\n        side={side}\n        sticky='always'\n        hideWhenDetached\n        // Rename focuses its input; other popovers keep focus where it was.\n        onOpenAutoFocus={isRename ? undefined : (event) => event.preventDefault()}\n        onInteractOutside={handleInteractOutside}\n        onEscapeKeyDown={handleInteractOutside}\n        // Reuse the dialog's enter/exit motion so the rename popover does not flicker on open.\n        classNames={\n          isRename\n            ? ['data-[state=open]:animate-slide-up-and-fade', 'data-[state=closed]:animate-slide-down-and-fade']\n            : undefined\n        }\n      >\n        <Popover.Viewport>\n          {isComponentPopover && content && 'component' in content ? (\n            /* Base popover: a plugin-provided component (e.g. editor link preview). */\n            <Surface.Surface type={AppSurface.Popover} data={content} limit={1} />\n          ) : (\n            /*\n             * Card popover (default). Rendered for any open popover that isn't an explicit\n             * base-component popover so the popover can never collapse to a bare 1px frame: the\n             * header (icon + title + menu) always renders, and the body falls back to a fixed-\n             * height \"no preview\" row when no subject resolves a card Surface (e.g. system-type\n             * objects like a raw Feed that have no registered card and no renderable fields).\n             */\n            <Menu.Root>\n              <Card.Root border={false} classNames='dx-card-popover'>\n                <Card.Header>\n                  <Card.Block>{icon && <Icon icon={icon} />}</Card.Block>\n                  <Card.Title>{title}</Card.Title>\n                  {/* TODO(wittjosiah): Reconcile with Card.Menu. */}\n                  <Card.Block end>\n                    <Menu.Trigger asChild disabled={!objectMenuItems.length}>\n                      <IconButton\n                        variant='ghost'\n                        density='sm'\n                        icon='ph--dots-three-vertical--regular'\n                        iconOnly\n                        label='Actions'\n                      />\n                    </Menu.Trigger>\n                    <Menu.Content items={objectMenuItems} />\n                  </Card.Block>\n                </Card.Header>\n\n                {content && 'subject' in content ? (\n                  <Surface.Surface type={AppSurface.CardContent} data={content} limit={1} />\n                ) : (\n                  <Card.Body classNames='min-bs-8'>\n                    <Card.Row>\n                      <Card.Text variant='description'>{t('popover-no-preview.message')}</Card.Text>\n                    </Card.Row>\n                  </Card.Body>\n                )}\n              </Card.Root>\n            </Menu.Root>\n          )}\n        </Popover.Viewport>\n        <Popover.Arrow />\n      </Popover.Content>\n    </Popover.Portal>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport React, { useState } from 'react';\n\nimport { type LayoutOperation } from '@dxos/app-toolkit';\nimport { Button, Toast as NaturalToast, type ToastRootProps, toLocalizedString, useTranslation } from '@dxos/react-ui';\n\nimport { meta } from '#meta';\n\n// TODO(wittjosiah): Render remaining duration as a progress bar within the toast.\nexport const Toast = ({\n  id,\n  title,\n  description,\n  icon,\n  duration,\n  actionLabel,\n  actionAlt,\n  onAction,\n  onOpenChange,\n}: LayoutOperation.Toast & Pick<ToastRootProps, 'onOpenChange'>) => {\n  const { t } = useTranslation(meta.profile.key);\n\n  // Control the open state so closing flips Radix's `open` (playing the exit animation) rather than\n  // unmounting abruptly. Both the close button and Radix's own timeout/swipe route through here.\n  const [open, setOpen] = useState(true);\n  const handleOpenChange = (next: boolean) => {\n    setOpen(next);\n    onOpenChange?.(next);\n  };\n\n  return (\n    <NaturalToast.Root data-testid={id} open={open} duration={duration} onOpenChange={handleOpenChange}>\n      <NaturalToast.Title icon={icon} onClose={() => handleOpenChange(false)}>\n        {title && <span>{toLocalizedString(title, t)}</span>}\n      </NaturalToast.Title>\n      {description && <NaturalToast.Description>{toLocalizedString(description, t)}</NaturalToast.Description>}\n      {onAction && actionAlt && actionLabel && (\n        <NaturalToast.Actions>\n          <NaturalToast.Action altText={toLocalizedString(actionAlt, t)} asChild>\n            <Button data-testid='toast.action' variant='primary' onClick={() => onAction?.()}>\n              {toLocalizedString(actionLabel, t)}\n            </Button>\n          </NaturalToast.Action>\n        </NaturalToast.Actions>\n      )}\n    </NaturalToast.Root>\n  );\n};\n\nexport type ToasterProps = {\n  toasts?: LayoutOperation.Toast[];\n  onDismissToast?: (id: string) => void;\n};\n\nexport const Toaster = ({ toasts, onDismissToast }: ToasterProps) => {\n  return (\n    <>\n      {toasts?.map((toast) => (\n        <Toast\n          {...toast}\n          key={toast.id}\n          onOpenChange={(open: boolean) => {\n            if (!open) {\n              onDismissToast?.(toast.id);\n            }\n\n            return open;\n          }}\n        />\n      ))}\n    </>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nexport const NAV_ID = 'NavTree';\n\nexport const SURFACE_PREFIX = 'surface:';\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { DeckLayout } from './DeckLayout';\n\nexport { NAV_ID } from './constants';\n\nexport default DeckLayout;\n"],
+  "mappings": "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",
+  "names": ["React", "useCallback", "useAtomCapability", "useOperationInvoker", "usePluginManager", "LayoutOperation", "Mosaic", "useDeckState", "DeckCapabilities", "getMode", "React", "Surface", "AppSurface", "useAppGraph", "useNode", "useAttended", "useNodeActionExpander", "ActiveNode", "id", "graph", "activeNode", "div", "className", "type", "DocumentTitle", "data", "subject", "limit", "React", "useCallback", "Surface", "AppSurface", "AlertDialog", "Dialog", "NaturalDialog", "useDeckState", "Dialog", "state", "updateEphemeral", "useDeckState", "dialogOpen", "dialogType", "dialogBlockAlign", "dialogOverlayClasses", "dialogOverlayStyle", "dialogContent", "Root", "AlertDialog", "NaturalDialog", "Overlay", "handleOpenChange", "useCallback", "nextOpen", "s", "React", "modal", "open", "onOpenChange", "Surface", "type", "AppSurface", "data", "undefined", "limit", "fallback", "PlankErrorFallback", "placeholder", "div", "blockAlign", "classNames", "style", "createContext", "React", "useCallback", "useEffect", "useRef", "useState", "Surface", "AppSurface", "useObjectMenuItems", "Obj", "Card", "Icon", "IconButton", "Popover", "toLocalizedString", "useMediaQuery", "useTranslation", "Menu", "useDeckState", "meta", "DEBOUNCE_DELAY", "DeckPopoverProvider", "useDeckPopoverContext", "PopoverRoot", "children", "state", "virtualRef", "virtualIter", "setVirtualIter", "open", "setOpen", "debounceRef", "popoverOpen", "current", "clearTimeout", "popoverAnchor", "iter", "setTimeout", "popoverAnchorId", "popoverContent", "modal", "popoverKind", "Root", "VirtualTrigger", "key", "PopoverContent", "t", "profile", "updateEphemeral", "popoverSubject", "subject", "undefined", "isObjectPopover", "isObject", "objectMenuItems", "title", "popoverTitle", "icon", "getIcon", "content", "isComponentPopover", "isRename", "isLg", "fallback", "side", "popoverSide", "handleClose", "handleInteractOutside", "event", "type", "preventDefault", "Portal", "Content", "sticky", "hideWhenDetached", "onOpenAutoFocus", "onInteractOutside", "onEscapeKeyDown", "classNames", "Viewport", "data", "limit", "border", "Header", "Block", "Title", "end", "Trigger", "asChild", "disabled", "length", "variant", "density", "iconOnly", "label", "items", "CardContent", "Body", "Row", "Text", "Arrow", "React", "useState", "Button", "Toast", "NaturalToast", "toLocalizedString", "useTranslation", "meta", "id", "title", "description", "icon", "duration", "actionLabel", "actionAlt", "onAction", "onOpenChange", "t", "profile", "key", "open", "setOpen", "handleOpenChange", "next", "Root", "data-testid", "Title", "onClose", "span", "Description", "Actions", "Action", "altText", "asChild", "variant", "onClick", "Toaster", "toasts", "onDismissToast", "map", "toast", "DeckLayout", "onDismissToast", "settings", "useAtomCapability", "DeckCapabilities", "Settings", "pluginManager", "usePluginManager", "invokePromise", "useOperationInvoker", "deck", "state", "updateState", "useDeckState", "layoutMode", "getMode", "toasts", "handleLayoutChange", "useCallback", "request", "LayoutOperation", "SetLayoutMode", "React", "Mosaic", "Root", "PopoverRoot", "ActiveNode", "Deck", "onLayoutChange", "Content", "Viewport", "solo", "SoloMode", "active", "length", "ContentEmpty", "MultiMode", "PopoverContent", "Dialog", "Toaster", "NAV_ID", "DeckLayout"]
+}

package/dist/lib/neutral/DeckPlugin.mjs

@@ -4,14 +4,13 @@ import "./chunk-J5LGTIGS.mjs";
 import { setAutoFreeze } from "immer";
 import { ActivationEvent, ActivationEvents, Plugin } from "@dxos/app-framework";
 import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
-import { translations as stackTranslations } from "@dxos/react-ui-stack/translations";
 import { AppGraphBuilder, CheckAppScheme, DeckSettings, DeckState, NotificationTracker, OperationHandler, ReactRoot, ReactSurface, UrlHandler } from "#capabilities";
 import { meta } from "#meta";
 import { translations } from "#translations";
 import { DeckEvents } from "#types";
 
-// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-deck/PLUGIN.mdl?raw
-var PLUGIN_default = "---\nid: org.dxos.plugin.deck\nname: DeckPlugin\nversion: 0.1.0\n---\n\nThe Deck plugin is the core layout engine for DXOS Composer. It manages the multi-plank workspace\n(\"deck\"), the sidebar, the complementary sidebar, dialogs, popovers, and toast notifications.\nIt owns the persisted and ephemeral layout state, handles URL routing, and implements every\n`LayoutOperation` that changes what is visible on screen.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype LayoutMode\n  literals: multi | solo | solo--fullscreen\n```\n\n```mdl\ntype PartAdjustment\n  literals: close | companion | solo | solo--fullscreen | increment-start | increment-end\n```\n\n```mdl\ntype DeckState\n  fields:\n    initialized: boolean          # false until the deck has left solo mode for the first time\n    active: string[]              # item IDs of planks displayed in multi mode\n    inactive: string[]            # item IDs that have been closed; persisted for reopening\n    solo?: string                 # item ID of the single plank in solo or fullscreen mode\n    fullscreen: boolean           # true when the solo plank is displayed without any chrome\n    plankSizing: Record<string, number>   # persisted plank widths in rem, keyed by item ID\n    companionOpen: boolean        # whether the companion pane is visible\n    companionVariant?: string     # which companion variant to display\n    companionFrameSizing: Record<string, number>  # companion frame widths in rem\n```\n\n```mdl\ntype StoredDeckState\n  desc: Persisted plugin state stored in KVS/localStorage.\n  fields:\n    sidebarState: closed | collapsed | expanded\n    complementarySidebarState: closed | collapsed | expanded\n    complementarySidebarPanel?: string\n    activeDeck: string\n    previousDeck: string\n    decks: Record<string, DeckState>\n    previousMode: Record<string, LayoutMode>\n```\n\n```mdl\ntype EphemeralDeckState\n  desc: Transient plugin state that is NOT persisted across sessions.\n  fields:\n    dialogOpen: boolean\n    dialogType?: default | alert\n    dialogBlockAlign?: start | center | end\n    dialogContent?: { component: string; props?: any }\n    popoverOpen: boolean\n    popoverSide?: top | right | bottom | left\n    popoverKind?: base | card\n    popoverTitle?: string\n    popoverContentRef?: string\n    popoverContent?: { component: string } | { subject: any }\n    toasts: Toast[]\n    currentUndoId?: string\n    scrollIntoView?: string\n```\n\n```mdl\ntype DeckSettings\n  fields:\n    enableDeck?: boolean          # display multiple panels side by side\n    encapsulatedPlanks?: boolean  # render each plank in an isolated container\n    showHints?: boolean           # show keyboard shortcut hints in the UI\n    enableNativeRedirect?: boolean  # redirect supported URLs to the native desktop app\n```\n\n## Components\n\n```mdl\ncomponent Matrix\n  desc: |\n    The primary workspace canvas. Renders the active planks side by side in multi mode,\n    or a single plank in solo/fullscreen mode. Manages plank-resize handles and the\n    companion pane alongside each plank.\n  props:\n    state: StoredDeckState        # persisted layout state atom\n    ephemeral: EphemeralDeckState # transient state atom\n  state:\n    mode: LayoutMode              # current layout mode derived from state\n  actions:\n    openPlank(id: string)\n    closePlank(id: string)\n    adjustPlank(id: string, type: PartAdjustment)\n    resizePlank(id: string, size: number)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502  sidebar   \u2502  plank A   \u2502  plank B   \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u2502  [content] \u2502  [content] \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524            \u2502\n    \u2502            \u2502 companion  \u2502            \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent DeckSettings\n  desc: Settings panel rendered in the Composer settings surface.\n  props:\n    settings: DeckSettings\n  actions:\n    updateSetting(key: string, value: any)\n```\n\n## Operations\n\n```mdl\nop Open\n  desc: |\n    Opens one or more subjects (item IDs or navigation paths) in the deck.\n    In multi mode uses stack semantics: truncates after the pivot then appends.\n    In solo or uninitialised mode, replaces the current subject entirely.\n    Validates each target against the app graph and redirects to a 404 node if not found.\n    Fires ScrollIntoView, Expose, and an observability event for each newly opened item.\n  input:\n    subject: string[]             # item IDs or navigation paths to open\n    pivotId?: string              # truncate deck after this item before appending\n    key?: string                  # replace an existing plank whose ID shares this key prefix\n    workspace?: string            # switch to this workspace before opening\n    navigation?: immediate        # skip validation; expand path only\n    scrollIntoView?: boolean      # default true; set false to suppress auto-scroll\n    state?: any\n    variant?: string\n  output: string[]\n  effects: [echo:read, layout:state]\n  requires: [AppGraph, AttentionCapabilities, ClientCapabilities, DeckCapabilities]\n```\n\n```mdl\nop Close\n  desc: |\n    Removes one or more subjects from the active deck.\n    Computes which plank (if any) should receive attention after removal and\n    schedules ScrollIntoView for it.\n  input:\n    subject: string[]\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities, AttentionCapabilities]\n```\n\n```mdl\nop SetLayoutMode\n  desc: |\n    Transitions to a new layout mode (multi, solo, solo--fullscreen) or reverts\n    to the previously recorded mode. Persists the previous mode so it can be\n    restored later. Toggling solo--fullscreen flips the fullscreen flag rather\n    than unconditionally setting it.\n  input:\n    mode?: LayoutMode             # target mode; omit if reverting\n    subject?: string              # item to solo; used only for solo / solo--fullscreen\n    revert?: boolean              # revert to the previously persisted mode\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateSidebar\n  desc: Update the sidebar visibility state (closed / collapsed / expanded).\n  input:\n    state?: closed | collapsed | expanded\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateComplementary\n  desc: Update the complementary-sidebar visibility state and optional panel selection.\n  input:\n    state?: closed | collapsed | expanded\n    panel?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateDialog\n  desc: |\n    Show or hide the global dialog overlay. Accepts a surface component identifier\n    or a boolean state flag. Propagates to EphemeralDeckState.\n  input:\n    subject?: string              # surface component identifier to display\n    props?: any                   # props forwarded to the dialog surface\n    state?: boolean               # false to close the dialog\n    type?: default | alert\n    blockAlign?: start | center | end\n    overlayClasses?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePopover\n  desc: |\n    Show or hide the global popover. Accepts anchor, content reference, or\n    an explicit subject reference.\n  input:\n    subject?: any                 # subject reference to pass to the popover surface\n    contentRef?: string           # surface component identifier for popover content\n    anchorId?: string             # DOM element ID for positioning the popover anchor\n    side?: top | right | bottom | left\n    kind?: base | card\n    title?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateCompanion\n  desc: Update the companion-pane open state and active variant.\n  input:\n    open?: boolean\n    variant?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AdjustPlank\n  desc: Apply a PartAdjustment to a specific plank (close, solo, move, companion).\n  input:\n    id: string\n    type: PartAdjustment\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePlankSize\n  desc: Persist the width of a plank in rem.\n  input:\n    id: string\n    size: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AddToast\n  desc: Push a toast notification into the ephemeral queue.\n  input:\n    title?: string\n    body?: string\n    duration?: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop ScrollIntoView\n  desc: Schedule a subject to be scrolled into view when its plank mounts.\n  input:\n    subject: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop SwitchWorkspace\n  desc: Switch the active workspace deck, persisting the previous workspace ID.\n  input:\n    subject: string               # workspace ID to switch to\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop RevertWorkspace\n  desc: Revert to the previously active workspace.\n  input: void\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n## Features\n\n```mdl\nfeat F-1: Multi-Plank Layout (Deck)\n\n  req F-1.1:\n    when: enableDeck setting is true\n    then: deck renders active planks side by side in a scrollable row\n\n  req F-1.2:\n    when: user opens a new subject with a pivot\n    then: deck is truncated after the pivot and the new subject is appended\n\n  req F-1.3:\n    when: subject is already present in the active deck\n    then: deck is unchanged and the existing plank scrolls into view\n\n  req F-1.4:\n    when: user resizes a plank\n    then: new width is persisted in plankSizing and restored on next load\n```\n\n```mdl\nfeat F-2: Solo / Fullscreen Mode\n\n  req F-2.1:\n    when: user triggers SetLayoutMode with mode=solo\n    then: only the targeted plank is visible; other planks move to inactive\n\n  req F-2.2:\n    when: user triggers SetLayoutMode with mode=solo--fullscreen\n    then: plank fills the viewport; sidebar and heading chrome are hidden\n\n  req F-2.3:\n    when: user triggers SetLayoutMode with revert=true\n    then: layout returns to the previously persisted mode\n```\n\n```mdl\nfeat F-3: Sidebar & Complementary Sidebar\n\n  req F-3.1:\n    when: UpdateSidebar is dispatched with a new state\n    then: sidebar transitions between closed / collapsed / expanded and state is persisted\n\n  req F-3.2:\n    when: UpdateComplementary is dispatched with a panel\n    then: complementary sidebar opens to the specified panel\n```\n\n```mdl\nfeat F-4: Dialog & Popover Overlay\n\n  req F-4.1:\n    when: UpdateDialog is dispatched with a subject component\n    then: the matching surface is rendered inside the global dialog overlay\n\n  req F-4.2:\n    when: UpdatePopover is dispatched with an anchorId\n    then: popover is positioned relative to that DOM element\n\n  req F-4.3:\n    when: dialog or popover state is set to false\n    then: overlay is closed and content is unmounted\n```\n\n```mdl\nfeat F-5: URL Navigation & Deep Linking\n\n  req F-5.1:\n    when: app loads with a URL referencing an item\n    then: DeckPlugin resolves the path and opens the item in the deck\n\n  req F-5.2:\n    when: active deck changes\n    then: browser URL is updated to reflect the current plank state\n\n  req F-5.3:\n    when: a navigation target is not found in the app graph\n    then: Open operation redirects to a 404 node\n```\n\n```mdl\nfeat F-6: Toast Notifications\n\n  req F-6.1:\n    when: AddToast is dispatched\n    then: a toast is appended to the queue and displayed for its configured duration\n\n  req F-6.2:\n    when: ShowUndo is dispatched\n    then: a toast with an undo action is shown; invoking it executes the linked undo operation\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Open subject in multi mode\n  given: deck is in multi mode with planks A and B active\n  when: Open({ subject: ['C'] }) is dispatched\n  then:\n    - plank C is appended to the right of plank B\n    - browser URL reflects the new deck state\n    - plank C is scrolled into view\n```\n\n```mdl\ntest T-2: Open with pivot truncation\n  given: deck has planks [A, B, C] active\n  when: Open({ subject: ['D'], pivotId: 'A' }) is dispatched\n  then:\n    - active deck becomes [A, D]\n    - planks B and C are moved to inactive\n```\n\n```mdl\ntest T-3: Open already-visible subject\n  given: deck has plank A active\n  when: Open({ subject: ['A'] }) is dispatched\n  then:\n    - active deck is unchanged\n    - plank A scrolls into view\n```\n\n```mdl\ntest T-4: Solo mode\n  given: deck is in multi mode\n  when: SetLayoutMode({ mode: 'solo', subject: 'A' }) is dispatched\n  then:\n    - only plank A is visible\n    - mode is stored as solo in StoredDeckState\n    - previousMode records 'multi' for the active deck\n```\n\n```mdl\ntest T-5: Revert from solo to multi\n  given: layout mode is solo, previousMode is multi\n  when: SetLayoutMode({ revert: true }) is dispatched\n  then:\n    - deck returns to multi mode\n    - previously inactive planks are restored\n```\n\n```mdl\ntest T-6: Close plank\n  given: deck has planks [A, B, C] active; B has attention\n  when: Close({ subject: ['B'] }) is dispatched\n  then:\n    - active deck becomes [A, C]\n    - attention moves to an adjacent plank\n    - ScrollIntoView is scheduled for the newly attended plank\n```\n\n```mdl\ntest T-7: Toast is shown and dismissed\n  given: no toasts are in the queue\n  when: AddToast({ title: 'Saved', duration: 3000 }) is dispatched\n  then:\n    - toast appears in the UI\n    - toast is removed after 3 seconds\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n";
+// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-deck/PLUGIN.mdl
+var PLUGIN_default = "---\nid: org.dxos.plugin.deck\nname: DeckPlugin\nversion: 0.1.0\n---\n\nThe Deck plugin is the core layout engine for DXOS Composer. It manages the multi-plank workspace\n(\"deck\"), the sidebar, the complementary sidebar, dialogs, popovers, and toast notifications.\nIt owns the persisted and ephemeral layout state, handles URL routing, and implements every\n`LayoutOperation` that changes what is visible on screen.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype LayoutMode\n  literals: multi | solo | solo--fullscreen\n```\n\n```mdl\ntype PartAdjustment\n  literals: close | companion | solo | solo--fullscreen | increment-start | increment-end\n```\n\n```mdl\ntype DeckState\n  fields:\n    initialized: boolean          # false until the deck has left solo mode for the first time\n    active: string[]              # item IDs of planks displayed in multi mode\n    inactive: string[]            # item IDs that have been closed; persisted for reopening\n    solo?: string                 # item ID of the single plank in solo or fullscreen mode\n    fullscreen: boolean           # true when the solo plank is displayed without any chrome\n    plankSizing: Record<string, number>   # persisted plank widths in rem, keyed by item ID\n    companionOpen: boolean        # whether the companion pane is visible\n    companionOrientation?: 'horizontal' | 'vertical'   # companion splitter orientation (side-by-side / stacked)\n    companionFrameSizing: Record<string, number>  # companion frame widths in rem\n    # NOTE: the selected companion variant and per-orientation split size now live in react-ui-attention\n    # view state (global, localStorage), not on DeckState \u2014 see util/companion-view-state.ts.\n```\n\n```mdl\ntype StoredDeckState\n  desc: Persisted plugin state stored in KVS/localStorage.\n  fields:\n    sidebarState: closed | collapsed | expanded\n    complementarySidebarState: closed | collapsed | expanded\n    complementarySidebarPanel?: string\n    activeDeck: string\n    previousDeck: string\n    decks: Record<string, DeckState>\n    previousMode: Record<string, LayoutMode>\n```\n\n```mdl\ntype EphemeralDeckState\n  desc: Transient plugin state that is NOT persisted across sessions.\n  fields:\n    dialogOpen: boolean\n    dialogType?: default | alert\n    dialogBlockAlign?: start | center | end\n    dialogContent?: { component: string; props?: any }\n    popoverOpen: boolean\n    popoverSide?: top | right | bottom | left\n    popoverKind?: base | card\n    popoverTitle?: string\n    popoverContentRef?: string\n    popoverContent?: { component: string } | { subject: any }\n    toasts: Toast[]\n    currentUndoId?: string\n    scrollIntoView?: string\n```\n\n```mdl\ntype DeckSettings\n  fields:\n    enableDeck?: boolean          # display multiple panels side by side\n    encapsulatedPlanks?: boolean  # render each plank in an isolated container\n    showHints?: boolean           # show keyboard shortcut hints in the UI\n    enableNativeRedirect?: boolean  # redirect supported URLs to the native desktop app\n```\n\n## Components\n\n```mdl\ncomponent Matrix\n  desc: |\n    The primary workspace canvas. Renders the active planks side by side in multi mode,\n    or a single plank in solo/fullscreen mode. Manages plank-resize handles and the\n    companion pane alongside each plank.\n  props:\n    state: StoredDeckState        # persisted layout state atom\n    ephemeral: EphemeralDeckState # transient state atom\n  state:\n    mode: LayoutMode              # current layout mode derived from state\n  actions:\n    openPlank(id: string)\n    closePlank(id: string)\n    adjustPlank(id: string, type: PartAdjustment)\n    resizePlank(id: string, size: number)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502  sidebar   \u2502  plank A   \u2502  plank B   \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u2502  [content] \u2502  [content] \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524            \u2502\n    \u2502            \u2502 companion  \u2502            \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent DeckSettings\n  desc: Settings panel rendered in the Composer settings surface.\n  props:\n    settings: DeckSettings\n  actions:\n    updateSetting(key: string, value: any)\n```\n\n## Operations\n\n```mdl\nop Open\n  desc: |\n    Opens one or more subjects (item IDs or navigation paths) in the deck.\n    In multi mode uses stack semantics: truncates after the pivot then appends.\n    In solo or uninitialised mode, replaces the current subject entirely.\n    Validates each target against the app graph and redirects to a 404 node if not found.\n    Fires ScrollIntoView, Expose, and an observability event for each newly opened item.\n  input:\n    subject: string[]             # item IDs or navigation paths to open\n    pivotId?: string              # truncate deck after this item before appending\n    key?: string                  # replace an existing plank whose ID shares this key prefix\n    workspace?: string            # switch to this workspace before opening\n    navigation?: immediate        # skip validation; expand path only\n    scrollIntoView?: boolean      # default true; set false to suppress auto-scroll\n    state?: any\n    variant?: string\n  output: string[]\n  effects: [echo:read, layout:state]\n  requires: [AppGraph, AttentionCapabilities, ClientCapabilities, DeckCapabilities]\n```\n\n```mdl\nop Close\n  desc: |\n    Removes one or more subjects from the active deck.\n    Computes which plank (if any) should receive attention after removal and\n    schedules ScrollIntoView for it.\n  input:\n    subject: string[]\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities, AttentionCapabilities]\n```\n\n```mdl\nop SetLayoutMode\n  desc: |\n    Transitions to a new layout mode (multi, solo, solo--fullscreen) or reverts\n    to the previously recorded mode. Persists the previous mode so it can be\n    restored later. Toggling solo--fullscreen flips the fullscreen flag rather\n    than unconditionally setting it.\n  input:\n    mode?: LayoutMode             # target mode; omit if reverting\n    subject?: string              # item to solo; used only for solo / solo--fullscreen\n    revert?: boolean              # revert to the previously persisted mode\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateSidebar\n  desc: Update the sidebar visibility state (closed / collapsed / expanded).\n  input:\n    state?: closed | collapsed | expanded\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateComplementary\n  desc: Update the complementary-sidebar visibility state and optional panel selection.\n  input:\n    state?: closed | collapsed | expanded\n    panel?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateDialog\n  desc: |\n    Show or hide the global dialog overlay. Accepts a surface component identifier\n    or a boolean state flag. Propagates to EphemeralDeckState.\n  input:\n    subject?: string              # surface component identifier to display\n    props?: any                   # props forwarded to the dialog surface\n    state?: boolean               # false to close the dialog\n    type?: default | alert\n    blockAlign?: start | center | end\n    overlayClasses?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePopover\n  desc: |\n    Show or hide the global popover. Accepts anchor, content reference, or\n    an explicit subject reference.\n  input:\n    subject?: any                 # subject reference to pass to the popover surface\n    contentRef?: string           # surface component identifier for popover content\n    anchorId?: string             # DOM element ID for positioning the popover anchor\n    side?: top | right | bottom | left\n    kind?: base | card\n    title?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateCompanion\n  desc: Update the companion-pane open state and active variant.\n  input:\n    open?: boolean\n    variant?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AdjustPlank\n  desc: Apply a PartAdjustment to a specific plank (close, solo, move, companion).\n  input:\n    id: string\n    type: PartAdjustment\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePlankSize\n  desc: Persist the width of a plank in rem.\n  input:\n    id: string\n    size: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AddToast\n  desc: Push a toast notification into the ephemeral queue.\n  input:\n    title?: string\n    body?: string\n    duration?: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop ScrollIntoView\n  desc: Schedule a subject to be scrolled into view when its plank mounts.\n  input:\n    subject: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop SwitchWorkspace\n  desc: Switch the active workspace deck, persisting the previous workspace ID.\n  input:\n    subject: string               # workspace ID to switch to\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop RevertWorkspace\n  desc: Revert to the previously active workspace.\n  input: void\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n## Features\n\n```mdl\nfeat F-1: Multi-Plank Layout (Deck)\n\n  req F-1.1:\n    when: enableDeck setting is true\n    then: deck renders active planks side by side in a scrollable row\n\n  req F-1.2:\n    when: user opens a new subject with a pivot\n    then: deck is truncated after the pivot and the new subject is appended\n\n  req F-1.3:\n    when: subject is already present in the active deck\n    then: deck is unchanged and the existing plank scrolls into view\n\n  req F-1.4:\n    when: user resizes a plank\n    then: new width is persisted in plankSizing and restored on next load\n```\n\n```mdl\nfeat F-2: Solo / Fullscreen Mode\n\n  req F-2.1:\n    when: user triggers SetLayoutMode with mode=solo\n    then: only the targeted plank is visible; other planks move to inactive\n\n  req F-2.2:\n    when: user triggers SetLayoutMode with mode=solo--fullscreen\n    then: plank fills the viewport; sidebar and heading chrome are hidden\n\n  req F-2.3:\n    when: user triggers SetLayoutMode with revert=true\n    then: layout returns to the previously persisted mode\n```\n\n```mdl\nfeat F-3: Sidebar & Complementary Sidebar\n\n  req F-3.1:\n    when: UpdateSidebar is dispatched with a new state\n    then: sidebar transitions between closed / collapsed / expanded and state is persisted\n\n  req F-3.2:\n    when: UpdateComplementary is dispatched with a panel\n    then: complementary sidebar opens to the specified panel\n```\n\n```mdl\nfeat F-4: Dialog & Popover Overlay\n\n  req F-4.1:\n    when: UpdateDialog is dispatched with a subject component\n    then: the matching surface is rendered inside the global dialog overlay\n\n  req F-4.2:\n    when: UpdatePopover is dispatched with an anchorId\n    then: popover is positioned relative to that DOM element\n\n  req F-4.3:\n    when: dialog or popover state is set to false\n    then: overlay is closed and content is unmounted\n```\n\n```mdl\nfeat F-5: URL Navigation & Deep Linking\n\n  req F-5.1:\n    when: app loads with a URL referencing an item\n    then: DeckPlugin resolves the path and opens the item in the deck\n\n  req F-5.2:\n    when: active deck changes\n    then: browser URL is updated to reflect the current plank state\n\n  req F-5.3:\n    when: a navigation target is not found in the app graph\n    then: Open operation redirects to a 404 node\n```\n\n```mdl\nfeat F-6: Toast Notifications\n\n  req F-6.1:\n    when: AddToast is dispatched\n    then: a toast is appended to the queue and displayed for its configured duration\n\n  req F-6.2:\n    when: ShowUndo is dispatched\n    then: a toast with an undo action is shown; invoking it executes the linked undo operation\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Open subject in multi mode\n  given: deck is in multi mode with planks A and B active\n  when: Open({ subject: ['C'] }) is dispatched\n  then:\n    - plank C is appended to the right of plank B\n    - browser URL reflects the new deck state\n    - plank C is scrolled into view\n```\n\n```mdl\ntest T-2: Open with pivot truncation\n  given: deck has planks [A, B, C] active\n  when: Open({ subject: ['D'], pivotId: 'A' }) is dispatched\n  then:\n    - active deck becomes [A, D]\n    - planks B and C are moved to inactive\n```\n\n```mdl\ntest T-3: Open already-visible subject\n  given: deck has plank A active\n  when: Open({ subject: ['A'] }) is dispatched\n  then:\n    - active deck is unchanged\n    - plank A scrolls into view\n```\n\n```mdl\ntest T-4: Solo mode\n  given: deck is in multi mode\n  when: SetLayoutMode({ mode: 'solo', subject: 'A' }) is dispatched\n  then:\n    - only plank A is visible\n    - mode is stored as solo in StoredDeckState\n    - previousMode records 'multi' for the active deck\n```\n\n```mdl\ntest T-5: Revert from solo to multi\n  given: layout mode is solo, previousMode is multi\n  when: SetLayoutMode({ revert: true }) is dispatched\n  then:\n    - deck returns to multi mode\n    - previously inactive planks are restored\n```\n\n```mdl\ntest T-6: Close plank\n  given: deck has planks [A, B, C] active; B has attention\n  when: Close({ subject: ['B'] }) is dispatched\n  then:\n    - active deck becomes [A, C]\n    - attention moves to an adjacent plank\n    - ScrollIntoView is scheduled for the newly attended plank\n```\n\n```mdl\ntest T-7: Toast is shown and dismissed\n  given: no toasts are in the queue\n  when: AddToast({ title: 'Saved', duration: 3000 }) is dispatched\n  then:\n    - toast appears in the UI\n    - toast is removed after 3 seconds\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n";
 
 // src/DeckPlugin.ts
 setAutoFreeze(false);
@@ -26,10 +25,7 @@ var DeckPlugin = Plugin.define(meta).pipe(
     activate: ReactSurface
   }),
   AppPlugin.addTranslationsModule({
-    translations: [
-      ...translations,
-      ...stackTranslations
-    ]
+    translations
   }),
   Plugin.addModule({
     activatesOn: AppActivationEvents.SetupSettings,
@@ -71,7 +67,7 @@ var DeckPlugin = Plugin.define(meta).pipe(
   }),
   AppPlugin.addPluginAssetModule({
     asset: {
-      pluginId: meta.id,
+      pluginId: meta.profile.key,
       path: "PLUGIN.mdl",
       content: PLUGIN_default,
       mimeType: "application/x-mdl"

package/dist/lib/neutral/DeckPlugin.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/DeckPlugin.ts", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-deck/PLUGIN.mdl?raw"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { setAutoFreeze } from 'immer';\n\nimport { ActivationEvent, ActivationEvents, Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\nimport { translations as stackTranslations } from '@dxos/react-ui-stack/translations';\n\nimport {\n  AppGraphBuilder,\n  CheckAppScheme,\n  DeckSettings,\n  DeckState,\n  NotificationTracker,\n  OperationHandler,\n  ReactRoot,\n  ReactSurface,\n  UrlHandler,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { DeckEvents } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\n// NOTE(Zan): When producing values with immer, we shouldn't auto-freeze them because\n//   our signal implementation needs to add some hidden properties to the produced values.\n// TODO(Zan): Move this to a more global location if we use immer more broadly.\nsetAutoFreeze(false);\n\nexport const DeckPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations: [...translations, ...stackTranslations] }),\n  Plugin.addModule({\n    activatesOn: AppActivationEvents.SetupSettings,\n    firesAfterActivation: [DeckEvents.SettingsReady],\n    activate: DeckSettings,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(DeckEvents.SettingsReady, ActivationEvents.ProcessManagerReady),\n    activate: CheckAppScheme,\n  }),\n  Plugin.addModule({\n    // TODO(wittjosiah): Does not integrate with settings store.\n    //   Should this be a different event?\n    //   Should settings store be renamed to be more generic?\n    activatesOn: ActivationEvent.oneOf(AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph),\n    firesAfterActivation: [AppActivationEvents.LayoutReady, DeckEvents.StateReady],\n    activate: DeckState,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvents.Startup,\n    activate: ReactRoot,\n  }),\n  // Plugin.addModule({\n  //   activatesOn: Events.SetupArtifactDefinition,\n  //   activate: Tools,\n  // }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, DeckEvents.StateReady),\n    activate: UrlHandler,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, DeckEvents.StateReady),\n    activate: NotificationTracker,\n  }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.id, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default DeckPlugin;\n", "---\nid: org.dxos.plugin.deck\nname: DeckPlugin\nversion: 0.1.0\n---\n\nThe Deck plugin is the core layout engine for DXOS Composer. It manages the multi-plank workspace\n(\"deck\"), the sidebar, the complementary sidebar, dialogs, popovers, and toast notifications.\nIt owns the persisted and ephemeral layout state, handles URL routing, and implements every\n`LayoutOperation` that changes what is visible on screen.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype LayoutMode\n  literals: multi | solo | solo--fullscreen\n```\n\n```mdl\ntype PartAdjustment\n  literals: close | companion | solo | solo--fullscreen | increment-start | increment-end\n```\n\n```mdl\ntype DeckState\n  fields:\n    initialized: boolean          # false until the deck has left solo mode for the first time\n    active: string[]              # item IDs of planks displayed in multi mode\n    inactive: string[]            # item IDs that have been closed; persisted for reopening\n    solo?: string                 # item ID of the single plank in solo or fullscreen mode\n    fullscreen: boolean           # true when the solo plank is displayed without any chrome\n    plankSizing: Record<string, number>   # persisted plank widths in rem, keyed by item ID\n    companionOpen: boolean        # whether the companion pane is visible\n    companionVariant?: string     # which companion variant to display\n    companionFrameSizing: Record<string, number>  # companion frame widths in rem\n```\n\n```mdl\ntype StoredDeckState\n  desc: Persisted plugin state stored in KVS/localStorage.\n  fields:\n    sidebarState: closed | collapsed | expanded\n    complementarySidebarState: closed | collapsed | expanded\n    complementarySidebarPanel?: string\n    activeDeck: string\n    previousDeck: string\n    decks: Record<string, DeckState>\n    previousMode: Record<string, LayoutMode>\n```\n\n```mdl\ntype EphemeralDeckState\n  desc: Transient plugin state that is NOT persisted across sessions.\n  fields:\n    dialogOpen: boolean\n    dialogType?: default | alert\n    dialogBlockAlign?: start | center | end\n    dialogContent?: { component: string; props?: any }\n    popoverOpen: boolean\n    popoverSide?: top | right | bottom | left\n    popoverKind?: base | card\n    popoverTitle?: string\n    popoverContentRef?: string\n    popoverContent?: { component: string } | { subject: any }\n    toasts: Toast[]\n    currentUndoId?: string\n    scrollIntoView?: string\n```\n\n```mdl\ntype DeckSettings\n  fields:\n    enableDeck?: boolean          # display multiple panels side by side\n    encapsulatedPlanks?: boolean  # render each plank in an isolated container\n    showHints?: boolean           # show keyboard shortcut hints in the UI\n    enableNativeRedirect?: boolean  # redirect supported URLs to the native desktop app\n```\n\n## Components\n\n```mdl\ncomponent Matrix\n  desc: |\n    The primary workspace canvas. Renders the active planks side by side in multi mode,\n    or a single plank in solo/fullscreen mode. Manages plank-resize handles and the\n    companion pane alongside each plank.\n  props:\n    state: StoredDeckState        # persisted layout state atom\n    ephemeral: EphemeralDeckState # transient state atom\n  state:\n    mode: LayoutMode              # current layout mode derived from state\n  actions:\n    openPlank(id: string)\n    closePlank(id: string)\n    adjustPlank(id: string, type: PartAdjustment)\n    resizePlank(id: string, size: number)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502  sidebar   \u2502  plank A   \u2502  plank B   \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u2502  [content] \u2502  [content] \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524            \u2502\n    \u2502            \u2502 companion  \u2502            \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent DeckSettings\n  desc: Settings panel rendered in the Composer settings surface.\n  props:\n    settings: DeckSettings\n  actions:\n    updateSetting(key: string, value: any)\n```\n\n## Operations\n\n```mdl\nop Open\n  desc: |\n    Opens one or more subjects (item IDs or navigation paths) in the deck.\n    In multi mode uses stack semantics: truncates after the pivot then appends.\n    In solo or uninitialised mode, replaces the current subject entirely.\n    Validates each target against the app graph and redirects to a 404 node if not found.\n    Fires ScrollIntoView, Expose, and an observability event for each newly opened item.\n  input:\n    subject: string[]             # item IDs or navigation paths to open\n    pivotId?: string              # truncate deck after this item before appending\n    key?: string                  # replace an existing plank whose ID shares this key prefix\n    workspace?: string            # switch to this workspace before opening\n    navigation?: immediate        # skip validation; expand path only\n    scrollIntoView?: boolean      # default true; set false to suppress auto-scroll\n    state?: any\n    variant?: string\n  output: string[]\n  effects: [echo:read, layout:state]\n  requires: [AppGraph, AttentionCapabilities, ClientCapabilities, DeckCapabilities]\n```\n\n```mdl\nop Close\n  desc: |\n    Removes one or more subjects from the active deck.\n    Computes which plank (if any) should receive attention after removal and\n    schedules ScrollIntoView for it.\n  input:\n    subject: string[]\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities, AttentionCapabilities]\n```\n\n```mdl\nop SetLayoutMode\n  desc: |\n    Transitions to a new layout mode (multi, solo, solo--fullscreen) or reverts\n    to the previously recorded mode. Persists the previous mode so it can be\n    restored later. Toggling solo--fullscreen flips the fullscreen flag rather\n    than unconditionally setting it.\n  input:\n    mode?: LayoutMode             # target mode; omit if reverting\n    subject?: string              # item to solo; used only for solo / solo--fullscreen\n    revert?: boolean              # revert to the previously persisted mode\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateSidebar\n  desc: Update the sidebar visibility state (closed / collapsed / expanded).\n  input:\n    state?: closed | collapsed | expanded\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateComplementary\n  desc: Update the complementary-sidebar visibility state and optional panel selection.\n  input:\n    state?: closed | collapsed | expanded\n    panel?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateDialog\n  desc: |\n    Show or hide the global dialog overlay. Accepts a surface component identifier\n    or a boolean state flag. Propagates to EphemeralDeckState.\n  input:\n    subject?: string              # surface component identifier to display\n    props?: any                   # props forwarded to the dialog surface\n    state?: boolean               # false to close the dialog\n    type?: default | alert\n    blockAlign?: start | center | end\n    overlayClasses?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePopover\n  desc: |\n    Show or hide the global popover. Accepts anchor, content reference, or\n    an explicit subject reference.\n  input:\n    subject?: any                 # subject reference to pass to the popover surface\n    contentRef?: string           # surface component identifier for popover content\n    anchorId?: string             # DOM element ID for positioning the popover anchor\n    side?: top | right | bottom | left\n    kind?: base | card\n    title?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateCompanion\n  desc: Update the companion-pane open state and active variant.\n  input:\n    open?: boolean\n    variant?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AdjustPlank\n  desc: Apply a PartAdjustment to a specific plank (close, solo, move, companion).\n  input:\n    id: string\n    type: PartAdjustment\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePlankSize\n  desc: Persist the width of a plank in rem.\n  input:\n    id: string\n    size: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AddToast\n  desc: Push a toast notification into the ephemeral queue.\n  input:\n    title?: string\n    body?: string\n    duration?: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop ScrollIntoView\n  desc: Schedule a subject to be scrolled into view when its plank mounts.\n  input:\n    subject: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop SwitchWorkspace\n  desc: Switch the active workspace deck, persisting the previous workspace ID.\n  input:\n    subject: string               # workspace ID to switch to\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop RevertWorkspace\n  desc: Revert to the previously active workspace.\n  input: void\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n## Features\n\n```mdl\nfeat F-1: Multi-Plank Layout (Deck)\n\n  req F-1.1:\n    when: enableDeck setting is true\n    then: deck renders active planks side by side in a scrollable row\n\n  req F-1.2:\n    when: user opens a new subject with a pivot\n    then: deck is truncated after the pivot and the new subject is appended\n\n  req F-1.3:\n    when: subject is already present in the active deck\n    then: deck is unchanged and the existing plank scrolls into view\n\n  req F-1.4:\n    when: user resizes a plank\n    then: new width is persisted in plankSizing and restored on next load\n```\n\n```mdl\nfeat F-2: Solo / Fullscreen Mode\n\n  req F-2.1:\n    when: user triggers SetLayoutMode with mode=solo\n    then: only the targeted plank is visible; other planks move to inactive\n\n  req F-2.2:\n    when: user triggers SetLayoutMode with mode=solo--fullscreen\n    then: plank fills the viewport; sidebar and heading chrome are hidden\n\n  req F-2.3:\n    when: user triggers SetLayoutMode with revert=true\n    then: layout returns to the previously persisted mode\n```\n\n```mdl\nfeat F-3: Sidebar & Complementary Sidebar\n\n  req F-3.1:\n    when: UpdateSidebar is dispatched with a new state\n    then: sidebar transitions between closed / collapsed / expanded and state is persisted\n\n  req F-3.2:\n    when: UpdateComplementary is dispatched with a panel\n    then: complementary sidebar opens to the specified panel\n```\n\n```mdl\nfeat F-4: Dialog & Popover Overlay\n\n  req F-4.1:\n    when: UpdateDialog is dispatched with a subject component\n    then: the matching surface is rendered inside the global dialog overlay\n\n  req F-4.2:\n    when: UpdatePopover is dispatched with an anchorId\n    then: popover is positioned relative to that DOM element\n\n  req F-4.3:\n    when: dialog or popover state is set to false\n    then: overlay is closed and content is unmounted\n```\n\n```mdl\nfeat F-5: URL Navigation & Deep Linking\n\n  req F-5.1:\n    when: app loads with a URL referencing an item\n    then: DeckPlugin resolves the path and opens the item in the deck\n\n  req F-5.2:\n    when: active deck changes\n    then: browser URL is updated to reflect the current plank state\n\n  req F-5.3:\n    when: a navigation target is not found in the app graph\n    then: Open operation redirects to a 404 node\n```\n\n```mdl\nfeat F-6: Toast Notifications\n\n  req F-6.1:\n    when: AddToast is dispatched\n    then: a toast is appended to the queue and displayed for its configured duration\n\n  req F-6.2:\n    when: ShowUndo is dispatched\n    then: a toast with an undo action is shown; invoking it executes the linked undo operation\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Open subject in multi mode\n  given: deck is in multi mode with planks A and B active\n  when: Open({ subject: ['C'] }) is dispatched\n  then:\n    - plank C is appended to the right of plank B\n    - browser URL reflects the new deck state\n    - plank C is scrolled into view\n```\n\n```mdl\ntest T-2: Open with pivot truncation\n  given: deck has planks [A, B, C] active\n  when: Open({ subject: ['D'], pivotId: 'A' }) is dispatched\n  then:\n    - active deck becomes [A, D]\n    - planks B and C are moved to inactive\n```\n\n```mdl\ntest T-3: Open already-visible subject\n  given: deck has plank A active\n  when: Open({ subject: ['A'] }) is dispatched\n  then:\n    - active deck is unchanged\n    - plank A scrolls into view\n```\n\n```mdl\ntest T-4: Solo mode\n  given: deck is in multi mode\n  when: SetLayoutMode({ mode: 'solo', subject: 'A' }) is dispatched\n  then:\n    - only plank A is visible\n    - mode is stored as solo in StoredDeckState\n    - previousMode records 'multi' for the active deck\n```\n\n```mdl\ntest T-5: Revert from solo to multi\n  given: layout mode is solo, previousMode is multi\n  when: SetLayoutMode({ revert: true }) is dispatched\n  then:\n    - deck returns to multi mode\n    - previously inactive planks are restored\n```\n\n```mdl\ntest T-6: Close plank\n  given: deck has planks [A, B, C] active; B has attention\n  when: Close({ subject: ['B'] }) is dispatched\n  then:\n    - active deck becomes [A, C]\n    - attention moves to an adjacent plank\n    - ScrollIntoView is scheduled for the newly attended plank\n```\n\n```mdl\ntest T-7: Toast is shown and dismissed\n  given: no toasts are in the queue\n  when: AddToast({ title: 'Saved', duration: 3000 }) is dispatched\n  then:\n    - toast appears in the UI\n    - toast is removed after 3 seconds\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n"],
-  "mappings": ";;;AAIA,SAASA,qBAAqB;AAE9B,SAASC,iBAAiBC,kBAAkBC,cAAc;AAC1D,SAASC,qBAAqBC,iBAAiB;AAC/C,SAASC,gBAAgBC,yBAAyB;AAElD,SACEC,iBACAC,gBACAC,cACAC,WACAC,qBACAC,kBACAC,WACAC,cACAC,kBACK;AACP,SAASC,YAAY;AACrB,SAASX,oBAAoB;AAC7B,SAASY,kBAAkB;;;ACvB3B;;;AD+BAC,cAAc,KAAA;AAEP,IAAMC,aAAaC,OAAOC,OAAOC,IAAAA,EAAMC;EAC5CC,UAAUC,kBAAkB;IAAEC,UAAUC;EAAgB,CAAA;EACxDH,UAAUI,0BAA0B;IAAEF,UAAUG;EAAiB,CAAA;EACjEL,UAAUM,iBAAiB;IAAEJ,UAAUK;EAAa,CAAA;EACpDP,UAAUQ,sBAAsB;IAAEC,cAAc;SAAIA;SAAiBC;;EAAmB,CAAA;EACxFd,OAAOe,UAAU;IACfC,aAAaC,oBAAoBC;IACjCC,sBAAsB;MAACC,WAAWC;;IAClCf,UAAUgB;EACZ,CAAA;EACAtB,OAAOe,UAAU;IACfC,aAAaO,gBAAgBC,MAAMJ,WAAWC,eAAeI,iBAAiBC,mBAAmB;IACjGpB,UAAUqB;EACZ,CAAA;EACA3B,OAAOe,UAAU;;;;IAIfC,aAAaO,gBAAgBK,MAAMX,oBAAoBC,eAAeD,oBAAoBY,aAAa;IACvGV,sBAAsB;MAACF,oBAAoBa;MAAaV,WAAWW;;IACnEzB,UAAU0B;EACZ,CAAA;EACAhC,OAAOe,UAAU;IACfC,aAAaS,iBAAiBQ;IAC9B3B,UAAU4B;EACZ,CAAA;;;;;EAKAlC,OAAOe,UAAU;IACfC,aAAaO,gBAAgBC,MAAMC,iBAAiBC,qBAAqBN,WAAWW,UAAU;IAC9FzB,UAAU6B;EACZ,CAAA;EACAnC,OAAOe,UAAU;IACfC,aAAaO,gBAAgBC,MAAMC,iBAAiBC,qBAAqBN,WAAWW,UAAU;IAC9FzB,UAAU8B;EACZ,CAAA;EACAhC,UAAUiC,qBAAqB;IAC7BC,OAAO;MAAEC,UAAUrC,KAAKsC;MAAIC,MAAM;MAAcC,SAASC;MAAYC,UAAU;IAAoB;EACrG,CAAA;EACA5C,OAAO6C;AAAI;AAGb,IAAA,qBAAe9C;",
-  "names": ["setAutoFreeze", "ActivationEvent", "ActivationEvents", "Plugin", "AppActivationEvents", "AppPlugin", "translations", "stackTranslations", "AppGraphBuilder", "CheckAppScheme", "DeckSettings", "DeckState", "NotificationTracker", "OperationHandler", "ReactRoot", "ReactSurface", "UrlHandler", "meta", "DeckEvents", "setAutoFreeze", "DeckPlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addAppGraphModule", "activate", "AppGraphBuilder", "addOperationHandlerModule", "OperationHandler", "addSurfaceModule", "ReactSurface", "addTranslationsModule", "translations", "stackTranslations", "addModule", "activatesOn", "AppActivationEvents", "SetupSettings", "firesAfterActivation", "DeckEvents", "SettingsReady", "DeckSettings", "ActivationEvent", "allOf", "ActivationEvents", "ProcessManagerReady", "CheckAppScheme", "oneOf", "SetupAppGraph", "LayoutReady", "StateReady", "DeckState", "Startup", "ReactRoot", "UrlHandler", "NotificationTracker", "addPluginAssetModule", "asset", "pluginId", "id", "path", "content", "pluginSpec", "mimeType", "make"]
+  "sources": ["../../../src/DeckPlugin.ts", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-deck/PLUGIN.mdl"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { setAutoFreeze } from 'immer';\n\nimport { ActivationEvent, ActivationEvents, Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\n\nimport {\n  AppGraphBuilder,\n  CheckAppScheme,\n  DeckSettings,\n  DeckState,\n  NotificationTracker,\n  OperationHandler,\n  ReactRoot,\n  ReactSurface,\n  UrlHandler,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { DeckEvents } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\n// NOTE(Zan): When producing values with immer, we shouldn't auto-freeze them because\n//   our signal implementation needs to add some hidden properties to the produced values.\n// TODO(Zan): Move this to a more global location if we use immer more broadly.\nsetAutoFreeze(false);\n\nexport const DeckPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    activatesOn: AppActivationEvents.SetupSettings,\n    firesAfterActivation: [DeckEvents.SettingsReady],\n    activate: DeckSettings,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(DeckEvents.SettingsReady, ActivationEvents.ProcessManagerReady),\n    activate: CheckAppScheme,\n  }),\n  Plugin.addModule({\n    // TODO(wittjosiah): Does not integrate with settings store.\n    //   Should this be a different event?\n    //   Should settings store be renamed to be more generic?\n    activatesOn: ActivationEvent.oneOf(AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph),\n    firesAfterActivation: [AppActivationEvents.LayoutReady, DeckEvents.StateReady],\n    activate: DeckState,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvents.Startup,\n    activate: ReactRoot,\n  }),\n  // Plugin.addModule({\n  //   activatesOn: Events.SetupArtifactDefinition,\n  //   activate: Tools,\n  // }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, DeckEvents.StateReady),\n    activate: UrlHandler,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, DeckEvents.StateReady),\n    activate: NotificationTracker,\n  }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default DeckPlugin;\n", "---\nid: org.dxos.plugin.deck\nname: DeckPlugin\nversion: 0.1.0\n---\n\nThe Deck plugin is the core layout engine for DXOS Composer. It manages the multi-plank workspace\n(\"deck\"), the sidebar, the complementary sidebar, dialogs, popovers, and toast notifications.\nIt owns the persisted and ephemeral layout state, handles URL routing, and implements every\n`LayoutOperation` that changes what is visible on screen.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype LayoutMode\n  literals: multi | solo | solo--fullscreen\n```\n\n```mdl\ntype PartAdjustment\n  literals: close | companion | solo | solo--fullscreen | increment-start | increment-end\n```\n\n```mdl\ntype DeckState\n  fields:\n    initialized: boolean          # false until the deck has left solo mode for the first time\n    active: string[]              # item IDs of planks displayed in multi mode\n    inactive: string[]            # item IDs that have been closed; persisted for reopening\n    solo?: string                 # item ID of the single plank in solo or fullscreen mode\n    fullscreen: boolean           # true when the solo plank is displayed without any chrome\n    plankSizing: Record<string, number>   # persisted plank widths in rem, keyed by item ID\n    companionOpen: boolean        # whether the companion pane is visible\n    companionOrientation?: 'horizontal' | 'vertical'   # companion splitter orientation (side-by-side / stacked)\n    companionFrameSizing: Record<string, number>  # companion frame widths in rem\n    # NOTE: the selected companion variant and per-orientation split size now live in react-ui-attention\n    # view state (global, localStorage), not on DeckState \u2014 see util/companion-view-state.ts.\n```\n\n```mdl\ntype StoredDeckState\n  desc: Persisted plugin state stored in KVS/localStorage.\n  fields:\n    sidebarState: closed | collapsed | expanded\n    complementarySidebarState: closed | collapsed | expanded\n    complementarySidebarPanel?: string\n    activeDeck: string\n    previousDeck: string\n    decks: Record<string, DeckState>\n    previousMode: Record<string, LayoutMode>\n```\n\n```mdl\ntype EphemeralDeckState\n  desc: Transient plugin state that is NOT persisted across sessions.\n  fields:\n    dialogOpen: boolean\n    dialogType?: default | alert\n    dialogBlockAlign?: start | center | end\n    dialogContent?: { component: string; props?: any }\n    popoverOpen: boolean\n    popoverSide?: top | right | bottom | left\n    popoverKind?: base | card\n    popoverTitle?: string\n    popoverContentRef?: string\n    popoverContent?: { component: string } | { subject: any }\n    toasts: Toast[]\n    currentUndoId?: string\n    scrollIntoView?: string\n```\n\n```mdl\ntype DeckSettings\n  fields:\n    enableDeck?: boolean          # display multiple panels side by side\n    encapsulatedPlanks?: boolean  # render each plank in an isolated container\n    showHints?: boolean           # show keyboard shortcut hints in the UI\n    enableNativeRedirect?: boolean  # redirect supported URLs to the native desktop app\n```\n\n## Components\n\n```mdl\ncomponent Matrix\n  desc: |\n    The primary workspace canvas. Renders the active planks side by side in multi mode,\n    or a single plank in solo/fullscreen mode. Manages plank-resize handles and the\n    companion pane alongside each plank.\n  props:\n    state: StoredDeckState        # persisted layout state atom\n    ephemeral: EphemeralDeckState # transient state atom\n  state:\n    mode: LayoutMode              # current layout mode derived from state\n  actions:\n    openPlank(id: string)\n    closePlank(id: string)\n    adjustPlank(id: string, type: PartAdjustment)\n    resizePlank(id: string, size: number)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502  sidebar   \u2502  plank A   \u2502  plank B   \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u2502  [content] \u2502  [content] \u2502\n    \u2502            \u2502            \u2502            \u2502\n    \u2502            \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524            \u2502\n    \u2502            \u2502 companion  \u2502            \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent DeckSettings\n  desc: Settings panel rendered in the Composer settings surface.\n  props:\n    settings: DeckSettings\n  actions:\n    updateSetting(key: string, value: any)\n```\n\n## Operations\n\n```mdl\nop Open\n  desc: |\n    Opens one or more subjects (item IDs or navigation paths) in the deck.\n    In multi mode uses stack semantics: truncates after the pivot then appends.\n    In solo or uninitialised mode, replaces the current subject entirely.\n    Validates each target against the app graph and redirects to a 404 node if not found.\n    Fires ScrollIntoView, Expose, and an observability event for each newly opened item.\n  input:\n    subject: string[]             # item IDs or navigation paths to open\n    pivotId?: string              # truncate deck after this item before appending\n    key?: string                  # replace an existing plank whose ID shares this key prefix\n    workspace?: string            # switch to this workspace before opening\n    navigation?: immediate        # skip validation; expand path only\n    scrollIntoView?: boolean      # default true; set false to suppress auto-scroll\n    state?: any\n    variant?: string\n  output: string[]\n  effects: [echo:read, layout:state]\n  requires: [AppGraph, AttentionCapabilities, ClientCapabilities, DeckCapabilities]\n```\n\n```mdl\nop Close\n  desc: |\n    Removes one or more subjects from the active deck.\n    Computes which plank (if any) should receive attention after removal and\n    schedules ScrollIntoView for it.\n  input:\n    subject: string[]\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities, AttentionCapabilities]\n```\n\n```mdl\nop SetLayoutMode\n  desc: |\n    Transitions to a new layout mode (multi, solo, solo--fullscreen) or reverts\n    to the previously recorded mode. Persists the previous mode so it can be\n    restored later. Toggling solo--fullscreen flips the fullscreen flag rather\n    than unconditionally setting it.\n  input:\n    mode?: LayoutMode             # target mode; omit if reverting\n    subject?: string              # item to solo; used only for solo / solo--fullscreen\n    revert?: boolean              # revert to the previously persisted mode\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateSidebar\n  desc: Update the sidebar visibility state (closed / collapsed / expanded).\n  input:\n    state?: closed | collapsed | expanded\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateComplementary\n  desc: Update the complementary-sidebar visibility state and optional panel selection.\n  input:\n    state?: closed | collapsed | expanded\n    panel?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateDialog\n  desc: |\n    Show or hide the global dialog overlay. Accepts a surface component identifier\n    or a boolean state flag. Propagates to EphemeralDeckState.\n  input:\n    subject?: string              # surface component identifier to display\n    props?: any                   # props forwarded to the dialog surface\n    state?: boolean               # false to close the dialog\n    type?: default | alert\n    blockAlign?: start | center | end\n    overlayClasses?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePopover\n  desc: |\n    Show or hide the global popover. Accepts anchor, content reference, or\n    an explicit subject reference.\n  input:\n    subject?: any                 # subject reference to pass to the popover surface\n    contentRef?: string           # surface component identifier for popover content\n    anchorId?: string             # DOM element ID for positioning the popover anchor\n    side?: top | right | bottom | left\n    kind?: base | card\n    title?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdateCompanion\n  desc: Update the companion-pane open state and active variant.\n  input:\n    open?: boolean\n    variant?: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AdjustPlank\n  desc: Apply a PartAdjustment to a specific plank (close, solo, move, companion).\n  input:\n    id: string\n    type: PartAdjustment\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop UpdatePlankSize\n  desc: Persist the width of a plank in rem.\n  input:\n    id: string\n    size: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop AddToast\n  desc: Push a toast notification into the ephemeral queue.\n  input:\n    title?: string\n    body?: string\n    duration?: number\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop ScrollIntoView\n  desc: Schedule a subject to be scrolled into view when its plank mounts.\n  input:\n    subject: string\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop SwitchWorkspace\n  desc: Switch the active workspace deck, persisting the previous workspace ID.\n  input:\n    subject: string               # workspace ID to switch to\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n```mdl\nop RevertWorkspace\n  desc: Revert to the previously active workspace.\n  input: void\n  output: void\n  effects: [layout:state]\n  requires: [DeckCapabilities]\n```\n\n## Features\n\n```mdl\nfeat F-1: Multi-Plank Layout (Deck)\n\n  req F-1.1:\n    when: enableDeck setting is true\n    then: deck renders active planks side by side in a scrollable row\n\n  req F-1.2:\n    when: user opens a new subject with a pivot\n    then: deck is truncated after the pivot and the new subject is appended\n\n  req F-1.3:\n    when: subject is already present in the active deck\n    then: deck is unchanged and the existing plank scrolls into view\n\n  req F-1.4:\n    when: user resizes a plank\n    then: new width is persisted in plankSizing and restored on next load\n```\n\n```mdl\nfeat F-2: Solo / Fullscreen Mode\n\n  req F-2.1:\n    when: user triggers SetLayoutMode with mode=solo\n    then: only the targeted plank is visible; other planks move to inactive\n\n  req F-2.2:\n    when: user triggers SetLayoutMode with mode=solo--fullscreen\n    then: plank fills the viewport; sidebar and heading chrome are hidden\n\n  req F-2.3:\n    when: user triggers SetLayoutMode with revert=true\n    then: layout returns to the previously persisted mode\n```\n\n```mdl\nfeat F-3: Sidebar & Complementary Sidebar\n\n  req F-3.1:\n    when: UpdateSidebar is dispatched with a new state\n    then: sidebar transitions between closed / collapsed / expanded and state is persisted\n\n  req F-3.2:\n    when: UpdateComplementary is dispatched with a panel\n    then: complementary sidebar opens to the specified panel\n```\n\n```mdl\nfeat F-4: Dialog & Popover Overlay\n\n  req F-4.1:\n    when: UpdateDialog is dispatched with a subject component\n    then: the matching surface is rendered inside the global dialog overlay\n\n  req F-4.2:\n    when: UpdatePopover is dispatched with an anchorId\n    then: popover is positioned relative to that DOM element\n\n  req F-4.3:\n    when: dialog or popover state is set to false\n    then: overlay is closed and content is unmounted\n```\n\n```mdl\nfeat F-5: URL Navigation & Deep Linking\n\n  req F-5.1:\n    when: app loads with a URL referencing an item\n    then: DeckPlugin resolves the path and opens the item in the deck\n\n  req F-5.2:\n    when: active deck changes\n    then: browser URL is updated to reflect the current plank state\n\n  req F-5.3:\n    when: a navigation target is not found in the app graph\n    then: Open operation redirects to a 404 node\n```\n\n```mdl\nfeat F-6: Toast Notifications\n\n  req F-6.1:\n    when: AddToast is dispatched\n    then: a toast is appended to the queue and displayed for its configured duration\n\n  req F-6.2:\n    when: ShowUndo is dispatched\n    then: a toast with an undo action is shown; invoking it executes the linked undo operation\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Open subject in multi mode\n  given: deck is in multi mode with planks A and B active\n  when: Open({ subject: ['C'] }) is dispatched\n  then:\n    - plank C is appended to the right of plank B\n    - browser URL reflects the new deck state\n    - plank C is scrolled into view\n```\n\n```mdl\ntest T-2: Open with pivot truncation\n  given: deck has planks [A, B, C] active\n  when: Open({ subject: ['D'], pivotId: 'A' }) is dispatched\n  then:\n    - active deck becomes [A, D]\n    - planks B and C are moved to inactive\n```\n\n```mdl\ntest T-3: Open already-visible subject\n  given: deck has plank A active\n  when: Open({ subject: ['A'] }) is dispatched\n  then:\n    - active deck is unchanged\n    - plank A scrolls into view\n```\n\n```mdl\ntest T-4: Solo mode\n  given: deck is in multi mode\n  when: SetLayoutMode({ mode: 'solo', subject: 'A' }) is dispatched\n  then:\n    - only plank A is visible\n    - mode is stored as solo in StoredDeckState\n    - previousMode records 'multi' for the active deck\n```\n\n```mdl\ntest T-5: Revert from solo to multi\n  given: layout mode is solo, previousMode is multi\n  when: SetLayoutMode({ revert: true }) is dispatched\n  then:\n    - deck returns to multi mode\n    - previously inactive planks are restored\n```\n\n```mdl\ntest T-6: Close plank\n  given: deck has planks [A, B, C] active; B has attention\n  when: Close({ subject: ['B'] }) is dispatched\n  then:\n    - active deck becomes [A, C]\n    - attention moves to an adjacent plank\n    - ScrollIntoView is scheduled for the newly attended plank\n```\n\n```mdl\ntest T-7: Toast is shown and dismissed\n  given: no toasts are in the queue\n  when: AddToast({ title: 'Saved', duration: 3000 }) is dispatched\n  then:\n    - toast appears in the UI\n    - toast is removed after 3 seconds\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n"],
+  "mappings": ";;;AAIA,SAASA,qBAAqB;AAE9B,SAASC,iBAAiBC,kBAAkBC,cAAc;AAC1D,SAASC,qBAAqBC,iBAAiB;AAE/C,SACEC,iBACAC,gBACAC,cACAC,WACAC,qBACAC,kBACAC,WACAC,cACAC,kBACK;AACP,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,kBAAkB;;;ACtB3B;;;AD8BAC,cAAc,KAAA;AAEP,IAAMC,aAAaC,OAAOC,OAAOC,IAAAA,EAAMC;EAC5CC,UAAUC,kBAAkB;IAAEC,UAAUC;EAAgB,CAAA;EACxDH,UAAUI,0BAA0B;IAAEF,UAAUG;EAAiB,CAAA;EACjEL,UAAUM,iBAAiB;IAAEJ,UAAUK;EAAa,CAAA;EACpDP,UAAUQ,sBAAsB;IAAEC;EAAa,CAAA;EAC/Cb,OAAOc,UAAU;IACfC,aAAaC,oBAAoBC;IACjCC,sBAAsB;MAACC,WAAWC;;IAClCd,UAAUe;EACZ,CAAA;EACArB,OAAOc,UAAU;IACfC,aAAaO,gBAAgBC,MAAMJ,WAAWC,eAAeI,iBAAiBC,mBAAmB;IACjGnB,UAAUoB;EACZ,CAAA;EACA1B,OAAOc,UAAU;;;;IAIfC,aAAaO,gBAAgBK,MAAMX,oBAAoBC,eAAeD,oBAAoBY,aAAa;IACvGV,sBAAsB;MAACF,oBAAoBa;MAAaV,WAAWW;;IACnExB,UAAUyB;EACZ,CAAA;EACA/B,OAAOc,UAAU;IACfC,aAAaS,iBAAiBQ;IAC9B1B,UAAU2B;EACZ,CAAA;;;;;EAKAjC,OAAOc,UAAU;IACfC,aAAaO,gBAAgBC,MAAMC,iBAAiBC,qBAAqBN,WAAWW,UAAU;IAC9FxB,UAAU4B;EACZ,CAAA;EACAlC,OAAOc,UAAU;IACfC,aAAaO,gBAAgBC,MAAMC,iBAAiBC,qBAAqBN,WAAWW,UAAU;IAC9FxB,UAAU6B;EACZ,CAAA;EACA/B,UAAUgC,qBAAqB;IAC7BC,OAAO;MAAEC,UAAUpC,KAAKqC,QAAQC;MAAKC,MAAM;MAAcC,SAASC;MAAYC,UAAU;IAAoB;EAC9G,CAAA;EACA5C,OAAO6C;AAAI;AAGb,IAAA,qBAAe9C;",
+  "names": ["setAutoFreeze", "ActivationEvent", "ActivationEvents", "Plugin", "AppActivationEvents", "AppPlugin", "AppGraphBuilder", "CheckAppScheme", "DeckSettings", "DeckState", "NotificationTracker", "OperationHandler", "ReactRoot", "ReactSurface", "UrlHandler", "meta", "translations", "DeckEvents", "setAutoFreeze", "DeckPlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addAppGraphModule", "activate", "AppGraphBuilder", "addOperationHandlerModule", "OperationHandler", "addSurfaceModule", "ReactSurface", "addTranslationsModule", "translations", "addModule", "activatesOn", "AppActivationEvents", "SetupSettings", "firesAfterActivation", "DeckEvents", "SettingsReady", "DeckSettings", "ActivationEvent", "allOf", "ActivationEvents", "ProcessManagerReady", "CheckAppScheme", "oneOf", "SetupAppGraph", "LayoutReady", "StateReady", "DeckState", "Startup", "ReactRoot", "UrlHandler", "NotificationTracker", "addPluginAssetModule", "asset", "pluginId", "profile", "key", "path", "content", "pluginSpec", "mimeType", "make"]
 }

package/dist/lib/neutral/DeckSettings-Z7GMB7XJ.mjs

@@ -0,0 +1,32 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/containers/DeckSettings/DeckSettings.tsx
+import React from "react";
+import { useTranslation } from "@dxos/react-ui";
+import { Form } from "@dxos/react-ui-form";
+import { meta } from "#meta";
+import { Settings } from "#types";
+var isSocket = !!globalThis.__args;
+var DeckSettings = ({ settings, onSettingsChange }) => {
+  const { t } = useTranslation(meta.profile.key);
+  return /* @__PURE__ */ React.createElement(Form.Root, {
+    variant: "settings",
+    schema: Settings.Settings,
+    values: settings,
+    readonly: !onSettingsChange,
+    onValuesChanged: (values) => onSettingsChange?.((current) => ({
+      ...current,
+      ...values
+    }))
+  }, /* @__PURE__ */ React.createElement(Form.Viewport, {
+    scroll: true
+  }, /* @__PURE__ */ React.createElement(Form.Content, null, /* @__PURE__ */ React.createElement(Form.Section, {
+    title: meta.profile.name ?? meta.profile.key
+  }, /* @__PURE__ */ React.createElement(Form.FieldSet, {
+    filter: (properties) => isSocket ? properties.filter((property) => property.name !== "enableNativeRedirect") : properties
+  })))));
+};
+export {
+  DeckSettings as default
+};
+//# sourceMappingURL=DeckSettings-Z7GMB7XJ.mjs.map

package/dist/lib/neutral/DeckSettings-Z7GMB7XJ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/containers/DeckSettings/DeckSettings.tsx"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\n\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { useTranslation } from '@dxos/react-ui';\nimport { Form } from '@dxos/react-ui-form';\n\nimport { meta } from '#meta';\nimport { Settings } from '#types';\n\nconst isSocket = !!(globalThis as any).__args;\n\nexport type DeckSettingsProps = AppSurface.SettingsProps<Settings.Settings>;\n\nexport const DeckSettings = ({ settings, onSettingsChange }: DeckSettingsProps) => {\n  const { t } = useTranslation(meta.profile.key);\n\n  return (\n    <Form.Root\n      variant='settings'\n      schema={Settings.Settings}\n      values={settings}\n      readonly={!onSettingsChange}\n      onValuesChanged={(values) => onSettingsChange?.((current) => ({ ...current, ...values }))}\n    >\n      <Form.Viewport scroll>\n        <Form.Content>\n          <Form.Section title={meta.profile.name ?? meta.profile.key}>\n            <Form.FieldSet\n              filter={(properties) =>\n                isSocket ? properties.filter((property) => property.name !== 'enableNativeRedirect') : properties\n              }\n            />\n          </Form.Section>\n        </Form.Content>\n      </Form.Viewport>\n    </Form.Root>\n  );\n};\n"],
+  "mappings": ";;;AAIA,OAAOA,WAAW;AAGlB,SAASC,sBAAsB;AAC/B,SAASC,YAAY;AAErB,SAASC,YAAY;AACrB,SAASC,gBAAgB;AAEzB,IAAMC,WAAW,CAAC,CAAEC,WAAmBC;AAIhC,IAAMC,eAAe,CAAC,EAAEC,UAAUC,iBAAgB,MAAqB;AAC5E,QAAM,EAAEC,EAAC,IAAKV,eAAeE,KAAKS,QAAQC,GAAG;AAE7C,SACE,sBAAA,cAACX,KAAKY,MAAI;IACRC,SAAQ;IACRC,QAAQZ,SAASA;IACjBa,QAAQR;IACRS,UAAU,CAACR;IACXS,iBAAiB,CAACF,WAAWP,mBAAmB,CAACU,aAAa;MAAE,GAAGA;MAAS,GAAGH;IAAO,EAAA;KAEtF,sBAAA,cAACf,KAAKmB,UAAQ;IAACC,QAAAA;KACb,sBAAA,cAACpB,KAAKqB,SAAO,MACX,sBAAA,cAACrB,KAAKsB,SAAO;IAACC,OAAOtB,KAAKS,QAAQc,QAAQvB,KAAKS,QAAQC;KACrD,sBAAA,cAACX,KAAKyB,UAAQ;IACZC,QAAQ,CAACC,eACPxB,WAAWwB,WAAWD,OAAO,CAACE,aAAaA,SAASJ,SAAS,sBAAA,IAA0BG;;AAQvG;",
+  "names": ["React", "useTranslation", "Form", "meta", "Settings", "isSocket", "globalThis", "__args", "DeckSettings", "settings", "onSettingsChange", "t", "profile", "key", "Root", "variant", "schema", "values", "readonly", "onValuesChanged", "current", "Viewport", "scroll", "Content", "Section", "title", "name", "FieldSet", "filter", "properties", "property"]
+}

package/dist/lib/neutral/{add-toast-TNB6DXWU.mjs → add-toast-BHNEH5UY.mjs}

@@ -1,6 +1,6 @@
 import {
   DeckCapabilities_exports
-} from "./chunk-BS4EOYMK.mjs";
+} from "./chunk-ICOJ4GMB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
 // src/operations/add-toast.ts
@@ -21,4 +21,4 @@ var add_toast_default = handler;
 export {
   add_toast_default as default
 };
-//# sourceMappingURL=add-toast-TNB6DXWU.mjs.map
+//# sourceMappingURL=add-toast-BHNEH5UY.mjs.map

package/dist/lib/neutral/{adjust-HNU5CCRO.mjs → adjust-MJB6UMRQ.mjs}

@@ -8,10 +8,11 @@ import {
   DeckCapabilities_exports,
   DeckOperation_exports,
   PLANK_COMPANION_TYPE
-} from "./chunk-BS4EOYMK.mjs";
+} from "./chunk-ICOJ4GMB.mjs";
 import {
   computeActiveUpdates
-} from "./chunk-GBIGQKYW.mjs";
+} from "./chunk-PP32NEVY.mjs";
+import "./chunk-SONATB35.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
 // src/operations/adjust.ts
@@ -23,7 +24,6 @@ import { AppCapabilities, LayoutOperation } from "@dxos/app-toolkit";
 import { Operation } from "@dxos/compute";
 import { AttentionCapabilities } from "@dxos/plugin-attention";
 import { Graph } from "@dxos/plugin-graph";
-import { byPosition } from "@dxos/util";
 var handler = DeckOperation_exports.Adjust.pipe(Operation.withHandler(Effect.fnUntraced(function* (input) {
   const _state = yield* Capabilities.getAtomValue(DeckCapabilities_exports.State);
   const deck = yield* DeckCapabilities_exports.getDeck();
@@ -77,12 +77,18 @@ var handler = DeckOperation_exports.Adjust.pipe(Operation.withHandler(Effect.fnU
       ]
     });
   }
-  if (input.type === "companion") {
-    const companion = Function.pipe(Graph.getNode(graph, input.id), Option.map((node) => Graph.getConnections(graph, node.id, "child").filter((n) => n.type === PLANK_COMPANION_TYPE).toSorted((a, b) => byPosition(a.properties, b.properties))), Option.flatMap((companions) => companions.length > 0 ? Option.some(companions[0]) : Option.none()));
-    if (Option.isSome(companion)) {
-      yield* Operation.invoke(LayoutOperation.UpdateCompanion, {
-        subject: companion.value.id
-      });
+  if (input.type === "companion" || input.type === "companion-vertical") {
+    const orientation = input.type === "companion-vertical" ? "vertical" : "horizontal";
+    yield* Capabilities.updateAtomValue(DeckCapabilities_exports.State, (state) => updateActiveDeck(state, {
+      companionOrientation: orientation
+    }));
+    if (!deck.companionOpen) {
+      const hasCompanion = Function.pipe(Graph.getNode(graph, input.id), Option.map((node) => Graph.getConnections(graph, node.id, "child").some((n) => n.type === PLANK_COMPANION_TYPE)), Option.getOrElse(() => false));
+      if (hasCompanion) {
+        yield* Capabilities.updateAtomValue(DeckCapabilities_exports.State, (state) => updateActiveDeck(state, {
+          companionOpen: true
+        }));
+      }
     }
   }
 })));
@@ -90,4 +96,4 @@ var adjust_default = handler;
 export {
   adjust_default as default
 };
-//# sourceMappingURL=adjust-HNU5CCRO.mjs.map
+//# sourceMappingURL=adjust-MJB6UMRQ.mjs.map

package/dist/lib/neutral/adjust-MJB6UMRQ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/operations/adjust.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Function from 'effect/Function';\nimport * as Option from 'effect/Option';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { AppCapabilities, LayoutOperation } from '@dxos/app-toolkit';\nimport { Operation } from '@dxos/compute';\nimport { AttentionCapabilities } from '@dxos/plugin-attention';\nimport { Graph } from '@dxos/plugin-graph';\n\nimport { incrementPlank } from '../layout';\nimport { DeckCapabilities, DeckOperation, PLANK_COMPANION_TYPE } from '../types';\nimport { computeActiveUpdates } from '../util';\nimport { updateActiveDeck } from './helpers';\n\nconst handler: Operation.WithHandler<typeof DeckOperation.Adjust> = DeckOperation.Adjust.pipe(\n  Operation.withHandler(\n    Effect.fnUntraced(function* (input) {\n      const _state = yield* Capabilities.getAtomValue(DeckCapabilities.State);\n      const deck = yield* DeckCapabilities.getDeck();\n      const attention = yield* Capability.get(AttentionCapabilities.Attention);\n      const { graph } = yield* Capability.get(AppCapabilities.AppGraph);\n\n      let soloOperation:\n        | { type: 'solo'; entryId: string; mode: string }\n        | { type: 'unsolo'; entryId: string }\n        | undefined;\n\n      if (input.type === 'increment-end' || input.type === 'increment-start') {\n        const next = incrementPlank(deck.active, input);\n        const { deckUpdates } = computeActiveUpdates({ next, deck, attention });\n        yield* Capabilities.updateAtomValue(DeckCapabilities.State, (state) => updateActiveDeck(state, deckUpdates));\n      }\n\n      if (input.type.startsWith('solo')) {\n        const entryId = input.id;\n        if (!deck.solo) {\n          soloOperation = { type: 'solo', entryId, mode: input.type };\n        } else {\n          if (input.type === 'solo--fullscreen') {\n            soloOperation = { type: 'solo', entryId, mode: 'solo--fullscreen' };\n          } else if (input.type === 'solo') {\n            soloOperation = { type: 'unsolo', entryId };\n          }\n        }\n      }\n\n      if (soloOperation?.type === 'solo') {\n        yield* Operation.invoke(LayoutOperation.SetLayoutMode, {\n          subject: soloOperation.entryId,\n          mode: soloOperation.mode,\n        });\n      } else if (soloOperation?.type === 'unsolo') {\n        yield* Operation.invoke(LayoutOperation.SetLayoutMode, { mode: 'multi' });\n        yield* Operation.invoke(LayoutOperation.Open, { subject: [soloOperation.entryId] });\n      }\n\n      if (input.type === 'companion' || input.type === 'companion-vertical') {\n        const orientation = input.type === 'companion-vertical' ? 'vertical' : 'horizontal';\n\n        // Set the orientation first so an already-open companion re-orients in place (the Splitter stays\n        // mounted and only its `orientation` prop changes — panels are never unmounted).\n        yield* Capabilities.updateAtomValue(DeckCapabilities.State, (state) =>\n          updateActiveDeck(state, { companionOrientation: orientation }),\n        );\n\n        // Open the companion when one is available; the selected variant lives in global view state and is\n        // resolved at render time, so opening restores the last-selected tab rather than forcing the first.\n        if (!deck.companionOpen) {\n          const hasCompanion = Function.pipe(\n            Graph.getNode(graph, input.id),\n            Option.map((node) =>\n              Graph.getConnections(graph, node.id, 'child').some((n) => n.type === PLANK_COMPANION_TYPE),\n            ),\n            Option.getOrElse(() => false),\n          );\n\n          if (hasCompanion) {\n            yield* Capabilities.updateAtomValue(DeckCapabilities.State, (state) =>\n              updateActiveDeck(state, { companionOpen: true }),\n            );\n          }\n        }\n      }\n    }),\n  ),\n);\n\nexport default handler;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AACxB,YAAYC,cAAc;AAC1B,YAAYC,YAAY;AAExB,SAASC,cAAcC,kBAAkB;AACzC,SAASC,iBAAiBC,uBAAuB;AACjD,SAASC,iBAAiB;AAC1B,SAASC,6BAA6B;AACtC,SAASC,aAAa;AAOtB,IAAMC,UAA8DC,sBAAcC,OAAOC,KACvFC,UAAUC,YACDC,kBAAW,WAAWC,OAAK;AAChC,QAAMC,SAAS,OAAOC,aAAaC,aAAaC,yBAAiBC,KAAK;AACtE,QAAMC,OAAO,OAAOF,yBAAiBG,QAAO;AAC5C,QAAMC,YAAY,OAAOC,WAAWC,IAAIC,sBAAsBC,SAAS;AACvE,QAAM,EAAEC,MAAK,IAAK,OAAOJ,WAAWC,IAAII,gBAAgBC,QAAQ;AAEhE,MAAIC;AAKJ,MAAIhB,MAAMiB,SAAS,mBAAmBjB,MAAMiB,SAAS,mBAAmB;AACtE,UAAMC,OAAOC,eAAeb,KAAKc,QAAQpB,KAAAA;AACzC,UAAM,EAAEqB,YAAW,IAAKC,qBAAqB;MAAEJ;MAAMZ;MAAME;IAAU,CAAA;AACrE,WAAON,aAAaqB,gBAAgBnB,yBAAiBC,OAAO,CAACmB,UAAUC,iBAAiBD,OAAOH,WAAAA,CAAAA;EACjG;AAEA,MAAIrB,MAAMiB,KAAKS,WAAW,MAAA,GAAS;AACjC,UAAMC,UAAU3B,MAAM4B;AACtB,QAAI,CAACtB,KAAKuB,MAAM;AACdb,sBAAgB;QAAEC,MAAM;QAAQU;QAASG,MAAM9B,MAAMiB;MAAK;IAC5D,OAAO;AACL,UAAIjB,MAAMiB,SAAS,oBAAoB;AACrCD,wBAAgB;UAAEC,MAAM;UAAQU;UAASG,MAAM;QAAmB;MACpE,WAAW9B,MAAMiB,SAAS,QAAQ;AAChCD,wBAAgB;UAAEC,MAAM;UAAUU;QAAQ;MAC5C;IACF;EACF;AAEA,MAAIX,eAAeC,SAAS,QAAQ;AAClC,WAAOpB,UAAUkC,OAAOC,gBAAgBC,eAAe;MACrDC,SAASlB,cAAcW;MACvBG,MAAMd,cAAcc;IACtB,CAAA;EACF,WAAWd,eAAeC,SAAS,UAAU;AAC3C,WAAOpB,UAAUkC,OAAOC,gBAAgBC,eAAe;MAAEH,MAAM;IAAQ,CAAA;AACvE,WAAOjC,UAAUkC,OAAOC,gBAAgBG,MAAM;MAAED,SAAS;QAAClB,cAAcW;;IAAS,CAAA;EACnF;AAEA,MAAI3B,MAAMiB,SAAS,eAAejB,MAAMiB,SAAS,sBAAsB;AACrE,UAAMmB,cAAcpC,MAAMiB,SAAS,uBAAuB,aAAa;AAIvE,WAAOf,aAAaqB,gBAAgBnB,yBAAiBC,OAAO,CAACmB,UAC3DC,iBAAiBD,OAAO;MAAEa,sBAAsBD;IAAY,CAAA,CAAA;AAK9D,QAAI,CAAC9B,KAAKgC,eAAe;AACvB,YAAMC,eAAwB3C,cAC5B4C,MAAMC,QAAQ5B,OAAOb,MAAM4B,EAAE,GACtBc,WAAI,CAACC,SACVH,MAAMI,eAAe/B,OAAO8B,KAAKf,IAAI,OAAA,EAASiB,KAAK,CAACC,MAAMA,EAAE7B,SAAS8B,oBAAAA,CAAAA,GAEhEC,iBAAU,MAAM,KAAA,CAAA;AAGzB,UAAIT,cAAc;AAChB,eAAOrC,aAAaqB,gBAAgBnB,yBAAiBC,OAAO,CAACmB,UAC3DC,iBAAiBD,OAAO;UAAEc,eAAe;QAAK,CAAA,CAAA;MAElD;IACF;EACF;AACF,CAAA,CAAA,CAAA;AAIJ,IAAA,iBAAe7C;",
+  "names": ["Effect", "Function", "Option", "Capabilities", "Capability", "AppCapabilities", "LayoutOperation", "Operation", "AttentionCapabilities", "Graph", "handler", "DeckOperation", "Adjust", "pipe", "Operation", "withHandler", "fnUntraced", "input", "_state", "Capabilities", "getAtomValue", "DeckCapabilities", "State", "deck", "getDeck", "attention", "Capability", "get", "AttentionCapabilities", "Attention", "graph", "AppCapabilities", "AppGraph", "soloOperation", "type", "next", "incrementPlank", "active", "deckUpdates", "computeActiveUpdates", "updateAtomValue", "state", "updateActiveDeck", "startsWith", "entryId", "id", "solo", "mode", "invoke", "LayoutOperation", "SetLayoutMode", "subject", "Open", "orientation", "companionOrientation", "companionOpen", "hasCompanion", "Graph", "getNode", "map", "node", "getConnections", "some", "n", "PLANK_COMPANION_TYPE", "getOrElse"]
+}