Maguyva ondersteunt TypeScript met AST-parsing en symboolextractie, zodat AI-agents interfaces, implementaties, gedeelde packages en JSX-zware applicatiecode kunnen traceren in monorepo's.
TypeScript is de taal waar veel teams verwachten dat AI-ondersteunde refactoring eindelijk veilig zal aanvoelen. Het typesysteem helpt, maar het lost het echte probleem niet op: gedeelde packages, DTO’s, gegenereerde clients, React-componenten, tests en appcode die allemaal van dezelfde namen afhankelijk zijn in een grote repo.
Voor TypeScript ligt de lat hoger dan “het begrijpt syntax”. De agent moet het contract volgen van definitie naar implementatie naar impactradius voordat hij een gedeeld type, gedeelde hook of client bewerkt.
Maguyva extraheert classes, methods, interfaces en type aliases over .ts, .mts, .cts en de gangbare TypeScript-bestandsvarianten rond tests en stories. Member-prefixes worden genormaliseerd, maar class-gekwalificeerde identifiers blijven behouden, wat helpt wanneer een repo zowel een kale helpernaam als een class-scoped method met hetzelfde laatste segment heeft.
JSX wordt behandeld als een echt structureel signaal in plaats van losse markup. In geïndexeerde TypeScript-bestanden blijven tests, stories en configuratie beschikbaar naast applicatiecode, zodat een agent gebruiksvoorbeelden en instellingen kan controleren voordat hij een gedeelde component of service wijzigt.
Drie startpatronen zijn meestal genoeg:
find_symbol als je de interface-, type alias-, hook- of servicenaam al kent.dependency_search voordat je gedeelde types of clients wijzigt die zich mogelijk vertakken over meerdere packages.structural_search wanneer je een codevorm nodig hebt, geen keywordmatch, bijvoorbeeld herhaalde component- of method-patronen.Voor conceptuele vragen zoals “volg het afrekenpad bij checkout” is get_task_context vaak een betere eerste stap dan een ruwe zoekopdracht.
Deze pagina is vooral relevant voor web- en platformmonorepo’s waar TypeScript de coördinatielaag is voor meerdere packages. Als je repo nog veel oudere JS bevat, lees dan de JavaScript-gids. Als jouw vraag eigenlijk is “kan de agent appcode en infracontext samen vasthouden?”, combineer dit dan met Terraform.
Beste toepassing
Agentworkflows
Enginedetails
Nuttige MCP-instappunten
Begin hier wanneer je de gedeelde interface, type-alias, hook of service kent die je wilt inspecteren.
Gebruik dit voordat je een gedeelde DTO of client wijzigt om een realistische impactradius over pakketten heen te krijgen.
Gebruik zoeken op AST-niveau wanneer je een patroon nodig hebt in plaats van een letterlijke match, bijvoorbeeld herhaalde component- of methodevormen.
Gerelateerde gidsen
Nuttig wanneer een repo CommonJS, ESM, taakscripts, tests en oudere applicatiecode combineert.
Extensies
.cjs, .js, .mjs, .spec.js, +2 meer
Nuttig wanneer infrastructuurcode deel uitmaakt van de repocontext en niet iets is waar de agent luchtig aan voorbij moet gaan.
Extensies
.tf, .tfvars