Merge branch 'vuejs:main' into main

CHANGELOG.md

@@ -1,3 +1,23 @@
+## [1.0.1](https://github.com/vuejs/vitepress/compare/v1.0.0...v1.0.1) (2024-03-22)
+
+### Bug Fixes
+
+- **build:** vendor vue-demi to avoid resolution issues with yarn berry ([#3680](https://github.com/vuejs/vitepress/issues/3680)) ([5d3cb96](https://github.com/vuejs/vitepress/commit/5d3cb96ac364413aa9eb494bc91744bd8f4a2c79))
+
+# [1.0.0](https://github.com/vuejs/vitepress/compare/v1.0.0-rc.45...v1.0.0) (2024-03-21)
+
+### Bug Fixes
+
+- **build:** resolve pattern relative to srcDir instead of root in createContentLoader ([#3638](https://github.com/vuejs/vitepress/issues/3638)) ([59183e9](https://github.com/vuejs/vitepress/commit/59183e9cef112a004c8a8e2b365478af657858b0))
+- **localSearch:** remove empty titles that may appear in search results ([#3665](https://github.com/vuejs/vitepress/issues/3665)) ([f7aef3c](https://github.com/vuejs/vitepress/commit/f7aef3ca23dae39e226c85d7bb2579dbf7c758f3))
+- **theme:** fixed sidebar expand caret showing when no children are present ([#3657](https://github.com/vuejs/vitepress/issues/3657)) ([e13f932](https://github.com/vuejs/vitepress/commit/e13f93292ce1a2b1d5ba161fddfe947a1824a2b0))
+- **theme:** ignore inner-page items in next/prev link ([#3663](https://github.com/vuejs/vitepress/issues/3663)) ([b50a8a1](https://github.com/vuejs/vitepress/commit/b50a8a132577693817a15ab43fc4cc22670a8a65))
+- **theme:** local nav separator not visible on pages having no outline ([1909041](https://github.com/vuejs/vitepress/commit/190904171500ad22998c8666080fd58c867a59b5))
+
+### Features
+
+- **theme:** allow selectively disabling external link icon on navbar items ([#3607](https://github.com/vuejs/vitepress/issues/3607)) ([5f6297c](https://github.com/vuejs/vitepress/commit/5f6297cb3df98926154235f31570e75820d4ea16))
+
 # [1.0.0-rc.45](https://github.com/vuejs/vitepress/compare/v1.0.0-rc.44...v1.0.0-rc.45) (2024-03-06)
 
 ### Bug Fixes

docs/guide/what-is-vitepress.md

@@ -34,11 +34,11 @@ VitePress aims to provide a great Developer Experience (DX) when working with Ma
 
 ## Performance
 
-Unlike many traditional SSGs, a website generated by VitePress is in fact a [Single Page Application](https://en.wikipedia.org/wiki/Single-page_application) (SPA).
+Unlike many traditional SSGs where each navigation results in a full page reload, a website generated by VitePress serves static HTML on the initial visit, but becomes a [Single Page Application](https://en.wikipedia.org/wiki/Single-page_application) (SPA) for subsequent navigation within the site. This model, in our opinion, provides an optimal balance for performance:
 
 - **Fast Initial Load**
 
-  The initial visit to any page will be served the static, pre-rendered HTML for blazing fast loading speed and optimal SEO. The page then loads a JavaScript bundle that turns the page into a Vue SPA ("hydration"). The hydration process is extremely fast: on [PageSpeed Insights](https://pagespeed.web.dev/report?url=https%3A%2F%2Fvitepress.dev%2F), typical VitePress sites achieve near-perfect performance scores even on low-end mobile devices with a slow network.
+  The initial visit to any page will be served the static, pre-rendered HTML for fast loading speed and optimal SEO. The page then loads a JavaScript bundle that turns the page into a Vue SPA ("hydration"). Contrary to common assumptions of SPA hydration being slow, this process is actually extremely fast thanks to Vue 3's raw performance and compiler optimizations. On [PageSpeed Insights](https://pagespeed.web.dev/report?url=https%3A%2F%2Fvitepress.dev%2F), typical VitePress sites achieve near-perfect performance scores even on low-end mobile devices with a slow network.
 
 - **Fast Post-load Navigation**
 

docs/reference/site-config.md

@@ -471,6 +471,13 @@ export default {
 }
 ```
 
+### metaChunk <Badge type="warning" text="experimental" />
+
+- Type: `boolean`
+- Default: `false`
+
+When set to `true`, extract pages metadata to a separate JavaScript chunk instead of inlining it in the initial HTML. This makes each page's HTML payload smaller and makes the pages metadata cacheable, thus reducing server bandwidth when you have many pages in the site.
+
 ### mpa <Badge type="warning" text="experimental" />
 
 - Type: `boolean`

lib/vue-demi.mjs

@@ -0,0 +1,34 @@
+/**
+ * vue-demi v0.14.7
+ * Copyright (c) 2020-present, Anthony Fu
+ * @license MIT
+ */
+
+import * as Vue from 'vue'
+
+var isVue2 = false
+var isVue3 = true
+var Vue2 = undefined
+
+function install() {}
+
+export function set(target, key, val) {
+  if (Array.isArray(target)) {
+    target.length = Math.max(target.length, key)
+    target.splice(key, 1, val)
+    return val
+  }
+  target[key] = val
+  return val
+}
+
+export function del(target, key) {
+  if (Array.isArray(target)) {
+    target.splice(key, 1)
+    return
+  }
+  delete target[key]
+}
+
+export * from 'vue'
+export { Vue, Vue2, isVue2, isVue3, install }

package.json

@@ -1,9 +1,9 @@
 {
   "name": "vitepress",
-  "version": "1.0.0-rc.45",
+  "version": "1.0.1",
   "description": "Vite & Vue powered static site generator",
   "type": "module",
-  "packageManager": "pnpm@8.15.4",
+  "packageManager": "pnpm@8.15.5",
   "main": "dist/node/index.js",
   "types": "types/index.d.ts",
   "exports": {
@@ -24,6 +24,9 @@
     "./theme-without-fonts": {
       "types": "./theme-without-fonts.d.ts",
       "default": "./dist/client/theme-default/without-fonts.js"
+    },
+    "./vue-demi": {
+      "default": "./lib/vue-demi.mjs"
     }
   },
   "bin": {
@@ -36,7 +39,8 @@
     "template",
     "client.d.ts",
     "theme.d.ts",
-    "theme-without-fonts.d.ts"
+    "theme-without-fonts.d.ts",
+    "lib"
   ],
   "repository": {
     "type": "git",
@@ -94,8 +98,8 @@
   "dependencies": {
     "@docsearch/css": "^3.6.0",
     "@docsearch/js": "^3.6.0",
-    "@shikijs/core": "^1.1.7",
-    "@shikijs/transformers": "^1.1.7",
+    "@shikijs/core": "^1.2.0",
+    "@shikijs/transformers": "^1.2.0",
     "@types/markdown-it": "^13.0.7",
     "@vitejs/plugin-vue": "^5.0.4",
     "@vue/devtools-api": "^7.0.16",
@@ -104,13 +108,13 @@
     "focus-trap": "^7.5.4",
     "mark.js": "8.11.1",
     "minisearch": "^6.3.0",
-    "shiki": "^1.1.7",
-    "vite": "^5.1.5",
+    "shiki": "^1.2.0",
+    "vite": "^5.2.2",
     "vue": "^3.4.21"
   },
   "peerDependencies": {
-    "markdown-it-mathjax3": "^4.3.2",
-    "postcss": "^8.4.35"
+    "markdown-it-mathjax3": "^4",
+    "postcss": "^8"
   },
   "peerDependenciesMeta": {
     "markdown-it-mathjax3": {
@@ -146,7 +150,7 @@
     "@types/markdown-it-emoji": "^2.0.4",
     "@types/micromatch": "^4.0.6",
     "@types/minimist": "^1.2.5",
-    "@types/node": "^20.11.25",
+    "@types/node": "^20.11.30",
     "@types/postcss-prefix-selector": "^1.16.3",
     "@types/prompts": "^2.4.9",
     "@vue/shared": "^3.4.21",
@@ -154,17 +158,17 @@
     "conventional-changelog-cli": "^4.1.0",
     "cross-spawn": "^7.0.3",
     "debug": "^4.3.4",
-    "esbuild": "^0.20.1",
+    "esbuild": "^0.20.2",
     "escape-html": "^1.0.3",
     "execa": "^8.0.1",
     "fast-glob": "^3.3.2",
     "fs-extra": "^11.2.0",
-    "get-port": "^7.0.0",
+    "get-port": "^7.1.0",
     "gray-matter": "^4.0.3",
     "lint-staged": "^15.2.2",
     "lodash.template": "^4.5.0",
     "lru-cache": "^10.2.0",
-    "markdown-it": "^14.0.0",
+    "markdown-it": "^14.1.0",
     "markdown-it-anchor": "^8.6.7",
     "markdown-it-attrs": "^4.1.6",
     "markdown-it-container": "^4.0.0",
@@ -186,17 +190,17 @@
     "prompts": "^2.4.2",
     "punycode": "^2.3.1",
     "rimraf": "^5.0.5",
-    "rollup": "^4.12.1",
+    "rollup": "^4.13.0",
     "rollup-plugin-dts": "^6.1.0",
     "rollup-plugin-esbuild": "^6.1.1",
     "semver": "^7.6.0",
-    "simple-git-hooks": "^2.10.0",
+    "simple-git-hooks": "^2.11.0",
     "sirv": "^2.0.4",
     "sitemap": "^7.1.1",
     "supports-color": "^9.4.0",
-    "typescript": "^5.4.2",
-    "vitest": "^1.3.1",
-    "vue-tsc": "^2.0.6",
+    "typescript": "^5.4.3",
+    "vitest": "^1.4.0",
+    "vue-tsc": "^2.0.7",
     "wait-on": "^7.2.0"
   },
   "simple-git-hooks": {

src/node/alias.ts

@@ -41,6 +41,10 @@ export function resolveAliases(
     {
       find: /^vitepress\/theme$/,
       replacement: join(DIST_CLIENT_PATH, '/theme-default/index.js')
+    },
+    {
+      find: /^vue-demi$/,
+      replacement: require.resolve('vitepress/vue-demi')
     }
   ]