// Keyboard, mouse, and joystick input polling.
//
// Call jlInputPoll() once per frame (typically right before
// drawing) to refresh keyboard, mouse, and joystick state. After
// polling, the joeyKey* predicates return the current state of every
// key:
//
//   jlKeyDown(k)     -- is key k held down right now
//   jlKeyPressed(k)  -- rising edge since the previous poll
//   jlKeyReleased(k) -- falling edge since the previous poll
//
// The mouse predicates return the pointer state:
//
//   jlMouseX/Y()                -- pointer position in surface
//                                    coords (0..SURFACE_WIDTH-1,
//                                    0..SURFACE_HEIGHT-1)
//   jlMouseDown(b)              -- is button b held right now
//   jlMousePressed(b)           -- rising edge since last poll
//   jlMouseReleased(b)          -- falling edge since last poll
//
// The joystick predicates return per-stick state:
//
//   jlJoystickConnected(js)     -- true if the platform reports a
//                                    stick on this port
//   jlJoystickX/Y(js)           -- axis values, signed -127..+127.
//                                    Digital sticks snap to the
//                                    extremes; analog sticks return
//                                    the raw centered value.
//   jlJoyDown(js, b)            -- is button b held on stick js
//   jlJoyPressed(js, b)         -- rising edge since last poll
//   jlJoyReleased(js, b)        -- falling edge since last poll
//
// Edge predicates are one-shot: they return true only in the
// frame the transition occurred and false thereafter.

#ifndef JOEYLIB_INPUT_H
#define JOEYLIB_INPUT_H

#include "platform.h"
#include "types.h"

typedef enum {
    KEY_NONE = 0,

    KEY_A, KEY_B, KEY_C, KEY_D, KEY_E, KEY_F, KEY_G, KEY_H, KEY_I,
    KEY_J, KEY_K, KEY_L, KEY_M, KEY_N, KEY_O, KEY_P, KEY_Q, KEY_R,
    KEY_S, KEY_T, KEY_U, KEY_V, KEY_W, KEY_X, KEY_Y, KEY_Z,

    KEY_0, KEY_1, KEY_2, KEY_3, KEY_4,
    KEY_5, KEY_6, KEY_7, KEY_8, KEY_9,

    KEY_SPACE, KEY_ESCAPE, KEY_RETURN, KEY_TAB, KEY_BACKSPACE,

    KEY_UP, KEY_DOWN, KEY_LEFT, KEY_RIGHT,

    KEY_LSHIFT, KEY_RSHIFT, KEY_LCTRL, KEY_LALT,

    KEY_F1, KEY_F2, KEY_F3, KEY_F4, KEY_F5,
    KEY_F6, KEY_F7, KEY_F8, KEY_F9, KEY_F10,

    KEY_COUNT
} jlKeyE;

typedef enum {
    MOUSE_BUTTON_NONE   = 0,
    MOUSE_BUTTON_LEFT,
    MOUSE_BUTTON_RIGHT,
    MOUSE_BUTTON_MIDDLE,

    MOUSE_BUTTON_COUNT
} jlMouseButtonE;

typedef enum {
    JOYSTICK_0 = 0,
    JOYSTICK_1,

    JOYSTICK_COUNT
} jlJoystickE;

typedef enum {
    JOY_BUTTON_0 = 0,
    JOY_BUTTON_1,

    JOY_BUTTON_COUNT
} jlJoyButtonE;

#define JOYSTICK_AXIS_MAX   127
#define JOYSTICK_AXIS_MIN   (-127)

void jlInputPoll(void);

// Block until the user presses any key. Internally polls via
// jlInputPoll, so per-port halInputPoll machinery (including
// audio-friendly IRQ-driven samplers) keeps working while the
// wait loop runs.
void jlWaitForAnyKey(void);

bool jlKeyDown(jlKeyE key);
bool jlKeyPressed(jlKeyE key);
bool jlKeyReleased(jlKeyE key);

int16_t jlMouseX(void);
int16_t jlMouseY(void);
bool    jlMouseDown(jlMouseButtonE button);
bool    jlMousePressed(jlMouseButtonE button);
bool    jlMouseReleased(jlMouseButtonE button);

bool   jlJoystickConnected(jlJoystickE js);
int8_t jlJoystickX(jlJoystickE js);
int8_t jlJoystickY(jlJoystickE js);
bool   jlJoyDown(jlJoystickE js, jlJoyButtonE button);
bool   jlJoyPressed(jlJoystickE js, jlJoyButtonE button);
bool   jlJoyReleased(jlJoystickE js, jlJoyButtonE button);

// Re-enable joystick polling and recalibrate the resting (center)
// position. The IIgs port auto-disables polling after a short window
// of detecting no stick (saves ~3 ms/frame of busy-wait). It does NOT
// auto-re-probe -- the application must call this function to resume
// polling after plugging a stick in.
//
// The next poll after this call captures the stick's CURRENT raw
// position as the new center -- so the user must hold the stick
// centered when calling. Subsequent polls report position relative
// to that center; raw readings within `deadZone` units of the center
// clamp to 0 (use 0 to disable the dead zone).
//
// On platforms with truly digital sticks (Amiga / ST / DOS) the
// recalibration is a no-op -- those ports already report -1 / 0 / +1
// directly -- and `deadZone` is ignored. The function still clears
// any auto-disconnect state so polling resumes.
void jlJoystickReset(jlJoystickE js, uint8_t deadZone);

#endif