#pragma once

/**
 * @file TouchManager.h
 * @brief Capacitive touch button handler for ESP32-S3 native touch pins.
 *
 * Supports three touch pads:
 *   TOUCH_NEXT   — Advance to the next display page
 *   TOUCH_PREV   — Go to the previous display page
 *   TOUCH_ACTION — Trigger a full e-ink refresh
 *
 * Combo detection:
 *   TOUCH_NEXT + TOUCH_PREV held for AP_COMBO_MS → enter WiFi AP mode
 *
 * The ESP32-S3 touch peripheral returns a raw capacitance value; a reading
 * *below* the threshold means the pad is being touched (lower = more contact).
 */

#include "Config.h"

class TouchManager {
public:
    /** @brief Initialise touch pads. Call from setup(). */
    void begin();

    /** @brief Poll all pads; must be called from loop(). */
    void update();

    // ── Event accessors (consumed once per call) ──────────────────────────────
    bool nextPressed()   { bool v = _evNext;   _evNext   = false; return v; }
    bool prevPressed()   { bool v = _evPrev;   _evPrev   = false; return v; }
    bool actionPressed() { bool v = _evAction; _evAction = false; return v; }
    bool apCombo()       { bool v = _evApCombo; _evApCombo = false; return v; }

private:
    // Per-pad state machine
    struct PadState {
        explicit PadState(uint8_t p = 0) : pin(p) {}
        uint8_t  pin;
        bool     wasDown     = false;
        uint32_t pressedAt   = 0;
        bool     longFired   = false;
    };

    PadState _pads[3] = {
        PadState(Pins::TOUCH_NEXT),
        PadState(Pins::TOUCH_PREV),
        PadState(Pins::TOUCH_ACTION)
    };

    uint32_t _lastDebounce = 0;
    uint32_t _comboPressAt = 0;
    bool     _comboActive  = false;

    bool _evNext    = false;
    bool _evPrev    = false;
    bool _evAction  = false;
    bool _evApCombo = false;

    bool _isTouched(uint8_t pin) const;
};

extern TouchManager touchManager;