@polyv/eslint-config 0.7.0 → 1.0.0

package/configs/miniprogram/index.mjs

@@ -0,0 +1,46 @@
+const sourceFilePattern = '**/*.{js,cjs,mjs,jsx,ts,tsx,mts,cts}';
+
+export const unitTestFilePatterns = [
+  '**/__tests__/**/*.{js,cjs,mjs,jsx,ts,tsx,mts,cts}',
+  '**/__test__/**/*.{js,cjs,mjs,jsx,ts,tsx,mts,cts}',
+  '**/tests/**/*.{js,cjs,mjs,jsx,ts,tsx,mts,cts}',
+  '**/test/**/*.{js,cjs,mjs,jsx,ts,tsx,mts,cts}',
+  '**/*.test.{js,cjs,mjs,jsx,ts,tsx,mts,cts}',
+  '**/*.spec.{js,cjs,mjs,jsx,ts,tsx,mts,cts}'
+];
+
+export const miniprogramGlobals = {
+  App: 'readonly',
+  Component: 'readonly',
+  Page: 'readonly',
+  getApp: 'readonly',
+  wx: 'readonly'
+};
+
+export default [
+  {
+    ignores: [
+      'miniprogram_npm/**',
+      '**/miniprogram_npm/**'
+    ]
+  },
+  {
+    files: [sourceFilePattern],
+    languageOptions: {
+      globals: miniprogramGlobals
+    },
+    rules: {
+      // 小程序 npm 构建需要显式 index，引入该配置时关闭会建议移除 index 的 import 规则。
+      'import-x/no-useless-path-segments': 'off',
+      // 禁止依赖相对目录的 index 兜底解析，避免小程序 npm 构建后路径解析失败。
+      'polyv/no-relative-directory-index-imports': 'error'
+    }
+  },
+  {
+    files: unitTestFilePatterns,
+    rules: {
+      // 单元测试文件不进入小程序 npm 产物，允许使用目录 index 简写。
+      'polyv/no-relative-directory-index-imports': 'off'
+    }
+  }
+];

package/configs/prettier/README.md

@@ -0,0 +1,53 @@
+# Prettier 配置
+
+`polyv.configs.prettier` 用于接入 `eslint-plugin-prettier/recommended`，并内置 Polyv 共享 Prettier 选项。
+
+## 使用方式
+
+Prettier 配置应放在配置数组最后，确保它能关闭前面配置中和 Prettier 冲突的格式类规则：
+
+```javascript
+// eslint.config.mjs
+import polyv from '@polyv/eslint-config';
+
+export default [
+  ...polyv.configs.common,
+  ...polyv.configs.js,
+  ...polyv.configs.prettier
+];
+```
+
+也可以通过子路径单独引入：
+
+```javascript
+// eslint.config.mjs
+import prettier from '@polyv/eslint-config/configs/prettier';
+
+export default [
+  ...prettier
+];
+```
+
+## 配置内容
+
+- 复用根级 [prettier-config.mjs](../../prettier-config.mjs) 中的共享 Prettier 配置。
+- 引入 `eslint-plugin-prettier/recommended`。
+- 注册 `prettier` plugin。
+- 开启 `prettier/prettier` 规则，并设置 `usePrettierrc: false`，避免消费项目必须单独维护 `prettier.config.mjs`。
+- 继承 `eslint-config-prettier`，关闭和 Prettier 冲突的格式类 ESLint 规则。
+- 内置共享 Prettier 选项：`useTabs: false`、`printWidth: 120`、`tabWidth: 2`、`singleQuote: true`、`semi: true`、`trailingComma: 'all'`、`bracketSameLine: false`、`arrowParens: 'avoid'`、`quoteProps: 'as-needed'`、`singleAttributePerLine: true`。
+
+## 注意事项
+
+`configs.prettier` 不内联引入 `common`。接入完整预设时仍应显式组合 `polyv.configs.common`，并把 `polyv.configs.prettier` 放在最后。
+
+如果消费项目需要覆盖共享格式选项，可以在 `polyv.configs.prettier` 后追加自己的 `prettier/prettier` 规则配置。
+
+如果消费项目需要单独给 Prettier CLI 或编辑器使用共享配置，可以在项目里的 `prettier.config.mjs` 中写：
+
+```javascript
+// prettier.config.mjs
+import prettierConfig from '@polyv/eslint-config/prettier-config';
+
+export default prettierConfig;
+```

