config moved to c++ plugin, removed old qml + fileview implementation

Plugins/ZShell/CMakeLists.txt

@@ -78,3 +78,4 @@ add_subdirectory(Internal)
 add_subdirectory(Services)
 add_subdirectory(Components)
 add_subdirectory(Blobs)
+add_subdirectory(Config)

Plugins/ZShell/Config/Appearance.cpp

@@ -0,0 +1,40 @@
+#include "Appearance.hpp"
+
+Anim::Anim(QObject *parent) : ConfigSection(parent) {
+    m_mediaGifSpeedAdjustment = 300;
+    m_sessionGifSpeed = 0.7;
+    wireSignals();
+}
+
+Deform::Deform(QObject *parent) : ConfigSection(parent) {
+    m_scale = 1;
+    wireSignals();
+}
+
+FontFamily::FontFamily(QObject *parent) : ConfigSection(parent) {
+    m_clock = QStringLiteral("Rubik");
+    m_material = QStringLiteral("Material Symbols Rounded");
+    m_mono = QStringLiteral("SegoeUI Variable");
+    m_sans = QStringLiteral("SegoeUI Variable");
+    wireSignals();
+}
+
+Font::Font(QObject *parent) : ConfigSection(parent) {
+    m_family = new FontFamily(this);
+    wireSignals();
+}
+
+Transparency::Transparency(QObject *parent) : ConfigSection(parent) {
+    m_base = 0.75;
+    m_enabled = true;
+    m_layers = 0.4;
+    wireSignals();
+}
+
+Appearance::Appearance(QObject *parent) : ConfigSection(parent) {
+    m_anim = new Anim(this);
+    m_deform = new Deform(this);
+    m_font = new Font(this);
+    m_transparency = new Transparency(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Appearance.hpp

@@ -0,0 +1,78 @@
+#pragma once
+
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+// NOTE: multiple classes per file is fine - moc processes every Q_OBJECT
+// class it finds in a header, regardless of how many. Config.appearance.anim
+// works purely through object composition (Appearance owns an Anim*), which
+// has nothing to do with how the files are split.
+
+class Anim : public ConfigSection {
+    Q_OBJECT
+    QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, mediaGifSpeedAdjustment, MediaGifSpeedAdjustment)
+    CFG_PROPERTY(qreal, sessionGifSpeed, SessionGifSpeed)
+
+public:
+    explicit Anim(QObject *parent = nullptr);
+};
+
+class Deform : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(qreal, scale, Scale)
+
+public:
+    explicit Deform(QObject *parent = nullptr);
+};
+
+class FontFamily : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(QString, clock, Clock)
+    CFG_PROPERTY(QString, material, Material)
+    CFG_PROPERTY(QString, mono, Mono)
+    CFG_PROPERTY(QString, sans, Sans)
+
+public:
+    explicit FontFamily(QObject *parent = nullptr);
+};
+
+class Font : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_SECTION(FontFamily, family, Family)
+
+public:
+    explicit Font(QObject *parent = nullptr);
+};
+
+class Transparency : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(qreal, base, Base)
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(qreal, layers, Layers)
+
+public:
+    explicit Transparency(QObject *parent = nullptr);
+};
+
+class Appearance : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_SECTION(Anim, anim, Anim)
+    CFG_SECTION(Deform, deform, Deform)
+    CFG_SECTION(Font, font, Font)
+    CFG_SECTION(Transparency, transparency, Transparency)
+
+public:
+    explicit Appearance(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Background.cpp

@@ -0,0 +1,7 @@
+#include "Background.hpp"
+
+Background::Background(QObject *parent) : ConfigSection(parent) {
+    m_enabled = true;
+    m_wallFadeDuration = 300;
+    wireSignals();
+}

Plugins/ZShell/Config/Background.hpp

@@ -0,0 +1,14 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class Background : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(int, wallFadeDuration, WallFadeDuration)
+
+public:
+    explicit Background(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Bar.cpp

@@ -0,0 +1,63 @@
+#include "Bar.hpp"
+
+namespace {
+QVariantMap entry(bool enabled, const char *id) {
+    QVariantMap m;
+    m["enabled"] = enabled;
+    m["id"] = QString::fromLatin1(id);
+    return m;
+}
+}
+
+Popouts::Popouts(QObject *parent) : ConfigSection(parent) {
+    m_statusIcons = true;
+    m_tray = true;
+    wireSignals();
+}
+
+Tray::Tray(QObject *parent) : ConfigSection(parent) {
+    m_recolorIcons = false;
+    m_showOnHover = true;
+    m_statusIcons = {
+        entry(true, "audio"),
+        entry(true, "microphone"),
+        entry(true, "bluetooth"),
+        entry(false, "network"),
+        entry(false, "wifi"),
+        entry(true, "power"),
+    };
+    m_trayIconSize = 24;
+    wireSignals();
+}
+
+Bar::Bar(QObject *parent) : ConfigSection(parent) {
+    m_autoHide = false;
+    m_border = 4;
+    m_entries = {
+        entry(true, "workspaces"),
+        entry(true, "audio"),
+        entry(true, "media"),
+        entry(true, "resources"),
+        entry(true, "updates"),
+        entry(false, "dash"),
+        entry(true, "spacer"),
+        entry(true, "activeWindow"),
+        entry(true, "spacer"),
+        entry(true, "hyprsunset"),
+        entry(true, "tray"),
+        entry(true, "statusIcons"),
+        entry(false, "network"),
+        entry(true, "upower"),
+        entry(true, "clock"),
+        entry(true, "notifBell"),
+    };
+    m_fullscreenReveal = true;
+    m_height = 24;
+    m_hideWhenNotif = true;
+    m_popouts = new Popouts(this);
+    m_revealDelay = 100;
+    m_rounding = 14;
+    m_smoothing = 32;
+    m_tray = new Tray(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Bar.hpp

@@ -0,0 +1,52 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QVariantList>
+
+class Popouts : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, statusIcons, StatusIcons)
+    CFG_PROPERTY(bool, tray, Tray)
+
+public:
+    explicit Popouts(QObject *parent = nullptr);
+};
+
+class Tray : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, recolorIcons, RecolorIcons)
+    CFG_PROPERTY(bool, showOnHover, ShowOnHover)
+    // Array of { enabled, id } objects. QML can't mutate array elements in
+    // place - assign the whole list back to change it, e.g.
+    // Config.bar.tray.statusIcons = updatedList
+    CFG_PROPERTY(QVariantList, statusIcons, StatusIcons)
+    CFG_PROPERTY(int, trayIconSize, TrayIconSize)
+
+public:
+    explicit Tray(QObject *parent = nullptr);
+};
+
+class Bar : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, autoHide, AutoHide)
+    CFG_PROPERTY(int, border, Border)
+    // Array of { enabled, id } objects, in display order.
+    CFG_PROPERTY(QVariantList, entries, Entries)
+    CFG_PROPERTY(bool, fullscreenReveal, FullscreenReveal)
+    CFG_PROPERTY(int, height, Height)
+    CFG_PROPERTY(bool, hideWhenNotif, HideWhenNotif)
+    CFG_SECTION(Popouts, popouts, Popouts)
+    CFG_PROPERTY(int, revealDelay, RevealDelay)
+    CFG_PROPERTY(int, rounding, Rounding)
+    CFG_PROPERTY(int, smoothing, Smoothing)
+    CFG_SECTION(Tray, tray, Tray)
+
+public:
+    explicit Bar(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/CMakeLists.txt

@@ -0,0 +1,24 @@
+qml_module(ZShell-config
+	URI ZShell.Config
+	SOURCES
+		ConfigSection.hpp ConfigSection.cpp
+		Config.hpp Config.cpp
+		Tokens.hpp Tokens.cpp
+		Appearance.hpp Appearance.cpp
+		Background.hpp Background.cpp
+		Bar.hpp Bar.cpp
+		Clipboard.hpp Clipboard.cpp
+		Colors.hpp Colors.cpp
+		Dashboard.hpp Dashboard.cpp
+		Dock.hpp Dock.cpp
+		General.hpp General.cpp
+		Launcher.hpp Launcher.cpp
+		Lock.hpp Lock.cpp
+		Notifs.hpp Notifs.cpp
+		Osd.hpp Osd.cpp
+		Overview.hpp Overview.cpp
+		Screenshot.hpp Screenshot.cpp
+		Services.hpp Services.cpp
+		Sidebar.hpp Sidebar.cpp
+		Utilities.hpp Utilities.cpp
+)

Plugins/ZShell/Config/Clipboard.cpp

@@ -0,0 +1,16 @@
+#include "Clipboard.hpp"
+
+ClipboardSizes::ClipboardSizes(QObject *parent) : ConfigSection(parent) {
+    m_itemHeight = 60;
+    m_minPreviewWidth = 200;
+    m_previewWidth = 800;
+    m_width = 500;
+    wireSignals();
+}
+
+Clipboard::Clipboard(QObject *parent) : ConfigSection(parent) {
+    m_enabled = true;
+    m_maxEntriesShown = 10;
+    m_sizes = new ClipboardSizes(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Clipboard.hpp

@@ -0,0 +1,28 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class ClipboardSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, itemHeight, ItemHeight)
+    CFG_PROPERTY(int, minPreviewWidth, MinPreviewWidth)
+    CFG_PROPERTY(int, previewWidth, PreviewWidth)
+    CFG_PROPERTY(int, width, Width)
+
+public:
+    explicit ClipboardSizes(QObject *parent = nullptr);
+};
+
+class Clipboard : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(int, maxEntriesShown, MaxEntriesShown)
+    CFG_SECTION(ClipboardSizes, sizes, Sizes)
+
+public:
+    explicit Clipboard(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Colors.cpp

@@ -0,0 +1,14 @@
+#include "Colors.hpp"
+
+Presets::Presets(QObject *parent) : ConfigSection(parent) {
+    m_accent = QString();
+    m_name = QStringLiteral("Catppuccin");
+    m_variant = QStringLiteral("latte");
+    wireSignals();
+}
+
+Colors::Colors(QObject *parent) : ConfigSection(parent) {
+    m_presets = new Presets(this);
+    m_schemeType = QStringLiteral("fidelity");
+    wireSignals();
+}

Plugins/ZShell/Config/Colors.hpp

@@ -0,0 +1,26 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class Presets : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(QString, accent, Accent)
+    CFG_PROPERTY(QString, name, Name)
+    CFG_PROPERTY(QString, variant, Variant)
+
+public:
+    explicit Presets(QObject *parent = nullptr);
+};
+
+class Colors : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_SECTION(Presets, presets, Presets)
+    CFG_PROPERTY(QString, schemeType, SchemeType)
+
+public:
+    explicit Colors(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Config.cpp

@@ -0,0 +1,137 @@
+#include "Config.hpp"
+
+#include <QFile>
+#include <QSaveFile>
+#include <QJsonDocument>
+#include <QStandardPaths>
+#include <QDir>
+#include <QDebug>
+#include <QFutureWatcher>
+
+Config::Config(QObject* parent) : ConfigSection(parent) {
+	m_appearance = new Appearance(this);
+	m_background = new Background(this);
+	m_bar = new Bar(this);
+	m_clipboard = new Clipboard(this);
+	m_colors = new Colors(this);
+	m_dashboard = new Dashboard(this);
+	m_dock = new Dock(this);
+	m_general = new General(this);
+	m_launcher = new Launcher(this);
+	m_lock = new Lock(this);
+	m_notifs = new Notifs(this);
+	m_osd = new Osd(this);
+	m_overview = new Overview(this);
+	m_screenshot = new Screenshot(this);
+	m_services = new Services(this);
+	m_sidebar = new Sidebar(this);
+	m_utilities = new Utilities(this);
+	wireSignals(); // forwards every child's changed() up to our own changed()
+
+	connect(this, &ConfigSection::changed, this, &Config::scheduleSave);
+
+	m_saveTimer.setSingleShot(true);
+	m_saveTimer.setInterval(
+		300); // debounce: coalesce rapid-fire edits (e.g. dragging a slider)
+	connect(&m_saveTimer, &QTimer::timeout, this, &Config::flushAsync);
+
+	loadSync();
+	m_firstLoadDone = true;
+}
+
+Config* Config::create(QQmlEngine*, QJSEngine*) {
+	// The QML engine takes ownership of singletons created this way.
+	return new Config();
+}
+
+QString Config::filePath() const {
+	const QString dir =
+		QStandardPaths::writableLocation(QStandardPaths::ConfigLocation) +
+		QStringLiteral("/zshell");
+	QDir().mkpath(dir);
+	return dir + QStringLiteral("/config.json");
+}
+
+void Config::loadSync() {
+	m_loading =
+		true; // suppress scheduleSave() while properties are set from disk
+	QFile f(filePath());
+	if (f.open(QIODevice::ReadOnly)) {
+		const auto doc = QJsonDocument::fromJson(f.readAll());
+		if (doc.isObject()) fromJson(doc.object());
+	} else {
+		qInfo() << "Config: no existing config at" << filePath()
+				<< "- using defaults";
+	}
+	m_loading = false;
+}
+
+void Config::loadAsync() {
+	m_loading = true;
+	auto future = QtConcurrent::run([this]() {
+		QFile f(filePath());
+		if (f.open(QIODevice::ReadOnly)) {
+			const auto doc = QJsonDocument::fromJson(f.readAll());
+			if (doc.isObject()) {
+				QMetaObject::invokeMethod(this, [this, doc]() {
+					fromJson(doc.object());
+					m_loading = false;
+				}, Qt::QueuedConnection);
+			} else {
+				QMetaObject::invokeMethod(this, [this]() {
+					m_loading = false;
+				}, Qt::QueuedConnection);
+			}
+		} else {
+			qInfo() << "Config: failed to reload from" << filePath()
+					<< "- using in-memory values";
+			QMetaObject::invokeMethod(this, [this]() {
+				m_loading = false;
+			}, Qt::QueuedConnection);
+		}
+	});
+	m_loadFuture = future;
+}
+
+void Config::load() {
+	if (!m_firstLoadDone) {
+		loadSync();
+	} else {
+		loadAsync();
+	}
+}
+
+void Config::reloadAsync() {
+	loadAsync();
+}
+
+void Config::scheduleSave() {
+	if (m_loading) return;
+	m_saveTimer.start(); // restarts the window if it's already running
+}
+
+void Config::flushAsync() {
+	auto future = QtConcurrent::run([this]() {
+		const QByteArray data = QJsonDocument(toJson()).toJson(QJsonDocument::Indented);
+		writeAtomically(data);
+	});
+}
+
+void Config::saveNow() {
+	m_saveTimer.stop();
+	flushAsync();
+}
+
+void Config::writeAtomically(const QByteArray& data) {
+	// QSaveFile writes to a temp file next to the target and atomically
+	// renames it into place on commit() - a crash or power loss mid-write
+	// can never leave config.json half-written.
+	QSaveFile f(filePath());
+	if (!f.open(QIODevice::WriteOnly)) {
+		qWarning() << "Config: failed to open for atomic write:"
+				   << f.errorString();
+		return;
+	}
+	f.write(data);
+	if (!f.commit()) qWarning() << "Config: commit failed:" << f.errorString();
+}

Plugins/ZShell/Config/Config.hpp

@@ -0,0 +1,86 @@
+#pragma once
+
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QTimer>
+#include <QtConcurrent/QtConcurrent>
+#include <QFuture>
+
+#include "Appearance.hpp"
+#include "Background.hpp"
+#include "Bar.hpp"
+#include "Clipboard.hpp"
+#include "Colors.hpp"
+#include "Dashboard.hpp"
+#include "Dock.hpp"
+#include "General.hpp"
+#include "Launcher.hpp"
+#include "Lock.hpp"
+#include "Notifs.hpp"
+#include "Osd.hpp"
+#include "Overview.hpp"
+#include "Screenshot.hpp"
+#include "Services.hpp"
+#include "Sidebar.hpp"
+#include "Utilities.hpp"
+
+class QQmlEngine;
+class QJSEngine;
+
+// The central hub. Exposed to QML as a singleton, so `Config.appearance.
+// anim.sessionGifSpeed` just works from anywhere without an import context
+// juggle. Every top-level JSON key is a CFG_SECTION child object; the
+// generic load()/save() logic lives entirely in ConfigSection, this class
+// only adds: the file path, the debounced/atomic write, and the QML
+// singleton factory.
+class Config : public ConfigSection {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+
+	CFG_SECTION(Appearance, appearance, Appearance)
+	CFG_SECTION(Background, background, Background)
+	CFG_SECTION(Bar, bar, Bar)
+	CFG_SECTION(Clipboard, clipboard, Clipboard)
+	CFG_SECTION(Colors, colors, Colors)
+	CFG_SECTION(Dashboard, dashboard, Dashboard)
+	CFG_SECTION(Dock, dock, Dock)
+	CFG_SECTION(General, general, General)
+	CFG_SECTION(Launcher, launcher, Launcher)
+	CFG_SECTION(Lock, lock, Lock)
+	CFG_SECTION(Notifs, notifs, Notifs)
+	CFG_SECTION(Osd, osd, Osd)
+	CFG_SECTION(Overview, overview, Overview)
+	CFG_SECTION(Screenshot, screenshot, Screenshot)
+	CFG_SECTION(Services, services, Services)
+	CFG_SECTION(Sidebar, sidebar, Sidebar)
+	CFG_SECTION(Utilities, utilities, Utilities)
+
+	public:
+	explicit Config(QObject* parent = nullptr);
+	static Config* create(QQmlEngine*, QJSEngine*);
+
+	// Reload from disk, discarding any unsaved in-memory changes.
+	// Synchronous for first load on startup, async for subsequent reloads.
+	Q_INVOKABLE void load();
+	// Force an immediate synchronous write, bypassing the debounce timer.
+	// Call this from your shell's shutdown handler so nothing gets lost.
+	Q_INVOKABLE void saveNow();
+	// Reload from disk asynchronously (for file change notifications).
+	Q_INVOKABLE void reloadAsync();
+
+	private Q_SLOTS:
+	void scheduleSave();
+	void flushAsync();
+
+	private:
+	QString filePath() const;
+	void writeAtomically(const QByteArray& data);
+	void loadSync();
+	void loadAsync();
+
+	QTimer m_saveTimer;
+	bool m_loading = false;
+	bool m_firstLoadDone = false;
+	QFuture<void> m_loadFuture;
+};

Plugins/ZShell/Config/ConfigSection.cpp

@@ -0,0 +1,87 @@
+#include "ConfigSection.hpp"
+
+#include <QMetaType>
+#include <QVariant>
+
+namespace {
+// Property index to start scanning from - skips QObject's own "objectName"
+// property, which we never want in the JSON.
+int firstOwnProperty() {
+    return QObject::staticMetaObject.propertyCount();
+}
+}
+
+ConfigSection::ConfigSection(QObject *parent) : QObject(parent) {}
+
+void ConfigSection::wireSignals() {
+    if (m_wired) return;
+    m_wired = true;
+
+    const QMetaObject *mo = metaObject();
+    const int slotIdx = mo->indexOfSlot("onPropertyChanged()");
+    Q_ASSERT(slotIdx != -1);
+    const QMetaMethod slot = mo->method(slotIdx);
+
+    const int start = firstOwnProperty();
+    for (int i = start; i < mo->propertyCount(); ++i) {
+        const QMetaProperty prop = mo->property(i);
+
+        if (prop.metaType().flags().testFlag(QMetaType::PointerToQObject)) {
+            if (auto *child = qobject_cast<ConfigSection *>(prop.read(this).value<QObject *>())) {
+                // Child sections bubble their changes straight up as our
+                // own changed() - no need to also react to our own notify.
+                connect(child, &ConfigSection::changed, this, &ConfigSection::changed);
+                continue;
+            }
+        }
+
+        if (prop.hasNotifySignal())
+            connect(this, prop.notifySignal(), this, slot);
+    }
+}
+
+void ConfigSection::onPropertyChanged() {
+    Q_EMIT changed();
+}
+
+void ConfigSection::fromJson(const QJsonObject &obj) {
+    const QMetaObject *mo = metaObject();
+    const int start = firstOwnProperty();
+
+    for (int i = start; i < mo->propertyCount(); ++i) {
+        const QMetaProperty prop = mo->property(i);
+        const QLatin1String name(prop.name());
+
+        if (!obj.contains(name)) continue;
+
+        if (prop.metaType().flags().testFlag(QMetaType::PointerToQObject)) {
+            if (auto *child = qobject_cast<ConfigSection *>(prop.read(this).value<QObject *>())) {
+                child->fromJson(obj.value(name).toObject());
+                continue;
+            }
+        }
+
+        if (prop.isWritable())
+            prop.write(this, obj.value(name).toVariant());
+    }
+}
+
+QJsonObject ConfigSection::toJson() const {
+    QJsonObject obj;
+    const QMetaObject *mo = metaObject();
+    const int start = firstOwnProperty();
+
+    for (int i = start; i < mo->propertyCount(); ++i) {
+        const QMetaProperty prop = mo->property(i);
+
+        if (prop.metaType().flags().testFlag(QMetaType::PointerToQObject)) {
+            if (auto *child = qobject_cast<ConfigSection *>(prop.read(this).value<QObject *>())) {
+                obj.insert(QLatin1String(prop.name()), child->toJson());
+                continue;
+            }
+        }
+
+        obj.insert(QLatin1String(prop.name()), QJsonValue::fromVariant(prop.read(this)));
+    }
+    return obj;
+}

Plugins/ZShell/Config/ConfigSection.hpp

@@ -0,0 +1,82 @@
+#pragma once
+
+#include <QObject>
+#include <QJsonObject>
+#include <QJsonValue>
+#include <QMetaProperty>
+#include <QMetaMethod>
+
+// ---------------------------------------------------------------------------
+// CFG_PROPERTY / CFG_SECTION
+//
+// These generate exactly the boilerplate you'd write by hand for a
+// Q_PROPERTY with a backing member, getter, setter and NOTIFY signal - just
+// in one line instead of ~8. Because everything they generate is a normal
+// compiled getter/setter, there is *zero* extra runtime cost vs hand-written
+// code: reading Config.appearance.anim.sessionGifSpeed from QML calls a
+// plain inline getter. Reflection (QMetaObject) is only walked at load time,
+// save time, and once at construction time to wire change signals - never
+// on the read/write path itself.
+//
+// CFG_PROPERTY(type, name, Name)
+//   - type: C++ type (bool, int, qreal, QString, QVariantList, ...)
+//   - name: property name as it must appear in the JSON file (camelCase,
+//           or whatever the JSON actually uses - it MUST match exactly)
+//   - Name: same name, capitalized, used to build setName()/NameChanged()
+//
+// CFG_SECTION(Type, name, Name)
+//   - Declares a child ConfigSection* property (e.g. Anim inside Appearance)
+//   - The pointer itself is CONSTANT (never reassigned); the object it
+//     points to is what actually changes.
+// ---------------------------------------------------------------------------
+
+#define CFG_PROPERTY(type, name, Name)                                       \
+    Q_PROPERTY(type name READ name WRITE set##Name NOTIFY Name##Changed)     \
+public:                                                                       \
+    type name() const { return m_##name; }                                   \
+    void set##Name(const type &value) {                                      \
+        if (m_##name == value) return;                                       \
+        m_##name = value;                                                    \
+        Q_EMIT Name##Changed();                                              \
+    }                                                                         \
+Q_SIGNALS:                                                                     \
+    void Name##Changed();                                                    \
+private:                                                                       \
+    type m_##name{};
+
+#define CFG_SECTION(Type, name, Name)                                        \
+public:                                                                       \
+    Q_PROPERTY(Type *name READ name CONSTANT)                                \
+    Type *name() const { return m_##name; }                                  \
+private:                                                                       \
+    Type *m_##name = nullptr;
+
+class ConfigSection : public QObject {
+    Q_OBJECT
+public:
+    explicit ConfigSection(QObject *parent = nullptr);
+
+    // Populate this section (and all child sections) from JSON. Unknown
+    // keys in obj are ignored; missing keys keep their current value.
+    void fromJson(const QJsonObject &obj);
+    // Serialize this section (and all child sections) to JSON.
+    QJsonObject toJson() const;
+
+Q_SIGNALS:
+    // Emitted whenever any property in this section, or any nested section,
+    // changes. Config listens on the root section to know a save is needed,
+    // without every leaf class needing to know about Config.
+    void changed();
+
+protected:
+    // Call once, at the end of every subclass constructor, after all child
+    // ConfigSection* members have been constructed (new'd with `this` as
+    // parent). Sets up the reflection-based signal forwarding.
+    void wireSignals();
+
+private Q_SLOTS:
+    void onPropertyChanged();
+
+private:
+    bool m_wired = false;
+};

Plugins/ZShell/Config/Dashboard.cpp

@@ -0,0 +1,39 @@
+#include "Dashboard.hpp"
+
+Performance::Performance(QObject *parent) : ConfigSection(parent) {
+    m_enabled = true;
+    m_showBattery = false;
+    m_showCpu = true;
+    m_showGpu = true;
+    m_showMemory = true;
+    m_showNetwork = true;
+    m_showStorage = true;
+    m_showVram = true;
+    wireSignals();
+}
+
+DashboardSizes::DashboardSizes(QObject *parent) : ConfigSection(parent) {
+    m_dateTimeWidth = 110;
+    m_infoIconSize = 25;
+    m_infoWidth = 200;
+    m_mediaCoverArtSize = 150;
+    m_mediaProgressSweep = 180;
+    m_mediaProgressThickness = 8;
+    m_mediaVisualizerSize = 200;
+    m_mediaWidth = 200;
+    m_resourceProgessThickness = 10;
+    m_resourceSize = 200;
+    m_tabIndicatorHeight = 3;
+    m_tabIndicatorSpacing = 5;
+    m_weatherWidth = 250;
+    wireSignals();
+}
+
+Dashboard::Dashboard(QObject *parent) : ConfigSection(parent) {
+    m_enabled = true;
+    m_mediaUpdateInterval = 2000;
+    m_performance = new Performance(this);
+    m_resourceUpdateInterval = 1000;
+    m_sizes = new DashboardSizes(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Dashboard.hpp

@@ -0,0 +1,56 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class Performance : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(bool, showBattery, ShowBattery)
+    CFG_PROPERTY(bool, showCpu, ShowCpu)
+    CFG_PROPERTY(bool, showGpu, ShowGpu)
+    CFG_PROPERTY(bool, showMemory, ShowMemory)
+    CFG_PROPERTY(bool, showNetwork, ShowNetwork)
+    CFG_PROPERTY(bool, showStorage, ShowStorage)
+    CFG_PROPERTY(bool, showVram, ShowVram)
+
+public:
+    explicit Performance(QObject *parent = nullptr);
+};
+
+class DashboardSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, dateTimeWidth, DateTimeWidth)
+    CFG_PROPERTY(int, infoIconSize, InfoIconSize)
+    CFG_PROPERTY(int, infoWidth, InfoWidth)
+    CFG_PROPERTY(int, mediaCoverArtSize, MediaCoverArtSize)
+    CFG_PROPERTY(int, mediaProgressSweep, MediaProgressSweep)
+    CFG_PROPERTY(int, mediaProgressThickness, MediaProgressThickness)
+    CFG_PROPERTY(int, mediaVisualizerSize, MediaVisualizerSize)
+    CFG_PROPERTY(int, mediaWidth, MediaWidth)
+    CFG_PROPERTY(int, resourceProgessThickness, ResourceProgessThickness)
+    CFG_PROPERTY(int, resourceSize, ResourceSize)
+    CFG_PROPERTY(int, tabIndicatorHeight, TabIndicatorHeight)
+    CFG_PROPERTY(int, tabIndicatorSpacing, TabIndicatorSpacing)
+    CFG_PROPERTY(int, weatherWidth, WeatherWidth)
+
+public:
+    explicit DashboardSizes(QObject *parent = nullptr);
+};
+
+class Dashboard : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(int, mediaUpdateInterval, MediaUpdateInterval)
+    CFG_SECTION(Performance, performance, Performance)
+    CFG_PROPERTY(int, resourceUpdateInterval, ResourceUpdateInterval)
+    CFG_SECTION(DashboardSizes, sizes, Sizes)
+
+public:
+    explicit Dashboard(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Dock.cpp

@@ -0,0 +1,15 @@
+#include "Dock.hpp"
+
+Dock::Dock(QObject *parent) : ConfigSection(parent) {
+    m_enable = false;
+    m_height = 80;
+    m_hoverToReveal = false;
+    m_ignoredAppRegexes = {};
+    m_pinnedApps = {
+        QStringLiteral("com.ayugram.desktop"),
+        QStringLiteral("com.obsproject.studio"),
+        QStringLiteral("librewolf"),
+    };
+    m_pinnedOnStartup = false;
+    wireSignals();
+}

Plugins/ZShell/Config/Dock.hpp

@@ -0,0 +1,19 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QVariantList>
+
+class Dock : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, enable, Enable)
+    CFG_PROPERTY(int, height, Height)
+    CFG_PROPERTY(bool, hoverToReveal, HoverToReveal)
+    CFG_PROPERTY(QVariantList, ignoredAppRegexes, IgnoredAppRegexes)
+    CFG_PROPERTY(QVariantList, pinnedApps, PinnedApps)
+    CFG_PROPERTY(bool, pinnedOnStartup, PinnedOnStartup)
+
+public:
+    explicit Dock(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/General.cpp

@@ -0,0 +1,77 @@
+#include "General.hpp"
+
+namespace {
+QVariantList strList(std::initializer_list<const char *> items) {
+    QVariantList list;
+    for (auto *item : items) list << QString::fromLatin1(item);
+    return list;
+}
+
+QVariantMap threshold(const char *icon, const char *message, const char *name, int perc) {
+    QVariantMap m;
+    m["icon"] = QString::fromLatin1(icon);
+    m["message"] = QString::fromLatin1(message);
+    m["name"] = QString::fromLatin1(name);
+    m["perc"] = perc;
+    return m;
+}
+}
+
+Apps::Apps(QObject *parent) : ConfigSection(parent) {
+    m_archiver = strList({"ark"});
+    m_audio = strList({"pavucontrol"});
+    m_document = strList({"libreoffice"});
+    m_editor = strList({"kate"});
+    m_explorer = strList({"dolphin"});
+    m_image = strList({"imv"});
+    m_playback = strList({"vlc"});
+    m_terminal = strList({"wezterm"});
+    wireSignals();
+}
+
+Battery::Battery(QObject *parent) : ConfigSection(parent) {
+    m_critPerc = 5;
+    m_popupThresholds = {
+        threshold("battery_android_frame_2", "Battery low", "Low battery", 20),
+        threshold("battery_android_frame_2", "Battery lower", "Low battery", 15),
+        threshold("battery_android_frame_2", "Battery lowest", "Low battery", 10),
+    };
+    wireSignals();
+}
+
+ColorSettings::ColorSettings(QObject *parent) : ConfigSection(parent) {
+    m_hyprsunsetTemp = 2600;
+    m_mode = QStringLiteral("dark");
+    m_neovimColors = false;
+    m_scheduleDark = false;
+    m_scheduleDarkEnd = 600;
+    m_scheduleDarkStart = 1140;
+    m_scheduleHyprsunset = true;
+    m_scheduleHyprsunsetEnd = 570;
+    m_scheduleHyprsunsetStart = 1200;
+    m_schemeGeneration = true;
+    m_smart = false;
+    wireSignals();
+}
+
+Idle::Idle(QObject *parent) : ConfigSection(parent) {
+    QVariantMap lock;
+    lock["idleAction"] = QStringLiteral("lock");
+    lock["name"] = QStringLiteral("Lock");
+    lock["timeout"] = 180;
+    m_timeouts = { lock };
+    wireSignals();
+}
+
+General::General(QObject *parent) : ConfigSection(parent) {
+    m_apps = new Apps(this);
+    m_battery = new Battery(this);
+    m_color = new ColorSettings(this);
+    m_dateFormat = QStringLiteral("ddd d MMM - hh:mm:ss");
+    m_desktopIcons = true;
+    m_idle = new Idle(this);
+    m_logo = QString();
+    m_showOverFullscreen = true;
+    m_wallpaperPath = QStringLiteral("/mnt/IronWolf/SDImages/SWWW_Wals/");
+    wireSignals();
+}

Plugins/ZShell/Config/General.hpp

@@ -0,0 +1,82 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QVariantList>
+
+class Apps : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(QVariantList, archiver, Archiver)
+    CFG_PROPERTY(QVariantList, audio, Audio)
+    CFG_PROPERTY(QVariantList, document, Document)
+    CFG_PROPERTY(QVariantList, editor, Editor)
+    CFG_PROPERTY(QVariantList, explorer, Explorer)
+    CFG_PROPERTY(QVariantList, image, Image)
+    CFG_PROPERTY(QVariantList, playback, Playback)
+    CFG_PROPERTY(QVariantList, terminal, Terminal)
+
+public:
+    explicit Apps(QObject *parent = nullptr);
+};
+
+class Battery : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, critPerc, CritPerc)
+    // Array of { icon, message, name, perc } objects.
+    CFG_PROPERTY(QVariantList, popupThresholds, PopupThresholds)
+
+public:
+    explicit Battery(QObject *parent = nullptr);
+};
+
+class ColorSettings : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, hyprsunsetTemp, HyprsunsetTemp)
+    CFG_PROPERTY(QString, mode, Mode)
+    CFG_PROPERTY(bool, neovimColors, NeovimColors)
+    CFG_PROPERTY(bool, scheduleDark, ScheduleDark)
+    CFG_PROPERTY(int, scheduleDarkEnd, ScheduleDarkEnd)
+    CFG_PROPERTY(int, scheduleDarkStart, ScheduleDarkStart)
+    CFG_PROPERTY(bool, scheduleHyprsunset, ScheduleHyprsunset)
+    CFG_PROPERTY(int, scheduleHyprsunsetEnd, ScheduleHyprsunsetEnd)
+    CFG_PROPERTY(int, scheduleHyprsunsetStart, ScheduleHyprsunsetStart)
+    CFG_PROPERTY(bool, schemeGeneration, SchemeGeneration)
+    CFG_PROPERTY(bool, smart, Smart)
+
+public:
+    explicit ColorSettings(QObject *parent = nullptr);
+};
+
+class Idle : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    // Array of { idleAction, name, timeout } objects.
+    CFG_PROPERTY(QVariantList, timeouts, Timeouts)
+
+public:
+    explicit Idle(QObject *parent = nullptr);
+};
+
+class General : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_SECTION(Apps, apps, Apps)
+    CFG_SECTION(Battery, battery, Battery)
+    CFG_SECTION(ColorSettings, color, Color)
+    CFG_PROPERTY(QString, dateFormat, DateFormat)
+    CFG_PROPERTY(bool, desktopIcons, DesktopIcons)
+    CFG_SECTION(Idle, idle, Idle)
+    CFG_PROPERTY(QString, logo, Logo)
+    CFG_PROPERTY(bool, showOverFullscreen, ShowOverFullscreen)
+    CFG_PROPERTY(QString, wallpaperPath, WallpaperPath)
+
+public:
+    explicit General(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Launcher.cpp

@@ -0,0 +1,71 @@
+#include "Launcher.hpp"
+
+namespace {
+QVariantList strList(std::initializer_list<const char *> items) {
+    QVariantList list;
+    for (auto *item : items) list << QString::fromLatin1(item);
+    return list;
+}
+
+QVariantMap action(QVariantList command, bool dangerous, const char *description,
+                    bool enabled, const char *icon, const char *name) {
+    QVariantMap m;
+    m["command"] = std::move(command);
+    m["dangerous"] = dangerous;
+    m["description"] = QString::fromLatin1(description);
+    m["enabled"] = enabled;
+    m["icon"] = QString::fromLatin1(icon);
+    m["name"] = QString::fromLatin1(name);
+    return m;
+}
+}
+
+LauncherSizes::LauncherSizes(QObject *parent) : ConfigSection(parent) {
+    m_itemHeight = 50;
+    m_itemWidth = 600;
+    m_wallpaperHeight = 200;
+    m_wallpaperWidth = 280;
+    wireSignals();
+}
+
+UseFuzzy::UseFuzzy(QObject *parent) : ConfigSection(parent) {
+    m_actions = true;
+    m_apps = true;
+    m_schemes = true;
+    m_variants = true;
+    m_wallpapers = true;
+    wireSignals();
+}
+
+Launcher::Launcher(QObject *parent) : ConfigSection(parent) {
+    m_actionPrefix = QStringLiteral("<");
+    m_actions = {
+        action(strList({"autocomplete", "calc"}), false, "Do simple math equations", true, "calculate", "Calculator"),
+        action(strList({"setMode", "light"}), false, "Change to light mode", true, "light_mode", "Light"),
+        action(strList({"setMode", "dark"}), false, "Change to dark mode", true, "dark_mode", "Dark"),
+        action(strList({"autocomplete", "wallpaper"}), false, "Change the current wallpaper", true, "image", "Wallpaper"),
+        action(strList({"autocomplete", "variant"}), false, "Change the current scheme variant", true, "colors", "Variant"),
+        action(strList({"systemctl", "poweroff"}), true, "Shutdown the system", true, "power_settings_new", "Shutdown"),
+        action(strList({"systemctl", "reboot"}), true, "Reboot the system", true, "cached", "Reboot"),
+        action(strList({"loginctl", "terminate-user", ""}), true, "Log out of the current session", true, "logout", "Logout"),
+        action(strList({"loginctl", "lock-session"}), false, "Lock the current session", true, "lock", "Lock"),
+        action(strList({"systemctl", "suspend-then-hibernate"}), false, "Suspend then hibernate", true, "bedtime", "Sleep"),
+    };
+    m_dragThreshold = 150;
+    m_enableDangerousActions = true;
+    m_enabled = true;
+    m_favoriteApps = strList({"Balatro", "Slay the Spire 2", "com.obsproject.Studio"});
+    m_hiddenApps = strList({
+        "zellij", "vim", "jshell-java-openjdk", "jconsole-java-openjdk",
+        "jshell-java21-openjdk", "jconsole-java21-openjdk", "jshell-java17-openjdk",
+        "jconsole-java17-openjdk", "org.neovim.nvim", "avahi-discover", "bvnc",
+        "bssh", "nm-connection-editor",
+    });
+    m_maxAppsShown = 18;
+    m_maxWallpapers = 7;
+    m_sizes = new LauncherSizes(this);
+    m_specialPrefix = QStringLiteral("@");
+    m_useFuzzy = new UseFuzzy(this);
+    m_uwsm = true;
+    wireSignals();
+}

Plugins/ZShell/Config/Launcher.hpp

@@ -0,0 +1,55 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QVariantList>
+
+class LauncherSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, itemHeight, ItemHeight)
+    CFG_PROPERTY(int, itemWidth, ItemWidth)
+    CFG_PROPERTY(int, wallpaperHeight, WallpaperHeight)
+    CFG_PROPERTY(int, wallpaperWidth, WallpaperWidth)
+
+public:
+    explicit LauncherSizes(QObject *parent = nullptr);
+};
+
+class UseFuzzy : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, actions, Actions)
+    CFG_PROPERTY(bool, apps, Apps)
+    CFG_PROPERTY(bool, schemes, Schemes)
+    CFG_PROPERTY(bool, variants, Variants)
+    CFG_PROPERTY(bool, wallpapers, Wallpapers)
+
+public:
+    explicit UseFuzzy(QObject *parent = nullptr);
+};
+
+class Launcher : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(QString, actionPrefix, ActionPrefix)
+    // Array of action-definition objects (command, dangerous, description,
+    // enabled, icon, name).
+    CFG_PROPERTY(QVariantList, actions, Actions)
+    CFG_PROPERTY(int, dragThreshold, DragThreshold)
+    CFG_PROPERTY(bool, enableDangerousActions, EnableDangerousActions)
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(QVariantList, favoriteApps, FavoriteApps)
+    CFG_PROPERTY(QVariantList, hiddenApps, HiddenApps)
+    CFG_PROPERTY(int, maxAppsShown, MaxAppsShown)
+    CFG_PROPERTY(int, maxWallpapers, MaxWallpapers)
+    CFG_SECTION(LauncherSizes, sizes, Sizes)
+    CFG_PROPERTY(QString, specialPrefix, SpecialPrefix)
+    CFG_SECTION(UseFuzzy, useFuzzy, UseFuzzy)
+    CFG_PROPERTY(bool, uwsm, Uwsm)
+
+public:
+    explicit Launcher(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Lock.cpp

@@ -0,0 +1,19 @@
+#include "Lock.hpp"
+
+LockSizes::LockSizes(QObject *parent) : ConfigSection(parent) {
+    m_centerWidth = 600;
+    m_heightMult = 0.7;
+    m_ratio = 1.78;
+    wireSignals();
+}
+
+Lock::Lock(QObject *parent) : ConfigSection(parent) {
+    m_blurAmount = 10;
+    m_enableFprint = true;
+    m_maxFprintTries = 3;
+    m_recolorLogo = false;
+    m_showNotifContent = true;
+    m_showNotifIcon = true;
+    m_sizes = new LockSizes(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Lock.hpp

@@ -0,0 +1,31 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class LockSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, centerWidth, CenterWidth)
+    CFG_PROPERTY(qreal, heightMult, HeightMult)
+    CFG_PROPERTY(qreal, ratio, Ratio)
+
+public:
+    explicit LockSizes(QObject *parent = nullptr);
+};
+
+class Lock : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, blurAmount, BlurAmount)
+    CFG_PROPERTY(bool, enableFprint, EnableFprint)
+    CFG_PROPERTY(int, maxFprintTries, MaxFprintTries)
+    CFG_PROPERTY(bool, recolorLogo, RecolorLogo)
+    CFG_PROPERTY(bool, showNotifContent, ShowNotifContent)
+    CFG_PROPERTY(bool, showNotifIcon, ShowNotifIcon)
+    CFG_SECTION(LockSizes, sizes, Sizes)
+
+public:
+    explicit Lock(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Notifs.cpp

@@ -0,0 +1,22 @@
+#include "Notifs.hpp"
+
+NotifsSizes::NotifsSizes(QObject *parent) : ConfigSection(parent) {
+    m_badge = 20;
+    m_image = 41;
+    m_width = 400;
+    wireSignals();
+}
+
+Notifs::Notifs(QObject *parent) : ConfigSection(parent) {
+    m_actionOnClick = false;
+    m_appNotifCooldown = 0;
+    m_clearThreshold = 0.3;
+    m_defaultExpireTimeout = 5000;
+    m_expandThreshold = 20;
+    m_expire = true;
+    m_groupPreviewNum = 5;
+    m_openExpanded = false;
+    m_showInFullscreen = false;
+    m_sizes = new NotifsSizes(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Notifs.hpp

@@ -0,0 +1,34 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class NotifsSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, badge, Badge)
+    CFG_PROPERTY(int, image, Image)
+    CFG_PROPERTY(int, width, Width)
+
+public:
+    explicit NotifsSizes(QObject *parent = nullptr);
+};
+
+class Notifs : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, actionOnClick, ActionOnClick)
+    CFG_PROPERTY(int, appNotifCooldown, AppNotifCooldown)
+    CFG_PROPERTY(qreal, clearThreshold, ClearThreshold)
+    CFG_PROPERTY(int, defaultExpireTimeout, DefaultExpireTimeout)
+    CFG_PROPERTY(int, expandThreshold, ExpandThreshold)
+    CFG_PROPERTY(bool, expire, Expire)
+    CFG_PROPERTY(int, groupPreviewNum, GroupPreviewNum)
+    CFG_PROPERTY(bool, openExpanded, OpenExpanded)
+    CFG_PROPERTY(bool, showInFullscreen, ShowInFullscreen)
+    CFG_SECTION(NotifsSizes, sizes, Sizes)
+
+public:
+    explicit Notifs(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Osd.cpp

@@ -0,0 +1,17 @@
+#include "Osd.hpp"
+
+OsdSizes::OsdSizes(QObject *parent) : ConfigSection(parent) {
+    m_sliderHeight = 150;
+    m_sliderWidth = 30;
+    wireSignals();
+}
+
+Osd::Osd(QObject *parent) : ConfigSection(parent) {
+    m_allMonBrightness = true;
+    m_enableBrightness = true;
+    m_enableMicrophone = true;
+    m_enabled = true;
+    m_hideDelay = 3000;
+    m_sizes = new OsdSizes(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Osd.hpp

@@ -0,0 +1,29 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class OsdSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, sliderHeight, SliderHeight)
+    CFG_PROPERTY(int, sliderWidth, SliderWidth)
+
+public:
+    explicit OsdSizes(QObject *parent = nullptr);
+};
+
+class Osd : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, allMonBrightness, AllMonBrightness)
+    CFG_PROPERTY(bool, enableBrightness, EnableBrightness)
+    CFG_PROPERTY(bool, enableMicrophone, EnableMicrophone)
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(int, hideDelay, HideDelay)
+    CFG_SECTION(OsdSizes, sizes, Sizes)
+
+public:
+    explicit Osd(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Overview.cpp

@@ -0,0 +1,9 @@
+#include "Overview.hpp"
+
+Overview::Overview(QObject *parent) : ConfigSection(parent) {
+    m_columns = 5;
+    m_enable = false;
+    m_rows = 2;
+    m_scale = 0.16;
+    wireSignals();
+}

Plugins/ZShell/Config/Overview.hpp

@@ -0,0 +1,16 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class Overview : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, columns, Columns)
+    CFG_PROPERTY(bool, enable, Enable)
+    CFG_PROPERTY(int, rows, Rows)
+    CFG_PROPERTY(qreal, scale, Scale)
+
+public:
+    explicit Overview(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Screenshot.cpp

@@ -0,0 +1,15 @@
+#include "Screenshot.hpp"
+
+Screenshot::Screenshot(QObject *parent) : ConfigSection(parent) {
+    m_enable_pp = false;
+    m_mode = QStringLiteral("manual");
+    m_radius = 49;
+    m_rounding = false;
+    m_saveOnCopy = false;
+    m_shadow = true;
+    m_shadow_blur = 0;
+    m_shadow_color = { 0, 0, 0, 160 };
+    m_shadow_offset_x = 30;
+    m_shadow_offset_y = 50;
+    wireSignals();
+}

Plugins/ZShell/Config/Screenshot.hpp

@@ -0,0 +1,26 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QVariantList>
+
+class Screenshot : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    // Property names below must match the JSON keys exactly (the JSON here
+    // uses snake_case for these particular keys, so we do too).
+    CFG_PROPERTY(bool, enable_pp, EnablePp)
+    CFG_PROPERTY(QString, mode, Mode)
+    CFG_PROPERTY(int, radius, Radius)
+    CFG_PROPERTY(bool, rounding, Rounding)
+    CFG_PROPERTY(bool, saveOnCopy, SaveOnCopy)
+    CFG_PROPERTY(bool, shadow, Shadow)
+    CFG_PROPERTY(int, shadow_blur, ShadowBlur)
+    // [r, g, b, a]
+    CFG_PROPERTY(QVariantList, shadow_color, ShadowColor)
+    CFG_PROPERTY(int, shadow_offset_x, ShadowOffsetX)
+    CFG_PROPERTY(int, shadow_offset_y, ShadowOffsetY)
+
+public:
+    explicit Screenshot(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Services.cpp

@@ -0,0 +1,23 @@
+#include "Services.hpp"
+
+Services::Services(QObject *parent) : ConfigSection(parent) {
+    m_audioIncrement = 0.1;
+    m_brightnessIncrement = 0.1;
+    m_ddcutilService = true;
+    m_defaultPlayer = QStringLiteral("Spotify");
+    m_gpuType = QStringLiteral("NVIDIA");
+    m_maxVolume = 1;
+    m_minBrightness = 0.01;
+
+    QVariantMap alias;
+    alias["from"] = QStringLiteral("com.github.th_ch.youtube_music");
+    alias["to"] = QStringLiteral("YT Music");
+    m_playerAliases = { alias };
+
+    m_updates = true;
+    m_useFahrenheit = false;
+    m_useTwelveHourClock = false;
+    m_visualizerBars = 50;
+    m_weatherLocation = QString();
+    wireSignals();
+}

Plugins/ZShell/Config/Services.hpp

@@ -0,0 +1,27 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QVariantList>
+
+class Services : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(qreal, audioIncrement, AudioIncrement)
+    CFG_PROPERTY(qreal, brightnessIncrement, BrightnessIncrement)
+    CFG_PROPERTY(bool, ddcutilService, DdcutilService)
+    CFG_PROPERTY(QString, defaultPlayer, DefaultPlayer)
+    CFG_PROPERTY(QString, gpuType, GpuType)
+    CFG_PROPERTY(qreal, maxVolume, MaxVolume)
+    CFG_PROPERTY(qreal, minBrightness, MinBrightness)
+    // Array of { from, to } objects.
+    CFG_PROPERTY(QVariantList, playerAliases, PlayerAliases)
+    CFG_PROPERTY(bool, updates, Updates)
+    CFG_PROPERTY(bool, useFahrenheit, UseFahrenheit)
+    CFG_PROPERTY(bool, useTwelveHourClock, UseTwelveHourClock)
+    CFG_PROPERTY(int, visualizerBars, VisualizerBars)
+    CFG_PROPERTY(QString, weatherLocation, WeatherLocation)
+
+public:
+    explicit Services(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Sidebar.cpp

@@ -0,0 +1,13 @@
+#include "Sidebar.hpp"
+
+SidebarSizes::SidebarSizes(QObject *parent) : ConfigSection(parent) {
+    m_width = 520;
+    wireSignals();
+}
+
+Sidebar::Sidebar(QObject *parent) : ConfigSection(parent) {
+    m_dragThreshold = 30;
+    m_enabled = true;
+    m_sizes = new SidebarSizes(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Sidebar.hpp

@@ -0,0 +1,25 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+
+class SidebarSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, width, Width)
+
+public:
+    explicit SidebarSizes(QObject *parent = nullptr);
+};
+
+class Sidebar : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, dragThreshold, DragThreshold)
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_SECTION(SidebarSizes, sizes, Sizes)
+
+public:
+    explicit Sidebar(QObject *parent = nullptr);
+};

Plugins/ZShell/Config/Tokens.cpp

@@ -0,0 +1,109 @@
+#include "Tokens.hpp"
+
+TokensRounding::TokensRounding(QObject* parent) : QObject(parent) {
+	m_extraSmall = 4;
+	m_full = 1000;
+	m_large = 24;
+	m_medium = 16;
+	m_normal = 18;
+	m_scale = 1;
+	m_small = 12;
+	m_smallest = 8;
+}
+
+TokensPadding::TokensPadding(QObject* parent) : QObject(parent) {
+	m_extraLarge = 28;
+	m_extraLargeIncreased = 32;
+	m_extraSmall = 4;
+	m_large = 16;
+	m_largeIncreased = 20;
+	m_larger = 12;
+	m_normal = 8;
+	m_scale = 1;
+	m_small = 5;
+	m_smaller = 7;
+	m_smallest = 2;
+}
+
+TokensSpacing::TokensSpacing(QObject* parent) : QObject(parent) {
+	m_extraSmall = 4;
+	m_large = 20;
+	m_larger = 16;
+	m_normal = 12;
+	m_scale = 1;
+	m_small = 8;
+	m_smaller = 10;
+}
+
+TokensFontSize::TokensFontSize(QObject* parent) : QObject(parent) {
+	m_extraLarge = 28;
+	m_large = 18;
+	m_larger = 16;
+	m_medium = 14;
+	m_normal = 13;
+	m_scale = 1;
+	m_small = 11;
+	m_smaller = 12;
+}
+
+TokensFont::TokensFont(QObject* parent) : QObject(parent) {
+	m_size = new TokensFontSize(this);
+}
+
+TokensAnimCurves::TokensAnimCurves(QObject* parent) : QObject(parent) {
+	m_emphasized = {
+		0.05,
+		0,
+		2.0 / 15.0,
+		0.06,
+		1.0 / 6.0,
+		0.4,
+		5.0 / 24.0,
+		0.82,
+		0.25,
+		1,
+		1,
+		1};
+	m_emphasizedAccel = {0.3, 0, 0.8, 0.15, 1, 1};
+	m_emphasizedDecel = {0.05, 0.7, 0.1, 1, 1, 1};
+	m_expressiveDefaultEffects = {0.34, 0.8, 0.34, 1, 1, 1};
+	m_expressiveDefaultSpatial = {0.38, 1.21, 0.22, 1, 1, 1};
+	m_expressiveEffects = {0.34, 0.8, 0.34, 1, 1, 1};
+	m_expressiveFastEffects = {0.31, 0.94, 0.34, 1, 1, 1};
+	m_expressiveFastSpatial = {0.42, 1.67, 0.21, 0.9, 1, 1};
+	m_expressiveSlowEffects = {0.34, 0.88, 0.34, 1, 1, 1};
+	m_expressiveSlowSpatial = {0.39, 1.29, 0.35, 0.98, 1, 1};
+	m_standard = {0.2, 0, 0, 1, 1, 1};
+	m_standardAccel = {0.3, 0, 1, 1, 1, 1};
+	m_standardDecel = {0, 0, 0, 1, 1, 1};
+}
+
+TokensAnimDurations::TokensAnimDurations(QObject* parent) : QObject(parent) {
+	m_expressiveDefaultSpatial = 500;
+	m_expressiveEffects = 200;
+	m_expressiveFastEffects = 150;
+	m_expressiveFastSpatial = 350;
+	m_expressiveSlowEffects = 300;
+	m_extraLarge = 1000;
+	m_large = 600;
+	m_normal = 400;
+	m_scale = 1;
+	m_small = 200;
+}
+
+TokensAnim::TokensAnim(QObject* parent) : QObject(parent) {
+	m_curves = new TokensAnimCurves(this);
+	m_durations = new TokensAnimDurations(this);
+}
+
+Tokens::Tokens(QObject* parent) : QObject(parent) {
+	m_rounding = new TokensRounding(this);
+	m_padding = new TokensPadding(this);
+	m_spacing = new TokensSpacing(this);
+	m_font = new TokensFont(this);
+	m_anim = new TokensAnim(this);
+}
+
+Tokens* Tokens::create(QQmlEngine*, QJSEngine*) {
+	return new Tokens();
+}

Plugins/ZShell/Config/Tokens.hpp

@@ -0,0 +1,348 @@
+#pragma once
+
+#include <QObject>
+#include <qqmlregistration.h>
+#include <QQmlEngine>
+#include <QJSEngine>
+
+class TokensRounding : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(qreal extraSmall READ extraSmall CONSTANT)
+	Q_PROPERTY(qreal full READ full CONSTANT)
+	Q_PROPERTY(qreal large READ large CONSTANT)
+	Q_PROPERTY(qreal medium READ medium CONSTANT)
+	Q_PROPERTY(qreal normal READ normal CONSTANT)
+	Q_PROPERTY(qreal scale READ scale CONSTANT)
+	Q_PROPERTY(qreal small READ small CONSTANT)
+	Q_PROPERTY(qreal smallest READ smallest CONSTANT)
+
+	public:
+	explicit TokensRounding(QObject* parent = nullptr);
+
+	qreal extraSmall() const { return m_extraSmall; }
+	qreal full() const { return m_full; }
+	qreal large() const { return m_large; }
+	qreal medium() const { return m_medium; }
+	qreal normal() const { return m_normal; }
+	qreal scale() const { return m_scale; }
+	qreal small() const { return m_small; }
+	qreal smallest() const { return m_smallest; }
+
+	private:
+	qreal m_extraSmall;
+	qreal m_full;
+	qreal m_large;
+	qreal m_medium;
+	qreal m_normal;
+	qreal m_scale;
+	qreal m_small;
+	qreal m_smallest;
+};
+
+class TokensPadding : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(qreal extraLarge READ extraLarge CONSTANT)
+	Q_PROPERTY(qreal extraLargeIncreased READ extraLargeIncreased CONSTANT)
+	Q_PROPERTY(qreal extraSmall READ extraSmall CONSTANT)
+	Q_PROPERTY(qreal large READ large CONSTANT)
+	Q_PROPERTY(qreal largeIncreased READ largeIncreased CONSTANT)
+	Q_PROPERTY(qreal larger READ larger CONSTANT)
+	Q_PROPERTY(qreal normal READ normal CONSTANT)
+	Q_PROPERTY(qreal scale READ scale CONSTANT)
+	Q_PROPERTY(qreal small READ small CONSTANT)
+	Q_PROPERTY(qreal smaller READ smaller CONSTANT)
+	Q_PROPERTY(qreal smallest READ smallest CONSTANT)
+
+	public:
+	explicit TokensPadding(QObject* parent = nullptr);
+
+	qreal extraLarge() const { return m_extraLarge; }
+	qreal extraLargeIncreased() const { return m_extraLargeIncreased; }
+	qreal extraSmall() const { return m_extraSmall; }
+	qreal large() const { return m_large; }
+	qreal largeIncreased() const { return m_largeIncreased; }
+	qreal larger() const { return m_larger; }
+	qreal normal() const { return m_normal; }
+	qreal scale() const { return m_scale; }
+	qreal small() const { return m_small; }
+	qreal smaller() const { return m_smaller; }
+	qreal smallest() const { return m_smallest; }
+
+	private:
+	qreal m_extraLarge;
+	qreal m_extraLargeIncreased;
+	qreal m_extraSmall;
+	qreal m_large;
+	qreal m_largeIncreased;
+	qreal m_larger;
+	qreal m_normal;
+	qreal m_scale;
+	qreal m_small;
+	qreal m_smaller;
+	qreal m_smallest;
+};
+
+class TokensSpacing : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(qreal extraSmall READ extraSmall CONSTANT)
+	Q_PROPERTY(qreal large READ large CONSTANT)
+	Q_PROPERTY(qreal larger READ larger CONSTANT)
+	Q_PROPERTY(qreal normal READ normal CONSTANT)
+	Q_PROPERTY(qreal scale READ scale CONSTANT)
+	Q_PROPERTY(qreal small READ small CONSTANT)
+	Q_PROPERTY(qreal smaller READ smaller CONSTANT)
+
+	public:
+	explicit TokensSpacing(QObject* parent = nullptr);
+
+	qreal extraSmall() const { return m_extraSmall; }
+	qreal large() const { return m_large; }
+	qreal larger() const { return m_larger; }
+	qreal normal() const { return m_normal; }
+	qreal scale() const { return m_scale; }
+	qreal small() const { return m_small; }
+	qreal smaller() const { return m_smaller; }
+
+	private:
+	qreal m_extraSmall;
+	qreal m_large;
+	qreal m_larger;
+	qreal m_normal;
+	qreal m_scale;
+	qreal m_small;
+	qreal m_smaller;
+};
+
+class TokensFontSize : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(qreal extraLarge READ extraLarge CONSTANT)
+	Q_PROPERTY(qreal large READ large CONSTANT)
+	Q_PROPERTY(qreal larger READ larger CONSTANT)
+	Q_PROPERTY(qreal medium READ medium CONSTANT)
+	Q_PROPERTY(qreal normal READ normal CONSTANT)
+	Q_PROPERTY(qreal scale READ scale CONSTANT)
+	Q_PROPERTY(qreal small READ small CONSTANT)
+	Q_PROPERTY(qreal smaller READ smaller CONSTANT)
+
+	public:
+	explicit TokensFontSize(QObject* parent = nullptr);
+
+	qreal extraLarge() const { return m_extraLarge; }
+	qreal large() const { return m_large; }
+	qreal larger() const { return m_larger; }
+	qreal medium() const { return m_medium; }
+	qreal normal() const { return m_normal; }
+	qreal scale() const { return m_scale; }
+	qreal small() const { return m_small; }
+	qreal smaller() const { return m_smaller; }
+
+	private:
+	qreal m_extraLarge;
+	qreal m_large;
+	qreal m_larger;
+	qreal m_medium;
+	qreal m_normal;
+	qreal m_scale;
+	qreal m_small;
+	qreal m_smaller;
+};
+
+class TokensFont : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(TokensFontSize* size READ size CONSTANT)
+
+	public:
+	explicit TokensFont(QObject* parent = nullptr);
+
+	TokensFontSize* size() const { return m_size; }
+
+	private:
+	TokensFontSize* m_size = nullptr;
+};
+
+class TokensAnimCurves : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(QVariantList emphasized READ emphasized CONSTANT)
+	Q_PROPERTY(QVariantList emphasizedAccel READ emphasizedAccel CONSTANT)
+	Q_PROPERTY(QVariantList emphasizedDecel READ emphasizedDecel CONSTANT)
+	Q_PROPERTY(
+		QVariantList expressiveDefaultEffects READ expressiveDefaultEffects
+			CONSTANT)
+	Q_PROPERTY(
+		QVariantList expressiveDefaultSpatial READ expressiveDefaultSpatial
+			CONSTANT)
+	Q_PROPERTY(QVariantList expressiveEffects READ expressiveEffects CONSTANT)
+	Q_PROPERTY(
+		QVariantList expressiveFastEffects READ expressiveFastEffects CONSTANT)
+	Q_PROPERTY(
+		QVariantList expressiveFastSpatial READ expressiveFastSpatial CONSTANT)
+	Q_PROPERTY(
+		QVariantList expressiveSlowEffects READ expressiveSlowEffects CONSTANT)
+	Q_PROPERTY(
+		QVariantList expressiveSlowSpatial READ expressiveSlowSpatial CONSTANT)
+	Q_PROPERTY(QVariantList standard READ standard CONSTANT)
+	Q_PROPERTY(QVariantList standardAccel READ standardAccel CONSTANT)
+	Q_PROPERTY(QVariantList standardDecel READ standardDecel CONSTANT)
+
+	public:
+	explicit TokensAnimCurves(QObject* parent = nullptr);
+
+	QVariantList emphasized() const { return m_emphasized; }
+	QVariantList emphasizedAccel() const { return m_emphasizedAccel; }
+	QVariantList emphasizedDecel() const { return m_emphasizedDecel; }
+	QVariantList expressiveDefaultEffects() const {
+		return m_expressiveDefaultEffects;
+	}
+	QVariantList expressiveDefaultSpatial() const {
+		return m_expressiveDefaultSpatial;
+	}
+	QVariantList expressiveEffects() const { return m_expressiveEffects; }
+	QVariantList expressiveFastEffects() const {
+		return m_expressiveFastEffects;
+	}
+	QVariantList expressiveFastSpatial() const {
+		return m_expressiveFastSpatial;
+	}
+	QVariantList expressiveSlowEffects() const {
+		return m_expressiveSlowEffects;
+	}
+	QVariantList expressiveSlowSpatial() const {
+		return m_expressiveSlowSpatial;
+	}
+	QVariantList standard() const { return m_standard; }
+	QVariantList standardAccel() const { return m_standardAccel; }
+	QVariantList standardDecel() const { return m_standardDecel; }
+
+	private:
+	QVariantList m_emphasized;
+	QVariantList m_emphasizedAccel;
+	QVariantList m_emphasizedDecel;
+	QVariantList m_expressiveDefaultEffects;
+	QVariantList m_expressiveDefaultSpatial;
+	QVariantList m_expressiveEffects;
+	QVariantList m_expressiveFastEffects;
+	QVariantList m_expressiveFastSpatial;
+	QVariantList m_expressiveSlowEffects;
+	QVariantList m_expressiveSlowSpatial;
+	QVariantList m_standard;
+	QVariantList m_standardAccel;
+	QVariantList m_standardDecel;
+};
+
+class TokensAnimDurations : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(
+		int expressiveDefaultSpatial READ expressiveDefaultSpatial CONSTANT)
+	Q_PROPERTY(int expressiveEffects READ expressiveEffects CONSTANT)
+	Q_PROPERTY(int expressiveFastEffects READ expressiveFastEffects CONSTANT)
+	Q_PROPERTY(int expressiveFastSpatial READ expressiveFastSpatial CONSTANT)
+	Q_PROPERTY(int expressiveSlowEffects READ expressiveSlowEffects CONSTANT)
+	Q_PROPERTY(int extraLarge READ extraLarge CONSTANT)
+	Q_PROPERTY(int large READ large CONSTANT)
+	Q_PROPERTY(int normal READ normal CONSTANT)
+	Q_PROPERTY(qreal scale READ scale CONSTANT)
+	Q_PROPERTY(int small READ small CONSTANT)
+
+	public:
+	explicit TokensAnimDurations(QObject* parent = nullptr);
+
+	int expressiveDefaultSpatial() const { return m_expressiveDefaultSpatial; }
+	int expressiveEffects() const { return m_expressiveEffects; }
+	int expressiveFastEffects() const { return m_expressiveFastEffects; }
+	int expressiveFastSpatial() const { return m_expressiveFastSpatial; }
+	int expressiveSlowEffects() const { return m_expressiveSlowEffects; }
+	int extraLarge() const { return m_extraLarge; }
+	int large() const { return m_large; }
+	int normal() const { return m_normal; }
+	qreal scale() const { return m_scale; }
+	int small() const { return m_small; }
+
+	private:
+	int m_expressiveDefaultSpatial;
+	int m_expressiveEffects;
+	int m_expressiveFastEffects;
+	int m_expressiveFastSpatial;
+	int m_expressiveSlowEffects;
+	int m_extraLarge;
+	int m_large;
+	int m_normal;
+	qreal m_scale;
+	int m_small;
+};
+
+class TokensAnim : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+	QML_UNCREATABLE("Instantiated internally by Tokens")
+
+	Q_PROPERTY(TokensAnimCurves* curves READ curves CONSTANT)
+	Q_PROPERTY(TokensAnimDurations* durations READ durations CONSTANT)
+
+	public:
+	explicit TokensAnim(QObject* parent = nullptr);
+
+	TokensAnimCurves* curves() const { return m_curves; }
+	TokensAnimDurations* durations() const { return m_durations; }
+
+	private:
+	TokensAnimCurves* m_curves = nullptr;
+	TokensAnimDurations* m_durations = nullptr;
+};
+
+class Tokens : public QObject {
+	Q_OBJECT
+	QML_ELEMENT
+	QML_SINGLETON
+
+	Q_PROPERTY(TokensRounding* rounding READ rounding CONSTANT)
+	Q_PROPERTY(TokensPadding* padding READ padding CONSTANT)
+	Q_PROPERTY(TokensSpacing* spacing READ spacing CONSTANT)
+	Q_PROPERTY(TokensFont* font READ font CONSTANT)
+	Q_PROPERTY(TokensAnim* anim READ anim CONSTANT)
+
+	public:
+	explicit Tokens(QObject* parent = nullptr);
+	static Tokens* create(QQmlEngine*, QJSEngine*);
+
+	TokensRounding* rounding() const { return m_rounding; }
+	TokensPadding* padding() const { return m_padding; }
+	TokensSpacing* spacing() const { return m_spacing; }
+	TokensFont* font() const { return m_font; }
+	TokensAnim* anim() const { return m_anim; }
+
+	private:
+	TokensRounding* m_rounding = nullptr;
+	TokensPadding* m_padding = nullptr;
+	TokensSpacing* m_spacing = nullptr;
+	TokensFont* m_font = nullptr;
+	TokensAnim* m_anim = nullptr;
+};

