acorn-tui 0.2.0

ACORN terminal user interface (TUI)
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

mod app;
mod event;
pub mod export;
mod screens;
mod theme;
mod widgets;

use app::App;
pub use app::{Candidate, GgufPickerData, State};
use color_eyre::eyre::{Ok, Result};
use crossterm::terminal::{disable_raw_mode, enable_raw_mode, EnterAlternateScreen, LeaveAlternateScreen};
use crossterm::ExecutableCommand;
use ratatui::backend::CrosstermBackend;
use ratatui::Terminal;
use std::io::stdout;
use std::path::PathBuf;

/// Entry screen for the TUI
#[derive(Clone, Copy, Debug, PartialEq)]
pub enum Screen {
    /// Dashboard hub
    Dashboard,
    /// Interactive diagnostic browser
    Doctor,
    /// Interactive check browser
    Check,
    /// Interactive GGUF repository picker
    GgufPicker,
    /// Interactive persistent identifier gatherer
    Gather,
    /// Interactive terminal theme picker
    ThemePicker,
}
/// Runtime settings inherited from the ACORN command line.
#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct TuiOptions {
    /// Override the local database path.
    pub database_path: Option<PathBuf>,
    /// Disable discovery persistence.
    pub no_local_database: bool,
    /// Prevent remote input retrieval.
    pub offline: bool,
}
/// Run the TUI with a given start screen
pub fn run(initial_screen: Screen) -> Result<()> {
    run_with(initial_screen, None).map(|_| ())
}
/// Run the TUI with optional GGUF picker state and return the selected repository ID.
pub fn run_with(initial_screen: Screen, initial_state: Option<State<GgufPickerData>>) -> Result<Option<String>> {
    run_with_options(initial_screen, initial_state, TuiOptions::default())
}
/// Run the TUI with caller-provided network and database settings.
pub fn run_with_options(initial_screen: Screen, initial_state: Option<State<GgufPickerData>>, options: TuiOptions) -> Result<Option<String>> {
    enable_raw_mode()?;
    let mut stdout = stdout();
    stdout.execute(EnterAlternateScreen)?;
    let backend = CrosstermBackend::new(stdout);
    let mut terminal = Terminal::new(backend)?;
    terminal.clear()?;
    let mut app = App::with_options(initial_screen, options);
    if let Some(state) = initial_state {
        app.set_gguf_picker(state);
    }
    let result = app.run(&mut terminal);
    disable_raw_mode()?;
    terminal.backend_mut().execute(LeaveAlternateScreen)?;
    terminal.show_cursor()?;
    result?;
    Ok(app.take_gguf_picker_result())
}