term39 1.5.1

A modern, retro-styled terminal multiplexer with a classic MS-DOS aesthetic
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

//! Widget system for the top bar
//!
//! This module provides a widget-based architecture for the top bar,
//! allowing modular and reusable UI components.

use crate::rendering::{Charset, Theme, VideoBuffer};
use crate::window::manager::FocusState;

pub mod battery;
pub mod datetime;
pub mod network;
pub mod new_term;
pub mod system_menu;
pub mod topbar;

// Re-export main types
pub use battery::BatteryWidget;
pub use datetime::DateTimeWidget;
pub use network::NetworkWidget;
pub use new_term::NewTermWidget;
pub use system_menu::SystemMenuWidget;
pub use topbar::TopBar;

/// Result from widget click handling
#[derive(Debug, Clone)]
pub enum WidgetClickResult {
    /// Click was not handled by this widget
    NotHandled,
    /// Widget requests opening calendar
    OpenCalendar,
    /// Widget requests creating new terminal
    CreateTerminal,
    /// Widget requests toggling System menu
    ToggleSystemMenu,
}

/// Alignment of widget within its container
#[derive(Clone, Copy, Debug, PartialEq)]
pub enum WidgetAlignment {
    Left,
    Center,
    Right,
}

/// Context passed to widgets for rendering and updates
#[derive(Clone, Copy, Debug)]
pub struct WidgetContext<'a> {
    pub cols: u16,
    #[allow(dead_code)]
    pub rows: u16,
    pub focus: FocusState,
    #[allow(dead_code)]
    pub has_clipboard_content: bool,
    #[allow(dead_code)]
    pub has_selection: bool,
    pub show_date_in_clock: bool,
    pub charset: &'a Charset,
}

impl<'a> WidgetContext<'a> {
    pub fn new(
        cols: u16,
        rows: u16,
        focus: FocusState,
        has_clipboard_content: bool,
        has_selection: bool,
        show_date_in_clock: bool,
        charset: &'a Charset,
    ) -> Self {
        Self {
            cols,
            rows,
            focus,
            has_clipboard_content,
            has_selection,
            show_date_in_clock,
            charset,
        }
    }
}

/// Core Widget trait that all topbar widgets implement
pub trait Widget {
    /// Return the widget's display width in characters
    fn width(&self) -> u16;

    /// Render the widget at the given x position (y is always 0 for topbar)
    fn render(&self, buffer: &mut VideoBuffer, x: u16, theme: &Theme, ctx: &WidgetContext);

    /// Check if the widget should be visible given current context
    fn is_visible(&self, ctx: &WidgetContext) -> bool;

    /// Check if point (x, y) is within widget bounds
    fn contains(&self, point_x: u16, point_y: u16, widget_x: u16) -> bool;

    /// Handle mouse hover - update internal hover state
    fn update_hover(&mut self, mouse_x: u16, mouse_y: u16, widget_x: u16);

    /// Handle mouse click - returns result indicating action to take
    fn handle_click(&mut self, mouse_x: u16, mouse_y: u16, widget_x: u16) -> WidgetClickResult;

    /// Reset all hover/pressed states to normal
    fn reset_state(&mut self);

    /// Update widget state based on context (e.g., button enabled states)
    fn update(&mut self, ctx: &WidgetContext);

    /// Get widget alignment preference
    #[allow(dead_code)]
    fn alignment(&self) -> WidgetAlignment;
}