From 2d47f3ae0f662cea13b458fa986be813d4cdfbe6 Mon Sep 17 00:00:00 2001
From: danbaruka <46156791+danbaruka@users.noreply.github.com>
Date: Fri, 16 Oct 2026 22:01:44 +0300
Subject: [PATCH 1/4] fix(website): remove the docs feedback widget

The form always reported success, including when no script URL was configured, and it posted visitor text to a public Apps Script.
---
 .../src/components/FeedbackWidget/index.tsx   | 121 ------------
 website/src/css/custom.css                    | 175 ------------------
 website/src/theme/DocItem/Footer/index.tsx    |  16 --
 3 files changed, 312 deletions(-)
 delete mode 100644 website/src/components/FeedbackWidget/index.tsx
 delete mode 100644 website/src/theme/DocItem/Footer/index.tsx

diff --git a/website/src/components/FeedbackWidget/index.tsx b/website/src/components/FeedbackWidget/index.tsx
deleted file mode 100644
index 184dc25e..00000000
--- a/website/src/components/FeedbackWidget/index.tsx
+++ /dev/null
@@ -1,121 +0,0 @@
-import React, { useState } from 'react';
-import clsx from 'clsx';
-import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
-
-export default function FeedbackWidget() {
-  const { siteConfig } = useDocusaurusContext();
-  const GOOGLE_SCRIPT_URL = siteConfig.customFields?.googleScriptUrl as string;
-  
-  const [vote, setVote] = useState<null | 'yes' | 'no'>(null);
-  const [comment, setComment] = useState('');
-  const [submitted, setSubmitted] = useState(false);
-  const [submitting, setSubmitting] = useState(false);
-
-  const handleVote = (value: 'yes' | 'no') => {
-    setVote(value);
-    if (value === 'yes') {
-       submitFeedback(value, '');
-    }
-  };
-
-  const submitFeedback = async (voteValue: string, commentValue: string) => {
-    setSubmitting(true);
-    try {
-      const data = {
-        url: window.location.href, 
-        vote: voteValue,
-        comment: commentValue,
-        userAgent: navigator.userAgent,
-      };
-
-      await fetch(GOOGLE_SCRIPT_URL, {
-        method: 'POST',
-        mode: 'no-cors',
-        headers: {
-          'Content-Type': 'text/plain;charset=utf-8',
-        },
-        body: JSON.stringify(data),
-      });
-
-      setSubmitted(true);
-    } catch (error) {
-      setSubmitted(true);
-    } finally {
-      setSubmitting(false);
-    }
-  };
-
-  const handleCommentSubmit = (e: React.FormEvent) => {
-    e.preventDefault();
-    if (vote) {
-      submitFeedback(vote, comment);
-    }
-  };
-
-  if (submitted) {
-    return (
-      <div className="feedback-container">
-        <div className="feedback-widget">
-          <p className="thank-you">Thanks for your feedback! 🙏🏽</p>
-        </div>
-      </div>
-    );
-  }
-
-  return (
-    <div className="feedback-container">
-      <div className="feedback-widget">
-        {!vote ? (
-          <div className="initial-state">
-            <span className="question">Was this helpful?</span>
-            <div className="buttons">
-              <button
-                className={clsx("button", "thumbs-up")}
-                onClick={() => handleVote('yes')}
-                aria-label="Yes"
-              >
-                👍 Yes
-              </button>
-              <button
-                className={clsx("button", "thumbs-down")}
-                onClick={() => setVote('no')}
-                aria-label="No"
-              >
-                👎 No
-              </button>
-            </div>
-          </div>
-        ) : (
-          <form className="comment-form" onSubmit={handleCommentSubmit}>
-            <p className="follow-up">
-              {vote === 'yes' ? 'What was most helpful?' : 'How can we improve this page?'}
-            </p>
-            <textarea
-              className="textarea"
-              value={comment}
-              onChange={(e) => setComment(e.target.value)}
-              placeholder={vote === 'yes' ? "Optional comments..." : "Please tell us what's missing or unclear..."}
-              rows={3}
-            />
-            <div className="form-actions">
-              <button
-                type="button"
-                className="cancel-button"
-                onClick={() => setVote(null)}
-              >
-                Cancel
-              </button>
-              <button
-                type="submit"
-                className="submit-button"
-                disabled={submitting}
-              >
-                {submitting ? 'Sending...' : 'Send Feedback'}
-              </button>
-            </div>
-          </form>
-        )}
-      </div>
-    </div>
-  );
-}
diff --git a/website/src/css/custom.css b/website/src/css/custom.css
index 3315650c..bc4d062e 100644
--- a/website/src/css/custom.css
+++ b/website/src/css/custom.css
@@ -880,181 +880,6 @@ html[data-theme='dark'] .searchBar .dropdownMenu svg {
 }
 
 
