Flixy heißt ab hier Halo

Reine Umbenennung, kein Verhalten geändert — bewusst als eigener Commit,
damit „umbenannt" und „umgebaut" im Nachhinein auseinanderzuhalten sind.

712 mal `Flixy`, 778 mal `flixy`, 7 mal `FLIXY` in 169 Dateien, dazu 25
Pfade. Ziele: `Halo`, `HaloTV`, `HaloTopShelf`, `HaloUITests`, `HaloKit` mit
`HaloDesign`, `HaloDownloads`, `HaloPlayback` und `HaloProbe`. `MediaKit`,
`JellyfinKit` und `DownloadWidget` tragen den Namen nicht und bleiben.

`docs/superpowers/specs/` ist ausgenommen. Datierte Entwurfsdokumente sind
ein Protokoll getroffener Entscheidungen; sie nachträglich umzuschreiben
hiesse, die Vergangenheit zu glätten.

**Die Bundle-ID wandert mit** — ausdrücklich so gewollt, mit bekanntem Preis:
`com.scarriffleservices.halo` ist für iOS eine *andere* App. Die installierte
Fassung bleibt daneben stehen, mit Downloads und Anmeldung in ihrem Container;
Halo startet leer. Einmal neu anmelden, heruntergeladene Folgen einmal neu
laden. Dasselbe gilt für die App-Gruppe, die sich TV-App und Top Shelf teilen.

**Eine Folge davon, die beim Entscheiden noch nicht auf dem Tisch lag:** der
Aufräumschritt aus dem vorigen Commit kommt an die alten Plex-Token nicht mehr
heran. Der Schlüsselbund grenzt nach Team und Bundle-Kennung ab — was unter
`…flixy` liegt, ist für `…halo` unerreichbar. Erledigt wird es trotzdem, nur
anders: **die alte App löschen.** iOS räumt deren Schlüsselbund-Einträge beim
Deinstallieren mit ab. Der Code bleibt stehen, weil er für jeden Stand vor
dieser Umbenennung richtig ist und im Jahr einen Startvergleich kostet.

Die Projektdatei ist aus `project.yml` neu erzeugt, der alte Ordner gelöscht
statt umbenannt — sie steht ohnehin nicht im Repo.

Das Verzeichnis des Repos selbst heißt weiter `Flixy`; das umzubenennen ist
ein Handgriff ausserhalb des Projekts.

368 Tests grün. iOS und tvOS bauen.

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

Halo/Session/HomeLayoutSettings.swift

