Delphi concept

2026-02-10 23:55:42 +01:00
parent adaff67219
commit 645fd71e45
12 changed files with 529 additions and 0 deletions
@@ -0,0 +1,72 @@
+# Implementation Plan: Pascal/Delphi in CodeGraph
+
+## 0) Prämissen
+
+- CodeGraph extrahiert **Nodes** und **Edges** über **tree-sitter** und language-spezifische **Queries (`.scm`)**.
+- Danach folgt **Reference Resolution** (Calls → Definitionen, imports → Dateien, inheritance, framework patterns).
+
+## 1) Parser / Grammar
+
+Empfohlen: `tree-sitter-pascal` (unterstützt Delphi + FreePascal).
+
+**Tasks:**
+- Dependency hinzufügen (wie bei bestehenden Sprachen).
+- Language-Loader/Registry erweitern: `languageId = "pascal"` (oder `"delphi"`, aber konsistent).
+
+## 2) File-Erkennung
+
+Extensions (MVP):
+- `.pas` (Units)
+- `.dpr` (Program)
+- `.dpk` (Package)
+- `.lpr` (Lazarus Program)
+
+Optional:
+- `.inc` (Include-Fragmente) – erst später oder nur, wenn Parser tolerant genug ist.
+
+## 3) Queries (MVP)
+
+### 3.1 Nodes
+Extrahiere mindestens:
+- Unit/Program/Package Name
+- Klassen / Interfaces / Records
+- Procedures/Functions
+- Methoden (class/instance)
+
+### 3.2 Edges
+Extrahiere mindestens:
+- `uses` (import/dependency)
+- `extends` (Basisklasse)
+- `implements` (Interface-Implementierungen)
+- `calls` (Identifier + optional Qualifier)
+
+## 4) Reference Resolution (MVP)
+
+### 4.1 Unit-Auflösung (`uses`)
+- Index-Phase: Map `UnitName -> fileId` (aus Units/Programs/Packages)
+- Resolution: Bei `uses Foo, Bar;` Edges auf Ziel-Units setzen.
+- Spezialfälle (später): `Foo in 'path\Foo.pas'` (DPR/DPK), Namespaces (`System.SysUtils`).
+
+### 4.2 Call-Auflösung (best effort)
+- Extraktion: `callName`, optional `qualifier` (`Obj.DoIt`, `TMyClass.DoIt`)
+- Heuristik-Reihenfolge:
+  1. lokale Procs/Funcs in der gleichen Unit
+  2. Methoden in der gleichen Klasse
+  3. Units aus `uses`
+  4. globaler Fallback nach Name
+
+## 5) Tests
+
+- Fixtures aus `fixtures/` in die Test-Suite aufnehmen
+- Assertions:
+  - Node-Anzahl + zentrale Namen
+  - `uses`-Edges
+  - `extends`/`implements`-Edges
+  - einfache Call-Edges
+
+## 6) Definition of Done
+
+- `codegraph index` indexiert Delphi/ Pascal-Dateien ohne Crash
+- `codegraph_search` findet Klassen/Methoden
+- `codegraph_callers/callees` liefert sinnvolle Ergebnisse für einfache Fälle
+- `uses`-Graph stimmt (Unit-Abhängigkeiten)