app_manager.hpp

#ifndef APP_MANAGER_HPP
#define APP_MANAGER_HPP
 
#include <QApplication>
#include <QMainWindow>
#include <QObject>
#include <QPointer>
#include <memory>
 
#include "cmd_line_parser.hpp"
#include "config.hpp"
#include "logger.hpp"
#include "qml_bridge.hpp"
#include "translation_loader.hpp"
 
namespace App {
    /**
     * \brief Orchestrates the application's lifecycle: setup, execution, and
     * cleanup.
     *
     * This class encapsulates the initialisation of translations, argument
     * parsing, logging, and the QML interface, simplifying the global `main()`
     * function.
     * \ingroup AppLifecycle
     */
    class AppManager : public QObject {  // NOLINT
        Q_OBJECT
 
       public:
        AppManager();
 
        /**
         * \brief Sets up all application components before running.
         * \return True on success, false on failure or if --help/--version
         * was requested.
         */
        bool setup();
 
        /**
         * \brief Runs the main application event loop.
         * \return The application exit code.
         */
        int run();
 
       private slots:
        /**
         * \brief Performs cleanup after the event loop has finished.
         */
        void cleanup();
 
       private:
        /// \brief The logger for the application.
        std::unique_ptr<AppUtils::Logger> logger_;
        /// \brief The command line arguments for the application.
        std::unique_ptr<CmdLine::CmdLineArgs> args_;
        /// \brief The QML bridge for exposing C++ functionality.
        QPointer<Window::QmlBridge> bridge_;
        /// \brief The main window (stored for proper cleanup order).
        QMainWindow* mainWindow_;
    };
}  // namespace App
#endif  // APP_MANAGER_HPP