my-code-style 1.0.0

package/README.md

@@ -0,0 +1,119 @@
+# my-code-style
+
+Lint/Format/Git 配置工程化 npm 包。适用于 Vue 3 + TypeScript + uni-app 项目。
+
+支持 ESLint v8 (.eslintrc.cjs) 和 ESLint v9 (Flat Config) 双格式，支持 SCSS 和 Less 样式检查。
+
+## 快速开始
+
+```bash
+pnpm add -D my-code-style
+npx my-code-style-init
+```
+
+init 脚本会自动检测项目的 ESLint 版本和 CSS 预处理器，生成对应的配置文件。
+
+## 生成的文件
+
+| 文件 | 说明 |
+|------|------|
+| `.eslintrc.cjs` | ESLint 配置（v8 项目，TypeScript + Vue 3 + uni-app） |
+| `eslint.config.ts` | ESLint Flat Config（v9 项目，TypeScript + Vue 3 + uni-app） |
+| `.prettierrc.cjs` | Prettier 格式化配置 |
+| `.prettierignore` | Prettier 忽略文件（跳过二进制文件） |
+| `.stylelintrc.cjs` | Stylelint CSS/SCSS/Less 配置 |
+| `.commitlintrc.cjs` | Git commit 信息规范 |
+| `.versionrc.js` | 自动版本号 + CHANGELOG 生成 |
+| `.editorconfig` | 编辑器基础配置 |
+| `.gitattributes` | Git 文件类型处理（统一 EOL=LF，标记二进制文件） |
+| `.husky/commit-msg` | Git hook: commitlint |
+| `.husky/pre-commit` | Git hook: lint-staged |
+
+## 手动使用（不通过 init）
+
+### ESLint v8 (.eslintrc.cjs)
+
+```js
+// .eslintrc.cjs
+module.exports = require("my-code-style/eslint/uniapp")
+
+// 或按需引入中间层
+const base = require("my-code-style/eslint")        // 基础 TypeScript
+const vue3 = require("my-code-style/eslint/vue3")   // + Vue 3 规则
+```
+
+### ESLint v9 (Flat Config / eslint.config.ts)
+
+```ts
+// eslint.config.ts
+import uniappConfig from "my-code-style/eslint/flat/uniapp"
+
+// 或按需引入中间层
+import baseConfig from "my-code-style/eslint/flat/base"
+import vue3Config from "my-code-style/eslint/flat/vue3"
+```
+
+### 其他配置
+
+```js
+// .prettierrc.cjs
+module.exports = require("my-code-style/prettier")
+
+// .stylelintrc.cjs
+module.exports = require("my-code-style/stylelint")
+
+// .commitlintrc.cjs
+const base = require("my-code-style/commitlint")
+const { generateScopes, guessCurrentScope } = require("my-code-style/commitlint/scopes")
+module.exports = { ...base, prompt: { ...base.prompt, scopes: generateScopes("src") } }
+
+// .versionrc.js
+module.exports = require("my-code-style/versionrc")
+```
+
+## 配置覆盖
+
+```js
+// .eslintrc.cjs
+const base = require("my-code-style/eslint/uniapp")
+module.exports = {
+    ...base,
+    rules: {
+        ...base.rules,
+        "no-console": "warn",
+    },
+}
+```
+
+## 导出入口
+
+| 入口 | 说明 |
+|------|------|
+| `my-code-style` | 默认：ESLint v8 uni-app 配置 |
+| `my-code-style/eslint` | 基础 ESLint v8（TypeScript） |
+| `my-code-style/eslint/vue3` | + Vue 3 规则 |
+| `my-code-style/eslint/uniapp` | + uni-app globals |
+| `my-code-style/eslint/flat` | ESLint v9 Flat Config 基础 |
+| `my-code-style/eslint/flat/vue3` | + Vue 3 规则 |
+| `my-code-style/eslint/flat/uniapp` | + uni-app globals |
+| `my-code-style/prettier` | Prettier 配置 |
+| `my-code-style/stylelint` | Stylelint 配置（SCSS + Less） |
+| `my-code-style/stylelint/less-override` | Less 专用覆写配置 |
+| `my-code-style/commitlint` | Commitlint 基础配置 |
+| `my-code-style/commitlint/scopes` | 动态 scope 工具函数 |
+| `my-code-style/versionrc` | standard-version 配置 |
+
+## 特性
+
+- **双引号**：`quotes: ["error", "double", { avoidEscape: false, allowTemplateLiterals: true }]`
+- **4 空格缩进**：`tabWidth: 4`
+- **无分号**：`semi: false`（`.nvue` 文件除外）
+- **行宽 100**：`printWidth: 100`
+- **小程序适配**：允许 `rpx` 单位、`page` 标签、`::v-deep` 伪类
+- **uni-app globals**：`uni`、`UniApp`、`wx`、`getCurrentPages` 等
+- **Less 支持**：`postcss-less` 解析、`@` 变量放行、`::v-deep` 伪元素
+- **双 ESLint 格式**：v8 (.eslintrc.cjs) 和 v9 (Flat Config) 自动检测
+
+## License
+
+MIT

