eslint-plugin-etc-misc 1.0.2 → 1.0.3

package/docs/rules/no-foreach.md

@@ -31,7 +31,7 @@ answers.forEach((answer) => console.log(answer));
 ```ts
 const answers = [42, 54];
 for (const answer of answers) {
-    console.log(answer);
+ console.log(answer);
 }
 ```
 
@@ -46,7 +46,7 @@ utilities to `for...of` before promoting to `error`.
 
 ```ts
 type Options = {
-    types?: string[];
+ types?: string[];
 };
 ```
 
@@ -61,13 +61,17 @@ Use this option to control which type names are checked.
 ## Additional examples
 
 ```ts
-const set = new Set([1, 2, 3]);
+const set = new Set([
+ 1,
+ 2,
+ 3,
+]);
 set.forEach((value) => console.log(value));
 // ❌ reported with default options
 
 const map = new Map<string, number>();
 for (const [key, value] of map) {
-    console.log(key, value);
+ console.log(key, value);
 }
 // ✅ preferred style
 ```
@@ -78,12 +82,12 @@ for (const [key, value] of map) {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-foreach": ["error", { types: ["Array", "Set"] }],
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-foreach": ["error", { types: ["Array", "Set"] }],
+  },
+ },
 ];
 ```
 

package/docs/rules/no-implicit-any-catch.md

@@ -37,13 +37,13 @@ narrowing before property access.
 
 ```ts
 Promise.reject(new Error("Boom")).catch((error) => {
-  console.error(error);
+ console.error(error);
 });
 ```
 
 ```ts
 Promise.reject(new Error("Boom")).catch((error: any) => {
-  console.error(error);
+ console.error(error);
 });
 ```
 
@@ -51,9 +51,9 @@ Promise.reject(new Error("Boom")).catch((error: any) => {
 
 ```ts
 Promise.reject(new Error("Boom")).catch((error: unknown) => {
-  if (error instanceof Error) {
-    console.error(error.message);
-  }
+ if (error instanceof Error) {
+  console.error(error.message);
+ }
 });
 ```
 
@@ -68,16 +68,16 @@ narrowed annotations, a safe suggestion is provided instead of forced rewrite.
 
 ```ts
 type Options = [
-  {
-    allowExplicitAny?: boolean;
-  }?,
+ {
+  allowExplicitAny?: boolean;
+ }?,
 ];
 ```
 
 Default:
 
 ```ts
-[{}]
+[{}];
 ```
 
 ### `allowExplicitAny`
@@ -89,17 +89,17 @@ rejection callbacks.
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-  {
-    plugins: { "etc-misc": etcMisc },
-    rules: {
-      "etc-misc/no-implicit-any-catch": [
-        "error",
-        {
-          allowExplicitAny: true,
-        },
-      ],
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-implicit-any-catch": [
+    "error",
+    {
+     allowExplicitAny: true,
     },
+   ],
   },
+ },
 ];
 ```
 
