editor_manager.cc

Go to the documentation of this file.

// Related header
#include "editor_manager.h"
 
// C system headers
#include <cctype>
#include <cstdint>
#include <cstdio>
#include <cstring>
#include <ctime>
 
// C++ standard library headers
#include <algorithm>
#include <array>
#include <chrono>
#include <cstdlib>
#include <exception>
#include <filesystem>
#include <fstream>
#include <functional>
#include <initializer_list>
#include <iterator>
#include <map>
#include <memory>
#include <optional>
#include <sstream>
#include <stdexcept>
#include <string>
#include <string_view>
#include <unordered_map>
#include <unordered_set>
#include <utility>
#include <vector>
 
#ifdef __APPLE__
#include <TargetConditionals.h>
#endif
 
// Third-party library headers
#define IMGUI_DEFINE_MATH_OPERATORS
#include "absl/status/status.h"
#include "absl/status/statusor.h"
#include "absl/strings/ascii.h"
#include "absl/strings/match.h"
#include "absl/strings/str_format.h"
#include "absl/strings/str_join.h"
#include "absl/strings/str_split.h"
#include "absl/strings/string_view.h"
#include "imgui/imgui.h"
#ifdef YAZE_WITH_JSON
#include "nlohmann/json.hpp"
#endif
#ifdef _WIN32
#include <process.h>
#else
#include <unistd.h>
#endif
 
// Project headers
#include "app/application.h"
#include "app/editor/agent/agent_ui_controller.h"
#include "app/editor/dungeon/dungeon_editor_v2.h"
#include "app/editor/editor.h"
#include "app/editor/graphics/graphics_editor.h"
#include "app/editor/graphics/screen_editor.h"
#include "app/editor/hack/workflow/hack_workflow_backend.h"
#include "app/editor/hack/workflow/hack_workflow_backend_factory.h"
#include "app/editor/hack/workflow/project_workflow_output_panel.h"
#include "app/editor/layout/layout_manager.h"
#include "app/editor/layout/layout_presets.h"
#include "app/editor/menu/activity_bar.h"
#include "app/editor/menu/menu_orchestrator.h"
#include "app/editor/message/message_editor.h"
#include "app/editor/overworld/overworld_editor.h"
#include "app/editor/session_types.h"
#include "app/editor/shell/coordinator/ui_coordinator.h"
#include "app/editor/shell/feedback/popup_manager.h"
#include "app/editor/shell/feedback/toast_manager.h"
#include "app/editor/shell/windows/dashboard_panel.h"
#include "app/editor/shell/windows/project_management_panel.h"
#include "app/editor/shell/windows/settings_panel.h"
#include "app/editor/sprite/sprite_editor.h"
#include "app/editor/system/editor_registry.h"
#include "app/editor/system/emulator_runtime_policy.h"
#include "app/editor/system/project_workflow_status.h"
#include "app/editor/system/session/collision_source_pairing.h"
#include "app/editor/system/session/default_editor_factories.h"
#include "app/editor/system/shortcut_configurator.h"
#include "app/editor/system/workspace/panel_visibility.h"
#include "app/editor/system/workspace/workspace_window_manager.h"
#include "app/emu/emulator.h"
#include "app/gfx/debug/performance/performance_dashboard.h"
#include "app/gfx/debug/performance/performance_profiler.h"
#include "app/gfx/resource/arena.h"
#include "app/gfx/util/palette_manager.h"
#include "app/gui/animation/animator.h"
#include "app/gui/core/icons.h"
#include "app/gui/core/style_guard.h"
#include "app/gui/core/theme_manager.h"
#include "app/platform/font_loader.h"
#include "app/platform/ios/ios_platform_state.h"
#include "app/platform/timing.h"
#include "app/testing/test_manager.h"
#include "core/features.h"
#include "core/native_save_receipt.h"
#include "core/palette_catalog.h"
#include "core/project.h"
#include "core/rom_settings.h"
#include "core/source_artifact_publisher.h"
#include "editor/core/content_registry.h"
#include "editor/core/editor_context.h"
#include "editor/events/core_events.h"
#include "editor/layout/layout_coordinator.h"
#include "editor/menu/right_drawer_manager.h"
#include "editor/system/editor_activator.h"
#include "editor/system/shortcut_manager.h"
#include "editor/ui/rom_load_options_dialog.h"
#include "rom/rom.h"
#include "rom/rom_diff.h"
#include "rom/transaction.h"
#include "startup_flags.h"
#include "util/file_util.h"
#include "util/i18n/language_manager.h"
#include "util/log.h"
#include "util/macro.h"
#include "util/rom_hash.h"
#include "yaze_config.h"
#include "zelda3/dungeon/custom_object.h"
#include "zelda3/dungeon/draw_routines/draw_routine_registry.h"
#include "zelda3/dungeon/dungeon_rom_addresses.h"
#include "zelda3/dungeon/oracle_rom_safety_preflight.h"
#include "zelda3/dungeon/water_fill_zone.h"
#include "zelda3/game_data.h"
#include "zelda3/overworld/overworld.h"
#include "zelda3/overworld/overworld_entrance.h"
#include "zelda3/overworld/overworld_map.h"
#include "zelda3/overworld/overworld_version_helper.h"
#include "zelda3/resource_labels.h"
#include "zelda3/screen/dungeon_map.h"
#include "zelda3/sprite/sprite.h"
 
// Conditional platform headers
#ifdef __EMSCRIPTEN__
#include "app/platform/wasm/wasm_control_api.h"
#include "app/platform/wasm/wasm_loading_manager.h"
#include "app/platform/wasm/wasm_session_bridge.h"
#endif
 
// Conditional test headers
#ifdef YAZE_ENABLE_TESTING
#include "app/testing/core_systems_test_suite.h"
#include "app/testing/e2e_test_suite.h"
#include "app/testing/integrated_test_suite.h"
#include "app/testing/rom_dependent_test_suite.h"
#include "app/testing/zscustomoverworld_test_suite.h"
#endif
#ifdef YAZE_ENABLE_GTEST
#include "app/testing/unit_test_suite.h"
#endif
#ifdef YAZE_WITH_GRPC
#include "app/testing/z3ed_test_suite.h"
#endif
 
// Conditional agent UI headers
#ifdef YAZE_BUILD_AGENT_UI
#include "app/editor/agent/agent_chat.h"
#endif
 
namespace yaze::editor {
 
namespace {
absl::StatusOr<std::map<std::string, std::string>> ProjectBuildEnvironment(
    const project::YazeProject& project,
    const std::string& editing_source_path) {
  if (project.filepath.empty()) {
    return absl::FailedPreconditionError("Save the project before building");
  }
  std::error_code error;
  const auto project_file =
      std::filesystem::absolute(project.filepath, error).lexically_normal();
  if (error) {
    return absl::FailedPreconditionError(
        "Cannot resolve the project build context: " + error.message());
  }
  const auto absolute = [&project_file](const std::string& value) {
    if (value.empty()) {
      return std::string();
    }
    const std::filesystem::path path(value);
    return (path.is_absolute() ? path : project_file.parent_path() / path)
        .lexically_normal()
        .string();
  };
  std::string save_context_path;
#if defined(YAZE_WITH_JSON) && !defined(__EMSCRIPTEN__)
  if (!editing_source_path.empty()) {
    ASSIGN_OR_RETURN(
        auto save_context,
        core::GetNativeSaveContext(editing_source_path, project_file.string()));
    save_context_path = save_context.path.string();
  }
#endif
  return std::map<std::string, std::string>{
      {"YAZE_PROJECT_FILE", project_file.string()},
      {"YAZE_PROJECT_CODE_FOLDER", absolute(project.code_folder)},
      {"YAZE_PROJECT_ROM", absolute(project.rom_filename)},
      {"YAZE_NATIVE_SAVE_RECEIPT", project_file.string() + ".native-save.json"},
      {"YAZE_NATIVE_SAVE_CONTEXT", save_context_path},
      {"YAZE_LYRA_TERRAIN_FILE", absolute(project.lyra_terrain_file)},
      {"OOS_LYRA_PROJECT",
       project.lyra_terrain_file.empty() ? "" : project_file.string()},
      {"OOS_LYRA_REQUEST", absolute(project.lyra_build_request_file)}};
}
 
std::string LastNonEmptyLine(const std::string& text) {
  std::vector<std::string> lines = absl::StrSplit(text, '\n');
  for (auto it = lines.rbegin(); it != lines.rend(); ++it) {
    std::string line = std::string(*it);
    absl::StripAsciiWhitespace(&line);
    if (!line.empty()) {
      return line;
    }
  }
  return "";
}
 
void UpdateBuildWorkflowStatus(StatusBar* status_bar,
                               ProjectManagementPanel* project_panel,
                               const ProjectWorkflowStatus& status) {
  ContentRegistry::Context::SetBuildWorkflowStatus(status);
  if (status_bar != nullptr) {
    status_bar->SetBuildStatus(status);
  }
  if (project_panel != nullptr) {
    project_panel->SetBuildStatus(status);
  }
}
 
void UpdateRunWorkflowStatus(StatusBar* status_bar,
                             ProjectManagementPanel* project_panel,
                             const ProjectWorkflowStatus& status) {
  ContentRegistry::Context::SetRunWorkflowStatus(status);
  if (status_bar != nullptr) {
    status_bar->SetRunStatus(status);
  }
  if (project_panel != nullptr) {
    project_panel->SetRunStatus(status);
  }
}
 
void AppendWorkflowHistoryEntry(const std::string& kind,
                                const ProjectWorkflowStatus& status,
                                const std::string& output_log) {
  ContentRegistry::Context::AppendWorkflowHistory(
      {.kind = kind,
       .status = status,
       .output_log = output_log,
       .timestamp = std::chrono::system_clock::now()});
}
 
void MergeRightDrawerWidthPreferences(
    std::unordered_map<std::string, float>* preferences,
    const std::unordered_map<std::string, float>& drawer_widths) {
  if (preferences == nullptr) {
    return;
  }
  constexpr std::array<const char*, 9> kDrawerWidthKeys = {
      "right_sidebar.shared", "agent_chat", "proposals", "settings",    "help",
      "notifications",        "properties", "project",   "tool_output",
  };
  for (const char* key : kDrawerWidthKeys) {
    preferences->erase(key);
  }
  for (const auto& [key, width] : drawer_widths) {
    preferences->insert_or_assign(key, width);
  }
}
 
std::string StripSessionPrefix(absl::string_view panel_id) {
  if (panel_id.size() > 2 && panel_id[0] == 's' &&
      absl::ascii_isdigit(panel_id[1])) {
    const size_t dot = panel_id.find('.');
    if (dot != absl::string_view::npos) {
      return std::string(panel_id.substr(dot + 1));
    }
  }
  return std::string(panel_id);
}
 
void SeedOracleProjectInRecents() {
  namespace fs = std::filesystem;
 
  std::vector<fs::path> roots;
  if (const char* home = std::getenv("HOME");
      home != nullptr && std::strlen(home) > 0) {
    roots.push_back(fs::path(home) / "src" / "hobby" / "oracle-of-secrets");
  }
 
  std::vector<fs::path> candidates;
  std::unordered_set<std::string> seen;
  auto add_candidate = [&](const fs::path& path) {
    std::error_code ec;
    if (!fs::exists(path, ec) || ec) {
      return;
    }
    std::string ext = path.extension().string();
    absl::AsciiStrToLower(&ext);
    if (ext != ".yaze" && ext != ".yazeproj") {
      return;
    }
    const std::string normalized = fs::weakly_canonical(path, ec).string();
    const std::string key = normalized.empty() ? path.string() : normalized;
    if (key.empty() || seen.count(key) > 0) {
      return;
    }
    seen.insert(key);
    candidates.push_back(path);
  };
 
  for (const auto& root : roots) {
    std::error_code ec;
    if (!fs::exists(root, ec) || ec) {
      continue;
    }
 
    // Priority candidates first.
    add_candidate(root / "Oracle-of-Secrets.yaze");
    add_candidate(root / "Oracle of Secrets.yaze");
    add_candidate(root / "Oracle-of-Secrets.yazeproj");
    add_candidate(root / "Oracle of Secrets.yazeproj");
    add_candidate(root / "Roms" / "Oracle of Secrets.yaze");
 
    // Also detect additional local project files nearby.
    fs::recursive_directory_iterator it(
        root, fs::directory_options::skip_permission_denied, ec);
    fs::recursive_directory_iterator end;
    if (ec) {
      continue;
    }
    for (; it != end; it.increment(ec)) {
      if (ec) {
        ec.clear();
        continue;
      }
      if (it.depth() > 2) {
        it.disable_recursion_pending();
        continue;
      }
      add_candidate(it->path());
    }
  }
 
  if (candidates.empty()) {
    return;
  }
 
  auto& manager = project::RecentFilesManager::GetInstance();
  // Add in reverse so the first candidate remains most recent.
  for (auto it = candidates.rbegin(); it != candidates.rend(); ++it) {
    manager.AddFile(it->string());
  }
  manager.Save();
}
 
}  // namespace
 
std::optional<EditorType> ParseEditorTypeFromString(absl::string_view name) {
  std::string normalized = std::string(name);
  absl::StripAsciiWhitespace(&normalized);
  const std::string lower = absl::AsciiStrToLower(normalized);
  for (int i = 0; i < static_cast<int>(kEditorTypeCount); ++i) {
    const auto type = static_cast<EditorType>(i);
    const std::string name_candidate =
        absl::AsciiStrToLower(EditorRegistry::GetEditorName(type));
    const std::string category_candidate =
        absl::AsciiStrToLower(EditorRegistry::GetEditorCategory(type));
    if (name_candidate == lower || category_candidate == lower) {
      return type;
    }
  }
  return std::nullopt;
}
 
// Static registry of editors that use the card-based layout system
// These editors register their cards with WorkspaceWindowManager and manage their
// own windows They do NOT need the traditional ImGui::Begin/End wrapper - they
// create cards internally
bool EditorManager::IsPanelBasedEditor(EditorType type) {
  return EditorRegistry::IsPanelBasedEditor(type);
}
 
void EditorManager::ResetWorkspaceLayout() {
  layout_coordinator_.ResetWorkspaceLayout();
}
 
void EditorManager::ApplyLayoutPreset(const std::string& preset_name) {
  layout_coordinator_.ApplyLayoutPreset(preset_name, GetCurrentSessionId());
}
 
bool EditorManager::ApplyLayoutProfile(const std::string& profile_id) {
  if (!layout_manager_) {
    return false;
  }
 
  const size_t session_id = GetCurrentSessionId();
  const EditorType current_type =
      current_editor_ ? current_editor_->type() : EditorType::kUnknown;
 
  LayoutProfile applied_profile;
  if (!layout_manager_->ApplyBuiltInProfile(profile_id, session_id,
                                            current_type, &applied_profile)) {
    return false;
  }
 
  if (applied_profile.open_agent_chat && right_drawer_manager_) {
    right_drawer_manager_->OpenDrawer(
        RightDrawerManager::DrawerType::kAgentChat);
    const float default_width = RightDrawerManager::GetDefaultDrawerWidth(
        RightDrawerManager::DrawerType::kAgentChat, current_type);
    right_drawer_manager_->SetDrawerWidth(
        RightDrawerManager::DrawerType::kAgentChat,
        std::max(default_width, 480.0f));
  }
 
  toast_manager_.Show(
      absl::StrFormat("Layout Profile: %s", applied_profile.label),
      ToastType::kSuccess);
  return true;
}
 
void EditorManager::CaptureTemporaryLayoutSnapshot() {
  if (!layout_manager_) {
    return;
  }
  layout_manager_->CaptureTemporarySessionLayout(GetCurrentSessionId());
  toast_manager_.Show("Captured temporary layout snapshot", ToastType::kInfo);
}
 
void EditorManager::RestoreTemporaryLayoutSnapshot(bool clear_after_restore) {
  if (!layout_manager_) {
    return;
  }
 
  if (layout_manager_->RestoreTemporarySessionLayout(GetCurrentSessionId(),
                                                     clear_after_restore)) {
    toast_manager_.Show("Restored temporary layout snapshot",
                        ToastType::kSuccess);
  } else {
    toast_manager_.Show("No temporary layout snapshot available",
                        ToastType::kWarning);
  }
}
 
void EditorManager::ClearTemporaryLayoutSnapshot() {
  if (!layout_manager_) {
    return;
  }
  layout_manager_->ClearTemporarySessionLayout();
  toast_manager_.Show("Cleared temporary layout snapshot", ToastType::kInfo);
}
 
bool EditorManager::SaveLayoutSnapshotAs(const std::string& name) {
  if (!layout_manager_)
    return false;
  if (name.empty()) {
    toast_manager_.Show("Snapshot name cannot be empty", ToastType::kWarning);
    return false;
  }
  const bool ok =
      layout_manager_->SaveNamedSnapshot(name, GetCurrentSessionId());
  if (ok) {
    toast_manager_.Show(absl::StrFormat("Saved snapshot '%s'", name),
                        ToastType::kSuccess);
  } else {
    toast_manager_.Show(absl::StrFormat("Failed to save snapshot '%s'", name),
                        ToastType::kError);
  }
  return ok;
}
 
bool EditorManager::RestoreLayoutSnapshot(const std::string& name,
                                          bool remove_after_restore) {
  if (!layout_manager_)
    return false;
  const bool ok = layout_manager_->RestoreNamedSnapshot(
      name, GetCurrentSessionId(), remove_after_restore);
  if (ok) {
    toast_manager_.Show(absl::StrFormat("Restored snapshot '%s'", name),
                        ToastType::kSuccess);
  } else {
    toast_manager_.Show(absl::StrFormat("Snapshot '%s' not available", name),
                        ToastType::kWarning);
  }
  return ok;
}
 
bool EditorManager::DeleteLayoutSnapshot(const std::string& name) {
  if (!layout_manager_)
    return false;
  const bool ok = layout_manager_->DeleteNamedSnapshot(name);
  if (ok) {
    toast_manager_.Show(absl::StrFormat("Deleted snapshot '%s'", name),
                        ToastType::kInfo);
  }
  return ok;
}
 
std::vector<std::string> EditorManager::ListLayoutSnapshots() const {
  if (!layout_manager_)
    return {};
  return layout_manager_->ListNamedSnapshots(GetCurrentSessionId());
}
 
void EditorManager::SyncLayoutScopeFromCurrentProject() {
  if (!layout_manager_) {
    return;
  }
 
  if (current_project_.project_opened()) {
    layout_manager_->SetProjectLayoutKey(
        current_project_.MakeStorageKey("layouts"));
  } else {
    layout_manager_->UseGlobalLayouts();
  }
}
 
bool EditorManager::HasPreviousEditorLayout() const {
  return current_editor_ &&
         layout_coordinator_.HasPreviousEditorLayout(current_editor_->type());
}
 
void EditorManager::RestorePreviousEditorLayout() {
  if (current_editor_) {
    layout_coordinator_.RestorePreviousEditorLayout(current_editor_->type());
  }
}
 
void EditorManager::ResetCurrentEditorLayout() {
  if (!current_editor_) {
    toast_manager_.Show("No active editor to reset", ToastType::kWarning);
    return;
  }
  // Choosing defaults ends automatic reapplication of a named layout. Keep
  // the named layout itself; the recovery snapshot also retains live docking.
  user_settings_.prefs().last_applied_layout_name.clear();
  settings_dirty_ = true;
  settings_dirty_timestamp_ = TimingManager::Get().GetElapsedTime();
  layout_coordinator_.ResetCurrentEditorLayout(current_editor_->type(),
                                               GetCurrentSessionId());
}
 
#ifdef YAZE_BUILD_AGENT_UI
void EditorManager::ShowAIAgent() {
  if (EditorRegistry::ShouldWarnAboutExperimentalEditor(
          EditorType::kAgent,
          user_settings_.prefs().show_experimental_editors)) {
    toast_manager_.Show(
        "AI Agent is experimental. It remains available; enable experimental "
        "features in Settings to acknowledge this warning.",
        ToastType::kWarning);
  }
  // Apply saved agent settings from the current project when opening the Agent
  // UI to respect the user's preferred provider/model.
  // TODO: Implement LoadAgentSettingsFromProject in AgentChat or AgentEditor
  agent_ui_->ShowAgent();
  window_manager_.SetActiveCategory("Agent");
  layout_coordinator_.InitializeEditorLayout(EditorType::kAgent);
  for (const auto& window_id :
       LayoutPresets::GetDefaultWindows(EditorType::kAgent)) {
    window_manager_.OpenWindow(window_id);
  }
}
 
void EditorManager::ShowChatHistory() {
  agent_ui_->ShowChatHistory();
}
 
AgentEditor* EditorManager::GetAgentEditor() {
  return agent_ui_->GetAgentEditor();
}
#endif
 
EditorManager::EditorManager()
    : agent_ui_(std::make_unique<AgentUiController>()),
      project_manager_(&toast_manager_),
      rom_file_manager_(&toast_manager_) {
  std::stringstream ss;
  ss << YAZE_VERSION_MAJOR << "." << YAZE_VERSION_MINOR << "."
     << YAZE_VERSION_PATCH;
  ss >> version_;
 
  // Initialize Core Context
  editor_context_ = std::make_unique<GlobalEditorContext>(event_bus_);
  ContentRegistry::Context::SetGlobalContext(editor_context_.get());
  status_bar_.Initialize(editor_context_.get());
 
  InitializeSubsystems();
  RegisterEditors();
  SubscribeToEvents();
 
  // STEP 5: ShortcutConfigurator created later in Initialize() method
  // It depends on all above coordinators being available
}
 
void EditorManager::InitializeSubsystems() {
  RefreshHackWorkflowBackend();
 
  // STEP 1: Initialize PopupManager FIRST
  popup_manager_ = std::make_unique<PopupManager>(this);
  popup_manager_->Initialize();  // Registers all popups with PopupID constants
 
  // STEP 2: Initialize SessionCoordinator (independent of popups)
  session_coordinator_ = std::make_unique<SessionCoordinator>(
      &window_manager_, &toast_manager_, &user_settings_);
  session_coordinator_->SetEditorRegistry(&editor_registry_);
 
  // STEP 3: Initialize MenuOrchestrator (depends on popup_manager_,
  // session_coordinator_)
  menu_orchestrator_ = std::make_unique<MenuOrchestrator>(
      this, menu_builder_, rom_file_manager_, project_manager_,
      editor_registry_, *session_coordinator_, toast_manager_, *popup_manager_);
 
  // Wire up the window manager for the View menu window listing
  menu_orchestrator_->SetWindowManager(&window_manager_);
  menu_orchestrator_->SetStatusBar(&status_bar_);
  menu_orchestrator_->SetUserSettings(&user_settings_);
  menu_orchestrator_->SetShortcutManager(&shortcut_manager_);
 
  session_coordinator_->SetEditorManager(this);
  session_coordinator_->SetBeforeSessionTransition(
      [this] { return RetireNativeSaveTransfer("rebound"); });
  session_coordinator_->SetEventBus(&event_bus_);  // Enable event publishing
  ContentRegistry::Context::SetEventBus(
      &event_bus_);  // Global event bus access
 
  // Expose UserSettings to cross-editor panels that don't get constructor
  // injection (e.g. Layout Designer, which reads named_layouts). The
  // LayoutManager setter happens below once the unique_ptr is constructed.
  ContentRegistry::Context::SetUserSettings(&user_settings_);
 
  // STEP 3.5: Initialize RomLifecycleManager (depends on popup_manager_,
  // session_coordinator_, rom_file_manager_, toast_manager_)
  rom_lifecycle_.Initialize({
      .rom_file_manager = &rom_file_manager_,
      .session_coordinator = session_coordinator_.get(),
      .toast_manager = &toast_manager_,
      .popup_manager = popup_manager_.get(),
      .project = &current_project_,
  });
 
  // STEP 4: Initialize UICoordinator (depends on popup_manager_,
  // session_coordinator_, window_manager_)
  ui_coordinator_ = std::make_unique<UICoordinator>(
      this, rom_file_manager_, project_manager_, editor_registry_,
      window_manager_, *session_coordinator_, window_delegate_, toast_manager_,
      *popup_manager_, shortcut_manager_);
 
  // STEP 4.5: Initialize LayoutManager (DockBuilder layouts for editors)
  layout_manager_ = std::make_unique<LayoutManager>();
  layout_manager_->SetWindowManager(&window_manager_);
  layout_manager_->UseGlobalLayouts();
  // Expose to cross-editor panels that drive the live dockspace (Layout
  // Designer). Must land after the unique_ptr is constructed.
  ContentRegistry::Context::SetLayoutManager(layout_manager_.get());
  workspace_manager_.set_layout_manager(layout_manager_.get());
  workspace_manager_.set_apply_preset_callback(
      [this](const std::string& preset_name) {
        ApplyLayoutPreset(preset_name);
      });
  window_delegate_.set_apply_preset_callback(
      [this](const std::string& preset_name) {
        ApplyLayoutPreset(preset_name);
      });
 
  // STEP 4.6: Initialize RightDrawerManager (right-side sliding drawers)
  right_drawer_manager_ = std::make_unique<RightDrawerManager>();
  right_drawer_manager_->SetToastManager(&toast_manager_);
  right_drawer_manager_->SetProposalDrawer(&proposal_drawer_);
  right_drawer_manager_->SetPropertiesPanel(&selection_properties_panel_);
  right_drawer_manager_->SetShortcutManager(&shortcut_manager_);
  right_drawer_manager_->SetSettingsPanelProvider([this]() -> SettingsPanel* {
    // The drawers button and the palette toggle open the Settings drawer
    // directly; on the Welcome screen there is no session yet. Create an
    // empty one, as SwitchToEditor does for ROM-less editors (BUG-020).
    if (session_coordinator_ && GetCurrentEditorSet() == nullptr) {
      session_coordinator_->CreateNewSession();
    }
    auto* editor_set = GetCurrentEditorSet();
    return editor_set ? editor_set->GetSettingsPanel() : nullptr;
  });
  selection_properties_panel_.SetAgentCallbacks(
      [this](const std::string& prompt) {
#if defined(YAZE_BUILD_AGENT_UI)
        auto* agent_editor = agent_ui_->GetAgentEditor();
        if (!agent_editor) {
          return;
        }
        auto* chat = agent_editor->GetAgentChat();
        if (!chat) {
          return;
        }
        chat->set_active(true);
        chat->SendMessage(prompt);
#else
        (void)prompt;
#endif
      },
      [this]() {
#if defined(YAZE_BUILD_AGENT_UI)
        if (right_drawer_manager_) {
          right_drawer_manager_->OpenDrawer(
              RightDrawerManager::DrawerType::kAgentChat);
        }
#endif
      });
  status_bar_.SetAgentToggleCallback([this]() {
    if (right_drawer_manager_) {
      right_drawer_manager_->ToggleDrawer(
          RightDrawerManager::DrawerType::kAgentChat);
    } else {
      agent_ui_->ShowAgent();
    }
  });
 
  // Initialize ProjectManagementPanel for project/version management
  project_management_panel_ = std::make_unique<ProjectManagementPanel>();
  project_management_panel_->SetToastManager(&toast_manager_);
  project_file_editor_.SetSaveGuardCallback(
      [this](const std::string& filepath, const std::string& contents) {
        return PrepareRawProjectFileSave(filepath, contents);
      });
  project_file_editor_.SetSaveCompleteCallback(
      [this](const std::string& filepath, const std::string& contents) {
        return CommitRawProjectFileSave(filepath, contents);
      });
  window_manager_.RegisterWindowContent(
      std::make_unique<workflow::ProjectWorkflowOutputPanel>());
  project_management_panel_->SetSwapRomCallback([this]() {
    // Prompt user to select a new ROM for the project
    auto rom_path = util::FileDialogWrapper::ShowOpenFileDialog(
        util::MakeRomFileDialogOptions(false));
    if (!rom_path.empty()) {
      auto status = SwapProjectRom(rom_path);
      if (status.ok()) {
        toast_manager_.Show("Project ROM updated and reloaded.",
                            ToastType::kSuccess);
      } else {
        toast_manager_.Show(absl::StrFormat("Failed to update project ROM: %s",
                                            status.message()),
                            ToastType::kError);
      }
    }
  });
  project_management_panel_->SetReloadRomCallback([this]() {
    if (current_project_.project_opened() &&
        !current_project_.rom_filename.empty()) {
      auto status = ReloadProjectRom();
      if (!status.ok()) {
        toast_manager_.Show(
            absl::StrFormat("Failed to reload ROM: %s", status.message()),
            ToastType::kError);
      }
    }
  });
  project_management_panel_->SetSaveProjectCallback([this]() {
    auto status = SaveProject();
    if (status.ok()) {
      toast_manager_.Show("Project saved", ToastType::kSuccess);
    } else {
      toast_manager_.Show(
          absl::StrFormat("Failed to save project: %s", status.message()),
          ToastType::kError);
    }
    return status;
  });
  project_management_panel_->SetBrowseFolderCallback(
      [this](const std::string& type) {
        auto folder_path = util::FileDialogWrapper::ShowOpenFolderDialog();
        if (!folder_path.empty()) {
          if (type == "code") {
            current_project_.code_folder = folder_path;
            // Update assembly editor path
            if (auto* editor_set = GetCurrentEditorSet()) {
// iOS: avoid blocking folder enumeration on the UI thread.
#if !(defined(__APPLE__) && TARGET_OS_IOS == 1)
              editor_set->OpenAssemblyFolder(folder_path);
#endif
              window_manager_.SetFileBrowserPath("Assembly", folder_path);
            }
          } else if (type == "assets") {
            current_project_.assets_folder = folder_path;
          }
          MarkCurrentProjectDirty();
          if (project_management_panel_) {
            project_management_panel_->SetProject(&current_project_, true);
          }
          toast_manager_.Show(absl::StrFormat("%s folder set: %s", type.c_str(),
                                              folder_path.c_str()),
                              ToastType::kSuccess);
        }
      });
  project_management_panel_->SetBuildProjectCallback(
      [this]() { QueueBuildCurrentProject(); });
  project_management_panel_->SetCancelBuildCallback(
      [this]() { CancelQueuedProjectBuild(); });
  project_management_panel_->SetRunProjectCallback(
      [this]() { (void)RunCurrentProject(); });
  ContentRegistry::Context::SetStartBuildWorkflowCallback(
      [this]() { QueueBuildCurrentProject(); });
  ContentRegistry::Context::SetRunProjectWorkflowCallback(
      [this]() { (void)RunCurrentProject(); });
  ContentRegistry::Context::SetShowWorkflowOutputCallback([this]() {
    window_manager_.OpenWindow("workflow.output");
    window_manager_.MarkWindowRecentlyUsed("workflow.output");
  });
  ContentRegistry::Context::SetCancelBuildWorkflowCallback(
      [this]() { CancelQueuedProjectBuild(); });
  right_drawer_manager_->SetProjectManagementPanel(
      project_management_panel_.get());
 
  // STEP 4.6.1: Initialize LayoutCoordinator (facade for layout operations)
  LayoutCoordinator::Dependencies layout_deps;
  layout_deps.layout_manager = layout_manager_.get();
  layout_deps.window_manager = &window_manager_;
  layout_deps.ui_coordinator = ui_coordinator_.get();
  layout_deps.toast_manager = &toast_manager_;
  layout_deps.status_bar = &status_bar_;
  layout_deps.right_drawer_manager = right_drawer_manager_.get();
  layout_coordinator_.Initialize(layout_deps);
 
  // STEP 4.6.2: Initialize EditorActivator (editor switching and jump navigation)
  EditorActivator::Dependencies activator_deps;
  activator_deps.window_manager = &window_manager_;
  activator_deps.layout_manager = layout_manager_.get();
  activator_deps.ui_coordinator = ui_coordinator_.get();
  activator_deps.right_drawer_manager = right_drawer_manager_.get();
  activator_deps.toast_manager = &toast_manager_;
  activator_deps.event_bus = &event_bus_;
  activator_deps.ensure_editor_assets_loaded = [this](EditorType type) {
    return EnsureEditorAssetsLoaded(type);
  };
  activator_deps.get_current_editor_set = [this]() {
    return GetCurrentEditorSet();
  };
  activator_deps.get_current_session_id = [this]() {
    return GetCurrentSessionId();
  };
  activator_deps.queue_deferred_action = [this](std::function<void()> action) {
    QueueDeferredAction(std::move(action));
  };
  editor_activator_.Initialize(activator_deps);
 
  // STEP 4.7: Initialize ActivityBar
  activity_bar_ = std::make_unique<ActivityBar>(
      window_manager_,
      [this]() -> bool {
        if (auto* editor_set = GetCurrentEditorSet()) {
          if (auto* dungeon_editor = editor_set->GetEditorAs<DungeonEditorV2>(
                  EditorType::kDungeon)) {
            return dungeon_editor->IsWorkbenchWorkflowEnabled();
          }
        }
        return false;
      },
      [this](bool enabled) {
        if (auto* editor_set = GetCurrentEditorSet()) {
          if (auto* dungeon_editor = editor_set->GetEditorAs<DungeonEditorV2>(
                  EditorType::kDungeon)) {
            dungeon_editor->QueueWorkbenchWorkflowMode(enabled);
          }
        }
      },
      [this](const std::string& category) {
        return GetEditorContextSnapshot(category);
      });
 
  // Wire per-user sidebar prefs so right-click / drag mutate persisted state.
  activity_bar_->SetUserSettings(&user_settings_);
 
  // Populate the MoreActions registry with the default rail entries. External
  // callers can Register/Unregister further entries at runtime.
  auto& registry = activity_bar_->actions_registry();
  registry.Register({"command_palette",
                     "Command Palette",
                     ICON_MD_TERMINAL,
                     [this]() { window_manager_.TriggerShowCommandPalette(); },
                     {}});
  registry.Register({"keyboard_shortcuts",
                     "Keyboard Shortcuts",
                     ICON_MD_KEYBOARD,
                     [this]() { window_manager_.TriggerShowShortcuts(); },
                     {}});
  registry.Register({"open_rom_project",
                     "Open ROM / Project",
                     ICON_MD_FOLDER_OPEN,
                     [this]() { window_manager_.TriggerOpenRom(); },
                     {}});
  registry.Register({"settings",
                     "Settings",
                     ICON_MD_SETTINGS,
                     [this]() { window_manager_.TriggerShowSettings(); },
                     {}});
 
  // WindowHost is the declarative window registration surface used by
  // editor/runtime systems.
  window_host_ = std::make_unique<WindowHost>(&window_manager_);
 
  // Wire up EventBus to WorkspaceWindowManager for action event publishing
  window_manager_.SetEventBus(&event_bus_);
}
 
void EditorManager::RegisterEditors() {
  // Auto-register panels from ContentRegistry (Unified Panel System)
  auto registry_panels = ContentRegistry::Panels::CreateAll();
  for (auto& panel : registry_panels) {
    window_manager_.RegisterRegistryWindowContent(std::move(panel));
  }
 
  // STEP 4.8: Initialize DashboardPanel
  dashboard_panel_ = std::make_unique<DashboardPanel>(this);
 
  if (window_host_) {
    WindowDefinition dashboard_definition;
    dashboard_definition.id = "dashboard.main";
    dashboard_definition.display_name = "Dashboard";
    dashboard_definition.icon = ICON_MD_DASHBOARD;
    dashboard_definition.category = "Dashboard";
    dashboard_definition.window_title = " Dashboard";
    dashboard_definition.shortcut_hint = "Ctrl+E";
    dashboard_definition.priority = 0;
    dashboard_definition.visibility_flag = dashboard_panel_->visibility_flag();
    dashboard_definition.presentation =
        WindowPresentationPolicy::CoreWorkspace();
    window_host_->RegisterWindow(dashboard_definition);
  } else {
    window_manager_.RegisterWindow(
        {.card_id = "dashboard.main",
         .display_name = "Dashboard",
         .window_title = " Dashboard",
         .icon = ICON_MD_DASHBOARD,
         .category = "Dashboard",
         .presentation = WindowPresentationPolicy::CoreWorkspace(),
         .shortcut_hint = "Ctrl+E",
         .visibility_flag = dashboard_panel_->visibility_flag(),
         .priority = 0});
  }
}
 
void EditorManager::SubscribeToEvents() {
  // Subscribe to session lifecycle events via EventBus
  // (replaces SessionObserver pattern)
  event_bus_.Subscribe<SessionSwitchedEvent>(
      [this](const SessionSwitchedEvent& e) {
        HandleSessionSwitched(e.new_index, e.session, e.transient);
      });
 
  event_bus_.Subscribe<SessionCreatedEvent>(
      [this](const SessionCreatedEvent& e) {
        HandleSessionCreated(e.index, e.session);
      });
 
  event_bus_.Subscribe<SessionClosedEvent>(
      [this](const SessionClosedEvent& e) { HandleSessionClosed(e.index); });
 
  event_bus_.Subscribe<RomLoadedEvent>([this](const RomLoadedEvent& e) {
    HandleSessionRomLoaded(e.session_id, e.rom);
  });
 
  // Subscribe to FrameGuiBeginEvent for ImGui-safe deferred action processing
  // This replaces scattered manual processing calls with event-driven execution
  event_bus_.Subscribe<FrameGuiBeginEvent>([this](const FrameGuiBeginEvent&) {
    ui_sync_frame_id_.fetch_add(1, std::memory_order_relaxed);
 
    // Process LayoutCoordinator's deferred actions
    layout_coordinator_.ProcessDeferredActions();
 
    // Process EditorManager's deferred actions
    if (!deferred_actions_.empty()) {
      std::vector<std::function<void()>> actions_to_execute;
      actions_to_execute.swap(deferred_actions_);
      const int processed_count = static_cast<int>(actions_to_execute.size());
      for (auto& action : actions_to_execute) {
        action();
      }
      if (processed_count > 0) {
        const int remaining = pending_editor_deferred_actions_.fetch_sub(
                                  processed_count, std::memory_order_relaxed) -
                              processed_count;
        if (remaining < 0) {
          pending_editor_deferred_actions_.store(0, std::memory_order_relaxed);
        }
      }
    }
  });
 
  // Subscribe to UIActionRequestEvent for activity bar actions
  // This replaces direct callbacks from WorkspaceWindowManager
  event_bus_.Subscribe<UIActionRequestEvent>(
      [this](const UIActionRequestEvent& e) {
        HandleUIActionRequest(e.action);
      });
 
  event_bus_.Subscribe<PanelVisibilityChangedEvent>(
      [this](const PanelVisibilityChangedEvent& e) {
        if (e.category.empty() ||
            e.category == WorkspaceWindowManager::kDashboardCategory) {
          return;
        }
        if (IsTransientPanelVisibilityId(e.base_panel_id)) {
          return;
        }
        if (e.visible && layout_manager_) {
          layout_manager_->DockPresetPositionOnPanelOpen(e.session_id,
                                                         e.base_panel_id);
        }
        auto& prefs = user_settings_.prefs();
        prefs.panel_visibility_state[e.category][e.base_panel_id] = e.visible;
        settings_dirty_ = true;
        settings_dirty_timestamp_ = TimingManager::Get().GetElapsedTime();
      });
}
 
EditorManager::~EditorManager() {
  // ContentRegistry::Context holds non-owning pointers into our members
  // (event_bus_, editor_context_, user_settings_, layout_manager_, callbacks).
  // Clear them before our members destruct so widgets that read the singleton
  // (e.g. Canvas::set_global_scale via Context::event_bus()) don't see
  // dangling pointers in tests that instantiate multiple EditorManagers.
  // Clear() resets fallback state but intentionally keeps global_context for
  // session-close semantics, so null it explicitly here.
  ContentRegistry::Context::Clear();
  ContentRegistry::Context::SetGlobalContext(nullptr);
 
  // GetResourceLabels() is a process-wide singleton. RefreshResourceLabelProvider
  // hands it a pointer to current_project_.hack_manifest, which dangles after
  // we destruct. Clear before our members go out of scope.
  zelda3::GetResourceLabels().SetHackManifest(nullptr);
  zelda3::GetResourceLabels().SetProjectLabels(nullptr);
 
  // ThemeManager is a singleton that outlives us. Clear the theme-changed
  // callback so it stops calling back into a destroyed EditorManager via the
  // captured `this` pointer. Matters for unit tests that construct and destroy
  // multiple EditorManager instances in the same process.
  gui::ThemeManager::Get().SetOnThemeChangedCallback(nullptr);
  i18n::LanguageManager::Get().SetOnLanguageChangedCallback(nullptr);
 
  // EventBus subscriptions are automatically cleaned up when event_bus_ is
  // destroyed (owned by this class). No manual unsubscription needed.
}
 
// ============================================================================
// Session Event Handlers (EventBus subscribers)
// ============================================================================
 
void EditorManager::RefreshResourceLabelProvider() {
  auto& provider = zelda3::GetResourceLabels();
  static zelda3::ResourceLabelProvider::ProjectLabels empty_labels;
  static zelda3::ResourceLabelProvider::ProjectLabels merged_labels;
 
  auto merge_labels =
      [](zelda3::ResourceLabelProvider::ProjectLabels* dst,
         const zelda3::ResourceLabelProvider::ProjectLabels& src) {
        for (const auto& [type, labels] : src) {
          auto& out = (*dst)[type];
          for (const auto& [key, value] : labels) {
            out[key] = value;
          }
        }
      };
 
  merged_labels.clear();
  std::vector<std::string> source_parts;
 
  // 1) ROM-local labels as baseline for active session.
  if (auto* rom = GetCurrentRom();
      rom && rom->resource_label() && !rom->resource_label()->labels_.empty()) {
    merge_labels(&merged_labels, rom->resource_label()->labels_);
    source_parts.push_back("rom");
  }
 
  // 2) Project registry labels from the active hack manifest.
  if (current_project_.project_opened() &&
      current_project_.hack_manifest.loaded() &&
      current_project_.hack_manifest.HasProjectRegistry()) {
    merge_labels(
        &merged_labels,
        current_project_.hack_manifest.project_registry().all_resource_labels);
    source_parts.push_back("registry");
  }
 
  // 3) Explicit project labels override all other sources.
  if (current_project_.project_opened() &&
      !current_project_.resource_labels.empty()) {
    merge_labels(&merged_labels, current_project_.resource_labels);
    source_parts.push_back("project");
  }
 
  auto* label_source = merged_labels.empty() ? &empty_labels : &merged_labels;
  std::string source =
      source_parts.empty() ? "empty" : absl::StrJoin(source_parts, "+");
 
  provider.SetProjectLabels(label_source);
  provider.SetHackManifest(current_project_.project_opened() &&
                                   current_project_.hack_manifest.loaded()
                               ? &current_project_.hack_manifest
                               : nullptr);
 
  const bool prefer_hmagic =
      current_project_.project_opened()
          ? current_project_.workspace_settings.prefer_hmagic_names
          : user_settings_.prefs().prefer_hmagic_sprite_names;
  provider.SetPreferHMagicNames(prefer_hmagic);
 
  LOG_DEBUG("EditorManager",
            "ResourceLabelProvider refreshed (source=%s, project_open=%s)",
            source.c_str(),
            current_project_.project_opened() ? "true" : "false");
}
 
void EditorManager::CaptureRuntimeFeatureFlags() {
  if (!runtime_feature_flags_session_id_.has_value() || !session_coordinator_) {
    return;
  }
 
  const auto index =
      ResolveSessionIndexById(*runtime_feature_flags_session_id_);
  if (!index.has_value()) {
    runtime_feature_flags_session_id_.reset();
    return;
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(*index));
  if (!session) {
    runtime_feature_flags_session_id_.reset();
    return;
  }
 
  session->feature_flags = core::FeatureFlags::get();
  if (session->project_context.has_value()) {
    session->project_context->feature_flags = session->feature_flags;
  }
  if (active_project_context_session_id_ == runtime_feature_flags_session_id_) {
    current_project_.feature_flags = session->feature_flags;
  }
}
 
void EditorManager::CaptureActiveProjectContext() {
  if (!active_project_context_session_id_.has_value() ||
      !session_coordinator_) {
    return;
  }
 
  CaptureActiveProjectEditingState();
  CaptureRuntimeFeatureFlags();
  const auto index =
      ResolveSessionIndexById(*active_project_context_session_id_);
  if (!index.has_value()) {
    active_project_context_session_id_.reset();
    return;
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(*index));
  if (!session) {
    active_project_context_session_id_.reset();
    return;
  }
 
  // The singleton can temporarily belong to another session while all editor
  // windows are ticked. Only use that value when it still belongs to this
  // project owner; otherwise its session-owned copy is authoritative.
  if (runtime_feature_flags_session_id_ == active_project_context_session_id_) {
    session->feature_flags = core::FeatureFlags::get();
  }
  // These preferences are exposed through global runtime settings, but they
  // are project workspace state. Capture them before leaving the session so a
  // later SaveProject cannot copy another session's values into this project.
  current_project_.workspace_settings.font_global_scale =
      user_settings_.prefs().font_global_scale;
  current_project_.workspace_settings.autosave_enabled =
      user_settings_.prefs().autosave_enabled;
  current_project_.workspace_settings.autosave_interval_secs =
      user_settings_.prefs().autosave_interval;
  current_project_.workspace_settings.backup_on_save =
      user_settings_.prefs().backup_before_save;
  current_project_.feature_flags = session->feature_flags;
  BindProjectContextToSession(session, current_project_);
}
 
void EditorManager::CaptureActiveProjectEditingState() {
  if (!active_project_context_session_id_.has_value() ||
      !session_coordinator_) {
    return;
  }
 
  const auto index =
      ResolveSessionIndexById(*active_project_context_session_id_);
  if (!index.has_value()) {
    return;
  }
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(*index));
  if (!session) {
    return;
  }
 
