From eac149656b1fa2a7072ebf13ab6fafedefd63a82 Mon Sep 17 00:00:00 2001
From: BruebachL <44814898+BruebachL@users.noreply.github.com>
Date: Sat, 24 Oct 2026 21:38:54 +0200
Subject: [PATCH] [QtUtils] Add window fade, path opening, bold font and
 confirmation helpers (#7621)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Lukas Brübach <Bruebach.Lukas@bdosecurity.de>
---
 .../libcockatrice/utility/qt_utils.h          | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/libcockatrice_utility/libcockatrice/utility/qt_utils.h b/libcockatrice_utility/libcockatrice/utility/qt_utils.h
index 39a9e01e6..1d06c4d72 100644
--- a/libcockatrice_utility/libcockatrice/utility/qt_utils.h
+++ b/libcockatrice_utility/libcockatrice/utility/qt_utils.h
@@ -1,11 +1,15 @@
 #ifndef COCKATRICE_QT_UTILS_H
 #define COCKATRICE_QT_UTILS_H
+#include <QDesktopServices>
 #include <QFont>
 #include <QFontDatabase>
 #include <QLayout>
+#include <QMessageBox>
 #include <QObject>
+#include <QPropertyAnimation>
 #include <QScrollArea>
 #include <QString>
+#include <QUrl>
 #include <QWidget>
 
 namespace QtUtils
@@ -141,6 +145,64 @@ static inline QFont monospaceFont()
     }
     return font;
 }
+
+/**
+ * @brief Fades @p window between two opacity values.
+ *
+ * @param window           Window to animate.
+ * @param startOpacity     Starting opacity.
+ * @param endOpacity       Ending opacity.
+ * @param durationMs       Duration in milliseconds.
+ * @param hideWhenFinished Hide the window when the animation finishes.
+ * @return The running animation. It is owned by @p window and deletes itself when stopped.
+ */
+static inline QPropertyAnimation *
+fadeWindow(QWidget *window, qreal startOpacity, qreal endOpacity, int durationMs, bool hideWhenFinished = false)
+{
+    auto *animation = new QPropertyAnimation(window, "windowOpacity", window);
+    animation->setDuration(durationMs);
+    animation->setStartValue(startOpacity);
+    animation->setEndValue(endOpacity);
+    if (hideWhenFinished) {
+        QObject::connect(animation, &QPropertyAnimation::finished, window, &QWidget::hide);
+    }
+    animation->start(QAbstractAnimation::DeleteWhenStopped);
+    return animation;
+}
+
+/**
+ * @brief Opens @p path with the platform's file manager or default handler.
+ */
+static inline bool openPathInFileManager(const QString &path)
+{
+    return QDesktopServices::openUrl(QUrl::fromLocalFile(path));
+}
+
+/**
+ * @brief Returns @p font with bold styling enabled.
+ */
+static inline QFont boldFont(QFont font)
+{
+    font.setBold(true);
+    return font;
+}
+
+/**
+ * @brief Shows a Yes/No confirmation dialog and returns true when the user confirms.
+ *
+ * @param parent        Parent widget.
+ * @param title         Dialog title.
+ * @param text          Dialog text.
+ * @param defaultButton Button focused by default. NoButton lets Qt choose.
+ */
+static inline bool confirm(QWidget *parent,
+                           const QString &title,
+                           const QString &text,
+                           QMessageBox::StandardButton defaultButton = QMessageBox::NoButton)
+{
+    return QMessageBox::question(parent, title, text, QMessageBox::Yes | QMessageBox::No, defaultButton) ==
+           QMessageBox::Yes;
+}
 } // namespace QtUtils
 
 #endif // COCKATRICE_QT_UTILS_H