feat(tokens): ManaTheme + 8 Web-Theme-Variants (v1.6.0)

Acht Web-Themes aus @mana/themes (mana, forest, paper, neutral, lume,
twilight, skylight, monochrome) sind jetzt als Swift verfuegbar.
Generiert aus den CSS-Quellen via `pnpm --filter @mana/themes gen:swift`,
hand-geschriebene API-Schicht oben drauf.

Hintergrund: Cards, Viadocu, Nutriphi hatten je ~90 LOC forest-HSL-
Apparat lokal nachgebaut. Mit v1.6.0 sind diese App-lokalen Files
durch `ManaTheme.<variant>` ersetzbar (Audit 2026-05-17 V1).

Neu:
- `ManaTheme` (public enum) — 8 Cases, CaseIterable, Sendable
- `ManaThemeColors` (public struct, Sendable) — 12 Tokens als Color
- `ManaTheme.colors` + Convenience-Accessoren (`.background` etc.)
- `View.manaTheme(_:)` + `@Environment(\.manaTheme)` (Default `.mana`)
- Generator: `mana/packages/themes/scripts/gen-swift-themes.mjs`

Geaendert: nichts breaking. `ManaColor.*` und `ManaBrand.*`
unveraendert.

Tests: 7 neue Tests in ThemeTests.swift; 12/12 ManaTokens grün,
76/76 gesamt grün auf macOS.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Till JS 2026-05-17 21:11:25 +02:00
parent a70f7fa5e8
commit 20c30fc321
6 changed files with 462 additions and 0 deletions

View file

