eslint 8.57.1 → 9.39.1

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 (458) hide show
  1. package/README.md +165 -115
  2. package/bin/eslint.js +112 -89
  3. package/conf/default-cli-options.js +22 -22
  4. package/conf/ecma-version.js +16 -0
  5. package/conf/globals.js +109 -94
  6. package/conf/replacements.json +24 -20
  7. package/conf/rule-type-list.json +89 -26
  8. package/lib/api.js +16 -20
  9. package/lib/cli-engine/cli-engine.js +841 -810
  10. package/lib/cli-engine/file-enumerator.js +384 -390
  11. package/lib/cli-engine/formatters/formatters-meta.json +17 -45
  12. package/lib/cli-engine/formatters/html.js +110 -102
  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 +97 -76
  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 +165 -148
  19. package/lib/cli-engine/load-rules.js +17 -17
  20. package/lib/cli.js +481 -399
  21. package/lib/config/config-loader.js +816 -0
  22. package/lib/config/config.js +674 -0
  23. package/lib/config/default-config.js +57 -46
  24. package/lib/config/flat-config-array.js +170 -333
  25. package/lib/config/flat-config-schema.js +389 -389
  26. package/lib/config-api.js +12 -0
  27. package/lib/eslint/eslint-helpers.js +1196 -663
  28. package/lib/eslint/eslint.js +1262 -607
  29. package/lib/eslint/index.js +3 -3
  30. package/lib/eslint/legacy-eslint.js +786 -0
  31. package/lib/eslint/worker.js +173 -0
  32. package/lib/languages/js/index.js +336 -0
  33. package/lib/languages/js/source-code/index.js +7 -0
  34. package/lib/languages/js/source-code/source-code.js +1364 -0
  35. package/lib/languages/js/source-code/token-store/backward-token-comment-cursor.js +61 -0
  36. package/lib/languages/js/source-code/token-store/backward-token-cursor.js +57 -0
  37. package/lib/{source-code → languages/js/source-code}/token-store/cursor.js +36 -36
  38. package/lib/languages/js/source-code/token-store/cursors.js +120 -0
  39. package/lib/{source-code → languages/js/source-code}/token-store/decorative-cursor.js +17 -18
  40. package/lib/{source-code → languages/js/source-code}/token-store/filter-cursor.js +19 -20
  41. package/lib/languages/js/source-code/token-store/forward-token-comment-cursor.js +65 -0
  42. package/lib/languages/js/source-code/token-store/forward-token-cursor.js +62 -0
  43. package/lib/languages/js/source-code/token-store/index.js +721 -0
  44. package/lib/{source-code → languages/js/source-code}/token-store/limit-cursor.js +17 -18
  45. package/lib/languages/js/source-code/token-store/padded-token-cursor.js +45 -0
  46. package/lib/{source-code → languages/js/source-code}/token-store/skip-cursor.js +19 -20
  47. package/lib/languages/js/source-code/token-store/utils.js +110 -0
  48. package/lib/languages/js/validate-language-options.js +196 -0
  49. package/lib/linter/apply-disable-directives.js +490 -371
  50. package/lib/linter/code-path-analysis/code-path-analyzer.js +650 -674
  51. package/lib/linter/code-path-analysis/code-path-segment.js +215 -216
  52. package/lib/linter/code-path-analysis/code-path-state.js +2118 -2096
  53. package/lib/linter/code-path-analysis/code-path.js +307 -317
  54. package/lib/linter/code-path-analysis/debug-helpers.js +183 -163
  55. package/lib/linter/code-path-analysis/fork-context.js +297 -272
  56. package/lib/linter/code-path-analysis/id-generator.js +22 -23
  57. package/lib/linter/esquery.js +332 -0
  58. package/lib/linter/file-context.js +144 -0
  59. package/lib/linter/file-report.js +608 -0
  60. package/lib/linter/index.js +3 -5
  61. package/lib/linter/interpolate.js +38 -16
  62. package/lib/linter/linter.js +2328 -1785
  63. package/lib/linter/rule-fixer.js +136 -107
  64. package/lib/linter/rules.js +37 -46
  65. package/lib/linter/source-code-fixer.js +96 -94
  66. package/lib/linter/source-code-traverser.js +333 -0
  67. package/lib/linter/source-code-visitor.js +81 -0
  68. package/lib/linter/timing.js +145 -97
  69. package/lib/linter/vfile.js +115 -0
  70. package/lib/options.js +464 -326
  71. package/lib/rule-tester/index.js +3 -1
  72. package/lib/rule-tester/rule-tester.js +1371 -998
  73. package/lib/rules/accessor-pairs.js +333 -259
  74. package/lib/rules/array-bracket-newline.js +250 -220
  75. package/lib/rules/array-bracket-spacing.js +286 -229
  76. package/lib/rules/array-callback-return.js +401 -354
  77. package/lib/rules/array-element-newline.js +358 -295
  78. package/lib/rules/arrow-body-style.js +400 -278
  79. package/lib/rules/arrow-parens.js +206 -155
  80. package/lib/rules/arrow-spacing.js +169 -145
  81. package/lib/rules/block-scoped-var.js +125 -123
  82. package/lib/rules/block-spacing.js +186 -158
  83. package/lib/rules/brace-style.js +262 -181
  84. package/lib/rules/callback-return.js +203 -174
  85. package/lib/rules/camelcase.js +403 -380
  86. package/lib/rules/capitalized-comments.js +253 -228
  87. package/lib/rules/class-methods-use-this.js +231 -168
  88. package/lib/rules/comma-dangle.js +379 -328
  89. package/lib/rules/comma-spacing.js +193 -177
  90. package/lib/rules/comma-style.js +375 -298
  91. package/lib/rules/complexity.js +180 -144
  92. package/lib/rules/computed-property-spacing.js +236 -193
  93. package/lib/rules/consistent-return.js +181 -170
  94. package/lib/rules/consistent-this.js +167 -141
  95. package/lib/rules/constructor-super.js +418 -411
  96. package/lib/rules/curly.js +407 -468
  97. package/lib/rules/default-case-last.js +39 -32
  98. package/lib/rules/default-case.js +89 -83
  99. package/lib/rules/default-param-last.js +69 -53
  100. package/lib/rules/dot-location.js +122 -92
  101. package/lib/rules/dot-notation.js +193 -153
  102. package/lib/rules/eol-last.js +122 -102
  103. package/lib/rules/eqeqeq.js +191 -155
  104. package/lib/rules/for-direction.js +150 -122
  105. package/lib/rules/func-call-spacing.js +261 -213
  106. package/lib/rules/func-name-matching.js +294 -209
  107. package/lib/rules/func-names.js +165 -164
  108. package/lib/rules/func-style.js +209 -86
  109. package/lib/rules/function-call-argument-newline.js +152 -111
  110. package/lib/rules/function-paren-newline.js +349 -273
  111. package/lib/rules/generator-star-spacing.js +229 -192
  112. package/lib/rules/getter-return.js +208 -170
  113. package/lib/rules/global-require.js +85 -58
  114. package/lib/rules/grouped-accessor-pairs.js +201 -148
  115. package/lib/rules/guard-for-in.js +72 -63
  116. package/lib/rules/handle-callback-err.js +108 -87
  117. package/lib/rules/id-blacklist.js +182 -187
  118. package/lib/rules/id-denylist.js +174 -179
  119. package/lib/rules/id-length.js +197 -157
  120. package/lib/rules/id-match.js +350 -286
  121. package/lib/rules/implicit-arrow-linebreak.js +102 -61
  122. package/lib/rules/indent-legacy.js +1345 -1102
  123. package/lib/rules/indent.js +2272 -1741
  124. package/lib/rules/index.js +320 -294
  125. package/lib/rules/init-declarations.js +139 -106
  126. package/lib/rules/jsx-quotes.js +94 -64
  127. package/lib/rules/key-spacing.js +750 -615
  128. package/lib/rules/keyword-spacing.js +648 -587
  129. package/lib/rules/line-comment-position.js +143 -108
  130. package/lib/rules/linebreak-style.js +115 -88
  131. package/lib/rules/lines-around-comment.js +540 -430
  132. package/lib/rules/lines-around-directive.js +233 -185
  133. package/lib/rules/lines-between-class-members.js +305 -216
  134. package/lib/rules/logical-assignment-operators.js +582 -398
  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 -416
  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 +102 -75
  142. package/lib/rules/max-statements-per-line.js +205 -180
  143. package/lib/rules/max-statements.js +168 -164
  144. package/lib/rules/multiline-comment-style.js +638 -460
  145. package/lib/rules/multiline-ternary.js +241 -158
  146. package/lib/rules/new-cap.js +233 -232
  147. package/lib/rules/new-parens.js +88 -61
  148. package/lib/rules/newline-after-var.js +287 -233
  149. package/lib/rules/newline-before-return.js +229 -204
  150. package/lib/rules/newline-per-chained-call.js +142 -109
  151. package/lib/rules/no-alert.js +90 -79
  152. package/lib/rules/no-array-constructor.js +175 -113
  153. package/lib/rules/no-async-promise-executor.js +30 -24
  154. package/lib/rules/no-await-in-loop.js +79 -70
  155. package/lib/rules/no-bitwise.js +113 -87
  156. package/lib/rules/no-buffer-constructor.js +61 -37
  157. package/lib/rules/no-caller.js +39 -33
  158. package/lib/rules/no-case-declarations.js +61 -45
  159. package/lib/rules/no-catch-shadow.js +76 -62
  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 -63
  164. package/lib/rules/no-console.js +202 -188
  165. package/lib/rules/no-const-assign.js +58 -41
  166. package/lib/rules/no-constant-binary-expression.js +501 -407
  167. package/lib/rules/no-constant-condition.js +158 -131
  168. package/lib/rules/no-constructor-return.js +49 -49
  169. package/lib/rules/no-continue.js +25 -26
  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 -40
  174. package/lib/rules/no-dupe-args.js +79 -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 +266 -188
  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 +197 -128
  183. package/lib/rules/no-empty-pattern.js +63 -56
  184. package/lib/rules/no-empty-static-block.js +61 -35
  185. package/lib/rules/no-empty.js +135 -85
  186. package/lib/rules/no-eq-null.js +37 -32
  187. package/lib/rules/no-eval.js +258 -249
  188. package/lib/rules/no-ex-assign.js +42 -39
  189. package/lib/rules/no-extend-native.js +161 -160
  190. package/lib/rules/no-extra-bind.js +201 -190
  191. package/lib/rules/no-extra-boolean-cast.js +398 -295
  192. package/lib/rules/no-extra-label.js +150 -130
  193. package/lib/rules/no-extra-parens.js +1654 -1307
  194. package/lib/rules/no-extra-semi.js +146 -126
  195. package/lib/rules/no-fallthrough.js +200 -136
  196. package/lib/rules/no-floating-decimal.js +74 -48
  197. package/lib/rules/no-func-assign.js +54 -55
  198. package/lib/rules/no-global-assign.js +78 -72
  199. package/lib/rules/no-implicit-coercion.js +350 -262
  200. package/lib/rules/no-implicit-globals.js +174 -133
  201. package/lib/rules/no-implied-eval.js +150 -112
  202. package/lib/rules/no-import-assign.js +145 -159
  203. package/lib/rules/no-inline-comments.js +101 -96
  204. package/lib/rules/no-inner-declarations.js +115 -78
  205. package/lib/rules/no-invalid-regexp.js +223 -174
  206. package/lib/rules/no-invalid-this.js +145 -117
  207. package/lib/rules/no-irregular-whitespace.js +266 -250
  208. package/lib/rules/no-iterator.js +29 -33
  209. package/lib/rules/no-label-var.js +59 -61
  210. package/lib/rules/no-labels.js +138 -131
  211. package/lib/rules/no-lone-blocks.js +127 -123
  212. package/lib/rules/no-lonely-if.js +105 -67
  213. package/lib/rules/no-loop-func.js +245 -184
  214. package/lib/rules/no-loss-of-precision.js +236 -201
  215. package/lib/rules/no-magic-numbers.js +339 -217
  216. package/lib/rules/no-misleading-character-class.js +548 -253
  217. package/lib/rules/no-mixed-operators.js +188 -164
  218. package/lib/rules/no-mixed-requires.js +253 -224
  219. package/lib/rules/no-mixed-spaces-and-tabs.js +135 -103
  220. package/lib/rules/no-multi-assign.js +46 -47
  221. package/lib/rules/no-multi-spaces.js +163 -125
  222. package/lib/rules/no-multi-str.js +42 -40
  223. package/lib/rules/no-multiple-empty-lines.js +196 -140
  224. package/lib/rules/no-native-reassign.js +90 -74
  225. package/lib/rules/no-negated-condition.js +79 -74
  226. package/lib/rules/no-negated-in-lhs.js +45 -32
  227. package/lib/rules/no-nested-ternary.js +33 -31
  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 -39
  231. package/lib/rules/no-new-require.js +48 -31
  232. package/lib/rules/no-new-symbol.js +61 -43
  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 +149 -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 +29 -32
  240. package/lib/rules/no-param-reassign.js +236 -218
  241. package/lib/rules/no-path-concat.js +66 -51
  242. package/lib/rules/no-plusplus.js +60 -63
  243. package/lib/rules/no-process-env.js +49 -32
  244. package/lib/rules/no-process-exit.js +48 -28
  245. package/lib/rules/no-promise-executor-return.js +205 -204
  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 -155
  249. package/lib/rules/no-regex-spaces.js +183 -161
  250. package/lib/rules/no-restricted-exports.js +208 -174
  251. package/lib/rules/no-restricted-globals.js +254 -112
  252. package/lib/rules/no-restricted-imports.js +824 -384
  253. package/lib/rules/no-restricted-modules.js +222 -186
  254. package/lib/rules/no-restricted-properties.js +218 -153
  255. package/lib/rules/no-restricted-syntax.js +56 -52
  256. package/lib/rules/no-return-assign.js +56 -49
  257. package/lib/rules/no-return-await.js +147 -120
  258. package/lib/rules/no-script-url.js +53 -46
  259. package/lib/rules/no-self-assign.js +148 -145
  260. package/lib/rules/no-self-compare.js +63 -46
  261. package/lib/rules/no-sequences.js +135 -115
  262. package/lib/rules/no-setter-return.js +176 -178
  263. package/lib/rules/no-shadow-restricted-names.js +84 -36
  264. package/lib/rules/no-shadow.js +598 -310
  265. package/lib/rules/no-spaced-func.js +82 -60
  266. package/lib/rules/no-sparse-arrays.js +46 -28
  267. package/lib/rules/no-sync.js +61 -44
  268. package/lib/rules/no-tabs.js +83 -54
  269. package/lib/rules/no-template-curly-in-string.js +33 -32
  270. package/lib/rules/no-ternary.js +25 -28
  271. package/lib/rules/no-this-before-super.js +332 -298
  272. package/lib/rules/no-throw-literal.js +31 -36
  273. package/lib/rules/no-trailing-spaces.js +208 -174
  274. package/lib/rules/no-unassigned-vars.js +80 -0
  275. package/lib/rules/no-undef-init.js +86 -60
  276. package/lib/rules/no-undef.js +52 -47
  277. package/lib/rules/no-undefined.js +73 -74
  278. package/lib/rules/no-underscore-dangle.js +370 -322
  279. package/lib/rules/no-unexpected-multiline.js +112 -102
  280. package/lib/rules/no-unmodified-loop-condition.js +254 -254
  281. package/lib/rules/no-unneeded-ternary.js +212 -146
  282. package/lib/rules/no-unreachable-loop.js +145 -140
  283. package/lib/rules/no-unreachable.js +255 -248
  284. package/lib/rules/no-unsafe-finally.js +93 -85
  285. package/lib/rules/no-unsafe-negation.js +105 -81
  286. package/lib/rules/no-unsafe-optional-chaining.js +193 -177
  287. package/lib/rules/no-unused-expressions.js +199 -158
  288. package/lib/rules/no-unused-labels.js +139 -124
  289. package/lib/rules/no-unused-private-class-members.js +206 -182
  290. package/lib/rules/no-unused-vars.js +1708 -687
  291. package/lib/rules/no-use-before-define.js +327 -229
  292. package/lib/rules/no-useless-assignment.js +654 -0
  293. package/lib/rules/no-useless-backreference.js +212 -143
  294. package/lib/rules/no-useless-call.js +58 -53
  295. package/lib/rules/no-useless-catch.js +40 -40
  296. package/lib/rules/no-useless-computed-key.js +144 -108
  297. package/lib/rules/no-useless-concat.js +65 -59
  298. package/lib/rules/no-useless-constructor.js +160 -97
  299. package/lib/rules/no-useless-escape.js +364 -291
  300. package/lib/rules/no-useless-rename.js +183 -153
  301. package/lib/rules/no-useless-return.js +344 -307
  302. package/lib/rules/no-var.js +245 -212
  303. package/lib/rules/no-void.js +51 -46
  304. package/lib/rules/no-warning-comments.js +191 -183
  305. package/lib/rules/no-whitespace-before-property.js +131 -97
  306. package/lib/rules/no-with.js +24 -26
  307. package/lib/rules/nonblock-statement-body-position.js +149 -112
  308. package/lib/rules/object-curly-newline.js +306 -247
  309. package/lib/rules/object-curly-spacing.js +360 -296
  310. package/lib/rules/object-property-newline.js +137 -88
  311. package/lib/rules/object-shorthand.js +632 -500
  312. package/lib/rules/one-var-declaration-per-line.js +104 -82
  313. package/lib/rules/one-var.js +686 -536
  314. package/lib/rules/operator-assignment.js +219 -158
  315. package/lib/rules/operator-linebreak.js +295 -233
  316. package/lib/rules/padded-blocks.js +346 -290
  317. package/lib/rules/padding-line-between-statements.js +443 -421
  318. package/lib/rules/prefer-arrow-callback.js +371 -315
  319. package/lib/rules/prefer-const.js +418 -373
  320. package/lib/rules/prefer-destructuring.js +309 -278
  321. package/lib/rules/prefer-exponentiation-operator.js +176 -132
  322. package/lib/rules/prefer-named-capture-group.js +160 -141
  323. package/lib/rules/prefer-numeric-literals.js +121 -112
  324. package/lib/rules/prefer-object-has-own.js +116 -82
  325. package/lib/rules/prefer-object-spread.js +214 -193
  326. package/lib/rules/prefer-promise-reject-errors.js +140 -118
  327. package/lib/rules/prefer-reflect.js +126 -103
  328. package/lib/rules/prefer-regex-literals.js +561 -463
  329. package/lib/rules/prefer-rest-params.js +79 -80
  330. package/lib/rules/prefer-spread.js +47 -43
  331. package/lib/rules/prefer-template.js +266 -194
  332. package/lib/rules/preserve-caught-error.js +535 -0
  333. package/lib/rules/quote-props.js +373 -289
  334. package/lib/rules/quotes.js +374 -308
  335. package/lib/rules/radix.js +152 -134
  336. package/lib/rules/require-atomic-updates.js +316 -282
  337. package/lib/rules/require-await.js +153 -82
  338. package/lib/rules/require-unicode-regexp.js +296 -108
  339. package/lib/rules/require-yield.js +53 -54
  340. package/lib/rules/rest-spread-spacing.js +128 -98
  341. package/lib/rules/semi-spacing.js +281 -232
  342. package/lib/rules/semi-style.js +176 -116
  343. package/lib/rules/semi.js +456 -418
  344. package/lib/rules/sort-imports.js +307 -229
  345. package/lib/rules/sort-keys.js +219 -181
  346. package/lib/rules/sort-vars.js +127 -91
  347. package/lib/rules/space-before-blocks.js +199 -171
  348. package/lib/rules/space-before-function-paren.js +186 -148
  349. package/lib/rules/space-in-parens.js +359 -270
  350. package/lib/rules/space-infix-ops.js +237 -183
  351. package/lib/rules/space-unary-ops.js +356 -280
  352. package/lib/rules/spaced-comment.js +363 -301
  353. package/lib/rules/strict.js +266 -229
  354. package/lib/rules/switch-colon-spacing.js +130 -104
  355. package/lib/rules/symbol-description.js +45 -48
  356. package/lib/rules/template-curly-spacing.js +148 -124
  357. package/lib/rules/template-tag-spacing.js +98 -70
  358. package/lib/rules/unicode-bom.js +54 -54
  359. package/lib/rules/use-isnan.js +237 -110
  360. package/lib/rules/utils/ast-utils.js +2139 -1688
  361. package/lib/rules/utils/char-source.js +247 -0
  362. package/lib/rules/utils/fix-tracker.js +99 -88
  363. package/lib/rules/utils/keywords.js +59 -59
  364. package/lib/rules/utils/lazy-loading-rule-map.js +81 -78
  365. package/lib/rules/utils/regular-expressions.js +35 -19
  366. package/lib/rules/utils/unicode/index.js +9 -4
  367. package/lib/rules/utils/unicode/is-combining-character.js +1 -1
  368. package/lib/rules/utils/unicode/is-emoji-modifier.js +1 -1
  369. package/lib/rules/utils/unicode/is-regional-indicator-symbol.js +1 -1
  370. package/lib/rules/utils/unicode/is-surrogate-pair.js +1 -1
  371. package/lib/rules/valid-typeof.js +153 -109
  372. package/lib/rules/vars-on-top.js +152 -144
  373. package/lib/rules/wrap-iife.js +204 -173
  374. package/lib/rules/wrap-regex.js +77 -47
  375. package/lib/rules/yield-star-spacing.js +145 -116
  376. package/lib/rules/yoda.js +283 -274
  377. package/lib/services/parser-service.js +65 -0
  378. package/lib/services/processor-service.js +101 -0
  379. package/lib/services/suppressions-service.js +302 -0
  380. package/lib/services/warning-service.js +98 -0
  381. package/lib/shared/ajv.js +14 -14
  382. package/lib/shared/assert.js +21 -0
  383. package/lib/shared/ast-utils.js +7 -6
  384. package/lib/shared/deep-merge-arrays.js +62 -0
  385. package/lib/shared/directives.js +3 -2
  386. package/lib/shared/flags.js +108 -0
  387. package/lib/shared/logging.js +24 -16
  388. package/lib/shared/naming.js +109 -0
  389. package/lib/shared/option-utils.js +63 -0
  390. package/lib/shared/relative-module-resolver.js +18 -40
  391. package/lib/shared/runtime-info.js +138 -128
  392. package/lib/shared/serialization.js +78 -0
  393. package/lib/shared/severity.js +22 -22
  394. package/lib/shared/stats.js +30 -0
  395. package/lib/shared/string-utils.js +19 -21
  396. package/lib/shared/text-table.js +68 -0
  397. package/lib/shared/translate-cli-options.js +281 -0
  398. package/lib/shared/traverser.js +153 -146
  399. package/lib/types/config-api.d.ts +12 -0
  400. package/lib/types/index.d.ts +1473 -0
  401. package/lib/types/rules.d.ts +5589 -0
  402. package/lib/types/universal.d.ts +6 -0
  403. package/lib/types/use-at-your-own-risk.d.ts +87 -0
  404. package/lib/universal.js +10 -0
  405. package/lib/unsupported-api.js +8 -9
  406. package/messages/all-files-ignored.js +3 -3
  407. package/messages/all-matched-files-ignored.js +21 -0
  408. package/messages/config-file-missing.js +16 -0
  409. package/messages/config-plugin-missing.js +14 -0
  410. package/messages/config-serialize-function.js +30 -0
  411. package/messages/eslintrc-incompat.js +35 -16
  412. package/messages/eslintrc-plugins.js +8 -5
  413. package/messages/extend-config-missing.js +3 -3
  414. package/messages/failed-to-read-json.js +3 -3
  415. package/messages/file-not-found.js +3 -3
  416. package/messages/invalid-rule-options.js +2 -2
  417. package/messages/invalid-rule-severity.js +2 -2
  418. package/messages/no-config-found.js +4 -4
  419. package/messages/plugin-conflict.js +9 -9
  420. package/messages/plugin-invalid.js +4 -4
  421. package/messages/plugin-missing.js +4 -4
  422. package/messages/print-config-with-directory-path.js +2 -2
  423. package/messages/shared.js +6 -1
  424. package/messages/whitespace-found.js +3 -3
  425. package/package.json +105 -60
  426. package/conf/config-schema.js +0 -93
  427. package/lib/cli-engine/formatters/checkstyle.js +0 -60
  428. package/lib/cli-engine/formatters/compact.js +0 -60
  429. package/lib/cli-engine/formatters/jslint-xml.js +0 -41
  430. package/lib/cli-engine/formatters/junit.js +0 -82
  431. package/lib/cli-engine/formatters/tap.js +0 -95
  432. package/lib/cli-engine/formatters/unix.js +0 -58
  433. package/lib/cli-engine/formatters/visualstudio.js +0 -63
  434. package/lib/cli-engine/xml-escape.js +0 -34
  435. package/lib/config/flat-config-helpers.js +0 -111
  436. package/lib/config/rule-validator.js +0 -158
  437. package/lib/eslint/flat-eslint.js +0 -1159
  438. package/lib/linter/config-comment-parser.js +0 -185
  439. package/lib/linter/node-event-generator.js +0 -354
  440. package/lib/linter/report-translator.js +0 -369
  441. package/lib/linter/safe-emitter.js +0 -52
  442. package/lib/rule-tester/flat-rule-tester.js +0 -1131
  443. package/lib/rules/require-jsdoc.js +0 -122
  444. package/lib/rules/utils/patterns/letters.js +0 -36
  445. package/lib/rules/valid-jsdoc.js +0 -516
  446. package/lib/shared/config-validator.js +0 -347
  447. package/lib/shared/deprecation-warnings.js +0 -58
  448. package/lib/shared/types.js +0 -216
  449. package/lib/source-code/index.js +0 -5
  450. package/lib/source-code/source-code.js +0 -1055
  451. package/lib/source-code/token-store/backward-token-comment-cursor.js +0 -57
  452. package/lib/source-code/token-store/backward-token-cursor.js +0 -58
  453. package/lib/source-code/token-store/cursors.js +0 -90
  454. package/lib/source-code/token-store/forward-token-comment-cursor.js +0 -57
  455. package/lib/source-code/token-store/forward-token-cursor.js +0 -63
  456. package/lib/source-code/token-store/index.js +0 -627
  457. package/lib/source-code/token-store/padded-token-cursor.js +0 -38
  458. package/lib/source-code/token-store/utils.js +0 -107
