Struct UIState 

pub struct UIState {

    pub mode: UIMode,
    pub last_log_mode: Option<UIMode>,
    pub messages: Vec<ChatMessageEntry>,
    pub chat_messages: Vec<(DateTime<Utc>, String)>,
    pub logs: VecDeque<LogEntry>,
    pub scroll_offset: usize,
    pub log_scroll_offset: usize,
    pub horizontal_scroll_offset: usize,
    pub is_at_bottom_chat: bool,
    pub is_at_bottom_log: bool,
    pub input_buffer: String,
    pub cursor_pos: usize,
    pub terminal_size: (u16, u16),
    pub max_log_entries: usize,
    pub connected_peers_count: usize,
}

Represents the overall state of the user interface.

This struct holds all the data and configuration necessary to render the UI and respond to user interactions.

Fields

mode: UIMode

The current operational mode of the UI (Chat or Logs).

last_log_mode: Option<UIMode>

Stores the last log mode for easy switching back.

messages: Vec<ChatMessageEntry>

A vector of chat message entries for display.

chat_messages: Vec<(DateTime<Utc>, String)>

A vector of generic chat messages, typically system messages or command output.

logs: VecDeque<LogEntry>

A deque of log entries for the log view.

scroll_offset: usize

The current vertical scroll offset for the chat view.

log_scroll_offset: usize

The current vertical scroll offset for the log view.

horizontal_scroll_offset: usize

The current horizontal scroll offset for text.

is_at_bottom_chat: bool

Indicates if the chat view is scrolled to the bottom.

is_at_bottom_log: bool

Indicates if the log view is scrolled to the bottom.

input_buffer: String

The current content of the input buffer.

cursor_pos: usize

The current cursor position within the input buffer.

terminal_size: (u16, u16)

The current size of the terminal (width, height).

max_log_entries: usize

The maximum number of log entries to retain.

connected_peers_count: usize

The count of currently connected peers.

Implementations

impl UIState

pub fn add_message(&mut self, message: Message)

Adds a new Message to the UI state.

This function stores the message along with its reception timestamp. If the UI is in chat mode and at the bottom of the scroll, it resets the scroll offset. Otherwise, it adjusts the scroll offset to keep new messages visible if not explicitly scrolled up.

Arguments

• message - The Message to add.

pub fn add_chat_message(&mut self, message: String)

Adds a generic chat message string to the UI state.

This is typically used for system messages or user input echoes. It handles scroll adjustment similarly to add_message.

Arguments

• message - The string content of the chat message.

pub fn add_history_output(&mut self, message: String)

Adds a block of history output to the UI state.

This is used for displaying multi-line output from commands like history. Each line is prefixed with a special marker for rendering purposes.

Arguments

• message - The string content of the history output.

pub fn update_chat_scroll_state(&mut self, terminal_height: usize)

Updates the chat scroll state based on the current terminal height.

This ensures that the scroll_offset remains within valid bounds and updates is_at_bottom_chat.

Arguments

• terminal_height - The current height of the terminal in lines.

pub fn calculate_total_chat_items(&self) -> usize

Calculates the total number of displayable items in the chat view.

This includes both actual messages and generic chat messages.

Returns

The total count of items that can be displayed.

pub fn jump_to_bottom_chat(&mut self)

Scrolls the chat view to the bottom.

impl UIState

pub fn safe_insert_char(&mut self, c: char)

Inserts a character safely into the input buffer at the current cursor position.

Handles multi-byte characters correctly.

Arguments

• c - The character to insert.

pub fn safe_remove_char_before(&mut self) -> bool

Removes the character before the current cursor position safely.

Handles multi-byte characters correctly.

Returns

true if a character was removed, false otherwise.

pub fn safe_remove_char_at(&mut self) -> bool

Removes the character at the current cursor position safely.

Handles multi-byte characters correctly.

Returns

true if a character was removed, false otherwise.

pub fn safe_cursor_left(&mut self)

Moves the cursor one position to the left.

pub fn safe_cursor_right(&mut self)

Moves the cursor one position to the right.

pub fn safe_cursor_home(&mut self)

Moves the cursor to the beginning of the input buffer.

pub fn safe_cursor_end(&mut self)

Moves the cursor to the end of the input buffer.

impl UIState

pub fn add_log_batch(&mut self, entries: Vec<LogEntry>)

Adds a batch of new log entries to the UI state.

This function appends new log entries to the buffer, enforcing max_log_entries. If the UI is in log mode and at the bottom of the scroll, it resets the scroll offset. Otherwise, it adjusts the scroll offset to keep new messages visible if not explicitly scrolled up.

Arguments

• entries - A Vec of LogEntry to add.

pub fn refresh_logs(&mut self)

Triggers a refresh of the log display.

This function resets the log scroll offset and marks the view as being at the bottom, useful when filter settings change.

pub fn update_log_scroll_state(&mut self, terminal_height: usize)

Updates the log scroll state based on the current terminal height.

This ensures that the log_scroll_offset remains within valid bounds and updates is_at_bottom_log.

Arguments

• terminal_height - The current height of the terminal in lines.

pub fn jump_to_bottom_log(&mut self)

Scrolls the log view to the bottom.

pub fn filtered_logs(&self) -> Vec<&LogEntry>

Returns a vector of log entries filtered by the current UIMode::Logs settings.

Logs can be filtered by minimum Level and by a text filter string, which can include exclusions prefixed with -.

impl UIState

pub fn new() -> Self

Creates a new UIState with default values.

pub fn toggle_mode(&mut self)

Toggles the UI mode between chat and logs.

When switching to log mode for the first time or from chat mode, it initializes log mode settings if not already defined. Resets scroll offsets and is_at_bottom flags upon mode change.

pub fn replace_messages(&mut self, messages: Vec<Message>)

Replaces the current list of displayed messages with a new set.

Resets scroll offset to the bottom after replacing messages.

Arguments

• messages - A Vec of Messages to display.

fn contains_message(&self, message_id: &Uuid) -> bool

Checks if a message with the given ID already exists in the UI state.

Arguments

• message_id - The Uuid of the message to check.

Returns

true if the message is found, false otherwise.

Trait Implementations

impl Debug for UIState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.