feat(scrolling): toggle a column between several slots and one stack

toggle-column-stack stacks the windows of the focused column in one
window slot, or spreads the focused stack out into a column with a
window in each slot, whichever the focused column is. A stack is what
a tabbed column already is, so this is the same thing seen from the
other side: existing stacks stay stacks, consume and expel make split
columns, and this switches either kind.

Stacking keeps the order of the windows and the one that had focus is
the one that shows. Spreading out puts the tabs in the order of the
tabs, with focus on the window that had it, and puts every window that
was out of sight where it is shown, the one that stays in its slot as
much as the ones that go to slots of their own. Focus stays on the
column while that is done, so that stacking and spreading out again
leaves the strip where it was. The column keeps its width. Heights that
its slots were given are not remembered for toggling back, which needs
more memory than a column keeps.

The stack is the stack of every layout, so cycle-stack, focus-stack-
window and stack work on it, and unstack takes the window that has
focus off into a column of its own to the right, which a test checks.

Like consume and expel it only does anything in the Scrolling layout.
The parking and restoring of windows is the code that stacks already
use, and was not seen on a screen. A test has no screen, so what would
be restored is recorded, and two tests check that every window of a
spread out stack is and that the strip stays put.
This commit is contained in:
LGUG2Z committed 2026-10-29 16:38:53 -07:00
1 parent 2363ff6c3a
commit 00faad73bf
7 files changed
+390

No files matched your search

+10
View File
@@ -63,6 +63,16 @@ column of its own, to the right of the column that has focus. To put windows in
- [`komorebic expel`](../cli/expel.md) takes the focused window out of its column and puts it in a column of its own on
the right.
- [`komorebic toggle-column-stack`](../cli/toggle-column-stack.md) stacks the windows of the focused column, or spreads
the focused stack out into a column with a window in each slot. A [stack](../cli/stack.md) is one slot that shows one
window at a time, and it takes the height of the column. The window that has focus keeps it. The column keeps its width,
but the heights that its windows were given are not remembered for when you toggle back.
A stack is the stack that you have in every layout, so [`cycle-stack`](../cli/cycle-stack.md),
[`focus-stack-window`](../cli/focus-stack-window.md) and [`stack`](../cli/stack.md) work on it as they always do.
[`unstack`](../cli/unstack.md) takes the window that has focus off the stack and puts it in a column of its own to the
right of the one that it was in.
These only do anything in the Scrolling layout, which is the only one with columns of several windows for now.
The focused window keeps focus, and stays where it is on screen, when you do any of these.