forked from 1b-agent/opencadstudio-upstream
638 lines
25 KiB
Rust
638 lines
25 KiB
Rust
//! Centralized UI Theme Accessibility & Contrast Test Suite.
|
|
//!
|
|
//! Evaluates WCAG 2.1 contrast ratios across all 22 built-in themes for every
|
|
//! major OpenCADStudio UI domain:
|
|
//! - Core Theme Palettes (base, weak, strong, weakest)
|
|
//! - Ribbon Bar (tabs, buttons, dropdown popups, contextual layout tab)
|
|
//! - Status Bar (active/inactive pills, coordinate readouts, dropdown carets)
|
|
//! - Command Line & History (input prompt, placeholder, option buttons, output logs)
|
|
//! - Properties & Dock Panels (field labels, section headers, muted text)
|
|
//! - Modals & Action Buttons (dialog body, Primary, Danger, Success buttons)
|
|
//! - Dropdowns & Selection Overlays (visual style picker, item checkmarks)
|
|
//! - Block Palette (card labels in normal/hover/pressed/placing states,
|
|
//! header icon buttons, empty-state muted text)
|
|
|
|
use crate::ui::style::common::{accessible_accent, accessible_accent_threshold, wcag_contrast};
|
|
use iced::{Color, Theme};
|
|
|
|
/// Composite a semi-transparent foreground color over a solid background color.
|
|
fn composite_over(fg: Color, bg: Color) -> Color {
|
|
let a = fg.a;
|
|
Color {
|
|
r: fg.r * a + bg.r * (1.0 - a),
|
|
g: fg.g * a + bg.g * (1.0 - a),
|
|
b: fg.b * a + bg.b * (1.0 - a),
|
|
a: 1.0,
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_theme_core_surfaces_contrast() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
|
|
// Base surface & text
|
|
let base_contrast = wcag_contrast(p.background.base.text, p.background.base.color);
|
|
assert!(
|
|
base_contrast >= 4.5,
|
|
"Theme {:?} base text ({:.2}:1) fails WCAG AA on base background",
|
|
theme,
|
|
base_contrast
|
|
);
|
|
|
|
// Weak surface & text
|
|
let weak_contrast = wcag_contrast(p.background.weak.text, p.background.weak.color);
|
|
assert!(
|
|
weak_contrast >= 4.5,
|
|
"Theme {:?} weak text ({:.2}:1) fails WCAG AA on weak background",
|
|
theme,
|
|
weak_contrast
|
|
);
|
|
|
|
// Strong surface & text
|
|
let strong_contrast = wcag_contrast(p.background.strong.text, p.background.strong.color);
|
|
assert!(
|
|
strong_contrast >= 4.5,
|
|
"Theme {:?} strong text ({:.2}:1) fails WCAG AA on strong background",
|
|
theme,
|
|
strong_contrast
|
|
);
|
|
|
|
// Weakest surface & text
|
|
let weakest_contrast = wcag_contrast(p.background.weakest.text, p.background.weakest.color);
|
|
assert!(
|
|
weakest_contrast >= 4.5,
|
|
"Theme {:?} weakest text ({:.2}:1) fails WCAG AA on weakest background",
|
|
theme,
|
|
weakest_contrast
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_ribbon_contrast() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
|
|
// 1. Active Tab: rendered on background.weakest.color
|
|
let active_tab_bg = p.background.weakest.color;
|
|
let active_tab_text = p.background.weakest.text;
|
|
let active_contrast = wcag_contrast(active_tab_text, active_tab_bg);
|
|
assert!(
|
|
active_contrast >= 4.5,
|
|
"Theme {:?} active ribbon tab text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
active_contrast
|
|
);
|
|
|
|
// 2. Inactive Tab: rendered on ribbon background.base.color with 0.72 alpha
|
|
let ribbon_bg = p.background.base.color;
|
|
let inactive_tab_text = composite_over(p.background.base.text.scale_alpha(0.72), ribbon_bg);
|
|
let inactive_contrast = wcag_contrast(inactive_tab_text, ribbon_bg);
|
|
assert!(
|
|
inactive_contrast >= 3.0,
|
|
"Theme {:?} inactive ribbon tab text ({:.2}:1) fails secondary text threshold (>=3.0:1)",
|
|
theme,
|
|
inactive_contrast
|
|
);
|
|
|
|
// 3. Hovered Tab: rendered on background.weak.color
|
|
let hovered_tab_bg = p.background.weak.color;
|
|
let hovered_tab_text = p.background.weak.text;
|
|
let hovered_contrast = wcag_contrast(hovered_tab_text, hovered_tab_bg);
|
|
assert!(
|
|
hovered_contrast >= 4.5,
|
|
"Theme {:?} hovered ribbon tab text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
hovered_contrast
|
|
);
|
|
|
|
// 4. Ribbon Button normal & hover
|
|
let btn_normal = wcag_contrast(p.background.base.text, ribbon_bg);
|
|
assert!(
|
|
btn_normal >= 4.5,
|
|
"Theme {:?} normal ribbon button text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
btn_normal
|
|
);
|
|
|
|
let btn_hover_bg = p.background.weak.color;
|
|
let btn_hover_text = p.background.weak.text;
|
|
let btn_hover = wcag_contrast(btn_hover_text, btn_hover_bg);
|
|
assert!(
|
|
btn_hover >= 4.5,
|
|
"Theme {:?} hovered ribbon button text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
btn_hover
|
|
);
|
|
|
|
// 5. Ribbon Dropdown Popup Panels
|
|
let popup_bg = p.background.base.color;
|
|
let popup_row_normal = wcag_contrast(p.background.base.text, popup_bg);
|
|
assert!(
|
|
popup_row_normal >= 4.5,
|
|
"Theme {:?} ribbon popup normal row ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
popup_row_normal
|
|
);
|
|
|
|
let popup_row_hover_bg = p.background.weak.color;
|
|
let popup_row_hover_text = p.background.weak.text;
|
|
let popup_row_hover = wcag_contrast(popup_row_hover_text, popup_row_hover_bg);
|
|
assert!(
|
|
popup_row_hover >= 4.5,
|
|
"Theme {:?} ribbon popup hovered row ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
popup_row_hover
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_statusbar_contrast() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
let statusbar_bg = p.background.base.color;
|
|
|
|
// 1. Status Bar Coordinate & Scale Text (normal text: >= 4.5:1)
|
|
let label_contrast = wcag_contrast(p.background.base.text, statusbar_bg);
|
|
assert!(
|
|
label_contrast >= 4.5,
|
|
"Theme {:?} statusbar coordinate/scale text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
label_contrast
|
|
);
|
|
|
|
// 2. Inactive Pill: background is weakest.color, text is base.text with 0.72 alpha (UI badge: >= 3.0:1)
|
|
let pill_inactive_bg = p.background.weakest.color;
|
|
let pill_inactive_text =
|
|
composite_over(p.background.base.text.scale_alpha(0.72), pill_inactive_bg);
|
|
let pill_inactive_contrast = wcag_contrast(pill_inactive_text, pill_inactive_bg);
|
|
assert!(
|
|
pill_inactive_contrast >= 3.0,
|
|
"Theme {:?} inactive statusbar pill text ({:.2}:1) fails secondary text threshold (>=3.0:1)",
|
|
theme,
|
|
pill_inactive_contrast
|
|
);
|
|
|
|
// 3. Active Pill: UI badge component. WCAG 1.4.11 specifies >= 3.0:1 for UI components.
|
|
let pill_active_bg = p.primary.weak.color;
|
|
let pill_active_text = p.primary.weak.text;
|
|
let pill_active_contrast = wcag_contrast(pill_active_text, pill_active_bg);
|
|
assert!(
|
|
pill_active_contrast >= 3.0,
|
|
"Theme {:?} active statusbar pill text ({:.2}:1) fails UI component threshold (>=3.0:1)",
|
|
theme,
|
|
pill_active_contrast
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_command_line_contrast() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
let cli_bg = p.background.base.color;
|
|
|
|
// 1. Input Value Text (normal text: >= 4.5:1)
|
|
let input_contrast = wcag_contrast(p.background.base.text, cli_bg);
|
|
assert!(
|
|
input_contrast >= 4.5,
|
|
"Theme {:?} command line input text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
input_contrast
|
|
);
|
|
|
|
// 1b. Prompt ("Command:") text (normal text: >= 4.5:1)
|
|
let prompt_color = accessible_accent_threshold(
|
|
p.success.base.color,
|
|
cli_bg,
|
|
p.background.base.text,
|
|
4.5,
|
|
);
|
|
let prompt_contrast = wcag_contrast(prompt_color, cli_bg);
|
|
assert!(
|
|
prompt_contrast >= 4.5,
|
|
"Theme {:?} command prompt text ({:.2}:1) fails WCAG AA (>=4.5:1)",
|
|
theme,
|
|
prompt_contrast
|
|
);
|
|
|
|
// 2. Placeholder Text (0.72 alpha, secondary text: >= 3.0:1)
|
|
let placeholder = composite_over(p.background.base.text.scale_alpha(0.72), cli_bg);
|
|
let placeholder_contrast = wcag_contrast(placeholder, cli_bg);
|
|
assert!(
|
|
placeholder_contrast >= 3.0,
|
|
"Theme {:?} command line placeholder text ({:.2}:1) fails secondary text threshold (>=3.0:1)",
|
|
theme,
|
|
placeholder_contrast
|
|
);
|
|
|
|
// 3. Option Keyword Button: normal is weakest pair, hovered is primary.weak pair
|
|
let opt_normal_contrast =
|
|
wcag_contrast(p.background.weakest.text, p.background.weakest.color);
|
|
assert!(
|
|
opt_normal_contrast >= 4.5,
|
|
"Theme {:?} option button normal text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
opt_normal_contrast
|
|
);
|
|
|
|
let opt_hover_contrast = wcag_contrast(p.primary.weak.text, p.primary.weak.color);
|
|
assert!(
|
|
opt_hover_contrast >= 3.0,
|
|
"Theme {:?} option button hover text ({:.2}:1) fails UI component threshold (>=3.0:1)",
|
|
theme,
|
|
opt_hover_contrast
|
|
);
|
|
|
|
// 4. Command History Entries:
|
|
// EntryKind::Command -> background.base.text (normal text: >= 4.5:1)
|
|
let cmd_contrast = wcag_contrast(p.background.base.text, cli_bg);
|
|
assert!(
|
|
cmd_contrast >= 4.5,
|
|
"Theme {:?} history command text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
cmd_contrast
|
|
);
|
|
|
|
// EntryKind::Output -> background.base.text at 0.72 alpha (secondary text: >= 3.0:1)
|
|
let output_text = composite_over(p.background.base.text.scale_alpha(0.72), cli_bg);
|
|
let output_contrast = wcag_contrast(output_text, cli_bg);
|
|
assert!(
|
|
output_contrast >= 3.0,
|
|
"Theme {:?} history output text ({:.2}:1) fails secondary text threshold (>=3.0:1)",
|
|
theme,
|
|
output_contrast
|
|
);
|
|
|
|
// EntryKind::Info -> primary.base.color (with fallback if primary has low contrast)
|
|
let info_color =
|
|
accessible_accent_threshold(p.primary.base.color, cli_bg, p.background.base.text, 4.5);
|
|
let info_contrast = wcag_contrast(info_color, cli_bg);
|
|
|
|
// EntryKind::Error -> danger.base.color
|
|
let error_contrast = wcag_contrast(p.danger.base.color, cli_bg);
|
|
assert!(
|
|
info_contrast >= 4.5,
|
|
"Theme {:?} info text ({:.2}:1) fails WCAG AA normal text threshold (>=4.5:1)",
|
|
theme,
|
|
info_contrast
|
|
);
|
|
assert!(
|
|
error_contrast >= 2.0,
|
|
"Theme {:?} error text ({:.2}:1) fails non-text indicator threshold (>=2.0:1)",
|
|
theme,
|
|
error_contrast
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_properties_and_dock_contrast() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
let dock_bg = p.background.base.color;
|
|
|
|
// 1. Property Field Labels & Values
|
|
let label_contrast = wcag_contrast(p.background.base.text, dock_bg);
|
|
assert!(
|
|
label_contrast >= 4.5,
|
|
"Theme {:?} properties label text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
label_contrast
|
|
);
|
|
|
|
// 2. Muted Helper Text: muted_style uses background.base.text at 0.68 alpha
|
|
let muted_text = composite_over(p.background.base.text.scale_alpha(0.68), dock_bg);
|
|
let muted_contrast = wcag_contrast(muted_text, dock_bg);
|
|
assert!(
|
|
muted_contrast >= 3.0,
|
|
"Theme {:?} properties muted text ({:.2}:1) fails secondary text threshold (>=3.0:1)",
|
|
theme,
|
|
muted_contrast
|
|
);
|
|
|
|
// 3. Section Header: rendered on background.weakest.color
|
|
let header_bg = p.background.weakest.color;
|
|
let header_text = p.background.base.text;
|
|
let header_contrast = wcag_contrast(header_text, header_bg);
|
|
assert!(
|
|
header_contrast >= 4.0,
|
|
"Theme {:?} properties header text ({:.2}:1) fails header contrast threshold (>=4.0:1)",
|
|
theme,
|
|
header_contrast
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_modals_and_action_buttons_contrast() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
let modal_bg = p.background.base.color;
|
|
|
|
// 1. Modal Body Text (normal text: >= 4.5:1)
|
|
let body_contrast = wcag_contrast(p.background.base.text, modal_bg);
|
|
assert!(
|
|
body_contrast >= 4.5,
|
|
"Theme {:?} modal body text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
body_contrast
|
|
);
|
|
|
|
// 2. Primary Action Button: UI button component (WCAG 1.4.11 >= 3.0:1)
|
|
let primary_btn_contrast = wcag_contrast(p.primary.base.text, p.primary.base.color);
|
|
assert!(
|
|
primary_btn_contrast >= 3.0,
|
|
"Theme {:?} Primary button text ({:.2}:1) fails button threshold (>=3.0:1)",
|
|
theme,
|
|
primary_btn_contrast
|
|
);
|
|
|
|
// 3. Danger Action Button: UI button component (WCAG 1.4.11 >= 3.0:1)
|
|
let danger_btn_contrast = wcag_contrast(p.danger.base.text, p.danger.base.color);
|
|
assert!(
|
|
danger_btn_contrast >= 3.0,
|
|
"Theme {:?} Danger button text ({:.2}:1) fails button threshold (>=3.0:1)",
|
|
theme,
|
|
danger_btn_contrast
|
|
);
|
|
|
|
// 4. Success Action Button: UI button component (WCAG 1.4.11 >= 3.0:1)
|
|
let success_btn_contrast = wcag_contrast(p.success.base.text, p.success.base.color);
|
|
assert!(
|
|
success_btn_contrast >= 3.0,
|
|
"Theme {:?} Success button text ({:.2}:1) fails button threshold (>=3.0:1)",
|
|
theme,
|
|
success_btn_contrast
|
|
);
|
|
|
|
// 5. Modal Close Button Hover: danger.strong pair (WCAG 1.4.11 >= 3.0:1)
|
|
let close_hover_contrast = wcag_contrast(p.danger.strong.text, p.danger.strong.color);
|
|
assert!(
|
|
close_hover_contrast >= 3.0,
|
|
"Theme {:?} close button hover text ({:.2}:1) fails button threshold (>=3.0:1)",
|
|
theme,
|
|
close_hover_contrast
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_dropdowns_and_selection_overlays() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
|
|
// 1. Visual Style Dropdown Popup: background is weak.color
|
|
let dropdown_bg = p.background.weak.color;
|
|
|
|
// Selected / hovered text uses strong.text
|
|
let selected_contrast = wcag_contrast(p.background.strong.text, dropdown_bg);
|
|
assert!(
|
|
selected_contrast >= 4.5,
|
|
"Theme {:?} visual style selected text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
selected_contrast
|
|
);
|
|
|
|
// Inactive item text uses base.text
|
|
let inactive_contrast = wcag_contrast(p.background.base.text, dropdown_bg);
|
|
assert!(
|
|
inactive_contrast >= 4.5,
|
|
"Theme {:?} visual style inactive text ({:.2}:1) fails WCAG AA",
|
|
theme,
|
|
inactive_contrast
|
|
);
|
|
|
|
// 2. Active Checkmark with Dynamic Fallback
|
|
// Dropdown panel is background.weak.color; highlighted row can be strong.color.
|
|
let pri = p.primary.base.color;
|
|
let bg_weak = dropdown_bg;
|
|
let bg_strong = p.background.strong.color;
|
|
let fallback = p.background.weak.text;
|
|
let candidate = accessible_accent(pri, bg_weak, fallback);
|
|
let tick_color = if wcag_contrast(candidate, bg_strong) >= 3.0 {
|
|
candidate
|
|
} else {
|
|
fallback
|
|
};
|
|
let final_tick_contrast_weak = wcag_contrast(tick_color, dropdown_bg);
|
|
let final_tick_contrast_strong = wcag_contrast(tick_color, p.background.strong.color);
|
|
assert!(
|
|
final_tick_contrast_weak >= 3.0,
|
|
"Theme {:?} checkmark ({:.2}:1) against weak background fails UI threshold (>=3.0:1)",
|
|
theme,
|
|
final_tick_contrast_weak
|
|
);
|
|
assert!(
|
|
final_tick_contrast_strong >= 3.0,
|
|
"Theme {:?} checkmark ({:.2}:1) against strong background fails UI threshold (>=3.0:1)",
|
|
theme,
|
|
final_tick_contrast_strong
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_viewport_controls_toggle_buttons_contrast() {
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
|
|
// 1. Active Toggle Button (Grid & Snap):
|
|
// Background is primary.weak.color, icon uses primary.weak.text
|
|
let active_bg = p.primary.weak.color;
|
|
let active_icon = p.primary.weak.text;
|
|
let active_contrast = wcag_contrast(active_icon, active_bg);
|
|
assert!(
|
|
active_contrast >= 3.0,
|
|
"Theme {:?} active viewport toggle button icon ({:.2}:1) fails UI threshold (>=3.0:1)",
|
|
theme,
|
|
active_contrast
|
|
);
|
|
|
|
// 2. Inactive Toggle Button:
|
|
// Background is transparent on the viewport HUD bar (background.base.color)
|
|
let inactive_icon = p.background.base.text;
|
|
let inactive_contrast = wcag_contrast(inactive_icon, p.background.base.color);
|
|
assert!(
|
|
inactive_contrast >= 4.5,
|
|
"Theme {:?} inactive viewport toggle button icon ({:.2}:1) fails WCAG AA (>=4.5:1)",
|
|
theme,
|
|
inactive_contrast
|
|
);
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn test_block_palette_contrast() {
|
|
use crate::ui::window::block_palette::{
|
|
block_card_border, block_card_colors, block_icon_button_text_color,
|
|
};
|
|
use iced::widget::button::Status as BtnStatus;
|
|
|
|
for theme in Theme::ALL {
|
|
let p = theme.palette();
|
|
|
|
// ── 1. Card label pairs resolve to the theme's own text colors ──
|
|
// Regression guard for the light-theme bug where labels were hardcoded
|
|
// to `Color::WHITE` (unreadable white-on-light). If anyone reintroduces
|
|
// a hardcoded foreground, these equality checks fail on every theme
|
|
// whose surface text is not pure white.
|
|
let (normal_bg, normal_fg) = block_card_colors(theme, false, BtnStatus::Active);
|
|
assert_eq!(
|
|
normal_bg, p.background.base.color,
|
|
"Theme {:?} block card normal background drifted from base pair",
|
|
theme
|
|
);
|
|
assert_eq!(
|
|
normal_fg, p.background.base.text,
|
|
"Theme {:?} block card normal label must use base text (was hardcoded WHITE)",
|
|
theme
|
|
);
|
|
|
|
let (_, hover_fg) = block_card_colors(theme, false, BtnStatus::Hovered);
|
|
assert_eq!(
|
|
hover_fg, p.background.strong.text,
|
|
"Theme {:?} block card hover label must use strong text (was hardcoded WHITE)",
|
|
theme
|
|
);
|
|
|
|
let (_, pressed_fg) = block_card_colors(theme, false, BtnStatus::Pressed);
|
|
assert_eq!(
|
|
pressed_fg, p.background.strong.text,
|
|
"Theme {:?} block card pressed label must use strong text (was hardcoded WHITE)",
|
|
theme
|
|
);
|
|
|
|
// Default-branch statuses (Active/Disabled/Focused/...) share the base pair.
|
|
let (_, disabled_fg) = block_card_colors(theme, false, BtnStatus::Disabled);
|
|
assert_eq!(
|
|
disabled_fg, p.background.base.text,
|
|
"Theme {:?} block card default-state label must use base text",
|
|
theme
|
|
);
|
|
|
|
// Placing (selected) cards always use the primary pair, regardless of
|
|
// hover — the background does not switch on hover while placing.
|
|
for status in [BtnStatus::Active, BtnStatus::Hovered, BtnStatus::Pressed] {
|
|
let (bg, fg) = block_card_colors(theme, true, status);
|
|
assert_eq!(bg, p.primary.base.color, "Theme {:?} placing card bg must be primary.base", theme);
|
|
assert_eq!(fg, p.primary.base.text, "Theme {:?} placing card label must be primary.base.text", theme);
|
|
}
|
|
|
|
// ── 2. Card label contrast: normal / hover / pressed ──
|
|
// 11px single-line labels are normal text → WCAG AA >= 4.5:1.
|
|
let normal_contrast = wcag_contrast(normal_fg, normal_bg);
|
|
assert!(
|
|
normal_contrast >= 4.5,
|
|
"Theme {:?} block card label ({:.2}:1) fails WCAG AA on card background",
|
|
theme, normal_contrast
|
|
);
|
|
|
|
let (hover_bg, hover_fg) = block_card_colors(theme, false, BtnStatus::Hovered);
|
|
let hover_contrast = wcag_contrast(hover_fg, hover_bg);
|
|
assert!(
|
|
hover_contrast >= 4.5,
|
|
"Theme {:?} block card hovered label ({:.2}:1) fails WCAG AA on hovered background",
|
|
theme, hover_contrast
|
|
);
|
|
|
|
let (pressed_bg, pressed_fg) = block_card_colors(theme, false, BtnStatus::Pressed);
|
|
let pressed_contrast = wcag_contrast(pressed_fg, pressed_bg);
|
|
assert!(
|
|
pressed_contrast >= 4.5,
|
|
"Theme {:?} block card pressed label ({:.2}:1) fails WCAG AA on pressed background",
|
|
theme, pressed_contrast
|
|
);
|
|
|
|
// ── 3. Placing card contrast ──
|
|
// Selected-card label on `primary.base`: UI button component threshold
|
|
// (>= 3.0:1 per WCAG 1.4.11, matching the Primary-button test above).
|
|
let (placing_bg, placing_fg) = block_card_colors(theme, true, BtnStatus::Active);
|
|
let placing_contrast = wcag_contrast(placing_fg, placing_bg);
|
|
assert!(
|
|
placing_contrast >= 3.0,
|
|
"Theme {:?} placing block card label ({:.2}:1) fails button threshold (>=3.0:1)",
|
|
theme, placing_contrast
|
|
);
|
|
// Placing + hover must not silently drop contrast (bg is sticky).
|
|
let (placing_hover_bg, placing_hover_fg) =
|
|
block_card_colors(theme, true, BtnStatus::Hovered);
|
|
let placing_hover_contrast = wcag_contrast(placing_hover_fg, placing_hover_bg);
|
|
assert!(
|
|
placing_hover_contrast >= 3.0,
|
|
"Theme {:?} placing+hover block card label ({:.2}:1) fails button threshold (>=3.0:1)",
|
|
theme, placing_hover_contrast
|
|
);
|
|
|
|
// ── 4. Card border is theme-driven (no invisible borders) ──
|
|
assert_eq!(
|
|
block_card_border(theme, false),
|
|
p.background.neutral.color,
|
|
"Theme {:?} block card border must use neutral color",
|
|
theme
|
|
);
|
|
assert_eq!(
|
|
block_card_border(theme, true),
|
|
p.primary.base.color,
|
|
"Theme {:?} placing block card border must use primary color",
|
|
theme
|
|
);
|
|
|
|
// ── 5. Header icon buttons (glyphs inherit button text_color) ──
|
|
// Resting buttons are transparent over the dock (`base`) background.
|
|
let icon_rest = block_icon_button_text_color(theme, BtnStatus::Active);
|
|
assert_eq!(icon_rest, p.background.base.text);
|
|
let icon_rest_contrast = wcag_contrast(icon_rest, p.background.base.color);
|
|
assert!(
|
|
icon_rest_contrast >= 4.5,
|
|
"Theme {:?} block palette icon button ({:.2}:1) fails WCAG AA on dock background",
|
|
theme, icon_rest_contrast
|
|
);
|
|
// Hovered/pressed buttons sit on the `strong` surface with its text.
|
|
for status in [BtnStatus::Hovered, BtnStatus::Pressed] {
|
|
let icon_fg = block_icon_button_text_color(theme, status);
|
|
assert_eq!(
|
|
icon_fg, p.background.strong.text,
|
|
"Theme {:?} hovered icon button must use strong text",
|
|
theme
|
|
);
|
|
let c = wcag_contrast(icon_fg, p.background.strong.color);
|
|
assert!(
|
|
c >= 4.5,
|
|
"Theme {:?} hovered icon button ({:.2}:1) fails WCAG AA on hovered background",
|
|
theme, c
|
|
);
|
|
}
|
|
|
|
// ── 6. Empty-state muted text ("No blocks in this drawing") ──
|
|
// Rendered as `base.text` at 0.72 alpha over the dock `base`
|
|
// background → secondary text threshold >= 3.0:1. (The old hardcoded
|
|
// 0.55-gray failed this on light themes.)
|
|
let empty_text = composite_over(p.background.base.text.scale_alpha(0.72), p.background.base.color);
|
|
let empty_contrast = wcag_contrast(empty_text, p.background.base.color);
|
|
assert!(
|
|
empty_contrast >= 3.0,
|
|
"Theme {:?} block palette empty-state text ({:.2}:1) fails secondary text threshold (>=3.0:1)",
|
|
theme, empty_contrast
|
|
);
|
|
|
|
// ── 7. Hardcoded-white regression probe ──
|
|
// The exact reported bug: pure white labels on the light card
|
|
// background. Every theme's card background must NOT be near-white
|
|
// with white text — i.e. white-on-card must fail while the real
|
|
// theme pair passes (proves the fix matters on light themes and the
|
|
// test would catch a WHITE hardcode).
|
|
let white_on_normal = wcag_contrast(Color::WHITE, normal_bg);
|
|
if white_on_normal < 4.5 {
|
|
assert!(
|
|
normal_contrast >= 4.5,
|
|
"Theme {:?} needs theme-aware labels: white-on-card is {:.2}:1 but theme pair is {:.2}:1",
|
|
theme, white_on_normal, normal_contrast
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|