From 310679a76c43b429dbe8b7127dc7e6bb3ec50569 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Wed, 19 Aug 2026 02:16:00 +0530
Subject: [PATCH 01/18] fix(theme): prevent layout shifts when locking page
 scroll

fixes #5386
---
 .../components/VPLocalNavOutlineDropdown.vue  |   7 +-
 .../components/VPLocalSearchBox.vue           |   6 +-
 .../theme-default/components/VPNavScreen.vue  |   6 +-
 .../theme-default/components/VPSidebar.vue    |   5 +-
 .../theme-default/composables/scroll-lock.ts  | 141 ++++++++++++++++++
 5 files changed, 153 insertions(+), 12 deletions(-)
 create mode 100644 src/client/theme-default/composables/scroll-lock.ts

diff --git a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
index 307a22bd..8a5eaa21 100644
--- a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
+++ b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
@@ -1,10 +1,11 @@
 <script setup lang="ts">
-import { onKeyStroke, useScrollLock } from '@vueuse/core'
-import { inBrowser, onContentUpdated } from 'vitepress'
+import { onKeyStroke } from '@vueuse/core'
+import { onContentUpdated } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { nextTick, ref, watch } from 'vue'
 import { useData } from '../composables/data'
 import { resolveTitle } from '../composables/outline'
+import { useBodyScrollLock } from '../composables/scroll-lock'
 import VPDocOutlineItem from './VPDocOutlineItem.vue'
 
 const props = defineProps<{
@@ -19,7 +20,7 @@ const main = ref<HTMLDivElement>()
 const items = ref<HTMLDivElement>()
 
 // lock body scroll while the dropdown is open to prevent scroll chaining
-const isLocked = useScrollLock(inBrowser ? document.body : null)
+const isLocked = useBodyScrollLock()
 
 function closeOnClickOutside(e: Event) {
   if (!main.value?.contains(e.target as Node)) {
diff --git a/src/client/theme-default/components/VPLocalSearchBox.vue b/src/client/theme-default/components/VPLocalSearchBox.vue
index 2efbe158..8bde5384 100644
--- a/src/client/theme-default/components/VPLocalSearchBox.vue
+++ b/src/client/theme-default/components/VPLocalSearchBox.vue
@@ -6,13 +6,12 @@ import {
   onKeyStroke,
   useEventListener,
   useLocalStorage,
-  useScrollLock,
   useSessionStorage
 } from '@vueuse/core'
 import { useFocusTrap } from '@vueuse/integrations/useFocusTrap'
 import Mark from 'mark.js/src/vanilla.js'
 import MiniSearch, { type SearchResult } from 'minisearch'
-import { dataSymbol, inBrowser, useRouter } from 'vitepress'
+import { dataSymbol, useRouter } from 'vitepress'
 import {
   computed,
   createApp,
@@ -30,6 +29,7 @@ import type { LocalSearchTranslations } from '../../../../types/local-search'
 import { pathToFile } from '../../app/utils'
 import { escapeRegExp } from '../../shared'
 import { useData } from '../composables/data'
+import { useBodyScrollLock } from '../composables/scroll-lock'
 import { LRUCache } from '../support/lru'
 import { createSearchTranslate } from '../support/translation'
 
@@ -409,7 +409,7 @@ useEventListener('popstate', (event) => {
 
 /** Lock body */
 
-const isLocked = useScrollLock(inBrowser ? document.body : null)
+const isLocked = useBodyScrollLock()
 
 onMounted(() => {
   nextTick(() => {
diff --git a/src/client/theme-default/components/VPNavScreen.vue b/src/client/theme-default/components/VPNavScreen.vue
index 44d280a2..0b114dfe 100644
--- a/src/client/theme-default/components/VPNavScreen.vue
+++ b/src/client/theme-default/components/VPNavScreen.vue
@@ -1,6 +1,5 @@
 <script setup lang="ts">
-import { useScrollLock } from '@vueuse/core'
-import { inBrowser } from 'vitepress'
+import { useBodyScrollLock } from '../composables/scroll-lock'
 import VPNavScreenAppearance from './VPNavScreenAppearance.vue'
 import VPNavScreenMenu from './VPNavScreenMenu.vue'
 import VPNavScreenSocialLinks from './VPNavScreenSocialLinks.vue'
@@ -10,7 +9,7 @@ defineProps<{
   open: boolean
 }>()
 
-const isLocked = useScrollLock(inBrowser ? document.body : null)
+const isLocked = useBodyScrollLock()
 </script>
 
 <template>
@@ -45,6 +44,7 @@ const isLocked = useScrollLock(inBrowser ? document.body : null)
   width: 100%;
   background-color: var(--vp-nav-screen-bg-color);
   overflow-y: auto;
+  overscroll-behavior: contain;
   transition: background-color 0.25s;
   pointer-events: auto;
 }
diff --git a/src/client/theme-default/components/VPSidebar.vue b/src/client/theme-default/components/VPSidebar.vue
index 9dbb802e..b3105f8c 100644
--- a/src/client/theme-default/components/VPSidebar.vue
+++ b/src/client/theme-default/components/VPSidebar.vue
@@ -1,8 +1,7 @@
 <script lang="ts" setup>
-import { useScrollLock } from '@vueuse/core'
-import { inBrowser } from 'vitepress'
 import { ref, watch } from 'vue'
 import { useLayout } from '../composables/layout'
+import { useBodyScrollLock } from '../composables/scroll-lock'
 import VPSidebarGroup from './VPSidebarGroup.vue'
 
 const { sidebarGroups, hasSidebar } = useLayout()
@@ -13,7 +12,7 @@ const props = defineProps<{
 
 // a11y: focus Nav element when menu has opened
 const navEl = ref<HTMLElement | null>(null)
-const isLocked = useScrollLock(inBrowser ? document.body : null)
+const isLocked = useBodyScrollLock()
 
 watch(
   [props, navEl],
diff --git a/src/client/theme-default/composables/scroll-lock.ts b/src/client/theme-default/composables/scroll-lock.ts
new file mode 100644
index 00000000..e04d15f6
--- /dev/null
+++ b/src/client/theme-default/composables/scroll-lock.ts
@@ -0,0 +1,141 @@
+import { inBrowser } from 'vitepress'
+import {
+  computed,
+  onScopeDispose,
+  shallowRef,
+  type WritableComputedRef
+} from 'vue'
+
+const isIOS =
+  inBrowser &&
+  (/iP(?:ad|hone|od)/.test(navigator.userAgent) ||
+    (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1))
+
+const scrollKeys = new Set([
+  ' ',
+  'PageUp',
+  'PageDown',
+  'Home',
+  'End',
+  'ArrowUp',
+  'ArrowDown',
+  'ArrowLeft',
+  'ArrowRight'
+])
+
+const listenerOptions = { capture: true, passive: false } as const
+
+function isScrollable(target: EventTarget | null): boolean {
+  let el = target instanceof Element ? target : null
+  while (el && el !== document.body) {
+    const { overflowX, overflowY } = getComputedStyle(el)
+    if (
+      ((overflowY === 'auto' || overflowY === 'scroll') &&
+        el.scrollHeight > el.clientHeight) ||
+      ((overflowX === 'auto' || overflowX === 'scroll') &&
+        el.scrollWidth > el.clientWidth)
+    ) {
+      return true
+    }
+    el = el.parentElement
+  }
+  return false
+}
+
+function blockScroll(e: Event) {
+  if ('touches' in e && (e as TouchEvent).touches.length > 1) return
+  if (!isScrollable(e.target)) e.preventDefault()
+}
+
+function blockScrollKeys(e: KeyboardEvent) {
+  if (e.metaKey || e.ctrlKey || e.altKey || !scrollKeys.has(e.key)) return
+  const el = e.target
+  if (
+    el instanceof HTMLElement &&
+    (el.isContentEditable || el.matches('input, textarea, select'))
+  ) {
+    return
+  }
+  blockScroll(e)
+}
+
+// all instances lock the same element, so the style juggling is refcounted
+let overflowLockCount = 0
+let eventLockCount = 0
+let initialOverflow: string | undefined
+let initialGutter: string | undefined
+
+function lockOverflow() {
+  if (++overflowLockCount > 1) return
+  const html = document.documentElement
+  if (!getComputedStyle(html).scrollbarGutter.includes('stable')) {
+    initialGutter = html.style.scrollbarGutter
+    html.style.scrollbarGutter = 'stable'
+  }
+  initialOverflow = document.body.style.overflow
+  document.body.style.overflow = 'hidden'
+  if (isIOS) {
+    document.addEventListener('touchmove', blockScroll, listenerOptions)
+  }
+}
+
+function unlockOverflow() {
+  if (--overflowLockCount > 0) return
+  if (isIOS) {
+    document.removeEventListener('touchmove', blockScroll, listenerOptions)
+  }
+  document.body.style.overflow = initialOverflow ?? ''
+  if (initialGutter !== undefined) {
+    document.documentElement.style.scrollbarGutter = initialGutter
+  }
+  initialOverflow = initialGutter = undefined
+}
+
+function lockEvents() {
+  if (++eventLockCount > 1) return
+  document.addEventListener('wheel', blockScroll, listenerOptions)
+  document.addEventListener('touchmove', blockScroll, listenerOptions)
+  document.addEventListener('keydown', blockScrollKeys, listenerOptions)
+}
+
+function unlockEvents() {
+  if (--eventLockCount > 0) return
+  document.removeEventListener('wheel', blockScroll, listenerOptions)
+  document.removeEventListener('touchmove', blockScroll, listenerOptions)
+  document.removeEventListener('keydown', blockScrollKeys, listenerOptions)
+}
+
+/**
+ * Locks page scrolling behind an overlay.
+ *
+ * Prefer `scrollbar-gutter: stable` + `overflow: hidden` so layout width
+ * stays stable when the scrollbar is hidden. If unsupported, fall back to
+ * blocking scroll events while still allowing events inside scrollable
+ * elements.
+ */
+export function useBodyScrollLock(): WritableComputedRef<boolean> {
+  const isLocked = shallowRef(false)
+  let useEvents = false
+
+  function lock() {
+    if (isLocked.value) return
+    useEvents =
+      window.innerWidth > document.documentElement.clientWidth &&
+      !CSS.supports('scrollbar-gutter', 'stable')
+    useEvents ? lockEvents() : lockOverflow()
+    isLocked.value = true
+  }
+
+  function unlock() {
+    if (!isLocked.value) return
+    useEvents ? unlockEvents() : unlockOverflow()
+    isLocked.value = false
+  }
+
+  onScopeDispose(unlock)
+
+  return computed({
+    get: () => isLocked.value,
+    set: (value) => (value ? lock() : unlock())
+  })
+}

From 5ce23b3bcc5b20c3ec5296eea463777118d8e0a8 Mon Sep 17 00:00:00 2001
From: btea <2356281422@qq.com>
Date: Wed, 19 Aug 2026 08:34:21 +0800
Subject: [PATCH 02/18] ci: preview release add pm option (#5388)

---
 .github/workflows/cr.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cr.yml b/.github/workflows/cr.yml
index ae327e48..d0b08f92 100644
--- a/.github/workflows/cr.yml
+++ b/.github/workflows/cr.yml
@@ -46,4 +46,4 @@ jobs:
           cache: pnpm
       - run: pnpm install
       - run: pnpm build
-      - run: npx pkg-pr-new publish --compact --no-template --pnpm
+      - run: npx pkg-pr-new publish --compact --no-template --pnpm --packageManager=pnpm,npm,yarn

From b0da3845f8a740f08777d0b46783179998dd30ed Mon Sep 17 00:00:00 2001
From: btea <2356281422@qq.com>
Date: Wed, 19 Aug 2026 08:46:06 +0800
Subject: [PATCH 03/18] refactor: use JSON import attributes instead of
 createRequire (#5389)

---
 scripts/release.ts | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/scripts/release.ts b/scripts/release.ts
index 1e44e490..1164aba0 100644
--- a/scripts/release.ts
+++ b/scripts/release.ts
@@ -2,15 +2,12 @@ import { spawn } from 'cross-spawn'
 import type { SpawnOptions } from 'node:child_process'
 import { once } from 'node:events'
 import fs from 'node:fs'
-import { createRequire } from 'node:module'
 import { resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import * as prompts from '@clack/prompts'
 import semver from 'semver'
+import { version as currentVersion } from '../package.json' with { type: 'json' }
 
-const { version: currentVersion } = createRequire(import.meta.url)(
-  '../package.json'
-)
 const { inc: _inc, valid } = semver
 
 const versionIncrements = ['patch', 'minor', 'major'] as const

From 005aa5c3e88d5d6a455bcc20b4c4e6f2c3a1abe9 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Thu, 20 Aug 2026 06:37:14 +0530
Subject: [PATCH 04/18] fix(theme): render sidebar active state during ssr

dcb7a755 turned hasActiveLink from a computed into a ref fed only by a
non-immediate watch and onMounted, so is-active/has-active stopped
rendering in static HTML. This broke pre-hydration sidebar highlighting
and the docsearch crawler's lvl0 selector (section.has-active div h2),
which has indexed every record as the defaultValue since then.

Run the update once during setup with the hash check skipped: the server
and the client's initial render compute identical path-only state, so
hydration stays clean; the watch and onMounted refine with the real hash
after mount.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../theme-default/composables/sidebar.ts       | 18 +++++++++++++-----
 src/client/theme-default/support/sidebar.ts    |  9 +++++----
 2 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/src/client/theme-default/composables/sidebar.ts b/src/client/theme-default/composables/sidebar.ts
index 1b9df6bd..116520d7 100644
--- a/src/client/theme-default/composables/sidebar.ts
+++ b/src/client/theme-default/composables/sidebar.ts
@@ -83,12 +83,14 @@ export function useSidebarItemControl(
   const isActiveLink = ref(false)
   const hasActiveLink = ref(false)
 
-  function updateActiveLink(): void {
+  function updateActiveLink(skipHashCheck = false): void {
     if (item.value.link) {
       isActiveLink.value = isActive(
         route.data.relativePath,
         route.hash,
-        item.value.link
+        item.value.link,
+        false,
+        skipHashCheck
       )
     } else {
       isActiveLink.value = false
@@ -105,15 +107,21 @@ export function useSidebarItemControl(
     hasActiveLink.value = containsActiveLink(
       route.data.relativePath,
       route.hash,
-      item.value.items
+      item.value.items,
+      skipHashCheck
     )
     if (hasActiveLink.value) {
       nextTick(() => (collapsed.value = false))
     }
   }
 
-  watch([item, route], updateActiveLink)
-  onMounted(updateActiveLink)
+  // runs during setup so active classes render in SSR output too; the hash
+  // isn't known on the server (and may differ at hydration), so it's skipped
+  // until mounted
+  updateActiveLink(true)
+
+  watch([item, route], () => updateActiveLink())
+  onMounted(() => updateActiveLink())
 
   const hasChildren = computed(() => {
     return !!(item.value.items && item.value.items.length)
diff --git a/src/client/theme-default/support/sidebar.ts b/src/client/theme-default/support/sidebar.ts
index 68a99452..35c92722 100644
--- a/src/client/theme-default/support/sidebar.ts
+++ b/src/client/theme-default/support/sidebar.ts
@@ -100,16 +100,17 @@ export function getFlatSideBarLinks(sidebar: SidebarItem[]): SidebarLink[] {
 export function hasActiveLink(
   path: string,
   hash: string,
-  items: SidebarItem | SidebarItem[]
+  items: SidebarItem | SidebarItem[],
+  skipHashCheck = false
 ): boolean {
   if (Array.isArray(items)) {
-    return items.some((item) => hasActiveLink(path, hash, item))
+    return items.some((item) => hasActiveLink(path, hash, item, skipHashCheck))
   }
-  if (items.link && isActive(path, hash, items.link)) {
+  if (items.link && isActive(path, hash, items.link, false, skipHashCheck)) {
     return true
   }
   if (items.items) {
-    return hasActiveLink(path, hash, items.items)
+    return hasActiveLink(path, hash, items.items, skipHashCheck)
   }
   return false
 }

From 1510d46a5f829a7213086e021e678af63f7d324b Mon Sep 17 00:00:00 2001
From: OldDriver <olddrivero.king@qq.com>
Date: Thu, 20 Aug 2026 14:11:59 +0800
Subject: [PATCH 05/18] docs(zh): translate 'Part file' in markdown guide
 (#5391)

---
 docs/zh/guide/markdown.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/zh/guide/markdown.md b/docs/zh/guide/markdown.md
index 2476c713..bec302f5 100644
--- a/docs/zh/guide/markdown.md
+++ b/docs/zh/guide/markdown.md
@@ -779,7 +779,7 @@ export default config
 <!--@@include: ./parts/basics.md-->
 ```
 
-**Part file** (`parts/basics.md`)
+**部分文件** (`parts/basics.md`)
 
 ```md
 Some getting started stuff.
@@ -815,7 +815,7 @@ Can be created using `.foorc.json`.
 <!--@@include: ./parts/basics.md{3,}-->
 ```
 
-**Part file** (`parts/basics.md`)
+**部分文件** (`parts/basics.md`)
 
 ```md
 Some getting started stuff.

From 548a6064473b6b98b0140e30f9fb11a1ada6423d Mon Sep 17 00:00:00 2001
From: btea <2356281422@qq.com>
Date: Thu, 20 Aug 2026 17:37:33 +0800
Subject: [PATCH 06/18] refactor: import json with attributes (#5392)

---
 src/node/build/render.ts     | 2 +-
 src/node/utils/logVersion.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/node/build/render.ts b/src/node/build/render.ts
index d91a8675..9cf215dc 100644
--- a/src/node/build/render.ts
+++ b/src/node/build/render.ts
@@ -2,7 +2,7 @@ import { isBooleanAttr } from '@vue/shared'
 import { mkdir, realpath, rm, writeFile } from 'node:fs/promises'
 import path from 'node:path'
 import { minify, normalizePath, type Rolldown } from 'vite'
-import { version } from '../../../package.json'
+import { version } from '../../../package.json' with { type: 'json' }
 import type { SiteConfig } from '../config'
 import {
   EXTERNAL_URL_RE,
diff --git a/src/node/utils/logVersion.ts b/src/node/utils/logVersion.ts
index 4e551282..a43ceb8a 100644
--- a/src/node/utils/logVersion.ts
+++ b/src/node/utils/logVersion.ts
@@ -1,6 +1,6 @@
 import c from 'picocolors'
 import { version as viteVersion, type Logger } from 'vite'
-import { version } from '../../../package.json'
+import { version } from '../../../package.json' with { type: 'json' }
 
 export function logVersion(logger: Logger) {
   logger.info(

From 9aeeb4fa31396040b6014af2b45111a05751547d Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Fri, 21 Aug 2026 10:37:41 +0530
Subject: [PATCH 07/18] fix(theme): use a getter as VPSidebar's open watch
 source
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`watch([props, navEl], ...)` is only accidentally valid on the client,
where props reaching setup are shallow-reactive. During SSR props are
not reactified (dev mode additionally wraps them in shallowReadonly),
so dev-flavored SSR warns "Invalid watch source: Proxy({ open: false })"
once per rendered page. Normally invisible because build() forces
NODE_ENV=production before vue loads — but any process that already
required vue under a different NODE_ENV (programmatic builds inside
test runners) keeps dev vue in the module cache and surfaces it.

Repro (pure Vue, no vitepress): renderToString of a component doing
watch([props, ref], cb, { immediate: true, flush: 'post' }) under dev
vue. Watching `() => props.open` expresses the actual dependency and
is valid in both environments.
---
 src/client/theme-default/components/VPSidebar.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/client/theme-default/components/VPSidebar.vue b/src/client/theme-default/components/VPSidebar.vue
index b3105f8c..594f78d1 100644
--- a/src/client/theme-default/components/VPSidebar.vue
+++ b/src/client/theme-default/components/VPSidebar.vue
@@ -15,7 +15,7 @@ const navEl = ref<HTMLElement | null>(null)
 const isLocked = useBodyScrollLock()
 
 watch(
-  [props, navEl],
+  [() => props.open, navEl],
   () => {
     if (props.open) {
       isLocked.value = true

From 7c871183bbaa79d393f25f5caeaa5df9867a8a8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Est=C3=A9ban?= <e.soubiran25@gmail.com>
Date: Fri, 21 Aug 2026 17:33:52 +0200
Subject: [PATCH 08/18] docs: vitepress-plugin-cloudflare-ai-search (#5393)

---
 docs/en/reference/default-theme-search.md | 1 +
 docs/es/reference/default-theme-search.md | 2 +-
 docs/fa/reference/default-theme-search.md | 2 +-
 docs/ja/reference/default-theme-search.md | 1 +
 docs/ko/reference/default-theme-search.md | 2 +-
 docs/pt/reference/default-theme-search.md | 2 +-
 docs/ru/reference/default-theme-search.md | 1 +
 docs/zh/reference/default-theme-search.md | 2 +-
 8 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/docs/en/reference/default-theme-search.md b/docs/en/reference/default-theme-search.md
index 3c3fc41b..66bc0693 100644
--- a/docs/en/reference/default-theme-search.md
+++ b/docs/en/reference/default-theme-search.md
@@ -31,6 +31,7 @@ Alternatively, you can use [Algolia DocSearch](#algolia-search) or some communit
 - <https://www.npmjs.com/package/vitepress-plugin-pagefind>
 - <https://www.npmjs.com/package/@orama/plugin-vitepress>
 - <https://www.npmjs.com/package/vitepress-plugin-typesense>
+- <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>
 
 ### i18n {#local-search-i18n}
 
diff --git a/docs/es/reference/default-theme-search.md b/docs/es/reference/default-theme-search.md
index 0dcb9018..7d5a719d 100644
--- a/docs/es/reference/default-theme-search.md
+++ b/docs/es/reference/default-theme-search.md
@@ -25,7 +25,7 @@ Resultado de ejemplo:
 
 ![captura de pantalla del modo de búsqueda](/search.png)
 
-Alternativamente, puedes usar [Algolia DocSearch](#algolia-search) o algunos complementos comunitarios como <https://www.npmjs.com/package/vitepress-plugin-search> o <https://www.npmjs.com/package/vitepress-plugin-pagefind>.
+Alternativamente, puedes usar [Algolia DocSearch](#algolia-search) o algunos complementos comunitarios como <https://www.npmjs.com/package/vitepress-plugin-search>, <https://www.npmjs.com/package/vitepress-plugin-pagefind> o <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>.
 
 ### i18n {#local-search-i18n}
 
diff --git a/docs/fa/reference/default-theme-search.md b/docs/fa/reference/default-theme-search.md
index 8bc68a81..0ef6902e 100644
--- a/docs/fa/reference/default-theme-search.md
+++ b/docs/fa/reference/default-theme-search.md
@@ -25,7 +25,7 @@ export default defineConfig({
 
 ![تصویر نمایشی از مودال جستجو](/search.png)
 
-همچنین، می‌توانید از [Algolia DocSearch](#algolia-search) یا برخی افزونه‌های جامعه‌ای مانند <https://www.npmjs.com/package/vitepress-plugin-search> یا <https://www.npmjs.com/package/vitepress-plugin-pagefind> استفاده کنید.
+همچنین، می‌توانید از [Algolia DocSearch](#algolia-search) یا برخی افزونه‌های جامعه‌ای مانند <https://www.npmjs.com/package/vitepress-plugin-search>، <https://www.npmjs.com/package/vitepress-plugin-pagefind> یا <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search> استفاده کنید.
 
 ### بین‌المللی‌سازی {#local-search-i18n}
 
diff --git a/docs/ja/reference/default-theme-search.md b/docs/ja/reference/default-theme-search.md
index e2042f75..4e6150b2 100644
--- a/docs/ja/reference/default-theme-search.md
+++ b/docs/ja/reference/default-theme-search.md
@@ -31,6 +31,7 @@ export default defineConfig({
 - <https://www.npmjs.com/package/vitepress-plugin-pagefind>
 - <https://www.npmjs.com/package/@orama/plugin-vitepress>
 - <https://www.npmjs.com/package/vitepress-plugin-typesense>
+- <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>
 
 ### i18n {#local-search-i18n}
 
diff --git a/docs/ko/reference/default-theme-search.md b/docs/ko/reference/default-theme-search.md
index e54e7059..a65f1a6a 100644
--- a/docs/ko/reference/default-theme-search.md
+++ b/docs/ko/reference/default-theme-search.md
@@ -25,7 +25,7 @@ export default defineConfig({
 
 ![검색 모달의 스크린샷](/search.png)
 
-대안으로 [Algolia DocSearch](#algolia-search), <https://www.npmjs.com/package/vitepress-plugin-search>, <https://www.npmjs.com/package/vitepress-plugin-pagefind>와 같은 커뮤니티 플러그인을 사용할 수도 있습니다.
+대안으로 [Algolia DocSearch](#algolia-search), <https://www.npmjs.com/package/vitepress-plugin-search>, <https://www.npmjs.com/package/vitepress-plugin-pagefind>, <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>와 같은 커뮤니티 플러그인을 사용할 수도 있습니다.
 
 ### i18n {#local-search-i18n}
 
diff --git a/docs/pt/reference/default-theme-search.md b/docs/pt/reference/default-theme-search.md
index d274674a..69beec9d 100644
--- a/docs/pt/reference/default-theme-search.md
+++ b/docs/pt/reference/default-theme-search.md
@@ -25,7 +25,7 @@ Exemplo de resultado:
 
 ![captura de tela do modal de pesquisa](/search.png)
 
-Alternativamente, você pode usar [Algolia DocSearch](#algolia-search) ou alguns plugins da comunidade como <https://www.npmjs.com/package/vitepress-plugin-search> ou <https://www.npmjs.com/package/vitepress-plugin-pagefind>.
+Alternativamente, você pode usar [Algolia DocSearch](#algolia-search) ou alguns plugins da comunidade como <https://www.npmjs.com/package/vitepress-plugin-search>, <https://www.npmjs.com/package/vitepress-plugin-pagefind> ou <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>.
 
 ### i18n {#local-search-i18n}
 
diff --git a/docs/ru/reference/default-theme-search.md b/docs/ru/reference/default-theme-search.md
index efead057..f40721a6 100644
--- a/docs/ru/reference/default-theme-search.md
+++ b/docs/ru/reference/default-theme-search.md
@@ -31,6 +31,7 @@ export default defineConfig({
 - <https://www.npmjs.com/package/vitepress-plugin-pagefind>
 - <https://www.npmjs.com/package/@orama/plugin-vitepress>
 - <https://www.npmjs.com/package/vitepress-plugin-typesense>
+- <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>
 
 ### i18n {#local-search-i18n}
 
diff --git a/docs/zh/reference/default-theme-search.md b/docs/zh/reference/default-theme-search.md
index eda1d18b..859a2a23 100644
--- a/docs/zh/reference/default-theme-search.md
+++ b/docs/zh/reference/default-theme-search.md
@@ -25,7 +25,7 @@ export default defineConfig({
 
 ![搜索弹窗截图](/search.png)
 
-或者，你可以使用 [Algolia DocSearch](#algolia-search) 或一些社区插件，例如：<https://www.npmjs.com/package/vitepress-plugin-search> 或者 <https://www.npmjs.com/package/vitepress-plugin-pagefind>。
+或者，你可以使用 [Algolia DocSearch](#algolia-search) 或一些社区插件，例如：<https://www.npmjs.com/package/vitepress-plugin-search>、<https://www.npmjs.com/package/vitepress-plugin-pagefind> 或者 <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>。
 
 ### i18n {#local-search-i18n}
 

From ed03db9a5970e4bd92d3f8d6ae26b244ea77928d Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Sat, 22 Aug 2026 09:24:22 +0530
Subject: [PATCH 09/18] docs: remove unmaintained search plugins from list

---
 docs/en/reference/default-theme-search.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/en/reference/default-theme-search.md b/docs/en/reference/default-theme-search.md
index 66bc0693..d383288e 100644
--- a/docs/en/reference/default-theme-search.md
+++ b/docs/en/reference/default-theme-search.md
@@ -27,11 +27,11 @@ Example result:
 
 Alternatively, you can use [Algolia DocSearch](#algolia-search) or some community plugins like:
 
-- <https://www.npmjs.com/package/vitepress-plugin-search>
-- <https://www.npmjs.com/package/vitepress-plugin-pagefind>
-- <https://www.npmjs.com/package/@orama/plugin-vitepress>
-- <https://www.npmjs.com/package/vitepress-plugin-typesense>
-- <https://www.npmjs.com/package/vitepress-plugin-cloudflare-ai-search>
+- <https://npmx.dev/package/vitepress-plugin-pagefind>
+- <https://npmx.dev/package/vitepress-plugin-typesense>
+- <https://npmx.dev/package/vitepress-plugin-cloudflare-ai-search>
+
+<!-- - <https://npmx.dev/package/@orama/plugin-vitepress> -- replace with zbsearch one when published -->
 
 ### i18n {#local-search-i18n}
 

From b18f30680b9bced83abd6eacb9417701298cb309 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Sat, 22 Aug 2026 10:05:22 +0530
Subject: [PATCH 10/18] fix: key head entries by id and ignore meta content
 when deduping

Any element with an `id` is keyed by it regardless of attribute order, and a
`meta` without one is keyed by its first attribute other than `content`. This
stops differently named meta tags with the same content from overriding each
other and lets repeated meta tags be kept apart with unique ids.

fixes #5362
closes #5363
closes #5379

Co-authored-by: Lazizbek Ergashev <20501725+lazerg@users.noreply.github.com>
Co-authored-by: shamu45678 <220251922@seu.edu.cn>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 __tests__/unit/shared/shared.test.ts    | 56 +++++++++++++++++++++++++
 docs/en/reference/frontmatter-config.md |  2 +-
 docs/en/reference/site-config.md        |  7 ++++
 src/shared/shared.ts                    | 22 ++++++----
 4 files changed, 79 insertions(+), 8 deletions(-)
 create mode 100644 __tests__/unit/shared/shared.test.ts

diff --git a/__tests__/unit/shared/shared.test.ts b/__tests__/unit/shared/shared.test.ts
new file mode 100644
index 00000000..77826db3
--- /dev/null
+++ b/__tests__/unit/shared/shared.test.ts
@@ -0,0 +1,56 @@
+import { mergeHead, type HeadConfig } from 'shared/shared'
+
+describe('shared/shared', () => {
+  describe('mergeHead', () => {
+    test('replaces meta tags with the same key in place', () => {
+      expect(
+        mergeHead(
+          [
+            ['meta', { property: 'og:image', content: '/site.png' }],
+            ['meta', { name: 'keywords', content: 'site' }]
+          ],
+          [['meta', { content: '/page.png', property: 'og:image' }]]
+        )
+      ).toEqual([
+        ['meta', { content: '/page.png', property: 'og:image' }],
+        ['meta', { name: 'keywords', content: 'site' }]
+      ])
+    })
+
+    test('ignores content when keying meta tags', () => {
+      const head: HeadConfig[] = [
+        ['meta', { content: 'a', name: 'name1' }],
+        ['meta', { content: 'a', name: 'name2' }]
+      ]
+      expect(mergeHead(head)).toEqual(head)
+    })
+
+    test('keys any element by id regardless of attribute order', () => {
+      expect(
+        mergeHead(
+          [
+            ['meta', { name: 'author', content: 'a', id: 'author-a' }],
+            ['meta', { name: 'author', content: 'b', id: 'author-b' }],
+            ['script', { id: 'sw' }, 'old']
+          ],
+          [
+            ['meta', { id: 'author-a', name: 'author', content: 'c' }],
+            ['script', { id: 'sw' }, 'new']
+          ]
+        )
+      ).toEqual([
+        ['meta', { id: 'author-a', name: 'author', content: 'c' }],
+        ['meta', { name: 'author', content: 'b', id: 'author-b' }],
+        ['script', { id: 'sw' }, 'new']
+      ])
+    })
+
+    test('appends elements without a key', () => {
+      const head: HeadConfig[] = [
+        ['link', { rel: 'stylesheet', href: '/a.css' }],
+        ['link', { rel: 'stylesheet', href: '/a.css' }]
+      ]
+      expect(mergeHead(head, head)).toEqual([...head, ...head])
+    })
+  })
+})
diff --git a/docs/en/reference/frontmatter-config.md b/docs/en/reference/frontmatter-config.md
index 8960bfe2..42f57f4a 100644
--- a/docs/en/reference/frontmatter-config.md
+++ b/docs/en/reference/frontmatter-config.md
@@ -63,7 +63,7 @@ description: VitePress
 
 - Type: `HeadConfig[]`
 
-Specify extra head tags to be injected for the current page. Will be appended after head tags injected by site-level config.
+Specify extra head tags to be injected for the current page. They are [merged](./site-config#head) with the head tags injected by site-level config.
 
 ```yaml
 ---
diff --git a/docs/en/reference/site-config.md b/docs/en/reference/site-config.md
index a9d9c4f1..d79eb637 100644
--- a/docs/en/reference/site-config.md
+++ b/docs/en/reference/site-config.md
@@ -248,6 +248,13 @@ type HeadConfig =
   | [string, Record<string, string>, string]
 ```
 
+Head entries from the site config, [locale config](../guide/i18n), [directory-level config](#directory-level-overrides), [frontmatter](./frontmatter-config#head) and [`transformHead`](#transformhead) are merged in that order. A later entry replaces an earlier one with the same key instead of being appended:
+
+- Any element with an `id` attribute is keyed by its `id`.
+- A `meta` element without an `id` is keyed by its first attribute other than `content` (e.g. `name`, `property`, `http-equiv`) and that attribute's value.
+
+Other elements are never deduplicated. To render multiple `meta` tags that would share a key, like several `<meta name="author">`, give each of them a unique `id`.
+
 #### Example: Adding a favicon
 
 ```ts
diff --git a/src/shared/shared.ts b/src/shared/shared.ts
index e7fda629..2b50151b 100644
--- a/src/shared/shared.ts
+++ b/src/shared/shared.ts
@@ -198,25 +198,23 @@ function createTitleTemplate(
 
 export function mergeHead(...headArrays: HeadConfig[][]): HeadConfig[] {
   const merged: HeadConfig[] = []
-  const metaKeyMap = new Map<string, number>()
+  const keyMap = new Map<string, number>()
 
   for (const current of headArrays) {
     for (const tag of current) {
-      const [type, attrs] = tag
-      const keyAttr = Object.entries(attrs)[0]
+      const key = getHeadKey(tag)
 
-      if (type !== 'meta' || !keyAttr) {
+      if (key == null) {
         merged.push(tag)
         continue
       }
 
-      const key = `${keyAttr[0]}=${keyAttr[1]}`
-      const existingIndex = metaKeyMap.get(key)
+      const existingIndex = keyMap.get(key)
 
       if (existingIndex != null) {
         merged[existingIndex] = tag // replace existing tag
       } else {
-        metaKeyMap.set(key, merged.length)
+        keyMap.set(key, merged.length)
         merged.push(tag)
       }
     }
@@ -225,6 +223,16 @@ export function mergeHead(...headArrays: HeadConfig[][]): HeadConfig[] {
   return merged
 }
 
+// any element is keyed by its `id`; a meta tag without one is keyed by its
+// first attribute other than `content` (e.g. `name`, `property`, `http-equiv`)
+function getHeadKey([type, attrs]: HeadConfig): string | undefined {
+  if (attrs.id) return `id=${attrs.id}`
+  if (type !== 'meta') return
+  for (const name in attrs) {
+    if (name !== 'content') return `${name}=${attrs[name]}`
+  }
+}
+
 export function sanitizeFileName(name: string): string {
   const match = DRIVE_LETTER_REGEX.exec(name)
   const driveLetter = match ? match[0] : ''

From ed2bfb266ef788e86d1a73fe3cd7708a4cd5e260 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Sat, 22 Aug 2026 11:24:45 +0530
Subject: [PATCH 11/18] fix(theme): render sidebar group toggles as native
 buttons

The sidebar item row was a `role="button"` wrapping both the group heading
and a second `role="button"` caret, which is invalid HTML and nests
interactive controls. The caret is now the only control (a native button
with `aria-expanded`), the row keeps its click handler as a mouse-only
affordance, and groups without a heading render a `div` instead of a
`section`.

fixes #5366
closes #5371

Co-authored-by: Jibin7Jose <jibinjose884@gmail.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 __tests__/e2e/sidebar.test.ts                 | 36 ++++++++++++++
 .../components/VPSidebarItem.vue              | 49 ++++++-------------
 2 files changed, 50 insertions(+), 35 deletions(-)
 create mode 100644 __tests__/e2e/sidebar.test.ts

diff --git a/__tests__/e2e/sidebar.test.ts b/__tests__/e2e/sidebar.test.ts
new file mode 100644
index 00000000..288b15c8
--- /dev/null
+++ b/__tests__/e2e/sidebar.test.ts
@@ -0,0 +1,36 @@
+describe('sidebar', () => {
+  beforeAll(async () => {
+    await goto('/frontmatter/multiple-levels-outline')
+  })
+
+  test('collapsible group renders a heading and a single toggle button', async () => {
+    const group = page.locator('.VPSidebarItem.level-0.collapsible').first()
+    const caret = group.locator('.caret').first()
+
+    expect(await page.locator('.VPSidebarItem [role="button"]').count()).toBe(0)
+    expect(await caret.evaluate((el) => el.tagName)).toBe('BUTTON')
+    expect(await caret.getAttribute('aria-expanded')).toBe('true')
+  })
+
+  test('group toggles with keyboard, caret and heading', async () => {
+    const group = page.locator('.VPSidebarItem.level-0.collapsible').first()
+    const caret = group.locator('.caret').first()
+    const isCollapsed = () =>
+      group.evaluate((el) => el.classList.contains('collapsed'))
+
+    await caret.focus()
+    await page.keyboard.press('Enter')
+    expect(await isCollapsed()).toBe(true)
+    expect(await caret.getAttribute('aria-expanded')).toBe('false')
+
+    await page.keyboard.press('Space')
+    expect(await isCollapsed()).toBe(false)
+    expect(await caret.getAttribute('aria-expanded')).toBe('true')
+
+    await caret.click()
+    expect(await isCollapsed()).toBe(true)
+
+    await group.locator('.text').first().click()
+    expect(await isCollapsed()).toBe(false)
+  })
+})
diff --git a/src/client/theme-default/components/VPSidebarItem.vue b/src/client/theme-default/components/VPSidebarItem.vue
index 6dad9f58..fe268a63 100644
--- a/src/client/theme-default/components/VPSidebarItem.vue
+++ b/src/client/theme-default/components/VPSidebarItem.vue
@@ -19,19 +19,16 @@ const {
   toggle
 } = useSidebarItemControl(computed(() => props.item))
 
-const sectionTag = computed(() => (hasChildren.value ? 'section' : `div`))
-
 const linkTag = computed(() => (isLink.value ? 'a' : 'div'))
 
-const textTag = computed(() => {
-  return !hasChildren.value
-    ? 'p'
-    : props.depth + 2 === 7
-      ? 'p'
-      : `h${props.depth + 2}`
-})
+const textTag = computed(() =>
+  hasChildren.value && props.depth < 5 ? `h${props.depth + 2}` : 'p'
+)
 
-const itemRole = computed(() => (isLink.value ? undefined : 'button'))
+// a section needs a heading
+const sectionTag = computed(() =>
+  props.item.text && textTag.value !== 'p' ? 'section' : 'div'
+)
 
 const classes = computed(() => [
   [`level-${props.depth}`],
@@ -42,31 +39,14 @@ const classes = computed(() => [
   { 'has-active': hasActiveLink.value }
 ])
 
-function onItemInteraction(e: MouseEvent | Event) {
-  if ('key' in e && e.key !== 'Enter') {
-    return
-  }
+function onItemClick() {
   !props.item.link && toggle()
 }
-
-function onCaretClick() {
-  props.item.link && toggle()
-}
 </script>
 
 <template>
   <component :is="sectionTag" class="VPSidebarItem" :class="classes">
-    <div
-      v-if="item.text"
-      class="item"
-      :role="itemRole"
-      v-on="
-        item.items
-          ? { click: onItemInteraction, keydown: onItemInteraction }
-          : {}
-      "
-      :tabindex="item.items && 0"
-    >
+    <div v-if="item.text" class="item" @click="onItemClick">
       <div class="indicator" />
 
       <VPLink
@@ -81,17 +61,16 @@ function onCaretClick() {
       </VPLink>
       <component v-else :is="textTag" class="text" v-html="item.text" />
 
-      <div
+      <button
         v-if="item.collapsed != null && item.items && item.items.length"
+        type="button"
         class="caret"
-        role="button"
         aria-label="toggle section"
-        @click="onCaretClick"
-        @keydown.enter="onCaretClick"
-        tabindex="0"
+        :aria-expanded="!collapsed"
+        @click.stop="toggle"
       >
         <span class="vpi-chevron-right caret-icon" />
-      </div>
+      </button>
     </div>
 
     <ul v-if="item.items && item.items.length" class="items">

From 5a368d3198728ade447d4ea86a059e04e266f404 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Mon, 24 Aug 2026 00:41:28 +0530
Subject: [PATCH 12/18] chore: format codebase and remove unused icons

---
 .../theme/components/CustomLayout.vue         |  1 +
 .../theme/components/HomeHeroCopy.vue         | 47 ++++++++-----------
 .../theme/components/NavVersion.vue           |  2 +-
 __tests__/e2e/.vitepress/theme/index.ts       |  3 +-
 __tests__/e2e/data-loading/basic.data.mts     |  1 +
 __tests__/e2e/dynamic-routes/[id].paths.ts    |  1 +
 __tests__/e2e/vitestGlobalSetup.ts            |  3 +-
 __tests__/init/init.test.ts                   |  5 +-
 __tests__/unit/node/contentLoader.test.ts     |  5 +-
 .../unit/node/markdown/plugins/image.test.ts  |  3 +-
 .../node/markdown/plugins/include.test.ts     |  1 +
 .../node/markdown/plugins/snippet.test.ts     |  1 +
 __tests__/unit/node/markdownToVue.test.ts     |  5 +-
 .../node/plugins/localSearchPlugin.test.ts    |  7 +--
 __tests__/unit/node/utils/fs.test.ts          |  1 +
 __tests__/unit/vitest.config.ts               |  3 +-
 docs/.vitepress/config.ts                     |  1 +
 docs/.vitepress/theme/index.ts                |  1 +
 netlify.toml                                  | 42 ++++++++---------
 rollup.config.ts                              |  8 ++--
 scripts/copyClient.ts                         |  1 +
 scripts/copyShared.ts                         |  1 +
 scripts/release.ts                            |  4 +-
 scripts/watchAndCopy.ts                       |  3 +-
 src/client/app/components/Content.ts          |  1 +
 src/client/app/composables/copyCode.ts        |  1 +
 src/client/app/composables/head.ts            |  1 +
 src/client/app/composables/preFetch.ts        |  1 +
 src/client/app/data.ts                        |  1 +
 src/client/app/devtools.ts                    |  1 +
 src/client/app/index.ts                       |  1 +
 src/client/app/router.ts                      |  1 +
 src/client/app/ssr.ts                         |  1 +
 src/client/app/theme.ts                       |  1 +
 src/client/app/utils.ts                       |  1 +
 src/client/theme-default/Layout.vue           |  1 +
 src/client/theme-default/NotFound.vue         |  5 +-
 .../components/VPAlgoliaSearchBox.vue         |  1 +
 .../theme-default/components/VPBackdrop.vue   |  2 +-
 .../theme-default/components/VPButton.vue     |  5 +-
 .../theme-default/components/VPCarbonAds.vue  |  2 +-
 .../theme-default/components/VPContent.vue    |  3 +-
 src/client/theme-default/components/VPDoc.vue |  3 +-
 .../components/VPDocAsideOutline.vue          |  6 +--
 .../theme-default/components/VPDocFooter.vue  |  1 +
 .../components/VPDocFooterLastUpdated.vue     |  9 +++-
 .../theme-default/components/VPFeature.vue    |  1 +
 .../theme-default/components/VPFeatures.vue   |  1 +
 .../theme-default/components/VPFlyout.vue     |  1 +
 .../theme-default/components/VPFooter.vue     | 18 +++++--
 .../theme-default/components/VPHero.vue       |  1 +
 .../theme-default/components/VPHome.vue       |  9 ++--
 .../theme-default/components/VPImage.vue      |  2 +-
 .../theme-default/components/VPLink.vue       |  3 +-
 .../theme-default/components/VPLocalNav.vue   |  1 +
 .../components/VPLocalNavOutlineDropdown.vue  |  1 +
 .../components/VPLocalSearchBox.vue           |  6 +--
 .../theme-default/components/VPMenu.vue       |  3 +-
 .../theme-default/components/VPMenuGroup.vue  | 12 ++++-
 .../theme-default/components/VPMenuLink.vue   |  5 +-
 src/client/theme-default/components/VPNav.vue |  1 +
 .../theme-default/components/VPNavBar.vue     |  1 +
 .../components/VPNavBarExtra.vue              |  1 +
 .../components/VPNavBarHamburger.vue          |  4 +-
 .../components/VPNavBarMenuGroup.vue          |  1 +
 .../components/VPNavBarMenuLink.vue           |  1 +
 .../components/VPNavBarSearch.vue             |  1 +
 .../components/VPNavBarTitle.vue              |  1 +
 .../components/VPNavScreenMenuGroup.vue       |  1 +
 .../components/VPNavScreenMenuGroupLink.vue   |  1 +
 .../VPNavScreenMenuGroupSection.vue           |  1 +
 .../components/VPNavScreenMenuLink.vue        |  5 +-
 .../components/VPNavScreenTranslations.vue    |  1 +
 .../theme-default/components/VPSidebar.vue    |  4 +-
 .../components/VPSidebarGroup.vue             |  1 +
 .../components/VPSidebarItem.vue              |  3 +-
 .../theme-default/components/VPSkipLink.vue   |  1 +
 .../theme-default/components/VPSocialLink.vue |  1 +
 .../components/VPSocialLinks.vue              |  9 +---
 .../theme-default/components/VPSponsors.vue   |  1 +
 .../components/VPSponsorsGrid.vue             |  1 +
 .../components/VPSwitchAppearance.vue         |  1 +
 .../components/VPTeamMembers.vue              |  1 +
 .../components/VPTeamMembersItem.vue          |  1 +
 .../components/icons/VPIconAlignJustify.vue   |  8 ----
 .../components/icons/VPIconAlignLeft.vue      |  8 ----
 .../components/icons/VPIconAlignRight.vue     |  8 ----
 .../components/icons/VPIconArrowLeft.vue      |  7 ---
 .../components/icons/VPIconArrowRight.vue     |  7 ---
 .../components/icons/VPIconChevronDown.vue    |  5 --
 .../components/icons/VPIconChevronLeft.vue    |  5 --
 .../components/icons/VPIconChevronRight.vue   |  5 --
 .../components/icons/VPIconChevronUp.vue      |  5 --
 .../components/icons/VPIconEdit.vue           |  6 ---
 .../components/icons/VPIconHeart.vue          |  5 --
 .../components/icons/VPIconLanguages.vue      |  9 ----
 .../components/icons/VPIconMinus.vue          |  5 --
 .../components/icons/VPIconMinusSquare.vue    |  6 ---
 .../components/icons/VPIconMoon.vue           |  5 --
 .../components/icons/VPIconMoreHorizontal.vue |  7 ---
 .../components/icons/VPIconPlus.vue           |  5 --
 .../components/icons/VPIconPlusSquare.vue     |  6 ---
 .../components/icons/VPIconSun.vue            | 13 -----
 .../theme-default/composables/edit-link.ts    |  1 +
 src/client/theme-default/composables/langs.ts |  1 +
 .../theme-default/composables/layout.ts       |  1 +
 .../theme-default/composables/outline.ts      |  1 +
 .../theme-default/composables/prev-next.ts    |  1 +
 .../theme-default/composables/sidebar.ts      |  1 +
 .../theme-default/composables/sponsor-grid.ts |  1 +
 src/client/theme-default/support/docsearch.ts |  1 +
 src/client/theme-default/support/sidebar.ts   |  1 +
 src/client/theme-default/support/utils.ts     |  1 +
 src/client/theme-default/without-fonts.ts     |  1 +
 src/node/alias.ts                             |  1 +
 src/node/build/build.ts                       |  4 +-
 src/node/build/buildMPAClient.ts              |  1 +
 src/node/build/bundle.ts                      |  2 +
 src/node/build/generateSitemap.ts             |  2 +
 src/node/build/render.ts                      |  4 +-
 src/node/cli.ts                               |  1 +
 src/node/config.ts                            |  2 +
 src/node/contentLoader.ts                     |  4 +-
 src/node/defaultTheme.ts                      |  1 +
 src/node/init/init.ts                         | 10 ++--
 src/node/markdown/markdown.ts                 |  4 +-
 src/node/markdown/plugins/containers.ts       |  1 +
 src/node/markdown/plugins/highlight.ts        |  1 +
 src/node/markdown/plugins/image.ts            |  6 ++-
 src/node/markdown/plugins/include.ts          |  4 +-
 src/node/markdown/plugins/link.ts             |  4 +-
 src/node/markdown/plugins/preWrapper.ts       |  1 +
 src/node/markdown/plugins/restoreEntities.ts  |  1 +
 src/node/markdown/plugins/snippet.ts          |  4 +-
 src/node/markdownToVue.ts                     |  6 ++-
 src/node/plugin.ts                            |  4 +-
 src/node/plugins/dynamicRoutesPlugin.ts       |  2 +
 src/node/plugins/localSearchPlugin.ts         |  4 +-
 src/node/plugins/rewritesPlugin.ts            |  1 +
 src/node/plugins/staticDataPlugin.ts          |  2 +
 src/node/serve/serve.ts                       |  4 +-
 src/node/server.ts                            |  1 +
 src/node/shortcuts.ts                         |  1 +
 src/node/siteConfig.ts                        |  1 +
 src/node/utils/getGitTimestamp.ts             |  4 +-
 src/node/utils/glob.ts                        |  1 +
 src/node/utils/logVersion.ts                  |  1 +
 theme.d.ts                                    |  1 +
 types/default-theme.d.ts                      |  1 +
 149 files changed, 277 insertions(+), 258 deletions(-)
 delete mode 100644 src/client/theme-default/components/icons/VPIconAlignJustify.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconAlignLeft.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconAlignRight.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconArrowLeft.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconArrowRight.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconChevronDown.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconChevronLeft.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconChevronRight.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconChevronUp.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconEdit.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconHeart.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconLanguages.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconMinus.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconMinusSquare.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconMoon.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconMoreHorizontal.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconPlus.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconPlusSquare.vue
 delete mode 100644 src/client/theme-default/components/icons/VPIconSun.vue

diff --git a/__tests__/e2e/.vitepress/theme/components/CustomLayout.vue b/__tests__/e2e/.vitepress/theme/components/CustomLayout.vue
index 4a42af44..2b060892 100644
--- a/__tests__/e2e/.vitepress/theme/components/CustomLayout.vue
+++ b/__tests__/e2e/.vitepress/theme/components/CustomLayout.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import DefaultTheme from 'vitepress/theme'
+
 import HomeHeroCopy from './HomeHeroCopy.vue'
 
 const INSTALL_COMMAND = 'npx vitepress init'
diff --git a/__tests__/e2e/.vitepress/theme/components/HomeHeroCopy.vue b/__tests__/e2e/.vitepress/theme/components/HomeHeroCopy.vue
index ecc3ba92..d8fdaf2a 100644
--- a/__tests__/e2e/.vitepress/theme/components/HomeHeroCopy.vue
+++ b/__tests__/e2e/.vitepress/theme/components/HomeHeroCopy.vue
@@ -1,23 +1,23 @@
 <script setup lang="ts">
-  import { ref } from 'vue'
-
-  const props = defineProps<{
-    command: string
-  }>()
-
-  const copied = ref(false)
-
-  async function copy () {
-    try {
-      await navigator.clipboard.writeText(props.command)
-      copied.value = true
-      setTimeout(() => {
-        copied.value = false
-      }, 2000)
-    } catch (error) {
-      console.error('Failed to copy', error)
-    }
+import { ref } from 'vue'
+
+const props = defineProps<{
+  command: string
+}>()
+
+const copied = ref(false)
+
+async function copy() {
+  try {
+    await navigator.clipboard.writeText(props.command)
+    copied.value = true
+    setTimeout(() => {
+      copied.value = false
+    }, 2000)
+  } catch (error) {
+    console.error('Failed to copy', error)
   }
+}
 </script>
 
 <template>
@@ -49,14 +49,7 @@
           width="18"
           xmlns="http://www.w3.org/2000/svg"
         >
-          <rect
-            height="14"
-            rx="2"
-            ry="2"
-            width="14"
-            x="8"
-            y="8"
-          />
+          <rect height="14" rx="2" ry="2" width="14" x="8" y="8" />
           <path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" />
         </svg>
         <svg
@@ -170,7 +163,7 @@
   font-size: 12px;
   font-weight: 600;
   pointer-events: none;
-  box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
   z-index: 10;
 }
 
diff --git a/__tests__/e2e/.vitepress/theme/components/NavVersion.vue b/__tests__/e2e/.vitepress/theme/components/NavVersion.vue
index d256e3d2..dc3b9180 100644
--- a/__tests__/e2e/.vitepress/theme/components/NavVersion.vue
+++ b/__tests__/e2e/.vitepress/theme/components/NavVersion.vue
@@ -1,8 +1,8 @@
 <script setup lang="ts">
-import { computed } from 'vue'
 import { useRoute } from 'vitepress'
 import VPNavBarMenuGroup from 'vitepress/dist/client/theme-default/components/VPNavBarMenuGroup.vue'
 import VPNavScreenMenuGroup from 'vitepress/dist/client/theme-default/components/VPNavScreenMenuGroup.vue'
+import { computed } from 'vue'
 
 const props = defineProps<{
   versions: { text: string; link: string }[]
diff --git a/__tests__/e2e/.vitepress/theme/index.ts b/__tests__/e2e/.vitepress/theme/index.ts
index 9b5c079c..d28c5dce 100644
--- a/__tests__/e2e/.vitepress/theme/index.ts
+++ b/__tests__/e2e/.vitepress/theme/index.ts
@@ -1,7 +1,8 @@
 import type { Theme } from 'vitepress'
 import DefaultTheme from 'vitepress/theme'
-import CustomLayout from './components/CustomLayout.vue'
+
 import ApiPreference from './components/ApiPreference.vue'
+import CustomLayout from './components/CustomLayout.vue'
 import NavVersion from './components/NavVersion.vue'
 
 export default {
diff --git a/__tests__/e2e/data-loading/basic.data.mts b/__tests__/e2e/data-loading/basic.data.mts
index 56aab77e..526cb615 100644
--- a/__tests__/e2e/data-loading/basic.data.mts
+++ b/__tests__/e2e/data-loading/basic.data.mts
@@ -1,4 +1,5 @@
 import fs from 'node:fs'
+
 import { defineLoader } from 'vitepress'
 
 type Data = Record<string, boolean>[]
diff --git a/__tests__/e2e/dynamic-routes/[id].paths.ts b/__tests__/e2e/dynamic-routes/[id].paths.ts
index a1cb6fef..273f729c 100644
--- a/__tests__/e2e/dynamic-routes/[id].paths.ts
+++ b/__tests__/e2e/dynamic-routes/[id].paths.ts
@@ -1,4 +1,5 @@
 import { defineRoutes } from 'vitepress'
+
 import paths from './paths'
 
 export default defineRoutes({
diff --git a/__tests__/e2e/vitestGlobalSetup.ts b/__tests__/e2e/vitestGlobalSetup.ts
index 74596801..314da731 100644
--- a/__tests__/e2e/vitestGlobalSetup.ts
+++ b/__tests__/e2e/vitestGlobalSetup.ts
@@ -1,5 +1,6 @@
-import getPort from 'get-port'
 import type { Server } from 'node:net'
+
+import getPort from 'get-port'
 import { chromium, type BrowserServer } from 'playwright-chromium'
 import type { ViteDevServer } from 'vite'
 import { build, createServer, serve } from 'vitepress'
diff --git a/__tests__/init/init.test.ts b/__tests__/init/init.test.ts
index 11ea8c32..79f1bad5 100644
--- a/__tests__/init/init.test.ts
+++ b/__tests__/init/init.test.ts
@@ -1,8 +1,9 @@
-import getPort from 'get-port'
-import { nanoid } from 'nanoid'
 import { rm } from 'node:fs/promises'
 import path from 'node:path'
 import { fileURLToPath, URL } from 'node:url'
+
+import getPort from 'get-port'
+import { nanoid } from 'nanoid'
 import { chromium } from 'playwright-chromium'
 import { createServer, scaffold, ScaffoldThemeType } from 'vitepress'
 
diff --git a/__tests__/unit/node/contentLoader.test.ts b/__tests__/unit/node/contentLoader.test.ts
index 197745f6..9d0ce2ac 100644
--- a/__tests__/unit/node/contentLoader.test.ts
+++ b/__tests__/unit/node/contentLoader.test.ts
@@ -1,9 +1,10 @@
-import { resolveConfig } from 'node/config'
-import { createContentLoader } from 'node/contentLoader'
 import { mkdtemp, rm, writeFile } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import path from 'node:path'
 
+import { resolveConfig } from 'node/config'
+import { createContentLoader } from 'node/contentLoader'
+
 describe('node/contentLoader', () => {
   let root: string | undefined
 
diff --git a/__tests__/unit/node/markdown/plugins/image.test.ts b/__tests__/unit/node/markdown/plugins/image.test.ts
index c6a346cc..15bb4dbd 100644
--- a/__tests__/unit/node/markdown/plugins/image.test.ts
+++ b/__tests__/unit/node/markdown/plugins/image.test.ts
@@ -1,6 +1,7 @@
 import path from 'node:path'
-import { MarkdownItAsync } from 'markdown-it-async'
+
 import { attrs as attrsPlugin } from '@mdit/plugin-attrs'
+import { MarkdownItAsync } from 'markdown-it-async'
 import { imagePlugin, type Options } from 'node/markdown/plugins/image'
 
 const srcDir = path.resolve(import.meta.dirname, '../../../../e2e')
diff --git a/__tests__/unit/node/markdown/plugins/include.test.ts b/__tests__/unit/node/markdown/plugins/include.test.ts
index 053bd58e..3053459b 100644
--- a/__tests__/unit/node/markdown/plugins/include.test.ts
+++ b/__tests__/unit/node/markdown/plugins/include.test.ts
@@ -1,6 +1,7 @@
 import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import path from 'node:path'
+
 import {
   createMarkdownRenderer,
   disposeMdItInstance,
diff --git a/__tests__/unit/node/markdown/plugins/snippet.test.ts b/__tests__/unit/node/markdown/plugins/snippet.test.ts
index 50f389c1..f4ff5a35 100644
--- a/__tests__/unit/node/markdown/plugins/snippet.test.ts
+++ b/__tests__/unit/node/markdown/plugins/snippet.test.ts
@@ -1,6 +1,7 @@
 import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import path from 'node:path'
+
 import {
   createMarkdownRenderer,
   disposeMdItInstance,
diff --git a/__tests__/unit/node/markdownToVue.test.ts b/__tests__/unit/node/markdownToVue.test.ts
index 1d675f31..dd0d23e8 100644
--- a/__tests__/unit/node/markdownToVue.test.ts
+++ b/__tests__/unit/node/markdownToVue.test.ts
@@ -1,9 +1,10 @@
-import { resolveConfig } from 'node/config'
-import { createMarkdownToVueRenderFn } from 'node/markdownToVue'
 import { mkdtemp, rm, writeFile } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import path from 'node:path'
 
+import { resolveConfig } from 'node/config'
+import { createMarkdownToVueRenderFn } from 'node/markdownToVue'
+
 describe('node/markdownToVue', () => {
   let root: string | undefined
 
diff --git a/__tests__/unit/node/plugins/localSearchPlugin.test.ts b/__tests__/unit/node/plugins/localSearchPlugin.test.ts
index 86242ce9..0ecab64e 100644
--- a/__tests__/unit/node/plugins/localSearchPlugin.test.ts
+++ b/__tests__/unit/node/plugins/localSearchPlugin.test.ts
@@ -1,11 +1,12 @@
+import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+
 import MiniSearch from 'minisearch'
 import { resolveConfig } from 'node/config'
 import { disposeMdItInstance } from 'node/markdown/markdown'
 import { createMarkdownToVueRenderFn } from 'node/markdownToVue'
 import { localSearchPlugin } from 'node/plugins/localSearchPlugin'
-import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
-import { tmpdir } from 'node:os'
-import path from 'node:path'
 
 describe('node/plugins/localSearchPlugin', () => {
   let root: string | undefined
diff --git a/__tests__/unit/node/utils/fs.test.ts b/__tests__/unit/node/utils/fs.test.ts
index 7072a471..0d34c623 100644
--- a/__tests__/unit/node/utils/fs.test.ts
+++ b/__tests__/unit/node/utils/fs.test.ts
@@ -1,6 +1,7 @@
 import { mkdtemp, rm, writeFile } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import path from 'node:path'
+
 import { readFile, readTextFile, readTextFileSync } from 'node/utils/fs'
 
 describe('node/utils/fs', () => {
diff --git a/__tests__/unit/vitest.config.ts b/__tests__/unit/vitest.config.ts
index 93eb40e1..c39470e3 100644
--- a/__tests__/unit/vitest.config.ts
+++ b/__tests__/unit/vitest.config.ts
@@ -1,6 +1,7 @@
-import vue from '@vitejs/plugin-vue'
 import { dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
+
+import vue from '@vitejs/plugin-vue'
 import { defineConfig } from 'vitest/config'
 
 const dir = dirname(fileURLToPath(import.meta.url))
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 570f51e7..64158acf 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -9,6 +9,7 @@ import {
   localIconLoader
 } from 'vitepress-plugin-group-icons'
 import llmstxt from 'vitepress-plugin-llms'
+
 import { markdown as esMarkdown } from '../es/config.ts'
 import { markdown as faMarkdown } from '../fa/config.ts'
 import { markdown as jaMarkdown } from '../ja/config.ts'
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
index ef131dc0..40c519bc 100644
--- a/docs/.vitepress/theme/index.ts
+++ b/docs/.vitepress/theme/index.ts
@@ -1,6 +1,7 @@
 /// <reference types="vitepress/client" />
 
 import Theme from 'vitepress/theme'
+
 import 'virtual:group-icons.css'
 import './styles.css'
 
diff --git a/netlify.toml b/netlify.toml
index 5d56b3b2..051f3378 100644
--- a/netlify.toml
+++ b/netlify.toml
@@ -1,38 +1,38 @@
 [build.environment]
-  NODE_VERSION = "24"
-  PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD = "1"
+NODE_VERSION = "24"
+PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD = "1"
 
 [build]
-  publish = "docs/.vitepress/dist"
-  command = "pnpm docs:build && pnpm docs:lunaria:build"
+publish = "docs/.vitepress/dist"
+command = "pnpm docs:build && pnpm docs:lunaria:build"
 
 [[headers]]
-  for = "/assets/*"
-  [headers.values]
-    cache-control = '''
+for = "/assets/*"
+[headers.values]
+cache-control = '''
     max-age=31536000,
     immutable'''
 
 [[headers]]
-  for = "/_translations/*"
-  [headers.values]
-    x-robots-tag = "noindex"
+for = "/_translations/*"
+[headers.values]
+x-robots-tag = "noindex"
 
 [[redirects]]
-  from = "https://vitepress.vuejs.org/*"
-  to = "https://vitepress.dev/:splat"
-  force = true
+from = "https://vitepress.vuejs.org/*"
+to = "https://vitepress.dev/:splat"
+force = true
 
 [[redirects]]
-  from = "/guide/"
-  to = "/guide/getting-started"
+from = "/guide/"
+to = "/guide/getting-started"
 
 [[redirects]]
-  from = "/llms.md"
-  status = 301
-  to = "/llms.txt"
+from = "/llms.md"
+status = 301
+to = "/llms.txt"
 
 [[redirects]]
-  from = "/llms-full.md"
-  status = 301
-  to = "/llms-full.txt"
+from = "/llms-full.md"
+status = 301
+to = "/llms-full.txt"
diff --git a/rollup.config.ts b/rollup.config.ts
index 6685d654..cce223e5 100644
--- a/rollup.config.ts
+++ b/rollup.config.ts
@@ -1,14 +1,16 @@
+import { rm } from 'node:fs/promises'
+import { builtinModules } from 'node:module'
+import { fileURLToPath } from 'node:url'
+
 import alias from '@rollup/plugin-alias'
 import commonjs from '@rollup/plugin-commonjs'
 import json from '@rollup/plugin-json'
 import { nodeResolve } from '@rollup/plugin-node-resolve'
 import replace from '@rollup/plugin-replace'
-import { rm } from 'node:fs/promises'
-import { builtinModules } from 'node:module'
-import { fileURLToPath } from 'node:url'
 import { type RollupOptions, defineConfig } from 'rollup'
 import dts from 'rollup-plugin-dts'
 import esbuild from 'rollup-plugin-esbuild'
+
 import pkg from './package.json' with { type: 'json' }
 
 const DEV = !!process.env.DEV
diff --git a/scripts/copyClient.ts b/scripts/copyClient.ts
index 7257748e..852bdb91 100644
--- a/scripts/copyClient.ts
+++ b/scripts/copyClient.ts
@@ -1,4 +1,5 @@
 import { cp } from 'node:fs/promises'
+
 import { globSync } from 'tinyglobby'
 
 function toDest(file: string) {
diff --git a/scripts/copyShared.ts b/scripts/copyShared.ts
index c9512bd1..d73257b1 100644
--- a/scripts/copyShared.ts
+++ b/scripts/copyShared.ts
@@ -1,4 +1,5 @@
 import { cp } from 'node:fs/promises'
+
 import { globSync } from 'tinyglobby'
 
 globSync(['src/shared/**/*.ts']).forEach(async (file) => {
diff --git a/scripts/release.ts b/scripts/release.ts
index 1164aba0..0d950707 100644
--- a/scripts/release.ts
+++ b/scripts/release.ts
@@ -1,11 +1,13 @@
-import { spawn } from 'cross-spawn'
 import type { SpawnOptions } from 'node:child_process'
 import { once } from 'node:events'
 import fs from 'node:fs'
 import { resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
+
 import * as prompts from '@clack/prompts'
+import { spawn } from 'cross-spawn'
 import semver from 'semver'
+
 import { version as currentVersion } from '../package.json' with { type: 'json' }
 
 const { inc: _inc, valid } = semver
diff --git a/scripts/watchAndCopy.ts b/scripts/watchAndCopy.ts
index 8f4b6679..ce725678 100644
--- a/scripts/watchAndCopy.ts
+++ b/scripts/watchAndCopy.ts
@@ -1,5 +1,6 @@
-import { watch } from 'chokidar'
 import { cp, rm } from 'node:fs/promises'
+
+import { watch } from 'chokidar'
 import { normalizePath } from 'vite'
 
 function toClientAndNode(method: 'copy' | 'remove', file: string) {
diff --git a/src/client/app/components/Content.ts b/src/client/app/components/Content.ts
index d21ed2aa..ec950d57 100644
--- a/src/client/app/components/Content.ts
+++ b/src/client/app/components/Content.ts
@@ -1,5 +1,6 @@
 import { useData, useRoute } from 'vitepress'
 import { defineComponent, h, watch } from 'vue'
+
 import { contentUpdatedCallbacks } from '../utils'
 
 const runCbs = () => contentUpdatedCallbacks.forEach((fn) => fn())
diff --git a/src/client/app/composables/copyCode.ts b/src/client/app/composables/copyCode.ts
index f0fc998d..7a52e621 100644
--- a/src/client/app/composables/copyCode.ts
+++ b/src/client/app/composables/copyCode.ts
@@ -1,4 +1,5 @@
 import { inBrowser } from 'vitepress'
+
 import { isShell } from '../../shared'
 
 const ignoredNodes = ['.vp-copy-ignore', '.diff.remove'].join(', ')
diff --git a/src/client/app/composables/head.ts b/src/client/app/composables/head.ts
index 2b63d5cf..74a041c5 100644
--- a/src/client/app/composables/head.ts
+++ b/src/client/app/composables/head.ts
@@ -1,4 +1,5 @@
 import { watchEffect, type Ref } from 'vue'
+
 import {
   createTitle,
   mergeHead,
diff --git a/src/client/app/composables/preFetch.ts b/src/client/app/composables/preFetch.ts
index 003d54c9..d251f9b3 100644
--- a/src/client/app/composables/preFetch.ts
+++ b/src/client/app/composables/preFetch.ts
@@ -2,6 +2,7 @@
 // https://github.com/GoogleChromeLabs/quicklink
 
 import { onMounted, onUnmounted, watch } from 'vue'
+
 import { useRoute } from '../router'
 import { inBrowser, pathToFile } from '../utils'
 
diff --git a/src/client/app/data.ts b/src/client/app/data.ts
index 7af33182..65f17f8a 100644
--- a/src/client/app/data.ts
+++ b/src/client/app/data.ts
@@ -9,6 +9,7 @@ import {
   type InjectionKey,
   type Ref
 } from 'vue'
+
 import {
   APPEARANCE_KEY,
   createTitle,
diff --git a/src/client/app/devtools.ts b/src/client/app/devtools.ts
index cbc0fd3b..8b23341b 100644
--- a/src/client/app/devtools.ts
+++ b/src/client/app/devtools.ts
@@ -1,5 +1,6 @@
 import { setupDevToolsPlugin } from '@vue/devtools-api'
 import type { App } from 'vue'
+
 import type { VitePressData } from './data'
 import type { Router } from './router'
 
diff --git a/src/client/app/index.ts b/src/client/app/index.ts
index 178c98b1..15f489e3 100644
--- a/src/client/app/index.ts
+++ b/src/client/app/index.ts
@@ -8,6 +8,7 @@ import {
   watchEffect,
   type App
 } from 'vue'
+
 import { ClientOnly } from './components/ClientOnly'
 import { Content } from './components/Content'
 import { useCodeGroups } from './composables/codeGroups'
diff --git a/src/client/app/router.ts b/src/client/app/router.ts
index 818f46fb..0cb0242e 100644
--- a/src/client/app/router.ts
+++ b/src/client/app/router.ts
@@ -1,5 +1,6 @@
 import type { Component, InjectionKey } from 'vue'
 import { inject, markRaw, nextTick, reactive, readonly } from 'vue'
+
 import type { Awaitable, PageData, PageDataPayload, Route } from '../shared'
 import { notFoundPageData, treatAsHtml } from '../shared'
 import { siteDataRef } from './data'
diff --git a/src/client/app/ssr.ts b/src/client/app/ssr.ts
index 338d4aad..d8a4f05b 100644
--- a/src/client/app/ssr.ts
+++ b/src/client/app/ssr.ts
@@ -1,5 +1,6 @@
 // entry for SSR
 import { renderToString } from 'vue/server-renderer'
+
 import type { SSGContext } from '../shared'
 import { createApp } from './index'
 
diff --git a/src/client/app/theme.ts b/src/client/app/theme.ts
index 0658ce1d..8c3fd2c1 100644
--- a/src/client/app/theme.ts
+++ b/src/client/app/theme.ts
@@ -1,4 +1,5 @@
 import type { App, Component, Ref } from 'vue'
+
 import type { Awaitable, SiteData } from '../shared'
 import type { Router } from './router'
 
diff --git a/src/client/app/utils.ts b/src/client/app/utils.ts
index 89e778ab..c80080f1 100644
--- a/src/client/app/utils.ts
+++ b/src/client/app/utils.ts
@@ -1,5 +1,6 @@
 import { tryOnUnmounted } from '@vueuse/core'
 import { h, onMounted, shallowRef, type AsyncComponentLoader } from 'vue'
+
 import {
   EXTERNAL_URL_RE,
   inBrowser,
diff --git a/src/client/theme-default/Layout.vue b/src/client/theme-default/Layout.vue
index f8df6761..d13266a5 100644
--- a/src/client/theme-default/Layout.vue
+++ b/src/client/theme-default/Layout.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed, provide, useSlots } from 'vue'
+
 import VPBackdrop from './components/VPBackdrop.vue'
 import VPContent from './components/VPContent.vue'
 import VPFooter from './components/VPFooter.vue'
diff --git a/src/client/theme-default/NotFound.vue b/src/client/theme-default/NotFound.vue
index 07d278b5..5805ac80 100644
--- a/src/client/theme-default/NotFound.vue
+++ b/src/client/theme-default/NotFound.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { withBase } from 'vitepress'
+
 import { useData } from './composables/data'
 import { useLangs } from './composables/langs'
 
@@ -84,9 +85,7 @@ const { currentLang } = useLangs()
   font-size: 0.875rem;
   font-weight: 500;
   color: var(--vp-c-brand-1);
-  transition:
-    border-color 0.25s,
-    color 0.25s;
+  transition: border-color 0.25s, color 0.25s;
 }
 
 .link:hover {
diff --git a/src/client/theme-default/components/VPAlgoliaSearchBox.vue b/src/client/theme-default/components/VPAlgoliaSearchBox.vue
index 3d56c670..0ef69015 100644
--- a/src/client/theme-default/components/VPAlgoliaSearchBox.vue
+++ b/src/client/theme-default/components/VPAlgoliaSearchBox.vue
@@ -4,6 +4,7 @@ import type { SidepanelInstance } from '@docsearch/sidepanel-js'
 import { inBrowser, useRouter } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { nextTick, onUnmounted, watch } from 'vue'
+
 import type { DocSearchAskAi } from '../../../../types/docsearch'
 import { useData } from '../composables/data'
 import {
diff --git a/src/client/theme-default/components/VPBackdrop.vue b/src/client/theme-default/components/VPBackdrop.vue
index 9ae83fbe..bdb2929f 100644
--- a/src/client/theme-default/components/VPBackdrop.vue
+++ b/src/client/theme-default/components/VPBackdrop.vue
@@ -30,7 +30,7 @@ defineProps<{
 }
 
 .VPBackdrop.fade-leave-active {
-  transition-duration: .25s;
+  transition-duration: 0.25s;
 }
 
 @media (min-width: 80rem) {
diff --git a/src/client/theme-default/components/VPButton.vue b/src/client/theme-default/components/VPButton.vue
index ac062d7a..51b7e9ec 100644
--- a/src/client/theme-default/components/VPButton.vue
+++ b/src/client/theme-default/components/VPButton.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed } from 'vue'
+
 import { EXTERNAL_URL_RE } from '../../shared'
 import { normalizeLink } from '../support/utils'
 
@@ -9,8 +10,8 @@ interface Props {
   theme?: 'brand' | 'alt' | 'sponsor'
   text?: string
   href?: string
-  target?: string;
-  rel?: string;
+  target?: string
+  rel?: string
 }
 const props = withDefaults(defineProps<Props>(), {
   size: 'medium',
diff --git a/src/client/theme-default/components/VPCarbonAds.vue b/src/client/theme-default/components/VPCarbonAds.vue
index f79d546d..51a617f8 100644
--- a/src/client/theme-default/components/VPCarbonAds.vue
+++ b/src/client/theme-default/components/VPCarbonAds.vue
@@ -22,7 +22,7 @@ function init() {
     const params = new URLSearchParams({
       serve: carbonOptions.code,
       placement: carbonOptions.placement,
-      format: carbonOptions?.format || 'classic',
+      format: carbonOptions?.format || 'classic'
     })
     const s = document.createElement('script')
     s.id = '_carbonads_js'
diff --git a/src/client/theme-default/components/VPContent.vue b/src/client/theme-default/components/VPContent.vue
index 67555b54..ef58f217 100644
--- a/src/client/theme-default/components/VPContent.vue
+++ b/src/client/theme-default/components/VPContent.vue
@@ -1,8 +1,9 @@
 <script setup lang="ts">
 import { resolveDynamicComponent } from 'vue'
-import NotFound from '../NotFound.vue'
+
 import { useData } from '../composables/data'
 import { useLayout } from '../composables/layout'
+import NotFound from '../NotFound.vue'
 import VPDoc from './VPDoc.vue'
 import VPHome from './VPHome.vue'
 import VPPage from './VPPage.vue'
diff --git a/src/client/theme-default/components/VPDoc.vue b/src/client/theme-default/components/VPDoc.vue
index 527ffb08..b0042bbd 100644
--- a/src/client/theme-default/components/VPDoc.vue
+++ b/src/client/theme-default/components/VPDoc.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import { useRoute } from 'vitepress'
 import { computed } from 'vue'
+
 import { useData } from '../composables/data'
 import { useLayout } from '../composables/layout'
 import VPDocAside from './VPDocAside.vue'
@@ -22,7 +23,7 @@ const pageName = computed(() =>
   >
     <slot name="doc-top" />
     <div class="container">
-      <div v-if="hasAside" class="aside" :class="{'left-aside': leftAside}">
+      <div v-if="hasAside" class="aside" :class="{ 'left-aside': leftAside }">
         <div class="aside-curtain" />
         <div class="aside-container">
           <div class="aside-content">
diff --git a/src/client/theme-default/components/VPDocAsideOutline.vue b/src/client/theme-default/components/VPDocAsideOutline.vue
index 42207e1b..2a5ba00b 100644
--- a/src/client/theme-default/components/VPDocAsideOutline.vue
+++ b/src/client/theme-default/components/VPDocAsideOutline.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { ref } from 'vue'
+
 import { useData } from '../composables/data'
 import { useLayout } from '../composables/layout'
 import { resolveTitle, useActiveAnchor } from '../composables/outline'
@@ -66,10 +67,7 @@ useActiveAnchor(container, marker)
   border-radius: 2px;
   height: 1.125rem;
   background-color: var(--vp-c-brand-1);
-  transition:
-    top 0.25s cubic-bezier(0, 1, 0.5, 1),
-    background-color 0.5s,
-    opacity 0.25s;
+  transition: top 0.25s cubic-bezier(0, 1, 0.5, 1), background-color 0.5s, opacity 0.25s;
 }
 
 .outline-title {
diff --git a/src/client/theme-default/components/VPDocFooter.vue b/src/client/theme-default/components/VPDocFooter.vue
index 9b74fc38..405e9815 100644
--- a/src/client/theme-default/components/VPDocFooter.vue
+++ b/src/client/theme-default/components/VPDocFooter.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed } from 'vue'
+
 import { useData } from '../composables/data'
 import { useEditLink } from '../composables/edit-link'
 import { usePrevNext } from '../composables/prev-next'
diff --git a/src/client/theme-default/components/VPDocFooterLastUpdated.vue b/src/client/theme-default/components/VPDocFooterLastUpdated.vue
index d2601eec..3002d897 100644
--- a/src/client/theme-default/components/VPDocFooterLastUpdated.vue
+++ b/src/client/theme-default/components/VPDocFooterLastUpdated.vue
@@ -1,6 +1,13 @@
 <script setup lang="ts">
 import { useNavigatorLanguage } from '@vueuse/core'
-import { computed, onMounted, shallowRef, useTemplateRef, watchEffect } from 'vue'
+import {
+  computed,
+  onMounted,
+  shallowRef,
+  useTemplateRef,
+  watchEffect
+} from 'vue'
+
 import { useData } from '../composables/data'
 
 const { theme, page, lang: pageLang } = useData()
diff --git a/src/client/theme-default/components/VPFeature.vue b/src/client/theme-default/components/VPFeature.vue
index a35fe9ee..94fb01b8 100644
--- a/src/client/theme-default/components/VPFeature.vue
+++ b/src/client/theme-default/components/VPFeature.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
+
 import VPImage from './VPImage.vue'
 import VPLink from './VPLink.vue'
 
diff --git a/src/client/theme-default/components/VPFeatures.vue b/src/client/theme-default/components/VPFeatures.vue
index 880d2059..0d777c10 100644
--- a/src/client/theme-default/components/VPFeatures.vue
+++ b/src/client/theme-default/components/VPFeatures.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed } from 'vue'
+
 import VPFeature from './VPFeature.vue'
 
 export interface Feature {
diff --git a/src/client/theme-default/components/VPFlyout.vue b/src/client/theme-default/components/VPFlyout.vue
index 32139556..3b2e58af 100644
--- a/src/client/theme-default/components/VPFlyout.vue
+++ b/src/client/theme-default/components/VPFlyout.vue
@@ -1,6 +1,7 @@
 <script lang="ts" setup generic="T extends DefaultTheme.NavItem">
 import type { DefaultTheme } from 'vitepress/theme'
 import { ref } from 'vue'
+
 import { useFlyout } from '../composables/flyout'
 import VPMenu from './VPMenu.vue'
 
diff --git a/src/client/theme-default/components/VPFooter.vue b/src/client/theme-default/components/VPFooter.vue
index fa2ac314..669846a6 100644
--- a/src/client/theme-default/components/VPFooter.vue
+++ b/src/client/theme-default/components/VPFooter.vue
@@ -7,10 +7,22 @@ const { hasSidebar } = useLayout()
 </script>
 
 <template>
-  <footer v-if="theme.footer && frontmatter.footer !== false" class="VPFooter" :class="{ 'has-sidebar': hasSidebar }">
+  <footer
+    v-if="theme.footer && frontmatter.footer !== false"
+    class="VPFooter"
+    :class="{ 'has-sidebar': hasSidebar }"
+  >
     <div class="container">
-      <p v-if="theme.footer.message" class="message" v-html="theme.footer.message"></p>
-      <p v-if="theme.footer.copyright" class="copyright" v-html="theme.footer.copyright"></p>
+      <p
+        v-if="theme.footer.message"
+        class="message"
+        v-html="theme.footer.message"
+      ></p>
+      <p
+        v-if="theme.footer.copyright"
+        class="copyright"
+        v-html="theme.footer.copyright"
+      ></p>
     </div>
   </footer>
 </template>
diff --git a/src/client/theme-default/components/VPHero.vue b/src/client/theme-default/components/VPHero.vue
index ca3ccc0c..895de45f 100644
--- a/src/client/theme-default/components/VPHero.vue
+++ b/src/client/theme-default/components/VPHero.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed, inject } from 'vue'
+
 import { layoutInfoInjectionKey } from '../composables/layout'
 import VPButton from './VPButton.vue'
 import VPImage from './VPImage.vue'
diff --git a/src/client/theme-default/components/VPHome.vue b/src/client/theme-default/components/VPHome.vue
index e9526c98..b5cd56c7 100644
--- a/src/client/theme-default/components/VPHome.vue
+++ b/src/client/theme-default/components/VPHome.vue
@@ -8,11 +8,10 @@ const { frontmatter, theme } = useData()
 </script>
 
 <template>
-  <div 
-    class="VPHome" 
-    :class="{
-      'external-link-icon-enabled': theme.externalLinkIcon
-    }">
+  <div
+    class="VPHome"
+    :class="{ 'external-link-icon-enabled': theme.externalLinkIcon }"
+  >
     <slot name="home-hero-before" />
     <VPHomeHero>
       <template #home-hero-info-before><slot name="home-hero-info-before" /></template>
diff --git a/src/client/theme-default/components/VPImage.vue b/src/client/theme-default/components/VPImage.vue
index 0a014d3c..e2d60621 100644
--- a/src/client/theme-default/components/VPImage.vue
+++ b/src/client/theme-default/components/VPImage.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
-import type { DefaultTheme } from 'vitepress/theme'
 import { withBase } from 'vitepress'
+import type { DefaultTheme } from 'vitepress/theme'
 
 defineProps<{
   image: DefaultTheme.ThemeableImage
diff --git a/src/client/theme-default/components/VPLink.vue b/src/client/theme-default/components/VPLink.vue
index 36977697..458d2139 100644
--- a/src/client/theme-default/components/VPLink.vue
+++ b/src/client/theme-default/components/VPLink.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import { computed } from 'vue'
+
 import { isLinkExternal, normalizeLink } from '../support/utils'
 
 const props = withDefaults(defineProps<{
@@ -10,7 +11,7 @@ const props = withDefaults(defineProps<{
   target?: string
   rel?: string
 }>(), {
-  external: undefined,
+  external: undefined
 })
 
 const tag = computed(() => props.tag ?? (props.href ? 'a' : 'span'))
diff --git a/src/client/theme-default/components/VPLocalNav.vue b/src/client/theme-default/components/VPLocalNav.vue
index 2d38ea62..53f16740 100644
--- a/src/client/theme-default/components/VPLocalNav.vue
+++ b/src/client/theme-default/components/VPLocalNav.vue
@@ -1,6 +1,7 @@
 <script lang="ts" setup>
 import { useWindowScroll } from '@vueuse/core'
 import { computed, onMounted, ref } from 'vue'
+
 import { useData } from '../composables/data'
 import { useLayout } from '../composables/layout'
 import VPLocalNavOutlineDropdown from './VPLocalNavOutlineDropdown.vue'
diff --git a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
index 8a5eaa21..349f6613 100644
--- a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
+++ b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
@@ -3,6 +3,7 @@ import { onKeyStroke } from '@vueuse/core'
 import { onContentUpdated } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { nextTick, ref, watch } from 'vue'
+
 import { useData } from '../composables/data'
 import { resolveTitle } from '../composables/outline'
 import { useBodyScrollLock } from '../composables/scroll-lock'
diff --git a/src/client/theme-default/components/VPLocalSearchBox.vue b/src/client/theme-default/components/VPLocalSearchBox.vue
index 8bde5384..34088590 100644
--- a/src/client/theme-default/components/VPLocalSearchBox.vue
+++ b/src/client/theme-default/components/VPLocalSearchBox.vue
@@ -25,6 +25,7 @@ import {
   watchEffect,
   type Ref
 } from 'vue'
+
 import type { LocalSearchTranslations } from '../../../../types/local-search'
 import { pathToFile } from '../../app/utils'
 import { escapeRegExp } from '../../shared'
@@ -486,7 +487,7 @@ function onMouseMove(e: MouseEvent) {
           <input
             ref="searchInput"
             v-model="filterText"
-            :aria-activedescendant="selectedIndex > -1 ? ('localsearch-item-' + selectedIndex) : undefined"
+            :aria-activedescendant="selectedIndex > -1 ? 'localsearch-item-' + selectedIndex : undefined"
             aria-autocomplete="both"
             :aria-controls="results?.length ? 'localsearch-list' : undefined"
             aria-labelledby="localsearch-label"
@@ -593,8 +594,7 @@ function onMouseMove(e: MouseEvent) {
             v-if="filterText && !results.length && enableNoResults"
             class="no-results"
           >
-            {{ translate('modal.noResultsText') }} "<strong>{{ filterText }}</strong
-            >"
+            {{ translate('modal.noResultsText') }} "<strong>{{ filterText }}</strong>"
           </li>
         </ul>
 
diff --git a/src/client/theme-default/components/VPMenu.vue b/src/client/theme-default/components/VPMenu.vue
index 02776639..5a7ad4a2 100644
--- a/src/client/theme-default/components/VPMenu.vue
+++ b/src/client/theme-default/components/VPMenu.vue
@@ -1,7 +1,8 @@
 <script lang="ts" setup generic="T extends DefaultTheme.NavItem">
 import type { DefaultTheme } from 'vitepress/theme'
-import VPMenuLink from './VPMenuLink.vue'
+
 import VPMenuGroup from './VPMenuGroup.vue'
+import VPMenuLink from './VPMenuLink.vue'
 
 defineProps<{
   items?: T[]
diff --git a/src/client/theme-default/components/VPMenuGroup.vue b/src/client/theme-default/components/VPMenuGroup.vue
index 5cd52688..b98138bc 100644
--- a/src/client/theme-default/components/VPMenuGroup.vue
+++ b/src/client/theme-default/components/VPMenuGroup.vue
@@ -1,5 +1,15 @@
-<script lang="ts" setup generic="T extends (DefaultTheme.NavItemComponent | DefaultTheme.NavItemChildren | DefaultTheme.NavItemWithLink)">
+<script
+  lang="ts"
+  setup
+  generic="
+    T extends
+      | DefaultTheme.NavItemComponent
+      | DefaultTheme.NavItemChildren
+      | DefaultTheme.NavItemWithLink
+  "
+>
 import type { DefaultTheme } from 'vitepress/theme'
+
 import VPMenuLink from './VPMenuLink.vue'
 
 defineProps<{
diff --git a/src/client/theme-default/components/VPMenuLink.vue b/src/client/theme-default/components/VPMenuLink.vue
index 01c23f26..89129dd6 100644
--- a/src/client/theme-default/components/VPMenuLink.vue
+++ b/src/client/theme-default/components/VPMenuLink.vue
@@ -2,6 +2,7 @@
 import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed } from 'vue'
+
 import { isActive } from '../../shared'
 import VPLink from './VPLink.vue'
 
@@ -62,9 +63,7 @@ defineOptions({ inheritAttrs: false })
   color: var(--vp-c-text-1);
   text-align: left;
   white-space: nowrap;
-  transition:
-    background-color 0.25s,
-    color 0.25s;
+  transition: background-color 0.25s, color 0.25s;
 }
 
 .link:hover {
diff --git a/src/client/theme-default/components/VPNav.vue b/src/client/theme-default/components/VPNav.vue
index 6392dcec..7c97b1d8 100644
--- a/src/client/theme-default/components/VPNav.vue
+++ b/src/client/theme-default/components/VPNav.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import { inBrowser } from 'vitepress'
 import { computed, provide, watchEffect } from 'vue'
+
 import { useData } from '../composables/data'
 import { navInjectionKey, useNav } from '../composables/nav'
 import VPNavBar from './VPNavBar.vue'
diff --git a/src/client/theme-default/components/VPNavBar.vue b/src/client/theme-default/components/VPNavBar.vue
index b7ff73e7..1c566aea 100644
--- a/src/client/theme-default/components/VPNavBar.vue
+++ b/src/client/theme-default/components/VPNavBar.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import { useWindowScroll } from '@vueuse/core'
+
 import { useLayout } from '../composables/layout'
 import VPNavBarAppearance from './VPNavBarAppearance.vue'
 import VPNavBarExtra from './VPNavBarExtra.vue'
diff --git a/src/client/theme-default/components/VPNavBarExtra.vue b/src/client/theme-default/components/VPNavBarExtra.vue
index cba5333b..0e4cc1fa 100644
--- a/src/client/theme-default/components/VPNavBarExtra.vue
+++ b/src/client/theme-default/components/VPNavBarExtra.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import { computed } from 'vue'
+
 import { useData } from '../composables/data'
 import { useLangs } from '../composables/langs'
 import VPFlyout from './VPFlyout.vue'
diff --git a/src/client/theme-default/components/VPNavBarHamburger.vue b/src/client/theme-default/components/VPNavBarHamburger.vue
index dcb47365..9632d80d 100644
--- a/src/client/theme-default/components/VPNavBarHamburger.vue
+++ b/src/client/theme-default/components/VPNavBarHamburger.vue
@@ -60,7 +60,7 @@ defineEmits<{
 .VPNavBarHamburger.active:hover .middle,
 .VPNavBarHamburger.active:hover .bottom {
   background-color: var(--vp-c-text-2);
-  transition: top .25s, background-color .25s, transform .25s;
+  transition: top 0.25s, background-color 0.25s, transform 0.25s;
 }
 
 .top,
@@ -70,7 +70,7 @@ defineEmits<{
   width: 1rem;
   height: 0.125rem;
   background-color: var(--vp-c-text-1);
-  transition: top .25s, background-color .5s, transform .25s;
+  transition: top 0.25s, background-color 0.5s, transform 0.25s;
 }
 
 .top    { top: 0; left: 0; transform: translateX(0); }
diff --git a/src/client/theme-default/components/VPNavBarMenuGroup.vue b/src/client/theme-default/components/VPNavBarMenuGroup.vue
index 61004f3f..b26cfdf2 100644
--- a/src/client/theme-default/components/VPNavBarMenuGroup.vue
+++ b/src/client/theme-default/components/VPNavBarMenuGroup.vue
@@ -2,6 +2,7 @@
 import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed } from 'vue'
+
 import { isActive } from '../../shared'
 import VPFlyout from './VPFlyout.vue'
 
diff --git a/src/client/theme-default/components/VPNavBarMenuLink.vue b/src/client/theme-default/components/VPNavBarMenuLink.vue
index c7a9982a..b5617da8 100644
--- a/src/client/theme-default/components/VPNavBarMenuLink.vue
+++ b/src/client/theme-default/components/VPNavBarMenuLink.vue
@@ -2,6 +2,7 @@
 import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed } from 'vue'
+
 import { isActive } from '../../shared'
 import VPLink from './VPLink.vue'
 
diff --git a/src/client/theme-default/components/VPNavBarSearch.vue b/src/client/theme-default/components/VPNavBarSearch.vue
index c6e3af71..4205f6ea 100644
--- a/src/client/theme-default/components/VPNavBarSearch.vue
+++ b/src/client/theme-default/components/VPNavBarSearch.vue
@@ -2,6 +2,7 @@
 import { onKeyStroke } from '@vueuse/core'
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed, defineAsyncComponent, onMounted, ref } from 'vue'
+
 import { useData } from '../composables/data'
 import { resolveMode, resolveOptionsForLanguage } from '../support/docsearch'
 import { smartComputed } from '../support/reactivity'
diff --git a/src/client/theme-default/components/VPNavBarTitle.vue b/src/client/theme-default/components/VPNavBarTitle.vue
index d27cf7ee..53b8f53d 100644
--- a/src/client/theme-default/components/VPNavBarTitle.vue
+++ b/src/client/theme-default/components/VPNavBarTitle.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed } from 'vue'
+
 import { useData } from '../composables/data'
 import { useLangs } from '../composables/langs'
 import { useLayout } from '../composables/layout'
diff --git a/src/client/theme-default/components/VPNavScreenMenuGroup.vue b/src/client/theme-default/components/VPNavScreenMenuGroup.vue
index 0a29618e..f45f9a92 100644
--- a/src/client/theme-default/components/VPNavScreenMenuGroup.vue
+++ b/src/client/theme-default/components/VPNavScreenMenuGroup.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import { computed, ref } from 'vue'
+
 import VPNavScreenMenuGroupLink from './VPNavScreenMenuGroupLink.vue'
 import VPNavScreenMenuGroupSection from './VPNavScreenMenuGroupSection.vue'
 
diff --git a/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue b/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
index 4d7acb70..c2364a0d 100644
--- a/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
+++ b/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
@@ -2,6 +2,7 @@
 import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed, inject } from 'vue'
+
 import { isActive } from '../../shared'
 import { navInjectionKey } from '../composables/nav'
 import VPLink from './VPLink.vue'
diff --git a/src/client/theme-default/components/VPNavScreenMenuGroupSection.vue b/src/client/theme-default/components/VPNavScreenMenuGroupSection.vue
index a30d9d42..1ad55857 100644
--- a/src/client/theme-default/components/VPNavScreenMenuGroupSection.vue
+++ b/src/client/theme-default/components/VPNavScreenMenuGroupSection.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import type { DefaultTheme } from 'vitepress/theme'
+
 import VPNavScreenMenuGroupLink from './VPNavScreenMenuGroupLink.vue'
 
 defineProps<{
diff --git a/src/client/theme-default/components/VPNavScreenMenuLink.vue b/src/client/theme-default/components/VPNavScreenMenuLink.vue
index f24d64a8..b9bedefe 100644
--- a/src/client/theme-default/components/VPNavScreenMenuLink.vue
+++ b/src/client/theme-default/components/VPNavScreenMenuLink.vue
@@ -2,6 +2,7 @@
 import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed, inject } from 'vue'
+
 import { isActive } from '../../shared'
 import { navInjectionKey } from '../composables/nav'
 import VPLink from './VPLink.vue'
@@ -52,9 +53,7 @@ const { closeScreen } = inject(navInjectionKey)!
   font-size: 0.875rem;
   font-weight: 500;
   color: var(--vp-c-text-1);
-  transition:
-    border-color 0.25s,
-    color 0.25s;
+  transition: border-color 0.25s, color 0.25s;
 }
 
 .VPNavScreenMenuLink:hover {
diff --git a/src/client/theme-default/components/VPNavScreenTranslations.vue b/src/client/theme-default/components/VPNavScreenTranslations.vue
index 13878d89..369c0f74 100644
--- a/src/client/theme-default/components/VPNavScreenTranslations.vue
+++ b/src/client/theme-default/components/VPNavScreenTranslations.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { ref } from 'vue'
+
 import { useLangs } from '../composables/langs'
 import VPLink from './VPLink.vue'
 
diff --git a/src/client/theme-default/components/VPSidebar.vue b/src/client/theme-default/components/VPSidebar.vue
index 594f78d1..4d247d53 100644
--- a/src/client/theme-default/components/VPSidebar.vue
+++ b/src/client/theme-default/components/VPSidebar.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import { ref, watch } from 'vue'
+
 import { useLayout } from '../composables/layout'
 import { useBodyScrollLock } from '../composables/scroll-lock'
 import VPSidebarGroup from './VPSidebarGroup.vue'
@@ -87,8 +88,7 @@ watch(
   opacity: 1;
   visibility: visible;
   transform: translateX(0);
-  transition: opacity 0.25s,
-    transform 0.5s cubic-bezier(0.19, 1, 0.22, 1);
+  transition: opacity 0.25s, transform 0.5s cubic-bezier(0.19, 1, 0.22, 1);
 }
 
 .dark .VPSidebar {
diff --git a/src/client/theme-default/components/VPSidebarGroup.vue b/src/client/theme-default/components/VPSidebarGroup.vue
index b3221c9a..b46aa923 100644
--- a/src/client/theme-default/components/VPSidebarGroup.vue
+++ b/src/client/theme-default/components/VPSidebarGroup.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
 import { onBeforeUnmount, onMounted, ref } from 'vue'
+
 import VPSidebarItem from './VPSidebarItem.vue'
 
 defineProps<{
diff --git a/src/client/theme-default/components/VPSidebarItem.vue b/src/client/theme-default/components/VPSidebarItem.vue
index fe268a63..23454817 100644
--- a/src/client/theme-default/components/VPSidebarItem.vue
+++ b/src/client/theme-default/components/VPSidebarItem.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed } from 'vue'
+
 import { useSidebarItemControl } from '../composables/sidebar'
 import VPLink from './VPLink.vue'
 
@@ -212,7 +213,7 @@ function onItemClick() {
 }
 
 .VPSidebarItem.collapsed .caret-icon {
-  transform: rotate(0)/*rtl:rotate(180deg)*/;
+  transform: rotate(0) /*rtl:rotate(180deg)*/;
 }
 
 .VPSidebarItem.level-1 .items,
diff --git a/src/client/theme-default/components/VPSkipLink.vue b/src/client/theme-default/components/VPSkipLink.vue
index 668b4a49..d9aabb04 100644
--- a/src/client/theme-default/components/VPSkipLink.vue
+++ b/src/client/theme-default/components/VPSkipLink.vue
@@ -1,6 +1,7 @@
 <script lang="ts" setup>
 import { useRoute } from 'vitepress'
 import { ref, watch } from 'vue'
+
 import { useData } from '../composables/data'
 
 const { theme } = useData()
diff --git a/src/client/theme-default/components/VPSocialLink.vue b/src/client/theme-default/components/VPSocialLink.vue
index 837c211e..842e2c9a 100644
--- a/src/client/theme-default/components/VPSocialLink.vue
+++ b/src/client/theme-default/components/VPSocialLink.vue
@@ -1,6 +1,7 @@
 <script lang="ts" setup>
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed, nextTick, onMounted, ref, useSSRContext } from 'vue'
+
 import { isExternal, type SSGContext } from '../../shared'
 
 const props = defineProps<{
diff --git a/src/client/theme-default/components/VPSocialLinks.vue b/src/client/theme-default/components/VPSocialLinks.vue
index 0d006ccd..1919ed95 100644
--- a/src/client/theme-default/components/VPSocialLinks.vue
+++ b/src/client/theme-default/components/VPSocialLinks.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import type { DefaultTheme } from 'vitepress/theme'
+
 import VPSocialLink from './VPSocialLink.vue'
 
 withDefaults(defineProps<{
@@ -13,13 +14,7 @@ withDefaults(defineProps<{
 <template>
   <ul class="VPSocialLinks">
     <li v-for="{ link, icon, ariaLabel, target } in links" :key="link">
-      <VPSocialLink
-        :icon
-        :link
-        :ariaLabel
-        :target
-        :me
-      />
+      <VPSocialLink :icon :link :ariaLabel :target :me />
     </li>
   </ul>
 </template>
diff --git a/src/client/theme-default/components/VPSponsors.vue b/src/client/theme-default/components/VPSponsors.vue
index 00654512..9c71aeea 100644
--- a/src/client/theme-default/components/VPSponsors.vue
+++ b/src/client/theme-default/components/VPSponsors.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed } from 'vue'
+
 import type { GridSize } from '../composables/sponsor-grid'
 import type { Sponsor } from './VPSponsorsGrid.vue'
 import VPSponsorsGrid from './VPSponsorsGrid.vue'
diff --git a/src/client/theme-default/components/VPSponsorsGrid.vue b/src/client/theme-default/components/VPSponsorsGrid.vue
index 370e5af0..2f0b6071 100644
--- a/src/client/theme-default/components/VPSponsorsGrid.vue
+++ b/src/client/theme-default/components/VPSponsorsGrid.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { ref } from 'vue'
+
 import type { GridSize } from '../composables/sponsor-grid'
 import { useSponsorsGrid } from '../composables/sponsor-grid'
 
diff --git a/src/client/theme-default/components/VPSwitchAppearance.vue b/src/client/theme-default/components/VPSwitchAppearance.vue
index f44e0c47..9412fb20 100644
--- a/src/client/theme-default/components/VPSwitchAppearance.vue
+++ b/src/client/theme-default/components/VPSwitchAppearance.vue
@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import { inject, ref, watchPostEffect } from 'vue'
+
 import { useData } from '../composables/data'
 import VPSwitch from './VPSwitch.vue'
 
diff --git a/src/client/theme-default/components/VPTeamMembers.vue b/src/client/theme-default/components/VPTeamMembers.vue
index 0e474a2c..37dd0746 100644
--- a/src/client/theme-default/components/VPTeamMembers.vue
+++ b/src/client/theme-default/components/VPTeamMembers.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed } from 'vue'
+
 import VPTeamMembersItem from './VPTeamMembersItem.vue'
 
 interface Props {
diff --git a/src/client/theme-default/components/VPTeamMembersItem.vue b/src/client/theme-default/components/VPTeamMembersItem.vue
index bcca2e82..83ef8440 100644
--- a/src/client/theme-default/components/VPTeamMembersItem.vue
+++ b/src/client/theme-default/components/VPTeamMembersItem.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
+
 import VPLink from './VPLink.vue'
 import VPSocialLinks from './VPSocialLinks.vue'
 
diff --git a/src/client/theme-default/components/icons/VPIconAlignJustify.vue b/src/client/theme-default/components/icons/VPIconAlignJustify.vue
deleted file mode 100644
index 653dab13..00000000
--- a/src/client/theme-default/components/icons/VPIconAlignJustify.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M21,11H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,11,21,11z" />
-    <path d="M21,7H3C2.4,7,2,6.6,2,6s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,7,21,7z" />
-    <path d="M21,15H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,15,21,15z" />
-    <path d="M21,19H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,19,21,19z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconAlignLeft.vue b/src/client/theme-default/components/icons/VPIconAlignLeft.vue
deleted file mode 100644
index 8dc84eae..00000000
--- a/src/client/theme-default/components/icons/VPIconAlignLeft.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M17,11H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S17.6,11,17,11z" />
-    <path d="M21,7H3C2.4,7,2,6.6,2,6s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,7,21,7z" />
-    <path d="M21,15H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,15,21,15z" />
-    <path d="M17,19H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S17.6,19,17,19z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconAlignRight.vue b/src/client/theme-default/components/icons/VPIconAlignRight.vue
deleted file mode 100644
index 16cbb3c7..00000000
--- a/src/client/theme-default/components/icons/VPIconAlignRight.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M21,11H7c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S21.6,11,21,11z" />
-    <path d="M21,7H3C2.4,7,2,6.6,2,6s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,7,21,7z" />
-    <path d="M21,15H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,15,21,15z" />
-    <path d="M21,19H7c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S21.6,19,21,19z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconArrowLeft.vue b/src/client/theme-default/components/icons/VPIconArrowLeft.vue
deleted file mode 100644
index 3f65b866..00000000
--- a/src/client/theme-default/components/icons/VPIconArrowLeft.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-    <path
-      d="M19,11H7.4l5.3-5.3c0.4-0.4,0.4-1,0-1.4s-1-0.4-1.4,0l-7,7c-0.1,0.1-0.2,0.2-0.2,0.3c-0.1,0.2-0.1,0.5,0,0.8c0.1,0.1,0.1,0.2,0.2,0.3l7,7c0.2,0.2,0.5,0.3,0.7,0.3s0.5-0.1,0.7-0.3c0.4-0.4,0.4-1,0-1.4L7.4,13H19c0.6,0,1-0.4,1-1S19.6,11,19,11z"
-    />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconArrowRight.vue b/src/client/theme-default/components/icons/VPIconArrowRight.vue
deleted file mode 100644
index ed89263f..00000000
--- a/src/client/theme-default/components/icons/VPIconArrowRight.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-    <path
-      d="M19.9,12.4c0.1-0.2,0.1-0.5,0-0.8c-0.1-0.1-0.1-0.2-0.2-0.3l-7-7c-0.4-0.4-1-0.4-1.4,0s-0.4,1,0,1.4l5.3,5.3H5c-0.6,0-1,0.4-1,1s0.4,1,1,1h11.6l-5.3,5.3c-0.4,0.4-0.4,1,0,1.4c0.2,0.2,0.5,0.3,0.7,0.3s0.5-0.1,0.7-0.3l7-7C19.8,12.6,19.9,12.5,19.9,12.4z"
-    />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconChevronDown.vue b/src/client/theme-default/components/icons/VPIconChevronDown.vue
deleted file mode 100644
index d72f4ee8..00000000
--- a/src/client/theme-default/components/icons/VPIconChevronDown.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M12,16c-0.3,0-0.5-0.1-0.7-0.3l-6-6c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l5.3,5.3l5.3-5.3c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-6,6C12.5,15.9,12.3,16,12,16z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconChevronLeft.vue b/src/client/theme-default/components/icons/VPIconChevronLeft.vue
deleted file mode 100644
index 013eb7fd..00000000
--- a/src/client/theme-default/components/icons/VPIconChevronLeft.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M15,19c-0.3,0-0.5-0.1-0.7-0.3l-6-6c-0.4-0.4-0.4-1,0-1.4l6-6c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4L10.4,12l5.3,5.3c0.4,0.4,0.4,1,0,1.4C15.5,18.9,15.3,19,15,19z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconChevronRight.vue b/src/client/theme-default/components/icons/VPIconChevronRight.vue
deleted file mode 100644
index cf72418f..00000000
--- a/src/client/theme-default/components/icons/VPIconChevronRight.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M9,19c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l5.3-5.3L8.3,6.7c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l6,6c0.4,0.4,0.4,1,0,1.4l-6,6C9.5,18.9,9.3,19,9,19z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconChevronUp.vue b/src/client/theme-default/components/icons/VPIconChevronUp.vue
deleted file mode 100644
index 0b6a873e..00000000
--- a/src/client/theme-default/components/icons/VPIconChevronUp.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M18,16c-0.3,0-0.5-0.1-0.7-0.3L12,10.4l-5.3,5.3c-0.4,0.4-1,0.4-1.4,0s-0.4-1,0-1.4l6-6c0.4-0.4,1-0.4,1.4,0l6,6c0.4,0.4,0.4,1,0,1.4C18.5,15.9,18.3,16,18,16z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconEdit.vue b/src/client/theme-default/components/icons/VPIconEdit.vue
deleted file mode 100644
index f30a62dd..00000000
--- a/src/client/theme-default/components/icons/VPIconEdit.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-    <path d="M18,23H4c-1.7,0-3-1.3-3-3V6c0-1.7,1.3-3,3-3h7c0.6,0,1,0.4,1,1s-0.4,1-1,1H4C3.4,5,3,5.4,3,6v14c0,0.6,0.4,1,1,1h14c0.6,0,1-0.4,1-1v-7c0-0.6,0.4-1,1-1s1,0.4,1,1v7C21,21.7,19.7,23,18,23z" />
-    <path d="M8,17c-0.3,0-0.5-0.1-0.7-0.3C7,16.5,6.9,16.1,7,15.8l1-4c0-0.2,0.1-0.3,0.3-0.5l9.5-9.5c1.2-1.2,3.2-1.2,4.4,0c1.2,1.2,1.2,3.2,0,4.4l-9.5,9.5c-0.1,0.1-0.3,0.2-0.5,0.3l-4,1C8.2,17,8.1,17,8,17zM9.9,12.5l-0.5,2.1l2.1-0.5l9.3-9.3c0.4-0.4,0.4-1.1,0-1.6c-0.4-0.4-1.2-0.4-1.6,0l0,0L9.9,12.5z M18.5,2.5L18.5,2.5L18.5,2.5z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconHeart.vue b/src/client/theme-default/components/icons/VPIconHeart.vue
deleted file mode 100644
index d408828f..00000000
--- a/src/client/theme-default/components/icons/VPIconHeart.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-    <path d="M12,22.2c-0.3,0-0.5-0.1-0.7-0.3l-8.8-8.8c-2.5-2.5-2.5-6.7,0-9.2c2.5-2.5,6.7-2.5,9.2,0L12,4.3l0.4-0.4c0,0,0,0,0,0C13.6,2.7,15.2,2,16.9,2c0,0,0,0,0,0c1.7,0,3.4,0.7,4.6,1.9l0,0c1.2,1.2,1.9,2.9,1.9,4.6c0,1.7-0.7,3.4-1.9,4.6l-8.8,8.8C12.5,22.1,12.3,22.2,12,22.2zM7,4C5.9,4,4.7,4.4,3.9,5.3c-1.8,1.8-1.8,4.6,0,6.4l8.1,8.1l8.1-8.1c0.9-0.9,1.3-2,1.3-3.2c0-1.2-0.5-2.3-1.3-3.2l0,0C19.3,4.5,18.2,4,17,4c0,0,0,0,0,0c-1.2,0-2.3,0.5-3.2,1.3c0,0,0,0,0,0l-1.1,1.1c-0.4,0.4-1,0.4-1.4,0l-1.1-1.1C9.4,4.4,8.2,4,7,4z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconLanguages.vue b/src/client/theme-default/components/icons/VPIconLanguages.vue
deleted file mode 100644
index 71a728fc..00000000
--- a/src/client/theme-default/components/icons/VPIconLanguages.vue
+++ /dev/null
@@ -1,9 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M0 0h24v24H0z" fill="none"></path>
-    <path
-      d=" M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z "
-      class="css-c4d79v"
-    ></path>
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconMinus.vue b/src/client/theme-default/components/icons/VPIconMinus.vue
deleted file mode 100644
index e0229195..00000000
--- a/src/client/theme-default/components/icons/VPIconMinus.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-    <path d="M22,13H2a1,1,0,0,1,0-2H22a1,1,0,0,1,0,2Z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconMinusSquare.vue b/src/client/theme-default/components/icons/VPIconMinusSquare.vue
deleted file mode 100644
index 266ae3da..00000000
--- a/src/client/theme-default/components/icons/VPIconMinusSquare.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24">
-    <path d="M19,2H5C3.3,2,2,3.3,2,5v14c0,1.7,1.3,3,3,3h14c1.7,0,3-1.3,3-3V5C22,3.3,20.7,2,19,2zM20,19c0,0.6-0.4,1-1,1H5c-0.6,0-1-0.4-1-1V5c0-0.6,0.4-1,1-1h14c0.6,0,1,0.4,1,1V19z" />
-    <path d="M16,11H8c-0.6,0-1,0.4-1,1s0.4,1,1,1h8c0.6,0,1-0.4,1-1S16.6,11,16,11z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconMoon.vue b/src/client/theme-default/components/icons/VPIconMoon.vue
deleted file mode 100644
index a9b205c6..00000000
--- a/src/client/theme-default/components/icons/VPIconMoon.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M12.1,22c-0.3,0-0.6,0-0.9,0c-5.5-0.5-9.5-5.4-9-10.9c0.4-4.8,4.2-8.6,9-9c0.4,0,0.8,0.2,1,0.5c0.2,0.3,0.2,0.8-0.1,1.1c-2,2.7-1.4,6.4,1.3,8.4c2.1,1.6,5,1.6,7.1,0c0.3-0.2,0.7-0.3,1.1-0.1c0.3,0.2,0.5,0.6,0.5,1c-0.2,2.7-1.5,5.1-3.6,6.8C16.6,21.2,14.4,22,12.1,22zM9.3,4.4c-2.9,1-5,3.6-5.2,6.8c-0.4,4.4,2.8,8.3,7.2,8.7c2.1,0.2,4.2-0.4,5.8-1.8c1.1-0.9,1.9-2.1,2.4-3.4c-2.5,0.9-5.3,0.5-7.5-1.1C9.2,11.4,8.1,7.7,9.3,4.4z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconMoreHorizontal.vue b/src/client/theme-default/components/icons/VPIconMoreHorizontal.vue
deleted file mode 100644
index 6fa7fca2..00000000
--- a/src/client/theme-default/components/icons/VPIconMoreHorizontal.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <circle cx="12" cy="12" r="2" />
-    <circle cx="19" cy="12" r="2" />
-    <circle cx="5" cy="12" r="2" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconPlus.vue b/src/client/theme-default/components/icons/VPIconPlus.vue
deleted file mode 100644
index 74d9f695..00000000
--- a/src/client/theme-default/components/icons/VPIconPlus.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M18.9,10.9h-6v-6c0-0.6-0.4-1-1-1s-1,0.4-1,1v6h-6c-0.6,0-1,0.4-1,1s0.4,1,1,1h6v6c0,0.6,0.4,1,1,1s1-0.4,1-1v-6h6c0.6,0,1-0.4,1-1S19.5,10.9,18.9,10.9z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconPlusSquare.vue b/src/client/theme-default/components/icons/VPIconPlusSquare.vue
deleted file mode 100644
index 88e5b5cf..00000000
--- a/src/client/theme-default/components/icons/VPIconPlusSquare.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-<template>
-  <svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-    <path d="M19,2H5C3.3,2,2,3.3,2,5v14c0,1.7,1.3,3,3,3h14c1.7,0,3-1.3,3-3V5C22,3.3,20.7,2,19,2z M20,19c0,0.6-0.4,1-1,1H5c-0.6,0-1-0.4-1-1V5c0-0.6,0.4-1,1-1h14c0.6,0,1,0.4,1,1V19z" />
-    <path d="M16,11h-3V8c0-0.6-0.4-1-1-1s-1,0.4-1,1v3H8c-0.6,0-1,0.4-1,1s0.4,1,1,1h3v3c0,0.6,0.4,1,1,1s1-0.4,1-1v-3h3c0.6,0,1-0.4,1-1S16.6,11,16,11z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/components/icons/VPIconSun.vue b/src/client/theme-default/components/icons/VPIconSun.vue
deleted file mode 100644
index 8ecb25ba..00000000
--- a/src/client/theme-default/components/icons/VPIconSun.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-<template>
-  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
-    <path d="M12,18c-3.3,0-6-2.7-6-6s2.7-6,6-6s6,2.7,6,6S15.3,18,12,18zM12,8c-2.2,0-4,1.8-4,4c0,2.2,1.8,4,4,4c2.2,0,4-1.8,4-4C16,9.8,14.2,8,12,8z" />
-    <path d="M12,4c-0.6,0-1-0.4-1-1V1c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,3.6,12.6,4,12,4z" />
-    <path d="M12,24c-0.6,0-1-0.4-1-1v-2c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,23.6,12.6,24,12,24z" />
-    <path d="M5.6,6.6c-0.3,0-0.5-0.1-0.7-0.3L3.5,4.9c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C6.2,6.5,5.9,6.6,5.6,6.6z" />
-    <path d="M19.8,20.8c-0.3,0-0.5-0.1-0.7-0.3l-1.4-1.4c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C20.3,20.7,20,20.8,19.8,20.8z" />
-    <path d="M3,13H1c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S3.6,13,3,13z" />
-    <path d="M23,13h-2c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S23.6,13,23,13z" />
-    <path d="M4.2,20.8c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C4.7,20.7,4.5,20.8,4.2,20.8z" />
-    <path d="M18.4,6.6c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C18.9,6.5,18.6,6.6,18.4,6.6z" />
-  </svg>
-</template>
diff --git a/src/client/theme-default/composables/edit-link.ts b/src/client/theme-default/composables/edit-link.ts
index 75fecc03..44cd35f5 100644
--- a/src/client/theme-default/composables/edit-link.ts
+++ b/src/client/theme-default/composables/edit-link.ts
@@ -1,4 +1,5 @@
 import { computed } from 'vue'
+
 import { useData } from './data'
 
 export function useEditLink() {
diff --git a/src/client/theme-default/composables/langs.ts b/src/client/theme-default/composables/langs.ts
index 64ca65ce..0fb6e06b 100644
--- a/src/client/theme-default/composables/langs.ts
+++ b/src/client/theme-default/composables/langs.ts
@@ -1,5 +1,6 @@
 import type { DefaultTheme } from 'vitepress/theme'
 import { computed } from 'vue'
+
 import { useRoute } from '../../app/router'
 import type { Route, VitePressData } from '../../shared'
 import { ensureStartingSlash } from '../support/utils'
diff --git a/src/client/theme-default/composables/layout.ts b/src/client/theme-default/composables/layout.ts
index 2e232be8..c69f8464 100644
--- a/src/client/theme-default/composables/layout.ts
+++ b/src/client/theme-default/composables/layout.ts
@@ -9,6 +9,7 @@ import {
   type ComputedRef,
   type InjectionKey
 } from 'vue'
+
 import { getSidebar, getSidebarGroups } from '../support/sidebar'
 import { useData } from './data'
 import { getHeaders } from './outline'
diff --git a/src/client/theme-default/composables/outline.ts b/src/client/theme-default/composables/outline.ts
index db476f0d..a963bb8f 100644
--- a/src/client/theme-default/composables/outline.ts
+++ b/src/client/theme-default/composables/outline.ts
@@ -1,6 +1,7 @@
 import { useMediaQuery } from '@vueuse/core'
 import type { DefaultTheme } from 'vitepress/theme'
 import { onMounted, onUnmounted, onUpdated, type Ref } from 'vue'
+
 import { throttleAndDebounce } from '../support/utils'
 
 const ignoreRE = /\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/
diff --git a/src/client/theme-default/composables/prev-next.ts b/src/client/theme-default/composables/prev-next.ts
index 258d9856..52a0d791 100644
--- a/src/client/theme-default/composables/prev-next.ts
+++ b/src/client/theme-default/composables/prev-next.ts
@@ -1,4 +1,5 @@
 import { computed } from 'vue'
+
 import { isActive, normalize } from '../../shared'
 import { getFlatSideBarLinks, getSidebar } from '../support/sidebar'
 import { uniqBy } from '../support/utils'
diff --git a/src/client/theme-default/composables/sidebar.ts b/src/client/theme-default/composables/sidebar.ts
index 116520d7..e6eec014 100644
--- a/src/client/theme-default/composables/sidebar.ts
+++ b/src/client/theme-default/composables/sidebar.ts
@@ -10,6 +10,7 @@ import {
   watchEffect,
   type ComputedRef
 } from 'vue'
+
 import { isActive } from '../../shared'
 import { hasActiveLink as containsActiveLink } from '../support/sidebar'
 
diff --git a/src/client/theme-default/composables/sponsor-grid.ts b/src/client/theme-default/composables/sponsor-grid.ts
index 624e15ba..ab17aaeb 100644
--- a/src/client/theme-default/composables/sponsor-grid.ts
+++ b/src/client/theme-default/composables/sponsor-grid.ts
@@ -1,4 +1,5 @@
 import { type Ref, onMounted, onUnmounted } from 'vue'
+
 import { throttleAndDebounce } from '../support/utils'
 
 export interface GridSetting {
diff --git a/src/client/theme-default/support/docsearch.ts b/src/client/theme-default/support/docsearch.ts
index d22c659c..aef6866e 100644
--- a/src/client/theme-default/support/docsearch.ts
+++ b/src/client/theme-default/support/docsearch.ts
@@ -1,5 +1,6 @@
 import type { SidepanelProps } from '@docsearch/sidepanel-js'
 import type { DefaultTheme } from 'vitepress/theme'
+
 import type { DocSearchAskAi } from '../../../../types/docsearch'
 import { isObject } from '../../shared'
 
diff --git a/src/client/theme-default/support/sidebar.ts b/src/client/theme-default/support/sidebar.ts
index 35c92722..d9ef00d2 100644
--- a/src/client/theme-default/support/sidebar.ts
+++ b/src/client/theme-default/support/sidebar.ts
@@ -1,4 +1,5 @@
 import type { DefaultTheme } from 'vitepress/theme'
+
 import { isActive, isExternal } from '../../shared'
 import { ensureStartingSlash } from './utils'
 
diff --git a/src/client/theme-default/support/utils.ts b/src/client/theme-default/support/utils.ts
index 6a2676a6..777cf314 100644
--- a/src/client/theme-default/support/utils.ts
+++ b/src/client/theme-default/support/utils.ts
@@ -1,4 +1,5 @@
 import { withBase } from 'vitepress'
+
 import { isExternal, treatAsHtml } from '../../shared'
 import { useData } from '../composables/data'
 
diff --git a/src/client/theme-default/without-fonts.ts b/src/client/theme-default/without-fonts.ts
index c32fb364..6a551bc6 100644
--- a/src/client/theme-default/without-fonts.ts
+++ b/src/client/theme-default/without-fonts.ts
@@ -9,6 +9,7 @@ import './styles/components/vp-doc.css'
 import './styles/components/vp-sponsor.css'
 
 import type { Theme } from 'vitepress'
+
 import VPBadge from './components/VPBadge.vue'
 import Layout from './Layout.vue'
 
diff --git a/src/node/alias.ts b/src/node/alias.ts
index e30e557c..cef8df37 100644
--- a/src/node/alias.ts
+++ b/src/node/alias.ts
@@ -1,6 +1,7 @@
 import { createRequire } from 'node:module'
 import { join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
+
 import type { Alias, AliasOptions } from 'vite'
 
 const require = createRequire(import.meta.url)
diff --git a/src/node/build/build.ts b/src/node/build/build.ts
index 592d680b..f59c3854 100644
--- a/src/node/build/build.ts
+++ b/src/node/build/build.ts
@@ -1,12 +1,14 @@
-import { getIconsCSS } from '@iconify/utils'
 import { createHash } from 'node:crypto'
 import fs from 'node:fs'
 import { mkdir, rm, symlink, unlink, writeFile } from 'node:fs/promises'
 import { createRequire } from 'node:module'
 import path from 'node:path'
+
+import { getIconsCSS } from '@iconify/utils'
 import pMap from 'p-map'
 import { packageDirectory } from 'package-directory'
 import type { BuildOptions, Rolldown } from 'vite'
+
 import { resolveConfig, type SiteConfig } from '../config'
 import { clearCache } from '../markdownToVue'
 import type { PageMeta } from '../plugin'
diff --git a/src/node/build/buildMPAClient.ts b/src/node/build/buildMPAClient.ts
index aa541814..3eebe9dd 100644
--- a/src/node/build/buildMPAClient.ts
+++ b/src/node/build/buildMPAClient.ts
@@ -1,4 +1,5 @@
 import { build, type Rolldown } from 'vite'
+
 import type { SiteConfig } from '..'
 
 const virtualEntry = 'client.js'
diff --git a/src/node/build/bundle.ts b/src/node/build/bundle.ts
index 409c5c28..be85540f 100644
--- a/src/node/build/bundle.ts
+++ b/src/node/build/bundle.ts
@@ -2,6 +2,7 @@ import fs from 'node:fs'
 import { cp } from 'node:fs/promises'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
+
 import pMap from 'p-map'
 import {
   build,
@@ -10,6 +11,7 @@ import {
   type Rolldown,
   type InlineConfig as ViteInlineConfig
 } from 'vite'
+
 import { APP_PATH } from '../alias'
 import type { SiteConfig } from '../config'
 import { createVitePressPlugin, type PageMeta } from '../plugin'
diff --git a/src/node/build/generateSitemap.ts b/src/node/build/generateSitemap.ts
index 2ed98277..6fad11c8 100644
--- a/src/node/build/generateSitemap.ts
+++ b/src/node/build/generateSitemap.ts
@@ -1,6 +1,7 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import { pipeline } from 'node:stream/promises'
+
 import {
   SitemapStream,
   type EnumChangefreq,
@@ -8,6 +9,7 @@ import {
   type LinkItem,
   type NewsItem
 } from 'sitemap'
+
 import type { SiteConfig } from '../config'
 import type { PageMeta } from '../plugin'
 
diff --git a/src/node/build/render.ts b/src/node/build/render.ts
index 9cf215dc..49c9a43b 100644
--- a/src/node/build/render.ts
+++ b/src/node/build/render.ts
@@ -1,7 +1,9 @@
-import { isBooleanAttr } from '@vue/shared'
 import { mkdir, realpath, rm, writeFile } from 'node:fs/promises'
 import path from 'node:path'
+
+import { isBooleanAttr } from '@vue/shared'
 import { minify, normalizePath, type Rolldown } from 'vite'
+
 import { version } from '../../../package.json' with { type: 'json' }
 import type { SiteConfig } from '../config'
 import {
diff --git a/src/node/cli.ts b/src/node/cli.ts
index 76da98c4..5a385b5f 100644
--- a/src/node/cli.ts
+++ b/src/node/cli.ts
@@ -1,6 +1,7 @@
 import minimist from 'minimist'
 import c from 'picocolors'
 import { createLogger } from 'vite'
+
 import {
   build,
   createServer,
diff --git a/src/node/config.ts b/src/node/config.ts
index 982016a6..093b455b 100644
--- a/src/node/config.ts
+++ b/src/node/config.ts
@@ -1,5 +1,6 @@
 import fs from 'node:fs'
 import path from 'node:path'
+
 import { createDebug } from 'obug'
 import c from 'picocolors'
 import {
@@ -10,6 +11,7 @@ import {
   type ConfigEnv,
   type UserConfig as ViteUserConfig
 } from 'vite'
+
 import { DEFAULT_THEME_PATH } from './alias'
 import type { DefaultTheme } from './defaultTheme'
 import type { MarkdownOptions } from './markdown/markdown'
diff --git a/src/node/contentLoader.ts b/src/node/contentLoader.ts
index 2356d6e5..937aa718 100644
--- a/src/node/contentLoader.ts
+++ b/src/node/contentLoader.ts
@@ -1,8 +1,10 @@
-import matter from 'gray-matter'
 import { stat } from 'node:fs/promises'
 import path from 'node:path'
+
+import matter from 'gray-matter'
 import pMap from 'p-map'
 import { normalizePath } from 'vite'
+
 import type { SiteConfig } from './config'
 import {
   createMarkdownRenderer,
diff --git a/src/node/defaultTheme.ts b/src/node/defaultTheme.ts
index 7b50e1b6..168b1bf2 100644
--- a/src/node/defaultTheme.ts
+++ b/src/node/defaultTheme.ts
@@ -4,6 +4,7 @@
 // but these can import types from dev deps
 
 import type { MarkdownItAsync } from 'markdown-it-async'
+
 import type { DefaultTheme } from '../../types/default-theme'
 import type { PageSplitSection } from '../../types/local-search'
 import type { Awaitable, MarkdownEnv } from './shared'
diff --git a/src/node/init/init.ts b/src/node/init/init.ts
index ba8e64b9..60f9a4f0 100644
--- a/src/node/init/init.ts
+++ b/src/node/init/init.ts
@@ -1,3 +1,8 @@
+import fs from 'node:fs'
+import { mkdir, writeFile } from 'node:fs/promises'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
 import {
   cancel,
   confirm,
@@ -8,11 +13,8 @@ import {
   text
 } from '@clack/prompts'
 import template from 'lodash.template'
-import fs from 'node:fs'
-import { mkdir, writeFile } from 'node:fs/promises'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
 import c from 'picocolors'
+
 import { slash } from '../shared'
 import { readFile } from '../utils/fs'
 
diff --git a/src/node/markdown/markdown.ts b/src/node/markdown/markdown.ts
index 3b496973..84886d3d 100644
--- a/src/node/markdown/markdown.ts
+++ b/src/node/markdown/markdown.ts
@@ -1,3 +1,5 @@
+import path from 'node:path'
+
 import {
   componentPlugin,
   type ComponentPluginOptions
@@ -27,7 +29,6 @@ import {
 } from '@mdit/plugin-tasklist'
 import { MarkdownItAsync, type MarkdownItAsyncOptions } from 'markdown-it-async'
 import mditCjkFriendly from 'markdown-it-cjk-friendly'
-import path from 'node:path'
 import type {
   BuiltinLanguage,
   BuiltinTheme,
@@ -38,6 +39,7 @@ import type {
   ThemeRegistrationAny
 } from 'shiki'
 import type { Logger } from 'vite'
+
 import type {
   Awaitable,
   CodeCopyButtonOptions,
diff --git a/src/node/markdown/plugins/containers.ts b/src/node/markdown/plugins/containers.ts
index 36b62cfd..690890ba 100644
--- a/src/node/markdown/plugins/containers.ts
+++ b/src/node/markdown/plugins/containers.ts
@@ -2,6 +2,7 @@ import { container } from '@mdit/plugin-container'
 import type { MarkdownItAsync } from 'markdown-it-async'
 import type { RenderRule } from 'markdown-it/lib/renderer.mjs'
 import type Token from 'markdown-it/lib/token.mjs'
+
 import type {
   ContainerOptions,
   MarkdownEnv,
diff --git a/src/node/markdown/plugins/highlight.ts b/src/node/markdown/plugins/highlight.ts
index d6cf82d7..7a72d135 100644
--- a/src/node/markdown/plugins/highlight.ts
+++ b/src/node/markdown/plugins/highlight.ts
@@ -10,6 +10,7 @@ import c from 'picocolors'
 import type { BundledLanguage, ShikiTransformer } from 'shiki'
 import { createHighlighter, guessEmbeddedLanguages, isSpecialLang } from 'shiki'
 import type { Logger } from 'vite'
+
 import { isShell } from '../../shared'
 import type { MarkdownOptions, ThemeOptions } from '../markdown'
 
diff --git a/src/node/markdown/plugins/image.ts b/src/node/markdown/plugins/image.ts
index e8407d56..f2c4fe6f 100644
--- a/src/node/markdown/plugins/image.ts
+++ b/src/node/markdown/plugins/image.ts
@@ -1,11 +1,13 @@
 // markdown-it plugin for normalizing image source and auto adding
 // width and height to images to avoid layout shift.
 
-import type { MarkdownItAsync } from 'markdown-it-async'
-import type Token from 'markdown-it/lib/token.mjs'
 import fs from 'node:fs'
 import path from 'node:path'
+
 import { imageSize } from 'image-size'
+import type { MarkdownItAsync } from 'markdown-it-async'
+import type Token from 'markdown-it/lib/token.mjs'
+
 import { EXTERNAL_URL_RE, type MarkdownEnv } from '../../shared'
 
 export interface Options {
diff --git a/src/node/markdown/plugins/include.ts b/src/node/markdown/plugins/include.ts
index c2236251..0e4ee896 100644
--- a/src/node/markdown/plugins/include.ts
+++ b/src/node/markdown/plugins/include.ts
@@ -1,7 +1,9 @@
+import path from 'node:path'
+
 import matter from 'gray-matter'
 import { replaceAsync, type MarkdownItAsync } from 'markdown-it-async'
-import path from 'node:path'
 import type { Logger } from 'vite'
+
 import { slash, type MarkdownEnv } from '../../shared'
 import { readTextFile } from '../../utils/fs'
 import { findRegions } from '../regions'
diff --git a/src/node/markdown/plugins/link.ts b/src/node/markdown/plugins/link.ts
index b165744a..f046537e 100644
--- a/src/node/markdown/plugins/link.ts
+++ b/src/node/markdown/plugins/link.ts
@@ -2,8 +2,10 @@
 // 1. adding target="_blank" to external links
 // 2. normalize internal links to end with `.html`
 
-import type { MarkdownItAsync } from 'markdown-it-async'
 import { URL } from 'node:url'
+
+import type { MarkdownItAsync } from 'markdown-it-async'
+
 import {
   EXTERNAL_URL_RE,
   isExternal,
diff --git a/src/node/markdown/plugins/preWrapper.ts b/src/node/markdown/plugins/preWrapper.ts
index 27014336..d5c66c7b 100644
--- a/src/node/markdown/plugins/preWrapper.ts
+++ b/src/node/markdown/plugins/preWrapper.ts
@@ -1,4 +1,5 @@
 import type { MarkdownItAsync } from 'markdown-it-async'
+
 import type { MarkdownEnv, MarkdownLocaleOptions } from '../../shared'
 
 export interface Options {
diff --git a/src/node/markdown/plugins/restoreEntities.ts b/src/node/markdown/plugins/restoreEntities.ts
index 0d2bb1d4..f34b7d5f 100644
--- a/src/node/markdown/plugins/restoreEntities.ts
+++ b/src/node/markdown/plugins/restoreEntities.ts
@@ -1,6 +1,7 @@
 import type { MarkdownItAsync } from 'markdown-it-async'
 import type StateCore from 'markdown-it/lib/rules_core/state_core.mjs'
 import type Token from 'markdown-it/lib/token.mjs'
+
 import { escapeHtml } from '../../shared'
 
 export function restoreEntities(md: MarkdownItAsync): void {
diff --git a/src/node/markdown/plugins/snippet.ts b/src/node/markdown/plugins/snippet.ts
index e371c2ea..3fe32cc4 100644
--- a/src/node/markdown/plugins/snippet.ts
+++ b/src/node/markdown/plugins/snippet.ts
@@ -1,7 +1,9 @@
+import path from 'node:path'
+
 import type { MarkdownItAsync } from 'markdown-it-async'
 import type { RuleBlock } from 'markdown-it/lib/parser_block.mjs'
-import path from 'node:path'
 import type { Logger } from 'vite'
+
 import type { MarkdownEnv } from '../../shared'
 import { readTextFileSync } from '../../utils/fs'
 import {
diff --git a/src/node/markdownToVue.ts b/src/node/markdownToVue.ts
index dd0f993a..f25e5b95 100644
--- a/src/node/markdownToVue.ts
+++ b/src/node/markdownToVue.ts
@@ -1,9 +1,11 @@
-import { resolveTitleFromToken } from '@mdit-vue/shared'
-import { LRUCache } from 'lru-cache'
 import { hash } from 'node:crypto'
 import fs from 'node:fs'
 import path from 'node:path'
+
+import { resolveTitleFromToken } from '@mdit-vue/shared'
+import { LRUCache } from 'lru-cache'
 import { createDebug } from 'obug'
+
 import type { SiteConfig } from './config'
 import {
   createMarkdownRenderer,
diff --git a/src/node/plugin.ts b/src/node/plugin.ts
index 0e652738..af0f3502 100644
--- a/src/node/plugin.ts
+++ b/src/node/plugin.ts
@@ -1,5 +1,6 @@
-import { exactRegex } from '@rolldown/pluginutils'
 import path from 'node:path'
+
+import { exactRegex } from '@rolldown/pluginutils'
 import c from 'picocolors'
 import {
   mergeConfig,
@@ -11,6 +12,7 @@ import {
   type Rolldown,
   type UserConfig
 } from 'vite'
+
 import {
   APP_PATH,
   DEFAULT_THEME_PATH,
diff --git a/src/node/plugins/dynamicRoutesPlugin.ts b/src/node/plugins/dynamicRoutesPlugin.ts
index 962e456e..3349cb23 100644
--- a/src/node/plugins/dynamicRoutesPlugin.ts
+++ b/src/node/plugins/dynamicRoutesPlugin.ts
@@ -1,5 +1,6 @@
 import fs from 'node:fs'
 import path from 'node:path'
+
 import c from 'picocolors'
 import pm from 'picomatch'
 import {
@@ -10,6 +11,7 @@ import {
   type Logger,
   type Plugin
 } from 'vite'
+
 import type { Awaitable } from '../shared'
 import { type SiteConfig, type UserConfig } from '../siteConfig'
 import { readTextFile } from '../utils/fs'
diff --git a/src/node/plugins/localSearchPlugin.ts b/src/node/plugins/localSearchPlugin.ts
index 35332af3..3bd154ce 100644
--- a/src/node/plugins/localSearchPlugin.ts
+++ b/src/node/plugins/localSearchPlugin.ts
@@ -1,9 +1,11 @@
+import path from 'node:path'
+
 import { prefixRegex } from '@rolldown/pluginutils'
 import MiniSearch from 'minisearch'
-import path from 'node:path'
 import { createDebug } from 'obug'
 import c from 'picocolors'
 import type { Plugin, ViteDevServer } from 'vite'
+
 import type { SiteConfig } from '../config'
 import type { DefaultTheme } from '../defaultTheme'
 import {
diff --git a/src/node/plugins/rewritesPlugin.ts b/src/node/plugins/rewritesPlugin.ts
index 045b88e8..16b313e0 100644
--- a/src/node/plugins/rewritesPlugin.ts
+++ b/src/node/plugins/rewritesPlugin.ts
@@ -1,5 +1,6 @@
 import { compile, match } from 'path-to-regexp'
 import type { Plugin } from 'vite'
+
 import type { SiteConfig, UserConfig } from '../siteConfig'
 
 export function resolveRewrites(
diff --git a/src/node/plugins/staticDataPlugin.ts b/src/node/plugins/staticDataPlugin.ts
index b926935f..594a473a 100644
--- a/src/node/plugins/staticDataPlugin.ts
+++ b/src/node/plugins/staticDataPlugin.ts
@@ -1,4 +1,5 @@
 import path from 'node:path'
+
 import pm from 'picomatch'
 import {
   loadConfigFromFile,
@@ -7,6 +8,7 @@ import {
   type Plugin,
   type ViteDevServer
 } from 'vite'
+
 import type { Awaitable } from '../shared'
 import { glob, normalizeGlob, type GlobOptions } from '../utils/glob'
 
diff --git a/src/node/serve/serve.ts b/src/node/serve/serve.ts
index dc70f683..6ed7704c 100644
--- a/src/node/serve/serve.ts
+++ b/src/node/serve/serve.ts
@@ -1,8 +1,10 @@
-import compression from '@polka/compression'
 import { once } from 'node:events'
 import path from 'node:path'
+
+import compression from '@polka/compression'
 import polka, { type IOptions } from 'polka'
 import sirv from 'sirv'
+
 import { resolveConfig } from '../config'
 import { readFile } from '../utils/fs'
 
diff --git a/src/node/server.ts b/src/node/server.ts
index 1008093c..6f8708ff 100644
--- a/src/node/server.ts
+++ b/src/node/server.ts
@@ -1,4 +1,5 @@
 import { createServer as createViteServer, type ServerOptions } from 'vite'
+
 import { resolveConfig, type SiteConfig } from './config'
 import { createVitePressPlugin } from './plugin'
 
diff --git a/src/node/shortcuts.ts b/src/node/shortcuts.ts
index 22dc168f..ef46858e 100644
--- a/src/node/shortcuts.ts
+++ b/src/node/shortcuts.ts
@@ -1,5 +1,6 @@
 import c from 'picocolors'
 import type { ViteDevServer } from 'vite'
+
 import type { Awaitable } from './shared'
 
 export type CLIShortcut = {
diff --git a/src/node/siteConfig.ts b/src/node/siteConfig.ts
index d5b450db..6538395e 100644
--- a/src/node/siteConfig.ts
+++ b/src/node/siteConfig.ts
@@ -2,6 +2,7 @@ import type { Options as VuePluginOptions } from '@vitejs/plugin-vue'
 import type { UseDarkOptions } from '@vueuse/core'
 import type { SitemapStreamOptions } from 'sitemap'
 import type { Logger, UserConfig as ViteConfig } from 'vite'
+
 import type {
   AdditionalConfigDict,
   AdditionalConfigLoader
diff --git a/src/node/utils/getGitTimestamp.ts b/src/node/utils/getGitTimestamp.ts
index a22db188..db3afcd1 100644
--- a/src/node/utils/getGitTimestamp.ts
+++ b/src/node/utils/getGitTimestamp.ts
@@ -1,9 +1,11 @@
-import { spawn, sync } from 'cross-spawn'
 import { once } from 'node:events'
 import fs from 'node:fs'
 import path from 'node:path'
 import { Transform, type TransformCallback } from 'node:stream'
+
+import { spawn, sync } from 'cross-spawn'
 import { createDebug } from 'obug'
+
 import { slash } from '../shared'
 
 const debug = createDebug('vitepress:git')
diff --git a/src/node/utils/glob.ts b/src/node/utils/glob.ts
index cd7c2e34..47623d6a 100644
--- a/src/node/utils/glob.ts
+++ b/src/node/utils/glob.ts
@@ -1,4 +1,5 @@
 import path from 'node:path'
+
 import { glob as _glob } from 'tinyglobby'
 import { normalizePath } from 'vite'
 
diff --git a/src/node/utils/logVersion.ts b/src/node/utils/logVersion.ts
index a43ceb8a..8e62c958 100644
--- a/src/node/utils/logVersion.ts
+++ b/src/node/utils/logVersion.ts
@@ -1,5 +1,6 @@
 import c from 'picocolors'
 import { version as viteVersion, type Logger } from 'vite'
+
 import { version } from '../../../package.json' with { type: 'json' }
 
 export function logVersion(logger: Logger) {
diff --git a/theme.d.ts b/theme.d.ts
index 28550aa6..ef7554d9 100644
--- a/theme.d.ts
+++ b/theme.d.ts
@@ -2,6 +2,7 @@
 
 import type { EnhanceAppContext } from 'vitepress'
 import type { ComputedRef, DefineComponent, ShallowRef } from 'vue'
+
 import type { DefaultTheme } from './types/default-theme.js'
 
 export type { DefaultTheme } from './types/default-theme.js'
diff --git a/types/default-theme.d.ts b/types/default-theme.d.ts
index 1fb1d7e4..24784d33 100644
--- a/types/default-theme.d.ts
+++ b/types/default-theme.d.ts
@@ -1,4 +1,5 @@
 import type { Options as _MiniSearchOptions } from 'minisearch'
+
 import type { DocSearchProps } from './docsearch.js'
 import type { LocalSearchTranslations } from './local-search.js'
 import type { Header, PageData, Route, VitePressData } from './shared.js'

From 357b072a47e1255001f510cc5fc4c09040a46e02 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Mon, 24 Aug 2026 03:35:00 +0530
Subject: [PATCH 13/18] chore: migrate build to tsdown (#5396)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
---
 __tests__/e2e/dynamic-routes/[id].paths.ts    |    4 +-
 .../markdown-extensions.test.ts               |   16 +-
 package.json                                  |   37 +-
 patches/vue-sfc-transformer.patch             |   18 +
 pnpm-lock.yaml                                | 1957 +++++++++--------
 pnpm-workspace.yaml                           |    7 +-
 rollup.config.ts                              |  115 -
 scripts/copyClient.ts                         |   12 -
 scripts/copyShared.ts                         |   10 -
 scripts/watchAndCopy.ts                       |   38 -
 shared-globals.d.ts                           |   13 +
 src/client/app/composables/codeGroups.ts      |    3 +-
 src/client/app/composables/copyCode.ts        |    4 +-
 src/client/app/composables/head.ts            |    4 +-
 src/client/shims.d.ts                         |   11 +-
 .../theme-default/components/VPCarbonAds.vue  |    6 +-
 .../components/VPDocAsideOutline.vue          |    6 +-
 .../theme-default/components/VPFlyout.vue     |    4 +-
 .../components/VPLocalNavOutlineDropdown.vue  |    6 +-
 .../components/VPLocalSearchBox.vue           |   43 +-
 .../theme-default/components/VPSidebar.vue    |    4 +-
 .../theme-default/components/VPSkipLink.vue   |    6 +-
 .../theme-default/components/VPSocialLink.vue |   10 +-
 .../components/VPSponsorsGrid.vue             |    4 +-
 .../theme-default/composables/flyout.ts       |    4 +-
 .../theme-default/composables/layout.ts       |    4 +-
 .../theme-default/composables/outline.ts      |   34 +-
 .../theme-default/composables/sponsor-grid.ts |   10 +-
 src/client/theme-default/support/sidebar.ts   |   15 +-
 src/client/theme-default/support/utils.ts     |    6 +-
 src/client/tsconfig.json                      |   14 -
 src/node/init/init.ts                         |   13 +-
 src/node/markdownToVue.ts                     |    2 +-
 src/node/plugins/dynamicRoutesPlugin.ts       |    3 +-
 src/node/plugins/rewritesPlugin.ts            |    2 +-
 src/node/tsconfig.json                        |    9 -
 src/shared/shared.ts                          |    6 +-
 src/shared/tsconfig.json                      |    7 -
 theme.d.ts                                    |   64 +-
 tsconfig.base.json                            |   30 +
 tsconfig.client.json                          |   19 +
 tsconfig.json                                 |   21 +-
 tsconfig.node.json                            |    8 +
 tsconfig.shared.json                          |   10 +
 tsdown.config.ts                              |  241 ++
 types/default-theme.d.ts                      |   27 +
 46 files changed, 1602 insertions(+), 1285 deletions(-)
 create mode 100644 patches/vue-sfc-transformer.patch
 delete mode 100644 rollup.config.ts
 delete mode 100644 scripts/copyClient.ts
 delete mode 100644 scripts/copyShared.ts
 delete mode 100644 scripts/watchAndCopy.ts
 create mode 100644 shared-globals.d.ts
 delete mode 100644 src/client/tsconfig.json
 delete mode 100644 src/node/tsconfig.json
 delete mode 100644 src/shared/tsconfig.json
 create mode 100644 tsconfig.base.json
 create mode 100644 tsconfig.client.json
 create mode 100644 tsconfig.node.json
 create mode 100644 tsconfig.shared.json
 create mode 100644 tsdown.config.ts

diff --git a/__tests__/e2e/dynamic-routes/[id].paths.ts b/__tests__/e2e/dynamic-routes/[id].paths.ts
index 273f729c..026079f7 100644
--- a/__tests__/e2e/dynamic-routes/[id].paths.ts
+++ b/__tests__/e2e/dynamic-routes/[id].paths.ts
@@ -3,8 +3,8 @@ import { defineRoutes } from 'vitepress'
 import paths from './paths'
 
 export default defineRoutes({
-  async paths(watchedFiles: string[]) {
-    // console.log('watchedFiles', watchedFiles)
+  async paths(_watchedFiles: string[]) {
+    // console.log('watchedFiles', _watchedFiles)
     return paths
   },
   watch: ['../data-loading/**/*.json'],
diff --git a/__tests__/e2e/markdown-extensions/markdown-extensions.test.ts b/__tests__/e2e/markdown-extensions/markdown-extensions.test.ts
index 839f953c..000ede05 100644
--- a/__tests__/e2e/markdown-extensions/markdown-extensions.test.ts
+++ b/__tests__/e2e/markdown-extensions/markdown-extensions.test.ts
@@ -123,13 +123,15 @@ describe('Table of Contents', () => {
 })
 
 describe('Custom Containers', () => {
-  enum CustomBlocks {
-    Info = 'INFO',
-    Tip = 'TIP',
-    Warning = 'WARNING',
-    Danger = 'DANGER',
-    Details = 'Details'
-  }
+  const CustomBlocks = {
+    Info: 'INFO',
+    Tip: 'TIP',
+    Warning: 'WARNING',
+    Danger: 'DANGER',
+    Details: 'Details'
+  } as const
+
+  type CustomBlocks = (typeof CustomBlocks)[keyof typeof CustomBlocks]
 
   const classnameMap = {
     [CustomBlocks.Info]: 'info',
diff --git a/package.json b/package.json
index 89aeebcc..c557b30e 100644
--- a/package.json
+++ b/package.json
@@ -52,17 +52,10 @@
     "lib"
   ],
   "scripts": {
-    "clean": "node -e \"require('node:fs').rmSync('./dist',{recursive:!0,force:!0,maxRetries:10})\"",
-    "dev": "pnpm clean && pnpm dev:shared && pnpm dev:start",
-    "dev:start": "pnpm --stream '/^dev:(client|node|watch)$/'",
-    "dev:client": "tsc --sourcemap -w --preserveWatchOutput -p src/client",
-    "dev:node": "DEV=true pnpm build:node -w",
-    "dev:shared": "node scripts/copyShared.ts",
-    "dev:watch": "node scripts/watchAndCopy.ts",
-    "build": "pnpm build:prepare && pnpm build:client && pnpm build:node && node scripts/genWebTypes.ts",
-    "build:prepare": "pnpm clean && node scripts/copyShared.ts",
-    "build:client": "vue-tsc --noEmit -p src/client && tsc -p src/client && node scripts/copyClient.ts",
-    "build:node": "tsc -p src/node --noEmit && rollup --config rollup.config.ts",
+    "dev": "tsdown --watch --sourcemap",
+    "build": "tsdown && pnpm typecheck && node scripts/genWebTypes.ts && pnpm build:check",
+    "build:check": "publint && attw --pack . --profile esm-only",
+    "typecheck": "tsc -p tsconfig.shared.json && vue-tsc -p tsconfig.client.json && tsc -p tsconfig.node.json",
     "test": "pnpm --aggregate-output --reporter=append-only '/^test:(types|unit|e2e|init)$/'",
     "test:types": "tsc -p __tests__/unit && tsc -p __tests__/e2e && tsc -p __tests__/init && vue-tsc -p docs",
     "test:unit": "vitest run -r __tests__/unit",
@@ -132,13 +125,9 @@
     "@mdit/plugin-emoji": "^1.1.1",
     "@mdit/plugin-footnote": "^1.0.2",
     "@mdit/plugin-tasklist": "^1.0.2",
+    "@arethetypeswrong/cli": "^0.18.5",
     "@polka/compression": "^1.0.0-next.28",
     "@rolldown/pluginutils": "^1.0.1",
-    "@rollup/plugin-alias": "^6.0.0",
-    "@rollup/plugin-commonjs": "^29.0.3",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-replace": "^6.0.3",
     "@types/cross-spawn": "^6.0.6",
     "@types/lodash.template": "^4.5.3",
     "@types/mark.js": "^8.11.12",
@@ -146,11 +135,11 @@
     "@types/node": "^26.2.0",
     "@types/picomatch": "^4.0.3",
     "@types/semver": "^7.8.0",
-    "chokidar": "^5.0.0",
+    "@volar/typescript": "^2.4.28",
+    "@vue/language-core": "^3.3.11",
     "conventional-changelog": "^8.1.1",
     "conventional-changelog-angular": "^9.2.1",
     "cross-spawn": "^7.0.6",
-    "esbuild": "^0.27.7",
     "get-port": "^7.2.0",
     "gray-matter": "^4.0.3",
     "image-size": "^2.0.2",
@@ -175,18 +164,18 @@
     "postcss": "^8.5.6",
     "postcss-selector-parser": "^7.1.5",
     "prettier": "^3.9.6",
-    "punycode": "^2.3.1",
-    "rollup": "^4.62.4",
-    "rollup-plugin-dts": "6.1.1",
-    "rollup-plugin-esbuild": "^6.2.1",
+    "publint": "^0.3.24",
+    "rolldown": "^1.2.5",
     "semver": "^7.8.5",
     "simple-git-hooks": "^2.13.1",
     "sirv": "^3.0.2",
     "sitemap": "^9.0.1",
     "tinyglobby": "^0.2.17",
-    "typescript": "^5.9.3",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "vue-tsc": "^3.3.9",
+    "vue-sfc-transformer": "^0.2.5",
+    "vue-tsc": "^3.3.11",
     "wait-on": "^9.1.0"
   },
   "peerDependencies": {
diff --git a/patches/vue-sfc-transformer.patch b/patches/vue-sfc-transformer.patch
new file mode 100644
index 00000000..c3b8091f
--- /dev/null
+++ b/patches/vue-sfc-transformer.patch
@@ -0,0 +1,18 @@
+diff --git a/dist/rolldown.mjs b/dist/rolldown.mjs
+index 7e04d96c703656b81220193b1f01426778b6a42f..26e96378fc0ad985237302e673ed0ab07674bf41 100644
+--- a/dist/rolldown.mjs
++++ b/dist/rolldown.mjs
+@@ -196,10 +196,11 @@ function resolveCache(options) {
+ async function transpileScript(code, filename = "__sfc.ts") {
+ 	const result = await transform(filename, code, {
+ 		lang: "ts",
+-		sourcemap: false
++		sourcemap: false,
++		typescript: { onlyRemoveTypeImports: true }
+ 	});
+ 	if (result.errors.length) throw new AggregateError(result.errors, `[vue-sfc-transformer] failed to transpile script in ${filename}`);
+-	return result.code ?? code;
++	return (result.code ?? code).replace(/\n?export \{\};?[\s\n]*$/, "");
+ }
+ function vueSfcPlugin(pluginOptions) {
+ 	const cwd = pluginOptions.cwd ?? process.cwd();
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index c09fe11e..74b2c437 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -4,6 +4,12 @@ settings:
   autoInstallPeers: false
   excludeLinksFromLockfile: false
 
+overrides:
+  esbuild: '-'
+
+patchedDependencies:
+  vue-sfc-transformer: 06dbce7d98fac77faf5e66a94aa6e04f34c0cc7ec0910ec10848e5f2e08b8b68
+
 importers:
 
   .:
@@ -28,7 +34,7 @@ importers:
         version: 14.1.2
       '@vitejs/plugin-vue':
         specifier: ^6.0.8
-        version: 6.0.8(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0))(vue@3.5.41(typescript@5.9.3))
+        version: 6.0.8(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0))(vue@3.5.41(typescript@6.0.3))
       '@vue/devtools-api':
         specifier: ^8.2.1
         version: 8.2.1
@@ -37,10 +43,10 @@ importers:
         version: 3.5.41
       '@vueuse/core':
         specifier: ^14.4.0
-        version: 14.4.0(vue@3.5.41(typescript@5.9.3))
+        version: 14.4.0(vue@3.5.41(typescript@6.0.3))
       '@vueuse/integrations':
         specifier: ^14.4.0
-        version: 14.4.0(axios@1.19.0(debug@4.4.3))(focus-trap@8.2.2)(vue@3.5.41(typescript@5.9.3))
+        version: 14.4.0(axios@1.19.0(debug@4.4.3(supports-color@7.2.0))(supports-color@7.2.0))(focus-trap@8.2.2)(vue@3.5.41(typescript@6.0.3))
       focus-trap:
         specifier: ^8.2.2
         version: 8.2.2
@@ -55,11 +61,14 @@ importers:
         version: 4.4.3
       vite:
         specifier: ^8.2.1
-        version: 8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0)
+        version: 8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0)
       vue:
         specifier: ^3.5.41
-        version: 3.5.41(typescript@5.9.3)
+        version: 3.5.41(typescript@6.0.3)
     devDependencies:
+      '@arethetypeswrong/cli':
+        specifier: ^0.18.5
+        version: 0.18.5
       '@clack/prompts':
         specifier: ^1.7.0
         version: 1.7.0
@@ -111,21 +120,6 @@ importers:
       '@rolldown/pluginutils':
         specifier: ^1.0.1
         version: 1.0.1
-      '@rollup/plugin-alias':
-        specifier: ^6.0.0
-        version: 6.0.0(rollup@4.62.4)
-      '@rollup/plugin-commonjs':
-        specifier: ^29.0.3
-        version: 29.0.3(rollup@4.62.4)
-      '@rollup/plugin-json':
-        specifier: ^6.1.0
-        version: 6.1.0(rollup@4.62.4)
-      '@rollup/plugin-node-resolve':
-        specifier: ^16.0.3
-        version: 16.0.3(rollup@4.62.4)
-      '@rollup/plugin-replace':
-        specifier: ^6.0.3
-        version: 6.0.3(rollup@4.62.4)
       '@types/cross-spawn':
         specifier: ^6.0.6
         version: 6.0.6
@@ -147,9 +141,12 @@ importers:
       '@types/semver':
         specifier: ^7.8.0
         version: 7.8.0
-      chokidar:
-        specifier: ^5.0.0
-        version: 5.0.0
+      '@volar/typescript':
+        specifier: ^2.4.28
+        version: 2.4.28(typescript@6.0.3)
+      '@vue/language-core':
+        specifier: ^3.3.11
+        version: 3.3.11
       conventional-changelog:
         specifier: ^8.1.1
         version: 8.1.1(conventional-commits-filter@6.0.1)
@@ -159,9 +156,6 @@ importers:
       cross-spawn:
         specifier: ^7.0.6
         version: 7.0.6
-      esbuild:
-        specifier: ^0.27.7
-        version: 0.27.7
       get-port:
         specifier: ^7.2.0
         version: 7.2.0
@@ -234,18 +228,12 @@ importers:
       prettier:
         specifier: ^3.9.6
         version: 3.9.6
-      punycode:
-        specifier: ^2.3.1
-        version: 2.3.1
-      rollup:
-        specifier: ^4.62.4
-        version: 4.62.4
-      rollup-plugin-dts:
-        specifier: 6.1.1
-        version: 6.1.1(rollup@4.62.4)(typescript@5.9.3)
-      rollup-plugin-esbuild:
-        specifier: ^6.2.1
-        version: 6.2.1(esbuild@0.27.7)(rollup@4.62.4)
+      publint:
+        specifier: ^0.3.24
+        version: 0.3.24
+      rolldown:
+        specifier: ^1.2.5
+        version: 1.2.5
       semver:
         specifier: ^7.8.5
         version: 7.8.5
@@ -261,18 +249,24 @@ importers:
       tinyglobby:
         specifier: ^0.2.17
         version: 0.2.17
+      tsdown:
+        specifier: ^0.22.14
+        version: 0.22.14(@arethetypeswrong/core@0.18.5)(@volar/typescript@2.4.28(typescript@6.0.3))(publint@0.3.24)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3))
       typescript:
-        specifier: ^5.9.3
-        version: 5.9.3
+        specifier: ^6.0.3
+        version: 6.0.3
       vitest:
         specifier: ^4.1.10
-        version: 4.1.10(@types/node@26.2.0)(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0))
+        version: 4.1.10(@types/node@26.2.0)(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0))
+      vue-sfc-transformer:
+        specifier: ^0.2.5
+        version: 0.2.5(patch_hash=06dbce7d98fac77faf5e66a94aa6e04f34c0cc7ec0910ec10848e5f2e08b8b68)(@volar/typescript@2.4.28(typescript@6.0.3))(@vue/compiler-core@3.5.41)(@vue/language-core@3.3.11)(rolldown@1.2.5)(typescript@6.0.3)(vue@3.5.41(typescript@6.0.3))
       vue-tsc:
-        specifier: ^3.3.9
-        version: 3.3.9(typescript@5.9.3)
+        specifier: ^3.3.11
+        version: 3.3.11(typescript@6.0.3)
       wait-on:
         specifier: ^9.1.0
-        version: 9.1.0(debug@4.4.3)
+        version: 9.1.0(debug@4.4.3(supports-color@7.2.0))(supports-color@7.2.0)
 
   __tests__/e2e:
     devDependencies:
@@ -290,13 +284,13 @@ importers:
     devDependencies:
       '@lunariajs/core':
         specifier: ^0.1.1
-        version: 0.1.1
+        version: 0.1.1(supports-color@7.2.0)
       markdown-it-mathjax3:
         specifier: ^4.3.2
         version: 4.3.2
       open-cli:
         specifier: ^9.0.0
-        version: 9.0.0
+        version: 9.0.0(supports-color@7.2.0)
       postcss-rtlcss:
         specifier: ^6.0.0
         version: 6.0.0(postcss@8.5.26)
@@ -305,10 +299,10 @@ importers:
         version: link:..
       vitepress-plugin-group-icons:
         specifier: ^1.7.6
-        version: 1.7.6(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0))
+        version: 1.7.6(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0))
       vitepress-plugin-llms:
         specifier: ^1.13.4
-        version: 1.13.4
+        version: 1.13.4(supports-color@7.2.0)
 
 packages:
 
@@ -316,12 +310,20 @@ packages:
     resolution: {integrity: sha512-fNdBOb3MgDz/1UCIoeY4wDuGbp+/3s5y6UrsyfMabECbh/CVycj7Er33JXqSxRwxrRKXcGE1Jipuq/1mODInsQ==}
     engines: {node: '>=11'}
 
+  '@andrewbranch/untar.js@1.0.4':
+    resolution: {integrity: sha512-pVXSwPsLuw8IGLo2Di0EaOfsk+ntVvpkk942J/sHYIkwvtKUakEcPh7HBgZ6tuimgzKSEHgCvO4XgQ05DEbwDw==}
+
   '@antfu/install-pkg@1.1.0':
     resolution: {integrity: sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==}
 
-  '@babel/code-frame@7.29.7':
-    resolution: {integrity: sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==}
-    engines: {node: '>=6.9.0'}
+  '@arethetypeswrong/cli@0.18.5':
+    resolution: {integrity: sha512-gM+8vRsQOD/Uc7EnBedUhkG5OCsDWE4uoak5QvomGpMpaky0Eh41p04nIMgrWb8EOmqZUJGc6zz9hsP6E56R7g==}
+    engines: {node: '>=20'}
+    hasBin: true
+
+  '@arethetypeswrong/core@0.18.5':
+    resolution: {integrity: sha512-9ytjzGwxjm9Uz7I9avfbt5vlQt6uk9uRRESzJjqrznl6WKvI6dwYTo+vJ3U02Wrq/mR3iql/PzhvHhKdJIAjDQ==}
+    engines: {node: '>=20'}
 
   '@babel/helper-string-parser@7.29.7':
     resolution: {integrity: sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==}
@@ -343,6 +345,9 @@ packages:
   '@borewit/text-codec@0.2.2':
     resolution: {integrity: sha512-DDaRehssg1aNrH4+2hnj1B7vnUGEjU6OIlyRdkMd0aUdIUvKXrJfXsy8LVtXAy7DRvYVluWbMspsRhz2lcW0mQ==}
 
+  '@braidai/lang@1.1.2':
+    resolution: {integrity: sha512-qBcknbBufNHlui137Hft8xauQMTZDKdophmLFv05r2eNmdIv/MlPuP4TdUknHG68UdWLgVZwgxVe735HzJNIwA==}
+
   '@clack/core@0.3.5':
     resolution: {integrity: sha512-5cfhQNH+1VQ2xLQlmzXMqUoiaH0lRBq9/CLW9lTyMbuKLC3+xEK01tHVvyut++mLOn5urSHmkm6I0Lg9MaJSTQ==}
 
@@ -354,6 +359,10 @@ packages:
     resolution: {integrity: sha512-y7/yvZ2TPAnR9+jnc00klvNNLkJiXFFrQA/hlLCcxA9a2A4zQIOimyFQ9XfwYKiGD1fb5GY8vbKIIgO8d5Tb2A==}
     engines: {node: '>= 20.12.0'}
 
+  '@colors/colors@1.5.0':
+    resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
+    engines: {node: '>=0.1.90'}
+
   '@conventional-changelog/git-client@3.1.1':
     resolution: {integrity: sha512-w/q+UIVdWQMgXlziPIYfPlyDud+H8kcvSCzDQQoc/gid7yZzb6eNfAkNN4UlEcS2cVVh924jevsOIb36d0In2g==}
     engines: {node: '>=22'}
@@ -379,162 +388,6 @@ packages:
   '@docsearch/sidepanel-js@4.7.0':
     resolution: {integrity: sha512-A8r34jCU8kcIk2viECEn2msA28ojUF1BLi/3v5OWWc5G2N3jOuuumBXoeYjfr8dA0UxgFSy5R2bt12dnFJQSyA==}
 
-  '@esbuild/aix-ppc64@0.27.7':
-    resolution: {integrity: sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==}
-    engines: {node: '>=18'}
-    cpu: [ppc64]
-    os: [aix]
-
-  '@esbuild/android-arm64@0.27.7':
-    resolution: {integrity: sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [android]
-
-  '@esbuild/android-arm@0.27.7':
-    resolution: {integrity: sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==}
-    engines: {node: '>=18'}
-    cpu: [arm]
-    os: [android]
-
-  '@esbuild/android-x64@0.27.7':
-    resolution: {integrity: sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [android]
-
-  '@esbuild/darwin-arm64@0.27.7':
-    resolution: {integrity: sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [darwin]
-
-  '@esbuild/darwin-x64@0.27.7':
-    resolution: {integrity: sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [darwin]
-
-  '@esbuild/freebsd-arm64@0.27.7':
-    resolution: {integrity: sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [freebsd]
-
-  '@esbuild/freebsd-x64@0.27.7':
-    resolution: {integrity: sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [freebsd]
-
-  '@esbuild/linux-arm64@0.27.7':
-    resolution: {integrity: sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [linux]
-
-  '@esbuild/linux-arm@0.27.7':
-    resolution: {integrity: sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==}
-    engines: {node: '>=18'}
-    cpu: [arm]
-    os: [linux]
-
-  '@esbuild/linux-ia32@0.27.7':
-    resolution: {integrity: sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==}
-    engines: {node: '>=18'}
-    cpu: [ia32]
-    os: [linux]
-
-  '@esbuild/linux-loong64@0.27.7':
-    resolution: {integrity: sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==}
-    engines: {node: '>=18'}
-    cpu: [loong64]
-    os: [linux]
-
-  '@esbuild/linux-mips64el@0.27.7':
-    resolution: {integrity: sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==}
-    engines: {node: '>=18'}
-    cpu: [mips64el]
-    os: [linux]
-
-  '@esbuild/linux-ppc64@0.27.7':
-    resolution: {integrity: sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==}
-    engines: {node: '>=18'}
-    cpu: [ppc64]
-    os: [linux]
-
-  '@esbuild/linux-riscv64@0.27.7':
-    resolution: {integrity: sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==}
-    engines: {node: '>=18'}
-    cpu: [riscv64]
-    os: [linux]
-
-  '@esbuild/linux-s390x@0.27.7':
-    resolution: {integrity: sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==}
-    engines: {node: '>=18'}
-    cpu: [s390x]
-    os: [linux]
-
-  '@esbuild/linux-x64@0.27.7':
-    resolution: {integrity: sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [linux]
-
-  '@esbuild/netbsd-arm64@0.27.7':
-    resolution: {integrity: sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [netbsd]
-
-  '@esbuild/netbsd-x64@0.27.7':
-    resolution: {integrity: sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [netbsd]
-
-  '@esbuild/openbsd-arm64@0.27.7':
-    resolution: {integrity: sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [openbsd]
-
-  '@esbuild/openbsd-x64@0.27.7':
-    resolution: {integrity: sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [openbsd]
-
-  '@esbuild/openharmony-arm64@0.27.7':
-    resolution: {integrity: sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [openharmony]
-
-  '@esbuild/sunos-x64@0.27.7':
-    resolution: {integrity: sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [sunos]
-
-  '@esbuild/win32-arm64@0.27.7':
-    resolution: {integrity: sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [win32]
-
-  '@esbuild/win32-ia32@0.27.7':
-    resolution: {integrity: sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==}
-    engines: {node: '>=18'}
-    cpu: [ia32]
-    os: [win32]
-
-  '@esbuild/win32-x64@0.27.7':
-    resolution: {integrity: sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [win32]
-
   '@hapi/address@5.1.1':
     resolution: {integrity: sha512-A+po2d/dVoY7cYajycYI43ZbYMXukuopIsqCjh5QzsBCipDtdofHntljDlpccMjIfTy6UOkg+5KPriwYch2bXA==}
     engines: {node: '>=14.0.0'}
@@ -579,6 +432,9 @@ packages:
   '@kwsites/promise-deferred@1.1.1':
     resolution: {integrity: sha512-GaHYm+c0O9MjZRu0ongGBRbinu8gVAMd2UZjji6jVmqKtZluZnptXGWhz1E8j8D2HJ3f/yMxKAUC0b+57wncIw==}
 
+  '@loaderkit/resolve@1.0.6':
+    resolution: {integrity: sha512-G8FdIoF5CypfwmD9rl8BXod5HDn8JqB0CCNBXDTaRZ+yRYhARrrSToX1zg1zy9jX3zLqigsELwhT4gNtkdQAUg==}
+
   '@lunariajs/core@0.1.1':
     resolution: {integrity: sha512-sAqM9+DVsLe3xHM9wu2pEnKGYMs/bWS9qpR+CGHol3RihOELnOQTzHddXbdB1MtgesbI8dnQuG64Ocd8KkWsng==}
     engines: {node: '>=18.17.0'}
@@ -672,13 +528,6 @@ packages:
       markdown-it:
         optional: true
 
-  '@napi-rs/lzma-linux-x64-gnu@1.5.1':
-    resolution: {integrity: sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==}
-    engines: {node: ^22.20 || ^24.12 || >=25}
-    cpu: [x64]
-    os: [linux]
-    libc: [glibc]
-
   '@nodelib/fs.scandir@2.1.5':
     resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
     engines: {node: '>= 8'}
@@ -694,6 +543,9 @@ packages:
   '@oxc-project/types@0.143.0':
     resolution: {integrity: sha512-u6JZdLBTLotrNC9Vd6vPssINdzcCzleKAH6EJKImQb7GtYvX5keN2dxkoK44stCc4tffE6QQRtZTXVSzsLUlWA==}
 
+  '@oxc-project/types@0.146.0':
+    resolution: {integrity: sha512-XC0QsnnhVe7sLIWmYmdPw7x5P0h4W8vUU3Nv1ySgWXtvCz8NizoAEpGXA0sOYoJQV2Rl13LgURAHQ5cI5ILCSA==}
+
   '@polka/compression@1.0.0-next.28':
     resolution: {integrity: sha512-aDmrBhgHJtxE+jy145WfhW9WmTAFmES/dNnn1LAs8UnnkFgBUj4T8I4ScQ9+rOkpDZStvnVP5iqhN3tvt7O1NA==}
     engines: {node: '>=6'}
@@ -701,36 +553,79 @@ packages:
   '@polka/url@1.0.0-next.29':
     resolution: {integrity: sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==}
 
+  '@publint/pack@0.1.7':
+    resolution: {integrity: sha512-4EDEmvxWtgsCnnVeBvtFIFZtUhPPt1+bA9JrSwU4Sa//6oKtzCSlGGXYJr44OD9aGISymbieJ4mCKHUygUDU+g==}
+    engines: {node: '>=18'}
+
+  '@quansync/fs@1.0.0':
+    resolution: {integrity: sha512-4TJ3DFtlf1L5LDMaM6CanJ/0lckGNtJcMjQ1NAV6zDmA0tEHKZtxNKin8EgPaVX1YzljbxckyT2tJrpQKAtngQ==}
+
+  '@rolldown/binding-android-arm-eabi@1.2.5':
+    resolution: {integrity: sha512-DLe/i+l8ynIBY7XEQ191TeZvCoowIGa18R+dIV30GW7DiOtp74i/xX8hs8GUjW5ARV7VZuie3d6AumSmCwbeRA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [android]
+
   '@rolldown/binding-android-arm64@1.2.3':
     resolution: {integrity: sha512-zrJtHDcaZJ1Fp7xf4hNl+7seH9Cn/N5TwLYkhgXREtBwAd/jaqW3uqeHxpDugJLVICWg4eW44kOQEGJ1r6jCGw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [android]
 
+  '@rolldown/binding-android-arm64@1.2.5':
+    resolution: {integrity: sha512-zXcwKlQApYAOELHd8PwKDFkagYF9Wy4e0RJ+0qnzl9Pjnpj75TEG8ufv40p2J7kCEfwZAsNiuzRIyNNMWT38ig==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [android]
+
   '@rolldown/binding-darwin-arm64@1.2.3':
     resolution: {integrity: sha512-ieIiibVCp0tX7TLu2cafoNPv8wJyYi01ekXpbf8q2j7F4rGAhhXb/eQh7ge9DRBY78GwmRQtvjZDux7EDbA8kA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [darwin]
 
+  '@rolldown/binding-darwin-arm64@1.2.5':
+    resolution: {integrity: sha512-dK4QakI42nzWgJT5sm4y4y/O//D4OxM75/cH28RLV+nzIN9AY+YsbuUVrUTjlLjXR6vpyxFbSsbmNuJ6BP9sww==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [darwin]
+
   '@rolldown/binding-darwin-x64@1.2.3':
     resolution: {integrity: sha512-Zh9tCon19eDXJoihx0rqKhMUlMYqzwj3aPsSuHmI4RWZh62dWUL+DJN4C5YQya5TcQBJU/Fe8+rY0jhXTQITqA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [darwin]
 
+  '@rolldown/binding-darwin-x64@1.2.5':
+    resolution: {integrity: sha512-fqSALaUu1Wjd1nK2uW2kJDWdLCc8lx1IcY+MTY26Aurfdx19anlzhqXOgCFbBFQnlFDTn4TC1/7Nz4Bl2mLP3A==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [darwin]
+
   '@rolldown/binding-freebsd-x64@1.2.3':
     resolution: {integrity: sha512-nGbJWewA1wrXXZiQhjAT5rhibGfns5ZNkDVqxsO6zJ3f3YvpoDNNmGMSbbhLuXKjNScaBJVOAboztAWVespQMg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [freebsd]
 
+  '@rolldown/binding-freebsd-x64@1.2.5':
+    resolution: {integrity: sha512-/vCnNxlkxs9tKxNDcyWUePpJ/PgTzxIaVhoM5SmG8UV+GR/IcPam4VYxi7GIMo7PSDuNqlJqvprqii9NqqVCMw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [freebsd]
+
   '@rolldown/binding-linux-arm-gnueabihf@1.2.3':
     resolution: {integrity: sha512-QNniJr5Kml0kDEB98jiDOJjXNroxIIi0IXIbdYzY26Xt1pVbeP62+KnoIZLwirOymX/0jDk/2gI/bNUv7A7OIw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [linux]
 
+  '@rolldown/binding-linux-arm-gnueabihf@1.2.5':
+    resolution: {integrity: sha512-abk0NLA519LxRCszmbE0jYKuQ9YPocOXTiOXOo6Yr+YAT95VH+PtqYAjOJvGKt3viEd/x4qzabAlwd5bHOOARg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm]
+    os: [linux]
+
   '@rolldown/binding-linux-arm64-gnu@1.2.3':
     resolution: {integrity: sha512-TkqEAcmmvH3I/q4114NB4RVt6241Dao48pF45uLcFGrwAaIn0iITgTAKP/dLjbN0R4buJjGb91+UHSoFmpgIWw==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -738,6 +633,13 @@ packages:
     os: [linux]
     libc: [glibc]
 
+  '@rolldown/binding-linux-arm64-gnu@1.2.5':
+    resolution: {integrity: sha512-Y7eALiJ8lr0M2HH103Js+g7V34wf6snlpZLAsHI90uLhr3PVlNsbFVAXJC9d/V6BnPyKtpSwI+NcB/RLxsQxuA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
   '@rolldown/binding-linux-arm64-musl@1.2.3':
     resolution: {integrity: sha512-NHqjnxpsndf4MPymxteFAWHHfkTL8HjWh1KB7z23ofZ6QO2euONuxDXjat69dKZRALnGypg8k8SsK8vZJoXv1Q==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -745,6 +647,13 @@ packages:
     os: [linux]
     libc: [musl]
 
+  '@rolldown/binding-linux-arm64-musl@1.2.5':
+    resolution: {integrity: sha512-xMvZgnbZg4YVnR/AX2b3oOPDTFYJvUVaJg5FedA/LuvexAtXibZQej4cnTkw3rjsJ/ggUROB64TdtETiim+FYA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
   '@rolldown/binding-linux-ppc64-gnu@1.2.3':
     resolution: {integrity: sha512-6tbrbwfz5GB9DQ4Jwo6hy9v+vR31xZlvzZ6n5Xut6Hhx5PvrA9q/HsK8KMaYQp063iqZGXwNvZtYNLD7EM/x0w==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -752,6 +661,13 @@ packages:
     os: [linux]
     libc: [glibc]
 
+  '@rolldown/binding-linux-ppc64-gnu@1.2.5':
+    resolution: {integrity: sha512-GRjeqTUDHTo5GwntsLaAMcBahG3nlpjftXWZLN73HiYQlhwEowvarFgQnRnQZtIp4keXX7quXFbG38uPZBa2EA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [ppc64]
+    os: [linux]
+    libc: [glibc]
+
   '@rolldown/binding-linux-s390x-gnu@1.2.3':
     resolution: {integrity: sha512-oyuXxXmoZHjXC917IAPFAAv4wWAa0cM9afk8nx1+9/jNNOX1uPf8yDA6p7G0RypOfw/X0PQt5IfoquY1um+zSg==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -759,6 +675,13 @@ packages:
     os: [linux]
     libc: [glibc]
 
+  '@rolldown/binding-linux-s390x-gnu@1.2.5':
+    resolution: {integrity: sha512-vLNTR45F2Uwc8AufkNXPmB4VliaXs+FvcheEogIzOXzO4l+LzieXF5A/TWxLy5HtqpsRCHUfd0lPVrrdgXdLHQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [s390x]
+    os: [linux]
+    libc: [glibc]
+
   '@rolldown/binding-linux-x64-gnu@1.2.3':
     resolution: {integrity: sha512-TytMwF2KVGqP2tgd0I1OY0PAv78dZRAYcF5ssDzjM34SUXCED3uXvSd5+lHoC0bTD6eEdFz7LdQNCO1y0oVk9w==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -766,6 +689,13 @@ packages:
     os: [linux]
     libc: [glibc]
 
+  '@rolldown/binding-linux-x64-gnu@1.2.5':
+    resolution: {integrity: sha512-Mgj59/HTuYeK9Gz2MA+mBWKnHsAgkBSec15ZMb1st3oIfFbX7gCjOae7GydHhzcyQi9Z/7M1QuN9bR3oFqF0jQ==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
   '@rolldown/binding-linux-x64-musl@1.2.3':
     resolution: {integrity: sha512-/E9m3qstrJFVPoULV25mVQblSNExY2+kBsYe4sy0Tn0yOOgJ8wZbZt3KnRbF/XeU2Gl1STKUQnDNTqhIE5MD4A==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -773,219 +703,52 @@ packages:
     os: [linux]
     libc: [musl]
 
+  '@rolldown/binding-linux-x64-musl@1.2.5':
+    resolution: {integrity: sha512-mY8AP0/ichsbhAxGnLa3d3+MwV0EfgrPND2bplI3Ym8T6R2pJ0N87bvrKVwNXmdy3jnr6eQBecdqx/HMknBmpA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
   '@rolldown/binding-openharmony-arm64@1.2.3':
     resolution: {integrity: sha512-Kr0OcsoQI816i6HOl3vFHpd1K0eZyh76zgfj4c1nTyaTsd5r2Mj1lwM4R90y/qaCfmTn9eHy0SKwi98eitRxug==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [openharmony]
 
+  '@rolldown/binding-openharmony-arm64@1.2.5':
+    resolution: {integrity: sha512-8SLssA2oweAxyRgDp789ACfRb/3P+zNRJpzZxSizxF9m8NUDQ4+3xjo8ttjhVGGw6Qxb70oZiEtIjaKikCO7Yw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+    cpu: [arm64]
+    os: [openharmony]
+
   '@rolldown/binding-win32-arm64-msvc@1.2.3':
     resolution: {integrity: sha512-hOtMwTqnME+/gJcH/PCZ0wn0zPUjiWOgkHpxbSJpfGKMezHltx1S7/k1SitzVa7Ww2cqrDDaFbZEhcJZO8o+Jw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [win32]
 
-  '@rolldown/binding-win32-x64-msvc@1.2.3':
-    resolution: {integrity: sha512-ekcqMMkI2PlhYnfzQnB/cEdYUVVJViWvoUyLrbzgDoi3Snfc1mVBwdnc306ufA5ejy8JSPjT2RlW1nQSjW7efg==}
+  '@rolldown/binding-win32-arm64-msvc@1.2.5':
+    resolution: {integrity: sha512-vGbruD5zquhoc8D9SViXgN2FBJtNdTyQ4DtG+SWiEGlJiAzoKcZ2xp+xuXCffhubVdt0NJlTZqkeRuERy7g8Cw==}
     engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [x64]
-    os: [win32]
-
-  '@rolldown/pluginutils@1.0.1':
-    resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
-
-  '@rollup/plugin-alias@6.0.0':
-    resolution: {integrity: sha512-tPCzJOtS7uuVZd+xPhoy5W4vThe6KWXNmsFCNktaAh5RTqcLiSfT4huPQIXkgJ6YCOjJHvecOAzQxLFhPxKr+g==}
-    engines: {node: '>=20.19.0'}
-    peerDependencies:
-      rollup: '>=4.0.0'
-    peerDependenciesMeta:
-      rollup:
-        optional: true
-
-  '@rollup/plugin-commonjs@29.0.3':
-    resolution: {integrity: sha512-ZaOxZceP7SOUW7Lqw5IRVweSQYWaeIPnXIGLiB690EBA3FGJTO40EEr2L5yZplJWsgTCogILRSpcAe7+U0Otdg==}
-    engines: {node: '>=16.0.0 || 14 >= 14.17'}
-    peerDependencies:
-      rollup: ^2.68.0||^3.0.0||^4.0.0
-    peerDependenciesMeta:
-      rollup:
-        optional: true
-
-  '@rollup/plugin-json@6.1.0':
-    resolution: {integrity: sha512-EGI2te5ENk1coGeADSIwZ7G2Q8CJS2sF120T7jLw4xFw9n7wIOXHo+kIYRAoVpJAN+kmqZSoO3Fp4JtoNF4ReA==}
-    engines: {node: '>=14.0.0'}
-    peerDependencies:
-      rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
-    peerDependenciesMeta:
-      rollup:
-        optional: true
-
-  '@rollup/plugin-node-resolve@16.0.3':
-    resolution: {integrity: sha512-lUYM3UBGuM93CnMPG1YocWu7X802BrNF3jW2zny5gQyLQgRFJhV1Sq0Zi74+dh/6NBx1DxFC4b4GXg9wUCG5Qg==}
-    engines: {node: '>=14.0.0'}
-    peerDependencies:
-      rollup: ^2.78.0||^3.0.0||^4.0.0
-    peerDependenciesMeta:
-      rollup:
-        optional: true
-
-  '@rollup/plugin-replace@6.0.3':
-    resolution: {integrity: sha512-J4RZarRvQAm5IF0/LwUUg+obsm+xZhYnbMXmXROyoSE1ATJe3oXSb9L5MMppdxP2ylNSjv6zFBwKYjcKMucVfA==}
-    engines: {node: '>=14.0.0'}
-    peerDependencies:
-      rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
-    peerDependenciesMeta:
-      rollup:
-        optional: true
-
-  '@rollup/pluginutils@5.4.0':
-    resolution: {integrity: sha512-MfPp06CjRLfXQ3wY0R8vJDYBy/MvVcc9OulEfR0B8Iv9ko+GCNaRZ+EpJYFl27LhKsZK0o420sYCRHCjfCgeUg==}
-    engines: {node: '>=14.0.0'}
-    peerDependencies:
-      rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
-    peerDependenciesMeta:
-      rollup:
-        optional: true
-
-  '@rollup/rollup-android-arm-eabi@4.62.4':
-    resolution: {integrity: sha512-RrPokAb7dmbxFoeO3TloqHyOjgye8RkBhSqmp4aJMIex4c9r46ZstPnleDQOq1t46VOVjwIuwNogIqbodV1Vvg==}
-    cpu: [arm]
-    os: [android]
-
-  '@rollup/rollup-android-arm64@4.62.4':
-    resolution: {integrity: sha512-JKuJc+pnpks2pjy7L/N3v/cAkZxYlnmuZoD840ldbMI5KDbC4iO9NKwPKYdjYFCMAIIlBzYSFHxIJVYzRo2/8A==}
-    cpu: [arm64]
-    os: [android]
-
-  '@rollup/rollup-darwin-arm64@4.62.4':
-    resolution: {integrity: sha512-krw5uS2STmvJ02x0uTXHbqQNuz+9eZ1iw+qXk9dmW2gvV4jV7O2hEoOnuhFrpOPiel1mBFtqbxYZZtC46hXLOw==}
-    cpu: [arm64]
-    os: [darwin]
-
-  '@rollup/rollup-darwin-x64@4.62.4':
-    resolution: {integrity: sha512-wsTxtgApb4PrOsNJIm0FZ1h3WvCC+k9uxLJ4ad75hgoS4NiRes2SoJFlDAyMwiUY8IssDqGcHbXuN0sx1tfF1A==}
-    cpu: [x64]
-    os: [darwin]
-
-  '@rollup/rollup-freebsd-arm64@4.62.4':
-    resolution: {integrity: sha512-GUOnQlyZe3yAXhWOtOMsn5Qkrv5E5mZXa0thbARWi5Ei2szlVXJFQhddZ4HbAzh8q92w5twp+CQvs/eFanz9YQ==}
-    cpu: [arm64]
-    os: [freebsd]
-
-  '@rollup/rollup-freebsd-x64@4.62.4':
-    resolution: {integrity: sha512-/Y7f3QuxjzPKsjA/rfEDa3+0vXqyjmJ50Ln8dPpCmWkKTrUoWHG1cWhTqaAMLob2m2nESWuC7yGrREz019Ztqg==}
-    cpu: [x64]
-    os: [freebsd]
-
-  '@rollup/rollup-linux-arm-gnueabihf@4.62.4':
-    resolution: {integrity: sha512-81wiiX3v7aqy+T+bT61TJ78yJjRquqFFTTbAPt08imfQQzkPIW8t6aJbkTagtCCrXMNc9D66+geqlK7ydLPNqA==}
-    cpu: [arm]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-arm-musleabihf@4.62.4':
-    resolution: {integrity: sha512-9kmDIvNZqdoHOBZgNtpTBeLWYO/LVipM3H/j62P8848/l/VPEQL6N3uxU9pvP1oZAsXyC2MEnFP3ovRjo7WYNQ==}
-    cpu: [arm]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-arm64-gnu@4.62.4':
-    resolution: {integrity: sha512-CcnXHWnXg69g+DX5VWL3FHts3qMRN2uVEHX+BZvGLdd07/gXkn3ePjYtO1LDJvxkGKVHMclKBRa1QUTH+6toYQ==}
-    cpu: [arm64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-arm64-musl@4.62.4':
-    resolution: {integrity: sha512-iFOibiHnTRuhrWLlRsOQFdZJJIa7S8OwkneJr4ocALP16u5yk6lWLINFwhHaEqBFMsKDUZofLkGos7+CPzGB3g==}
-    cpu: [arm64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-loong64-gnu@4.62.4':
-    resolution: {integrity: sha512-XnWYMI7euHlb5a871xPja+Gm7DRCFU+FGRrtS2sMq9N8FvqtpagUy6gD4YOemC5MRk9xbh8+jYMEJbigFQwsgA==}
-    cpu: [loong64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-loong64-musl@4.62.4':
-    resolution: {integrity: sha512-qGDAlO0U8xedCcsdRm9oaoQY8DAx/QT7uIxJWhCdx0ceIWX783UC9QSYkdpzAe29wNiVfp24+bZdQmn49o45SQ==}
-    cpu: [loong64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-ppc64-gnu@4.62.4':
-    resolution: {integrity: sha512-ru4H6ezD7ysA5EiEK6qkkaEb4modH8CTej6kUy/gQi20u3kB3G7Zn8snXXkeJSCOFKG/rbPPtM/+9Wgas1961w==}
-    cpu: [ppc64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-ppc64-musl@4.62.4':
-    resolution: {integrity: sha512-2W4MO5WQVJnbJaZdvDb9rhBDuFU1nKIepPFpJUBsTh2k1YY2g+ODViaWuyOAjQ5cOP7NvrvLzt3wvHOoiAvc7w==}
-    cpu: [ppc64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-riscv64-gnu@4.62.4':
-    resolution: {integrity: sha512-+fxjfuoAmVMCYV5QyjoIpu0cp5DOiOTeqYFk1AVaxGr+/ravWLX89XfQmptsoWcaVy/TGf2hexzbUOrCQIL1CQ==}
-    cpu: [riscv64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-riscv64-musl@4.62.4':
-    resolution: {integrity: sha512-jTn8JfHGL4djjFxPuM06LmNUJDsst2jeVlsd9OmIH6zc5sC9K6rIuO4YajXatLUpBmBKl6b35ro1QZocLi+tcA==}
-    cpu: [riscv64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-s390x-gnu@4.62.4':
-    resolution: {integrity: sha512-oCJCJL4pXsoDcP2QZ+JVlPTIRc6266zsIaeJJsWImmF7HO0W8nb6HuSgZlMWxJwaPf8ehbSw8yo0EUw925hKsA==}
-    cpu: [s390x]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-x64-gnu@4.62.4':
-    resolution: {integrity: sha512-W69hukhZ3KKNRCaMIEzKvcFye42hh0FE1+YoYaf5+Ikacuftoco6yO/xouz0hc5d5W/s3yBro5jRiuEE/Q5vUw==}
-    cpu: [x64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-x64-musl@4.62.4':
-    resolution: {integrity: sha512-qiXbGG2jkjXhzXpsFZSR2Xpb8DN/UaxYsbb/STbuR/6fpaDgRmmaq1B/LmtF2wQFOFOSsK2jdE0RZ3a0zHn4QA==}
-    cpu: [x64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-openbsd-x64@4.62.4':
-    resolution: {integrity: sha512-nWeM//hxv8mIo6jD7Hu4o48DVmV9pbV6gsKaWU+4NFyqHoPKwrkRiZGLKUhOBk8qNmDmpwFtPKg80Bo/Tn4xiQ==}
-    cpu: [x64]
-    os: [openbsd]
-
-  '@rollup/rollup-openharmony-arm64@4.62.4':
-    resolution: {integrity: sha512-s62SQ/vgsRSvMwDkOEfTqfgASF0f26ZNaQuTA6Aok5lrikf89yI2W0gFHvZb2Jpgc6N8JnOKZgCK2iciO3CsxQ==}
-    cpu: [arm64]
-    os: [openharmony]
-
-  '@rollup/rollup-win32-arm64-msvc@4.62.4':
-    resolution: {integrity: sha512-J6wGf8TVGbXJq+HH+ttTvrcfNKPbuZecV6KT1B8I18BC5IURUh5kl4Yl5OEP5eFIUoI5BWxCsyYMhFsDx8kekw==}
     cpu: [arm64]
     os: [win32]
 
-  '@rollup/rollup-win32-ia32-msvc@4.62.4':
-    resolution: {integrity: sha512-zmfrQd/0wu6oJs8Vq8KwY/YtsKSsLtKe/HwAP4Wqy8LhWjeT55fHRAkOhYQ12wI3ayS4Tt12d5CDRD7N96SAYQ==}
-    cpu: [ia32]
-    os: [win32]
-
-  '@rollup/rollup-win32-x64-gnu@4.62.4':
-    resolution: {integrity: sha512-qPzHqdj9rfUD+w79dtE07zi/kFwKyCJqplp5K5ygeLTp7jLpAoc16OAH39HSmRC9UpozaecsleI8uAdEj6v2yw==}
+  '@rolldown/binding-win32-x64-msvc@1.2.3':
+    resolution: {integrity: sha512-ekcqMMkI2PlhYnfzQnB/cEdYUVVJViWvoUyLrbzgDoi3Snfc1mVBwdnc306ufA5ejy8JSPjT2RlW1nQSjW7efg==}
+    engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [win32]
 
-  '@rollup/rollup-win32-x64-msvc@4.62.4':
-    resolution: {integrity: sha512-zD6NdeWEByGE9QF9vCrlJ5YQB4oq9q91kPZS37Jwj5hOkvR1lTBSpsKhKDw4IJtbQ35LsTS1HD9DZYGKIshU1Q==}
+  '@rolldown/binding-win32-x64-msvc@1.2.5':
+    resolution: {integrity: sha512-e/SXpgISz+IoqVcSSI0rx/d/he8zqLex+/rCWpnHpmVfmPIUjag9H6P7zotf0gJHwPUhQxZ/mF8tr6acebT9yw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [win32]
 
+  '@rolldown/pluginutils@1.0.1':
+    resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
+
   '@shikijs/core@4.4.3':
     resolution: {integrity: sha512-QCR4q2ZO/ILJEuwiBMel4wdcTDb1JGwfjKTxPDF6x8ixOaluPrVqIn06C99AcRPhmYlBR56d/Fb+GN58GzExpg==}
     engines: {node: '>=20'}
@@ -1043,6 +806,10 @@ packages:
     resolution: {integrity: sha512-fCTuZK4QBa+39Oz9l4OGfJfz+GpwCp3AqO7Zch3to99xHPgstVsRFpeQ8LNd2o1Gv8raL2mCFwiaHh7bFSp5DQ==}
     engines: {node: '>=22'}
 
+  '@sindresorhus/is@4.6.0':
+    resolution: {integrity: sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==}
+    engines: {node: '>=10'}
+
   '@standard-schema/spec@1.1.0':
     resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
 
@@ -1110,9 +877,6 @@ packages:
   '@types/picomatch@4.0.3':
     resolution: {integrity: sha512-iG0T6+nYJ9FAPmx9SsUlnwcq1ZVRuCXcVEvWnntoPlrOpwtSTKNDC9uVAxTsC3PUvJ+99n4RpAcNgBbHX3JSnQ==}
 
-  '@types/resolve@1.20.2':
-    resolution: {integrity: sha512-60BCwRFOZCQhDncwQdxxeOEEkbc5dIMccYLwbxsS4TUNeVECQ/pBJ0j09mrHOl/JJvpRPGwO9SvE4nR2Nb/a4Q==}
-
   '@types/sax@1.2.7':
     resolution: {integrity: sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==}
 
@@ -1199,8 +963,8 @@ packages:
   '@vue/devtools-shared@8.2.1':
     resolution: {integrity: sha512-Fkac7lUdGReh6pVOi3AYPRGe82LQqRmAfThW7RRligOAP0ZA/Z1z9XLHDM9dv34pV2HRc79DK8uKPeG2fLnA/g==}
 
-  '@vue/language-core@3.3.9':
-    resolution: {integrity: sha512-in/68oAa4BCtVY6n/nkuhLIkV8DHYd2UivedJ6cMZ6UYtlq9jaoaSNUBHYCVO44z3nKg7MdE5OBoHKt5SxeBKQ==}
+  '@vue/language-core@3.3.11':
+    resolution: {integrity: sha512-QJmpliwAVpC/OxubIByPAhNzsQPRc8/gxlN2qnVzVfIMjMDz/9RnXRFoetjz5yEgXVXyp4LqhXq3V53PjmNzFw==}
 
   '@vue/reactivity@3.5.41':
     resolution: {integrity: sha512-rznsqKM0np0x18EjzF8x88MpEhdNsffbvFbckLL5+oUKz1BxAImEmO7J1ArRYSyo6aQaVoBDp7jEkT91OOxydA==}
@@ -1272,9 +1036,145 @@ packages:
     peerDependencies:
       vue: ^3.5.0
 
-  '@xmldom/xmldom@0.9.10':
-    resolution: {integrity: sha512-A9gOqLdi6cV4ibazAjcQufGj0B1y/vDqYrcuP6d/6x8P27gRS8643Dj9o1dEKtB6O7fwxb2FgBmJS2mX7gpvdw==}
-    engines: {node: '>=14.6'}
+  '@xmldom/xmldom@0.9.10':
+    resolution: {integrity: sha512-A9gOqLdi6cV4ibazAjcQufGj0B1y/vDqYrcuP6d/6x8P27gRS8643Dj9o1dEKtB6O7fwxb2FgBmJS2mX7gpvdw==}
+    engines: {node: '>=14.6'}
+    deprecated: this version has critical issues, please update to the latest version
+
+  '@yuku-codegen/binding-android-arm64@0.8.7':
+    resolution: {integrity: sha512-C/0zV5IhgVdYhGJTwrY0v8dknxlhiKwtVJkMUaexu9/QvRmzlV4vfU3hZlUSgqc2BxQHntL1mCVbDq8j0FRFDw==}
+    cpu: [arm64]
+    os: [android]
+
+  '@yuku-codegen/binding-darwin-arm64@0.8.7':
+    resolution: {integrity: sha512-/u+REDMI4a0/lsJXTM4c53/w31OGZLOReZIyg62uhgLs0kc8NHsj/nOcxTdlQjq5gi0zhdkccD9LaLTXcdzPvw==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@yuku-codegen/binding-darwin-x64@0.8.7':
+    resolution: {integrity: sha512-sMMzFOwCo4WXR+/6zIBThOocSC50iIIZZdfiIDbaLvj0Ax/rWt/iavyfEAqajyvzydLyCqR/ZItdLWSRlu1umw==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@yuku-codegen/binding-freebsd-x64@0.8.7':
+    resolution: {integrity: sha512-MpdpKXix9P+Y1rKgjvcNeNtGjXeL1CmttNhYINrWls8kRpm4xM/oBGTmn6w7to8lAlwj5jm8q03dQPl5mRv4Qw==}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@yuku-codegen/binding-linux-arm-gnu@0.8.7':
+    resolution: {integrity: sha512-rr1srFLlPAmC1vtxfc9C1YLDe3iH09YjfSeeIidBqKhzx1MATjOAq4mjlRUOnhr/L27MotWIYOFKwVsd5JZFOg==}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-codegen/binding-linux-arm-musl@0.8.7':
+    resolution: {integrity: sha512-eAufXh8qBRpiSO6ueaMDL+yyoXIGLhpUce72YbcACtZU2qhExwBIJyEtQf5kH2Ki0X2aqkSjSfog4OPtKXan3Q==}
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-codegen/binding-linux-arm64-gnu@0.8.7':
+    resolution: {integrity: sha512-gw4w6wPoHObBrdIC4duVWLmJOvpdE25j5D7yrM5mACNlK4klRz/lv8hK+ssQk9EJHBgZjSaqZIJVFgqNYbfv7A==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-codegen/binding-linux-arm64-musl@0.8.7':
+    resolution: {integrity: sha512-L68N6Y4XkqcIaKo3Ra88JEvBEH4AHff44A4INcrxeVWZ8CZtu2tCpfVxe3hR8qQQMcvBSQlDn24KpkCKEhVvfA==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-codegen/binding-linux-x64-gnu@0.8.7':
+    resolution: {integrity: sha512-dzyAbltJmf3Cqlb8HcFuYIf5Yn0fl1vTr3XJ9HiVNNvOlhqPSArOqtw9vI1p6/VTXTjrMLXlU+s+/kNHiIy/Cw==}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-codegen/binding-linux-x64-musl@0.8.7':
+    resolution: {integrity: sha512-Otw4MH3404q0Bbvl+YTdW9aoUV5vXmUw8260bWvt1XlaoIX/ceSgI4ygheRDMfBPoHt6FDayQaO9OLVUZAgkFA==}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-codegen/binding-win32-arm64@0.8.7':
+    resolution: {integrity: sha512-qo/jyrzryiBuKEsFiuWaBCBe3tRMynQ0qFWFgOEjcCMQeZfBm+wKiVEUEFXXLc7bh8YezguAWp0Mtnhq4ARNyA==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@yuku-codegen/binding-win32-x64@0.8.7':
+    resolution: {integrity: sha512-D5lDsVDx6m00E6bWySlWdH72Ca4TPSaphDqB6QjU6MpuNLIJqoGoatYyq2rOmBE8Zv/kunot/o58KGL03P3eiA==}
+    cpu: [x64]
+    os: [win32]
+
+  '@yuku-parser/binding-android-arm64@0.8.7':
+    resolution: {integrity: sha512-eGKYiUDX7Y0V7tDTmg+JTVnXnjMqfXXsorZ+EDf5kxwchQ3Or1HS14MzI2fw+jFhHR85fCWt+mtX33Yao73hIQ==}
+    cpu: [arm64]
+    os: [android]
+
+  '@yuku-parser/binding-darwin-arm64@0.8.7':
+    resolution: {integrity: sha512-Re0RHelKLnjEURulY2/KxW+Ngb8zuNA4BRZuMwgGQNzVumT6u4U2N2hc01oeYVNVof0i7GrXE4UCNBgbpRRnjQ==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@yuku-parser/binding-darwin-x64@0.8.7':
+    resolution: {integrity: sha512-Hn8DROtQkjlA1ACbPgj4a7eP9IuVOI504oiTwpkWPbpaDWD9KdmnVYCqW+1LfenNK/g7O9NhWGpXEdaCNX7lIA==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@yuku-parser/binding-freebsd-x64@0.8.7':
+    resolution: {integrity: sha512-bAP2OV8wRuzplX/jYxv9+vvqQT8JxyNphI8fLfXGL054Xs+4/J5u33cIm3y4rxY8rdoLmmdiJs2Tq7r7lrDRfA==}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@yuku-parser/binding-linux-arm-gnu@0.8.7':
+    resolution: {integrity: sha512-kTYwJQQgmZeAWdDIWabiReIZMpmfLueIj1tCmjStUtFGhR1Z0qwxonKVfUC4N7h/VhGGzLZ//7O1kgt1QKqgCg==}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-parser/binding-linux-arm-musl@0.8.7':
+    resolution: {integrity: sha512-uL4jE8HPT2BLlxAXyD10LqgPuXa9eDa0BKpCdSANmzIJghq/2eZo3/gQNtaxPZMupWoxjYzSad9IXrwu7aYPXQ==}
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-parser/binding-linux-arm64-gnu@0.8.7':
+    resolution: {integrity: sha512-3gVN4pWSKZmXiNX7cU164dR9MPvesCHnlH6nPfpK+yQsCuYphjKKplcb4SnZBrhiqmXbgb2HR0c2TS0IZUPhgA==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-parser/binding-linux-arm64-musl@0.8.7':
+    resolution: {integrity: sha512-S0mwfEjoLpxzXeZw802Wa4RaELsQiPtWqG6INcy8j4GtvNFtl4LCX3eGO1XLn9pyLAISLzTRyU3zUCBUPin8lg==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-parser/binding-linux-x64-gnu@0.8.7':
+    resolution: {integrity: sha512-lnbWdPmerE5D1uH1G4IEZKnPzCrWCStRGrtgpSIe1RibAo5bZIjDbbbPYXmMHCEh4F+x/JaJpElh26a3r+BPbg==}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-parser/binding-linux-x64-musl@0.8.7':
+    resolution: {integrity: sha512-769uwndMvMzUvATWbAcEvyLHKA+DzhHSCl/obBUrRdYfRo26yxui6S8y3z7uJ+Naup7UKrDxrpK7OnQkxkl9KQ==}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-parser/binding-win32-arm64@0.8.7':
+    resolution: {integrity: sha512-mEB/9PlaAkisJ6KWGz0zvywXoU6+80dTlR2LwS7s/jcXXoU6fm2+sitBZXtqu3+Q4DcDgPxM45uWMCzPs0TSRw==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@yuku-parser/binding-win32-x64@0.8.7':
+    resolution: {integrity: sha512-8vNB2DP0ou61nGb8tc/qfi41gfyDXz1MHr2zqL3nR+cJ6CEbiuWV/l/a/vv151gCgiZLLAyGkQGENpozdg716w==}
+    cpu: [x64]
+    os: [win32]
+
+  '@yuku-toolchain/types@0.8.7':
+    resolution: {integrity: sha512-2Z53dNxAJL6UvFoIrDZvYf3zlO8s4VJK4O2hhaB4mXVwwpX/7ajtss3cmfqKvamlNLWyt9FSWs4eoYdlbxpnHA==}
 
   agent-base@6.0.2:
     resolution: {integrity: sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==}
@@ -1287,6 +1187,10 @@ packages:
     resolution: {integrity: sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==}
     engines: {node: '>=6'}
 
+  ansi-escapes@7.3.0:
+    resolution: {integrity: sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==}
+    engines: {node: '>=18'}
+
   ansi-regex@5.0.1:
     resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
     engines: {node: '>=8'}
@@ -1299,6 +1203,13 @@ packages:
     resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
     engines: {node: '>=8'}
 
+  ansis@4.3.1:
+    resolution: {integrity: sha512-BJ8/l4R5LRE7hW9WdSuGYrLSHi2ynxeFpDFbH0K/CgNeY/tyhk+vO6TYxXC5r5CpUhNVX310xzPsN/H9lCdfOA==}
+    engines: {node: '>=14'}
+
+  any-promise@1.3.0:
+    resolution: {integrity: sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==}
+
   arg@5.0.2:
     resolution: {integrity: sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==}
 
@@ -1347,6 +1258,10 @@ packages:
     resolution: {integrity: sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==}
     engines: {node: '>=18'}
 
+  cac@7.0.0:
+    resolution: {integrity: sha512-tixWYgm5ZoOD+3g6UTea91eow5z6AAHaho3g0V9CNSNb45gM8SmflpAc+GRd1InC4AqN/07Unrgp56Y94N9hJQ==}
+    engines: {node: '>=20.19.0'}
+
   call-bind-apply-helpers@1.0.2:
     resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==}
     engines: {node: '>= 0.4'}
@@ -1358,10 +1273,18 @@ packages:
     resolution: {integrity: sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==}
     engines: {node: '>=18'}
 
+  chalk@4.1.2:
+    resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
+    engines: {node: '>=10'}
+
   chalk@5.6.2:
     resolution: {integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==}
     engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
 
+  char-regex@1.0.2:
+    resolution: {integrity: sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==}
+    engines: {node: '>=10'}
+
   character-entities-html4@2.1.0:
     resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
 
@@ -1378,18 +1301,29 @@ packages:
     resolution: {integrity: sha512-g0J0q/O6mW8z5zxQ3A8E8J1hUgp4SMOvEoW/x84OwyHKe/Zccz83PVT4y5Crcr530FV6NgmKI1qvGTKVl9XXVw==}
     engines: {node: '>= 6'}
 
-  chokidar@5.0.0:
-    resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==}
-    engines: {node: '>= 20.19.0'}
+  cjs-module-lexer@1.4.3:
+    resolution: {integrity: sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==}
 
   cli-cursor@5.0.0:
     resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==}
     engines: {node: '>=18'}
 
+  cli-highlight@2.1.11:
+    resolution: {integrity: sha512-9KDcoEVwyUXrjcJNvHD0NFc/hiwe/WPVYIleQh2O1N2Zro5gWJZ/K+3DGn8w8P/F6FxOgzyC5bxDyHIgCSPhGg==}
+    engines: {node: '>=8.0.0', npm: '>=5.0.0'}
+    hasBin: true
+
   cli-spinners@3.4.0:
     resolution: {integrity: sha512-bXfOC4QcT1tKXGorxL3wbJm6XJPDqEnij2gQ2m7ESQuE+/z9YFIWnl/5RpTiKWbMq3EVKR4fRLJGn6DVfu0mpw==}
     engines: {node: '>=18.20'}
 
+  cli-table3@0.6.5:
+    resolution: {integrity: sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==}
+    engines: {node: 10.* || >= 12.*}
+
+  cliui@7.0.4:
+    resolution: {integrity: sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==}
+
   cliui@8.0.1:
     resolution: {integrity: sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==}
     engines: {node: '>=12'}
@@ -1408,6 +1342,10 @@ packages:
   comma-separated-tokens@2.0.3:
     resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}
 
+  commander@10.0.1:
+    resolution: {integrity: sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug==}
+    engines: {node: '>=14'}
+
   commander@13.1.0:
     resolution: {integrity: sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==}
     engines: {node: '>=18'}
@@ -1416,9 +1354,6 @@ packages:
     resolution: {integrity: sha512-U7VdrJFnJgo4xjrHpTzu0yrHPGImdsmD95ZlgYSEajAn2JKzDhDTPG9kBTefmObL2w/ngeZnilk+OV9CG3d7UA==}
     engines: {node: '>= 6'}
 
-  commondir@1.0.1:
-    resolution: {integrity: sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==}
-
   conventional-changelog-angular@9.2.1:
     resolution: {integrity: sha512-oWSL6ZhnXbYraOFTK3PgRAQJ8fADDAEv5K6AdeyQPLvjFmhG8+ejL0jZZp/R7vTmGJaBvZEE+sE7dB4bCv7sAw==}
     engines: {node: '>=22'}
@@ -1484,10 +1419,6 @@ packages:
   decode-named-character-reference@1.3.0:
     resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==}
 
-  deepmerge@4.3.1:
-    resolution: {integrity: sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==}
-    engines: {node: '>=0.10.0'}
-
   default-browser-id@5.0.1:
     resolution: {integrity: sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==}
     engines: {node: '>=18'}
@@ -1500,6 +1431,9 @@ packages:
     resolution: {integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==}
     engines: {node: '>=12'}
 
+  defu@6.1.7:
+    resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==}
+
   delayed-stream@1.0.0:
     resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==}
     engines: {node: '>=0.4.0'}
@@ -1532,6 +1466,15 @@ packages:
   domutils@2.8.0:
     resolution: {integrity: sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==}
 
+  dts-resolver@3.0.0:
+    resolution: {integrity: sha512-1T1f+z+4tl9XD+m+0HBgWoL/nm0bOIffyWaUuUSBlFg/86IWvfx+wjNaO/ybU0AJzG9/Mi5hBUgGV6zCmWEN7Q==}
+    engines: {node: ^22.18.0 || >=24.0.0}
+    peerDependencies:
+      oxc-resolver: '>=11.0.0'
+    peerDependenciesMeta:
+      oxc-resolver:
+        optional: true
+
   dunder-proto@1.0.1:
     resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
     engines: {node: '>= 0.4'}
@@ -1539,6 +1482,13 @@ packages:
   emoji-regex@8.0.0:
     resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
 
+  emojilib@2.4.0:
+    resolution: {integrity: sha512-5U0rVMU5Y2n2+ykNLQqMoqklN9ICBT/KsvC1Gz6vqHbz2AXXGkG+Pm5rMWk/8Vjrr/mY9985Hi8DYzn1F09Nyw==}
+
+  empathic@2.0.1:
+    resolution: {integrity: sha512-YGRs8knHhKHVShLkFET/rWAU8kmHbOV5LwN938RHI0pljAJ1Gf6SzXsSmRaEzcXTtOOmVqJ5+WtQPL5uigY50Q==}
+    engines: {node: '>=14'}
+
   entities@2.2.0:
     resolution: {integrity: sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==}
 
@@ -1550,6 +1500,10 @@ packages:
     resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==}
     engines: {node: '>=0.12'}
 
+  environment@1.1.0:
+    resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==}
+    engines: {node: '>=18'}
+
   es-define-property@1.0.1:
     resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==}
     engines: {node: '>= 0.4'}
@@ -1558,9 +1512,6 @@ packages:
     resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==}
     engines: {node: '>= 0.4'}
 
-  es-module-lexer@1.7.0:
-    resolution: {integrity: sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==}
-
   es-module-lexer@2.3.1:
     resolution: {integrity: sha512-shc1dbU90Yl/xq1QrC7QRtfcwURZuVRfPhZbDoldJ1cn1gzDvBaBWlv0eFolj5+0znnPJz5TXLxsN77X/12KTA==}
 
@@ -1572,11 +1523,6 @@ packages:
     resolution: {integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==}
     engines: {node: '>= 0.4'}
 
-  esbuild@0.27.7:
-    resolution: {integrity: sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==}
-    engines: {node: '>=18'}
-    hasBin: true
-
   escalade@3.2.0:
     resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==}
     engines: {node: '>=6'}
@@ -1646,6 +1592,9 @@ packages:
       picomatch:
         optional: true
 
+  fflate@0.8.3:
+    resolution: {integrity: sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==}
+
   file-type@21.3.4:
     resolution: {integrity: sha512-Ievi/yy8DS3ygGvT47PjSfdFoX+2isQueoYP1cntFW1JLYAuS4GD7NUPGg4zv2iZfV52uDyk5w5Z0TdpRS6Q1g==}
     engines: {node: '>=20'}
@@ -1706,8 +1655,9 @@ packages:
     resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==}
     engines: {node: '>= 0.4'}
 
-  get-tsconfig@4.14.1:
-    resolution: {integrity: sha512-Dz/6HxkrxgNehhxLVeyv8sad9UzF2xBVeaKBQNDfJ5XiSXmp2gTR0eO0RWiT2NCKS5aGP9jjkOMggTN90qU50A==}
+  get-tsconfig@5.0.0-beta.5:
+    resolution: {integrity: sha512-/6gFNr0N04nob252sTQxyFLi3eKFRqIg1I87YcqAMT1i6SQrSF6KujUEQrtrjMV0H/eejTCltLdDSTEMzHbnsQ==}
+    engines: {node: '>=20.20.0'}
 
   glob-parent@5.1.2:
     resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
@@ -1721,6 +1671,10 @@ packages:
     resolution: {integrity: sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==}
     engines: {node: '>=6.0'}
 
+  has-flag@4.0.0:
+    resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
+    engines: {node: '>=8'}
+
   has-symbols@1.1.0:
     resolution: {integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==}
     engines: {node: '>= 0.4'}
@@ -1739,9 +1693,15 @@ packages:
   hast-util-whitespace@3.0.0:
     resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
 
+  highlight.js@10.7.3:
+    resolution: {integrity: sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A==}
+
   hookable@5.5.3:
     resolution: {integrity: sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==}
 
+  hookable@6.1.1:
+    resolution: {integrity: sha512-U9LYDy1CwhMCnprUfeAZWZGByVbhd54hwepegYTK7Pi5NvqEj63ifz5z+xukznehT7i6NIZRu89Ay1AZmRsLEQ==}
+
   html-void-elements@3.0.0:
     resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==}
 
@@ -1766,9 +1726,9 @@ packages:
   import-meta-resolve@4.2.0:
     resolution: {integrity: sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==}
 
-  is-core-module@2.16.2:
-    resolution: {integrity: sha512-evOr8xfXKxE6qSR0hSXL2r3sd7ALj8+7jQEUvPYcm5sgZFdJ+AYzT6yNmJenvIYQBgIGwfwz08sL8zoL7yq2BA==}
-    engines: {node: '>= 0.4'}
+  import-without-cache@0.4.0:
+    resolution: {integrity: sha512-NkJQA7oZ4YHQhd2+H3BoRFKF3d/XNsiKpHZCQEMH9pDX27hQQLsTyOocyRgaIVtf8gHX3Nt3LPkR4e5EdtPAGQ==}
+    engines: {node: ^22.18.0 || >=24.0.0}
 
   is-docker@3.0.0:
     resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==}
@@ -1804,9 +1764,6 @@ packages:
     resolution: {integrity: sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==}
     engines: {node: '>=12'}
 
-  is-module@1.0.0:
-    resolution: {integrity: sha512-51ypPSPCoTEIN9dy5Oy+h4pShgJmPCygKfyRCISBI+JoWT/2oJvK8QPxmwv7b/p239jXrm9M1mlQbyKJ5A152g==}
-
   is-number@7.0.0:
     resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
     engines: {node: '>=0.12.0'}
@@ -1815,9 +1772,6 @@ packages:
     resolution: {integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==}
     engines: {node: '>=12'}
 
-  is-reference@1.2.1:
-    resolution: {integrity: sha512-U82MsXXiFIrjCK4otLT+o2NA2Cd2g5MLoOVXUZjIOhLurrRxpEXzI8O0KZHr3IjLvlAH1kTPYSuqer5T9ZVBKQ==}
-
   is-stream@3.0.0:
     resolution: {integrity: sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==}
     engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
@@ -1841,9 +1795,6 @@ packages:
     resolution: {integrity: sha512-N5A3KTWQpPWT4ExxxPlUx7WmykGXRzhNidWhV41d6Abu9YfI2NyWCJuxdPnslJCPWtbRpSVOWSnSS6GakLM/Rg==}
     engines: {node: '>= 20'}
 
-  js-tokens@4.0.0:
-    resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
-
   js-yaml@3.15.1:
     resolution: {integrity: sha512-S99WuO3HlhO3XN41EtYUNl9zzXjoJx7QvmipxsJVxtCBT0YHEFy+iOJhjSvrmV12nYhWpZaM8lPHkJm0yUMbag==}
     hasBin: true
@@ -1997,6 +1948,17 @@ packages:
     resolution: {integrity: sha512-MqIQVVkz+uGEHi3TsHx/czcxxCbRIL7sv5K5DnYw/tI+apY54IbPefV/cmgxp6LoJSEx/TqcHdLs/298afG5QQ==}
     engines: {node: '>=6'}
 
+  marked-terminal@7.3.0:
+    resolution: {integrity: sha512-t4rBvPsHc57uE/2nJOLmMbZCQ4tgAccAED3ngXQqW6g+TxA488JzJ+FK3lQkzBQOI1mRV/r/Kq+1ZlJ4D0owQw==}
+    engines: {node: '>=16.0.0'}
+    peerDependencies:
+      marked: '>=1 <16'
+
+  marked@9.1.6:
+    resolution: {integrity: sha512-jcByLnIFkd5gSXZmjNvS1TlmRhCXZjIzHYlaGkPlLIekG55JDR2Z4va9tZwCiP+/RDERiNhMOFu01xd6O5ct1Q==}
+    engines: {node: '>= 16'}
+    hasBin: true
+
   math-intrinsics@1.1.0:
     resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
     engines: {node: '>= 0.4'}
@@ -2144,6 +2106,10 @@ packages:
   mj-context-menu@0.6.1:
     resolution: {integrity: sha512-7NO5s6n10TIV96d4g2uDpG7ZDpIhMh0QNfGdJw/W47JswFcosz457wqz/b5sAKvl12sxINGFCn80NZHKwxQEXA==}
 
+  mri@1.2.0:
+    resolution: {integrity: sha512-tzzskb3bG8LvYGFF/mDTpq3jpI6Q9wc3LEmBaghu+DdCssd1FakN7Bc0hVNmEyGq1bq3RgfkCb3cmQLpNPOroA==}
+    engines: {node: '>=4'}
+
   mrmime@2.0.1:
     resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==}
     engines: {node: '>=10'}
@@ -2154,6 +2120,9 @@ packages:
   muggle-string@0.4.1:
     resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==}
 
+  mz@2.7.0:
+    resolution: {integrity: sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==}
+
   nanoid@3.3.18:
     resolution: {integrity: sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==}
     engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
@@ -2164,6 +2133,10 @@ packages:
     engines: {node: ^22 || ^24 || >=26}
     hasBin: true
 
+  node-emoji@2.2.0:
+    resolution: {integrity: sha512-Z3lTE9pLaJF47NyMhd4ww1yFTAP8YhYI8SleJiHzM46Fgpm5cnNzSl9XfzFNqbaz+VlJrIj3fXQ4DeN1Rjm6cw==}
+    engines: {node: '>=18'}
+
   node-fetch@2.7.0:
     resolution: {integrity: sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==}
     engines: {node: 4.x || >=6.0.0}
@@ -2176,6 +2149,10 @@ packages:
   nth-check@2.1.1:
     resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==}
 
+  object-assign@4.1.1:
+    resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==}
+    engines: {node: '>=0.10.0'}
+
   obug@2.1.4:
     resolution: {integrity: sha512-4a+OsYv9UktOJKE+l1A4OufDgdRF9PifWj+tJnHURo/P+WOxpG4GzUFL9qCalmWauao6ogiG+QvnCovwPoyAWA==}
     engines: {node: '>=12.20.0'}
@@ -2217,6 +2194,9 @@ packages:
   parse5-htmlparser2-tree-adapter@6.0.1:
     resolution: {integrity: sha512-qPuWvbLgvDGilKc5BoicRovlT4MtYT6JfJyBOMDsKoiT+GiuP5qyrPCnR9HcPECIJJmZh5jRndyNThnhhb/vlA==}
 
+  parse5@5.1.1:
+    resolution: {integrity: sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug==}
+
   parse5@6.0.1:
     resolution: {integrity: sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==}
 
@@ -2227,9 +2207,6 @@ packages:
     resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
     engines: {node: '>=8'}
 
-  path-parse@1.0.7:
-    resolution: {integrity: sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==}
-
   path-to-regexp@6.3.0:
     resolution: {integrity: sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==}
 
@@ -2298,21 +2275,21 @@ packages:
     resolution: {integrity: sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==}
     engines: {node: '>=10'}
 
+  publint@0.3.24:
+    resolution: {integrity: sha512-9zS56KrKBoqi5Qt8h92uMP8TTM9AYZSgnmCo4u2priMqkOZvQnTsziZ2p5LJ2ywbYkAjoCDp2jda9u4cgFefIw==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   punycode.js@2.3.1:
     resolution: {integrity: sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==}
     engines: {node: '>=6'}
 
-  punycode@2.3.1:
-    resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==}
-    engines: {node: '>=6'}
+  quansync@1.0.0:
+    resolution: {integrity: sha512-5xZacEEufv3HSTPQuchrvV6soaiACMFnq1H8wkVioctoH3TRha9Sz66lOxRwPK/qZj7HPiSveih9yAyh98gvqA==}
 
   queue-microtask@1.2.3:
     resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
 
-  readdirp@5.1.1:
-    resolution: {integrity: sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==}
-    engines: {node: '>= 20.19.0'}
-
   regex-recursion@6.0.2:
     resolution: {integrity: sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==}
 
@@ -2345,11 +2322,6 @@ packages:
   resolve-pkg-maps@1.0.0:
     resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
 
-  resolve@1.22.12:
-    resolution: {integrity: sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==}
-    engines: {node: '>= 0.4'}
-    hasBin: true
-
   restore-cursor@5.1.0:
     resolution: {integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==}
     engines: {node: '>=18'}
@@ -2358,28 +2330,33 @@ packages:
     resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
     engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
 
+  rolldown-plugin-dts@0.27.14:
+    resolution: {integrity: sha512-ZvuDDwoIpRK9RPxDXratCpklFO9QZZWndf/sd0VBFb4LEj0jj07UcHK9OCh7V4XiFz2Z89ziyBC2K6tJiDjrbw==}
+    engines: {node: ^22.18.0 || >=24.11.0}
+    peerDependencies:
+      '@typescript/native-preview': '*'
+      '@volar/typescript': ~2.4.0
+      rolldown: ^1.0.0
+      typescript: ^5.0.0 || ^6.0.0 || ~7.0.0
+      vue-tsc: ~3.2.0 || ~3.3.0
+    peerDependenciesMeta:
+      '@typescript/native-preview':
+        optional: true
+      '@volar/typescript':
+        optional: true
+      typescript:
+        optional: true
+      vue-tsc:
+        optional: true
+
   rolldown@1.2.3:
     resolution: {integrity: sha512-rn9wpmxplLf7NLNyCk9FyWh3FM43DbY8jOzCdEPzH7uflhTftRbCEpqi6Ly2osgoU8OwObtmavMbWLaWy4LX7A==}
     engines: {node: ^20.19.0 || >=22.12.0}
     hasBin: true
 
-  rollup-plugin-dts@6.1.1:
-    resolution: {integrity: sha512-aSHRcJ6KG2IHIioYlvAOcEq6U99sVtqDDKVhnwt70rW6tsz3tv5OSjEiWcgzfsHdLyGXZ/3b/7b/+Za3Y6r1XA==}
-    engines: {node: '>=16'}
-    peerDependencies:
-      rollup: ^3.29.4 || ^4
-      typescript: ^4.5 || ^5.0
-
-  rollup-plugin-esbuild@6.2.1:
-    resolution: {integrity: sha512-jTNOMGoMRhs0JuueJrJqbW8tOwxumaWYq+V5i+PD+8ecSCVkuX27tGW7BXqDgoULQ55rO7IdNxPcnsWtshz3AA==}
-    engines: {node: '>=14.18.0'}
-    peerDependencies:
-      esbuild: '>=0.18.0'
-      rollup: ^1.20.0 || ^2.0.0 || ^3.0.0 || ^4.0.0
-
-  rollup@4.62.4:
-    resolution: {integrity: sha512-RXOqwaPsBGjMNMa4sQjDjHieHEZDFoj/Rdr46l2MU5DfEs16wHJPC2RPTPHWhNl+M3aI472LLqFkFKut4SblOg==}
-    engines: {node: '>=18.0.0', npm: '>=8.0.0'}
+  rolldown@1.2.5:
+    resolution: {integrity: sha512-VD2IE5PUG4Oj8zz2VGykiYd5wbnjdIiSsNQb8Qu5B+noEp+A78mu2iVvpp27g8es14Tk9rofNs5Tku9iQCS4fA==}
+    engines: {node: ^20.19.0 || >=22.12.0}
     hasBin: true
 
   rtlcss@4.3.0:
@@ -2397,6 +2374,10 @@ packages:
   rxjs@7.8.2:
     resolution: {integrity: sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==}
 
+  sade@1.8.1:
+    resolution: {integrity: sha512-xal3CZX1Xlo/k4ApwCFrHVACi9fBqJ7V+mwhBsuf/1IOKbBy098Fex+Wa/5QMubw09pSZ/u8EY8PWgevJsXp1A==}
+    engines: {node: '>=6'}
+
   sax@1.6.1:
     resolution: {integrity: sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==}
     engines: {node: '>=11.0.0'}
@@ -2448,6 +2429,10 @@ packages:
     engines: {node: '>=20.19.5', npm: '>=10.8.2'}
     hasBin: true
 
+  skin-tone@2.0.0:
+    resolution: {integrity: sha512-kUMbT1oBJCpgrnKoSr0o6wPtvRWT9W9UKvGLwfJYO2WuahZRHOpEyL1ckyMGgMWh0UdpmaoFqKKD29WTomNEGA==}
+    engines: {node: '>=8'}
+
   slick@1.12.2:
     resolution: {integrity: sha512-4qdtOGcBjral6YIBCWJ0ljFSKNLz9KkhbWtuGvUyRowl1kxfuE1x/Z/aJcaiilpb3do9bl5K7/1h9XC5wWpY/A==}
 
@@ -2510,9 +2495,13 @@ packages:
     resolution: {integrity: sha512-ki4hZQfh5rX0QDLLkOCj+h+CVNkqmp/CMf8v8kZpkNVK6jGQooMytqzLZYUVYIZcFZ6yDB70EfD8POcFXiF5oA==}
     engines: {node: '>=18'}
 
-  supports-preserve-symlinks-flag@1.0.0:
-    resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
-    engines: {node: '>= 0.4'}
+  supports-color@7.2.0:
+    resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
+    engines: {node: '>=8'}
+
+  supports-hyperlinks@3.2.0:
+    resolution: {integrity: sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig==}
+    engines: {node: '>=14.18'}
 
   tabbable@6.5.0:
     resolution: {integrity: sha512-wieBHXygIm7OyQOu5hQlkk62/WyCFYGlWg7L6/ZCUZwx0o398Zkn4pVmMyfYhfMG8kGrj/Krt8eIk6UKC6VzwA==}
@@ -2525,6 +2514,13 @@ packages:
     resolution: {integrity: sha512-d79HhZya5Djd7am0q+W4RTsSU+D/aJzM+4Y4AGJGuGlgM2L6sx5ZvOYTmZjqPhrDrV6xJTtRSm1JCLj6V6LHLQ==}
     engines: {node: '>=14.16'}
 
+  thenify-all@1.6.0:
+    resolution: {integrity: sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==}
+    engines: {node: '>=0.8'}
+
+  thenify@3.3.1:
+    resolution: {integrity: sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==}
+
   tinybench@2.9.0:
     resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}
 
@@ -2558,6 +2554,10 @@ packages:
   tr46@0.0.3:
     resolution: {integrity: sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==}
 
+  tree-kill@1.2.2:
+    resolution: {integrity: sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==}
+    hasBin: true
+
   trim-lines@3.0.1:
     resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}
 
@@ -2568,6 +2568,40 @@ packages:
     resolution: {integrity: sha512-bwwr76BThfiVwAFZqks5cJ+VoKNM3/2Yg1ZwJslkdmAUQ6S0UNoCoGYFDxdw+u1skfexggdmD2p35kW5Td4Cug==}
     engines: {node: '>=6'}
 
+  tsdown@0.22.14:
+    resolution: {integrity: sha512-ule7Y+fsAN2iZbLDoo7C4KYljFJNJJ+fLshyn+9gozeTspVersWHxwdGB+Dm2hzA38s6muFnUTl0jK3vJm9ifQ==}
+    engines: {node: ^22.18.0 || >=24.11.0}
+    hasBin: true
+    peerDependencies:
+      '@arethetypeswrong/core': ^0.18.1
+      '@tsdown/css': 0.22.14
+      '@tsdown/exe': 0.22.14
+      '@vitejs/devtools': '*'
+      publint: ^0.3.8
+      tsx: '*'
+      typescript: ^5.0.0 || ^6.0.0 || ^7.0.0
+      unplugin-unused: ^0.5.0
+      unrun: '*'
+    peerDependenciesMeta:
+      '@arethetypeswrong/core':
+        optional: true
+      '@tsdown/css':
+        optional: true
+      '@tsdown/exe':
+        optional: true
+      '@vitejs/devtools':
+        optional: true
+      publint:
+        optional: true
+      tsx:
+        optional: true
+      typescript:
+        optional: true
+      unplugin-unused:
+        optional: true
+      unrun:
+        optional: true
+
   tslib@2.8.1:
     resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
 
@@ -2579,8 +2613,13 @@ packages:
     resolution: {integrity: sha512-RAH822pAdBgcNMAfWnCBU3CFZcfZ/i1eZjwFU/dsLKumyuuP3niueg2UAukXYF0E2AAoc82ZSSf9J0WQBinzHA==}
     engines: {node: '>=12.20'}
 
-  typescript@5.9.3:
-    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+  typescript@5.6.1-rc:
+    resolution: {integrity: sha512-E3b2+1zEFu84jB0YQi9BORDjz9+jGbwwy1Zi3G0LUNw7a7cePUrHMRNy8aPh53nXpkFGVHSxIZo5vKTfYaFiBQ==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  typescript@6.0.3:
+    resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==}
     engines: {node: '>=14.17'}
     hasBin: true
 
@@ -2594,12 +2633,19 @@ packages:
   ultramatter@0.0.4:
     resolution: {integrity: sha512-1f/hO3mR+/Hgue4eInOF/Qm/wzDqwhYha4DxM0hre9YIUyso3fE2XtrAU6B4njLqTC8CM49EZaYgsVSa+dXHGw==}
 
+  unconfig-core@7.5.0:
+    resolution: {integrity: sha512-Su3FauozOGP44ZmKdHy2oE6LPjk51M/TRRjHv2HNCWiDvfvCoxC2lno6jevMA91MYAdCdwP05QnWdWpSbncX/w==}
+
   undici-types@7.18.2:
     resolution: {integrity: sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==}
 
   undici-types@8.3.0:
     resolution: {integrity: sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ==}
 
+  unicode-emoji-modifier-base@1.0.0:
+    resolution: {integrity: sha512-yLSH4py7oFH3oG/9K+XWrz1pSi3dfUrWEnInbxMfArOfc1+33BlGPQtLsOYwvdMy11AwUBetYuaRxSPqgkq+8g==}
+    engines: {node: '>=4'}
+
   unified@11.0.5:
     resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
 
@@ -2625,10 +2671,6 @@ packages:
   unist-util-visit@5.1.0:
     resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==}
 
-  unplugin-utils@0.2.5:
-    resolution: {integrity: sha512-gwXJnPRewT4rT7sBi/IvxKTjsms7jX7QIDLOClApuZwR49SXbrB1z2NLUZ+vDHyqCj/n58OzRRqaW+B8OZi8vg==}
-    engines: {node: '>=18.12.0'}
-
   util-deprecate@1.0.2:
     resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
 
@@ -2636,6 +2678,14 @@ packages:
     resolution: {integrity: sha512-jOWVmzVceKlVVdwjNSenT4PbGghU0SBIizAev8ofZVgivk/TVHXSbNL8LP6M3spZvkR9/QolkyJavGSX5Cs0UA==}
     engines: {node: '>=10'}
 
+  validate-npm-package-name@5.0.1:
+    resolution: {integrity: sha512-OljLrQ9SQdOUqTaQxqL5dEfZWrXExyyWsozYlAWFawPVNuD83igl7uJD2RTkNMbniIYgt8l81eCJGIdQF7avLQ==}
+    engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+  verkit@0.3.2:
+    resolution: {integrity: sha512-zj/ob3UsvJGN0whEAKFp53REA5X66hvffVqoCtVQAakJKnKlH+/PcOfMoFwIG/o4rElqLv/ycAFlx8ZlXUorCg==}
+    engines: {node: '>=18.12.0'}
+
   vfile-message@4.0.3:
     resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
 
@@ -2649,7 +2699,7 @@ packages:
     peerDependencies:
       '@types/node': ^20.19.0 || >=22.12.0
       '@vitejs/devtools': ^0.4.0
-      esbuild: ^0.27.0 || ^0.28.0
+      esbuild: '*'
       jiti: '>=1.21.0'
       less: ^4.0.0
       sass: ^1.70.0
@@ -2741,8 +2791,28 @@ packages:
   vscode-uri@3.1.0:
     resolution: {integrity: sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==}
 
-  vue-tsc@3.3.9:
-    resolution: {integrity: sha512-TS3Y1ux/IRoE8OCP2PpACAeOseuIs0UvWrcr7u+w3PmfY+SlCfEf8zjrBgnQksHUgLpthi5vHlffcQTQTdPBZA==}
+  vue-sfc-transformer@0.2.5:
+    resolution: {integrity: sha512-e+yWjXmWH/088bFrgpvVZ4x/4TkgRKM3L9yreSVlzphEy03auX7zgycyHFLEyCizMDmUh+Q2aXYRb3tjETtCyQ==}
+    engines: {node: '>=18.0.0'}
+    peerDependencies:
+      '@volar/typescript': ^2.4.0
+      '@vue/compiler-core': ^3.5.13
+      '@vue/language-core': ^3.0.0
+      rolldown: '>=1.0.0-beta.0'
+      typescript: '>=5.0.0'
+      vue: ^3.5.13
+    peerDependenciesMeta:
+      '@volar/typescript':
+        optional: true
+      '@vue/language-core':
+        optional: true
+      rolldown:
+        optional: true
+      typescript:
+        optional: true
+
+  vue-tsc@3.3.11:
+    resolution: {integrity: sha512-gOb0B9rtU2+f1dszwPqSH5kAieIF9ReeLhD3kSRNHv5WZZUQz/JdVXW0RTdqhNTMlQkqKzrTTviqKr/4FYZraQ==}
     hasBin: true
     peerDependencies:
       typescript: '>=5.0.0'
@@ -2804,10 +2874,18 @@ packages:
     engines: {node: '>= 14.6'}
     hasBin: true
 
+  yargs-parser@20.2.9:
+    resolution: {integrity: sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==}
+    engines: {node: '>=10'}
+
   yargs-parser@21.1.1:
     resolution: {integrity: sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==}
     engines: {node: '>=12'}
 
+  yargs@16.2.2:
+    resolution: {integrity: sha512-Nt9ZJjXTv5R8MHbqby/wXQ6Gi0Bb3TcYZkR1bzuL4yB2OxWPkXknz513gEF0GoA6tn00UpbPvERW8rzCuWCA6w==}
+    engines: {node: '>=10'}
+
   yargs@17.7.3:
     resolution: {integrity: sha512-GZtjxm/J/4TSxuL3FNYjCmLktBTnIw/rVmKSIyKeYAZpmJB2ig9VauCC5xsa82GNKVKDAqpOn3KVzNt0zmrU0g==}
     engines: {node: '>=12'}
@@ -2816,6 +2894,15 @@ packages:
     resolution: {integrity: sha512-xYqdZFUK/VYazNl/oCDYN+3WloWQwMfZxBoiNt6qNyk+xfOdi598muWE42rNZFp1kNOiqW936q5RhUdnpqElSg==}
     engines: {node: '>=18'}
 
+  yuku-ast@0.8.7:
+    resolution: {integrity: sha512-h6+4bDfyootiMB9vckk5uKo5r5j0GHrkr17FQTDNfEsFT3DWlN9uu1HJwQwc64pgmLCI945fWM3lbTIqxjT3GQ==}
+
+  yuku-codegen@0.8.7:
+    resolution: {integrity: sha512-adwDZSh8oVDzhE6Du9PwVWxcOxeV0e2EVhUuMKWfhSY4wkrDq9eqixlxFF3l/XGUV1E7UFzhpz9393MUumkyNw==}
+
+  yuku-parser@0.8.7:
+    resolution: {integrity: sha512-vRD9nwt4L3aYpxNqeSC4WqLv58xrXef0Ong1Mc45CTXTIpvLafx7JO05sczmQZwdLEZvywrLOGdNC5+Rp5N1BQ==}
+
   zod@3.25.76:
     resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
 
@@ -2829,17 +2916,33 @@ snapshots:
       js-yaml: 4.3.1
       section-matter: 1.0.0
 
+  '@andrewbranch/untar.js@1.0.4': {}
+
   '@antfu/install-pkg@1.1.0':
     dependencies:
       package-manager-detector: 1.8.0
       tinyexec: 1.3.0
 
-  '@babel/code-frame@7.29.7':
+  '@arethetypeswrong/cli@0.18.5':
     dependencies:
-      '@babel/helper-validator-identifier': 7.29.7
-      js-tokens: 4.0.0
-      picocolors: 1.1.1
-    optional: true
+      '@arethetypeswrong/core': 0.18.5
+      chalk: 4.1.2
+      cli-table3: 0.6.5
+      commander: 10.0.1
+      marked: 9.1.6
+      marked-terminal: 7.3.0(marked@9.1.6)
+      semver: 7.8.5
+
+  '@arethetypeswrong/core@0.18.5':
+    dependencies:
+      '@andrewbranch/untar.js': 1.0.4
+      '@loaderkit/resolve': 1.0.6
+      cjs-module-lexer: 1.4.3
+      fflate: 0.8.3
+      lru-cache: 11.5.2
+      semver: 7.8.5
+      typescript: 5.6.1-rc
+      validate-npm-package-name: 5.0.1
 
   '@babel/helper-string-parser@7.29.7': {}
 
@@ -2856,6 +2959,8 @@ snapshots:
 
   '@borewit/text-codec@0.2.2': {}
 
+  '@braidai/lang@1.1.2': {}
+
   '@clack/core@0.3.5':
     dependencies:
       picocolors: 1.1.1
@@ -2873,6 +2978,9 @@ snapshots:
       fast-wrap-ansi: 0.2.2
       sisteransi: 1.0.5
 
+  '@colors/colors@1.5.0':
+    optional: true
+
   '@conventional-changelog/git-client@3.1.1(conventional-commits-filter@6.0.1)(conventional-commits-parser@7.1.2)':
     dependencies:
       '@simple-libs/child-process-utils': 2.0.0
@@ -2890,84 +2998,6 @@ snapshots:
 
   '@docsearch/sidepanel-js@4.7.0': {}
 
-  '@esbuild/aix-ppc64@0.27.7':
-    optional: true
-
-  '@esbuild/android-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/android-arm@0.27.7':
-    optional: true
-
-  '@esbuild/android-x64@0.27.7':
-    optional: true
-
-  '@esbuild/darwin-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/darwin-x64@0.27.7':
-    optional: true
-
-  '@esbuild/freebsd-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/freebsd-x64@0.27.7':
-    optional: true
-
-  '@esbuild/linux-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/linux-arm@0.27.7':
-    optional: true
-
-  '@esbuild/linux-ia32@0.27.7':
-    optional: true
-
-  '@esbuild/linux-loong64@0.27.7':
-    optional: true
-
-  '@esbuild/linux-mips64el@0.27.7':
-    optional: true
-
-  '@esbuild/linux-ppc64@0.27.7':
-    optional: true
-
-  '@esbuild/linux-riscv64@0.27.7':
-    optional: true
-
-  '@esbuild/linux-s390x@0.27.7':
-    optional: true
-
-  '@esbuild/linux-x64@0.27.7':
-    optional: true
-
-  '@esbuild/netbsd-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/netbsd-x64@0.27.7':
-    optional: true
-
-  '@esbuild/openbsd-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/openbsd-x64@0.27.7':
-    optional: true
-
-  '@esbuild/openharmony-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/sunos-x64@0.27.7':
-    optional: true
-
-  '@esbuild/win32-arm64@0.27.7':
-    optional: true
-
-  '@esbuild/win32-ia32@0.27.7':
-    optional: true
-
-  '@esbuild/win32-x64@0.27.7':
-    optional: true
-
   '@hapi/address@5.1.1':
     dependencies:
       '@hapi/hoek': 11.0.7
@@ -3006,15 +3036,19 @@ snapshots:
 
   '@jridgewell/sourcemap-codec@1.5.5': {}
 
-  '@kwsites/file-exists@1.1.1':
+  '@kwsites/file-exists@1.1.1(supports-color@7.2.0)':
     dependencies:
-      debug: 4.4.3
+      debug: 4.4.3(supports-color@7.2.0)
     transitivePeerDependencies:
       - supports-color
 
   '@kwsites/promise-deferred@1.1.1': {}
 
-  '@lunariajs/core@0.1.1':
+  '@loaderkit/resolve@1.0.6':
+    dependencies:
+      '@braidai/lang': 1.1.2
+
+  '@lunariajs/core@0.1.1(supports-color@7.2.0)':
     dependencies:
       '@clack/core': 0.3.5
       fast-glob: 3.3.3
@@ -3023,7 +3057,7 @@ snapshots:
       micromatch: 4.0.8
       path-to-regexp: 6.3.0
       picocolors: 1.1.1
-      simple-git: 3.36.0
+      simple-git: 3.36.0(supports-color@7.2.0)
       ultramatter: 0.0.4
       zod: 3.25.76
     transitivePeerDependencies:
@@ -3117,193 +3151,123 @@ snapshots:
     optionalDependencies:
       markdown-it: 14.3.0
 
-  '@napi-rs/lzma-linux-x64-gnu@1.5.1':
-    optional: true
-
   '@nodelib/fs.scandir@2.1.5':
     dependencies:
       '@nodelib/fs.stat': 2.0.5
       run-parallel: 1.2.0
 
-  '@nodelib/fs.stat@2.0.5': {}
-
-  '@nodelib/fs.walk@1.2.8':
-    dependencies:
-      '@nodelib/fs.scandir': 2.1.5
-      fastq: 1.20.1
-
-  '@oxc-project/types@0.143.0': {}
-
-  '@polka/compression@1.0.0-next.28': {}
-
-  '@polka/url@1.0.0-next.29': {}
-
-  '@rolldown/binding-android-arm64@1.2.3':
-    optional: true
-
-  '@rolldown/binding-darwin-arm64@1.2.3':
-    optional: true
-
-  '@rolldown/binding-darwin-x64@1.2.3':
-    optional: true
-
-  '@rolldown/binding-freebsd-x64@1.2.3':
-    optional: true
-
-  '@rolldown/binding-linux-arm-gnueabihf@1.2.3':
-    optional: true
-
-  '@rolldown/binding-linux-arm64-gnu@1.2.3':
-    optional: true
-
-  '@rolldown/binding-linux-arm64-musl@1.2.3':
-    optional: true
-
-  '@rolldown/binding-linux-ppc64-gnu@1.2.3':
-    optional: true
-
-  '@rolldown/binding-linux-s390x-gnu@1.2.3':
-    optional: true
-
-  '@rolldown/binding-linux-x64-gnu@1.2.3':
-    optional: true
-
-  '@rolldown/binding-linux-x64-musl@1.2.3':
-    optional: true
+  '@nodelib/fs.stat@2.0.5': {}
 
-  '@rolldown/binding-openharmony-arm64@1.2.3':
-    optional: true
+  '@nodelib/fs.walk@1.2.8':
+    dependencies:
+      '@nodelib/fs.scandir': 2.1.5
+      fastq: 1.20.1
 
-  '@rolldown/binding-win32-arm64-msvc@1.2.3':
-    optional: true
+  '@oxc-project/types@0.143.0': {}
 
-  '@rolldown/binding-win32-x64-msvc@1.2.3':
-    optional: true
+  '@oxc-project/types@0.146.0': {}
 
-  '@rolldown/pluginutils@1.0.1': {}
+  '@polka/compression@1.0.0-next.28': {}
 
-  '@rollup/plugin-alias@6.0.0(rollup@4.62.4)':
-    optionalDependencies:
-      rollup: 4.62.4
+  '@polka/url@1.0.0-next.29': {}
 
-  '@rollup/plugin-commonjs@29.0.3(rollup@4.62.4)':
+  '@publint/pack@0.1.7':
     dependencies:
-      '@rollup/pluginutils': 5.4.0(rollup@4.62.4)
-      commondir: 1.0.1
-      estree-walker: 2.0.2
-      fdir: 6.5.0(picomatch@4.0.5)
-      is-reference: 1.2.1
-      magic-string: 0.30.21
-      picomatch: 4.0.5
-    optionalDependencies:
-      rollup: 4.62.4
+      tinyexec: 1.3.0
 
-  '@rollup/plugin-json@6.1.0(rollup@4.62.4)':
+  '@quansync/fs@1.0.0':
     dependencies:
-      '@rollup/pluginutils': 5.4.0(rollup@4.62.4)
-    optionalDependencies:
-      rollup: 4.62.4
+      quansync: 1.0.0
 
-  '@rollup/plugin-node-resolve@16.0.3(rollup@4.62.4)':
-    dependencies:
-      '@rollup/pluginutils': 5.4.0(rollup@4.62.4)
-      '@types/resolve': 1.20.2
-      deepmerge: 4.3.1
-      is-module: 1.0.0
-      resolve: 1.22.12
-    optionalDependencies:
-      rollup: 4.62.4
+  '@rolldown/binding-android-arm-eabi@1.2.5':
+    optional: true
 
-  '@rollup/plugin-replace@6.0.3(rollup@4.62.4)':
-    dependencies:
-      '@rollup/pluginutils': 5.4.0(rollup@4.62.4)
-      magic-string: 0.30.21
-    optionalDependencies:
-      rollup: 4.62.4
+  '@rolldown/binding-android-arm64@1.2.3':
+    optional: true
 
-  '@rollup/pluginutils@5.4.0(rollup@4.62.4)':
-    dependencies:
-      '@types/estree': 1.0.9
-      estree-walker: 2.0.2
-      picomatch: 4.0.5
-    optionalDependencies:
-      rollup: 4.62.4
+  '@rolldown/binding-android-arm64@1.2.5':
+    optional: true
+
+  '@rolldown/binding-darwin-arm64@1.2.3':
+    optional: true
 
-  '@rollup/rollup-android-arm-eabi@4.62.4':
+  '@rolldown/binding-darwin-arm64@1.2.5':
     optional: true
 
-  '@rollup/rollup-android-arm64@4.62.4':
+  '@rolldown/binding-darwin-x64@1.2.3':
     optional: true
 
-  '@rollup/rollup-darwin-arm64@4.62.4':
+  '@rolldown/binding-darwin-x64@1.2.5':
     optional: true
 
-  '@rollup/rollup-darwin-x64@4.62.4':
+  '@rolldown/binding-freebsd-x64@1.2.3':
     optional: true
 
-  '@rollup/rollup-freebsd-arm64@4.62.4':
+  '@rolldown/binding-freebsd-x64@1.2.5':
     optional: true
 
-  '@rollup/rollup-freebsd-x64@4.62.4':
+  '@rolldown/binding-linux-arm-gnueabihf@1.2.3':
     optional: true
 
-  '@rollup/rollup-linux-arm-gnueabihf@4.62.4':
+  '@rolldown/binding-linux-arm-gnueabihf@1.2.5':
     optional: true
 
-  '@rollup/rollup-linux-arm-musleabihf@4.62.4':
+  '@rolldown/binding-linux-arm64-gnu@1.2.3':
     optional: true
 
-  '@rollup/rollup-linux-arm64-gnu@4.62.4':
+  '@rolldown/binding-linux-arm64-gnu@1.2.5':
     optional: true
 
-  '@rollup/rollup-linux-arm64-musl@4.62.4':
+  '@rolldown/binding-linux-arm64-musl@1.2.3':
     optional: true
 
-  '@rollup/rollup-linux-loong64-gnu@4.62.4':
+  '@rolldown/binding-linux-arm64-musl@1.2.5':
     optional: true
 
-  '@rollup/rollup-linux-loong64-musl@4.62.4':
+  '@rolldown/binding-linux-ppc64-gnu@1.2.3':
     optional: true
 
-  '@rollup/rollup-linux-ppc64-gnu@4.62.4':
+  '@rolldown/binding-linux-ppc64-gnu@1.2.5':
     optional: true
 
-  '@rollup/rollup-linux-ppc64-musl@4.62.4':
+  '@rolldown/binding-linux-s390x-gnu@1.2.3':
     optional: true
 
-  '@rollup/rollup-linux-riscv64-gnu@4.62.4':
+  '@rolldown/binding-linux-s390x-gnu@1.2.5':
     optional: true
 
-  '@rollup/rollup-linux-riscv64-musl@4.62.4':
+  '@rolldown/binding-linux-x64-gnu@1.2.3':
     optional: true
 
-  '@rollup/rollup-linux-s390x-gnu@4.62.4':
+  '@rolldown/binding-linux-x64-gnu@1.2.5':
     optional: true
 
-  '@rollup/rollup-linux-x64-gnu@4.62.4':
+  '@rolldown/binding-linux-x64-musl@1.2.3':
     optional: true
 
-  '@rollup/rollup-linux-x64-musl@4.62.4':
+  '@rolldown/binding-linux-x64-musl@1.2.5':
     optional: true
 
-  '@rollup/rollup-openbsd-x64@4.62.4':
+  '@rolldown/binding-openharmony-arm64@1.2.3':
     optional: true
 
-  '@rollup/rollup-openharmony-arm64@4.62.4':
+  '@rolldown/binding-openharmony-arm64@1.2.5':
     optional: true
 
-  '@rollup/rollup-win32-arm64-msvc@4.62.4':
+  '@rolldown/binding-win32-arm64-msvc@1.2.3':
     optional: true
 
-  '@rollup/rollup-win32-ia32-msvc@4.62.4':
+  '@rolldown/binding-win32-arm64-msvc@1.2.5':
     optional: true
 
-  '@rollup/rollup-win32-x64-gnu@4.62.4':
+  '@rolldown/binding-win32-x64-msvc@1.2.3':
     optional: true
 
-  '@rollup/rollup-win32-x64-msvc@4.62.4':
+  '@rolldown/binding-win32-x64-msvc@1.2.5':
     optional: true
 
+  '@rolldown/pluginutils@1.0.1': {}
+
   '@shikijs/core@4.4.3':
     dependencies:
       '@shikijs/primitive': 4.4.3
@@ -3368,11 +3332,13 @@ snapshots:
 
   '@simple-libs/stream-utils@2.0.0': {}
 
+  '@sindresorhus/is@4.6.0': {}
+
   '@standard-schema/spec@1.1.0': {}
 
-  '@tokenizer/inflate@0.4.1':
+  '@tokenizer/inflate@0.4.1(supports-color@7.2.0)':
     dependencies:
-      debug: 4.4.3
+      debug: 4.4.3(supports-color@7.2.0)
       token-types: 6.1.2
     transitivePeerDependencies:
       - supports-color
@@ -3439,8 +3405,6 @@ snapshots:
 
   '@types/picomatch@4.0.3': {}
 
-  '@types/resolve@1.20.2': {}
-
   '@types/sax@1.2.7':
     dependencies:
       '@types/node': 26.2.0
@@ -3453,11 +3417,11 @@ snapshots:
 
   '@ungap/structured-clone@1.3.3': {}
 
-  '@vitejs/plugin-vue@6.0.8(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0))(vue@3.5.41(typescript@5.9.3))':
+  '@vitejs/plugin-vue@6.0.8(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0))(vue@3.5.41(typescript@6.0.3))':
     dependencies:
       '@rolldown/pluginutils': 1.0.1
-      vite: 8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0)
-      vue: 3.5.41(typescript@5.9.3)
+      vite: 8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0)
+      vue: 3.5.41(typescript@6.0.3)
 
   '@vitest/expect@4.1.10':
     dependencies:
@@ -3468,13 +3432,13 @@ snapshots:
       chai: 6.2.2
       tinyrainbow: 3.1.1
 
-  '@vitest/mocker@4.1.10(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0))':
+  '@vitest/mocker@4.1.10(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0))':
     dependencies:
       '@vitest/spy': 4.1.10
       estree-walker: 3.0.3
       magic-string: 0.30.21
     optionalDependencies:
-      vite: 8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0)
+      vite: 8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0)
 
   '@vitest/pretty-format@4.1.10':
     dependencies:
@@ -3506,13 +3470,13 @@ snapshots:
 
   '@volar/source-map@2.4.28': {}
 
-  '@volar/typescript@2.4.28(typescript@5.9.3)':
+  '@volar/typescript@2.4.28(typescript@6.0.3)':
     dependencies:
       '@volar/language-core': 2.4.28
       path-browserify: 1.0.1
       vscode-uri: 3.1.0
     optionalDependencies:
-      typescript: 5.9.3
+      typescript: 6.0.3
 
   '@vue/compiler-core@3.5.41':
     dependencies:
@@ -3557,7 +3521,7 @@ snapshots:
 
   '@vue/devtools-shared@8.2.1': {}
 
-  '@vue/language-core@3.3.9':
+  '@vue/language-core@3.3.11':
     dependencies:
       '@volar/language-core': 2.4.28
       '@vue/compiler-dom': 3.5.41
@@ -3591,33 +3555,107 @@ snapshots:
 
   '@vue/shared@3.5.41': {}
 
-  '@vueuse/core@14.4.0(vue@3.5.41(typescript@5.9.3))':
+  '@vueuse/core@14.4.0(vue@3.5.41(typescript@6.0.3))':
     dependencies:
       '@types/web-bluetooth': 0.0.21
       '@vueuse/metadata': 14.4.0
-      '@vueuse/shared': 14.4.0(vue@3.5.41(typescript@5.9.3))
-      vue: 3.5.41(typescript@5.9.3)
+      '@vueuse/shared': 14.4.0(vue@3.5.41(typescript@6.0.3))
+      vue: 3.5.41(typescript@6.0.3)
 
-  '@vueuse/integrations@14.4.0(axios@1.19.0(debug@4.4.3))(focus-trap@8.2.2)(vue@3.5.41(typescript@5.9.3))':
+  '@vueuse/integrations@14.4.0(axios@1.19.0(debug@4.4.3(supports-color@7.2.0))(supports-color@7.2.0))(focus-trap@8.2.2)(vue@3.5.41(typescript@6.0.3))':
     dependencies:
-      '@vueuse/core': 14.4.0(vue@3.5.41(typescript@5.9.3))
-      '@vueuse/shared': 14.4.0(vue@3.5.41(typescript@5.9.3))
-      vue: 3.5.41(typescript@5.9.3)
+      '@vueuse/core': 14.4.0(vue@3.5.41(typescript@6.0.3))
+      '@vueuse/shared': 14.4.0(vue@3.5.41(typescript@6.0.3))
+      vue: 3.5.41(typescript@6.0.3)
     optionalDependencies:
-      axios: 1.19.0(debug@4.4.3)
+      axios: 1.19.0(debug@4.4.3(supports-color@7.2.0))(supports-color@7.2.0)
       focus-trap: 8.2.2
 
   '@vueuse/metadata@14.4.0': {}
 
-  '@vueuse/shared@14.4.0(vue@3.5.41(typescript@5.9.3))':
+  '@vueuse/shared@14.4.0(vue@3.5.41(typescript@6.0.3))':
     dependencies:
-      vue: 3.5.41(typescript@5.9.3)
+      vue: 3.5.41(typescript@6.0.3)
 
   '@xmldom/xmldom@0.9.10': {}
 
-  agent-base@6.0.2:
+  '@yuku-codegen/binding-android-arm64@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-darwin-arm64@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-darwin-x64@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-freebsd-x64@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm-gnu@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm-musl@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm64-gnu@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm64-musl@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-linux-x64-gnu@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-linux-x64-musl@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-win32-arm64@0.8.7':
+    optional: true
+
+  '@yuku-codegen/binding-win32-x64@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-android-arm64@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-darwin-arm64@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-darwin-x64@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-freebsd-x64@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm-gnu@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm-musl@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm64-gnu@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm64-musl@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-linux-x64-gnu@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-linux-x64-musl@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-win32-arm64@0.8.7':
+    optional: true
+
+  '@yuku-parser/binding-win32-x64@0.8.7':
+    optional: true
+
+  '@yuku-toolchain/types@0.8.7': {}
+
+  agent-base@6.0.2(supports-color@7.2.0):
     dependencies:
-      debug: 4.4.3
+      debug: 4.4.3(supports-color@7.2.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -3625,6 +3663,10 @@ snapshots:
 
   ansi-colors@4.1.3: {}
 
+  ansi-escapes@7.3.0:
+    dependencies:
+      environment: 1.1.0
+
   ansi-regex@5.0.1: {}
 
   ansi-regex@6.2.2: {}
@@ -3633,6 +3675,10 @@ snapshots:
     dependencies:
       color-convert: 2.0.1
 
+  ansis@4.3.1: {}
+
+  any-promise@1.3.0: {}
+
   arg@5.0.2: {}
 
   argparse@1.0.10:
@@ -3647,11 +3693,11 @@ snapshots:
 
   asynckit@0.4.0: {}
 
-  axios@1.19.0(debug@4.4.3):
+  axios@1.19.0(debug@4.4.3(supports-color@7.2.0))(supports-color@7.2.0):
     dependencies:
-      follow-redirects: 1.16.0(debug@4.4.3)
+      follow-redirects: 1.16.0(debug@4.4.3(supports-color@7.2.0))
       form-data: 4.0.6
-      https-proxy-agent: 5.0.1
+      https-proxy-agent: 5.0.1(supports-color@7.2.0)
       proxy-from-env: 2.1.0
     transitivePeerDependencies:
       - debug
@@ -3677,6 +3723,8 @@ snapshots:
     dependencies:
       run-applescript: 7.1.0
 
+  cac@7.0.0: {}
+
   call-bind-apply-helpers@1.0.2:
     dependencies:
       es-errors: 1.3.0
@@ -3686,8 +3734,15 @@ snapshots:
 
   chai@6.2.2: {}
 
+  chalk@4.1.2:
+    dependencies:
+      ansi-styles: 4.3.0
+      supports-color: 7.2.0
+
   chalk@5.6.2: {}
 
+  char-regex@1.0.2: {}
+
   character-entities-html4@2.1.0: {}
 
   character-entities-legacy@3.0.0: {}
@@ -3712,16 +3767,35 @@ snapshots:
       parse5-htmlparser2-tree-adapter: 6.0.1
       tslib: 2.8.1
 
-  chokidar@5.0.0:
-    dependencies:
-      readdirp: 5.1.1
+  cjs-module-lexer@1.4.3: {}
 
   cli-cursor@5.0.0:
     dependencies:
       restore-cursor: 5.1.0
 
+  cli-highlight@2.1.11:
+    dependencies:
+      chalk: 4.1.2
+      highlight.js: 10.7.3
+      mz: 2.7.0
+      parse5: 5.1.1
+      parse5-htmlparser2-tree-adapter: 6.0.1
+      yargs: 16.2.2
+
   cli-spinners@3.4.0: {}
 
+  cli-table3@0.6.5:
+    dependencies:
+      string-width: 4.2.3
+    optionalDependencies:
+      '@colors/colors': 1.5.0
+
+  cliui@7.0.4:
+    dependencies:
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+      wrap-ansi: 7.0.0
+
   cliui@8.0.1:
     dependencies:
       string-width: 4.2.3
@@ -3740,12 +3814,12 @@ snapshots:
 
   comma-separated-tokens@2.0.3: {}
 
+  commander@10.0.1: {}
+
   commander@13.1.0: {}
 
   commander@6.2.1: {}
 
-  commondir@1.0.1: {}
-
   conventional-changelog-angular@9.2.1:
     dependencies:
       '@conventional-changelog/template': 1.2.1
@@ -3806,16 +3880,16 @@ snapshots:
 
   csstype@3.2.3: {}
 
-  debug@4.4.3:
+  debug@4.4.3(supports-color@7.2.0):
     dependencies:
       ms: 2.1.3
+    optionalDependencies:
+      supports-color: 7.2.0
 
   decode-named-character-reference@1.3.0:
     dependencies:
       character-entities: 2.0.2
 
-  deepmerge@4.3.1: {}
-
   default-browser-id@5.0.1: {}
 
   default-browser@5.5.0:
@@ -3825,6 +3899,8 @@ snapshots:
 
   define-lazy-prop@3.0.0: {}
 
+  defu@6.1.7: {}
+
   delayed-stream@1.0.0: {}
 
   dequal@2.0.3: {}
@@ -3857,6 +3933,8 @@ snapshots:
       domelementtype: 2.3.0
       domhandler: 4.3.1
 
+  dts-resolver@3.0.0: {}
+
   dunder-proto@1.0.1:
     dependencies:
       call-bind-apply-helpers: 1.0.2
@@ -3865,18 +3943,22 @@ snapshots:
 
   emoji-regex@8.0.0: {}
 
+  emojilib@2.4.0: {}
+
+  empathic@2.0.1: {}
+
   entities@2.2.0: {}
 
   entities@4.5.0: {}
 
   entities@7.0.1: {}
 
+  environment@1.1.0: {}
+
   es-define-property@1.0.1: {}
 
   es-errors@1.3.0: {}
 
-  es-module-lexer@1.7.0: {}
-
   es-module-lexer@2.3.1: {}
 
   es-object-atoms@1.1.2:
@@ -3890,35 +3972,6 @@ snapshots:
       has-tostringtag: 1.0.2
       hasown: 2.0.4
 
-  esbuild@0.27.7:
-    optionalDependencies:
-      '@esbuild/aix-ppc64': 0.27.7
-      '@esbuild/android-arm': 0.27.7
-      '@esbuild/android-arm64': 0.27.7
-      '@esbuild/android-x64': 0.27.7
-      '@esbuild/darwin-arm64': 0.27.7
-      '@esbuild/darwin-x64': 0.27.7
-      '@esbuild/freebsd-arm64': 0.27.7
-      '@esbuild/freebsd-x64': 0.27.7
-      '@esbuild/linux-arm': 0.27.7
-      '@esbuild/linux-arm64': 0.27.7
-      '@esbuild/linux-ia32': 0.27.7
-      '@esbuild/linux-loong64': 0.27.7
-      '@esbuild/linux-mips64el': 0.27.7
-      '@esbuild/linux-ppc64': 0.27.7
-      '@esbuild/linux-riscv64': 0.27.7
-      '@esbuild/linux-s390x': 0.27.7
-      '@esbuild/linux-x64': 0.27.7
-      '@esbuild/netbsd-arm64': 0.27.7
-      '@esbuild/netbsd-x64': 0.27.7
-      '@esbuild/openbsd-arm64': 0.27.7
-      '@esbuild/openbsd-x64': 0.27.7
-      '@esbuild/openharmony-arm64': 0.27.7
-      '@esbuild/sunos-x64': 0.27.7
-      '@esbuild/win32-arm64': 0.27.7
-      '@esbuild/win32-ia32': 0.27.7
-      '@esbuild/win32-x64': 0.27.7
-
   escalade@3.2.0: {}
 
   escape-goat@3.0.0: {}
@@ -3977,9 +4030,11 @@ snapshots:
     optionalDependencies:
       picomatch: 4.0.5
 
-  file-type@21.3.4:
+  fflate@0.8.3: {}
+
+  file-type@21.3.4(supports-color@7.2.0):
     dependencies:
-      '@tokenizer/inflate': 0.4.1
+      '@tokenizer/inflate': 0.4.1(supports-color@7.2.0)
       strtok3: 10.3.5
       token-types: 6.1.2
       uint8array-extras: 1.5.0
@@ -3996,9 +4051,9 @@ snapshots:
     dependencies:
       tabbable: 6.5.0
 
-  follow-redirects@1.16.0(debug@4.4.3):
+  follow-redirects@1.16.0(debug@4.4.3(supports-color@7.2.0)):
     optionalDependencies:
-      debug: 4.4.3
+      debug: 4.4.3(supports-color@7.2.0)
 
   form-data@4.0.6:
     dependencies:
@@ -4039,7 +4094,7 @@ snapshots:
       dunder-proto: 1.0.1
       es-object-atoms: 1.1.2
 
-  get-tsconfig@4.14.1:
+  get-tsconfig@5.0.0-beta.5:
     dependencies:
       resolve-pkg-maps: 1.0.0
 
@@ -4056,6 +4111,8 @@ snapshots:
       section-matter: 1.0.0
       strip-bom-string: 1.0.0
 
+  has-flag@4.0.0: {}
+
   has-symbols@1.1.0: {}
 
   has-tostringtag@1.0.2:
@@ -4084,8 +4141,12 @@ snapshots:
     dependencies:
       '@types/hast': 3.0.5
 
+  highlight.js@10.7.3: {}
+
   hookable@5.5.3: {}
 
+  hookable@6.1.1: {}
+
   html-void-elements@3.0.0: {}
 
   htmlparser2@5.0.1:
@@ -4102,10 +4163,10 @@ snapshots:
       domutils: 2.8.0
       entities: 2.2.0
 
-  https-proxy-agent@5.0.1:
+  https-proxy-agent@5.0.1(supports-color@7.2.0):
     dependencies:
-      agent-base: 6.0.2
-      debug: 4.4.3
+      agent-base: 6.0.2(supports-color@7.2.0)
+      debug: 4.4.3(supports-color@7.2.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -4115,9 +4176,7 @@ snapshots:
 
   import-meta-resolve@4.2.0: {}
 
-  is-core-module@2.16.2:
-    dependencies:
-      hasown: 2.0.4
+  import-without-cache@0.4.0: {}
 
   is-docker@3.0.0: {}
 
@@ -4139,16 +4198,10 @@ snapshots:
 
   is-interactive@2.0.0: {}
 
-  is-module@1.0.0: {}
-
   is-number@7.0.0: {}
 
   is-plain-obj@4.1.0: {}
 
-  is-reference@1.2.1:
-    dependencies:
-      '@types/estree': 1.0.9
-
   is-stream@3.0.0: {}
 
   is-unicode-supported@2.1.0: {}
@@ -4171,9 +4224,6 @@ snapshots:
       '@hapi/topo': 6.0.2
       '@standard-schema/spec': 1.1.0
 
-  js-tokens@4.0.0:
-    optional: true
-
   js-yaml@3.15.1:
     dependencies:
       argparse: 1.0.10
@@ -4314,6 +4364,19 @@ snapshots:
 
   markdown-title@1.0.2: {}
 
+  marked-terminal@7.3.0(marked@9.1.6):
+    dependencies:
+      ansi-escapes: 7.3.0
+      ansi-regex: 6.2.2
+      chalk: 5.6.2
+      cli-highlight: 2.1.11
+      cli-table3: 0.6.5
+      marked: 9.1.6
+      node-emoji: 2.2.0
+      supports-hyperlinks: 3.2.0
+
+  marked@9.1.6: {}
+
   math-intrinsics@1.1.0: {}
 
   mathjax-full@3.2.2:
@@ -4323,14 +4386,14 @@ snapshots:
       mj-context-menu: 0.6.1
       speech-rule-engine: 4.1.4
 
-  mdast-util-from-markdown@2.0.3:
+  mdast-util-from-markdown@2.0.3(supports-color@7.2.0):
     dependencies:
       '@types/mdast': 4.0.4
       '@types/unist': 3.0.3
       decode-named-character-reference: 1.3.0
       devlop: 1.1.0
       mdast-util-to-string: 4.0.0
-      micromark: 4.0.2
+      micromark: 4.0.2(supports-color@7.2.0)
       micromark-util-decode-numeric-character-reference: 2.0.2
       micromark-util-decode-string: 2.0.1
       micromark-util-normalize-identifier: 2.0.1
@@ -4340,12 +4403,12 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  mdast-util-frontmatter@2.0.1:
+  mdast-util-frontmatter@2.0.1(supports-color@7.2.0):
     dependencies:
       '@types/mdast': 4.0.4
       devlop: 1.1.0
       escape-string-regexp: 5.0.0
-      mdast-util-from-markdown: 2.0.3
+      mdast-util-from-markdown: 2.0.3(supports-color@7.2.0)
       mdast-util-to-markdown: 2.1.2
       micromark-extension-frontmatter: 2.0.0
     transitivePeerDependencies:
@@ -4512,10 +4575,10 @@ snapshots:
 
   micromark-util-types@2.0.2: {}
 
-  micromark@4.0.2:
+  micromark@4.0.2(supports-color@7.2.0):
     dependencies:
       '@types/debug': 4.1.13
-      debug: 4.4.3
+      debug: 4.4.3(supports-color@7.2.0)
       decode-named-character-reference: 1.3.0
       devlop: 1.1.0
       micromark-core-commonmark: 2.0.3
@@ -4563,16 +4626,31 @@ snapshots:
 
   mj-context-menu@0.6.1: {}
 
+  mri@1.2.0: {}
+
   mrmime@2.0.1: {}
 
   ms@2.1.3: {}
 
   muggle-string@0.4.1: {}
 
+  mz@2.7.0:
+    dependencies:
+      any-promise: 1.3.0
+      object-assign: 4.1.1
+      thenify-all: 1.6.0
+
   nanoid@3.3.18: {}
 
   nanoid@6.0.1: {}
 
+  node-emoji@2.2.0:
+    dependencies:
+      '@sindresorhus/is': 4.6.0
+      char-regex: 1.0.2
+      emojilib: 2.4.0
+      skin-tone: 2.0.0
+
   node-fetch@2.7.0:
     dependencies:
       whatwg-url: 5.0.0
@@ -4581,6 +4659,8 @@ snapshots:
     dependencies:
       boolbase: 1.0.0
 
+  object-assign@4.1.1: {}
+
   obug@2.1.4: {}
 
   onetime@7.0.0:
@@ -4595,9 +4675,9 @@ snapshots:
       regex: 6.1.0
       regex-recursion: 6.0.2
 
-  open-cli@9.0.0:
+  open-cli@9.0.0(supports-color@7.2.0):
     dependencies:
-      file-type: 21.3.4
+      file-type: 21.3.4(supports-color@7.2.0)
       meow: 14.1.0
       open: 11.0.0
       tempy: 3.2.0
@@ -4636,14 +4716,14 @@ snapshots:
     dependencies:
       parse5: 6.0.1
 
+  parse5@5.1.1: {}
+
   parse5@6.0.1: {}
 
   path-browserify@1.0.1: {}
 
   path-key@3.1.1: {}
 
-  path-parse@1.0.7: {}
-
   path-to-regexp@6.3.0: {}
 
   pathe@2.0.3: {}
@@ -4693,14 +4773,19 @@ snapshots:
 
   proxy-from-env@2.1.0: {}
 
+  publint@0.3.24:
+    dependencies:
+      '@publint/pack': 0.1.7
+      package-manager-detector: 1.8.0
+      picocolors: 1.1.1
+      sade: 1.8.1
+
   punycode.js@2.3.1: {}
 
-  punycode@2.3.1: {}
+  quansync@1.0.0: {}
 
   queue-microtask@1.2.3: {}
 
-  readdirp@5.1.1: {}
-
   regex-recursion@6.0.2:
     dependencies:
       regex-utilities: 2.3.0
@@ -4713,19 +4798,19 @@ snapshots:
 
   regexparam@3.0.0: {}
 
-  remark-frontmatter@5.0.0:
+  remark-frontmatter@5.0.0(supports-color@7.2.0):
     dependencies:
       '@types/mdast': 4.0.4
-      mdast-util-frontmatter: 2.0.1
+      mdast-util-frontmatter: 2.0.1(supports-color@7.2.0)
       micromark-extension-frontmatter: 2.0.0
       unified: 11.0.5
     transitivePeerDependencies:
       - supports-color
 
-  remark-parse@11.0.0:
+  remark-parse@11.0.0(supports-color@7.2.0):
     dependencies:
       '@types/mdast': 4.0.4
-      mdast-util-from-markdown: 2.0.3
+      mdast-util-from-markdown: 2.0.3(supports-color@7.2.0)
       micromark-util-types: 2.0.2
       unified: 11.0.5
     transitivePeerDependencies:
@@ -4737,10 +4822,10 @@ snapshots:
       mdast-util-to-markdown: 2.1.2
       unified: 11.0.5
 
-  remark@15.0.1:
+  remark@15.0.1(supports-color@7.2.0):
     dependencies:
       '@types/mdast': 4.0.4
-      remark-parse: 11.0.0
+      remark-parse: 11.0.0(supports-color@7.2.0)
       remark-stringify: 11.0.0
       unified: 11.0.5
     transitivePeerDependencies:
@@ -4750,13 +4835,6 @@ snapshots:
 
   resolve-pkg-maps@1.0.0: {}
 
-  resolve@1.22.12:
-    dependencies:
-      es-errors: 1.3.0
-      is-core-module: 2.16.2
-      path-parse: 1.0.7
-      supports-preserve-symlinks-flag: 1.0.0
-
   restore-cursor@5.1.0:
     dependencies:
       onetime: 7.0.0
@@ -4764,6 +4842,22 @@ snapshots:
 
   reusify@1.1.0: {}
 
+  rolldown-plugin-dts@0.27.14(@volar/typescript@2.4.28(typescript@6.0.3))(rolldown@1.2.3)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3)):
+    dependencies:
+      dts-resolver: 3.0.0
+      get-tsconfig: 5.0.0-beta.5
+      obug: 2.1.4
+      rolldown: 1.2.3
+      yuku-ast: 0.8.7
+      yuku-codegen: 0.8.7
+      yuku-parser: 0.8.7
+    optionalDependencies:
+      '@volar/typescript': 2.4.28(typescript@6.0.3)
+      typescript: 6.0.3
+      vue-tsc: 3.3.11(typescript@6.0.3)
+    transitivePeerDependencies:
+      - oxc-resolver
+
   rolldown@1.2.3:
     dependencies:
       '@oxc-project/types': 0.143.0
@@ -4784,56 +4878,26 @@ snapshots:
       '@rolldown/binding-win32-arm64-msvc': 1.2.3
       '@rolldown/binding-win32-x64-msvc': 1.2.3
 
-  rollup-plugin-dts@6.1.1(rollup@4.62.4)(typescript@5.9.3):
-    dependencies:
-      magic-string: 0.30.21
-      rollup: 4.62.4
-      typescript: 5.9.3
-    optionalDependencies:
-      '@babel/code-frame': 7.29.7
-
-  rollup-plugin-esbuild@6.2.1(esbuild@0.27.7)(rollup@4.62.4):
-    dependencies:
-      debug: 4.4.3
-      es-module-lexer: 1.7.0
-      esbuild: 0.27.7
-      get-tsconfig: 4.14.1
-      rollup: 4.62.4
-      unplugin-utils: 0.2.5
-    transitivePeerDependencies:
-      - supports-color
-
-  rollup@4.62.4:
+  rolldown@1.2.5:
     dependencies:
-      '@types/estree': 1.0.9
+      '@oxc-project/types': 0.146.0
+      '@rolldown/pluginutils': 1.0.1
     optionalDependencies:
-      '@napi-rs/lzma-linux-x64-gnu': 1.5.1
-      '@rollup/rollup-android-arm-eabi': 4.62.4
-      '@rollup/rollup-android-arm64': 4.62.4
-      '@rollup/rollup-darwin-arm64': 4.62.4
-      '@rollup/rollup-darwin-x64': 4.62.4
-      '@rollup/rollup-freebsd-arm64': 4.62.4
-      '@rollup/rollup-freebsd-x64': 4.62.4
-      '@rollup/rollup-linux-arm-gnueabihf': 4.62.4
-      '@rollup/rollup-linux-arm-musleabihf': 4.62.4
-      '@rollup/rollup-linux-arm64-gnu': 4.62.4
-      '@rollup/rollup-linux-arm64-musl': 4.62.4
-      '@rollup/rollup-linux-loong64-gnu': 4.62.4
-      '@rollup/rollup-linux-loong64-musl': 4.62.4
-      '@rollup/rollup-linux-ppc64-gnu': 4.62.4
-      '@rollup/rollup-linux-ppc64-musl': 4.62.4
-      '@rollup/rollup-linux-riscv64-gnu': 4.62.4
-      '@rollup/rollup-linux-riscv64-musl': 4.62.4
-      '@rollup/rollup-linux-s390x-gnu': 4.62.4
-      '@rollup/rollup-linux-x64-gnu': 4.62.4
-      '@rollup/rollup-linux-x64-musl': 4.62.4
-      '@rollup/rollup-openbsd-x64': 4.62.4
-      '@rollup/rollup-openharmony-arm64': 4.62.4
-      '@rollup/rollup-win32-arm64-msvc': 4.62.4
-      '@rollup/rollup-win32-ia32-msvc': 4.62.4
-      '@rollup/rollup-win32-x64-gnu': 4.62.4
-      '@rollup/rollup-win32-x64-msvc': 4.62.4
-      fsevents: 2.3.3
+      '@rolldown/binding-android-arm-eabi': 1.2.5
+      '@rolldown/binding-android-arm64': 1.2.5
+      '@rolldown/binding-darwin-arm64': 1.2.5
+      '@rolldown/binding-darwin-x64': 1.2.5
+      '@rolldown/binding-freebsd-x64': 1.2.5
+      '@rolldown/binding-linux-arm-gnueabihf': 1.2.5
+      '@rolldown/binding-linux-arm64-gnu': 1.2.5
+      '@rolldown/binding-linux-arm64-musl': 1.2.5
+      '@rolldown/binding-linux-ppc64-gnu': 1.2.5
+      '@rolldown/binding-linux-s390x-gnu': 1.2.5
+      '@rolldown/binding-linux-x64-gnu': 1.2.5
+      '@rolldown/binding-linux-x64-musl': 1.2.5
+      '@rolldown/binding-openharmony-arm64': 1.2.5
+      '@rolldown/binding-win32-arm64-msvc': 1.2.5
+      '@rolldown/binding-win32-x64-msvc': 1.2.5
 
   rtlcss@4.3.0:
     dependencies:
@@ -4852,6 +4916,10 @@ snapshots:
     dependencies:
       tslib: 2.8.1
 
+  sade@1.8.1:
+    dependencies:
+      mri: 1.2.0
+
   sax@1.6.1: {}
 
   section-matter@1.0.0:
@@ -4884,13 +4952,13 @@ snapshots:
 
   simple-git-hooks@2.13.1: {}
 
-  simple-git@3.36.0:
+  simple-git@3.36.0(supports-color@7.2.0):
     dependencies:
-      '@kwsites/file-exists': 1.1.1
+      '@kwsites/file-exists': 1.1.1(supports-color@7.2.0)
       '@kwsites/promise-deferred': 1.1.1
       '@simple-git/args-pathspec': 1.0.3
       '@simple-git/argv-parser': 1.1.1
-      debug: 4.4.3
+      debug: 4.4.3(supports-color@7.2.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -4909,6 +4977,10 @@ snapshots:
       arg: 5.0.2
       sax: 1.6.1
 
+  skin-tone@2.0.0:
+    dependencies:
+      unicode-emoji-modifier-base: 1.0.0
+
   slick@1.12.2: {}
 
   source-map-js@1.2.1: {}
@@ -4963,7 +5035,14 @@ snapshots:
     dependencies:
       '@tokenizer/token': 0.3.0
 
-  supports-preserve-symlinks-flag@1.0.0: {}
+  supports-color@7.2.0:
+    dependencies:
+      has-flag: 4.0.0
+
+  supports-hyperlinks@3.2.0:
+    dependencies:
+      has-flag: 4.0.0
+      supports-color: 7.2.0
 
   tabbable@6.5.0: {}
 
@@ -4976,6 +5055,14 @@ snapshots:
       type-fest: 2.19.0
       unique-string: 3.0.0
 
+  thenify-all@1.6.0:
+    dependencies:
+      thenify: 3.3.1
+
+  thenify@3.3.1:
+    dependencies:
+      any-promise: 1.3.0
+
   tinybench@2.9.0: {}
 
   tinyexec@1.3.0: {}
@@ -5003,6 +5090,8 @@ snapshots:
 
   tr46@0.0.3: {}
 
+  tree-kill@1.2.2: {}
+
   trim-lines@3.0.1: {}
 
   trough@2.2.0: {}
@@ -5011,13 +5100,42 @@ snapshots:
     dependencies:
       regexparam: 3.0.0
 
+  tsdown@0.22.14(@arethetypeswrong/core@0.18.5)(@volar/typescript@2.4.28(typescript@6.0.3))(publint@0.3.24)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3)):
+    dependencies:
+      ansis: 4.3.1
+      cac: 7.0.0
+      defu: 6.1.7
+      empathic: 2.0.1
+      hookable: 6.1.1
+      import-without-cache: 0.4.0
+      obug: 2.1.4
+      picomatch: 4.0.5
+      rolldown: 1.2.3
+      rolldown-plugin-dts: 0.27.14(@volar/typescript@2.4.28(typescript@6.0.3))(rolldown@1.2.3)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3))
+      tinyexec: 1.3.0
+      tinyglobby: 0.2.17
+      tree-kill: 1.2.2
+      unconfig-core: 7.5.0
+      verkit: 0.3.2
+    optionalDependencies:
+      '@arethetypeswrong/core': 0.18.5
+      publint: 0.3.24
+      typescript: 6.0.3
+    transitivePeerDependencies:
+      - '@typescript/native-preview'
+      - '@volar/typescript'
+      - oxc-resolver
+      - vue-tsc
+
   tslib@2.8.1: {}
 
   type-fest@1.4.0: {}
 
   type-fest@2.19.0: {}
 
-  typescript@5.9.3: {}
+  typescript@5.6.1-rc: {}
+
+  typescript@6.0.3: {}
 
   uc.micro@2.1.0: {}
 
@@ -5025,10 +5143,17 @@ snapshots:
 
   ultramatter@0.0.4: {}
 
+  unconfig-core@7.5.0:
+    dependencies:
+      '@quansync/fs': 1.0.0
+      quansync: 1.0.0
+
   undici-types@7.18.2: {}
 
   undici-types@8.3.0: {}
 
+  unicode-emoji-modifier-base@1.0.0: {}
+
   unified@11.0.5:
     dependencies:
       '@types/unist': 3.0.3
@@ -5072,15 +5197,14 @@ snapshots:
       unist-util-is: 6.0.1
       unist-util-visit-parents: 6.0.2
 
-  unplugin-utils@0.2.5:
-    dependencies:
-      pathe: 2.0.3
-      picomatch: 4.0.5
-
   util-deprecate@1.0.2: {}
 
   valid-data-url@3.0.1: {}
 
+  validate-npm-package-name@5.0.1: {}
+
+  verkit@0.3.2: {}
+
   vfile-message@4.0.3:
     dependencies:
       '@types/unist': 3.0.3
@@ -5091,51 +5215,50 @@ snapshots:
       '@types/unist': 3.0.3
       vfile-message: 4.0.3
 
-  vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0):
+  vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0):
     dependencies:
       lightningcss: 1.33.0
       picomatch: 4.0.5
       postcss: 8.5.26
-      rolldown: 1.2.3
+      rolldown: 1.2.5
       tinyglobby: 0.2.17
     optionalDependencies:
       '@types/node': 26.2.0
-      esbuild: 0.27.7
       fsevents: 2.3.3
       jiti: 1.21.7
       yaml: 2.9.0
 
-  vitepress-plugin-group-icons@1.7.6(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0)):
+  vitepress-plugin-group-icons@1.7.6(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0)):
     dependencies:
       '@iconify-json/logos': 1.2.12
       '@iconify-json/vscode-icons': 1.2.70
       '@iconify/utils': 3.1.4
     optionalDependencies:
-      vite: 8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0)
+      vite: 8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0)
 
-  vitepress-plugin-llms@1.13.4:
+  vitepress-plugin-llms@1.13.4(supports-color@7.2.0):
     dependencies:
       '@11ty/gray-matter': 2.1.0
       markdown-it: 14.3.0
       markdown-title: 1.0.2
-      mdast-util-from-markdown: 2.0.3
+      mdast-util-from-markdown: 2.0.3(supports-color@7.2.0)
       millify: 6.1.0
       minimatch: 10.2.6
       path-to-regexp: 6.3.0
       picocolors: 1.1.1
       pretty-bytes: 7.1.1
-      remark: 15.0.1
-      remark-frontmatter: 5.0.0
+      remark: 15.0.1(supports-color@7.2.0)
+      remark-frontmatter: 5.0.0(supports-color@7.2.0)
       tokenx: 1.6.0
       unist-util-remove: 4.0.0
       unist-util-visit: 5.1.0
     transitivePeerDependencies:
       - supports-color
 
-  vitest@4.1.10(@types/node@26.2.0)(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0)):
+  vitest@4.1.10(@types/node@26.2.0)(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0)):
     dependencies:
       '@vitest/expect': 4.1.10
-      '@vitest/mocker': 4.1.10(vite@8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0))
+      '@vitest/mocker': 4.1.10(vite@8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0))
       '@vitest/pretty-format': 4.1.10
       '@vitest/runner': 4.1.10
       '@vitest/snapshot': 4.1.10
@@ -5152,7 +5275,7 @@ snapshots:
       tinyexec: 1.3.0
       tinyglobby: 0.2.17
       tinyrainbow: 3.1.1
-      vite: 8.2.1(@types/node@26.2.0)(esbuild@0.27.7)(jiti@1.21.7)(yaml@2.9.0)
+      vite: 8.2.1(@types/node@26.2.0)(jiti@1.21.7)(yaml@2.9.0)
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@types/node': 26.2.0
@@ -5161,13 +5284,26 @@ snapshots:
 
   vscode-uri@3.1.0: {}
 
-  vue-tsc@3.3.9(typescript@5.9.3):
+  vue-sfc-transformer@0.2.5(patch_hash=06dbce7d98fac77faf5e66a94aa6e04f34c0cc7ec0910ec10848e5f2e08b8b68)(@volar/typescript@2.4.28(typescript@6.0.3))(@vue/compiler-core@3.5.41)(@vue/language-core@3.3.11)(rolldown@1.2.5)(typescript@6.0.3)(vue@3.5.41(typescript@6.0.3)):
+    dependencies:
+      '@babel/parser': 7.29.8
+      '@vue/compiler-core': 3.5.41
+      pathe: 2.0.3
+      tinyglobby: 0.2.17
+      vue: 3.5.41(typescript@6.0.3)
+    optionalDependencies:
+      '@volar/typescript': 2.4.28(typescript@6.0.3)
+      '@vue/language-core': 3.3.11
+      rolldown: 1.2.5
+      typescript: 6.0.3
+
+  vue-tsc@3.3.11(typescript@6.0.3):
     dependencies:
-      '@volar/typescript': 2.4.28(typescript@5.9.3)
-      '@vue/language-core': 3.3.9
-      typescript: 5.9.3
+      '@volar/typescript': 2.4.28(typescript@6.0.3)
+      '@vue/language-core': 3.3.11
+      typescript: 6.0.3
 
-  vue@3.5.41(typescript@5.9.3):
+  vue@3.5.41(typescript@6.0.3):
     dependencies:
       '@vue/compiler-dom': 3.5.41
       '@vue/compiler-sfc': 3.5.41
@@ -5175,11 +5311,11 @@ snapshots:
       '@vue/server-renderer': 3.5.41
       '@vue/shared': 3.5.41
     optionalDependencies:
-      typescript: 5.9.3
+      typescript: 6.0.3
 
-  wait-on@9.1.0(debug@4.4.3):
+  wait-on@9.1.0(debug@4.4.3(supports-color@7.2.0))(supports-color@7.2.0):
     dependencies:
-      axios: 1.19.0(debug@4.4.3)
+      axios: 1.19.0(debug@4.4.3(supports-color@7.2.0))(supports-color@7.2.0)
       joi: 18.2.3
       lodash: 4.18.1
       minimist: 1.2.8
@@ -5235,8 +5371,20 @@ snapshots:
   yaml@2.9.0:
     optional: true
 
+  yargs-parser@20.2.9: {}
+
   yargs-parser@21.1.1: {}
 
+  yargs@16.2.2:
+    dependencies:
+      cliui: 7.0.4
+      escalade: 3.2.0
+      get-caller-file: 2.0.5
+      require-directory: 2.1.1
+      string-width: 4.2.3
+      y18n: 5.0.8
+      yargs-parser: 20.2.9
+
   yargs@17.7.3:
     dependencies:
       cliui: 8.0.1
@@ -5249,6 +5397,45 @@ snapshots:
 
   yoctocolors@2.2.0: {}
 
+  yuku-ast@0.8.7:
+    dependencies:
+      '@yuku-toolchain/types': 0.8.7
+
+  yuku-codegen@0.8.7:
+    dependencies:
+      '@yuku-toolchain/types': 0.8.7
+    optionalDependencies:
+      '@yuku-codegen/binding-android-arm64': 0.8.7
+      '@yuku-codegen/binding-darwin-arm64': 0.8.7
+      '@yuku-codegen/binding-darwin-x64': 0.8.7
+      '@yuku-codegen/binding-freebsd-x64': 0.8.7
+      '@yuku-codegen/binding-linux-arm-gnu': 0.8.7
+      '@yuku-codegen/binding-linux-arm-musl': 0.8.7
+      '@yuku-codegen/binding-linux-arm64-gnu': 0.8.7
+      '@yuku-codegen/binding-linux-arm64-musl': 0.8.7
+      '@yuku-codegen/binding-linux-x64-gnu': 0.8.7
+      '@yuku-codegen/binding-linux-x64-musl': 0.8.7
+      '@yuku-codegen/binding-win32-arm64': 0.8.7
+      '@yuku-codegen/binding-win32-x64': 0.8.7
+
+  yuku-parser@0.8.7:
+    dependencies:
+      '@yuku-toolchain/types': 0.8.7
+      yuku-ast: 0.8.7
+    optionalDependencies:
+      '@yuku-parser/binding-android-arm64': 0.8.7
+      '@yuku-parser/binding-darwin-arm64': 0.8.7
+      '@yuku-parser/binding-darwin-x64': 0.8.7
+      '@yuku-parser/binding-freebsd-x64': 0.8.7
+      '@yuku-parser/binding-linux-arm-gnu': 0.8.7
+      '@yuku-parser/binding-linux-arm-musl': 0.8.7
+      '@yuku-parser/binding-linux-arm64-gnu': 0.8.7
+      '@yuku-parser/binding-linux-arm64-musl': 0.8.7
+      '@yuku-parser/binding-linux-x64-gnu': 0.8.7
+      '@yuku-parser/binding-linux-x64-musl': 0.8.7
+      '@yuku-parser/binding-win32-arm64': 0.8.7
+      '@yuku-parser/binding-win32-x64': 0.8.7
+
   zod@3.25.76: {}
 
   zwitch@2.0.4: {}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 2338b29a..7feb78ec 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -3,7 +3,6 @@ packages:
   - __tests__/*
 
 allowBuilds:
-  esbuild: true
   playwright-chromium: true
   simple-git-hooks: true
 
@@ -13,6 +12,12 @@ ignoreWorkspaceRootCheck: true
 
 minimumReleaseAge: 1440
 
+overrides:
+  esbuild: '-'
+
+patchedDependencies:
+  vue-sfc-transformer: patches/vue-sfc-transformer.patch
+
 shellEmulator: true
 
 strictPeerDependencies: true
diff --git a/rollup.config.ts b/rollup.config.ts
deleted file mode 100644
index cce223e5..00000000
--- a/rollup.config.ts
+++ /dev/null
@@ -1,115 +0,0 @@
-import { rm } from 'node:fs/promises'
-import { builtinModules } from 'node:module'
-import { fileURLToPath } from 'node:url'
-
-import alias from '@rollup/plugin-alias'
-import commonjs from '@rollup/plugin-commonjs'
-import json from '@rollup/plugin-json'
-import { nodeResolve } from '@rollup/plugin-node-resolve'
-import replace from '@rollup/plugin-replace'
-import { type RollupOptions, defineConfig } from 'rollup'
-import dts from 'rollup-plugin-dts'
-import esbuild from 'rollup-plugin-esbuild'
-
-import pkg from './package.json' with { type: 'json' }
-
-const DEV = !!process.env.DEV
-const PROD = !DEV
-
-const external = [
-  ...Object.keys(pkg.dependencies),
-  ...Object.keys(pkg.peerDependencies),
-  ...builtinModules.flatMap((m) =>
-    m.includes('punycode') ? [] : [m, `node:${m}`]
-  )
-]
-
-const plugins = [
-  alias({ entries: { 'readable-stream': 'stream' } }),
-  replace({
-    // polyfill broken browser check from bundled deps
-    'navigator.userAgentData': 'undefined',
-    'navigator.userAgent': 'undefined',
-    preventAssignment: true
-  }),
-  commonjs(),
-  nodeResolve({ preferBuiltins: false }),
-  esbuild({ target: 'node22' }),
-  json()
-]
-
-const esmBuild: RollupOptions = {
-  input: ['src/node/index.ts', 'src/node/cli.ts'],
-  output: {
-    format: 'esm',
-    entryFileNames: `[name].js`,
-    chunkFileNames: 'chunk-[hash].js',
-    dir: 'dist/node',
-    sourcemap: DEV
-  },
-  external,
-  plugins,
-  onwarn(warning, warn) {
-    if (warning.code !== 'EVAL') warn(warning)
-  }
-}
-
-// keep .d.ts files under the repo root (e.g. types/*) external so module
-// augmentations in the bundle still target the same files users reference.
-// compared on normalized resolved paths so this works regardless of the
-// checkout location, path separators, or drive-letter casing.
-const normalizePath = (id: string): string => {
-  const normalized = id.replaceAll('\\', '/')
-  return process.platform === 'win32' ? normalized.toLowerCase() : normalized
-}
-
-const root = normalizePath(fileURLToPath(new URL('.', import.meta.url)))
-
-const typesExternal = (id: string): boolean => {
-  if (external.includes(id) || /^markdown-it(?:\/|$)/.test(id)) return true
-  const normalized = normalizePath(id)
-  return (
-    normalized.endsWith('.d.ts') &&
-    normalized.startsWith(root) &&
-    !normalized.startsWith(`${root}dist/`) &&
-    !normalized.startsWith(`${root}node_modules/`)
-  )
-}
-
-const dtsNode = dts({
-  respectExternal: true,
-  tsconfig: 'src/node/tsconfig.json',
-  compilerOptions: { preserveSymlinks: false }
-})
-
-const nodeTypes: RollupOptions = {
-  input: 'src/node/index.ts',
-  output: {
-    format: 'esm',
-    file: 'dist/node/index.d.ts'
-  },
-  external: typesExternal,
-  plugins: [dtsNode]
-}
-
-const clientTypes: RollupOptions = {
-  input: 'dist/client-types/index.d.ts',
-  output: {
-    format: 'esm',
-    file: 'dist/client/index.d.ts'
-  },
-  external: typesExternal,
-  plugins: [
-    dts({ respectExternal: true }),
-    {
-      name: 'cleanup',
-      async closeBundle() {
-        if (PROD) {
-          await rm('dist/client-types', { recursive: true })
-        }
-      }
-    }
-  ]
-}
-
-export default defineConfig([esmBuild, nodeTypes, clientTypes])
diff --git a/scripts/copyClient.ts b/scripts/copyClient.ts
deleted file mode 100644
index 852bdb91..00000000
--- a/scripts/copyClient.ts
+++ /dev/null
@@ -1,12 +0,0 @@
-import { cp } from 'node:fs/promises'
-
-import { globSync } from 'tinyglobby'
-
-function toDest(file: string) {
-  return file.replace(/^src\//, 'dist/')
-}
-
-globSync(['src/client/**']).forEach((file) => {
-  if (/(\.ts|tsconfig\.json)$/.test(file)) return
-  cp(file, toDest(file))
-})
diff --git a/scripts/copyShared.ts b/scripts/copyShared.ts
deleted file mode 100644
index d73257b1..00000000
--- a/scripts/copyShared.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-import { cp } from 'node:fs/promises'
-
-import { globSync } from 'tinyglobby'
-
-globSync(['src/shared/**/*.ts']).forEach(async (file) => {
-  await Promise.all([
-    cp(file, file.replace(/^src\/shared\//, 'src/node/')),
-    cp(file, file.replace(/^src\/shared\//, 'src/client/'))
-  ])
-})
diff --git a/scripts/watchAndCopy.ts b/scripts/watchAndCopy.ts
deleted file mode 100644
index ce725678..00000000
--- a/scripts/watchAndCopy.ts
+++ /dev/null
@@ -1,38 +0,0 @@
-import { cp, rm } from 'node:fs/promises'
-
-import { watch } from 'chokidar'
-import { normalizePath } from 'vite'
-
-function toClientAndNode(method: 'copy' | 'remove', file: string) {
-  file = normalizePath(file)
-  if (method === 'copy') {
-    cp(file, file.replace(/^src\/shared\//, 'src/node/'))
-    cp(file, file.replace(/^src\/shared\//, 'src/client/'))
-  } else if (method === 'remove') {
-    rm(file.replace(/^src\/shared\//, 'src/node/'), { force: true })
-    rm(file.replace(/^src\/shared\//, 'src/client/'), { force: true })
-  }
-}
-
-function toDist(file: string) {
-  return normalizePath(file).replace(/^src\//, 'dist/')
-}
-
-// copy shared files to the client and node directory whenever they change.
-watch('src/shared', {
-  ignored: (path, stats) => !!stats?.isFile() && !path.endsWith('.ts')
-})
-  .on('change', (file) => toClientAndNode('copy', file))
-  .on('add', (file) => toClientAndNode('copy', file))
-  .on('unlink', (file) => toClientAndNode('remove', file))
-
-// copy non ts files, such as an html or css, to the dist directory whenever
-// they change.
-watch('src/client', {
-  ignored: (path, stats) =>
-    !!stats?.isFile() &&
-    (path.endsWith('.ts') || path.endsWith('tsconfig.json'))
-})
-  .on('change', (file) => cp(file, toDist(file)))
-  .on('add', (file) => cp(file, toDist(file)))
-  .on('unlink', (file) => rm(toDist(file), { force: true }))
diff --git a/shared-globals.d.ts b/shared-globals.d.ts
new file mode 100644
index 00000000..3fcf43bb
--- /dev/null
+++ b/shared-globals.d.ts
@@ -0,0 +1,13 @@
+// Cross-environment globals that environment-neutral code may use, declared
+// merge-compatibly with lib.dom and @types/node (interface merging plus an
+// identically named var). Loaded only by projects without a DOM lib; keep
+// members to what shared code actually touches.
+
+interface Console {
+  debug(...data: unknown[]): void
+  warn(...data: unknown[]): void
+}
+declare var console: Console
+
+interface Document {}
+declare var document: Document
diff --git a/src/client/app/composables/codeGroups.ts b/src/client/app/composables/codeGroups.ts
index ba56bc05..731e220a 100644
--- a/src/client/app/composables/codeGroups.ts
+++ b/src/client/app/composables/codeGroups.ts
@@ -7,7 +7,8 @@ export function useCodeGroups() {
         Array.from(el.children).forEach((child) => {
           child.classList.remove('active')
         })
-        activate(el.children[0])
+        const first = el.children[0]
+        if (first) activate(first)
       })
     })
   }
diff --git a/src/client/app/composables/copyCode.ts b/src/client/app/composables/copyCode.ts
index 7a52e621..b686f0b9 100644
--- a/src/client/app/composables/copyCode.ts
+++ b/src/client/app/composables/copyCode.ts
@@ -6,7 +6,7 @@ const ignoredNodes = ['.vp-copy-ignore', '.diff.remove'].join(', ')
 
 export function useCopyCode() {
   if (inBrowser) {
-    const timeoutIdMap: WeakMap<HTMLElement, NodeJS.Timeout> = new WeakMap()
+    const timeoutIdMap: WeakMap<HTMLElement, number> = new WeakMap()
     window.addEventListener('click', (e) => {
       const el = e.target as HTMLElement
       if (el.matches('div[class*="language-"] > button.copy')) {
@@ -35,7 +35,7 @@ export function useCopyCode() {
         copyToClipboard(text).then(() => {
           el.classList.add('copied')
           clearTimeout(timeoutIdMap.get(el))
-          const timeoutId = setTimeout(() => {
+          const timeoutId = window.setTimeout(() => {
             el.classList.remove('copied')
             el.blur()
             timeoutIdMap.delete(el)
diff --git a/src/client/app/composables/head.ts b/src/client/app/composables/head.ts
index 74a041c5..c6238f43 100644
--- a/src/client/app/composables/head.ts
+++ b/src/client/app/composables/head.ts
@@ -82,8 +82,8 @@ export function useUpdateHead(route: Route, siteDataByRouteRef: Ref<SiteData>) {
 
 function createHeadElement([tag, attrs, innerHTML]: HeadConfig) {
   const el = document.createElement(tag)
-  for (const key in attrs) {
-    el.setAttribute(key, attrs[key])
+  for (const [key, value] of Object.entries(attrs)) {
+    el.setAttribute(key, value)
   }
   if (innerHTML) {
     el.innerHTML = innerHTML
diff --git a/src/client/shims.d.ts b/src/client/shims.d.ts
index e12889d5..740a932a 100644
--- a/src/client/shims.d.ts
+++ b/src/client/shims.d.ts
@@ -1,3 +1,8 @@
+// vite/client rather than vitepress/client: the .vue declaration emit runs
+// outside a project and cannot resolve self-references, and client.d.ts would
+// pull the built dist into the program, clashing with the sources
+/// <reference types="vite/client" />
+
 declare const __VP_HASH_MAP__: Record<string, string>
 declare const __VP_LOCAL_SEARCH__: boolean
 declare const __ALGOLIA__: boolean
@@ -5,12 +10,6 @@ declare const __CARBON__: boolean
 declare const __VUE_PROD_DEVTOOLS__: boolean
 declare const __ASSETS_DIR__: string
 
-declare module '*.vue' {
-  import type { DefineComponent } from 'vue'
-  const component: DefineComponent
-  export default component
-}
-
 declare module '@siteData' {
   import type { SiteData } from 'vitepress'
   const data: SiteData
diff --git a/src/client/theme-default/components/VPCarbonAds.vue b/src/client/theme-default/components/VPCarbonAds.vue
index 51a617f8..5f4b5cfa 100644
--- a/src/client/theme-default/components/VPCarbonAds.vue
+++ b/src/client/theme-default/components/VPCarbonAds.vue
@@ -2,7 +2,7 @@
 import { useMediaQuery } from '@vueuse/core'
 import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { onMounted, ref, watch } from 'vue'
+import { onMounted, useTemplateRef, watch } from 'vue'
 
 const route = useRoute()
 const props = defineProps<{
@@ -12,7 +12,7 @@ const props = defineProps<{
 const carbonOptions = props.carbonAds
 
 const isAsideVisible = useMediaQuery('(min-width: 80rem)')
-const container = ref()
+const container = useTemplateRef('container')
 
 let isInitialized = false
 
@@ -28,7 +28,7 @@ function init() {
     s.id = '_carbonads_js'
     s.src = `//cdn.carbonads.com/carbon.js?${params.toString()}`
     s.async = true
-    container.value.appendChild(s)
+    container.value?.appendChild(s)
   }
 }
 
diff --git a/src/client/theme-default/components/VPDocAsideOutline.vue b/src/client/theme-default/components/VPDocAsideOutline.vue
index 2a5ba00b..8082b336 100644
--- a/src/client/theme-default/components/VPDocAsideOutline.vue
+++ b/src/client/theme-default/components/VPDocAsideOutline.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { ref } from 'vue'
+import { useTemplateRef } from 'vue'
 
 import { useData } from '../composables/data'
 import { useLayout } from '../composables/layout'
@@ -8,8 +8,8 @@ import VPDocOutlineItem from './VPDocOutlineItem.vue'
 
 const { theme } = useData()
 
-const container = ref()
-const marker = ref()
+const container = useTemplateRef('container')
+const marker = useTemplateRef('marker')
 
 const { headers, hasLocalNav } = useLayout()
 
diff --git a/src/client/theme-default/components/VPFlyout.vue b/src/client/theme-default/components/VPFlyout.vue
index 3b2e58af..cdb86fb3 100644
--- a/src/client/theme-default/components/VPFlyout.vue
+++ b/src/client/theme-default/components/VPFlyout.vue
@@ -1,6 +1,6 @@
 <script lang="ts" setup generic="T extends DefaultTheme.NavItem">
 import type { DefaultTheme } from 'vitepress/theme'
-import { ref } from 'vue'
+import { ref, useTemplateRef } from 'vue'
 
 import { useFlyout } from '../composables/flyout'
 import VPMenu from './VPMenu.vue'
@@ -13,7 +13,7 @@ defineProps<{
 }>()
 
 const open = ref(false)
-const el = ref<HTMLElement>()
+const el = useTemplateRef('el')
 
 useFlyout({ el, onBlur })
 
diff --git a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
index 349f6613..11f5be61 100644
--- a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
+++ b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
@@ -2,7 +2,7 @@
 import { onKeyStroke } from '@vueuse/core'
 import { onContentUpdated } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { nextTick, ref, watch } from 'vue'
+import { nextTick, ref, useTemplateRef, watch } from 'vue'
 
 import { useData } from '../composables/data'
 import { resolveTitle } from '../composables/outline'
@@ -17,8 +17,8 @@ const props = defineProps<{
 const { theme } = useData()
 const open = ref(false)
 const vh = ref(0)
-const main = ref<HTMLDivElement>()
-const items = ref<HTMLDivElement>()
+const main = useTemplateRef('main')
+const items = useTemplateRef('items')
 
 // lock body scroll while the dropdown is open to prevent scroll chaining
 const isLocked = useBodyScrollLock()
diff --git a/src/client/theme-default/components/VPLocalSearchBox.vue b/src/client/theme-default/components/VPLocalSearchBox.vue
index 34088590..046c849b 100644
--- a/src/client/theme-default/components/VPLocalSearchBox.vue
+++ b/src/client/theme-default/components/VPLocalSearchBox.vue
@@ -21,6 +21,7 @@ import {
   onMounted,
   ref,
   shallowRef,
+  useTemplateRef,
   watch,
   watchEffect,
   type Ref
@@ -38,8 +39,8 @@ const emit = defineEmits<{
   (e: 'close'): void
 }>()
 
-const el = shallowRef<HTMLElement>()
-const resultsEl = shallowRef<HTMLElement>()
+const el = useTemplateRef('el')
+const resultsEl = useTemplateRef('resultsEl')
 
 /* Search */
 
@@ -75,25 +76,25 @@ const showSearchSpinner = computed(() => {
 })
 
 const searchIndex = computedAsync(
-  async () =>
-    markRaw(
-      MiniSearch.loadJSON<Result>(
-        (await searchIndexData.value[localeIndex.value]?.())?.default,
-        {
-          fields: ['title', 'titles', 'text'],
-          storeFields: ['title', 'titles'],
-          searchOptions: {
-            fuzzy: 0.2,
-            prefix: true,
-            boost: { title: 4, text: 2, titles: 1 },
-            ...(theme.value.search?.provider === 'local' &&
-              theme.value.search.options?.miniSearch?.searchOptions)
-          },
+  async () => {
+    const json = (await searchIndexData.value[localeIndex.value]?.())?.default
+    if (!json) return null
+    return markRaw(
+      MiniSearch.loadJSON<Result>(json, {
+        fields: ['title', 'titles', 'text'],
+        storeFields: ['title', 'titles'],
+        searchOptions: {
+          fuzzy: 0.2,
+          prefix: true,
+          boost: { title: 4, text: 2, titles: 1 },
           ...(theme.value.search?.provider === 'local' &&
-            theme.value.search.options?.miniSearch?.options)
-        }
-      )
-    ),
+            theme.value.search.options?.miniSearch?.searchOptions)
+        },
+        ...(theme.value.search?.provider === 'local' &&
+          theme.value.search.options?.miniSearch?.options)
+      })
+    )
+  },
   undefined,
   isSearchIndexLoading
 )
@@ -265,7 +266,7 @@ async function fetchExcerpt(id: string) {
 
 /* Search input focus */
 
-const searchInput = ref<HTMLInputElement>()
+const searchInput = useTemplateRef('searchInput')
 const disableReset = computed(() => {
   return filterText.value?.length <= 0
 })
diff --git a/src/client/theme-default/components/VPSidebar.vue b/src/client/theme-default/components/VPSidebar.vue
index 4d247d53..377b7a9c 100644
--- a/src/client/theme-default/components/VPSidebar.vue
+++ b/src/client/theme-default/components/VPSidebar.vue
@@ -1,5 +1,5 @@
 <script lang="ts" setup>
-import { ref, watch } from 'vue'
+import { ref, useTemplateRef, watch } from 'vue'
 
 import { useLayout } from '../composables/layout'
 import { useBodyScrollLock } from '../composables/scroll-lock'
@@ -12,7 +12,7 @@ const props = defineProps<{
 }>()
 
 // a11y: focus Nav element when menu has opened
-const navEl = ref<HTMLElement | null>(null)
+const navEl = useTemplateRef('navEl')
 const isLocked = useBodyScrollLock()
 
 watch(
diff --git a/src/client/theme-default/components/VPSkipLink.vue b/src/client/theme-default/components/VPSkipLink.vue
index d9aabb04..78cebdd8 100644
--- a/src/client/theme-default/components/VPSkipLink.vue
+++ b/src/client/theme-default/components/VPSkipLink.vue
@@ -1,14 +1,14 @@
 <script lang="ts" setup>
 import { useRoute } from 'vitepress'
-import { ref, watch } from 'vue'
+import { useTemplateRef, watch } from 'vue'
 
 import { useData } from '../composables/data'
 
 const { theme } = useData()
 const route = useRoute()
-const backToTop = ref()
+const backToTop = useTemplateRef('backToTop')
 
-watch(() => route.path, () => backToTop.value.focus())
+watch(() => route.path, () => backToTop.value?.focus())
 </script>
 
 <template>
diff --git a/src/client/theme-default/components/VPSocialLink.vue b/src/client/theme-default/components/VPSocialLink.vue
index 842e2c9a..cc19a5f3 100644
--- a/src/client/theme-default/components/VPSocialLink.vue
+++ b/src/client/theme-default/components/VPSocialLink.vue
@@ -1,6 +1,12 @@
 <script lang="ts" setup>
 import type { DefaultTheme } from 'vitepress/theme'
-import { computed, nextTick, onMounted, ref, useSSRContext } from 'vue'
+import {
+  computed,
+  nextTick,
+  onMounted,
+  useSSRContext,
+  useTemplateRef
+} from 'vue'
 
 import { isExternal, type SSGContext } from '../../shared'
 
@@ -12,7 +18,7 @@ const props = defineProps<{
   me: boolean
 }>()
 
-const el = ref<HTMLAnchorElement>()
+const el = useTemplateRef('el')
 
 onMounted(async () => {
   await nextTick()
diff --git a/src/client/theme-default/components/VPSponsorsGrid.vue b/src/client/theme-default/components/VPSponsorsGrid.vue
index 2f0b6071..0dc50a22 100644
--- a/src/client/theme-default/components/VPSponsorsGrid.vue
+++ b/src/client/theme-default/components/VPSponsorsGrid.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { ref } from 'vue'
+import { useTemplateRef } from 'vue'
 
 import type { GridSize } from '../composables/sponsor-grid'
 import { useSponsorsGrid } from '../composables/sponsor-grid'
@@ -17,7 +17,7 @@ const props = withDefaults(defineProps<Props>(), {
   size: 'medium'
 })
 
-const el = ref(null)
+const el = useTemplateRef('el')
 
 useSponsorsGrid({ el, size: props.size })
 </script>
diff --git a/src/client/theme-default/composables/flyout.ts b/src/client/theme-default/composables/flyout.ts
index 5f80e93f..1b0b5286 100644
--- a/src/client/theme-default/composables/flyout.ts
+++ b/src/client/theme-default/composables/flyout.ts
@@ -1,8 +1,8 @@
 import { inBrowser } from 'vitepress'
-import { onUnmounted, readonly, type Ref, ref, watch } from 'vue'
+import { onUnmounted, readonly, type TemplateRef, ref, watch } from 'vue'
 
 interface UseFlyoutOptions {
-  el: Ref<HTMLElement | undefined>
+  el: TemplateRef<HTMLElement>
   onFocus?(): void
   onBlur?(): void
 }
diff --git a/src/client/theme-default/composables/layout.ts b/src/client/theme-default/composables/layout.ts
index c69f8464..542bbc2a 100644
--- a/src/client/theme-default/composables/layout.ts
+++ b/src/client/theme-default/composables/layout.ts
@@ -1,6 +1,6 @@
 import { useMediaQuery } from '@vueuse/core'
 import { onContentUpdated, useRoute } from 'vitepress'
-import type { DefaultTheme, useLayout as expected } from 'vitepress/theme'
+import type { DefaultTheme } from 'vitepress/theme'
 import {
   computed,
   shallowReadonly,
@@ -20,7 +20,7 @@ const sidebar = shallowRef<DefaultTheme.SidebarItem[]>([])
 
 const isDesktop = useMediaQuery('(min-width: 60rem)')
 
-export function useLayout(): ReturnType<typeof expected> {
+export function useLayout(): DefaultTheme.Layout {
   const { frontmatter, theme } = useData()
 
   const isHome = computed(() => {
diff --git a/src/client/theme-default/composables/outline.ts b/src/client/theme-default/composables/outline.ts
index a963bb8f..14d4baef 100644
--- a/src/client/theme-default/composables/outline.ts
+++ b/src/client/theme-default/composables/outline.ts
@@ -1,6 +1,6 @@
 import { useMediaQuery } from '@vueuse/core'
 import type { DefaultTheme } from 'vitepress/theme'
-import { onMounted, onUnmounted, onUpdated, type Ref } from 'vue'
+import { onMounted, onUnmounted, onUpdated, type TemplateRef } from 'vue'
 
 import { throttleAndDebounce } from '../support/utils'
 
@@ -77,8 +77,8 @@ export function resolveHeaders(
 }
 
 export function useActiveAnchor(
-  container: Ref<HTMLElement>,
-  marker: Ref<HTMLElement>
+  container: TemplateRef<HTMLElement>,
+  marker: TemplateRef<HTMLElement>
 ): void {
   const isAsideVisible = useMediaQuery('(min-width: 80rem)')
 
@@ -90,7 +90,7 @@ export function useActiveAnchor(
   onMounted(() => {
     requestAnimationFrame(setActiveLink)
     window.addEventListener('scroll', onScroll)
-    container.value.addEventListener('click', onClick)
+    container.value?.addEventListener('click', onClick)
   })
 
   onUpdated(() => {
@@ -156,7 +156,7 @@ export function useActiveAnchor(
 
     // page bottom - highlight last link
     if (isBottom) {
-      activateLink(headers[headers.length - 1].link)
+      activateLink(headers.at(-1)?.link ?? null)
       return
     }
 
@@ -174,9 +174,9 @@ export function useActiveAnchor(
   function activateLink(hash: string | null) {
     const activeLink =
       hash != null
-        ? container.value.querySelector<HTMLAnchorElement>(
+        ? (container.value?.querySelector<HTMLAnchorElement>(
             `a[href$="${decodeURIComponent(hash)}"]`
-          )
+          ) ?? null)
         : null
 
     if (activeLink === prevActiveLink) return
@@ -186,16 +186,18 @@ export function useActiveAnchor(
 
     if (activeLink) {
       activeLink.classList.add('active')
-      // the links' offsetParent (.root) sits below the outline title while the
-      // marker is offset from .content, so re-align their origins
-      marker.value.style.top =
-        activeLink.offsetTop +
-        ((activeLink.offsetParent as HTMLElement)?.offsetTop ?? 0) +
-        (activeLink.offsetHeight - marker.value.offsetHeight) / 2 +
-        'px'
-      marker.value.style.opacity = '1'
+      if (marker.value) {
+        // the links' offsetParent (.root) sits below the outline title while
+        // the marker is offset from .content, so re-align their origins
+        marker.value.style.top =
+          activeLink.offsetTop +
+          ((activeLink.offsetParent as HTMLElement)?.offsetTop ?? 0) +
+          (activeLink.offsetHeight - marker.value.offsetHeight) / 2 +
+          'px'
+        marker.value.style.opacity = '1'
+      }
       activeLink.scrollIntoView({ block: 'nearest', behavior: 'smooth' })
-    } else {
+    } else if (marker.value) {
       marker.value.style.top = ''
       marker.value.style.opacity = '0'
     }
diff --git a/src/client/theme-default/composables/sponsor-grid.ts b/src/client/theme-default/composables/sponsor-grid.ts
index ab17aaeb..2ff70f6b 100644
--- a/src/client/theme-default/composables/sponsor-grid.ts
+++ b/src/client/theme-default/composables/sponsor-grid.ts
@@ -1,15 +1,15 @@
-import { type Ref, onMounted, onUnmounted } from 'vue'
+import { type TemplateRef, onMounted, onUnmounted } from 'vue'
 
 import { throttleAndDebounce } from '../support/utils'
 
-export interface GridSetting {
-  [size: string]: [number, number][]
+export type GridSetting = {
+  [size in GridSize]: [number, number][]
 }
 
 export type GridSize = 'xmini' | 'mini' | 'small' | 'medium' | 'big'
 
 export interface UseSponsorsGridOptions {
-  el: Ref<HTMLElement | null>
+  el: TemplateRef<HTMLElement>
   size?: GridSize
 }
 
@@ -63,7 +63,7 @@ export function useSponsorsGrid({
   })
 
   function manage() {
-    adjustSlots(el.value!, size)
+    if (el.value) adjustSlots(el.value, size)
   }
 }
 
diff --git a/src/client/theme-default/support/sidebar.ts b/src/client/theme-default/support/sidebar.ts
index d9ef00d2..1ae5b390 100644
--- a/src/client/theme-default/support/sidebar.ts
+++ b/src/client/theme-default/support/sidebar.ts
@@ -37,7 +37,7 @@ export function getSidebar(
       return path.startsWith(ensureStartingSlash(dir))
     })
 
-  const sidebar = dir ? _sidebar[dir] : []
+  const sidebar = dir ? (_sidebar[dir] ?? []) : []
   return Array.isArray(sidebar)
     ? addBase(sidebar)
     : addBase(sidebar.items, sidebar.base)
@@ -51,19 +51,20 @@ export function getSidebarGroups(sidebar: SidebarItem[]): SidebarItem[] {
 
   let lastGroupIndex: number = 0
 
-  for (const index in sidebar) {
-    const item = sidebar[index]
-
+  for (const item of sidebar) {
     if (item.items) {
       lastGroupIndex = groups.push(item)
       continue
     }
 
-    if (!groups[lastGroupIndex]) {
-      groups.push({ items: [] })
+    let group = groups[lastGroupIndex]
+
+    if (!group) {
+      group = { items: [] }
+      groups.push(group)
     }
 
-    groups[lastGroupIndex]!.items!.push(item)
+    group.items?.push(item)
   }
 
   return groups
diff --git a/src/client/theme-default/support/utils.ts b/src/client/theme-default/support/utils.ts
index 777cf314..76017be5 100644
--- a/src/client/theme-default/support/utils.ts
+++ b/src/client/theme-default/support/utils.ts
@@ -4,7 +4,7 @@ import { isExternal, treatAsHtml } from '../../shared'
 import { useData } from '../composables/data'
 
 export function throttleAndDebounce(fn: () => void, delay: number): () => void {
-  let timeoutId: NodeJS.Timeout
+  let timeoutId: number
   let called = false
 
   return () => {
@@ -12,8 +12,8 @@ export function throttleAndDebounce(fn: () => void, delay: number): () => void {
 
     if (!called) {
       fn()
-      ;(called = true) && setTimeout(() => (called = false), delay)
-    } else timeoutId = setTimeout(fn, delay)
+      ;(called = true) && window.setTimeout(() => (called = false), delay)
+    } else timeoutId = window.setTimeout(fn, delay)
   }
 }
 
diff --git a/src/client/tsconfig.json b/src/client/tsconfig.json
deleted file mode 100644
index f88ca8e9..00000000
--- a/src/client/tsconfig.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/client",
-    "declaration": true,
-    "declarationDir": "../../dist/client-types",
-    "types": ["../../client.d.ts", "@types/node"],
-    "paths": {
-      "vitepress": ["./index.ts"],
-      "vitepress/theme": ["../../theme.d.ts"]
-    }
-  },
-  "include": ["."]
-}
diff --git a/src/node/init/init.ts b/src/node/init/init.ts
index 60f9a4f0..dadce3fe 100644
--- a/src/node/init/init.ts
+++ b/src/node/init/init.ts
@@ -18,11 +18,14 @@ import c from 'picocolors'
 import { slash } from '../shared'
 import { readFile } from '../utils/fs'
 
-export enum ScaffoldThemeType {
-  Default = 'default theme',
-  DefaultCustom = 'default theme + customization',
-  Custom = 'custom theme'
-}
+export const ScaffoldThemeType = {
+  Default: 'default theme',
+  DefaultCustom: 'default theme + customization',
+  Custom: 'custom theme'
+} as const
+
+export type ScaffoldThemeType =
+  (typeof ScaffoldThemeType)[keyof typeof ScaffoldThemeType]
 
 export interface ScaffoldOptions {
   root?: string
diff --git a/src/node/markdownToVue.ts b/src/node/markdownToVue.ts
index f25e5b95..8586fb1b 100644
--- a/src/node/markdownToVue.ts
+++ b/src/node/markdownToVue.ts
@@ -122,7 +122,7 @@ export async function createMarkdownToVueRenderFn(
     const fileOrig = dynamicRoute?.[0] || file
     const transformPageData = [
       siteConfig?.transformPageData,
-      getPageDataTransformer(dynamicRoute?.[1]!)
+      getPageDataTransformer(dynamicRoute?.[1])
     ].filter((fn) => fn != null)
 
     file = rewrites.get(normalizeDriveLetter(file)) || file
diff --git a/src/node/plugins/dynamicRoutesPlugin.ts b/src/node/plugins/dynamicRoutesPlugin.ts
index 3349cb23..def6cc61 100644
--- a/src/node/plugins/dynamicRoutesPlugin.ts
+++ b/src/node/plugins/dynamicRoutesPlugin.ts
@@ -217,8 +217,9 @@ export const dynamicRoutesPlugin = async (
 }
 
 export function getPageDataTransformer(
-  loaderPath: string
+  loaderPath?: string
 ): UserConfig['transformPageData'] | undefined {
+  if (loaderPath == null) return undefined
   return routeModuleCache.get(loaderPath)?.transformPageData
 }
 
diff --git a/src/node/plugins/rewritesPlugin.ts b/src/node/plugins/rewritesPlugin.ts
index 16b313e0..23153244 100644
--- a/src/node/plugins/rewritesPlugin.ts
+++ b/src/node/plugins/rewritesPlugin.ts
@@ -61,7 +61,7 @@ export const rewritesPlugin = (config: SiteConfig): Plugin => {
           if (config.rewrites.inv[page]) {
             req.url = req.url.replace(
               encodeURI(page),
-              encodeURI(config.rewrites.inv[page]!)
+              encodeURI(config.rewrites.inv[page])
             )
           }
         }
diff --git a/src/node/tsconfig.json b/src/node/tsconfig.json
deleted file mode 100644
index f2ca0ef1..00000000
--- a/src/node/tsconfig.json
+++ /dev/null
@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/node",
-    "types": ["node"],
-    "sourceMap": true
-  },
-  "include": ["."]
-}
diff --git a/src/shared/shared.ts b/src/shared/shared.ts
index 2b50151b..c5f36a60 100644
--- a/src/shared/shared.ts
+++ b/src/shared/shared.ts
@@ -122,7 +122,7 @@ export function resolveSiteDataByRoute(
 ): SiteData {
   const localeIndex = getLocaleForPath(siteData, relativePath)
   const { label, link, markdown, ...localeConfig } =
-    siteData.locales[localeIndex] ?? {}
+    siteData.locales[localeIndex] ?? ({} as (typeof siteData.locales)[string])
   Object.assign(localeConfig, { localeIndex })
 
   // additional configs are colocated with sources, so resolve them by the
@@ -253,7 +253,7 @@ export function slash(p: string): string {
 export function treatAsHtml(filename: string): boolean {
   if (KNOWN_EXTENSIONS.size === 0) {
     const extraExts =
-      (typeof process === 'object' && process.env?.VITE_EXTRA_EXTENSIONS) ||
+      (globalThis as any).process?.env?.VITE_EXTRA_EXTENSIONS ||
       (import.meta as any).env?.VITE_EXTRA_EXTENSIONS ||
       ''
 
@@ -300,7 +300,7 @@ function resolveAdditionalConfig(
   if (typeof additionalConfig === 'function')
     return additionalConfig(path) ?? []
 
-  const configs: AdditionalConfig[] = []
+  const configs: (AdditionalConfig | undefined)[] = []
   const segments = path.split('/').slice(0, -1) // remove file name
 
   while (segments.length) {
diff --git a/src/shared/tsconfig.json b/src/shared/tsconfig.json
deleted file mode 100644
index 8d64877e..00000000
--- a/src/shared/tsconfig.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "lib": ["esnext", "dom", "dom.iterable"]
-  },
-  "include": ["."]
-}
diff --git a/theme.d.ts b/theme.d.ts
index ef7554d9..01a486da 100644
--- a/theme.d.ts
+++ b/theme.d.ts
@@ -1,7 +1,7 @@
 // so that users can do `import DefaultTheme from 'vitepress/theme'`
 
 import type { EnhanceAppContext } from 'vitepress'
-import type { ComputedRef, DefineComponent, ShallowRef } from 'vue'
+import type { DefineComponent } from 'vue'
 
 import type { DefaultTheme } from './types/default-theme.js'
 
@@ -14,48 +14,26 @@ declare const theme: {
 
 export default theme
 
-export declare const useLayout: () => {
-  isHome: ComputedRef<boolean>
-
-  sidebar: Readonly<ShallowRef<DefaultTheme.SidebarItem[]>>
-  sidebarGroups: ComputedRef<DefaultTheme.SidebarItem[]>
-  hasSidebar: ComputedRef<boolean>
-  isSidebarEnabled: ComputedRef<boolean>
-
-  hasAside: ComputedRef<boolean>
-  leftAside: ComputedRef<boolean>
-
-  /**
-   * The outline headers of the current page.
-   */
-  headers: Readonly<ShallowRef<DefaultTheme.OutlineItem[]>>
-  /**
-   * Whether the current page has a local nav. Local nav is shown when the
-   * "outline" is present in the page. However, note that the actual
-   * local nav visibility depends on the screen width as well.
-   */
-  hasLocalNav: ComputedRef<boolean>
-}
-
-// TODO: add props for these
-export declare const VPBadge: DefineComponent
-export declare const VPButton: DefineComponent
-export declare const VPDocAsideSponsors: DefineComponent
-export declare const VPFeatures: DefineComponent
-export declare const VPHomeContent: DefineComponent
-export declare const VPHomeFeatures: DefineComponent
-export declare const VPHomeHero: DefineComponent
-export declare const VPHomeSponsors: DefineComponent
-export declare const VPImage: DefineComponent
-export declare const VPLink: DefineComponent
-export declare const VPNavBarSearch: DefineComponent
-export declare const VPSocialLink: DefineComponent
-export declare const VPSocialLinks: DefineComponent
-export declare const VPSponsors: DefineComponent
-export declare const VPTeamMembers: DefineComponent
-export declare const VPTeamPage: DefineComponent
-export declare const VPTeamPageSection: DefineComponent
-export declare const VPTeamPageTitle: DefineComponent
+export declare const useLayout: () => DefaultTheme.Layout
+
+export declare const VPBadge: typeof import('./dist/client/theme-default/components/VPBadge.vue').default
+export declare const VPButton: typeof import('./dist/client/theme-default/components/VPButton.vue').default
+export declare const VPDocAsideSponsors: typeof import('./dist/client/theme-default/components/VPDocAsideSponsors.vue').default
+export declare const VPFeatures: typeof import('./dist/client/theme-default/components/VPFeatures.vue').default
+export declare const VPHomeContent: typeof import('./dist/client/theme-default/components/VPHomeContent.vue').default
+export declare const VPHomeFeatures: typeof import('./dist/client/theme-default/components/VPHomeFeatures.vue').default
+export declare const VPHomeHero: typeof import('./dist/client/theme-default/components/VPHomeHero.vue').default
+export declare const VPHomeSponsors: typeof import('./dist/client/theme-default/components/VPHomeSponsors.vue').default
+export declare const VPImage: typeof import('./dist/client/theme-default/components/VPImage.vue').default
+export declare const VPLink: typeof import('./dist/client/theme-default/components/VPLink.vue').default
+export declare const VPNavBarSearch: typeof import('./dist/client/theme-default/components/VPNavBarSearch.vue').default
+export declare const VPSocialLink: typeof import('./dist/client/theme-default/components/VPSocialLink.vue').default
+export declare const VPSocialLinks: typeof import('./dist/client/theme-default/components/VPSocialLinks.vue').default
+export declare const VPSponsors: typeof import('./dist/client/theme-default/components/VPSponsors.vue').default
+export declare const VPTeamMembers: typeof import('./dist/client/theme-default/components/VPTeamMembers.vue').default
+export declare const VPTeamPage: typeof import('./dist/client/theme-default/components/VPTeamPage.vue').default
+export declare const VPTeamPageSection: typeof import('./dist/client/theme-default/components/VPTeamPageSection.vue').default
+export declare const VPTeamPageTitle: typeof import('./dist/client/theme-default/components/VPTeamPageTitle.vue').default
 
 declare module 'vue' {
   interface GlobalComponents {
diff --git a/tsconfig.base.json b/tsconfig.base.json
new file mode 100644
index 00000000..d5ba0c4d
--- /dev/null
+++ b/tsconfig.base.json
@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "moduleDetection": "force",
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
+
+    "strict": true,
+    "noImplicitOverride": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+
+    "skipLibCheck": true
+  },
+  "exclude": [
+    "**/node_modules/**",
+    "**/dist/**",
+    "template",
+    "bin",
+    "docs/snippets"
+  ]
+}
diff --git a/tsconfig.client.json b/tsconfig.client.json
new file mode 100644
index 00000000..0e47095d
--- /dev/null
+++ b/tsconfig.client.json
@@ -0,0 +1,19 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "types": ["./client.d.ts"],
+    "noUncheckedIndexedAccess": true,
+    "paths": {
+      "vitepress": ["./src/client/index.ts"],
+      // default-theme.d.ts instead of theme.d.ts so type checks and the .vue
+      // declaration emit don't depend on a built dist.
+      "vitepress/theme": ["./types/default-theme.d.ts"],
+      // dev-server virtual modules, resolved onto their ambient shims
+      "@siteData": ["./src/client/shims.d.ts"],
+      "@theme/index": ["./src/client/shims.d.ts"],
+      "@localSearchIndex": ["./src/client/shims.d.ts"]
+    }
+  },
+  "include": ["src/client"]
+}
diff --git a/tsconfig.json b/tsconfig.json
index a0a5c69b..ffcbb947 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,22 +1,3 @@
 {
-  "compilerOptions": {
-    "module": "esnext",
-    "target": "esnext",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "noUnusedLocals": true,
-    "resolveJsonModule": true,
-    "verbatimModuleSyntax": true,
-    "jsx": "preserve",
-    "lib": ["esnext", "dom", "dom.iterable"]
-  },
-  "exclude": [
-    "**/node_modules/**",
-    "**/dist/**",
-    "template",
-    "bin",
-    "docs/snippets"
-  ]
+  "extends": "./tsconfig.base.json"
 }
diff --git a/tsconfig.node.json b/tsconfig.node.json
new file mode 100644
index 00000000..3de1cdef
--- /dev/null
+++ b/tsconfig.node.json
@@ -0,0 +1,8 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "lib": ["ES2023"],
+    "types": ["node"]
+  },
+  "include": ["src/node", "scripts", "tsdown.config.ts", "shared-globals.d.ts"]
+}
diff --git a/tsconfig.shared.json b/tsconfig.shared.json
new file mode 100644
index 00000000..0a9eb997
--- /dev/null
+++ b/tsconfig.shared.json
@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "lib": ["ES2023"],
+    "types": [],
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true
+  },
+  "include": ["src/shared", "shared-globals.d.ts"]
+}
diff --git a/tsdown.config.ts b/tsdown.config.ts
new file mode 100644
index 00000000..4494b557
--- /dev/null
+++ b/tsdown.config.ts
@@ -0,0 +1,241 @@
+import { readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import path from 'node:path'
+
+import { defineConfig, type Rolldown, type UserConfig } from 'tsdown'
+import { vueSfcPlugin } from 'vue-sfc-transformer/rolldown'
+
+const ROOT = import.meta.dirname
+
+// wipe all of dist (not just the outDirs) once per invocation; the configs
+// set `clean: false` so watch-mode rebuilds never clear it mid-session
+rmSync(path.join(ROOT, 'dist'), {
+  recursive: true,
+  force: true,
+  maxRetries: 10
+})
+
+const normalizePath = (p: string): string => {
+  const normalized = p.replaceAll('\\', '/')
+  return process.platform === 'win32' ? normalized.toLowerCase() : normalized
+}
+
+const TYPES_DIR = normalizePath(path.join(ROOT, 'types')) + '/'
+
+function isRootTypes(id: string, importer: string | undefined): boolean {
+  if (!importer || !/^\.\.?\//.test(id)) return false
+  const resolved = normalizePath(path.resolve(path.dirname(importer), id))
+  return resolved.startsWith(TYPES_DIR)
+}
+
+// keep .d.ts files under types/* external so module augmentations in the
+// output still target the same files users reference, spelled with the .js
+// extension so they resolve under node16 too
+function rootTypesSpecifiers(): Rolldown.Plugin {
+  return {
+    name: 'vitepress:root-types-specifiers',
+    resolveId: {
+      order: 'pre',
+      handler(id, importer) {
+        if (
+          importer &&
+          /\.d\.[cm]?ts$/.test(importer) &&
+          isRootTypes(id, importer)
+        ) {
+          return { id: id.replace(/\.js$/, '') + '.js', external: 'relative' }
+        }
+      }
+    }
+  }
+}
+
+// src/shared is compiled twice, once per environment, via gitignored copies.
+// Copies are written only when their content differs — they are watched
+// modules, so an unconditional write on every buildStart would retrigger the
+// watcher in an endless loop.
+function syncSharedFiles(
+  dest: 'client' | 'node',
+  track?: (file: string) => void
+): void {
+  const src = path.join(ROOT, 'src/shared')
+  for (const entry of readdirSync(src, {
+    recursive: true,
+    encoding: 'utf8'
+  })) {
+    if (!entry.endsWith('.ts')) continue
+    const file = path.join(src, entry)
+    track?.(file)
+    const content = readFileSync(file)
+    const copy = path.join(ROOT, 'src', dest, entry)
+    let stale = true
+    try {
+      stale = !content.equals(readFileSync(copy))
+    } catch {}
+    if (stale) writeFileSync(copy, content)
+  }
+}
+
+// seed the copies now, before the entry globs below are resolved
+syncSharedFiles('client')
+syncSharedFiles('node')
+
+// keeps the copies fresh across watch-mode rebuilds
+function syncShared(dest: 'client' | 'node'): Rolldown.Plugin {
+  return {
+    name: 'vitepress:sync-shared',
+    buildStart() {
+      syncSharedFiles(dest, (file) => this.addWatchFile(file))
+    }
+  }
+}
+
+// Ships styles and fonts as-is, keeps css imports as relative specifiers in
+// the output for the consumer's bundler, and drops them from declaration
+// files where they would dangle.
+function clientAssets(): Rolldown.Plugin {
+  const src = path.join(ROOT, 'src/client')
+  return {
+    name: 'vitepress:client-assets',
+    resolveId(id) {
+      if (id.endsWith('.css') && id[0] === '.') {
+        return { id, external: 'relative' }
+      }
+    },
+    buildStart() {
+      for (const entry of readdirSync(src, {
+        recursive: true,
+        encoding: 'utf8'
+      })) {
+        if (!/\.(css|woff2)$/.test(entry)) continue
+        const file = path.join(src, entry)
+        this.addWatchFile(file)
+        this.emitFile({
+          type: 'asset',
+          fileName: normalizePath(entry),
+          source: readFileSync(file)
+        })
+      }
+    }
+  }
+}
+
+// Declarations must resolve under node16, so relative specifiers need the .js
+// extension: vue-tsc keeps the SFC's extensionless ones in .d.vue.ts files,
+// and rolldown-plugin-dts drops the extension from chunk imports on Windows.
+// Dangling side-effect css imports are removed along the way.
+function fixDeclarationSpecifiers(): Rolldown.Plugin {
+  const stripCssImports = (code: string) =>
+    code.replace(/^\s*import\s+["'][^"']+\.css["'];?\s*\r?\n/gm, '')
+  const addJsExtensions = (code: string) =>
+    code.replace(
+      /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+)(['"])(\.\.?\/[^'"]*?)\2/g,
+      (match, keyword, quote, spec) =>
+        /\.[^/.]+$/.test(spec) ? match : `${keyword}${quote}${spec}.js${quote}`
+    )
+  const fix = (code: string) => addJsExtensions(stripCssImports(code))
+  return {
+    name: 'vitepress:fix-declaration-specifiers',
+    generateBundle(_options, bundle) {
+      for (const file of Object.values(bundle)) {
+        if (!/\.d\.(?:vue\.)?ts$/.test(file.fileName)) continue
+        if (file.type === 'chunk') file.code = fix(file.code)
+        else if (typeof file.source === 'string') file.source = fix(file.source)
+      }
+    }
+  }
+}
+
+// Rebuilds re-emit every output; dropping byte-identical files before they
+// are written keeps their mtimes stable, so watchers of dist (the docs dev
+// server's vite) only react to files that actually changed.
+function skipUnchanged(): Rolldown.Plugin {
+  return {
+    name: 'vitepress:skip-unchanged',
+    generateBundle: {
+      order: 'post',
+      handler(options, bundle) {
+        for (const [key, file] of Object.entries(bundle)) {
+          const next =
+            file.type === 'chunk'
+              ? Buffer.from(file.code)
+              : Buffer.from(file.source)
+          try {
+            const existing = readFileSync(
+              path.resolve(ROOT, options.dir ?? '.', file.fileName)
+            )
+            if (existing.equals(next)) delete bundle[key]
+          } catch {}
+        }
+      }
+    }
+  }
+}
+
+function withStableOutputs(config: UserConfig): UserConfig {
+  return {
+    ...config,
+    clean: false,
+    plugins: [
+      ...(config.plugins as Rolldown.Plugin[]),
+      fixDeclarationSpecifiers(),
+      skipUnchanged()
+    ]
+  }
+}
+
+const client: UserConfig = {
+  entry: ['src/client/**/*.ts', '!src/client/**/*.d.ts'],
+  outDir: 'dist/client',
+  platform: 'neutral',
+  unbundle: true,
+  fixedExtension: false,
+  dts: { vue: true },
+  tsconfig: 'tsconfig.client.json',
+  deps: {
+    // self-imports and dev-server virtual modules, resolved at site build time
+    neverBundle: [
+      /^vitepress(?:\/|$)/,
+      '@siteData',
+      '@theme/index',
+      '@localSearchIndex'
+    ]
+  },
+  plugins: [
+    syncShared('client'),
+    rootTypesSpecifiers(),
+    clientAssets(),
+    vueSfcPlugin({
+      srcDir: 'src/client',
+      cwd: ROOT,
+      tsconfig: './tsconfig.client.json'
+    })
+  ],
+  checks: { pluginTimings: false }
+}
+
+const node: UserConfig = {
+  entry: ['src/node/index.ts', 'src/node/cli.ts'],
+  outDir: 'dist/node',
+  platform: 'node',
+  target: 'node22',
+  fixedExtension: false,
+  dts: true,
+  tsconfig: 'tsconfig.node.json',
+  // polyfill broken browser check from bundled deps
+  define: {
+    'navigator.userAgentData': 'undefined',
+    'navigator.userAgent': 'undefined'
+  },
+  deps: {
+    // devDependencies are bundled by design
+    onlyBundle: false,
+    // markdown-it types are provided by @types/markdown-it (a runtime dep)
+    dts: { neverBundle: /^markdown-it(?:\/|$)/ }
+  },
+  // code-level compression only — no name mangling or whitespace removal
+  minify: { compress: true, mangle: false, codegen: false },
+  outputOptions: { chunkFileNames: 'chunk-[hash].js' },
+  checks: { eval: false, pluginTimings: false },
+  plugins: [syncShared('node'), rootTypesSpecifiers()]
+}
+
+export default defineConfig([client, node].map(withStableOutputs))
diff --git a/types/default-theme.d.ts b/types/default-theme.d.ts
index 24784d33..a8add01a 100644
--- a/types/default-theme.d.ts
+++ b/types/default-theme.d.ts
@@ -1,10 +1,37 @@
 import type { Options as _MiniSearchOptions } from 'minisearch'
+import type { ComputedRef, ShallowRef } from 'vue'
 
 import type { DocSearchProps } from './docsearch.js'
 import type { LocalSearchTranslations } from './local-search.js'
 import type { Header, PageData, Route, VitePressData } from './shared.js'
 
 export namespace DefaultTheme {
+  /**
+   * The layout state returned by `useLayout` from `vitepress/theme`.
+   */
+  export interface Layout {
+    isHome: ComputedRef<boolean>
+
+    sidebar: Readonly<ShallowRef<SidebarItem[]>>
+    sidebarGroups: ComputedRef<SidebarItem[]>
+    hasSidebar: ComputedRef<boolean>
+    isSidebarEnabled: ComputedRef<boolean>
+
+    hasAside: ComputedRef<boolean>
+    leftAside: ComputedRef<boolean>
+
+    /**
+     * The outline headers of the current page.
+     */
+    headers: Readonly<ShallowRef<OutlineItem[]>>
+    /**
+     * Whether the current page has a local nav. Local nav is shown when the
+     * "outline" is present in the page. However, note that the actual
+     * local nav visibility depends on the screen width as well.
+     */
+    hasLocalNav: ComputedRef<boolean>
+  }
+
   export interface Config {
     /**
      * The logo file of the site.

From 40380c308592cf0ffc5c83c2e69debc27b4cfa4a Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Mon, 24 Aug 2026 03:59:08 +0530
Subject: [PATCH 14/18] chore: dedupe rolldown

---
 pnpm-lock.yaml | 170 ++-----------------------------------------------
 1 file changed, 4 insertions(+), 166 deletions(-)

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 74b2c437..ea95f3b5 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -540,9 +540,6 @@ packages:
     resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
     engines: {node: '>= 8'}
 
-  '@oxc-project/types@0.143.0':
-    resolution: {integrity: sha512-u6JZdLBTLotrNC9Vd6vPssINdzcCzleKAH6EJKImQb7GtYvX5keN2dxkoK44stCc4tffE6QQRtZTXVSzsLUlWA==}
-
   '@oxc-project/types@0.146.0':
     resolution: {integrity: sha512-XC0QsnnhVe7sLIWmYmdPw7x5P0h4W8vUU3Nv1ySgWXtvCz8NizoAEpGXA0sOYoJQV2Rl13LgURAHQ5cI5ILCSA==}
 
@@ -566,73 +563,36 @@ packages:
     cpu: [arm]
     os: [android]
 
-  '@rolldown/binding-android-arm64@1.2.3':
-    resolution: {integrity: sha512-zrJtHDcaZJ1Fp7xf4hNl+7seH9Cn/N5TwLYkhgXREtBwAd/jaqW3uqeHxpDugJLVICWg4eW44kOQEGJ1r6jCGw==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [arm64]
-    os: [android]
-
   '@rolldown/binding-android-arm64@1.2.5':
     resolution: {integrity: sha512-zXcwKlQApYAOELHd8PwKDFkagYF9Wy4e0RJ+0qnzl9Pjnpj75TEG8ufv40p2J7kCEfwZAsNiuzRIyNNMWT38ig==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [android]
 
-  '@rolldown/binding-darwin-arm64@1.2.3':
-    resolution: {integrity: sha512-ieIiibVCp0tX7TLu2cafoNPv8wJyYi01ekXpbf8q2j7F4rGAhhXb/eQh7ge9DRBY78GwmRQtvjZDux7EDbA8kA==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [arm64]
-    os: [darwin]
-
   '@rolldown/binding-darwin-arm64@1.2.5':
     resolution: {integrity: sha512-dK4QakI42nzWgJT5sm4y4y/O//D4OxM75/cH28RLV+nzIN9AY+YsbuUVrUTjlLjXR6vpyxFbSsbmNuJ6BP9sww==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [darwin]
 
-  '@rolldown/binding-darwin-x64@1.2.3':
-    resolution: {integrity: sha512-Zh9tCon19eDXJoihx0rqKhMUlMYqzwj3aPsSuHmI4RWZh62dWUL+DJN4C5YQya5TcQBJU/Fe8+rY0jhXTQITqA==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [x64]
-    os: [darwin]
-
   '@rolldown/binding-darwin-x64@1.2.5':
     resolution: {integrity: sha512-fqSALaUu1Wjd1nK2uW2kJDWdLCc8lx1IcY+MTY26Aurfdx19anlzhqXOgCFbBFQnlFDTn4TC1/7Nz4Bl2mLP3A==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [darwin]
 
-  '@rolldown/binding-freebsd-x64@1.2.3':
-    resolution: {integrity: sha512-nGbJWewA1wrXXZiQhjAT5rhibGfns5ZNkDVqxsO6zJ3f3YvpoDNNmGMSbbhLuXKjNScaBJVOAboztAWVespQMg==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [x64]
-    os: [freebsd]
-
   '@rolldown/binding-freebsd-x64@1.2.5':
     resolution: {integrity: sha512-/vCnNxlkxs9tKxNDcyWUePpJ/PgTzxIaVhoM5SmG8UV+GR/IcPam4VYxi7GIMo7PSDuNqlJqvprqii9NqqVCMw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [freebsd]
 
-  '@rolldown/binding-linux-arm-gnueabihf@1.2.3':
-    resolution: {integrity: sha512-QNniJr5Kml0kDEB98jiDOJjXNroxIIi0IXIbdYzY26Xt1pVbeP62+KnoIZLwirOymX/0jDk/2gI/bNUv7A7OIw==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [arm]
-    os: [linux]
-
   '@rolldown/binding-linux-arm-gnueabihf@1.2.5':
     resolution: {integrity: sha512-abk0NLA519LxRCszmbE0jYKuQ9YPocOXTiOXOo6Yr+YAT95VH+PtqYAjOJvGKt3viEd/x4qzabAlwd5bHOOARg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [linux]
 
-  '@rolldown/binding-linux-arm64-gnu@1.2.3':
-    resolution: {integrity: sha512-TkqEAcmmvH3I/q4114NB4RVt6241Dao48pF45uLcFGrwAaIn0iITgTAKP/dLjbN0R4buJjGb91+UHSoFmpgIWw==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [arm64]
-    os: [linux]
-    libc: [glibc]
-
   '@rolldown/binding-linux-arm64-gnu@1.2.5':
     resolution: {integrity: sha512-Y7eALiJ8lr0M2HH103Js+g7V34wf6snlpZLAsHI90uLhr3PVlNsbFVAXJC9d/V6BnPyKtpSwI+NcB/RLxsQxuA==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -640,13 +600,6 @@ packages:
     os: [linux]
     libc: [glibc]
 
-  '@rolldown/binding-linux-arm64-musl@1.2.3':
-    resolution: {integrity: sha512-NHqjnxpsndf4MPymxteFAWHHfkTL8HjWh1KB7z23ofZ6QO2euONuxDXjat69dKZRALnGypg8k8SsK8vZJoXv1Q==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [arm64]
-    os: [linux]
-    libc: [musl]
-
   '@rolldown/binding-linux-arm64-musl@1.2.5':
     resolution: {integrity: sha512-xMvZgnbZg4YVnR/AX2b3oOPDTFYJvUVaJg5FedA/LuvexAtXibZQej4cnTkw3rjsJ/ggUROB64TdtETiim+FYA==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -654,13 +607,6 @@ packages:
     os: [linux]
     libc: [musl]
 
-  '@rolldown/binding-linux-ppc64-gnu@1.2.3':
-    resolution: {integrity: sha512-6tbrbwfz5GB9DQ4Jwo6hy9v+vR31xZlvzZ6n5Xut6Hhx5PvrA9q/HsK8KMaYQp063iqZGXwNvZtYNLD7EM/x0w==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [ppc64]
-    os: [linux]
-    libc: [glibc]
-
   '@rolldown/binding-linux-ppc64-gnu@1.2.5':
     resolution: {integrity: sha512-GRjeqTUDHTo5GwntsLaAMcBahG3nlpjftXWZLN73HiYQlhwEowvarFgQnRnQZtIp4keXX7quXFbG38uPZBa2EA==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -668,13 +614,6 @@ packages:
     os: [linux]
     libc: [glibc]
 
-  '@rolldown/binding-linux-s390x-gnu@1.2.3':
-    resolution: {integrity: sha512-oyuXxXmoZHjXC917IAPFAAv4wWAa0cM9afk8nx1+9/jNNOX1uPf8yDA6p7G0RypOfw/X0PQt5IfoquY1um+zSg==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [s390x]
-    os: [linux]
-    libc: [glibc]
-
   '@rolldown/binding-linux-s390x-gnu@1.2.5':
     resolution: {integrity: sha512-vLNTR45F2Uwc8AufkNXPmB4VliaXs+FvcheEogIzOXzO4l+LzieXF5A/TWxLy5HtqpsRCHUfd0lPVrrdgXdLHQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -682,13 +621,6 @@ packages:
     os: [linux]
     libc: [glibc]
 
-  '@rolldown/binding-linux-x64-gnu@1.2.3':
-    resolution: {integrity: sha512-TytMwF2KVGqP2tgd0I1OY0PAv78dZRAYcF5ssDzjM34SUXCED3uXvSd5+lHoC0bTD6eEdFz7LdQNCO1y0oVk9w==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [x64]
-    os: [linux]
-    libc: [glibc]
-
   '@rolldown/binding-linux-x64-gnu@1.2.5':
     resolution: {integrity: sha512-Mgj59/HTuYeK9Gz2MA+mBWKnHsAgkBSec15ZMb1st3oIfFbX7gCjOae7GydHhzcyQi9Z/7M1QuN9bR3oFqF0jQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -696,13 +628,6 @@ packages:
     os: [linux]
     libc: [glibc]
 
-  '@rolldown/binding-linux-x64-musl@1.2.3':
-    resolution: {integrity: sha512-/E9m3qstrJFVPoULV25mVQblSNExY2+kBsYe4sy0Tn0yOOgJ8wZbZt3KnRbF/XeU2Gl1STKUQnDNTqhIE5MD4A==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [x64]
-    os: [linux]
-    libc: [musl]
-
   '@rolldown/binding-linux-x64-musl@1.2.5':
     resolution: {integrity: sha512-mY8AP0/ichsbhAxGnLa3d3+MwV0EfgrPND2bplI3Ym8T6R2pJ0N87bvrKVwNXmdy3jnr6eQBecdqx/HMknBmpA==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -710,36 +635,18 @@ packages:
     os: [linux]
     libc: [musl]
 
-  '@rolldown/binding-openharmony-arm64@1.2.3':
-    resolution: {integrity: sha512-Kr0OcsoQI816i6HOl3vFHpd1K0eZyh76zgfj4c1nTyaTsd5r2Mj1lwM4R90y/qaCfmTn9eHy0SKwi98eitRxug==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [arm64]
-    os: [openharmony]
-
   '@rolldown/binding-openharmony-arm64@1.2.5':
     resolution: {integrity: sha512-8SLssA2oweAxyRgDp789ACfRb/3P+zNRJpzZxSizxF9m8NUDQ4+3xjo8ttjhVGGw6Qxb70oZiEtIjaKikCO7Yw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [openharmony]
 
-  '@rolldown/binding-win32-arm64-msvc@1.2.3':
-    resolution: {integrity: sha512-hOtMwTqnME+/gJcH/PCZ0wn0zPUjiWOgkHpxbSJpfGKMezHltx1S7/k1SitzVa7Ww2cqrDDaFbZEhcJZO8o+Jw==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [arm64]
-    os: [win32]
-
   '@rolldown/binding-win32-arm64-msvc@1.2.5':
     resolution: {integrity: sha512-vGbruD5zquhoc8D9SViXgN2FBJtNdTyQ4DtG+SWiEGlJiAzoKcZ2xp+xuXCffhubVdt0NJlTZqkeRuERy7g8Cw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [win32]
 
-  '@rolldown/binding-win32-x64-msvc@1.2.3':
-    resolution: {integrity: sha512-ekcqMMkI2PlhYnfzQnB/cEdYUVVJViWvoUyLrbzgDoi3Snfc1mVBwdnc306ufA5ejy8JSPjT2RlW1nQSjW7efg==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    cpu: [x64]
-    os: [win32]
-
   '@rolldown/binding-win32-x64-msvc@1.2.5':
     resolution: {integrity: sha512-e/SXpgISz+IoqVcSSI0rx/d/he8zqLex+/rCWpnHpmVfmPIUjag9H6P7zotf0gJHwPUhQxZ/mF8tr6acebT9yw==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -2349,11 +2256,6 @@ packages:
       vue-tsc:
         optional: true
 
-  rolldown@1.2.3:
-    resolution: {integrity: sha512-rn9wpmxplLf7NLNyCk9FyWh3FM43DbY8jOzCdEPzH7uflhTftRbCEpqi6Ly2osgoU8OwObtmavMbWLaWy4LX7A==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    hasBin: true
-
   rolldown@1.2.5:
     resolution: {integrity: sha512-VD2IE5PUG4Oj8zz2VGykiYd5wbnjdIiSsNQb8Qu5B+noEp+A78mu2iVvpp27g8es14Tk9rofNs5Tku9iQCS4fA==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -3163,8 +3065,6 @@ snapshots:
       '@nodelib/fs.scandir': 2.1.5
       fastq: 1.20.1
 
-  '@oxc-project/types@0.143.0': {}
-
   '@oxc-project/types@0.146.0': {}
 
   '@polka/compression@1.0.0-next.28': {}
@@ -3182,87 +3082,45 @@ snapshots:
   '@rolldown/binding-android-arm-eabi@1.2.5':
     optional: true
 
-  '@rolldown/binding-android-arm64@1.2.3':
-    optional: true
-
   '@rolldown/binding-android-arm64@1.2.5':
     optional: true
 
-  '@rolldown/binding-darwin-arm64@1.2.3':
-    optional: true
-
   '@rolldown/binding-darwin-arm64@1.2.5':
     optional: true
 
-  '@rolldown/binding-darwin-x64@1.2.3':
-    optional: true
-
   '@rolldown/binding-darwin-x64@1.2.5':
     optional: true
 
-  '@rolldown/binding-freebsd-x64@1.2.3':
-    optional: true
-
   '@rolldown/binding-freebsd-x64@1.2.5':
     optional: true
 
-  '@rolldown/binding-linux-arm-gnueabihf@1.2.3':
-    optional: true
-
   '@rolldown/binding-linux-arm-gnueabihf@1.2.5':
     optional: true
 
-  '@rolldown/binding-linux-arm64-gnu@1.2.3':
-    optional: true
-
   '@rolldown/binding-linux-arm64-gnu@1.2.5':
     optional: true
 
-  '@rolldown/binding-linux-arm64-musl@1.2.3':
-    optional: true
-
   '@rolldown/binding-linux-arm64-musl@1.2.5':
     optional: true
 
-  '@rolldown/binding-linux-ppc64-gnu@1.2.3':
-    optional: true
-
   '@rolldown/binding-linux-ppc64-gnu@1.2.5':
     optional: true
 
-  '@rolldown/binding-linux-s390x-gnu@1.2.3':
-    optional: true
-
   '@rolldown/binding-linux-s390x-gnu@1.2.5':
     optional: true
 
-  '@rolldown/binding-linux-x64-gnu@1.2.3':
-    optional: true
-
   '@rolldown/binding-linux-x64-gnu@1.2.5':
     optional: true
 
-  '@rolldown/binding-linux-x64-musl@1.2.3':
-    optional: true
-
   '@rolldown/binding-linux-x64-musl@1.2.5':
     optional: true
 
-  '@rolldown/binding-openharmony-arm64@1.2.3':
-    optional: true
-
   '@rolldown/binding-openharmony-arm64@1.2.5':
     optional: true
 
-  '@rolldown/binding-win32-arm64-msvc@1.2.3':
-    optional: true
-
   '@rolldown/binding-win32-arm64-msvc@1.2.5':
     optional: true
 
-  '@rolldown/binding-win32-x64-msvc@1.2.3':
-    optional: true
-
   '@rolldown/binding-win32-x64-msvc@1.2.5':
     optional: true
 
@@ -4842,12 +4700,12 @@ snapshots:
 
   reusify@1.1.0: {}
 
-  rolldown-plugin-dts@0.27.14(@volar/typescript@2.4.28(typescript@6.0.3))(rolldown@1.2.3)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3)):
+  rolldown-plugin-dts@0.27.14(@volar/typescript@2.4.28(typescript@6.0.3))(rolldown@1.2.5)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3)):
     dependencies:
       dts-resolver: 3.0.0
       get-tsconfig: 5.0.0-beta.5
       obug: 2.1.4
-      rolldown: 1.2.3
+      rolldown: 1.2.5
       yuku-ast: 0.8.7
       yuku-codegen: 0.8.7
       yuku-parser: 0.8.7
@@ -4858,26 +4716,6 @@ snapshots:
     transitivePeerDependencies:
       - oxc-resolver
 
-  rolldown@1.2.3:
-    dependencies:
-      '@oxc-project/types': 0.143.0
-      '@rolldown/pluginutils': 1.0.1
-    optionalDependencies:
-      '@rolldown/binding-android-arm64': 1.2.3
-      '@rolldown/binding-darwin-arm64': 1.2.3
-      '@rolldown/binding-darwin-x64': 1.2.3
-      '@rolldown/binding-freebsd-x64': 1.2.3
-      '@rolldown/binding-linux-arm-gnueabihf': 1.2.3
-      '@rolldown/binding-linux-arm64-gnu': 1.2.3
-      '@rolldown/binding-linux-arm64-musl': 1.2.3
-      '@rolldown/binding-linux-ppc64-gnu': 1.2.3
-      '@rolldown/binding-linux-s390x-gnu': 1.2.3
-      '@rolldown/binding-linux-x64-gnu': 1.2.3
-      '@rolldown/binding-linux-x64-musl': 1.2.3
-      '@rolldown/binding-openharmony-arm64': 1.2.3
-      '@rolldown/binding-win32-arm64-msvc': 1.2.3
-      '@rolldown/binding-win32-x64-msvc': 1.2.3
-
   rolldown@1.2.5:
     dependencies:
       '@oxc-project/types': 0.146.0
@@ -5110,8 +4948,8 @@ snapshots:
       import-without-cache: 0.4.0
       obug: 2.1.4
       picomatch: 4.0.5
-      rolldown: 1.2.3
-      rolldown-plugin-dts: 0.27.14(@volar/typescript@2.4.28(typescript@6.0.3))(rolldown@1.2.3)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3))
+      rolldown: 1.2.5
+      rolldown-plugin-dts: 0.27.14(@volar/typescript@2.4.28(typescript@6.0.3))(rolldown@1.2.5)(typescript@6.0.3)(vue-tsc@3.3.11(typescript@6.0.3))
       tinyexec: 1.3.0
       tinyglobby: 0.2.17
       tree-kill: 1.2.2

From 0f0fe135762489f1a6c73348bd8b0a86db969248 Mon Sep 17 00:00:00 2001
From: yiheng-kkk <lij921093@gmail.com>
Date: Mon, 24 Aug 2026 19:45:14 +0800
Subject: [PATCH 15/18] fix(theme): mark current navigation links (#5395)

Co-authored-by: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
---
 __tests__/e2e/.vitepress/config.ts            | 22 +++++
 __tests__/e2e/multi-sidebar/index.test.ts     |  3 +-
 __tests__/e2e/navigation.test.ts              | 88 +++++++++++++++++++
 __tests__/e2e/sidebar-hash/index.md           | 11 +++
 .../theme-default/components/VPMenuLink.vue   | 22 +----
 .../components/VPNavBarMenuLink.vue           | 22 +----
 .../components/VPNavScreenMenuGroupLink.vue   | 24 +----
 .../components/VPNavScreenMenuLink.vue        | 24 +----
 .../components/VPSidebarItem.vue              |  2 +
 src/client/theme-default/composables/nav.ts   | 41 ++++++++-
 .../theme-default/composables/sidebar.ts      | 10 +++
 11 files changed, 189 insertions(+), 80 deletions(-)
 create mode 100644 __tests__/e2e/navigation.test.ts
 create mode 100644 __tests__/e2e/sidebar-hash/index.md

diff --git a/__tests__/e2e/.vitepress/config.ts b/__tests__/e2e/.vitepress/config.ts
index cafcfd50..acd74892 100644
--- a/__tests__/e2e/.vitepress/config.ts
+++ b/__tests__/e2e/.vitepress/config.ts
@@ -65,6 +65,11 @@ const nav: DefaultTheme.Config['nav'] = [
         ]
       }
     ]
+  },
+  {
+    text: 'Active Match',
+    link: '/markdown-extensions/',
+    activeMatch: '^/home'
   }
 ]
 
@@ -153,6 +158,23 @@ const sidebar: DefaultTheme.Config['sidebar'] = {
           link: '/team-and-sponsors/home-no-markdown-styles'
         }
       ]
+    },
+    {
+      text: 'Sidebar Hash',
+      items: [
+        {
+          text: 'Overview',
+          link: '/sidebar-hash/'
+        },
+        {
+          text: 'Section One',
+          link: '/sidebar-hash/#section-one'
+        },
+        {
+          text: 'Section Two',
+          link: '/sidebar-hash/#section-two'
+        }
+      ]
     }
   ],
   '/multi-sidebar/': [
diff --git a/__tests__/e2e/multi-sidebar/index.test.ts b/__tests__/e2e/multi-sidebar/index.test.ts
index cd654301..9f7d4a4c 100644
--- a/__tests__/e2e/multi-sidebar/index.test.ts
+++ b/__tests__/e2e/multi-sidebar/index.test.ts
@@ -16,7 +16,8 @@ describe('test multi sidebar sort root', () => {
       'Multi Sidebar Test',
       'Dynamic Routes',
       'Markdown Extensions',
-      'Team & Sponsors'
+      'Team & Sponsors',
+      'Sidebar Hash'
     ])
   })
 })
diff --git a/__tests__/e2e/navigation.test.ts b/__tests__/e2e/navigation.test.ts
new file mode 100644
index 00000000..cece272a
--- /dev/null
+++ b/__tests__/e2e/navigation.test.ts
@@ -0,0 +1,88 @@
+const ariaCurrent = (selector: string) =>
+  page.locator(selector).getAttribute('aria-current')
+
+describe('navigation accessibility', () => {
+  beforeEach(async () => {
+    await page.setViewportSize({ width: 1280, height: 720 })
+  })
+
+  test('marks direct nav links to the current page', async () => {
+    await goto('/')
+
+    expect(await ariaCurrent('.VPNavBarMenuLink[href="/"]')).toBe('page')
+
+    await page.setViewportSize({ width: 375, height: 667 })
+    await page.locator('.VPNavBarHamburger').click()
+
+    expect(await ariaCurrent('.VPNavScreenMenuLink[href="/"]')).toBe('page')
+  })
+
+  test('marks nested nav links to the current page', async () => {
+    await goto('/home')
+
+    expect(await ariaCurrent('.VPMenuLink a[href="/home.html"]')).toBe('page')
+    expect(await ariaCurrent('.VPNavBarMenuLink[href="/"]')).toBeNull()
+
+    await page.setViewportSize({ width: 375, height: 667 })
+    await page.locator('.VPNavBarHamburger').click()
+
+    expect(
+      await ariaCurrent('.VPNavScreenMenuGroupLink[href="/home.html"]')
+    ).toBe('page')
+  })
+
+  test('does not mark broad activeMatch links as current', async () => {
+    await goto('/home')
+
+    const sectionLink = page.locator(
+      '.VPNavBarMenuLink[href="/markdown-extensions/"]'
+    )
+
+    expect(await sectionLink.getAttribute('class')).toContain('active')
+    expect(await sectionLink.getAttribute('aria-current')).toBeNull()
+  })
+
+  test('marks only exact sidebar links, including fragments', async () => {
+    const overview = '.VPSidebarItem .link[href="/sidebar-hash/"]'
+    const sectionOne = '.VPSidebarItem .link[href="/sidebar-hash/#section-one"]'
+    const sectionTwo = '.VPSidebarItem .link[href="/sidebar-hash/#section-two"]'
+
+    await goto('/sidebar-hash/')
+
+    // wait for hydration to replace the hash-agnostic server-rendered state
+    await page.waitForFunction(
+      () => document.querySelectorAll('.VPSidebarItem.is-active').length === 1
+    )
+
+    expect(await ariaCurrent(overview)).toBe('page')
+    expect(await ariaCurrent(sectionOne)).toBeNull()
+    expect(await ariaCurrent(sectionTwo)).toBeNull()
+
+    await page.locator(sectionTwo).click()
+    await page.waitForSelector(`${sectionTwo}[aria-current="page"]`)
+    expect(await ariaCurrent(sectionOne)).toBeNull()
+
+    await page.locator(sectionOne).click()
+    await page.waitForSelector(`${sectionOne}[aria-current="page"]`)
+    expect(await ariaCurrent(sectionTwo)).toBeNull()
+  })
+
+  test.runIf(process.env.VITE_TEST_BUILD)(
+    'omits aria-current for fragment links in server-rendered HTML',
+    async () => {
+      const response = await page.request.get(
+        `http://localhost:${process.env['PORT']}/sidebar-hash/`
+      )
+      const anchors = (
+        (await response.text()).match(/<a\b[^>]*>/g) ?? []
+      ).filter((anchor) => anchor.includes('/sidebar-hash/'))
+
+      expect(
+        anchors.filter((anchor) => anchor.includes('#section-')).length
+      ).toBeGreaterThanOrEqual(2)
+      expect(
+        anchors.filter((anchor) => anchor.includes('aria-current'))
+      ).toEqual([expect.stringContaining('href="/sidebar-hash/"')])
+    }
+  )
+})
diff --git a/__tests__/e2e/sidebar-hash/index.md b/__tests__/e2e/sidebar-hash/index.md
new file mode 100644
index 00000000..4b3aad17
--- /dev/null
+++ b/__tests__/e2e/sidebar-hash/index.md
@@ -0,0 +1,11 @@
+# Sidebar Hash
+
+A page whose sidebar entries point at fragments of the same page.
+
+## Section One
+
+Content for the first section.
+
+## Section Two
+
+Content for the second section.
diff --git a/src/client/theme-default/components/VPMenuLink.vue b/src/client/theme-default/components/VPMenuLink.vue
index 89129dd6..45912479 100644
--- a/src/client/theme-default/components/VPMenuLink.vue
+++ b/src/client/theme-default/components/VPMenuLink.vue
@@ -1,9 +1,7 @@
 <script lang="ts" setup generic="T extends DefaultTheme.NavItemWithLink">
-import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { computed } from 'vue'
 
-import { isActive } from '../../shared'
+import { useNavItemLink } from '../composables/nav'
 import VPLink from './VPLink.vue'
 
 const props = defineProps<{
@@ -11,22 +9,7 @@ const props = defineProps<{
   rel?: string
 }>()
 
-const route = useRoute()
-
-const href = computed(() =>
-  typeof props.item.link === 'function'
-    ? props.item.link(route.data)
-    : props.item.link
-)
-
-const isActiveLink = computed(() => {
-  return isActive(
-    route.data.relativePath,
-    route.hash,
-    props.item.activeMatch || href.value,
-    !!props.item.activeMatch
-  )
-})
+const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
 
 defineOptions({ inheritAttrs: false })
 </script>
@@ -36,6 +19,7 @@ defineOptions({ inheritAttrs: false })
     <VPLink
       v-bind="$attrs"
       :class="{ active: isActiveLink }"
+      :aria-current="isCurrentLink ? 'page' : undefined"
       :href
       :target="item.target"
       :rel="props.rel ?? item.rel"
diff --git a/src/client/theme-default/components/VPNavBarMenuLink.vue b/src/client/theme-default/components/VPNavBarMenuLink.vue
index b5617da8..451359c1 100644
--- a/src/client/theme-default/components/VPNavBarMenuLink.vue
+++ b/src/client/theme-default/components/VPNavBarMenuLink.vue
@@ -1,36 +1,20 @@
 <script lang="ts" setup>
-import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { computed } from 'vue'
 
-import { isActive } from '../../shared'
+import { useNavItemLink } from '../composables/nav'
 import VPLink from './VPLink.vue'
 
 const props = defineProps<{
   item: DefaultTheme.NavItemWithLink
 }>()
 
-const route = useRoute()
-
-const href = computed(() =>
-  typeof props.item.link === 'function'
-    ? props.item.link(route.data)
-    : props.item.link
-)
-
-const isActiveLink = computed(() => {
-  return isActive(
-    route.data.relativePath,
-    route.hash,
-    props.item.activeMatch || href.value,
-    !!props.item.activeMatch
-  )
-})
+const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
 </script>
 
 <template>
   <VPLink
     :class="{ VPNavBarMenuLink: true, active: isActiveLink }"
+    :aria-current="isCurrentLink ? 'page' : undefined"
     :href
     :target="item.target"
     :rel="item.rel"
diff --git a/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue b/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
index c2364a0d..351b7328 100644
--- a/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
+++ b/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
@@ -1,32 +1,15 @@
 <script lang="ts" setup>
-import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { computed, inject } from 'vue'
+import { inject } from 'vue'
 
-import { isActive } from '../../shared'
-import { navInjectionKey } from '../composables/nav'
+import { navInjectionKey, useNavItemLink } from '../composables/nav'
 import VPLink from './VPLink.vue'
 
 const props = defineProps<{
   item: DefaultTheme.NavItemWithLink
 }>()
 
-const route = useRoute()
-
-const href = computed(() =>
-  typeof props.item.link === 'function'
-    ? props.item.link(route.data)
-    : props.item.link
-)
-
-const isActiveLink = computed(() => {
-  return isActive(
-    route.data.relativePath,
-    route.hash,
-    props.item.activeMatch || href.value,
-    !!props.item.activeMatch
-  )
-})
+const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
 
 const { closeScreen } = inject(navInjectionKey)!
 </script>
@@ -34,6 +17,7 @@ const { closeScreen } = inject(navInjectionKey)!
 <template>
   <VPLink
     :class="{ VPNavScreenMenuGroupLink: true, active: isActiveLink }"
+    :aria-current="isCurrentLink ? 'page' : undefined"
     :href
     :target="item.target"
     :rel="item.rel"
diff --git a/src/client/theme-default/components/VPNavScreenMenuLink.vue b/src/client/theme-default/components/VPNavScreenMenuLink.vue
index b9bedefe..647eaef1 100644
--- a/src/client/theme-default/components/VPNavScreenMenuLink.vue
+++ b/src/client/theme-default/components/VPNavScreenMenuLink.vue
@@ -1,32 +1,15 @@
 <script lang="ts" setup>
-import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { computed, inject } from 'vue'
+import { inject } from 'vue'
 
-import { isActive } from '../../shared'
-import { navInjectionKey } from '../composables/nav'
+import { navInjectionKey, useNavItemLink } from '../composables/nav'
 import VPLink from './VPLink.vue'
 
 const props = defineProps<{
   item: DefaultTheme.NavItemWithLink
 }>()
 
-const route = useRoute()
-
-const href = computed(() =>
-  typeof props.item.link === 'function'
-    ? props.item.link(route.data)
-    : props.item.link
-)
-
-const isActiveLink = computed(() => {
-  return isActive(
-    route.data.relativePath,
-    route.hash,
-    props.item.activeMatch || href.value,
-    !!props.item.activeMatch
-  )
-})
+const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
 
 const { closeScreen } = inject(navInjectionKey)!
 </script>
@@ -34,6 +17,7 @@ const { closeScreen } = inject(navInjectionKey)!
 <template>
   <VPLink
     :class="{ VPNavScreenMenuLink: true, active: isActiveLink }"
+    :aria-current="isCurrentLink ? 'page' : undefined"
     :href
     :target="item.target"
     :rel="item.rel"
diff --git a/src/client/theme-default/components/VPSidebarItem.vue b/src/client/theme-default/components/VPSidebarItem.vue
index 23454817..75f85310 100644
--- a/src/client/theme-default/components/VPSidebarItem.vue
+++ b/src/client/theme-default/components/VPSidebarItem.vue
@@ -15,6 +15,7 @@ const {
   collapsible,
   isLink,
   isActiveLink,
+  isCurrentLink,
   hasActiveLink,
   hasChildren,
   toggle
@@ -54,6 +55,7 @@ function onItemClick() {
         v-if="item.link"
         :tag="linkTag"
         class="link"
+        :aria-current="isCurrentLink ? 'page' : undefined"
         :href="item.link"
         :rel="item.rel"
         :target="item.target"
diff --git a/src/client/theme-default/composables/nav.ts b/src/client/theme-default/composables/nav.ts
index 5938a49f..e7341ed6 100644
--- a/src/client/theme-default/composables/nav.ts
+++ b/src/client/theme-default/composables/nav.ts
@@ -1,6 +1,16 @@
 import { useMediaQuery, whenever } from '@vueuse/core'
 import { useRoute } from 'vitepress'
-import { ref, watch, type InjectionKey } from 'vue'
+import type { DefaultTheme } from 'vitepress/theme'
+import {
+  computed,
+  ref,
+  toValue,
+  watch,
+  type InjectionKey,
+  type MaybeRefOrGetter
+} from 'vue'
+
+import { isActive } from '../../shared'
 
 export function useNav() {
   const isScreenOpen = ref(false)
@@ -32,6 +42,35 @@ export function useNav() {
   }
 }
 
+export function useNavItemLink(
+  item: MaybeRefOrGetter<DefaultTheme.NavItemWithLink>
+) {
+  const route = useRoute()
+
+  const href = computed(() => {
+    const { link } = toValue(item)
+    return typeof link === 'function' ? link(route.data) : link
+  })
+
+  const isActiveLink = computed(() => {
+    const { activeMatch } = toValue(item)
+    return isActive(
+      route.data.relativePath,
+      route.hash,
+      activeMatch || href.value,
+      !!activeMatch
+    )
+  })
+
+  // exact match only — a broad activeMatch keeps the visual active state
+  // without claiming aria-current
+  const isCurrentLink = computed(() => {
+    return isActive(route.data.relativePath, route.hash, href.value)
+  })
+
+  return { href, isActiveLink, isCurrentLink }
+}
+
 export interface NavExposedMethods {
   closeScreen: () => void
 }
diff --git a/src/client/theme-default/composables/sidebar.ts b/src/client/theme-default/composables/sidebar.ts
index e6eec014..684bda6f 100644
--- a/src/client/theme-default/composables/sidebar.ts
+++ b/src/client/theme-default/composables/sidebar.ts
@@ -124,6 +124,15 @@ export function useSidebarItemControl(
   watch([item, route], () => updateActiveLink())
   onMounted(() => updateActiveLink())
 
+  // exact match only, unlike isActiveLink which skips the hash check before
+  // mount — links that differ only in hash must not claim aria-current in
+  // SSR output
+  const isCurrentLink = computed(() => {
+    return item.value.link
+      ? isActive(route.data.relativePath, route.hash, item.value.link)
+      : false
+  })
+
   const hasChildren = computed(() => {
     return !!(item.value.items && item.value.items.length)
   })
@@ -143,6 +152,7 @@ export function useSidebarItemControl(
     collapsible,
     isLink,
     isActiveLink: isActiveLink as ComputedRef<boolean>,
+    isCurrentLink,
     hasActiveLink: hasActiveLink as ComputedRef<boolean>,
     hasChildren,
     toggle

From 26b76d6d9e8fd3ae368c7a1e8ad6698cdeb73e7a Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Tue, 25 Aug 2026 02:34:56 +0530
Subject: [PATCH 16/18] feat(theme): redesign the navbar (#5397)

Co-authored-by: bluwy <34116392+bluwy@users.noreply.github.com>
Co-authored-by: xbsheng <56357338+xbsheng@users.noreply.github.com>
Co-authored-by: fvsch <243601+fvsch@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
---
 .../theme/components/ApiPreference.vue        |  29 +-
 .../theme/components/NavVersion.vue           |  15 +-
 __tests__/e2e/navigation.test.ts              | 151 +++++++++
 .../composables/nav-overflow.test.ts          | 135 ++++++++
 docs/en/guide/extending-default-theme.md      |  40 +++
 docs/en/reference/default-theme-config.md     |  21 ++
 docs/en/reference/default-theme-nav.md        |   1 +
 package.json                                  |   2 +-
 src/client/theme-default/Layout.vue           |  15 +-
 .../theme-default/components/VPFlyout.vue     | 101 ++++--
 .../theme-default/components/VPLocalNav.vue   |  39 ++-
 .../components/VPLocalNavOutlineDropdown.vue  |  18 +-
 .../theme-default/components/VPMenu.vue       |  13 +-
 .../theme-default/components/VPMenuGroup.vue  |  56 +++-
 .../theme-default/components/VPMenuLink.vue   |  45 ++-
 src/client/theme-default/components/VPNav.vue |   1 -
 .../components/VPNavAppearance.vue            |  92 ++++++
 .../theme-default/components/VPNavBar.vue     | 239 ++++++++------
 .../components/VPNavBarAppearance.vue         |  32 --
 .../components/VPNavBarExtra.vue              | 119 ++++---
 .../components/VPNavBarHamburger.vue          |  21 +-
 .../theme-default/components/VPNavBarMenu.vue |  46 ---
 .../components/VPNavBarMenuGroup.vue          |  54 ----
 .../components/VPNavBarMenuLink.vue           |  47 ---
 .../components/VPNavBarSearch.vue             |   1 -
 .../components/VPNavBarSocialLinks.vue        |  27 --
 .../components/VPNavBarTitle.vue              |  24 +-
 .../components/VPNavBarTranslations.vue       |  57 ----
 .../theme-default/components/VPNavMenu.vue    |  79 +++++
 .../components/VPNavMenuGroup.vue             | 150 +++++++++
 ...avScreenMenuLink.vue => VPNavMenuLink.vue} |  45 ++-
 .../theme-default/components/VPNavScreen.vue  |  32 +-
 .../components/VPNavScreenAppearance.vue      |  40 ---
 .../components/VPNavScreenMenu.vue            |  28 --
 .../components/VPNavScreenMenuGroup.vue       | 113 -------
 .../components/VPNavScreenMenuGroupLink.vue   |  49 ---
 .../VPNavScreenMenuGroupSection.vue           |  35 --
 .../components/VPNavScreenSocialLinks.vue     |  14 -
 .../components/VPNavScreenTranslations.vue    |  87 -----
 .../components/VPNavSocialLinks.vue           |  43 +++
 .../components/VPNavTranslations.vue          | 179 +++++++++++
 .../components/VPSidebarItem.vue              |  24 +-
 .../theme-default/components/VPSkipLink.vue   |   7 +-
 .../theme-default/components/VPSwitch.vue     |   6 +-
 .../components/VPSwitchAppearance.vue         |   6 +-
 .../components/VPTeamMembers.vue              |   5 +-
 .../theme-default/composables/flyout.ts       |   1 +
 .../theme-default/composables/nav-overflow.ts | 299 ++++++++++++++++++
 src/client/theme-default/composables/nav.ts   |  68 +++-
 src/client/theme-default/styles/vars.css      |  21 +-
 types/default-theme.d.ts                      |  23 ++
 51 files changed, 1851 insertions(+), 944 deletions(-)
 create mode 100644 __tests__/unit/client/theme-default/composables/nav-overflow.test.ts
 create mode 100644 src/client/theme-default/components/VPNavAppearance.vue
 delete mode 100644 src/client/theme-default/components/VPNavBarAppearance.vue
 delete mode 100644 src/client/theme-default/components/VPNavBarMenu.vue
 delete mode 100644 src/client/theme-default/components/VPNavBarMenuGroup.vue
 delete mode 100644 src/client/theme-default/components/VPNavBarMenuLink.vue
 delete mode 100644 src/client/theme-default/components/VPNavBarSocialLinks.vue
 delete mode 100644 src/client/theme-default/components/VPNavBarTranslations.vue
 create mode 100644 src/client/theme-default/components/VPNavMenu.vue
 create mode 100644 src/client/theme-default/components/VPNavMenuGroup.vue
 rename src/client/theme-default/components/{VPNavScreenMenuLink.vue => VPNavMenuLink.vue} (64%)
 delete mode 100644 src/client/theme-default/components/VPNavScreenAppearance.vue
 delete mode 100644 src/client/theme-default/components/VPNavScreenMenu.vue
 delete mode 100644 src/client/theme-default/components/VPNavScreenMenuGroup.vue
 delete mode 100644 src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
 delete mode 100644 src/client/theme-default/components/VPNavScreenMenuGroupSection.vue
 delete mode 100644 src/client/theme-default/components/VPNavScreenSocialLinks.vue
 delete mode 100644 src/client/theme-default/components/VPNavScreenTranslations.vue
 create mode 100644 src/client/theme-default/components/VPNavSocialLinks.vue
 create mode 100644 src/client/theme-default/components/VPNavTranslations.vue
 create mode 100644 src/client/theme-default/composables/nav-overflow.ts

diff --git a/__tests__/e2e/.vitepress/theme/components/ApiPreference.vue b/__tests__/e2e/.vitepress/theme/components/ApiPreference.vue
index c286640b..0dfe61c8 100644
--- a/__tests__/e2e/.vitepress/theme/components/ApiPreference.vue
+++ b/__tests__/e2e/.vitepress/theme/components/ApiPreference.vue
@@ -5,12 +5,13 @@ const props = defineProps<{
   options: string[]
   defaultOption: string
   screenMenu?: boolean
+  menu?: boolean
 }>()
 
 // reactivity isn't needed for props here
 
 const key = removeSpaces(`api-preference-${props.options.join('-')}`)
-const name = key + (props.screenMenu ? '-screen-menu' : '')
+const name = key + (props.screenMenu ? '-screen-menu' : props.menu ? '-menu' : '')
 
 const selected = useLocalStorage(key, () => props.defaultOption)
 
@@ -25,8 +26,11 @@ function removeSpaces(str: string) {
 </script>
 
 <template>
-  <div class="VPApiPreference" :class="{ 'screen-menu': screenMenu }">
-    <template v-for="option in optionsWithKeys" :key="option">
+  <div
+    class="VPApiPreference"
+    :class="{ 'screen-menu': screenMenu, 'in-menu': menu }"
+  >
+    <template v-for="option in optionsWithKeys" :key="option.key">
       <input
         type="radio"
         :id="option.key"
@@ -42,10 +46,10 @@ function removeSpaces(str: string) {
 <style scoped>
 .VPApiPreference {
   display: flex;
-  margin: 12px 0;
+  margin: 0.75rem 0;
   border: 1px solid var(--vp-c-border);
-  border-radius: 6px;
-  font-size: 14px;
+  border-radius: 0.375rem;
+  font-size: 0.875rem;
   color: var(--vp-c-text-1);
 }
 
@@ -57,8 +61,13 @@ function removeSpaces(str: string) {
   margin-bottom: 0;
 }
 
+.VPApiPreference.in-menu {
+  margin: 0.5rem 0.75rem;
+}
+
 .VPApiPreference.screen-menu {
-  margin: 12px 0 0 12px;
+  margin: 0.75rem 0 0 0.75rem;
+  font-size: 1rem;
 }
 
 .VPApiPreference input[type='radio'] {
@@ -69,10 +78,10 @@ function removeSpaces(str: string) {
 
 .VPApiPreference label {
   flex: 1;
-  margin: 2px;
-  padding: 4px 12px;
+  margin: 0.125rem;
+  padding: 0.25rem 0.75rem;
   cursor: pointer;
-  border-radius: 4px;
+  border-radius: 0.25rem;
   text-align: center;
 }
 
diff --git a/__tests__/e2e/.vitepress/theme/components/NavVersion.vue b/__tests__/e2e/.vitepress/theme/components/NavVersion.vue
index dc3b9180..00d554fc 100644
--- a/__tests__/e2e/.vitepress/theme/components/NavVersion.vue
+++ b/__tests__/e2e/.vitepress/theme/components/NavVersion.vue
@@ -1,12 +1,12 @@
 <script setup lang="ts">
 import { useRoute } from 'vitepress'
-import VPNavBarMenuGroup from 'vitepress/dist/client/theme-default/components/VPNavBarMenuGroup.vue'
-import VPNavScreenMenuGroup from 'vitepress/dist/client/theme-default/components/VPNavScreenMenuGroup.vue'
+import VPNavMenuGroup from 'vitepress/dist/client/theme-default/components/VPNavMenuGroup.vue'
 import { computed } from 'vue'
 
 const props = defineProps<{
   versions: { text: string; link: string }[]
   screenMenu?: boolean
+  menu?: boolean
 }>()
 
 const route = useRoute()
@@ -26,15 +26,10 @@ const currentVersion = computed(() => {
 </script>
 
 <template>
-  <VPNavBarMenuGroup
-    v-if="!screenMenu"
+  <VPNavMenuGroup
     :item="{ text: currentVersion, items: versions }"
-    class="VPNavVersion"
-  />
-  <VPNavScreenMenuGroup
-    v-else
-    :text="currentVersion"
-    :items="versions"
+    :screen="screenMenu"
+    :menu="menu"
     class="VPNavVersion"
   />
 </template>
diff --git a/__tests__/e2e/navigation.test.ts b/__tests__/e2e/navigation.test.ts
index cece272a..3d475f85 100644
--- a/__tests__/e2e/navigation.test.ts
+++ b/__tests__/e2e/navigation.test.ts
@@ -67,6 +67,157 @@ describe('navigation accessibility', () => {
     expect(await ariaCurrent(sectionTwo)).toBeNull()
   })
 
+  test('nav landmarks and controls have accessible names', async () => {
+    await goto('/')
+
+    expect(await page.locator('.VPNavBarMenu').getAttribute('aria-label')).toBe(
+      'Main Navigation'
+    )
+
+    await page.setViewportSize({ width: 375, height: 667 })
+    expect(
+      await page.locator('.VPNavBarHamburger').getAttribute('aria-label')
+    ).toBe('Menu')
+  })
+
+  test('dropdown group is a keyboard-dismissible disclosure', async () => {
+    await goto('/')
+
+    const button = page.locator('.VPNavBarMenuGroup').first().locator('button')
+    expect(await button.getAttribute('aria-expanded')).toBe('false')
+
+    await button.click()
+    expect(await button.getAttribute('aria-expanded')).toBe('true')
+
+    await page.keyboard.press('Escape')
+    expect(await button.getAttribute('aria-expanded')).toBe('false')
+
+    // focus returned to the trigger
+    expect(
+      await page.evaluate(() => document.activeElement?.textContent)
+    ).toContain('API Reference')
+  })
+
+  test('dropdown closes after navigating via a menu item', async () => {
+    await goto('/')
+
+    const group = page.locator('.VPNavBarMenuGroup').first()
+    await group.locator('button').click()
+    await group.locator('a[href="/home.html"]').click()
+    await page.waitForFunction(() => location.pathname.endsWith('/home.html'))
+
+    // the route watcher closes it on the post-navigation tick
+    await page.waitForSelector(
+      '.VPNavBarMenuGroup button[aria-expanded="false"]'
+    )
+  })
+
+  test('overflowing nav items move into the extra menu instead of clipping', async () => {
+    await goto('/')
+
+    // everything fits at 1280, so the ⋯ menu isn't rendered at all
+    expect(await page.locator('.VPNavBarExtra').count()).toBe(0)
+
+    // inflate the items so none of them can possibly fit
+    const style = await page.addStyleTag({
+      content: '.VPNavBarMenu .list > li > * { padding: 0 500px !important }'
+    })
+    await page.waitForSelector('.VPNavBarExtra')
+
+    // every control that stays in the bar remains fully within the viewport
+    // (no clipped/unreachable items — the failure mode of #2842)
+    expect(
+      await page.evaluate(() => {
+        const targets = [
+          ...document.querySelectorAll('.VPNavBarMenu .list > li'),
+          document.querySelector('.VPNavBarSearch button'),
+          document.querySelector('.VPNavBarExtra > button')
+        ].filter((el): el is HTMLElement => !!el)
+        return targets.every((el) => {
+          const rect = el.getBoundingClientRect()
+          return rect.left >= -1 && rect.right <= innerWidth + 1
+        })
+      })
+    ).toBe(true)
+
+    // collapsed items and social links are reachable through the ⋯ menu
+    // (the scoped selector targets the moved "Home" item itself — the
+    // version-switcher component in the menu also links to "/")
+    await page.locator('.VPNavBarExtra > button').click()
+    await page.waitForSelector(
+      '.VPNavBarExtra .overflow-items > .VPMenuLink a[href="/"]'
+    )
+    await page.waitForSelector('.VPNavBarExtra .social-links')
+
+    // component items render menu-native: a titled group whose links are
+    // visible in place, not the screen accordion or a nested flyout
+    await page.waitForSelector(
+      '.VPNavBarExtra .overflow-items > .VPNavVersion .title'
+    )
+    expect(
+      await page.locator('.VPNavBarExtra .VPNavScreenMenuGroup').count()
+    ).toBe(0)
+
+    // widening back restores the inline items and removes the ⋯ menu
+    await style.evaluate((el) => (el as HTMLStyleElement).remove())
+    await page.waitForSelector('.VPNavBarExtra', { state: 'detached' })
+    await page.waitForSelector('.VPNavBarMenuLink[href="/"]')
+  })
+
+  test('nav screen manages focus and inert state', async () => {
+    await page.setViewportSize({ width: 375, height: 667 })
+    await goto('/')
+
+    const hamburger = page.locator('.VPNavBarHamburger')
+    expect(await hamburger.getAttribute('aria-expanded')).toBe('false')
+
+    await hamburger.click()
+    await page.waitForSelector('#VPNavScreen')
+    expect(await hamburger.getAttribute('aria-expanded')).toBe('true')
+
+    // the covered page content is inert while the screen is open
+    expect(
+      await page.evaluate(() =>
+        document.getElementById('VPContent')!.hasAttribute('inert')
+      )
+    ).toBe(true)
+
+    await page.keyboard.press('Escape')
+    await page.waitForSelector('#VPNavScreen', { state: 'detached' })
+
+    expect(
+      await page.evaluate(() =>
+        document.getElementById('VPContent')!.hasAttribute('inert')
+      )
+    ).toBe(false)
+
+    // focus returned to the hamburger
+    expect(
+      await page.evaluate(() => document.activeElement?.className)
+    ).toContain('VPNavBarHamburger')
+  })
+
+  test('screen menu group is a real disclosure', async () => {
+    await page.setViewportSize({ width: 375, height: 667 })
+    await goto('/')
+    await page.locator('.VPNavBarHamburger').click()
+
+    const group = page.locator('.VPNavScreenMenuGroup').first()
+    const button = group.locator('button').first()
+
+    expect(await button.getAttribute('aria-expanded')).toBe('false')
+    // collapsed content is hidden from view and the tab order
+    expect(await group.locator('a[href="/home.html"]').isVisible()).toBe(false)
+
+    await button.click()
+    expect(await button.getAttribute('aria-expanded')).toBe('true')
+    await page.waitForSelector('.VPNavScreenMenuGroup a[href="/home.html"]')
+
+    // aria-controls points at the panel it toggles
+    const controls = await button.getAttribute('aria-controls')
+    expect(await group.locator(`ul[id="${controls}"]`).count()).toBe(1)
+  })
+
   test.runIf(process.env.VITE_TEST_BUILD)(
     'omits aria-current for fragment links in server-rendered HTML',
     async () => {
diff --git a/__tests__/unit/client/theme-default/composables/nav-overflow.test.ts b/__tests__/unit/client/theme-default/composables/nav-overflow.test.ts
new file mode 100644
index 00000000..3250bee3
--- /dev/null
+++ b/__tests__/unit/client/theme-default/composables/nav-overflow.test.ts
@@ -0,0 +1,135 @@
+import {
+  computeNavFit,
+  type NavFitInput
+} from 'client/theme-default/composables/nav-overflow'
+
+function fit(input: Partial<NavFitInput>) {
+  return computeNavFit({
+    itemWidths: [],
+    translations: null,
+    appearance: null,
+    socialLinks: null,
+    available: 0,
+    extraWidth: 40,
+    ...input
+  })
+}
+
+describe('client/theme-default/composables/nav-overflow', () => {
+  describe('computeNavFit', () => {
+    test('keeps everything when it fits', () => {
+      expect(
+        fit({
+          itemWidths: [100, 100],
+          translations: 50,
+          appearance: 60,
+          socialLinks: 90,
+          available: 400
+        })
+      ).toEqual({
+        visibleItemCount: Infinity,
+        translations: true,
+        appearance: true,
+        socialLinks: true
+      })
+    })
+
+    test('collapses social links first', () => {
+      expect(
+        fit({
+          itemWidths: [100, 100],
+          translations: 50,
+          appearance: 60,
+          socialLinks: 90,
+          available: 390
+        })
+      ).toEqual({
+        visibleItemCount: Infinity,
+        translations: true,
+        appearance: true,
+        socialLinks: false
+      })
+    })
+
+    test('collapses the cluster cascade in order', () => {
+      // items (200) + translations (50) fit in the 260 budget after
+      // reserving the extra button, appearance (60) does not — social links
+      // must follow appearance out even though they'd fit alone
+      expect(
+        fit({
+          itemWidths: [100, 100],
+          translations: 50,
+          appearance: 60,
+          socialLinks: 5,
+          available: 300
+        })
+      ).toEqual({
+        visibleItemCount: Infinity,
+        translations: true,
+        appearance: false,
+        socialLinks: false
+      })
+    })
+
+    test('collapses menu items right-to-left after the cluster', () => {
+      expect(
+        fit({
+          itemWidths: [100, 100, 100],
+          translations: 50,
+          available: 250
+        })
+      ).toEqual({
+        visibleItemCount: 2,
+        translations: false,
+        appearance: true,
+        socialLinks: true
+      })
+    })
+
+    test('ignores unconfigured cluster units', () => {
+      expect(
+        fit({
+          itemWidths: [100],
+          socialLinks: 90,
+          available: 150
+        })
+      ).toEqual({
+        visibleItemCount: Infinity,
+        translations: true,
+        appearance: true,
+        socialLinks: false
+      })
+    })
+
+    test('collapses everything when nothing fits', () => {
+      expect(
+        fit({
+          itemWidths: [100, 100],
+          translations: 50,
+          available: 30
+        })
+      ).toEqual({
+        visibleItemCount: 0,
+        translations: false,
+        // unconfigured units just stay "not collapsed"
+        appearance: true,
+        socialLinks: true
+      })
+    })
+
+    test('a lone overwide item still collapses instead of clipping', () => {
+      expect(fit({ itemWidths: [500], available: 400 }).visibleItemCount).toBe(
+        0
+      )
+    })
+
+    test('handles an empty nav', () => {
+      expect(fit({ socialLinks: 90, appearance: 60, available: 80 })).toEqual({
+        visibleItemCount: Infinity,
+        translations: true,
+        appearance: false,
+        socialLinks: false
+      })
+    })
+  })
+})
diff --git a/docs/en/guide/extending-default-theme.md b/docs/en/guide/extending-default-theme.md
index 8a109e34..63bf3365 100644
--- a/docs/en/guide/extending-default-theme.md
+++ b/docs/en/guide/extending-default-theme.md
@@ -40,6 +40,46 @@ export default DefaultTheme
 
 See [default theme CSS variables](https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css) that can be overridden.
 
+### Navbar
+
+The navbar draws a single background surface controlled by CSS variables, so its look can be changed without touching component internals:
+
+```css
+:root {
+  /* bar height and background */
+  --vp-nav-height: 4rem;
+  --vp-nav-bg-color: var(--vp-c-bg);
+
+  /* background while on top of the home page (unscrolled);
+     set to var(--vp-nav-bg-color) to opt out of the transparent treatment */
+  --vp-nav-home-bg-color: transparent;
+
+  /* filter applied to the content behind the bar */
+  --vp-nav-backdrop-filter: none;
+
+  /* the bar's bottom rule and the mobile menu background */
+  --vp-nav-divider-color: var(--vp-c-gutter);
+  --vp-nav-screen-bg-color: var(--vp-c-bg);
+}
+```
+
+For example, a frosted-glass navbar:
+
+```css
+:root {
+  --vp-nav-bg-color: color-mix(in srgb, var(--vp-c-bg) 65%, transparent);
+  --vp-nav-backdrop-filter: saturate(180%) blur(8px);
+}
+```
+
+The same treatment carries over to the local nav: `--vp-local-nav-bg-color` follows the navbar surface color by default, and where the two bars meet they share a single blurred surface, so the glass stays continuous across them.
+
+::: warning
+`backdrop-filter` has a measurable scroll performance cost, especially on large or high-DPI screens. When using a translucent bar, also check text contrast over your page content.
+:::
+
+When the nav items don't fit the available width, they move into the `⋯` menu at the end of the navbar instead of being clipped, starting with the social links, the appearance switch and the locale switcher, followed by the nav items right-to-left. Its button label can be localized with [`extraMenuLabel`](../reference/default-theme-config#extramenulabel).
+
 ## Using Different Fonts
 
 VitePress uses [Inter](https://rsms.me/inter/) as the default font, and will include the fonts in the build output. The font is also auto preloaded in production. However, this may not be desirable if you want to use a different main font.
diff --git a/docs/en/reference/default-theme-config.md b/docs/en/reference/default-theme-config.md
index cef4c48a..19f0cc76 100644
--- a/docs/en/reference/default-theme-config.md
+++ b/docs/en/reference/default-theme-config.md
@@ -470,6 +470,27 @@ Can be used to customize the label of the return to top button. This label is on
 
 Can be used to customize the aria-label of the language toggle button in navbar. This is only used if you're using [i18n](../guide/i18n).
 
+## navMenuLabel
+
+- Type: `string`
+- Default: `Main Navigation`
+
+Can be used to customize the accessible label of the main navigation landmarks (the navbar menu and the mobile menu).
+
+## mobileMenuLabel
+
+- Type: `string`
+- Default: `Menu`
+
+Can be used to customize the aria-label of the mobile menu (hamburger) button.
+
+## extraMenuLabel
+
+- Type: `string`
+- Default: `More options`
+
+Can be used to customize the aria-label of the `⋯` menu button in the navbar. That menu collects the nav items and controls that don't fit in the bar at the current viewport size.
+
 ## skipToContentLabel
 
 - Type: `string`
diff --git a/docs/en/reference/default-theme-nav.md b/docs/en/reference/default-theme-nav.md
index 01ff2090..02caac41 100644
--- a/docs/en/reference/default-theme-nav.md
+++ b/docs/en/reference/default-theme-nav.md
@@ -216,5 +216,6 @@ export default {
 Your component will be rendered in the navigation bar. VitePress will provide the following additional props to the component:
 
 - `screenMenu`: an optional boolean indicating whether the component is inside mobile navigation menu
+- `menu`: an optional boolean indicating whether the component is inside a dropdown panel — for example, the `⋯` menu that nav items collapse into when they don't fit the bar. In both these contexts, render a flat list instead of a floating flyout, which would end up nested inside the panel
 
 You can check an example in the e2e tests [here](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress).
diff --git a/package.json b/package.json
index c557b30e..13fb5fdb 100644
--- a/package.json
+++ b/package.json
@@ -57,7 +57,7 @@
     "build:check": "publint && attw --pack . --profile esm-only",
     "typecheck": "tsc -p tsconfig.shared.json && vue-tsc -p tsconfig.client.json && tsc -p tsconfig.node.json",
     "test": "pnpm --aggregate-output --reporter=append-only '/^test:(types|unit|e2e|init)$/'",
-    "test:types": "tsc -p __tests__/unit && tsc -p __tests__/e2e && tsc -p __tests__/init && vue-tsc -p docs",
+    "test:types": "tsc -p __tests__/unit && vue-tsc -p __tests__/e2e && tsc -p __tests__/init && vue-tsc -p docs",
     "test:unit": "vitest run -r __tests__/unit",
     "test:unit:watch": "vitest -r __tests__/unit",
     "test:e2e": "pnpm test:e2e-dev && pnpm test:e2e-build",
diff --git a/src/client/theme-default/Layout.vue b/src/client/theme-default/Layout.vue
index d13266a5..c9a4af67 100644
--- a/src/client/theme-default/Layout.vue
+++ b/src/client/theme-default/Layout.vue
@@ -10,6 +10,7 @@ import VPSidebar from './components/VPSidebar.vue'
 import VPSkipLink from './components/VPSkipLink.vue'
 import { useData } from './composables/data'
 import { layoutInfoInjectionKey, registerWatchers } from './composables/layout'
+import { useNav } from './composables/nav'
 import { useSidebarControl } from './composables/sidebar'
 
 const {
@@ -18,6 +19,10 @@ const {
   close: closeSidebar
 } = useSidebarControl()
 
+// everything behind the open nav screen is inert so keyboard and screen
+// reader users can't reach the covered page content
+const { isScreenOpen } = useNav()
+
 registerWatchers({ closeSidebar })
 
 const { frontmatter, theme } = useData()
@@ -38,7 +43,7 @@ provide(layoutInfoInjectionKey, { heroImageSlotExists })
     ]"
   >
     <slot name="layout-top" />
-    <VPSkipLink />
+    <VPSkipLink :inert="isScreenOpen" />
     <VPBackdrop class="backdrop" :show="isSidebarOpen" @click="closeSidebar" />
     <VPNav>
       <template #nav-bar-title-before><slot name="nav-bar-title-before" /></template>
@@ -48,14 +53,14 @@ provide(layoutInfoInjectionKey, { heroImageSlotExists })
       <template #nav-screen-content-before><slot name="nav-screen-content-before" /></template>
       <template #nav-screen-content-after><slot name="nav-screen-content-after" /></template>
     </VPNav>
-    <VPLocalNav :open="isSidebarOpen" @open-menu="openSidebar" />
+    <VPLocalNav :open="isSidebarOpen" @open-menu="openSidebar" :inert="isScreenOpen" />
 
-    <VPSidebar :open="isSidebarOpen">
+    <VPSidebar :open="isSidebarOpen" :inert="isScreenOpen">
       <template #sidebar-nav-before><slot name="sidebar-nav-before" /></template>
       <template #sidebar-nav-after><slot name="sidebar-nav-after" /></template>
     </VPSidebar>
 
-    <VPContent>
+    <VPContent :inert="isScreenOpen">
       <template #page-top><slot name="page-top" /></template>
       <template #page-bottom><slot name="page-bottom" /></template>
 
@@ -85,7 +90,7 @@ provide(layoutInfoInjectionKey, { heroImageSlotExists })
       <template #aside-ads-after><slot name="aside-ads-after" /></template>
     </VPContent>
 
-    <VPFooter />
+    <VPFooter :inert="isScreenOpen" />
     <slot name="layout-bottom" />
   </div>
   <Content v-else />
diff --git a/src/client/theme-default/components/VPFlyout.vue b/src/client/theme-default/components/VPFlyout.vue
index cdb86fb3..503066fc 100644
--- a/src/client/theme-default/components/VPFlyout.vue
+++ b/src/client/theme-default/components/VPFlyout.vue
@@ -1,6 +1,8 @@
 <script lang="ts" setup generic="T extends DefaultTheme.NavItem">
+import { onKeyStroke, useEventListener } from '@vueuse/core'
+import { useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { ref, useTemplateRef } from 'vue'
+import { ref, useId, useTemplateRef, watch } from 'vue'
 
 import { useFlyout } from '../composables/flyout'
 import VPMenu from './VPMenu.vue'
@@ -14,39 +16,99 @@ defineProps<{
 
 const open = ref(false)
 const el = useTemplateRef('el')
+const buttonEl = useTemplateRef('buttonEl')
+const menuEl = useTemplateRef('menuEl')
+const menuId = useId()
+
+useFlyout({ el, onBlur: close })
+
+const route = useRoute()
+watch(() => route.path, close)
+
+// for mouse users the disclosure opens and closes on hover, with the same
+// boundary in both directions: the button plus the open panel. The root box
+// isn't used — it also contains the ::before divider some contexts draw
+// before the flyout, which should act as a neutral gap either way. Closing
+// needs no delay: leaving for the panel (or back) is detected via
+// relatedTarget, and any real exit closes instantly so a panel never
+// lingers over a neighboring flyout while sweeping across the bar.
+
+// a hover-open absorbs the click that usually follows it, otherwise mouse
+// users would toggle the menu right back off
+let openedByHover = false
+
+function onPointerEnter(e: PointerEvent) {
+  if (e.pointerType !== 'mouse') return
+  if (!open.value) {
+    open.value = true
+    openedByHover = true
+  }
+}
 
-useFlyout({ el, onBlur })
+function onPointerLeave(e: PointerEvent) {
+  if (e.pointerType !== 'mouse') return
+  const to = e.relatedTarget as Node | null
+  // still within the button ∪ panel region — not an exit
+  if (to && (buttonEl.value?.contains(to) || menuEl.value?.contains(to))) return
+  close()
+}
 
-function onBlur() {
+function toggle() {
+  if (open.value && openedByHover) {
+    openedByHover = false
+    return
+  }
+  openedByHover = false
+  open.value = !open.value
+}
+
+function close() {
   open.value = false
+  openedByHover = false
 }
+
+// content shown on hover must be dismissible without moving the pointer
+// (WCAG 1.4.13) — Escape closes and, if focus was inside, returns it to the
+// trigger
+onKeyStroke('Escape', () => {
+  if (!open.value) return
+  const restoreFocus = el.value?.contains(document.activeElement)
+  close()
+  if (restoreFocus) {
+    el.value?.querySelector('button')?.focus()
+  }
+})
+
+// a tap on a non-focusable area outside doesn't move focus, so the
+// focus-tracking blur alone can't dismiss the menu on touch
+useEventListener('pointerdown', (e) => {
+  if (open.value && el.value && !el.value.contains(e.target as Node)) close()
+})
 </script>
 
 <template>
-  <div
-    class="VPFlyout"
-    ref="el"
-    @mouseenter="open = true"
-    @mouseleave="open = false"
-  >
+  <div class="VPFlyout" ref="el">
     <button
+      ref="buttonEl"
       type="button"
       class="button"
-      aria-haspopup="true"
       :aria-expanded="open"
+      :aria-controls="menuId"
       :aria-label="label"
-      @click="open = !open"
+      @pointerenter="onPointerEnter"
+      @pointerleave="onPointerLeave"
+      @click="toggle"
     >
       <span v-if="button || icon" class="text">
-        <span v-if="icon" :class="[icon, 'option-icon']" />
+        <span v-if="icon" :class="[icon, 'option-icon']" aria-hidden="true" />
         <span v-if="button" v-html="button"></span>
-        <span class="vpi-chevron-down text-icon" />
+        <span class="vpi-chevron-down text-icon" aria-hidden="true" />
       </span>
 
-      <span v-else class="vpi-more-horizontal icon" />
+      <span v-else class="vpi-more-horizontal icon" aria-hidden="true" />
     </button>
 
-    <div class="menu">
+    <div ref="menuEl" class="menu" :id="menuId" @pointerleave="onPointerLeave">
       <VPMenu :items>
         <slot />
       </VPMenu>
@@ -80,17 +142,17 @@ function onBlur() {
   color: var(--vp-c-brand-2);
 }
 
+/* closing is snappier than opening so a panel doesn't linger over the
+   neighboring flyout's panel while sweeping across the bar */
 .button[aria-expanded="false"] + .menu {
   opacity: 0;
   visibility: hidden;
-  transform: translateY(0);
+  transition: opacity 0.1s, visibility 0.1s;
 }
 
-.VPFlyout:hover .menu,
 .button[aria-expanded="true"] + .menu {
   opacity: 1;
   visibility: visible;
-  transform: translateY(0);
 }
 
 .button {
@@ -113,7 +175,6 @@ function onBlur() {
 }
 
 .option-icon {
-  margin-right: 0px;
   font-size: 1rem;
 }
 
@@ -133,6 +194,6 @@ function onBlur() {
   right: 0;
   opacity: 0;
   visibility: hidden;
-  transition: opacity 0.25s, visibility 0.25s, transform 0.25s;
+  transition: opacity 0.25s, visibility 0.25s;
 }
 </style>
diff --git a/src/client/theme-default/components/VPLocalNav.vue b/src/client/theme-default/components/VPLocalNav.vue
index 53f16740..0b644cdc 100644
--- a/src/client/theme-default/components/VPLocalNav.vue
+++ b/src/client/theme-default/components/VPLocalNav.vue
@@ -31,30 +31,29 @@ onMounted(() => {
   probe.remove()
 })
 
-const classes = computed(() => {
-  return {
-    VPLocalNav: true,
-    'has-sidebar': hasSidebar.value,
-    empty: !hasLocalNav.value,
-    fixed: !hasLocalNav.value && !hasSidebar.value
-  }
-})
+const isScrolled = computed(() => y.value >= navHeight.value)
 </script>
 
 <template>
   <div
-    v-if="!isHome && (hasLocalNav || hasSidebar || y >= navHeight)"
-    :class="classes"
+    v-if="!isHome && (hasLocalNav || hasSidebar || isScrolled)"
+    class="VPLocalNav"
+    :class="{
+      'has-sidebar': hasSidebar,
+      'empty': !hasLocalNav,
+      'fixed': !hasLocalNav && !hasSidebar
+    }"
   >
     <div class="container">
       <button
         v-if="hasSidebar"
+        type="button"
         class="menu"
         :aria-expanded="open"
         aria-controls="VPSidebarNav"
         @click="$emit('open-menu')"
       >
-        <span class="vpi-align-left menu-icon"></span>
+        <span class="vpi-align-left menu-icon" aria-hidden="true"></span>
         <span class="menu-text">
           {{ theme.sidebarMenuLabel || 'Menu' }}
         </span>
@@ -75,7 +74,21 @@ const classes = computed(() => {
   border-bottom: 1px solid var(--vp-c-gutter);
   padding-top: var(--vp-layout-top-height, 0px);
   width: 100%;
+}
+
+/* the background surface — below 60rem it covers just this bar; from 60rem
+   the bar is pinned under the fixed navbar, so the surface extends up
+   behind it and one element carries the backdrop filter for both bars
+   (two stacked filters would show a seam at their shared edge) */
+.VPLocalNav::before {
+  content: '';
+  position: absolute;
+  inset: 0;
+  z-index: -1;
   background-color: var(--vp-local-nav-bg-color);
+  backdrop-filter: var(--vp-nav-backdrop-filter);
+  -webkit-backdrop-filter: var(--vp-nav-backdrop-filter);
+  transition: background-color 0.25s;
 }
 
 .VPLocalNav.fixed {
@@ -87,6 +100,10 @@ const classes = computed(() => {
     top: var(--vp-nav-height);
   }
 
+  .VPLocalNav::before {
+    top: calc(-1 * var(--vp-nav-height));
+  }
+
   .VPLocalNav.has-sidebar {
     padding-left: var(--vp-sidebar-width);
   }
diff --git a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
index 11f5be61..c4b0418a 100644
--- a/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
+++ b/src/client/theme-default/components/VPLocalNavOutlineDropdown.vue
@@ -2,7 +2,7 @@
 import { onKeyStroke } from '@vueuse/core'
 import { onContentUpdated } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
-import { nextTick, ref, useTemplateRef, watch } from 'vue'
+import { nextTick, ref, useId, useTemplateRef, watch } from 'vue'
 
 import { useData } from '../composables/data'
 import { resolveTitle } from '../composables/outline'
@@ -19,6 +19,7 @@ const open = ref(false)
 const vh = ref(0)
 const main = useTemplateRef('main')
 const items = useTemplateRef('items')
+const itemsId = useId()
 
 // lock body scroll while the dropdown is open to prevent scroll chaining
 const isLocked = useBodyScrollLock()
@@ -76,15 +77,22 @@ function scrollToTop() {
     :style="{ '--vp-vh': vh + 'px' }"
     data-allow-mismatch="style"
   >
-    <button @click="toggle" :class="{ open }" v-if="headers.length > 0">
+    <button
+      v-if="headers.length > 0"
+      type="button"
+      :aria-expanded="open"
+      :aria-controls="itemsId"
+      :class="{ open }"
+      @click="toggle"
+    >
       <span class="menu-text">{{ resolveTitle(theme) }}</span>
-      <span class="vpi-chevron-right icon" />
+      <span class="vpi-chevron-right icon" aria-hidden="true" />
     </button>
-    <button @click="scrollToTop" v-else>
+    <button v-else type="button" @click="scrollToTop">
       {{ theme.returnToTopLabel || 'Return to top' }}
     </button>
     <Transition name="flyout">
-      <div v-if="open" ref="items" class="items" @click="onItemClick">
+      <div v-if="open" ref="items" :id="itemsId" class="items" @click="onItemClick">
         <div class="header">
           <a class="top-link" href="#" @click="scrollToTop">
             {{ theme.returnToTopLabel || 'Return to top' }}
diff --git a/src/client/theme-default/components/VPMenu.vue b/src/client/theme-default/components/VPMenu.vue
index 5a7ad4a2..725dc4a1 100644
--- a/src/client/theme-default/components/VPMenu.vue
+++ b/src/client/theme-default/components/VPMenu.vue
@@ -18,6 +18,7 @@ defineProps<{
           v-else-if="'component' in item"
           :is="item.component"
           v-bind="item.props"
+          menu
         />
         <VPMenuGroup v-else :text="item.text" :items="item.items" />
       </template>
@@ -64,16 +65,4 @@ defineProps<{
   white-space: nowrap;
 }
 
-.VPMenu :deep(.label) {
-  flex-grow: 1;
-  line-height: 2.3333333;
-  font-size: 0.75rem;
-  font-weight: 500;
-  color: var(--vp-c-text-2);
-  transition: color 0.5s;
-}
-
-.VPMenu :deep(.action) {
-  padding-left: 1.5rem;
-}
 </style>
diff --git a/src/client/theme-default/components/VPMenuGroup.vue b/src/client/theme-default/components/VPMenuGroup.vue
index b98138bc..4e155292 100644
--- a/src/client/theme-default/components/VPMenuGroup.vue
+++ b/src/client/theme-default/components/VPMenuGroup.vue
@@ -9,22 +9,41 @@
   "
 >
 import type { DefaultTheme } from 'vitepress/theme'
+import { computed, inject } from 'vue'
 
+import { navScreenInjectionKey } from '../composables/nav'
 import VPMenuLink from './VPMenuLink.vue'
 
-defineProps<{
+const props = defineProps<{
   text?: string
   items: T[]
 }>()
+
+const screen = inject(navScreenInjectionKey, false)
+
+const hasSubGroups = computed(() =>
+  props.items.some((item) => !('link' in item) && !('component' in item))
+)
 </script>
 
 <template>
-  <li class="VPMenuGroup">
+  <li
+    class="VPMenuGroup"
+    :class="{ VPNavScreenMenuGroupSection: screen }"
+  >
     <p v-if="text" class="title">{{ text }}</p>
 
-    <ul>
+    <ul :class="{ 'sub-groups': hasSubGroups }">
       <template v-for="item in items" :key="JSON.stringify(item)">
         <VPMenuLink v-if="'link' in item" :item />
+        <component
+          v-else-if="'component' in item"
+          :is="item.component"
+          v-bind="item.props"
+          :screen-menu="screen || undefined"
+          :menu="!screen || undefined"
+        />
+        <VPMenuGroup v-else :text="item.text" :items="item.items" />
       </template>
     </ul>
   </li>
@@ -57,4 +76,35 @@ defineProps<{
   white-space: nowrap;
   transition: color 0.25s;
 }
+
+.VPNavScreen .VPMenuGroup {
+  margin: 0;
+  border: none;
+  padding: 0;
+}
+
+.VPNavScreen .title {
+  padding: 0;
+  line-height: 2.4615385;
+  font-size: 0.8125rem;
+  font-weight: 700;
+  white-space: normal;
+}
+
+.VPMenuGroup > .sub-groups {
+  margin: 0.25rem 0 0.25rem 0.75rem;
+  border-left: 1px solid var(--vp-c-divider);
+  padding-left: 0.25rem;
+}
+
+.VPMenuGroup .VPMenuGroup,
+.VPMenuGroup .VPMenuGroup + .VPMenuGroup {
+  margin: 0;
+  border-top: 0;
+  padding: 0.5rem 0 0;
+}
+
+.VPMenuGroup .VPMenuGroup:first-child {
+  padding-top: 0;
+}
 </style>
diff --git a/src/client/theme-default/components/VPMenuLink.vue b/src/client/theme-default/components/VPMenuLink.vue
index 45912479..39016a7e 100644
--- a/src/client/theme-default/components/VPMenuLink.vue
+++ b/src/client/theme-default/components/VPMenuLink.vue
@@ -1,7 +1,12 @@
 <script lang="ts" setup generic="T extends DefaultTheme.NavItemWithLink">
 import type { DefaultTheme } from 'vitepress/theme'
+import { inject } from 'vue'
 
-import { useNavItemLink } from '../composables/nav'
+import {
+  navInjectionKey,
+  navScreenInjectionKey,
+  useNavItemLink
+} from '../composables/nav'
 import VPLink from './VPLink.vue'
 
 const props = defineProps<{
@@ -11,6 +16,13 @@ const props = defineProps<{
 
 const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
 
+const screen = inject(navScreenInjectionKey, false)
+const nav = inject(navInjectionKey, null)
+
+function onClick() {
+  if (screen) nav?.closeScreen()
+}
+
 defineOptions({ inheritAttrs: false })
 </script>
 
@@ -18,12 +30,16 @@ defineOptions({ inheritAttrs: false })
   <li class="VPMenuLink">
     <VPLink
       v-bind="$attrs"
-      :class="{ active: isActiveLink }"
+      :class="{
+        active: isActiveLink,
+        VPNavScreenMenuGroupLink: screen
+      }"
       :aria-current="isCurrentLink ? 'page' : undefined"
       :href
       :target="item.target"
       :rel="props.rel ?? item.rel"
       :no-icon="item.noIcon"
+      @click="onClick"
     >
       <span v-html="item.text"></span>
     </VPLink>
@@ -37,6 +53,12 @@ defineOptions({ inheritAttrs: false })
   padding: 0.75rem 0.75rem 0;
 }
 
+.VPMenuGroup .VPMenuGroup + .VPMenuLink {
+  margin: 0;
+  border-top: 0;
+  padding: 0.5rem 0 0;
+}
+
 .link {
   display: block;
   border-radius: 0.375rem;
@@ -58,4 +80,23 @@ defineOptions({ inheritAttrs: false })
 .link.active {
   color: var(--vp-c-brand-1);
 }
+
+.VPNavScreen .VPMenuLink {
+  margin: 0;
+  border: none;
+  padding: 0;
+}
+
+.VPNavScreen .link {
+  display: block;
+  margin-left: 0.75rem;
+  border-radius: 0;
+  padding: 0;
+  font-weight: 400;
+  white-space: normal;
+}
+
+.VPNavScreen .link:hover {
+  background-color: transparent;
+}
 </style>
diff --git a/src/client/theme-default/components/VPNav.vue b/src/client/theme-default/components/VPNav.vue
index 7c97b1d8..051a3009 100644
--- a/src/client/theme-default/components/VPNav.vue
+++ b/src/client/theme-default/components/VPNav.vue
@@ -47,7 +47,6 @@ watchEffect(() => {
   z-index: var(--vp-z-index-nav);
   width: 100%;
   pointer-events: none;
-  transition: background-color 0.5s;
 }
 
 @media (min-width: 60rem) {
diff --git a/src/client/theme-default/components/VPNavAppearance.vue b/src/client/theme-default/components/VPNavAppearance.vue
new file mode 100644
index 00000000..6873e400
--- /dev/null
+++ b/src/client/theme-default/components/VPNavAppearance.vue
@@ -0,0 +1,92 @@
+<script lang="ts" setup>
+import { computed, useId } from 'vue'
+
+import { useData } from '../composables/data'
+import { useAppearanceSwitch } from '../composables/nav'
+import { useNavOverflow } from '../composables/nav-overflow'
+import VPSwitchAppearance from './VPSwitchAppearance.vue'
+
+const props = defineProps<{
+  /** labeled row (nav screen and `⋯` menu) instead of the bare switch */
+  row?: boolean
+  /** styling context for the row variant */
+  screen?: boolean
+}>()
+
+const { theme } = useData()
+const show = useAppearanceSwitch()
+
+// only the inline bar switch participates in the overflow engine
+const overflow = props.row ? null : useNavOverflow()
+
+const isCollapsed = computed(() => !!overflow && !overflow.state.appearance)
+
+const labelId = useId()
+</script>
+
+<template>
+  <div
+    v-if="show"
+    class="VPNavAppearance"
+    :class="[
+      row ? (screen ? 'VPNavScreenAppearance' : 'menu-appearance') : 'VPNavBarAppearance',
+      { collapsed: isCollapsed }
+    ]"
+    :ref="(el) => overflow?.setClusterEl('appearance', el as HTMLElement | null)"
+  >
+    <p v-if="row" :id="labelId" class="text">
+      {{ theme.darkModeSwitchLabel || 'Appearance' }}
+    </p>
+    <VPSwitchAppearance :aria-labelledby="row ? labelId : undefined" />
+  </div>
+</template>
+
+<style scoped>
+.VPNavBarAppearance {
+  display: none;
+}
+
+@media (min-width: 48rem) {
+  .VPNavBarAppearance {
+    display: flex;
+    align-items: center;
+  }
+}
+
+.VPNavAppearance .text {
+  font-size: 0.75rem;
+  font-weight: 500;
+  color: var(--vp-c-text-2);
+}
+
+/* labeled row inside the nav screen */
+.VPNavScreenAppearance {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  border-radius: 0.5rem;
+  padding: 0.75rem 0.875rem 0.75rem 1rem;
+  background-color: var(--vp-c-bg-soft);
+}
+
+.VPNavScreenAppearance .text {
+  line-height: 2;
+}
+
+/* labeled row inside the `⋯` menu */
+.menu-appearance {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 1rem;
+  min-width: 11rem;
+  padding: 0 0.75rem;
+}
+
+/* matches the menu group titles */
+.menu-appearance .text {
+  line-height: 2.2857143;
+  font-size: 0.875rem;
+  font-weight: 600;
+}
+</style>
diff --git a/src/client/theme-default/components/VPNavBar.vue b/src/client/theme-default/components/VPNavBar.vue
index 1c566aea..24a0f4c9 100644
--- a/src/client/theme-default/components/VPNavBar.vue
+++ b/src/client/theme-default/components/VPNavBar.vue
@@ -1,17 +1,20 @@
 <script lang="ts" setup>
 import { useWindowScroll } from '@vueuse/core'
+import { computed } from 'vue'
 
+import { useData } from '../composables/data'
 import { useLayout } from '../composables/layout'
-import VPNavBarAppearance from './VPNavBarAppearance.vue'
+import { provideNavOverflow } from '../composables/nav-overflow'
+import VPNavAppearance from './VPNavAppearance.vue'
 import VPNavBarExtra from './VPNavBarExtra.vue'
 import VPNavBarHamburger from './VPNavBarHamburger.vue'
-import VPNavBarMenu from './VPNavBarMenu.vue'
 import VPNavBarSearch from './VPNavBarSearch.vue'
-import VPNavBarSocialLinks from './VPNavBarSocialLinks.vue'
 import VPNavBarTitle from './VPNavBarTitle.vue'
-import VPNavBarTranslations from './VPNavBarTranslations.vue'
+import VPNavMenu from './VPNavMenu.vue'
+import VPNavSocialLinks from './VPNavSocialLinks.vue'
+import VPNavTranslations from './VPNavTranslations.vue'
 
-const props = defineProps<{
+defineProps<{
   isScreenOpen: boolean
 }>()
 
@@ -19,8 +22,15 @@ defineEmits<{
   (e: 'toggle-screen'): void
 }>()
 
+const { theme } = useData()
+const { isHome, hasSidebar, hasLocalNav } = useLayout()
+
 const { y } = useWindowScroll()
-const { isHome, hasSidebar } = useLayout()
+const isTop = computed(() => y.value <= 0)
+
+const overflow = provideNavOverflow({
+  itemsKey: () => JSON.stringify(theme.value.nav ?? null)
+})
 </script>
 
 <template>
@@ -28,8 +38,9 @@ const { isHome, hasSidebar } = useLayout()
     class="VPNavBar"
     :class="{
       'has-sidebar': hasSidebar,
+      'has-local-nav': !isHome && hasLocalNav,
       'home': isHome,
-      'top': y <= 0,
+      'top': isTop,
       'screen-open': isScreenOpen
     }"
   >
@@ -43,13 +54,16 @@ const { isHome, hasSidebar } = useLayout()
         </div>
 
         <div class="content">
-          <div class="content-body">
+          <div
+            class="content-body"
+            :ref="(el) => overflow.setContainerEl(el as HTMLElement | null)"
+          >
             <slot name="nav-bar-content-before" />
             <VPNavBarSearch class="search" />
-            <VPNavBarMenu class="menu" />
-            <VPNavBarTranslations class="translations" />
-            <VPNavBarAppearance class="appearance" />
-            <VPNavBarSocialLinks class="social-links" />
+            <VPNavMenu class="menu" />
+            <VPNavTranslations class="translations" />
+            <VPNavAppearance class="appearance" />
+            <VPNavSocialLinks class="social-links" />
             <VPNavBarExtra class="extra" />
             <slot name="nav-bar-content-after" />
             <VPNavBarHamburger
@@ -75,25 +89,68 @@ const { isHome, hasSidebar } = useLayout()
   height: var(--vp-nav-height);
   pointer-events: none;
   white-space: nowrap;
-  transition: background-color 0.25s;
+  /* left edge of the background surface and divider — on doc pages the
+     sidebar column paints its own surface up to this offset */
+  --vp-nav-col-offset: 0px;
 }
 
-.VPNavBar.screen-open {
-  transition: none;
+/* the single background surface — every state change below is color-only,
+   so nothing ever moves */
+.VPNavBar::before {
+  content: "";
+  position: absolute;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  left: var(--vp-nav-col-offset);
+  z-index: -1;
   background-color: var(--vp-nav-bg-color);
+  backdrop-filter: var(--vp-nav-backdrop-filter);
+  -webkit-backdrop-filter: var(--vp-nav-backdrop-filter);
+  transition: background-color 0.25s;
 }
 
-.VPNavBar:not(.home) {
-  background-color: var(--vp-nav-bg-color);
+/* below 60rem the bar scrolls with the page, so home stays transparent */
+.VPNavBar.home::before {
+  background-color: transparent;
 }
 
 @media (min-width: 60rem) {
-  .VPNavBar:not(.home) {
-    background-color: transparent;
+  .VPNavBar.home::before {
+    background-color: var(--vp-nav-bg-color);
   }
 
-  .VPNavBar:not(.has-sidebar):not(.home.top) {
-    background-color: var(--vp-nav-bg-color);
+  .VPNavBar.home.top::before {
+    background-color: var(--vp-nav-home-bg-color);
+    backdrop-filter: none;
+    -webkit-backdrop-filter: none;
+  }
+
+  .VPNavBar.has-sidebar {
+    --vp-nav-col-offset: var(--vp-sidebar-width);
+  }
+}
+
+@media (min-width: 90rem) {
+  .VPNavBar.has-sidebar {
+    --vp-nav-col-offset: calc(
+      (100% - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width)
+    );
+  }
+}
+
+.VPNavBar.screen-open::before {
+  transition: none;
+  background-color: var(--vp-nav-bg-color);
+}
+
+/* between 60rem and 80rem the local nav is pinned right under the bar and
+   its surface extends up behind it, carrying the paint for both bars */
+@media (60rem <= width < 80rem) {
+  .VPNavBar.has-local-nav::before {
+    background-color: transparent;
+    backdrop-filter: none;
+    -webkit-backdrop-filter: none;
   }
 }
 
@@ -107,12 +164,6 @@ const { isHome, hasSidebar } = useLayout()
   }
 }
 
-@media (min-width: 60rem) {
-  .VPNavBar.has-sidebar .wrapper {
-    padding: 0;
-  }
-}
-
 .container {
   display: flex;
   justify-content: space-between;
@@ -131,87 +182,67 @@ const { isHome, hasSidebar } = useLayout()
   pointer-events: auto;
 }
 
-@media (min-width: 60rem) {
-  .VPNavBar.has-sidebar .container {
-    max-width: 100%;
-  }
+.title {
+  /* below the overflow engine's range the title is the only shrinkable
+     piece, truncating instead of running over search and the hamburger */
+  min-width: 0;
 }
 
-.title {
-  flex-shrink: 0;
-  height: calc(var(--vp-nav-height) - 1px);
-  transition: background-color 0.5s;
+@media (min-width: 48rem) {
+  .title {
+    /* the overflow engine measures fixed occupancy around a rigid title */
+    flex-shrink: 0;
+  }
 }
 
 @media (min-width: 60rem) {
-  .VPNavBar.has-sidebar .title {
-    position: absolute;
-    top: 0;
-    left: 0;
-    z-index: 2;
-    padding: 0 2rem;
-    width: var(--vp-sidebar-width);
-    height: var(--vp-nav-height);
-    background-color: transparent;
+  /* outside home the title column matches the sidebar column, so search and
+     menu sit at the same spot on every doc page; on home the title keeps its
+     natural width and search sits right next to it */
+  .VPNavBar:not(.home) .title {
+    min-width: calc(var(--vp-sidebar-width) - 2rem);
   }
-}
 
-@media (min-width: 90rem) {
   .VPNavBar.has-sidebar .title {
-    padding-left: max(2rem, calc((100% - (var(--vp-layout-max-width) - 4rem)) / 2));
-    width: calc((100% - (var(--vp-layout-max-width) - 4rem)) / 2 + var(--vp-sidebar-width) - 2rem);
+    max-width: calc(var(--vp-sidebar-width) - 2rem);
   }
 }
 
 .content {
   flex-grow: 1;
+  /* below the engine's range the controls stay rigid and the title absorbs
+     all the shrink */
+  flex-shrink: 0;
 }
 
-@media (min-width: 60rem) {
-  .VPNavBar.has-sidebar .content {
-    position: relative;
-    z-index: 1;
-    padding-left: var(--vp-sidebar-width);
-    padding-right: 2rem;
-  }
-}
-
-@media (min-width: 90rem) {
-  .VPNavBar.has-sidebar .content {
-    padding-left: calc((100% - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width));
-    padding-right: calc((100% - var(--vp-layout-max-width)) / 2 + 2rem);
+@media (min-width: 48rem) {
+  .content {
+    flex-shrink: 1;
+    min-width: 0;
   }
 }
 
 .content-body {
+  position: relative;
   display: flex;
   justify-content: flex-end;
   align-items: center;
   height: var(--vp-nav-height);
-  transition: background-color 0.5s;
 }
 
-@media (min-width: 60rem) {
-  .VPNavBar:not(.home.top) .content-body {
-    position: relative;
-    background-color: var(--vp-nav-bg-color);
-  }
-
-  .VPNavBar:not(.has-sidebar):not(.home.top) .content-body {
-    background-color: transparent;
-  }
-
-  .content-body {
-    margin-right: -100vw;
-    padding-right: 100vw;
-  }
+/* collapsed into the `⋯` menu — kept mounted (hidden, out of the a11y tree
+   and tab order) so its natural width stays measurable */
+.content-body > .collapsed {
+  visibility: hidden;
+  position: absolute;
+  top: 0;
+  left: 0;
+  max-width: 100%;
+  overflow: hidden;
 }
 
-.menu + .translations::before,
-.menu + .appearance::before,
-.menu + .social-links::before,
-.translations + .appearance::before,
-.appearance + .social-links::before {
+/* separators between whichever cluster units are currently in the bar */
+.content-body > :where(.menu, .translations, .appearance, .social-links) + :where(.translations, .appearance, .social-links)::before {
   margin-right: 0.5rem;
   margin-left: 0.5rem;
   width: 1px;
@@ -220,12 +251,11 @@ const { isHome, hasSidebar } = useLayout()
   content: "";
 }
 
-.menu + .appearance::before,
-.translations + .appearance::before {
+.content-body > :where(.menu, .translations) + .appearance::before {
   margin-right: 1rem;
 }
 
-.appearance + .social-links::before {
+.content-body > .appearance + .social-links::before {
   margin-left: 1rem;
 }
 
@@ -234,20 +264,25 @@ const { isHome, hasSidebar } = useLayout()
 }
 
 .divider {
+  position: relative;
+  /* above the background surface, below the bar's content — an open flyout
+     panel overlaps the bar's bottom edge and must cover the rule */
+  z-index: -1;
   width: 100%;
   height: 1px;
+  padding-left: var(--vp-nav-col-offset);
 }
 
-@media (min-width: 60rem) {
-  .VPNavBar.has-sidebar .divider {
-    padding-left: var(--vp-sidebar-width);
-  }
-}
-
-@media (min-width: 90rem) {
-  .VPNavBar.has-sidebar .divider {
-    padding-left: calc((100% - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width));
-  }
+/* the sidebar-column segment of the bottom rule — inset from the column
+   edges so it lines up with the sidebar's own group dividers */
+.VPNavBar.has-sidebar .divider::before {
+  content: "";
+  position: absolute;
+  top: 0;
+  left: calc(var(--vp-nav-col-offset) - var(--vp-sidebar-width) + 2rem);
+  width: calc(var(--vp-sidebar-width) - 4rem);
+  height: 1px;
+  background-color: var(--vp-c-divider);
 }
 
 .divider-line {
@@ -257,20 +292,16 @@ const { isHome, hasSidebar } = useLayout()
 }
 
 .VPNavBar:not(.home) .divider-line {
-  background-color: var(--vp-c-gutter);
-}
-
-.VPNavBar.screen-open .divider-line {
-  background-color: var(--vp-c-divider);
+  background-color: var(--vp-nav-divider-color);
 }
 
 @media (min-width: 60rem) {
-  .divider-line {
-    transition: background-color 0.5s;
-  }
-
   .VPNavBar:not(.home.top) .divider-line {
-    background-color: var(--vp-c-gutter);
+    background-color: var(--vp-nav-divider-color);
   }
 }
+
+.VPNavBar.screen-open .divider-line {
+  background-color: var(--vp-c-divider);
+}
 </style>
diff --git a/src/client/theme-default/components/VPNavBarAppearance.vue b/src/client/theme-default/components/VPNavBarAppearance.vue
deleted file mode 100644
index 1691b52d..00000000
--- a/src/client/theme-default/components/VPNavBarAppearance.vue
+++ /dev/null
@@ -1,32 +0,0 @@
-<script lang="ts" setup>
-import { useData } from '../composables/data'
-import VPSwitchAppearance from './VPSwitchAppearance.vue'
-
-const { site } = useData()
-</script>
-
-<template>
-  <div
-    v-if="
-      site.appearance &&
-      site.appearance !== 'force-dark' &&
-      site.appearance !== 'force-auto'
-    "
-    class="VPNavBarAppearance"
-  >
-    <VPSwitchAppearance />
-  </div>
-</template>
-
-<style scoped>
-.VPNavBarAppearance {
-  display: none;
-}
-
-@media (min-width: 80rem) {
-  .VPNavBarAppearance {
-    display: flex;
-    align-items: center;
-  }
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavBarExtra.vue b/src/client/theme-default/components/VPNavBarExtra.vue
index 0e4cc1fa..dfaa4f9d 100644
--- a/src/client/theme-default/components/VPNavBarExtra.vue
+++ b/src/client/theme-default/components/VPNavBarExtra.vue
@@ -3,70 +3,84 @@ import { computed } from 'vue'
 
 import { useData } from '../composables/data'
 import { useLangs } from '../composables/langs'
+import { useAppearanceSwitch } from '../composables/nav'
+import { useNavOverflow } from '../composables/nav-overflow'
 import VPFlyout from './VPFlyout.vue'
+import VPMenuGroup from './VPMenuGroup.vue'
 import VPMenuLink from './VPMenuLink.vue'
+import VPNavAppearance from './VPNavAppearance.vue'
+import VPNavTranslations from './VPNavTranslations.vue'
 import VPSocialLinks from './VPSocialLinks.vue'
-import VPSwitchAppearance from './VPSwitchAppearance.vue'
 
-const { site, theme } = useData()
+const { theme } = useData()
 const { localeLinks, currentLang } = useLangs({
   linkToCorrespondingPage: true
 })
+const hasAppearanceSwitch = useAppearanceSwitch()
 
-const hasExtraContent = computed(
+const overflow = useNavOverflow()
+
+// nav items the priority+ engine pushed out of the bar (contiguous suffix)
+const overflowItems = computed(() => {
+  const count = overflow?.state.visibleItemCount ?? Infinity
+  if (count === Infinity || !theme.value.nav) return []
+  return theme.value.nav.slice(count)
+})
+
+const showTranslations = computed(
   () =>
-    (localeLinks.value.length && currentLang.value.label) ||
-    site.value.appearance ||
-    theme.value.socialLinks
+    !!(localeLinks.value.length && currentLang.value.label) &&
+    !(overflow?.state.translations ?? true)
+)
+
+const showAppearance = computed(
+  () => hasAppearanceSwitch.value && !(overflow?.state.appearance ?? true)
+)
+
+const showSocialLinks = computed(
+  () => !!theme.value.socialLinks && !(overflow?.state.socialLinks ?? true)
+)
+
+const hasContent = computed(
+  () =>
+    overflowItems.value.length > 0 ||
+    showTranslations.value ||
+    showAppearance.value ||
+    showSocialLinks.value
 )
 </script>
 
 <template>
   <VPFlyout
-    v-if="hasExtraContent"
+    v-if="hasContent"
     class="VPNavBarExtra"
-    label="extra navigation"
+    :label="theme.extraMenuLabel || 'More options'"
+    :ref="(inst: any) => overflow?.setExtraEl(inst?.$el ?? null)"
   >
-    <ul
-      v-if="localeLinks.length && currentLang.label"
-      class="group translations"
-    >
-      <li class="trans-title">{{ currentLang.label }}</li>
-
-      <template v-for="locale in localeLinks" :key="locale.link">
-        <VPMenuLink
-          :item="locale"
-          :external="false"
-          :lang="locale.lang"
-          :hreflang="locale.lang"
-          rel="alternate"
-          :dir="locale.dir"
-          data-allow-mismatch="attribute"
+    <ul v-if="overflowItems.length" class="group overflow-items">
+      <template v-for="item in overflowItems" :key="JSON.stringify(item)">
+        <VPMenuLink v-if="'link' in item" :item />
+        <!-- a menu panel is a vertical list context — components must
+             render a flat list here, not a nested floating flyout -->
+        <component
+          v-else-if="'component' in item"
+          :is="item.component"
+          v-bind="item.props"
+          menu
         />
+        <VPMenuGroup v-else :text="item.text" :items="item.items" />
       </template>
     </ul>
 
-    <div
-      v-if="
-        site.appearance &&
-        site.appearance !== 'force-dark' &&
-        site.appearance !== 'force-auto'
-      "
-      class="group"
-    >
-      <div class="item appearance">
-        <p class="label">
-          {{ theme.darkModeSwitchLabel || 'Appearance' }}
-        </p>
-        <div class="appearance-action">
-          <VPSwitchAppearance />
-        </div>
-      </div>
+    <VPNavTranslations v-if="showTranslations" menu />
+
+    <div v-if="showAppearance" class="group">
+      <VPNavAppearance row />
     </div>
 
-    <div v-if="theme.socialLinks" class="group">
+    <div v-if="showSocialLinks" class="group">
       <div class="item social-links">
-        <VPSocialLinks class="social-links-list" :links="theme.socialLinks" />
+        <VPSocialLinks class="social-links-list" :links="theme.socialLinks!" />
       </div>
     </div>
   </VPFlyout>
@@ -84,35 +98,12 @@ const hasExtraContent = computed(
   }
 }
 
-@media (min-width: 80rem) {
-  .VPNavBarExtra {
-    display: none;
-  }
-}
-
-.trans-title {
-  padding: 0 1.5rem 0 0.75rem;
-  line-height: 2.2857143;
-  font-size: 0.875rem;
-  font-weight: 700;
-  color: var(--vp-c-text-1);
-}
-
-.item.appearance,
 .item.social-links {
   display: flex;
   align-items: center;
   padding: 0 0.75rem;
 }
 
-.item.appearance {
-  min-width: 11rem;
-}
-
-.appearance-action {
-  margin-right: -0.125rem;
-}
-
 .social-links-list {
   margin: -0.25rem -0.5rem;
 }
diff --git a/src/client/theme-default/components/VPNavBarHamburger.vue b/src/client/theme-default/components/VPNavBarHamburger.vue
index 9632d80d..ef06a4e7 100644
--- a/src/client/theme-default/components/VPNavBarHamburger.vue
+++ b/src/client/theme-default/components/VPNavBarHamburger.vue
@@ -1,4 +1,9 @@
 <script lang="ts" setup>
+import { useTemplateRef, watchEffect } from 'vue'
+
+import { useData } from '../composables/data'
+import { useNav } from '../composables/nav'
+
 defineProps<{
   active: boolean
 }>()
@@ -6,19 +11,29 @@ defineProps<{
 defineEmits<{
   (e: 'click'): void
 }>()
+
+const { theme } = useData()
+
+// register as the screen's trigger so Escape can return focus here
+const el = useTemplateRef('el')
+const { screenTriggerEl } = useNav()
+
+watchEffect(() => {
+  screenTriggerEl.value = el.value
+})
 </script>
 
 <template>
   <button
+    ref="el"
     type="button"
     class="VPNavBarHamburger"
     :class="{ active }"
-    aria-label="mobile navigation"
+    :aria-label="theme.mobileMenuLabel || 'Menu'"
     :aria-expanded="active"
-    aria-controls="VPNavScreen"
     @click="$emit('click')"
   >
-    <span class="container">
+    <span class="container" aria-hidden="true">
       <span class="top" />
       <span class="middle" />
       <span class="bottom" />
diff --git a/src/client/theme-default/components/VPNavBarMenu.vue b/src/client/theme-default/components/VPNavBarMenu.vue
deleted file mode 100644
index cab2a133..00000000
--- a/src/client/theme-default/components/VPNavBarMenu.vue
+++ /dev/null
@@ -1,46 +0,0 @@
-<script lang="ts" setup>
-import { useData } from '../composables/data'
-import VPNavBarMenuGroup from './VPNavBarMenuGroup.vue'
-import VPNavBarMenuLink from './VPNavBarMenuLink.vue'
-
-const { theme } = useData()
-</script>
-
-<template>
-  <nav
-    v-if="theme.nav"
-    aria-labelledby="main-nav-aria-label"
-    class="VPNavBarMenu"
-  >
-    <span id="main-nav-aria-label" class="visually-hidden">
-      Main Navigation
-    </span>
-    <ul class="list">
-      <li v-for="item in theme.nav" :key="JSON.stringify(item)">
-        <VPNavBarMenuLink v-if="'link' in item" :item />
-        <component
-          v-else-if="'component' in item"
-          :is="item.component"
-          v-bind="item.props"
-        />
-        <VPNavBarMenuGroup v-else :item />
-      </li>
-    </ul>
-  </nav>
-</template>
-
-<style scoped>
-.VPNavBarMenu {
-  display: none;
-}
-
-.list {
-  display: flex;
-}
-
-@media (min-width: 48rem) {
-  .VPNavBarMenu {
-    display: block;
-  }
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavBarMenuGroup.vue b/src/client/theme-default/components/VPNavBarMenuGroup.vue
deleted file mode 100644
index b26cfdf2..00000000
--- a/src/client/theme-default/components/VPNavBarMenuGroup.vue
+++ /dev/null
@@ -1,54 +0,0 @@
-<script lang="ts" setup>
-import { useRoute } from 'vitepress'
-import type { DefaultTheme } from 'vitepress/theme'
-import { computed } from 'vue'
-
-import { isActive } from '../../shared'
-import VPFlyout from './VPFlyout.vue'
-
-const props = defineProps<{
-  item: DefaultTheme.NavItemWithChildren
-}>()
-
-const route = useRoute()
-
-const isActiveGroup = computed(() => {
-  if (props.item.activeMatch) {
-    return isActive(
-      route.data.relativePath,
-      route.hash,
-      props.item.activeMatch,
-      true
-    )
-  }
-  return isChildActive(props.item)
-})
-
-function isChildActive(navItem: DefaultTheme.NavItem): boolean {
-  if ('component' in navItem) return false
-
-  if ('link' in navItem) {
-    const href =
-      typeof navItem.link === 'function'
-        ? navItem.link(route.data)
-        : navItem.link
-
-    return isActive(
-      route.data.relativePath,
-      route.hash,
-      navItem.activeMatch || href,
-      !!navItem.activeMatch
-    )
-  }
-
-  return navItem.items.some(isChildActive)
-}
-</script>
-
-<template>
-  <VPFlyout
-    :class="{ VPNavBarMenuGroup: true, active: isActiveGroup }"
-    :button="item.text"
-    :items="item.items"
-  />
-</template>
diff --git a/src/client/theme-default/components/VPNavBarMenuLink.vue b/src/client/theme-default/components/VPNavBarMenuLink.vue
deleted file mode 100644
index 451359c1..00000000
--- a/src/client/theme-default/components/VPNavBarMenuLink.vue
+++ /dev/null
@@ -1,47 +0,0 @@
-<script lang="ts" setup>
-import type { DefaultTheme } from 'vitepress/theme'
-
-import { useNavItemLink } from '../composables/nav'
-import VPLink from './VPLink.vue'
-
-const props = defineProps<{
-  item: DefaultTheme.NavItemWithLink
-}>()
-
-const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
-</script>
-
-<template>
-  <VPLink
-    :class="{ VPNavBarMenuLink: true, active: isActiveLink }"
-    :aria-current="isCurrentLink ? 'page' : undefined"
-    :href
-    :target="item.target"
-    :rel="item.rel"
-    :no-icon="item.noIcon"
-    tabindex="0"
-  >
-    <span v-html="item.text"></span>
-  </VPLink>
-</template>
-
-<style scoped>
-.VPNavBarMenuLink {
-  display: flex;
-  align-items: center;
-  padding: 0 0.75rem;
-  line-height: var(--vp-nav-height);
-  font-size: 0.875rem;
-  font-weight: 500;
-  color: var(--vp-c-text-1);
-  transition: color 0.25s;
-}
-
-.VPNavBarMenuLink.active {
-  color: var(--vp-c-brand-1);
-}
-
-.VPNavBarMenuLink:hover {
-  color: var(--vp-c-brand-1);
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavBarSearch.vue b/src/client/theme-default/components/VPNavBarSearch.vue
index 4205f6ea..1fe94891 100644
--- a/src/client/theme-default/components/VPNavBarSearch.vue
+++ b/src/client/theme-default/components/VPNavBarSearch.vue
@@ -204,7 +204,6 @@ function isEditingContent(event: KeyboardEvent): boolean {
 @media (min-width: 48rem) {
   .VPNavBarSearch {
     gap: 0.5rem;
-    flex-grow: 1;
     padding-left: 1.5rem;
   }
 }
diff --git a/src/client/theme-default/components/VPNavBarSocialLinks.vue b/src/client/theme-default/components/VPNavBarSocialLinks.vue
deleted file mode 100644
index 4209e2b0..00000000
--- a/src/client/theme-default/components/VPNavBarSocialLinks.vue
+++ /dev/null
@@ -1,27 +0,0 @@
-<script lang="ts" setup>
-import { useData } from '../composables/data'
-import VPSocialLinks from './VPSocialLinks.vue'
-
-const { theme } = useData()
-</script>
-
-<template>
-  <VPSocialLinks
-    v-if="theme.socialLinks"
-    class="VPNavBarSocialLinks"
-    :links="theme.socialLinks"
-  />
-</template>
-
-<style scoped>
-.VPNavBarSocialLinks {
-  display: none;
-}
-
-@media (min-width: 80rem) {
-  .VPNavBarSocialLinks {
-    display: flex;
-    align-items: center;
-  }
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavBarTitle.vue b/src/client/theme-default/components/VPNavBarTitle.vue
index 53b8f53d..35ce1067 100644
--- a/src/client/theme-default/components/VPNavBarTitle.vue
+++ b/src/client/theme-default/components/VPNavBarTitle.vue
@@ -28,6 +28,14 @@ const target = computed(() =>
     ? undefined
     : theme.value.logoLink?.target
 )
+
+// plain-text form of the rendered title (`siteTitle` may contain HTML),
+// surfaced as a native tooltip since the sidebar column truncates it
+const textTitle = computed(() => {
+  if (theme.value.siteTitle === false) return undefined
+  const raw = theme.value.siteTitle ?? site.value.title
+  return raw.replace(/<[^>]+>/g, '').trim() || undefined
+})
 </script>
 
 <template>
@@ -37,6 +45,7 @@ const target = computed(() =>
       :href="link ?? normalizeLink(currentLang.link)"
       :rel
       :target
+      :title="textTitle"
     >
       <slot name="nav-bar-title-before" />
       <VPImage v-if="theme.logo" class="logo" :image="theme.logo" />
@@ -51,7 +60,6 @@ const target = computed(() =>
 .title {
   display: flex;
   align-items: center;
-  border-bottom: 1px solid transparent;
   width: 100%;
   height: var(--vp-nav-height);
   font-size: 1rem;
@@ -60,17 +68,27 @@ const target = computed(() =>
   transition: opacity 0.25s;
 }
 
+/* wherever the bar runs out of room, the title text gives way first */
+.title > span {
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 @media (min-width: 60rem) {
   .title {
     flex-shrink: 0;
   }
 
-  .VPNavBarTitle.has-sidebar .title {
-    border-bottom-color: var(--vp-c-divider);
+  /* the sidebar column has a fixed width — truncate at the divider
+     segment's edge (2rem inset from the column); the outer column box
+     keeps its full reserved width */
+  .VPNavBarTitle.has-sidebar {
+    max-width: calc(var(--vp-sidebar-width) - 4rem);
   }
 }
 
 :deep(.logo) {
+  flex: none;
   margin-right: 0.5rem;
   height: var(--vp-nav-logo-height);
 }
diff --git a/src/client/theme-default/components/VPNavBarTranslations.vue b/src/client/theme-default/components/VPNavBarTranslations.vue
deleted file mode 100644
index 45704f52..00000000
--- a/src/client/theme-default/components/VPNavBarTranslations.vue
+++ /dev/null
@@ -1,57 +0,0 @@
-<script lang="ts" setup>
-import { useData } from '../composables/data'
-import { useLangs } from '../composables/langs'
-import VPFlyout from './VPFlyout.vue'
-import VPMenuLink from './VPMenuLink.vue'
-
-const { theme } = useData()
-const { localeLinks, currentLang } = useLangs({
-  linkToCorrespondingPage: true
-})
-</script>
-
-<template>
-  <VPFlyout
-    v-if="localeLinks.length && currentLang.label"
-    class="VPNavBarTranslations"
-    icon="vpi-languages"
-    :label="theme.langMenuLabel || 'Change language'"
-  >
-    <ul class="items">
-      <li class="title">{{ currentLang.label }}</li>
-
-      <template v-for="locale in localeLinks" :key="locale.link">
-        <VPMenuLink
-          :item="locale"
-          :external="false"
-          :lang="locale.lang"
-          :hreflang="locale.lang"
-          rel="alternate"
-          :dir="locale.dir"
-          data-allow-mismatch="attribute"
-        />
-      </template>
-    </ul>
-  </VPFlyout>
-</template>
-
-<style scoped>
-.VPNavBarTranslations {
-  display: none;
-}
-
-@media (min-width: 80rem) {
-  .VPNavBarTranslations {
-    display: flex;
-    align-items: center;
-  }
-}
-
-.title {
-  padding: 0 1.5rem 0 0.75rem;
-  line-height: 2.2857143;
-  font-size: 0.875rem;
-  font-weight: 700;
-  color: var(--vp-c-text-1);
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavMenu.vue b/src/client/theme-default/components/VPNavMenu.vue
new file mode 100644
index 00000000..4e3bd40c
--- /dev/null
+++ b/src/client/theme-default/components/VPNavMenu.vue
@@ -0,0 +1,79 @@
+<script lang="ts" setup>
+import { useData } from '../composables/data'
+import { useNavOverflow } from '../composables/nav-overflow'
+import VPNavMenuGroup from './VPNavMenuGroup.vue'
+import VPNavMenuLink from './VPNavMenuLink.vue'
+
+const props = defineProps<{
+  screen?: boolean
+}>()
+
+const { theme } = useData()
+
+// bar only — inside the screen every item is always shown
+const overflow = props.screen ? null : useNavOverflow()
+
+function isVisible(index: number) {
+  return !overflow || index < overflow.state.visibleItemCount
+}
+</script>
+
+<template>
+  <nav
+    v-if="theme.nav"
+    :aria-label="theme.navMenuLabel || 'Main Navigation'"
+    class="VPNavMenu"
+    :class="screen ? 'VPNavScreenMenu' : 'VPNavBarMenu'"
+    :ref="(el) => overflow?.setMenuEl(el as HTMLElement | null)"
+  >
+    <ul class="list">
+      <li
+        v-for="(item, index) in theme.nav"
+        :key="JSON.stringify(item)"
+        :class="{ collapsed: !isVisible(index) }"
+        :ref="(el) => overflow?.setItemEl(index, el as HTMLElement | null)"
+      >
+        <VPNavMenuLink v-if="'link' in item" :item :screen />
+        <component
+          v-else-if="'component' in item"
+          :is="item.component"
+          v-bind="item.props"
+          :screen-menu="screen || undefined"
+        />
+        <VPNavMenuGroup v-else :item :screen />
+      </li>
+    </ul>
+  </nav>
+</template>
+
+<style scoped>
+.VPNavBarMenu {
+  position: relative;
+  display: none;
+  min-width: 0;
+}
+
+.VPNavBarMenu .list {
+  display: flex;
+  justify-content: flex-end;
+}
+
+/* collapsed into the `⋯` menu — kept mounted (hidden, out of the a11y tree
+   and tab order) so its natural width stays measurable */
+.VPNavBarMenu .list > li.collapsed {
+  visibility: hidden;
+  position: absolute;
+  top: 0;
+  left: 0;
+  max-width: 100%;
+  overflow: hidden;
+}
+
+@media (min-width: 48rem) {
+  .VPNavBarMenu {
+    display: flex;
+    flex-grow: 1;
+    justify-content: flex-end;
+  }
+}
+</style>
diff --git a/src/client/theme-default/components/VPNavMenuGroup.vue b/src/client/theme-default/components/VPNavMenuGroup.vue
new file mode 100644
index 00000000..63a9d1ae
--- /dev/null
+++ b/src/client/theme-default/components/VPNavMenuGroup.vue
@@ -0,0 +1,150 @@
+<script lang="ts" setup>
+import { useRoute } from 'vitepress'
+import type { DefaultTheme } from 'vitepress/theme'
+import { computed, ref, useId } from 'vue'
+
+import { isActive } from '../../shared'
+import VPFlyout from './VPFlyout.vue'
+import VPMenuGroup from './VPMenuGroup.vue'
+import VPMenuLink from './VPMenuLink.vue'
+
+const props = defineProps<{
+  item: DefaultTheme.NavItemWithChildren
+  /** accordion inside the nav screen */
+  screen?: boolean
+  /** flat titled group inside a menu panel (e.g. the `⋯` menu) */
+  menu?: boolean
+}>()
+
+const route = useRoute()
+
+const isActiveGroup = computed(() => {
+  if (props.item.activeMatch) {
+    return isActive(
+      route.data.relativePath,
+      route.hash,
+      props.item.activeMatch,
+      true
+    )
+  }
+  return isChildActive(props.item)
+})
+
+function isChildActive(navItem: DefaultTheme.NavItem): boolean {
+  if ('component' in navItem) return false
+
+  if ('link' in navItem) {
+    const href =
+      typeof navItem.link === 'function'
+        ? navItem.link(route.data)
+        : navItem.link
+
+    return isActive(
+      route.data.relativePath,
+      route.hash,
+      navItem.activeMatch || href,
+      !!navItem.activeMatch
+    )
+  }
+
+  return navItem.items.some(isChildActive)
+}
+
+// screen accordion state — resets when the screen unmounts
+const isOpen = ref(false)
+const groupId = useId()
+
+function toggle() {
+  isOpen.value = !isOpen.value
+}
+</script>
+
+<template>
+  <VPMenuGroup
+    v-if="menu"
+    class="VPNavMenuGroup"
+    :text="item.text"
+    :items="item.items"
+  />
+
+  <VPFlyout
+    v-else-if="!screen"
+    :class="{ VPNavMenuGroup: true, VPNavBarMenuGroup: true, active: isActiveGroup }"
+    :button="item.text"
+    :items="item.items"
+  />
+
+  <div
+    v-else
+    class="VPNavMenuGroup VPNavScreenMenuGroup"
+    :class="{ open: isOpen, active: isActiveGroup }"
+  >
+    <button
+      type="button"
+      class="button"
+      :aria-expanded="isOpen"
+      :aria-controls="groupId"
+      @click="toggle"
+    >
+      <span class="button-text" v-html="item.text"></span>
+      <span class="vpi-plus button-icon" aria-hidden="true" />
+    </button>
+
+    <ul v-show="isOpen" :id="groupId" class="items">
+      <template v-for="child in item.items" :key="JSON.stringify(child)">
+        <VPMenuLink v-if="'link' in child" :item="child" />
+        <li v-else-if="'component' in child">
+          <component :is="child.component" v-bind="child.props" screen-menu />
+        </li>
+        <VPMenuGroup v-else :text="child.text" :items="child.items" />
+      </template>
+    </ul>
+  </div>
+</template>
+
+<style scoped>
+.VPNavScreenMenuGroup {
+  border-bottom: 1px solid var(--vp-c-divider);
+  transition: border-color 0.5s;
+}
+
+.VPNavScreenMenuGroup.open {
+  padding-bottom: 0.625rem;
+}
+
+.VPNavScreenMenuGroup.open .button {
+  padding-bottom: 0.375rem;
+  color: var(--vp-c-brand-1);
+}
+
+.VPNavScreenMenuGroup.open .button-icon {
+  /*rtl:ignore*/
+  transform: rotate(45deg);
+}
+
+.button {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 0.75rem 0.25rem 0.6875rem 0;
+  width: 100%;
+  line-height: 1.7142857;
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--vp-c-text-1);
+  transition: color 0.25s;
+}
+
+.button:hover,
+.VPNavScreenMenuGroup.active .button {
+  color: var(--vp-c-brand-1);
+}
+
+.button-icon {
+  transition: transform 0.25s;
+}
+
+.items :deep(.VPMenuGroup) {
+  padding-top: 0.25rem;
+}
+</style>
diff --git a/src/client/theme-default/components/VPNavScreenMenuLink.vue b/src/client/theme-default/components/VPNavMenuLink.vue
similarity index 64%
rename from src/client/theme-default/components/VPNavScreenMenuLink.vue
rename to src/client/theme-default/components/VPNavMenuLink.vue
index 647eaef1..4fb1fae3 100644
--- a/src/client/theme-default/components/VPNavScreenMenuLink.vue
+++ b/src/client/theme-default/components/VPNavMenuLink.vue
@@ -7,44 +7,63 @@ import VPLink from './VPLink.vue'
 
 const props = defineProps<{
   item: DefaultTheme.NavItemWithLink
+  screen?: boolean
 }>()
 
 const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
 
-const { closeScreen } = inject(navInjectionKey)!
+const nav = inject(navInjectionKey, null)
+
+function onClick() {
+  if (props.screen) nav?.closeScreen()
+}
 </script>
 
 <template>
   <VPLink
-    :class="{ VPNavScreenMenuLink: true, active: isActiveLink }"
+    class="VPNavMenuLink"
+    :class="{
+      VPNavBarMenuLink: !screen,
+      VPNavScreenMenuLink: screen,
+      active: isActiveLink
+    }"
     :aria-current="isCurrentLink ? 'page' : undefined"
     :href
     :target="item.target"
     :rel="item.rel"
     :no-icon="item.noIcon"
-    @click="closeScreen"
+    @click="onClick"
   >
     <span v-html="item.text"></span>
   </VPLink>
 </template>
 
 <style scoped>
-.VPNavScreenMenuLink {
-  display: block;
-  border-bottom: 1px solid var(--vp-c-divider);
-  padding: 0.75rem 0 0.6875rem;
-  line-height: 1.7142857;
+.VPNavMenuLink {
+  color: var(--vp-c-text-1);
   font-size: 0.875rem;
   font-weight: 500;
-  color: var(--vp-c-text-1);
-  transition: border-color 0.25s, color 0.25s;
+  transition: color 0.25s;
 }
 
-.VPNavScreenMenuLink:hover {
+.VPNavMenuLink:hover,
+.VPNavMenuLink.active {
   color: var(--vp-c-brand-1);
 }
 
-.VPNavScreenMenuLink.active {
-  color: var(--vp-c-brand-1);
+.VPNavBarMenuLink {
+  display: flex;
+  align-items: center;
+  min-height: var(--vp-nav-height);
+  padding: 0 0.75rem;
+  line-height: 1.5;
+}
+
+.VPNavScreenMenuLink {
+  display: block;
+  border-bottom: 1px solid var(--vp-c-divider);
+  padding: 0.75rem 0 0.6875rem;
+  line-height: 1.7142857;
+  transition: border-color 0.25s, color 0.25s;
 }
 </style>
diff --git a/src/client/theme-default/components/VPNavScreen.vue b/src/client/theme-default/components/VPNavScreen.vue
index 0b114dfe..4ae3ff15 100644
--- a/src/client/theme-default/components/VPNavScreen.vue
+++ b/src/client/theme-default/components/VPNavScreen.vue
@@ -1,15 +1,29 @@
 <script setup lang="ts">
+import { onKeyStroke } from '@vueuse/core'
+import { provide } from 'vue'
+
+import { navScreenInjectionKey, useNav } from '../composables/nav'
 import { useBodyScrollLock } from '../composables/scroll-lock'
-import VPNavScreenAppearance from './VPNavScreenAppearance.vue'
-import VPNavScreenMenu from './VPNavScreenMenu.vue'
-import VPNavScreenSocialLinks from './VPNavScreenSocialLinks.vue'
-import VPNavScreenTranslations from './VPNavScreenTranslations.vue'
+import VPNavAppearance from './VPNavAppearance.vue'
+import VPNavMenu from './VPNavMenu.vue'
+import VPNavSocialLinks from './VPNavSocialLinks.vue'
+import VPNavTranslations from './VPNavTranslations.vue'
 
-defineProps<{
+const props = defineProps<{
   open: boolean
 }>()
 
 const isLocked = useBodyScrollLock()
+
+provide(navScreenInjectionKey, true)
+
+const { closeScreen, screenTriggerEl } = useNav()
+
+onKeyStroke('Escape', () => {
+  if (!props.open) return
+  closeScreen()
+  screenTriggerEl.value?.focus()
+})
 </script>
 
 <template>
@@ -21,10 +35,10 @@ const isLocked = useBodyScrollLock()
     <div v-if="open" class="VPNavScreen" id="VPNavScreen">
       <div class="container">
         <slot name="nav-screen-content-before" />
-        <VPNavScreenMenu class="menu" />
-        <VPNavScreenTranslations class="translations" />
-        <VPNavScreenAppearance class="appearance" />
-        <VPNavScreenSocialLinks class="social-links" />
+        <VPNavMenu screen class="menu" />
+        <VPNavTranslations screen class="translations" />
+        <VPNavAppearance row screen class="appearance" />
+        <VPNavSocialLinks screen class="social-links" />
         <slot name="nav-screen-content-after" />
       </div>
     </div>
diff --git a/src/client/theme-default/components/VPNavScreenAppearance.vue b/src/client/theme-default/components/VPNavScreenAppearance.vue
deleted file mode 100644
index 76c68bdb..00000000
--- a/src/client/theme-default/components/VPNavScreenAppearance.vue
+++ /dev/null
@@ -1,40 +0,0 @@
-<script lang="ts" setup>
-import { useData } from '../composables/data'
-import VPSwitchAppearance from './VPSwitchAppearance.vue'
-
-const { site, theme } = useData()
-</script>
-
-<template>
-  <div
-    v-if="
-      site.appearance &&
-      site.appearance !== 'force-dark' &&
-      site.appearance !== 'force-auto'
-    "
-    class="VPNavScreenAppearance"
-  >
-    <p class="text">
-      {{ theme.darkModeSwitchLabel || 'Appearance' }}
-    </p>
-    <VPSwitchAppearance />
-  </div>
-</template>
-
-<style scoped>
-.VPNavScreenAppearance {
-  display: flex;
-  justify-content: space-between;
-  align-items: center;
-  border-radius: 0.5rem;
-  padding: 0.75rem 0.875rem 0.75rem 1rem;
-  background-color: var(--vp-c-bg-soft);
-}
-
-.text {
-  line-height: 2;
-  font-size: 0.75rem;
-  font-weight: 500;
-  color: var(--vp-c-text-2);
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavScreenMenu.vue b/src/client/theme-default/components/VPNavScreenMenu.vue
deleted file mode 100644
index 8fa72da2..00000000
--- a/src/client/theme-default/components/VPNavScreenMenu.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-<script lang="ts" setup>
-import { useData } from '../composables/data'
-import VPNavScreenMenuGroup from './VPNavScreenMenuGroup.vue'
-import VPNavScreenMenuLink from './VPNavScreenMenuLink.vue'
-
-const { theme } = useData()
-</script>
-
-<template>
-  <nav v-if="theme.nav" class="VPNavScreenMenu">
-    <ul>
-      <li v-for="item in theme.nav" :key="JSON.stringify(item)">
-        <VPNavScreenMenuLink v-if="'link' in item" :item />
-        <component
-          v-else-if="'component' in item"
-          :is="item.component"
-          v-bind="item.props"
-          screen-menu
-        />
-        <VPNavScreenMenuGroup
-          v-else
-          :text="item.text || ''"
-          :items="item.items"
-        />
-      </li>
-    </ul>
-  </nav>
-</template>
diff --git a/src/client/theme-default/components/VPNavScreenMenuGroup.vue b/src/client/theme-default/components/VPNavScreenMenuGroup.vue
deleted file mode 100644
index f45f9a92..00000000
--- a/src/client/theme-default/components/VPNavScreenMenuGroup.vue
+++ /dev/null
@@ -1,113 +0,0 @@
-<script lang="ts" setup>
-import { computed, ref } from 'vue'
-
-import VPNavScreenMenuGroupLink from './VPNavScreenMenuGroupLink.vue'
-import VPNavScreenMenuGroupSection from './VPNavScreenMenuGroupSection.vue'
-
-const props = defineProps<{
-  text: string
-  items: any[]
-}>()
-
-const isOpen = ref(false)
-
-const groupId = computed(
-  () => `NavScreenGroup-${props.text.replace(' ', '-').toLowerCase()}`
-)
-
-function toggle() {
-  isOpen.value = !isOpen.value
-}
-</script>
-
-<template>
-  <div class="VPNavScreenMenuGroup" :class="{ open: isOpen }">
-    <button
-      class="button"
-      :aria-controls="groupId"
-      :aria-expanded="isOpen"
-      @click="toggle"
-    >
-      <span class="button-text" v-html="text"></span>
-      <span class="vpi-plus button-icon" />
-    </button>
-
-    <ul :id="groupId" class="items">
-      <li v-for="item in items" :key="JSON.stringify(item)">
-        <div v-if="'link' in item" class="item">
-          <VPNavScreenMenuGroupLink :item />
-        </div>
-
-        <div v-else-if="'component' in item" class="item">
-          <component :is="item.component" v-bind="item.props" screen-menu />
-        </div>
-
-        <div v-else class="group">
-          <VPNavScreenMenuGroupSection :text="item.text" :items="item.items" />
-        </div>
-      </li>
-    </ul>
-  </div>
-</template>
-
-<style scoped>
-.VPNavScreenMenuGroup {
-  border-bottom: 1px solid var(--vp-c-divider);
-  height: 3rem;
-  overflow: hidden;
-  transition: border-color 0.5s;
-}
-
-.VPNavScreenMenuGroup .items {
-  visibility: hidden;
-}
-
-.VPNavScreenMenuGroup.open .items {
-  visibility: visible;
-}
-
-.VPNavScreenMenuGroup.open {
-  padding-bottom: 0.625rem;
-  height: auto;
-}
-
-.VPNavScreenMenuGroup.open .button {
-  padding-bottom: 0.375rem;
-  color: var(--vp-c-brand-1);
-}
-
-.VPNavScreenMenuGroup.open .button-icon {
-  /*rtl:ignore*/
-  transform: rotate(45deg);
-}
-
-.button {
-  display: flex;
-  justify-content: space-between;
-  align-items: center;
-  padding: 0.75rem 0.25rem 0.6875rem 0;
-  width: 100%;
-  line-height: 1.7142857;
-  font-size: 0.875rem;
-  font-weight: 500;
-  color: var(--vp-c-text-1);
-  transition: color 0.25s;
-}
-
-.button:hover {
-  color: var(--vp-c-brand-1);
-}
-
-.button-icon {
-  transition: transform 0.25s;
-}
-
-.group:first-child {
-  padding-top: 0px;
-}
-
-.group + .group,
-.group + .item {
-  padding-top: 0.25rem;
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue b/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
deleted file mode 100644
index 351b7328..00000000
--- a/src/client/theme-default/components/VPNavScreenMenuGroupLink.vue
+++ /dev/null
@@ -1,49 +0,0 @@
-<script lang="ts" setup>
-import type { DefaultTheme } from 'vitepress/theme'
-import { inject } from 'vue'
-
-import { navInjectionKey, useNavItemLink } from '../composables/nav'
-import VPLink from './VPLink.vue'
-
-const props = defineProps<{
-  item: DefaultTheme.NavItemWithLink
-}>()
-
-const { href, isActiveLink, isCurrentLink } = useNavItemLink(() => props.item)
-
-const { closeScreen } = inject(navInjectionKey)!
-</script>
-
-<template>
-  <VPLink
-    :class="{ VPNavScreenMenuGroupLink: true, active: isActiveLink }"
-    :aria-current="isCurrentLink ? 'page' : undefined"
-    :href
-    :target="item.target"
-    :rel="item.rel"
-    :no-icon="item.noIcon"
-    @click="closeScreen"
-  >
-    <span v-html="item.text"></span>
-  </VPLink>
-</template>
-
-<style scoped>
-.VPNavScreenMenuGroupLink {
-  display: block;
-  margin-left: 0.75rem;
-  line-height: 2.2857143;
-  font-size: 0.875rem;
-  font-weight: 400;
-  color: var(--vp-c-text-1);
-  transition: color 0.25s;
-}
-
-.VPNavScreenMenuGroupLink:hover {
-  color: var(--vp-c-brand-1);
-}
-
-.VPNavScreenMenuGroupLink.active {
-  color: var(--vp-c-brand-1);
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavScreenMenuGroupSection.vue b/src/client/theme-default/components/VPNavScreenMenuGroupSection.vue
deleted file mode 100644
index 1ad55857..00000000
--- a/src/client/theme-default/components/VPNavScreenMenuGroupSection.vue
+++ /dev/null
@@ -1,35 +0,0 @@
-<script lang="ts" setup>
-import type { DefaultTheme } from 'vitepress/theme'
-
-import VPNavScreenMenuGroupLink from './VPNavScreenMenuGroupLink.vue'
-
-defineProps<{
-  text?: string
-  items: DefaultTheme.NavItemWithLink[]
-}>()
-</script>
-
-<template>
-  <div class="VPNavScreenMenuGroupSection">
-    <p v-if="text" class="title">{{ text }}</p>
-    <ul>
-      <li v-for="item in items" :key="item.text">
-        <VPNavScreenMenuGroupLink :item="item" />
-      </li>
-    </ul>
-  </div>
-</template>
-
-<style scoped>
-.VPNavScreenMenuGroupSection {
-  display: block;
-}
-
-.title {
-  line-height: 2.4615385;
-  font-size: 0.8125rem;
-  font-weight: 700;
-  color: var(--vp-c-text-2);
-  transition: color 0.25s;
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavScreenSocialLinks.vue b/src/client/theme-default/components/VPNavScreenSocialLinks.vue
deleted file mode 100644
index 9102d387..00000000
--- a/src/client/theme-default/components/VPNavScreenSocialLinks.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<script lang="ts" setup>
-import { useData } from '../composables/data'
-import VPSocialLinks from './VPSocialLinks.vue'
-
-const { theme } = useData()
-</script>
-
-<template>
-  <VPSocialLinks
-    v-if="theme.socialLinks"
-    class="VPNavScreenSocialLinks"
-    :links="theme.socialLinks"
-  />
-</template>
diff --git a/src/client/theme-default/components/VPNavScreenTranslations.vue b/src/client/theme-default/components/VPNavScreenTranslations.vue
deleted file mode 100644
index 369c0f74..00000000
--- a/src/client/theme-default/components/VPNavScreenTranslations.vue
+++ /dev/null
@@ -1,87 +0,0 @@
-<script setup lang="ts">
-import { ref } from 'vue'
-
-import { useLangs } from '../composables/langs'
-import VPLink from './VPLink.vue'
-
-const { localeLinks, currentLang } = useLangs({
-  linkToCorrespondingPage: true
-})
-const isOpen = ref(false)
-
-function toggle() {
-  isOpen.value = !isOpen.value
-}
-</script>
-
-<template>
-  <div
-    v-if="localeLinks.length && currentLang.label"
-    class="VPNavScreenTranslations"
-    :class="{ open: isOpen }"
-  >
-    <button class="title" @click="toggle">
-      <span class="vpi-languages icon lang" />
-      {{ currentLang.label }}
-      <span class="vpi-chevron-down icon chevron" />
-    </button>
-
-    <ul class="list">
-      <li v-for="locale in localeLinks" :key="locale.link" class="item">
-        <VPLink
-          class="link"
-          :href="locale.link"
-          :external="false"
-          :lang="locale.lang"
-          :hreflang="locale.lang"
-          rel="alternate"
-          :dir="locale.dir"
-          data-allow-mismatch="attribute"
-        >
-          {{ locale.text }}
-        </VPLink>
-      </li>
-    </ul>
-  </div>
-</template>
-
-<style scoped>
-.VPNavScreenTranslations {
-  height: 1.5rem;
-  overflow: hidden;
-}
-
-.VPNavScreenTranslations.open {
-  height: auto;
-}
-
-.title {
-  display: flex;
-  align-items: center;
-  font-size: 0.875rem;
-  font-weight: 500;
-  color: var(--vp-c-text-1);
-}
-
-.icon {
-  font-size: 1rem;
-}
-
-.icon.lang {
-  margin-right: 0.5rem;
-}
-
-.icon.chevron {
-  margin-left: 0.25rem;
-}
-
-.list {
-  padding: 0.25rem 0 0 1.5rem;
-}
-
-.link {
-  line-height: 2.4615385;
-  font-size: 0.8125rem;
-  color: var(--vp-c-text-1);
-}
-</style>
diff --git a/src/client/theme-default/components/VPNavSocialLinks.vue b/src/client/theme-default/components/VPNavSocialLinks.vue
new file mode 100644
index 00000000..72d49801
--- /dev/null
+++ b/src/client/theme-default/components/VPNavSocialLinks.vue
@@ -0,0 +1,43 @@
+<script lang="ts" setup>
+import { computed } from 'vue'
+
+import { useData } from '../composables/data'
+import { useNavOverflow } from '../composables/nav-overflow'
+import VPSocialLinks from './VPSocialLinks.vue'
+
+const props = defineProps<{
+  screen?: boolean
+}>()
+
+const { theme } = useData()
+
+const overflow = props.screen ? null : useNavOverflow()
+
+const isCollapsed = computed(() => !!overflow && !overflow.state.socialLinks)
+</script>
+
+<template>
+  <VPSocialLinks
+    v-if="theme.socialLinks"
+    class="VPNavSocialLinks"
+    :class="[
+      screen ? 'VPNavScreenSocialLinks' : 'VPNavBarSocialLinks',
+      { collapsed: isCollapsed }
+    ]"
+    :links="theme.socialLinks"
+    :ref="(inst: any) => overflow?.setClusterEl('socialLinks', inst?.$el ?? null)"
+  />
+</template>
+
+<style scoped>
+.VPNavBarSocialLinks {
+  display: none;
+}
+
+@media (min-width: 48rem) {
+  .VPNavBarSocialLinks {
+    display: flex;
+    align-items: center;
+  }
+}
+</style>
diff --git a/src/client/theme-default/components/VPNavTranslations.vue b/src/client/theme-default/components/VPNavTranslations.vue
new file mode 100644
index 00000000..27fa8b21
--- /dev/null
+++ b/src/client/theme-default/components/VPNavTranslations.vue
@@ -0,0 +1,179 @@
+<script lang="ts" setup>
+import { computed, ref, useId } from 'vue'
+
+import { useData } from '../composables/data'
+import { useLangs } from '../composables/langs'
+import { useNavOverflow } from '../composables/nav-overflow'
+import VPFlyout from './VPFlyout.vue'
+import VPLink from './VPLink.vue'
+import VPMenuLink from './VPMenuLink.vue'
+
+const props = defineProps<{
+  /** accordion inside the nav screen */
+  screen?: boolean
+  /** titled group inside the `⋯` menu */
+  menu?: boolean
+}>()
+
+const { theme } = useData()
+const { localeLinks, currentLang } = useLangs({
+  linkToCorrespondingPage: true
+})
+
+const show = computed(
+  () => !!(localeLinks.value.length && currentLang.value.label)
+)
+
+// only the inline bar flyout participates in the overflow engine
+const overflow = props.screen || props.menu ? null : useNavOverflow()
+
+const isCollapsed = computed(
+  () => !!overflow && !overflow.state.translations
+)
+
+const isOpen = ref(false)
+const listId = useId()
+
+function toggle() {
+  isOpen.value = !isOpen.value
+}
+
+const localeProps = (locale: (typeof localeLinks.value)[number]) => ({
+  lang: locale.lang,
+  hreflang: locale.lang,
+  rel: 'alternate',
+  dir: locale.dir,
+  'data-allow-mismatch': 'attribute' as const
+})
+</script>
+
+<template>
+  <!-- accordion inside the nav screen -->
+  <div
+    v-if="screen && show"
+    class="VPNavTranslations VPNavScreenTranslations"
+    :class="{ open: isOpen }"
+  >
+    <button
+      type="button"
+      class="title"
+      :aria-expanded="isOpen"
+      :aria-controls="listId"
+      @click="toggle"
+    >
+      <span class="vpi-languages icon lang" aria-hidden="true" />
+      {{ currentLang.label }}
+      <span class="vpi-chevron-down icon chevron" aria-hidden="true" />
+    </button>
+
+    <ul v-show="isOpen" :id="listId" class="list">
+      <li v-for="locale in localeLinks" :key="locale.link" class="item">
+        <VPLink
+          class="link"
+          :href="locale.link"
+          :external="false"
+          v-bind="localeProps(locale)"
+        >
+          {{ locale.text }}
+        </VPLink>
+      </li>
+    </ul>
+  </div>
+
+  <!-- titled group inside the `⋯` menu -->
+  <div v-else-if="menu && show" class="VPNavTranslations group translations">
+    <p class="title">{{ currentLang.label }}</p>
+
+    <ul>
+      <template v-for="locale in localeLinks" :key="locale.link">
+        <VPMenuLink :item="locale" :external="false" v-bind="localeProps(locale)" />
+      </template>
+    </ul>
+  </div>
+
+  <!-- inline flyout in the navbar -->
+  <VPFlyout
+    v-else-if="!menu && show"
+    class="VPNavTranslations VPNavBarTranslations"
+    :class="{ collapsed: isCollapsed }"
+    icon="vpi-languages"
+    :label="theme.langMenuLabel || 'Change language'"
+    :ref="(inst: any) => overflow?.setClusterEl('translations', inst?.$el ?? null)"
+  >
+    <p class="title">{{ currentLang.label }}</p>
+
+    <ul class="items">
+      <template v-for="locale in localeLinks" :key="locale.link">
+        <VPMenuLink :item="locale" :external="false" v-bind="localeProps(locale)" />
+      </template>
+    </ul>
+  </VPFlyout>
+</template>
+
+<style scoped>
+/* flyout variant */
+.VPNavBarTranslations {
+  display: none;
+}
+
+@media (min-width: 48rem) {
+  .VPNavBarTranslations {
+    display: flex;
+    align-items: center;
+  }
+}
+
+.VPNavBarTranslations .title {
+  padding: 0 1.5rem 0 0.75rem;
+  line-height: 2.2857143;
+  font-size: 0.875rem;
+  font-weight: 700;
+  color: var(--vp-c-text-1);
+}
+
+/* menu-group variant (inside the `⋯` menu) — matches the menu group
+   titles */
+.group > .title {
+  padding: 0 0.75rem;
+  line-height: 2.2857143;
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: var(--vp-c-text-2);
+}
+
+/* accordion variant (inside the nav screen) */
+.VPNavScreenTranslations .title {
+  display: flex;
+  align-items: center;
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--vp-c-text-1);
+}
+
+.VPNavScreenTranslations .icon {
+  font-size: 1rem;
+}
+
+.VPNavScreenTranslations .icon.lang {
+  margin-right: 0.5rem;
+}
+
+.VPNavScreenTranslations .icon.chevron {
+  margin-left: 0.25rem;
+  transition: transform 0.25s;
+}
+
+.VPNavScreenTranslations.open .icon.chevron {
+  transform: rotate(180deg);
+}
+
+.VPNavScreenTranslations .list {
+  padding: 0.25rem 0 0 1.5rem;
+}
+
+.VPNavScreenTranslations .link {
+  line-height: 2.4615385;
+  font-size: 0.8125rem;
+  color: var(--vp-c-text-1);
+}
+</style>
diff --git a/src/client/theme-default/components/VPSidebarItem.vue b/src/client/theme-default/components/VPSidebarItem.vue
index 75f85310..28ce0628 100644
--- a/src/client/theme-default/components/VPSidebarItem.vue
+++ b/src/client/theme-default/components/VPSidebarItem.vue
@@ -32,22 +32,26 @@ const sectionTag = computed(() =>
   props.item.text && textTag.value !== 'p' ? 'section' : 'div'
 )
 
-const classes = computed(() => [
-  [`level-${props.depth}`],
-  { collapsible: collapsible.value },
-  { collapsed: collapsed.value },
-  { 'is-link': isLink.value },
-  { 'is-active': isActiveLink.value },
-  { 'has-active': hasActiveLink.value }
-])
-
 function onItemClick() {
   !props.item.link && toggle()
 }
 </script>
 
 <template>
-  <component :is="sectionTag" class="VPSidebarItem" :class="classes">
+  <component
+    :is="sectionTag"
+    class="VPSidebarItem"
+    :class="[
+      `level-${depth}`,
+      {
+        collapsible,
+        collapsed,
+        'is-link': isLink,
+        'is-active': isActiveLink,
+        'has-active': hasActiveLink
+      }
+    ]"
+  >
     <div v-if="item.text" class="item" @click="onItemClick">
       <div class="indicator" />
 
diff --git a/src/client/theme-default/components/VPSkipLink.vue b/src/client/theme-default/components/VPSkipLink.vue
index 78cebdd8..6340a24c 100644
--- a/src/client/theme-default/components/VPSkipLink.vue
+++ b/src/client/theme-default/components/VPSkipLink.vue
@@ -4,6 +4,11 @@ import { useTemplateRef, watch } from 'vue'
 
 import { useData } from '../composables/data'
 
+defineProps<{
+  // the component has two root nodes, so `inert` can't fall through
+  inert?: boolean
+}>()
+
 const { theme } = useData()
 const route = useRoute()
 const backToTop = useTemplateRef('backToTop')
@@ -13,7 +18,7 @@ watch(() => route.path, () => backToTop.value?.focus())
 
 <template>
   <span ref="backToTop" tabindex="-1" />
-  <a href="#VPContent" class="VPSkipLink visually-hidden">
+  <a href="#VPContent" class="VPSkipLink visually-hidden" :inert>
     {{ theme.skipToContentLabel || 'Skip to content' }}
   </a>
 </template>
diff --git a/src/client/theme-default/components/VPSwitch.vue b/src/client/theme-default/components/VPSwitch.vue
index 01a2b43b..85abde59 100644
--- a/src/client/theme-default/components/VPSwitch.vue
+++ b/src/client/theme-default/components/VPSwitch.vue
@@ -18,7 +18,7 @@
   flex-shrink: 0;
   border: 1px solid var(--vp-input-border-color);
   background-color: var(--vp-input-switch-bg-color);
-  transition: border-color 0.25s !important;
+  transition: border-color 0.25s;
 }
 
 .VPSwitch:hover {
@@ -35,7 +35,7 @@
   border-radius: 50%;
   background-color: var(--vp-c-neutral-inverse);
   box-shadow: var(--vp-shadow-1);
-  transition: transform 0.25s !important;
+  transition: transform 0.25s;
 }
 
 .icon {
@@ -58,6 +58,6 @@
 
 .dark .icon :deep([class^='vpi-']) {
   color: var(--vp-c-text-1);
-  transition: opacity 0.25s !important;
+  transition: opacity 0.25s;
 }
 </style>
diff --git a/src/client/theme-default/components/VPSwitchAppearance.vue b/src/client/theme-default/components/VPSwitchAppearance.vue
index 9412fb20..3e193bba 100644
--- a/src/client/theme-default/components/VPSwitchAppearance.vue
+++ b/src/client/theme-default/components/VPSwitchAppearance.vue
@@ -20,14 +20,16 @@ watchPostEffect(() => {
 </script>
 
 <template>
+  <!-- stable name + aria-checked state; the title stays the action hint -->
   <VPSwitch
     :title="switchTitle"
     class="VPSwitchAppearance"
+    :aria-label="theme.darkModeSwitchLabel || 'Appearance'"
     :aria-checked="isDark"
     @click="toggleAppearance"
   >
-    <span class="vpi-sun sun" />
-    <span class="vpi-moon moon" />
+    <span class="vpi-sun sun" aria-hidden="true" />
+    <span class="vpi-moon moon" aria-hidden="true" />
   </VPSwitch>
 </template>
 
diff --git a/src/client/theme-default/components/VPTeamMembers.vue b/src/client/theme-default/components/VPTeamMembers.vue
index 37dd0746..2e784e26 100644
--- a/src/client/theme-default/components/VPTeamMembers.vue
+++ b/src/client/theme-default/components/VPTeamMembers.vue
@@ -1,6 +1,5 @@
 <script setup lang="ts">
 import type { DefaultTheme } from 'vitepress/theme'
-import { computed } from 'vue'
 
 import VPTeamMembersItem from './VPTeamMembersItem.vue'
 
@@ -12,12 +11,10 @@ interface Props {
 const props = withDefaults(defineProps<Props>(), {
   size: 'medium'
 })
-
-const classes = computed(() => [props.size, `count-${props.members.length}`])
 </script>
 
 <template>
-  <div class="VPTeamMembers" :class="classes">
+  <div class="VPTeamMembers" :class="[size, `count-${members.length}`]">
     <ul class="container">
       <li v-for="member in members" :key="member.name" class="item">
         <VPTeamMembersItem :size :member />
diff --git a/src/client/theme-default/composables/flyout.ts b/src/client/theme-default/composables/flyout.ts
index 1b0b5286..d7aef46f 100644
--- a/src/client/theme-default/composables/flyout.ts
+++ b/src/client/theme-default/composables/flyout.ts
@@ -52,6 +52,7 @@ function activateFocusTracking() {
 
 function deactivateFocusTracking() {
   document.removeEventListener('focusin', handleFocusIn)
+  active = false
 }
 
 function handleFocusIn() {
diff --git a/src/client/theme-default/composables/nav-overflow.ts b/src/client/theme-default/composables/nav-overflow.ts
new file mode 100644
index 00000000..5c45c6b8
--- /dev/null
+++ b/src/client/theme-default/composables/nav-overflow.ts
@@ -0,0 +1,299 @@
+import { useMediaQuery } from '@vueuse/core'
+import { inBrowser } from 'vitepress'
+import {
+  inject,
+  onScopeDispose,
+  provide,
+  reactive,
+  toValue,
+  watch,
+  type InjectionKey,
+  type MaybeRefOrGetter
+} from 'vue'
+
+/**
+ * Priority+ overflow for the navbar (#1271, #2842).
+ *
+ * Collapse order under space pressure: social links → appearance switch →
+ * translations → menu items right-to-left. Collapsed units move into the
+ * `⋯` flyout (VPNavBarExtra) instead of being clipped, so nothing ever
+ * becomes unreachable.
+ *
+ * Collapsed units stay mounted but hidden (visibility: hidden + absolute,
+ * which also removes them from the a11y tree and tab order), so their
+ * natural widths remain measurable and observed — re-expanding never works
+ * from stale data.
+ */
+
+export const navClusterUnits = [
+  'translations',
+  'appearance',
+  'socialLinks'
+] as const
+
+export type NavClusterUnit = (typeof navClusterUnits)[number]
+
+export interface NavFitInput {
+  /** widths of the top-level menu items, in nav order (px) */
+  itemWidths: number[]
+  /** cluster unit widths; null = the unit isn't configured on this site */
+  translations: number | null
+  appearance: number | null
+  socialLinks: number | null
+  /** px available to all collapsible units */
+  available: number
+  /** px the `⋯` button occupies once anything is collapsed */
+  extraWidth: number
+}
+
+export interface NavFitResult {
+  /** number of menu items that stay in the bar (Infinity = all) */
+  visibleItemCount: number
+  translations: boolean
+  appearance: boolean
+  socialLinks: boolean
+}
+
+const allVisible: NavFitResult = {
+  visibleItemCount: Infinity,
+  translations: true,
+  appearance: true,
+  socialLinks: true
+}
+
+export function computeNavFit(input: NavFitInput): NavFitResult {
+  const { itemWidths, available, extraWidth } = input
+
+  const itemsTotal = itemWidths.reduce((sum, w) => sum + w, 0)
+  const clusterTotal =
+    (input.translations ?? 0) +
+    (input.appearance ?? 0) +
+    (input.socialLinks ?? 0)
+
+  if (itemsTotal + clusterTotal <= available) return allVisible
+
+  // something must collapse, so the `⋯` button needs room too
+  const budget = available - extraWidth
+
+  if (itemsTotal > budget) {
+    // even the menu alone doesn't fit — the whole cluster collapses and the
+    // menu keeps a contiguous prefix so the bar never shows a gap
+    // (units that aren't configured stay `true`: there is nothing to collapse)
+    let used = 0
+    let visibleItemCount = 0
+    for (const width of itemWidths) {
+      if (used + width > budget) break
+      used += width
+      visibleItemCount++
+    }
+    return {
+      visibleItemCount,
+      translations: input.translations == null,
+      appearance: input.appearance == null,
+      socialLinks: input.socialLinks == null
+    }
+  }
+
+  // menu fits in full; collapse the cluster in reverse keep-priority
+  // (translations is kept longest, social links go first) — once a unit
+  // collapses, everything after it in keep order collapses too
+  const result = { ...allVisible }
+  let used = itemsTotal
+  let dropRest = false
+
+  for (const unit of navClusterUnits) {
+    const width = input[unit]
+    if (width == null) continue
+    if (dropRest || used + width > budget) {
+      dropRest = true
+      result[unit] = false
+    } else {
+      used += width
+    }
+  }
+
+  return result
+}
+
+/** headroom against sub-pixel rounding and the inter-unit dividers */
+const SLACK = 24
+
+/** used until the real `⋯` button has been measured once */
+const EXTRA_WIDTH_ESTIMATE = 48
+
+export interface NavOverflow {
+  /** reactive collapse state, all-visible during SSR and below 48rem */
+  state: NavFitResult
+  /** true when anything is collapsed into the `⋯` menu */
+  hasCollapsed: () => boolean
+  setContainerEl(el: HTMLElement | null): void
+  setMenuEl(el: HTMLElement | null): void
+  setExtraEl(el: HTMLElement | null): void
+  setItemEl(index: number, el: HTMLElement | null): void
+  setClusterEl(unit: NavClusterUnit, el: HTMLElement | null): void
+}
+
+const navOverflowKey: InjectionKey<NavOverflow> = Symbol('nav-overflow')
+
+export function useNavOverflow(): NavOverflow | null {
+  return inject(navOverflowKey, null)
+}
+
+export function provideNavOverflow(options: {
+  /** stringified nav config — collapse state resets when it changes */
+  itemsKey: MaybeRefOrGetter<string>
+}): NavOverflow {
+  const state = reactive<NavFitResult>({ ...allVisible })
+
+  const itemEls = new Map<number, HTMLElement>()
+  const clusterEls = new Map<NavClusterUnit, HTMLElement>()
+  let containerEl: HTMLElement | null = null
+  let menuEl: HTMLElement | null = null
+  let extraEl: HTMLElement | null = null
+  let extraWidth = EXTRA_WIDTH_ESTIMATE
+
+  let observer: ResizeObserver | null = null
+  const observed = new Set<HTMLElement>()
+  let scheduled = false
+
+  function observe(el: HTMLElement | null) {
+    // instanceof also guards against fragment roots handing over a comment
+    // node via $el — better to skip a unit than to crash the bar
+    if (!inBrowser || !(el instanceof Element) || observed.has(el)) return
+    observed.add(el)
+    ;(observer ??= new ResizeObserver(schedule)).observe(el)
+  }
+
+  function schedule() {
+    if (!inBrowser || scheduled) return
+    scheduled = true
+    requestAnimationFrame(() => {
+      scheduled = false
+      recompute()
+    })
+  }
+
+  const controller: NavOverflow = {
+    state,
+    hasCollapsed: () =>
+      state.visibleItemCount !== Infinity ||
+      !state.translations ||
+      !state.appearance ||
+      !state.socialLinks,
+    setContainerEl(el) {
+      containerEl = el
+      observe(el)
+      schedule()
+    },
+    setMenuEl(el) {
+      menuEl = el
+      observe(el)
+      schedule()
+    },
+    setExtraEl(el) {
+      extraEl = el
+      observe(el)
+      schedule()
+    },
+    setItemEl(index, el) {
+      el ? itemEls.set(index, el) : itemEls.delete(index)
+      // container and menu boxes don't resize when item content changes
+      // (the menu is flex-grown), so the items themselves are observed
+      observe(el)
+      schedule()
+    },
+    setClusterEl(unit, el) {
+      el ? clusterEls.set(unit, el) : clusterEls.delete(unit)
+      observe(el)
+      schedule()
+    }
+  }
+
+  provide(navOverflowKey, controller)
+
+  if (!inBrowser) return controller
+
+  // below tablet size the hamburger + screen own navigation and the bar only
+  // shows title/search/hamburger, so the engine idles in the all-visible state
+  const isEngineActive = useMediaQuery('(min-width: 48rem)')
+
+  // natural width even while the unit is collapsed (clamped by max-width)
+  function measureUnit(el: HTMLElement) {
+    return Math.max(el.offsetWidth, el.scrollWidth)
+  }
+
+  function recompute() {
+    if (!isEngineActive.value) return applyResult(allVisible)
+    if (!containerEl) return
+
+    if (extraEl && extraEl.offsetWidth > 0) extraWidth = extraEl.offsetWidth
+
+    // everything in the row that isn't a collapsible unit (search, slots,
+    // the hamburger…) is measured live and treated as fixed occupancy
+    let fixed = 0
+    for (const child of Array.from(containerEl.children)) {
+      if (!(child instanceof HTMLElement)) continue
+      if (child === menuEl || child === extraEl) continue
+      let isCluster = false
+      for (const el of clusterEls.values()) {
+        if (el === child) {
+          isCluster = true
+          break
+        }
+      }
+      if (isCluster) continue
+      fixed += child.offsetWidth
+    }
+
+    const itemWidths: number[] = []
+    for (let i = 0; i < itemEls.size; i++) {
+      const el = itemEls.get(i)
+      // a hole means not every item has registered yet — wait for the next
+      // pass instead of collapsing on partial data
+      if (!el) return
+      itemWidths.push(measureUnit(el))
+    }
+
+    const clusterWidth = (unit: NavClusterUnit) => {
+      const el = clusterEls.get(unit)
+      return el ? measureUnit(el) : null
+    }
+
+    applyResult(
+      computeNavFit({
+        itemWidths,
+        translations: clusterWidth('translations'),
+        appearance: clusterWidth('appearance'),
+        socialLinks: clusterWidth('socialLinks'),
+        available: containerEl.clientWidth - fixed - SLACK,
+        extraWidth
+      })
+    )
+  }
+
+  function applyResult(result: NavFitResult) {
+    if (state.visibleItemCount !== result.visibleItemCount)
+      state.visibleItemCount = result.visibleItemCount
+    for (const unit of navClusterUnits) {
+      if (state[unit] !== result[unit]) state[unit] = result[unit]
+    }
+  }
+
+  watch(isEngineActive, schedule)
+
+  watch(() => toValue(options.itemsKey), schedule)
+
+  if (document.fonts?.ready) {
+    // a clamped collapsed unit keeps its box size when the font changes, so
+    // the ResizeObserver alone can miss late font swaps
+    document.fonts.ready.then(schedule).catch(() => {})
+  }
+
+  onScopeDispose(() => {
+    observer?.disconnect()
+    observer = null
+    observed.clear()
+  })
+
+  return controller
+}
diff --git a/src/client/theme-default/composables/nav.ts b/src/client/theme-default/composables/nav.ts
index e7341ed6..dcb08764 100644
--- a/src/client/theme-default/composables/nav.ts
+++ b/src/client/theme-default/composables/nav.ts
@@ -1,9 +1,10 @@
 import { useMediaQuery, whenever } from '@vueuse/core'
-import { useRoute } from 'vitepress'
+import { inBrowser, useRoute } from 'vitepress'
 import type { DefaultTheme } from 'vitepress/theme'
 import {
   computed,
   ref,
+  shallowRef,
   toValue,
   watch,
   type InjectionKey,
@@ -11,37 +12,66 @@ import {
 } from 'vue'
 
 import { isActive } from '../../shared'
+import { useData } from './data'
 
-export function useNav() {
-  const isScreenOpen = ref(false)
+// module-scoped so Layout.vue can render the rest of the app inert while the
+// screen (mobile drawer) is open, without threading props through VPNav
+const isScreenOpen = ref(false)
 
-  function openScreen() {
-    isScreenOpen.value = true
-  }
+// the button that toggles the screen — focus returns to it when the screen
+// is closed with Escape
+const screenTriggerEl = shallowRef<HTMLButtonElement | null>(null)
 
-  function closeScreen() {
-    isScreenOpen.value = false
-  }
+function openScreen() {
+  isScreenOpen.value = true
+}
 
-  function toggleScreen() {
-    isScreenOpen.value ? closeScreen() : openScreen()
-  }
+function closeScreen() {
+  isScreenOpen.value = false
+}
 
-  // Close screen when the user resizes the window wider than tablet size.
-  const isTablet = useMediaQuery('(min-width: 48rem)')
-  whenever(isTablet, closeScreen)
+function toggleScreen() {
+  isScreenOpen.value ? closeScreen() : openScreen()
+}
 
-  const route = useRoute()
-  watch(() => route.path, closeScreen)
+let watchersRegistered = false
+
+export function useNav() {
+  // the auto-close watchers are app-wide, so guard against VPNav being
+  // mounted more than once (the flag persists across SSG renders, hence the
+  // inBrowser check — the watchers are meaningless during SSR anyway)
+  if (inBrowser && !watchersRegistered) {
+    watchersRegistered = true
+
+    // Close screen when the user resizes the window wider than tablet size.
+    const isTablet = useMediaQuery('(min-width: 48rem)')
+    whenever(isTablet, closeScreen)
+
+    const route = useRoute()
+    watch(() => route.path, closeScreen)
+  }
 
   return {
     isScreenOpen,
+    screenTriggerEl,
     openScreen,
     closeScreen,
     toggleScreen
   }
 }
 
+// whether the theme shows a light/dark switch (guard shared by the inline
+// switch, the `⋯` menu and the nav screen)
+export function useAppearanceSwitch() {
+  const { site } = useData()
+  return computed(
+    () =>
+      !!site.value.appearance &&
+      site.value.appearance !== 'force-dark' &&
+      site.value.appearance !== 'force-auto'
+  )
+}
+
 export function useNavItemLink(
   item: MaybeRefOrGetter<DefaultTheme.NavItemWithLink>
 ) {
@@ -76,3 +106,7 @@ export interface NavExposedMethods {
 }
 
 export const navInjectionKey: InjectionKey<NavExposedMethods> = Symbol('nav')
+
+// true within the VPNavScreen subtree — shared components (VPMenuLink,
+// VPMenuGroup, …) restyle themselves and close the screen on navigation
+export const navScreenInjectionKey: InjectionKey<boolean> = Symbol('nav-screen')
diff --git a/src/client/theme-default/styles/vars.css b/src/client/theme-default/styles/vars.css
index a6c47551..aa1daaa0 100644
--- a/src/client/theme-default/styles/vars.css
+++ b/src/client/theme-default/styles/vars.css
@@ -499,6 +499,20 @@
 :root {
   --vp-nav-height: 4rem;
   --vp-nav-bg-color: var(--vp-c-bg);
+
+  /**
+   * Background while on top of the home page (unscrolled). Set it to
+   * var(--vp-nav-bg-color) to opt out of the transparent treatment.
+   */
+  --vp-nav-home-bg-color: transparent;
+
+  /**
+   * Applied to the navbar surface, e.g. `saturate(180%) blur(8px)` combined
+   * with a translucent --vp-nav-bg-color for a frosted-glass bar.
+   */
+  --vp-nav-backdrop-filter: none;
+
+  --vp-nav-divider-color: var(--vp-c-gutter);
   --vp-nav-screen-bg-color: var(--vp-c-bg);
   --vp-nav-logo-height: 1.5rem;
 }
@@ -516,7 +530,12 @@
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-local-nav-bg-color: var(--vp-c-bg);
+  /**
+   * Follows the navbar surface by default, so a translucent
+   * --vp-nav-bg-color with --vp-nav-backdrop-filter extends the
+   * frosted-glass treatment to the local nav as well.
+   */
+  --vp-local-nav-bg-color: var(--vp-nav-bg-color);
 }
 
 /**
diff --git a/types/default-theme.d.ts b/types/default-theme.d.ts
index a8add01a..8120fead 100644
--- a/types/default-theme.d.ts
+++ b/types/default-theme.d.ts
@@ -133,6 +133,29 @@ export namespace DefaultTheme {
      */
     langMenuLabel?: string
 
+    /**
+     * Accessible label of the main navigation landmarks (navbar menu and
+     * the mobile menu).
+     *
+     * @default 'Main Navigation'
+     */
+    navMenuLabel?: string
+
+    /**
+     * Set custom `aria-label` for the mobile menu (hamburger) button.
+     *
+     * @default 'Menu'
+     */
+    mobileMenuLabel?: string
+
+    /**
+     * Set custom `aria-label` for the `⋯` overflow menu button in the
+     * navbar, which collects nav items and controls that don't fit.
+     *
+     * @default 'More options'
+     */
+    extraMenuLabel?: string
+
     /**
      * @default 'Skip to content'
      */

From a2a0a923e5f468af1bb81023347c61513d6c408a Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Tue, 25 Aug 2026 03:16:49 +0530
Subject: [PATCH 17/18] fix(theme): drop the -webkit-backdrop-filter fallbacks
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The frosted-glass surface disappeared from builds. Two causes stacked:
lightningcss (vite's css minifier) collapses a standard-first pair
into the prefixed declaration alone, and -webkit-backdrop-filter is
dead weight everywhere — Chromium and Firefox don't recognize it, and
WebKit ignores var() values in it (bug 289800).

Only the standard property is written now. The minifier re-adds the
prefix from it for its own targets. Safari 17 and earlier show the
translucent color without the blur, noted in the glass recipe's
warning.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs/en/guide/extending-default-theme.md           | 2 +-
 src/client/theme-default/components/VPLocalNav.vue | 1 -
 src/client/theme-default/components/VPNavBar.vue   | 3 ---
 3 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/docs/en/guide/extending-default-theme.md b/docs/en/guide/extending-default-theme.md
index 63bf3365..307e0db4 100644
--- a/docs/en/guide/extending-default-theme.md
+++ b/docs/en/guide/extending-default-theme.md
@@ -75,7 +75,7 @@ For example, a frosted-glass navbar:
 The same treatment carries over to the local nav: `--vp-local-nav-bg-color` follows the navbar surface color by default, and where the two bars meet they share a single blurred surface, so the glass stays continuous across them.
 
 ::: warning
-`backdrop-filter` has a measurable scroll performance cost, especially on large or high-DPI screens. When using a translucent bar, also check text contrast over your page content.
+`backdrop-filter` has a measurable scroll performance cost, especially on large or high-DPI screens. When using a translucent bar, also check text contrast over your page content. Safari 17 and earlier don't apply variable-driven backdrop filters, so they show the translucent color without the blur.
 :::
 
 When the nav items don't fit the available width, they move into the `⋯` menu at the end of the navbar instead of being clipped, starting with the social links, the appearance switch and the locale switcher, followed by the nav items right-to-left. Its button label can be localized with [`extraMenuLabel`](../reference/default-theme-config#extramenulabel).
diff --git a/src/client/theme-default/components/VPLocalNav.vue b/src/client/theme-default/components/VPLocalNav.vue
index 0b644cdc..254aff13 100644
--- a/src/client/theme-default/components/VPLocalNav.vue
+++ b/src/client/theme-default/components/VPLocalNav.vue
@@ -87,7 +87,6 @@ const isScrolled = computed(() => y.value >= navHeight.value)
   z-index: -1;
   background-color: var(--vp-local-nav-bg-color);
   backdrop-filter: var(--vp-nav-backdrop-filter);
-  -webkit-backdrop-filter: var(--vp-nav-backdrop-filter);
   transition: background-color 0.25s;
 }
 
diff --git a/src/client/theme-default/components/VPNavBar.vue b/src/client/theme-default/components/VPNavBar.vue
index 24a0f4c9..35b404cb 100644
--- a/src/client/theme-default/components/VPNavBar.vue
+++ b/src/client/theme-default/components/VPNavBar.vue
@@ -106,7 +106,6 @@ const overflow = provideNavOverflow({
   z-index: -1;
   background-color: var(--vp-nav-bg-color);
   backdrop-filter: var(--vp-nav-backdrop-filter);
-  -webkit-backdrop-filter: var(--vp-nav-backdrop-filter);
   transition: background-color 0.25s;
 }
 
@@ -123,7 +122,6 @@ const overflow = provideNavOverflow({
   .VPNavBar.home.top::before {
     background-color: var(--vp-nav-home-bg-color);
     backdrop-filter: none;
-    -webkit-backdrop-filter: none;
   }
 
   .VPNavBar.has-sidebar {
@@ -150,7 +148,6 @@ const overflow = provideNavOverflow({
   .VPNavBar.has-local-nav::before {
     background-color: transparent;
     backdrop-filter: none;
-    -webkit-backdrop-filter: none;
   }
 }
 

From 110209dd32bd7b828abccfb773ae2207f36c1147 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Tue, 25 Aug 2026 03:30:30 +0530
Subject: [PATCH 18/18] feat(theme): add --vp-local-nav-divider-color

The local nav's bottom rule reads its own token instead of a
hardcoded gutter color. It follows --vp-nav-divider-color by default,
like the surface color follows the navbar's.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 src/client/theme-default/components/VPLocalNav.vue | 2 +-
 src/client/theme-default/styles/vars.css           | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/client/theme-default/components/VPLocalNav.vue b/src/client/theme-default/components/VPLocalNav.vue
index 254aff13..27dcda67 100644
--- a/src/client/theme-default/components/VPLocalNav.vue
+++ b/src/client/theme-default/components/VPLocalNav.vue
@@ -71,7 +71,7 @@ const isScrolled = computed(() => y.value >= navHeight.value)
   /*rtl:ignore*/
   left: 0;
   z-index: var(--vp-z-index-local-nav);
-  border-bottom: 1px solid var(--vp-c-gutter);
+  border-bottom: 1px solid var(--vp-local-nav-divider-color);
   padding-top: var(--vp-layout-top-height, 0px);
   width: 100%;
 }
diff --git a/src/client/theme-default/styles/vars.css b/src/client/theme-default/styles/vars.css
index aa1daaa0..f95c80c3 100644
--- a/src/client/theme-default/styles/vars.css
+++ b/src/client/theme-default/styles/vars.css
@@ -536,6 +536,12 @@
    * frosted-glass treatment to the local nav as well.
    */
   --vp-local-nav-bg-color: var(--vp-nav-bg-color);
+
+  /**
+   * The local nav's bottom rule. Follows the navbar's divider color by
+   * default.
+   */
+  --vp-local-nav-divider-color: var(--vp-nav-divider-color);
 }
 
 /**