// Commander X16 Emulator — in-process Dear ImGui debugger.

//

// C-callable API so the C emulator core (main.c / video.c) can drive the

// ImGui debugger without knowing any C++. The implementation lives in

// debug_ui.cpp; individual panels live under panels/ and self-register (see

// debug_ui_panels.h).

#ifndef DEBUG_UI_H

#define DEBUG_UI_H

#include <stdbool.h>

#include <SDL.h>

#ifdef __cplusplus

extern "C" {

#endif

// Create the ImGui context + SDL2/SDLRenderer2 backends. `win`/`ren` are a

// dedicated debugger SDL window + renderer (separate from the emulator display

// window), created by the caller (see video.c). Enables docking. Idempotent.

void debug_ui_init(SDL_Window *win, SDL_Renderer *ren);

// Feed one SDL event to ImGui. Call for every event pulled from the pump.

void debug_ui_process_event(const SDL_Event *ev);

// Build and present one debugger frame: NewFrame -> full-window DockSpace ->

// iterate the panel registry -> Render + present on the debugger renderer.

// Call once per emulator frame.

void debug_ui_render(void);

// Destroy backends + ImGui context. Safe to call even if never initialized.

void debug_ui_shutdown(void);

// Reflects the -imgui flag / runtime enable state.

bool debug_ui_is_enabled(void);

void debug_ui_set_enabled(bool enabled);

// The debugger's SDL_Renderer (the one passed to debug_ui_init). Panels that

// need to create SDL_Texture objects for ImGui::Image (e.g. the VERA graphical

// viewers) obtain it here. Returns nullptr before debug_ui_init runs.

SDL_Renderer *debug_ui_get_renderer(void);

// True when ImGui wants to consume keyboard input this frame (e.g. a text field

// is focused). NOTE: with keyboard nav enabled this is ALSO true whenever the

// debugger window merely has focus, so it is too broad for gating function-key

// shortcuts — use debug_ui_want_text_input() for those.

bool debug_ui_want_capture_keyboard(void);

// True only while an ImGui text field is actively accepting text input. Used to

// gate the F5/F9/F10/F11 debug shortcuts so they work whenever the debugger

// window is focused but are suppressed while the user types in a goto/search box.

bool debug_ui_want_text_input(void);

// Run to the "cursor" — the disassembly row currently under the mouse, if any

// (published each frame by the Disassembly panel via debug_ui_set_cursor).

// No-op unless the machine is paused and a valid cursor is set. Returns true if

// a run-to actually started. Backs the Ctrl+F10 "run to cursor" shortcut.

bool debug_ui_run_to_cursor(void);

// Toggle a breakpoint on the current instruction (regs.pc / regs.k). Backs the

// F9 shortcut so it works regardless of which debugger panel has focus.

void debug_ui_toggle_breakpoint_at_pc(void);

#ifdef __cplusplus

} // extern "C"

#endif

#endif // DEBUG_UI_H