eslint-plugin-code-style 1.3.9 → 1.4.3

package/CHANGELOG.md

@@ -0,0 +1,336 @@
+# Changelog
+
+All notable releases of this project are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/) principles.
+
+---
+
+## [1.4.0] - 2026-01-30
+
+**Release Title:** New Rules, Enhanced Auto-Fix & Comprehensive Documentation
+
+**Version Range:** v1.3.1 → v1.4.2
+
+### Added
+
+- **New Rules (3)**
+  - `index-exports-only` - Prevent type/interface definitions in index files (move to types file)
+  - `ternary-condition-multiline` - Format complex ternary conditions with each operand on its own line 🔧 ⚙️
+  - `no-inline-type-definitions` - Extract inline union types to named types in type files ⚙️
+
+- **Auto-Fix Labels in Documentation**
+  - Added 🔧 label to indicate auto-fixable rules
+  - Added legend explaining 🔧 (auto-fixable) and ⚙️ (customizable) labels
+  - Clear distinction: 58 auto-fixable rules, 6 report-only rules
+
+### Enhanced
+
+- **function-naming-convention** - Expanded verb list from ~50 to ~200+ verbs organized by category (CRUD, validation, transformation, UI, lifecycle, network, etc.)
+- **function-object-destructure** - Added auto-fix: inserts destructuring at function body top and replaces `param.prop` with `prop`
+- **component-props-destructure** - Added auto-fix: converts `(props)` to `({ prop1, prop2 })` and replaces `props.x` with `x` 🔧
+- **react-code-order** - Added auto-fix for reordering code blocks in components/hooks
+- **variable-naming-convention** - Added auto-fix for renaming variables to camelCase
+
+### Fixed
+
+- **multiline-if-conditions** - Fix indentation calculation for nested code (use actual line indentation)
+- **classname-multiline** - Fix template literal indentation for inline JSX attributes
+- **function-naming-convention** - Skip React components (PascalCase + returns JSX)
+- **variable-naming-convention** - Skip PascalCase arguments (component references)
+- Add "poll" as recognized verb prefix in function-naming-convention
+
+### Documentation
+
+- Enhanced error messages with examples and helpful context
+- Improved CHANGELOG with full details and Full Changelog links
+- Added GitHub Releases guidelines to AGENTS.md
+
+### Report-Only Rules (6)
+
+These rules cannot be auto-fixed because they require file creation, movement, or cross-file changes:
+- `absolute-imports-only` - Requires knowledge of project structure
+- `index-exports-only` - Requires moving code to new files
+- `jsx-prop-naming-convention` - Requires cross-file prop renaming
+- `module-index-exports` - Requires file creation
+- `no-inline-type-definitions` - Requires extracting types to new files
+- `typescript-definition-location` - Requires moving code to folders
+
+### Stats
+
+- Total Rules: 64 (was 61)
+- Auto-fixable: 58 rules 🔧
+- Report-only: 6 rules
+
+**Full Changelog:** https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.3.1...v1.4.2
+
+---
+
+## [1.3.0] - 2026-01-28
+
+**Release Title:** New Rules, Auto-Fix Enhancements & Agent Skills Integration
+
+**Version Range:** v1.2.1 → v1.3.0
+
+### Added
+
+- **New Rules (2)**
+  - `classname-multiline` - Enforce multiline className formatting with string/template literal format
+  - `function-declaration-style` - Auto-fix function declarations to arrow expressions
+
+- **Agent Skills** - Added [Agent Skills](https://agentskills.io) open standard support
+  - `test-rule` - Test an ESLint rule after creating or modifying it
+  - `validate-types` - Verify TypeScript definitions match rules in index.js
+  - `review-config` - Review recommended ESLint configurations
+  - `audit-docs` - Verify documentation accuracy across all files
+  - Compatible with Claude Code, Cursor, VS Code, GitHub Copilot, Gemini CLI, and more
+
+- **TypeScript Support**
+  - Added `index.d.ts` with full type definitions for IDE autocomplete
+  - All 61 rule names available as TypeScript literal types
+
+### Enhanced
+
+- `variable-naming-convention` - Enforce camelCase for all variables including constants
+- `function-object-destructure` - Add auto-fix for arrow expression body callbacks
+- `simple-call-single-line` - Extend to collapse callbacks with params, handle optional chaining
+- `function-naming-convention` - Add auto-fix for missing Handler suffix
+- `absolute-imports-only` - Allow relative imports in entry files (main.tsx/main.ts), add pages folder
+
+### Fixed
+
+- Remove space before `?.` when collapsing simple calls to single line
+- Sync eslint configs and add `@stylistic/semi-style` rule
+
+### Documentation
+
+- Reorganized AGENTS.md and CLAUDE.md for better AI agent compatibility
+- Added git workflow and versioning guidelines
+- Updated requirements: Node.js 20+, TypeScript 5+, Tailwind CSS 4+
+
+### Stats
+
+- Total Rules: 61 (was 56)
+- All rules are auto-fixable with `eslint --fix`
+
+**Full Changelog:** https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.2.1...v1.3.0
+
+---
+
+## [1.2.0] - 2025-01-25
+
+**Release Title:** React Code Order & TypeScript Enhancement Rules
+
+**Version Range:** v1.1.10 → v1.2.0
+
+### Added
+
+- **New Rules (5)**
+  - `component-props-destructure` - Enforce props destructuring in React components
+  - `component-props-inline-type` - Enforce inline type annotations for component props
+  - `function-object-destructure` - Enforce typed params with body destructuring for non-component functions
+  - `react-code-order` - Enforce consistent ordering of hooks and code blocks in components/hooks
+  - `type-annotation-spacing` - Enforce proper spacing in TypeScript type annotations
+
+### React Code Order (15 Categories)
+
+The `react-code-order` rule enforces a logical dependency chain:
+
+1. Props destructure (parameter level)
+2. Props destructure in body
+3. `useRef`
+4. `useState`
+5. `useReducer`
+6. Redux hooks
+7. Router hooks
+8. Context hooks
+9. Custom hooks
+10. Derived state
+11. `useMemo`
+12. `useCallback`
+13. Handlers
+14. `useEffect`
+15. Return statement
+
+### TypeScript Improvements
+
+- `type-annotation-spacing` - No space before colon/generic/array brackets, one space after colon
+- Better support for inline type literals in component props
+
+### Stats
+
+- Total Rules: 56 (was 51)
+- All rules are auto-fixable with `eslint --fix`
+
+**Full Changelog:** https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.1.10...v1.2.0
+
+---
+
+## [1.1.0] - 2025-01-19
+
+**Release Title:** TypeScript + Tailwind Support & Configurable Rules
+
+**Version Range:** v1.0.17 → v1.1.0
+
+### Added
+
+- **New Configuration: React + TypeScript + Tailwind**
+  - `react-ts-tw` - Recommended ESLint config for TS + Tailwind projects (`recommended-configs/react-ts-tw/`)
+  - Includes TypeScript parser, TypeScript ESLint plugin, and Tailwind CSS plugin
+  - Perfectionist rules for sorting interfaces, enums, and object types
+  - Full documentation with installation instructions
+
+- **New Rule**
+  - `index-export-style` - Enforce consistent export formatting in index files (shorthand vs import-export style)
+
+- **Configurable Rules**
+  - `array-items-per-line` - Added `maxItems` option (default: 3)
+  - `hook-deps-per-line` - Added `maxDeps` option (default: 2)
+  - `multiline-if-conditions` - Added `maxOperands` option (default: 3)
+  - `function-arguments-format` - New rule merging `multiline-argument-newline` and `multiple-arguments-per-line`
+
+- **Documentation**
+  - Added `AGENTS.md` for AI coding agents (Claude Code, Cursor, etc.)
+  - Added React test application for validating plugin rules
+  - Migration guide to `@stylistic/eslint-plugin` for deprecated formatting rules
+
+### Changed
+
+- **Self-Sufficient Rules**
+  - `export-format` and `import-format` now handle all formatting independently
+  - `object-property-per-line` now handles all object formatting independently
+
+- **TypeScript Support**
+  - `module-index-exports` rule now recognizes `index.ts` and `index.tsx` files
+  - Added TypeScript test file patterns (`*.test.ts`, `*.spec.ts`, etc.) to ignore list
+
+### Fixed
+
+- `object-property-per-line` - Fixed handling of multi-line template literals and spread elements
+- `jsx-ternary-format` - Fixed handling of return statements and broken conditions
+- `comment-spacing` - Renamed to `comment-format` to better reflect functionality
+- Fixed rule count sync between README and index.d.ts
+
+### Stats
+
+- Total Rules: 51 (was 48)
+- All changes are backward compatible
+- All rules are auto-fixable with `eslint --fix`
+
+**Full Changelog:** https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.0.17...v1.1.0
+
+---
+
+## [1.0.16] - 2025-01-11
+
+**Release Title:** New Rule: index-export-style
+
+**Version Range:** v1.0.15 → v1.0.16
+
+### Added
+
+- **New Rule**
+  - `index-export-style` - Enforce consistent export patterns in index files with shorthand or import-export styles
+
+### Changed
+
+- Added index file overrides to prevent conflicts with other formatting rules
+
+### Stats
+
+- Total Rules: 48 (was 47)
+- All rules are auto-fixable with `eslint --fix`
+
+**Full Changelog:** https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.0.15...v1.0.16
+
+---
+
+## [1.0.14] - 2025-01-06
+
+**Release Title:** Customizable Rules, Recommended Configs & Documentation Overhaul
+
+**Version Range:** v1.0.8 → v1.0.14
+
+### Added
+
+- **Customizable Folder Options**
+  - `absolute-imports-only` - Added `extraAllowedFolders` and `extraDeepImportFolders` options
+  - `module-index-exports` - Added `extraModuleFolders`, `extraLazyLoadFolders`, and `extraIgnorePatterns` options
+
+- **Recommended ESLint Configurations**
+  - Added `recommended-configs/react/` folder with battle-tested ESLint flat config
+  - Includes comprehensive setup with 9 third-party plugins + all 47 code-style rules
+  - Complete documentation with installation commands and plugin explanations
+
+- **Documentation**
+  - Comprehensive README rewrite with examples for all 47 rules
+  - Rules Summary table with descriptions for quick reference
+  - "Why This Plugin?" section explaining the unique value proposition
+  - Block comments added to all rules in source code with Good/Bad examples
+  - Emojis added to all major section titles for better visual hierarchy
+
+### Changed
+
+- **Internal Refactoring**
+  - Standardized all internal helper function names with `Handler` suffix
+  - Ensures codebase follows the same conventions enforced by the plugin
+  - Made plugin version and name dynamic (reads from package.json)
+
+### Fixed
+
+- Fixed rule naming: `singleArgumentOneLine` → `singleArgumentOnOneLine`
+- Removed orphaned/duplicate block comments
+
+### Stats
+
+- Total Rules: 47
+- All rules are auto-fixable with `eslint --fix`
+
+**Full Changelog:** https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.0.8...v1.0.14
+
+---
+
+## [1.0.7] - 2025-01-06
+
+**Release Title:** TypeScript Type Definitions for IDE Support
+
+**Version Range:** v1.0.6 → v1.0.7
+
+### Added
+
+- **TypeScript Support**
+  - `index.d.ts` with comprehensive type definitions
+  - IDE autocomplete and IntelliSense support
+  - Module augmentation for ESLint's configuration types
+
+### Stats
+
+- Total Rules: 47
+- All rules are auto-fixable with `eslint --fix`
+
+**Full Changelog:** https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.0.6...v1.0.7
+
+---
+
+## [1.0.6] - 2025-01-06
+
+**Release Title:** Initial Public Release
+
+**Version Range:** First Release
+
+### Added
+
+- **Initial Release**
+  - 45+ auto-fixable ESLint rules for React/JSX projects
+  - Full support for ESLint v9+ flat config
+  - Zero dependencies
+
+### Requirements
+
+- ESLint >= 9.0.0
+- Node.js >= 20.0.0
+
+### Stats
+
+- Total Rules: 45+
+- All rules are auto-fixable with `eslint --fix`

package/README.md

@@ -19,7 +19,7 @@
 
 **A powerful ESLint plugin for enforcing consistent code formatting and style rules in React/JSX projects.**
 
-*61 auto-fixable rules to keep your codebase clean and consistent*
+*64 auto-fixable rules to keep your codebase clean and consistent*
 
 </div>
 
@@ -27,7 +27,7 @@
 
 ## 🎯 Why This Plugin?
 
-This plugin provides **61 custom auto-fixable rules** for code formatting. Built for **ESLint v9 flat configs**.
+This plugin provides **64 custom auto-fixable rules** for code formatting. Built for **ESLint v9 flat configs**.
 
 > **Note:** ESLint [deprecated 79 formatting rules](https://eslint.org/blog/2023/10/deprecating-formatting-rules/) in v8.53.0. Our recommended configs use `@stylistic/eslint-plugin` as the replacement for these deprecated rules.
 
@@ -36,7 +36,7 @@ This plugin provides **61 custom auto-fixable rules** for code formatting. Built
 - **Works alongside existing tools** — Complements ESLint's built-in rules and packages like eslint-plugin-react, eslint-plugin-import, etc
 - **Self-sufficient rules** — Each rule handles complete formatting independently
 - **Consistency at scale** — Reduces code-style differences between team members by enforcing uniform formatting across your projects
-- **Fully automated** — All 61 rules support auto-fix, eliminating manual style reviews
+- **Highly automated** — 58 of 64 rules support auto-fix with `eslint --fix`
 
 When combined with ESLint's native rules and other popular plugins, this package helps create a complete code style solution that keeps your codebase clean and consistent.
 
@@ -60,7 +60,7 @@ We provide **ready-to-use ESLint flat configuration files** that combine `eslint
 
 ### 💡 Why Use These Configs?
 
-- **Complete Coverage** — Combines ESLint built-in rules, third-party plugins, and all 61 code-style rules
+- **Complete Coverage** — Combines ESLint built-in rules, third-party plugins, and all 64 code-style rules
 - **Ready-to-Use** — Copy the config file and start linting immediately
 - **Battle-Tested** — These configurations have been refined through real-world usage
 - **Fully Documented** — Each config includes detailed instructions and explanations
@@ -97,7 +97,7 @@ We provide **ready-to-use ESLint flat configuration files** that combine `eslint
 <td width="50%">
 
 ### 🔧 Auto-Fixable Rules
-All **61 rules** support automatic fixing with `eslint --fix`. No manual code changes needed.
+**58 rules** support automatic fixing with `eslint --fix`. 6 rules are report-only (require manual changes).
 
 </td>
 <td width="50%">
@@ -250,88 +250,91 @@ rules: {
 
 ## 📖 Rules Categories
 
-> All **61 rules** are auto-fixable. See detailed examples for each rule in the [Rules Reference](#-rules-reference) section below.
+> **64 rules total** — 58 with auto-fix 🔧, 6 report-only. See detailed examples in [Rules Reference](#-rules-reference) below.
 >
-> Rules marked with ⚙️ support customization options (e.g., extending default folder lists).
+> **Legend:** 🔧 Auto-fixable with `eslint --fix` • ⚙️ Customizable options
 
 | Rule | Description |
 |------|-------------|
 | **Array Rules** | |
-| `array-items-per-line` | Collapse arrays ≤ threshold to one line; expand larger arrays with each item on own line (default: ≤3) ⚙️ |
-| `array-objects-on-new-lines` | Each object in an array starts on its own line for better visual scanning |
+| `array-items-per-line` | Collapse arrays ≤ threshold to one line; expand larger arrays with each item on own line (default: ≤3) 🔧 ⚙️ |
+| `array-objects-on-new-lines` | Each object in an array starts on its own line for better visual scanning 🔧 |
 | **Arrow Function Rules** | |
-| `arrow-function-block-body` | Wrap multiline arrow function expressions in parentheses for clear boundaries |
-| `arrow-function-simple-jsx` | Collapse arrow functions returning simple single-element JSX to one line, remove unnecessary parens |
-| `arrow-function-simplify` | Convert block body with single return to implicit return: `() => { return x; }` → `() => x` |
-| `curried-arrow-same-line` | Curried arrow functions start on same line as `=>`, not on new line |
+| `arrow-function-block-body` | Wrap multiline arrow function expressions in parentheses for clear boundaries 🔧 |
+| `arrow-function-simple-jsx` | Collapse arrow functions returning simple single-element JSX to one line, remove unnecessary parens 🔧 |
+| `arrow-function-simplify` | Convert block body with single return to implicit return: `() => { return x; }` → `() => x` 🔧 |
+| `curried-arrow-same-line` | Curried arrow functions start on same line as `=>`, not on new line 🔧 |
 | **Call Expression Rules** | |
-| `function-arguments-format` | Args ≥ threshold or multiline: first arg on new line, each on own line, closing `)` on new line (default: ≥2) ⚙️ |
-| `nested-call-closing-brackets` | Chain closing brackets on same line: `}));` not scattered across lines |
-| `no-empty-lines-in-function-calls` | No empty lines between arguments or after `(`/before `)` |
-| `opening-brackets-same-line` | Opening `{`, `[`, or `(` on same line as function call, not on new line |
-| `simple-call-single-line` | Collapse simple arrow function calls to single line (including callbacks with params and optional chaining) |
-| `single-argument-on-one-line` | Single simple argument stays on one line: `fn(x)` not expanded |
+| `function-arguments-format` | Args ≥ threshold or multiline: first arg on new line, each on own line, closing `)` on new line (default: ≥2) 🔧 ⚙️ |
+| `nested-call-closing-brackets` | Chain closing brackets on same line: `}));` not scattered across lines 🔧 |
+| `no-empty-lines-in-function-calls` | No empty lines between arguments or after `(`/before `)` 🔧 |
+| `opening-brackets-same-line` | Opening `{`, `[`, or `(` on same line as function call, not on new line 🔧 |
+| `simple-call-single-line` | Collapse simple arrow function calls to single line (including callbacks with params and optional chaining) 🔧 |
+| `single-argument-on-one-line` | Single simple argument stays on one line: `fn(x)` not expanded 🔧 |
 | **Comment Rules** | |
-| `comment-format` | Space after `//`, space inside `/* */`, convert single-line blocks to `//`, no blank lines between file-top comments |
+| `comment-format` | Space after `//`, space inside `/* */`, convert single-line blocks to `//`, no blank lines between file-top comments 🔧 |
 | **Component Rules** | |
-| `component-props-destructure` | Component props must be destructured `({ prop })` not received as `(props)` |
-| `component-props-inline-type` | Inline type annotation `} : {` with matching props, proper spacing, commas, no interface reference |
+| `component-props-destructure` | Component props must be destructured `({ prop })` not received as `(props)` 🔧 |
+| `component-props-inline-type` | Inline type annotation `} : {` with matching props, proper spacing, commas, no interface reference 🔧 |
 | **Control Flow Rules** | |
-| `block-statement-newlines` | Newline after `{` and before `}` in if/for/while/function blocks |
-| `if-statement-format` | `{` on same line as `if`/`else if`, `else` on same line as `}`, proper spacing |
-| `multiline-if-conditions` | Conditions exceeding threshold get one operand per line with proper indentation (default: >3) ⚙️ |
-| `no-empty-lines-in-switch-cases` | No empty line after `case X:` before code, no empty lines between cases |
+| `block-statement-newlines` | Newline after `{` and before `}` in if/for/while/function blocks 🔧 |
+| `if-statement-format` | `{` on same line as `if`/`else if`, `else` on same line as `}`, proper spacing 🔧 |
+| `multiline-if-conditions` | Conditions exceeding threshold get one operand per line with proper indentation (default: >3) 🔧 ⚙️ |
+| `no-empty-lines-in-switch-cases` | No empty line after `case X:` before code, no empty lines between cases 🔧 |
+| `ternary-condition-multiline` | Ternary conditions exceeding threshold get one operand per line (default: >3) 🔧 ⚙️ |
 | **Function Rules** | |
-| `function-call-spacing` | No space between function name and `(`: `fn()` not `fn ()` |
-| `function-declaration-style` | Auto-fix for `func-style`: converts function declarations to arrow expressions |
-| `function-naming-convention` | Functions use camelCase, start with verb (get/set/handle/is/has), handlers end with Handler |
-| `function-object-destructure` | Non-component functions: use typed params (not destructured), destructure in body; report dot notation access |
-| `function-params-per-line` | When multiline, each param on own line with consistent indentation |
-| `no-empty-lines-in-function-params` | No empty lines between parameters or after `(`/before `)` |
+| `function-call-spacing` | No space between function name and `(`: `fn()` not `fn ()` 🔧 |
+| `function-declaration-style` | Auto-fix for `func-style`: converts function declarations to arrow expressions 🔧 |
+| `function-naming-convention` | Functions use camelCase, start with verb (get/set/handle/is/has), handlers end with Handler 🔧 |
+| `function-object-destructure` | Non-component functions: use typed params (not destructured), destructure in body; report dot notation access 🔧 |
+| `function-params-per-line` | When multiline, each param on own line with consistent indentation 🔧 |
+| `no-empty-lines-in-function-params` | No empty lines between parameters or after `(`/before `)` 🔧 |
 | **Hook Rules** | |
-| `hook-callback-format` | React hooks: callback on new line, deps array on separate line, proper indentation |
-| `hook-deps-per-line` | Collapse deps ≤ threshold to one line; expand larger arrays with each dep on own line (default: >2) ⚙️ |
+| `hook-callback-format` | React hooks: callback on new line, deps array on separate line, proper indentation 🔧 |
+| `hook-deps-per-line` | Collapse deps ≤ threshold to one line; expand larger arrays with each dep on own line (default: >2) 🔧 ⚙️ |
 | **Import/Export Rules** | |
 | `absolute-imports-only` | Use alias imports from index files only (not deep paths), no relative imports (default: `@/`) ⚙️ |
-| `export-format` | `export {` on same line; collapse ≤ threshold to one line; expand larger with each specifier on own line (default: ≤3) ⚙️ |
-| `import-format` | `import {` and `} from` on same line; collapse ≤ threshold; expand larger with each specifier on own line (default: ≤3) ⚙️ |
-| `import-source-spacing` | No leading/trailing spaces inside import path quotes |
-| `index-export-style` | Index files: no blank lines, enforce shorthand or import-export style; Regular files: require blank lines between exports (default: shorthand) ⚙️ |
+| `export-format` | `export {` on same line; collapse ≤ threshold to one line; expand larger with each specifier on own line (default: ≤3) 🔧 ⚙️ |
+| `import-format` | `import {` and `} from` on same line; collapse ≤ threshold; expand larger with each specifier on own line (default: ≤3) 🔧 ⚙️ |
+| `import-source-spacing` | No leading/trailing spaces inside import path quotes 🔧 |
+| `index-export-style` | Index files: no blank lines, enforce shorthand or import-export style; Regular files: require blank lines between exports (default: shorthand) 🔧 ⚙️ |
+| `index-exports-only` | Index files should only contain imports and exports, not type/interface definitions |
 | `module-index-exports` | Index files must export all folder contents (files and subfolders) ⚙️ |
 | **JSX Rules** | |
-| `classname-dynamic-at-end` | Dynamic expressions (`${className}`) must be at the end of class strings (JSX and variables) |
-| `classname-multiline` | Long className strings broken into multiple lines; smart detection for objects/returns with Tailwind values ⚙️ |
-| `classname-no-extra-spaces` | No extra/leading/trailing spaces in class strings; smart detection for objects/returns with Tailwind values |
-| `classname-order` | Tailwind class ordering in variables/objects/returns; smart detection for Tailwind values |
-| `jsx-children-on-new-line` | Multiple JSX children: each on own line with proper indentation |
-| `jsx-closing-bracket-spacing` | No space before `>` or `/>` in JSX tags |
-| `jsx-element-child-new-line` | Nested JSX elements on new lines; text/expression children can stay inline |
-| `jsx-logical-expression-simplify` | Remove unnecessary parens around conditions and JSX in logical expressions |
-| `jsx-parentheses-position` | Opening `(` for multiline JSX on same line as `return`/`=>`, not on new line |
+| `classname-dynamic-at-end` | Dynamic expressions (`${className}`) must be at the end of class strings (JSX and variables) 🔧 |
+| `classname-multiline` | Long className strings broken into multiple lines; smart detection for objects/returns with Tailwind values 🔧 ⚙️ |
+| `classname-no-extra-spaces` | No extra/leading/trailing spaces in class strings; smart detection for objects/returns with Tailwind values 🔧 |
+| `classname-order` | Tailwind class ordering in variables/objects/returns; smart detection for Tailwind values 🔧 |
+| `jsx-children-on-new-line` | Multiple JSX children: each on own line with proper indentation 🔧 |
+| `jsx-closing-bracket-spacing` | No space before `>` or `/>` in JSX tags 🔧 |
+| `jsx-element-child-new-line` | Nested JSX elements on new lines; text/expression children can stay inline 🔧 |
+| `jsx-logical-expression-simplify` | Remove unnecessary parens around conditions and JSX in logical expressions 🔧 |
+| `jsx-parentheses-position` | Opening `(` for multiline JSX on same line as `return`/`=>`, not on new line 🔧 |
 | `jsx-prop-naming-convention` | Props: camelCase for regular, kebab-case for data-*/aria-*, PascalCase for component refs |
-| `jsx-simple-element-one-line` | Collapse simple JSX with single text/expression child to one line |
-| `jsx-string-value-trim` | No leading/trailing whitespace inside JSX string attribute values |
-| `jsx-ternary-format` | Simple ternaries on one line; complex branches get parens with proper indentation |
-| `no-empty-lines-in-jsx` | No empty lines between children or after opening/before closing tags |
+| `jsx-simple-element-one-line` | Collapse simple JSX with single text/expression child to one line 🔧 |
+| `jsx-string-value-trim` | No leading/trailing whitespace inside JSX string attribute values 🔧 |
+| `jsx-ternary-format` | Simple ternaries on one line; complex branches get parens with proper indentation 🔧 |
+| `no-empty-lines-in-jsx` | No empty lines between children or after opening/before closing tags 🔧 |
 | **Object Rules** | |
-| `no-empty-lines-in-objects` | No empty lines between properties or after `{`/before `}` |
-| `object-property-per-line` | Collapse ≤ threshold to one line; expand larger with `{`/`}` on own lines and each property on own line (default: ≥2) ⚙️ |
-| `object-property-value-brace` | Opening `{` of object value on same line as `:`, not on new line |
-| `object-property-value-format` | Simple property values on same line as `:`, not on new line |
-| `string-property-spacing` | No leading/trailing spaces inside string property keys |
+| `no-empty-lines-in-objects` | No empty lines between properties or after `{`/before `}` 🔧 |
+| `object-property-per-line` | Collapse ≤ threshold to one line; expand larger with `{`/`}` on own lines and each property on own line (default: ≥2) 🔧 ⚙️ |
+| `object-property-value-brace` | Opening `{` of object value on same line as `:`, not on new line 🔧 |
+| `object-property-value-format` | Simple property values on same line as `:`, not on new line 🔧 |
+| `string-property-spacing` | No leading/trailing spaces inside string property keys 🔧 |
 | **Spacing Rules** | |
-| `assignment-value-same-line` | Assignment values start on same line as `=`, not on new line |
-| `member-expression-bracket-spacing` | No spaces inside brackets in computed member expressions: `arr[0]` not `arr[ 0 ]` |
+| `assignment-value-same-line` | Assignment values start on same line as `=`, not on new line 🔧 |
+| `member-expression-bracket-spacing` | No spaces inside brackets in computed member expressions: `arr[0]` not `arr[ 0 ]` 🔧 |
 | **TypeScript Rules** | |
-| `enum-format` | Enforce enum naming (PascalCase + Enum suffix), UPPER_CASE members, no empty lines, and trailing commas |
-| `interface-format` | Enforce interface naming (PascalCase + Interface suffix), camelCase properties, no empty lines, and trailing commas |
-| `type-annotation-spacing` | Enforce consistent spacing in type annotations: no space before colon/generic/array brackets, one space after colon |
-| `type-format` | Enforce type naming (PascalCase + Type suffix), camelCase properties, no empty lines, and trailing commas |
+| `enum-format` | Enforce enum naming (PascalCase + Enum suffix), UPPER_CASE members, no empty lines, and trailing commas 🔧 |
+| `interface-format` | Enforce interface naming (PascalCase + Interface suffix), camelCase properties, no empty lines, and trailing commas 🔧 |
+| `no-inline-type-definitions` | Inline union types in function params should be extracted to named types ⚙️ |
+| `type-annotation-spacing` | Enforce consistent spacing in type annotations: no space before colon/generic/array brackets, one space after colon 🔧 |
+| `type-format` | Enforce type naming (PascalCase + Type suffix), camelCase properties, no empty lines, and trailing commas 🔧 |
 | `typescript-definition-location` | Enforce TypeScript definitions (interfaces, types, enums) to be in designated folders ⚙️ |
 | **React Rules** | |
-| `react-code-order` | Enforce consistent ordering in components and hooks: props destructure → refs → state → redux → router → context → custom hooks → derived → memo → callback → handlers → effects → return |
+| `react-code-order` | Enforce consistent ordering in components and hooks: props destructure → refs → state → redux → router → context → custom hooks → derived → memo → callback → handlers → effects → return 🔧 |
 | **Variable Rules** | |
-| `variable-naming-convention` | camelCase for all variables and constants, PascalCase for components, `use` prefix for hooks |
+| `variable-naming-convention` | camelCase for all variables and constants, PascalCase for components, `use` prefix for hooks 🔧 |
 
 <br />
 
@@ -339,7 +342,7 @@ rules: {
 
 ## 📖 Rules Reference
 
-> All rules are **auto-fixable** using `eslint --fix`
+> Rules marked with 🔧 are **auto-fixable** using `eslint --fix`
 
 <br />
 

package/index.d.ts

@@ -30,6 +30,7 @@ export type RuleNames =
     | "code-style/import-format"
     | "code-style/import-source-spacing"
     | "code-style/index-export-style"
+    | "code-style/index-exports-only"
     | "code-style/classname-dynamic-at-end"
     | "code-style/classname-multiline"
     | "code-style/classname-no-extra-spaces"
@@ -47,6 +48,7 @@ export type RuleNames =
     | "code-style/module-index-exports"
     | "code-style/multiline-if-conditions"
     | "code-style/nested-call-closing-brackets"
+    | "code-style/no-inline-type-definitions"
     | "code-style/no-empty-lines-in-function-calls"
     | "code-style/no-empty-lines-in-function-params"
     | "code-style/no-empty-lines-in-jsx"
@@ -59,8 +61,10 @@ export type RuleNames =
     | "code-style/simple-call-single-line"
     | "code-style/single-argument-on-one-line"
     | "code-style/string-property-spacing"
+    | "code-style/ternary-condition-multiline"
     | "code-style/enum-format"
     | "code-style/interface-format"
+    | "code-style/type-annotation-spacing"
     | "code-style/type-format"
     | "code-style/typescript-definition-location"
     | "code-style/variable-naming-convention";
@@ -112,6 +116,7 @@ interface PluginRules {
     "import-format": Rule.RuleModule;
     "import-source-spacing": Rule.RuleModule;
     "index-export-style": Rule.RuleModule;
+    "index-exports-only": Rule.RuleModule;
     "classname-dynamic-at-end": Rule.RuleModule;
     "classname-multiline": Rule.RuleModule;
     "classname-no-extra-spaces": Rule.RuleModule;
@@ -129,6 +134,7 @@ interface PluginRules {
     "module-index-exports": Rule.RuleModule;
     "multiline-if-conditions": Rule.RuleModule;
     "nested-call-closing-brackets": Rule.RuleModule;
+    "no-inline-type-definitions": Rule.RuleModule;
     "no-empty-lines-in-function-calls": Rule.RuleModule;
     "no-empty-lines-in-function-params": Rule.RuleModule;
     "no-empty-lines-in-jsx": Rule.RuleModule;
@@ -141,8 +147,10 @@ interface PluginRules {
     "simple-call-single-line": Rule.RuleModule;
     "single-argument-on-one-line": Rule.RuleModule;
     "string-property-spacing": Rule.RuleModule;
+    "ternary-condition-multiline": Rule.RuleModule;
     "enum-format": Rule.RuleModule;
     "interface-format": Rule.RuleModule;
+    "type-annotation-spacing": Rule.RuleModule;
     "type-format": Rule.RuleModule;
     "typescript-definition-location": Rule.RuleModule;
     "variable-naming-convention": Rule.RuleModule;