gravityfile-tui 0.2.4

//! Event handling for the TUI.

use crossterm::event::{KeyCode, KeyEvent, KeyModifiers, MouseButton, MouseEvent, MouseEventKind};

/// Key action that can be performed in the TUI.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum KeyAction {
    // Navigation
    MoveUp,
    MoveDown,
    MoveLeft,
    MoveRight,
    JumpToTop,
    JumpToBottom,
    PageUp,
    PageDown,

    // Tree operations
    #[allow(dead_code)]
    Expand,
    #[allow(dead_code)]
    Collapse,
    ToggleExpand,

    // Directory navigation
    DrillDown,
    NavigateBack,
    /// Open file with configured opener (Enter on file).
    #[allow(dead_code)]
    OpenFile,

    // Selection
    /// Toggle mark on current item (Space).
    ToggleMark,
    /// Enter visual selection mode (Shift+V).
    EnterVisual,
    /// Clear all marks.
    ClearMarks,

    // Clipboard operations (vim-style)
    /// Yank (copy) marked/current to clipboard.
    Yank,
    /// Cut (move) marked/current to clipboard.
    Cut,
    /// Paste from clipboard to current directory.
    Paste,

    // File operations
    /// Delete marked/current items (with confirmation).
    Delete,
    /// Rename current item.
    Rename,
    /// Create new file.
    CreateFile,
    /// Create new directory.
    CreateDirectory,
    /// Create directory and navigate into it (like zsh's `take`).
    Take,
    /// Undo last operation.
    Undo,

    // UI toggles
    ToggleDetails,
    ToggleHelp,
    ToggleTheme,
    /// Toggle between tree and miller layout.
    ToggleLayout,
    /// Cycle preview mode (auto/text/hex/metadata).
    CyclePreviewMode,
    /// Open settings modal.
    OpenSettings,

    // Other actions
    Refresh,
    Search,
    Sort,
    ReverseSort,
    CommandMode,
    /// Go to a specific directory (opens path input).
    GoTo,

    // Confirmation
    /// Explicit confirmation action (e.g. mapped from 'y' via dedicated confirm logic).
    #[allow(dead_code)]
    Confirm,
    Cancel,

    // View switching (for View enum: Explorer, Duplicates, Age, Errors)
    NextView,
    PrevView,

    // Bookmarks
    /// Set a bookmark (m<key>).
    SetBookmark,
    /// Jump to a bookmark ('<key>).
    JumpToBookmark,
    /// Show bookmark list modal.
    ShowBookmarkList,

    // Directory tabs (multiple directory contexts)
    /// Create a new directory tab.
    NewDirTab,
    /// Close the current directory tab.
    CloseDirTab,
    /// Switch to next directory tab.
    NextDirTab,
    /// Switch to previous directory tab.
    PrevDirTab,
    /// Switch to directory tab 1-9 (Alt+1 through Alt+9).
    DirTab(u8),

    // Application
    Quit,
    ForceQuit,

    // No action
    None,
}

/// Mouse action that can be performed in the TUI.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum MouseAction {
    /// Left click at a position.
    Click { x: u16, y: u16 },
    /// Double click at a position.
    /// Reserved for future double-click detection with timing logic.
    #[allow(dead_code)]
    DoubleClick { x: u16, y: u16 },
    /// Right click at a position.
    RightClick { x: u16, y: u16 },
    /// Scroll up at a position.
    ScrollUp { x: u16, y: u16 },
    /// Scroll down at a position.
    ScrollDown { x: u16, y: u16 },
    /// Drag started at a position.
    /// Reserved for future drag-and-drop support.
    #[allow(dead_code)]
    DragStart { x: u16, y: u16 },
    /// Drag continued to a position.
    DragTo { x: u16, y: u16 },
    /// Drag ended.
    DragEnd,
    /// No action.
    None,
}

