docs: add Ask AI feature (#744)

## Description

- bumped `docusaurus`, `react`, `node` and `t-rex-ui` versions for our
docs
- added `Docsearch Ask AI` feature to our docs
- configured Algolia Ask AI assistant
- updated `docs-build-check` workflow to use required node version
(`20+`)

### Introduces a breaking change?

- [ ] Yes
- [x] No

### Type of change

- [ ] Bug fix (change which fixes an issue)
- [ ] New feature (change which adds functionality)
- [x] Documentation update (improves or adds clarity to existing
documentation)
- [ ] Other (chores, tests, code style improvements etc.)

### Tested on

- [ ] iOS
- [ ] Android

### Testing instructions

- try to build docs locally (`yarn build -> yarn serve`) from this
branch

### Screenshots


https://github.com/user-attachments/assets/0eaabb6e-7c97-4c20-bb16-16d693970791


https://github.com/user-attachments/assets/201202ff-8c9f-48b3-b36d-eb25609e10b9

### Related issues

<!-- Link related issues here using #issue-number -->

### Checklist

- [ ] I have performed a self-review of my code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have updated the documentation accordingly
- [ ] My changes generate no new warnings

### Additional notes

<!-- Include any additional information, assumptions, or context that
reviewers might need to understand this PR. -->

Author: mateuszlampert

.github/workflows/docs-build-check.yml

@@ -26,10 +26,10 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3
-      - name: Use Node.js 18
-        uses: actions/setup-node@v2
+      - name: Use Node.js 20
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
       - name: Install node dependencies
         working-directory: ${{ env.WORKING_DIRECTORY }}
         run: yarn install --immutable

docs/docusaurus.config.js

@@ -107,8 +107,20 @@ const config = {
         appId: '9PIVJVUUXB',
         apiKey: '8634751cfd500c6708f63ea5fc7446c6',
         indexName: 'swmansion',
+        askAi: {
+          appId: '9PIVJVUUXB',
+          apiKey: '8634751cfd500c6708f63ea5fc7446c6',
+          assistantId: 'MZHkLL8cFqAN',
+          indexName: 'swmansion-markdown-for-llms',
+        },
       },
     }),
+  customFields: {
+    algolia: {
+      suggestedQuestions: true,
+      enableSidePanel: true,
+    },
+  },
 };
 
 module.exports = config;

docs/package.json

@@ -15,20 +15,27 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docusaurus/core": "3.7.0",
-    "@docusaurus/plugin-sitemap": "3.7.0",
-    "@docusaurus/preset-classic": "3.7.0",
+    "@docsearch/core": "^4.4.0",
+    "@docsearch/css": "^4.4.0",
+    "@docsearch/sidepanel": "^4.4.0",
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/plugin-sitemap": "^3.9.2",
+    "@docusaurus/preset-classic": "^3.9.2",
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.1",
     "@mdx-js/react": "^3.0.0",
-    "@swmansion/t-rex-ui": "1.0.1",
+    "@mui/material": "^7.3.7",
+    "@swmansion/t-rex-ui": "^1.2.1",
     "clsx": "^2.1.0",
+    "copy-text-to-clipboard": "^3.2.2",
     "prism-react-renderer": "^2.1.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
     "swiper": "^11.2.10"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.7.0",
-    "@docusaurus/tsconfig": "3.7.0"
+    "@docusaurus/module-type-aliases": "^3.9.2",
+    "@docusaurus/tsconfig": "^3.9.2"
   },
   "browserslist": {
     "production": [
@@ -43,6 +50,6 @@
     ]
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }