oxicode-vtui 0.68.0

Terminal UI framework for oxicode, based on vtcode-ui
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

//! Layout configuration — appearance settings that drive the pane geometry.
//!
//! Pure data — the actual geometry computation lives in
//! [`super::agent::AgentViewLayout::compute`].

/// Horizontal + vertical padding configuration for the agent view.
///
/// All values are in terminal cells.  The `eff_*` methods fold in the compact
/// flag so callers pass one boolean instead of replicating the conditional
/// everywhere.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct LayoutConfig {
    /// Left horizontal padding (normal mode).
    pub hpad_left: u16,
    /// Right horizontal padding (normal mode).
    pub hpad_right: u16,
    /// Left horizontal padding (compact mode).
    pub hpad_left_compact: u16,
    /// Right horizontal padding (compact mode).
    pub hpad_right_compact: u16,
    /// Outer vertical padding (normal mode).
    pub outer_vpad: u16,
    /// Outer vertical padding (compact mode — usually 0).
    pub outer_vpad_compact: u16,
}

impl Default for LayoutConfig {
    fn default() -> Self {
        Self {
            hpad_left: 2,
            hpad_right: 2,
            hpad_left_compact: 1,
            hpad_right_compact: 1,
            outer_vpad: 1,
            outer_vpad_compact: 0,
        }
    }
}

impl LayoutConfig {
    /// Effective left horizontal padding given the compact flag.
    #[must_use]
    pub fn eff_hpad_left(&self, compact: bool) -> u16 {
        if compact {
            self.hpad_left_compact
        } else {
            self.hpad_left
        }
    }

    /// Effective right horizontal padding given the compact flag.
    #[must_use]
    pub fn eff_hpad_right(&self, compact: bool) -> u16 {
        if compact {
            self.hpad_right_compact
        } else {
            self.hpad_right
        }
    }

    /// Effective outer vertical padding given the compact flag.
    #[must_use]
    pub fn eff_outer_vpad(&self, compact: bool) -> u16 {
        if compact {
            self.outer_vpad_compact
        } else {
            self.outer_vpad
        }
    }
}

/// Scrollbar appearance configuration.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct ScrollbarConfig {
    /// Whether the scrollbar is enabled.
    pub enabled: bool,
    /// Columns of gap between the scrollbar and content (left side).
    pub gap_left: u16,
    /// Columns of gap between the scrollbar and the screen edge (right side).
    pub gap_right: u16,
}

impl Default for ScrollbarConfig {
    fn default() -> Self {
        Self {
            enabled: true,
            gap_left: 1,
            gap_right: 1,
        }
    }
}