  if (project_management_panel_) {
    session->project_dirty = project_management_panel_->IsProjectDirty();
  }
  session->project_file_editor_state = project_file_editor_.CaptureState();
}
 
absl::Status EditorManager::PrepareActiveProjectEditorDraftsForSave(
    bool publish_lyra) {
  if (!session_coordinator_) {
    return absl::OkStatus();
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (session == nullptr || !session->editors.HasPendingProjectDraftChanges()) {
    return absl::OkStatus();
  }
  if (!IsCurrentProjectContextOwnedBySession(session->session_id())) {
    return absl::FailedPreconditionError(
        "Project editor drafts require their project context to be active");
  }
  return session->editors.PrepareProjectSave(publish_lyra);
}
 
void EditorManager::DetachActiveProjectContext() {
  CaptureActiveProjectContext();
  active_project_context_session_id_.reset();
  runtime_feature_flags_session_id_.reset();
  version_manager_ = nullptr;
  if (project_management_panel_) {
    project_management_panel_->SetVersionManager(nullptr);
  }
}
 
void EditorManager::RestoreProjectContextAfterFailedOpen(
    std::optional<size_t> previous_session_id) {
  pending_project_open_transition_ = false;
  pending_project_open_previous_session_id_.reset();
  if (previous_session_id.has_value() && session_coordinator_) {
    const auto index = ResolveSessionIndexById(*previous_session_id);
    if (index.has_value()) {
      auto* previous_session =
          static_cast<RomSession*>(session_coordinator_->GetSession(*index));
      if (previous_session) {
        if (session_coordinator_->GetActiveSessionIndex() != *index) {
          session_coordinator_->SwitchToSession(*index);
        } else {
          RestoreProjectContextForSession(previous_session);
        }
        return;
      }
    }
  }
 
  current_project_ = project::YazeProject();
  active_project_context_session_id_.reset();
  runtime_feature_flags_session_id_.reset();
  version_manager_ = nullptr;
  ApplyCurrentProjectRuntimeContext();
  project_file_editor_.ResetForProject(&current_project_);
}
 
absl::Status EditorManager::DiscardProvisionalSessionCreatedSince(
    size_t previous_session_count) {
  if (!session_coordinator_ ||
      session_coordinator_->GetTotalSessionCount() <= previous_session_count) {
    return absl::OkStatus();
  }
  auto* provisional_session = session_coordinator_->GetActiveRomSession();
  if (!provisional_session) {
    return absl::InternalError(
        "A provisional session was created but is not active");
  }
  return session_coordinator_->DiscardProvisionalSession(
      provisional_session->session_id());
}
 
bool EditorManager::ProjectFileDraftTargetsCurrentProject() const {
  if (current_project_.filepath.empty() ||
      project_file_editor_.filepath().empty()) {
    return false;
  }
  return SessionCoordinator::PathsReferToSameBackingFile(
      project_file_editor_.filepath(), current_project_.filepath);
}
 
absl::Status EditorManager::PrepareRawProjectFileSave(
    const std::string& filepath, const std::string& contents) {
  CaptureActiveProjectEditingState();
  const bool targets_current = !current_project_.filepath.empty() &&
                               SessionCoordinator::PathsReferToSameBackingFile(
                                   filepath, current_project_.filepath);
  if (!targets_current) {
    // Save As to a separate descriptor is the deterministic escape hatch when
    // both the structured panel and raw document have edits.
    return absl::OkStatus();
  }
  if (IsCurrentProjectDirty()) {
    return absl::FailedPreconditionError(
        "Project settings also have unsaved changes; use raw Save As to "
        "preserve this draft, then save the project settings");
  }
 
  auto* session = session_coordinator_
                      ? session_coordinator_->GetActiveRomSession()
                      : nullptr;
  if (!session || !session->rom.is_loaded()) {
    return absl::FailedPreconditionError(
        "No active ROM session for this project file");
  }
 
  project::YazeProject parsed_project;
  RETURN_IF_ERROR(parsed_project.LoadFromString(contents, filepath));
  if (!parsed_project.project_opened()) {
    return absl::InvalidArgumentError(
        "Raw project file must contain a non-empty project name");
  }
  if (parsed_project.rom_filename.empty() ||
      !(SessionCoordinator::PathsReferToSameBackingFile(
            parsed_project.rom_filename, session->filepath) ||
        SessionCoordinator::PathsReferToSameBackingFile(
            parsed_project.rom_filename, session->rom.filename()))) {
    return absl::FailedPreconditionError(
        "Raw project file cannot change the ROM backing file of a loaded "
        "session; use Project Management > Swap ROM");
  }
  return session_coordinator_->CheckBackingFileAvailable(
      parsed_project.rom_filename, session->session_id());
}
 
absl::Status EditorManager::CommitRawProjectFileSave(
    const std::string& filepath, const std::string& contents) {
  if (current_project_.filepath.empty() ||
      !SessionCoordinator::PathsReferToSameBackingFile(
          filepath, current_project_.filepath)) {
    return absl::OkStatus();
  }
 
  auto* session = session_coordinator_
                      ? session_coordinator_->GetActiveRomSession()
                      : nullptr;
  if (!session) {
    return absl::FailedPreconditionError("No active ROM session");
  }
 
  project::YazeProject parsed_project;
  RETURN_IF_ERROR(parsed_project.LoadFromString(contents, filepath));
  current_project_ = std::move(parsed_project);
  BindProjectContextToSession(session, current_project_);
  session->project_dirty = false;
  active_project_context_session_id_ = session->session_id();
  runtime_feature_flags_session_id_ = session->session_id();
  version_manager_ = session->version_manager.get();
  ApplyCurrentProjectRuntimeContext();
  if (project_management_panel_) {
    project_management_panel_->SetProject(&current_project_, false);
  }
  return absl::OkStatus();
}
 
void EditorManager::RebaseCleanProjectFileDraft(const std::string& filepath) {
  if (!session_coordinator_ || filepath.empty()) {
    return;
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (!session || !session->project_file_editor_state.initialized ||
      session->project_file_editor_state.modified) {
    return;
  }
 
  const bool was_active = project_file_editor_.is_active();
  auto status = project_file_editor_.LoadFile(filepath);
  if (!status.ok()) {
    LOG_WARN("EditorManager", "Failed to rebase raw project editor: %s",
             status.message());
    return;
  }
  project_file_editor_.SetProject(&current_project_);
  project_file_editor_.set_active(was_active);
  session->project_file_editor_state = project_file_editor_.CaptureState();
}
 
absl::StatusOr<const project::YazeProject*>
EditorManager::PrepareActiveProjectContextForSave() {
  if (!session_coordinator_) {
    return absl::FailedPreconditionError("No session coordinator");
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (!session || !session->rom.is_loaded()) {
    return absl::FailedPreconditionError("No active ROM session");
  }
 
  CaptureRuntimeFeatureFlags();
  if (!active_project_context_session_id_.has_value() ||
      *active_project_context_session_id_ != session->session_id()) {
    return absl::FailedPreconditionError(
        "Active ROM session project context is not restored");
  }
  CaptureActiveProjectContext();
  if (!session->project_context.has_value()) {
    return absl::FailedPreconditionError(
        "Active ROM session has no project/save context");
  }
  return &*session->project_context;
}
 
void EditorManager::HandleUIActionRequest(UIActionRequestEvent::Action action) {
  using Action = UIActionRequestEvent::Action;
  switch (action) {
    case Action::kShowEmulator:
      if (ui_coordinator_) {
        ui_coordinator_->SetEmulatorVisible(true);
      }
      break;
 
    case Action::kShowSettings:
      // Toggle Settings panel in sidebar
      if (right_drawer_manager_) {
        right_drawer_manager_->ToggleDrawer(
            RightDrawerManager::DrawerType::kSettings);
      } else {
        SwitchToEditor(EditorType::kSettings);
      }
      break;
 
    case Action::kShowPanelBrowser:
      if (ui_coordinator_) {
        ui_coordinator_->ShowWindowBrowser();
      }
      break;
 
    case Action::kShowSearch:
      if (ui_coordinator_) {
        ui_coordinator_->ShowGlobalSearch();
      }
      break;
 
    case Action::kShowShortcuts:
      if (ui_coordinator_) {
        ui_coordinator_->ShowShortcutsBrowser();
      }
      break;
 
    case Action::kShowCommandPalette:
      if (ui_coordinator_) {
        ui_coordinator_->ShowCommandPalette();
      }
      break;
 
    case Action::kShowHelp:
      if (right_drawer_manager_) {
        // Toggle Help panel in sidebar
        right_drawer_manager_->ToggleDrawer(
            RightDrawerManager::DrawerType::kHelp);
      } else if (popup_manager_) {
        // Fallback to "About" dialog if sidebar not available
        popup_manager_->Show(PopupID::kAbout);
      }
      break;
 
    case Action::kShowAgentChatSidebar:
      if (right_drawer_manager_) {
        right_drawer_manager_->OpenDrawer(
            RightDrawerManager::DrawerType::kAgentChat);
      } else {
        SwitchToEditor(EditorType::kAgent);
      }
      break;
 
    case Action::kShowAgentProposalsSidebar:
      if (right_drawer_manager_) {
        right_drawer_manager_->OpenDrawer(
            RightDrawerManager::DrawerType::kProposals);
      }
      break;
 
    case Action::kOpenRom: {
      auto status = LoadRom();
      if (!status.ok()) {
        toast_manager_.Show(
            std::string("Open failed: ") + std::string(status.message()),
            ToastType::kError);
      }
    } break;
 
    case Action::kSaveRom:
      if (GetCurrentRom() && GetCurrentRom()->is_loaded()) {
        auto status = SaveRom();
        if (!absl::IsCancelled(status) && !status.ok()) {
          toast_manager_.Show(
              std::string("Save failed: ") + std::string(status.message()),
              ToastType::kError);
        }
      }
      break;
 
    case Action::kUndo:
      if (auto* current_editor = GetCurrentEditor()) {
        auto status = current_editor->Undo();
        if (!status.ok()) {
          toast_manager_.Show(
              std::string("Undo failed: ") + std::string(status.message()),
              ToastType::kError);
        }
      }
      break;
 
    case Action::kRedo:
      if (auto* current_editor = GetCurrentEditor()) {
        auto status = current_editor->Redo();
        if (!status.ok()) {
          toast_manager_.Show(
              std::string("Redo failed: ") + std::string(status.message()),
              ToastType::kError);
        }
      }
      break;
 
    case Action::kResetLayout:
      ResetWorkspaceLayout();
      break;
  }
}
 
void EditorManager::InitializeTestSuites() {
  auto& test_manager = test::TestManager::Get();
 
#ifdef YAZE_ENABLE_TESTING
  // Register comprehensive test suites
  test_manager.RegisterTestSuite(
      std::make_unique<test::CoreSystemsTestSuite>());
  test_manager.RegisterTestSuite(std::make_unique<test::IntegratedTestSuite>());
  test_manager.RegisterTestSuite(
      std::make_unique<test::PerformanceTestSuite>());
  test_manager.RegisterTestSuite(std::make_unique<test::UITestSuite>());
  test_manager.RegisterTestSuite(
      std::make_unique<test::RomDependentTestSuite>());
 
  // Register new E2E and ZSCustomOverworld test suites
  test_manager.RegisterTestSuite(std::make_unique<test::E2ETestSuite>());
  test_manager.RegisterTestSuite(
      std::make_unique<test::ZSCustomOverworldTestSuite>());
#endif
 
  // Register Google Test suite if available
#ifdef YAZE_ENABLE_GTEST
  test_manager.RegisterTestSuite(std::make_unique<test::UnitTestSuite>());
#endif
 
  // Register z3ed AI Agent test suites (requires gRPC)
#ifdef YAZE_WITH_GRPC
  test::RegisterZ3edTestSuites();
#endif
 
  // Update resource monitoring to track Arena state
  test_manager.UpdateResourceStats();
}
 
void EditorManager::Initialize(gfx::IRenderer* renderer,
                               const std::string& filename) {
  renderer_ = renderer;
  RegisterDefaultEditorFactories(&editor_registry_);
  SeedOracleProjectInRecents();
 
  // Inject the window manager into emulator and workspace_manager
  emulator_.set_window_manager(&window_manager_);
  workspace_manager_.set_window_manager(&window_manager_);
 
  // Point to a blank editor set when no ROM is loaded
  // current_editor_set_ = &blank_editor_set_;
 
  // Note: PopupManager is now initialized in constructor before
  // MenuOrchestrator This ensures all menu callbacks can safely call
  // popup_manager_.Show()
 
  RegisterEmulatorPanels();
  InitializeServices();
  SetupComponentCallbacks();
 
  // Apply sidebar state from settings AFTER registering callbacks
  // This triggers the callbacks but they should be safe now
  window_manager_.SetSidebarVisible(user_settings_.prefs().sidebar_visible,
                                    /*notify=*/false);
  window_manager_.SetSidebarExpanded(
      user_settings_.prefs().sidebar_panel_expanded,
      /*notify=*/false);
  window_manager_.SetStoredSidePanelWidth(
      user_settings_.prefs().sidebar_panel_width, /*notify=*/false);
  window_manager_.SetWindowBrowserCategoryWidth(
      user_settings_.prefs().panel_browser_category_width,
      /*notify=*/false);
  {
    const bool prefer_dashboard_only =
        dashboard_mode_override_ == StartupVisibility::kShow &&
        startup_editor_hint_.empty() && startup_panel_hints_.empty();
    if (!prefer_dashboard_only) {
      const std::string category = GetPreferredStartupCategory(
          user_settings_.prefs().sidebar_active_category, {});
      if (!category.empty()) {
        window_manager_.SetActiveCategory(category, /*notify=*/false);
        SyncEditorContextForCategory(category);
        auto it = user_settings_.prefs().panel_visibility_state.find(category);
        if (it != user_settings_.prefs().panel_visibility_state.end()) {
          window_manager_.RestoreVisibilityState(
              window_manager_.GetActiveSessionId(), it->second);
        }
      }
    }
  }
 
  if (pending_layout_defaults_reset_) {
    ResetWorkspaceLayout();
    pending_layout_defaults_reset_ = false;
  }
 
  // Initialize testing system only when tests are enabled
#ifdef YAZE_ENABLE_TESTING
  InitializeTestSuites();
#endif
 
  // TestManager will be updated when ROMs are loaded via SetCurrentRom calls
 
  InitializeShortcutSystem();
 
  // Open a startup ROM last. The post-load surface reads Settings (Default
  // Editor), which InitializeServices() loads; opening earlier used the
  // built-in defaults and always showed the editor picker.
  if (!filename.empty()) {
    // The post-load surface must see --startup_dashboard/--welcome (saved by
    // SetStartupLoadHints) and Settings > Test mode now; Application applies
    // them only after this returns.
    if (user_settings_.prefs().test_mode) {
      if (welcome_mode_override_ == StartupVisibility::kAuto) {
        welcome_mode_override_ = StartupVisibility::kHide;
      }
      if (dashboard_mode_override_ == StartupVisibility::kAuto) {
        dashboard_mode_override_ = StartupVisibility::kHide;
      }
    }
    ApplyStartupVisibilityOverrides();
    // Scripts and test launches pass --rom_file; they must not wait on the
    // load options dialog.
    PRINT_IF_ERROR(OpenRomOrProject(filename, LoadOptionsPrompt::kNoPrompt));
  }
}
 
void EditorManager::RegisterEmulatorPanels() {
  // Register emulator panels early (emulator Initialize might not be called).
  const std::vector<WindowDefinition> panel_definitions = {
      {.id = "emulator.cpu_debugger",
       .display_name = "CPU Debugger",
       .icon = ICON_MD_BUG_REPORT,
       .category = "Emulator",
       .priority = 10,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.ppu_viewer",
       .display_name = "PPU Viewer",
       .icon = ICON_MD_VIDEOGAME_ASSET,
       .category = "Emulator",
       .priority = 20,
       .presentation = WindowPresentationPolicy::CoreWorkspace()},
      {.id = "emulator.memory_viewer",
       .display_name = "Memory Viewer",
       .icon = ICON_MD_MEMORY,
       .category = "Emulator",
       .priority = 30,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.breakpoints",
       .display_name = "Breakpoints",
       .icon = ICON_MD_STOP,
       .category = "Emulator",
       .priority = 40,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.performance",
       .display_name = "Performance",
       .icon = ICON_MD_SPEED,
       .category = "Emulator",
       .priority = 50,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.ai_agent",
       .display_name = "AI Agent",
       .icon = ICON_MD_SMART_TOY,
       .category = "Emulator",
       .priority = 60,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.save_states",
       .display_name = "Save States",
       .icon = ICON_MD_SAVE,
       .category = "Emulator",
       .priority = 70,
       .presentation = WindowPresentationPolicy::Diagnostic().WithHost(
           "Command palette (placeholder: Coming Soon)")},
      {.id = "emulator.keyboard_config",
       .display_name = "Keyboard Config",
       .icon = ICON_MD_KEYBOARD,
       .category = "Emulator",
       .priority = 80,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.virtual_controller",
       .display_name = "Virtual Controller",
       .icon = ICON_MD_SPORTS_ESPORTS,
       .category = "Emulator",
       .priority = 85,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.apu_debugger",
       .display_name = "APU Debugger",
       .icon = ICON_MD_AUDIOTRACK,
       .category = "Emulator",
       .priority = 90,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "emulator.audio_mixer",
       .display_name = "Audio Mixer",
       .icon = ICON_MD_AUDIO_FILE,
       .category = "Emulator",
       .priority = 100,
       .presentation = WindowPresentationPolicy::OptionalPopOut()},
      {.id = "memory.hex_editor",
       .display_name = "Hex Editor",
       .icon = ICON_MD_MEMORY,
       .category = "Memory",
       .window_title = ICON_MD_MEMORY " Hex Editor",
       .priority = 10,
       .presentation = WindowPresentationPolicy::CoreWorkspace(),
       .legacy_ids = {"Memory Editor"}},
  };
 
  if (window_host_) {
    window_host_->RegisterPanels(panel_definitions);
    return;
  }
 
  for (const auto& definition : panel_definitions) {
    WindowDescriptor descriptor;
    descriptor.card_id = definition.id;
    descriptor.display_name = definition.display_name;
    descriptor.window_title = definition.window_title;
    descriptor.icon = definition.icon;
    descriptor.category = definition.category;
    descriptor.shortcut_hint = definition.shortcut_hint;
    descriptor.priority = definition.priority;
    descriptor.scope = definition.scope;
    descriptor.window_lifecycle = definition.window_lifecycle;
    descriptor.context_scope = definition.context_scope;
    descriptor.presentation = definition.presentation;
    descriptor.visibility_flag = definition.visibility_flag;
    descriptor.on_show = definition.on_show;
    descriptor.on_hide = definition.on_hide;
 
    for (const auto& legacy_id : definition.legacy_ids) {
      window_manager_.RegisterPanelAlias(legacy_id, definition.id);
    }
 
    window_manager_.RegisterWindow(descriptor);
    if (definition.visible_by_default) {
      window_manager_.OpenWindow(definition.id);
    }
  }
}
 
void EditorManager::InitializeServices() {
  // Initialize project file editor
  project_file_editor_.SetToastManager(&toast_manager_);
 
  // Initialize agent UI (no-op when agent UI is disabled)
  agent_ui_->Initialize(&toast_manager_, &proposal_drawer_,
                        right_drawer_manager_.get(), &window_manager_,
                        &user_settings_);
 
  // Note: Unified gRPC Server is started from Application::Initialize()
  // after gRPC infrastructure is properly set up
 
  // Load critical user settings first
  status_ = user_settings_.Load();
  if (!status_.ok()) {
    LOG_WARN("EditorManager", "Failed to load user settings: %s",
             status_.ToString().c_str());
  }
 
  feature_hint_manager_.SetUserSettings(&user_settings_);
  feature_hint_manager_.SetToastManager(&toast_manager_);
  feature_hint_manager_.RegisterBuiltinHints();
  feature_hint_manager_.SetGuideCallback([this]() {
    if (popup_manager_) {
      popup_manager_->Show(PopupID::kComingFromZScream);
    }
  });
 
  // Wire theme persistence. Any successful theme application (selector click,
  // command-palette switch, programmatic call) stamps the name into prefs and
  // rides the existing debounced-save path. Decouples ThemeManager (singleton
  // in app/gui) from UserSettings (editor-layer) — ThemeManager holds only a
  // std::function.
  gui::ThemeManager::Get().SetOnThemeChangedCallback(
      [this](const std::string& theme_name) {
        user_settings_.prefs().last_theme_name = theme_name;
        settings_dirty_ = true;
        settings_dirty_timestamp_ = TimingManager::Get().GetElapsedTime();
      });
  i18n::LanguageManager::Get().SetOnLanguageChangedCallback(
      [this](const std::string& locale) {
        user_settings_.prefs().language_locale = locale;
        settings_dirty_ = true;
        settings_dirty_timestamp_ = TimingManager::Get().GetElapsedTime();
      });
 
  auto& prefs = user_settings_.prefs();
  i18n::LanguageManager::Get().SetLanguage(prefs.language_locale);
 
  // Apply the persisted font selection (defaults to index 0 = Karla).
  // Fonts were loaded by the window backend before EditorManager init, so
  // ImGui::GetIO().Fonts->Fonts is fully populated here.
  ::yaze::SetActiveFontIndex(prefs.font_family_index);
 
  prefs.switch_motion_profile = std::clamp(prefs.switch_motion_profile, 0, 2);
  gui::GetAnimator().SetMotionPreferences(
      prefs.reduced_motion,
      gui::Animator::ClampMotionProfile(prefs.switch_motion_profile));
 
  ApplyLayoutDefaultsMigrationIfNeeded();
 
  if (right_drawer_manager_) {
    // Rebuilding dock placement does not invalidate user-sized drawers.
    // Migrations that intentionally discard widths clear them in UserSettings.
    right_drawer_manager_->RestoreDrawerWidths(
        user_settings_.prefs().right_panel_widths);
    auto normalized_widths = user_settings_.prefs().right_panel_widths;
    MergeRightDrawerWidthPreferences(
        &normalized_widths, right_drawer_manager_->SerializeDrawerWidths());
    if (user_settings_.prefs().right_panel_widths != normalized_widths) {
      user_settings_.prefs().right_panel_widths = std::move(normalized_widths);
      settings_dirty_ = true;
      settings_dirty_timestamp_ = TimingManager::Get().GetElapsedTime();
    }
    right_drawer_manager_->SetDrawerWidthChangedCallback(
        [this](RightDrawerManager::DrawerType, float) {
          if (!right_drawer_manager_) {
            return;
          }
          MergeRightDrawerWidthPreferences(
              &user_settings_.prefs().right_panel_widths,
              right_drawer_manager_->SerializeDrawerWidths());
          settings_dirty_ = true;
          settings_dirty_timestamp_ = TimingManager::Get().GetElapsedTime();
        });
  }
  agent_ui_->ApplyUserSettingsDefaults();
  // Apply sprite naming preference globally.
  yaze::zelda3::SetPreferHmagicSpriteNames(
      user_settings_.prefs().prefer_hmagic_sprite_names);
 
  window_manager_.RestorePinnedState(user_settings_.prefs().pinned_panels);
 
  // Apply font scale after loading (only if ImGui context exists)
  if (ImGui::GetCurrentContext() != nullptr) {
    ImGui::GetIO().FontGlobalScale = user_settings_.prefs().font_global_scale;
  } else {
    LOG_WARN("EditorManager",
             "ImGui context not available; skipping FontGlobalScale update");
  }
 
  // Restore the user's last theme. Empty (first run) or "Custom Accent"
  // (transient generated themes without a matching discovered preset) both
  // skip restoration and keep the built-in default (Classic YAZE / YAZE Tre).
  const auto& last_theme = user_settings_.prefs().last_theme_name;
  if (!last_theme.empty() && last_theme != "Custom Accent") {
    gui::ThemeManager::Get().ApplyTheme(last_theme);
  }
 
  // Initialize WASM control and session APIs for browser/agent integration
#ifdef __EMSCRIPTEN__
  app::platform::WasmControlApi::Initialize(this);
  app::platform::WasmSessionBridge::Initialize(this);
  LOG_INFO("EditorManager", "WASM Control and Session APIs initialized");
#endif
}
 
void EditorManager::SetupComponentCallbacks() {
  SetupDialogCallbacks();
  SetupSidebarCallbacks();
 
  if (ui_coordinator_ && !user_settings_.prefs().show_welcome_on_startup) {
    ui_coordinator_->SetWelcomeScreenVisible(false);
    ui_coordinator_->SetWelcomeScreenManuallyClosed(true);
  }
}
 
bool EditorManager::WantsContinuousFrames() const {
  return emulator_.running() || gfx::Arena::Get().HasPendingTextures() ||
         pending_editor_deferred_actions_.load(std::memory_order_relaxed) > 0;
}
 
bool EditorManager::HasOpenEditor() const {
  return current_editor_ != nullptr &&
         window_manager_.GetActiveCategory() !=
             WorkspaceWindowManager::kDashboardCategory;
}
 
void EditorManager::ShowPostLoadSurface() {
  if (ui_coordinator_) {
    ui_coordinator_->SetWelcomeScreenVisible(false);
  }
 
  // 1. Never cover an editor the user already has open. Re-enter the same
  //    editor type so it binds to the newly loaded session.
  std::optional<EditorType> target;
  if (HasOpenEditor()) {
    target = current_editor_->type();
  }
 
  // 2. Settings > Editor Behavior > Default Editor.
  if (!target.has_value()) {
    switch (user_settings_.prefs().default_editor) {
      case 1:
        target = EditorType::kOverworld;
        break;
      case 2:
        target = EditorType::kDungeon;
        break;
      case 3:
        target = EditorType::kGraphics;
        break;
      case 4:
        target = EditorType::kMessage;
        break;
      default:
        break;
    }
  }
 
  // 3. The editor picker, unless it is suppressed (--startup_dashboard=hide
  //    or Settings > Test mode). Suppressed with no other choice: open the
  //    most recently used editor, else Dungeon.
  if (!target.has_value()) {
    if (!ui_coordinator_ || ui_coordinator_->ShouldShowDashboard()) {
      if (ui_coordinator_) {
        ui_coordinator_->SetEditorSelectionVisible(true);
      }
      // Suppress panel drawing until the user picks an editor.
      window_manager_.SetActiveCategory(
          WorkspaceWindowManager::kDashboardCategory, /*notify=*/false);
      return;
    }
    target =
        (dashboard_panel_ ? dashboard_panel_->MostRecentEditor() : std::nullopt)
            .value_or(EditorType::kDungeon);
  }
 
  if (ui_coordinator_) {
    ui_coordinator_->SetStartupSurface(StartupSurface::kEditor);
  }
  SwitchToEditor(*target, /*force_visible=*/true);
}
 
void EditorManager::InitializeShortcutSystem() {
  ShortcutDependencies shortcut_deps;
  shortcut_deps.editor_manager = this;
  shortcut_deps.editor_registry = &editor_registry_;
  shortcut_deps.menu_orchestrator = menu_orchestrator_.get();
  shortcut_deps.rom_file_manager = &rom_file_manager_;
  shortcut_deps.project_manager = &project_manager_;
  shortcut_deps.session_coordinator = session_coordinator_.get();
  shortcut_deps.ui_coordinator = ui_coordinator_.get();
  shortcut_deps.workspace_manager = &workspace_manager_;
  shortcut_deps.popup_manager = popup_manager_.get();
  shortcut_deps.toast_manager = &toast_manager_;
  shortcut_deps.window_manager = &window_manager_;
  shortcut_deps.user_settings = &user_settings_;
 
  ConfigureEditorShortcuts(shortcut_deps, &shortcut_manager_);
  ConfigureMenuShortcuts(shortcut_deps, &shortcut_manager_);
  ConfigurePanelShortcuts(shortcut_deps, &shortcut_manager_);
}
 
void EditorManager::OpenEditorAndPanelsFromFlags(
    const std::string& editor_name, const std::string& panels_str) {
  const bool has_editor = !editor_name.empty();
  const bool has_panels = !panels_str.empty();
 
  if (!has_editor && !has_panels) {
    return;
  }
 
  LOG_INFO("EditorManager",
           "Processing startup flags: editor='%s', panels='%s'",
           editor_name.c_str(), panels_str.c_str());
 
  std::optional<EditorType> editor_type_to_open =
      has_editor ? ParseEditorTypeFromString(editor_name) : std::nullopt;
  if (has_editor && !editor_type_to_open.has_value()) {
    LOG_WARN("EditorManager", "Unknown editor specified via flag: %s",
             editor_name.c_str());
  } else if (editor_type_to_open.has_value()) {
    // Use EditorActivator to ensure layouts and default panels are initialized
    SwitchToEditor(*editor_type_to_open, true, /*from_dialog=*/true);
  }
 
  // Open windows via WorkspaceWindowManager - works for any editor type
  if (!has_panels) {
    return;
  }
 
  const size_t session_id = GetCurrentSessionId();
  std::string last_known_category = window_manager_.GetActiveCategory();
  bool applied_category_from_panel = false;
 
  for (absl::string_view token :
       absl::StrSplit(panels_str, ',', absl::SkipWhitespace())) {
    if (token.empty()) {
      continue;
    }
    std::string panel_name = std::string(absl::StripAsciiWhitespace(token));
    LOG_DEBUG("EditorManager", "Attempting to open panel: '%s'",
              panel_name.c_str());
 
    const std::string lower_name = absl::AsciiStrToLower(panel_name);
    if (lower_name == "welcome" || lower_name == "welcome_screen") {
      if (ui_coordinator_) {
        ui_coordinator_->SetWelcomeScreenBehavior(StartupVisibility::kShow);
      }
      continue;
    }
    if (lower_name == "dashboard" || lower_name == "dashboard.main" ||
        lower_name == "editor_selection") {
      if (dashboard_panel_) {
        dashboard_panel_->Show();
      }
      if (ui_coordinator_) {
        ui_coordinator_->SetDashboardBehavior(StartupVisibility::kShow);
      }
      window_manager_.SetActiveCategory(
          WorkspaceWindowManager::kDashboardCategory,
          /*notify=*/false);
      continue;
    }
 
    // Special case: "Room <id>" opens a dungeon room
    if (absl::StartsWith(panel_name, "Room ")) {
      if (auto* editor_set = GetCurrentEditorSet()) {
        try {
          int room_id = std::stoi(panel_name.substr(5));
          event_bus_.Publish(
              JumpToRoomRequestEvent::Create(room_id, session_id));
        } catch (const std::exception& e) {
          LOG_WARN("EditorManager", "Invalid room ID format: %s",
                   panel_name.c_str());
        }
      }
      continue;
    }
 
    std::optional<std::string> resolved_panel;
    if (window_manager_.GetWindowDescriptor(session_id, panel_name)) {
      resolved_panel = panel_name;
    } else {
      for (const auto& [prefixed_id, descriptor] :
           window_manager_.GetAllWindowDescriptors()) {
        const std::string base_id = StripSessionPrefix(prefixed_id);
        const std::string card_lower = absl::AsciiStrToLower(base_id);
        const std::string display_lower =
            absl::AsciiStrToLower(descriptor.display_name);
 
        if (card_lower == lower_name || display_lower == lower_name) {
          resolved_panel = base_id;
          break;
        }
      }
    }
 
    if (!resolved_panel.has_value()) {
      LOG_WARN("EditorManager",
               "Unknown panel '%s' from --open_panels (known count: %zu)",
               panel_name.c_str(),
               window_manager_.GetAllWindowDescriptors().size());
      continue;
    }
 
    if (window_manager_.OpenWindow(session_id, *resolved_panel)) {
      const auto* descriptor =
          window_manager_.GetWindowDescriptor(session_id, *resolved_panel);
      if (descriptor != nullptr) {
        const EditorType type =
            EditorRegistry::GetEditorTypeFromCategory(descriptor->category);
        const auto ensure_status = EnsureEditorAssetsLoaded(type);
        if (!ensure_status.ok()) {
          LOG_WARN("EditorManager", "Failed to load assets for panel '%s': %s",
                   resolved_panel->c_str(), ensure_status.message().data());
        }
      }
      if (descriptor && !applied_category_from_panel &&
          descriptor->category != WorkspaceWindowManager::kDashboardCategory) {
        window_manager_.SetActiveCategory(descriptor->category);
        applied_category_from_panel = true;
      } else if (!applied_category_from_panel && descriptor &&
                 descriptor->category.empty() && !last_known_category.empty()) {
        window_manager_.SetActiveCategory(last_known_category);
      }
    } else {
      LOG_WARN("EditorManager", "Failed to show panel '%s'",
               resolved_panel->c_str());
    }
  }
}
 
void EditorManager::ApplyStartupVisibility(const AppConfig& config) {
  welcome_mode_override_ = config.welcome_mode;
  dashboard_mode_override_ = config.dashboard_mode;
  sidebar_mode_override_ = config.sidebar_mode;
  ApplyStartupVisibilityOverrides();
}
 
void EditorManager::SetStartupLoadHints(const AppConfig& config) {
  startup_editor_hint_ = config.startup_editor;
  startup_panel_hints_ = config.open_panels;
  welcome_mode_override_ = config.welcome_mode;
  dashboard_mode_override_ = config.dashboard_mode;
  sidebar_mode_override_ = config.sidebar_mode;
}
 
void EditorManager::ApplyLayoutDefaultsMigrationIfNeeded() {
  constexpr int kTargetRevision =
      UserSettings::kLatestPanelLayoutDefaultsRevision;
  const int previous_revision =
      user_settings_.prefs().panel_layout_defaults_revision;
  if (!user_settings_.ApplyPanelLayoutDefaultsRevision(kTargetRevision)) {
    return;
  }
 
  const bool includes_workspace_reset_revision =
      previous_revision <
          UserSettings::kLastWorkspaceResetPanelLayoutDefaultsRevision &&
      kTargetRevision >=
          UserSettings::kLastWorkspaceResetPanelLayoutDefaultsRevision;
  pending_layout_defaults_reset_ =
      pending_layout_defaults_reset_ || includes_workspace_reset_revision;
  settings_dirty_ = true;
  settings_dirty_timestamp_ = TimingManager::Get().GetElapsedTime();
 
  LOG_INFO("EditorManager",
           "Applied panel layout defaults migration %d -> %d (%s)",
           previous_revision, kTargetRevision,
           includes_workspace_reset_revision ? "workspace reset"
                                             : "targeted preferences");
}
 
std::string EditorManager::GetPreferredStartupCategory(
    const std::string& saved_category,
    const std::vector<std::string>& available_categories) const {
  const std::string preferred =
      PreferStartupCategory(saved_category, available_categories);
  if (preferred.empty()) {
    return preferred;
  }
 
  return preferred;
}
 
void EditorManager::SetAssetLoadMode(AssetLoadMode mode) {
  asset_load_mode_ = mode;
}
 
void EditorManager::ApplyStartupVisibilityOverrides() {
  if (ui_coordinator_) {
    ui_coordinator_->SetWelcomeScreenBehavior(welcome_mode_override_);
    ui_coordinator_->SetDashboardBehavior(dashboard_mode_override_);
  }
 
  if (sidebar_mode_override_ != StartupVisibility::kAuto) {
    const bool sidebar_visible =
        sidebar_mode_override_ == StartupVisibility::kShow;
    window_manager_.SetSidebarVisible(sidebar_visible, /*notify=*/false);
    if (ui_coordinator_) {
      ui_coordinator_->SetPanelSidebarVisible(sidebar_visible);
    }
  }
 
  // Force sidebar panel to collapse if Welcome Screen or Dashboard is explicitly shown
  // This prevents visual overlap/clutter on startup
  if (welcome_mode_override_ == StartupVisibility::kShow ||
      dashboard_mode_override_ == StartupVisibility::kShow) {
    window_manager_.SetSidebarExpanded(false, /*notify=*/false);
  }
 
  if (dashboard_panel_) {
    if (dashboard_mode_override_ == StartupVisibility::kHide) {
      dashboard_panel_->Hide();
    } else if (dashboard_mode_override_ == StartupVisibility::kShow) {
      dashboard_panel_->Show();
    }
  }
}
 
void EditorManager::ProcessStartupActions(const AppConfig& config) {
  ApplyStartupVisibility(config);
  // Handle startup editor and panels
  std::string panels_str;
  for (size_t i = 0; i < config.open_panels.size(); ++i) {
    if (i > 0)
      panels_str += ",";
    panels_str += config.open_panels[i];
  }
  OpenEditorAndPanelsFromFlags(config.startup_editor, panels_str);
 
  // Handle jump targets
  if (config.jump_to_room >= 0) {
    event_bus_.Publish(JumpToRoomRequestEvent::Create(config.jump_to_room,
                                                      GetCurrentSessionId()));
  }
  if (config.jump_to_map >= 0) {
    // The navigation handler loads project assets before validating the target
    // against the editor's displayed capacity (including project Lyra maps).
    event_bus_.Publish(JumpToMapRequestEvent::Create(config.jump_to_map,
                                                     GetCurrentSessionId()));
  }
}
 
absl::Status EditorManager::LoadAssetsForMode(uint64_t loading_handle) {
  switch (asset_load_mode_) {
    case AssetLoadMode::kLazy:
      return LoadAssetsLazy(loading_handle);
    case AssetLoadMode::kFull:
    case AssetLoadMode::kAuto:
    default:
      return LoadAssets(loading_handle);
  }
}
 
void EditorManager::ResetAssetState(RomSession* session) {
  if (!session) {
    return;
  }
  session->ResetGraphicsDisplay();
  session->game_data_loaded = false;
  session->editor_initialized.fill(false);
  session->editor_assets_loaded.fill(false);
}
 
void EditorManager::MarkEditorInitialized(RomSession* session,
                                          EditorType type) {
  if (!session) {
    return;
  }
  const size_t index = EditorTypeIndex(type);
  if (index < session->editor_initialized.size()) {
    session->editor_initialized[index] = true;
  }
}
 
void EditorManager::MarkEditorLoaded(RomSession* session, EditorType type) {
  if (!session) {
    return;
  }
  const size_t index = EditorTypeIndex(type);
  if (index < session->editor_assets_loaded.size()) {
    session->editor_assets_loaded[index] = true;
  }
}
 
void EditorManager::RestoreEditorLayoutAfterAssets(RomSession* session,
                                                   EditorType type) {
  if (!session || !layout_manager_) {
    return;
  }
 
  const size_t index = EditorTypeIndex(type);
  if (!EditorRegistry::IsPanelBasedEditor(type) ||
      index >= session->editor_initialized.size() ||
      !session->editor_initialized[index] ||
      window_manager_.GetActiveSessionId() != session->session_id()) {
    return;
  }
 
  const std::string category = EditorRegistry::GetEditorCategory(type);
  // Session switching can happen before a lazily loaded editor registers its
  // panels. Repeat the persisted visibility pass once those descriptors exist.
  const auto visibility_it =
      user_settings_.prefs().panel_visibility_state.find(category);
  if (visibility_it != user_settings_.prefs().panel_visibility_state.end()) {
    window_manager_.RestoreVisibilityState(session->session_id(),
                                           visibility_it->second);
  }
 
  // Only the active category owns the shared dock tree. A cross-category
  // activation will refresh its layout immediately after the category switch.
  if (window_manager_.GetActiveCategory() == category &&
      layout_manager_->IsLayoutInitialized(type)) {
    editor_activator_.InitializeEditorLayout(type);
  }
}
 
void EditorManager::RestoreActiveEditorLayoutAfterAssets(RomSession* session) {
  const EditorType type = EditorRegistry::GetEditorTypeFromCategory(
      window_manager_.GetActiveCategory());
  RestoreEditorLayoutAfterAssets(session, type);
}
 
bool EditorManager::EditorRequiresGameData(EditorType type) const {
  switch (type) {
    case EditorType::kOverworld:
    case EditorType::kDungeon:
    case EditorType::kGraphics:
    case EditorType::kPalette:
    case EditorType::kScreen:
    case EditorType::kSprite:
    case EditorType::kMessage:
      return true;
    default:
      return false;
  }
}
 
bool EditorManager::EditorInitRequiresGameData(EditorType type) const {
  return type == EditorType::kMessage;
}
 
std::vector<EditorType> EditorManager::CollectEditorsToPreload(
    EditorSet* editor_set) const {
  std::unordered_set<EditorType> types;
 
  auto add_type = [&types](EditorType type) {
    switch (type) {
      case EditorType::kUnknown:
      case EditorType::kEmulator:
      case EditorType::kSettings:
      case EditorType::kAgent:
        return;
      default:
        types.insert(type);
        return;
    }
  };
 
  auto add_category = [&](const std::string& category) {
    if (category.empty() ||
        category == WorkspaceWindowManager::kDashboardCategory) {
      return;
    }
    add_type(EditorRegistry::GetEditorTypeFromCategory(category));
  };
 
  const size_t session_id = GetCurrentSessionId();
  bool used_startup_hints = false;
 
  if (!startup_editor_hint_.empty()) {
    if (auto startup_type = ParseEditorTypeFromString(startup_editor_hint_)) {
      add_type(*startup_type);
      used_startup_hints = true;
    }
  }
 
  for (const auto& panel_name : startup_panel_hints_) {
    if (panel_name.empty()) {
      continue;
    }
 
    if (const auto* descriptor =
            window_manager_.GetWindowDescriptor(session_id, panel_name)) {
      add_category(descriptor->category);
      used_startup_hints = true;
      continue;
    }
 
    const std::string lower_name = absl::AsciiStrToLower(panel_name);
    for (const auto& [prefixed_id, descriptor] :
         window_manager_.GetAllWindowDescriptors()) {
      const std::string base_id = StripSessionPrefix(prefixed_id);
      const std::string card_lower = absl::AsciiStrToLower(base_id);
      const std::string display_lower =
          absl::AsciiStrToLower(descriptor.display_name);
      if (card_lower == lower_name || display_lower == lower_name) {
        add_category(descriptor.category);
        used_startup_hints = true;
        break;
      }
    }
  }
 
  if (used_startup_hints) {
    return std::vector<EditorType>(types.begin(), types.end());
  }
 
  if (dashboard_mode_override_ == StartupVisibility::kShow) {
    return {};
  }
 
  if (editor_set) {
    for (auto* editor : editor_set->active_editors_) {
      if (editor != nullptr && *editor->active()) {
        add_type(editor->type());
      }
    }
  }
 
  if (current_editor_ != nullptr) {
    add_type(current_editor_->type());
  }
 
  add_category(window_manager_.GetActiveCategory());
 
  for (const auto& window_id :
       window_manager_.GetVisibleWindowIds(session_id)) {
    if (const auto* descriptor =
            window_manager_.GetWindowDescriptor(session_id, window_id)) {
      add_category(descriptor->category);
    }
  }
 
  return std::vector<EditorType>(types.begin(), types.end());
}
 
Editor* EditorManager::GetEditorByType(EditorType type,
                                       EditorSet* editor_set) const {
  return editor_set ? editor_set->GetEditor(type) : nullptr;
}
 
Editor* EditorManager::ResolveEditorForCategory(const std::string& category) {
  if (category.empty() ||
      category == WorkspaceWindowManager::kDashboardCategory) {
    return nullptr;
  }
 
  auto* editor_set = GetCurrentEditorSet();
  if (!editor_set) {
    return nullptr;
  }
 
  EditorType type = EditorRegistry::GetEditorTypeFromCategory(category);
  switch (type) {
    case EditorType::kAgent:
#ifdef YAZE_BUILD_AGENT_UI
      return agent_ui_->GetAgentEditor();
#else
      return nullptr;
#endif
    case EditorType::kEmulator:
    case EditorType::kSettings:
    case EditorType::kUnknown:
      return nullptr;
    default:
      return GetEditorByType(type, editor_set);
  }
}
 
EditorContextSnapshot EditorManager::GetEditorContextSnapshot(
    const std::string& category) {
  EditorContextSnapshot snapshot;
  snapshot.category = category;
  Editor* editor = ResolveEditorForCategory(category);
  if (editor == nullptr) {
    return snapshot;
  }
 
  snapshot = editor->BuildContextSnapshot();
  if (snapshot.category.empty()) {
    snapshot.category = category;
  }
  if (snapshot.semantic_owner.empty()) {
    snapshot.semantic_owner = snapshot.category;
  }
 
  const EditorExperimentPolicy policy =
      EditorRegistry::GetExperimentPolicy(editor->type());
  snapshot.experiment.experimental = policy.experimental;
  snapshot.experiment.acknowledged =
      !policy.experimental || user_settings_.prefs().show_experimental_editors;
  switch (policy.disabled_save_posture) {
    case ExperimentalSavePosture::kDefensiveBackup:
      snapshot.experiment.save_posture = "Defensive backup";
      break;
    case ExperimentalSavePosture::kReadOnly:
      snapshot.experiment.save_posture = "Guarded / read-only";
      break;
    case ExperimentalSavePosture::kNormal:
    default:
      snapshot.experiment.save_posture = "Normal";
      break;
  }
  if (EditorRegistry::ShouldWarnAboutExperimentalEditor(
          editor->type(), user_settings_.prefs().show_experimental_editors)) {
    snapshot.diagnostics.push_back({
        .id = "experimental_editor",
        .severity = EditorContextDiagnosticSeverity::kWarning,
        .message = absl::StrFormat("%s is experimental; save posture: %s",
                                   snapshot.category,
                                   snapshot.experiment.save_posture),
    });
  }
  return snapshot;
}
 
void EditorManager::SyncEditorContextForCategory(const std::string& category) {
  if (Editor* resolved = ResolveEditorForCategory(category)) {
    SetCurrentEditor(resolved);
  } else if (!category.empty() &&
             category != WorkspaceWindowManager::kDashboardCategory) {
    LOG_DEBUG("EditorManager", "No editor context available for category '%s'",
              category.c_str());
  }
}
 
absl::Status EditorManager::InitializeEditorForType(EditorType type,
                                                    EditorSet* editor_set,
                                                    Rom* rom) {
  if (!editor_set) {
    return absl::FailedPreconditionError("No editor set available");
  }
 
  auto* editor = GetEditorByType(type, editor_set);
  if (!editor) {
    return absl::OkStatus();
  }
  editor->Initialize();
  return absl::OkStatus();
}
 
absl::Status EditorManager::EnsureGameDataLoaded() {
  auto* session = session_coordinator_
                      ? session_coordinator_->GetActiveRomSession()
                      : nullptr;
  if (!session) {
    return absl::FailedPreconditionError("No active session");
  }
  if (session->game_data_loaded) {
    return absl::OkStatus();
  }
  if (!session->rom.is_loaded()) {
    return absl::FailedPreconditionError("ROM not loaded");
  }
 
  RETURN_IF_ERROR(zelda3::LoadGameData(session->rom, session->game_data));
  session->ReloadGraphicsDisplay();
 
  auto* game_data = &session->game_data;
  auto* editor_set = &session->editors;
  editor_set->SetGameData(game_data);
  gfx::PaletteManager::Get().Initialize(game_data);
 
  ContentRegistry::Context::SetGameData(game_data);
  session->game_data_loaded = true;
 
  return absl::OkStatus();
}
 
absl::Status EditorManager::EnsureEditorAssetsLoaded(EditorType type) {
  if (type == EditorType::kUnknown) {
    return absl::OkStatus();
  }
 
  auto* session = session_coordinator_
                      ? session_coordinator_->GetActiveRomSession()
                      : nullptr;
  if (!session) {
    return absl::OkStatus();
  }
 
  if (!session->rom.is_loaded()) {
    if (!EditorRegistry::UpdateAllowedWithoutLoadedRom(type)) {
      return absl::OkStatus();
    }
    const size_t index = EditorTypeIndex(type);
    if (index >= session->editor_initialized.size()) {
      return absl::InvalidArgumentError("Invalid editor type");
    }
    if (EditorInitRequiresGameData(type)) {
      return absl::OkStatus();
    }
    bool initialized_now = false;
    if (!session->editor_initialized[index]) {
      RETURN_IF_ERROR(
          InitializeEditorForType(type, &session->editors, &session->rom));
      MarkEditorInitialized(session, type);
      initialized_now = true;
    }
    if (initialized_now) {
      RestoreEditorLayoutAfterAssets(session, type);
    }
    return absl::OkStatus();
  }
 
  const size_t index = EditorTypeIndex(type);
  if (index >= session->editor_initialized.size()) {
    return absl::InvalidArgumentError("Invalid editor type");
  }
 
  if (EditorInitRequiresGameData(type)) {
    RETURN_IF_ERROR(EnsureGameDataLoaded());
  }
 
  bool initialized_now = false;
  if (!session->editor_initialized[index]) {
    RETURN_IF_ERROR(
        InitializeEditorForType(type, &session->editors, &session->rom));
    MarkEditorInitialized(session, type);
    initialized_now = true;
  }
 
  if (EditorRequiresGameData(type)) {
    RETURN_IF_ERROR(EnsureGameDataLoaded());
  }
 
  bool loaded_now = false;
  if (!session->editor_assets_loaded[index]) {
    auto* editor = GetEditorByType(type, &session->editors);
    if (editor) {
      RETURN_IF_ERROR(editor->Load());
    }
    MarkEditorLoaded(session, type);
    loaded_now = true;
  }
 
  if (initialized_now || loaded_now) {
    RestoreEditorLayoutAfterAssets(session, type);
  }
 
  return absl::OkStatus();
}
 
void EditorManager::RefreshHackWorkflowBackend() {
  hack_workflow_backend_ =
      workflow::CreateHackWorkflowBackendForProject(&current_project_);
  ContentRegistry::Context::SetHackWorkflowBackend(
      hack_workflow_backend_.get());
}
 
absl::Status EditorManager::LoadRom() {
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kOpenRomDialog,
           GetCurrentSessionId()})) {
    return absl::OkStatus();
  }
 
  return LoadRomInternal();
}
 