package/configs/prettier/index.mjs

@@ -0,0 +1,17 @@
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import prettierConfig from '../../prettier-config.mjs';
+
+export const prettierOptions = prettierConfig;
+
+export default [
+  // 启用 prettier 推荐配置，注册 prettier 插件并关闭与 prettier 冲突的格式类规则。
+  eslintPluginPrettierRecommended,
+  {
+    rules: {
+      // 复用共享 Prettier 选项，避免消费项目单独维护 prettier.config.mjs。
+      'prettier/prettier': ['error', prettierOptions, {
+        usePrettierrc: false
+      }]
+    }
+  }
+];

package/configs/sonarjs/README.md

@@ -0,0 +1,48 @@
+# SonarJS 配置
+
+`polyv.configs.sonarjs` 用于提供 `eslint-plugin-sonarjs` 的推荐规则和项目内覆盖规则。
+
+## 使用方式
+
+通常不需要单独引入该配置，`polyv.configs.common` 已经继承了 `polyv.configs.sonarjs`：
+
+```javascript
+// eslint.config.mjs
+import polyv from '@polyv/eslint-config';
+
+export default [
+  ...polyv.configs.common
+];
+```
+
+如果只需要 SonarJS 能力，也可以单独组合：
+
+```javascript
+// eslint.config.mjs
+import polyv from '@polyv/eslint-config';
+
+export default [
+  ...polyv.configs.sonarjs
+];
+```
+
+也可以通过子路径单独引入：
+
+```javascript
+// eslint.config.mjs
+import sonarjs from '@polyv/eslint-config/configs/sonarjs';
+
+export default [
+  ...sonarjs
+];
+```
+
+## 配置内容
+
+- 启用 `eslint-plugin-sonarjs` 的推荐配置。
+- 集中维护复杂度、重复分支、重复字符串、无意义表达式、冗余跳转、嵌套 switch、未使用集合等 `sonarjs/*` 规则。
+- 关闭部分容易和历史代码、示例配置、SDK 兼容代码产生误报或风格冲突的规则，例如 `sonarjs/elseif-without-else`、`sonarjs/no-clear-text-protocols`、`sonarjs/no-duplicate-string`、`sonarjs/no-hardcoded-ip`、`sonarjs/pseudo-random`、`sonarjs/redundant-type-aliases`、`sonarjs/slow-regex` 和 `sonarjs/todo-tag`。
+
+## 注意事项
+
+`configs.sonarjs` 不内联引入 `common`。接入完整预设时仍应显式组合 `polyv.configs.common`。

package/configs/sonarjs/index.mjs

