Merge pull request #11 from refactorfirst/implement-dark-mode

#5 Implement Dark Mode

Author: jimbethancourt

AGENTS.md

@@ -10,8 +10,21 @@ in `out/` is served by any static host (GitHub Pages, GitLab Pages, Bitbucket).
 
 **Key Features:**
 - Search over curated repository listing (`repositories.txt`)
-- Breadcrumb trail under the menu (`components/breadcrumbs.jsx` +
-  `lib/breadcrumbs.js`): mirrors `/user/repo/branch` with linked ancestors;
+- Dark mode, 100% CSS switching (`components/theme-toggle.jsx` +
+  `plans/css-only-dark-mode.md`): three radios (light/dark/system) on the
+  right side of the `.theme-bar` row below the header, rendered by
+  `app/layout.jsx` — the breadcrumb trail shares the row on report routes
+  (crumbs left, toggle right, vertically centered; the right-edge mirror
+  of the breadcrumbs' left-edge alignment) — palettes selected in
+  `app/globals.css` via `:root:has(#rf-theme-…:checked)` +
+  `prefers-color-scheme`; an inline pre-paint script in `app/layout.jsx`
+  only restores/persists the choice (CSP-hashed by the build). Guards:
+  `tests/unit/theme-css.test.js` (the two dark blocks must stay
+  byte-identical; all hex colors live in the palette blocks; dark palette
+  passes the same WCAG AA math as `tests/unit/css-a11y.test.js`)
+- Breadcrumb trail on the theme bar row under the menu
+  (`components/breadcrumbs.jsx` + `lib/breadcrumbs.js`): mirrors
+  `/user/repo/branch` with linked ancestors;
   the repo crumb never self-links, and ReportView announces the resolved
   branch (`rf:branch-resolved` event) so the label matches the loaded report
   (`main` 404 → `master` fallback)
@@ -130,6 +143,14 @@ coverage there when introducing new markup patterns.
 - **Environment config:** meta tags in `app/layout.jsx` (`submission-target`,
   `sentry-dsn`, `platform-base-url`) plus `NEXT_PUBLIC_HOSTING_ENVIRONMENT`
   / `NEXT_PUBLIC_BASE_PATH` at build time.
+- **Theming:** see the dark-mode bullet above — the radios in
+  `components/theme-toggle.jsx` are the single source of truth; never add
+  JS-driven styling. All colors must be custom properties declared only in
+  the four palette blocks (`:root`, `html:root` mvp overrides, and the two
+  identical dark blocks) in `app/globals.css`; mvp.css light overrides must
+  stay on `html:root` (mvp loads after the bundle). Report-template
+  widgets that hardcode light colors are re-driven from `main#app …`
+  rules there (the mustache stays byte-identical).
 
 ## Report Tables (Enhanced)
 
@@ -178,7 +199,7 @@ coverage there when introducing new markup patterns.
 
 ## Current Test Count
 
-~543 unit/integration + ~202 E2E (~198 across three browsers + 4 basePath leg).
+~584 unit/integration + ~229 E2E (~202 across three browsers + 4 basePath leg + 27 dark mode).
 
 WCAG 2.2 AA / HTML5 guards live in tests/unit/html5-attributes.test.js,
 tests/unit/report-template-wcag.test.js, tests/unit/css-a11y.test.js and