SignalManager.hpp

//
// TGUI - Texus' Graphical User Interface
// Copyright (C) 2012-2026 Bruno Van de Velde (vdv_b@tgui.eu)
//
// This software is provided 'as-is', without any express or implied warranty.
// In no event will the authors be held liable for any damages arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it freely,
// subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented;
//    you must not claim that you wrote the original software.
//    If you use this software in a product, an acknowledgment
//    in the product documentation would be appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such,
//    and must not be misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source distribution.
//
 
#ifndef TGUI_SIGNAL_MANAGER_HPP
#define TGUI_SIGNAL_MANAGER_HPP
 
#include <TGUI/Widget.hpp>
 
#include <memory>
#include <unordered_map>

 
namespace tgui
{
 
    class TGUI_API SignalManager
    {
    public:
        using Ptr = std::shared_ptr<SignalManager>;            
        using ConstPtr = std::shared_ptr<const SignalManager>; 
 
        using Delegate = std::function<void()>;
        using DelegateEx = std::function<void(std::shared_ptr<Widget>, const String&)>;
 
        using Weak = std::weak_ptr<Widget>;
        using SignalID = unsigned int;
 
        struct SignalTuple
        {
            String widgetName;
            String signalName;
            std::pair<Delegate, DelegateEx> func;
        };
 
        struct ConnectedSignalTuple
        {
            SignalID signalId;
            Weak widget;
            unsigned int signalWidgetID;
 
            ConnectedSignalTuple(SignalID sigId, Weak widgetPtr, unsigned int widgetId) :
                signalId(sigId),
                widget(std::move(widgetPtr)),
                signalWidgetID(widgetId)
            {
            }
        };

        SignalManager() = default;

        virtual ~SignalManager() = default;

        static void setDefaultSignalManager(const SignalManager::Ptr& manager);

        [[nodiscard]] static SignalManager::Ptr getSignalManager();

        template <typename Func, typename... BoundArgs>
        unsigned int connect(String widgetName, String signalName, Func&& handler, const BoundArgs&... args);

        virtual bool disconnect(unsigned int id);

        virtual void disconnectAll();

        virtual void add(const Widget::Ptr& widgetPtr);

        virtual void remove(Widget* widget);

 
    private:
        unsigned int generateUniqueId();
 
        unsigned int m_lastId = 0;

 
    protected:
        [[nodiscard]] static std::pair<Delegate, DelegateEx> makeSignal(const Delegate& handle);

        [[nodiscard]] static std::pair<Delegate, DelegateEx> makeSignalEx(const DelegateEx& handle);

        virtual void connect(SignalID id);

 
        static SignalManager::Ptr m_manager;
 
        std::vector<Weak> m_widgets;
        std::unordered_map<SignalID, SignalTuple> m_signals;
        std::vector<ConnectedSignalTuple> m_connectedSignals;
    };

 
    template <typename Func, typename... BoundArgs>
    unsigned int SignalManager::connect(String widgetName, String signalName, Func&& handler, const BoundArgs&... args)
    {
        const unsigned int id = generateUniqueId();
        auto fwdHandler = std::forward<Func>(handler);
 
        constexpr bool takesCallerArgs = std::is_invocable_v<Func, BoundArgs..., const std::shared_ptr<Widget>&, const String&>;
        if constexpr (takesCallerArgs)
        {
            m_signals[id] = {widgetName,
                             signalName,
                             makeSignalEx([f = fwdHandler, args...](const std::shared_ptr<Widget>& w, const String& s)
                                          { std::invoke(f, args..., w, s); })};
        }
        else
        {
            m_signals[id] = {widgetName, signalName, makeSignal([f = fwdHandler, args...] { std::invoke(f, args...); })};
        }
 
        connect(id);
        return id;
    }
} // namespace tgui
 
#endif // TGUI_SIGNAL_MANAGER_HPP