zidane-ui/workspace

Provides the resolved horizontal budget to the columns below.

Paints an extension panel's declarative content: sections of rows, prose and key / value facts, and the footer actions. Memoised: its host re-renders on every panel content or badge change, for any tab.

Renders the corner cluster: pop out and full screen (while open), then the toggle.

Renders a panel's icon, or its extension's mark.

Panel rows below that stand for a session are drawn with row: the app's own session row, so they look and move like its session list.

The side panel for the scope on screen: its tab groups, their bodies, the resize edge and, when it floats and slid away, the edge tab.

Puts a WorkspaceHost in context for the WorkspaceProviders below (what AppHostProvider does with host.workspace).

Provides the side panel's state for scope to the components below.

The first prose detail, flattened to plain text for the collapsed preview.

The scope holding focus: from the focused element (or from) up to the first registered one. None when that scope is hidden: focus left behind in a kept-alive tab the user switched away from (browsers keep it on a display: none element) must not take ctrl+w from the shown tab.

The scope under the pointer (the innermost hovered element up).

After a tab key acted in region: whenever the element holding focus goes away with what it showed (a closed file's editor, a stepped-away tab, even a beat later), focus lands back on the region instead of the page, so the next key and the next arrow stay there. Stops once the user is elsewhere.

The width the cluster covers at the end of the band, in px: what the strip or header under it reserves.

The scope of the side panel's visible tab (SidePanel marks its root data-side-panel), if it has one. Hidden kept-alive tabs have no boxes.

Register scope on el (marks it data-tab-scope). Returns the unregister.

The index a step lands on in a list, wrapping; -1 when the list is empty.

Where ⌥⌘← / ⌥⌘→ act, from what holds focus (or from). Focus on the page itself (it fell there): the region the user was in, if still shown.

Most recent first, deduplicated, capped at max. Returns list itself when nothing changes.

Follow where the user is (pointer down, focus in). Install once per window; returns the uninstall.

The extension panels offered in cwd, kept per folder: switching back to a folder shows its tabs at once, and a slow list for a folder left behind never lands on the one shown. A folder not listed yet keeps the last list until its own arrives, so the strip does not drop its tabs for a frame. Re-lists when the host says the catalog changed.

The budget from the nearest LayoutBudgetProvider. Throws outside one.

The budget from the nearest LayoutBudgetProvider, or null (chrome that may render outside one).

useWorkspaceActions, or null outside a WorkspaceProvider.

useWorkspaceView, or null outside a WorkspaceProvider.

The splitTabRight / splitTabDown handlers for the WorkspaceProvider above, or none while they cannot act.

Whether the tab body calling it is on screen (true outside a side panel).

Live layout for a scope (EMPTY_LAYOUT without one). A scope on screen owns its layout from then on (adoptScopeLayout; the draft excepted): what it shows stays put while other sessions of its project change theirs.

Register a tab scope on the element ref points at, with handlers that always see the latest render.

Everything at once (re-renders on any panel change); prefer the narrower hooks above.

Stable actions only: never re-renders on panel state changes. Throws outside a WorkspaceProvider.

Extension content and badges. Re-renders on every content load and badge change.

The WorkspaceHost from the nearest WorkspaceHostProvider, or null.

The side panel's key commands for the WorkspaceProvider above. Each is present only while it can act.

Returns the side panel's strings: the defaults merged with any overrides given to WorkspaceProvider or LabelsProvider.

The one-shot requests to tab bodies.

The catalog, strips and open state. Re-renders on navigation, not on content loads.

Whether the tab body below is on screen; TabParking provides it per body. Default: visible.

Props for a focus region's root: marked, and focusable by a click (not by Tab).

A column's wanted width and its bounds.

The resolved widths and modes, the slid-away flag and the drag caps.

Props for LayoutBudgetProvider.

Props for PanelContentView.

Props of PanelCorner.

Props for PanelGlyph.

A click's modifiers, as onOpenPath receives them.

Props of a PanelSessionRowProvider's row.

Props of PanelSessionRowProvider.

Props for SidePanel.

The panel's own buttons, on one strip only.

What a surface does with the tab keys: step, close, find.

Where the tab keys act: a scope, and the focus region holding focus.

Every panel action; one object whose identity never changes for the provider's lifetime.

Extension content and badges: the fast-changing part.

Where extension panels load: the folder, and the session they show beside.

Props for WorkspaceHostProvider.

Options for useWorkspaceKeyCommands.

Props for WorkspaceProvider.

One-shot hand-overs to tab bodies (consumed with the matching take* action).

The tab kinds an app offers: how each tab renders, and how the panel treats it. Read at render; a body re-renders when its tab or the panel's bodyKey changes.

Catalog, strip and open/active state: changes on user navigation, not on content loads.

Everything useWorkspace returns.