eslint 9.21.0 → 9.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/README.md +52 -48
  2. package/bin/eslint.js +92 -90
  3. package/conf/default-cli-options.js +22 -22
  4. package/conf/ecma-version.js +1 -1
  5. package/conf/globals.js +97 -98
  6. package/conf/replacements.json +24 -20
  7. package/conf/rule-type-list.json +88 -92
  8. package/lib/api.js +12 -12
  9. package/lib/cli-engine/cli-engine.js +828 -808
  10. package/lib/cli-engine/file-enumerator.js +381 -387
  11. package/lib/cli-engine/formatters/formatters-meta.json +16 -16
  12. package/lib/cli-engine/formatters/html.js +107 -99
  13. package/lib/cli-engine/formatters/json-with-metadata.js +5 -5
  14. package/lib/cli-engine/formatters/json.js +2 -2
  15. package/lib/cli-engine/formatters/stylish.js +96 -75
  16. package/lib/cli-engine/hash.js +1 -1
  17. package/lib/cli-engine/index.js +1 -1
  18. package/lib/cli-engine/lint-result-cache.js +144 -145
  19. package/lib/cli-engine/load-rules.js +16 -16
  20. package/lib/cli.js +541 -457
  21. package/lib/config/config-loader.js +648 -618
  22. package/lib/config/config.js +247 -221
  23. package/lib/config/default-config.js +54 -45
  24. package/lib/config/flat-config-array.js +167 -172
  25. package/lib/config/flat-config-helpers.js +65 -68
  26. package/lib/config/flat-config-schema.js +375 -368
  27. package/lib/config/rule-validator.js +139 -144
  28. package/lib/config-api.js +12 -0
  29. package/lib/eslint/eslint-helpers.js +709 -679
  30. package/lib/eslint/eslint.js +944 -886
  31. package/lib/eslint/index.js +2 -2
  32. package/lib/eslint/legacy-eslint.js +576 -532
  33. package/lib/languages/js/index.js +263 -264
  34. package/lib/languages/js/source-code/index.js +1 -1
  35. package/lib/languages/js/source-code/source-code.js +1129 -1054
  36. package/lib/languages/js/source-code/token-store/backward-token-comment-cursor.js +39 -35
  37. package/lib/languages/js/source-code/token-store/backward-token-cursor.js +35 -36
  38. package/lib/languages/js/source-code/token-store/cursor.js +36 -36
  39. package/lib/languages/js/source-code/token-store/cursors.js +80 -52
  40. package/lib/languages/js/source-code/token-store/decorative-cursor.js +17 -18
  41. package/lib/languages/js/source-code/token-store/filter-cursor.js +19 -20
  42. package/lib/languages/js/source-code/token-store/forward-token-comment-cursor.js +40 -32
  43. package/lib/languages/js/source-code/token-store/forward-token-cursor.js +40 -41
  44. package/lib/languages/js/source-code/token-store/index.js +592 -498
  45. package/lib/languages/js/source-code/token-store/limit-cursor.js +17 -18
  46. package/lib/languages/js/source-code/token-store/padded-token-cursor.js +23 -16
  47. package/lib/languages/js/source-code/token-store/skip-cursor.js +19 -20
  48. package/lib/languages/js/source-code/token-store/utils.js +63 -60
  49. package/lib/languages/js/validate-language-options.js +104 -89
  50. package/lib/linter/apply-disable-directives.js +467 -383
  51. package/lib/linter/code-path-analysis/code-path-analyzer.js +650 -672
  52. package/lib/linter/code-path-analysis/code-path-segment.js +215 -216
  53. package/lib/linter/code-path-analysis/code-path-state.js +2118 -2096
  54. package/lib/linter/code-path-analysis/code-path.js +307 -319
  55. package/lib/linter/code-path-analysis/debug-helpers.js +183 -163
  56. package/lib/linter/code-path-analysis/fork-context.js +296 -271
  57. package/lib/linter/code-path-analysis/id-generator.js +22 -23
  58. package/lib/linter/file-context.js +119 -120
  59. package/lib/linter/index.js +3 -3
  60. package/lib/linter/interpolate.js +16 -16
  61. package/lib/linter/linter.js +2402 -2044
  62. package/lib/linter/node-event-generator.js +284 -225
  63. package/lib/linter/report-translator.js +256 -219
  64. package/lib/linter/rule-fixer.js +122 -124
  65. package/lib/linter/rules.js +35 -35
  66. package/lib/linter/safe-emitter.js +18 -18
  67. package/lib/linter/source-code-fixer.js +94 -92
  68. package/lib/linter/timing.js +104 -101
  69. package/lib/linter/vfile.js +70 -73
  70. package/lib/options.js +375 -361
  71. package/lib/rule-tester/index.js +1 -1
  72. package/lib/rule-tester/rule-tester.js +1307 -1045
  73. package/lib/rules/accessor-pairs.js +297 -262
  74. package/lib/rules/array-bracket-newline.js +249 -237
  75. package/lib/rules/array-bracket-spacing.js +262 -223
  76. package/lib/rules/array-callback-return.js +401 -355
  77. package/lib/rules/array-element-newline.js +357 -312
  78. package/lib/rules/arrow-body-style.js +399 -280
  79. package/lib/rules/arrow-parens.js +205 -172
  80. package/lib/rules/arrow-spacing.js +168 -162
  81. package/lib/rules/block-scoped-var.js +124 -122
  82. package/lib/rules/block-spacing.js +185 -175
  83. package/lib/rules/brace-style.js +261 -198
  84. package/lib/rules/callback-return.js +202 -189
  85. package/lib/rules/camelcase.js +402 -391
  86. package/lib/rules/capitalized-comments.js +252 -231
  87. package/lib/rules/class-methods-use-this.js +179 -171
  88. package/lib/rules/comma-dangle.js +378 -345
  89. package/lib/rules/comma-spacing.js +192 -194
  90. package/lib/rules/comma-style.js +374 -315
  91. package/lib/rules/complexity.js +172 -168
  92. package/lib/rules/computed-property-spacing.js +235 -210
  93. package/lib/rules/consistent-return.js +180 -169
  94. package/lib/rules/consistent-this.js +166 -146
  95. package/lib/rules/constructor-super.js +411 -403
  96. package/lib/rules/curly.js +406 -331
  97. package/lib/rules/default-case-last.js +37 -30
  98. package/lib/rules/default-case.js +88 -84
  99. package/lib/rules/default-param-last.js +68 -53
  100. package/lib/rules/dot-location.js +121 -109
  101. package/lib/rules/dot-notation.js +191 -155
  102. package/lib/rules/eol-last.js +121 -119
  103. package/lib/rules/eqeqeq.js +167 -154
  104. package/lib/rules/for-direction.js +145 -120
  105. package/lib/rules/func-call-spacing.js +260 -230
  106. package/lib/rules/func-name-matching.js +292 -208
  107. package/lib/rules/func-names.js +164 -163
  108. package/lib/rules/func-style.js +158 -126
  109. package/lib/rules/function-call-argument-newline.js +151 -128
  110. package/lib/rules/function-paren-newline.js +348 -290
  111. package/lib/rules/generator-star-spacing.js +228 -209
  112. package/lib/rules/getter-return.js +207 -171
  113. package/lib/rules/global-require.js +84 -73
  114. package/lib/rules/grouped-accessor-pairs.js +169 -149
  115. package/lib/rules/guard-for-in.js +71 -62
  116. package/lib/rules/handle-callback-err.js +107 -102
  117. package/lib/rules/id-blacklist.js +181 -198
  118. package/lib/rules/id-denylist.js +167 -186
  119. package/lib/rules/id-length.js +196 -170
  120. package/lib/rules/id-match.js +343 -288
  121. package/lib/rules/implicit-arrow-linebreak.js +101 -78
  122. package/lib/rules/indent-legacy.js +1343 -1117
  123. package/lib/rules/indent.js +2271 -1758
  124. package/lib/rules/index.js +317 -292
  125. package/lib/rules/init-declarations.js +115 -106
  126. package/lib/rules/jsx-quotes.js +93 -81
  127. package/lib/rules/key-spacing.js +749 -632
  128. package/lib/rules/keyword-spacing.js +647 -604
  129. package/lib/rules/line-comment-position.js +141 -127
  130. package/lib/rules/linebreak-style.js +106 -105
  131. package/lib/rules/lines-around-comment.js +539 -447
  132. package/lib/rules/lines-around-directive.js +232 -202
  133. package/lib/rules/lines-between-class-members.js +304 -233
  134. package/lib/rules/logical-assignment-operators.js +581 -398
  135. package/lib/rules/max-classes-per-file.js +68 -67
  136. package/lib/rules/max-depth.js +145 -142
  137. package/lib/rules/max-len.js +472 -433
  138. package/lib/rules/max-lines-per-function.js +200 -175
  139. package/lib/rules/max-lines.js +157 -161
  140. package/lib/rules/max-nested-callbacks.js +101 -103
  141. package/lib/rules/max-params.js +77 -75
  142. package/lib/rules/max-statements-per-line.js +204 -197
  143. package/lib/rules/max-statements.js +167 -163
  144. package/lib/rules/multiline-comment-style.js +636 -478
  145. package/lib/rules/multiline-ternary.js +240 -175
  146. package/lib/rules/new-cap.js +232 -212
  147. package/lib/rules/new-parens.js +87 -78
  148. package/lib/rules/newline-after-var.js +286 -249
  149. package/lib/rules/newline-before-return.js +228 -221
  150. package/lib/rules/newline-per-chained-call.js +141 -126
  151. package/lib/rules/no-alert.js +89 -78
  152. package/lib/rules/no-array-constructor.js +121 -112
  153. package/lib/rules/no-async-promise-executor.js +29 -23
  154. package/lib/rules/no-await-in-loop.js +68 -70
  155. package/lib/rules/no-bitwise.js +123 -99
  156. package/lib/rules/no-buffer-constructor.js +54 -46
  157. package/lib/rules/no-caller.js +38 -32
  158. package/lib/rules/no-case-declarations.js +60 -56
  159. package/lib/rules/no-catch-shadow.js +75 -72
  160. package/lib/rules/no-class-assign.js +50 -47
  161. package/lib/rules/no-compare-neg-zero.js +61 -47
  162. package/lib/rules/no-cond-assign.js +147 -131
  163. package/lib/rules/no-confusing-arrow.js +97 -80
  164. package/lib/rules/no-console.js +201 -190
  165. package/lib/rules/no-const-assign.js +46 -40
  166. package/lib/rules/no-constant-binary-expression.js +499 -404
  167. package/lib/rules/no-constant-condition.js +157 -142
  168. package/lib/rules/no-constructor-return.js +48 -48
  169. package/lib/rules/no-continue.js +24 -26
  170. package/lib/rules/no-control-regex.js +124 -120
  171. package/lib/rules/no-debugger.js +27 -29
  172. package/lib/rules/no-delete-var.js +28 -28
  173. package/lib/rules/no-div-regex.js +46 -40
  174. package/lib/rules/no-dupe-args.js +67 -68
  175. package/lib/rules/no-dupe-class-members.js +92 -88
  176. package/lib/rules/no-dupe-else-if.js +99 -76
  177. package/lib/rules/no-dupe-keys.js +132 -109
  178. package/lib/rules/no-duplicate-case.js +49 -42
  179. package/lib/rules/no-duplicate-imports.js +178 -175
  180. package/lib/rules/no-else-return.js +429 -384
  181. package/lib/rules/no-empty-character-class.js +56 -49
  182. package/lib/rules/no-empty-function.js +126 -127
  183. package/lib/rules/no-empty-pattern.js +62 -57
  184. package/lib/rules/no-empty-static-block.js +36 -34
  185. package/lib/rules/no-empty.js +97 -85
  186. package/lib/rules/no-eq-null.js +36 -31
  187. package/lib/rules/no-eval.js +255 -249
  188. package/lib/rules/no-ex-assign.js +41 -38
  189. package/lib/rules/no-extend-native.js +160 -158
  190. package/lib/rules/no-extra-bind.js +200 -189
  191. package/lib/rules/no-extra-boolean-cast.js +397 -347
  192. package/lib/rules/no-extra-label.js +149 -130
  193. package/lib/rules/no-extra-parens.js +1653 -1324
  194. package/lib/rules/no-extra-semi.js +145 -143
  195. package/lib/rules/no-fallthrough.js +198 -156
  196. package/lib/rules/no-floating-decimal.js +73 -65
  197. package/lib/rules/no-func-assign.js +53 -54
  198. package/lib/rules/no-global-assign.js +77 -72
  199. package/lib/rules/no-implicit-coercion.js +348 -292
  200. package/lib/rules/no-implicit-globals.js +157 -134
  201. package/lib/rules/no-implied-eval.js +139 -111
  202. package/lib/rules/no-import-assign.js +144 -158
  203. package/lib/rules/no-inline-comments.js +100 -94
  204. package/lib/rules/no-inner-declarations.js +114 -100
  205. package/lib/rules/no-invalid-regexp.js +221 -189
  206. package/lib/rules/no-invalid-this.js +122 -116
  207. package/lib/rules/no-irregular-whitespace.js +265 -251
  208. package/lib/rules/no-iterator.js +28 -32
  209. package/lib/rules/no-label-var.js +58 -61
  210. package/lib/rules/no-labels.js +137 -132
  211. package/lib/rules/no-lone-blocks.js +126 -122
  212. package/lib/rules/no-lonely-if.js +107 -76
  213. package/lib/rules/no-loop-func.js +233 -212
  214. package/lib/rules/no-loss-of-precision.js +215 -200
  215. package/lib/rules/no-magic-numbers.js +245 -217
  216. package/lib/rules/no-misleading-character-class.js +498 -445
  217. package/lib/rules/no-mixed-operators.js +187 -181
  218. package/lib/rules/no-mixed-requires.js +252 -239
  219. package/lib/rules/no-mixed-spaces-and-tabs.js +133 -120
  220. package/lib/rules/no-multi-assign.js +45 -43
  221. package/lib/rules/no-multi-spaces.js +162 -142
  222. package/lib/rules/no-multi-str.js +41 -40
  223. package/lib/rules/no-multiple-empty-lines.js +195 -157
  224. package/lib/rules/no-native-reassign.js +89 -84
  225. package/lib/rules/no-negated-condition.js +78 -74
  226. package/lib/rules/no-negated-in-lhs.js +44 -42
  227. package/lib/rules/no-nested-ternary.js +32 -31
  228. package/lib/rules/no-new-func.js +70 -61
  229. package/lib/rules/no-new-native-nonconstructor.js +42 -38
  230. package/lib/rules/no-new-object.js +47 -47
  231. package/lib/rules/no-new-require.js +47 -46
  232. package/lib/rules/no-new-symbol.js +51 -49
  233. package/lib/rules/no-new-wrappers.js +42 -40
  234. package/lib/rules/no-new.js +27 -28
  235. package/lib/rules/no-nonoctal-decimal-escape.js +140 -120
  236. package/lib/rules/no-obj-calls.js +65 -52
  237. package/lib/rules/no-object-constructor.js +103 -96
  238. package/lib/rules/no-octal-escape.js +39 -42
  239. package/lib/rules/no-octal.js +31 -31
  240. package/lib/rules/no-param-reassign.js +234 -216
  241. package/lib/rules/no-path-concat.js +65 -66
  242. package/lib/rules/no-plusplus.js +59 -60
  243. package/lib/rules/no-process-env.js +48 -47
  244. package/lib/rules/no-process-exit.js +53 -49
  245. package/lib/rules/no-promise-executor-return.js +213 -181
  246. package/lib/rules/no-proto.js +25 -28
  247. package/lib/rules/no-prototype-builtins.js +145 -123
  248. package/lib/rules/no-redeclare.js +153 -151
  249. package/lib/rules/no-regex-spaces.js +182 -160
  250. package/lib/rules/no-restricted-exports.js +207 -184
  251. package/lib/rules/no-restricted-globals.js +110 -111
  252. package/lib/rules/no-restricted-imports.js +656 -536
  253. package/lib/rules/no-restricted-modules.js +221 -201
  254. package/lib/rules/no-restricted-properties.js +180 -152
  255. package/lib/rules/no-restricted-syntax.js +55 -51
  256. package/lib/rules/no-return-assign.js +54 -49
  257. package/lib/rules/no-return-await.js +147 -123
  258. package/lib/rules/no-script-url.js +51 -44
  259. package/lib/rules/no-self-assign.js +147 -145
  260. package/lib/rules/no-self-compare.js +62 -45
  261. package/lib/rules/no-sequences.js +134 -115
  262. package/lib/rules/no-setter-return.js +184 -151
  263. package/lib/rules/no-shadow-restricted-names.js +60 -45
  264. package/lib/rules/no-shadow.js +341 -315
  265. package/lib/rules/no-spaced-func.js +81 -76
  266. package/lib/rules/no-sparse-arrays.js +53 -58
  267. package/lib/rules/no-sync.js +60 -59
  268. package/lib/rules/no-tabs.js +82 -71
  269. package/lib/rules/no-template-curly-in-string.js +32 -31
  270. package/lib/rules/no-ternary.js +24 -28
  271. package/lib/rules/no-this-before-super.js +320 -318
  272. package/lib/rules/no-throw-literal.js +30 -35
  273. package/lib/rules/no-trailing-spaces.js +198 -190
  274. package/lib/rules/no-undef-init.js +75 -60
  275. package/lib/rules/no-undef.js +50 -47
  276. package/lib/rules/no-undefined.js +72 -74
  277. package/lib/rules/no-underscore-dangle.js +369 -326
  278. package/lib/rules/no-unexpected-multiline.js +111 -101
  279. package/lib/rules/no-unmodified-loop-condition.js +253 -253
  280. package/lib/rules/no-unneeded-ternary.js +211 -146
  281. package/lib/rules/no-unreachable-loop.js +144 -141
  282. package/lib/rules/no-unreachable.js +254 -247
  283. package/lib/rules/no-unsafe-finally.js +92 -84
  284. package/lib/rules/no-unsafe-negation.js +104 -82
  285. package/lib/rules/no-unsafe-optional-chaining.js +191 -177
  286. package/lib/rules/no-unused-expressions.js +177 -161
  287. package/lib/rules/no-unused-labels.js +138 -123
  288. package/lib/rules/no-unused-private-class-members.js +205 -181
  289. package/lib/rules/no-unused-vars.js +1668 -1448
  290. package/lib/rules/no-use-before-define.js +228 -230
  291. package/lib/rules/no-useless-assignment.js +589 -510
  292. package/lib/rules/no-useless-backreference.js +211 -192
  293. package/lib/rules/no-useless-call.js +57 -52
  294. package/lib/rules/no-useless-catch.js +39 -39
  295. package/lib/rules/no-useless-computed-key.js +143 -114
  296. package/lib/rules/no-useless-concat.js +64 -59
  297. package/lib/rules/no-useless-constructor.js +157 -110
  298. package/lib/rules/no-useless-escape.js +341 -290
  299. package/lib/rules/no-useless-rename.js +182 -155
  300. package/lib/rules/no-useless-return.js +343 -311
  301. package/lib/rules/no-var.js +232 -211
  302. package/lib/rules/no-void.js +49 -47
  303. package/lib/rules/no-warning-comments.js +190 -185
  304. package/lib/rules/no-whitespace-before-property.js +130 -114
  305. package/lib/rules/no-with.js +23 -25
  306. package/lib/rules/nonblock-statement-body-position.js +148 -129
  307. package/lib/rules/object-curly-newline.js +305 -264
  308. package/lib/rules/object-curly-spacing.js +359 -313
  309. package/lib/rules/object-property-newline.js +136 -105
  310. package/lib/rules/object-shorthand.js +606 -501
  311. package/lib/rules/one-var-declaration-per-line.js +103 -99
  312. package/lib/rules/one-var.js +652 -536
  313. package/lib/rules/operator-assignment.js +218 -160
  314. package/lib/rules/operator-linebreak.js +294 -250
  315. package/lib/rules/padded-blocks.js +345 -307
  316. package/lib/rules/padding-line-between-statements.js +442 -438
  317. package/lib/rules/prefer-arrow-callback.js +361 -312
  318. package/lib/rules/prefer-const.js +417 -376
  319. package/lib/rules/prefer-destructuring.js +300 -278
  320. package/lib/rules/prefer-exponentiation-operator.js +175 -132
  321. package/lib/rules/prefer-named-capture-group.js +152 -139
  322. package/lib/rules/prefer-numeric-literals.js +120 -112
  323. package/lib/rules/prefer-object-has-own.js +115 -81
  324. package/lib/rules/prefer-object-spread.js +212 -192
  325. package/lib/rules/prefer-promise-reject-errors.js +139 -121
  326. package/lib/rules/prefer-reflect.js +126 -106
  327. package/lib/rules/prefer-regex-literals.js +577 -465
  328. package/lib/rules/prefer-rest-params.js +78 -79
  329. package/lib/rules/prefer-spread.js +46 -43
  330. package/lib/rules/prefer-template.js +265 -194
  331. package/lib/rules/quote-props.js +372 -306
  332. package/lib/rules/quotes.js +373 -325
  333. package/lib/rules/radix.js +151 -135
  334. package/lib/rules/require-atomic-updates.js +315 -284
  335. package/lib/rules/require-await.js +143 -115
  336. package/lib/rules/require-unicode-regexp.js +281 -176
  337. package/lib/rules/require-yield.js +52 -53
  338. package/lib/rules/rest-spread-spacing.js +127 -115
  339. package/lib/rules/semi-spacing.js +280 -249
  340. package/lib/rules/semi-style.js +175 -133
  341. package/lib/rules/semi.js +455 -435
  342. package/lib/rules/sort-imports.js +305 -232
  343. package/lib/rules/sort-keys.js +218 -187
  344. package/lib/rules/sort-vars.js +126 -92
  345. package/lib/rules/space-before-blocks.js +198 -188
  346. package/lib/rules/space-before-function-paren.js +185 -165
  347. package/lib/rules/space-in-parens.js +358 -287
  348. package/lib/rules/space-infix-ops.js +236 -200
  349. package/lib/rules/space-unary-ops.js +355 -297
  350. package/lib/rules/spaced-comment.js +362 -318
  351. package/lib/rules/strict.js +264 -229
  352. package/lib/rules/switch-colon-spacing.js +129 -121
  353. package/lib/rules/symbol-description.js +44 -47
  354. package/lib/rules/template-curly-spacing.js +147 -141
  355. package/lib/rules/template-tag-spacing.js +97 -87
  356. package/lib/rules/unicode-bom.js +53 -55
  357. package/lib/rules/use-isnan.js +236 -205
  358. package/lib/rules/utils/ast-utils.js +2039 -1860
  359. package/lib/rules/utils/char-source.js +162 -155
  360. package/lib/rules/utils/fix-tracker.js +83 -80
  361. package/lib/rules/utils/keywords.js +59 -59
  362. package/lib/rules/utils/lazy-loading-rule-map.js +79 -76
  363. package/lib/rules/utils/regular-expressions.js +32 -24
  364. package/lib/rules/utils/unicode/index.js +4 -4
  365. package/lib/rules/utils/unicode/is-combining-character.js +1 -1
  366. package/lib/rules/utils/unicode/is-emoji-modifier.js +1 -1
  367. package/lib/rules/utils/unicode/is-regional-indicator-symbol.js +1 -1
  368. package/lib/rules/utils/unicode/is-surrogate-pair.js +1 -1
  369. package/lib/rules/valid-typeof.js +152 -110
  370. package/lib/rules/vars-on-top.js +151 -144
  371. package/lib/rules/wrap-iife.js +203 -190
  372. package/lib/rules/wrap-regex.js +69 -57
  373. package/lib/rules/yield-star-spacing.js +144 -133
  374. package/lib/rules/yoda.js +282 -271
  375. package/lib/services/parser-service.js +35 -35
  376. package/lib/services/processor-service.js +66 -73
  377. package/lib/shared/ajv.js +14 -14
  378. package/lib/shared/assert.js +3 -4
  379. package/lib/shared/ast-utils.js +7 -6
  380. package/lib/shared/deep-merge-arrays.js +24 -22
  381. package/lib/shared/directives.js +3 -2
  382. package/lib/shared/flags.js +46 -17
  383. package/lib/shared/logging.js +24 -25
  384. package/lib/shared/option-utils.js +43 -36
  385. package/lib/shared/runtime-info.js +136 -127
  386. package/lib/shared/serialization.js +27 -27
  387. package/lib/shared/severity.js +22 -22
  388. package/lib/shared/stats.js +5 -5
  389. package/lib/shared/string-utils.js +16 -16
  390. package/lib/shared/text-table.js +28 -27
  391. package/lib/shared/traverser.js +153 -146
  392. package/lib/types/config-api.d.ts +8 -0
  393. package/lib/types/index.d.ts +2010 -1559
  394. package/lib/types/rules.d.ts +5312 -0
  395. package/lib/types/use-at-your-own-risk.d.ts +32 -30
  396. package/lib/unsupported-api.js +5 -5
  397. package/messages/all-files-ignored.js +3 -3
  398. package/messages/all-matched-files-ignored.js +3 -3
  399. package/messages/config-file-missing.js +2 -2
  400. package/messages/config-plugin-missing.js +3 -3
  401. package/messages/config-serialize-function.js +9 -7
  402. package/messages/eslintrc-incompat.js +13 -15
  403. package/messages/eslintrc-plugins.js +3 -4
  404. package/messages/extend-config-missing.js +3 -3
  405. package/messages/failed-to-read-json.js +3 -3
  406. package/messages/file-not-found.js +3 -3
  407. package/messages/invalid-rule-options.js +2 -2
  408. package/messages/invalid-rule-severity.js +2 -2
  409. package/messages/no-config-found.js +3 -3
  410. package/messages/plugin-conflict.js +8 -8
  411. package/messages/plugin-invalid.js +3 -3
  412. package/messages/plugin-missing.js +3 -3
  413. package/messages/print-config-with-directory-path.js +2 -2
  414. package/messages/shared.js +6 -1
  415. package/messages/whitespace-found.js +3 -3
  416. package/package.json +22 -20
  417. package/lib/types/rules/best-practices.d.ts +0 -1143
  418. package/lib/types/rules/deprecated.d.ts +0 -252
  419. package/lib/types/rules/ecmascript-6.d.ts +0 -647
  420. package/lib/types/rules/index.d.ts +0 -50
  421. package/lib/types/rules/node-commonjs.d.ts +0 -171
  422. package/lib/types/rules/possible-errors.d.ts +0 -685
  423. package/lib/types/rules/strict-mode.d.ts +0 -38
  424. package/lib/types/rules/stylistic-issues.d.ts +0 -2043
  425. package/lib/types/rules/variables.d.ts +0 -234
