ts-standard
TypeScript Style Guide, with linter and automatic code fixer based on StandardJS
๐พ Install
npm install --save-dev ts-standard
โจ๏ธ Basic Usage
ts-standard
Enable auto code fixing
ts-standard --fix
Note: A tsconfig.json
or similar project file is required. See
TSConfig
section below for more details
๐ Help
ts-standard - Standard for TypeScript! (https://github.com/standard/ts-standard)
Usage:
ts-standard <flags> [FILES...]
If FILES is omitted, all JavaScript/TypeScript source files (*.js, *.jsx, *.mjs, *.cjs, *.ts, *.tsx)
in the current working directory are checked, recursively.
Certain paths (node_modules/, coverage/, vendor/, *.min.js, and
files/folders that begin with '.' like .git/) are automatically ignored.
Paths in a project's root .gitignore file are also automatically ignored.
Flags:
--fix Automatically fix problems
-p, --project Specify ts-config location (default: ./tsconfig.eslint.json or ./tsconfig.json)
--version Show current version
-h, --help Show usage information
Flags (advanced):
--stdin Read file text from stdin
--ext Specify JavaScript/TypeScript file extensions
--global Declare global variable
--plugin Use custom eslint plugin
--env Use custom eslint environment
--parser Use custom ts/js parser (default: @typescript-eslint/parser)
๐งฌ TSConfig: Linting with Type Information
By default ts-standard
will search the current working director (cwd) for the following in order
tsconfig.eslint.json
tsconfig.json
You can also manually configure the location of the tsconfig
file by either passing the path to
the --project
flag or adding a ts-standard
configuration property to your package.json
file.
{
"ts-standard": {
"project": "path/to/tsconfig.json"
}
}
๐ Ignoring files and folders
You can add an ignore
property to your package.json
ts-standard
configuration settings.
{
"ts-standard": {
"ignore": [
"dist",
"src/**/*.js"
]
}
}
๐ซ Please change X rule
This project has no control over the rules implemented, as such this project cannot change any of the
rules that have been configured. If you want to discuss the rules, please visit the rules configuration repo
eslint-config-standard-with-typescript
.
๐ง Why
This utility was designed to be the standard
equivalent for typescript.
Underneath the hood, this utility uses the same standard-engine
and combines that engine with the official
eslint-config-standard-with-typescript
ruleset.
You can also choose to just use eslint
with the
eslint-config-standard-with-typescript
shareable config instead and achieve the same results as
this project. But ts-standard
saves you from having to manually install all the extra dependencies
and may reduce configuration overhead.
๐ Special Thanks
Special thanks to standard
for inspiration and some shared code and
to eslint-config-standard-with-typescript
for
creating a typescript specific standard.
๐ Contributing Guide
I welcome all pull requests. Please make sure you add appropriate test cases for any features added. Before opening a PR please make sure to run the following scripts:
npm run lint:standard
checks for code errors and format according to standardnpm test
make sure all tests pass