@dxos/plugin-deck 0.8.4-main.406dc2a → 0.8.4-main.4a85c3132b

package/dist/lib/browser/{chunk-7I6H3N4Q.mjs → chunk-OAPMV5ZR.mjs}

@@ -1,10 +1,46 @@
 import {
   meta
-} from "./chunk-MHP4GPX5.mjs";
+} from "./chunk-FBL4WVYZ.mjs";
+
+// src/types/capabilities.ts
+import * as Effect from "effect/Effect";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-deck/src/types/capabilities.ts";
+(function(DeckCapabilities2) {
+  DeckCapabilities2.Settings = Capability.make(`${meta.id}/capability/settings`);
+  DeckCapabilities2.State = Capability.make(`${meta.id}/capability/state`);
+  DeckCapabilities2.EphemeralState = Capability.make(`${meta.id}/capability/ephemeral-state`);
+  DeckCapabilities2.getDeck = () => Effect.gen(function* () {
+    const state = yield* Capabilities.getAtomValue(DeckCapabilities2.State);
+    const deck = state.decks[state.activeDeck];
+    invariant(deck, `Deck not found: ${state.activeDeck}`, {
+      F: __dxlog_file,
+      L: 30,
+      S: this,
+      A: [
+        "deck",
+        "`Deck not found: ${state.activeDeck}`"
+      ]
+    });
+    return deck;
+  });
+})(DeckCapabilities || (DeckCapabilities = {}));
+var DeckCapabilities;
+
+// src/types/events.ts
+import { AppActivationEvents } from "@dxos/app-toolkit";
+(function(DeckEvents2) {
+  DeckEvents2.StateReady = AppActivationEvents.createStateEvent(`${meta.id}/state-ready`);
+  DeckEvents2.SettingsReady = AppActivationEvents.createSettingsEvent(DeckCapabilities.Settings.identifier);
+})(DeckEvents || (DeckEvents = {}));
+var DeckEvents;
 
 // src/types/schema.ts
 import * as Schema from "effect/Schema";
-import { LayoutAction } from "@dxos/app-framework";
+import { Capability as Capability2 } from "@dxos/app-framework";
+import { Label, LayoutOperation } from "@dxos/app-toolkit";
+import { Operation } from "@dxos/operation";
 import { ATTENDABLE_PATH_SEPARATOR } from "@dxos/react-ui-attention";
 var PLANK_COMPANION_TYPE = `${meta.id}/plank-companion`;
 var DECK_COMPANION_TYPE = `${meta.id}/deck-companion`;
@@ -12,7 +48,7 @@ var NewPlankPositions = [
   "start",
   "end"
 ];
