Flaro/Halo/Views/Home/HeroSection.swift

import SwiftUI
import HaloDesign
import MediaKit

/// Der Aufmacher oben auf der Startseite.
struct HeroSection: View {
    let item: MediaItem
    /// Der Titel, dessen Bild gerade verschwindet — nur im Karussell gesetzt.
    var outgoing: MediaItem?
    /// Wie weit das neue Bild schon deckt.
    var crossfade: CGFloat = 1
    /// Wie weit es dabei hereinrutscht.
    var incomingOffset: CGFloat = 0

    @Environment(HaloSession.self) private var session
    @Environment(PlaybackCoordinator.self) private var playback
    @Environment(QuickPlay.self) private var quickPlay
    @Environment(\.haloAccent) private var accent
    @Environment(\.horizontalSizeClass) private var sizeClass

    var body: some View {
        HeroBanner(
            title: item.rowTitle,
            metadata: metadata,
            summary: item.summary,
            artworkURLs: session.backend.map {
                HeroArtwork.backdropURLs(for: item, backend: $0, compact: sizeClass == .compact)
            } ?? [],
            outgoingArtworkURLs: session.backend.flatMap { backend in
                outgoing.map { HeroArtwork.backdropURLs(for: $0, backend: backend, compact: sizeClass == .compact) }
            } ?? [],
            outgoingTitle: outgoing?.rowTitle,
            outgoingMetadata: outgoing.flatMap(Self.metadata(for:)),
            outgoingLogoURL: session.backend.flatMap { backend in
                outgoing.flatMap { HeroArtwork.logoURL(for: $0, backend: backend) }
            },
            crossfade: crossfade,
            incomingOffset: incomingOffset,
            logoURL: session.backend.flatMap { HeroArtwork.logoURL(for: item, backend: $0) },
            // Auf dem iPhone 4:3 statt 16:9: hochkant ließ 16:9 dem Text so
            // wenig Platz, dass Schriftzug und Beschreibung übereinanderlagen.
            // Beschnitten statt hochkant — das Bild bleibt ein Querbild.
            aspectRatio: HeroArtwork.aspectRatio(compact: sizeClass == .compact),
            // Auf einem großen Bildschirm nimmt der Aufmacher die Höhe, die
            // das Karussell ihm gibt — sonst wäre er so hoch, wie 16:9 es
            // vorschreibt, und darüber und darunter bliebe der halbe
            // Bildschirm leer.
            fillsAvailableSpace: sizeClass != .compact
        ) {
            Button {
                // **Über QuickPlay, nicht unmittelbar.** Steht im Aufmacher
                // eine Serie — und Jellyfins „Zuletzt hinzugefügt" liefert
                // neue Folgen als ihre Serie —, schickte der direkte Weg
                // deren eigene Kennung an den Player, und der scheiterte mit
                // „keine abspielbare Datei". Eine Serie hat keine Fassungen.
                quickPlay.start(item, backend: session.backend, coordinator: playback)
            } label: {
                Label(playLabel, systemImage: "play.fill")
                    .font(.haloCardTitle)
                    .padding(.horizontal, HaloSpacing.loose)
                    .padding(.vertical, HaloSpacing.snug)
            }
            .buttonStyle(.borderedProminent)
            .tint(accent)

            NavigationLink(value: MediaRoute(ratingKey: item.id, title: item.title)) {
                Label("hero.details", systemImage: "info.circle")
                    .font(.haloCardTitle)
                    .padding(.horizontal, HaloSpacing.loose)
                    .padding(.vertical, HaloSpacing.snug)
            }
            .buttonStyle(.bordered)
            .tint(Color.haloTextSecondary)
        }
    }

    /// „Weiterschauen" statt „Abspielen", wenn schon etwas gesehen wurde —
    /// sonst wäre nicht erkennbar, dass der Film an der alten Stelle weitergeht.
    private var playLabel: LocalizedStringKey {
        item.watchProgress == nil ? "hero.play" : "hero.resume"
    }

    private var metadata: String? { Self.metadata(for: item) }

    /// Die Zeile unter dem Titel.
    ///
    /// `static`, weil sie während eines Wechsels auch für den weichenden
    /// Titel gebraucht wird — und der ist nicht `item`.
    static func metadata(for item: MediaItem) -> String? {
        var pieces: [String] = []
        if item.kind == .episode, let season = item.parentIndex, let episode = item.index {
            pieces.append(String(localized: "episode.short \(season) \(episode)"))
        }
        if let year = item.year { pieces.append(String(year)) }
        if let duration = item.duration { pieces.append(Duration.milliseconds(duration).runtimeLabel) }
        if let rating = item.contentRating { pieces.append(rating) }
        return pieces.isEmpty ? nil : pieces.joined(separator: " · ")
    }
}