@dxos/plugin-deck 0.9.1-main.c7dcc2e112 → 0.10.0

package/dist/types/src/containers/Deck/DeckViewport.d.ts

@@ -10,7 +10,9 @@ export declare const DeckContentEmpty: () => React.JSX.Element;
  */
 export declare const DeckSoloMode: () => React.JSX.Element;
 /**
- * Multi-plank horizontal scrolling layout.
+ * Multi-plank horizontal scrolling layout. Planks are resizable {@link Mosaic.Tile}s in a horizontal
+ * {@link Mosaic.Stack}; the scroll position is preserved across solo↔multi transitions and the
+ * just-navigated plank is scrolled into view.
  */
 export declare const DeckMultiMode: () => React.JSX.Element;
 //# sourceMappingURL=DeckViewport.d.ts.map

package/dist/types/src/containers/Deck/DeckViewport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeckViewport.d.ts","sourceRoot":"","sources":["../../../../../src/containers/Deck/DeckViewport.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAGZ,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AA+Bf,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;qCAKrB,EAAE,QAAQ,EAAE,EAAE,iBAAiB;;;;AAkD5D,eAAO,MAAM,gBAAgB,yBAW5B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,YAAY,yBA8CxB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,aAAa,yBAsFzB,CAAC"}
+{"version":3,"file":"DeckViewport.d.ts","sourceRoot":"","sources":["../../../../../src/containers/Deck/DeckViewport.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAkC,MAAM,OAAO,CAAC;AAkCtF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;qCAKrB,EAAE,QAAQ,EAAE,EAAE,iBAAiB;;;;AA+C5D,eAAO,MAAM,gBAAgB,yBAW5B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,YAAY,yBAsCxB,CAAC;AAiDF;;;;GAIG;AACH,eAAO,MAAM,aAAa,yBAwEzB,CAAC"}

package/dist/types/src/containers/{Plank → Deck}/PlankControls.d.ts

@@ -1,15 +1,8 @@
 import React from 'react';
 import { type ButtonGroupProps } from '@dxos/react-ui';
-import { type DeckAction, type LayoutMode } from '#types';
-export type PlankControlHandler = (event: DeckAction.PartAdjustment) => void;
-export type PlankCapabilities = {
-    incrementStart?: boolean;
-    incrementEnd?: boolean;
-    deck?: boolean;
-    solo?: boolean;
-    fullscreen?: boolean;
-    companion?: boolean;
-};
+import { type DeckOperation, type LayoutMode } from '#types';
+import { type PlankCapabilities } from './useDeckPlank';
+export type PlankControlHandler = (event: DeckOperation.PartAdjustment) => void;
 export type PlankCompanionControlsProps = {
     primary?: string;
 };

package/dist/types/src/containers/Deck/PlankControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlankControls.d.ts","sourceRoot":"","sources":["../../../../../src/containers/Deck/PlankControls.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAkC,MAAM,OAAO,CAAC;AAIvD,OAAO,EAAe,KAAK,gBAAgB,EAAgD,MAAM,gBAAgB,CAAC;AAGlH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,KAAK,IAAI,CAAC;AAQhF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,sBAAsB,oGAmBlC,CAAC;AAUF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GAAG;IACnE,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,GAAG,YAAY,CAAC;IAChD,YAAY,EAAE,iBAAiB,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;CAChC,CAAC;AAKF,eAAO,MAAM,aAAa,wGAkHzB,CAAC"}

package/dist/types/src/containers/Deck/PlankFallback.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { type ErrorFallbackProps } from '@dxos/react-ui';
+export declare const PlankLoading: () => React.JSX.Element;
+/** User-facing error fallback for a plank's content Surface. */
+export declare const PlankErrorFallback: ({ error }: ErrorFallbackProps) => React.JSX.Element;
+//# sourceMappingURL=PlankFallback.d.ts.map

package/dist/types/src/containers/Deck/PlankFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlankFallback.d.ts","sourceRoot":"","sources":["../../../../../src/containers/Deck/PlankFallback.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAGzC,OAAO,EAAiB,KAAK,kBAAkB,EAAkB,MAAM,gBAAgB,CAAC;AAMxF,eAAO,MAAM,YAAY,yBAAyE,CAAC;AAEnG,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,cAAe,kBAAkB,sBAyB/D,CAAC"}

package/dist/types/src/containers/Deck/useDeckPlank.d.ts

@@ -0,0 +1,49 @@
+import { type AttentionSigilAction } from '@dxos/app-toolkit/ui';
+import { type Node } from '@dxos/plugin-graph';
+import { DeckOperation, type LayoutMode, type ResolvedPart } from '#types';
+/** Capability flags that gate the plank toolbar controls. */
+export type PlankCapabilities = {
+    deck?: boolean;
+    solo?: boolean;
+    incrementStart?: boolean;
+    incrementEnd?: boolean;
+    fullscreen?: boolean;
+    companion?: boolean;
+};
+export type UseDeckPlankOptions = {
+    id: string;
+    /** Resolved part for the primary plank (`solo` | `multi` | `complementary`). */
+    part: ResolvedPart;
+    layoutMode: LayoutMode;
+    /** Ordered active planks (multi mode); enables increment/close-range semantics. */
+    active?: string[];
+    /** Whether the companion pane should be shown for this plank (gated further by attention in multi-mode). */
+    companionShown?: boolean;
+    deckEnabled?: boolean;
+};
+export type DeckPlank = {
+    node: Node.Node | undefined;
+    companions: Node.Node[];
+    resolvedCompanionId: string | undefined;
+    currentCompanion: Node.Node | undefined;
+    hasCompanion: boolean;
+    /** Splitter orientation for the companion pane (defaults to `horizontal`). */
+    companionOrientation: 'horizontal' | 'vertical';
+    capabilities: PlankCapabilities;
+    /** Grouped sigil-menu actions, or `undefined` when the node is unresolved. */
+    sigilActions: AttentionSigilAction[][] | undefined;
+    popoverAnchorId?: string;
+    scrollIntoView?: string;
+    onAction: (action: AttentionSigilAction) => void;
+    onAdjust: (type: DeckOperation.PartAdjustment) => void;
+    onResize: (size: number) => void;
+    onScrollIntoView: (subject?: string) => void;
+    onUpdateCompanion: (companion: string | null) => void;
+};
+/**
+ * Resolves the graph node, companions, capabilities and sigil actions for a deck plank, and exposes the
+ * operation dispatchers that mutate deck layout state. This re-homes the framework wiring that the legacy
+ * `PlankContainer`/`PlankHeading` bundled, so the presentational components stay free of capabilities.
+ */
+export declare const useDeckPlank: ({ id, part, layoutMode, active, companionShown, deckEnabled, }: UseDeckPlankOptions) => DeckPlank;
+//# sourceMappingURL=useDeckPlank.d.ts.map

package/dist/types/src/containers/Deck/useDeckPlank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeckPlank.d.ts","sourceRoot":"","sources":["../../../../../src/containers/Deck/useDeckPlank.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAS,KAAK,IAAI,EAAwC,MAAM,oBAAoB,CAAC;AAK5F,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAwB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKjG,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4GAA4G;IAC5G,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACxB,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,gBAAgB,EAAE,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,oBAAoB,EAAE,YAAY,GAAG,UAAU,CAAC;IAChD,YAAY,EAAE,iBAAiB,CAAC;IAChC,8EAA8E;IAC9E,YAAY,EAAE,oBAAoB,EAAE,EAAE,GAAG,SAAS,CAAC;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,cAAc,KAAK,IAAI,CAAC;IACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,mEAOtB,mBAAmB,KAAG,SAgJxB,CAAC"}

package/dist/types/src/containers/DeckLayout/DeckLayout.stories.d.ts

@@ -10,7 +10,6 @@ declare const meta: {
             readonly 'en-US': {
                 readonly [x: string]: {
                     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': 'Close sidebar';
@@ -44,7 +43,8 @@ declare const meta: {
                     readonly 'show-fullscreen-plank.label': 'Fullscreen';
                     readonly 'close.label': 'Close';
                     readonly 'minify.label': 'Minify';
-                    readonly 'open-companion.label': 'Open companion';
+                    readonly 'open-companion.label': 'Open companion side-by-side';
+                    readonly 'open-companion-vertical.label': 'Open companion stacked';
                     readonly 'close-companion.label': 'Close companion';
                     readonly 'close-current.label': 'Close current plank';
                     readonly 'close-others.label': 'Close other planks';

package/dist/types/src/containers/DeckLayout/DeckLayout.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeckLayout.stories.d.ts","sourceRoot":"","sources":["../../../../../src/containers/DeckLayout/DeckLayout.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAA8B,MAAM,OAAO,CAAC;AAoVnD,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcyB,CAAC;eAErB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,IAAI,EAAE,KAUlB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAUnB,CAAC"}
+{"version":3,"file":"DeckLayout.stories.d.ts","sourceRoot":"","sources":["../../../../../src/containers/DeckLayout/DeckLayout.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAA8B,MAAM,OAAO,CAAC;AAuUnD,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcyB,CAAC;eAErB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,IAAI,EAAE,KAUlB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAUnB,CAAC"}

package/dist/types/src/{components → containers}/DeckSettings/DeckSettings.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { Settings } from '#types';
-export type DeckSettingsProps = AppSurface.SettingsArticleProps<Settings.Settings>;
+export type DeckSettingsProps = AppSurface.SettingsProps<Settings.Settings>;
 export declare const DeckSettings: ({ settings, onSettingsChange }: DeckSettingsProps) => React.JSX.Element;
 //# sourceMappingURL=DeckSettings.d.ts.map

package/dist/types/src/containers/DeckSettings/DeckSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckSettings.d.ts","sourceRoot":"","sources":["../../../../../src/containers/DeckSettings/DeckSettings.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAIlC,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAE5E,eAAO,MAAM,YAAY,mCAAoC,iBAAiB,sBAwB7E,CAAC"}

package/dist/types/src/{components → containers}/DeckSettings/DeckSettings.stories.d.ts

@@ -10,7 +10,6 @@ declare const meta: {
             readonly 'en-US': {
                 readonly [x: string]: {
                     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': 'Close sidebar';
@@ -44,7 +43,8 @@ declare const meta: {
                     readonly 'show-fullscreen-plank.label': 'Fullscreen';
                     readonly 'close.label': 'Close';
                     readonly 'minify.label': 'Minify';
-                    readonly 'open-companion.label': 'Open companion';
+                    readonly 'open-companion.label': 'Open companion side-by-side';
+                    readonly 'open-companion-vertical.label': 'Open companion stacked';
                     readonly 'close-companion.label': 'Close companion';
                     readonly 'close-current.label': 'Close current plank';
                     readonly 'close-others.label': 'Close other planks';

package/dist/types/src/{components → containers}/DeckSettings/DeckSettings.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeckSettings.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/DeckSettings/DeckSettings.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQjE,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KASrB,CAAC"}
+{"version":3,"file":"DeckSettings.stories.d.ts","sourceRoot":"","sources":["../../../../../src/containers/DeckSettings/DeckSettings.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQjE,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS2B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KASrB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/containers/DeckSettings/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -1,6 +1,6 @@
 import { type ComponentType } from 'react';
 export * from './Deck';
-export * from './Plank';
 export * from './Sidebar';
 export declare const DeckLayout: ComponentType<any>;
+export declare const DeckSettings: ComponentType<any>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/containers/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAQ,MAAM,OAAO,CAAC;AAEjD,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAE1B,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,GAAG,CAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/containers/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAQ,MAAM,OAAO,CAAC;AAEjD,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAE1B,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,GAAG,CAAsC,CAAC;AACjF,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,GAAG,CAAwC,CAAC"}

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

@@ -1,8 +1,10 @@
 export * from './useBreakpoints';
 export * from './useCompanions';
+export * from './useCompanionSplit';
 export * from './useDeckCompanions';
 export * from './useDeckState';
 export * from './useMainSize';
 export * from './useNodeActionExpander';
 export * from './useSelectedCompanion';
+export * from './useSelectedCompanionVariant';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC"}

package/dist/types/src/hooks/useCompanionSplit.d.ts

@@ -0,0 +1,28 @@
+import * as Schema from 'effect/Schema';
+import { type SplitterOrientation } from '@dxos/react-ui';
+import { type AspectDef } from '@dxos/react-ui-attention';
+/** Companion split point (rem) used until the user resizes a given orientation. */
+export declare const DEFAULT_COMPANION_SIZE = 30;
+declare const CompanionSplitSchema: Schema.mutable<Schema.Struct<{
+    horizontal: Schema.optional<typeof Schema.Number>;
+    vertical: Schema.optional<typeof Schema.Number>;
+}>>;
+export type CompanionSplit = Schema.Schema.Type<typeof CompanionSplitSchema>;
+/**
+ * Companion splitter sizes (rem), memoized separately for each orientation so toggling the companion
+ * between side-by-side and stacked restores that orientation's last split point. Stored in the `local`
+ * backend (localStorage, persisted across reloads) via react-ui-attention view state.
+ */
+export declare const companionSplitAspect: AspectDef<CompanionSplit>;
+export type UseCompanionSplit = {
+    /** The remembered split point for the current orientation (or the default). */
+    size: number;
+    onSizeChange: (size: number) => void;
+};
+/**
+ * Reads and writes the global companion splitter size keyed by `orientation`. A live size keeps dragging
+ * smooth while the persisted write is debounced (and flushed on unmount) to avoid per-frame storage writes.
+ */
+export declare const useCompanionSplit: (orientation: SplitterOrientation) => UseCompanionSplit;
+export {};
+//# sourceMappingURL=useCompanionSplit.d.ts.map

package/dist/types/src/hooks/useCompanionSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompanionSplit.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useCompanionSplit.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,KAAK,SAAS,EAAsD,MAAM,0BAA0B,CAAC;AAI9G,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAKzC,QAAA,MAAM,oBAAoB;;;GAGH,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,cAAc,CAKzD,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,gBAAiB,mBAAmB,KAAG,iBA8BpE,CAAC"}

package/dist/types/src/hooks/useCompanions.d.ts

@@ -1,8 +1,12 @@
-export declare const useCompanions: (id?: string) => Readonly<{
-    id: string;
-    type: string;
-    cacheable?: string[];
-    properties: Readonly<Record<string, any>>;
-    data: any;
-}>[];
+import { type Node } from '@dxos/plugin-graph';
+/**
+ * Companion (child) nodes for a plank.
+ *
+ * The node's child-connections atom is read in a commit-phase effect rather than during render.
+ * Subscribing to it during render (via `useConnections`/`useAtomValue`) recomputes the shared atom and
+ * synchronously notifies its other subscribers — notably navtree items rendering the same node — which
+ * surfaces as a React "cannot update a component while rendering a different component" warning. Reading
+ * it from an effect defers that notification to the commit phase where cross-component updates are allowed.
+ */
+export declare const useCompanions: (id?: string) => Node.Node[];
 //# sourceMappingURL=useCompanions.d.ts.map

package/dist/types/src/hooks/useCompanions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCompanions.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useCompanions.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,aAAa,QAAS,MAAM;;;;;;IAKxC,CAAC"}
+{"version":3,"file":"useCompanions.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useCompanions.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAK/C;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,QAAS,MAAM,KAAG,IAAI,CAAC,IAAI,EA2BpD,CAAC"}

package/dist/types/src/hooks/useDeckCompanions.d.ts

@@ -1,12 +1,12 @@
 import { type Node as NodeType } from '@dxos/plugin-graph';
 import { type Label } from '@dxos/ui-types/translations';
-import { type Position } from '@dxos/util';
+import { Position } from '@dxos/util';
 export type DeckCompanion = NodeType.Node<any, {
     label: Label;
     icon: string;
     /** If true, the panel will not be wrapped in a scroll area. */
     fixed?: boolean;
-    position?: Position;
+    position?: Position.Position;
     joyride?: string;
 }>;
 export declare const useDeckCompanions: () => DeckCompanion[];

package/dist/types/src/hooks/useDeckCompanions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDeckCompanions.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useDeckCompanions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAQ,KAAK,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,YAAY,CAAC;AAIvD,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CACvC,GAAG,EACH;IACE,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,aAAa,EAKjD,CAAC"}
+{"version":3,"file":"useDeckCompanions.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useDeckCompanions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAQ,KAAK,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CACvC,GAAG,EACH;IACE,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,aAAa,EAKjD,CAAC"}

package/dist/types/src/hooks/useDeckState.d.ts

@@ -1,4 +1,4 @@
-import { type EphemeralDeckState, type DeckPluginState, type DeckState, type StoredDeckState } from '#types';
+import { type DeckPluginState, type DeckState, type EphemeralDeckState, type StoredDeckState } from '#types';
 export type DeckStateHook = {
     /** Combined state value (reactive). Includes both persisted and ephemeral state. */
     state: DeckPluginState;

package/dist/types/src/hooks/useDeckState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDeckState.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useDeckState.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,QAAQ,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG;IAC1B,oFAAoF;IACpF,KAAK,EAAE,eAAe,CAAC;IACvB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,8BAA8B;IAC9B,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,eAAe,KAAK,IAAI,CAAC;IACzE,8BAA8B;IAC9B,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,kBAAkB,KAAK,IAAI,CAAC;CACpF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,aAsC/B,CAAC"}
+{"version":3,"file":"useDeckState.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useDeckState.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,QAAQ,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG;IAC1B,oFAAoF;IACpF,KAAK,EAAE,eAAe,CAAC;IACvB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,8BAA8B;IAC9B,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,eAAe,KAAK,IAAI,CAAC;IACzE,8BAA8B;IAC9B,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,kBAAkB,KAAK,IAAI,CAAC;CACpF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,aAsC/B,CAAC"}

package/dist/types/src/hooks/useSelectedCompanionVariant.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reads the globally-selected companion variant (persisted via view state) so reopening the companion
+ * restores the last-selected tab rather than resetting to the first.
+ */
+export declare const useSelectedCompanionVariant: () => string | undefined;
+//# sourceMappingURL=useSelectedCompanionVariant.d.ts.map

package/dist/types/src/hooks/useSelectedCompanionVariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectedCompanionVariant.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useSelectedCompanionVariant.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAO,MAAM,GAAG,SACoB,CAAC"}

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

@@ -1,3 +1,4 @@
 export * from './meta';
 export * from './types';
+export { COMPANION_VIEW_STATE_CONTEXT, type CompanionSelection, companionVariantAspect, } from './util/companion-view-state';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC"}

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

@@ -16,6 +16,7 @@ export declare const meta: {
         } | undefined;
         readonly dependsOn?: readonly string[] | undefined;
         readonly spec?: string | undefined;
+        readonly createdAt?: string | undefined;
         readonly author?: string | undefined;
     };
     readonly release?: {
@@ -24,6 +25,9 @@ export declare const meta: {
         readonly dependencies?: {
             readonly [x: string]: string;
         } | undefined;
+        readonly pluginKey?: string | undefined;
+        readonly manifestHash?: string | undefined;
+        readonly createdAt?: string | undefined;
     } | undefined;
 };
 //# sourceMappingURL=meta.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAmC,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAmC,CAAC"}

package/dist/types/src/operations/adjust.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adjust.d.ts","sourceRoot":"","sources":["../../../../src/operations/adjust.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM1C,OAAO,EAAoB,aAAa,EAAwB,MAAM,UAAU,CAAC;AAIjF,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,aAAa,CAAC,MAAM,CA2D/D,CAAC;eAEa,OAAO"}
+{"version":3,"file":"adjust.d.ts","sourceRoot":"","sources":["../../../../src/operations/adjust.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK1C,OAAO,EAAoB,aAAa,EAAwB,MAAM,UAAU,CAAC;AAIjF,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,aAAa,CAAC,MAAM,CAuE/D,CAAC;eAEa,OAAO"}

package/dist/types/src/operations/update-companion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-companion.d.ts","sourceRoot":"","sources":["../../../../src/operations/update-companion.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM1C,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,eAAe,CAkB1E,CAAC;eAEa,OAAO"}
+{"version":3,"file":"update-companion.d.ts","sourceRoot":"","sources":["../../../../src/operations/update-companion.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAQ1C,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,eAAe,CAoB1E,CAAC;eAEa,OAAO"}

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

@@ -2,7 +2,6 @@ export declare const translations: [{
     readonly 'en-US': {
         readonly [x: string]: {
             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': 'Close sidebar';
@@ -36,7 +35,8 @@ export declare const translations: [{
             readonly 'show-fullscreen-plank.label': 'Fullscreen';
             readonly 'close.label': 'Close';
             readonly 'minify.label': 'Minify';
-            readonly 'open-companion.label': 'Open companion';
+            readonly 'open-companion.label': 'Open companion side-by-side';
+            readonly 'open-companion-vertical.label': 'Open companion stacked';
             readonly 'close-companion.label': 'Close companion';
             readonly 'close-current.label': 'Close current plank';
             readonly 'close-others.label': 'Close other planks';

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

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY;;;oCAIF,MAAM;uCACH,eAAe;0CACZ,aAAa;sDACD,cAAc;0DACV,eAAe;yDAChB,sBAAsB;0DACrB,uBAAuB;sCAC3C,oBAAoB;oDACN,iBAAiB;6CACxB,2BAA2B;iDACvB,aAAa;qDAEvC,8JAA+I;gDACtH,mBAAmB;6CACtB,gCAAgC;0CACnC,MAAM;wCACR,sBAAsB;yCACrB,SAAS;+CACH,4BAA4B;kDACzB,MAAM;qDACH,UAAU;2CACpB,SAAS;4CACR,cAAc;wCAClB,eAAU;2CACP,MAAM;qCACZ,gBAAgB;wCACb,yBAAyB;sCAC3B,0BAA0B;8CAClB,kBAAkB;4CACpB,mBAAmB;8CACjB,gBAAgB;8CAChB,UAAU;8CACV,iBAAiB;oDACX,YAAY;oCAC5B,OAAO;qCACN,QAAQ;6CACA,gBAAgB;8CACf,iBAAiB;4CACnB,qBAAqB;2CACtB,oBAAoB;wCACvB,kBAAkB;wDACF,OAAO;+DACA,SAAS;mDACrB,uBAAuB;6CAC7B,6BAA6B;mDACvB,kCAAkC;oDACjC,eAAe;kDACjB,sBAAsB;;;EAI5B,CAAC"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY;;;oCAIF,MAAM;0CACA,aAAa;sDACD,cAAc;0DACV,eAAe;yDAChB,sBAAsB;0DACrB,uBAAuB;sCAC3C,oBAAoB;oDACN,iBAAiB;6CACxB,2BAA2B;iDACvB,aAAa;qDAEvC,8JAA+I;gDACtH,mBAAmB;6CACtB,gCAAgC;0CACnC,MAAM;wCACR,sBAAsB;yCACrB,SAAS;+CACH,4BAA4B;kDACzB,MAAM;qDACH,UAAU;2CACpB,SAAS;4CACR,cAAc;wCAClB,eAAU;2CACP,MAAM;qCACZ,gBAAgB;wCACb,yBAAyB;sCAC3B,0BAA0B;8CAClB,kBAAkB;4CACpB,mBAAmB;8CACjB,gBAAgB;8CAChB,UAAU;8CACV,iBAAiB;oDACX,YAAY;oCAC5B,OAAO;qCACN,QAAQ;6CACA,6BAA6B;sDACpB,wBAAwB;8CAChC,iBAAiB;4CACnB,qBAAqB;2CACtB,oBAAoB;wCACvB,kBAAkB;wDACF,OAAO;+DACA,SAAS;mDACrB,uBAAuB;6CAC7B,6BAA6B;mDACvB,kCAAkC;oDACjC,eAAe;kDACjB,sBAAsB;;;EAI5B,CAAC"}

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

@@ -21,7 +21,7 @@ export declare const State: Capability.InterfaceDef<Atom.Writable<{
                 [x: string]: number;
             };
             companionOpen: boolean;
-            companionVariant?: string | undefined;
+            companionOrientation?: "horizontal" | "vertical" | undefined;
             companionFrameSizing: {
                 [x: string]: number;
             };
@@ -47,7 +47,7 @@ export declare const State: Capability.InterfaceDef<Atom.Writable<{
                 [x: string]: number;
             };
             companionOpen: boolean;
-            companionVariant?: string | undefined;
+            companionOrientation?: "horizontal" | "vertical" | undefined;
             companionFrameSizing: {
                 [x: string]: number;
             };

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

@@ -1 +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,sGAEpB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAA0F,CAAC;AAE7G,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"}
+{"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,EAAE,KAAK,SAAS,EAAiD,MAAM,UAAU,CAAC;AAEzF,eAAO,MAAM,QAAQ,sGAEpB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAA0F,CAAC;AAE7G,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/DeckOperation.d.ts

@@ -1,11 +1,11 @@
 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"]>]>;
+declare const PartAdjustmentSchema: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["companion-vertical"]>, 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";
+    readonly type: "close" | "companion" | "companion-vertical" | "increment-end" | "increment-start" | "solo" | "solo--fullscreen";
 }, void, Capability.Service>;
 export declare const UpdatePlankSize: Operation.Definition<{
     readonly id: string;

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

@@ -1 +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;AAO1C,QAAA,MAAM,oBAAoB,kNAOzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E,eAAO,MAAM,MAAM;;;4BAajB,CAAC;AAEH,eAAO,MAAM,eAAe;;;4BAa1B,CAAC"}
+{"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;AAO1C,QAAA,MAAM,oBAAoB,0PAQzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E,eAAO,MAAM,MAAM;;;4BAajB,CAAC;AAEH,eAAO,MAAM,eAAe;;;4BAa1B,CAAC"}

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

@@ -21,8 +21,8 @@ export declare const DeckState: Schema.Struct<{
     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>;
+    /** Orientation of the companion splitter: `horizontal` (side-by-side) or `vertical` (stacked). */
+    companionOrientation: Schema.optional<Schema.Literal<["horizontal", "vertical"]>>;
     /** Persisted companion frame widths in rem, keyed by frame ID. */
     companionFrameSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
 }>;
@@ -53,8 +53,8 @@ export declare const StoredDeckState: Schema.mutable<Schema.Struct<{
         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>;
+        /** Orientation of the companion splitter: `horizontal` (side-by-side) or `vertical` (stacked). */
+        companionOrientation: Schema.optional<Schema.Literal<["horizontal", "vertical"]>>;
         /** Persisted companion frame widths in rem, keyed by frame ID. */
         companionFrameSizing: Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.Number>>;
     }>>>>;
@@ -129,11 +129,11 @@ export declare const EphemeralDeckState: Schema.mutable<Schema.Struct<{
 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"]>]>;
+    const PartAdjustmentSchema: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["companion-vertical"]>, 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 Adjustment: Schema.mutable<Schema.Struct<{
         id: typeof Schema.String;
-        type: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
+        type: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["companion-vertical"]>, 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`, {
@@ -141,7 +141,7 @@ export declare namespace DeckAction {
     } & {
         input: Schema.mutable<Schema.Struct<{
             id: typeof Schema.String;
-            type: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
+            type: Schema.Union<[Schema.Literal<["close"]>, Schema.Literal<["companion"]>, Schema.Literal<["companion-vertical"]>, Schema.Literal<["solo"]>, Schema.Literal<["solo--fullscreen"]>, Schema.Literal<["increment-start"]>, Schema.Literal<["increment-end"]>]>;
         }>>;
         output: typeof Schema.Void;
     }>;

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":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,eAAO,MAAM,oBAAoB,yCAA+B,CAAC;AACjE,eAAO,MAAM,mBAAmB,wCAA8B,CAAC;AAE/D,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,oBASpC;KAAG;;CACL"}
+{"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,eAAO,MAAM,oBAAoB,yCAA+B,CAAC;AACjE,eAAO,MAAM,mBAAmB,wCAA8B,CAAC;AAE/D,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,kGAAkG;;IAElG,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,kGAAkG;;QAElG,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,0PAQzB,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,oBASpC;KAAG;;CACL"}

package/dist/types/src/util/companion-view-state.d.ts

@@ -0,0 +1,16 @@
+import * as Schema from 'effect/Schema';
+import { type AspectDef } from '@dxos/react-ui-attention';
+/** Global context shared by the deck-companion view-state aspects (split point + selected variant). */
+export declare const COMPANION_VIEW_STATE_CONTEXT = "deck-companion";
+declare const CompanionSelectionSchema: Schema.mutable<Schema.Struct<{
+    /** Linked variant of the currently selected companion tab. */
+    variant: Schema.optional<typeof Schema.String>;
+}>>;
+export type CompanionSelection = Schema.Schema.Type<typeof CompanionSelectionSchema>;
+/**
+ * The globally-selected companion variant, persisted (localStorage) so reopening the companion restores
+ * the last-selected tab. Stored via react-ui-attention view state for consistency with the split point.
+ */
+export declare const companionVariantAspect: AspectDef<CompanionSelection>;
+export {};
+//# sourceMappingURL=companion-view-state.d.ts.map

package/dist/types/src/util/companion-view-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-view-state.d.ts","sourceRoot":"","sources":["../../../../src/util/companion-view-state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,0BAA0B,CAAC;AAE3E,uGAAuG;AACvG,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D,QAAA,MAAM,wBAAwB;IAC5B,8DAA8D;;GAEzC,CAAC;AAExB,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,CAAC,kBAAkB,CAK/D,CAAC"}

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

@@ -1,3 +1,4 @@
+export * from './companion-view-state';
 export * from './layoutAppliesTopbar';
 export * from './plank-url-params';
 export * from './sanitize-persisted-state';

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,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC"}

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

@@ -5,6 +5,8 @@
 export declare const serializePlanks: (active: readonly string[], existingSearch: string) => string;
 /**
  * Deserialize plank query params from a URL back to qualified graph IDs.
+ * Duplicates are dropped (preserving first occurrence): a shared or hand-edited URL may repeat a
+ * `plank` param, and the deck's `active` list must stay unique so each plank renders under a distinct key.
  */
 export declare const deserializePlanks: (url: URL) => string[];
 /**

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

@@ -1 +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"}
+{"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;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAS,GAAG,KAAG,MAAM,EAElD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,mBAAoB,MAAM,KAAG,MAIpD,CAAC"}