Show soundtrack covers and edit alternative names (#49)

Covers: statistics cards show the soundtrack's cover on the left, and the
statistics popup shows it large. Until it arrives, and without a cover, the
soundtrack's initials stand in. Covers load only for cards on or near the
screen, three at a time, and are cached in covers/ next to the settings
(CoverCache), downloaded again only when cover_modified changes. The index and
file handling are shared with CharacterCache in a new FileCache.

Alternative names: the popup shows them and has an editor (add, remove, save)
that sends PUT /soundtracks/{uuid}/alternative-names. The statistics search and
the Search popup find soundtracks by them; Search shows the matching name after
the real one. Search now loads /soundtracks, falling back to the plain list.

The API types are regenerated from the server's spec, with a SoundtrackCover
theme style in every theme.

Closes #49

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

server/generated/alternative_names.gd

@@ -0,0 +1,22 @@
+# Generated by tools/generate_api_types.gd from server/openapi.json.
+# Do not edit; change the server and generate again.
+class_name AlternativeNames
+extends RefCounted
+## The [code]AlternativeNames[/code] schema of the MusicServer API.
+
+## The new list of alternative names. Replaces the old list; send [] to remove them all.
+var names: Array[String]
+
+
+## Reads the fields from parsed JSON. Missing fields keep their defaults.
+static func from_dict(data: Dictionary) -> AlternativeNames:
+	var result: AlternativeNames = AlternativeNames.new()
+	result.names.assign(ApiJson.get_array(data, "names"))
+	return result
+
+
+## Returns the fields under their JSON names, ready for [method JSON.stringify].
+func to_dict() -> Dictionary:
+	return {
+		"names": names,
+	}

server/generated/alternative_names.gd.uid

@@ -0,0 +1 @@
+uid://bpdabeiw5wupm

server/generated/cover_source.gd

@@ -0,0 +1,26 @@
+# Generated by tools/generate_api_types.gd from server/openapi.json.
+# Do not edit; change the server and generate again.
+class_name CoverSource
+extends RefCounted
+## The [code]CoverSource[/code] schema of the MusicServer API.
+
+## The game's ID on SteamGridDB, or the anime's ID on AniList
+var id: String
+## Where the cover comes from
+var source: String
+
+
+## Reads the fields from parsed JSON. Missing fields keep their defaults.
+static func from_dict(data: Dictionary) -> CoverSource:
+	var result: CoverSource = CoverSource.new()
+	result.id = ApiJson.get_string(data, "id", "")
+	result.source = ApiJson.get_string(data, "source", "")
+	return result
+
+
+## Returns the fields under their JSON names, ready for [method JSON.stringify].
+func to_dict() -> Dictionary:
+	return {
+		"id": id,
+		"source": source,
+	}

server/generated/cover_source.gd.uid

@@ -0,0 +1 @@
+uid://06q8sppe2evn

server/generated/soundtrack.gd

@@ -5,6 +5,10 @@ extends RefCounted
 ## The [code]Soundtrack[/code] schema of the MusicServer API.
 
 var added: String
+## Other names the soundtrack is known by
+var alternative_names: Array[String]
+## When the cover last changed, in Unix seconds. Missing when there is no cover.
+var cover_modified: int
 var last_played: String
 var name: String
 var times_played: int
@@ -15,6 +19,8 @@ var uuid: String
 static func from_dict(data: Dictionary) -> Soundtrack:
 	var result: Soundtrack = Soundtrack.new()
 	result.added = ApiJson.get_string(data, "added", "")
+	result.alternative_names.assign(ApiJson.get_array(data, "alternative_names"))
+	result.cover_modified = ApiJson.get_int(data, "cover_modified", 0)
 	result.last_played = ApiJson.get_string(data, "last_played", "")
 	result.name = ApiJson.get_string(data, "name", "")
 	result.times_played = ApiJson.get_int(data, "times_played", 0)
@@ -26,6 +32,8 @@ static func from_dict(data: Dictionary) -> Soundtrack:
 func to_dict() -> Dictionary:
 	return {
 		"added": added,
+		"alternative_names": alternative_names,
+		"cover_modified": cover_modified,
 		"last_played": last_played,
 		"name": name,
 		"times_played": times_played,

server/generated/soundtrack_with_song_list.gd

@@ -5,6 +5,10 @@ extends RefCounted
 ## The [code]SoundtrackWithSongList[/code] schema of the MusicServer API.
 
 var added: String
+## Other names the soundtrack is known by
+var alternative_names: Array[String]
+## When the cover last changed, in Unix seconds. Missing when there is no cover.
+var cover_modified: int
 var last_played: String
 var name: String
 var songs: Array[Song]
@@ -16,6 +20,8 @@ var uuid: String
 static func from_dict(data: Dictionary) -> SoundtrackWithSongList:
 	var result: SoundtrackWithSongList = SoundtrackWithSongList.new()
 	result.added = ApiJson.get_string(data, "added", "")
+	result.alternative_names.assign(ApiJson.get_array(data, "alternative_names"))
+	result.cover_modified = ApiJson.get_int(data, "cover_modified", 0)
 	result.last_played = ApiJson.get_string(data, "last_played", "")
 	result.name = ApiJson.get_string(data, "name", "")
 	for item: Variant in ApiJson.get_array(data, "songs"):
@@ -30,6 +36,8 @@ static func from_dict(data: Dictionary) -> SoundtrackWithSongList:
 func to_dict() -> Dictionary:
 	return {
 		"added": added,
+		"alternative_names": alternative_names,
+		"cover_modified": cover_modified,
 		"last_played": last_played,
 		"name": name,
 		"songs": songs.map(func(item: Song) -> Dictionary: return item.to_dict()),

server/generated/soundtrack_with_songs.gd

@@ -4,6 +4,10 @@ class_name SoundtrackWithSongs
 extends RefCounted
 ## The [code]SoundtrackWithSongs[/code] schema of the MusicServer API.
 
+## Other names the soundtrack is known by
+var alternative_names: Array[String]
+## When the cover last changed, in Unix seconds. Missing when there is no cover.
+var cover_modified: int
 var songs: Array[SongInfoForStats]
 var soundtrack_id: int
 var soundtrack_last_played: String
@@ -15,6 +19,8 @@ var soundtrack_uuid: String
 ## Reads the fields from parsed JSON. Missing fields keep their defaults.
 static func from_dict(data: Dictionary) -> SoundtrackWithSongs:
 	var result: SoundtrackWithSongs = SoundtrackWithSongs.new()
+	result.alternative_names.assign(ApiJson.get_array(data, "alternative_names"))
+	result.cover_modified = ApiJson.get_int(data, "cover_modified", 0)
 	for item: Variant in ApiJson.get_array(data, "songs"):
 		if item is Dictionary:
 			result.songs.append(SongInfoForStats.from_dict(item))
@@ -29,6 +35,8 @@ static func from_dict(data: Dictionary) -> SoundtrackWithSongs:
 ## Returns the fields under their JSON names, ready for [method JSON.stringify].
 func to_dict() -> Dictionary:
 	return {
+		"alternative_names": alternative_names,
+		"cover_modified": cover_modified,
 		"songs": songs.map(func(item: SongInfoForStats) -> Dictionary: return item.to_dict()),
 		"soundtrack_id": soundtrack_id,
 		"soundtrack_last_played": soundtrack_last_played,