my-code-style 1.9.0 → 1.9.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## 变更日志
 
+## [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 修复
+
+- **doctor:** ESM-only peer 误报未安装——版本探测改文件系统链优先 ([418aeb5](https://github.com/myvn/codeStyle/commit/418aeb5c90b097719a37aa96ee9bf140a4550b45))
+- **init:** --merge 统计语义「保留/覆盖」对齐 + 新增 lint:style 全量样式入口 ([9ebe796](https://github.com/myvn/codeStyle/commit/9ebe796b7959052c1880af1af164247abcc16a98))
+
 ## [1.9.0](https://github.com/myvn/codeStyle/compare/v1.8.6...v1.9.0) (2026-09-23)
 
 ### ✨ Features | 新功能

package/README.md

@@ -204,6 +204,27 @@ npx my-code-style-init [--dry-run] [--backup] [--merge] [--version|-v] [--help|-
 - 初始化结束时**自动自检 hooks**（存在 / 非空 / 可执行位 / `lint-staged`、`commitlint` 是否可解析），只提示不阻断——把"hook 存在但不生效"消灭在当场。
 - 具备**事务回滚保护**：若在写入过程中遭遇文件权限或磁盘异常，自动回滚所有修改，恢复工作区原始状态。
 
+## lint 覆盖范围须知
+
+| 入口                      | 覆盖                                            | 典型用途           |
+| ------------------------- | ----------------------------------------------- | ------------------ |
+| `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） | 仅本次改动的文件（三件套自动修复）              | 提交门禁           |
+
+`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` 退出码不受影响：
+
+- **带 `.ts` 与不带 `.ts` 都可以写**，两种风格共存不报错；
+- 不一致的写法仍会出 warning，作为渐进统一的风格信号；
+- 团队统一后想恢复严格检查（error 级、只允许省略），删除 `eslint.config.mjs` 里的兼容段即可。
+
 ## 项目体检：my-code-style-doctor
 
 ```bash
@@ -258,12 +279,12 @@ npx my-code-style-doctor
 ## 测试套件
 
 ```bash
-npm run test:all               # 全量运行 194 项：用例明细 + 分类统计 + 最慢文件定位
+npm run test:all               # 全量运行 200 项：用例明细 + 分类统计 + 最慢文件定位
 npm run diagnose               # 换机器后先跑它：进程 / git / 文件系统 / hooks 各占多少
 npm run sweep                  # 给本机找最佳文件级并发（扫 integration 套件）
-npm test                       # 只跑基础 CLI 与配置矩阵（93 项）
+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 隔离运行环境
@@ -276,47 +297,47 @@ npm run test:stylelint17       # Stylelint 17 生态兼容性回归（8 项）
 ```text
   my-code-style 测试套件
 
-  ▶ [1/4] 基础 CLI 与配置矩阵  （共 93 项，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
       …
-     ✓ 通过 93  ·  4.9s   · 最慢文件 init-matrix.test.cjs 4.6s
+     ✓ 通过 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  ·  50.7s   · 最慢文件 commit-chain-both.test.cjs 16.1s
+     ✓ 通过 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  ·  19.4s
+     ✓ 通过 27  ·  20.2s
 
   ▶ [4/4] Stylelint 17 兼容性  （共 9 项，1 文件 · 3 文件并发（自动：2 核 / 内存 4G））
       ✓ 隔离环境装的是 stylelint 17（不是 16） · 2ms
       ✓ 生成的 .stylelintrc.cjs 在 stylelint 17 下可加载并放过正常 SCSS · 700ms
       …
-     ✓ 通过 9  ·  9.6s
+     ✓ 通过 9  ·  8.8s
 
   ──────────────────────────────────────────────────────
   套件                      通过    失败    跳过    用时
   ──────────────────────────────────────────────────────
-  基础 CLI 与配置矩阵         93       0       -    4.9s
-  现代工具链与提交链          65       0       -   50.7s
-  ESLint 8 兼容性             27       0       -   19.4s
-  Stylelint 17 兼容性          9       0       -    9.6s
+  基础 CLI 与配置矩阵         98       0       -    4.2s
+  现代工具链与提交链          66       0       -   43.8s
+  ESLint 8 兼容性             27       0       -   20.2s
+  Stylelint 17 兼容性          9       0       -    8.8s
   ──────────────────────────────────────────────────────
-  合计                       194       0       -   84.6s
+  合计                       200       0       -   77.1s
   ──────────────────────────────────────────────────────
 
   ⏱ 最慢文件：eslint8.test.cjs 18.0s · commit-chain-less.test.cjs 11.4s · commit-chain-both.test.cjs 11.3s
 
-  ✅ 全部通过：194/194 项，用时 84.6s
+  ✅ 全部通过：200/200 项，用时 77.1s
 ```
 
 终端里每个套件下方还有一条实时进度条（`██████░░░░ 38/66  失败 0  4.0s`）。附加参数：
@@ -394,7 +415,7 @@ npm run test:all -- --profile     # 看每个测试文件耗时，定位瓶颈
 | `npm run test:integration`（运行器调度，自动并发 3）                        | 30.6s（只看集成套件那一段）                 |
 | 串行套件 + 文件级并发 23（全部一波）                                        | ✗ 3.8G 内存沙箱被 OOM 压垮（19 项 SIGKILL） |
 
-同机复测（194 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：默认自动并发 3 = 84.6s、`npm run test:integration` = 50.7s（本轮实跑；串行与 parallel 口径为早前基线实测，相对关系稳定）。
+同机复测（200 项，同一台 2 核沙箱连续跑；绝对秒数随机器负载波动，相对关系稳定）：默认自动并发 3 = 77.1s、`npm run test:integration` = 43.8s（本轮实跑；串行与 parallel 口径为早前基线实测，相对关系稳定）。
 
 （2 核沙箱里并行收益被 CPU 争抢吃掉大半，`--concurrency=1` 时单个文件只要 0.7–4.2s；
 16 核机器上集成套件那段 ≈ 最慢子文件，即"一次真实提交"的量级。）

package/bin/doctor

@@ -55,15 +55,36 @@ function readManifest() {
     }
 }
 
-// 读取依赖包版本：优先裸包名/package.json（可能被 exports 挡，如 less），
-// 回退到 resolve(裸包名) 后读相邻 package.json
+// 从 startDir 逐级向上直读 node_modules/<name>/package.json（纯文件系统，不经过
+// 模块解析）。必须走这条路：ESM-only 包（如 stylelint-config-recommended@18，
+// 下游 1.9.0 实测 BUG-035）的 exports 常常只有 "import" 条件且不暴露
+// "./package.json"，CJS require/resolve 双双抛 ERR_PACKAGE_PATH_NOT_EXPORTED，
+// 曾被误判为"未安装"。读文件天然兼容 ESM-only / exports 任意形态 / pnpm 符号链接。
+function findPkgUp(startDir, name) {
+    let cur = startDir
+    while (true) {
+        try {
+            return JSON.parse(
+                fs.readFileSync(path.join(cur, "node_modules", name, "package.json"), "utf8"),
+            )
+        } catch {}
+        const parent = path.dirname(cur)
+        if (parent === cur) return null
+        cur = parent
+    }
+}
+
+// 读取依赖包版本：文件系统链优先， exotic 布局回退模块解析
 function installedVersion(projectRequire, name) {
+    // ① 项目根向上（标准安装）；② 本脚本位置向上（npx 临时目录 / monorepo hoisting /
+    //    pnpm 内部 .pnpm 的真实包经符号链接可达）
+    const direct = findPkgUp(PROJECT_ROOT, name) ?? findPkgUp(__dirname, name)
+    if (direct?.version) return direct.version
     try {
         return require(`${name}/package.json`).version
     } catch {}
     try {
         const entry = projectRequire.resolve(name)
-        // 截掉入口文件取包目录（用 path.dirname；别用正则截第一个分隔符——会得到空串）
         const dir = path.dirname(entry)
         return JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf8")).version
     } catch {

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,22 @@ function eslintFlatConfigContent(projectType) {
         varName = "vue3Config"
     }
 
+    const compatBlock = compatExplicitTsImports
+        ? `,
+// 兼容存量代码：检测到项目存在显式 .ts/.tsx 扩展名 import（Vite 等 bundler
+// resolution 下合法）。降级为 warn：带与不带扩展名都可写、不再报错阻断，
+// 两种写法的"风格不一致"仍会以警告提示，团队可渐进统一；想恢复严格检查
+// （error + 只允许省略）删除此段即可。
+{
+    files: ["**/*.{ts,tsx,mts,cts}"],
+    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 +896,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 +909,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")
@@ -926,10 +991,13 @@ function main() {
     stepHeader(3, 6, "配置文件与 Git hooks")
     let overwriteTotal = 0
     let createTotal = 0
+    // --merge 下"已存在"的语义是保留而非覆盖，统计与文案必须一致，
+    // 否则预览先吓唬人、写入段再改口"保留"，前后矛盾（下游 1.9.0 实测）
+    const verb = mergeMode ? "保留" : "覆盖"
     for (const f of files) {
         if (f.exists) {
             overwriteTotal++
-            console.log(`      覆盖 ${f.path}`)
+            console.log(`      ${verb} ${f.path}`)
         } else {
             createTotal++
             console.log(`      新建 ${f.path}`)
@@ -951,7 +1019,7 @@ function main() {
     for (const h of hooks) {
         if (fileExists(h.path)) {
             overwriteTotal++
-            console.log(`      覆盖 ${h.path}`)
+            console.log(`      ${verb} ${h.path}`)
         } else {
             createTotal++
             console.log(`      新建 ${h.path}`)
@@ -959,7 +1027,7 @@ function main() {
     }
 
     console.log(
-        `      小计：覆盖 ${overwriteTotal} 个 · 新建 ${createTotal} 个` +
+        `      小计：${verb} ${overwriteTotal} 个 · 新建 ${createTotal} 个` +
             (backup ? " · 旧文件将备份到 .my-code-style-backup/" : "") +
             (dryRun ? "（Dry run 预览，不写入）" : ""),
     )
@@ -981,11 +1049,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 预处理器生成")
     }
 
@@ -1017,7 +1087,7 @@ function main() {
             success("Dry run 结束：未写入任何文件；去掉 --dry-run 执行真实初始化")
         } else {
             success(
-                `初始化完成：覆盖 ${overwriteTotal} 个 · 新建 ${createTotal} 个 · package.json 已更新`,
+                `初始化完成：${verb} ${overwriteTotal} 个 · 新建 ${createTotal} 个 · package.json 已更新`,
             )
         }
         console.log("")
@@ -1125,7 +1195,6 @@ function main() {
         // Actually write files
         for (const f of files) {
             if (mergeMode && snapshot.get(f.path)?.existed) {
-                console.log(`      · 保留 ${f.path}（--merge 不覆盖）`)
                 continue
             }
             writeFile(f.path, f.content)
@@ -1137,7 +1206,6 @@ function main() {
         }
         for (const h of hooks) {
             if (mergeMode && snapshot.get(h.path)?.existed) {
-                console.log(`      · 保留 ${h.path}（--merge 不覆盖）`)
                 continue
             }
             writeFile(h.path, h.content)
@@ -1150,6 +1218,15 @@ function main() {
                 scripts: {
                     lint: lintCommand,
                     "lint:fix": `${lintCommand} --fix`,
+                    // CI 只跑 pnpm lint 时会漏检 CSS（下游 1.9.0 反馈）：给有
+                    // 预处理器的项目一个全量 stylelint 入口；ignoreFiles 已在
+                    // 配置里排除 node_modules/dist 等，glob 全仓是安全的
+                    ...(skipStylelint
+                        ? {}
+                        : {
+                              "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.0",
+  "version": "1.9.2",
   "description": "Lint/Format/Git 配置工程化 npm 包（ESLint + Prettier + Stylelint + Commitlint + Husky + standard-version）",
   "type": "commonjs",
   "main": "src/eslint/uniapp.cjs",