@@ -0,0 +1,92 @@
+import sonarjsPlugin from 'eslint-plugin-sonarjs';
+
+export default [
+  // 启用 sonarjs 推荐规则，检查复杂度、重复代码和常见逻辑问题。
+  sonarjsPlugin.configs.recommended,
+  {
+    rules: {
+      // 限制函数认知复杂度，避免过多分支和嵌套。
+      'sonarjs/cognitive-complexity': ['error', 20],
+      // 关闭 elseif 必须带 else 的限制。
+      'sonarjs/elseif-without-else': 'off',
+      // 限制 switch 分支数量。
+      'sonarjs/max-switch-cases': 'error',
+      // 禁止所有条件分支代码完全相同。
+      'sonarjs/no-all-duplicated-branches': 'error',
+      // 禁止可以合并的嵌套 if。
+      'sonarjs/no-collapsible-if': 'error',
+      // 关闭注释代码检查，避免示例代码或兼容性注释误报。
+      'sonarjs/no-commented-code': 'off',
+      // 关闭明文协议检查，允许历史配置或示例中保留 http 等协议字符串。
+      'sonarjs/no-clear-text-protocols': 'off',
+      // 关闭集合长度误判检查，避免现有代码误报。
+      'sonarjs/no-collection-size-mischeck': 'off',
+      // 关闭重复字符串检查，避免业务常量、文案和接口路径产生大量误报。
+      'sonarjs/no-duplicate-string': 'off',
+      // 禁止不同分支出现重复代码块。
+      'sonarjs/no-duplicated-branches': 'error',
+      // 禁止刚赋值的元素被立即覆盖。
+      'sonarjs/no-element-overwrite': 'error',
+      // 禁止对明显为空的集合做无意义操作。
+      'sonarjs/no-empty-collection': 'error',
+      // 禁止调用函数时传入多余参数。
+      'sonarjs/no-extra-arguments': 'error',
+      // 禁止无意义或永远同值的表达式。
+      'sonarjs/no-gratuitous-expressions': 'error',
+      // 关闭硬编码 IP 检查，允许本地开发、内网地址或示例配置。
+      'sonarjs/no-hardcoded-ip': 'off',
+      // 禁止多个条件分支使用相同判断。
+      'sonarjs/no-identical-conditions': 'error',
+      // 禁止表达式两边完全相同。
+      'sonarjs/no-identical-expressions': 'error',
+      // 禁止多个函数实现完全相同。
+      'sonarjs/no-identical-functions': 'error',
+      // 禁止忽略应该使用的返回值。
+      'sonarjs/no-ignored-return': 'error',
+      // 关闭忽略异常检查，允许业务代码显式吞掉可忽略异常。
+      'sonarjs/no-ignored-exceptions': 'off',
+      // 关闭不变返回值检查，避免简单分支适配代码误报。
+      'sonarjs/no-invariant-returns': 'off',
+      // 关闭反向布尔判断检查。
+      'sonarjs/no-inverted-boolean-check': 'off',
+      // 禁止嵌套 switch。
+      'sonarjs/no-nested-switch': 'error',
+      // 禁止嵌套模板字符串。
+      'sonarjs/no-nested-template-literals': 'error',
+      // 禁止冗余布尔表达式。
+      'sonarjs/no-redundant-boolean': 'error',
+      // 禁止多余的 return、break 或 continue。
+      'sonarjs/no-redundant-jump': 'error',
+      // 关闭冗余类型别名检查，避免历史类型抽象或导出别名误报。
+      'sonarjs/redundant-type-aliases': 'off',
+      // 禁止同一行写复杂条件逻辑。
+      'sonarjs/no-same-line-conditional': 'error',
+      // 禁止过小的 switch。
+      'sonarjs/no-small-switch': 'error',
+      // 禁止创建或修改后没有实际使用的集合。
+      'sonarjs/no-unused-collection': 'error',
+      // 禁止使用没有返回值的函数调用结果。
+      'sonarjs/no-use-of-empty-return-value': 'error',
+      // 禁止只重新抛出异常的无意义 catch。
+      'sonarjs/no-useless-catch': 'error',
+      // 关闭从 PATH 查找系统命令的检查，避免 Node 工具脚本场景误报。
+      'sonarjs/no-os-command-from-path': 'off',
+      // 检查疑似写错的操作符组合。
+      'sonarjs/non-existent-operator': 'error',
+      // 建议直接返回表达式而不是先赋值再返回。
+      'sonarjs/prefer-immediate-return': 'error',
+      // 建议使用对象字面量。
+      'sonarjs/prefer-object-literal': 'error',
+      // 关闭单一布尔返回简化建议。
+      'sonarjs/prefer-single-boolean-return': 'off',
+      // 关闭伪随机数检查，允许非安全场景使用 Math.random 等实现。
+      'sonarjs/pseudo-random': 'off',
+      // 关闭慢正则检查，避免复杂兼容正则误报。
+      'sonarjs/slow-regex': 'off',
+      // 关闭待办标签检查，允许历史注释或临时事项保留。
+      'sonarjs/todo-tag': 'off',
+      // for 循环没有初始化或更新逻辑时建议改成 while。
+      'sonarjs/prefer-while': 'error'
+    }
+  }
+];

package/configs/ts/README.md

