object: add property APIs

Author: ammen99

src/api/wayfire/object.hpp

@@ -2,6 +2,7 @@
 #define OBJECT_HPP
 
 #include <typeinfo>
+#include <optional>
 #include <memory>
 #include <string>
 #include <cstdint>
@@ -24,6 +25,13 @@ class custom_data_t
     custom_data_t& operator =(const custom_data_t& other) = default;
 };
 
+template<class T>
+class property_data_t : public custom_data_t
+{
+  public:
+    T value;
+};
+
 /**
  * A base class for "objects". Objects provide signals and ways for plugins to
  * store custom data about the object.
@@ -114,6 +122,44 @@ class object_base_t
 
     virtual ~object_base_t();
 
+    bool has_property(std::string name)
+    {
+        return has_data(name);
+    }
+
+    template<class T>
+    std::optional<T> get_property(std::string name)
+    {
+        auto data = get_data<property_data_t<T>>(name);
+        if (!data)
+        {
+            return {};
+        }
+
+        return data->value;
+    }
+
+    template<class T>
+    void set_property(std::string name, T value)
+    {
+        auto data = get_data<property_data_t<T>>(name);
+        if (has_data(name) && !data)
+        {
+            _warn_wrong_type(name);
+            return;
+        }
+
+        if (!data)
+        {
+            auto prop = std::make_unique<property_data_t<T>>();
+            prop->value = value;
+            store_data<property_data_t<T>>(std::move(prop), name);
+        } else
+        {
+            data->value = value;
+        }
+    }
+
     object_base_t(const object_base_t &) = delete;
     object_base_t(object_base_t &&) = delete;
     object_base_t& operator =(const object_base_t&) = delete;
@@ -135,6 +181,8 @@ class object_base_t
     /** Store the given data under the given name */
     void _store_data(std::unique_ptr<custom_data_t> data, std::string name);
 
+    void _warn_wrong_type(std::string name);
+
     class obase_impl;
     std::unique_ptr<obase_impl> obase_priv;
 };

src/api/wayfire/plugin.hpp

@@ -107,7 +107,7 @@ using wayfire_plugin_load_func = wf::plugin_interface_t * (*)();
 /**
  * The version is defined as macro as well, to allow conditional compilation.
  */
-#define WAYFIRE_API_ABI_VERSION_MACRO 2025'09'09
+#define WAYFIRE_API_ABI_VERSION_MACRO 2025'09'11
 
 /**
  * The version of Wayfire's API/ABI

src/core/object.cpp

@@ -2,6 +2,7 @@
 #include <unordered_map>
 #include <wayfire/signal-provider.hpp>
 #include <wayfire/nonstd/safe-list.hpp>
+#include <wayfire/util/log.hpp>
 
 struct wf::signal::provider_t::impl
 {
@@ -139,3 +140,9 @@ void wf::object_base_t::_clear_data()
         erase_data(key);
     }
 }
+
+void wf::object_base_t::_warn_wrong_type(std::string name)
+{
+    LOGW("Tried to access data with name '", name, "' using the wrong type. Actual type: ",
+        typeid(_fetch_data(name)).name());
+}