From 7ee008e150bc5bcf76082d726f719ee0fdfda982 Mon Sep 17 00:00:00 2001
From: SulfurNitride <SulfurNitride@users.noreply.github.com>
Date: Wed, 11 Feb 2026 02:37:39 -0600
Subject: Fluorine Manager: full Linux port of Mod Organizer 2

Complete native Linux port with FUSE-based virtual filesystem,
Proton/umu-run integration, and Flatpak packaging.

Key features:
- FUSE VFS replacing Windows USVFS (in-process + standalone helper for Flatpak)
- Proton/GE-Proton/umu-run launcher with env var forwarding
- Flatpak support (sandbox-aware VFS, NXM handler, umu-run)
- Wine prefix management UI
- Case-insensitive path resolution for Linux filesystems
- QSettings-safe INI handling (avoids Bethesda INI corruption)
- Portable instance support with auto-generated launcher scripts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 libs/uibase/src/tutorialmanager.cpp | 112 ++++++++++++++++++++++++++++++++++++
 1 file changed, 112 insertions(+)
 create mode 100644 libs/uibase/src/tutorialmanager.cpp

(limited to 'libs/uibase/src/tutorialmanager.cpp')

diff --git a/libs/uibase/src/tutorialmanager.cpp b/libs/uibase/src/tutorialmanager.cpp
new file mode 100644
index 0000000..58191e7
--- /dev/null
+++ b/libs/uibase/src/tutorialmanager.cpp
@@ -0,0 +1,112 @@
+/*
+Copyright (C) 2012 Sebastian Herbord. All rights reserved.
+
+This file is part of Mod Organizer.
+
+Mod Organizer is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+Mod Organizer is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with Mod Organizer.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#include <uibase/tutorialmanager.h>
+#include <uibase/log.h>
+#include <uibase/tutorialcontrol.h>
+#include <uibase/utility.h>
+#include <QApplication>
+#include <QDir>
+#include <QList>
+#include <QString>
+#include <QTimer>
+
+namespace MOBase
+{
+
+TutorialManager* TutorialManager::s_Instance = nullptr;
+
+TutorialManager::TutorialManager(const QString& tutorialPath, QObject* organizerCore)
+    : m_TutorialPath(tutorialPath), m_OrganizerCore(organizerCore)
+{}
+
+void TutorialManager::init(const QString& tutorialPath, QObject* organizerCore)
+{
+  if (s_Instance != nullptr) {
+    delete s_Instance;
+  }
+  s_Instance = new TutorialManager(tutorialPath, organizerCore);
+}
+
+TutorialManager& TutorialManager::instance()
+{
+  if (s_Instance == nullptr) {
+    throw Exception(tr("tutorial manager not set up yet"));
+  }
+  return *s_Instance;
+}
+
+void TutorialManager::activateTutorial(const QString& windowName,
+                                       const QString& tutorialName)
+{
+  std::map<QString, TutorialControl*>::iterator iter = m_Controls.find(windowName);
+  if (iter != m_Controls.end()) {
+    // control already visible, start tutorial right away
+    iter->second->startTutorial(m_TutorialPath + tutorialName);
+  } else {
+    m_PendingTutorials[windowName] = tutorialName;
+  }
+}
+
+void TutorialManager::finishWindowTutorial(const QString& windowName)
+{
+  emit windowTutorialFinished(windowName);
+  //  QSettings &settings = Settings::instance().directInterface();
+  //  settings.setValue(QString("CompletedWindowTutorials/") + windowName, true);
+}
+
+bool TutorialManager::hasTutorial(const QString& tutorialName)
+{
+  return QFile::exists(m_TutorialPath + tutorialName);
+}
+
+QWidget* TutorialManager::findControl(const QString& controlName)
+{
+  QWidget* mainWindow = qApp->activeWindow();
+  if (mainWindow != nullptr) {
+    return mainWindow->findChild<QWidget*>(controlName);
+  } else {
+    return nullptr;
+  }
+}
+
+void TutorialManager::registerControl(const QString& windowName,
+                                      TutorialControl* control)
+{
+  m_Controls[windowName]                    = control;
+  std::map<QString, QString>::iterator iter = m_PendingTutorials.find(windowName);
+  if (iter != m_PendingTutorials.end()) {
+    // there is a pending tutorial for this window, display it
+    QTimer::singleShot(0, [control, tutorial = m_TutorialPath + iter->second] {
+      control->startTutorial(tutorial);
+    });
+    m_PendingTutorials.erase(iter);
+  }
+}
+
+void TutorialManager::unregisterControl(const QString& windowName)
+{
+  std::map<QString, TutorialControl*>::iterator iter = m_Controls.find(windowName);
+  if (iter != m_Controls.end()) {
+    m_Controls.erase(iter);
+  } else {
+    log::warn("failed to remove tutorial control {}", windowName);
+  }
+}
+}  // namespace MOBase
-- 
cgit v1.3.1