absl::Status EditorManager::LoadAssets(uint64_t passed_handle) {
  auto* current_rom = GetCurrentRom();
  auto* current_editor_set = GetCurrentEditorSet();
  if (!current_rom || !current_editor_set) {
    return absl::FailedPreconditionError("No ROM or editor set loaded");
  }
 
  auto* current_session = session_coordinator_->GetActiveRomSession();
  if (!current_session) {
    return absl::FailedPreconditionError("No active ROM session");
  }
  ResetAssetState(current_session);
 
  auto start_time = std::chrono::steady_clock::now();
 
#ifdef __EMSCRIPTEN__
  // Use passed handle if provided, otherwise create new one
  auto loading_handle =
      passed_handle != 0
          ? static_cast<app::platform::WasmLoadingManager::LoadingHandle>(
                passed_handle)
          : app::platform::WasmLoadingManager::BeginLoading(
                "Loading Editor Assets");
 
  // Progress starts at 10% (ROM already loaded), goes to 100%
  constexpr float kStartProgress = 0.10f;
  constexpr float kEndProgress = 1.0f;
  constexpr int kTotalSteps = 11;  // Graphics + 8 editors + profiler + finish
  int current_step = 0;
  auto update_progress = [&](const std::string& message) {
    current_step++;
    float progress =
        kStartProgress + (kEndProgress - kStartProgress) *
                             (static_cast<float>(current_step) / kTotalSteps);
    app::platform::WasmLoadingManager::UpdateProgress(loading_handle, progress);
    app::platform::WasmLoadingManager::UpdateMessage(loading_handle, message);
  };
  // RAII guard to ensure loading indicator is closed even on early return
  auto cleanup_loading = [&]() {
    app::platform::WasmLoadingManager::EndLoading(loading_handle);
  };
  struct LoadingGuard {
    std::function<void()> cleanup;
    bool dismissed = false;
    ~LoadingGuard() {
      if (!dismissed)
        cleanup();
    }
    void dismiss() { dismissed = true; }
  } loading_guard{cleanup_loading};
#else
  (void)passed_handle;  // Unused on non-WASM
#endif
 
  // Set renderer for emulator (lazy initialization happens in Run())
  if (renderer_) {
    emulator_.set_renderer(renderer_);
  }
 
  const auto preload_editor_list = CollectEditorsToPreload(current_editor_set);
  const std::unordered_set<EditorType> preload_types(
      preload_editor_list.begin(), preload_editor_list.end());
 
  // Initialize only the editors needed for the current startup surface. This
  // registers their windows and sets up editor-specific resources before Load().
  struct InitStep {
    EditorType type;
    bool mark_loaded;
  };
  const InitStep init_steps[] = {
      {EditorType::kOverworld, false}, {EditorType::kMessage, false},
      {EditorType::kGraphics, false},  {EditorType::kScreen, false},
      {EditorType::kSprite, false},    {EditorType::kPalette, false},
      {EditorType::kAssembly, true},   {EditorType::kMusic, false},
      {EditorType::kDungeon, false},
  };
  for (const auto& step : init_steps) {
    if (!preload_types.contains(step.type)) {
      continue;
    }
    if (auto* editor = current_editor_set->GetEditor(step.type)) {
      editor->Initialize();
      MarkEditorInitialized(current_session, step.type);
      if (step.mark_loaded) {
        MarkEditorLoaded(current_session, step.type);
      }
    }
  }
 
#ifdef __EMSCRIPTEN__
  update_progress("Loading graphics sheets...");
#endif
  // Load all Zelda3-specific data (metadata, palettes, gfx groups, graphics)
  gfx::PaletteManager::Get().ReleaseSession(&current_session->game_data);
  RETURN_IF_ERROR(
      zelda3::LoadGameData(*current_rom, current_session->game_data));
  current_session->game_data_loaded = true;
 
  current_session->ReloadGraphicsDisplay();
 
  // Propagate GameData to editors that already exist; future editors inherit it
  // on first construction via EditorSet.
  auto* game_data = &current_session->game_data;
  current_editor_set->SetGameData(game_data);
  gfx::PaletteManager::Get().Initialize(game_data);
 
  struct LoadStep {
    EditorType type;
    const char* progress_message;
  };
  const LoadStep load_steps[] = {
      {EditorType::kOverworld, "Loading overworld..."},
      {EditorType::kDungeon, "Loading dungeons..."},
      {EditorType::kScreen, "Loading screen editor..."},
      {EditorType::kGraphics, "Loading graphics editor..."},
      {EditorType::kSprite, "Loading sprites..."},
      {EditorType::kMessage, "Loading messages..."},
      {EditorType::kMusic, "Loading music..."},
      {EditorType::kPalette, "Loading palettes..."},
  };
  for (const auto& step : load_steps) {
    if (!preload_types.contains(step.type)) {
      continue;
    }
#ifdef __EMSCRIPTEN__
    update_progress(step.progress_message);
#endif
    if (auto* editor = current_editor_set->GetEditor(step.type)) {
      RETURN_IF_ERROR(editor->Load());
      MarkEditorLoaded(current_session, step.type);
    }
  }
 
#ifdef __EMSCRIPTEN__
  update_progress("Finishing up...");
#endif
 
  // Set up RightDrawerManager with session's settings editor
  if (right_drawer_manager_) {
    auto* settings = current_editor_set->GetSettingsPanel();
    right_drawer_manager_->SetSettingsPanel(settings);
  }
 
  // Apply user preferences to status bar
  status_bar_.SetEnabled(user_settings_.prefs().show_status_bar);
 
  RestoreActiveEditorLayoutAfterAssets(current_session);
 
  gfx::PerformanceProfiler::Get().PrintSummary();
 
#ifdef __EMSCRIPTEN__
  // Dismiss the guard and manually close - we completed successfully
  loading_guard.dismiss();
  app::platform::WasmLoadingManager::EndLoading(loading_handle);
#endif
 
  auto end_time = std::chrono::steady_clock::now();
  auto duration = std::chrono::duration_cast<std::chrono::milliseconds>(
      end_time - start_time);
  LOG_DEBUG("EditorManager", "ROM assets loaded in %lld ms", duration.count());
 
  return absl::OkStatus();
}
 
