restore last selected library feature/playlist/crate on restart

implements #10125
persists the currently selected sidebar item (feature or child) to user settings and restores it on next mixxx startup.
uses feature iconname + child data for robust matching across sessions. gracefully falls back to default selection if saved item not found.

config keys:
- [Library] LastSelectedFeature: stores feature icon name (programmatic identifier)
- [Library] LastSelectedChild: stores child item data (playlist/crate id)

changes based on pr feedback:
- use iconName() instead of title() for feature identification (non-translated, version-stable)
- use QAbstractItemModel::match() with recursive flag to simplify child lookup
- add bounds checking to prevent out-of-bounds access
- reuse clicked() method for activation to eliminate code duplication

also adds Qt6::GuiPrivate component for Qt >= 6.10 compatibility

prevent jarring sidebar scroll on startup

- only scroll if restored item not visible in viewport
- position at top when scrolling needed
- disable auto-scroll during startup restoration

Author: Milkii Brewster

CMakeLists.txt

@@ -3518,6 +3518,10 @@ if(QT6)
   list(APPEND QT_EXTRA_COMPONENTS "ShaderTools")
   list(APPEND QT_EXTRA_COMPONENTS "SvgWidgets")
   list(APPEND QT_EXTRA_COMPONENTS "Core5Compat")
+  if(QT_VERSION VERSION_GREATER_EQUAL 6.10)
+    # from Qt 6.10 GuiPrivate required for QShader/rendergraph (rhi/qshader.h)
+    list(APPEND QT_EXTRA_COMPONENTS "GuiPrivate")
+  endif()
 else()
   find_package(QT 5.12 NAMES Qt5 COMPONENTS Core REQUIRED)
 endif()

res/qml/MicrophoneDuckingPanel.qml

@@ -40,7 +40,7 @@ Column {
                     case MicrophoneDuckingPanel.DuckingMode.Auto:
                         return "Auto";
                     case MicrophoneDuckingPanel.DuckingMode.Manual:
-                        return "Manual";
+                            return "Manual";
                     default:
                         return "Off";
                 }

res/qml/Mixxx/Controls/Knob.qml

@@ -27,7 +27,7 @@ Item {
             case Knob.ArcStart.Minimum:
                 return min;
             case Knob.ArcStart.Maximum:
-                return max;
+                    return max;
             default:
                 return valueCenter;
         }

res/qml/SyncButton.qml

