#ifndef _STATE_TX_H_
#define _STATE_TX_H_

#include <cinttypes>

enum StateID;           ///< Forward-declared identifier type for application states

/**
 * @brief Transition modes defining how the state machine behaves after completing a state.
 */
enum StateTxMode
{
    NO_OP,             ///< No Operation
    REFRESH,           ///< Refresh after end()
    WAIT,              ///< Wait between states
    REFRESH_WAIT,      ///< Refresh then wait
    ERROR              ///< Immediately cancel
};

/**
 * @brief Structure containing metadata for state transitions and timing.
 */
struct StateTx
{
    StateID id;                 ///< Target state identifier
    StateTxMode mode{NO_OP};    ///< Transition mode (defaults to NO_OP)
    uint64_t wait{0};           ///< Wait duration in milliseconds or ticks (defaults to 0)
};

#endif // _STATE_TX_H_