Program Listing for File keyboard_trigger.hpp

↰ Return to documentation for file (src/trigger/keyboard_trigger.hpp)

#pragma once
#include <QKeySequence>
#include <QObject>

#include "core/settings.hpp"
#include "trigger/trigger_types.hpp"

namespace mosaic {

// One keyboard trigger. Installed as a QCoreApplication event filter so it
// catches key events from any focused widget inside the app.
// Does NOT fire when a QKeySequenceEdit is focused (prevents double-triggering
// while the user is recording a new key binding).

class KeyboardTrigger : public QObject {
    Q_OBJECT
   public:
    explicit KeyboardTrigger(KeyTriggerConfig& config, QObject* parent = nullptr);
    ~KeyboardTrigger() override;

    void set_active(bool active);
    [[nodiscard]] bool is_active() const { return m_active; }

    // Call after the config's keySeq string changes to re-parse it.
    void reload_key_sequence();

    [[nodiscard]] int fire_count() const { return m_fireCount; }
    void reset_count();

    bool eventFilter(QObject* obj, QEvent* event) override;

   signals:
    void triggered(mosaic::TriggerEvent event);
    void count_changed(int count);

   private:
    KeyTriggerConfig& m_config;
    QKeySequence m_keySeq;
    bool m_active{false};
    int m_fireCount{0};

    // Explicit key-down state, so a physical press only ever fires once
    // regardless of *why* the platform delivered more than one KeyPress
    // event for it (OS auto-repeat — see isAutoRepeat() below — or any
    // other source of duplicate delivery). Reset on the matching
    // KeyRelease. m_keyDownAtNs guards against a release that's never
    // seen at all (e.g. focus moves to another application mid-press) —
    // without it, one lost release would permanently wedge this trigger.
    bool m_keyDown{false};
    int64_t m_keyDownAtNs{0};
};

} // namespace mosaic