build: migrate to @docusaurus/faster and modernise config

- Replace custom webpack/SWC loader config with @docusaurus/faster (rspack)
- Remove babel.config.js (no longer needed)
- Move onBrokenMarkdownLinks into markdown.hooks per v4 API
- Enable future.faster and future.v4.removeLegacyPostBuildHeadAttribute
- Replace ExecutionEnvironment import with inline canUseDOM check
- Add deployment summary step to publish workflow
- Fix pages-environment output reference to use bracket notation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: homotechsual

.github/workflows/publish.yml

@@ -112,6 +112,27 @@ jobs:
           echo "alias_url=$ALIAS_URL" >> "$GITHUB_OUTPUT"
           echo "final_url=$FINAL_URL" >> "$GITHUB_OUTPUT"
 
+      - name: Write deployment summary
+        shell: bash
+        env:
+          COMMIT_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          ENVIRONMENT: ${{ steps.cloudflare-pages-deploy.outputs['pages-environment'] }}
+          DEPLOYMENT_URL: ${{ steps.deploy-urls.outputs.deployment_url }}
+          PREVIEW_URL: ${{ steps.deploy-urls.outputs.final_url }}
+        run: |
+          {
+            echo "## Deploying with Cloudflare Pages"
+            echo
+            echo "| Name | Result |"
+            echo "| --- | --- |"
+            echo "| Last commit | \`$COMMIT_SHA\` |"
+            echo "| Deploy log | [View run]($RUN_URL) |"
+            echo "| Preview URL | [$PREVIEW_URL]($PREVIEW_URL) |"
+            echo "| Deployment URL | [$DEPLOYMENT_URL]($DEPLOYMENT_URL) |"
+            echo "| Environment | $ENVIRONMENT |"
+          } >> "$GITHUB_STEP_SUMMARY"
+
       - name: Create commit comment
         if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
         uses: peter-evans/commit-comment@v4
@@ -121,7 +142,7 @@ jobs:
             | <span aria-hidden="true">🔨</span> **Latest commit** | ${{ github.event.pull_request.head.sha || github.sha }} |
             | <span aria-hidden="true">🔍</span> **Latest deploy log** | ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} |
             | <span aria-hidden="true">😎</span> **Deploy preview URL** | [${{ steps.deploy-urls.outputs.final_url }}](${{ steps.deploy-urls.outputs.final_url }}) |
-            | <span aria-hidden="true">🌳</span> **Environment** | ${{ steps.cloudflare-pages-deploy.outputs.environment }} |
+            | <span aria-hidden="true">🌳</span> **Environment** | ${{ steps.cloudflare-pages-deploy.outputs['pages-environment'] }} |
 
       - name: Create PR comment
         if: ${{ github.event_name == 'pull_request' || github.event_name == 'pull_request_target' }}
@@ -132,7 +153,7 @@ jobs:
             | <span aria-hidden="true">🔨</span> **Latest commit** | ${{ github.event.pull_request.head.sha || github.sha }} |
             | <span aria-hidden="true">🔍</span> **Latest deploy log** | ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} |
             | <span aria-hidden="true">😎</span> **Deploy preview URL** | [${{ steps.deploy-urls.outputs.final_url }}](${{ steps.deploy-urls.outputs.final_url }}) |
-            | <span aria-hidden="true">🌳</span> **Environment** | ${{ steps.cloudflare-pages-deploy.outputs.environment }} |
+            | <span aria-hidden="true">🌳</span> **Environment** | ${{ steps.cloudflare-pages-deploy.outputs['pages-environment'] }} |
 
       - name: Remove label
         if: ${{ github.event_name == 'pull_request_target' && contains(github.event.label.name, '🚀request-deploy') }}

.yarn/install-state.gz

@@ -71,7 +71,6 @@ const config: Config = {
   organizationName: 'homotechsual', // Usually your GitHub org/user name.
   projectName: 'docusaurus.community', // Usually your repo name.
   onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'throw',
   trailingSlash: true,
   i18n: {
     defaultLocale: 'en',
@@ -278,29 +277,10 @@ const config: Config = {
       }),
     ],
   ],
-  webpack: {
-    jsLoader: (isServer: boolean) => ({
-      loader: 'swc-loader',
-      options: {
-        jsc: {
-          parser: {
-            syntax: 'typescript',
-            tsx: true,
-          },
-          transform: {
-            react: {
-              runtime: 'automatic',
-            }
-          },
-          target: 'es2017',
-        },
-        module: {
-          type: isServer ? 'commonjs' : 'es6',
-        },
-      },
-    }),
-  },
   markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'throw',
+    },
     format: 'detect',
     mermaid: true,
     mdx1Compat: {
@@ -309,5 +289,11 @@ const config: Config = {
       admonitions: false,
     }
   },
+  future: {
+    faster: true,
+    v4: {
+      removeLegacyPostBuildHeadAttribute: true,
+    },
+  },
 };
 export default config;

babel.config.js

@@ -52,6 +52,7 @@
     "swc-loader": "^0.2.7"
   },
   "devDependencies": {
+    "@docusaurus/faster": "^3.10.1",
     "@docusaurus/module-type-aliases": "^3.10.1",
     "@docusaurus/tsconfig": "^3.10.1",
     "@docusaurus/types": "^3.10.1",

docusaurus.config.ts

@@ -7,7 +7,6 @@
 
 import React, {useState, useMemo, useEffect} from 'react';
 import clsx from 'clsx';
-import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
 import Translate, {translate} from '@docusaurus/Translate';
 import {useHistory, useLocation} from '@docusaurus/router';
 import {usePluralForm} from '@docusaurus/theme-common';
@@ -51,6 +50,8 @@ type UserState = {
   focusedElementId: string | undefined;
 };
 
+const canUseDOM = typeof window !== 'undefined' && typeof document !== 'undefined';
+
 function restoreUserState(userState: UserState | null) {
   const {scrollTopPosition, focusedElementId} = userState ?? {
     scrollTopPosition: 0,
@@ -61,7 +62,7 @@ function restoreUserState(userState: UserState | null) {
 }
 
 export function prepareUserState(): UserState | undefined {
-  if (ExecutionEnvironment.canUseDOM) {
+  if (canUseDOM) {
     return {
       scrollTopPosition: window.scrollY,
       focusedElementId: document.activeElement?.id,