@polyv/eslint-config 0.3.0 → 0.6.0-beta.1

package/README.md

@@ -8,6 +8,24 @@
 npm install @polyv/eslint-config --save-dev
 ```
 
+此外，根据工程使用的技术栈，还需要安装以下依赖：
+
+| 依赖 | 纯 JS 工程 | 纯 TS 工程 | Vue.js 工程（JS） |
+| --- | --- | --- | --- |
+| eslint | √ | √ | √ |
+| eslint-plugin-import | √ | √ | √ |
+| eslint-plugin-node | √ | √ | √ |
+| eslint-plugin-promise | √ | √ | √ |
+| eslint-plugin-sonarjs | √ | √ | √ |
+| @babel/core | √ |  | √ |
+| @babel/eslint-parser | √ |  | √ |
+| typescript | | √ | |
+| @typescript-eslint/eslint-plugin | | √ | |
+| @typescript-eslint/parser | | √ |
+| eslint-plugin-vue | | | √ |
+| vue-eslint-parser | | | √ |
+| @vue/eslint-config-standard | | | √ |
+
 ### 调用配置
 
 创建 `.eslintrc.js`（一般在工程根目录下创建），并配置 `extends` 字段：
@@ -15,12 +33,11 @@ npm install @polyv/eslint-config --save-dev
 ```javascript
 /* eslint-env node */
 
-// TypeScript 工程的配置
+// 纯 JS 工程的配置
 module.exports = {
   root: true,
   extends: [
-    './node_modules/@polyv/eslint-config/lib/for-js',
-    './node_modules/@polyv/eslint-config/lib/for-ts'
+    './node_modules/@polyv/eslint-config/lib/for-js'
   ]
 };
 ```
@@ -28,24 +45,35 @@ module.exports = {
 ```javascript
 /* eslint-env node */
 
-// Vue.js 工程（不含 TypeScript）的配置
+// 纯 TS 工程的配置
 module.exports = {
   root: true,
   extends: [
-    './node_modules/@polyv/eslint-config/lib/for-vue'
+    './node_modules/@polyv/eslint-config/lib/for-js',
+    './node_modules/@polyv/eslint-config/lib/for-ts'
   ]
 };
 ```
 
-
 ```javascript
 /* eslint-env node */
 
-// JavaScript 工程的配置
+// Vue.js 工程（JS）的配置
 module.exports = {
   root: true,
   extends: [
-    './node_modules/@polyv/eslint-config/lib/for-js'
+    './node_modules/@polyv/eslint-config/lib/for-vue'
   ]
 };
-```
+```
+
+## devWarnProdError
+
+部分规则在 `NODE_ENV` 为 `production` 时，告警级别为错误，其他情况下为警告。这些规则包括：
+
+- no-debugger
+- no-unused-vars
+- no-constant-condition
+- no-empty
+- @typescript-eslint/no-unused-vars
+- @typescript-eslint/explicit-module-boundary-types

package/lib/for-js.js

@@ -23,13 +23,7 @@ module.exports = {
     'eslint:recommended',
     'plugin:sonarjs/recommended',
   ],
-  // add your custom rules here
   rules: {
-    // 调试
-    'no-console': [
-      devWarnProdError,
-      { 'allow': ['info', 'warn', 'error', 'time', 'timeEnd'] }
-    ],
     'no-debugger': devWarnProdError,
 
     // 基本
@@ -136,6 +130,7 @@ module.exports = {
     'sonarjs/cognitive-complexity': ['error', 18],
     'sonarjs/no-duplicate-string': ['error', 5],
     'sonarjs/prefer-single-boolean-return': 'off',
-    'sonarjs/no-collection-size-mischeck': 'off'
+    'sonarjs/no-collection-size-mischeck': 'off',
+    'sonarjs/no-nested-template-literals': 'warn'
   }
 };

package/lib/for-ts.js

