create-pressplus 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Josef-qiao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# VitePress Custom Theme Template
+
+一个基于 **VitePress** 的现代化文档模板，默认启用 **自定义主题**，并集成常用的前端工程化工具，适合用于：
+
+- 技术文档
+- 博客 / 笔记站点
+- 组件说明站
+- 长期维护的知识库
+
+该模板以 **可维护性、可扩展性** 为核心设计目标。
+
+---
+
+## ✨ 特性一览
+
+- ⚡️ 基于 **VitePress**
+- 🎨 **完全自定义主题**（不依赖 DefaultTheme 布局）
+- 🌬 **Tailwind CSS v4**（Vite 插件模式）
+- 🧹 **ESLint**（代码规范）
+- ✨ **Prettier**（统一格式化）
+- 🧩 支持在 **Markdown / Theme / Vue 组件** 中无感使用
+- 📦 适合二次开发与长期演进
+
+---
+
+## 📦 技术栈
+
+| 技术            | 说明         |
+| --------------- | ------------ |
+| VitePress       | 文档生成框架 |
+| Vue 3           | 组件系统     |
+| Tailwind CSS v4 | 原子化 CSS   |
+| ESLint          | 代码规范     |
+| Prettier        | 格式化工具   |
+
+---
+
+## 📂 项目结构
+
+```txt
+docs/
+├─ .vitepress/
+│  ├─ config.ts              # VitePress 配置
+│  └─ theme/
+│     ├─ index.ts            # 自定义主题入口
+│     ├─ Layout.vue          # 全局布局
+│     ├─ tailwind.css        # Tailwind CSS v4 入口
+│     └─ components/         # 主题级组件
+│
+├─ index.md                  # 首页
+└─ README.md
+```
+
+## 🚀 使用方式
+
+```txt
+npx create-pressplus
+```

