@jbrowse/app-core 5.0.0-beta.11 → 5.0.0-beta.14

package/esm/WorkspaceLayout/model.js

@@ -1,46 +1,20 @@
 import { createElementId } from '@jbrowse/core/util/types/mst';
-import { cast, getSnapshot, types } from '@jbrowse/mobx-state-tree';
-import { resolveLayoutSpec, specForPendingMove, tileLayoutSpec, treeFromSpec, viewIdsInSpec, } from './spec.js';
-import { activeTabIn, addTab, addViewToTab, findTab, homeViews, moveTabToPanel, normalize, panelContainingView, panels, pruneEmptyPanel, pruneEmptyTabIn, removePanel, removeTab, removeView, renameTab, setActiveTab, setSizes, splitPanel, tabContainingView, tabs, } from './tree.js';
+import { addDisposer, cast, getSnapshot, types } from '@jbrowse/mobx-state-tree';
+import { autorun } from 'mobx';
+import { resolveLayoutSpec, tileLayoutSpec, treeFromSpec, viewIdsInSpec, } from './spec.js';
+import { addTab, addViewToTab, findTab, homeViews, moveTabToPanel, normalize, panelContainingView, panels, pruneEmptyPanel, pruneEmptyTab, removePanel, removeTab, removeView, renameTab, setActiveTab, setSizes, splitPanel, tabContainingView, tabs, } from './tree.js';
 function sessionViewIds(self) {
     return self.views?.map(v => v.id);
 }
