Struct LogPane 

pub struct LogPane { /* private fields */ }

The component itself. Owns the tab state + ring buffers; reads the bee::http capture from a borrowed handle, same as the legacy CommandLog did.

Implementations

impl LogPane

pub fn new( capture: Option<LogCapture>, initial_tab: LogTab, initial_height: u16, ) -> Self

pub fn set_cockpit_capture(&mut self, cap: CockpitCapture)

Attach the cockpit-capture ring buffer so the Cockpit tab can render events bee-tui itself emitted (everything that isn’t bee::http). Wired by [App::new] after crate::logging::init has installed the capture.

pub fn active_tab(&self) -> LogTab

pub fn height(&self) -> u16

pub fn set_spawn_active(&mut self, active: bool)

Tell the pane bee-tui is acting as the supervisor (so the placeholder changes from “configure bee” to “(awaiting first log line)”). Called once at startup; cheap to call repeatedly.

pub fn next_tab(&mut self) -> LogTab

Cycle to the next tab (left → right, wrapping). Returns the new active tab so callers can persist state without re-reading. Resets the scroll offset — the new tab’s content has nothing to do with where we were on the old one.

pub fn prev_tab(&mut self) -> LogTab

Cycle to the previous tab (right → left, wrapping).

pub fn scroll_up(&mut self, lines: usize)

Scroll the active tab up by lines (toward older entries). Clamped at draw-time to the buffer length so the user can’t scroll past the top. lines = 1 is the per-keystroke step; callers can pass a larger value for page-scrolling.

pub fn scroll_down(&mut self, lines: usize)

Scroll the active tab down by lines (toward newer entries / the tail). Saturates at 0, which is the auto-tail state.

pub fn resume_tail(&mut self)

Snap back to auto-tail mode (scroll_offset = 0). The pane resumes following new entries as they arrive. Also resets horizontal pan because operators usually want both axes reset together when “going back to live.”

pub fn scroll_right(&mut self, cols: u16)

Pan the active tab right by cols characters. Bee log lines often run past the pane width; ratatui truncates them at the right edge by default so we add a horizontal scroll to let operators read the tail.

pub fn scroll_left(&mut self, cols: u16)

Pan the active tab left by cols characters. Saturates at 0 (the natural left edge).

pub fn reset_h_scroll(&mut self)

Reset horizontal pan to the left edge without touching the vertical scroll. Used when operators want the line start back without leaving the historical window.

pub fn h_scroll_offset(&self) -> u16

Current horizontal scroll offset. Exposed for tests + the title-strip indicator.

pub fn is_tailing(&self) -> bool

true when the pane is auto-tailing (the default state).

pub fn scroll_offset(&self) -> usize

Lines the pane is currently scrolled back from the tail. Useful for rendering “[paused N]” indicators in the title.

pub fn grow(&mut self) -> u16

Grow the pane by one line. Returns the new height. No-op once the cap is hit.

pub fn shrink(&mut self) -> u16

Shrink the pane by one line. Returns the new height. No-op once the floor is hit.

pub fn push_bee(&mut self, tab: LogTab, line: BeeLogLine)

Push a Bee log line to the appropriate tab. The supervisor’s log tailer calls this for each parsed line. Bounded — when the ring is full the oldest entry is evicted.

Scroll-stability: if this push lands on the active tab AND we’re currently scrolled back (not auto-tailing), bump scroll_offset so the visible window stays anchored on the same content rather than drifting upward as new lines push the old ones up.

impl LogPane

pub fn active_tab_total_lines(&self) -> usize

Number of payload lines the active tab currently has. Used by draw() to clamp the scroll offset and by tests.

Trait Implementations

impl Component for LogPane

fn update(&mut self, action: Action) -> Result<Option<Action>>

Update the state of the component based on a received action. (REQUIRED)

fn draw(&mut self, frame: &mut Frame<'_>, area: Rect) -> Result<()>

Render the component on the screen. (REQUIRED)

fn register_action_handler(&mut self, tx: UnboundedSender<Action>) -> Result<()>

Register an action handler that can send actions for processing if necessary.

fn register_config_handler(&mut self, config: Config) -> Result<()>

Register a configuration handler that provides configuration settings if necessary.

fn init(&mut self, area: Size) -> Result<()>

Initialize the component with a specified area if necessary.

fn handle_events(&mut self, event: Option<Event>) -> Result<Option<Action>>

Handle incoming events and produce actions if necessary.

fn handle_key_event(&mut self, key: KeyEvent) -> Result<Option<Action>>

Handle key events and produce actions if necessary.

fn handle_mouse_event(&mut self, mouse: MouseEvent) -> Result<Option<Action>>

Handle mouse events and produce actions if necessary.

fn as_any_mut(&mut self) -> Option<&mut dyn Any>

Downcast hook so the App can reach a concrete screen type (e.g. to call Manifest::load(reference) from the command bar). Default returns None so screens that don’t need it can ignore this method.