54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
# Capture Convention (wie die `.scm` Queries an CodeGraph andocken)
|
|
|
|
Da wir hier nur ein ZIP-Konzept liefern (ohne den CodeGraph-Source lokal auszulesen), ist das wichtigste: **du musst die Captures so benennen, wie CodeGraph sie in den bestehenden Sprachen bereits erwartet**.
|
|
|
|
## Vorgehen
|
|
|
|
1. Öffne im CodeGraph-Repo eine bestehende Sprache (z.B. Go/Rust/Java).
|
|
2. Suche nach `.scm` Dateien und schaue:
|
|
- welche Capture-Namen verwendet werden
|
|
- wie Node-Kind/Edge-Kind gesetzt werden (oft via `#set!`)
|
|
3. Übertrage exakt dieses Schema auf Pascal.
|
|
|
|
## Empfohlene semantische Einteilung
|
|
|
|
Unabhängig von den konkreten Capture-Namen sollte jedes Query-Match folgende Informationen liefern:
|
|
|
|
### Für Nodes
|
|
- **kind**: `unit | program | package | class | interface | record | function | procedure | method | property | field | type | enum | variable`
|
|
- **name**: Symbolname
|
|
- **container** (optional): z.B. Klassenname für Methoden
|
|
- **signature** (optional): Parameter/Returntype, falls leicht verfügbar
|
|
- **range**: Start/Ende im File (Line/Column)
|
|
|
|
### Für Edges
|
|
- **kind**: `imports | calls | extends | implements | contains | returns_type`
|
|
- **from**: Node-ID der Quelle (oder "current scope")
|
|
- **to**: Zielsymbol (Name) oder Ziel-Node-ID, wenn schon auflösbar
|
|
- **raw**: Originaltext (hilft Resolvern)
|
|
|
|
## Minimaler Capture-Satz (Pseudo)
|
|
|
|
> **Wichtig:** Diese Namen sind **Platzhalter**. Bitte auf das CodeGraph-interne Schema mappen.
|
|
|
|
- `@cg.node` mit Properties:
|
|
- `(#set! cg.kind "class")`
|
|
- `(#set! cg.name @nameCapture)` oder per separate captures
|
|
|
|
- `@cg.edge` mit Properties:
|
|
- `(#set! cg.kind "calls")`
|
|
- Zielsymbol als Capture: `@cg.target`
|
|
|
|
Wenn CodeGraph statt `#set!` eine feste Capture-Nomenklatur nutzt (z.B. `@definition.function`), dann übernimm exakt diese.
|
|
|
|
## Delphi-spezifische Stolperfallen
|
|
|
|
- `procedure Foo;` vs `function Foo: Integer;`
|
|
- `class procedure` / `class function`
|
|
- `constructor` / `destructor`
|
|
- `property` (kann wie Feld wirken, ist aber call-ähnlich)
|
|
- `with`-Statements (Call-Qualifier wird verschleiert)
|
|
- Namespaces: `System.SysUtils`
|
|
|
|
Für MVP: **nicht perfekt auflösen**, aber **zuverlässig extrahieren**.
|