@ansstory/hias 1.0.4 → 1.0.6

package/lib/core/action.js

@@ -1,68 +1,95 @@
-const inquirer = require('inquirer')
-const chalk = require('chalk')
-const { program } = require('commander')
-var config = require('../config')
-var downloadFun = require('./download')
-const compileEjs = require('../utils/compile-ejs')
-const writeFile = require('../utils/write-file')
-const beginAction = async (project, args) => {
-  // 命令行的执行逻辑代码
-  // console.log(project);
-  // console.log(args);
-  const answer = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'framwork',
-      choices: config.framwork,
-      message: 'Please select the template.',
-    },
-  ])
-  // console.log(answer);
-  // 下载代码模板
-  downloadFun(config.foramworkUrl[answer.framwork], project)
-}
-
-async function addComponentAction(cpnName, temPath, fileType) {
-  // 边界处理: 若为 .\xx\xx\ 则转换为 ./xx/xx/
-  const dest = program.opts().dest.replace(/\\/g, '/') || 'src/components'
-  // 边界处理: 若为 ./xx/xx 则转换为 ./xx/xx/
-  const path = /[\\/]/.test(dest.at(-1)) ? dest : `${dest}/`
-
-  const [folderName = 'index'] = dest.match(/[^\\/]+(?=\/?$)/)
-  const name = cpnName === 'index' ? folderName : cpnName
-
-  const result = await compileEjs(temPath, {
-    name: name,
-    lowername: name.toLowerCase(),
-  })
-
-  const filePath = `${path}${cpnName}.${fileType}`
-
-  await writeFile(filePath, result)
-  console.log(chalk.green.bold('Component creation was successful:'), chalk.blue.bold(`${cpnName}.${fileType}`), chalk.underline(filePath))
-}
-
-async function addVueComponentAction(cpnName) {
-  await addComponentAction(cpnName, 'component.vue.ejs', 'vue')
-}
-async function addReactComponentAction(cpnName) {
-  await addComponentAction(cpnName, 'component.jsx.ejs', 'jsx')
-}
-async function addReactTsComponentAction(cpnName) {
-  await addComponentAction(cpnName, 'component.tsx.ejs', 'tsx')
-}
-async function addReduxStoreAction(cpnName) {
-  await addComponentAction(cpnName, 'reduxStore.jsx.ejs', 'jsx')
-}
-async function addReduxTsStoreAction(cpnName) {
-  await addComponentAction(cpnName, 'reduxTsStore.tsx.ejs', 'tsx')
-}
-
-module.exports = {
-  beginAction,
-  addVueComponentAction,
-  addReactComponentAction,
-  addReactTsComponentAction,
-  addReduxStoreAction,
-  addReduxTsStoreAction,
-}
+// 命令行操作处理文件 - 处理各种命令的具体执行逻辑
+
+const inquirer = require('inquirer')
+const chalk = require('chalk')
+const { program } = require('commander')
+var config = require('../config')
+var downloadFun = require('./download')
+const compileEjs = require('../utils/compile-ejs')
+const writeFile = require('../utils/write-file')
+const i18n = require('../i18n')
+
+// 创建项目的主处理函数
+const beginAction = async (project, args) => {
+  // 获取翻译函数
+  const t = i18n.getT()
+
+  // 使用 inquirer 交互式命令行提示用户选择框架
+  const answer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'framwork',
+      choices: config.framwork,
+      message: t('prompts.selectTemplate'),
+    },
+  ])
+
+  // 调用下载函数获取对应框架的模板
+  downloadFun(config.foramworkUrl[answer.framwork], project)
+}
+
+// 通用的组件/Store 添加处理函数
+async function addComponentAction(cpnName, temPath, fileType) {
+  // 获取翻译函数
+  const t = i18n.getT()
+
+  // 边界处理：将反斜杠转换为正斜杠（处理 Windows 路径格式）
+  const dest = program.opts().dest.replace(/\\/g, '/') || 'src/components'
+
+  // 边界处理：确保路径末尾带有斜杠
+  const path = /[\\/]/.test(dest.at(-1)) ? dest : `${dest}/`
+
+  // 从目标路径中提取文件夹名称（用作默认组件名）
+  const [folderName = 'index'] = dest.match(/[^\\/]+(?=\/?$)/)
+  // 如果组件名为 'index'，使用文件夹名作为实际组件名
+  const name = cpnName === 'index' ? folderName : cpnName
+
+  // 使用 EJS 模板引擎编译模板文件
+  const result = await compileEjs(temPath, {
+    name: name,
+    lowername: name.toLowerCase(),
+  })
+
+  // 拼接完整的文件路径
+  const filePath = `${path}${cpnName}.${fileType}`
+
+  // 将编译后的内容写入文件
+  await writeFile(filePath, result)
+
+  // 输出成功提示信息
+  console.log(chalk.green.bold(t('messages.componentCreated')), chalk.blue.bold(`${cpnName}.${fileType}`), chalk.underline(filePath))
+}
+
+// 添加 Vue 组件
+async function addVueComponentAction(cpnName) {
+  await addComponentAction(cpnName, 'component.vue.ejs', 'vue')
+}
+
+// 添加 React JSX 组件
+async function addReactComponentAction(cpnName) {
+  await addComponentAction(cpnName, 'component.jsx.ejs', 'jsx')
+}
+
+// 添加 React TSX 组件
+async function addReactTsComponentAction(cpnName) {
+  await addComponentAction(cpnName, 'component.tsx.ejs', 'tsx')
+}
+
+// 添加 Redux JSX Store
+async function addReduxStoreAction(cpnName) {
+  await addComponentAction(cpnName, 'reduxStore.jsx.ejs', 'jsx')
+}
+
+// 添加 Redux TSX Store
+async function addReduxTsStoreAction(cpnName) {
+  await addComponentAction(cpnName, 'reduxTsStore.tsx.ejs', 'tsx')
+}
+
+module.exports = {
+  beginAction,
+  addVueComponentAction,
+  addReactComponentAction,
+  addReactTsComponentAction,
+  addReduxStoreAction,
+  addReduxTsStoreAction,
+}

