create-jnrs-vue 1.2.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 JNRS Tech Co., Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# create-jnrs-vue
+
+## ✨ 介绍
+巨能前端工程化开发，Vue 项目模板脚手架
+
+## 💻 技术栈
+TypeScript、Vue3 生态
+
+## 🧩 安装使用说明
+新项目默认名称为 jnrs-template-vue
+```shell
+# ✅ 正确用法
+# 创建新项目
+pnpm create jnrs-template-vue@latest
+# 在当前目录下创建项目
+pnpm create jnrs-template-vue@latest .
+
+# 安装依赖/启动开发/打包构建
+pnpm i
+pnpm dev
+pnpm build
+
+# 升级模板
+运行 `pnpm upgrade-jnrs-vue` 将项目配置升级到最新模板版本（注意：请检查 breaking changes）。
+
+# ❌ 错误用法
+pnpm add create-jnrs-vue
+```
+
+## 📂 模板项目主要结构
+```Text
+jnrs-template-vue/
+├── viteMockServe/        # Mock 服务配置
+├── public/               # 静态资源
+├── src/                  # 源码目录
+│   ├── components/       # Vue 组件
+│   ├── composables/      # 组合式函数
+│   ├── layout/           # 布局
+│   ├── views/            # 页面视图
+│   ├── router/           # 路由配置
+│   ├── api/              # 接口定义（已含 request 实例）
+│   ├── types/            # 类型定义
+│   ├── store/            # 状态管理
+│   ├── utils/            # 工具函数
+│   ├── locales/          # 国际化
+│   └── main.ts           # 应用入口
+├── index.html            # HTML 入口文件
+├── eslint.config.js      # ESLint 配置文件
+├── package.json          # 包管理配置
+└── vite.config.ts        # Vite 构建配置
+├── tsconfig.json         # TypeScript 配置
+├── auto-imports.d.ts     # 自动导入类型声明
+├── components.d.ts       # 全局组件类型声明
+├── README.md             # 项目文档
+├── .env.development      # 开发环境变量
+├── .env.production       # 生产环境变量
+├── .gitignore            # Git 忽略规则
+├── .prettierrc.json      # Prettier 格式化配置
+```
+
+

package/bin/create.mjs

