Merge branch 'main' into react-dom/no-render

Author: Rel1cx

.adrs/0000-choice-between-useless-and-unnecessary-in-rule-naming.md

@@ -0,0 +1,39 @@
+# ADR 0000: Choice between "useless" and "unnecessary" in rule naming
+
+## Status
+
+Accepted
+
+## Context
+
+When naming rules related to identifying redundant or non-functional code (e.g., in linting or static analysis), the terms "useless" and "unnecessary" both convey a sense of superfluity. However, their nuanced semantic differences could lead to ambiguity if misapplied. For example, a `forwardRef` call with no `ref` usage is entirely without purpose, but other scenarios might involve optional code that is only redundant in specific contexts. A consistent naming convention is needed to ensure clarity and accuracy in rule documentation and error messaging.
+
+## Decision
+
+Use "useless" to describe code that has no functional purpose under any circumstances (e.g., a `forwardRef` call with no `ref` usage).
+
+Use "unnecessary" to describe code that is contextually redundant but not strictly non-functional (e.g., an `useEffect` that runs event-specific logic).
+
+## Consequences
+
+- Improved clarity: Developers can better discern whether code is strictly non-functional ("useless") or situationally redundant ("unnecessary").
+
+- Consistency: Rules and error messages will align with precise semantic definitions.
+
+- Potential learning curve: Teams may need documentation to understand the distinction initially.
+
+## Alternatives Considered
+
+1. Using only "unnecessary" for all cases:
+   - Rejected because it conflates fundamentally distinct scenarios (strictly non-functional vs. contextually redundant), reducing diagnostic precision.
+
+2. Using only "useless" for all cases:
+   - Rejected because it could mislabel code that is optional but valid in other contexts, leading to confusion or dismissal of valid feedback.
+
+## Related ADRs
+
+N/A
+
+## Links
+
+N/A

.adrs/0001-rename-ensure-forward-ref-using-ref-to-no-useless-forward-ref.md

@@ -0,0 +1,32 @@
+# ADR 0001: Rename ensure-forward-ref-using-ref to no-useless-forward-ref
+
+## Status
+
+Accepted
+
+## Context
+
+Renaming the `ensure-forward-ref-using-ref` rule to align with the existing rule naming conventions and accurately reflect the rule's focus on non-functional code.
+
+## Decision
+
+Rename the rule to **`no-useless-forward-ref`** adhere to the `no-<category>-<term>` pattern used in similar rules (e.g., `no-useless-fragment`).
+
+## Consequences
+
+- The rule name will be more consistent with other rules in the project.
+- The rule name will more accurately reflect the rule's focus on non-functional code.
+
+## Alternatives Considered
+
+Using `no-unnecessary-forward-ref`:
+
+- Rejected because "unnecessary" implies optional redundancy, in this case, the `forwardRef` call is always redundant.
+
+## Related ADRs
+
+- [ADR 0000: Choice between "useless" and "unnecessary" in rule naming](./0000-choice-between-useless-and-unnecessary-in-rule-naming.md)
+
+## Links
+
+N/A

.github/workflows/publish.yml

@@ -7,12 +7,10 @@ on:
       - "**"
     paths-ignore:
       - "**/*.gitignore"