-/* ------------------------------ */
-/* Feedback Widget Styles         */
-/* ------------------------------ */
-
-.feedback-container {
-  margin-top: 3rem;
-  border-top: 1px solid var(--ifm-color-emphasis-200);
-  padding-top: 2rem;
-  display: flex;
-  justify-content: center;
-}
-
-.feedback-widget {
-  background-color: var(--ifm-background-surface-color);
-  /* Match .card border and radius */
-  border: 1px solid rgba(37, 85, 254, 0.1);
-  border-radius: 12px;
-  padding: 1.5rem 2rem;
-  min-width: 300px;
-  max-width: 500px;
-  text-align: center;
-  transition: all 0.2s ease;
-  /* Subtle shadow like .navbar or .card */
-  box-shadow: 0 2px 8px rgba(37, 85, 254, 0.05);
-}
-
-.feedback-widget:hover {
-  /* Subtle lift on hover like .card */
-  border-color: var(--ifm-color-primary);
-  box-shadow: 0 4px 20px rgba(37, 85, 254, 0.1);
-  transform: translateY(-2px);
-}
-
-.feedback-widget .initial-state {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 1.5rem;
-}
-
-.feedback-widget .question {
-  font-weight: 600;
-  font-size: 1.1em;
-  color: var(--ifm-font-color-base);
-}
-
-.feedback-widget .buttons {
-  display: flex;
-  gap: 0.75rem;
-}
-
-/* Thumbs Buttons - mimic .button--outline but with state colors */
-.feedback-widget .button {
-  cursor: pointer;
-  background: transparent;
-  border: 2px solid var(--ifm-color-emphasis-300);
-  /* Neutral start */
-  padding: 0.5rem 1.2rem;
-  border-radius: 50px;
-  /* Match site pill buttons */
-  font-weight: 600;
-  transition: all 0.2s ease;
-  font-size: 0.95rem;
-  color: var(--ifm-font-color-base);
-}
-
-.feedback-widget .button:hover {
-  transform: translateY(-1px);
-}
-
-.feedback-widget .thumbs-up:hover {
-  border-color: var(--ifm-color-success);
-  color: var(--ifm-color-success);
-  box-shadow: 0 4px 12px rgba(0, 164, 0, 0.1);
-}
-
-.feedback-widget .thumbs-down:hover {
-  border-color: var(--ifm-color-danger);
-  color: var(--ifm-color-danger);
-  box-shadow: 0 4px 12px rgba(255, 0, 0, 0.1);
-}
-
-.feedback-widget .thank-you {
-  color: var(--ifm-color-success);
-  font-weight: 700;
-  font-size: 1.1em;
-  margin: 0;
-}
-
-.feedback-widget .comment-form {
-  display: flex;
-  flex-direction: column;
-  gap: 1rem;
-  text-align: left;
-}
-
-.feedback-widget .follow-up {
-  margin: 0;
-  font-weight: 600;
-  font-size: 0.95em;
-  color: var(--ifm-font-color-base);
-}
-
-.feedback-widget .textarea {
-  width: 100%;
-  padding: 0.75rem;
-  border-radius: 8px;
-  /* Slightly softer */
-  border: 1px solid var(--ifm-color-emphasis-300);
-  background: var(--ifm-background-color);
-  color: var(--ifm-font-color-base);
-  resize: vertical;
-  font-family: inherit;
-  font-size: 0.9em;
-  transition: border-color 0.2s;
-}
-
-.feedback-widget .textarea:focus {
-  outline: none;
-  border-color: var(--ifm-color-primary);
-  box-shadow: 0 0 0 2px var(--ifm-color-primary-lightest);
-}
-
-.feedback-widget .form-actions {
-  display: flex;
-  justify-content: flex-end;
-  gap: 0.75rem;
-  align-items: center;
-}
-
-/* Submit Button - Match .button--primary */
-.feedback-widget .submit-button {
-  background: var(--ifm-color-primary);
-  border: 2px solid var(--ifm-color-primary);
-  color: #fff;
-  padding: 0.6rem 1.5rem;
-  border-radius: 50px;
-  /* Pill shape */
-  cursor: pointer;
-  font-weight: 600;
-  font-size: 0.9em;
-  transition: all 0.2s ease;
-}
-
-.feedback-widget .submit-button:hover {
-  background: var(--ifm-color-primary-dark);
-  border-color: var(--ifm-color-primary-dark);
-  transform: translateY(-1px);
-  box-shadow: 0 4px 12px rgba(37, 85, 254, 0.3);
-}
-
-.feedback-widget .submit-button:disabled {
-  opacity: 0.6;
-  cursor: not-allowed;
-  transform: none;
-  box-shadow: none;
-}
-
-/* Cancel Button - Match simple text link or .button--secondary */
-.feedback-widget .cancel-button {
-  background: transparent;
-  border: none;
-  color: var(--ifm-font-color-secondary);
-  cursor: pointer;
-  font-size: 0.9em;
-  font-weight: 500;
-  padding: 0.5rem 1rem;
-  transition: color 0.2s;
-}
-
-.feedback-widget .cancel-button:hover {
-  color: var(--ifm-color-primary);
-  text-decoration: none;
-}
-
 [data-theme='dark'] .DocSearch-Input,
 [data-theme='dark'] .DocSearch-Input * {
   color: #ffffff !important;
diff --git a/website/src/theme/DocItem/Footer/index.tsx b/website/src/theme/DocItem/Footer/index.tsx
deleted file mode 100644
index a974c7df..00000000
--- a/website/src/theme/DocItem/Footer/index.tsx
+++ /dev/null
@@ -1,16 +0,0 @@
-import React, {type ReactNode} from 'react';
-import Footer from '@theme-original/DocItem/Footer';
-import type FooterType from '@theme/DocItem/Footer';
-import type {WrapperProps} from '@docusaurus/types';
-import FeedbackWidget from '@site/src/components/FeedbackWidget';
-
-type Props = WrapperProps<typeof FooterType>;
-
-export default function FooterWrapper(props: Props): ReactNode {
-  return (
-    <>
-      <FeedbackWidget />
-      <Footer {...props} />
-    </>
-  );
-}

From 1050df3b466d0742f2ff3ff46d86f53fd0f9cbf6 Mon Sep 17 00:00:00 2001
From: danbaruka <46156791+danbaruka@users.noreply.github.com>
Date: Fri, 16 Oct 2026 22:02:10 +0300
Subject: [PATCH 2/4] chore: drop the Google Apps Script feedback channel

Stop passing GOOGLE_SCRIPT_URL into the site build and delete the script that appended visitor text to the Sheet.
---
 .github/workflows/deploy.yml  |  1 -
 website/docusaurus.config.ts  |  4 ---
 website/google-apps-script.js | 68 -----------------------------------
 3 files changed, 73 deletions(-)
 delete mode 100644 website/google-apps-script.js

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 84c3daf8..3a173733 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -48,7 +48,6 @@ jobs:
       - name: Build website
         run: npm run build
         env:
-          GOOGLE_SCRIPT_URL: ${{ secrets.GOOGLE_SCRIPT_URL }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Upload Build Artifact
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
index 1187a8f9..207833d9 100644
--- a/website/docusaurus.config.ts
+++ b/website/docusaurus.config.ts
@@ -292,10 +292,6 @@ const config: Config = {
       darkTheme: prismThemes.dracula,
     },
   } satisfies Preset.ThemeConfig,
-
-  customFields: {
-    googleScriptUrl: process.env.GOOGLE_SCRIPT_URL,
-  },
 };
 
 export default config;
