Halo heisst ab hier Flaro — die Marke stand im Weg

Der Upload zu App Store Connect scheiterte am Namen. „Halo" ist eine
eingetragene Marke von Microsoft; im App Store heisst zwar keine App exakt
so, aber reservierte und markenrechtlich belegte Namen tauchen in keiner
Suche auf. Der einzige verlässliche Test war die Eingabe dort, und die ging
daneben.

**Der Name wurde diesmal vorher geprüft.** Zwanzig Kandidaten gegen den
deutschen und amerikanischen App Store, auf exakte Treffer und auf ähnliche
Namen. „Kavo" wäre dieselbe Wand gewesen — exakt belegt in beiden Stores, in
Deutschland von KaVo Dental GmbH. „Flare" ist mit 42 ähnlichen Apps je Store
der am dichtesten besetzte Name der ganzen Runde. **Flaro** ist in beiden
frei und liest sich als eigenes Wort, nicht als Flare mit Tippfehler.

Das bleibt eine Store-Suche und keine Markenrecherche — reservierte Namen
ohne veröffentlichte App sieht sie nicht. Aber es ist mehr Prüfung, als beim
letzten Mal stattfand.

---

2160 Textvorkommen in 273 Dateien, 49 Pfade. Betroffen ist diesmal auch der
Server: `Flaro.Api`, `Flaro.Core`, `Flaro.Data`, `Flaro.Media`,
`Flaro.Metadata`, `FlaroContext`, `FlaroPaths`, `flaro.db`, die Variablen
`FLARO_DATA`, `FLARO_CACHE`, `FLARO_TRANSCODE`, `FLARO_WRITE_SIDECARS`, und
das Image.

**Vor dem Ersetzen geprüft**, ob „halo" irgendwo als Teil eines anderen
Wortes steckt — und ob es im TMDB-Token vorkommt. Tat es nicht; ein blindes
Ersetzen hätte den sonst zerlegt.

`docs/superpowers/specs/` bleibt wie beim letzten Mal unangetastet: datierte
Entwurfsdokumente sind ein Protokoll getroffener Entscheidungen. Das
Server-Dokument hat stattdessen einen Nachtrag bekommen, damit es niemanden
in die Irre führt.

**Die Bundle-ID wandert mit**, zum zweiten Mal an einem Tag:
`com.scarriffleservices.flaro`. Wer die vorige Fassung installiert hat, hat
jetzt zwei Karteileichen auf dem Gerät — beide löschen, dann ist Ruhe.

308 Server-Tests grün, 368 im Swift-Paket, null Warnungen. iOS und tvOS
bauen, das Image baut, und ein frischer Container läuft durch Einrichtung
und Anmeldung.

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

Packages/FlaroKit/Tests/FlaroPlaybackTests/SubtitleStyleTests.swift

