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

package/dist/types/src/{capabilities/state/index.d.ts → types/DeckCapabilities.d.ts}

@@ -1,5 +1,10 @@
+import { type Atom } from '@effect-atom/atom-react';
+import * as Effect from 'effect/Effect';
 import { Capability } from '@dxos/app-framework';
-export declare const DeckState: Capability.LazyCapability<void, [Capability.Capability<Capability.InterfaceDef<import("@effect-atom/atom/Atom").Writable<{
+import { type DeckState } from './schema';
+export declare const Settings: Capability.InterfaceDef<Atom.Writable<import("./Settings").Settings, import("./Settings").Settings>>;
+/** Persisted state (stored in KVS/localStorage). */
+export declare const State: Capability.InterfaceDef<Atom.Writable<{
     sidebarState: "closed" | "collapsed" | "expanded";
     complementarySidebarState: "closed" | "collapsed" | "expanded";
     complementarySidebarPanel?: string | undefined;
@@ -9,21 +14,21 @@ export declare const DeckState: Capability.LazyCapability<void, [Capability.Capa
         [x: string]: {
             initialized: boolean;
             active: string[];
-            companionOpen: boolean;
-            companionVariant?: string | undefined;
             inactive: string[];
             solo?: string | undefined;
             fullscreen: boolean;
             plankSizing: {
                 [x: string]: number;
             };
+            companionOpen: boolean;
+            companionVariant?: string | undefined;
             companionFrameSizing: {
                 [x: string]: number;
             };
         };
     };
     previousMode: {
-        [x: string]: "solo" | "deck" | "solo--fullscreen";
+        [x: string]: "multi" | "solo" | "solo--fullscreen";
     };
 }, {
     sidebarState: "closed" | "collapsed" | "expanded";
@@ -35,33 +40,38 @@ export declare const DeckState: Capability.LazyCapability<void, [Capability.Capa
         [x: string]: {
             initialized: boolean;
             active: string[];
-            companionOpen: boolean;
-            companionVariant?: string | undefined;
             inactive: string[];
             solo?: string | undefined;
             fullscreen: boolean;
             plankSizing: {
                 [x: string]: number;
             };
+            companionOpen: boolean;
+            companionVariant?: string | undefined;
             companionFrameSizing: {
                 [x: string]: number;
             };
         };
     };
     previousMode: {
-        [x: string]: "solo" | "deck" | "solo--fullscreen";
+        [x: string]: "multi" | "solo" | "solo--fullscreen";
     };
-}>>>, Capability.Capability<Capability.InterfaceDef<import("@effect-atom/atom/Atom").Writable<{
+}>>;
+/** Transient/ephemeral state (not persisted). */
+export declare const EphemeralState: Capability.InterfaceDef<Atom.Writable<{
     dialogOpen: boolean;
-    dialogType?: "default" | "alert" | undefined;
-    dialogBlockAlign?: "start" | "end" | "center" | undefined;
+    dialogType?: "alert" | "default" | undefined;
+    dialogBlockAlign?: "center" | "end" | "start" | undefined;
     dialogOverlayClasses?: string | undefined;
     dialogOverlayStyle?: {
         readonly [x: string]: any;
     } | undefined;
-    dialogContent?: any;
+    dialogContent: {
+        readonly component: string;
+        readonly props?: any;
+    } | null;
     popoverOpen: boolean;
-    popoverSide?: "top" | "right" | "bottom" | "left" | undefined;
+    popoverSide?: "bottom" | "left" | "right" | "top" | undefined;
     popoverAnchor?: any;
     popoverAnchorId?: string | undefined;
     popoverKind?: "base" | "card" | undefined;
@@ -71,15 +81,20 @@ export declare const DeckState: Capability.LazyCapability<void, [Capability.Capa
         defaultValue?: string | undefined;
     }] | undefined;
     popoverContentRef?: string | undefined;
-    popoverContent?: any;
+    popoverContent: {
+        readonly component: string;
+        readonly props?: any;
+    } | {
+        readonly subject: any;
+    } | null;
     toasts: {
-        readonly description?: string | [string, {
+        readonly id: string;
+        readonly title?: string | [string, {
             ns: string;
             count?: number | undefined;
             defaultValue?: string | undefined;
         }] | undefined;
-        readonly id: string;
-        readonly title?: string | [string, {
+        readonly description?: string | [string, {
             ns: string;
             count?: number | undefined;
             defaultValue?: string | undefined;
@@ -107,15 +122,18 @@ export declare const DeckState: Capability.LazyCapability<void, [Capability.Capa
     scrollIntoView?: string | undefined;
 }, {
     dialogOpen: boolean;
-    dialogType?: "default" | "alert" | undefined;
-    dialogBlockAlign?: "start" | "end" | "center" | undefined;
+    dialogType?: "alert" | "default" | undefined;
+    dialogBlockAlign?: "center" | "end" | "start" | undefined;
     dialogOverlayClasses?: string | undefined;
     dialogOverlayStyle?: {
         readonly [x: string]: any;
     } | undefined;
-    dialogContent?: any;
+    dialogContent: {
+        readonly component: string;
+        readonly props?: any;
+    } | null;
     popoverOpen: boolean;
-    popoverSide?: "top" | "right" | "bottom" | "left" | undefined;
+    popoverSide?: "bottom" | "left" | "right" | "top" | undefined;
     popoverAnchor?: any;
     popoverAnchorId?: string | undefined;
     popoverKind?: "base" | "card" | undefined;
@@ -125,15 +143,20 @@ export declare const DeckState: Capability.LazyCapability<void, [Capability.Capa
         defaultValue?: string | undefined;
     }] | undefined;
     popoverContentRef?: string | undefined;
-    popoverContent?: any;
+    popoverContent: {
+        readonly component: string;
+        readonly props?: any;
+    } | {
+        readonly subject: any;
+    } | null;
     toasts: {
-        readonly description?: string | [string, {
+        readonly id: string;
+        readonly title?: string | [string, {
             ns: string;
             count?: number | undefined;
             defaultValue?: string | undefined;
         }] | undefined;
-        readonly id: string;
-        readonly title?: string | [string, {
+        readonly description?: string | [string, {
             ns: string;
             count?: number | undefined;
             defaultValue?: string | undefined;
@@ -159,14 +182,7 @@ export declare const DeckState: Capability.LazyCapability<void, [Capability.Capa
     }[];
     currentUndoId?: string | undefined;
     scrollIntoView?: string | undefined;
-}>>>, Capability.Capability<Capability.InterfaceDef<import("@effect-atom/atom/Atom").Atom<Readonly<{
-    mode: string;
-    dialogOpen: boolean;
-    sidebarOpen: boolean;
-    complementarySidebarOpen: boolean;
-    workspace: string;
-    active: string[];
-    inactive: string[];
-    scrollIntoView: string | undefined;
-}>>>>], Error>;
-//# sourceMappingURL=index.d.ts.map
+}>>;
+/** Get the current active deck from state. */
+export declare const getDeck: () => Effect.Effect<DeckState, Error, Capability.Service>;
+//# sourceMappingURL=DeckCapabilities.d.ts.map

package/dist/types/src/types/DeckCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/types/DeckCapabilities.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAK/D,OAAO,EAA2B,KAAK,SAAS,EAAwB,MAAM,UAAU,CAAC;AAEzF,eAAO,MAAM,QAAQ,sGAAkG,CAAC;AAExH,oDAAoD;AACpD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAiF,CAAC;AAEpG,iDAAiD;AACjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE1B,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,OAAO,QAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAMzE,CAAC"}

package/dist/types/src/types/DeckEvents.d.ts

@@ -0,0 +1,5 @@
+import { type ActivationEvent } from '@dxos/app-framework';
+export declare const StateReady: ActivationEvent.ActivationEvent;
+/** Fired when DeckSettings capability is ready. */
+export declare const SettingsReady: ActivationEvent.ActivationEvent;
+//# sourceMappingURL=DeckEvents.d.ts.map

package/dist/types/src/types/DeckEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckEvents.d.ts","sourceRoot":"","sources":["../../../../src/types/DeckEvents.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAO3D,eAAO,MAAM,UAAU,EAAE,eAAe,CAAC,eAExC,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,eAE3C,CAAC"}

package/dist/types/src/types/DeckOperation.d.ts

@@ -0,0 +1,15 @@
+import * as Schema from 'effect/Schema';
+import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+declare const PartAdjustmentSchema: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
+export type PartAdjustment = Schema.Schema.Type<typeof PartAdjustmentSchema>;
+export declare const Adjust: Operation.Definition<{
+    readonly id: string;
+    readonly type: "close" | "companion" | "increment-end" | "increment-start" | "solo" | "solo--fullscreen";
+}, void, Capability.Service>;
+export declare const UpdatePlankSize: Operation.Definition<{
+    readonly id: string;
+    readonly size: number;
+}, void, Capability.Service>;
+export {};
+//# sourceMappingURL=DeckOperation.d.ts.map

package/dist/types/src/types/DeckOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckOperation.d.ts","sourceRoot":"","sources":["../../../../src/types/DeckOperation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI1C,QAAA,MAAM,oBAAoB,kNAOzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E,eAAO,MAAM,MAAM;;;4BAYjB,CAAC;AAEH,eAAO,MAAM,eAAe;;;4BAY1B,CAAC"}

package/dist/types/src/types/Settings.d.ts

@@ -0,0 +1,11 @@
+import * as Schema from 'effect/Schema';
+export declare const Settings: Schema.mutable<Schema.Struct<{
+    enableDeck: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    encapsulatedPlanks: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    enableStatusbar: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    showHints: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    enableNativeRedirect: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+}>>;
+export interface Settings extends Schema.Schema.Type<typeof Settings> {
+}
+//# sourceMappingURL=Settings.d.ts.map

package/dist/types/src/types/Settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../../../src/types/Settings.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,QAAQ;;;;;;GAgCE,CAAC;AACxB,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC;CAAG"}

package/dist/types/src/types/index.d.ts

@@ -1,4 +1,6 @@
-export * from './capabilities';
-export * from './events';
 export * from './schema';
+export * as DeckCapabilities from './DeckCapabilities';
+export * as DeckEvents from './DeckEvents';
+export * as DeckOperation from './DeckOperation';
+export * as Settings from './Settings';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AAEzB,OAAO,KAAK,gBAAgB,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/types/src/types/schema.d.ts

@@ -1,46 +1,37 @@
 import * as Schema from 'effect/Schema';
-import { Capability } from '@dxos/app-framework';
 import { type DeepReadonly } from '@dxos/util';
-export { ATTENDABLE_PATH_SEPARATOR } from '@dxos/react-ui-attention';
-export declare const PLANK_COMPANION_TYPE: string;
-export declare const DECK_COMPANION_TYPE: string;
-export declare const NewPlankPositions: readonly ["start", "end"];
-export type NewPlankPositioning = (typeof NewPlankPositions)[number];
-export declare const OverScrollToProps: readonly ["none", "centering"];
-export type Overscroll = (typeof OverScrollToProps)[number];
-export type Part = 'solo' | 'deck' | 'complementary';
+export { PLANK_COMPANION_TYPE, DECK_COMPANION_TYPE } from '@dxos/app-toolkit';
+export type Part = 'solo' | 'multi' | 'complementary';
 export type ResolvedPart = Part | 'solo-primary' | 'solo-companion';
-export declare const DeckSettingsSchema: Schema.mutable<Schema.Struct<{
-    showHints: Schema.optional<typeof Schema.Boolean>;
-    enableDeck: Schema.optional<typeof Schema.Boolean>;
-    enableStatusbar: Schema.optional<typeof Schema.Boolean>;
-    enableNativeRedirect: Schema.optional<typeof Schema.Boolean>;
-    newPlankPositioning: Schema.optional<Schema.Literal<["start", "end"]>>;
-    overscroll: Schema.optional<Schema.Literal<["none", "centering"]>>;
-    encapsulatedPlanks: Schema.optional<typeof Schema.Boolean>;
-}>>;
-export type DeckSettingsProps = Schema.Schema.Type<typeof DeckSettingsSchema>;
 export declare const PlankSizing: Schema.Record$<typeof Schema.String, typeof Schema.Number>;
 export type PlankSizing = Schema.Schema.Type<typeof PlankSizing>;
 export declare const DeckState: Schema.Struct<{
     /** If false, the deck has not yet left solo mode and new planks should be soloed. */
     initialized: typeof Schema.Boolean;
+    /** Item IDs of planks currently displayed in multi-mode. */
     active: Schema.mutable<Schema.Array$<typeof Schema.String>>;
-    companionOpen: typeof Schema.Boolean;
-    companionVariant: Schema.optional<typeof Schema.String>;
+    /** Item IDs of planks that have been closed; used for state persistence and reopening. */
     inactive: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+    /** Item ID of the single plank displayed in solo or fullscreen mode. */
     solo: Schema.optional<typeof Schema.String>;
+    /** Whether the solo plank is displayed in fullscreen mode (no heading or sidebars). */
     fullscreen: typeof Schema.Boolean;
+    /** Persisted plank widths in rem, keyed by item ID. */
     plankSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
+    /** Whether the companion pane is visible alongside the active plank(s). */
+    companionOpen: typeof Schema.Boolean;
+    /** Which companion variant to display when the companion pane is open. */
+    companionVariant: Schema.optional<typeof Schema.String>;
+    /** Persisted companion frame widths in rem, keyed by frame ID. */
     companionFrameSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
 }>;
 export type DeckState = Schema.Schema.Type<typeof DeckState>;
 export declare const defaultDeck: DeckState;
-declare const LayoutMode: Schema.Literal<["deck", "solo", "solo--fullscreen"]>;
+declare const LayoutMode: Schema.Literal<["multi", "solo", "solo--fullscreen"]>;
 export type LayoutMode = Schema.Schema.Type<typeof LayoutMode>;
 export declare const isLayoutMode: (value: any) => value is LayoutMode;
 export declare const getMode: (deck: DeckState | DeepReadonly<DeckState>) => LayoutMode;
-export declare const DeckStateSchema: Schema.mutable<Schema.Struct<{
+export declare const StoredDeckState: Schema.mutable<Schema.Struct<{
     sidebarState: Schema.Literal<["closed", "collapsed", "expanded"]>;
     complementarySidebarState: Schema.Literal<["closed", "collapsed", "expanded"]>;
     complementarySidebarPanel: Schema.optional<typeof Schema.String>;
@@ -49,26 +40,37 @@ export declare const DeckStateSchema: Schema.mutable<Schema.Struct<{
     decks: Schema.mutable<Schema.Record$<typeof Schema.String, Schema.mutable<Schema.Struct<{
         /** If false, the deck has not yet left solo mode and new planks should be soloed. */
         initialized: typeof Schema.Boolean;
+        /** Item IDs of planks currently displayed in multi-mode. */
         active: Schema.mutable<Schema.Array$<typeof Schema.String>>;
-        companionOpen: typeof Schema.Boolean;
-        companionVariant: Schema.optional<typeof Schema.String>;
+        /** Item IDs of planks that have been closed; used for state persistence and reopening. */
         inactive: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+        /** Item ID of the single plank displayed in solo or fullscreen mode. */
         solo: Schema.optional<typeof Schema.String>;
+        /** Whether the solo plank is displayed in fullscreen mode (no heading or sidebars). */
         fullscreen: typeof Schema.Boolean;
+        /** Persisted plank widths in rem, keyed by item ID. */
         plankSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
+        /** Whether the companion pane is visible alongside the active plank(s). */
+        companionOpen: typeof Schema.Boolean;
+        /** Which companion variant to display when the companion pane is open. */
+        companionVariant: Schema.optional<typeof Schema.String>;
+        /** Persisted companion frame widths in rem, keyed by frame ID. */
         companionFrameSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
     }>>>>;
-    previousMode: Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Literal<["deck", "solo", "solo--fullscreen"]>>>;
+    previousMode: Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Literal<["multi", "solo", "solo--fullscreen"]>>>;
 }>>;
-export type DeckStateProps = Schema.Schema.Type<typeof DeckStateSchema>;
-export declare const DeckEphemeralStateSchema: Schema.mutable<Schema.Struct<{
+export type StoredDeckState = Schema.Schema.Type<typeof StoredDeckState>;
+export declare const EphemeralDeckState: Schema.mutable<Schema.Struct<{
     dialogOpen: typeof Schema.Boolean;
     dialogType: Schema.optional<Schema.Literal<["default", "alert"]>>;
     dialogBlockAlign: Schema.optional<Schema.Literal<["start", "center", "end"]>>;
     dialogOverlayClasses: Schema.optional<typeof Schema.String>;
     dialogOverlayStyle: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Any>>;
     /** Data to be passed to the dialog Surface. */
-    dialogContent: Schema.optional<typeof Schema.Any>;
+    dialogContent: Schema.NullOr<Schema.Struct<{
+        component: typeof Schema.String;
+        props: Schema.optional<typeof Schema.Any>;
+    }>>;
     popoverOpen: typeof Schema.Boolean;
     popoverSide: Schema.optional<Schema.Literal<["top", "right", "bottom", "left"]>>;
     popoverAnchor: Schema.optional<typeof Schema.Any>;
@@ -82,7 +84,12 @@ export declare const DeckEphemeralStateSchema: Schema.mutable<Schema.Struct<{
     /** Ref of the subject to be passed to the popover Surface. */
     popoverContentRef: Schema.optional<typeof Schema.String>;
     /** Data to be passed to the popover Surface. */
-    popoverContent: Schema.optional<typeof Schema.Any>;
+    popoverContent: Schema.NullOr<Schema.Union<[Schema.Struct<{
+        component: typeof Schema.String;
+        props: Schema.optional<typeof Schema.Any>;
+    }>, Schema.Struct<{
+        subject: typeof Schema.Any;
+    }>]>>;
     toasts: Schema.mutable<Schema.Array$<Schema.Struct<{
         id: Schema.SchemaClass<string, string, never>;
         title: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Tuple2<typeof Schema.String, Schema.mutable<Schema.Struct<{
@@ -118,8 +125,8 @@ export declare const DeckEphemeralStateSchema: Schema.mutable<Schema.Struct<{
     /** The identifier of a component to scroll into view when it is mounted. */
     scrollIntoView: Schema.optional<typeof Schema.String>;
 }>>;
-export type DeckEphemeralStateProps = Schema.Schema.Type<typeof DeckEphemeralStateSchema>;
-export type DeckPluginState = DeckStateProps & DeckEphemeralStateProps;
+export type EphemeralDeckState = Schema.Schema.Type<typeof EphemeralDeckState>;
+export type DeckPluginState = StoredDeckState & EphemeralDeckState;
 export declare namespace DeckAction {
     const PartAdjustmentSchema: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
     export type PartAdjustment = Schema.Schema.Type<typeof PartAdjustmentSchema>;
@@ -128,8 +135,8 @@ export declare namespace DeckAction {
         type: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
     }>>;
     export type Adjustment = Schema.Schema.Type<typeof Adjustment>;
-    const Adjust_base: Schema.TaggedClass<Adjust, `${string}/action/adjust`, {
-        readonly _tag: Schema.tag<`${string}/action/adjust`>;
+    const Adjust_base: Schema.TaggedClass<Adjust, `${string}.action.adjust`, {
+        readonly _tag: Schema.tag<`${string}.action.adjust`>;
     } & {
         input: Schema.mutable<Schema.Struct<{
             id: typeof Schema.String;
@@ -139,8 +146,8 @@ export declare namespace DeckAction {
     }>;
     export class Adjust extends Adjust_base {
     }
-    const UpdatePlankSize_base: Schema.TaggedClass<UpdatePlankSize, `${string}/action/update-plank-size`, {
-        readonly _tag: Schema.tag<`${string}/action/update-plank-size`>;
+    const UpdatePlankSize_base: Schema.TaggedClass<UpdatePlankSize, `${string}.action.update-plank-size`, {
+        readonly _tag: Schema.tag<`${string}.action.update-plank-size`>;
     } & {
         input: Schema.Struct<{
             id: typeof Schema.String;
@@ -150,74 +157,6 @@ export declare namespace DeckAction {
     }>;
     export class UpdatePlankSize extends UpdatePlankSize_base {
     }
-    const ChangeCompanion_base: Schema.TaggedClass<ChangeCompanion, `${string}/action/change-companion`, {
-        readonly _tag: Schema.tag<`${string}/action/change-companion`>;
-    } & {
-        input: Schema.Struct<{
-            companion: Schema.Union<[typeof Schema.String, typeof Schema.Null]>;
-        }>;
-        output: typeof Schema.Void;
-    }>;
-    export class ChangeCompanion extends ChangeCompanion_base {
-    }
-    export {};
-}
-/**
- * Operations for the Deck plugin.
- */
-export declare namespace DeckOperation {
-    const PartAdjustmentSchema: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
-    export type PartAdjustment = Schema.Schema.Type<typeof PartAdjustmentSchema>;
-    export const Adjust: Omit<{
-        readonly meta: {
-            readonly key: `${string}/operation/adjust`;
-            readonly name: "Adjust";
-            readonly description: "Adjust the layout of a plank.";
-        };
-        readonly services: readonly [typeof Capability.Service];
-        readonly schema: {
-            readonly input: Schema.Struct<{
-                id: Schema.SchemaClass<string, string, never>;
-                type: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
-            }>;
-            readonly output: typeof Schema.Void;
-        };
-    }, "executionMode"> & import("effect/Pipeable").Pipeable & {
-        readonly executionMode: "sync" | "async";
-    };
-    export const UpdatePlankSize: Omit<{
-        readonly meta: {
-            readonly key: `${string}/operation/update-plank-size`;
-            readonly name: "Update Plank Size";
-            readonly description: "Update the size of a plank.";
-        };
-        readonly services: readonly [typeof Capability.Service];
-        readonly schema: {
-            readonly input: Schema.Struct<{
-                id: Schema.SchemaClass<string, string, never>;
-                size: Schema.SchemaClass<number, number, never>;
-            }>;
-            readonly output: typeof Schema.Void;
-        };
-    }, "executionMode"> & import("effect/Pipeable").Pipeable & {
-        readonly executionMode: "sync" | "async";
-    };
-    export const ChangeCompanion: Omit<{
-        readonly meta: {
-            readonly key: `${string}/operation/change-companion`;
-            readonly name: "Change Companion";
-            readonly description: "Change the companion plank for a primary plank.";
-        };
-        readonly services: readonly [typeof Capability.Service];
-        readonly schema: {
-            readonly input: Schema.Struct<{
-                companion: Schema.Union<[typeof Schema.String, typeof Schema.Null]>;
-            }>;
-            readonly output: typeof Schema.Void;
-        };
-    }, "executionMode"> & import("effect/Pipeable").Pipeable & {
-        readonly executionMode: "sync" | "async";
-    };
     export {};
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/types/src/types/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/types/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/types/schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,eAAe,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEpE,eAAO,MAAM,WAAW,4DAA8D,CAAC;AACvF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjE,eAAO,MAAM,SAAS;IACpB,qFAAqF;;IAErF,4DAA4D;;IAE5D,0FAA0F;;IAE1F,wEAAwE;;IAExE,uFAAuF;;IAEvF,uDAAuD;;IAEvD,2EAA2E;;IAE3E,0EAA0E;;IAE1E,kEAAkE;;EAElE,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7D,eAAO,MAAM,WAAW,EAAE,SAUzB,CAAC;AAMF,QAAA,MAAM,UAAU,uDAAsD,CAAC;AACvE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC;AAC/D,eAAO,MAAM,YAAY,UAAW,GAAG,KAAG,KAAK,IAAI,UAA0C,CAAC;AAC9F,eAAO,MAAM,OAAO,SAAU,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,KAAG,UAMnE,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;QAjD1B,qFAAqF;;QAErF,4DAA4D;;QAE5D,0FAA0F;;QAE1F,wEAAwE;;QAExE,uFAAuF;;QAEvF,uDAAuD;;QAEvD,2EAA2E;;QAE3E,0EAA0E;;QAE1E,kEAAkE;;;;GAyC7C,CAAC;AACxB,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;AAGzE,eAAO,MAAM,kBAAkB;;;;;;IAM7B,+CAA+C;;;;;;;;;;;;;;;IAQ/C,8DAA8D;;IAE9D,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAShD,4EAA4E;;GAEvD,CAAC;AACxB,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAG/E,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEnE,yBAAiB,UAAU,CAAC,CAAC;IAC3B,MAAM,oBAAoB,kNAOzB,CAAC;IACF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC7E,MAAM,CAAC,MAAM,UAAU;;;OAAmF,CAAC;IAC3G,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC;;;;;;;;;;IAG/D,MAAM,OAAO,MAAO,SAAQ,WAG1B;KAAG;;;;;;;;;;IAEL,MAAM,OAAO,eAAgB,SAAQ,oBAMnC;KAAG;;CACN"}

package/dist/types/src/util/index.d.ts

@@ -1,4 +1,5 @@
 export * from './layoutAppliesTopbar';
-export * from './overscroll';
+export * from './plank-url-params';
+export * from './sanitize-persisted-state';
 export * from './set-active';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC"}

package/dist/types/src/util/layoutAppliesTopbar.d.ts

@@ -1,3 +1,3 @@
-import { type LayoutMode } from '../types';
+import { type LayoutMode } from '#types';
 export declare const layoutAppliesTopbar: (breakpoint: string, layoutMode?: LayoutMode) => boolean;
 //# sourceMappingURL=layoutAppliesTopbar.d.ts.map

package/dist/types/src/util/layoutAppliesTopbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layoutAppliesTopbar.d.ts","sourceRoot":"","sources":["../../../../src/util/layoutAppliesTopbar.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,EAAE,aAAa,UAAU,YAM9E,CAAC"}
+{"version":3,"file":"layoutAppliesTopbar.d.ts","sourceRoot":"","sources":["../../../../src/util/layoutAppliesTopbar.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,eAAO,MAAM,mBAAmB,eAAgB,MAAM,eAAe,UAAU,YAM9E,CAAC"}

package/dist/types/src/util/plank-url-params.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Serialize deck active qualified IDs into a URL search string.
+ * Preserves non-plank query params from the existing search string.
+ */
+export declare const serializePlanks: (active: readonly string[], existingSearch: string) => string;
+/**
+ * Deserialize plank query params from a URL back to qualified graph IDs.
+ */
+export declare const deserializePlanks: (url: URL) => string[];
+/**
+ * Strip plank query params from a search string, preserving all others.
+ */
+export declare const stripPlanks: (existingSearch: string) => string;
+//# sourceMappingURL=plank-url-params.d.ts.map

package/dist/types/src/util/plank-url-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plank-url-params.d.ts","sourceRoot":"","sources":["../../../../src/util/plank-url-params.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,eAAe,WAAY,SAAS,MAAM,EAAE,kBAAkB,MAAM,KAAG,MAOnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAS,GAAG,KAAG,MAAM,EAElD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,mBAAoB,MAAM,KAAG,MAIpD,CAAC"}

package/dist/types/src/util/plank-url-params.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plank-url-params.test.d.ts.map

package/dist/types/src/util/plank-url-params.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plank-url-params.test.d.ts","sourceRoot":"","sources":["../../../../src/util/plank-url-params.test.ts"],"names":[],"mappings":""}

package/dist/types/src/util/sanitize-persisted-state.d.ts

@@ -0,0 +1,19 @@
+import { type StoredDeckState } from '#types';
+/**
+ * Sanitizes persisted deck state on startup.
+ *
+ * Persisted state may contain values that are inappropriate to restore across sessions:
+ *
+ * - **Fullscreen**: Cleared unconditionally to prevent the user from getting stuck in fullscreen
+ *   mode if the app was closed (or crashed) while fullscreen was active.
+ *
+ * - **Active planks in solo-mode decks**: When a deck is in solo mode, any items in `active`
+ *   represent planks that were kept mounted (hidden) during the session for fast deck↔solo
+ *   switching. After a restart these planks would need to fully remount anyway, so retaining
+ *   them only adds unnecessary load. Clearing `active` for solo-mode decks avoids rendering
+ *   stale planks in the background on startup.
+ *
+ * Returns a new state object if any changes were made, or the original state if clean.
+ */
+export declare const sanitizePersistedState: (state: StoredDeckState) => StoredDeckState;
+//# sourceMappingURL=sanitize-persisted-state.d.ts.map

package/dist/types/src/util/sanitize-persisted-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-persisted-state.d.ts","sourceRoot":"","sources":["../../../../src/util/sanitize-persisted-state.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,UAAW,eAAe,KAAG,eA6B/D,CAAC"}

package/dist/types/src/util/sanitize-persisted-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sanitize-persisted-state.test.d.ts.map

package/dist/types/src/util/sanitize-persisted-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-persisted-state.test.d.ts","sourceRoot":"","sources":["../../../../src/util/sanitize-persisted-state.test.ts"],"names":[],"mappings":""}

package/dist/types/src/util/set-active.d.ts

@@ -1,5 +1,5 @@
-import { type AttentionManager } from '@dxos/plugin-attention';
-import { type DeckState } from '../types';
+import { type AttentionManager } from '@dxos/react-ui-attention';
+import { type DeckState } from '#types';
 export type SetActiveOptions = {
     next: string[];
     deck: DeckState;

package/dist/types/src/util/set-active.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-active.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,oCAAoC;IACpC,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,2BAA2B,gBAAgB,KAAG,eAoClF,CAAC"}
+{"version":3,"file":"set-active.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,oCAAoC;IACpC,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,8BAA+B,gBAAgB,KAAG,eAoClF,CAAC"}

package/dist/types/src/util/set-active.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=set-active.test.d.ts.map

package/dist/types/src/util/set-active.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-active.test.d.ts","sourceRoot":"","sources":["../../../../src/util/set-active.test.ts"],"names":[],"mappings":""}