impl MouseAction {
    /// Convert a mouse event to an action.
    pub fn from_mouse_event(event: MouseEvent) -> Self {
        let x = event.column;
        let y = event.row;

        match event.kind {
            MouseEventKind::Down(MouseButton::Left) => MouseAction::Click { x, y },
            MouseEventKind::Down(MouseButton::Right) => MouseAction::RightClick { x, y },
            MouseEventKind::Up(_) => MouseAction::DragEnd,
            MouseEventKind::Drag(MouseButton::Left) => MouseAction::DragTo { x, y },
            MouseEventKind::ScrollUp => MouseAction::ScrollUp { x, y },
            MouseEventKind::ScrollDown => MouseAction::ScrollDown { x, y },
            _ => MouseAction::None,
        }
    }
}

impl KeyAction {
    /// Convert a key event to an action.
    pub fn from_key_event(event: KeyEvent) -> Self {
        match (event.code, event.modifiers) {
            // Quit - only 'q' quits, Esc is for clearing selection/clipboard
            (KeyCode::Char('q'), KeyModifiers::NONE) => KeyAction::Quit,
            (KeyCode::Char('c'), KeyModifiers::CONTROL) => KeyAction::ForceQuit,

            // Cancel/Clear - Esc clears selection, clipboard, or closes dialogs
            (KeyCode::Esc, _) => KeyAction::Cancel,

            // Navigation - vim style
            (KeyCode::Char('j'), KeyModifiers::NONE) => KeyAction::MoveDown,
            (KeyCode::Char('k'), KeyModifiers::NONE) => KeyAction::MoveUp,
            (KeyCode::Char('h'), KeyModifiers::NONE) => KeyAction::MoveLeft,
            (KeyCode::Char('l'), KeyModifiers::NONE) => KeyAction::MoveRight,

            // Navigation - arrow keys (without modifiers; Ctrl+arrows for tabs)
            (KeyCode::Down, KeyModifiers::NONE) => KeyAction::MoveDown,
            (KeyCode::Up, KeyModifiers::NONE) => KeyAction::MoveUp,
            (KeyCode::Left, KeyModifiers::NONE) => KeyAction::MoveLeft,
            (KeyCode::Right, KeyModifiers::NONE) => KeyAction::MoveRight,

            // Jump
            (KeyCode::Char('g'), KeyModifiers::NONE) => KeyAction::JumpToTop,
            (KeyCode::Char('G'), KeyModifiers::SHIFT) => KeyAction::JumpToBottom,
            (KeyCode::Home, _) => KeyAction::JumpToTop,
            (KeyCode::End, _) => KeyAction::JumpToBottom,

            // Page navigation
            (KeyCode::PageUp, _) => KeyAction::PageUp,
            (KeyCode::PageDown, _) => KeyAction::PageDown,
            (KeyCode::Char('u'), KeyModifiers::CONTROL) => KeyAction::PageUp,
            (KeyCode::Char('d'), KeyModifiers::CONTROL) => KeyAction::PageDown,

            // Selection and marking
            (KeyCode::Char(' '), KeyModifiers::NONE) => KeyAction::ToggleMark,
            (KeyCode::Char('V'), KeyModifiers::SHIFT) => KeyAction::EnterVisual,
            (KeyCode::Char('u'), KeyModifiers::NONE) => KeyAction::ClearMarks,

            // Tree expand/collapse with 'o'
            (KeyCode::Char('o'), KeyModifiers::NONE) => KeyAction::ToggleExpand,

            // Clipboard operations (vim-style)
            (KeyCode::Char('y'), KeyModifiers::NONE) => KeyAction::Yank,
            (KeyCode::Char('x'), KeyModifiers::NONE) => KeyAction::Cut,
            (KeyCode::Char('p'), KeyModifiers::NONE) => KeyAction::Paste,

            // File operations
            (KeyCode::Char('d'), KeyModifiers::NONE) => KeyAction::Delete,
            (KeyCode::Char('D'), KeyModifiers::SHIFT) => KeyAction::Delete,
            (KeyCode::Delete, _) => KeyAction::Delete,
            (KeyCode::Char('r'), KeyModifiers::NONE) => KeyAction::Rename,
            (KeyCode::Char('a'), KeyModifiers::NONE) => KeyAction::CreateFile,
            (KeyCode::Char('A'), KeyModifiers::SHIFT) => KeyAction::CreateDirectory,
            (KeyCode::Char('T'), KeyModifiers::SHIFT) => KeyAction::Take,

            // Undo
            (KeyCode::Char('z'), KeyModifiers::CONTROL) => KeyAction::Undo,

            // UI toggles
            (KeyCode::Char('i'), KeyModifiers::NONE) => KeyAction::ToggleDetails,
            (KeyCode::Char('?'), KeyModifiers::NONE) => KeyAction::ToggleHelp,
            (KeyCode::Char('t'), KeyModifiers::NONE) => KeyAction::ToggleTheme,
            (KeyCode::Char('P'), KeyModifiers::SHIFT) => KeyAction::CyclePreviewMode,
            (KeyCode::Char('v'), KeyModifiers::NONE) => KeyAction::ToggleLayout,
            (KeyCode::Char(','), KeyModifiers::NONE) => KeyAction::OpenSettings,

            // Refresh (Shift-R since r is rename)
            (KeyCode::Char('R'), KeyModifiers::SHIFT) => KeyAction::Refresh,

            // Search and sort
            (KeyCode::Char('/'), KeyModifiers::NONE) => KeyAction::Search,
            (KeyCode::Char('s'), KeyModifiers::NONE) => KeyAction::Sort,
            (KeyCode::Char('S'), KeyModifiers::SHIFT) => KeyAction::ReverseSort,

            // Directory navigation
            (KeyCode::Enter, _) => KeyAction::DrillDown,
            (KeyCode::Backspace, _) => KeyAction::NavigateBack,
            (KeyCode::Char('-'), KeyModifiers::NONE) => KeyAction::NavigateBack,

            // Command palette
            (KeyCode::Char(':'), KeyModifiers::NONE) => KeyAction::CommandMode,
            (KeyCode::Char(':'), KeyModifiers::SHIFT) => KeyAction::CommandMode,

            // Go to directory
            (KeyCode::Char('g'), KeyModifiers::CONTROL) => KeyAction::GoTo,

            // Bookmarks
            (KeyCode::Char('m'), KeyModifiers::NONE) => KeyAction::SetBookmark,
            (KeyCode::Char('\''), KeyModifiers::NONE) => KeyAction::JumpToBookmark,
            (KeyCode::Char('`'), KeyModifiers::NONE) => KeyAction::JumpToBookmark,
            (KeyCode::Char('B'), KeyModifiers::SHIFT) => KeyAction::ShowBookmarkList,

            // Confirmation (for dialogs)
            (KeyCode::Char('n'), KeyModifiers::NONE) => KeyAction::Cancel,
            // ClearMarks available via Escape when items are marked, or :clear command

            // View switching (Explorer, Duplicates, Age, Errors)
            (KeyCode::Tab, KeyModifiers::NONE) => KeyAction::NextView,
            (KeyCode::BackTab, _) => KeyAction::PrevView,

            // Directory tabs
            (KeyCode::Char('t'), KeyModifiers::CONTROL) => KeyAction::NewDirTab,
            (KeyCode::Char('w'), KeyModifiers::CONTROL) => KeyAction::CloseDirTab,
            (KeyCode::Char(']'), KeyModifiers::NONE) => KeyAction::NextDirTab,
            (KeyCode::Char('['), KeyModifiers::NONE) => KeyAction::PrevDirTab,
            // Direct tab switching: 1-9 keys (only when multiple tabs exist)
            (KeyCode::Char('1'), KeyModifiers::NONE) => KeyAction::DirTab(1),
            (KeyCode::Char('2'), KeyModifiers::NONE) => KeyAction::DirTab(2),
            (KeyCode::Char('3'), KeyModifiers::NONE) => KeyAction::DirTab(3),
            (KeyCode::Char('4'), KeyModifiers::NONE) => KeyAction::DirTab(4),
            (KeyCode::Char('5'), KeyModifiers::NONE) => KeyAction::DirTab(5),
            (KeyCode::Char('6'), KeyModifiers::NONE) => KeyAction::DirTab(6),
            (KeyCode::Char('7'), KeyModifiers::NONE) => KeyAction::DirTab(7),
            (KeyCode::Char('8'), KeyModifiers::NONE) => KeyAction::DirTab(8),
            (KeyCode::Char('9'), KeyModifiers::NONE) => KeyAction::DirTab(9),

            _ => KeyAction::None,
        }
    }
}

