@ruan-cat/utils 4.21.0 → 4.22.0

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@ruan-cat/utils",
-  "version": "4.21.0",
+  "version": "4.22.0",
   "description": "阮喵喵工具集合。默认提供js文件，也直接提供ts文件。",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
+  "bin": {
+    "ruan-cat-utils": "./dist/cli/index.js",
+    "move-vercel-output-to-root": "./dist/cli/move-vercel-output-to-root.js"
+  },
   "homepage": "https://utils.ruancat6312.top",
   "bugs": {
     "url": "https://github.com/ruan-cat/monorepo/issues"
@@ -30,7 +34,6 @@
       "import": "./dist/node-esm/index.js"
     },
     "./monorepo": "./src/monorepo/index.ts",
-    "./move-vercel-output-to-root": "./src/node-esm/scripts/move-vercel-output-to-root/index.ts",
     "./unplugin-vue-router": "./src/unplugin-vue-router/index.ts",
     "./vite-plugin-autogeneration-import-file": "./src/vite-plugin-autogeneration-import-file/index.ts",
     "./vueuse": "./src/vueuse/index.ts",

package/src/cli/index.ts

@@ -0,0 +1,87 @@
+/**
+ * @ruan-cat/utils CLI 入口
+ *
+ * @description
+ * 本文件是 @ruan-cat/utils 包的统一 CLI 入口。
+ * 通过 package.json 的 bin 字段暴露为 `ruan-cat-utils` 命令。
+ *
+ * 用法：
+ *   npx ruan-cat-utils <command> [options]
+ *
+ * 支持的子命令：
+ *   move-vercel-output-to-root  将子包的 .vercel/output 搬运到 monorepo 根目录
+ */
+
+import consola from "consola";
+import {
+	getMoveVercelOutputToRootHelpText,
+	runMoveVercelOutputToRootCli,
+} from "../node-esm/scripts/move-vercel-output-to-root/index";
+
+const CLI_NAME = "ruan-cat-utils";
+
+function printMainHelp() {
+	const helpText = [
+		`${CLI_NAME} - @ruan-cat/utils 命令行工具`,
+		"",
+		"用法：",
+		`  ${CLI_NAME} <command> [options]`,
+		"",
+		"可用命令：",
+		"  move-vercel-output-to-root  将子包的 .vercel/output 搬运到 monorepo 根目录",
+		"",
+		"全局选项：",
+		"  -h, --help                  查看帮助信息",
+		"  -v, --version               查看版本号",
+		"",
+		"示例：",
+		`  ${CLI_NAME} move-vercel-output-to-root`,
+		`  ${CLI_NAME} move-vercel-output-to-root --dry-run`,
+		`  ${CLI_NAME} move-vercel-output-to-root --root-dir ../../..`,
+	].join("\n");
+
+	console.log(helpText);
+}
+
+function printVersion() {
+	// 动态读取版本号会引入额外复杂度，这里直接输出包名提示用户查看
+	console.log(`${CLI_NAME} (from @ruan-cat/utils)`);
+	console.log("运行 'npm list @ruan-cat/utils' 查看当前安装的版本。");
+}
+
+function main() {
+	const args = process.argv.slice(2);
+	const command = args[0];
+
+	if (!command || command === "--help" || command === "-h") {
+		printMainHelp();
+		return;
+	}
+
+	if (command === "--version" || command === "-v") {
+		printVersion();
+		return;
+	}
+
+	switch (command) {
+		case "move-vercel-output-to-root": {
+			const subArgs = args.slice(1);
+			try {
+				runMoveVercelOutputToRootCli(subArgs);
+			} catch (error) {
+				consola.error(error instanceof Error ? error.message : String(error));
+				process.exitCode = 1;
+			}
+			break;
+		}
+
+		default: {
+			consola.error(`未知命令：${command}`);
+			console.log("");
+			printMainHelp();
+			process.exitCode = 1;
+		}
+	}
+}
+
+main();

package/src/cli/move-vercel-output-to-root.ts

@@ -0,0 +1,17 @@
+/**
+ * move-vercel-output-to-root 快捷命令入口
+ *
+ * @description
+ * 本文件是 `move-vercel-output-to-root` bin 命令的直接入口。
+ * 安装 @ruan-cat/utils 后，可以直接通过 `npx move-vercel-output-to-root` 调用。
+ */
+
+import consola from "consola";
+import { runMoveVercelOutputToRootCli } from "../node-esm/scripts/move-vercel-output-to-root/index";
+
+try {
+	runMoveVercelOutputToRootCli();
+} catch (error) {
+	consola.error(error instanceof Error ? error.message : String(error));
+	process.exitCode = 1;
+}

package/src/node-esm/scripts/move-vercel-output-to-root/index.ts

@@ -239,7 +239,7 @@ export function parseMoveVercelOutputToRootCliArgs(args: string[]): MoveVercelOu
  */
 export function getMoveVercelOutputToRootHelpText() {
 	return [
-		"tsx @ruan-cat/utils/move-vercel-output-to-root [options]",
+		"move-vercel-output-to-root [options]",
 		"",
 		"选项：",
 		"  --root-dir <path>    显式指定 monorepo 根目录",