eslint-plugin-etc-misc 1.0.2 → 1.0.3

package/docs/docusaurus/blog/2026-03-09-docs-site-online.md

@@ -3,9 +3,9 @@ title: Docs Site Is Online
 slug: docs-site-online
 authors: nick
 tags:
-    - docs
-    - docusaurus
-    - release
+ - docs
+ - docusaurus
+ - release
 ---
 
 The Docusaurus site is now live with:

package/docs/docusaurus/blog/2026-03-11-adr-driven-docs-roadmap.md

@@ -3,9 +3,9 @@ title: ADR-Driven Docs Roadmap
 slug: adr-driven-docs-roadmap
 authors: nick
 tags:
-    - docs
-    - adr
-    - architecture
+ - docs
+ - adr
+ - architecture
 ---
 
 We added three new ADRs to document core project strategy:

package/docs/docusaurus/docusaurus.config.ts

@@ -23,7 +23,6 @@ const projectName = "eslint-plugin-etc-misc";
 const modernEnhancementsClientModule = fileURLToPath(
     new URL("src/js/modernEnhancements.ts", import.meta.url)
 );
-
 /** PWA theme-color meta value for Chromium-based browsers. */
 const pwaThemeColor = "#8D0CE8";
 /** Windows tile color for pinned-site metadata. */
