vitepress 0.22.4 → 1.0.0-draft.1

package/dist/client/theme-default/components/icons/VPIconPlus.vue

@@ -0,0 +1,5 @@
+<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>

package/dist/client/theme-default/components/icons/VPIconSlack.vue

@@ -0,0 +1,5 @@
+<template>
+  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
+    <path d="M5.042 15.165a2.528 2.528 0 0 1-2.52 2.523A2.528 2.528 0 0 1 0 15.165a2.527 2.527 0 0 1 2.522-2.52h2.52v2.52zM6.313 15.165a2.527 2.527 0 0 1 2.521-2.52 2.527 2.527 0 0 1 2.521 2.52v6.313A2.528 2.528 0 0 1 8.834 24a2.528 2.528 0 0 1-2.521-2.522v-6.313zM8.834 5.042a2.528 2.528 0 0 1-2.521-2.52A2.528 2.528 0 0 1 8.834 0a2.528 2.528 0 0 1 2.521 2.522v2.52H8.834zM8.834 6.313a2.528 2.528 0 0 1 2.521 2.521 2.528 2.528 0 0 1-2.521 2.521H2.522A2.528 2.528 0 0 1 0 8.834a2.528 2.528 0 0 1 2.522-2.521h6.312zM18.956 8.834a2.528 2.528 0 0 1 2.522-2.521A2.528 2.528 0 0 1 24 8.834a2.528 2.528 0 0 1-2.522 2.521h-2.522V8.834zM17.688 8.834a2.528 2.528 0 0 1-2.523 2.521 2.527 2.527 0 0 1-2.52-2.521V2.522A2.527 2.527 0 0 1 15.165 0a2.528 2.528 0 0 1 2.523 2.522v6.312zM15.165 18.956a2.528 2.528 0 0 1 2.523 2.522A2.528 2.528 0 0 1 15.165 24a2.527 2.527 0 0 1-2.52-2.522v-2.522h2.52zM15.165 17.688a2.527 2.527 0 0 1-2.52-2.523 2.526 2.526 0 0 1 2.52-2.52h6.313A2.527 2.527 0 0 1 24 15.165a2.528 2.528 0 0 1-2.522 2.523h-6.313z" />
+  </svg>
+</template>

package/dist/client/theme-default/components/icons/VPIconSun.vue

@@ -0,0 +1,13 @@
+<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>

package/dist/client/theme-default/components/icons/VPIconTwitter.vue

@@ -0,0 +1,5 @@
+<template>
+  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
+    <path d="M23.953 4.57a10 10 0 01-2.825.775 4.958 4.958 0 002.163-2.723c-.951.555-2.005.959-3.127 1.184a4.92 4.92 0 00-8.384 4.482C7.69 8.095 4.067 6.13 1.64 3.162a4.822 4.822 0 00-.666 2.475c0 1.71.87 3.213 2.188 4.096a4.904 4.904 0 01-2.228-.616v.06a4.923 4.923 0 003.946 4.827 4.996 4.996 0 01-2.212.085 4.936 4.936 0 004.604 3.417 9.867 9.867 0 01-6.102 2.105c-.39 0-.779-.023-1.17-.067a13.995 13.995 0 007.557 2.209c9.053 0 13.998-7.496 13.998-13.985 0-.21 0-.42-.015-.63A9.935 9.935 0 0024 4.59z" />
+  </svg>
+</template>

package/dist/client/theme-default/components/icons/VPIconYouTube.vue

@@ -0,0 +1,5 @@
+<template>
+  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewBox="0 0 24 24">
+    <path d="M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z" />
+  </svg>
+</template>

package/dist/client/theme-default/composables/edit-link.js

