[App] Add onboarding wizard (#7064)

* [App] Add onboarding wizard

Took 10 minutes

Took 3 minutes

Took 7 minutes

Took 9 minutes

Took 2 minutes

Took 1 minute


Took 7 minutes

* Adjust CI

Took 14 minutes

Took 56 seconds

Took 2 seconds

Took 3 seconds

* Adjust CI again

Took 14 minutes

Took 2 seconds

* Comments and fixes

Took 9 seconds


Took 1 minute

* Rebase.

Took 5 minutes

Took 50 seconds

Took 15 seconds

* Comments.

Took 7 minutes

* CI lol

Took 3 minutes

* CI again lol

Took 4 minutes

* Drop some settings, add some new ones.

Took 19 minutes

* Resize when expanding section

Took 4 minutes

Took 3 minutes

Took 7 minutes

---------

Co-authored-by: Lukas Brübach <Bruebach.Lukas@bdosecurity.de>

cockatrice/src/interface/widgets/onboarding/first_run_wizard.h

@@ -0,0 +1,71 @@
+#ifndef FIRST_RUN_WIZARD_H
+#define FIRST_RUN_WIZARD_H
+
+#include <QDialog>
+#include <QList>
+
+class BannerHost;
+class FirstRunWizardPage;
+class StepIndicatorWidget;
+class CardDatabaseSetupPage;
+class QLabel;
+class QPushButton;
+class QStackedWidget;
+
+/** @brief Polished first-run onboarding flow: card database setup, theme
+ *         selection, server account setup, and a handful of key preferences.
+ *
+ * Deliberately ignorant of network/registration/download internals --
+ * pages that need them emit request signals for MainWindow to fulfill.
+ * Every choice is written to SettingsCache as it's made (via the pages
+ * themselves, same as AppearanceSettingsPage does), so "Skip" or closing
+ * the window never discards anything already confirmed. */
+class FirstRunWizard : public QDialog
+{
+    Q_OBJECT
+
+public:
+    explicit FirstRunWizard(QWidget *parent = nullptr);
+
+signals:
+    void registerRequested();
+    void connectRequested();
+    void cardDatabaseUpdateRequested();
+    void manualCardDatabaseSetupRequested();
+
+public slots:
+    /** @brief Forwarded from MainWindow once the background card database update process exits. */
+    void onCardDatabaseUpdateFinished(bool success);
+
+protected:
+    void closeEvent(QCloseEvent *event) override;
+    void changeEvent(QEvent *event) override;
+
+private slots:
+    void goNext();
+    void goBack();
+    void skip();
+    void updateChrome();
+
+private:
+    void addPage(FirstRunWizardPage *page);
+    void showPage(int index);
+    void retranslateUi();
+    void finish();
+
+    QStackedWidget *stack;
+    StepIndicatorWidget *stepIndicator;
+    BannerHost *bannerHost;
+    QLabel *titleLabel;
+    QLabel *subtitleLabel;
+    QPushButton *backButton;
+    QPushButton *skipButton;
+    QPushButton *nextButton;
+
+    CardDatabaseSetupPage *cardDatabasePage = nullptr;
+
+    QList<FirstRunWizardPage *> pages;
+    int currentIndex = -1;
+};
+
+#endif // FIRST_RUN_WIZARD_H