@dxos/plugin-deck 0.8.4-main.4a85c3132b → 0.8.4-main.51f1e5ca51

package/dist/lib/browser/{chunk-SKBPLX5T.mjs → chunk-ZYYOSX5I.mjs}

@@ -1,23 +1,13 @@
 // src/layout.ts
 import { produce } from "immer";
-import { ATTENDABLE_PATH_SEPARATOR } from "@dxos/react-ui-attention";
-var createEntryId = (entryId, variant) => variant ? `${entryId}${ATTENDABLE_PATH_SEPARATOR}${variant}` : entryId;
-var parseEntryId = (entryId) => {
-  const [id, variant] = entryId.split(ATTENDABLE_PATH_SEPARATOR);
-  return {
-    id,
-    variant
-  };
-};
-var openEntry = (deck, _entryId, options) => {
-  return produce(deck, (draft) => {
-    const entryId = createEntryId(_entryId, options?.variant);
+var openEntry = (deck, entryId, options) => {
+  return produce([
+    ...deck
+  ], (draft) => {
     if (draft.find((id) => id === entryId)) {
       return;
     }
     const key = options?.key;
-    const plankPositioning = options?.positioning ?? "start";
-    const pivotId = options?.pivotId;
     if (key) {
       const index = draft.findIndex((id) => id.split("+")[0] === key);
       if (index !== -1) {
@@ -25,24 +15,24 @@ var openEntry = (deck, _entryId, options) => {
         return;
       }
     }
-    if (pivotId) {
-      const pivotIndex = draft.findIndex((id) => id === pivotId);
-      if (pivotIndex !== -1) {
-        if (plankPositioning === "start") {
-          draft.splice(pivotIndex, 0, entryId);
-        } else {
-          draft.splice(pivotIndex + 1, 0, entryId);
-        }
-        return;
-      }
-    }
-    if (plankPositioning === "start") {
-      draft.unshift(entryId);
-    } else {
-      draft.push(entryId);
-    }
+    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);
@@ -72,10 +62,8 @@ var incrementPlank = (deck, adjustment) => {
 };
 
 export {
-  createEntryId,
-  parseEntryId,
-  openEntry,
+  openSubjectsOnActiveDeck,
   closeEntry,
   incrementPlank
 };
-//# sourceMappingURL=chunk-SKBPLX5T.mjs.map
+//# 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,129 +1,25 @@
-import {
-  useCompanions
-} from "./chunk-Q4GUCIRE.mjs";
-import "./chunk-SKBPLX5T.mjs";
 import {
   DeckCapabilities,
   DeckEvents
-} from "./chunk-OAPMV5ZR.mjs";
-import {
-  meta
-} from "./chunk-FBL4WVYZ.mjs";
+} from "./chunk-MARE7ZFK.mjs";
+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";
-
-// src/capabilities/app-graph-builder/index.ts
-import { Capability } from "@dxos/app-framework";
-var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("./app-graph-builder-22XAL7YE.mjs"));
-
-// src/capabilities/check-app-scheme/index.ts
-import { Capability as Capability2 } from "@dxos/app-framework";
-var CheckAppScheme = Capability2.lazy("CheckAppScheme", () => import("./check-app-scheme-ZV3QWNNZ.mjs"));
-
-// src/capabilities/operation-resolver/index.ts
-import { Capability as Capability$ } from "@dxos/app-framework";
-var LayoutOperationResolver = Capability$.lazy("LayoutOperationResolver", () => import("./operation-resolver-BLZGJWLO.mjs"));
-
-// src/capabilities/react-root/index.ts
-import { Capability as Capability3 } from "@dxos/app-framework";
-var ReactRoot = Capability3.lazy("ReactRoot", () => import("./react-root-4ESZAM6D.mjs"));
-
-// src/capabilities/react-surface/index.ts
-import { Capability as Capability4 } from "@dxos/app-framework";
-var ReactSurface = Capability4.lazy("ReactSurface", () => import("./react-surface-KYQGCALN.mjs"));
-
-// src/capabilities/settings/index.ts
-import { Capability as Capability5 } from "@dxos/app-framework";
-var DeckSettings = Capability5.lazy("DeckSettings", () => import("./settings-RY2TBSGP.mjs"));
-
-// src/capabilities/state/index.ts
-import { Capability as Capability6 } from "@dxos/app-framework";
-var DeckState = Capability6.lazy("DeckState", () => import("./state-CSTTMJ43.mjs"));
-
-// src/capabilities/toolkit/index.ts
-import { Capability as Capability7 } from "@dxos/app-framework";
-var Toolkit = Capability7.lazy("Toolkit", () => import("./toolkit-EONRPYA5.mjs"));
-
-// src/capabilities/url-handler/index.ts
-import { Capability as Capability8 } from "@dxos/app-framework";
-var UrlHandler = Capability8.lazy("UrlHandler", () => import("./url-handler-EM3SYHHX.mjs"));
-
-// src/translations.ts
-var translations = [
-  {
-    "en-US": {
-      [meta.id]: {
-        "plugin name": "Deck",
-        "settings title": "Deck settings",
-        "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 object",
-        "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",
-        "settings encapsulated planks label": "Encapsulated planks",
-        "close current label": "Close current plank",
-        "close others label": "Close other planks",
-        "close all label": "Close all planks",
-        "companion plank heading fallback label": "Related",
-        "open item label": "Open"
-      }
-    }
-  }
-];
-
-// src/DeckPlugin.ts
+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 = Plugin.define(meta).pipe(
   AppPlugin.addAppGraphModule({
     activate: AppGraphBuilder
   }),
-  AppPlugin.addOperationResolverModule({
-    activate: LayoutOperationResolver
+  AppPlugin.addOperationHandlerModule({
+    activate: OperationHandler
   }),
   AppPlugin.addSurfaceModule({
     activate: ReactSurface
@@ -136,13 +32,13 @@ var DeckPlugin = Plugin.define(meta).pipe(
   }),
   Plugin.addModule({
     activatesOn: AppActivationEvents.SetupSettings,
-    activatesAfter: [
-      DeckEvents.SettingsReady
+    firesAfterActivation: [
+      DeckEvents2.SettingsReady
     ],
     activate: DeckSettings
   }),
   Plugin.addModule({
-    activatesOn: DeckEvents.SettingsReady,
+    activatesOn: ActivationEvent.allOf(DeckEvents2.SettingsReady, ActivationEvents.OperationInvokerReady),
     activate: CheckAppScheme
   }),
   Plugin.addModule({
@@ -150,9 +46,9 @@ var DeckPlugin = Plugin.define(meta).pipe(
     //   Should this be a different event?
     //   Should settings store be renamed to be more generic?
     activatesOn: ActivationEvent.oneOf(AppActivationEvents.SetupSettings, AppActivationEvents.SetupAppGraph),
-    activatesAfter: [
+    firesAfterActivation: [
       AppActivationEvents.LayoutReady,
-      DeckEvents.StateReady
+      DeckEvents2.StateReady
     ],
     activate: DeckState
   }),
@@ -165,21 +61,78 @@ var DeckPlugin = Plugin.define(meta).pipe(
   //   activate: Tools,
   // }),
   Plugin.addModule({
-    // TODO(wittjosiah): Shouldn't use the startup event.
-    activatesOn: ActivationEvents.Startup,
-    activate: Toolkit
-  }),
-  Plugin.addModule({
-    activatesOn: ActivationEvent.allOf(ActivationEvents.OperationInvokerReady, DeckEvents.StateReady),
+    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 {
   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/DeckPlugin.ts", "../../../src/capabilities/app-graph-builder/index.ts", "../../../src/capabilities/check-app-scheme/index.ts", "../../../src/capabilities/operation-resolver/index.ts", "../../../src/capabilities/react-root/index.ts", "../../../src/capabilities/react-surface/index.ts", "../../../src/capabilities/settings/index.ts", "../../../src/capabilities/state/index.ts", "../../../src/capabilities/toolkit/index.ts", "../../../src/capabilities/url-handler/index.ts", "../../../src/translations.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';\n\nimport {\n  AppGraphBuilder,\n  CheckAppScheme,\n  DeckSettings,\n  DeckState,\n  LayoutOperationResolver,\n  ReactRoot,\n  ReactSurface,\n  Toolkit,\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.addOperationResolverModule({ activate: LayoutOperationResolver }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations: [...translations, ...stackTranslations] }),\n  Plugin.addModule({\n    activatesOn: AppActivationEvents.SetupSettings,\n    activatesAfter: [DeckEvents.SettingsReady],\n    activate: DeckSettings,\n  }),\n  Plugin.addModule({\n    activatesOn: DeckEvents.SettingsReady,\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    activatesAfter: [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    // TODO(wittjosiah): Shouldn't use the startup event.\n    activatesOn: ActivationEvents.Startup,\n    activate: Toolkit,\n  }),\n  Plugin.addModule({\n    activatesOn: ActivationEvent.allOf(ActivationEvents.OperationInvokerReady, DeckEvents.StateReady),\n    activate: UrlHandler,\n  }),\n  Plugin.make,\n);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const CheckAppScheme = Capability.lazy('CheckAppScheme', () => import('./check-app-scheme'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Capability, Capability as Capability$ } from '@dxos/app-framework';\n\nexport const LayoutOperationResolver: Capability.LazyCapability = Capability$.lazy(\n  'LayoutOperationResolver',\n  () => import('./operation-resolver'),\n);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const ReactRoot = Capability.lazy('ReactRoot', () => import('./react-root'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const DeckSettings = Capability.lazy('DeckSettings', () => import('./settings'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const DeckState = Capability.lazy('DeckState', () => import('./state'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const Toolkit = Capability.lazy('Toolkit', () => import('./toolkit'));\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const UrlHandler = Capability.lazy('UrlHandler', () => import('./url-handler'));\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        'settings title': 'Deck settings',\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 object',\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        'settings encapsulated planks label': 'Encapsulated planks',\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        'open item label': 'Open',\n      },\n    },\n  },\n] as const satisfies Resource[];\n"],
-  "mappings": "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",
-  "names": ["setAutoFreeze", "ActivationEvent", "ActivationEvents", "Plugin", "AppActivationEvents", "AppPlugin", "translations", "stackTranslations", "Capability", "AppGraphBuilder", "Capability", "lazy", "Capability", "CheckAppScheme", "Capability", "lazy", "Capability", "Capability$", "LayoutOperationResolver", "Capability$", "lazy", "Capability", "ReactRoot", "Capability", "lazy", "Capability", "ReactSurface", "Capability", "lazy", "Capability", "DeckSettings", "Capability", "lazy", "Capability", "DeckState", "Capability", "lazy", "Capability", "Toolkit", "Capability", "lazy", "Capability", "UrlHandler", "Capability", "lazy", "translations", "meta", "id", "setAutoFreeze", "DeckPlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addAppGraphModule", "activate", "AppGraphBuilder", "addOperationResolverModule", "LayoutOperationResolver", "addSurfaceModule", "ReactSurface", "addTranslationsModule", "translations", "stackTranslations", "addModule", "activatesOn", "AppActivationEvents", "SetupSettings", "activatesAfter", "DeckEvents", "SettingsReady", "DeckSettings", "CheckAppScheme", "ActivationEvent", "oneOf", "SetupAppGraph", "LayoutReady", "StateReady", "DeckState", "ActivationEvents", "Startup", "ReactRoot", "Toolkit", "allOf", "OperationInvokerReady", "UrlHandler", "make"]
+  "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"]
 }