+      - .adrs/**
       - .editorconfig
-      - adrs/**
-      - docs/**
+      - apps/**
       - examples/**
-      - website/**
-      - scripts/**
   pull_request: null
 jobs:
   publish:

.pkgs/configs/package.json

@@ -21,7 +21,7 @@
   "dependencies": {
     "@eslint/js": "^9.22.0",
     "@stylistic/eslint-plugin": "^4.2.0",
-    "eslint-plugin-de-morgan": "^1.2.0",
+    "eslint-plugin-de-morgan": "^1.2.1",
     "eslint-plugin-jsdoc": "^50.6.6",
     "eslint-plugin-perfectionist": "^4.10.1",
     "eslint-plugin-regexp": "^2.7.0",

.pkgs/eslint-plugin-local/package.json

@@ -31,7 +31,7 @@
     "@typescript-eslint/type-utils": "^8.26.1",
     "@typescript-eslint/types": "^8.26.1",
     "@typescript-eslint/utils": "^8.26.1",
-    "eslint-plugin-de-morgan": "^1.2.0",
+    "eslint-plugin-de-morgan": "^1.2.1",
     "eslint-plugin-jsdoc": "^50.6.6",
     "eslint-plugin-perfectionist": "^4.10.1",
     "eslint-plugin-regexp": "^2.7.0",

.vscode/settings.json

@@ -3,7 +3,7 @@
     "editor.defaultFormatter": "dprint.dprint"
   },
   "[jsonc]": {
-    "editor.defaultFormatter": "dprint.dprint"
+    "editor.defaultFormatter": "vscode.json-language-features"
   },
   "[typescript]": {
     "editor.defaultFormatter": "dprint.dprint"

CHANGELOG.md

@@ -1,3 +1,42 @@
+## v1.34.0 (2025-03-15)
+
+### 🪄 Improvements
+
+- refactor: export the create function of each rule by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/989
+- refactor(plugins/x): rename `no-nested-components` rule to `no-nested-component-definitions` and update related docs by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/990
+
+### 📝 Changes you should be aware of
+
+The following rules have been renamed:
+
+- `react-x/no-nested-components` to `react-x/no-nested-component-definitions`
+- `@eslint-react/no-nested-components` to `@eslint-react/no-nested-component-definitions`
+
+The old rule names will still be available until the next major update to avoid breaking changes.
+
+**Full Changelog**: https://github.com/Rel1cx/eslint-react/compare/v1.33.0...v1.34.0
+
+## v1.33.0 (2025-03-14)
+
+### 🐞 Fixes
+
+- fix: update rule severity for `no-flush-sync` and `no-void-elements-with-children` in recommended presets by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/988
+
+### 🪄 Improvements
+
+- refactor(plugins/x): rename `ensure-forward-ref-using-ref` to `no-useless-forward-ref` by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/987
+
+### 📝 Changes you should be aware of
+
+The following rules have been renamed:
+
+- `react-x/ensure-forward-ref-using-ref` to `react-x/no-useless-forward-ref`
+- `@eslint-react/ensure-forward-ref-using-ref` to `@eslint-react/no-useless-forward-ref`
+
+The old rule names will still be available until the next major update to avoid breaking changes.
+
+**Full Changelog**: https://github.com/Rel1cx/eslint-react/compare/v1.32.1...v1.33.0
+
 ## v1.32.1 (2025-03-13)
 
 ### 🐞 Fixes

VERSION

@@ -1 +1 @@
-1.32.1
+1.34.0

apps/website/app/theme.css

@@ -44,6 +44,15 @@
     border: none;
 }
 
+.dark .prose {
+    --tw-prose-body:
+        color-mix(in oklab, var(--color-fd-foreground) 80%, transparent);
+}
+
+.dark .prose :where(code):not(:where([class~="not-prose"], [class~="not-prose"] *)) {
+    color: #ffffff;
+}
+
 .dark #nd-sidebar {
     --color-fd-muted: hsl(0, 0%, 16%);
     --color-fd-secondary: hsl(0, 0%, 18%);

apps/website/content/docs/changelog.md

@@ -2,6 +2,45 @@
 title: Changelog
 ---
 
+## v1.34.0 (2025-03-15)
+
+### 🪄 Improvements
+
+- refactor: export the create function of each rule by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/989
+- refactor(plugins/x): rename `no-nested-components` rule to `no-nested-component-definitions` and update related docs by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/990
+
+### 📝 Changes you should be aware of
+
+The following rules have been renamed:
+
+- `react-x/no-nested-components` to `react-x/no-nested-component-definitions`
+- `@eslint-react/no-nested-components` to `@eslint-react/no-nested-component-definitions`
+
+The old rule names will still be available until the next major update to avoid breaking changes.
+
+**Full Changelog**: https://github.com/Rel1cx/eslint-react/compare/v1.33.0...v1.34.0
+
+## v1.33.0 (2025-03-14)
+
+### 🐞 Fixes
+
+- fix: update rule severity for `no-flush-sync` and `no-void-elements-with-children` in recommended presets by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/988
+
+### 🪄 Improvements
+
+- refactor(plugins/x): rename `ensure-forward-ref-using-ref` to `no-useless-forward-ref` by @Rel1cx in https://github.com/Rel1cx/eslint-react/pull/987
+
+### 📝 Changes you should be aware of
+
+The following rules have been renamed:
+
+- `react-x/ensure-forward-ref-using-ref` to `react-x/no-useless-forward-ref`
+- `@eslint-react/ensure-forward-ref-using-ref` to `@eslint-react/no-useless-forward-ref`
+
+The old rule names will still be available until the next major update to avoid breaking changes.
+
+**Full Changelog**: https://github.com/Rel1cx/eslint-react/compare/v1.32.1...v1.33.0
+
 ## v1.32.1 (2025-03-13)
 
 ### 🐞 Fixes