@@ -10,8 +10,16 @@
10
10
  //------------------------------------------------------------------------------
11
11
 
12
12
  const astUtils = require("./utils/ast-utils");
13
- const { CALL, CONSTRUCT, ReferenceTracker, findVariable } = require("@eslint-community/eslint-utils");
14
- const { RegExpValidator, visitRegExpAST, RegExpParser } = require("@eslint-community/regexpp");
13
+ const {
14
+ CALL,
15
+ CONSTRUCT,
16
+ ReferenceTracker,
17
+ } = require("@eslint-community/eslint-utils");
18
+ const {
19
+ RegExpValidator,
20
+ visitRegExpAST,
21
+ RegExpParser,
22
+ } = require("@eslint-community/regexpp");
15
23
  const { canTokensBeAdjacent } = require("./utils/ast-utils");
16
24
  const { REGEXPP_LATEST_ECMA_VERSION } = require("./utils/regular-expressions");
17
25
 
@@ -25,7 +33,7 @@ const { REGEXPP_LATEST_ECMA_VERSION } = require("./utils/regular-expressions");
25
33
  * @returns {boolean} True if the node is a string literal.
26
34
  */
27
35
  function isStringLiteral(node) {
28
- return node.type === "Literal" && typeof node.value === "string";
36
+ return node.type === "Literal" && typeof node.value === "string";
29
37
  }