Plugins/ZShell/Config/Utilities.cpp

@@ -0,0 +1,38 @@
+#include "Utilities.hpp"
+
+UtilitiesSizes::UtilitiesSizes(QObject *parent) : ConfigSection(parent) {
+    m_toastWidth = 430;
+    m_width = 430;
+    wireSignals();
+}
+
+Toasts::Toasts(QObject *parent) : ConfigSection(parent) {
+    m_audioInputChanged = true;
+    m_audioOutputChanged = true;
+    m_capsLockChanged = true;
+    m_chargingChanged = true;
+    m_configLoaded = true;
+    m_dndChanged = true;
+    m_gameModeChanged = true;
+    m_kbLayoutChanged = true;
+    m_kbLimit = true;
+    m_nowPlaying = false;
+    m_numLockChanged = true;
+    m_vpnChanged = true;
+    wireSignals();
+}
+
+Vpn::Vpn(QObject *parent) : ConfigSection(parent) {
+    m_enabled = false;
+    m_provider = { QStringLiteral("netbird") };
+    wireSignals();
+}
+
+Utilities::Utilities(QObject *parent) : ConfigSection(parent) {
+    m_enabled = true;
+    m_maxToasts = 4;
+    m_sizes = new UtilitiesSizes(this);
+    m_toasts = new Toasts(this);
+    m_vpn = new Vpn(this);
+    wireSignals();
+}