package/bin/init.cjs

@@ -0,0 +1,476 @@
+#!/usr/bin/env node
+/**
+ * my-code-style-init CLI
+ *
+ * Scaffolds lint/format/git config files into the current project.
+ * Auto-detects ESLint version and CSS preprocessor for optimal config generation.
+ *
+ * Usage:
+ *   npx my-code-style-init
+ *   npx my-code-style-init --dry-run
+ */
+
+const fs = require("fs")
+const path = require("path")
+const { execSync } = require("child_process")
+
+const PROJECT_ROOT = process.cwd()
+const PACKAGE_DIR = path.resolve(__dirname, "..")
+
+// --- Helpers ---
+
+function log(msg) {
+    console.log(`  ${msg}`)
+}
+
+function success(msg) {
+    console.log(`  ✓ ${msg}`)
+}
+
+function warn(msg) {
+    console.log(`  ⚠ ${msg}`)
+}
+
+function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true })
+    }
+}
+
+function writeFile(dest, content) {
+    const destDir = path.dirname(dest)
+    ensureDir(destDir)
+    fs.writeFileSync(dest, content, "utf8")
+}
+
+function fileExists(relative) {
+    return fs.existsSync(path.resolve(PROJECT_ROOT, relative))
+}
+
+function readTemplate(relativePath) {
+    return fs.readFileSync(path.resolve(PACKAGE_DIR, relativePath), "utf8")
+}
+
+function getProjectPkg() {
+    const pkgPath = path.resolve(PROJECT_ROOT, "package.json")
+    if (!fs.existsSync(pkgPath)) return null
+    return JSON.parse(fs.readFileSync(pkgPath, "utf8"))
+}
+
+function getDependencyVersion(pkg, depName) {
+    return (pkg.dependencies && pkg.dependencies[depName])
+        || (pkg.devDependencies && pkg.devDependencies[depName])
+        || null
+}
+
+// --- Detection helpers ---
+
+/**
+ * Detect ESLint major version from package.json
+ * Returns 8, 9, or null (not installed)
+ */
+function detectEslintVersion() {
+    const pkg = getProjectPkg()
+    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
+}
+
+/**
+ * Detect CSS preprocessor in use
+ * Returns "scss", "less", or "none"
+ */
+function detectCssPreprocessor() {
+    const pkg = getProjectPkg()
+    if (!pkg) return "scss"
+    const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) }
+
+    const hasSass = allDeps["sass"] || allDeps["node-sass"] || allDeps["sass-loader"]
+    const hasLess = allDeps["less"] || allDeps["less-loader"]
+
+    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")) {
+        try {
+            const content = fs.readFileSync(
+                path.resolve(PROJECT_ROOT, ".stylelintrc.cjs"),
+                "utf8"
+            )
+            if (content.includes("postcss-less")) return "less"
+        } catch {}
+    }
+
+    return "scss" // default
+}
+
+/**
+ * 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"])
+}
+
+// --- Config templates ---
+
+function eslintrcContent(isUniApp) {
+    const importPath = isUniApp
+        ? "my-code-style/eslint/uniapp"
+        : "my-code-style/eslint/vue3"
+
+    return `// ESLint config — powered by my-code-style
+// https://www.npmjs.com/package/my-code-style
+const config = require("${importPath}")
+
+// 如果需要引入 unplugin-auto-import 生成的 globals，取消下面的注释：
+// config.extends = [...config.extends, "./.eslintrc-auto-import.json"]
+
+module.exports = config
+`
+}
+
+function eslintFlatConfigContent(isUniApp) {
+    const importPath = isUniApp
+        ? "my-code-style/eslint/flat/uniapp"
+        : "my-code-style/eslint/flat/vue3"
+
+    return `// ESLint Flat Config — powered by my-code-style
+// https://www.npmjs.com/package/my-code-style
+import uniappConfig from "${importPath}"
+
+export default uniappConfig
+`
+}
+
+function prettierrcContent() {
+    return `// Prettier config — powered by my-code-style
+module.exports = require("my-code-style/prettier")
+`
+}
+
+function prettierignoreContent() {
+    return readTemplate("src/prettierignore")
+}
+
+function stylelintrcContent(cssPreprocessor) {
+    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}")
+`
+}
+
+function commitlintrcContent() {
+    return `// Commitlint config — powered by my-code-style
+const base = require("my-code-style/commitlint")
+const { generateScopes, guessCurrentScope } = require("my-code-style/commitlint/scopes")
+
+const scopes = generateScopes("src")
+const scopeComplete = guessCurrentScope()
+
+module.exports = {
+    ...base,
+    prompt: {
+        ...base.prompt,
+        customScopesAlign: !scopeComplete ? "top" : "bottom",
+        defaultScope: scopeComplete,
+        scopes: [...scopes, "mock"],
+        allowEmptyIssuePrefixs: false,
+        allowCustomIssuePrefixs: false,
+    },
+}
+`
+}
+
+function versionrcContent() {
+    return `// standard-version config — powered by my-code-style
+module.exports = require("my-code-style/versionrc")
+`
+}
+
+function huskyCommitMsg() {
+    return `#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no-install commitlint --edit
+`
+}
+
+function huskyPreCommit() {
+    return `#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no-install -- lint-staged
+`
+}
+
+function editorconfigContent() {
+    return readTemplate("src/editorconfig")
+}
+
+function gitattributesContent() {
+    return readTemplate("src/gitattributes")
+}
+
+/**
+ * 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"],
+    }
+}
+
+// --- Main ---
+
+function main() {
+    const dryRun = process.argv.includes("--dry-run")
+    const label = dryRun ? "[DRY RUN] " : ""
+
+    console.log("")
+    console.log("  my-code-style-init — 初始化项目配置")
+    console.log("")
+
+    if (dryRun) {
+        warn("Dry run mode — no files will be written")
+        console.log("")
+    }
+
+    // --- Detection phase ---
+    const eslintVersion = detectEslintVersion()
+    const cssPreprocessor = detectCssPreprocessor()
+    const uniApp = isUniAppProject()
+
+    // Determine ESLint format
+    const useFlatConfig = eslintVersion === 9
+    const eslintFormat = useFlatConfig ? "flat" : "eslintrc"
+
+    log(`检测到 ESLint 版本: ${eslintVersion || "未知"} → 使用 ${eslintFormat} 格式`)
+    log(`检测到 CSS 预处理器: ${cssPreprocessor}`)
+    if (uniApp) log(`检测到 uni-app 项目`)
+    console.log("")
+
+    // --- Build file list based on detection ---
+    const files = []
+
+    if (useFlatConfig) {
+        files.push({
+            path: "eslint.config.ts",
+            exists: fileExists("eslint.config.ts") || fileExists("eslint.config.js") || fileExists("eslint.config.mjs"),
+            content: eslintFlatConfigContent(uniApp),
+        })
+    } else {
+        files.push({
+            path: ".eslintrc.cjs",
+            exists: fileExists(".eslintrc.cjs"),
+            content: eslintrcContent(uniApp),
+        })
+    }
+
+    files.push({
+        path: ".prettierrc.cjs",
+        exists: fileExists(".prettierrc.cjs"),
+        content: prettierrcContent(),
+    })
+
+    files.push({
+        path: ".prettierignore",
+        exists: fileExists(".prettierignore"),
+        content: prettierignoreContent(),
+    })
+
+    // Stylelint: always generate, but note if no CSS preprocessor
+    if (cssPreprocessor !== "none") {
+        files.push({
+            path: ".stylelintrc.cjs",
+            exists: fileExists(".stylelintrc.cjs"),
+            content: stylelintrcContent(cssPreprocessor),
+        })
+    } else {
+        log("跳过 Stylelint 配置 (未检测到 CSS 预处理器)")
+    }
+
+    files.push({
+        path: ".commitlintrc.cjs",
+        exists: fileExists(".commitlintrc.cjs"),
+        content: commitlintrcContent(),
+    })
+
+    files.push({
+        path: ".versionrc.js",
+        exists: fileExists(".versionrc.js"),
+        content: versionrcContent(),
+    })
+
+    files.push({
+        path: ".editorconfig",
+        exists: fileExists(".editorconfig"),
+        content: editorconfigContent(),
+    })
+
+    files.push({
+        path: ".gitattributes",
+        exists: fileExists(".gitattributes"),
+        content: gitattributesContent(),
+    })
+
+    // Show what will be created/overwritten
+    for (const f of files) {
+        if (f.exists) {
+            warn(`${label}覆盖 ${f.path}`)
+        } else {
+            success(`${label}创建 ${f.path}`)
+        }
+    }
+
+    // Husky hooks
+    const huskyDir = path.resolve(PROJECT_ROOT, ".husky")
+    const hasHusky = fs.existsSync(huskyDir)
+    if (!hasHusky) {
+        success(`${label}创建 .husky/ 目录`)
+    }
+
+    const hooks = [
+        { path: ".husky/commit-msg", content: huskyCommitMsg() },
+        { path: ".husky/pre-commit", content: huskyPreCommit() },
+    ]
+
+    for (const h of hooks) {
+        if (fileExists(h.path)) {
+            warn(`${label}覆盖 ${h.path}`)
+        } else {
+            success(`${label}创建 ${h.path}`)
+        }
+    }
+
+    if (dryRun) {
+        console.log("")
+        warn("Dry run 结束，未修改任何文件")
+        console.log("")
+        return
+    }
+
+    // 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: {
+            prepare: "husky install",
+            release: "standard-version",
+            cz: "czg",
+        },
+        "lint-staged": getLintStagedConfig(cssPreprocessor),
+    })
+    success("更新 package.json (scripts + lint-staged)")
+
+    // Check for missing peerDependencies
+    checkPeerDeps({ useFlatConfig, cssPreprocessor })
+
+    console.log("")
+    success("配置初始化完成！")
+    console.log("")
+    console.log("  下一步：")
+    console.log("  1. 确保已安装 peerDependencies：")
+    console.log("     pnpm add -D 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("  3. 初始化 husky：")
+    console.log("     pnpm prepare")
+    console.log("  4. 使用 czg 提交 commit：")
+    console.log("     pnpm cz")
+    console.log("")
+}
+
+function modifyPackageJson(updates) {
+    const pkgPath = path.resolve(PROJECT_ROOT, "package.json")
+    let pkg = {}
+    if (fileExists("package.json")) {
+        pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"))
+    }
+
+    // Merge scripts
+    if (updates.scripts) {
+        pkg.scripts = { ...pkg.scripts, ...updates.scripts }
+    }
+
+    // Merge lint-staged
+    if (updates["lint-staged"]) {
+        pkg["lint-staged"] = { ...pkg["lint-staged"], ...updates["lint-staged"] }
+    }
+
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 4) + "\n", "utf8")
+}
+
+function checkPeerDeps({ useFlatConfig = false, cssPreprocessor = "scss" } = {}) {
+    const baseDeps = [
+        "eslint",
+        "prettier",
+        "@commitlint/cli",
+        "husky",
+        "lint-staged",
+        "czg",
+        "standard-version",
+    ]
+
+    const flatDeps = useFlatConfig
+        ? ["typescript-eslint", "globals", "eslint-plugin-import-x", "@eslint/js"]
+        : []
+
+    const cssDeps = cssPreprocessor === "scss"
+        ? ["stylelint", "postcss-scss"]
+        : cssPreprocessor === "less"
+            ? ["stylelint", "postcss-less"]
+            : []
+
+    const allPeerDeps = [...baseDeps, ...flatDeps, ...cssDeps]
+
+    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 || {}),
+    }
+
+    const missing = allPeerDeps.filter((dep) => !allDeps[dep])
+    if (missing.length > 0) {
+        console.log("")
+        warn("以下 peerDependencies 未安装，建议安装：")
+        warn(`pnpm add -D ${missing.join(" ")}`)
+    }
+}
+
+main()

package/package.json

@@ -0,0 +1,121 @@
+{
+    "name": "my-code-style",
+    "version": "1.0.0",
+    "description": "Lint/Format/Git 配置工程化 npm 包（ESLint + Prettier + Stylelint + Commitlint + Husky + standard-version）",
+    "type": "commonjs",
+    "main": "src/eslint/uniapp.cjs",
+    "bin": {
+        "my-code-style-init": "./bin/init.cjs"
+    },
+    "exports": {
+        ".": "./src/eslint/uniapp.cjs",
+        "./eslint": "./src/eslint/base.cjs",
+        "./eslint/vue3": "./src/eslint/vue3.cjs",
+        "./eslint/uniapp": "./src/eslint/uniapp.cjs",
+        "./eslint/flat": "./src/eslint/flat/base.mjs",
+        "./eslint/flat/vue3": "./src/eslint/flat/vue3.mjs",
+        "./eslint/flat/uniapp": "./src/eslint/flat/uniapp.mjs",
+        "./prettier": "./src/prettier/index.cjs",
+        "./stylelint": "./src/stylelint/index.cjs",
+        "./stylelint/less": "./src/stylelint/less.cjs",
+        "./stylelint/less-override": "./src/stylelint/less-override.cjs",
+        "./commitlint": "./src/commitlint/base.cjs",
+        "./commitlint/scopes": "./src/commitlint/scopes.cjs",
+        "./versionrc": "./src/versionrc/index.cjs"
+    },
+    "files": [
+        "src",
+        "bin",
+        "README.md"
+    ],
+    "scripts": {
+        "release": "standard-version"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "peerDependencies": {
+        "@commitlint/cli": ">=18.0.0",
+        "@commitlint/config-conventional": ">=18.0.0",
+        "@eslint/eslintrc": ">=3.0.0",
+        "@eslint/js": ">=9.0.0",
+        "@typescript-eslint/eslint-plugin": ">=6.0.0",
+        "@typescript-eslint/parser": ">=6.0.0",
+        "czg": ">=1.0.0",
+        "eslint": ">=8.0.0",
+        "eslint-config-prettier": ">=9.0.0",
+        "eslint-config-standard": ">=17.0.0",
+        "eslint-import-resolver-typescript": ">=3.0.0",
+        "eslint-plugin-import": ">=2.0.0",
+        "eslint-plugin-import-x": ">=3.0.0",
+        "eslint-plugin-prettier": ">=5.0.0",
+        "eslint-plugin-vue": ">=9.0.0",
+        "globals": ">=15.0.0",
+        "husky": ">=8.0.0",
+        "lint-staged": ">=15.0.0",
+        "postcss-html": ">=1.0.0",
+        "postcss-less": ">=6.0.0",
+        "postcss-scss": ">=4.0.0",
+        "prettier": ">=3.0.0",
+        "standard-version": ">=9.0.0",
+        "stylelint": ">=16.0.0",
+        "stylelint-config-html": ">=1.0.0",
+        "stylelint-config-recess-order": ">=4.0.0",
+        "stylelint-config-recommended": ">=14.0.0",
+        "stylelint-config-recommended-scss": ">=14.0.0",
+        "stylelint-config-recommended-vue": ">=1.0.0",
+        "stylelint-prettier": ">=5.0.0",
+        "typescript-eslint": ">=8.0.0"
+    },
+    "peerDependenciesMeta": {
+        "@eslint/eslintrc": {
+            "optional": true
+        },
+        "@eslint/js": {
+            "optional": true
+        },
+        "eslint-plugin-vue": {
+            "optional": true
+        },
+        "eslint-plugin-import-x": {
+            "optional": true
+        },
+        "globals": {
+            "optional": true
+        },
+        "postcss-less": {
+            "optional": true
+        },
+        "postcss-scss": {
+            "optional": true
+        },
+        "postcss-html": {
+            "optional": true
+        },
+        "stylelint-config-recommended-scss": {
+            "optional": true
+        },
+        "stylelint-config-recommended-vue": {
+            "optional": true
+        },
+        "stylelint-config-html": {
+            "optional": true
+        },
+        "typescript-eslint": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "standard-version": "^9.5.0"
+    },
+    "keywords": [
+        "eslint-config",
+        "prettier-config",
+        "stylelint-config",
+        "commitlint-config",
+        "vue",
+        "uni-app",
+        "typescript"
+    ],
+    "license": "MIT"
+}

package/src/commitlint/base.cjs

@@ -0,0 +1,48 @@
+// Commitlint base config (without project-specific dynamic scopes)
+module.exports = {
+    ignores: [(commit) => commit.includes("init")],
+    extends: ["@commitlint/config-conventional"],
+    rules: {
+        "body-leading-blank": [2, "always"],
+        "footer-leading-blank": [1, "always"],
+        "header-max-length": [2, "always", 108],
+        "subject-empty": [2, "never"],
+        "type-empty": [2, "never"],
+        "subject-case": [0],
+        "type-enum": [
+            2,
+            "always",
+            [
+                "feat",
+                "fix",
+                "perf",
+                "style",
+                "docs",
+                "test",
+                "refactor",
+                "build",
+                "ci",
+                "chore",
+                "revert",
+                "wip",
+                "workflow",
+                "types",
+                "release",
+            ],
+        ],
+    },
+    prompt: {
+        alias: {
+            f: "docs: fix typos",
+            r: "docs: update README",
+            s: "style: update code format",
+            b: "build: bump dependencies",
+            c: "chore: update config",
+        },
+        typesAppend: [
+            { value: "wip", name: "wip:      work in process" },
+            { value: "workflow", name: "workflow: workflow improvements" },
+            { value: "types", name: "types:    type definition file changes" },
+        ],
+    },
+}

package/src/commitlint/scopes.cjs

@@ -0,0 +1,46 @@
+// Commitlint scopes helper — dynamically generate scopes from project directories
+const fs = require("fs")
+const path = require("path")
+const { execSync } = require("child_process")
+
+/**
+ * Generate scopes by reading directory names
+ * @param {string|string[]} srcDirs - Source directory name(s) relative to cwd
+ * @returns {string[]} Scope names
+ */
+function generateScopes(srcDirs = "src") {
+    const dirs = Array.isArray(srcDirs) ? srcDirs : [srcDirs]
+    const allScopes = []
+
+    for (const srcDir of dirs) {
+        const resolved = path.resolve(process.cwd(), srcDir)
+        if (!fs.existsSync(resolved)) continue
+        const scopes = fs
+            .readdirSync(resolved, { withFileTypes: true })
+            .filter((dirent) => dirent.isDirectory())
+            .map((dirent) => dirent.name.replace(/s$/, ""))
+        allScopes.push(...scopes)
+    }
+
+    return [...new Set(allScopes)]
+}
+
+/**
+ * Guess the current scope from git status (modified files under src/)
+ * @returns {string|undefined}
+ */
+function guessCurrentScope() {
+    try {
+        const output = execSync("git status --porcelain || true").toString().trim()
+        const line = output.split("\n").find((r) => r.includes("M  src"))
+        if (!line) return undefined
+        return line
+            .replace(/\//g, "%%")
+            .match(/src%%((\w|-)*)/)?.[1]
+            ?.replace(/s$/, "")
+    } catch {
+        return undefined
+    }
+}
+
+module.exports = { generateScopes, guessCurrentScope }

package/src/editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 4
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{json,yml,yaml}]
+indent_size = 2
+
+[*.nvue]
+indent_size = 4