30
38
 
31
39
  /**
@@ -34,474 +42,564 @@ function isStringLiteral(node) {
34
42
  * @returns {boolean} True if the node is a regex literal.
35
43
  */
36
44
  function isRegexLiteral(node) {
37
- return node.type === "Literal" && Object.prototype.hasOwnProperty.call(node, "regex");
45
+ return node.type === "Literal" && Object.hasOwn(node, "regex");
38
46
  }
39
47
 
40
48
  const validPrecedingTokens = new Set([
41
- "(",
42
- ";",
43
- "[",
44
- ",",
45
- "=",
46
- "+",
47
- "*",
48
- "-",
49
- "?",
50
- "~",
51
- "%",
52
- "**",
53
- "!",
54
- "typeof",
55
- "instanceof",
56
- "&&",
57
- "||",
58
- "??",
59
- "return",
60
- "...",
61
- "delete",
62
- "void",
63
- "in",
64
- "<",
65
- ">",
66
- "<=",
67
- ">=",
68
- "==",
69
- "===",
70
- "!=",
71
- "!==",
72
- "<<",
73
- ">>",
74
- ">>>",
75
- "&",
76
- "|",
77
- "^",
78
- ":",
79
- "{",
80
- "=>",
81
- "*=",
82
- "<<=",
83
- ">>=",
84
- ">>>=",
85
- "^=",
86
- "|=",
87
- "&=",
88
- "??=",
89
- "||=",
90
- "&&=",
91
- "**=",
92
- "+=",
93
- "-=",
94
- "/=",
95
- "%=",
96
- "/",
97
- "do",
98
- "break",
99
- "continue",
100
- "debugger",
101
- "case",
102
- "throw"
49
+ "(",
50
+ ";",
51
+ "[",
52
+ ",",
53
+ "=",
54
+ "+",
55
+ "*",
56
+ "-",
57
+ "?",
58
+ "~",
59
+ "%",
60
+ "**",
61
+ "!",
62
+ "typeof",
63
+ "instanceof",
64
+ "&&",
65
+ "||",
66
+ "??",
67
+ "return",
68
+ "...",
69
+ "delete",
70
+ "void",
71
+ "in",
72
+ "<",
73
+ ">",
74
+ "<=",
75
+ ">=",
76
+ "==",
77
+ "===",
78
+ "!=",
79
+ "!==",
80
+ "<<",
81
+ ">>",
82
+ ">>>",
83
+ "&",
84
+ "|",
85
+ "^",
86
+ ":",
87
+ "{",
88
+ "=>",
89
+ "*=",
90
+ "<<=",
91
+ ">>=",
92
+ ">>>=",
93
+ "^=",
94
+ "|=",
95
+ "&=",
96
+ "??=",
97
+ "||=",
98
+ "&&=",
99
+ "**=",
100
+ "+=",
101
+ "-=",
102
+ "/=",
103
+ "%=",
104
+ "/",
105
+ "do",
106
+ "break",
107
+ "continue",
108
+ "debugger",
109
+ "case",
110
+ "throw",
103
111
  ]);
