fbe13fd1cb
Zustandsmaschine und Geometrie sind testgetrieben entstanden und tragen 40 Tests — sie sind frei von AppKit, damit jeder Übergang ohne Fenster und ohne Warten prüfbar ist. Zeit kommt nur als Ereignis herein. Zwei Entscheidungen, die im Code begründet sind: Der Zeiger wird über einen globalen Ereignismonitor verfolgt, nicht über ein unsichtbares Fenster auf der Notch. Ein solches Fenster müsste Mausereignisse annehmen, um sie zu bemerken, und würde damit Menüleiste und Fensterknöpfe darunter unbenutzbar machen. "Nur internes Display" fällt auf ein externes zurück, wenn kein eingebautes da ist. Am Dock mit geschlossenem Deckel hieße die Einstellung wörtlich genommen, dass Onyx unerreichbar wird. Design: NSVisualEffectView mit eigenem Tint statt Liquid Glass — Onyx ist Stein, kein Glas. Alle Farben und Maße liegen als Tokens in OnyxDesign. Menüleiste: jedes Modul bekommt ein eigenes NSStatusItem. Elemente, denen macOS mangels Platz keine Breite gibt, werden erkannt und gemeldet, statt still zu verschwinden. App-Target über XcodeGen, damit die Projektdefinition im Diff lesbar bleibt. Nicht sandboxed, mit App-Group-Entitlement — baut, startet, signiert mit PP34X97WS3.
65 lines
2.2 KiB
Swift
65 lines
2.2 KiB
Swift
import AppKit
|
||
import SwiftUI
|
||
|
||
/// Wie ein Modul seinen Messwert in der Menüleiste zeichnet.
|
||
public enum MenuBarPresentation: String, Codable, Sendable, CaseIterable, Identifiable {
|
||
/// Nur die Zahl, z. B. `34 %` oder `↓ 2,4 MB/s`.
|
||
case value
|
||
/// Schmales Verlaufsdiagramm über die letzten Messungen.
|
||
case graph
|
||
/// Ein Balken je Cluster bzw. je Richtung.
|
||
case bars
|
||
case valueAndGraph
|
||
/// Nur ein Glyph, nach Grenzwert eingefärbt.
|
||
case symbol
|
||
|
||
public var id: String { rawValue }
|
||
}
|
||
|
||
/// Die Menüleisten-Entsprechung zu einem Widget.
|
||
///
|
||
/// Ein Modul liefert nur Darstellung. Die Daten kommen aus demselben Provider,
|
||
/// den auch das Panel-Widget benutzt — es gibt keine zweite Messschleife.
|
||
@MainActor
|
||
public protocol MenuBarModule: AnyObject {
|
||
var id: String { get }
|
||
var displayName: String { get }
|
||
|
||
/// Zeichnet den kompakten Zustand. Muss eine feste Breite je Darstellungsart
|
||
/// liefern, sonst springt die ganze Menüleiste bei jedem Messwert.
|
||
func makeStatusView(presentation: MenuBarPresentation) -> NSView
|
||
|
||
/// Der Inhalt des Popovers beim Klick.
|
||
func makePopoverView() -> AnyView
|
||
|
||
/// Wird gerufen, wenn das Modul sichtbar wird bzw. verschwindet — hier
|
||
/// meldet sich das Modul beim Provider an und wieder ab.
|
||
func activate()
|
||
func deactivate()
|
||
}
|
||
|
||
/// Was der Nutzer je Modul eingestellt hat.
|
||
public struct MenuBarModuleSettings: Codable, Sendable, Equatable {
|
||
public var isEnabled: Bool
|
||
public var presentation: MenuBarPresentation
|
||
/// Abtastintervall in Sekunden, 1–10.
|
||
public var refreshInterval: TimeInterval
|
||
public var usesThresholdColors: Bool
|
||
|
||
public init(isEnabled: Bool = false,
|
||
presentation: MenuBarPresentation = .value,
|
||
refreshInterval: TimeInterval = 2,
|
||
usesThresholdColors: Bool = true) {
|
||
self.isEnabled = isEnabled
|
||
self.presentation = presentation
|
||
self.refreshInterval = refreshInterval.clamped(to: 1...10)
|
||
self.usesThresholdColors = usesThresholdColors
|
||
}
|
||
}
|
||
|
||
extension TimeInterval {
|
||
func clamped(to range: ClosedRange<TimeInterval>) -> TimeInterval {
|
||
Swift.min(Swift.max(self, range.lowerBound), range.upperBound)
|
||
}
|
||
}
|