@dxos/plugin-deck 0.8.4-main.f9ba587 → 0.8.4-main.fcc0d83b33

package/dist/lib/browser/chunk-ZYYOSX5I.mjs

@@ -0,0 +1,69 @@
+// src/layout.ts
+import { produce } from "immer";
+var openEntry = (deck, entryId, options) => {
+  return produce([
+    ...deck
+  ], (draft) => {
+    if (draft.find((id) => id === entryId)) {
+      return;
+    }
+    const key = options?.key;
+    if (key) {
+      const index = draft.findIndex((id) => id.split("+")[0] === key);
+      if (index !== -1) {
+        draft.splice(index, 1, entryId);
+        return;
+      }
+    }
+    draft.push(entryId);
+  });
+};
+var openSubjectsOnActiveDeck = (active, subject, options) => {
+  if (subject.length > 0 && subject.every((id) => active.includes(id))) {
+    return [
+      ...active
+    ];
+  }
+  const { pivotId, key } = options ?? {};
+  const pivotIndex = pivotId ? active.findIndex((id) => id === pivotId) : -1;
+  const baseDeck = pivotIndex !== -1 ? active.slice(0, pivotIndex + 1) : [
+    ...active
+  ];
+  return subject.reduce((acc, entryId) => openEntry(acc, entryId, {
+    key
+  }), baseDeck);
+};
+var closeEntry = (deck, entryId) => {
+  return produce(deck, (draft) => {
+    const index = draft.findIndex((id) => id === entryId);
+    if (index !== -1) {
+      draft.splice(index, 1);
+    }
+  });
+};
+var incrementPlank = (deck, adjustment) => {
+  return produce(deck, (draft) => {
+    const index = draft.findIndex((id) => id === adjustment.id);
+    if (index === -1 || adjustment.type === "increment-start" && index === 0 || adjustment.type === "increment-end" && index === draft.length - 1) {
+      return;
+    }
+    if (adjustment.type === "increment-start") {
+      [draft[index - 1], draft[index]] = [
+        draft[index],
+        draft[index - 1]
+      ];
+    } else if (adjustment.type === "increment-end") {
+      [draft[index], draft[index + 1]] = [
+        draft[index + 1],
+        draft[index]
+      ];
+    }
+  });
+};
+
+export {
+  openSubjectsOnActiveDeck,
+  closeEntry,
+  incrementPlank
+};
+//# sourceMappingURL=chunk-ZYYOSX5I.mjs.map

