#pragma once

#include <string>  // Para manejar cadenas de texto
#include <span>

namespace Lang {
enum class Code : int;
}

class Director {
   public:
    // --- Constructor y destructor ---
    Director(int argc, std::span<char*> argv);
    ~Director();

    // --- Bucle principal ---
    auto run() -> int;

private:
    // --- Variables internas ---
    std::string executable_path_;  // Ruta del ejecutable
    std::string system_folder_;    // Carpeta del sistema para almacenar datos

    // --- Inicialización y cierre del sistema ---
    void init();   // Inicializa la aplicación
    void close();  // Cierra y libera recursos

    // --- Configuración inicial ---
    void loadParams();                                   // Carga los parámetros del programa
    void loadScoreFile();                                // Carga el fichero de puntuaciones
    void createSystemFolder(const std::string &folder);  // Crea la carpeta del sistema

    // --- Gestión de entrada y archivos ---
    void bindInputs();                                         // Asigna botones y teclas al sistema de entrada
    void setFileList();                                        // Crea el índice de archivos disponibles
    void checkProgramArguments(int argc, std::span<char*> argv);  // Verifica los parámetros del programa // NOLINT(modernize-avoid-c-arrays)

    // --- Secciones del programa ---
    void runLogo();          // Ejecuta la pantalla con el logo
    void runIntro();         // Ejecuta la introducción del juego
    void runTitle();         // Ejecuta la pantalla de título
    void runGame();          // Inicia el juego
    void runInstructions();  // Muestra las instrucciones
    void runCredits();       // Muestra los créditos del juego
    void runHiScoreTable();  // Muestra la tabla de puntuaciones
    void runDemoGame();      // Ejecuta el modo demo
    void reset();            // Reinicia objetos y vuelve a la sección inicial

    // --- Gestión de archivos de idioma ---
    auto getLangFile(Lang::Code code) -> std::string;  // Obtiene un fichero de idioma según el código

    // --- Apagado del sistema ---
    void shutdownSystem(bool should_shutdown);  // Apaga el sistema
};