@@ -0,0 +1,22 @@
+import { computed } from 'vue';
+import { useData } from 'vitepress';
+export function useEditLink() {
+    const { theme, page } = useData();
+    return computed(() => {
+        const url = [
+            'https://github.com',
+            theme.value.editLink?.repo || '???',
+            'edit',
+            theme.value.editLink?.branch || 'main',
+            theme.value.editLink?.dir || null,
+            page.value.relativePath
+        ]
+            .filter((v) => v)
+            .join('/');
+        const text = theme.value.editLink?.text ?? 'Edit this page';
+        return {
+            url,
+            text
+        };
+    });
+}

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

@@ -0,0 +1,40 @@
+import { ref, watch, readonly, onUnmounted } from 'vue';
+export const focusedElement = ref();
+let active = false;
+let listeners = 0;
+export function useFlyout(options) {
+    const focus = ref(false);
+    if (typeof window !== 'undefined') {
+        !active && activateFocusTracking();
+        listeners++;
+        const unwatch = watch(focusedElement, (el) => {
+            if (el === options.el.value || options.el.value?.contains(el)) {
+                focus.value = true;
+                options.onFocus?.();
+            }
+            else {
+                focus.value = false;
+                options.onBlur?.();
+            }
+        });
+        onUnmounted(() => {
+            unwatch();
+            listeners--;
+            if (!listeners) {
+                deactivateFocusTracking();
+            }
+        });
+    }
+    return readonly(focus);
+}
+function activateFocusTracking() {
+    document.addEventListener('focusin', handleFocusIn);
+    active = true;
+    focusedElement.value = document.activeElement;
+}
+function deactivateFocusTracking() {
+    document.removeEventListener('focusin', handleFocusIn);
+}
+function handleFocusIn() {
+    focusedElement.value = document.activeElement;
+}

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

@@ -1,5 +1,31 @@
-import { computed } from 'vue';
+import { ref, computed } from 'vue';
 import { useData, useRoute } from 'vitepress';