@@ -20,9 +20,7 @@
20
20
 
21
21
  const escapeRegExp = require("escape-string-regexp");
22
22
  const {
23
- Legacy: {
24
- ConfigOps
25
- }
23
+ Legacy: { ConfigOps },
26
24
  } = require("@eslint/eslintrc/universal");
27
25
 
28
26
  /**
@@ -33,7 +31,7 @@ const {
33
31
  * itemA appears after itemB in the source file, or 0 if itemA and itemB have the same location.
34
32
  */
35
33
  function compareLocations(itemA, itemB) {
36
- return itemA.line - itemB.line || itemA.column - itemB.column;
34
+ return itemA.line - itemB.line || itemA.column - itemB.column;
37
35
  }
38
36
 
39
37
  /**
@@ -42,19 +40,21 @@ function compareLocations(itemA, itemB) {
42
40
  * @returns {Directive[][]} Directives grouped by their parent comment.
43
41
  */
44
42
  function groupByParentDirective(directives) {
45
- const groups = new Map();
43
+ const groups = new Map();
46
44
 
47
- for (const directive of directives) {
48
- const { unprocessedDirective: { parentDirective } } = directive;
45
+ for (const directive of directives) {
46
+ const {
47
+ unprocessedDirective: { parentDirective },
48
+ } = directive;
49
49
 
50
- if (groups.has(parentDirective)) {
51
- groups.get(parentDirective).push(directive);
52
- } else {
53
- groups.set(parentDirective, [directive]);
54
- }
55
- }
50
+ if (groups.has(parentDirective)) {
51
+ groups.get(parentDirective).push(directive);
52
+ } else {
53
+ groups.set(parentDirective, [directive]);
54
+ }
55
+ }
56
56
 
57
- return [...groups.values()];
57
+ return [...groups.values()];
58
58
  }