@@ -0,0 +1,221 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : create.mjs
+ * @Date   : 2026/01/01
+ * @Desc.  : 脚手架创建脚本（支持 workspace:* 依赖选择）
+ */
+
+import { fileURLToPath } from 'url'
+import { dirname, join, relative } from 'path'
+import { promises as fs, existsSync } from 'fs'
+import { execSync } from 'child_process'
+import minimist from 'minimist'
+import prompts from 'prompts'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+// 检测系统中可用的包管理器
+function detectAvailablePackageManagers() {
+  const available = []
+  try {
+    execSync('pnpm --version', { stdio: 'ignore' })
+    available.push('pnpm')
+  } catch {}
+  try {
+    execSync('yarn --version', { stdio: 'ignore' })
+    available.push('yarn')
+  } catch {}
+  try {
+    execSync('npm --version', { stdio: 'ignore' })
+    available.push('npm')
+  } catch {}
+  return available.length ? available : ['npm']
+}
+
+function getInstallCommand(packageManager) {
+  switch (packageManager) {
+    case 'pnpm':
+      return ['pnpm', 'install']
+    case 'yarn':
+      return ['yarn']
+    default:
+      return ['npm', 'install']
+  }
+}
+
+function getRunCommand(packageManager, script) {
+  if (!packageManager || packageManager === 'skip') return `pnpm ${script}` // fallback for skip
+  switch (packageManager) {
+    case 'pnpm':
+      return `pnpm ${script}`
+    case 'yarn':
+      return `yarn ${script}`
+    case 'npm':
+      return `npm run ${script}`
+    default:
+      return `npm run ${script}`
+  }
+}
+
+function isValidPackageName(projectName) {
+  return /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(projectName)
+}
+
+function toValidPackageName(projectName) {
+  return projectName
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, '-')
+    .replace(/^[._]/, '')
+    .replace(/[^a-z0-9-~@/._]/g, '-')
+}
+
+// 提取 workspace:* 依赖
+function extractWorkspaceDeps(pkg) {
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies }
+  const workspaceDeps = Object.entries(deps)
+    .filter(([_, value]) => value === 'workspace:*')
+    .map(([name]) => name)
+  return workspaceDeps
+}
+
+async function main() {
+  const argv = minimist(process.argv.slice(2), { string: ['_'] })
+  let targetDir = argv._[0]
+
+  // 新增：判断是否使用当前目录
+  const isCurrentDir = targetDir === '.'
+
+  if (!targetDir) {
+    const { name } = await prompts({
+      type: 'text',
+      name: 'name',
+      message: '项目名称:',
+      initial: 'jnrs-template-vue',
+      validate: (input) => {
+        if (!input) return '请输入项目名称！'
+        if (existsSync(input)) return '目录已存在！'
+        if (!isValidPackageName(input)) {
+          return '包名称无效！请使用小写字母、连字符，不要使用特殊字符'
+        }
+        return true
+      }
+    })
+    if (!name) process.exit(1)
+    targetDir = name
+  } else if (!isCurrentDir) {
+    if (!isValidPackageName(targetDir)) {
+      console.error('❌ 无效的项目名称:', targetDir)
+      console.error('   包名称必须有效（小写、无空格等）')
+      process.exit(1)
+    }
+    if (existsSync(join(process.cwd(), targetDir))) {
+      console.error(`❌ 目录 "${targetDir}" 已存在！`)
+      process.exit(1)
+    }
+  }
+
+  const root = isCurrentDir ? process.cwd() : join(process.cwd(), targetDir.trim())
+  const templateDir = join(__dirname, '..', 'jnrs-template-vue')
+
+  await fs.cp(templateDir, root, { recursive: true })
+
+  const pkgPath = join(root, 'package.json')
+  const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf8'))
+
+  const pkgName = isCurrentDir
+    ? toValidPackageName(process.cwd().split(/[\\/]/).pop() || 'jnrs-template-vue')
+    : toValidPackageName(targetDir)
+
+  pkg.name = pkgName
+
+  // ===== 新增逻辑：处理 workspace:* 依赖 =====
+  const allWorkspaceDeps = extractWorkspaceDeps(pkg)
+  let selectedWorkspaceDeps = []
+
+  if (allWorkspaceDeps.length > 0) {
+    const defaultSelected = ['@jnrs/shared', '@jnrs/vue-core'].filter((dep) => allWorkspaceDeps.includes(dep))
+
+    const { selected } = await prompts({
+      type: 'multiselect',
+      name: 'selected',
+      message: '请选择要包含的 workspace 依赖（默认选中常用模块）:',
+      choices: allWorkspaceDeps.map((dep) => ({
+        title: dep,
+        value: dep,
+        selected: defaultSelected.includes(dep)
+      })),
+      instructions: false
+    })
+
+    selectedWorkspaceDeps = selected || []
+
+    // 移除未选中的 workspace 依赖
+    for (const section of ['dependencies', 'devDependencies']) {
+      if (!pkg[section]) continue
+      for (const dep of Object.keys(pkg[section])) {
+        if (pkg[section][dep] === 'workspace:*' && !selectedWorkspaceDeps.includes(dep)) {
+          delete pkg[section][dep]
+        }
+      }
+    }
+  }
+  // ===== 结束新增逻辑 =====
+
+  await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2))
+
+  // 检测可用包管理器
+  const availablePMs = detectAvailablePackageManagers()
+  const pmChoices = [...availablePMs.map((pm) => ({ title: pm, value: pm })), { title: '跳过安装依赖', value: 'skip' }]
+
+  const { selected: selectedPM } = await prompts({
+    type: 'select',
+    name: 'selected',
+    message: '请选择包管理器来安装依赖:',
+    choices: pmChoices,
+    initial: 0
+  })
+
+  if (!selectedPM) process.exit(1)
+
+  let packageManager = 'pnpm'
+  if (selectedPM !== 'skip') {
+    packageManager = selectedPM
+    console.log(`\n📦 使用 ${packageManager} 安装依赖项中...\n`)
+    const [cmd, ...args] = getInstallCommand(packageManager)
+    try {
+      execSync(`${cmd} ${args.join(' ')}`, {
+        cwd: root,
+        stdio: 'inherit',
+        env: { ...process.env, FORCE_COLOR: '1' }
+      })
+    } catch (e) {
+      console.error(
+        `\n⚠️ 安装依赖失败。请手动运行:\n   cd ${relative(process.cwd(), root)} && ${cmd} ${args.join(' ')}`
+      )
+      process.exit(1)
+    }
+  }
+
+  // 成功提示
+  const relativePath = relative(process.cwd(), root)
+  const devCmd = getRunCommand(packageManager, 'dev')
+
+  console.log(`\n✅ 项目创建成功! 👌`)
+  console.log(`\n👉 cd ${relativePath}`)
+  if (selectedPM === 'skip') {
+    const fallbackPM = availablePMs[0] || 'npm'
+    const [cmd, ...args] = getInstallCommand(fallbackPM)
+    console.log(`\n👉 手动安装依赖:`)
+    console.log(`   ${cmd} ${args.join(' ')}`)
+  }
+  console.log(`   ${devCmd}\n`)
+}
+
+main().catch((err) => {
+  console.error(`\n🚨 Error: ${err.message}`)
+  console.trace(err)
+  process.exit(1)
+})

