TerminalBasic/openspec/changes/archive/2026-09-08-phase-6-07a-fensterlokale-control-menues/design.md

## Context

`App` hält ein einziges Menüfeld `menu: Option<(usize, usize)>` für die Menüleiste (Menüindex, Eintrag) und ein Flag `control_menu: bool`. `Command::ControlMenu` setzt `control_menu = true` und `menu = Some((0, 0))`. Dadurch gilt in `render.rs` der Menüleistentitel mit Index 0 („File“) als ausgewählt und wird hervorgehoben. Der Aufklappbereich wird in `render.rs` mit `Rect::new(x, 1, …)` gezeichnet; `x` ist bei Control-Menü nur die linke Fensterkante, `y` ist fest die Zeile unter der Menüleiste. Das Popup steht deshalb nicht am `[≡]`-Symbol des Fensters, sondern wandert an den oberen Bildschirmrand und überdeckt fremde Fenster.

Die Tastenverteilung im Menüzustand blockiert Links/Rechts, wenn `control_menu` gesetzt ist, erlaubt aber Alt+Mnemonic-Wechsel in die Menüleiste. Der Hit-Bereich für `[≡]` existiert bereits nur für das aktive Fenster (`Hit::Command(Command::ControlMenu)` auf `Rect::new(rect.x, rect.y, 3, 1)`).

Beobachtung aus der Validierung: siehe `evidence/befund-2026-09-08.md`.

## Goals / Non-Goals

**Goals:** Control-Menü als fensterlokales Popup am Symbol; keine sichtbare oder logische Kopplung an einen Menüleistentitel; bestehende Tasten- und Mausbedienung unverändert; prüfbare Renderposition.

**Non-Goals:** Neues Menüsystem, Änderung der Menüleisten-Aufklappposition, neue Befehle im Control-Menü, Control-Menü für inaktive Fenster, Änderung des Themes.

## Decisions

1. Den Control-Menü-Zustand von der Menüleiste trennen: `control_menu` trägt die Auswahl selbst (z. B. `Option<usize>` für den gewählten Eintrag) statt `menu = Some((0, 0))` zu missbrauchen. `menu` bleibt bei offenem Control-Menü `None`. Damit hebt die Menüleiste nichts hervor, ohne dass der Renderer Sonderfälle braucht. Die gemeinsame Tastenlogik (Auf/Ab, Enter, Mnemonic, Esc) wird über eine kleine Abstraktion „offene Liste“ geteilt, die beide Zustände bedient; keine zweite Kopie der Eintragsnavigation.
2. Eine einzige Platzierungsfunktion für alle `WindowKind`-Varianten (Code, Project, Output, Immediate, Debug, Calls, Help, Toolbox, Palette, MenuDesign). Ankerpunkt ist die Zelle des `[≡]`-Symbols im aktuellen Fensterrechteck `self.rect(w)`: Popup-x = `rect.x`, bevorzugt Popup-y = `rect.y + 1` (erste Zeile unter der Titelzeile). Das gilt für Normal, Maximized (Rechteck = Arbeitsfläche) und Minimized (Titelzeile des minimierten Fensters am unteren Rand). Bei Alt+Minus und Mausklick identisch, da beide `Command::ControlMenu` ausführen. Kein fensterartspezifischer Sonderfall.
3. Anheftregel bei Platzmangel, in dieser Reihenfolge: (a) Passt die Popup-Höhe nicht zwischen `rect.y + 1` und die Statuszeile, klappt das Popup nach oben: Popup-Unterkante = `rect.y - 1`, Popup-y = `rect.y - Höhe`. Minimierte Fenster liegen laut `rect()` immer zwei Zeilen über der Statuszeile und treffen damit stets diesen Fall. (b) Passt es auch oben nicht vollständig, wird die Richtung mit mehr Platz gewählt und die vorhandene Scroll-Logik für Einträge greift; die Titelzeile des eigenen Fensters wird nie überdeckt. (c) Ragt es rechts hinaus, wird x nur so weit reduziert, dass `x + Breite <= area.right()`; da die Breite größer als drei Zellen ist, bleibt die Symbolspalte `rect.x..rect.x+3` überdeckt. Die visuelle Verbindung zum Symbol bleibt in allen Fällen: eine Popup-Kante grenzt an die Titelzeile, und die Symbolspalte liegt innerhalb der Popup-Breite.
4. Zeichenreihenfolge: Das Popup wird nach allen Fenstern und vor der Statuszeile mit `Clear` gezeichnet, so wie heute die Menüleisten-Popups; es überdeckt Fensterinhalt lokal, nicht die Menüleiste.
5. Alt+Mnemonic aus dem offenen Control-Menü wechselt weiterhin in die Menüleiste (bestehendes Verhalten); dabei wird das Control-Menü geschlossen. Links/Rechts bleiben im Control-Menü ohne Wirkung. Esc schließt das Control-Menü, der Fokus bleibt im Fenster, die Statuszeile zeigt die Fensterkürzel.
6. Nachweis über TestBackend für mehrere Fensterarten (mindestens Code, Project, Output, Immediate): Nach Alt+Minus und `draw` wird geprüft, dass der Rahmen des Popups in Zeile `rect.y + 1` ab Spalte `rect.x` beginnt, dass die Zelle „File“ in Zeile 0 den normalen Menüstil trägt, dass bei einem minimierten Fenster (Ctrl+F9) die Popup-Unterkante in `rect.y - 1` liegt und die linke Spalte `rect.x` ist, dass ein per Ctrl+F7 an den rechten Rand verschobenes Fenster ein Popup mit `x + Breite <= area.right()` und `x <= rect.x` erhält, und dass nach Ctrl+F10 (Maximize) das Popup unter der Titelzeile des maximierten Rechtecks liegt. Keine rein textuellen Snapshots.

7. Nebenbefunde der Windows-Testausführung werden im selben Change behoben, ohne die Fensterlogik zu berühren: `prepare_publication` öffnet die Temporärdatei vor `sync_all` schreibend; `relative_path` schreibt Verweise immer mit `/`, weil `\` unter Linux/macOS kein Trenner ist und beide Plattformen `/` auflösen; zeilenendenabhängige Testvergleiche normalisieren CRLF. Details und Zahlen in `evidence/befund-2026-09-08.md`.

## Risks / Trade-offs

- Trennung des Zustands berührt alle Stellen, die `self.menu.is_some()` als „ein Menü ist offen“ lesen (Tasten- und Mausverteilung) → gezielt in eine Hilfsfunktion `menu_open()` zusammenführen, damit Klick außerhalb und Esc beide Zustände schließen.
- Bei sehr kleinem Terminal passt das Popup weder unter noch über die Titelzeile → Richtung mit mehr Platz und vorhandene Eintrags-Scroll-Logik; das eigene Symbol bleibt sichtbar, ein Teil der Einträge ist dann nur per Auf/Ab erreichbar.
- Hilfe-Referenz und Tutorial nennen Alt+Minus, aber keinen Ort → Abschnitt 2 der `ide-referenz.md` um einen Satz ergänzen, keine Änderung der Hilfeseiten nötig.

## Migration Plan

Keine Datenmigration. Änderung in `app.rs`, `render.rs`, Test in `tests/app.rs`, ein Satz in `docs/ide-referenz.md`. Rücknahme durch Revert des Commits; keine gespeicherten Zustände betroffen.