eslint-plugin-code-style 1.11.7 → 1.14.0

package/CHANGELOG.md

@@ -7,6 +7,122 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.14.0] - 2026-02-05
+
+**New Rule: useState Naming Convention**
+
+**Version Range:** v1.13.0 → v1.14.0
+
+### Added
+
+**New Rules (1)**
+- `use-state-naming-convention` - Enforce boolean useState variables to start with valid prefixes 🔧
+  - Boolean state must start with: `is`, `has`, `with`, `without` (configurable)
+  - Auto-fixes both state variable and setter function names, plus all usages
+  - Detects boolean literals (`useState(false)`) and type annotations (`useState<boolean>()`)
+  - Options: `booleanPrefixes`, `extendBooleanPrefixes`, `allowPastVerbBoolean`, `allowContinuousVerbBoolean`
+
+### Enhanced
+
+- **`folder-component-suffix`** - Add auto-fix to rename component and all references in the file
+- **`function-naming-convention`** - Detect useCallback-wrapped functions in custom hooks
+- **`prop-naming-convention`** - Auto-fix now renames both type annotation AND destructured parameter with all usages
+
+### Stats
+
+- Total Rules: 76 (was 75)
+- Auto-fixable: 67 rules 🔧
+- Configurable: 17 rules ⚙️
+- Report-only: 9 rules
+
+**Full Changelog:** [v1.13.0...v1.14.0](https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.13.0...v1.14.0)
+
+---
+
+## [1.13.0] - 2026-02-05
+
+**New Rule: Prop Naming Convention & Auto-Fix Enhancements**
+
+**Version Range:** v1.12.1 → v1.13.0
+
+### Added
+
+**New Rules (1)**
+- `prop-naming-convention` - Enforce naming conventions for boolean and callback props 🔧
+  - Boolean props must start with: `is`, `has`, `with`, `without` (configurable)
+  - Callback props must start with: `on` (configurable)
+  - Detects React event handler types (`MouseEventHandler`, `ChangeEventHandler`, `FormEventHandler`, etc.)
+  - Supports nested types at any depth
+  - Applies to interfaces, type aliases, and inline types (NOT JSX attributes)
+  - Options: `booleanPrefixes`, `extendBooleanPrefixes`, `allowPastVerbBoolean`, `allowContinuousVerbBoolean`, `callbackPrefix`, `allowActionSuffix`
+
+### Enhanced
+
+- **`enum-format`** - Add auto-fix for member names (convert to UPPER_SNAKE_CASE)
+- **`interface-format`** - Add auto-fix for property names (convert to camelCase); collapse single-member nested object types to one line
+- **`type-format`** - Add auto-fix for property names (convert to camelCase); collapse single-member nested object types to one line; union type formatting with configurable threshold (`minUnionMembersForMultiline` option, default 5)
+
+### Stats
+
+- Total Rules: 75 (was 74)
+- Auto-fixable: 66 rules 🔧
+- Configurable: 17 rules ⚙️
+- Report-only: 9 rules
+
+**Full Changelog:** [v1.12.1...v1.13.0](https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.12.1...v1.13.0)
+
+---
+
+## [1.12.1] - 2026-02-04
+
+### Fixed
+
+- **`function-object-destructure`** - Skip when param is used in spread operations, exclude object property keys from reference counting
+- **`no-empty-lines-in-function-params`** - Only check parens within function's own range (fix for `.map(config => ...)` false positives)
+- **`jsx-children-on-new-line`** - Remove blank line check after opening tag (handled by `no-empty-lines-in-jsx` rule)
+
+---
+
+## [1.12.0] - 2026-02-04
+
+**New Rule: Folder Component Suffix**
+
+**Version Range:** v1.11.1 → v1.12.0
+
+### Added
+
+**New Rules (1)**
+- `folder-component-suffix` - Enforce naming conventions based on folder location:
+  - Components in `views/` folder must end with `View` suffix
+  - Components in `pages/` folder must end with `Page` suffix
+
+### Stats
+
+- Total Rules: 74 (was 73)
+- Auto-fixable: 65 rules 🔧
+- Report-only: 9 rules
+
+**Full Changelog:** [v1.11.1...v1.12.0](https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.11.1...v1.12.0)
+
+---
+
+## [1.11.9] - 2026-02-04
+
+### Fixed
+
+- **`variable-naming-convention`** - Enforce camelCase for object property keys (no longer allows SCREAMING_SNAKE_CASE like `APP_NAME`)
+- **`variable-naming-convention`** - Add auto-fix to convert property names to camelCase (e.g., `APP_NAME` → `appName`)
+
+---
+
+## [1.11.8] - 2026-02-04
+
+### Fixed
+
+- **`comment-format`** - Allow `/* */` syntax for ESLint directive comments (`/* eslint-disable ... */`, `/* eslint-enable ... */`, etc.) since these must use block comment syntax
+
+---
+
 ## [1.11.7] - 2026-02-04
 
 ### Changed
