Chili Palmer 52ccbb5848 Phase 3 (Kern): Laufzeitbibliothek, Bildschirm und Datei-E/A
Setzt den OpenSpec-Change phase-3-runtime-bildschirm um (77/77 Aufgaben).
Abdeckung laut Inventar: 195 implementiert, 37 offen, 53 Non-Feature.

Vollstaendigkeits-Inventar
- docs/inventar.md mit 285 Eintraegen aus den Themenlisten von
  bas7advr.hlp und qb45advr.hlp, je mit Status und Fundstelle
- crates/tb-frontend/tests/inventar.rs haelt die Tabelle in beide
  Richtungen gegen den Code; der Abdeckungsstand kann nicht veralten

Bruchschritt (Puffer, Host, Korpus)
- Cell/TextScreen ziehen ratatui-frei nach tb-runtime::screen; tb-ui
  behaelt Farbabbildung, Widget und den neuen Terminal-Host
- Host wechselt vom Zeichenstrom auf Anzeige des Zellenpuffers plus
  Ereignisse (Taste, Groessenaenderung, Abbruch)
- Korpusvergleich auf getrimmten Bildschirm-Snapshot; die acht
  bestehenden Sollausgaben blieben dabei unveraendert

Groessenunabhaengigkeit
- 80x25 ist nirgends mehr eine feste Grenze; Groessenaenderungen waehrend
  der Ausfuehrung werden zugestellt (Inhalt oben links erhalten, Cursor
  und VIEW PRINT geklemmt)
- Korpusnachweis: dasselbe Programm bei 80x25 und 120x40 mit je eigener
  Sollausgabe, plus ein Programm mit Groessenwechsel mitten im Lauf

Bibliothek
- Breite Unicode-Zeichen belegen zwei Zellen (Cursor, POS, Randumbruch)
- Bildschirm: CLS, COLOR, LOCATE, WIDTH, VIEW PRINT, SCREEN, CSRLIN, POS
- Tastatur: INKEY$, INPUT$, Funktionstasten-Makros (KEY n / LIST / ON)
- PRINT USING, LPRINT USING, FORMAT$, SetFormatCC
- Mathematik mit kompatiblem PRNG (gleiche Saat, gleiche Folge)
- Datum und Zeit mit Serienwerten ab 1899
- Finanzmathematik: FV#, PV#, Pmt#, IPmt#, PPmt#, NPer#, Rate#, NPV#,
  IRR#, MIRR#, SLN#, SYD#, DDB#
- Datei-E/A: sequenziell, RANDOM (Recordpuffer und UDT-Variablen),
  BINARY, FIELD/LSET/RSET, Statusfunktionen, Dateisystem, MK$/CV
- System: ENVIRON, FRE, CLEAR, TRON/TROFF, STACK, ERDEV, ERR-Anweisung

Altlasten aus Phase 2
- ON ERROR GOTO auf Modulebene ist aus Prozeduren ansprechbar
  (prozeduruebergreifender Fixup im Codegenerator)
- DATA behaelt seinen Rohtext (Gross-/Kleinschreibung, innerer Leerraum)
- Die vier TODO-verify-Zellen der Konvertierungsmatrix sind aufgeloest

Vom Inventar aufgedeckte Fehler
- Zwoelf Non-Features wies der Compiler entgegen der Phase-1-Spec nicht
  ab (CALLS, SSEG, POINT, VIEW, COM, PEN, STRIG, STICK, die
  String*-Routinen, LINE und OPEN "COMn:") -- geschlossen
- Drei Gruppen fehlten im urspruenglichen Umfang: Finanzmathematik,
  Record-Konvertierung, Rest der Dateisystemfunktionen
- bas7advr.hlp allein ist keine vollstaendige Quelle; das Inventar
  bildet die Vereinigung mit qb45advr.hlp

Neue Changes
- phase-3-isam: schliesst Phase 3 ab (Speicherschicht redb)
- phase-3-ortszeit: zieht die UTC-Abweichung zurueck

Neue Abhaengigkeit: unicode-width.
Dokumentiert: sprachreferenz.md und tbvm-design.md sind TODO-frei,
docs/bibliothek.md neu, PLAN.md fortgeschrieben.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-04 06:54:19 +02:00

