editor_layout.h

Go to the documentation of this file.

#ifndef YAZE_APP_GUI_EDITOR_LAYOUT_H
#define YAZE_APP_GUI_EDITOR_LAYOUT_H
 
#include <functional>
#include <optional>
#include <string>
#include <vector>
 
#include "app/gui/core/style_guard.h"
#include "imgui/imgui.h"
 
namespace yaze {
namespace gui {
 
class Toolset {
 public:
  Toolset() = default;
 
  // Begin the toolbar
  void Begin();
 
  // End the toolbar
  void End();
 
  // Add mode button group
  void BeginModeGroup();
  bool ModeButton(const char* icon, bool selected, const char* tooltip);
  void EndModeGroup();
 
  // Add separator
  void AddSeparator();
 
  // Add ROM version badge
  void AddRomBadge(uint8_t version, std::function<void()> on_upgrade = nullptr);
 
  // Add quick property (inline hex editing)
  bool AddProperty(const char* icon, const char* label, uint8_t* value,
                   std::function<void()> on_change = nullptr);
  bool AddProperty(const char* icon, const char* label, uint16_t* value,
                   std::function<void()> on_change = nullptr);
 
  // Add combo selector
  bool AddCombo(const char* icon, int* current, const char* const items[],
                int count);
 
  // Add toggle button
  bool AddToggle(const char* icon, bool* state, const char* tooltip);
 
  // Add action button
  bool AddAction(const char* icon, const char* tooltip);
 
  // Add collapsible settings section
  bool BeginCollapsibleSection(const char* label, bool* p_open);
  void EndCollapsibleSection();
 
  // Add v3 settings indicator
  void AddV3StatusBadge(uint8_t version, std::function<void()> on_settings);
 
  // Add usage statistics button
  bool AddUsageStatsButton(const char* tooltip);
 
  // Get button count for widget registration
  int GetButtonCount() const { return button_count_; }
 
 private:
  bool in_toolbar_ = false;
  bool in_section_ = false;
  int button_count_ = 0;
  float current_line_width_ = 0.0f;
  float mode_group_button_size_ = 0.0f;
  std::optional<StyleVarGuard> toolbar_var_guard_;
  std::optional<StyleColorGuard> mode_group_color_guard_;
};
 
class PanelWindow {
 public:
  enum class Position {
    Free,      // Floating window
    Right,     // Docked to right side
    Left,      // Docked to left side
    Bottom,    // Docked to bottom
    Top,       // Docked to top
    Center,    // Docked to center
    Floating,  // Floating but position saved
  };
 
  explicit PanelWindow(const char* title, const char* icon = nullptr);
  PanelWindow(const char* title, const char* icon, bool* p_open);
 
  // Debug: Reset frame tracking (call once per frame from main loop)
  static void ResetFrameTracking() {
    last_frame_count_ = ImGui::GetFrameCount();
    panels_begun_this_frame_.clear();
  }
 
  // Debug: Check if any panel was rendered twice this frame
  static bool HasDuplicateRendering() { return duplicate_detected_; }
  static const std::string& GetDuplicatePanelName() { return duplicate_panel_name_; }
 
 private:
  static int last_frame_count_;
  static std::vector<std::string> panels_begun_this_frame_;
  static bool duplicate_detected_;
  static std::string duplicate_panel_name_;
 
 public:
 
  // Set panel properties
  void SetDefaultSize(float width, float height);
  void SetPosition(Position pos);
  void SetStableId(const std::string& stable_id);
  void SetMinimizable(bool minimizable) { minimizable_ = minimizable; }
  void SetClosable(bool closable) { closable_ = closable; }
  void SetHeadless(bool headless) { headless_ = headless; }
  void SetDockingAllowed(bool allowed) { docking_allowed_ = allowed; }
  void SetIconCollapsible(bool collapsible) { icon_collapsible_ = collapsible; }
  void SetPinnable(bool pinnable) { pinnable_ = pinnable; }
  void SetSaveSettings(bool save) { save_settings_ = save; }
  void SetStartOffset(const ImVec2& offset) {
    start_offset_ = offset;
    start_offset_set_ = true;
  }
 
  // Custom Title Bar Buttons (e.g., Pin, Help, Settings)
  // These will be drawn in the window header or top-right corner.
  void AddHeaderButton(const char* icon, const char* tooltip, std::function<void()> callback);
 
  // Begin drawing the panel
  bool Begin(bool* p_open = nullptr);
 
  // End drawing
  void End();
 
  // Minimize/maximize
  void SetMinimized(bool minimized) { minimized_ = minimized; }
  bool IsMinimized() const { return minimized_; }
 
  // Pin management
  void SetPinned(bool pinned) { pinned_ = pinned; }
  bool IsPinned() const { return pinned_; }
  void SetPinChangedCallback(std::function<void(bool)> callback) {
    on_pin_changed_ = std::move(callback);
  }
 
  // Focus the panel window (bring to front and set focused)
  void Focus();
  bool IsFocused() const { return focused_; }
 
  // Get the window name for ImGui operations
  const char* GetWindowName() const { return window_name_.c_str(); }
 
 private:
  std::string title_;
  std::string icon_;
  std::string window_name_;  // Full window name with icon
  std::string stable_id_;
  ImVec2 default_size_;
  bool default_size_set_ = false;
  Position position_ = Position::Free;
  bool minimizable_ = true;
  bool closable_ = true;
  bool minimized_ = false;
  bool first_draw_ = true;
  bool focused_ = false;
  bool* p_open_ = nullptr;
  bool imgui_begun_ = false;  // Track if ImGui::Begin() was called
 
  // UX enhancements
  bool headless_ = false;                    // Minimal chrome, no title bar
  bool docking_allowed_ = true;              // Allow docking
  bool icon_collapsible_ = false;            // Can collapse to floating icon
  bool collapsed_to_icon_ = false;           // Currently collapsed
  ImVec2 saved_icon_pos_ = ImVec2(10, 100);  // Position when collapsed to icon
  ImVec2 start_offset_ = ImVec2(0, 0);
  bool start_offset_set_ = false;
  
  // Pinning support
  bool pinnable_ = false;
  bool pinned_ = false;
  std::function<void(bool)> on_pin_changed_;
  
  // Settings persistence
  bool save_settings_ = true;  // If false, uses ImGuiWindowFlags_NoSavedSettings
  
  // Header buttons
  struct HeaderButton {
    std::string icon;
    std::string tooltip;
    std::function<void()> callback;
  };
  std::vector<HeaderButton> header_buttons_;
 
  void DrawFloatingIconButton();
  void DrawHeaderButtons();
  void UpdateWindowName();
 
  std::optional<StyleVarGuard> panel_var_guard_;
  std::optional<StyleColorGuard> panel_color_guard_;
};
 
class EditorLayout {
 public:
  EditorLayout() = default;
 
  // Begin the editor layout
  void Begin();
 
  // End the editor layout
  void End();
 
  // Get toolbar reference
  Toolset& GetToolbar() { return toolbar_; }
 
  // Begin main canvas area
  void BeginMainCanvas();
  void EndMainCanvas();
 
  // Register a panel (for layout management)
  void RegisterPanel(PanelWindow* panel);
 
 private:
  Toolset toolbar_;
  std::vector<PanelWindow*> panels_;
  bool in_layout_ = false;
};
 
}  // namespace gui
}  // namespace yaze
 
#endif  // YAZE_APP_GUI_EDITOR_LAYOUT_H