build: 升级 @142vip/vuepress 至 0.0.1-alpha.25 并对齐包内用法

改用 `createVipViteBuildPlugin`，侧栏类型直接引用包导出，去掉本地重复插件与主题默认项冗余配置。

Author: mmdapl

.vuepress/config/index.ts

@@ -1,6 +1,5 @@
 /** 站点配置统一导出入口 */
 export * from './footer'
-export * from './plugins/vite-build.plugin'
 export * from './seo'
 export * from './sidebar'
 export * from './sidebar.resolve'

.vuepress/config/plugins/vite-build.plugin.ts

@@ -1,30 +1,11 @@
+import type {
+  DocsSidebarConfig,
+  DocsSidebarGroup,
+  DocsSidebarItem,
+} from '@142vip/vuepress'
 import type { AutoLinkOptions, SidebarItemOptions } from 'vuepress-theme-hope'
 import { VipNodeJS } from '@142vip/utils'
 
-/** 侧边栏直链项 */
-export interface DocsSidebarLink {
-  text: string
-  link: string
-}
-
-/** 侧边栏分组项 */
-export interface DocsSidebarGroup {
-  text: string
-  prefix?: string
-  link?: string
-  collapsible?: boolean
-  expanded?: boolean
-  children: DocsSidebarItem[]
-}
-
-export type DocsSidebarItem = DocsSidebarLink | DocsSidebarGroup
-
-export type DocsSidebarConfig = DocsSidebarItem[]
-
-function isSidebarGroup(item: DocsSidebarItem): item is DocsSidebarGroup {
-  return Array.isArray((item as DocsSidebarGroup).children)
-}
-
 function readPermalink(mdFilePath: string): string | null {
   if (!VipNodeJS.existPath(mdFilePath)) {
     return null
@@ -59,6 +40,8 @@ function resolveMdLink(
  * 本仓库大量页面 permalink 与文件名不一致（如 `html.md` → `/front-end/base-begin/html-correlation.html`），
  * 故在配置阶段按文件解析并替换 `link`；无法单靠 `vuepress.config.ts` 原生选项完成。
  *
+ * 侧栏结构类型见 `@142vip/vuepress` 的 `DocsSidebar*`；本函数为站点侧解析工具。
+ *
  * @param sidebar 模块侧边栏原始配置（可含 `.md` 链接）
  * @param docsBasePath `docs/` 下的相对目录，如 `server-end/framework/egg`
  */
@@ -68,14 +51,15 @@ export function resolveSidebarPermalinks(
 ): SidebarItemOptions[] {
   const walk = (items: DocsSidebarItem[], groupPrefix = ''): SidebarItemOptions[] =>
     items.map((item) => {
-      if (isSidebarGroup(item)) {
+      if (Array.isArray((item as DocsSidebarGroup).children)) {
+        const group = item as DocsSidebarGroup
         return {
-          ...item,
-          children: walk(item.children, item.prefix ?? ''),
+          ...group,
+          children: walk(group.children, group.prefix ?? ''),
         }
       }
 
-      if (!item.link.endsWith('.md')) {
+      if (!item.link?.endsWith('.md')) {
         return item as AutoLinkOptions
       }
 

.vuepress/config/sidebar.resolve.ts

@@ -21,9 +21,9 @@
     "clean:hooks": "npx fa clean --git-hooks --all --ignore-tips",
     "lint": "npx fa lint",
     "lint:fix": "npx fa lint --fix",
-    "dev": "npx vuepress dev",
-    "build": "npx vuepress build --clean-temp --clean-cache",
-    "build:proxy": "NEED_PROXY=true npx vuepress build --clean-temp --clean-cache",
+    "dev": "vuepress dev",
+    "build": "vuepress build --clean-temp --clean-cache",
+    "build:proxy": "NEED_PROXY=true vuepress build --clean-temp --clean-cache",
     "release": "npx fa release --vip --check-branch next --check-branch main",
     "check:commit": "npx node --loader ts-node/esm --no-warnings scripts/core/verify-commit.ts"
   },
@@ -33,7 +33,7 @@
     "@142vip/fairy-cli": "0.0.3-alpha.33",
     "@142vip/open-source": "0.0.1-alpha.4",
     "@142vip/utils": "0.0.1-alpha.58",
-    "@142vip/vuepress": "0.0.1-alpha.24",
+    "@142vip/vuepress": "0.0.1-alpha.25",
     "only-allow": "1.2.1",
     "simple-git-hooks": "2.13.0",
     "ts-node": "10.9.2"