@@ -1538,6 +1654,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+[1.14.0]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.13.0...v1.14.0
+[1.13.0]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.12.1...v1.13.0
+[1.12.1]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.12.0...v1.12.1
+[1.12.0]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.11.9...v1.12.0
+[1.11.9]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.11.8...v1.11.9
+[1.11.8]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.11.7...v1.11.8
 [1.11.7]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.11.6...v1.11.7
 [1.11.6]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.11.5...v1.11.6
 [1.11.5]: https://github.com/Mohamed-Elhawary/eslint-plugin-code-style/compare/v1.11.4...v1.11.5

package/README.md

@@ -19,7 +19,7 @@
 
 **A powerful ESLint plugin for enforcing consistent code formatting and style rules in React/JSX projects.**
 
-*73 rules (65 auto-fixable) to keep your codebase clean and consistent*
+*76 rules (67 auto-fixable, 17 configurable) to keep your codebase clean and consistent*
 
 </div>
 
@@ -27,7 +27,7 @@
 
 ## 🎯 Why This Plugin?
 
-This plugin provides **73 custom rules** (65 auto-fixable) for code formatting. Built for **ESLint v9 flat configs**.
+This plugin provides **75 custom rules** (66 auto-fixable, 17 configurable) 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 **73 custom rules** (65 auto-fixable) for code formatting.
 - **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
-- **Highly automated** — 65 of 73 rules support auto-fix with `eslint --fix`
+- **Highly automated** — 67 of 76 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.
 
