feat: add folder group support to dock taskbar

1. Add DockGlobalElementModel support for group elements (launcher
folders)
2. Update AppGroup to use new folder ID format ("internal/folders/"
instead of "internal/folder/")
3. Implement group item details and launch functionality in AppsApplet
4. Display composite preview icons for folder groups in dock items
5. Add FolderPopup QML component with grid layout for folder contents
6. Implement drag-and-drop support for folder elements from launcher
7. Update the dock settings to handle folder dock/undock operations
8. Improve group ID parsing with input validation

Log: Added folder group display in dock taskbar with composite preview
and popup

Influence:
1. Test folder group display in dock: verify composite preview icons
show correctly
2. Test folder popup: verify grid layout, scrolling, and application
launch
3. Test drag-and-drop folders from launcher to dock
4. Test folder dock/undock via context menu
5. Test folder group ID format migration ("internal/folders/" prefix)
6. Test group ID parsing with invalid inputs (empty, non-numeric,
negative)
7. Test group display name and item details retrieval
8. Test folder persistence after dock restart
9. Test launcher folder operations with multiple items and special
characters

feat: 在任务栏中添加文件夹组支持

1. 为 DockGlobalElementModel 添加组元素支持（启动器文件夹）
2. 更新 AppGroup 使用新的文件夹 ID 格式（"internal/folders/" 替代
"internal/folder/"）
3. 在 AppsApplet 中实现组项目详情和启动功能
4. 在任务栏项目中显示文件夹组的复合预览图标
5. 添加带有网格布局的 FolderPopup QML 组件用于显示文件夹内容
6. 实现从启动器拖放文件夹元素到任务栏的功能
7. 更新任务栏设置以支持文件夹的停靠/取消停靠操作
8. 改进组 ID 解析验证

Log: 在任务栏中添加文件夹组显示，支持复合预览和弹出窗口

Influence:
1. 测试任务栏中的文件夹组显示：验证复合预览图标是否正确显示
2. 测试文件夹弹窗：验证网格布局、滚动和应用启动功能
3. 测试从启动器拖放文件夹到任务栏
4. 测试通过右键菜单停靠/取消停靠文件夹
5. 测试文件夹组 ID 格式迁移（"internal/folders/" 前缀）
6. 测试组 ID 解析对无效输入的处理（空值、非数字、负数）
7. 测试组显示名称和项目详情的获取
8. 测试重启任务栏后文件夹状态的持久化
9. 测试启动器文件夹操作在包含多个项目和特殊字符时的表现

PMS: TASK-392671

Author: wjyrich

