@dxos/plugin-deck 0.8.4-main.fd6878d → 0.8.4-staging.60fe92afc8

package/dist/lib/neutral/DeckLayout-DEURA3KR.mjs

@@ -0,0 +1,291 @@
+import {
+  Deck,
+  PlankErrorFallback
+} from "./chunk-WAXJPQJI.mjs";
+import "./chunk-GBIGQKYW.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/containers/DeckLayout/DeckLayout.tsx
+import React5, { useCallback as useCallback3 } from "react";
+import { useAtomCapability, useOperationInvoker, usePluginManager } from "@dxos/app-framework/ui";
+import { LayoutOperation } from "@dxos/app-toolkit";
+import { Mosaic } from "@dxos/react-ui-mosaic";
+import { useDeckState as useDeckState3 } from "#hooks";
+import { DeckCapabilities, getMode } from "#types";
+
+// src/containers/DeckLayout/ActiveNode.tsx
+import React from "react";
+import { Surface } from "@dxos/app-framework/ui";
+import { AppSurface, useAppGraph } from "@dxos/app-toolkit/ui";
+import { useNode } from "@dxos/plugin-graph";
+import { useAttended } from "@dxos/react-ui-attention";
+import { useNodeActionExpander } from "#hooks";
+var ActiveNode = () => {
+  const [id] = useAttended();
+  const { graph } = useAppGraph();
+  const activeNode = useNode(graph, id);
+  useNodeActionExpander(activeNode);
+  return /* @__PURE__ */ React.createElement("div", {
+    className: "sr-only"
+  }, /* @__PURE__ */ React.createElement(Surface.Surface, {
+    type: AppSurface.DocumentTitle,
+    data: {
+      subject: activeNode
+    },
+    limit: 1
+  }));
+};
+
+// src/containers/DeckLayout/Dialog.tsx
+import React2, { useCallback } from "react";
+import { Surface as Surface2 } from "@dxos/app-framework/ui";
+import { AppSurface as AppSurface2 } from "@dxos/app-toolkit/ui";
+import { AlertDialog, Dialog as NaturalDialog } from "@dxos/react-ui";
+import { useDeckState } from "#hooks";
+var Dialog = () => {
+  const { state, updateEphemeral } = useDeckState();
+  const { dialogOpen, dialogType, dialogBlockAlign, dialogOverlayClasses, dialogOverlayStyle, dialogContent } = state;
+  const Root = dialogType === "alert" ? AlertDialog.Root : NaturalDialog.Root;
+  const Overlay = dialogType === "alert" ? AlertDialog.Overlay : NaturalDialog.Overlay;
+  const handleOpenChange = useCallback((nextOpen) => {
+    updateEphemeral((s) => ({
+      ...s,
+      dialogOpen: nextOpen
+    }));
+  }, [
+    updateEphemeral
+  ]);
+  return /* @__PURE__ */ React2.createElement(Root, {
+    modal: dialogBlockAlign !== "end",
+    open: dialogOpen,
+    onOpenChange: handleOpenChange
+  }, dialogBlockAlign === "end" ? (
+    // TODO(burdon): Placeholder creates a suspense boundary; replace with defaults.
+    /* @__PURE__ */ React2.createElement(Surface2.Surface, {
+      type: AppSurface2.Dialog,
+      data: dialogContent ?? void 0,
+      limit: 1,
+      fallback: PlankErrorFallback,
+      placeholder: /* @__PURE__ */ React2.createElement("div", null)
+    })
+  ) : /* @__PURE__ */ React2.createElement(Overlay, {
+    blockAlign: dialogBlockAlign,
+    classNames: dialogOverlayClasses,
+    style: dialogOverlayStyle
+  }, /* @__PURE__ */ React2.createElement(Surface2.Surface, {
+    type: AppSurface2.Dialog,
+    data: dialogContent ?? void 0,
+    limit: 1,
+    fallback: PlankErrorFallback
+  })));
+};
+
+// src/containers/DeckLayout/Popover.tsx
+import { createContext } from "@radix-ui/react-context";
+import React3, { useCallback as useCallback2, useEffect, useRef, useState } from "react";
+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 { Menu } from "@dxos/react-ui-menu";
+import { useDeckState as useDeckState2 } from "#hooks";
+import { meta } from "#meta";
+var DEBOUNCE_DELAY = 40;
+var [DeckPopoverProvider, useDeckPopoverContext] = createContext("DeckPopover");
+var PopoverRoot = ({ children }) => {
+  const { state } = useDeckState2();
+  const virtualRef = useRef(null);
+  const [virtualIter, setVirtualIter] = useState(0);
+  const [open, setOpen] = useState(false);
+  const debounceRef = useRef(null);
+  useEffect(() => {
+    setOpen(false);
+    if (state.popoverOpen) {
+      if (debounceRef.current) {
+        clearTimeout(debounceRef.current);
+      }
+      if (state.popoverAnchor && virtualRef.current !== state.popoverAnchor) {
+        virtualRef.current = state.popoverAnchor ?? null;
+        setVirtualIter((iter) => iter + 1);
+      }
+      debounceRef.current = setTimeout(() => setOpen(true), DEBOUNCE_DELAY);
+    }
+  }, [
+    state.popoverOpen,
+    state.popoverAnchorId,
+    state.popoverAnchor,
+    state.popoverContent
+  ]);
+  return /* @__PURE__ */ React3.createElement(DeckPopoverProvider, {
+    setOpen
+  }, /* @__PURE__ */ React3.createElement(Popover.Root, {
+    modal: false,
+    open
+  }, state.popoverAnchor && /* @__PURE__ */ React3.createElement(Popover.VirtualTrigger, {
+    key: virtualIter,
+    virtualRef
+  }), children));
+};
+var PopoverContent = () => {
+  const { t } = useTranslation(meta.id);
+  const { state, updateEphemeral } = useDeckState2();
+  const { setOpen } = useDeckPopoverContext("PopoverContent");
+  const popoverSubject = state.popoverContent && "subject" in state.popoverContent ? state.popoverContent.subject : void 0;
+  const isObjectPopover = Obj.isObject(popoverSubject);
+  const objectMenuItems = useObjectMenuItems(popoverSubject);
+  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 handleClose = useCallback2(() => {
+    setOpen(false);
+    updateEphemeral((state2) => ({
+      ...state2,
+      popoverOpen: false,
+      popoverAnchor: void 0,
+      popoverAnchorId: void 0,
+      popoverSide: void 0
+    }));
+  }, [
+    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")
+    ) {
+      event.preventDefault();
+    } else {
+      handleClose();
+    }
+  }, [
+    handleClose
+  ]);
+  return /* @__PURE__ */ React3.createElement(Popover.Portal, null, /* @__PURE__ */ React3.createElement(Popover.Content, {
+    side: state.popoverSide,
+    sticky: "always",
+    hideWhenDetached: true,
+    onOpenAutoFocus: (event) => event.preventDefault(),
+    onInteractOutside: handleInteractOutside,
+    onEscapeKeyDown: handleInteractOutside
+  }, /* @__PURE__ */ React3.createElement(Popover.Viewport, null, isBasePopover && content && "component" in content ? (
+    /* Base popover: a plugin-provided component (e.g. editor link preview). */
+    /* @__PURE__ */ React3.createElement(Surface3.Surface, {
+      type: AppSurface3.Popover,
+      data: content,
+      limit: 1
+    })
+  ) : (
+    /*
+        * Card popover (default). Rendered for any open popover that isn't an explicit
+        * base-component popover so the popover can never collapse to a bare 1px frame: the
+        * header (icon + title + menu) always renders, and the body falls back to a fixed-
+        * height "no preview" row when no subject resolves a card Surface (e.g. system-type
+        * objects like a raw Feed that have no registered card and no renderable fields).
+        */
+    /* @__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, {
+      icon
+    })), /* @__PURE__ */ React3.createElement(Card.Title, null, title), /* @__PURE__ */ React3.createElement(Card.IconBlock, null, /* @__PURE__ */ React3.createElement(Menu.Trigger, {
+      asChild: true,
+      disabled: !objectMenuItems.length
+    }, /* @__PURE__ */ React3.createElement(Toolbar.IconButton, {
+      variant: "ghost",
+      density: "sm",
+      icon: "ph--dots-three-vertical--regular",
+      iconOnly: true,
+      label: "Actions"
+    })), /* @__PURE__ */ React3.createElement(Menu.Content, {
+      items: objectMenuItems
+    }))), content && "subject" in content ? /* @__PURE__ */ React3.createElement(Surface3.Surface, {
+      type: AppSurface3.Card,
+      data: content,
+      limit: 1
+    }) : /* @__PURE__ */ React3.createElement(Card.Body, {
+      classNames: "min-bs-8"
+    }, /* @__PURE__ */ React3.createElement(Card.Row, null, /* @__PURE__ */ React3.createElement(Card.Text, {
+      variant: "description"
+    }, t("popover-no-preview.message"))))))
+  )), /* @__PURE__ */ React3.createElement(Popover.Arrow, null)));
+};
+
+// src/containers/DeckLayout/Toast.tsx
+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 [open, setOpen] = useState2(true);
+  const handleOpenChange = (next) => {
+    setOpen(next);
+    onOpenChange?.(next);
+  };
+  return /* @__PURE__ */ React4.createElement(NaturalToast.Root, {
+    "data-testid": id,
+    open,
+    duration,
+    onOpenChange: handleOpenChange
+  }, /* @__PURE__ */ React4.createElement(NaturalToast.Title, {
+    icon,
+    onClose: () => handleOpenChange(false)
+  }, title && /* @__PURE__ */ React4.createElement("span", null, toLocalizedString2(title, t))), description && /* @__PURE__ */ React4.createElement(NaturalToast.Description, null, toLocalizedString2(description, t)), onAction && actionAlt && actionLabel && /* @__PURE__ */ React4.createElement(NaturalToast.Actions, null, /* @__PURE__ */ React4.createElement(NaturalToast.Action, {
+    altText: toLocalizedString2(actionAlt, t),
+    asChild: true
+  }, /* @__PURE__ */ React4.createElement(Button, {
+    "data-testid": "toast.action",
+    variant: "primary",
+    onClick: () => onAction?.()
+  }, toLocalizedString2(actionLabel, t)))));
+};
+var Toaster = ({ toasts, onDismissToast }) => {
+  return /* @__PURE__ */ React4.createElement(React4.Fragment, null, toasts?.map((toast) => /* @__PURE__ */ React4.createElement(Toast, {
+    ...toast,
+    key: toast.id,
+    onOpenChange: (open) => {
+      if (!open) {
+        onDismissToast?.(toast.id);
+      }
+      return open;
+    }
+  })));
+};
+
+// src/containers/DeckLayout/DeckLayout.tsx
+var DeckLayout = ({ onDismissToast }) => {
+  const settings = useAtomCapability(DeckCapabilities.Settings);
+  const pluginManager = usePluginManager();
+  const { invokePromise } = useOperationInvoker();
+  const { deck, state, updateState } = useDeckState3();
+  const layoutMode = getMode(deck);
+  const { toasts } = state;
+  const handleLayoutChange = useCallback3((request) => {
+    void invokePromise(LayoutOperation.SetLayoutMode, request);
+  }, [
+    invokePromise
+  ]);
+  return /* @__PURE__ */ React5.createElement(Mosaic.Root, null, /* @__PURE__ */ React5.createElement(PopoverRoot, null, /* @__PURE__ */ React5.createElement(ActiveNode, null), /* @__PURE__ */ React5.createElement(Deck.Root, {
+    settings,
+    pluginManager,
+    layoutMode,
+    deck,
+    state,
+    updateState,
+    onLayoutChange: handleLayoutChange
+  }, /* @__PURE__ */ React5.createElement(Deck.Content, null, /* @__PURE__ */ React5.createElement(Deck.Viewport, null, deck.solo ? /* @__PURE__ */ React5.createElement(Deck.SoloMode, null) : deck.active.length === 0 ? /* @__PURE__ */ React5.createElement(Deck.ContentEmpty, null) : /* @__PURE__ */ React5.createElement(Deck.MultiMode, null)))), /* @__PURE__ */ React5.createElement(PopoverContent, null), /* @__PURE__ */ React5.createElement(Dialog, null), /* @__PURE__ */ React5.createElement(Toaster, {
+    toasts,
+    onDismissToast
+  })));
+};
+
+// src/containers/DeckLayout/constants.ts
+var NAV_ID = "NavTree";
+
+// src/containers/DeckLayout/index.ts
+var DeckLayout_default = DeckLayout;
+export {
+  NAV_ID,
+  DeckLayout_default as default
+};
+//# sourceMappingURL=DeckLayout-DEURA3KR.mjs.map

