romm_cli/tui/screens/
search.rs

1use ratatui::layout::{Constraint, Layout, Rect};
2use ratatui::style::{Color, Style};
3use ratatui::widgets::{Block, Borders, Cell, Paragraph, Row, Table};
4use ratatui::Frame;
5
6use crate::core::utils::{self, RomGroup};
7use crate::types::{Rom, RomList};
8
9/// Full-text search screen over ROMs, with grouped results.
10pub struct SearchScreen {
11    pub query: String,
12    pub cursor_pos: usize,
13    pub results: Option<RomList>,
14    /// One row per game name (base + updates/DLC grouped).
15    pub result_groups: Option<Vec<RomGroup>>,
16    /// Query string used for the API call that produced [`Self::result_groups`], if any.
17    pub last_searched_query: Option<String>,
18    pub selected: usize,
19    pub scroll_offset: usize,
20    visible_rows: usize,
21    pub loading: bool,
22}
23
24impl Default for SearchScreen {
25    fn default() -> Self {
26        Self::new()
27    }
28}
29
30impl SearchScreen {
31    pub fn new() -> Self {
32        Self {
33            query: String::new(),
34            cursor_pos: 0,
35            results: None,
36            result_groups: None,
37            last_searched_query: None,
38            selected: 0,
39            scroll_offset: 0,
40            visible_rows: 15,
41            loading: false,
42        }
43    }
44
45    pub fn add_char(&mut self, c: char) {
46        let pos = self.cursor_pos.min(self.query.len());
47        self.query.insert(pos, c);
48        self.cursor_pos = pos + 1;
49    }
50
51    pub fn delete_char(&mut self) {
52        if self.cursor_pos > 0 && self.cursor_pos <= self.query.len() {
53            self.query.remove(self.cursor_pos - 1);
54            self.cursor_pos -= 1;
55        }
56    }
57
58    pub fn cursor_left(&mut self) {
59        if self.cursor_pos > 0 {
60            self.cursor_pos -= 1;
61        }
62    }
63
64    pub fn cursor_right(&mut self) {
65        if self.cursor_pos < self.query.len() {
66            self.cursor_pos += 1;
67        }
68    }
69
70    pub fn set_results(&mut self, results: RomList) {
71        self.results = Some(results.clone());
72        self.result_groups = Some(utils::group_roms_by_name(&results.items));
73        self.last_searched_query = Some(self.query.clone());
74        self.selected = 0;
75        self.scroll_offset = 0;
76    }
77
78    pub fn clear_results(&mut self) {
79        self.results = None;
80        self.result_groups = None;
81        self.last_searched_query = None;
82    }
83
84    /// True when the on-screen results were fetched for the current `query` string.
85    pub fn results_match_current_query(&self) -> bool {
86        self.last_searched_query.as_deref() == Some(self.query.as_str())
87    }
88
89    pub fn next(&mut self) {
90        if let Some(ref g) = self.result_groups {
91            if !g.is_empty() {
92                self.selected = (self.selected + 1) % g.len();
93                self.update_scroll(self.visible_rows);
94            }
95        }
96    }
97
98    pub fn previous(&mut self) {
99        if let Some(ref g) = self.result_groups {
100            if !g.is_empty() {
101                self.selected = if self.selected == 0 {
102                    g.len() - 1
103                } else {
104                    self.selected - 1
105                };
106                self.update_scroll(self.visible_rows);
107            }
108        }
109    }
110
111    fn update_scroll(&mut self, visible: usize) {
112        if let Some(ref g) = self.result_groups {
113            let visible = visible.max(1);
114            let max_scroll = g.len().saturating_sub(visible);
115            if self.selected >= self.scroll_offset + visible {
116                self.scroll_offset = (self.selected + 1).saturating_sub(visible);
117            } else if self.selected < self.scroll_offset {
118                self.scroll_offset = self.selected;
119            }
120            self.scroll_offset = self.scroll_offset.min(max_scroll);
121        }
122    }
123
124    /// Primary ROM and other files (updates/DLC) for the selected game.
125    pub fn get_selected_group(&self) -> Option<(Rom, Vec<Rom>)> {
126        self.result_groups
127            .as_ref()
128            .and_then(|g| g.get(self.selected))
129            .map(|g| (g.primary.clone(), g.others.clone()))
130    }
131
132    pub fn render(&mut self, f: &mut Frame, area: Rect) {
133        let chunks = Layout::default()
134            .constraints([
135                Constraint::Length(3),
136                Constraint::Min(5),
137                Constraint::Length(3),
138            ])
139            .direction(ratatui::layout::Direction::Vertical)
140            .split(area);
141
142        let input_line = format!("Search: {}", self.query);
143        let input = Paragraph::new(input_line)
144            .block(Block::default().title("Search games").borders(Borders::ALL));
145        f.render_widget(input, chunks[0]);
146
147        if self.result_groups.is_some() {
148            let visible = (chunks[1].height as usize).saturating_sub(3).max(1);
149            // Keep selection and viewport aligned with the current terminal size.
150            self.visible_rows = visible;
151            self.update_scroll(visible);
152            let Some(groups) = self.result_groups.as_ref() else {
153                return;
154            };
155            let start = self.scroll_offset.min(groups.len().saturating_sub(visible));
156            let end = (start + visible).min(groups.len());
157            let visible_groups = &groups[start..end];
158
159            let header = Row::new(vec![
160                Cell::from("Name").style(Style::default().fg(Color::Cyan)),
161                Cell::from("Platform").style(Style::default().fg(Color::Cyan)),
162            ]);
163            let rows: Vec<Row> = visible_groups
164                .iter()
165                .enumerate()
166                .map(|(i, g)| {
167                    let global_idx = start + i;
168                    let platform = g
169                        .primary
170                        .platform_display_name
171                        .as_deref()
172                        .or(g.primary.platform_custom_name.as_deref())
173                        .unwrap_or("—");
174                    let style = if global_idx == self.selected {
175                        Style::default().fg(Color::Yellow)
176                    } else {
177                        Style::default()
178                    };
179                    Row::new(vec![
180                        Cell::from(g.name.as_str()).style(style),
181                        Cell::from(platform).style(style),
182                    ])
183                    .height(1)
184                })
185                .collect();
186
187            let total_files = self.results.as_ref().map(|r| r.items.len()).unwrap_or(0);
188            let widths = [Constraint::Percentage(60), Constraint::Percentage(40)];
189            let title = if self.loading {
190                format!(
191                    "Results ({}) — {} files [Loading...]",
192                    groups.len(),
193                    total_files
194                )
195            } else {
196                format!("Results ({}) — {} files", groups.len(), total_files)
197            };
198            let table = Table::new(rows, widths)
199                .header(header)
200                .block(Block::default().title(title).borders(Borders::ALL));
201            f.render_widget(table, chunks[1]);
202        } else {
203            let msg = if self.loading {
204                "Searching..."
205            } else {
206                "Type a search term and press Enter to search"
207            };
208            let p =
209                Paragraph::new(msg).block(Block::default().title("Results").borders(Borders::ALL));
210            f.render_widget(p, chunks[1]);
211        }
212
213        let help = "Enter: Search (or open game if query unchanged) | ↑↓: Navigate | Esc: Back";
214        let p = Paragraph::new(help).block(Block::default().borders(Borders::ALL));
215        f.render_widget(p, chunks[2]);
216    }
217
218    pub fn cursor_position(&self, area: Rect) -> Option<(u16, u16)> {
219        let chunks = Layout::default()
220            .constraints([
221                Constraint::Length(3),
222                Constraint::Min(5),
223                Constraint::Length(3),
224            ])
225            .direction(ratatui::layout::Direction::Vertical)
226            .split(area);
227        let offset = 9 + self.cursor_pos.min(self.query.len()) as u16;
228        let x = chunks[0].x + offset.min(chunks[0].width.saturating_sub(1));
229        let y = chunks[0].y + 1;
230        Some((x, y))
231    }
232}
233
234#[cfg(test)]
235mod tests {
236    use super::SearchScreen;
237    use crate::types::RomList;
238
239    fn empty_list() -> RomList {
240        RomList {
241            items: vec![],
242            total: 0,
243            limit: 50,
244            offset: 0,
245        }
246    }
247
248    #[test]
249    fn set_results_records_last_searched_query() {
250        let mut s = SearchScreen::new();
251        s.query = "mario".to_string();
252        s.set_results(empty_list());
253        assert_eq!(s.last_searched_query.as_deref(), Some("mario"));
254        assert!(s.results_match_current_query());
255    }
256
257    #[test]
258    fn editing_query_after_search_marks_stale() {
259        let mut s = SearchScreen::new();
260        s.query = "mario".to_string();
261        s.cursor_pos = s.query.len();
262        s.set_results(empty_list());
263        assert!(s.results_match_current_query());
264        s.delete_char();
265        assert_eq!(s.query, "mari");
266        assert!(!s.results_match_current_query());
267    }
268
269    #[test]
270    fn clear_results_clears_last_searched_query() {
271        let mut s = SearchScreen::new();
272        s.query = "a".to_string();
273        s.set_results(empty_list());
274        s.clear_results();
275        assert!(s.last_searched_query.is_none());
276    }
277}
romm_cli/tui/screens/search.rs

romm_cli/tui/screens/
search.rs
