esoc-chart 0.1.0

High-level charting API built on esoc-gfx — matplotlib-equivalent for Rust
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
120
121
122
123
124
125
126
127
128
129
130
131

// SPDX-License-Identifier: MIT OR Apache-2.0
//! Enhanced theme for the grammar-of-graphics chart API.

use esoc_color::{Color, ColorScale, Palette};

/// Theme controlling visual appearance of grammar-based charts.
#[derive(Clone, Debug)]
pub struct NewTheme {
    /// Background color.
    pub background: Color,
    /// Foreground color (text, axes, ticks).
    pub foreground: Color,
    /// Muted foreground color (subtitles, secondary text).
    pub muted_foreground: Color,
    /// Color palette for data series.
    pub palette: Palette,
    /// Grid line color.
    pub grid_color: Color,
    /// Grid line width.
    pub grid_width: f32,
    /// Whether to show grid lines.
    pub show_grid: bool,
    /// Base font size from which all others are derived.
    pub base_font_size: f32,
    /// Title font size (base * 1.2).
    pub title_font_size: f32,
    /// Subtitle font size (base * 1.1).
    pub subtitle_font_size: f32,
    /// Axis label font size (base * 1.0).
    pub label_font_size: f32,
    /// Tick label font size (base * 0.9).
    pub tick_font_size: f32,
    /// Legend font size (base * 0.9).
    pub legend_font_size: f32,
    /// Font family.
    pub font_family: String,
    /// Axis line width.
    pub axis_width: f32,
    /// Default data line width.
    pub line_width: f32,
    /// Default scatter point size (area in px²).
    pub point_size: f32,
    /// Optional color scale for heatmaps (default: viridis).
    pub color_scale: Option<ColorScale>,
}

impl NewTheme {
    /// Default light theme.
    pub fn light() -> Self {
        let base = 13.0_f32;
        Self {
            background: Color::WHITE,
            foreground: Color::from_srgb8(0x33, 0x33, 0x33), // near-black, softer than pure #000
            muted_foreground: Color::from_srgb8(0x73, 0x73, 0x73), // sRGB ~0.45
            palette: Palette::tab10(),
            grid_color: Color::from_srgb8(0xE0, 0xE0, 0xE0), // sRGB #E0E0E0
            grid_width: 0.5,
            show_grid: true,
            base_font_size: base,
            title_font_size: (base * 1.2).max(8.0),
            subtitle_font_size: (base * 1.1).max(8.0),
            label_font_size: (base * 1.0).max(8.0),
            tick_font_size: (base * 0.9).max(8.0),
            legend_font_size: (base * 0.9).max(8.0),
            font_family: "sans-serif".to_string(),
            axis_width: 1.0,
            line_width: 2.0,
            point_size: 30.0, // px² area (Vega default)
            color_scale: None,
        }
    }

    /// Dark theme.
    pub fn dark() -> Self {
        let base = 13.0_f32;
        Self {
            background: Color::from_srgb8(0x1e, 0x1e, 0x2e),
            foreground: Color::from_srgb8(0xcd, 0xd6, 0xf4),
            muted_foreground: Color::new(0.55, 0.55, 0.65, 1.0), // muted light
            palette: Palette::tab10(),
            grid_color: Color::from_srgb8(0x3a, 0x3a, 0x4a), // visible on dark bg
            grid_width: 0.5,
            show_grid: true,
            base_font_size: base,
            title_font_size: (base * 1.2).max(8.0),
            subtitle_font_size: (base * 1.1).max(8.0),
            label_font_size: (base * 1.0).max(8.0),
            tick_font_size: (base * 0.9).max(8.0),
            legend_font_size: (base * 0.9).max(8.0),
            font_family: "sans-serif".to_string(),
            axis_width: 1.0,
            line_width: 2.0,
            point_size: 30.0,
            color_scale: None,
        }
    }

    /// Publication theme — clean, minimal, for papers.
    pub fn publication() -> Self {
        let base = 10.0_f32;
        Self {
            background: Color::WHITE,
            foreground: Color::BLACK,
            muted_foreground: Color::new(0.25, 0.25, 0.25, 1.0),
            palette: Palette::tab10(),
            grid_color: Color::TRANSPARENT,
            grid_width: 0.0,
            show_grid: false,
            base_font_size: base,
            title_font_size: (base * 1.2).max(8.0),
            subtitle_font_size: (base * 1.1).max(8.0),
            label_font_size: (base * 1.0).max(8.0),
            tick_font_size: (base * 0.9).max(8.0),
            legend_font_size: (base * 0.9).max(8.0),
            font_family: "serif".to_string(),
            axis_width: 1.0,
            line_width: 1.5,
            point_size: 25.0, // slightly smaller for publication
            color_scale: None,
        }
    }
}

impl Default for NewTheme {
    fn default() -> Self {
        Self::light()
    }
}

/// Preferred alias for [`NewTheme`].
pub type Theme = NewTheme;