package/dist/lib/browser/chunk-ZYYOSX5I.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/layout.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { produce } from 'immer';\n\nimport { type DeckAction } from '#types';\n\ntype OpenLayoutEntryOptions = {\n  key?: string;\n};\n\n/**\n * Mutates a deck list using stack semantics: new items open to the right (`push`).\n * Callers that open from a pivot must truncate the deck first (see deck `open` operation).\n */\nexport const openEntry = (deck: readonly string[], entryId: string, options?: OpenLayoutEntryOptions): string[] => {\n  return produce([...deck], (draft) => {\n    if (draft.find((id) => id === entryId)) {\n      return;\n    }\n\n    const key = options?.key;\n    if (key) {\n      const index = draft.findIndex((id) => id.split('+')[0] === key);\n      if (index !== -1) {\n        draft.splice(index, 1, entryId);\n        return;\n      }\n    }\n\n    draft.push(entryId);\n  });\n};\n\nexport type OpenSubjectsOnActiveDeckOptions = {\n  pivotId?: string;\n  key?: string;\n};\n\n/**\n * Computes the next multi-mode `active` list for {@link LayoutOperation.Open}.\n * If `pivotId` is present and found, truncates the deck after that id.\n * Applies each subject with {@link openEntry}.\n * If the pivot is missing, appends onto the full `active` list.\n *\n * When all subjects are already present in the active deck, the deck is returned\n * unchanged so that pivot truncation does not discard open planks when navigating\n * to something that is already visible.\n */\nexport const openSubjectsOnActiveDeck = (\n  active: readonly string[],\n  subject: readonly string[],\n  options?: OpenSubjectsOnActiveDeckOptions,\n): string[] => {\n  if (subject.length > 0 && subject.every((id) => active.includes(id))) {\n    return [...active];\n  }\n\n  const { pivotId, key } = options ?? {};\n  const pivotIndex = pivotId ? active.findIndex((id) => id === pivotId) : -1;\n  const baseDeck = pivotIndex !== -1 ? active.slice(0, pivotIndex + 1) : [...active];\n  return subject.reduce((acc, entryId) => openEntry(acc, entryId, { key }), baseDeck);\n};\n\nexport const closeEntry = (deck: string[], entryId: string): string[] => {\n  return produce(deck, (draft) => {\n    const index = draft.findIndex((id) => id === entryId);\n    if (index !== -1) {\n      draft.splice(index, 1);\n    }\n  });\n};\n\nexport const incrementPlank = (deck: string[], adjustment: DeckAction.Adjustment): string[] => {\n  return produce(deck, (draft) => {\n    const index = draft.findIndex((id) => id === adjustment.id);\n    if (\n      index === -1 ||\n      (adjustment.type === 'increment-start' && index === 0) ||\n      (adjustment.type === 'increment-end' && index === draft.length - 1)\n    ) {\n      return;\n    }\n\n    if (adjustment.type === 'increment-start') {\n      // Swap the current item with the previous item.\n      [draft[index - 1], draft[index]] = [draft[index], draft[index - 1]];\n    } else if (adjustment.type === 'increment-end') {\n      // Swap the current item with the next item.\n      [draft[index], draft[index + 1]] = [draft[index + 1], draft[index]];\n    }\n  });\n};\n"],
+  "mappings": ";AAIA,SAASA,eAAe;AAYjB,IAAMC,YAAY,CAACC,MAAyBC,SAAiBC,YAAAA;AAClE,SAAOJ,QAAQ;OAAIE;KAAO,CAACG,UAAAA;AACzB,QAAIA,MAAMC,KAAK,CAACC,OAAOA,OAAOJ,OAAAA,GAAU;AACtC;IACF;AAEA,UAAMK,MAAMJ,SAASI;AACrB,QAAIA,KAAK;AACP,YAAMC,QAAQJ,MAAMK,UAAU,CAACH,OAAOA,GAAGI,MAAM,GAAA,EAAK,CAAA,MAAOH,GAAAA;AAC3D,UAAIC,UAAU,IAAI;AAChBJ,cAAMO,OAAOH,OAAO,GAAGN,OAAAA;AACvB;MACF;IACF;AAEAE,UAAMQ,KAAKV,OAAAA;EACb,CAAA;AACF;AAiBO,IAAMW,2BAA2B,CACtCC,QACAC,SACAZ,YAAAA;AAEA,MAAIY,QAAQC,SAAS,KAAKD,QAAQE,MAAM,CAACX,OAAOQ,OAAOI,SAASZ,EAAAA,CAAAA,GAAM;AACpE,WAAO;SAAIQ;;EACb;AAEA,QAAM,EAAEK,SAASZ,IAAG,IAAKJ,WAAW,CAAC;AACrC,QAAMiB,aAAaD,UAAUL,OAAOL,UAAU,CAACH,OAAOA,OAAOa,OAAAA,IAAW;AACxE,QAAME,WAAWD,eAAe,KAAKN,OAAOQ,MAAM,GAAGF,aAAa,CAAA,IAAK;OAAIN;;AAC3E,SAAOC,QAAQQ,OAAO,CAACC,KAAKtB,YAAYF,UAAUwB,KAAKtB,SAAS;IAAEK;EAAI,CAAA,GAAIc,QAAAA;AAC5E;AAEO,IAAMI,aAAa,CAACxB,MAAgBC,YAAAA;AACzC,SAAOH,QAAQE,MAAM,CAACG,UAAAA;AACpB,UAAMI,QAAQJ,MAAMK,UAAU,CAACH,OAAOA,OAAOJ,OAAAA;AAC7C,QAAIM,UAAU,IAAI;AAChBJ,YAAMO,OAAOH,OAAO,CAAA;IACtB;EACF,CAAA;AACF;AAEO,IAAMkB,iBAAiB,CAACzB,MAAgB0B,eAAAA;AAC7C,SAAO5B,QAAQE,MAAM,CAACG,UAAAA;AACpB,UAAMI,QAAQJ,MAAMK,UAAU,CAACH,OAAOA,OAAOqB,WAAWrB,EAAE;AAC1D,QACEE,UAAU,MACTmB,WAAWC,SAAS,qBAAqBpB,UAAU,KACnDmB,WAAWC,SAAS,mBAAmBpB,UAAUJ,MAAMY,SAAS,GACjE;AACA;IACF;AAEA,QAAIW,WAAWC,SAAS,mBAAmB;AAEzC,OAACxB,MAAMI,QAAQ,CAAA,GAAIJ,MAAMI,KAAAA,CAAM,IAAI;QAACJ,MAAMI,KAAAA;QAAQJ,MAAMI,QAAQ,CAAA;;IAClE,WAAWmB,WAAWC,SAAS,iBAAiB;AAE9C,OAACxB,MAAMI,KAAAA,GAAQJ,MAAMI,QAAQ,CAAA,CAAE,IAAI;QAACJ,MAAMI,QAAQ,CAAA;QAAIJ,MAAMI,KAAAA;;IAC9D;EACF,CAAA;AACF;",
+  "names": ["produce", "openEntry", "deck", "entryId", "options", "draft", "find", "id", "key", "index", "findIndex", "split", "splice", "push", "openSubjectsOnActiveDeck", "active", "subject", "length", "every", "includes", "pivotId", "pivotIndex", "baseDeck", "slice", "reduce", "acc", "closeEntry", "incrementPlank", "adjustment", "type"]
+}

package/dist/lib/browser/close-URA766JO.mjs

@@ -0,0 +1,44 @@
+import {
+  closeEntry
+} from "./chunk-ZYYOSX5I.mjs";
+import {
+  computeActiveUpdates
+} from "./chunk-LSZ47AY3.mjs";
+import {
+  updateActiveDeck
+} from "./chunk-GLB73Q6U.mjs";
+import {
+  DeckCapabilities
+} from "./chunk-MARE7ZFK.mjs";
+import "./chunk-J5LGTIGS.mjs";
+
+// src/operations/close.ts
+import * as Effect from "effect/Effect";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { LayoutOperation } from "@dxos/app-toolkit";
+import { Operation } from "@dxos/compute";
+import { AttentionCapabilities } from "@dxos/plugin-attention/types";
+var handler = LayoutOperation.Close.pipe(Operation.withHandler(Effect.fnUntraced(function* (input) {
+  const deck = yield* DeckCapabilities.getDeck();
+  const attention = yield* Capability.get(AttentionCapabilities.Attention);
+  const active = deck.solo ? [
+    deck.solo
+  ] : deck.active;
+  const next = input.subject.reduce((acc, id) => closeEntry(acc, id), active);
+  const { deckUpdates, toAttend } = computeActiveUpdates({
+    next,
+    deck,
+    attention
+  });
+  yield* Capabilities.updateAtomValue(DeckCapabilities.State, (state) => updateActiveDeck(state, deckUpdates));
+  if (toAttend) {
+    yield* Operation.schedule(LayoutOperation.ScrollIntoView, {
+      subject: toAttend
+    });
+  }
+})));
+var close_default = handler;
+export {
+  close_default as default
+};
+//# sourceMappingURL=close-URA766JO.mjs.map

package/dist/lib/browser/close-URA766JO.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/operations/close.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { LayoutOperation } from '@dxos/app-toolkit';\nimport { Operation } from '@dxos/compute';\nimport { AttentionCapabilities } from '@dxos/plugin-attention/types';\n\nimport { closeEntry } from '../layout';\nimport { DeckCapabilities } from '../types';\nimport { computeActiveUpdates } from '../util';\nimport { updateActiveDeck } from './helpers';\n\nconst handler: Operation.WithHandler<typeof LayoutOperation.Close> = LayoutOperation.Close.pipe(\n  Operation.withHandler(\n    Effect.fnUntraced(function* (input) {\n      const deck = yield* DeckCapabilities.getDeck();\n      const attention = yield* Capability.get(AttentionCapabilities.Attention);\n\n      const active = deck.solo ? [deck.solo] : deck.active;\n      const next = input.subject.reduce((acc, id) => closeEntry(acc, id), active);\n      const { deckUpdates, toAttend } = computeActiveUpdates({ next, deck, attention });\n      yield* Capabilities.updateAtomValue(DeckCapabilities.State, (state) => updateActiveDeck(state, deckUpdates));\n\n      if (toAttend) {\n        yield* Operation.schedule(LayoutOperation.ScrollIntoView, { subject: toAttend });\n      }\n    }),\n  ),\n);\n\nexport default handler;\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,cAAcC,kBAAkB;AACzC,SAASC,uBAAuB;AAChC,SAASC,iBAAiB;AAC1B,SAASC,6BAA6B;AAOtC,IAAMC,UAA+DC,gBAAgBC,MAAMC,KACzFC,UAAUC,YACDC,kBAAW,WAAWC,OAAK;AAChC,QAAMC,OAAO,OAAOC,iBAAiBC,QAAO;AAC5C,QAAMC,YAAY,OAAOC,WAAWC,IAAIC,sBAAsBC,SAAS;AAEvE,QAAMC,SAASR,KAAKS,OAAO;IAACT,KAAKS;MAAQT,KAAKQ;AAC9C,QAAME,OAAOX,MAAMY,QAAQC,OAAO,CAACC,KAAKC,OAAOC,WAAWF,KAAKC,EAAAA,GAAKN,MAAAA;AACpE,QAAM,EAAEQ,aAAaC,SAAQ,IAAKC,qBAAqB;IAAER;IAAMV;IAAMG;EAAU,CAAA;AAC/E,SAAOgB,aAAaC,gBAAgBnB,iBAAiBoB,OAAO,CAACC,UAAUC,iBAAiBD,OAAON,WAAAA,CAAAA;AAE/F,MAAIC,UAAU;AACZ,WAAOrB,UAAU4B,SAAS/B,gBAAgBgC,gBAAgB;MAAEd,SAASM;IAAS,CAAA;EAChF;AACF,CAAA,CAAA,CAAA;AAIJ,IAAA,gBAAezB;",
+  "names": ["Effect", "Capabilities", "Capability", "LayoutOperation", "Operation", "AttentionCapabilities", "handler", "LayoutOperation", "Close", "pipe", "Operation", "withHandler", "fnUntraced", "input", "deck", "DeckCapabilities", "getDeck", "attention", "Capability", "get", "AttentionCapabilities", "Attention", "active", "solo", "next", "subject", "reduce", "acc", "id", "closeEntry", "deckUpdates", "toAttend", "computeActiveUpdates", "Capabilities", "updateAtomValue", "State", "state", "updateActiveDeck", "schedule", "ScrollIntoView"]
+}

package/dist/lib/browser/index.mjs

@@ -1,168 +1,138 @@
 import {
-  AppGraphBuilder,
-  CheckAppScheme,
-  DeckSettings,
-  DeckState,
-  LayoutIntentResolver,
-  ReactRoot,
-  ReactSurface,
-  Tools,
-  UrlHandler,
-  useCompanions
-} from "./chunk-7LJDT5OH.mjs";
-import "./chunk-QO3VIMKQ.mjs";
-import {
-  DeckCapabilities
-} from "./chunk-M57WD3V6.mjs";
-import "./chunk-XL7EWOGI.mjs";
-import {
-  DECK_PLUGIN,
-  meta
-} from "./chunk-Z5KITAZW.mjs";
-
-// src/events.ts
-import { Events } from "@dxos/app-framework";
-(function(DeckEvents2) {
-  DeckEvents2.StateReady = Events.createStateEvent(`${DECK_PLUGIN}/state-ready`);
-})(DeckEvents || (DeckEvents = {}));
-var DeckEvents;
+  DeckCapabilities,
+  DeckEvents
+} from "./chunk-MARE7ZFK.mjs";
+import "./chunk-J5LGTIGS.mjs";
 
 // src/DeckPlugin.ts
 import { setAutoFreeze } from "immer";
-import { allOf, Capabilities, contributes, defineModule, definePlugin, Events as Events2, oneOf } from "@dxos/app-framework";
-import { translations as stackTranslations } from "@dxos/react-ui-stack";
-
-// src/translations.ts
-var translations = [
-  {
-    "en-US": {
-      [meta.id]: {
-        "plugin name": "Deck",
-        "main header label": "Main header",
-        "open navigation sidebar label": "Open sidebar",
-        "collapse navigation sidebar label": "Minimize sidebar",
-        "open complementary sidebar label": "Open context sidebar",
-        "close complementary sidebar label": "Minimize context sidebar",
-        "sidebar title": "Navigation sidebar",
-        "complementary sidebar title": "Context sidebar",
-        "plugin error message": "Content failed to render.",
-        "content fallback message": "Unsupported",
-        "content fallback description": "No plugin had a response for the address you navigated\xA0to. Double-check the URL, and ensure you\u2019ve enabled a plugin that supports the\xA0object.",
-        "toggle fullscreen label": "Toggle fullscreen",
-        "settings show hints label": "Show hints",
-        "settings native redirect label": "Enable native url redirect (experimental)",
-        "settings new plank position start label": "Start",
-        "settings new plank position end label": "End",
-        "select new plank positioning placeholder": "Select new plank positioning",
-        "select new plank positioning label": "New plank positioning",
-        "undo available label": "Click to undo previous action.",
-        "undo action label": "Undo",
-        "undo action alt": "Undo previous action",
-        "undo close label": "Dismiss",
-        "error fallback message": "Unable to open this item",
-        "plank heading fallback label": "Untitled",
-        "actions menu label": "Options",
-        "settings deck label": "Disable deck",
-        "pending heading": "Loading\u2026",
-        "insert plank label": "Open",
-        "resize label": "Drag to resize",
-        "pin start label": "Pin to the left sidebar",
-        "pin end label": "Pin to the right sidebar",
-        "increment start label": "Move to the left",
-        "increment end label": "Move to the right",
-        "show deck plank label": "Return to deck",
-        "show solo plank label": "Maximize",
-        "exit fullscreen label": "Exit fullscreen",
-        "show fullscreen plank label": "Fullscreen",
-        "close label": "Close",
-        "minify label": "Minify",
-        "open companion label": "Open companion",
-        "close companion label": "Close companion",
-        "settings overscroll label": "Plank scrolling",
-        "select overscroll placeholder": "Select plank scrolling behavior",
-        "settings overscroll centering label": "Centering",
-        "settings overscroll none label": "None",
-        "settings enable statusbar label": "Show status bar",
-        "settings enable deck label": "Enable Deck",
-        "close current label": "Close current plank",
-        "close others label": "Close other planks",
-        "close all label": "Close all planks",
-        "companion plank heading fallback label": "Related"
-      }
-    }
-  }
-];
-
-// src/DeckPlugin.ts
+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, OperationHandler, ReactRoot, ReactSurface, UrlHandler } from "#capabilities";
+import { meta } from "#meta";
+import { translations } from "#translations";
+import { DeckEvents as DeckEvents2 } from "#types";
 setAutoFreeze(false);