diff --git a/website/google-apps-script.js b/website/google-apps-script.js
deleted file mode 100644
index 8eac394c..00000000
--- a/website/google-apps-script.js
+++ /dev/null
@@ -1,68 +0,0 @@
-/**
- * DO NOT DELETE THIS FILE
- * Google Apps Script to handle feedback submissions.
- * 
- * INSTRUCTIONS:
- * 1. Open your Google Sheet.
- * 2. Go to Extensions > Apps Script.
- * 3. Paste this code into the editor.
- * 4. Save the project.
- * 5. Click "Deploy" > "New deployment".
- * 6. Select type: "Web app".
- * 7. Description: "Feedback Widget API".
- * 8. Execute as: "Me" (your email).
- * 9. Who has access: "Anyone" (IMPORTANT).
- * 10. Click "Deploy" and copy the "Web app URL".
- */
-
-
-function doPost(e) {
-    const lock = LockService.getScriptLock();
-    lock.tryLock(10000);
-
-    try {
-        const doc = SpreadsheetApp.getActiveSpreadsheet();
-        const sheet = doc.getSheetByName('Feedback') || doc.insertSheet('Feedback');
-
-        // Add headers if they don't exist
-        if (sheet.getLastRow() === 0) {
-            sheet.appendRow(['Timestamp', 'Page URL', 'Vote', 'Comment', 'User Agent']);
-        }
-
-        const headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
-        const nextRow = sheet.getLastRow() + 1;
-
-        // Parse the request body
-        const data = JSON.parse(e.postData.contents);
-
-        const newRow = [
-            new Date(),
-            data.url || 'Unknown',
-            data.vote || 'Unknown',
-            data.comment || '',
-            data.userAgent || ''
-        ];
-
-        sheet.appendRow(newRow);
-
-        return ContentService
-            .createTextOutput(JSON.stringify({ 'result': 'success', 'row': nextRow }))
-            .setMimeType(ContentService.MimeType.JSON);
-
-    } catch (e) {
-        return ContentService
-            .createTextOutput(JSON.stringify({ 'result': 'error', 'error': e }))
-            .setMimeType(ContentService.MimeType.JSON);
-    } finally {
-        lock.releaseLock();
-    }
-}
-
-// Handle CORS preflight requests
-function doOptions(e) {
-    return ContentService.createTextOutput("")
-        .setMimeType(ContentService.MimeType.JSON)
-        .appendHeader("Access-Control-Allow-Origin", "*")
-        .appendHeader("Access-Control-Allow-Methods", "POST")
-        .appendHeader("Access-Control-Allow-Headers", "Content-Type");
-}

