Maguyva es compatible con TypeScript mediante análisis AST y extracción de símbolos, de modo que los agentes de IA puedan rastrear interfaces, implementaciones, paquetes compartidos y código de aplicación con mucho JSX en distintos monorepos.
TypeScript es el lenguaje donde muchos equipos esperan que la refactorización asistida por IA finalmente se sienta segura. El sistema de tipos ayuda, pero no elimina el problema real: paquetes compartidos, DTOs, clientes generados, componentes React, pruebas y código de aplicación, todos tirando de los mismos nombres en un repositorio grande.
Para TypeScript, el estándar es más alto que «entiende la sintaxis». El agente necesita seguir el contrato desde la definición hasta la implementación y el radio de impacto antes de editar un tipo, un hook o un cliente compartidos.
Maguyva extrae clases, métodos, interfaces y alias de tipo en .ts, .mts, .cts y las variantes de archivo TypeScript habituales para pruebas y stories. Los prefijos de miembro se normalizan, pero los identificadores calificados por clase se conservan, lo cual ayuda cuando un repositorio tiene tanto un nombre de helper simple como un método con alcance de clase que comparte el mismo segmento final.
JSX se trata como una señal estructural real y no como marcado suelto, y las expectativas de símbolos omiten explícitamente muchas rutas de pruebas, stories y configuración. Eso importa en los monorepos porque, de lo contrario, el agente pasa demasiado tiempo redescubriendo el andamiaje en lugar de la superficie de implementación real.
Tres patrones de inicio suelen ser suficientes:
find_symbol cuando ya conoces el nombre de la interfaz, el alias de tipo, el hook o el servicio.dependency_search antes de cambiar tipos o clientes compartidos que puedan ramificarse en varios paquetes.structural_search cuando necesites una forma de código, no una coincidencia de palabra clave, por ejemplo patrones repetidos de componentes o métodos.Para preguntas conceptuales como «seguir la ruta de envío del checkout», get_task_context suele ser un mejor primer paso que una búsqueda en bruto.
Esta página tiene más fuerza en monorepos web y de plataforma donde TypeScript es la capa de coordinación entre varios paquetes. Si tu repositorio todavía incluye mucho JS antiguo, lee la guía de JavaScript. Si tu pregunta en realidad es «¿el agente puede mantener juntos el código de la aplicación y el contexto de infraestructura?», combina esta página con Terraform.
Mejor uso
Flujos de trabajo del agente
Detalles del motor
Puntos de entrada MCP útiles
find_symbol
Empieza aquí cuando sepas la interfaz compartida, el alias de tipo, el hook o el servicio que quieres inspeccionar.
dependency_search
Úsala antes de cambiar un DTO o cliente compartido para obtener un radio de impacto realista entre paquetes.
structural_search
Usa búsqueda a nivel de AST cuando necesites un patrón, no una coincidencia de texto — por ejemplo, formas repetidas de componentes o métodos.
Guías relacionadas
Útil cuando un repositorio mezcla CommonJS, ESM, scripts de tareas, pruebas y código de aplicación más antiguo.
Extensiones
.cjs, .js, .mjs, .spec.js, +2 más
Útil cuando el código de infraestructura es parte del contexto del repositorio y no algo que el agente deba pasar por alto sin más.
Extensiones
.tf, .tfvars