package/src/eslint/base.cjs

@@ -0,0 +1,55 @@
+// Base ESLint config for TypeScript projects
+module.exports = {
+    env: {
+        browser: true,
+        es2021: true,
+        node: true,
+    },
+    extends: [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended",
+        "plugin:import/recommended",
+        "standard",
+        "prettier",
+        "plugin:prettier/recommended",
+    ],
+    parserOptions: {
+        ecmaVersion: "latest",
+        parser: "@typescript-eslint/parser",
+        sourceType: "module",
+    },
+    plugins: ["@typescript-eslint", "prettier", "import"],
+    rules: {
+        // Prettier 集成
+        "prettier/prettier": ["error", { singleQuote: false, tabWidth: 4 }],
+        // Import 相关
+        "import/no-unresolved": "off",
+        "import/extensions": [
+            "error",
+            "ignorePackages",
+            { js: "never", jsx: "never", ts: "never", tsx: "never" },
+        ],
+        "import/prefer-default-export": ["off"],
+        "import/no-extraneous-dependencies": "off",
+        // TypeScript
+        "@typescript-eslint/no-redeclare": "error",
+        // 常用关闭
+        "no-console": ["off"],
+        "no-plusplus": "off",
+        "no-shadow": "off",
+        "no-underscore-dangle": "off",
+        "no-use-before-define": "off",
+        "no-undef": "off",
+        "no-unused-vars": "off",
+        "no-param-reassign": "off",
+        "@typescript-eslint/no-unused-vars": "off",
+        "no-redeclare": "off",
+        "prefer-promise-reject-errors": "off",
+        // 引号规则
+        quotes: ["error", "double", { avoidEscape: false, allowTemplateLiterals: true }],
+    },
+    settings: {
+        "import/parsers": { "@typescript-eslint/parser": [".ts", ".tsx"] },
+        "import/resolver": { typescript: {} },
+    },
+}

