Fix the docs typecheck script, and gate the docs site on PRs

.github/workflows/docs.yml

@@ -34,6 +34,7 @@ jobs:
       - run: |
           pnpm install --frozen-lockfile
           pnpm build
+          pnpm --filter docs typecheck
           pnpm docs:build
       - uses: actions/upload-pages-artifact@v5
         with:

.github/workflows/test.yml

@@ -80,6 +80,53 @@ jobs:
       - name: Biome lint/format (packages/*/src)
         run: pnpm lint:biome
 
+  docs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    # The docs site is excluded from `pnpm build` and `pnpm test`, so nothing on a
+    # PR used to compile it. Its own `typecheck` script was broken for long enough
+    # to go unnoticed (it called `tsc`, which the TS 6 compat package does not
+    # provide), and the Docs workflow that would have caught it only runs on main —
+    # by which point the failure is already blocking a Pages deploy. This job is
+    # that workflow's Build steps minus the deploy, so the same breakage fails on
+    # the PR instead.
+    steps:
+      - name: Check out repository (docs)
+        uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          run_install: false
+
+      - name: Setup Node
+        uses: actions/setup-node@v7
+        with:
+          node-version: '24.14.1'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # Required, not incidental: docs imports `@spatialdata/vis`, and the
+      # workspace packages resolve types through `dist/index.d.ts`, which only
+      # exists after their build. Without this the typecheck fails on a bare
+      # "Cannot find module '@spatialdata/vis'".
+      - name: Build packages
+        run: pnpm build
+
+      - name: Typecheck docs site
+        run: pnpm --filter docs typecheck
+
+      # Catches what the typecheck cannot: broken MDX, dead internal links, and
+      # Docusaurus config/plugin regressions. Kept after the typecheck so the
+      # cheap check reports first. Same order as the Docs workflow's Build job.
+      - name: Build docs site
+        run: pnpm docs:build
+
   test:
     runs-on: ubuntu-latest
     steps:

docs/package.json

@@ -13,7 +13,7 @@
     "serve": "docusaurus serve",
     "write-translations": "docusaurus write-translations",
     "write-heading-ids": "docusaurus write-heading-ids",
-    "typecheck": "tsc"
+    "typecheck": "tsc6"
   },
   "dependencies": {
     "@docusaurus/core": "3.10.2",
@@ -33,6 +33,7 @@
     "@docusaurus/module-type-aliases": "3.10.2",
     "@docusaurus/tsconfig": "3.10.2",
     "@docusaurus/types": "3.10.2",
+    "@types/react": "catalog:",
     "typescript": "catalog:"
   },
   "browserslist": {

docs/tsconfig.json

@@ -2,7 +2,12 @@
   // This file is not used in compilation. It is here just for a nice editor experience.
   "extends": "@docusaurus/tsconfig",
   "compilerOptions": {
-    "baseUrl": "."
+    // `baseUrl` is what anchors the inherited `@site/*` path mapping to this
+    // directory, so it has to stay until @docusaurus/tsconfig drops its own
+    // `baseUrl`. TS 6 deprecates the option (TS 7 removes it outright), hence the
+    // opt-out below and the `tsc6` typecheck script.
+    "baseUrl": ".",
+    "ignoreDeprecations": "6.0"
   },
   "exclude": [".docusaurus", "build"]
 }