vitepress 1.0.0-draft.2 → 1.0.0-draft.5

package/dist/client/theme-default/components/VPDoc.vue

@@ -1,10 +1,12 @@
 <script setup lang="ts">
 import { computed } from 'vue'
 import { useData } from 'vitepress'
-import VPDocOutline from './VPDocOutline.vue'
+import { useSidebar } from '../composables/sidebar'
+import VPDocAside from './VPDocAside.vue'
 import VPDocFooter from './VPDocFooter.vue'
 
 const { page } = useData()
+const { hasSidebar } = useSidebar()
 
 const pageName = computed(() => {
   return page.value.relativePath.slice(0, page.value.relativePath.indexOf('/'))
@@ -12,23 +14,32 @@ const pageName = computed(() => {
 </script>
 
 <template>
-  <div class="VPDoc has-aside">
+  <div class="VPDoc" :class="{ 'has-sidebar': hasSidebar }">
     <div class="container">
       <div class="aside">
+        <div class="aside-curtain" />
         <div class="aside-container">
-          <div class="aside-curtain" />
           <div class="aside-content">
-            <VPDocOutline v-if="page.headers" />
+            <VPDocAside>
+              <template #aside-top><slot name="aside-top" /></template>
+              <template #aside-bottom><slot name="aside-bottom" /></template>
+              <template #aside-outline-before><slot name="aside-outline-before" /></template>
+              <template #aside-outline-after><slot name="aside-outline-after" /></template>
+              <template #aside-ads-before><slot name="aside-ads-before" /></template>
+              <template #aside-ads-after><slot name="aside-ads-after" /></template>
+            </VPDocAside>
           </div>
         </div>
       </div>
 
       <div class="content">
-        <main class="main">
-          <Content class="vp-doc" :class="pageName" />
-        </main>
+        <div class="content-container">
+          <main class="main">
+            <Content class="vp-doc" :class="pageName" />
+          </main>
 
-        <VPDocFooter />
+          <VPDocFooter />
+        </div>
       </div>
     </div>
   </div>
@@ -37,6 +48,7 @@ const pageName = computed(() => {
 <style scoped>
 .VPDoc {
   padding: 32px 24px 96px;
+  width: 100%;
 }
 
 @media (min-width: 768px) {
@@ -47,90 +59,82 @@ const pageName = computed(() => {
 
 @media (min-width: 960px) {
   .VPDoc {
-    padding: 32px 64px 96px;
+    padding: 32px 32px 32px;
   }
-}
 
-@media (min-width: 1280px) {
-  .VPDoc {
-    padding: 32px 0 128px 64px;
+  .VPDoc:not(.has-sidebar) .container {
+    display: flex;
+    justify-content: center;
+    max-width: 992px;
   }
 
-  .VPDoc:not(.has-sidebar.has-aside) {
-    padding-left: calc((100vw - 688px) / 2);
+  .VPDoc:not(.has-sidebar) .aside {
+    display: block;
   }
 
-  .VPDoc.has-aside:not(.has-sidebar) {
-    padding-left: calc((100vw - 688px - 320px) / 2);
+  .VPDoc:not(.has-sidebar) .content {
+    max-width: 752px;
+  }
+}
+
+@media (min-width: 1280px) {
+  .VPDoc .container {
+    display: flex;
+    justify-content: center;
   }
 
-  .VPDoc:not(.has-aside) .content {
-    min-width: 688px;
+  .VPDoc .aside {
+    display: block;
   }
 }
 
 @media (min-width: 1440px) {
-  .VPDoc {
-    padding: 32px 0 128px 96px;
+  .VPDoc:not(.has-sidebar) .content {
+    max-width: 784px;
   }
-}
 
-@media (min-width: 1280px) {
-  .container {
-    display: flex;
+  .VPDoc:not(.has-sidebar) .container {
+    max-width: 1104px;
   }
 }
 
+.container {
+  margin: 0 auto;
+  width: 100%;
+}
+
 .aside {
   position: relative;
   display: none;
   order: 2;
-  flex-shrink: 0;
   flex-grow: 1;
-  padding-left: 64px;
-  padding-right: 32px;
-  min-width: 320px;
-}
-
-@media (min-width: 1280px) {
-  .aside {
-    display: block;
-  }
-}
-
-@media (min-width: 1440px) {
-  .aside {
-    padding-left: 96px;
-  }
+  padding-left: 32px;
+  width: 100%;
+  max-width: 256px;
 }
 
 .aside-container {
-  position: fixed;
-  top: var(--vp-nav-height-desktop);
-  bottom: 0;
-  padding-top: 32px;
-  width: 224px;
+  position: sticky;
+  top: 0;
+  margin-top: calc(var(--vp-nav-height-desktop) * -1 - 32px);
+  padding-top: calc(var(--vp-nav-height-desktop) + 32px);
+  max-height: 100vh;
   overflow-x: hidden;
   overflow-y: auto;
+  scrollbar-width: none;
 }
 
 .aside-container::-webkit-scrollbar {
   display: none;
 }
 
-@media (min-width: 1440px) {
-  .aside-container {
-    width: 256px;
-  }
-}
-
 .aside-curtain {
   position: fixed;
-  top: var(--vp-nav-height-desktop);
+  bottom: 0;
   z-index: 10;
-  width: 100%;
-  height: 40px;
-  background: linear-gradient(var(--vp-c-bg-content), transparent);
+  width: 224px;
+  height: 88px;
+  background: linear-gradient(transparent, var(--vp-c-bg) 70%);
 }
 
 .aside-content {
@@ -140,17 +144,28 @@ const pageName = computed(() => {
 .content {
   position: relative;
   margin: 0 auto;
-  max-width: 688px;
+  width: 100%;
+}
+
+@media (min-width: 960px) {
+  .content {
+    padding: 0 32px 96px;
+  }
 }
 
 @media (min-width: 1280px) {
   .content {
     order: 1;
     margin: 0;
-    min-width: 632px;
+    min-width: 640px;
   }
 }
 
+.content-container {
+  margin: 0 auto;
+  max-width: 688px;
+}
+
 .edit-link {
   margin: 0 0 32px;
 }

package/dist/client/theme-default/components/VPDocAside.vue

@@ -0,0 +1,34 @@
+<script setup lang="ts">
+import { useData } from 'vitepress'
+import VPDocAsideOutline from './VPDocAsideOutline.vue'
+import VPDocAsideCarbonAds from './VPDocAsideCarbonAds.vue'
+
+const { page, theme } = useData()
+</script>
+
+<template>
+  <div class="VPDocAside">
+    <slot name="aside-top" />
+
+    <slot name="aside-outline-before" />
+    <VPDocAsideOutline v-if="page.headers.length" />
+    <slot name="aside-outline-after" />
+
+    <slot name="aside-ads-before" />
+    <VPDocAsideCarbonAds v-if="theme.carbonAds" />
+    <slot name="aside-ads-after" />
+
+    <slot name="aside-bottom" />
+  </div>
+</template>
+
+<style scoped>
+.VPDocAside :deep(.VPDocAsideOutline + .VPDocAsideSponsors),
+.VPDocAside :deep(.VPDocAsideOutline + .VPDocAsideCarbonAds) {
+  margin-top: 24px;
+}
+
+.VPDocAside :deep(.VPDocAsideSponsors + .VPDocAsideCarbonAds) {
+  margin-top: 16px;
+}
+</style>

package/dist/client/theme-default/components/VPDocAsideCarbonAds.vue

@@ -0,0 +1,13 @@
+<script setup lang="ts">
+import { defineAsyncComponent } from 'vue'
+
+const VPCarbonAds = __ALGOLIA__
+  ? defineAsyncComponent(() => import('./VPCarbonAds.vue'))
+  : () => null
+</script>
+
+<template>
+  <div class="VPDocAsideCarbonAds">
+    <VPCarbonAds />
+  </div>
+</template>

package/dist/client/theme-default/components/{VPDocOutline.vue → VPDocAsideOutline.vue}

@@ -1,10 +1,16 @@
 <script setup lang="ts">
 import { ref, computed } from 'vue'
 import { useData } from 'vitepress'
-import { resolveHeaders, useActiveAnchor } from '../composables/outline'
+import {
+  resolveHeaders,
+  useOutline,
+  useActiveAnchor
+} from '../composables/outline'
 
 const { page, frontmatter } = useData()
 
+const { hasOutline } = useOutline()
+
 const container = ref()
 const marker = ref()
 
@@ -22,7 +28,7 @@ function handleClick({ target: el }: Event) {
 </script>
 
 <template>
-  <div class="VPDocOutline" ref="container">
+  <div class="VPDocAsideOutline" :class="{ 'has-outline': hasOutline }" ref="container">
     <div class="outline-marker" ref="marker" />
 
     <div class="outline-title">On this page</div>
@@ -54,14 +60,19 @@ function handleClick({ target: el }: Event) {
 </template>
 
 <style scoped>
-.VPDocOutline {
+.VPDocAsideOutline {
   position: relative;
+  display: none;
   border-left: 1px solid var(--vp-c-divider-light);
   padding-left: 16px;
   font-size: 13px;
   font-weight: 500;
 }
 
+.VPDocAsideOutline.has-outline {
+  display: block;
+}
+
 .outline-marker {
   position: absolute;
   top: 32px;

package/dist/client/theme-default/components/VPDocAsideSponsors.vue

@@ -0,0 +1,32 @@
+<script setup lang="ts">
+import VPSponsors from './VPSponsors.vue'
+
+export interface Sponsors {
+  tier?: string
+  size?: 'xmini' | 'mini' | 'small'
+  items: Sponsor[]
+}
+
+export interface Sponsor {
+  name: string
+  img: string
+  url: string
+}
+
+defineProps<{
+  tier?: string
+  size?: 'xmini' | 'mini' | 'small'
+  data: Sponsors[] | Sponsor[]
+}>()
+</script>
+
+<template>
+  <div class="VPDocAsideSponsors">
+    <VPSponsors
+      mode="aside"
+      :tier="tier"
+      :size="size"
+      :data="data"
+    />
+  </div>
+</template>

package/dist/client/theme-default/components/VPDocFooter.vue

@@ -44,7 +44,7 @@ const control = usePrevNext()
 }
 
 .edit-link {
-  padding-bottom: 8px;
+  padding-bottom: 14px;
 }
 
 .edit-link-button {

package/dist/client/theme-default/components/VPFlyout.vue

@@ -1,12 +1,11 @@
 <script lang="ts" setup>
 import { ref } from 'vue'
-import { DefaultTheme } from 'vitepress'
 import { useFlyout } from '../composables/flyout'
 import VPIconChevronDown from './icons/VPIconChevronDown.vue'
 import VPIconMoreHorizontal from './icons/VPIconMoreHorizontal.vue'
 import VPMenu from './VPMenu.vue'
 
-const props = defineProps<{
+defineProps<{
   icon?: any
   button?: string
   label?: string
@@ -141,7 +140,7 @@ function onBlur() {
   transition: opacity 0.25s, visibility 0.25s, transform 0.25s;
 }
 
-@media (min-width: 1280px) {
+@media (min-width: 960px) {
   .menu {
     top: calc(var(--vp-nav-height-desktop) / 2 + 20px);
   }

package/dist/client/theme-default/components/VPFooter.vue

@@ -21,7 +21,7 @@ const { hasSidebar } = useSidebar()
   z-index: var(--vp-z-index-footer);
   border-top: 1px solid var(--vp-c-divider-light);
   padding: 32px 24px;
-  background-color: var(--vp-c-bg-content);
+  background-color: var(--vp-c-bg);
 }
 
 .VPFooter.has-sidebar {

package/dist/client/theme-default/components/VPHero.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import VPButton from './VPButton.vue'
 
-interface HeroAction {
+export interface HeroAction {
   theme?: 'brand' | 'alt'
   text: string
   link: string
@@ -56,8 +56,8 @@ defineProps<{
 
 .name,
 .text {
-  line-height: 40px;
-  font-size: 32px;
+  line-height: 48px;
+  font-size: 40px;
   font-weight: 700;
 }
 

package/dist/client/theme-default/components/VPHomeSponsors.vue

@@ -3,13 +3,13 @@ import VPIconHeart from './icons/VPIconHeart.vue'
 import VPButton from './VPButton.vue'
 import VPSponsors from './VPSponsors.vue'
 
-interface Sponsors {
+export interface Sponsors {
   tier: string
   size?: 'medium' | 'big'
   items: Sponsor[]
 }
 
-interface Sponsor {
+export interface Sponsor {
   name: string
   img: string
   url: string
@@ -50,7 +50,7 @@ defineProps<{
 .VPHomeSponsors {
   border-top: 1px solid var(--vp-c-divider-light);
   padding: 88px 24px 96px;
-  background-color: var(--vp-c-bg-content);
+  background-color: var(--vp-c-bg);
 }
 
 .container {
@@ -86,10 +86,6 @@ defineProps<{
   padding-top: 32px;
 }
 
-.sponsor + .sponsor {
-  padding-top: 0px;
-}
-
 .action {
   padding-top: 40px;
   text-align: center;

package/dist/client/theme-default/components/VPLink.vue

@@ -1,5 +1,6 @@
 <script lang="ts" setup>
 import { computed } from 'vue'
+import { normalizeLink } from '../support/utils'
 import VPIconExternalLink from './icons/VPIconExternalLink.vue'
 
 const props = defineProps<{
@@ -15,7 +16,7 @@ const isExternal = computed(() => props.href && /^[a-z]+:/i.test(props.href))
     :is="href ? 'a' : 'span'"
     class="VPLink"
     :class="{ link: href }"
-    :href="href"
+    :href="href ? normalizeLink(href) : undefined"
     :target="isExternal ? '_blank' : undefined"
     :rel="isExternal ? 'noopener noreferrer' : undefined"
   >

package/dist/client/theme-default/components/VPLocalNav.vue

@@ -45,7 +45,7 @@ function scrollToTop() {
   justify-content: space-between;
   border-bottom: 1px solid var(--vp-c-divider-light);
   width: 100%;
-  background-color: var(--vp-c-bg-content);
+  background-color: var(--vp-c-bg);
   transition: border-color 0.5s, background-color 0.5s;
 }
 

package/dist/client/theme-default/components/VPMenu.vue

@@ -22,27 +22,22 @@ defineProps<{
 
 <style scoped>
 .VPMenu {
-  border-radius: 8px;
-  padding: 12px 0;
-  min-width: 192px;
-  border: 1px solid transparent;
-  background: var(--vp-c-bg);
+  border-radius: 12px;
+  padding: 12px;
+  min-width: 128px;
+  border: 1px solid var(--vp-c-divider-light);
+  background-color: var(--vp-c-bg);
   box-shadow: var(--vp-shadow-3);
   transition: background-color 0.5s;
 }
 
 .dark .VPMenu {
-  background: var(--vp-c-bg);
-  box-shadow: var(--vp-shadow-1);
-  border: 1px solid var(--vp-c-divider-light);
-}
-
-.VPMenu :deep(.items) {
-  transition: border-color .5s;
+  box-shadow: var(--vp-shadow-2);
 }
 
 .VPMenu :deep(.group) {
-  padding: 0 0 12px;
+  margin: 0 -12px;
+  padding: 0 12px 12px;
 }
 
 .VPMenu :deep(.group + .group) {

package/dist/client/theme-default/components/VPMenuLink.vue

@@ -15,16 +15,22 @@ defineProps<{
 <style scoped>
 .VPMenuLink {
   display: block;
-  padding: 0 16px;
-  line-height: 28px;
-  font-size: 13px;
+  border-radius: 6px;
+  padding: 0 12px;
+  line-height: 32px;
+  font-size: 14px;
   font-weight: 500;
   color: var(--vp-c-text-1);
   white-space: nowrap;
-  transition: color 0.25s;
+  transition: background-color 0.25s, color 0.25s;
 }
 
 .VPMenuLink:hover {
   color: var(--vp-c-brand);
+  background-color: var(--vp-c-bg-mute);
+}
+
+.dark .VPMenuLink:hover {
+  background-color: var(--vp-c-bg-soft);
 }
 </style>

package/dist/client/theme-default/components/VPNav.vue

@@ -1,16 +1,18 @@
 <script setup lang="ts">
 import { provide } from 'vue'
 import { useNav } from '../composables/nav'
+import { useSidebar } from '../composables/sidebar'
 import VPNavBar from './VPNavBar.vue'
 import VPNavScreen from './VPNavScreen.vue'
 
 const { isScreenOpen, closeScreen, toggleScreen } = useNav()
+const { hasSidebar } = useSidebar()
 
 provide('close-screen', closeScreen)
 </script>
 
 <template>
-  <header class="VPNav">
+  <header class="VPNav" :class="{ 'no-sidebar' : !hasSidebar }">
     <VPNavBar :is-screen-open="isScreenOpen" @toggle-screen="toggleScreen" />
     <VPNavScreen :open="isScreenOpen" />
   </header>
@@ -29,5 +31,20 @@ provide('close-screen', closeScreen)
   .VPNav {
     position: fixed;
   }
+
+  .VPNav.no-sidebar {
+    backdrop-filter: saturate(50%) blur(8px);
+    -webkit-backdrop-filter: saturate(50%) blur(8px);
+  }
+
+  @supports not (backdrop-filter: saturate(50%) blur(8px)) {
+    .VPNav.no-sidebar {
+      background: rgba(255, 255, 255, 0.95);
+    }
+
+    .dark .VPNav.no-sidebar {
+      background: rgba(36, 36, 36, 0.95);
+    }
+  }
 }
 </style>

package/dist/client/theme-default/components/VPNavBar.vue

@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+import { useSidebar } from '../composables/sidebar'
 import VPNavBarTitle from './VPNavBarTitle.vue'
 import VPNavBarSearch from './VPNavBarSearch.vue'
 import VPNavBarMenu from './VPNavBarMenu.vue'
@@ -15,10 +16,12 @@ defineProps<{
 defineEmits<{
   (e: 'toggle-screen'): void
 }>()
+
+const { hasSidebar } = useSidebar()
 </script>
 
 <template>
-  <div class="VPNavBar">
+  <div class="VPNavBar" :class="{ 'has-sidebar' : hasSidebar }">
     <div class="container">
       <VPNavBarTitle />
 
@@ -60,13 +63,28 @@ defineEmits<{
     height: var(--vp-nav-height-desktop);
     border-bottom: 0;
   }
+
+  .VPNavBar.has-sidebar .content {
+    backdrop-filter: saturate(50%) blur(8px);
+    -webkit-backdrop-filter: saturate(50%) blur(8px);
+  }
+
+  @supports not (backdrop-filter: saturate(50%) blur(8px)) {
+    .VPNavBar.has-sidebar.content {
+      background: rgba(255, 255, 255, 0.95);
+    }
+
+    .dark .VPNavBar.has-sidebar .content {
+      background: rgba(36, 36, 36, 0.95);
+    }
+  }
 }
 
 .container {
   display: flex;
   justify-content: space-between;
   margin: 0 auto;
-  max-width: var(--vp-layout-max-width);
+  max-width: calc(var(--vp-layout-max-width) - 64px);
 }
 
 .content {
@@ -76,12 +94,6 @@ defineEmits<{
   flex-grow: 1;
 }
 
-@media (min-width: 960px) {
-  .content {
-    backdrop-filter: saturate(50%) blur(8px);
-  }
-}
-
 .menu + .translations::before,
 .menu + .appearance::before,
 .menu + .social-links::before,