codewhale-tui 0.9.8

Terminal UI for open-source and open-weight coding models
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

//! Responsive list/detail geometry for settings pickers.
//!
//! Wide terminals place the option list beside a detail pane. Narrow terminals
//! stack (or, when the focused option prefers it, keep the list alone).

use ratatui::layout::Rect;

use crate::tui::views::ListDetailLayout;

use super::option::SettingOption;

/// Resolved panes for one settings-picker frame.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct SettingsPickerLayout {
    pub list: Rect,
    pub detail: Option<Rect>,
    pub stacked: bool,
    pub narrow: bool,
}

impl SettingsPickerLayout {
    /// Split `area` using the shared list/detail contract, then optionally
    /// collapse the detail pane when the focused option prefers list-only
    /// narrow fallback.
    #[must_use]
    pub fn resolve(area: Rect, min_detail_width: u16, focused: Option<&SettingOption>) -> Self {
        if area.width == 0 || area.height == 0 {
            return Self {
                list: area,
                detail: None,
                stacked: true,
                narrow: true,
            };
        }

        let base = ListDetailLayout::split(area, min_detail_width);
        let narrow = base.stacked || area.width < 96;
        let prefer_list = focused.is_some_and(|option| option.prefer_list_when_narrow);

        if narrow && prefer_list {
            return Self {
                list: area,
                detail: None,
                stacked: true,
                narrow: true,
            };
        }

        Self {
            list: base.list,
            detail: Some(base.detail),
            stacked: base.stacked,
            narrow,
        }
    }
}