Files
onyx/Packages/OnyxKit/Sources/OnyxWidgetKit/WidgetGrid.swift
Guido Schmit 8e0629d3a5 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.
2026-08-10 17:32:48 +02:00

57 lines
2.1 KiB
Swift

import SwiftUI
import OnyxDesign
/// Zeichnet ein aufgelöstes Layout.
///
/// Die Positionen kommen aus `LayoutEngine`, nicht aus einem SwiftUI-Grid. Ein
/// `LazyVGrid` kann keine Kacheln über zwei Zeilen führen, und genau das braucht
/// der Mini-Monat.
public struct WidgetGrid: View {
private let resolved: [ResolvedPlacement]
private let panelSize: CGSize
public init(placements: [WidgetPlacement]) {
self.resolved = LayoutEngine.resolve(placements)
self.panelSize = LayoutEngine.panelSize(for: resolved)
}
public var body: some View {
ZStack(alignment: .topLeading) {
ForEach(resolved) { item in
let frame = LayoutEngine.frame(for: item, in: panelSize)
widgetView(for: item)
.frame(width: frame.width, height: frame.height)
.offset(x: frame.minX, y: frame.minY)
}
}
.frame(width: panelSize.width, height: panelSize.height, alignment: .topLeading)
}
@ViewBuilder
private func widgetView(for item: ResolvedPlacement) -> some View {
if let widget = WidgetRegistry.shared.widget(id: item.placement.widgetID) {
OnyxTile { widget.makeView(size: item.placement.size) }
} else {
// Sollte nach dem Filtern in LayoutStore nicht vorkommen. Falls doch,
// ist eine sichtbare Lücke mit Namen besser als ein stiller Ausfall.
OnyxTile {
VStack(spacing: 4) {
Image(systemName: "questionmark.square.dashed")
Text(item.placement.widgetID)
.font(Onyx.Font.caption)
}
.foregroundStyle(Onyx.Color.textTertiary)
.frame(maxWidth: .infinity, maxHeight: .infinity)
}
}
}
/// Die Größe, die das Panel für dieses Layout braucht der Controller
/// stellt das Fenster darauf ein.
public static func panelSize(for placements: [WidgetPlacement]) -> CGSize {
LayoutEngine.panelSize(for: LayoutEngine.resolve(placements))
}
}