@ansstory/hias 1.0.4 → 1.0.5

package/lib/core/commander.js

@@ -1,40 +1,48 @@
-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 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)
+}
+
+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,
+}

package/lib/i18n/index.js

@@ -0,0 +1,77 @@
+// i18n 初始化模块 - 设置国际化并提供翻译函数
+
+const i18next = require('i18next')
+const path = require('path')
+const fs = require('fs')
+const store = require('./store')
+
+// 加载翻译资源
+const en = require('./resources/en.json')
+const zhCN = require('./resources/zh-CN.json')
+
+// 获取当前语言
+const currentLanguage = store.getLanguage()
+
+/**
+ * 初始化 i18n
+ */
+i18next.init({
+  lng: currentLanguage,
+  fallbackLng: 'en',
+  interpolation: {
+    escapeValue: false, // 不转义插值内容
+  },
+  resources: {
+    en: { translation: en },
+    'zh-CN': { translation: zhCN },
+  },
+})
+
+/**
+ * 获取翻译函数
+ * @returns {function} t 翻译函数
+ */
+function getT() {
+  return i18next.t.bind(i18next)
+}
+
+/**
+ * 更改语言
+ * @param {string} language - 语言代码
+ * @returns {boolean} 是否更改成功
+ */
+function changeLanguage(language) {
+  if (!store.SUPPORTED_LANGUAGES.includes(language)) {
+    return false
+  }
+
+  if (store.setLanguage(language)) {
+    i18next.changeLanguage(language)
+    return true
+  }
+  return false
+}
+
+/**
+ * 获取当前语言代码
+ * @returns {string} 语言代码
+ */
+function getCurrentLanguage() {
+  return i18next.language
+}
+
+/**
+ * 获取支持的语言列表
+ * @returns {array} 语言代码数组
+ */
+function getSupportedLanguages() {
+  return store.SUPPORTED_LANGUAGES
+}
+
+module.exports = {
+  getT,
+  changeLanguage,
+  getCurrentLanguage,
+  getSupportedLanguages,
+  SUPPORTED_LANGUAGES: store.SUPPORTED_LANGUAGES,
+}

package/lib/i18n/resources/en.json

@@ -0,0 +1,34 @@
+{
+  "commands": {
+    "create": "create project. For example: hias create airbnb",
+    "adv": "add vue component into a folder, For example: hias adv Demo -d src/components or hias adv index -d src/views/demo",
+    "adr": "add react jsx component into a folder, For example: hias adr Demo -d src/components or hias adr index -d src/views/demo",
+    "adrt": "add react tsx component into a folder, For example: hias adrt Demo -d src/components or hias adrt index -d src/views/demo",
+    "adrd": "add redux jsx store into a folder, For example: hias adrd useDemoStore -d src/store/modules",
+    "adrdt": "add redux tsx store into a folder, For example: hias adrdt useDemoStore -d src/store/modules",
+    "lang": "set CLI language. For example: hias lang zh-CN or hias lang en",
+    "closePort": "close processes occupying one or more ports. For example: hias close-port 8076 8077 or hias close-port 8076,8077"
+  },
+  "options": {
+    "dest": "a destination folder, For example: -d src/components"
+  },
+  "prompts": {
+    "selectTemplate": "Please select the template."
+  },
+  "messages": {
+    "downloading": "in progress...",
+    "downloadSuccess": "succeed",
+    "downloadError": "error",
+    "componentCreated": "Component creation was successful:",
+    "youRun": "you run:",
+    "langSet": "Language has been set to: {{language}}",
+    "langCurrent": "Current language: {{language}}",
+    "invalidLanguage": "Invalid language. Supported languages: {{languages}}",
+    "closePortSuccess": "Closed port {{port}}. Killed PID(s): {{pids}}",
+    "closePortNoProcess": "No process is occupying port {{port}}."
+  },
+  "languages": {
+    "en": "English",
+    "zh-CN": "简体中文"
+  }
+}

package/lib/i18n/resources/zh-CN.json

