Maguyva podporuje TypeScript díky AST parsování a extrakci symbolů, takže AI agenti dokážou sledovat rozhraní, implementace, sdílené balíčky a aplikační kód plný JSX napříč monorepy.
TypeScript je jazyk, u kterého spousta týmů očekává, že refaktoring s asistencí AI konečně vzbudí pocit bezpečí. Typový systém pomáhá, ale neodstraňuje skutečný problém: sdílené balíčky, DTO, generovaní klienti, React komponenty, testy a aplikační kód — to vše odkazuje na stejné názvy napříč velkým repozitářem.
U TypeScriptu je laťka vyšší než „rozumí syntaxi“. Agent musí sledovat kontrakt od definice přes implementaci až po rozsah dopadu dřív, než upraví sdílený typ, hook nebo klienta.
Maguyva extrahuje třídy, metody, rozhraní a type aliasy napříč .ts, .mts, .cts a běžnými variantami souborů TypeScriptu kolem testů a stories. Prefixy členů jsou normalizované, ale identifikátory kvalifikované třídou zůstávají zachované, což pomáhá ve chvíli, kdy má repozitář jak holý název helperu, tak metodu vázanou na třídu se stejným koncovým segmentem.
S JSX se zachází jako se skutečným strukturálním signálem, ne jako s náhodným markupem. V indexovaných souborech TypeScript zůstávají testy, stories a konfigurace dostupné vedle aplikačního kódu, takže agent může před změnou sdílené komponenty nebo služby zkontrolovat příklady použití a nastavení.
Tři výchozí vzory obvykle stačí:
find_symbol, když už znáte název rozhraní, type aliasu, hooku nebo služby.dependency_search dřív, než změníte sdílené typy nebo klienty, jejichž změny mohou ovlivnit více balíčků.structural_search, když potřebujete tvar kódu, ne shodu klíčového slova, například opakující se vzory komponent nebo metod.Pro konceptuální otázky typu „projít cestu odeslání checkoutu“ bývá get_task_context často lepším prvním krokem než syrové vyhledávání.
Tato stránka je nejsilnější pro webová a platformní monorepa, kde je TypeScript koordinační vrstvou pro více balíčků. Pokud váš repozitář stále obsahuje hodně staršího JS, přečtěte si průvodce JavaScriptem. Pokud vaše otázka ve skutečnosti zní „dokáže agent udržet pohromadě aplikační kód i infrastrukturní kontext?“, spárujte tuto stránku s Terraformem.
Nejlépe se hodí pro
Workflow agentů
Podrobnosti enginu
Užitečné vstupní body MCP
Začněte tady, když znáte sdílené rozhraní, type alias, hook nebo službu, kterou chcete prozkoumat.
Použijte ho před změnou sdíleného DTO nebo klienta, abyste získali reálný poloměr dopadu napříč balíčky.
Použijte vyhledávání na úrovni AST, když potřebujete vzor, ne shodu textu, například opakující se tvary komponent nebo metod.
Související průvodci
Užitečné, když repozitář kombinuje CommonJS, ESM, task skripty, testy a starší aplikační kód.
Přípony
.cjs, .js, .mjs, .spec.js, +2 dalších
Užitečné, když je infrastrukturní kód součástí kontextu repozitáře a ne něčím, co agent jen mávnutím ruky přeskočí.
Přípony
.tf, .tfvars