caixa-theme 0.1.687

Nord palette + blackmatter style overlays for caixa diagnostics, formatter output, LSP semantic tokens, and nvim plugin colors.
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

//! Nord — Arctic-themed palette. Reference: <https://www.nordtheme.com/>.
//!
//! Polar Night → Snow Storm → Frost → Aurora. All members are const — use
//! them directly, e.g. `Nord::NORD11` for red.

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct Rgb {
    pub r: u8,
    pub g: u8,
    pub b: u8,
}

impl Rgb {
    #[must_use]
    pub const fn new(r: u8, g: u8, b: u8) -> Self {
        Self { r, g, b }
    }

    #[must_use]
    pub const fn from_hex(hex: u32) -> Self {
        Self {
            r: ((hex >> 16) & 0xFF) as u8,
            g: ((hex >> 8) & 0xFF) as u8,
            b: (hex & 0xFF) as u8,
        }
    }

    #[must_use]
    pub fn to_hex(self) -> String {
        format!("#{:02X}{:02X}{:02X}", self.r, self.g, self.b)
    }

    #[must_use]
    pub const fn from_irodori(c: irodori::Color) -> Self {
        Self::new(c.r, c.g, c.b)
    }

    /// ANSI 24-bit SGR foreground sequence — `ESC[38;2;R;G;Bm`.
    #[must_use]
    pub fn fg_ansi(self) -> String {
        anstyle::RgbColor(self.r, self.g, self.b)
            .render_fg()
            .to_string()
    }

    /// ANSI 24-bit SGR background sequence — `ESC[48;2;R;G;Bm`.
    #[must_use]
    pub fn bg_ansi(self) -> String {
        anstyle::RgbColor(self.r, self.g, self.b)
            .render_bg()
            .to_string()
    }
}

impl From<Rgb> for kazari::Rgb {
    fn from(c: Rgb) -> Self {
        kazari::Rgb::new(c.r, c.g, c.b)
    }
}

impl From<kazari::Rgb> for Rgb {
    fn from(c: kazari::Rgb) -> Self {
        Rgb::new(c.r, c.g, c.b)
    }
}

impl From<irodori::Color> for Rgb {
    fn from(c: irodori::Color) -> Self {
        Rgb::from_irodori(c)
    }
}

/// Reset SGR — ends a color.
pub const ANSI_RESET: anstyle::Reset = anstyle::Reset;

/// Nord palette — 16 entries, named Nord0 … Nord15 per the canonical spec.
#[allow(non_snake_case)]
pub struct Nord;

impl Nord {
    // Polar Night — backgrounds, UI chrome.
    pub const NORD0: Rgb = Rgb::from_irodori(irodori::NORD.polar_night[0]);
    pub const NORD1: Rgb = Rgb::from_irodori(irodori::NORD.polar_night[1]);
    pub const NORD2: Rgb = Rgb::from_irodori(irodori::NORD.polar_night[2]);
    pub const NORD3: Rgb = Rgb::from_irodori(irodori::NORD.polar_night[3]);
    // Snow Storm — foregrounds.
    pub const NORD4: Rgb = Rgb::from_irodori(irodori::NORD.snow_storm[0]);
    pub const NORD5: Rgb = Rgb::from_irodori(irodori::NORD.snow_storm[1]);
    pub const NORD6: Rgb = Rgb::from_irodori(irodori::NORD.snow_storm[2]);
    // Frost — classes, types, primary accent.
    pub const NORD7: Rgb = Rgb::from_irodori(irodori::NORD.frost[0]);
    pub const NORD8: Rgb = Rgb::from_irodori(irodori::NORD.frost[1]);
    pub const NORD9: Rgb = Rgb::from_irodori(irodori::NORD.frost[2]);
    pub const NORD10: Rgb = Rgb::from_irodori(irodori::NORD.frost[3]);
    // Aurora — diagnostics, literals.
    pub const NORD11: Rgb = Rgb::from_irodori(irodori::NORD.aurora[0]); // red   — errors
    pub const NORD12: Rgb = Rgb::from_irodori(irodori::NORD.aurora[1]); // orange — warnings
    pub const NORD13: Rgb = Rgb::from_irodori(irodori::NORD.aurora[2]); // yellow — hints
    pub const NORD14: Rgb = Rgb::from_irodori(irodori::NORD.aurora[3]); // green  — added / info
    pub const NORD15: Rgb = Rgb::from_irodori(irodori::NORD.aurora[4]); // purple — strings / symbols
}

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

    #[test]
    fn hex_round_trip() {
        let c = Rgb::from_hex(0x5E_81_AC);
        assert_eq!(c.to_hex(), "#5E81AC");
    }

    #[test]
    fn palette_is_irodori_nord_in_canonical_order() {
        let table = [
            Nord::NORD0,
            Nord::NORD1,
            Nord::NORD2,
            Nord::NORD3,
            Nord::NORD4,
            Nord::NORD5,
            Nord::NORD6,
            Nord::NORD7,
            Nord::NORD8,
            Nord::NORD9,
            Nord::NORD10,
            Nord::NORD11,
            Nord::NORD12,
            Nord::NORD13,
            Nord::NORD14,
            Nord::NORD15,
        ];
        for (ours, theirs) in table.iter().zip(irodori::NORD.all_colors()) {
            assert_eq!(*ours, Rgb::from(theirs));
        }
    }

    #[test]
    fn ansi_fg_matches_kazari_truecolor_emission() {
        let c = Nord::NORD11;
        let caps = kazari::Capability::fixed(kazari::ColorLevel::Truecolor, 80, true);
        assert_eq!(
            format!("{}x{ANSI_RESET}", c.fg_ansi()),
            kazari::paint_rgb_at(c.into(), "x", false, false, &caps),
        );
        assert_ne!(c.fg_ansi(), c.bg_ansi());
    }
}