From 6e2d86520b3f6f10a99702ed8d9b9963ce1beccc Mon Sep 17 00:00:00 2001
From: Terry Jia <terryjia88@gmail.com>
Date: Sun, 14 Sep 2025 03:40:44 -0400
Subject: [PATCH] add sortOrder for setting item (#5534)

* add priority for setting item

* keep original order

* remove comment
---
 src/components/dialog/content/SettingDialogContent.vue | 7 ++++++-
 src/types/settingTypes.ts                              | 3 +++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/components/dialog/content/SettingDialogContent.vue b/src/components/dialog/content/SettingDialogContent.vue
index 9f6eb3216..8c6e3ea90 100644
--- a/src/components/dialog/content/SettingDialogContent.vue
+++ b/src/components/dialog/content/SettingDialogContent.vue
@@ -113,7 +113,12 @@ const sortedGroups = (category: SettingTreeNode): ISettingGroup[] => {
     .sort((a, b) => a.label.localeCompare(b.label))
     .map((group) => ({
       label: group.label,
-      settings: flattenTree<SettingParams>(group)
+      settings: flattenTree<SettingParams>(group).sort((a, b) => {
+        const sortOrderA = a.sortOrder ?? 0
+        const sortOrderB = b.sortOrder ?? 0
+
+        return sortOrderB - sortOrderA
+      })
     }))
 }
 
diff --git a/src/types/settingTypes.ts b/src/types/settingTypes.ts
index 08453bde9..9044168d7 100644
--- a/src/types/settingTypes.ts
+++ b/src/types/settingTypes.ts
@@ -43,6 +43,9 @@ export interface SettingParams<TValue = unknown> extends FormItem {
   versionAdded?: string
   // Version of the setting when it was last modified
   versionModified?: string
+  // sortOrder for sorting settings within a group. Higher values appear first.
+  // Default is 0 if not specified.
+  sortOrder?: number
 }
 
 /**