applets/dde-apps/appgroup.cpp

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
@@ -15,11 +15,11 @@ Q_LOGGING_CATEGORY(appGroupLog, "org.deepin.dde.shell.dde-apps.appgroup")
 namespace apps {
 AppGroup::AppGroup(const QString &groupId, const QString &name, const QList<QStringList> &appIDs)
     : AppItem(groupId, AppItemModel::FolderItemType)
-    , m_itemsPage(new ItemsPage(name, groupId == QStringLiteral("internal/folder/0") ? (4 * 8) : (3 * 4)))
+    , m_itemsPage(new ItemsPage(name, parseGroupId(groupId) == 0 ? (4 * 8) : (3 * 4)))
 {
     setItemsPerPage(m_itemsPage->maxItemCountPerPage());
     setAppName(m_itemsPage->name());
-    // folder id is a part of its groupId: "internal/folder/{folderId}"
+    // folder id is a part of its groupId: "internal/folders/{folderId}"
     setFolderId(parseGroupId(groupId));
 
     for (const QStringList &items : appIDs) {
@@ -49,19 +49,33 @@ ItemsPage *AppGroup::itemsPage()
 
 bool AppGroup::idIsFolder(const QString & id)
 {
-    return id.startsWith(QStringLiteral("internal/folder/"));
+    return parseGroupId(id) >= 0;
 }
 
 QString AppGroup::groupIdFromNumber(int groupId)
 {
-    return QStringLiteral("internal/folder/%1").arg(groupId);
+    return QStringLiteral("internal/folders/%1").arg(groupId);
 }
 
 int AppGroup::parseGroupId(const QString & id)
 {
-    using namespace std::string_view_literals;
-    constexpr size_t len = "internal/folder/"sv.size();
-    return QStringView{id}.mid(len + 1).toInt();
+    constexpr QLatin1StringView prefix("internal/folders/");
+    if (!id.startsWith(prefix))
+        return -1;
+
+    const QStringView number = QStringView(id).sliced(prefix.size());
+
+    if (number.isEmpty())
+        return -1;
+
+    for (const QChar ch : number) {
+        if (!ch.isDigit())
+            return -1;
+    }
+
+    bool ok = false;
+    const int groupId = number.toInt(&ok);
+    return ok && groupId >= 0 ? groupId : -1;
 }
 
 void AppGroup::setItemsPerPage(int number)

applets/dde-apps/appgroup.h

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 

applets/dde-apps/appgroupmanager.cpp

@@ -87,8 +87,8 @@ QModelIndex AppGroupManager::groupIndexById(int groupId)
 {
     for (int i = 0; i < rowCount(); i++) {
         auto groupIndex = index(i, 0);
-        auto data = groupIndex.data(GroupIdRole);
-        if (data.toInt() == groupId) {
+        auto appGroup = static_cast<AppGroup *>(itemFromIndex(groupIndex));
+        if (appGroup && appGroup->folderId() == groupId) {
             return groupIndex;
         }
     }
@@ -352,8 +352,8 @@ void AppGroupManager::loadAppGroupInfo()
     }
 
     // always ensure top-level group exists
-    if (rowCount() == 0) {
-        auto p = appendGroup(assignGroupId(), "Top Level", {});
+    if (!group(TOPLEVEL_FOLDERID)) {
+        auto p = appendGroup(AppGroup::groupIdFromNumber(TOPLEVEL_FOLDERID), "Top Level", {});
         Q_ASSERT(p->folderId() == TOPLEVEL_FOLDERID);
     }
 }
@@ -375,18 +375,19 @@ void AppGroupManager::saveAppGroupInfo()
 
 QString AppGroupManager::assignGroupId() const
 {
-    QStringList knownGroupIds;
+    QSet<int> knownGroupIds;
     for (int i = 0; i < rowCount(); i++) {
-        auto group = index(i, 0);
-        knownGroupIds.append(group.data(AppItemModel::DesktopIdRole).toString());
+        auto appGroup = static_cast<AppGroup *>(itemFromIndex(index(i, 0)));
+        if (appGroup && appGroup->folderId() >= 0)
+            knownGroupIds.insert(appGroup->folderId());
     }
 
-    int idNumber = 0;
-    while (knownGroupIds.contains(QString("internal/group/%1").arg(idNumber))) {
+    int idNumber = 1;
+    while (knownGroupIds.contains(idNumber)) {
         idNumber++;
     }
 
-    return QString("internal/group/%1").arg(idNumber);
+    return AppGroup::groupIdFromNumber(idNumber);
 }
 
 AppGroup * AppGroupManager::appendGroup(int groupId, QString groupName, const QList<QStringList> &appItemIDs)

applets/dde-apps/appsapplet.cpp

@@ -1,17 +1,32 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
 #include "appsapplet.h"
+#include "amappitem.h"
 #include "amappitemmodel.h"
+#include "appgroup.h"
 #include "appgroupmanager.h"
+#include "appitemmodel.h"
+#include "itemspage.h"
 #include "pluginfactory.h"
 
 #include <DUtil>
 #include <QtConcurrent>
 
 namespace apps
 {
+static AMAppItem *findApplication(AMAppItemModel *model, const QString &desktopId)
+{
+    if (auto item = model->appItem(desktopId))
+        return item;
+
+    const auto alternateId = desktopId.endsWith(QStringLiteral(".desktop"))
+        ? desktopId.chopped(8)
+        : desktopId + QStringLiteral(".desktop");
+    return model->appItem(alternateId);
+}
+
 AppsApplet::AppsApplet(QObject *parent)
     : DApplet(parent)
     , m_appModel(new AMAppItemModel(this))
@@ -40,6 +55,39 @@ QAbstractItemModel *AppsApplet::appModel() const
     return m_appModel;
 }
 
+QVariantList AppsApplet::groupItemDetails(const QString &groupId) const
+{
+    const int id = AppGroup::parseGroupId(groupId);
+    auto group = id > 0 ? m_groupModel->group(id) : nullptr;
+    if (!group)
+        return {};
+
+    const auto items = group->itemsPage()->allArrangedItems();
+    QVariantList result;
+    result.reserve(items.size());
+    for (const auto &desktopId : items) {
+        const auto item = findApplication(m_appModel, desktopId);
+        if (!item)
+            continue;
+        result.append(QVariantMap{
+            {QStringLiteral("desktopId"), desktopId},
+            {QStringLiteral("name"), item->data(AppItemModel::NameRole)},
+            {QStringLiteral("iconName"), item->data(AppItemModel::IconNameRole)},
+        });
+    }
+    return result;
+}
+
+bool AppsApplet::launchApplication(const QString &desktopId)
+{
+    if (auto item = findApplication(m_appModel, desktopId)) {
+        item->launch({}, {}, {{QStringLiteral("_launch_type"), QStringLiteral("dde-shell")}});
+        return true;
+    }
+
+    return false;
+}
+
 bool AppsApplet::appModelReady() const
 {
     return m_appModel->ready();

applets/dde-apps/appsapplet.h

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
@@ -13,6 +13,7 @@ DS_USE_NAMESPACE
 
 namespace apps {
 class AMAppItemModel;
+class AppGroupManager;
 class AppItem;
 class AppsApplet : public DApplet
 {
@@ -30,6 +31,9 @@ class AppsApplet : public DApplet
     QAbstractItemModel *appModel() const;
     QAbstractItemModel *groupModel() const;
 
+    Q_INVOKABLE QVariantList groupItemDetails(const QString &groupId) const;
+    Q_INVOKABLE bool launchApplication(const QString &desktopId);
+
     bool appModelReady() const;
 
 signals:
@@ -38,6 +42,6 @@ class AppsApplet : public DApplet
 private:
     bool m_appModelReady;
     AMAppItemModel *m_appModel;
-    QAbstractItemModel *m_groupModel;
+    AppGroupManager *m_groupModel;
 };
 }

panels/dock/MenuHelper.qml

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2023 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2023 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 

panels/dock/dockpositioner.cpp

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 -2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 

panels/dock/dockpositioner.h

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd.
+// SPDX-FileCopyrightText: 2024 - 2026 UnionTech Software Technology Co., Ltd.
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 

panels/dock/package/main.qml

@@ -495,13 +495,13 @@ Window {
             cornerRadius: fashionDock.enabled ? fashionDock.backgroundRadius : 0
             blendColor: {
                 if (valid) {
-                    return DStyle.Style.control.selectColor(undefined,
+                    return D.Style.control.selectColor(undefined,
                                                         Qt.rgba(235 / 255.0, 235 / 255.0, 235 / 255.0, dock.blendColorAlpha(0.6)),
                                                         Qt.rgba(10 / 255, 10 / 255, 10 /255, dock.blendColorAlpha(85 / 255)))
                 }
-                return DStyle.Style.control.selectColor(undefined,
-                                                    DStyle.Style.behindWindowBlur.lightNoBlurColor,
-                                                    DStyle.Style.behindWindowBlur.darkNoBlurColor)
+                return D.Style.control.selectColor(undefined,
+                                                    D.Style.behindWindowBlur.lightNoBlurColor,
+                                                    D.Style.behindWindowBlur.darkNoBlurColor)
             }
         }
 
@@ -622,6 +622,8 @@ Window {
                 visible: dockLeftPartModel.count > 0
                 implicitWidth: leftLoader.implicitWidth
                 implicitHeight: leftLoader.implicitHeight
+                Accessible.role: Accessible.Grouping
+                Accessible.name: qsTr("Dock Left Area")
                 OverflowContainer {
                     id: leftLoader
                     anchors.fill: parent
@@ -640,8 +642,8 @@ Window {
                 implicitHeight: centerLoader.implicitHeight
                 Accessible.role: Accessible.Grouping
                 Accessible.name: qsTr("Dock Center Area")
-                Layout.maximumWidth: useColumnLayout ? -1 : dockRawCenterSpace
-                Layout.maximumHeight: useColumnLayout ? dockRawCenterSpace : -1
+                Layout.maximumWidth: useColumnLayout ? -1 : dockEffectiveCenterSpace
+                Layout.maximumHeight: useColumnLayout ? dockEffectiveCenterSpace : -1
                 onXChanged: dockCenterPartPosChanged()
                 onYChanged: dockCenterPartPosChanged()
                 Layout.leftMargin: !useColumnLayout && !fashionDock.enabled && Panel.itemAlignment === Dock.CenterAlignment ?