59
59
 
60
60
  /**
@@ -64,93 +64,96 @@ function groupByParentDirective(directives) {
64
64
  * @param {SourceCode} sourceCode The source code object for the file being linted.
65
65
  * @returns {{ description, fix, unprocessedDirective }[]} Details for later creation of output Problems.
66
66
  */
67
- function createIndividualDirectivesRemoval(directives, parentDirective, sourceCode) {
68
-
69
- /*
70
- * Get the list of the rules text without any surrounding whitespace. In order to preserve the original
71
- * formatting, we don't want to change that whitespace.
72
- *
73
- * // eslint-disable-line rule-one , rule-two , rule-three -- comment
74
- * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
75
- */
76
- const listText = parentDirective.value.trim();
77
-
78
- // Calculate where it starts in the source code text
79
- const listStart = sourceCode.text.indexOf(listText, sourceCode.getRange(parentDirective.node)[0]);
80
-
81
- /*
82
- * We can assume that `listText` contains multiple elements.
83
- * Otherwise, this function wouldn't be called - if there is
84
- * only one rule in the list, then the whole comment must be removed.
85
- */
86
-
87
- return directives.map(directive => {
88
- const { ruleId } = directive;
89
-
90
- const regex = new RegExp(String.raw`(?:^|\s*,\s*)(?<quote>['"]?)${escapeRegExp(ruleId)}\k<quote>(?:\s*,\s*|$)`, "u");
91
- const match = regex.exec(listText);
92
- const matchedText = match[0];
93
- const matchStart = listStart + match.index;
94
- const matchEnd = matchStart + matchedText.length;
95
-
96
- const firstIndexOfComma = matchedText.indexOf(",");
97
- const lastIndexOfComma = matchedText.lastIndexOf(",");
98
-
99
- let removalStart, removalEnd;
100
-
101
- if (firstIndexOfComma !== lastIndexOfComma) {
102
-
103
- /*
104
- * Since there are two commas, this must one of the elements in the middle of the list.
105
- * Matched range starts where the previous rule name ends, and ends where the next rule name starts.
106
- *
107
- * // eslint-disable-line rule-one , rule-two , rule-three -- comment
108
- * ^^^^^^^^^^^^^^
109
- *
110
- * We want to remove only the content between the two commas, and also one of the commas.
111
- *
112
- * // eslint-disable-line rule-one , rule-two , rule-three -- comment
113
- * ^^^^^^^^^^^
114
- */
115
- removalStart = matchStart + firstIndexOfComma;
116
- removalEnd = matchStart + lastIndexOfComma;
117
-
118
- } else {
119
-
120
- /*
121
- * This is either the first element or the last element.
122
- *
123
- * If this is the first element, matched range starts where the first rule name starts
124
- * and ends where the second rule name starts. This is exactly the range we want
125
- * to remove so that the second rule name will start where the first one was starting
126
- * and thus preserve the original formatting.
127
- *
128
- * // eslint-disable-line rule-one , rule-two , rule-three -- comment
129
- * ^^^^^^^^^^^
130
- *
131
- * Similarly, if this is the last element, we've already matched the range we want to
132
- * remove. The previous rule name will end where the last one was ending, relative
133
- * to the content on the right side.
134
- *
135
- * // eslint-disable-line rule-one , rule-two , rule-three -- comment
136
- * ^^^^^^^^^^^^^
137
- */
138
- removalStart = matchStart;
139
- removalEnd = matchEnd;
140
- }
141
-
142
- return {
143
- description: `'${ruleId}'`,
144
- fix: {
145
- range: [
146
- removalStart,
147
- removalEnd
148
- ],
149
- text: ""
150
- },
151
- unprocessedDirective: directive.unprocessedDirective
152
- };
153
- });
67
+ function createIndividualDirectivesRemoval(
68
+ directives,
69
+ parentDirective,
70
+ sourceCode,
71
+ ) {
72
+ /*
73
+ * Get the list of the rules text without any surrounding whitespace. In order to preserve the original
74
+ * formatting, we don't want to change that whitespace.
75
+ *
76
+ * // eslint-disable-line rule-one , rule-two , rule-three -- comment
77
+ * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
78
+ */
79
+ const listText = parentDirective.value.trim();
80
+
81
+ // Calculate where it starts in the source code text
82
+ const listStart = sourceCode.text.indexOf(
83
+ listText,
84
+ sourceCode.getRange(parentDirective.node)[0],
85
+ );
86
+
87
+ /*
88
+ * We can assume that `listText` contains multiple elements.
89
+ * Otherwise, this function wouldn't be called - if there is
90
+ * only one rule in the list, then the whole comment must be removed.
91
+ */
92
+
93
+ return directives.map(directive => {
94
+ const { ruleId } = directive;
95
+
96
+ const regex = new RegExp(
97
+ String.raw`(?:^|\s*,\s*)(?<quote>['"]?)${escapeRegExp(ruleId)}\k<quote>(?:\s*,\s*|$)`,
98
+ "u",
99
+ );
100
+ const match = regex.exec(listText);
101
+ const matchedText = match[0];
102
+ const matchStart = listStart + match.index;
103
+ const matchEnd = matchStart + matchedText.length;
104
+
105
+ const firstIndexOfComma = matchedText.indexOf(",");
106
+ const lastIndexOfComma = matchedText.lastIndexOf(",");
107
+
108
+ let removalStart, removalEnd;
109
+
110
+ if (firstIndexOfComma !== lastIndexOfComma) {
111
+ /*
112
+ * Since there are two commas, this must one of the elements in the middle of the list.
113
+ * Matched range starts where the previous rule name ends, and ends where the next rule name starts.
114
+ *
115
+ * // eslint-disable-line rule-one , rule-two , rule-three -- comment
116
+ * ^^^^^^^^^^^^^^
117
+ *
118
+ * We want to remove only the content between the two commas, and also one of the commas.
119
+ *
120
+ * // eslint-disable-line rule-one , rule-two , rule-three -- comment
121
+ * ^^^^^^^^^^^
122
+ */
123
+ removalStart = matchStart + firstIndexOfComma;
124
+ removalEnd = matchStart + lastIndexOfComma;
125
+ } else {
126
+ /*
127
+ * This is either the first element or the last element.
128
+ *
129
+ * If this is the first element, matched range starts where the first rule name starts
130
+ * and ends where the second rule name starts. This is exactly the range we want
131
+ * to remove so that the second rule name will start where the first one was starting
132
+ * and thus preserve the original formatting.
133
+ *
134
+ * // eslint-disable-line rule-one , rule-two , rule-three -- comment
135
+ * ^^^^^^^^^^^
136
+ *
137
+ * Similarly, if this is the last element, we've already matched the range we want to
138
+ * remove. The previous rule name will end where the last one was ending, relative
139
+ * to the content on the right side.
140
+ *
141
+ * // eslint-disable-line rule-one , rule-two , rule-three -- comment
142
+ * ^^^^^^^^^^^^^
143
+ */
144
+ removalStart = matchStart;
145
+ removalEnd = matchEnd;
146
+ }
147
+
148
+ return {
149
+ description: `'${ruleId}'`,
150
+ fix: {
151
+ range: [removalStart, removalEnd],
152
+ text: "",
153
+ },
154
+ unprocessedDirective: directive.unprocessedDirective,
155
+ };
156
+ });
154
157
  }
155
158
 
156
159
  /**
@@ -161,19 +164,22 @@ function createIndividualDirectivesRemoval(directives, parentDirective, sourceCo
161
164
  * @returns {{ description, fix, unprocessedDirective }} Details for later creation of an output problem.
162
165
  */
163
166
  function createDirectiveRemoval(directives, node, sourceCode) {
164
- const range = sourceCode.getRange(node);
165
- const ruleIds = directives.filter(directive => directive.ruleId).map(directive => `'${directive.ruleId}'`);
166
-
167
- return {
168
- description: ruleIds.length <= 2
169
- ? ruleIds.join(" or ")
170
- : `${ruleIds.slice(0, ruleIds.length - 1).join(", ")}, or ${ruleIds.at(-1)}`,
171
- fix: {
172
- range,
173
- text: " "
174
- },
175
- unprocessedDirective: directives[0].unprocessedDirective
176
- };
167
+ const range = sourceCode.getRange(node);
168
+ const ruleIds = directives
169
+ .filter(directive => directive.ruleId)
170
+ .map(directive => `'${directive.ruleId}'`);
171
+
172
+ return {
173
+ description:
174
+ ruleIds.length <= 2
175
+ ? ruleIds.join(" or ")
176
+ : `${ruleIds.slice(0, ruleIds.length - 1).join(", ")}, or ${ruleIds.at(-1)}`,
177
+ fix: {
178
+ range,
179
+ text: " ",
180
+ },
181
+ unprocessedDirective: directives[0].unprocessedDirective,
182
+ };
177
183
  }
178
184
 
179
185
  /**
@@ -183,22 +189,30 @@ function createDirectiveRemoval(directives, node, sourceCode) {
183
189
  * @returns {{ description, fix, unprocessedDirective }[]} Details for later creation of output Problems.
184
190
  */
185
191
  function processUnusedDirectives(allDirectives, sourceCode) {
186
- const directiveGroups = groupByParentDirective(allDirectives);
187
-
188
- return directiveGroups.flatMap(
189
- directives => {
190
- const { parentDirective } = directives[0].unprocessedDirective;
191
- const remainingRuleIds = new Set(parentDirective.ruleIds);
192
-
193
- for (const directive of directives) {
194
- remainingRuleIds.delete(directive.ruleId);
195
- }
196
-
197
- return remainingRuleIds.size
198
- ? createIndividualDirectivesRemoval(directives, parentDirective, sourceCode)
199
- : [createDirectiveRemoval(directives, parentDirective.node, sourceCode)];
200
- }
201
- );
192
+ const directiveGroups = groupByParentDirective(allDirectives);
193
+
194
+ return directiveGroups.flatMap(directives => {
195
+ const { parentDirective } = directives[0].unprocessedDirective;
196
+ const remainingRuleIds = new Set(parentDirective.ruleIds);
197
+
198
+ for (const directive of directives) {
199
+ remainingRuleIds.delete(directive.ruleId);
200
+ }
201
+
202
+ return remainingRuleIds.size
203
+ ? createIndividualDirectivesRemoval(
204
+ directives,
205
+ parentDirective,
206
+ sourceCode,
207
+ )
208
+ : [
209
+ createDirectiveRemoval(
210
+ directives,
211
+ parentDirective.node,
212
+ sourceCode,
213
+ ),
214
+ ];
215
+ });
202
216
  }
203
217
 
204
218
  /**
@@ -207,87 +221,83 @@ function processUnusedDirectives(allDirectives, sourceCode) {
207
221
  * @returns {Set<Directive>} The used eslint-enable comments
208
222
  */
209
223
  function collectUsedEnableDirectives(directives) {
210
-
211
- /**
212
- * A Map of `eslint-enable` keyed by ruleIds that may be marked as used.
213
- * If `eslint-enable` does not have a ruleId, the key will be `null`.
214
- * @type {Map<string|null, Directive>}
215
- */
216
- const enabledRules = new Map();
217
-
218
- /**
219
- * A Set of `eslint-enable` marked as used.
220
- * It is also the return value of `collectUsedEnableDirectives` function.
221
- * @type {Set<Directive>}
222
- */
223
- const usedEnableDirectives = new Set();
224
-
225
- /*
226
- * Checks the directives backwards to see if the encountered `eslint-enable` is used by the previous `eslint-disable`,
227
- * and if so, stores the `eslint-enable` in `usedEnableDirectives`.
228
- */
229
- for (let index = directives.length - 1; index >= 0; index--) {
230
- const directive = directives[index];
231
-
232
- if (directive.type === "disable") {
233
- if (enabledRules.size === 0) {
234
- continue;
235
- }
236
- if (directive.ruleId === null) {
237
-
238
- // If encounter `eslint-disable` without ruleId,
239
- // mark all `eslint-enable` currently held in enabledRules as used.
240
- // e.g.
241
- // /* eslint-disable */ <- current directive
242
- // /* eslint-enable rule-id1 */ <- used
243
- // /* eslint-enable rule-id2 */ <- used
244
- // /* eslint-enable */ <- used
245
- for (const enableDirective of enabledRules.values()) {
246
- usedEnableDirectives.add(enableDirective);
247
- }
248
- enabledRules.clear();
249
- } else {
250
- const enableDirective = enabledRules.get(directive.ruleId);
251
-
252
- if (enableDirective) {
253
-
254
- // If encounter `eslint-disable` with ruleId, and there is an `eslint-enable` with the same ruleId in enabledRules,
255
- // mark `eslint-enable` with ruleId as used.
256
- // e.g.
257
- // /* eslint-disable rule-id */ <- current directive
258
- // /* eslint-enable rule-id */ <- used
259
- usedEnableDirectives.add(enableDirective);
260
- } else {
261
- const enabledDirectiveWithoutRuleId = enabledRules.get(null);
262
-
263
- if (enabledDirectiveWithoutRuleId) {
264
-
265
- // If encounter `eslint-disable` with ruleId, and there is no `eslint-enable` with the same ruleId in enabledRules,
266
- // mark `eslint-enable` without ruleId as used.
267
- // e.g.
268
- // /* eslint-disable rule-id */ <- current directive
269
- // /* eslint-enable */ <- used
270
- usedEnableDirectives.add(enabledDirectiveWithoutRuleId);
271
- }
272
- }
273
- }
274
- } else if (directive.type === "enable") {
275
- if (directive.ruleId === null) {
276
-
277
- // If encounter `eslint-enable` without ruleId, the `eslint-enable` that follows it are unused.
278
- // So clear enabledRules.
279
- // e.g.
280
- // /* eslint-enable */ <- current directive
281
- // /* eslint-enable rule-id *// <- unused
282
- // /* eslint-enable */ <- unused
283
- enabledRules.clear();
284
- enabledRules.set(null, directive);
285
- } else {
286
- enabledRules.set(directive.ruleId, directive);
287
- }
288
- }
289
- }
290
- return usedEnableDirectives;
224
+ /**
225
+ * A Map of `eslint-enable` keyed by ruleIds that may be marked as used.
226
+ * If `eslint-enable` does not have a ruleId, the key will be `null`.
227
+ * @type {Map<string|null, Directive>}
228
+ */
229
+ const enabledRules = new Map();
230
+
231
+ /**
232
+ * A Set of `eslint-enable` marked as used.
233
+ * It is also the return value of `collectUsedEnableDirectives` function.
234
+ * @type {Set<Directive>}
235
+ */
236
+ const usedEnableDirectives = new Set();
237
+
238
+ /*
239
+ * Checks the directives backwards to see if the encountered `eslint-enable` is used by the previous `eslint-disable`,
240
+ * and if so, stores the `eslint-enable` in `usedEnableDirectives`.
241
+ */
242
+ for (let index = directives.length - 1; index >= 0; index--) {
243
+ const directive = directives[index];
244
+
245
+ if (directive.type === "disable") {
246
+ if (enabledRules.size === 0) {
247
+ continue;
248
+ }
249
+ if (directive.ruleId === null) {
250
+ // If encounter `eslint-disable` without ruleId,
251
+ // mark all `eslint-enable` currently held in enabledRules as used.
252
+ // e.g.
253
+ // /* eslint-disable */ <- current directive
254
+ // /* eslint-enable rule-id1 */ <- used
255
+ // /* eslint-enable rule-id2 */ <- used
256
+ // /* eslint-enable */ <- used
257
+ for (const enableDirective of enabledRules.values()) {
258
+ usedEnableDirectives.add(enableDirective);
259
+ }
260
+ enabledRules.clear();
261
+ } else {
262
+ const enableDirective = enabledRules.get(directive.ruleId);
263
+
264
+ if (enableDirective) {
265
+ // If encounter `eslint-disable` with ruleId, and there is an `eslint-enable` with the same ruleId in enabledRules,
266
+ // mark `eslint-enable` with ruleId as used.
267
+ // e.g.
268
+ // /* eslint-disable rule-id */ <- current directive
269
+ // /* eslint-enable rule-id */ <- used
270
+ usedEnableDirectives.add(enableDirective);
271
+ } else {
272
+ const enabledDirectiveWithoutRuleId =
273
+ enabledRules.get(null);
274
+
275
+ if (enabledDirectiveWithoutRuleId) {
276
+ // If encounter `eslint-disable` with ruleId, and there is no `eslint-enable` with the same ruleId in enabledRules,
277
+ // mark `eslint-enable` without ruleId as used.
278
+ // e.g.
279
+ // /* eslint-disable rule-id */ <- current directive
280
+ // /* eslint-enable */ <- used
281
+ usedEnableDirectives.add(enabledDirectiveWithoutRuleId);
282
+ }
283
+ }
284
+ }
285
+ } else if (directive.type === "enable") {
286
+ if (directive.ruleId === null) {
287
+ // If encounter `eslint-enable` without ruleId, the `eslint-enable` that follows it are unused.
288
+ // So clear enabledRules.
289
+ // e.g.
290
+ // /* eslint-enable */ <- current directive
291
+ // /* eslint-enable rule-id *// <- unused
292
+ // /* eslint-enable */ <- unused
293
+ enabledRules.clear();
294
+ enabledRules.set(null, directive);
295
+ } else {
296
+ enabledRules.set(directive.ruleId, directive);
297
+ }
298
+ }
299
+ }
300
+ return usedEnableDirectives;
291
301
  }
292
302
 
293
303
  /**
@@ -301,105 +311,132 @@ function collectUsedEnableDirectives(directives) {
301
311
  * of problems (including suppressed ones) and unused eslint-disable directives
302
312
  */
303
313
  function applyDirectives(options) {
304
- const problems = [];
305
- const usedDisableDirectives = new Set();
306
- const { sourceCode } = options;
307
-
308
- for (const problem of options.problems) {
309
- let disableDirectivesForProblem = [];
310
- let nextDirectiveIndex = 0;
311
-
312
- while (
313
- nextDirectiveIndex < options.directives.length &&
314
- compareLocations(options.directives[nextDirectiveIndex], problem) <= 0
315
- ) {
316
- const directive = options.directives[nextDirectiveIndex++];
317
-
318
- if (directive.ruleId === null || directive.ruleId === problem.ruleId) {
319
- switch (directive.type) {
320
- case "disable":
321
- disableDirectivesForProblem.push(directive);
322
- break;
323
-
324
- case "enable":
325
- disableDirectivesForProblem = [];
326
- break;
327
-
328
- // no default
329
- }
330
- }
331
- }
332
-
333
- if (disableDirectivesForProblem.length > 0) {
334
- const suppressions = disableDirectivesForProblem.map(directive => ({
335
- kind: "directive",
336
- justification: directive.unprocessedDirective.justification
337
- }));
338
-
339
- if (problem.suppressions) {
340
- problem.suppressions = problem.suppressions.concat(suppressions);
341
- } else {
342
- problem.suppressions = suppressions;
343
- usedDisableDirectives.add(disableDirectivesForProblem.at(-1));
344
- }
345
- }
346
-
347
- problems.push(problem);
348
- }
349
-
350
- const unusedDisableDirectivesToReport = options.directives
351
- .filter(directive => directive.type === "disable" && !usedDisableDirectives.has(directive) && !options.rulesToIgnore.has(directive.ruleId));
352
-
353
-
354
- const unusedEnableDirectivesToReport = new Set(
355
- options.directives.filter(directive => directive.unprocessedDirective.type === "enable" && !options.rulesToIgnore.has(directive.ruleId))
356
- );
357
-
358
- /*
359
- * If directives has the eslint-enable directive,
360
- * check whether the eslint-enable comment is used.
361
- */
362
- if (unusedEnableDirectivesToReport.size > 0) {
363
- for (const directive of collectUsedEnableDirectives(options.directives)) {
364
- unusedEnableDirectivesToReport.delete(directive);
365
- }
366
- }
367
-
368
- const processed = processUnusedDirectives(unusedDisableDirectivesToReport, sourceCode)
369
- .concat(processUnusedDirectives(unusedEnableDirectivesToReport, sourceCode));
370
- const columnOffset = options.language.columnStart === 1 ? 0 : 1;
371
- const lineOffset = options.language.lineStart === 1 ? 0 : 1;
372
-
373
- const unusedDirectives = processed
374
- .map(({ description, fix, unprocessedDirective }) => {
375
- const { parentDirective, type, line, column } = unprocessedDirective;
376
-
377
- let message;
378
-
379
- if (type === "enable") {
380
- message = description
381
- ? `Unused eslint-enable directive (no matching eslint-disable directives were found for ${description}).`
382
- : "Unused eslint-enable directive (no matching eslint-disable directives were found).";
383
- } else {
384
- message = description
385
- ? `Unused eslint-disable directive (no problems were reported from ${description}).`
386
- : "Unused eslint-disable directive (no problems were reported).";
387
- }
388
-
389
- const loc = sourceCode.getLoc(parentDirective.node);
390
-
391
- return {
392
- ruleId: null,
393
- message,
394
- line: type === "disable-next-line" ? loc.start.line + lineOffset : line,
395
- column: type === "disable-next-line" ? loc.start.column + columnOffset : column,
396
- severity: options.reportUnusedDisableDirectives === "warn" ? 1 : 2,
397
- nodeType: null,
398
- ...options.disableFixes ? {} : { fix }
399
- };
400
- });
401
-
402
- return { problems, unusedDirectives };
314
+ const problems = [];
315
+ const usedDisableDirectives = new Set();
316
+ const { sourceCode } = options;
317
+
318
+ for (const problem of options.problems) {
319
+ let disableDirectivesForProblem = [];
320
+ let nextDirectiveIndex = 0;
321
+
322
+ while (
323
+ nextDirectiveIndex < options.directives.length &&
324
+ compareLocations(options.directives[nextDirectiveIndex], problem) <=
325
+ 0
326
+ ) {
327
+ const directive = options.directives[nextDirectiveIndex++];
328
+
329
+ if (
330
+ directive.ruleId === null ||
331
+ directive.ruleId === problem.ruleId
332
+ ) {
333
+ switch (directive.type) {
334
+ case "disable":
335
+ disableDirectivesForProblem.push(directive);
336
+ break;
337
+
338
+ case "enable":
339
+ disableDirectivesForProblem = [];
340
+ break;
341
+
342
+ // no default
343
+ }
344
+ }
345
+ }
346
+
347
+ if (disableDirectivesForProblem.length > 0) {
348
+ const suppressions = disableDirectivesForProblem.map(directive => ({
349
+ kind: "directive",
350
+ justification: directive.unprocessedDirective.justification,
351
+ }));
352
+
353
+ if (problem.suppressions) {
354
+ problem.suppressions =
355
+ problem.suppressions.concat(suppressions);
356
+ } else {
357
+ problem.suppressions = suppressions;
358
+ usedDisableDirectives.add(disableDirectivesForProblem.at(-1));
359
+ }
360
+ }
361
+
362
+ problems.push(problem);
363
+ }
364
+
365
+ const unusedDisableDirectivesToReport = options.directives.filter(
366
+ directive =>
367
+ directive.type === "disable" &&
368
+ !usedDisableDirectives.has(directive) &&
369
+ !options.rulesToIgnore.has(directive.ruleId),
370
+ );
371
+
372
+ const unusedEnableDirectivesToReport = new Set(
373
+ options.directives.filter(
374
+ directive =>
375
+ directive.unprocessedDirective.type === "enable" &&
376
+ !options.rulesToIgnore.has(directive.ruleId),
377
+ ),
378
+ );
379
+
380
+ /*
381
+ * If directives has the eslint-enable directive,
382
+ * check whether the eslint-enable comment is used.
383
+ */
384
+ if (unusedEnableDirectivesToReport.size > 0) {
385
+ for (const directive of collectUsedEnableDirectives(
386
+ options.directives,
387
+ )) {
388
+ unusedEnableDirectivesToReport.delete(directive);
389
+ }
390
+ }
391
+
392
+ const processed = processUnusedDirectives(
393
+ unusedDisableDirectivesToReport,
394
+ sourceCode,
395
+ ).concat(
396
+ processUnusedDirectives(unusedEnableDirectivesToReport, sourceCode),
397
+ );
398
+ const columnOffset = options.language.columnStart === 1 ? 0 : 1;
399
+ const lineOffset = options.language.lineStart === 1 ? 0 : 1;
400
+
401
+ const unusedDirectives = processed.map(
402
+ ({ description, fix, unprocessedDirective }) => {
403
+ const { parentDirective, type, line, column } =
404
+ unprocessedDirective;
405
+
406
+ let message;
407
+
408
+ if (type === "enable") {
409
+ message = description
410
+ ? `Unused eslint-enable directive (no matching eslint-disable directives were found for ${description}).`
411
+ : "Unused eslint-enable directive (no matching eslint-disable directives were found).";
412
+ } else {
413
+ message = description
414
+ ? `Unused eslint-disable directive (no problems were reported from ${description}).`
415
+ : "Unused eslint-disable directive (no problems were reported).";
416
+ }
417
+
418
+ const loc = sourceCode.getLoc(parentDirective.node);
419
+
420
+ return {
421
+ ruleId: null,
422
+ message,
423
+ line:
424
+ type === "disable-next-line"
425
+ ? loc.start.line + lineOffset
426
+ : line,
427
+ column:
428
+ type === "disable-next-line"
429
+ ? loc.start.column + columnOffset
430
+ : column,
431
+ severity:
432
+ options.reportUnusedDisableDirectives === "warn" ? 1 : 2,
433
+ nodeType: null,
434
+ ...(options.disableFixes ? {} : { fix }),
435
+ };
436
+ },
437
+ );
438
+
439
+ return { problems, unusedDirectives };
403
440
  }
404
441
 
405
442
  /**
@@ -426,77 +463,124 @@ function applyDirectives(options) {
426
463
  * @returns {{ruleId: (string|null), line: number, column: number, suppressions?: {kind: string, justification: string}}[]}
427
464
  * An object with a list of reported problems, the suppressed of which contain the suppression information.
428
465
  */
429
- module.exports = ({ language, sourceCode, directives, disableFixes, problems, configuredRules, ruleFilter, reportUnusedDisableDirectives = "off" }) => {
430
- const blockDirectives = directives
431
- .filter(directive => directive.type === "disable" || directive.type === "enable")
432
- .map(directive => Object.assign({}, directive, { unprocessedDirective: directive }))
433
- .sort(compareLocations);
434
-
435
- const lineDirectives = directives.flatMap(directive => {
436
- switch (directive.type) {
437
- case "disable":
438
- case "enable":
439
- return [];
440
-
441
- case "disable-line":
442
- return [
443
- { type: "disable", line: directive.line, column: 1, ruleId: directive.ruleId, unprocessedDirective: directive },
444
- { type: "enable", line: directive.line + 1, column: 0, ruleId: directive.ruleId, unprocessedDirective: directive }
445
- ];
446
-
447
- case "disable-next-line":
448
- return [
449
- { type: "disable", line: directive.line + 1, column: 1, ruleId: directive.ruleId, unprocessedDirective: directive },
450
- { type: "enable", line: directive.line + 2, column: 0, ruleId: directive.ruleId, unprocessedDirective: directive }
451
- ];
452
-
453
- default:
454
- throw new TypeError(`Unrecognized directive type '${directive.type}'`);
455
- }
456
- }).sort(compareLocations);
457
-
458
- // This determines a list of rules that are not being run by the given ruleFilter, if present.
459
- const rulesToIgnore = configuredRules && ruleFilter
460
- ? new Set(Object.keys(configuredRules).filter(ruleId => {
461
- const severity = ConfigOps.getRuleSeverity(configuredRules[ruleId]);
462
-
463
- // Ignore for disabled rules.
464
- if (severity === 0) {
465
- return false;
466
- }
467
-
468
- return !ruleFilter({ severity, ruleId });
469
- }))
470
- : new Set();
471
-
472
- // If no ruleId is supplied that means this directive is applied to all rules, so we can't determine if it's unused if any rules are filtered out.
473
- if (rulesToIgnore.size > 0) {
474
- rulesToIgnore.add(null);
475
- }
476
-
477
- const blockDirectivesResult = applyDirectives({
478
- language,
479
- sourceCode,
480
- problems,
481
- directives: blockDirectives,
482
- disableFixes,
483
- reportUnusedDisableDirectives,
484
- rulesToIgnore
485
- });
486
- const lineDirectivesResult = applyDirectives({
487
- language,
488
- sourceCode,
489
- problems: blockDirectivesResult.problems,
490
- directives: lineDirectives,
491
- disableFixes,
492
- reportUnusedDisableDirectives,
493
- rulesToIgnore
494
- });
495
-
496
- return reportUnusedDisableDirectives !== "off"
497
- ? lineDirectivesResult.problems
498
- .concat(blockDirectivesResult.unusedDirectives)
499
- .concat(lineDirectivesResult.unusedDirectives)
500
- .sort(compareLocations)
501
- : lineDirectivesResult.problems;
466
+ module.exports = ({
467
+ language,
468
+ sourceCode,
469
+ directives,
470
+ disableFixes,
471
+ problems,
472
+ configuredRules,
473
+ ruleFilter,
474
+ reportUnusedDisableDirectives = "off",
475
+ }) => {
476
+ const blockDirectives = directives
477
+ .filter(
478
+ directive =>
479
+ directive.type === "disable" || directive.type === "enable",
480
+ )
481
+ .map(directive =>
482
+ Object.assign({}, directive, { unprocessedDirective: directive }),
483
+ )
484
+ .sort(compareLocations);
485
+
486
+ const lineDirectives = directives
487
+ .flatMap(directive => {
488
+ switch (directive.type) {
489
+ case "disable":
490
+ case "enable":
491
+ return [];
492
+
493
+ case "disable-line":
494
+ return [
495
+ {
496
+ type: "disable",
497
+ line: directive.line,
498
+ column: 1,
499
+ ruleId: directive.ruleId,
500
+ unprocessedDirective: directive,
501
+ },
502
+ {
503
+ type: "enable",
504
+ line: directive.line + 1,
505
+ column: 0,
506
+ ruleId: directive.ruleId,
507
+ unprocessedDirective: directive,
508
+ },
509
+ ];
510
+
511
+ case "disable-next-line":
512
+ return [
513
+ {
514
+ type: "disable",
515
+ line: directive.line + 1,
516
+ column: 1,
517
+ ruleId: directive.ruleId,
518
+ unprocessedDirective: directive,
519
+ },
520
+ {
521
+ type: "enable",
522
+ line: directive.line + 2,
523
+ column: 0,
524
+ ruleId: directive.ruleId,
525
+ unprocessedDirective: directive,
526
+ },
527
+ ];
528
+
529
+ default:
530
+ throw new TypeError(
531
+ `Unrecognized directive type '${directive.type}'`,
532
+ );
533
+ }
534
+ })
535
+ .sort(compareLocations);
536
+
537
+ // This determines a list of rules that are not being run by the given ruleFilter, if present.
538
+ const rulesToIgnore =
539
+ configuredRules && ruleFilter
540
+ ? new Set(
541
+ Object.keys(configuredRules).filter(ruleId => {
542
+ const severity = ConfigOps.getRuleSeverity(
543
+ configuredRules[ruleId],
544
+ );
545
+
546
+ // Ignore for disabled rules.
547
+ if (severity === 0) {
548
+ return false;
549
+ }
550
+
551
+ return !ruleFilter({ severity, ruleId });
552
+ }),
553
+ )
554
+ : new Set();
555
+
556
+ // If no ruleId is supplied that means this directive is applied to all rules, so we can't determine if it's unused if any rules are filtered out.
557
+ if (rulesToIgnore.size > 0) {
558
+ rulesToIgnore.add(null);
559
+ }
560
+
561
+ const blockDirectivesResult = applyDirectives({
562
+ language,
563
+ sourceCode,
564
+ problems,
565
+ directives: blockDirectives,
566
+ disableFixes,
567
+ reportUnusedDisableDirectives,
568
+ rulesToIgnore,
569
+ });
570
+ const lineDirectivesResult = applyDirectives({
571
+ language,
572
+ sourceCode,
573
+ problems: blockDirectivesResult.problems,
574
+ directives: lineDirectives,
575
+ disableFixes,
576
+ reportUnusedDisableDirectives,
577
+ rulesToIgnore,
578
+ });
579
+
580
+ return reportUnusedDisableDirectives !== "off"
581
+ ? lineDirectivesResult.problems
582
+ .concat(blockDirectivesResult.unusedDirectives)
583
+ .concat(lineDirectivesResult.unusedDirectives)
584
+ .sort(compareLocations)
585
+ : lineDirectivesResult.problems;
502
586
  };