Phase 2 (Teil 1): Widget-Raster, Layout-Engine, Persistenz

Layout-Engine mit vier Spalten, testgetrieben. Widgets werden nicht stur
hintereinander gesetzt, sondern jeweils an die erste Stelle, an die sie passen.
Der Unterschied zeigt sich neben einem 2x2-Widget: dort bleiben rechts zwei
1x1-Plätze frei, die ein reines Anhängen dauerhaft leer ließe.

Persistenz unterscheidet zwei Fälle, die gleich aussehen und es nicht sind. Eine
leere Layout-Datei ist eine Aussage — der Nutzer hat alle Widgets entfernt. Eine
Datei, aus der nach dem Filtern unbekannter Kennungen nichts übrig bleibt, ist
dagegen ein Zeichen, dass sich die Kennungen geändert haben; dort wäre ein leeres
Panel eine stille Fehlfunktion, also greift das Standardlayout.

Beschädigte und fehlende Dateien führen beide zum Standardlayout statt zu einem
Absturz oder einem leeren Panel.

Die Panelgröße folgt dem Layout statt umgekehrt. Positioniert wird über
LayoutEngine.frame, nicht über LazyVGrid — das kann keine Kacheln über zwei
Zeilen führen, und genau das braucht der Mini-Monat.

Platzhalter-Widgets für alle 13 geplanten Karten. Sie tragen die endgültigen
Kennungen, damit gespeicherte Layouts weitergelten, wenn die echten Widgets sie
Phase für Phase ersetzen.

66 Tests grün.
This commit is contained in:
Guido Schmit
2026-08-10 17:32:48 +02:00
parent 715031f153
commit 8e0629d3a5
11 changed files with 750 additions and 36 deletions

View File

@@ -0,0 +1,73 @@
import SwiftUI
import OnyxDesign
import OnyxWidgetKit
/// Vorläufige Widgets für Phase 2.
///
/// Sie tragen keine echten Daten ihr Zweck ist zu belegen, dass Registry,
/// Layout-Engine, Persistenz und Panelgröße zusammenspielen, bevor die Provider
/// dazukommen. Jedes wird in seiner Phase durch das echte Widget ersetzt; die
/// Kennungen bleiben dabei gleich, damit gespeicherte Layouts weitergelten.
struct PlaceholderWidget: OnyxWidget {
let id: String
let displayName: String
let symbolName: String
let supportedSizes: [WidgetSize]
/// In welcher Phase dieses Widget echt wird.
let phase: String
func makeView(size: WidgetSize) -> AnyView {
AnyView(
VStack(alignment: .leading, spacing: 6) {
HStack(spacing: 6) {
Image(systemName: symbolName)
.font(.system(size: 12, weight: .medium))
.foregroundStyle(Onyx.Color.accent)
Text(displayName)
.font(Onyx.Font.caption)
.foregroundStyle(Onyx.Color.textSecondary)
}
Spacer(minLength: 0)
Text(phase)
.font(Onyx.Font.caption)
.foregroundStyle(Onyx.Color.textTertiary)
}
.frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
)
}
}
@MainActor
enum PlaceholderWidgets {
static func registerAll() {
let widgets: [PlaceholderWidget] = [
.init(id: "calendar", displayName: "Kalender", symbolName: "calendar",
supportedSizes: [.medium, .large], phase: "Phase 3"),
.init(id: "weather", displayName: "Wetter", symbolName: "cloud.sun",
supportedSizes: [.small, .medium], phase: "Phase 3"),
.init(id: "media", displayName: "Medien", symbolName: "play.circle",
supportedSizes: [.medium, .wide], phase: "Phase 4"),
.init(id: "cpu", displayName: "CPU", symbolName: "cpu",
supportedSizes: [.small, .medium], phase: "Phase 5"),
.init(id: "gpu", displayName: "GPU", symbolName: "cpu.fill",
supportedSizes: [.small, .medium], phase: "Phase 5"),
.init(id: "memory", displayName: "Speicher", symbolName: "memorychip",
supportedSizes: [.small, .medium], phase: "Phase 5"),
.init(id: "battery", displayName: "Akku", symbolName: "battery.100",
supportedSizes: [.small, .medium], phase: "Phase 5"),
.init(id: "sensors", displayName: "Sensoren", symbolName: "thermometer",
supportedSizes: [.medium, .large], phase: "Phase 5"),
.init(id: "network", displayName: "Netzwerk", symbolName: "network",
supportedSizes: [.small, .medium, .large], phase: "Phase 5"),
.init(id: "fans", displayName: "Lüfter", symbolName: "fan",
supportedSizes: [.small, .medium], phase: "Phase 6"),
.init(id: "audio", displayName: "Audio-Mixer", symbolName: "slider.horizontal.3",
supportedSizes: [.medium, .large], phase: "Phase 7"),
.init(id: "shelf", displayName: "Ablage", symbolName: "tray.full",
supportedSizes: [.small, .medium], phase: "Phase 8"),
.init(id: "airdrop", displayName: "AirDrop", symbolName: "shareplay",
supportedSizes: [.small], phase: "Phase 8"),
]
widgets.forEach { WidgetRegistry.shared.register($0) }
}
}