-var OverscrollOptions = [
+var OverScrollToProps = [
   "none",
   "centering"
 ];
@@ -22,7 +58,7 @@ var DeckSettingsSchema = Schema.Struct({
   enableStatusbar: Schema.optional(Schema.Boolean),
   enableNativeRedirect: Schema.optional(Schema.Boolean),
   newPlankPositioning: Schema.optional(Schema.Literal(...NewPlankPositions)),
-  overscroll: Schema.optional(Schema.Literal(...OverscrollOptions)),
+  overscroll: Schema.optional(Schema.Literal(...OverScrollToProps)),
   // TODO(burdon): Rename layoutMode? (e.g., bento | encapsulated?)
   encapsulatedPlanks: Schema.optional(Schema.Boolean)
 }).pipe(Schema.mutable);
@@ -34,11 +70,8 @@ var DeckState = Schema.Struct({
   /** If false, the deck has not yet left solo mode and new planks should be soloed. */
   initialized: Schema.Boolean,
   active: Schema.mutable(Schema.Array(Schema.String)),
-  // TODO(wittjosiah): Piping into both mutable and optional caused invalid typescript output.
-  activeCompanions: Schema.optional(Schema.mutable(Schema.Record({
-    key: Schema.String,
-    value: Schema.String
-  }))),
+  companionOpen: Schema.Boolean,
+  companionVariant: Schema.optional(Schema.String),
   inactive: Schema.mutable(Schema.Array(Schema.String)),
   solo: Schema.optional(Schema.String),
   fullscreen: Schema.Boolean,
@@ -48,7 +81,8 @@ var DeckState = Schema.Struct({
 var defaultDeck = {
   initialized: false,
   active: [],
-  activeCompanions: {},
+  companionOpen: false,
+  companionVariant: void 0,
   inactive: [],
   solo: void 0,
   fullscreen: false,
@@ -63,10 +97,22 @@ var getMode = (deck) => {
   }
   return "deck";
 };
-var DeckPluginState = Schema.Struct({
+var DeckStateSchema = Schema.Struct({
   sidebarState: Schema.Literal("closed", "collapsed", "expanded"),
   complementarySidebarState: Schema.Literal("closed", "collapsed", "expanded"),
   complementarySidebarPanel: Schema.optional(Schema.String),
+  activeDeck: Schema.String,
+  previousDeck: Schema.String,
+  decks: Schema.mutable(Schema.Record({
+    key: Schema.String,
+    value: Schema.mutable(DeckState)
+  })),
+  previousMode: Schema.mutable(Schema.Record({
+    key: Schema.String,
+    value: LayoutMode
+  }))
+}).pipe(Schema.mutable);
+var DeckEphemeralStateSchema = Schema.Struct({
   dialogOpen: Schema.Boolean,
   dialogType: Schema.optional(Schema.Literal("default", "alert")),
   dialogBlockAlign: Schema.optional(Schema.Literal("start", "center", "end")),
@@ -81,21 +127,16 @@ var DeckPluginState = Schema.Struct({
   popoverSide: Schema.optional(Schema.Literal("top", "right", "bottom", "left")),
   popoverAnchor: Schema.optional(Schema.Any),
   popoverAnchorId: Schema.optional(Schema.String),
+  popoverKind: Schema.optional(Schema.Literal("base", "card")),
+  popoverTitle: Schema.optional(Label.annotations({
+    description: "The title of the popover."
+  })),
+  /** Ref of the subject to be passed to the popover Surface. */
+  popoverContentRef: Schema.optional(Schema.String),
   /** Data to be passed to the popover Surface. */
   popoverContent: Schema.optional(Schema.Any),
-  toasts: Schema.mutable(Schema.Array(LayoutAction.Toast)),
+  toasts: Schema.mutable(Schema.Array(LayoutOperation.Toast)),
   currentUndoId: Schema.optional(Schema.String),
-  activeDeck: Schema.String,
-  previousDeck: Schema.String,
-  decks: Schema.mutable(Schema.Record({
-    key: Schema.String,
-    value: Schema.mutable(DeckState)
-  })),
-  previousMode: Schema.mutable(Schema.Record({
-    key: Schema.String,
-    value: LayoutMode
-  })),
-  deck: Schema.mutable(DeckState),
   /** The identifier of a component to scroll into view when it is mounted. */
   scrollIntoView: Schema.optional(Schema.String)
 }).pipe(Schema.mutable);
@@ -134,7 +175,6 @@ var DeckPluginState = Schema.Struct({
   DeckAction2.UpdatePlankSize = UpdatePlankSize;
   class ChangeCompanion extends Schema.TaggedClass()(`${meta.id}/action/change-companion`, {
     input: Schema.Struct({
-      primary: Schema.String,
       companion: Schema.Union(Schema.String, Schema.Null)
     }),
     output: Schema.Void
@@ -142,21 +182,99 @@ var DeckPluginState = Schema.Struct({
   }
   DeckAction2.ChangeCompanion = ChangeCompanion;
 })(DeckAction || (DeckAction = {}));
+(function(DeckOperation2) {
+  const PartAdjustmentSchema = Schema.Union(Schema.Literal("close").annotations({
+    description: "Close the plank."
+  }), Schema.Literal("companion").annotations({
+    description: "Open the companion plank."
+  }), Schema.Literal("solo").annotations({
+    description: "Solo the plank."
+  }), Schema.Literal("solo--fullscreen").annotations({
+    description: "Fullscreen the plank."
+  }), Schema.Literal("increment-start").annotations({
+    description: "Move the plank towards the start of the deck."
+  }), Schema.Literal("increment-end").annotations({
+    description: "Move the plank towards the end of the deck."
+  }));
+  DeckOperation2.Adjust = Operation.make({
+    meta: {
+      key: `${meta.id}/operation/adjust`,
+      name: "Adjust",
+      description: "Adjust the layout of a plank."
+    },
+    services: [
+      Capability2.Service
+    ],
+    schema: {
+      input: Schema.Struct({
+        id: Schema.String.annotations({
+          description: "The id of the plank to adjust."
+        }),
+        type: PartAdjustmentSchema.annotations({
+          description: "The type of adjustment to make."
+        })
+      }),
+      output: Schema.Void
+    }
+  });
+  DeckOperation2.UpdatePlankSize = Operation.make({
+    meta: {
+      key: `${meta.id}/operation/update-plank-size`,
+      name: "Update Plank Size",
+      description: "Update the size of a plank."
+    },
+    services: [
+      Capability2.Service
+    ],
+    schema: {
+      input: Schema.Struct({
+        id: Schema.String.annotations({
+          description: "The id of the plank to resize."
+        }),
+        size: Schema.Number.annotations({
+          description: "The new size of the plank."
+        })
+      }),
+      output: Schema.Void
+    }
+  });
+  DeckOperation2.ChangeCompanion = Operation.make({
+    meta: {
+      key: `${meta.id}/operation/change-companion`,
+      name: "Change Companion",
+      description: "Change the companion plank for a primary plank."
+    },
+    services: [
+      Capability2.Service
+    ],
+    schema: {
+      input: Schema.Struct({
+        companion: Schema.Union(Schema.String, Schema.Null)
+      }),
+      output: Schema.Void
+    }
+  });
+})(DeckOperation || (DeckOperation = {}));
 var DeckAction;
+var DeckOperation;
 
 export {
+  DeckCapabilities,
+  DeckEvents,
   PLANK_COMPANION_TYPE,
   DECK_COMPANION_TYPE,
   NewPlankPositions,
-  OverscrollOptions,
+  OverScrollToProps,
   DeckSettingsSchema,
   PlankSizing,
   DeckState,
   defaultDeck,
   isLayoutMode,
   getMode,
-  DeckPluginState,
+  DeckStateSchema,
+  DeckEphemeralStateSchema,
   DeckAction,
+  DeckOperation,
   ATTENDABLE_PATH_SEPARATOR
 };
-//# sourceMappingURL=chunk-7I6H3N4Q.mjs.map
+//# sourceMappingURL=chunk-OAPMV5ZR.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/capabilities.ts", "../../../src/types/events.ts", "../../../src/types/schema.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom-react';\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { invariant } from '@dxos/invariant';\n\nimport { meta } from '../meta';\nimport { type DeckEphemeralStateProps, type DeckSettingsProps, type DeckState, type DeckStateProps } from '../types';\n\nexport namespace DeckCapabilities {\n  export const Settings = Capability.make<Atom.Writable<DeckSettingsProps>>(`${meta.id}/capability/settings`);\n\n  /** Persisted state (stored in KVS/localStorage). */\n  export const State = Capability.make<Atom.Writable<DeckStateProps>>(`${meta.id}/capability/state`);\n\n  /** Transient/ephemeral state (not persisted). */\n  export const EphemeralState = Capability.make<Atom.Writable<DeckEphemeralStateProps>>(\n    `${meta.id}/capability/ephemeral-state`,\n  );\n\n  /** Get the current active deck from state. */\n  export const getDeck = (): Effect.Effect<DeckState, Error, Capability.Service> =>\n    Effect.gen(function* () {\n      const state = yield* Capabilities.getAtomValue(State);\n      const deck = state.decks[state.activeDeck];\n      invariant(deck, `Deck not found: ${state.activeDeck}`);\n      return deck;\n    });\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type ActivationEvent } from '@dxos/app-framework';\nimport { AppActivationEvents } from '@dxos/app-toolkit';\n\nimport { meta } from '../meta';\n\nimport { DeckCapabilities } from './capabilities';\n\nexport namespace DeckEvents {\n  export const StateReady: ActivationEvent.ActivationEvent = AppActivationEvents.createStateEvent(\n    `${meta.id}/state-ready`,\n  );\n\n  /** Fired when DeckSettings capability is ready. */\n  export const SettingsReady: ActivationEvent.ActivationEvent = AppActivationEvents.createSettingsEvent(\n    DeckCapabilities.Settings.identifier,\n  );\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Label, LayoutOperation } from '@dxos/app-toolkit';\nimport { Operation } from '@dxos/operation';\nimport { type DeepReadonly } from '@dxos/util';\n\nimport { meta } from '../meta';\n\nexport { ATTENDABLE_PATH_SEPARATOR } from '@dxos/react-ui-attention';\n\nexport const PLANK_COMPANION_TYPE = `${meta.id}/plank-companion`;\nexport const DECK_COMPANION_TYPE = `${meta.id}/deck-companion`;\n\n// TODO(Zan): In the future we should consider adding new planks adjacent to the attended plank.\nexport const NewPlankPositions = ['start', 'end'] as const;\nexport type NewPlankPositioning = (typeof NewPlankPositions)[number];\n\nexport const OverScrollToProps = ['none', 'centering'] as const;\nexport type Overscroll = (typeof OverScrollToProps)[number];\n\nexport type Part = 'solo' | 'deck' | 'complementary';\nexport type ResolvedPart = Part | 'solo-primary' | 'solo-companion';\n\nexport const DeckSettingsSchema = Schema.Struct({\n  showHints: Schema.optional(Schema.Boolean),\n  enableDeck: Schema.optional(Schema.Boolean),\n  enableStatusbar: Schema.optional(Schema.Boolean),\n  enableNativeRedirect: Schema.optional(Schema.Boolean),\n  newPlankPositioning: Schema.optional(Schema.Literal(...NewPlankPositions)),\n  overscroll: Schema.optional(Schema.Literal(...OverScrollToProps)),\n  // TODO(burdon): Rename layoutMode? (e.g., bento | encapsulated?)\n  encapsulatedPlanks: Schema.optional(Schema.Boolean),\n}).pipe(Schema.mutable);\nexport type DeckSettingsProps = Schema.Schema.Type<typeof DeckSettingsSchema>;\n\nexport const PlankSizing = Schema.Record({ key: Schema.String, value: Schema.Number });\nexport type PlankSizing = Schema.Schema.Type<typeof PlankSizing>;\n\n// State of an individual deck.\nexport const DeckState = Schema.Struct({\n  /** If false, the deck has not yet left solo mode and new planks should be soloed. */\n  initialized: Schema.Boolean,\n  active: Schema.mutable(Schema.Array(Schema.String)),\n  companionOpen: Schema.Boolean,\n  companionVariant: Schema.optional(Schema.String),\n  inactive: Schema.mutable(Schema.Array(Schema.String)),\n  solo: Schema.optional(Schema.String),\n  fullscreen: Schema.Boolean,\n  plankSizing: Schema.mutable(PlankSizing),\n  companionFrameSizing: Schema.mutable(PlankSizing),\n});\nexport type DeckState = Schema.Schema.Type<typeof DeckState>;\n\nexport const defaultDeck: DeckState = {\n  initialized: false,\n  active: [],\n  companionOpen: false,\n  companionVariant: undefined,\n  inactive: [],\n  solo: undefined,\n  fullscreen: false,\n  plankSizing: {},\n  companionFrameSizing: {},\n};\n\nconst LayoutMode = Schema.Literal('deck', 'solo', 'solo--fullscreen');\nexport type LayoutMode = Schema.Schema.Type<typeof LayoutMode>;\nexport const isLayoutMode = (value: any): value is LayoutMode => Schema.is(LayoutMode)(value);\n\nexport const getMode = (deck: DeckState | DeepReadonly<DeckState>): LayoutMode => {\n  if (deck.solo) {\n    return deck.fullscreen ? 'solo--fullscreen' : 'solo';\n  }\n\n  return 'deck';\n};\n\n// Persisted plugin state (stored in KVS/localStorage).\nexport const DeckStateSchema = Schema.Struct({\n  sidebarState: Schema.Literal('closed', 'collapsed', 'expanded'),\n  complementarySidebarState: Schema.Literal('closed', 'collapsed', 'expanded'),\n  complementarySidebarPanel: Schema.optional(Schema.String),\n  activeDeck: Schema.String,\n  previousDeck: Schema.String,\n  decks: Schema.mutable(Schema.Record({ key: Schema.String, value: Schema.mutable(DeckState) })),\n  previousMode: Schema.mutable(Schema.Record({ key: Schema.String, value: LayoutMode })),\n}).pipe(Schema.mutable);\nexport type DeckStateProps = Schema.Schema.Type<typeof DeckStateSchema>;\n\n// TODO(burdon): Factor out state (in common with other layouts?)\n// Transient/ephemeral plugin state (not persisted).\nexport const DeckEphemeralStateSchema = Schema.Struct({\n  dialogOpen: Schema.Boolean,\n  dialogType: Schema.optional(Schema.Literal('default', 'alert')),\n  dialogBlockAlign: Schema.optional(Schema.Literal('start', 'center', 'end')),\n  dialogOverlayClasses: Schema.optional(Schema.String),\n  dialogOverlayStyle: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Any })),\n  /** Data to be passed to the dialog Surface. */\n  dialogContent: Schema.optional(Schema.Any),\n\n  popoverOpen: Schema.Boolean,\n  popoverSide: Schema.optional(Schema.Literal('top', 'right', 'bottom', 'left')),\n  popoverAnchor: Schema.optional(Schema.Any),\n  popoverAnchorId: Schema.optional(Schema.String),\n  popoverKind: Schema.optional(Schema.Literal('base', 'card')),\n  popoverTitle: Schema.optional(Label.annotations({ description: 'The title of the popover.' })),\n  /** Ref of the subject to be passed to the popover Surface. */\n  popoverContentRef: Schema.optional(Schema.String),\n  /** Data to be passed to the popover Surface. */\n  popoverContent: Schema.optional(Schema.Any),\n\n  toasts: Schema.mutable(Schema.Array(LayoutOperation.Toast)),\n  currentUndoId: Schema.optional(Schema.String),\n\n  /** The identifier of a component to scroll into view when it is mounted. */\n  scrollIntoView: Schema.optional(Schema.String),\n}).pipe(Schema.mutable);\nexport type DeckEphemeralStateProps = Schema.Schema.Type<typeof DeckEphemeralStateSchema>;\n\n// Combined state type (for convenience in components that need both).\nexport type DeckPluginState = DeckStateProps & DeckEphemeralStateProps;\n\nexport namespace DeckAction {\n  const PartAdjustmentSchema = Schema.Union(\n    Schema.Literal('close').annotations({ description: 'Close the plank.' }),\n    Schema.Literal('companion').annotations({ description: 'Open the companion plank.' }),\n    Schema.Literal('solo').annotations({ description: 'Solo the plank.' }),\n    Schema.Literal('solo--fullscreen').annotations({ description: 'Fullscreen the plank.' }),\n    Schema.Literal('increment-start').annotations({ description: 'Move the plank towards the start of the deck.' }),\n    Schema.Literal('increment-end').annotations({ description: 'Move the plank towards the end of the deck.' }),\n  );\n  export type PartAdjustment = Schema.Schema.Type<typeof PartAdjustmentSchema>;\n  export const Adjustment = Schema.mutable(Schema.Struct({ id: Schema.String, type: PartAdjustmentSchema }));\n  export type Adjustment = Schema.Schema.Type<typeof Adjustment>;\n\n  // An atomic transaction to apply to the deck, describing which element to move to which location.\n  export class Adjust extends Schema.TaggedClass<Adjust>()(`${meta.id}/action/adjust`, {\n    input: Adjustment,\n    output: Schema.Void,\n  }) {}\n\n  export class UpdatePlankSize extends Schema.TaggedClass<UpdatePlankSize>()(`${meta.id}/action/update-plank-size`, {\n    input: Schema.Struct({\n      id: Schema.String,\n      size: Schema.Number,\n    }),\n    output: Schema.Void,\n  }) {}\n\n  export class ChangeCompanion extends Schema.TaggedClass<ChangeCompanion>()(`${meta.id}/action/change-companion`, {\n    input: Schema.Struct({\n      companion: Schema.Union(Schema.String, Schema.Null),\n    }),\n    output: Schema.Void,\n  }) {}\n}\n\n/**\n * Operations for the Deck plugin.\n */\nexport namespace DeckOperation {\n  const PartAdjustmentSchema = Schema.Union(\n    Schema.Literal('close').annotations({ description: 'Close the plank.' }),\n    Schema.Literal('companion').annotations({ description: 'Open the companion plank.' }),\n    Schema.Literal('solo').annotations({ description: 'Solo the plank.' }),\n    Schema.Literal('solo--fullscreen').annotations({ description: 'Fullscreen the plank.' }),\n    Schema.Literal('increment-start').annotations({ description: 'Move the plank towards the start of the deck.' }),\n    Schema.Literal('increment-end').annotations({ description: 'Move the plank towards the end of the deck.' }),\n  );\n  export type PartAdjustment = Schema.Schema.Type<typeof PartAdjustmentSchema>;\n\n  export const Adjust = Operation.make({\n    meta: {\n      key: `${meta.id}/operation/adjust`,\n      name: 'Adjust',\n      description: 'Adjust the layout of a plank.',\n    },\n    services: [Capability.Service],\n    schema: {\n      input: Schema.Struct({\n        id: Schema.String.annotations({ description: 'The id of the plank to adjust.' }),\n        type: PartAdjustmentSchema.annotations({ description: 'The type of adjustment to make.' }),\n      }),\n      output: Schema.Void,\n    },\n  });\n\n  export const UpdatePlankSize = Operation.make({\n    meta: {\n      key: `${meta.id}/operation/update-plank-size`,\n      name: 'Update Plank Size',\n      description: 'Update the size of a plank.',\n    },\n    services: [Capability.Service],\n    schema: {\n      input: Schema.Struct({\n        id: Schema.String.annotations({ description: 'The id of the plank to resize.' }),\n        size: Schema.Number.annotations({ description: 'The new size of the plank.' }),\n      }),\n      output: Schema.Void,\n    },\n  });\n\n  export const ChangeCompanion = Operation.make({\n    meta: {\n      key: `${meta.id}/operation/change-companion`,\n      name: 'Change Companion',\n      description: 'Change the companion plank for a primary plank.',\n    },\n    services: [Capability.Service],\n    schema: {\n      input: Schema.Struct({\n        companion: Schema.Union(Schema.String, Schema.Null),\n      }),\n      output: Schema.Void,\n    },\n  });\n}\n"],
+  "mappings": "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",
+  "names": ["Effect", "Capabilities", "Capability", "invariant", "DeckCapabilities", "Settings", "Capability", "make", "meta", "id", "State", "EphemeralState", "getDeck", "gen", "state", "Capabilities", "getAtomValue", "deck", "decks", "activeDeck", "invariant", "AppActivationEvents", "DeckEvents", "StateReady", "AppActivationEvents", "createStateEvent", "meta", "id", "SettingsReady", "createSettingsEvent", "DeckCapabilities", "Settings", "identifier", "Schema", "Capability", "Label", "LayoutOperation", "Operation", "ATTENDABLE_PATH_SEPARATOR", "PLANK_COMPANION_TYPE", "meta", "id", "DECK_COMPANION_TYPE", "NewPlankPositions", "OverScrollToProps", "DeckSettingsSchema", "Struct", "showHints", "optional", "Boolean", "enableDeck", "enableStatusbar", "enableNativeRedirect", "newPlankPositioning", "Literal", "overscroll", "encapsulatedPlanks", "pipe", "mutable", "PlankSizing", "Record", "key", "String", "value", "Number", "DeckState", "initialized", "active", "Array", "companionOpen", "companionVariant", "inactive", "solo", "fullscreen", "plankSizing", "companionFrameSizing", "defaultDeck", "undefined", "LayoutMode", "isLayoutMode", "is", "getMode", "deck", "DeckStateSchema", "sidebarState", "complementarySidebarState", "complementarySidebarPanel", "activeDeck", "previousDeck", "decks", "previousMode", "DeckEphemeralStateSchema", "dialogOpen", "dialogType", "dialogBlockAlign", "dialogOverlayClasses", "dialogOverlayStyle", "Any", "dialogContent", "popoverOpen", "popoverSide", "popoverAnchor", "popoverAnchorId", "popoverKind", "popoverTitle", "Label", "annotations", "description", "popoverContentRef", "popoverContent", "toasts", "LayoutOperation", "Toast", "currentUndoId", "scrollIntoView", "DeckAction", "PartAdjustmentSchema", "Union", "Adjustment", "type", "Adjust", "TaggedClass", "input", "output", "Void", "UpdatePlankSize", "size", "ChangeCompanion", "companion", "Null", "DeckOperation", "Operation", "make", "name", "services", "Capability", "Service", "schema"]
+}

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

@@ -0,0 +1,200 @@
+import {
+  parseEntryId
+} from "./chunk-SKBPLX5T.mjs";
+import {
+  ATTENDABLE_PATH_SEPARATOR,
+  DECK_COMPANION_TYPE,
+  DeckCapabilities,
+  PLANK_COMPANION_TYPE
+} from "./chunk-OAPMV5ZR.mjs";
+
+// 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";
+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/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";
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-deck/src/hooks/useDeckState.ts";
+var useDeckState = () => {
+  const registry = useCapability(Capabilities.AtomRegistry);
+  const stateAtom = useCapability(DeckCapabilities.State);
+  const ephemeralAtom = useCapability(DeckCapabilities.EphemeralState);
+  const persistedState = useAtomValue(stateAtom);
+  const ephemeralState = useAtomValue(ephemeralAtom);
+  const deck = useMemo2(() => {
+    const d = persistedState.decks[persistedState.activeDeck];
+    invariant(d, `Deck not found: ${persistedState.activeDeck}`, {
+      F: __dxlog_file,
+      L: 46,
+      S: void 0,
+      A: [
+        "d",
+        "`Deck not found: ${persistedState.activeDeck}`"
+      ]
+    });
+    return d;
+  }, [
+    persistedState.decks,
+    persistedState.activeDeck
+  ]);
+  const state = useMemo2(() => ({
+    ...persistedState,
+    ...ephemeralState
+  }), [
+    persistedState,
+    ephemeralState
+  ]);
+  const updateState = useCallback((fn) => {
+    registry.set(stateAtom, fn(registry.get(stateAtom)));
+  }, [
+    registry,
+    stateAtom
+  ]);
+  const updateEphemeral = useCallback((fn) => {
+    registry.set(ephemeralAtom, fn(registry.get(ephemeralAtom)));
+  }, [
+    registry,
+    ephemeralAtom
+  ]);
+  return useMemo2(() => ({
+    state,
+    deck,
+    updateState,
+    updateEphemeral
+  }), [
+    state,
+    deck,
+    updateState,
+    updateEphemeral
+  ]);
+};
+
+// src/hooks/useBreakpoints.ts
+import { useMediaQuery } from "@dxos/react-ui";
+var useBreakpoints = () => {
+  const [isNotMobile] = useMediaQuery("md");
+  const [isDesktop] = useMediaQuery("lg");
+  return isDesktop ? "desktop" : isNotMobile ? "tablet" : "mobile";
+};
+
+// 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";
+var getCompanionId = (id) => {
+  const [_, companionId] = id.split(ATTENDABLE_PATH_SEPARATOR);
+  return companionId ?? "never";
+};
+var useDeckCompanions = () => {
+  const { graph } = useAppGraph2();
+  const connections = useConnections2(graph, Node.RootId, "child");
+  const companions = connections.filter((node) => node.type === DECK_COMPANION_TYPE);
+  return companions.toSorted((a, b) => byPosition2(a.properties, b.properties));
+};
+
+// src/hooks/useHoistStatusbar.ts
+import { useMemo as useMemo3 } from "react";
+import { useAtomCapability } from "@dxos/app-framework/ui";
+import { useThemeContext } from "@dxos/react-ui";
+var useHoistStatusbar = (breakpoint, layoutMode) => {
+  const { safeAreaPadding } = useThemeContext();
+  const enableStatusbar = useAtomCapability(DeckCapabilities.Settings).enableStatusbar;
+  return useMemo3(() => {
+    return breakpoint === "desktop" && layoutMode !== "solo--fullscreen" && !!enableStatusbar && safeAreaPadding?.bottom === 0;
+  }, [
+    enableStatusbar,
+    breakpoint,
+    safeAreaPadding?.bottom,
+    layoutMode
+  ]);
+};
+
+// src/hooks/useMainSize.ts
+import { useMainContext } from "@dxos/react-ui";
+var useMainSize = () => {
+  const { navigationSidebarState, complementarySidebarState } = useMainContext("DeckPluginPlank");
+  return {
+    "data-sidebar-left-state": navigationSidebarState,
+    "data-sidebar-right-state": complementarySidebarState
+  };
+};
+
+// src/hooks/useNodeActionExpander.ts
+import { useEffect } from "react";
+import { Graph } from "@dxos/plugin-graph";
+var useNodeActionExpander = (node) => {
+  useEffect(() => {
+    if (node) {
+      const frame = requestAnimationFrame(() => {
+        const graph = Graph.getGraph(node);
+        void Graph.expand(graph, node.id, "action");
+      });
+      return () => cancelAnimationFrame(frame);
+    }
+  }, [
+    node
+  ]);
+};
+
+// src/hooks/useSelectedCompanion.ts
+import { useMemo as useMemo4 } from "react";
+var useSelectedCompanion = (companions, preferredVariant) => {
+  return useMemo4(() => {
+    if (companions.length === 0) {
+      return {
+        companionId: void 0,
+        variant: void 0
+      };
+    }
+    if (preferredVariant) {
+      const preferred = companions.find((companion) => {
+        const { variant: variant2 } = parseEntryId(companion.id);
+        return variant2 === preferredVariant;
+      });
+      if (preferred) {
+        const { variant: variant2 } = parseEntryId(preferred.id);
+        return {
+          companionId: preferred.id,
+          variant: variant2
+        };
+      }
+    }
+    const first = companions[0];
+    const { variant } = parseEntryId(first.id);
+    return {
+      companionId: first.id,
+      variant
+    };
+  }, [
+    companions,
+    preferredVariant
+  ]);
+};
+
+export {
+  useBreakpoints,
+  useCompanions,
+  getCompanionId,
+  useDeckCompanions,
+  useDeckState,
+  useHoistStatusbar,
+  useMainSize,
+  useNodeActionExpander,
+  useSelectedCompanion
+};
+//# sourceMappingURL=chunk-Q4GUCIRE.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/useCompanions.ts", "../../../src/hooks/useDeckState.ts", "../../../src/hooks/useBreakpoints.ts", "../../../src/hooks/useDeckCompanions.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 { 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 { 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 DeckEphemeralStateProps,\n  type DeckPluginState,\n  type DeckState,\n  type DeckStateProps,\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: DeckStateProps) => DeckStateProps) => void;\n  /** Update ephemeral state. */\n  updateEphemeral: (fn: (current: DeckEphemeralStateProps) => DeckEphemeralStateProps) => 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\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 d = persistedState.decks[persistedState.activeDeck];\n    invariant(d, `Deck not found: ${persistedState.activeDeck}`);\n    return d;\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: DeckStateProps) => DeckStateProps) => {\n      registry.set(stateAtom, fn(registry.get(stateAtom)));\n    },\n    [registry, stateAtom],\n  );\n\n  const updateEphemeral = useCallback(\n    (fn: (current: DeckEphemeralStateProps) => DeckEphemeralStateProps) => {\n      registry.set(ephemeralAtom, fn(registry.get(ephemeralAtom)));\n    },\n    [registry, ephemeralAtom],\n  );\n\n  return useMemo(\n    () => ({\n      state,\n      deck,\n      updateState,\n      updateEphemeral,\n    }),\n    [state, deck, updateState, updateEphemeral],\n  );\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 { 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';\nimport { type Position, byPosition } from '@dxos/util';\n\nimport { ATTENDABLE_PATH_SEPARATOR, DECK_COMPANION_TYPE } from '../types';\n\nexport const getCompanionId = (id: string) => {\n  const [_, companionId] = id.split(ATTENDABLE_PATH_SEPARATOR);\n  return companionId ?? 'never';\n};\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  }\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 { 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';\n\nimport { parseEntryId } from '../layout';\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) => {\n        const { variant } = parseEntryId(companion.id);\n        return variant === preferredVariant;\n      });\n      if (preferred) {\n        const { variant } = parseEntryId(preferred.id);\n        return { companionId: preferred.id, variant };\n      }\n    }\n\n    // Fallback to first companion.\n    const first = companions[0];\n    const { variant } = parseEntryId(first.id);\n    return { companionId: first.id, variant };\n  }, [companions, preferredVariant]);\n};\n"],
+  "mappings": "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",
+  "names": ["useMemo", "useAppGraph", "useConnections", "byPosition", "useCompanions", "id", "graph", "useAppGraph", "nodes", "useConnections", "companions", "filter", "node", "type", "PLANK_COMPANION_TYPE", "useMemo", "toSorted", "a", "b", "byPosition", "properties", "useAtomValue", "useCallback", "useMemo", "Capabilities", "useCapability", "invariant", "useDeckState", "registry", "useCapability", "Capabilities", "AtomRegistry", "stateAtom", "DeckCapabilities", "State", "ephemeralAtom", "EphemeralState", "persistedState", "useAtomValue", "ephemeralState", "deck", "useMemo", "d", "decks", "activeDeck", "invariant", "state", "updateState", "useCallback", "fn", "set", "get", "updateEphemeral", "useMediaQuery", "useBreakpoints", "isNotMobile", "useMediaQuery", "isDesktop", "useAppGraph", "Node", "useConnections", "byPosition", "getCompanionId", "id", "_", "companionId", "split", "ATTENDABLE_PATH_SEPARATOR", "useDeckCompanions", "graph", "useAppGraph", "connections", "useConnections", "Node", "RootId", "companions", "filter", "node", "type", "DECK_COMPANION_TYPE", "toSorted", "a", "b", "byPosition", "properties", "useMemo", "useAtomCapability", "useThemeContext", "useHoistStatusbar", "breakpoint", "layoutMode", "safeAreaPadding", "useThemeContext", "enableStatusbar", "useAtomCapability", "DeckCapabilities", "Settings", "useMemo", "bottom", "useMainContext", "useMainSize", "navigationSidebarState", "complementarySidebarState", "useMainContext", "useEffect", "Graph", "useNodeActionExpander", "node", "useEffect", "frame", "requestAnimationFrame", "graph", "Graph", "getGraph", "expand", "id", "cancelAnimationFrame", "useMemo", "useSelectedCompanion", "companions", "preferredVariant", "useMemo", "length", "companionId", "undefined", "variant", "preferred", "find", "companion", "parseEntryId", "id", "first"]
+}

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

@@ -0,0 +1,81 @@
+// 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);
+    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) {
+        draft.splice(index, 1, entryId);
+        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);
+    }
+  });
+};
+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 {
+  createEntryId,
+  parseEntryId,
+  openEntry,
+  closeEntry,
+  incrementPlank
+};
+//# sourceMappingURL=chunk-SKBPLX5T.mjs.map

package/dist/lib/browser/chunk-SKBPLX5T.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 { ATTENDABLE_PATH_SEPARATOR } from '@dxos/react-ui-attention';\n\nimport { type DeckAction, type NewPlankPositioning } from './types';\n\nexport const createEntryId = (entryId: string, variant?: string) =>\n  variant ? `${entryId}${ATTENDABLE_PATH_SEPARATOR}${variant}` : entryId;\n\nexport const parseEntryId = (entryId: string) => {\n  const [id, variant] = entryId.split(ATTENDABLE_PATH_SEPARATOR);\n  return { id, variant };\n};\n\ntype OpenLayoutEntryOptions = {\n  key?: string;\n  positioning?: NewPlankPositioning;\n  pivotId?: string;\n  variant?: string;\n};\n\nexport const openEntry = (deck: string[], _entryId: string, options?: OpenLayoutEntryOptions): string[] => {\n  return produce(deck, (draft) => {\n    const entryId = createEntryId(_entryId, options?.variant);\n\n    // Check that the entry is not already in the part\n    if (draft.find((id) => id === entryId)) {\n      return;\n    }\n\n    const key = options?.key;\n    const plankPositioning = options?.positioning ?? 'start';\n    const pivotId = options?.pivotId;\n\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    if (pivotId) {\n      const pivotIndex = draft.findIndex((id) => id === pivotId);\n      if (pivotIndex !== -1) {\n        if (plankPositioning === 'start') {\n          draft.splice(pivotIndex, 0, entryId);\n        } else {\n          draft.splice(pivotIndex + 1, 0, entryId);\n        }\n        return;\n      }\n    }\n\n    // If no pivot found or provided, fall back to original behavior\n    if (plankPositioning === 'start') {\n      draft.unshift(entryId);\n    } else {\n      draft.push(entryId);\n    }\n  });\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;AAExB,SAASC,iCAAiC;AAInC,IAAMC,gBAAgB,CAACC,SAAiBC,YAC7CA,UAAU,GAAGD,OAAAA,GAAUE,yBAAAA,GAA4BD,OAAAA,KAAYD;AAE1D,IAAMG,eAAe,CAACH,YAAAA;AAC3B,QAAM,CAACI,IAAIH,OAAAA,IAAWD,QAAQK,MAAMH,yBAAAA;AACpC,SAAO;IAAEE;IAAIH;EAAQ;AACvB;AASO,IAAMK,YAAY,CAACC,MAAgBC,UAAkBC,YAAAA;AAC1D,SAAOC,QAAQH,MAAM,CAACI,UAAAA;AACpB,UAAMX,UAAUD,cAAcS,UAAUC,SAASR,OAAAA;AAGjD,QAAIU,MAAMC,KAAK,CAACR,OAAOA,OAAOJ,OAAAA,GAAU;AACtC;IACF;AAEA,UAAMa,MAAMJ,SAASI;AACrB,UAAMC,mBAAmBL,SAASM,eAAe;AACjD,UAAMC,UAAUP,SAASO;AAEzB,QAAIH,KAAK;AACP,YAAMI,QAAQN,MAAMO,UAAU,CAACd,OAAOA,GAAGC,MAAM,GAAA,EAAK,CAAA,MAAOQ,GAAAA;AAC3D,UAAII,UAAU,IAAI;AAChBN,cAAMQ,OAAOF,OAAO,GAAGjB,OAAAA;AACvB;MACF;IACF;AAEA,QAAIgB,SAAS;AACX,YAAMI,aAAaT,MAAMO,UAAU,CAACd,OAAOA,OAAOY,OAAAA;AAClD,UAAII,eAAe,IAAI;AACrB,YAAIN,qBAAqB,SAAS;AAChCH,gBAAMQ,OAAOC,YAAY,GAAGpB,OAAAA;QAC9B,OAAO;AACLW,gBAAMQ,OAAOC,aAAa,GAAG,GAAGpB,OAAAA;QAClC;AACA;MACF;IACF;AAGA,QAAIc,qBAAqB,SAAS;AAChCH,YAAMU,QAAQrB,OAAAA;IAChB,OAAO;AACLW,YAAMW,KAAKtB,OAAAA;IACb;EACF,CAAA;AACF;AAEO,IAAMuB,aAAa,CAAChB,MAAgBP,YAAAA;AACzC,SAAOU,QAAQH,MAAM,CAACI,UAAAA;AACpB,UAAMM,QAAQN,MAAMO,UAAU,CAACd,OAAOA,OAAOJ,OAAAA;AAC7C,QAAIiB,UAAU,IAAI;AAChBN,YAAMQ,OAAOF,OAAO,CAAA;IACtB;EACF,CAAA;AACF;AAEO,IAAMO,iBAAiB,CAACjB,MAAgBkB,eAAAA;AAC7C,SAAOf,QAAQH,MAAM,CAACI,UAAAA;AACpB,UAAMM,QAAQN,MAAMO,UAAU,CAACd,OAAOA,OAAOqB,WAAWrB,EAAE;AAC1D,QACEa,UAAU,MACTQ,WAAWC,SAAS,qBAAqBT,UAAU,KACnDQ,WAAWC,SAAS,mBAAmBT,UAAUN,MAAMgB,SAAS,GACjE;AACA;IACF;AAEA,QAAIF,WAAWC,SAAS,mBAAmB;AAEzC,OAACf,MAAMM,QAAQ,CAAA,GAAIN,MAAMM,KAAAA,CAAM,IAAI;QAACN,MAAMM,KAAAA;QAAQN,MAAMM,QAAQ,CAAA;;IAClE,WAAWQ,WAAWC,SAAS,iBAAiB;AAE9C,OAACf,MAAMM,KAAAA,GAAQN,MAAMM,QAAQ,CAAA,CAAE,IAAI;QAACN,MAAMM,QAAQ,CAAA;QAAIN,MAAMM,KAAAA;;IAC9D;EACF,CAAA;AACF;",
+  "names": ["produce", "ATTENDABLE_PATH_SEPARATOR", "createEntryId", "entryId", "variant", "ATTENDABLE_PATH_SEPARATOR", "parseEntryId", "id", "split", "openEntry", "deck", "_entryId", "options", "produce", "draft", "find", "key", "plankPositioning", "positioning", "pivotId", "index", "findIndex", "splice", "pivotIndex", "unshift", "push", "closeEntry", "incrementPlank", "adjustment", "type", "length"]
+}