// Commander X16 Emulator — debugger user preferences.
//
// One place for the debugger's behavioural toggles, so panels read a single
// source of truth instead of each keeping its own static, and so the user can
// see and change them together (System > Settings).
//
// Preferences persist in imgui.ini through an ImGuiSettingsHandler, alongside
// the window layout ImGui already stores there — no extra config file.
#ifndef DEBUG_UI_SETTINGS_H
#define DEBUG_UI_SETTINGS_H

#include <stdbool.h>

struct DebugUiSettings {
    // --- Appearance ---------------------------------------------------------
    // Global interface scale: the whole debugger, not just panel text. Per-panel
    // Ctrl+wheel zoom stacks on top of this. Scales widget metrics (padding,
    // spacing, scrollbars) as well as the font, so menus, tab bars and buttons
    // grow with it instead of staying tiny.
    float ui_scale = 1.0f;

    // --- Navigation ---------------------------------------------------------
    // Where execution stops is not always where the user is looking. These make
    // the debugger follow the PC between the Source and Disassembly views.
    bool auto_switch_disasm = true;  // stop with no source -> focus Disassembly
    bool auto_switch_source = true;  // stop with source    -> focus Source

    // --- Execution ----------------------------------------------------------
    bool follow_interrupts = false;  // stepping stops at a handler that fires
    bool break_on_interrupt = false; // stop on every interrupt entry

    // --- Memory -------------------------------------------------------------
    bool  mem_highlight_changes = true;  // pulse bytes that changed
    float mem_highlight_seconds = 1.5f;  // how long the pulse takes to fade

    // --- Audio --------------------------------------------------------------
    bool audio_hold_on_pause = true; // freeze audio panels instead of blanking

    // --- I/O trace ----------------------------------------------------------
    // The I/O panel records a ring of register accesses and decoded device
    // events. Capture is off by default and every device with it: this is the
    // one debugger feature that costs the running machine anything -- a test
    // and a branch on every I/O access, and a copy on every captured one --
    // and the I/O page is the busiest address range in the system. The panel's
    // live state tabs all work without it; only the Activity log needs it.
    bool io_trace_capture = false;
    int  io_trace_capacity = 4096; // events retained; clamped by io_trace.c

    // Per-device capture, all off by default so that switching capture on
    // records nothing until the user says what they are actually looking for.
    // Rates differ by orders of magnitude -- see the tooltips in the panel.
    bool io_cap_via = false;
    bool io_cap_vera = false;
    bool io_cap_spi = false;
    bool io_cap_ym = false;
    bool io_cap_emu = false;
    bool io_cap_midi = false;
    bool io_cap_openbus = false;

    // Decoded device events, split per device rather than lumped together
    // because their rates differ by orders of magnitude.
    bool io_cap_sd = false;
    bool io_cap_files = false;
    bool io_cap_i2c = false;
    bool io_cap_joy = false;

    // Index the filesystem inside an attached SD image, so block traffic can be
    // named. Off means the SD tab still works, it just reports LBAs.
    bool io_fat_autoindex = true;

    // --- Performance budget --------------------------------------------------
    // The Performance panel arms profiling while it is open, so this is only
    // for the cases where that is not what is wanted: leaving it running after
    // the panel is closed (to keep a DAP client fed), or holding it off
    // entirely. Like the I/O trace, this is a feature that costs the running
    // machine something -- an add and a table lookup on every instruction.
    bool  perf_always_on   = false; // keep profiling when the panel is closed
    float perf_target_fps  = 60.0f;
    int   perf_idle_mode   = 0;    // perf_idle_mode_t
    int   perf_capacity    = 3600; // frames of history; 60s at 60Hz
    int   perf_graph_frames = 240; // frames drawn in the panel's graph

    // --- Safety -------------------------------------------------------------
    // Most register edits are recoverable pokes. A few are not: they change
    // machine state the running program has already committed to, and it will
    // usually crash rather than cope. Those are gated behind this and are off by
    // default, so nobody reaches for one thinking it is a display option.
    //
    // The E (emulation) flag is the clearest case - see cpu_panel.cpp.
    bool allow_breaking_changes = false;
};

// The live settings. Mutating these takes effect immediately.
DebugUiSettings &debug_ui_settings();

// Install the imgui.ini persistence hook. Call once, before ImGui loads its
// ini file (i.e. before the first NewFrame).
void debug_ui_settings_register(void);

// The Settings window itself (System > Settings).
void debug_ui_draw_settings_window(bool *p_open);

// Note that a preference changed so it gets written back to imgui.ini. Panels
// that expose the same toggle call this instead of pulling in imgui_internal.h.
void debug_ui_settings_mark_dirty(void);

#endif