babaofan-translate-cli 1.0.0 → 1.0.1

package/README.md

@@ -89,49 +89,6 @@ npm install
 - 已安装当前项目依赖
 - 能访问 Google AI Studio / Gemini 接口
 
-## 发布到 npm
-
-发布前建议先确认：
-
-- [package.json](./package.json) 中的 `name`、`version`、`description` 已经正确
-- [config.js](./config.js) 里不要保留你自己的真实 API Key
-- 本地已经执行过测试命令
-
-### 1. 登录 npm
-
-```bash
-npm login
-```
-
-### 2. 检查最终会发布哪些文件
-
-```bash
-npm pack --dry-run
-```
-
-### 3. 发布
-
-首次发布：
-
-```bash
-npm publish
-```
-
-如果后续发新版本，先改 `version`，再发布：
-
-```bash
-npm version patch
-npm publish
-```
-
-你也可以按需使用：
-
-```bash
-npm version minor
-npm version major
-```
-
-## 在别的项目里使用
 
 ### 安装
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"private": false,
 	"name": "babaofan-translate-cli",
-	"version": "1.0.0",
+	"version": "1.0.1",
 	"description": "A local CLI for scanning i18n calls, generating semantic keys, translating with Google AI Studio, and updating locale files.",
 	"type": "module",
 	"bin": {
@@ -13,7 +13,8 @@
 	"files": [
 		"bin",
 		"config.js",
-		"README.md"
+		"README.md",
+		"utils.js"
 	],
 	"keywords": [
 		"i18n",

package/utils.js

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+
+/**
+ * 公共工具函数模块
+ * 提供跨脚本使用的通用功能
+ */
+
+import chalk from "chalk";
+import path from "path";
+import fs from "fs";
+import { execSync } from "child_process";
+import os from "os";
+
+// ============================================================================
+// 路径工具
+// ============================================================================
+
+/**
+ * 获取项目根目录
+ * @returns {string} 项目根目录路径
+ */
+function getProjectRoot() {
+	// return "/Users/jiangshuai/Desktop/coding/cool/uniapp/cool-unix";
+	return process.cwd();
+}
+
+/**
+ * 获取相对于项目根目录的路径
+ * @param {string} absolutePath - 绝对路径
+ * @param {string} projectRoot - 项目根目录（可选）
+ * @returns {string} 相对路径
+ */
+function getRelativePath(absolutePath, projectRoot = getProjectRoot()) {
+	return absolutePath.replace(projectRoot, "").replace(/^\//, "");
+}
+
+// ============================================================================
+// 文件系统工具
+// ============================================================================
+
+/**
+ * 确保目录存在，不存在则创建
+ * @param {string} filePath - 文件路径或目录路径
+ */
+function ensureDirectoryExists(filePath) {
+	const dirPath = path.dirname(filePath);
+	if (!fs.existsSync(dirPath)) {
+		fs.mkdirSync(dirPath, { recursive: true });
+	}
+}
+
+/**
+ * 递归复制目录/文件（覆盖模式）
+ * @param {string} src - 源路径
+ * @param {string} dest - 目标路径
+ */
+function copyRecursive(src, dest) {
+	const stat = fs.statSync(src);
+
+	if (fs.existsSync(dest)) {
+		fs.rmSync(dest, { recursive: true, force: true });
+	}
+
+	if (stat.isDirectory()) {
+		fs.mkdirSync(dest, { recursive: true });
+		const items = fs.readdirSync(src);
+		for (const item of items) {
+			const srcPath = path.join(src, item);
+			const destPath = path.join(dest, item);
+			copyRecursive(srcPath, destPath);
+		}
+	} else {
+		fs.copyFileSync(src, dest);
+	}
+}
+
+/**
+ * 清理目录
+ * @param {string} dirPath - 目录路径
+ * @returns {boolean} 是否成功清理
+ */
+function cleanDirectory(dirPath) {
+	if (fs.existsSync(dirPath)) {
+		fs.rmSync(dirPath, { recursive: true, force: true });
+		return true;
+	}
+	return false;
+}
+
+// ============================================================================
+// 终端日志工具
+// ============================================================================
+
+/**
+ * 统一的日志工具类
+ */
+const logger = {
+	/**
+	 * 打印标题
+	 * @param {string} text - 标题文本
+	 */
+	title(text) {
+		console.log();
+		console.log(chalk.white.bold(text));
+		console.log(chalk.gray("─".repeat(50)));
+	},
+
+	/**
+	 * 打印信息
+	 * @param {string} label - 标签
+	 * @param {string} value - 值
+	 */
+	info(label, value) {
+		console.log(chalk.gray("  ●"), chalk.white(label), chalk.cyan(value));
+	},
+
+	/**
+	 * 打印成功消息
+	 * @param {string} text - 消息文本
+	 */
+	success(text) {
+		console.log(chalk.green("  ✓"), chalk.white(text));
+	},
+
+	/**
+	 * 打印警告消息
+	 * @param {string} text - 警告文本
+	 */
+	warn(text) {
+		console.log(chalk.yellow("  ⚠"), chalk.white(text));
+	},
+
+	/**
+	 * 打印错误消息
+	 * @param {string} text - 错误文本
+	 */
+	error(text) {
+		console.error(chalk.red("  ✗"), chalk.white(text));
+	},
+
+	/**
+	 * 打印文件路径
+	 * @param {string} filePath - 文件路径
+	 * @param {string} projectRoot - 项目根目录（可选）
+	 */
+	file(filePath, projectRoot = getProjectRoot()) {
+		const relativePath = getRelativePath(filePath, projectRoot);
+		console.log(chalk.gray("  +"), chalk.green(relativePath));
+	},
+
+	/**
+	 * 打印分隔线
+	 */
+	divider() {
+		console.log(chalk.gray("─".repeat(50)));
+	},
+
+	/**
+	 * 打印空行
+	 */
+	newline() {
+		console.log();
+	}
+};
+
+// ============================================================================
+// 命令行工具
+// ============================================================================
+
+/**
+ * 跨平台检测命令是否存在
+ * @param {string} command - 要检测的命令
+ * @returns {boolean} 命令是否存在
+ */
+function commandExists(command) {
+	const isWindows = os.platform() === "win32";
+
+	try {
+		if (isWindows) {
+			try {
+				execSync(`where ${command}`, { stdio: "ignore", shell: "cmd.exe" });
+				return true;
+			} catch {
+				execSync(`${command} --version`, {
+					stdio: "ignore",
+					shell: "cmd.exe",
+					timeout: 3000
+				});
+				return true;
+			}
+		} else {
+			try {
+				execSync(`which ${command}`, { stdio: "ignore" });
+				return true;
+			} catch {
+				execSync(`${command} --version`, {
+					stdio: "ignore",
+					timeout: 3000
+				});
+				return true;
+			}
+		}
+	} catch {
+		return false;
+	}
+}
+
+// ============================================================================
+// 字符串工具
+// ============================================================================
+
+/**
+ * 将连字符命名转换为驼峰命名
+ * @param {string} str - 连字符字符串
+ * @returns {string} 驼峰命名字符串
+ */
+function toCamelCase(str) {
+	return str.replace(/-([a-z])/g, (_match, letter) => letter.toUpperCase());
+}
+
+/**
+ * 将驼峰命名转换为连字符命名
+ * @param {string} str - 驼峰字符串
+ * @returns {string} 连字符命名字符串
+ */
+function toKebabCase(str) {
+	return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+
+// ============================================================================
+// 导出
+// ============================================================================
+
+export {
+	getProjectRoot,
+	getRelativePath,
+	ensureDirectoryExists,
+	copyRecursive,
+	cleanDirectory,
+	logger,
+	commandExists,
+	toCamelCase,
+	toKebabCase
+};