+export function useNav() {
+    const isScreenOpen = ref(false);
+    function openScreen() {
+        isScreenOpen.value = true;
+        window.addEventListener('resize', closeScreenOnTabletWindow);
+    }
+    function closeScreen() {
+        isScreenOpen.value = false;
+        window.removeEventListener('resize', closeScreenOnTabletWindow);
+    }
+    function toggleScreen() {
+        isScreenOpen.value ? closeScreen() : openScreen();
+    }
+    /**
+     * Close screen when the user resizes the window wider than tablet size.
+     */
+    function closeScreenOnTabletWindow() {
+        window.outerWidth >= 768 && closeScreen();
+    }
+    return {
+        isScreenOpen,
+        openScreen,
+        closeScreen,
+        toggleScreen
+    };
+}
 export function useLanguageLinks() {
     const { site, localePath, theme } = useData();
     return computed(() => {

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

@@ -0,0 +1,130 @@
+import { onMounted, onUpdated, onUnmounted } from 'vue';
+import { useMediaQuery } from '@vueuse/core';
+// magic number to avoid repeated retrieval
+const PAGE_OFFSET = 56;
+export function resolveHeaders(headers) {
+    return mapHeaders(groupHeaders(headers));
+}
+function groupHeaders(headers) {
+    headers = headers.map((h) => Object.assign({}, h));
+    let lastH2;
+    for (const h of headers) {
+        if (h.level === 2) {
+            lastH2 = h;
+        }
+        else if (lastH2 && h.level <= 3) {
+            ;
+            (lastH2.children || (lastH2.children = [])).push(h);
+        }
+    }
+    return headers.filter((h) => h.level === 2);
+}
+function mapHeaders(headers) {
+    return headers.map((header) => ({
+        text: header.title,
+        link: `#${header.slug}`,
+        children: header.children ? mapHeaders(header.children) : undefined,
+        hidden: header.hidden
+    }));
+}
+export function useActiveAnchor(container, marker) {
+    const isOutlineEnabled = useMediaQuery('(min-width: 1280px)');
+    const onScroll = throttleAndDebounce(setActiveLink, 100);
+    let prevActiveLink = null;
+    onMounted(() => {
+        requestAnimationFrame(setActiveLink);
+        window.addEventListener('scroll', onScroll);
+    });
+    onUpdated(() => {
+        // sidebar update means a route change
+        activateLink(location.hash);
+    });
+    onUnmounted(() => {
+        window.removeEventListener('scroll', onScroll);
+    });
+    function setActiveLink() {
+        if (!isOutlineEnabled.value) {
+            return;
+        }
+        const links = [].slice.call(container.value.querySelectorAll('.outline-link'));
+        const anchors = [].slice
+            .call(document.querySelectorAll('.content .header-anchor'))
+            .filter((anchor) => {
+            return links.some((link) => {
+                return link.hash === anchor.hash && anchor.offsetParent !== null;
+            });
+        });
+        const scrollY = window.scrollY;
+        const innerHeight = window.innerHeight;
+        const offsetHeight = document.body.offsetHeight;
+        const isBottom = scrollY + innerHeight === offsetHeight;
+        // page bottom - highlight last one
+        if (anchors.length && isBottom) {
+            activateLink(anchors[anchors.length - 1].hash);
+            return;
+        }
+        for (let i = 0; i < anchors.length; i++) {
+            const anchor = anchors[i];
+            const nextAnchor = anchors[i + 1];
+            const [isActive, hash] = isAnchorActive(i, anchor, nextAnchor);
+            if (isActive) {
+                history.replaceState(null, document.title, hash ? hash : ' ');
+                activateLink(hash);
+                return;
+            }
+        }
+    }
+    function activateLink(hash) {
+        if (prevActiveLink) {
+            prevActiveLink.classList.remove('active');
+        }
+        if (hash !== null) {
+            prevActiveLink = container.value.querySelector(`a[href="${decodeURIComponent(hash)}"]`);
+        }
+        const activeLink = prevActiveLink;
+        if (activeLink) {
+            activeLink.classList.add('active');
+            marker.value.style.top = activeLink.offsetTop + 33 + 'px';
+            marker.value.style.opacity = '1';
+        }
+        else {
+            marker.value.style.top = '33px';
+            marker.value.style.opacity = '0';
+        }
+    }
+}
+function getAnchorTop(anchor) {
+    return anchor.parentElement.offsetTop - PAGE_OFFSET - 15;
+}
+function isAnchorActive(index, anchor, nextAnchor) {
+    const scrollTop = window.scrollY;
+    if (index === 0 && scrollTop === 0) {
+        return [true, null];
+    }
+    if (scrollTop < getAnchorTop(anchor)) {
+        return [false, null];
+    }
+    if (!nextAnchor || scrollTop < getAnchorTop(nextAnchor)) {
+        return [true, anchor.hash];
+    }
+    return [false, null];
+}
+function throttleAndDebounce(fn, delay) {
+    let timeout;
+    let called = false;
+    return () => {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+        if (!called) {
+            fn();
+            called = true;
+            setTimeout(() => {
+                called = false;
+            }, delay);
+        }
+        else {
+            timeout = setTimeout(fn, delay);
+        }
+    };
+}

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

@@ -0,0 +1,18 @@
+import { computed } from 'vue';
+import { useData } from 'vitepress';
+import { isActive } from '../support/utils';
+import { getSidebar, getFlatSideBarLinks } from '../support/sidebar';
+export function usePrevNext() {
+    const { page, theme } = useData();
+    return computed(() => {
+        const sidebar = getSidebar(theme.value.sidebar, page.value.relativePath);
+        const candidates = getFlatSideBarLinks(sidebar);
+        const index = candidates.findIndex((link) => {
+            return isActive(page.value.relativePath, link.link);
+        });
+        return {
+            prev: candidates[index - 1],
+            next: candidates[index + 1]
+        };
+    });
+}

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

@@ -0,0 +1,57 @@
+import { ref, computed, watchEffect, onMounted, onUnmounted } from 'vue';
+import { useRoute, useData } from 'vitepress';
+import { getSidebar } from '../support/sidebar';
+export function useSidebar() {
+    const route = useRoute();
+    const { theme, frontmatter } = useData();
+    const isOpen = ref(false);
+    const sidebar = computed(() => {
+        const sidebarConfig = theme.value.sidebar;
+        const relativePath = route.data.relativePath;
+        return sidebarConfig ? getSidebar(sidebarConfig, relativePath) : [];
+    });
+    const hasSidebar = computed(() => {
+        return frontmatter.value.sidebar !== false && sidebar.value.length > 0;
+    });
+    function open() {
+        isOpen.value = true;
+    }
+    function close() {
+        isOpen.value = false;
+    }
+    function toggle() {
+        isOpen.value ? close() : open();
+    }
+    return {
+        isOpen,
+        sidebar,
+        hasSidebar,
+        open,
+        close,
+        toggle
+    };
+}
+/**
+ * a11y: cache the element that opened the Sidebar (the menu button) then
+ * focus that button again when Menu is closed with Escape key.
+ */
+export function useCloseSidebarOnEscape(isOpen, close) {
+    let triggerElement;
+    watchEffect(() => {
+        triggerElement = isOpen.value
+            ? document.activeElement
+            : undefined;
+    });
+    onMounted(() => {
+        window.addEventListener('keyup', onEscape);
+    });
+    onUnmounted(() => {
+        window.removeEventListener('keyup', onEscape);
+    });
+    function onEscape(e) {
+        if (e.key === 'Escape' && isOpen.value) {
+            close();
+            triggerElement?.focus();
+        }
+    }
+}

package/dist/client/theme-default/index.js

@@ -1,8 +1,8 @@
+import './styles/fonts.css';
 import './styles/vars.css';
-import './styles/layout.css';
-import './styles/code.css';
-import './styles/custom-blocks.css';
-import './styles/sidebar-links.css';
+import './styles/base.css';
+import './styles/utils.css';
+import './styles/vp-doc.css';
 import Layout from './Layout.vue';
 import NotFound from './NotFound.vue';
 const theme = {

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

@@ -0,0 +1,200 @@
+*,
+::before,
+::after {
+  box-sizing: border-box;
+}
+
+html {
+  line-height: 1.4;
+  font-size: 16px;
+  -webkit-text-size-adjust: 100%;
+}
+
+body {
+  margin: 0;
+  width: 100%;
+  min-width: 320px;
+  min-height: 100vh;
+  line-height: 24px;
+  font-family: var(--vp-font-family-base);
+  font-size: 16px;
+  font-weight: 400;
+  color: var(--vp-c-text-1);
+  background-color: var(--vp-c-bg-content);
+  direction: ltr;
+  font-synthesis: none;
+  text-rendering: optimizeLegibility;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+main {
+  display: block;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  margin: 0;
+}
+
+p {
+  margin: 0;
+}
+
+strong,
+b {
+  font-weight: 600;
+}
+
+/**
+ * Avoid 300ms click delay on touch devices that support the `touch-action`
+ * CSS property.
+ *
+ * In particular, unlike most other browsers, IE11+Edge on Windows 10 on
+ * touch devices and IE Mobile 10-11 DON'T remove the click delay when
+ * `<meta name="viewport" content="width=device-width">` is present.
+ * However, they DO support removing the click delay via
+ * `touch-action: manipulation`.
+ *
+ * See:
+ * - http://v4-alpha.getbootstrap.com/content/reboot/#click-delay-optimization-for-touch
+ * - http://caniuse.com/#feat=css-touch-action
+ * - http://patrickhlauke.github.io/touch/tests/results/#suppressing-300ms-delay
+ */
+a,
+area,
+button,
+[role="button"],
+input,
+label,
+select,
+summary,
+textarea {
+  touch-action: manipulation;
+}
+
+a {
+  color: inherit;
+  text-decoration: inherit;
+}
+
+ol,
+ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+pre,
+code,
+kbd,
+samp {
+  font-family: var(--vp-font-family-mono);
+}
+
+img,
+svg,
+video,
+canvas,
+audio,
+iframe,
+embed,
+object {
+  display: block;
+  vertical-align: middle;
+}
+
+img,
+video {
+  max-width: 100%;
+  height: auto;
+}
+
+button,
+input,
+optgroup,
+select,
+textarea {
+  border: 0;
+  padding: 0;
+  line-height: inherit;
+  color: inherit;
+}
+
+button {
+  padding: 0;
+  font-family: inherit;;
+  background-color: transparent;
+  background-image: none;
+}
+
+button,
+[role="button"] {
+  cursor: pointer;
+}
+
+button:focus,
+button:focus-visible {
+  outline: 1px dotted;
+  outline: 4px auto -webkit-focus-ring-color;
+}
+
+button:focus:not(:focus-visible) {
+  outline: none !important;
+}
+
+input:focus,
+textarea:focus,
+select:focus {
+  outline: none;
+}
+
+table {
+  border-collapse: collapse;
+}
+
+input {
+  background-color: transparent;
+}
+
+input:-ms-input-placeholder,
+textarea:-ms-input-placeholder {
+  color: var(--vp-c-text-3);
+}
+
+input::-ms-input-placeholder,
+textarea::-ms-input-placeholder {
+  color: var(--vp-c-text-3);
+}
+
+input::placeholder,
+textarea::placeholder {
+  color: var(--vp-c-text-3);
+}
+
+input::-webkit-outer-spin-button,
+input::-webkit-inner-spin-button {
+  -webkit-appearance: none;
+  margin: 0;
+}
+
+input[type="number"] {
+  -moz-appearance: textfield;
+}
+
+textarea {
+  resize: vertical;
+}
+
+select {
+  -webkit-appearance: none;
+}
+
+fieldset {
+  margin: 0;
+  padding: 0;
+}

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

@@ -0,0 +1,67 @@
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-weight: 100 900;
+  font-display: swap;
+  src: url(../fonts/inter-latin.woff2) format('woff2');
+  unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da,
+    U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215,
+    U+feff, U+fffd;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-weight: 400 500 600 700 900;
+  font-display: swap;
+  src: url(../fonts/inter-latin-ext.woff2) format('woff2');
+  unicode-range: U+0100-024f, U+0259, U+1e??, U+2020, U+20a0-20ab, U+20ad-20cf,
+    U+2113, U+2c60-2c7f, U+a720-a7ff;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-weight: 400 500 600 700 900;
+  font-display: swap;
+  src: url(../fonts/inter-cyrillic.woff2) format('woff2');
+  unicode-range: U+0400-045f, U+0490-0491, U+04b0-04b1, U+2116;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-weight: 400 500 600 700 900;
+  font-display: swap;
+  src: url(../fonts/inter-cyrillic-ext.woff2) format('woff2');
+  unicode-range: U+0460-052f, U+1c80-1c88, U+20b4, U+2de0-2dff, U+a640-a69f,
+    U+fe2e-fe2f;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-weight: 400 500 600 700 900;
+  font-display: swap;
+  src: url(../fonts/inter-greek.woff2) format('woff2');
+  unicode-range: U+0370-03ff;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-weight: 400 500 600 700 900;
+  font-display: swap;
+  src: url(../fonts/inter-greek-ext.woff2) format('woff2');
+  unicode-range: U+1f??;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-weight: 400 500 600 700 900;
+  font-display: swap;
+  src: url(../fonts/inter-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+1ea0-1ef9, U+20ab;
+}

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

@@ -0,0 +1,9 @@
+.visually-hidden {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  white-space: nowrap;
+  clip: rect(0 0 0 0);
+  clip-path: inset(50%);
+  overflow: hidden;
+}