Merge branch 'feature/20260429/better'

Author: KonghaYao

Cargo.lock

@@ -7,10 +7,13 @@ description = "Reusable ratatui widget library for Perihelion"
 [dependencies]
 ratatui = { version = ">=0.30", features = ["unstable-rendered-line-info"] }
 pulldown-cmark = { version = "0.12", optional = true }
+syntect = { version = "5", default-features = false, features = ["default-fancy"], optional = true }
+once_cell = "1"
 unicode-width = "0.2"
 rand = "0.8"
 regex = "1"
 
 [features]
 default = []
 markdown = ["pulldown-cmark"]
+markdown-highlight = ["markdown", "dep:syntect"]

perihelion-widgets/Cargo.toml

@@ -0,0 +1,80 @@
+use once_cell::sync::Lazy;
+use ratatui::{
+    style::{Color, Style},
+    text::{Line, Span},
+};
+use syntect::easy::HighlightLines;
+use syntect::highlighting::ThemeSet;
+use syntect::parsing::SyntaxSet;
+
+pub static SYNTAX_SET: Lazy<SyntaxSet> = Lazy::new(SyntaxSet::load_defaults_newlines);
+pub static THEME_SET: Lazy<ThemeSet> = Lazy::new(ThemeSet::load_defaults);
+
+/// │ 前缀的固定灰色，与 TUI 暗色背景视觉协调
+const PREFIX_COLOR: Color = Color::Rgb(130, 140, 150);
+
+/// 对多行代码块进行语法高亮，返回着色后的 Line 列表。
+/// 当语言标签未识别时返回 None，调用方应回退到统一颜色渲染。
+pub fn highlight_code_block(lang: &str, lines: &[String]) -> Option<Vec<Line<'static>>> {
+    let ss = &*SYNTAX_SET;
+    let syntax = ss.find_syntax_by_token(lang)?;
+    let theme = &THEME_SET.themes["base16-ocean.dark"];
+    let mut highlighter = HighlightLines::new(syntax, theme);
+
+    let mut result = Vec::with_capacity(lines.len());
+    for line_text in lines {
+        let mut spans = Vec::new();
+        spans.push(Span::styled("│ ".to_string(), Style::default().fg(PREFIX_COLOR)));
+
+        let ranges = highlighter.highlight_line(line_text, ss).ok()?;
+        for (style, text) in ranges {
+            let color = Color::Rgb(style.foreground.r, style.foreground.g, style.foreground.b);
+            spans.push(Span::styled(text.to_string(), Style::default().fg(color)));
+        }
+        result.push(Line::from(spans));
+    }
+    Some(result)
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn highlight_rust_code() {
+        let result = highlight_code_block("rust", &["fn main() {}".to_string()]);
+        assert!(result.is_some(), "rust 代码应被识别");
+        let lines = result.unwrap();
+        assert_eq!(lines.len(), 1);
+        let has_prefix = lines[0].spans.iter().any(|s| s.content.contains("│"));
+        assert!(has_prefix, "应有 │ 前缀");
+        let has_syntax_color = lines[0].spans.iter().any(|s| {
+            s.style.fg.map_or(false, |c| c != PREFIX_COLOR) && !s.content.contains("│")
+        });
+        assert!(has_syntax_color, "应有非前缀颜色的语法着色 span");
+    }
+
+    #[test]
+    fn highlight_unknown_lang() {
+        let result = highlight_code_block("unknown_lang_xyz", &["hello".to_string()]);
+        assert!(result.is_none(), "未识别语言应返回 None");
+    }
+
+    #[test]
+    fn highlight_empty_lang() {
+        let result = highlight_code_block("", &["hello".to_string()]);
+        assert!(result.is_none(), "空语言标签应返回 None");
+    }
+
+    #[test]
+    fn highlight_multiline() {
+        let lines = vec![
+            "fn main() {".to_string(),
+            "    println!(\"hello\");".to_string(),
+            "}".to_string(),
+        ];
+        let result = highlight_code_block("rust", &lines);
+        assert!(result.is_some(), "多行 rust 代码应被识别");
+        assert_eq!(result.unwrap().len(), 3, "输出行数应等于输入行数");
+    }
+}