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
@@ -28,9 +28,12 @@ const { normalizeSeverityToNumber } = require("../shared/severity");
28
28
  //-----------------------------------------------------------------------------
29
29
 
30
30
  const ruleSeverities = new Map([
31
- [0, 0], ["off", 0],
32
- [1, 1], ["warn", 1],
33
- [2, 2], ["error", 2]
31
+ [0, 0],
32
+ ["off", 0],
33
+ [1, 1],
34
+ ["warn", 1],
35
+ [2, 2],
36
+ ["error", 2],
34
37
  ]);
35
38
 
36
39
  /**
@@ -39,7 +42,7 @@ const ruleSeverities = new Map([
39
42
  * @returns {boolean} `true` if the value is a non-null object.
40
43
  */
41
44
  function isNonNullObject(value) {
42
- return typeof value === "object" && value !== null;
45
+ return typeof value === "object" && value !== null;
43
46
  }
44
47
 
45
48
  /**
@@ -48,7 +51,7 @@ function isNonNullObject(value) {
48
51
  * @returns {boolean} `true` if the value is a non-null non-array object.
49
52
  */
50
53
  function isNonArrayObject(value) {
51
- return isNonNullObject(value) && !Array.isArray(value);
54
+ return isNonNullObject(value) && !Array.isArray(value);
52
55
  }
53
56
 
54
57
  /**
@@ -57,7 +60,7 @@ function isNonArrayObject(value) {
57
60
  * @returns {boolean} `true` if the value is undefined.
58
61
  */
59
62
  function isUndefined(value) {
60
- return typeof value === "undefined";
63
+ return typeof value === "undefined";
61
64
  }
62
65
 
63
66
  /**
@@ -68,57 +71,56 @@ function isUndefined(value) {
68
71
  * @returns {Object} An object with properties from both first and second.
69
72
  */
70
73
  function deepMerge(first, second, mergeMap = new Map()) {
71
-
72
- let secondMergeMap = mergeMap.get(first);
73
-
74
- if (secondMergeMap) {
75
- const result = secondMergeMap.get(second);
76
-
77
- if (result) {
78
-
79
- // If this combination of first and second arguments has been already visited, return the previously created result.
80
- return result;
81
- }
82
- } else {
83
- secondMergeMap = new Map();
84
- mergeMap.set(first, secondMergeMap);
85
- }
86
-
87
- /*
88
- * First create a result object where properties from the second object
89
- * overwrite properties from the first. This sets up a baseline to use
90
- * later rather than needing to inspect and change every property
91
- * individually.
92
- */
93
- const result = {
94
- ...first,
95
- ...second
96
- };
97
-
98
- delete result.__proto__; // eslint-disable-line no-proto -- don't merge own property "__proto__"
99
-
100
- // Store the pending result for this combination of first and second arguments.
101
- secondMergeMap.set(second, result);
102
-
103
- for (const key of Object.keys(second)) {
104
-
105
- // avoid hairy edge case
106
- if (key === "__proto__" || !Object.prototype.propertyIsEnumerable.call(first, key)) {
107
- continue;
108
- }
109
-
110
- const firstValue = first[key];
111
- const secondValue = second[key];
112
-
113
- if (isNonArrayObject(firstValue) && isNonArrayObject(secondValue)) {
114
- result[key] = deepMerge(firstValue, secondValue, mergeMap);
115
- } else if (isUndefined(secondValue)) {
116
- result[key] = firstValue;
117
- }
118
- }
119
-
120
- return result;
121
-
74
+ let secondMergeMap = mergeMap.get(first);
75
+
76
+ if (secondMergeMap) {
77
+ const result = secondMergeMap.get(second);
78
+
79
+ if (result) {
80
+ // If this combination of first and second arguments has been already visited, return the previously created result.
81
+ return result;
82
+ }
83
+ } else {
84
+ secondMergeMap = new Map();
85
+ mergeMap.set(first, secondMergeMap);
86
+ }
87
+
88
+ /*
89
+ * First create a result object where properties from the second object
90
+ * overwrite properties from the first. This sets up a baseline to use
91
+ * later rather than needing to inspect and change every property
92
+ * individually.
93
+ */
94
+ const result = {
95
+ ...first,
96
+ ...second,
97
+ };
98
+
99
+ delete result.__proto__; // eslint-disable-line no-proto -- don't merge own property "__proto__"
100
+
101
+ // Store the pending result for this combination of first and second arguments.
102
+ secondMergeMap.set(second, result);
103
+
104
+ for (const key of Object.keys(second)) {
105
+ // avoid hairy edge case
106
+ if (
107
+ key === "__proto__" ||
108
+ !Object.prototype.propertyIsEnumerable.call(first, key)
109
+ ) {
110
+ continue;
111
+ }
112
+
113
+ const firstValue = first[key];
114
+ const secondValue = second[key];
115
+
116
+ if (isNonArrayObject(firstValue) && isNonArrayObject(secondValue)) {
117
+ result[key] = deepMerge(firstValue, secondValue, mergeMap);
118
+ } else if (isUndefined(secondValue)) {
119
+ result[key] = firstValue;
120
+ }
121
+ }
122
+
123
+ return result;
122
124
  }