From d8b3acb362b29c238dd98d4e7918c7f1c9f9c8d9 Mon Sep 17 00:00:00 2001
From: IanoNjuguna <inc3099@gmail.com>
Date: Sun, 18 Oct 2026 09:36:58 +0300
Subject: [PATCH 3/4] fix(website): regenerate the lockfile so npm ci matches
 package.json

The dependabot merges for dotenv (#317) and mermaid (#318) bumped
package.json without regenerating package-lock.json, so every npm ci run
fails with EUSAGE before the build starts: the lock still pins dotenv
17.3.1 and mermaid 11.17.2. The PR build gate and the Pages deploy have
both been red on main since 2026-10-16.

Regenerated with npm install against the current package.json, which
resolves dotenv 18.0.8, mermaid 12.2.0 and @mermaid-js/parser 2.0.1.
---
 website/package-lock.json | 116 +++++++++++++++++++++++++++-----------
 1 file changed, 82 insertions(+), 34 deletions(-)

diff --git a/website/package-lock.json b/website/package-lock.json
index 3bea6084..d5130f67 100644
--- a/website/package-lock.json
+++ b/website/package-lock.json
@@ -17,7 +17,7 @@
         "@mdx-js/react": "^3.0.0",
         "clsx": "^2.0.0",
         "image-size": "file:vendor/image-size",
-        "mermaid": "^11.16.1",
+        "mermaid": "^12.1.0",
         "prism-react-renderer": "^2.3.0",
         "react": "^18.3.1",
         "react-dom": "^18.3.1"
@@ -27,7 +27,7 @@
         "@docusaurus/tsconfig": "^3.10.2",
         "@docusaurus/types": "^3.10.2",
         "@types/node": "^25.5.2",
-        "dotenv": "^17.3.1",
+        "dotenv": "^18.0.7",
         "patch-package": "^8.0.0",
         "ts-node": "^10.9.2",
         "typescript": "~6.0.2"
@@ -2021,10 +2021,41 @@
       "integrity": "sha512-jigsZK+sMF/cuiB7sERuo9V7N9jx+dhmHHnQyDSVdpZwVutaBu7WvNYqMDLSgFgfB30n452TP3vjDAvFC973mA==",
       "license": "MIT"
     },
