vitepress 0.22.3 → 1.0.0-draft.2

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

@@ -0,0 +1,425 @@
+/**
+ * Headings
+ * -------------------------------------------------------------------------- */
+
+.vp-doc h1,
+.vp-doc h2,
+.vp-doc h3,
+.vp-doc h4,
+.vp-doc h5,
+.vp-doc h6 {
+  position: relative;
+  font-weight: 600;
+  outline: none;
+}
+
+.vp-doc h1 {
+  letter-spacing: -0.02em;
+  line-height: 40px;
+  font-size: 28px;
+}
+
+.vp-doc h2 {
+  margin: 48px 0 0;
+  border-top: 1px solid var(--vp-c-divider-light);
+  padding-top: 24px;
+  letter-spacing: -0.02em;
+  line-height: 32px;
+  font-size: 24px;
+}
+
+.vp-doc h3 {
+  margin: 48px 0 0;
+  letter-spacing: -0.01em;
+  line-height: 28px;
+  font-size: 20px;
+}
+
+.vp-doc .header-anchor {
+  float: left;
+  margin-left: -0.87em;
+  padding-right: 0.23em;
+  font-weight: 500;
+  opacity: 0;
+  transition: color 0.25s, opacity 0.25s;
+}
+
+.vp-doc h1:hover .header-anchor,
+.vp-doc h1 .header-anchor:focus,
+.vp-doc h2:hover .header-anchor,
+.vp-doc h2 .header-anchor:focus,
+.vp-doc h3:hover .header-anchor,
+.vp-doc h3 .header-anchor:focus,
+.vp-doc h4:hover .header-anchor,
+.vp-doc h4 .header-anchor:focus,
+.vp-doc h5:hover .header-anchor,
+.vp-doc h5 .header-anchor:focus,
+.vp-doc h6:hover .header-anchor,
+.vp-doc h6 .header-anchor:focus {
+  opacity: 1;
+}
+
+@media (min-width: 768px) {
+  .vp-doc h1 {
+    letter-spacing: -0.02em;
+    line-height: 40px;
+    font-size: 32px;
+  }
+}
+
+/**
+ * Paragraph and inline elements
+ * -------------------------------------------------------------------------- */
+
+.vp-doc p,
+.vp-doc summary {
+  margin: 16px 0;
+}
+
+.vp-doc p {
+  line-height: 28px;
+}
+
+.vp-doc blockquote {
+  margin: 16px 0;
+  border-left: 2px solid var(--vp-c-divider);
+  padding-left: 16px;
+  transition: border-color 0.5s;
+}
+
+.vp-doc blockquote > p {
+  margin: 0;
+  font-size: 16px;
+  color: var(--vp-c-text-2);
+  transition: color 0.5s;
+}
+
+.vp-doc a {
+  font-weight: 500;
+  color: var(--vp-c-brand);
+  text-decoration-style: dotted;
+  transition: color 0.25s;
+}
+
+.vp-doc a:hover {
+  color: var(--vp-c-brand-dark);
+}
+
+.vp-doc strong {
+  font-weight: 600;
+}
+
+/**
+ * Lists
+ * -------------------------------------------------------------------------- */
+
+.vp-doc ul,
+.vp-doc ol {
+  margin: 16px 0;
+}
+
+.vp-doc ul {
+  padding-left: 1.25rem;
+  list-style: disc;
+}
+
+.vp-doc li + li {
+  margin-top: 8px;
+}
+
+/**
+ * Table
+ * -------------------------------------------------------------------------- */
+
+.vp-doc table {
+  display: block;
+  border-collapse: collapse;
+  margin: 20px 0;
+  overflow-x: auto;
+}
+
+.vp-doc tr {
+  border-top: 1px solid var(--vp-c-divider);
+  transition: background-color 0.5s;
+}
+
+.vp-doc tr:nth-child(2n) {
+  background-color: var(--vp-c-bg-soft);
+}
+
+.dark .vp-doc tr:nth-child(2n) {
+  background-color: var(--vp-c-bg-mute);
+}
+
+.vp-doc th,
+.vp-doc td {
+  border: 1px solid var(--vp-c-divider);
+  padding: 12px 16px;
+}
+
+.vp-doc th {
+  font-size: 16px;
+  font-weight: 600;
+  background-color: var(--vp-c-white-soft);
+}
+
+.dark .vp-doc th {
+  background-color: var(--vp-c-black);
+}
+
+/**
+ * Decorational elements
+ * -------------------------------------------------------------------------- */
+
+.vp-doc hr {
+  margin: 16px 0;
+  border: none;
+  border-top: 1px solid var(--vp-c-divider-light);
+}
+
+/**
+ * Code
+ * -------------------------------------------------------------------------- */
+
+/* inline code */
+.vp-doc :not(pre, h1, h2, h3, h4, h5, h6) > code {
+  font-size: var(--vp-code-font-size);
+}
+
+.vp-doc :not(pre) > code {
+  border-radius: 4px;
+  padding: 3px 6px;
+  color: var(--vp-c-text-code);
+  background-color: var(--vp-c-bg-mute);
+  transition: color 0.5s, background-color 0.5s;
+}
+
+.vp-doc h1 > code,
+.vp-doc h2 > code,
+.vp-doc h3 > code {
+  font-size: 0.9em;
+}
+
+@media (min-width: 768px) {
+  .vp-doc :not(pre) > code {
+    white-space: nowrap;
+  }
+}
+
+.vp-doc a > code {
+  color: var(--vp-c-brand-dark);
+}
+
+.vp-doc div[class*='language-'] {
+  position: relative;
+  margin: 20px -24px;
+  background-color: var(--vp-code-block-bg);
+  overflow-x: auto;
+  transition: background-color 0.5s;
+}
+
+@media (min-width: 640px) {
+  .vp-doc div[class*='language-'] {
+    border-radius: 8px;
+    margin: 24px 0;
+  }
+}
+
+@media (max-width: 639px) {
+  .vp-doc li div[class*='language-'] {
+    border-radius: 8px 0 0 8px;
+  }
+}
+
+.vp-doc div[class*='language-'] + div[class*='language-'],
+.vp-doc div[class$='-api'] + div[class*='language-'],
+.vp-doc div[class*='language-'] + div[class$='-api'] > div[class*='language-'] {
+  margin-top: -12px;
+}
+
+.vp-doc [class*='language-'] pre,
+.vp-doc [class*='language-'] code {
+  text-align: left;
+  white-space: pre;
+  word-spacing: normal;
+  word-break: normal;
+  word-wrap: normal;
+  -moz-tab-size: 4;
+  -o-tab-size: 4;
+  tab-size: 4;
+  -webkit-hyphens: none;
+  -moz-hyphens: none;
+  -ms-hyphens: none;
+  hyphens: none;
+}
+
+.vp-doc [class*='language-'] pre {
+  position: relative;
+  z-index: 1;
+  margin: 0;
+  padding: 16px 24px;
+  background: transparent;
+  overflow-x: auto;
+}
+
+.vp-doc [class*='language-'] code {
+  display: inline-block;
+  padding: 0;
+  line-height: var(--vp-code-line-height);
+  font-size: var(--vp-code-font-size);
+  color: var(--vp-code-block-color);
+  transition: color 0.5s;
+}
+
+.vp-doc .highlight-lines {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  padding: 13px 0 11px;
+  width: 100%;
+  font-family: var(--vp-font-family-mono);
+  line-height: var(--vp-code-line-height);
+  font-size: var(--vp-code-font-size);
+  user-select: none;
+  overflow: hidden;
+}
+
+.vp-doc .highlight-lines .highlighted {
+  background-color: rgba(0, 0, 0, 0.3);
+  transition: background-color 0.5s;
+}
+
+.dark .vp-doc .highlight-lines .highlighted {
+  background-color: rgba(255, 255, 255, 0.05);
+}
+
+.vp-doc div[class*='language-'].line-numbers-mode {
+  padding-left: 32px;
+}
+
+.vp-doc .line-numbers-wrapper {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  z-index: 3;
+  border-right: 1px solid var(--vp-c-divider-light);
+  padding: 13px 0 11px;
+  width: 32px;
+  text-align: center;
+  font-family: var(--vp-font-family-mono);
+  line-height: var(--vp-code-line-height);
+  font-size: var(--vp-code-font-size);
+  color: var(--vp-c-text-3);
+  transition: border-color 0.5s, color 0.5s;
+}
+
+.vp-doc [class*='language-']:before {
+  position: absolute;
+  top: 4px;
+  right: 10px;
+  z-index: 2;
+  font-size: 12px;
+  font-weight: 500;
+  color: var(--vp-c-text-dark-3);
+  transition: color 0.5s;
+}
+
+.vp-doc [class~='language-vue']:before      { content: 'vue'; }
+.vp-doc [class~='language-html']:before     { content: 'html'; }
+.vp-doc [class~='language-vue-html']:before { content: 'template'; }
+.vp-doc [class~='language-css']:before      { content: 'css'; }
+.vp-doc [class~='language-js']:before       { content: 'js'; }
+.vp-doc [class~='language-jsx']:before      { content: 'jsx'; }
+.vp-doc [class~='language-ts']:before       { content: 'ts'; }
+.vp-doc [class~='language-tsx']:before      { content: 'tsx'; }
+.vp-doc [class~='language-json']:before     { content: 'json'; }
+.vp-doc [class~='language-yaml']:before     { content: 'yaml'; }
+.vp-doc [class~='language-yml']:before      { content: 'yaml'; }
+.vp-doc [class~='language-sh']:before       { content: 'sh'; }
+.vp-doc [class~='language-bash']:before     { content: 'sh'; }
+
+/**
+ * Code: Highlight
+ *
+ * prism.js tomorrow night eighties theme.
+ * https://github.com/chriskempson/tomorrow-theme
+ *
+ * @author Rose Pritchard
+ * -------------------------------------------------------------------------- */
+
+.token.comment,
+.token.block-comment,
+.token.prolog,
+.token.doctype,
+.token.cdata {
+  color: #999;
+}
+
+.token.punctuation {
+  color: #ccc;
+}
+
+.token.tag,
+.token.attr-name,
+.token.namespace,
+.token.deleted {
+  color: #e2777a;
+}
+
+.token.function-name {
+  color: #6196cc;
+}
+
+.token.boolean,
+.token.number,
+.token.function {
+  color: #f08d49;
+}
+
+.token.property,
+.token.class-name,
+.token.constant,
+.token.symbol {
+  color: #f8c555;
+}
+
+.token.selector,
+.token.important,
+.token.atrule,
+.token.keyword,
+.token.builtin {
+  color: #cc99cd;
+}
+
+.token.string,
+.token.char,
+.token.attr-value,
+.token.regex,
+.token.variable {
+  color: #7ec699;
+}
+
+.token.operator,
+.token.entity,
+.token.url {
+  color: #67cdcc;
+}
+
+.token.important,
+.token.bold {
+  font-weight: bold;
+}
+
+.token.italic {
+  font-style: italic;
+}
+
+.token.entity {
+  cursor: help;
+}
+
+.token.inserted {
+  color: green;
+}