package/lib/core/close-port.js

@@ -0,0 +1,173 @@
+// 关闭端口命令处理文件 - 查找并结束占用指定端口的进程
+
+const { exec: execWithCallback } = require('child_process')
+const { promisify } = require('util')
+
+// 将 Node 回调风格的 exec 转换为 Promise，方便 async/await 调用
+const defaultExec = promisify(execWithCallback)
+
+// 端口参数标准化：校验端口必须是 1-65535 之间的数字
+function normalizePort(port) {
+  const value = String(port || '').trim()
+
+  if (!/^\d+$/.test(value)) {
+    throw new Error('Invalid port. Port must be a number between 1 and 65535.')
+  }
+
+  const number = Number(value)
+  if (number < 1 || number > 65535) {
+    throw new Error('Invalid port. Port must be a number between 1 and 65535.')
+  }
+
+  return number
+}
+
+// 解析命令行端口输入，支持空格分隔和逗号分隔两种方式
+function parsePortInputs(inputs) {
+  return unique(
+    inputs
+      .flatMap((input) => String(input).split(','))
+      .map((port) => port.trim())
+      .filter(Boolean)
+      .map(normalizePort),
+  )
+}
+
+// 从 netstat 的本地地址字段中提取端口号
+function getLocalPort(localAddress) {
+  const match = String(localAddress).match(/:(\d+)$/)
+  return match ? Number(match[1]) : null
+}
+
+// 数组去重，保持原有顺序
+function unique(values) {
+  return Array.from(new Set(values))
+}
+
+// 解析 Windows netstat 输出，提取占用目标端口的进程 PID
+function parsePidsFromWindowsNetstat(output, port) {
+  return unique(
+    String(output)
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .map((line) => line.split(/\s+/))
+      .filter((parts) => {
+        const protocol = parts[0]
+        const localAddress = parts[1]
+        const state = parts[parts.length - 2]
+
+        // 只处理本地端口匹配的连接
+        if (getLocalPort(localAddress) !== port) {
+          return false
+        }
+
+        // TCP 只结束监听进程，UDP 没有 LISTENING 状态，直接按端口匹配
+        return protocol === 'UDP' || (protocol === 'TCP' && state === 'LISTENING')
+      })
+      .map((parts) => parts[parts.length - 1])
+      .filter((pid) => /^\d+$/.test(pid)),
+  )
+}
+
+// 解析类 Unix 系统 lsof 输出，提取进程 PID
+function parsePidsFromPosixLsof(output) {
+  return unique(
+    String(output)
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter((line) => /^\d+$/.test(line)),
+  )
+}
+
+// 根据当前系统查找占用端口的进程 PID
+async function findPortPids(port, options) {
+  const exec = options.exec || defaultExec
+  const platform = options.platform || process.platform
+
+  // Windows 使用 netstat 查询所有端口，再在 Node 内部解析过滤
+  if (platform === 'win32') {
+    const { stdout } = await exec('netstat -ano')
+    return parsePidsFromWindowsNetstat(stdout, port)
+  }
+
+  // macOS/Linux 使用 lsof 查询端口；如果系统未安装 lsof 或无占用，则视为无进程
+  try {
+    const { stdout } = await exec(`lsof -ti :${port}`)
+    return parsePidsFromPosixLsof(stdout)
+  } catch (err) {
+    return []
+  }
+}
+
+// 根据平台结束指定 PID
+async function killPid(pid, options) {
+  const exec = options.exec || defaultExec
+  const platform = options.platform || process.platform
+  const command = platform === 'win32' ? `taskkill /F /PID ${pid}` : `kill -9 ${pid}`
+
+  await exec(command)
+  return pid
+}
+
+// 关闭单个端口：查找占用进程并逐个结束
+async function closePort(port, options = {}) {
+  const normalizedPort = normalizePort(port)
+  const pids = await findPortPids(normalizedPort, options)
+  const killed = []
+
+  for (const pid of pids) {
+    killed.push(await killPid(pid, options))
+  }
+
+  return {
+    port: normalizedPort,
+    pids,
+    killed,
+  }
+}
+
+// 关闭多个端口：先解析输入，再按端口顺序逐个处理
+async function closePorts(portInputs, options = {}) {
+  const ports = parsePortInputs(portInputs)
+  const results = []
+
+  for (const port of ports) {
+    results.push(await closePort(port, options))
+  }
+
+  return results
+}
+
+// CLI action：执行关闭端口命令并输出结果
+async function handleClosePortAction(ports) {
+  const chalk = require('chalk')
+  const i18n = require('../i18n')
+  const t = i18n.getT()
+
+  try {
+    const results = await closePorts(ports)
+
+    // 每个端口单独输出处理结果，方便用户定位具体端口状态
+    for (const result of results) {
+      if (result.killed.length === 0) {
+        console.log(chalk.yellow.bold(t('messages.closePortNoProcess', { port: result.port })))
+        continue
+      }
+
+      console.log(chalk.green.bold(t('messages.closePortSuccess', { port: result.port, pids: result.killed.join(', ') })))
+    }
+  } catch (err) {
+    console.log(chalk.red.bold(err.message))
+  }
+}
+
+module.exports = {
+  closePort,
+  closePorts,
+  handleClosePortAction,
+  normalizePort,
+  parsePortInputs,
+  parsePidsFromPosixLsof,
+  parsePidsFromWindowsNetstat,
+}

