euv-cli 0.8.14

The official CLI tool for the euv UI framework, providing dev/release profiles with run/build modes, hot reload, and wasm-pack integration.
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

use crate::*;

/// Shared application state.
///
/// Holds the generated HTML, reload channel, build lock, and CLI arguments
/// for coordination between the HTTP server and file watcher.
#[derive(Data, New)]
pub(crate) struct AppState {
    /// The generated HTML with injected reload script.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) html_content: RwLock<String>,
    /// Broadcast channel for reload events.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) reload_tx: broadcast::Sender<ReloadEvent>,
    /// Whether a build is currently in progress.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) is_building: RwLock<bool>,
    /// CLI arguments.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) args: ModeArgs,
}

/// Configuration for HTML generation.
///
/// Groups all parameters needed by `generate_html` into a single struct
/// to reduce parameter count and improve maintainability.
#[derive(Data, New)]
pub(crate) struct HtmlConfig {
    /// The directory where `index.html` will be written.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) serving_root: PathBuf,
    /// The JS import path relative to the serving root.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) import_path: String,
    /// Whether to use the release template (no live-reload).
    #[get(pub(crate), type(copy))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) is_release: bool,
    /// Optional path to a custom index.html template file.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) custom_index_html: Option<PathBuf>,
}

/// Request middleware that injects cache-control headers.
///
/// Sets `Cache-Control: no-cache, no-store, must-revalidate`, `Pragma: no-cache`,
/// and `Expires: 0` on every response to prevent stale WASM assets during development.
#[derive(Data, New)]
pub(crate) struct RequestMiddleware;

/// Response middleware that writes the serialized response to the stream.
///
/// Builds the HTTP response bytes and sends them through the connection stream,
/// closing the stream if the send fails.
#[derive(Data, New)]
pub(crate) struct ResponseMiddleware;

/// Route handler for the root path serving the injected development HTML.
///
/// When the request targets `index.html`, returns the in-memory HTML
/// that has the live-reload script injected. For all other files,
/// reads the content from disk with path-traversal protection.
#[derive(Data, New)]
pub(crate) struct IndexRoute;

/// Route handler for the reload endpoint using long-polling.
///
/// Holds the connection open until a reload event is broadcast, then returns
/// a single JSON response so the client can distinguish between a successful
/// rebuild and an error.
#[derive(Data, New)]
pub(crate) struct ReloadRoute;