Struct SessionWidget 

pub struct SessionWidget<'a> { /* private fields */ }

Root compositor widget that orchestrates rendering of the entire session UI

This widget follows the compositional pattern recommended by Ratatui where a single root widget manages the layout and delegates rendering to child widgets.

It handles:

• Responsive layout based on terminal size (Compact/Standard/Wide)
• Layout calculation (header, main, footer regions)
• Coordinating child widget rendering
• Modal and palette overlay management
• Sidebar rendering in wide mode

Layout Modes

• Compact (< 80 cols): Minimal chrome, no borders, no sidebar
• Standard (80-119 cols): Borders, titles, optional logs panel
• Wide (>= 120 cols): Full layout with sidebar for queue/context

Example

SessionWidget::new(session)
    .header_lines(lines)
    .header_area(header_area)
    .transcript_area(transcript_area)
    .render(area, buf);

Implementations

impl<'a> SessionWidget<'a>

pub fn new(session: &'a mut Session) -> Self

Create a new SessionWidget with required parameters

pub fn header_lines(self, lines: Vec<Line<'static>>) -> Self

Set the header lines to render

pub fn header_area(self, area: Rect) -> Self

Set the header area

pub fn transcript_area(self, area: Rect) -> Self

Set the transcript area

pub fn navigation_area(self, area: Rect) -> Self

Set the navigation area

pub fn layout_mode(self, mode: LayoutMode) -> Self

Override the layout mode (auto-detected by default)

Trait Implementations

impl Widget for &mut SessionWidget<'_>

fn render(self, area: Rect, buf: &mut Buffer)

Draws the current state of the widget in the given buffer. That is the only method required to implement a custom widget.