mochajs · JoshuaKGoldberg · Apr 8, 2025 · Apr 8, 2025 · Dec 19, 2025
diff --git a/docs-next/.gitignore b/docs-next/.gitignore
@@ -1,4 +1,5 @@
 .astro/
+api/
 dist/
 node_modules/
 src/content/data/supporters.json
diff --git a/docs-next/astro.config.ts b/docs-next/astro.config.ts
@@ -1,6 +1,7 @@
 import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
 import { visit } from "unist-util-visit";
+import starlightTypeDoc, { typeDocSidebarGroup } from "starlight-typedoc";
 
 const base = "/next";
 
@@ -29,6 +30,15 @@ export default defineConfig({
         dark: "./src/components/icon-dark.svg",
         light: "./src/components/icon-light.svg",
       },
+      plugins: [
+        starlightTypeDoc({
+          entryPoints: ["../lib/mocha.js"],
+          sidebar: {
+            collapsed: true,
+          },
+          tsconfig: "../tsconfig.json",
+        }),
+      ],
       sidebar: [
         { label: "Getting Started", slug: "getting-started" },
         {
@@ -176,8 +186,9 @@ export default defineConfig({
           ],
           label: "Explainers",
         },
+        typeDocSidebarGroup,
         {
-          label: "API",
+          label: "API (legacy)",
           link: "https://mochajs.org/api",
         },
       ],

diff --git a/docs-next/package-lock.json b/docs-next/package-lock.json
diff --git a/docs-next/package.json b/docs-next/package.json
@@ -21,6 +21,7 @@
     "needle": "^3.3.1",
     "sharp": "^0.34.5",
     "starlight-package-managers": "^0.11.1",
+    "starlight-typedoc": "^0.21.5",
     "typescript": "^5.9.3",
     "unist-util-visit": "^5.0.0"
   }

diff --git a/tsconfig.json b/tsconfig.json
@@ -1,10 +1,12 @@
 {
   "compilerOptions": {
     "allowJs": true,
-    "module": "Node16",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "noEmit": true,
     "resolveJsonModule": true,
-    "target": "ES2022",
-    "noEmit": true
+    "skipLibCheck": true,
+    "target": "ESNext"
   },
   "exclude": ["lib/browser"],
   "include": ["lib"]

diff --git a/typedoc.json b/typedoc.json
@@ -0,0 +1,5 @@
+{
+  "$schema": "https://typedoc.org/schema.json",
+  "entryPoints": ["./lib/mocha.js", "./lib/cli/cli.js"],
+  "out": "docs-next/api"
+}