From 669823ca45b3c8c6d46d488a7e3a78b45d267abc Mon Sep 17 00:00:00 2001
From: Gregor Becker <gregor@codedredd.de>
Date: Mon, 20 Jul 2026 17:39:02 +0200
Subject: [PATCH 1/3] docs: add version switcher to the docs header

Adds a select to the header that lets readers switch between the 2.x
and 1.x documentation. Versions are configured via the 'versions' array
in app.config.ts.
---
 docs/app.config.ts                   |   5 +
 docs/components/AppHeader.vue        | 171 +++++++++++++++++++++++++++
 docs/components/AppVersionSelect.vue |  67 +++++++++++
 3 files changed, 243 insertions(+)
 create mode 100644 docs/components/AppHeader.vue
 create mode 100644 docs/components/AppVersionSelect.vue

diff --git a/docs/app.config.ts b/docs/app.config.ts
index 702517ad4..508847574 100644
--- a/docs/app.config.ts
+++ b/docs/app.config.ts
@@ -1,4 +1,9 @@
 export default defineAppConfig({
+  versions: [
+    // `current` marks the version this deployment serves.
+    { label: '2.x', href: 'https://pinia-orm.codedredd.de', current: true },
+    { label: '1.x', href: 'https://v1.pinia-orm.codedredd.de' },
+  ],
   docus: {
     title: 'Pinia ORM',
     description: 'The Pinia plugin to enable Object-Relational Mapping access to the Pinia Store.',
diff --git a/docs/components/AppHeader.vue b/docs/components/AppHeader.vue
new file mode 100644
index 000000000..adf224bf0
--- /dev/null
+++ b/docs/components/AppHeader.vue
@@ -0,0 +1,171 @@
+<script setup lang="ts">
+import { useMagicKeys } from '@vueuse/core'
+
+const { config } = useDocus()
+const { navigation } = useContent()
+const { y } = useWindowScroll()
+const route = useRoute()
+
+const showDocsSearch = ref(false)
+
+const hasDrawer = computed(() => navigation.value?.length > 1 || navigation.value?.[0]?.children?.length)
+
+const isBasicLayout = computed(() => route.meta.layout === 'basic')
+
+const { meta_K, Escape } = useMagicKeys()
+
+watch(meta_K, (v) => {
+  if (v) {
+    showDocsSearch.value = !showDocsSearch.value
+  }
+})
+
+watch(Escape, () => {
+  if (showDocsSearch.value)
+    showDocsSearch.value = false
+})
+</script>
+
+<template>
+  <header :class="{ 'has-drawer': hasDrawer, 'is-basic-layout': isBasicLayout, 'on-top': y === 0 }">
+    <Container>
+      <div class="header-layout">
+        <div class="section left">
+          <AppHeaderDrawer v-if="hasDrawer" />
+          <AppHeaderLogo />
+        </div>
+
+        <div class="section center">
+          <AppHeaderLogo />
+          <AppNavigation v-if="config.header.navigation" />
+          <DocsSearchButton
+            v-else
+            class="docs-search-button-desktop"
+            @click="showDocsSearch = true"
+          />
+          <DocsSearch v-model="showDocsSearch" />
+        </div>
+
+        <div class="section right">
+          <DocsSearchButton
+            class="docs-search-button-mobile"
+            @click="showDocsSearch = true"
+          />
+          <AppVersionSelect />
+          <AppColorMode />
+          <div class="social-icons">
+            <AppSocialIcons />
+          </div>
+        </div>
+      </div>
+    </Container>
+  </header>
+</template>
+
+<style scoped lang="ts">
+css({
+  ':deep(.icon)': {
+    width: '{docus.app.header.icon.size}',
+    height: '{docus.app.header.icon.size}'
+  },
+
+  '.header-logo': {
+    '.left &': {
+      '.has-drawer &': {
+        display: 'none',
+        '@lg': {
+          display: 'block'
+        }
+      },
+    },
+
+    '.center &': {
+      display: 'none',
+      '.has-drawer &': {
+        display: 'block',
+        '@lg': {
+          display: 'none'
+        },
+      },
+    }
+  },
+
+  header: {
+    backdropFilter: '{docus.app.header.backdropFilter}',
+    position: 'sticky',
+    top: 0,
+    zIndex: 10,
+    width: '100%',
+    borderBottomWidth: '{docus.app.header.borderBottomWidth}',
+    borderBottomStyle: '{docus.app.header.borderBottomStyle}',
+    borderBottomColor: '{docus.app.header.borderBottomColor}',
+    backgroundColor: '{docus.app.header.backgroundColor}',
+    height: '{docus.app.header.height}',
+
+    '&.is-basic-layout.on-top': {
+      background: 'transparent',
+      borderColor: 'transparent',
+      backdropFilter: 'none',
+    },
+
+    '.docs-search-button-desktop': {
+      display: 'none',
+      '@lg': {
+        display: 'flex'
+      }
+    },
+
+    '.docs-search-button-mobile': {
+      display: 'flex',
+      '@lg': {
+        display: 'none'
+      }
+    },
+
+    '.header-layout': {
+      display: 'grid',
+      height: '100%',
+      gridTemplateColumns: '{docus.app.header.layout.gridTemplateColumns}',
+      gap: '{docus.app.header.layout.gap}',
+    },
+
+    '.section': {
+      display: 'flex',
+      alignItems: 'center',
+      flex: 'none',
+
+      '&.left': {
+        gridColumn: '{docus.app.header.layout.left.gridColumn}',
+        '@lg': {
+          marginInlineStart: 0
+        },
+      },
+
+      '&.center': {
+        gridColumn: '{docus.app.header.layout.center.gridColumn}',
+        justifyContent: 'center',
+        flex: '1',
+        zIndex: '1'
+      },
+
+      '&.right': {
+        display: 'flex',
+        gridColumn: '{docus.app.header.layout.right.gridColumn}',
+        justifyContent: 'flex-end',
+        alignItems: 'center',
+        gap: '{space.2}',
+        flex: 'none',
+        marginInlineEnd: 'calc(0px - {space.4})',
+
+        '.social-icons': {
+          display: 'none',
+          '@md': {
+            display: 'flex',
+            alignItems: 'center',
+          }
+        }
+      }
+    }
+  }
+})
+</style>
diff --git a/docs/components/AppVersionSelect.vue b/docs/components/AppVersionSelect.vue
new file mode 100644
index 000000000..9e3efe8dc
--- /dev/null
+++ b/docs/components/AppVersionSelect.vue
@@ -0,0 +1,67 @@
+<script setup lang="ts">
+interface DocsVersion {
+  label: string
+  href: string
+  current?: boolean
+}
+
+const appConfig = useAppConfig() as { versions?: DocsVersion[] }
+
+const versions = computed<DocsVersion[]>(() => appConfig.versions ?? [])
+
+const current = computed(() => versions.value.find(version => version.current) ?? versions.value[0])
+
+function onChange (event: Event) {
+  const href = (event.target as HTMLSelectElement).value
+
+  if (!href || href === current.value?.href) { return }
+
+  window.location.href = href
+}
+</script>
+
+<template>
+  <label v-if="versions.length > 1" class="version-select">
+    <span class="sr-only">Switch documentation version</span>
+    <select :value="current?.href" @change="onChange">
+      <option v-for="version in versions" :key="version.label" :value="version.href">
+        {{ version.label }}
+      </option>
+    </select>
+  </label>
+</template>
+
+<style scoped>
+.version-select select {
+  appearance: none;
+  background-color: transparent;
+  border: 1px solid rgb(115 115 115 / 0.35);
+  border-radius: 0.375rem;
+  color: inherit;
+  cursor: pointer;
+  font-size: 0.875rem;
+  font-weight: 500;
+  line-height: 1;
+  padding: 0.375rem 1.5rem 0.375rem 0.625rem;
+  background-image: url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24' stroke='%23737373' stroke-width='2'%3E%3Cpath stroke-linecap='round' stroke-linejoin='round' d='m6 9 6 6 6-6'/%3E%3C/svg%3E");
+  background-position: right 0.375rem center;
+  background-repeat: no-repeat;
+  background-size: 0.875rem;
+}
+
+.version-select select:hover {
+  border-color: rgb(115 115 115 / 0.7);
+}
+
+.version-select .sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border-width: 0;
+}
+</style>

From 157dec5db7c8b379cfb6adee78f3cf195884a9e9 Mon Sep 17 00:00:00 2001
From: Gregor Becker <gregor@codedredd.de>
Date: Mon, 20 Jul 2026 18:02:54 +0200
Subject: [PATCH 2/3] chore: retrigger vercel preview


From 74428b376519d5bd442234455e4a6cce607ea72b Mon Sep 17 00:00:00 2001
From: Gregor Becker <gregor@codedredd.de>
Date: Mon, 20 Jul 2026 18:03:49 +0200
Subject: [PATCH 3/3] docs: clarify version select config comment

---
 docs/app.config.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/app.config.ts b/docs/app.config.ts
index 508847574..9bea0e20c 100644
--- a/docs/app.config.ts
+++ b/docs/app.config.ts
@@ -1,6 +1,6 @@
 export default defineAppConfig({
   versions: [
-    // `current` marks the version this deployment serves.
+    // `current` marks the version served by this deployment.
     { label: '2.x', href: 'https://pinia-orm.codedredd.de', current: true },
     { label: '1.x', href: 'https://v1.pinia-orm.codedredd.de' },
   ],