Terminal Basic

Eine plattformübergreifende Re-Imagination des letzten großen BASIC-Dialekts für DOS (1992) — Sprache, Laufzeitbibliothek, Forms-Engine und IDE — in Rust, mit Ratatui als Terminal-UI-Schicht.

Dieses Projekt ist eine unabhängige Neuentwicklung und steht in keiner Verbindung zu Microsoft. Produktnamen Dritter werden bewusst nicht verwendet.

Leitbild

Terminal Basic ist keine sklavische 1:1-Reimplementierung, sondern eine spirituelle Neuauflage: ein BASIC, mit dem man heute Terminal-Tools baut — CLI-Werkzeuge ebenso wie TUI-Anwendungen. Der Weg dorthin:

  1. Erst die Re-Imagination: gleiche UI/UX wie das Vorbild, gleicher Sprachstandard, gleiche Standardbibliothek. Wer das Vorbild kannte, fühlt sich sofort zu Hause; bestehende Programme laufen weitgehend unverändert.
  2. Dann die Anreicherung: über die Zeit kommen bewusst Elemente außerhalb des Vorbilds dazu (moderne Terminal-Fähigkeiten, Sprachkomfort, Bibliotheken). Erweiterungen sind additiv und brechen den Kernstandard nicht.

Wo Alt und Neu kollidieren, gewinnt die Plattform von heute — deshalb z. B. durchgängig UTF-8 statt Codepage 437 und keine Emulation von DOS-Hardware.

Ziele

  • Volle Sprachkompatibilität: alle Sprachelemente des Dialekts — Prozeduren (SUB/FUNCTION), benutzerdefinierte Typen, GOSUB, ON ERROR/RESUME, Typ-Suffixe, feste und dynamische Arrays, PRINT USING, DATA/READ usw.
  • Volle Library-Kompatibilität für die DOS-Oberflächenprogrammierung: die ereignisgesteuerte Forms-Engine mit allen Steuerelementen, Menüs, Maus- und Tastaturereignissen, nachgebildet auf einem emulierten Textbildschirm (16 Farben) über Ratatui. Bewusste Modernisierungen: durchgängig UTF-8/Unicode statt Codepage 437, und dynamische Terminalgröße statt festem 80×25 — IDE und erzeugte Programme passen sich der Fenstergröße an (Mindestgröße 80×25; darunter erscheint nur ein Hinweis, wie bei btop).
  • Plattformübergreifend: läuft in Terminals unter Linux, macOS und Windows.
  • Compiler + VM: der Compiler erzeugt Bytecode für eine eigene virtuelle Maschine (TBVM); die Abwägung der Runtime-Optionen ist in PLAN.md dokumentiert.
  • IDE im Terminal: Nachbildung der klassischen DOS-IDE mit Editor, Formular-Designer, Direktfenster und Debugger.

Aufbau des Workspace

Crate Inhalt
tb-frontend Lexer, Parser, AST, semantische Analyse
tb-vm Bytecode-Format, Codegenerator, virtuelle Maschine (TBVM)
tb-runtime Laufzeitbibliothek: Strings, Mathematik, Datei-E/A, Datum/Zeit, Fehlercodes
tb-ui Textbildschirm-Emulation und Forms-Engine auf Ratatui
tb-cli tbc: Standalone-Compiler — wandelt Quellen und Projekte in binäre Ergebnisse um
tb-ide tb: die integrierte Entwicklungsumgebung (TUI) zum Erstellen von Programmen

Status

Projektrahmen. Die Implementierungs- und Explorationsschritte sind in PLAN.md beschrieben; dort wird der Fortschritt fortgeschrieben.

Bauen

cargo build
cargo run -p tb-cli   # tbc — Standalone-Compiler
cargo run -p tb-ide   # tb  — IDE (TUI)

Benötigt wird nur eine aktuelle stabile Rust-Toolchain.

Lizenz

MIT — siehe LICENSE.

Description
Re-Imagining of Visual Basic for DOS in Rust and for modern systems.
Readme MIT 6.1 MiB
Languages
Rust 95.5%
Python 2.8%
QuickBASIC 1.3%
Visual Basic 6.0 0.3%