fix: Order versioned docs select items by recency

src/components/versionSelector/index.tsx

@@ -11,8 +11,31 @@ import styles from './style.module.scss';
 
 import {VersionBanner} from '../versionBanner';
 
+function sortVersions(versions: string[]) {
+  return versions.sort((a, b) => {
+    const aMajor = parseInt(a.split('.')[0], 10);
+    const bMajor = parseInt(b.split('.')[0], 10);
+
+    if (isNaN(aMajor) || isNaN(bMajor)) {
+      return a.localeCompare(b);
+    }
+
+    if (aMajor < bMajor) {
+      return 1;
+    }
+
+    if (aMajor === bMajor) {
+      // yes, this is flawed. But for now there's no case where we need to order
+      // by minor or patch so I wanna avoid pulling in semver as a dependency
+      return a.localeCompare(b);
+    }
+
+    return -1;
+  });
+}
+
 export function VersionSelector({versions, sdk}: {sdk: string; versions: string[]}) {
-  const availableVersions = ['latest', ...versions];
+  const availableVersions = ['latest', ...sortVersions([...versions])];
   const router = useRouter();
   const pathname = usePathname();