package/src/eslint/flat/_shared.mjs

@@ -0,0 +1,55 @@
+// Shared constants and rule objects for Flat Config files
+
+/**
+ * Prettier plugin rules — mirrors base.cjs prettier/prettier config
+ */
+export const prettierRules = {
+    "prettier/prettier": ["error", { singleQuote: false, tabWidth: 4 }],
+}
+
+/**
+ * Common rules shared across all flat config levels — mirrors base.cjs rules
+ */
+export const commonRules = {
+    // Import rules (using import-x for flat config compatibility)
+    "import-x/no-unresolved": "off",
+    "import-x/extensions": [
+        "error",
+        "ignorePackages",
+        { js: "never", jsx: "never", ts: "never", tsx: "never" },
+    ],
+    "import-x/prefer-default-export": "off",
+    "import-x/no-extraneous-dependencies": "off",
+    // TypeScript
+    "@typescript-eslint/no-redeclare": "error",
+    // Commonly disabled
+    "no-console": "off",
+    "no-plusplus": "off",
+    "no-shadow": "off",
+    "no-underscore-dangle": "off",
+    "no-use-before-define": "off",
+    "no-undef": "off",
+    "no-unused-vars": "off",
+    "no-param-reassign": "off",
+    "@typescript-eslint/no-unused-vars": "off",
+    "no-redeclare": "off",
+    "prefer-promise-reject-errors": "off",
+    // Quotes
+    quotes: ["error", "double", { avoidEscape: false, allowTemplateLiterals: true }],
+}
+
+/**
+ * Uni-app global variables — mirrors uniapp.cjs globals
+ */
+export const uniappGlobals = {
+    $t: true,
+    uni: true,
+    UniApp: true,
+    wx: true,
+    WechatMiniprogram: true,
+    getCurrentPages: true,
+    UniHelper: true,
+    Page: true,
+    App: true,
+    NodeJS: true,
+}

