fix(ui): defer startup wizard until visible

* Triggers the startup wizard after the window is loaded instead of on
  first show, reducing timing-related focus issues
* Skips the startup wizard when the main window is not yet visible to
  avoid opening it too early
* Improves wizard activation by deferring raise/activate and applying a
  macOS-specific dialog flag for better modality behavior

Co-authored-by: Copilot <copilot@github.com>

Author: saturneric

src/ui/main_window/MainWindow.cpp

@@ -167,6 +167,14 @@ void MainWindow::Init() noexcept {
     connect(m_key_list_, &KeyList::SignalRefreshDatabase, this,
             [=]() { slot_update_engine_status(); });
 
+    connect(this, &MainWindow::SignalLoaded, this, [this]() {
+      QTimer::singleShot(100, this,
+                         [self = QPointer<MainWindow>(this)]() -> void {
+                           if (self == nullptr) return;
+                           self->slot_maybe_show_wizard();
+                         });
+    });
+
     // restore settings and window state
     restore_settings();
 
@@ -175,8 +183,9 @@ void MainWindow::Init() noexcept {
     // size.
     RestoreSettingsOnce();
 
+    // If no previous state is saved, apply a default layout after the event
+    // loop starts.
     const bool state_restored = restoreWindowState();
-
     QTimer::singleShot(0, this, [this, state_restored]() -> void {
       if (!state_restored) {
         apply_default_layout();
@@ -274,15 +283,6 @@ void MainWindow::closeEvent(QCloseEvent* event) {
   GeneralMainWindow::closeEvent(event);
 }
 
-void MainWindow::showEvent(QShowEvent* event) {
-  GeneralMainWindow::showEvent(event);
-
-  if (wizard_checked_) return;
-  wizard_checked_ = true;
-
-  QTimer::singleShot(0, this, [this]() -> void { slot_maybe_show_wizard(); });
-}
-
 auto MainWindow::create_action(const QString& id, const QString& name,
                                const QString& icon, const QString& too_tip,
                                const QContainer<QKeySequence>& shortcuts)

src/ui/main_window/MainWindow.h

@@ -139,13 +139,6 @@ class GF_UI_EXPORT MainWindow : public GeneralMainWindow {
    */
   void closeEvent(QCloseEvent* event) override;
 
-  /**
-   * @brief
-   *
-   * @param event
-   */
-  void showEvent(QShowEvent* event) override;
-
  public slots:
 
   /**
@@ -331,6 +324,10 @@ class GF_UI_EXPORT MainWindow : public GeneralMainWindow {
    */
   void slot_find();
 
+  /**
+   * @brief
+   *
+   */
   void slot_start_wizard();
 
   /**

src/ui/main_window/MainWindowSlotUI.cpp

@@ -48,17 +48,35 @@ void MainWindow::slot_start_wizard() {
   auto* wizard = new Wizard(this);
   wizard->setAttribute(Qt::WA_DeleteOnClose);
   wizard->setWindowModality(Qt::ApplicationModal);
+
+#ifdef Q_OS_MACOS
+  wizard->setWindowFlag(Qt::Dialog, true);
+#endif
+
   wizard->open();
-  wizard->raise();
-  wizard->activateWindow();
+
+  QTimer::singleShot(0, wizard, [wizard]() {
+    wizard->raise();
+    wizard->activateWindow();
+  });
 }
 
 void MainWindow::slot_maybe_show_wizard() {
+  if (wizard_checked_) {
+    return;
+  }
+  wizard_checked_ = true;
+
   if (!show_wizard_on_startup_) {
     LOG_D() << "Wizard on startup is disabled. Skipping wizard.";
     return;
   }
 
+  if (!isVisible()) {
+    LOG_W() << "Main window is not visible yet. Skipping startup wizard.";
+    return;
+  }
+
   slot_start_wizard();
 }