package/dist/lib/neutral/DeckLayout-DEURA3KR.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 '../Plank';\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  Popover,\n  type PopoverContentInteractOutsideEvent,\n  toLocalizedString,\n  Toolbar,\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  return (\n    <DeckPopoverProvider setOpen={setOpen}>\n      <Popover.Root modal={false} 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.id);\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  // A base popover renders a plugin-provided component; everything else falls through to the card.\n  const isBasePopover = state.popoverKind === 'base' && !!content && 'component' in content;\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      if (\n        // TODO(thure): CodeMirror should not focus itself when it updates.\n        event.type === 'dismissableLayer.focusOutside' &&\n        (event.currentTarget as HTMLElement | undefined)?.classList.contains('cm-content')\n      ) {\n        event.preventDefault();\n      } else {\n        handleClose();\n      }\n    },\n    [handleClose],\n  );\n\n  return (\n    <Popover.Portal>\n      <Popover.Content\n        side={state.popoverSide}\n        sticky='always'\n        hideWhenDetached\n        onOpenAutoFocus={(event) => event.preventDefault()}\n        onInteractOutside={handleInteractOutside}\n        onEscapeKeyDown={handleInteractOutside}\n      >\n        <Popover.Viewport>\n          {isBasePopover && 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.IconBlock>{icon && <Card.Icon icon={icon} />}</Card.IconBlock>\n                  <Card.Title>{title}</Card.Title>\n                  {/* TODO(wittjosiah): Reconcile with Card.Menu. */}\n                  <Card.IconBlock>\n                    <Menu.Trigger asChild disabled={!objectMenuItems.length}>\n                      <Toolbar.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.IconBlock>\n                </Card.Header>\n\n                {content && 'subject' in content ? (\n                  <Surface.Surface type={AppSurface.Card} 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.id);\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", "Popover", "toLocalizedString", "Toolbar", "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", "Root", "modal", "VirtualTrigger", "key", "PopoverContent", "t", "id", "updateEphemeral", "popoverSubject", "subject", "undefined", "isObjectPopover", "isObject", "objectMenuItems", "title", "popoverTitle", "icon", "getIcon", "content", "isBasePopover", "popoverKind", "handleClose", "popoverSide", "handleInteractOutside", "event", "type", "currentTarget", "classList", "contains", "preventDefault", "Portal", "Content", "side", "sticky", "hideWhenDetached", "onOpenAutoFocus", "onInteractOutside", "onEscapeKeyDown", "Viewport", "data", "limit", "border", "classNames", "Header", "IconBlock", "Icon", "Title", "Trigger", "asChild", "disabled", "length", "IconButton", "variant", "density", "iconOnly", "label", "items", "Body", "Row", "Text", "Arrow", "React", "useState", "Button", "Toast", "NaturalToast", "toLocalizedString", "useTranslation", "meta", "id", "title", "description", "icon", "duration", "actionLabel", "actionAlt", "onAction", "onOpenChange", "t", "open", "setOpen", "handleOpenChange", "next", "Root", "data-testid", "Title", "onClose", "span", "Description", "Actions", "Action", "altText", "asChild", "variant", "onClick", "Toaster", "toasts", "onDismissToast", "map", "toast", "key", "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

