neser 1.2.0

NESER - Nintendo Emulation Systems Engine (Rust). Desktop and WebAssembly frontends.
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

//! TUI frontend for Neser — launched via `--tui` flag.
//!
//! This module provides an interactive terminal UI for browsing ROMs and
//! launching the emulator. It requires the `tui` Cargo feature.

mod action_menu;
mod app;
mod catalog;
mod launcher;
mod rom_entry;
mod rom_list;
mod terminal;

use app::App;
use terminal::TerminalHandle;

/// Launch the TUI ROM browser.
///
/// Sets up the terminal, runs the interactive UI, then restores the terminal.
/// Catalog load errors are surfaced in the TUI status bar rather than aborting.
///
/// # Errors
///
/// Returns an error if terminal setup or the event loop fails.
pub fn run_tui(
    search_paths: &[String],
    rebuild_catalog: bool,
    include_unofficial: bool,
) -> Result<(), Box<dyn std::error::Error>> {
    let (entries, catalog_err) =
        match catalog::load_catalog(search_paths, rebuild_catalog, include_unofficial) {
            Ok(entries) => (entries, None),
            Err(e) => (vec![], Some(e)),
        };

    let mut terminal = TerminalHandle::new()?;
    let mut app = App::new(entries);
    if let Some(err) = catalog_err {
        app = app.with_catalog_error(err);
    }
    app.run(&mut terminal)?;
    Ok(())
}