ratatui-toolkit 0.2.6

DEPRECATED: this crate was renamed to `ratkit`. Please migrate to `ratkit`.
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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212

//! Render frontmatter.

use crate::widgets::markdown_widget::foundation::elements::MarkdownElement;
use ratatui::style::{Color, Style};
use ratatui::text::{Line, Span};

pub fn render(
    _element: &MarkdownElement,
    fields: &[(String, String)],
    collapsed: bool,
    width: usize,
) -> Vec<Line<'static>> {
    let border_style = Style::default().fg(Color::DarkGray);
    let key_style = Style::default().fg(Color::Rgb(240, 113, 120)); // Coral/red for keys (#F07178)
    let value_style = Style::default().fg(Color::Rgb(170, 217, 76)); // Green for values (#AAD94C)
    let collapse_icon_style = Style::default().fg(Color::Yellow);

    // Border character for full-width lines
    let border_char = "\u{2500}";

    if collapsed {
        let context_id = fields
            .iter()
            .find(|(k, _)| k == "context_id")
            .map(|(_, v)| v.as_str())
            .unwrap_or("frontmatter");

        // Build collapsed line: "\u{25b6} \u{2500}\u{2500}\u{2500} context_id \u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}"
        let prefix = "\u{25b6} \u{2500}\u{2500}\u{2500} ";
        let suffix = " ";
        let used_width =
            prefix.chars().count() + context_id.chars().count() + suffix.chars().count();
        let remaining = width.saturating_sub(used_width);
        let border_fill = border_char.repeat(remaining);

        vec![Line::from(vec![
            Span::styled("\u{25b6} ", collapse_icon_style),
            Span::styled("\u{2500}\u{2500}\u{2500} ", border_style),
            Span::styled(context_id.to_string(), key_style),
            Span::styled(" ", Style::default()),
            Span::styled(border_fill, border_style),
        ])]
    } else {
        let mut lines = Vec::new();

        // Top border: "\u{25bc} \u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}"
        let prefix_len = 2; // "\u{25bc} "
        let top_border = border_char.repeat(width.saturating_sub(prefix_len));
        lines.push(Line::from(vec![
            Span::styled("\u{25bc} ", collapse_icon_style),
            Span::styled(top_border, border_style),
        ]));

        for (key, value) in fields {
            let key_prefix = format!("{}: ", key);
            let key_prefix_len = key_prefix.chars().count();

            // Calculate available width for value
            let value_width = width.saturating_sub(key_prefix_len);

            if value_width == 0 || value.chars().count() <= value_width {
                // Value fits on one line
                lines.push(Line::from(vec![
                    Span::styled(key_prefix, key_style),
                    Span::styled(value.clone(), value_style),
                ]));
            } else {
                // Wrap value across multiple lines
                let wrapped = wrap_text(value, value_width);
                for (i, line_text) in wrapped.iter().enumerate() {
                    if i == 0 {
                        // First line with key
                        lines.push(Line::from(vec![
                            Span::styled(key_prefix.clone(), key_style),
                            Span::styled(line_text.clone(), value_style),
                        ]));
                    } else {
                        // Continuation lines - indent to align with value
                        let continuation_indent = " ".repeat(key_prefix_len);
                        lines.push(Line::from(vec![
                            Span::styled(continuation_indent, Style::default()),
                            Span::styled(line_text.clone(), value_style),
                        ]));
                    }
                }
            }
        }

        // Bottom border: "\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}"
        let bottom_border = border_char.repeat(width);
        lines.push(Line::from(vec![Span::styled(bottom_border, border_style)]));

        lines
    }
}

