evil-shrike / tslib

Runtime library for TypeScript helpers.

Runtime

This is a runtime library for TypeScript that contains all of the TypeScript helper functions.

Installing

For the latest stable version:

npm

# TypeScript 2.3.3 or later
npm install tslib

# TypeScript 2.3.2 or earlier
npm install tslib@1.6.1

bower

# TypeScript 2.3.3 or later
bower install tslib

# TypeScript 2.3.2 or earlier
bower install tslib@1.6.1

JSPM

# TypeScript 2.3.3 or later
jspm install npm:tslib

# TypeScript 2.3.2 or earlier
jspm install npm:tslib@1.6.1

Usage

Set the importHelpers compiler option on the command line:

tsc --importHelpers file.ts

or in your tsconfig.json:

{
    "compilerOptions": {
        "importHelpers": true
    }
}

For npm users

You don't need to do anything if moduleResolution option is "node". If it's not (e.g. it implicitly equals to "classic" when module option is "amd") then you will need to add a paths mapping:

    "baseUrl": ".", // This must be specified if "paths" is.
    "paths": {
      "tslib": ["node_modules/tslib/tslib.d.ts"] // This mapping is relative to "baseUrl"
    }

For bower and JSPM users

You will need to add a paths mapping for tslib, e.g. For Bower users:

{
    "compilerOptions": {
        "module": "amd",
        "importHelpers": true,
        "baseUrl": "./",
        "paths": {
            "tslib" : ["bower_components/tslib/tslib.d.ts"]
        }
    }
}

For JSPM users:

{
    "compilerOptions": {
        "module": "System",
        "importHelpers": true,
        "baseUrl": "./",
        "paths": {
            "tslib" : ["jspm_packages/npm/tslib@1.7.0/tslib.d.ts"]
        }
    }
}

Contribute

There are many ways to contribute to TypeScript.

• Submit bugs and help us verify fixes as they are checked in.
• Review the source code changes.
• Engage with other TypeScript users and developers on StackOverflow.
• Join the #typescript discussion on Twitter.
• Contribute bug fixes.
• Read the language specification (docx, pdf).

Documentation

• Quick tutorial
• Programming handbook
• Language specification
• Homepage