@@ -0,0 +1,87 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/DeckPlugin.ts
+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";
+
+// src/DeckPlugin.ts
+setAutoFreeze(false);
+var DeckPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addAppGraphModule({
+    activate: AppGraphBuilder
+  }),
+  AppPlugin.addOperationHandlerModule({
+    activate: OperationHandler
+  }),
+  AppPlugin.addSurfaceModule({
+    activate: ReactSurface
+  }),
+  AppPlugin.addTranslationsModule({
+    translations: [
+      ...translations,
+      ...stackTranslations
+    ]
+  }),
+  Plugin.addModule({
+    activatesOn: AppActivationEvents.SetupSettings,
+    firesAfterActivation: [
+      DeckEvents.SettingsReady
+    ],
+    activate: DeckSettings
+  }),
+  Plugin.addModule({
+    activatesOn: ActivationEvent.allOf(DeckEvents.SettingsReady, ActivationEvents.ProcessManagerReady),
+    activate: CheckAppScheme
+  }),
+  Plugin.addModule({
+    // TODO(wittjosiah): Does not integrate with settings store.
+    //   Should this be a different event?
+    //   Should settings store be renamed to be more generic?
+    activatesOn: ActivationEvent.oneOf(AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph),
+    firesAfterActivation: [
+      AppActivationEvents.LayoutReady,
+      DeckEvents.StateReady
+    ],
+    activate: DeckState
+  }),
+  Plugin.addModule({
+    activatesOn: ActivationEvents.Startup,
+    activate: ReactRoot
+  }),
+  // Plugin.addModule({
+  //   activatesOn: Events.SetupArtifactDefinition,
+  //   activate: Tools,
+  // }),
+  Plugin.addModule({
+    activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, DeckEvents.StateReady),
+    activate: UrlHandler
+  }),
+  Plugin.addModule({
+    activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, DeckEvents.StateReady),
+    activate: NotificationTracker
+  }),
+  AppPlugin.addPluginAssetModule({
+    asset: {
+      pluginId: meta.id,
+      path: "PLUGIN.mdl",
+      content: PLUGIN_default,
+      mimeType: "application/x-mdl"
+    }
+  }),
+  Plugin.make
+);
+var DeckPlugin_default = DeckPlugin;
+export {
+  DeckPlugin,
+  DeckPlugin_default as default
+};
+//# sourceMappingURL=DeckPlugin.mjs.map

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

