refactor: rework social icons for Adventure links

Author: zlataovce

astro.config.ts

@@ -12,10 +12,12 @@ import {
   LATEST_ADVENTURE_API_RELEASE,
   LATEST_ADVENTURE_PLATFORM_MOD_RELEASE,
   LATEST_ADVENTURE_PLATFORM_RELEASE,
+  LATEST_FOLIA_RELEASE,
   LATEST_MC_RELEASE,
   LATEST_PAPER_RELEASE,
   LATEST_USERDEV_RELEASE,
   LATEST_VELOCITY_RELEASE,
+  LATEST_WATERFALL_RELEASE,
 } from "./src/utils/versions";
 
 const prod = process.env.NODE_ENV === "production";
@@ -37,9 +39,32 @@ export default defineConfig({
     starlight({
       title: "PaperMC Docs",
       social: [
+        { icon: "github", label: "paper:GitHub", href: "https://github.com/PaperMC/Paper" },
+        { icon: "seti:java", label: "paper:Javadoc", href: `https://jd.papermc.io/paper/${LATEST_PAPER_RELEASE}` },
+
+        { icon: "github", label: "velocity:GitHub", href: "https://github.com/PaperMC/Velocity" },
+        {
+          icon: "seti:java",
+          label: "velocity:Javadoc",
+          href: `https://jd.papermc.io/velocity/${LATEST_VELOCITY_RELEASE.substring(0, LATEST_VELOCITY_RELEASE.lastIndexOf("."))}.0`,
+        },
+
+        { icon: "github", label: "folia:GitHub", href: "https://github.com/PaperMC/Folia" },
+        { icon: "seti:java", label: "folia:Javadoc", href: `https://jd.papermc.io/folia/${LATEST_FOLIA_RELEASE}` },
+
+        { icon: "github", label: "adventure:GitHub", href: "https://github.com/KyoriPowered/adventure" },
+        { icon: "seti:java", label: "adventure:Javadoc", href: "https://jd.advntr.dev" },
+
+        { icon: "github", label: "waterfall:GitHub", href: "https://github.com/PaperMC/Waterfall" },
+        {
+          icon: "seti:java",
+          label: "waterfall:Javadoc",
+          href: `https://jd.papermc.io/waterfall/${LATEST_WATERFALL_RELEASE}`,
+        },
+
         { icon: "github", label: "GitHub", href: "https://github.com/PaperMC" },
-        { icon: "discord", label: "Discord", href: "https://discord.gg/PaperMC" },
         { icon: "seti:java", label: "Javadoc", href: "https://jd.papermc.io" },
+        { icon: "discord", label: "Discord", href: "https://discord.gg/PaperMC" },
       ],
       lastUpdated: true,
       editLink: {
@@ -521,7 +546,9 @@ export default defineConfig({
           constants: {
             LATEST_MC_RELEASE,
             LATEST_PAPER_RELEASE,
+            LATEST_FOLIA_RELEASE,
             LATEST_VELOCITY_RELEASE,
+            LATEST_WATERFALL_RELEASE,
             LATEST_USERDEV_RELEASE,
             LATEST_ADVENTURE_API_RELEASE,
             LATEST_ADVENTURE_PLATFORM_RELEASE,

src/components/overrides/SocialIcons.astro

@@ -1,30 +1,21 @@
 ---
 import config from "virtual:starlight/user-config";
 import { Icon } from "@astrojs/starlight/components";
-import { LATEST_RELEASES } from "../../utils/versions";
 
 const { isPageWithTopic, topics } = Astro.locals.starlightSidebarTopics;
 const currentTopic = isPageWithTopic ? topics.find((t) => t.isCurrent) : null;
 
-const links = (config.social || []).map((link) => {
-  const project = currentTopic?.label?.toLowerCase();
-  if (!project) {
-    return link;
-  }
-
-  const version = LATEST_RELEASES[project];
-  if (!version) {
-    return link;
-  }
+const project = currentTopic?.label?.toLowerCase();
 
-  switch (link.label) {
-    case "Javadoc":
-      return { ...link, href: `${link.href}/${project}/${version}` };
-    case "GitHub":
-      return { ...link, href: `${link.href}/${project}` };
-  }
-  return link;
-});
+const links = (config.social || [])
+  .filter((l) => !l.label.includes(":") || (project && l.label.startsWith(`${project}:`)))
+  .map((link) => {
+    // strip project IDs
+    const index = link.label.indexOf(":");
+    return index !== -1 ? { ...link, label: link.label.substring(index + 1) } : link;
+  })
+  // deduplicate links with the same label
+  .filter((l, pos, self) => self.findIndex((e) => e.label === l.label) === pos);
 ---
 
 {

src/utils/versions.ts

@@ -74,15 +74,3 @@ export const LATEST_ADVENTURE_PLATFORM_MOD_RELEASE = adventurePlatformModVersion
 const adventureAnsiVersions: string[] = await fetchGitHubTags("KyoriPowered/ansi");
 
 export const LATEST_ADVENTURE_ANSI_RELEASE = adventureAnsiVersions[0];
-
-export const LATEST_RELEASES: Record<string, string> = {
-  paper: LATEST_PAPER_RELEASE,
-  velocity: LATEST_VELOCITY_RELEASE,
-  folia: LATEST_FOLIA_RELEASE,
-  waterfall: LATEST_WATERFALL_RELEASE,
-  userdev: LATEST_USERDEV_RELEASE,
-  "adventure-api": LATEST_ADVENTURE_API_RELEASE,
-  "adventure-platform": LATEST_ADVENTURE_PLATFORM_RELEASE,
-  "adventure-platform-mod": LATEST_ADVENTURE_PLATFORM_MOD_RELEASE,
-  "adventure-ansi": LATEST_ADVENTURE_ANSI_RELEASE,
-};