eslint 9.22.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.
- package/README.md +47 -45
- package/bin/eslint.js +92 -90
- package/conf/default-cli-options.js +22 -22
- package/conf/ecma-version.js +1 -1
- package/conf/globals.js +97 -98
- package/conf/replacements.json +24 -20
- package/conf/rule-type-list.json +88 -92
- package/lib/api.js +12 -12
- package/lib/cli-engine/cli-engine.js +828 -808
- package/lib/cli-engine/file-enumerator.js +381 -387
- package/lib/cli-engine/formatters/formatters-meta.json +16 -16
- package/lib/cli-engine/formatters/html.js +107 -99
- package/lib/cli-engine/formatters/json-with-metadata.js +5 -5
- package/lib/cli-engine/formatters/json.js +2 -2
- package/lib/cli-engine/formatters/stylish.js +96 -75
- package/lib/cli-engine/hash.js +1 -1
- package/lib/cli-engine/index.js +1 -1
- package/lib/cli-engine/lint-result-cache.js +144 -145
- package/lib/cli-engine/load-rules.js +16 -16
- package/lib/cli.js +541 -457
- package/lib/config/config-loader.js +648 -618
- package/lib/config/config.js +247 -221
- package/lib/config/default-config.js +54 -45
- package/lib/config/flat-config-array.js +167 -172
- package/lib/config/flat-config-helpers.js +65 -68
- package/lib/config/flat-config-schema.js +375 -368
- package/lib/config/rule-validator.js +139 -144
- package/lib/config-api.js +2 -2
- package/lib/eslint/eslint-helpers.js +709 -679
- package/lib/eslint/eslint.js +944 -886
- package/lib/eslint/index.js +2 -2
- package/lib/eslint/legacy-eslint.js +576 -532
- package/lib/languages/js/index.js +263 -264
- package/lib/languages/js/source-code/index.js +1 -1
- package/lib/languages/js/source-code/source-code.js +1128 -1057
- package/lib/languages/js/source-code/token-store/backward-token-comment-cursor.js +39 -35
- package/lib/languages/js/source-code/token-store/backward-token-cursor.js +35 -36
- package/lib/languages/js/source-code/token-store/cursor.js +36 -36
- package/lib/languages/js/source-code/token-store/cursors.js +80 -52
- package/lib/languages/js/source-code/token-store/decorative-cursor.js +17 -18
- package/lib/languages/js/source-code/token-store/filter-cursor.js +19 -20
- package/lib/languages/js/source-code/token-store/forward-token-comment-cursor.js +40 -32
- package/lib/languages/js/source-code/token-store/forward-token-cursor.js +40 -41
- package/lib/languages/js/source-code/token-store/index.js +592 -498
- package/lib/languages/js/source-code/token-store/limit-cursor.js +17 -18
- package/lib/languages/js/source-code/token-store/padded-token-cursor.js +23 -16
- package/lib/languages/js/source-code/token-store/skip-cursor.js +19 -20
- package/lib/languages/js/source-code/token-store/utils.js +63 -60
- package/lib/languages/js/validate-language-options.js +104 -89
- package/lib/linter/apply-disable-directives.js +467 -383
- package/lib/linter/code-path-analysis/code-path-analyzer.js +650 -672
- package/lib/linter/code-path-analysis/code-path-segment.js +215 -216
- package/lib/linter/code-path-analysis/code-path-state.js +2118 -2096
- package/lib/linter/code-path-analysis/code-path.js +307 -319
- package/lib/linter/code-path-analysis/debug-helpers.js +183 -163
- package/lib/linter/code-path-analysis/fork-context.js +296 -271
- package/lib/linter/code-path-analysis/id-generator.js +22 -23
- package/lib/linter/file-context.js +119 -120
- package/lib/linter/index.js +3 -3
- package/lib/linter/interpolate.js +16 -16
- package/lib/linter/linter.js +2402 -2044
- package/lib/linter/node-event-generator.js +284 -225
- package/lib/linter/report-translator.js +256 -219
- package/lib/linter/rule-fixer.js +122 -124
- package/lib/linter/rules.js +35 -35
- package/lib/linter/safe-emitter.js +18 -18
- package/lib/linter/source-code-fixer.js +94 -92
- package/lib/linter/timing.js +104 -101
- package/lib/linter/vfile.js +70 -73
- package/lib/options.js +375 -361
- package/lib/rule-tester/index.js +1 -1
- package/lib/rule-tester/rule-tester.js +1307 -1045
- package/lib/rules/accessor-pairs.js +297 -262
- package/lib/rules/array-bracket-newline.js +249 -237
- package/lib/rules/array-bracket-spacing.js +262 -223
- package/lib/rules/array-callback-return.js +401 -355
- package/lib/rules/array-element-newline.js +357 -312
- package/lib/rules/arrow-body-style.js +399 -280
- package/lib/rules/arrow-parens.js +205 -172
- package/lib/rules/arrow-spacing.js +168 -162
- package/lib/rules/block-scoped-var.js +124 -122
- package/lib/rules/block-spacing.js +185 -175
- package/lib/rules/brace-style.js +261 -198
- package/lib/rules/callback-return.js +202 -189
- package/lib/rules/camelcase.js +402 -391
- package/lib/rules/capitalized-comments.js +252 -231
- package/lib/rules/class-methods-use-this.js +179 -171
- package/lib/rules/comma-dangle.js +378 -345
- package/lib/rules/comma-spacing.js +192 -194
- package/lib/rules/comma-style.js +374 -315
- package/lib/rules/complexity.js +172 -168
- package/lib/rules/computed-property-spacing.js +235 -210
- package/lib/rules/consistent-return.js +180 -169
- package/lib/rules/consistent-this.js +166 -146
- package/lib/rules/constructor-super.js +411 -403
- package/lib/rules/curly.js +406 -331
- package/lib/rules/default-case-last.js +37 -30
- package/lib/rules/default-case.js +88 -84
- package/lib/rules/default-param-last.js +68 -53
- package/lib/rules/dot-location.js +121 -109
- package/lib/rules/dot-notation.js +191 -155
- package/lib/rules/eol-last.js +121 -119
- package/lib/rules/eqeqeq.js +167 -154
- package/lib/rules/for-direction.js +145 -120
- package/lib/rules/func-call-spacing.js +260 -230
- package/lib/rules/func-name-matching.js +292 -208
- package/lib/rules/func-names.js +164 -163
- package/lib/rules/func-style.js +158 -126
- package/lib/rules/function-call-argument-newline.js +151 -128
- package/lib/rules/function-paren-newline.js +348 -290
- package/lib/rules/generator-star-spacing.js +228 -209
- package/lib/rules/getter-return.js +207 -171
- package/lib/rules/global-require.js +84 -73
- package/lib/rules/grouped-accessor-pairs.js +169 -149
- package/lib/rules/guard-for-in.js +71 -62
- package/lib/rules/handle-callback-err.js +107 -102
- package/lib/rules/id-blacklist.js +181 -198
- package/lib/rules/id-denylist.js +167 -186
- package/lib/rules/id-length.js +196 -170
- package/lib/rules/id-match.js +343 -288
- package/lib/rules/implicit-arrow-linebreak.js +101 -78
- package/lib/rules/indent-legacy.js +1343 -1117
- package/lib/rules/indent.js +2271 -1758
- package/lib/rules/index.js +317 -292
- package/lib/rules/init-declarations.js +115 -106
- package/lib/rules/jsx-quotes.js +93 -81
- package/lib/rules/key-spacing.js +749 -632
- package/lib/rules/keyword-spacing.js +647 -604
- package/lib/rules/line-comment-position.js +141 -127
- package/lib/rules/linebreak-style.js +106 -105
- package/lib/rules/lines-around-comment.js +539 -447
- package/lib/rules/lines-around-directive.js +232 -202
- package/lib/rules/lines-between-class-members.js +304 -233
- package/lib/rules/logical-assignment-operators.js +581 -398
- package/lib/rules/max-classes-per-file.js +68 -67
- package/lib/rules/max-depth.js +145 -142
- package/lib/rules/max-len.js +472 -433
- package/lib/rules/max-lines-per-function.js +200 -175
- package/lib/rules/max-lines.js +157 -161
- package/lib/rules/max-nested-callbacks.js +101 -103
- package/lib/rules/max-params.js +77 -75
- package/lib/rules/max-statements-per-line.js +204 -197
- package/lib/rules/max-statements.js +167 -163
- package/lib/rules/multiline-comment-style.js +636 -478
- package/lib/rules/multiline-ternary.js +240 -175
- package/lib/rules/new-cap.js +232 -212
- package/lib/rules/new-parens.js +87 -78
- package/lib/rules/newline-after-var.js +286 -249
- package/lib/rules/newline-before-return.js +228 -221
- package/lib/rules/newline-per-chained-call.js +141 -126
- package/lib/rules/no-alert.js +89 -78
- package/lib/rules/no-array-constructor.js +121 -112
- package/lib/rules/no-async-promise-executor.js +29 -23
- package/lib/rules/no-await-in-loop.js +68 -70
- package/lib/rules/no-bitwise.js +123 -99
- package/lib/rules/no-buffer-constructor.js +54 -46
- package/lib/rules/no-caller.js +38 -32
- package/lib/rules/no-case-declarations.js +60 -56
- package/lib/rules/no-catch-shadow.js +75 -72
- package/lib/rules/no-class-assign.js +50 -47
- package/lib/rules/no-compare-neg-zero.js +61 -47
- package/lib/rules/no-cond-assign.js +147 -131
- package/lib/rules/no-confusing-arrow.js +97 -80
- package/lib/rules/no-console.js +201 -198
- package/lib/rules/no-const-assign.js +46 -40
- package/lib/rules/no-constant-binary-expression.js +499 -404
- package/lib/rules/no-constant-condition.js +157 -142
- package/lib/rules/no-constructor-return.js +48 -48
- package/lib/rules/no-continue.js +24 -26
- package/lib/rules/no-control-regex.js +124 -120
- package/lib/rules/no-debugger.js +27 -29
- package/lib/rules/no-delete-var.js +28 -28
- package/lib/rules/no-div-regex.js +46 -40
- package/lib/rules/no-dupe-args.js +67 -68
- package/lib/rules/no-dupe-class-members.js +92 -88
- package/lib/rules/no-dupe-else-if.js +99 -76
- package/lib/rules/no-dupe-keys.js +132 -109
- package/lib/rules/no-duplicate-case.js +49 -42
- package/lib/rules/no-duplicate-imports.js +178 -175
- package/lib/rules/no-else-return.js +429 -384
- package/lib/rules/no-empty-character-class.js +56 -49
- package/lib/rules/no-empty-function.js +126 -127
- package/lib/rules/no-empty-pattern.js +62 -57
- package/lib/rules/no-empty-static-block.js +36 -34
- package/lib/rules/no-empty.js +97 -85
- package/lib/rules/no-eq-null.js +36 -31
- package/lib/rules/no-eval.js +255 -249
- package/lib/rules/no-ex-assign.js +41 -38
- package/lib/rules/no-extend-native.js +160 -158
- package/lib/rules/no-extra-bind.js +200 -189
- package/lib/rules/no-extra-boolean-cast.js +397 -347
- package/lib/rules/no-extra-label.js +149 -130
- package/lib/rules/no-extra-parens.js +1653 -1324
- package/lib/rules/no-extra-semi.js +145 -143
- package/lib/rules/no-fallthrough.js +198 -156
- package/lib/rules/no-floating-decimal.js +73 -65
- package/lib/rules/no-func-assign.js +53 -54
- package/lib/rules/no-global-assign.js +77 -72
- package/lib/rules/no-implicit-coercion.js +348 -292
- package/lib/rules/no-implicit-globals.js +157 -134
- package/lib/rules/no-implied-eval.js +139 -111
- package/lib/rules/no-import-assign.js +144 -158
- package/lib/rules/no-inline-comments.js +100 -94
- package/lib/rules/no-inner-declarations.js +114 -100
- package/lib/rules/no-invalid-regexp.js +221 -189
- package/lib/rules/no-invalid-this.js +122 -116
- package/lib/rules/no-irregular-whitespace.js +265 -251
- package/lib/rules/no-iterator.js +28 -32
- package/lib/rules/no-label-var.js +58 -61
- package/lib/rules/no-labels.js +137 -132
- package/lib/rules/no-lone-blocks.js +126 -122
- package/lib/rules/no-lonely-if.js +107 -76
- package/lib/rules/no-loop-func.js +233 -212
- package/lib/rules/no-loss-of-precision.js +215 -200
- package/lib/rules/no-magic-numbers.js +245 -217
- package/lib/rules/no-misleading-character-class.js +498 -445
- package/lib/rules/no-mixed-operators.js +187 -181
- package/lib/rules/no-mixed-requires.js +252 -239
- package/lib/rules/no-mixed-spaces-and-tabs.js +133 -120
- package/lib/rules/no-multi-assign.js +45 -43
- package/lib/rules/no-multi-spaces.js +162 -142
- package/lib/rules/no-multi-str.js +41 -40
- package/lib/rules/no-multiple-empty-lines.js +195 -157
- package/lib/rules/no-native-reassign.js +89 -84
- package/lib/rules/no-negated-condition.js +78 -74
- package/lib/rules/no-negated-in-lhs.js +44 -42
- package/lib/rules/no-nested-ternary.js +32 -31
- package/lib/rules/no-new-func.js +70 -61
- package/lib/rules/no-new-native-nonconstructor.js +42 -38
- package/lib/rules/no-new-object.js +47 -47
- package/lib/rules/no-new-require.js +47 -46
- package/lib/rules/no-new-symbol.js +51 -49
- package/lib/rules/no-new-wrappers.js +42 -40
- package/lib/rules/no-new.js +27 -28
- package/lib/rules/no-nonoctal-decimal-escape.js +140 -120
- package/lib/rules/no-obj-calls.js +65 -52
- package/lib/rules/no-object-constructor.js +103 -96
- package/lib/rules/no-octal-escape.js +39 -42
- package/lib/rules/no-octal.js +31 -31
- package/lib/rules/no-param-reassign.js +234 -216
- package/lib/rules/no-path-concat.js +65 -66
- package/lib/rules/no-plusplus.js +59 -60
- package/lib/rules/no-process-env.js +48 -47
- package/lib/rules/no-process-exit.js +53 -49
- package/lib/rules/no-promise-executor-return.js +213 -181
- package/lib/rules/no-proto.js +25 -28
- package/lib/rules/no-prototype-builtins.js +145 -123
- package/lib/rules/no-redeclare.js +153 -151
- package/lib/rules/no-regex-spaces.js +182 -160
- package/lib/rules/no-restricted-exports.js +207 -184
- package/lib/rules/no-restricted-globals.js +110 -111
- package/lib/rules/no-restricted-imports.js +656 -536
- package/lib/rules/no-restricted-modules.js +221 -201
- package/lib/rules/no-restricted-properties.js +180 -152
- package/lib/rules/no-restricted-syntax.js +55 -51
- package/lib/rules/no-return-assign.js +54 -49
- package/lib/rules/no-return-await.js +147 -123
- package/lib/rules/no-script-url.js +51 -44
- package/lib/rules/no-self-assign.js +147 -145
- package/lib/rules/no-self-compare.js +62 -45
- package/lib/rules/no-sequences.js +134 -115
- package/lib/rules/no-setter-return.js +184 -151
- package/lib/rules/no-shadow-restricted-names.js +60 -45
- package/lib/rules/no-shadow.js +341 -315
- package/lib/rules/no-spaced-func.js +81 -76
- package/lib/rules/no-sparse-arrays.js +53 -58
- package/lib/rules/no-sync.js +60 -59
- package/lib/rules/no-tabs.js +82 -71
- package/lib/rules/no-template-curly-in-string.js +32 -31
- package/lib/rules/no-ternary.js +24 -28
- package/lib/rules/no-this-before-super.js +320 -318
- package/lib/rules/no-throw-literal.js +30 -35
- package/lib/rules/no-trailing-spaces.js +198 -190
- package/lib/rules/no-undef-init.js +75 -60
- package/lib/rules/no-undef.js +50 -47
- package/lib/rules/no-undefined.js +72 -74
- package/lib/rules/no-underscore-dangle.js +369 -326
- package/lib/rules/no-unexpected-multiline.js +111 -101
- package/lib/rules/no-unmodified-loop-condition.js +253 -253
- package/lib/rules/no-unneeded-ternary.js +211 -146
- package/lib/rules/no-unreachable-loop.js +144 -141
- package/lib/rules/no-unreachable.js +254 -247
- package/lib/rules/no-unsafe-finally.js +92 -84
- package/lib/rules/no-unsafe-negation.js +104 -82
- package/lib/rules/no-unsafe-optional-chaining.js +191 -177
- package/lib/rules/no-unused-expressions.js +177 -161
- package/lib/rules/no-unused-labels.js +138 -123
- package/lib/rules/no-unused-private-class-members.js +205 -181
- package/lib/rules/no-unused-vars.js +1668 -1448
- package/lib/rules/no-use-before-define.js +228 -230
- package/lib/rules/no-useless-assignment.js +589 -510
- package/lib/rules/no-useless-backreference.js +211 -192
- package/lib/rules/no-useless-call.js +57 -52
- package/lib/rules/no-useless-catch.js +39 -39
- package/lib/rules/no-useless-computed-key.js +143 -114
- package/lib/rules/no-useless-concat.js +64 -59
- package/lib/rules/no-useless-constructor.js +157 -110
- package/lib/rules/no-useless-escape.js +341 -290
- package/lib/rules/no-useless-rename.js +182 -155
- package/lib/rules/no-useless-return.js +343 -311
- package/lib/rules/no-var.js +232 -211
- package/lib/rules/no-void.js +49 -47
- package/lib/rules/no-warning-comments.js +190 -185
- package/lib/rules/no-whitespace-before-property.js +130 -114
- package/lib/rules/no-with.js +23 -25
- package/lib/rules/nonblock-statement-body-position.js +148 -129
- package/lib/rules/object-curly-newline.js +305 -264
- package/lib/rules/object-curly-spacing.js +359 -313
- package/lib/rules/object-property-newline.js +136 -105
- package/lib/rules/object-shorthand.js +606 -501
- package/lib/rules/one-var-declaration-per-line.js +103 -99
- package/lib/rules/one-var.js +652 -536
- package/lib/rules/operator-assignment.js +218 -160
- package/lib/rules/operator-linebreak.js +294 -250
- package/lib/rules/padded-blocks.js +345 -307
- package/lib/rules/padding-line-between-statements.js +442 -438
- package/lib/rules/prefer-arrow-callback.js +361 -312
- package/lib/rules/prefer-const.js +417 -376
- package/lib/rules/prefer-destructuring.js +300 -278
- package/lib/rules/prefer-exponentiation-operator.js +175 -132
- package/lib/rules/prefer-named-capture-group.js +152 -139
- package/lib/rules/prefer-numeric-literals.js +120 -112
- package/lib/rules/prefer-object-has-own.js +115 -81
- package/lib/rules/prefer-object-spread.js +212 -192
- package/lib/rules/prefer-promise-reject-errors.js +139 -121
- package/lib/rules/prefer-reflect.js +126 -106
- package/lib/rules/prefer-regex-literals.js +577 -465
- package/lib/rules/prefer-rest-params.js +78 -79
- package/lib/rules/prefer-spread.js +46 -43
- package/lib/rules/prefer-template.js +265 -194
- package/lib/rules/quote-props.js +372 -306
- package/lib/rules/quotes.js +373 -325
- package/lib/rules/radix.js +151 -135
- package/lib/rules/require-atomic-updates.js +315 -284
- package/lib/rules/require-await.js +143 -115
- package/lib/rules/require-unicode-regexp.js +281 -176
- package/lib/rules/require-yield.js +52 -53
- package/lib/rules/rest-spread-spacing.js +127 -115
- package/lib/rules/semi-spacing.js +280 -249
- package/lib/rules/semi-style.js +175 -133
- package/lib/rules/semi.js +455 -435
- package/lib/rules/sort-imports.js +305 -232
- package/lib/rules/sort-keys.js +218 -187
- package/lib/rules/sort-vars.js +126 -92
- package/lib/rules/space-before-blocks.js +198 -188
- package/lib/rules/space-before-function-paren.js +185 -165
- package/lib/rules/space-in-parens.js +358 -287
- package/lib/rules/space-infix-ops.js +236 -200
- package/lib/rules/space-unary-ops.js +355 -297
- package/lib/rules/spaced-comment.js +362 -318
- package/lib/rules/strict.js +264 -229
- package/lib/rules/switch-colon-spacing.js +129 -121
- package/lib/rules/symbol-description.js +44 -47
- package/lib/rules/template-curly-spacing.js +147 -141
- package/lib/rules/template-tag-spacing.js +97 -87
- package/lib/rules/unicode-bom.js +53 -55
- package/lib/rules/use-isnan.js +236 -205
- package/lib/rules/utils/ast-utils.js +2039 -1860
- package/lib/rules/utils/char-source.js +162 -155
- package/lib/rules/utils/fix-tracker.js +83 -80
- package/lib/rules/utils/keywords.js +59 -59
- package/lib/rules/utils/lazy-loading-rule-map.js +79 -76
- package/lib/rules/utils/regular-expressions.js +32 -24
- package/lib/rules/utils/unicode/index.js +4 -4
- package/lib/rules/utils/unicode/is-combining-character.js +1 -1
- package/lib/rules/utils/unicode/is-emoji-modifier.js +1 -1
- package/lib/rules/utils/unicode/is-regional-indicator-symbol.js +1 -1
- package/lib/rules/utils/unicode/is-surrogate-pair.js +1 -1
- package/lib/rules/valid-typeof.js +152 -110
- package/lib/rules/vars-on-top.js +151 -144
- package/lib/rules/wrap-iife.js +203 -190
- package/lib/rules/wrap-regex.js +69 -57
- package/lib/rules/yield-star-spacing.js +144 -133
- package/lib/rules/yoda.js +282 -271
- package/lib/services/parser-service.js +35 -35
- package/lib/services/processor-service.js +66 -73
- package/lib/shared/ajv.js +14 -14
- package/lib/shared/assert.js +3 -4
- package/lib/shared/ast-utils.js +7 -6
- package/lib/shared/deep-merge-arrays.js +24 -22
- package/lib/shared/directives.js +3 -2
- package/lib/shared/flags.js +46 -17
- package/lib/shared/logging.js +24 -25
- package/lib/shared/option-utils.js +43 -36
- package/lib/shared/runtime-info.js +136 -127
- package/lib/shared/serialization.js +27 -27
- package/lib/shared/severity.js +22 -22
- package/lib/shared/stats.js +5 -5
- package/lib/shared/string-utils.js +16 -16
- package/lib/shared/text-table.js +28 -27
- package/lib/shared/traverser.js +153 -146
- package/lib/types/index.d.ts +2010 -1559
- package/lib/types/rules.d.ts +5253 -5140
- package/lib/types/use-at-your-own-risk.d.ts +32 -30
- package/lib/unsupported-api.js +5 -5
- package/messages/all-files-ignored.js +3 -3
- package/messages/all-matched-files-ignored.js +3 -3
- package/messages/config-file-missing.js +2 -2
- package/messages/config-plugin-missing.js +3 -3
- package/messages/config-serialize-function.js +9 -7
- package/messages/eslintrc-incompat.js +13 -15
- package/messages/eslintrc-plugins.js +3 -4
- package/messages/extend-config-missing.js +3 -3
- package/messages/failed-to-read-json.js +3 -3
- package/messages/file-not-found.js +3 -3
- package/messages/invalid-rule-options.js +2 -2
- package/messages/invalid-rule-severity.js +2 -2
- package/messages/no-config-found.js +3 -3
- package/messages/plugin-conflict.js +8 -8
- package/messages/plugin-invalid.js +3 -3
- package/messages/plugin-missing.js +3 -3
- package/messages/print-config-with-directory-path.js +2 -2
- package/messages/shared.js +6 -1
- package/messages/whitespace-found.js +3 -3
- package/package.json +11 -17
@@ -18,8 +18,8 @@ const astUtils = require("./utils/ast-utils");
|
|
18
18
|
|
19
19
|
const LT = `[${Array.from(astUtils.LINEBREAKS).join("")}]`;
|
20
20
|
const PADDING_LINE_SEQUENCE = new RegExp(
|
21
|
-
|
22
|
-
|
21
|
+
String.raw`^(\s*?${LT})\s*${LT}(\s*;?)$`,
|
22
|
+
"u",
|
23
23
|
);
|
24
24
|
const CJS_EXPORT = /^(?:module\s*\.\s*)?exports(?:\s*\.|\s*\[|$)/u;
|
25
25
|
const CJS_IMPORT = /^require\(/u;
|
@@ -31,10 +31,10 @@ const CJS_IMPORT = /^require\(/u;
|
|
31
31
|
* @private
|
32
32
|
*/
|
33
33
|
function newKeywordTester(keyword) {
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
34
|
+
return {
|
35
|
+
test: (node, sourceCode) =>
|
36
|
+
sourceCode.getFirstToken(node).value === keyword,
|
37
|
+
};
|
38
38
|
}
|
39
39
|
|
40
40
|
/**
|
@@ -44,11 +44,11 @@ function newKeywordTester(keyword) {
|
|
44
44
|
* @private
|
45
45
|
*/
|
46
46
|
function newSinglelineKeywordTester(keyword) {
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
47
|
+
return {
|
48
|
+
test: (node, sourceCode) =>
|
49
|
+
node.loc.start.line === node.loc.end.line &&
|
50
|
+
sourceCode.getFirstToken(node).value === keyword,
|
51
|
+
};
|
52
52
|
}
|
53
53
|
|
54
54
|
/**
|
@@ -58,11 +58,11 @@ function newSinglelineKeywordTester(keyword) {
|
|
58
58
|
* @private
|
59
59
|
*/
|
60
60
|
function newMultilineKeywordTester(keyword) {
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
61
|
+
return {
|
62
|
+
test: (node, sourceCode) =>
|
63
|
+
node.loc.start.line !== node.loc.end.line &&
|
64
|
+
sourceCode.getFirstToken(node).value === keyword,
|
65
|
+
};
|
66
66
|
}
|
67
67
|
|
68
68
|
/**
|
@@ -72,10 +72,9 @@ function newMultilineKeywordTester(keyword) {
|
|
72
72
|
* @private
|
73
73
|
*/
|
74
74
|
function newNodeTypeTester(type) {
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
};
|
75
|
+
return {
|
76
|
+
test: node => node.type === type,
|
77
|
+
};
|
79
78
|
}
|
80
79
|
|
81
80
|
/**
|
@@ -85,15 +84,17 @@ function newNodeTypeTester(type) {
|
|
85
84
|
* @private
|
86
85
|
*/
|
87
86
|
function isIIFEStatement(node) {
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
87
|
+
if (node.type === "ExpressionStatement") {
|
88
|
+
let call = astUtils.skipChainExpression(node.expression);
|
89
|
+
|
90
|
+
if (call.type === "UnaryExpression") {
|
91
|
+
call = astUtils.skipChainExpression(call.argument);
|
92
|
+
}
|
93
|
+
return (
|
94
|
+
call.type === "CallExpression" && astUtils.isFunction(call.callee)
|
95
|
+
);
|
96
|
+
}
|
97
|
+
return false;
|
97
98
|
}
|
98
99
|
|
99
100
|
/**
|
@@ -105,30 +106,37 @@ function isIIFEStatement(node) {
|
|
105
106
|
* @private
|
106
107
|
*/
|
107
108
|
function isBlockLikeStatement(sourceCode, node) {
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
109
|
+
// do-while with a block is a block-like statement.
|
110
|
+
if (
|
111
|
+
node.type === "DoWhileStatement" &&
|
112
|
+
node.body.type === "BlockStatement"
|
113
|
+
) {
|
114
|
+
return true;
|
115
|
+
}
|
116
|
+
|
117
|
+
/*
|
118
|
+
* IIFE is a block-like statement specially from
|
119
|
+
* JSCS#disallowPaddingNewLinesAfterBlocks.
|
120
|
+
*/
|
121
|
+
if (isIIFEStatement(node)) {
|
122
|
+
return true;
|
123
|
+
}
|
124
|
+
|
125
|
+
// Checks the last token is a closing brace of blocks.
|
126
|
+
const lastToken = sourceCode.getLastToken(
|
127
|
+
node,
|
128
|
+
astUtils.isNotSemicolonToken,
|
129
|
+
);
|
130
|
+
const belongingNode =
|
131
|
+
lastToken && astUtils.isClosingBraceToken(lastToken)
|
132
|
+
? sourceCode.getNodeByRangeIndex(lastToken.range[0])
|
133
|
+
: null;
|
134
|
+
|
135
|
+
return (
|
136
|
+
Boolean(belongingNode) &&
|
137
|
+
(belongingNode.type === "BlockStatement" ||
|
138
|
+
belongingNode.type === "SwitchStatement")
|
139
|
+
);
|
132
140
|
}
|
133
141
|
|
134
142
|
/**
|
@@ -145,19 +153,19 @@ function isBlockLikeStatement(sourceCode, node) {
|
|
145
153
|
* @private
|
146
154
|
*/
|
147
155
|
function getActualLastToken(sourceCode, node) {
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
156
|
+
const semiToken = sourceCode.getLastToken(node);
|
157
|
+
const prevToken = sourceCode.getTokenBefore(semiToken);
|
158
|
+
const nextToken = sourceCode.getTokenAfter(semiToken);
|
159
|
+
const isSemicolonLessStyle = Boolean(
|
160
|
+
prevToken &&
|
161
|
+
nextToken &&
|
162
|
+
prevToken.range[0] >= node.range[0] &&
|
163
|
+
astUtils.isSemicolonToken(semiToken) &&
|
164
|
+
semiToken.loc.start.line !== prevToken.loc.end.line &&
|
165
|
+
semiToken.loc.end.line === nextToken.loc.start.line,
|
166
|
+
);
|
167
|
+
|
168
|
+
return isSemicolonLessStyle ? prevToken : semiToken;
|
161
169
|
}
|
162
170
|
|
163
171
|
/**
|
@@ -169,7 +177,7 @@ function getActualLastToken(sourceCode, node) {
|
|
169
177
|
* @private
|
170
178
|
*/
|
171
179
|
function replacerToRemovePaddingLines(_, trailingSpaces, indentSpaces) {
|
172
|
-
|
180
|
+
return trailingSpaces + indentSpaces;
|
173
181
|
}
|
174
182
|
|
175
183
|
/**
|
@@ -178,8 +186,7 @@ function replacerToRemovePaddingLines(_, trailingSpaces, indentSpaces) {
|
|
178
186
|
* @returns {void}
|
179
187
|
* @private
|
180
188
|
*/
|
181
|
-
function verifyForAny() {
|
182
|
-
}
|
189
|
+
function verifyForAny() {}
|
183
190
|
|
184
191
|
/**
|
185
192
|
* Check and report statements for `never` configuration.
|
@@ -195,29 +202,29 @@ function verifyForAny() {
|
|
195
202
|
* @private
|
196
203
|
*/
|
197
204
|
function verifyForNever(context, _, nextNode, paddingLines) {
|
198
|
-
|
199
|
-
|
200
|
-
|
201
|
-
|
202
|
-
|
203
|
-
|
204
|
-
|
205
|
-
|
206
|
-
|
207
|
-
|
208
|
-
|
209
|
-
|
210
|
-
|
211
|
-
|
212
|
-
|
213
|
-
|
214
|
-
|
215
|
-
|
216
|
-
|
217
|
-
|
218
|
-
|
219
|
-
|
220
|
-
|
205
|
+
if (paddingLines.length === 0) {
|
206
|
+
return;
|
207
|
+
}
|
208
|
+
|
209
|
+
context.report({
|
210
|
+
node: nextNode,
|
211
|
+
messageId: "unexpectedBlankLine",
|
212
|
+
fix(fixer) {
|
213
|
+
if (paddingLines.length >= 2) {
|
214
|
+
return null;
|
215
|
+
}
|
216
|
+
|
217
|
+
const prevToken = paddingLines[0][0];
|
218
|
+
const nextToken = paddingLines[0][1];
|
219
|
+
const start = prevToken.range[1];
|
220
|
+
const end = nextToken.range[0];
|
221
|
+
const text = context.sourceCode.text
|
222
|
+
.slice(start, end)
|
223
|
+
.replace(PADDING_LINE_SEQUENCE, replacerToRemovePaddingLines);
|
224
|
+
|
225
|
+
return fixer.replaceTextRange([start, end], text);
|
226
|
+
},
|
227
|
+
});
|
221
228
|
}
|
222
229
|
|
223
230
|
/**
|
@@ -234,58 +241,55 @@ function verifyForNever(context, _, nextNode, paddingLines) {
|
|
234
241
|
* @private
|
235
242
|
*/
|
236
243
|
function verifyForAlways(context, prevNode, nextNode, paddingLines) {
|
237
|
-
|
238
|
-
|
239
|
-
|
240
|
-
|
241
|
-
|
242
|
-
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
|
251
|
-
|
252
|
-
|
253
|
-
|
254
|
-
|
255
|
-
|
256
|
-
|
257
|
-
|
258
|
-
|
259
|
-
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
|
264
|
-
|
265
|
-
|
266
|
-
|
267
|
-
|
268
|
-
|
269
|
-
|
270
|
-
|
271
|
-
|
272
|
-
|
273
|
-
|
274
|
-
|
275
|
-
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
|
280
|
-
|
281
|
-
|
282
|
-
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
return fixer.insertTextAfter(prevToken, insertText);
|
287
|
-
}
|
288
|
-
});
|
244
|
+
if (paddingLines.length > 0) {
|
245
|
+
return;
|
246
|
+
}
|
247
|
+
|
248
|
+
context.report({
|
249
|
+
node: nextNode,
|
250
|
+
messageId: "expectedBlankLine",
|
251
|
+
fix(fixer) {
|
252
|
+
const sourceCode = context.sourceCode;
|
253
|
+
let prevToken = getActualLastToken(sourceCode, prevNode);
|
254
|
+
const nextToken =
|
255
|
+
sourceCode.getFirstTokenBetween(prevToken, nextNode, {
|
256
|
+
includeComments: true,
|
257
|
+
|
258
|
+
/**
|
259
|
+
* Skip the trailing comments of the previous node.
|
260
|
+
* This inserts a blank line after the last trailing comment.
|
261
|
+
*
|
262
|
+
* For example:
|
263
|
+
*
|
264
|
+
* foo(); // trailing comment.
|
265
|
+
* // comment.
|
266
|
+
* bar();
|
267
|
+
*
|
268
|
+
* Get fixed to:
|
269
|
+
*
|
270
|
+
* foo(); // trailing comment.
|
271
|
+
*
|
272
|
+
* // comment.
|
273
|
+
* bar();
|
274
|
+
* @param {Token} token The token to check.
|
275
|
+
* @returns {boolean} `true` if the token is not a trailing comment.
|
276
|
+
* @private
|
277
|
+
*/
|
278
|
+
filter(token) {
|
279
|
+
if (astUtils.isTokenOnSameLine(prevToken, token)) {
|
280
|
+
prevToken = token;
|
281
|
+
return false;
|
282
|
+
}
|
283
|
+
return true;
|
284
|
+
},
|
285
|
+
}) || nextNode;
|
286
|
+
const insertText = astUtils.isTokenOnSameLine(prevToken, nextToken)
|
287
|
+
? "\n\n"
|
288
|
+
: "\n";
|
289
|
+
|
290
|
+
return fixer.insertTextAfter(prevToken, insertText);
|
291
|
+
},
|
292
|
+
});
|
289
293
|
}
|
290
294
|
|
291
295
|
/**
|
@@ -295,9 +299,9 @@ function verifyForAlways(context, prevNode, nextNode, paddingLines) {
|
|
295
299
|
* @private
|
296
300
|
*/
|
297
301
|
const PaddingTypes = {
|
298
|
-
|
299
|
-
|
300
|
-
|
302
|
+
any: { verify: verifyForAny },
|
303
|
+
never: { verify: verifyForNever },
|
304
|
+
always: { verify: verifyForAlways },
|
301
305
|
};
|
302
306
|
|
303
307
|
/**
|
@@ -306,75 +310,76 @@ const PaddingTypes = {
|
|
306
310
|
* @private
|
307
311
|
*/
|
308
312
|
const StatementTypes = {
|
309
|
-
|
310
|
-
|
311
|
-
|
312
|
-
|
313
|
-
|
314
|
-
|
315
|
-
|
316
|
-
|
317
|
-
|
318
|
-
|
319
|
-
|
320
|
-
|
321
|
-
|
322
|
-
|
323
|
-
|
324
|
-
|
325
|
-
|
326
|
-
|
327
|
-
|
328
|
-
|
329
|
-
|
330
|
-
|
331
|
-
|
332
|
-
|
333
|
-
|
334
|
-
|
335
|
-
|
336
|
-
|
337
|
-
|
338
|
-
|
339
|
-
|
340
|
-
|
341
|
-
|
342
|
-
|
343
|
-
|
344
|
-
|
345
|
-
|
346
|
-
|
347
|
-
|
348
|
-
|
349
|
-
|
350
|
-
|
351
|
-
|
352
|
-
|
353
|
-
|
354
|
-
|
355
|
-
|
356
|
-
|
357
|
-
|
358
|
-
|
359
|
-
|
360
|
-
|
361
|
-
|
362
|
-
|
363
|
-
|
364
|
-
|
365
|
-
|
366
|
-
|
367
|
-
|
368
|
-
|
369
|
-
|
370
|
-
|
371
|
-
|
372
|
-
|
373
|
-
|
374
|
-
|
375
|
-
|
376
|
-
|
377
|
-
|
313
|
+
"*": { test: () => true },
|
314
|
+
"block-like": {
|
315
|
+
test: (node, sourceCode) => isBlockLikeStatement(sourceCode, node),
|
316
|
+
},
|
317
|
+
"cjs-export": {
|
318
|
+
test: (node, sourceCode) =>
|
319
|
+
node.type === "ExpressionStatement" &&
|
320
|
+
node.expression.type === "AssignmentExpression" &&
|
321
|
+
CJS_EXPORT.test(sourceCode.getText(node.expression.left)),
|
322
|
+
},
|
323
|
+
"cjs-import": {
|
324
|
+
test: (node, sourceCode) =>
|
325
|
+
node.type === "VariableDeclaration" &&
|
326
|
+
node.declarations.length > 0 &&
|
327
|
+
Boolean(node.declarations[0].init) &&
|
328
|
+
CJS_IMPORT.test(sourceCode.getText(node.declarations[0].init)),
|
329
|
+
},
|
330
|
+
directive: {
|
331
|
+
test: astUtils.isDirective,
|
332
|
+
},
|
333
|
+
expression: {
|
334
|
+
test: node =>
|
335
|
+
node.type === "ExpressionStatement" && !astUtils.isDirective(node),
|
336
|
+
},
|
337
|
+
iife: {
|
338
|
+
test: isIIFEStatement,
|
339
|
+
},
|
340
|
+
"multiline-block-like": {
|
341
|
+
test: (node, sourceCode) =>
|
342
|
+
node.loc.start.line !== node.loc.end.line &&
|
343
|
+
isBlockLikeStatement(sourceCode, node),
|
344
|
+
},
|
345
|
+
"multiline-expression": {
|
346
|
+
test: node =>
|
347
|
+
node.loc.start.line !== node.loc.end.line &&
|
348
|
+
node.type === "ExpressionStatement" &&
|
349
|
+
!astUtils.isDirective(node),
|
350
|
+
},
|
351
|
+
|
352
|
+
"multiline-const": newMultilineKeywordTester("const"),
|
353
|
+
"multiline-let": newMultilineKeywordTester("let"),
|
354
|
+
"multiline-var": newMultilineKeywordTester("var"),
|
355
|
+
"singleline-const": newSinglelineKeywordTester("const"),
|
356
|
+
"singleline-let": newSinglelineKeywordTester("let"),
|
357
|
+
"singleline-var": newSinglelineKeywordTester("var"),
|
358
|
+
|
359
|
+
block: newNodeTypeTester("BlockStatement"),
|
360
|
+
empty: newNodeTypeTester("EmptyStatement"),
|
361
|
+
function: newNodeTypeTester("FunctionDeclaration"),
|
362
|
+
|
363
|
+
break: newKeywordTester("break"),
|
364
|
+
case: newKeywordTester("case"),
|
365
|
+
class: newKeywordTester("class"),
|
366
|
+
const: newKeywordTester("const"),
|
367
|
+
continue: newKeywordTester("continue"),
|
368
|
+
debugger: newKeywordTester("debugger"),
|
369
|
+
default: newKeywordTester("default"),
|
370
|
+
do: newKeywordTester("do"),
|
371
|
+
export: newKeywordTester("export"),
|
372
|
+
for: newKeywordTester("for"),
|
373
|
+
if: newKeywordTester("if"),
|
374
|
+
import: newKeywordTester("import"),
|
375
|
+
let: newKeywordTester("let"),
|
376
|
+
return: newKeywordTester("return"),
|
377
|
+
switch: newKeywordTester("switch"),
|
378
|
+
throw: newKeywordTester("throw"),
|
379
|
+
try: newKeywordTester("try"),
|
380
|
+
var: newKeywordTester("var"),
|
381
|
+
while: newKeywordTester("while"),
|
382
|
+
with: newKeywordTester("with"),
|
378
383
|
};
|
379
384
|
|
380
385
|
//------------------------------------------------------------------------------
|
@@ -383,226 +388,225 @@ const StatementTypes = {
|
|
383
388
|
|
384
389
|
/** @type {import('../shared/types').Rule} */
|
385
390
|
module.exports = {
|
386
|
-
|
387
|
-
|
388
|
-
|
389
|
-
|
390
|
-
|
391
|
-
|
392
|
-
|
393
|
-
|
394
|
-
|
395
|
-
|
396
|
-
|
397
|
-
|
398
|
-
|
399
|
-
|
400
|
-
|
401
|
-
|
402
|
-
|
403
|
-
|
404
|
-
|
405
|
-
|
406
|
-
|
407
|
-
|
408
|
-
|
409
|
-
|
410
|
-
|
411
|
-
|
412
|
-
|
413
|
-
|
414
|
-
|
415
|
-
|
416
|
-
|
417
|
-
|
418
|
-
|
419
|
-
|
420
|
-
|
421
|
-
|
422
|
-
|
423
|
-
|
424
|
-
|
425
|
-
|
426
|
-
|
427
|
-
|
428
|
-
|
429
|
-
|
430
|
-
|
431
|
-
|
432
|
-
|
433
|
-
|
434
|
-
|
435
|
-
|
436
|
-
|
437
|
-
|
438
|
-
|
439
|
-
|
440
|
-
|
441
|
-
|
442
|
-
|
443
|
-
|
444
|
-
|
445
|
-
|
446
|
-
|
447
|
-
|
448
|
-
|
449
|
-
|
450
|
-
|
451
|
-
|
452
|
-
|
453
|
-
|
454
|
-
|
455
|
-
|
456
|
-
|
457
|
-
|
458
|
-
|
459
|
-
|
460
|
-
|
461
|
-
|
462
|
-
|
463
|
-
|
464
|
-
|
465
|
-
|
466
|
-
|
467
|
-
|
468
|
-
|
469
|
-
|
470
|
-
|
471
|
-
|
472
|
-
|
473
|
-
|
474
|
-
|
475
|
-
|
476
|
-
|
477
|
-
|
478
|
-
|
479
|
-
|
480
|
-
|
481
|
-
|
482
|
-
|
483
|
-
|
484
|
-
|
485
|
-
|
486
|
-
|
487
|
-
|
488
|
-
|
489
|
-
|
490
|
-
|
491
|
-
|
492
|
-
|
493
|
-
|
494
|
-
|
495
|
-
|
496
|
-
|
497
|
-
|
498
|
-
|
499
|
-
|
500
|
-
|
501
|
-
|
502
|
-
|
503
|
-
|
504
|
-
|
505
|
-
|
506
|
-
|
507
|
-
|
508
|
-
|
509
|
-
|
510
|
-
|
511
|
-
|
512
|
-
|
513
|
-
|
514
|
-
|
515
|
-
|
516
|
-
|
517
|
-
|
518
|
-
|
519
|
-
|
520
|
-
|
521
|
-
|
522
|
-
|
523
|
-
|
524
|
-
|
525
|
-
|
526
|
-
|
527
|
-
|
528
|
-
|
529
|
-
|
530
|
-
|
531
|
-
|
532
|
-
|
533
|
-
|
534
|
-
|
535
|
-
|
536
|
-
|
537
|
-
|
538
|
-
|
539
|
-
|
540
|
-
|
541
|
-
|
542
|
-
|
543
|
-
|
544
|
-
|
545
|
-
|
546
|
-
|
547
|
-
|
548
|
-
|
549
|
-
|
550
|
-
|
551
|
-
|
552
|
-
|
553
|
-
|
554
|
-
|
555
|
-
|
556
|
-
|
557
|
-
|
558
|
-
|
559
|
-
|
560
|
-
|
561
|
-
|
562
|
-
|
563
|
-
|
564
|
-
|
565
|
-
|
566
|
-
|
567
|
-
|
568
|
-
|
569
|
-
|
570
|
-
|
571
|
-
|
572
|
-
|
573
|
-
|
574
|
-
|
575
|
-
|
576
|
-
|
577
|
-
|
578
|
-
|
579
|
-
|
580
|
-
|
581
|
-
|
582
|
-
|
583
|
-
|
584
|
-
|
585
|
-
|
586
|
-
|
587
|
-
|
588
|
-
|
589
|
-
|
590
|
-
|
591
|
-
|
592
|
-
|
593
|
-
|
594
|
-
|
595
|
-
|
596
|
-
|
597
|
-
|
598
|
-
|
599
|
-
|
600
|
-
|
601
|
-
|
602
|
-
|
603
|
-
|
604
|
-
|
605
|
-
|
606
|
-
|
607
|
-
}
|
391
|
+
meta: {
|
392
|
+
deprecated: {
|
393
|
+
message: "Formatting rules are being moved out of ESLint core.",
|
394
|
+
url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/",
|
395
|
+
deprecatedSince: "8.53.0",
|
396
|
+
availableUntil: "10.0.0",
|
397
|
+
replacedBy: [
|
398
|
+
{
|
399
|
+
message:
|
400
|
+
"ESLint Stylistic now maintains deprecated stylistic core rules.",
|
401
|
+
url: "https://eslint.style/guide/migration",
|
402
|
+
plugin: {
|
403
|
+
name: "@stylistic/eslint-plugin-js",
|
404
|
+
url: "https://eslint.style/packages/js",
|
405
|
+
},
|
406
|
+
rule: {
|
407
|
+
name: "padding-line-between-statements",
|
408
|
+
url: "https://eslint.style/rules/js/padding-line-between-statements",
|
409
|
+
},
|
410
|
+
},
|
411
|
+
],
|
412
|
+
},
|
413
|
+
type: "layout",
|
414
|
+
|
415
|
+
docs: {
|
416
|
+
description: "Require or disallow padding lines between statements",
|
417
|
+
recommended: false,
|
418
|
+
url: "https://eslint.org/docs/latest/rules/padding-line-between-statements",
|
419
|
+
},
|
420
|
+
|
421
|
+
fixable: "whitespace",
|
422
|
+
|
423
|
+
schema: {
|
424
|
+
definitions: {
|
425
|
+
paddingType: {
|
426
|
+
enum: Object.keys(PaddingTypes),
|
427
|
+
},
|
428
|
+
statementType: {
|
429
|
+
anyOf: [
|
430
|
+
{ enum: Object.keys(StatementTypes) },
|
431
|
+
{
|
432
|
+
type: "array",
|
433
|
+
items: { enum: Object.keys(StatementTypes) },
|
434
|
+
minItems: 1,
|
435
|
+
uniqueItems: true,
|
436
|
+
},
|
437
|
+
],
|
438
|
+
},
|
439
|
+
},
|
440
|
+
type: "array",
|
441
|
+
items: {
|
442
|
+
type: "object",
|
443
|
+
properties: {
|
444
|
+
blankLine: { $ref: "#/definitions/paddingType" },
|
445
|
+
prev: { $ref: "#/definitions/statementType" },
|
446
|
+
next: { $ref: "#/definitions/statementType" },
|
447
|
+
},
|
448
|
+
additionalProperties: false,
|
449
|
+
required: ["blankLine", "prev", "next"],
|
450
|
+
},
|
451
|
+
},
|
452
|
+
|
453
|
+
messages: {
|
454
|
+
unexpectedBlankLine: "Unexpected blank line before this statement.",
|
455
|
+
expectedBlankLine: "Expected blank line before this statement.",
|
456
|
+
},
|
457
|
+
},
|
458
|
+
|
459
|
+
create(context) {
|
460
|
+
const sourceCode = context.sourceCode;
|
461
|
+
const configureList = context.options || [];
|
462
|
+
let scopeInfo = null;
|
463
|
+
|
464
|
+
/**
|
465
|
+
* Processes to enter to new scope.
|
466
|
+
* This manages the current previous statement.
|
467
|
+
* @returns {void}
|
468
|
+
* @private
|
469
|
+
*/
|
470
|
+
function enterScope() {
|
471
|
+
scopeInfo = {
|
472
|
+
upper: scopeInfo,
|
473
|
+
prevNode: null,
|
474
|
+
};
|
475
|
+
}
|
476
|
+
|
477
|
+
/**
|
478
|
+
* Processes to exit from the current scope.
|
479
|
+
* @returns {void}
|
480
|
+
* @private
|
481
|
+
*/
|
482
|
+
function exitScope() {
|
483
|
+
scopeInfo = scopeInfo.upper;
|
484
|
+
}
|
485
|
+
|
486
|
+
/**
|
487
|
+
* Checks whether the given node matches the given type.
|
488
|
+
* @param {ASTNode} node The statement node to check.
|
489
|
+
* @param {string|string[]} type The statement type to check.
|
490
|
+
* @returns {boolean} `true` if the statement node matched the type.
|
491
|
+
* @private
|
492
|
+
*/
|
493
|
+
function match(node, type) {
|
494
|
+
let innerStatementNode = node;
|
495
|
+
|
496
|
+
while (innerStatementNode.type === "LabeledStatement") {
|
497
|
+
innerStatementNode = innerStatementNode.body;
|
498
|
+
}
|
499
|
+
if (Array.isArray(type)) {
|
500
|
+
return type.some(match.bind(null, innerStatementNode));
|
501
|
+
}
|
502
|
+
return StatementTypes[type].test(innerStatementNode, sourceCode);
|
503
|
+
}
|
504
|
+
|
505
|
+
/**
|
506
|
+
* Finds the last matched configure from configureList.
|
507
|
+
* @param {ASTNode} prevNode The previous statement to match.
|
508
|
+
* @param {ASTNode} nextNode The current statement to match.
|
509
|
+
* @returns {Object} The tester of the last matched configure.
|
510
|
+
* @private
|
511
|
+
*/
|
512
|
+
function getPaddingType(prevNode, nextNode) {
|
513
|
+
for (let i = configureList.length - 1; i >= 0; --i) {
|
514
|
+
const configure = configureList[i];
|
515
|
+
const matched =
|
516
|
+
match(prevNode, configure.prev) &&
|
517
|
+
match(nextNode, configure.next);
|
518
|
+
|
519
|
+
if (matched) {
|
520
|
+
return PaddingTypes[configure.blankLine];
|
521
|
+
}
|
522
|
+
}
|
523
|
+
return PaddingTypes.any;
|
524
|
+
}
|
525
|
+
|
526
|
+
/**
|
527
|
+
* Gets padding line sequences between the given 2 statements.
|
528
|
+
* Comments are separators of the padding line sequences.
|
529
|
+
* @param {ASTNode} prevNode The previous statement to count.
|
530
|
+
* @param {ASTNode} nextNode The current statement to count.
|
531
|
+
* @returns {Array<Token[]>} The array of token pairs.
|
532
|
+
* @private
|
533
|
+
*/
|
534
|
+
function getPaddingLineSequences(prevNode, nextNode) {
|
535
|
+
const pairs = [];
|
536
|
+
let prevToken = getActualLastToken(sourceCode, prevNode);
|
537
|
+
|
538
|
+
if (nextNode.loc.start.line - prevToken.loc.end.line >= 2) {
|
539
|
+
do {
|
540
|
+
const token = sourceCode.getTokenAfter(prevToken, {
|
541
|
+
includeComments: true,
|
542
|
+
});
|
543
|
+
|
544
|
+
if (token.loc.start.line - prevToken.loc.end.line >= 2) {
|
545
|
+
pairs.push([prevToken, token]);
|
546
|
+
}
|
547
|
+
prevToken = token;
|
548
|
+
} while (prevToken.range[0] < nextNode.range[0]);
|
549
|
+
}
|
550
|
+
|
551
|
+
return pairs;
|
552
|
+
}
|
553
|
+
|
554
|
+
/**
|
555
|
+
* Verify padding lines between the given node and the previous node.
|
556
|
+
* @param {ASTNode} node The node to verify.
|
557
|
+
* @returns {void}
|
558
|
+
* @private
|
559
|
+
*/
|
560
|
+
function verify(node) {
|
561
|
+
const parentType = node.parent.type;
|
562
|
+
const validParent =
|
563
|
+
astUtils.STATEMENT_LIST_PARENTS.has(parentType) ||
|
564
|
+
parentType === "SwitchStatement";
|
565
|
+
|
566
|
+
if (!validParent) {
|
567
|
+
return;
|
568
|
+
}
|
569
|
+
|
570
|
+
// Save this node as the current previous statement.
|
571
|
+
const prevNode = scopeInfo.prevNode;
|
572
|
+
|
573
|
+
// Verify.
|
574
|
+
if (prevNode) {
|
575
|
+
const type = getPaddingType(prevNode, node);
|
576
|
+
const paddingLines = getPaddingLineSequences(prevNode, node);
|
577
|
+
|
578
|
+
type.verify(context, prevNode, node, paddingLines);
|
579
|
+
}
|
580
|
+
|
581
|
+
scopeInfo.prevNode = node;
|
582
|
+
}
|
583
|
+
|
584
|
+
/**
|
585
|
+
* Verify padding lines between the given node and the previous node.
|
586
|
+
* Then process to enter to new scope.
|
587
|
+
* @param {ASTNode} node The node to verify.
|
588
|
+
* @returns {void}
|
589
|
+
* @private
|
590
|
+
*/
|
591
|
+
function verifyThenEnterScope(node) {
|
592
|
+
verify(node);
|
593
|
+
enterScope();
|
594
|
+
}
|
595
|
+
|
596
|
+
return {
|
597
|
+
Program: enterScope,
|
598
|
+
BlockStatement: enterScope,
|
599
|
+
SwitchStatement: enterScope,
|
600
|
+
StaticBlock: enterScope,
|
601
|
+
"Program:exit": exitScope,
|
602
|
+
"BlockStatement:exit": exitScope,
|
603
|
+
"SwitchStatement:exit": exitScope,
|
604
|
+
"StaticBlock:exit": exitScope,
|
605
|
+
|
606
|
+
":statement": verify,
|
607
|
+
|
608
|
+
SwitchCase: verifyThenEnterScope,
|
609
|
+
"SwitchCase:exit": exitScope,
|
610
|
+
};
|
611
|
+
},
|
608
612
|
};
|