pacsea 0.8.2

use std::collections::HashMap;

use crossterm::event::{KeyCode, KeyModifiers};
use ratatui::style::Color;

/// Application theme palette used by rendering code.
///
/// All colors are provided as [`ratatui::style::Color`] and are suitable for
/// direct use with widgets and styles.
#[derive(Clone, Copy, Debug)]
pub struct Theme {
    /// Primary background color for the canvas.
    pub base: Color,
    /// Slightly lighter background layer used behind panels.
    pub mantle: Color,
    /// Darkest background shade for deep contrast areas.
    pub crust: Color,
    /// Subtle surface color for component backgrounds (level 1).
    pub surface1: Color,
    /// Subtle surface color for component backgrounds (level 2).
    pub surface2: Color,
    /// Muted overlay line/border color (primary).
    pub overlay1: Color,
    /// Muted overlay line/border color (secondary).
    pub overlay2: Color,
    /// Primary foreground text color.
    pub text: Color,
    /// Secondary text for less prominent content.
    pub subtext0: Color,
    /// Tertiary text for captions and low-emphasis content.
    pub subtext1: Color,
    /// Accent color commonly used for selection and interactive highlights.
    pub sapphire: Color,
    /// Accent color for emphasized headings or selections.
    pub mauve: Color,
    /// Success/positive state color.
    pub green: Color,
    /// Warning/attention state color.
    pub yellow: Color,
    /// Error/danger state color.
    pub red: Color,
    /// Accent color for subtle emphasis and borders.
    pub lavender: Color,
}

/// User-configurable application settings parsed from `pacsea.conf`.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum PackageMarker {
    /// Color the entire line for the marked package.
    FullLine,
    /// Add a marker at the front of the line.
    Front,
    /// Add a marker at the end of the line.
    End,
}