@@ -0,0 +1,162 @@
+import Foundation
+import Observation
+import MediaKit
+
+/// Welche Reihen die Startseite zeigt und in welcher Reihenfolge.
+///
+/// Hält nur die Einstellung und ihre Speicherung. Das Anordnen selbst macht
+/// `Arrangement` in MediaKit — dort ist es reine Rechnung und ohne Simulator
+/// prüfbar, und genau dort liegen die kniffligen Fälle: neue Reihen vom
+/// Server, verschwundene aus der gespeicherten Liste.
+@MainActor
+@Observable
+final class HomeLayoutSettings {
+    private enum Key {
+        static let hidden = "halo.home.hiddenHubs"
+        static let order = "halo.home.hubOrder"
+        static let heroCount = "halo.home.heroCount"
+        static let heroSource = "halo.home.heroSource"
+        static let heroLibraries = "halo.home.heroLibraries"
+        static let combinesContinueRows = "halo.home.combinesContinueRows"
+        static let hidesWatchedInLatest = "halo.home.hidesWatchedInLatest"
+        static let cardScale = "halo.home.cardScale"
+        static let heroHeight = "halo.home.heroHeight"
+    }
+
+    /// Woraus sich der Aufmacher speist.
+    enum HeroSource: String, CaseIterable, Identifiable, Sendable {
+        /// Angefangenes zuerst, danach aufgefüllt.
+        case continueFirst
+        /// Nur Neuzugänge — für den, der den Aufmacher als Schaufenster
+        /// versteht und nicht als Fortsetzung.
+        case latestOnly
+
+        var id: String { rawValue }
+    }
+
+    /// Wie viele Titel der Aufmacher durchwechselt.
+    static let heroCountChoices = [1, 3, 5, 7, 10]
+
+    /// Die Grenzen der Kachelgröße.
+    ///
+    /// Nach unten, wo ein Plakat noch erkennbar ist; nach oben, wo auf einem
+    /// iPad noch mehr als zwei nebeneinander passen — sonst ist es keine Reihe
+    /// mehr, sondern eine Abfolge.
+    static let cardScaleRange: ClosedRange<Double> = 0.7...1.8
+
+    /// Wie viel vom Bildschirm der Aufmacher einnehmen darf.
+    ///
+    /// Nach unten bleibt er ein breites Vorschaubild, nach oben verdeckt er
+    /// die erste Reihe ganz — und dann weiß niemand, dass es weitergeht.
+    static let heroHeightRange: ClosedRange<Double> = 0.4...0.95
+
+    private let defaults: UserDefaults
+    private(set) var arrangement: Arrangement
+
+    var heroCount: Int { didSet { defaults.set(heroCount, forKey: Key.heroCount) } }
+    var heroSource: HeroSource { didSet { defaults.set(heroSource.rawValue, forKey: Key.heroSource) } }
+
+    /// Aus welchen Mediatheken der Aufmacher sich speist.
+    ///
+    /// **Leer heisst alle** — siehe `HeroSelection.rows(_:limitedTo:)`. Eine
+    /// Auswahl, bei der nichts angekreuzt ist, darf nicht in einen leeren
+    /// Aufmacher führen.
+    ///
+    /// Als `Set` und nicht als eine einzelne Kennung: wer Filme und Serien
+    /// will, aber keine Musikvideos, hat zwei Antworten und nicht eine.
+    var heroLibraries: Set<String> {
+        didSet { defaults.set(Array(heroLibraries), forKey: Key.heroLibraries) }
+    }
+    /// Ob „Weiterschauen" und „Als Nächstes" eine Reihe sind.
+    ///
+    /// Getrennt ist genauer, zusammen ist kürzer. Beides ist vertretbar, und
+    /// welches richtig ist, hängt davon ab, wie viele Serien jemand parallel
+    /// schaut.
+    var combinesContinueRows: Bool { didSet { defaults.set(combinesContinueRows, forKey: Key.combinesContinueRows) } }
+    /// Ob Gesehenes aus „Zuletzt hinzugefügt" verschwindet.
+    var hidesWatchedInLatest: Bool { didSet { defaults.set(hidesWatchedInLatest, forKey: Key.hidesWatchedInLatest) } }
+
+    /// Wie groß Plakate und Vorschaubilder erscheinen, als Faktor auf die
+    /// gestalterisch festgelegten Breiten.
+    ///
+    /// Ein Faktor und keine Punktzahl: die Breiten von Plakat und Querformat
+    /// stehen in einem Verhältnis zueinander, das stimmen soll. Zwei getrennte
+    /// Zahlen ließen sich gegeneinander verstellen, bis eine Reihe zur anderen
+    /// nicht mehr passt.
+    ///
+    /// **Pro Gerät**, nicht über den Server: am Fernseher will man größere
+    /// Kacheln als am Laptop, und das eine soll das andere nicht umstellen.
+    var cardScale: Double { didSet { defaults.set(cardScale, forKey: Key.cardScale) } }
+
+    /// Welchen Anteil der sichtbaren Höhe der Aufmacher einnimmt.
+    var heroHeight: Double { didSet { defaults.set(heroHeight, forKey: Key.heroHeight) } }
+
+    init(defaults: UserDefaults = .standard) {
+        self.defaults = defaults
+        self.arrangement = Arrangement(
+            hidden: Set(defaults.stringArray(forKey: Key.hidden) ?? []),
+            order: defaults.stringArray(forKey: Key.order) ?? []
+        )
+        self.heroCount = defaults.object(forKey: Key.heroCount) as? Int ?? 5
+        self.heroSource = defaults.string(forKey: Key.heroSource)
+            .flatMap(HeroSource.init(rawValue:)) ?? .continueFirst
+        self.heroLibraries = Set(defaults.stringArray(forKey: Key.heroLibraries) ?? [])
+        self.combinesContinueRows = defaults.object(forKey: Key.combinesContinueRows) as? Bool ?? false
+        self.hidesWatchedInLatest = defaults.object(forKey: Key.hidesWatchedInLatest) as? Bool ?? false
+        // Die Voreinstellungen sind genau das bisherige feste Verhalten: wer
+        // nichts anfasst, merkt von der neuen Einstellung nichts.
+        self.cardScale = (defaults.object(forKey: Key.cardScale) as? Double)
+            .map { $0.clamped(to: Self.cardScaleRange) } ?? 1.0
+        self.heroHeight = (defaults.object(forKey: Key.heroHeight) as? Double)
+            .map { $0.clamped(to: Self.heroHeightRange) } ?? 0.82
+    }
+
+    func isHidden(_ identifier: String) -> Bool {
+        arrangement.hidden.contains(identifier)
+    }
+
+    func setHidden(_ hidden: Bool, for identifier: String) {
+        if hidden {
+            arrangement.hidden.insert(identifier)
+        } else {
+            arrangement.hidden.remove(identifier)
+        }
+        defaults.set(Array(arrangement.hidden), forKey: Key.hidden)
+    }
+
+    func setOrder(_ identifiers: [String]) {
+        arrangement.order = identifiers
+        defaults.set(identifiers, forKey: Key.order)
+    }
+
+    func apply(to rows: [MediaRowGroup]) -> [MediaRowGroup] {
+        arrangement.apply(to: rows)
+    }
+
+    /// Die Zeilen für den Einstellungsbildschirm.
+    func rows(from rows: [MediaRowGroup]) -> [HomeRow] {
+        arrangement.arrangedIdentifiers(from: rows).compactMap { identifier in
+            guard let row = rows.first(where: { $0.id == identifier }) else { return nil }
+            return HomeRow(id: identifier, title: row.title, isHidden: isHidden(identifier))
+        }
+    }
+}
+
+/// Eine Reihe im Einstellungsbildschirm.
+struct HomeRow: Identifiable, Hashable {
+    let id: String
+    let title: String
+    var isHidden: Bool
+}
+
+extension Comparable {
+    /// Auf einen Bereich begrenzt.
+    ///
+    /// Gespeicherte Werte werden beim Lesen geprüft, nicht blind übernommen:
+    /// eine ältere Fassung mit anderen Grenzen — oder ein von Hand
+    /// verändertes Voreinstellungs-Sheet — soll nicht zu einer Kachel führen,
+    /// die den halben Bildschirm einnimmt.
+    func clamped(to range: ClosedRange<Self>) -> Self {
+        min(max(self, range.lowerBound), range.upperBound)
+    }
+}