Phase 0: Projektgerüst, Design-Tokens und Navigation

Legt das Fundament für den Plex-Client an:

- XcodeGen-Projekt nach dem Muster von Onyx (com.scarriffleservices,
  strict concurrency, Projektdatei nicht eingecheckt)
- FlixyKit mit vier Modulen: PlexKit, FlixyDesign, FlixyPlayback,
  FlixyDownloads. macOS steht als Plattform mit drin, damit die
  Logik-Tests ohne Simulator laufen.
- FlixyDesign: dunkle Farb-Tokens, Schriftskala, Poster- und
  Querformat-Kacheln, Aufmacher-Bild. Die Akzentfarbe fließt über die
  Umgebung und wird per WCAG-Rechnung lesbar gehalten.
- PlexKit: Kopfzeilen-Identität, Transport-Protokoll, Fehlerarten und
  die Medienmodelle samt nachsichtigem Decoder.
- FlixyPlayback: VideoPlayerEngine-Protokoll und PlaybackDecider — die
  eine Funktion, an der Phase 2 das Transcoding andockt.
- Ausfahrbare Seitenleiste auf dem iPhone, Split-View auf dem iPad.
- 45 Tests, alle grün.

VLCKit 4.0.0-a24 ist vorab geprüft: baut über SPM unter Swift 6 mit
strict concurrency. Die iOS-Slice ist mit 239 MB allerdings gewichtig,
deshalb bekommt sie in Phase 1 ein eigenes Target.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido
2026-09-11 16:04:40 +02:00
co-authored by Claude Opus 5
commit 1ed64bf166
54 changed files with 3584 additions and 0 deletions
+81
View File
@@ -0,0 +1,81 @@
import SwiftUI
import FlixyDesign
/// Die Wurzelansicht.
///
/// Legt fest, in welcher Form die Seitenleiste erscheint: auf dem iPhone als
/// ausfahrbares Blatt, auf dem iPad dauerhaft neben dem Inhalt. Beide Wege
/// nutzen dieselbe `SidebarView` — der Unterschied liegt nur im Rahmen.
struct RootView: View {
@Environment(\.horizontalSizeClass) private var sizeClass
@State private var selection: SidebarDestination = .home
@State private var isSidebarOpen = false
/// Kommt in Phase 1 vom Server. Solange leer, blendet die Seitenleiste den
/// Abschnitt aus, statt eine leere Überschrift zu zeigen.
@State private var libraries: [SidebarDestination] = []
var body: some View {
Group {
if sizeClass == .regular {
splitLayout
} else {
drawerLayout
}
}
.background(Color.flixyCanvas)
}
/// iPad: die Seitenleiste ist Teil des Fensters und lässt sich über den
/// Systemknopf einklappen.
private var splitLayout: some View {
NavigationSplitView {
SidebarView(libraries: libraries, selection: $selection, showsHeader: false) {}
.navigationTitle(Branding.appName)
.toolbar(removing: .sidebarToggle)
} detail: {
NavigationStack {
destination
}
}
}
/// iPhone: die Seitenleiste fährt über den Inhalt.
private var drawerLayout: some View {
DrawerContainer(isOpen: $isSidebarOpen) {
SidebarView(libraries: libraries, selection: $selection) {
isSidebarOpen = false
}
} content: {
NavigationStack {
destination
.toolbar {
ToolbarItem(placement: .topBarLeading) {
Button {
withAnimation(.snappy(duration: 0.28)) { isSidebarOpen = true }
} label: {
Image(systemName: "line.3.horizontal")
}
.accessibilityLabel(Text("sidebar.open"))
}
}
}
}
}
@ViewBuilder
private var destination: some View {
switch selection {
case .home:
PlaceholderScreen(destination: .home)
case .library(let key, let title):
PlaceholderScreen(destination: .library(key: key, title: title))
case .liveTV:
PlaceholderScreen(destination: .liveTV)
case .downloads:
PlaceholderScreen(destination: .downloads)
case .settings:
PlaceholderScreen(destination: .settings)
}
}
}