@pobammer-ts/eslint-cease-nonsense-rules 1.5.2 → 1.6.0

package/README.md

@@ -36,6 +36,7 @@ export default [
       "cease-nonsense/require-named-effect-functions": "error",
       "cease-nonsense/require-paired-calls": "error",
       "cease-nonsense/require-react-component-keys": "error",
+      "cease-nonsense/no-god-components": "error",
       "cease-nonsense/no-useless-use-spring": "error",
       "cease-nonsense/use-exhaustive-dependencies": "error",
       "cease-nonsense/use-hook-at-top-level": "error",
@@ -114,6 +115,35 @@ Bans React.FC and similar component type annotations. Use explicit function decl
 
 React.FC (Function Component) and related types break debug information in React DevTools, making profiling exponentially harder. They also encourage poor patterns and add unnecessary complexity.
 
+#### `no-god-components`
+
+Flags React components that are too large or doing too much, pushing you toward extracting hooks/components/utilities.
+
+Checks (defaults):
+
+- Component body line count: target `120`, hard max `200`
+- TSX nesting depth ≤ `3`
+- Stateful hooks ≤ `5` (counts `useState`, `useReducer`, `useBinding` by default)
+- Destructured props in parameters ≤ `5`
+- Runtime `null` literals are always banned
+
+**Configuration:**
+
+```typescript
+{
+  "cease-nonsense/no-god-components": ["error", {
+    targetLines: 120,
+    maxLines: 200,
+    maxTsxNesting: 3,
+    maxStateHooks: 5,
+    stateHooks: ["useState", "useReducer", "useBinding"],
+    maxDestructuredProps: 5,
+    enforceTargetLines: true,
+    ignoreComponents: ["LegacyComponent"]
+  }]
+}
+```
+
 **❌ Bad:**
 
 ```typescript

package/dist/build-metadata.json

@@ -1,5 +1,5 @@
 {
-  "commit": "12c06ad5566d08fbf3f48f5203aff7fdc61a801f",
-  "time": "2025-12-11T22:26:23.456Z",
-  "version": "1.5.2"
+  "commit": "cee43b8397ea4513dfaa07a29159dc9559cbca45",
+  "time": "2025-12-19T08:25:21.635Z",
+  "version": "1.6.0"
 }

package/dist/configure-utilities.d.ts

@@ -2,6 +2,7 @@ import type { BanInstancesOptions } from "./rules/ban-instances";
 import type { ComplexityConfiguration } from "./rules/enforce-ianitor-check-type";
 import type { NoInstanceMethodsOptions } from "./rules/no-instance-methods-without-this";
 import type { NoShorthandOptions } from "./rules/no-shorthand-names";
+import type { NoGodComponentsOptions } from "./rules/no-god-components";
 import { type NoUselessUseSpringOptions } from "./rules/no-useless-use-spring";
 import type { EffectFunctionOptions, HookConfiguration } from "./rules/require-named-effect-functions";
 import type { PairConfiguration, RequirePairedCallsOptions } from "./rules/require-paired-calls";
@@ -69,6 +70,12 @@ export declare function createRequirePairedCallsOptions(options?: Partial<Requir
  * @returns The full options
  */
 export declare function createReactKeysOptions(options?: Partial<ReactKeysOptions>): ReactKeysOptions;
+/**
+ * Creates options for no-god-components rule
+ * @param options - Partial configuration options
+ * @returns The full options
+ */
+export declare function createNoGodComponentsOptions(options?: Partial<NoGodComponentsOptions>): NoGodComponentsOptions;
 /**
  * Creates a use-exhaustive-dependencies options for use-exhaustive-dependencies rule
  * @param options - Partial configuration options

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import type { TSESLint } from "@typescript-eslint/utils";
 import type { Rule } from "eslint";
 type AnyRuleModule = Rule.RuleModule | TSESLint.AnyRuleModuleWithMetaDocs;
-export { createBanInstancesOptions, createComplexityConfiguration, createEffectFunctionOptions, createHookConfiguration, createNoInstanceMethodsOptions, createNoUselessUseSpringOptions, createNoShorthandOptions, createPairConfiguration, createReactKeysOptions, createRequirePairedCallsOptions, createUseExhaustiveDependenciesOptions, createUseHookAtTopLevelOptions, defaultRobloxProfilePair, } from "./configure-utilities";
+export { createBanInstancesOptions, createComplexityConfiguration, createEffectFunctionOptions, createHookConfiguration, createNoGodComponentsOptions, createNoInstanceMethodsOptions, createNoUselessUseSpringOptions, createNoShorthandOptions, createPairConfiguration, createReactKeysOptions, createRequirePairedCallsOptions, createUseExhaustiveDependenciesOptions, createUseHookAtTopLevelOptions, defaultRobloxProfilePair, } from "./configure-utilities";
 export type { BanInstancesOptions } from "./rules/ban-instances";
 export type { ComplexityConfiguration } from "./rules/enforce-ianitor-check-type";
 export type { NoInstanceMethodsOptions } from "./rules/no-instance-methods-without-this";
 export type { NoShorthandOptions } from "./rules/no-shorthand-names";
+export type { NoGodComponentsOptions } from "./rules/no-god-components";
 export type { NoUselessUseSpringOptions } from "./rules/no-useless-use-spring";
 export type { EffectFunctionOptions, EnvironmentMode, HookConfiguration } from "./rules/require-named-effect-functions";
 export type { PairConfiguration, RequirePairedCallsOptions } from "./rules/require-paired-calls";
@@ -39,6 +40,7 @@ declare const recommended: {
         readonly "cease-nonsense/no-async-constructor": "error";
         readonly "cease-nonsense/no-color3-constructor": "error";
         readonly "cease-nonsense/no-instance-methods-without-this": "error";
+        readonly "cease-nonsense/no-god-components": "error";
         readonly "cease-nonsense/no-print": "error";
         readonly "cease-nonsense/no-shorthand-names": "error";
         readonly "cease-nonsense/no-warn": "error";