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>
This commit is contained in:
Scarriffle
2026-10-03 11:12:32 +02:00
co-authored by Claude Opus 5
parent 2fcf6821c8
commit 4b9a1e7b67
280 changed files with 1456 additions and 1456 deletions
+64
View File
@@ -0,0 +1,64 @@
import SwiftUI
import HaloDesign
import MediaKit
/// Der Aufmacher oben auf der Startseite des Fernsehers.
///
/// Derselbe `HeroBanner` wie am Telefon — das Bauteil kennt keine Plattform,
/// es setzt Bild, Verlauf und Text. Anders sind nur die Knöpfe: hier sind es
/// Fokusziele, und sie müssen gross genug sein, dass man aus drei Metern
/// sieht, welcher gerade dran ist.
struct TVHeroSection: View {
let item: MediaItem
let onPlay: () -> Void
let onDetails: () -> Void
@Environment(HaloSession.self) private var session
@Environment(\.haloAccent) private var accent
var body: some View {
HeroBanner(
title: item.rowTitle,
metadata: metadaten,
summary: item.summary,
artworkURLs: session.backend.map {
HeroArtwork.backdropURLs(for: item, backend: $0, compact: false)
} ?? [],
logoURL: session.backend.flatMap { HeroArtwork.logoURL(for: item, backend: $0) },
aspectRatio: HaloAspectRatio.hero,
// Der Aufmacher nimmt die Höhe, die das Karussell ihm gibt.
fillsAvailableSpace: true
) {
Button(action: onPlay) {
Label(abspielTitel, systemImage: "play.fill")
}
.buttonStyle(.borderedProminent)
.tint(accent)
Button(action: onDetails) {
Label("hero.details", systemImage: "info.circle")
}
.buttonStyle(.bordered)
}
}
/// „Weiterschauen" statt „Abspielen", wenn schon etwas gesehen wurde.
private var abspielTitel: LocalizedStringKey {
item.watchProgress == nil ? "hero.play" : "hero.resume"
}
private var metadaten: String? {
var teile: [String] = []
if item.kind == .episode, let staffel = item.parentIndex, let folge = item.index {
// Ausgeschrieben: der Aufmacher am Fernseher ist 1760 Punkte
// breit, und gelesen wird er aus drei Metern.
teile.append(String(localized: "episode.long \(staffel) \(folge)"))
}
if let jahr = item.year { teile.append(String(jahr)) }
if let dauer = item.duration {
teile.append(Duration.milliseconds(dauer).runtimeLabel)
}
if let freigabe = item.contentRating { teile.append(freigabe) }
return teile.isEmpty ? nil : teile.joined(separator: " · ")
}
}
+148
View File
@@ -0,0 +1,148 @@
import SwiftUI
import HaloDesign
import MediaKit
/// Die Startseite auf dem Fernseher.
///
/// **Dasselbe Modell wie am Telefon.** `HomeFeed` lädt, ordnet und lost den
/// Aufmacher aus; hier steht nur, wie das aussieht. Der Unterschied ist die
/// Bedienart, nicht der Inhalt.
struct TVHomeView: View {
/// Wohin ein Link aus dem Regal führen soll.
///
/// **Als Bindung von aussen**, nicht als eigener Zustand: das Regal
/// erreicht die Wurzel, der Navigationsstapel liegt hier. Einen zweiten
/// Stapel eine Ebene höher anzulegen, nur um ein Ziel durchzureichen,
/// hiesse zwei Stapel gleich zu halten.
@Binding var deepLinkTarget: MediaRoute?
@Environment(HaloSession.self) private var session
@Environment(HomeLayoutSettings.self) private var layout
@Environment(PlaybackCoordinator.self) private var playback
@Environment(QuickPlay.self) private var quickPlay
@State private var feed = HomeFeed()
@State private var pfad = NavigationPath()
/// Welcher Titel gerade oben gross steht.
///
/// **Der Fokus bestimmt ihn, nicht eine Uhr.** Am Telefon wechselt der
/// Aufmacher alle sieben Sekunden von selbst — dort blättert man ihn auch
/// mit dem Daumen. Vor einem Fernseher wäre ein Bild, das sich von allein
/// austauscht, während man es ansieht, eine Zumutung: man verliert den
/// Titel, den man gerade lesen wollte.
@State private var aufmacher: MediaItem?
var body: some View {
NavigationStack(path: $pfad) {
inhalt
.navigationDestination(for: MediaRoute.self) { route in
TVDetailView(route: route)
}
}
.task(id: session.serverName) { await feed.load(from: session.backend) }
.onChange(of: deepLinkTarget) { _, neu in
guard let neu else { return }
pfad.append(neu)
deepLinkTarget = nil
}
}
@ViewBuilder
private var inhalt: some View {
switch feed.state {
case .loading:
ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity)
case .failed(let meldung):
VStack(spacing: HaloSpacing.regular) {
Text(meldung).font(.haloBody).foregroundStyle(.white)
Button("action.retry") {
Task { await feed.load(from: session.backend) }
}
}
case .loaded:
let reihen = feed.rows(for: layout)
if reihen.isEmpty && session.libraries.isEmpty {
Text("home.empty.title").font(.haloRowHeader).foregroundStyle(.white)
} else {
seite(reihen: reihen)
}
}
}
private func seite(reihen: [MediaRowGroup]) -> some View {
ScrollView {
LazyVStack(alignment: .leading, spacing: HaloSpacing.section) {
if let gezeigt = aufmacher ?? feed.heroItems(for: layout).first {
TVHeroSection(
item: gezeigt,
onPlay: { spiele(gezeigt) },
onDetails: { zeige(gezeigt) }
)
.frame(height: 720)
}
ForEach(reihen) { reihe in
// **Der Fokus setzt den Aufmacher.** Wer durch „Zuletzt
// hinzugefügt" wandert, sieht oben, was er gerade
// anschaut — ohne irgendwo hindrücken zu müssen.
TVMediaRow(
row: reihe,
onSelect: { spiele($0) },
onFocus: { aufmacher = $0 }
)
}
}
.padding(.bottom, HaloSpacing.screenMargin)
}
.scrollIndicators(.never)
// **Bildfüllend, und der Rand steckt in `screenMargin`.** Der
// Aufmacher muss bis an die Bildschirmkante reichen; ein Bild, das
// achtzig Punkte davor aufhört, sieht nach Fehler aus.
.ignoresSafeArea()
// Als Überlagerung und nicht als letzte Zeile der Liste: dorthin
// müsste man erst an allen Reihen vorbeiscrollen, und wer nachsieht,
// warum das Regal leer ist, soll es sofort sehen.
.overlay(alignment: .bottom) { regalStatus }
}
/// Was das Regal über der App zuletzt bekommen hat.
///
/// **Nur im Entwicklerbau.** Es gehört nicht in die fertige App — aber
/// solange das Regal leer bleibt, sieht man von aussen nicht, woran es
/// liegt: fehlende App-Gruppe, fehlende Datei und ein System, das nicht
/// fragt, sehen alle gleich aus. Diese Zeile unterscheidet sie.
@ViewBuilder
private var regalStatus: some View {
#if DEBUG
VStack(alignment: .leading, spacing: HaloSpacing.tight) {
Text("topShelf.title")
.font(.haloCaption)
.foregroundStyle(Color.haloTextMuted)
Text(TopShelfWriter.status)
.font(.haloCaption)
.foregroundStyle(Color.haloTextSecondary)
}
.padding(.horizontal, HaloSpacing.screenMargin)
.padding(.bottom, HaloSpacing.regular)
.frame(maxWidth: .infinity, alignment: .leading)
.background(Color.black.opacity(0.6))
#endif
}
// MARK: - Was ein Druck auslöst
/// **Über QuickPlay, nicht unmittelbar.** Steht in der Reihe 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.
private func spiele(_ item: MediaItem) {
quickPlay.start(item, backend: session.backend, coordinator: playback)
}
private func zeige(_ item: MediaItem) {
pfad.append(MediaRoute(ratingKey: item.id, title: item.title))
}
}
+73
View File
@@ -0,0 +1,73 @@
import SwiftUI
import HaloDesign
import MediaKit
/// Eine waagerechte Reihe von Titeln auf dem Fernseher.
///
/// Dieselben Daten wie `MediaRow` am Telefon, aber eine andere Bedienung: es
/// gibt keinen Finger, der die Reihe schiebt, sondern einen Fokus, der von
/// Karte zu Karte springt und die Reihe hinter sich herzieht.
struct TVMediaRow: View {
let row: MediaRowGroup
let onSelect: (MediaItem) -> Void
/// Wer gerade dran ist — damit der Aufmacher oben mitwandert.
var onFocus: (MediaItem) -> Void = { _ in }
@Environment(HaloSession.self) private var session
/// Breit genug, dass die übernächste Karte angeschnitten ist — das zeigt,
/// dass es weitergeht, ohne einen Pfeil dafür zu brauchen.
private var breite: CGFloat { row.isContinueWatching ? 500 : 280 }
var body: some View {
VStack(alignment: .leading, spacing: HaloSpacing.regular) {
Text(row.title)
.font(.haloRowHeader)
.foregroundStyle(Color.haloTextPrimary)
.padding(.horizontal, HaloSpacing.screenMargin)
ScrollView(.horizontal) {
LazyHStack(spacing: HaloSpacing.regular) {
ForEach(row.items) { item in
karte(for: item).frame(width: breite)
}
}
.padding(.horizontal, HaloSpacing.screenMargin)
// **Platz zum Anheben.** Eine fokussierte Karte wächst über
// ihren Rahmen hinaus, und eine ScrollView beschneidet am
// Rand. Ohne Polster und ohne das abgeschaltete Beschneiden
// fehlt der obersten Reihe die Anhebung — und zwar nur ihr,
// was wie ein Zufall aussieht statt wie ein Fehler.
.padding(.vertical, HaloSpacing.regular)
}
.scrollClipDisabled()
.scrollIndicators(.never)
}
}
/// Szenenbild beim Weiterschauen, sonst das Plakat.
@ViewBuilder
private func karte(for item: MediaItem) -> some View {
if row.isContinueWatching {
TVLandscapeCard(
title: item.rowTitle,
subtitle: item.cardSubtitle,
artworkURL: session.backend?.artworkURL(
path: item.rowArtworkPath, width: 880, height: 496
),
progress: item.watchProgress,
onFocusChange: { if $0 { onFocus(item) } }
) { onSelect(item) }
} else {
TVPosterCard(
title: item.rowTitle,
subtitle: item.cardSubtitle,
artworkURL: session.backend?.artworkURL(
path: item.thumb, width: 560, height: 840
),
progress: item.watchProgress,
onFocusChange: { if $0 { onFocus(item) } }
) { onSelect(item) }
}
}
}