@putout/plugin-typescript

@putout/plugin-typescript

TypeScript is JavaScript with syntax for types.

(c) typescriptcriptlang.org

🐊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];
• ✅ [cts-file][#cts-file];
• ✅ [filesystem.js][#filesystem.js];
• ✅ [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-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];
• ✅ [typescript.js][#typescript.js];

Config

{
    "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/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/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 practise.

❌ Example of incorrect code

const boundaryElement = <HTMLElement>e.target;

✅ Example of correct code

const boundaryElement1 = e.target as HTMLElement;

apply-utility-types

❌ Example of incorrect code

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

✅ Example of correct code

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

Check out in 🐊Putout Editor.

❌ Example of incorrect code

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

✅ Example of correct code

const isNumber = (a): 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

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

✅ Example of correct code

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

Comparison

Linter	Rule	Fix
🐊 Putout	typescript/convert-generic-to-shorthand	✅
⏣ ESLint	@typescript-eslint/array-type	✅

convert-commonjs-to-esm

Checkout in 🐊Putout Editor.

❌ Example of incorrect code

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

✅ Example of correct code

import foo from 'foo';

export default 5;

convert-commonjs-to-esm

Checkout in 🐊Putout Editor.

❌ Example of incorrect code

import foo from 'foo';

export default 5;

✅ Example of correct code

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

remove-duplicates-from-union

❌ Example of incorrect code

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

✅ Example of correct code

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

remove-duplicates-exports

In JavaScript duplicate exports leads to SyntaxError, anyways TypeScript parses such code and reports Duplicates Identifier diagnostic.

It gives us ability to automate fixing of such code 😏. Check it out in 🐊Putout Editor.

❌ Example of incorrect code

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

✅ Example of correct code

export {
    hello,
    a,
    world,
};

☝️ The rule fits good with putout/add-newlines-between-specifiers of eslint-plugin-putout.

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

❌ Example of incorrect code

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

✅ Example of correct code

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

❌ Example of incorrect code

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

✅ Example of correct code

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

remove-useless-types-from-constants

❌ Example of incorrect code

const x: any = 5;

✅ Example of correct code

const x = 5;

remove-unused-types

❌ Example of incorrect code

type n = number;
type s = string;

const x: n = 5;

✅ Example of correct code

type n = number;

const x: n = 5;

remove-useless-types

❌ Example of incorrect code

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

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

✅ Example of correct code

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

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

remove-useless-parens

Check it out in 🐊Putout Editor.

❌ Example of incorrect code

const m: X[] = [];
const z: (X | Y) = 5;
const f: X = 5;

✅ Example of correct code

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.

❌ Example of incorrect code

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

✅ Example of correct code

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

remove-useless-mapped-types

Remove useless mapped types.

❌ Example of incorrect code

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

✅ Example of correct code

type SuperType = Type;

remove-useless-mapping-modifiers

Remove useless mapping modifiers.

❌ Example of incorrect code

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

✅ Example of correct code

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

remove-duplicate-interface-keys

❌ Example of incorrect code

interface Hello {
    'hello': any;
    'hello': string;
}

✅ Example of correct code

interface Hello {
    'hello': string;
}

cts-file

Run convert-esm-to-commonjs for all *.cts files with help of redlint.

Check out in 🐊Putout Editor.

mts-file

Run convert-esm-to-commonjs for all *.mts files with help of redlint.

Check out in 🐊Putout Editor.

find-file

Checkout in 🐊Putout Editor.

❌ Example of incorrect code

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

✅ Example of correct code

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

rename-file-cts-to-ts

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

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

Check out in 🐊Putout Editor.

rename-file-mts-to-ts

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

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

Check out in 🐊Putout Editor.

License

MIT