fix(website): unbreak docusaurus build on 3.10.x (#1062)

The "Test docs deployment" CI workflow has been failing since Docusaurus
3.10 was released. Two distinct issues, fixed together so every commit
on this branch keeps CI green:

1. `future.v4: true` in `docusaurus.config.ts` now routes through the
rspack bundler path, which hard-requires `@docusaurus/faster` to be a
direct dependency. Add it and bump all `@docusaurus/*` packages from
`^3.9.2` to `^3.10.1`. Refresh other website deps within their existing
ranges (no major-version jumps).

2. Docusaurus 3.10's MDX loader is stricter and rejects HTML comments
(`<!-- ... -->`) in `.md` files. The git-cliff-generated patch notes
contain these comments. Keep them in `cliff.toml`/`CHANGELOG.md` (so
GitHub-rendered output stays clean) but transform `<!--`/`-->` to
`{/*`/`*/}` in the workflow's copy step that produces
`docs/developers/patch-notes.md`. Apply the same transform to the
already-checked-in `patch-notes.md` and `release-notes/0.12.md`.

Author: alexpasmantier

.github/workflows/changelog.yml

@@ -28,7 +28,10 @@ jobs:
           GITHUB_REPO: ${{ github.repository }}
       - name: Copy changelog to docs
         run: |
-          cp CHANGELOG.md 'docs/developers/patch-notes.md'
+          # MDX (used by docusaurus) does not allow HTML comments, so rewrite
+          # the cliff-template markers into MDX-style `{/* ... */}` comments.
+          sed -e 's|<!--|{/*|g' -e 's|-->|*/}|g' \
+              CHANGELOG.md > 'docs/developers/patch-notes.md'
       - name: Extract branch name
         shell: bash
         run: echo "branch=${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" >> $GITHUB_OUTPUT

docs/developers/patch-notes.md

@@ -1,8 +1,8 @@
 # Changelog
 
 All notable changes to this project will be documented in this file.
-<!-- ignore lint rules that are often triggered by content generated from commits / git-cliff -->
-<!-- markdownlint-disable line-length no-bare-urls ul-style emphasis-style -->
+{/* ignore lint rules that are often triggered by content generated from commits / git-cliff */}
+{/* markdownlint-disable line-length no-bare-urls ul-style emphasis-style */}
 
 ## [0.15.6](https://github.com/alexpasmantier/television/releases/tag/0.15.6) - 2026-04-15
 
@@ -1899,5 +1899,5 @@ All notable changes to this project will be documented in this file.
 * @alexpasmantier made their first contribution
 
 
-<!-- generated by git-cliff -->
+{/* generated by git-cliff */}
 

docs/developers/release-notes/0.12.md

@@ -361,4 +361,4 @@ Television now has [a brand new website](https://alexpasmantier.github.io/televi
 
 **Full Changelog**: https://github.com/alexpasmantier/television/compare/0.11.9...0.12.0
 
-<!-- generated by git-cliff -->
+{/* generated by git-cliff */}

website/package.json

@@ -14,25 +14,26 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docsearch/react": "^4.6.0",
-    "@docusaurus/core": "^3.9.2",
-    "@docusaurus/preset-classic": "^3.9.2",
-    "@docusaurus/theme-common": "^3.9.2",
-    "@docusaurus/theme-mermaid": "^3.9.2",
-    "@docusaurus/theme-search-algolia": "^3.9.2",
+    "@docsearch/react": "^4.6.3",
+    "@docusaurus/core": "^3.10.1",
+    "@docusaurus/faster": "^3.10.1",
+    "@docusaurus/preset-classic": "^3.10.1",
+    "@docusaurus/theme-common": "^3.10.1",
+    "@docusaurus/theme-mermaid": "^3.10.1",
+    "@docusaurus/theme-search-algolia": "^3.10.1",
     "@mdx-js/react": "^3.1.1",
     "clsx": "^2.1.1",
     "prism-react-renderer": "^2.4.1",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4"
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6"
   },
   "devDependencies": {
-    "@algolia/autocomplete-core": "^1.19.6",
-    "@docusaurus/module-type-aliases": "^3.9.2",
-    "@docusaurus/tsconfig": "^3.9.2",
-    "@docusaurus/types": "^3.9.2",
+    "@algolia/autocomplete-core": "^1.19.8",
+    "@docusaurus/module-type-aliases": "^3.10.1",
+    "@docusaurus/tsconfig": "^3.10.1",
+    "@docusaurus/types": "^3.10.1",
     "@types/react": "^19.2.14",
-    "algoliasearch": "^5.49.1",
+    "algoliasearch": "^5.52.1",
     "typescript": "~5.9.3"
   },
   "browserslist": {