@dxos/plugin-deck 0.8.3 → 0.8.4-main.1068cf700f

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

@@ -1,59 +1,62 @@
-declare const _default: {
-    'en-US': {
-        "dxos.org/plugin/deck": {
-            'plugin name': string;
-            'main header label': string;
-            'open navigation sidebar label': string;
-            'collapse navigation sidebar label': string;
-            'open complementary sidebar label': string;
-            'close complementary sidebar label': string;
-            'sidebar title': string;
-            'complementary sidebar title': string;
-            'plugin error message': string;
-            'content fallback message': string;
-            'content fallback description': string;
-            'toggle fullscreen label': string;
-            'settings show hints label': string;
-            'settings native redirect label': string;
-            'settings new plank position start label': string;
-            'settings new plank position end label': string;
-            'select new plank positioning placeholder': string;
-            'select new plank positioning label': string;
-            'undo available label': string;
-            'undo action label': string;
-            'undo action alt': string;
-            'undo close label': string;
-            'error fallback message': string;
-            'plank heading fallback label': string;
-            'actions menu label': string;
-            'settings deck label': string;
-            'pending heading': string;
-            'insert plank label': string;
-            'resize label': string;
-            'pin start label': string;
-            'pin end label': string;
-            'increment start label': string;
-            'increment end label': string;
-            'show deck plank label': string;
-            'show solo plank label': string;
-            'exit fullscreen label': string;
-            'show fullscreen plank label': string;
-            'close label': string;
-            'minify label': string;
-            'open companion label': string;
-            'close companion label': string;
-            'settings overscroll label': string;
-            'select overscroll placeholder': string;
-            'settings overscroll centering label': string;
-            'settings overscroll none label': string;
-            'settings enable statusbar label': string;
-            'settings enable deck label': string;
-            'close current label': string;
-            'close others label': string;
-            'close all label': string;
-            'companion plank heading fallback label': string;
+import { meta } from './meta';
+export declare const translations: [{
+    readonly 'en-US': {
+        readonly [meta.id]: {
+            readonly 'plugin name': "Deck";
+            readonly 'settings title': "Deck settings";
+            readonly 'main header label': "Main header";
+            readonly 'open navigation sidebar label': "Open sidebar";
+            readonly 'collapse navigation sidebar label': "Minimize sidebar";
+            readonly 'open complementary sidebar label': "Open context sidebar";
+            readonly 'close complementary sidebar label': "Minimize context sidebar";
+            readonly 'sidebar title': "Navigation sidebar";
+            readonly 'complementary sidebar title': "Context sidebar";
+            readonly 'plugin error message': "Content failed to render.";
+            readonly 'content fallback message': "Unsupported";
+            readonly 'content fallback description': "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.";
+            readonly 'toggle fullscreen label': "Toggle fullscreen";
+            readonly 'settings show hints label': "Show hints";
+            readonly 'settings native redirect label': "Enable native url redirect (experimental)";
+            readonly 'settings new plank position start label': "Start";
+            readonly 'settings new plank position end label': "End";
+            readonly 'select new plank positioning placeholder': "Select new plank positioning";
+            readonly 'select new plank positioning label': "New plank positioning";
+            readonly 'undo available label': "Click to undo previous action.";
+            readonly 'undo action label': "Undo";
+            readonly 'undo action alt': "Undo previous action";
+            readonly 'undo close label': "Dismiss";
+            readonly 'error fallback message': "Unable to open this object";
+            readonly 'plank heading fallback label': "Untitled";
+            readonly 'actions menu label': "Options";
+            readonly 'settings deck label': "Disable deck";
+            readonly 'pending heading': "Loading…";
+            readonly 'insert plank label': "Open";
+            readonly 'resize label': "Drag to resize";
+            readonly 'pin start label': "Pin to the left sidebar";
+            readonly 'pin end label': "Pin to the right sidebar";
+            readonly 'increment start label': "Move to the left";
+            readonly 'increment end label': "Move to the right";
+            readonly 'show deck plank label': "Return to deck";
+            readonly 'show solo plank label': "Maximize";
+            readonly 'exit fullscreen label': "Exit fullscreen";
+            readonly 'show fullscreen plank label': "Fullscreen";
+            readonly 'close label': "Close";
+            readonly 'minify label': "Minify";
+            readonly 'open companion label': "Open companion";
+            readonly 'close companion label': "Close companion";
+            readonly 'settings overscroll label': "Plank scrolling";
+            readonly 'select overscroll placeholder': "Select plank scrolling behavior";
+            readonly 'settings overscroll centering label': "Centering";
+            readonly 'settings overscroll none label': "None";
+            readonly 'settings enable statusbar label': "Show status bar";
+            readonly 'settings enable deck label': "Enable Deck";
+            readonly 'settings encapsulated planks label': "Encapsulated planks";
+            readonly 'close current label': "Close current plank";
+            readonly 'close others label': "Close other planks";
+            readonly 'close all label': "Close all planks";
+            readonly 'companion plank heading fallback label': "Related";
+            readonly 'open item label': "Open";
         };
     };
-}[];
-export default _default;
+}];
 //# sourceMappingURL=translations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,wBA2DE"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,eAAO,MAAM,YAAY;;QAGnB,SAAA,CAAC,IAAI,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAwDR;;EAGwB,CAAC"}

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

@@ -1,25 +1,83 @@
-import { type DeepReadonly } from '@dxos/util';
+import { type Atom } from '@effect-atom/atom-react';
+import * as Effect from 'effect/Effect';
+import { Capability } from '@dxos/app-framework';
+import { type DeckState } from '../types';
 export declare namespace DeckCapabilities {
-    const DeckState: import("@dxos/app-framework").InterfaceDef<DeepReadonly<{
-        deck: {
-            solo?: string | undefined;
-            initialized: boolean;
-            active: string[];
-            activeCompanions?: {
-                [x: string]: string;
-            } | undefined;
-            inactive: string[];
-            fullscreen: boolean;
-            plankSizing: {
-                [x: string]: number;
-            };
-            companionFrameSizing: {
-                [x: string]: number;
+    const Settings: Capability.InterfaceDef<Atom.Writable<{
+        showHints?: boolean | undefined;
+        enableDeck?: boolean | undefined;
+        enableStatusbar?: boolean | undefined;
+        enableNativeRedirect?: boolean | undefined;
+        newPlankPositioning?: "start" | "end" | undefined;
+        overscroll?: "none" | "centering" | undefined;
+        encapsulatedPlanks?: boolean | undefined;
+    }, {
+        showHints?: boolean | undefined;
+        enableDeck?: boolean | undefined;
+        enableStatusbar?: boolean | undefined;
+        enableNativeRedirect?: boolean | undefined;
+        newPlankPositioning?: "start" | "end" | undefined;
+        overscroll?: "none" | "centering" | undefined;
+        encapsulatedPlanks?: boolean | undefined;
+    }>>;
+    /** Persisted state (stored in KVS/localStorage). */
+    const State: Capability.InterfaceDef<Atom.Writable<{
+        sidebarState: "closed" | "collapsed" | "expanded";
+        complementarySidebarState: "closed" | "collapsed" | "expanded";
+        complementarySidebarPanel?: string | undefined;
+        activeDeck: string;
+        previousDeck: string;
+        decks: {
+            [x: string]: {
+                initialized: boolean;
+                active: string[];
+                activeCompanions?: {
+                    [x: string]: string;
+                } | undefined;
+                inactive: string[];
+                solo?: string | undefined;
+                fullscreen: boolean;
+                plankSizing: {
+                    [x: string]: number;
+                };
+                companionFrameSizing: {
+                    [x: string]: number;
+                };
             };
         };
+        previousMode: {
+            [x: string]: "solo" | "deck" | "solo--fullscreen";
+        };
+    }, {
         sidebarState: "closed" | "collapsed" | "expanded";
         complementarySidebarState: "closed" | "collapsed" | "expanded";
         complementarySidebarPanel?: string | undefined;
+        activeDeck: string;
+        previousDeck: string;
+        decks: {
+            [x: string]: {
+                initialized: boolean;
+                active: string[];
+                activeCompanions?: {
+                    [x: string]: string;
+                } | undefined;
+                inactive: string[];
+                solo?: string | undefined;
+                fullscreen: boolean;
+                plankSizing: {
+                    [x: string]: number;
+                };
+                companionFrameSizing: {
+                    [x: string]: number;
+                };
+            };
+        };
+        previousMode: {
+            [x: string]: "solo" | "deck" | "solo--fullscreen";
+        };
+    }>>;
+    /** Transient/ephemeral state (not persisted). */
+    const EphemeralState: Capability.InterfaceDef<Atom.Writable<{
         dialogOpen: boolean;
         dialogType?: "default" | "alert" | undefined;
         dialogBlockAlign?: "start" | "end" | "center" | undefined;
@@ -32,15 +90,22 @@ export declare namespace DeckCapabilities {
         popoverSide?: "top" | "right" | "bottom" | "left" | undefined;
         popoverAnchor?: any;
         popoverAnchorId?: string | undefined;
+        popoverKind?: "base" | "card" | undefined;
+        popoverTitle?: string | [string, {
+            ns: string;
+            count?: number | undefined;
+            defaultValue?: string | undefined;
+        }] | undefined;
+        popoverContentRef?: string | undefined;
         popoverContent?: any;
         toasts: {
-            readonly id: string;
-            readonly title?: string | [string, {
+            readonly description?: string | [string, {
                 ns: string;
                 count?: number | undefined;
                 defaultValue?: string | undefined;
             }] | undefined;
-            readonly description?: string | [string, {
+            readonly id: string;
+            readonly title?: string | [string, {
                 ns: string;
                 count?: number | undefined;
                 defaultValue?: string | undefined;
@@ -65,51 +130,8 @@ export declare namespace DeckCapabilities {
             readonly onAction?: any;
         }[];
         currentUndoId?: string | undefined;
-        activeDeck: string;
-        previousDeck: string;
-        decks: {
-            [x: string]: {
-                solo?: string | undefined;
-                initialized: boolean;
-                active: string[];
-                activeCompanions?: {
-                    [x: string]: string;
-                } | undefined;
-                inactive: string[];
-                fullscreen: boolean;
-                plankSizing: {
-                    [x: string]: number;
-                };
-                companionFrameSizing: {
-                    [x: string]: number;
-                };
-            };
-        };
-        previousMode: {
-            [x: string]: "solo" | "deck" | "solo--fullscreen";
-        };
         scrollIntoView?: string | undefined;
-    }>>;
-    const MutableDeckState: import("@dxos/app-framework").InterfaceDef<{
-        deck: {
-            solo?: string | undefined;
-            initialized: boolean;
-            active: string[];
-            activeCompanions?: {
-                [x: string]: string;
-            } | undefined;
-            inactive: string[];
-            fullscreen: boolean;
-            plankSizing: {
-                [x: string]: number;
-            };
-            companionFrameSizing: {
-                [x: string]: number;
-            };
-        };
-        sidebarState: "closed" | "collapsed" | "expanded";
-        complementarySidebarState: "closed" | "collapsed" | "expanded";
-        complementarySidebarPanel?: string | undefined;
+    }, {
         dialogOpen: boolean;
         dialogType?: "default" | "alert" | undefined;
         dialogBlockAlign?: "start" | "end" | "center" | undefined;
@@ -122,15 +144,22 @@ export declare namespace DeckCapabilities {
         popoverSide?: "top" | "right" | "bottom" | "left" | undefined;
         popoverAnchor?: any;
         popoverAnchorId?: string | undefined;
+        popoverKind?: "base" | "card" | undefined;
+        popoverTitle?: string | [string, {
+            ns: string;
+            count?: number | undefined;
+            defaultValue?: string | undefined;
+        }] | undefined;
+        popoverContentRef?: string | undefined;
         popoverContent?: any;
         toasts: {
-            readonly id: string;
-            readonly title?: string | [string, {
+            readonly description?: string | [string, {
                 ns: string;
                 count?: number | undefined;
                 defaultValue?: string | undefined;
             }] | undefined;
-            readonly description?: string | [string, {
+            readonly id: string;
+            readonly title?: string | [string, {
                 ns: string;
                 count?: number | undefined;
                 defaultValue?: string | undefined;
@@ -155,30 +184,9 @@ export declare namespace DeckCapabilities {
             readonly onAction?: any;
         }[];
         currentUndoId?: string | undefined;
-        activeDeck: string;
-        previousDeck: string;
-        decks: {
-            [x: string]: {
-                solo?: string | undefined;
-                initialized: boolean;
-                active: string[];
-                activeCompanions?: {
-                    [x: string]: string;
-                } | undefined;
-                inactive: string[];
-                fullscreen: boolean;
-                plankSizing: {
-                    [x: string]: number;
-                };
-                companionFrameSizing: {
-                    [x: string]: number;
-                };
-            };
-        };
-        previousMode: {
-            [x: string]: "solo" | "deck" | "solo--fullscreen";
-        };
         scrollIntoView?: string | undefined;
-    }>;
+    }>>;
+    /** Get the current active deck from state. */
+    const getDeck: () => Effect.Effect<DeckState, Error, Capability.Service>;
 }
 //# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../../src/types/capabilities.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI/D,OAAO,EAAwD,KAAK,SAAS,EAAuB,MAAM,UAAU,CAAC;AAErH,yBAAiB,gBAAgB,CAAC;IACzB,MAAM,QAAQ;;;;;;;;;;;;;;;;OAAsF,CAAC;IAE5G,oDAAoD;IAC7C,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAgF,CAAC;IAEnG,iDAAiD;IAC1C,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAE1B,CAAC;IAEF,8CAA8C;IACvC,MAAM,OAAO,QAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAMzE,CAAC;CACN"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/types/events.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAO3D,yBAAiB,UAAU,CAAC;IACnB,MAAM,UAAU,EAAE,eAAe,CAAC,eAExC,CAAC;IAEF,mDAAmD;IAC5C,MAAM,aAAa,EAAE,eAAe,CAAC,eAE3C,CAAC;CACH"}

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

@@ -0,0 +1,4 @@
+export * from './capabilities';
+export * from './events';
+export * from './schema';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/src/{types.d.ts → types/schema.d.ts}

@@ -1,8 +1,9 @@
-import { Schema } from 'effect';
+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 = "dxos.org/plugin/deck/plank-companion";
-export declare const DECK_COMPANION_TYPE = "dxos.org/plugin/deck/deck-companion";
+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 OverscrollOptions: readonly ["none", "centering"];
@@ -16,6 +17,7 @@ export declare const DeckSettingsSchema: Schema.mutable<Schema.Struct<{
     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>;
@@ -37,10 +39,27 @@ declare const LayoutMode: Schema.Literal<["deck", "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 DeckPluginState: Schema.mutable<Schema.Struct<{
+export declare const DeckStateSchema: Schema.mutable<Schema.Struct<{
     sidebarState: Schema.Literal<["closed", "collapsed", "expanded"]>;
     complementarySidebarState: Schema.Literal<["closed", "collapsed", "expanded"]>;
     complementarySidebarPanel: Schema.optional<typeof Schema.String>;
+    activeDeck: typeof Schema.String;
+    previousDeck: typeof Schema.String;
+    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;
+        active: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+        activeCompanions: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+        inactive: Schema.mutable<Schema.Array$<typeof Schema.String>>;
+        solo: Schema.optional<typeof Schema.String>;
+        fullscreen: typeof Schema.Boolean;
+        plankSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
+        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"]>>>;
+}>>;
+export type DeckStateProps = Schema.Schema.Type<typeof DeckStateSchema>;
+export declare const DeckEphemeralStateSchema: Schema.mutable<Schema.Struct<{
     dialogOpen: typeof Schema.Boolean;
     dialogType: Schema.optional<Schema.Literal<["default", "alert"]>>;
     dialogBlockAlign: Schema.optional<Schema.Literal<["start", "center", "end"]>>;
@@ -52,6 +71,14 @@ export declare const DeckPluginState: Schema.mutable<Schema.Struct<{
     popoverSide: Schema.optional<Schema.Literal<["top", "right", "bottom", "left"]>>;
     popoverAnchor: Schema.optional<typeof Schema.Any>;
     popoverAnchorId: Schema.optional<typeof Schema.String>;
+    popoverKind: Schema.optional<Schema.Literal<["base", "card"]>>;
+    popoverTitle: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Tuple2<typeof Schema.String, Schema.mutable<Schema.Struct<{
+        ns: typeof Schema.String;
+        count: Schema.optional<typeof Schema.Number>;
+        defaultValue: Schema.optional<typeof Schema.String>;
+    }>>>>]>>;
+    /** 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>;
     toasts: Schema.mutable<Schema.Array$<Schema.Struct<{
@@ -86,36 +113,11 @@ export declare const DeckPluginState: Schema.mutable<Schema.Struct<{
         onAction: Schema.optional<Schema.SchemaClass<any, any, never>>;
     }>>>;
     currentUndoId: Schema.optional<typeof Schema.String>;
-    activeDeck: typeof Schema.String;
-    previousDeck: typeof Schema.String;
-    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;
-        active: Schema.mutable<Schema.Array$<typeof Schema.String>>;
-        activeCompanions: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
-        inactive: Schema.mutable<Schema.Array$<typeof Schema.String>>;
-        solo: Schema.optional<typeof Schema.String>;
-        fullscreen: typeof Schema.Boolean;
-        plankSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
-        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"]>>>;
-    deck: Schema.mutable<Schema.Struct<{
-        /** If false, the deck has not yet left solo mode and new planks should be soloed. */
-        initialized: typeof Schema.Boolean;
-        active: Schema.mutable<Schema.Array$<typeof Schema.String>>;
-        activeCompanions: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
-        inactive: Schema.mutable<Schema.Array$<typeof Schema.String>>;
-        solo: Schema.optional<typeof Schema.String>;
-        fullscreen: typeof Schema.Boolean;
-        plankSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
-        companionFrameSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
-    }>>;
     /** The identifier of a component to scroll into view when it is mounted. */
     scrollIntoView: Schema.optional<typeof Schema.String>;
 }>>;
-export type DeckPluginState = Schema.Schema.Type<typeof DeckPluginState>;
-export declare const DECK_ACTION: string;
+export type DeckEphemeralStateProps = Schema.Schema.Type<typeof DeckEphemeralStateSchema>;
+export type DeckPluginState = DeckStateProps & DeckEphemeralStateProps;
 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>;
@@ -124,8 +126,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}/adjust`, {
-        readonly _tag: Schema.tag<`${string}/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;
@@ -135,8 +137,8 @@ export declare namespace DeckAction {
     }>;
     export class Adjust extends Adjust_base {
     }
-    const UpdatePlankSize_base: Schema.TaggedClass<UpdatePlankSize, `${string}/update-plank-size`, {
-        readonly _tag: Schema.tag<`${string}/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;
@@ -146,8 +148,8 @@ export declare namespace DeckAction {
     }>;
     export class UpdatePlankSize extends UpdatePlankSize_base {
     }
-    const ChangeCompanion_base: Schema.TaggedClass<ChangeCompanion, `${string}/change-companion`, {
-        readonly _tag: Schema.tag<`${string}/change-companion`>;
+    const ChangeCompanion_base: Schema.TaggedClass<ChangeCompanion, `${string}/action/change-companion`, {
+        readonly _tag: Schema.tag<`${string}/action/change-companion`>;
     } & {
         input: Schema.Struct<{
             primary: typeof Schema.String;
@@ -159,4 +161,63 @@ export declare namespace DeckAction {
     }
     export {};
 }
-//# sourceMappingURL=types.d.ts.map
+/**
+ * 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<{
+                primary: typeof Schema.String;
+                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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/types/schema.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,24 @@
 import { type AttentionManager } from '@dxos/plugin-attention';
-import { type DeckPluginState } from '../types';
+import { type DeckState } from '../types';
 export type SetActiveOptions = {
     next: string[];
-    state: DeckPluginState;
+    deck: DeckState;
     attention?: AttentionManager;
 };
-export declare const setActive: ({ next, state, attention }: SetActiveOptions) => string | undefined;
+export type SetActiveResult = {
+    /** Updates to apply to the deck. */
+    deckUpdates: {
+        inactive: string[];
+        solo: string | undefined;
+        active: string[];
+        fullscreen: boolean;
+    };
+    /** ID of the item to attend (scroll into view) if attention changed. */
+    toAttend?: string;
+};
+/**
+ * Computes the new active state for the deck without mutating.
+ * Returns the updates to apply and optionally an item to attend.
+ */
+export declare const computeActiveUpdates: ({ next, deck, attention }: SetActiveOptions) => SetActiveResult;
 //# sourceMappingURL=set-active.d.ts.map

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":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,4BAA4B,gBAAgB,uBA8BrE,CAAC"}
+{"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"}