Phase 1: Notch-Shell, Design-System, Menüleisten-Infrastruktur

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.

Packages/OnyxKit/Sources/OnyxMenuBar/MenuBarModule.swift

@@ -0,0 +1,64 @@
+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)
+    }
+}