package/src/eslint/flat/base.mjs

@@ -0,0 +1,78 @@
+// Base ESLint Flat Config for TypeScript projects (ESLint v9+)
+// Equivalent to src/eslint/base.cjs but in flat config format
+
+import tseslint from "typescript-eslint"
+import importX from "eslint-plugin-import-x"
+import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended"
+import eslintConfigPrettier from "eslint-config-prettier"
+import globals from "globals"
+import { prettierRules, commonRules } from "./_shared.mjs"
+
+export default [
+    // Ignore patterns
+    {
+        ignores: ["**/node_modules/**", "**/dist/**", "**/coverage/**"],
+    },
+
+    // TypeScript recommended rules
+    // Replaces: extends: ["eslint:recommended", "plugin:@typescript-eslint/recommended"]
+    ...tseslint.configs.recommended,
+
+    // eslint-plugin-import-x configuration
+    // Replaces: plugin:import/recommended + eslint-config-standard (via FlatCompat)
+    {
+        files: ["**/*.{js,mjs,cjs,ts,mts,cts}"],
+        plugins: {
+            "import-x": importX,
+        },
+        rules: {
+            ...importX.configs.recommended.rules,
+        },
+        settings: {
+            "import-x/resolver": {
+                typescript: true,
+                node: true,
+            },
+        },
+    },
+
+    // Prettier integration
+    // Replaces: extends: ["plugin:prettier/recommended"]
+    eslintPluginPrettierRecommended,
+
+    // eslint-config-prettier MUST be last — disables conflicting ESLint rules
+    eslintConfigPrettier,
+
+    // Global language options + shared rules
+    {
+        files: ["**/*.{js,mjs,cjs,ts,mts,cts}"],
+        languageOptions: {
+            ecmaVersion: "latest",
+            sourceType: "module",
+            globals: {
+                ...globals.browser,
+                ...globals.node,
+                ...globals.es2021,
+            },
+            parser: tseslint.parser,
+            parserOptions: {
+                ecmaVersion: "latest",
+                sourceType: "module",
+            },
+        },
+        rules: {
+            ...prettierRules,
+            ...commonRules,
+        },
+    },
+
+    // .nvue file handling (uni-app)
+    {
+        files: ["**/*.nvue"],
+        languageOptions: {
+            parserOptions: {
+                sourceType: "script",
+            },
+        },
+    },
+]

