docs: link the docs version to its manifest and show it in the footer

apps/docs/build/meta.ts

@@ -79,6 +79,11 @@ if (
 
 export const META = {
   version,
+  /**
+   * The docs package's manifest on GitHub, where `version` is set — on `main`,
+   * the branch the site deploys from, like the "View source" links.
+   */
+  versionUrl: `${repoUrl}/blob/main/apps/docs/package.json`,
   siteUrl,
   repoUrl,
   /** The repository without its scheme, e.g. `github.com/mixedrays/keyrove`. */
@@ -106,10 +111,10 @@ const PLACEHOLDER = /^<div data-about><\/div>$/gm;
 
 const renderFacts = () =>
   [
-    // Both versions, each beside what it numbers: the footer shows the
-    // package's, and a lone "Docs version" reads as the release it documents.
+    // Both versions, each beside what it numbers: a lone "Docs version" reads
+    // as the release it documents.
     `- **Package** — [${META.packageName}](${META.npmUrl}) ${META.packageVersion} on npm`,
-    `- **Docs version** — ${META.version}, numbered separately from the package`,
+    `- **Docs version** — [${META.version}](${META.versionUrl}), numbered separately from the package`,
     `- **Repository** — [${META.repoLabel}](${META.repoUrl})`,
     `- **Author** — [@${META.author}](${META.authorUrl})`,
   ].join('\n');

apps/docs/src/components/site-chrome.tsx

@@ -102,7 +102,7 @@ export function SiteFooter({ layout }: { layout: Layout }) {
             keyrove
           </SiteLink>
           <span>
-            v{meta.packageVersion} &middot;{' '}
+            v{meta.packageVersion} &middot; docs v{meta.docsVersion} &middot;{' '}
             <SiteLink href="/docs/license" className="footer-link">
               MIT licensed
             </SiteLink>

apps/docs/src/virtual.d.ts

@@ -28,6 +28,8 @@ declare module 'virtual:docs/site' {
 
   export const meta: {
     packageVersion: string;
+    /** The docs package's own version, which moves when the site is released. */
+    docsVersion: string;
     repoUrl: string;
     npmUrl: string;
   };

apps/docs/vite-plugin-content.ts

@@ -170,6 +170,7 @@ const toSiteModule = (site: Site, addresses: Addresses) => {
   const data = {
     meta: {
       packageVersion: META.packageVersion,
+      docsVersion: META.version,
       repoUrl: META.repoUrl,
       npmUrl: META.npmUrl,
     },