bonbon 0.4.2

A sweet and simple Rust library for generating static diabetes data visualizations.
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
92
93
94

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

/// Represents a single glucose reading.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GraphEntry {
    pub sgv: f32,
    pub date: DateTime<Utc>,
}

/// Represents a treatment (Insulin, Carbs, or Manual BG).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GraphTreatment {
    pub insulin: Option<f32>,
    pub carbs: Option<f32>,
    pub mbg: Option<f32>,
    pub date: DateTime<Utc>,
    pub is_isf: bool, // Distinguish SMBs/Microboluses if needed
}

/// Preferences for unit display.
#[derive(Debug, Clone, Copy, PartialEq, Default)]
pub enum UnitDisplay {
    #[default]
    MgDl,
    MmolL,
    /// Shows both, with the first type as the primary (larger) label.
    Dual {
        primary: UnitPreference,
    },
}

#[derive(Debug, Clone, Copy, PartialEq)]
pub enum UnitPreference {
    MgDl,
    MmolL,
}

/// Defines how the Y-Axis scales.
#[derive(Debug, Clone, Copy)]
pub enum GraphScaling {
    /// Manually set Min and Max (e.g., 40, 400).
    Static { min: f32, max: f32 },
    /// Automatically detected based on data, clamped to specific bounds.
    Dynamic {
        /// The absolute minimum value the graph can show (hard floor).
        clamp_min: f32,
        /// The absolute maximum value the graph can show (hard ceiling).
        clamp_max: f32,
        /// The default minimum view (e.g., 70). The graph will expand to this
        /// even if data is tight (e.g., 100-120 becomes 70-120).
        /// If data goes below this (but above clamp_min), the graph expands further.
        default_min: f32,
        /// The default maximum view (e.g., 180).
        default_max: f32,
    },
}

impl Default for GraphScaling {
    fn default() -> Self {
        Self::Dynamic {
            clamp_min: 40.0,
            clamp_max: 400.0,
            default_min: 60.0,
            default_max: 200.0,
        }
    }
}

/// Determines how treatments (Insulin/Carbs) are positioned.
#[derive(Debug, Clone, Copy, PartialEq, Default)]
pub enum TreatmentDisplayMode {
    /// Treatments are shown in fixed lanes at the bottom of the graph (Timeline view).
    #[default]
    Timeline,
    /// Treatments are "attached" to the closest SGV point in time.
    /// Carbs appear above the SGV, Insulin appears below.
    Contextual,
}

/// Configuration for the X-Axis time labels.
///
/// Both modes render local time (HH:MM) with the relative offset (-Xh)
/// underneath and a tick mark on the axis; they differ only in how the tick
/// count is chosen.
#[derive(Debug, Clone, Copy, PartialEq, Default)]
pub enum TimeAxisMode {
    /// Picks a sensible number of evenly spaced labels from the graph width.
    #[default]
    Simple,
    /// Uses exactly `count` evenly spaced labels.
    EquallyDistributed { count: u32 },
    // I'll add more in the future... Probably?
}