feat(tabs): pin tabs to a Focus section on the vertical rail

A session or web-tab ref in the owner tab layout may now carry
`focus: true`. "Add to Focus" in a row's menu (right-click on a web tab)
sets it; the vertical rail then draws a shortcut to that tab in a pinned,
collapsible "Focus" section at its top, while the row itself stays where
it is. A click on a shortcut selects its tab, a right-click or the menu
key offers "Remove from Focus".

Model: `TabRef.focus?: true`, parsed strictly (only `true` or absent) and
carried through normalization, every pure edit and the legacy-order
projection; `setTabFocus()` is the pure helper. TabLayoutService needed
no change and no route was added: the flag rides the existing
`PUT /api/tab-layout`. Browser: `copyRef`/`normalizeLayout` keep `focus`
the way they keep `placement` (the browser writes whole layouts, so a
dropped field would be erased on every save), `setFocus` is a named
operation through `createEditCoordinator` and replays on a 409, and
`focusRefs()` (also on `project()`) lists what the rail can draw.

The section is its own element in #tabRail above #sessionTabs, so it
works on the flat rail (no named groups) as well as the grouped one, and
shortcuts are never rows: no Alt+N badge, no tree item, no lineage
anchor, no drag target. It is a list with one tab stop and
Up/Down/Home/End between shortcuts. Collapse is per-device localStorage
under its own key. A shortcut whose session closed or whose web tab is
not open drops out; the server already prunes deleted refs. zh-CN
strings added.
This commit is contained in:
Aamer Akhter committed 2026-10-10 13:43:20 -04:00
1 parent aa3730aace
commit cde90a465b
15 files changed
+1819 -16

No files matched your search

+21 -2
View File
@@ -15,6 +15,13 @@ export interface TabRef {
kind: TabRefKind;
id: string;
placement?: 'manual';
/**
* Pinned to the vertical rail's Focus section. The browser draws a SHORTCUT to
* the ref there; the ref itself stays in its group, so the flag never moves
* anything and nothing that moves a ref may drop it. Only `true` is stored:
* an unfocused ref carries no key at all.
*/
focus?: true;
}
export interface TabGroup {
@@ -104,7 +111,13 @@ function parseRef(value: unknown, label: string): TabRef {
if (value.placement !== undefined && value.placement !== 'manual') {
throw new TabLayoutValidationError(`${label}.placement must be manual when present`);
}
return value.placement === 'manual' ? { kind: value.kind, id, placement: 'manual' } : { kind: value.kind, id };
if (value.focus !== undefined && value.focus !== true) {
throw new TabLayoutValidationError(`${label}.focus must be true when present`);
}
const ref: TabRef = { kind: value.kind, id };
if (value.placement === 'manual') ref.placement = 'manual';
if (value.focus === true) ref.focus = true;
return ref;
}
function parseTabLayout(input: unknown, repairDuplicates: boolean): TabLayout {
@@ -395,6 +408,11 @@ export function setManualPlacement(input: TabLayout, target: TabRef, manual: boo
return mapRef(input, target, (ref) => ({ ...ref, placement: 'manual' }));
}
/** Pin `target` to the Focus section, or unpin it. Moves nothing; idempotent both ways. */
export function setTabFocus(input: TabLayout, target: TabRef, focused: boolean): TabLayout {
return mapRef(input, target, ({ focus: _focus, ...ref }) => (focused ? { ...ref, focus: true } : ref));
}
export function followParent(input: TabLayout, target: TabRef, metadata: readonly TabRefMetadata[]): TabLayout {
const normalized = normalizeTabLayout(input, metadata);
if (target.kind !== 'session') {
@@ -420,7 +438,8 @@ export function followParent(input: TabLayout, target: TabRef, metadata: readonl
throw new TabLayoutValidationError(`session parent is not represented: ${targetMetadata.parentSessionId}`);
}
const cleared = mapRef(normalized, target, (ref) => ({ kind: ref.kind, id: ref.id }));
// Clear the manual placement only: a focused ref stays focused.
const cleared = mapRef(normalized, target, ({ placement: _placement, ...ref }) => ref);
return normalizeTabLayout(cleared, metadata);
}