-var DeckPlugin = () => definePlugin(meta, [
-  defineModule({
-    id: `${meta.id}/module/check-app-scheme`,
-    activatesOn: Events2.SettingsReady,
-    activate: CheckAppScheme
+var DeckPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addAppGraphModule({
+    activate: AppGraphBuilder
   }),
-  defineModule({
-    id: `${meta.id}/module/settings`,
-    activatesOn: Events2.SetupSettings,
+  AppPlugin.addOperationHandlerModule({
+    activate: OperationHandler
+  }),
+  AppPlugin.addSurfaceModule({
+    activate: ReactSurface
+  }),
+  AppPlugin.addTranslationsModule({
+    translations: [
+      ...translations,
+      ...stackTranslations
+    ]
+  }),
+  Plugin.addModule({
+    activatesOn: AppActivationEvents.SetupSettings,
+    firesAfterActivation: [
+      DeckEvents2.SettingsReady
+    ],
     activate: DeckSettings
   }),
-  defineModule({
-    id: `${meta.id}/module/layout`,
+  Plugin.addModule({
+    activatesOn: ActivationEvent.allOf(DeckEvents2.SettingsReady, ActivationEvents.OperationInvokerReady),
+    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: oneOf(Events2.SetupSettings, Events2.SetupAppGraph),
-    activatesAfter: [
-      Events2.LayoutReady,
-      DeckEvents.StateReady
+    activatesOn: ActivationEvent.oneOf(AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph),
+    firesAfterActivation: [
+      AppActivationEvents.LayoutReady,
+      DeckEvents2.StateReady
     ],
     activate: DeckState
   }),
-  defineModule({
-    id: `${meta.id}/module/translations`,
-    activatesOn: Events2.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, [
-      ...translations,
-      ...stackTranslations
-    ])
-  }),
-  defineModule({
-    id: `${meta.id}/module/react-root`,
-    activatesOn: Events2.Startup,
+  Plugin.addModule({
+    activatesOn: ActivationEvents.Startup,
     activate: ReactRoot
   }),
-  defineModule({
-    id: `${meta.id}/module/react-surface`,
-    activatesOn: Events2.SetupReactSurface,
-    activate: ReactSurface
-  }),
-  defineModule({
-    id: `${meta.id}/module/layout-intent-resolver`,
-    activatesOn: Events2.SetupIntentResolver,
-    activate: LayoutIntentResolver
-  }),
-  defineModule({
-    id: `${meta.id}/module/app-graph-builder`,
-    activatesOn: Events2.SetupAppGraph,
-    activate: AppGraphBuilder
-  }),
-  defineModule({
-    id: `${meta.id}/module/tools`,
-    activatesOn: Events2.SetupArtifactDefinition,
-    activate: Tools
-  }),
-  defineModule({
-    id: `${meta.id}/module/url`,
-    activatesOn: allOf(Events2.DispatcherReady, DeckEvents.StateReady),
+  // Plugin.addModule({
+  //   activatesOn: Events.SetupArtifactDefinition,
+  //   activate: Tools,
+  // }),
+  Plugin.addModule({
+    activatesOn: ActivationEvent.allOf(ActivationEvents.OperationInvokerReady, DeckEvents2.StateReady),
     activate: UrlHandler
-  })
-]);
+  }),
+  Plugin.make
+);
+
+// src/meta.ts
+import { trim } from "@dxos/util";
+var meta2 = {
+  id: "org.dxos.plugin.deck",
+  name: "Layout",
+  description: trim`
+    Flexible layout system for arranging workspace views in tabs, splits, and panels.
+    Customize your workspace organization with drag-and-drop layout management.
+  `,
+  icon: "ph--layout--regular"
+};
+
+// src/hooks/useBreakpoints.ts
+import { useMediaQuery } from "@dxos/react-ui";
+
+// src/hooks/useCompanions.ts
+import { useMemo } from "react";
+import { useAppGraph } from "@dxos/app-toolkit/ui";
+import { useConnections } from "@dxos/plugin-graph";
+import { byPosition } from "@dxos/util";
+import { PLANK_COMPANION_TYPE } from "#types";
+var useCompanions = (id) => {
+  const { graph } = useAppGraph();
+  const nodes = useConnections(graph, id, "child");
+  const companions = nodes.filter((node) => node.type === PLANK_COMPANION_TYPE);
+  return useMemo(() => companions.toSorted((a, b) => byPosition(a.properties, b.properties)), [
+    companions
+  ]);
+};
+
+// src/hooks/useDeckCompanions.ts
+import { useAppGraph as useAppGraph2 } from "@dxos/app-toolkit/ui";
+import { Node } from "@dxos/plugin-graph";
+import { useConnections as useConnections2 } from "@dxos/plugin-graph";
+import { byPosition as byPosition2 } from "@dxos/util";
+import { DECK_COMPANION_TYPE } from "#types";
+
+// src/hooks/useDeckState.ts
+import { useAtomValue } from "@effect-atom/atom-react";
+import { useCallback, useMemo as useMemo2 } from "react";
+import { Capabilities } from "@dxos/app-framework";
+import { useCapability } from "@dxos/app-framework/ui";
+import { invariant } from "@dxos/invariant";
+import { DeckCapabilities as DeckCapabilities2 } from "#types";
+
+// src/hooks/useHoistStatusbar.ts
+import { useMemo as useMemo3 } from "react";
+import { useAtomCapability } from "@dxos/app-framework/ui";
+import { useThemeContext } from "@dxos/react-ui";
+import { DeckCapabilities as DeckCapabilities3 } from "#types";
+
+// src/hooks/useMainSize.ts
+import { useMainContext } from "@dxos/react-ui";
+
+// src/hooks/useNodeActionExpander.ts
+import { useEffect } from "react";
+import { Graph } from "@dxos/plugin-graph";
+
+// src/hooks/useSelectedCompanion.ts
+import { useMemo as useMemo4 } from "react";
+import { getLinkedVariant } from "@dxos/react-ui-attention";
 export {
-  DECK_PLUGIN,
   DeckCapabilities,
   DeckEvents,
   DeckPlugin,
-  meta,
+  meta2 as meta,
   useCompanions
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/events.ts", "../../../src/DeckPlugin.ts", "../../../src/translations.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Events } from '@dxos/app-framework';\n\nimport { DECK_PLUGIN } from './meta';\n\nexport namespace DeckEvents {\n  export const StateReady = Events.createStateEvent(`${DECK_PLUGIN}/state-ready`);\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { setAutoFreeze } from 'immer';\n\nimport { allOf, Capabilities, contributes, defineModule, definePlugin, Events, oneOf } from '@dxos/app-framework';\nimport { translations as stackTranslations } from '@dxos/react-ui-stack';\n\nimport {\n  AppGraphBuilder,\n  CheckAppScheme,\n  DeckSettings,\n  DeckState,\n  LayoutIntentResolver,\n  ReactRoot,\n  ReactSurface,\n  Tools,\n  UrlHandler,\n} from './capabilities';\nimport { DeckEvents } from './events';\nimport { meta } from './meta';\nimport { translations } from './translations';\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 = () =>\n  definePlugin(meta, [\n    defineModule({\n      id: `${meta.id}/module/check-app-scheme`,\n      activatesOn: Events.SettingsReady,\n      activate: CheckAppScheme,\n    }),\n    defineModule({\n      id: `${meta.id}/module/settings`,\n      activatesOn: Events.SetupSettings,\n      activate: DeckSettings,\n    }),\n    defineModule({\n      id: `${meta.id}/module/layout`,\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: oneOf(Events.SetupSettings, Events.SetupAppGraph),\n      activatesAfter: [Events.LayoutReady, DeckEvents.StateReady],\n      activate: DeckState,\n    }),\n    defineModule({\n      id: `${meta.id}/module/translations`,\n      activatesOn: Events.SetupTranslations,\n      activate: () => contributes(Capabilities.Translations, [...translations, ...stackTranslations]),\n    }),\n    defineModule({\n      id: `${meta.id}/module/react-root`,\n      activatesOn: Events.Startup,\n      activate: ReactRoot,\n    }),\n    defineModule({\n      id: `${meta.id}/module/react-surface`,\n      activatesOn: Events.SetupReactSurface,\n      activate: ReactSurface,\n    }),\n    defineModule({\n      id: `${meta.id}/module/layout-intent-resolver`,\n      activatesOn: Events.SetupIntentResolver,\n      activate: LayoutIntentResolver,\n    }),\n    defineModule({\n      id: `${meta.id}/module/app-graph-builder`,\n      activatesOn: Events.SetupAppGraph,\n      activate: AppGraphBuilder,\n    }),\n    defineModule({\n      id: `${meta.id}/module/tools`,\n      activatesOn: Events.SetupArtifactDefinition,\n      activate: Tools,\n    }),\n    defineModule({\n      id: `${meta.id}/module/url`,\n      activatesOn: allOf(Events.DispatcherReady, DeckEvents.StateReady),\n      activate: UrlHandler,\n    }),\n  ]);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Resource } from '@dxos/react-ui';\n\nimport { meta } from './meta';\n\nexport const translations = [\n  {\n    'en-US': {\n      [meta.id]: {\n        'plugin name': 'Deck',\n        'main header label': 'Main header',\n        'open navigation sidebar label': 'Open sidebar',\n        'collapse navigation sidebar label': 'Minimize sidebar',\n        'open complementary sidebar label': 'Open context sidebar',\n        'close complementary sidebar label': 'Minimize context sidebar',\n        'sidebar title': 'Navigation sidebar',\n        'complementary sidebar title': 'Context sidebar',\n        'plugin error message': 'Content failed to render.',\n        'content fallback message': 'Unsupported',\n        'content fallback description':\n          'No plugin had a response for the address you navigated to. Double-check the URL, and ensure you’ve enabled a plugin that supports the object.',\n        'toggle fullscreen label': 'Toggle fullscreen',\n        'settings show hints label': 'Show hints',\n        'settings native redirect label': 'Enable native url redirect (experimental)',\n        'settings new plank position start label': 'Start',\n        'settings new plank position end label': 'End',\n        'select new plank positioning placeholder': 'Select new plank positioning',\n        'select new plank positioning label': 'New plank positioning',\n        'undo available label': 'Click to undo previous action.',\n        'undo action label': 'Undo',\n        'undo action alt': 'Undo previous action',\n        'undo close label': 'Dismiss',\n        'error fallback message': 'Unable to open this item',\n        'plank heading fallback label': 'Untitled',\n        'actions menu label': 'Options',\n        'settings deck label': 'Disable deck',\n        'pending heading': 'Loading…',\n        'insert plank label': 'Open',\n        'resize label': 'Drag to resize',\n        'pin start label': 'Pin to the left sidebar',\n        'pin end label': 'Pin to the right sidebar',\n        'increment start label': 'Move to the left',\n        'increment end label': 'Move to the right',\n        'show deck plank label': 'Return to deck',\n        'show solo plank label': 'Maximize',\n        'exit fullscreen label': 'Exit fullscreen',\n        'show fullscreen plank label': 'Fullscreen',\n        'close label': 'Close',\n        'minify label': 'Minify',\n        'open companion label': 'Open companion',\n        'close companion label': 'Close companion',\n        'settings overscroll label': 'Plank scrolling',\n        'select overscroll placeholder': 'Select plank scrolling behavior',\n        'settings overscroll centering label': 'Centering',\n        'settings overscroll none label': 'None',\n        'settings enable statusbar label': 'Show status bar',\n        'settings enable deck label': 'Enable Deck',\n        'close current label': 'Close current plank',\n        'close others label': 'Close other planks',\n        'close all label': 'Close all planks',\n        'companion plank heading fallback label': 'Related',\n      },\n    },\n  },\n] as const satisfies Resource[];\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAIA,SAASA,cAAc;UAINC,aAAAA;cACFC,aAAaC,OAAOC,iBAAiB,GAAGC,WAAAA,cAAyB;AAChF,GAFiBJ,eAAAA,aAAAA,CAAAA,EAAAA;;;;ACJjB,SAASK,qBAAqB;AAE9B,SAASC,OAAOC,cAAcC,aAAaC,cAAcC,cAAcC,UAAAA,SAAQC,aAAa;AAC5F,SAASC,gBAAgBC,yBAAyB;;;ACC3C,IAAMC,eAAe;EAC1B;IACE,SAAS;MACP,CAACC,KAAKC,EAAE,GAAG;QACT,eAAe;QACf,qBAAqB;QACrB,iCAAiC;QACjC,qCAAqC;QACrC,oCAAoC;QACpC,qCAAqC;QACrC,iBAAiB;QACjB,+BAA+B;QAC/B,wBAAwB;QACxB,4BAA4B;QAC5B,gCACE;QACF,2BAA2B;QAC3B,6BAA6B;QAC7B,kCAAkC;QAClC,2CAA2C;QAC3C,yCAAyC;QACzC,4CAA4C;QAC5C,sCAAsC;QACtC,wBAAwB;QACxB,qBAAqB;QACrB,mBAAmB;QACnB,oBAAoB;QACpB,0BAA0B;QAC1B,gCAAgC;QAChC,sBAAsB;QACtB,uBAAuB;QACvB,mBAAmB;QACnB,sBAAsB;QACtB,gBAAgB;QAChB,mBAAmB;QACnB,iBAAiB;QACjB,yBAAyB;QACzB,uBAAuB;QACvB,yBAAyB;QACzB,yBAAyB;QACzB,yBAAyB;QACzB,+BAA+B;QAC/B,eAAe;QACf,gBAAgB;QAChB,wBAAwB;QACxB,yBAAyB;QACzB,6BAA6B;QAC7B,iCAAiC;QACjC,uCAAuC;QACvC,kCAAkC;QAClC,mCAAmC;QACnC,8BAA8B;QAC9B,uBAAuB;QACvB,sBAAsB;QACtB,mBAAmB;QACnB,0CAA0C;MAC5C;IACF;EACF;;;;ADvCFC,cAAc,KAAA;AAEP,IAAMC,aAAa,MACxBC,aAAaC,MAAM;EACjBC,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAOC;IACpBC,UAAUC;EACZ,CAAA;EACAN,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAOI;IACpBF,UAAUG;EACZ,CAAA;EACAR,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;;;;IAIdC,aAAaO,MAAMN,QAAOI,eAAeJ,QAAOO,aAAa;IAC7DC,gBAAgB;MAACR,QAAOS;MAAaC,WAAWC;;IAChDT,UAAUU;EACZ,CAAA;EACAf,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAOa;IACpBX,UAAU,MAAMY,YAAYC,aAAaC,cAAc;SAAIC;SAAiBC;KAAkB;EAChG,CAAA;EACArB,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAOmB;IACpBjB,UAAUkB;EACZ,CAAA;EACAvB,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAOqB;IACpBnB,UAAUoB;EACZ,CAAA;EACAzB,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAOuB;IACpBrB,UAAUsB;EACZ,CAAA;EACA3B,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAOO;IACpBL,UAAUuB;EACZ,CAAA;EACA5B,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAaC,QAAO0B;IACpBxB,UAAUyB;EACZ,CAAA;EACA9B,aAAa;IACXC,IAAI,GAAGF,KAAKE,EAAE;IACdC,aAAa6B,MAAM5B,QAAO6B,iBAAiBnB,WAAWC,UAAU;IAChET,UAAU4B;EACZ,CAAA;CACD;",
-  "names": ["Events", "DeckEvents", "StateReady", "Events", "createStateEvent", "DECK_PLUGIN", "setAutoFreeze", "allOf", "Capabilities", "contributes", "defineModule", "definePlugin", "Events", "oneOf", "translations", "stackTranslations", "translations", "meta", "id", "setAutoFreeze", "DeckPlugin", "definePlugin", "meta", "defineModule", "id", "activatesOn", "Events", "SettingsReady", "activate", "CheckAppScheme", "SetupSettings", "DeckSettings", "oneOf", "SetupAppGraph", "activatesAfter", "LayoutReady", "DeckEvents", "StateReady", "DeckState", "SetupTranslations", "contributes", "Capabilities", "Translations", "translations", "stackTranslations", "Startup", "ReactRoot", "SetupReactSurface", "ReactSurface", "SetupIntentResolver", "LayoutIntentResolver", "AppGraphBuilder", "SetupArtifactDefinition", "Tools", "allOf", "DispatcherReady", "UrlHandler"]
+  "sources": ["../../../src/DeckPlugin.ts", "../../../src/meta.ts", "../../../src/hooks/useBreakpoints.ts", "../../../src/hooks/useCompanions.ts", "../../../src/hooks/useDeckCompanions.ts", "../../../src/hooks/useDeckState.ts", "../../../src/hooks/useHoistStatusbar.ts", "../../../src/hooks/useMainSize.ts", "../../../src/hooks/useNodeActionExpander.ts", "../../../src/hooks/useSelectedCompanion.ts"],
+  "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  OperationHandler,\n  ReactRoot,\n  ReactSurface,\n  UrlHandler,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { DeckEvents } from '#types';\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.OperationInvokerReady),\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.OperationInvokerReady, DeckEvents.StateReady),\n    activate: UrlHandler,\n  }),\n  Plugin.make,\n);\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n  id: 'org.dxos.plugin.deck',\n  name: 'Layout',\n  description: trim`\n    Flexible layout system for arranging workspace views in tabs, splits, and panels.\n    Customize your workspace organization with drag-and-drop layout management.\n  `,\n  icon: 'ph--layout--regular',\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useMediaQuery } from '@dxos/react-ui';\n\nexport const useBreakpoints = () => {\n  const [isNotMobile] = useMediaQuery('md');\n  const [isDesktop] = useMediaQuery('lg');\n  return isDesktop ? 'desktop' : isNotMobile ? 'tablet' : 'mobile';\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { useAppGraph } from '@dxos/app-toolkit/ui';\nimport { useConnections } from '@dxos/plugin-graph';\nimport { byPosition } from '@dxos/util';\n\nimport { PLANK_COMPANION_TYPE } from '#types';\n\nexport const useCompanions = (id?: string) => {\n  const { graph } = useAppGraph();\n  const nodes = useConnections(graph, id, 'child');\n  const companions = nodes.filter((node) => node.type === PLANK_COMPANION_TYPE);\n  return useMemo(() => companions.toSorted((a, b) => byPosition(a.properties, b.properties)), [companions]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useAppGraph } from '@dxos/app-toolkit/ui';\nimport { Node, type Node as NodeType } from '@dxos/plugin-graph';\nimport { useConnections } from '@dxos/plugin-graph';\nimport { type Label } from '@dxos/ui-types/translations';\nimport { type Position, byPosition } from '@dxos/util';\n\nimport { DECK_COMPANION_TYPE } from '#types';\n\nexport type DeckCompanion = NodeType.Node<\n  any,\n  {\n    label: Label;\n    icon: string;\n    // TODO(burdon): Scroll area should be controlled by surface.\n    /** If true, the panel will not be wrapped in a scroll area. */\n    fixed?: boolean;\n    position?: Position;\n    joyride?: string;\n  }\n>;\n\nexport const useDeckCompanions = (): DeckCompanion[] => {\n  const { graph } = useAppGraph();\n  const connections = useConnections(graph, Node.RootId, 'child');\n  const companions = connections.filter((node) => node.type === DECK_COMPANION_TYPE) as DeckCompanion[];\n  return companions.toSorted((a, b) => byPosition(a.properties, b.properties));\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useAtomValue } from '@effect-atom/atom-react';\nimport { useCallback, useMemo } from 'react';\n\nimport { Capabilities } from '@dxos/app-framework';\nimport { useCapability } from '@dxos/app-framework/ui';\nimport { invariant } from '@dxos/invariant';\n\nimport {\n  DeckCapabilities,\n  type EphemeralDeckState,\n  type DeckPluginState,\n  type DeckState,\n  type StoredDeckState,\n} from '#types';\n\nexport type DeckStateHook = {\n  /** Combined state value (reactive). Includes both persisted and ephemeral state. */\n  state: DeckPluginState;\n  /** The active deck, computed from decks[activeDeck]. */\n  deck: DeckState;\n  /** Update persisted state. */\n  updateState: (fn: (current: StoredDeckState) => StoredDeckState) => void;\n  /** Update ephemeral state. */\n  updateEphemeral: (fn: (current: EphemeralDeckState) => EphemeralDeckState) => void;\n};\n\n/**\n * Hook to access the deck plugin state reactively.\n * Returns the combined state, the active deck, and update functions for each atom.\n */\nexport const useDeckState = (): DeckStateHook => {\n  const registry = useCapability(Capabilities.AtomRegistry);\n  const stateAtom = useCapability(DeckCapabilities.State);\n  const ephemeralAtom = useCapability(DeckCapabilities.EphemeralState);\n  const persistedState = useAtomValue(stateAtom);\n  const ephemeralState = useAtomValue(ephemeralAtom);\n\n  // Compute deck from decks[activeDeck] to ensure it's always current.\n  const deck = useMemo(() => {\n    const deck = persistedState.decks[persistedState.activeDeck];\n    invariant(deck, `Deck not found: ${persistedState.activeDeck}`);\n    return deck;\n  }, [persistedState.decks, persistedState.activeDeck]);\n\n  // Combine persisted and ephemeral state into a unified view.\n  const state = useMemo(\n    (): DeckPluginState => ({\n      ...persistedState,\n      ...ephemeralState,\n    }),\n    [persistedState, ephemeralState],\n  );\n\n  const updateState = useCallback(\n    (fn: (current: StoredDeckState) => StoredDeckState) => {\n      registry.set(stateAtom, fn(registry.get(stateAtom)));\n    },\n    [registry, stateAtom],\n  );\n\n  const updateEphemeral = useCallback(\n    (fn: (current: EphemeralDeckState) => EphemeralDeckState) => {\n      registry.set(ephemeralAtom, fn(registry.get(ephemeralAtom)));\n    },\n    [registry, ephemeralAtom],\n  );\n\n  return useMemo(() => ({ state, deck, updateState, updateEphemeral }), [state, deck, updateState, updateEphemeral]);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { useAtomCapability } from '@dxos/app-framework/ui';\nimport { useThemeContext } from '@dxos/react-ui';\n\nimport { DeckCapabilities, type LayoutMode } from '#types';\n\nexport const useHoistStatusbar = (breakpoint: string, layoutMode?: LayoutMode): boolean => {\n  const { safeAreaPadding } = useThemeContext();\n  const enableStatusbar = useAtomCapability(DeckCapabilities.Settings).enableStatusbar;\n\n  return useMemo(() => {\n    return (\n      breakpoint === 'desktop' &&\n      layoutMode !== 'solo--fullscreen' &&\n      !!enableStatusbar &&\n      safeAreaPadding?.bottom === 0\n    );\n  }, [enableStatusbar, breakpoint, safeAreaPadding?.bottom, layoutMode]);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useMainContext } from '@dxos/react-ui';\n\nexport const useMainSize = () => {\n  const { navigationSidebarState, complementarySidebarState } = useMainContext('DeckPluginPlank');\n  return {\n    'data-sidebar-left-state': navigationSidebarState,\n    'data-sidebar-right-state': complementarySidebarState,\n  };\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect } from 'react';\n\nimport { Graph, type Node } from '@dxos/plugin-graph';\n\nexport const useNodeActionExpander = (node?: Node.Node) => {\n  useEffect(() => {\n    if (node) {\n      const frame = requestAnimationFrame(() => {\n        const graph = Graph.getGraph(node);\n        void Graph.expand(graph, node.id, 'action');\n      });\n      return () => cancelAnimationFrame(frame);\n    }\n  }, [node]);\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { type Node } from '@dxos/plugin-graph';\nimport { getLinkedVariant } from '@dxos/react-ui-attention';\n\n/**\n * Resolves which companion to show based on variant preference.\n * Falls back to first available if preferred variant not found.\n */\nexport const useSelectedCompanion = (companions: Node.Node[], preferredVariant?: string) => {\n  return useMemo(() => {\n    if (companions.length === 0) {\n      return { companionId: undefined, variant: undefined };\n    }\n\n    // Try to find companion matching the preferred variant.\n    if (preferredVariant) {\n      const preferred = companions.find((companion) => getLinkedVariant(companion.id) === preferredVariant);\n      if (preferred) {\n        return { companionId: preferred.id, variant: getLinkedVariant(preferred.id) };\n      }\n    }\n\n    // Fallback to first companion.\n    const first = companions[0];\n    return { companionId: first.id, variant: getLinkedVariant(first.id) };\n  }, [companions, preferredVariant]);\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,kBACAC,WACAC,cACAC,kBACK;AACP,SAASC,YAAY;AACrB,SAASV,oBAAoB;AAC7B,SAASW,cAAAA,mBAAkB;AAK3BjB,cAAc,KAAA;AAEP,IAAMkB,aAAaf,OAAOgB,OAAOH,IAAAA,EAAMI;EAC5Cf,UAAUgB,kBAAkB;IAAEC,UAAUd;EAAgB,CAAA;EACxDH,UAAUkB,0BAA0B;IAAED,UAAUV;EAAiB,CAAA;EACjEP,UAAUmB,iBAAiB;IAAEF,UAAUR;EAAa,CAAA;EACpDT,UAAUoB,sBAAsB;IAAEnB,cAAc;SAAIA;SAAiBC;;EAAmB,CAAA;EACxFJ,OAAOuB,UAAU;IACfC,aAAavB,oBAAoBwB;IACjCC,sBAAsB;MAACZ,YAAWa;;IAClCR,UAAUZ;EACZ,CAAA;EACAP,OAAOuB,UAAU;IACfC,aAAa1B,gBAAgB8B,MAAMd,YAAWa,eAAe5B,iBAAiB8B,qBAAqB;IACnGV,UAAUb;EACZ,CAAA;EACAN,OAAOuB,UAAU;;;;IAIfC,aAAa1B,gBAAgBgC,MAAM7B,oBAAoBwB,eAAexB,oBAAoB8B,aAAa;IACvGL,sBAAsB;MAACzB,oBAAoB+B;MAAalB,YAAWmB;;IACnEd,UAAUX;EACZ,CAAA;EACAR,OAAOuB,UAAU;IACfC,aAAazB,iBAAiBmC;IAC9Bf,UAAUT;EACZ,CAAA;;;;;EAKAV,OAAOuB,UAAU;IACfC,aAAa1B,gBAAgB8B,MAAM7B,iBAAiB8B,uBAAuBf,YAAWmB,UAAU;IAChGd,UAAUP;EACZ,CAAA;EACAZ,OAAOmC;AAAI;;;AC1Db,SAASC,YAAY;AAEd,IAAMC,QAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,aAAaJ;;;;EAIbK,MAAM;AACR;;;ACXA,SAASC,qBAAqB;;;ACA9B,SAASC,eAAe;AAExB,SAASC,mBAAmB;AAC5B,SAASC,sBAAsB;AAC/B,SAASC,kBAAkB;AAE3B,SAASC,4BAA4B;AAE9B,IAAMC,gBAAgB,CAACC,OAAAA;AAC5B,QAAM,EAAEC,MAAK,IAAKN,YAAAA;AAClB,QAAMO,QAAQN,eAAeK,OAAOD,IAAI,OAAA;AACxC,QAAMG,aAAaD,MAAME,OAAO,CAACC,SAASA,KAAKC,SAASR,oBAAAA;AACxD,SAAOJ,QAAQ,MAAMS,WAAWI,SAAS,CAACC,GAAGC,MAAMZ,WAAWW,EAAEE,YAAYD,EAAEC,UAAU,CAAA,GAAI;IAACP;GAAW;AAC1G;;;ACbA,SAASQ,eAAAA,oBAAmB;AAC5B,SAASC,YAAmC;AAC5C,SAASC,kBAAAA,uBAAsB;AAE/B,SAAwBC,cAAAA,mBAAkB;AAE1C,SAASC,2BAA2B;;;ACNpC,SAASC,oBAAoB;AAC7B,SAASC,aAAaC,WAAAA,gBAAe;AAErC,SAASC,oBAAoB;AAC7B,SAASC,qBAAqB;AAC9B,SAASC,iBAAiB;AAE1B,SACEC,oBAAAA,yBAKK;;;ACbP,SAASC,WAAAA,gBAAe;AAExB,SAASC,yBAAyB;AAClC,SAASC,uBAAuB;AAEhC,SAASC,oBAAAA,yBAAyC;;;ACLlD,SAASC,sBAAsB;;;ACA/B,SAASC,iBAAiB;AAE1B,SAASC,aAAwB;;;ACFjC,SAASC,WAAAA,gBAAe;AAGxB,SAASC,wBAAwB;",
+  "names": ["setAutoFreeze", "ActivationEvent", "ActivationEvents", "Plugin", "AppActivationEvents", "AppPlugin", "translations", "stackTranslations", "AppGraphBuilder", "CheckAppScheme", "DeckSettings", "DeckState", "OperationHandler", "ReactRoot", "ReactSurface", "UrlHandler", "meta", "DeckEvents", "DeckPlugin", "define", "pipe", "addAppGraphModule", "activate", "addOperationHandlerModule", "addSurfaceModule", "addTranslationsModule", "addModule", "activatesOn", "SetupSettings", "firesAfterActivation", "SettingsReady", "allOf", "OperationInvokerReady", "oneOf", "SetupAppGraph", "LayoutReady", "StateReady", "Startup", "make", "trim", "meta", "id", "name", "description", "icon", "useMediaQuery", "useMemo", "useAppGraph", "useConnections", "byPosition", "PLANK_COMPANION_TYPE", "useCompanions", "id", "graph", "nodes", "companions", "filter", "node", "type", "toSorted", "a", "b", "properties", "useAppGraph", "Node", "useConnections", "byPosition", "DECK_COMPANION_TYPE", "useAtomValue", "useCallback", "useMemo", "Capabilities", "useCapability", "invariant", "DeckCapabilities", "useMemo", "useAtomCapability", "useThemeContext", "DeckCapabilities", "useMainContext", "useEffect", "Graph", "useMemo", "getLinkedVariant"]
 }