feat(typescript-estree): add package version to ts version warning (typescript-eslint#10343)

* feat(typescript-estree): add package version to ts version warning

* restore original phrase and fix package name typo

* update warn about ts version message

* correct message version

* Update docs/packages/Parser.mdx

---------

Co-authored-by: Josh Goldberg ✨ <[email protected]>

Author: marcalexiei

docs/packages/Parser.mdx

@@ -423,11 +423,9 @@ This option allows you to toggle the warning that the parser will give you if yo
 
 WARNING: You are currently running a version of TypeScript which is not officially supported by @typescript-eslint/typescript-estree.
 
-You may find that it works just fine, or you may not.
-
-SUPPORTED TYPESCRIPT VERSIONS: >=3.3.1 <5.1.0
-
-YOUR TYPESCRIPT VERSION: 5.1.3
+* @typescript-eslint/typescript-estree version: 8.15.0
+* Supported TypeScript versions: >=4.7.4 <5.7.0
+* Your TypeScript version: 5.7.1
 
 Please only submit bug reports when using the officially supported version.
 

packages/typescript-estree/src/index.ts

@@ -19,8 +19,5 @@ export type {
 export { simpleTraverse } from './simple-traverse';
 export * from './ts-estree';
 export { typescriptVersionIsAtLeast } from './version-check';
+export { version } from './version';
 export { withoutProjectParserOptions } from './withoutProjectParserOptions';
-
-// note - cannot migrate this to an import statement because it will make TSC copy the package.json to the dist folder
-// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
-export const version: string = require('../package.json').version;

packages/typescript-estree/src/parseSettings/warnAboutTSVersion.ts

@@ -3,6 +3,8 @@ import * as ts from 'typescript';
 
 import type { ParseSettings } from './index';
 
+import { version as TYPESCRIPT_ESTREE_VERSION } from '../version';
+
 /**
  * This needs to be kept in sync with package.json in the typescript-eslint monorepo
  */
@@ -38,13 +40,17 @@ export function warnAboutTSVersion(
     const border = '=============';
     const versionWarning = [
       border,
+      '\n',
       'WARNING: You are currently running a version of TypeScript which is not officially supported by @typescript-eslint/typescript-estree.',
-      'You may find that it works just fine, or you may not.',
-      `SUPPORTED TYPESCRIPT VERSIONS: ${SUPPORTED_TYPESCRIPT_VERSIONS}`,
-      `YOUR TYPESCRIPT VERSION: ${ACTIVE_TYPESCRIPT_VERSION}`,
+      '\n',
+      `* @typescript-eslint/typescript-estree version: ${TYPESCRIPT_ESTREE_VERSION}`,
+      `* Supported TypeScript versions: ${SUPPORTED_TYPESCRIPT_VERSIONS}`,
+      `* Your TypeScript version: ${ACTIVE_TYPESCRIPT_VERSION}`,
+      '\n',
       'Please only submit bug reports when using the officially supported version.',
+      '\n',
       border,
-    ].join('\n\n');
+    ].join('\n');
 
     parseSettings.log(versionWarning);
   }

packages/typescript-estree/src/version.ts

@@ -0,0 +1,3 @@
+// note - cannot migrate this to an import statement because it will make TSC copy the package.json to the dist folder
+// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+export const version: string = require('../package.json').version;

packages/typescript-estree/tests/lib/warn-on-unsupported-ts.test.ts

@@ -27,7 +27,7 @@ describe('Warn on unsupported TypeScript version', () => {
     parser.parse('');
     expect(console.log).toHaveBeenCalledWith(
       expect.stringContaining(
-        'WARNING: You are currently running a version of TypeScript which is not officially supported by @typescript-eslint/typescript-estree',
+        'WARNING: You are currently running a version of TypeScript which is not officially supported by @typescript-eslint/typescript-estree.',
       ),
     );
   });