wayfinder-core 0.1.0

Client, cache, search, and rendering for Archives of Nethys Pathfinder 2e / Starfinder 2e data
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

//! Render `ContentBlock` to clean markdown (no HTML tags).

use super::content::{ContentBlock, InlineContent};

/// Render content blocks to clean markdown text.
pub fn render_markdown(blocks: &[ContentBlock]) -> String {
    let mut out = String::new();
    for (i, block) in blocks.iter().enumerate() {
        if i > 0 {
            out.push('\n');
        }
        render_block(&mut out, block, 0);
    }
    out.trim().to_string()
}

#[allow(clippy::only_used_in_recursion)]
fn render_block(out: &mut String, block: &ContentBlock, depth: usize) {
    match block {
        ContentBlock::Title {
            level,
            text,
            right,
            action,
        } => {
            let hashes = "#".repeat(*level as usize);
            let mut line = format!("{hashes} {text}");
            if let Some(a) = action {
                line.push_str(&format!(" ({a})"));
            }
            if let Some(r) = right {
                line.push_str(&format!(" - {r}"));
            }
            out.push_str(&line);
            out.push('\n');
        }
        ContentBlock::Paragraph { content } => {
            render_inlines(out, content);
            out.push('\n');
        }
        ContentBlock::KeyValue { key, value } => {
            out.push_str(&format!("**{key}** "));
            render_inlines(out, value);
            out.push('\n');
        }
        ContentBlock::List { items } => {
            for item in items {
                out.push_str("- ");
                render_inlines(out, item);
                out.push('\n');
            }
        }
        ContentBlock::Table { headers, rows } => {
            if !headers.is_empty() {
                out.push_str(&format!("| {} |\n", headers.join(" | ")));
                let sep: Vec<&str> = headers.iter().map(|_| "---").collect();
                out.push_str(&format!("| {} |\n", sep.join(" | ")));
            }
            for row in rows {
                out.push_str(&format!("| {} |\n", row.join(" | ")));
            }
        }
        ContentBlock::Aside { title, content } => {
            if let Some(t) = title {
                out.push_str(&format!("> **{t}**\n"));
            }
            for inner in content {
                out.push_str("> ");
                render_block(out, inner, depth + 1);
            }
            out.push('\n');
        }
        ContentBlock::HRule => {
            out.push_str("---\n");
        }
    }
}

fn render_inlines(out: &mut String, inlines: &[InlineContent]) {
    for ic in inlines {
        match ic {
            InlineContent::Text { text } => out.push_str(text),
            InlineContent::Bold { text } => {
                out.push_str(&format!("**{text}**"));
            }
            InlineContent::Italic { text } => {
                out.push_str(&format!("_{text}_"));
            }
            InlineContent::Link { text, url } => {
                if url.is_empty() {
                    out.push_str(text);
                } else {
                    out.push_str(&format!("[{text}]({url})"));
                }
            }
            InlineContent::Trait { label } => {
                out.push_str(&format!("[{label}]"));
            }
            InlineContent::Action { text } => {
                out.push_str(&format!("({text})"));
            }
        }
    }
}