kimun-notes 0.17.0

//! The **Drawer** — the single panel between the activity rail and the
//! editor. It renders whichever rail view is active: the file browser
//! (FILES), the Query panel (FIND), or a placeholder for the views that land
//! in later phases (TAGS, LINKS, OUTLINE, CFG).

use ratatui::Frame;
use ratatui::layout::Rect;
use ratatui::style::Style;
use ratatui::widgets::Paragraph;

use crate::components::Component;
use crate::components::backlinks_panel::QueryPanel;
use crate::components::drawer_views::{LinksPanel, OutlinePanel, TagsPanel};
use crate::components::event_state::EventState;
use crate::components::events::{AppTx, InputEvent};
use crate::components::panel::panel_block;
use crate::components::sidebar::SidebarComponent;
use crate::settings::themes::Theme;

/// The views the activity rail can put in the drawer. Closed set, mirrors
/// the rail items top to bottom.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum DrawerView {
    Files,
    Find,
    Tags,
    Links,
    Outline,
    Config,
}

impl DrawerView {
    /// Status-bar label when the drawer shows this view.
    pub fn label(&self) -> &'static str {
        match self {
            DrawerView::Files => "FILES",
            DrawerView::Find => "FIND",
            DrawerView::Tags => "TAGS",
            DrawerView::Links => "LINKS",
            DrawerView::Outline => "OUTLINE",
            DrawerView::Config => "CFG",
        }
    }
}

/// What the CFG drawer view displays — resolved by the host screen when the
/// view opens (the drawer itself holds no settings handle).
#[derive(Default, Clone)]
pub struct ConfigInfo {
    pub theme_name: String,
    pub leader_key: String,
    pub preferences_key: String,
    pub leader_timeout_ms: u64,
    pub config_path: String,
}

/// Hosts the drawer views. FILES and FIND are the ported existing panels
/// (file browser and Query panel); TAGS, LINKS, and OUTLINE are the
/// phase-03 panels; CFG is a placeholder until the settings drawer lands.
pub struct DrawerHost {
    active: DrawerView,
    sidebar: SidebarComponent,
    query: QueryPanel,
    tags: TagsPanel,
    links: LinksPanel,
    outline: OutlinePanel,
    /// CFG view contents, refreshed by the host when the view opens.
    config_info: ConfigInfo,
}

impl DrawerHost {
    pub fn new(
        sidebar: SidebarComponent,
        query: QueryPanel,
        tags: TagsPanel,
        links: LinksPanel,
        outline: OutlinePanel,
    ) -> Self {
        Self {
            active: DrawerView::Files,
            sidebar,
            query,
            tags,
            links,
            outline,
            config_info: ConfigInfo::default(),
        }
    }

    /// Refresh what the CFG view shows (called when the view opens).
    pub fn set_config_info(&mut self, info: ConfigInfo) {
        self.config_info = info;
    }

    pub fn active_view(&self) -> DrawerView {
        self.active
    }

    /// Whether the active view is a text-input context (drives the status
    /// bar's ⌨/≣ indicator). The surface owns this knowledge: FIND hosts a
    /// query input; the list views are filter-as-you-type lists, which read
    /// as lists (spec mockup shows them with ≣).
    pub fn is_text_input(&self) -> bool {
        matches!(self.active, DrawerView::Find)
    }

    pub fn set_view(&mut self, view: DrawerView) {
        self.active = view;
    }

    // ── Typed accessors for view-specific calls from the host screen ───────

    pub fn sidebar(&self) -> &SidebarComponent {
        &self.sidebar
    }
    pub fn sidebar_mut(&mut self) -> &mut SidebarComponent {
        &mut self.sidebar
    }
    pub fn query(&self) -> &QueryPanel {
        &self.query
    }
    pub fn query_mut(&mut self) -> &mut QueryPanel {
        &mut self.query
    }
    pub fn tags_mut(&mut self) -> &mut TagsPanel {
        &mut self.tags
    }
    pub fn links_mut(&mut self) -> &mut LinksPanel {
        &mut self.links
    }
    pub fn outline_mut(&mut self) -> &mut OutlinePanel {
        &mut self.outline
    }

    pub fn hint_shortcuts(&self) -> Vec<(String, String)> {
        match self.active {
            DrawerView::Files => self.sidebar.hint_shortcuts(),
            DrawerView::Find => self.query.hint_shortcuts(),
            DrawerView::Tags => self.tags.hint_shortcuts(),
            DrawerView::Links => self.links.hint_shortcuts(),
            DrawerView::Outline => self.outline.hint_shortcuts(),
            DrawerView::Config => vec![
                ("t/⏎".into(), "Theme picker".into()),
                ("p".into(), "Preferences".into()),
            ],
        }
    }

