Die Startseite am Fernseher — und die Ladeschicht nur einmal

Aufmacher, Reihen, Mediatheken, Raster. Der sichtbare Teil ist neu; der
Teil darunter ist derselbe wie am Telefon, und das war die eigentliche
Arbeit.

**Herausgelöst statt kopiert.** `HomeFeed` und `LibraryFeed` tragen jetzt,
was vorher in `HomeView` und `LibraryView` stand: laden, ordnen, den
Aufmacher auslosen, den Zwischenspeicher abziehen, entdoppeln, nach einem
Fehlschlag sperren. Das zu kopieren wäre der schlimmste Ausgang dieses
Vorhabens gewesen — an mindestens drei dieser Stellen klebte schon je ein
Fehler, der sich als „es sind nicht alle Filme drin" äusserte und sonst
nichts. Einer davon, das Los des Aufmachers an der Position statt am
Titel, wäre in einer Kopie ein zweites Mal zu finden gewesen.

Mitgewandert sind `rowTitle`, `rowArtworkPath`, `posterArtworkPath`,
`runtimeLabel` und `HeroArtwork`: reine Ableitungen, die in einer
Ansichtsdatei lagen und deshalb nur das Telefon übersetzte.

**Nachgeladen wird am Fokus, nicht am Erscheinen.** Die alte Regel hiess
„die letzten fünf" und hing daran, dass eine Kachel sichtbar wird. Beim
ersten Zeichnen erscheinen aber alle sechzig, auch die letzten fünf — das
Nachladen lief sofort los statt beim Blättern. Auf einem Raster aus sechs
Spalten sind fünf Einträge ausserdem nicht einmal eine Zeile. `PagingWindow`
rechnet deshalb in Zeilen; sechs Tests halten es fest, darunter der Fall,
der die alte Regel entlarvt.

**Der Fokus setzt den Aufmacher.** Wer durch „Zuletzt hinzugefügt"
wandert, sieht oben, was er gerade anschaut. Kein Wechsel im Sieben-
sekundentakt wie am Telefon: vor einem Fernseher wäre ein Bild, das sich
von allein austauscht, während man es liest, eine Zumutung.

**Drei Dinge, die erst der Simulator zeigte.** Die Seiten müssen
bildfüllend laufen, weil ein Aufmacher, der achtzig Punkte vor der
Bildschirmkante aufhört, nach Fehler aussieht — also trägt `screenMargin`
auf tvOS den Überscan mit. Die Karten brauchen einen Fokus-Rückruf, weil
`\.isFocused` den nächsten fokussierbaren Vorfahren meint und das in einer
Reihe aus Karten nicht verlässlich die Karte ist. Und der Bau scheiterte
an „Unable to resolve module dependency: VLCKit" — der Abhängigkeits-
Sucher prüft `canImport(FlixyVLC)` auch für ein Ziel, das es nie verlinkt.
Ein `&& !os(tvOS)` genügt; das Paket selbst bleibt unverändert.

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

Flixy/Views/Home/HeroArtwork.swift

