Dart w Maguyva: grafy kodu dla aplikacji Flutter i Dart

Gdzie Dart sprawia kłopot powierzchownym narzędziom AI

Dart rozkłada jeden typ na kilka konstrukcji. Klasa może dziedziczyć po jednej klasie bazowej, implementować kilka interfejsów i włączać zachowanie z mixinów przez with. Metody rozszerzające doczepiają składowe do typów zdefiniowanych gdzie indziej, a konstruktory nazwane i factory ukrywają, która klasa naprawdę powstaje. Wyszukiwanie tekstowe znajduje nazwy, ale nie strukturę, która za nimi stoi.

Maguyva daje agentowi tę strukturę, więc może on prześledzić zmianę od widżetu aż do serwisu, od którego ten zależy.

Co Maguyva wyodrębnia w Darcie

Maguyva obejmuje pliki .dart. Klasy, mixiny i rozszerzenia są wyodrębniane jako typy. Preset functions w structural_search obejmuje funkcje, metody, funkcje lokalne, lambdy oraz konstruktory generatywne, const i factory. Sygnatury zapisują opcjonalne grupy parametrów pozycyjnych i nazwanych oraz składowe static, a nazwy definicji tracą końcowe ? lub !.

Importy normalizują dyrektywy import, part i library oraz usuwają ich klauzule show, hide i as. Wywołanie przez prefiks importu, na przykład http.get po import 'package:http/http.dart' as http, zostaje w grafie.

Typowanie odbiorców śledzi parametry, zmienne typowane i zainicjalizowane, gettery oraz pętle for-in po listach, zbiorach i obiektach iterowalnych, a var i dynamic traktuje jako typy wywnioskowane. Przy rozwiązywaniu dziedziczonych składowych śledzone są klauzule extends, implements i with. Graf zapisuje też tworzenie instancji, odwołania do typów, odczyty i zapisy oraz krawędzie wyjątków.

Przykładowe prompty dla agentów

• „Kto wywołuje CartRepository.addItem i z których widżetów?” (find_symbol, potem dependency_search incoming)
• „Które klasy implementują PaymentGateway?” (dependency_search)
• „Prześledź, jak przycisk zakupu dociera do API płatności.” (get_task_context)

Znane ograniczenia

• Około 200 nazw z bibliotek podstawowych Darta jest odfiltrowywanych z relacji, w tym pomocnicze funkcje kolekcji, takie jak map, where i forEach, metody Future i Stream, takie jak then i listen, oraz biblioteki dart:. Do ich wyszukania użyj text_pattern_search.
• Węzły sygnatur w Darcie przechowują ciało jako węzeł siostrzany, więc w wynikach structural_search funkcja lokalna lub lambda może nakładać się na zawierający ją element wywoływalny, a gettery i settery pojawiają się jako sygnatury metod.

Kolejne kroki

Podłącz repozytorium za pomocą szybkiego startu, a potem sprawdź macierz obsługi na stronie zgodności. W przypadku innych mobilnych baz kodu przeczytaj przewodnik po Kotlinie i przewodnik po Swifcie.