Struct MasterLayout 

pub struct MasterLayout { /* private fields */ }

Available on crate feature master-layout only.

Master Layout - orchestrates the entire TUI application

Architecture

┌─────────────────────────────────┐
│ Navigation Bar (1 row + border) │ ← 3 rows total
├─────────────────────────────────┤
│                                 │
│         Active Tab              │ ← Remaining space
│  (panes + footer)               │
│                                 │
└─────────────────────────────────┘

Modes

• Layout Mode: Navigate panes with hjkl, Tab/Shift+Tab, Enter to focus
• Focus Mode: All input goes to focused pane, Ctrl-A to exit

Key Bindings

Global (always work):

• Ctrl+Q: Quit
• 1-9: Switch tabs

Layout Mode:

• h/j/k/l: Directional navigation
• Tab: Next pane
• Shift+Tab: Previous pane
• Enter: Focus selected pane

Focus Mode:

• Ctrl-A: Exit to Layout Mode
• All other keys: Route to focused pane
• Mouse on same pane: Route to pane
• Mouse on different pane: Change focus

Implementations

impl MasterLayout

pub fn new() -> Self

Create a new empty master layout

pub fn set_nav_bar_offset(&mut self, offset: u16)

Set the navigation bar left offset (to make room for other components like IconNavBar)

pub fn add_tab(&mut self, tab: Tab)

Add a tab to the master layout

pub fn tab_count(&self) -> usize

Get number of tabs

pub fn active_tab_index(&self) -> usize

Get active tab index

pub fn set_active_tab(&mut self, index: usize)

Set active tab by index

pub fn active_tab(&self) -> Option<&Tab>

Get reference to active tab

pub fn active_tab_mut(&mut self) -> Option<&mut Tab>

Get mutable reference to active tab

pub fn mode(&self) -> &InteractionMode

Get current interaction mode

pub fn enter_layout_mode(&mut self)

Enter Layout Mode

pub fn enter_focus_mode(&mut self, pane_id: PaneId)

Enter Focus Mode with a specific pane

pub fn exit_focus_mode(&mut self)

Exit Focus Mode (Ctrl-A) - returns to Layout Mode

pub fn select_next_pane(&mut self)

Select next pane (Tab key in Layout Mode)

pub fn select_prev_pane(&mut self)

Select previous pane (Shift+Tab key in Layout Mode)

pub fn select_left(&mut self)

Select pane to the left (h key in Layout Mode)

pub fn select_right(&mut self)

Select pane to the right (l key in Layout Mode)

pub fn select_up(&mut self)

Select pane above (k key in Layout Mode)

pub fn select_down(&mut self)

Select pane below (j key in Layout Mode)

pub fn focus_selected(&mut self)

Focus the currently selected pane (Enter key in Layout Mode)

pub fn handle_event(&mut self, event: Event) -> EventResult

Handle a crossterm event

pub fn render(&mut self, frame: &mut Frame<'_>)

Render the master layout

Trait Implementations

impl Default for MasterLayout

fn default() -> Self

Returns the “default value” for a type.