@@ -0,0 +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"]
+}

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

@@ -0,0 +1,18 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/DeckPlugin.node.ts
+import { Plugin } from "@dxos/app-framework";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { AppGraphBuilder, OperationHandler } from "#capabilities";
+import { meta } from "#meta";
+var DeckPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({
+  activate: AppGraphBuilder
+}), AppPlugin.addOperationHandlerModule({
+  activate: OperationHandler
+}), Plugin.make);
+var DeckPlugin_node_default = DeckPlugin;
+export {
+  DeckPlugin,
+  DeckPlugin_node_default as default
+};
+//# sourceMappingURL=DeckPlugin.node.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/DeckPlugin.node.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { AppGraphBuilder, OperationHandler } from '#capabilities';\nimport { meta } from '#meta';\n\nexport const DeckPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  Plugin.make,\n);\n\nexport default DeckPlugin;\n"],
+  "mappings": ";;;AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,iBAAiBC,wBAAwB;AAClD,SAASC,YAAY;AAEd,IAAMC,aAAaL,OAAOM,OAAOF,IAAAA,EAAMG,KAC5CN,UAAUO,kBAAkB;EAAEC,UAAUP;AAAgB,CAAA,GACxDD,UAAUS,0BAA0B;EAAED,UAAUN;AAAiB,CAAA,GACjEH,OAAOW,IAAI;AAGb,IAAA,0BAAeN;",
+  "names": ["Plugin", "AppPlugin", "AppGraphBuilder", "OperationHandler", "meta", "DeckPlugin", "define", "pipe", "addAppGraphModule", "activate", "addOperationHandlerModule", "make"]
+}

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

