vtcode-ghostty-core 0.123.3

Pure-Rust VT terminal emulator core for VT Code, inspired by Ghostty
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

/// Parser states for the VT state machine.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum ParserState {
    Ground,
    Escape,
    Csi,
    Osc,
}

/// A parsed CSI sequence.
#[derive(Clone, Debug)]
pub(crate) struct CsiSequence {
    pub(crate) raw: String,
    pub(crate) private: bool,
    pub(crate) params: Vec<Option<usize>>,
}

impl CsiSequence {
    pub(crate) fn parse(raw: &str) -> Self {
        let private = raw.starts_with('?');
        let clean = if private { &raw[1..] } else { raw };

        // Strip leading intermediate characters (>, =, <)
        let clean = clean.trim_start_matches(|c: char| c == '>' || c == '=' || c == '<');

        let params = clean
            .split(';')
            .map(|s| {
                if s.is_empty() {
                    None
                } else {
                    s.parse::<usize>().ok()
                }
            })
            .collect();

        Self {
            raw: raw.to_string(),
            private,
            params,
        }
    }

    /// Get parameter at index, or the default value.
    pub(crate) fn param_or(&self, index: usize, default: usize) -> usize {
        self.params.get(index).and_then(|p| *p).unwrap_or(default)
    }

    /// Convert a 1-based parameter to 0-based (saturating).
    pub(crate) fn one_based_to_zero(&self, index: usize) -> usize {
        self.param_or(index, 1).saturating_sub(1)
    }
}