fix(home): Discover Songs covers for local-index tracks (#874)

* fix(home): pre-warm and prefetch Discover Songs row covers

The Discover Songs raблин. il came out of the cover pipeline merge with two
gaps that left its cards stuck on the placeholder disc icon on cold
caches.

- `warmHomeMainstageCovers` walked `heroAlbums` / `recent` / `random`
  through `ensureAlbumCoverMisses` + `predecodeWarmAlbums` but skipped
  `discoverSongs`, so songs that were peeked but missed on disk had to
  wait for lazy per-card ensure
- `Home.tsx`'s `coverPrefetchRegister` lumped `songRefs` into a
  `cappedRest` slice already saturated by 48 album refs + 16 artist
  refs at a 24-entry cap, so the song row's background prefetch was
  discarded entirely

Fix: ensure + decode-warm the Discover Songs cells alongside the album
rails, and register the song refs in their own bucket with a sane cap
and `middle` priority. Both follow the same shape as the working album
rails — no behavior change for surfaces that were already painting.

* fix(library): resolve track cover art from albumId for local index songs

Discover Songs uses runLocalRandomSongs; trackToSong only mapped coverArtId,
so rows with empty cover_art_id but a valid album_id showed the disc
placeholder. Mirror Rust COALESCE(cover_art_id, album_id) and Live Search's
coverArt ?? albumId in trackToSong, SongCard, and Home prefetch.

* docs(release): note Discover Songs cover fix in CHANGELOG and credits (PR #874)

* docs(release): credit PR #874 to Psychotoxical and cucadmuh jointly

* chore(credits): drop PR #874 from settingsCredits — minor fix

---------

Co-authored-by: Psychotoxical <171614930+Psychotoxical@users.noreply.github.com>
This commit is contained in:
cucadmuh
2026-05-27 08:49:06 +03:00
committed by GitHub
parent d353482ac5
commit fab6ff19bf
7 changed files with 85 additions and 9 deletions
+18 -1
View File
@@ -138,6 +138,21 @@ function buildRequest(
};
}
/**
* Cover art id for a library track — mirrors Rust cover backfill
* (`COALESCE(cover_art_id, album_id)`). Many servers only expose album art.
*/
export function resolveTrackCoverArtId(
hot: Pick<LibraryTrackDto, 'coverArtId' | 'albumId'>,
song: Partial<SubsonicSong> = {},
): string | undefined {
for (const c of [hot.coverArtId, song.coverArt, hot.albumId, song.albumId]) {
const id = typeof c === 'string' ? c.trim() : '';
if (id) return id;
}
return undefined;
}
export function trackToSong(t: LibraryTrackDto): SubsonicSong {
const raw = isObject(t.rawJson) ? t.rawJson : {};
const resolvedBpm = t.bpm != null && t.bpm > 0 ? t.bpm : undefined;
@@ -151,7 +166,7 @@ export function trackToSong(t: LibraryTrackDto): SubsonicSong {
duration: t.durationSec,
track: t.trackNumber ?? undefined,
discNumber: t.discNumber ?? undefined,
coverArt: t.coverArtId ?? undefined,
coverArt: resolveTrackCoverArtId(t),
year: t.year ?? undefined,
genre: t.genre ?? undefined,
suffix: t.suffix ?? undefined,
@@ -167,6 +182,8 @@ export function trackToSong(t: LibraryTrackDto): SubsonicSong {
// `rawJson` is the authoritative original song — let it override the
// hot-column fallbacks (it carries OpenSubsonic extras too).
const merged: SubsonicSong = { ...base, ...(raw as Partial<SubsonicSong>) };
const coverArt = resolveTrackCoverArtId(t, merged);
if (coverArt) merged.coverArt = coverArt;
if (resolvedBpm != null) merged.bpm = resolvedBpm;
if (t.bpmSource === 'analysis' || t.bpmSource === 'tag') {
merged.localBpmSource = t.bpmSource;