123
125
 
124
126
  /**
@@ -128,13 +130,12 @@ function deepMerge(first, second, mergeMap = new Map()) {
128
130
  * @returns {Array} An array of rule options.
129
131
  */
130
132
  function normalizeRuleOptions(ruleOptions) {
133
+ const finalOptions = Array.isArray(ruleOptions)
134
+ ? ruleOptions.slice(0)
135
+ : [ruleOptions];
131
136
 
132
- const finalOptions = Array.isArray(ruleOptions)
133
- ? ruleOptions.slice(0)
134
- : [ruleOptions];
135
-
136
- finalOptions[0] = ruleSeverities.get(finalOptions[0]);
137
- return structuredClone(finalOptions);
137
+ finalOptions[0] = ruleSeverities.get(finalOptions[0]);
138
+ return structuredClone(finalOptions);
138
139
  }
139
140
 
140
141
  /**
@@ -143,15 +144,13 @@ function normalizeRuleOptions(ruleOptions) {
143
144
  * @returns {boolean} `true` if the object has any methods.
144
145
  */
145
146
  function hasMethod(object) {
147
+ for (const key of Object.keys(object)) {
148
+ if (typeof object[key] === "function") {
149
+ return true;
150
+ }
151
+ }
146
152
 
147
- for (const key of Object.keys(object)) {
148
-
149
- if (typeof object[key] === "function") {
150
- return true;
151
- }
152
- }
153
-
154
- return false;
153
+ return false;
155
154
  }
156
155
 
157
156
  //-----------------------------------------------------------------------------
