jsxrs 0.1.4

A Rust library for rendering JSX/TSX to complete HTML documents at build-time or server-side.
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

mod attributes;
mod config;
mod document;
mod error;
mod escape;
mod eval;
mod export;
mod head;
mod jsx_expr;
mod parser;
mod renderer;
mod resolver;
mod tailwind;

pub mod codegen;

pub use config::{HeadElement, RenderConfig};
pub use error::JsxrsError;

use std::path::Path;

use serde_json::Value;

/// Render a JSX/TSX source string to a complete HTML document.
pub fn render_string(
    source: &str,
    file_name: &str,
    props: &Value,
    config: &RenderConfig,
) -> Result<String, JsxrsError> {
    if source.is_empty() {
        return Err(JsxrsError::NoDefaultExport);
    }

    let (module, _cm) = parser::parse_source(source, file_name)?;
    let (body_html, state) = renderer::render_module(&module.body, props, config)?;

    if config.fragment {
        return Ok(body_html);
    }

    let head_parts = build_head(&state, config);
    let head_html = head_parts.join("");

    Ok(document::build_document(
        &head_html,
        &body_html,
        config.pretty,
    ))
}

/// Render a JSX/TSX file to a complete HTML document.
pub fn render_file(
    path: &Path,
    props: &Value,
    config: &RenderConfig,
) -> Result<String, JsxrsError> {
    let source =
        std::fs::read_to_string(path).map_err(|_| JsxrsError::FileNotFound(path.to_path_buf()))?;
    let file_name = path
        .file_name()
        .map(|f| f.to_string_lossy().to_string())
        .ok_or_else(|| JsxrsError::FileNotFound(path.to_path_buf()))?;

    render_string(&source, &file_name, props, config)
}

fn build_head(state: &renderer::RenderState, config: &RenderConfig) -> Vec<String> {
    let mut head_parts = head::merge_head(&state.head, &config.head_elements);

    if config.tailwind {
        let css = tailwind::generate_css(&state.class_names);
        if !css.is_empty() {
            head_parts.push(format!("<style>{css}</style>"));
        }
    }

    head_parts
}