bcode_models_site 0.0.1-alpha.0

Bcode models catalog website
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

#![cfg_attr(feature = "fail-on-warnings", deny(warnings))]
#![warn(clippy::all, clippy::pedantic, clippy::nursery, clippy::cargo)]
#![allow(clippy::multiple_crate_versions)]

//! Bcode models catalog website.

use std::sync::LazyLock;

use bcode_model_catalog::{OutputFormat, default_source_dir, load_catalog};
use hyperchad::app::{App, AppBuilder, renderer::DefaultRenderer};
use hyperchad::color::Color;
use hyperchad::router::Router;

static BACKGROUND_COLOR: LazyLock<Color> = LazyLock::new(|| Color::from_hex("#0d1117"));

/// Default viewport meta tag for responsive design.
pub static VIEWPORT: LazyLock<String> =
    LazyLock::new(|| "width=device-width, initial-scale=1".to_string());

/// Application router.
pub static ROUTER: LazyLock<Router> = LazyLock::new(|| {
    Router::new().with_static_route(&["/", "/home"], |_| async {
        let catalog = load_catalog(&default_source_dir()).unwrap_or_else(|_| {
            bcode_model_catalog_models::CatalogDocument::empty(
                option_env!("GIT_HASH").unwrap_or("unknown"),
                "1970-01-01T00:00:00Z",
            )
        });
        bcode_models_site_ui::pages::home::home(&catalog)
    })
});

/// Initialize the application builder with default configuration.
#[must_use]
pub fn init() -> AppBuilder {
    AppBuilder::new()
        .with_router(ROUTER.clone())
        .with_background(*BACKGROUND_COLOR)
        .with_title("models.bmux.dev".to_string())
        .with_description("Model catalog for Bcode and BMUX".to_string())
        .with_size(1100.0, 700.0)
}

/// Build the application from the provided builder.
///
/// # Errors
///
/// Returns an error if the application fails to build.
pub fn build_app(builder: AppBuilder) -> Result<App<DefaultRenderer>, hyperchad::app::Error> {
    Ok(builder.build_default()?)
}

/// Build catalog API artifacts next to the HyperChad-generated static site.
///
/// The `HyperChad` runner owns the process CLI and rejects unknown flags, so live snapshots are
/// supplied through the `BCODE_MODEL_CATALOG_LIVE_DIR` environment variable rather than a `--live`
/// argument.
///
/// # Errors
///
/// Returns an error if catalog artifacts cannot be generated.
pub fn build_catalog_artifacts(
    output_dir: &std::path::Path,
    live_dir: Option<&std::path::Path>,
) -> bcode_model_catalog::Result<()> {
    bcode_model_catalog::build_artifacts_with_live(
        &default_source_dir(),
        live_dir,
        &output_dir.join("v1"),
        OutputFormat::PrettyJson,
    )
}