right_panel_manager.cc

Go to the documentation of this file.

#include "app/editor/menu/right_panel_manager.h"
 
#include <algorithm>
#include <array>
#include <chrono>
#include <cmath>
#include <filesystem>
 
#include "absl/strings/str_format.h"
#include "app/editor/agent/agent_chat.h"
#include "app/editor/system/proposal_drawer.h"
#include "app/editor/system/shortcut_manager.h"
#include "app/editor/ui/project_management_panel.h"
#include "app/editor/ui/selection_properties_panel.h"
#include "app/editor/ui/settings_panel.h"
#include "app/editor/ui/toast_manager.h"
#include "app/gui/animation/animator.h"
#include "app/gui/core/icons.h"
#include "app/gui/core/input.h"
#include "app/gui/core/layout_helpers.h"
#include "app/gui/core/platform_keys.h"
#include "app/gui/core/style.h"
#include "app/gui/core/style_guard.h"
#include "app/gui/core/theme_manager.h"
#include "app/gui/core/ui_config.h"
#include "app/gui/core/ui_helpers.h"
#include "app/gui/widgets/themed_widgets.h"
#include "imgui/imgui.h"
#include "util/log.h"
#include "util/platform_paths.h"
 
namespace yaze {
namespace editor {
 
namespace {
 
std::string ResolveAgentChatHistoryPath() {
  auto agent_dir = util::PlatformPaths::GetAppDataSubdirectory("agent");
  if (agent_dir.ok()) {
    return (*agent_dir / "agent_chat_history.json").string();
  }
  auto temp_dir = util::PlatformPaths::GetTempDirectory();
  if (temp_dir.ok()) {
    return (*temp_dir / "agent_chat_history.json").string();
  }
  return (std::filesystem::current_path() / "agent_chat_history.json").string();
}
 
std::string BuildSelectionContextSummary(const SelectionContext& selection) {
  if (selection.type == SelectionType::kNone) {
    return "";
  }
  std::string context =
      absl::StrFormat("Selection: %s", GetSelectionTypeName(selection.type));
  if (!selection.display_name.empty()) {
    context += absl::StrFormat("\nName: %s", selection.display_name);
  }
  if (selection.id >= 0) {
    context += absl::StrFormat("\nID: 0x%X", selection.id);
  }
  if (selection.secondary_id >= 0) {
    context += absl::StrFormat("\nSecondary: 0x%X", selection.secondary_id);
  }
  if (selection.read_only) {
    context += "\nRead Only: true";
  }
  return context;
}
 
const std::array<RightPanelManager::PanelType, 7> kRightPanelSwitchOrder = {
    RightPanelManager::PanelType::kProject,
    RightPanelManager::PanelType::kProperties,
    RightPanelManager::PanelType::kAgentChat,
    RightPanelManager::PanelType::kProposals,
    RightPanelManager::PanelType::kNotifications,
    RightPanelManager::PanelType::kHelp,
    RightPanelManager::PanelType::kSettings,
};
 
int FindRightPanelIndex(RightPanelManager::PanelType type) {
  for (size_t i = 0; i < kRightPanelSwitchOrder.size(); ++i) {
    if (kRightPanelSwitchOrder[i] == type) {
      return static_cast<int>(i);
    }
  }
  return -1;
}
 
RightPanelManager::PanelType StepRightPanel(
    RightPanelManager::PanelType current, int direction) {
  if (kRightPanelSwitchOrder.empty()) {
    return RightPanelManager::PanelType::kNone;
  }
  int index = FindRightPanelIndex(current);
  if (index < 0) {
    index = 0;
  }
  const int size = static_cast<int>(kRightPanelSwitchOrder.size());
  const int next = (index + direction + size) % size;
  return kRightPanelSwitchOrder[static_cast<size_t>(next)];
}
 
const char* GetPanelShortcutAction(RightPanelManager::PanelType type) {
  switch (type) {
    case RightPanelManager::PanelType::kProject:
      return "View: Toggle Project Panel";
    case RightPanelManager::PanelType::kAgentChat:
      return "View: Toggle AI Agent Panel";
    case RightPanelManager::PanelType::kProposals:
      return "View: Toggle Proposals Panel";
    case RightPanelManager::PanelType::kSettings:
      return "View: Toggle Settings Panel";
    case RightPanelManager::PanelType::kHelp:
      return "View: Toggle Help Panel";
    case RightPanelManager::PanelType::kNotifications:
      return "View: Toggle Notifications Panel";
    case RightPanelManager::PanelType::kProperties:
      return "View: Toggle Properties Panel";
    case RightPanelManager::PanelType::kNone:
    default:
      return "";
  }
}
 
}  // namespace
 
const char* GetPanelTypeName(RightPanelManager::PanelType type) {
  switch (type) {
    case RightPanelManager::PanelType::kNone:
      return "None";
    case RightPanelManager::PanelType::kAgentChat:
      return "AI Agent";
    case RightPanelManager::PanelType::kProposals:
      return "Proposals";
    case RightPanelManager::PanelType::kSettings:
      return "Settings";
    case RightPanelManager::PanelType::kHelp:
      return "Help";
    case RightPanelManager::PanelType::kNotifications:
      return "Notifications";
    case RightPanelManager::PanelType::kProperties:
      return "Properties";
    case RightPanelManager::PanelType::kProject:
      return "Project";
    default:
      return "Unknown";
  }
}
 
const char* GetPanelTypeIcon(RightPanelManager::PanelType type) {
  switch (type) {
    case RightPanelManager::PanelType::kNone:
      return "";
    case RightPanelManager::PanelType::kAgentChat:
      return ICON_MD_SMART_TOY;
    case RightPanelManager::PanelType::kProposals:
      return ICON_MD_DESCRIPTION;
    case RightPanelManager::PanelType::kSettings:
      return ICON_MD_SETTINGS;
    case RightPanelManager::PanelType::kHelp:
      return ICON_MD_HELP;
    case RightPanelManager::PanelType::kNotifications:
      return ICON_MD_NOTIFICATIONS;
    case RightPanelManager::PanelType::kProperties:
      return ICON_MD_LIST_ALT;
    case RightPanelManager::PanelType::kProject:
      return ICON_MD_FOLDER_SPECIAL;
    default:
      return ICON_MD_HELP;
  }
}
 
std::string RightPanelManager::PanelTypeKey(PanelType type) {
  switch (type) {
    case PanelType::kAgentChat:
      return "agent_chat";
    case PanelType::kProposals:
      return "proposals";
    case PanelType::kSettings:
      return "settings";
    case PanelType::kHelp:
      return "help";
    case PanelType::kNotifications:
      return "notifications";
    case PanelType::kProperties:
      return "properties";
    case PanelType::kProject:
      return "project";
    case PanelType::kNone:
    default:
      return "none";
  }
}
 
void RightPanelManager::TogglePanel(PanelType type) {
  if (active_panel_ == type) {
    ClosePanel();
  } else {
    // Opens the requested panel (also handles re-opening during close animation)
    OpenPanel(type);
  }
}
 
bool RightPanelManager::IsPanelExpanded() const {
  return active_panel_ != PanelType::kNone || closing_;
}
 
void RightPanelManager::OpenPanel(PanelType type) {
  // If we were closing, cancel the close animation
  closing_ = false;
  closing_panel_ = PanelType::kNone;
 
  active_panel_ = type;
  animating_ = true;
  animation_target_ = 1.0f;
 
  // Check if animations are enabled
  if (!gui::GetAnimator().IsEnabled()) {
    panel_animation_ = 1.0f;
    animating_ = false;
  }
  // Otherwise keep current panel_animation_ for smooth transition
}
 
void RightPanelManager::ClosePanel() {
  if (!gui::GetAnimator().IsEnabled()) {
    // Instant close
    active_panel_ = PanelType::kNone;
    closing_ = false;
    closing_panel_ = PanelType::kNone;
    panel_animation_ = 0.0f;
    animating_ = false;
    return;
  }
 
  // Start close animation — keep the panel type so we can still draw it
  closing_ = true;
  closing_panel_ = active_panel_;
  active_panel_ = PanelType::kNone;
  animating_ = true;
  animation_target_ = 0.0f;
}
 
void RightPanelManager::CyclePanel(int direction) {
  if (direction == 0) {
    return;
  }
 
  const PanelType current_panel =
      (active_panel_ != PanelType::kNone) ? active_panel_ : closing_panel_;
  if (current_panel == PanelType::kNone) {
    return;
  }
 
  const int step = direction > 0 ? 1 : -1;
  OpenPanel(StepRightPanel(current_panel, step));
}
 
void RightPanelManager::OnHostVisibilityChanged(bool visible) {
  // Snap transition state to a stable endpoint. This avoids stale intermediate
  // frames being composited when the OS moves the app across spaces.
  (void)visible;
  closing_ = false;
  closing_panel_ = PanelType::kNone;
  animating_ = false;
 
  panel_animation_ = (active_panel_ == PanelType::kNone) ? 0.0f : 1.0f;
  animation_target_ = panel_animation_;
}
 
float RightPanelManager::GetPanelWidth() const {
  // Determine which panel to measure: active panel, or the one being closed
  PanelType effective_panel = active_panel_;
  if (effective_panel == PanelType::kNone && closing_) {
    effective_panel = closing_panel_;
  }
  if (effective_panel == PanelType::kNone) {
    return 0.0f;
  }
 
  ImGuiContext* context = ImGui::GetCurrentContext();
  if (!context) {
    return GetConfiguredPanelWidth(effective_panel) * panel_animation_;
  }
 
  const ImGuiViewport* viewport = ImGui::GetMainViewport();
  if (!viewport) {
    return GetConfiguredPanelWidth(effective_panel) * panel_animation_;
  }
 
  const float vp_width = viewport->WorkSize.x;
  const float width = GetClampedPanelWidth(effective_panel, vp_width);
 
  // Scale by animation progress for smooth docking space adjustment
  return width * panel_animation_;
}
 
void RightPanelManager::SetPanelWidth(PanelType type, float width) {
  if (type == PanelType::kNone) {
    return;
  }
  float viewport_width = 0.0f;
  if (const ImGuiViewport* viewport = ImGui::GetMainViewport()) {
    viewport_width = viewport->WorkSize.x;
  }
  if (viewport_width <= 0.0f && ImGui::GetCurrentContext()) {
    viewport_width = ImGui::GetIO().DisplaySize.x;
  }
  const auto limits = GetPanelSizeLimits(type);
  float clamped = std::max(limits.min_width, width);
  if (viewport_width > 0.0f) {
    const float ratio = viewport_width < 768.0f
                            ? std::max(0.88f, limits.max_width_ratio)
                            : limits.max_width_ratio;
    const float max_width = std::max(limits.min_width, viewport_width * ratio);
    clamped = std::clamp(clamped, limits.min_width, max_width);
  }
 
  float* target = nullptr;
  switch (type) {
    case PanelType::kAgentChat:
      target = &agent_chat_width_;
      break;
    case PanelType::kProposals:
      target = &proposals_width_;
      break;
    case PanelType::kSettings:
      target = &settings_width_;
      break;
    case PanelType::kHelp:
      target = &help_width_;
      break;
    case PanelType::kNotifications:
      target = &notifications_width_;
      break;
    case PanelType::kProperties:
      target = &properties_width_;
      break;
    case PanelType::kProject:
      target = &project_width_;
      break;
    default:
      break;
  }
  if (!target) {
    return;
  }
  if (std::abs(*target - clamped) < 0.5f) {
    return;
  }
  *target = clamped;
#if !defined(NDEBUG)
  LOG_INFO("RightPanelManager",
           "SetPanelWidth type=%d requested=%.1f clamped=%.1f",
           static_cast<int>(type), width, clamped);
#endif
  NotifyPanelWidthChanged(type, *target);
}
 
void RightPanelManager::ResetPanelWidths() {
  SetPanelWidth(
      PanelType::kAgentChat,
      GetDefaultPanelWidth(PanelType::kAgentChat, active_editor_type_));
  SetPanelWidth(
      PanelType::kProposals,
      GetDefaultPanelWidth(PanelType::kProposals, active_editor_type_));
  SetPanelWidth(
      PanelType::kSettings,
      GetDefaultPanelWidth(PanelType::kSettings, active_editor_type_));
  SetPanelWidth(PanelType::kHelp,
                GetDefaultPanelWidth(PanelType::kHelp, active_editor_type_));
  SetPanelWidth(
      PanelType::kNotifications,
      GetDefaultPanelWidth(PanelType::kNotifications, active_editor_type_));
  SetPanelWidth(
      PanelType::kProperties,
      GetDefaultPanelWidth(PanelType::kProperties, active_editor_type_));
  SetPanelWidth(PanelType::kProject,
                GetDefaultPanelWidth(PanelType::kProject, active_editor_type_));
}
 
float RightPanelManager::GetDefaultPanelWidth(PanelType type,
                                              EditorType editor) {
  switch (type) {
    case PanelType::kAgentChat:
      return std::max(gui::UIConfig::kPanelWidthAgentChat, 480.0f);
    case PanelType::kProposals:
      return std::max(gui::UIConfig::kPanelWidthProposals, 440.0f);
    case PanelType::kSettings:
      return std::max(gui::UIConfig::kPanelWidthSettings, 380.0f);
    case PanelType::kHelp:
      return std::max(gui::UIConfig::kPanelWidthHelp, 380.0f);
    case PanelType::kNotifications:
      return std::max(gui::UIConfig::kPanelWidthNotifications, 380.0f);
    case PanelType::kProperties:
      // Property panel can be wider in certain editors.
      if (editor == EditorType::kDungeon) {
        return 440.0f;
      }
      return std::max(gui::UIConfig::kPanelWidthProperties, 400.0f);
    case PanelType::kProject:
      return std::max(gui::UIConfig::kPanelWidthProject, 420.0f);
    default:
      return std::max(gui::UIConfig::kPanelWidthMedium, 380.0f);
  }
}
 
void RightPanelManager::SetPanelSizeLimits(PanelType type,
                                           const PanelSizeLimits& limits) {
  if (type == PanelType::kNone) {
    return;
  }
  PanelSizeLimits normalized = limits;
  normalized.min_width =
      std::max(gui::UIConfig::kPanelMinWidthAbsolute, normalized.min_width);
  normalized.max_width_ratio =
      std::clamp(normalized.max_width_ratio, 0.25f, 0.95f);
  panel_size_limits_[PanelTypeKey(type)] = normalized;
}
 
RightPanelManager::PanelSizeLimits RightPanelManager::GetPanelSizeLimits(
    PanelType type) const {
  auto it = panel_size_limits_.find(PanelTypeKey(type));
  if (it != panel_size_limits_.end()) {
    return it->second;
  }
 
  PanelSizeLimits defaults;
  switch (type) {
    case PanelType::kAgentChat:
      defaults.min_width = gui::UIConfig::kPanelMinWidthAgentChat;
      defaults.max_width_ratio = 0.90f;
      break;
    case PanelType::kProposals:
      defaults.min_width = gui::UIConfig::kPanelMinWidthProposals;
      defaults.max_width_ratio = 0.86f;
      break;
    case PanelType::kSettings:
      defaults.min_width = gui::UIConfig::kPanelMinWidthSettings;
      defaults.max_width_ratio = 0.80f;
      break;
    case PanelType::kHelp:
      defaults.min_width = gui::UIConfig::kPanelMinWidthHelp;
      defaults.max_width_ratio = 0.80f;
      break;
    case PanelType::kNotifications:
      defaults.min_width = gui::UIConfig::kPanelMinWidthNotifications;
      defaults.max_width_ratio = 0.82f;
      break;
    case PanelType::kProperties:
      defaults.min_width = gui::UIConfig::kPanelMinWidthProperties;
      defaults.max_width_ratio = 0.90f;
      break;
    case PanelType::kProject:
      defaults.min_width = gui::UIConfig::kPanelMinWidthProject;
      defaults.max_width_ratio = 0.86f;
      break;
    case PanelType::kNone:
    default:
      break;
  }
  return defaults;
}
 
float RightPanelManager::GetConfiguredPanelWidth(PanelType type) const {
  switch (type) {
    case PanelType::kAgentChat:
      return agent_chat_width_;
    case PanelType::kProposals:
      return proposals_width_;
    case PanelType::kSettings:
      return settings_width_;
    case PanelType::kHelp:
      return help_width_;
    case PanelType::kNotifications:
      return notifications_width_;
    case PanelType::kProperties:
      return properties_width_;
    case PanelType::kProject:
      return project_width_;
    case PanelType::kNone:
    default:
      return 0.0f;
  }
}
 
float RightPanelManager::GetClampedPanelWidth(PanelType type,
                                              float viewport_width) const {
  float width = GetConfiguredPanelWidth(type);
  if (width <= 0.0f) {
    return width;
  }
  const auto limits = GetPanelSizeLimits(type);
  const float ratio = viewport_width < 768.0f
                          ? std::max(0.88f, limits.max_width_ratio)
                          : limits.max_width_ratio;
  const float max_width = std::max(limits.min_width, viewport_width * ratio);
  return std::clamp(width, limits.min_width, max_width);
}
 
void RightPanelManager::NotifyPanelWidthChanged(PanelType type, float width) {
  if (on_panel_width_changed_) {
    on_panel_width_changed_(type, width);
  }
}
 
std::unordered_map<std::string, float> RightPanelManager::SerializePanelWidths()
    const {
  return {
      {PanelTypeKey(PanelType::kAgentChat), agent_chat_width_},
      {PanelTypeKey(PanelType::kProposals), proposals_width_},
      {PanelTypeKey(PanelType::kSettings), settings_width_},
      {PanelTypeKey(PanelType::kHelp), help_width_},
      {PanelTypeKey(PanelType::kNotifications), notifications_width_},
      {PanelTypeKey(PanelType::kProperties), properties_width_},
      {PanelTypeKey(PanelType::kProject), project_width_},
  };
}
 
void RightPanelManager::RestorePanelWidths(
    const std::unordered_map<std::string, float>& widths) {
#if !defined(NDEBUG)
  LOG_INFO("RightPanelManager", "RestorePanelWidths: %zu entries from settings",
           widths.size());
#endif
  auto apply = [&](PanelType type) {
    auto it = widths.find(PanelTypeKey(type));
    if (it != widths.end()) {
      SetPanelWidth(type, it->second);
    }
  };
  apply(PanelType::kAgentChat);
  apply(PanelType::kProposals);
  apply(PanelType::kSettings);
  apply(PanelType::kHelp);
  apply(PanelType::kNotifications);
  apply(PanelType::kProperties);
  apply(PanelType::kProject);
}
 
void RightPanelManager::Draw() {
  // Nothing to draw if no panel is active and no close animation running
  if (active_panel_ == PanelType::kNone && !closing_) {
    return;
  }
 
  // Handle Escape key to close panel
  if (active_panel_ != PanelType::kNone &&
      ImGui::IsKeyPressed(ImGuiKey_Escape)) {
    ClosePanel();
    // Don't return — we need to start drawing the close animation this frame
    if (!closing_)
      return;
  }
 
  const bool animations_enabled = gui::GetAnimator().IsEnabled();
  if (!animations_enabled && animating_) {
    panel_animation_ = animation_target_;
    animating_ = false;
    if (closing_ && animation_target_ == 0.0f) {
      closing_ = false;
      closing_panel_ = PanelType::kNone;
      return;
    }
  }
 
  // Advance animation
  if (animating_ && animations_enabled) {
    // Clamp dt to avoid giant interpolation jumps after focus/space changes.
    float delta_time = std::clamp(ImGui::GetIO().DeltaTime, 0.0f, 1.0f / 20.0f);
    float speed = gui::UIConfig::kAnimationSpeed;
    switch (gui::GetAnimator().motion_profile()) {
      case gui::MotionProfile::kSnappy:
        speed *= 1.20f;
        break;
      case gui::MotionProfile::kRelaxed:
        speed *= 0.75f;
        break;
      case gui::MotionProfile::kStandard:
      default:
        break;
    }
    float diff = animation_target_ - panel_animation_;
    panel_animation_ += diff * std::min(1.0f, delta_time * speed);
 
    // Snap to target when close enough
    if (std::abs(animation_target_ - panel_animation_) <
        gui::UIConfig::kAnimationSnapThreshold) {
      panel_animation_ = animation_target_;
      animating_ = false;
 
      // Close animation finished — fully clean up
      if (closing_ && animation_target_ == 0.0f) {
        closing_ = false;
        closing_panel_ = PanelType::kNone;
        return;
      }
    }
  }
 
  // Determine which panel type to draw content for
  PanelType draw_panel = active_panel_;
  if (draw_panel == PanelType::kNone && closing_) {
    draw_panel = closing_panel_;
  }
 
  const ImGuiViewport* viewport = ImGui::GetMainViewport();
  const float viewport_width = viewport->WorkSize.x;
  const float top_inset = gui::LayoutHelpers::GetTopInset();
  const float bottom_safe = gui::LayoutHelpers::GetSafeAreaInsets().bottom;
  const float viewport_height =
      std::max(0.0f, viewport->WorkSize.y - top_inset - bottom_safe);
 
  // Keep full-width state explicit so drag-resize and animation remain stable.
  const float full_width =
      (draw_panel == PanelType::kNone)
          ? 0.0f
          : GetClampedPanelWidth(draw_panel, viewport_width);
  const float animated_width = full_width * panel_animation_;
 
  // Use SurfaceContainer for slightly elevated panel background
  ImVec4 panel_bg = gui::GetSurfaceContainerVec4();
  ImVec4 panel_border = gui::GetOutlineVec4();
 
  ImGuiWindowFlags panel_flags =
      ImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoMove |
      ImGuiWindowFlags_NoCollapse | ImGuiWindowFlags_NoDocking |
      ImGuiWindowFlags_NoNavFocus;
 
  // Position panel: slides from right edge. At animation=1.0, fully visible.
  // At animation=0.0, fully off-screen to the right.
  float panel_x = viewport->WorkPos.x + viewport_width - animated_width;
  ImGui::SetNextWindowPos(ImVec2(panel_x, viewport->WorkPos.y + top_inset));
  ImGui::SetNextWindowSize(ImVec2(full_width, viewport_height));
 
  gui::StyledWindow panel("##RightPanel",
                          {.bg = panel_bg,
                           .border = panel_border,
                           .padding = ImVec2(0.0f, 0.0f),
                           .border_size = 1.0f},
                          nullptr, panel_flags);
  if (panel) {
    // Draw enhanced panel header
    DrawPanelHeader(GetPanelTypeName(draw_panel), GetPanelTypeIcon(draw_panel));
 
    // Content area with padding and minimum height so content never collapses
    gui::StyleVarGuard content_padding(
        ImGuiStyleVar_WindowPadding,
        ImVec2(gui::UIConfig::kPanelPaddingLarge,
               gui::UIConfig::kPanelPaddingMedium));
    const bool panel_content_open = gui::LayoutHelpers::BeginContentChild(
        "##PanelContent", ImVec2(0.0f, gui::UIConfig::kContentMinHeightList),
        false, ImGuiWindowFlags_AlwaysUseWindowPadding);
    if (panel_content_open) {
      switch (draw_panel) {
        case PanelType::kAgentChat:
          DrawAgentChatPanel();
          break;
        case PanelType::kProposals:
          DrawProposalsPanel();
          break;
        case PanelType::kSettings:
          DrawSettingsPanel();
          break;
        case PanelType::kHelp:
          DrawHelpPanel();
          break;
        case PanelType::kNotifications:
          DrawNotificationsPanel();
          break;
        case PanelType::kProperties:
          DrawPropertiesPanel();
          break;
        case PanelType::kProject:
          DrawProjectPanel();
          break;
        default:
          break;
      }
    }
    gui::LayoutHelpers::EndContentChild();
 
    // VSCode-style splitter: drag from the left edge to resize.
    if (!closing_ && active_panel_ != PanelType::kNone) {
      const float handle_width = gui::UIConfig::kSplitterWidth;
      const ImVec2 win_pos = ImGui::GetWindowPos();
      const float win_height = ImGui::GetWindowHeight();
      ImGui::SetCursorScreenPos(
          ImVec2(win_pos.x - handle_width * 0.5f, win_pos.y));
      ImGui::InvisibleButton("##RightPanelResizeHandle",
                             ImVec2(handle_width, win_height));
      const bool handle_hovered = ImGui::IsItemHovered();
      const bool handle_active = ImGui::IsItemActive();
      if (handle_hovered || handle_active) {
        ImGui::SetMouseCursor(ImGuiMouseCursor_ResizeEW);
      }
      if (handle_hovered &&
          ImGui::IsMouseDoubleClicked(ImGuiMouseButton_Left)) {
        SetPanelWidth(active_panel_,
                      GetDefaultPanelWidth(active_panel_, active_editor_type_));
      }
      if (handle_active) {
        const float new_width = GetConfiguredPanelWidth(active_panel_) -
                                ImGui::GetIO().MouseDelta.x;
        SetPanelWidth(active_panel_, new_width);
        ImGui::SetTooltip("Width: %.0f px",
                          GetConfiguredPanelWidth(active_panel_));
      }
 
      ImVec4 handle_color = gui::GetOutlineVec4();
      handle_color.w = handle_active ? 0.95f : (handle_hovered ? 0.72f : 0.35f);
      ImGui::GetWindowDrawList()->AddLine(
          ImVec2(win_pos.x, win_pos.y),
          ImVec2(win_pos.x, win_pos.y + win_height),
          ImGui::GetColorU32(handle_color), handle_active ? 2.0f : 1.0f);
    }
  }
}
 
void RightPanelManager::DrawPanelHeader(const char* title, const char* icon) {
  const float header_height = gui::UIConfig::kPanelHeaderHeight;
  const float padding = gui::UIConfig::kPanelPaddingLarge;
 
  // Header background - slightly elevated surface
  ImVec2 header_min = ImGui::GetCursorScreenPos();
  ImVec2 header_max = ImVec2(header_min.x + ImGui::GetWindowWidth(),
                             header_min.y + header_height);
 
  ImDrawList* draw_list = ImGui::GetWindowDrawList();
  draw_list->AddRectFilled(
      header_min, header_max,
      ImGui::GetColorU32(gui::GetSurfaceContainerHighVec4()));
 
  // Draw subtle bottom border
  draw_list->AddLine(ImVec2(header_min.x, header_max.y),
                     ImVec2(header_max.x, header_max.y),
                     ImGui::GetColorU32(gui::GetOutlineVec4()), 1.0f);
 
  // Position content within header
  ImGui::SetCursorPosX(padding);
  ImGui::SetCursorPosY(ImGui::GetCursorPosY() +
                       (header_height - ImGui::GetTextLineHeight()) * 0.5f);
 
  // Panel icon with primary color
  gui::ColoredText(icon, gui::GetPrimaryVec4());
 
  ImGui::SameLine();
 
  // Panel title (use current style text color)
  gui::ColoredText(title, ImGui::GetStyleColorVec4(ImGuiCol_Text));
 
  const PanelType current_panel =
      (active_panel_ != PanelType::kNone) ? active_panel_ : closing_panel_;
  const std::string previous_shortcut =
      GetShortcutLabel("View: Previous Right Panel", "");
  const std::string next_shortcut =
      GetShortcutLabel("View: Next Right Panel", "");
  const std::string previous_tooltip =
      previous_shortcut.empty() ? "Previous right panel"
                                : absl::StrFormat("Previous right panel (%s)",
                                                  previous_shortcut.c_str());
  const std::string next_tooltip =
      next_shortcut.empty()
          ? "Next right panel"
          : absl::StrFormat("Next right panel (%s)", next_shortcut.c_str());
 
  ImGui::SameLine(0.0f, gui::UIConfig::kHeaderButtonSpacing);
  if (gui::TransparentIconButton(ICON_MD_CHEVRON_LEFT, gui::IconSize::Small(),
                                 previous_tooltip.c_str(), false,
                                 gui::GetTextSecondaryVec4(), "right_sidebar",
                                 "switch_panel_prev")) {
    CycleToPreviousPanel();
  }
 
  ImGui::SameLine(0.0f, gui::UIConfig::kHeaderButtonGap);
  if (gui::TransparentIconButton(
          ICON_MD_SWAP_HORIZ, gui::IconSize::Small(), "Panel switcher", false,
          gui::GetTextSecondaryVec4(), "right_sidebar", "switch_panel_menu")) {
    ImGui::OpenPopup("##RightPanelSwitcher");
  }
 
  ImGui::SameLine(0.0f, gui::UIConfig::kHeaderButtonGap);
  if (gui::TransparentIconButton(ICON_MD_CHEVRON_RIGHT, gui::IconSize::Small(),
                                 next_tooltip.c_str(), false,
                                 gui::GetTextSecondaryVec4(), "right_sidebar",
                                 "switch_panel_next")) {
    CycleToNextPanel();
  }
 
  if (ImGui::BeginPopup("##RightPanelSwitcher")) {
    for (PanelType panel_type : kRightPanelSwitchOrder) {
      std::string label = absl::StrFormat("%s %s", GetPanelTypeIcon(panel_type),
                                          GetPanelTypeName(panel_type));
      const char* shortcut_action = GetPanelShortcutAction(panel_type);
      std::string shortcut;
      if (shortcut_action[0] != '\0') {
        shortcut = GetShortcutLabel(shortcut_action, "");
        if (shortcut == "Unassigned") {
          shortcut.clear();
        }
      }
      if (ImGui::MenuItem(label.c_str(),
                          shortcut.empty() ? nullptr : shortcut.c_str(),
                          current_panel == panel_type)) {
        OpenPanel(panel_type);
      }
    }
    ImGui::EndPopup();
  }
 
  // Right-aligned buttons
  const ImVec2 chrome_button_size = gui::IconSize::Toolbar();
  const float button_size = chrome_button_size.x;
  const float button_y =
      header_min.y + (header_height - chrome_button_size.y) * 0.5f;
  float current_x = ImGui::GetWindowWidth() - button_size - padding;
 
  // Close button
  ImGui::SetCursorScreenPos(ImVec2(header_min.x + current_x, button_y));
  if (gui::TransparentIconButton(ICON_MD_CANCEL, chrome_button_size,
                                 "Close Panel (Esc)", false, ImVec4(0, 0, 0, 0),
                                 "right_sidebar", "close_panel")) {
    ClosePanel();
  }
 
  // Lock Toggle (Only for Properties Panel)
  if (active_panel_ == PanelType::kProperties) {
    current_x -= (button_size + 4.0f);
    ImGui::SetCursorScreenPos(ImVec2(header_min.x + current_x, button_y));
 
    if (gui::TransparentIconButton(
            properties_locked_ ? ICON_MD_LOCK : ICON_MD_LOCK_OPEN,
            chrome_button_size,
            properties_locked_ ? "Unlock Selection" : "Lock Selection",
            properties_locked_, ImVec4(0, 0, 0, 0), "right_sidebar",
            "lock_selection")) {
      properties_locked_ = !properties_locked_;
    }
  }
 
  // Move cursor past the header
  ImGui::SetCursorPosY(header_height + 8.0f);
}
 
// =============================================================================
// Panel Styling Helpers
// =============================================================================
 
bool RightPanelManager::BeginPanelSection(const char* label, const char* icon,
                                          bool default_open) {
  gui::StyleColorGuard section_colors({
      {ImGuiCol_Header, gui::GetSurfaceContainerHighVec4()},
      {ImGuiCol_HeaderHovered, gui::GetSurfaceContainerHighestVec4()},
      {ImGuiCol_HeaderActive, gui::GetSurfaceContainerHighestVec4()},
  });
  gui::StyleVarGuard section_vars({
      {ImGuiStyleVar_FramePadding, ImVec2(8.0f, 6.0f)},
      {ImGuiStyleVar_FrameRounding, 4.0f},
  });
 
  // Build header text with icon if provided
  std::string header_text;
  if (icon) {
    header_text = std::string(icon) + "  " + label;
  } else {
    header_text = label;
  }
 
  ImGuiTreeNodeFlags flags =
      ImGuiTreeNodeFlags_Framed | ImGuiTreeNodeFlags_SpanAvailWidth |
      ImGuiTreeNodeFlags_AllowOverlap | ImGuiTreeNodeFlags_FramePadding;
  if (default_open) {
    flags |= ImGuiTreeNodeFlags_DefaultOpen;
  }
 
  bool is_open = ImGui::TreeNodeEx(header_text.c_str(), flags);
 
  if (is_open) {
    ImGui::Spacing();
    ImGui::Indent(4.0f);
  }
 
  return is_open;
}
 
void RightPanelManager::EndPanelSection() {
  ImGui::Unindent(4.0f);
  ImGui::TreePop();
  ImGui::Spacing();
}
 
void RightPanelManager::DrawPanelDivider() {
  ImGui::Spacing();
  {
    gui::StyleColorGuard sep_color(ImGuiCol_Separator, gui::GetOutlineVec4());
    ImGui::Separator();
  }
  ImGui::Spacing();
}
 
void RightPanelManager::DrawPanelLabel(const char* label) {
  gui::ColoredText(label, gui::GetTextSecondaryVec4());
}
 
void RightPanelManager::DrawPanelValue(const char* label, const char* value) {
  gui::ColoredTextF(gui::GetTextSecondaryVec4(), "%s:", label);
  ImGui::SameLine();
  ImGui::TextUnformatted(value);
}
 
void RightPanelManager::DrawPanelDescription(const char* text) {
  gui::StyleColorGuard desc_color(ImGuiCol_Text, gui::GetTextDisabledVec4());
  ImGui::PushTextWrapPos(ImGui::GetContentRegionAvail().x);
  ImGui::TextWrapped("%s", text);
  ImGui::PopTextWrapPos();
}
 
std::string RightPanelManager::GetShortcutLabel(
    const std::string& action, const std::string& fallback) const {
  if (!shortcut_manager_) {
    return fallback;
  }
 
  const Shortcut* shortcut = shortcut_manager_->FindShortcut(action);
  if (!shortcut) {
    return fallback;
  }
  if (shortcut->keys.empty()) {
    return "Unassigned";
  }
 
  return PrintShortcut(shortcut->keys);
}
 
void RightPanelManager::DrawShortcutRow(const std::string& action,
                                        const char* description,
                                        const std::string& fallback) {
  std::string label = GetShortcutLabel(action, fallback);
  DrawPanelValue(label.c_str(), description);
}
 
// =============================================================================
// Panel Content Drawing
// =============================================================================
 
void RightPanelManager::DrawAgentChatPanel() {
#ifdef YAZE_BUILD_AGENT_UI
  if (!agent_chat_) {
    gui::ColoredText(ICON_MD_SMART_TOY " AI Agent Not Available",
                     gui::GetTextSecondaryVec4());
    ImGui::Spacing();
    DrawPanelDescription(
        "The AI Agent is not initialized. "
        "Open the AI Agent from View menu or use Ctrl+Shift+A.");
    return;
  }
 
  agent_chat_->set_active(true);
 
  const float action_bar_height = ImGui::GetFrameHeightWithSpacing() + 8.0f;
  const float content_height =
      std::max(gui::UIConfig::kContentMinHeightChat,
               ImGui::GetContentRegionAvail().y - action_bar_height);
 
  if (ImGui::BeginChild("AgentChatBody", ImVec2(0, content_height), true)) {
    agent_chat_->Draw(0.0f);
  }
  ImGui::EndChild();
 
  gui::StyleVarGuard action_spacing(ImGuiStyleVar_ItemSpacing, ImVec2(6, 6));
  const ImVec2 action_size = gui::IconSize::Toolbar();
  const ImVec4 transparent_bg(0, 0, 0, 0);
 
  if (proposal_drawer_) {
    if (gui::TransparentIconButton(ICON_MD_DESCRIPTION, action_size,
                                   "Open Proposals", false, transparent_bg,
                                   "agent_sidebar", "open_proposals")) {
      OpenPanel(PanelType::kProposals);
    }
    ImGui::SameLine();
  }
 
  if (gui::TransparentIconButton(ICON_MD_DELETE_FOREVER, action_size,
                                 "Clear Chat History", false, transparent_bg,
                                 "agent_sidebar", "clear_history")) {
    agent_chat_->ClearHistory();
  }
  ImGui::SameLine();
 
  if (gui::TransparentIconButton(ICON_MD_FILE_DOWNLOAD, action_size,
                                 "Save Chat History", false, transparent_bg,
                                 "agent_sidebar", "save_history")) {
    agent_chat_->SaveHistory(ResolveAgentChatHistoryPath());
  }
#else
  gui::ColoredText(ICON_MD_SMART_TOY " AI Agent Not Available",
                   gui::GetTextSecondaryVec4());
 
  ImGui::Spacing();
  DrawPanelDescription(
      "The AI Agent requires agent UI support. "
      "Build with YAZE_BUILD_AGENT_UI=ON to enable.");
#endif
}
 
bool RightPanelManager::DrawAgentQuickActions() {
#ifdef YAZE_BUILD_AGENT_UI
  if (!agent_chat_) {
    return false;
  }
  const auto& theme = gui::ThemeManager::Get().GetCurrentTheme();
  const ImVec4 accent = gui::GetPrimaryVec4();
 
  std::string selection_context;
  if (properties_panel_ && properties_panel_->HasSelection()) {
    selection_context =
        BuildSelectionContextSummary(properties_panel_->GetSelection());
  }
 
  struct QuickAction {
    const char* label;
    std::string prompt;
  };
 
  std::vector<QuickAction> actions;
  if (!selection_context.empty()) {
    actions.push_back({"Explain selection",
                       "Explain this selection and how to edit it safely.\n\n" +
                           selection_context});
    actions.push_back(
        {"Suggest fixes",
         "Suggest improvements or checks for this selection.\n\n" +
             selection_context});
  }
 
  switch (active_editor_type_) {
    case EditorType::kOverworld:
      actions.push_back({"Summarize map",
                         "Summarize the current overworld map and its key "
                         "features. Use overworld tools if available."});
      actions.push_back({"List sprites/items",
                         "List notable sprites or items on the current "
                         "overworld map."});
      break;
    case EditorType::kDungeon:
      actions.push_back({"Audit room",
                         "Summarize the current dungeon room layout, doors, "
                         "and object density."});
      actions.push_back({"List sprites",
                         "List sprites in the current dungeon room and any "
                         "potential conflicts."});
      break;
    case EditorType::kGraphics:
      actions.push_back({"Review tiles",
                         "Review the current tileset usage and point out any "
                         "obvious issues."});
      actions.push_back({"Palette check",
                         "Check palette usage for contrast/readability "
                         "problems."});
      break;
    case EditorType::kPalette:
      actions.push_back({"Palette audit",
                         "Audit the active palette for hue/contrast balance "
                         "and note risks."});
      actions.push_back({"Theme ideas",
                         "Suggest a palette variation that fits the current "
                         "scene style."});
      break;
    case EditorType::kSprite:
      actions.push_back({"Sprite review",
                         "Review the selected sprite properties and suggest "
                         "tuning."});
      break;
    case EditorType::kMessage:
      actions.push_back({"Copy edit",
                         "Review the current message text for clarity and "
                         "style improvements."});
      break;
    case EditorType::kAssembly:
      actions.push_back({"ASM review",
                         "Review the current ASM changes for risks and style "
                         "issues."});
      break;
    case EditorType::kHex:
      actions.push_back({"Hex context",
                         "Explain what the current hex selection likely "
                         "represents."});
      break;
    case EditorType::kEmulator:
      actions.push_back({"Test suggestion",
                         "Propose a short emulator test to validate the "
                         "current feature."});
      break;
    case EditorType::kAgent:
      actions.push_back({"Agent config review",
                         "Review current agent configuration for practical "
                         "improvements."});
      break;
    default:
      actions.push_back({"Agent overview",
                         "Suggest the next best agent-assisted action for the "
                         "current editor context."});
      break;
  }
 
  if (actions.empty()) {
    return false;
  }
 
  ImGui::TextColored(accent, "%s Editor Actions", ICON_MD_BOLT);
  gui::ColoredText("Send a context-aware prompt to the agent.",
                   gui::GetTextSecondaryVec4());
 
  int columns = ImGui::GetContentRegionAvail().x > 420.0f ? 2 : 1;
  if (ImGui::BeginTable("AgentQuickActionsTable", columns,
                        ImGuiTableFlags_SizingStretchSame)) {
    for (const auto& action : actions) {
      ImGui::TableNextColumn();
      if (ImGui::Button(action.label, ImVec2(-1, 0))) {
        agent_chat_->SendMessage(action.prompt);
      }
    }
    ImGui::EndTable();
  }
  return true;
#else
  return false;
#endif
}
 
void RightPanelManager::DrawProposalsPanel() {
  if (proposal_drawer_) {
    // Set ROM and draw content inside the panel (not a separate window)
    if (rom_) {
      proposal_drawer_->SetRom(rom_);
    }
    proposal_drawer_->DrawContent();
  } else {
    gui::ColoredText(ICON_MD_DESCRIPTION " Proposals Not Available",
                     gui::GetTextSecondaryVec4());
 
    ImGui::Spacing();
    DrawPanelDescription(
        "The proposal system is not initialized. "
        "Proposals will appear here when the AI Agent creates them.");
  }
}
 
void RightPanelManager::DrawSettingsPanel() {
  if (settings_panel_) {
    // Draw settings inline (no card windows)
    settings_panel_->Draw();
  } else {
    gui::ColoredText(ICON_MD_SETTINGS " Settings Not Available",
                     gui::GetTextSecondaryVec4());
 
    ImGui::Spacing();
    DrawPanelDescription(
        "Settings will be available once initialized. "
        "This panel provides quick access to application settings.");
  }
}
 
void RightPanelManager::DrawHelpPanel() {
  // Context-aware editor header
  DrawEditorContextHeader();
 
  // Keyboard Shortcuts section (default open)
  if (BeginPanelSection("Keyboard Shortcuts", ICON_MD_KEYBOARD, true)) {
    DrawGlobalShortcuts();
    DrawEditorSpecificShortcuts();
    EndPanelSection();
  }
 
  // Editor-specific help (default open)
  if (BeginPanelSection("Editor Guide", ICON_MD_HELP, true)) {
    DrawEditorSpecificHelp();
    EndPanelSection();
  }
 
  // Quick Actions (collapsed by default)
  if (BeginPanelSection("Quick Actions", ICON_MD_BOLT, false)) {
    DrawQuickActionButtons();
    EndPanelSection();
  }
 
  // About section (collapsed by default)
  if (BeginPanelSection("About", ICON_MD_INFO, false)) {
    DrawAboutSection();
    EndPanelSection();
  }
}
 
void RightPanelManager::DrawEditorContextHeader() {
  const char* editor_name = "No Editor Selected";
  const char* editor_icon = ICON_MD_HELP;
 
  switch (active_editor_type_) {
    case EditorType::kOverworld:
      editor_name = "Overworld Editor";
      editor_icon = ICON_MD_LANDSCAPE;
      break;
    case EditorType::kDungeon:
      editor_name = "Dungeon Editor";
      editor_icon = ICON_MD_CASTLE;
      break;
    case EditorType::kGraphics:
      editor_name = "Graphics Editor";
      editor_icon = ICON_MD_IMAGE;
      break;
    case EditorType::kPalette:
      editor_name = "Palette Editor";
      editor_icon = ICON_MD_PALETTE;
      break;
    case EditorType::kMusic:
      editor_name = "Music Editor";
      editor_icon = ICON_MD_MUSIC_NOTE;
      break;
    case EditorType::kScreen:
      editor_name = "Screen Editor";
      editor_icon = ICON_MD_TV;
      break;
    case EditorType::kSprite:
      editor_name = "Sprite Editor";
      editor_icon = ICON_MD_SMART_TOY;
      break;
    case EditorType::kMessage:
      editor_name = "Message Editor";
      editor_icon = ICON_MD_CHAT;
      break;
    case EditorType::kEmulator:
      editor_name = "Emulator";
      editor_icon = ICON_MD_VIDEOGAME_ASSET;
      break;
    default:
      break;
  }
 
  // Draw context header with editor info
  gui::ColoredTextF(gui::GetPrimaryVec4(), "%s %s Help", editor_icon,
                    editor_name);
 
  DrawPanelDivider();
}
 
void RightPanelManager::DrawGlobalShortcuts() {
  const char* ctrl = gui::GetCtrlDisplayName();
  DrawPanelLabel("Global");
  ImGui::Indent(8.0f);
  DrawShortcutRow("Open", "Open ROM", absl::StrFormat("%s+O", ctrl));
  DrawShortcutRow("Save", "Save ROM", absl::StrFormat("%s+S", ctrl));
  DrawShortcutRow("Save As", "Save ROM As",
                  absl::StrFormat("%s+Shift+S", ctrl));
  DrawShortcutRow("Undo", "Undo", absl::StrFormat("%s+Z", ctrl));
  DrawShortcutRow("Redo", "Redo", absl::StrFormat("%s+Shift+Z", ctrl));
  DrawShortcutRow("Command Palette", "Command Palette",
                  absl::StrFormat("%s+Shift+P", ctrl));
  DrawShortcutRow("Global Search", "Global Search",
                  absl::StrFormat("%s+Shift+K", ctrl));
  DrawShortcutRow("view.toggle_activity_bar", "Toggle Sidebar",
                  absl::StrFormat("%s+B", ctrl));
  DrawShortcutRow("Show About", "About / Help", "F1");
  DrawPanelValue("Esc", "Close Panel");
  ImGui::Unindent(8.0f);
  ImGui::Spacing();
}
 
void RightPanelManager::DrawEditorSpecificShortcuts() {
  const char* ctrl = gui::GetCtrlDisplayName();
  switch (active_editor_type_) {
    case EditorType::kOverworld:
      DrawPanelLabel("Overworld");
      ImGui::Indent(8.0f);
      DrawPanelValue("1-3", "Switch World (LW/DW/SP)");
      DrawPanelValue("Arrow Keys", "Navigate Maps");
      DrawPanelValue("E", "Entity Mode");
      DrawPanelValue("T", "Tile Mode");
      DrawShortcutRow("overworld.brush_toggle", "Toggle brush", "B");
      DrawShortcutRow("overworld.fill", "Fill tool", "F");
      DrawShortcutRow("overworld.next_tile", "Next tile", "]");
      DrawShortcutRow("overworld.prev_tile", "Previous tile", "[");
      DrawPanelValue("Right Click", "Pick Tile");
      ImGui::Unindent(8.0f);
      break;
 
    case EditorType::kDungeon:
      DrawPanelLabel("Dungeon");
      ImGui::Indent(8.0f);
      DrawShortcutRow("dungeon.object.select_tool", "Select tool", "S");
      DrawShortcutRow("dungeon.object.place_tool", "Place tool", "P");
      DrawShortcutRow("dungeon.object.delete_tool", "Delete tool", "D");
      DrawShortcutRow("dungeon.object.copy", "Copy selection",
                      absl::StrFormat("%s+C", ctrl));
      DrawShortcutRow("dungeon.object.paste", "Paste selection",
                      absl::StrFormat("%s+V", ctrl));
      DrawShortcutRow("dungeon.object.delete", "Delete selection", "Delete");
      DrawPanelValue("Arrow Keys", "Move Object");
      DrawPanelValue("G", "Toggle Grid");
      DrawPanelValue("L", "Cycle Layers");
      ImGui::Unindent(8.0f);
      break;
 
    case EditorType::kGraphics:
      DrawPanelLabel("Graphics");
      ImGui::Indent(8.0f);
      DrawShortcutRow("graphics.prev_sheet", "Previous sheet", "PageUp");
      DrawShortcutRow("graphics.next_sheet", "Next sheet", "PageDown");
      DrawShortcutRow("graphics.tool.pencil", "Pencil tool", "B");
      DrawShortcutRow("graphics.tool.fill", "Fill tool", "G");
      DrawShortcutRow("graphics.zoom_in", "Zoom in", "+");
      DrawShortcutRow("graphics.zoom_out", "Zoom out", "-");
      DrawShortcutRow("graphics.toggle_grid", "Toggle grid",
                      absl::StrFormat("%s+G", ctrl));
      ImGui::Unindent(8.0f);
      break;
 
    case EditorType::kPalette:
      DrawPanelLabel("Palette");
      ImGui::Indent(8.0f);
      DrawPanelValue("Click", "Select Color");
      DrawPanelValue("Double Click", "Edit Color");
      DrawPanelValue("Drag", "Copy Color");
      ImGui::Unindent(8.0f);
      break;
 
    case EditorType::kMusic:
      DrawPanelLabel("Music");
      ImGui::Indent(8.0f);
      DrawShortcutRow("music.play_pause", "Play/Pause", "Space");
      DrawShortcutRow("music.stop", "Stop", "Esc");
      DrawShortcutRow("music.speed_up", "Speed up", "+");
      DrawShortcutRow("music.speed_down", "Slow down", "-");
      DrawPanelValue("Left/Right", "Seek");
      ImGui::Unindent(8.0f);
      break;
 
    case EditorType::kMessage:
      DrawPanelLabel("Message");
      ImGui::Indent(8.0f);
      DrawPanelValue(absl::StrFormat("%s+Enter", ctrl).c_str(),
                     "Insert Line Break");
      DrawPanelValue("Up/Down", "Navigate Messages");
      ImGui::Unindent(8.0f);
      break;
 
    default:
      DrawPanelLabel("Editor Shortcuts");
      ImGui::Indent(8.0f);
      {
        gui::StyleColorGuard text_color(ImGuiCol_Text,
                                        gui::GetTextSecondaryVec4());
        ImGui::TextWrapped("Select an editor to see specific shortcuts.");
      }
      ImGui::Unindent(8.0f);
      break;
  }
}
 
void RightPanelManager::DrawEditorSpecificHelp() {
  switch (active_editor_type_) {
    case EditorType::kOverworld: {
      gui::StyleColorGuard text_color(ImGuiCol_Text,
                                      ImGui::GetStyleColorVec4(ImGuiCol_Text));
      ImGui::Bullet();
      ImGui::TextWrapped("Paint tiles by selecting from Tile16 Selector");
      ImGui::Bullet();
      ImGui::TextWrapped(
          "Switch between Light World, Dark World, and Special Areas");
      ImGui::Bullet();
      ImGui::TextWrapped(
          "Use Entity Mode to place entrances, exits, items, and sprites");
      ImGui::Bullet();
      ImGui::TextWrapped("Right-click on the map to pick a tile for painting");
    } break;
 
    case EditorType::kDungeon: {
      gui::StyleColorGuard text_color(ImGuiCol_Text,
                                      ImGui::GetStyleColorVec4(ImGuiCol_Text));
      ImGui::Bullet();
      ImGui::TextWrapped("Select rooms from the Room Selector or Room Matrix");
      ImGui::Bullet();
      ImGui::TextWrapped("Place objects using the Object Editor panel");
      ImGui::Bullet();
      ImGui::TextWrapped(
          "Edit room headers for palette, GFX, and floor settings");
      ImGui::Bullet();
      ImGui::TextWrapped("Multiple rooms can be opened in separate tabs");
    } break;
 
    case EditorType::kGraphics: {
      gui::StyleColorGuard text_color(ImGuiCol_Text,
                                      ImGui::GetStyleColorVec4(ImGuiCol_Text));
      ImGui::Bullet();
      ImGui::TextWrapped("Browse graphics sheets using the Sheet Browser");
      ImGui::Bullet();
      ImGui::TextWrapped("Edit pixels directly with the Pixel Editor");
      ImGui::Bullet();
      ImGui::TextWrapped("Choose palettes from Palette Controls");
      ImGui::Bullet();
      ImGui::TextWrapped("View 3D objects like rupees and crystals");
    } break;
 
    case EditorType::kPalette: {
      gui::StyleColorGuard text_color(ImGuiCol_Text,
                                      ImGui::GetStyleColorVec4(ImGuiCol_Text));
      ImGui::Bullet();
      ImGui::TextWrapped("Edit overworld, dungeon, and sprite palettes");
      ImGui::Bullet();
      ImGui::TextWrapped("Use Quick Access for color harmony tools");
      ImGui::Bullet();
      ImGui::TextWrapped("Changes update in real-time across all editors");
    } break;
 
    case EditorType::kMusic: {
      gui::StyleColorGuard text_color(ImGuiCol_Text,
                                      ImGui::GetStyleColorVec4(ImGuiCol_Text));
      ImGui::Bullet();
      ImGui::TextWrapped("Browse songs in the Song Browser");
      ImGui::Bullet();
      ImGui::TextWrapped("Use the tracker for playback control");
      ImGui::Bullet();
      ImGui::TextWrapped("Edit instruments and BRR samples");
    } break;
 
    case EditorType::kMessage: {
      gui::StyleColorGuard text_color(ImGuiCol_Text,
                                      ImGui::GetStyleColorVec4(ImGuiCol_Text));
      ImGui::Bullet();
      ImGui::TextWrapped("Edit all in-game dialog messages");
      ImGui::Bullet();
      ImGui::TextWrapped("Preview text rendering with the font atlas");
      ImGui::Bullet();
      ImGui::TextWrapped("Manage the compression dictionary");
    } break;
 
    default:
      ImGui::Bullet();
      ImGui::TextWrapped("Open a ROM file via File > Open ROM");
      ImGui::Bullet();
      ImGui::TextWrapped("Select an editor from the sidebar");
      ImGui::Bullet();
      ImGui::TextWrapped("Use panels to access tools and settings");
      ImGui::Bullet();
      ImGui::TextWrapped("Save your work via File > Save ROM");
      break;
  }
}
 
void RightPanelManager::DrawQuickActionButtons() {
  const float button_width = ImGui::GetContentRegionAvail().x;
 
  gui::StyleVarGuard button_vars({
      {ImGuiStyleVar_FramePadding, ImVec2(8.0f, 6.0f)},
      {ImGuiStyleVar_FrameRounding, 4.0f},
  });
 
  // Documentation button
  {
    gui::StyleColorGuard btn_colors({
        {ImGuiCol_Button, gui::GetSurfaceContainerHighVec4()},
        {ImGuiCol_ButtonHovered, gui::GetSurfaceContainerHighestVec4()},
    });
    if (ImGui::Button(ICON_MD_DESCRIPTION " Open Documentation",
                      ImVec2(button_width, 0))) {
      gui::OpenUrl("https://github.com/scawful/yaze/wiki");
    }
  }
 
  ImGui::Spacing();
 
  // GitHub Issues button
  {
    gui::StyleColorGuard btn_colors({
        {ImGuiCol_Button, gui::GetSurfaceContainerHighVec4()},
        {ImGuiCol_ButtonHovered, gui::GetSurfaceContainerHighestVec4()},
    });
    if (ImGui::Button(ICON_MD_BUG_REPORT " Report Issue",
                      ImVec2(button_width, 0))) {
      gui::OpenUrl("https://github.com/scawful/yaze/issues/new");
    }
  }
 
  ImGui::Spacing();
 
  // Discord button
  {
    gui::StyleColorGuard btn_colors({
        {ImGuiCol_Button, gui::GetSurfaceContainerHighVec4()},
        {ImGuiCol_ButtonHovered, gui::GetSurfaceContainerHighestVec4()},
    });
    if (ImGui::Button(ICON_MD_FORUM " Join Discord", ImVec2(button_width, 0))) {
      gui::OpenUrl("https://discord.gg/zU5qDm8MZg");
    }
  }
}
 
void RightPanelManager::DrawAboutSection() {
  gui::ColoredText("YAZE - Yet Another Zelda3 Editor", gui::GetPrimaryVec4());
 
  ImGui::Spacing();
  DrawPanelDescription(
      "A comprehensive editor for The Legend of Zelda: "
      "A Link to the Past ROM files.");
 
  DrawPanelDivider();
 
  DrawPanelLabel("Credits");
  ImGui::Spacing();
  ImGui::Text("Written by: scawful");
  ImGui::Text("Special Thanks: Zarby89, JaredBrian");
 
  DrawPanelDivider();
 
  DrawPanelLabel("Links");
  ImGui::Spacing();
  gui::ColoredText(ICON_MD_LINK " github.com/scawful/yaze",
                   gui::GetTextSecondaryVec4());
}
 
void RightPanelManager::DrawNotificationsPanel() {
  if (!toast_manager_) {
    gui::ColoredText(ICON_MD_NOTIFICATIONS_OFF " Notifications Unavailable",
                     gui::GetTextSecondaryVec4());
    return;
  }
 
  // Header actions
  float avail = ImGui::GetContentRegionAvail().x;
 
  // Mark all read / Clear all buttons
  {
    gui::StyleColorGuard btn_colors({
        {ImGuiCol_Button, gui::GetSurfaceContainerHighVec4()},
        {ImGuiCol_ButtonHovered, gui::GetSurfaceContainerHighestVec4()},
    });
 
    if (ImGui::Button(ICON_MD_DONE_ALL " Mark All Read",
                      ImVec2(avail * 0.5f - 4.0f, 0))) {
      toast_manager_->MarkAllRead();
    }
    ImGui::SameLine();
    if (ImGui::Button(ICON_MD_DELETE_SWEEP " Clear All",
                      ImVec2(avail * 0.5f - 4.0f, 0))) {
      toast_manager_->ClearHistory();
    }
  }
 
  DrawPanelDivider();
 
  // Notification history
  const auto& history = toast_manager_->GetHistory();
 
  if (history.empty()) {
    ImGui::Spacing();
    gui::ColoredText(ICON_MD_INBOX " No notifications",
                     gui::GetTextSecondaryVec4());
    ImGui::Spacing();
    DrawPanelDescription(
        "Notifications will appear here when actions complete.");
    return;
  }
 
  // Stats
  size_t unread_count = toast_manager_->GetUnreadCount();
  if (unread_count > 0) {
    gui::ColoredTextF(gui::GetPrimaryVec4(), "%zu unread", unread_count);
  } else {
    gui::ColoredText("All caught up", gui::GetTextSecondaryVec4());
  }
 
  ImGui::Spacing();
 
  // Scrollable notification list (minimum height so list never collapses)
  const bool notification_list_open = gui::LayoutHelpers::BeginContentChild(
      "##NotificationList", ImVec2(0.0f, gui::UIConfig::kContentMinHeightList),
      false, ImGuiWindowFlags_AlwaysVerticalScrollbar);
  if (notification_list_open) {
    const auto& theme = gui::ThemeManager::Get().GetCurrentTheme();
    auto now = std::chrono::system_clock::now();
 
    // Group by time (Today, Yesterday, Older)
    bool shown_today = false;
    bool shown_yesterday = false;
    bool shown_older = false;
 
    for (const auto& entry : history) {
      auto diff =
          std::chrono::duration_cast<std::chrono::hours>(now - entry.timestamp)
              .count();
 
      // Time grouping headers
      if (diff < 24 && !shown_today) {
        DrawPanelLabel("Today");
        shown_today = true;
      } else if (diff >= 24 && diff < 48 && !shown_yesterday) {
        ImGui::Spacing();
        DrawPanelLabel("Yesterday");
        shown_yesterday = true;
      } else if (diff >= 48 && !shown_older) {
        ImGui::Spacing();
        DrawPanelLabel("Older");
        shown_older = true;
      }
 
      // Notification item
      ImGui::PushID(&entry);
 
      // Icon and color based on type
      const char* icon;
      ImVec4 color;
      switch (entry.type) {
        case ToastType::kSuccess:
          icon = ICON_MD_CHECK_CIRCLE;
          color = gui::ConvertColorToImVec4(theme.success);
          break;
        case ToastType::kWarning:
          icon = ICON_MD_WARNING;
          color = gui::ConvertColorToImVec4(theme.warning);
          break;
        case ToastType::kError:
          icon = ICON_MD_ERROR;
          color = gui::ConvertColorToImVec4(theme.error);
          break;
        default:
          icon = ICON_MD_INFO;
          color = gui::ConvertColorToImVec4(theme.info);
          break;
      }
 
      // Unread indicator
      if (!entry.read) {
        gui::ColoredText(ICON_MD_FIBER_MANUAL_RECORD, gui::GetPrimaryVec4());
        ImGui::SameLine();
      }
 
      // Icon
      gui::ColoredTextF(color, "%s", icon);
      ImGui::SameLine();
 
      // Message
      ImGui::TextWrapped("%s", entry.message.c_str());
 
      // Timestamp
      auto diff_sec = std::chrono::duration_cast<std::chrono::seconds>(
                          now - entry.timestamp)
                          .count();
      std::string time_str;
      if (diff_sec < 60) {
        time_str = "just now";
      } else if (diff_sec < 3600) {
        time_str = absl::StrFormat("%dm ago", diff_sec / 60);
      } else if (diff_sec < 86400) {
        time_str = absl::StrFormat("%dh ago", diff_sec / 3600);
      } else {
        time_str = absl::StrFormat("%dd ago", diff_sec / 86400);
      }
 
      gui::ColoredTextF(gui::GetTextDisabledVec4(), "  %s", time_str.c_str());
 
      ImGui::PopID();
      ImGui::Spacing();
    }
  }
  gui::LayoutHelpers::EndContentChild();
}
 
void RightPanelManager::DrawPropertiesPanel() {
  if (properties_panel_) {
    properties_panel_->Draw();
  } else {
    // Placeholder when no properties panel is set
    gui::ColoredText(ICON_MD_SELECT_ALL " No Selection",
                     gui::GetTextSecondaryVec4());
 
    ImGui::Spacing();
    DrawPanelDescription(
        "Select an item in the editor to view and edit its properties here.");
 
    DrawPanelDivider();
 
    // Show placeholder sections for what properties would look like
    if (BeginPanelSection("Position & Size", ICON_MD_STRAIGHTEN, true)) {
      DrawPanelValue("X", "--");
      DrawPanelValue("Y", "--");
      DrawPanelValue("Width", "--");
      DrawPanelValue("Height", "--");
      EndPanelSection();
    }
 
    if (BeginPanelSection("Appearance", ICON_MD_PALETTE, false)) {
      DrawPanelValue("Tile ID", "--");
      DrawPanelValue("Palette", "--");
      DrawPanelValue("Layer", "--");
      EndPanelSection();
    }
 
    if (BeginPanelSection("Behavior", ICON_MD_SETTINGS, false)) {
      DrawPanelValue("Type", "--");
      DrawPanelValue("Subtype", "--");
      DrawPanelValue("Properties", "--");
      EndPanelSection();
    }
  }
}
 
void RightPanelManager::DrawProjectPanel() {
  if (project_panel_) {
    project_panel_->Draw();
  } else {
    gui::ColoredText(ICON_MD_FOLDER_SPECIAL " No Project Loaded",
                     gui::GetTextSecondaryVec4());
 
    ImGui::Spacing();
    DrawPanelDescription(
        "Open a .yaze project file to access project management features "
        "including ROM versioning, snapshots, and configuration.");
 
    DrawPanelDivider();
 
    // Placeholder for project features
    if (BeginPanelSection("Quick Start", ICON_MD_ROCKET_LAUNCH, true)) {
      ImGui::Bullet();
      ImGui::TextWrapped("Create a new project via File > New Project");
      ImGui::Bullet();
      ImGui::TextWrapped("Open existing .yaze project files");
      ImGui::Bullet();
      ImGui::TextWrapped("Projects track ROM versions and settings");
      EndPanelSection();
    }
 
    if (BeginPanelSection("Features", ICON_MD_CHECKLIST, false)) {
      ImGui::Bullet();
      ImGui::TextWrapped("Version snapshots with Git integration");
      ImGui::Bullet();
      ImGui::TextWrapped("ROM backup and restore");
      ImGui::Bullet();
      ImGui::TextWrapped("Project-specific settings");
      ImGui::Bullet();
      ImGui::TextWrapped("Assembly code folder integration");
      EndPanelSection();
    }
  }
}
 
bool RightPanelManager::DrawPanelToggleButtons() {
  bool clicked = false;
 
  // Keep menu-bar controls on SmallButton metrics so baseline/spacing stays
  // consistent with the session + notification controls.
  auto DrawPanelButton = [&](const char* icon, const char* base_tooltip,
                             const char* shortcut_action, PanelType type) {
    const bool is_active = IsPanelActive(type);
    gui::StyleColorGuard button_colors({
        {ImGuiCol_Button, ImVec4(0, 0, 0, 0)},
        {ImGuiCol_ButtonHovered, gui::GetSurfaceContainerHighVec4()},
        {ImGuiCol_ButtonActive, gui::GetSurfaceContainerHighestVec4()},
        {ImGuiCol_Text,
         is_active ? gui::GetPrimaryVec4() : gui::GetTextSecondaryVec4()},
    });
 
    if (ImGui::SmallButton(icon)) {
      TogglePanel(type);
      clicked = true;
    }
 
    if (ImGui::IsItemHovered()) {
      const std::string shortcut = GetShortcutLabel(shortcut_action, "");
      if (shortcut.empty() || shortcut == "Unassigned") {
        ImGui::SetTooltip("%s", base_tooltip);
      } else {
        ImGui::SetTooltip("%s (%s)", base_tooltip, shortcut.c_str());
      }
    }
  };
 
  DrawPanelButton(ICON_MD_FOLDER_SPECIAL, "Project Panel",
                  "View: Toggle Project Panel", PanelType::kProject);
  ImGui::SameLine();
 
  DrawPanelButton(ICON_MD_SMART_TOY, "AI Agent Panel",
                  "View: Toggle AI Agent Panel", PanelType::kAgentChat);
  ImGui::SameLine();
 
  DrawPanelButton(ICON_MD_HELP_OUTLINE, "Help Panel", "View: Toggle Help Panel",
                  PanelType::kHelp);
  ImGui::SameLine();
 
  DrawPanelButton(ICON_MD_SETTINGS, "Settings Panel",
                  "View: Toggle Settings Panel", PanelType::kSettings);
  ImGui::SameLine();
 
  DrawPanelButton(ICON_MD_LIST_ALT, "Properties Panel",
                  "View: Toggle Properties Panel", PanelType::kProperties);
 
  return clicked;
}
 
}  // namespace editor
}  // namespace yaze