@@ -97,7 +97,7 @@ We provide **ready-to-use ESLint flat configuration files** that combine `eslint
 <td width="50%">
 
 ### 🔧 Auto-Fixable Rules
-**65 rules** support automatic fixing with `eslint --fix`. 6 rules are report-only (require manual changes).
+**67 rules** support automatic fixing with `eslint --fix`. **17 rules** have configurable options. 9 rules are report-only (require manual changes).
 
 </td>
 <td width="50%">
@@ -205,6 +205,7 @@ rules: {
     "code-style/enum-format": "error",
     "code-style/enum-type-enforcement": "error",
     "code-style/export-format": "error",
+    "code-style/folder-component-suffix": "error",
     "code-style/function-arguments-format": "error",
     "code-style/function-call-spacing": "error",
     "code-style/function-declaration-style": "error",
@@ -213,6 +214,7 @@ rules: {
     "code-style/function-params-per-line": "error",
     "code-style/hook-callback-format": "error",
     "code-style/hook-deps-per-line": "error",
+    "code-style/use-state-naming-convention": "error",
     "code-style/if-else-spacing": "error",
     "code-style/if-statement-format": "error",
     "code-style/import-format": "error",
@@ -229,6 +231,7 @@ rules: {
     "code-style/jsx-simple-element-one-line": "error",
     "code-style/jsx-string-value-trim": "error",
     "code-style/jsx-ternary-format": "error",
+    "code-style/logical-expression-multiline": "error",
     "code-style/member-expression-bracket-spacing": "error",
     "code-style/module-index-exports": "error",
     "code-style/multiline-if-conditions": "error",
@@ -244,6 +247,7 @@ rules: {
     "code-style/object-property-value-brace": "error",
     "code-style/object-property-value-format": "error",
     "code-style/opening-brackets-same-line": "error",
+    "code-style/prop-naming-convention": "error",
     "code-style/react-code-order": "error",
     "code-style/simple-call-single-line": "error",
     "code-style/single-argument-on-one-line": "error",
@@ -262,7 +266,7 @@ rules: {
 
 ## 📖 Rules Categories
 
-> **73 rules total** — 65 with auto-fix 🔧, 8 report-only. See detailed examples in [Rules Reference](#-rules-reference) below.
+> **76 rules total** — 67 with auto-fix 🔧, 17 configurable ⚙️, 9 report-only. See detailed examples in [Rules Reference](#-rules-reference) below.
 >
 > **Legend:** 🔧 Auto-fixable with `eslint --fix` • ⚙️ Customizable options
 
@@ -289,6 +293,7 @@ rules: {
 | **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 🔧 |
+| `folder-component-suffix` | Components in `views/` folder must end with "View", components in `pages/` folder must end with "Page" |
 | `svg-component-icon-naming` | SVG components must end with "Icon" suffix; "Icon" suffix components must return SVG |
 | **Class Rules** | |
 | `class-method-definition-format` | Consistent spacing in class/method definitions: space before `{`, no space before `(` 🔧 |
@@ -298,6 +303,7 @@ rules: {
 | `empty-line-after-block` | Empty line required between closing `}` of block and next statement 🔧 |
 | `if-else-spacing` | Empty line between consecutive if blocks, no empty line between single-line if/else 🔧 |
 | `if-statement-format` | `{` on same line as `if`/`else if`, `else` on same line as `}`, proper spacing 🔧 |
+| `logical-expression-multiline` | Logical expressions (&&, \|\|) with >maxOperands get one operand per line (default: >3) 🔧 ⚙️ |
 | `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` | ≤maxOperands always single line; >maxOperands multiline (based on operand count, not line length) 🔧 ⚙️ |
@@ -311,6 +317,7 @@ rules: {
 | **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) 🔧 ⚙️ |
+| `use-state-naming-convention` | Boolean useState variables must start with is/has/with/without prefix 🔧 ⚙️ |
 | **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) 🔧 ⚙️ |
@@ -348,8 +355,9 @@ rules: {
 | `enum-type-enforcement` | Enforce using enum values instead of string literals for variables typed with `*Type` (e.g., use `ButtonVariantEnum.PRIMARY` not `"primary"`) 🔧 |
 | `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 ⚙️ |
+| `prop-naming-convention` | Enforce boolean props start with is/has/with/without, callback props start with on 🔧 ⚙️ |
 | `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 🔧 |
+| `type-format` | Enforce type naming (PascalCase + Type suffix), camelCase properties, union type formatting, 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 🔧 |
@@ -1166,6 +1174,45 @@ else
 
 ---
 
+### `logical-expression-multiline`
+
+**What it does:** When a logical expression (`&&`, `||`) has more operands than the threshold (default: 3), each operand goes on its own line with the operator at the start.
+
+**Why use it:** Long logical expressions are hard to read on one line. One operand per line makes each part clear and easy to modify.
+
+```javascript
+// ✅ Good — 3 or fewer operands stay inline
+const isValid = a && b && c;
+const result = x || y;
+
+// ✅ Good — 4+ operands get one per line
+const err = data.error
+    || data.message
+    || data.status
+    || data.fallback;
+
+const isComplete = hasName
+    && hasEmail
+    && hasPhone
+    && hasAddress;
+
+// ❌ Bad — 4+ operands on single line
+const err = data.error || data.message || data.status || data.fallback;
+```
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `maxOperands` | `integer` | `3` | Maximum operands allowed on a single line |
+
+```javascript
+// Configuration example - allow up to 4 operands on single line
+"code-style/logical-expression-multiline": ["error", { maxOperands: 4 }]
+```
+
+---
+
 ### `multiline-if-conditions`
 
 **What it does:** When an if statement has more conditions than the threshold (default: 3), each condition goes on its own line with proper indentation.
@@ -1716,6 +1763,49 @@ useEffect(() => {}, [
 
 <br />
 
+### `use-state-naming-convention`
+
+**What it does:** Enforces boolean useState variables to start with valid prefixes (is, has, with, without).
+
+**Why use it:** Consistent boolean state naming makes code more predictable and self-documenting. When you see `isLoading`, you immediately know it's a boolean state.
+
+```typescript
+// ✅ Good — boolean state with proper prefix
+const [isLoading, setIsLoading] = useState(false);
+const [hasError, setHasError] = useState<boolean>(false);
+const [isAuthenticated, setIsAuthenticated] = useState(true);
+const [withBorder, setWithBorder] = useState(false);
+
+// ❌ Bad — boolean state without prefix
+const [loading, setLoading] = useState(false);
+const [authenticated, setAuthenticated] = useState<boolean>(true);
+const [error, setError] = useState<boolean>(false);
+```
+
+**Customization Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `booleanPrefixes` | `string[]` | `["is", "has", "with", "without"]` | Replace default prefixes entirely |
+| `extendBooleanPrefixes` | `string[]` | `[]` | Add additional prefixes to defaults |
+| `allowPastVerbBoolean` | `boolean` | `false` | Allow past verb names without prefix (disabled, selected) |
+| `allowContinuousVerbBoolean` | `boolean` | `false` | Allow continuous verb names without prefix (loading, saving) |
+
+```javascript
+// Example: Allow "loading" and "disabled" without prefix
+"code-style/use-state-naming-convention": ["error", {
+    allowPastVerbBoolean: true,
+    allowContinuousVerbBoolean: true
+}]
+
+// Example: Add "should" prefix
+"code-style/use-state-naming-convention": ["error", {
+    extendBooleanPrefixes: ["should"]
+}]
+```
+
+<br />
+
 ## 📥 Import/Export Rules
 
 ### `absolute-imports-only`
@@ -2969,6 +3059,30 @@ export const Card = ({ a, b } : { a: string, b: string }) => (
 
 ---
 
+### `folder-component-suffix`
+
+**What it does:** Enforces naming conventions for components based on folder location:
+- Components in `views/` folder must end with "View" suffix
+- Components in `pages/` folder must end with "Page" suffix
+
+**Why use it:** Consistent naming based on folder structure makes component purpose immediately clear. View components and page components have different responsibilities, and the suffix reflects this.
+
+```tsx
+// ✅ Good — in views/dashboard-view.tsx
+export const DashboardView = () => <div>Dashboard</div>;
+
+// ✅ Good — in pages/home-page.tsx
+export const HomePage = () => <div>Home</div>;
+
+// ❌ Bad — in views/dashboard.tsx (missing "View" suffix)
+export const Dashboard = () => <div>Dashboard</div>;
+
+// ❌ Bad — in pages/home.tsx (missing "Page" suffix)
+export const Home = () => <div>Home</div>;
+```
+
+---
+
 ### `svg-component-icon-naming`
 
 **What it does:** Enforces naming conventions for SVG icon components:
@@ -3161,6 +3275,172 @@ export const Button = ({
 
 ---
 
+### `prop-naming-convention`
+
+**What it does:** Enforces naming conventions for boolean and callback props in TypeScript interfaces, types, and inline type definitions:
+- Boolean props must start with: `is`, `has`, `with`, or `without` (followed by capital letter)
+- Callback props must start with: `on` (followed by capital letter)
+- Detects React event handler types: `MouseEventHandler`, `ChangeEventHandler`, `FormEventHandler`, `KeyboardEventHandler`, etc.
+- Applies to all nesting levels (nested object types are checked recursively)
+- Does NOT apply to JSX element attributes (external components have their own props)
+
+**Why use it:** Consistent prop naming makes props self-documenting. Boolean prefixes clarify intent (`isLoading` vs `loading`), and `on` prefix clearly identifies event handlers.
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `booleanPrefixes` | `string[]` | - | Replace default prefixes entirely (overrides defaults) |
+| `extendBooleanPrefixes` | `string[]` | `[]` | Add to default prefixes (`is`, `has`, `with`, `without`) |
+| `allowPastVerbBoolean` | `boolean` | `false` | Allow past verb booleans (e.g., `disabled`, `selected`, `checked`, `opened`) |
+| `allowContinuousVerbBoolean` | `boolean` | `false` | Allow continuous verb booleans (e.g., `loading`, `saving`, `fetching`) |
+| `callbackPrefix` | `string` | `"on"` | Required prefix for callback props |
+| `allowActionSuffix` | `boolean` | `false` | Allow `xxxAction` pattern for callbacks |
+
+```typescript
+// ✅ Good — proper prop naming
+interface ButtonPropsInterface {
+    isDisabled: boolean,
+    isLoading: boolean,
+    hasError: boolean,
+    onClick: () => void,
+    onSubmit: (data: FormData) => void,
+}
+
+type CardPropsType = {
+    isExpanded: boolean,
+    hasChildren: boolean,
+    onToggle: () => void,
+};
+
+// ✅ Good — nested types are also checked
+interface FormPropsInterface {
+    isValid: boolean,
+    config: {
+        isEnabled: boolean,      // Nested - checked
+        onValidate: () => void,  // Nested - checked
+        settings: {
+            isActive: boolean,   // Deep nested - also checked
+        },
+    },
+}
+
+// ✅ Good — inline component props
+const Button = ({
+    isLoading,
+    onClick,
+}: {
+    isLoading: boolean,
+    onClick: () => void,
+}) => { ... };
+
+// ❌ Bad — missing prefixes
+interface ButtonPropsInterface {
+    disabled: boolean,    // Should be isDisabled
+    loading: boolean,     // Should be isLoading
+    error: boolean,       // Should be hasError
+    click: () => void,    // Should be onClick
+    handleSubmit: () => void,  // Should be onSubmit
+}
+
+// ❌ Bad — nested types also checked
+type PropsType = {
+    config: {
+        enabled: boolean,  // Should be isEnabled
+        toggle: () => void, // Should be onToggle
+    },
+};
+```
+
+**Past Verb Booleans** (`allowPastVerbBoolean: true`):
+
+When enabled, allows boolean props that are past tense verbs (ending in `-ed`):
+
+```typescript
+// ✅ Allowed with allowPastVerbBoolean: true
+interface PropsInterface {
+    disabled: boolean,    // Past verb - ends with -ed
+    selected: boolean,    // Past verb - ends with -ed
+    checked: boolean,     // Past verb - ends with -ed
+    opened: boolean,      // Past verb - ends with -ed
+    closed: boolean,      // Past verb - ends with -ed
+    expanded: boolean,    // Past verb - ends with -ed
+    collapsed: boolean,   // Past verb - ends with -ed
+    focused: boolean,     // Past verb - ends with -ed
+    hidden: boolean,      // Past verb - ends with -ed
+    connected: boolean,   // Past verb - ends with -ed
+}
+```
+
+**Continuous Verb Booleans** (`allowContinuousVerbBoolean: true`):
+
+When enabled, allows boolean props that are continuous tense verbs (ending in `-ing`):
+
+```typescript
+// ✅ Allowed with allowContinuousVerbBoolean: true
+interface PropsInterface {
+    loading: boolean,     // Continuous verb - ends with -ing
+    saving: boolean,      // Continuous verb - ends with -ing
+    fetching: boolean,    // Continuous verb - ends with -ing
+    closing: boolean,     // Continuous verb - ends with -ing
+    opening: boolean,     // Continuous verb - ends with -ing
+    submitting: boolean,  // Continuous verb - ends with -ing
+    processing: boolean,  // Continuous verb - ends with -ing
+    updating: boolean,    // Continuous verb - ends with -ing
+    deleting: boolean,    // Continuous verb - ends with -ing
+    pending: boolean,     // Continuous verb - ends with -ing
+}
+```
+
+**Configuration Examples:**
+
+```javascript
+// Default configuration (strict)
+"code-style/prop-naming-convention": "error"
+
+// Allow past verb booleans (disabled, selected, checked, etc.)
+"code-style/prop-naming-convention": ["error", {
+    allowPastVerbBoolean: true,
+}]
+
+// Allow continuous verb booleans (loading, saving, fetching, etc.)
+"code-style/prop-naming-convention": ["error", {
+    allowContinuousVerbBoolean: true,
+}]
+
+// Allow both past and continuous verb booleans
+"code-style/prop-naming-convention": ["error", {
+    allowPastVerbBoolean: true,
+    allowContinuousVerbBoolean: true,
+}]
+
+// Extend default prefixes with additional ones
+"code-style/prop-naming-convention": ["error", {
+    extendBooleanPrefixes: ["should", "can", "will", "did"],
+}]
+
+// Replace default prefixes entirely
+"code-style/prop-naming-convention": ["error", {
+    booleanPrefixes: ["is", "has"],  // Only these prefixes allowed
+}]
+
+// Allow "xxxAction" suffix for callbacks
+"code-style/prop-naming-convention": ["error", {
+    allowActionSuffix: true,  // Allows: submitAction, copyAction, deleteAction
+}]
+
+// Full custom configuration
+"code-style/prop-naming-convention": ["error", {
+    extendBooleanPrefixes: ["should", "can"],
+    allowPastVerbBoolean: true,
+    allowContinuousVerbBoolean: true,
+    callbackPrefix: "on",
+    allowActionSuffix: true,
+}]
+```
+
+---
+
 ### `type-format`
 
 **What it does:** Enforces consistent formatting for TypeScript type aliases:
@@ -3168,6 +3448,8 @@ export const Button = ({
 - Properties must be camelCase
 - No empty lines between properties
 - Properties must end with commas, not semicolons
+- Union types with 5+ members must be multiline (one per line)
+- Union types with <5 members must be single line
 
 **Why use it:** Consistent type naming makes types instantly recognizable. The suffix clearly distinguishes types from interfaces and classes.
 
@@ -3185,6 +3467,26 @@ export type ApiResponseType<T> = {
     status: number,
 };
 
+// ✅ Good — union type with 6 members (multiline)
+export type ButtonVariantType =
+    "danger"
+    | "ghost"
+    | "ghost-danger"
+    | "link"
+    | "muted"
+    | "primary";
+
+// ✅ Good — union type with 2 members (single line)
+export type CodeLayoutVariantType = "default" | "error";
+
+// ❌ Bad — 6 members should be multiline
+export type BadUnionType = "a" | "b" | "c" | "d" | "e" | "f";
+
+// ❌ Bad — 2 members should be single line
+export type BadSingleType =
+    "default"
+    | "error";
+
 // ❌ Bad — wrong naming
 export type User = {           // Missing Type suffix
     Email: string;             // Should be camelCase
@@ -3199,6 +3501,17 @@ export type ConfigType = {
 };
 ```
 
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `minUnionMembersForMultiline` | `integer` | `5` | Minimum number of union members to require multiline format |
+
+```javascript
+// Configuration example - require multiline for 4+ union members
+"code-style/type-format": ["error", { minUnionMembersForMultiline: 4 }]
+```
+
 ---
 
 ### `type-annotation-spacing`
@@ -3581,7 +3894,7 @@ const UseAuth = () => {};          // hooks should be camelCase
 
 ## 🔧 Auto-fixing
 
-65 of 73 rules support auto-fixing. Run ESLint with the `--fix` flag:
+67 of 76 rules support auto-fixing. Run ESLint with the `--fix` flag:
 
 ```bash
 # Fix all files in src directory

package/index.d.ts

@@ -24,6 +24,7 @@ export type RuleNames =
     | "code-style/empty-line-after-block"
     | "code-style/enum-type-enforcement"
     | "code-style/export-format"
+    | "code-style/folder-component-suffix"
     | "code-style/function-arguments-format"
     | "code-style/function-call-spacing"
     | "code-style/function-declaration-style"
@@ -32,6 +33,7 @@ export type RuleNames =
     | "code-style/function-params-per-line"
     | "code-style/hook-callback-format"
     | "code-style/hook-deps-per-line"
+    | "code-style/use-state-naming-convention"
     | "code-style/if-else-spacing"
     | "code-style/if-statement-format"
     | "code-style/import-format"
@@ -67,6 +69,7 @@ export type RuleNames =
     | "code-style/object-property-value-brace"
     | "code-style/object-property-value-format"
     | "code-style/opening-brackets-same-line"
+    | "code-style/prop-naming-convention"
     | "code-style/simple-call-single-line"
     | "code-style/single-argument-on-one-line"
     | "code-style/string-property-spacing"
@@ -119,6 +122,7 @@ interface PluginRules {
     "empty-line-after-block": Rule.RuleModule;
     "enum-type-enforcement": Rule.RuleModule;
     "export-format": Rule.RuleModule;
+    "folder-component-suffix": Rule.RuleModule;
     "function-arguments-format": Rule.RuleModule;
     "function-call-spacing": Rule.RuleModule;
     "function-declaration-style": Rule.RuleModule;
@@ -162,6 +166,7 @@ interface PluginRules {
     "object-property-value-brace": Rule.RuleModule;
     "object-property-value-format": Rule.RuleModule;
     "opening-brackets-same-line": Rule.RuleModule;
+    "prop-naming-convention": Rule.RuleModule;
     "simple-call-single-line": Rule.RuleModule;
     "single-argument-on-one-line": Rule.RuleModule;
     "string-property-spacing": Rule.RuleModule;