104
112
 
105
-
106
113
  //------------------------------------------------------------------------------
107
114
  // Rule Definition
108
115
  //------------------------------------------------------------------------------
109
116
 
110
- /** @type {import('../shared/types').Rule} */
117
+ /** @type {import('../types').Rule.RuleModule} */
111
118
  module.exports = {
112
- meta: {
113
- type: "suggestion",
114
-
115
- docs: {
116
- description: "Disallow use of the `RegExp` constructor in favor of regular expression literals",
117
- recommended: false,
118
- url: "https://eslint.org/docs/latest/rules/prefer-regex-literals"
119
- },
120
-
121
- hasSuggestions: true,
122
-
123
- schema: [
124
- {
125
- type: "object",
126
- properties: {
127
- disallowRedundantWrapping: {
128
- type: "boolean",
129
- default: false
130
- }
131
- },
132
- additionalProperties: false
133
- }
134
- ],
135
-
136
- messages: {
137
- unexpectedRegExp: "Use a regular expression literal instead of the 'RegExp' constructor.",
138
- replaceWithLiteral: "Replace with an equivalent regular expression literal.",
139
- replaceWithLiteralAndFlags: "Replace with an equivalent regular expression literal with flags '{{ flags }}'.",
140
- replaceWithIntendedLiteralAndFlags: "Replace with a regular expression literal with flags '{{ flags }}'.",
141
- unexpectedRedundantRegExp: "Regular expression literal is unnecessarily wrapped within a 'RegExp' constructor.",
142
- unexpectedRedundantRegExpWithFlags: "Use regular expression literal with flags instead of the 'RegExp' constructor."
143
- }
144
- },
145
-
146
- create(context) {
147
- const [{ disallowRedundantWrapping = false } = {}] = context.options;
148
- const sourceCode = context.sourceCode;
149
-
150
- /**
151
- * Determines whether the given identifier node is a reference to a global variable.
152
- * @param {ASTNode} node `Identifier` node to check.
153
- * @returns {boolean} True if the identifier is a reference to a global variable.
154
- */
155
- function isGlobalReference(node) {
156
- const scope = sourceCode.getScope(node);
157
- const variable = findVariable(scope, node);
158
-
159
- return variable !== null && variable.scope.type === "global" && variable.defs.length === 0;
160
- }
161
-
162
- /**
163
- * Determines whether the given node is a String.raw`` tagged template expression
164
- * with a static template literal.
165
- * @param {ASTNode} node Node to check.
166
- * @returns {boolean} True if the node is String.raw`` with a static template.
167
- */
168
- function isStringRawTaggedStaticTemplateLiteral(node) {
169
- return node.type === "TaggedTemplateExpression" &&
170
- astUtils.isSpecificMemberAccess(node.tag, "String", "raw") &&
171
- isGlobalReference(astUtils.skipChainExpression(node.tag).object) &&
172
- astUtils.isStaticTemplateLiteral(node.quasi);
173
- }
174
-
175
- /**
176
- * Gets the value of a string
177
- * @param {ASTNode} node The node to get the string of.
178
- * @returns {string|null} The value of the node.
179
- */
180
- function getStringValue(node) {
181
- if (isStringLiteral(node)) {
182
- return node.value;
183
- }
184
-
185
- if (astUtils.isStaticTemplateLiteral(node)) {
186
- return node.quasis[0].value.cooked;
187
- }
188
-
189
- if (isStringRawTaggedStaticTemplateLiteral(node)) {
190
- return node.quasi.quasis[0].value.raw;
191
- }
192
-
193
- return null;
194
- }
195
-
196
- /**
197
- * Determines whether the given node is considered to be a static string by the logic of this rule.
198
- * @param {ASTNode} node Node to check.
199
- * @returns {boolean} True if the node is a static string.
200
- */
201
- function isStaticString(node) {
202
- return isStringLiteral(node) ||
203
- astUtils.isStaticTemplateLiteral(node) ||
204
- isStringRawTaggedStaticTemplateLiteral(node);
205
- }
206
-
207
- /**
208
- * Determines whether the relevant arguments of the given are all static string literals.
209
- * @param {ASTNode} node Node to check.
210
- * @returns {boolean} True if all arguments are static strings.
211
- */
212
- function hasOnlyStaticStringArguments(node) {
213
- const args = node.arguments;
214
-
215
- if ((args.length === 1 || args.length === 2) && args.every(isStaticString)) {
216
- return true;
217
- }
218
-
219
- return false;
220
- }
221
-
222
- /**
223
- * Determines whether the arguments of the given node indicate that a regex literal is unnecessarily wrapped.
224
- * @param {ASTNode} node Node to check.
225
- * @returns {boolean} True if the node already contains a regex literal argument.
226
- */
227
- function isUnnecessarilyWrappedRegexLiteral(node) {
228
- const args = node.arguments;
229
-
230
- if (args.length === 1 && isRegexLiteral(args[0])) {
231
- return true;
232
- }
233
-
234
- if (args.length === 2 && isRegexLiteral(args[0]) && isStaticString(args[1])) {
235
- return true;
236
- }
237
-
238
- return false;
239
- }
240
-
241
- /**
242
- * Returns a ecmaVersion compatible for regexpp.
243
- * @param {number} ecmaVersion The ecmaVersion to convert.
244
- * @returns {import("@eslint-community/regexpp/ecma-versions").EcmaVersion} The resulting ecmaVersion compatible for regexpp.
245
- */
246
- function getRegexppEcmaVersion(ecmaVersion) {
247
- if (ecmaVersion <= 5) {
248
- return 5;
249
- }
250
- return Math.min(ecmaVersion, REGEXPP_LATEST_ECMA_VERSION);
251
- }
252
-
253
- const regexppEcmaVersion = getRegexppEcmaVersion(context.languageOptions.ecmaVersion);
254
-
255
- /**
256
- * Makes a character escaped or else returns null.
257
- * @param {string} character The character to escape.
258
- * @returns {string} The resulting escaped character.
259
- */
260
- function resolveEscapes(character) {
261
- switch (character) {
262
- case "\n":
263
- case "\\\n":
264
- return "\\n";
265
-
266
- case "\r":
267
- case "\\\r":
268
- return "\\r";
269
-
270
- case "\t":
271
- case "\\\t":
272
- return "\\t";
273
-
274
- case "\v":
275
- case "\\\v":
276
- return "\\v";
277
-
278
- case "\f":
279
- case "\\\f":
280
- return "\\f";
281
-
282
- case "/":
283
- return "\\/";
284
-
285
- default:
286
- return null;
287
- }
288
- }
289
-
290
- /**
291
- * Checks whether the given regex and flags are valid for the ecma version or not.
292
- * @param {string} pattern The regex pattern to check.
293
- * @param {string | undefined} flags The regex flags to check.
294
- * @returns {boolean} True if the given regex pattern and flags are valid for the ecma version.
295
- */
296
- function isValidRegexForEcmaVersion(pattern, flags) {
297
- const validator = new RegExpValidator({ ecmaVersion: regexppEcmaVersion });
298
-
299
- try {
300
- validator.validatePattern(pattern, 0, pattern.length, {
301
- unicode: flags ? flags.includes("u") : false,
302
- unicodeSets: flags ? flags.includes("v") : false
303
- });
304
- if (flags) {
305
- validator.validateFlags(flags);
306
- }
307
- return true;
308
- } catch {
309
- return false;
310
- }
311
- }
312
-
313
- /**
314
- * Checks whether two given regex flags contain the same flags or not.
315
- * @param {string} flagsA The regex flags.
316
- * @param {string} flagsB The regex flags.
317
- * @returns {boolean} True if two regex flags contain same flags.
318
- */
319
- function areFlagsEqual(flagsA, flagsB) {
320
- return [...flagsA].sort().join("") === [...flagsB].sort().join("");
321
- }
322
-
323
-
324
- /**
325
- * Merges two regex flags.
326
- * @param {string} flagsA The regex flags.
327
- * @param {string} flagsB The regex flags.
328
- * @returns {string} The merged regex flags.
329
- */
330
- function mergeRegexFlags(flagsA, flagsB) {
331
- const flagsSet = new Set([
332
- ...flagsA,
333
- ...flagsB
334
- ]);
335
-
336
- return [...flagsSet].join("");
337
- }
338
-
339
- /**
340
- * Checks whether a give node can be fixed to the given regex pattern and flags.
341
- * @param {ASTNode} node The node to check.
342
- * @param {string} pattern The regex pattern to check.
343
- * @param {string} flags The regex flags
344
- * @returns {boolean} True if a node can be fixed to the given regex pattern and flags.
345
- */
346
- function canFixTo(node, pattern, flags) {
347
- const tokenBefore = sourceCode.getTokenBefore(node);
348
-
349
- return sourceCode.getCommentsInside(node).length === 0 &&
350
- (!tokenBefore || validPrecedingTokens.has(tokenBefore.value)) &&
351
- isValidRegexForEcmaVersion(pattern, flags);
352
- }
353
-
354
- /**
355
- * Returns a safe output code considering the before and after tokens.
356
- * @param {ASTNode} node The regex node.
357
- * @param {string} newRegExpValue The new regex expression value.
358
- * @returns {string} The output code.
359
- */
360
- function getSafeOutput(node, newRegExpValue) {
361
- const tokenBefore = sourceCode.getTokenBefore(node);
362
- const tokenAfter = sourceCode.getTokenAfter(node);
363
-
364
- return (tokenBefore && !canTokensBeAdjacent(tokenBefore, newRegExpValue) && tokenBefore.range[1] === node.range[0] ? " " : "") +
365
- newRegExpValue +
366
- (tokenAfter && !canTokensBeAdjacent(newRegExpValue, tokenAfter) && node.range[1] === tokenAfter.range[0] ? " " : "");
367
-
368
- }
369
-
370
- return {
371
- Program(node) {
372
- const scope = sourceCode.getScope(node);
373
- const tracker = new ReferenceTracker(scope);
374
- const traceMap = {
375
- RegExp: {
376
- [CALL]: true,
377
- [CONSTRUCT]: true
378
- }
379
- };
380
-
381
- for (const { node: refNode } of tracker.iterateGlobalReferences(traceMap)) {
382
- if (disallowRedundantWrapping && isUnnecessarilyWrappedRegexLiteral(refNode)) {
383
- const regexNode = refNode.arguments[0];
384
-
385
- if (refNode.arguments.length === 2) {
386
- const suggests = [];
387
-
388
- const argFlags = getStringValue(refNode.arguments[1]) || "";
389
-
390
- if (canFixTo(refNode, regexNode.regex.pattern, argFlags)) {
391
- suggests.push({
392
- messageId: "replaceWithLiteralAndFlags",
393
- pattern: regexNode.regex.pattern,
394
- flags: argFlags
395
- });
396
- }
397
-
398
- const literalFlags = regexNode.regex.flags || "";
399
- const mergedFlags = mergeRegexFlags(literalFlags, argFlags);
400
-
401
- if (
402
- !areFlagsEqual(mergedFlags, argFlags) &&
403
- canFixTo(refNode, regexNode.regex.pattern, mergedFlags)
404
- ) {
405
- suggests.push({
406
- messageId: "replaceWithIntendedLiteralAndFlags",
407
- pattern: regexNode.regex.pattern,
408
- flags: mergedFlags
409
- });
410
- }
411
-
412
- context.report({
413
- node: refNode,
414
- messageId: "unexpectedRedundantRegExpWithFlags",
415
- suggest: suggests.map(({ flags, pattern, messageId }) => ({
416
- messageId,
417
- data: {
418
- flags
419
- },
420
- fix(fixer) {
421
- return fixer.replaceText(refNode, getSafeOutput(refNode, `/${pattern}/${flags}`));
422
- }
423
- }))
424
- });
425
- } else {
426
- const outputs = [];
427
-
428
- if (canFixTo(refNode, regexNode.regex.pattern, regexNode.regex.flags)) {
429
- outputs.push(sourceCode.getText(regexNode));
430
- }
431
-
432
-
433
- context.report({
434
- node: refNode,
435
- messageId: "unexpectedRedundantRegExp",
436
- suggest: outputs.map(output => ({
437
- messageId: "replaceWithLiteral",
438
- fix(fixer) {
439
- return fixer.replaceText(
440
- refNode,
441
- getSafeOutput(refNode, output)
442
- );
443
- }
444
- }))
445
- });
446
- }
447
- } else if (hasOnlyStaticStringArguments(refNode)) {
448
- let regexContent = getStringValue(refNode.arguments[0]);
449
- let noFix = false;
450
- let flags;
451
-
452
- if (refNode.arguments[1]) {
453
- flags = getStringValue(refNode.arguments[1]);
454
- }
455
-
456
- if (!canFixTo(refNode, regexContent, flags)) {
457
- noFix = true;
458
- }
459
-
460
- if (!/^[-a-zA-Z0-9\\[\](){} \t\r\n\v\f!@#$%^&*+^_=/~`.><?,'"|:;]*$/u.test(regexContent)) {
461
- noFix = true;
462
- }
463
-
464
- if (regexContent && !noFix) {
465
- let charIncrease = 0;
466
-
467
- const ast = new RegExpParser({ ecmaVersion: regexppEcmaVersion }).parsePattern(regexContent, 0, regexContent.length, {
468
- unicode: flags ? flags.includes("u") : false,
469
- unicodeSets: flags ? flags.includes("v") : false
470
- });
471
-
472
- visitRegExpAST(ast, {
473
- onCharacterEnter(characterNode) {
474
- const escaped = resolveEscapes(characterNode.raw);
475
-
476
- if (escaped) {
477
- regexContent =
478
- regexContent.slice(0, characterNode.start + charIncrease) +
479
- escaped +
480
- regexContent.slice(characterNode.end + charIncrease);
481
-
482
- if (characterNode.raw.length === 1) {
483
- charIncrease += 1;
484
- }
485
- }
486
- }
487
- });
488
- }
489
-
490
- const newRegExpValue = `/${regexContent || "(?:)"}/${flags || ""}`;
491
-
492
- context.report({
493
- node: refNode,
494
- messageId: "unexpectedRegExp",
495
- suggest: noFix ? [] : [{
496
- messageId: "replaceWithLiteral",
497
- fix(fixer) {
498
- return fixer.replaceText(refNode, getSafeOutput(refNode, newRegExpValue));
499
- }
500
- }]
501
- });
502
- }
503
- }
504
- }
505
- };
506
- }
119
+ meta: {
120
+ type: "suggestion",
121
+
122
+ defaultOptions: [
123
+ {
124
+ disallowRedundantWrapping: false,
125
+ },
126
+ ],
127
+
128
+ docs: {
129
+ description:
130
+ "Disallow use of the `RegExp` constructor in favor of regular expression literals",
131
+ recommended: false,
132
+ url: "https://eslint.org/docs/latest/rules/prefer-regex-literals",
133
+ },
134
+
135
+ hasSuggestions: true,
136
+
137
+ schema: [
138
+ {
139
+ type: "object",
140
+ properties: {
141
+ disallowRedundantWrapping: {
142
+ type: "boolean",
143
+ },
144
+ },
145
+ additionalProperties: false,
146
+ },
147
+ ],
148
+
149
+ messages: {
150
+ unexpectedRegExp:
151
+ "Use a regular expression literal instead of the 'RegExp' constructor.",
152
+ replaceWithLiteral:
153
+ "Replace with an equivalent regular expression literal.",
154
+ replaceWithLiteralAndFlags:
155
+ "Replace with an equivalent regular expression literal with flags '{{ flags }}'.",
156
+ replaceWithIntendedLiteralAndFlags:
157
+ "Replace with a regular expression literal with flags '{{ flags }}'.",
158
+ unexpectedRedundantRegExp:
159
+ "Regular expression literal is unnecessarily wrapped within a 'RegExp' constructor.",
160
+ unexpectedRedundantRegExpWithFlags:
161
+ "Use regular expression literal with flags instead of the 'RegExp' constructor.",
162
+ },
163
+ },
164
+
165
+ create(context) {
166
+ const [{ disallowRedundantWrapping }] = context.options;
167
+ const sourceCode = context.sourceCode;
168
+
169
+ /**
170
+ * Determines whether the given node is a String.raw`` tagged template expression
171
+ * with a static template literal.
172
+ * @param {ASTNode} node Node to check.
173
+ * @returns {boolean} True if the node is String.raw`` with a static template.
174
+ */
175
+ function isStringRawTaggedStaticTemplateLiteral(node) {
176
+ return (
177
+ node.type === "TaggedTemplateExpression" &&
178
+ astUtils.isSpecificMemberAccess(node.tag, "String", "raw") &&
179
+ sourceCode.isGlobalReference(
180
+ astUtils.skipChainExpression(node.tag).object,
181
+ ) &&
182
+ astUtils.isStaticTemplateLiteral(node.quasi)
183
+ );
184
+ }
185
+
186
+ /**
187
+ * Gets the value of a string
188
+ * @param {ASTNode} node The node to get the string of.
189
+ * @returns {string|null} The value of the node.
190
+ */
191
+ function getStringValue(node) {
192
+ if (isStringLiteral(node)) {
193
+ return node.value;
194
+ }
195
+
196
+ if (astUtils.isStaticTemplateLiteral(node)) {
197
+ return node.quasis[0].value.cooked;
198
+ }
199
+
200
+ if (isStringRawTaggedStaticTemplateLiteral(node)) {
201
+ return node.quasi.quasis[0].value.raw;
202
+ }
203
+
204
+ return null;
205
+ }
206
+
207
+ /**
208
+ * Determines whether the given node is considered to be a static string by the logic of this rule.
209
+ * @param {ASTNode} node Node to check.
210
+ * @returns {boolean} True if the node is a static string.
211
+ */
212
+ function isStaticString(node) {
213
+ return (
214
+ isStringLiteral(node) ||
215
+ astUtils.isStaticTemplateLiteral(node) ||
216
+ isStringRawTaggedStaticTemplateLiteral(node)
217
+ );
218
+ }
219
+
220
+ /**
221
+ * Determines whether the relevant arguments of the given are all static string literals.
222
+ * @param {ASTNode} node Node to check.
223
+ * @returns {boolean} True if all arguments are static strings.
224
+ */
225
+ function hasOnlyStaticStringArguments(node) {
226
+ const args = node.arguments;
227
+
228
+ if (
229
+ (args.length === 1 || args.length === 2) &&
230
+ args.every(isStaticString)
231
+ ) {
232
+ return true;
233
+ }
234
+
235
+ return false;
236
+ }
237
+
238
+ /**
239
+ * Determines whether the arguments of the given node indicate that a regex literal is unnecessarily wrapped.
240
+ * @param {ASTNode} node Node to check.
241
+ * @returns {boolean} True if the node already contains a regex literal argument.
242
+ */
243
+ function isUnnecessarilyWrappedRegexLiteral(node) {
244
+ const args = node.arguments;
245
+
246
+ if (args.length === 1 && isRegexLiteral(args[0])) {
247
+ return true;
248
+ }
249
+
250
+ if (
251
+ args.length === 2 &&
252
+ isRegexLiteral(args[0]) &&
253
+ isStaticString(args[1])
254
+ ) {
255
+ return true;
256
+ }
257
+
258
+ return false;
259
+ }
260
+
261
+ /**
262
+ * Returns a ecmaVersion compatible for regexpp.
263
+ * @param {number} ecmaVersion The ecmaVersion to convert.
264
+ * @returns {import("@eslint-community/regexpp/ecma-versions").EcmaVersion} The resulting ecmaVersion compatible for regexpp.
265
+ */
266
+ function getRegexppEcmaVersion(ecmaVersion) {
267
+ if (ecmaVersion <= 5) {
268
+ return 5;
269
+ }
270
+ return Math.min(ecmaVersion, REGEXPP_LATEST_ECMA_VERSION);
271
+ }
272
+
273
+ const regexppEcmaVersion = getRegexppEcmaVersion(
274
+ context.languageOptions.ecmaVersion,
275
+ );
276
+
277
+ /**
278
+ * Makes a character escaped or else returns null.
279
+ * @param {string} character The character to escape.
280
+ * @returns {string} The resulting escaped character.
281
+ */
282
+ function resolveEscapes(character) {
283
+ switch (character) {
284
+ case "\n":
285
+ case "\\\n":
286
+ return "\\n";
287
+
288
+ case "\r":
289
+ case "\\\r":
290
+ return "\\r";
291
+
292
+ case "\t":
293
+ case "\\\t":
294
+ return "\\t";
295
+
296
+ case "\v":
297
+ case "\\\v":
298
+ return "\\v";
299
+
300
+ case "\f":
301
+ case "\\\f":
302
+ return "\\f";
303
+
304
+ case "/":
305
+ return "\\/";
306
+
307
+ default:
308
+ return null;
309
+ }
310
+ }
311
+
312
+ /**
313
+ * Checks whether the given regex and flags are valid for the ecma version or not.
314
+ * @param {string} pattern The regex pattern to check.
315
+ * @param {string | undefined} flags The regex flags to check.
316
+ * @returns {boolean} True if the given regex pattern and flags are valid for the ecma version.
317
+ */
318
+ function isValidRegexForEcmaVersion(pattern, flags) {
319
+ const validator = new RegExpValidator({
320
+ ecmaVersion: regexppEcmaVersion,
321
+ });
322
+
323
+ try {
324
+ validator.validatePattern(pattern, 0, pattern.length, {
325
+ unicode: flags ? flags.includes("u") : false,
326
+ unicodeSets: flags ? flags.includes("v") : false,
327
+ });
328
+ if (flags) {
329
+ validator.validateFlags(flags);
330
+ }
331
+ return true;
332
+ } catch {
333
+ return false;
334
+ }
335
+ }
336
+
337
+ /**
338
+ * Checks whether two given regex flags contain the same flags or not.
339
+ * @param {string} flagsA The regex flags.
340
+ * @param {string} flagsB The regex flags.
341
+ * @returns {boolean} True if two regex flags contain same flags.
342
+ */
343
+ function areFlagsEqual(flagsA, flagsB) {
344
+ return [...flagsA].sort().join("") === [...flagsB].sort().join("");
345
+ }
346
+
347
+ /**
348
+ * Merges two regex flags.
349
+ * @param {string} flagsA The regex flags.
350
+ * @param {string} flagsB The regex flags.
351
+ * @returns {string} The merged regex flags.
352
+ */
353
+ function mergeRegexFlags(flagsA, flagsB) {
354
+ const flagsSet = new Set([...flagsA, ...flagsB]);
355
+
356
+ return [...flagsSet].join("");
357
+ }
358
+
359
+ /**
360
+ * Checks whether a give node can be fixed to the given regex pattern and flags.
361
+ * @param {ASTNode} node The node to check.
362
+ * @param {string} pattern The regex pattern to check.
363
+ * @param {string} flags The regex flags
364
+ * @returns {boolean} True if a node can be fixed to the given regex pattern and flags.
365
+ */
366
+ function canFixTo(node, pattern, flags) {
367
+ const tokenBefore = sourceCode.getTokenBefore(node);
368
+
369
+ return (
370
+ sourceCode.getCommentsInside(node).length === 0 &&
371
+ (!tokenBefore || validPrecedingTokens.has(tokenBefore.value)) &&
372
+ isValidRegexForEcmaVersion(pattern, flags)
373
+ );
374
+ }
375
+
376
+ /**
377
+ * Returns a safe output code considering the before and after tokens.
378
+ * @param {ASTNode} node The regex node.
379
+ * @param {string} newRegExpValue The new regex expression value.
380
+ * @returns {string} The output code.
381
+ */
382
+ function getSafeOutput(node, newRegExpValue) {
383
+ const tokenBefore = sourceCode.getTokenBefore(node);
384
+ const tokenAfter = sourceCode.getTokenAfter(node);
385
+
386
+ return (
387
+ (tokenBefore &&
388
+ !canTokensBeAdjacent(tokenBefore, newRegExpValue) &&
389
+ tokenBefore.range[1] === node.range[0]
390
+ ? " "
391
+ : "") +
392
+ newRegExpValue +
393
+ (tokenAfter &&
394
+ !canTokensBeAdjacent(newRegExpValue, tokenAfter) &&
395
+ node.range[1] === tokenAfter.range[0]
396
+ ? " "
397
+ : "")
398
+ );
399
+ }
400
+
401
+ return {
402
+ Program(node) {
403
+ const scope = sourceCode.getScope(node);
404
+ const tracker = new ReferenceTracker(scope);
405
+ const traceMap = {
406
+ RegExp: {
407
+ [CALL]: true,
408
+ [CONSTRUCT]: true,
409
+ },
410
+ };
411
+
412
+ for (const { node: refNode } of tracker.iterateGlobalReferences(
413
+ traceMap,
414
+ )) {
415
+ if (
416
+ disallowRedundantWrapping &&
417
+ isUnnecessarilyWrappedRegexLiteral(refNode)
418
+ ) {
419
+ const regexNode = refNode.arguments[0];
420
+
421
+ if (refNode.arguments.length === 2) {
422
+ const suggests = [];
423
+
424
+ const argFlags =
425
+ getStringValue(refNode.arguments[1]) || "";
426
+
427
+ if (
428
+ canFixTo(
429
+ refNode,
430
+ regexNode.regex.pattern,
431
+ argFlags,
432
+ )
433
+ ) {
434
+ suggests.push({
435
+ messageId: "replaceWithLiteralAndFlags",
436
+ pattern: regexNode.regex.pattern,
437
+ flags: argFlags,
438
+ });
439
+ }
440
+
441
+ const literalFlags = regexNode.regex.flags || "";
442
+ const mergedFlags = mergeRegexFlags(
443
+ literalFlags,
444
+ argFlags,
445
+ );
446
+
447
+ if (
448
+ !areFlagsEqual(mergedFlags, argFlags) &&
449
+ canFixTo(
450
+ refNode,
451
+ regexNode.regex.pattern,
452
+ mergedFlags,
453
+ )
454
+ ) {
455
+ suggests.push({
456
+ messageId:
457
+ "replaceWithIntendedLiteralAndFlags",
458
+ pattern: regexNode.regex.pattern,
459
+ flags: mergedFlags,
460
+ });
461
+ }
462
+
463
+ context.report({
464
+ node: refNode,
465
+ messageId: "unexpectedRedundantRegExpWithFlags",
466
+ suggest: suggests.map(
467
+ ({ flags, pattern, messageId }) => ({
468
+ messageId,
469
+ data: {
470
+ flags,
471
+ },
472
+ fix(fixer) {
473
+ return fixer.replaceText(
474
+ refNode,
475
+ getSafeOutput(
476
+ refNode,
477
+ `/${pattern}/${flags}`,
478
+ ),
479
+ );
480
+ },
481
+ }),
482
+ ),
483
+ });
484
+ } else {
485
+ const outputs = [];
486
+
487
+ if (
488
+ canFixTo(
489
+ refNode,
490
+ regexNode.regex.pattern,
491
+ regexNode.regex.flags,
492
+ )
493
+ ) {
494
+ outputs.push(sourceCode.getText(regexNode));
495
+ }
496
+
497
+ context.report({
498
+ node: refNode,
499
+ messageId: "unexpectedRedundantRegExp",
500
+ suggest: outputs.map(output => ({
501
+ messageId: "replaceWithLiteral",
502
+ fix(fixer) {
503
+ return fixer.replaceText(
504
+ refNode,
505
+ getSafeOutput(refNode, output),
506
+ );
507
+ },
508
+ })),
509
+ });
510
+ }
511
+ } else if (hasOnlyStaticStringArguments(refNode)) {
512
+ let regexContent = getStringValue(refNode.arguments[0]);
513
+ let noFix = false;
514
+ let flags;
515
+
516
+ if (refNode.arguments[1]) {
517
+ flags = getStringValue(refNode.arguments[1]);
518
+ }
519
+
520
+ if (!canFixTo(refNode, regexContent, flags)) {
521
+ noFix = true;
522
+ }
523
+
524
+ if (
525
+ !/^[-\w\\[\](){} \t\r\n\v\f!@#$%^&*+=/~`.><?,'"|:;]*$/u.test(
526
+ regexContent,
527
+ )
528
+ ) {
529
+ noFix = true;
530
+ }
531
+
532
+ if (regexContent && !noFix) {
533
+ let charIncrease = 0;
534
+
535
+ const ast = new RegExpParser({
536
+ ecmaVersion: regexppEcmaVersion,
537
+ }).parsePattern(
538
+ regexContent,
539
+ 0,
540
+ regexContent.length,
541
+ {
542
+ unicode: flags
543
+ ? flags.includes("u")
544
+ : false,
545
+ unicodeSets: flags
546
+ ? flags.includes("v")
547
+ : false,
548
+ },
549
+ );
550
+
551
+ visitRegExpAST(ast, {
552
+ onCharacterEnter(characterNode) {
553
+ const escaped = resolveEscapes(
554
+ characterNode.raw,
555
+ );
556
+
557
+ if (escaped) {
558
+ regexContent =
559
+ regexContent.slice(
560
+ 0,
561
+ characterNode.start +
562
+ charIncrease,
563
+ ) +
564
+ escaped +
565
+ regexContent.slice(
566
+ characterNode.end +
567
+ charIncrease,
568
+ );
569
+
570
+ if (characterNode.raw.length === 1) {
571
+ charIncrease += 1;
572
+ }
573
+ }
574
+ },
575
+ });
576
+ }
577
+
578
+ const newRegExpValue = `/${regexContent || "(?:)"}/${flags || ""}`;
579
+
580
+ context.report({
581
+ node: refNode,
582
+ messageId: "unexpectedRegExp",
583
+ suggest: noFix
584
+ ? []
585
+ : [
586
+ {
587
+ messageId: "replaceWithLiteral",
588
+ fix(fixer) {
589
+ return fixer.replaceText(
590
+ refNode,
591
+ getSafeOutput(
592
+ refNode,
593
+ newRegExpValue,
594
+ ),
595
+ );
596
+ },
597
+ },
598
+ ],
599
+ });
600
+ }
601
+ }
602
+ },
603
+ };
604
+ },
507
605
  };