@@ -0,0 +1,43 @@
+# TypeScript 配置
+
+`polyv.configs.ts` 用于 TypeScript 项目或 TypeScript + JavaScript 混合项目。它已经集成 `polyv.configs.js`，因此混合项目不需要再额外引入 `polyv.configs.js`。
+
+## 使用方式
+
+```javascript
+// eslint.config.mjs
+import polyv from '@polyv/eslint-config';
+
+export default [
+  ...polyv.configs.common,
+  ...polyv.configs.ts
+];
+```
+
+## 配置内容
+
+- 集成 `polyv.configs.js`，覆盖 JavaScript 文件。
+- 启用 `typescript-eslint` 的 `tseslint.configs.recommended`。
+- 复用 `importX.flatConfigs.typescript` 的 TypeScript 处理，补充 TS 扩展名、`@typescript-eslint/parser` 映射和 TypeScript resolver，并关闭 TS 场景下容易误报的 `import-x/named`。
+- 配置 TypeScript 文件范围：`**/*.{ts,tsx}`。
+- 注入 browser 和 node 全局变量。
+- 使用 `@stylistic` 承接 ESLint 10 生态中已经移除的 TypeScript 格式类规则，例如分号、缩进、逗号空格、尾逗号、函数括号前空格和类型注解空格。
+- 迁移 ESLint 8 `for-ts.js` 中仍适用的 TypeScript 规则。
+- 不使用 `STRICT_LINT` 分支，相关规则统一按当前配置写死。
+
+## 关键规则
+
+- `@typescript-eslint/no-unused-vars`：未使用变量给出 `warn`，检查全部变量，允许 `_` 前缀变量和参数，允许对象 rest 兄弟属性。
+- `@typescript-eslint/no-explicit-any`：关闭 `any` 限制，兼容历史代码。
+- `@typescript-eslint/no-empty-object-type`：关闭空对象类型限制，兼容历史 `{}` 类型写法。
+- `@typescript-eslint/no-namespace`：关闭 namespace 限制，兼容历史声明合并或 SDK 类型组织方式。
+- `@typescript-eslint/no-unused-expressions`：禁止无用表达式，但允许短路表达式和三元表达式承载调用逻辑。
+- `polyv/explicit-module-boundary-types`：基于 `@typescript-eslint/explicit-module-boundary-types` 封装，按环境使用 `devWarnProdError`，生产环境为 `error`，其他环境为 `warn`；默认要求导出函数声明返回类型，具体场景可通过 settings 放开特定命名的返回类型推导。
+- `no-empty`：禁止空代码块，但允许空 `catch`。
+- `no-useless-escape`：关闭无意义转义检查，兼容历史字符串和正则写法。
+
+## 注意事项
+
+- `configs.ts` 不注册 `polyv`、`import-x`、`promise` 或 `sonarjs` 插件。
+- 接入时必须显式组合 `polyv.configs.common`。
+- Vue2 项目需要允许 `useXxx`、`xxxProp(s)` / `xxxEmit(s)` 省略返回类型时，在 `configs.ts` 后面继续组合 `polyv.configs.vue2`。

package/configs/ts/index.mjs

