Struct AppState 

pub struct AppState<'a> {

    pub session: &'a VortexSession,
    pub key_mode: KeyMode,
    pub search_filter: String,
    pub filter: Option<Vec<bool>>,
    pub vxf: VortexFile,
    pub cursor: LayoutCursor,
    pub current_tab: Tab,
    pub layouts_list_state: ListState,
    pub segment_grid_state: SegmentGridState<'a>,
    pub frame_size: Size,
    pub tree_scroll_offset: u16,
    pub query_state: QueryState,
    pub file_path: String,
}

The complete application state for the TUI browser.

This struct holds all state needed to render and interact with the TUI, including:

• The Vortex session and file being browsed
• Navigation state (current cursor position, selected tab)
• Input mode and search filter state
• UI state for lists and grids

The state is preserved when switching between tabs, allowing users to return to their previous position.

Fields

session: &'a VortexSession

The Vortex session used to read array data during rendering.

key_mode: KeyMode

The current input mode (normal navigation or search).

search_filter: String

The current search filter string (only used in search mode).

filter: Option<Vec<bool>>

A boolean mask indicating which children match the current search filter.

None when no filter is active, Some(vec) when filtering where vec[i] indicates whether child i should be shown.

vxf: VortexFile

The open Vortex file being browsed.

cursor: LayoutCursor

The current position in the layout hierarchy.

current_tab: Tab

The currently selected tab.

layouts_list_state: ListState

Selection state for the layout children list.

segment_grid_state: SegmentGridState<'a>

State for the segment grid display.

frame_size: Size

The size of the last rendered frame.

tree_scroll_offset: u16

Vertical scroll offset for the encoding tree display in flat layout view.

query_state: QueryState

State for the Query tab

file_path: String

File path for use in query execution

Implementations

impl<'a> AppState<'a>

pub async fn new( session: &'a VortexSession, path: impl AsRef<Path>, ) -> VortexResult<AppState<'a>>

Create a new application state by opening a Vortex file.

Errors

Returns an error if the file cannot be opened or read.

pub fn clear_search(&mut self)

Clear the current search filter and return to showing all children.

pub fn reset_layout_view_state(&mut self)

Reset the layout view state after navigating to a different layout.

This resets the list selection to the first item and clears any scroll offset.