-/**
- * A caller-supplied view list narrowed to the views the session actually has.
- *
- * The list is the caller's snapshot, and `applyLayoutSpec` refuses an id no
- * view has — so a view added after the list was built, or removed between
- * building it and the call, would throw out of a sugar action no plugin wraps.
- * The arrangement a stale name asks for is still the one it means for every
- * view that IS there, so the name is dropped rather than the action. A repeat
- * is dropped for the same reason: it would seat one view in two cells, which
- * the resolver also refuses.
- */
-function liveViewIds(self, allViewIds) {
-    const live = sessionViewIds(self);
-    return [
-        ...new Set(live ? allViewIds.filter(id => live.includes(id)) : allViewIds),
-    ];
-}
 /**
  * #stateModel WorkspaceLayoutMixin
  *
- * The whole workspace, in one MST tree. There is no second owner, so there is
- * nothing to reconcile, no event to echo, and no window during which the two
- * disagree — which is the entire content of `useDockviewController`.
- *
- * Four levels, matching what the workspace actually has and what a generic
- * window manager cannot quite express:
+ * The whole workspace as one MST tree:
  *
  *   branch (a split)  >  panel (a grid cell)  >  tab  >  views (stacked)
  *
- * dockview models the first three as branch/group/panel and stops there; the
- * vertical stack of views inside a tab is ours, which is why
- * `panelViewAssignments` had to exist alongside dockview's own serialized grid.
- * Here it is one tree, and a tab simply *contains* its views.
- *
  * Every action is `tree -> tree` through the pure functions in `tree.ts`, so
- * undo is `applySnapshot` on this node and nothing else has to be told.
+ * undo is `applySnapshot` on this node.
  */
 const LayoutTab = types.model('LayoutTab', {
     id: types.identifier,
@@ -60,19 +34,13 @@ const LayoutBranch = types.model('LayoutBranch', {
     direction: types.enumeration('LayoutDirection', ['row', 'column']),
     children: types.array(types.late(() => LayoutNode)),
 });
-// `children` is a union of both node kinds, resolved late because a branch
-// contains branches. The dispatcher keys off `direction`, which only a branch
-// has, so an ambiguous snapshot is impossible rather than merely unlikely.
+// only a branch has `direction`, so the dispatcher is never ambiguous
 const LayoutNode = types.union({
     dispatcher: (snapshot) => snapshot.direction ? LayoutBranch : LayoutPanel,
 }, LayoutBranch, LayoutPanel);
 /**
- * Panel and tab ids.
- *
- * Random, NOT a counter. These are `types.identifier`, so they must be unique
- * within the tree — and a counter is reset by every page load while the restored
- * snapshot still holds `panel-1`, `tab-1`, .... The first tab a returning user
- * opened would mint an id the tree already had.
+ * Random, not a counter: a counter restarts on page load while a restored
+ * snapshot still holds its old ids, and these are `types.identifier`s.
  */
 function nextId(kind) {
     return `${kind}-${createElementId()}`;
@@ -92,30 +60,17 @@ export function WorkspaceLayoutMixin() {
         layout: types.optional(LayoutNode, emptyPanel),
         activePanelId: types.maybe(types.string),
         /**
-         * Show only this cell, at the size of the whole workspace.
-         *
-         * Deliberately HERE and not a `maximized` flag on `PanelNode`. On the
-         * node it would be inside `tree.ts`, the half that carries the risk and
-         * is proven by a randomised operation sequence asserting canonical form
-         * after every step — and every operation would then have to say what it
-         * does to the flag: a split of a maximized panel, a drag of its last tab
-         * out, a normalize that collapses it into its parent. Beside
-         * `activePanelId` it is the same class of thing as `activePanelId`,
-         * including its failure mode, which `livePanelIds` already repairs.
+         * Show only this cell, at the size of the whole workspace. Kept here
+         * rather than as a flag on `PanelNode` so no `tree.ts` operation has to
+         * say what it does to it.
          */
         maximizedPanelId: types.maybe(types.string),
     })
         .views(self => ({
         /**
-         * The plain tree the pure functions take.
-         *
-         * `getSnapshot` is a `keepAlive` computed, so this is cached and
-         * referentially stable — which also lets MST's reconcile short-circuit on
-         * identity when `apply` writes an untouched subtree back.
-         *
-         * Uncast on purpose: the models below and the interfaces in `tree.ts` are
-         * two spellings of one shape, and this assignment is the only thing that
-         * checks they agree.
+         * Referentially stable, since `getSnapshot` is cached. Uncast on
+         * purpose: this assignment is what checks the models above agree with
+         * the interfaces in `tree.ts`.
          */
         get tree() {
             return getSnapshot(self.layout);
@@ -140,24 +95,10 @@ export function WorkspaceLayoutMixin() {
         panelContainingView(viewId) {
             return panelContainingView(self.tree, viewId);
         },
-        /** The views a tab renders: its members, in `session.views` order. */
-        viewIdsForTab(tabId, order) {
-            const members = new Set(findTab(self.tree, tabId)?.tab.viewIds ?? []);
-            return order.filter(id => members.has(id));
-        },
-        /** The tab a panel is showing, or its first. */
-        activeTabOf(panelId) {
-            const panel = panels(self.tree).find(p => p.id === panelId);
-            return panel ? activeTabIn(panel) : undefined;
-        },
         /**
-         * What to render: the maximized cell alone, or the whole tree.
-         *
-         * Sized to 1 rather than handed over as it sits. A pane's `size` is its
-         * share of its siblings, and CSS distributes free space by grow factor
-         * only up to a total of 1 — so a cell that was a third of a row, alone
-         * in the workspace with `flexGrow: 0.33`, draws a third of the window
-         * and leaves the rest blank.
+         * The maximized cell alone, or the whole tree. The cell is resized to 1
+         * because CSS hands out free space by grow factor only up to a total of
+         * 1, so a third-of-a-row cell would draw a third of the window.
          */
         get visibleTree() {
             const maximized = panels(self.tree).find(p => p.id === self.maximizedPanelId);
@@ -166,20 +107,9 @@ export function WorkspaceLayoutMixin() {
     }))
         .actions(self => {
         /**
-         * Both panel ids this model holds outside the tree must name a cell
-         * that exists, whatever just stopped existing. A dangling
-         * `activePanelId` puts homed views in a cell nobody draws; a dangling
-         * `maximizedPanelId` draws nothing at all.
-         *
-         * Stated as the invariant rather than as "the panel I just closed",
-         * because a removal collapses branches on the way out and the cell that
-         * disappears is not always the one that was named.
-         *
-         * They fall back differently, and the difference is the whole reason
-         * this is two lines rather than a loop. A workspace always shows some
-         * cell, so `activePanelId` takes the first one; maximize is a mode the
-         * user is IN, so losing its cell leaves the mode rather than picking an
-         * arbitrary cell to hold the user in it.
+         * Both panel ids held outside the tree must name a live cell. A lost
+         * active cell falls back to the first; a lost maximized cell leaves the
+         * mode.
          */
         function livePanelIds() {
             if (self.activePanelId !== undefined &&
@@ -191,27 +121,19 @@ export function WorkspaceLayoutMixin() {
                 self.maximizedPanelId = undefined;
             }
         }
-        /**
-         * Every write to the tree, and therefore the one place the invariant
-         * above is repaired.
-         *
-         * It used to be a `keepActivePanel()` the two closing actions called,
-         * which was right while a closing action was the only way to retire a
-         * cell. `maximizedPanelId` is not reached that way: BOTH drop gestures
-         * prune their emptied source panel, and `applyLayoutSpec` replaces every
-         * id in the tree at once. That is five call sites for one rule, which is
-         * the shape that ends with one of them missing.
-         */
+        // a maximized cell is the active one, so activating any other leaves
+        // the mode rather than putting new views where nobody can see them
+        function activate(panelId) {
+            self.activePanelId = panelId;
+            if (self.maximizedPanelId !== panelId) {
+                self.maximizedPanelId = undefined;
+            }
+        }
+        /** Every write to the tree, so the one place `livePanelIds` runs. */
         function apply(next) {
             const before = panels(self.tree).length;
             self.layout = cast(normalize(next));
-            // A cell appearing where it cannot be seen is the one thing maximize
-            // must not do, so gaining one leaves the mode. Stated as the count
-            // rather than at the three actions that split (`splitPanel`,
-            // `dropTabInNewSplit`, `moveViewToSplitRight`) for the reason above —
-            // and a fourth, `applyLayoutSpec`, arrives at it from the other side:
-            // it replaces every id, so `livePanelIds` was going to clear the mode
-            // regardless. Losing a cell needs nothing here; that IS `livePanelIds`.
+            // a new cell would appear where maximize hides it
             if (panels(self.tree).length > before) {
                 self.maximizedPanelId = undefined;
             }
@@ -221,68 +143,46 @@ export function WorkspaceLayoutMixin() {
             return homeViews(tree, viewIds, self.activePanelId, () => nextId('tab'));
         }
         /**
-         * The shape ViewMenu's two "give this view a home of its own" moves share.
-         *
-         * Homing first is what removed the old fork here — the live dockview api
-         * when the workspace was up, an `init` when it was not — because from the
-         * classic stack nothing has been assigned to a tab yet.
-         *
-         * Returns where the view came from, or `undefined` if it is not in the
+         * Homes every view first: the homing autorun waits for the outermost
+         * action, so a view added in the same action has no tab yet. Returns
+         * where the view came from, or `undefined` if it is not in the
          * session, in which case nothing is applied.
          */
-        function everyViewId(action, allViewIds) {
-            const ids = allViewIds ?? sessionViewIds(self);
-            if (!ids) {
-                throw new Error(`${action}(viewId, allViewIds): allViewIds is every view id in the session, and this session has no view list to default it from`);
-            }
-            return ids;
-        }
-        function rehomeView(viewId, allViewIds, place) {
-            const tree = home(self.tree, allViewIds);
+        function rehomeView(viewId, place) {
+            const ids = sessionViewIds(self);
+            const tree = ids ? home(self.tree, ids) : self.tree;
             const from = tabContainingView(tree, viewId);
             if (!from) {
                 return undefined;
             }
             const placed = place(removeView(tree, viewId), from);
-            apply(pruneEmptyTabIn(placed, from.panel.id, from.tab.id));
+            apply(pruneEmptyPanel(pruneEmptyTab(placed, from.tab.id), from.panel.id));
             return from;
         }
         /**
-         * The panel a dropped tab is leaving, or `undefined` if the drop cannot
-         * happen — which BOTH drop gestures have to establish before they touch
-         * the tree, and for two different reasons. A missing tab leaves an
-         * edge-drop's new cell behind empty; a missing target splits nothing while
-         * the gesture goes on to point `activePanelId` at a cell nobody draws, and
-         * makes `moveTabToPanel`'s remove-then-insert a deletion.
-         *
-         * One place, so the next drop gesture inherits the rule rather than
-         * restating it — the two of them restating it is how one came to be
-         * missing half of it.
+         * The panel a dropped tab is leaving, or `undefined` if the tab or the
+         * target is missing. Every drop gesture checks this before touching the
+         * tree.
          */
         function dropSource(tabId, targetPanelId) {
             const source = findTab(self.tree, tabId)?.panel;
             return source && self.hasPanel(targetPanelId) ? source : undefined;
         }
-        // `apply` is deliberately not returned: it takes a whole tree, so as an
-        // action it is a public "set the layout to this" on the session.
+        // `apply` stays private: as an action it would be a public "set layout"
         return {
             setActivePanelId(panelId) {
-                self.activePanelId = panelId;
+                if (panelId === undefined) {
+                    self.activePanelId = undefined;
+                }
+                else {
+                    activate(panelId);
+                }
             },
             /**
-             * Show one cell at the size of the workspace, or go back.
-             *
-             * A toggle rather than a pair, because the gesture is a toggle: the
-             * strip's double-click and the cell menu's one item both mean "this
-             * cell, or not any more". Maximizing a DIFFERENT cell while one is
-             * already maximized moves the mode rather than restoring, which is
-             * what the menu item on another cell's strip is asking for.
-             *
-             * Mounts no views that were not mounted — it is the same cell showing
-             * the same tab — and unmounts every other cell's, so the WebGL2
-             * context ceiling (`agent-docs/reference/GPU_PORTABILITY.md`) can
-             * only go down. That is the reason it is this and not a `display:
-             * none` over a still-mounted workspace.
+             * Show one cell at the size of the workspace, or go back; naming a
+             * different cell moves the mode. Unmounts every other cell's views
+             * rather than hiding them, to stay under the WebGL2 context ceiling
+             * (`agent-docs/reference/GPU_PORTABILITY.md`).
              */
             toggleMaximizedPanel(panelId) {
                 if (!self.hasPanel(panelId)) {
@@ -299,7 +199,7 @@ export function WorkspaceLayoutMixin() {
             },
             setActiveTab(panelId, tabId) {
                 apply(setActiveTab(self.tree, panelId, tabId));
-                self.activePanelId = panelId;
+                activate(panelId);
             },
             renameTab(tabId, title) {
                 apply(renameTab(self.tree, tabId, title));
@@ -308,13 +208,12 @@ export function WorkspaceLayoutMixin() {
             splitPanel(panelId, direction, before = false) {
                 const panel = emptyPanel();
                 apply(splitPanel(self.tree, panelId, direction, panel, before));
-                // A split of a cell that is not there inserts nothing, so claiming
-                // the id anyway would leave activePanelId naming a cell nobody draws
-                // — and homing falls back on activePanelId.
+                // a split of a missing cell inserts nothing, and homing falls back
+                // on activePanelId
                 if (!self.hasPanel(panel.id)) {
                     return undefined;
                 }
-                self.activePanelId = panel.id;
+                activate(panel.id);
                 return panel;
             },
             closePanel(panelId) {
@@ -327,22 +226,12 @@ export function WorkspaceLayoutMixin() {
                 }
                 const tab = { id: nextId('tab'), viewIds };
                 apply(addTab(self.tree, panelId, tab));
-                self.activePanelId = panelId;
+                activate(panelId);
                 return tab;
             },
             /**
-             * Close a tab, and the cell with it if that was its last.
-             *
-             * A cell whose tabs are all gone is the state `pruneEmptyPanel` was
-             * written for — "dragging the last tab out of a split and leaving a
-             * blank half is the one place an empty panel is clearly not what was
-             * meant" — and closing that tab arrives at the identical half by a
-             * different gesture. It rendered nothing at all, not even the launcher
-             * an empty TAB shows, so the only way back out of it was the `+`.
-             *
-             * `pruneEmptyPanel` carries both guards already: a cell with tabs left
-             * stays, and the last cell in the workspace stays whatever happens to
-             * it, since there is nowhere for the tree to collapse to.
+             * Close a tab, and its cell too if that was the last tab and not the
+             * workspace's last cell: a tabless cell renders nothing at all.
              */
             closeTab(tabId) {
                 const panelId = findTab(self.tree, tabId)?.panel.id;
@@ -354,42 +243,15 @@ export function WorkspaceLayoutMixin() {
             addViewToTab(tabId, viewId) {
                 apply(addViewToTab(self.tree, tabId, viewId));
             },
-            // NO `removeView` HERE. This mixin is composed into the session, where
-            // `removeView(view)` is already the action that takes a view out of
-            // `session.views` — part of AbstractSessionModel, and what every close
-            // button and every host calls. A same-named action here does not extend
-            // it, it *replaces* it (types.compose merges, last one wins), so the
-            // session action stopped being reachable at all: closing a view pruned
-            // the layout tree and left the view in the session forever, and
-            // `session.removeView(view)` passed a model where this wanted an id, so
-            // it matched nothing and even the pruning was a no-op.
-            //
-            // Nothing needs one either way: `home` below drops any tab entry whose
-            // view is no longer in `session.views`, so removing the view is the
-            // whole operation and the tree follows.
-            /**
-             * Drop a dragged tab into an existing panel, as a tab.
-             *
-             * One action, so the tree never exists in a state where the tab is in
-             * both panels or neither. The imperative bridge needed an explicit
-             * `runInAction` around the unassign+reassign pair for exactly this, and
-             * a comment explaining that without it the reconcile autorun would
-             * observe the gap and re-home the view.
-             */
+            // NO `removeView` here: composed into the session it would replace
+            // `session.removeView`, and homing already drops a removed view
+            /** Drop a dragged tab into an existing panel, as a tab. */
             dropTabInPanel(tabId, targetPanelId, index) {
                 const source = dropSource(tabId, targetPanelId);
                 if (!source) {
                     return;
                 }
-                // A drop on the BODY of the cell the tab is already in asks for
-                // nothing. There is no gap under the pointer to state a position, and
-                // the indicator washes the whole cell — which says "be a tab of this
-                // cell", which it already is. Appending reordered the strip to say
-                // something the gesture never said, and sent the tab to the end.
-                // dockview declines a centre drop on the group a tab came from too.
-                //
-                // The rule is the gesture's, not `moveTabToPanel`'s: no index there
-                // still means append, which is the only reading a total function has.
+                // a drop on the body of the tab's own cell asks for nothing
                 if (source.id === targetPanelId && index === undefined) {
                     return;
                 }
@@ -398,7 +260,7 @@ export function WorkspaceLayoutMixin() {
                     next = pruneEmptyPanel(next, source.id);
                 }
                 apply(next);
-                self.activePanelId = targetPanelId;
+                activate(targetPanelId);
             },
             /** Drop a dragged tab on a panel edge: split, and land in the new half. */
             dropTabInNewSplit(tabId, targetPanelId, direction, before) {
@@ -413,33 +275,20 @@ export function WorkspaceLayoutMixin() {
                 };
                 let next = splitPanel(self.tree, targetPanelId, direction, panel, before);
                 next = moveTabToPanel(next, tabId, panel.id);
-                // Dragging a panel's only tab onto that same panel's edge prunes the
-                // now-empty source, which collapses the split — the gesture undoes
-                // itself rather than leaving a blank half, without needing a case.
+                // a panel's only tab dropped on its own edge collapses the split
                 next = pruneEmptyPanel(next, source.id);
                 apply(next);
-                self.activePanelId = panel.id;
+                activate(panel.id);
                 return panel.id;
             },
             setSizes(branchId, sizes) {
                 apply(setSizes(self.tree, branchId, sizes));
             },
             /**
-             * Arrange the workspace as a spec states.
-             *
-             * The spec is the same shape a session spec's `layout` takes: a leaf's
-             * `views` names views by index into `session.views` or by id, so
-             * `{ direction: 'horizontal', children: [{ views: [0] }, { views: [1] }] }`
-             * means here what it means in a link. A leaf spelled any other way, an
-             * index past the end or an id no view has throws rather than arranging
-             * nothing — an untyped caller used to collapse the workspace into one
-             * blank tab that way.
-             *
-             * There is no `init` property and no standing request: the spec is
-             * converted and *becomes* the layout, here and now. `init` existed only
-             * because dockview had to be told, could not be told before it mounted,
-             * and had to be told again afterwards — three problems that all came
-             * from the layout living somewhere this action could not reach.
+             * Arrange the workspace as a spec states, in the shape a session
+             * spec's `layout` takes: a leaf's `views` names views by index into
+             * `session.views` or by id. A malformed leaf, an index past the end or
+             * an unknown id throws.
              */
             applyLayoutSpec(spec) {
                 const resolved = resolveLayoutSpec(spec, sessionViewIds(self));
@@ -449,25 +298,21 @@ export function WorkspaceLayoutMixin() {
             },
             /**
              * ViewMenu's "move to new tab": the view leaves its tab for a new one.
-             *
-             * `allViewIds` is EVERY view in the session, defaulting to the host's
-             * own list — homing drops any view the list does not name, so the
-             * `[viewId]` default this used to carry unhomed all the others.
              */
-            moveViewToNewTab(viewId, allViewIds) {
+            moveViewToNewTab(viewId) {
                 const tab = { id: nextId('tab'), viewIds: [viewId] };
-                const from = rehomeView(viewId, everyViewId('moveViewToNewTab', allViewIds), (tree, at) => addTab(tree, at.panel.id, tab));
+                const from = rehomeView(viewId, (tree, at) => addTab(tree, at.panel.id, tab));
                 if (!from) {
                     return undefined;
                 }
-                self.activePanelId = from.panel.id;
+                activate(from.panel.id);
                 return tab.id;
             },
             /**
-             * ViewMenu's "move to split view": the view leaves for a new cell.
-             * `allViewIds` is every view in the session — see `moveViewToNewTab`.
+             * ViewMenu's "move to split": the view leaves for a new cell to the
+             * right (`row`) or below (`column`) of its own.
              */
-            moveViewToSplitRight(viewId, allViewIds) {
+            moveViewToSplit(viewId, direction) {
                 const tabId = nextId('tab');
                 const panel = {
                     id: nextId('panel'),
@@ -475,111 +320,108 @@ export function WorkspaceLayoutMixin() {
                     tabs: [{ id: tabId, viewIds: [viewId] }],
                     activeTabId: tabId,
                 };
-                const from = rehomeView(viewId, everyViewId('moveViewToSplitRight', allViewIds), (tree, at) => splitPanel(tree, at.panel.id, 'row', panel));
+                const from = rehomeView(viewId, (tree, at) => splitPanel(tree, at.panel.id, direction, panel));
                 if (!from) {
                     return undefined;
                 }
-                self.activePanelId = panel.id;
+                activate(panel.id);
                 return panel.id;
             },
+            /**
+             * ViewMenu's "move to tab": the view joins an existing tab, which
+             * becomes the one shown.
+             */
+            moveViewToTab(viewId, tabId) {
+                const target = findTab(self.tree, tabId);
+                if (!target || target.tab.viewIds.includes(viewId)) {
+                    return;
+                }
+                const from = rehomeView(viewId, tree => addViewToTab(tree, tabId, viewId));
+                const landed = findTab(self.tree, tabId);
+                if (from && landed) {
+                    apply(setActiveTab(self.tree, landed.panel.id, tabId));
+                    activate(landed.panel.id);
+                }
+            },
             homeUnassignedViews(viewIds) {
                 apply(home(self.tree, viewIds));
             },
         };
     })
-        /**
-         * The two sugars, in their own block so they can reach the actions they are
-         * sugar FOR through `self`.
-         *
-         * `this.applyLayoutSpec()` reaches sideways into the action literal the
-         * block returned — the fork's `instantiateActions` does `fn.bind(actions)`
-         * — so it is pinned to that block's implementation for good. A later block,
-         * or a plugin's `extendStateModel`, replaces `self.applyLayoutSpec` and the
-         * sideways hop goes on calling the one it replaced, with no error and no
-         * type complaint. An extra layer costs a line.
-         */
+        // a separate block so these reach the actions they wrap through `self`,
+        // where a later override still gets called
         .actions(self => ({
         /**
-         * Move one view relative to the others. PUBLIC API: an external plugin
-         * calls this behind a `'setPendingMove' in session` guard
-         * (jbrowse-plugin-protein3d, putting a protein view beside its genome
-         * view). It survived the last storage change by being kept as sugar, and
-         * it survives this one the same way — a capability-detecting caller
-         * cannot tell you it lost a capability.
-         *
-         * **`allViewIds` is therefore OPTIONAL, and has to stay that way.** The
-         * plugin passes the move alone, because that was the whole signature when
-         * its call site was written; requiring the second argument threw
-         * `undefined.filter` out of a launch the plugin does not wrap, and the
-         * figure was again the only thing that noticed. Keeping the NAME is half
-         * of not breaking a runtime lookup — the call has to keep working as it
-         * is spelled.
+         * Move one view to a new tab or a split beside its cell, keeping the
+         * rest of the arrangement. PUBLIC API: protein3d and msaview call it
+         * with the move alone. The second argument is an old plugin signature;
+         * the session's own views are read instead.
          */
-        setPendingMove(move, allViewIds) {
-            // Not `?? []`: homing drops every view the list does not name, so an
-            // empty one would answer "put this view beside nothing" and unhome the
-            // rest. Nothing to say is nothing to do.
-            const ids = allViewIds ?? sessionViewIds(self);
-            if (!move || !ids) {
+        setPendingMove(move, _allViewIds) {
+            const ids = sessionViewIds(self);
+            if (!move || !ids?.includes(move.viewId)) {
                 return;
             }
-            const known = liveViewIds(self, ids);
-            // Nothing to move: the view named is not in the session, so there is
-            // no arrangement to state about it.
-            if (sessionViewIds(self) && !known.includes(move.viewId)) {
-                return;
+            if (ids.length === 1) {
+                self.homeUnassignedViews(ids);
+            }
+            else if (move.type === 'newTab') {
+                self.moveViewToNewTab(move.viewId);
             }
-            self.applyLayoutSpec(specForPendingMove(move, known));
-            // Show where the view went. A spec states an arrangement and not a
-            // selection, so `treeFromSpec` shows each cell's FIRST tab — and
-            // `newTab` puts the moved view in a tab beside the others, which makes
-            // it the one tab nobody can see. The plugin asking for this is asking
-            // for its view to be on screen; `moveViewToNewTab`, the same gesture
-            // from the View menu, has always ended with it there.
-            const home = tabContainingView(self.tree, move.viewId);
-            if (home) {
-                self.setActiveTab(home.panel.id, home.tab.id);
+            else {
+                self.moveViewToSplit(move.viewId, 'row');
             }
         },
         /**
-         * The whole-workspace re-arrange: every view one cell, in one of four
-         * shapes. Restored from the dockview header's four "Global:" commands,
-         * which went with that component and were not reimplemented.
-         *
-         * `allViewIds` is passed in rather than read off the session for the same
-         * reason `moveViewToNewTab` takes it: this mixin owns the tree and has no
-         * view list of its own. Passing `session.views` order means the
-         * arrangement it states is already the order views render in, so unlike a
-         * session spec's layout there is nothing for `orderViews` to apply.
+         * Re-arrange the whole workspace, one view per cell, in one of four
+         * shapes, in `session.views` order.
          */
-        tileViews(mode, allViewIds) {
-            self.applyLayoutSpec(tileLayoutSpec(liveViewIds(self, allViewIds), mode));
+        tileViews(mode) {
+            self.applyLayoutSpec(tileLayoutSpec(sessionViewIds(self) ?? [], mode));
         },
         /**
          * #action
-         * Arrange the session's views into panels. Calls `applyLayoutSpec`,
-         * turns workspaces mode on for this session (a layout renders nowhere
-         * else), and orders `session.views` to the spec's top-to-bottom
-         * order, which tabs read their order from. Without the last two steps
-         * the layout applies but does not display, or the tabs appear in the
-         * wrong order. Leaves take view ids or indexes into `session.views`; a
-         * layout that seats no view throws rather than leaving a blank tab. A
-         * session spec's `layout` and an agent's live re-layout both call it.
+         * Arrange the session's views into panels: `applyLayoutSpec`, then
+         * `session.views` ordered to the spec's top-to-bottom order, which tabs
+         * read their order from. Leaves take view ids or indexes into
+         * `session.views`; a layout that seats no view throws rather than
+         * leaving a blank tab. A session spec's `layout` and an agent's live
+         * re-layout both call it.
          */
         layoutViews(spec) {
             const host = self;
-            if (!host.setUseWorkspaces || !host.orderViews) {
+            if (!host.orderViews) {
                 throw new Error('This session has no view list to arrange: layoutViews needs a host composed with MultipleViewsSessionMixin');
             }
-            host.setUseWorkspaces(true);
-            const ids = self.applyLayoutSpec(spec);
-            if (ids.length === 0) {
+            const seated = viewIdsInSpec(resolveLayoutSpec(spec, sessionViewIds(self)));
+            if (seated.length === 0) {
                 throw new Error('The layout seats no views: a leaf names its views with "views" (view ids, or indexes into session.views) and a container nests "children"');
             }
+            const ids = self.applyLayoutSpec(spec);
             host.orderViews(ids);
             return ids;
         },
-    })));
+    }))
+        .actions(self => ({
+        afterAttach() {
+            addDisposer(self, autorun(function homeUnassignedViewsAutorun() {
+                const host = self;
+                if (host.views) {
+                    self.homeUnassignedViews(host.views.map(v => v.id));
+                }
+            }, { name: 'HomeUnassignedViews' }));
+        },
+    }))
+        // A session saved with workspaces off showed its views stacked whatever
+        // layout it carried, so it opens as one cell holding them all
+        .preProcessSnapshot(snap => {
+        if (snap?.useWorkspaces !==
+            false) {
+            return snap;
+        }
+        const { layout, activePanelId, maximizedPanelId, ...rest } = snap;
+        return rest;
+    }));
 }
 export function isSessionWithWorkspaceLayout(session) {
     return 'layout' in session && 'splitPanel' in session;