@@ -28,16 +28,16 @@ Skin.Button {
             case SyncButton.SyncMode.ImplicitLeader:
                 return Theme.yellow;
             case SyncButton.SyncMode.ExplicitLeader:
-                return Theme.red;
+                    return Theme.red;
             default:
                 return Theme.deckActiveColor;
         }
     }
     text: {
         switch (mode) {
             case SyncButton.SyncMode.ImplicitLeader:
-                case SyncButton.SyncMode.ExplicitLeader:
-                    return "Leader";
+            case SyncButton.SyncMode.ExplicitLeader:
+                return "Leader";
             default:
                 return "Sync";
         }

src/library/library.cpp

@@ -79,6 +79,9 @@ Library::Library(
           m_pAnalysisFeature(nullptr) {
     qRegisterMetaType<LibraryRemovalType>("LibraryRemovalType");
 
+    // provide config to sidebar model for selection persistence
+    m_pSidebarModel->setConfig(m_pConfig);
+
     m_pKeyNotation.reset(
             new ControlObject(mixxx::library::prefs::kKeyNotationConfigKey));
 

src/library/sidebarmodel.cpp

@@ -2,6 +2,7 @@
 
 #include <QTimer>
 #include <QUrl>
+#include <functional>
 
 #include "library/libraryfeature.h"
 #include "library/treeitem.h"
@@ -94,6 +95,17 @@ void SidebarModel::setDefaultSelection(unsigned int index) {
 }
 
 void SidebarModel::activateDefaultSelection() {
+    // try to restore previously selected item
+    QModelIndex savedIndex = restoreSavedSelection();
+    if (savedIndex.isValid()) {
+        // enable smart scrolling - only if item below viewport
+        emit selectIndex(savedIndex, true /* scrollTo */);
+        // reuse clicked() method to activate the restored selection
+        clicked(savedIndex);
+        return;
+    }
+
+    // fallback to default selection if restoration failed
     if (m_iDefaultSelectedIndex <
             static_cast<unsigned int>(m_sFeatures.size())) {
         emit selectIndex(getDefaultSelection(), true /* scrollTo */);
@@ -354,6 +366,9 @@ void SidebarModel::clicked(const QModelIndex& index) {
     // this event.
     stopPressedUntilClickedTimer();
     if (index.isValid()) {
+        // save the selection for restoration on restart
+        saveCurrentSelection(index);
+
         if (index.internalPointer() == this) {
             m_sFeatures[index.row()]->activate();
         } else {
@@ -520,7 +535,16 @@ QModelIndex SidebarModel::translateIndex(
 void SidebarModel::slotDataChanged(const QModelIndex& topLeft, const QModelIndex& bottomRight) {
     // qDebug() << "slotDataChanged topLeft:" << topLeft << "bottomRight:" << bottomRight;
     QModelIndex topLeftTranslated = translateSourceIndex(topLeft);
-    QModelIndex bottomRightTranslated = translateSourceIndex(bottomRight);
+    QModelIndex bottomRightTranslated;
+
+    // if bottomRight is invalid in the source, keep it invalid in the translation
+    if (bottomRight.isValid()) {
+        bottomRightTranslated = translateSourceIndex(bottomRight);
+    } else {
+        // per Qt convention, invalid bottomRight means same as topLeft
+        bottomRightTranslated = topLeftTranslated;
+    }
+
     emit dataChanged(topLeftTranslated, bottomRightTranslated);
 }
 
@@ -610,3 +634,131 @@ void SidebarModel::slotFeatureSelect(LibraryFeature* pFeature,
     }
     emit selectIndex(ind, scrollTo);
 }
+
+void SidebarModel::saveCurrentSelection(const QModelIndex& index) {
+    if (!m_pConfig || !index.isValid()) {
+        return;
+    }
+
+    QString featureName;
+    QString childName;
+
+    if (index.internalPointer() == this) {
+        // root feature selected
+        if (index.row() >= 0 && index.row() < m_sFeatures.size()) {
+            featureName = m_sFeatures[index.row()]->iconName();
+        }
+    } else {
+        // child item selected
+        TreeItem* pTreeItem = static_cast<TreeItem*>(index.internalPointer());
+        if (pTreeItem) {
+            LibraryFeature* pFeature = pTreeItem->feature();
+            if (pFeature) {
+                featureName = pFeature->iconName();
+                childName = pTreeItem->getData().toString();
+            }
+        }
+    }
+
+    if (!featureName.isEmpty()) {
+        m_pConfig->setValue(
+                ConfigKey(QStringLiteral("[Library]"), QStringLiteral("LastSelectedFeature")),
+                featureName);
+        m_pConfig->setValue(
+                ConfigKey(QStringLiteral("[Library]"), QStringLiteral("LastSelectedChild")),
+                childName);
+    }
+}
+
+QModelIndex SidebarModel::restoreSavedSelection() {
+    if (!m_pConfig || m_sFeatures.isEmpty()) {
+        return QModelIndex();
+    }
+
+    const QString savedFeatureName = m_pConfig->getValueString(
+            ConfigKey(QStringLiteral("[Library]"), QStringLiteral("LastSelectedFeature")));
+
+    if (savedFeatureName.isEmpty()) {
+        return QModelIndex();
+    }
+
+    int featureRow = -1;
+    // find the feature by icon name (non-translated, programmatic identifier)
+    for (int i = 0; i < m_sFeatures.size(); ++i) {
+        if (m_sFeatures[i]->iconName() == savedFeatureName) {
+            featureRow = i;
+            break;
+        }
+    }
+
+    const QString savedChildName = m_pConfig->getValueString(
+            ConfigKey(QStringLiteral("[Library]"), QStringLiteral("LastSelectedChild")));
+    // if no child data, return the feature root.
+    // returns invalid index if feature was not found.
+    if (savedChildName.isEmpty()) {
+        return index(featureRow, 0);
+    }
+
+    // feature not found, can't search for child
+    if (featureRow < 0) {
+        return {};
+    }
+
+    // search for matching child by data using QAbstractItemModel::match()
+    QAbstractItemModel* pChildModel = m_sFeatures[featureRow]->sidebarModel();
+    if (pChildModel && pChildModel->rowCount() > 0) {
+        // the model items' data type may be int (playlist, crate) or
+        // QString (Missing, Quick Links).
+        // get the model's data type, then create the appropriate QVariant.
+        // note: assumes the model uses only one data type!
+        const QVariant dataVar = pChildModel->data(
+                pChildModel->index(0, 0), TreeItemModel::kDataRole);
+        auto dataType = dataVar.metaType();
+        QVariant childData;
+        switch (dataType.id()) {
+        case QMetaType::QString: {
+            childData = QVariant::fromValue(savedChildName);
+            break;
+        }
+        case QMetaType::Int: {
+            bool convertedToInt = false;
+            int intValue = savedChildName.toInt(&convertedToInt);
+            if (convertedToInt) {
+                childData = QVariant::fromValue(intValue);
+            } else {
+                qWarning() << "SidebarModel::restoreSavedSelection: could not "
+                              "convert stored child data to int";
+            }
+            break;
+        }
+        default:
+            qWarning() << "SidebarModel::restoreSavedSelection: "
+                          "model uses unexpected data type"
+                       << dataType.name();
+            qWarning() << "select feature root";
+        }
+
+        if (!childData.isValid()) {
+            return {};
+        }
+
+        const QModelIndexList matches = pChildModel->match(
+                pChildModel->index(0, 0),
+                TreeItemModel::kDataRole,
+                childData,
+                1, // stop at first match
+                Qt::MatchExactly | Qt::MatchRecursive);
+
+        if (!matches.isEmpty() && matches.first().isValid()) {
+            // translate child model index to sidebar model index
+            const QModelIndex childIndex = matches.first();
+            TreeItem* pTreeItem = static_cast<TreeItem*>(childIndex.internalPointer());
+            if (pTreeItem) {
+                return createIndex(childIndex.row(), childIndex.column(), pTreeItem);
+            }
+        }
+    }
+
+    // child not found, return feature root or invalid index if feature was not found.
+    return index(featureRow, 0);
+}

src/library/sidebarmodel.h

@@ -3,8 +3,11 @@
 #include <QAbstractItemModel>
 #include <QList>
 #include <QModelIndex>
+#include <QString>
 #include <QVariant>
 
+#include "preferences/usersettings.h"
+
 class LibraryFeature;
 class QTimer;
 
@@ -25,6 +28,10 @@ class SidebarModel : public QAbstractItemModel {
             QObject* parent = nullptr);
     ~SidebarModel() override = default;
 
+    void setConfig(UserSettingsPointer pConfig) {
+        m_pConfig = pConfig;
+    }
+
     void addLibraryFeature(LibraryFeature* feature);
     QModelIndex getDefaultSelection();
     void setDefaultSelection(unsigned int index);
@@ -93,10 +100,14 @@ class SidebarModel : public QAbstractItemModel {
     QModelIndex translateSourceIndex(const QModelIndex& parent);
     QModelIndex translateIndex(const QModelIndex& index, const QAbstractItemModel* model);
     void featureRenamed(LibraryFeature*);
+    void saveCurrentSelection(const QModelIndex& index);
+    QModelIndex restoreSavedSelection();
+
     unsigned int m_iDefaultSelectedIndex; /** Index of the item in the sidebar model to select at startup. */
 
     QTimer* const m_pressedUntilClickedTimer;
     QModelIndex m_pressedIndex;
+    UserSettingsPointer m_pConfig;
 
     void startPressedUntilClickedTimer(const QModelIndex& pressedIndex);
     void stopPressedUntilClickedTimer();

src/library/treeitemmodel.cpp

@@ -214,6 +214,11 @@ void TreeItemModel::triggerRepaint(const QModelIndex& index) {
 }
 
 void TreeItemModel::triggerRepaint() {
+    // don't emit dataChanged if the model is empty
+    if (rowCount() == 0) {
+        return;
+    }
+
     QModelIndex left = index(0, 0);
     QModelIndex right = index(rowCount() - 1, columnCount() - 1);
     emit dataChanged(left, right);