@@ -0,0 +1,148 @@
+import globals from 'globals';
+import stylistic from '@stylistic/eslint-plugin';
+import { importX } from 'eslint-plugin-import-x';
+import tseslint from 'typescript-eslint';
+import jsConfig from '../js/index.mjs';
+import { devWarnProdError } from '../../utils.mjs';
+
+const tsFiles = ['**/*.{ts,tsx}'];
+const importXTypeScriptConfig = {
+  name: importX.flatConfigs.typescript.name,
+  settings: importX.flatConfigs.typescript.settings,
+  rules: importX.flatConfigs.typescript.rules
+};
+
+export default [
+  ...jsConfig,
+  ...tseslint.configs.recommended,
+  // 启用 import-x 的 TypeScript 配置，补充 TS parser、TS 扩展名和 TypeScript resolver 设置。
+  importXTypeScriptConfig,
+  {
+    files: tsFiles,
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node
+      }
+    },
+    plugins: {
+      '@stylistic': stylistic
+    },
+    rules: {
+      // 关闭核心分号规则，交给 @stylistic 版本处理。
+      semi: 'off',
+      // 要求语句结尾必须使用分号。
+      '@stylistic/semi': ['error', 'always'],
+
+      // 关闭核心缩进规则，交给 @stylistic 版本处理。
+      indent: 'off',
+      // 要求使用 2 个空格缩进，switch case 多缩进一级。
+      '@stylistic/indent': ['error', 2, {
+        SwitchCase: 1
+      }],
+
+      // 关闭核心逗号空格规则，交给 @stylistic 版本处理。
+      'comma-spacing': 'off',
+      // 要求逗号后有空格、逗号前没有空格。
+      '@stylistic/comma-spacing': ['error'],
+
+      // 关闭核心尾逗号规则，交给 @stylistic 版本处理。
+      'comma-dangle': 'off',
+      // 只允许多行结构使用尾逗号，单行结构不允许。
+      '@stylistic/comma-dangle': ['error', 'only-multiline'],
+
+      // 关闭核心使用前定义规则，交给 TypeScript 版本处理。
+      'no-use-before-define': 'off',
+      // 禁止变量在定义前使用，但允许函数和类提前使用。
+      '@typescript-eslint/no-use-before-define': ['error', {
+        functions: false,
+        classes: false,
+        variables: true
+      }],
+
+      // 关闭核心未使用变量规则，交给 TypeScript 版本处理。
+      'no-unused-vars': 'off',
+      // 未使用变量给出警告，检查全部变量，允许对象 rest 兄弟属性和 _ 前缀变量不触发告警。
+      '@typescript-eslint/no-unused-vars': ['warn', {
+        vars: 'all',
+        args: 'after-used',
+        argsIgnorePattern: '^_',
+        ignoreRestSiblings: true,
+        caughtErrors: 'none',
+        varsIgnorePattern: '^_'
+      }],
+
+      // 关闭核心循环内函数规则，交给 TypeScript 版本处理。
+      'no-loop-func': 'off',
+      // 禁止在循环中定义可能捕获循环变量的函数。
+      '@typescript-eslint/no-loop-func': 'error',
+
+      // 关闭核心函数括号前空格规则，交给 @stylistic 版本处理。
+      'space-before-function-paren': 'off',
+      // 约束函数括号前空格：普通函数不留空格，async 箭头函数留空格。
+      '@stylistic/space-before-function-paren': ['error', {
+        anonymous: 'never',
+        named: 'never',
+        asyncArrow: 'always'
+      }],
+
+      // 允许使用 any。
+      '@typescript-eslint/no-explicit-any': 'off',
+      // 允许使用空对象类型，兼容历史类型声明中的 {} 写法。
+      '@typescript-eslint/no-empty-object-type': 'off',
+      // 允许使用 Function 类型，兼容历史函数类型声明。
+      '@typescript-eslint/no-unsafe-function-type': 'off',
+      // 允许使用 String、Number、Boolean、Object 等包装对象类型，兼容历史类型声明。
+      '@typescript-eslint/no-wrapper-object-types': 'off',
+      // 允许空函数。
+      '@typescript-eslint/no-empty-function': 'off',
+      // 允许空接口。
+      '@typescript-eslint/no-empty-interface': 'off',
+      // 允许 TypeScript namespace，兼容历史声明合并或 SDK 类型组织方式。
+      '@typescript-eslint/no-namespace': 'off',
+      // 禁止无用表达式，但允许短路和三元表达式承载调用逻辑。
+      '@typescript-eslint/no-unused-expressions': ['error', {
+        allowShortCircuit: true,
+        allowTernary: true
+      }],
+      // 要求类型注解冒号前无空格、冒号后有空格。
+      '@stylistic/type-annotation-spacing': ['error', {
+        after: true,
+        before: false
+      }],
+      // 要求箭头前后都有空格。
+      '@stylistic/arrow-spacing': ['error', {
+        before: true,
+        after: true
+      }],
+      // 要求仅作为类型使用的导入使用 import type，保持类型和值导入边界清晰。
+      '@typescript-eslint/consistent-type-imports': 'error',
+      // 关闭原模块边界类型规则，交给 polyv 包装版本读取 settings 并处理返回类型推导。
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      // 要求模块边界显式声明类型；具体场景可通过 settings 放开特定命名的返回类型推导。
+      'polyv/explicit-module-boundary-types': devWarnProdError,
+      // 要求 enum 名称和 enum 成员名称使用 PascalCase。
+      '@typescript-eslint/naming-convention': ['error', {
+        selector: 'enumMember',
+        format: ['PascalCase', 'UPPER_CASE']
+      }, {
+        selector: 'enum',
+        format: ['PascalCase']
+      }],
+      // 允许使用 CommonJS require。
+      '@typescript-eslint/no-var-requires': 'off',
+      // 禁止对数组使用 for-in，避免遍历到索引或继承属性。
+      '@typescript-eslint/no-for-in-array': 'off',
+      // 禁止空代码块，但允许空 catch 用于吞掉可忽略异常。
+      'no-empty': ['error', {
+        allowEmptyCatch: true
+      }],
+      // 允许历史字符串或正则里保留冗余转义。
+      'no-useless-escape': 'off',
+      // 允许变量赋值后未再被读取，避免历史代码中的中间赋值触发新规则。
+      'no-useless-assignment': 'off',
+    }
+  }
+];

package/configs/vue2/README.md

