docs-utils: make reference table of content in alphabetical order (#10084)

www/utils/packages/typedoc-plugin-markdown-medusa/src/resources/helpers/toc.ts

@@ -30,7 +30,11 @@ export default function (theme: MarkdownTheme) {
         })
 
       function pushGroup(group: ReflectionGroup, md: string[]) {
-        const children = group.children.map(
+        const children = group.children
+          .sort((childA, childB) => {
+            return childA.name.localeCompare(childB.name)
+          })
+          .map(
             (child) =>
               `- [${escapeChars(child.name)}](${Handlebars.helpers.relativeURL(
                 child.url
@@ -44,12 +48,20 @@ export default function (theme: MarkdownTheme) {
           md.push(`## Table of contents\n\n`)
         }
         const headingLevel = hideInPageTOC ? `##` : `###`
-        this.groups?.forEach((group) => {
+        this.groups
+          ?.sort((groupA, groupB) => {
+            return groupA.title.localeCompare(groupB.title)
+          })
+          .forEach((group) => {
             const groupTitle = Object.hasOwn(reflectionGroupRename, group.title)
               ? reflectionGroupRename[group.title]
               : group.title
             if (group.categories) {
-            group.categories.forEach((category) => {
+              group.categories
+                .sort((catA, catB) => {
+                  return catA.title.localeCompare(catB.title)
+                })
+                .forEach((category) => {
                   md.push(`${headingLevel} ${category.title} ${groupTitle}\n\n`)
                   pushGroup(category as ReflectionGroup, md)
                   md.push("\n")