eslint-plugin-etc-misc 1.0.2 → 1.0.3

package/docs/rules/export-matching-filename-only.md

@@ -58,16 +58,18 @@ enabling this rule at `error`.
 
 ```ts
 type Options = [
-    {
-        format?: "camelCase" | "kebab-case" | "PascalCase";
-    },
+ {
+  format?: "camelCase" | "kebab-case" | "PascalCase";
+ },
 ];
 ```
 
 Default:
 
 ```ts
-{ format: "PascalCase" }
+{
+ format: "PascalCase";
+}
 ```
 
 ## Additional examples
@@ -85,12 +87,12 @@ export { userService };
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/export-matching-filename-only": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/export-matching-filename-only": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/getting-started.md

@@ -21,8 +21,8 @@ export default [
 ];
 ```
 
-Use `recommended` first, then move through stricter presets as your baseline
-stabilizes.
+Use `minimal` or `recommended` first, then move through stricter presets as
+your baseline stabilizes.
 
 ## Alternative: manual scoped setup
 
@@ -58,9 +58,10 @@ Use this pattern when you only extend rules and want full control over parser se
 
 ## Recommended rollout
 
-1. Start with `recommended`.
-2. Promote to `strict` when you want the same rules to hard-fail.
-3. Move to `strictTypeChecked` once your lint config is fully type-aware.
-4. Adopt `allStrict` or `all` when you want full rule coverage.
+1. Start with `minimal` if you want to defer the `typescript/prefer-readonly*` rules.
+2. Move to `recommended` for the full baseline.
+3. Promote to `strict` when you want the same rules to hard-fail.
+4. Move to `strictTypeChecked` once your lint config is fully type-aware.
+5. Adopt `allStrict` or `all` when you want full rule coverage.
 
 See the **Presets** section in this sidebar for details and examples.

package/docs/rules/match-filename.md

@@ -57,13 +57,13 @@ once naming conventions are stable.
 
 ```ts
 type Options = [
-    {
-        format?: "camelCase" | "kebab-case" | "PascalCase";
-        match?: boolean;
-        prefix?: string;
-        selector?: string | string[];
-        suffix?: string;
-    },
+ {
+  format?: "camelCase" | "kebab-case" | "PascalCase";
+  match?: boolean;
+  prefix?: string;
+  selector?: string | string[];
+  suffix?: string;
+ },
 ];
 ```
 
@@ -88,12 +88,12 @@ export function userService() {}
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/match-filename": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/match-filename": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/max-identifier-blocks.md

@@ -28,7 +28,7 @@ const AaaBbbCccDddEee = 1;
 function aaaBbbCccDddEee() {}
 
 const obj = {
-    veryLongCompoundIdentifierName: 1,
+ veryLongCompoundIdentifierName: 1,
 };
 ```
 
@@ -65,12 +65,12 @@ const parseHttpBody = true;
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/max-identifier-blocks": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/max-identifier-blocks": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-assign-mutated-array.md

@@ -26,12 +26,20 @@ mutating shared state, which causes subtle bugs.
 ## ❌ Incorrect
 
 ```ts
-const names = ["c", "a", "b"];
+const names = [
+ "c",
+ "a",
+ "b",
+];
 const sorted = names.sort();
 ```
 
 ```ts
-const names = ["c", "a", "b"];
+const names = [
+ "c",
+ "a",
+ "b",
+];
 print(names.reverse());
 ```
 
@@ -43,17 +51,29 @@ return sorted;
 ## ✅ Correct
 
 ```ts
-const names = ["c", "a", "b"];
+const names = [
+ "c",
+ "a",
+ "b",
+];
 names.sort();
 ```
 
 ```ts
-const names = ["c", "a", "b"];
+const names = [
+ "c",
+ "a",
+ "b",
+];
 const sorted = names.slice().sort();
 ```
 
 ```ts
-const names = ["c", "a", "b"];
+const names = [
+ "c",
+ "a",
+ "b",
+];
 const sorted = names.map((name) => name).reverse();
 ```
 
@@ -88,12 +108,12 @@ const result2 = source.sort();
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-assign-mutated-array": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-assign-mutated-array": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-at-sign-import.md

@@ -39,8 +39,8 @@ Typical migration is replacing `"@"` with a concrete module path like
 
 ```ts
 type Options = {
-    allow?: string[];
-    disallow?: string[];
+ allow?: string[];
+ disallow?: string[];
 };
 ```
 
@@ -48,7 +48,7 @@ Default:
 
 ```json
 {
-    "disallow": ["@"]
+ "disallow": ["@"]
 }
 ```
 
@@ -68,12 +68,12 @@ export { value } from "@/core/value";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-at-sign-import": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-at-sign-import": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-at-sign-internal-import.md

@@ -39,8 +39,8 @@ allowed local relative imports.
 
 ```ts
 type Options = {
-    allow?: string[];
-    disallow?: string[];
+ allow?: string[];
+ disallow?: string[];
 };
 ```
 
@@ -48,7 +48,7 @@ Default:
 
 ```json
 {
-    "disallow": ["@/**"]
+ "disallow": ["@/**"]
 }
 ```
 
@@ -69,12 +69,12 @@ import { helper } from "@";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-at-sign-internal-import": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-at-sign-internal-import": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-chain-coalescence-mixture.md

@@ -63,12 +63,12 @@ const titleSafe = maybeTitle ?? "Untitled";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-chain-coalescence-mixture": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-chain-coalescence-mixture": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-commented-out-code.md

@@ -33,9 +33,9 @@ const answer = 42;
 
 ```ts
 class Example {
-    public a: string;
-    // public b: string;
-    public c: string;
+ public a: string;
+ // public b: string;
+ public c: string;
 }
 ```
 