@@ -0,0 +1,16 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/DeckPlugin.workerd.ts
+import { Plugin } from "@dxos/app-framework";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { OperationHandler } from "#capabilities";
+import { meta } from "#meta";
+var DeckPlugin = Plugin.define(meta).pipe(AppPlugin.addOperationHandlerModule({
+  activate: OperationHandler
+}), Plugin.make);
+var DeckPlugin_workerd_default = DeckPlugin;
+export {
+  DeckPlugin,
+  DeckPlugin_workerd_default as default
+};
+//# sourceMappingURL=DeckPlugin.workerd.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/DeckPlugin.workerd.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { OperationHandler } from '#capabilities';\nimport { meta } from '#meta';\n\nexport const DeckPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  Plugin.make,\n);\n\nexport default DeckPlugin;\n"],
+  "mappings": ";;;AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,wBAAwB;AACjC,SAASC,YAAY;AAEd,IAAMC,aAAaJ,OAAOK,OAAOF,IAAAA,EAAMG,KAC5CL,UAAUM,0BAA0B;EAAEC,UAAUN;AAAiB,CAAA,GACjEF,OAAOS,IAAI;AAGb,IAAA,6BAAeL;",
+  "names": ["Plugin", "AppPlugin", "OperationHandler", "meta", "DeckPlugin", "define", "pipe", "addOperationHandlerModule", "activate", "make"]
+}

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