@@ -1,81 +0,0 @@
-import Foundation
-import FlixyDesign
-import MediaKit
-
-/// Woher der Aufmacher seine Bilder nimmt.
-///
-/// An **einer** Stelle, weil zwei Stellen es schon zweimal falsch gemacht
-/// haben:
-///
-/// Erstens wurde das Hintergrundbild in 900×1200 angefordert — hochkant — und
-/// dann in einem 16:9-Rahmen gezeigt. Zu sehen war davon ein schmaler Streifen
-/// aus der Mitte; vom Bild fehlte oben und unten je ein Drittel. Die Maße
-/// richten sich jetzt nach dem Rahmen, in dem das Bild landet.
-///
-/// Zweitens holt das Karussell das nächste Bild vor, solange das aktuelle noch
-/// steht. Weicht dessen Adresse auch nur in einer Zahl ab, ist es eine andere
-/// Adresse, der Zwischenspeicher trifft daneben und der Aufmacher blendet auf
-/// eine graue Fläche über.
-enum HeroArtwork {
-    /// Die Maße, in denen das Bild angefordert wird.
-    ///
-    /// Im Seitenverhältnis des Rahmens, in dem es landet — sonst schneidet der
-    /// Server zu, und man sieht einen Streifen aus der Mitte.
-    static func size(compact: Bool) -> (width: Int, height: Int) {
-        compact ? (600, 900) : (1920, 1080)
-    }
-
-    static func aspectRatio(compact: Bool) -> CGFloat {
-        compact ? FlixyAspectRatio.poster : FlixyAspectRatio.hero
-    }
-
-    /// Auf einem schmalen Bildschirm das **Plakat**, sonst das Hintergrundbild.
-    ///
-    /// Ein Hintergrundbild ist 16:9. Hochkant gezeigt fehlen ihm links und
-    /// rechts je ein Viertel, und zu sehen ist ein Ausschnitt aus der Mitte —
-    /// vom Bild bleibt wenig übrig. Ein Plakat ist von vornherein hochkant;
-    /// es passt in den Rahmen, ohne dass etwas weggeschnitten werden muss.
-    static func backdropURL(for item: MediaItem, backend: any MediaBackend, compact: Bool) -> URL? {
-        backdropURLs(for: item, backend: backend, compact: compact).first
-    }
-
-    /// Alle Kandidaten, vom besten zum schlechtesten.
-    ///
-    /// **Warum mehrere und nicht einer.** Eine Folge hat selten ein eigenes
-    /// Querformatbild, die Staffel manchmal, die Serie fast immer. Bisher
-    /// wurde die erste Adresse genommen, die sich **zusammensetzen** liess —
-    /// und ob es das Bild dahinter gibt, stellt sich erst beim Abruf heraus.
-    /// Gab es keines, blieb die Fläche grau, obwohl eine Ebene höher eines
-    /// gelegen hätte. Genau so sahen Folgen im Aufmacher aus.
-    ///
-    /// Die Reihenfolge steht hier, ausprobiert wird sie beim Laden.
-    static func backdropURLs(
-        for item: MediaItem,
-        backend: any MediaBackend,
-        compact: Bool
-    ) -> [URL] {
-        let size = size(compact: compact)
-        let pfade: [String?] = compact
-            // Hochkant: das Plakat der Folge, dann das der Staffel, dann das
-            // der Serie. Ein Hintergrundbild kommt hier zuletzt — es ist
-            // quer und verliert hochkant die Hälfte.
-            ? [item.posterArtworkPath, item.thumb, item.parentThumb, item.seriesThumb, item.art]
-            // Quer: das eigene Hintergrundbild, dann das der Staffel, dann
-            // das der Serie — und erst danach das Vorschaubild der Folge.
-            : [item.art, item.parentThumb, item.seriesArt, item.seriesThumb, item.thumb]
-
-        var gesehen = Set<String>()
-        return pfade
-            .compactMap(\.self)
-            .filter { gesehen.insert($0).inserted }
-            .compactMap { backend.artworkURL(path: $0, width: size.width, height: size.height) }
-    }
-
-    /// Der freigestellte Schriftzug — ohne Bild-Transcoder.
-    ///
-    /// Er ist ein PNG mit durchsichtigem Grund, und der Transcoder liefert
-    /// JPEG. Aus dem Schriftzug würde sonst ein schwarzer Kasten.
-    static func logoURL(for item: MediaItem, backend: any MediaBackend) -> URL? {
-        backend.rawImageURL(path: item.clearLogoPath)
-    }
-}

Flixy/Views/Home/HeroSection.swift

@@ -74,16 +74,3 @@ struct HeroSection: View {
         return pieces.isEmpty ? nil : pieces.joined(separator: " · ")
     }
 }
-
-extension Duration {
-    /// Laufzeit als „2 Std 46 Min" bzw. „46 Min".
-    var runtimeLabel: String {
-        let totalMinutes = Int(components.seconds / 60)
-        let hours = totalMinutes / 60
-        let minutes = totalMinutes % 60
-        if hours > 0 {
-            return String(localized: "runtime.hoursMinutes \(hours) \(minutes)")
-        }
-        return String(localized: "runtime.minutes \(minutes)")
-    }
-}

Flixy/Views/Home/HomeView.swift

@@ -3,14 +3,19 @@ import FlixyDesign
 import MediaKit
 
 /// Die Startseite: Aufmacher oben, darunter die Reihen vom Server.