+    "node_modules/@chevrotain/cst-dts-gen": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/@chevrotain/cst-dts-gen/-/cst-dts-gen-13.2.0.tgz",
+      "integrity": "sha512-bA9dvWlhAUcHkNwU+8w9yiUxJPlj/Lm3VqS7MD+NbIR/7LmpNLuK/AWNFdCo/T3SK5ND0/UHf3IJvl/Jn/i6yg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@chevrotain/gast": "13.2.0",
+        "@chevrotain/types": "13.2.0"
+      }
+    },
+    "node_modules/@chevrotain/gast": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/@chevrotain/gast/-/gast-13.2.0.tgz",
+      "integrity": "sha512-bCARdAsG+eEbOveSXcOAC7pVxA04I1ionzeMOwIYf5NX7SaS7zgn4Dgug2BSqoL+iyKeMNSorQjsFSHJHsCNwg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@chevrotain/types": "13.2.0"
+      }
+    },
+    "node_modules/@chevrotain/regexp-to-ast": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/@chevrotain/regexp-to-ast/-/regexp-to-ast-13.2.0.tgz",
+      "integrity": "sha512-kxpUkLtiaK09ph+dib+Yvm+3sWSnuwlo25gqfKRgTPNmF6H7uW4gVkMjaRdtnN783S9sM6vUNWh9CsxYX4QwKw==",
+      "license": "Apache-2.0"
+    },
     "node_modules/@chevrotain/types": {
-      "version": "11.1.2",
-      "resolved": "https://registry.npmjs.org/@chevrotain/types/-/types-11.1.2.tgz",
-      "integrity": "sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw==",
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/@chevrotain/types/-/types-13.2.0.tgz",
+      "integrity": "sha512-7qrYHRlKfWf2AvBfJi5eVOrKAkbxvMFsy/iIHTGIiApNcEecCaVIdR+mIQhyCBsTDJxBz4JWXHMo6krbhR9hVg==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/@chevrotain/utils": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/@chevrotain/utils/-/utils-13.2.0.tgz",
+      "integrity": "sha512-SzKYY68rseOrb9KILVzPsl6SjkQtdWw01SRGB5aCVI5kFcHltQsOYV3JB0Ffst72DgkvHCyDQ0NLwxtmCCf97Q==",
       "license": "Apache-2.0"
     },
     "node_modules/@colors/colors": {
@@ -4964,12 +4995,15 @@
       }
     },
     "node_modules/@mermaid-js/parser": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-1.2.1.tgz",
-      "integrity": "sha512-n12NohV3mrUyUL2o93IgG/ifeW9FTyeJn3zDxkhwa8MJ9Fxg3HQMlA3RiGmD/3UnJvheztkjjQAjA2T4LmUcpw==",
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-2.0.1.tgz",
+      "integrity": "sha512-j37dj/h6p6pots1L7pLPPNuABEEu9WP4OYg9pW1g+nYG331j0+3canE9OagtYdytYvdSAMG+2fKU5cxep6LgjA==",
       "license": "MIT",
       "dependencies": {
-        "@chevrotain/types": "~11.1.2"
+        "@chevrotain/types": "~13.2.0"
+      },
+      "engines": {
+        "node": ">=22.12.0"
       }
     },
     "node_modules/@napi-rs/wasm-runtime": {
@@ -7585,6 +7619,22 @@
         "url": "https://github.com/sponsors/fb55"
       }
     },
