docs: display package name in sidebar

Author: so1ve

docs/.vitepress/config/en.ts

@@ -59,16 +59,16 @@ const guideSidebar = [
 	},
 	{
 		text: "API Reference",
-		items: PACKAGES.map((pkg) => ({
-			text: pkg,
+		items: Object.entries(PACKAGES).map(([pkg, name]) => ({
+			text: name,
 			link: `/reference/api/${pkg}/`,
 		})),
 	},
 ];
 
 const sidebar = {
 	...Object.fromEntries(
-		PACKAGES.map((pkg) => [
+		Object.keys(PACKAGES).map((pkg) => [
 			`/reference/api/${pkg}/`,
 			[
 				{

docs/.vitepress/config/zh.ts

@@ -59,16 +59,16 @@ const guideSidebar = [
 	},
 	{
 		text: "API 参考",
-		items: PACKAGES.map((pkg) => ({
-			text: pkg,
+		items: Object.entries(PACKAGES).map(([pkg, name]) => ({
+			text: name,
 			link: `/zh/reference/api/${pkg}/`,
 		})),
 	},
 ];
 
 const sidebar = {
 	...Object.fromEntries(
-		PACKAGES.map((pkg) => [
+		Object.keys(PACKAGES).map((pkg) => [
 			`/zh/reference/api/${pkg}/`,
 			[
 				{

docs/.vitepress/scripts/generate-reference.ts

@@ -1,15 +1,27 @@
-import { existsSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { cp, rename, rm } from "node:fs/promises";
 
 import type { TypeDocOptions } from "typedoc";
 import { Application } from "typedoc";
 
 const LANGUAGES = ["zh"];
 const IGNORED_PACKAGES = ["test-utils"];
-export const PACKAGES = readdirSync("../packages", { withFileTypes: true })
-	.filter((dirent) => dirent.isDirectory())
-	.map((dirent) => dirent.name)
-	.filter((name) => !IGNORED_PACKAGES.includes(name));
+export const PACKAGES = Object.fromEntries(
+	readdirSync("../packages", { withFileTypes: true })
+		.filter((dirent) => dirent.isDirectory())
+		.map((dirent) => dirent.name)
+		.filter((name) => !IGNORED_PACKAGES.includes(name))
+		.map((name) => {
+			const pkgPath = `../packages/${name}/package.json`;
+			if (!existsSync(pkgPath)) {
+				throw new Error(`Package.json not found for package: ${name}`);
+			}
+			const pkgJson = JSON.parse(readFileSync(pkgPath, "utf-8"));
+
+			return [name, pkgJson.name as string] as const;
+		})
+		.sort(([a], [b]) => a.localeCompare(b)),
+);
 const tsconfig = "../tsconfig.json";
 
 if (import.meta.main) {
@@ -19,14 +31,14 @@ if (import.meta.main) {
 	await rm("reference/api", { recursive: true, force: true });
 
 	// Generate API documentation
-	for (const pkg of PACKAGES) {
-		console.log(`📚 Generating reference for ${pkg}...`);
+	for (const [pkg, name] of Object.entries(PACKAGES)) {
+		console.log(`📚 Generating reference for ${name}...`);
 		await runTypedoc(tsconfig, pkg);
 	}
 	console.log("✅ Reference generated successfully!");
 	console.log("📚 Beautifying reference structure...");
 
-	for (const pkg of PACKAGES) {
+	for (const pkg of Object.keys(PACKAGES)) {
 		if (existsSync(`reference/api/${pkg}/globals.md`)) {
 			await rm(`reference/api/${pkg}/index.md`, { force: true });
 			await rename(