application.h

Go to the documentation of this file.

#ifndef YAZE_APP_APPLICATION_H_
#define YAZE_APP_APPLICATION_H_
 
#include <chrono>
#include <memory>
#include <string>
#include <vector>
 
#include "absl/status/status.h"
#include "app/activity_file.h"
#include "app/controller.h"
#include "app/startup_flags.h"
#include "yaze_config.h"
 
#ifdef YAZE_WITH_GRPC
#include "app/emu/i_emulator.h"
#include "app/service/canvas_automation_service.h"
#include "app/service/unified_grpc_server.h"
#endif
 
namespace yaze {
 
struct AppConfig {
  // File loading
  std::string rom_file;
  std::string log_file;
  bool debug = false;
  std::string log_categories;
  StartupVisibility welcome_mode = StartupVisibility::kAuto;
  StartupVisibility dashboard_mode = StartupVisibility::kAuto;
  StartupVisibility sidebar_mode = StartupVisibility::kAuto;
  AssetLoadMode asset_load_mode = AssetLoadMode::kAuto;
 
  // Startup navigation
  std::string startup_editor;  // Editor to open (e.g., "Dungeon")
  std::vector<std::string>
      open_panels;  // Panel IDs to show (e.g., "dungeon.room_list")
 
  // Jump targets
  int jump_to_room = -1;  // Dungeon room ID (-1 to ignore)
  int jump_to_map = -1;   // Overworld map ID (-1 to ignore)
 
  // Services
  bool headless = false;      // Run without GUI (uses NullWindowBackend)
  bool service_mode = false;  // Run with GUI backend but hidden window
  bool enable_api = false;
  bool editor_control = false;  // Semantic local editor commands, opt-in.
  int api_port = 8080;
  bool enable_test_harness = false;
  std::string test_harness_bind_address = "0.0.0.0";
  int test_harness_port =
      50052;  // Unified gRPC server port (GUI automation + Emulator service)
  std::string backend = "internal";  // Emulator backend: "internal" or "mesen"
};
 
class Application {
 public:
  static Application& Instance();
 
  // Initialize the application with configuration
  void Initialize(const AppConfig& config);
 
  // Default initialization (empty config)
  void Initialize() { Initialize(AppConfig{}); }
 
  // Main loop tick
  void Tick();
 
  // Shutdown application
  void Shutdown();
 
  // Unified ROM loading
  void LoadRom(const std::string& path);
 
  // Accessors
  Controller* GetController() { return controller_.get(); }
  bool IsReady() const { return controller_ != nullptr; }
  const AppConfig& GetConfig() const { return config_; }
 
#ifdef YAZE_WITH_GRPC
  emu::IEmulator* GetEmulatorBackend() { return emulator_backend_.get(); }
#endif
 
 private:
  Application() = default;
  ~Application() = default;
 
  // Non-copyable
  Application(const Application&) = delete;
  Application& operator=(const Application&) = delete;
 
  std::unique_ptr<Controller> controller_;
  AppConfig config_;
 
  // Frame timing for delta_time calculation
  std::chrono::steady_clock::time_point last_frame_time_;
  float delta_time_ = 0.0f;
  bool first_frame_ = true;
  bool in_tick_ = false;  // Guards Tick() against nested run loops
 
#ifndef __EMSCRIPTEN__
  // For non-WASM builds, we need a local queue for ROMs requested before
  // the controller is initialized.
  std::string pending_rom_;
 
  // Activity file for instance discovery by Oracle Agent Manager
  std::unique_ptr<app::ActivityFile> activity_file_;
 
  // Update the activity status file with current state
  void UpdateActivityStatus();
#endif
 
  // Helper to run startup actions (jumps, card opening) after ROM load
  void RunStartupActions();
 
#ifdef YAZE_WITH_GRPC
  std::unique_ptr<YazeGRPCServer> grpc_server_;
  std::unique_ptr<CanvasAutomationServiceImpl> canvas_automation_service_;
  std::unique_ptr<emu::IEmulator>
      emulator_backend_;  // Owned adapter for gRPC service
#endif
};
 
}  // namespace yaze
 
#endif  // YAZE_APP_APPLICATION_H_