/// User-configurable application settings parsed from `pacsea.conf`.
#[derive(Clone, Debug)]
#[allow(clippy::struct_excessive_bools)]
pub struct Settings {
    /// Percentage width allocated to the Recent pane (left column).
    pub layout_left_pct: u16,
    /// Percentage width allocated to the Search pane (center column).
    pub layout_center_pct: u16,
    /// Percentage width allocated to the Install pane (right column).
    pub layout_right_pct: u16,
    /// Vertical order of the main stack: results list, middle search row, package info (each once).
    pub main_pane_order: [crate::state::MainVerticalPane; 3],
    /// Minimum terminal rows for the results list band.
    pub vertical_min_results: u16,
    /// Maximum terminal rows for the results list band.
    pub vertical_max_results: u16,
    /// Minimum terminal rows for the middle (search) row.
    pub vertical_min_middle: u16,
    /// Maximum terminal rows for the middle row.
    pub vertical_max_middle: u16,
    /// Minimum terminal rows for package info when that band is shown.
    pub vertical_min_package_info: u16,
    /// Default value for the application's dry-run mode on startup.
    /// This can be toggled via the `--dry-run` CLI flag.
    pub app_dry_run_default: bool,
    /// Configurable key bindings parsed from `pacsea.conf`
    pub keymap: KeyMap,
    /// Initial sort mode for results list.
    pub sort_mode: crate::state::SortMode,
    /// Text appended when copying PKGBUILD to clipboard.
    pub clipboard_suffix: String,
    /// Whether the Search history pane should be shown on startup.
    pub show_recent_pane: bool,
    /// Whether the Install/Remove pane should be shown on startup.
    pub show_install_pane: bool,
    /// Whether the keybinds footer should be shown on startup.
    pub show_keybinds_footer: bool,
    /// Selected countries used when updating mirrors (comma-separated or multiple).
    pub selected_countries: String,
    /// Number of mirrors to fetch/rank when updating.
    pub mirror_count: u16,
    /// `VirusTotal` API key for security scanning.
    pub virustotal_api_key: String,
    /// Whether to run `ClamAV` scan on AUR packages.
    pub scan_do_clamav: bool,
    /// Whether to run `Trivy` scan on AUR packages.
    pub scan_do_trivy: bool,
    /// Whether to run `Semgrep` scan on AUR packages.
    pub scan_do_semgrep: bool,
    /// Whether to run `ShellCheck` scan on AUR packages.
    pub scan_do_shellcheck: bool,
    /// Whether to run `VirusTotal` scan on AUR packages.
    pub scan_do_virustotal: bool,
    /// Whether to run custom scan on AUR packages.
    pub scan_do_custom: bool,
    /// Whether to run Sleuth scan on AUR packages.
    pub scan_do_sleuth: bool,
    /// Comma-separated `ShellCheck` rule IDs to pass as `--exclude` when running PKGBUILD static checks.
    /// Empty means `ShellCheck` runs without `--exclude`.
    pub pkgbuild_shellcheck_exclude: String,
    /// When true, the PKGBUILD details pane may show the expandable `Raw output:` block from static checks.
    /// When false, findings and status still show; raw command output is hidden. Defaults to false.
    pub pkgbuild_checks_show_raw_output: bool,
    /// Whether to start the app in News mode (true) or Package mode (false).
    pub start_in_news: bool,
    /// Whether to show Arch news items in the News view.
    pub news_filter_show_arch_news: bool,
    /// Whether to show security advisories in the News view.
    pub news_filter_show_advisories: bool,
    /// Whether to show installed package update items in the News view.
    pub news_filter_show_pkg_updates: bool,
    /// Whether to show AUR package update items in the News view.
    pub news_filter_show_aur_updates: bool,
    /// Whether to show installed AUR comment items in the News view.
    pub news_filter_show_aur_comments: bool,
    /// Whether to restrict advisories to installed packages in the News view.
    pub news_filter_installed_only: bool,
    /// Maximum age of news items in days (None = unlimited).
    pub news_max_age_days: Option<u32>,
    /// Whether startup news popup setup has been completed.
    pub startup_news_configured: bool,
    /// Whether to show Arch news in startup news popup.
    pub startup_news_show_arch_news: bool,
    /// Whether to show security advisories in startup news popup.
    pub startup_news_show_advisories: bool,
    /// Whether to show AUR updates in startup news popup.
    pub startup_news_show_aur_updates: bool,
    /// Whether to show AUR comments in startup news popup.
    pub startup_news_show_aur_comments: bool,
    /// Whether to show official package updates in startup news popup.
    pub startup_news_show_pkg_updates: bool,
    /// Maximum age of news items in days for startup news popup (None = unlimited).
    pub startup_news_max_age_days: Option<u32>,
    /// How many days to keep Arch news and advisories cached on disk.
    /// Default is 7 days. Helps reduce network requests on startup.
    pub news_cache_ttl_days: u32,
    /// Visual marker style for packages added to Install/Remove/Downgrade lists.
    pub package_marker: PackageMarker,
    /// Symbol used to mark a news item as read in the News modal.
    pub news_read_symbol: String,
    /// Symbol used to mark a news item as unread in the News modal.
    pub news_unread_symbol: String,
    /// Preferred terminal binary name to spawn for shell commands (e.g., "alacritty", "kitty", "gnome-terminal").
    /// When empty, Pacsea auto-detects from available terminals.
    pub preferred_terminal: String,
    /// When true, skip the Preflight modal and execute actions directly (install/remove/downgrade).
    /// Defaults to false to preserve the safer, review-first workflow.
    pub skip_preflight: bool,
    /// Locale code for translations (e.g., "de-DE", "en-US").
    /// Empty string means auto-detect from system locale.
    pub locale: String,
    /// Search input mode on startup.
    /// When false, starts in insert mode (default).
    /// When true, starts in normal mode.
    pub search_startup_mode: bool,
    /// Whether fuzzy search is enabled by default on startup.
    /// When false, uses normal substring search (default).
    /// When true, uses fuzzy matching (fzf-style).
    pub fuzzy_search: bool,
    /// Refresh interval in seconds for pacman -Qu and AUR helper checks.
    /// Default is 30 seconds. Set to a higher value to reduce resource usage on slow systems.
    pub updates_refresh_interval: u64,
    /// Filter mode for installed packages display.
    /// `LeafOnly` shows explicitly installed packages with no dependents.
    /// `AllExplicit` shows all explicitly installed packages.
    pub installed_packages_mode: crate::state::InstalledPackagesMode,
    /// Whether to fetch remote announcements from GitHub Gist.
    /// If `true`, fetches announcements from the configured Gist URL.
    /// If `false`, remote announcements are disabled (version announcements still show).
    pub get_announcement: bool,
    /// Whether to use passwordless sudo for install operations when available.
    /// If `false` (default), password prompt is always shown even if passwordless sudo is configured.
    /// If `true`, passwordless sudo is used when available, skipping the password prompt.
    /// This acts as an additional safety barrier requiring explicit opt-in.
    pub use_passwordless_sudo: bool,
    /// Privilege escalation tool selection mode.
    /// Controls which tool (sudo/doas) is used for privileged operations.
    /// `Auto` (default): prefer doas if available, fall back to sudo.
    /// `Sudo`: always use sudo. `Doas`: always use doas.
    pub privilege_mode: crate::logic::privilege::PrivilegeMode,
    /// Authentication mode for privilege escalation.
    /// Controls how Pacsea handles password/authentication before privileged operations.
    /// `Prompt` (default): Pacsea captures password only for stdin-capable tools (sudo).
    /// For doas, prompt mode is coerced to `Interactive` because doas cannot read stdin passwords.
    /// `PasswordlessOnly`: Skip prompt only when `{tool} -n true` succeeds.
    /// `Interactive`: Let the privilege tool handle auth directly (fingerprint via PAM, etc.).
    pub auth_mode: crate::logic::privilege::AuthMode,
    /// Whether to use the terminal's theme colors instead of theme.conf.
    /// If `true`, Pacsea queries the terminal for foreground/background colors via OSC 10/11.
    /// If `false` (default), uses theme.conf colors.
    /// Note: Terminal theme is also used automatically when theme.conf is missing/invalid
    /// and the terminal is on the supported list (alacritty, kitty, konsole, ghostty, xterm,
    /// gnome-terminal, xfce4-terminal, tilix, mate-terminal, wezterm-gui, `WezTerm`).
    pub use_terminal_theme: bool,
    /// Whether AUR voting via SSH is enabled.
    /// Requires an SSH key uploaded to the user's AUR account.
    pub aur_vote_enabled: bool,
    /// SSH connect timeout in seconds for AUR vote commands.
    pub aur_vote_ssh_timeout_seconds: u32,
    /// SSH binary path or name for AUR vote commands.
    /// Defaults to `"ssh"`. Override for non-standard SSH setups.
    pub aur_vote_ssh_command: String,
    /// Dynamic results-list toggles from `repos.conf` filter ids (canonical keys, see `repos` module).
    ///
    /// Keys match canonical `results_filter` tokens from repos.conf (e.g. `vendor_pkgs` for `results_filter_show_vendor_pkgs`).
    pub results_filter_toggles: HashMap<String, bool>,
}

