vortex-tui 0.77.0

a small but mighty tool for working with Vortex files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright the Vortex contributors

//! UI rendering components for the TUI browser.

mod layouts;
#[cfg(feature = "native")]
mod query;
mod segments;

use layouts::render_layouts;
#[cfg(feature = "native")]
pub use query::QueryFocus;
#[cfg(feature = "native")]
pub use query::QueryState;
#[cfg(feature = "native")]
pub use query::SortDirection;
#[cfg(feature = "native")]
use query::render_query;
use ratatui::prelude::*;
use ratatui::widgets::Block;
use ratatui::widgets::BorderType;
use ratatui::widgets::Borders;
use ratatui::widgets::Tabs;
pub use segments::SegmentGridState;

use super::app::AppState;
use super::app::KeyMode;
use super::app::Tab;
use crate::browse::ui::segments::segments_ui;

/// Render the complete TUI application to the given frame.
///
/// This is the main entry point for rendering. It draws:
/// - The outer border with title and help text
/// - The tab bar showing available views
/// - The content area for the currently selected tab
pub fn render_app(app: &mut AppState, frame: &mut Frame<'_>) {
    // Render the outer tab view, then render the inner frame view.
    let bottom_text = if app.key_mode == KeyMode::Search {
        Line::from(format!(
            "Searching (press esc to exit): {}",
            app.search_filter.as_str()
        ))
        .yellow()
        .on_black()
        .left_aligned()
    } else {
        Line::from("press q to quit |  ← to go up a level | ENTER to select | / to search")
            .centered()
    };
    let shell = Block::default()
        .borders(Borders::ALL)
        .border_type(BorderType::Rounded)
        .border_style(Style::default().fg(Color::Rgb(89, 113, 253)))
        .title_top("Vortex Browser")
        .title_bottom(bottom_text)
        .title_alignment(Alignment::Center);

    // The rest of the app is rendered inside the shell.
    let inner_area = shell.inner(frame.area());

    frame.render_widget(shell, frame.area());

    // Split the inner area into a Tab view area and the rest of the screen.
    let [tab_view, app_view] = Layout::vertical([
        // Tab bar area - 1 line
        Constraint::Length(1),
        // Rest of the interior space for app view
        Constraint::Min(0),
    ])
    .areas(inner_area);

    // Display a tab indicator.
    #[cfg(feature = "native")]
    let (selected_tab, tab_names) = {
        let selected = match app.current_tab {
            Tab::Layout => 0,
            Tab::Segments => 1,
            Tab::Query => 2,
        };
        (selected, vec!["File Layout", "Segments", "Query"])
    };

    #[cfg(not(feature = "native"))]
    let (selected_tab, tab_names) = {
        let selected = match app.current_tab {
            Tab::Layout => 0,
            Tab::Segments => 1,
        };
        (selected, vec!["File Layout", "Segments"])
    };

    let tabs = Tabs::new(tab_names)
        .style(Style::default().bold().white())
        .highlight_style(
            Style::default()
                .bold()
                .fg(Color::Rgb(16, 16, 16))
                .bg(Color::Rgb(89, 113, 253)),
        )
        .select(Some(selected_tab));

    frame.render_widget(tabs, tab_view);

    // Render the view for the current tab.
    match app.current_tab {
        Tab::Layout => {
            render_layouts(app, app_view, frame.buffer_mut());
        }
        Tab::Segments => segments_ui(app, app_view, frame.buffer_mut()),
        #[cfg(feature = "native")]
        Tab::Query => render_query(app, app_view, frame.buffer_mut()),
    }
}