pacsea 0.8.2

A fast, friendly TUI for browsing and installing Arch and AUR packages with built-in news and security scanning
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
116
117
118
119
120

use crossterm::event::KeyEvent;

use super::super::utils::matches_any;
use super::normal_mode::{handle_export, handle_menu_toggles};
use crate::state::AppState;

/// What: Handle Shift+char keybinds (menus, import, export, updates, status) that work across all panes and modes.
///
/// Inputs:
/// - `ke`: Key event from terminal
/// - `app`: Mutable application state
///
/// Output:
/// - `true` if a Shift+char keybind was handled, `false` otherwise
///
/// Details:
/// - Handles menu toggles (Shift+C, Shift+O, Shift+P), import (Shift+I), export (Shift+E),
///   updates (Shift+U), and status (Shift+S).
/// - Works in insert mode, normal mode, and all panes (Search, Recent, Install).
pub fn handle_shift_keybinds(ke: &KeyEvent, app: &mut AppState) -> bool {
    // Handle menu toggles
    if handle_menu_toggles(ke, app) {
        return true;
    }

    // Handle import (Shift+I)
    if matches_any(ke, &app.keymap.search_normal_import) {
        if !app.installed_only_mode {
            app.modal = crate::state::Modal::ImportHelp;
        }
        return true;
    }

    // Handle export (Shift+E)
    if matches_any(ke, &app.keymap.search_normal_export) {
        handle_export(app);
        return true;
    }

    // Handle updates (Shift+U)
    if matches_any(ke, &app.keymap.search_normal_updates) {
        // In News mode, open News modal; otherwise open Updates modal
        if matches!(app.app_mode, crate::state::types::AppMode::News) {
            crate::events::mouse::handle_news_button(app);
        } else {
            crate::events::mouse::handle_updates_button(app);
        }
        return true;
    }

    // Handle status (Shift+S)
    if matches_any(ke, &app.keymap.search_normal_open_status) {
        crate::util::open_url("https://status.archlinux.org");
        return true;
    }

    false
}

/// What: Handle pane navigation from Search pane to adjacent panes.
///
/// Inputs:
/// - `app`: Mutable application state
/// - `direction`: Direction to navigate ("right" for Install, "left" for Recent)
/// - `details_tx`: Channel to request details for the focused item
/// - `preview_tx`: Channel to request preview details when moving focus
///
/// Output:
/// - None (modifies app state directly)
///
/// Details:
/// - In installed-only mode, right navigation targets Downgrade first.
/// - Otherwise, right navigation targets Install list.
/// - Left navigation always targets Recent pane.
pub fn navigate_pane(
    app: &mut AppState,
    direction: &str,
    details_tx: &tokio::sync::mpsc::UnboundedSender<crate::state::PackageItem>,
    preview_tx: &tokio::sync::mpsc::UnboundedSender<crate::state::PackageItem>,
) {
    if matches!(app.app_mode, crate::state::types::AppMode::News) {
        match direction {
            "right" => {
                app.focus = crate::state::Focus::Install; // bookmarks pane
            }
            "left" => {
                app.focus = crate::state::Focus::Recent; // history pane
            }
            _ => {}
        }
        return;
    }
    match direction {
        "right" => {
            if app.installed_only_mode {
                // Target Downgrade first in installed-only mode
                app.right_pane_focus = crate::state::RightPaneFocus::Downgrade;
                if app.downgrade_state.selected().is_none() && !app.downgrade_list.is_empty() {
                    app.downgrade_state.select(Some(0));
                }
                app.focus = crate::state::Focus::Install;
                super::super::utils::refresh_downgrade_details(app, details_tx);
            } else {
                if app.install_state.selected().is_none() && !app.install_list.is_empty() {
                    app.install_state.select(Some(0));
                }
                app.focus = crate::state::Focus::Install;
                super::super::utils::refresh_install_details(app, details_tx);
            }
        }
        "left" => {
            if app.history_state.selected().is_none() && !app.recent.is_empty() {
                app.history_state.select(Some(0));
            }
            app.focus = crate::state::Focus::Recent;
            crate::ui::helpers::trigger_recent_preview(app, preview_tx);
        }
        _ => {}
    }
}