package/src/eslint/flat/uniapp.mjs

@@ -0,0 +1,17 @@
+// uni-app ESLint Flat Config — extends vue3 flat config, adds uni-app globals
+
+import vue3Config from "./vue3.mjs"
+import { uniappGlobals } from "./_shared.mjs"
+
+export default [
+    // Spread all Vue 3 configs
+    ...vue3Config,
+
+    // Add uni-app globals
+    {
+        files: ["**/*.{vue,ts,js,nvue}"],
+        languageOptions: {
+            globals: uniappGlobals,
+        },
+    },
+]

package/src/eslint/flat/vue3.mjs

@@ -0,0 +1,46 @@
+// Vue 3 ESLint Flat Config — extends base, adds Vue-specific rules
+
+import pluginVue from "eslint-plugin-vue"
+import baseConfig from "./base.mjs"
+
+export default [
+    // Spread all base configs first
+    ...baseConfig,
+
+    // Vue 3 essential rules
+    // Replaces: extends: ["plugin:vue/vue3-essential"]
+    // Must scope to .vue files only
+    ...pluginVue.configs["flat/essential"].map((config) => ({
+        ...config,
+        files: ["**/*.vue"],
+    })),
+
+    // Vue plugin setup and custom overrides
+    {
+        files: ["**/*.vue"],
+        languageOptions: {
+            parserOptions: {
+                parser: "@typescript-eslint/parser",
+                sourceType: "module",
+            },
+        },
+        rules: {
+            "vue/multi-word-component-names": "off",
+            "@typescript-eslint/no-explicit-any": "off",
+            "vue/no-mutating-props": ["error", { shallowOnly: true }],
+        },
+    },
+
+    // .nvue specific overrides
+    {
+        files: ["*.nvue"],
+        languageOptions: {
+            parserOptions: {
+                sourceType: "script",
+            },
+        },
+        rules: {
+            "vue/comment-directive": "off",
+        },
+    },
+]