absl::Status EditorManager::LoadAssetsLazy(uint64_t passed_handle) {
  auto* current_rom = GetCurrentRom();
  auto* current_editor_set = GetCurrentEditorSet();
  if (!current_rom || !current_editor_set) {
    return absl::FailedPreconditionError("No ROM or editor set loaded");
  }
 
  auto* current_session = session_coordinator_->GetActiveRomSession();
  if (!current_session) {
    return absl::FailedPreconditionError("No active ROM session");
  }
  ResetAssetState(current_session);
 
#ifdef __EMSCRIPTEN__
  // Use passed handle if provided, otherwise create new one
  auto loading_handle =
      passed_handle != 0
          ? static_cast<app::platform::WasmLoadingManager::LoadingHandle>(
                passed_handle)
          : app::platform::WasmLoadingManager::BeginLoading(
                "Loading ROM (lazy assets)");
  auto cleanup_loading = [&]() {
    app::platform::WasmLoadingManager::EndLoading(loading_handle);
  };
  struct LoadingGuard {
    std::function<void()> cleanup;
    bool dismissed = false;
    ~LoadingGuard() {
      if (!dismissed) {
        cleanup();
      }
    }
    void dismiss() { dismissed = true; }
  } loading_guard{cleanup_loading};
#else
  (void)passed_handle;  // Unused on non-WASM
#endif
 
  // Set renderer for emulator (lazy initialization happens in Run())
  if (renderer_) {
    emulator_.set_renderer(renderer_);
  }
 
  // Wire settings panel to right panel manager for the current session.
  if (right_drawer_manager_) {
    auto* settings = current_editor_set->GetSettingsPanel();
    right_drawer_manager_->SetSettingsPanel(settings);
  }
 
  // Apply user preferences to status bar
  status_bar_.SetEnabled(user_settings_.prefs().show_status_bar);
 
#ifdef __EMSCRIPTEN__
  loading_guard.dismiss();
  app::platform::WasmLoadingManager::EndLoading(loading_handle);
#endif
 
  LOG_INFO("EditorManager", "Lazy asset mode: editor assets deferred");
  return absl::OkStatus();
}
 
absl::Status EditorManager::CheckRomWritePolicy(
    const std::optional<std::string>& target_filename) {
  return rom_lifecycle_.CheckRomWritePolicy(GetCurrentRom(), target_filename);
}
 
absl::Status EditorManager::CheckOracleRomSafetyPreSave(Rom* rom) {
  return rom_lifecycle_.CheckOracleRomSafetyPreSave(rom);
}
 
bool EditorManager::HasPendingRomSaveConfirmation() const {
  return rom_lifecycle_.IsRomWriteConfirmPending() ||
         rom_lifecycle_.HasPendingPotItemSaveConfirmation() ||
         !rom_lifecycle_.pending_write_conflicts().empty();
}
 
bool EditorManager::PendingRomSaveMatchesActiveSession() const {
  if (!pending_rom_save_.has_value() || !session_coordinator_) {
    return false;
  }
  return pending_rom_save_->session_index == GetCurrentSessionIndex() &&
         pending_rom_save_->rom != nullptr &&
         pending_rom_save_->rom == GetCurrentRom();
}
 
void EditorManager::CancelPendingRomSave(bool hide_popups) {
  pending_rom_save_.reset();
  rom_lifecycle_.ResetPendingSaveState();
 
  if (!hide_popups || !popup_manager_) {
    return;
  }
  for (const char* popup :
       {PopupID::kRomWriteConfirm, PopupID::kDungeonPotItemSaveConfirm,
        PopupID::kWriteConflictWarning, PopupID::kSaveAs}) {
    if (popup_manager_->IsVisible(popup)) {
      popup_manager_->Hide(popup);
    }
  }
}
 
absl::Status EditorManager::StartPendingRomSave(
    const std::optional<std::string>& save_as_filename) {
  auto* rom = GetCurrentRom();
  if (!session_coordinator_ || !session_coordinator_->GetActiveRomSession() ||
      !rom) {
    return absl::FailedPreconditionError("No active ROM session");
  }
 
  CancelPendingRomSave();
  pending_rom_save_ =
      PendingRomSave{save_as_filename, GetCurrentSessionIndex(), rom};
  return absl::OkStatus();
}
 
void EditorManager::FinishPendingRomSaveAttempt(const absl::Status& status) {
  // A Cancelled status is resumable only while one of this request's explicit
  // confirmation dialogs is pending. Every other outcome is terminal and must
  // consume all one-shot bypasses so a later Ctrl+S cannot inherit consent.
  if (status.ok() || !absl::IsCancelled(status) ||
      !HasPendingRomSaveConfirmation()) {
    CancelPendingRomSave();
  }
}
 
absl::Status EditorManager::SaveCurrentSession() {
  // An established ROM save owns its confirmation and one-shot exemptions.
  if (pending_rom_save_.has_value()) {
    return SaveRom();
  }
  if (!session_coordinator_ || !session_coordinator_->GetActiveRomSession()) {
    return absl::FailedPreconditionError("No active ROM session");
  }
  if (auto* message = static_cast<MessageEditor*>(
          GetCurrentEditorSet()->GetExistingEditor(EditorType::kMessage));
      message && message->HasUnpublishedMessageSourceChanges()) {
    return absl::FailedPreconditionError(
        "Expanded message source has unpublished edits; use Preview and "
        "Publish in the Message editor before saving");
  }
  CaptureActiveProjectEditingState();
  const size_t session_id = GetCurrentSessionId();
  RETURN_IF_ERROR(SaveProjectWorkBeforeRomSave(/*allow_dialogs=*/true));
  if (GetCurrentSessionId() != session_id) {
    return absl::FailedPreconditionError(
        "The active session changed while saving project work");
  }
  if (SessionHasPendingRomWork(GetCurrentSessionIndex())) {
    return SaveRom();
  }
  return CompletePendingProjectNativeSave();
}
 
absl::Status EditorManager::CompletePendingProjectNativeSave() {
  auto* session = session_coordinator_
                      ? session_coordinator_->GetActiveRomSession()
                      : nullptr;
  const auto* rom = GetCurrentRom();
  if (session == nullptr || !session->native_save_completion_pending ||
      pending_rom_save_.has_value() || !current_project_.project_opened() ||
      rom == nullptr || !rom->is_loaded() || rom->filename().empty()) {
    return absl::OkStatus();
  }
  return RecordCompletedNativeSave(current_project_, rom->filename(),
                                   session->native_save_completion_save_as,
                                   /*rom_written=*/false);
}
 
absl::Status EditorManager::SaveProjectWorkBeforeRomSave(bool allow_dialogs) {
  // A project-only receipt failure must not block the following ROM save.
  defer_project_native_completion_ =
      SessionHasPendingRomWork(GetCurrentSessionIndex());
  const auto status = SaveActiveProjectEditingWork(allow_dialogs);
  defer_project_native_completion_ = false;
  return status;
}
 
absl::Status EditorManager::SaveRom() {
  // Do not let an autosave or an unrelated Ctrl+S replace a Save As request
  // while one of its confirmation dialogs is still open.
  if (pending_rom_save_.has_value()) {
    const bool unresolved_confirmation =
        rom_lifecycle_.IsRomWriteConfirmPending() ||
        rom_lifecycle_.HasPendingPotItemSaveConfirmation() ||
        (!rom_lifecycle_.pending_write_conflicts().empty() &&
         !rom_lifecycle_.ShouldBypassWriteConflict());
    if (unresolved_confirmation) {
      return absl::CancelledError("Save pending confirmation");
    }
    // Preserve the established request after programmatic confirmation too.
    // Older callers use ConfirmRomWrite(); SaveRom() rather than the popup's
    // ResumePendingRomSave() helper.
    return ResumePendingRomSave();
  }
  RETURN_IF_ERROR(StartPendingRomSave(std::nullopt));
  auto status = SaveRomInternal(std::nullopt);
  FinishPendingRomSaveAttempt(status);
  return status;
}
 
absl::Status EditorManager::SaveRomAs(const std::string& filename) {
  if (filename.empty()) {
    return absl::InvalidArgumentError("No filename provided for save as");
  }
  if (pending_rom_save_.has_value() && HasPendingRomSaveConfirmation()) {
    return absl::CancelledError("Save pending confirmation");
  }
  RETURN_IF_ERROR(StartPendingRomSave(filename));
  auto status = SaveRomInternal(filename);
  FinishPendingRomSaveAttempt(status);
  return status;
}
 
absl::Status EditorManager::ResumePendingRomSave() {
  if (!pending_rom_save_.has_value()) {
    rom_lifecycle_.ResetPendingSaveState();
    return absl::FailedPreconditionError("No pending ROM save to resume");
  }
  if (!PendingRomSaveMatchesActiveSession()) {
    CancelPendingRomSave(/*hide_popups=*/true);
    return absl::FailedPreconditionError(
        "Pending ROM save belongs to a different session");
  }
 
  const auto save_as_filename = pending_rom_save_->save_as_filename;
  auto status = SaveRomInternal(save_as_filename);
  FinishPendingRomSaveAttempt(status);
  return status;
}
 
