feat(eslint-plugin): [require-types-exports] add new rule

packages/eslint-plugin/docs/rules/require-types-exports.mdx

@@ -0,0 +1,80 @@
+---
+description: 'Require exporting types that are used in exported entities.'
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+> 🛑 This file is source code, not the primary documentation location! 🛑
+>
+> See **https://typescript-eslint.io/rules/require-types-exports** for documentation.
+
+When exporting entities from a module, it is recommended to export also all the
+types that are used in their declarations. This is useful for consumers of the
+module, as it allows them to use the types in their own code without having to
+use utility types like [`Parameters`](https://www.typescriptlang.org/docs/handbook/utility-types.html#parameterstype)
+or [`ReturnType`](https://www.typescriptlang.org/docs/handbook/utility-types.html#returntypetype)
+in order to extract the types from your code.
+
+## Examples
+
+<Tabs>
+<TabItem value="❌ Incorrect">
+
+```ts
+type Arg = string;
+type Result = number;
+
+export function strLength(arg: Arg): Result {
+  return arg.length;
+}
+
+interface Fruit {
+  name: string;
+  color: string;
+}
+
+export const getFruitName = (fruit: Fruit) => fruit.name;
+
+enum Color {
+  Red = 'red',
+  Green = 'green',
+  Blue = 'blue',
+}
+
+export declare function getRandomColor(): Color;
+```
+
+</TabItem>
+<TabItem value="✅ Correct">
+
+```ts
+export type Arg = string;
+export type Result = number;
+
+export function strLength(arg: Arg): Result {
+  return arg.length;
+}
+
+export interface Fruit {
+  name: string;
+  color: string;
+}
+
+export const getFruitName = (fruit: Fruit) => fruit.name;
+
+export enum Color {
+  Red = 'red',
+  Green = 'green',
+  Blue = 'blue',
+}
+
+export declare function getRandomColor(): Color;
+```
+
+</TabItem>
+</Tabs>
+
+## When Not To Use It
+
+When you don't want to enforce exporting types that are used in exported functions declarations.

packages/eslint-plugin/src/configs/all.ts

@@ -143,6 +143,7 @@ export = {
     '@typescript-eslint/require-array-sort-compare': 'error',
     'require-await': 'off',
     '@typescript-eslint/require-await': 'error',
+    '@typescript-eslint/require-types-exports': 'error',
     '@typescript-eslint/restrict-plus-operands': 'error',
     '@typescript-eslint/restrict-template-expressions': 'error',
     'no-return-await': 'off',

packages/eslint-plugin/src/configs/disable-type-checked.ts

@@ -58,6 +58,7 @@ export = {
     '@typescript-eslint/promise-function-async': 'off',
     '@typescript-eslint/require-array-sort-compare': 'off',
     '@typescript-eslint/require-await': 'off',
+    '@typescript-eslint/require-types-exports': 'off',
     '@typescript-eslint/restrict-plus-operands': 'off',
     '@typescript-eslint/restrict-template-expressions': 'off',
     '@typescript-eslint/return-await': 'off',

packages/eslint-plugin/src/configs/strict-type-checked-only.ts

@@ -43,6 +43,7 @@ export = {
     '@typescript-eslint/prefer-return-this-type': 'error',
     'require-await': 'off',
     '@typescript-eslint/require-await': 'error',
+    '@typescript-eslint/require-types-exports': 'error',
     '@typescript-eslint/restrict-plus-operands': [
       'error',
       {

packages/eslint-plugin/src/configs/strict-type-checked.ts

@@ -73,6 +73,7 @@ export = {
     '@typescript-eslint/prefer-return-this-type': 'error',
     'require-await': 'off',
     '@typescript-eslint/require-await': 'error',
+    '@typescript-eslint/require-types-exports': 'error',
     '@typescript-eslint/restrict-plus-operands': [
       'error',
       {

packages/eslint-plugin/src/rules/index.ts

@@ -128,6 +128,7 @@ import promiseFunctionAsync from './promise-function-async';
 import quotes from './quotes';
 import requireArraySortCompare from './require-array-sort-compare';
 import requireAwait from './require-await';
+import requireTypesExports from './require-types-exports';
 import restrictPlusOperands from './restrict-plus-operands';
 import restrictTemplateExpressions from './restrict-template-expressions';
 import returnAwait from './return-await';
@@ -274,6 +275,7 @@ export default {
   quotes: quotes,
   'require-array-sort-compare': requireArraySortCompare,
   'require-await': requireAwait,
+  'require-types-exports': requireTypesExports,
   'restrict-plus-operands': restrictPlusOperands,
   'restrict-template-expressions': restrictTemplateExpressions,
   'return-await': returnAwait,