fix(docs): correct versioned nav links and local dev version routing (#74)

scripts/docs-versioning.ts

@@ -1,3 +1,5 @@
+import { createHash } from 'node:crypto';
+
 export type DocsVersionEntry = {
   version: string;
   path: string;
@@ -57,14 +59,23 @@ export function versionArchiveCacheName(version: string, sharedInternalsHash: st
   return `${sharedInternalsHash.slice(0, 12)}-${version}`;
 }
 
+export function versionArchiveCacheKey(options: {
+  sharedInternalsHash: string;
+  manifestJson: string;
+}): string {
+  const hash = createHash('sha256');
+  hash.update('shared-internals:');
+  hash.update(options.sharedInternalsHash);
+  hash.update('\nmanifest:');
+  hash.update(options.manifestJson);
+  return hash.digest('hex');
+}
+
 export function stableTagsWithDocs(
   tags: string[],
   hasDocsSite: (tag: string) => boolean,
 ): string[] {
-  return tags
-    .filter(isStableReleaseTag)
-    .filter(hasDocsSite)
-    .sort(compareStableVersionsDesc);
+  return tags.filter(isStableReleaseTag).filter(hasDocsSite).sort(compareStableVersionsDesc);
 }
 
 export function buildVersionManifest(options: {