package/bin/upgrade.mjs

@@ -0,0 +1,40 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : upgrade.mjs
+ * @Date   : 2026/03/11
+ * @Desc.  : 脚手架升级脚本
+ */
+
+import { execSync } from 'child_process'
+import { cpSync, readFileSync, writeFileSync } from 'fs'
+import { join } from 'path'
+
+console.log('🔄 正在拉取最新模板...')
+
+// 1. 临时创建一个最新版模板
+execSync('pnpm create jnrs-template-vue@latest ./_temp_new --force', {
+  stdio: 'inherit'
+})
+
+// 2. 安静地复制关键配置文件（不覆盖 src/）
+const filesToSync = ['package.json', 'vite.config.ts', '.eslintrc.cjs', '.prettierrc', 'tsconfig.json', 'index.html']
+
+for (const file of filesToSync) {
+  try {
+    cpSync(join('_temp_new', file), file, { force: true })
+    console.log(`✅ 同步: ${file}`)
+  } catch (e) {
+    console.warn(`⚠️ 跳过: ${file} (可能不存在)`)
+  }
+}
+
+// 3. 提示用户手动处理依赖和业务代码
+console.log('\n🔧 请运行:')
+console.log('   pnpm install')
+console.log('\n📝 注意:')
+console.log('   - 检查 package.json 差异')
+console.log('   - src/ 目录未自动更新，请手动合并新功能')
+
+// 4. 清理临时目录
+execSync('rm -rf _temp_new')

package/jnrs-template-vue/.env.development

@@ -0,0 +1,13 @@
+ENV = 'development'
+
+# 是否是 mock 模式
+VITE_USE_MOCK = true
+
+# 后端接口基地址 - 开发环境
+# VITE_BASE_URL = '192.168.1.120:6001'
+VITE_BASE_URL = '192.168.1.112:5010'
+
+# 应用运行主机（置空默认为 localhost）
+VITE_APP_HOST = ''
+# 应用运行端口（0 为自动分配）
+VITE_APP_PORT = 5788

package/jnrs-template-vue/.env.production

@@ -0,0 +1,4 @@
+ENV = 'production'
+
+# 生产环境后端接口基地址
+VITE_BASE_URL = '192.168.1.120:6001'

package/jnrs-template-vue/.prettierrc.json

@@ -0,0 +1,12 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "trailingComma": "none",
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "auto",
+  "htmlWhitespaceSensitivity": "ignore"
+}

package/jnrs-template-vue/README.md

