right_drawer_manager.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_MENU_RIGHT_DRAWER_MANAGER_H_
#define YAZE_APP_EDITOR_MENU_RIGHT_DRAWER_MANAGER_H_
 
#include <cstdint>
#include <functional>
#include <string>
#include <unordered_map>
#include <utility>
 
#include "absl/types/span.h"
#include "app/editor/editor.h"
#include "app/gui/core/ui_config.h"
#include "imgui/imgui.h"
 
namespace yaze {
 
class Rom;
 
namespace project {
struct YazeProject;
}
 
namespace core {
class VersionManager;
}
 
namespace editor {
 
// Forward declarations
class ProposalDrawer;
class ToastManager;
class AgentChat;
class SettingsPanel;
class SelectionPropertiesPanel;
class ProjectManagementPanel;
class ShortcutManager;
 
class RightDrawerManager {
 public:
  struct ToolOutputActions {
    std::function<void(const std::string&)> on_open_reference;
    std::function<void(uint32_t)> on_open_address;
    std::function<void(uint32_t)> on_open_lookup;
  };
 
  enum class DrawerType {
    kNone = 0,
    kAgentChat,
    kProposals,
    kSettings,
    kHelp,
    kNotifications,  // Full notification history panel
    kProperties,     // Full-editing properties panel
    kProject,        // Project management panel
    kToolOutput      // Tool/query results panel
  };
  using PanelType = DrawerType;
 
  RightDrawerManager() = default;
  ~RightDrawerManager() = default;
 
  // Non-copyable
  RightDrawerManager(const RightDrawerManager&) = delete;
  RightDrawerManager& operator=(const RightDrawerManager&) = delete;
 
  // ============================================================================
  // Configuration
  // ============================================================================
 
  void SetAgentChat(AgentChat* chat) { agent_chat_ = chat; }
  void SetProposalDrawer(ProposalDrawer* drawer) { proposal_drawer_ = drawer; }
  void SetSettingsPanel(SettingsPanel* panel) { settings_panel_ = panel; }
  // Supplies a SettingsPanel when the drawer opens with none bound, which
  // happens on the Welcome screen before any session exists. EditorManager
  // creates an empty session, like SwitchToEditor(EditorType::kSettings).
  void SetSettingsPanelProvider(std::function<SettingsPanel*()> provider) {
    settings_panel_provider_ = std::move(provider);
  }
  void SetShortcutManager(ShortcutManager* manager) {
    shortcut_manager_ = manager;
  }
  void SetPropertiesPanel(SelectionPropertiesPanel* panel) {
    properties_panel_ = panel;
  }
  void SetProjectManagementPanel(ProjectManagementPanel* panel) {
    project_panel_ = panel;
  }
  void SetToastManager(ToastManager* manager) { toast_manager_ = manager; }
  void SetRom(Rom* rom) { rom_ = rom; }
  void SetToolOutput(std::string title, std::string query, std::string content,
                     ToolOutputActions actions = {});
  const std::string& tool_output_title() const { return tool_output_title_; }
  const std::string& tool_output_query() const { return tool_output_query_; }
  const std::string& tool_output_content() const {
    return tool_output_content_;
  }
 
  void SetActiveEditor(EditorType type) { active_editor_type_ = type; }
 
  // ============================================================================
  // Panel Control
  // ============================================================================
 
  void ToggleDrawer(DrawerType type);
  [[deprecated("Use ToggleDrawer() instead.")]]
  void TogglePanel(PanelType type) {
    ToggleDrawer(type);
  }
 
  void OpenDrawer(DrawerType type);
  [[deprecated("Use OpenDrawer() instead.")]]
  void OpenPanel(PanelType type) {
    OpenDrawer(type);
  }
 
  void ToggleLastDrawer();
  DrawerType GetLastActiveDrawer() const { return last_active_panel_; }
 
  void CloseDrawer();
  [[deprecated("Use CloseDrawer() instead.")]]
  void ClosePanel() {
    CloseDrawer();
  }
 