/// Render frontmatter start (opening border with collapse icon).
pub fn render_start(collapsed: bool, context_id: Option<&str>, width: usize) -> Line<'static> {
    let border_style = Style::default().fg(Color::DarkGray);
    let key_style = Style::default().fg(Color::Rgb(240, 113, 120)); // Coral/red (#F07178)
    let collapse_icon_style = Style::default().fg(Color::Yellow);
    let border_char = "\u{2500}";

    if collapsed {
        // Collapsed: "\u{25b6} \u{2500}\u{2500}\u{2500} context_id \u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}"
        let ctx = context_id.unwrap_or("frontmatter");
        let prefix = "\u{25b6} \u{2500}\u{2500}\u{2500} ";
        let suffix = " ";
        let used_width = prefix.chars().count() + ctx.chars().count() + suffix.chars().count();
        let remaining = width.saturating_sub(used_width);
        let border_fill = border_char.repeat(remaining);

        Line::from(vec![
            Span::styled("\u{25b6} ", collapse_icon_style),
            Span::styled("\u{2500}\u{2500}\u{2500} ", border_style),
            Span::styled(ctx.to_string(), key_style),
            Span::styled(" ", Style::default()),
            Span::styled(border_fill, border_style),
        ])
    } else {
        // Expanded: "\u{25bc} \u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}\u{2500}"
        let prefix_len = 2; // "\u{25bc} "
        let top_border = border_char.repeat(width.saturating_sub(prefix_len));
        Line::from(vec![
            Span::styled("\u{25bc} ", collapse_icon_style),
            Span::styled(top_border, border_style),
        ])
    }
}

/// Render a single frontmatter field.
pub fn render_field(key: &str, value: &str, width: usize) -> Vec<Line<'static>> {
    let key_style = Style::default().fg(Color::Rgb(240, 113, 120)); // Coral/red for keys (#F07178)
    let value_style = Style::default().fg(Color::Rgb(170, 217, 76)); // Green for values (#AAD94C)

    let key_prefix = format!("{}: ", key);
    let key_prefix_len = key_prefix.chars().count();
    let value_width = width.saturating_sub(key_prefix_len);

    if value_width == 0 || value.chars().count() <= value_width {
        // Value fits on one line
        vec![Line::from(vec![
            Span::styled(key_prefix, key_style),
            Span::styled(value.to_string(), value_style),
        ])]
    } else {
        // Wrap value across multiple lines
        let wrapped = wrap_text(value, value_width);
        let mut lines = Vec::new();
        for (i, line_text) in wrapped.iter().enumerate() {
            if i == 0 {
                lines.push(Line::from(vec![
                    Span::styled(key_prefix.clone(), key_style),
                    Span::styled(line_text.clone(), value_style),
                ]));
            } else {
                let continuation_indent = " ".repeat(key_prefix_len);
                lines.push(Line::from(vec![
                    Span::styled(continuation_indent, Style::default()),
                    Span::styled(line_text.clone(), value_style),
                ]));
            }
        }
        lines
    }
}

/// Render frontmatter end (closing border).
pub fn render_end(width: usize) -> Line<'static> {
    let border_style = Style::default().fg(Color::DarkGray);
    let border_char = "\u{2500}";
    let bottom_border = border_char.repeat(width);
    Line::from(vec![Span::styled(bottom_border, border_style)])
}

/// Wrap text to fit within a given width.
fn wrap_text(text: &str, width: usize) -> Vec<String> {
    if width == 0 || text.is_empty() {
        return vec![text.to_string()];
    }

    let mut lines = Vec::new();
    let mut current_line = String::new();
    let mut current_width = 0;

    for word in text.split_whitespace() {
        let word_width = word.chars().count();

        if current_width == 0 {
            current_line = word.to_string();
            current_width = word_width;
        } else if current_width + 1 + word_width <= width {
            current_line.push(' ');
            current_line.push_str(word);
            current_width += 1 + word_width;
        } else {
            lines.push(current_line);
            current_line = word.to_string();
            current_width = word_width;
        }
    }

    if !current_line.is_empty() {
        lines.push(current_line);
    }

    if lines.is_empty() {
        lines.push(String::new());
    }

    lines
}