@@ -0,0 +1,48 @@
+# jnrs-template-vue
+
+## ✨ 介绍
+巨能前端工程化开发，Vue 项目信息化管理系统
+
+## 💻 技术栈
+TypeScript、Vue3 生态
+
+## 🧩 安装使用说明
+```shell
+pnpm i
+pnpm dev
+pnpm build
+```
+
+#### 项目结构
+```Text
+jnrs-template-vue/
+├── viteMockServe/        # Mock 服务配置
+├── public/               # 静态资源
+├── src/                  # 源码目录
+│   ├── components/       # Vue 组件
+│   ├── composables/      # 组合式函数
+│   ├── layout/           # 布局
+│   ├── views/            # 页面视图
+│   ├── router/           # 路由配置
+│   ├── api/              # 接口定义（已含 request 实例）
+│   ├── types/            # 类型定义
+│   ├── store/            # 状态管理
+│   ├── utils/            # 工具函数
+│   ├── locales/          # 国际化
+│   └── main.ts           # 应用入口
+├── index.html            # HTML 入口文件
+├── eslint.config.js      # ESLint 配置文件
+├── package.json          # 包管理配置
+└── vite.config.ts        # Vite 构建配置
+├── tsconfig.json         # TypeScript 配置
+├── auto-imports.d.ts     # 自动导入类型声明
+├── components.d.ts       # 全局组件类型声明
+├── README.md             # 项目文档
+├── .env.development      # 开发环境变量
+├── .env.production       # 生产环境变量
+├── .gitignore            # Git 忽略规则
+├── .prettierrc.json      # Prettier 格式化配置
+```
+
+## ⚠️ 注意事项
+- layout 中使用了 KeepAlive 内置组件进行组件实例缓存，使用生命周期进行如“副作用清理“时注意用 onActivated / onDeactivated 替代 onMounted / onUnmounted

package/jnrs-template-vue/auto-imports.d.ts

@@ -0,0 +1,17 @@
+/* eslint-disable */
+/* prettier-ignore */
+// @ts-nocheck
+// noinspection JSUnusedGlobalSymbols
+// Generated by unplugin-auto-import
+// biome-ignore lint: disable
+export {}
+declare global {
+  const ElButton: typeof import('element-plus/es').ElButton
+  const ElCheckbox: typeof import('element-plus/es').ElCheckbox
+  const ElMessage: typeof import('element-plus/es').ElMessage
+  const ElMessageBox: typeof import('element-plus/es').ElMessageBox
+  const ElOption: typeof import('element-plus/es').ElOption
+  const ElSwitch: typeof import('element-plus/es').ElSwitch
+  const ElTableColumn: typeof import('element-plus/es').ElTableColumn
+  const vLoading: typeof import('element-plus/es').ElLoadingDirective
+}

package/jnrs-template-vue/components.d.ts

@@ -0,0 +1,51 @@
+/* eslint-disable */
+// @ts-nocheck
+// biome-ignore lint: disable
+// oxlint-disable
+// ------
+// Generated by unplugin-vue-components
+// Read more: https://github.com/vuejs/core/pull/3399
+
+export {}
+
+/* prettier-ignore */
+declare module 'vue' {
+  export interface GlobalComponents {
+    ElAside: typeof import('element-plus/es')['ElAside']
+    ElAvatar: typeof import('element-plus/es')['ElAvatar']
+    ElBadge: typeof import('element-plus/es')['ElBadge']
+    ElButton: typeof import('element-plus/es')['ElButton']
+    ElButtonGroup: typeof import('element-plus/es')['ElButtonGroup']
+    ElCard: typeof import('element-plus/es')['ElCard']
+    ElCascader: typeof import('element-plus/es')['ElCascader']
+    ElColorPicker: typeof import('element-plus/es')['ElColorPicker']
+    ElContainer: typeof import('element-plus/es')['ElContainer']
+    ElDatePicker: typeof import('element-plus/es')['ElDatePicker']
+    ElDatePickerPanel: typeof import('element-plus/es')['ElDatePickerPanel']
+    ElDialog: typeof import('element-plus/es')['ElDialog']
+    ElForm: typeof import('element-plus/es')['ElForm']
+    ElFormItem: typeof import('element-plus/es')['ElFormItem']
+    ElHeader: typeof import('element-plus/es')['ElHeader']
+    ElIcon: typeof import('element-plus/es')['ElIcon']
+    ElInput: typeof import('element-plus/es')['ElInput']
+    ElInputNumber: typeof import('element-plus/es')['ElInputNumber']
+    ElMain: typeof import('element-plus/es')['ElMain']
+    ElMenu: typeof import('element-plus/es')['ElMenu']
+    ElMenuItem: typeof import('element-plus/es')['ElMenuItem']
+    ElOption: typeof import('element-plus/es')['ElOption']
+    ElPopover: typeof import('element-plus/es')['ElPopover']
+    ElSelect: typeof import('element-plus/es')['ElSelect']
+    ElSubMenu: typeof import('element-plus/es')['ElSubMenu']
+    ElSwitch: typeof import('element-plus/es')['ElSwitch']
+    ElTable: typeof import('element-plus/es')['ElTable']
+    ElTableColumn: typeof import('element-plus/es')['ElTableColumn']
+    ElTabPane: typeof import('element-plus/es')['ElTabPane']
+    ElTabs: typeof import('element-plus/es')['ElTabs']
+    ElTag: typeof import('element-plus/es')['ElTag']
+    ElUpload: typeof import('element-plus/es')['ElUpload']
+    ElWatermark: typeof import('element-plus/es')['ElWatermark']
+  }
+  export interface GlobalDirectives {
+    vLoading: typeof import('element-plus/es')['ElLoadingDirective']
+  }
+}

