@ruan-cat/utils 4.11.0 → 4.12.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruan-cat/utils",
-  "version": "4.11.0",
+  "version": "4.12.1",
   "description": "阮喵喵工具集合。默认提供js文件，也直接提供ts文件。",
   "type": "module",
   "main": "./src/index.ts",
@@ -62,24 +62,24 @@
   ],
   "dependencies": {
     "@vueuse/integrations": "^13.9.0",
-    "axios": "^1.12.0",
+    "axios": "^1.12.2",
     "consola": "^3.4.2",
     "lodash-es": "^4.17.21"
   },
   "devDependencies": {
-    "@antfu/utils": "^9.2.0",
+    "@antfu/utils": "^9.2.1",
     "@types/lodash-es": "^4.17.12",
-    "@types/node": "^22.18.1",
+    "@types/node": "^22.18.6",
     "@types/qs": "^6.14.0",
-    "automd": "^0.4.0",
+    "automd": "^0.4.2",
     "commander": "^13.1.0",
     "js-yaml": "^4.1.0",
     "qs": "^6.14.0",
     "tsup": "^8.5.0",
     "type-plus": "^7.6.2",
-    "typedoc": "^0.28.12",
+    "typedoc": "^0.28.13",
     "typedoc-plugin-frontmatter": "^1.3.0",
-    "typedoc-plugin-markdown": "^4.8.1",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.2",
     "unplugin-auto-import": "^20.1.0",
     "unplugin-vue-router": "^0.15.0",

package/src/node-esm/index.ts

@@ -2,6 +2,7 @@ export * from "./ruan-cat-pkg-info";
 
 export * from "./scripts/clean";
 export * from "./scripts/copy-changelog";
+export * from "./scripts/copy-claude-agents";
 export * from "./scripts/copy-readme";
 export * from "./scripts/yaml-to-md";
 export * from "./scripts/add-changelog-to-doc";

package/src/node-esm/scripts/copy-claude-agents.ts

@@ -0,0 +1,154 @@
+import fs from "node:fs";
+import path from "node:path";
+import consola from "consola";
+
+/**
+ * 从当前工作目录向上查找 monorepo 根目录
+ * @returns monorepo 根目录的绝对路径，如果找不到则返回 null
+ * @description
+ * 通过查找 pnpm-workspace.yaml 文件来定位 monorepo 根目录。
+ * 从 process.cwd() 开始向上遍历，直到找到该文件或到达文件系统根目录。
+ */
+function findMonorepoRoot(): string | null {
+	let currentDir = process.cwd();
+	const root = path.parse(currentDir).root;
+
+	while (currentDir !== root) {
+		const workspaceFile = path.join(currentDir, "pnpm-workspace.yaml");
+		if (fs.existsSync(workspaceFile)) {
+			return currentDir;
+		}
+		currentDir = path.dirname(currentDir);
+	}
+
+	// 检查根目录本身
+	const workspaceFile = path.join(root, "pnpm-workspace.yaml");
+	if (fs.existsSync(workspaceFile)) {
+		return root;
+	}
+
+	return null;
+}
+
+/**
+ * 解析根目录路径
+ * @param rootDir - 根目录路径，支持相对路径（如 `../../../`）或绝对路径
+ * @returns 解析后的绝对路径
+ * @description
+ * 路径解析优先级：
+ * 1. 如果传入 rootDir，将相对路径基于 process.cwd() 解析为绝对路径
+ * 2. 如果未传入 rootDir，自动向上查找包含 pnpm-workspace.yaml 的 monorepo 根目录
+ * 3. 如果自动查找失败，回退到 process.cwd()
+ */
+function resolveRootDir(rootDir?: string): string {
+	if (rootDir) {
+		// 将相对路径或绝对路径解析为绝对路径
+		return path.resolve(process.cwd(), rootDir);
+	}
+
+	// 自动查找 monorepo 根目录
+	const monorepoRoot = findMonorepoRoot();
+	if (monorepoRoot) {
+		return monorepoRoot;
+	}
+
+	// 回退到当前工作目录
+	return process.cwd();
+}
+
+/**
+ * 检查指定根目录是否存在 .claude/agents 文件夹
+ * @param options - 配置选项
+ * @param options.rootDir - 可选的根目录路径，支持相对路径（如 `../../../` 表示向上三级目录）。
+ *                          如果不传入，将自动向上查找包含 pnpm-workspace.yaml 的 monorepo 根目录。
+ *                          相对路径会基于当前工作目录 (process.cwd()) 解析为绝对路径。
+ * @returns 是否存在 .claude/agents 文件夹
+ * @example
+ * // 自动检测 monorepo 根目录
+ * hasClaudeAgents()
+ *
+ * // 手动指定相对路径（从当前工作目录向上三级）
+ * hasClaudeAgents({ rootDir: '../../../' })
+ *
+ * // 手动指定绝对路径
+ * hasClaudeAgents({ rootDir: '/path/to/monorepo' })
+ */
+export function hasClaudeAgents(options?: { rootDir?: string }): boolean {
+	const root = resolveRootDir(options?.rootDir);
+	const claudeAgentsPath = path.join(root, ".claude/agents");
+	const exists = fs.existsSync(claudeAgentsPath);
+
+	if (!exists) {
+		consola.log("检测的根目录为：", root);
+		consola.warn("该根目录不存在 .claude/agents 文件夹");
+	}
+
+	return exists;
+}
+
+/**
+ * 将 .claude/agents 文件夹复制到指定位置的配置选项
+ */
+export interface CopyClaudeAgentsOptions {
+	/**
+	 * 目标文件夹路径（相对于当前工作目录）
+	 * @example 'dist', 'build/output', './public'
+	 */
+	target: string;
+
+	/**
+	 * 可选的根目录路径，支持相对路径（如 `../../../` 表示向上三级目录）
+	 * @description
+	 * - 如果不传入，将自动向上查找包含 pnpm-workspace.yaml 的 monorepo 根目录
+	 * - 相对路径会基于当前工作目录 (process.cwd()) 解析为绝对路径
+	 * - 绝对路径将直接使用
+	 * @example
+	 * // 相对路径：向上三级目录
+	 * '../../../'
+	 *
+	 * // 绝对路径
+	 * '/absolute/path/to/monorepo'
+	 */
+	rootDir?: string;
+}
+
+/**
+ * 将 .claude/agents 文件夹复制到指定位置
+ * @param options - 配置选项
+ * @description
+ * 该函数相当于实现 `cpx .claude/agents <target>` 命令。
+ * 从根目录的 .claude/agents 复制到目标位置。
+ * @example
+ * // 自动检测 monorepo 根目录，复制到当前目录的 dist 文件夹
+ * copyClaudeAgents({ target: 'dist' })
+ *
+ * // 手动指定根目录为向上三级，复制到 build 文件夹
+ * copyClaudeAgents({
+ *   target: 'build',
+ *   rootDir: '../../../'
+ * })
+ *
+ * // 使用绝对路径指定根目录
+ * copyClaudeAgents({
+ *   target: 'dist',
+ *   rootDir: '/absolute/path/to/monorepo'
+ * })
+ */
+export function copyClaudeAgents(options: CopyClaudeAgentsOptions): void {
+	// 检查源目录是否存在
+	if (!hasClaudeAgents({ rootDir: options.rootDir })) {
+		return;
+	}
+
+	const root = resolveRootDir(options.rootDir);
+	const source = path.join(root, ".claude/agents");
+	const destination = path.resolve(process.cwd(), options.target);
+
+	// 确保目标文件夹的父目录存在
+	fs.mkdirSync(path.dirname(destination), { recursive: true });
+
+	// 递归复制文件夹
+	fs.cpSync(source, destination, { recursive: true });
+
+	consola.success(`已成功复制 .claude/agents 到 ${destination}`);
+}