Maguyva mendukung TypeScript dengan parsing AST dan ekstraksi simbol sehingga agen AI dapat menelusuri interface, implementasi, package bersama, dan kode aplikasi yang sarat JSX di seluruh monorepo.
TypeScript adalah bahasa tempat banyak tim berharap refactoring berbantuan AI akhirnya terasa aman. Sistem type-nya membantu, tetapi tidak menghilangkan masalah sesungguhnya: package bersama, DTO, client hasil generate, komponen React, test, dan kode aplikasi semuanya merujuk pada nama yang sama di seluruh repo besar.
Untuk TypeScript, standarnya lebih tinggi daripada sekadar “memahami sintaks.” Agen perlu mengikuti kontrak dari definisi ke implementasi hingga cakupan dampak sebelum mengedit type, hook, atau client bersama.
Maguyva mengekstraksi class, method, interface, dan type alias di seluruh .ts, .mts, .cts, dan varian file TypeScript umum di seputar test dan story. Awalan member dinormalkan, tetapi identifier yang dikualifikasi class tetap dipertahankan, yang membantu saat sebuah repo memiliki nama helper tanpa kualifikasi sekaligus method yang terlingkup class dengan segmen akhir yang sama.
JSX diperlakukan sebagai sinyal struktural sungguhan, bukan markup yang tercecer. Dalam file TypeScript yang telah diindeks, test, story, dan konfigurasi tetap tersedia bersama kode aplikasi, sehingga agen dapat memeriksa contoh penggunaan dan pengaturan sebelum mengubah komponen atau layanan bersama.
Tiga pola awal biasanya sudah cukup:
find_symbol saat Anda sudah tahu nama interface, type alias, hook, atau service.dependency_search sebelum mengubah type atau client bersama yang mungkin merambat ke banyak package.structural_search saat Anda butuh bentuk kode, bukan kecocokan kata kunci, misalnya pola komponen atau method yang berulang.Untuk pertanyaan konseptual seperti “telusuri jalur pengiriman checkout,” get_task_context sering menjadi lompatan awal yang lebih baik daripada pencarian mentah.
Halaman ini paling kuat untuk monorepo web dan platform tempat TypeScript menjadi lapisan koordinasi untuk banyak package. Jika repo Anda masih mencakup banyak JS lama, baca panduan JavaScript. Jika pertanyaan Anda sebenarnya “bisakah agen memegang konteks kode aplikasi dan infra secara bersamaan?” padukan ini dengan Terraform.
Paling cocok untuk
Workflow agen
Detail engine
Titik masuk MCP yang berguna
Mulai dari sini kalau Anda sudah tahu interface bersama, type alias, hook, atau service yang ingin Anda periksa.
Gunakan sebelum mengubah DTO atau client bersama untuk mendapat cakupan dampak yang realistis lintas package.
Gunakan pencarian tingkat AST kalau Anda butuh sebuah pola, bukan kecocokan string, misalnya bentuk component atau method yang berulang.
Panduan terkait
Berguna saat sebuah repo mencampur CommonJS, ESM, script tugas, test, dan kode aplikasi yang lebih lama.
Ekstensi
.cjs, .js, .mjs, .spec.js, +2 lagi
Berguna saat kode infrastruktur menjadi bagian dari konteks repo dan bukan sesuatu yang boleh dilewati begitu saja oleh agen.
Ekstensi
.tf, .tfvars