@@ -0,0 +1,34 @@
+{
+  "commands": {
+    "create": "创建项目。示例: hias create airbnb",
+    "adv": "将 Vue 组件添加到文件夹，示例: hias adv Demo -d src/components 或 hias adv index -d src/views/demo",
+    "adr": "将 React JSX 组件添加到文件夹，示例: hias adr Demo -d src/components 或 hias adr index -d src/views/demo",
+    "adrt": "将 React TSX 组件添加到文件夹，示例: hias adrt Demo -d src/components 或 hias adrt index -d src/views/demo",
+    "adrd": "将 Redux JSX Store 添加到文件夹，示例: hias adrd useDemoStore -d src/store/modules",
+    "adrdt": "将 Redux TSX Store 添加到文件夹，示例: hias adrdt useDemoStore -d src/store/modules",
+    "lang": "设置 CLI 语言。示例: hias lang zh-CN 或 hias lang en",
+    "closePort": "关闭占用一个或多个端口的进程。示例: hias close-port 8076 8077 或 hias close-port 8076,8077"
+  },
+  "options": {
+    "dest": "目标文件夹，示例: -d src/components"
+  },
+  "prompts": {
+    "selectTemplate": "请选择模板。"
+  },
+  "messages": {
+    "downloading": "正在下载...",
+    "downloadSuccess": "成功",
+    "downloadError": "错误",
+    "componentCreated": "组件创建成功:",
+    "youRun": "请运行:",
+    "langSet": "语言已设置为: {{language}}",
+    "langCurrent": "当前语言: {{language}}",
+    "invalidLanguage": "无效的语言。支持的语言: {{languages}}",
+    "closePortSuccess": "已关闭端口 {{port}}。结束的 PID: {{pids}}",
+    "closePortNoProcess": "端口 {{port}} 当前没有被进程占用。"
+  },
+  "languages": {
+    "en": "English",
+    "zh-CN": "简体中文"
+  }
+}

package/lib/i18n/store.js