package/lib/core/commander.js

@@ -1,40 +1,106 @@
-const chalk = require('chalk')
-const {
-  beginAction,
-  addVueComponentAction,
-  addReactComponentAction,
-  addReactTsComponentAction,
-  addReduxStoreAction,
-  addReduxTsStoreAction,
-} = require('./action')
-
-const beginCommander = function (program) {
-  console.log()
-  program.command('create <project> [other...]').alias('crt').description('create project. For example: hias create airbnb').action(beginAction)
-  program
-    .command('adv <vuecpnname> [...others]')
-    .description(`add vue component into a folder, For example: ${chalk.green.bold(`hias addv Demo -d src/components or hias addv index -d src/views/demo`)}`)
-    .action(addVueComponentAction)
-  program
-    .command('adr <reactcpnname> [...others]')
-    .description(
-      `add react jsx component into a folder, For example: ${chalk.green.bold(`hias addr Demo -d src/components or hias addr index -d src/views/demo`)}`
-    )
-    .action(addReactComponentAction)
-  program
-    .command('adrt <reactcpnname> [...others]')
-    .description(
-      `add react tsx component into a folder, For example: ${chalk.green.bold(`hias addrt Demo -d src/components or hias addrt index -d src/views/demo`)}`
-    )
-    .action(addReactTsComponentAction)
-  program
-    .command('adrd <reactcpnname> [...others]')
-    .description(`add redux jsx store into a folder, For example: ${chalk.blue.bold(`hias adrd useDemoStore -d src/store/modules`)}`)
-    .action(addReduxStoreAction)
-  program
-    .command('adrdt <reactcpnname> [...others]')
-    .description(`add redux tsx store into a folder, For example: ${chalk.blue.bold(`hias adrdt useDemoStore -d src/store/modules`)}`)
-    .action(addReduxTsStoreAction)
-}
-
-module.exports = beginCommander
+// 命令行指令定义文件 - 配置 CLI 的所有可用命令
+
+const chalk = require('chalk')
+const i18n = require('../i18n')
+const {
+  beginAction,
+  addVueComponentAction,
+  addReactComponentAction,
+  addReactTsComponentAction,
+  addReduxStoreAction,
+  addReduxTsStoreAction,
+} = require('./action')
+const { handleLanguageAction } = require('./lang')
+const { handleClosePortAction } = require('./close-port')
+const { handleTranslateFileAction, handleTranslateFolderAction, handleSettingAction, handleGlobalSettingAction, handleRollbackAction, handleGitignoreAction } = require('./translate')
+
+// 注册所有命令行指令
+const beginCommander = function (program) {
+  // 获取翻译函数
+  const t = i18n.getT()
+
+  console.log()
+
+  // 创建项目命令：下载框架模板
+  program.command('create <project> [other...]').alias('crt').description(t('commands.create')).action(beginAction)
+
+  // 添加 Vue 组件命令
+  program.command('adv <vuecpnname> [...others]').description(t('commands.adv')).action(addVueComponentAction)
+
+  // 添加 React JSX 组件命令
+  program.command('adr <reactcpnname> [...others]').description(t('commands.adr')).action(addReactComponentAction)
+
+  // 添加 React TSX 组件命令
+  program.command('adrt <reactcpnname> [...others]').description(t('commands.adrt')).action(addReactTsComponentAction)
+
+  // 添加 Redux JSX Store 命令
+  program.command('adrd <reactcpnname> [...others]').description(t('commands.adrd')).action(addReduxStoreAction)
+
+  // 添加 Redux TSX Store 命令
+  program.command('adrdt <reactcpnname> [...others]').description(t('commands.adrdt')).action(addReduxTsStoreAction)
+
+  // 语言切换命令
+  program.command('lang [language]').description(t('commands.lang')).option('-l --list', 'show current language').action(handleLanguageAction)
+
+  // 关闭端口命令
+  program.command('close-port <ports...>').description(t('commands.closePort')).action(handleClosePortAction)
+
+  // 翻译文件命令：将单个文件中的中文替换为国际化调用并生成语言包
+  program
+    .command('tf [file] [name]')
+    .description(t('commands.translateFile'))
+    .option('-n, --name <name>', t('options.translateName'))
+    .option('--dry-run', 'preview changes without modifying files')
+    .option('--show-extractions', 'list all extracted Chinese texts without translating')
+    .option('-v, --verbose', 'verbose output with individual file logs')
+    .action((file, name, options) => {
+      name = name || options.name
+      options.name = name
+      if (!file) {
+        console.log(chalk.red(t('messages.translateFileRequired')))
+        return
+      }
+      handleTranslateFileAction(file, options)
+    })
+
+  // 翻译文件夹命令：递归翻译文件夹内所有支持的文件
+  program
+    .command('tfo [folder] [name]')
+    .description(t('commands.translateFolder'))
+    .option('-n, --name <name>', t('options.translateName'))
+    .option('--dry-run', 'preview changes without modifying files')
+    .option('--show-extractions', 'list all extracted Chinese texts without translating')
+    .option('--exclude <pattern>', 'exclude files matching glob pattern (e.g. **/*.test.js)', (val, acc) => acc.concat([val]), [])
+    .option('-v, --verbose', 'verbose output with individual file logs')
+    .action((folder, name, options) => {
+      name = name || options.name
+      options.name = name
+      if (!folder) {
+        console.log(chalk.red(t('messages.translateFolderRequired')))
+        return
+      }
+      handleTranslateFolderAction(folder, options)
+    })
+
+  // 生成翻译配置文件（项目级）
+  program.command('setting').description(t('commands.setting')).action(handleSettingAction)
+
+  // 生成全局翻译配置文件
+  program.command('globalsetting').description(t('commands.globalSetting')).action(handleGlobalSettingAction)
+
+  // 将 .hias 添加到 .gitignore
+  program.command('gitignore').description(t('commands.gitignore')).action(handleGitignoreAction)
+
+  // 回滚上一次翻译操作
+  program
+    .command('rollback')
+    .description(t('commands.rollback'))
+    .option('-l, --list', 'list available backups')
+    .option('--name <name>', 'specific backup name to rollback (default: latest)')
+    .option('--keep <count>', 'keep only N most recent backups, remove older ones')
+    .action((options) => {
+      handleRollbackAction(options)
+    })
+}
+
+module.exports = beginCommander

