GuiTrigger.h

/****************************************************************************
 * libgui
 * Daryl Borth 2009-2026
 * GuiTrigger.h
 *
 * Menu input trigger management.
 * Acts as a generic UI condition matcher for GuiElements
 ***************************************************************************/
#pragma once
 
#include <cstdint>

enum class TRIGGER_TYPE {
    SIMPLE,
    HELD,
    BUTTON_ONLY,
    BUTTON_ONLY_IN_FOCUS
};

enum class TRIGGER_ACTION {
    NONE,      // Explicit button mask provided
    PRIMARY,   // Semantic Accept: A (Vertical) or 2 (Sideways)
    SECONDARY  // Semantic Cancel: B (Vertical) or 1 (Sideways)
};

class GuiTrigger {
public:
    GuiTrigger();
    ~GuiTrigger() = default;

    // Automatically resolves to A/2 or B/1 based on controller orientation
    void setPrimaryTrigger(int ch = -1);
    void setSecondaryTrigger(int ch = -1);

    void setSimpleTrigger(int ch, uint32_t buttonMask);

    void setHeldTrigger(int ch, uint32_t buttonMask);

    void setButtonOnlyTrigger(int ch, uint32_t buttonMask);

    void setButtonOnlyInFocusTrigger(int ch, uint32_t buttonMask);

    bool isClicked(const InputController* controller) const;
    bool isHeld(const InputController* controller) const;
    bool isReleased(const InputController* controller) const;

    TRIGGER_TYPE getType() const { return type; }
    int getChannel() const { return chan; }
 
private:
    TRIGGER_TYPE type;
    TRIGGER_ACTION action;
    int chan;
    uint32_t conditionMask;

    uint32_t resolveMask(const InputController* controller) const;
};