BREP_render 0.2.0

BREP Rust rendering engine: kernel-fed scene store + wgpu renderer (headless artifact, desktop window, and wasm canvas shells).
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

//! The ONE assembly-constraint status → label/color map (requirements §5
//! vocabulary). Both the Assembly Constraints panel's row status labels AND the
//! viewport overlay labels (lane G) read THIS module — the status vocabulary and
//! its colors are never re-declared anywhere else (the UI-consistency directive).
//!
//! Colors are the captured palette: grey `#8e8e93` (disabled), green `#30d158`
//! (satisfied), yellow `#ffd60a` (adjusting / everything indeterminate — also
//! the default), red `#ff3b30` (blocked / duplicate / error / failed). Exposed
//! as plain sRGB byte triples so this stays egui-free (reusable by any painter).

/// The human label for a constraint `persistentData.status` word. Unknown /
/// empty statuses read as "Pending" (a constraint that has never run).
pub fn status_label(status: &str) -> &'static str {
    match status {
        "disabled" => "Disabled",
        "satisfied" => "Satisfied",
        "adjusted" | "adjusting" => "Adjusting",
        "blocked" => "Blocked",
        "pending" | "" => "Pending",
        "duplicate" => "Duplicate",
        "error" => "Error",
        "incomplete" => "Incomplete",
        "invalid-selection" => "Invalid selection",
        "unsupported-selection" | "unimplemented" => "Unimplemented",
        "pending-component" => "Pending component",
        "fixed" => "Locked",
        "noop" => "No change",
        "apply-failed" => "Failed",
        _ => "Pending",
    }
}

/// The status color as sRGB bytes. Grey for disabled, green for satisfied,
/// red for the error family (blocked / duplicate / error / apply-failed),
/// yellow (`#ffd60a`) for adjusting and every indeterminate status — the
/// captured default.
pub fn status_color_rgb(status: &str) -> [u8; 3] {
    match status {
        "disabled" => [0x8e, 0x8e, 0x93],
        "satisfied" => [0x30, 0xd1, 0x58],
        "blocked" | "duplicate" | "error" | "invalid-selection" | "apply-failed" => {
            [0xff, 0x3b, 0x30]
        }
        "unsupported-selection" | "unimplemented" => [0xff, 0x9f, 0x0a],
        _ => [0xff, 0xd6, 0x0a],
    }
}

/// The status color as a CSS hex string (`#rrggbb`) — the overlay/label lanes
/// that speak CSS-hex use this so the byte triple and the hex can never drift.
pub fn status_color_hex(status: &str) -> String {
    let [r, g, b] = status_color_rgb(status);
    format!("#{r:02x}{g:02x}{b:02x}")
}

/// Rank a status for the structure tree's per-component ROLLUP dot: the WORST
/// status across a component's constraints wins. Higher = worse. Order:
/// error family (3) > indeterminate/adjusting (2) > satisfied (1) >
/// disabled (0).
pub fn status_severity(status: &str) -> u8 {
    match status {
        "disabled" => 0,
        "satisfied" => 1,
        "blocked" | "duplicate" | "error" | "apply-failed" => 3,
        _ => 2,
    }
}

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

    #[test]
    fn vocabulary_labels_match_requirements() {
        // The requirements-§5 table, spot-checked across every family.
        assert_eq!(status_label("disabled"), "Disabled");
        assert_eq!(status_label("satisfied"), "Satisfied");
        assert_eq!(status_label("adjusted"), "Adjusting");
        assert_eq!(status_label("adjusting"), "Adjusting");
        assert_eq!(status_label("blocked"), "Blocked");
        assert_eq!(status_label("pending"), "Pending");
        assert_eq!(status_label("duplicate"), "Duplicate");
        assert_eq!(status_label("error"), "Error");
        assert_eq!(status_label("incomplete"), "Incomplete");
        assert_eq!(status_label("invalid-selection"), "Invalid selection");
        assert_eq!(status_label("unsupported-selection"), "Unimplemented");
        assert_eq!(status_label("unimplemented"), "Unimplemented");
        assert_eq!(status_label("pending-component"), "Pending component");
        assert_eq!(status_label("fixed"), "Locked");
        assert_eq!(status_label("noop"), "No change");
        assert_eq!(status_label("apply-failed"), "Failed");
        // Never-ran / unknown default to Pending.
        assert_eq!(status_label(""), "Pending");
        assert_eq!(status_label("???"), "Pending");
    }

    #[test]
    fn colors_match_the_captured_palette() {
        assert_eq!(status_color_hex("disabled"), "#8e8e93");
        assert_eq!(status_color_hex("satisfied"), "#30d158");
        assert_eq!(status_color_hex("adjusted"), "#ffd60a");
        assert_eq!(status_color_hex("blocked"), "#ff3b30");
        assert_eq!(status_color_hex("duplicate"), "#ff3b30");
        assert_eq!(status_color_hex("error"), "#ff3b30");
        assert_eq!(status_color_hex("apply-failed"), "#ff3b30");
        // The default is the captured yellow.
        assert_eq!(status_color_hex("pending"), "#ffd60a");
        assert_eq!(status_color_hex("fixed"), "#ffd60a");
        assert_eq!(status_color_hex(""), "#ffd60a");
        // Byte triple and hex agree by construction.
        assert_eq!(status_color_rgb("satisfied"), [0x30, 0xd1, 0x58]);
    }

    #[test]
    fn severity_orders_worst_first() {
        assert!(status_severity("error") > status_severity("pending"));
        assert!(status_severity("blocked") > status_severity("satisfied"));
        assert!(status_severity("satisfied") > status_severity("disabled"));
        assert_eq!(status_severity("adjusted"), status_severity("incomplete"));
    }
}