OpenSpec-Review dokumentieren und ISAM-Vertragsabweichungen beheben

openspec/changes/ereigniszustellung-und-hostgrenzen/specs/ereignissteuerung/spec.md

@@ -0,0 +1,139 @@
+## MODIFIED Requirements
+
+### Requirement: Ereignisquellen mit Zeit vom Host
+Die Laufzeit SHALL Ereignisse aus vier Quellen führen: Tastatur, Maus,
+Zeit und benutzerdefinierte Ereignisse. Die Zeit SHALL vom Host bezogen
+werden;
+die Laufzeit MUST NOT für die Ereigniszustellung selbst auf die
+Systemuhr zugreifen. Ein Host ohne Terminal MUST die Zeit frei stellen
+können, sodass zeitgesteuerte Programme ohne Wartezeit und mit
+reproduzierbarem Ergebnis prüfbar sind.
+
+Auch Wartefristen der VM SHALL ausschließlich von der Hostzeit abhängen. Ein Host mit stehender virtueller Zeit MUST NOT durch reale verstrichene Zeit eine Frist scheinbar erreichen.
+
+#### Scenario: Zeitgesteuerter Trap ohne echte Wartezeit
+- **WHEN** ein Testhost die Zeit um 5 Sekunden vorstellt und ein Programm `ON TIMER(5) GOSUB Marke` mit `TIMER ON` aktiv hat
+- **THEN** wird der Trap zugestellt, ohne dass der Test tatsächlich wartet
+
+#### Scenario: Wiederholter Lauf liefert dasselbe Ergebnis
+- **WHEN** dasselbe zeitgesteuerte Korpusprogramm zweimal mit demselben Zeitverlauf ausgeführt wird
+- **THEN** ist die Ausgabe beide Male identisch
+
+#### Scenario: Stehende virtuelle Zeit
+- **WHEN** ein Host während SLEEP seine Zeit unverändert hält
+- **THEN** endet SLEEP nicht wegen realer Zeit; eine vom Host gemeldete Frist oder ein zugestelltes Ereignis beendet das Warten
+
+### Requirement: Mausereignisse in Zellenkoordinaten
+Die Darstellungsschicht SHALL Mausereignisse der Ausführungsumgebung an
+die Laufzeit weitergeben: Drücken, Loslassen und Bewegung, jeweils mit
+gedrückter Taste, Umschaltzustand und Position. Die Position SHALL in
+Zellen des Textbildschirms angegeben werden, gezählt wie bei `LOCATE`,
+also 1-basiert. Ereignisse außerhalb der aktuellen Bildschirmfläche MUST
+verworfen werden. Die Reihenfolge zwischen Maus- und Tastenereignissen
+SHALL der Reihenfolge ihres Eintreffens entsprechen. Solange kein
+Verbraucher ein Mausereignis annimmt, MUST es am Zustellpunkt verworfen
+werden, damit die Warteschlange nicht unbegrenzt wächst.
+
+Die Reihenfolge SHALL bis zur beobachtbaren Ausführung der zugehörigen Handler erhalten bleiben; getrennte Quellarten MUST NOT nachträglich nach ihrer Art umgeordnet werden.
+
+#### Scenario: Position als Zelle
+- **WHEN** in der linken oberen Ecke der Darstellungsfläche die linke Maustaste gedrückt wird
+- **THEN** trägt das Ereignis Zeile 1 und Spalte 1
+
+#### Scenario: Reihenfolge bleibt erhalten
+- **WHEN** eine Taste gedrückt und danach die Maus geklickt wird
+- **THEN** liefert die Warteschlange erst das Tasten-, dann das Mausereignis
+
+#### Scenario: Ereignis außerhalb der Fläche
+- **WHEN** ein Mausereignis eine Position außerhalb der aktuellen Bildschirmgröße nennt
+- **THEN** wird es verworfen und erreicht die Warteschlange nicht
+
+#### Scenario: Kein Verbraucher, keine Anhäufung
+- **WHEN** ein Programm ohne Verbraucher für Mausereignisse läuft und die Maus dauerhaft bewegt wird
+- **THEN** wächst die Warteschlange nicht über ihre Grenze und das Programm läuft unverändert weiter
+
+#### Scenario: Taste vor Maus bis zum Handler
+- **WHEN** eine Taste vor einem Mausklick eintrifft und beide Handler eine Kennung anhängen
+- **THEN** steht die Tastenkennung vor der Mauskennung
+
+#### Scenario: Maus vor Taste bis zum Handler
+- **WHEN** ein Mausklick vor einer Taste eintrifft
+- **THEN** wird zuerst der Maushandler wirksam
+
+### Requirement: Abschließende Liste der Zustellpunkte
+Ereignisse SHALL ausschließlich an folgenden Punkten zugestellt werden
+— das Vorbild prüft die Ereignismarke „before executing the next
+statement":
+an einer Anweisungsgrenze, bei `DOEVENTS`, während `SLEEP` und vor einer
+blockierenden Eingabe. Zwischen zwei Zustellpunkten MUST NOT ein
+Trap-Handler beginnen; insbesondere MUST NOT eine Anweisung in ihrer
+Mitte unterbrochen werden. Ein zugestelltes Ereignis SHALL ein laufendes
+`SLEEP` beenden.
+
+Forms-Ereignisse SHALL auch während SLEEP an dessen bestehenden Zustellpunkten verarbeitet werden. Eine für das Menü geltende Zustellsperre SHALL an jedem Zustellpunkt gleichermaßen gelten.
+
+#### Scenario: Keine Zustellung innerhalb einer Anweisung
+- **WHEN** ein Ereignis fällig wird, während eine mehrteilige Anweisung ausgewertet wird
+- **THEN** läuft die Anweisung zu Ende und der Handler beginnt erst an der folgenden Anweisungsgrenze
+
+#### Scenario: SLEEP endet durch Ereignis
+- **WHEN** ein Programm `SLEEP 60` ausführt und nach 2 Sekunden ein aktiver Trap fällig wird
+- **THEN** wird der Handler ausgeführt und `SLEEP` kehrt danach zurück, ohne die vollen 60 Sekunden abzuwarten
+
+#### Scenario: DOEVENTS stellt zu
+- **WHEN** ein anstehendes Ereignis vorliegt und `DOEVENTS` ausgewertet wird
+- **THEN** läuft der zugehörige Handler, bevor `DOEVENTS` einen Wert liefert
+
+#### Scenario: Forms-Timer beendet SLEEP
+- **WHEN** während SLEEP ein aktiver Forms-Timer fällig wird
+- **THEN** läuft dessen Handler und SLEEP kehrt danach zurück
+
+### Requirement: Getrappte Tasten verlassen den Eingabestrom
+Eine Taste, für die ein aktiver `ON KEY`-Trap besteht, SHALL dem Trap
+zugestellt werden und MUST NOT zusätzlich über `INKEY$`, `INPUT`,
+`LINE INPUT` oder `INPUT$` sichtbar werden. Bei `OFF` oder `STOP` der
+Quelle SHALL die Taste dem normalen Eingabestrom erhalten bleiben.
+
+Unter STOP SHALL die Taste normal lesbar bleiben und zugleich höchstens ein Ereignis für das spätere ON gemerkt werden.
+
+#### Scenario: Getrappte Taste erscheint nicht bei INKEY$
+- **WHEN** `ON KEY(1) GOSUB Marke` mit `KEY(1) ON` gilt und F1 gedrückt wird
+- **THEN** läuft der Handler und ein anschließendes `INKEY$` liefert den leeren String
+
+#### Scenario: Nicht getrappte Taste bleibt im Strom
+- **WHEN** derselbe Trap mit `KEY(1) OFF` gilt und F1 gedrückt wird
+- **THEN** liefert `INKEY$` die Sondertastenfolge für F1
+
+#### Scenario: STOP merkt und erhält Eingabe
+- **WHEN** unter KEY(1) STOP F1 gedrückt, per INKEY$ gelesen und danach KEY(1) ON ausgeführt wird
+- **THEN** liefert INKEY$ die Sondertastenfolge und der Handler läuft nach ON genau einmal
+
+### Requirement: Signal-Trap auf Betriebssystemsignalen
+`ON SIGNAL(n%) GOSUB` und die Steueranweisung `SIGNAL(n%)` SHALL
+denselben Regeln für Maskierung, Zustellung und Wiedereintritt
+unterliegen wie die übrigen Quellen. `n%` SHALL auf
+Betriebssystemsignale abgebildet werden, und zwar ausschließlich auf die
+Menge, die auf allen Zielplattformen besteht: 1 auf den
+Unterbrechungswunsch (`SIGINT`), 2 auf den Beendigungswunsch
+(`SIGTERM`). Ein anderer Wert MUST namentlich abgewiesen werden — zur
+Übersetzungszeit, wenn er konstant ist, sonst mit Laufzeitfehler 5. Ein
+Signal MUST NOT im Signalkontext verarbeitet werden; es SHALL über den
+Host als Ereignis in die Warteschlange gelangen. Die Abweichung zur
+OS/2-gebundenen Quelle des Vorbilds SHALL in der Sprachreferenz
+ausgewiesen sein.
+
+#### Scenario: Signal-Trap folgt der Maskierung
+- **WHEN** `ON SIGNAL(1) GOSUB Marke` mit `SIGNAL(1) STOP` gilt und ein `SIGINT` eintrifft
+- **THEN** läuft der Handler erst nach `SIGNAL(1) ON`, und zwar genau einmal
+
+#### Scenario: Unzulässige Signalnummer
+- **WHEN** ein Modul `ON SIGNAL(7) GOSUB Marke` enthält
+- **THEN** wird es namentlich abgewiesen und die Meldung nennt den zulässigen Bereich
+
+#### Scenario: Signal ohne Trap bleibt Abbruch
+- **WHEN** ein `SIGINT` eintrifft, ohne dass ein `SIGNAL(1)`-Trap aktiv ist
+- **THEN** bleibt es beim bisherigen Abbruchverhalten
+
+#### Scenario: SIGTERM wird zugestellt
+- **WHEN** SIGNAL(2) ON gilt und ein SIGTERM über den Host eintrifft
+- **THEN** wird das Ziel von ON SIGNAL(2) GOSUB am nächsten erlaubten Zustellpunkt ausgeführt

