typescript-strictly-typed

TypeScript Strictly Typed

Enable configurations for strictly typed TypeScript, ESLint or TSLint, and optionally Angular. Because TypeScript strict mode is not enough.

A blog post explains the motivation of this lib.

Status of this project (October 2, 2020)

While the tool was still working, this project was archived when Angular 10 added a --strict option, given that React and Vue were already (partially) strict by default.

Unfortunately, Angular is stepping back. So the project will restart soon.

Getting started

cd path/to/my-project
npx typescript-strictly-typed

npx is a command included in Node/npm. In case of problem (there is a known issue with npx on Windows if your user path contains a space, like C:\Users\Hello World), just do the full commands:

cd path/to/my-project
npm install typescript-strictly-typed -g
typescript-strictly-typed

What does it do?

Adding configuration for:

• TypeScript compiler options
  • strict
• ESLint rules
  • @typescript-eslint/no-explicit-any
  • @typescript-eslint/explicit-function-return-type
• TSLint rules
  • no-any
  • typedef with call-signature
• Angular compiler options
  • strictInjectionParameters
  • strictTemplates
  • strictInputAccessModifiers

By the same author

• Angular schematics extension for VS Code (GUI for Angular CLI commands)
• @ngx-pwa/local-storage: Angular library for local storage
• Popular Angular posts on Medium
• Follow updates of this lib on Twitter
• Angular onsite trainings (based in Paris, so the website is in French, but my English bio is here and I'm open to travel)

My open source contributions are done on free time. So if your company earns money with them, it would be nice to consider becoming a sponsor.

Requirements

Node & npm

You need a LTS version of Node and npm, ie. currently:

• Node >= 10.13
• npm >= 6.4

Directory

Be sure to invoke the command in the root directory of your project, ie. where your configuration files (like tsconfig.json) are located.

TypeScript

strict mode is available in TypeScript >= 2.3.

ESLint

ESLint must be configured for TypeScript, ie. with:

• "parser": "@typescript-eslint/parser" and "plugins": ["@typescript-eslint"]
• or an equivalent (for example Vue uses "extends": ["@vue/typescript"] and React uses "extends": "react-app")

Official getting started documentation of @typescript-eslint

Angular

The project must use a LTS version of Angular CLI, ie. with a angular.json file.

Known limitations

This lib is here to promote good practices. But at the end of the day, it just adds a few lines in configuration files, as explained above in "What does it do?".

It was already a lot of work to support all possible official configuration formats. So if it doesn't work for your project because of a custom configuration, you can just modify the configuration files yourself.

React apps

For React apps created with create-react-app, after running this lib command, it will work out of the box:

• in your editor (for example if you have the ESLint extension in Visual Studio Code)
• if you run lint manually (for example with eslint src/** command)

But it won't be taken into account at React compilation (ie. on npm start), because React does custom things.

See issue #2 if you want to help.

Apps using .eslintrc.js (including Vue)

If your project uses a .eslintrc.js file (instead of a more classic .eslintrc.json file) you'll have to copy the strict rules newly generated in .eslintrc.json file into the existing .eslintrc.js file.

For Vue apps created with vue create, after running this lib command, it will work out of the box if you chose one of the following Vue options:

• ESLint with config stored in package.json
• TSLint

But if you chose ESLint with a dedicated config file, Vue will create a .eslintrc.js file and so you'll have to do the above step.

See issue #3 if you want to help.

Changelog

Changelog available here.

License

MIT

Changelog

2.1.0 (2020-10-02)

Feature

• For Angular projects, update to last Angular strict compiler options:
  • fullTemplateTypeCheck is not required anymore as it is replaced by strictTemplates
  • add new strictInputAccessModifiers option