uzor 1.5.5

Core UI engine — geometry, interaction, input state
Documentation
//! Token-contract implementation of [`ChromeTheme`](super::theme::ChromeTheme)
//! (H1 token contract design §3; companion table
//! `docs/uzor/plans/h1-component-tokens-2026-09-24.md`, "chrome" section).
//! Same shape as `atomic/button/tokens.rs`, the worked example.
//!
//! [`ChromeTokens`] holds one pre-rendered `String` per `ChromeTheme` method —
//! every method on this trait is required (no default bodies), so every
//! field is owned here.
//!
//! Built once per [`crate::tokens::set::Tokens`]
//! ([`crate::tokens::set::TokenSet::resolve`]), never recomputed per paint
//! call.

use crate::tokens::{component_tokens, ColorSpec, ColorValue, Role};

component_tokens! {
    widget = "chrome",
    struct ChromeTokens, keys = CHROME_KEYS;

    background   => ColorSpec::Alias(Role::SurfaceAppChrome, None),

    icon_normal  => ColorSpec::Alias(Role::TextSecondary, None),
    icon_hover   => ColorSpec::Alias(Role::TextPrimary, None),

    button_hover => ColorSpec::Alias(Role::SurfaceControlHover, None),
    // Was the literal Windows close-app hover-red `#e81123` — broke the
    // high_contrast_mono set's grayscale contract (one meaning per role, H1
    // Brief 9 item b). Aliased onto `status.danger`, which is `#ffffff` in
    // high_contrast_mono and `#f23645` everywhere else.
    close_hover  => ColorSpec::Alias(Role::StatusDanger, None),
    // Overridden to `surface.app_chrome` in high_contrast_mono, where
    // `status.danger` and `text.primary` are both white (see
    // `builtin/high_contrast_mono.json`'s `component.chrome.close_icon_hover`).
    close_icon_hover => ColorSpec::Alias(Role::TextPrimary, None),

    separator    => ColorSpec::Alias(Role::BorderDefault, None),

    tab_bg_normal   => ColorSpec::Literal(ColorValue::Transparent),
    tab_bg_hover    => ColorSpec::Alias(Role::SurfaceControlHover, None),
    tab_bg_active   => ColorSpec::Alias(Role::SurfaceFloating, None),
    tab_text_normal => ColorSpec::Alias(Role::TextSecondary, None),
    tab_text_hover  => ColorSpec::Alias(Role::TextPrimary, None),
    tab_text_active => ColorSpec::Alias(Role::TextOnAccent, None),
    tab_accent      => ColorSpec::Alias(Role::AccentDefault, None),

    drag_zone_bg => ColorSpec::Literal(ColorValue::Transparent),

    tooltip_bg   => ColorSpec::Alias(Role::SurfaceControlHover, None),
    tooltip_text => ColorSpec::Alias(Role::TextOnAccent, None),
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::tokens::{BuiltinSet, Tokens};

    #[test]
    fn every_chrome_key_is_registered() {
        let keys = crate::tokens::component_keys("chrome").expect("chrome must be registered");
        assert_eq!(keys, CHROME_KEYS);
        assert_eq!(keys.len(), 17, "one entry per ChromeTokens field");
        assert!(keys.contains(&"tab_accent"));
    }

    #[test]
    fn dark_defaults_match_the_companion_table() {
        let tokens = Tokens::builtin(BuiltinSet::Dark);
        let c = tokens.chrome();
        assert_eq!(c.background, "#131722");
        assert_eq!(c.icon_normal, "#b2b5be");
        assert_eq!(c.icon_hover, "#d1d4dc");
        assert_eq!(c.button_hover, "#2a2e39");
        assert_eq!(c.close_hover, "#f23645");
        assert_eq!(c.close_icon_hover, "#d1d4dc");
        assert_eq!(c.separator, "#363a45");
        assert_eq!(c.tab_bg_normal, "transparent");
        assert_eq!(c.tab_bg_hover, "#2a2e39");
        assert_eq!(c.tab_bg_active, "#1e222d");
        assert_eq!(c.tab_text_normal, "#b2b5be");
        assert_eq!(c.tab_text_hover, "#d1d4dc");
        assert_eq!(c.tab_text_active, "#d1d4dc");
        assert_eq!(c.tab_accent, "#2962ff");
        assert_eq!(c.drag_zone_bg, "transparent");
        assert_eq!(c.tooltip_bg, "#2a2e39");
        assert_eq!(c.tooltip_text, "#d1d4dc");
    }

    /// `high_contrast_mono` overrides `close_icon_hover` to
    /// `surface.app_chrome` (black) because its `status.danger` (the
    /// `close_hover` background) and `text.primary` (the default alias)
    /// are both white — without the override the hovered close-app X is
    /// invisible (chrome golden defect 10b-1a). Every other built-in set
    /// keeps the `text.primary` default, same as `icon_hover`.
    #[test]
    fn only_high_contrast_mono_overrides_close_icon_hover() {
        let dark = Tokens::builtin(BuiltinSet::Dark);
        let light = Tokens::builtin(BuiltinSet::Light);
        let hc = Tokens::builtin(BuiltinSet::HighContrast);
        let hc_mono = Tokens::builtin(BuiltinSet::HighContrastMono);

        assert_eq!(dark.chrome().close_icon_hover, dark.chrome().icon_hover);
        assert_eq!(light.chrome().close_icon_hover, light.chrome().icon_hover);
        assert_eq!(hc.chrome().close_icon_hover, hc.chrome().icon_hover);

        assert_eq!(hc_mono.chrome().close_icon_hover, hc_mono.chrome().background);
        assert_ne!(hc_mono.chrome().close_icon_hover, hc_mono.chrome().close_hover);
    }
}