@dengzhibo/create-vue-template 0.0.0-stage → 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 更新日志
+
+## v0 系列
+
+### v0.0.1 (2026-10-22) 
+
+* vue 脚手架创建项目

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2026] [DengZhiBo]
+
+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

@@ -1,3 +1,63 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Vue + Vite 模板脚手架
+
+生成现有 Vue + Vite + TypeScript 应用，保留 Router、Pinia 和 Vue DevTools。
+
+## 用户使用（发布到 npm 后）
+
+```sh
+pnpm create @dengzhibo/vue-template@latest my-vue-app
+
+# 等价的完整包名调用
+pnpm dlx @dengzhibo/create-vue-template@latest my-vue-app
+
+# 全选并安装依赖
+pnpm create @dengzhibo/vue-template@latest my-vue-app --yes "--features=code-quality,unit-test,e2e" --install
+
+# 不选任何功能，不安装依赖
+pnpm create @dengzhibo/vue-template@latest my-vue-app --yes --features=
+```
+
+以上命令会从 npm 获取并运行脚手架，无需下载源码或全局安装；必须先发布对应包。`--install` 控制的是生成项目的依赖安装，不是脚手架自身的下载。每个示例独立执行，请使用空目录。
+
+命令说明：[pnpm create](https://pnpm.io/cli/create)、[pnpm dlx](https://pnpm.io/cli/dlx)。
+
+项目名取目标目录名，支持 my-vue-app 等带连字符名称；目录参数可使用相对路径、绝对路径或当前目录 .。目标目录必须为空，允许保留 .git。
+
+向导顺序：创建位置 → 功能多选 → 是否安装依赖 → 确认、返回修改或取消。
+
+功能默认全部不选，Space 勾选，Enter 确认，可任意组合：
+
+- 代码规范（code-quality）：ESLint + Oxlint + Oxfmt。
+- 单元测试（unit-test）：Vitest、Vue Test Utils 和现有测试示例。
+- 端到端测试（e2e）：Playwright 和现有测试示例。
+
+Windows PowerShell 中，包含逗号的 `--features` 参数应加引号，如上例。
+
+--yes 使用非交互模式；--features= 指定逗号分隔的功能，空值为全部不选；--install 执行 pnpm install，默认不安装。
+
+未选择的功能不生成对应配置、依赖、脚本或编辑器推荐。测试的 ESLint 规则仅在代码规范与相应测试同时选择时生成。
+
+不生成 Git hooks、CI、Docker 或部署管理。基础模板现有 Vue RC 与 TypeScript bridge 覆盖保持原样；本次仅拆分现有能力。
+
+CLI Node 要求见 package.json；生成应用的 Node 要求见 templates/base/package.json。
+
+## 源码开发与维护
+
+仅在本包源码目录中使用以下命令进行本地调试：
+
+```sh
+node bin/index.js my-vue-app
+```
+
+验证：
+
+```sh
+node --test tests/*.test.mjs
+node scripts/check-package.mjs
+```
+
+测试覆盖 8 种功能组合、CLI 参数、向导返回修改、取消及目标目录保护。不要在 templates 内安装依赖。
+
+## 发布文件范围
+
+`bin/`、`lib/`、`templates/`、README、CHANGELOG、LICENSE 与 package.json 随 npm 包发布。测试、预检脚本、AGENTS.md 和本地缓存仅用于仓库维护，不需要上传 npm。`_gitignore` 在生成项目时恢复为 `.gitignore`。

package/bin/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+import { execSync } from 'node:child_process'
+import { createPlan, writePlan } from '../lib/generate.js'
+import { help, parseArgs } from '../lib/options.js'
+import { Cancelled, collectOptions } from '../lib/prompts.js'
+
+async function main() {
+  const args = process.argv.slice(2)
+  const parsed = parseArgs(args)
+  if (parsed.help) {
+    console.log(help)
+    return
+  }
+  if (!parsed.yes && (!process.stdin.isTTY || !process.stdout.isTTY))
+    throw new Error('非交互环境请使用 --yes')
+  const options = parsed.yes ? parsed.options : await collectOptions(parsed.options)
+  if (!options) {
+    console.log('已取消，未创建项目。')
+    return
+  }
+  const target = writePlan(createPlan(options))
+  console.log(`✔ 项目已创建：${target}`)
+  if (options.install) {
+    try {
+      execSync('pnpm install', { cwd: target, stdio: 'inherit' })
+    }
+    catch {
+      console.error('安装失败，文件保留，请手动运行 pnpm install')
+      process.exitCode = 1
+      return
+    }
+  }
+  console.log(`cd "${target}"\n${options.install ? '' : 'pnpm install\n'}pnpm dev`)
+}
+main().catch((error) => {
+  console.error(error instanceof Cancelled ? '已取消，未创建项目。' : error.message)
+  process.exitCode = error instanceof Cancelled ? 130 : 1
+})

package/lib/generate.js

@@ -0,0 +1,100 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { assertTarget, featureLabels, normalizeOptions } from './options.js'
+
+const templateDir = fileURLToPath(new URL('../templates/', import.meta.url))
+const skip = new Set(['node_modules', 'dist', '.npmignore', '.git', '.DS_Store', 'pnpm-lock.yaml', '.turbo'])
+const rename = { _gitignore: '.gitignore' }
+const encode = value => `${JSON.stringify(value, null, 2)}\n`
+export function createPlan(input = {}, cwd = process.cwd()) {
+  const options = normalizeOptions(input)
+  const target = path.resolve(cwd, options.location)
+  const name = path.basename(target)
+  if (!/^[a-z0-9][\w.-]*$/i.test(name))
+    throw new Error('项目名不合法')
+  assertTarget(target)
+  const files = new Map()
+  const has = feature => options.features.includes(feature)
+  function add(directory, relative = '') {
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      if (skip.has(entry.name) || entry.name.endsWith('.fragment.json'))
+        continue
+      const source = path.join(directory, entry.name)
+      if (entry.isSymbolicLink())
+        throw new Error(`模板不支持符号链接：${source}`)
+      const destination = path.posix.join(relative, rename[entry.name] || entry.name)
+      if (entry.isDirectory()) {
+        add(source, destination)
+      }
+      else {
+        if (files.has(destination))
+          throw new Error(`模板文件冲突：${destination}`)
+        files.set(destination, fs.readFileSync(source))
+      }
+    }
+  }
+  add(path.join(templateDir, 'base'))
+  const parse = file => JSON.parse(files.get(file).toString())
+  const pkg = parse('package.json')
+  for (const feature of options.features) {
+    const directory = path.join(templateDir, 'features', feature)
+    add(directory)
+    const fragment = JSON.parse(fs.readFileSync(path.join(directory, 'package.fragment.json'), 'utf8'))
+    for (const field of ['scripts', 'dependencies', 'devDependencies']) {
+      for (const [key, value] of Object.entries(fragment[field] || {})) {
+        pkg[field] ||= {}
+        if (Object.hasOwn(pkg[field], key) && pkg[field][key] !== value)
+          throw new Error(`配置冲突：${key}`)
+        pkg[field][key] = value
+      }
+    }
+  }
+  const extensions = parse('.vscode/extensions.json')
+  if (has('unit-test')) {
+    const tsconfig = parse('tsconfig.json')
+    tsconfig.references.push({ path: './tsconfig.vitest.json' })
+    files.set('tsconfig.json', encode(tsconfig))
+    extensions.recommendations.push('vitest.explorer')
+  }
+  if (has('e2e'))
+    extensions.recommendations.push('ms-playwright.playwright')
+  if (has('code-quality')) {
+    let eslint = files.get('eslint.config.ts').toString().replace(/\r\n/g, '\n')
+    for (const [feature, plugin, dependency] of [['unit-test', 'pluginVitest', '@vitest/eslint-plugin'], ['e2e', 'pluginPlaywright', 'eslint-plugin-playwright']]) {
+      if (!has(feature)) {
+        delete pkg.devDependencies[dependency]
+        eslint = eslint.replace(new RegExp(`^import ${plugin}.*\\n`, 'm'), '')
+        eslint = eslint.replace(new RegExp(`  \{\\n    \\.\\.\\.${plugin}[\\s\\S]*?\\n  \},\\n`), '')
+      }
+    }
+    files.set('eslint.config.ts', eslint)
+    const oxlint = parse('.oxlintrc.json')
+    if (!has('unit-test'))
+      oxlint.plugins = oxlint.plugins.filter(p => p !== 'vitest')
+    files.set('.oxlintrc.json', encode(oxlint))
+    const settings = JSON.parse(fs.readFileSync(path.join(templateDir, 'features/code-quality/settings.fragment.json'), 'utf8'))
+    files.set('.vscode/settings.json', encode({ ...parse('.vscode/settings.json'), ...settings }))
+    extensions.recommendations.push('dbaeumer.vscode-eslint', 'EditorConfig.EditorConfig', 'oxc.oxc-vscode')
+  }
+  files.set('.vscode/extensions.json', encode(extensions))
+  pkg.name = name
+  files.set('package.json', encode(pkg))
+  let readme = files.get('README.md').toString().replace(/\r\n/g, '\n')
+  const sections = [['unit-test', 'Run Unit Tests'], ['e2e', 'Run End-to-End Tests'], ['code-quality', 'Lint with']]
+  for (const [feature, title] of sections) {
+    if (!has(feature))
+      readme = readme.replace(new RegExp(`### ${title}[\\s\\S]*?(?=\\n### |$)`), '')
+  }
+  files.set('README.md', `${readme.replace('# base', `# ${name}`).trimEnd()}\n\n已选功能：${options.features.map(f => featureLabels[f]).join('、') || '无'}\n`)
+  return { target, options, files }
+}
+export function writePlan(plan) {
+  assertTarget(plan.target)
+  for (const [relative, content] of plan.files) {
+    const file = path.join(plan.target, relative)
+    fs.mkdirSync(path.dirname(file), { recursive: true })
+    fs.writeFileSync(file, content)
+  }
+  return plan.target
+}

package/lib/options.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+export const featureLabels = { 'code-quality': '代码规范', 'unit-test': '单元测试', 'e2e': '端到端测试' }
+export function normalizeOptions(input = {}) {
+  const features = input.features ?? []
+  if (!Array.isArray(features) || features.some(f => !Object.hasOwn(featureLabels, f)))
+    throw new Error('功能仅支持 code-quality、unit-test、e2e')
+  return { location: input.location || '.', features: Object.keys(featureLabels).filter(f => features.includes(f)), install: Boolean(input.install) }
+}
+export function assertTarget(target) {
+  let current = target
+  while (true) {
+    if (fs.existsSync(current) && fs.lstatSync(current).isSymbolicLink())
+      throw new Error('目标路径不能经过符号链接')
+    const parent = path.dirname(current)
+    if (parent === current)
+      break
+    current = parent
+  }
+  if (fs.existsSync(target) && (!fs.statSync(target).isDirectory() || fs.readdirSync(target).some(name => name !== '.git')))
+    throw new Error('目标必须为空目录（允许保留 .git）')
+}
+
+export const help = `用法：create-vue-template [目录] [选项]
+  --yes, -y           非交互创建
+  --features=code-quality,unit-test,e2e  选择功能，默认全部不选
+  --features=         全部不选
+  --install           安装依赖，默认不安装
+  --help, -h          帮助
+项目名取目标目录名，例如 my-vue-app。`
+export function parseArgs(args) {
+  if (args.includes('--help') || args.includes('-h'))
+    return { help: true }
+  const options = normalizeOptions()
+  const locations = []
+  let yes = false
+  for (const arg of args) {
+    if (['--yes', '-y'].includes(arg))
+      yes = true
+    else if (arg.startsWith('--features='))
+      options.features = arg.slice('--features='.length) === '' ? [] : arg.slice('--features='.length).split(',')
+    else if (arg === '--install')
+      options.install = true
+    else if (arg.startsWith('-'))
+      throw new Error(`未知参数：${arg}`)
+    else locations.push(arg)
+  }
+  if (locations.length > 1)
+    throw new Error('只能指定一个创建目录')
+  options.location = locations[0] || '.'
+  return { options: normalizeOptions(options), yes }
+}

package/lib/prompts.js

@@ -0,0 +1,318 @@
+/* eslint-disable no-console */
+
+import path from 'node:path'
+/**
+ * 命令行交互问答模块
+ *
+ * 作用：
+ *   为脚手架提供终端交互能力，并把问答结果整理成创建计划所需的选项。
+ *   bin 入口只负责调用，所有输入框、单选、多选的渲染和按键处理都在本文件。
+ *
+ * 导出：
+ *   Cancelled      用户主动取消（Ctrl+C / Esc / 输入流结束）时抛出的异常
+ *   prompt         通用交互组件，支持三种形式：
+ *                    - 文本输入（不传 choices）
+ *                    - 单选（传 choices）
+ *                    - 多选（传 choices 且 multiple: true）
+ *   collectOptions 配置向导，按顺序提问并处理选项之间的联动
+ *   summary        把创建计划整理成确认页的文字摘要
+ *
+ * 实现要点：
+ *   - 基于 Node 原生 readline 的按键事件，开启 Raw 模式后自行绘制界面，不依赖第三方库。
+ *   - 当前问题限制在终端可视高度内，长列表随当前选项滚动；完成后收起为一行摘要。
+ *   - 选中状态用符号和颜色双重表示：即使终端不支持颜色，符号也能区分选中与否。
+ *   - 颜色在 NO_COLOR 环境变量存在时自动关闭。
+ *
+ * 终端兼容：
+ *   多选符号曾使用 ☑ / ☐，在部分 Windows 终端字体里 ☑ 缺失，显示成空方块，
+ *   导致已选和未选无法区分，因此改用 ◉ / ◯。若仍有显示问题，
+ *   将下方 MARK_ON / MARK_OFF 改为 '[x]' / '[ ]' 即可。
+ */
+import readline from 'node:readline'
+import { featureLabels, normalizeOptions } from './options.js'
+
+/** 用户主动中断（Ctrl+C 或 Esc）时抛出，由调用方统一捕获 */
+export class Cancelled extends Error {}
+
+// ---------------------------------------------------------------------------
+// 显示样式
+// ---------------------------------------------------------------------------
+
+// 多选框符号（已选 / 未选）
+const MARK_ON = '◉'
+const MARK_OFF = '◯'
+// 单选框符号（当前项 / 其他项）
+const RADIO_ON = '●'
+const RADIO_OFF = '○'
+
+const useColor = !process.env.NO_COLOR
+const paint = code => text => (useColor ? `\x1B[${code}m${text}\x1B[0m` : text)
+const green = paint(32)
+const cyan = paint(36)
+const red = paint(31)
+const gray = paint(90)
+
+// 去掉颜色转义序列，用于计算真实显示宽度
+// eslint-disable-next-line no-control-regex
+const stripAnsi = text => text.replace(/\x1B\[[0-9;]*m/g, '')
+
+// 单个字符的显示宽度：中日韩、全角字符和表情占 2 格，其余占 1 格
+function charWidth(char) {
+  const code = char.codePointAt(0)
+  if (/\p{Mark}/u.test(char) || code === 0x200D)
+    return 0
+  const wide
+    = (code >= 0x1100 && code <= 0x115F)
+      || (code >= 0x2E80 && code <= 0xA4CF)
+      || (code >= 0xAC00 && code <= 0xD7A3)
+      || (code >= 0xF900 && code <= 0xFAFF)
+      || (code >= 0xFE30 && code <= 0xFE6F)
+      || (code >= 0xFF00 && code <= 0xFF60)
+      || (code >= 0xFFE0 && code <= 0xFFE6)
+      || (code >= 0x1F300 && code <= 0x1F64F)
+      || (code >= 0x20000 && code <= 0x3FFFD)
+  return wide ? 2 : 1
+}
+
+// 每行保留一格，避免行尾自动换行使光标回退行数失真；不截断颜色转义序列。
+function fitLine(line, columns) {
+  const limit = Math.max(1, columns - 1)
+  if ([...stripAnsi(line)].reduce((width, char) => width + charWidth(char), 0) <= limit)
+    return line
+  let result = ''
+  let width = 0
+  // eslint-disable-next-line no-control-regex
+  for (const token of line.match(/\x1B\[[0-9;]*m|[\s\S]/gu) || []) {
+    if (token.startsWith('\x1B')) {
+      result += token
+      continue
+    }
+    width += charWidth(token)
+    if (width > limit - 1)
+      break
+    result += token
+  }
+  return `${result}…\x1B[0m`
+}
+
+// ---------------------------------------------------------------------------
+// 通用交互组件
+// ---------------------------------------------------------------------------
+
+/**
+ * 显示一个交互问题并返回用户的回答。
+ *
+ * 参数：
+ *   title         问题标题
+ *   choices       选项数组 [{ value, label, group?, required? }]；不传则为文本输入
+ *   multiple      是否多选（需要 choices）
+ *   initial       初始值：单选为某个 value，多选为 value 数组，文本为字符串
+ *   defaultValue  文本输入留空时使用的默认值
+ *   hint          标题下方的多行提示
+ *   validate      校验函数，返回错误文字则不允许提交
+ *
+ * 返回：文本为字符串，单选为选中的 value，多选为选中的 value 数组。
+ * 非终端环境会直接抛错，提示改用 --yes 和显式选项。
+ */
+export function prompt({ title, choices, multiple = false, initial, defaultValue = '', hint = '', validate = () => undefined }) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY)
+    throw new Error('交互问答需要终端；自动化调用请使用 --yes 和显式选项，详见 --help')
+
+  const input = process.stdin
+  const output = process.stdout
+  readline.emitKeypressEvents(input)
+  const wasRaw = input.isRaw
+
+  // Raw 模式：接管按键事件，阻止终端默认回显
+  input.setRawMode(true)
+  input.resume()
+
+  let index = Math.max(0, choices?.findIndex(choice => choice.value === initial) ?? 0)
+  let value = typeof initial === 'string' && !choices ? initial : ''
+  const checked = new Set(Array.isArray(initial) ? initial : [])
+
+  // 必选项始终处于选中状态
+  for (const choice of choices || []) {
+    if (choice.required)
+      checked.add(choice.value)
+  }
+  let rows = 0
+  let message = ''
+  let offset = 0
+  let columns = output.columns || 80
+
+  const clearFrame = () => {
+    if (rows) {
+      output.write(`\x1B[${rows}A\r\x1B[0J`)
+      rows = 0
+    }
+  }
+
+  // 最后一行留给光标，整个活动问题始终处于可见屏幕中，不回退到历史缓冲区。
+  const draw = (resized = false) => {
+    const height = Math.max(1, (output.rows || 24) - 1)
+    const nextColumns = Math.max(2, output.columns || 80)
+    if (resized && (nextColumns !== columns || rows > height)) {
+      // 改变宽度会使旧输出重新折行，缩小高度也可能丢失旧起点，不能再按旧行数回退。
+      output.write('\x1B[H\x1B[2J')
+      rows = 0
+    }
+    else {
+      clearFrame()
+    }
+    columns = nextColumns
+
+    const entries = []
+    let activeRow = 0
+    if (choices) {
+      for (const [i, choice] of choices.entries()) {
+        if (choice.group && choice.group !== choices[i - 1]?.group)
+          entries.push(`  ${gray(choice.group)}`)
+
+        const active = index === i
+        if (active)
+          activeRow = entries.length
+        const selected = multiple ? checked.has(choice.value) : active
+        const on = multiple ? MARK_ON : RADIO_ON
+        const off = multiple ? MARK_OFF : RADIO_OFF
+        const mark = selected ? green(on) : gray(off)
+        const pointer = active ? cyan('›') : gray('│')
+        const label = active ? cyan(choice.label) : choice.label
+        const required = choice.required ? gray('（必需）') : ''
+        entries.push(`${pointer} ${mark} ${label}${required}`)
+      }
+    }
+    else {
+      entries.push(`${gray('│')} ${value || gray(`${defaultValue}（默认）`)}`)
+    }
+
+    const hints = hint ? hint.split('\n').slice(0, Math.max(0, height - 5)).map(line => `${gray('│')} ${gray(line)}`) : []
+    const tip = choices ? (multiple ? '↑↓ 移动，Space 勾选，Enter 确认' : '↑↓ 选择，Enter 确认') : 'Enter 确认'
+    let lines
+    if (height < 3) {
+      // 极小窗口优先保留当前选项；两行可用时同时显示校验或操作提示。
+      lines = [entries[activeRow]]
+      if (height === 2)
+        lines.push(`${gray('└')} ${message ? red(message) : gray(tip)}`)
+    }
+    else {
+      const budget = height - hints.length - 2
+      const overflow = entries.length > budget
+      const indicators = overflow && budget >= 3
+      const capacity = indicators ? budget - 2 : budget
+      offset = Math.max(0, Math.min(offset, activeRow, entries.length - capacity))
+      if (activeRow >= offset + capacity)
+        offset = activeRow - capacity + 1
+      const visible = entries.slice(offset, offset + capacity)
+      if (indicators) {
+        visible.unshift(gray(offset ? '│ ↑ 上方还有选项' : '│ 已到列表顶部'))
+        visible.push(gray(offset + capacity < entries.length ? '│ ↓ 下方还有选项' : '│ 已到列表底部'))
+      }
+      const position = overflow && choices ? ` [${index + 1}/${choices.length}]` : ''
+      lines = [`${cyan('◆')} ${title}`, ...visible, ...hints, `${gray('└')} ${message ? red(message) : gray(`${position} ${tip}`.trim())}`]
+    }
+
+    rows = lines.length
+    output.write(`${lines.map(line => fitLine(line, columns)).join('\n')}\n`)
+  }
+
+  return new Promise((resolve, reject) => {
+    // 还原终端状态并移除监听，任何结束路径都必须调用
+    function cleanup() {
+      input.removeListener('keypress', onKey)
+      input.removeListener('end', onEnd)
+      input.removeListener('error', onError)
+      output.removeListener('resize', onResize)
+      input.setRawMode(Boolean(wasRaw))
+      input.pause()
+      output.write('\x1B[?25h')
+    }
+    function onEnd() {
+      clearFrame()
+      cleanup()
+      reject(new Cancelled('已取消'))
+    }
+    function onError(error) {
+      cleanup()
+      reject(error)
+    }
+    function onResize() {
+      draw(true)
+    }
+
+    // 按键处理：取消、确认、上下移动、空格勾选、文本输入
+    function onKey(str, key = {}) {
+      if ((key.ctrl && key.name === 'c') || key.name === 'escape') {
+        onEnd()
+        return
+      }
+      message = ''
+      if (key.name === 'return') {
+        const result = choices
+          ? multiple
+            ? choices.filter(choice => checked.has(choice.value)).map(choice => choice.value)
+            : choices[index].value
+          : value.trim() || defaultValue
+        message = validate(result) || ''
+        if (message) {
+          draw()
+          return
+        }
+        const answer = choices
+          ? choices.filter(choice => multiple ? checked.has(choice.value) : choice.value === result).map(choice => choice.label).join('、') || '未选择'
+          : result
+        clearFrame()
+        output.write(`${fitLine(`${green('✓')} ${title}：${answer}`, columns)}\n`)
+        cleanup()
+        resolve(result)
+        return
+      }
+      if (choices) {
+        if (key.name === 'up')
+          index = (index - 1 + choices.length) % choices.length
+        if (key.name === 'down')
+          index = (index + 1) % choices.length
+        if (multiple && key.name === 'space' && !choices[index].required) {
+          const selected = choices[index].value
+          if (checked.has(selected))
+            checked.delete(selected)
+          else checked.add(selected)
+        }
+      }
+      else if (key.name === 'backspace') {
+        value = [...value].slice(0, -1).join('')
+      }
+      else if (key.ctrl && key.name === 'u') {
+        value = ''
+      }
+      else if (str && !key.ctrl && !key.meta && [...str].every(char => char.codePointAt(0) >= 32 && char.codePointAt(0) !== 127)) {
+        value += str
+      }
+      draw()
+    }
+
+    input.on('keypress', onKey)
+    input.once('end', onEnd)
+    input.once('error', onError)
+    output.on('resize', onResize)
+    output.write('\x1B[?25l')
+    draw()
+  })
+}
+
+// ---------------------------------------------------------------------------
+
+export async function collectOptions(previous = {}, ask = prompt) {
+  const options = normalizeOptions(previous)
+  options.location = await ask({ title: '项目创建位置', initial: options.location === '.' ? '' : options.location, defaultValue: '.', hint: '输入 my-vue-app：新建项目文件夹；输入 .：在当前目录创建；支持相对或绝对路径' }) || '.'
+  options.features = await ask({ title: '选择可选功能', multiple: true, choices: Object.entries(featureLabels).map(([value, label]) => ({ value, label })), initial: options.features, hint: 'Space 勾选，Enter 确认；可全部不选或全部选择' })
+  options.install = await ask({ title: '是否立即安装依赖？', choices: [{ value: false, label: '暂不安装' }, { value: true, label: '立即安装' }], initial: options.install })
+  console.log(summary(options))
+  const action = await ask({ title: '确认配置', choices: [{ value: 'create', label: '开始创建' }, { value: 'edit', label: '返回修改' }, { value: 'cancel', label: '取消' }] })
+  if (action === 'edit')
+    return collectOptions(options, ask)
+  return action === 'create' ? normalizeOptions(options) : null
+}
+export function summary(options) {
+  return [`创建位置：${path.resolve(options.location)}`, `可选功能：${options.features.map(f => featureLabels[f]).join('、') || '无'}`, `安装依赖：${options.install ? '立即安装' : '暂不安装'}`].join('\n')
+}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@dengzhibo/create-vue-template",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "0.0.1",
+  "private": false,
+  "description": "Vue + Vite 应用脚手架，可选代码规范、单元测试和端到端测试",
+  "main": "bin/index.js",
+  "bin": {
+    "create-vue-template": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "templates",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE",
+    "lib"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "author": "THINKA <your-email@example.com>",
+  "license": "MIT",
+  "keywords": [
+    "vue",
+    "vite",
+    "typescript",
+    "scaffold",
+    "create"
+  ],
+  "homepage": "https://github.com/THINKA19/My-CLI/tree/main/packages/templates/frontend/vite/vue-template#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/THINKA19/My-CLI.git",
+    "directory": "packages/templates/frontend/vite/vue-template"
+  },
+  "bugs": {
+    "url": "https://github.com/THINKA19/My-CLI/issues"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "pub": "pnpm publish",
+    "test:pack": "node scripts/check-package.mjs"
+  }
 }

package/templates/base/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/templates/base/.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+  "recommendations": [
+    "Vue.volar"
+  ]
+}