@@ -0,0 +1,87 @@
+# Vue2 配置
+
+`polyv.configs.vue2` 用于 Vue2 项目中的补充规则配置，包含 Vue2 SFC 解析、Vue2 essential 规则、从 ESLint 8 `for-vue2-js.js` 迁移的 Vue 规则，以及 Vue2 TypeScript 场景的返回类型推导 settings。
+
+## 使用方式
+
+Vue2 JavaScript 项目放在 `polyv.configs.js` 后面：
+
+```javascript
+// eslint.config.mjs
+import polyv from '@polyv/eslint-config';
+
+export default [
+  ...polyv.configs.common,
+  ...polyv.configs.js,
+  ...polyv.configs.vue2
+];
+```
+
+Vue2 TypeScript 项目放在 `polyv.configs.ts` 后面：
+
+```javascript
+// eslint.config.mjs
+import polyv from '@polyv/eslint-config';
+
+export default [
+  ...polyv.configs.common,
+  ...polyv.configs.ts,
+  ...polyv.configs.vue2
+];
+```
+
+## 配置内容
+
+- 启用 `eslint-plugin-vue` 的 `flat/vue2-essential`，承接 ESLint 8 的 `plugin:vue/essential`。
+- 为 `.vue` 文件配置 `vue-eslint-parser` 和 `typescript-eslint` parser，支持普通 `<script>`、`<script lang="ts">` 和 `<script setup lang="ts">`。
+- 为 `.vue` 文件注入 browser、node 和 jest 全局变量。
+- 从 ESLint 8 `for-vue2-js.js` 和 live-watch-sdk 本地 `.eslintrc.js` 迁移 Vue 规则，包括模板缩进、自闭合标签、属性换行、自定义事件命名、props 修改限制、组件名限制、attribute 连字符命名、v-on 事件连字符命名、模板组件名大小写和 style 属性限制。
+- 提供 `settings['polyv/explicit-module-boundary-types']`，不覆盖 `polyv.configs.ts` 中的规则配置。
+- 通过 settings 允许 `useXxx` hook 函数省略返回类型。
+- 通过 settings 允许 `xxxProp`、`xxxProps`、`xxxEmit`、`xxxEmits` 这类 Vue2 props/emits 工厂方法省略返回类型。
+- 仍然要求普通导出函数声明返回类型。
+- 仍然检查参数类型，不会因为函数名匹配就放开参数类型。
+- 启用 `polyv/no-vue-component-variable-name-conflict`，避免 `<script setup>` 中组件导入名和 lower camel 本地声明冲突。
+
+## 关键规则
+
+- `vue/html-indent`：要求 template 使用 2 个空格缩进。
+- `vue/html-self-closing`：要求 void HTML 标签和组件使用自闭合，普通 HTML 标签不使用自闭合。
+- `vue/no-v-html`：关闭 `v-html` 限制，兼容历史富文本渲染场景。
+- `vue/max-attributes-per-line`：单行元素最多 3 个属性，多行元素每行 1 个属性。
+- `vue/custom-event-name-casing`：要求自定义事件名称使用 `kebab-case`。
+- `vue/no-mutating-props`：禁止直接修改 props。
+- `vue/multi-word-component-names`：要求组件名使用多个单词，但允许 `index`、`Index`、`default`、`Default`。
+- `vue/attribute-hyphenation`：要求模板中的 attribute 使用连字符命名。
+- `vue/v-on-event-hyphenation`：要求 `v-on` 监听的自定义事件使用连字符命名。
+- `vue/component-name-in-template-casing`：要求模板中已注册组件使用 `kebab-case` 标签名。
+- `vue/enforce-style-attribute`：约束 `<style>` 标签属性，允许普通 `<style>`，违规时给出警告。
+- `polyv/no-vue-component-variable-name-conflict`：禁止 Vue `<script setup>` 中的组件导入名和 lower camel 本地声明产生命名冲突。
+
+## 示例
+
+```typescript
+// good.ts
+export function dialogProps() {
+  return {
+    visible: Boolean
+  };
+}
+
+export function dialogEmits() {
+  return ['confirm', 'cancel'];
+}
+```
+
+```typescript
+// bad.ts
+export function createDialog() {
+  return {
+    visible: Boolean
+  };
+}
+```
+
+## 注意事项
+
+`configs.vue2` 不内联引入 `common`、`js` 或 `ts`。接入完整预设时仍应显式组合 `polyv.configs.common`，并按项目语言选择 `polyv.configs.js` 或 `polyv.configs.ts`。

package/configs/vue2/index.mjs

