Skip to main content

orbital_scheduler/calendar/engine/
event_layout.rs

1//! Event positioning math for timed grid columns.
2
3use chrono::NaiveDate;
4use orbital_base_components::{DatetimeTimezone, OrbitalDateTime};
5
6use crate::PlannedEvent;
7
8/// Minutes in a calendar day for percentage layout.
9pub const MINUTES_PER_DAY: f64 = 1440.0;
10/// Minimum visible block height (~36 minutes).
11pub const MIN_EVENT_HEIGHT_PCT: f64 = 2.5;
12
13/// Percentage-based layout rect within a day column.
14#[derive(Clone, Copy, Debug, PartialEq)]
15pub struct EventLayoutRect {
16    pub top_pct: f64,
17    pub height_pct: f64,
18}
19
20fn rezone(dt: OrbitalDateTime, display_tz: DatetimeTimezone) -> OrbitalDateTime {
21    OrbitalDateTime::from_instant(dt.instant(), display_tz)
22}
23
24fn minutes_from_midnight(dt: OrbitalDateTime) -> Option<f64> {
25    let (h, m, s) = dt.hour_minute_second()?;
26    Some(h as f64 * 60.0 + m as f64 + s as f64 / 60.0)
27}
28
29fn day_bounds(
30    day: NaiveDate,
31    display_tz: DatetimeTimezone,
32) -> Option<(OrbitalDateTime, OrbitalDateTime)> {
33    let start = OrbitalDateTime::from_naive_date(day, display_tz)?;
34    let end = start.apply_hms(23, 59, 59)?;
35    Some((start, end))
36}
37
38/// Whether the event intersects the given calendar day in `display_tz`.
39pub fn event_overlaps_day(
40    event: &PlannedEvent,
41    day: NaiveDate,
42    display_tz: DatetimeTimezone,
43) -> bool {
44    event_layout_on_day(event, day, display_tz).is_some()
45}
46
47/// Wall-clock start/end in `display_tz`, clipped to `day`, as percentage rect.
48pub fn event_layout_on_day(
49    event: &PlannedEvent,
50    day: NaiveDate,
51    display_tz: DatetimeTimezone,
52) -> Option<EventLayoutRect> {
53    let start = rezone(event.start, display_tz);
54    let end = rezone(event.end, display_tz);
55    let (day_start, day_end) = day_bounds(day, display_tz)?;
56
57    if end <= day_start || start > day_end {
58        return None;
59    }
60
61    let clip_start = if start < day_start { day_start } else { start };
62    let clip_end = if end > day_end { day_end } else { end };
63
64    let start_minutes = minutes_from_midnight(clip_start)?;
65    let end_minutes = minutes_from_midnight(clip_end)?;
66    let duration = (end_minutes - start_minutes).max(0.0);
67
68    let mut top_pct = (start_minutes / MINUTES_PER_DAY) * 100.0;
69    let mut height_pct = (duration / MINUTES_PER_DAY * 100.0).max(MIN_EVENT_HEIGHT_PCT);
70
71    if top_pct + height_pct > 100.0 {
72        height_pct = (100.0 - top_pct).max(MIN_EVENT_HEIGHT_PCT);
73    }
74    if top_pct + height_pct > 100.0 {
75        top_pct = (100.0 - height_pct).max(0.0);
76    }
77
78    Some(EventLayoutRect {
79        top_pct,
80        height_pct,
81    })
82}
83
84#[cfg(test)]
85mod tests {
86    use super::*;
87    use orbital_base_components::TryFromUnixSeconds;
88
89    fn day_anchor() -> OrbitalDateTime {
90        OrbitalDateTime::try_from_unix_seconds(1_735_689_600_i64, DatetimeTimezone::Utc)
91            .expect("valid")
92            .start_of_day()
93    }
94
95    fn event_at(start_hms: (u32, u32, u32), end_hms: (u32, u32, u32)) -> PlannedEvent {
96        let base = day_anchor();
97        let start = base
98            .apply_hms(start_hms.0, start_hms.1, start_hms.2)
99            .expect("start");
100        let end = base
101            .apply_hms(end_hms.0, end_hms.1, end_hms.2)
102            .expect("end");
103        PlannedEvent::new("evt", "Test", start, end)
104    }
105
106    #[test]
107    fn nine_to_ten_am_layout() {
108        let event = event_at((9, 0, 0), (10, 0, 0));
109        let day = day_anchor().wall_date().unwrap();
110        let rect = event_layout_on_day(&event, day, DatetimeTimezone::Utc).expect("layout");
111        assert!((rect.top_pct - 37.5).abs() < 0.01);
112        assert!((rect.height_pct - (100.0 / 24.0)).abs() < 0.01);
113    }
114
115    #[test]
116    fn zero_duration_uses_min_height() {
117        let event = event_at((9, 0, 0), (9, 0, 0));
118        let day = day_anchor().wall_date().unwrap();
119        let rect = event_layout_on_day(&event, day, DatetimeTimezone::Utc).expect("layout");
120        assert!((rect.height_pct - MIN_EVENT_HEIGHT_PCT).abs() < 0.01);
121    }
122
123    #[test]
124    fn event_on_other_day_returns_none() {
125        let event = event_at((9, 0, 0), (10, 0, 0));
126        let day = day_anchor()
127            .wall_date()
128            .unwrap()
129            .checked_add_days(chrono::Days::new(3))
130            .unwrap();
131        assert!(event_layout_on_day(&event, day, DatetimeTimezone::Utc).is_none());
132    }
133}