package/lib/core/download.js

@@ -1,19 +1,32 @@
-const download = require('download-git-repo')
-const ora = require('ora')
-const chalk = require('chalk')
-const downloadFun = function (url, project) {
-  const spinner = ora().start()
-  spinner.text = 'in progress...'
-  download('direct:' + url, project, { clone: true }, (err) => {
-    if (!err) {
-      spinner.succeed('succeed')
-      console.log(chalk.blue.bold('you run:'))
-      console.log(chalk.blue.bold('cd ' + project))
-      console.log(chalk.blue.bold('code .'))
-    } else {
-      spinner.fail(`error: ${err}`)
-    }
-  })
-}
-
-module.exports = downloadFun
+// 项目模板下载处理文件 - 从 Git 仓库下载框架模板
+
+const download = require('download-git-repo')
+const ora = require('ora')
+const chalk = require('chalk')
+const i18n = require('../i18n')
+
+// 下载框架模板函数
+const downloadFun = function (url, project) {
+  // 获取翻译函数
+  const t = i18n.getT()
+
+  // 创建加载动画
+  const spinner = ora().start()
+  spinner.text = t('messages.downloading')
+
+  // 使用 download-git-repo 库下载 Git 仓库
+  download('direct:' + url, project, { clone: true }, (err) => {
+    if (!err) {
+      // 下载成功，停止加载动画并显示成功提示
+      spinner.succeed(t('messages.downloadSuccess'))
+      console.log(chalk.blue.bold(t('messages.youRun')))
+      console.log(chalk.blue.bold('cd ' + project))
+      console.log(chalk.blue.bold('code .'))
+    } else {
+      // 下载失败，显示错误信息
+      spinner.fail(`${t('messages.downloadError')}: ${err}`)
+    }
+  })
+}
+
+module.exports = downloadFun

