fission-charts 0.4.0

Native chart widgets and data visualization primitives for Fission applications
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum ChartEasing {
    Linear,
    EaseIn,
    EaseOut,
    EaseInOut,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum ChartAnimationKind {
    None,
    Grow,
    Fade,
    Sweep,
    Pulse,
    Morph,
}

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ChartAnimation {
    pub enabled: bool,
    pub kind: ChartAnimationKind,
    pub duration_ms: u64,
    pub delay_ms: u64,
    pub stagger_ms: u64,
    pub easing: ChartEasing,
    pub reduced_motion_safe: bool,
    pub repeat: bool,
}

impl Default for ChartAnimation {
    fn default() -> Self {
        Self {
            enabled: false,
            kind: ChartAnimationKind::Grow,
            duration_ms: 450,
            delay_ms: 0,
            stagger_ms: 24,
            easing: ChartEasing::EaseOut,
            reduced_motion_safe: true,
            repeat: false,
        }
    }
}

impl ChartAnimation {
    pub fn disabled() -> Self {
        Self {
            enabled: false,
            kind: ChartAnimationKind::None,
            ..Self::default()
        }
    }

    pub fn enter(kind: ChartAnimationKind) -> Self {
        Self {
            enabled: true,
            kind,
            ..Self::default()
        }
    }

    pub fn duration_ms(mut self, duration_ms: u64) -> Self {
        self.duration_ms = duration_ms;
        self
    }

    pub fn delay_ms(mut self, delay_ms: u64) -> Self {
        self.delay_ms = delay_ms;
        self
    }

    pub fn stagger_ms(mut self, stagger_ms: u64) -> Self {
        self.stagger_ms = stagger_ms;
        self
    }

    pub fn easing(mut self, easing: ChartEasing) -> Self {
        self.easing = easing;
        self
    }

    pub fn reduced_motion_safe(mut self, safe: bool) -> Self {
        self.reduced_motion_safe = safe;
        self
    }

    pub fn repeat(mut self, repeat: bool) -> Self {
        self.repeat = repeat;
        self
    }

    pub fn progress_at(&self, elapsed_ms: u64, item_index: usize) -> f32 {
        if !self.enabled || self.duration_ms == 0 {
            return 1.0;
        }
        let start = self
            .delay_ms
            .saturating_add(self.stagger_ms.saturating_mul(item_index as u64));
        if elapsed_ms <= start {
            return 0.0;
        }
        let raw = ((elapsed_ms - start) as f32 / self.duration_ms as f32).clamp(0.0, 1.0);
        match self.easing {
            ChartEasing::Linear => raw,
            ChartEasing::EaseIn => raw * raw,
            ChartEasing::EaseOut => 1.0 - (1.0 - raw) * (1.0 - raw),
            ChartEasing::EaseInOut => {
                if raw < 0.5 {
                    2.0 * raw * raw
                } else {
                    1.0 - (-2.0 * raw + 2.0).powi(2) / 2.0
                }
            }
        }
    }
}