    pub fn handle_input(&mut self, event: &InputEvent, tx: &AppTx) -> EventState {
        match self.active {
            DrawerView::Files => self.sidebar.handle_input(event, tx),
            DrawerView::Find => {
                // The Query panel speaks `handle_key`; non-key events are not
                // delivered to it.
                if let InputEvent::Key(key) = event {
                    self.query.handle_key(key, tx)
                } else {
                    EventState::NotConsumed
                }
            }
            DrawerView::Tags => self.tags.handle_input(event, tx),
            DrawerView::Links => self.links.handle_input(event, tx),
            DrawerView::Outline => self.outline.handle_input(event, tx),
            DrawerView::Config => {
                if let InputEvent::Key(key) = event {
                    use ratatui::crossterm::event::KeyCode;
                    match key.code {
                        KeyCode::Char('t') | KeyCode::Enter => {
                            tx.send(crate::components::events::AppEvent::ExecuteLeaderAction(
                                crate::keys::leader::LeaderAction::VaultTheme,
                            ))
                            .ok();
                            return EventState::Consumed;
                        }
                        KeyCode::Char('p') => {
                            tx.send(crate::components::events::AppEvent::OpenScreen(
                                crate::components::events::ScreenEvent::OpenPreferences,
                            ))
                            .ok();
                            return EventState::Consumed;
                        }
                        _ => {}
                    }
                }
                EventState::NotConsumed
            }
        }
    }

    pub fn handle_mouse(&mut self, event: &InputEvent, tx: &AppTx) {
        let InputEvent::Mouse(mouse) = event else {
            return;
        };
        match self.active {
            // The Query panel has a dedicated mouse entry point; every other
            // view takes mouse events through its regular input path.
            DrawerView::Find => {
                self.query.handle_mouse(mouse, tx);
            }
            _ => {
                self.handle_input(event, tx);
            }
        }
    }

    pub fn render(&mut self, f: &mut Frame, rect: Rect, theme: &Theme, focused: bool) {
        match self.active {
            DrawerView::Files => self.sidebar.render(f, rect, theme, focused),
            DrawerView::Find => self.query.render(f, rect, theme, focused),
            DrawerView::Tags => self.tags.render(f, rect, theme, focused),
            DrawerView::Links => self.links.render(f, rect, theme, focused),
            DrawerView::Outline => self.outline.render(f, rect, theme, focused),
            DrawerView::Config => {
                let block = panel_block("Config", theme, focused);
                let inner = block.inner(rect);
                f.render_widget(block, rect);
                let info = &self.config_info;
                let label = Style::default().fg(theme.gray.to_ratatui());
                let value = Style::default().fg(theme.fg.to_ratatui());
                let keycap = Style::default().fg(theme.yellow.to_ratatui());
                let lines = vec![
                    ratatui::text::Line::from(vec![
                        ratatui::text::Span::styled(" theme    ", label),
                        ratatui::text::Span::styled(info.theme_name.clone(), value),
                    ]),
                    ratatui::text::Line::from(vec![
                        ratatui::text::Span::styled(" leader   ", label),
                        ratatui::text::Span::styled(info.leader_key.clone(), value),
                    ]),
                    ratatui::text::Line::from(vec![
                        ratatui::text::Span::styled(" prefs    ", label),
                        ratatui::text::Span::styled(info.preferences_key.clone(), value),
                    ]),
                    ratatui::text::Line::from(vec![
                        ratatui::text::Span::styled(" timeout  ", label),
                        ratatui::text::Span::styled(
                            format!("{} ms (which-key reveal)", info.leader_timeout_ms),
                            value,
                        ),
                    ]),
                    ratatui::text::Line::from(vec![
                        ratatui::text::Span::styled(" config   ", label),
                        ratatui::text::Span::styled(info.config_path.clone(), value),
                    ]),
                    ratatui::text::Line::default(),
                    ratatui::text::Line::from(vec![
                        ratatui::text::Span::styled(" t ", keycap),
                        ratatui::text::Span::styled("theme picker", label),
                    ]),
                    ratatui::text::Line::from(vec![
                        ratatui::text::Span::styled(" p ", keycap),
                        ratatui::text::Span::styled("preferences", label),
                    ]),
                ];
                f.render_widget(Paragraph::new(lines), inner);
            }
        }
    }
}