std::string EditorManager::ExecuteEditorControl(const std::string& request) {
#ifdef YAZE_WITH_JSON
  using nlohmann::json;
  CaptureActiveProjectEditingState();
  json response = {{"protocol", "yaze-editor-control/v1"},
                   {"status", "ok"},
                   {"http_status", 200}};
  response["capabilities"]["commands"] = {"status",
                                          "project.open",
                                          "project.rom.swap",
                                          "dungeon.select",
                                          "proposal.load",
                                          "panel.hide",
                                          "overworld.stencil.apply"};
#ifdef _WIN32
  const auto pid = _getpid();
#else
  const auto pid = getpid();
#endif
  const auto rom_sha256 = [](const Rom& rom) {
    return core::ComputeSourceArtifactSha256(std::string_view(
        reinterpret_cast<const char*>(rom.data()), rom.size()));
  };
  auto fail = [&](int code, const std::string& message) {
    response["status"] = "error";
    response["http_status"] = code;
    response["error"] = message;
  };
  try {
    const auto body = json::parse(request);
    const std::string command = body.at("command").get<std::string>();
    response["command"] = command;
    auto path_argument = [&]() -> std::string {
      const auto path = body.at("path").get<std::string>();
      if (path.empty() || path.find('\0') != std::string::npos ||
          !std::filesystem::path(path).is_absolute()) {
        throw std::invalid_argument("path must be an absolute local path");
      }
      return path;
    };
    auto dungeon_editor = [&]() -> DungeonEditorV2* {
      auto* editors = GetCurrentEditorSet();
      return editors
                 ? editors->GetEditorAs<DungeonEditorV2>(EditorType::kDungeon)
                 : nullptr;
    };
    const auto hash_argument = [](const json& value) {
      const auto hash = value.get<std::string>();
      if (hash.size() != 64 ||
          !std::all_of(hash.begin(), hash.end(), [](char ch) {
            return (ch >= '0' && ch <= '9') || (ch >= 'a' && ch <= 'f');
          })) {
        throw std::invalid_argument(
            "SHA256 must contain 64 lowercase hexadecimal characters");
      }
      return hash;
    };
    // The caller names the exact editor it inspected; any other process,
    // session, project, ROM file or ROM bytes refuses the command.
    const auto expected_editor_matches = [&](const json& expected) {
      for (const auto* field : {"pid", "session_id"}) {
        if (!expected.at(field).is_number_integer() || expected.at(field) < 0 ||
            (std::string_view(field) == "pid" && expected.at(field) == 0)) {
          throw std::invalid_argument(
              "expected pid and session_id must be valid nonnegative integers");
        }
      }
      const auto expected_path = [&](const char* field) {
        const auto value = expected.at(field).get<std::string>();
        if (value.empty() || value.find('\0') != std::string::npos ||
            !std::filesystem::path(value).is_absolute()) {
          throw std::invalid_argument(std::string("expected ") + field +
                                      " must be an absolute local path");
        }
        return value;
      };
      const auto project_path = expected_path("project_path");
      const auto current_rom_path = expected_path("rom_path");
      const auto current_sha256 = hash_argument(expected.at("rom_sha256"));
      const auto* rom = GetCurrentRom();
      return current_project_.project_opened() && rom && rom->is_loaded() &&
             expected.at("pid") == pid &&
             expected.at("session_id") == GetCurrentSessionId() &&
             SessionCoordinator::PathsReferToSameBackingFile(
                 project_path, current_project_.filepath) &&
             SessionCoordinator::PathsReferToSameBackingFile(current_rom_path,
                                                             rom->filename()) &&
             current_sha256 == rom_sha256(*rom);
    };
    if (command == "status") {
      // Read-only; usable before a ROM is opened.
    } else if (command == "project.open") {
      const auto path = path_argument();
      const auto extension = std::filesystem::path(path).extension();
      if (extension != ".yaze" && extension != ".zsproj" &&
          extension != ".yazeproj") {
        fail(400, "project.open requires a .yaze, .zsproj or .yazeproj path");
      } else if (HasAnySessionPendingUnsavedWork() ||
                 HasPendingUnsavedSessionAction()) {
        fail(409, "Project switch blocked: " + DescribeAllPendingUnsavedWork());
      } else if (current_project_.filepath != path) {
        // No implicit save/discard and no repair/file picker fallback.
        const auto status = OpenRomOrProjectInternal(path, false);
        if (!status.ok())
          fail(422, std::string(status.message()));
      }
    } else if (command == "project.rom.swap") {
      const auto path = path_argument();
      const auto candidate_sha256 = hash_argument(body.at("candidate_sha256"));
      const bool identity_matches =
          expected_editor_matches(body.at("expected"));
      if (HasAnySessionPendingUnsavedWork() ||
          HasPendingUnsavedSessionAction()) {
        fail(409, "ROM swap blocked by pending work or action: " +
                      DescribeAllPendingUnsavedWork());
      } else if (!identity_matches) {
        fail(409,
             "ROM swap expected identity does not match the active editor");
      } else {
        const auto status = SwapProjectRom(path, candidate_sha256);
        if (!status.ok()) {
          fail(absl::IsAborted(status) ? 409 : 422,
               std::string(status.message()));
        }
      }
    } else if (command == "overworld.stencil.apply") {
      const auto path = path_argument();
      const auto stencil_sha256 = hash_argument(body.at("stencil_sha256"));
      const bool identity_matches =
          expected_editor_matches(body.at("expected"));
      std::ifstream file(path, std::ios::binary);
      const std::string bytes((std::istreambuf_iterator<char>(file)),
                              std::istreambuf_iterator<char>());
      if (!file.good() && !file.eof()) {
        fail(422, "Stencil file could not be read");
      } else if (core::ComputeSourceArtifactSha256(bytes) != stencil_sha256) {
        fail(409, "Stencil file does not match stencil_sha256");
      } else if (HasAnySessionPendingUnsavedWork() ||
                 HasPendingUnsavedSessionAction()) {
        fail(409, "Stencil blocked by pending work or action: " +
                      DescribeAllPendingUnsavedWork());
      } else if (!identity_matches) {
        fail(409, "Stencil expected identity does not match the active editor");
      } else {
        const auto stencil = json::parse(bytes);
        if (stencil.at("schema").get<std::string>() !=
            "yaze.overworld_tile16_stencil.v1") {
          throw std::invalid_argument(
              "Stencil schema must be yaze.overworld_tile16_stencil.v1");
        }
        const int map_id = stencil.at("map_id").get<int>();
        std::vector<GuardedTileCell> cells;
        for (const auto& cell : stencil.at("cells")) {
          const auto tile = [&](const char* field) {
            const int value = cell.at(field).get<int>();
            if (value < 0 || value > 0xFFFF) {
              throw std::invalid_argument(std::string("Stencil ") + field +
                                          " must be a Tile16 ID");
            }
            return static_cast<uint16_t>(value);
          };
          cells.push_back({cell.at("x").get<int>(), cell.at("y").get<int>(),
                           tile("expected"), tile("proposed")});
        }
        const auto loaded = EnsureEditorAssetsLoaded(EditorType::kOverworld);
        auto* editors = GetCurrentEditorSet();
        auto* overworld =
            editors
                ? editors->GetEditorAs<OverworldEditor>(EditorType::kOverworld)
                : nullptr;
        if (!loaded.ok()) {
          fail(422, std::string(loaded.message()));
        } else if (!overworld) {
          fail(503, "Overworld editor is unavailable");
        } else {
          SwitchToEditor(EditorType::kOverworld, true);
          const auto changed = overworld->ApplyTile16Stencil(map_id, cells);
          if (!changed.ok()) {
            fail(absl::IsFailedPrecondition(changed.status()) ? 409 : 422,
                 std::string(changed.status().message()));
          } else {
            response["map_id"] = map_id;
            response["cells"] = cells.size();
            response["cells_changed"] = *changed;
            response["stencil_sha256"] = stencil_sha256;
          }
        }
      }
    } else if (command == "dungeon.select" || command == "proposal.load") {
      int room = -1;
      std::string path;
      if (command == "dungeon.select") {
        if (!body.at("room").is_number_integer()) {
          throw std::invalid_argument("room must be an integer from 0 to 295");
        }
        room = body.at("room").get<int>();
        if (room < 0 || room >= 296) {
          throw std::invalid_argument("room must be an integer from 0 to 295");
        }
      } else {
        path = path_argument();
      }
      if (!GetCurrentRom() || !GetCurrentRom()->is_loaded()) {
        fail(409, "No ROM loaded");
      } else {
        const auto loaded = EnsureEditorAssetsLoaded(EditorType::kDungeon);
        if (!loaded.ok()) {
          fail(422, std::string(loaded.message()));
        } else if (auto* dungeon = dungeon_editor()) {
          SwitchToEditor(EditorType::kDungeon, true);
          if (command == "dungeon.select") {
            dungeon->add_room(room);
            dungeon->FocusRoom(room);
            if (dungeon->current_room_id() != room) {
              fail(422, "Dungeon room selection did not complete");
            }
          } else {
            const auto status = dungeon->LoadProposalForReview(path);
            if (!status.ok())
              fail(422, std::string(status.message()));
          }
        } else {
          fail(503, "Dungeon editor is unavailable");
        }
      }
    } else if (command == "panel.hide") {
      const auto id = body.at("panel").get<std::string>();
      if (!window_manager_.GetWindowDescriptor(GetCurrentSessionId(), id)) {
        fail(404, "Unknown panel ID for the active session: " + id);
      } else {
        window_manager_.CloseWindow(id);
        response["panel"] = id;
        response["panel_visible"] = window_manager_.IsWindowOpen(id);
        if (response["panel_visible"].get<bool>()) {
          fail(409, "Panel did not close");
        }
      }
    } else {
      fail(400, "Unknown editor command: " + command);
    }
  } catch (const std::exception& error) {
    fail(400, error.what());
  }
  // Report the state after completion or rejection, never the requested path.
  json state;
  state["pid"] = pid;
  state["project_path"] = current_project_.filepath;
  state["session_id"] = GetCurrentSessionId();
  state["session_count"] =
      session_coordinator_ ? session_coordinator_->GetTotalSessionCount() : 0;
  state["sessions"] = json::array();
  if (session_coordinator_) {
    for (size_t i = 0; i < session_coordinator_->GetTotalSessionCount(); ++i) {
      auto* session =
          static_cast<RomSession*>(session_coordinator_->GetSession(i));
      const auto* project =
          IsCurrentProjectContextOwnedBySession(session->session_id())
              ? &current_project_
          : session->project_context.has_value() ? &*session->project_context
                                                 : nullptr;
      json item = {{"session_id", session->session_id()},
                   {"active", i == GetCurrentSessionIndex()},
                   {"loaded", session->rom.is_loaded()},
                   {"project_path", project ? project->filepath : ""},
                   {"rom_dirty", session->rom.dirty()},
                   {"unsaved", SessionHasPendingUnsavedWork(i)}};
      item["rom_path"] = session->rom.is_loaded()
                             ? json(session->rom.filename())
                             : json(nullptr);
      state["sessions"].push_back(std::move(item));
    }
  }
  state["unsaved"] = HasAnySessionPendingUnsavedWork();
  state["unsaved_detail"] = DescribeAllPendingUnsavedWork();
  state["pending_action"] = HasPendingUnsavedSessionAction();
  if (auto* rom = GetCurrentRom(); rom && rom->is_loaded()) {
    state["rom_path"] = rom->filename();
    state["rom_title"] = rom->title();
    state["rom_size"] = rom->size();
    state["rom_dirty"] = rom->dirty();
    state["rom_sha256"] = rom_sha256(*rom);
  } else {
    state["rom_path"] = nullptr;
    state["rom_sha256"] = nullptr;
  }
  state["room"] = nullptr;
  state["proposal_path"] = nullptr;
  if (auto* editors = GetCurrentEditorSet()) {
    if (auto* dungeon =
            editors->GetEditorAs<DungeonEditorV2>(EditorType::kDungeon)) {
      state["room"] = dungeon->current_room_id();
      state["proposal_path"] = dungeon->proposal_review_path();
    }
  }
  state["visible_panels"] = json::array();
  for (const auto& id :
       window_manager_.GetWindowsInSession(GetCurrentSessionId())) {
    if (window_manager_.IsWindowOpen(id)) {
      state["visible_panels"].push_back(id);
    }
  }
  response["state"] = std::move(state);
  return response.dump();
#else
  return R"({"status":"error","http_status":503,"error":"JSON support unavailable"})";
#endif
}
 
bool EditorManager::ActivateExistingSessionForOpen(
    const std::string& filename) {
  if (!session_coordinator_ || filename.empty() ||
      pending_project_open_transition_ ||
      project_manager_.IsPendingRomSelection()) {
    return false;
  }
  const bool is_project = absl::EndsWith(filename, ".yaze") ||
                          absl::EndsWith(filename, ".zsproj") ||
                          absl::EndsWith(filename, ".yazeproj");
  const size_t count = session_coordinator_->GetTotalSessionCount();
  // Prefer the active owner if an older app left duplicate sessions behind.
  for (size_t step = 0; step < count; ++step) {
    const size_t index = (GetCurrentSessionIndex() + step) % count;
    auto* session =
        static_cast<RomSession*>(session_coordinator_->GetSession(index));
    if (!session || !session->rom.is_loaded()) {
      continue;
    }
    bool matches = false;
    if (is_project) {
      const auto* project =
          IsCurrentProjectContextOwnedBySession(session->session_id())
              ? &current_project_
          : session->project_context.has_value() ? &*session->project_context
                                                 : nullptr;
      matches = project && project->project_opened() &&
                SessionCoordinator::PathsReferToSameBackingFile(
                    filename, project->filepath);
    } else {
      matches = SessionCoordinator::PathsReferToSameBackingFile(
                    filename, session->filepath) ||
                SessionCoordinator::PathsReferToSameBackingFile(
                    filename, session->rom.filename());
    }
    if (matches) {
      // Reuse the loaded buffers and editor drafts. Switching away from another
      // dirty session still follows the ordinary unsaved-work guard.
      SwitchToSession(index);
      return true;
    }
  }
  return false;
}
 
absl::Status EditorManager::OpenRomOrProject(const std::string& filename,
                                             LoadOptionsPrompt prompt) {
  if (ActivateExistingSessionForOpen(filename)) {
    return absl::OkStatus();
  }
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kOpenRomOrProjectPath,
           GetCurrentSessionId(), SIZE_MAX, filename, prompt})) {
    return absl::OkStatus();
  }
 
  return OpenRomOrProjectInternal(filename, /*allow_dialogs=*/true, prompt);
}
 
absl::Status EditorManager::OpenRomOrProjectInternal(
    const std::string& filename, bool allow_dialogs, LoadOptionsPrompt prompt) {
  LOG_INFO("EditorManager", "OpenRomOrProject called with: '%s'",
           filename.c_str());
  if (filename.empty()) {
    LOG_INFO("EditorManager", "Empty filename provided, skipping load.");
    return absl::OkStatus();
  }
  if (ActivateExistingSessionForOpen(filename)) {
    return absl::OkStatus();
  }
 
#ifdef __EMSCRIPTEN__
  // Start loading indicator early for WASM builds
  auto loading_handle =
      app::platform::WasmLoadingManager::BeginLoading("Loading ROM");
  app::platform::WasmLoadingManager::UpdateMessage(loading_handle,
                                                   "Reading ROM file...");
  // RAII guard to ensure loading indicator is closed even on early return
  struct LoadingGuard {
    app::platform::WasmLoadingManager::LoadingHandle handle;
    bool dismissed = false;
    ~LoadingGuard() {
      if (!dismissed)
        app::platform::WasmLoadingManager::EndLoading(handle);
    }
    void dismiss() { dismissed = true; }
  } loading_guard{loading_handle};
#endif
 
  if (absl::EndsWith(filename, ".yaze") ||
      absl::EndsWith(filename, ".zsproj") ||
      absl::EndsWith(filename, ".yazeproj")) {
    // Parse first so a failed project open cannot destroy the active session's
    // working context. Detach only when the incoming project is ready.
    project::YazeProject incoming_project;
    RETURN_IF_ERROR(incoming_project.Open(filename));
    if (!incoming_project.rom_filename.empty()) {
      RETURN_IF_ERROR(session_coordinator_->CheckBackingFileAvailable(
          incoming_project.rom_filename));
    }
    const std::optional<size_t> previous_session_id =
        active_project_context_session_id_;
    pending_project_open_transition_ = true;
    pending_project_open_previous_session_id_ = previous_session_id;
    DetachActiveProjectContext();
    current_project_ = std::move(incoming_project);
    SyncLayoutScopeFromCurrentProject();
    RefreshHackWorkflowBackend();
 
    // Automation cannot fall back to a file dialog for a missing/invalid ROM.
    auto project_status = LoadProjectWithRom(allow_dialogs);
    if (!project_status.ok()) {
      RestoreProjectContextAfterFailedOpen(previous_session_id);
    }
    return project_status;
  } else {
#ifdef __EMSCRIPTEN__
    app::platform::WasmLoadingManager::UpdateProgress(loading_handle, 0.05f);
    app::platform::WasmLoadingManager::UpdateMessage(loading_handle,
                                                     "Loading ROM data...");
#endif
    Rom temp_rom;
    RETURN_IF_ERROR(session_coordinator_->CheckBackingFileAvailable(filename));
    RETURN_IF_ERROR(rom_file_manager_.LoadRom(&temp_rom, filename));
    RETURN_IF_ERROR(rom_lifecycle_.CheckRomOpenPolicy(&temp_rom));
 
    const std::optional<size_t> previous_session_id =
        active_project_context_session_id_;
    const size_t previous_session_count =
        session_coordinator_->GetTotalSessionCount();
    auto session_or = session_coordinator_->CreateSessionFromRom(
        std::move(temp_rom), filename);
    if (!session_or.ok()) {
      return session_or.status();
    }
    RomSession* session = *session_or;
 
    ConfigureEditorDependencies(GetCurrentEditorSet(), GetCurrentRom(),
                                GetCurrentSessionId());
    RestoreCurrentRomIdentity();
 
    // Apply project feature flags to both session and global singleton
    session->feature_flags = current_project_.feature_flags;
    core::FeatureFlags::get() = current_project_.feature_flags;
    CaptureActiveProjectContext();
    // A choice remembered for this file applies to prompted and unprompted
    // opens alike, and has to be live before assets load.
    const bool remembered_load_options = allow_dialogs &&
                                         ui_coordinator_ != nullptr &&
                                         ApplyRememberedRomLoadChoice();
    // Ask only when nothing is remembered and no project owns the flags.
    const bool ask_for_load_options =
        prompt == LoadOptionsPrompt::kAsk && allow_dialogs &&
        ui_coordinator_ != nullptr && !remembered_load_options &&
        !current_project_.project_opened();
 
    // Keep ResourceLabelProvider in sync with the active ROM session before
    // editors register room/sprite labels.
    RefreshResourceLabelProvider();
 
    // Update test manager with current ROM for ROM-dependent tests (only when
    // tests are enabled)
#ifdef YAZE_ENABLE_TESTING
    LOG_DEBUG("EditorManager", "Setting ROM in TestManager - %p ('%s')",
              (void*)GetCurrentRom(),
              GetCurrentRom() ? GetCurrentRom()->title().c_str() : "null");
    test::TestManager::Get().SetCurrentRom(GetCurrentRom());
#endif
 
    if (auto* editor_set = GetCurrentEditorSet();
        editor_set && !current_project_.code_folder.empty()) {
      const std::string absolute_code_folder =
          current_project_.GetAbsolutePath(current_project_.code_folder);
      // iOS: avoid blocking the main thread during project open / scene updates.
      // Large iCloud-backed projects can trigger watchdog termination if we
      // eagerly enumerate folders here.
#if !(defined(__APPLE__) && TARGET_OS_IOS == 1)
      editor_set->OpenAssemblyFolder(absolute_code_folder);
#endif
      // Also set the sidebar file browser path (refresh happens during UI draw).
      window_manager_.SetFileBrowserPath("Assembly", absolute_code_folder);
    }
 
#ifdef __EMSCRIPTEN__
    app::platform::WasmLoadingManager::UpdateProgress(loading_handle, 0.10f);
    app::platform::WasmLoadingManager::UpdateMessage(loading_handle,
                                                     "Initializing editors...");
    // Pass the loading handle to LoadAssets and dismiss our guard
    // LoadAssets will manage closing the indicator when done
    loading_guard.dismiss();
    auto asset_status = LoadAssetsForMode(loading_handle);
#else
    auto asset_status = LoadAssetsForMode();
#endif
    if (!asset_status.ok()) {
      auto rollback_status =
          DiscardProvisionalSessionCreatedSince(previous_session_count);
      RestoreProjectContextAfterFailedOpen(previous_session_id);
      if (!rollback_status.ok()) {
        return absl::InternalError(
            absl::StrFormat("%s; session rollback failed: %s",
                            asset_status.message(), rollback_status.message()));
      }
      return asset_status;
    }
 
    bool is_first_time_rom_path = false;
    if (ask_for_load_options) {
      const auto& recent_files =
          project::RecentFilesManager::GetInstance().GetRecentFiles();
      is_first_time_rom_path =
          std::find(recent_files.begin(), recent_files.end(), filename) ==
          recent_files.end();
    }
    FinishRawRomOpen(remembered_load_options, ask_for_load_options,
                     is_first_time_rom_path);
    MaybeEmitZScreamRomLoadHints();
  }
  return absl::OkStatus();
}
 
absl::Status EditorManager::CreateNewProject(const std::string& template_name) {
  if (HasAnySessionPendingUnsavedWork()) {
    return absl::FailedPreconditionError(
        "Save or discard pending session work before creating a project");
  }
 
  if (!ui_coordinator_) {
    return absl::FailedPreconditionError(
        "Project creation dialog is not available");
  }
  ui_coordinator_->OpenNewProjectDialog(
      template_name.empty() ? "Vanilla ROM Hack" : template_name);
  return absl::OkStatus();
}
 
absl::Status EditorManager::CreateNewProjectFromRom(
    const std::string& template_name, const std::string& rom_path,
    const std::string& project_name, const std::string& project_path) {
  if (rom_path.empty() || project_name.empty()) {
    return absl::InvalidArgumentError("ROM path and project name are required");
  }
  if (absl::EndsWith(rom_path, ".yaze") ||
      absl::EndsWith(rom_path, ".yazeproj") ||
      absl::EndsWith(rom_path, ".zsproj")) {
    return absl::InvalidArgumentError(
        "New projects require a ROM file, not a project descriptor");
  }
  if (HasAnySessionPendingUnsavedWork()) {
    return absl::FailedPreconditionError(
        "Save or discard pending session work before creating a project");
  }
 
  auto* reusable_session = session_coordinator_
                               ? session_coordinator_->GetActiveRomSession()
                               : nullptr;
  const bool reuse_active_raw_session =
      reusable_session && reusable_session->rom.is_loaded() &&
      SessionCoordinator::PathsReferToSameBackingFile(
          rom_path, reusable_session->rom.filename()) &&
      (!current_project_.project_opened() ||
       project_manager_.IsPendingRomSelection());
  const std::optional<size_t> previous_session_id =
      active_project_context_session_id_;
  const size_t previous_session_count =
      session_coordinator_ ? session_coordinator_->GetTotalSessionCount() : 0;
  RETURN_IF_ERROR(project_manager_.CreateNewProject(template_name));
  auto rom_status = project_manager_.SetProjectRom(rom_path);
  if (!rom_status.ok()) {
    project_manager_.CancelPendingProject();
    return rom_status;
  }
  auto target_status = project_manager_.ValidateProjectCreationTarget(
      project_name, project_path);
  if (!target_status.ok()) {
    project_manager_.CancelPendingProject();
    return target_status;
  }
 
  if (reuse_active_raw_session) {
    return FinalizeNewProject(project_name, project_path);
  }
 
  DetachActiveProjectContext();
  current_project_ = project_manager_.GetCurrentProject();
  SyncLayoutScopeFromCurrentProject();
 
  // The new project, not the load options dialog, owns the flags.
  auto open_status = OpenRomOrProjectInternal(rom_path, /*allow_dialogs=*/true,
                                              LoadOptionsPrompt::kNoPrompt);
  if (!open_status.ok()) {
    project_manager_.CancelPendingProject();
    RestoreProjectContextAfterFailedOpen(previous_session_id);
    return open_status;
  }
 
  auto finalize_status = FinalizeNewProject(project_name, project_path);
  if (!finalize_status.ok()) {
    auto rollback_status =
        DiscardProvisionalSessionCreatedSince(previous_session_count);
    RestoreProjectContextAfterFailedOpen(previous_session_id);
    if (!rollback_status.ok()) {
      return absl::InternalError(absl::StrFormat(
          "%s; session rollback failed: %s", finalize_status.message(),
          rollback_status.message()));
    }
  }
  return finalize_status;
}
 
absl::Status EditorManager::FinalizeNewProject(
    const std::string& project_name, const std::string& project_path) {
  if (!session_coordinator_) {
    return absl::FailedPreconditionError("No session coordinator");
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (!session || !session->rom.is_loaded()) {
    return absl::FailedPreconditionError(
        "Load a ROM before finalizing the project");
  }
 
  // The ROM-load-options dialog can create a project directly from an
  // already-open raw ROM. Start from a clean shell in that path rather than
  // reusing ProjectManager state left by an earlier project/import.
  const bool created_project_shell = !project_manager_.IsPendingRomSelection();
  if (created_project_shell) {
    RETURN_IF_ERROR(project_manager_.CreateNewProject());
  }
 
  auto project_rom_status =
      project_manager_.SetProjectRom(session->rom.filename());
  if (!project_rom_status.ok()) {
    project_manager_.CancelPendingProject();
    return project_rom_status;
  }
  auto& pending_project = project_manager_.GetCurrentProject();
  if (created_project_shell) {
    // ROM-load options apply their selected flags directly to the raw session.
    // Guided creation already configured the pending template, including when
    // it reuses an existing raw-ROM session.
    pending_project.feature_flags = session->feature_flags;
  }
  pending_project.workspace_settings.font_global_scale =
      user_settings_.prefs().font_global_scale;
  pending_project.workspace_settings.autosave_enabled =
      user_settings_.prefs().autosave_enabled;
  pending_project.workspace_settings.autosave_interval_secs =
      user_settings_.prefs().autosave_interval;
  pending_project.workspace_settings.backup_on_save =
      user_settings_.prefs().backup_before_save;
 
  auto finalize_status =
      project_manager_.FinalizeProjectCreation(project_name, project_path);
  if (!finalize_status.ok()) {
    project_manager_.CancelPendingProject();
    return finalize_status;
  }
 
  current_project_ = project_manager_.GetCurrentProject();
  BindProjectContextToSession(session, current_project_);
  session->project_dirty = false;
  active_project_context_session_id_ = session->session_id();
  runtime_feature_flags_session_id_ = session->session_id();
  RestoreProjectContextForSession(session);
  if (version_manager_) {
    // Creating a project never creates a Git repository; the Initialize Git
    // action in Project Management is the opt-in. Adopt one that exists.
    version_manager_->AdoptExistingRepository();
    current_project_.git_repository = session->project_context->git_repository;
    BindProjectContextToSession(session, current_project_);
  }
  RebaseCleanProjectFileDraft(current_project_.filepath);
  ApplyCurrentProjectRuntimeContext();
  CaptureActiveProjectContext();
  return absl::OkStatus();
}
 
absl::Status EditorManager::OpenProject() {
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kOpenProjectDialog,
           GetCurrentSessionId()})) {
    return absl::OkStatus();
  }
 
  return OpenProjectInternal();
}
 