package/src/eslint/uniapp.cjs

@@ -0,0 +1,22 @@
+// uni-app ESLint config — extends Vue 3, adds uni-app globals and rules
+const vue3 = require("./vue3.cjs")
+
+module.exports = {
+    ...vue3,
+    extends: vue3.extends,
+    globals: {
+        $t: true,
+        uni: true,
+        UniApp: true,
+        wx: true,
+        WechatMiniprogram: true,
+        getCurrentPages: true,
+        UniHelper: true,
+        Page: true,
+        App: true,
+        NodeJS: true,
+    },
+    rules: {
+        ...vue3.rules,
+    },
+}

package/src/eslint/vue3.cjs

@@ -0,0 +1,23 @@
+// Vue 3 ESLint config — extends base, adds Vue-specific rules
+const base = require("./base.cjs")
+
+module.exports = {
+    ...base,
+    extends: [...base.extends, "plugin:vue/vue3-essential"],
+    plugins: [...base.plugins, "vue"],
+    overrides: [
+        {
+            env: { node: true },
+            files: [".eslintrc.{js,cjs}", "*.nvue"],
+            parserOptions: { sourceType: "script" },
+            rules: { "vue/comment-directive": "off" },
+        },
+        ...(base.overrides || []),
+    ],
+    rules: {
+        ...base.rules,
+        "vue/multi-word-component-names": "off",
+        "@typescript-eslint/no-explicit-any": "off",
+        "vue/no-mutating-props": ["error", { shallowOnly: true }],
+    },
+}

package/src/gitattributes

@@ -0,0 +1,19 @@
+* text eol=lf
+
+# Binary files — do not apply EOL conversion
+*.aar binary
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.webp binary
+*.bmp binary
+*.dex binary
+*.DS_Store binary
+*.jar binary
+*.ttf binary
+*.woff binary
+*.woff2 binary
+*.apk binary
+*.plist binary

package/src/husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no-install commitlint --edit

package/src/husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no-install -- lint-staged

package/src/prettier/index.cjs

@@ -0,0 +1,21 @@
+// Prettier config
+module.exports = {
+    singleQuote: false,
+    printWidth: 100,
+    tabWidth: 4,
+    useTabs: false,
+    semi: false,
+    trailingComma: "all",
+    endOfLine: "lf",
+    htmlWhitespaceSensitivity: "ignore",
+    overrides: [
+        {
+            files: "*.json",
+            options: { trailingComma: "none" },
+        },
+        {
+            files: "*.nvue",
+            options: { semi: true },
+        },
+    ],
+}

package/src/prettierignore

@@ -0,0 +1,16 @@
+*.aar
+*.png
+*.jpg
+*.jpeg
+*.gif
+*.ico
+*.webp
+*.bmp
+*.dex
+*.DS_Store
+*.jar
+*.ttf
+*.woff
+*.woff2
+*.apk
+*.plist

package/src/stylelint/index.cjs

