feat: initial commit for pixel-snapping components and helpers

Plugins/ZShell/alignaudit.hpp

@@ -0,0 +1,19 @@
+#pragma once
+#include <QString>
+#include <qtmetamacros.h>
+
+namespace ZShell {
+
+struct Options {
+	QString outputPath = QStringLiteral("/tmp/align-audit.txt");
+	bool paintedOnly = true; // skip items that draw nothing
+	bool includeInherited =
+		false; // also report items only off because an ancestor is
+	double tolerance = 1e-3; // in device pixels
+};
+
+Q_INVOKABLE void runLater(int delayMs, const Options& options = {});
+
+int run(const Options& options = {});
+
+} // namespace ZShell