@pobammer-ts/eslint-cease-nonsense-rules 1.7.0 → 1.9.0

package/README.md

@@ -13,6 +13,8 @@ An ESLint plugin that catches common mistakes before they reach production. This
   - [Resource Management](#resource-management)
   - [Code Quality](#code-quality)
   - [Performance](#performance)
+  - [Module Boundaries](#module-boundaries)
+  - [TypeScript](#typescript)
 - [License](#license)
 
 ## Installation
@@ -51,11 +53,18 @@ export default [
 			"cease-nonsense/no-shorthand-names": "error",
 			"cease-nonsense/no-useless-use-spring": "error",
 			"cease-nonsense/no-warn": "error",
+			"cease-nonsense/prefer-class-properties": "error",
+			"cease-nonsense/prefer-early-return": "error",
+			"cease-nonsense/prefer-module-scope-constants": "error",
+			"cease-nonsense/prefer-pascal-case-enums": "error",
 			"cease-nonsense/prefer-sequence-overloads": "error",
+			"cease-nonsense/prefer-singular-enums": "error",
 			"cease-nonsense/prefer-udim2-shorthand": "error",
+			"cease-nonsense/react-hooks-strict-return": "error",
 			"cease-nonsense/require-named-effect-functions": "error",
 			"cease-nonsense/require-paired-calls": "error",
 			"cease-nonsense/require-react-component-keys": "error",
+			"cease-nonsense/strict-component-boundaries": "error",
 			"cease-nonsense/use-exhaustive-dependencies": "error",
 			"cease-nonsense/use-hook-at-top-level": "error",
 		},
@@ -418,6 +427,35 @@ function UserProfile({ userId }) {
 }
 ```
 
+#### `react-hooks-strict-return`
+
+React hooks must return a tuple of ≤2 elements or a single object. Prevents unwieldy hook return types.
+
+**❌ Bad**
+
+```typescript
+function useMyHook() {
+	return [a, b, c]; // 3+ elements
+}
+
+function useData() {
+	const items = [1, 2, 3];
+	return items; // Variable reference to 3+ element array
+}
+```
+
+**✅ Good**
+
+```typescript
+function useMyHook() {
+	return [state, setState]; // 2 elements max
+}
+
+function useData() {
+	return { a, b, c }; // Objects are fine regardless of size
+}
+```
+
 ### Logging
 
 #### `no-print`
@@ -843,6 +881,85 @@ const deltaTime = 0.016;
 const model = entity.char; // Property access is allowed
 ```
 
+#### `prefer-class-properties`
+
+Prefer class properties over assignment of literals in constructors.
+
+**Options:** `['always' | 'never']` (default: `'always'`)
+
+**❌ Bad**
+
+```typescript
+class Foo {
+	constructor() {
+		this.bar = "literal"; // Assignment in constructor
+		this.obj = { key: "value" };
+	}
+}
+```
+
+**✅ Good**
+
+```typescript
+class Foo {
+	bar = "literal"; // Class property
+	obj = { key: "value" };
+}
+```
+
+#### `prefer-early-return`
+
+Prefer early returns over full-body conditional wrapping in function declarations.
+
+**Options:** `{ maximumStatements: number }` (default: `1`)
+
+**❌ Bad**
+
+```typescript
+function foo() {
+	if (condition) {
+		doA();
+		doB();
+		doC();
+	}
+}
+```
+
+**✅ Good**
+
+```typescript
+function foo() {
+	if (!condition) return;
+	doA();
+	doB();
+	doC();
+}
+```
+
+#### `prefer-module-scope-constants`
+
+SCREAMING_SNAKE_CASE variables must be `const` at module scope.
+
+**❌ Bad**
+
+```typescript
+let FOO = 1; // Not const
+function bar() {
+	const BAZ = 2; // Not module scope
+}
+```
+
+**✅ Good**
+
+```typescript
+const FOO = 1; // Const at module scope
+
+// Destructuring patterns are allowed anywhere
+function bar() {
+	const { FOO } = config;
+}
+```
+
 ### Performance
 
 #### `no-color3-constructor`
@@ -992,6 +1109,116 @@ class MyClass {
 }
 ```
 
+### Module Boundaries
+
+#### `strict-component-boundaries`
+
+Prevent reaching into sibling component folders for nested modules.
+
+**Options:** `{ allow: string[], maxDepth: number }` (default: `maxDepth: 1`)
+
+**❌ Bad**
+
+```typescript
+// Reaching into another component's internals
+import { helper } from "../OtherComponent/utils/helper";
+import { thing } from "./components/Foo/internal";
+```
+
+**✅ Good**
+
+```typescript
+// Import from shared location
+import { helper } from "../../shared/helper";
+
+// Index import from component
+import { OtherComponent } from "../OtherComponent";
+
+// Direct component import (within maxDepth)
+import { Foo } from "./components/Foo";
+```
+
+**Configuration**
+
+```typescript
+{
+  "cease-nonsense/strict-component-boundaries": ["error", {
+    "allow": ["components/\\w+$"],  // Regex patterns to allow
+    "maxDepth": 2                    // Maximum import depth
+  }]
+}
+```
+
+### TypeScript
+
+#### `prefer-pascal-case-enums`
+
+Enum names and members must be PascalCase.
+
+**❌ Bad**
+
+```typescript
+enum my_enum {
+	foo_bar,
+}
+enum MyEnum {
+	FOO_BAR,
+}
+enum COLORS {
+	red,
+}
+```
+
+**✅ Good**
+
+```typescript
+enum MyEnum {
+	FooBar,
+}
+enum Color {
+	Red,
+	Blue,
+}
+```
+
+#### `prefer-singular-enums`
+
+Enum names should be singular, not plural.
+
+**❌ Bad**
+
+```typescript
+enum Colors {
+	Red,
+	Blue,
+}
+enum Commands {
+	Up,
+	Down,
+}
+enum Feet {
+	Left,
+	Right,
+} // Irregular plural
+```
+
+**✅ Good**
+
+```typescript
+enum Color {
+	Red,
+	Blue,
+}
+enum Command {
+	Up,
+	Down,
+}
+enum Foot {
+	Left,
+	Right,
+}
+```
+
 ## License
 
 MIT License - feel free to use this code however you want.

package/dist/build-metadata.json

@@ -1,5 +1,5 @@
 {
-  "commit": "5190fe3e4c6dd0f00dca6ffc3ab597f548ed996b",
-  "time": "2025-12-20T05:50:30.010Z",
-  "version": "1.7.0"
+  "commit": "6f9e13801a44ec08f3620295fee898d814956ca1",
+  "time": "2025-12-21T10:12:09.203Z",
+  "version": "1.9.0"
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAuBnC,KAAK,aAAa,GAAG,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,yBAAyB,CAAC;AAE1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AACxH,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACjG,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,EACN,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,EAC/B,uBAAuB,EACvB,sBAAsB,EACtB,+BAA+B,EAC/B,sCAAsC,EACtC,8BAA8B,EAC9B,wBAAwB,GACxB,MAAM,iCAAiC,CAAC;AA+BzC;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAuBP,CAAC;AAEX,KAAK,YAAY,GAAG,OAAO,WAAW,CAAC;AAEvC,UAAU,MAAM;IACf,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;KAAE,CAAC;CACzD;AAED,QAAA,MAAM,MAAM,EAAE,MAGJ,CAAC;AAEX,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AA8BnC,KAAK,aAAa,GAAG,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,yBAAyB,CAAC;AAE1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AACxH,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACjG,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,EACN,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,EAC/B,uBAAuB,EACvB,sBAAsB,EACtB,+BAA+B,EAC/B,sCAAsC,EACtC,8BAA8B,EAC9B,wBAAwB,GACxB,MAAM,iCAAiC,CAAC;AAsCzC;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAuBP,CAAC;AAEX,KAAK,YAAY,GAAG,OAAO,WAAW,CAAC;AAEvC,UAAU,MAAM;IACf,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;KAAE,CAAC;CACzD;AAED,QAAA,MAAM,MAAM,EAAE,MAGJ,CAAC;AAEX,eAAe,MAAM,CAAC"}