@@ -0,0 +1,55 @@
+// Stylelint config for Vue/SCSS/Less projects
+module.exports = {
+    root: true,
+    extends: [
+        "stylelint-config-recommended",
+        "stylelint-config-recommended-scss",
+        "stylelint-config-recommended-vue/scss",
+        "stylelint-config-html/vue",
+        "stylelint-config-recess-order",
+    ],
+    plugins: ["stylelint-prettier"],
+    overrides: [
+        {
+            files: ["**/*.{vue,html}"],
+            customSyntax: "postcss-html",
+        },
+        {
+            files: ["**/*.{css,scss}"],
+            customSyntax: "postcss-scss",
+        },
+        {
+            files: ["**/*.less"],
+            customSyntax: "postcss-less",
+        },
+    ],
+    rules: {
+        "prettier/prettier": true,
+        // Less and SCSS both use @ for non-standard at-rules
+        "at-rule-no-unknown": null,
+        // 允许 global、export、v-deep 等伪类
+        "selector-pseudo-class-no-unknown": [
+            true,
+            { ignorePseudoClasses: ["global", "export", "v-deep", "deep"] },
+        ],
+        // Allow ::v-deep / /deep/ pseudo-elements
+        "selector-pseudo-element-no-unknown": [
+            true,
+            { ignorePseudoElements: ["v-deep", "deep", "ng-deep"] },
+        ],
+        // Less built-in functions unknown to Stylelint
+        "function-no-unknown": null,
+        // 允许小程序单位 rpx
+        "unit-no-unknown": [true, { ignoreUnits: ["rpx"] }],
+        // 允许小程序 page 标签
+        "selector-type-no-unknown": [true, { ignoreTypes: ["page"] }],
+        "comment-empty-line-before": "never",
+        "custom-property-empty-line-before": "never",
+        "no-empty-source": null,
+        "comment-no-empty": null,
+        "no-duplicate-selectors": null,
+        "scss/comment-no-empty": null,
+        "selector-class-pattern": null,
+        "font-family-no-missing-generic-family-keyword": null,
+    },
+}

package/src/stylelint/less-override.cjs

@@ -0,0 +1,22 @@
+// Less-specific Stylelint override configuration
+// Usage: merge into your Stylelint config when your project uses Less
+
+module.exports = {
+    overrides: [
+        {
+            files: ["**/*.less"],
+            customSyntax: "postcss-less",
+        },
+    ],
+    rules: {
+        // Less uses @ for variables, mixins, etc. — disable globally
+        "at-rule-no-unknown": null,
+        // Less built-in functions (darken, lighten, fade...) unknown to Stylelint
+        "function-no-unknown": null,
+        // Allow ::v-deep / /deep/ / ::ng-deep pseudo-elements
+        "selector-pseudo-element-no-unknown": [
+            true,
+            { ignorePseudoElements: ["v-deep", "deep", "ng-deep"] },
+        ],
+    },
+}

package/src/stylelint/less.cjs

@@ -0,0 +1,49 @@
+// Stylelint config for Vue/Less projects
+module.exports = {
+    root: true,
+    extends: [
+        "stylelint-config-recommended",
+        "stylelint-config-recommended-vue",
+        "stylelint-config-html/vue",
+        "stylelint-config-recess-order",
+    ],
+    plugins: ["stylelint-prettier"],
+    overrides: [
+        {
+            files: ["**/*.{vue,html}"],
+            customSyntax: "postcss-html",
+        },
+        {
+            files: ["**/*.less"],
+            customSyntax: "postcss-less",
+        },
+    ],
+    rules: {
+        "prettier/prettier": true,
+        // Less uses @ for variables/mixins/etc
+        "at-rule-no-unknown": null,
+        // 允许 global、export、v-deep 等伪类
+        "selector-pseudo-class-no-unknown": [
+            true,
+            { ignorePseudoClasses: ["global", "export", "v-deep", "deep"] },
+        ],
+        // Allow ::v-deep / /deep/ pseudo-elements
+        "selector-pseudo-element-no-unknown": [
+            true,
+            { ignorePseudoElements: ["v-deep", "deep", "ng-deep"] },
+        ],
+        // Less built-in functions unknown to Stylelint
+        "function-no-unknown": null,
+        // 允许小程序单位 rpx
+        "unit-no-unknown": [true, { ignoreUnits: ["rpx"] }],
+        // 允许小程序 page 标签
+        "selector-type-no-unknown": [true, { ignoreTypes: ["page"] }],
+        "comment-empty-line-before": "never",
+        "custom-property-empty-line-before": "never",
+        "no-empty-source": null,
+        "comment-no-empty": null,
+        "no-duplicate-selectors": null,
+        "selector-class-pattern": null,
+        "font-family-no-missing-generic-family-keyword": null,
+    },
+}

package/src/versionrc/index.cjs

@@ -0,0 +1,14 @@
+// standard-version config
+module.exports = {
+    header: "## 变更日志\n",
+    types: [
+        { type: "feat", section: "✨ Features | 新功能" },
+        { type: "fix", section: "🐛 Bug Fixes | Bug 修复" },
+    ],
+    skip: {
+        bump: false,
+        changelog: false,
+        commit: false,
+        tag: false,
+    },
+}