# TypeScript-stöd i Maguyva: bättre kontext för monorepon

Canonical source: https://maguyva.ai/sv/languages/typescript

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Maguyva stöder TypeScript med AST-parsning och symbolextraktion, så att AI-agenter kan spåra gränssnitt, implementationer, delade paket och JSX-tung applikationskod över monorepon.

## Stödöversikt

- Nivå: Stöd för AST och symboler
- Programmering
- Filändelser: .cts, .d.ts, .mts, .spec.ts, .stories.ts, .test.ts, +1 till
- Riktig AST-parsning för syntaxmedveten sökning och strukturell kontext.
- Namngivna symboler driver semantisk uppslagning och korsreferenser. Grafnavigering är tillgänglig när relationsextraktion är aktiverad.
- Det här språket bidrar med symboler och relationer till grafmedveten sökning; vilka kanttyper som stöds varierar med språkets inbyggda konstruktioner.
- Både AST-parsning och symbolextraktion är tillgängliga.

## Bäst lämpad för

- Produkt- och plattformsteam som kör Next.js, Node-tjänster, delade paket och verktyg inuti ett och samma TypeScript-repo.
- Repon där gränssnitt, DTO:er, scheman och React-komponenter rör sig tillsammans men lever i olika kataloger.
- Team som försöker ge AI-agenter säker kontext innan de rör delade typer eller paketgränser.

## Agentarbetsflöden

- Följ en typ, ett gränssnitt eller en komponent från dess definition till de kodvägar som faktiskt använder den.
- Jämför implementationer över paket innan en delad hjälpfunktion eller ett API-kontrakt ändras.
- Kartlägg den troliga påverkansradien av att redigera en delad typ, hjälpfunktion eller tjänstemodul.

## Varför TypeScript-sidor spelar roll

TypeScript är språket där många team förväntar sig att AI-assisterad refaktorering äntligen ska kännas säker. Typsystemet hjälper, men det tar inte bort det verkliga problemet: delade paket, DTO:er, genererade klienter, React-komponenter, tester och appkod som alla refererar till samma namn i ett stort repo.

För TypeScript ligger ribban högre än "den förstår syntax". Agenten behöver följa kontraktet från definition till implementation till påverkansradie innan den redigerar en delad typ, hook eller klient.

## Vad Maguyva faktiskt extraherar i TypeScript

Maguyva extraherar klasser, metoder, gränssnitt och typalias över `.ts`, `.mts`, `.cts` och de vanliga TypeScript-filvarianterna kring tester och stories. Medlemsprefix normaliseras, men klasskvalificerade identifierare bevaras, vilket hjälper när ett repo har både ett okvalificerat hjälpfunktionsnamn och en klassbunden metod med samma slutliga segment.

JSX behandlas som en verklig strukturell signal snarare än lös markup. I indexerade TypeScript-filer finns tester, stories och konfiguration kvar tillsammans med applikationskod, så att en agent kan kontrollera användningsexempel och inställningar innan den ändrar en delad komponent eller tjänst.

## Användbara MCP-arbetsflöden för TypeScript-repon

Tre startmönster räcker oftast:

- Använd `find_symbol` när du redan vet gränssnittets, typaliasets, hookens eller tjänstens namn.
- Använd `dependency_search` innan delade typer eller klienter som kan påverka flera paket ändras.
- Använd `structural_search` när du behöver en kodform, inte en nyckelordsträff, till exempel upprepade komponent- eller metodmönster.

För konceptuella frågor som "följ flödet för att skicka en beställning i kassan" är `get_task_context` ofta ett bättre första steg än en rå sökning.

## Var den här sidan är mest relevant

Den här sidan är starkast för webb- och plattformsmonorepon där TypeScript är koordineringslagret för flera paket. Om ditt repo fortfarande innehåller mycket äldre JS, läs [JavaScript-guiden](/sv/languages/javascript). Om din fråga egentligen är "kan agenten hålla appkod och infrastrukturkontext ihop?" para den med [Terraform](/sv/languages/terraform).

## Motordetaljer

- TypeScript extraherar klasser, metoder, gränssnitt och typalias istället för att platta ut allt till generiska symboler.
- Medlemsprefix tas bort, men klasskvalificerade identifierare bevaras, vilket hjälper till att skilja `CheckoutService.create` från ett bart `create`.
- JSX-element räknas som instansieringar. I indexerade TypeScript-filer finns tester, stories och konfiguration kvar som kontext tillsammans med applikationskod.

## Användbara MCP-ingångar

- `find_symbol`: Börja här när du känner till det delade gränssnittet, typaliaset, hooken eller tjänsten du vill inspektera.
- `dependency_search`: Använd innan du ändrar en delad DTO eller klient för att få en realistisk påverkansradie över paketen.
- `structural_search`: Använd AST-nivåsökning när du behöver ett mönster, inte en textträff, till exempel upprepade komponent- eller metodformer.