openspec/changes/ereigniszustellung-und-hostgrenzen/specs/forms-steuerelemente/spec.md

@@ -0,0 +1,53 @@
+## MODIFIED Requirements
+
+### Requirement: Fokus, Tabreihenfolge und Access-Keys
+Der Fokus SHALL mit Tab in aufsteigender `TabIndex`-Folge und mit
+Umschalt-Tab rückwärts wechseln; Elemente mit `TabStop = 0` oder
+`Enabled = 0` MUST übersprungen werden. Ein `&` im Text SHALL den
+folgenden Buchstaben zum Access-Key machen, der mit Alt das Element
+auslöst oder ihm den Fokus gibt. Enter SHALL die `Default`-Schaltfläche
+auslösen, Esc die `Cancel`-Schaltfläche. Fokuswechsel MUST `LostFocus`
+am alten und `GotFocus` am neuen Element auslösen, in dieser Reihenfolge.
+
+Die über das Terminal gelieferte Rückwärtstab-Taste SHALL denselben Fokuswechsel wie Tab mit Umschalt auslösen. Die Reihenfolge LostFocus vor GotFocus SHALL auch an den Wirkungen der BASIC-Handler sichtbar bleiben.
+
+#### Scenario: Tab überspringt
+- **WHEN** das mittlere von drei Elementen `TabStop = 0` trägt und Tab gedrückt wird
+- **THEN** erhält das dritte Element den Fokus
+
+#### Scenario: Access-Key
+- **WHEN** eine Schaltfläche `Caption = "&OK"` trägt und Alt+O gedrückt wird
+- **THEN** wird ihr `Click`-Ereignis ausgelöst
+
+#### Scenario: Reihenfolge der Fokusereignisse
+- **WHEN** der Fokus von `Text1` auf `Text2` wechselt
+- **THEN** läuft erst `Text1_LostFocus`, danach `Text2_GotFocus`
+
+#### Scenario: Handlerwirkungen in Fokusreihenfolge
+- **WHEN** LostFocus den Text L und GotFocus den Text G an dieselbe Variable anhängen
+- **THEN** lautet das Ergebnis LG
+
+#### Scenario: Rückwärtstab vom Terminal
+- **WHEN** das Terminal eine Rückwärtstab-Taste liefert
+- **THEN** wechselt der Fokus zum vorherigen zulässigen TabIndex
+
+### Requirement: Menüsystem
+Ein Formular SHALL eine Menüleiste mit bis zu sechs Ebenen tragen.
+Menüeinträge SHALL Access-Keys (`&`), Shortcuts, `Checked`, `Enabled`,
+`Visible` und Separatoren (`-`) unterstützen; ein Separator MUST NOT
+`Checked`, deaktiviert oder mit Shortcut versehen sein, ein Menütitel
+MUST NOT einen Shortcut tragen. Solange ein Menü geöffnet ist, MUST die
+Zustellung von Zeitereignissen und klassischen Traps ruhen und danach
+fortgesetzt werden.
+
+#### Scenario: Menüauswahl löst Click aus
+- **WHEN** ein Menüeintrag über seinen Access-Key gewählt wird
+- **THEN** läuft seine `Click`-Prozedur
+
+#### Scenario: Traps ruhen im geöffneten Menü
+- **WHEN** ein Menü geöffnet ist und ein Zeit-Trap fällig wird
+- **THEN** läuft sein Handler erst, nachdem das Menü geschlossen wurde
+
+#### Scenario: UEVENT an gewöhnlicher Anweisungsgrenze
+- **WHEN** ein Menü offen ist und UEVENT vor einer Zuweisung ansteht
+- **THEN** läuft dessen Handler erst nach dem Schließen des Menüs

