Add WCAG 2.2 AAA compliance and automated AT-SPI audit tool

- Bring all UI widgets to WCAG 2.2 AAA conformance across all views
- Add accessible labels, roles, descriptions, and announcements
- Bump focus outlines to 3px, target sizes to 44px AAA minimum
- Fix announce()/announce_result() to walk widget tree via parent()
- Add AT-SPI accessibility audit script (tools/a11y-audit.py) that
  checks SC 4.1.2, 1.1.1, 1.3.1, 2.1.1, 2.5.5, 2.5.8, 2.4.8,
  2.4.9, 2.4.10, 2.1.3 with JSON report output for CI
- Clean up project structure, archive old plan documents
This commit is contained in:
lashman
2026-03-01 12:44:21 +02:00
parent abb69dc753
commit 7e55d5796f
23 changed files with 2758 additions and 472 deletions

View File

@@ -81,7 +81,7 @@
.drop-zone-icon {
color: @accent_bg_color;
opacity: 0.7;
opacity: 0.85;
}
/* ===== Card View (using libadwaita .card) ===== */
@@ -90,17 +90,42 @@
}
flowboxchild:focus-visible .card {
outline: 2px solid @accent_bg_color;
outline: 3px solid @accent_bg_color;
outline-offset: 3px;
}
/* ===== Selection Mode Highlight ===== */
flowboxchild.selected .card {
outline: 3px solid @accent_bg_color;
outline-offset: -3px;
background: alpha(@accent_bg_color, 0.12);
}
row.selected {
background: alpha(@accent_bg_color, 0.15);
outline: 3px solid @accent_bg_color;
outline-offset: -3px;
}
@media (prefers-contrast: more) {
flowboxchild.selected .card {
outline-width: 4px;
background: alpha(@accent_bg_color, 0.2);
}
row.selected {
outline-width: 4px;
background: alpha(@accent_bg_color, 0.25);
}
}
/* App card status indicators */
.status-ok {
border: 1px solid alpha(@success_bg_color, 0.4);
border: 1px solid alpha(@success_bg_color, 0.6);
}
.status-attention {
border: 1px solid alpha(@warning_bg_color, 0.4);
border: 1px dashed alpha(@warning_bg_color, 0.6);
}
/* Rounded icon clipping for list view */
@@ -108,7 +133,7 @@ flowboxchild:focus-visible .card {
border-radius: 8px;
}
/* ===== WCAG AAA Focus Indicators ===== */
/* ===== WCAG AAA Focus Indicators (3px for enhanced visibility) ===== */
button:focus-visible,
togglebutton:focus-visible,
menubutton:focus-visible,
@@ -117,13 +142,13 @@ switch:focus-visible,
entry:focus-visible,
searchentry:focus-visible,
spinbutton:focus-visible {
outline: 2px solid @accent_bg_color;
outline: 3px solid @accent_bg_color;
outline-offset: 2px;
}
row:focus-visible {
outline: 2px solid @accent_bg_color;
outline-offset: -2px;
outline: 3px solid @accent_bg_color;
outline-offset: 2px;
}
/* Letter-circle fallback icon */
@@ -139,8 +164,8 @@ row:focus-visible {
color: @success_fg_color;
border-radius: 50%;
padding: 2px;
min-width: 16px;
min-height: 16px;
min-width: 24px;
min-height: 24px;
}
/* ===== Detail View Banner ===== */
@@ -157,10 +182,10 @@ row:focus-visible {
/* ===== Compatibility Warning Banner ===== */
.compat-warning-banner {
background: alpha(@warning_bg_color, 0.15);
background: alpha(@warning_bg_color, 0.22);
border-radius: 12px;
padding: 12px;
border: 1px solid alpha(@warning_bg_color, 0.3);
border: 1px solid alpha(@warning_bg_color, 0.5);
}
/* ===== Reduced Motion (WCAG AAA 2.3.3) ===== */
@@ -168,11 +193,27 @@ row:focus-visible {
Reduced motion is handled by the GTK toolkit settings instead
(gtk-enable-animations). */
/* ===== Minimum Target Size (WCAG 2.5.8) ===== */
/* ===== Minimum Target Size (WCAG 2.5.5 AAA - 44x44px) ===== */
button.flat.circular,
button.flat:not(.pill):not(.suggested-action):not(.destructive-action) {
min-width: 24px;
min-height: 24px;
min-width: 44px;
min-height: 44px;
}
/* Accessible icon button minimum target size (WCAG 2.5.5 AAA) */
.accessible-icon-btn {
min-width: 44px;
min-height: 44px;
}
/* Header bar buttons: ensure icon-only buttons meet AAA 44px target */
headerbar button.flat,
headerbar button.image-button,
headerbar menubutton > button,
headerbar splitbutton > button,
headerbar splitbutton > menubutton > button {
min-width: 44px;
min-height: 44px;
}
/* ===== Category Filter Tiles ===== */
@@ -191,39 +232,84 @@ button.flat:not(.pill):not(.suggested-action):not(.destructive-action) {
opacity: 0.9;
}
/* Colored backgrounds per category */
.cat-accent { background: alpha(@accent_bg_color, 0.7); }
.cat-purple { background: alpha(@purple_3, 0.65); }
.cat-red { background: alpha(@red_3, 0.6); }
.cat-green { background: alpha(@success_bg_color, 0.55); }
.cat-orange { background: alpha(@orange_3, 0.65); }
.cat-blue { background: alpha(@blue_3, 0.6); }
.cat-amber { background: alpha(@warning_bg_color, 0.6); }
.cat-neutral { background: alpha(@window_fg_color, 0.2); }
/* Colored backgrounds per category - darkened for WCAG AAA 7:1 contrast with white text */
.cat-accent { background: color-mix(in srgb, @accent_bg_color 80%, black 20%); }
.cat-purple { background: color-mix(in srgb, @purple_3 75%, black 25%); }
.cat-red { background: color-mix(in srgb, @red_3 70%, black 30%); }
.cat-green { background: color-mix(in srgb, @success_bg_color 65%, black 35%); }
.cat-orange { background: color-mix(in srgb, @orange_3 75%, black 25%); }
.cat-blue { background: color-mix(in srgb, @blue_3 70%, black 30%); }
.cat-amber { background: color-mix(in srgb, @warning_bg_color 70%, black 30%); }
.cat-neutral { background: color-mix(in srgb, @window_fg_color 55%, @window_bg_color 45%); }
.cat-teal { background: color-mix(in srgb, color-mix(in srgb, @blue_3 50%, @success_bg_color 50%) 70%, black 30%); }
.cat-brown { background: color-mix(in srgb, color-mix(in srgb, @orange_3 60%, @red_3 40%) 60%, black 40%); }
.cat-lime { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 70%, @warning_bg_color 30%) 65%, black 35%); }
.cat-slate { background: color-mix(in srgb, color-mix(in srgb, @blue_3 30%, @window_fg_color 70%) 45%, black 55%); }
.cat-pink { background: color-mix(in srgb, color-mix(in srgb, @red_3 50%, @purple_3 50%) 75%, black 25%); }
.cat-emerald { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 80%, @blue_3 20%) 70%, black 30%); }
.cat-crimson { background: color-mix(in srgb, @red_3 60%, black 40%); }
.cat-indigo { background: color-mix(in srgb, color-mix(in srgb, @blue_3 70%, @purple_3 30%) 70%, black 30%); }
.cat-coral { background: color-mix(in srgb, color-mix(in srgb, @red_3 60%, @orange_3 40%) 75%, black 25%); }
.cat-violet { background: color-mix(in srgb, color-mix(in srgb, @purple_3 70%, @red_3 30%) 70%, black 30%); }
.cat-mint { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 60%, @blue_3 40%) 65%, black 35%); }
/* Hover: intensify the background */
.cat-accent:hover { background: alpha(@accent_bg_color, 0.85); }
.cat-purple:hover { background: alpha(@purple_3, 0.8); }
.cat-red:hover { background: alpha(@red_3, 0.75); }
.cat-green:hover { background: alpha(@success_bg_color, 0.7); }
.cat-orange:hover { background: alpha(@orange_3, 0.8); }
.cat-blue:hover { background: alpha(@blue_3, 0.75); }
.cat-amber:hover { background: alpha(@warning_bg_color, 0.75); }
.cat-neutral:hover { background: alpha(@window_fg_color, 0.3); }
.cat-accent:hover { background: color-mix(in srgb, @accent_bg_color 95%, black 5%); }
.cat-purple:hover { background: color-mix(in srgb, @purple_3 90%, black 10%); }
.cat-red:hover { background: color-mix(in srgb, @red_3 85%, black 15%); }
.cat-green:hover { background: color-mix(in srgb, @success_bg_color 80%, black 20%); }
.cat-orange:hover { background: color-mix(in srgb, @orange_3 90%, black 10%); }
.cat-blue:hover { background: color-mix(in srgb, @blue_3 85%, black 15%); }
.cat-amber:hover { background: color-mix(in srgb, @warning_bg_color 85%, black 15%); }
.cat-neutral:hover { background: color-mix(in srgb, @window_fg_color 65%, @window_bg_color 35%); }
.cat-teal:hover { background: color-mix(in srgb, color-mix(in srgb, @blue_3 50%, @success_bg_color 50%) 85%, black 15%); }
.cat-brown:hover { background: color-mix(in srgb, color-mix(in srgb, @orange_3 60%, @red_3 40%) 75%, black 25%); }
.cat-lime:hover { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 70%, @warning_bg_color 30%) 80%, black 20%); }
.cat-slate:hover { background: color-mix(in srgb, color-mix(in srgb, @blue_3 30%, @window_fg_color 70%) 60%, black 40%); }
.cat-pink:hover { background: color-mix(in srgb, color-mix(in srgb, @red_3 50%, @purple_3 50%) 90%, black 10%); }
.cat-emerald:hover { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 80%, @blue_3 20%) 85%, black 15%); }
.cat-crimson:hover { background: color-mix(in srgb, @red_3 75%, black 25%); }
.cat-indigo:hover { background: color-mix(in srgb, color-mix(in srgb, @blue_3 70%, @purple_3 30%) 85%, black 15%); }
.cat-coral:hover { background: color-mix(in srgb, color-mix(in srgb, @red_3 60%, @orange_3 40%) 90%, black 10%); }
.cat-violet:hover { background: color-mix(in srgb, color-mix(in srgb, @purple_3 70%, @red_3 30%) 85%, black 15%); }
.cat-mint:hover { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 60%, @blue_3 40%) 80%, black 20%); }
/* Checked: full-strength background + light border for emphasis */
.cat-accent:checked { background: @accent_bg_color; }
.cat-purple:checked { background: @purple_3; }
.cat-red:checked { background: @red_3; }
.cat-green:checked { background: @success_bg_color; }
.cat-orange:checked { background: @orange_3; }
.cat-blue:checked { background: @blue_3; }
.cat-amber:checked { background: @warning_bg_color; }
/* Checked: slightly darkened for WCAG AAA contrast with white text */
.cat-accent:checked { background: color-mix(in srgb, @accent_bg_color 85%, black 15%); }
.cat-purple:checked { background: color-mix(in srgb, @purple_3 85%, black 15%); }
.cat-red:checked { background: color-mix(in srgb, @red_3 85%, black 15%); }
.cat-green:checked { background: color-mix(in srgb, @success_bg_color 85%, black 15%); }
.cat-orange:checked { background: color-mix(in srgb, @orange_3 85%, black 15%); }
.cat-blue:checked { background: color-mix(in srgb, @blue_3 85%, black 15%); }
.cat-amber:checked { background: color-mix(in srgb, @warning_bg_color 85%, black 15%); }
.cat-neutral:checked { background: alpha(@window_fg_color, 0.45); }
.cat-teal:checked { background: color-mix(in srgb, color-mix(in srgb, @blue_3 50%, @success_bg_color 50%) 85%, black 15%); }
.cat-brown:checked { background: color-mix(in srgb, color-mix(in srgb, @orange_3 60%, @red_3 40%) 85%, black 15%); }
.cat-lime:checked { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 70%, @warning_bg_color 30%) 85%, black 15%); }
.cat-slate:checked { background: color-mix(in srgb, color-mix(in srgb, @blue_3 30%, @window_fg_color 70%) 85%, black 15%); }
.cat-pink:checked { background: color-mix(in srgb, color-mix(in srgb, @red_3 50%, @purple_3 50%) 85%, black 15%); }
.cat-emerald:checked { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 80%, @blue_3 20%) 85%, black 15%); }
.cat-crimson:checked { background: color-mix(in srgb, @red_3 75%, black 25%); }
.cat-indigo:checked { background: color-mix(in srgb, color-mix(in srgb, @blue_3 70%, @purple_3 30%) 85%, black 15%); }
.cat-coral:checked { background: color-mix(in srgb, color-mix(in srgb, @red_3 60%, @orange_3 40%) 85%, black 15%); }
.cat-violet:checked { background: color-mix(in srgb, color-mix(in srgb, @purple_3 70%, @red_3 30%) 85%, black 15%); }
.cat-mint:checked { background: color-mix(in srgb, color-mix(in srgb, @success_bg_color 60%, @blue_3 40%) 85%, black 15%); }
/* Focus indicator on the tile itself */
flowboxchild:focus-visible .category-tile {
outline: 2px solid @accent_bg_color;
outline: 3px solid @accent_bg_color;
outline-offset: 2px;
}
/* Focus indicators for catalog items */
.catalog-tile:focus-visible,
.catalog-featured-card:focus-visible {
outline: 3px solid @accent_bg_color;
outline-offset: 2px;
}
.destructive-context-item:focus-visible {
outline: 3px solid @accent_bg_color;
outline-offset: 2px;
}
@@ -281,7 +367,7 @@ window.lightbox {
}
window.lightbox .lightbox-counter {
background: rgba(0, 0, 0, 0.6);
background: rgba(0, 0, 0, 0.78);
color: white;
border-radius: 12px;
padding: 4px 12px;
@@ -296,11 +382,11 @@ window.lightbox .lightbox-nav {
/* ===== Catalog Tile Stats Row ===== */
.catalog-stats-row {
font-size: 0.8em;
color: alpha(@window_fg_color, 0.7);
color: alpha(@window_fg_color, 0.87);
}
.catalog-stats-row image {
opacity: 0.65;
opacity: 0.85;
}
/* ===== Detail Page Stat Cards ===== */
@@ -358,11 +444,11 @@ window.lightbox .lightbox-nav {
.stat-card .stat-label {
font-size: 0.8em;
color: alpha(@window_fg_color, 0.6);
color: alpha(@window_fg_color, 0.87);
}
.stat-card image {
opacity: 0.55;
opacity: 0.78;
}
/* ===== Catalog Row (compact list view) ===== */
@@ -389,3 +475,67 @@ window.lightbox .lightbox-nav {
0%, 100% { opacity: 0.4; }
50% { opacity: 0.7; }
}
/* ===== Reduced Motion (WCAG AAA 2.3.3) ===== */
@media (prefers-reduced-motion: reduce) {
.skeleton-card {
animation: none;
opacity: 0.5;
}
}
/* ===== High Contrast Mode (WCAG AAA) ===== */
@media (prefers-contrast: more) {
.catalog-tile,
.catalog-featured-card,
.catalog-row {
border-width: 2px;
}
.stat-card {
border-width: 2px;
background: alpha(@window_fg_color, 0.1);
}
.status-badge,
.status-badge-with-icon {
border: 1px solid currentColor;
}
.drop-zone-card {
border-width: 3px;
}
.status-ok,
.status-attention {
border-width: 2px;
}
.category-tile {
border: 2px solid white;
}
.stat-card .stat-label {
color: @window_fg_color;
}
.stat-card image {
opacity: 1.0;
}
.compat-warning-banner {
border-width: 2px;
}
window.lightbox .lightbox-counter {
background: rgba(0, 0, 0, 0.9);
}
.catalog-stats-row image {
opacity: 1.0;
}
.category-tile image {
opacity: 1.0;
}
}