drew-moore / typings

The TypeScript Definition Manager

The TypeScript Definition Manager.

Updating from 0.x to 1.0? Make sure you rm -rf typings/, re-install, and update tsconfig.json. See the release for more information!

Quick Start

# Install Typings CLI utility.
npm install typings --global

# Search for definitions.
typings search tape

# Find an available definition (by name).
typings search --name react

# If you use the package as a module:
# Install non-global typings (defaults to "npm" source, configurable through `defaultSource` in `.typingsrc`).
typings install debug --save

# If you use the package through script tag, or
# it is part of the environment, or
# the non-global typings is not yet available:
typings install dt~mocha --global --save

# Install typings from particular registry.
typings install env~atom --global --save
typings install npm~bluebird --save

# Use `typings/index.d.ts` (in `tsconfig.json` or as a `///` reference).
cat typings/index.d.ts

Usage

Typings is the simple way to manage and install TypeScript definitions. It uses typings.json, which can resolve to the Typings Registry, GitHub, NPM, Bower, HTTP and local files. Packages can use type definitions from various sources and different versions, knowing they will never conflict for users.

typings install debug --save

The public registry is maintained by the community, and is used to resolve official type definitions for JavaScript packages.

Read More

• Commands
• Coming from TSD?
• Example typings
• Why external modules?
• About the registry
• FAQ

Sources

• npm - dependencies from NPM
• github - dependencies directly from GitHub (E.g. Duo, JSPM)
• bower - dependencies from Bower
• common - "standard" libraries without a known "source"
• shared - shared library functionality
• lib - shared environment functionality (mirror of shared) (--global)
• env - environments (E.g. atom, electron) (--global)
• global - global (window.<var>) libraries (--global)
• dt - typings from DefinitelyTyped (usually --global)

Contributing

# Installation
# Fork this repo (https://github.com/typings/typings)
# Clone the fork (E.g. `https://github.com/<your_username>/typings.git`)
cd typings

# Install modules
npm install

# Build
npm run build

# Test
npm run test

Change Log

License

MIT