From 9097fa16e7d24000b1b0408e8d19cdcc5919493f Mon Sep 17 00:00:00 2001
From: Vladimir Sheremet <sleuths.slews0s@icloud.com>
Date: Wed, 22 Oct 2025 19:09:24 +0200
Subject: [PATCH] docs: add "old documentation" banner

---
 docs/.vitepress/components.d.ts            |  1 +
 docs/.vitepress/components/OldDocument.vue | 42 ++++++++++++++++++++++
 docs/.vitepress/style/vars.css             | 28 ++++++++-------
 docs/.vitepress/theme/index.ts             |  2 ++
 4 files changed, 61 insertions(+), 12 deletions(-)
 create mode 100644 docs/.vitepress/components/OldDocument.vue

diff --git a/docs/.vitepress/components.d.ts b/docs/.vitepress/components.d.ts
index 4b95bae77..9cabe6b09 100644
--- a/docs/.vitepress/components.d.ts
+++ b/docs/.vitepress/components.d.ts
@@ -16,6 +16,7 @@ declare module 'vue' {
     HomePage: typeof import('./components/HomePage.vue')['default']
     ListItem: typeof import('./components/ListItem.vue')['default']
     NonProjectOption: typeof import('./components/NonProjectOption.vue')['default']
+    OldDocument: typeof import('./components/OldDocument.vue')['default']
     Version: typeof import('./components/Version.vue')['default']
   }
 }
diff --git a/docs/.vitepress/components/OldDocument.vue b/docs/.vitepress/components/OldDocument.vue
new file mode 100644
index 000000000..1b176c365
--- /dev/null
+++ b/docs/.vitepress/components/OldDocument.vue
@@ -0,0 +1,42 @@
+<template>
+  <div class="old-document">
+    <p>
+      This documentation covers Vitest v3 <strong>(old version)</strong>. For the
+      latest version, see
+      <a href="https://vitest.dev" class="new-document-link">https://vitest.dev</a>.
+    </p>
+  </div>
+</template>
+
+<style>
+:root {
+  --vp-layout-top-height: 96px;
+  @media (min-width: 455px) {
+    --vp-layout-top-height: 64px;
+  }
+  @media (min-width: 960px) {
+    --vp-layout-top-height: 32px;
+  }
+}
+
+.old-document {
+  position: fixed;
+  display: flex;
+  height: var(--vp-layout-top-height);
+  width: 100%;
+  padding: 4px 32px;
+  justify-content: center;
+  align-items: center;
+  color: var(--vp-c-old-document-text);
+  background: var(--vp-c-old-document-bg);
+  z-index: var(--vp-z-index-layout-top);
+
+  .new-document-link {
+    text-decoration: underline;
+    color: var(--vp-c-text-1);
+    &:hover {
+      color: var(--vp-c-text-2);
+    }
+  }
+}
+</style>
diff --git a/docs/.vitepress/style/vars.css b/docs/.vitepress/style/vars.css
index ae1cd10f0..29d8f433f 100644
--- a/docs/.vitepress/style/vars.css
+++ b/docs/.vitepress/style/vars.css
@@ -8,6 +8,10 @@
   --vp-c-brand-3: #506e10;
   --vp-c-sponsor: #ca2971;
   --vitest-c-sponsor-hover: #c13071;
+
+  /* Old Document */
+  --vp-c-old-document-bg: #f4f8e0;
+  --vp-c-old-document-text: #2a3a1b;
 }
 
 .dark {
@@ -16,6 +20,10 @@
   --vp-c-brand-3: #acd268;
   --vp-c-sponsor: #ee4e95;
   --vitest-c-sponsor-hover: #e51370;
+
+  /* Old Document */
+  --vp-c-old-document-bg: #2d3b2e;
+  --vp-c-old-document-text: #c5d9b6;
 }
 
 
@@ -47,18 +55,14 @@
  * Component: Home
  * -------------------------------------------------------------------------- */
 
- :root {
+:root {
   --vp-home-hero-name-color: transparent;
-  --vp-home-hero-name-background: -webkit-linear-gradient(
-    120deg,
-    #86b91a 30%,
-    #edd532
-  );
-  --vp-home-hero-image-background-image: linear-gradient(
-    -45deg,
-    #86b91a60 30%,
-    #edd53260
-  );
+  --vp-home-hero-name-background: -webkit-linear-gradient(120deg,
+      #86b91a 30%,
+      #edd532);
+  --vp-home-hero-image-background-image: linear-gradient(-45deg,
+      #86b91a60 30%,
+      #edd53260);
   --vp-home-hero-image-filter: blur(30px);
 }
 
@@ -97,4 +101,4 @@
 
 .vp-sponsor-grid.big .vp-sponsor-grid-image[alt='Zammad'] {
   max-height: 74px;
-}
+}
\ No newline at end of file
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
index c3e91f7db..dbe4bac13 100644
--- a/docs/.vitepress/theme/index.ts
+++ b/docs/.vitepress/theme/index.ts
@@ -11,6 +11,7 @@ import '../style/vars.css'
 import 'uno.css'
 import '@shikijs/vitepress-twoslash/style.css'
 import 'virtual:group-icons.css'
+import OldDocument from '../components/OldDocument.vue'
 
 if (inBrowser) {
   import('./pwa')
@@ -21,6 +22,7 @@ export default {
   Layout() {
     return h(DefaultTheme.Layout, null, {
       'home-features-after': () => h(HomePage),
+      'layout-top': () => h(OldDocument),
     })
   },
   enhanceApp({ app }) {
-- 
2.51.2