Skip to main content

orbital_scheduler/shared/
preferences.rs

1//! Scheduler display preferences (SC-14, SC-27).
2
3use leptos::prelude::*;
4
5/// Week start day: `0` = Sunday, `1` = Monday.
6pub const WEEK_STARTS_SUNDAY: u8 = 0;
7pub const WEEK_STARTS_MONDAY: u8 = 1;
8
9/// User-facing scheduler display preferences.
10#[derive(Clone, Copy, Debug, PartialEq)]
11pub struct SchedulerPreferences {
12    pub show_weekends: RwSignal<bool>,
13    pub ampm: RwSignal<bool>,
14    pub week_starts_on: RwSignal<u8>,
15}
16
17/// Plain snapshot for persistence callbacks.
18#[derive(Clone, Debug, PartialEq, Eq)]
19pub struct SchedulerPreferencesSnapshot {
20    pub show_weekends: bool,
21    pub ampm: bool,
22    pub week_starts_on: u8,
23}
24
25/// Week grid layout inputs derived from preferences.
26#[derive(Clone, Copy, Debug, PartialEq, Eq)]
27pub struct WeekLayoutPrefs {
28    pub week_starts_on: u8,
29    pub show_weekends: bool,
30}
31
32impl Default for WeekLayoutPrefs {
33    fn default() -> Self {
34        Self {
35            week_starts_on: WEEK_STARTS_SUNDAY,
36            show_weekends: true,
37        }
38    }
39}
40
41impl SchedulerPreferences {
42    pub fn snapshot(&self) -> SchedulerPreferencesSnapshot {
43        SchedulerPreferencesSnapshot {
44            show_weekends: self.show_weekends.get_untracked(),
45            ampm: self.ampm.get_untracked(),
46            week_starts_on: self.week_starts_on.get_untracked(),
47        }
48    }
49
50    pub fn try_snapshot(&self) -> Option<SchedulerPreferencesSnapshot> {
51        Some(SchedulerPreferencesSnapshot {
52            show_weekends: self.show_weekends.try_get()?,
53            ampm: self.ampm.try_get()?,
54            week_starts_on: self.week_starts_on.try_get()?,
55        })
56    }
57
58    pub fn week_layout(&self) -> WeekLayoutPrefs {
59        WeekLayoutPrefs {
60            week_starts_on: self.week_starts_on.get_untracked(),
61            show_weekends: self.show_weekends.get_untracked(),
62        }
63    }
64
65    pub fn try_week_layout(&self) -> Option<WeekLayoutPrefs> {
66        Some(WeekLayoutPrefs {
67            week_starts_on: self.week_starts_on.try_get()?,
68            show_weekends: self.show_weekends.try_get()?,
69        })
70    }
71
72    pub fn ampm_clock(&self) -> bool {
73        self.ampm.get_untracked()
74    }
75
76    pub fn try_ampm_clock(&self) -> Option<bool> {
77        self.ampm.try_get()
78    }
79}
80
81/// Default preferences: weekends on, 12-hour clock, week starts Sunday.
82pub fn default_scheduler_preferences() -> SchedulerPreferences {
83    let show_weekends = RwSignal::new(true);
84    let ampm = RwSignal::new(true);
85    let week_starts_on = RwSignal::new(WEEK_STARTS_SUNDAY);
86    scheduler_preferences_from_signals(show_weekends, ampm, week_starts_on)
87}
88
89/// Build preferences from owned signals (preview / controlled usage).
90pub fn scheduler_preferences_from_signals(
91    show_weekends: RwSignal<bool>,
92    ampm: RwSignal<bool>,
93    week_starts_on: RwSignal<u8>,
94) -> SchedulerPreferences {
95    SchedulerPreferences {
96        show_weekends,
97        ampm,
98        week_starts_on,
99    }
100}
101
102/// Resolve preferences from optional prop or defaults.
103pub fn resolve_scheduler_preferences(
104    preferences: Option<SchedulerPreferences>,
105) -> SchedulerPreferences {
106    preferences.unwrap_or_else(default_scheduler_preferences)
107}