package/dist/client/theme-default/styles/vp-sponsor.css

@@ -0,0 +1,86 @@
+.vp-sponsor-grid {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+}
+
+.vp-sponsor-grid.small .vp-sponsor-grid-link   { height: 96px; }
+.vp-sponsor-grid.small .vp-sponsor-grid-image  { max-width: 96px; max-height: 24px }
+
+.vp-sponsor-grid.medium .vp-sponsor-grid-link  { height: 112px; }
+.vp-sponsor-grid.medium .vp-sponsor-grid-image { max-width: 120px; max-height: 36px }
+
+.vp-sponsor-grid.big .vp-sponsor-grid-link     { height: 184px; }
+.vp-sponsor-grid.big .vp-sponsor-grid-image    { max-width: 192px; max-height: 56px }
+
+.vp-sponsor-grid[data-vp-grid="2"] .vp-sponsor-grid-item {
+  width: calc((100% - 4px) / 2);
+}
+
+.vp-sponsor-grid[data-vp-grid="3"] .vp-sponsor-grid-item {
+  width: calc((100% - 4px * 2) / 3);
+}
+
+.vp-sponsor-grid[data-vp-grid="4"] .vp-sponsor-grid-item {
+  width: calc((100% - 4px * 3) / 4);
+}
+
+.vp-sponsor-grid[data-vp-grid="5"] .vp-sponsor-grid-item {
+  width: calc((100% - 4px * 4) / 5);
+}
+
+.vp-sponsor-grid[data-vp-grid="6"] .vp-sponsor-grid-item {
+  width: calc((100% - 4px * 5) / 6);
+}
+
+.vp-sponsor-grid-item {
+  flex-shrink: 0;
+  width: 100%;
+  background-color: var(--vp-c-white-soft);
+  transition: background-color 0.25s;
+}
+
+.vp-sponsor-grid-item:hover {
+  background-color: var(--vp-c-white-mute);
+}
+
+.vp-sponsor-grid-item:hover .vp-sponsor-grid-image {
+  filter: grayscale(0) invert(0);
+}
+
+.vp-sponsor-grid-item.empty:hover {
+  background-color: var(--vp-c-white-soft);
+}
+
+.dark .vp-sponsor-grid-item {
+  background-color: var(--vp-c-black-mute);
+}
+
+.dark .vp-sponsor-grid-item:hover {
+  background-color: var(--vp-c-white-soft);
+}
+
+.dark .vp-sponsor-grid-item.empty:hover {
+  background-color: var(--vp-c-black-mute);
+}
+
+.vp-sponsor-grid-link {
+  display: flex;
+}
+
+.vp-sponsor-grid-box {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  width: 100%;
+}
+
+.vp-sponsor-grid-image {
+  max-width: 100%;
+  filter: grayscale(1);
+  transition: filter 0.25s;
+}
+
+.dark .vp-sponsor-grid-image {
+  filter: grayscale(1) invert(1);
+}

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

