Phase 4: Steuerelemente implementieren

openspec/changes/archive/2026-09-05-phase-4-steuerelemente/design.md

@@ -5,7 +5,7 @@
 Siehe proposal.md — Why. Dieser Change setzt auf drei fertigen Stücken
 auf: dem Zellenpuffer aus Phase 3, der Ereignisschleife samt Mausquelle
 (`phase-4-ereignisschleife`) und dem Objektmodell
-(`phase-4-objektmodell`). Er ist der breiteste Change der Phase — 15
+(`phase-4-objektmodell`). Er ist der breiteste Change der Phase — 16
 Klassen, Menüs, Dialoge —, aber der mit den wenigsten offenen
 Architekturfragen.
 
@@ -94,9 +94,16 @@ Einhängepunkte der Plattform; DirListBox und FileListBox arbeiten auf
 Pfaden. `Pattern` bleibt das Muster des Vorbilds. Die Abweichung wird in
 der Sprachreferenz festgehalten.
 
+### D7 — Korpusbefunde werden im gemeinsamen Ausführungspfad geschlossen
+
+Die VBDOS-Projekte laufen durch denselben CLI-, Frontend-, VM- und
+Zellenpufferpfad wie eigene Programme. Projekt- und Include-Auflösung,
+VSpin/HSpin, Common-Dialog-Routinen und die tatsächlich verwendete Grafik
+werden deshalb dort implementiert und getestet, nicht im Korpus umgangen.
+
 ## Risks / Trade-offs
 
-- **Breite statt Tiefe** → 15 Klassen sind viel Fläche für Flüchtigkeit;
+- **Breite statt Tiefe** → 16 Klassen sind viel Fläche für Flüchtigkeit;
   jede Klasse bekommt ihren eigenen Korpusnachweis, nicht nur einen
   gemeinsamen Sammeltest.
 - **Vollständiges Neuzeichnen bei großen Terminals** → bei 200×60 sind es
@@ -109,6 +116,4 @@ der Sprachreferenz festgehalten.
 
 ## Open Questions
 
-- Ob die PictureBox als Container für OptionButton-Gruppen dieselbe
-  Fokuslogik wie der Frame braucht, zeigt der erste Korpusnachweis mit
-  gruppierten Optionsfeldern.
+Keine.

openspec/changes/archive/2026-09-05-phase-4-steuerelemente/proposal.md

@@ -18,7 +18,7 @@ zwischen die Aufgaben.
 - **Steuerelementklassen mit Verhalten**: CommandButton, TextBox,
   ListBox, ComboBox, CheckBox, OptionButton, Frame, Label, HScrollBar,
   VScrollBar, PictureBox, Timer sowie die Dateisystem-Steuerelemente
-  DirListBox, DriveListBox und FileListBox — je mit Darstellung,
+  DirListBox, DriveListBox, FileListBox und VSpin/HSpin — je mit Darstellung,
   Zuständen (normal, fokussiert, deaktiviert) und ihren Methoden.
 - **Darstellung im Zellenpuffer**: Steuerelemente zeichnen in den
   vorhandenen Textbildschirm; es entsteht keine zweite Zeichenschicht.
@@ -43,10 +43,13 @@ zwischen die Aufgaben.
   Positionierung in Zeichen.
 - **Timer als Steuerelement**: `Interval` 0–65 535 ms auf der Zeitquelle
   der Ereignisschleife, Ereignis `Timer`.
+- **VBDOS-Kompatibilität**: `.MAK`- und `$INCLUDE`-Auflösung, `RUN`,
+  VSpin/HSpin, die verwendete Zellgrafik (`SCREEN`, `LINE`, `PAINT`, `VIEW`)
+  und die von den Beispielen benutzten Common-Dialog-Routinen.
 
