eslint 9.22.0 → 9.24.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 (417) hide show
  1. package/README.md +48 -46
  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 +830 -810
  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 +638 -457
  21. package/lib/config/config-loader.js +726 -622
  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 +72 -72
  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 +2 -2
  29. package/lib/eslint/eslint-helpers.js +756 -681
  30. package/lib/eslint/eslint.js +934 -912
  31. package/lib/eslint/index.js +2 -2
  32. package/lib/eslint/legacy-eslint.js +577 -533
  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 +1128 -1057
  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 +2403 -2045
  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 +36 -36
  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 +404 -361
  71. package/lib/rule-tester/index.js +1 -1
  72. package/lib/rule-tester/rule-tester.js +1308 -1046
  73. package/lib/rules/accessor-pairs.js +298 -263
  74. package/lib/rules/array-bracket-newline.js +250 -238
  75. package/lib/rules/array-bracket-spacing.js +263 -224
  76. package/lib/rules/array-callback-return.js +402 -356
  77. package/lib/rules/array-element-newline.js +358 -313
  78. package/lib/rules/arrow-body-style.js +400 -281
  79. package/lib/rules/arrow-parens.js +206 -173
  80. package/lib/rules/arrow-spacing.js +169 -163
  81. package/lib/rules/block-scoped-var.js +125 -123
  82. package/lib/rules/block-spacing.js +186 -176
  83. package/lib/rules/brace-style.js +262 -199
  84. package/lib/rules/callback-return.js +203 -190
  85. package/lib/rules/camelcase.js +403 -392
  86. package/lib/rules/capitalized-comments.js +253 -232
  87. package/lib/rules/class-methods-use-this.js +224 -172
  88. package/lib/rules/comma-dangle.js +379 -346
  89. package/lib/rules/comma-spacing.js +193 -195
  90. package/lib/rules/comma-style.js +375 -316
  91. package/lib/rules/complexity.js +173 -169
  92. package/lib/rules/computed-property-spacing.js +236 -211
  93. package/lib/rules/consistent-return.js +181 -170
  94. package/lib/rules/consistent-this.js +167 -147
  95. package/lib/rules/constructor-super.js +412 -404
  96. package/lib/rules/curly.js +407 -332
  97. package/lib/rules/default-case-last.js +38 -31
  98. package/lib/rules/default-case.js +89 -85
  99. package/lib/rules/default-param-last.js +69 -54
  100. package/lib/rules/dot-location.js +122 -110
  101. package/lib/rules/dot-notation.js +192 -156
  102. package/lib/rules/eol-last.js +122 -120
  103. package/lib/rules/eqeqeq.js +168 -155
  104. package/lib/rules/for-direction.js +146 -121
  105. package/lib/rules/func-call-spacing.js +261 -231
  106. package/lib/rules/func-name-matching.js +293 -209
  107. package/lib/rules/func-names.js +165 -164
  108. package/lib/rules/func-style.js +159 -127
  109. package/lib/rules/function-call-argument-newline.js +152 -129
  110. package/lib/rules/function-paren-newline.js +349 -291
  111. package/lib/rules/generator-star-spacing.js +229 -210
  112. package/lib/rules/getter-return.js +208 -172
  113. package/lib/rules/global-require.js +85 -74
  114. package/lib/rules/grouped-accessor-pairs.js +170 -150
  115. package/lib/rules/guard-for-in.js +72 -63
  116. package/lib/rules/handle-callback-err.js +108 -103
  117. package/lib/rules/id-blacklist.js +182 -199
  118. package/lib/rules/id-denylist.js +168 -187
  119. package/lib/rules/id-length.js +197 -171
  120. package/lib/rules/id-match.js +344 -289
  121. package/lib/rules/implicit-arrow-linebreak.js +102 -79
  122. package/lib/rules/indent-legacy.js +1344 -1118
  123. package/lib/rules/indent.js +2272 -1759
  124. package/lib/rules/index.js +317 -292
  125. package/lib/rules/init-declarations.js +137 -107
  126. package/lib/rules/jsx-quotes.js +94 -82
  127. package/lib/rules/key-spacing.js +750 -633
  128. package/lib/rules/keyword-spacing.js +648 -605
  129. package/lib/rules/line-comment-position.js +142 -128
  130. package/lib/rules/linebreak-style.js +107 -106
  131. package/lib/rules/lines-around-comment.js +540 -448
  132. package/lib/rules/lines-around-directive.js +233 -203
  133. package/lib/rules/lines-between-class-members.js +305 -234
  134. package/lib/rules/logical-assignment-operators.js +582 -399
  135. package/lib/rules/max-classes-per-file.js +69 -68
  136. package/lib/rules/max-depth.js +146 -143
  137. package/lib/rules/max-len.js +473 -434
  138. package/lib/rules/max-lines-per-function.js +201 -176
  139. package/lib/rules/max-lines.js +158 -162
  140. package/lib/rules/max-nested-callbacks.js +102 -104
  141. package/lib/rules/max-params.js +78 -76
  142. package/lib/rules/max-statements-per-line.js +205 -198
  143. package/lib/rules/max-statements.js +168 -164
  144. package/lib/rules/multiline-comment-style.js +637 -479
  145. package/lib/rules/multiline-ternary.js +241 -176
  146. package/lib/rules/new-cap.js +233 -213
  147. package/lib/rules/new-parens.js +88 -79
  148. package/lib/rules/newline-after-var.js +287 -250
  149. package/lib/rules/newline-before-return.js +229 -222
  150. package/lib/rules/newline-per-chained-call.js +142 -127
  151. package/lib/rules/no-alert.js +90 -79
  152. package/lib/rules/no-array-constructor.js +125 -113
  153. package/lib/rules/no-async-promise-executor.js +30 -24
  154. package/lib/rules/no-await-in-loop.js +69 -71
  155. package/lib/rules/no-bitwise.js +124 -100
  156. package/lib/rules/no-buffer-constructor.js +55 -47
  157. package/lib/rules/no-caller.js +39 -33
  158. package/lib/rules/no-case-declarations.js +61 -57
  159. package/lib/rules/no-catch-shadow.js +76 -73
  160. package/lib/rules/no-class-assign.js +51 -48
  161. package/lib/rules/no-compare-neg-zero.js +62 -48
  162. package/lib/rules/no-cond-assign.js +148 -132
  163. package/lib/rules/no-confusing-arrow.js +98 -81
  164. package/lib/rules/no-console.js +202 -199
  165. package/lib/rules/no-const-assign.js +47 -41
  166. package/lib/rules/no-constant-binary-expression.js +500 -405
  167. package/lib/rules/no-constant-condition.js +158 -143
  168. package/lib/rules/no-constructor-return.js +49 -49
  169. package/lib/rules/no-continue.js +25 -27
  170. package/lib/rules/no-control-regex.js +125 -121
  171. package/lib/rules/no-debugger.js +28 -30
  172. package/lib/rules/no-delete-var.js +29 -29
  173. package/lib/rules/no-div-regex.js +47 -41
  174. package/lib/rules/no-dupe-args.js +68 -69
  175. package/lib/rules/no-dupe-class-members.js +102 -89
  176. package/lib/rules/no-dupe-else-if.js +100 -77
  177. package/lib/rules/no-dupe-keys.js +133 -110
  178. package/lib/rules/no-duplicate-case.js +50 -43
  179. package/lib/rules/no-duplicate-imports.js +179 -176
  180. package/lib/rules/no-else-return.js +430 -385
  181. package/lib/rules/no-empty-character-class.js +57 -50
  182. package/lib/rules/no-empty-function.js +127 -128
  183. package/lib/rules/no-empty-pattern.js +63 -58
  184. package/lib/rules/no-empty-static-block.js +37 -35
  185. package/lib/rules/no-empty.js +98 -86
  186. package/lib/rules/no-eq-null.js +37 -32
  187. package/lib/rules/no-eval.js +256 -250
  188. package/lib/rules/no-ex-assign.js +42 -39
  189. package/lib/rules/no-extend-native.js +161 -159
  190. package/lib/rules/no-extra-bind.js +201 -190
  191. package/lib/rules/no-extra-boolean-cast.js +398 -348
  192. package/lib/rules/no-extra-label.js +150 -131
  193. package/lib/rules/no-extra-parens.js +1654 -1325
  194. package/lib/rules/no-extra-semi.js +146 -144
  195. package/lib/rules/no-fallthrough.js +199 -157
  196. package/lib/rules/no-floating-decimal.js +74 -66
  197. package/lib/rules/no-func-assign.js +54 -55
  198. package/lib/rules/no-global-assign.js +78 -73
  199. package/lib/rules/no-implicit-coercion.js +349 -293
  200. package/lib/rules/no-implicit-globals.js +158 -135
  201. package/lib/rules/no-implied-eval.js +140 -112
  202. package/lib/rules/no-import-assign.js +145 -159
  203. package/lib/rules/no-inline-comments.js +101 -95
  204. package/lib/rules/no-inner-declarations.js +115 -101
  205. package/lib/rules/no-invalid-regexp.js +222 -190
  206. package/lib/rules/no-invalid-this.js +123 -117
  207. package/lib/rules/no-irregular-whitespace.js +266 -252
  208. package/lib/rules/no-iterator.js +29 -33
  209. package/lib/rules/no-label-var.js +59 -62
  210. package/lib/rules/no-labels.js +138 -133
  211. package/lib/rules/no-lone-blocks.js +127 -123
  212. package/lib/rules/no-lonely-if.js +108 -77
  213. package/lib/rules/no-loop-func.js +238 -213
  214. package/lib/rules/no-loss-of-precision.js +218 -201
  215. package/lib/rules/no-magic-numbers.js +246 -218
  216. package/lib/rules/no-misleading-character-class.js +499 -446
  217. package/lib/rules/no-mixed-operators.js +188 -182
  218. package/lib/rules/no-mixed-requires.js +253 -240
  219. package/lib/rules/no-mixed-spaces-and-tabs.js +134 -121
  220. package/lib/rules/no-multi-assign.js +46 -44
  221. package/lib/rules/no-multi-spaces.js +163 -143
  222. package/lib/rules/no-multi-str.js +42 -41
  223. package/lib/rules/no-multiple-empty-lines.js +196 -158
  224. package/lib/rules/no-native-reassign.js +90 -85
  225. package/lib/rules/no-negated-condition.js +79 -75
  226. package/lib/rules/no-negated-in-lhs.js +45 -43
  227. package/lib/rules/no-nested-ternary.js +33 -32
  228. package/lib/rules/no-new-func.js +71 -62
  229. package/lib/rules/no-new-native-nonconstructor.js +43 -39
  230. package/lib/rules/no-new-object.js +48 -48
  231. package/lib/rules/no-new-require.js +48 -47
  232. package/lib/rules/no-new-symbol.js +52 -50
  233. package/lib/rules/no-new-wrappers.js +43 -41
  234. package/lib/rules/no-new.js +28 -29
  235. package/lib/rules/no-nonoctal-decimal-escape.js +141 -121
  236. package/lib/rules/no-obj-calls.js +66 -53
  237. package/lib/rules/no-object-constructor.js +104 -97
  238. package/lib/rules/no-octal-escape.js +40 -43
  239. package/lib/rules/no-octal.js +32 -32
  240. package/lib/rules/no-param-reassign.js +235 -217
  241. package/lib/rules/no-path-concat.js +66 -67
  242. package/lib/rules/no-plusplus.js +60 -61
  243. package/lib/rules/no-process-env.js +49 -48
  244. package/lib/rules/no-process-exit.js +54 -50
  245. package/lib/rules/no-promise-executor-return.js +214 -182
  246. package/lib/rules/no-proto.js +26 -29
  247. package/lib/rules/no-prototype-builtins.js +146 -124
  248. package/lib/rules/no-redeclare.js +154 -152
  249. package/lib/rules/no-regex-spaces.js +183 -161
  250. package/lib/rules/no-restricted-exports.js +208 -185
  251. package/lib/rules/no-restricted-globals.js +111 -112
  252. package/lib/rules/no-restricted-imports.js +657 -537
  253. package/lib/rules/no-restricted-modules.js +222 -202
  254. package/lib/rules/no-restricted-properties.js +181 -153
  255. package/lib/rules/no-restricted-syntax.js +56 -52
  256. package/lib/rules/no-return-assign.js +55 -50
  257. package/lib/rules/no-return-await.js +148 -124
  258. package/lib/rules/no-script-url.js +52 -45
  259. package/lib/rules/no-self-assign.js +148 -146
  260. package/lib/rules/no-self-compare.js +63 -46
  261. package/lib/rules/no-sequences.js +135 -116
  262. package/lib/rules/no-setter-return.js +185 -152
  263. package/lib/rules/no-shadow-restricted-names.js +61 -46
  264. package/lib/rules/no-shadow.js +342 -316
  265. package/lib/rules/no-spaced-func.js +82 -77
  266. package/lib/rules/no-sparse-arrays.js +54 -59
  267. package/lib/rules/no-sync.js +61 -60
  268. package/lib/rules/no-tabs.js +83 -72
  269. package/lib/rules/no-template-curly-in-string.js +33 -32
  270. package/lib/rules/no-ternary.js +25 -29
  271. package/lib/rules/no-this-before-super.js +321 -319
  272. package/lib/rules/no-throw-literal.js +31 -36
  273. package/lib/rules/no-trailing-spaces.js +199 -191
  274. package/lib/rules/no-undef-init.js +76 -61
  275. package/lib/rules/no-undef.js +51 -48
  276. package/lib/rules/no-undefined.js +73 -75
  277. package/lib/rules/no-underscore-dangle.js +370 -327
  278. package/lib/rules/no-unexpected-multiline.js +112 -102
  279. package/lib/rules/no-unmodified-loop-condition.js +254 -254
  280. package/lib/rules/no-unneeded-ternary.js +212 -147
  281. package/lib/rules/no-unreachable-loop.js +145 -142
  282. package/lib/rules/no-unreachable.js +255 -248
  283. package/lib/rules/no-unsafe-finally.js +93 -85
  284. package/lib/rules/no-unsafe-negation.js +105 -83
  285. package/lib/rules/no-unsafe-optional-chaining.js +192 -178
  286. package/lib/rules/no-unused-expressions.js +178 -162
  287. package/lib/rules/no-unused-labels.js +139 -124
  288. package/lib/rules/no-unused-private-class-members.js +206 -182
  289. package/lib/rules/no-unused-vars.js +1669 -1449
  290. package/lib/rules/no-use-before-define.js +229 -231
  291. package/lib/rules/no-useless-assignment.js +590 -511
  292. package/lib/rules/no-useless-backreference.js +212 -193
  293. package/lib/rules/no-useless-call.js +58 -53
  294. package/lib/rules/no-useless-catch.js +40 -40
  295. package/lib/rules/no-useless-computed-key.js +144 -115
  296. package/lib/rules/no-useless-concat.js +65 -60
  297. package/lib/rules/no-useless-constructor.js +158 -111
  298. package/lib/rules/no-useless-escape.js +342 -291
  299. package/lib/rules/no-useless-rename.js +183 -156
  300. package/lib/rules/no-useless-return.js +344 -312
  301. package/lib/rules/no-var.js +233 -212
  302. package/lib/rules/no-void.js +50 -48
  303. package/lib/rules/no-warning-comments.js +191 -186
  304. package/lib/rules/no-whitespace-before-property.js +131 -115
  305. package/lib/rules/no-with.js +24 -26
  306. package/lib/rules/nonblock-statement-body-position.js +149 -130
  307. package/lib/rules/object-curly-newline.js +306 -265
  308. package/lib/rules/object-curly-spacing.js +360 -314
  309. package/lib/rules/object-property-newline.js +137 -106
  310. package/lib/rules/object-shorthand.js +607 -502
  311. package/lib/rules/one-var-declaration-per-line.js +104 -100
  312. package/lib/rules/one-var.js +653 -537
  313. package/lib/rules/operator-assignment.js +219 -161
  314. package/lib/rules/operator-linebreak.js +295 -251
  315. package/lib/rules/padded-blocks.js +346 -308
  316. package/lib/rules/padding-line-between-statements.js +443 -439
  317. package/lib/rules/prefer-arrow-callback.js +362 -313
  318. package/lib/rules/prefer-const.js +418 -377
  319. package/lib/rules/prefer-destructuring.js +301 -279
  320. package/lib/rules/prefer-exponentiation-operator.js +176 -133
  321. package/lib/rules/prefer-named-capture-group.js +153 -140
  322. package/lib/rules/prefer-numeric-literals.js +121 -113
  323. package/lib/rules/prefer-object-has-own.js +116 -82
  324. package/lib/rules/prefer-object-spread.js +213 -193
  325. package/lib/rules/prefer-promise-reject-errors.js +140 -122
  326. package/lib/rules/prefer-reflect.js +127 -107
  327. package/lib/rules/prefer-regex-literals.js +578 -466
  328. package/lib/rules/prefer-rest-params.js +79 -80
  329. package/lib/rules/prefer-spread.js +47 -44
  330. package/lib/rules/prefer-template.js +266 -195
  331. package/lib/rules/quote-props.js +373 -307
  332. package/lib/rules/quotes.js +374 -326
  333. package/lib/rules/radix.js +152 -136
  334. package/lib/rules/require-atomic-updates.js +316 -285
  335. package/lib/rules/require-await.js +144 -116
  336. package/lib/rules/require-unicode-regexp.js +282 -177
  337. package/lib/rules/require-yield.js +53 -54
  338. package/lib/rules/rest-spread-spacing.js +128 -116
  339. package/lib/rules/semi-spacing.js +281 -250
  340. package/lib/rules/semi-style.js +176 -134
  341. package/lib/rules/semi.js +456 -436
  342. package/lib/rules/sort-imports.js +306 -233
  343. package/lib/rules/sort-keys.js +219 -188
  344. package/lib/rules/sort-vars.js +127 -93
  345. package/lib/rules/space-before-blocks.js +199 -189
  346. package/lib/rules/space-before-function-paren.js +186 -166
  347. package/lib/rules/space-in-parens.js +359 -288
  348. package/lib/rules/space-infix-ops.js +237 -201
  349. package/lib/rules/space-unary-ops.js +356 -298
  350. package/lib/rules/spaced-comment.js +363 -319
  351. package/lib/rules/strict.js +265 -230
  352. package/lib/rules/switch-colon-spacing.js +130 -122
  353. package/lib/rules/symbol-description.js +45 -48
  354. package/lib/rules/template-curly-spacing.js +148 -142
  355. package/lib/rules/template-tag-spacing.js +98 -88
  356. package/lib/rules/unicode-bom.js +54 -56
  357. package/lib/rules/use-isnan.js +237 -206
  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 +153 -111
  370. package/lib/rules/vars-on-top.js +152 -145
  371. package/lib/rules/wrap-iife.js +204 -191
  372. package/lib/rules/wrap-regex.js +70 -58
  373. package/lib/rules/yield-star-spacing.js +145 -134
  374. package/lib/rules/yoda.js +283 -272
  375. package/lib/services/parser-service.js +35 -35
  376. package/lib/services/processor-service.js +66 -73
  377. package/lib/services/suppressions-service.js +289 -0
  378. package/lib/shared/ajv.js +14 -14
  379. package/lib/shared/assert.js +3 -4
  380. package/lib/shared/ast-utils.js +7 -6
  381. package/lib/shared/deep-merge-arrays.js +24 -22
  382. package/lib/shared/directives.js +3 -2
  383. package/lib/shared/flags.js +50 -17
  384. package/lib/shared/logging.js +24 -25
  385. package/lib/shared/option-utils.js +43 -36
  386. package/lib/shared/runtime-info.js +136 -127
  387. package/lib/shared/serialization.js +27 -27
  388. package/lib/shared/severity.js +22 -22
  389. package/lib/shared/stats.js +5 -5
  390. package/lib/shared/string-utils.js +16 -16
  391. package/lib/shared/text-table.js +28 -27
  392. package/lib/shared/traverser.js +153 -146
  393. package/lib/shared/types.js +4 -27
  394. package/lib/types/index.d.ts +2010 -1559
  395. package/lib/types/rules.d.ts +5253 -5140
  396. package/lib/types/use-at-your-own-risk.d.ts +32 -30
  397. package/lib/unsupported-api.js +5 -5
  398. package/messages/all-files-ignored.js +3 -3
  399. package/messages/all-matched-files-ignored.js +3 -3
  400. package/messages/config-file-missing.js +2 -2
  401. package/messages/config-plugin-missing.js +3 -3
  402. package/messages/config-serialize-function.js +9 -7
  403. package/messages/eslintrc-incompat.js +13 -15
  404. package/messages/eslintrc-plugins.js +3 -4
  405. package/messages/extend-config-missing.js +3 -3
  406. package/messages/failed-to-read-json.js +3 -3
  407. package/messages/file-not-found.js +3 -3
  408. package/messages/invalid-rule-options.js +2 -2
  409. package/messages/invalid-rule-severity.js +2 -2
  410. package/messages/no-config-found.js +3 -3
  411. package/messages/plugin-conflict.js +8 -8
  412. package/messages/plugin-invalid.js +3 -3
  413. package/messages/plugin-missing.js +3 -3
  414. package/messages/print-config-with-directory-path.js +2 -2
  415. package/messages/shared.js +6 -1
  416. package/messages/whitespace-found.js +3 -3
  417. package/package.json +14 -20
@@ -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
  };