my-code-style 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## 变更日志
 
+## [1.9.3](https://github.com/myvn/codeStyle/compare/v1.9.2...v1.9.3) (2026-09-23)
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **init:** BUG-038 兼容段 files 补 vue/nvue——SFC 内显式 .ts import 不再报 error ([c2298af](https://github.com/myvn/codeStyle/commit/c2298af354592f4f9232d3571be5ff31075a81e5))
+- **peer:** typescript 放宽至 ^5.0.0 || ^6.0.0——TS 6（Vite 8 模板默认）不再堵死装机（BUG-039） ([fa633f1](https://github.com/myvn/codeStyle/commit/fa633f1a0f65229609cd6a38f88d032d08124e50))
+
+## [1.9.2](https://github.com/myvn/codeStyle/compare/v1.9.1...v1.9.2) (2026-09-23)
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **init:** 兼容段 off→warn——带/不带 .ts 扩展名 import 双向兼容 ([a26cfb6](https://github.com/myvn/codeStyle/commit/a26cfb6884b96c466e45b935a606c217bd39069c))
+- **init:** 显式 .ts 扩展名 import 自动兼容，fresh init 保持绿起点（BUG-037） ([4c63221](https://github.com/myvn/codeStyle/commit/4c632219817cf188d80963a45076817bcfd9d6ef))
+
 ## [1.9.1](https://github.com/myvn/codeStyle/compare/v1.9.0...v1.9.1) (2026-09-23)
 
 ### 🐛 Bug Fixes | Bug 修复

package/README.md

@@ -26,7 +26,7 @@ npx my-code-style-init --dry-run
 npx my-code-style-init                # 需保留旧文件时加 --backup
 
 # 3. 按 CLI 输出的缺失依赖清单安装 peerDependencies（会按包管理器生成命令，别漏 typescript 和 stylelint-order——后者是 recess-order 7 的 peer，Vue/SCSS 项目缺了它 stylelint 直接崩）
-pnpm add -D my-code-style eslint@^9.0.0 typescript@^5.0.0 prettier@^3.0.0 ...   # 以 CLI 实际输出为准
+pnpm add -D my-code-style eslint@^9.0.0 typescript@^6.0.0 prettier@^3.0.0 ...   # 以 CLI 实际输出为准
 
 # 4. 初始化 hooks 并首次检查
 pnpm prepare                          # npm: npm run prepare
@@ -206,13 +206,25 @@ npx my-code-style-init [--dry-run] [--backup] [--merge] [--version|-v] [--help|-
 
 ## lint 覆盖范围须知
 
-`lint` 脚本只跑 **ESLint**；Stylelint 默认只在 pre-commit 的 lint-staged 里对**本次改动的文件**执行。CI 如果只跑 `pnpm lint`，CSS/SCSS/Vue 内嵌样式不会被检查。有 CSS 预处理器的项目，init 会额外生成全量样式检查入口：
+| 入口                      | 覆盖                                            | 典型用途           |
+| ------------------------- | ----------------------------------------------- | ------------------ |
+| `pnpm lint`               | ESLint（JS/TS/Vue 脚本层）                      | 本地与 CI 基础门禁 |
+| `pnpm lint:style`         | Stylelint 全仓（Vue/HTML 内嵌 + css/scss/less） | CI 补齐样式检查    |
+| `pnpm lint:all`           | ESLint + Stylelint 全仓                         | CI 一条命令全覆盖  |
+| lint-staged（pre-commit） | 仅本次改动的文件（三件套自动修复）              | 提交门禁           |
 
-```bash
-pnpm lint:style     # stylelint "**/*.{vue,nvue,html,css,scss,less}"
-```
+`lint` 只跑 **ESLint**；Stylelint 默认只在 pre-commit 对**本次改动的文件**执行——CI 只跑 `pnpm lint` 时 CSS/SCSS/Vue 内嵌样式不会被检查。有 CSS 预处理器的项目，init 会生成 `lint:style` 与 `lint:all`。
+
+### 显式扩展名 import 的兼容行为
+
+`import-x/extensions` 默认要求相对导入**省略** `.ts/.tsx` 扩展名。Vite 等 bundler resolution 项目常写 `import x from "@/types/Foo.ts"`（合法但与该规则冲突）。
+
+init 会**自动检测**：命中显式扩展名 import 时，生成的 `eslint.config.mjs` 注入兼容段——该规则**降级为 warn**，`pnpm lint` 退出码不受影响：
 
-把 `lint:style` 加进 CI（或并进 `lint:all`）即可补齐覆盖面。
+- **带 `.ts` 与不带 `.ts` 都可以写**，两种风格共存不报错；
+- 兼容段同样覆盖 **Vue SFC（`.vue`/`.nvue`）**：`<script setup>` 里的显式扩展名 import 不会绕过兼容段报错（BUG-038）；
+- 不一致的写法仍会出 warning，作为渐进统一的风格信号；
+- 团队统一后想恢复严格检查（error 级、只允许省略），删除 `eslint.config.mjs` 里的兼容段即可。
 
 ## 项目体检：my-code-style-doctor
 
@@ -252,6 +264,7 @@ npx my-code-style-doctor
 | `pnpm prepare` 输出 `.git can't be found`，hooks 不生效              | husky 必须在 git 仓库内执行                                                                      | 先 `git init`、再 `pnpm prepare`；验证 `git config core.hooksPath` 输出 `.husky/_`                                                                                                                                                                      |
 | 安装依赖报 `ERR_PNPM_IGNORED_BUILDS`（如 `unrs-resolver`）           | pnpm 10+ 默认拦截依赖的构建脚本                                                                  | 执行 `pnpm approve-builds` 后重新安装，不是初始化失败                                                                                                                                                                                                   |
 | `eslint` 声明 `>=8.0.0` 却生成了 Flat Config                         | 无上界范围 npm 实际会装 9，CLI 按 9 生成                                                         | 确定留在 8 就把范围收紧到 `<9`（如 `~8.57.0`）后重跑 init                                                                                                                                                                                               |
+| 首次接入存量/脚手架项目，`lint:style` 集中报几十个属性顺序错         | stylelint-order（recess-order）按既有排序规约检查，脚手架模板（如 Vite 的 `style.css`）不满足    | 一次性 `stylelint "**/*.{vue,nvue,html,css,scss,less}" --fix` 自动归位后再提交；此后保持绿色。属存量风格收敛，非本配置引入的错误                                                                                                                        |
 | 重复 init 后，改过的 `.prettierrc.cjs` / hooks 被覆盖                | 除 ESLint 入口与已存在的 `.gitignore` 外，目标文件一律覆盖                                       | 先用 `--dry-run` 看清单、用 `--backup` 留档（备份含 `package.json`，目录会自动写入 `.gitignore`）                                                                                                                                                       |
 | 自定义 `lint-staged` 分组消失                                        | `lint-staged` 为整体替换，避免残留失效分组                                                       | 从 `.my-code-style-backup/package.json` 恢复后手动合并                                                                                                                                                                                                  |
 | 提交时 lint 报错、提交失败                                           | 修不了的错误（语法错误、非法 CSS 属性）会阻止提交                                                | 按提示修复；紧急情况可用 `git commit --no-verify`，但请在 **CI 用 `pnpm lint` 兜底**                                                                                                                                                                    |
@@ -268,12 +281,12 @@ npx my-code-style-doctor
 ## 测试套件
 
 ```bash
-npm run test:all               # 全量运行 197 项：用例明细 + 分类统计 + 最慢文件定位
+npm run test:all               # 全量运行 200 项：用例明细 + 分类统计 + 最慢文件定位
 npm run diagnose               # 换机器后先跑它：进程 / git / 文件系统 / hooks 各占多少
 npm run sweep                  # 给本机找最佳文件级并发（扫 integration 套件）
-npm test                       # 只跑基础 CLI 与配置矩阵（96 项）
+npm test                       # 只跑基础 CLI 与配置矩阵（98 项）
 npm run test:integration:setup # 安装现代化隔离依赖运行环境
-npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（65 项）
+npm run test:integration       # Flat Config、真实 Husky 及提交链路测试（66 项）
 npm run test:legacy:setup      # 安装 ESLint 8 隔离运行环境
 npm run test:legacy            # ESLint 8.57.0 兼容性回归测试（27 项）
 npm run test:stylelint17:setup # 安装 Stylelint 17 隔离运行环境
@@ -286,47 +299,47 @@ npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
 ```text
   my-code-style 测试套件
 
-  ▶ [1/4] 基础 CLI 与配置矩阵  （共 96 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [1/4] 基础 CLI 与配置矩阵  （共 98 项，5 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 运行器 TAP 解析：统计通过与失败、SKIP 与每用例耗时 · 7ms
       ✓ cz 交互提示为中文，且可选类型与 type-enum 一一对应 · 1ms
       ✓ peer 范围覆盖我们声明支持的上游大版本（校准防回退，BUG-027） · 0ms
       ✓ 一键安装命令对含 || 的版本范围加引号，可整段粘贴执行 · 40ms
       ✓ 初始化结尾指引把 cz 用法说清楚（先 git add + 指到 README 手册） · 80ms
       …
-     ✓ 通过 96  ·  3.6s   · 最慢文件 init-matrix.test.cjs 3.4s
+     ✓ 通过 98  ·  4.2s   · 最慢文件 init-matrix.test.cjs 4.0s
 
-  ▶ [2/4] 现代工具链与提交链  （共 65 项，24 文件 · 3 文件并发（自动：2 核 / 内存 4G））
+  ▶ [2/4] 现代工具链与提交链  （共 66 项，24 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 完整提交链：JS/TS/Vue/nvue/CSS/less 自动修复及二次复检 · 10.4s
       ✓ 发布防呆：HEAD 已有 v* tag 时拦截（此时 release 工具会静默抬版并写出空 CHANGELOG） · 609ms
       …
-     ✓ 通过 65  ·  39.5s   · 最慢文件 commit-chain-scss.test.cjs 12.7s
+     ✓ 通过 66  ·  43.8s   · 最慢文件 commit-chain-both.test.cjs 11.9s
 
   ▶ [3/4] ESLint 8 兼容性  （共 27 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 独立运行 ESLint 8 支持下限而非 ESLint 9 · 1ms
       ✓ ESLint 8 base：实际 CLI 加载生成配置并接受正常文件 · 1.3s
       …
-     ✓ 通过 27  ·  16.3s
+     ✓ 通过 27  ·  20.2s
 
   ▶ [4/4] Stylelint 17 兼容性  （共 9 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 隔离环境装的是 stylelint 17（不是 16） · 2ms
       ✓ 生成的 .stylelintrc.cjs 在 stylelint 17 下可加载并放过正常 SCSS · 700ms
       …
-     ✓ 通过 9  ·  7.4s
+     ✓ 通过 9  ·  8.8s
 
   ──────────────────────────────────────────────────────
   套件                      通过    失败    跳过    用时
   ──────────────────────────────────────────────────────
-  基础 CLI 与配置矩阵         96       0       -    3.6s
-  现代工具链与提交链          65       0       -   39.5s
-  ESLint 8 兼容性             27       0       -   16.3s
-  Stylelint 17 兼容性          9       0       -    7.4s
+  基础 CLI 与配置矩阵         98       0       -    4.2s
+  现代工具链与提交链          66       0       -   43.8s
+  ESLint 8 兼容性             27       0       -   20.2s
+  Stylelint 17 兼容性          9       0       -    8.8s
   ──────────────────────────────────────────────────────
-  合计                       197       0       -   66.8s
+  合计                       200       0       -   77.1s
   ──────────────────────────────────────────────────────
 
   ⏱ 最慢文件：eslint8.test.cjs 18.0s · commit-chain-less.test.cjs 11.4s · commit-chain-both.test.cjs 11.3s
 
-  ✅ 全部通过：197/197 项，用时 66.8s
+  ✅ 全部通过：200/200 项，用时 77.1s
 ```
 
 终端里每个套件下方还有一条实时进度条（`██████░░░░ 38/66  失败 0  4.0s`）。附加参数：
@@ -404,7 +417,7 @@ npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
 | `npm run test:integration`（运行器调度，自动并发 3）                        | 30.6s（只看集成套件那一段）                 |
 | 串行套件 + 文件级并发 23（全部一波）                                        | ✗ 3.8G 内存沙箱被 OOM 压垮（19 项 SIGKILL） |
 
-同机复测（197 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：默认自动并发 3 = 66.8s、`npm run test:integration` = 39.5s（本轮实跑；串行与 parallel 口径为早前基线实测，相对关系稳定）。
+同机复测（200 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：默认自动并发 3 = 77.1s、`npm run test:integration` = 43.8s（本轮实跑；串行与 parallel 口径为早前基线实测，相对关系稳定）。
 
 （2 核沙箱里并行收益被 CPU 争抢吃掉大半，`--concurrency=1` 时单个文件只要 0.7–4.2s；
 16 核机器上集成套件那段 ≈ 最慢子文件，即"一次真实提交"的量级。）

package/bin/init

@@ -555,7 +555,55 @@ module.exports = config
 `
 }
 
-function eslintFlatConfigContent(projectType) {
+/**
+ * 检测项目源码是否存在显式 .ts/.tsx/.mts/.cts 扩展名 import（下游 1.9.1 实测：
+ * Vite 等 bundler resolution 项目大量使用 `import xxx from "@/types/Foo.ts"`，
+ * 全部合法，但默认的 import-x/extensions 强制省略扩展名会让 fresh init 直接
+ * 报数百个错误）。命中则生成的配置注入兼容段，fresh init 保持"绿起点"。
+ */
+function detectExplicitTsImports() {
+    const roots = ["src", "app", "pages", "scripts"].filter((dir) =>
+        fs.existsSync(path.resolve(PROJECT_ROOT, dir)),
+    )
+    const scanRoots = roots.length > 0 ? roots : ["."]
+    const exts = new Set([".ts", ".tsx", ".mts", ".cts", ".vue", ".js", ".jsx", ".mjs", ".cjs"])
+    const pattern =
+        /(?:from\s+|import\s*\(\s*|require\s*\(\s*)["'][^"']+:?[\w@/.-]*\.(?:ts|tsx|mts|cts)["']/
+    let scanned = 0
+    const walk = (dir) => {
+        let entries
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true })
+        } catch {
+            return false
+        }
+        for (const entry of entries) {
+            if (scanned > 2000) return false
+            const full = path.join(dir, entry.name)
+            if (entry.isDirectory()) {
+                if (
+                    entry.name === "node_modules" ||
+                    entry.name === "dist" ||
+                    entry.name.startsWith(".")
+                )
+                    continue
+                if (walk(full)) return true
+            } else if (exts.has(path.extname(entry.name))) {
+                scanned++
+                try {
+                    if (pattern.test(fs.readFileSync(full, "utf8"))) return true
+                } catch {}
+            }
+        }
+        return false
+    }
+    for (const root of scanRoots) {
+        if (walk(path.resolve(PROJECT_ROOT, root))) return true
+    }
+    return false
+}
+
+function eslintFlatConfigContent(projectType, { compatExplicitTsImports = false } = {}) {
     let importPath = "my-code-style/eslint/flat"
     let varName = "baseConfig"
     if (projectType === "uniapp") {
@@ -566,11 +614,24 @@ function eslintFlatConfigContent(projectType) {
         varName = "vue3Config"
     }
 
+    const compatBlock = compatExplicitTsImports
+        ? `,
+// 兼容存量代码：检测到项目存在显式 .ts/.tsx 扩展名 import（Vite 等 bundler
+// resolution 下合法）。降级为 warn：带与不带扩展名都可写、不再报错阻断，
+// 两种写法的"风格不一致"仍会以警告提示，团队可渐进统一；想恢复严格检查
+// （error + 只允许省略）删除此段即可。
+{
+    // 含 vue/nvue：SFC <script setup> 内的显式 .ts import 同样走兼容口径，
+    // 否则 .vue 文件会绕过此段仍按 error 报（BUG-038）
+    files: ["**/*.{ts,tsx,mts,cts,vue,nvue}"],
+    rules: { "import-x/extensions": "warn" },
+}`
+        : ""
     return `// ESLint Flat Config — powered by my-code-style
 // https://www.npmjs.com/package/my-code-style
 import ${varName} from "${importPath}"
 
-export default [...${varName}]
+export default [...${varName}${compatBlock}]
 `
 }
 
@@ -837,6 +898,12 @@ function main() {
         console.log("      保留已有 ESLint 配置，不生成额外入口")
     } else if (useFlatConfig) {
         console.log("      生成 Flat Config 入口 eslint.config.mjs")
+        const compatExplicitTsImports = detectExplicitTsImports()
+        if (compatExplicitTsImports) {
+            console.log(
+                "      · 检测到显式 .ts 扩展名 import：已注入兼容段（import-x/extensions 降级为 warn，带/不带扩展名均可写；统一风格时删除该段）",
+            )
+        }
         files.push({
             path: "eslint.config.mjs",
             exists:
@@ -844,7 +911,7 @@ function main() {
                 fileExists("eslint.config.js") ||
                 fileExists("eslint.config.ts") ||
                 fileExists("eslint.config.cjs"),
-            content: eslintFlatConfigContent(projectType),
+            content: eslintFlatConfigContent(projectType, { compatExplicitTsImports }),
         })
     } else {
         console.log("      生成传统格式入口 .eslintrc.cjs")
@@ -984,11 +1051,13 @@ function main() {
         stepHeader(4, 6, "package.json")
         if (dryRun) {
             console.log(
-                "      · 将更新 scripts（lint / lint:fix / format / prepare / release / cz）与 lint-staged",
+                "      · 将更新 scripts（lint / lint:fix / lint:style / lint:all / format / prepare / release / cz）与 lint-staged",
             )
             return
         }
-        console.log("      ✓ scripts 已更新（lint / lint:fix / format / prepare / release / cz）")
+        console.log(
+            "      ✓ scripts 已更新（lint / lint:fix / lint:style / lint:all / format / prepare / release / cz）",
+        )
         console.log("      ✓ lint-staged 已按检测到的 CSS 预处理器生成")
     }
 
@@ -1156,7 +1225,10 @@ function main() {
                     // 配置里排除 node_modules/dist 等，glob 全仓是安全的
                     ...(skipStylelint
                         ? {}
-                        : { "lint:style": 'stylelint "**/*.{vue,nvue,html,css,scss,less}"' }),
+                        : {
+                              "lint:style": 'stylelint "**/*.{vue,nvue,html,css,scss,less}"',
+                              "lint:all": `${lintCommand} && stylelint "**/*.{vue,nvue,html,css,scss,less}"`,
+                          }),
                     format: "prettier --write .",
                     prepare: "husky",
                     release: "commit-and-tag-version",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-code-style",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "description": "Lint/Format/Git 配置工程化 npm 包（ESLint + Prettier + Stylelint + Commitlint + Husky + standard-version）",
   "type": "commonjs",
   "main": "src/eslint/uniapp.cjs",
@@ -101,7 +101,7 @@
     "stylelint-config-recommended-vue": "^2.0.0",
     "stylelint-order": "^6.0.0 || ^7.0.0 || ^8.0.0",
     "stylelint-prettier": "^5.0.0",
-    "typescript": "^5.0.0",
+    "typescript": "^5.0.0 || ^6.0.0",
     "typescript-eslint": "^8.0.0",
     "vue-eslint-parser": "^10.3.0"
   },