RPG Maker JS Analyzer

Propósito e Intenção: A RPG Maker JS Analyzer atende desenvolvedores que usam o RPG Maker MV/MZ com JavaScript; resolve problemas de compatibilidade entre versões, integração de plugins e qualidade de código. Casos de uso incluem auditorias de migração, checagens de compatibilidade de plugins e scaffolding de novos plugins. O valor está na detecção precoce de problemas, templates padronizados de plugins e ciclos de depuração reduzidos.
Lógica Central & Funcionalidades: A ferramenta realiza análise estática do código JavaScript e de manifests do projeto para identificar APIs obsoletas, diferenças MV/MZ e conflitos com plugins de terceiros. Funcionalidades obrigatórias: parser baseado em AST, mapeamento delta entre versões do motor, uma pontuação de compatibilidade e gerador de scaffolding. Funcionalidades opcionais/avançadas: ambiente de avaliação sandbox, relatórios exportáveis, recomendações de transformação de código e templates prontos para MV/MZ.
Entradas & Saídas: Entrada — project_version, target_version, source_code (string ou arquivo), plugin_list (array de strings) e analysis_mode (enum: compatibility, scaffolding, metrics). Saída — compatibility_report (JSON), issues (array com campos: id, severity, description, location), generated_scaffold (trecho de código) e summary_score (0–100). Validação: versões devem ser MV ou MZ; source_code não pode ficar vazio.
Algoritmos & Cálculos: Um parser AST analisa estruturas de sintaxe para uso de APIs e compatibilidade. Delta-table mapeia mudanças MV→MZ para APIs centrais e hooks de plugins. Pontuação de compatibilidade = max(0, 100 - soma dos pesos das issues). Geração de scaffolding usa motor de templates com metadados e pontos de entrada do plugin. Resultados reproduzíveis com os mesmos inputs.
Erros & Casos Limites: Entradas ausentes geram erros de esquema; versões desconhecidas utilizam delta padrão. Projetos grandes podem ter tempos de análise maiores; timeouts aparecem como resultados parciais. Dependências circulares de plugins são sinalizadas.
Indústria/Região & Localização: Alinha-se às convenções MV/MZ; cabeçalhos de plugins e identificadores independentes de localização. Suporta recursos ECMAScript presentes em MV/MZ; localização fica a cargo das fontes fornecidas pelo usuário.
Suposições & Exclusões: Assume que as entradas são fontes JavaScript dentro de projetos RPG Maker; não há instrumentação em tempo real nem automação completa de migração; exclui ativos não-JS e considerações de UI/UX.