impl Default for Settings {
    /// What: Provide the built-in baseline configuration for Pacsea settings.
    ///
    /// Inputs:
    /// - None.
    ///
    /// Output:
    /// - Returns a `Settings` instance populated with Pacsea's preferred defaults.
    ///
    /// Details:
    /// - Sets balanced pane layout percentages and enables all panes by default.
    /// - Enables all scan types and uses Catppuccin-inspired news glyphs.
    fn default() -> Self {
        Self {
            layout_left_pct: 20,
            layout_center_pct: 60,
            layout_right_pct: 20,
            main_pane_order: crate::state::DEFAULT_MAIN_PANE_ORDER,
            vertical_min_results: 3,
            vertical_max_results: 17,
            vertical_min_middle: 3,
            vertical_max_middle: 5,
            vertical_min_package_info: 3,
            app_dry_run_default: false,
            keymap: KeyMap::default(),
            sort_mode: crate::state::SortMode::RepoThenName,
            clipboard_suffix: "Check PKGBUILD and source for suspicious and malicious activities"
                .to_string(),
            show_recent_pane: true,
            show_install_pane: true,
            show_keybinds_footer: true,
            selected_countries: "Worldwide".to_string(),
            mirror_count: 20,
            virustotal_api_key: String::new(),
            scan_do_clamav: true,
            scan_do_trivy: true,
            scan_do_semgrep: true,
            scan_do_shellcheck: true,
            scan_do_virustotal: true,
            scan_do_custom: true,
            scan_do_sleuth: true,
            pkgbuild_shellcheck_exclude: "SC2034, SC2164, SC2148, SC2154".to_string(),
            pkgbuild_checks_show_raw_output: false,
            start_in_news: false,
            news_filter_show_arch_news: true,
            news_filter_show_advisories: true,
            news_filter_show_pkg_updates: true,
            news_filter_show_aur_updates: true,
            news_filter_show_aur_comments: true,
            news_filter_installed_only: false,
            news_max_age_days: Some(30),
            startup_news_configured: false,
            startup_news_show_arch_news: true,
            startup_news_show_advisories: true,
            startup_news_show_aur_updates: true,
            startup_news_show_aur_comments: true,
            startup_news_show_pkg_updates: true,
            startup_news_max_age_days: Some(7),
            news_cache_ttl_days: 7,
            package_marker: PackageMarker::Front,
            news_read_symbol: "✓".to_string(),
            news_unread_symbol: "∘".to_string(),
            preferred_terminal: String::new(),
            skip_preflight: false,
            locale: String::new(),        // Empty means auto-detect from system
            search_startup_mode: false,   // Default to insert mode
            fuzzy_search: false,          // Default to normal substring search
            updates_refresh_interval: 30, // Default to 30 seconds
            installed_packages_mode: crate::state::InstalledPackagesMode::LeafOnly,
            get_announcement: true, // Default to fetching remote announcements
            use_passwordless_sudo: false, // Default to always showing password prompt (safety barrier)
            privilege_mode: crate::logic::privilege::PrivilegeMode::Auto, // Default to auto-detect (prefer doas, fallback sudo)
            auth_mode: crate::logic::privilege::AuthMode::Prompt, // Default to Pacsea password modal
            use_terminal_theme: false, // Default to using theme.conf colors
            aur_vote_enabled: true,    // Enabled by default; requires SSH key configured on AUR
            aur_vote_ssh_timeout_seconds: 10,
            aur_vote_ssh_command: "ssh".to_string(),
            results_filter_toggles: HashMap::new(),
        }
    }
}

