tslime 0.1.2

A lightweight terminal screensaver simulating slime mold growth patterns
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

//! `AppRuntimeConfig` — restart-only levers that have no home in `SimConfig` or
//! `ResolvedRenderConfig`.
//!
//! Holds every observable `args.*` setting the runner reads directly that is NOT
//! a sim lever (simulation parameters) or render lever (visual pipeline config).
//! Defaults source from `crate::config_defaults` constants — no magic numbers here.

use crate::render::grid::GridStyle;
use crate::render::palette::RgbColor;
use serde::{Deserialize, Serialize};

/// Restart-only application-level runtime configuration.
///
/// These are the levers the runner reads from `args.*` at startup that don't fit
/// in `SimConfig` (simulation algorithm params) or `ResolvedRenderConfig` (visual
/// pipeline params). `Profile` carries one of these alongside `sim`/`render`/`seed`
/// so saved configs and preset switches can round-trip them.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub(crate) struct AppRuntimeConfig {
    // ── warmup ──
    /// Number of warmup frames at simulation start.
    pub warmup_frames: usize,
    /// Skip the warmup phase entirely.
    pub skip_warmup: bool,
    /// Brightness multiplier applied during warmup.
    pub warmup_brightness_multiplier: f32,

    // ── auto-reset ──
    /// Enable automatic reset when the simulation collapses.
    pub auto_reset: bool,
    /// Entropy threshold below which the simulation is considered collapsed
    /// (brightness-value entropy is 0..8; healthy ~4-6, dead → 0).
    pub auto_reset_entropy_threshold: f32,
    /// Number of frames the simulation must remain collapsed before auto-reset fires.
    pub auto_reset_duration_frames: usize,

    // ── background grid (all five GridRenderer::new params) ──
    /// Enable background grid rendering.
    pub grid: bool,
    /// Visual style of the grid.
    pub grid_style: GridStyle,
    /// Grid cell size (number of cells per dimension).
    pub grid_size: usize,
    /// Grid line color.
    pub grid_color: RgbColor,
    /// Base opacity of the grid (0.0–1.0).
    pub grid_opacity: f32,
    /// Whether grid opacity adapts to trail density.
    pub grid_adaptive: bool,

    // ── food persistence params ──
    /// Strength of persistent food attractors.
    pub food_persist_strength: f32,
    /// Radius of persistent food attractors.
    pub food_persist_radius: f32,
    /// Duration of food persistence in frames.
    pub food_persist_duration: usize,
}

impl Default for AppRuntimeConfig {
    fn default() -> Self {
        use crate::config_defaults::{auto_reset, food_persist, grid, warmup};

        Self {
            warmup_frames: warmup::DEFAULT_WARMUP_FRAMES,
            skip_warmup: warmup::DEFAULT_SKIP_WARMUP,
            warmup_brightness_multiplier: warmup::DEFAULT_BRIGHTNESS_MULTIPLIER,

            auto_reset: auto_reset::DEFAULT_AUTO_RESET,
            auto_reset_entropy_threshold: auto_reset::DEFAULT_ENTROPY_THRESHOLD,
            auto_reset_duration_frames: auto_reset::DEFAULT_DURATION_FRAMES,

            grid: grid::DEFAULT_GRID_ENABLED,
            grid_style: GridStyle::Cross,
            grid_size: grid::DEFAULT_GRID_SIZE,
            grid_color: RgbColor::from_hex(grid::DEFAULT_GRID_COLOR_HEX),
            grid_opacity: grid::DEFAULT_GRID_OPACITY,
            grid_adaptive: grid::DEFAULT_GRID_ADAPTIVE,

            food_persist_strength: food_persist::DEFAULT_STRENGTH,
            food_persist_radius: food_persist::DEFAULT_RADIUS,
            food_persist_duration: food_persist::DEFAULT_DURATION,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn default_sources_from_config_defaults() {
        use crate::config_defaults::{auto_reset, food_persist, grid, warmup};
        let cfg = AppRuntimeConfig::default();
        assert_eq!(cfg.warmup_frames, warmup::DEFAULT_WARMUP_FRAMES);
        assert_eq!(cfg.skip_warmup, warmup::DEFAULT_SKIP_WARMUP);
        assert_eq!(
            cfg.warmup_brightness_multiplier,
            warmup::DEFAULT_BRIGHTNESS_MULTIPLIER
        );
        assert_eq!(cfg.auto_reset, auto_reset::DEFAULT_AUTO_RESET);
        assert_eq!(
            cfg.auto_reset_entropy_threshold,
            auto_reset::DEFAULT_ENTROPY_THRESHOLD
        );
        assert_eq!(
            cfg.auto_reset_duration_frames,
            auto_reset::DEFAULT_DURATION_FRAMES
        );
        assert_eq!(cfg.grid, grid::DEFAULT_GRID_ENABLED);
        assert_eq!(cfg.grid_style, GridStyle::Cross);
        assert_eq!(cfg.grid_size, grid::DEFAULT_GRID_SIZE);
        assert_eq!(
            cfg.grid_color,
            RgbColor::from_hex(grid::DEFAULT_GRID_COLOR_HEX)
        );
        assert_eq!(cfg.grid_opacity, grid::DEFAULT_GRID_OPACITY);
        assert_eq!(cfg.grid_adaptive, grid::DEFAULT_GRID_ADAPTIVE);
        assert_eq!(cfg.food_persist_strength, food_persist::DEFAULT_STRENGTH);
        assert_eq!(cfg.food_persist_radius, food_persist::DEFAULT_RADIUS);
        assert_eq!(cfg.food_persist_duration, food_persist::DEFAULT_DURATION);
    }
}