Phase 1: Anmeldung, Bibliothek, Detailseiten, Hybrid-Player

Die Datenschicht:
- plex.tv-Anmeldung über das PIN-Verfahren, Token im Schlüsselbund
- Serversuche und Verbindungsauswahl nach Rang (lokal vor direkt vor
  Vermittlung), mit Abgleich der Server-Kennung gegen veraltete
  plex.direct-Adressen
- PlexServer als einzige Stelle, an der die App Endpunkte kennt:
  Mediatheken, Hubs, seitenweises Blättern mit Filtern, Metadaten,
  Staffeln/Folgen, Suche

Die Oberfläche:
- Startseite mit Aufmacher und den Reihen vom Server
- Mediathek als Raster oder Liste, mit Filter- und Sortierblatt
- Detailseiten für Filme, Folgen, Serien und Staffeln inkl. Besetzung,
  Fassungsauswahl und aufklappbaren technischen Angaben
- Suche mit gemerkten Anfragen
- Vollbildplayer mit eigenem Chrome

Der Player:
- AVPlayerEngine und VLCPlayerEngine hinter einem gemeinsamen Protokoll
- VLCKit liegt in einem eigenen Package (FlixyVLC), damit `swift test`
  in FlixyKit nicht das 920-MB-Binärpaket mitzieht

Am echten plex.tv geprüft: der Anmeldecode kommt an. Dabei fiel auf,
dass `strong=true` einen dreißigstelligen Code liefert, der sich bei
plex.tv/link nicht eintippen lässt — jetzt der kurze.

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

Packages/FlixyKit/Sources/PlexKit/Models/PlexItem.swift

@@ -6,7 +6,10 @@ import Foundation
 /// `type`. Das ist ungewohnt, aber praktisch: Suchergebnisse und Reihen auf
 /// der Startseite mischen die Arten, und ein gemeinsamer Typ erspart das
 /// Aufteilen bei jedem Abruf.
-public struct PlexItem: Sendable, Equatable, Codable, Identifiable {
+/// Nur `Decodable`: geschrieben wird dieser Typ nirgends. Der Offline-Bestand
+/// in Phase 3 bekommt ein eigenes SwiftData-Modell, weil er andere Felder
+/// braucht — lokaler Dateipfad, Ladezeitpunkt — und andere nicht.
+public struct PlexItem: Sendable, Equatable, Decodable, Identifiable {
     public enum Kind: String, Sendable, Codable {
         case movie, show, season, episode, clip, collection
     }
@@ -58,6 +61,15 @@ public struct PlexItem: Sendable, Equatable, Codable, Identifiable {
 
     public let media: [PlexMedia]
 
+    // Schlagwörter. Plex liefert sie nur bei der Einzelabfrage eines Titels
+    // mit, nicht in Listen — deshalb sind sie dort leer.
+    public let genres: [PlexTag]
+    public let directors: [PlexTag]
+    public let writers: [PlexTag]
+    /// Die Besetzung, mit Porträt und Rollennamen.
+    public let roles: [PlexTag]
+    public let markers: [PlexMarker]
+
     private enum CodingKeys: String, CodingKey {
         case ratingKey, key, guid, type, title, titleSort, summary, year, duration
         case contentRating, rating, audienceRating
@@ -67,6 +79,11 @@ public struct PlexItem: Sendable, Equatable, Codable, Identifiable {
         case viewCount, viewOffset, lastViewedAt, addedAt
         case leafCount, viewedLeafCount, childCount
         case media = "Media"
+        case genres = "Genre"
+        case directors = "Director"
+        case writers = "Writer"
+        case roles = "Role"
+        case markers = "Marker"
     }
 
     /// Von Hand geschrieben statt erzeugt, weil der erzeugte Decoder einen
@@ -112,6 +129,11 @@ public struct PlexItem: Sendable, Equatable, Codable, Identifiable {
         self.childCount = try values.decodeIfPresent(Int.self, forKey: .childCount)
 
         self.media = try values.decodeIfPresent([PlexMedia].self, forKey: .media) ?? []
+        self.genres = try values.decodeIfPresent([PlexTag].self, forKey: .genres) ?? []
+        self.directors = try values.decodeIfPresent([PlexTag].self, forKey: .directors) ?? []
+        self.writers = try values.decodeIfPresent([PlexTag].self, forKey: .writers) ?? []
+        self.roles = try values.decodeIfPresent([PlexTag].self, forKey: .roles) ?? []
+        self.markers = try values.decodeIfPresent([PlexMarker].self, forKey: .markers) ?? []
     }
 
     /// `ratingKey` ist serverweit eindeutig und eignet sich deshalb direkt
@@ -162,6 +184,7 @@ public struct PlexMediaContainer<Content: Decodable & Sendable>: Sendable, Decod
         case size, totalSize, offset, title1, title2
         case metadata = "Metadata"
         case directory = "Directory"
+        case hub = "Hub"
     }
 
     public init(from decoder: any Decoder) throws {
@@ -174,13 +197,15 @@ public struct PlexMediaContainer<Content: Decodable & Sendable>: Sendable, Decod
         self.title1 = try inner.decodeIfPresent(String.self, forKey: .title1)
         self.title2 = try inner.decodeIfPresent(String.self, forKey: .title2)
 
-        // `Metadata` bei Titeln, `Directory` bei Bibliotheken und Staffeln.
-        // Eine leere Mediathek liefert gar kein Feld — das ist kein Fehler,
-        // sondern bedeutet schlicht null Einträge.
+        // `Metadata` bei Titeln, `Directory` bei Mediatheken, `Hub` bei den
+        // Reihen der Startseite. Eine leere Mediathek liefert gar kein Feld —
+        // das ist kein Fehler, sondern bedeutet schlicht null Einträge.
         if let metadata = try inner.decodeIfPresent([Content].self, forKey: .metadata) {
             self.content = metadata
         } else if let directory = try inner.decodeIfPresent([Content].self, forKey: .directory) {
             self.content = directory
+        } else if let hub = try inner.decodeIfPresent([Content].self, forKey: .hub) {
+            self.content = hub
         } else {
             self.content = []
         }