.config/coc/extensions/node_modules/coc-prettier/node_modules/prettier-eslint/node_modules/typescript/README.md

   1 \r
   2 # TypeScript\r
   3 \r
   4 [![Build Status](https://travis-ci.org/microsoft/TypeScript.svg?branch=master)](https://travis-ci.org/microsoft/TypeScript)\r
   5 [![VSTS Build Status](https://dev.azure.com/typescript/TypeScript/_apis/build/status/Typescript/node10)](https://dev.azure.com/typescript/TypeScript/_build/latest?definitionId=4&view=logs)\r
   6 [![npm version](https://badge.fury.io/js/typescript.svg)](https://www.npmjs.com/package/typescript)\r
   7 [![Downloads](https://img.shields.io/npm/dm/typescript.svg)](https://www.npmjs.com/package/typescript)\r
   8 \r
   9 [TypeScript](https://www.typescriptlang.org/) is a language for application-scale JavaScript. TypeScript adds optional types to JavaScript that support tools for large-scale JavaScript applications for any browser, for any host, on any OS. TypeScript compiles to readable, standards-based JavaScript. Try it out at the [playground](https://www.typescriptlang.org/play/), and stay up to date via [our blog](https://blogs.msdn.microsoft.com/typescript) and [Twitter account](https://twitter.com/typescript).\r
  10 \r
  11 Find others who are using TypeScript at [our community page](https://www.typescriptlang.org/community/).\r
  12 \r
  13 ## Installing\r
  14 \r
  15 For the latest stable version:\r
  16 \r
  17 ```bash\r
  18 npm install -g typescript\r
  19 ```\r
  20 \r
  21 For our nightly builds:\r
  22 \r
  23 ```bash\r
  24 npm install -g typescript@next\r
  25 ```\r
  26 \r
  27 ## Contribute\r
  28 \r
  29 There are many ways to [contribute](https://github.com/microsoft/TypeScript/blob/master/CONTRIBUTING.md) to TypeScript.\r
  30 * [Submit bugs](https://github.com/microsoft/TypeScript/issues) and help us verify fixes as they are checked in.\r
  31 * Review the [source code changes](https://github.com/microsoft/TypeScript/pulls).\r
  32 * Engage with other TypeScript users and developers on [StackOverflow](https://stackoverflow.com/questions/tagged/typescript).\r
  33 * Help each other in the [TypeScript Community Discord](https://discord.gg/typescript).\r
  34 * Join the [#typescript](https://twitter.com/search?q=%23TypeScript) discussion on Twitter.\r
  35 * [Contribute bug fixes](https://github.com/microsoft/TypeScript/blob/master/CONTRIBUTING.md).\r
  36 * Read the language specification ([docx](https://github.com/microsoft/TypeScript/blob/master/doc/TypeScript%20Language%20Specification.docx?raw=true),\r
  37  [pdf](https://github.com/microsoft/TypeScript/blob/master/doc/TypeScript%20Language%20Specification.pdf?raw=true), [md](https://github.com/microsoft/TypeScript/blob/master/doc/spec.md)).\r
  38 \r
  39 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see\r
  40 the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com)\r
  41 with any additional questions or comments.\r
  42 \r
  43 ## Documentation\r
  44 \r
  45 *  [TypeScript in 5 minutes](https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes.html)\r
  46 *  [Programming handbook](https://www.typescriptlang.org/docs/handbook/basic-types.html)\r
  47 *  [Language specification](https://github.com/microsoft/TypeScript/blob/master/doc/spec.md)\r
  48 *  [Homepage](https://www.typescriptlang.org/)\r
  49 \r
  50 ## Building\r
  51 \r
  52 In order to build the TypeScript compiler, ensure that you have [Git](https://git-scm.com/downloads) and [Node.js](https://nodejs.org/) installed.\r
  53 \r
  54 Clone a copy of the repo:\r
  55 \r
  56 ```bash\r
  57 git clone https://github.com/microsoft/TypeScript.git\r
  58 ```\r
  59 \r
  60 Change to the TypeScript directory:\r
  61 \r
  62 ```bash\r
  63 cd TypeScript\r
  64 ```\r
  65 \r
  66 Install [Gulp](https://gulpjs.com/) tools and dev dependencies:\r
  67 \r
  68 ```bash\r
  69 npm install -g gulp\r
  70 npm install\r
  71 ```\r
  72 \r
  73 Use one of the following to build and test:\r
  74 \r
  75 ```\r
  76 gulp local             # Build the compiler into built/local.\r
  77 gulp clean             # Delete the built compiler.\r
  78 gulp LKG               # Replace the last known good with the built one.\r
  79                        # Bootstrapping step to be executed when the built compiler reaches a stable state.\r
  80 gulp tests             # Build the test infrastructure using the built compiler.\r
  81 gulp runtests          # Run tests using the built compiler and test infrastructure.\r
  82                        # Some low-value tests are skipped when not on a CI machine - you can use the\r
  83                        # --skipPercent=0 command to override this behavior and run all tests locally.\r
  84                        # You can override the specific suite runner used or specify a test for this command.\r
  85                        # Use --tests=<testPath> for a specific test and/or --runner=<runnerName> for a specific suite.\r
  86                        # Valid runners include conformance, compiler, fourslash, project, user, and docker\r
  87                        # The user and docker runners are extended test suite runners - the user runner\r
  88                        # works on disk in the tests/cases/user directory, while the docker runner works in containers.\r
  89                        # You'll need to have the docker executable in your system path for the docker runner to work.\r
  90 gulp runtests-parallel # Like runtests, but split across multiple threads. Uses a number of threads equal to the system\r
  91                        # core count by default. Use --workers=<number> to adjust this.\r
  92 gulp baseline-accept   # This replaces the baseline test results with the results obtained from gulp runtests.\r
  93 gulp lint              # Runs eslint on the TypeScript source.\r
  94 gulp help              # List the above commands.\r
  95 ```\r
  96 \r
  97 \r
  98 ## Usage\r
  99 \r
 100 ```bash\r
 101 node built/local/tsc.js hello.ts\r
 102 ```\r
 103 \r
 104 \r
 105 ## Roadmap\r
 106 \r
 107 For details on our planned features and future direction please refer to our [roadmap](https://github.com/microsoft/TypeScript/wiki/Roadmap).\r