waterui-cli 0.1.4

Cross-platform tooling for WaterUI applications
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

//! Preview command protocol types.
//!
//! This module defines the messages exchanged between:
//! - CLI → Preview support app (render commands via TCP)
//! - Preview support app → CLI (render results via TCP)

/// Target platform for a native preview support app.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum PreviewPlatform {
    /// Physical iOS device.
    Ios,
    /// iOS Simulator.
    IosSimulator,
    /// macOS.
    Macos,
    /// Android device or emulator.
    Android,
}

impl std::str::FromStr for PreviewPlatform {
    type Err = String;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s.to_lowercase().as_str() {
            "ios" => Ok(Self::Ios),
            "ios-simulator" | "iossimulator" => Ok(Self::IosSimulator),
            "macos" => Ok(Self::Macos),
            "android" => Ok(Self::Android),
            _ => Err(format!("Unknown platform: {s}")),
        }
    }
}

pub use waterui_preview_protocol::{
    DylibId, DylibSource, PREVIEW_PROTOCOL_COMMIT, PreviewError as AppError,
    PreviewOutput as AppOutput, PreviewProtocolInfo, PreviewRequest as AppRequest,
    PreviewResponse as AppResponse, PreviewRuntimePlatform, Size,
};

pub use waterui_preview_protocol::tcp::PreviewTcpConfig;

/// Convert a function path to preview export symbol.
///
/// Example:
/// - `sidebar` with crate `my-crate` -> `waterui_preview_my_crate_sidebar`
/// - `dashboard::admin::card_preview` with crate `my-crate`
///   -> `waterui_preview_my_crate_card_preview`
///
/// # Panics
///
/// Panics if `function_path` does not end with a function name.
#[must_use]
pub fn function_path_to_symbol(crate_name: &str, function_path: &str) -> String {
    // Replace dashes with underscores (Cargo uses dashes, Rust uses underscores)
    let crate_name = crate_name.replace('-', "_");
    let function_name = function_path
        .rsplit("::")
        .next()
        .expect("splitting a string always yields one segment");
    assert!(
        !function_name.is_empty(),
        "preview function path must end with a function name"
    );
    format!("waterui_preview_{crate_name}_{function_name}")
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_function_path_to_symbol() {
        assert_eq!(
            function_path_to_symbol("my_crate", "sidebar"),
            "waterui_preview_my_crate_sidebar"
        );

        assert_eq!(
            function_path_to_symbol("my-crate", "dashboard::admin::card_preview"),
            "waterui_preview_my_crate_card_preview"
        );
    }
}