btn-recognizer 0.2.2

Timestamp-driven button debouncing with multi-tap, hold, repeat, and multi-key chord gesture recognition
Documentation
//! Finite control state for a logical control's gesture session.

use crate::fsm_engine::Fsm;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub(crate) enum State {
    Idle,
    Pressed,
    AwaitNextTap,
    Holding,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub(crate) enum Event {
    Down,
    UpTapWait,
    UpTapComplete,
    UpInvalid,
    HoldReached,
    HoldMilestoneReached,
    RepeatDue,
    TapWindowExpired,
    HeldUp,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(crate) enum Motion {
    StartPress,
    RecordTap,
    CompleteTap,
    AbortPress,
    StartHold,
    EmitHoldMilestone,
    EmitRepeat,
    CompleteHold,
}

pub(crate) fn new() -> Fsm<State, Event, Motion> {
    use Event::{
        Down, HeldUp, HoldMilestoneReached, HoldReached, RepeatDue, TapWindowExpired, UpInvalid,
        UpTapComplete, UpTapWait,
    };
    use Motion::{
        AbortPress, CompleteHold, CompleteTap, EmitHoldMilestone, EmitRepeat, RecordTap, StartHold,
        StartPress,
    };
    use State::{AwaitNextTap, Holding, Idle, Pressed};

    Fsm::builder()
        .initial_state(Idle)
        .on(Idle, Down, Pressed, StartPress)
        .on(AwaitNextTap, Down, Pressed, StartPress)
        .on(Pressed, UpTapWait, AwaitNextTap, RecordTap)
        .on(Pressed, UpTapComplete, Idle, CompleteTap)
        .on(Pressed, UpInvalid, Idle, AbortPress)
        .on(Pressed, HoldReached, Holding, StartHold)
        .on(Holding, HoldMilestoneReached, Holding, EmitHoldMilestone)
        .on(Holding, RepeatDue, Holding, EmitRepeat)
        .on(AwaitNextTap, TapWindowExpired, Idle, CompleteTap)
        .on(Holding, HeldUp, Idle, CompleteHold)
        .build()
        .expect("the gesture transition table is valid")
}