+///
+/// **Nur noch Darstellung.** Was auf der Startseite steht — laden, ordnen,
+/// den Aufmacher auslosen — liegt in `HomeFeed`, weil der Fernseher dieselben
+/// Reihen zeigt und die Logik sonst zweimal dastünde. Kopiert wäre dabei
+/// ausgerechnet der Teil gewesen, an dem schon mehrere Fehler steckten.
 struct HomeView: View {
     @Environment(FlixySession.self) private var session
     @Environment(HomeLayoutSettings.self) private var layout
-    @State private var state: LoadState<[MediaRowGroup]> = .loading
+    @State private var feed = HomeFeed()
 
     var body: some View {
         Group {
-            switch state {
+            switch feed.state {
             case .loading:
                 ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity)
 
@@ -20,11 +25,11 @@ struct HomeView: View {
                 } description: {
                     Text(message)
                 } actions: {
-                    Button("action.retry") { Task { await load() } }
+                    Button("action.retry") { Task { await feed.load(from: session.backend) } }
                 }
 
-            case .loaded(let allRows):
-                let hubs = layout.apply(to: prepared(allRows))
+            case .loaded:
+                let hubs = feed.rows(for: layout)
                 if hubs.isEmpty {
                     ContentUnavailableView {
                         Label("home.empty.title", systemImage: "film.stack")
@@ -54,14 +59,14 @@ struct HomeView: View {
         // daneben, und genau diese Kante sah man. Auf den geschobenen
         // Bildschirmen bleibt sie, dort trägt sie den Zurück-Weg.
         .toolbar(.hidden, for: .navigationBar)
-        .task(id: session.serverName) { await load() }
-        .refreshable { await load() }
+        .task(id: session.serverName) { await feed.load(from: session.backend) }
+        .refreshable { await feed.load(from: session.backend) }
     }
 
     private func content(hubs: [MediaRowGroup]) -> some View {
         ScrollView {
             LazyVStack(alignment: .leading, spacing: FlixySpacing.section) {
-                let featured = heroItems(in: hubs)
+                let featured = feed.heroItems(for: layout)
                 if !featured.isEmpty {
                     HeroCarousel(items: featured)
                 }
@@ -75,103 +80,4 @@ struct HomeView: View {
         .scrollIndicators(.never)
         .flixyRevealsTopChrome()
     }
-
-    /// Bringt die Reihen vom Server in die Form, die eingestellt ist.
-    ///
-    /// Hier und nicht im Backend: „Weiterschauen und Als Nächstes zusammen"
-    /// und „Gesehenes ausblenden" sind Fragen der Darstellung, keine des
-    /// Servers. Beides hier zu erledigen hält den Vertrag schmal und gilt für
-    /// Plex und Jellyfin gleichermaßen.
-    private func prepared(_ rows: [MediaRowGroup]) -> [MediaRowGroup] {
-        var rows = rows
-
-        if layout.hidesWatchedInLatest {
-            rows = rows.map { row in
-                guard row.id.hasPrefix("latest") else { return row }
-                return MediaRowGroup(
-                    id: row.id,
-                    title: row.title,
-                    moreKey: row.moreKey,
-                    items: row.items.filter { !$0.isWatched }
-                )
-            }
-        }
-
-        if layout.combinesContinueRows {
-            rows = combiningContinueRows(rows)
-        }
-
-        return rows.filter { !$0.items.isEmpty }
-    }
-
-    /// Legt „Weiterschauen" und „Als Nächstes" in eine Reihe.
-    ///
-    /// Die zusammengelegte Reihe behält die Kennung der ersten — sonst wäre
-    /// sie für die gespeicherte Reihenfolge eine neue und stünde plötzlich
-    /// wieder ganz unten.
-    private func combiningContinueRows(_ rows: [MediaRowGroup]) -> [MediaRowGroup] {
-        let continuing = rows.filter(\.isContinueWatching)
-        guard continuing.count > 1, let first = continuing.first else { return rows }
-
-        var seen = Set<String>()
-        let merged = continuing.flatMap(\.items).filter { seen.insert($0.id).inserted }
-
-        var result: [MediaRowGroup] = []
-        for row in rows {
-            guard row.isContinueWatching else {
-                result.append(row)
-                continue
-            }
-            guard row.id == first.id else { continue }
-            result.append(MediaRowGroup(id: row.id, title: row.title, items: merged))
-        }
-        return result
-    }
-
-    /// Was oben groß gezeigt wird.
-    ///
-    /// Angefangenes zuerst — wer die App öffnet, will meistens weiterschauen.
-    /// Aufgefüllt wird aus den übrigen Reihen: bei einer einzigen angefangenen
-    /// Folge gäbe es sonst nichts zu blättern. Wer den Aufmacher lieber als
-    /// Schaufenster versteht, stellt auf Neuzugänge um.
-    private func heroItems(in hubs: [MediaRowGroup]) -> [MediaItem] {
-        let candidates: [MediaItem]
-        switch layout.heroSource {
-        case .continueFirst:
-            let continuing = hubs.first(where: \.isContinueWatching)?.items ?? []
-            let rest = hubs.filter { !$0.isContinueWatching }.flatMap(\.items)
-            candidates = continuing + rest
-        case .latestOnly:
-            candidates = hubs.filter { $0.id.hasPrefix("latest") }.flatMap(\.items)
-        }
-
-        var seen = Set<String>()
-        let unique = candidates.filter { seen.insert($0.id).inserted }
-
-        // **Gemischt, aber nicht bei jedem Blick.**
-        //
-        // Wie gemischt wird, steht in `HeroSelection` — einem reinen Typ mit
-        // Tests. Der Grund dafür ist ein Fehler, den man hier nie gefunden
-        // hätte: das Los hing an der **Position** in der Liste, nicht am
-        // Titel. Kam einer dazu oder änderte sich ein Fortschritt, bekamen
-        // alle dahinter ein anderes Los — und der Aufmacher war nach jedem
-        // Start ein anderer, obwohl das Zeitfenster dasselbe war.
-        switch layout.heroSource {
-        case .continueFirst:
-            // Innerhalb der Gruppen ziehen, nicht über sie hinweg:
-            // Angefangenes bleibt vorn, wechselt aber untereinander.
-            let ordered = HeroSelection.ordered(unique.filter { $0.watchProgress != nil })
-                + HeroSelection.ordered(unique.filter { $0.watchProgress == nil })
-            return Array(ordered.prefix(layout.heroCount))
-        case .latestOnly:
-            return Array(HeroSelection.ordered(unique).prefix(layout.heroCount))
-        }
-    }
-
-    private func load() async {
-        guard let backend = session.backend else { return }
-        state = await LoadState.load(keepingPrevious: state) {
-            try await backend.homeRows()
-        }
-    }
 }

Flixy/Views/Home/MediaRow.swift

@@ -77,53 +77,3 @@ struct MediaRow: View {
         }
     }
 }
-
-extension MediaItem {
-    /// Der Titel auf einer Kachel in einer Reihe.
-    ///
-    /// Groß steht, worum es geht: bei einer Folge ihr eigener Titel, bei
-    /// einer Staffel der Name der Serie. Die Einordnung — Serie, Staffel —
-    /// gehört darunter. „Staffel 10" allein als Überschrift sagt nichts
-    /// darüber, welche Serie gemeint ist.
-    var rowTitle: String {
-        switch kind {
-        case .episode: title
-        // Die Serie steht je nach Antwort mal unter `parentTitle`, mal unter
-        // `seriesTitle`. Fehlt beides, bleibt „Staffel 2" — besser als
-        // gar keine Beschriftung.
-        case .season: parentTitle ?? seriesTitle ?? title
-        default: title
-        }
-    }
-
-    /// Welches Bild auf die Querformat-Kachel gehört.
-    ///
-    /// Bei Folgen ist `thumb` das Szenenbild der Folge — genau richtig. Bei
-    /// Filmen ist `thumb` das Hochkant-Plakat, das im Querformat beschnitten
-    /// würde; dort ist `art` (das Hintergrundbild) die bessere Wahl.
-    var rowArtworkPath: String? {
-        switch kind {
-        case .episode: thumb ?? seriesThumb
-        // Eine Staffel hat bei Jellyfin oft gar kein eigenes Bild — sie leiht
-        // sich das der Serie. Ohne diesen Rückfall blieb „Nachtstreife,
-        // Staffel 7" eine graue Fläche, obwohl die Serie ein Plakat hat.
-        case .season: art ?? thumb ?? seriesArt ?? seriesThumb
-        default: art ?? thumb
-        }
-    }
-
-    /// Welches Bild auf die Hochkant-Kachel gehört.
-    ///
-    /// Bei Folgen das Plakat der Serie statt des Szenenbilds: ein 16:9-Bild
-    /// hochkant beschnitten zeigt einen zufälligen Ausschnitt und ist zum
-    /// Wiedererkennen wertlos.
-    var posterArtworkPath: String? {
-        switch kind {
-        case .episode: seriesThumb ?? parentThumb ?? thumb
-        // Das eigene Staffelplakat zuerst: es zeigt die Staffel. Gibt es
-        // keines, ist das der Serie allemal besser als nichts.
-        case .season: thumb ?? seriesThumb
-        default: thumb
-        }
-    }
-}