-**Non-Goals:** Der Formular-Designer und die Projektverwaltung (Phase 5);
-native Erweiterungssteuerelemente (Stufe 2); grafische Ausgabe in der
-PictureBox — sie ist eine Textzeichenfläche.
+**Non-Goals:** Der Formular-Designer (Phase 5). Für den geforderten
+VBDOS-Kompatibilitätsnachweis notwendige Projektauflösung, native
+Erweiterungssteuerelemente und Grafikausgabe gehören zu diesem Change.
 
 ## Capabilities
 
@@ -66,10 +69,10 @@ PictureBox — sie ist eine Textzeichenfläche.
 
 - `crates/tb-ui`: Darstellung und Eingabebehandlung je Klasse, Menüs,
   Dialoge, Trefferprüfung, Fokusverwaltung.
-- `crates/tb-runtime`: Fehler 260–480 des Forms-Bereichs als Auslöser;
-  `MSGBOX`/`INPUTBOX$` als Sprachelemente.
+- `crates/tb-runtime`: Fehler 260–480 des Forms-Bereichs als Auslöser,
+  `MSGBOX`/`INPUTBOX$` und die benötigte Zellgrafik.
 - `crates/tb-frontend`: Signaturen von `MSGBOX` (Anweisung und Funktion)
-  und `INPUTBOX$`; die `Unsupported`-Absenkung von `MSGBOX` entfällt.
+  und `INPUTBOX$`, Projektquellen, `RUN` und die verwendete Grafiksyntax.
 - `tests/compat`: Formularprogramme mit Sollausgabe; die Programme aus
   `github.com/cout/vbdos` als Kompatibilitätsnachweis.
 - `docs/`: `forms-referenz.md` — die offenen Detailfragen (Optik je

openspec/changes/archive/2026-09-05-phase-4-steuerelemente/specs/kompat-testkorpus/spec.md

@@ -19,11 +19,10 @@ Listen-Steuerelement, ein Timer und ein modaler Dialog.
 
 ### Requirement: Kompatibilitätsnachweis an Fremdprogrammen
 Die Formularprogramme aus dem öffentlichen Bestand des Vorbilds SHALL
-sich ohne Non-Features übersetzen lassen und bedienbar sein. Ein
-Programm, das an einem Non-Feature scheitert, MUST das Element
-namentlich nennen; ein Scheitern aus anderem Grund MUST als Befund
-festgehalten werden.
+sich ohne Diagnosen oder Non-Features übersetzen lassen und bedienbar
+sein. Jeder entdeckte fehlende Sprach-, Projekt-, Formular- oder
+Laufzeitpfad MUST implementiert und als Befund festgehalten werden.
 
 #### Scenario: Fremdprogramm übersetzt
 - **WHEN** ein Formularprogramm des öffentlichen Bestands übersetzt wird
-- **THEN** entstehen keine Diagnosen außer namentlich genannten Non-Features
+- **THEN** entstehen keine Diagnosen und das Programm ist bedienbar

openspec/changes/archive/2026-09-05-phase-4-steuerelemente/tasks.md

@@ -1,49 +1,49 @@
 ## 1. Festlegungen vorab
 
-- [ ] 1.1 Optik je Klasse und Zustand (normal, fokussiert, deaktiviert) als Zeichenbild in `docs/forms-referenz.md` festhalten, aus den Original-Screenshots abgeleitet (D3); verifiziert durch je ein Zeichenbild pro Klasse und Zustand
-- [ ] 1.2 Z-Reihenfolge und Timer-Reihenfolge festlegen und als unsere Festlegung kennzeichnen (D3); verifiziert durch die beiden Abschnitte in der Forms-Referenz
+- [x] 1.1 Optik je Klasse und Zustand (normal, fokussiert, deaktiviert) als Zeichenbild in `docs/forms-referenz.md` festhalten, aus den Original-Screenshots abgeleitet (D3); verifiziert durch je ein Zeichenbild pro Klasse und Zustand
+- [x] 1.2 Z-Reihenfolge und Timer-Reihenfolge festlegen und als unsere Festlegung kennzeichnen (D3); verifiziert durch die beiden Abschnitte in der Forms-Referenz
 
 ## 2. Darstellung und Eingabekette
 
-- [ ] 2.1 Zeichnen je Klasse aus dem Eigenschaftszustand in den Zellenpuffer (D1); verifiziert durch Snapshot-Tests je Klasse, darunter die drei Höhenformen des CommandButton
-- [ ] 2.2 Eingabekette für Tastatur und Maus (D2); verifiziert durch Unit-Tests, die je Station den Vorrang prüfen
-- [ ] 2.3 Trefferprüfung über die Z-Reihenfolge; verifiziert durch einen Test mit überlappenden Steuerelementen und einem Klick ins Formular
+- [x] 2.1 Zeichnen je Klasse aus dem Eigenschaftszustand in den Zellenpuffer (D1); verifiziert durch Snapshot-Tests je Klasse, darunter die drei Höhenformen des CommandButton
+- [x] 2.2 Eingabekette für Tastatur und Maus (D2); verifiziert durch Unit-Tests, die je Station den Vorrang prüfen
+- [x] 2.3 Trefferprüfung über die Z-Reihenfolge; verifiziert durch einen Test mit überlappenden Steuerelementen und einem Klick ins Formular
 
 ## 3. Fokus und Tastatur
 
-- [ ] 3.1 Tabreihenfolge über `TabIndex`/`TabStop` vorwärts und rückwärts, deaktivierte Elemente überspringen; verifiziert durch Unit-Tests je Fall
-- [ ] 3.2 Access-Keys aus `&`, `Default` für Enter, `Cancel` für Esc; verifiziert durch Unit-Tests je Auslöser
-- [ ] 3.3 `SETFOCUS`, `GotFocus`/`LostFocus` in der festgelegten Reihenfolge; verifiziert durch einen Test, der die Reihenfolge der beiden Ereignisse prüft
+- [x] 3.1 Tabreihenfolge über `TabIndex`/`TabStop` vorwärts und rückwärts, deaktivierte Elemente überspringen; verifiziert durch Unit-Tests je Fall
+- [x] 3.2 Access-Keys aus `&`, `Default` für Enter, `Cancel` für Esc; verifiziert durch Unit-Tests je Auslöser
+- [x] 3.3 `SETFOCUS`, `GotFocus`/`LostFocus` in der festgelegten Reihenfolge; verifiziert durch einen Test, der die Reihenfolge der beiden Ereignisse prüft
 
 ## 4. Steuerelementklassen
 
-- [ ] 4.1 CommandButton, Label, Frame, CheckBox, OptionButton (inkl. Gruppierung im Container); verifiziert durch Snapshot- und Verhaltenstests je Klasse
-- [ ] 4.2 TextBox mit `Text`, `SelStart`/`SelLength`/`SelText`, `MultiLine`, `ScrollBars`, Ereignis `Change`; verifiziert durch Tests für Eingabe, Auswahl und Umbruch
-- [ ] 4.3 ListBox und ComboBox mit `ADDITEM`/`REMOVEITEM`, `List`/`ListCount`/`ListIndex`, `Sorted`, den drei ComboBox-Stilarten; verifiziert durch Tests für Einfügen, Sortierung und „keine Auswahl"
-- [ ] 4.4 HScrollBar/VScrollBar mit `Min`/`Max`/`Value`/`SmallChange`/`LargeChange`/`Attached` und Ereignis `Change`; verifiziert durch Tests für Tastatur- und Mausbedienung
-- [ ] 4.5 PictureBox als Textzeichenfläche (`PRINT`, `CLS`, `CurrentX`/`CurrentY`, `TEXTWIDTH`/`TEXTHEIGHT`) und als Container; verifiziert durch Snapshot-Tests
-- [ ] 4.6 Timer auf der Zeitquelle der Ereignisschleife, Reihenfolge nach 1.2; verifiziert durch Tests mit virtueller Zeit für Abstand, `Interval = 0` und zwei gleichzeitig fällige Timer
-- [ ] 4.7 DirListBox, DriveListBox, FileListBox plattformneutral (D6) mit `Path`/`Drive`/`FileName`/`Pattern` und ihren Ereignissen; verifiziert durch Tests auf einem angelegten Verzeichnisbaum
-- [ ] 4.8 Ziehen und Ablegen: `DragMode`, `DRAG action%`, `DragOver` mit Zustand, `DragDrop` mit Quelle; verifiziert durch Tests für automatisches und manuelles Ziehen sowie Abbruch
+- [x] 4.1 CommandButton, Label, Frame, CheckBox, OptionButton (inkl. Gruppierung im Container); verifiziert durch Snapshot- und Verhaltenstests je Klasse
+- [x] 4.2 TextBox mit `Text`, `SelStart`/`SelLength`/`SelText`, `MultiLine`, `ScrollBars`, Ereignis `Change`; verifiziert durch Tests für Eingabe, Auswahl und Umbruch
+- [x] 4.3 ListBox und ComboBox mit `ADDITEM`/`REMOVEITEM`, `List`/`ListCount`/`ListIndex`, `Sorted`, den drei ComboBox-Stilarten; verifiziert durch Tests für Einfügen, Sortierung und „keine Auswahl"
+- [x] 4.4 HScrollBar/VScrollBar mit `Min`/`Max`/`Value`/`SmallChange`/`LargeChange`/`Attached` und Ereignis `Change`; verifiziert durch Tests für Tastatur- und Mausbedienung
+- [x] 4.5 PictureBox als Textzeichenfläche (`PRINT`, `CLS`, `CurrentX`/`CurrentY`, `TEXTWIDTH`/`TEXTHEIGHT`) und als Container; verifiziert durch Snapshot-Tests
+- [x] 4.6 Timer auf der Zeitquelle der Ereignisschleife, Reihenfolge nach 1.2; verifiziert durch Tests mit virtueller Zeit für Abstand, `Interval = 0` und zwei gleichzeitig fällige Timer
+- [x] 4.7 DirListBox, DriveListBox, FileListBox plattformneutral (D6) mit `Path`/`Drive`/`FileName`/`Pattern` und ihren Ereignissen; verifiziert durch Tests auf einem angelegten Verzeichnisbaum
+- [x] 4.8 Ziehen und Ablegen: `DragMode`, `DRAG action%`, `DragOver` mit Zustand, `DragDrop` mit Quelle; verifiziert durch Tests für automatisches und manuelles Ziehen sowie Abbruch
 
 ## 5. Menüs und Dialoge
 
-- [ ] 5.1 Menüleiste mit bis zu sechs Ebenen, Access-Keys, Shortcuts, `Checked`/`Enabled`/`Visible`/`Separator`, Menü-Arrays; verifiziert durch Snapshot- und Verhaltenstests, darunter die Regelverstöße (Separator mit Shortcut)
-- [ ] 5.2 Ereigniszustellung ruht im geöffneten Menü über den vorhandenen `STOP`-Zustand (D5); verifiziert durch einen Test mit fälligem Zeit-Trap bei offenem Menü
-- [ ] 5.3 `MSGBOX` als Anweisung und Funktion mit Schaltflächengruppen, Vorgabeschaltfläche und Rückgabewerten; verifiziert durch Tests je Gruppe und Rückgabewert
-- [ ] 5.4 `INPUTBOX$` mit fester Größe 46×16, Positionierung in Zeichen, leerem String bei Abbruch; verifiziert durch Snapshot-Test und Abbruchtest
-- [ ] 5.5 Frontend-Signaturen für `MSGBOX` (Anweisung und Funktion) und `INPUTBOX$`, `Unsupported`-Absenkung entfernen; verifiziert durch `cargo test -p tb-frontend`
+- [x] 5.1 Menüleiste mit bis zu sechs Ebenen, Access-Keys, Shortcuts, `Checked`/`Enabled`/`Visible`/`Separator`, Menü-Arrays; verifiziert durch Snapshot- und Verhaltenstests, darunter die Regelverstöße (Separator mit Shortcut)
+- [x] 5.2 Ereigniszustellung ruht im geöffneten Menü über den vorhandenen `STOP`-Zustand (D5); verifiziert durch einen Test mit fälligem Zeit-Trap bei offenem Menü
+- [x] 5.3 `MSGBOX` als Anweisung und Funktion mit Schaltflächengruppen, Vorgabeschaltfläche und Rückgabewerten; verifiziert durch Tests je Gruppe und Rückgabewert
+- [x] 5.4 `INPUTBOX$` mit fester Größe 46×16, Positionierung in Zeichen, leerem String bei Abbruch; verifiziert durch Snapshot-Test und Abbruchtest
+- [x] 5.5 Frontend-Signaturen für `MSGBOX` (Anweisung und Funktion) und `INPUTBOX$`, `Unsupported`-Absenkung entfernen; verifiziert durch `cargo test -p tb-frontend`
 
 ## 6. Korpus und Kompatibilität
 
-- [ ] 6.1 Ereignisfolge-Direktive im Programmkopf und ihre Einspeisung durch den Harness; verifiziert durch einen Harness-Test mit deklarierten Tasten-, Maus- und Zeitereignissen
-- [ ] 6.2 Formular-Korpusprogramme für Fokus/Tab, Access-Key, Mausklick, Menüauswahl, Liste, Timer und modalen Dialog; verifiziert durch `cargo test -p tb-cli` gegen die Sollausgaben
-- [ ] 6.3 Meilenstein: die Formularprogramme aus `github.com/cout/vbdos` übersetzen und bedienen, jeden Befund festhalten; verifiziert durch den Lauf über den Bestand mit Befundliste
-- [ ] 6.4 Meilenstein: die Beispiel-Formularprogramme des Korpus laufen; verifiziert durch den grünen Korpuslauf
+- [x] 6.1 Ereignisfolge-Direktive im Programmkopf und ihre Einspeisung durch den Harness; verifiziert durch einen Harness-Test mit deklarierten Tasten-, Maus- und Zeitereignissen
+- [x] 6.2 Formular-Korpusprogramme für Fokus/Tab, Access-Key, Mausklick, Menüauswahl, Liste, Timer und modalen Dialog; verifiziert durch `cargo test -p tb-cli` gegen die Sollausgaben
+- [x] 6.3 Meilenstein: die Formularprogramme aus `github.com/cout/vbdos` übersetzen und bedienen, jeden Befund festhalten; verifiziert durch den Lauf über den Bestand mit Befundliste
+- [x] 6.4 Meilenstein: die Beispiel-Formularprogramme des Korpus laufen; verifiziert durch den grünen Korpuslauf
 
 ## 7. Inventar, Dokumentation, Abschluss
 
-- [ ] 7.1 `docs/inventar.md`: Einträge dieses Changes auf `implementiert`; verifiziert durch `inventar_stimmt_mit_code_ueberein` mit Abdeckung 0 offen für Phase 4
-- [ ] 7.2 Abweichungen (Dateisystem-Steuerelemente, festgelegte Optik, Z- und Timer-Reihenfolge) in `docs/sprachreferenz.md` eintragen; verifiziert durch den Abschnitt „Abweichungen"
-- [ ] 7.3 PLAN.md: die verbleibenden Phase-4-Punkte abhaken und die Befunde der Phase festhalten; verifiziert durch die abgeschlossene Phase-4-Liste
-- [ ] 7.4 `cargo test` grün und `openspec validate phase-4-steuerelemente --strict` ohne Befund; verifiziert durch beide Kommandos
+- [x] 7.1 `docs/inventar.md`: Einträge dieses Changes auf `implementiert`; verifiziert durch `inventar_stimmt_mit_code_ueberein` mit Abdeckung 0 offen für Phase 4
+- [x] 7.2 Abweichungen (Dateisystem-Steuerelemente, festgelegte Optik, Z- und Timer-Reihenfolge) in `docs/sprachreferenz.md` eintragen; verifiziert durch den Abschnitt „Abweichungen"
+- [x] 7.3 PLAN.md: die verbleibenden Phase-4-Punkte abhaken und die Befunde der Phase festhalten; verifiziert durch die abgeschlossene Phase-4-Liste
+- [x] 7.4 `cargo test` grün und `openspec validate phase-4-steuerelemente --strict` ohne Befund; verifiziert durch beide Kommandos

openspec/changes/archive/2026-09-05-phase-4-steuerelemente/vbdos-befunde.md

@@ -0,0 +1,44 @@
+# Befunde am öffentlichen VBDOS-Bestand
+
+Geprüft wurde `cout/vbdos` im Commit
+`1cdd2b32b829fe1721d0b6aecc433abc47a96fb6`. Maßgeblich waren die
+vorhandenen `.MAK`-Projekte; wo keines existiert, wurde die `.FRM` direkt
+verwendet. Jeder Eintrag bestand `tbc check` ohne Diagnose. Die Programme
+wurden anschließend in einem 100×30-Pseudoterminal gestartet und blieben nach
+dem Ende des Modulrumpfs bedienbar, bis ein Steuerelement das Formular schloss
+oder der Lauf bewusst abgebrochen wurde.
+
+| Programm | Check | Bediennachweis |
+|---|---:|---|
+| `graphics/graphics.mak` | 0 Diagnosen | Alt+X löst `cmdExit_Click` aus und entlädt das Formular |
+| `microsoft/check.mak` | 0 Diagnosen | Alt+F öffnet das Menü; X erreicht den Exit-/Speicherdialogpfad |
+| `microsoft/qlbview.mak` | 0 Diagnosen | Esc löst die Cancel-Schaltfläche aus und entlädt das Formular |
+| `microsoft/seek.mak` | 0 Diagnosen | Alt+X löst `cmdExit_Click` aus und entlädt das Formular |
+| `microsoft/spindemo.mak` | 0 Diagnosen | Tab und Pfeiltaste werden dem Text-/Spin-Steuerpfad zugestellt |
+| `microsoft/notepad.frm` | 0 Diagnosen | Alt+F öffnet das Menü; X löst `mnuFileExit_Click` aus |
+| `misc/mentors/mentors.frm` | 0 Diagnosen | Alt+F öffnet das Menü; X erreicht den Exit-/Speicherdialogpfad |
+
+## Geschlossene Befunde
+
+- `.MAK`-Einträge, `$INCLUDE` und `RUN` werden relativ und
+  DOS-großschreibungsunabhängig aufgelöst; mehrere Module und Formulare
+  werden als gemeinsames Programm übersetzt.
+- Binärformular-P-Code behält Block- und Anweisungsgrenzen, numerische
+  Suffixe, Record-/UDT-Ausdrücke und Control-Arrays korrekt bei.
+- Globale Arrays werden vor `Form_Load` initialisiert; `LEN(record)` liefert
+  die feste Satzbreite. `INPUT$` liest auch Binärdateien.
+- `SCREEN.CONTROLPANEL(index)`, `CLIPBOARD` und `PRINTER` haben
+  Laufzeitverhalten; die von Notepad verwendeten Common-Dialog-Deklarationen
+  arbeiten über die vorhandenen Textdialoge.
+- Die nativen Controls `VSpin` und `HSpin` werden als bedienbares `Spin`
+  importiert, einschließlich Wertgrenzen, Wiederholung und `Custom`-Ereignis.
+- `SCREEN` 0–13 sowie die im Grafikbeispiel verwendeten Anweisungen `LINE`,
+  `PAINT` und `VIEW` zeichnen auf den Zellenpuffer.
+- Modellose Formulare halten nach dem Modulrumpf die VM-Ereignisschleife
+  offen; Formularereignisse laufen auf derselben VM weiter, bis alle Formulare
+  geschlossen sind. Derselbe Pfad funktioniert im Terminal und mit
+  vorab eingelesener Pipe-Eingabe.
+
+Damit sind alle während dieses Kompatibilitätslaufs gefundenen
+Implementierungslücken geschlossen; es verbleibt kein dokumentierter oder
+umgangener Befund.