absl::Status EditorManager::OpenProjectInternal() {
  auto open_project_from_path =
      [this](const std::string& file_path) -> absl::Status {
    if (file_path.empty()) {
      return absl::OkStatus();
    }
    if (ActivateExistingSessionForOpen(file_path)) {
      return absl::OkStatus();
    }
 
    project::YazeProject new_project;
    RETURN_IF_ERROR(new_project.Open(file_path));
 
    if (!new_project.rom_filename.empty()) {
      RETURN_IF_ERROR(session_coordinator_->CheckBackingFileAvailable(
          new_project.rom_filename));
    }
 
    // Validate project
    auto validation_status = new_project.Validate();
    if (!validation_status.ok()) {
      toast_manager_.Show(absl::StrFormat("Project validation failed: %s",
                                          validation_status.message()),
                          editor::ToastType::kWarning, 5.0f);
 
      // Ask user if they want to repair
      popup_manager_->Show("Project Repair");
    }
 
    const std::optional<size_t> previous_session_id =
        active_project_context_session_id_;
    pending_project_open_transition_ = true;
    pending_project_open_previous_session_id_ = previous_session_id;
    DetachActiveProjectContext();
    current_project_ = std::move(new_project);
    SyncLayoutScopeFromCurrentProject();
 
    auto project_status = LoadProjectWithRom();
    if (!project_status.ok()) {
      RestoreProjectContextAfterFailedOpen(previous_session_id);
    }
    return project_status;
  };
 
#if defined(__APPLE__) && TARGET_OS_IOS == 1
  // On iOS, route project selection through the SwiftUI overlay document picker
  // so we get open-in-place + security-scoped access for iCloud Drive bundles.
  platform::ios::PostOverlayCommand("open_project");
  return absl::OkStatus();
#else
  auto file_path = util::FileDialogWrapper::ShowOpenFileDialog();
  return open_project_from_path(file_path);
#endif
}
 
absl::Status EditorManager::ValidateProjectRomSelection(
    const std::string& rom_path) {
  RETURN_IF_ERROR(session_coordinator_->CheckBackingFileAvailable(rom_path));
 
  Rom candidate_rom;
  RETURN_IF_ERROR(rom_file_manager_.LoadRom(&candidate_rom, rom_path));
  RETURN_IF_ERROR(rom_lifecycle_.CheckRomOpenPolicy(&candidate_rom));
 
  pending_project_rom_selection_ = PendingProjectRomSelection{
      .previous_path = current_project_.rom_filename,
      .candidate_path = rom_path,
  };
  return absl::OkStatus();
}
 
absl::Status EditorManager::SwapProjectRom(
    const std::string& rom_path,
    const std::optional<std::string>& expected_sha256) {
  if (rom_path.empty()) {
    return absl::InvalidArgumentError("ROM path cannot be empty");
  }
  if (!session_coordinator_) {
    return absl::FailedPreconditionError("No session coordinator");
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (!session || !session->rom.is_loaded() ||
      !current_project_.project_opened()) {
    return absl::FailedPreconditionError("No active project ROM session");
  }
  if (SessionHasPendingRomWork(GetCurrentSessionIndex()) ||
      session->editors.HasPendingProjectDraftChanges()) {
    return absl::FailedPreconditionError(
        "Save or discard ROM or project edits before swapping the project ROM");
  }
  CaptureActiveProjectEditingState();
  if (session->project_file_editor_state.initialized &&
      session->project_file_editor_state.modified &&
      ProjectFileDraftTargetsCurrentProject()) {
    return absl::FailedPreconditionError(
        "Preserve the raw project-file draft before swapping ROMs");
  }
 
  RETURN_IF_ERROR(session_coordinator_->CheckBackingFileAvailable(
      rom_path, session->session_id()));
  Rom replacement_rom;
  RETURN_IF_ERROR(rom_file_manager_.LoadRom(&replacement_rom, rom_path));
  // Bind approval to the bytes that will replace the session, not a separate
  // file read that could change before LoadRom. Reject before descriptor Save.
  if (expected_sha256 &&
      *expected_sha256 !=
          core::ComputeSourceArtifactSha256(std::string_view(
              reinterpret_cast<const char*>(replacement_rom.data()),
              replacement_rom.size()))) {
    return absl::AbortedError("Loaded candidate ROM SHA256 does not match");
  }
 
  // Save As deliberately leaves the project's collision source untouched.
  // Refuse an incompatible copy before saving the descriptor or rebuilding
  // live editor models: otherwise neither normal Save nor Build can repair
  // the newly mismatched pair. Rebinding never publishes source changes.
  if (!current_project_.custom_collision_json.empty()) {
    RETURN_IF_ERROR(ValidateRomCollisionSourceBinding(
        &replacement_rom, current_project_.GetAbsolutePath(
                              current_project_.custom_collision_json)));
  }
  RETURN_IF_ERROR(rom_lifecycle_.CheckRomRebindPolicy(&replacement_rom));
 
  std::string replacement_path = rom_path;
  if (current_project_.rom_metadata.write_policy !=
          project::RomWritePolicy::kAllow &&
      current_project_.hack_manifest.loaded() &&
      !current_project_.hack_manifest.build_pipeline().dev_rom.empty()) {
    // The policy proved this is the manifest's exact backing file. Bind its
    // canonical path so an accepted alias cannot later fail the write policy
    // or be replaced as a separate file by the atomic ROM save.
    std::error_code ec;
    const auto development_path = std::filesystem::canonical(
        current_project_.GetAbsolutePath(
            current_project_.hack_manifest.build_pipeline().dev_rom),
        ec);
    if (ec) {
      return absl::FailedPreconditionError(absl::StrFormat(
          "Cannot resolve the manifest development ROM before rebinding: %s",
          ec.message()));
    }
    replacement_path = development_path.string();
    replacement_rom.set_filename(replacement_path);
  }
 
  const std::string old_rom_path = current_project_.rom_filename;
  current_project_.rom_filename = replacement_path;
  auto save_status = current_project_.Save();
  if (!save_status.ok()) {
    current_project_.rom_filename = old_rom_path;
    return save_status;
  }
 
  BindProjectContextToSession(session, current_project_);
  auto replace_status =
      ReplaceActiveSessionRom(std::move(replacement_rom), replacement_path);
  if (!replace_status.ok()) {
    current_project_.rom_filename = old_rom_path;
    auto rollback_status = current_project_.Save();
    BindProjectContextToSession(session, current_project_);
    ApplyCurrentProjectRuntimeContext();
    if (!rollback_status.ok()) {
      return absl::InternalError(absl::StrFormat(
          "ROM swap failed (%s) and restoring the project descriptor failed "
          "(%s)",
          replace_status.message(), rollback_status.message()));
    }
    return replace_status;
  }
  session->project_dirty = false;
  if (project_management_panel_) {
    project_management_panel_->SetProjectDirty(false);
  }
  RebaseCleanProjectFileDraft(current_project_.filepath);
  CaptureActiveProjectContext();
  return absl::OkStatus();
}
 
absl::Status EditorManager::ReloadProjectRom() {
  if (!session_coordinator_) {
    return absl::FailedPreconditionError("No session coordinator");
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (!session || !session->rom.is_loaded() ||
      !current_project_.project_opened() ||
      current_project_.rom_filename.empty()) {
    return absl::FailedPreconditionError("No active project ROM to reload");
  }
  if (SessionHasPendingRomWork(GetCurrentSessionIndex()) ||
      session->editors.HasPendingProjectDraftChanges()) {
    return absl::FailedPreconditionError(
        "Save or discard ROM or project edits before reloading from disk");
  }
 
  RETURN_IF_ERROR(session_coordinator_->CheckBackingFileAvailable(
      current_project_.rom_filename, session->session_id()));
  Rom replacement_rom;
  RETURN_IF_ERROR(rom_file_manager_.LoadRom(&replacement_rom,
                                            current_project_.rom_filename));
  RETURN_IF_ERROR(rom_lifecycle_.CheckRomOpenPolicy(&replacement_rom));
  return ReplaceActiveSessionRom(std::move(replacement_rom),
                                 current_project_.rom_filename);
}
 
absl::Status EditorManager::ValidateLyraTerrainProjectContext() const {
  if (!current_project_.project_opened() || current_project_.filepath.empty()) {
    return absl::FailedPreconditionError(
        "Save a Yaze project before creating or opening Lyra terrain");
  }
  if (!IsCurrentProjectContextOwnedBySession(GetCurrentSessionId())) {
    return absl::FailedPreconditionError(
        "Lyra terrain requires its project session to be active");
  }
  auto* rom = GetCurrentRom();
  if (!rom || !rom->is_loaded() || !GetCurrentEditorSet()) {
    return absl::FailedPreconditionError(
        "Load the project's ROM before creating or opening Lyra terrain");
  }
  return absl::OkStatus();
}
 
absl::Status EditorManager::CreateLyraTerrain() {
  RETURN_IF_ERROR(ValidateLyraTerrainProjectContext());
  RETURN_IF_ERROR(EnsureEditorAssetsLoaded(EditorType::kOverworld));
  auto* overworld = GetCurrentEditorSet()->GetEditorAs<OverworldEditor>(
      EditorType::kOverworld);
  if (!overworld) {
    return absl::NotFoundError("Overworld editor is unavailable");
  }
  const auto previous_source = current_project_.lyra_terrain_file;
  RETURN_IF_ERROR(overworld->CreateLyraTerrain());
  if (previous_source != current_project_.lyra_terrain_file ||
      overworld->HasPendingProjectDraftChanges()) {
    MarkCurrentProjectDirty();
  }
  CaptureActiveProjectContext();
  SwitchToEditor(EditorType::kOverworld, true);
  return absl::OkStatus();
}
 
absl::Status EditorManager::OpenLyraTerrain() {
  RETURN_IF_ERROR(ValidateLyraTerrainProjectContext());
  util::FileDialogOptions options;
  options.filters.push_back({"Lyra terrain source", "json"});
  return OpenLyraTerrainFromPath(
      util::FileDialogWrapper::ShowOpenFileDialog(options));
}
 
absl::Status EditorManager::OpenLyraTerrainFromPath(const std::string& path) {
  if (path.empty()) {
    return absl::OkStatus();
  }
  RETURN_IF_ERROR(ValidateLyraTerrainProjectContext());
  RETURN_IF_ERROR(EnsureEditorAssetsLoaded(EditorType::kOverworld));
  auto* overworld = GetCurrentEditorSet()->GetEditorAs<OverworldEditor>(
      EditorType::kOverworld);
  if (!overworld) {
    return absl::NotFoundError("Overworld editor is unavailable");
  }
  const auto previous_source = current_project_.lyra_terrain_file;
  RETURN_IF_ERROR(overworld->OpenLyraTerrain(path));
  if (previous_source != current_project_.lyra_terrain_file) {
    MarkCurrentProjectDirty();
  }
  CaptureActiveProjectContext();
  SwitchToEditor(EditorType::kOverworld, true);
  return absl::OkStatus();
}
 
absl::Status EditorManager::SaveProject() {
  CaptureActiveProjectEditingState();
  if (session_coordinator_) {
    if (auto* session = session_coordinator_->GetActiveRomSession();
        session && session->project_file_editor_state.initialized &&
        session->project_file_editor_state.modified &&
        ProjectFileDraftTargetsCurrentProject()) {
      return absl::FailedPreconditionError(
          "Raw project file also has unsaved changes; use raw Save As to "
          "preserve that draft before saving project settings");
    }
  }
  auto* save_session = session_coordinator_
                           ? session_coordinator_->GetActiveRomSession()
                           : nullptr;
  if (save_session != nullptr && IsPlanningOnlyProjectSave(*save_session)) {
    // The plan is a live reference outside the build: its own CAS save is the
    // whole Save, leaving the descriptor and native receipt untouched.
    return save_session->editors.SavePlanningProjectDraft();
  }
  // Every other project Save commits build-owned work: the descriptor and
  // any terrain/sprite/dungeon drafts. Retire the prior native commit before
  // any of those bytes change.
  const bool build_owned =
      current_project_.project_opened() && save_session != nullptr;
  if (build_owned) {
    RETURN_IF_ERROR(RetireNativeSaveTransfer("rebound"));
  }
  RETURN_IF_ERROR(PrepareActiveProjectEditorDraftsForSave());
  CaptureActiveProjectContext();
  if (!current_project_.project_opened()) {
    return CreateNewProject();
  }
 
  ApplyProjectSaveSettings(&current_project_, /*include_recent_files=*/true);
 
  auto status = current_project_.Save();
  if (status.ok()) {
    if (auto* editors = GetCurrentEditorSet())
      editors->ProjectSaveCommitted();
    if (project_management_panel_) {
      project_management_panel_->SetProjectDirty(false);
    }
    if (session_coordinator_) {
      if (auto* session = session_coordinator_->GetActiveRomSession()) {
        session->project_dirty = false;
      }
    }
    RebaseCleanProjectFileDraft(current_project_.filepath);
  }
  CaptureActiveProjectContext();
  if (!status.ok() || !build_owned) {
    return status;
  }
  save_session->native_save_completion_pending = true;
  if (defer_project_native_completion_) {
    return absl::OkStatus();
  }
  return CompletePendingProjectNativeSave();
}
 
void EditorManager::ApplyProjectSaveSettings(project::YazeProject* project,
                                             bool include_recent_files) {
  if (!GetCurrentRom() || !GetCurrentEditorSet()) {
    return;
  }
  if (session_coordinator_) {
    if (auto* session = session_coordinator_->GetActiveRomSession()) {
      project->feature_flags = session->feature_flags;
    }
  }
  project->workspace_settings.font_global_scale =
      user_settings_.prefs().font_global_scale;
  project->workspace_settings.autosave_enabled =
      user_settings_.prefs().autosave_enabled;
  project->workspace_settings.autosave_interval_secs =
      user_settings_.prefs().autosave_interval;
  project->workspace_settings.backup_on_save =
      user_settings_.prefs().backup_before_save;
  if (!include_recent_files) {
    return;
  }
  auto& manager = project::RecentFilesManager::GetInstance();
  project->workspace_settings.recent_files.clear();
  for (const auto& file : manager.GetRecentFiles()) {
    project->workspace_settings.recent_files.push_back(file);
  }
}
 
// True when a project Save would write the descriptor bytes already on disk,
// apart from its timestamp and the recent-files list, which are not build
// inputs.
bool EditorManager::ProjectDescriptorMatchesDisk() {
  if (current_project_.filepath.empty() ||
      current_project_.music_persistence.storage_key.empty()) {
    return false;
  }
  CaptureActiveProjectContext();
  project::YazeProject candidate = current_project_;
  ApplyProjectSaveSettings(&candidate, /*include_recent_files=*/false);
  candidate.NormalizePathsToAbsolute();
  const auto serialized = candidate.SerializeToString();
  std::ifstream input(current_project_.filepath, std::ios::binary);
  if (!serialized.ok() || !input.is_open()) {
    return false;
  }
  const std::string on_disk((std::istreambuf_iterator<char>(input)),
                            std::istreambuf_iterator<char>());
  return !input.bad() && on_disk == *serialized;
}
 
bool EditorManager::IsPlanningOnlyProjectSave(const RomSession& session) {
  return current_project_.project_opened() && !session.project_dirty &&
         !session.native_save_completion_pending &&
         !(session.project_file_editor_state.initialized &&
           session.project_file_editor_state.modified) &&
         !session.editors.HasPendingBuildProjectDraftChanges() &&
         session.editors.HasPendingPlanningProjectDraftChanges() &&
         ProjectDescriptorMatchesDisk();
}
 
void EditorManager::MarkCurrentProjectDirty() {
  if (project_management_panel_) {
    project_management_panel_->SetProjectDirty(true);
  }
  if (session_coordinator_) {
    if (auto* session = session_coordinator_->GetActiveRomSession()) {
      session->project_dirty = true;
    }
  }
}
 
bool EditorManager::IsCurrentProjectDirty() const {
  if (!session_coordinator_) {
    return project_management_panel_ &&
           project_management_panel_->IsProjectDirty();
  }
  const auto* session = session_coordinator_->GetActiveRomSession();
  return session != nullptr &&
         (session->project_dirty ||
          session->editors.HasPendingProjectDraftChanges());
}
 
absl::Status EditorManager::SaveActiveProjectEditingWork(bool allow_dialogs) {
  if (!session_coordinator_) {
    return absl::FailedPreconditionError("No session coordinator");
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (!session) {
    return absl::FailedPreconditionError("No active ROM session");
  }
 
  if (auto* graphics = static_cast<GraphicsEditor*>(
          session->editors.GetExistingEditor(EditorType::kGraphics))) {
    RETURN_IF_ERROR(graphics->SaveScratchAssets());
  }
 
  if (session->editors.HasPendingSpriteChanges()) {
    auto* sprite = static_cast<SpriteEditor*>(
        session->editors.GetExistingEditor(EditorType::kSprite));
    RETURN_IF_ERROR(allow_dialogs ? sprite->Save() : sprite->SaveForAutosave());
  }
 
  CaptureActiveProjectEditingState();
  const bool project_dirty = session->project_dirty ||
                             session->editors.HasPendingProjectDraftChanges();
  const bool project_file_dirty =
      session->project_file_editor_state.initialized &&
      session->project_file_editor_state.modified;
 
  if (project_dirty && project_file_dirty &&
      ProjectFileDraftTargetsCurrentProject()) {
    return absl::FailedPreconditionError(
        "Project settings and raw project file both have unsaved changes; "
        "use raw Save As to preserve the draft, then save project settings");
  }
 
  if (project_dirty) {
    if (!current_project_.project_opened() ||
        current_project_.filepath.empty()) {
      return absl::FailedPreconditionError(
          "Project settings have no project file to save");
    }
    RETURN_IF_ERROR(SaveProject());
  }
 
  if (project_file_dirty) {
    if (project_file_editor_.filepath().empty()) {
      return absl::FailedPreconditionError(
          "Project file draft has no destination; use Save As first");
    }
    RETURN_IF_ERROR(project_file_editor_.SaveFile());
    session->project_file_editor_state = project_file_editor_.CaptureState();
  }
 
  return absl::OkStatus();
}
 
absl::Status EditorManager::AutosaveActiveSession() {
  if (!session_coordinator_) {
    return absl::FailedPreconditionError("No session coordinator");
  }
  const size_t session_index = GetCurrentSessionIndex();
  RETURN_IF_ERROR(SaveProjectWorkBeforeRomSave(/*allow_dialogs=*/false));
  const auto* session = session_coordinator_->GetActiveRomSession();
  if (session != nullptr && session->backup_restore_pending) {
    return absl::CancelledError(
        "Staged backup restore requires an explicit Save ROM");
  }
  if (SessionHasPendingRomWork(session_index)) {
    RETURN_IF_ERROR(SaveRom());
  } else {
    RETURN_IF_ERROR(CompletePendingProjectNativeSave());
  }
  if (SessionHasPendingUnsavedWork(session_index)) {
    return absl::FailedPreconditionError(
        "Autosave left unsaved project or ROM work");
  }
  return absl::OkStatus();
}
 
void EditorManager::ResolvePotItemSaveConfirmation(
    PotItemSaveDecision decision) {
  // Map EditorManager enum to RomLifecycleManager enum
  auto lifecycle_decision =
      static_cast<RomLifecycleManager::PotItemSaveDecision>(
          static_cast<int>(decision));
  rom_lifecycle_.ResolvePotItemSaveConfirmation(lifecycle_decision);
 
  if (decision == PotItemSaveDecision::kCancel) {
    CancelPendingRomSave();
    toast_manager_.Show("Save cancelled", ToastType::kInfo);
    return;
  }
 
  auto status = ResumePendingRomSave();
  if (!absl::IsCancelled(status) && !status.ok()) {
    toast_manager_.Show(
        absl::StrFormat("Failed to save ROM: %s", status.message()),
        ToastType::kError);
  }
}
 
absl::Status EditorManager::SaveProjectAs() {
  // Get current project name for default filename
  std::string default_name = current_project_.project_opened()
                                 ? current_project_.GetDisplayName()
                                 : "untitled_project";
 
  auto file_path =
      util::FileDialogWrapper::ShowSaveFileDialog(default_name, "yaze");
  if (file_path.empty()) {
    return absl::OkStatus();
  }
 
  return SaveProjectAs(file_path);
}
 
absl::Status EditorManager::SaveProjectAs(const std::string& filepath) {
  if (filepath.empty()) {
    return absl::InvalidArgumentError("Project file path cannot be empty");
  }
  CaptureActiveProjectEditingState();
  std::string file_path = filepath;
 
  // Ensure a project extension.
  if (!(absl::EndsWith(file_path, ".yaze") ||
        absl::EndsWith(file_path, ".yazeproj"))) {
    file_path += ".yaze";
  }
  if (SessionCoordinator::PathsReferToSameBackingFile(current_project_.filepath,
                                                      file_path)) {
    return SaveProject();
  }
  if (auto* editors = GetCurrentEditorSet();
      editors && editors->HasPendingPlanningProjectDraftChanges()) {
    return absl::FailedPreconditionError(
        "Save or discard plan edits before saving the project to another file");
  }
 
  if (session_coordinator_) {
    if (auto* session = session_coordinator_->GetActiveRomSession();
        session && session->project_file_editor_state.initialized &&
        session->project_file_editor_state.modified &&
        SessionCoordinator::PathsReferToSameBackingFile(
            session->project_file_editor_state.filepath, file_path)) {
      return absl::FailedPreconditionError(
          "Raw project draft targets the selected file; preserve it with "
          "raw Save As before overwriting that destination");
    }
  }
 
  OverworldEditor* lyra_editor = nullptr;
  if (current_project_.IsOracleCompatible() ||
      !current_project_.lyra_terrain_file.empty()) {
    RETURN_IF_ERROR(ValidateLyraTerrainProjectContext());
    RETURN_IF_ERROR(EnsureEditorAssetsLoaded(EditorType::kOverworld));
    lyra_editor = GetCurrentEditorSet()->GetEditorAs<OverworldEditor>(
        EditorType::kOverworld);
    if (!lyra_editor || !lyra_editor->lyra_canvas_.loaded()) {
      return lyra_editor && !lyra_editor->lyra_canvas_status_.ok()
                 ? lyra_editor->lyra_canvas_status_
                 : absl::FailedPreconditionError(
                       "Project Lyra terrain is unavailable");
    }
  }
  // Dungeon property drafts still join the saved descriptor. Lyra publishes
  // directly into its new owner instead of flushing into the original source.
  // Refuse the rebind before writing either owner if the previous native
  // transfer cannot be durably retired. A failed Save As leaves it retired.
  RETURN_IF_ERROR(RetireNativeSaveTransfer("rebound"));
  RETURN_IF_ERROR(PrepareActiveProjectEditorDraftsForSave(
      /*publish_lyra=*/lyra_editor == nullptr));
  CaptureActiveProjectContext();
 
  std::string old_filepath = current_project_.filepath;
  absl::Status save_status;
  if (lyra_editor) {
    save_status =
        lyra_editor->SaveProjectTerrainAs(&current_project_, file_path);
  } else {
    current_project_.filepath = file_path;
    save_status = current_project_.Save();
  }
  if (save_status.ok()) {
    if (auto* editors = GetCurrentEditorSet())
      editors->ProjectSaveCommitted();
    if (project_management_panel_) {
      project_management_panel_->SetProjectDirty(false);
    }
    if (session_coordinator_) {
      if (auto* session = session_coordinator_->GetActiveRomSession()) {
        session->project_dirty = false;
      }
    }
    SyncLayoutScopeFromCurrentProject();
    RebaseCleanProjectFileDraft(file_path);
 
    // Add to recent files
    auto& manager = project::RecentFilesManager::GetInstance();
    manager.AddFile(file_path);
    manager.Save();
 
    const auto catalog_path = core::PaletteCatalog::ResolvePathForProject(
        file_path, current_project_.palette_catalog_file);
    if (!current_project_.palette_catalog_file.empty() &&
        absl::IsInvalidArgument(catalog_path.status())) {
      toast_manager_.Show(
          absl::StrFormat(
              "Project saved as: %s. Its palette catalog cannot load from this "
              "folder. Copy the catalog into the new project folder, then "
              "update palette_catalog_file in Edit Project File.",
              file_path),
          editor::ToastType::kWarning, 10.0f);
    } else {
      toast_manager_.Show(absl::StrFormat("Project saved as: %s", file_path),
                          editor::ToastType::kSuccess);
    }
  } else {
    // Restore old filepath on failure
    current_project_.filepath = old_filepath;
    toast_manager_.Show(
        absl::StrFormat("Failed to save project: %s", save_status.message()),
        editor::ToastType::kError);
  }
 
  CaptureActiveProjectContext();
 
  if (!save_status.ok()) {
    return save_status;
  }
  const auto retirement = RetireNativeSaveTransfer("rebound");
  if (!retirement.ok()) {
    return absl::FailedPreconditionError(
        "Project saved as, but its retired native-save context could not be "
        "updated: " +
        std::string(retirement.message()));
  }
  // The new owner's receipt is part of Save As; a failed completion stays
  // pending so a Save without new edits retries it.
  if (auto* session = session_coordinator_
                          ? session_coordinator_->GetActiveRomSession()
                          : nullptr) {
    session->native_save_completion_pending = true;
    session->native_save_completion_save_as = true;
  }
  return CompletePendingProjectNativeSave();
}
 
absl::StatusOr<std::string> EditorManager::ResolveProjectBuildCommand() {
  if (!current_project_.project_opened()) {
    return absl::FailedPreconditionError("No project open");
  }
  if (current_project_.rom_metadata.write_policy ==
      project::RomWritePolicy::kReadOnly) {
    return absl::PermissionDeniedError(
        "Build Project is disabled by the project's read-only policy");
  }
 
  // A Build button can run during the panel's Draw() before the frame-end
  // project draft capture. Read the live panel and raw editor state now.
  CaptureActiveProjectEditingState();
  if (auto* editors = GetCurrentEditorSet()) {
    const auto* dungeon =
        editors->GetEditorAs<DungeonEditorV2>(EditorType::kDungeon);
    if (dungeon && dungeon->HasUnpublishedMinecartTrackChanges()) {
      return absl::FailedPreconditionError(
          "Minecart tracks have unpublished changes. Use Publish Tracks, then "
          "save remaining project and ROM changes before Build Project. "
          "Undo the track edits if you do not want to publish them.");
    }
  }
  const size_t session_index = GetCurrentSessionIndex();
  if (SessionHasPendingUnsavedWork(session_index)) {
    return absl::FailedPreconditionError(
        absl::StrFormat("Save project and ROM changes before building: %s",
                        DescribePendingUnsavedWork(session_index)));
  }
 
  const Rom* active_rom = GetCurrentRom();
  if (active_rom != nullptr && active_rom->is_loaded() &&
      !current_project_.rom_filename.empty() &&
      !SessionCoordinator::PathsReferToSameBackingFile(
          active_rom->filename(),
          current_project_.GetAbsolutePath(current_project_.rom_filename))) {
    return absl::FailedPreconditionError(absl::StrFormat(
        "Build source mismatch: active ROM %s differs from project ROM %s. "
        "Use Project Management > Swap ROM to bind the saved copy, or reopen "
        "the project's ROM before building.",
        active_rom->filename(),
        current_project_.GetAbsolutePath(current_project_.rom_filename)));
  }
 
  std::string command = current_project_.build_script;
  if (command.empty() && current_project_.hack_manifest.loaded()) {
    const auto& pipeline = current_project_.hack_manifest.build_pipeline();
    if (!pipeline.dev_rom.empty() && !current_project_.rom_filename.empty() &&
        !SessionCoordinator::PathsReferToSameBackingFile(
            current_project_.GetAbsolutePath(pipeline.dev_rom),
            current_project_.GetAbsolutePath(current_project_.rom_filename))) {
      return absl::FailedPreconditionError(absl::StrFormat(
          "Build source mismatch: manifest development ROM %s differs from "
          "project ROM %s.",
          current_project_.GetAbsolutePath(pipeline.dev_rom),
          current_project_.GetAbsolutePath(current_project_.rom_filename)));
    }
    command = pipeline.build_script;
    // Manifest build_script is normally a path. Do not parse arbitrary shell
    // commands here; only check a single, unquoted file-path token.
    if (!command.empty() &&
        command.find_first_of(" \t\r\n|&;<>()$`'\"\\") == std::string::npos) {
      const std::filesystem::path script_path(command);
      if (script_path.is_absolute() || script_path.has_parent_path() ||
          script_path.extension() == ".sh") {
        const std::string absolute_script =
            current_project_.GetAbsolutePath(command);
        std::error_code ec;
        if (!std::filesystem::is_regular_file(absolute_script, ec)) {
          return absl::FailedPreconditionError(absl::StrFormat(
              "Manifest build script is unavailable: %s. Configure a build "
              "script for this project before building.",
              absolute_script));
        }
      }
    }
  }
  if (command.empty()) {
    return absl::NotFoundError("Project does not define a build command");
  }
  return command;
}
 
absl::StatusOr<std::string> EditorManager::ResolveProjectRunTarget() const {
  if (!current_project_.project_opened()) {
    return absl::FailedPreconditionError("No project open");
  }
 
  ASSIGN_OR_RETURN(const auto expanded,
                   current_project_.ResolveExpandedBuildRunTarget(
                       NativeSaveEditingSourcePath()));
  if (expanded) {
    return *expanded;
  }
 
  std::string target;
  if (current_project_.hack_manifest.loaded()) {
    target = current_project_.hack_manifest.build_pipeline().patched_rom;
  }
  if (target.empty()) {
    target = current_project_.build_target;
  }
  if (target.empty()) {
    return absl::NotFoundError("Project does not define a run target ROM");
  }
  return current_project_.GetAbsolutePath(target);
}
 
ProjectWorkflowStatus EditorManager::MakeBuildStatus(
    const std::string& summary, const std::string& detail,
    ProjectWorkflowState state, const std::string& output_tail,
    bool can_cancel) const {
  return {.visible = true,
          .can_cancel = can_cancel,
          .label = "Build",
          .summary = summary,
          .detail = detail,
          .output_tail = output_tail,
          .state = state};
}
 
ProjectWorkflowStatus EditorManager::MakeRunStatus(
    const std::string& summary, const std::string& detail,
    ProjectWorkflowState state) const {
  return {.visible = true,
          .label = "Run",
          .summary = summary,
          .detail = detail,
          .state = state};
}
 
absl::StatusOr<std::string> EditorManager::RunProjectBuildCommand() {
  auto command_or = ResolveProjectBuildCommand();
  if (!command_or.ok()) {
    return command_or.status();
  }
 
  const std::string command = *command_or;
  const std::filesystem::path project_root =
      std::filesystem::path(current_project_.filepath).parent_path();
  ASSIGN_OR_RETURN(
      auto environment,
      ProjectBuildEnvironment(current_project_, NativeSaveEditingSourcePath()));
  BackgroundCommandTask task;
  auto start_status = task.Start(command, project_root.string(), environment);
  if (!start_status.ok()) {
    return start_status;
  }
  auto wait_status = task.Wait();
  const auto snapshot = task.GetSnapshot();
  if (!wait_status.ok()) {
    return wait_status;
  }
  const std::string summary = LastNonEmptyLine(snapshot.output);
  return summary.empty() ? command : summary;
}
 
absl::Status EditorManager::BuildCurrentProject() {
  const std::string running_detail =
      "Running the configured project build command";
  UpdateBuildWorkflowStatus(
      &status_bar_, project_management_panel_.get(),
      MakeBuildStatus("Build running", running_detail,
                      ProjectWorkflowState::kRunning, "", false));
 
  auto result_or = RunProjectBuildCommand();
  if (!result_or.ok()) {
    const bool unavailable =
        result_or.status().code() == absl::StatusCode::kFailedPrecondition ||
        result_or.status().code() == absl::StatusCode::kNotFound;
    UpdateBuildWorkflowStatus(
        &status_bar_, project_management_panel_.get(),
        MakeBuildStatus(unavailable ? "Build unavailable" : "Build failed",
                        std::string(result_or.status().message()),
                        ProjectWorkflowState::kFailure));
    toast_manager_.Show(
        absl::StrFormat("%s: %s",
                        unavailable ? "Build unavailable" : "Build failed",
                        result_or.status().message()),
        ToastType::kWarning);
    return result_or.status();
  }
 
  const std::string summary = *result_or;
  UpdateBuildWorkflowStatus(&status_bar_, project_management_panel_.get(),
                            MakeBuildStatus("Build succeeded", summary,
                                            ProjectWorkflowState::kSuccess));
  toast_manager_.Show(
      summary.empty() ? "Project build completed"
                      : absl::StrFormat("Project build completed: %s", summary),
      ToastType::kSuccess);
  LOG_INFO("EditorManager", "Project build completed: %s", summary.c_str());
  return absl::OkStatus();
}
 
void EditorManager::QueueBuildCurrentProject() {
  if (active_project_build_) {
    const auto snapshot = active_project_build_->GetSnapshot();
    if (snapshot.running) {
      toast_manager_.Show("A project build is already running",
                          ToastType::kInfo);
      return;
    }
  }
 
  auto command_or = ResolveProjectBuildCommand();
  if (!command_or.ok()) {
    UpdateBuildWorkflowStatus(
        &status_bar_, project_management_panel_.get(),
        MakeBuildStatus("Build unavailable",
                        std::string(command_or.status().message()),
                        ProjectWorkflowState::kFailure));
    toast_manager_.Show(
        absl::StrFormat("Build unavailable: %s", command_or.status().message()),
        ToastType::kWarning);
    return;
  }
 
  const std::filesystem::path project_root =
      std::filesystem::path(current_project_.filepath).parent_path();
  auto environment =
      ProjectBuildEnvironment(current_project_, NativeSaveEditingSourcePath());
  active_project_build_ = std::make_unique<BackgroundCommandTask>();
  auto start_status =
      environment.ok() ? active_project_build_->Start(
                             *command_or, project_root.string(), *environment)
                       : environment.status();
  if (!start_status.ok()) {
    UpdateBuildWorkflowStatus(
        &status_bar_, project_management_panel_.get(),
        MakeBuildStatus("Build unavailable",
                        std::string(start_status.message()),
                        ProjectWorkflowState::kFailure));
    toast_manager_.Show(
        absl::StrFormat("Build unavailable: %s", start_status.message()),
        ToastType::kWarning);
    active_project_build_.reset();
    return;
  }
 
  active_project_build_reported_ = false;
  UpdateBuildWorkflowStatus(
      &status_bar_, project_management_panel_.get(),
      MakeBuildStatus("Build running",
                      "Running the configured project build command",
                      ProjectWorkflowState::kRunning, "", true));
  if (project_management_panel_) {
    project_management_panel_->SetBuildLogOutput("");
  }
  ContentRegistry::Context::SetBuildWorkflowLog("");
}
 
void EditorManager::CancelQueuedProjectBuild() {
  if (!active_project_build_) {
    return;
  }
 
  const auto snapshot = active_project_build_->GetSnapshot();
  if (!snapshot.running) {
    return;
  }
 
  active_project_build_->Cancel();
  UpdateBuildWorkflowStatus(
      &status_bar_, project_management_panel_.get(),
      MakeBuildStatus("Cancelling build", "Stopping the active project build",
                      ProjectWorkflowState::kRunning, snapshot.output_tail,
                      false));
}
 
absl::Status EditorManager::RunCurrentProject() {
  UpdateRunWorkflowStatus(
      &status_bar_, project_management_panel_.get(),
      MakeRunStatus("Run queued",
                    "Preparing the project output for emulator reload",
                    ProjectWorkflowState::kRunning));
 
  auto run_target_or = ResolveProjectRunTarget();
  if (!run_target_or.ok()) {
    UpdateRunWorkflowStatus(
        &status_bar_, project_management_panel_.get(),
        MakeRunStatus("Run unavailable",
                      std::string(run_target_or.status().message()),
                      ProjectWorkflowState::kFailure));
    toast_manager_.Show(absl::StrFormat("Run unavailable: %s",
                                        run_target_or.status().message()),
                        ToastType::kWarning);
    return run_target_or.status();
  }
  const std::string run_target = *run_target_or;
  if (!std::filesystem::exists(run_target)) {
    UpdateRunWorkflowStatus(&status_bar_, project_management_panel_.get(),
                            MakeRunStatus("Run target missing", run_target,
                                          ProjectWorkflowState::kFailure));
    toast_manager_.Show("Run target ROM not found. Build the project first.",
                        ToastType::kWarning);
    return absl::NotFoundError("Run target ROM not found");
  }
 
#ifdef YAZE_WITH_GRPC
  if (auto* emulator_backend = Application::Instance().GetEmulatorBackend()) {
    auto load_status = emulator_backend->LoadRom(run_target);
    if (load_status.ok()) {
      AppendWorkflowHistoryEntry(
          "Run",
          MakeRunStatus("Reloaded in backend", run_target,
                        ProjectWorkflowState::kSuccess),
          "");
      UpdateRunWorkflowStatus(&status_bar_, project_management_panel_.get(),
                              MakeRunStatus("Reloaded in backend", run_target,
                                            ProjectWorkflowState::kSuccess));
      if (ui_coordinator_) {
        ui_coordinator_->SetEmulatorVisible(true);
      }
      toast_manager_.Show(
          absl::StrFormat("Reloaded project output in emulator backend: %s",
                          run_target),
          ToastType::kInfo);
      return absl::OkStatus();
    }
  }
#endif
 
  Rom temp_rom;
  auto load_rom_status = rom_file_manager_.LoadRom(&temp_rom, run_target);
  if (!load_rom_status.ok()) {
    UpdateRunWorkflowStatus(
        &status_bar_, project_management_panel_.get(),
        MakeRunStatus("Run load failed", std::string(load_rom_status.message()),
                      ProjectWorkflowState::kFailure));
    toast_manager_.Show(absl::StrFormat("Failed to load run target ROM: %s",
                                        load_rom_status.message()),
                        ToastType::kError);
    return load_rom_status;
  }
 
  auto reload_status = emulator_.ReloadRuntimeRom(temp_rom.vector());
  if (!reload_status.ok()) {
    UpdateRunWorkflowStatus(
        &status_bar_, project_management_panel_.get(),
        MakeRunStatus("Reload failed", std::string(reload_status.message()),
                      ProjectWorkflowState::kFailure));
    toast_manager_.Show(absl::StrFormat("Failed to reload emulator runtime: %s",
                                        reload_status.message()),
                        ToastType::kError);
    return reload_status;
  }
 
  if (ui_coordinator_) {
    ui_coordinator_->SetEmulatorVisible(true);
  }
  AppendWorkflowHistoryEntry("Run",
                             MakeRunStatus("Reloaded in emulator", run_target,
                                           ProjectWorkflowState::kSuccess),
                             "");
  UpdateRunWorkflowStatus(&status_bar_, project_management_panel_.get(),
                          MakeRunStatus("Reloaded in emulator", run_target,
                                        ProjectWorkflowState::kSuccess));
  toast_manager_.Show(
      absl::StrFormat("Reloaded project output in emulator: %s", run_target),
      ToastType::kInfo);
  return absl::OkStatus();
}
 
absl::Status EditorManager::ImportProject(const std::string& project_path) {
  // Delegate to ProjectManager for import logic
  RETURN_IF_ERROR(project_manager_.ImportProject(project_path));
  // Sync local project reference
  DetachActiveProjectContext();
  current_project_ = project_manager_.GetCurrentProject();
  if (session_coordinator_) {
    if (auto* session = session_coordinator_->GetActiveRomSession()) {
      BindProjectContextToSession(session, current_project_);
      RestoreProjectContextForSession(session);
    }
  }
  SyncLayoutScopeFromCurrentProject();
  RefreshHackWorkflowBackend();
  return absl::OkStatus();
}
 
absl::Status EditorManager::RepairCurrentProject() {
  if (!current_project_.project_opened()) {
    return absl::FailedPreconditionError("No project is currently open");
  }
 
  RETURN_IF_ERROR(current_project_.RepairProject());
  CaptureActiveProjectContext();
  toast_manager_.Show("Project repaired successfully",
                      editor::ToastType::kSuccess);
 
  return absl::OkStatus();
}
 
yaze::zelda3::Overworld* EditorManager::overworld() const {
  if (auto* editor_set = GetCurrentEditorSet()) {
    return editor_set->GetOverworldData();
  }
  return nullptr;
}
 
absl::Status EditorManager::SetCurrentRom(Rom* rom) {
  if (!rom) {
    return absl::InvalidArgumentError("Invalid ROM pointer");
  }
 
  // We need to find the session that owns this ROM.
  // This is inefficient but SetCurrentRom is rare.
  if (session_coordinator_) {
    for (size_t i = 0; i < session_coordinator_->GetTotalSessionCount(); ++i) {
      auto* session =
          static_cast<RomSession*>(session_coordinator_->GetSession(i));
      if (session && &session->rom == rom) {
        session_coordinator_->SwitchToSession(i);
        if (GetCurrentRom() != rom) {
          return absl::FailedPreconditionError(
              "The requested ROM session could not be activated");
        }
        // Update test manager with current ROM for ROM-dependent tests
        test::TestManager::Get().SetCurrentRom(GetCurrentRom());
        RefreshResourceLabelProvider();
        RestoreCurrentRomIdentity();
        return absl::OkStatus();
      }
    }
  }
  // If ROM wasn't found in existing sessions, treat as new session.
  // Copying an external ROM object is avoided; instead, fail.
  return absl::NotFoundError("ROM not found in existing sessions");
}
 
void EditorManager::ApplyDefaultBackupPolicy() {
  rom_lifecycle_.ApplyDefaultBackupPolicy(
      user_settings_.prefs().backup_before_save, "", 20, true, 14);
}
 
void EditorManager::CaptureCurrentRomIdentity(bool preserve_editing_source) {
  if (session_coordinator_) {
    if (auto* session = session_coordinator_->GetActiveRomSession()) {
      session->CaptureRomIdentity(preserve_editing_source);
    }
  }
  RestoreCurrentRomIdentity();
}
 
void EditorManager::RestoreCurrentRomIdentity() {
  rom_lifecycle_.ActivateRomIdentity(
      session_coordinator_ ? session_coordinator_->GetActiveRomSession()
                           : nullptr);
}
 
// IsRomHashMismatch() is now inline in editor_manager.h delegating to
// rom_lifecycle_.
 
std::vector<RomFileManager::BackupEntry> EditorManager::GetRomBackups() const {
  return rom_lifecycle_.GetRomBackups(GetCurrentRom());
}
 
bool EditorManager::IsRomBackupRestorePending() const {
  if (!session_coordinator_) {
    return false;
  }
  const auto* session = session_coordinator_->GetActiveRomSession();
  return session != nullptr && session->backup_restore_pending;
}
 
absl::Status EditorManager::RestoreRomBackup(const std::string& backup_path) {
  auto* rom = GetCurrentRom();
  if (!rom) {
    return absl::FailedPreconditionError("No ROM loaded");
  }
  if (SessionHasPendingRomWork(GetCurrentSessionIndex())) {
    return absl::FailedPreconditionError(
        "Save or discard ROM edits before restoring a backup");
  }
 
  const std::string original_filename = rom->filename();
  const project::ResourceLabelManager original_resource_labels =
      *rom->resource_label();
  const auto backups = rom_file_manager_.ListBackups(original_filename);
  const bool is_managed_backup =
      std::any_of(backups.begin(), backups.end(), [&](const auto& backup) {
        return SessionCoordinator::PathsReferToSameBackingFile(backup.path,
                                                               backup_path);
      });
  if (!is_managed_backup) {
    return absl::InvalidArgumentError(
        "Selected file is not a managed backup for the active ROM");
  }
 
  // Load the backup away from the live session. Backups may legitimately have
  // a different size when they predate a ROM expansion or shrink. Reusing the
  // ROM-replacement path restores the prior ROM bytes and backing identity if
  // rebuilding assets fails partway through.
  Rom restored_rom;
  RETURN_IF_ERROR(rom_file_manager_.LoadRom(&restored_rom, backup_path));
 
  if (!original_filename.empty()) {
    restored_rom.set_filename(original_filename);
  }
  RETURN_IF_ERROR(rom_lifecycle_.CheckRomOpenPolicy(&restored_rom));
  // Normal ROM backups do not copy the active `.labels` sidecar. Preserve the
  // session's loaded and in-memory resource labels instead of replacing them
  // with the usually-empty `<backup>.labels` lookup from LoadFromFile().
  *restored_rom.resource_label() = original_resource_labels;
  // Restore is intentionally staged in memory. Mark it dirty so closing or
  // autosave cannot silently treat the on-disk source as already restored.
  restored_rom.set_dirty(true);
  RETURN_IF_ERROR(
      ReplaceActiveSessionRom(std::move(restored_rom), original_filename));
  auto* restored_session = session_coordinator_->GetActiveRomSession();
  if (!restored_session) {
    return absl::InternalError(
        "ROM backup restored without an active session to stage it");
  }
  restored_session->backup_restore_pending = true;
  return absl::OkStatus();
}
 
absl::Status EditorManager::DiscardPendingRomBackupRestore() {
  if (!session_coordinator_) {
    return absl::FailedPreconditionError("No session coordinator");
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  if (!session || !session->rom.is_loaded()) {
    return absl::FailedPreconditionError("No ROM loaded");
  }
  if (!session->backup_restore_pending) {
    return absl::FailedPreconditionError("No restored backup is staged");
  }
 
  const size_t session_index = GetCurrentSessionIndex();
  if (session->editors.HasPendingSpriteChanges() ||
      session->editors.HasPendingGraphicsChanges() ||
      session->HasPendingGfxGroupChanges() ||
      session->editors.HasPendingScreenChanges() ||
      HasPendingDungeonChangesForSession(session_index) ||
      gfx::PaletteManager::Get().HasUnsavedChanges(&session->game_data)) {
    return absl::FailedPreconditionError(
        "Resolve pending graphics, screen, dungeon, or palette edits before "
        "discarding the restored backup");
  }
 
  const std::string backing_path = session->rom.filename();
  if (backing_path.empty()) {
    return absl::FailedPreconditionError("ROM has no backing file to reload");
  }
 
  // Load into scratch storage before touching the live session so file I/O
  // failures preserve the staged ROM. Resource labels are session work, not
  // part of normal ROM backups, so preserve them across the byte-level discard.
  const project::ResourceLabelManager resource_labels =
      *session->rom.resource_label();
  Rom backing_rom;
  RETURN_IF_ERROR(rom_file_manager_.LoadRom(&backing_rom, backing_path));
  *backing_rom.resource_label() = resource_labels;
  RETURN_IF_ERROR(
      ReplaceActiveSessionRom(std::move(backing_rom), backing_path));
 
  session->backup_restore_pending = false;
  session->rom.ClearDirty();
  return absl::OkStatus();
}
 
absl::Status EditorManager::PruneRomBackups() {
  return rom_lifecycle_.PruneRomBackups(GetCurrentRom());
}
 
void EditorManager::ConfirmRomWrite() {
  if (!PendingRomSaveMatchesActiveSession() ||
      !rom_lifecycle_.IsRomWriteConfirmPending()) {
    return;
  }
  rom_lifecycle_.ConfirmRomWrite();
}
 
void EditorManager::CancelRomWriteConfirm() {
  CancelPendingRomSave();
}
 
void EditorManager::ClearPendingWriteConflicts() {
  CancelPendingRomSave();
}
 
void EditorManager::CreateNewSession() {
  if (session_coordinator_) {
    session_coordinator_->CreateNewSession();
    // Toast messages are now shown by SessionCoordinator
  }
}
 
void EditorManager::DuplicateCurrentSession() {
  if (session_coordinator_) {
    session_coordinator_->DuplicateCurrentSession();
  }
}
 
void EditorManager::CloseCurrentSession() {
  if (!session_coordinator_) {
    return;
  }
 
  if (!session_coordinator_->HasMultipleSessions()) {
    // Preserve the coordinator's existing warning without offering a
    // "Close Without Saving" action that cannot close the final session.
    session_coordinator_->CloseCurrentSession();
    return;
  }
 
  const size_t current_session_id = GetCurrentSessionId();
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kCloseSession, current_session_id,
           current_session_id})) {
    return;
  }
 
  session_coordinator_->CloseCurrentSession();
  RestoreCurrentRomIdentity();
}
 
void EditorManager::CloseRom() {
  if (!CanCloseRom()) {
    return;
  }
  const size_t session_id = GetCurrentSessionId();
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kCloseRom, session_id,
           session_id})) {
    return;
  }
  ExecutePendingUnsavedSessionAction(
      {PendingUnsavedSessionAction::Type::kCloseRom, session_id, session_id});
}
 
