Flaro/Halo/Session/HomeLayoutSettings.swift

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)
    }
}