user_settings.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_SYSTEM_USER_SETTINGS_H_
#define YAZE_APP_EDITOR_SYSTEM_USER_SETTINGS_H_
 
#include <string>
#include <unordered_map>
#include <unordered_set>
#include <utility>
#include <vector>
 
#include "absl/status/status.h"
 
namespace yaze {
namespace editor {
 
class UserSettings {
 public:
  struct Preferences {
    struct AiHost {
      std::string id;
      std::string label;
      std::string base_url;
      std::string api_type;  // openai, ollama, gemini, lmstudio, grpc
      bool supports_vision = false;
      bool supports_tools = true;
      bool supports_streaming = true;
      bool allow_insecure = false;
      std::string api_key;  // Optional plaintext key (desktop/non-keychain)
      std::string
          credential_id;  // Keychain reference (never store secrets here)
    };
 
    struct AiModelProfile {
      std::string name;
      std::string model;
      float temperature = 0.25f;
      float top_p = 0.95f;
      int max_output_tokens = 2048;
      bool supports_vision = false;
      bool supports_tools = true;
    };
 
    // General
    float font_global_scale = 1.0f;
    bool backup_rom = false;
    bool save_new_auto = true;
    bool autosave_enabled = true;
    float autosave_interval = 300.0f;
    int recent_files_limit = 10;
    std::string last_rom_path;
    std::string last_project_path;
    bool show_welcome_on_startup = true;
    bool restore_last_session = true;
    bool prefer_hmagic_sprite_names = true;
 
    // Welcome screen animation preferences. Match the defaults hard-coded in
    // WelcomeScreen so first-run behavior is unchanged.
    float welcome_triforce_alpha = 1.0f;
    float welcome_triforce_speed = 0.3f;
    float welcome_triforce_size = 1.0f;
    bool welcome_particles_enabled = true;
    bool welcome_mouse_repel_enabled = true;
 
    // Accessibility / interaction
    bool reduced_motion = false;
    int switch_motion_profile = 1;  // 0=Snappy, 1=Standard, 2=Relaxed
 
    // Theme (last applied theme persists across restart; empty = default)
    std::string last_theme_name;
 
    // Editor Behavior
    bool backup_before_save = true;
    int default_editor = 0;  // 0=None, 1=Overworld, 2=Dungeon, 3=Graphics
 
    // Performance
    bool vsync = true;
    int target_fps = 60;
    int cache_size_mb = 512;
    int undo_history_size = 50;
 
    // AI Agent
    int ai_provider =
        0;  // Legacy default provider (0=Ollama, 1=Gemini, 2=Mock)
    std::string ai_model;
    std::string ollama_url = "http://localhost:11434";
    std::string gemini_api_key;
    std::string openai_api_key;
    std::string anthropic_api_key;
    float ai_temperature = 0.7f;
    int ai_max_tokens = 2048;
    bool ai_proactive = true;
    bool ai_auto_learn = true;
    bool ai_multimodal = true;
    std::vector<AiHost> ai_hosts;
    std::string active_ai_host_id;
    std::vector<AiModelProfile> ai_profiles;
    std::string active_ai_profile;
    std::string remote_build_host_id;
    std::vector<std::string> ai_model_paths;
 
    // CLI Logging
    int log_level = 1;  // 0=Debug, 1=Info, 2=Warning, 3=Error, 4=Fatal
    bool log_to_file = false;
    std::string log_file_path;
    bool log_ai_requests = true;
    bool log_rom_operations = true;
    bool log_gui_automation = true;
    bool log_proposals = true;
 
    // Filesystem (iOS + remote workflows)
    std::vector<std::string> project_root_paths;
    std::string default_project_root;
    bool use_files_app = true;
    bool use_icloud_sync = true;
 
    // Shortcut Overrides
    // Maps panel_id -> shortcut string (e.g., "dungeon.room_selector" -> "Ctrl+Shift+R")
    std::unordered_map<std::string, std::string> panel_shortcuts;
    // Maps global action id -> shortcut string (e.g., "Open", "Save")
    std::unordered_map<std::string, std::string> global_shortcuts;
    // Maps editor-scoped action id -> shortcut string (keyed by editor namespace)
    std::unordered_map<std::string, std::string> editor_shortcuts;
 
    // Sidebar State
    bool sidebar_visible = true;         // Controls Activity Bar visibility
    bool sidebar_panel_expanded = true;  // Controls Side Panel visibility
    float sidebar_panel_width = 0.0f;    // 0 = responsive default
    float panel_browser_category_width = 260.0f;
    int panel_layout_defaults_revision = 0;
    std::string sidebar_active_category;  // Last active category
 
    // Sidebar customization (Phase 4): user-controlled category order,
    // hidden set (filtered out of the rail), and pinned set (pinned-first).
    std::vector<std::string> sidebar_order;
    std::unordered_set<std::string> sidebar_hidden;
    std::unordered_set<std::string> sidebar_pinned;
 
    // Status Bar
    bool show_status_bar =
        false;  // Show status bar at bottom (disabled by default)
 
    // Panel Visibility State (per editor type)
    // Maps editor_type_name -> (panel_id -> visible)
    // e.g., "Overworld" -> {"overworld.tile16_selector" -> true, ...}
    std::unordered_map<std::string, std::unordered_map<std::string, bool>>
        panel_visibility_state;
 
    // Pinned panels (persists across sessions)
    // Maps panel_id -> pinned
    std::unordered_map<std::string, bool> pinned_panels;
    std::unordered_map<std::string, float> right_panel_widths;
 
    // Named layouts (user-saved workspace configurations)
    // Maps layout_name -> (panel_id -> visible)
    std::unordered_map<std::string, std::unordered_map<std::string, bool>>
        saved_layouts;
  };
 
  UserSettings();
 
  absl::Status Load();
  absl::Status Save();
 
  // Applies a one-time layout defaults migration when target_revision is newer
  // than persisted settings. Returns true when defaults were reset.
  bool ApplyPanelLayoutDefaultsRevision(int target_revision);
 
  static constexpr int kLatestPanelLayoutDefaultsRevision = 12;
 
  Preferences& prefs() { return prefs_; }
  const Preferences& prefs() const { return prefs_; }
 
  // Testing hook: redirect Load/Save to a caller-specified path. Production
  // code should never call this; it only exists so unit tests can exercise
  // JSON round-trip without touching the user's real settings file.
  void SetSettingsFilePathForTesting(std::string path) {
    settings_file_path_ = std::move(path);
  }
 
 private:
  Preferences prefs_;
  std::string settings_file_path_;
  std::string legacy_settings_file_path_;
};
 
}  // namespace editor
}  // namespace yaze
 
#endif  // YAZE_APP_EDITOR_SYSTEM_USER_SETTINGS_H_