#ifndef PSX_HOST_KEYMAP_H
#define PSX_HOST_KEYMAP_H

#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

/*
 * Host hotkeys from recomp-ui config.ini [KeyMap] (SDL key names + Ctrl+/Alt+/
 * Shift+ prefixes). Missing lines keep the historic runtime defaults.
 */

typedef enum HostKeymapAction {
    HOST_KEYMAP_FULLSCREEN = 0,
    HOST_KEYMAP_TURBO,
    HOST_KEYMAP_VOLUME_UP,
    HOST_KEYMAP_VOLUME_DOWN,
    HOST_KEYMAP_DISPLAY_PERF,
    HOST_KEYMAP_REWIND,           /* default F8 */
    HOST_KEYMAP_SAVE_STATE_MENU,  /* default F7 */
    HOST_KEYMAP_SCANLINES,        /* default F6 */
    HOST_KEYMAP_TURBO_TOGGLE,     /* default F9; latches Turbo until pressed again */
    HOST_KEYMAP_CAPTURE_MARK,     /* default Ctrl+M; freezes the debug capture rings */
    HOST_KEYMAP_OPEN_LAUNCHER,    /* Ctrl+L / F10: shared in-game menu */
    HOST_KEYMAP_ACTION_COUNT
} HostKeymapAction;

/* Load [KeyMap] from path (NULL => no file, apply defaults only). */
void host_keymap_load(const char *config_ini_path);

/* 1 if (keycode, mod) matches a binding for `action`. */
int host_keymap_match(HostKeymapAction action, int keycode, int mod);

/* Match a key event by its logical keycode or physical scancode. SDL can
 * report a layout-dependent/unknown keycode while still providing the stable
 * scancode stored with the configured binding. */
int host_keymap_match_event(HostKeymapAction action, int keycode,
                            int scancode, int mod);

/* 1 if any configured bind for `action` is currently held. */
int host_keymap_down(HostKeymapAction action, const uint8_t *keys, int mod);

/* Format the primary bind for `action` into out (e.g. "F8", "Ctrl+R",
 * "GRAVE"). Punctuation key names are tokenized for the rewind overlay font.
 * Returns out, or "F8" / "" on empty action. Always NUL-terminates. */
const char *host_keymap_label(HostKeymapAction action, char *out, size_t cap);

#ifdef __cplusplus
}
#endif

#endif /* PSX_HOST_KEYMAP_H */