Plugins/ZShell/Config/Utilities.hpp

@@ -0,0 +1,61 @@
+#pragma once
+#include "ConfigSection.hpp"
+#include <qqmlregistration.h>
+#include <QVariantList>
+
+class UtilitiesSizes : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(int, toastWidth, ToastWidth)
+    CFG_PROPERTY(int, width, Width)
+
+public:
+    explicit UtilitiesSizes(QObject *parent = nullptr);
+};
+
+class Toasts : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, audioInputChanged, AudioInputChanged)
+    CFG_PROPERTY(bool, audioOutputChanged, AudioOutputChanged)
+    CFG_PROPERTY(bool, capsLockChanged, CapsLockChanged)
+    CFG_PROPERTY(bool, chargingChanged, ChargingChanged)
+    CFG_PROPERTY(bool, configLoaded, ConfigLoaded)
+    CFG_PROPERTY(bool, dndChanged, DndChanged)
+    CFG_PROPERTY(bool, gameModeChanged, GameModeChanged)
+    CFG_PROPERTY(bool, kbLayoutChanged, KbLayoutChanged)
+    CFG_PROPERTY(bool, kbLimit, KbLimit)
+    CFG_PROPERTY(bool, nowPlaying, NowPlaying)
+    CFG_PROPERTY(bool, numLockChanged, NumLockChanged)
+    CFG_PROPERTY(bool, vpnChanged, VpnChanged)
+
+public:
+    explicit Toasts(QObject *parent = nullptr);
+};
+
+class Vpn : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(QVariantList, provider, Provider)
+
+public:
+    explicit Vpn(QObject *parent = nullptr);
+};
+
+class Utilities : public ConfigSection {
+    Q_OBJECT
+        QML_UNCREATABLE("Instantiated internally by Config")
+
+    CFG_PROPERTY(bool, enabled, Enabled)
+    CFG_PROPERTY(int, maxToasts, MaxToasts)
+    CFG_SECTION(UtilitiesSizes, sizes, Sizes)
+    CFG_SECTION(Toasts, toasts, Toasts)
+    CFG_SECTION(Vpn, vpn, Vpn)
+
+public:
+    explicit Utilities(QObject *parent = nullptr);
+};