@ruan-cat/utils 4.10.0 → 4.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruan-cat/utils",
-  "version": "4.10.0",
+  "version": "4.12.0",
   "description": "阮喵喵工具集合。默认提供js文件，也直接提供ts文件。",
   "type": "module",
   "main": "./src/index.ts",
@@ -61,27 +61,27 @@
     "tsconfig.json"
   ],
   "dependencies": {
-    "@vueuse/integrations": "^13.7.0",
-    "axios": "^1.11.0",
+    "@vueuse/integrations": "^13.9.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.17.2",
+    "@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.10",
+    "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.0.0",
+    "unplugin-auto-import": "^20.1.0",
     "unplugin-vue-router": "^0.15.0",
     "vite-plugin-autogeneration-import-file": "^3.0.0",
     "vitepress": "^1.6.4"

package/src/.vitepress/config.mts

@@ -1,5 +1,5 @@
 // 工具包文档项目 直接导入生成文档配置 避免出现循环依赖
-import { setUserConfig, setGenerateSidebar, withMermaid } from "../../../vitepress-preset-config";
+import { setUserConfig, setGenerateSidebar } from "../../../vitepress-preset-config";
 import { addChangelog2doc, copyReadmeMd } from "@ruan-cat/utils/node-esm";
 
 import { description } from "../../package.json";
@@ -33,4 +33,4 @@ const userConfig = setUserConfig({
 userConfig.themeConfig.sidebar = setGenerateSidebar({
 	documentRootPath: "src",
 });
-export default withMermaid(userConfig);
+export default userConfig;

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,35 @@
+import fs from "node:fs";
+import path from "node:path";
+import consola from "consola";
+
+/** 检查当前运行的根目录 是否存在 .claude/agents 文件夹 */
+export function hasClaudeAgents() {
+	const res = fs.existsSync(path.resolve(process.cwd(), ".claude/agents"));
+	if (!res) {
+		consola.log("当前项目根目录为：", process.cwd());
+		consola.warn("当前项目根目录不存在 .claude/agents 文件夹");
+	}
+	return res;
+}
+
+/**
+ * 将 .claude/agents 文件夹复制到指定要求的位置内
+ * @description
+ * 该函数相当于实现 `cpx .claude/agents <target>` 命令
+ */
+export function copyClaudeAgents(/** 目标文件夹 */ target: string) {
+	if (!hasClaudeAgents()) {
+		return;
+	}
+
+	const source = path.resolve(process.cwd(), ".claude/agents");
+	const destination = path.resolve(process.cwd(), target);
+
+	// 确保目标文件夹的父目录存在
+	fs.mkdirSync(path.dirname(destination), { recursive: true });
+
+	// 递归复制文件夹
+	fs.cpSync(source, destination, { recursive: true });
+
+	consola.success(`已成功复制 .claude/agents 到 ${destination}`);
+}

package/src/print.ts

@@ -1,5 +1,6 @@
 import { isPlainObject, isArray } from "lodash-es";
 import { isConditionsSome } from "./conditions";
+import consola from "consola";
 
 /**
  * 一个简单的格式化函数
@@ -21,3 +22,29 @@ export function printFormat(params: any) {
 
 	return res;
 }
+
+export interface PrintListParams {
+	/** 标题，可以是字符串或根据列表生成标题的函数 */
+	title: ((stringList: string[]) => string) | string;
+	/** 要显示的字符串列表 */
+	stringList: string[];
+}
+
+/**
+ * 输出字符串列表
+ * @description
+ * 1. 生成编号列表文本
+ * 2. 生成标题文本
+ * 3. 输出标题和列表
+ */
+export function printList({ title, stringList }: PrintListParams): void {
+	// 生成编号列表文本
+	const listText = stringList.map((item, index) => `${index + 1}. ${item}`).join("\n");
+
+	// 生成标题文本
+	const titleText = typeof title === "function" ? title(stringList) : title;
+
+	// 输出标题和列表
+	consola.info(titleText);
+	consola.box(listText);
+}

package/tsconfig.json

@@ -26,25 +26,19 @@
 		"skipLibCheck": true,
 		// 需要使用 ThisType 工具
 		"noImplicitThis": true,
-		"types": [
-			"typedoc",
-			"typedoc-plugin-markdown",
-			"node"
-		],
+		"types": ["typedoc", "typedoc-plugin-markdown", "node"],
 		"paths": {
-			"@ruan-cat/utils/*": [
-				"./src/*"
-			]
-		},
+			"@ruan-cat/utils/*": ["./src/*"]
+		}
 	},
 	"include": [
-		"./src/**/*.ts",
+		"./src/**/*.ts"
 		// "./src/**/*.js",
 		// "./tests/**/*.ts",
 		// "./tests/**/*.js",
 	],
 	"exclude": [
 		// 测试用例的全部文件 交由本项目根目录下的 tsconfig.json 处理
-		"src/tests/**/*.ts",
+		"src/tests/**/*.ts"
 	]
-}
+}