/// A section of key bindings for the help display.
pub struct HelpSection {
    pub title: &'static str,
    pub bindings: Vec<KeyBinding>,
}

/// Key binding for display in help.
pub struct KeyBinding {
    pub keys: &'static str,
    pub description: &'static str,
}

/// Get all key bindings organized by section for help display.
pub fn get_help_sections() -> Vec<HelpSection> {
    vec![
        HelpSection {
            title: "Navigation",
            bindings: vec![
                KeyBinding {
                    keys: "j/k ↑/↓",
                    description: "Move up/down",
                },
                KeyBinding {
                    keys: "h/l ←/→",
                    description: "Collapse/expand",
                },
                KeyBinding {
                    keys: "Enter",
                    description: "Drill into directory",
                },
                KeyBinding {
                    keys: "Backspace/-",
                    description: "Navigate back",
                },
                KeyBinding {
                    keys: "g/G",
                    description: "Jump to top/bottom",
                },
                KeyBinding {
                    keys: "Ctrl-u/d",
                    description: "Page up/down",
                },
                KeyBinding {
                    keys: "Ctrl-g",
                    description: "Go to directory",
                },
                KeyBinding {
                    keys: "o",
                    description: "Toggle expand node",
                },
            ],
        },
        HelpSection {
            title: "Selection & Clipboard",
            bindings: vec![
                KeyBinding {
                    keys: "Space",
                    description: "Mark item for multi-select",
                },
                KeyBinding {
                    keys: "y",
                    description: "Yank (copy) to clipboard",
                },
                KeyBinding {
                    keys: "x",
                    description: "Cut to clipboard",
                },
                KeyBinding {
                    keys: "p",
                    description: "Paste from clipboard",
                },
                KeyBinding {
                    keys: "Esc",
                    description: "Clear clipboard/marks",
                },
            ],
        },
        HelpSection {
            title: "File Operations",
            bindings: vec![
                KeyBinding {
                    keys: "d/Del",
                    description: "Delete item(s)",
                },
                KeyBinding {
                    keys: "r",
                    description: "Rename",
                },
                KeyBinding {
                    keys: "a",
                    description: "Create file (touch)",
                },
                KeyBinding {
                    keys: "A",
                    description: "Create directory (mkdir)",
                },
                KeyBinding {
                    keys: "T",
                    description: "Take (mkdir + cd)",
                },
                KeyBinding {
                    keys: "Ctrl-z",
                    description: "Undo",
                },
            ],
        },
        HelpSection {
            title: "Views & Display",
            bindings: vec![
                KeyBinding {
                    keys: "Tab/S-Tab",
                    description: "Switch view (Explorer/Dups/Age)",
                },
                KeyBinding {
                    keys: "v",
                    description: "Toggle Tree/Miller",
                },
                KeyBinding {
                    keys: "s",
                    description: "Cycle sort mode",
                },
                KeyBinding {
                    keys: "S",
                    description: "Reverse sort order",
                },
                KeyBinding {
                    keys: "i",
                    description: "Toggle details panel",
                },
                KeyBinding {
                    keys: "t",
                    description: "Toggle dark/light theme",
                },
                KeyBinding {
                    keys: "R",
                    description: "Refresh/rescan",
                },
            ],
        },
        HelpSection {
            title: "Duplicates View",
            bindings: vec![
                KeyBinding {
                    keys: "j/k",
                    description: "Navigate groups/files",
                },
                KeyBinding {
                    keys: "h/l",
                    description: "Collapse/expand group",
                },
                KeyBinding {
                    keys: "d (on group)",
                    description: "Mark all duplicates (keeps 1st)",
                },
                KeyBinding {
                    keys: "d (on file)",
                    description: "Mark single file for deletion",
                },
                KeyBinding {
                    keys: "Space (group)",
                    description: "Select/deselect all in group",
                },
                KeyBinding {
                    keys: "Space (file)",
                    description: "Toggle single file selection",
                },
            ],
        },
        HelpSection {
            title: "Bookmarks",
            bindings: vec![
                KeyBinding {
                    keys: "m<key>",
                    description: "Set bookmark",
                },
                KeyBinding {
                    keys: "'<key>",
                    description: "Jump to bookmark",
                },
                KeyBinding {
                    keys: "B",
                    description: "Show bookmark list",
                },
            ],
        },
        HelpSection {
            title: "Mouse",
            bindings: vec![
                KeyBinding {
                    keys: "Click",
                    description: "Select item",
                },
                KeyBinding {
                    keys: "Double-click",
                    description: "Enter directory",
                },
                KeyBinding {
                    keys: "Right-click",
                    description: "Toggle mark",
                },
                KeyBinding {
                    keys: "Scroll",
                    description: "Move up/down",
                },
            ],
        },
        HelpSection {
            title: "Directory Tabs",
            bindings: vec![
                KeyBinding {
                    keys: "Ctrl-t",
                    description: "New tab (current dir)",
                },
                KeyBinding {
                    keys: "Ctrl-w",
                    description: "Close current tab",
                },
                KeyBinding {
                    keys: "]/[",
                    description: "Next/prev tab",
                },
                KeyBinding {
                    keys: "1-9",
                    description: "Jump to tab N",
                },
            ],
        },
        HelpSection {
            title: "Commands",
            bindings: vec![
                KeyBinding {
                    keys: ":",
                    description: "Open command palette",
                },
                KeyBinding {
                    keys: ",",
                    description: "Open settings",
                },
                KeyBinding {
                    keys: "?",
                    description: "Show this help",
                },
                KeyBinding {
                    keys: "q",
                    description: "Quit",
                },
            ],
        },
    ]
}

