daniel/deepdrft
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 13 Wiki Activity

feat(theme): light-glass panels in light theme

Browse Source 
Queue, visualizer control deck, and privacy overlays now bind a theme-aware
--deepdrft-panel-* family (surface/text/text-muted/border/row-hover): light
translucent glass with dark text in light theme, unchanged dark-glass charcoal
in dark. Tokens re-declared in body.deepdrft-theme-dark for the body-portaled overlays.
This commit is contained in:
daniel-c-harvey
2026-06-20 00:59:22 -04:00
parent 494668bf24
commit 4c14c67c33
3 changed files with 62 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+1 -1
View File
@@ -80,7 +80,7 @@ Keep this seam clean — it is the most architecturally load-bearing part of the
- Dark mode toggles via cookie (`darkMode`, 365 days). Client-side via JS interop. - Dark mode toggles via cookie (`darkMode`, 365 days). Client-side via JS interop.
- During server prerender, `DarkModeService` (in `DeepDrftPublic`) reads the cookie and seeds `DarkModeSettings.IsDarkMode`, which carries into WASM render via `PersistentComponentState`. Avoids "wrong theme flash" on initial paint. - During server prerender, `DarkModeService` (in `DeepDrftPublic`) reads the cookie and seeds `DarkModeSettings.IsDarkMode`, which carries into WASM render via `PersistentComponentState`. Avoids "wrong theme flash" on initial paint.
- `DarkModeSettings` lives in `DeepDrftPublic.Client.Common` (consumed by both server prerender and client components). - `DarkModeSettings` lives in `DeepDrftPublic.Client.Common` (consumed by both server prerender and client components).
- **Theme-aware token layer:** `DeepDrftShared.Client/wwwroot/styles/deepdrft-tokens.css` defines two kinds of CSS custom properties. *Source tokens* (`--deepdrft-navy`, `--deepdrft-white`, `--deepdrft-green-accent`, etc.) are brand constants — identical in `:root` and `.deepdrft-theme-dark`. *Theme-aware aliases* are defined in both blocks and flip when the theme wrapper class changes. Component and page CSS must bind the **alias**, not the source token, so neutral surfaces invert for free. Current alias families: `--deepdrft-page-surface`/`-text`/`-text-muted` (neutral page backgrounds and text), `--deepdrft-play-chip`/`-glyph`/`-chip-soft` (play-state icon chip and glyph), `--deepdrft-popover-surface` (default MudBlazor popover background — light: `color-mix(navy 4%, white)`, a near-page-background surface; dark: references source token `--deepdrft-popover-surface-dark`, a `color-mix(navy-mid 80%, green-accent 20%)` bluer navy defined once in `:root` and referenced by both the `.deepdrft-theme-dark` wrapper block and `body.deepdrft-theme-dark` so portaled popovers are reached). Bespoke dark-glass panels (visualizer/queue/privacy) bind `--deepdrft-panel-ground` directly and are intentionally exempt from the neutral-surface alias. - **Theme-aware token layer:** `DeepDrftShared.Client/wwwroot/styles/deepdrft-tokens.css` defines two kinds of CSS custom properties. *Source tokens* (`--deepdrft-navy`, `--deepdrft-white`, `--deepdrft-green-accent`, etc.) are brand constants — identical in `:root` and `.deepdrft-theme-dark`. *Theme-aware aliases* are defined in both blocks and flip when the theme wrapper class changes. Component and page CSS must bind the **alias**, not the source token, so neutral surfaces invert for free. Current alias families: `--deepdrft-page-surface`/`-text`/`-text-muted` (neutral page backgrounds and text), `--deepdrft-play-chip`/`-glyph`/`-chip-soft` (play-state icon chip and glyph), `--deepdrft-popover-surface` (default MudBlazor popover background — light: `color-mix(navy 4%, white)`, a near-page-background surface; dark: references source token `--deepdrft-popover-surface-dark`, a `color-mix(navy-mid 80%, green-accent 20%)` bluer navy defined once in `:root` and referenced by both the `.deepdrft-theme-dark` wrapper block and `body.deepdrft-theme-dark` so portaled popovers are reached). The bespoke glass panels (visualizer/queue/privacy) now bind their own theme-aware `--deepdrft-panel-surface`/`-text`/`-text-muted`/`-border`/`-row-hover` family: dark-glass charcoal (sourced from the `--deepdrft-panel-ground` constant) with light text in dark theme, and a light translucent glass with dark text in light theme. These tokens are re-declared in `body.deepdrft-theme-dark` because the panels are MudOverlay panels that portal to `<body>` (same portal scope as popovers); the `--deepdrft-panel-ground` source token is now consumed only via the dark `--deepdrft-panel-surface` value.
- **Portaled-popover body-class bridge:** MudBlazor popovers portal to `<body>`, outside the `.deepdrft-theme-dark` wrapper `<div>`, so the dark popover token never reached them. Fix: `MainLayout.razor` stamps `deepdrft-theme-dark` on `<body>` via the `setBodyThemeClass(isDark)` helper in `DeepDrftShared.Client/Interop/theme/theme.ts` (lazy-imported as `_content/DeepDrftShared.Client/js/theme/theme.js`). The call fires only on first render or when `_isDarkMode` actually changes (gated by `_lastAppliedDarkMode` comparison) to avoid redundant JS calls on unrelated re-renders. The `body.deepdrft-theme-dark` selector in `deepdrft-tokens.css` resolves `--deepdrft-popover-surface` from `--deepdrft-popover-surface-dark` for these portaled elements. - **Portaled-popover body-class bridge:** MudBlazor popovers portal to `<body>`, outside the `.deepdrft-theme-dark` wrapper `<div>`, so the dark popover token never reached them. Fix: `MainLayout.razor` stamps `deepdrft-theme-dark` on `<body>` via the `setBodyThemeClass(isDark)` helper in `DeepDrftShared.Client/Interop/theme/theme.ts` (lazy-imported as `_content/DeepDrftShared.Client/js/theme/theme.js`). The call fires only on first render or when `_isDarkMode` actually changes (gated by `_lastAppliedDarkMode` comparison) to avoid redundant JS calls on unrelated re-renders. The `body.deepdrft-theme-dark` selector in `deepdrft-tokens.css` resolves `--deepdrft-popover-surface` from `--deepdrft-popover-surface-dark` for these portaled elements.
- Typography: Google Fonts (Bodoni Moda, Cormorant, DM Sans). Hand-rolled gas-lamp icon (lit/unlit) lives in `DeepDrftShared.Client/Common/DDIcons.cs`. - Typography: Google Fonts (Bodoni Moda, Cormorant, DM Sans). Hand-rolled gas-lamp icon (lit/unlit) lives in `DeepDrftShared.Client/Common/DDIcons.cs`.
DeepDrftPublic/wwwroot/styles/deepdrft-styles.css
+22 -21
View File
@@ -424,11 +424,11 @@ h2, h3, h4, h5, h6,
section labels are LIGHT (static). The slider track/thumb and the lamp toggles are green. section labels are LIGHT (static). The slider track/thumb and the lamp toggles are green.
============================================================================= */ ============================================================================= */
.waveform-visualizer-control-panel.mix-visualizer-controls-bar { .waveform-visualizer-control-panel.mix-visualizer-controls-bar {
/* Greyed panel ground — desaturated charcoal so the blue slider reads against it (defect #1). /* Theme-aware glass ground — dark charcoal in dark theme, light translucent glass in light
Token is tunable in deepdrft-tokens.css without touching this rule. */ (so the deck reads against the light page). Tunable in deepdrft-tokens.css. */
background: var(--deepdrft-panel-ground); background: var(--deepdrft-panel-surface);
/* Square corners + thin light border — NowPlayingCard chrome (§5). */ /* Square corners + thin theme-aware border — NowPlayingCard chrome (§5). */
border: 1px solid var(--deepdrft-border-light); border: 1px solid var(--deepdrft-panel-border);
border-radius: 0; border-radius: 0;
/* Optional backdrop blur — cheap on a small modal panel, nice over the visualizer (§5). */ /* Optional backdrop blur — cheap on a small modal panel, nice over the visualizer (§5). */
backdrop-filter: blur(8px); backdrop-filter: blur(8px);
@@ -445,7 +445,7 @@ h2, h3, h4, h5, h6,
--mud-palette-primary: var(--deepdrft-green-accent); /* knob arc/pointer + slider track/thumb (interactive) */ --mud-palette-primary: var(--deepdrft-green-accent); /* knob arc/pointer + slider track/thumb (interactive) */
--mud-palette-surface: var(--deepdrft-navy); /* knob center fill — darkest navy reads against the panel */ --mud-palette-surface: var(--deepdrft-navy); /* knob center fill — darkest navy reads against the panel */
--mud-palette-surface-variant: var(--deepdrft-muted); /* knob background track — muted-navy filler */ --mud-palette-surface-variant: var(--deepdrft-muted); /* knob background track — muted-navy filler */
--mud-palette-text-primary: var(--deepdrft-white); /* knob value label — light */ --mud-palette-text-primary: var(--deepdrft-panel-text); /* knob value label — flips dark on light glass */
} }
/* ── Row layout (§3). Each row is a horizontal band. Row 1 (MODE) and row 3 (WAVE) use /* ── Row layout (§3). Each row is a horizontal band. Row 1 (MODE) and row 3 (WAVE) use
@@ -492,7 +492,7 @@ h2, h3, h4, h5, h6,
font-size: 0.6rem; font-size: 0.6rem;
letter-spacing: 0.25em; letter-spacing: 0.25em;
text-transform: uppercase; text-transform: uppercase;
color: var(--deepdrft-white); color: var(--deepdrft-panel-text);
align-self: center; align-self: center;
flex: 0 0 auto; flex: 0 0 auto;
opacity: 0.85; opacity: 0.85;
@@ -838,8 +838,8 @@ body:has(.deepdrft-queue-overlay) {
width: min(90vw, 520px); width: min(90vw, 520px);
height: min(90vw, 520px); height: min(90vw, 520px);
max-height: 90vh; max-height: 90vh;
background: var(--deepdrft-panel-ground); background: var(--deepdrft-panel-surface);
border: 1px solid var(--deepdrft-border-light); border: 1px solid var(--deepdrft-panel-border);
border-radius: 0; border-radius: 0;
backdrop-filter: blur(8px); backdrop-filter: blur(8px);
overflow: hidden; overflow: hidden;
@@ -850,16 +850,16 @@ body:has(.deepdrft-queue-overlay) {
align-items: center; align-items: center;
justify-content: space-between; justify-content: space-between;
padding: 0.85rem 1rem; padding: 0.85rem 1rem;
border-bottom: 1px solid var(--deepdrft-border-light); border-bottom: 1px solid var(--deepdrft-panel-border);
} }
/* Mono uppercase eyebrow — the NowPlayingCard .np-label typography, recoloured light (static). */ /* Mono uppercase eyebrow — the NowPlayingCard .np-label typography, theme-aware (static). */
.deepdrft-queue-modal-title { .deepdrft-queue-modal-title {
font-family: var(--deepdrft-font-mono); font-family: var(--deepdrft-font-mono);
font-size: 0.72rem; font-size: 0.72rem;
letter-spacing: 0.2em; letter-spacing: 0.2em;
text-transform: uppercase; text-transform: uppercase;
color: var(--deepdrft-white); color: var(--deepdrft-panel-text);
opacity: 0.85; opacity: 0.85;
} }
@@ -887,12 +887,12 @@ body:has(.deepdrft-queue-overlay) {
gap: 0.6rem; gap: 0.6rem;
padding: 0.45rem 0.5rem; padding: 0.45rem 0.5rem;
border-radius: 4px; border-radius: 4px;
color: var(--deepdrft-white); color: var(--deepdrft-panel-text);
transition: background 0.15s ease; transition: background 0.15s ease;
} }
.deepdrft-queue-row:hover { .deepdrft-queue-row:hover {
background: color-mix(in srgb, var(--deepdrft-white) 6%, transparent); background: var(--deepdrft-panel-row-hover);
} }
/* Current track: a subtle green wash + left accent, matching the green = active principle. */ /* Current track: a subtle green wash + left accent, matching the green = active principle. */
@@ -997,8 +997,8 @@ body:has(.deepdrft-privacy-overlay) {
display: flex; display: flex;
flex-direction: column; flex-direction: column;
width: min(90vw, 480px); width: min(90vw, 480px);
background: var(--deepdrft-panel-ground); background: var(--deepdrft-panel-surface);
border: 1px solid var(--deepdrft-border-light); border: 1px solid var(--deepdrft-panel-border);
border-radius: 0; border-radius: 0;
backdrop-filter: blur(8px); backdrop-filter: blur(8px);
overflow: hidden; overflow: hidden;
@@ -1009,7 +1009,7 @@ body:has(.deepdrft-privacy-overlay) {
align-items: center; align-items: center;
justify-content: space-between; justify-content: space-between;
padding: 0.85rem 0.85rem 0.85rem 1rem; padding: 0.85rem 0.85rem 0.85rem 1rem;
border-bottom: 1px solid var(--deepdrft-border-light); border-bottom: 1px solid var(--deepdrft-panel-border);
} }
/* Mono uppercase eyebrow — matches queue modal title. */ /* Mono uppercase eyebrow — matches queue modal title. */
@@ -1018,27 +1018,28 @@ body:has(.deepdrft-privacy-overlay) {
font-size: 0.72rem; font-size: 0.72rem;
letter-spacing: 0.2em; letter-spacing: 0.2em;
text-transform: uppercase; text-transform: uppercase;
color: var(--deepdrft-white); color: var(--deepdrft-panel-text);
opacity: 0.85; opacity: 0.85;
} }
/* Tuck the close icon flush with the panel edge; keep it subtle. */ /* Tuck the close icon flush with the panel edge; keep it subtle. */
.deepdrft-privacy-modal-close { .deepdrft-privacy-modal-close {
opacity: 0.6; opacity: 0.6;
color: var(--deepdrft-white) !important; color: var(--deepdrft-panel-text) !important;
} }
.deepdrft-privacy-modal-close:hover { .deepdrft-privacy-modal-close:hover {
opacity: 1; opacity: 1;
} }
/* Privacy copy: same mono treatment as the former inline paragraph, but readable on dark ground. */ /* Privacy copy: same mono treatment as the former inline paragraph; theme-aware text colour
so it stays legible on both the dark-glass (dark) and light-glass (light) panel surfaces. */
.deepdrft-privacy-modal-body { .deepdrft-privacy-modal-body {
font-family: var(--deepdrft-font-mono); font-family: var(--deepdrft-font-mono);
font-size: 0.72rem; font-size: 0.72rem;
letter-spacing: 0.06em; letter-spacing: 0.06em;
line-height: 1.7; line-height: 1.7;
color: var(--deepdrft-white); color: var(--deepdrft-panel-text);
opacity: 0.8; opacity: 0.8;
margin: 0; margin: 0;
padding: 1rem 1rem 1.25rem; padding: 1rem 1rem 1.25rem;
DeepDrftShared.Client/wwwroot/styles/deepdrft-tokens.css
+39 -3
View File
@@ -28,9 +28,24 @@
(Phase 15 §4/§10.5). Mild so the panel reads as modal without a blackout. Change here once. */ (Phase 15 §4/§10.5). Mild so the panel reads as modal without a blackout. Change here once. */
--deepdrft-modal-scrim-alpha: 0.15; --deepdrft-modal-scrim-alpha: 0.15;
/* Panel ground — muted, desaturated charcoal beneath the controls panel. /* Panel ground — muted, desaturated charcoal beneath the controls panel.
Tunable: increase blue channel (e.g. #1e2235) to recover warmth, lower (e.g. #191b20) to go darker. */ Tunable: increase blue channel (e.g. #1e2235) to recover warmth, lower (e.g. #191b20) to go darker.
Source token; consumed by the theme-aware --deepdrft-panel-surface dark value below. */
--deepdrft-panel-ground: #1a1c22; --deepdrft-panel-ground: #1a1c22;
/* Glass-panel family — the bespoke overlay panels (queue / visualizer control deck / privacy).
Light values here make these panels a light translucent glass with dark text so they read
coherently against the light page; the .deepdrft-theme-dark block below reproduces today's
dark-glass charcoal exactly so dark mode is visually unchanged. Surface keeps the glassmorphic
translucency (paired with backdrop-blur in the consuming rules).
Light surface: near-page-surface white at 82% so the backdrop blur still shows through;
text/border are navy-based for legibility on the light glass. */
--deepdrft-panel-surface: rgba(250, 250, 248, 0.82);
--deepdrft-panel-text: var(--deepdrft-navy);
--deepdrft-panel-text-muted: var(--deepdrft-muted);
--deepdrft-panel-border: var(--deepdrft-border);
/* Row/hover wash on the panel surface — a navy tint on light, a white tint on dark (below). */
--deepdrft-panel-row-hover: color-mix(in srgb, var(--deepdrft-navy) 8%, transparent);
/* Wireframe font stack */ /* Wireframe font stack */
--deepdrft-font-display: "Cormorant Garamond", Georgia, serif; --deepdrft-font-display: "Cormorant Garamond", Georgia, serif;
--deepdrft-font-mono: "Geist Mono", monospace; --deepdrft-font-mono: "Geist Mono", monospace;
@@ -90,8 +105,9 @@
bluer navy (colour-mix of navy-mid + green-accent at 20%), defined once in bluer navy (colour-mix of navy-mid + green-accent at 20%), defined once in
--deepdrft-popover-surface-dark below and referenced by both the .deepdrft-theme-dark --deepdrft-popover-surface-dark below and referenced by both the .deepdrft-theme-dark
wrapper block and the body.deepdrft-theme-dark block so portaled popover content (which wrapper block and the body.deepdrft-theme-dark block so portaled popover content (which
portals to <body>, outside the wrapper div) is also reached. Bespoke dark-glass panels portals to <body>, outside the wrapper div) is also reached. The bespoke glass panels
(visualizer/queue/privacy) do NOT bind this — they keep --deepdrft-panel-ground. */ (visualizer/queue/privacy) do NOT bind this — they have their own theme-aware
--deepdrft-panel-* family (dark glass in dark theme, light glass in light). */
--deepdrft-popover-surface-dark: color-mix(in srgb, var(--deepdrft-navy-mid) 80%, var(--deepdrft-green-accent) 20%); --deepdrft-popover-surface-dark: color-mix(in srgb, var(--deepdrft-navy-mid) 80%, var(--deepdrft-green-accent) 20%);
--deepdrft-popover-surface: color-mix(in srgb, var(--deepdrft-navy) 4%, var(--deepdrft-white)); --deepdrft-popover-surface: color-mix(in srgb, var(--deepdrft-navy) 4%, var(--deepdrft-white));
@@ -172,6 +188,16 @@
non-portaled elements only (drawers, inline menus). Portaled MudBlazor popovers live at non-portaled elements only (drawers, inline menus). Portaled MudBlazor popovers live at
<body> level; the body.deepdrft-theme-dark block below uses the same source token. */ <body> level; the body.deepdrft-theme-dark block below uses the same source token. */
--deepdrft-popover-surface: var(--deepdrft-popover-surface-dark); --deepdrft-popover-surface: var(--deepdrft-popover-surface-dark);
/* Glass-panel family (dark) — reproduces today's dark-glass chrome EXACTLY. Surface is the
opaque charcoal ground the panels used directly before tokenisation; text is off-white;
border is the thin light-on-dark hairline (NowPlayingCard spirit); row hover is the prior
white 6% wash. Dark mode must look unchanged. */
--deepdrft-panel-surface: var(--deepdrft-panel-ground);
--deepdrft-panel-text: var(--deepdrft-white);
--deepdrft-panel-text-muted: color-mix(in srgb, var(--deepdrft-white) 60%, transparent);
--deepdrft-panel-border: var(--deepdrft-border-light);
--deepdrft-panel-row-hover: color-mix(in srgb, var(--deepdrft-white) 6%, transparent);
} }
/* Portal-scope dark popover surface. MudBlazor popovers (selects, menus, share body) portal /* Portal-scope dark popover surface. MudBlazor popovers (selects, menus, share body) portal
@@ -181,4 +207,14 @@
(navy-mid + 20% green-accent tint) rather than the pure charcoal #162437. */ (navy-mid + 20% green-accent tint) rather than the pure charcoal #162437. */
body.deepdrft-theme-dark { body.deepdrft-theme-dark {
--deepdrft-popover-surface: var(--deepdrft-popover-surface-dark); --deepdrft-popover-surface: var(--deepdrft-popover-surface-dark);
/* The bespoke glass panels (queue / visualizer / privacy) are MudOverlay panels that portal to
<body>, outside the .deepdrft-theme-dark wrapper div — same portal scope as popovers. Re-declare
the dark glass-panel family here so the panels resolve the dark (charcoal) values; without this
they would fall through to the light :root values while the page is in dark mode. */
--deepdrft-panel-surface: var(--deepdrft-panel-ground);
--deepdrft-panel-text: var(--deepdrft-white);
--deepdrft-panel-text-muted: color-mix(in srgb, var(--deepdrft-white) 60%, transparent);
--deepdrft-panel-border: var(--deepdrft-border-light);
--deepdrft-panel-row-hover: color-mix(in srgb, var(--deepdrft-white) 6%, transparent);
} }