⚠ This package was only intented for use with NodeCG v1 till official typings for NodeCG v2 are published in a separate package. As v2 has been released this package is practically deprecated. Only updates for eventual minor/fix version upgrades for NodeCG v1 will be ported here. Use the official @nodecg/types package from now on for newer projects that use NodeCG v2!
If you are developing NodeCG bundles in TypeScript you need typings for nodecg.
The official guide recommends that you import them directly from the local NodeCG installation using relative paths. This can easily break if the install NodeCG version is incorrect or the user has placed your bundle somewhere other than in nodecgInstall/bundles/yourBundle. Also your bundle cannot be compiled if you don't have NodeCG installed.
Some people require the nodecg npm package directly to get around these problems. However this pulls in all the dependencies of NodeCG into your project/node_modules directory which are tremendous in count and size.
Because of this npm installs are pretty slow and also you have NodeCG stored multiple times on your disk. Once for your actual install and then one additional install for each TypeScript bundle that imports the NodeCG typings this way.
nodecg-types solves this by republishing just the official NodeCG types. It does not contain any other NodeCG code and only has the dependencies that are needed for the typings to work.
Note: this is an unofficial package and a temporary workaround till NodeCG 2.x is released! Please refer to this issue regarding how the official NodeCG typings will be handled in the future.
nodecg-types behaves the same way as the official nodecg npm package regarding types.
You install it using npm:
npm install nodecg-types --saveAnd then import the typings you need. The paths are completely the same meaning nodecg-types is a drop-in replacement and you can just exchange nodecg for nodecg-types:
import { NodeCG } from "nodecg-types/types/server";