codegraph/Delphi/Docs/04-Checklist.md

Checklist: Pascal/Delphi Support in CodeGraph

A) Plumbing (Infrastruktur)

• npm install tree-sitter-pascal als Dependency
• src/types.ts: 'pascal' zum Language Union-Type hinzufügen
• src/types.ts: DEFAULT_CONFIG.include um '**/*.pas', '**/*.dpr', '**/*.dpk', '**/*.lpr', '**/*.dfm', '**/*.fmx' erweitern
• src/extraction/grammars.ts: Grammar-Loader pascal: () => require('tree-sitter-pascal')
• src/extraction/grammars.ts: Extension-Mapping .pas, .dpr, .dpk, .lpr, .dfm, .fmx → 'pascal'
• src/extraction/grammars.ts: Display-Name pascal: 'Pascal / Delphi'
• src/extraction/tree-sitter.ts: LanguageExtractor für pascal in EXTRACTORS Map

B) Node-Extraktion

• unit / program / library → NodeKind module
• declClass → NodeKind class (inkl. record, object)
• declIntf → NodeKind interface
• declProc (top-level) → NodeKind function
• declProc (in Klasse) → NodeKind method (inkl. constructor/destructor)
• declProp → NodeKind property
• declField → NodeKind field
• declEnum → NodeKind enum
• declEnumValue → NodeKind enum_member
• declConst → NodeKind constant
• declType (einfach) → NodeKind type_alias

C) Edge-Extraktion

• declUses → EdgeKind imports
• declClass.parent[0] → EdgeKind extends
• declClass.parent[1..] → EdgeKind implements
• exprCall → EdgeKind calls
• exprDot + exprCall → EdgeKind calls (qualifiziert)
• TClass.Create → EdgeKind instantiates
• Parent-Child Containment → EdgeKind contains

D) Sichtbarkeit & Attribute

• getVisibility: declSection → public/private/protected
• isStatic: kClass in declProc → true
• getSignature: Parameter + Rückgabetyp extrahieren

E) Resolution

• moduleName → unitName → fileId Mapping
• uses X; → Unit-Node auflösen
• uses X in 'path' → Datei direkt auflösen (Phase 2)
• Call-Resolution: gleiche Unit → gleiche Klasse → uses-Units → global

F) Testing

• Fixtures in Test-Suite aufnehmen (UAuth.pas, App.dpr, UTypes.pas)
• Nodes: Anzahl + Namen verifizieren
• Edges: imports/extends/implements/calls prüfen
• Sichtbarkeiten prüfen
• Properties, Enums, Konstanten prüfen

G) Polishing

• Language in Supported-Languages-Dokumentation aufnehmen
• CLI-Hilfe / Config-Validierung aktualisieren

H) DFM/FMX Form-Dateien (Phase 1b)

• DfmExtractor-Klasse in src/extraction/tree-sitter.ts implementieren (analog LiquidExtractor)
• Routing in extractFromSource(): .dfm/.fmx → DfmExtractor
• Komponenten als NodeKind component extrahieren (object <Name>: <Typ>)
• Verschachtelung als EdgeKind contains abbilden
• Event-Handler (OnClick = MethodName) als UnresolvedReference speichern → EdgeKind references
• Mehrzeilige Properties korrekt überspringen
• inherited-Blöcke als component behandeln
• DFM-Fixture (MainForm.dfm) in Test-Suite aufnehmen
• Resolution: Event-Handler-Namen zu Methoden in zugehöriger .pas-Datei auflösen

I) Bekannte Einschränkungen (für spätere Phasen)

• with-Statements (Phase 2): Verschleiern den Qualifier bei Aufrufen. Im MVP werden Calls innerhalb von with-Blöcken ohne Qualifier extrahiert.
• .inc Include-Dateien (Optional): Enthalten Code-Fragmente, die per {$I filename} eingebunden werden. Parser liefert möglicherweise keinen vollständigen AST.
• Class Helpers / Record Helpers (Phase 2): declHelper-Knoten erweitern existierende Typen. Erfordert spezielle Resolution-Logik.
• Generics (Phase 2): typerefTpl und genericTpl für generische Typen.