Release 1.32.0

src/docs/guide/usage/linter/generated-cli.md

@@ -75,8 +75,6 @@ Arguments:
   Enable the promise plugin and detect promise usage problems
 - **`--node-plugin`** —
   Enable the node plugin and detect node usage problems
-- **`--regex-plugin`** —
-  Enable the regex plugin and detect regex usage problems
 - **`--vue-plugin`** —
   Enable the vue plugin and detect vue usage problems
 

src/docs/guide/usage/linter/generated-rules.md

@@ -6,7 +6,7 @@ search: false
 
 The progress of all rule implementations is tracked [here](https://github.com/oxc-project/oxc/issues/481).
 
-- Total number of rules: 618
+- Total number of rules: 619
 - Rules turned on by default: 103
 
 **Legend for 'Fixable?' column:**
@@ -378,7 +378,7 @@ code that is most likely wrong or useless.
 | [no-required-prop-with-default](/docs/guide/usage/linter/rules/vue/no-required-prop-with-default.html)                          | vue        |         | 🚧       |
 | [require-default-export](/docs/guide/usage/linter/rules/vue/require-default-export.html)                                        | vue        |         |          |
 
-## Pedantic (106):
+## Pedantic (107):
 
 Lints which are rather strict or have occasional false positives.
 
@@ -405,6 +405,7 @@ Lints which are rather strict or have occasional false positives.
 | [no-redeclare](/docs/guide/usage/linter/rules/eslint/no-redeclare.html)                                                        | eslint     |         |          |
 | [no-self-compare](/docs/guide/usage/linter/rules/eslint/no-self-compare.html)                                                  | eslint     |         |          |
 | [no-throw-literal](/docs/guide/usage/linter/rules/eslint/no-throw-literal.html)                                                | eslint     |         | 💡       |
+| [no-useless-return](/docs/guide/usage/linter/rules/eslint/no-useless-return.html)                                              | eslint     |         | 🚧       |
 | [no-warning-comments](/docs/guide/usage/linter/rules/eslint/no-warning-comments.html)                                          | eslint     |         |          |
 | [radix](/docs/guide/usage/linter/rules/eslint/radix.html)                                                                      | eslint     |         | ⚠️🛠️️       |
 | [require-await](/docs/guide/usage/linter/rules/eslint/require-await.html)                                                      | eslint     |         | ⚠️🛠️️       |
@@ -497,7 +498,7 @@ Code that should be written in a more idiomatic way.
 
 | Rule name                                                                                                                | Source     | Default | Fixable? |
 | ------------------------------------------------------------------------------------------------------------------------ | ---------- | ------- | -------- |
-| [arrow-body-style](/docs/guide/usage/linter/rules/eslint/arrow-body-style.html)                                          | eslint     |         | 🚧       |
+| [arrow-body-style](/docs/guide/usage/linter/rules/eslint/arrow-body-style.html)                                          | eslint     |         | 🛠️        |
 | [curly](/docs/guide/usage/linter/rules/eslint/curly.html)                                                                | eslint     |         | 🛠️        |
 | [default-case-last](/docs/guide/usage/linter/rules/eslint/default-case-last.html)                                        | eslint     |         |          |
 | [default-param-last](/docs/guide/usage/linter/rules/eslint/default-param-last.html)                                      | eslint     |         |          |

src/docs/guide/usage/linter/rules/eslint/arrow-body-style.md

@@ -9,7 +9,7 @@ const source = `https://github.com/oxc-project/oxc/blob/${ data }/crates/oxc_lin
 
 <div class="rule-meta">
 <Alert class="fix" type="info">
-<span class="emoji">🚧</span> An auto-fix is planned for this rule, but not implemented at this time.
+<span class="emoji">🛠️</span> An auto-fix is available for this rule.
 </Alert>
 </div>
 
@@ -32,13 +32,13 @@ First option:
 
 - Type: `string`
 - Enum: `"always"`, `"as-needed"`, `"never"`
-- Default: `"never"`
+- Default: `"as-needed"`
 
 Possible values:
 
-- `never` enforces no braces where they can be omitted (default)
+- `never` enforces no braces around the function body (constrains arrow functions to the role of returning an expression)
 - `always` enforces braces around the function body
-- `as-needed` enforces no braces around the function body (constrains arrow functions to the role of returning an expression)
+- `as-needed` enforces no braces where they can be omitted (default)
 
 Second option:
 

src/docs/guide/usage/linter/rules/eslint/max-lines-per-function.md

@@ -61,7 +61,7 @@ function foo() {
 
 This rule accepts a configuration object with the following properties:
 
-### iifes
+### IIFEs
 
 type: `boolean`
 

src/docs/guide/usage/linter/rules/eslint/no-useless-return.md

@@ -0,0 +1,89 @@
+<!-- This file is auto-generated by tasks/website_linter/src/rules/doc_page.rs. Do not edit it manually. -->
+
+<script setup>
+import { data } from '../version.data.js';
+const source = `https://github.com/oxc-project/oxc/blob/${ data }/crates/oxc_linter/src/rules/eslint/no_useless_return.rs`;
+</script>
+
+# eslint/no-useless-return <Badge type="info" text="Pedantic" />
+
+<div class="rule-meta">
+<Alert class="fix" type="info">
+<span class="emoji">🚧</span> An auto-fix is planned for this rule, but not implemented at this time.
+</Alert>
+</div>
+
+### What it does
+
+Disallows redundant return statements.
+
+### Why is this bad?
+
+A `return;` statement with nothing after it is redundant, and has no effect
+on the runtime behavior of a function. This can be confusing, so it's better
+to disallow these redundant statements.
+
+### Examples
+
+Examples of **incorrect** code for this rule:
+
+```js
+function foo() {
+  return;
+}
+
+function bar() {
+  doSomething();
+  return;
+}
+
+function baz() {
+  if (condition) {
+    doSomething();
+    return;
+  }
+}
+```
+
+Examples of **correct** code for this rule:
+
+```js
+function foo() {
+  return 5;
+}
+
+function bar() {
+  if (condition) {
+    return;
+  }
+  doSomething();
+}
+
+function baz() {
+  return doSomething();
+}
+```
+
+## How to use
+
+To **enable** this rule using the config file or in the CLI, you can use:
+
+::: code-group
+
+```json [Config (.oxlintrc.json)]
+{
+  "rules": {
+    "no-useless-return": "error"
+  }
+}
+```
+
+```bash [CLI]
+oxlint --deny no-useless-return
+```
+
+:::
+
+## References
+
+- <a v-bind:href="source" target="_blank" rel="noreferrer">Rule Source</a>

src/docs/guide/usage/linter/rules/jest/consistent-test-it.md

@@ -58,7 +58,7 @@ describe("foo", function() {
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/consistent-test-it.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/expect-expect.md

@@ -30,7 +30,7 @@ test("should assert something", () => {});
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/expect-expect.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {
@@ -52,32 +52,23 @@ default: `[]`
 
 An array of function names that should also be treated as test blocks.
 
-### assertFunctionNamesJest
+### assertFunctionNames
 
 type: `string[]`
 
 default: `["expect"]`
 
 A list of function names that should be treated as assertion functions.
 
-### assertFunctionNamesVitest
-
-type: `string[]`
-
-default: `["expect", "expectTypeOf", "assert", "assertType"]`
-
-A list of function names that should be treated as assertion functions for Vitest.
+NOTE: The default value is `["expect"]` for Jest and
+`["expect", "expectTypeOf", "assert", "assertType"]` for Vitest.
 
 ## How to use
 
-To **enable** this rule in the CLI or using the config file, you can use:
+To **enable** this rule using the config file or in the CLI, you can use:
 
 ::: code-group
 
-```bash [CLI]
-oxlint --deny jest/expect-expect --jest-plugin
-```
-
 ```json [Config (.oxlintrc.json)]
 {
   "plugins": ["jest"],
@@ -87,6 +78,10 @@ oxlint --deny jest/expect-expect --jest-plugin
 }
 ```
 
+```bash [CLI]
+oxlint --deny jest/expect-expect --jest-plugin
+```
+
 :::
 
 ## References

src/docs/guide/usage/linter/rules/jest/no-alias-methods.md

@@ -57,7 +57,7 @@ expect(a).toThrow();
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/no-alias-methods.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/no-commented-out-tests.md

@@ -35,7 +35,7 @@ Examples of **incorrect** code for this rule:
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/no-commented-out-tests.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/no-disabled-tests.md

@@ -45,7 +45,7 @@ it("foo", () => {
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/no-disabled-tests.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/no-focused-tests.md

@@ -45,7 +45,7 @@ table
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/no-focused-tests.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/no-identical-title.md

@@ -36,7 +36,7 @@ describe("baz", () => {
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/no-identical-title.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/no-test-prefixes.md

@@ -40,7 +40,7 @@ xdescribe("foo"); // invalid
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/no-test-prefixes.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/prefer-hooks-in-order.md

@@ -116,7 +116,7 @@ describe("foo", () => {
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/prefer-hooks-in-order.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/valid-describe-callback.md

@@ -48,7 +48,7 @@ describe("myFunction", () =>
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/valid-describe-callback.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jest/valid-expect.md

@@ -40,7 +40,7 @@ expect(Promise.resolve("Hi!")).resolves.toBe("Hi!");
 ```
 
 This rule is compatible with [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest/blob/v1.1.9/docs/rules/valid-expect.md),
-to use it, add the following configuration to your `.eslintrc.json`:
+to use it, add the following configuration to your `.oxlintrc.json`:
 
 ```json
 {

src/docs/guide/usage/linter/rules/jsx_a11y/img-redundant-alt.md

@@ -44,33 +44,29 @@ Examples of **correct** code for this rule:
 
 This rule accepts a configuration object with the following properties:
 
-### redundantWords
+### components
 
 type: `string[]`
 
-default: `["image", "photo", "picture"]`
+default: `["img"]`
 
-Words considered redundant in alt text that should trigger a warning.
+JSX element types to validate (component names) where the rule applies.
+For example, `["img", "Image"]`.
 
-### typesToValidate
+### words
 
 type: `string[]`
 
-default: `["img"]`
+default: `["image", "photo", "picture"]`
 
-JSX element types to validate (component names) where the rule applies.
-For example, `["img", "Image"]`.
+Words considered redundant in alt text that should trigger a warning.
 
 ## How to use
 
-To **enable** this rule in the CLI or using the config file, you can use:
+To **enable** this rule using the config file or in the CLI, you can use:
 
 ::: code-group
 
-```bash [CLI]
-oxlint --deny jsx-a11y/img-redundant-alt --jsx-a11y-plugin
-```
-
 ```json [Config (.oxlintrc.json)]
 {
   "plugins": ["jsx-a11y"],
@@ -80,6 +76,10 @@ oxlint --deny jsx-a11y/img-redundant-alt --jsx-a11y-plugin
 }
 ```
 
+```bash [CLI]
+oxlint --deny jsx-a11y/img-redundant-alt --jsx-a11y-plugin
+```
+
 :::
 
 ## References

src/docs/guide/usage/linter/rules/react/jsx-fragments.md

@@ -23,15 +23,9 @@ Makes code using fragments more consistent one way or the other.
 
 ## Configuration
 
-This rule accepts a configuration object with the following properties:
+This rule accepts one of the following string values:
 
-### mode
-
-type: `"syntax" | "element"`
-
-default: `"syntax"`
-
-`syntax` mode:
+### `"syntax"`
 
 This is the default mode. It will enforce the shorthand syntax for React fragments, with one exception.
 Keys or attributes are not supported by the shorthand syntax, so the rule will not warn on standard-form fragments that use those.
@@ -58,7 +52,8 @@ Examples of **correct** code for this rule:
 </React.Fragment>;
 ```
 
-`element` mode:
+### `"element"`
+
 This mode enforces the standard form for React fragments.
 
 Examples of **incorrect** code for this rule: