RPG Maker JS Analyzer

Propósito e intención de usuario: la RPG Maker JS Analyzer está dirigida a desarrolladores que usan RPG Maker MV/MZ y JavaScript; resuelve problemas de compatibilidad entre versiones, integración de plugins y calidad de código. Casos de uso: auditorías de migración, comprobaciones de compatibilidad de plugins y scaffolding de nuevos plugins. El valor principal es la detección temprana de problemas, plantillas de plugins estandarizadas y ciclos de depuración reducidos.
Lógica central y características: el tool realiza un análisis estático del código JavaScript y de los manifests del proyecto para identificar API obsoletas, diferencias MV/MZ y conflictos con plugins de terceros. Funciones requeridas: parser basado en AST, mapeo delta entre versiones del motor, una puntuación de compatibilidad y un generador de scaffolding. Funciones opcionales/avanzadas: entorno de evaluación en sandbox, informes exportables, recomendaciones de transformación de código y código plantilla listo para MV/MZ.
Entradas y salidas: Entradas — project_version, target_version, source_code (string o archivo), plugin_list (array de strings) y analysis_mode (enum: compatibility, scaffolding, metrics). Salidas — compatibility_report (JSON), issues (array con campos: id, severity, description, location), generated_scaffold (fragmento de código) y summary_score (0–100). Validación: las versiones deben ser MV o MZ; source_code no debe estar vacío.
Algoritmos y cálculos: un analizador AST examina estructuras de sintaxis para usar APIs y compatibilidad. Una delta-table mapea cambios MV→MZ para APIs centrales y hooks de plugins. compatibilidad = max(0, 100 - suma de pesos de issues). La generación de scaffolding usa motor de plantillas con metadatos y puntos de entrada del plugin. Resultados reproducibles con las mismas entradas.
Errores y casos límite: entradas faltantes provocan errores de esquema; versiones desconocidas usan delta por defecto. Proyectos grandes pueden tener tiempos de análisis más largos; timeouts se presentan como resultados parciales. Falta de dependencias circulares de plugins se detecta.
Industria/Región y localización: Alineado con las convenciones MV/MZ, cabeceras de plugins y identificadores independientes de localización. Soporta características ECMAScript presentes en MV/MZ; la localización se deja a fuentes proporcionadas por el usuario.
Supuestos y exclusiones: Se asume que las entradas son fuentes JavaScript dentro de proyectos RPG Maker; no hay instrumentación en tiempo real ni migración automatizada completa; se excluyen activos no-JS y consideraciones de UI/UX.