@ -4,6 +4,56 @@ Alle Änderungen werden hier dokumentiert. Format orientiert an
[Keep a Changelog](https://keepachangelog.com), Versionierung nach
[Semver](https://semver.org).
## [1.6.0] — 2026-05-17
Minor — **`ManaTheme`-Variants** in ManaTokens. Acht Web-Themes aus
`@mana/themes` (mana, forest, paper, neutral, lume, twilight,
skylight, monochrome) sind jetzt als Swift verfügbar; generiert aus
den CSS-Quellen via `pnpm --filter @mana/themes gen:swift`.
Hintergrund: bisher haben Cards, Manaspur und Nutriphi je ~90 LOC
forest-HSL-Apparat lokal nachgebaut, weil ManaTokens nur die
mana-Variant kannte. Mit v1.6.0 sind diese App-lokalen Theme-Files
ablösbar (Audit 2026-05-17 Vorschlag V1).
### Neu
- `ManaTheme` (public enum) — `case mana | forest | paper | neutral
| lume | twilight | skylight | monochrome`. `String`-RawValue,
`CaseIterable`, `Sendable`.
- `ManaThemeColors` (public struct, Sendable) — die 12 Tokens als
`Color`-Properties. Per-Variant statisch verfügbar
(`ManaThemeColors.forest` usw.) aus der generierten Datei
`GeneratedThemes.swift`.
- `ManaTheme.colors` + Convenience-Accessoren (`.background`,
`.foreground`, …) — beide Schreibweisen funktionieren.
- `EnvironmentValues.manaTheme` + `View.manaTheme(_:)`
SwiftUI-Environment, Default `.mana`. Apps mit User-Theme-Switching
setzen den Wert per `@AppStorage`-gestütztem Binding.
### Geändert
- Nichts breaking. `ManaColor.*` und `ManaBrand.*` bleiben unverändert
und liefern weiter die mana-Variant-Werte.
### Generator
- `mana/packages/themes/scripts/gen-swift-themes.mjs` liest die acht
CSS-Variant-Dateien und schreibt `GeneratedThemes.swift`. CI-Drift-
Check: nach Generator-Lauf `git diff --exit-code` in beiden Repos.
### Migrations-Hinweis
Apps können ihre lokalen `*Theme.swift`-Files (Cards, Manaspur,
Nutriphi) durch direkten Aufruf von `ManaTheme.<variant>` ersetzen.
Konvention: Apps mit fester Identität setzen `.manaTheme(.<variant>)`
an der App-Root; verschachtelte Views lesen via
`@Environment(\.manaTheme)`.
### Tests
- 7 neue Tests (`ThemeTests.swift`). 12/12 ManaTokens grün auf macOS.
## [1.5.1] — 2026-05-17
Patch — KeychainStore-Migration-Fallback. Bisher haben die mana-Apps

View file

@ -0,0 +1,143 @@
// ============================================================
// AUTOGENERIERT NICHT MANUELL EDITIEREN.
//
// Quelle: mana/packages/themes/src/variants/*.css
// Generator: mana/packages/themes/scripts/gen-swift-themes.mjs
// Aufruf: pnpm --filter @mana/themes gen:swift
//
// Drift-Check: nach jedem Generator-Lauf `git diff --exit-code`
// in CI sicherstellen.
// ============================================================
import SwiftUI
public extension ManaThemeColors {
/// forest-Variant aus `mana/packages/themes/src/variants/forest.css`.
static let forest = ManaThemeColors(
background: Color.manaToken(light: (0, 0, 100), dark: (142, 30, 8)),
foreground: Color.manaToken(light: (142, 30, 12), dark: (142, 15, 95)),
surface: Color.manaToken(light: (142, 25, 98), dark: (142, 25, 12)),
surfaceHover: Color.manaToken(light: (142, 20, 95), dark: (142, 20, 16)),
muted: Color.manaToken(light: (142, 15, 93), dark: (142, 18, 18)),
mutedForeground: Color.manaToken(light: (142, 10, 42), dark: (142, 12, 65)),
border: Color.manaToken(light: (142, 15, 88), dark: (142, 18, 22)),
primary: Color.manaToken(light: (142, 76, 28), dark: (142, 71, 45)),
primaryForeground: Color.manaToken(light: (0, 0, 100), dark: (142, 30, 8)),
error: Color.manaToken(light: (0, 84, 60), dark: (0, 63, 55)),
success: Color.manaToken(light: (142, 71, 45), dark: (142, 71, 45)),
warning: Color.manaToken(light: (38, 92, 50), dark: (48, 96, 53))
)
/// lume-Variant aus `mana/packages/themes/src/variants/lume.css`.
static let lume = ManaThemeColors(
background: Color.manaToken(light: (0, 0, 100), dark: (0, 0, 6)),
foreground: Color.manaToken(light: (0, 0, 17), dark: (0, 0, 100)),
surface: Color.manaToken(light: (0, 0, 99), dark: (0, 0, 12)),
surfaceHover: Color.manaToken(light: (51, 40, 95), dark: (51, 30, 18)),
muted: Color.manaToken(light: (0, 0, 92), dark: (0, 0, 17)),
mutedForeground: Color.manaToken(light: (0, 0, 42), dark: (0, 0, 65)),
border: Color.manaToken(light: (0, 0, 86), dark: (0, 0, 26)),
primary: Color.manaToken(light: (51, 95, 58), dark: (51, 95, 58)),
primaryForeground: Color.manaToken(light: (0, 0, 13), dark: (0, 0, 6)),
error: Color.manaToken(light: (5, 78, 55), dark: (5, 78, 60)),
success: Color.manaToken(light: (142, 71, 45), dark: (142, 71, 50)),
warning: Color.manaToken(light: (38, 92, 50), dark: (48, 96, 55))
)
/// mana-Variant aus `mana/packages/themes/src/variants/mana.css`.
static let mana = ManaThemeColors(
background: Color.manaToken(light: (0, 0, 100), dark: (220, 20, 9)),
foreground: Color.manaToken(light: (220, 15, 12), dark: (25, 15, 95)),
surface: Color.manaToken(light: (0, 0, 99), dark: (220, 18, 13)),
surfaceHover: Color.manaToken(light: (25, 30, 95), dark: (25, 20, 18)),
muted: Color.manaToken(light: (25, 20, 93), dark: (220, 18, 18)),
mutedForeground: Color.manaToken(light: (220, 10, 42), dark: (220, 10, 65)),
border: Color.manaToken(light: (25, 15, 88), dark: (220, 15, 22)),
primary: Color.manaToken(light: (25, 100, 50), dark: (25, 100, 58)),
primaryForeground: Color.manaToken(light: (0, 0, 10), dark: (220, 20, 9)),
error: Color.manaToken(light: (0, 84, 60), dark: (0, 63, 55)),
success: Color.manaToken(light: (142, 71, 45), dark: (142, 71, 45)),
warning: Color.manaToken(light: (38, 92, 50), dark: (48, 96, 53))
)
/// monochrome-Variant aus `mana/packages/themes/src/variants/monochrome.css`.
static let monochrome = ManaThemeColors(
background: Color.manaToken(light: (0, 0, 100), dark: (0, 0, 5)),
foreground: Color.manaToken(light: (0, 0, 10), dark: (0, 0, 95)),
surface: Color.manaToken(light: (0, 0, 99), dark: (0, 0, 10)),
surfaceHover: Color.manaToken(light: (0, 0, 95), dark: (0, 0, 15)),
muted: Color.manaToken(light: (0, 0, 93), dark: (0, 0, 17)),
mutedForeground: Color.manaToken(light: (0, 0, 40), dark: (0, 0, 65)),
border: Color.manaToken(light: (0, 0, 85), dark: (0, 0, 22)),
primary: Color.manaToken(light: (0, 0, 25), dark: (0, 0, 80)),
primaryForeground: Color.manaToken(light: (0, 0, 100), dark: (0, 0, 5)),
error: Color.manaToken(light: (0, 70, 45), dark: (0, 65, 55)),
success: Color.manaToken(light: (142, 60, 35), dark: (142, 60, 50)),
warning: Color.manaToken(light: (38, 90, 45), dark: (48, 90, 55))
)
/// neutral-Variant aus `mana/packages/themes/src/variants/neutral.css`.
static let neutral = ManaThemeColors(
background: Color.manaToken(light: (0, 0, 99), dark: (0, 0, 8)),
foreground: Color.manaToken(light: (0, 0, 13), dark: (0, 0, 95)),
surface: Color.manaToken(light: (0, 0, 100), dark: (0, 0, 12)),
surfaceHover: Color.manaToken(light: (0, 0, 96), dark: (0, 0, 17)),
muted: Color.manaToken(light: (0, 0, 94), dark: (0, 0, 18)),
mutedForeground: Color.manaToken(light: (0, 0, 45), dark: (0, 0, 65)),
border: Color.manaToken(light: (0, 0, 88), dark: (0, 0, 22)),
primary: Color.manaToken(light: (215, 60, 40), dark: (215, 70, 60)),
primaryForeground: Color.manaToken(light: (0, 0, 100), dark: (0, 0, 8)),
error: Color.manaToken(light: (0, 65, 45), dark: (0, 63, 55)),
success: Color.manaToken(light: (135, 35, 35), dark: (135, 35, 55)),
warning: Color.manaToken(light: (38, 92, 45), dark: (48, 96, 53))
)
/// paper-Variant aus `mana/packages/themes/src/variants/paper.css`.
static let paper = ManaThemeColors(
background: Color.manaToken(light: (38, 28, 95), dark: (24, 14, 9)),
foreground: Color.manaToken(light: (20, 14, 16), dark: (38, 24, 88)),
surface: Color.manaToken(light: (0, 0, 100), dark: (24, 12, 13)),
surfaceHover: Color.manaToken(light: (38, 24, 92), dark: (24, 14, 17)),
muted: Color.manaToken(light: (38, 20, 90), dark: (24, 12, 18)),
mutedForeground: Color.manaToken(light: (20, 14, 50), dark: (38, 12, 60)),
border: Color.manaToken(light: (38, 18, 80), dark: (24, 10, 25)),
primary: Color.manaToken(light: (18, 50, 38), dark: (24, 60, 65)),
primaryForeground: Color.manaToken(light: (0, 0, 100), dark: (24, 14, 9)),
error: Color.manaToken(light: (0, 65, 45), dark: (0, 60, 55)),
success: Color.manaToken(light: (135, 35, 35), dark: (135, 35, 55)),
warning: Color.manaToken(light: (38, 80, 40), dark: (38, 70, 55))
)
/// skylight-Variant aus `mana/packages/themes/src/variants/skylight.css`.
static let skylight = ManaThemeColors(
background: Color.manaToken(light: (205, 50, 99), dark: (215, 40, 9)),
foreground: Color.manaToken(light: (215, 30, 15), dark: (205, 25, 95)),
surface: Color.manaToken(light: (0, 0, 100), dark: (215, 35, 13)),
surfaceHover: Color.manaToken(light: (205, 40, 95), dark: (215, 30, 18)),
muted: Color.manaToken(light: (205, 30, 93), dark: (215, 30, 19)),
mutedForeground: Color.manaToken(light: (215, 15, 45), dark: (205, 18, 65)),
border: Color.manaToken(light: (205, 25, 88), dark: (215, 25, 24)),
primary: Color.manaToken(light: (205, 90, 40), dark: (205, 90, 60)),
primaryForeground: Color.manaToken(light: (0, 0, 100), dark: (215, 40, 9)),
error: Color.manaToken(light: (0, 80, 50), dark: (0, 70, 60)),
success: Color.manaToken(light: (142, 65, 40), dark: (142, 65, 50)),
warning: Color.manaToken(light: (38, 92, 50), dark: (48, 95, 55))
)
/// twilight-Variant aus `mana/packages/themes/src/variants/twilight.css`.
static let twilight = ManaThemeColors(
background: Color.manaToken(light: (250, 30, 97), dark: (260, 35, 8)),
foreground: Color.manaToken(light: (260, 25, 15), dark: (250, 20, 92)),
surface: Color.manaToken(light: (250, 40, 99), dark: (260, 30, 12)),
surfaceHover: Color.manaToken(light: (260, 30, 94), dark: (260, 28, 17)),
muted: Color.manaToken(light: (260, 25, 92), dark: (260, 25, 19)),
mutedForeground: Color.manaToken(light: (260, 15, 45), dark: (250, 15, 65)),
border: Color.manaToken(light: (260, 20, 87), dark: (260, 20, 25)),
primary: Color.manaToken(light: (260, 70, 55), dark: (260, 75, 70)),
primaryForeground: Color.manaToken(light: (0, 0, 100), dark: (260, 35, 10)),
error: Color.manaToken(light: (0, 75, 55), dark: (0, 65, 60)),
success: Color.manaToken(light: (142, 60, 45), dark: (142, 60, 55)),
warning: Color.manaToken(light: (38, 90, 55), dark: (48, 90, 55))
)
}

View file

@ -0,0 +1,54 @@
import SwiftUI
/// Eine der acht Verein-Theme-Variants aus `mana/packages/themes`.
///
/// Die Werte-Schicht (``ManaThemeColors``) wird per `colors`-Accessor
/// geliefert. Convenience-Properties (`background`, `foreground`, )
/// erlauben Apps, ohne `.colors`-Indirektion zu schreiben:
///
/// ```swift
/// ManaTheme.forest.foreground // Convenience
/// ManaTheme.forest.colors.foreground // explizit
/// ```
///
/// Für User-Theme-Switching nutze ``SwiftUICore/View/manaTheme(_:)``
/// und lese im View per `@Environment(\.manaTheme)`.
public enum ManaTheme: String, CaseIterable, Sendable {
case mana
case forest
case paper
case neutral
case lume
case twilight
case skylight
case monochrome
/// Konkrete Token-Werte für diese Variant.
public var colors: ManaThemeColors {
switch self {
case .mana: return .mana
case .forest: return .forest
case .paper: return .paper
case .neutral: return .neutral
case .lume: return .lume
case .twilight: return .twilight
case .skylight: return .skylight
case .monochrome: return .monochrome
}
}
// MARK: Convenience-Accessors
public var background: Color { colors.background }
public var foreground: Color { colors.foreground }
public var surface: Color { colors.surface }
public var surfaceHover: Color { colors.surfaceHover }
public var muted: Color { colors.muted }
public var mutedForeground: Color { colors.mutedForeground }
public var border: Color { colors.border }
public var primary: Color { colors.primary }
public var primaryForeground: Color { colors.primaryForeground }
public var error: Color { colors.error }
public var success: Color { colors.success }
public var warning: Color { colors.warning }
}

View file

@ -0,0 +1,76 @@
import SwiftUI
/// Die 12 Vereins-Tokens als konkrete Color-Werte für eine bestimmte
/// Theme-Variant. Wird heute per-Variant von ``ManaTheme/colors``
/// geliefert; die statischen Variants (``ManaThemeColors/mana``,
/// ``ManaThemeColors/forest`` etc.) leben im generierten File
/// `GeneratedThemes.swift`.
///
/// **Verwendung:**
///
/// ```swift
/// // Direkt:
/// Text("Hi").foregroundColor(ManaTheme.forest.foreground)
///
/// // Via Environment (für Apps, die User-Theme-Switching anbieten):
/// @Environment(\.manaTheme) var theme
/// Text("Hi").foregroundColor(theme.foreground)
/// ```
///
/// Beide Werte (`light:`, `dark:`) sind CSS-HSL-Tripel `(hue 0360,
/// saturation 0100, lightness 0100)`. Quelle:
/// `mana/packages/themes/src/variants/*.css`.
public struct ManaThemeColors: Sendable {
/// Token 1 `--color-background`. Page-Hintergrund.
public let background: Color
/// Token 2 `--color-foreground`. Standard-Text.
public let foreground: Color
/// Token 3 `--color-surface`. Card, Panel, Modal, Popover.
public let surface: Color
/// Token 4 `--color-surface-hover`. Hover-State auf Surface.
public let surfaceHover: Color
/// Token 5 `--color-muted`. Disabled-Felder, Skeleton.
public let muted: Color
/// Token 6 `--color-muted-foreground`. Sekundär-Text, Placeholder.
public let mutedForeground: Color
/// Token 7 `--color-border`. Rahmen, Trennlinien.
public let border: Color
/// Token 8 `--color-primary`. App-Akzent.
public let primary: Color
/// Token 9 `--color-primary-foreground`. Text auf Primary-Flächen.
public let primaryForeground: Color
/// Token 10 `--color-error`. Fehler, Lösch-Aktion.
public let error: Color
/// Token 11 `--color-success`. Erfolg, Bestätigung.
public let success: Color
/// Token 12 `--color-warning`. Warnung, Aufmerksamkeit.
public let warning: Color
public init(
background: Color,
foreground: Color,
surface: Color,
surfaceHover: Color,
muted: Color,
mutedForeground: Color,
border: Color,
primary: Color,
primaryForeground: Color,
error: Color,
success: Color,
warning: Color
) {
self.background = background
self.foreground = foreground
self.surface = surface
self.surfaceHover = surfaceHover
self.muted = muted
self.mutedForeground = mutedForeground
self.border = border
self.primary = primary
self.primaryForeground = primaryForeground
self.error = error
self.success = success
self.warning = warning
}
}

View file

@ -0,0 +1,37 @@
import SwiftUI
private struct ManaThemeEnvironmentKey: EnvironmentKey {
static let defaultValue: ManaTheme = .mana
}
public extension EnvironmentValues {
/// Aktuell aktive Theme-Variant. Default: ``ManaTheme/mana``.
var manaTheme: ManaTheme {
get { self[ManaThemeEnvironmentKey.self] }
set { self[ManaThemeEnvironmentKey.self] = newValue }
}
}
public extension View {
/// Setzt die aktive Theme-Variant für diesen View-Subtree.
///
/// Apps mit fixer Identität setzen das an der App-Root:
///
/// ```swift
/// @main
/// struct CardsApp: App {
/// var body: some Scene {
/// WindowGroup {
/// ContentView()
/// .manaTheme(.forest)
/// }
/// }
/// }
/// ```
///
/// Apps mit User-Theme-Switching binden den Wert an `@AppStorage`
/// oder eine Settings-Source und re-rendern bei Wechsel automatisch.
func manaTheme(_ theme: ManaTheme) -> some View {
environment(\.manaTheme, theme)
}
}

View file

@ -0,0 +1,102 @@
import SwiftUI
import Testing
@testable import ManaTokens
@Suite("ManaTheme Variants")
struct ThemeTests {
@Test("Alle 8 Variants sind im enum vorhanden")
func allCasesPresent() {
let cases = ManaTheme.allCases.map(\.rawValue).sorted()
#expect(cases == [
"forest",
"lume",
"mana",
"monochrome",
"neutral",
"paper",
"skylight",
"twilight",
])
}
@Test("Jede Variant liefert nicht-leere Colors")
func everyVariantHasColors() {
for variant in ManaTheme.allCases {
let colors = variant.colors
// Existenz-Smoke Color hat keinen Equatable-Color-Vergleich,
// aber wir können die Properties gegen Optional/Crash absichern.
let _: Color = colors.background
let _: Color = colors.foreground
let _: Color = colors.surface
let _: Color = colors.surfaceHover
let _: Color = colors.muted
let _: Color = colors.mutedForeground
let _: Color = colors.border
let _: Color = colors.primary
let _: Color = colors.primaryForeground
let _: Color = colors.error
let _: Color = colors.success
let _: Color = colors.warning
}
}
@Test("Convenience-Accessor matcht colors-Accessor")
func convenienceMatchesColors() {
// Identitäts-Smoke beide Pfade müssen denselben Color-Wert liefern.
// Color ist nicht Equatable, also testen wir, dass es überhaupt
// möglich ist, beide Pfade typkorrekt zu nutzen.
let theme = ManaTheme.forest
let direct = theme.background
let viaColors = theme.colors.background
let _: (Color, Color) = (direct, viaColors)
}
@Test("forest.primary entspricht forest.css (142, 76, 28)")
func forestPrimaryMatchesSpec() {
// Wir rekonstruieren den erwarteten Light-Wert aus HSL und
// vergleichen mit dem, was `Color.manaToken` für denselben Input
// liefert. Da `Color`-Vergleich nicht direkt möglich ist, prüfen
// wir indirekt über PlatformColor.fromHSL.
let expected = PlatformColor.fromHSL(142, 76, 28)
let components = rgbComponents(of: expected)
// Forest-Primary Light: HSL(142, 76, 28) ~RGB(0.067, 0.493, 0.231)
#expect(approxEqual(components.r, 0.067, tolerance: 0.02))
#expect(approxEqual(components.g, 0.493, tolerance: 0.02))
#expect(approxEqual(components.b, 0.231, tolerance: 0.02))
}
@Test("ManaTheme ist via rawValue rekonstruierbar")
func rawValueRoundtrip() {
for variant in ManaTheme.allCases {
let raw = variant.rawValue
let roundtrip = ManaTheme(rawValue: raw)
#expect(roundtrip == variant)
}
}
@Test("Environment-Default ist mana")
func environmentDefault() {
// Wir können das Environment hier nicht direkt anzapfen ohne
// einen Host-View, aber wir spiegeln das Default per Konstante:
// ManaThemeEnvironmentKey.defaultValue ist auf .mana gesetzt.
// Smoke-Test, der die Konvention dokumentiert.
#expect(ManaTheme.allCases.contains(.mana))
}
}
// MARK: - Helpers
private func rgbComponents(of color: PlatformColor) -> (r: Double, g: Double, b: Double) {
#if canImport(UIKit)
var r: CGFloat = 0, g: CGFloat = 0, b: CGFloat = 0, a: CGFloat = 0
color.getRed(&r, green: &g, blue: &b, alpha: &a)
return (Double(r), Double(g), Double(b))
#else
let space = color.usingColorSpace(.deviceRGB) ?? color
return (Double(space.redComponent), Double(space.greenComponent), Double(space.blueComponent))
#endif
}
private func approxEqual(_ a: Double, _ b: Double, tolerance: Double = 0.001) -> Bool {
abs(a - b) < tolerance
}