@vuepress/client 2.0.0-rc.28 → 2.0.0-rc.29

package/dist/app.js

@@ -1,4 +1,4 @@
-import { D as usePageHead, O as usePageLang, R as clientDataSymbol, a as ClientOnly, d as resolveRoute, h as updateHeadSymbol, i as Content, k as usePageLayout, m as routes, p as redirects, r as resolvers, s as RouteLink, t as withBase } from "./utils-_b2e7bpk.js";
+import { D as usePageHead, O as usePageLang, R as clientDataSymbol, a as ClientOnly, d as resolveRoute, h as updateHeadSymbol, i as Content, k as usePageLayout, m as routes, p as redirects, r as resolvers, s as RouteLink, t as withBase } from "./utils-CIxUK0LM.js";
 import { clientConfigs } from "@internal/clientConfigs";
 import { computed, createApp, createSSRApp, customRef, h, onMounted, provide, shallowRef, useSSRContext, watch } from "vue";
 import { siteData } from "@internal/siteData";

package/dist/index.js

@@ -1,3 +1,3 @@
-import { A as useRedirects, C as usePage, D as usePageHead, E as usePageFrontmatter, F as useSiteData, I as useSiteLocale, L as useSiteLocaleData, M as useRoutePath, N as useRoutes, O as usePageLang, P as useSite, R as clientDataSymbol, S as useLayouts, T as usePageData, _ as onContentUpdated, a as ClientOnly, b as useHead, c as useRoute, d as resolveRoute, f as resolveRoutePath, g as useUpdateHead, h as updateHeadSymbol, i as Content, j as useRouteLocale, k as usePageLayout, l as useRouter, n as defineClientConfig, o as AutoLink, r as resolvers, s as RouteLink, t as withBase, u as resolveRouteFullPath, v as useData, w as usePageComponent, x as useLang, y as useFrontmatter, z as useClientData } from "./utils-_b2e7bpk.js";
+import { A as useRedirects, C as usePage, D as usePageHead, E as usePageFrontmatter, F as useSiteData, I as useSiteLocale, L as useSiteLocaleData, M as useRoutePath, N as useRoutes, O as usePageLang, P as useSite, R as clientDataSymbol, S as useLayouts, T as usePageData, _ as onContentUpdated, a as ClientOnly, b as useHead, c as useRoute, d as resolveRoute, f as resolveRoutePath, g as useUpdateHead, h as updateHeadSymbol, i as Content, j as useRouteLocale, k as usePageLayout, l as useRouter, n as defineClientConfig, o as AutoLink, r as resolvers, s as RouteLink, t as withBase, u as resolveRouteFullPath, v as useData, w as usePageComponent, x as useLang, y as useFrontmatter, z as useClientData } from "./utils-CIxUK0LM.js";
 import { c as constants_exports } from "./constants-COBTj3zj.js";
 export { AutoLink, ClientOnly, Content, constants_exports as DEVTOOLS, RouteLink, clientDataSymbol, defineClientConfig, onContentUpdated, resolveRoute, resolveRouteFullPath, resolveRoutePath, resolvers, updateHeadSymbol, useClientData, useData, useFrontmatter, useHead, useLang, useLayouts, usePage, usePageComponent, usePageData, usePageFrontmatter, usePageHead, usePageLang, usePageLayout, useRedirects, useRoute, useRouteLocale, useRoutePath, useRouter, useRoutes, useSite, useSiteData, useSiteLocale, useSiteLocaleData, useUpdateHead, withBase };

package/dist/{utils-_b2e7bpk.js → utils-CIxUK0LM.js}

@@ -155,11 +155,22 @@ const guardEvent = (event) => {
 const RouteLink = defineComponent({
 	name: "RouteLink",
 	props: {
+		/**
+		* The route path to link to
+		*/
 		to: {
 			type: String,
 			required: true
 		},
+		/**
+		* Whether the link is active to have an active class
+		*
+		* Notice that the active status is not automatically determined according to the current route.
+		*/
 		active: Boolean,
+		/**
+		* The class to add when the link is active
+		*/
 		activeClass: {
 			type: String,
 			default: "route-link-active"
@@ -312,10 +323,18 @@ const LAYOUT_NAME_DEFAULT = "Layout";
 * @experimental - This is an experimental API and may be changed in minor versions
 */
 const resolvers = reactive({
+	/**
+	* Resolve layouts component map
+	*/
 	resolveLayouts: (clientConfigs) => clientConfigs.reduce((prev, item) => ({
 		...prev,
 		...item.layouts
 	}), {}),
+	/**
+	* Merge the head config in frontmatter and site locale
+	*
+	* Frontmatter should take priority over site locale
+	*/
 	resolvePageHead: (pageHeadTitle, pageFrontmatter, siteLocaleDate) => {
 		const description = isString(pageFrontmatter.description) ? pageFrontmatter.description : siteLocaleDate.description;
 		return dedupeHead([
@@ -332,14 +351,35 @@ const resolvers = reactive({
 			}]
 		]);
 	},
+	/**
+	* Resolve the content of page head title
+	*
+	* It would be used as the content of the `<title>` tag
+	*/
 	resolvePageHeadTitle: (pageData, siteLocaleDate) => [pageData.title, siteLocaleDate.title].filter((item) => !!item).join(" | "),
+	/**
+	* Resolve page language from page data
+	*
+	* It would be used as the `lang` attribute of `<html>` tag
+	*/
 	resolvePageLang: (pageData, siteLocaleData) => pageData.lang || siteLocaleData.lang || "en-US",
+	/**
+	* Resolve layout component of current page
+	*/
 	resolvePageLayout: (pageData, layouts) => {
 		const layoutName = isString(pageData.frontmatter.layout) ? pageData.frontmatter.layout : LAYOUT_NAME_DEFAULT;
 		if (!layouts[layoutName]) throw new Error(`[vuepress] Cannot resolve layout: ${layoutName}`);
 		return layouts[layoutName];
 	},
+	/**
+	* Resolve locale path according to route path and locales config
+	*/
 	resolveRouteLocale: (locales, routePath) => resolveLocalePath(locales, decodeURI(routePath)),
+	/**
+	* Resolve site data for specific locale
+	*
+	* It would merge the locales fields to the root fields
+	*/
 	resolveSiteLocaleData: ({ base, locales, ...siteData }, routeLocale) => ({
 		...siteData,
 		...locales[routeLocale],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vuepress/client",
-  "version": "2.0.0-rc.28",
+  "version": "2.0.0-rc.29",
   "description": "Client package of VuePress",
   "keywords": [
     "client",
@@ -38,9 +38,9 @@
   "dependencies": {
     "@vue/devtools-api": "^8.1.1",
     "@vue/devtools-kit": "^8.1.1",
-    "vue": "^3.5.31",
-    "vue-router": "^5.0.4",
-    "@vuepress/shared": "2.0.0-rc.28"
+    "vue": "^3.5.34",
+    "vue-router": "^5.0.6",
+    "@vuepress/shared": "2.0.0-rc.29"
   },
   "tsdown": {
     "deps": {