RPG Maker JS Analyzer

Scopo & Intento utente: Strumento rivolto agli sviluppatori che usano RPG Maker MV/MZ con JavaScript; risolve problemi di compatibilità tra versioni, integrazione plugin e qualità del codice. Casi d’uso includono audit di migrazione, controlli di compatibilità dei plugin e scaffolding di nuovi plugin. Il valore principale è la rilevazione precoce dei problemi, template di plugin standardizzati e cicli di debug ridotti.
Logica principale & Funzionalità: Esegue analisi statica del codice JavaScript e dei manifest di progetto per identificare API obsolete, differenze MV/MZ e conflitti con plugin di terze parti. Funzionalità necessarie: parser basato su AST, mapping delta tra versioni del motore, punteggio di compatibilità e generatore di scaffolding. Funzionalità opzionali/avanzate: ambiente di valutazione sandbox, rapporti esportabili, raccomandazioni di trasformazione del codice e template di codice pronti all’uso.
Input & Output: Input — project_version, target_version, source_code (stringa o file), plugin_list (array di stringhe) e analysis_mode (enum: compatibility, scaffolding, metrics). Output — compatibility_report (JSON), issues (array con campi: id, severity, description, location), generated_scaffold (snippet di codice) e summary_score (0–100). Validazione: le versioni devono essere MV o MZ; source_code non vuoto.
Algoritmi & Calcoli: Un parser AST analizza alberi di sintassi per l’uso delle API e la compatibilità. Delta-table mappa modifiche MV→MZ per API core e plugin-hooks. Punteggio di compatibilità = max(0, 100 - somma(weight) degli issues). Generazione di scaffolding usa un template engine con metadati e punti di ingresso del plugin. Risultati riproducibili con lo stesso input.
Errori & Casi limite: Input mancanti provocano errori di schema; versioni sconosciute usano delta predefinito. Progetti grandi comportano tempi di analisi più lunghi; timeout visualizzati come risultati parziali. Dipendenze cicliche dei plugin segnalate.
Industria/Regione & Localizzazione: Allineato alle convenzioni MV/MZ, intestazioni di plugin e identificatori indipendenti dalla localizzazione. Supporta funzioni ECMAScript presenti in MV/MZ; la localizzazione è affidata alle fonti fornite dall’utente.
Assunzioni & Esclusioni: Si assume che gli input siano sorgenti JavaScript all’interno di progetti RPG Maker; non viene eseguita strumentazione runtime o automazione completa della migrazione; esclude asset non-JS e UI/UX.