@@ -0,0 +1,27 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/components/DeckSettings/DeckSettings.tsx
+import React from "react";
+import { useTranslation } from "@dxos/react-ui";
+import { Settings as SettingsForm } 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.id);
+  return /* @__PURE__ */ React.createElement(SettingsForm.Viewport, null, /* @__PURE__ */ React.createElement(SettingsForm.Section, {
+    title: t("settings.title", {
+      ns: meta.id
+    })
+  }, /* @__PURE__ */ React.createElement(SettingsForm.FieldSet, {
+    readonly: !onSettingsChange,
+    schema: Settings.Settings,
+    visible: (path) => path !== "enableNativeRedirect" || !isSocket,
+    values: settings,
+    onValuesChanged: (values) => onSettingsChange?.(() => values)
+  })));
+};
+export {
+  DeckSettings as default
+};
+//# sourceMappingURL=DeckSettings-W5I57OXM.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/components/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 { Settings as SettingsForm } 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.SettingsArticleProps<Settings.Settings>;\n\nexport const DeckSettings = ({ settings, onSettingsChange }: DeckSettingsProps) => {\n  const { t } = useTranslation(meta.id);\n\n  return (\n    <SettingsForm.Viewport>\n      <SettingsForm.Section title={t('settings.title', { ns: meta.id })}>\n        <SettingsForm.FieldSet\n          readonly={!onSettingsChange}\n          schema={Settings.Settings}\n          visible={(path) => path !== 'enableNativeRedirect' || !isSocket}\n          values={settings}\n          onValuesChanged={(values) => onSettingsChange?.(() => values)}\n        />\n      </SettingsForm.Section>\n    </SettingsForm.Viewport>\n  );\n};\n"],
+  "mappings": ";;;AAIA,OAAOA,WAAW;AAGlB,SAASC,sBAAsB;AAC/B,SAASC,YAAYC,oBAAoB;AAEzC,SAASC,YAAY;AACrB,SAASF,gBAAgB;AAEzB,IAAMG,WAAW,CAAC,CAAEC,WAAmBC;AAIhC,IAAMC,eAAe,CAAC,EAAEC,UAAUC,iBAAgB,MAAqB;AAC5E,QAAM,EAAEC,EAAC,IAAKV,eAAeG,KAAKQ,EAAE;AAEpC,SACE,sBAAA,cAACT,aAAaU,UAAQ,MACpB,sBAAA,cAACV,aAAaW,SAAO;IAACC,OAAOJ,EAAE,kBAAkB;MAAEK,IAAIZ,KAAKQ;IAAG,CAAA;KAC7D,sBAAA,cAACT,aAAac,UAAQ;IACpBC,UAAU,CAACR;IACXS,QAAQjB,SAASA;IACjBkB,SAAS,CAACC,SAASA,SAAS,0BAA0B,CAAChB;IACvDiB,QAAQb;IACRc,iBAAiB,CAACD,WAAWZ,mBAAmB,MAAMY,MAAAA;;AAKhE;",
+  "names": ["React", "useTranslation", "Settings", "SettingsForm", "meta", "isSocket", "globalThis", "__args", "DeckSettings", "settings", "onSettingsChange", "t", "id", "Viewport", "Section", "title", "ns", "FieldSet", "readonly", "schema", "visible", "path", "values", "onValuesChanged"]
+}