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>

Packages/FlixyKit/Sources/MediaKit/PagingWindow.swift

@@ -0,0 +1,37 @@
+import Foundation
+
+/// Wann nachgeladen wird.
+///
+/// **Nicht „die letzten fünf".** So stand es bisher, und zwei Dinge daran
+/// gehen schief. Erstens ist das auf einem Raster aus sechs Spalten nicht
+/// einmal eine Zeile: wer dort ankommt, wartet trotzdem. Zweitens — und das
+/// ist der eigentliche Fehler — hing es am **Erscheinen** der Kachel. Beim
+/// ersten Zeichnen erscheinen alle sechzig gleichzeitig, auch die letzten
+/// fünf; das Nachladen lief also sofort los statt beim Scrollen.
+///
+/// Gemessen wird deshalb in **Zeilen**, und der Auslöser ist auf dem
+/// Fernseher der Fokus statt des Erscheinens. Auf einem breiten Raster ist
+/// das nicht Feinschliff: dort sind sechs Kacheln eine Zeile, und mit der
+/// alten Regel wäre schon die erste Bildschirmseite „fast am Ende".
+public struct PagingWindow: Sendable, Equatable {
+    /// Wie viele Kacheln nebeneinander stehen.
+    public let columns: Int
+    /// Wie viele Zeilen Vorlauf gewünscht sind.
+    public let rowsAhead: Int
+
+    public init(columns: Int, rowsAhead: Int = 2) {
+        self.columns = columns
+        self.rowsAhead = rowsAhead
+    }
+
+    /// - Parameter focusedIndex: Wo der Fokus gerade steht.
+    /// - Parameter loaded: Wie viele Einträge schon dastehen.
+    /// - Parameter total: Wie viele der Server insgesamt meldet.
+    public func shouldLoad(focusedIndex: Int, loaded: Int, total: Int) -> Bool {
+        // `columns <= 0` ist keine sinnvolle Frage, aber eine mögliche: ein
+        // Raster kennt seine Spaltenzahl erst nach dem ersten Zeichnen. Null
+        // zurückzugeben ist richtiger, als durch null zu teilen.
+        guard columns > 0, loaded > 0, loaded < total else { return false }
+        return focusedIndex >= loaded - columns * rowsAhead
+    }
+}