@@ -0,0 +1,85 @@
+// i18n 配置存储模块 - 管理用户的语言偏好设置
+
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+
+// 配置文件路径：~/.hias-cli/config.json
+const CONFIG_DIR = path.join(os.homedir(), '.hias-cli')
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json')
+
+// 默认语言
+const DEFAULT_LANGUAGE = 'en'
+
+// 支持的语言列表
+const SUPPORTED_LANGUAGES = ['en', 'zh-CN']
+
+/**
+ * 确保配置目录存在
+ */
+function ensureConfigDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true })
+  }
+}
+
+/**
+ * 获取当前设置的语言
+ * @returns {string} 语言代码 (如: 'en' 或 'zh-CN')
+ */
+function getLanguage() {
+  try {
+    ensureConfigDir()
+    if (fs.existsSync(CONFIG_FILE)) {
+      const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'))
+      if (config.language && SUPPORTED_LANGUAGES.includes(config.language)) {
+        return config.language
+      }
+    }
+  } catch (err) {
+    console.error('Error reading config:', err)
+  }
+  return DEFAULT_LANGUAGE
+}
+
+/**
+ * 设置语言
+ * @param {string} language - 语言代码 (如: 'en' 或 'zh-CN')
+ * @returns {boolean} 是否设置成功
+ */
+function setLanguage(language) {
+  try {
+    if (!SUPPORTED_LANGUAGES.includes(language)) {
+      return false
+    }
+
+    ensureConfigDir()
+    const config = {}
+
+    // 读取现有配置（如果存在）
+    if (fs.existsSync(CONFIG_FILE)) {
+      try {
+        Object.assign(config, JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8')))
+      } catch (err) {
+        // 忽略读取错误
+      }
+    }
+
+    // 更新语言设置
+    config.language = language
+
+    // 写入配置文件
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8')
+    return true
+  } catch (err) {
+    console.error('Error writing config:', err)
+    return false
+  }
+}
+
+module.exports = {
+  getLanguage,
+  setLanguage,
+  SUPPORTED_LANGUAGES,
+  DEFAULT_LANGUAGE,
+}

package/lib/index.js

@@ -1,7 +1,15 @@
 #! /usr/bin/env node
-const { program } = require('commander')
-const beginHelp = require('./core/help')
-const beginCommander = require('./core/commander')
-beginHelp(program)
-beginCommander(program)
-program.parse(process.argv)
+// CLI 入口文件 - 项目模板生成工具的主程序
+// 初始化国际化模块（必须在其他模块之前）
+require('./i18n')
+
+const { program } = require('commander')
+const beginHelp = require('./core/help')
+const beginCommander = require('./core/commander')
+
+// 初始化帮助信息
+beginHelp(program)
+// 初始化命令行指令
+beginCommander(program)
+// 解析命令行参数
+program.parse(process.argv)

package/lib/template/component.jsx.ejs

@@ -1,11 +1,11 @@
-import React, { memo } from 'react'
-
-const <%= name %> = memo(() => {
-  return (
-    <div>
-      <%= name %>
-    </div>
-  )
-})
-
-export default <%= name %>
+import React, { memo } from 'react'
+
+const <%= name %> = memo(() => {
+  return (
+    <div>
+      <%= name %>
+    </div>
+  )
+})
+
+export default <%= name %>

package/lib/template/component.tsx.ejs

@@ -1,12 +1,12 @@
-import React, { memo } from "react"
-import type { FC, ReactNode } from "react"
-
-interface IProps {
-  children?: ReactNode
-}
-
-const <%= name %>: FC<IProps> = memo(() => {
-  return (<div> <%= name %> </div>)
-})
-
-export default <%= name %>
+import React, { memo } from "react"
+import type { FC, ReactNode } from "react"
+
+interface IProps {
+  children?: ReactNode
+}
+
+const <%= name %>: FC<IProps> = memo(() => {
+  return (<div> <%= name %> </div>)
+})
+
+export default <%= name %>

package/lib/template/component.vue.ejs

@@ -1,13 +1,13 @@
-<script setup>
-
-</script>
-
-<template>
-  <div class="<%= lowername %>">
-    <%= name %>
-  </div>
-</template>
-
-<style lang="scss" scoped>
-  .<%=lowername %> {}
-</style>
+<script setup>
+
+</script>
+
+<template>
+  <div class="<%= lowername %>">
+    <%= name %>
+  </div>
+</template>
+
+<style lang="scss" scoped>
+  .<%=lowername %> {}
+</style>

package/lib/template/reduxStore.jsx.ejs

@@ -1,16 +1,16 @@
-import { createSlice } from '@reduxjs/toolkit'
-
-const <%= name %>SliceModule = createSlice({
-  name: '<%= name %>',
-  initialState:{
-    count: 100,
-  },
-  reducers: {
-    changeCountAction(state, { payload }) {
-      state.message = payload
-    },
-  },
-})
-
-export const { changeCountAction } = <%= name %>SliceModule.actions
-export default <%= name %>SliceModule.reducer
+import { createSlice } from '@reduxjs/toolkit'
+
+const <%= name %>SliceModule = createSlice({
+  name: '<%= name %>',
+  initialState:{
+    count: 100,
+  },
+  reducers: {
+    changeCountAction(state, { payload }) {
+      state.message = payload
+    },
+  },
+})
+
+export const { changeCountAction } = <%= name %>SliceModule.actions
+export default <%= name %>SliceModule.reducer

package/lib/template/reduxTsStore.tsx.ejs

@@ -1,22 +1,22 @@
-import { createSlice, PayloadAction } from '@reduxjs/toolkit'
-
-interface IState {
-  count: number
-}
-
-const initialState: IState = {
-  count: 100,
-}
-
-const <%= name %>SliceModule = createSlice({
-  name: '<%= name %>',
-  initialState,
-  reducers: {
-    changeCountAction(state, { payload }: PayloadAction<number>) {
-      state.count = payload
-    },
-  },
-})
-
-export const { changeCountAction } = <%= name %>SliceModule.actions
-export default <%= name %>SliceModule.reducer
+import { createSlice, PayloadAction } from '@reduxjs/toolkit'
+
+interface IState {
+  count: number
+}
+
+const initialState: IState = {
+  count: 100,
+}
+
+const <%= name %>SliceModule = createSlice({
+  name: '<%= name %>',
+  initialState,
+  reducers: {
+    changeCountAction(state, { payload }: PayloadAction<number>) {
+      state.count = payload
+    },
+  },
+})
+
+export const { changeCountAction } = <%= name %>SliceModule.actions
+export default <%= name %>SliceModule.reducer