eslint-plugin-etc-misc 1.0.1

package/docs/rules/prefer-object-has-own.md

@@ -0,0 +1,82 @@
+# prefer-object-has-own
+
+Prefer `Object.hasOwn(...)` over `Object.prototype.hasOwnProperty.call(...)`.
+
+## Targeted pattern scope
+
+This rule targets property-ownership checks using `hasOwnProperty.call`.
+
+## What this rule reports
+
+This rule reports legacy `Object.prototype.hasOwnProperty.call(...)` patterns.
+
+## Why this rule exists
+
+`Object.hasOwn(...)` is shorter, clearer, and less error-prone.
+
+## ❌ Incorrect
+
+```ts
+Object.prototype.hasOwnProperty.call(record, "id");
+```
+
+## ✅ Correct
+
+```ts
+Object.hasOwn(record, "id");
+```
+
+## Behavior and migration notes
+
+This rule forwards options and behavior to ESLint core
+`prefer-object-has-own`.
+
+- **Lifecycle:** Deprecated and frozen.
+- **Deprecated since:** `v1.0.0`
+- **Available until:** `v2.0.0`
+- **Use instead:** [`prefer-object-has-own` (ESLint core)](https://eslint.org/docs/latest/rules/prefer-object-has-own)
+
+## Additional examples
+
+```ts
+Object.prototype.hasOwnProperty.call(config, "port");
+// ❌ reported
+
+Object.hasOwn(config, "port");
+// ✅ valid
+```
+
+## ESLint flat config example
+
+```ts
+import etcMisc from "eslint-plugin-etc-misc";
+
+export default [
+    {
+        plugins: { "etc-misc": etcMisc },
+        rules: {
+            "etc-misc/prefer-object-has-own": "error",
+        },
+    },
+];
+```
+
+## When not to use it
+
+Disable this rule if you must support runtimes without `Object.hasOwn(...)` and
+cannot polyfill it.
+
+## Package documentation
+
+- [eslint-plugin-etc-misc README](https://github.com/Nick2bad4u/eslint-plugin-etc-misc#readme)
+
+> **Rule catalog ID:** R060
+
+## Further reading
+
+- [ESLint: `prefer-object-has-own`](https://eslint.org/docs/latest/rules/prefer-object-has-own)
+
+## Adoption resources
+
+- Start at warning level in CI, then move to error after cleanup.
+- Use focused codemods/autofix batches per package or directory.

package/docs/rules/prefer-only-export.md

@@ -0,0 +1,89 @@
+# prefer-only-export
+
+Disallow additional exports alongside a default export.
+
+## Targeted pattern scope
+
+This rule targets program bodies where both are true:
+
+- a `default` export exists, and
+- the file has more than one top-level statement.
+
+## What this rule reports
+
+This rule reports files that contain `export default` plus any additional
+top-level statement (including non-export statements).
+
+## Why this rule exists
+
+Some teams enforce a strict module contract: either a module exposes one default
+value, or it exposes named exports, but not both. Mixing both styles can make
+imports inconsistent across the codebase.
+
+## ❌ Incorrect
+
+```ts
+export default 1;
+export const x = 1;
+```
+
+## ✅ Correct
+
+```ts
+export default 1;
+```
+
+```ts
+export const x = 1;
+export const y = 2;
+```
+
+## Behavior and migration notes
+
+This rule has no options.
+
+## Additional examples
+
+```ts
+export default function main() {}
+const helper = 1;
+// ❌ reported by current implementation (second top-level statement)
+
+export default function main() {}
+// ✅ valid
+```
+
+## ESLint flat config example
+
+```ts
+import etcMisc from "eslint-plugin-etc-misc";
+
+export default [
+    {
+        plugins: { "etc-misc": etcMisc },
+        rules: {
+            "etc-misc/prefer-only-export": "error",
+        },
+    },
+];
+```
+
+## When not to use it
+
+Disable this rule if combining default and named exports is allowed in your modules.
+
+## Package documentation
+
+- [eslint-plugin-etc-misc README](https://github.com/Nick2bad4u/eslint-plugin-etc-misc#readme)
+
+> **Rule catalog ID:** R061
+
+## Further reading
+
+- [MDN: `export` statement](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/export)
+- [TypeScript Handbook: Modules](https://www.typescriptlang.org/docs/handbook/modules/introduction.html)
+
+## Adoption resources
+
+- Start at warning level in CI, then move to error after cleanup.
+- Use focused codemods/autofix batches per package or directory.

package/docs/rules/presets/all-strict.md

@@ -0,0 +1,160 @@
+---
+title: All Strict preset
+---
+
+# 🔴 All Strict
+
+Use this preset when you want near-maximum enforcement across the entire plugin
+surface.
+
+## Config key
+
+```ts
+etcMisc.configs.allStrict
+```
+
+## Flat Config example
+
+```ts
+import etcMisc from "eslint-plugin-etc-misc";
+
+export default [etcMisc.configs.allStrict];
+```
+
+## Rules in this preset
+
+- [`etc-misc/array-type`](../array-type.md) (R001)
+- [`etc-misc/class-match-filename`](../class-match-filename.md) (R002)
+- [`etc-misc/comment-spacing`](../comment-spacing.md) (R003)
+- [`etc-misc/consistent-empty-lines`](../consistent-empty-lines.md) (R004)
+- [`etc-misc/consistent-enum-members`](../consistent-enum-members.md) (R005)
+- [`etc-misc/consistent-filename`](../consistent-filename.md) (R006)
+- [`etc-misc/consistent-import`](../consistent-import.md) (R007)
+- [`etc-misc/consistent-optional-props`](../consistent-optional-props.md) (R008)
+- [`etc-misc/consistent-source-extension`](../consistent-source-extension.md) (R009)
+- [`etc-misc/consistent-symbol-description`](../consistent-symbol-description.md) (R010)
+- [`etc-misc/default-case`](../default-case.md) (R011)
+- [`etc-misc/disallow-import`](../disallow-import.md) (R012)
+- [`etc-misc/export-matching-filename-only`](../export-matching-filename-only.md) (R013)
+- [`etc-misc/match-filename`](../match-filename.md) (R014)
+- [`etc-misc/max-identifier-blocks`](../max-identifier-blocks.md) (R015)
+- [`etc-misc/no-assign-mutated-array`](../no-assign-mutated-array.md) (R016)
+- [`etc-misc/no-at-sign-import`](../no-at-sign-import.md) (R017)
+- [`etc-misc/no-at-sign-internal-import`](../no-at-sign-internal-import.md) (R018)
+- [`etc-misc/no-chain-coalescence-mixture`](../no-chain-coalescence-mixture.md) (R019)
+- [`etc-misc/no-commented-out-code`](../no-commented-out-code.md) (R020)
+- [`etc-misc/no-const-enum`](../no-const-enum.md) (R021)
+- [`etc-misc/no-deprecated`](../no-deprecated.md) (R022)
+- [`etc-misc/no-enum`](../no-enum.md) (R023)
+- [`etc-misc/no-expression-empty-lines`](../no-expression-empty-lines.md) (R024)
+- [`etc-misc/no-foreach`](../no-foreach.md) (R025)
+- [`etc-misc/no-implicit-any-catch`](../no-implicit-any-catch.md) (R026)
+- [`etc-misc/no-index-import`](../no-index-import.md) (R027)
+- [`etc-misc/no-internal-modules`](../no-internal-modules.md) (R029)
+- [`etc-misc/no-internal`](../no-internal.md) (R028)
+- [`etc-misc/no-language-mixing`](../no-language-mixing.md) (R030)
+- [`etc-misc/no-misused-generics`](../no-misused-generics.md) (R031)
+- [`etc-misc/no-mixed-enums`](../no-mixed-enums.md) (R032)
+- [`etc-misc/no-negated-conditions`](../no-negated-conditions.md) (R033)
+- [`etc-misc/no-nodejs-modules`](../no-nodejs-modules.md) (R034)
+- [`etc-misc/no-param-reassign`](../no-param-reassign.md) (R035)
+- [`etc-misc/no-relative-parent-import`](../no-relative-parent-import.md) (R036)
+- [`etc-misc/no-restricted-syntax`](../no-restricted-syntax.md) (R037)
+- [`etc-misc/no-secret`](../no-secret.md) (R038)
+- [`etc-misc/no-self-import`](../no-self-import.md) (R039)
+- [`etc-misc/no-shadow`](../no-shadow.md) (R040)
+- [`etc-misc/no-sibling-import`](../no-sibling-import.md) (R041)
+- [`etc-misc/no-single-line-comment`](../no-single-line-comment.md) (R042)
+- [`etc-misc/no-t`](../no-t.md) (R043)
+- [`etc-misc/no-underscore-export`](../no-underscore-export.md) (R044)
+- [`etc-misc/no-unnecessary-as-const`](../no-unnecessary-as-const.md) (R045)
+- [`etc-misc/no-unnecessary-break`](../no-unnecessary-break.md) (R046)
+- [`etc-misc/no-unnecessary-initialization`](../no-unnecessary-initialization.md) (R047)
+- [`etc-misc/no-unnecessary-template-literal`](../no-unnecessary-template-literal.md) (R048)
+- [`etc-misc/no-unused-disable`](../no-unused-disable.md) (R049)
+- [`etc-misc/no-useless-generics`](../no-useless-generics.md) (R050)
+- [`etc-misc/no-value-tostring`](../no-value-tostring.md) (R051)
+- [`etc-misc/no-writeonly`](../no-writeonly.md) (R052)
+- [`etc-misc/object-format`](../object-format.md) (R053)
+- [`etc-misc/only-export-name`](../only-export-name.md) (R054)
+- [`etc-misc/prefer-arrow-function-property`](../prefer-arrow-function-property.md) (R055)
+- [`etc-misc/prefer-const-require`](../prefer-const-require.md) (R056)
+- [`etc-misc/prefer-includes`](../prefer-includes.md) (R057)
+- [`etc-misc/prefer-interface`](../prefer-interface.md) (R058)
+- [`etc-misc/prefer-less-than`](../prefer-less-than.md) (R059)
+- [`etc-misc/prefer-object-has-own`](../prefer-object-has-own.md) (R060)
+- [`etc-misc/prefer-only-export`](../prefer-only-export.md) (R061)
+- [`etc-misc/require-jsdoc`](../require-jsdoc.md) (R062)
+- [`etc-misc/require-syntax`](../require-syntax.md) (R063)
+- [`etc-misc/restrict-identifier-characters`](../restrict-identifier-characters.md) (R064)
+- [`etc-misc/sort-array`](../sort-array.md) (R065)
+- [`etc-misc/sort-call-signature`](../sort-call-signature.md) (R066)
+- [`etc-misc/sort-class-members`](../sort-class-members.md) (R067)
+- [`etc-misc/sort-construct-signature`](../sort-construct-signature.md) (R068)
+- [`etc-misc/sort-export-specifiers`](../sort-export-specifiers.md) (R069)
+- [`etc-misc/sort-keys`](../sort-keys.md) (R070)
+- [`etc-misc/sort-top-comments`](../sort-top-comments.md) (R071)
+- [`etc-misc/switch-case-spacing`](../switch-case-spacing.md) (R072)
+- [`etc-misc/template-literal-format`](../template-literal-format.md) (R073)
+- [`etc-misc/throw-error`](../throw-error.md) (R074)
+- [`etc-misc/throw-new-error`](../throw-new-error.md) (R075)
+- [`etc-misc/typescript/array-callback-return-type`](../typescript-array-callback-return-type.md) (R080)
+- [`etc-misc/typescript/class-methods-use-this`](../typescript-class-methods-use-this.md) (R081)
+- [`etc-misc/typescript/consistent-array-type-name`](../typescript-consistent-array-type-name.md) (R082)
+- [`etc-misc/typescript/define-function-in-one-statement`](../typescript-define-function-in-one-statement.md) (R083)
+- [`etc-misc/typescript/exhaustive-switch`](../typescript-exhaustive-switch.md) (R084)
+- [`etc-misc/typescript/no-boolean-literal-type`](../typescript-no-boolean-literal-type.md) (R085)
+- [`etc-misc/typescript/no-complex-declarator-type`](../typescript-no-complex-declarator-type.md) (R086)
+- [`etc-misc/typescript/no-complex-return-type`](../typescript-no-complex-return-type.md) (R087)
+- [`etc-misc/typescript/no-empty-interfaces`](../typescript-no-empty-interfaces.md) (R088)
+- [`etc-misc/typescript/no-inferrable-types`](../typescript-no-inferrable-types.md) (R089)
+- [`etc-misc/typescript/no-multi-type-tuples`](../typescript-no-multi-type-tuples.md) (R090)
+- [`etc-misc/typescript/no-never`](../typescript-no-never.md) (R091)
+- [`etc-misc/typescript/no-redundant-undefined-const`](../typescript-no-redundant-undefined-const.md) (R092)
+- [`etc-misc/typescript/no-redundant-undefined-default-parameter`](../typescript-no-redundant-undefined-default-parameter.md) (R093)
+- [`etc-misc/typescript/no-redundant-undefined-let`](../typescript-no-redundant-undefined-let.md) (R094)
+- [`etc-misc/typescript/no-redundant-undefined-optional`](../typescript-no-redundant-undefined-optional.md) (R095)
+- [`etc-misc/typescript/no-redundant-undefined-promise-return-type`](../typescript-no-redundant-undefined-promise-return-type.md) (R096)
+- [`etc-misc/typescript/no-redundant-undefined-readonly-property`](../typescript-no-redundant-undefined-readonly-property.md) (R097)
+- [`etc-misc/typescript/no-redundant-undefined-return-type`](../typescript-no-redundant-undefined-return-type.md) (R098)
+- [`etc-misc/typescript/no-redundant-undefined-var`](../typescript-no-redundant-undefined-var.md) (R099)
+- [`etc-misc/typescript/no-restricted-syntax`](../typescript-no-restricted-syntax.md) (R100)
+- [`etc-misc/typescript/no-unsafe-object-assign`](../typescript-no-unsafe-object-assign.md) (R101)
+- [`etc-misc/typescript/no-unsafe-object-assignment`](../typescript-no-unsafe-object-assignment.md) (R102)
+- [`etc-misc/typescript/prefer-array-type-alias`](../typescript-prefer-array-type-alias.md) (R103)
+- [`etc-misc/typescript/prefer-class-method`](../typescript-prefer-class-method.md) (R104)
+- [`etc-misc/typescript/prefer-enum`](../typescript-prefer-enum.md) (R105)
+- [`etc-misc/typescript/prefer-named-tuple-members`](../typescript-prefer-named-tuple-members.md) (R106)
+- [`etc-misc/typescript/prefer-readonly-array-parameter`](../typescript-prefer-readonly-array-parameter.md) (R108)
+- [`etc-misc/typescript/prefer-readonly-array`](../typescript-prefer-readonly-array.md) (R107)
+- [`etc-misc/typescript/prefer-readonly-index-signature`](../typescript-prefer-readonly-index-signature.md) (R109)
+- [`etc-misc/typescript/prefer-readonly-map`](../typescript-prefer-readonly-map.md) (R110)
+- [`etc-misc/typescript/prefer-readonly-property`](../typescript-prefer-readonly-property.md) (R111)
+- [`etc-misc/typescript/prefer-readonly-record`](../typescript-prefer-readonly-record.md) (R112)
+- [`etc-misc/typescript/prefer-readonly-set`](../typescript-prefer-readonly-set.md) (R113)
+- [`etc-misc/typescript/require-prop-type-annotation`](../typescript-require-prop-type-annotation.md) (R114)
+- [`etc-misc/typescript/require-readonly-array-property-type`](../typescript-require-readonly-array-property-type.md) (R115)
+- [`etc-misc/typescript/require-readonly-array-return-type`](../typescript-require-readonly-array-return-type.md) (R116)
+- [`etc-misc/typescript/require-readonly-array-type-alias`](../typescript-require-readonly-array-type-alias.md) (R117)
+- [`etc-misc/typescript/require-readonly-map-parameter-type`](../typescript-require-readonly-map-parameter-type.md) (R118)
+- [`etc-misc/typescript/require-readonly-map-property-type`](../typescript-require-readonly-map-property-type.md) (R119)
+- [`etc-misc/typescript/require-readonly-map-return-type`](../typescript-require-readonly-map-return-type.md) (R120)
+- [`etc-misc/typescript/require-readonly-map-type-alias`](../typescript-require-readonly-map-type-alias.md) (R121)
+- [`etc-misc/typescript/require-readonly-record-parameter-type`](../typescript-require-readonly-record-parameter-type.md) (R122)
+- [`etc-misc/typescript/require-readonly-record-property-type`](../typescript-require-readonly-record-property-type.md) (R123)
+- [`etc-misc/typescript/require-readonly-record-return-type`](../typescript-require-readonly-record-return-type.md) (R124)
+- [`etc-misc/typescript/require-readonly-record-type-alias`](../typescript-require-readonly-record-type-alias.md) (R125)
+- [`etc-misc/typescript/require-readonly-set-parameter-type`](../typescript-require-readonly-set-parameter-type.md) (R126)
+- [`etc-misc/typescript/require-readonly-set-property-type`](../typescript-require-readonly-set-property-type.md) (R127)
+- [`etc-misc/typescript/require-readonly-set-return-type`](../typescript-require-readonly-set-return-type.md) (R128)
+- [`etc-misc/typescript/require-readonly-set-type-alias`](../typescript-require-readonly-set-type-alias.md) (R129)
+- [`etc-misc/typescript/require-this-void`](../typescript-require-this-void.md) (R130)
+- [`etc-misc/underscore-internal`](../underscore-internal.md) (R076)
+- [`etc-misc/unused-internal-properties`](../unused-internal-properties.md) (R077)
+- [`etc-misc/uppercase-iife`](../uppercase-iife.md) (R078)
+- [`etc-misc/words`](../words.md) (R079)
+
+## Adoption guidance
+
+Use this as the strictest preset when you want broad coverage and hard
+enforcement of non-deprecated rules.

package/docs/rules/presets/all.md

@@ -0,0 +1,177 @@
+---
+title: All preset
+---
+
+# 🟣 All
+
+Use this preset when you want every rule exported by `eslint-plugin-etc-misc`.
+
+## Config key
+
+```ts
+etcMisc.configs.all
+```
+
+## Flat Config example
+
+```ts
+import etcMisc from "eslint-plugin-etc-misc";
+
+export default [etcMisc.configs.all];
+```
+
+## What it enables
+
+- Every rule under `src/rules/*.ts`.
+- Full plugin namespace coverage with `etc-misc/<rule-id>` entries.
+- A total of **115 rules** (79 core + 36 TypeScript-scoped).
+
+## Rules in this preset
+
+### Core rules
+
+- [`etc-misc/array-type`](../array-type.md) (R001)
+- [`etc-misc/class-match-filename`](../class-match-filename.md) (R002)
+- [`etc-misc/comment-spacing`](../comment-spacing.md) (R003)
+- [`etc-misc/consistent-empty-lines`](../consistent-empty-lines.md) (R004)
+- [`etc-misc/consistent-enum-members`](../consistent-enum-members.md) (R005)
+- [`etc-misc/consistent-filename`](../consistent-filename.md) (R006)
+- [`etc-misc/consistent-import`](../consistent-import.md) (R007)
+- [`etc-misc/consistent-optional-props`](../consistent-optional-props.md) (R008)
+- [`etc-misc/consistent-source-extension`](../consistent-source-extension.md) (R009)
+- [`etc-misc/consistent-symbol-description`](../consistent-symbol-description.md) (R010)
+- [`etc-misc/default-case`](../default-case.md) (R011)
+- [`etc-misc/disallow-import`](../disallow-import.md) (R012)
+- [`etc-misc/export-matching-filename-only`](../export-matching-filename-only.md) (R013)
+- [`etc-misc/match-filename`](../match-filename.md) (R014)
+- [`etc-misc/max-identifier-blocks`](../max-identifier-blocks.md) (R015)
+- [`etc-misc/no-assign-mutated-array`](../no-assign-mutated-array.md) (R016)
+- [`etc-misc/no-at-sign-import`](../no-at-sign-import.md) (R017)
+- [`etc-misc/no-at-sign-internal-import`](../no-at-sign-internal-import.md) (R018)
+- [`etc-misc/no-chain-coalescence-mixture`](../no-chain-coalescence-mixture.md) (R019)
+- [`etc-misc/no-commented-out-code`](../no-commented-out-code.md) (R020)
+- [`etc-misc/no-const-enum`](../no-const-enum.md) (R021)
+- [`etc-misc/no-deprecated`](../no-deprecated.md) (R022)
+- [`etc-misc/no-enum`](../no-enum.md) (R023)
+- [`etc-misc/no-expression-empty-lines`](../no-expression-empty-lines.md) (R024)
+- [`etc-misc/no-foreach`](../no-foreach.md) (R025)
+- [`etc-misc/no-implicit-any-catch`](../no-implicit-any-catch.md) (R026)
+- [`etc-misc/no-index-import`](../no-index-import.md) (R027)
+- [`etc-misc/no-internal`](../no-internal.md) (R028)
+- [`etc-misc/no-internal-modules`](../no-internal-modules.md) (R029)
+- [`etc-misc/no-language-mixing`](../no-language-mixing.md) (R030)
+- [`etc-misc/no-misused-generics`](../no-misused-generics.md) (R031)
+- [`etc-misc/no-mixed-enums`](../no-mixed-enums.md) (R032)
+- [`etc-misc/no-negated-conditions`](../no-negated-conditions.md) (R033)
+- [`etc-misc/no-nodejs-modules`](../no-nodejs-modules.md) (R034)
+- [`etc-misc/no-param-reassign`](../no-param-reassign.md) (R035)
+- [`etc-misc/no-relative-parent-import`](../no-relative-parent-import.md) (R036)
+- [`etc-misc/no-restricted-syntax`](../no-restricted-syntax.md) (R037)
+- [`etc-misc/no-secret`](../no-secret.md) (R038)
+- [`etc-misc/no-self-import`](../no-self-import.md) (R039)
+- [`etc-misc/no-shadow`](../no-shadow.md) (R040)
+- [`etc-misc/no-sibling-import`](../no-sibling-import.md) (R041)
+- [`etc-misc/no-single-line-comment`](../no-single-line-comment.md) (R042)
+- [`etc-misc/no-t`](../no-t.md) (R043)
+- [`etc-misc/no-underscore-export`](../no-underscore-export.md) (R044)
+- [`etc-misc/no-unnecessary-as-const`](../no-unnecessary-as-const.md) (R045)
+- [`etc-misc/no-unnecessary-break`](../no-unnecessary-break.md) (R046)
+- [`etc-misc/no-unnecessary-initialization`](../no-unnecessary-initialization.md) (R047)
+- [`etc-misc/no-unnecessary-template-literal`](../no-unnecessary-template-literal.md) (R048)
+- [`etc-misc/no-unused-disable`](../no-unused-disable.md) (R049)
+- [`etc-misc/no-useless-generics`](../no-useless-generics.md) (R050)
+- [`etc-misc/no-value-tostring`](../no-value-tostring.md) (R051)
+- [`etc-misc/no-writeonly`](../no-writeonly.md) (R052)
+- [`etc-misc/object-format`](../object-format.md) (R053)
+- [`etc-misc/only-export-name`](../only-export-name.md) (R054)
+- [`etc-misc/prefer-arrow-function-property`](../prefer-arrow-function-property.md) (R055)
+- [`etc-misc/prefer-const-require`](../prefer-const-require.md) (R056)
+- [`etc-misc/prefer-includes`](../prefer-includes.md) (R057)
+- [`etc-misc/prefer-interface`](../prefer-interface.md) (R058)
+- [`etc-misc/prefer-less-than`](../prefer-less-than.md) (R059)
+- [`etc-misc/prefer-object-has-own`](../prefer-object-has-own.md) (R060)
+- [`etc-misc/prefer-only-export`](../prefer-only-export.md) (R061)
+- [`etc-misc/require-jsdoc`](../require-jsdoc.md) (R062)
+- [`etc-misc/require-syntax`](../require-syntax.md) (R063)
+- [`etc-misc/restrict-identifier-characters`](../restrict-identifier-characters.md) (R064)
+- [`etc-misc/sort-array`](../sort-array.md) (R065)
+- [`etc-misc/sort-call-signature`](../sort-call-signature.md) (R066)
+- [`etc-misc/sort-class-members`](../sort-class-members.md) (R067)
+- [`etc-misc/sort-construct-signature`](../sort-construct-signature.md) (R068)
+- [`etc-misc/sort-export-specifiers`](../sort-export-specifiers.md) (R069)
+- [`etc-misc/sort-keys`](../sort-keys.md) (R070)
+- [`etc-misc/sort-top-comments`](../sort-top-comments.md) (R071)
+- [`etc-misc/switch-case-spacing`](../switch-case-spacing.md) (R072)
+- [`etc-misc/template-literal-format`](../template-literal-format.md) (R073)
+- [`etc-misc/throw-error`](../throw-error.md) (R074)
+- [`etc-misc/throw-new-error`](../throw-new-error.md) (R075)
+- [`etc-misc/underscore-internal`](../underscore-internal.md) (R076)
+- [`etc-misc/unused-internal-properties`](../unused-internal-properties.md) (R077)
+- [`etc-misc/uppercase-iife`](../uppercase-iife.md) (R078)
+- [`etc-misc/words`](../words.md) (R079)
+
+### TypeScript-scoped rules
+
+- [`etc-misc/typescript/array-callback-return-type`](../typescript-array-callback-return-type.md) (R080)
+- [`etc-misc/typescript/class-methods-use-this`](../typescript-class-methods-use-this.md) (R081)
+- [`etc-misc/typescript/consistent-array-type-name`](../typescript-consistent-array-type-name.md) (R082)
+- [`etc-misc/typescript/define-function-in-one-statement`](../typescript-define-function-in-one-statement.md) (R083)
+- [`etc-misc/typescript/exhaustive-switch`](../typescript-exhaustive-switch.md) (R084)
+- [`etc-misc/typescript/no-boolean-literal-type`](../typescript-no-boolean-literal-type.md) (R085)
+- [`etc-misc/typescript/no-complex-declarator-type`](../typescript-no-complex-declarator-type.md) (R086)
+- [`etc-misc/typescript/no-complex-return-type`](../typescript-no-complex-return-type.md) (R087)
+- [`etc-misc/typescript/no-empty-interfaces`](../typescript-no-empty-interfaces.md) (R088)
+- [`etc-misc/typescript/no-inferrable-types`](../typescript-no-inferrable-types.md) (R089)
+- [`etc-misc/typescript/no-multi-type-tuples`](../typescript-no-multi-type-tuples.md) (R090)
+- [`etc-misc/typescript/no-never`](../typescript-no-never.md) (R091)
+- [`etc-misc/typescript/no-redundant-undefined-const`](../typescript-no-redundant-undefined-const.md) (R092)
+- [`etc-misc/typescript/no-redundant-undefined-default-parameter`](../typescript-no-redundant-undefined-default-parameter.md) (R093)
+- [`etc-misc/typescript/no-redundant-undefined-let`](../typescript-no-redundant-undefined-let.md) (R094)
+- [`etc-misc/typescript/no-redundant-undefined-optional`](../typescript-no-redundant-undefined-optional.md) (R095)
+- [`etc-misc/typescript/no-redundant-undefined-promise-return-type`](../typescript-no-redundant-undefined-promise-return-type.md) (R096)
+- [`etc-misc/typescript/no-redundant-undefined-readonly-property`](../typescript-no-redundant-undefined-readonly-property.md) (R097)
+- [`etc-misc/typescript/no-redundant-undefined-return-type`](../typescript-no-redundant-undefined-return-type.md) (R098)
+- [`etc-misc/typescript/no-redundant-undefined-var`](../typescript-no-redundant-undefined-var.md) (R099)
+- [`etc-misc/typescript/no-restricted-syntax`](../typescript-no-restricted-syntax.md) (R100)
+- [`etc-misc/typescript/no-unsafe-object-assign`](../typescript-no-unsafe-object-assign.md) (R101)
+- [`etc-misc/typescript/no-unsafe-object-assignment`](../typescript-no-unsafe-object-assignment.md) (R102)
+- [`etc-misc/typescript/prefer-array-type-alias`](../typescript-prefer-array-type-alias.md) (R103)
+- [`etc-misc/typescript/prefer-class-method`](../typescript-prefer-class-method.md) (R104)
+- [`etc-misc/typescript/prefer-enum`](../typescript-prefer-enum.md) (R105)
+- [`etc-misc/typescript/prefer-named-tuple-members`](../typescript-prefer-named-tuple-members.md) (R106)
+- [`etc-misc/typescript/prefer-readonly-array`](../typescript-prefer-readonly-array.md) (R107)
+- [`etc-misc/typescript/prefer-readonly-array-parameter`](../typescript-prefer-readonly-array-parameter.md) (R108)
+- [`etc-misc/typescript/prefer-readonly-index-signature`](../typescript-prefer-readonly-index-signature.md) (R109)
+- [`etc-misc/typescript/prefer-readonly-map`](../typescript-prefer-readonly-map.md) (R110)
+- [`etc-misc/typescript/prefer-readonly-property`](../typescript-prefer-readonly-property.md) (R111)
+- [`etc-misc/typescript/prefer-readonly-record`](../typescript-prefer-readonly-record.md) (R112)
+- [`etc-misc/typescript/prefer-readonly-set`](../typescript-prefer-readonly-set.md) (R113)
+- [`etc-misc/typescript/require-prop-type-annotation`](../typescript-require-prop-type-annotation.md) (R114)
+- [`etc-misc/typescript/require-readonly-array-property-type`](../typescript-require-readonly-array-property-type.md) (R115)
+- [`etc-misc/typescript/require-readonly-array-return-type`](../typescript-require-readonly-array-return-type.md) (R116)
+- [`etc-misc/typescript/require-readonly-array-type-alias`](../typescript-require-readonly-array-type-alias.md) (R117)
+- [`etc-misc/typescript/require-readonly-map-parameter-type`](../typescript-require-readonly-map-parameter-type.md) (R118)
+- [`etc-misc/typescript/require-readonly-map-property-type`](../typescript-require-readonly-map-property-type.md) (R119)
+- [`etc-misc/typescript/require-readonly-map-return-type`](../typescript-require-readonly-map-return-type.md) (R120)
+- [`etc-misc/typescript/require-readonly-map-type-alias`](../typescript-require-readonly-map-type-alias.md) (R121)
+- [`etc-misc/typescript/require-readonly-record-parameter-type`](../typescript-require-readonly-record-parameter-type.md) (R122)
+- [`etc-misc/typescript/require-readonly-record-property-type`](../typescript-require-readonly-record-property-type.md) (R123)
+- [`etc-misc/typescript/require-readonly-record-return-type`](../typescript-require-readonly-record-return-type.md) (R124)
+- [`etc-misc/typescript/require-readonly-record-type-alias`](../typescript-require-readonly-record-type-alias.md) (R125)
+- [`etc-misc/typescript/require-readonly-set-parameter-type`](../typescript-require-readonly-set-parameter-type.md) (R126)
+- [`etc-misc/typescript/require-readonly-set-property-type`](../typescript-require-readonly-set-property-type.md) (R127)
+- [`etc-misc/typescript/require-readonly-set-return-type`](../typescript-require-readonly-set-return-type.md) (R128)
+- [`etc-misc/typescript/require-readonly-set-type-alias`](../typescript-require-readonly-set-type-alias.md) (R129)
+- [`etc-misc/typescript/require-this-void`](../typescript-require-this-void.md) (R130)
+
+## Adoption guidance
+
+Start with `recommended` first unless your project is already prepared for broad
+lint enforcement. `all` is best for teams that prefer maximum rule coverage and
+can commit to rule-by-rule tuning where needed.
+
+## Related pages
+
+- [Overview](../overview.md)
+- [Getting Started](../getting-started.md)
+- [Rule Reference](../)

package/docs/rules/presets/recommended.md

@@ -0,0 +1,55 @@
+---
+title: Recommended preset
+---
+
+# 🟡 Recommended
+
+Use this preset as the default onboarding path for most projects.
+
+## Config key
+
+```ts
+etcMisc.configs.recommended
+```
+
+## Flat Config example
+
+```ts
+import etcMisc from "eslint-plugin-etc-misc";
+
+export default [etcMisc.configs.recommended];
+```
+
+## Rules in this preset
+
+- [`etc-misc/consistent-optional-props`](../consistent-optional-props.md) (R008)
+- [`etc-misc/no-assign-mutated-array`](../no-assign-mutated-array.md) (R016)
+- [`etc-misc/no-const-enum`](../no-const-enum.md) (R021)
+- [`etc-misc/no-implicit-any-catch`](../no-implicit-any-catch.md) (R026)
+- [`etc-misc/no-internal`](../no-internal.md) (R028)
+- [`etc-misc/no-t`](../no-t.md) (R043)
+- [`etc-misc/no-unnecessary-as-const`](../no-unnecessary-as-const.md) (R045)
+- [`etc-misc/no-unnecessary-break`](../no-unnecessary-break.md) (R046)
+- [`etc-misc/no-unnecessary-initialization`](../no-unnecessary-initialization.md) (R047)
+- [`etc-misc/no-unnecessary-template-literal`](../no-unnecessary-template-literal.md) (R048)
+- [`etc-misc/throw-error`](../throw-error.md) (R074)
+- [`etc-misc/typescript/no-boolean-literal-type`](../typescript-no-boolean-literal-type.md) (R085)
+- [`etc-misc/typescript/prefer-readonly-array-parameter`](../typescript-prefer-readonly-array-parameter.md) (R108)
+- [`etc-misc/typescript/prefer-readonly-array`](../typescript-prefer-readonly-array.md) (R107)
+- [`etc-misc/typescript/prefer-readonly-index-signature`](../typescript-prefer-readonly-index-signature.md) (R109)
+- [`etc-misc/typescript/prefer-readonly-map`](../typescript-prefer-readonly-map.md) (R110)
+- [`etc-misc/typescript/prefer-readonly-property`](../typescript-prefer-readonly-property.md) (R111)
+- [`etc-misc/typescript/prefer-readonly-record`](../typescript-prefer-readonly-record.md) (R112)
+- [`etc-misc/typescript/prefer-readonly-set`](../typescript-prefer-readonly-set.md) (R113)
+- [`etc-misc/typescript/require-readonly-array-return-type`](../typescript-require-readonly-array-return-type.md) (R116)
+- [`etc-misc/typescript/require-this-void`](../typescript-require-this-void.md) (R130)
+
+## Adoption guidance
+
+This preset now enables a wider "safe baseline" mix:
+
+- strong correctness rules as `error`
+- low-risk style/maintainability rules as `warn`
+
+Start with this preset, then promote selected `warn` rules to `error` as your
+codebase stabilizes.

package/docs/rules/presets/strict-type-checked.md

@@ -0,0 +1,66 @@
+---
+title: Strict Type-Checked preset
+---
+
+# 🔵 Strict Type-Checked
+
+Use this preset when you want strict linting plus additional non-deprecated
+rules that require TypeScript type information.
+
+## Config key
+
+```ts
+etcMisc.configs.strictTypeChecked
+```
+
+## Flat Config example
+
+```ts
+import etcMisc from "eslint-plugin-etc-misc";
+
+export default [etcMisc.configs.strictTypeChecked];
+```
+
+## Type information requirement
+
+⚠️ This preset is type-aware and includes
+`languageOptions.parserOptions.projectService: true`.
+
+If your project uses custom parser options, merge this preset with your own
+`languageOptions` so full type information remains available.
+
+## Rules in this preset
+
+- [`etc-misc/consistent-optional-props`](../consistent-optional-props.md) (R008)
+- [`etc-misc/no-assign-mutated-array`](../no-assign-mutated-array.md) (R016)
+- [`etc-misc/no-const-enum`](../no-const-enum.md) (R021)
+- [`etc-misc/no-foreach`](../no-foreach.md) (R025)
+- [`etc-misc/no-implicit-any-catch`](../no-implicit-any-catch.md) (R026)
+- [`etc-misc/no-internal`](../no-internal.md) (R028)
+- [`etc-misc/no-misused-generics`](../no-misused-generics.md) (R031)
+- [`etc-misc/no-t`](../no-t.md) (R043)
+- [`etc-misc/no-unnecessary-as-const`](../no-unnecessary-as-const.md) (R045)
+- [`etc-misc/no-unnecessary-break`](../no-unnecessary-break.md) (R046)
+- [`etc-misc/no-unnecessary-initialization`](../no-unnecessary-initialization.md) (R047)
+- [`etc-misc/no-unnecessary-template-literal`](../no-unnecessary-template-literal.md) (R048)
+- [`etc-misc/throw-error`](../throw-error.md) (R074)
+- [`etc-misc/typescript/array-callback-return-type`](../typescript-array-callback-return-type.md) (R080)
+- [`etc-misc/typescript/no-boolean-literal-type`](../typescript-no-boolean-literal-type.md) (R085)
+- [`etc-misc/typescript/no-never`](../typescript-no-never.md) (R091)
+- [`etc-misc/typescript/no-unsafe-object-assign`](../typescript-no-unsafe-object-assign.md) (R101)
+- [`etc-misc/typescript/no-unsafe-object-assignment`](../typescript-no-unsafe-object-assignment.md) (R102)
+- [`etc-misc/typescript/prefer-enum`](../typescript-prefer-enum.md) (R105)
+- [`etc-misc/typescript/prefer-readonly-array-parameter`](../typescript-prefer-readonly-array-parameter.md) (R108)
+- [`etc-misc/typescript/prefer-readonly-array`](../typescript-prefer-readonly-array.md) (R107)
+- [`etc-misc/typescript/prefer-readonly-index-signature`](../typescript-prefer-readonly-index-signature.md) (R109)
+- [`etc-misc/typescript/prefer-readonly-map`](../typescript-prefer-readonly-map.md) (R110)
+- [`etc-misc/typescript/prefer-readonly-property`](../typescript-prefer-readonly-property.md) (R111)
+- [`etc-misc/typescript/prefer-readonly-record`](../typescript-prefer-readonly-record.md) (R112)
+- [`etc-misc/typescript/prefer-readonly-set`](../typescript-prefer-readonly-set.md) (R113)
+- [`etc-misc/typescript/require-readonly-array-return-type`](../typescript-require-readonly-array-return-type.md) (R116)
+- [`etc-misc/typescript/require-this-void`](../typescript-require-this-void.md) (R130)
+
+## Adoption guidance
+
+Adopt this preset when your project is fully type-aware and you want stronger
+semantic enforcement before moving to all-rule coverage.