@@ -0,0 +1,96 @@
+import globals from 'globals';
+import vue from 'eslint-plugin-vue';
+import tseslint from 'typescript-eslint';
+
+const vueFiles = ['*.vue', '**/*.vue'];
+const vue2ReturnTypeInferencePatterns = [
+  '^[A-Za-z_$][\\w$]*(?:Props?|Emits?)$'
+];
+
+export default [
+  // 启用 Vue2 essential 规则和 vue-eslint-parser，承接 ESLint 8 的 plugin:vue/essential。
+  ...vue.configs['flat/vue2-essential'],
+  {
+    files: vueFiles,
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.jest
+      },
+      parserOptions: {
+        parser: {
+          js: tseslint.parser,
+          ts: tseslint.parser,
+          '<template>': tseslint.parser
+        },
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        ecmaFeatures: {
+          jsx: true
+        },
+        extraFileExtensions: ['.vue'],
+        vueFeatures: {
+          filter: true,
+          interpolationAsNonHTML: true,
+          styleCSSVariableInjection: true
+        }
+      }
+    }
+  },
+  {
+    settings: {
+      // 为 polyv/explicit-module-boundary-types 提供 Vue2 props/emits 工厂方法命名约定。
+      'polyv/explicit-module-boundary-types': {
+        allowHookReturnTypeInference: true,
+        allowedReturnTypeInferencePatterns: vue2ReturnTypeInferencePatterns
+      }
+    },
+    rules: {
+      // 要求 template 使用 2 个空格缩进。
+      'vue/html-indent': ['error', 2],
+      // 约束 HTML、SVG、MathML 和组件标签的自闭合写法。
+      'vue/html-self-closing': ['error', {
+        html: {
+          void: 'always',
+          normal: 'never',
+          component: 'always'
+        },
+        svg: 'always',
+        math: 'always'
+      }],
+      // 允许 v-html，兼容历史富文本渲染场景。
+      'vue/no-v-html': 'off',
+      // 限制单行元素最多 3 个属性，多行元素每行 1 个属性。
+      'vue/max-attributes-per-line': ['error', {
+        singleline: 3,
+        multiline: 1
+      }],
+      // 允许单行 HTML 元素内容和标签写在同一行。
+      'vue/singleline-html-element-content-newline': 'off',
+      // 要求自定义事件名称使用 kebab-case。
+      'vue/custom-event-name-casing': ['error', 'kebab-case'],
+      // 禁止直接修改 props。
+      'vue/no-mutating-props': 'error',
+      // 要求组件名使用多个单词，但允许入口组件常用命名。
+      'vue/multi-word-component-names': ['error', {
+        ignores: ['index', 'Index', 'default', 'Default']
+      }],
+      // 要求模板中的 attribute 使用连字符命名。
+      'vue/attribute-hyphenation': ['error', 'always'],
+      // 要求 v-on 监听的自定义事件使用连字符命名。
+      'vue/v-on-event-hyphenation': ['error', 'always'],
+      // 要求模板中已注册组件使用 kebab-case 标签名。
+      'vue/component-name-in-template-casing': ['error', 'kebab-case', {
+        registeredComponentsOnly: true,
+        ignores: []
+      }],
+      // 约束 style 标签属性，允许普通 style 写法，违规时给出警告。
+      'vue/enforce-style-attribute': ['warn', {
+        allow: ['plain']
+      }],
+      // 禁止 Vue 组件导入名和同名 lower camel 本地变量冲突，避免模板组件被误识别为变量。
+      'polyv/no-vue-component-variable-name-conflict': 'error'
+    }
+  }
+];

package/index.mjs

@@ -0,0 +1,29 @@
+import common from './configs/common/index.mjs';
+import importx from './configs/importx/index.mjs';
+import js from './configs/js/index.mjs';
+import miniprogram from './configs/miniprogram/index.mjs';
+import prettier from './configs/prettier/index.mjs';
+import sonarjs from './configs/sonarjs/index.mjs';
+import ts from './configs/ts/index.mjs';
+import vue2 from './configs/vue2/index.mjs';
+import plugin, { rules } from './plugin.mjs';
+
+const configs = {
+  common,
+  importx,
+  js,
+  miniprogram,
+  prettier,
+  sonarjs,
+  ts,
+  vue2
+};
+
+export { configs, plugin };
+export { rules };
+
+export default {
+  configs,
+  plugin,
+  rules
+};