Files

Chili Palmer 7e6fa6ea88 Phase 0: Referenzdokumente, Fehlerkatalog, Testkorpus, Ratatui-Spike

Entscheidungen festgehalten: TBVM bestaetigt und eingebettet in die
Executables; durchgaengig UTF-8 statt CP437 (dokumentierte Abweichung).

- docs/: Sprachreferenz, Forms-Referenz, Dateiformate, TBVM-Design
- tb-runtime::errors: klassischer Laufzeitfehler-Katalog (implementiert)
- tb-ui::screen: 80x25-Unicode-Zellenpuffer mit 16-Farben-Abbildung,
  Scrollbereich (VIEW PRINT), Letterboxing; Ratatui-Widget + Tests
- Spike: cargo run -p tb-ui --example spike (Farben, Unicode, Tasten, Maus)
- tests/compat/: erste Referenzprogramme mit byte-genauer Sollausgabe

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-09-01 16:36:45 +02:00

2.2 KiB

Raw Blame History

Terminal Basic

Eine plattformübergreifende Re-Implementierung 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.

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 80×25-Textbildschirm (16 Farben) über Ratatui. Bewusste Modernisierung: durchgängig UTF-8/Unicode statt Codepage 437.
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`	`tbdosc`: Standalone-Compiler — wandelt Quellen und Projekte in binäre Ergebnisse um
`tb-ide`	`tbdos`: 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   # tbdosc — Standalone-Compiler
cargo run -p tb-ide   # tbdos  — IDE (TUI)

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