docs: Sort sidebar (#454)

docs/.vitepress/en.mts

@@ -1,4 +1,5 @@
 import { type DefaultTheme, defineConfig } from 'vitepress';
+import { sortByText } from '../libs/sortByText.mts';
 
 export const en = defineConfig({
   lang: 'en',
@@ -44,7 +45,7 @@ function sidebar(): DefaultTheme.Sidebar {
     },
     {
       text: 'Reference',
-      items: [
+      items: sortByText([
         {
           text: 'Array Utilities',
           items: [
@@ -232,7 +233,7 @@ function sidebar(): DefaultTheme.Sidebar {
             { text: 'TimeoutError', link: '/reference/error/TimeoutError' },
           ],
         },
-      ],
+      ]),
     },
   ];
 }

docs/.vitepress/ja.mts

@@ -1,4 +1,5 @@
 import { type DefaultTheme, defineConfig } from 'vitepress';
+import { sortByText } from '../libs/sortByText.mts';
 
 export const ja = defineConfig({
   lang: 'ja',
@@ -43,7 +44,7 @@ function sidebar(): DefaultTheme.Sidebar {
     },
     {
       text: 'リファレンス',
-      items: [
+      items: sortByText([
         {
           text: '配列',
           items: [
@@ -228,7 +229,7 @@ function sidebar(): DefaultTheme.Sidebar {
             { text: 'TimeoutError', link: '/ja/reference/error/TimeoutError' },
           ],
         },
-      ],
+      ]),
     },
   ];
 }

docs/.vitepress/ko.mts

@@ -1,4 +1,5 @@
 import { type DefaultTheme, defineConfig } from 'vitepress';
+import { sortByText } from '../libs/sortByText.mts';
 
 export const ko = defineConfig({
   lang: 'ko',
@@ -43,7 +44,7 @@ function sidebar(): DefaultTheme.Sidebar {
     },
     {
       text: '레퍼런스',
-      items: [
+      items: sortByText([
         {
           text: '배열',
           items: [
@@ -245,7 +246,7 @@ function sidebar(): DefaultTheme.Sidebar {
             { text: 'TimeoutError', link: '/ko/reference/error/TimeoutError' },
           ],
         },
-      ],
+      ]),
     },
   ];
 }

docs/.vitepress/zh_hans.mts

@@ -1,4 +1,5 @@
 import { type DefaultTheme, defineConfig } from 'vitepress';
+import { sortByText } from '../libs/sortByText.mts';
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export const zh_hans = defineConfig({
@@ -44,7 +45,7 @@ function sidebar(): DefaultTheme.Sidebar {
     },
     {
       text: '参考',
-      items: [
+      items: sortByText([
         {
           text: '数组工具',
           items: [
@@ -229,7 +230,7 @@ function sidebar(): DefaultTheme.Sidebar {
             { text: 'TimeoutError', link: '/zh_hans/reference/error/TimeoutError' },
           ],
         },
-      ],
+      ]),
     },
   ];
 }

docs/libs/sortByText.mts

@@ -0,0 +1,17 @@
+import { DefaultTheme } from 'vitepress';
+
+export function sortByText(items: DefaultTheme.SidebarItem[]): DefaultTheme.SidebarItem[] {
+  return items.slice().map(item => {
+    if (item.items) {
+      item.items = item.items.sort((a, b) => {
+        if (typeof a.text === 'string' && typeof b.text === 'string') {
+          return a.text.localeCompare(b.text);
+        }
+
+        return 0;
+      });
+    }
+
+    return item;
+  });
+}