feat: add clickthrough mask to windows

src/cpp/region.hpp

@@ -0,0 +1,125 @@
+#pragma once
+
+#include <qobject.h>
+#include <qqmlengine.h>
+#include <qqmlintegration.h>
+#include <qqmllist.h>
+#include <qquickitem.h>
+#include <qregion.h>
+#include <qtmetamacros.h>
+#include <qtypes.h>
+
+/// Shape of a Region.
+namespace RegionShape { // NOLINT
+Q_NAMESPACE;
+QML_ELEMENT;
+
+enum Enum {
+	Rect = 0,
+	Ellipse = 1,
+};
+Q_ENUM_NS(Enum);
+
+} // namespace RegionShape
+
+///! Intersection strategy for Regions.
+namespace Intersection { // NOLINT
+Q_NAMESPACE;
+QML_ELEMENT;
+
+enum Enum {
+	/// Combine this region, leaving a union of this and the other region. (opposite of `Subtract`)
+	Combine = 0,
+	/// Subtract this region, cutting this region out of the other. (opposite of `Combine`)
+	Subtract = 1,
+	/// Create an intersection of this region and the other, leaving only
+	/// the area covered by both. (opposite of `Xor`)
+	Intersect = 2,
+	/// Create an intersection of this region and the other, leaving only
+	/// the area not covered by both. (opposite of `Intersect`)
+	Xor = 3,
+};
+Q_ENUM_NS(Enum);
+
+} // namespace Intersection
+
+///! A composable region used as a mask.
+class PendingRegion: public QObject {
+	Q_OBJECT;
+	/// Defaults to `Rect`.
+	Q_PROPERTY(RegionShape::Enum shape MEMBER mShape NOTIFY shapeChanged);
+	/// The way this region interacts with its parent region. Defaults to `Combine`.
+	Q_PROPERTY(Intersection::Enum intersection MEMBER mIntersection NOTIFY intersectionChanged);
+
+	/// The item that determines the geometry of the region.
+	/// `item` overrides `x`, `y`, `width` and `height`.
+	Q_PROPERTY(QQuickItem* item MEMBER mItem WRITE setItem NOTIFY itemChanged);
+
+	/// Defaults to 0. Does nothing if `item` is set.
+	Q_PROPERTY(qint32 x MEMBER mX NOTIFY xChanged);
+	/// Defaults to 0. Does nothing if `item` is set.
+	Q_PROPERTY(qint32 y MEMBER mY NOTIFY yChanged);
+	/// Defaults to 0. Does nothing if `item` is set.
+	Q_PROPERTY(qint32 width MEMBER mWidth NOTIFY widthChanged);
+	/// Defaults to 0. Does nothing if `item` is set.
+	Q_PROPERTY(qint32 height MEMBER mHeight NOTIFY heightChanged);
+
+	/// Regions to apply on top of this region.
+	///
+	/// Regions can be nested to create a more complex region.
+	/// For example this will create a square region with a cutout in the middle.
+	/// ```qml
+	/// Region {
+	///   width: 100; height: 100;
+	///
+	///   Region {
+	///     x: 50; y: 50;
+	///     width: 50; height: 50;
+	///     intersection: Intersection.Subtract
+	///   }
+	/// }
+	/// ```
+	Q_PROPERTY(QQmlListProperty<PendingRegion> regions READ regions);
+	Q_CLASSINFO("DefaultProperty", "regions");
+	QML_NAMED_ELEMENT(Region);
+
+public:
+	explicit PendingRegion(QObject* parent = nullptr);
+
+	void setItem(QQuickItem* item);
+
+	QQmlListProperty<PendingRegion> regions();
+
+	[[nodiscard]] bool empty() const;
+	[[nodiscard]] QRegion build() const;
+	[[nodiscard]] QRegion applyTo(QRegion& region) const;
+
+	RegionShape::Enum mShape = RegionShape::Rect;
+	Intersection::Enum mIntersection = Intersection::Combine;
+
+signals:
+	void shapeChanged();
+	void intersectionChanged();
+	void itemChanged();
+	void xChanged();
+	void yChanged();
+	void widthChanged();
+	void heightChanged();
+	void childrenChanged();
+	void changed();
+
+private slots:
+	void onItemDestroyed();
+
+private:
+	static void regionsAppend(QQmlListProperty<PendingRegion>* prop, PendingRegion* region);
+
+	QQuickItem* mItem = nullptr;
+
+	qint32 mX = 0;
+	qint32 mY = 0;
+	qint32 mWidth = 0;
+	qint32 mHeight = 0;
+
+	QList<PendingRegion*> mRegions;
+};