From 0405db8d8007af268ff1a49fe4f8b305a3174295 Mon Sep 17 00:00:00 2001
From: Josh B <421772+HT154@users.noreply.github.com>
Date: Fri, 16 Feb 2024 05:25:49 -0800
Subject: [PATCH] [pkl-doc] Sort stdlib first on the main page (#165)

---
 .../src/main/kotlin/org/pkl/doc/MainPageGenerator.kt   | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/pkl-doc/src/main/kotlin/org/pkl/doc/MainPageGenerator.kt b/pkl-doc/src/main/kotlin/org/pkl/doc/MainPageGenerator.kt
index 0a3183fd..bd566a9f 100644
--- a/pkl-doc/src/main/kotlin/org/pkl/doc/MainPageGenerator.kt
+++ b/pkl-doc/src/main/kotlin/org/pkl/doc/MainPageGenerator.kt
@@ -67,6 +67,14 @@ internal class MainPageGenerator(
   private fun HtmlBlockTag.renderPackages() {
     if (packagesData.isEmpty()) return
 
+    val sortedPackages =
+      packagesData.sortedWith { pkg1, pkg2 ->
+        when {
+          pkg1.ref.pkg == "pkl" -> -1 // always sort the stdlib first
+          else -> pkg1.ref.pkg.compareTo(pkg2.ref.pkg)
+        }
+      }
+
     div {
       classes = setOf("member-group")
 
@@ -79,7 +87,7 @@ internal class MainPageGenerator(
       }
 
       ul {
-        for (pkg in packagesData) {
+        for (pkg in sortedPackages) {
           val packageScope =
             pageScope.packageScopes[pkg.ref.pkg]
             // create scope for previously generated package