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,50 @@
import SwiftUI
/// Ein Widget im Notch-Panel.
///
/// Das Panel kennt ausschließlich dieses Protokoll. Ein neues Widget kommt
/// dazu, indem es sich bei der Registry meldet am Panel selbst ändert sich
/// dafür keine Zeile.
@MainActor
public protocol OnyxWidget: Identifiable, Sendable {
/// Stabil über App-Versionen hinweg: dieser Wert steht in der Layout-Datei.
var id: String { get }
/// Lokalisierter Name für die Einstellungen.
var displayName: String { get }
var symbolName: String { get }
/// Welche Größen dieses Widget sinnvoll ausfüllen kann.
var supportedSizes: [WidgetSize] { get }
@ViewBuilder func makeView(size: WidgetSize) -> AnyView
/// Einstellungen dieses Widgets, falls es welche hat.
@ViewBuilder func makeSettingsView() -> AnyView?
}
public extension OnyxWidget {
func makeSettingsView() -> AnyView? { nil }
}
/// Alle bekannten Widgets. Die App füllt sie beim Start.
@MainActor
public final class WidgetRegistry {
public static let shared = WidgetRegistry()
private var widgets: [String: any OnyxWidget] = [:]
private var order: [String] = []
private init() {}
public func register(_ widget: any OnyxWidget) {
if widgets[widget.id] == nil { order.append(widget.id) }
widgets[widget.id] = widget
}
public func widget(id: String) -> (any OnyxWidget)? { widgets[id] }
/// In Registrierungsreihenfolge das ist auch die Reihenfolge in den
/// Einstellungen.
public var all: [any OnyxWidget] { order.compactMap { widgets[$0] } }
public func contains(_ id: String) -> Bool { widgets[id] != nil }
}