openspec/changes/ereigniszustellung-und-hostgrenzen/specs/textbildschirm/spec.md

@@ -0,0 +1,20 @@
+## MODIFIED Requirements
+
+### Requirement: Zellenpuffer ohne Terminalabhängigkeit
+Der Zellenpuffer mit der vollständigen Bildschirmsemantik (Cursor,
+Farbattribute, Umbruch, Scrollen, Scrollbereich, Größenänderung) SHALL
+ohne Terminal instanziierbar, veränderbar und auslesbar sein. Die
+Anbindung an ein konkretes Terminal SHALL ausschließlich in der
+Darstellungsschicht liegen. Damit MUST jedes Bildschirmverhalten in
+automatischen Tests ohne Terminal prüfbar sein, und die Ausführungsschicht
+MUST NOT von einer Terminal-Bibliothek abhängen.
+
+Ein separater Einbetter SHALL die VM einschließlich Forms ohne Terminalbackend bauen und ausführen können. Der CLI-Runner SHALL das Backend ausdrücklich zuschalten.
+
+#### Scenario: Bildschirmverhalten im Test ohne Terminal
+- **WHEN** ein Testprogramm in einer Umgebung ohne Terminal `LOCATE 5, 10 : PRINT "x"` ausführt
+- **THEN** trägt die Zelle (5, 10) das Zeichen `x` und der Test benötigt kein Terminal
+
+#### Scenario: Terminalfreier Einbetter
+- **WHEN** ein separates Programm ausschließlich die VM mit einem Capture-Host einbindet
+- **THEN** enthält sein aufgelöster Abhängigkeitsbaum keine Terminalbibliothek und die Forms-Tests können darin laufen

