添加creeper-qt最新依赖

creeper-qt/utility/wrapper/mutable.hh

@@ -0,0 +1,82 @@
+#pragma once
+
+#include <functional>
+#include <qwidget.h>
+
+namespace creeper {
+
+/// @brief 响应式属性包装器，允许属性变更后自动同步到所有已绑定组件。
+///
+/// 该模板用于包装具备 apply 方法的属性类型，使其具备响应式能力。
+/// 通过 Mutable 包装后的属性可以被多个组件共享，
+/// 当属性发生变更时，所有通过 Mutable 绑定的组件会自动更新自身属性，
+/// 达到类似“全局属性联动”的效果。
+///
+/// Usage：
+///   auto mutable_size = Mutable{widget::pro::FixedSize{100, 100}};
+///   auto card_1 = OutlinedCard{mutable_size};
+///   auto card_2 = OutlinedCard{mutable_size};
+///   // 修改 mutable_size，card1/card2 会同步变化
+///   mutable_size = {mutable_size.width() + 10, mutable_size.height() + 10};
+///
+/// @note
+///   1. 不支持将 Mutable 实例放入 std::tuple 进行批量 apply，
+///      必须显式调用 apply 绑定组件。
+///      若允许混入 tuple，容易导致属性的响应式副作用被隐式传播，
+///      使得属性绑定和变更难以追踪，带来较大维护隐患。
+///      显式 apply 可以让响应式属性的边界清晰可控，
+///      便于代码审查和后期维护。
+///
+///   2. Mutable 不支持拷贝和移动构造，需确保唯一性和生命周期安全。
+///
+///   3. 绑定对象被销毁时，内部回调会自动解绑，无内存泄漏风险。
+///
+/// @date 2025.7.28
+template <class T>
+struct Mutable : public T {
+public:
+    explicit Mutable(const T& t) noexcept
+        : T { t } { }
+
+    explicit Mutable(std::constructible_from<T> auto&&... args) noexcept
+        : T { std::forward<decltype(args)>(args)... } { }
+
+    Mutable(const Mutable&) = delete;
+    Mutable(Mutable&&)      = delete;
+
+    auto apply(auto& self) const noexcept -> void {
+        T::apply(self);
+        Mutable::bind(self);
+    }
+    auto bind(auto& self) const noexcept -> void {
+        callbacks_.insert({
+            &self,
+            [&](const T& pro) {
+                pro.apply(self);
+                self.update();
+            },
+        });
+        QObject::connect(&self, &QObject::destroyed, //
+            [pointer = &self, this] { callbacks_.erase(pointer); });
+    }
+    template <typename U>
+    auto set(U&& u) noexcept -> Mutable<T>&
+        requires requires(T& t, U&& u) { t = std::forward<U>(u); }
+    {
+        static_cast<T&>(*this) = std::forward<U>(u);
+        for (const auto& [_, f] : callbacks_)
+            f(*this);
+        return *this;
+    }
+    template <typename U>
+    auto operator=(U&& u) noexcept -> Mutable<T>&
+        requires requires(T& t, U&& u) { t = std::forward<U>(u); }
+    {
+        return set(std::forward<U>(u));
+    }
+
+private:
+    mutable std::unordered_map<QWidget*, std::function<void(const T&)>> callbacks_;
+};
+
+}