@@ -48,9 +48,9 @@ const answer = 42;
 
 ```ts
 class Example {
-  // #region Public API
-  public execute(): void {}
-  // #endregion
+ // #region Public API
+ public execute(): void {}
+ // #endregion
 }
 ```
 
@@ -95,12 +95,12 @@ Use the **Deprecated** section above for lifecycle details.
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-commented-out-code": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-commented-out-code": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-const-enum.md

@@ -22,8 +22,8 @@ toolchains and isolated transpilation flows.
 
 ```ts
 const enum Status {
-    Ready,
-    Running,
+ Ready,
+ Running,
 }
 ```
 
@@ -31,8 +31,8 @@ const enum Status {
 
 ```ts
 enum Status {
-    Ready,
-    Running,
+ Ready,
+ Running,
 }
 ```
 
@@ -49,7 +49,7 @@ Migration options:
 
 ```ts
 type Options = {
-    allowLocal?: boolean;
+ allowLocal?: boolean;
 };
 ```
 
@@ -64,12 +64,12 @@ When `true`, non-exported `const enum` declarations are allowed.
 ```ts
 // config: { allowLocal: true }
 const enum LocalKind {
-    A,
+ A,
 }
 // ✅ allowed when not exported
 
 export const enum PublicKind {
-    A,
+ A,
 }
 // ❌ still reported
 ```
@@ -80,12 +80,12 @@ export const enum PublicKind {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-const-enum": ["error", { allowLocal: true }],
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-const-enum": ["error", { allowLocal: true }],
+  },
+ },
 ];
 ```
 

package/docs/rules/no-deprecated.md

@@ -6,7 +6,7 @@ Disallow usage of symbols tagged with `@deprecated`.
 
 ⚠️ 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 `@deprecated` JSDoc tags, usage is
@@ -37,8 +37,8 @@ oldMethod();
 
 ```ts
 interface Api {
-  /** @deprecated Use `nextValue` instead. */
-  oldValue: string;
+ /** @deprecated Use `nextValue` instead. */
+ oldValue: string;
 }
 
 declare const api: Api;
@@ -77,16 +77,16 @@ It reports only and does not provide an autofix.
 
 ```ts
 type Options = [
-  {
-    ignored?: Record<string, "name" | "path">;
-  }?,
+ {
+  ignored?: Record<string, "name" | "path">;
+ }?,
 ];
 ```
 
 Default:
 
 ```ts
-[{}]
+[{}];
 ```
 
 Use `ignored` to suppress some deprecated symbols by regular-expression pattern:
@@ -103,20 +103,20 @@ Example:
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-  {
-    plugins: { "etc-misc": etcMisc },
-    rules: {
-      "etc-misc/no-deprecated": [
-        "warn",
-        {
-          ignored: {
-            "^LegacyMethod$": "name",
-            "modules/legacy": "path",
-          },
-        },
-      ],
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-deprecated": [
+    "warn",
+    {
+     ignored: {
+      "^LegacyMethod$": "name",
+      "modules/legacy": "path",
+     },
     },
+   ],
   },
+ },
 ];
 ```
 
@@ -127,7 +127,7 @@ Use the **Deprecated** section above for lifecycle details.
 ## Additional examples
 
 ```ts
-/** @deprecated internal migration shim */
+/** @deprecated Internal migration shim */
 declare const legacyApi: () => void;
 
 legacyApi();
@@ -144,12 +144,12 @@ legacyApi();
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-deprecated": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-deprecated": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-enum.md

@@ -19,8 +19,8 @@ objects are preferred over enum runtime constructs.
 
 ```ts
 enum Status {
-    Ready,
-    Running,
+ Ready,
+ Running,
 }
 ```
 
@@ -28,8 +28,8 @@ enum Status {
 
 ```ts
 const Status = {
-    Ready: "Ready",
-    Running: "Running",
+ Ready: "Ready",
+ Running: "Running",
 } as const;
 
 type Status = (typeof Status)[keyof typeof Status];
@@ -49,14 +49,14 @@ This rule has no options.
 
 ```ts
 enum HttpCode {
-    Ok = 200,
-    NotFound = 404,
+ Ok = 200,
+ NotFound = 404,
 }
 // ❌ reported
 
 const HttpCode = {
-    Ok: 200,
-    NotFound: 404,
+ Ok: 200,
+ NotFound: 404,
 } as const;
 
 type HttpCode = (typeof HttpCode)[keyof typeof HttpCode];
@@ -69,12 +69,12 @@ type HttpCode = (typeof HttpCode)[keyof typeof HttpCode];
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-enum": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-enum": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/no-expression-empty-lines.md

@@ -16,25 +16,20 @@ This rule reports expression statements whose inner source text contains empty l
 
 ## Why this rule exists
 
-Blank lines *inside* a single expression usually come from accidental edits and
+Blank lines _inside_ a single expression usually come from accidental edits and
 make statement boundaries harder to read. Normalizing these expressions reduces
 formatting noise.
 
 ## ❌ Incorrect
 
 ```ts
-someCall(
-
-    1
-);
+someCall(1);
 ```
 
 ## ✅ Correct
 
 ```ts
-someCall(
-    1
-);
+someCall(1);
 ```
 
 ## Behavior and migration notes
@@ -52,16 +47,13 @@ This rule has no options.
 
 ```ts
 doWork(
-    value,
+ value,
 
-    nextValue
+ nextValue
 );
 // ❌ reported
 
-doWork(
-    value,
-    nextValue
-);
+doWork(value, nextValue);
 // ✅ valid
 ```
 
@@ -71,12 +63,12 @@ doWork(
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/no-expression-empty-lines": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/no-expression-empty-lines": "error",
+  },
+ },
 ];
 ```