bool EditorManager::CanCloseRom() const {
  return session_coordinator_ != nullptr &&
         session_coordinator_->GetActiveRomSession() != nullptr;
}
 
bool EditorManager::CanRevertRom() const {
  if (!session_coordinator_) {
    return false;
  }
  const auto* session = session_coordinator_->GetActiveRomSession();
  return session != nullptr && session->rom.is_loaded() &&
         !session->rom.filename().empty();
}
 
absl::Status EditorManager::RevertRomToSaved() {
  if (!CanRevertRom()) {
    return absl::FailedPreconditionError("No ROM with a backing file is open");
  }
  const size_t session_id = GetCurrentSessionId();
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kRevertRom, session_id,
           session_id})) {
    return absl::OkStatus();  // Confirmation popup is now showing.
  }
  RETURN_IF_ERROR(RevertRomToSavedInternal());
  toast_manager_.Show("Reverted ROM to the saved file", ToastType::kSuccess);
  return absl::OkStatus();
}
 
absl::Status EditorManager::RevertRomToSavedInternal() {
  if (!CanRevertRom()) {
    return absl::FailedPreconditionError("No ROM with a backing file is open");
  }
  auto* session = session_coordinator_->GetActiveRomSession();
  // Graphics sheet drafts are held by the Graphics editor and are not rebuilt
  // by ReplaceActiveSessionRom. Refuse instead of leaving them stale.
  if (session->editors.HasPendingGraphicsChanges()) {
    return absl::FailedPreconditionError(
        "The Graphics editor has unsaved sheet edits; save or undo them "
        "before reverting");
  }
 
  const std::string backing_path = session->rom.filename();
  // Load into scratch storage first so a read failure leaves the live
  // session untouched. Resource labels are session work stored beside the
  // ROM, not ROM bytes, so keep the in-memory labels (as
  // DiscardPendingRomBackupRestore does).
  const project::ResourceLabelManager resource_labels =
      *session->rom.resource_label();
  Rom backing_rom;
  RETURN_IF_ERROR(rom_file_manager_.LoadRom(&backing_rom, backing_path));
  *backing_rom.resource_label() = resource_labels;
  RETURN_IF_ERROR(
      ReplaceActiveSessionRom(std::move(backing_rom), backing_path));
 
  // ReplaceActiveSessionRom may re-resolve the session pointer's contents but
  // not its identity; re-read it defensively.
  session = session_coordinator_->GetActiveRomSession();
  if (session != nullptr) {
    session->backup_restore_pending = false;
    session->rom.ClearDirty();
    if (SessionHasPendingRomWork(GetCurrentSessionIndex())) {
      return absl::DataLossError(absl::StrFormat(
          "ROM reloaded from disk, but the session still reports %s",
          DescribePendingUnsavedWork(GetCurrentSessionIndex())));
    }
  }
  return absl::OkStatus();
}
 
void EditorManager::RemoveSession(size_t index) {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(index)) {
    return;
  }
 
  const size_t session_id = session_coordinator_->GetSessionId(index);
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kCloseSession, session_id,
           session_id})) {
    return;
  }
 
  session_coordinator_->RemoveSession(index);
  RestoreCurrentRomIdentity();
}
 
void EditorManager::Quit() {
  if (!MaybeGuardPendingSessionAction(
          {PendingUnsavedSessionAction::Type::kQuit, SIZE_MAX})) {
    return;
  }
 
  quit_ = true;
}
 
bool EditorManager::HasPendingUnsavedSessionAction() const {
  return pending_unsaved_session_action_.has_value();
}
 
std::optional<size_t> EditorManager::ResolveSessionIndexById(
    size_t session_id) const {
  if (!session_coordinator_ || session_id == SIZE_MAX) {
    return std::nullopt;
  }
 
  for (size_t index = 0; index < session_coordinator_->GetTotalSessionCount();
       ++index) {
    if (session_coordinator_->GetSessionId(index) == session_id) {
      return index;
    }
  }
  return std::nullopt;
}
 
std::string EditorManager::GetPendingUnsavedSessionActionPrompt() const {
  if (!pending_unsaved_session_action_) {
    return "";
  }
 
  const auto& action = *pending_unsaved_session_action_;
  if (action.type == PendingUnsavedSessionAction::Type::kQuit) {
    return absl::StrFormat("%s\n\nQuitting now will discard them.",
                           DescribeAllPendingUnsavedWork());
  }
 
  const auto source_index = ResolveSessionIndexById(action.source_session_id);
  const std::string session_name =
      source_index.has_value()
          ? session_coordinator_->GetSessionDisplayName(*source_index)
          : "Closed Session";
  const std::string work = source_index.has_value()
                               ? DescribePendingUnsavedWork(*source_index)
                               : "unsaved work";
 
  switch (action.type) {
    case PendingUnsavedSessionAction::Type::kOpenRomDialog:
    case PendingUnsavedSessionAction::Type::kOpenRomOrProjectPath:
      return absl::StrFormat(
          "Session '%s' has %s. Opening another ROM or project will not save "
          "them automatically.",
          session_name, work);
    case PendingUnsavedSessionAction::Type::kOpenProjectDialog:
      return absl::StrFormat(
          "Session '%s' has %s. Opening another project will not save them "
          "automatically.",
          session_name, work);
    case PendingUnsavedSessionAction::Type::kSwitchSession:
      return absl::StrFormat(
          "Session '%s' has %s. Switching sessions will leave them behind in "
          "this session.",
          session_name, work);
    case PendingUnsavedSessionAction::Type::kCloseSession:
      return absl::StrFormat(
          "Session '%s' has %s. Closing it now will discard them.",
          session_name, work);
    case PendingUnsavedSessionAction::Type::kCloseRom:
      return absl::StrFormat(
          "Session '%s' has %s. Closing the ROM now will discard them.",
          session_name, work);
    case PendingUnsavedSessionAction::Type::kRevertRom:
      return absl::StrFormat(
          "Session '%s' has %s. Reverting reloads the ROM from disk and "
          "discards all unsaved ROM edits. This cannot be undone.",
          session_name, work);
    case PendingUnsavedSessionAction::Type::kQuit:
      break;
  }
 
  return "";
}
 
std::string EditorManager::GetPendingUnsavedSessionActionSaveLabel() const {
  if (!pending_unsaved_session_action_) {
    return "Save Work";
  }
 
  switch (pending_unsaved_session_action_->type) {
    case PendingUnsavedSessionAction::Type::kOpenRomDialog:
    case PendingUnsavedSessionAction::Type::kOpenRomOrProjectPath:
      return "Save Work & Open";
    case PendingUnsavedSessionAction::Type::kOpenProjectDialog:
      return "Save Work & Open Project";
    case PendingUnsavedSessionAction::Type::kSwitchSession:
      return "Save Work & Switch";
    case PendingUnsavedSessionAction::Type::kCloseSession:
      return "Save Work & Close";
    case PendingUnsavedSessionAction::Type::kCloseRom:
      return "Save Work & Close ROM";
    case PendingUnsavedSessionAction::Type::kRevertRom:
      // Saving and then reloading from disk is a no-op; the popup hides the
      // save button when this label is empty.
      return "";
    case PendingUnsavedSessionAction::Type::kQuit:
      return ModifiedSessionCount() == 1 ? "Save Work & Quit"
                                         : "Save Modified Work & Quit";
  }
 
  return "Save Work";
}
 