package/index.mjs

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+import fsExtra from "fs-extra";
+import { join, resolve } from "path";
+import { fileURLToPath } from "url";
+import { spawn } from "child_process";
+import ora from "ora";
+import chalk from "chalk";
+import enquirerPkg from "enquirer";
+import gradient from "gradient-string";
+
+const { prompt } = enquirerPkg
+const { copy, readJSON, writeJSON, remove } = fsExtra;
+
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+
+// 打印欢迎信息
+function printWelcome() {
+	console.log();
+	console.log(gradient.morning("✨ 欢迎使用 PressPlus 脚手架 ✨"));
+	console.log();
+}
+
+// 验证项目名称
+function isValidPackageName(projectName) {
+	return /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(
+		projectName
+	);
+}
+
+// 格式化项目名称
+function toValidPackageName(projectName) {
+	return projectName
+		.trim()
+		.toLowerCase()
+		.replace(/\s+/g, "-")
+		.replace(/^[._]/, "")
+		.replace(/[^a-z0-9-~]+/g, "-");
+}
+
+// 将包名转换为目录名
+function packageNameToDirName(packageName) {
+	if (packageName.includes("/")) {
+		return packageName.split("/")[1];
+	}
+	return packageName;
+}
+
+// 交互式提问
+async function askForOptions(targetDir) {
+	const options = await prompt([
+		{
+			type: "input",
+			name: "packageName",
+			message: "请输入项目名称",
+			initial: toValidPackageName(targetDir),
+			validate: (name) =>
+				isValidPackageName(name) || "项目名称不符合 npm 包命名规则",
+		},
+		{
+			type: "confirm",
+			name: "installDeps",
+			message: "是否立即安装依赖?",
+			initial: true,
+		},
+	]);
+
+	return options;
+}
+
+// 拷贝模板
+async function copyTemplate(src, dest) {
+	const spinner = ora(`正在创建项目...`).start();
+	try {
+		await copy(src, dest);
+		spinner.succeed("项目创建成功");
+	} catch (err) {
+		spinner.fail("项目创建失败");
+		throw err;
+	}
+}
+
+
+// 更新 package.json
+async function updatePackageJson(destDir, projectName) {
+	const packageJsonPath = join(destDir, "package.json");
+	const packageJson = await readJSON(packageJsonPath);
+	packageJson.name = projectName;
+	await writeJSON(packageJsonPath, packageJson, { spaces: 2 });
+}
+
+// 安装依赖
+async function installDependencies(destDir) {
+	const spinner = ora("正在安装依赖...").start();
+
+	try {
+		await new Promise((resolve, reject) => {
+			const installer = spawn("npm", ["install"], {
+				cwd: destDir,
+				stdio: "ignore",
+				shell: true,
+			});
+
+			installer.on("close", (code) => {
+				if (code === 0) resolve();
+				else reject(new Error(`npm install 失败，退出码 ${code}`));
+			});
+		});
+		spinner.succeed("依赖安装完成");
+	} catch (err) {
+		spinner.fail(`依赖安装失败: ${err.message}`);
+		throw err;
+	}
+}
+
+// 打印完成信息
+function printCompletion(targetDir, installDeps) {
+	console.log();
+	console.log(chalk.bold("🎉  项目创建完成!"));
+	console.log();
+
+	console.log(chalk.bold("接下来可以执行以下命令:"));
+	console.log();
+	console.log(chalk.dim(` # 进入项目目录`));
+	console.log(` cd ${chalk.cyan(targetDir)}`);
+
+	if (!installDeps) {
+		console.log(chalk.dim(` # 安装依赖`));
+		console.log(` npm install`);
+	}
+
+	console.log(chalk.dim(` # 启动开发服务器`));
+	console.log(` npm run dev`);
+	console.log();
+	console.log(chalk.dim(` # 构建生产版本`));
+	console.log(` npm run build`);
+	console.log();
+}
+
+// 主函数
+async function main() {
+	printWelcome();
+
+	// 获取初始目标目录
+	const initialTargetDir = process.argv[2];
+
+	if (!initialTargetDir) {
+		console.error(
+			chalk.red("❌ 必须指定项目名称，例如:") +
+			chalk.cyan("npx create-pressplus my-project")
+		);
+		process.exit(1);
+	}
+
+	let destDir = null;
+	let finalDirName = null;
+
+	try {
+		// 先获取用户选项
+		const options = await askForOptions(initialTargetDir);
+
+		// 基于用户输入的项目名称确定最终目录名
+		finalDirName = packageNameToDirName(options.packageName);
+		destDir = resolve(process.cwd(), finalDirName);
+
+		// 检查目录是否已存在
+		if (fsExtra.existsSync(destDir)) {
+			console.error(chalk.red(`❌ 目录 "${finalDirName}" 已存在!`));
+			process.exit(1);
+		}
+
+		// 拷贝模板
+		await copyTemplate(join(__dirname, "template"), destDir);
+
+		// 更新 package.json
+		await updatePackageJson(destDir, options.packageName);
+
+		// 安装依赖
+		if (options.installDeps) {
+			await installDependencies(destDir);
+		}
+
+		// 打印完成信息
+		printCompletion(finalDirName, options.installDeps);
+	} catch (err) {
+		console.error(chalk.red("❌ 创建项目失败:"), err.message);
+
+		// 清理已创建的文件
+		if (destDir && fsExtra.existsSync(destDir)) {
+			const spinner = ora("清理已创建的文件...").start();
+			await remove(destDir);
+			spinner.succeed("清理完成");
+		}
+
+		process.exit(1);
+	}
+}
+
+main().catch((err) => {
+	console.error(chalk.red("❌ 发生未预期的错误:"), err);
+	process.exit(1);
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "create-pressplus",
+	"version": "1.0.0",
+	"description": "一个基于 VitePress 的现代化文档模板",
+	"main": "index.js",
+	"bin": {
+		"create-vueplus": "./index.mjs"
+	},
+	"files": [
+		"index.mjs",
+		"template"
+	],
+	"scripts": {
+		"test": "echo \"Error: no test specified\" && exit 1"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/359Steve/create-vitepress.git"
+	},
+	"keywords": [
+		"vue",
+		"vite",
+		"press",
+		"markdown",
+		"pressplus"
+	],
+	"author": "josefqiao",
+	"license": "MIT",
+	"dependencies": {
+		"chalk": "^5.5.0",
+		"enquirer": "^2.4.1",
+		"fs-extra": "^11.3.0",
+		"gradient-string": "^3.0.0",
+		"ora": "^8.2.0"
+	}
+}

package/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Josef-qiao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/template/README.md

@@ -0,0 +1,58 @@
+# VitePress Custom Theme Template
+
+一个基于 **VitePress** 的现代化文档模板，默认启用 **自定义主题**，并集成常用的前端工程化工具，适合用于：
+
+- 技术文档
+- 博客 / 笔记站点
+- 组件说明站
+- 长期维护的知识库
+
+该模板以 **可维护性、可扩展性** 为核心设计目标。
+
+---
+
+## ✨ 特性一览
+
+- ⚡️ 基于 **VitePress**
+- 🎨 **完全自定义主题**（不依赖 DefaultTheme 布局）
+- 🌬 **Tailwind CSS v4**（Vite 插件模式）
+- 🧹 **ESLint**（代码规范）
+- ✨ **Prettier**（统一格式化）
+- 🧩 支持在 **Markdown / Theme / Vue 组件** 中无感使用
+- 📦 适合二次开发与长期演进
+
+---
+
+## 📦 技术栈
+
+| 技术            | 说明         |
+| --------------- | ------------ |
+| VitePress       | 文档生成框架 |
+| Vue 3           | 组件系统     |
+| Tailwind CSS v4 | 原子化 CSS   |
+| ESLint          | 代码规范     |
+| Prettier        | 格式化工具   |
+
+---
+
+## 📂 项目结构
+
+```txt
+docs/
+├─ .vitepress/
+│  ├─ config.ts              # VitePress 配置
+│  └─ theme/
+│     ├─ index.ts            # 自定义主题入口
+│     ├─ Layout.vue          # 全局布局
+│     ├─ tailwind.css        # Tailwind CSS v4 入口
+│     └─ components/         # 主题级组件
+│
+├─ index.md                  # 首页
+└─ README.md
+```
+
+## 🚀 使用方式
+
+```txt
+npx create-pressplus
+```

package/template/docs/.vitepress/cache/deps/_metadata.json

@@ -0,0 +1,31 @@
+{
+  "hash": "ada4f81b",
+  "configHash": "bde764a9",
+  "lockfileHash": "baacf20b",
+  "browserHash": "1a9d3965",
+  "optimized": {
+    "vue": {
+      "src": "../../../../node_modules/vue/dist/vue.runtime.esm-bundler.js",
+      "file": "vue.js",
+      "fileHash": "4a3f86cb",
+      "needsInterop": false
+    },
+    "vitepress > @vue/devtools-api": {
+      "src": "../../../../node_modules/@vue/devtools-api/dist/index.js",
+      "file": "vitepress___@vue_devtools-api.js",
+      "fileHash": "a9540d98",
+      "needsInterop": false
+    },
+    "vitepress > @vueuse/core": {
+      "src": "../../../../node_modules/@vueuse/core/index.mjs",
+      "file": "vitepress___@vueuse_core.js",
+      "fileHash": "4fccfa93",
+      "needsInterop": false
+    }
+  },
+  "chunks": {
+    "chunk-XKDLJUKD": {
+      "file": "chunk-XKDLJUKD.js"
+    }
+  }
+}