@@ -0,0 +1,143 @@
+import AVFoundation
+import CoreMedia
+import Foundation
+import Testing
+@testable import FlaroPlayback
+
+@Suite("Aussehen der Untertitel")
+struct SubtitleStyleTests {
+
+    private func attributes(_ style: SubtitleStyle) -> [String: Any]? {
+        style.textStyleRules.first?.textMarkupAttributes
+    }
+
+    private func colour(_ style: SubtitleStyle, _ key: CFString) -> [Double]? {
+        (attributes(style)?[key as String] as? [NSNumber])?.map(\.doubleValue)
+    }
+
+    // MARK: - Dass überhaupt etwas herauskommt
+
+    /// **Der Test, für den es den ganzen Typ gibt.** Der Initialisierer von
+    /// `AVTextStyleRule` kann fehlschlagen: ein falscher Schlüssel ergibt
+    /// `nil` und damit gar keine Regel — lautlos. Auf dem Bildschirm sieht
+    /// „keine Regel" genauso aus wie „Regel ohne Wirkung".
+    @Test("Jedes Paar ergibt genau eine Regel")
+    func everyPaletteProducesOneRule() {
+        for palette in SubtitleStyle.Palette.allCases {
+            for size in SubtitleStyle.Size.allCases {
+                let regeln = SubtitleStyle(size: size, palette: palette).textStyleRules
+                #expect(regeln.count == 1, "\(palette) / \(size) ergab \(regeln.count) Regeln")
+            }
+        }
+    }
+
+    // MARK: - Die Farben
+
+    /// Alpha **zuerst**, dann Rot, Grün, Blau — der häufigste Fehler an
+    /// dieser Stelle, und einer ohne Fehlermeldung.
+    @Test("Die Farbe steht als A, R, G, B da")
+    func colourOrderIsARGB() {
+        let gelb = SubtitleStyle(palette: .yellowOnBlack)
+        let werte = colour(gelb, kCMTextMarkupAttribute_ForegroundColorARGB)
+
+        #expect(werte?.count == 4)
+        #expect(werte?[0] == 1)          // Alpha
+        #expect(werte?[1] == 1)          // Rot
+        #expect((werte?[3] ?? 1) < 0.5)  // Blau — sonst wäre es nicht Gelb
+    }
+
+    @Test("Alle Anteile liegen zwischen null und eins")
+    func coloursAreInRange() {
+        for palette in SubtitleStyle.Palette.allCases {
+            let stil = SubtitleStyle(palette: palette)
+            for schlüssel in [
+                kCMTextMarkupAttribute_ForegroundColorARGB,
+                kCMTextMarkupAttribute_BackgroundColorARGB,
+            ] {
+                let werte = colour(stil, schlüssel) ?? []
+                #expect(werte.count == 4, "\(palette): \(werte.count) Anteile")
+                #expect(werte.allSatisfy { $0 >= 0 && $0 <= 1 }, "\(palette): \(werte)")
+            }
+        }
+    }
+
+    @Test("Weiss auf Schwarz ist weiss auf schwarz")
+    func whiteOnBlack() {
+        let stil = SubtitleStyle(palette: .whiteOnBlack)
+        #expect(colour(stil, kCMTextMarkupAttribute_ForegroundColorARGB) == [1, 1, 1, 1])
+
+        let grund = colour(stil, kCMTextMarkupAttribute_BackgroundColorARGB) ?? []
+        #expect((grund.first ?? 0) > 0.5)              // sichtbarer Kasten
+        #expect(grund.dropFirst().allSatisfy { $0 == 0 })
+    }
+
+    @Test("Schwarz auf Weiss ist die Umkehrung")
+    func blackOnWhite() {
+        let stil = SubtitleStyle(palette: .blackOnWhite)
+        #expect(colour(stil, kCMTextMarkupAttribute_ForegroundColorARGB) == [1, 0, 0, 0])
+        #expect((colour(stil, kCMTextMarkupAttribute_BackgroundColorARGB)?.first ?? 0) > 0.5)
+    }
+
+    /// **Weglassen ist nicht dasselbe wie durchsichtig.** Ohne den Schlüssel
+    /// gilt, was der Untertitel selbst mitbringt — und Jellyfins WebVTT
+    /// bringt oft einen schwarzen Kasten mit. Dann bliebe „Weiss ohne
+    /// Kasten" wirkungslos, und niemand wüsste warum.
+    @Test("Durchsichtig wird ausdrücklich gesetzt, nicht weggelassen")
+    func transparentIsStated() {
+        for palette in [SubtitleStyle.Palette.whiteOnClear, .yellowOnClear] {
+            let stil = SubtitleStyle(palette: palette)
+            let grund = colour(stil, kCMTextMarkupAttribute_BackgroundColorARGB)
+
+            #expect(grund != nil, "\(palette): der Hintergrund fehlt ganz")
+            #expect(grund?.first == 0, "\(palette): Alpha ist nicht null")
+        }
+    }
+
+    // MARK: - Die Grösse
+
+    /// Ein Prozentwert, keine Punktgrösse. Hundert heisst unverändert — und
+    /// „unverändert" darf nicht wegoptimiert werden, sonst gilt wieder, was
+    /// der Untertitel mitbringt.
+    @Test("Die Grösse ist ein Prozentwert, auch bei hundert")
+    func sizeIsAPercentage() {
+        for size in SubtitleStyle.Size.allCases {
+            let wert = attributes(SubtitleStyle(size: size))?[
+                kCMTextMarkupAttribute_RelativeFontSize as String
+            ] as? Double
+            #expect(wert == Double(size.rawValue))
+        }
+    }
+
+    /// Die zweite Grössenangabe bezieht sich auf etwas anderes. Beide zu
+    /// setzen liesse sie sich streiten.
+    @Test("Die andere Grössenangabe bleibt weg")
+    func onlyOneSizeKey() {
+        let gesetzt = attributes(SubtitleStyle(size: .huge)) ?? [:]
+        #expect(gesetzt[
+            kCMTextMarkupAttribute_BaseFontSizePercentageRelativeToVideoHeight as String
+        ] == nil)
+    }
+
+    // MARK: - Der Rand
+
+    /// Ohne Kasten steht die Schrift unmittelbar im Bild, und Weiss auf einer
+    /// hellen Szene ist dort unlesbar. Mit Kasten wäre der Schatten Unruhe.
+    @Test("Den Schatten gibt es nur ohne Kasten")
+    func edgeShadowOnlyWithoutBox() {
+        for palette in SubtitleStyle.Palette.allCases {
+            let stil = SubtitleStyle(palette: palette)
+            let rand = attributes(stil)?[kCMTextMarkupAttribute_CharacterEdgeStyle as String]
+            #expect((rand != nil) == stil.wantsEdgeShadow, "\(palette)")
+        }
+    }
+
+    // MARK: - Die Vorgabe
+
+    @Test("Ohne Angabe: weisse Schrift, kein Kasten, normale Grösse")
+    func defaults() {
+        let stil = SubtitleStyle()
+        #expect(stil.size == .normal)
+        #expect(stil.palette == .whiteOnClear)
+        #expect(stil.wantsEdgeShadow)
+    }
+}