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.
This commit is contained in:
Guido Schmit
2026-08-10 17:17:16 +02:00
parent 41ee3cc174
commit fbe13fd1cb
24 changed files with 2204 additions and 0 deletions

View File

@@ -0,0 +1,68 @@
import AppKit
/// Das Fenster, in dem das Notch-Panel lebt.
///
/// Zwei Anforderungen kollidieren hier: es muss über allem liegen, auch über der
/// Menüleiste und es darf der aktiven App niemals den Fokus wegnehmen. Wer beim
/// Blick auf den Kalender den Cursor aus seinem Editor verliert, benutzt das
/// Panel kein zweites Mal.
public final class NotchPanel: NSPanel {
public init(contentRect: NSRect) {
super.init(contentRect: contentRect,
styleMask: [.borderless, .nonactivatingPanel],
backing: .buffered,
defer: false)
isFloatingPanel = true
// Ohne das wird das Panel beim ersten Klick zum Schlüsselfenster und
// entzieht der aktiven App den Fokus.
becomesKeyOnlyIfNeeded = true
hidesOnDeactivate = false
// Über der Menüleiste, aber unter Bildschirmschoner und Anmeldefenster.
level = NSWindow.Level(rawValue: Int(CGWindowLevelForKey(.statusWindow)) + 1)
// Auf allen Schreibtischen sichtbar und auch neben Vollbildfenstern,
// ohne beim Umschalten mitzuwandern.
collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary,
.stationary, .ignoresCycle]
backgroundColor = .clear
isOpaque = false
hasShadow = true
isMovable = false
isMovableByWindowBackground = false
animationBehavior = .none
// Nicht in Bildschirmaufnahmen und Fensterlisten auftauchen.
isExcludedFromWindowsMenu = true
}
/// Randlose Fenster gelten sonst als nicht fokussierbar das bräuchten wir
/// aber, damit `esc` im fixierten Zustand ankommt.
public override var canBecomeKey: Bool { true }
public override var canBecomeMain: Bool { false }
}
/// Der unsichtbare Fühler über der Notch.
///
/// Er zeichnet nichts und nimmt keine Klicks an `ignoresMouseEvents` bleibt an,
/// sonst würden die Menüleiste und die Fensterknöpfe darunter unerreichbar.
/// Die Zeigerposition kommt aus einem globalen Monitor, nicht aus diesem Fenster;
/// das Fenster dient nur der Sichtprüfung beim Entwickeln.
public final class NotchDebugOverlay: NSPanel {
public init(frame: NSRect) {
super.init(contentRect: frame,
styleMask: [.borderless, .nonactivatingPanel],
backing: .buffered,
defer: false)
level = NSWindow.Level(rawValue: Int(CGWindowLevelForKey(.statusWindow)) + 2)
collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .stationary]
backgroundColor = NSColor.systemPink.withAlphaComponent(0.25)
isOpaque = false
hasShadow = false
ignoresMouseEvents = true
}
}