  void CycleDrawer(int direction);
  void CycleToNextDrawer() { CycleDrawer(1); }
  void CycleToPreviousDrawer() { CycleDrawer(-1); }
  [[deprecated("Use CycleDrawer() instead.")]]
  void CyclePanel(int direction) {
    CycleDrawer(direction);
  }
 
  void OnHostVisibilityChanged(bool visible);
 
  bool IsDrawerExpanded() const;
  [[deprecated("Use IsDrawerExpanded() instead.")]]
  bool IsPanelExpanded() const {
    return IsDrawerExpanded();
  }
 
  DrawerType GetActiveDrawer() const { return active_panel_; }
  [[deprecated("Use GetActiveDrawer() instead.")]]
  PanelType GetActivePanel() const {
    return GetActiveDrawer();
  }
 
  bool IsDrawerActive(DrawerType type) const { return active_panel_ == type; }
  [[deprecated("Use IsDrawerActive() instead.")]]
  bool IsPanelActive(PanelType type) const {
    return IsDrawerActive(type);
  }
 
  // ============================================================================
  // Dimensions
  // ============================================================================
 
  float GetDrawerWidth() const;
  float GetExpandedDrawerWidth() const;
  [[deprecated("Use GetDrawerWidth() instead.")]]
  float GetPanelWidth() const {
    return GetDrawerWidth();
  }
 
  static constexpr float GetCollapsedWidth() { return 0.0f; }
 
  void SetDrawerWidth(DrawerType type, float width);
  [[deprecated("Use SetDrawerWidth() instead.")]]
  void SetPanelWidth(PanelType type, float width) {
    SetDrawerWidth(type, width);
  }
 
  void ResetDrawerWidths();
 
  static float GetDefaultDrawerWidth(DrawerType type,
                                     EditorType editor = EditorType::kUnknown);
 
  struct PanelSizeLimits {
    float min_width = 280.0f;
    float max_width_ratio = gui::UIConfig::kMaxPanelWidthRatio;
  };
 
  void SetPanelSizeLimits(PanelType type, const PanelSizeLimits& limits);
  PanelSizeLimits GetPanelSizeLimits(PanelType type) const;
  void SetDrawerSizeLimits(DrawerType type, const PanelSizeLimits& limits) {
    SetPanelSizeLimits(type, limits);
  }
  PanelSizeLimits GetDrawerSizeLimits(DrawerType type) const {
    return GetPanelSizeLimits(type);
  }
 
  std::unordered_map<std::string, float> SerializeDrawerWidths() const;
  void RestoreDrawerWidths(
      const std::unordered_map<std::string, float>& widths);
 
  void SetDrawerWidthChangedCallback(
      std::function<void(DrawerType, float)> callback) {
    on_panel_width_changed_ = std::move(callback);
  }
 
  // ============================================================================
  // Rendering
  // ============================================================================
 
  void Draw();
 
  bool DrawSidebarToggleButton();
  [[deprecated("Use DrawSidebarToggleButton() instead.")]]
  bool DrawDrawerToggleButtons() {
    return DrawSidebarToggleButton();
  }
 
  static float GetSidebarToggleWidth();
  [[deprecated("Use GetSidebarToggleWidth() instead.")]]
  static float GetDrawerToggleClusterWidth() {
    return GetSidebarToggleWidth();
  }
 
  // ============================================================================
  // Panel-specific accessors
  // ============================================================================
 
  AgentChat* agent_chat() const { return agent_chat_; }
  ProposalDrawer* proposal_drawer() const { return proposal_drawer_; }
  SettingsPanel* settings_panel() const { return settings_panel_; }
  SelectionPropertiesPanel* properties_panel() const {
    return properties_panel_;
  }
  ProjectManagementPanel* project_panel() const { return project_panel_; }
 
 private:
  friend class RightDrawerManagerTestPeer;
 
  void DrawPanelHeader(PanelType type, const char* title, const char* icon);
  void DrawDrawerNavStrip(PanelType current_panel);
  void DrawHeaderActions(PanelType type);
  void DrawHeaderContextBadge(PanelType type, float available_width);
  void DrawAgentChatPanel();
  void DrawProposalsPanel();
  void DrawSettingsPanel();
  void DrawHelpPanel();
  void DrawNotificationsPanel();
  void DrawPropertiesPanel();
  void DrawProjectPanel();
  void DrawToolOutputPanel();
  bool DrawAgentQuickActions();
 
