Merge pull request #26282 from Eism/tours_system

Implemented tours system

Author: Eism

src/app/CMakeLists.txt

@@ -159,6 +159,10 @@ if (MUSE_MODULE_UI)
     list(APPEND LINK_LIB muse::dockwindow)
 endif()
 
+if (MUSE_MODULE_TOURS)
+    list(APPEND LINK_LIB muse::tours)
+endif()
+
 if (MUSE_MODULE_AUDIOPLUGINS)
     list(APPEND LINK_LIB muse::audioplugins)
 endif()

src/app/appfactory.cpp

@@ -77,6 +77,12 @@
 #include "framework/stubs/shortcuts/shortcutsstubmodule.h"
 #endif
 
+#ifdef MUSE_MODULE_TOURS
+#include "framework/tours/toursmodule.h"
+#else
+#include "framework/stubs/tours/toursstubmodule.h"
+#endif
+
 #ifdef MUSE_MODULE_UI
 #include "framework/dockwindow/dockmodule.h"
 #include "framework/ui/uimodule.h"
@@ -254,6 +260,7 @@ std::shared_ptr<muse::IApplication> AppFactory::newGuiApp(const CmdOptions& opti
     app->addModule(new muse::uicomponents::UiComponentsModule());
     app->addModule(new muse::dock::DockModule());
 #endif
+    app->addModule(new muse::tours::ToursModule());
     app->addModule(new muse::vst::VSTModule());
 
 // modules
@@ -360,6 +367,7 @@ std::shared_ptr<muse::IApplication> AppFactory::newConsoleApp(const CmdOptions&
     app->addModule(new muse::uicomponents::UiComponentsModule());
     app->addModule(new muse::dock::DockModule());
 #endif
+    app->addModule(new muse::tours::ToursModule());
     app->addModule(new muse::vst::VSTModule());
 
 // modules

src/appshell/qml/AppWindow.qml

@@ -26,6 +26,8 @@ import Muse.Ui 1.0
 import Muse.Shortcuts 1.0
 import MuseScore.AppShell 1.0
 
+import Muse.Tours 1.0
+
 ApplicationWindow {
     id: root
 
@@ -69,6 +71,8 @@ ApplicationWindow {
 
     ToolTipProvider { }
 
+    ToursProvider { }
+
     //! NOTE Need only create
     Shortcuts { }
 

src/framework/CMakeLists.txt

@@ -81,6 +81,10 @@ if (MUSE_MODULE_SHORTCUTS)
     add_subdirectory(shortcuts)
 endif()
 
+if (MUSE_MODULE_TOURS)
+    add_subdirectory(tours)
+endif()
+
 if (MUSE_MODULE_MULTIINSTANCES)
     add_subdirectory(multiinstances)
 endif()

src/framework/cmake/MuseDeclareOptions.cmake

@@ -49,6 +49,8 @@ option(MUSE_MODULE_NETWORK_WEBSOCKET "Enable websocket support" OFF)
 
 declare_muse_module_opt(SHORTCUTS ON)
 
+declare_muse_module_opt(TOURS ON)
+
 declare_muse_module_opt(UI ON)
 option(MUSE_MODULE_UI_DISABLE_MODALITY "Disable dialogs modality for testing purpose" OFF)
 

src/framework/cmake/muse_framework_config.h.in

@@ -106,6 +106,10 @@
 #cmakedefine MUSE_MODULE_SHORTCUTS_TESTS 1
 #cmakedefine MUSE_MODULE_SHORTCUTS_API 1
 
+#cmakedefine MUSE_MODULE_TOURS 1
+#cmakedefine MUSE_MODULE_TOURS_TESTS 1
+#cmakedefine MUSE_MODULE_TOURS_API 1
+
 #cmakedefine MUSE_MODULE_UI 1
 #cmakedefine MUSE_MODULE_UI_TESTS 1
 #cmakedefine MUSE_MODULE_UI_API 1

src/framework/dockwindow/view/dockpageview.h

@@ -58,7 +58,7 @@ class DockPageView : public QQuickItem, public muse::Injectable
     Q_PROPERTY(muse::dock::DockCentralView * centralDock READ centralDock WRITE setCentralDock NOTIFY centralDockChanged)
     Q_PROPERTY(muse::dock::DockStatusBarView * statusBar READ statusBar WRITE setStatusBar NOTIFY statusBarChanged)
 
-    muse::Inject<ui::INavigationController> navigationController = { this };
+    Inject<ui::INavigationController> navigationController = { this };
 
 public:
     explicit DockPageView(QQuickItem* parent = nullptr);

src/framework/global/types/uri.h

@@ -115,4 +115,13 @@ inline muse::logger::Stream& operator<<(muse::logger::Stream& s, const muse::Uri
     return s;
 }
 
+template<>
+struct std::hash<muse::Uri>
+{
+    std::size_t operator()(const muse::Uri& uri) const noexcept
+    {
+        return std::hash<std::string> {}(uri.toString());
+    }
+};
+
 #endif // MUSE_GLOBAL_URI_H

src/framework/stubs/CMakeLists.txt

@@ -58,6 +58,10 @@ if (NOT MUSE_MODULE_SHORTCUTS)
     add_subdirectory(shortcuts)
 endif()
 
+if (NOT MUSE_MODULE_TOURS)
+    add_subdirectory(tours)
+endif()
+
 if (NOT MUSE_MODULE_UPDATE)
     add_subdirectory(update)
 endif()

src/framework/stubs/tours/CMakeLists.txt

@@ -0,0 +1,41 @@
+# SPDX-License-Identifier: GPL-3.0-only
+# MuseScore-CLA-applies
+#
+# MuseScore
+# Music Composition & Notation
+#
+# Copyright (C) 2025 MuseScore BVBA and others
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program 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 General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+declare_module(muse_tours)
+set(MODULE_ALIAS muse::tours)
+
+set(MODULE_QRC tours.qrc)
+
+set(MODULE_QML_IMPORT ${CMAKE_CURRENT_LIST_DIR}/qml)
+
+set(MODULE_SRC
+    ${CMAKE_CURRENT_LIST_DIR}/toursstubmodule.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/toursstubmodule.h
+    ${CMAKE_CURRENT_LIST_DIR}/toursconfigurationstub.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/toursconfigurationstub.h
+    ${CMAKE_CURRENT_LIST_DIR}/toursservicestub.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/toursservicestub.h
+
+    ${CMAKE_CURRENT_LIST_DIR}/view/toursproviderstub.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/view/toursproviderstub.h
+    )
+
+set(MODULE_IS_STUB ON)
+setup_module()