termcinema-cli 0.1.0

🎬 Animated terminal-to-SVG renderer CLI for the termcinema project
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

/// Predefined typing speed presets used for animation timing.
///
/// Each variant maps to a fixed frame delay (in milliseconds):
///
/// - 🐢 `Slow`     → 150ms  · Snail-paced typing, good for cinematic effect
/// - 🐇 `Normal`   → 80ms   · Default typing speed
/// - 🚀 `Fast`     → 45ms   · Snappy interaction, readable but quick
/// - ⚡  `Extreme`  → 5ms    · Virtually instant output, useful for tests or skips
#[derive(Debug)]
pub(crate) enum SpeedPreset {
    Slow,
    Normal,
    Fast,
    Extreme,
}

/// Parse a user-provided string into a [`SpeedPreset`] variant.
///
/// Accepts case-insensitive values:
/// - `"slow"`
/// - `"normal"`
/// - `"fast"`
/// - `"extreme"`
///
/// Returns `None` if the input is unrecognized.
pub(crate) fn parse_speed(input: &str) -> Option<SpeedPreset> {
    match input.to_lowercase().as_str() {
        "slow" => Some(SpeedPreset::Slow),
        "normal" => Some(SpeedPreset::Normal),
        "fast" => Some(SpeedPreset::Fast),
        "extreme" => Some(SpeedPreset::Extreme),
        _ => None,
    }
}

/// Convert a [`SpeedPreset`] to its corresponding frame delay in milliseconds.
///
/// This delay defines how long to wait between each character during typing.
pub(crate) fn speed_to_delay_ms(preset: &SpeedPreset) -> u32 {
    match preset {
        SpeedPreset::Slow => 150,
        SpeedPreset::Normal => 80,
        SpeedPreset::Fast => 45,
        SpeedPreset::Extreme => 5,
    }
}