my-code-style 1.2.0 → 1.5.0

package/bin/init

@@ -12,7 +12,6 @@
 
 const fs = require("fs")
 const path = require("path")
-const { execSync } = require("child_process")
 
 const PROJECT_ROOT = process.cwd()
 const PACKAGE_DIR = path.resolve(__dirname, "..")
@@ -51,6 +50,24 @@ function readTemplate(relativePath) {
     return fs.readFileSync(path.resolve(PACKAGE_DIR, relativePath), "utf8")
 }
 
+/**
+ * Append an entry to the project .gitignore (idempotent, keeps existing lines).
+ */
+function ensureGitignoreEntry(entry) {
+    const gitignorePath = path.resolve(PROJECT_ROOT, ".gitignore")
+    if (!fs.existsSync(gitignorePath)) return
+    const content = fs.readFileSync(gitignorePath, "utf8")
+    const hasEntry = content.split("\n").some((line) => line.trim() === entry)
+    if (hasEntry) return
+    const separator = content.length === 0 || content.endsWith("\n") ? "" : "\n"
+    fs.writeFileSync(
+        gitignorePath,
+        `${content}${separator}\n# my-code-style 初始化备份目录\n${entry}\n`,
+        "utf8",
+    )
+    log(`已将 ${entry} 追加到 .gitignore`)
+}
+
 function getProjectPkg() {
     const pkgPath = path.resolve(PROJECT_ROOT, "package.json")
     if (!fs.existsSync(pkgPath)) return null
@@ -62,76 +79,381 @@ function getProjectPkg() {
 }
 
 function getDependencyVersion(pkg, depName) {
-    return (pkg.dependencies && pkg.dependencies[depName])
-        || (pkg.devDependencies && pkg.devDependencies[depName])
-        || null
+    return (
+        (pkg.dependencies && pkg.dependencies[depName]) ||
+        (pkg.devDependencies && pkg.devDependencies[depName]) ||
+        (pkg.peerDependencies && pkg.peerDependencies[depName]) ||
+        null
+    )
 }
 
 // --- Detection helpers ---
 
 /**
- * Detect ESLint major version from package.json
- * Returns 8, 9, or null (not installed)
+ * Detect if project is configured as ECMAScript Module (ESM)
  */
-function detectEslintVersion() {
-    const pkg = getProjectPkg()
+function isEsmProject(pkg = getProjectPkg()) {
+    return pkg?.type === "module"
+}
+
+// --- Semver range helpers (dependency-free) ---
+// Detection only needs to know which major versions a declared range can
+// install. Regex guessing on the raw string misreads "<9.0.0" (8 only) and
+// ">=8.0.0" (8 or 9), so ranges are parsed into half-open [lower, upper)
+// intervals with the subset of npm range syntax that appears in practice.
+
+const MAX_VERSION = [Number.POSITIVE_INFINITY, 0, 0]
+
+function compareVersion(a, b) {
+    for (let i = 0; i < 3; i += 1) {
+        if (a[i] !== b[i]) return a[i] < b[i] ? -1 : 1
+    }
+    return 0
+}
+
+function isWildcardField(field) {
+    return field === undefined || field === "" || /^[xX*]$/.test(field)
+}
+
+function parseVersionFields(text) {
+    const [release] = String(text).trim().replace(/^v/, "").split("-")
+    const fields = release.split(".")
+    if (fields.length > 3) return null
+    const parts = [0, 1, 2].map((index) => {
+        const field = fields[index]
+        if (isWildcardField(field)) return null
+        return /^\d+$/.test(field) ? parseInt(field, 10) : NaN
+    })
+    return parts.some((part) => Number.isNaN(part)) ? null : parts
+}
+
+function lowerBound(parts) {
+    return [parts[0] || 0, parts[1] || 0, parts[2] || 0]
+}
+
+function partialInterval(parts) {
+    const lower = lowerBound(parts)
+    const missing = parts.findIndex((part) => part === null)
+    if (missing === -1) return [lower, [lower[0], lower[1], lower[2] + 1]]
+    if (missing === 0) return [[0, 0, 0], MAX_VERSION]
+    const upper = [0, 0, 0]
+    for (let i = 0; i < missing; i += 1) upper[i] = parts[i]
+    upper[missing - 1] += 1
+    return [lower, upper]
+}
+
+function caretInterval(parts) {
+    const lower = lowerBound(parts)
+    if (parts[0] === null) return [[0, 0, 0], MAX_VERSION]
+    if (parts[0] > 0 || parts[1] === null) return [lower, [parts[0] + 1, 0, 0]]
+    if (parts[1] > 0 || parts[2] === null) return [lower, [0, parts[1] + 1, 0]]
+    return [lower, [0, 0, parts[2] + 1]]
+}
+
+function tildeInterval(parts) {
+    const lower = lowerBound(parts)
+    if (parts[0] === null) return [[0, 0, 0], MAX_VERSION]
+    if (parts[1] === null) return [lower, [parts[0] + 1, 0, 0]]
+    return [lower, [parts[0], parts[1] + 1, 0]]
+}
+
+function tokenInterval(token) {
+    const match = /^(>=|<=|>|<|\^|~|=)?\s*(.*)$/.exec(token.trim())
+    if (!match || !match[2]) return null
+    const [, operator = "", text] = match
+    if (/^[xX*]$/.test(text.trim())) return [[0, 0, 0], MAX_VERSION]
+    const parts = parseVersionFields(text)
+    if (!parts) return null
+    const lower = lowerBound(parts)
+    switch (operator) {
+        case ">=":
+            return [lower, MAX_VERSION]
+        case ">":
+            return [[lower[0], lower[1], lower[2] + 1], MAX_VERSION]
+        case "<":
+            return [[0, 0, 0], lower]
+        case "<=":
+            return [
+                [0, 0, 0],
+                [lower[0], lower[1], lower[2] + 1],
+            ]
+        case "^":
+            return caretInterval(parts)
+        case "~":
+            return tildeInterval(parts)
+        default:
+            return partialInterval(parts)
+    }
+}
+
+function rangeIntervals(range) {
+    const intervals = []
+    for (const clause of range.split("||")) {
+        const text = clause.trim()
+        if (!text) continue
+        const hyphen = text.split(/\s+-\s+/)
+        const tokens =
+            hyphen.length === 2 ? [`>=${hyphen[0]}`, `<=${hyphen[1]}`] : text.split(/\s+/)
+        let lower = [0, 0, 0]
+        let upper = MAX_VERSION
+        let valid = true
+        for (const token of tokens) {
+            const interval = tokenInterval(token)
+            if (!interval) {
+                valid = false
+                break
+            }
+            if (compareVersion(interval[0], lower) > 0) lower = interval[0]
+            if (compareVersion(interval[1], upper) < 0) upper = interval[1]
+        }
+        if (valid && compareVersion(lower, upper) < 0) intervals.push([lower, upper])
+    }
+    return intervals
+}
+
+/**
+ * List every major version a declared range can install (0-12), or null when
+ * the range cannot be parsed.
+ */
+function majorsForRange(range) {
+    const intervals = rangeIntervals(range)
+    if (!intervals.length) return null
+    const majors = []
+    for (let major = 0; major <= 12; major += 1) {
+        const lower = [major, 0, 0]
+        const upper = [major + 1, 0, 0]
+        const intersects = intervals.some(
+            ([intervalLower, intervalUpper]) =>
+                compareVersion(intervalLower, upper) < 0 &&
+                compareVersion(intervalUpper, lower) > 0,
+        )
+        if (intersects) majors.push(major)
+    }
+    return majors.length ? majors : null
+}
+
+/**
+ * Detect ESLint major version from package.json or installed node_modules
+ * Returns 8, 9, or null (not installed or ambiguous)
+ */
+function detectEslintVersion(pkg = getProjectPkg(), rootDir = PROJECT_ROOT) {
     if (!pkg) return null
-    const version = getDependencyVersion(pkg, "eslint")
-    if (!version) return null
-    // Handle range specifiers like "^9.0.0", ">=8.0.0", "9.x"
-    const match = version.match(/(\d+)/)
-    return match ? parseInt(match[1], 10) : null
+
+    // 1. If eslint is installed in node_modules, read its actual major version directly
+    try {
+        const installedPkgPath = path.resolve(rootDir, "node_modules", "eslint", "package.json")
+        if (fs.existsSync(installedPkgPath)) {
+            const installedPkg = JSON.parse(fs.readFileSync(installedPkgPath, "utf8"))
+            const installedMajor = parseInt(installedPkg.version?.split(".")[0], 10)
+            if (!Number.isNaN(installedMajor)) {
+                return installedMajor
+            }
+        }
+    } catch {
+        // Fall through to package.json dependency declaration
+    }
+
+    // 2. Parse package.json dependency declaration
+    let version = getDependencyVersion(pkg, "eslint")
+    if (!version || typeof version !== "string") return null
+
+    version = version.trim()
+
+    // Handle npm alias: e.g. "npm:eslint@^8.57.0"
+    if (version.startsWith("npm:")) {
+        const atIdx = version.lastIndexOf("@")
+        if (atIdx > 3) {
+            version = version.slice(atIdx + 1).trim()
+        }
+    }
+
+    // Handle workspace protocol: e.g. "workspace:^8.0.0", "workspace:*"
+    if (version.startsWith("workspace:")) {
+        version = version.slice("workspace:".length).trim()
+        if (version === "*" || version === "^" || version === "~") {
+            return null
+        }
+    }
+
+    // Unspecified or dynamic ranges
+    if (
+        version === "*" ||
+        version === "" ||
+        version.startsWith("catalog:") ||
+        version.startsWith("file:") ||
+        version.startsWith("link:")
+    ) {
+        return null
+    }
+
+    // npm tag: latest
+    if (version === "latest") {
+        return 9
+    }
+
+    const majors = majorsForRange(version)
+    if (!majors) {
+        // Fallback: check leading digit if available
+        const match = version.match(/(\d+)/)
+        return match ? parseInt(match[1], 10) : null
+    }
+
+    // Ranges such as ">=8.0.0" or "^8.57.0 || ^9.0.0" can install either
+    // major; without a local install npm resolves the newest one (9).
+    if (majors.includes(8) && majors.includes(9)) {
+        log("ESLint 依赖同时支持 8 与 9 且未安装本地副本，默认采用 ESLint 9 Flat Config")
+        return 9
+    }
+    if (majors.includes(9)) return 9
+    if (majors.includes(8)) return 8
+    return majors[0]
+}
+
+/**
+ * Detect if project is a uni-app project
+ */
+function isUniAppProject() {
+    const pkg = getProjectPkg()
+    if (!pkg) return false
+    const allDeps = {
+        ...(pkg.dependencies || {}),
+        ...(pkg.devDependencies || {}),
+        ...(pkg.peerDependencies || {}),
+    }
+    return !!(allDeps["@dcloudio/uni-app"] || allDeps["uni-app"])
+}
+
+/**
+ * Detect if project is a Vue project
+ */
+function isVueProject() {
+    const pkg = getProjectPkg()
+    if (!pkg) return false
+    const allDeps = {
+        ...(pkg.dependencies || {}),
+        ...(pkg.devDependencies || {}),
+        ...(pkg.peerDependencies || {}),
+    }
+    return !!(allDeps["vue"] || allDeps["@dcloudio/uni-app"] || allDeps["uni-app"])
+}
+
+/**
+ * Detect the package manager in use ("pnpm" | "npm" | "yarn" | "bun" | null).
+ * The lockfile is the project's own truth, so it wins over the user agent of
+ * whatever launched this CLI (e.g. `npx` inside a pnpm project).
+ */
+function detectPackageManager() {
+    if (fileExists("pnpm-lock.yaml")) return "pnpm"
+    if (fileExists("yarn.lock")) return "yarn"
+    if (fileExists("bun.lockb") || fileExists("bun.lock")) return "bun"
+    if (fileExists("package-lock.json")) return "npm"
+
+    const agent = process.env.npm_config_user_agent || ""
+    if (agent.startsWith("pnpm/")) return "pnpm"
+    if (agent.startsWith("yarn/")) return "yarn"
+    if (agent.startsWith("bun/")) return "bun"
+    if (agent.startsWith("npm/")) return "npm"
+    return null
+}
+
+function addDevCommand(packageManager) {
+    switch (packageManager) {
+        case "npm":
+            return "npm i -D"
+        case "yarn":
+            return "yarn add -D"
+        case "bun":
+            return "bun add -d"
+        default:
+            return "pnpm add -D"
+    }
+}
+
+/**
+ * `pnpm prepare` / `yarn prepare` run the script directly, but npm needs an
+ * explicit `npm run prepare` (plain `npm prepare` is not a command).
+ */
+function runScriptCommand(packageManager, script) {
+    switch (packageManager) {
+        case "npm":
+        case "bun":
+            return `${packageManager} run ${script}`
+        default:
+            return `${packageManager} ${script}`
+    }
+}
+
+/**
+ * Detect project type: "uniapp", "vue", or "base"
+ */
+function detectProjectType() {
+    if (isUniAppProject()) return "uniapp"
+    if (isVueProject()) return "vue"
+    return "base"
 }
 
 /**
  * Detect CSS preprocessor in use
- * Returns "scss", "less", or "none"
+ * Returns "scss", "less", "both", or "none"
  */
 function detectCssPreprocessor() {
     const pkg = getProjectPkg()
     if (!pkg) return "scss"
-    const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) }
+    const allDeps = {
+        ...(pkg.dependencies || {}),
+        ...(pkg.devDependencies || {}),
+        ...(pkg.peerDependencies || {}),
+    }
 
     const hasSass = allDeps["sass"] || allDeps["node-sass"] || allDeps["sass-loader"]
     const hasLess = allDeps["less"] || allDeps["less-loader"]
 
+    if (hasSass && hasLess) return "both"
     if (hasLess && !hasSass) return "less"
     if (hasSass) return "scss"
-    if (hasLess) return "less"
 
     // Fallback: check for existing stylelint config
     if (fileExists(".stylelintrc.cjs") || fileExists(".stylelintrc.js")) {
+        const stylelintFile = fileExists(".stylelintrc.cjs")
+            ? ".stylelintrc.cjs"
+            : ".stylelintrc.js"
+        let content = ""
         try {
-            const stylelintFile = fileExists(".stylelintrc.cjs")
-                ? ".stylelintrc.cjs"
-                : ".stylelintrc.js"
-            const content = fs.readFileSync(
-                path.resolve(PROJECT_ROOT, stylelintFile),
-                "utf8"
-            )
-            if (content.includes("postcss-less")) return "less"
+            content = fs.readFileSync(path.resolve(PROJECT_ROOT, stylelintFile), "utf8")
         } catch {}
+        // "my-code-style/stylelint" is a prefix of "my-code-style/stylelint/less",
+        // so the Less entry must be matched before the SCSS one.
+        const usesLess =
+            /my-code-style\/stylelint\/less(?:-override)?/.test(content) ||
+            content.includes("postcss-less") ||
+            content.includes("stylelint-config-recommended-less")
+        const usesScss =
+            /my-code-style\/stylelint(?![-\w/])/.test(content) ||
+            content.includes("postcss-scss") ||
+            content.includes("stylelint-config-recommended-scss")
+        if (usesLess && usesScss) return "both"
+        if (usesLess) return "less"
+        if (usesScss) return "scss"
+        return "scss"
     }
 
-    return "scss" // default
-}
+    // If not a Vue/uni-app project and no css preprocessor found, skip stylelint
+    if (!isVueProject()) {
+        return "none"
+    }
 
