Merge branch 'main'

Author: JoshuaKGoldberg

.gitignore

@@ -6,6 +6,7 @@ yarn-debug.log*
 yarn-error.log*
 
 # Website
+docs/packages/*/generated
 packages/website/.docusaurus
 packages/website/.cache-loader
 packages/website/build

CHANGELOG.md

@@ -1,3 +1,26 @@
+## 7.18.0 (2024-07-29)
+
+
+### 🚀 Features
+
+- **types:** update ECMA versions ([#9634](https://github.com/typescript-eslint/typescript-eslint/pull/9634))
+
+### 🩹 Fixes
+
+- **eslint-plugin:** [no-unnecessary-type-assertion] prevent runtime error when asserting a variable declared in default TS lib ([#9660](https://github.com/typescript-eslint/typescript-eslint/pull/9660))
+- **eslint-plugin:** [unbound-method] report on destructuring in function parameters ([#8952](https://github.com/typescript-eslint/typescript-eslint/pull/8952))
+- **eslint-plugin:** [no-duplicate-type-constituents] shouldn't report on error types ([#9600](https://github.com/typescript-eslint/typescript-eslint/pull/9600))
+- **eslint-plugin:** [strict-boolean-expressions] support branded booleans ([#9297](https://github.com/typescript-eslint/typescript-eslint/pull/9297))
+
+### ❤️  Thank You
+
+- auvred @auvred
+- Oliver Salzburg
+- Vinccool96
+- Yukihiro Hasegawa @y-hsgw
+
+You can read about our [versioning strategy](https://main--typescript-eslint.netlify.app/users/versioning) and [releases](https://main--typescript-eslint.netlify.app/users/releases) on our website.
+
 ## 7.17.0 (2024-07-22)
 
 

docs/getting-started/Typed_Linting.mdx

@@ -84,7 +84,7 @@ In more detail:
 
 :::caution
 Your ESLint config file may start receiving a parsing error about type information.
-See [our TSConfig inclusion FAQ](../troubleshooting/faqs/General.mdx#i-get-errors-telling-me-eslint-was-configured-to-run--however-that-tsconfig-does-not--none-of-those-tsconfigs-include-this-file).
+See [our TSConfig inclusion FAQ](../troubleshooting/typed-linting#i-get-errors-telling-me-eslint-was-configured-to-run--however-that-tsconfig-does-not--none-of-those-tsconfigs-include-this-file).
 :::
 
 With that done, run the same lint command you ran before.

docs/packages/Type_Utils.mdx

@@ -1,20 +1,31 @@
 ---
 id: type-utils
 sidebar_label: type-utils
+toc_max_heading_level: 3
 ---
 
+import GeneratedDocs from './type-utils/generated/index.md';
+
 # `@typescript-eslint/type-utils`
 
 <PackageLink packageName="type-utils" scope="@typescript-eslint" />
 
-> Type utilities for working with TypeScript within ESLint rules. ✨
+> Type utilities for working with TypeScript types ✨
 
-This package contains public utilities for working with TypeScript types that ESLint rules often use.
+This package contains public utilities for working with TypeScript types.
 Rules declared in [`@typescript-eslint/eslint-plugin`](./ESLint_Plugin.mdx) use these utility functions.
 
 The utilities in this package are both:
 
 - More generally ESLint-focused than the broad TypeScript utilities in [`ts-api-utils`](https://npmjs.com/package/ts-api-utils)
 - Separated from [`@typescript-eslint/utils`](./Utils.mdx) so that that package does not require a dependency on `typescript`
 
-> See [Custom Rules](../developers/Custom_Rules.mdx) for documentation on creating your own custom ESLint rules for TypeScript code.
+:::tip
+See [Custom Rules](../developers/Custom_Rules.mdx) for documentation on creating your own custom ESLint rules for TypeScript code.
+:::
+
+---
+
+The following documentation is auto-generated from source code.
+
+<GeneratedDocs />

docs/packages/Utils.mdx

@@ -1,6 +1,7 @@
 ---
 id: utils
 sidebar_label: utils
+toc_max_heading_level: 3
 ---
 
 # `@typescript-eslint/utils`

docs/packages/typescript-estree/AST_Spec.mdx

@@ -0,0 +1,13 @@
+---
+id: ast-spec
+sidebar_label: AST Specification
+toc_max_heading_level: 3
+---
+
+import GeneratedDocs from '../ast-spec/generated/index.md';
+
+# AST Specification
+
+The following auto-generated documentation describes the Abstract Syntax Tree (AST) generated by [`@typescript-eslint/typescript-estree`](../TypeScript_ESTree.mdx) for parsers such as [`@typescript-eslint/parser`](../Parser.mdx).
+
+<GeneratedDocs />

knip.ts

@@ -97,6 +97,9 @@ export default {
         '@generated/docusaurus.config',
         '^@theme/.*',
         '^@theme-original/.*',
+        'docusaurus-plugin-typedoc',
+        'typedoc',
+        'typedoc-plugin-markdown',
       ],
     },
     'packages/website-eslint': {

packages/ast-spec/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 7.18.0 (2024-07-29)
+
+This was a version bump only for ast-spec to align it with other projects, there were no code changes.
+
+You can read about our [versioning strategy](https://main--typescript-eslint.netlify.app/users/versioning) and [releases](https://main--typescript-eslint.netlify.app/users/releases) on our website.
+
 ## 7.17.0 (2024-07-22)
 
 This was a version bump only for ast-spec to align it with other projects, there were no code changes.

packages/ast-spec/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typescript-eslint/ast-spec",
-  "version": "7.17.0",
+  "version": "7.18.0",
   "description": "Complete specification for the TypeScript-ESTree AST",
   "private": true,
   "keywords": [

packages/ast-spec/src/ast-node-types.ts

@@ -88,9 +88,9 @@ export enum AST_NODE_TYPES {
   WhileStatement = 'WhileStatement',
   WithStatement = 'WithStatement',
   YieldExpression = 'YieldExpression',
-  /**
-   * TS-prefixed nodes
-   */
+
+  // TS_prefixed nodes
+
   TSAbstractAccessorProperty = 'TSAbstractAccessorProperty',
   TSAbstractKeyword = 'TSAbstractKeyword',
   TSAbstractMethodDefinition = 'TSAbstractMethodDefinition',