+    "node_modules/chevrotain": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/chevrotain/-/chevrotain-13.2.0.tgz",
+      "integrity": "sha512-GTouk5YzgBxlTPCaDn5q0q2EJKkrYmnPF+HmF8v0Qo4r3iyPG7HJivkN1wthCXZcm3sIcZFpGTRovLPNdJNRCA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@chevrotain/cst-dts-gen": "13.2.0",
+        "@chevrotain/gast": "13.2.0",
+        "@chevrotain/regexp-to-ast": "13.2.0",
+        "@chevrotain/types": "13.2.0",
+        "@chevrotain/utils": "13.2.0"
+      },
+      "engines": {
+        "node": ">=22.0.0"
+      }
+    },
     "node_modules/chokidar": {
       "version": "3.6.0",
       "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz",
@@ -9452,11 +9502,14 @@
       }
     },
     "node_modules/dotenv": {
-      "version": "17.3.1",
-      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.3.1.tgz",
-      "integrity": "sha512-IO8C/dzEb6O3F9/twg6ZLXz164a2fhTnEWb95H23Dm4OuN+92NmEAlTrupP9VW6Jm3sO26tQlqyvyi4CsnY9GA==",
+      "version": "18.0.8",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-18.0.8.tgz",
+      "integrity": "sha512-2KDeoFoK/zRtcnbunCDlLG5VWVMcyqeQc6iK65o231nfNAcuGrKoqUQfJFUtBI+QlShk5HKIHxwebBtUl3rEfA==",
       "dev": true,
       "license": "BSD-2-Clause",
+      "bin": {
+        "dotenv": "dist/index.cjs"
+      },
       "engines": {
         "node": ">=12"
       },
@@ -9502,6 +9555,12 @@
       "integrity": "sha512-lEcqhErbHjXRvd41rnWLpzbyU/IXfIYo7QwaFWmxGeLiLyY2TBCdHnWY88vB+p3ubnihRypDm66panXl7TylLA==",
       "license": "ISC"
     },
+    "node_modules/elkjs": {
+      "version": "0.9.3",
+      "resolved": "https://registry.npmjs.org/elkjs/-/elkjs-0.9.3.tgz",
+      "integrity": "sha512-f/ZeWvW/BCXbhGEf1Ujp29EASo/lk1FDnETgNKwJrsVvGZhUWCZyg3xLJjAsxfOmt8KjswHmI5EwCQcPMpOYhQ==",
+      "license": "EPL-2.0"
+    },
     "node_modules/emoji-regex": {
       "version": "9.2.2",
       "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
@@ -10076,15 +10135,6 @@
       ],
       "license": "BSD-3-Clause"
     },