@@ -0,0 +1,29 @@
+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
+ * as matching `guide/` and `/guide/`. If no matching config was found, it will
+ * return empty array.
+ */
+export function getSidebar(sidebar, path) {
+    if (Array.isArray(sidebar)) {
+        return sidebar;
+    }
+    path = ensureStartingSlash(path);
+    for (const dir in sidebar) {
+        // make sure the multi sidebar key starts with slash too
+        if (path.startsWith(ensureStartingSlash(dir))) {
+            return sidebar[dir];
+        }
+    }
+    return [];
+}
+export function getFlatSideBarLinks(sidebar) {
+    const links = [];
+    for (const group of sidebar) {
+        for (const link of group.items) {
+            links.push(link);
+        }
+    }
+    return links;
+}

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

@@ -0,0 +1,62 @@
+import { ref } from 'vue';
+import { withBase } from 'vitepress';
+export const HASH_RE = /#.*$/;
+export const EXT_RE = /(index)?\.(md|html)$/;
+export const OUTBOUND_RE = /^[a-z]+:/i;
+const inBrowser = typeof window !== 'undefined';
+const hashRef = ref(inBrowser ? location.hash : '');
+export function isExternal(path) {
+    return OUTBOUND_RE.test(path);
+}
+export 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);
+        }
+    };
+}
+export function isActive(currentPath, matchPath, asRegex = false) {
+    if (matchPath === undefined) {
+        return false;
+    }
+    currentPath = normalize(`/${currentPath}`);
+    if (asRegex) {
+        return new RegExp(matchPath).test(currentPath);
+    }
+    if (normalize(matchPath) !== currentPath) {
+        return false;
+    }
+    const hashMatch = matchPath.match(HASH_RE);
+    if (hashMatch) {
+        return hashRef.value === hashMatch[0];
+    }
+    return true;
+}
+export function ensureStartingSlash(path) {
+    return /^\//.test(path) ? path : `/${path}`;
+}
+export function normalize(path) {
+    return decodeURI(path).replace(HASH_RE, '').replace(EXT_RE, '');
+}
+export function normalizeLink(url) {
+    if (isExternal(url)) {
+        return url;
+    }
+    const { pathname, search, hash } = new URL(url, 'http://example.com');
+    const normalizedPath = pathname.endsWith('/') || pathname.endsWith('.html')
+        ? url
+        : `${pathname.replace(/(\.md)?$/, '.html')}${search}${hash}`;
+    return withBase(normalizedPath);
+}

