Maguyva supporta TypeScript con parsing AST ed estrazione dei simboli, così gli agenti IA possono tracciare interfacce, implementazioni, package condivisi, e codice applicativo ricco di JSX nei monorepo.
TypeScript è il linguaggio in cui molti team si aspettano che il refactoring assistito dall’IA finalmente sembri sicuro. Il sistema di tipi aiuta, ma non elimina il vero problema: package condivisi, DTO, client generati, componenti React, test, e codice applicativo che fanno tutti riferimento agli stessi nomi in un grande repository.
Per TypeScript, lo standard è più alto di “capisce la sintassi.” L’agente deve seguire il contratto dalla definizione all’implementazione fino al raggio d’impatto prima di modificare un tipo, un hook, o un client condiviso.
Maguyva estrae classi, metodi, interfacce, e alias di tipo attraverso .ts, .mts, .cts, e le comuni varianti di file TypeScript intorno a test e story. I prefissi member vengono normalizzati, ma gli identificatori qualificati dalla classe vengono preservati, il che aiuta quando un repository ha sia un nome di helper non qualificato che un metodo con scope di classe con lo stesso segmento finale.
JSX viene trattato come un vero segnale strutturale, non come markup sparso. Nei file TypeScript indicizzati, test, stories e configurazione restano disponibili accanto al codice applicativo, aiutando un agente a verificare esempi d’uso e impostazioni prima di modificare un componente o un servizio condiviso.
Tre pattern di partenza di solito bastano:
find_symbol quando conosci già il nome dell’interfaccia, dell’alias di tipo, dell’hook, o del service.dependency_search prima di modificare tipi o client condivisi che potrebbero propagarsi tra i package.structural_search quando ti serve una forma di codice, non un match di parole chiave, per esempio pattern di componenti o metodi ripetuti.Per domande concettuali come “segui il percorso di invio del checkout,” get_task_context è spesso un primo passo migliore di una ricerca grezza.
Questa pagina è particolarmente utile per i monorepo web e platform dove TypeScript è il livello di coordinamento per più package. Se il tuo repository include ancora molto JS più vecchio, leggi la guida JavaScript. Se la tua domanda è davvero “l’agente riesce a tenere insieme codice applicativo e contesto infrastrutturale?” abbina questa pagina a Terraform.
Il più adatto per
Workflow degli agenti
Dettagli del motore
Punti di ingresso MCP utili
Inizia da qui quando conosci l'interfaccia condivisa, l'alias di tipo, l'hook o il servizio che vuoi ispezionare.
Usalo prima di modificare un DTO o un client condiviso per ottenere un raggio d'impatto realistico tra i pacchetti.
Usa la ricerca a livello AST quando ti serve un pattern, non una corrispondenza di stringa, ad esempio forme ripetute di componenti o metodi.
Guide correlate
Utile quando un repository mescola CommonJS, ESM, script di task, test, e codice applicativo più datato.
Estensioni
.cjs, .js, .mjs, .spec.js, +2 altre
Utile quando il codice infrastrutturale fa parte del contesto del repository e non è qualcosa su cui l'agente dovrebbe sorvolare.
Estensioni
.tf, .tfvars