openspec/changes/ereigniszustellung-und-hostgrenzen/specs/vm-ausfuehrung/spec.md

@@ -0,0 +1,24 @@
+## MODIFIED Requirements
+
+### Requirement: Ereigniszustellung an Anweisungsgrenzen
+Die VM SHALL an Anweisungsgrenzen prüfen, ob ein Ereignis zuzustellen
+ist, und in diesem Fall das `GOSUB`-Ziel des zugehörigen Traps
+ausführen. Der unterbrochene Zustand — Aufrufkette, Schleifen, Locals,
+`GOSUB`-Stapel und Fehlerzustand — MUST dabei erhalten bleiben; mit
+`RETURN` SHALL die Ausführung an der unterbrochenen Stelle fortfahren.
+Die Prüfung MUST NOT pro Opcode erfolgen; solange kein Trap definiert ist,
+MUST sie auf einen einzelnen Test hinauslaufen und MUST NOT die Uhr lesen.
+
+Ohne klassische Traps, aktive Forms-Timer oder zeitabhängige Mausauswertung SHALL auch die Forms-Integration keine Hostzeit abfragen.
+
+#### Scenario: Trap aus einer Prozedur heraus
+- **WHEN** ein Ereignis zugestellt wird, während eine `SUB` läuft, und das Trap-Ziel im Modulrumpf liegt
+- **THEN** läuft der Handler und nach `RETURN` setzt die `SUB` an der unterbrochenen Anweisung fort
+
+#### Scenario: Ohne aktiven Trap wird die Uhr nicht gelesen
+- **WHEN** ein Programm ohne jede `ON …`-Trap-Definition ausgeführt wird
+- **THEN** fragt die Ausführung an keiner Anweisungsgrenze die Zeit ab, und der Durchsatz bleibt im Rahmen der Messgenauigkeit unverändert
+
+#### Scenario: Einfaches Programm liest keine Ereigniszeit
+- **WHEN** ein Programm nur Zuweisungen und END ausführt und ein Testhost Zeitabfragen zählt
+- **THEN** ist der Zähler am Ende 0