# @putout/plugin-typescript [![NPM version][NPMIMGURL]][NPMURL]

[NPMIMGURL]: https://img.shields.io/npm/v/@putout/plugin-typescript.svg?style=flat&longCache=true
[NPMURL]: https://npmjs.org/package/@putout/plugin-typescript "npm"

> TypeScript is JavaScript with syntax for types.
>
> (c) [typescriptcriptlang.org](https://www.typescriptcriptlang.org)

🐊[**Putout**](https://github.com/coderaiser/putout) plugin adds ability to transform **TypeScript** code. Enabled by default for `ts` and `tsx` files.

## Install

```
npm i putout @putout/plugin-typescript -D
```

## Rules

- ✅ [apply-as-type-assertion](#apply-as-type-assertion);
- ✅ [apply-type-guards](#apply-type-guards);
- ✅ [apply-utility-types](#apply-utility-types);
- ✅ [convert-commonjs-to-esm](#convert-commonjs-to-esm);
- ✅ [convert-esm-to-commonjs](#convert-esm-to-commonjs);
- ✅ [convert-generic-to-shorthand](#convert-generic-to-shorthand);
- ✅ [convert-namespace-to-global](#convert-namespace-to-global);
- ✅ [convert-empty-type-literal-to-record](#convert-empty-type-literal-to-record);
- ✅ [cts-file](#cts-file);
- ✅ [find-file](#find-file);
- ✅ [mts-file](#mts-file);
- ✅ [remove-duplicate-exports](#remove-duplicate-exports);
- ✅ [remove-duplicate-interface-keys](#remove-duplicate-interface-keys);
- ✅ [remove-duplicates-from-union](#remove-duplicates-from-union);
- ✅ [remove-unused-types](#remove-unused-types);
- ✅ [remove-getter-arguments](#remove-getter-arguments);
- ✅ [remove-setter-return-type](#remove-setter-return-type);
- ✅ [remove-useless-mapped-types](#remove-useless-mapped-types);
- ✅ [remove-useless-mapping-modifiers](#remove-useless-mapping-modifiers);
- ✅ [remove-useless-non-null-expressions](#remove-useless-non-null-expressions);
- ✅ [remove-useless-parens](#remove-useless-parens);
- ✅ [remove-useless-promise](#remove-useless-promise);
- ✅ [remove-useless-types](#remove-useless-types);
- ✅ [remove-useless-types-from-constants](#remove-useless-types-from-constants);
- ✅ [rename-file-cts-to-ts](#rename-file-cts-to-ts);
- ✅ [rename-file-mts-to-ts](#rename-file-mts-to-ts);

## Config

```json
{
    "rules": {
        "typescript/apply-as-type-assertion": "on",
        "typescript/apply-utility-types": "on",
        "typescript/apply-type-guards": "on",
        "typescript/convert-generic-to-shorthand": "on",
        "typescript/convert-commonjs-to-esm": "off",
        "typescript/convert-esm-to-commonjs": "off",
        "typescript/convert-namespace-to-global": "on",
        "typescript/convert-empty-type-literal-to-record": "on",
        "typescript/remove-duplicates-from-union": "on",
        "typescript/remove-duplicates-interface-keys": "on",
        "typescript/remove-duplicates-exports": "on",
        "typescript/remove-useless-types-from-constants": "on",
        "typescript/remove-unused-types": "on",
        "typescript/remove-useless-types": "on",
        "typescript/remove-useless-parens": "on",
        "typescript/remove-useless-promise": "on",
        "typescript/remove-getter-arguments": "on",
        "typescript/remove-setter-return-type": "on",
        "typescript/remove-useless-mapped-types": "on",
        "typescript/remove-useless-non-null-expressions": "on",
        "typescript/cts-file": "off",
        "typescript/mts-file": "off",
        "typescript/rename-file-cts-to-ts": "off",
        "typescript/rename-file-mts-to-ts": "off",
        "typescript/find-file": ["off", {
            "ignore": []
        }]
    }
}
```

## apply-as-type-assertion

According to [best practice](https://stackoverflow.com/questions/36842158/arraytype-vs-type-in-typescript/36843084#36843084).

### ❌ Example of incorrect code

```ts
const boundaryElement = <HTMLElement>e.target;
```

### ✅ Example of correct code

```ts
const boundaryElement1 = e.target as HTMLElement;
```

## apply-utility-types

### ❌ Example of incorrect code

```ts
type SuperType1 = {
    [Key in keyof Type]?: Type[Key];
};
```

### ✅ Example of correct code

```ts
type SuperType1 = Partial<Type>;
```

## apply-type-guards

> It just so happens that TypeScript has something called a `type guard`.
> A `type guard` is some expression that performs a runtime check that guarantees the type in some scope.
>
> (c) [typescript.org](https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards)

Check out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/5ac4459242197c4820b331f19d3681eb/4b66175c486ee8e865aee9645bf4e5fffc664e01).

### ❌ Example of incorrect code

```ts
const isNumber = (a) => typeof a === 'number';
```

### ✅ Example of correct code

```ts
const isNumber = (a: unknown): a is number => typeof a === 'number';
```

## convert-generic-to-shorthand

> There is no difference at all. `Type[]` is the shorthand syntax for an `array` of `Type`. `Array<Type>` is the generic syntax. They are completely equivalent.
>
> (c) https://stackoverflow.com/a/36843084/4536327

Convert `generic` to `shorthand`.

### ❌ Example of incorrect code

```ts
interface A {
    x: Array<X>;
    y: Array<X | Y>;
}
```

### ✅ Example of correct code

```ts
interface A {
    x: X[];
    y: X[] | Y[];
}
```

### Comparison

Linter | Rule | Fix
--------|-------|------------|
🐊 **Putout** | [`typescript/convert-generic-to-shorthand`](https://github.com/coderaiser/putout/tree/master/packages/plugin-typescript#convert-generic-to-shorthand) | ✅
⏣ **ESLint** | [`@typescript-eslint/array-type`](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/eslint-plugin/docs/rules/array-type.md#array-type) | ✅

## convert-commonjs-to-esm

Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/bb90e1d40107f2e76f528053ef576bd2/d10cd8374c7a792d3ff1225ca5ac639c71da7207).

### ❌ Example of incorrect code

```ts
import foo = require('foo');
export = 5;
```

### ✅ Example of correct code

```ts
import foo from 'foo';

export default 5;
```

## convert-esm-to-commonjs

Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/7f77665246b03d9eddc8ee35713c415b/f874630569fa856e62c8a1564c31115ac82f182e).

### ❌ Example of incorrect code

```ts
import foo from 'foo';

export default 5;
```

### ✅ Example of correct code

```ts
import foo = require('foo');
export = 5;
```

## convert-namespace-to-global

Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/7b4036c8f4f7c02799e2fb5bcce865c8/f945baf6553ba7a9d0c95b7448bca4b82f7236e3).

### ❌ Example of incorrect code

```ts
declare namespace global {
    var al: any;
}
```

### ✅ Example of correct code

```ts
declare global {
    var al: any;
}
```

### Comparison

Linter | Rule | Fix
--------|-------|------------|
🐊 **Putout** | [`typescript/convert-namespace-to-global`](https://github.com/coderaiser/putout/tree/master/packages/plugin-typescript#convert-namespace-to-global) | ✅
⏣ **ESLint** | [`@typescript-eslint/no-namespace`](https://typescript-eslint.io/rules/no-namespace/) | ❌

## convert-empty-type-literal-to-record

> `{}` doesn't mean an empty object, but means any types other than `null` and `undefined`
>
> (c) [deno.com](https://docs.deno.com/lint/rules/ban-types/)

Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/6a6699b3f6ff1d707b732fd56323c329/a815410d21c9963bb1c8e974a1d0c93e6e53dd61).

### ❌ Example of incorrect code

```ts
type TestFunction<T extends Test = Test> = ((message: string, fn: (t: T) => void) => void) & {
    extend<U extends CustomOperator = {}>(operators?: U): TestFunction<T & OperatorsToMethods<U>>;
};
```

### ✅ Example of correct code

```ts
type TestFunction<T extends Test = Test> = ((message: string, fn: (t: T) => void) => void) & {
    extend<U extends CustomOperator = Record<PropertyKey, never>>(operators?: U): TestFunction<T & OperatorsToMethods<U>>;
};
```

### Comparison

Linter | Rule | Fix
--------|-------|------------|
🐊 **Putout** | [`typescript/convert-namespace-to-global`](https://github.com/coderaiser/putout/tree/master/packages/plugin-typescript#convert-namespace-to-global) | ✅
🦕 **Deno** | [`bun-types`](https://docs.deno.com/lint/rules/ban-types/) | ❌

## remove-duplicates-from-union

### ❌ Example of incorrect code

```ts
type x =
    | boolean[]
    | A
    | string
    | A
    | string[]
    | boolean[];
```

### ✅ Example of correct code

```ts
type x =
    | boolean[]
    | A
    | string
    | string[];
```

## remove-duplicate-exports

In **JavaScript** duplicate exports leads to [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError), anyways **TypeScript** parses such code and reports [`Duplicates Identifier`](https://github.com/Microsoft/TypeScript/blob/v1.8.5/src/compiler/diagnosticMessages.json#L826-L829) diagnostic.

It gives us ability to automate fixing of such code 😏. Check it out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/e8d02b3d1c91b4b3b6b9636e22dd03ed/8be7b4c8d0f6c28440f36d03341a1153c18549a7).

### ❌ Example of incorrect code

```ts
export {
    a,
    hello,
    a,
    world,
};
```

#### ✅ Example of correct code

```ts
export {
    hello,
    a,
    world,
};
```

*☝️ The rule fits good with [`putout/add-newlines-between-specifiers`](https://github.com/coderaiser/putout/tree/master/packages/eslint-plugin-putout/lib/add-newlines-between-specifiers#readme) of [**eslint-plugin-putout**](https://github.com/coderaiser/putout/tree/master/packages/eslint-plugin-putout/#readme).*

### remove-getter-arguments

> The `get` syntax binds an object property to a function that will be called when that property is looked up
>
> (c) [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/get)

#### ❌ Example of incorrect code

```ts
export interface IParamsConstructor {
    get [fromArray](name: string): IParams;
}
```

#### ✅ Example of correct code

```ts
export interface IParamsConstructor {
    get [fromArray](): IParams;
}
```

### remove-setter-return-type

> The `set` syntax binds an object property to a function to be called when there is an attempt to set that property.
>
> (c) [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/set)

#### ❌ Example of incorrect code

```ts
export interface IParamsConstructor {
    set fromArray(values: ParamsArray): string;
}
```

#### ✅ Example of correct code

```ts
export interface IParamsConstructor {
    set fromArray(values: ParamsArray);
}
```

### remove-useless-types-from-constants

#### ❌ Example of incorrect code

```ts
const x: any = 5;
```

#### ✅ Example of correct code

```ts
const x = 5;
```

## remove-unused-types

### ❌ Example of incorrect code

```ts
type n = number;
type s = string;

const x: n = 5;
```

### ✅ Example of correct code

```ts
type n = number;

const x: n = 5;
```

## remove-useless-types

### ❌ Example of incorrect code

```ts
type oldType = {
    a: number;
    b: string;
};
type newType = oldType;

const x: newType = {
    a: 5,
    b: 'hello',
};
```

### ✅ Example of correct code

```ts
type oldType = {
    a: number;
    b: string;
};

const x: oldType = {
    a: 5,
    b: 'hello',
};
```

## remove-useless-parens

Check it out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/6c8717114f7285639a5f24b5a6fdb9dc/583e438a61aae156c79b66dbf418e1e5f251bf87).

### ❌ Example of incorrect code

```ts
const m: X[] = [];
const z: X | Y = 5;
const f: X = 5;
```

### ✅ Example of correct code

```ts
const x: X[] | Y[] = [];
const m: X[] = [];
const z: X | Y = 5;
const f: X = 5;
```

## remove-useless-promise

Check it out in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/5fd13c0510571b45884dfddbc8b83bb4/5ca97c4021b197822ef73418796513fe6d891239).

### ❌ Example of incorrect code

```ts
function doStuff(): Promise<string> {
    return 'hello';
}
```

### ✅ Example of correct code

```ts
function doStuff(): string {
    return 'hello';
}
```

## remove-useless-mapped-types

Remove useless [mapped types](https://www.typescriptlang.org/docs/handbook/2/mapped-types.html).

### ❌ Example of incorrect code

```ts
type SuperType = {
    [Key in keyof Type]: Type[Key];
};
```

### ✅ Example of correct code

```ts
type SuperType = Type;
```

## remove-useless-non-null-expressions

Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/7a7b37619981d2b2667a709aed96aa26/4bf8d219803979ccb8777e732aa095ce4425dff5).

### ❌ Example of incorrect code

```ts
const bar = foo!!.str;
const baz = bar!?.n;
```

### ✅ Example of correct code

```ts
const bar = foo!.str;
const baz = bar?.n;
```

## remove-useless-mapping-modifiers

Remove useless [mapping modifiers](https://www.typescriptlang.org/docs/handbook/2/mapped-types.html#mapping-modifiers).

### ❌ Example of incorrect code

```ts
type SuperType = {
    [Key in keyof Type]+?: Type[Key];
};
```

### ✅ Example of correct code

```ts
type SuperType = {
    [Key in keyof Type]?: Type[Key];
};
```

## remove-duplicate-interface-keys

### ❌ Example of incorrect code

```ts
interface Hello {
    hello: any;
    hello: string;
}
```

### ✅ Example of correct code

```ts
interface Hello {
    hello: string;
}
```

## cts-file

Run [convert-esm-to-commonjs](#convert-esm-to-commonjs) for all `*.cts` files with help of [redlint](https://github.com/putoutjs/redlint).

Check out in 🐊[Putout Editor](https://putout.cloudcmd.io/#/gist/0beac7eb211cf57be282f6744fc54410/f4217bf6e392e33871152318adce4e3ef6db2dd6).

## mts-file

Run [convert-esm-to-commonjs](#convert-commonjs-to-esm) for all `*.mts` files with help of [redlint](https://github.com/putoutjs/redlint).

Check out in 🐊[Putout Editor](https://putout.cloudcmd.io/#/gist/0beac7eb211cf57be282f6744fc54410/f4217bf6e392e33871152318adce4e3ef6db2dd6).

## find-file

Checkout in 🐊[**Putout Editor**](https://putout.cloudcmd.io/#/gist/1026c5e9562248e7f07f9e2c7b698650/8c701bba5ba52f4cac258ecf5dcb5bee1f197236).

### ❌ Example of incorrect code

```ts
__putout_processor_filesystem(['/', [
    '/hello.ts',
    'const a: number = 5;',
]]);
```

### ✅ Example of correct code

```ts
__putout_processor_filesystem([
    '/',
    ['/hello.ts', 'const a = 5;'],
]);
```

## rename-file-cts-to-ts

Rename `*.cts` files when `type === "commonjs"`:

```diff
 /
 |-- package.json
 `-- lib/
-     `-- hello.cts
+     `-- hello.ts
```

Check out in 🐊[Putout Editor](https://putout.cloudcmd.io/#/gist/8d8f3cd6662b70abbd5e4a2e4835077f/e43319fd63291ec3a5028b30a83f3c91fe90325e).

## rename-file-mts-to-ts

Rename `*.mts` files when `type === "module"`:

```diff
 /
 |-- package.json
 `-- lib/
-     `-- hello.mts
+     `-- hello.ts
```

Check out in 🐊[Putout Editor](https://putout.cloudcmd.io/#/gist/8d8f3cd6662b70abbd5e4a2e4835077f/e43319fd63291ec3a5028b30a83f3c91fe90325e).

## License

MIT