std::string EditorManager::GetPendingUnsavedSessionActionContinueLabel() const {
  if (!pending_unsaved_session_action_) {
    return "Continue";
  }
 
  switch (pending_unsaved_session_action_->type) {
    case PendingUnsavedSessionAction::Type::kOpenRomDialog:
    case PendingUnsavedSessionAction::Type::kOpenRomOrProjectPath:
      return "Open Without Saving";
    case PendingUnsavedSessionAction::Type::kOpenProjectDialog:
      return "Open Project Without Saving";
    case PendingUnsavedSessionAction::Type::kSwitchSession:
      return "Switch Without Saving";
    case PendingUnsavedSessionAction::Type::kCloseSession:
    case PendingUnsavedSessionAction::Type::kCloseRom:
      return "Close Without Saving";
    case PendingUnsavedSessionAction::Type::kRevertRom:
      return "Discard Edits & Revert";
    case PendingUnsavedSessionAction::Type::kQuit:
      return "Quit Without Saving";
  }
 
  return "Continue";
}
 
void EditorManager::ConfirmPendingUnsavedSessionActionSaveAndContinue() {
  if (!pending_unsaved_session_action_) {
    return;
  }
 
  const auto action = *pending_unsaved_session_action_;
  pending_unsaved_session_action_.reset();
 
  if (popup_manager_) {
    popup_manager_->Hide(PopupID::kUnsavedSessionChanges);
  }
 
  const size_t original_session_id = GetCurrentSessionId();
  auto save_modified_session = [this](size_t session_id) -> absl::Status {
    const auto session_index = ResolveSessionIndexById(session_id);
    if (!session_index.has_value()) {
      return absl::FailedPreconditionError(
          "The ROM session is no longer available");
    }
    if (!SessionHasPendingUnsavedWork(*session_index)) {
      return absl::OkStatus();
    }
 
    session_coordinator_->SwitchToSession(*session_index);
    if (GetCurrentSessionId() != session_id) {
      return absl::FailedPreconditionError(
          "The requested ROM session could not be activated before saving");
    }
    RETURN_IF_ERROR(SaveActiveProjectEditingWork());
    if (SessionHasPendingRomWork(*session_index)) {
      RETURN_IF_ERROR(SaveRom());
    }
 
    // A successful file write does not necessarily mean every pending editor
    // domain participated in the save. For example, dungeon palette saving is
    // user-configurable. Never execute a destructive follow-up while work that
    // the confirmation dialog promised to save is still pending.
    if (SessionHasPendingUnsavedWork(*session_index)) {
      return absl::FailedPreconditionError(
          absl::StrFormat("Save completed, but session still has %s",
                          DescribePendingUnsavedWork(*session_index)));
    }
    return absl::OkStatus();
  };
 
  absl::Status save_status = absl::OkStatus();
  if (action.type == PendingUnsavedSessionAction::Type::kQuit) {
    if (session_coordinator_) {
      std::vector<size_t> session_ids;
      session_ids.reserve(session_coordinator_->GetTotalSessionCount());
      for (size_t i = 0; i < session_coordinator_->GetTotalSessionCount();
           ++i) {
        session_ids.push_back(session_coordinator_->GetSessionId(i));
      }
      for (const size_t session_id : session_ids) {
        save_status = save_modified_session(session_id);
        if (!save_status.ok()) {
          break;
        }
      }
    }
  } else {
    save_status = save_modified_session(action.source_session_id);
  }
 
  if (!save_status.ok()) {
    const bool resumable_confirmation = absl::IsCancelled(save_status) &&
                                        HasPendingRomSaveConfirmation() &&
                                        PendingRomSaveMatchesActiveSession();
    const auto original_session_index =
        ResolveSessionIndexById(original_session_id);
    if (!resumable_confirmation && original_session_index.has_value()) {
      session_coordinator_->SwitchToSession(*original_session_index);
    }
 
    if (absl::IsCancelled(save_status)) {
      toast_manager_.Show("Save paused. Finish saving, then retry your action.",
                          ToastType::kInfo);
    } else {
      toast_manager_.Show(
          absl::StrFormat("Failed to save before continuing: %s",
                          save_status.message()),
          ToastType::kError);
    }
    return;
  }
 
  // Saving an inactive close target temporarily activates that session. Put
  // the original session back before compacting the target index so the same
  // stable session remains active after the close.
  if (action.type == PendingUnsavedSessionAction::Type::kCloseSession &&
      original_session_id != action.target_session_id) {
    const auto original_session_index =
        ResolveSessionIndexById(original_session_id);
    if (original_session_index.has_value()) {
      session_coordinator_->SwitchToSession(*original_session_index);
      if (GetCurrentSessionId() != original_session_id) {
        toast_manager_.Show(
            "Session saved, but the original ROM session could not be "
            "restored. Close was cancelled.",
            ToastType::kError);
        return;
      }
    }
  }
 
  ExecutePendingUnsavedSessionAction(action);
}
 
void EditorManager::ConfirmPendingUnsavedSessionActionDiscardAndContinue() {
  if (!pending_unsaved_session_action_) {
    return;
  }
 
  const auto action = *pending_unsaved_session_action_;
  pending_unsaved_session_action_.reset();
  if (popup_manager_) {
    popup_manager_->Hide(PopupID::kUnsavedSessionChanges);
  }
  ExecutePendingUnsavedSessionAction(action);
}
 
void EditorManager::CancelPendingUnsavedSessionAction() {
  pending_unsaved_session_action_.reset();
  if (popup_manager_) {
    popup_manager_->Hide(PopupID::kUnsavedSessionChanges);
  }
}
 
bool EditorManager::MaybeGuardPendingSessionAction(
    PendingUnsavedSessionAction action) {
  CaptureActiveProjectEditingState();
  const auto source_index = ResolveSessionIndexById(action.source_session_id);
  bool has_pending_work = false;
  if (action.type == PendingUnsavedSessionAction::Type::kQuit) {
    has_pending_work = HasAnySessionPendingUnsavedWork();
  } else if (action.type == PendingUnsavedSessionAction::Type::kRevertRom) {
    // Revert only discards ROM-side work; project drafts survive it.
    has_pending_work =
        source_index.has_value() && SessionHasPendingRomWork(*source_index);
  } else {
    has_pending_work =
        source_index.has_value() && SessionHasPendingUnsavedWork(*source_index);
  }
  if (!has_pending_work) {
    return true;
  }
 
  pending_unsaved_session_action_ = std::move(action);
  if (popup_manager_) {
    popup_manager_->Show(PopupID::kUnsavedSessionChanges);
  }
  return false;
}
 
void EditorManager::ExecutePendingUnsavedSessionAction(
    const PendingUnsavedSessionAction& action) {
  switch (action.type) {
    case PendingUnsavedSessionAction::Type::kOpenRomDialog: {
      auto status = LoadRomInternal();
      if (!status.ok()) {
        toast_manager_.Show(
            absl::StrFormat("Failed to load ROM: %s", status.message()),
            ToastType::kError);
      }
      break;
    }
    case PendingUnsavedSessionAction::Type::kOpenRomOrProjectPath: {
      auto status = OpenRomOrProjectInternal(
          action.path, /*allow_dialogs=*/true, action.load_options_prompt);
      if (!status.ok()) {
        toast_manager_.Show(absl::StrFormat("Failed to open ROM / project: %s",
                                            status.message()),
                            ToastType::kError);
      }
      break;
    }
    case PendingUnsavedSessionAction::Type::kOpenProjectDialog: {
      auto status = OpenProjectInternal();
      if (!status.ok()) {
        toast_manager_.Show(
            absl::StrFormat("Failed to open project: %s", status.message()),
            ToastType::kError);
      }
      break;
    }
    case PendingUnsavedSessionAction::Type::kSwitchSession:
      if (session_coordinator_) {
        const auto target_index =
            ResolveSessionIndexById(action.target_session_id);
        if (target_index.has_value()) {
          session_coordinator_->SwitchToSession(*target_index);
        }
      }
      break;
    case PendingUnsavedSessionAction::Type::kCloseSession:
      if (session_coordinator_) {
        const auto target_index =
            ResolveSessionIndexById(action.target_session_id);
        if (target_index.has_value()) {
          session_coordinator_->RemoveSession(*target_index);
          RestoreCurrentRomIdentity();
        }
      }
      break;
    case PendingUnsavedSessionAction::Type::kCloseRom:
      if (session_coordinator_) {
        const auto target_index =
            ResolveSessionIndexById(action.target_session_id);
        if (target_index.has_value()) {
          session_coordinator_->CloseSessionAllowingEmpty(*target_index);
          RestoreCurrentRomIdentity();
        }
      }
      break;
    case PendingUnsavedSessionAction::Type::kRevertRom: {
      const auto target_index =
          ResolveSessionIndexById(action.target_session_id);
      if (!target_index.has_value()) {
        break;
      }
      if (session_coordinator_ &&
          *target_index != session_coordinator_->GetActiveSessionIndex()) {
        session_coordinator_->SwitchToSession(*target_index);
      }
      if (GetCurrentSessionId() != action.target_session_id) {
        toast_manager_.Show(
            "Revert cancelled: the requested ROM session could not be "
            "activated",
            ToastType::kError);
        break;
      }
      auto status = RevertRomToSavedInternal();
      if (status.ok()) {
        toast_manager_.Show("Reverted ROM to the saved file",
                            ToastType::kSuccess);
      } else {
        toast_manager_.Show(
            absl::StrFormat("Revert failed: %s", status.message()),
            ToastType::kError, 6.0f);
      }
      break;
    }
    case PendingUnsavedSessionAction::Type::kQuit:
      quit_ = true;
      break;
  }
}
 
bool EditorManager::SessionHasPendingUnsavedWork(size_t session_index) const {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(session_index)) {
    return false;
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(session_index));
  return session != nullptr &&
         (SessionHasPendingRomWork(session_index) ||
          session->editors.HasPendingSpriteChanges() ||
          session->project_dirty ||
          session->editors.HasPendingProjectDraftChanges() ||
          (session->project_file_editor_state.initialized &&
           session->project_file_editor_state.modified));
}
 
bool EditorManager::SessionHasPendingRomWork(size_t session_index) const {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(session_index)) {
    return false;
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(session_index));
  return session != nullptr &&
         ((session->rom.is_loaded() && session->rom.dirty()) ||
          session->editors.HasPendingGraphicsChanges() ||
          session->HasPendingGfxGroupChanges() ||
          session->editors.HasPendingScreenChanges() ||
          HasPendingDungeonChangesForSession(session_index) ||
          gfx::PaletteManager::Get().HasUnsavedChanges(&session->game_data));
}
 
bool EditorManager::HasAnySessionPendingUnsavedWork() const {
  return ModifiedSessionCount() > 0;
}
 
bool EditorManager::HasPendingDungeonChangesForSession(
    size_t session_index) const {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(session_index)) {
    return false;
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(session_index));
  if (!session) {
    return false;
  }
 
  if (auto* dungeon_editor =
          session->editors.GetEditorAs<DungeonEditorV2>(EditorType::kDungeon)) {
    return dungeon_editor->HasPendingDungeonChanges();
  }
  return false;
}
 
int EditorManager::PendingDungeonRoomCountForSession(
    size_t session_index) const {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(session_index)) {
    return 0;
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(session_index));
  if (!session) {
    return 0;
  }
 
  if (auto* dungeon_editor =
          session->editors.GetEditorAs<DungeonEditorV2>(EditorType::kDungeon)) {
    return dungeon_editor->PendingRoomCount();
  }
  return 0;
}
 
size_t EditorManager::PendingPaletteColorCountForSession(
    size_t session_index) const {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(session_index)) {
    return 0;
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(session_index));
  return session != nullptr ? gfx::PaletteManager::Get().GetModifiedColorCount(
                                  &session->game_data)
                            : 0;
}
 
int EditorManager::ModifiedSessionCount() const {
  if (!session_coordinator_) {
    return 0;
  }
 
  int count = 0;
  for (size_t i = 0; i < session_coordinator_->GetTotalSessionCount(); ++i) {
    if (SessionHasPendingUnsavedWork(i)) {
      ++count;
    }
  }
  return count;
}
 
std::string EditorManager::DescribePendingUnsavedWork(
    size_t session_index) const {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(session_index)) {
    return "unsaved work";
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(session_index));
  const bool rom_dirty =
      session != nullptr && session->rom.is_loaded() && session->rom.dirty();
  const bool pending_dungeon_changes =
      HasPendingDungeonChangesForSession(session_index);
  const bool pending_sprite_changes =
      session != nullptr && session->editors.HasPendingSpriteChanges();
  const bool pending_graphics_changes =
      session != nullptr && session->editors.HasPendingGraphicsChanges();
  const bool pending_gfx_group_changes =
      session != nullptr && session->HasPendingGfxGroupChanges();
  const bool pending_screen_changes =
      session != nullptr && session->editors.HasPendingScreenChanges();
  const int pending_rooms = PendingDungeonRoomCountForSession(session_index);
  const size_t pending_palette_colors =
      PendingPaletteColorCountForSession(session_index);
  const bool project_dirty = session != nullptr && session->project_dirty;
  const bool project_editor_draft =
      session != nullptr && session->editors.HasPendingProjectDraftChanges();
  const bool project_file_dirty =
      session != nullptr && session->project_file_editor_state.initialized &&
      session->project_file_editor_state.modified;
 
  std::vector<std::string> work;
  if (pending_rooms > 0) {
    work.push_back(absl::StrFormat("%d unapplied dungeon room%s", pending_rooms,
                                   pending_rooms == 1 ? "" : "s"));
  } else if (pending_dungeon_changes) {
    work.emplace_back("unapplied dungeon metadata");
  }
  if (pending_palette_colors > 0) {
    work.push_back(absl::StrFormat("%zu unapplied palette color%s",
                                   pending_palette_colors,
                                   pending_palette_colors == 1 ? "" : "s"));
  }
  if (pending_sprite_changes)
    work.emplace_back("unsaved sprite assets");
  if (pending_graphics_changes) {
    work.emplace_back("unapplied graphics sheet edits");
  }
  if (pending_gfx_group_changes) {
    work.emplace_back("unsaved blockset/spriteset (gfx group) edits");
  }
  if (pending_screen_changes) {
    work.emplace_back("unapplied Screen Editor edits");
  }
  if (rom_dirty) {
    work.emplace_back("unsaved ROM-buffer changes");
  }
  if (project_dirty) {
    work.emplace_back("unsaved project settings");
  }
  if (project_editor_draft) {
    work.emplace_back("an uncommitted project editor draft");
  }
  if (project_file_dirty) {
    work.emplace_back("an unsaved project-file draft");
  }
  return work.empty() ? "unsaved work" : absl::StrJoin(work, " and ");
}
 
std::string EditorManager::CompactPendingUnsavedWorkLabel(
    size_t session_index) const {
  if (!session_coordinator_ ||
      !session_coordinator_->IsValidSessionIndex(session_index)) {
    return {};
  }
 
  auto* session =
      static_cast<RomSession*>(session_coordinator_->GetSession(session_index));
  const bool rom_dirty =
      session != nullptr && session->rom.is_loaded() && session->rom.dirty();
  const bool pending_dungeon_changes =
      HasPendingDungeonChangesForSession(session_index);
  const bool pending_sprite_changes =
      session != nullptr && session->editors.HasPendingSpriteChanges();
  const bool pending_graphics_changes =
      session != nullptr && session->editors.HasPendingGraphicsChanges();
  const bool pending_gfx_group_changes =
      session != nullptr && session->HasPendingGfxGroupChanges();
  const bool pending_screen_changes =
      session != nullptr && session->editors.HasPendingScreenChanges();
  const int pending_rooms = PendingDungeonRoomCountForSession(session_index);
  const size_t pending_palette_colors =
      PendingPaletteColorCountForSession(session_index);
  const bool project_dirty = session != nullptr && session->project_dirty;
  const bool project_editor_draft =
      session != nullptr && session->editors.HasPendingProjectDraftChanges();
  const bool project_file_dirty =
      session != nullptr && session->project_file_editor_state.initialized &&
      session->project_file_editor_state.modified;
 
  std::vector<std::string> tags;
  if (pending_rooms > 0) {
    tags.push_back("Rooms");
  } else if (pending_dungeon_changes) {
    tags.push_back("Dungeon");
  }
  if (pending_palette_colors > 0) {
    tags.push_back("Palette");
  }
  if (pending_sprite_changes)
    tags.emplace_back("Sprites");
  if (pending_graphics_changes) {
    tags.push_back("Gfx");
  }
  if (pending_gfx_group_changes) {
    tags.push_back("GfxGroups");
  }
  if (pending_screen_changes) {
    tags.push_back("Screen");
  }
  if (rom_dirty) {
    tags.push_back("ROM");
  }
  if (project_dirty || project_editor_draft || project_file_dirty) {
    tags.push_back("Project");
  }
  return absl::StrJoin(tags, "+");
}
 
std::string EditorManager::DescribeAllPendingUnsavedWork() const {
  const int modified_sessions = ModifiedSessionCount();
  if (modified_sessions <= 0) {
    return "No sessions have unsaved work.";
  }
 
  if (modified_sessions == 1 && session_coordinator_) {
    for (size_t i = 0; i < session_coordinator_->GetTotalSessionCount(); ++i) {
      if (SessionHasPendingUnsavedWork(i)) {
        return absl::StrFormat("Session '%s' has %s.",
                               session_coordinator_->GetSessionDisplayName(i),
                               DescribePendingUnsavedWork(i));
      }
    }
  }
 
  return absl::StrFormat(
      "%d sessions have unsaved ROM, graphics, screen, dungeon, palette, or "
      "project work.",
      modified_sessions);
}
 
size_t EditorManager::GetCurrentSessionIndex() const {
  return session_coordinator_ ? session_coordinator_->GetActiveSessionIndex()
                              : 0;
}
 
EditorManager::UiSyncState EditorManager::GetUiSyncStateSnapshot() const {
  UiSyncState state;
  state.frame_id = ui_sync_frame_id_.load(std::memory_order_relaxed);
 
  int pending_editor =
      pending_editor_deferred_actions_.load(std::memory_order_relaxed);
  if (pending_editor < 0) {
    pending_editor = 0;
  }
  state.pending_editor_actions = pending_editor;
 
  int pending_layout = layout_coordinator_.PendingDeferredActionCount();
  if (pending_layout < 0) {
    pending_layout = 0;
  }
  state.pending_layout_actions = pending_layout;
  state.layout_rebuild_pending =
      layout_manager_ ? layout_manager_->IsRebuildRequested() : false;
  return state;
}
 
size_t EditorManager::GetActiveSessionCount() const {
  return session_coordinator_ ? session_coordinator_->GetActiveSessionCount()
                              : 0;
}
 
std::string EditorManager::GenerateUniqueEditorTitle(
    EditorType type, size_t session_index) const {
  const char* base_name = kEditorNames[static_cast<int>(type)];
  return session_coordinator_ ? session_coordinator_->GenerateUniqueEditorTitle(
                                    base_name, session_index)
                              : std::string(base_name);
}
 
void EditorManager::SwitchToEditor(EditorType editor_type, bool force_visible,
                                   bool from_dialog) {
#ifdef YAZE_BUILD_AGENT_UI
  // Agent has its own activation path, including the shared experimental
  // warning. Handle it first so one user action cannot emit the warning twice.
  if (editor_type == EditorType::kAgent) {
    ShowAIAgent();
    return;
  }
#endif
 
  if (EditorRegistry::ShouldWarnAboutExperimentalEditor(
          editor_type, user_settings_.prefs().show_experimental_editors)) {
    toast_manager_.Show(
        absl::StrFormat(
            "%s is experimental. It remains available; enable experimental "
            "features in Settings to acknowledge this warning.",
            kEditorNames[static_cast<int>(editor_type)]),
        ToastType::kWarning);
  }
 
  // Fresh launch has no ROM session, so GetCurrentEditorSet() is null and
  // EditorActivator::SwitchToEditor would silently no-op (BUG-020) — that was
  // why File->Settings, the "no ROM" welcome buttons, and Tools editors did
  // nothing. Create an empty session on demand so ROM-less editors (Settings,
  // Assembly, ...) have an editor set to live in. Normal ROM loads create their
  // own session, so this only fires when the user reaches an editor first.
  if (session_coordinator_ && GetCurrentEditorSet() == nullptr) {
    session_coordinator_->CreateNewSession();
  }
 
  auto status = EnsureEditorAssetsLoaded(editor_type);
  if (!status.ok()) {
    toast_manager_.Show(
        absl::StrFormat("Failed to prepare %s: %s",
                        kEditorNames[static_cast<int>(editor_type)],
                        status.message()),
        ToastType::kError);
  }
 
  if (current_editor_ && current_editor_->type() == EditorType::kGraphics &&
      editor_type != EditorType::kGraphics) {
    static_cast<GraphicsEditor*>(current_editor_)->FinishPixelGesture();
  }
 
  // Delegate all other editor switching to EditorActivator
  editor_activator_.SwitchToEditor(editor_type, force_visible, from_dialog);
 
  switch (editor_type) {
    case EditorType::kOverworld:
      // Show at most one migration tip per editor transition. The next visit
      // naturally advances to the more specific Tile16 tip.
      if (!feature_hint_manager_.MaybeShow(FeatureHintId::kZScreamOverworld)) {
        feature_hint_manager_.MaybeShow(FeatureHintId::kZScreamTile16);
      }
      break;
    case EditorType::kDungeon:
      feature_hint_manager_.MaybeShow(FeatureHintId::kZScreamDungeon);
      break;
    case EditorType::kScreen:
      feature_hint_manager_.MaybeShow(FeatureHintId::kZScreamScreenMap);
      break;
    default:
      break;
  }
}
 
void EditorManager::DismissEditorSelection() {
  if (!ui_coordinator_) {
    return;
  }
  ui_coordinator_->SetEditorSelectionVisible(false);
  ui_coordinator_->SetStartupSurface(StartupSurface::kEditor);
}
 
bool EditorManager::HasDuplicateSession(const std::string& filepath) {
  return session_coordinator_ &&
         session_coordinator_->HasDuplicateSession(filepath);
}
 
void EditorManager::ShowProjectManagement() {
  // Menu actions can run before the next Update() frame captures drawer
  // edits. Preserve the panel's current dirty bit before rebinding it.
  CaptureActiveProjectEditingState();
  if (right_drawer_manager_) {
    // Update project panel context before showing
    if (project_management_panel_) {
      project_management_panel_->SetProject(&current_project_,
                                            IsCurrentProjectDirty());
      project_management_panel_->SetVersionManager(version_manager_);
      project_management_panel_->SetRom(GetCurrentRom());
    }
    right_drawer_manager_->ToggleDrawer(
        RightDrawerManager::DrawerType::kProject);
  }
}
 
void EditorManager::ShowProjectFileEditor() {
  CaptureActiveProjectEditingState();
  auto* session = session_coordinator_
                      ? session_coordinator_->GetActiveRomSession()
                      : nullptr;
 
  // Preserve an existing draft for this session. Only load from disk the first
  // time this session opens the project-file editor.
  if (session && session->project_file_editor_state.initialized &&
      !session->project_file_editor_state.modified &&
      !current_project_.filepath.empty() &&
      !SessionCoordinator::PathsReferToSameBackingFile(
          session->project_file_editor_state.filepath,
          current_project_.filepath)) {
    RebaseCleanProjectFileDraft(current_project_.filepath);
  }
 
  if (session && session->project_file_editor_state.initialized) {
    project_file_editor_.RestoreState(session->project_file_editor_state,
                                      &current_project_);
  } else if (!current_project_.filepath.empty()) {
    auto status = project_file_editor_.LoadFile(current_project_.filepath);
    if (!status.ok()) {
      toast_manager_.Show(
          absl::StrFormat("Failed to load project file: %s", status.message()),
          ToastType::kError);
      return;
    }
  } else {
    project_file_editor_.ResetForProject(&current_project_);
  }
  // Set the project pointer for label import functionality
  project_file_editor_.SetProject(&current_project_);
  // Activate the editor window
  project_file_editor_.set_active(true);
  if (session) {
    session->project_file_editor_state = project_file_editor_.CaptureState();
  }
}
 
void EditorManager::ConfigureEditorDependencies(EditorSet* editor_set, Rom* rom,
                                                size_t session_id) {
  if (!editor_set) {
    return;
  }
 
  EditorDependencies deps;
  deps.rom = rom;
  deps.session_id = session_id;
  deps.window_manager = &window_manager_;
  deps.toast_manager = &toast_manager_;
  deps.popup_manager = popup_manager_.get();
  deps.shortcut_manager = &shortcut_manager_;
  deps.shared_clipboard = &shared_clipboard_;
  deps.user_settings = &user_settings_;
  if (session_coordinator_) {
    const auto session_index = ResolveSessionIndexById(session_id);
    if (session_index.has_value()) {
      auto* session = static_cast<RomSession*>(
          session_coordinator_->GetSession(*session_index));
      if (session) {
        deps.game_data = &session->game_data;
        if (session->project_context.has_value()) {
          deps.project = &*session->project_context;
          deps.version_manager = session->version_manager.get();
        }
      }
    }
  }
  deps.global_context = editor_context_.get();
  deps.status_bar = &status_bar_;
  deps.renderer = renderer_;
  deps.emulator = &emulator_;
  deps.custom_data = this;
  deps.project_context_provider = [this,
                                   session_id]() -> project::YazeProject* {
    return IsCurrentProjectContextOwnedBySession(session_id) ? &current_project_
                                                             : nullptr;
  };
  deps.gfx_group_workspace = editor_set->gfx_group_workspace();
 
  editor_set->ApplyDependencies(deps);
 
  if (auto* overworld =
          editor_set->GetEditorAs<OverworldEditor>(EditorType::kOverworld)) {
    overworld->SetProjectContextProvider(
        [this, session_id]() -> project::YazeProject* {
          return IsCurrentProjectContextOwnedBySession(session_id)
                     ? &current_project_
                     : nullptr;
        });
  }
  if (auto* settings_panel = editor_set->GetSettingsPanel()) {
    // Settings edit the same active project that CaptureActiveProjectContext
    // persists. Editing the session snapshot directly loses changes when the
    // next capture replaces that snapshot with current_project_.
    settings_panel->SetProjectContextProvider(
        [this, session_id]() -> project::YazeProject* {
          return IsCurrentProjectContextOwnedBySession(session_id)
                     ? &current_project_
                     : nullptr;
        },
        [this, session_id]() -> std::string {
          return IsCurrentProjectContextOwnedBySession(session_id)
                     ? GetCurrentRomHash()
                     : std::string();
        });
    settings_panel->SetOpenMinecartTracksCallback(
        [this, session_id]() -> absl::Status {
          if (!IsCurrentProjectContextOwnedBySession(session_id)) {
            return absl::FailedPreconditionError(
                "Minecart Tracks requires its project session to be active.");
          }
          RETURN_IF_ERROR(EnsureEditorAssetsLoaded(EditorType::kDungeon));
          auto* dungeon = GetCurrentEditorSet()->GetEditorAs<DungeonEditorV2>(
              EditorType::kDungeon);
          if (dungeon == nullptr) {
            return absl::NotFoundError(
                "Dungeon editor is unavailable in the active project "
                "session.");
          }
          RETURN_IF_ERROR(dungeon->EnsureMinecartTrackEditorPanel());
 
          SwitchToEditor(EditorType::kDungeon, true);
          if (!window_manager_.OpenWindow(
                  session_id, DungeonEditorV2::kMinecartTrackEditorId)) {
            return absl::NotFoundError(
                "Minecart Tracks could not be opened in the active Dungeon "
                "editor.");
          }
          return absl::OkStatus();
        });
  }
 
  // If configuring the active session, update the properties panel
  if (session_id == GetCurrentSessionId()) {
    selection_properties_panel_.SetRom(rom);
  }
}
 
}  // namespace yaze::editor