package/jnrs-template-vue/eslint.config.ts

@@ -0,0 +1,40 @@
+import { fileURLToPath } from 'node:url'
+import { dirname } from 'node:path'
+import { globalIgnores } from 'eslint/config'
+import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript'
+import pluginVue from 'eslint-plugin-vue'
+import skipFormatting from '@vue/eslint-config-prettier/skip-formatting'
+import parser from '@typescript-eslint/parser'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+export default defineConfigWithVueTs(
+  {
+    name: 'app/files-to-lint',
+    files: ['**/*.{ts,mts,tsx,vue}'],
+    languageOptions: {
+      parser: parser,
+      parserOptions: {
+        tsconfigRootDir: __dirname
+      }
+    },
+    rules: {
+      // 禁止使用 any 类型（显式和隐式）
+      '@typescript-eslint/no-explicit-any': 'error',
+      'vue/multi-word-component-names': [
+        'error',
+        {
+          ignores: ['index', '403', '404']
+        }
+      ],
+      'vue/block-order': ['error', { order: ['script', 'template', 'style'] }]
+    }
+  },
+
+  globalIgnores(['**/dist/**', '**/dist-ssr/**', '**/coverage/**']),
+
+  pluginVue.configs['flat/essential'],
+  vueTsConfigs.recommended,
+  skipFormatting
+)

package/jnrs-template-vue/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>jnrs-template-vue</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/jnrs-template-vue/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "jnrs-template-vue",
+  "version": "1.2.11",
+  "description": "JNRS 信息化管理系统",
+  "author": "talia_tan",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "run-p type-check \"build-only {@}\" --",
+    "build-only": "vite build",
+    "preview": "vite preview",
+    "type-check": "vue-tsc --build",
+    "lint": "eslint . --fix",
+    "format": "prettier --write src/"
+  },
+  "dependencies": {
+    "@element-plus/icons-vue": "^2.3.2",
+    "@jnrs/shared": "1.1.14",
+    "@jnrs/vue-core": "1.2.9",
+    "@jnrs/lingshu-smart": "2.2.4",
+    "@vueuse/core": "^14.1.0",
+    "element-plus": "^2.13.3",
+    "pinia": "^3.0.4",
+    "pinia-plugin-persistedstate": "^4.7.1",
+    "vue": "^3.5.25",
+    "vue-i18n": "^11.2.8"
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "^22.0.5",
+    "@types/node": "^22.19.1",
+    "@typescript-eslint/parser": "^8.48.1",
+    "@vitejs/plugin-vue": "^6.0.2",
+    "@vue/eslint-config-prettier": "^10.2.0",
+    "@vue/eslint-config-typescript": "^14.6.0",
+    "@vue/tsconfig": "^0.8.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-vue": "~10.4.0",
+    "jiti": "^2.6.1",
+    "npm-run-all2": "^8.0.4",
+    "prettier": "3.6.2",
+    "sass": "^1.94.2",
+    "typescript": "~5.9.3",
+    "unplugin-auto-import": "^20.3.0",
+    "unplugin-vue-components": "^29.2.0",
+    "vite": "^7.2.2",
+    "vite-plugin-compression": "^0.5.1",
+    "vite-plugin-mock": "^3.0.2",
+    "vite-plugin-vue-devtools": "^8.0.5",
+    "vue-tsc": "^3.1.5"
+  }
+}