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

@@ -3,6 +3,7 @@ import AppKit
import OnyxDesign
import OnyxNotch
import OnyxMenuBar
import OnyxWidgetKit
@main
struct OnyxApp: App {
@@ -22,17 +23,28 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
private var menuBar: MenuBarController?
private var onyxItem: NSStatusItem?
private var layout: [WidgetPlacement] = []
func applicationDidFinishLaunching(_ notification: Notification) {
NSApp.setActivationPolicy(.accessory)
let coordinator = NotchCoordinator(policy: .builtInOnly) { displayID, presentation in
PlaceholderWidgets.registerAll()
let known = Set(WidgetRegistry.shared.all.map(\.id))
layout = LayoutStore.standard().load(knownWidgetIDs: known)
let placements = layout
let coordinator = NotchCoordinator(policy: .builtInOnly) { _, presentation in
NotchHostingView(
rootView: NotchContainer(presentation: presentation) {
NotchPanelContent(displayID: displayID)
WidgetGrid(placements: placements)
},
presentation: presentation)
}
coordinator.start()
// Die Panelgröße folgt dem Layout, nicht umgekehrt: wer ein Widget
// hinzufügt, soll nicht auch noch die Fenstergröße nachziehen müssen.
let size = WidgetGrid.panelSize(for: layout)
coordinator.activeControllers.forEach { $0.expandedSize = size }
self.coordinator = coordinator
let menuBar = MenuBarController()
@@ -80,35 +92,3 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
@objc private func quit() { NSApp.terminate(nil) }
}
/// Platzhalterinhalt für Phase 1. Er beweist, dass Fenster, Geometrie und
/// Zustandsmaschine zusammenspielen; die Widget-Ebene kommt in Phase 2.
private struct NotchPanelContent: View {
let displayID: CGDirectDisplayID
var body: some View {
ZStack {
OnyxSurface()
VStack(alignment: .leading, spacing: Onyx.Metric.tileSpacing) {
Text("Onyx")
.font(Onyx.Font.title)
.foregroundStyle(Onyx.Color.textPrimary)
Text("Phase 1 — Notch-Shell steht.")
.font(Onyx.Font.body)
.foregroundStyle(Onyx.Color.textSecondary)
HStack(spacing: Onyx.Metric.tileSpacing) {
ForEach(["Kalender", "Wetter", "Medien"], id: \.self) { name in
OnyxTile {
Text(name)
.font(Onyx.Font.caption)
.foregroundStyle(Onyx.Color.textTertiary)
}
}
}
}
.padding(Onyx.Metric.panelPadding)
}
}
}

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) }
}
}