docs: mark track-card plain-shell refactor completed

This commit is contained in:
daniel-c-harvey
2026-06-05 16:27:51 -04:00
parent 3c17260f32
commit 7c401d75b5
2 changed files with 471 additions and 0 deletions
+25
View File
@@ -60,6 +60,31 @@ Collapsed the two divergent Razor trees in `AudioPlayerBar.razor` (`@if (_isDesk
**Notes for future work:**
- First-render layout flash eliminated by construction (CSS media query evaluates at paint, not async subscription).
### Track Card Plain-Shell Refactor
**Landed 2026-06-05.**
Eliminated `!important` declarations from track card CSS by replacing MudBlazor surface components with plain HTML. Implemented per `product-notes/track-card-css-architecture.md` Option A.
**Razor changes (`DeepDrftShared.Client/Components/TrackCard.razor`):**
- `MudCard``<div class="deepdrft-track-card-container">`
- Fallback `MudPaper``<div class="deepdrft-track-card-fallback">`
- `MudCardContent``<div class="deepdrft-track-card-content">`
- `MudText`, `MudChip`, `MudFab` unchanged.
**CSS changes (`DeepDrftPublic/wwwroot/styles/deepdrft-styles.css` §8):**
- Removed four `!important` declarations from `.deepdrft-track-card-container`, `.deepdrft-track-card-fallback` base, and the dark/light theme-scoped variants.
- Plain single-class selectors now win by cascade without `!important`; theme-scoped rules use normal specificity hierarchy.
**Scope:**
- `TrackCard` component in shared `DeepDrftShared.Client` consumed by both public site and CMS.
- CSS in `DeepDrftPublic/wwwroot/styles/deepdrft-styles.css` (public site only).
- Build clean: 0 errors, 0 new warnings.
**Notes for future work:**
- Plain-div shell re-enables CSS isolation as an option (a `TrackCard.razor.css` would now work against the shell divs). Section 8's public-only scoping remains convenient; isolation is optional for future polish.
- Removes the structural mismatch of using a Material surface component (`MudCard`/`MudPaper`) solely as a layout shell. TrackCard now mirrors the construction of `NowPlayingCard` (plain divs + themed CSS).
**Status:** Desktop AudioPlayerBar redesign landed on 2026-06-04.
### Desktop AudioPlayerBar — migrate to MudBlazor theme system