feat: link to releases

Author: antfu

app/components/Package/Versions.vue

@@ -17,6 +17,7 @@ import { detectPublishSecurityDowngradeForVersion } from '~/utils/publish-securi
 import { useModal } from '~/composables/useModal'
 import { useAtproto } from '~/composables/atproto/useAtproto'
 import { togglePackageLike } from '~/utils/atproto/likes'
+import { getMatchedRelease } from '~/utils/releases'
 
 defineOgImageComponent('Package', {
   name: () => packageName.value,
@@ -358,7 +359,23 @@ const repositoryUrl = computed(() => {
   return url
 })
 
-const { meta: repoMeta, repoRef, stars, starsLink, forks, forksLink } = useRepoMeta(repositoryUrl)
+const {
+  meta: repoMeta,
+  repoRef,
+  stars,
+  starsLink,
+  forks,
+  forksLink,
+  releases,
+  releasesLink,
+  releasesPending,
+} = useRepoMeta(repositoryUrl)
+
+const currentVersionRelease = computed(() => {
+  const version = resolvedVersion.value ?? displayVersion.value?.version
+  if (!version || !releases.value.length) return null
+  return getMatchedRelease(version, releases.value)
+})
 
 const PROVIDER_ICONS: Record<string, string> = {
   github: 'i-carbon:logo-github',
@@ -591,6 +608,16 @@ onKeyStroke(
   },
 )
 
+onKeyStroke(
+  e => isKeyWithoutModifiers(e, 'r') && !isEditableElement(e.target),
+  e => {
+    if (!currentVersionRelease.value) return
+    e.preventDefault()
+    navigateTo(currentVersionRelease.value.url)
+  },
+  { dedupe: true },
+)
+
 const showSkeleton = shallowRef(false)
 </script>
 
@@ -734,6 +761,15 @@ const showSkeleton = shallowRef(false)
             >
               {{ $t('package.links.compare') }}
             </LinkBase>
+            <LinkBase
+              v-if="currentVersionRelease"
+              variant="button-secondary"
+              :to="currentVersionRelease.url"
+              aria-keyshortcuts="r"
+              classicon="i-carbon-catalog"
+            >
+              {{ $t('package.links.release') }}
+            </LinkBase>
           </ButtonGroup>
 
           <!-- Package metrics -->
@@ -1334,6 +1370,7 @@ const showSkeleton = shallowRef(false)
             :dist-tags="pkg['dist-tags'] ?? {}"
             :time="pkg.time"
             :selected-version="resolvedVersion ?? pkg['dist-tags']?.['latest']"
+            :releases="releases"
           />
 
           <!-- Install Scripts Warning -->

app/composables/useRepoMeta.ts

@@ -0,0 +1,38 @@
+import type { Release } from '~/composables/useRepoMeta'
+
+/**
+ * Match an npm version string to a repository release.
+ * Handles various tag formats: "v1.0.0", "1.0.0", "release-1.0.0", etc.
+ *
+ * @param version - npm version string (e.g., "1.2.3", "0.9.0-beta.1")
+ * @param releases - Array of releases from repository
+ * @returns Matched release or null
+ */
+export function getMatchedRelease(version: string, releases: Release[]): Release | null {
+  if (!version || !releases.length) return null
+
+  // Normalize version for comparison (remove any existing 'v' prefix)
+  const normalizedVersion = version.replace(/^v/, '').toLowerCase()
+
+  // Try exact matches with common tag formats
+  const tagVariants = [
+    `v${normalizedVersion}`, // Most common: v1.0.0
+    normalizedVersion, // Without prefix: 1.0.0
+    `release-${normalizedVersion}`, // Some projects: release-1.0.0
+    `${normalizedVersion}-release`, // Alternative: 1.0.0-release
+  ]
+
+  for (const release of releases) {
+    if (!release.url) continue
+    const releaseTag = release.tag.toLowerCase()
+
+    // Check each variant (case-insensitive)
+    for (const variant of tagVariants) {
+      if (releaseTag === variant) {
+        return release
+      }
+    }
+  }
+
+  return null
+}

app/pages/package/[[org]]/[name].vue

@@ -206,7 +206,14 @@
       "code": "code",
       "docs": "docs",
       "fund": "fund",
-      "compare": "compare"
+      "compare": "compare",
+      "release": "release"
+    },
+    "releases": {
+      "title": "Releases",
+      "view_all": "View all {count} releases",
+      "view_release": "View release",
+      "view_release_for_version": "View release for {version}"
     },
     "likes": {
       "like": "Like this package",

app/utils/releases.ts

@@ -624,6 +624,27 @@
             },
             "compare": {
               "type": "string"
+            },
+            "release": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "releases": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string"
+            },
+            "view_all": {
+              "type": "string"
+            },
+            "view_release": {
+              "type": "string"
+            },
+            "view_release_for_version": {
+              "type": "string"
             }
           },
           "additionalProperties": false

i18n/locales/en.json

@@ -205,7 +205,14 @@
       "code": "code",
       "docs": "docs",
       "fund": "fund",
-      "compare": "compare"
+      "compare": "compare",
+      "release": "release"
+    },
+    "releases": {
+      "title": "Releases",
+      "view_all": "View all {count} releases",
+      "view_release": "View release",
+      "view_release_for_version": "View release for {version}"
     },
     "likes": {
       "like": "Like this package",

i18n/schema.json

@@ -205,7 +205,14 @@
       "code": "code",
       "docs": "docs",
       "fund": "fund",
-      "compare": "compare"
+      "compare": "compare",
+      "release": "release"
+    },
+    "releases": {
+      "title": "Releases",
+      "view_all": "View all {count} releases",
+      "view_release": "View release",
+      "view_release_for_version": "View release for {version}"
     },
     "likes": {
       "like": "Like this package",