vitepress 1.5.0 → 1.6.0

package/README.md

@@ -2,6 +2,7 @@
 
 [![test](https://github.com/vuejs/vitepress/workflows/Test/badge.svg)](https://github.com/vuejs/vitepress/actions)
 [![npm](https://img.shields.io/npm/v/vitepress)](https://www.npmjs.com/package/vitepress)
+[![nightly releases](https://img.shields.io/badge/nightly-releases-orange)](https://nightly.akryum.dev/vuejs/vitepress)
 [![chat](https://img.shields.io/badge/chat-discord-blue?logo=discord)](https://chat.vuejs.org)
 
 ---

package/dist/client/app/components/ClientOnly.js

@@ -1,4 +1,4 @@
-import { defineComponent, ref, onMounted } from 'vue';
+import { defineComponent, onMounted, ref } from 'vue';
 export const ClientOnly = defineComponent({
     setup(_, { slots }) {
         const show = ref(false);

package/dist/client/app/components/Content.js

@@ -1,5 +1,5 @@
-import { defineComponent, h, watch } from 'vue';
 import { useData, useRoute } from 'vitepress';
+import { defineComponent, h, watch } from 'vue';
 import { contentUpdatedCallbacks } from '../utils';
 const runCbs = () => contentUpdatedCallbacks.forEach((fn) => fn());
 export const Content = defineComponent({

package/dist/client/app/composables/preFetch.js

@@ -1,7 +1,7 @@
 // Customized pre-fetch for page chunks based on
 // https://github.com/GoogleChromeLabs/quicklink
-import { useRoute } from '../router';
 import { onMounted, onUnmounted, watch } from 'vue';
+import { useRoute } from '../router';
 import { inBrowser, pathToFile } from '../utils';
 const hasFetched = new Set();
 const createLink = () => document.createElement('link');

package/dist/client/app/router.js

@@ -27,7 +27,7 @@ export function createRouter(loadPageModule, fallbackComponent) {
             history.pushState({}, '', href);
         }
         await loadPage(href);
-        await router.onAfterRouteChanged?.(href);
+        await (router.onAfterRouteChange ?? router.onAfterRouteChanged)?.(href);
     }
     let latestPendingPath = null;
     async function loadPage(href, scrollPosition = 0, isRetry = false) {
@@ -168,11 +168,11 @@ export function createRouter(loadPageModule, fallbackComponent) {
             }
         }, { capture: true });
         window.addEventListener('popstate', async (e) => {
-            if (e.state === null) {
+            if (e.state === null)
                 return;
-            }
-            await loadPage(normalizeHref(location.href), (e.state && e.state.scrollPosition) || 0);
-            router.onAfterRouteChanged?.(location.href);
+            const href = normalizeHref(location.href);
+            await loadPage(href, (e.state && e.state.scrollPosition) || 0);
+            await (router.onAfterRouteChange ?? router.onAfterRouteChanged)?.(href);
         });
         window.addEventListener('hashchange', (e) => {
             e.preventDefault();

package/dist/client/app/ssr.js

@@ -1,6 +1,6 @@
 // entry for SSR
-import { createApp } from './index';
 import { renderToString } from 'vue/server-renderer';
+import { createApp } from './index';
 export async function render(path) {
     const { app, router } = await createApp();
     await router.go(path);

package/dist/client/app/utils.js

@@ -1,7 +1,7 @@
-import { siteDataRef } from './data';
-import { inBrowser, EXTERNAL_URL_RE, sanitizeFileName } from '../shared';
 import { h, onMounted, onUnmounted, shallowRef } from 'vue';
-export { inBrowser, escapeHtml as _escapeHtml } from '../shared';
+import { EXTERNAL_URL_RE, inBrowser, sanitizeFileName } from '../shared';
+import { siteDataRef } from './data';
+export { escapeHtml as _escapeHtml, inBrowser } from '../shared';
 /**
  * Join two paths by resolving the slash collision.
  */

package/dist/client/index.d.ts

@@ -39,6 +39,10 @@ interface Router {
     /**
      * Called after the route changes.
      */
+    onAfterRouteChange?: (to: string) => Awaitable<void>;
+    /**
+     * @deprecated use `onAfterRouteChange` instead
+     */
     onAfterRouteChanged?: (to: string) => Awaitable<void>;
 }
 declare function useRouter(): Router;

package/dist/client/index.js

@@ -1,9 +1,9 @@
 // exports in this file are exposed to themes and md files via 'vitepress'
 // so the user can do `import { useRoute, useData } from 'vitepress'`
 // composables
-export { useData, dataSymbol } from './app/data';
+export { dataSymbol, useData } from './app/data';
 export { useRoute, useRouter } from './app/router';
 // utilities
-export { inBrowser, onContentUpdated, defineClientComponent, withBase, getScrollOffset, _escapeHtml } from './app/utils';
+export { _escapeHtml, defineClientComponent, getScrollOffset, inBrowser, onContentUpdated, withBase } from './app/utils';
 // components
 export { Content } from './app/components/Content';

package/dist/client/shared.js

@@ -31,7 +31,7 @@ export function isActive(currentPath, matchPath, asRegex = false) {
     }
     return true;
 }
-function normalize(path) {
+export function normalize(path) {
     return decodeURI(path)
         .replace(HASH_OR_QUERY_RE, '')
         .replace(INDEX_OR_EXT_RE, '$1');

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

@@ -29,10 +29,10 @@ const heroImageSlotExists = inject('hero-image-slot-exists') as Ref<boolean>
       <div class="main">
         <slot name="home-hero-info-before" />
         <slot name="home-hero-info">
-          <h1 v-if="name" class="name">
-            <span v-html="name" class="clip"></span>
+          <h1>
+            <span v-if="name" v-html="name" class="name clip"></span>
+            <span v-if="text" v-html="text" class="text"></span>
           </h1>
-          <p v-if="text" v-html="text" class="text"></p>
           <p v-if="tagline" v-html="tagline" class="tagline"></p>
         </slot>
         <slot name="home-hero-info-after" />
@@ -127,6 +127,7 @@ const heroImageSlotExists = inject('hero-image-slot-exists') as Ref<boolean>
 
 .name,
 .text {
+  display: inline-block;
   max-width: 392px;
   letter-spacing: -0.4px;
   line-height: 40px;

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

@@ -4,11 +4,15 @@ import VPHomeFeatures from './VPHomeFeatures.vue'
 import VPHomeContent from './VPHomeContent.vue'
 import { useData } from '../composables/data'
 
-const { frontmatter } = useData()
+const { frontmatter, theme } = useData()
 </script>
 
 <template>
-  <div class="VPHome">
+  <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>

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

@@ -125,7 +125,7 @@ function scrollToTop() {
   vertical-align: middle;
   margin-left: 2px;
   font-size: 14px;
-  transform: rotate(0deg);
+  transform: rotate(0)/*rtl:rotate(180deg)*/;
   transition: transform 0.25s;
 }
 
@@ -140,6 +140,7 @@ function scrollToTop() {
 }
 
 .open > .icon {
+  /*rtl:ignore*/
   transform: rotate(90deg);
 }
 

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

@@ -227,12 +227,13 @@ function onCaretClick() {
 
 .caret-icon {
   font-size: 18px;
+  /*rtl:ignore*/
   transform: rotate(90deg);
   transition: transform 0.25s;
 }
 
 .VPSidebarItem.collapsed .caret-icon {
-  transform: rotate(0);
+  transform: rotate(0)/*rtl:rotate(180deg)*/;
 }
 
 .VPSidebarItem.level-1 .items,

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

@@ -1,7 +1,9 @@
 <script lang="ts" setup>
 import { ref, watch } from 'vue'
 import { useRoute } from 'vitepress'
+import { useData } from '../composables/data'
 
+const { theme } = useData()
 const route = useRoute()
 const backToTop = ref()
 
@@ -33,7 +35,7 @@ function focusOnTargetAnchor({ target }: Event) {
     class="VPSkipLink visually-hidden"
     @click="focusOnTargetAnchor"
   >
-    Skip to content
+    {{ theme.skipToContentLabel || 'Skip to content' }}
   </a>
 </template>
 

package/dist/client/theme-default/composables/flyout.js

@@ -1,4 +1,4 @@
-import { ref, watch, readonly, onUnmounted } from 'vue';
+import { onUnmounted, readonly, ref, watch } from 'vue';
 import { inBrowser } from '../../shared';
 export const focusedElement = ref();
 let active = false;

package/dist/client/theme-default/composables/nav.js

@@ -1,5 +1,5 @@
-import { ref, watch } from 'vue';
 import { useRoute } from 'vitepress';
+import { ref, watch } from 'vue';
 export function useNav() {
     const isScreenOpen = ref(false);
     function openScreen() {

package/dist/client/theme-default/composables/outline.js

@@ -2,6 +2,7 @@ import { getScrollOffset } from 'vitepress';
 import { onMounted, onUnmounted, onUpdated } from 'vue';
 import { throttleAndDebounce } from '../support/utils';
 import { useAside } from './aside';
+const ignoreRE = /\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/;
 // cached list of anchor elements from resolveHeaders
 const resolvedHeaders = [];
 export function resolveTitle(theme) {
@@ -31,11 +32,8 @@ function serializeHeader(h) {
     let ret = '';
     for (const node of h.childNodes) {
         if (node.nodeType === 1) {
-            if (node.classList.contains('VPBadge') ||
-                node.classList.contains('header-anchor') ||
-                node.classList.contains('ignore-header')) {
+            if (ignoreRE.test(node.className))
                 continue;
-            }
             ret += node.textContent;
         }
         else if (node.nodeType === 3) {

package/dist/client/theme-default/composables/prev-next.js

@@ -1,7 +1,7 @@
 import { computed } from 'vue';
-import { useData } from './data';
 import { isActive } from '../../shared';
-import { getSidebar, getFlatSideBarLinks } from '../support/sidebar';
+import { getFlatSideBarLinks, getSidebar } from '../support/sidebar';
+import { useData } from './data';
 export function usePrevNext() {
     const { page, theme, frontmatter } = useData();
     return computed(() => {

package/dist/client/theme-default/styles/components/vp-doc.css

@@ -493,6 +493,7 @@
   border: 1px solid var(--vp-code-copy-code-hover-border-color);
   /*rtl:ignore*/
   border-right: 0;
+  /*rtl:ignore*/
   border-radius: 4px 0 0 4px;
   padding: 0 10px;
   width: fit-content;
@@ -554,7 +555,7 @@
  * -------------------------------------------------------------------------- */
 
 /* prettier-ignore */
-:is(.vp-external-link-icon, .vp-doc a[href*='://'], .vp-doc a[target='_blank']):not(.no-icon)::after {
+:is(.vp-external-link-icon, .vp-doc a[href*='://'], .vp-doc a[target='_blank']):not(:is(.no-icon, svg a, :has(img, svg)))::after {
   display: inline-block;
   margin-top: -1px;
   margin-left: 4px;
@@ -566,6 +567,7 @@
   --icon: url("data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' %3E%3Cpath d='M0 0h24v24H0V0z' fill='none' /%3E%3Cpath d='M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z' /%3E%3C/svg%3E");
   -webkit-mask-image: var(--icon);
   mask-image: var(--icon);
+  /*rtl:raw:transform: scaleX(-1);*/
 }
 
 .vp-external-link-icon::after {
@@ -573,7 +575,7 @@
 }
 
 /* prettier-ignore */
-.external-link-icon-enabled :is(.vp-doc a[href*='://'], .vp-doc a[target='_blank'])::after {
+.external-link-icon-enabled :is(.vp-doc a[href*='://'], .vp-doc a[target='_blank']):not(:is(.no-icon, svg a, :has(img, svg)))::after {
   content: '';
   color: currentColor;
 }

package/dist/client/theme-default/styles/fonts.css

@@ -46,9 +46,9 @@
   font-weight: 100 900;
   font-display: swap;
   src: url('../fonts/inter-roman-vietnamese.woff2') format('woff2');
-  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1,
-    U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329,
-    U+1EA0-1EF9, U+20AB;
+  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169,
+    U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323,
+    U+0329, U+1EA0-1EF9, U+20AB;
 }
 
 @font-face {
@@ -116,9 +116,9 @@
   font-weight: 100 900;
   font-display: swap;
   src: url('../fonts/inter-italic-vietnamese.woff2') format('woff2');
-  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1,
-    U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329,
-    U+1EA0-1EF9, U+20AB;
+  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169,
+    U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323,
+    U+0329, U+1EA0-1EF9, U+20AB;
 }
 
 @font-face {

package/dist/client/theme-default/styles/icons.css

@@ -39,14 +39,17 @@
 }
 .vpi-chevron-down,
 .vpi-arrow-down {
+  /*rtl:ignore*/
   transform: rotate(90deg);
 }
 .vpi-chevron-left,
 .vpi-arrow-left {
+  /*rtl:ignore*/
   transform: rotate(180deg);
 }
 .vpi-chevron-up,
 .vpi-arrow-up {
+  /*rtl:ignore*/
   transform: rotate(-90deg);
 }
 .vpi-square-pen {

package/dist/client/theme-default/styles/vars.css

@@ -174,15 +174,15 @@
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-c-text-1: rgba(60, 60, 67);
-  --vp-c-text-2: rgba(60, 60, 67, 0.78);
-  --vp-c-text-3: rgba(60, 60, 67, 0.56);
+  --vp-c-text-1: #3c3c43;
+  --vp-c-text-2: #67676c;
+  --vp-c-text-3: #929295;
 }
 
 .dark {
-  --vp-c-text-1: rgba(255, 255, 245, 0.86);
-  --vp-c-text-2: rgba(235, 235, 245, 0.6);
-  --vp-c-text-3: rgba(235, 235, 245, 0.38);
+  --vp-c-text-1: #dfdfd6;
+  --vp-c-text-2: #98989f;
+  --vp-c-text-3: #6a6a71;
 }
 
 /**
@@ -366,6 +366,23 @@
   --vp-code-tab-active-bar-color: var(--vp-c-brand-1);
 }
 
+:lang(es),
+:lang(pt) {
+  --vp-code-copy-copied-text-content: 'Copiado';
+}
+:lang(fa) {
+  --vp-code-copy-copied-text-content: 'کپی شد';
+}
+:lang(ko) {
+  --vp-code-copy-copied-text-content: '복사됨';
+}
+:lang(ru) {
+  --vp-code-copy-copied-text-content: 'Скопировано';
+}
+:lang(zh) {
+  --vp-code-copy-copied-text-content: '已复制';
+}
+
 /**
  * Component: Button
  * -------------------------------------------------------------------------- */

package/dist/client/theme-default/support/sidebar.js

@@ -1,5 +1,5 @@
-import { ensureStartingSlash } from './utils';
 import { isActive } from '../../shared';
+import { ensureStartingSlash } from './utils';
 /**
  * Get the `Sidebar` from sidebar option. This method will ensure to get correct
  * sidebar config from `MultiSideBarConfig` with various path combinations such

package/dist/client/theme-default/support/utils.js

@@ -1,6 +1,6 @@
 import { withBase } from 'vitepress';
-import { useData } from '../composables/data';
 import { isExternal, treatAsHtml } from '../../shared';
+import { useData } from '../composables/data';
 export function throttleAndDebounce(fn, delay) {
     let timeoutId;
     let called = false;
@@ -16,7 +16,7 @@ export function throttleAndDebounce(fn, delay) {
     };
 }
 export function ensureStartingSlash(path) {
-    return /^\//.test(path) ? path : `/${path}`;
+    return path.startsWith('/') ? path : `/${path}`;
 }
 export function normalizeLink(url) {
     const { pathname, search, hash, protocol } = new URL(url, 'http://a.com');

package/dist/client/theme-default/without-fonts.js

@@ -10,23 +10,25 @@ import './styles/components/vp-sponsor.css';
 import VPBadge from './components/VPBadge.vue';
 import Layout from './Layout.vue';
 export { default as VPBadge } from './components/VPBadge.vue';
-export { default as VPImage } from './components/VPImage.vue';
 export { default as VPButton } from './components/VPButton.vue';
+export { default as VPDocAsideSponsors } from './components/VPDocAsideSponsors.vue';
+export { default as VPFeatures } from './components/VPFeatures.vue';
 export { default as VPHomeContent } from './components/VPHomeContent.vue';
-export { default as VPHomeHero } from './components/VPHomeHero.vue';
 export { default as VPHomeFeatures } from './components/VPHomeFeatures.vue';
+export { default as VPHomeHero } from './components/VPHomeHero.vue';
 export { default as VPHomeSponsors } from './components/VPHomeSponsors.vue';
+export { default as VPImage } from './components/VPImage.vue';
 export { default as VPLink } from './components/VPLink.vue';
-export { default as VPDocAsideSponsors } from './components/VPDocAsideSponsors.vue';
+export { default as VPNavBarSearch } from './components/VPNavBarSearch.vue';
 export { default as VPSocialLink } from './components/VPSocialLink.vue';
 export { default as VPSocialLinks } from './components/VPSocialLinks.vue';
 export { default as VPSponsors } from './components/VPSponsors.vue';
+export { default as VPTeamMembers } from './components/VPTeamMembers.vue';
 export { default as VPTeamPage } from './components/VPTeamPage.vue';
-export { default as VPTeamPageTitle } from './components/VPTeamPageTitle.vue';
 export { default as VPTeamPageSection } from './components/VPTeamPageSection.vue';
-export { default as VPTeamMembers } from './components/VPTeamMembers.vue';
-export { useSidebar } from './composables/sidebar';
+export { default as VPTeamPageTitle } from './components/VPTeamPageTitle.vue';
 export { useLocalNav } from './composables/local-nav';
+export { useSidebar } from './composables/sidebar';
 const theme = {
     Layout,
     enhanceApp: ({ app }) => {