docs: update to latest clerc api

Author: so1ve

.vscode/settings.json

@@ -1,3 +1,6 @@
 {
-	"typescript.tsdk": "node_modules\\typescript\\lib"
+	"typescript.tsdk": "node_modules\\typescript\\lib",
+	"files.associations": {
+		"*.md": "markdown"
+	}
 }

docs/.vitepress/config/en.ts

@@ -1,5 +1,14 @@
+import { join } from "node:path";
+
 import { defineConfig } from "vitepress";
 
+import { getPluginNavigation } from "./plugin-navigation";
+
+const pluginNavigation = await getPluginNavigation(
+	join(import.meta.dirname, "..", "..", "official-plugins"),
+	"/official-plugins",
+);
+
 export const enConfig = defineConfig({
 	lang: "en-US",
 	description: "The The full-featured Command-Line Interface library",
@@ -11,12 +20,12 @@ export const enConfig = defineConfig({
 				link: "/getting-started",
 			},
 			{
-				text: "Members",
-				link: "/members",
+				text: "Official Plugins",
+				items: pluginNavigation,
 			},
 			{
-				text: "Sponsor (CN)",
-				link: "https://afdian.net/a/so1ve",
+				text: "Members",
+				link: "/members",
 			},
 		],
 		sidebar: [
@@ -35,6 +44,10 @@ export const enConfig = defineConfig({
 						text: "Interceptors",
 						link: "/interceptors",
 					},
+					{
+						text: "Context",
+						link: "/context",
+					},
 					{
 						text: "Plugins",
 						link: "/plugins",
@@ -43,7 +56,7 @@ export const enConfig = defineConfig({
 			},
 			{
 				text: "Official Plugins",
-				link: "/official-plugins",
+				items: pluginNavigation,
 			},
 		],
 		editLink: {

docs/.vitepress/config/plugin-navigation.ts

@@ -0,0 +1,75 @@
+import fs from "node:fs/promises";
+import { join } from "node:path";
+
+function extractTitleFromMarkdown(content: string): string | null {
+	// eslint-disable-next-line regexp/no-super-linear-backtracking
+	const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n/;
+	const match = content.match(frontmatterRegex);
+
+	if (!match) {
+		return null;
+	}
+
+	const frontmatter = match[1];
+	// eslint-disable-next-line regexp/no-super-linear-backtracking
+	const titleRegex = /^title:\s*(.+?)\s*$/m;
+	const titleMatch = frontmatter.match(titleRegex);
+
+	return titleMatch ? titleMatch[1].trim() : null;
+}
+
+export async function getPluginTitles(
+	path: string,
+): Promise<{ filename: string; title: string }[]> {
+	try {
+		const files = await fs.readdir(path);
+		const results: { filename: string; title: string }[] = [];
+
+		for (const file of files) {
+			if (file.endsWith(".md")) {
+				const filePath = join(path, file);
+
+				try {
+					const content = await fs.readFile(filePath, "utf-8");
+					const title = extractTitleFromMarkdown(content);
+
+					if (title) {
+						results.push({
+							filename: file,
+							title,
+						});
+					}
+				} catch (error) {
+					console.warn(`读取文件 ${file} 时出错:`, error);
+				}
+			}
+		}
+
+		results.sort((a, b) => a.filename.localeCompare(b.filename));
+
+		return results;
+	} catch (error) {
+		console.error(`扫描目录 ${path} 时出错:`, error);
+
+		return [];
+	}
+}
+
+export async function getPluginNavigation(
+	path: string,
+	webRoot: string,
+): Promise<{ text: string; link: string }[]> {
+	const pluginTitles = await getPluginTitles(path);
+
+	return pluginTitles.map(({ filename, title }) => {
+		const link =
+			filename === "index.md"
+				? webRoot
+				: join(webRoot, filename.replace(/\.md$/, "")).replace(/\\/g, "/");
+
+		return {
+			text: title,
+			link,
+		};
+	});
+}

docs/.vitepress/config/zh.ts

@@ -1,5 +1,14 @@
+import { join } from "node:path";
+
 import { defineConfig } from "vitepress";
 
+import { getPluginNavigation } from "./plugin-navigation";
+
+const pluginNavigation = await getPluginNavigation(
+	join(import.meta.dirname, "..", "..", "zh", "official-plugins"),
+	"/zh/official-plugins",
+);
+
 export const zhConfig = defineConfig({
 	lang: "zh-CN",
 	description: "全功能 CLI 库",
@@ -11,12 +20,12 @@ export const zhConfig = defineConfig({
 				link: "/zh/getting-started",
 			},
 			{
-				text: "成员",
-				link: "/zh/members",
+				text: "官方插件列表",
+				items: pluginNavigation,
 			},
 			{
-				text: "捐赠作者",
-				link: "https://afdian.net/a/so1ve",
+				text: "成员",
+				link: "/zh/members",
 			},
 		],
 		sidebar: [
@@ -35,15 +44,19 @@ export const zhConfig = defineConfig({
 						text: "拦截器",
 						link: "/zh/interceptors",
 					},
+					{
+						text: "上下文",
+						link: "/zh/context",
+					},
 					{
 						text: "插件",
 						link: "/zh/plugins",
 					},
 				],
 			},
 			{
-				text: "Official Plugins",
-				link: "/zh/official-plugins",
+				text: "官方插件列表",
+				items: pluginNavigation,
 			},
 		],
 		editLink: {

docs/.vitepress/theme/style.css

@@ -88,3 +88,7 @@
 .DocSearch {
 	--docsearch-primary-color: var(--vp-c-brand) !important;
 }
+
+span {
+	tab-size: 2;
+}