welcome_screen.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_UI_WELCOME_SCREEN_H_
#define YAZE_APP_EDITOR_UI_WELCOME_SCREEN_H_
 
#include <functional>
#include <string>
#include <vector>
 
#include "imgui/imgui.h"
 
namespace yaze {
namespace editor {
 
struct RecentProject {
  std::string name;
  std::string filepath;
  std::string rom_title;
  std::string metadata_summary;
  std::string last_modified;
  std::string item_type;
  std::string item_icon;
  std::string thumbnail_path;  // Optional screenshot
  bool unavailable = false;
  int days_ago = 0;
};
 
class WelcomeScreen {
 public:
  WelcomeScreen();
 
  bool Show(bool* p_open);
 
  void SetOpenRomCallback(std::function<void()> callback) {
    open_rom_callback_ = callback;
  }
 
  void SetNewProjectCallback(std::function<void()> callback) {
    new_project_callback_ = callback;
  }
 
  void SetNewProjectWithTemplateCallback(
      std::function<void(const std::string&)> callback) {
    new_project_with_template_callback_ = callback;
  }
 
  void SetOpenProjectCallback(
      std::function<void(const std::string&)> callback) {
    open_project_callback_ = callback;
  }
 
  void SetOpenAgentCallback(std::function<void()> callback) {
    open_agent_callback_ = callback;
  }
 
  void SetOpenProjectDialogCallback(std::function<void()> callback) {
    open_project_dialog_callback_ = callback;
  }
 
  void SetOpenProjectManagementCallback(std::function<void()> callback) {
    open_project_management_callback_ = callback;
  }
 
  void SetOpenProjectFileEditorCallback(std::function<void()> callback) {
    open_project_file_editor_callback_ = callback;
  }
 
  void RefreshRecentProjects();
 
  void UpdateAnimations();
 
  bool ShouldShow() const { return !manually_closed_; }
 
  void MarkManuallyClosed() { manually_closed_ = true; }
 
  void ResetFirstShow() { first_show_attempt_ = true; }
 
  void SetLayoutOffsets(float left, float right) {
    left_offset_ = left;
    right_offset_ = right;
  }
 
  void SetContextState(bool has_rom, bool has_project) {
    has_rom_ = has_rom;
    has_project_ = has_project;
  }
 
 private:
  void DrawHeader();
  void DrawQuickActions();
  void DrawRecentProjects();
  void DrawProjectPanel(const RecentProject& project, int index,
                        const ImVec2& card_size);
  void DrawTemplatesSection();
  void DrawTipsSection();
  void DrawWhatsNew();
 
  std::vector<RecentProject> recent_projects_;
  bool manually_closed_ = false;
  bool first_show_attempt_ = true;  // Override ImGui ini state on first display
 
  // Callbacks
  std::function<void()> open_rom_callback_;
  std::function<void()> new_project_callback_;
  std::function<void(const std::string&)> open_project_callback_;
  std::function<void(const std::string&)> new_project_with_template_callback_;
  std::function<void()> open_agent_callback_;
  std::function<void()> open_project_dialog_callback_;
  std::function<void()> open_project_management_callback_;
  std::function<void()> open_project_file_editor_callback_;
 
  // UI state
  int selected_template_ = 0;
  static constexpr int kMaxRecentProjects = 6;
 
  // Animation state
  float animation_time_ = 0.0f;
  float card_hover_scale_[6] = {1.0f, 1.0f, 1.0f, 1.0f, 1.0f, 1.0f};
  int hovered_card_ = -1;
 
  // Staggered entry animations
  bool entry_animations_started_ = false;
  float entry_time_ = 0.0f;  // Time since welcome screen opened
  static constexpr float kEntryAnimDuration = 0.4f;   // Duration per section
  static constexpr float kEntryStaggerDelay = 0.08f;  // Delay between sections
 
  // Interactive triforce positions (smooth interpolation)
  static constexpr int kNumTriforces = 6;
  ImVec2 triforce_positions_[kNumTriforces] = {};
  ImVec2 triforce_base_positions_[kNumTriforces] = {};
  bool triforce_positions_initialized_ = false;
 
  // Particle system
  static constexpr int kMaxParticles = 50;
  struct Particle {
    ImVec2 position;
    ImVec2 velocity;
    float size;
    float alpha;
    float lifetime;
    float max_lifetime;
  };
  Particle particles_[kMaxParticles] = {};
  int active_particle_count_ = 0;
 
  // Triforce animation settings
  bool show_triforce_settings_ = false;
  float triforce_alpha_multiplier_ = 1.0f;
  float triforce_speed_multiplier_ = 0.3f;  // Default slower speed
  float triforce_size_multiplier_ = 1.0f;
  bool triforce_mouse_repel_enabled_ = true;
  bool particles_enabled_ = true;
  float particle_spawn_rate_ = 2.0f;  // Particles per second
 
  // Layout offsets for sidebar awareness (so welcome screen centers in dockspace)
  float left_offset_ = 0.0f;
  float right_offset_ = 0.0f;
 
  // Context state for gating actions
  bool has_rom_ = false;
  bool has_project_ = false;
 
  // Deferred refresh for recent projects (avoid mutating during draw loop)
  bool pending_recent_refresh_ = false;
};
 
}  // namespace editor
}  // namespace yaze
 
#endif  // YAZE_APP_EDITOR_UI_WELCOME_SCREEN_H_