I use TypeScript 2 in my project. I'd like to use some js library, but also typings for that library. I can install types with simple npm install @types/some-library
. I'm not sure if I should --save
or --save-dev
them. It seems to me that even DefinetelyTyped GitHub readme kind of mentions both versions, but never explains them. I would think that @types should be in devDependencies
, as types are needed for development and aren't used in runtime, but I saw many times @types in just dependencies
. I'm confused.
How should I decide whether @types/* goes into dependencies
or devDependencies
? Are there actually some more or less official instructions?
The rule of thumb is that if a module is imported by the application (e.g. with a require('foo') ), then it should be a dependency. Anything else goes as devDependency.
Packages required to build the webpack project are under dependencies, rather than devDependencies . Node is historically used as a “server”, and still considered true.
dev_dependencies are modules which are only required during development, while dependencies are modules which are also required at runtime.
Let's say you're developing a package "A" that have @types/some-module package in devDependencies. For some reason you're exporting the type from @types/some-module
import {SomeType} from 'some-module'; export default class APackageClass { constructor(private config: SomeType) { } }
Right now Typescript consumers of package "A" are unable to guess what SomeType is, since devDependencies of package "A" are NOT installed.
In that particular case you NEED to place @types/* package with regular "dependencies". For other cases "devDependencies" are good enough.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With