package/lib/core/help.js

@@ -1,6 +1,17 @@
-const beginHelp = function (program) {
-  const version = require('../../package.json').version
-  program.version(version, '-v --version')
-  program.option('-d --dest <dest>', 'a destination folder, For example: -d src/components')
-}
-module.exports = beginHelp
+// 帮助信息配置 - 定义 CLI 版本号和全局选项
+
+const i18n = require('../i18n')
+
+const beginHelp = function (program) {
+  // 获取翻译函数
+  const t = i18n.getT()
+  
+  // 从 package.json 中读取版本号
+  const version = require('../../package.json').version
+  // 设置版本号命令
+  program.version(version, '-v --version')
+  // 定义全局目标目录选项
+  program.option('-d --dest <dest>', t('options.dest'))
+}
+
+module.exports = beginHelp

package/lib/core/lang.js

@@ -0,0 +1,50 @@
+// 语言切换命令处理 - 处理用户设置 CLI 语言的操作
+
+const chalk = require('chalk')
+const i18n = require('../i18n')
+
+/**
+ * 处理语言切换命令
+ * @param {string} language - 语言代码
+ * @param {object} options - 命令选项
+ */
+const handleLanguageAction = (language, options) => {
+  const t = i18n.getT()
+
+  // 查看当前语言
+  if (options.list || options.l) {
+    const currentLang = i18n.getCurrentLanguage()
+    const langName = t(`languages.${currentLang}`)
+    console.log(chalk.blue.bold(t('messages.langCurrent', { language: langName })))
+    return
+  }
+
+  // 如果没有提供语言参数
+  if (!language) {
+    console.log(chalk.yellow.bold('Usage: hias lang <language> | hias lang -l'))
+    console.log(chalk.gray(`Supported languages: ${i18n.getSupportedLanguages().join(', ')}`))
+    return
+  }
+
+  // 验证语言是否支持
+  if (!i18n.SUPPORTED_LANGUAGES.includes(language)) {
+    const supportedLangs = i18n
+      .getSupportedLanguages()
+      .map((lang) => `${lang} (${t(`languages.${lang}`)})`)
+      .join(', ')
+    console.log(chalk.red.bold(t('messages.invalidLanguage', { languages: supportedLangs })))
+    return
+  }
+
+  // 设置语言
+  if (i18n.changeLanguage(language)) {
+    const langName = t(`languages.${language}`)
+    console.log(chalk.green.bold(t('messages.langSet', { language: langName })))
+  } else {
+    console.log(chalk.red.bold('Failed to set language'))
+  }
+}
+
+module.exports = {
+  handleLanguageAction,
+}