@@ -162,16 +161,17 @@ function hasMethod(object) {
162
161
  * The error type when a rule's options are configured with an invalid type.
163
162
  */
164
163
  class InvalidRuleOptionsError extends Error {
165
-
166
- /**
167
- * @param {string} ruleId Rule name being configured.
168
- * @param {any} value The invalid value.
169
- */
170
- constructor(ruleId, value) {
171
- super(`Key "${ruleId}": Expected severity of "off", 0, "warn", 1, "error", or 2.`);
172
- this.messageTemplate = "invalid-rule-options";
173
- this.messageData = { ruleId, value };
174
- }
164
+ /**
165
+ * @param {string} ruleId Rule name being configured.
166
+ * @param {any} value The invalid value.
167
+ */
168
+ constructor(ruleId, value) {
169
+ super(
170
+ `Key "${ruleId}": Expected severity of "off", 0, "warn", 1, "error", or 2.`,
171
+ );
172
+ this.messageTemplate = "invalid-rule-options";
173
+ this.messageData = { ruleId, value };
174
+ }
175
175
  }
176
176
 
177
177
  /**
@@ -182,25 +182,30 @@ class InvalidRuleOptionsError extends Error {
182
182
  * @throws {InvalidRuleOptionsError} If the value isn't a valid rule options.
183
183
  */
184
184
  function assertIsRuleOptions(ruleId, value) {
185
- if (typeof value !== "string" && typeof value !== "number" && !Array.isArray(value)) {
186
- throw new InvalidRuleOptionsError(ruleId, value);
187
- }
185
+ if (
186
+ typeof value !== "string" &&
187
+ typeof value !== "number" &&
188
+ !Array.isArray(value)
189
+ ) {
190
+ throw new InvalidRuleOptionsError(ruleId, value);
191
+ }
188
192
  }
189
193
 
190
194
  /**
191
195
  * The error type when a rule's severity is invalid.
192
196
  */
193
197
  class InvalidRuleSeverityError extends Error {
194
-
195
- /**
196
- * @param {string} ruleId Rule name being configured.
197
- * @param {any} value The invalid value.
198
- */
199
- constructor(ruleId, value) {
200
- super(`Key "${ruleId}": Expected severity of "off", 0, "warn", 1, "error", or 2.`);
201
- this.messageTemplate = "invalid-rule-severity";
202
- this.messageData = { ruleId, value };
203
- }
198
+ /**
199
+ * @param {string} ruleId Rule name being configured.
200
+ * @param {any} value The invalid value.
201
+ */
202
+ constructor(ruleId, value) {
203
+ super(
204
+ `Key "${ruleId}": Expected severity of "off", 0, "warn", 1, "error", or 2.`,
205
+ );
206
+ this.messageTemplate = "invalid-rule-severity";
207
+ this.messageData = { ruleId, value };
208
+ }
204
209
  }
205
210
 
206
211
  /**
@@ -211,11 +216,11 @@ class InvalidRuleSeverityError extends Error {
211
216
  * @throws {InvalidRuleSeverityError} If the value isn't a valid rule severity.
212
217
  */
213
218
  function assertIsRuleSeverity(ruleId, value) {
214
- const severity = ruleSeverities.get(value);
219
+ const severity = ruleSeverities.get(value);
215
220
 
216
- if (typeof severity === "undefined") {
217
- throw new InvalidRuleSeverityError(ruleId, value);
218
- }
221
+ if (typeof severity === "undefined") {
222
+ throw new InvalidRuleSeverityError(ruleId, value);
223
+ }
219
224
  }
220
225
 
221
226
  /**
@@ -225,9 +230,11 @@ function assertIsRuleSeverity(ruleId, value) {
225
230
  * @throws {TypeError} If the string isn't in the correct format.
226
231
  */
227
232
  function assertIsPluginMemberName(value) {
228
- if (!/[@a-z0-9-_$]+(?:\/(?:[a-z0-9-_$]+))+$/iu.test(value)) {
229
- throw new TypeError(`Expected string in the form "pluginName/objectName" but found "${value}".`);
230
- }
233
+ if (!/[@a-z0-9-_$]+(?:\/(?:[a-z0-9-_$]+))+$/iu.test(value)) {
234
+ throw new TypeError(
235
+ `Expected string in the form "pluginName/objectName" but found "${value}".`,
236
+ );
237
+ }
231
238
  }
232
239
 
233
240
  /**
@@ -237,294 +244,293 @@ function assertIsPluginMemberName(value) {
237
244
  * @throws {TypeError} If the value isn't an object.
238
245
  */
239
246
  function assertIsObject(value) {
240
- if (!isNonNullObject(value)) {
241
- throw new TypeError("Expected an object.");
242
- }
247
+ if (!isNonNullObject(value)) {
248
+ throw new TypeError("Expected an object.");
249
+ }
243
250
  }
244
251
 
245
252
  /**
246
253
  * The error type when there's an eslintrc-style options in a flat config.
247
254
  */
248
255
  class IncompatibleKeyError extends Error {
249
-
250
- /**
251
- * @param {string} key The invalid key.
252
- */
253
- constructor(key) {
254
- super("This appears to be in eslintrc format rather than flat config format.");
255
- this.messageTemplate = "eslintrc-incompat";
256
- this.messageData = { key };
257
- }
256
+ /**
257
+ * @param {string} key The invalid key.
258
+ */
259
+ constructor(key) {
260
+ super(
261
+ "This appears to be in eslintrc format rather than flat config format.",
262
+ );
263
+ this.messageTemplate = "eslintrc-incompat";
264
+ this.messageData = { key };
265
+ }
258
266
  }
259
267
 
260
268
  /**
261
269
  * The error type when there's an eslintrc-style plugins array found.
262
270
  */
263
271
  class IncompatiblePluginsError extends Error {
264
-
265
- /**
266
- * Creates a new instance.
267
- * @param {Array<string>} plugins The plugins array.
268
- */
269
- constructor(plugins) {
270
- super("This appears to be in eslintrc format (array of strings) rather than flat config format (object).");
271
- this.messageTemplate = "eslintrc-plugins";
272
- this.messageData = { plugins };
273
- }
272
+ /**
273
+ * Creates a new instance.
274
+ * @param {Array<string>} plugins The plugins array.
275
+ */
276
+ constructor(plugins) {
277
+ super(
278
+ "This appears to be in eslintrc format (array of strings) rather than flat config format (object).",
279
+ );
280
+ this.messageTemplate = "eslintrc-plugins";
281
+ this.messageData = { plugins };
282
+ }
274
283
  }
275
284
 
276
-
277
285
  //-----------------------------------------------------------------------------
278
286
  // Low-Level Schemas
279
287
  //-----------------------------------------------------------------------------
280
288
 
281
289
  /** @type {ObjectPropertySchema} */
282
290
  const booleanSchema = {
283
- merge: "replace",
284
- validate: "boolean"
291
+ merge: "replace",
292
+ validate: "boolean",
285
293
  };
286
294
 
287
295
  const ALLOWED_SEVERITIES = new Set(["error", "warn", "off", 2, 1, 0]);
288
296
 
289
297
  /** @type {ObjectPropertySchema} */
290
298
  const disableDirectiveSeveritySchema = {
291
- merge(first, second) {
292
- const value = second === void 0 ? first : second;
293
-
294
- if (typeof value === "boolean") {
295
- return value ? "warn" : "off";
296
- }
297
-
298
- return normalizeSeverityToNumber(value);
299
- },
300
- validate(value) {
301
- if (!(ALLOWED_SEVERITIES.has(value) || typeof value === "boolean")) {
302
- throw new TypeError("Expected one of: \"error\", \"warn\", \"off\", 0, 1, 2, or a boolean.");
303
- }
304
- }
299
+ merge(first, second) {
300
+ const value = second === void 0 ? first : second;
301
+
302
+ if (typeof value === "boolean") {
303
+ return value ? "warn" : "off";
304
+ }
305
+
306
+ return normalizeSeverityToNumber(value);
307
+ },
308
+ validate(value) {
309
+ if (!(ALLOWED_SEVERITIES.has(value) || typeof value === "boolean")) {
310
+ throw new TypeError(
311
+ 'Expected one of: "error", "warn", "off", 0, 1, 2, or a boolean.',
312
+ );
313
+ }
314
+ },
305
315
  };
306
316
 
307
317
  /** @type {ObjectPropertySchema} */
308
318
  const unusedInlineConfigsSeveritySchema = {
309
- merge(first, second) {
310
- const value = second === void 0 ? first : second;
311
-
312
- return normalizeSeverityToNumber(value);
313
- },
314
- validate(value) {
315
- if (!ALLOWED_SEVERITIES.has(value)) {
316
- throw new TypeError("Expected one of: \"error\", \"warn\", \"off\", 0, 1, or 2.");
317
- }
318
- }
319
+ merge(first, second) {
320
+ const value = second === void 0 ? first : second;
321
+
322
+ return normalizeSeverityToNumber(value);
323
+ },
324
+ validate(value) {
325
+ if (!ALLOWED_SEVERITIES.has(value)) {
326
+ throw new TypeError(
327
+ 'Expected one of: "error", "warn", "off", 0, 1, or 2.',
328
+ );
329
+ }
330
+ },
319
331
  };
320
332
 
321
333
  /** @type {ObjectPropertySchema} */
322
334
  const deepObjectAssignSchema = {
323
- merge(first = {}, second = {}) {
324
- return deepMerge(first, second);
325
- },
326
- validate: "object"
335
+ merge(first = {}, second = {}) {
336
+ return deepMerge(first, second);
337
+ },
338
+ validate: "object",
327
339
  };
328
340
 
329
-
330
341
  //-----------------------------------------------------------------------------
331
342
  // High-Level Schemas
332
343
  //-----------------------------------------------------------------------------
333
344
 
334
345
  /** @type {ObjectPropertySchema} */
335
346
  const languageOptionsSchema = {
336
- merge(first = {}, second = {}) {
337
-
338
- const result = deepMerge(first, second);
339
-
340
- for (const [key, value] of Object.entries(result)) {
341
-
342
- /*
343
- * Special case: Because the `parser` property is an object, it should
344
- * not be deep merged. Instead, it should be replaced if it exists in
345
- * the second object. To make this more generic, we just check for
346
- * objects with methods and replace them if they exist in the second
347
- * object.
348
- */
349
- if (isNonArrayObject(value)) {
350
- if (hasMethod(value)) {
351
- result[key] = second[key] ?? first[key];
352
- continue;
353
- }
354
-
355
- // for other objects, make sure we aren't reusing the same object
356
- result[key] = { ...result[key] };
357
- continue;
358
- }
359
-
360
- }
361
-
362
- return result;
363
- },
364
- validate: "object"
347
+ merge(first = {}, second = {}) {
348
+ const result = deepMerge(first, second);
349
+
350
+ for (const [key, value] of Object.entries(result)) {
351
+ /*
352
+ * Special case: Because the `parser` property is an object, it should
353
+ * not be deep merged. Instead, it should be replaced if it exists in
354
+ * the second object. To make this more generic, we just check for
355
+ * objects with methods and replace them if they exist in the second
356
+ * object.
357
+ */
358
+ if (isNonArrayObject(value)) {
359
+ if (hasMethod(value)) {
360
+ result[key] = second[key] ?? first[key];
361
+ continue;
362
+ }
363
+
364
+ // for other objects, make sure we aren't reusing the same object
365
+ result[key] = { ...result[key] };
366
+ continue;
367
+ }
368
+ }
369
+
370
+ return result;
371
+ },
372
+ validate: "object",
365
373
  };
366
374
 
367
375
  /** @type {ObjectPropertySchema} */
368
376
  const languageSchema = {
369
- merge: "replace",
370
- validate: assertIsPluginMemberName
377
+ merge: "replace",
378
+ validate: assertIsPluginMemberName,
371
379
  };
372
380
 
373
381
  /** @type {ObjectPropertySchema} */
374
382
  const pluginsSchema = {
375
- merge(first = {}, second = {}) {
376
- const keys = new Set([...Object.keys(first), ...Object.keys(second)]);
377
- const result = {};
378
-
379
- // manually validate that plugins are not redefined
380
- for (const key of keys) {
381
-
382
- // avoid hairy edge case
383
- if (key === "__proto__") {
384
- continue;
385
- }
386
-
387
- if (key in first && key in second && first[key] !== second[key]) {
388
- throw new TypeError(`Cannot redefine plugin "${key}".`);
389
- }
390
-
391
- result[key] = second[key] || first[key];
392
- }
393
-
394
- return result;
395
- },
396
- validate(value) {
397
-
398
- // first check the value to be sure it's an object
399
- if (value === null || typeof value !== "object") {
400
- throw new TypeError("Expected an object.");
401
- }
402
-
403
- // make sure it's not an array, which would mean eslintrc-style is used
404
- if (Array.isArray(value)) {
405
- throw new IncompatiblePluginsError(value);
406
- }
407
-
408
- // second check the keys to make sure they are objects
409
- for (const key of Object.keys(value)) {
410
-
411
- // avoid hairy edge case
412
- if (key === "__proto__") {
413
- continue;
414
- }
415
-
416
- if (value[key] === null || typeof value[key] !== "object") {
417
- throw new TypeError(`Key "${key}": Expected an object.`);
418
- }
419
- }
420
- }
383
+ merge(first = {}, second = {}) {
384
+ const keys = new Set([...Object.keys(first), ...Object.keys(second)]);
385
+ const result = {};
386
+
387
+ // manually validate that plugins are not redefined
388
+ for (const key of keys) {
389
+ // avoid hairy edge case
390
+ if (key === "__proto__") {
391
+ continue;
392
+ }
393
+
394
+ if (key in first && key in second && first[key] !== second[key]) {
395
+ throw new TypeError(`Cannot redefine plugin "${key}".`);
396
+ }
397
+
398
+ result[key] = second[key] || first[key];
399
+ }
400
+
401
+ return result;
402
+ },
403
+ validate(value) {
404
+ // first check the value to be sure it's an object
405
+ if (value === null || typeof value !== "object") {
406
+ throw new TypeError("Expected an object.");
407
+ }
408
+
409
+ // make sure it's not an array, which would mean eslintrc-style is used
410
+ if (Array.isArray(value)) {
411
+ throw new IncompatiblePluginsError(value);
412
+ }
413
+
414
+ // second check the keys to make sure they are objects
415
+ for (const key of Object.keys(value)) {
416
+ // avoid hairy edge case
417
+ if (key === "__proto__") {
418
+ continue;
419
+ }
420
+
421
+ if (value[key] === null || typeof value[key] !== "object") {
422
+ throw new TypeError(`Key "${key}": Expected an object.`);
423
+ }
424
+ }
425
+ },
421
426
  };
422
427
 
423
428
  /** @type {ObjectPropertySchema} */
424
429
  const processorSchema = {
425
- merge: "replace",
426
- validate(value) {
427
- if (typeof value === "string") {
428
- assertIsPluginMemberName(value);
429
- } else if (value && typeof value === "object") {
430
- if (typeof value.preprocess !== "function" || typeof value.postprocess !== "function") {
431
- throw new TypeError("Object must have a preprocess() and a postprocess() method.");
432
- }
433
- } else {
434
- throw new TypeError("Expected an object or a string.");
435
- }
436
- }
430
+ merge: "replace",
431
+ validate(value) {
432
+ if (typeof value === "string") {
433
+ assertIsPluginMemberName(value);
434
+ } else if (value && typeof value === "object") {
435
+ if (
436
+ typeof value.preprocess !== "function" ||
437
+ typeof value.postprocess !== "function"
438
+ ) {
439
+ throw new TypeError(
440
+ "Object must have a preprocess() and a postprocess() method.",
441
+ );
442
+ }
443
+ } else {
444
+ throw new TypeError("Expected an object or a string.");
445
+ }
446
+ },
437
447
  };
438
448
 
439
449
  /** @type {ObjectPropertySchema} */
440
450
  const rulesSchema = {
441
- merge(first = {}, second = {}) {
442
-
443
- const result = {
444
- ...first,
445
- ...second
446
- };
447
-
448
-
449
- for (const ruleId of Object.keys(result)) {
450
-
451
- try {
452
-
453
- // avoid hairy edge case
454
- if (ruleId === "__proto__") {
455
-
456
- /* eslint-disable-next-line no-proto -- Though deprecated, may still be present */
457
- delete result.__proto__;
458
- continue;
459
- }
460
-
461
- result[ruleId] = normalizeRuleOptions(result[ruleId]);
462
-
463
- /*
464
- * If either rule config is missing, then the correct
465
- * config is already present and we just need to normalize
466
- * the severity.
467
- */
468
- if (!(ruleId in first) || !(ruleId in second)) {
469
- continue;
470
- }
471
-
472
- const firstRuleOptions = normalizeRuleOptions(first[ruleId]);
473
- const secondRuleOptions = normalizeRuleOptions(second[ruleId]);
474
-
475
- /*
476
- * If the second rule config only has a severity (length of 1),
477
- * then use that severity and keep the rest of the options from
478
- * the first rule config.
479
- */
480
- if (secondRuleOptions.length === 1) {
481
- result[ruleId] = [secondRuleOptions[0], ...firstRuleOptions.slice(1)];
482
- continue;
483
- }
484
-
485
- /*
486
- * In any other situation, then the second rule config takes
487
- * precedence. That means the value at `result[ruleId]` is
488
- * already correct and no further work is necessary.
489
- */
490
- } catch (ex) {
491
- throw new Error(`Key "${ruleId}": ${ex.message}`, { cause: ex });
492
- }
493
-
494
- }
495
-
496
- return result;
497
-
498
-
499
- },
500
-
501
- validate(value) {
502
- assertIsObject(value);
503
-
504
- /*
505
- * We are not checking the rule schema here because there is no
506
- * guarantee that the rule definition is present at this point. Instead
507
- * we wait and check the rule schema during the finalization step
508
- * of calculating a config.
509
- */
510
- for (const ruleId of Object.keys(value)) {
511
-
512
- // avoid hairy edge case
513
- if (ruleId === "__proto__") {
514
- continue;
515
- }
516
-
517
- const ruleOptions = value[ruleId];
518
-
519
- assertIsRuleOptions(ruleId, ruleOptions);
520
-
521
- if (Array.isArray(ruleOptions)) {
522
- assertIsRuleSeverity(ruleId, ruleOptions[0]);
523
- } else {
524
- assertIsRuleSeverity(ruleId, ruleOptions);
525
- }
526
- }
527
- }
451
+ merge(first = {}, second = {}) {
452
+ const result = {
453
+ ...first,
454
+ ...second,
455
+ };
456
+
457
+ for (const ruleId of Object.keys(result)) {
458
+ try {
459
+ // avoid hairy edge case
460
+ if (ruleId === "__proto__") {
461
+ /* eslint-disable-next-line no-proto -- Though deprecated, may still be present */
462
+ delete result.__proto__;
463
+ continue;
464
+ }
465
+
466
+ result[ruleId] = normalizeRuleOptions(result[ruleId]);
467
+
468
+ /*
469
+ * If either rule config is missing, then the correct
470
+ * config is already present and we just need to normalize
471
+ * the severity.
472
+ */
473
+ if (!(ruleId in first) || !(ruleId in second)) {
474
+ continue;
475
+ }
476
+
477
+ const firstRuleOptions = normalizeRuleOptions(first[ruleId]);
478
+ const secondRuleOptions = normalizeRuleOptions(second[ruleId]);
479
+
480
+ /*
481
+ * If the second rule config only has a severity (length of 1),
482
+ * then use that severity and keep the rest of the options from
483
+ * the first rule config.
484
+ */
485
+ if (secondRuleOptions.length === 1) {
486
+ result[ruleId] = [
487
+ secondRuleOptions[0],
488
+ ...firstRuleOptions.slice(1),
489
+ ];
490
+ continue;
491
+ }
492
+
493
+ /*
494
+ * In any other situation, then the second rule config takes
495
+ * precedence. That means the value at `result[ruleId]` is
496
+ * already correct and no further work is necessary.
497
+ */
498
+ } catch (ex) {
499
+ throw new Error(`Key "${ruleId}": ${ex.message}`, {
500
+ cause: ex,
501
+ });
502
+ }
503
+ }
504
+
505
+ return result;
506
+ },
507
+
508
+ validate(value) {
509
+ assertIsObject(value);
510
+
511
+ /*
512
+ * We are not checking the rule schema here because there is no
513
+ * guarantee that the rule definition is present at this point. Instead
514
+ * we wait and check the rule schema during the finalization step
515
+ * of calculating a config.
516
+ */
517
+ for (const ruleId of Object.keys(value)) {
518
+ // avoid hairy edge case
519
+ if (ruleId === "__proto__") {
520
+ continue;
521
+ }
522
+
523
+ const ruleOptions = value[ruleId];
524
+
525
+ assertIsRuleOptions(ruleId, ruleOptions);
526
+
527
+ if (Array.isArray(ruleOptions)) {
528
+ assertIsRuleSeverity(ruleId, ruleOptions[0]);
529
+ } else {
530
+ assertIsRuleSeverity(ruleId, ruleOptions);
531
+ }
532
+ }
533
+ },
528
534
  };
529
535
 
530
536
  /**
@@ -534,25 +540,25 @@ const rulesSchema = {
534
540
  * @returns {ObjectPropertySchema} The schema.
535
541
  */
536
542
  function createEslintrcErrorSchema(key) {
537
- return {
538
- merge: "replace",
539
- validate() {
540
- throw new IncompatibleKeyError(key);
541
- }
542
- };
543
+ return {
544
+ merge: "replace",
545
+ validate() {
546
+ throw new IncompatibleKeyError(key);
547
+ },
548
+ };
543
549
  }
544
550
 
545
551
  const eslintrcKeys = [
546
- "env",
547
- "extends",
548
- "globals",
549
- "ignorePatterns",
550
- "noInlineConfig",
551
- "overrides",
552
- "parser",
553
- "parserOptions",
554
- "reportUnusedDisableDirectives",
555
- "root"
552
+ "env",
553
+ "extends",
554
+ "globals",
555
+ "ignorePatterns",
556
+ "noInlineConfig",
557
+ "overrides",
558
+ "parser",
559
+ "parserOptions",
560
+ "reportUnusedDisableDirectives",
561
+ "root",
556
562
  ];
557
563
 
558
564
  //-----------------------------------------------------------------------------
@@ -560,24 +566,25 @@ const eslintrcKeys = [
560
566
  //-----------------------------------------------------------------------------
561
567
 
562
568
  const flatConfigSchema = {
563
-
564
- // eslintrc-style keys that should always error
565
- ...Object.fromEntries(eslintrcKeys.map(key => [key, createEslintrcErrorSchema(key)])),
566
-
567
- // flat config keys
568
- settings: deepObjectAssignSchema,
569
- linterOptions: {
570
- schema: {
571
- noInlineConfig: booleanSchema,
572
- reportUnusedDisableDirectives: disableDirectiveSeveritySchema,
573
- reportUnusedInlineConfigs: unusedInlineConfigsSeveritySchema
574
- }
575
- },
576
- language: languageSchema,
577
- languageOptions: languageOptionsSchema,
578
- processor: processorSchema,
579
- plugins: pluginsSchema,
580
- rules: rulesSchema
569
+ // eslintrc-style keys that should always error
570
+ ...Object.fromEntries(
571
+ eslintrcKeys.map(key => [key, createEslintrcErrorSchema(key)]),
572
+ ),
573
+
574
+ // flat config keys
575
+ settings: deepObjectAssignSchema,
576
+ linterOptions: {
577
+ schema: {
578
+ noInlineConfig: booleanSchema,
579
+ reportUnusedDisableDirectives: disableDirectiveSeveritySchema,
580
+ reportUnusedInlineConfigs: unusedInlineConfigsSeveritySchema,
581
+ },
582
+ },
583
+ language: languageSchema,
584
+ languageOptions: languageOptionsSchema,
585
+ processor: processorSchema,
586
+ plugins: pluginsSchema,
587
+ rules: rulesSchema,
581
588
  };
582
589
 
583
590
  //-----------------------------------------------------------------------------
@@ -585,7 +592,7 @@ const flatConfigSchema = {
585
592
  //-----------------------------------------------------------------------------
586
593
 
587
594
  module.exports = {
588
- flatConfigSchema,
589
- hasMethod,
590
- assertIsRuleSeverity
595
+ flatConfigSchema,
596
+ hasMethod,
597
+ assertIsRuleSeverity,
591
598
  };