hauchiwa 0.5.3

Incredibly flexible static site generator library with incremental rebuilds and cached image optimization
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

use std::process::{Command, Stdio};

use camino::{Utf8Path, Utf8PathBuf};

use crate::{Hash32, Loader, loader::generic::LoaderGenericMultifile};

/// Represents a compiled JavaScript module ready for inclusion in the output site.
///
/// Each [`Script`] corresponds to a `.js`, `.ts`, or `.tsx` source file that has been
/// bundled and minified using `esbuild`. The compiled output is stored under a
/// hashed filename, and the `path` can be used in templates.
pub struct Script {
    // Path to the compiled `.js` file,
    pub path: Utf8PathBuf,
}

/// Constructs a loader that compiles JavaScript/TypeScript files using `esbuild`.
///
/// Matches files based on a glob pattern and compiles each into a minified
/// ES module using `esbuild` with bundling enabled. Each output is content-hashed
/// and written to disk. The resulting `Script` provides the path to that output.
///
/// ### Parameters
/// - `path_base`: Base directory for relative resolution of the glob.
/// - `path_glob`: Glob pattern used to select `.js`, `.ts`, etc. source files.
///
/// ### Returns
/// A `Loader` that emits `Script` objects keyed by hashed output content.
///
/// ### Requirements
/// - `esbuild` must be installed and available on `$PATH`.
///
/// ### Example
/// ```rust
/// use hauchiwa::loader::glob_scripts;
///
/// let loader = glob_scripts("src/scripts", "**/*.ts");
/// ```
pub fn glob_scripts(path_base: &'static str, path_glob: &'static str) -> Loader {
    Loader::with(move |_| {
        LoaderGenericMultifile::new(
            path_base,
            path_glob,
            |path| {
                let data = compile_esbuild(path);
                let hash = Hash32::hash(&data);

                Ok((hash, data))
            },
            |rt, data| {
                let path = rt.store(&data, "js")?;

                Ok(Script { path })
            },
        )
    })
}

fn compile_esbuild(file: &Utf8Path) -> Vec<u8> {
    let output = Command::new("esbuild")
        .arg(file.as_str())
        .arg("--format=esm")
        .arg("--bundle")
        .arg("--minify")
        .stdout(Stdio::piped())
        .stderr(Stdio::inherit())
        .output()
        .expect("esbuild invocation failed");

    output.stdout
}