Improve Home page UX and HVSC state management

[chrisgleissner]

• Added cache status management to the HVSC library, including baseline version and update tracking.
• Implemented action tracing for HVSC install and ingest operations.
• Introduced a reset handler for HVSC state management.
• Updated hooks and state management to reflect new cache status and phases.

test: Add unit tests for playback routing with FTP support

• Implemented tests for playback routing that utilize FTP for loading SID files.
• Added scenarios for successful FTP downloads and fallbacks to local uploads.

test: Enhance RAM operations tests for chunked reads and writes

• Added tests to ensure RAM is read and written in monotonic 2KB chunks.
• Included retry logic for failed read operations.

feat: Introduce LED color configuration and utility functions

• Created a new module for LED color definitions and utility functions for RGB conversion.
• Added tests to validate color definitions and RGB conversion functionality.

feat: Implement C64 liveness checking mechanism

• Developed a new module to check the liveness of the C64 machine based on jiffy and raster readings.
• Added tests to verify the liveness checking logic under different scenarios.

feat: Add volume state management for playback

• Introduced a volume state management system to handle mute and index transitions.
• Added tests to ensure correct state transitions for volume management.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 63.22%. Comparing base (8fe09ad) to head (a114282).

❗ There is a different number of reports uploaded between BASE (8fe09ad) and HEAD (a114282). Click for more details.

HEAD has 2 uploads less than BASE

Flag	BASE (8fe09ad)	HEAD (a114282)
unittests	1	0
e2etests	1	0

Additional details and impacted files

@@              Coverage Diff              @@
##               main      #33       +/-   ##
=============================================
- Coverage     88.31%   63.22%   -25.09%     
  Complexity       25       25               
=============================================
  Files           192        4      -188     
  Lines         25663      155    -25508     
  Branches       8856       24     -8832     
=============================================
- Hits          22663       98    -22565     
+ Misses         2851       42     -2809     
+ Partials        149       15      -134     

Flag	Coverage Δ
android	63.22% <ø> (ø)
e2etests	?
unittests	?

Flags with carried forward coverage won't be shown. Click here to find out more.
see 188 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

This PR expands device/library management and playback flows across the app: HVSC gains cache-status awareness + action tracing + reset behavior, playback gains an FTP-based SID upload path for Ultimate sources with known duration, and multiple UI areas are updated for better inline configuration and interaction behavior (plus accompanying unit/E2E tests).

Changes:

• Add C64 liveness checking + RAM operation tracing/recovery, with expanded unit coverage for chunked reads/writes and retry behavior.
• Enhance HVSC UX/state with cache status + phase tracking, action tracing, and a reset handler; extend Playwright coverage for tracing and progress.
• Add playback routing for Ultimate SIDs via FTP download + upload when duration is known; plus LED color utilities and volume state reducer with tests.

Reviewed changes

Copilot reviewed 27 out of 58 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
tests/unit/ramOperations.test.ts	Extends RAM tests for 2KB monotonic chunking + retry behavior; updates API mock for liveness reads.
tests/unit/playbackRouter.test.ts	Adds unit tests covering FTP download + upload path and fallback to PUT.
tests/unit/playFiles/volumeState.test.ts	Adds unit tests for the new volume reducer state transitions.
tests/unit/machine/c64Liveness.test.ts	Adds unit tests for jiffy/raster-based liveness decisions.
tests/unit/config/ledColors.test.ts	Adds tests validating fixed LED color definitions + RGB helpers.
src/pages/playFiles/volumeState.ts	Introduces a reducer-based state machine for volume/mute handling.
src/pages/playFiles/hooks/useHvscLibrary.ts	Adds HVSC cache status polling, action tracing wrappers, phase computation, ingest gating, and reset handler.
src/pages/playFiles/components/HvscControls.tsx	Updates HVSC controls UI to show phase/status, reset option, and ingest gating.
src/pages/PlayFilesPage.tsx	Switches volume/mute management to the reducer and plumbs new HVSC state into UI.
src/pages/MusicPlayerPage.tsx	Uses StatefulButton for play/restart button to align visuals with play state.
src/pages/HomePage.tsx	Reworks LED controls inline, adds SID type/profile column handling, and updates SID control entry derivation.
src/lib/playback/playbackRouter.ts	Adds Ultimate SID FTP fetch + upload path when duration is available, with fallback to existing PUT behavior.
src/lib/machine/ramOperations.ts	Adds liveness checks, detailed tracing, and reset/reboot recovery on retry for RAM operations.
src/lib/machine/c64Liveness.ts	New module implementing jiffy+raster liveness sampling and trace recording.
src/lib/config/ledColors.ts	New module centralizing LED fixed colors and RGB helpers.
src/hooks/useLocalSources.ts	Initializes local sources state from storage eagerly and avoids redundant effect updates.
src/components/ui/button.tsx	Introduces Stateless vs Stateful button exports; default Button now blurs on click.
src/components/itemSelection/ItemSelectionDialog.tsx	Adds a test hook to disable local auto-confirm behavior and resets auto-confirming on open.
src/components/QuickActionCard.tsx	Blurs card button on click to clear focus/pressed state.
playwright/visualSeeds.ts	Seeds local sources storage for more stable visual runs.
playwright/uiMocks.ts	Adds HVSC cache-status mock to UI fixtures.
playwright/sourceSelection.ts	Adds interstitial-aware source selection helper for tests.
playwright/screenshots.spec.ts	Adjusts screenshot flow for local import selection and scroll reset before capture.
playwright/itemSelection.spec.ts	Adds coverage to ensure source interstitial resets on reopen and minor whitespace cleanup.
playwright/hvsc.spec.ts	Adds action-trace ordering assertions and more granular progress-step scenarios.
playwright/homeInteractivity.spec.ts	Adds tests for SID type column rendering and focus-clearing behavior.
PLANS.md	Updates execution plan to match the expanded set of fixes/features implemented.