Merge pull request #723 from dahlia/docs/jsr-ref

Link docs refs across Fedify packages

Author: dahlia

docs/.gitignore

@@ -1,4 +1,5 @@
 .jsr-cache.json
+.jsr-*-cache.json
 .vitepress/cache/
 .vitepress/dist/
 node_modules/

docs/.vitepress/config.mts

@@ -15,11 +15,24 @@ import {
 import llmstxt from "vitepress-plugin-llms";
 import { withMermaid } from "vitepress-plugin-mermaid";
 
-const jsrRefPlugin = await jsrRef({
-  package: "@fedify/fedify",
-  version: process.env.JSR_REF_VERSION ?? "unstable",
-  cachePath: ".jsr-cache.json",
-});
+const jsrRefVersion = process.env.JSR_REF_VERSION ?? "unstable";
+const jsrRefPackages = [
+  ["@fedify/fedify", ".jsr-cache.json"],
+  ["@fedify/vocab", ".jsr-vocab-cache.json"],
+  ["@fedify/vocab-runtime", ".jsr-vocab-runtime-cache.json"],
+  ["@fedify/webfinger", ".jsr-webfinger-cache.json"],
+  ["@fedify/debugger", ".jsr-debugger-cache.json"],
+  ["@fedify/testing", ".jsr-testing-cache.json"],
+] as const;
+const jsrRefPlugins = await Promise.all(
+  jsrRefPackages.map(([packageName, cachePath]) =>
+    jsrRef({
+      package: packageName,
+      version: jsrRefVersion,
+      cachePath,
+    })
+  ),
+);
 
 let extraNav: { text: string; link: string }[] = [];
 if (process.env.EXTRA_NAV_TEXT && process.env.EXTRA_NAV_LINK) {
@@ -300,7 +313,9 @@ export default withMermaid(defineConfig({
       md.use(footnote);
       md.use(taskLists);
       md.use(groupIconMdPlugin);
-      md.use(jsrRefPlugin);
+      for (const jsrRefPlugin of jsrRefPlugins) {
+        md.use(jsrRefPlugin);
+      }
     },
   },
   sitemap: {

docs/package.json

@@ -56,7 +56,7 @@
     "markdown-it-abbr": "^2.0.0",
     "markdown-it-deflist": "^3.0.0",
     "markdown-it-footnote": "^4.0.0",
-    "markdown-it-jsr-ref": "0.4.1",
+    "markdown-it-jsr-ref": "0.4.4",
     "mermaid": "^11.4.1",
     "postgres": "catalog:",
     "srvx": "^0.11.15",