@@ -26,6 +26,8 @@ module.exports = {
       }],
       '@typescript-eslint/comma-spacing': ['error'],
       '@typescript-eslint/no-duplicate-imports': ['error'],
+      '@typescript-eslint/no-empty-function': 'off',
+      '@typescript-eslint/no-empty-interface': 'off',
       '@typescript-eslint/type-annotation-spacing': ['error', {
         after: true,
         before: false,
@@ -46,7 +48,7 @@ module.exports = {
         'classes': false,
         'variables': true
       }],
-      '@typescript-eslint/explicit-module-boundary-types': ['error']
+      '@typescript-eslint/explicit-module-boundary-types': devWarnProdError
     }
   }]
 };

package/lib/for-vue.js

@@ -35,7 +35,9 @@ module.exports = Object.assign({}, jsConfig, {
     // 为兼容以前代码而设为 warn
     'vue/custom-event-name-casing': ['warn', 'kebab-case'],
     'vue/no-mutating-props': 'warn',
-    'vue/multi-word-component-names': 'warn',
+    'vue/multi-word-component-names': ['warn', {
+      ignores: ['index', 'Index']
+    }],
     'vue/attribute-hyphenation': ['warn', 'always'],
     'vue/v-on-event-hyphenation': ['warn', 'always']
   }

package/package.json

@@ -1,27 +1,42 @@
 {
   "name": "@polyv/eslint-config",
-  "version": "0.3.0",
-  "description": "Universal ESLint configuration for Polyv projects.",
+  "version": "0.6.0-beta.1",
+  "description": "Standard ESLint configuration for Polyv projects.",
+  "keywords": [
+    "polyv",
+    "eslint",
+    "config"
+  ],
+  "homepage": "https://www.polyv.net/",
   "license": "MIT",
-  "dependencies": {
-    "@babel/core": "^7.18.10",
-    "@babel/eslint-parser": "^7.18.9",
-    "@typescript-eslint/eslint-plugin": "^5.33.0",
-    "@typescript-eslint/parser": "^5.33.0",
-    "@vue/eslint-config-standard": "^6.1.0",
-    "eslint-plugin-import": "^2.26.0",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-promise": "^6.0.0",
-    "eslint-plugin-sonarjs": "^0.15.0",
-    "eslint-plugin-vue": "^9.3.0",
-    "vue-eslint-parser": "^9.0.2"
-  },
   "peerDependencies": {
+    "@babel/core": ">=7.19.0",
+    "@babel/eslint-parser": ">=7.19.0",
+    "@typescript-eslint/eslint-plugin": ">=5.0.0",
+    "@typescript-eslint/parser": ">=5.0.0",
+    "@vue/eslint-config-standard": ">=7.0.0",
     "eslint": ">=8.0.0",
-    "typescript": ">=4.0.0"
+    "eslint-plugin-import": ">=2.0.0",
+    "eslint-plugin-node": ">=11.1.0",
+    "eslint-plugin-promise": ">=6.1.0",
+    "eslint-plugin-sonarjs": ">=0.18.0",
+    "eslint-plugin-vue": ">=9.0.0",
+    "typescript": ">=4.0.0",
+    "vue-eslint-parser": ">=9.0.0"
   },
   "devDependencies": {
-    "eslint": "^8.21.0",
-    "typescript": "^4.7.4"
+    "@babel/core": "^7.21.4",
+    "@babel/eslint-parser": "^7.21.3",
+    "@typescript-eslint/eslint-plugin": "^5.59.1",
+    "@typescript-eslint/parser": "^5.59.1",
+    "@vue/eslint-config-standard": "^8.0.1",
+    "eslint": "^8.39.0",
+    "eslint-plugin-import": "^2.27.5",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-promise": "^6.1.1",
+    "eslint-plugin-sonarjs": "^0.19.0",
+    "eslint-plugin-vue": "^9.11.0",
+    "typescript": "^5.0.4",
+    "vue-eslint-parser": "^9.1.1"
   }
 }