@luxkit/cli 1.0.0 → 1.0.2

package/README.md

@@ -4,45 +4,39 @@
 
 **One-click project formatting & VSCode config CLI**
 
-[![npm version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/TTT1231/lux)
+[![npm version](https://img.shields.io/npm/v/@luxkit/cli.svg)](https://www.npmjs.com/package/@luxkit/cli)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org/)
 [![License: ISC](https://img.shields.io/badge/license-ISC-purple.svg)](https://opensource.org/licenses/ISC)
 [![TypeScript](https://img.shields.io/badge/TypeScript-6.0-3178C6.svg)](https://www.typescriptlang.org/)
 [![ESM Only](https://img.shields.io/badge/ESM-only-F7DF1E.svg)](https://nodejs.org/api/esm.html)
 
-<br />
-
-<a href="#-english">English</a> | <a href="#-中文">中文</a>
+**English** | [中文](./README_Zh.md)
 
 </div>
 
 ---
 
-<br />
-
-## 🇬🇧 English
-
-<br />
-
 ### What is lux?
 
 `lux` is a CLI tool that initializes project formatting configs and VSCode workspace settings with a single command. It generates ESLint, Prettier, Stylelint, CSpell, EditorConfig files and VSCode settings from battle-tested presets — with smart merge and conflict resolution.
 
-<br />
+<div align="center">
+  <img src="demo.gif" alt="lux demo" width="640" />
+</div>
 
 ### ✨ Key Highlights
 
-| Feature | Description |
-|:--------|:------------|
-| 🎯 **One Command Setup** | `lux fmt init web` generates all linting & formatting configs instantly |
-| 🔧 **5 Fmt Presets** | `web` · `electron` · `uniapp` · `node` · `nest` — each with curated rules |
-| 🖥️ **6 VSCode Presets** | `web` · `electron` · `uniapp` · `node` · `nest` · `go` — settings + extensions |
-| 🔀 **Smart Merge** | Preset wins for linting keys; user wins for personal preferences |
-| 🛡️ **Conflict Resolution** | `neverOverwrite` / `forceOverwrite` lists + `--force` flag |
-| 📦 **Auto Install** | Detects bun / pnpm / yarn / npm and installs devDependencies |
-| 🔍 **Fuzzy Matching** | Typo a preset name? Levenshtein distance finds the closest match |
-| 🧪 **Dry Run** | Preview all changes with `--dry-run` before writing anything |
-| 🔗 **Script Injection** | Auto-injects `<pm> lint` / `<pm> format` scripts into package.json |
+| Feature                    | Description                                                                    |
+| :------------------------- | :----------------------------------------------------------------------------- |
+| 🎯 **One Command Setup**   | `lux fmt web` generates all linting & formatting configs instantly        |
+| 🔧 **5 Fmt Presets**       | `web` · `electron` · `uniapp` · `node` · `nest` — each with curated rules      |
+| 🖥️ **6 VSCode Presets**    | `web` · `electron` · `uniapp` · `node` · `nest` · `go` — settings + extensions |
+| 🔀 **Smart Merge**         | Preset wins for linting keys; user wins for personal preferences               |
+| 🛡️ **Conflict Resolution** | `neverOverwrite` / `forceOverwrite` lists + `--force` flag                     |
+| 📦 **Auto Install**        | Detects bun / pnpm / yarn / npm and installs devDependencies                   |
+| 🔍 **Fuzzy Matching**      | Typo a preset name? Levenshtein distance finds the closest match               |
+| 🧪 **Dry Run**             | Preview all changes with `--dry-run` before writing anything                   |
+| 🔗 **Script Injection**    | Auto-injects `<pm> lint` / `<pm> format` scripts into package.json             |
 
 <br />
 
@@ -50,15 +44,15 @@
 
 ```bash
 # Install globally (pick your package manager)
-npm install -g lux
+npm install -g @luxkit/cli
 # or
-bun add -g lux
+bun add -g @luxkit/cli
 
 # Initialize formatting configs
-lux fmt init web          # Generate ESLint, Prettier, Stylelint, CSpell, EditorConfig
+lux fmt web          # Generate ESLint, Prettier, Stylelint, CSpell, EditorConfig
 
 # Initialize VSCode settings
-lux vscode init web       # Generate .vscode/settings.json + extensions.json
+lux vscode web       # Generate .vscode/settings.json + extensions.json
 
 # List available presets
 lux fmt list
@@ -69,34 +63,34 @@ lux vscode list
 
 ### CLI Commands
 
-| Command | Description |
-|:--------|:------------|
-| `lux fmt init <preset>` | Initialize formatting config files |
-| `lux fmt list` | List available fmt presets |
-| `lux vscode init <preset>` | Initialize VSCode workspace settings |
-| `lux vscode list` | List available VSCode presets |
-| `lux vpn cmd` | Copy CMD proxy env-vars to clipboard |
-| `lux vpn pw` | Copy PowerShell proxy env-vars to clipboard |
+| Command                    | Description                                 |
+| :------------------------- | :------------------------------------------ |
+| `lux fmt <preset>`    | Initialize formatting config files          |
+| `lux fmt list`             | List available fmt presets                  |
+| `lux vscode <preset>` | Initialize VSCode workspace settings        |
+| `lux vscode list`          | List available VSCode presets               |
+| `lux vpn cmd`              | Copy CMD proxy env-vars to clipboard        |
+| `lux vpn pw`               | Copy PowerShell proxy env-vars to clipboard |
 
 <br />
 
 ### Available Presets
 
-| Preset | Fmt | VSCode | Stack |
-|:-------|:---:|:------:|:------|
-| `web` | ✅ | ✅ | Vue / React / TS / CSS |
-| `electron` | ✅ | ✅ | Electron + Web stack |
-| `uniapp` | ✅ | ✅ | UniApp / WeChat Mini Program |
-| `node` | ✅ | ✅ | Node.js backend |
-| `nest` | ✅ | ✅ | NestJS backend |
-| `go` | — | ✅ | Go backend |
+| Preset     | Fmt | VSCode | Stack                        |
+| :--------- | :-: | :----: | :--------------------------- |
+| `web`      | ✅  |   ✅   | Vue / React / TS / CSS       |
+| `electron` | ✅  |   ✅   | Electron + Web stack         |
+| `uniapp`   | ✅  |   ✅   | UniApp / WeChat Mini Program |
+| `node`     | ✅  |   ✅   | Node.js backend              |
+| `nest`     | ✅  |   ✅   | NestJS backend               |
+| `go`       |  —  |   ✅   | Go backend                   |
 
 <br />
 
 ### Options
 
 ```bash
-lux fmt init <preset> [options]
+lux fmt <preset> [options]
 
   --force       Force overwrite existing files
   --no-install  Skip dependency installation
@@ -108,7 +102,7 @@ lux fmt init <preset> [options]
 ### How It Works
 
 ```
-lux fmt init web
+lux fmt web
        │
        ▼
   Parse CLI args ──► Resolve preset (fuzzy match on typo)
@@ -132,15 +126,15 @@ lux fmt init web
 
 ### Tech Stack
 
-| Category | Technology |
-|:---------|:-----------|
-| Language | TypeScript 6.0 (ESM-only) |
-| Runtime | Node.js 18+ |
-| Build | tsup |
-| Test | Vitest (unit + acceptance) |
-| CLI | Commander.js |
-| Output | Chalk |
-| Bundle | Zero runtime deps (chalk + commander only) |
+| Category | Technology                                 |
+| :------- | :----------------------------------------- |
+| Language | TypeScript 6.0 (ESM-only)                  |
+| Runtime  | Node.js 18+                                |
+| Build    | tsup                                       |
+| Test     | Vitest (unit + acceptance)                 |
+| CLI      | Commander.js                               |
+| Output   | Chalk                                      |
+| Bundle   | Zero runtime deps (chalk + commander only) |
 
 <br />
 
@@ -152,7 +146,7 @@ cd lux
 bun install
 
 bun link                  # Register `lux` globally for testing
-lux fmt init web          # Test it on any project
+lux fmt web          # Test it on any project
 
 bun test                  # Run tests
 bun build                 # Build to dist/
@@ -167,157 +161,4 @@ bun code:check:all        # lint + format + spell check
 
 <br />
 
-<p align="right"><a href="#-中文">切换到中文 →</a></p>
-
----
-
-<br />
-
-## 🇨🇳 中文
-
-<br />
-
-### lux 是什么？
-
-`lux` 是一个 CLI 工具，只需一条命令即可初始化项目格式化配置和 VSCode 工作区设置。它从经过实战检验的预设中生成 ESLint、Prettier、Stylelint、CSpell、EditorConfig 配置文件以及 VSCode 设置 —— 并带有智能合并和冲突解决机制。
-
-<br />
-
-### ✨ 核心亮点
-
-| 特性 | 说明 |
-|:-----|:-----|
-| 🎯 **一键配置** | `lux fmt init web` 即可生成所有 lint 与格式化配置 |
-| 🔧 **5 种格式化预设** | `web` · `electron` · `uniapp` · `node` · `nest` — 各配备精选规则 |
-| 🖥️ **6 种 VSCode 预设** | `web` · `electron` · `uniapp` · `node` · `nest` · `go` — 设置 + 扩展推荐 |
-| 🔀 **智能合并** | 预设优先覆盖 linting 相关键；用户配置优先保留个人偏好 |
-| 🛡️ **冲突解决** | `neverOverwrite` / `forceOverwrite` 列表 + `--force` 标志 |
-| 📦 **自动安装** | 自动检测 bun / pnpm / yarn / npm 并安装 devDependencies |
-| 🔍 **模糊匹配** | 预设名拼错了？Levenshtein 距离帮你找到最接近的匹配 |
-| 🧪 **Dry Run** | 使用 `--dry-run` 预览所有变更，不写入任何文件 |
-| 🔗 **脚本注入** | 自动将 `<pm> lint` / `<pm> format` 脚本注入 package.json |
-
-<br />
-
-### 快速开始
-
-```bash
-# 全局安装（选择你的包管理器）
-npm install -g lux
-# 或
-bun add -g lux
-
-# 初始化格式化配置
-lux fmt init web          # 生成 ESLint、Prettier、Stylelint、CSpell、EditorConfig
-
-# 初始化 VSCode 设置
-lux vscode init web       # 生成 .vscode/settings.json + extensions.json
-
-# 查看可用预设
-lux fmt list
-lux vscode list
-```
-
-<br />
-
-### CLI 命令
-
-| 命令 | 说明 |
-|:-----|:-----|
-| `lux fmt init <preset>` | 初始化格式化配置文件 |
-| `lux fmt list` | 列出可用的格式化预设 |
-| `lux vscode init <preset>` | 初始化 VSCode 工作区设置 |
-| `lux vscode list` | 列出可用的 VSCode 预设 |
-| `lux vpn cmd` | 复制 CMD 代理环境变量到剪贴板 |
-| `lux vpn pw` | 复制 PowerShell 代理环境变量到剪贴板 |
-
-<br />
-
-### 可用预设
-
-| 预设 | 格式化 | VSCode | 技术栈 |
-|:-----|:------:|:------:|:-------|
-| `web` | ✅ | ✅ | Vue / React / TS / CSS |
-| `electron` | ✅ | ✅ | Electron + Web 技术栈 |
-| `uniapp` | ✅ | ✅ | UniApp / 微信小程序 |
-| `node` | ✅ | ✅ | Node.js 后端 |
-| `nest` | ✅ | ✅ | NestJS 后端 |
-| `go` | — | ✅ | Go 后端 |
-
-<br />
-
-### 命令选项
-
-```bash
-lux fmt init <preset> [options]
-
-  --force       强制覆盖已有文件
-  --no-install  跳过依赖安装
-  --dry-run     预览模式，不写入文件
-```
-
-<br />
-
-### 工作原理
-
-```
-lux fmt init web
-       │
-       ▼
-  解析 CLI 参数 ──► 解析预设（拼写错误时自动模糊匹配）
-       │
-       ▼
-  遍历每个配置文件：
-       │
-       ├── 文件不存在？ ──► 创建
-       ├── 在 neverOverwrite 中？ ──► 跳过
-       ├── 在 forceOverwrite 中？ ──► 覆盖
-       └── 已存在 + --force？ ──► 覆盖 / 跳过
-       │
-       ▼
-  注入脚本到 package.json（<pm> → bun run / pnpm run / ...）
-       │
-       ▼
-  自动安装 devDependencies（检测 lockfile 判断包管理器）
-```
-
-<br />
-
-### 技术栈
-
-| 分类 | 技术 |
-|:-----|:-----|
-| 语言 | TypeScript 6.0（纯 ESM） |
-| 运行时 | Node.js 18+ |
-| 构建 | tsup |
-| 测试 | Vitest（单元测试 + 验收测试） |
-| CLI | Commander.js |
-| 输出 | Chalk |
-| 依赖 | 零运行时依赖（仅 chalk + commander） |
-
-<br />
-
-### 开发
-
-```bash
-git clone git@github.com:TTT1231/lux.git
-cd lux
-bun install
-
-bun link                  # 全局注册 `lux` 用于测试
-lux fmt init web          # 在任意项目上测试
-
-bun test                  # 运行测试
-bun build                 # 构建到 dist/
-bun code:check:all        # lint + 格式化 + 拼写检查
-```
-
-<br />
-
-### 📄 许可证
-
-[ISC](https://opensource.org/licenses/ISC) — 可自由使用、修改和分发。
-
-<br />
-
-<p align="right"><a href="#-english">← Switch to English</a></p>
+<p align="right"><a href="./README_Zh.md">切换到中文 →</a></p>

package/dist/index.js

@@ -4,7 +4,7 @@
 import { program } from "commander";
 
 // src/commands/fmt.ts
-import path3 from "path";
+import path4 from "path";
 
 // src/presets/fmt/electron.ts
 var electronFmt = {
@@ -39,46 +39,12 @@ export default [
     null,
     2
   ) + "\n",
-  prettierIgnore: () => `# Dependencies
-node_modules/
-pnpm-lock.yaml
-package-lock.json
-
-# Build outputs
+  prettierIgnore: () => `node_modules/
+<lockfile>
 dist/
 release/
 out/
-*.tsbuildinfo
-
-# Logs
-*.log
-logs/
-
-# Environment files
-.env
-.env.local
-.env.*.local
-
-# IDE files
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Coverage
 coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
-*.woff
-*.woff2
-*.ttf
-*.eot
 `,
   stylelint: () => `export default {
   plugins: ['stylelint-order', '@stylistic/stylelint-plugin'],
@@ -101,33 +67,10 @@ coverage/
   },
 }
 `,
-  stylelintIgnore: () => `# Dependencies
-node_modules/
-pnpm-lock.yaml
-
-# Build outputs
+  stylelintIgnore: () => `node_modules/
 dist/
 release/
 out/
-*.tsbuildinfo
-
-# Logs
-*.log
-
-# Environment files
-.env
-.env.local
-
-# Coverage
-coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
 `,
   cspell: () => JSON.stringify(
     {
@@ -135,8 +78,7 @@ coverage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["vite", "pinia", "vueuse", "unplugin", "trw", "electron", "electron-builder"],
-      ignorePaths: ["pnpm-lock.yaml", "/coverage/", "*.svg", "*.png"]
+      words: ["vite", "pinia", "vueuse", "unplugin", "electron", "electron-builder"]
     },
     null,
     2
@@ -208,42 +150,11 @@ var nestFmt = {
     null,
     2
   ) + "\n",
-  prettierIgnore: () => `# Dependencies
-node_modules/
-pnpm-lock.yaml
-package-lock.json
-
-# Build outputs
+  prettierIgnore: () => `node_modules/
+<lockfile>
 dist/
 build/
-*.tsbuildinfo
-
-# Logs
-*.log
-logs/
-
-# Environment files
-.env
-.env.local
-.env.*.local
-
-# IDE files
-.vscode/
-
-# Coverage
 coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
-*.woff
-*.woff2
-*.ttf
-*.eot
 `,
   // No stylelint for NestJS
   cspell: () => JSON.stringify(
@@ -252,8 +163,7 @@ coverage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["nestjs", "typeorm", "dtos"],
-      ignorePaths: ["pnpm-lock.yaml", "*.svg", "*.png"]
+      words: ["nestjs", "typeorm", "dtos"]
     },
     null,
     2
@@ -295,7 +205,7 @@ import tseslint from 'typescript-eslint'
 
 export default defineConfig(
   {
-    ignores: ['eslint.config.mjs', 'dist/', 'vitest.config.ts', 'tsup.config.ts'],
+    ignores: ['eslint.config.mjs', 'dist/'],
   },
   eslint.configs.recommended,
   ...tseslint.configs.recommended,
@@ -345,42 +255,11 @@ export default defineConfig(
     null,
     2
   ) + "\n",
-  prettierIgnore: () => `# Dependencies
-node_modules/
-bun.lock
-package-lock.json
-
-# Build outputs
+  prettierIgnore: () => `node_modules/
+<lockfile>
 dist/
 build/
-*.tsbuildinfo
-
-# Logs
-*.log
-logs/
-
-# Environment files
-.env
-.env.local
-.env.*.local
-
-# IDE files
-.vscode/
-
-# Coverage
 coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
-*.woff
-*.woff2
-*.ttf
-*.eot
 `,
   // No stylelint for node projects
   cspell: () => JSON.stringify(
@@ -389,8 +268,7 @@ coverage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: [],
-      ignorePaths: ["bun.lock", "*.svg", "*.png"]
+      words: []
     },
     null,
     2
@@ -466,44 +344,11 @@ export default [
     null,
     2
   ) + "\n",
-  prettierIgnore: () => `# Dependencies
-node_modules/
-pnpm-lock.yaml
-package-lock.json
-
-# Build outputs (UniApp \u7F16\u8BD1\u8F93\u51FA)
+  prettierIgnore: () => `node_modules/
+<lockfile>
 dist/
 unpackage/
-
-# Logs
-*.log
-logs/
-
-# Environment files
-.env
-.env.local
-.env.*.local
-
-# IDE files
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Coverage
 coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
-*.woff
-*.woff2
-*.ttf
-*.eot
 `,
   stylelint: () => `export default {
   plugins: ['stylelint-order', '@stylistic/stylelint-plugin'],
@@ -526,31 +371,9 @@ coverage/
   },
 }
 `,
-  stylelintIgnore: () => `# Dependencies
-node_modules/
-pnpm-lock.yaml
-
-# Build outputs (UniApp \u7F16\u8BD1\u8F93\u51FA)
+  stylelintIgnore: () => `node_modules/
 dist/
 unpackage/
-
-# Logs
-*.log
-
-# Environment files
-.env
-.env.local
-
-# Coverage
-coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
 `,
   cspell: () => JSON.stringify(
     {
@@ -558,8 +381,7 @@ coverage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["vite", "pinia", "vueuse", "unplugin", "trw", "uniapp"],
-      ignorePaths: ["pnpm-lock.yaml", "/coverage/", "*.svg", "*.png"]
+      words: ["vite", "pinia", "vueuse", "unplugin", "uniapp"]
     },
     null,
     2
@@ -643,44 +465,10 @@ export default [
     null,
     2
   ) + "\n",
-  prettierIgnore: () => `# Dependencies
-node_modules/
-pnpm-lock.yaml
-package-lock.json
-
-# Build outputs
+  prettierIgnore: () => `node_modules/
+<lockfile>
 dist/
-*.tsbuildinfo
-
-# Logs
-*.log
-logs/
-
-# Environment files
-.env
-.env.local
-.env.*.local
-
-# IDE files
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Coverage
 coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
-*.woff
-*.woff2
-*.ttf
-*.eot
 `,
   stylelint: () => `export default {
   plugins: ['stylelint-order', '@stylistic/stylelint-plugin'],
@@ -703,31 +491,8 @@ coverage/
   },
 }
 `,
-  stylelintIgnore: () => `# Dependencies
-node_modules/
-pnpm-lock.yaml
-
-# Build outputs
+  stylelintIgnore: () => `node_modules/
 dist/
-*.tsbuildinfo
-
-# Logs
-*.log
-
-# Environment files
-.env
-.env.local
-
-# Coverage
-coverage/
-
-# Static assets
-*.svg
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.ico
 `,
   cspell: () => JSON.stringify(
     {
@@ -735,8 +500,7 @@ coverage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["vite", "pinia", "vueuse", "unplugin", "trw"],
-      ignorePaths: ["pnpm-lock.yaml", "/coverage/", "*.svg", "*.png"]
+      words: ["vite", "pinia", "vueuse", "unplugin"]
     },
     null,
     2
@@ -793,26 +557,17 @@ var FMT_PRESETS = [webFmt, electronFmt, uniappFmt, nodeFmt, nestFmt];
 // src/utils/logger.ts
 import chalk from "chalk";
 var logger = {
-  info(msg) {
-    console.log(chalk.blue("\u2139"), msg);
+  log(msg) {
+    console.log(msg);
   },
   success(msg) {
-    console.log(chalk.green("\u2714"), msg);
+    console.log(chalk.green(msg));
   },
   warn(msg) {
-    console.log(chalk.yellow("\u26A0"), msg);
+    console.warn(chalk.yellow(msg));
   },
   error(msg) {
-    console.error(chalk.red("\u2716"), msg);
-  },
-  skip(file, reason) {
-    console.log(chalk.yellow("\u2298"), chalk.gray(file), chalk.gray(`(${reason})`));
-  },
-  create(file) {
-    console.log(chalk.green("\u271A"), file);
-  },
-  overwrite(file) {
-    console.log(chalk.cyan("\u21BB"), file);
+    console.error(chalk.red(msg));
   }
 };
 
@@ -868,7 +623,7 @@ function resolvePreset(presets, name) {
       name,
       presets.map((p) => p.name)
     );
-    console.error(chalk2.red("\u2716"), err.message);
+    console.error(chalk2.red(err.message));
     process.exit(1);
   }
   return found;
@@ -936,89 +691,46 @@ function generateConfigFile(preset, filename, content, opts) {
   const filepath = path2.join(opts.cwd, filename);
   const exists = fileExists(filepath);
   const action = resolveConflict(filename, exists, preset, opts.force);
-  if (action === "skip") {
-    logger.skip(filename, "already exists");
-    return false;
-  }
-  if (opts.dryRun) {
-    logger.info(`[dry-run] Would ${exists ? "overwrite" : "create"} ${filename}`);
-    return true;
-  }
-  writeFile(filepath, content);
-  if (exists) {
-    logger.overwrite(filename);
-  } else {
-    logger.create(filename);
-  }
-  return true;
+  if (action === "skip") return "skipped";
+  if (opts.dryRun) return exists ? "overwritten" : "created";
+  const resolved = opts.lockfile ? content.replace(/<lockfile>/g, opts.lockfile) : content.replace(/<lockfile>\n?/g, "");
+  writeFile(filepath, resolved);
+  return exists ? "overwritten" : "created";
 }
 function generateAllFmt(preset, opts) {
-  const generated = [];
+  const result = { created: [], overwritten: [], skipped: [] };
   for (const { filename, getContent } of CONFIG_FILES) {
     const content = getContent(preset);
     if (content === void 0) continue;
-    if (generateConfigFile(preset, filename, content, opts)) {
-      generated.push(filename);
-    }
-  }
-  return generated;
-}
-
-// src/presets/versions.ts
-var DEPS_VERSIONS = {
-  eslint: "^10.2.0",
-  "@eslint/js": "^10.0.1",
-  "typescript-eslint": "^8.58.0",
-  "eslint-plugin-prettier": "^5.5.5",
-  "eslint-config-prettier": "^10.1.8",
-  "@vue/eslint-config-typescript": "^14.7.0",
-  "@vue/eslint-config-prettier": "^10.2.0",
-  "eslint-plugin-vue": "^10.8.0",
-  prettier: "^3.8.1",
-  stylelint: "^17.6.0",
-  "stylelint-config-standard-scss": "^17.0.0",
-  "stylelint-order": "^8.1.1",
-  "stylelint-scss": "^7.0.0",
-  "@stylistic/stylelint-plugin": "^5.1.0",
-  "postcss-html": "^1.8.1",
-  "postcss-scss": "^4.0.9",
-  cspell: "^10.0.0"
-};
-function resolveVersions(packages) {
-  return packages.map((pkg) => {
-    const version = DEPS_VERSIONS[pkg];
-    return version ? `${pkg}@${version}` : pkg;
-  });
-}
-
-// src/utils/execFileNoThrow.ts
-import { exec } from "child_process";
-import { promisify } from "util";
-var execAsync = promisify(exec);
-async function execFileNoThrow(command, args, options) {
-  const cmdStr = args.length > 0 ? `${command} ${args.join(" ")}` : command;
-  try {
-    const { stdout, stderr } = await execAsync(cmdStr, {
-      cwd: options?.cwd
-    });
-    return { stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0 };
-  } catch (err) {
-    const error = err;
-    return {
-      stdout: (error.stdout ?? "").trim(),
-      stderr: (error.stderr ?? "").trim(),
-      exitCode: error.code === "ENOENT" ? null : 1
-    };
+    const action = generateConfigFile(preset, filename, content, opts);
+    if (action === "created") result.created.push(filename);
+    else if (action === "overwritten") result.overwritten.push(filename);
+    else if (action === "skipped") result.skipped.push(filename);
   }
+  return result;
 }
 
 // src/utils/deps.ts
+import path3 from "path";
+import { spawn } from "child_process";
 function detectPackageManager(cwd) {
   if (fileExists(`${cwd}/bun.lockb`) || fileExists(`${cwd}/bun.lock`)) return "bun";
   if (fileExists(`${cwd}/pnpm-lock.yaml`)) return "pnpm";
   if (fileExists(`${cwd}/yarn.lock`)) return "yarn";
   return "npm";
 }
+function getLockfileName(pm) {
+  switch (pm) {
+    case "bun":
+      return "bun.lock";
+    case "pnpm":
+      return "pnpm-lock.yaml";
+    case "yarn":
+      return "yarn.lock";
+    case "npm":
+      return "package-lock.json";
+  }
+}
 function getRunPrefix(pm) {
   switch (pm) {
     case "bun":
@@ -1031,85 +743,150 @@ function getRunPrefix(pm) {
       return "npm run";
   }
 }
-var INSTALL_CMDS = {
-  bun: ["bun", ["add"]],
-  pnpm: ["pnpm", ["add"]],
-  yarn: ["yarn", ["add"]],
-  npm: ["npm", ["install"]]
-};
 async function installDevDeps(packages, cwd, pm) {
   const manager = pm ?? detectPackageManager(cwd);
-  const resolvedPackages = resolveVersions(packages);
-  logger.info(`Installing ${resolvedPackages.length} devDependencies via ${manager}...`);
-  const [command, subcommand] = INSTALL_CMDS[manager];
-  const args = [...subcommand, "-D", ...resolvedPackages];
-  const { stderr, exitCode } = await execFileNoThrow(command, args, { cwd });
+  const pkg = readJson(path3.join(cwd, "package.json"));
+  if (!pkg) {
+    throw new Error("package.json not found");
+  }
+  const devDeps = pkg.devDependencies ?? {};
+  const missing = packages.filter((pkg2) => !devDeps[pkg2]);
+  if (missing.length === 0) return;
+  const addCmd = manager === "npm" ? "npm install -D" : `${manager} add -D`;
+  const exitCode = await new Promise((resolve) => {
+    const child = spawn(`${addCmd} ${missing.join(" ")}`, {
+      cwd,
+      shell: true,
+      stdio: "inherit"
+    });
+    const timer = setTimeout(() => {
+      child.kill();
+      resolve(null);
+    }, 12e4);
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve(code);
+    });
+    child.on("error", () => {
+      clearTimeout(timer);
+      resolve(1);
+    });
+  });
+  if (exitCode === null) {
+    throw new Error("Dependency installation timed out (120s)");
+  }
   if (exitCode !== 0) {
-    logger.error(`Failed to install dependencies: ${stderr}`);
     throw new Error(`Dependency installation failed (exit code ${exitCode})`);
   }
-  logger.success(`Installed ${resolvedPackages.length} packages`);
 }
 
 // src/commands/fmt.ts
 function registerFmtCommand(program2) {
-  const fmt = program2.command("fmt");
-  fmt.command("init <preset>").description("Initialize formatting config with preset").option("-F, --force", "Force overwrite existing files").option("--no-install", "Skip dependency installation").option("--dry-run", "Preview without writing files").action(
+  const fmt = program2.command("fmt").description("Initialize formatting config with preset");
+  fmt.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--no-install", "Skip dependency installation").option("--dry-run", "Preview without writing files").action(
     async (presetName, options) => {
       const preset = resolvePreset(FMT_PRESETS, presetName);
       if (!preset) return;
       const cwd = process.cwd();
+      const pm = fileExists(path4.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
       const opts = {
         cwd,
         force: options.force ?? false,
-        dryRun: options.dryRun ?? false
+        dryRun: options.dryRun ?? false,
+        lockfile: pm ? getLockfileName(pm) : void 0
       };
-      logger.info(`Initializing fmt preset: ${preset.name}`);
-      logger.info(`Description: ${preset.description}`);
-      const generated = generateAllFmt(preset, opts);
-      if (generated.length === 0) {
-        logger.warn("No files generated");
+      const result = generateAllFmt(preset, opts);
+      const allFiles = [...result.created, ...result.overwritten];
+      if (allFiles.length === 0 && result.skipped.length === 0) {
+        logger.warn("No files to generate for this preset");
+        return;
+      }
+      logGenerationResult(result, opts.dryRun);
+      if (!pm) {
+        warnMissingPackageJson(preset, options.install !== false);
         return;
       }
-      logger.success(`Generated ${generated.length} config file(s)`);
       if (preset.scripts) {
-        await injectScripts(preset.scripts, opts);
+        await injectScripts(preset.scripts, opts, pm);
       }
-      if (preset.dependencies?.dev && options.install !== false) {
-        if (opts.dryRun) {
-          logger.info(`[dry-run] Would install: ${preset.dependencies.dev.join(", ")}`);
-        } else {
-          try {
-            await installDevDeps(preset.dependencies.dev, cwd);
-          } catch {
-            logger.warn("Dependency installation failed. You can install manually.");
-          }
-        }
-      } else if (preset.dependencies?.dev && options.install === false) {
-        logger.info("Dependencies to install:");
-        for (const dep of preset.dependencies.dev) {
-          console.log(`  - ${dep}`);
-        }
+      if (!preset.dependencies?.dev) return;
+      if (options.install === false) {
+        logger.log(`Dependencies: ${preset.dependencies.dev.join(", ")}`);
+        return;
+      }
+      if (opts.dryRun) {
+        logger.log(`[dry-run] Would install: ${preset.dependencies.dev.join(", ")}`);
+        return;
+      }
+      try {
+        logger.log(`Installing dependencies with ${pm}...`);
+        await installDevDeps(preset.dependencies.dev, cwd, pm);
+        logger.success("Dependencies installed successfully");
+      } catch {
+        logger.warn("Dependency installation failed. You can install manually.");
       }
-      logger.success("fmt init complete!");
     }
   );
   fmt.command("list").description("List available fmt presets").action(() => {
-    logger.info("Available fmt presets:");
     for (const p of FMT_PRESETS) {
-      console.log(`  ${p.name.padEnd(12)} ${p.description}`);
+      console.log(`${p.name.padEnd(12)} ${p.description}`);
     }
   });
 }
-async function injectScripts(scripts, opts) {
-  const pkgPath = path3.join(opts.cwd, "package.json");
+function logGenerationResult(result, dryRun) {
+  const files = [...result.created, ...result.overwritten];
+  if (dryRun) {
+    if (files.length > 0) {
+      logger.log(`[dry-run] Would create ${files.join(", ")}`);
+    }
+    if (result.skipped.length > 0) {
+      logger.log(`[dry-run] Skipped ${result.skipped.join(", ")} (already exists)`);
+    }
+    return;
+  }
+  if (result.created.length > 0) {
+    logger.log(
+      `Created ${summarizeFiles(result.created)} config ${result.created.length} file${result.created.length > 1 ? "s" : ""}`
+    );
+  }
+  if (result.overwritten.length > 0) {
+    logger.log(
+      `Overwritten ${summarizeFiles(result.overwritten)} config ${result.overwritten.length} file${result.overwritten.length > 1 ? "s" : ""}`
+    );
+  }
+  if (result.skipped.length > 0) {
+    logger.log(
+      `Skipped ${result.skipped.length} file${result.skipped.length > 1 ? "s" : ""} (already exists)`
+    );
+  }
+}
+function warnMissingPackageJson(preset, installEnabled) {
+  const tasks = [];
+  if (preset.scripts) tasks.push("script injection");
+  if (preset.dependencies?.dev && installEnabled) tasks.push("dependency installation");
+  if (tasks.length > 0) {
+    logger.warn(`package.json not found, skipping ${tasks.join(" and ")}`);
+  }
+}
+function summarizeFiles(filenames) {
+  const categories = /* @__PURE__ */ new Set();
+  for (const name of filenames) {
+    if (name.includes("eslint")) categories.add("eslint");
+    else if (name.includes("prettier")) categories.add("prettier");
+    else if (name.includes("stylelint")) categories.add("stylelint");
+    else if (name.includes("cspell")) categories.add("cspell");
+    else if (name.includes("editorconfig")) categories.add("editorconfig");
+  }
+  return [...categories].join(", ");
+}
+async function injectScripts(scripts, opts, pm) {
+  const pkgPath = path4.join(opts.cwd, "package.json");
   const pkg = readJson(pkgPath);
   if (!pkg) {
-    logger.warn("package.json not found, skipping scripts injection");
+    logger.warn("package.json not found, skipping script injection");
     return;
   }
   const existingScripts = pkg.scripts ?? {};
-  const pm = detectPackageManager(opts.cwd);
   const prefix = getRunPrefix(pm);
   const resolvedScripts = {};
   for (const [key, value] of Object.entries(scripts)) {
@@ -1119,12 +896,10 @@ async function injectScripts(scripts, opts) {
   let skipped = 0;
   for (const [key, value] of Object.entries(resolvedScripts)) {
     if (existingScripts[key] !== void 0 && !opts.force) {
-      logger.skip(`script:${key}`, "already exists");
       skipped++;
       continue;
     }
     if (opts.dryRun) {
-      logger.info(`[dry-run] Would add script: ${key}`);
       added++;
       continue;
     }
@@ -1134,7 +909,30 @@ async function injectScripts(scripts, opts) {
   if (added > 0 && !opts.dryRun) {
     pkg.scripts = existingScripts;
     writeJson(pkgPath, pkg);
-    logger.success(`Scripts: ${added} added, ${skipped} skipped`);
+    logger.log(
+      `Added ${added} script${added > 1 ? "s" : ""} to package.json${skipped > 0 ? ` (${skipped} skipped)` : ""}`
+    );
+  }
+}
+
+// src/utils/execFileNoThrow.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+async function execFileNoThrow(command, args, options) {
+  const cmdStr = args.length > 0 ? `${command} ${args.join(" ")}` : command;
+  try {
+    const { stdout, stderr } = await execAsync(cmdStr, {
+      cwd: options?.cwd
+    });
+    return { stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0 };
+  } catch (err) {
+    const error = err;
+    return {
+      stdout: (error.stdout ?? "").trim(),
+      stderr: (error.stderr ?? "").trim(),
+      exitCode: error.code === "ENOENT" ? null : 1
+    };
   }
 }
 
@@ -1187,22 +985,19 @@ async function performUpdate(pm) {
 function registerUpdateCommand(program2) {
   program2.command("update").description("Update @luxkit/cli to the latest version").option("--check", "Only check for updates without installing").action(async (options) => {
     try {
-      logger.info("Checking for updates...");
       const current = getCurrentVersion();
       const latest = await fetchLatestVersion();
       if (current === latest) {
-        logger.success(`Already up to date (v${current})`);
+        logger.log(`Already up to date (v${current})`);
         return;
       }
       if (options.check) {
-        logger.info(`New version available: v${latest} (current: v${current})`);
-        logger.info(`Run \`lux update\` to update.`);
+        logger.log(`Update available: v${current} \u2192 v${latest}`);
         return;
       }
       const pm = detectGlobalPackageManager();
-      logger.info(`Updating via ${pm}...`);
       await performUpdate(pm);
-      logger.success(`Successfully updated to v${latest}`);
+      logger.log(`Updated to v${latest}`);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       logger.error(message);
@@ -1885,49 +1680,44 @@ function isPlainObject(val) {
 // src/generators/vscode.ts
 function generateVscodeSettings(preset, opts) {
   const settingsPath = `${opts.cwd}/.vscode/settings.json`;
-  const presetSettings = preset.settings();
   if (opts.dryRun) {
-    logger.info(`[dry-run] Would merge .vscode/settings.json`);
-    return true;
+    const existingSettings2 = readJson(settingsPath);
+    return existingSettings2 ? "overwritten" : "created";
   }
+  const presetSettings = preset.settings();
   const existingSettings = readJson(settingsPath);
   if (existingSettings) {
     const backupPath = `${settingsPath}.bak`;
     if (!fileExists(backupPath)) {
       writeFile(backupPath, JSON.stringify(existingSettings, null, 2) + "\n");
-      logger.info(`Backed up .vscode/settings.json \u2192 settings.json.bak`);
+      logger.log(`Backed up .vscode/settings.json \u2192 settings.json.bak`);
     }
     const merged = mergeVscodeSettings(presetSettings, existingSettings);
     writeJson(settingsPath, merged);
-    logger.overwrite(".vscode/settings.json");
-  } else {
-    writeJson(settingsPath, presetSettings);
-    logger.create(".vscode/settings.json");
+    return "overwritten";
   }
-  return true;
+  writeJson(settingsPath, presetSettings);
+  return "created";
 }
 function generateVscodeExtensions(preset, opts) {
-  const extensionsPath = `${opts.cwd}/.vscode/extensions.json`;
-  const extensions = preset.extensions();
-  if (opts.dryRun) {
-    logger.info(`[dry-run] Would create .vscode/extensions.json`);
-    return true;
-  }
-  writeJson(extensionsPath, { recommendations: extensions });
-  logger.create(".vscode/extensions.json");
-  return true;
+  if (opts.dryRun) return "created";
+  writeJson(`${opts.cwd}/.vscode/extensions.json`, { recommendations: preset.extensions() });
+  return "created";
 }
 function generateAllVscode(preset, opts) {
-  const generated = [];
-  if (generateVscodeSettings(preset, opts)) generated.push(".vscode/settings.json");
-  if (generateVscodeExtensions(preset, opts)) generated.push(".vscode/extensions.json");
-  return generated;
+  const result = { created: [], overwritten: [], skipped: [] };
+  const settingsAction = generateVscodeSettings(preset, opts);
+  if (settingsAction === "created") result.created.push(".vscode/settings.json");
+  else if (settingsAction === "overwritten") result.overwritten.push(".vscode/settings.json");
+  const extAction = generateVscodeExtensions(preset, opts);
+  if (extAction === "created") result.created.push(".vscode/extensions.json");
+  return result;
 }
 
 // src/commands/vscode.ts
 function registerVscodeCommand(program2) {
-  const vscode = program2.command("vscode");
-  vscode.command("init <preset>").description("Initialize VSCode config with preset").option("-F, --force", "Force overwrite existing files").option("--dry-run", "Preview without writing files").action(async (presetName, options) => {
+  const vscode = program2.command("vscode").description("Initialize VSCode config with preset");
+  vscode.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--dry-run", "Preview without writing files").action(async (presetName, options) => {
     const preset = resolvePreset(VSCODE_PRESETS, presetName);
     if (!preset) return;
     const cwd = process.cwd();
@@ -1936,20 +1726,21 @@ function registerVscodeCommand(program2) {
       force: options.force ?? false,
       dryRun: options.dryRun ?? false
     };
-    logger.info(`Initializing vscode preset: ${preset.name}`);
-    logger.info(`Description: ${preset.description}`);
-    const generated = generateAllVscode(preset, opts);
-    if (generated.length === 0) {
+    const result = generateAllVscode(preset, opts);
+    const files = [...result.created, ...result.overwritten];
+    if (files.length === 0) {
       logger.warn("No files generated");
       return;
     }
-    logger.success(`Generated ${generated.length} config file(s)`);
-    logger.success("vscode init complete!");
+    if (opts.dryRun) {
+      logger.log(`[dry-run] Would create ${files.join(", ")}`);
+      return;
+    }
+    logger.log(`Created ${files.join(", ")}`);
   });
   vscode.command("list").description("List available vscode presets").action(() => {
-    logger.info("Available vscode presets:");
     for (const p of VSCODE_PRESETS) {
-      console.log(`  ${p.name.padEnd(12)} ${p.description}`);
+      console.log(`${p.name.padEnd(12)} ${p.description}`);
     }
   });
 }
@@ -1965,6 +1756,13 @@ function buildCommands(shell, httpProxy, socksProxy) {
       `set all_proxy=${socksProxy}`
     ].join("\r\n");
   }
+  if (shell === "bash") {
+    return [
+      `export https_proxy=${httpProxy}`,
+      `export http_proxy=${httpProxy}`,
+      `export all_proxy=${socksProxy}`
+    ].join("\n");
+  }
   return [
     `$env:https_proxy="${httpProxy}"`,
     `$env:http_proxy="${httpProxy}"`,
@@ -1984,15 +1782,16 @@ function parseProxy(proxy) {
 }
 var SHELL_LABELS = {
   cmd: "CMD",
-  pw: "PowerShell"
+  pw: "PowerShell",
+  bash: "Bash"
 };
 function handleCopy(shell, proxy) {
   const { httpProxy, socksProxy } = parseProxy(proxy);
   const commands = buildCommands(shell, httpProxy, socksProxy);
   if (copyToClipboard(commands)) {
-    logger.success(`\u5DF2\u590D\u5236\u5230\u526A\u8D34\u677F\uFF0CCtrl+V \u7C98\u8D34\u5230 ${SHELL_LABELS[shell]} \u5373\u53EF`);
+    logger.log(`Copied to clipboard \u2014 paste in ${SHELL_LABELS[shell]}`);
   } else {
-    logger.error("\u590D\u5236\u5230\u526A\u8D34\u677F\u5931\u8D25");
+    logger.error("Failed to copy to clipboard");
     console.log(commands);
   }
 }
@@ -2000,6 +1799,7 @@ function registerVpnCommand(program2) {
   const vpn = program2.command("vpn");
   vpn.command("cmd").description("Copy CMD proxy commands to clipboard").option("--proxy <addr>", "Proxy address", DEFAULT_PROXY).action((options) => handleCopy("cmd", options.proxy));
   vpn.command("pw").description("Copy PowerShell proxy commands to clipboard").option("--proxy <addr>", "Proxy address", DEFAULT_PROXY).action((options) => handleCopy("pw", options.proxy));
+  vpn.command("bash").description("Copy Bash proxy commands to clipboard").option("--proxy <addr>", "Proxy address", DEFAULT_PROXY).action((options) => handleCopy("bash", options.proxy));
 }
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@luxkit/cli",
-   "version": "1.0.0",
+   "version": "1.0.2",
    "description": "One-click project formatting & VSCode config CLI",
    "type": "module",
    "bin": {
@@ -28,8 +28,7 @@
       "prepublishOnly": "cross-env NODE_ENV=production bun run build",
       "test": "vitest run",
       "test:watch": "vitest",
-      "test:coverage": "vitest run --coverage",
-      "bump:deps": "bunx tsx scripts/bump-deps.ts"
+      "test:coverage": "vitest run --coverage"
    },
    "keywords": [],
    "author": "",