/// Get command palette commands for help display.
pub fn get_command_help() -> Vec<(&'static str, &'static str)> {
    vec![
        (":q :quit", "Quit application"),
        (":cd <path>", "Change directory"),
        (":touch <name>", "Create file"),
        (":mkdir <name>", "Create directory"),
        (":take <name>", "Create dir and cd into it"),
        (":yank :y", "Copy to clipboard"),
        (":cut :x", "Cut to clipboard"),
        (":paste :p", "Paste from clipboard"),
        (":delete :rm", "Delete marked items"),
        (":rename <name>", "Rename current item"),
        (":rename-bulk :brn", "Bulk rename marked items"),
        (":clear", "Clear all marks"),
        (":theme dark|light", "Set theme"),
        (":layout tree|miller", "Set layout"),
        (":sort <mode>", "Set sort (size/name/date/count)"),
        (":bookmark [key]", "Set bookmark (or list all)"),
        (":bookmarks", "Show bookmark list"),
        (":delmark <key>", "Delete a bookmark"),
        (":help", "Show help"),
    ]
}

/// Get all key bindings as a flat list (for backwards compatibility).
#[allow(dead_code)]
pub fn get_key_bindings() -> Vec<KeyBinding> {
    get_help_sections()
        .into_iter()
        .flat_map(|s| s.bindings)
        .collect()
}