-/**
- * Detect if project is a uni-app project
- */
-function isUniAppProject() {
-    const pkg = getProjectPkg()
-    if (!pkg) return false
-    const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) }
-    return !!(allDeps["@dcloudio/uni-app"] || allDeps["uni-app"])
+    return "scss" // default for Vue/uni-app projects
 }
 
 // --- Config templates ---
 
-function eslintrcContent(isUniApp) {
-    const importPath = isUniApp
-        ? "my-code-style/eslint/uniapp"
-        : "my-code-style/eslint/vue3"
+function eslintrcContent(projectType) {
+    let importPath = "my-code-style/eslint"
+    if (projectType === "uniapp") {
+        importPath = "my-code-style/eslint/uniapp"
+    } else if (projectType === "vue") {
+        importPath = "my-code-style/eslint/vue3"
+    }
 
     return `// ESLint config — powered by my-code-style
 // https://www.npmjs.com/package/my-code-style
@@ -144,19 +466,22 @@ module.exports = config
 `
 }
 
-function eslintFlatConfigContent(isUniApp) {
-    const importPath = isUniApp
-        ? "my-code-style/eslint/flat/uniapp"
-        : "my-code-style/eslint/flat/vue3"
-    const varName = isUniApp ? "uniappConfig" : "vue3Config"
+function eslintFlatConfigContent(projectType) {
+    let importPath = "my-code-style/eslint/flat"
+    let varName = "baseConfig"
+    if (projectType === "uniapp") {
+        importPath = "my-code-style/eslint/flat/uniapp"
+        varName = "uniappConfig"
+    } else if (projectType === "vue") {
+        importPath = "my-code-style/eslint/flat/vue3"
+        varName = "vue3Config"
+    }
 
     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}]
 `
 }
 
@@ -171,9 +496,8 @@ function prettierignoreContent() {
 }
 
 function stylelintrcContent(cssPreprocessor) {
-    const importPath = cssPreprocessor === "less"
-        ? "my-code-style/stylelint/less"
-        : "my-code-style/stylelint"
+    const importPath =
+        cssPreprocessor === "less" ? "my-code-style/stylelint/less" : "my-code-style/stylelint"
 
     return `// Stylelint config — powered by my-code-style
 module.exports = require("${importPath}")
@@ -181,6 +505,11 @@ module.exports = require("${importPath}")
 }
 
 function commitlintrcContent() {
+    const mockScope = ["mock", "mocks", "src/mock", "src/mocks"].some((dir) =>
+        fs.existsSync(path.resolve(PROJECT_ROOT, dir)),
+    )
+        ? `, "mock"`
+        : ""
     return `// Commitlint config — powered by my-code-style
 const base = require("my-code-style/commitlint")
 const { generateScopes, guessCurrentScope } = require("my-code-style/commitlint/scopes")
@@ -194,7 +523,7 @@ module.exports = {
         ...base.prompt,
         customScopesAlign: !scopeComplete ? "top" : "bottom",
         defaultScope: scopeComplete,
-        scopes: [...scopes, "mock"],
+        scopes: [...scopes${mockScope}],
         allowEmptyIssuePrefixs: false,
         allowCustomIssuePrefixs: false,
     },
@@ -208,20 +537,14 @@ module.exports = require("my-code-style/versionrc")
 `
 }
 