-    "node_modules/fastdom": {
-      "version": "1.0.12",
-      "resolved": "https://registry.npmjs.org/fastdom/-/fastdom-1.0.12.tgz",
-      "integrity": "sha512-LB+xjSTEbjHE1cWsxu+tN2Xqr1kpi+V9aADI7sVM5ZMaXyYGPHULQMzpJMYqOTULK/73pUkWVzzObFRBkPr+hg==",
-      "license": "MIT",
-      "dependencies": {
-        "strictdom": "^1.0.1"
-      }
-    },
     "node_modules/fastq": {
       "version": "1.20.1",
       "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz",
@@ -12580,16 +12630,17 @@
       }
     },
     "node_modules/mermaid": {
-      "version": "11.17.2",
-      "resolved": "https://registry.npmjs.org/mermaid/-/mermaid-11.17.2.tgz",
-      "integrity": "sha512-V6K3C8EBdEsPFZXSKMJe6ppQOENxuHARr9GvHX4hh47lAbhMRD9qf4oEK7LoaRQxULMa80/qt5gHO73aCleBBg==",
+      "version": "12.2.0",
+      "resolved": "https://registry.npmjs.org/mermaid/-/mermaid-12.2.0.tgz",
+      "integrity": "sha512-w7nr/SFrLO7BaVTs3dQTvYSV6nYSBj0Yy9DjBhsIJtAcHqRzXSq4Pg32ujHZ/AdWsAMNEvvhbm5dt9E2tOiHzw==",
       "license": "MIT",
       "dependencies": {
         "@braintree/sanitize-url": "^7.1.2",
         "@iconify/utils": "^3.0.2",
-        "@mermaid-js/parser": "^1.2.1",
+        "@mermaid-js/parser": "^2.0.1",
         "@types/d3": "^7.4.3",
         "@upsetjs/venn.js": "^2.0.0",
+        "chevrotain": "~13.2.0",
         "cytoscape": "^3.34.0",
         "cytoscape-cose-bilkent": "^4.1.0",
         "cytoscape-fcose": "^2.2.0",
@@ -12597,16 +12648,19 @@
         "d3-sankey": "^0.12.3",
         "dagre-d3-es": "7.0.14",
         "dayjs": "^1.11.21",
-        "dompurify": "^3.3.3",
+        "dompurify": "^3.4.12",
+        "elkjs": "^0.9.3",
         "es-toolkit": "^1.45.1",
-        "fastdom": "1.0.12",
-        "katex": "^0.16.47",
+        "katex": "^0.18.0",
         "khroma": "^2.1.0",
         "marked": "^16.3.0",
         "roughjs": "^4.6.6",
         "stylis": "^4.3.6",
         "ts-dedent": "^2.2.0",
         "uuid": "^11.1.0 || ^12 || ^13 || ^14.0.0"
+      },
+      "engines": {
+        "node": ">=22.12.0"
       }
     },
     "node_modules/methods": {
@@ -18343,12 +18397,6 @@
       "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==",
       "license": "MIT"
     },
-    "node_modules/strictdom": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/strictdom/-/strictdom-1.0.1.tgz",
-      "integrity": "sha512-cEmp9QeXXRmjj/rVp9oyiqcvyocWab/HaoN4+bwFeZ7QzykJD6L3yD4v12K1x0tHpqRqVpJevN3gW7kyM39Bqg==",
-      "license": "MIT"
-    },
     "node_modules/string_decoder": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",

From cc59562d5c911642b0281bc631f7e9e5fbba3e8b Mon Sep 17 00:00:00 2001
From: IanoNjuguna <inc3099@gmail.com>
Date: Sun, 18 Oct 2026 09:36:58 +0300
Subject: [PATCH 4/4] ci: build the website on Node 22

mermaid 12 declares engines node >=22.12.0, but both workflows pinned
Node 20, so npm ci installs it with EBADENGINE warnings and the build
runs on a runtime the library does not support. Bump the PR gate and the
Pages deploy to Node 22 and raise the package engines floor to match.

Docusaurus itself is unaffected (engines >=20.0).
---
 .github/workflows/deploy.yml           | 2 +-
 .github/workflows/pr-build-website.yml | 2 +-
 website/package.json                   | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 3a173733..16b36d85 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -40,7 +40,7 @@ jobs:
       - uses: actions/setup-node@v6
         with:
           cache-dependency-path: ./website/package-lock.json
-          node-version: 20
+          node-version: 22
           cache: npm
 
       - name: Install dependencies
diff --git a/.github/workflows/pr-build-website.yml b/.github/workflows/pr-build-website.yml
index 071965db..23601176 100644
--- a/.github/workflows/pr-build-website.yml
+++ b/.github/workflows/pr-build-website.yml
@@ -33,7 +33,7 @@ jobs:
       - uses: actions/setup-node@v6
         with:
           cache-dependency-path: ./website/package-lock.json
-          node-version: 20
+          node-version: 22
           cache: npm
 
       - name: Install dependencies
diff --git a/website/package.json b/website/package.json
index 5840cd21..592bb558 100644
--- a/website/package.json
+++ b/website/package.json
@@ -58,7 +58,7 @@
     ]
   },
   "engines": {
-    "node": ">=20.0"
+    "node": ">=22.12.0"
   },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
   "resolutions": {