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:
50
Packages/OnyxKit/Sources/OnyxWidgetKit/OnyxWidget.swift
Normal file
50
Packages/OnyxKit/Sources/OnyxWidgetKit/OnyxWidget.swift
Normal 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 }
|
||||
}
|
||||
Reference in New Issue
Block a user