@@ -107,17 +107,17 @@ export default [
 
 ```ts
 Promise.resolve(1).then(
-  (value) => value,
-  (error: string) => {
-    console.error(error);
-  }
+ (value) => value,
+ (error: string) => {
+  console.error(error);
+ }
 );
 // ❌ reported as narrowed type, with suggestion to use unknown
 
 Promise.resolve(1).catch((error: unknown) => {
-  if (error instanceof Error) {
-    console.error(error.message);
-  }
+ if (error instanceof Error) {
+  console.error(error.message);
+ }
 });
 // ✅ valid
 ```
@@ -128,12 +128,12 @@ Promise.resolve(1).catch((error: unknown) => {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-implicit-any-catch": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-implicit-any-catch": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-index-import.md

@@ -40,8 +40,8 @@ Migration usually means replacing `"."` with a concrete relative path.
 
 ```ts
 type Options = {
-    allow?: string[];
-    disallow?: string[];
+ allow?: string[];
+ disallow?: string[];
 };
 ```
 
@@ -49,7 +49,7 @@ Default:
 
 ```json
 {
-    "disallow": ["."]
+ "disallow": ["."]
 }
 ```
 
@@ -72,12 +72,12 @@ const moduleRef = await import("./feature");
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-index-import": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-index-import": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-internal-modules.md

@@ -52,8 +52,8 @@ entrypoint imports.
 
 ```ts
 type Options = {
-    allow?: string[];
-    disallow?: string[];
+ allow?: string[];
+ disallow?: string[];
 };
 ```
 
@@ -61,7 +61,7 @@ Default:
 
 ```json
 {
-    "disallow": ["./*/**", "[^@]*/**", "@?*/*/**"]
+ "disallow": ["./*/**", "[^@]*/**", "@?*/*/**"]
 }
 ```
 
@@ -82,12 +82,12 @@ import c from "@scope/package";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-internal-modules": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-internal-modules": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-internal.md

@@ -6,7 +6,7 @@ Disallow usage of symbols tagged with `@internal`.
 
 ⚠️ This rule requires type information to run. Configure type-aware linting (`parserOptions.project` or `projectService`) before enabling it.
 
-This rule inspects identifier *usages* and resolves each identifier to a
+This rule inspects identifier _usages_ and resolves each identifier to a
 TypeScript symbol.
 
 If the resolved symbol has one or more `@internal` JSDoc tags, usage is
@@ -31,7 +31,7 @@ outside a package's supported API surface.
 ```ts
 /** @internal */
 interface InternalType {
-  readonly value: number;
+ readonly value: number;
 }
 
 const item: InternalType = { value: 42 };
@@ -48,7 +48,7 @@ internalFunction();
 
 ```ts
 interface PublicType {
-  readonly value: number;
+ readonly value: number;
 }
 
 const item: PublicType = { value: 42 };
@@ -57,7 +57,7 @@ const item: PublicType = { value: 42 };
 ```ts
 /** @internal */
 interface InternalType {
-  readonly value: number;
+ readonly value: number;
 }
 
 // Declaration is allowed. Only usage is reported.
@@ -74,16 +74,16 @@ focuses on usage sites resolved through TypeScript symbol information.
 
 ```ts
 type Options = [
-  {
-    ignored?: Record<string, "name" | "path">;
-  }?,
+ {
+  ignored?: Record<string, "name" | "path">;
+ }?,
 ];
 ```
 
 Default:
 
 ```ts
-[{}]
+[{}];
 ```
 
 Use `ignored` to suppress some internal symbols by regular-expression pattern:
@@ -100,20 +100,20 @@ Example:
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-  {
-    plugins: { "etc-misc": etcMisc },
-    rules: {
-      "etc-misc/no-internal": [
-        "error",
-        {
-          ignored: {
-            "^ExperimentalInternalType$": "name",
-            "modules/internal": "path",
-          },
-        },
-      ],
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-internal": [
+    "error",
+    {
+     ignored: {
+      "^ExperimentalInternalType$": "name",
+      "modules/internal": "path",
+     },
     },
+   ],
   },
+ },
 ];
 ```
 
@@ -137,12 +137,12 @@ const ignoredValue = __internalThing;
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-internal": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-internal": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-language-mixing.md

@@ -59,12 +59,12 @@ const mixed = `пользовательId42`;
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-language-mixing": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-language-mixing": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-misused-generics.md

@@ -59,12 +59,12 @@ When this rule reports `canReplace`, replacing the type parameter with `unknown`
 
 ```ts
 function wrap<T extends string>(value: T): void {
-    console.log(value);
+ console.log(value);
 }
 // ❌ reported with `canReplace`: `T` can be replaced with `string`
 
 function pair<T>(left: T, right: T): [T, T] {
-    return [left, right];
+ return [left, right];
 }
 // ✅ valid: `T` meaningfully relates parameters and return type
 ```
@@ -75,12 +75,12 @@ function pair<T>(left: T, right: T): [T, T] {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-misused-generics": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-misused-generics": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-mixed-enums.md

@@ -20,8 +20,8 @@ understand.
 
 ```ts
 enum State {
-    open = "open",
-    closed = 2,
+ open = "open",
+ closed = 2,
 }
 ```
 
@@ -29,8 +29,8 @@ enum State {
 
 ```ts
 enum State {
-    open = 1,
-    closed = 2,
+ open = 1,
+ closed = 2,
 }
 ```
 
@@ -48,14 +48,14 @@ This rule forwards options and behavior to
 
 ```ts
 enum NumericStatus {
-    Open = 1,
-    Closed = 2,
+ Open = 1,
+ Closed = 2,
 }
 // ✅ valid
 
 enum MixedStatus {
-    Open = "open",
-    Closed = 2,
+ Open = "open",
+ Closed = 2,
 }
 // ❌ reported
 ```
@@ -66,12 +66,12 @@ enum MixedStatus {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-mixed-enums": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-mixed-enums": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-negated-conditions.md

@@ -25,16 +25,20 @@ expressions. Positive predicates are usually easier to scan and reason about.
 ## ❌ Incorrect
 
 ```ts
-if (!x && y) {}
-if (x !== 1 && y) {}
+if (!x && y) {
+}
+if (x !== 1 && y) {
+}
 const value = !x || y;
 ```
 
 ## ✅ Correct
 
 ```ts
-if (x && y) {}
-if (x === 1 && y) {}
+if (x && y) {
+}
+if (x === 1 && y) {
+}
 const value = x && y;
 ```
 
@@ -53,12 +57,12 @@ This rule has no options.
 
 ```ts
 if (!isReady || hasError) {
-    return;
+ return;
 }
 // ❌ reported
 
 if (isReady && hasNoError) {
-    start();
+ start();
 }
 // ✅ valid when predicates are already positive.
 ```
@@ -69,12 +73,12 @@ if (isReady && hasNoError) {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-negated-conditions": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-negated-conditions": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-nodejs-modules.md

@@ -45,8 +45,8 @@ with `path`, and so on.
 
 ```ts
 type Options = {
-    allow?: string[];
-    disallow?: string[];
+ allow?: string[];
+ disallow?: string[];
 };
 ```
 
@@ -54,7 +54,7 @@ Default:
 
 ```json
 {
-    "disallow": ["node:*"]
+ "disallow": ["node:*"]
 }
 ```
 
@@ -74,12 +74,12 @@ const fsModule = await import("fs");
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-nodejs-modules": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-nodejs-modules": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-param-reassign.md

@@ -25,8 +25,8 @@ input values.
 
 ```ts
 function f(value: number) {
-    sideEffect();
-    value += 1;
+ sideEffect();
+ value += 1;
 }
 ```
 
@@ -34,23 +34,23 @@ function f(value: number) {
 
 ```ts
 function f(value: number) {
-    value += 1;
-    sideEffect();
+ value += 1;
+ sideEffect();
 }
 ```
 
 ```ts
 function f(value: number): number {
-    const nextValue = value + 1;
-    return nextValue;
+ const nextValue = value + 1;
+ return nextValue;
 }
 ```
 
 ```ts
 function initialize(value: number) {
-    value = normalize(value);
-    // ✅ allowed: reassignment occurs in first expression statement
-    return value;
+ value = normalize(value);
+ // ✅ allowed: reassignment occurs in first expression statement
+ return value;
 }
 ```
 
@@ -68,10 +68,10 @@ This rule has no options.
 
 ```ts
 function increment(count: number): number {
-    doWork();
-    count++;
-    // ❌ reported: update occurs after the first expression statement
-    return count;
+ doWork();
+ count++;
+ // ❌ reported: update occurs after the first expression statement
+ return count;
 }
 ```
 
@@ -81,12 +81,12 @@ function increment(count: number): number {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-param-reassign": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-param-reassign": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-relative-parent-import.md

@@ -50,8 +50,8 @@ It reports only and does not provide an autofix.
 
 ```ts
 type Options = {
-    allow?: string[];
-    disallow?: string[];
+ allow?: string[];
+ disallow?: string[];
 };
 ```
 
@@ -61,7 +61,7 @@ Use `allow` for specific exceptions:
 
 ```ts
 {
-    allow: ["../allowed-source"]
+ allow: ["../allowed-source"];
 }
 ```
 
@@ -86,15 +86,15 @@ import mod from "@/shared/mod";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-relative-parent-import": [
-                "error",
-                { allow: ["../allowed-source"] },
-            ],
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-relative-parent-import": [
+    "error",
+    { allow: ["../allowed-source"] },
+   ],
+  },
+ },
 ];
 ```