refactor: cherry-pick social icons rework from Adventure PR

Author: zlataovce

astro.config.ts

@@ -7,10 +7,12 @@ import starlightSidebarTopics from "starlight-sidebar-topics";
 import codeConstantsPlugin from "./src/utils/remark/code_const";
 import javadocPlugin from "./src/utils/remark/javadoc";
 import {
+  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";
@@ -32,9 +34,29 @@ 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: "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: {
@@ -433,6 +455,8 @@ export default defineConfig({
             LATEST_MC_RELEASE,
             LATEST_PAPER_RELEASE,
             LATEST_VELOCITY_RELEASE,
+            LATEST_FOLIA_RELEASE,
+            LATEST_WATERFALL_RELEASE,
             LATEST_USERDEV_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

@@ -55,11 +55,3 @@ const userdevVersions: string[] = await fetch("https://api.github.com/repos/Pape
   .then((tags: Tag[]) => tags.map((t) => t.name.substring(1)));
 
 export const LATEST_USERDEV_RELEASE = userdevVersions[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,
-};