+// Hook bodies live in src/husky/* so the shipped templates cannot drift from
+// what the CLI writes. Normalise the trailing newline.
 function huskyCommitMsg() {
-    return `#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-npx --no-install commitlint --edit
-`
+    return readTemplate("src/husky/commit-msg").replace(/\s*$/, "\n")
 }
 
 function huskyPreCommit() {
-    return `#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-npx --no-install -- lint-staged
-`
+    return readTemplate("src/husky/pre-commit").replace(/\s*$/, "\n")
 }
 
 function editorconfigContent() {
@@ -232,26 +555,59 @@ function gitattributesContent() {
     return readTemplate("src/gitattributes")
 }
 
+function gitignoreContent() {
+    return readTemplate("src/gitignore")
+}
+
 /**
  * Generate the lint-staged config based on detected CSS preprocessor
  */
 function getLintStagedConfig(cssPreprocessor) {
-    const styleFiles = cssPreprocessor === "less"
-        ? "**/*.{vue,css,less,html}"
-        : cssPreprocessor === "none"
-            ? "**/*.{vue,html}"
-            : "**/*.{vue,css,scss,html}"
-
-    return {
-        "**/*.{html,vue,ts,cjs,json,md}": ["prettier --write"],
-        "**/*.{vue,js,ts,jsx,tsx}": ["eslint --cache --fix"],
-        [styleFiles]: ["stylelint --fix"],
+    // Disjoint groups: a file is owned by exactly one task array.
+    // lint-staged runs each array in order, while unrelated groups may run concurrently.
+    const componentTasks = ["prettier --write", "eslint --fix"]
+    const styleTasks = ["prettier --write"]
+    if (cssPreprocessor !== "none") {
+        componentTasks.push("stylelint --fix")
+        styleTasks.push("stylelint --fix")
     }
+    const styleFiles =
+        cssPreprocessor === "both"
+            ? "**/*.{html,css,scss,less}"
+            : cssPreprocessor === "less"
+              ? "**/*.{html,css,less}"
+              : cssPreprocessor === "scss"
+                ? "**/*.{html,css,scss}"
+                : "**/*.{html,css}"
+    const config = {
+        "**/*.{vue,nvue}": componentTasks,
+        "**/*.{js,ts,jsx,tsx,cjs,mjs,mts,cts}": ["prettier --write", "eslint --fix"],
+        [styleFiles]: styleTasks,
+        "**/*.{json,json5,md,yml,yaml}": ["prettier --write"],
+    }
+
+    return config
 }
 
 // --- Main ---
 
 function main() {
+    const args = process.argv.slice(2)
+    const supported = new Set(["--dry-run", "--backup", "--version", "-v", "--help", "-h"])
+    const unknown = args.filter((arg) => !supported.has(arg))
+    if (unknown.length) {
+        console.error(`未知参数: ${unknown.join(", ")}；使用 --help 查看帮助`)
+        process.exitCode = 1
+        return
+    }
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log("Usage: my-code-style-init [--dry-run] [--backup] [--version|-v] [--help|-h]")
+        console.log("  --backup   覆盖已有配置前将其备份到 .my-code-style-backup/ 目录")
+        console.log("  --dry-run  试运行，仅输出将执行的变更，不写入任何文件")
+        console.log("初始化会覆盖部分配置和 hooks；请先备份并运行 --dry-run。")
+        return
+    }
+
     // Handle --version / -v
     if (process.argv.includes("--version") || process.argv.includes("-v")) {
         const pkg = require("../package.json")
@@ -259,6 +615,34 @@ function main() {
         return
     }
 
+    // Validate before detection or any filesystem writes. Missing package.json
+    // remains supported, but malformed manifests must never be treated as empty.
+    if (fileExists("package.json")) {
+        try {
+            const pkg = JSON.parse(
+                fs.readFileSync(path.resolve(PROJECT_ROOT, "package.json"), "utf8"),
+            )
+            if (!pkg || typeof pkg !== "object" || Array.isArray(pkg)) {
+                throw new Error("package.json 必须是 JSON 对象")
+            }
+            for (const key of ["dependencies", "devDependencies", "peerDependencies", "scripts"]) {
+                if (pkg[key] === undefined) continue
+                if (
+                    !pkg[key] ||
+                    typeof pkg[key] !== "object" ||
+                    Array.isArray(pkg[key]) ||
+                    Object.values(pkg[key]).some((value) => typeof value !== "string")
+                ) {
+                    throw new Error(`${key} 必须是值为字符串的对象`)
+                }
+            }
+        } catch (error) {
+            console.error(`无法读取有效的 package.json：${error.message}；未修改任何文件`)
+            process.exitCode = 1
+            return
+        }
+    }
+
     const dryRun = process.argv.includes("--dry-run")
     const label = dryRun ? "[DRY RUN] " : ""
 
@@ -272,33 +656,88 @@ function main() {
     }
 
     // --- Detection phase ---
+    const pm = detectPackageManager() || "pnpm"
     const eslintVersion = detectEslintVersion()
     const cssPreprocessor = detectCssPreprocessor()
-    const uniApp = isUniAppProject()
+    const projectType = detectProjectType()
 
     // Determine ESLint format
-    const useFlatConfig = eslintVersion === 9
+    const hasLegacyConfigFile =
+        fileExists(".eslintrc.js") ||
+        fileExists(".eslintrc.cjs") ||
+        fileExists(".eslintrc.json") ||
+        fileExists(".eslintrc.yaml") ||
+        fileExists(".eslintrc.yml") ||
+        fileExists(".eslintrc")
+
+    const hasFlatConfigFile =
+        fileExists("eslint.config.mjs") ||
+        fileExists("eslint.config.js") ||
+        fileExists("eslint.config.ts") ||
+        fileExists("eslint.config.cjs")
+
+    if (eslintVersion !== null && eslintVersion < 8) {
+        console.error(
+            `不支持 ESLint ${eslintVersion} 版本；本配置包仅支持 ESLint 8 或 9，未修改任何文件`,
+        )
+        process.exitCode = 1
+        return
+    }
+
+    if (eslintVersion !== null && eslintVersion >= 10) {
+        warn(
+            `ESLint ${eslintVersion} 尚未在 peerDependencies 声明支持（^8.57.0 || ^9.0.0），将按 Flat Config 生成`,
+        )
+    }
+
+    // Do not silently mix an installed major version with an incompatible format.
+    if (
+        (eslintVersion >= 9 && hasLegacyConfigFile && !hasFlatConfigFile) ||
+        (eslintVersion === 8 && hasFlatConfigFile)
+    ) {
+        console.error("ESLint 版本与已有配置格式冲突；请先手动迁移或确认配置格式，未修改任何文件")
+        process.exitCode = 1
+        return
+    }
+    if (!eslintVersion && hasLegacyConfigFile && !hasFlatConfigFile) {
+        console.error(
+            "检测到传统 ESLint 配置但无法确定版本；请先声明 ESLint 版本或迁移到 Flat Config，未修改任何文件",
+        )
+        process.exitCode = 1
+        return
+    }
+    const useFlatConfig = eslintVersion !== 8
     const eslintFormat = useFlatConfig ? "flat" : "eslintrc"
 
-    log(`检测到 ESLint 版本: ${eslintVersion || "未知"} → 使用 ${eslintFormat} 格式`)
-    log(`检测到 CSS 预处理器: ${cssPreprocessor}`)
-    if (uniApp) log(`检测到 uni-app 项目`)
+    log(`检测到 ESLint 版本: ${eslintVersion || "默认最新 (9+)"} → 使用 ${eslintFormat} 格式`)
+    log(
+        `检测到项目类型: ${projectType === "uniapp" ? "uni-app" : projectType === "vue" ? "Vue" : "Node/TS 基础"}`,
+    )
+    log(
+        `检测到 CSS 预处理器: ${cssPreprocessor === "both" ? "SCSS + Less (混合)" : cssPreprocessor}`,
+    )
     console.log("")
 
     // --- Build file list based on detection ---
     const files = []
 
-    if (useFlatConfig) {
+    if (hasFlatConfigFile || hasLegacyConfigFile) {
+        log("保留已有 ESLint 配置，不生成额外入口")
+    } else if (useFlatConfig) {
         files.push({
             path: "eslint.config.mjs",
-            exists: fileExists("eslint.config.mjs") || fileExists("eslint.config.js") || fileExists("eslint.config.ts"),
-            content: eslintFlatConfigContent(uniApp),
+            exists:
+                fileExists("eslint.config.mjs") ||
+                fileExists("eslint.config.js") ||
+                fileExists("eslint.config.ts") ||
+                fileExists("eslint.config.cjs"),
+            content: eslintFlatConfigContent(projectType),
         })
     } else {
         files.push({
             path: ".eslintrc.cjs",
             exists: fileExists(".eslintrc.cjs"),
-            content: eslintrcContent(uniApp),
+            content: eslintrcContent(projectType),
         })
     }
 
@@ -331,9 +770,21 @@ function main() {
         content: commitlintrcContent(),
     })
 
+    const isEsm = isEsmProject()
+    let versionrcPath = ".versionrc.js"
+    if (fileExists(".versionrc.cjs") || isEsm) {
+        versionrcPath = ".versionrc.cjs"
+    }
+
+    if (isEsm && fileExists(".versionrc.js") && !fileExists(".versionrc.cjs")) {
+        warn(
+            "检测到 ESM 项目 (type: module) 存在旧的 .versionrc.js，standard-version 需使用 .versionrc.cjs",
+        )
+    }
+
     files.push({
-        path: ".versionrc.js",
-        exists: fileExists(".versionrc.js"),
+        path: versionrcPath,
+        exists: fileExists(versionrcPath),
         content: versionrcContent(),
     })
 
@@ -349,6 +800,14 @@ function main() {
         content: gitattributesContent(),
     })
 
+    if (!fileExists(".gitignore")) {
+        files.push({
+            path: ".gitignore",
+            exists: false,
+            content: gitignoreContent(),
+        })
+    }
+
     // Show what will be created/overwritten
     for (const f of files) {
         if (f.exists) {
@@ -385,52 +844,172 @@ function main() {
         return
     }
 
-    // Actually write files
-    for (const f of files) {
-        writeFile(f.path, f.content)
+    // Optional backup of existing files before modifying
+    const backup = args.includes("--backup")
+    if (backup) {
+        const backupDir = path.resolve(PROJECT_ROOT, ".my-code-style-backup")
+        ensureDir(backupDir)
+        // package.json is rewritten (scripts + lint-staged), so it must be backed
+        // up as well — users lose custom lint-staged groups otherwise.
+        for (const item of [...files, ...hooks, { path: "package.json" }]) {
+            if (fileExists(item.path)) {
+                const srcPath = path.resolve(PROJECT_ROOT, item.path)
+                const targetPath = path.resolve(backupDir, item.path)
+                ensureDir(path.dirname(targetPath))
+                fs.copyFileSync(srcPath, targetPath)
+                log(`已备份 ${item.path} -> .my-code-style-backup/${item.path}`)
+            }
+        }
     }
 
-    // Husky
-    if (!hasHusky) {
-        ensureDir(huskyDir)
+    // ESLint 8 directory traversal defaults to .js; explicitly include typed
+    // files and the selected component formats so `lint` cannot silently skip them.
+    const legacyExtensions =
+        ".js,.cjs,.mjs,.ts,.mts,.cts,.jsx,.tsx" +
+        (projectType !== "base" ? ",.vue" : "") +
+        (projectType === "uniapp" ? ",.nvue" : "")
+    const lintCommand = useFlatConfig ? "eslint ." : `eslint . --ext ${legacyExtensions}`
+
+    // Take snapshot of files and hooks before making any filesystem modifications
+    const snapshot = new Map()
+    for (const f of files) {
+        const abs = path.resolve(PROJECT_ROOT, f.path)
+        let existed = false
+        let isFile = false
+        let content = null
+        try {
+            if (fs.existsSync(abs)) {
+                existed = true
+                isFile = fs.statSync(abs).isFile()
+                if (isFile) content = fs.readFileSync(abs, "utf8")
+            }
+        } catch {}
+        snapshot.set(f.path, { existed, isFile, content })
     }
     for (const h of hooks) {
-        writeFile(h.path, h.content)
-        fs.chmodSync(path.resolve(PROJECT_ROOT, h.path), 0o755)
-    }
-
-    // package.json scripts + lint-staged
-    modifyPackageJson({
-        scripts: {
-            prepare: "husky",
-            release: "standard-version",
-            cz: "czg",
-        },
-        "lint-staged": getLintStagedConfig(cssPreprocessor),
-    })
-    success("更新 package.json (scripts + lint-staged)")
+        const abs = path.resolve(PROJECT_ROOT, h.path)
+        let existed = false
+        let isFile = false
+        let content = null
+        let mode = undefined
+        try {
+            if (fs.existsSync(abs)) {
+                existed = true
+                const stat = fs.statSync(abs)
+                isFile = stat.isFile()
+                mode = stat.mode
+                if (isFile) content = fs.readFileSync(abs, "utf8")
+            }
+        } catch {}
+        snapshot.set(h.path, { existed, isFile, content, mode })
+    }
+    const pkgPath = path.resolve(PROJECT_ROOT, "package.json")
+    const hadPkg = fs.existsSync(pkgPath)
+    let pkgContent = null
+    try {
+        if (hadPkg && fs.statSync(pkgPath).isFile()) {
+            pkgContent = fs.readFileSync(pkgPath, "utf8")
+        }
+    } catch {}
+    const hadHuskyDir = fs.existsSync(huskyDir)
+
+    try {
+        // Actually write files
+        for (const f of files) {
+            writeFile(f.path, f.content)
+        }
+
+        // Husky
+        if (!hasHusky) {
+            ensureDir(huskyDir)
+        }
+        for (const h of hooks) {
+            writeFile(h.path, h.content)
+            fs.chmodSync(path.resolve(PROJECT_ROOT, h.path), 0o755)
+        }
+
+        // package.json scripts + lint-staged
+        modifyPackageJson({
+            scripts: {
+                lint: lintCommand,
+                "lint:fix": `${lintCommand} --fix`,
+                format: "prettier --write .",
+                prepare: "husky",
+                release: "standard-version",
+                cz: "czg",
+            },
+            "lint-staged": getLintStagedConfig(cssPreprocessor),
+        })
+        success("更新 package.json (scripts + lint-staged)")
+
+        // The backup directory is ours, not the user's source — keep it out of git
+        if (backup) {
+            ensureGitignoreEntry(".my-code-style-backup/")
+        }
+    } catch (err) {
+        console.error(`\n  ✖ 初始化写入失败: ${err.message}；正在回滚...`)
+        for (const [relPath, info] of snapshot.entries()) {
+            const abs = path.resolve(PROJECT_ROOT, relPath)
+            try {
+                if (info.existed && info.isFile) {
+                    fs.writeFileSync(abs, info.content, "utf8")
+                    if (info.mode !== undefined) {
+                        fs.chmodSync(abs, info.mode)
+                    }
+                } else if (!info.existed && fs.existsSync(abs)) {
+                    fs.rmSync(abs, { force: true, recursive: true })
+                }
+            } catch (rollbackErr) {
+                console.error(`  回滚文件失败: ${relPath} (${rollbackErr.message})`)
+            }
+        }
+        if (hadPkg) {
+            fs.writeFileSync(pkgPath, pkgContent, "utf8")
+        } else if (fs.existsSync(pkgPath)) {
+            fs.rmSync(pkgPath, { force: true })
+        }
+        if (!hadHuskyDir && fs.existsSync(huskyDir)) {
+            try {
+                if (fs.readdirSync(huskyDir).length === 0) {
+                    fs.rmdirSync(huskyDir)
+                }
+            } catch {}
+        }
+        console.error("  ✓ 已成功回滚所有更改，工作区已恢复原始状态。\n")
+        process.exitCode = 1
+        return
+    }
 
     // Check for missing peerDependencies
-    checkPeerDeps({ useFlatConfig, cssPreprocessor })
+    checkPeerDeps({ useFlatConfig, cssPreprocessor, projectType })
 
     console.log("")
     success("配置初始化完成！")
     console.log("")
     console.log("  下一步：")
     console.log("  1. 确保已安装 peerDependencies：")
-    console.log("     pnpm add -D my-code-style")
+    console.log(`     ${addDevCommand(pm)} my-code-style`)
     if (useFlatConfig) {
         console.log("  2. Flat Config 需要的额外依赖：")
-        console.log("     pnpm add -D typescript-eslint globals eslint-plugin-import-x @eslint/js")
+        console.log(
+            `     ${addDevCommand(pm)} typescript-eslint globals eslint-plugin-import-x @eslint/js`,
+        )
         console.log("  3. 初始化 husky：")
-        console.log("     pnpm prepare")
+        console.log(`     ${runScriptCommand(pm, "prepare")}`)
         console.log("  4. 使用 czg 提交 commit：")
     } else {
         console.log("  2. 初始化 husky：")
-        console.log("     pnpm prepare")
+        console.log(`     ${runScriptCommand(pm, "prepare")}`)
         console.log("  3. 使用 czg 提交 commit：")
     }
-    console.log("     pnpm cz")
+    console.log(`     ${runScriptCommand(pm, "cz")}`)
+    if (pm === "pnpm") {
+        console.log("")
+        console.log("  提示：pnpm 10+ 默认拦截依赖的构建脚本，若安装时提示")
+        console.log(
+            "  ERR_PNPM_IGNORED_BUILDS（如 unrs-resolver），执行 pnpm approve-builds 后重试。",
+        )
+    }
     console.log("")
 }
 
@@ -441,25 +1020,61 @@ function modifyPackageJson(updates) {
         pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"))
     }
 
-    // Merge scripts
+    // A generated manifest must be installable on its own: npm requires
+    // name/version (e.g. running init in an empty directory).
+    if (typeof pkg.name !== "string" || !pkg.name.trim()) {
+        pkg.name =
+            path
+                .basename(PROJECT_ROOT)
+                .toLowerCase()
+                .replace(/[^a-z0-9._-]+/g, "-")
+                .replace(/^[._-]+|[._-]+$/g, "") || "my-project"
+    }
+    if (typeof pkg.version !== "string" || !pkg.version.trim()) {
+        pkg.version = "1.0.0"
+    }
+
+    // Merge scripts: updates won't overwrite existing scripts with the same key
     if (updates.scripts) {
-        pkg.scripts = { ...pkg.scripts, ...updates.scripts }
+        pkg.scripts = { ...updates.scripts, ...(pkg.scripts || {}) }
     }
 
-    // Merge lint-staged
+    // Set lint-staged (replace existing lint-staged to avoid stale/duplicate patterns)
     if (updates["lint-staged"]) {
-        pkg["lint-staged"] = { ...pkg["lint-staged"], ...updates["lint-staged"] }
+        pkg["lint-staged"] = updates["lint-staged"]
     }
 
-    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 4) + "\n", "utf8")
+    // Keep the project's own indentation (a 2-space repo should not be reflowed)
+    const previous = fileExists("package.json") ? fs.readFileSync(pkgPath, "utf8") : ""
+    const indentMatch = previous.match(/^[ \t]+(?=")/m)
+    fs.writeFileSync(
+        pkgPath,
+        JSON.stringify(pkg, null, indentMatch ? indentMatch[0] : 4) + "\n",
+        "utf8",
+    )
 }
 
-function checkPeerDeps({ useFlatConfig = false, cssPreprocessor = "scss" } = {}) {
+function checkPeerDeps({
+    useFlatConfig = false,
+    cssPreprocessor = "scss",
+    projectType = "base",
+} = {}) {
+    const pkg = getProjectPkg()
+    if (!pkg) return
+
+    // If running within the package itself, skip external missing deps check
+    if (pkg.name === "my-code-style") {
+        return
+    }
+
     const baseDeps = [
         "eslint",
+        // Required by @typescript-eslint/parser and typescript-eslint at runtime
+        "typescript",
         "prettier",
-        "eslint-plugin-vue",
+        ...(projectType !== "base" ? ["eslint-plugin-vue"] : []),
         "@commitlint/cli",
+        "@commitlint/config-conventional",
         "husky",
         "lint-staged",
         "czg",
@@ -467,25 +1082,73 @@ function checkPeerDeps({ useFlatConfig = false, cssPreprocessor = "scss" } = {})
     ]
 
     const flatDeps = useFlatConfig
-        ? ["typescript-eslint", "vue-eslint-parser", "globals", "eslint-plugin-import-x", "@eslint/js", "eslint-plugin-prettier", "eslint-config-prettier"]
-        : ["@typescript-eslint/parser", "@typescript-eslint/eslint-plugin", "eslint-plugin-prettier", "eslint-config-prettier"]
-
-    const cssDeps = cssPreprocessor === "scss"
-        ? ["stylelint", "postcss-scss", "postcss-html"]
-        : cssPreprocessor === "less"
-            ? ["stylelint", "postcss-less", "postcss-html"]
-            : []
+        ? [
+              "typescript-eslint",
+              "eslint-import-resolver-typescript",
+              ...(projectType !== "base" ? ["vue-eslint-parser"] : []),
+              "globals",
+              "eslint-plugin-import-x",
+              "@eslint/js",
+              "eslint-plugin-prettier",
+              "eslint-config-prettier",
+          ]
+        : [
+              "@typescript-eslint/parser",
+              "@typescript-eslint/eslint-plugin",
+              ...(projectType !== "base" ? ["vue-eslint-parser"] : []),
+              "eslint-plugin-import",
+              "eslint-import-resolver-typescript",
+              "eslint-plugin-prettier",
+              "eslint-config-prettier",
+          ]
+
+    const cssDeps =
+        cssPreprocessor === "both"
+            ? [
+                  "stylelint",
+                  "postcss-scss",
+                  "postcss-less",
+                  "postcss-html",
+                  "stylelint-config-recommended",
+                  "stylelint-config-recommended-scss",
+                  "stylelint-config-recommended-vue",
+                  "stylelint-config-html",
+                  "stylelint-config-recess-order",
+                  "stylelint-prettier",
+              ]
+            : cssPreprocessor === "scss"
+              ? [
+                    "stylelint",
+                    "postcss-scss",
+                    "postcss-html",
+                    "stylelint-config-recommended",
+                    "stylelint-config-recommended-scss",
+                    "stylelint-config-recommended-vue",
+                    "stylelint-config-html",
+                    "stylelint-config-recess-order",
+                    "stylelint-prettier",
+                ]
+              : cssPreprocessor === "less"
+                ? [
+                      "stylelint",
+                      "postcss-less",
+                      "postcss-html",
+                      "stylelint-config-recommended",
+                      "stylelint-config-recommended-vue",
+                      "stylelint-config-html",
+                      "stylelint-config-recess-order",
+                      "stylelint-prettier",
+                  ]
+                : []
 
     const allPeerDeps = [...baseDeps, ...flatDeps, ...cssDeps]
 
     // Read peer dependency versions from my-code-style package.json
-    const packagePkg = JSON.parse(fs.readFileSync(path.resolve(PACKAGE_DIR, "package.json"), "utf8"))
+    const packagePkg = JSON.parse(
+        fs.readFileSync(path.resolve(PACKAGE_DIR, "package.json"), "utf8"),
+    )
     const peerDeps = packagePkg.peerDependencies || {}
 
-    const pkgPath = path.resolve(PROJECT_ROOT, "package.json")
-    if (!fileExists("package.json")) return
-
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"))
     const allDeps = {
         ...(pkg.dependencies || {}),
         ...(pkg.devDependencies || {}),
@@ -497,9 +1160,10 @@ function checkPeerDeps({ useFlatConfig = false, cssPreprocessor = "scss" } = {})
         warn(`以下依赖未安装：${missing.join(", ")}`)
         console.log("")
         warn("一键安装命令：")
-        console.log(`  pnpm add -D my-code-style \\`)
+        console.log(`  ${addDevCommand(detectPackageManager())} my-code-style \\`)
         missing.forEach((dep, i) => {
-            const version = peerDeps[dep] || ""
+            const version =
+                dep === "eslint" ? (useFlatConfig ? "^9.0.0" : "^8.57.0") : peerDeps[dep] || ""
             const depWithVersion = version ? `${dep}@${version}` : dep
             const suffix = i < missing.length - 1 ? " \\" : ""
             console.log(`  ${depWithVersion}${suffix}`)
@@ -507,4 +1171,7 @@ function checkPeerDeps({ useFlatConfig = false, cssPreprocessor = "scss" } = {})
     }
 }
 
-main()
+// Only run when executed directly; requiring this file must be side-effect free.
+if (require.main === module) {
+    main()
+}