  // Help panel helpers for context-aware content
  void DrawEditorContextHeader();
  void DrawGlobalShortcuts();
  void DrawEditorSpecificShortcuts();
  void DrawEditorSpecificHelp();
  void DrawQuickActionButtons();
  void DrawAboutSection();
 
  // Styling helpers for consistent panel UI
  bool BeginPanelSection(const char* label, const char* icon = nullptr,
                         bool default_open = true);
  void EndPanelSection();
  void DrawPanelDivider();
  void DrawPanelLabel(const char* label);
  void DrawPanelValue(const char* label, const char* value);
  void DrawPanelDescription(const char* text);
  std::string GetShortcutLabel(const std::string& action,
                               const std::string& fallback) const;
  void DrawShortcutRow(const std::string& action, const char* description,
                       const std::string& fallback);
  float GetConfiguredPanelWidth(PanelType type) const;
  float GetClampedPanelWidth(PanelType type, float viewport_width) const;
  PanelSizeLimits GetSharedPanelSizeLimits() const;
  void NotifyPanelWidthChanged(PanelType type, float width);
  static std::string PanelTypeKey(PanelType type);
 
  // Active and last-selected persistent tab.
  PanelType active_panel_ = PanelType::kNone;
  PanelType last_active_panel_ = PanelType::kProject;
 
  // Active editor for context-aware help
  EditorType active_editor_type_ = EditorType::kUnknown;
 
  // Every drawer uses the same user-resizable width so switching tabs does not
  // move the workspace edge.
  float shared_width_ = 480.0f;
 
  // Component references (not owned)
  AgentChat* agent_chat_ = nullptr;
  ProposalDrawer* proposal_drawer_ = nullptr;
  SettingsPanel* settings_panel_ = nullptr;
  std::function<SettingsPanel*()> settings_panel_provider_;
  ShortcutManager* shortcut_manager_ = nullptr;
  SelectionPropertiesPanel* properties_panel_ = nullptr;
  ProjectManagementPanel* project_panel_ = nullptr;
  ToastManager* toast_manager_ = nullptr;
  Rom* rom_ = nullptr;
  std::string tool_output_title_;
  std::string tool_output_query_;
  std::string tool_output_content_;
  ToolOutputActions tool_output_actions_;
 
  // Properties panel lock state
  bool properties_locked_ = false;
 
  // Animation state
  float panel_animation_ = 0.0f;   // 0.0 = fully closed, 1.0 = fully open
  float animation_target_ = 0.0f;  // Target value for lerp
  bool animating_ = false;
  bool closing_ = false;                        // True during close animation
  PanelType closing_panel_ = PanelType::kNone;  // Panel being animated closed
  std::unordered_map<std::string, PanelSizeLimits> panel_size_limits_;
  std::function<void(PanelType, float)> on_panel_width_changed_;
};
 
const char* GetPanelTypeName(RightDrawerManager::PanelType type);
 
const char* GetPanelTypeIcon(RightDrawerManager::PanelType type);
 
const char* GetPanelShortcutAction(RightDrawerManager::PanelType type);
 
struct DrawerCatalogEntry {
  RightDrawerManager::DrawerType type;
  const char* name = nullptr;
  const char* icon = nullptr;
  const char* shortcut_action = nullptr;
};
 
absl::Span<const DrawerCatalogEntry> GetDrawerCatalog();
 
inline const char* GetDrawerTypeName(RightDrawerManager::DrawerType type) {
  return GetPanelTypeName(type);
}
 
inline const char* GetDrawerTypeIcon(RightDrawerManager::DrawerType type) {
  return GetPanelTypeIcon(type);
}
 
inline const char* GetDrawerShortcutAction(
    RightDrawerManager::DrawerType type) {
  return GetPanelShortcutAction(type);
}
 
}  // namespace editor
}  // namespace yaze
 
#endif  // YAZE_APP_EDITOR_MENU_RIGHT_DRAWER_MANAGER_H_