package/dist/node/alias.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAliases = exports.SITE_DATA_REQUEST_PATH = exports.SITE_DATA_ID = exports.DEFAULT_THEME_PATH = exports.SHARED_PATH = exports.APP_PATH = exports.DIST_CLIENT_PATH = void 0;
+const path_1 = __importDefault(require("path"));
+const PKG_ROOT = path_1.default.join(__dirname, '../../');
+exports.DIST_CLIENT_PATH = path_1.default.join(__dirname, '../client');
+exports.APP_PATH = path_1.default.join(exports.DIST_CLIENT_PATH, 'app');
+exports.SHARED_PATH = path_1.default.join(exports.DIST_CLIENT_PATH, 'shared');
+exports.DEFAULT_THEME_PATH = path_1.default.join(exports.DIST_CLIENT_PATH, 'theme-default');
+// special virtual file
+// we can't directly import '/@siteData' because
+// - it's not an actual file so we can't use tsconfig paths to redirect it
+// - TS doesn't allow shimming a module that starts with '/'
+exports.SITE_DATA_ID = '@siteData';
+exports.SITE_DATA_REQUEST_PATH = '/' + exports.SITE_DATA_ID;
+const vueRuntimePath = 'vue/dist/vue.runtime.esm-bundler.js';
+function resolveAliases(root, themeDir) {
+    const paths = {
+        '/@theme': themeDir,
+        '@theme': themeDir,
+        [exports.SITE_DATA_ID]: exports.SITE_DATA_REQUEST_PATH
+    };
+    // prioritize vue installed in project root and fallback to
+    // vue that comes with vitepress itself.
+    let vuePath;
+    try {
+        vuePath = require.resolve(vueRuntimePath, { paths: [root] });
+    }
+    catch (e) {
+        vuePath = require.resolve(vueRuntimePath);
+    }
+    const aliases = [
+        ...Object.keys(paths).map((p) => ({
+            find: p,
+            replacement: paths[p]
+        })),
+        {
+            find: /^vitepress$/,
+            replacement: path_1.default.join(__dirname, '../client/index')
+        },
+        {
+            find: /^vitepress\/theme$/,
+            replacement: path_1.default.join(__dirname, '../client/theme-default/index')
+        },
+        // alias for local linked development
+        { find: /^vitepress\//, replacement: PKG_ROOT + '/' },
+        // make sure it always use the same vue dependency that comes with
+        // vitepress itself
+        {
+            find: /^vue$/,
+            replacement: vuePath
+        }
+    ];
+    return aliases;
+}
+exports.resolveAliases = resolveAliases;
+//# sourceMappingURL=alias.js.map

package/dist/node/alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.js","sourceRoot":"","sources":["../../src/node/alias.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AAGvB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AAClC,QAAA,gBAAgB,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;AACpD,QAAA,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,wBAAgB,EAAE,KAAK,CAAC,CAAA;AAC7C,QAAA,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,wBAAgB,EAAE,QAAQ,CAAC,CAAA;AACnD,QAAA,kBAAkB,GAAG,cAAI,CAAC,IAAI,CAAC,wBAAgB,EAAE,eAAe,CAAC,CAAA;AAE9E,uBAAuB;AACvB,gDAAgD;AAChD,0EAA0E;AAC1E,4DAA4D;AAC/C,QAAA,YAAY,GAAG,WAAW,CAAA;AAC1B,QAAA,sBAAsB,GAAG,GAAG,GAAG,oBAAY,CAAA;AAExD,MAAM,cAAc,GAAG,qCAAqC,CAAA;AAE5D,SAAgB,cAAc,CAAC,IAAY,EAAE,QAAgB;IAC3D,MAAM,KAAK,GAA2B;QACpC,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,QAAQ;QAClB,CAAC,oBAAY,CAAC,EAAE,8BAAsB;KACvC,CAAA;IAED,2DAA2D;IAC3D,wCAAwC;IACxC,IAAI,OAAO,CAAA;IACX,IAAI;QACF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;KAC7D;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;KAC1C;IAED,MAAM,OAAO,GAAY;QACvB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,CAAC;YACP,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;SACtB,CAAC,CAAC;QACH;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC;SACrD;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,+BAA+B,CAAC;SACnE;QACD,qCAAqC;QACrC,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,GAAG,GAAG,EAAE;QACrD,kEAAkE;QAClE,mBAAmB;QACnB;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,OAAO;SACrB;KACF,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAxCD,wCAwCC"}