@@ -285,7 +284,7 @@ const config: Config = {
                         },
                         {
                             label: "🎛 Presets",
-                            to: "/docs/rules/presets/recommended",
+                            to: "/docs/rules/presets/minimal",
                         },
                         {
                             label: "📏 Rule Reference",
@@ -365,7 +364,7 @@ const config: Config = {
                     activeBaseRegex: "^/docs/rules/presets(?:/.*)?$",
                     label: "🎛️ Presets",
                     position: "left",
-                    to: "/docs/rules/presets/recommended",
+                    to: "/docs/rules/presets/minimal",
                 },
                 {
                     label: "📰 Blog",

package/docs/docusaurus/sidebars.rules.ts

@@ -238,6 +238,14 @@ if (guideItems.length > 0) {
 
 const presetItems: SidebarsConfig["rules"] = [];
 
+if (hasRulesPluginDocId("presets/minimal")) {
+    presetItems.push({
+        id: "presets/minimal",
+        label: "🟢 Minimal",
+        type: "doc",
+    });
+}
+
 if (hasRulesPluginDocId("presets/recommended")) {
     presetItems.push({
         id: "presets/recommended",

package/docs/docusaurus/site-docs/getting-started.md

@@ -15,13 +15,12 @@ Then enable it in your Flat Config:
 ```ts
 import etcMisc from "eslint-plugin-etc-misc";
 
-export default [
-    etcMisc.configs.recommended,
-];
+export default [etcMisc.configs.recommended];
 ```
 
 ## Recommended approach
 
+- Start with `etcMisc.configs.minimal` if you want to defer readonly-style constraints.
 - Start with `etcMisc.configs.recommended`.
 - Fix violations in small batches.
 - Move to `etcMisc.configs.all` when you want every available rule enabled.

package/docs/docusaurus/site-docs/guides/blog-post-backlog.md

@@ -8,18 +8,18 @@ title: Blog post backlog
 This page tracks high-value blog post ideas sourced from ADRs, release
 workflow, benchmarking, and rule curation work.
 
-| Proposed title | Core angle | Source material | Audience | Status |
-| --- | --- | --- | --- | --- |
-| Why we unified etc + misc into one plugin | Explain the curation strategy and trade-offs | ADR 0003 | New adopters | Idea |
-| How we keep 100+ rule docs in sync | Show generated catalog and sync automation | ADR 0004 + sync scripts | Maintainers | Idea |
-| Designing a practical recommended preset | Discuss warn/error tiering philosophy | ADR 0005 + `src/configs/recommended.ts` | Teams adopting plugin | Idea |
-| Flat Config-first from day one | Migration rationale for modern ESLint | ADR 0001 | ESLint users migrating from legacy | Idea |
-| Docs coverage as a hard gate | Why docs parity must fail fast | ADR 0002 + sidebar checks | OSS maintainers | Idea |
-| Rule overlap audits: how we avoid duplicates | Method for checking ecosystem overlap before adding rules | Rule scan workflow + tests | Rule authors | Idea |
-| Performance guardrails for large rule sets | Benchmark strategy and regression tracking | `benchmarks/README.md` | Performance-focused users | Idea |
-| Release engineering without changelog drift | Runtime release notes + no-commit CI changelog policy | `RELEASING.md` + workflows | Maintainers | Idea |
-| Immutability rule family deep dive | Why readonly array/map/set/record rules are bundled | Rule docs in `/docs/rules/typescript-*readonly*` | TypeScript teams | Idea |
-| Building reliable autofixes in custom ESLint rules | Patterns for safe fixers and suggestions | Rule tests + docs maintenance playbook | Rule developers | Idea |
+| Proposed title                                     | Core angle                                                | Source material                                  | Audience                           | Status |
+| -------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------ | ---------------------------------- | ------ |
+| Why we unified etc + misc into one plugin          | Explain the curation strategy and trade-offs              | ADR 0003                                         | New adopters                       | Idea   |
+| How we keep 100+ rule docs in sync                 | Show generated catalog and sync automation                | ADR 0004 + sync scripts                          | Maintainers                        | Idea   |
+| Designing a practical recommended preset           | Discuss warn/error tiering philosophy                     | ADR 0005 + `src/configs/recommended.ts`          | Teams adopting plugin              | Idea   |
+| Flat Config-first from day one                     | Migration rationale for modern ESLint                     | ADR 0001                                         | ESLint users migrating from legacy | Idea   |
+| Docs coverage as a hard gate                       | Why docs parity must fail fast                            | ADR 0002 + sidebar checks                        | OSS maintainers                    | Idea   |
+| Rule overlap audits: how we avoid duplicates       | Method for checking ecosystem overlap before adding rules | Rule scan workflow + tests                       | Rule authors                       | Idea   |
+| Performance guardrails for large rule sets         | Benchmark strategy and regression tracking                | `benchmarks/README.md`                           | Performance-focused users          | Idea   |
+| Release engineering without changelog drift        | Runtime release notes + no-commit CI changelog policy     | `RELEASING.md` + workflows                       | Maintainers                        | Idea   |
+| Immutability rule family deep dive                 | Why readonly array/map/set/record rules are bundled       | Rule docs in `/docs/rules/typescript-*readonly*` | TypeScript teams                   | Idea   |
+| Building reliable autofixes in custom ESLint rules | Patterns for safe fixers and suggestions                  | Rule tests + docs maintenance playbook           | Rule developers                    | Idea   |
 
 ## Editorial guidance
 

package/docs/docusaurus/site-docs/guides/migration-from-etc-and-misc.md

@@ -31,13 +31,13 @@ import etc from "eslint-plugin-etc";
 import misc from "eslint-plugin-misc";
 
 export default [
-    {
-        plugins: { etc, misc },
-        rules: {
-            "etc/no-internal": "error",
-            "misc/no-t": "error",
-        },
-    },
+ {
+  plugins: { etc, misc },
+  rules: {
+   "etc/no-internal": "error",
+   "misc/no-t": "error",
+  },
+ },
 ];
 ```
 

package/docs/docusaurus/site-docs/intro.md

@@ -20,7 +20,7 @@ projects.
 ```mermaid
 flowchart LR
     A[Rule Source\nsrc/rules/*.ts] --> B[Plugin Registry\nsrc/rules.ts]
-    B --> C[Presets\nconfigs/recommended + configs/all]
+    B --> C[Presets\nconfigs/minimal + configs/recommended + configs/all]
     A --> D[Rule Docs\ndocs/rules/*.md]
     D --> E[Docs Site\n/docs/rules]
     F[Architecture ADRs\n/docs/architecture/adr] --> E

package/docs/rules/array-type.md

@@ -53,12 +53,12 @@ type ValuesFixed = string[];
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/array-type": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/array-type": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/class-match-filename.md

@@ -66,12 +66,12 @@ export default class UserService {}
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/class-match-filename": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/class-match-filename": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/comment-spacing.md

@@ -38,7 +38,7 @@ across contributors and editors.
  * Renders the profile panel.
  */
 const renderProfile = () => {
-    // ...
+ // ...
 };
 ```
 
@@ -56,7 +56,7 @@ const normalize = (value: string) => value.trim();
  */
 
 const renderProfile = () => {
-    // ...
+ // ...
 };
 ```
 
@@ -82,7 +82,7 @@ This rule has no options.
 ```ts
 /* eslint-disable no-console */
 const run = () => {
-    console.log("allowed here");
+ console.log("allowed here");
 };
 ```
 
@@ -101,12 +101,12 @@ const createTask = () => ({ id: crypto.randomUUID() });
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/comment-spacing": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/comment-spacing": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/consistent-empty-lines.md

@@ -31,7 +31,6 @@ reduces noisy formatting diffs.
 ```ts
 const first = 1;
 
-
 const second = 2;
 ```
 
@@ -61,9 +60,9 @@ This rule has no options.
 
 ```ts
 function run(): void {
-    stepOne();
+ stepOne();
 
-    stepTwo();
+ stepTwo();
 }
 ```
 
@@ -73,12 +72,12 @@ function run(): void {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/consistent-empty-lines": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/consistent-empty-lines": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/consistent-enum-members.md

@@ -9,18 +9,18 @@ This rule analyzes TypeScript `TSEnumMember` nodes and validates naming for:
 - enum member identifiers (for example `ACTIVE_USER`), and
 - string literal member values when provided.
 
-It enforces SCREAMING_SNAKE_CASE in both places.
+It enforces SCREAMING\_SNAKE\_CASE in both places.
 
 ## What this rule reports
 
 This rule reports enum members when **neither** of these matches
-SCREAMING_SNAKE_CASE:
+SCREAMING\_SNAKE\_CASE:
 
 - the member identifier name, or
 - the string literal initializer value.
 
 In other words, the current implementation accepts a member if either side is
-already SCREAMING_SNAKE_CASE.
+already SCREAMING\_SNAKE\_CASE.
 
 ## Why this rule exists
 
@@ -32,8 +32,8 @@ Standardizing enum casing lowers conversion glue and helps grepability.
 
 ```ts
 enum Status {
-    pendingApproval = "PENDING_APPROVAL",
-    ACTIVE_USER = "active_user",
+ pendingApproval = "PENDING_APPROVAL",
+ ACTIVE_USER = "active_user",
 }
 ```
 
@@ -41,8 +41,8 @@ enum Status {
 
 ```ts
 enum Status {
-    PENDING_APPROVAL = "PENDING_APPROVAL",
-    ACTIVE_USER = "ACTIVE_USER",
+ PENDING_APPROVAL = "PENDING_APPROVAL",
+ ACTIVE_USER = "ACTIVE_USER",
 }
 ```
 
@@ -58,22 +58,23 @@ This rule has no options.
 
 ```ts
 enum EventType {
-    USER_CREATED,
-    USER_DELETED,
+ USER_CREATED,
+ USER_DELETED,
 }
 ```
 
 ```ts
 enum Permission {
-    READ_ONLY = "READ_ONLY",
-    READ_WRITE = "READ_WRITE",
+ READ_ONLY = "READ_ONLY",
+ READ_WRITE = "READ_WRITE",
 }
 ```
 
-```ts
-enum Partial {
-    USER_CREATED = "user_created",
-}
+````ts
+
+
+
+enum Partial {    USER_CREATED = "user_created",}
 // ✅ currently accepted (name matches SCREAMING_SNAKE_CASE)
 
 ## ESLint flat config example
@@ -89,7 +90,7 @@ export default [
         },
     },
 ];
-```
+````
 
 ## When not to use it
 

package/docs/rules/consistent-filename.md

@@ -54,16 +54,18 @@ It reports only and does not provide an autofix.
 
 ```ts
 type Options = [
-    {
-        format?: "camelCase" | "kebab-case" | "PascalCase";
-    },
+ {
+  format?: "camelCase" | "kebab-case" | "PascalCase";
+ },
 ];
 ```
 
 Default:
 
 ```ts
-{ format: "kebab-case" }
+{
+ format: "kebab-case";
+}
 ```
 
 ### Status
@@ -86,12 +88,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/consistent-filename": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/consistent-filename": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/consistent-import.md

@@ -20,7 +20,7 @@ It distinguishes five styles:
 This rule reports imports whose style does not match the expected style.
 
 - Without options, the first import style seen for a given module source becomes
-the expected style for subsequent imports from that same source.
+  the expected style for subsequent imports from that same source.
 - With `style`, all imports must match the configured style globally.
 
 ## Why this rule exists
@@ -61,9 +61,9 @@ cleanup) before promoting from `warn` to `error`.
 
 ```ts
 type Options = [
-    {
-        style?: "default" | "mixed" | "named" | "namespace" | "side-effect";
-    },
+ {
+  style?: "default" | "mixed" | "named" | "namespace" | "side-effect";
+ },
 ];
 ```
 
@@ -72,7 +72,7 @@ type Options = [
 ### Default configuration
 
 ```ts
-[{}]
+[{}];
 ```
 
 When `style` is omitted, the first seen import style for each module source is
@@ -98,12 +98,12 @@ import "reflect-metadata";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/consistent-import": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/consistent-import": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/consistent-optional-props.md

@@ -34,11 +34,11 @@ to read.
 
 ```ts
 interface User {
-    name?: string | undefined;
+ name?: string | undefined;
 }
 
 class Config {
-    timeoutMs?: number | undefined;
+ timeoutMs?: number | undefined;
 }
 ```
 
@@ -46,11 +46,11 @@ class Config {
 
 ```ts
 interface User {
-    name?: string;
+ name?: string;
 }
 
 class Config {
-    timeoutMs?: number;
+ timeoutMs?: number;
 }
 ```
 
@@ -68,12 +68,12 @@ This rule has no options.
 
 ```ts
 type Options = {
-    verbose?: boolean | undefined;
+ verbose?: boolean | undefined;
 };
 // ❌ reported
 
 type OptionsFixed = {
-    verbose?: boolean;
+ verbose?: boolean;
 };
 // ✅ valid
 ```
@@ -84,12 +84,12 @@ type OptionsFixed = {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/consistent-optional-props": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/consistent-optional-props": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/consistent-source-extension.md

@@ -76,12 +76,12 @@ export * from "./utils";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/consistent-source-extension": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/consistent-source-extension": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/consistent-symbol-description.md

@@ -62,12 +62,12 @@ const bad = Symbol("Cache_Key");
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/consistent-symbol-description": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/consistent-symbol-description": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/default-case.md

@@ -19,8 +19,8 @@ control flow.
 
 ```ts
 switch (status) {
-    case "open":
-        break;
+ case "open":
+  break;
 }
 ```
 
@@ -28,10 +28,10 @@ switch (status) {
 
 ```ts
 switch (status) {
-    case "open":
-        break;
-    default:
-        break;
+ case "open":
+  break;
+ default:
+  break;
 }
 ```
 
@@ -43,18 +43,18 @@ This rule forwards options and behavior to ESLint core `default-case`.
 
 ```ts
 switch (kind) {
-    case "a":
-        runA();
-        break;
+ case "a":
+  runA();
+  break;
 }
 // ❌ reported
 
 switch (kind) {
-    case "a":
-        runA();
-        break;
-    default:
-        throw new Error(`Unhandled kind: ${kind}`);
+ case "a":
+  runA();
+  break;
+ default:
+  throw new Error(`Unhandled kind: ${kind}`);
 }
 // ✅ valid
 ```
@@ -65,12 +65,12 @@ switch (kind) {
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/default-case": "error",
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/default-case": "error",
+  },
+ },
 ];
 ```
 

package/docs/rules/disallow-import.md

@@ -31,7 +31,9 @@ import value from "../source";
 with options:
 
 ```ts
-{ disallow: ["../**"] }
+{
+ disallow: ["../**"];
+}
 ```
 
 ## ✅ Correct
@@ -57,8 +59,8 @@ configure `disallow` patterns.
 
 ```ts
 type Options = {
-    allow?: string[];
-    disallow?: string[];
+ allow?: string[];
+ disallow?: string[];
 };
 ```
 
@@ -79,12 +81,12 @@ import shared from "../shared/math";
 import etcMisc from "eslint-plugin-etc-misc";
 
 export default [
-    {
-        plugins: { "etc-misc": etcMisc },
-        rules: {
-            "etc-misc/disallow-import": ["error", { disallow: ["../**"] }],
-        },
-    },
+ {
+  plugins: { "etc-misc": etcMisc },
+  rules: {
+   "etc-misc/disallow-import": ["error", { disallow: ["../**"] }],
+  },
+ },
 ];
 ```