/// A single keyboard chord (modifiers + key).
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct KeyChord {
    /// The key code (e.g., Char('a'), Enter, Esc).
    pub code: KeyCode,
    /// The modifier keys (e.g., Ctrl, Shift, Alt).
    pub mods: KeyModifiers,
}

impl KeyChord {
    /// Return a short display label such as "Ctrl+R", "F1", "Shift+Del", "+/ ?".
    #[must_use]
    pub fn label(&self) -> String {
        let mut parts: Vec<&'static str> = Vec::new();
        if self.mods.contains(KeyModifiers::CONTROL) {
            parts.push("Ctrl");
        }
        if self.mods.contains(KeyModifiers::ALT) {
            parts.push("Alt");
        }
        if self.mods.contains(KeyModifiers::SHIFT) {
            parts.push("Shift");
        }
        if self.mods.contains(KeyModifiers::SUPER) {
            parts.push("Super");
        }
        let key = match self.code {
            KeyCode::Char(ch) => {
                // Show uppercase character for display
                let up = ch.to_ascii_uppercase();
                if up == ' ' {
                    "Space".to_string()
                } else {
                    up.to_string()
                }
            }
            KeyCode::Enter => "Enter".to_string(),
            KeyCode::Esc => "Esc".to_string(),
            KeyCode::Backspace => "Backspace".to_string(),
            KeyCode::Tab => "Tab".to_string(),
            KeyCode::BackTab => "Shift+Tab".to_string(),
            KeyCode::Delete => "Del".to_string(),
            KeyCode::Insert => "Ins".to_string(),
            KeyCode::Home => "Home".to_string(),
            KeyCode::End => "End".to_string(),
            KeyCode::PageUp => "PgUp".to_string(),
            KeyCode::PageDown => "PgDn".to_string(),
            KeyCode::Up => "↑".to_string(),
            KeyCode::Down => "↓".to_string(),
            KeyCode::Left => "←".to_string(),
            KeyCode::Right => "→".to_string(),
            KeyCode::F(n) => format!("F{n}"),
            _ => "?".to_string(),
        };
        if parts.is_empty() || matches!(self.code, KeyCode::BackTab) {
            key
        } else {
            format!("{}+{key}", parts.join("+"))
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    /// What: Ensure `KeyChord::label` renders user-facing text for modifier and key combinations.
    ///
    /// Inputs:
    /// - Sample chords covering control characters, space, function keys, Shift+BackTab, arrow keys, and multi-modifier chords.
    ///
    /// Output:
    /// - Labels such as `"Ctrl+R"`, `"Space"`, `"F5"`, `"Shift+Tab"`, arrow glyphs, and combined modifier strings.
    ///
    /// Details:
    /// - Protects the formatting logic that appears in keybinding help overlays.
    fn theme_keychord_label_variants() {
        let kc = KeyChord {
            code: KeyCode::Char('r'),
            mods: KeyModifiers::CONTROL,
        };
        assert_eq!(kc.label(), "Ctrl+R");

        let kc2 = KeyChord {
            code: KeyCode::Char(' '),
            mods: KeyModifiers::empty(),
        };
        assert_eq!(kc2.label(), "Space");

        let kc3 = KeyChord {
            code: KeyCode::F(5),
            mods: KeyModifiers::empty(),
        };
        assert_eq!(kc3.label(), "F5");

        let kc4 = KeyChord {
            code: KeyCode::BackTab,
            mods: KeyModifiers::SHIFT,
        };
        assert_eq!(kc4.label(), "Shift+Tab");

        let kc5 = KeyChord {
            code: KeyCode::Left,
            mods: KeyModifiers::empty(),
        };
        assert_eq!(kc5.label(), "←");

        let kc6 = KeyChord {
            code: KeyCode::Char('x'),
            mods: KeyModifiers::ALT | KeyModifiers::SHIFT,
        };
        assert_eq!(kc6.label(), "Alt+Shift+X");
    }
}

/// Application key bindings.
/// Each action can have multiple chords.
#[derive(Clone, Debug)]
pub struct KeyMap {
    // Global
    /// Key chords to show help overlay.
    pub help_overlay: Vec<KeyChord>,
    /// Key chords to reload configuration.
    pub reload_config: Vec<KeyChord>,
    /// Key chords to exit the application.
    pub exit: Vec<KeyChord>,
    /// Global: Show/Hide PKGBUILD viewer
    pub show_pkgbuild: Vec<KeyChord>,
    /// Global: Show/Hide AUR comments viewer
    pub comments_toggle: Vec<KeyChord>,
    /// Global: Run PKGBUILD static checks in preview panel.
    pub run_pkgbuild_checks: Vec<KeyChord>,
    /// Global: Cycle PKGBUILD pane between body, `ShellCheck`, and `Namcap` sections.
    pub cycle_pkgbuild_sections: Vec<KeyChord>,
    /// Global: Change results sorting mode
    pub change_sort: Vec<KeyChord>,
    /// Key chords to move to next pane.
    pub pane_next: Vec<KeyChord>,
    /// Key chords to move focus left.
    pub pane_left: Vec<KeyChord>,
    /// Key chords to move focus right.
    pub pane_right: Vec<KeyChord>,
    /// Global: Toggle Config/Lists dropdown
    pub config_menu_toggle: Vec<KeyChord>,
    /// Global: Toggle Options dropdown
    pub options_menu_toggle: Vec<KeyChord>,
    /// Global: Toggle Panels dropdown
    pub panels_menu_toggle: Vec<KeyChord>,

    // Search
    /// Key chords to move selection up in search results.
    pub search_move_up: Vec<KeyChord>,
    /// Key chords to move selection down in search results.
    pub search_move_down: Vec<KeyChord>,
    /// Key chords to page up in search results.
    pub search_page_up: Vec<KeyChord>,
    /// Key chords to page down in search results.
    pub search_page_down: Vec<KeyChord>,
    /// Key chords to add package to install list.
    pub search_add: Vec<KeyChord>,
    /// Key chords to install selected package.
    pub search_install: Vec<KeyChord>,
    /// Key chords to move focus left from search pane.
    pub search_focus_left: Vec<KeyChord>,
    /// Key chords to move focus right from search pane.
    pub search_focus_right: Vec<KeyChord>,
    /// Key chords for backspace in search input.
    pub search_backspace: Vec<KeyChord>,
    /// Insert mode: clear entire search input (default: Shift+Del)
    pub search_insert_clear: Vec<KeyChord>,

    // Search normal mode
    /// Toggle Search normal mode on/off (works from both insert/normal)
    pub search_normal_toggle: Vec<KeyChord>,
    /// Enter insert mode while in Search normal mode
    pub search_normal_insert: Vec<KeyChord>,
    /// Normal mode: extend selection to the left (default: h)
    pub search_normal_select_left: Vec<KeyChord>,
    /// Normal mode: extend selection to the right (default: l)
    pub search_normal_select_right: Vec<KeyChord>,
    /// Normal mode: delete selected text (default: d)
    pub search_normal_delete: Vec<KeyChord>,
    /// Normal mode: clear entire search input (default: Shift+Del)
    pub search_normal_clear: Vec<KeyChord>,
    /// Normal mode: open Arch status page in browser (default: Shift+S)
    pub search_normal_open_status: Vec<KeyChord>,
    /// Normal mode: trigger Import packages dialog
    pub search_normal_import: Vec<KeyChord>,
    /// Normal mode: trigger Export Install list
    pub search_normal_export: Vec<KeyChord>,
    /// Normal mode: open Available Updates window
    pub search_normal_updates: Vec<KeyChord>,
    /// Toggle fuzzy search mode on/off
    pub toggle_fuzzy: Vec<KeyChord>,

    // Recent
    /// Key chords to move selection up in recent queries.
    pub recent_move_up: Vec<KeyChord>,
    /// Key chords to move selection down in recent queries.
    pub recent_move_down: Vec<KeyChord>,
    /// Key chords to find/search in recent queries.
    pub recent_find: Vec<KeyChord>,
    /// Key chords to use selected recent query.
    pub recent_use: Vec<KeyChord>,
    /// Key chords to add package from recent to install list.
    pub recent_add: Vec<KeyChord>,
    /// Key chords to move focus from recent to search pane.
    pub recent_to_search: Vec<KeyChord>,
    /// Key chords to move focus right from recent pane.
    pub recent_focus_right: Vec<KeyChord>,
    /// Remove one entry from Recent
    pub recent_remove: Vec<KeyChord>,
    /// Clear all entries in Recent
    pub recent_clear: Vec<KeyChord>,

    // Install
    /// Key chords to move selection up in install list.
    pub install_move_up: Vec<KeyChord>,
    /// Key chords to move selection down in install list.
    pub install_move_down: Vec<KeyChord>,
    /// Key chords to confirm and execute install/remove operation.
    pub install_confirm: Vec<KeyChord>,
    /// Key chords to remove item from install list.
    pub install_remove: Vec<KeyChord>,
    /// Key chords to clear install list.
    pub install_clear: Vec<KeyChord>,
    /// Key chords to find/search in install list.
    pub install_find: Vec<KeyChord>,
    /// Key chords to move focus from install to search pane.
    pub install_to_search: Vec<KeyChord>,
    /// Key chords to move focus left from install pane.
    pub install_focus_left: Vec<KeyChord>,

    // News modal
    /// Mark currently listed News items as read (without opening URL)
    pub news_mark_read: Vec<KeyChord>,
    /// Mark all listed News items as read
    pub news_mark_all_read: Vec<KeyChord>,
    /// Mark selected News Feed item as read.
    pub news_mark_read_feed: Vec<KeyChord>,
    /// Mark selected News Feed item as unread.
    pub news_mark_unread_feed: Vec<KeyChord>,
    /// Toggle read/unread for selected News Feed item.
    pub news_toggle_read_feed: Vec<KeyChord>,
}

/// Type alias for global key bindings tuple.
///
/// Contains 10 `Vec<KeyChord>` for `help_overlay`, `reload_config`, `exit`, `show_pkgbuild`, `comments_toggle`, `run_pkgbuild_checks`, `change_sort`, and pane navigation keys.
type GlobalKeys = (
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
);

/// Type alias for search key bindings tuple.
///
/// Contains 10 `Vec<KeyChord>` for search navigation, actions, and focus keys.
type SearchKeys = (
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
);

/// Type alias for search normal mode key bindings tuple.
///
/// Contains 10 `Vec<KeyChord>` for Vim-like normal mode search keys.
type SearchNormalKeys = (
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
);

/// Type alias for recent pane key bindings tuple.
///
/// Contains 9 `Vec<KeyChord>` for recent pane navigation and action keys.
type RecentKeys = (
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
);

/// Type alias for install list key bindings tuple.
///
/// Contains 8 `Vec<KeyChord>` for install list navigation and action keys.
type InstallKeys = (
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
    Vec<KeyChord>,
);

/// What: Create default global key bindings.
///
/// Inputs:
/// - `none`: Empty key modifiers
/// - `ctrl`: Control modifier
///
/// Output:
/// - Tuple of global key binding vectors
///
/// Details:
/// - Returns `help_overlay`, `reload_config`, `exit`, `show_pkgbuild`, `change_sort`, and pane navigation keys.
fn default_global_keys(none: KeyModifiers, ctrl: KeyModifiers) -> GlobalKeys {
    use KeyCode::{BackTab, Char, Left, Right, Tab};
    (
        vec![
            KeyChord {
                code: KeyCode::F(1),
                mods: none,
            },
            KeyChord {
                code: Char('?'),
                mods: none,
            },
        ],
        vec![KeyChord {
            code: Char('r'),
            mods: ctrl,
        }],
        vec![KeyChord {
            code: Char('c'),
            mods: ctrl,
        }],
        vec![KeyChord {
            code: Char('x'),
            mods: ctrl,
        }],
        vec![KeyChord {
            code: Char('t'),
            mods: ctrl,
        }],
        vec![KeyChord {
            code: Char('k'),
            mods: ctrl,
        }],
        vec![KeyChord {
            code: BackTab,
            mods: none,
        }],
        vec![KeyChord {
            code: Tab,
            mods: none,
        }],
        vec![KeyChord {
            code: Left,
            mods: none,
        }],
        vec![KeyChord {
            code: Right,
            mods: none,
        }],
    )
}

/// What: Create default dropdown toggle key bindings.
///
/// Inputs:
/// - `shift`: Shift modifier
///
/// Output:
/// - Tuple of dropdown toggle key binding vectors
///
/// Details:
/// - Returns `config_menu_toggle`, `options_menu_toggle`, and `panels_menu_toggle` keys.
fn default_dropdown_keys(shift: KeyModifiers) -> (Vec<KeyChord>, Vec<KeyChord>, Vec<KeyChord>) {
    use KeyCode::Char;
    (
        vec![KeyChord {
            code: Char('c'),
            mods: shift,
        }],
        vec![KeyChord {
            code: Char('o'),
            mods: shift,
        }],
        vec![KeyChord {
            code: Char('p'),
            mods: shift,
        }],
    )
}

/// What: Create default search key bindings.
///
/// Inputs:
/// - `none`: Empty key modifiers
///
/// Output:
/// - Tuple of search key binding vectors
///
/// Details:
/// - Returns all search-related key bindings for navigation, actions, and focus.
fn default_search_keys(none: KeyModifiers) -> SearchKeys {
    use KeyCode::{Backspace, Char, Down, Enter, Left, PageDown, PageUp, Right, Up};
    (
        vec![KeyChord {
            code: Up,
            mods: none,
        }],
        vec![KeyChord {
            code: Down,
            mods: none,
        }],
        vec![KeyChord {
            code: PageUp,
            mods: none,
        }],
        vec![KeyChord {
            code: PageDown,
            mods: none,
        }],
        vec![KeyChord {
            code: Char(' '),
            mods: none,
        }],
        vec![KeyChord {
            code: Enter,
            mods: none,
        }],
        vec![KeyChord {
            code: Left,
            mods: none,
        }],
        vec![KeyChord {
            code: Right,
            mods: none,
        }],
        vec![KeyChord {
            code: Backspace,
            mods: none,
        }],
        vec![KeyChord {
            code: KeyCode::Delete,
            mods: KeyModifiers::SHIFT,
        }],
    )
}

/// What: Create default search normal mode key bindings.
///
/// Inputs:
/// - `none`: Empty key modifiers
/// - `shift`: Shift modifier
///
/// Output:
/// - Tuple of search normal mode key binding vectors
///
/// Details:
/// - Returns all Vim-like normal mode key bindings for search.
fn default_search_normal_keys(none: KeyModifiers, shift: KeyModifiers) -> SearchNormalKeys {
    use KeyCode::{Char, Delete, Esc};
    (
        vec![KeyChord {
            code: Esc,
            mods: none,
        }],
        vec![KeyChord {
            code: Char('i'),
            mods: none,
        }],
        vec![KeyChord {
            code: Char('h'),
            mods: none,
        }],
        vec![KeyChord {
            code: Char('l'),
            mods: none,
        }],
        vec![KeyChord {
            code: Char('d'),
            mods: none,
        }],
        vec![KeyChord {
            code: Delete,
            mods: shift,
        }],
        vec![KeyChord {
            code: Char('s'),
            mods: shift,
        }],
        vec![KeyChord {
            code: Char('i'),
            mods: shift,
        }],
        vec![KeyChord {
            code: Char('e'),
            mods: shift,
        }],
        vec![KeyChord {
            code: Char('u'),
            mods: shift,
        }],
    )
}

/// What: Create default recent pane key bindings.
///
/// Inputs:
/// - `none`: Empty key modifiers
/// - `shift`: Shift modifier
///
/// Output:
/// - Tuple of recent pane key binding vectors
///
/// Details:
/// - Returns all recent pane navigation and action key bindings.
fn default_recent_keys(none: KeyModifiers, shift: KeyModifiers) -> RecentKeys {
    use KeyCode::{Char, Delete, Down, Enter, Esc, Right, Up};
    (
        vec![
            KeyChord {
                code: Char('k'),
                mods: none,
            },
            KeyChord {
                code: Up,
                mods: none,
            },
        ],
        vec![
            KeyChord {
                code: Char('j'),
                mods: none,
            },
            KeyChord {
                code: Down,
                mods: none,
            },
        ],
        vec![KeyChord {
            code: Char('/'),
            mods: none,
        }],
        vec![KeyChord {
            code: Enter,
            mods: none,
        }],
        vec![KeyChord {
            code: Char(' '),
            mods: none,
        }],
        vec![KeyChord {
            code: Esc,
            mods: none,
        }],
        vec![KeyChord {
            code: Right,
            mods: none,
        }],
        vec![
            KeyChord {
                code: Char('d'),
                mods: none,
            },
            KeyChord {
                code: Delete,
                mods: none,
            },
        ],
        vec![KeyChord {
            code: Delete,
            mods: shift,
        }],
    )
}

/// What: Create default install list key bindings.
///
/// Inputs:
/// - `none`: Empty key modifiers
/// - `shift`: Shift modifier
///
/// Output:
/// - Tuple of install list key binding vectors
///
/// Details:
/// - Returns all install list navigation and action key bindings.
fn default_install_keys(none: KeyModifiers, shift: KeyModifiers) -> InstallKeys {
    use KeyCode::{Char, Delete, Down, Enter, Esc, Left, Up};
    (
        vec![
            KeyChord {
                code: Char('k'),
                mods: none,
            },
            KeyChord {
                code: Up,
                mods: none,
            },
        ],
        vec![
            KeyChord {
                code: Char('j'),
                mods: none,
            },
            KeyChord {
                code: Down,
                mods: none,
            },
        ],
        vec![KeyChord {
            code: Enter,
            mods: none,
        }],
        vec![
            KeyChord {
                code: Delete,
                mods: none,
            },
            KeyChord {
                code: Char('d'),
                mods: none,
            },
        ],
        vec![KeyChord {
            code: Delete,
            mods: shift,
        }],
        vec![KeyChord {
            code: Char('/'),
            mods: none,
        }],
        vec![KeyChord {
            code: Esc,
            mods: none,
        }],
        vec![KeyChord {
            code: Left,
            mods: none,
        }],
    )
}

/// What: Create default news modal key bindings.
///
/// Inputs:
/// - `none`: Empty key modifiers
/// - `ctrl`: Control modifier
///
/// Output:
/// - Tuple of news modal key binding vectors
///
/// Details:
/// - Returns `news_mark_read` and `news_mark_all_read` key bindings.
fn default_news_keys(none: KeyModifiers, ctrl: KeyModifiers) -> (Vec<KeyChord>, Vec<KeyChord>) {
    use KeyCode::Char;
    (
        vec![KeyChord {
            code: Char('r'),
            mods: none,
        }],
        vec![KeyChord {
            code: Char('r'),
            mods: ctrl,
        }],
    )
}

/// What: Create default News Feed key bindings.
///
/// Inputs:
/// - `none`: Empty key modifiers
///
/// Output:
/// - Tuple of news feed key binding vectors
///
/// Details:
/// - Returns `news_mark_read_feed`, `news_mark_unread_feed`, and `news_toggle_read_feed`.
fn default_news_feed_keys(none: KeyModifiers) -> (Vec<KeyChord>, Vec<KeyChord>, Vec<KeyChord>) {
    use KeyCode::Char;
    (
        vec![KeyChord {
            code: Char('r'),
            mods: none,
        }],
        vec![KeyChord {
            code: Char('u'),
            mods: none,
        }],
        vec![KeyChord {
            code: Char('t'),
            mods: none,
        }],
    )
}

/// What: Build the default `KeyMap` by constructing it from helper functions.
///
/// Inputs:
/// - None (uses internal modifier constants).
///
/// Output:
/// - Returns a fully constructed `KeyMap` with all default key bindings.
///
/// Details:
/// - Consolidates all key binding construction to reduce data flow complexity.
/// - All key bindings are constructed inline within the struct initialization.
fn build_default_keymap() -> KeyMap {
    let none = KeyModifiers::empty();
    let ctrl = KeyModifiers::CONTROL;
    let shift = KeyModifiers::SHIFT;

    let global = default_global_keys(none, ctrl);
    let dropdown = default_dropdown_keys(shift);
    let search = default_search_keys(none);
    let search_normal = default_search_normal_keys(none, shift);
    let recent = default_recent_keys(none, shift);
    let install = default_install_keys(none, shift);
    let news = default_news_keys(none, ctrl);
    let news_feed = default_news_feed_keys(none);

    KeyMap {
        help_overlay: global.0,
        reload_config: global.1,
        exit: global.2,
        show_pkgbuild: global.3,
        comments_toggle: global.4,
        run_pkgbuild_checks: global.5,
        cycle_pkgbuild_sections: vec![KeyChord {
            code: KeyCode::Char('d'),
            mods: ctrl,
        }],
        change_sort: global.6,
        pane_next: global.7,
        pane_left: global.8,
        pane_right: global.9,
        config_menu_toggle: dropdown.0,
        options_menu_toggle: dropdown.1,
        panels_menu_toggle: dropdown.2,
        search_move_up: search.0,
        search_move_down: search.1,
        search_page_up: search.2,
        search_page_down: search.3,
        search_add: search.4,
        search_install: search.5,
        search_focus_left: search.6,
        search_focus_right: search.7,
        search_backspace: search.8,
        search_insert_clear: search.9,
        search_normal_toggle: search_normal.0,
        search_normal_insert: search_normal.1,
        search_normal_select_left: search_normal.2,
        search_normal_select_right: search_normal.3,
        search_normal_delete: search_normal.4,
        search_normal_clear: search_normal.5,
        search_normal_open_status: search_normal.6,
        search_normal_import: search_normal.7,
        search_normal_export: search_normal.8,
        search_normal_updates: search_normal.9,
        toggle_fuzzy: vec![KeyChord {
            code: KeyCode::Char('f'),
            mods: ctrl,
        }],
        recent_move_up: recent.0,
        recent_move_down: recent.1,
        recent_find: recent.2,
        recent_use: recent.3,
        recent_add: recent.4,
        recent_to_search: recent.5,
        recent_focus_right: recent.6,
        recent_remove: recent.7,
        recent_clear: recent.8,
        install_move_up: install.0,
        install_move_down: install.1,
        install_confirm: install.2,
        install_remove: install.3,
        install_clear: install.4,
        install_find: install.5,
        install_to_search: install.6,
        install_focus_left: install.7,
        news_mark_read: news.0,
        news_mark_all_read: news.1,
        news_mark_read_feed: news_feed.0,
        news_mark_unread_feed: news_feed.1,
        news_toggle_read_feed: news_feed.2,
    }
}

impl Default for KeyMap {
    /// What: Supply the default key bindings for Pacsea interactions.
    ///
    /// Inputs:
    /// - None.
    ///
    /// Output:
    /// - Returns a `KeyMap` prefilling chord vectors for global, search, recent, install, and news actions.
    ///
    /// Details:
    /// - Encodes human-friendly defaults such as `F1` for help and `Ctrl+R` to reload the configuration.
    /// - Provides multiple bindings for certain actions (e.g., `F1` and `?` for help).
    /// - Delegates to `build_default_keymap()` to reduce data flow complexity.
    fn default() -> Self {
        build_default_keymap()
    }
}