Skip to content

Handbook -> Docs, i18n doc pages, Double nesting #790

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 14 commits into from
Jul 25, 2020
Merged

Handbook -> Docs, i18n doc pages, Double nesting #790

merged 14 commits into from
Jul 25, 2020

Conversation

orta
Copy link
Contributor

@orta orta commented Jul 20, 2020

i8n Doc Page

Screen Shot 2020-07-19 at 8 01 06 PM

Succinct Nav

The nav is now basically impossible to get wrong, filepaths are typed:

Screen Shot 2020-07-19 at 8 05 50 PM

Release notes are automatically added on deploys.

Double Nesting

Docs navigation now supports nesting 2 levels. Today this is only needed for the .d.ts templates but I have plans which need this also.

Screen Shot 2020-07-19 at 8 06 38 PM

TODO:

  • Keyboard up/down in the sidebar
  • Next/Previous page broke
  • Mobile check

@orta orta mentioned this pull request Jul 20, 2020
12 tasks
@orta orta changed the title Handbook -> Docs, i8n doc pages, Double nesting Handbook -> Docs, i18n doc pages, Double nesting Jul 24, 2020
@github-actions
Copy link
Contributor

Messages
📖

Deployed to a PR branch - playground tsconfig old handbook

Got false positives?

Make changes to the global settings spellcheck.json in /artsy/peril-settings.

Typos for Basic Types.md

Line Typo
8 # 1ntr0duc7un
15 The most basic datatype is the simple true/false valu
23 ther floating point values or BigIntegers.
24 get the type number, while BigIntegers get the type bigint.
38 ng programs in JavaScript for webpages and servers alike is working
39 ng` to refer to these textual datatypes.
48 re surrounded by the backtick/backquote (`) character, and embe
128 # Enum
130 dition to the standard set of datatypes from JavaScript is the enum
131 As in languages like C#, an enum is a way of giving more frien
142 By default, enums begin numbering their members
155 lly set all the values in the enum:
166 A handy feature of enums is that you can also go from
166 the name of that value in the enum.
167 that mapped to in the Color enum above, we could look up the c
307 able to, every type; however, no type is a subtype of, or assi

Typos for tsconfig.json.md

Line Typo
19 - By invoking tsc with no input files, in which
20 - By invoking tsc with no input files and a `--
78 ## TSConfig Reference
80 configuration options in the [TSConfig Reference](/tsconfig).

Typos for TypeScript Tooling in 5 minutes.md

Line Typo
14 - Via npm (the Node.js package manager)
14 - Via npm (the Node.js package manager)
15 ng TypeScript's Visual Studio plugins
20 For npm users:
100 describes objects that have a firstName and lastName field.
100 cts that have a firstName and lastName field.

Typos for React.md

Line Typo
15 - [Next.js](https://nextjs.org) - [TS do
24 - [React TypeScript Cheatsheets](https://react-typescript-che
25 - [React & Redux in TypeScript](https://github

Typos for Migrating from JavaScript.md

Line Typo
87 with common build tools like Browserify, Babelify, and Uglify.
87 build tools like Browserify, Babelify, and Uglify.
90 ## Webpack
92 Webpack integration is pretty simple.
133 The same goes for [ts-loader](https://github.com/TypeStron
133 another TypeScript loader for Webpack.
136 u can see an example of using Webpack in our [tutorial on React and
136 in our [tutorial on React and Webpack](./React%20&%20Webpack.md).
153 for you, you can tighten that behavior up.
190 If you had the following Node/CommonJS code:
198 or the following RequireJS/AMD code:
227 hat, you'll be able to import lodash with no issues, and get accur

Typos for Gulp.md

Line Typo
9 p://gulpjs.com) and then add [Browserify](http://browserify.org), [ugl
9 isperator.net/uglifyjs/), or [Watchify](https://github.com/substack/
10 ljs.io/) functionality using [Babelify](https://github.com/babel/bab
12 me that you're already using [Node.js](https://nodejs.org/) with [n
12 s](https://nodejs.org/) with [npm](https://www.npmjs.com/).
43 e'll turn this folder into an npm package.
64 ge/gulp-typescript) is a gulp plugin for TypeScript.
122 Before we get to Browserify, let's build our code out and
160 le syntax, TypeScript emitted CommonJS modules that Node uses.
161 We'll stick with CommonJS for this tutorial, but you co
163 # Browserify
167 tunately, that's exactly what Browserify does.
168 en better, it lets us use the CommonJS module system used by Node, w
171 First, install browserify, [tsify](https://www.npmjs.co
171 First, install browserify, [tsify](https://www.npmjs.com/packag
172 tsify is a Browserify plugin that,
172 tsify is a Browserify plugin that, like gulp-typesc
172 tsify is a Browserify plugin that, like gulp-typescript, g
173 s us adapt the file output of Browserify back into a format that gulp
211 Now change your gulpfile to the following:
246 lso changed default to call Browserify with the tsify plugin instead
246 ` to call Browserify with the tsify plugin instead of gulp-typesc
246 all Browserify with the tsify plugin instead of gulp-typescript.
254 we specified debug: true to Browserify.
255 This causes tsify to emit source maps inside th
260 # Watchify, Babel, and Uglify
262 we are bundling our code with Browserify and tsify, we can add various
262 our code with Browserify and tsify, we can add various features
262 us features to our build with browserify plugins.
262 to our build with browserify plugins.
264 - Watchify starts gulp and keeps it runn
272 ## Watchify
274 We'll start with Watchify to provide background compila
280 Now change your gulpfile to the following:
323 n('update', bundle);so that **Browserify** will run thebundle` functio
327 r default a name since both Watchify and Gulp need to call it.
349 d to install vinyl-buffer and gulp-sourcemaps to keep sourcemaps working.
349 r and gulp-sourcemaps to keep sourcemaps working.
355 Now change your gulpfile to the following:
395 ourcemaps` exist to make sure sourcemaps keep working.
396 hese calls give us a separate sourcemap file instead of using inline
396 file instead of using inline sourcemaps like before.
406 First install Babelify and the Babel preset for ES20
407 Like Uglify, Babelify mangles code, so we'll need v
407 o we'll need vinyl-buffer and gulp-sourcemaps.
408 By default Babelify will only process files with
408 ts` extension as an option to Babelify.
414 Now change your gulpfile to the following:

Typos for DOM Manipulation.md

Line Typo
12 in data science, and even on IoT devices, it is important to r
14 ic, they do not change. The Document Object Model (DOM) is a prog
14 is so powerful that countless frontend frameworks (jQuery, React, An
14 ountless frontend frameworks (jQuery, React, Angular, etc.) have b
16 000+ lines of definitions in lib.dom.d.ts, one stands out among the re
22 Given a simplified index.html file:
50 er compiling and running the index.html page, the resulting HTML wil
60 Document` interface from the lib.dom.d.ts file. The code snippet conta
81 and it will return a standard HTMLElement. This definition is what enab
106 ds the Node interface. This prototypal extension allows for all `HTM
160 at tools for getting lists of dom elements that fit a more uniq
160 traints. They are defined in lib.dom.d.ts as:
195 The best part about the lib.dom.d.ts type definitions is that the
195 erface is documented by this [HTMLElement page](https://developer.mozil
195 o the [W3C Recommendation for HTMLElement](https://www.w3.org/TR/html52
199 - [ECMA-262 Standard](http://www.ecma-int

Typos for Babel with TypeScript.md

Line Typo
12 h an existing framework like [tsdx](https://www.npmjs.com/packag
12 gular](https://angular.io/), [NestJS](https://nestjs.com/) or any
27 #### Type Checking and d.ts file generation
33 uplicating some of your babel config into a corresponding [`tsconf

Typos for ASP.NET Core.md

Line Typo
8 ## Install ASP.NET Core and TypeScript
10 First, install [ASP.NET Core](https://dotnet.microsof
19 4. Select ASP.NET Core Web Application and pr
37 Open Dependencies > Manage NuGet Packages > Browse. Search a
124 e.json` file, add gulp and del
133 uld start installing gulp and del as soon as you save the file.
133 the file. If not, right-click package.json and then Restore Packages.
208 2. Look in the first localhost folder, then scripts/app.ts
208 ocalhost folder, then scripts/app.ts
214 ore project with a TypeScript frontend.

Typos for TypeScript 3.9.md

Line Typo
33 This is strange behavior!
52 tion speed with packages like material-ui and styled-components.
63 ved around a 40% reduction in material-ui's compile time!
86 We'd like to test this behavior, so we'll write a unit test.
168 t/pull/36402) from [Alexander Tarasyuk](https://github.com/a-tarasyu
199 he SDK installers above] and [MSBuild installs](https://www.nuget.o
202 ### CommonJS Auto-Imports in JavaScript
204 rts in JavaScript files using CommonJS modules.
213 Plenty of users still use CommonJS-style require(...) imports like s
227 TypeScript's refactorings and quick fixes often didn't
300 26434) from community member [Wenlu Wang](https://github.com/King
333 ceived user feedback that the behavior of optional chaining (?.) w
347 s stop the "short-circuiting" behavior of optional chaining, so if `
349 e Babel team who pointed this behavior out, and most users who provi
349 back to us, believe that this behavior is wrong.
362 who want to revert to the old behavior can add explicit parentheses
371 enforce this rule to be more comformant.
374 36) enforcing this from [Brad Zacher](https://github.com/bradzache
389 fix, and thanks to [Alexander Tarasyuk](https://github.com/a-tarasyu
471 S5 and ES2015 could differ in behavior.
473 pull/32264) from GitHub user [pathurs](https://github.com/pathurs),
502 ### More libdom.d.ts refinements
504 ore of TypeScript's built-in .d.ts library (lib.d.ts and family)
504 ipt's built-in .d.ts library (lib.d.ts and family) to be generated f

Typos for TypeScript 3.8.md

Line Typo
56 - remove: this is today's behavior of dropping these imports. It
64 private fields, part of the [stage-3 class fields proposal](https:
249 oned, another benefit is that subclassing can be easier with ECMAScript
251 e over properties declared in superclasses.
255 This is because our downleveled implementation uses WeakMap
255 vacy, and WeakMaps can't be polyfilled in a way that doesn't cause m
259 ecause # private fields are downleveled using WeakMaps, they may be
260 While some runtimes might optimize their actual i
260 might not be the case in all runtimes.
313 thin several environments and bundlers may be limited or may require
320 tures like optional chaining, nullish coalescing, export * as ns,
323 ## JSDoc Property Modifiers
327 hecking, TypeScript leverages JSDoc.
328 ipt 3.8 understands a few new JSDoc tags for properties.
386 y watchers on folders, and at startup that would be fine; however,
386 d be fine; however, during an npm install, a lot of activity wi
433 his flag for some less-common setups.

Typos for TypeScript 3.7.md

Line Typo
34 code that performs repetitive nullish checks using the && operato
48 e && will act specially on "falsy" values (e.g. the empty strin
86 The "short-circuiting" behavior that optional chains have is
114 ## Nullish Coalescing
118 The nullish coalescing operator is anoth
149 ?? avoids some unintended behavior from 0, NaN and "" bein
149 aNand""` being treated as falsy values.
151 thanks to community members [Wenlu Wang](https://github.com/King
151 ithub.com/Kingwl) and [Titian Cernicova Dragomir](https://github.com/
151 Kingwl) and [Titian Cernicova Dragomir](https://github.com/dragomirt
152 peScript/pull/32883) and [the nullish coalescing proposal repositor
160 As an example, Node.js has a dedicated function for
193 de so that the language could analyze it, but this isn't convenient
220 scope, that condition must be truthy.
221 s assertion function means we do catch our original yell exa
305 ers found themselves return-ing their failure functions.
424 codebases, even if they were JSDoc-annotated.
427 users can write libraries in JSDoc annotated JavaScript and supp
430 out the best way to transform JSDoc comments and CommonJS exports
430 transform JSDoc comments and CommonJS exports into valid type decla
545 t doesn't necessarily have to downlevel .js files.
696 for issues, you can create a seperate project that targets ES5 and
710 You can disable this behavior with the compiler option `dis
739 d the code incorrectly allows non-adminstrator users to edit the configurati
774 a big thanks to GitHub user [@jwbay](https://github.com/jwbay) wh
794 orrectness changes related to nullability, but impact will ultimately d
801 While not a breakage per se, opting in to the `useDefineF
803 - overriding an accessor in a derived class with a pro
808 ### Function Truthy Checks

Typos for TypeScript 3.6.md

Line Typo
55 methods present, and is also iterable.
142 In pre-ES2015 targets, the most faithful em
167 Arrays` is also available in [tslib](https://github.com/Microsoft
173 ments for when Promises are mis-handled.
197 ccess a method before await-ing or .then()-ing a Promise.
197 fore await-ing or .then()-ing a Promise.
220 ## import.meta Support in SystemJS
245 s proposal may have differing behavior from in existing versions of
245 to communicate this different behavior to provide appropriate errors
289 ppropriately capture both the callability and constructability of a cla
289 ture both the callability and constructability of a class-like function.
298 rty build tools like Gulp and Webpack.
310 omatically apply quick fixes, refactorings, and other transformations li
320 he one Node already supports (CommonJS), AMD, System.js, and more!
320 ady supports (CommonJS), AMD, System.js, and more!
333 yground is largely a fork of [Artem Tyurin](https://github.com/ag
333 d is largely a fork of [Artem Tyurin](https://github.com/agentcoop
334 We owe Artem a big thanks for helping out

Typos for TypeScript 3.5.md

Line Typo
73 Previously, a non-disciminated union wouldn't have any exc
97 ay 3rd party libraries, where globals that libraries declare can al
181 peScript 3.5 generalizes this behavior to work on constructor functi

Typos for TypeScript 3.4.md

Line Typo
139 This means that genericity from compose's arguments ha
204 ub> extends from ReadonlyArray< T1 | T2</su
265 e that strips away readonly-ness, and that would convert `read
301 uct for literal values called ****const assertions.
433 y want to [use an appropriate polyfill](https://github.com/ljharb/gl

Typos for TypeScript 3.3.md

Line Typo
8 ## Improved behavior for calling union types
54 This new behavior only kicks in when at most on
116 That can mean signficantly faster builds under `--build

Typos for TypeScript 3.2.md

Line Typo
30 he last overload will ever be modeled.
70 TypeScript 3.2 also allows destructuring a rest binding from a generic
70 of the other bindings in the destructuring pattern.
82 ## BigInt
84 BigInts are part of an upcoming propo
85 3.2 brings type-checking for BigInts, as well as support for emitt
85 well as support for emitting BigInt literals when targeting `esne
87 BigInt support in TypeScript introdu
87 type called the bigint (all lowercase).
88 function or by writing out a BigInt literal by adding an n to t
146 As we mentioned, BigInt support is only available for
147 y not be obvious, but because BigInts have different behavior for m
147 ecause BigInts have different behavior for mathematical operators li
148 ed to dispatch to the correct behavior depending on the type, and so
150 no immediate plans to provide downleveling support.
151 ure, so you'll be able to use BigInts there when targeting esnext
153 Certain targets may include a polyfill or BigInt-like runtime object
153 ets may include a polyfill or BigInt-like runtime object.
178 sconfig.json` inheritance via Node.js packages

Typos for TypeScript 3.1.md

Line Typo
47 components (formerly known as SFCs).
100 ## Matching behavior
102 e matches is by using Node's [semver ranges](https://github.com/np
121 he order could have different behavior, so the above sample would no

Typos for TypeScript 3.0.md

Line Typo
12 lso introduces a new mode for tsc, the --build flag, that wor
300 we can model React's specific behavior for things like `defaultProps
323 The default-ed properties are inferred from
327 components (formerly known as SFCs) use ES2015 default initializ
344 e "lib" compiler option in tsconfig.json (e.g. use lib="es2015" and
346 ecommended. Previously these .d.ts files had to add forward/dupl

Typos for TypeScript 2.9.md

Line Typo
83 ric literals (such as numeric enum types) and unique symbols.
148 ler option to disable the new behavior.
227 This also works in JSDoc comments to refer to types fr
240 ## Relaxing declaration emit visiblity rules
289 Often in Node.js applications a .json is nee
326 tput device is applicable for colorful text.

Typos for TypeScript 2.8.md

Line Typo
347 ## IIFEs as namespace declarations
399 factory name using @jsx dom pragma.
421 React`) allowing for multiple jsx factories in one compilation.
423 ined with the per-file @jsx pragma, each file can have a differe

Typos for TypeScript 2.7.md

Line Typo
10 .7 adds support for declaring const-named properties on types including
191 ript 2.7, tuples of different arities are no longer assignable to e
192 hanks to a pull request from [Tycho Grouwstra](https://github.com
192 to a pull request from [Tycho Grouwstra](https://github.com/tycho01),
192 tuple types now encode their arity into the type of their respec
193 inct from tuples of different arities.
206 eed to resort to the original behavior in which tuples only enforce
318 or import d from "cjs" from CommonJS modules with `--esModuleInter
320 TypeScript 2.7 updates CommonJS/AMD/UMD module emit to synthe
323 Previously CommonJS/AMD/UMD modules were treated
325 t * as foo from "foo"`) for a CommonJS/AMD/UMD module as equivalent
325 ass or a function. ECMAScript spec stipulates that a namespace r
326 import d from "foo") for a CommonJS/AMD/UMD module as equivalent
326 e("foo").default`.Most of the CommonJS/AMD/UMD modules available tod
326 o import non-ES modules (i.e. CommonJS/AMD/UMD). For instance `impor
330 ) is now correctly flagged as uncallable. Calling it will result in an
331 - Default imports to CommonJS/AMD/UMD are now allowed (e.g.
333 > Note: The new behavior is added under a flag to avoi
392 --pretty now uses colors for file names, diagnostic co

Typos for TypeScript 2.6.md

Line Typo
12 your command line or in your tsconfig.json.
14 ameter positions are checked contravariantly instead of bivariantly.
14 contravariantly instead of bivariantly.
15 out [What are covariance and contravariance?](https://www.stephanboyer.co
18 >`) continue to mostly relate covariantly.
20 mple in which Animal is the supertype of Dog and Cat:
35 the type (x: T) => void is bivariant (i.e. covariant or contrav
35 s bivariant (i.e. covariant or contravariant) for T in def
35 variant_ (i.e. covariant or contravariant) for T in default type chec
35 ault type checking mode, but contravariant for T in strict function t
51 an error. Effectively, T is contravariant in Comparer<T> because it i
58 Effectively, T is bivariant in Comparer<T> because it i
72 oves type inference involving contravariant positions:
87 ferences for T originate in contravariant positions, and we therefore i
88 ere we infer the best common supertype.
92 gn better with the ECMAScript spec.
93 As per the [ECMAScript spec](https://tc39.github.io/ecma2
145 TypeScript 2.6 npm package ships with localized
215 ## Suppress errors in .ts files using '// @ts-ignore' c
215 rrors in .ts files using '// @ts-ignore' comments
217 upport suppressing errors in .js files using // @ts-ignore c
240 e enhancements to watching in tsserver.

Typos for TypeScript 2.5.md

Line Typo
10 Thanks to work done by [@tinganho](https://github.com/tinganho)
33 ## Deduplicated and redirected packages
43 ksflag, which parallels the **behavior** of &#91;the--preserve-symlinks`
43 --preserve-symlinks flag in Node.js](https://nodejs.org/api/cli.h
44 ag also exhibits the opposite behavior to Webpack's `resolve.symlink
44 bits the opposite behavior to Webpack's resolve.symlinks option (i.
44 totrueparallels setting **Webpack's**resolve.symlinkstofalse`
47 to [the documentation on the Node.js website](https://nodejs.org/a

Typos for TypeScript 2.4.md

Line Typo
23 Many bundlers have support for automaticall
25 ## String Enums
27 TypeScript 2.4 now allows enum members to contain string ini
37 at is that string-initialized enums can't be reverse-mapped to ge
37 se-mapped to get the original enum member name.
104 ## Strict contravariance for callback parameters
106 ways compared parameters in a bivariant way.
127 e parameters are checked in a contravariant manner with respect to the cu

Typos for TypeScript 2.3.md

Line Typo
25 orts iteration is said to be "iterable" if it has a `Symbol.iterator
27 perator and the array rest in destructuring assignmnets.
27 e array rest in destructuring assignmnets.
32 lly delegate calls to another iterable through yield *. For exampl
48 uses new type check and emit behavior that attempts to call a `[Sym
52 for..of statements, Array Destructuring, and Spread elements in Array
54 ## Async Iteration
56 ript 2.3 adds support for the async iterators and generators as d
58 ##### Async iterators
60 The Async Iteration introduces an `Asyn
73 An object that supports async iteration is said to be "iter
73 sync iteration is said to be "iterable" if it has a `Symbol.asyncIte
75 ##### Async Generators
77 The [Async Iteration proposal](https://g
77 -async-iteration) introduces "Async Generators", which are async
77 "Async Generators", which are async functions that also can be us
78 Async Generators can also delegate
78 lls via yield* to either an iterable or async iterable:
78 ld*` to either an iterable or async iterable:
78 o either an iterable or async iterable:
92 As with Generators, Async Generators can only be functi
93 Arrow functions cannot be Async Generators. Async Generators
93 s cannot be Async Generators. Async Generators require a valid, g
93 entation (either native or an ES2015-compatible polyfill), in addition to a v
93 ative or an ES2015-compatible polyfill), in addition to a valid `Sym
97 a means of iterating over an iterable.
98 Similarly, the Async Iteration proposal introduces
98 statement to iterate over an async iterable:
98 ment to iterate over an async iterable:
108 ement is only legal within an Async Function or Async Generator.
108 l within an Async Function or Async Generator.
112 in mind that our support for async iterators relies on support f
112 t at runtime. You may need to polyfill Symbol.asyncIterator, which
182 Just un-comment the configuration you like to
182 ike to set to get the desired behavior; we hope the new output simpl
184 ## Errors in .js files with --checkJs
186 oes not report any errors in .js files including using `--allo
193 JSDoc comments can be used to add s
193 to your JavaScript code, see [JSDoc Support documentation](https:
193 e details about the supported JSDoc constructs.

Typos for TypeScript 2.2.md

Line Typo
10 pport for the ECMAScript 2015 mixin class pattern (see [MDN Mixin
10 mixin class pattern (see [MDN Mixin description](https://develope
10 /Classes#Mix-ins) and ["Real" Mixins with JavaScript Classes](http
10 s well as rules for combining mixin construct signatures with reg
14 A mixin constructor type refers to
14 w (...args: any[]) => X` is a mixin constructor type with an inst
16 A mixin class is a class declaratio
16 The following rules apply to mixin class declarations:
18 sion must be constrained to a mixin constructor type.
19 - The constructor of a mixin class (if any) must have a si
21 T with a constraint X, a mixin class `class C extends Base {
22 In other words, a mixin class is represented as an in
22 s an intersection between the mixin class constructor type and th
24 tersection type that contains mixin constructor types, the mixin
24 mixin constructor types, the mixin construct signatures are disc
64 Mixin classes can constrain the typ
105 is inheriting from Error in NodeJS v4 and higher.
105 riting from Error in NodeJS v4 and higher.
162 +, -, ~, ++, or -- unary operator is nullable.
189 Please see [facebook/jsx#57](https://github.com/fa
189 Please see [facebook/jsx#57](https://github.com/facebook/

Typos for TypeScript 2.1.md

Line Typo
153 cript 2.1 brings support for [ESnext Spread and Rest](https://gith
178 that don't get picked up when destructuring an element:
186 ## Downlevel Async Functions
186 ## Downlevel Async Functions
192 hat might involve grabbing [a polyfill](https://github.com/stefanpen
197 ##### tsconfig.json
207 ##### dramaticWelcome.ts
230 should result in the correct behavior on an ES3/ES5 engine.
234 elements, and __awaiter for async functions.
298 the compiler not to transform ES2016-specific features, e.g. ** operator.
300 the compiler not to transform ES2017-specific features like async/await
392 or false and the containing enum for enum literal types.
392 ` and the containing enum for enum literal types.
411 iteral type is inferred for a const location without a type annot
465 change entails a break in the behavior of extending built-in classes
476 en by those in the inheriting config file.
478 exclude from the inheriting config file overwrite those from t
478 verwrite_ those from the base config file.

Typos for TypeScript 2.0.md

Line Typo
385 roperty declared with a get accessor and no set accessor is cons
385 a get accessor and no set accessor is considered read-only.
386 * In the type of an enum object, enum members are cons
386 n the type of an enum object, enum members are considered read-o
518 dule resolution enhancements: BaseUrl, Path mapping, rootDirs and t
518 ments: BaseUrl, Path mapping, rootDirs and tracing
520 additional module resolution knops to inform the compiler wher
547 e not directly located under baseUrl.
548 es to files at run-time, see [RequireJs documentation](http://require
548 s/api.html#config-paths) and [SystemJS documentation](https://github
571 Using 'rootDirs', you can inform the compiler
619 ##### declarations.d.ts
634 /master/LoaderPlugins.md) or [SystemJS](https://github.com/systemjs/
662 useful when migrating from an un-typed code base.
688 ##### math-lib.d.ts
688 ##### math-lib.d.ts
818 * dom
819 * webworker
820 * es5
821 * es6 / es2015
821 * es6 / es2015
822 * es2015.core
823 * es2015.collection
824 * es2015.iterable
825 * es2015.promise
826 * es2015.proxy
827 * es2015.reflect
828 * es2015.generator
829 * es2015.symbol
830 * es2015.symbol.wellknown
831 * es2016
832 * es2016.array.include
833 * es2017
834 * es2017.object
835 * es2017.sharedmemory
836 * scripthost
854 cals` flags any unused local (un-exported) declaration like variables,
884 bundling/loading tools like [SystemJS](https://github.com/systemjs/
888 ## Support 'target : es5' with 'module: es6'
888 'target : es5' with 'module: es6'
890 n, target: es5 and 'module: es6' is now supported.
891 This should facilitate using ES2015-based tree shakers like [rollup](ht
891 2015-based tree shakers like [rollup](https://github.com/rollup/ro
896 s is an implementation for a [Stage-3 ECMAScript proposal](https://

Typos for TypeScript 1.8.md

Line Typo
105 ### Case clause fall-throughs
153 be use the [latest version of react.d.ts](https://github.com/Definitel
157 .8 with the latest version of react.d.ts (see above), we've also great
352 Support for default import interop with SystemJS
352 default import interop with SystemJS
354 Module loaders like SystemJS wrap CommonJS modules and exp
354 le loaders like SystemJS wrap CommonJS modules and expose then as a
354 definition files between the SystemJS and CommonJS implementation o
354 iles between the SystemJS and CommonJS implementation of the module
356 ot indicated in the imported .ts or .d.ts. The compiler will i
356 cated in the imported .ts or .d.ts. The compiler will infer the e
424 rict mode as per ES6, but for non-ES6 targets this was not respecte
469 When used in a type narowing position (e.g. if statement
509 ## Official TypeScript NuGet package
511 with TypeScript 1.8, official NuGet packages are available for th
511 er (tsc.exe) as well as the MSBuild integration (`Microsoft.TypeS
515 - [Microsoft.TypeScript.Compiler](https://www.nuget.org/packag
516 - [Microsoft.TypeScript.MSBuild](https://www.nuget.org/packag
518 Also, a nightly NuGet package to match the [nightly
518 package to match the [nightly npm package](http://blogs.msdn.co
518 htlies.aspx) is available on [myget](https://myget.org):
525 Colors can help discern where a mess
527 option, TypeScript gives more colorful output with context about whe
531 ## Colorization of JSX code in VS 2015
533 X tags are now classified and colorized in Visual Studio 2015.
537 ized by changing the font and color settings for the VB XML col
537 lor settings for the VB XML color and font settings through `To
543 ht want to target ES2015 with CommonJS modules for Node 5, but ES5 w
544 one without having to perform hacky workarounds like placing `tsc
546 The old behavior still remains the same if giv
548 ## Allow comments in tsconfig.json
568 ## Support output to IPC-driven files
580 t into a pretty printer like [pretty-js](https://www.npmjs.com/packag
589 This includes ASP.NET v4 projects, _Console Applica
589 This includes ASP.NET v4 projects, _Console Applicatio

Typos for TypeScript 1.7.md

Line Typo
8 support in ES6 targets (Node v4+)
10 for ES6 generators, e.g. Node v4 and above.
16 nted out one at a time with a 400ms delay:
41 For more information see [async function reference](https://d
46 features you want in specific runtimes.
145 in describing libraries (e.g. Ember.js) that use mixin-style pattern
145 ries (e.g. Ember.js) that use mixin-style patterns to describe inherita
176 ## Improved checking for destructuring object literal
178 eScript 1.7 makes checking of destructuring patterns with an object liter
216 TypeScript 1.7 removes the ES5-specific use of reduceRight from the

Typos for TypeScript 1.6.md

Line Typo
29 To use JSX-support with React you should use the
29 act you should use the [React typings](https://github.com/borisyank
29 ped/tree/master/react). These typings define the JSX namespace so
48 #### Using other JSX framworks
123 Local class, interface, enum, and type alias declarations
350 Async functions are expected to inv
351 plished through the use of an ES6-compatible Promise implementation, and
353 An async function is a function or me
353 await` should be treated as a unary expression instead of an iden
354 An Async Function must provide a retu
395 module names when targeting 'commonjs'.
397 include information about its typings and TypeScript compiler will
442 exclude property support in tsconfig.json
444 A tsconfig.json file that doesn't specify a f
444 implicitly references all *.ts files in all subdirectories)
445 lative to the location of the tsconfig.json file.
457 xclude` list does not support wilcards. It must simply be a list of
462 to be stored in your initial tsconfig.json on creation.

Typos for TypeScript 1.5.md

Line Typo
86 e see the [ES6 module support spec](https://github.com/Microsoft
88 ## Destructuring in declarations and assignmen
90 cript 1.5 adds support to ES6 destructuring declarations and assignments.
94 A destructuring declaration introduces one or
102 Destructuring declarations also works for e
108 Similarly, destructuring can be used in function param
122 Destructuring patterns can also be used in
123 es can be written as a single destructuring assignment:
159 #### Const
219 augment the descriptor to be writable: false and enumerable: false.
254 a variable to hold on to the neighbor-map so that we can initialize it.
274 > tsc --module umd
274 > tsc --module umd
278 > tsc --module system
280 ## Unicode codepoint escapes in strings
282 users to represent a Unicode codepoint using just a single escape.
286 that you'd have to escape the codepoint as "\uD842\uDFB7".
289 With ES6’s codepoint escapes, you can cleanly repr
295 e considerable work done by [@ivogabe](https://github.com/ivogabe),
323 informs the compiler about a non-TS module dependency that needs
326 ssing an optional name for an amd-dependency:
349 The tsconfig.json file specifies the root files
351 - By invoking tsc with no input files, in which
351 the compiler searches for the tsconfig.json file starting in the current
352 - By invoking tsc with no input files and a -pr
352 h of a directory containing a tsconfig.json file.
366 See the [tsconfig.json wiki page](https://github.com
381 The TypeSript compiler emits a few helpers
383 lace, or override the default behavior, use --noEmitHelpers to ins
388 e flag allows overriding this behavior and specifying the new line c

Typos for TypeScript 1.4.md

Line Typo
12 unning a program that takes a commandline as either a string, a `stri
65 u can now specify the desired behavior at both the function declarat
136 When compiling to pre-ES6 targets, the string is decomp
199 nst enum` (completely inlined enums)
201 Enums are very useful, but some pro
201 ply inlining all instances of enum members with their numeric eq
219 eScript will also now compute enum values when possible:
232 ## -noEmitOnError commandline option
234 The default behavior for the TypeScript compiler i
234 pt compiler is to still emit .js files if there were type erro
234 s the compiler from emitting .js code if there were any errors
236 This is now the default for MSBuild projects; this allows MSBuild
236 MSBuild projects; this allows MSBuild incremental build to work as
240 the resulting modules like a bundlers (e.g. r.js).

Typos for TypeScript 1.1.md

Line Typo
8 owingly shipped to prod while v2 is in beta - it's got a reall
8 t a really long comment and a twoslash error.
35 compiler is typically around 4x faster than any previous rele

Typos for Overview.md

Line Typo
37 This is strange behavior!
56 tion speed with packages like material-ui and styled-components.
67 ved around a 40% reduction in material-ui's compile time!
90 We'd like to test this behavior, so we'll write a unit test.
172 t/pull/36402) from [Alexander Tarasyuk](https://github.com/a-tarasyu
203 he SDK installers above] and [MSBuild installs](https://www.nuget.o
206 ### CommonJS Auto-Imports in JavaScript
208 rts in JavaScript files using CommonJS modules.
217 Plenty of users still use CommonJS-style require(...) imports like s
231 TypeScript's refactorings and quick fixes often didn't
304 26434) from community member [Wenlu Wang](https://github.com/King
337 ceived user feedback that the behavior of optional chaining (?.) w
351 s stop the "short-circuiting" behavior of optional chaining, so if `
353 e Babel team who pointed this behavior out, and most users who provi
353 back to us, believe that this behavior is wrong.
366 who want to revert to the old behavior can add explicit parentheses
375 enforce this rule to be more comformant.
378 36) enforcing this from [Brad Zacher](https://github.com/bradzache
393 fix, and thanks to [Alexander Tarasyuk](https://github.com/a-tarasyu
475 S5 and ES2015 could differ in behavior.
477 pull/32264) from GitHub user [pathurs](https://github.com/pathurs),
556 - remove: this is today's behavior of dropping these imports. It
564 private fields, part of the [stage-3 class fields proposal](https:
707 vate modifier. When using the**private keyword, privacy is only enforced at compile-time/design-t**ime, and for JavaScript consum
762 ## export * as **ns Syntax**
809 t need to write out export {}** as some boilerplate to make sure of this.**
820 lish coalescing, export * as **ns, and** dynamic import(...) syntax.
820 ng, export * as ns, and dynamic import(...) syntax.
830 e accessibility modifiers: @p**u**blic, @private, and `@prote
830 ccessibility modifiers: @publ**i**c, @private, and `@protecte
830 ity modifiers: @public, @pr**i**vate, and @protected.
830 @public, @Private, and @protected`.
831 hese tags work exactly like p**u**blic, private, and `protect
831 e tags work exactly like publ**i**c, private, and protected
831 ork exactly like public, pr**i**vate, and protected respect
831 e public, private, and pr**o**tected respectively work in T
852 - @p**u**blic is always implied and ca
852 - @publ**i**c is always implied and can b
853 - @pr**i**vate means that a property ca
854 - @pr**o**tected means that a property
854 - @protected** means that a property can only be used within the containing class, and all derived subclasses, but not on dissimilar instances of the containing class.**
856 also added the @readonly modifier to ensure that a property is only ever
856 @readonly` modifier to ensure that a property is only ever written to during initialization.
856 tten to during initialization.****
969 lues (e.g. the empty string, **0, NaN, and, well, false), but th**is is an intentional feature o
969 and, well, false), but this** is an intentional featur**e of the construct.
969 his is an intentional feature of the construct.
970 It doesn't short-circuit on valid data like 0 or empty strin
970 oesn't short-circuit on valid **data like 0 or empty **strings.
970 alid data like 0 or empty strings.
1079 ecific set of functions that **throw an error if something unexpected happened.**
1140 asserts **condition says that whatever gets **passed into the condition pa
1171 Here asserts **val** is string ensures that after
1171 Here asserts val is **string ensures that after any call to assertIsStrin**g, any variable passed in wil
1515 a new flag called useDefineF**orClassFields to enable this emit mode with some new checking logic.**
1517 iggest changes are the following:
1693 o write something like if (!!**user.isAdministrator**) to indicate that the coerci
1697 ## // @**ts-nocheck** in TypeScript Files
1699 ipt 3.7 allows us to add // @**ts-nocheck comments** to the top of TypeScript file
1699 add // @ts-nocheck comments to the top of TypeScript files to disable semantic checks.
1700 rt to TypeScript files to make** migrations easier for all users.**
1704 TypeScript's built-in formatter now supports semicolon insertion and
1704 s built-in formatter now supports semicolon insertion and removal at locations where a trailing semicolon is optional due to JavaScript's
1932 cript 3.6 introduces a new __**spreadArrays helper to accurate**ly model what happens in ECMAS
1933 __**spreadArrays is also av**ailable in [tslib](https://git
1933 __spreadArrays is also avai**lable in [tslib](https://gi**thub.com/Microsoft/tslib/).
1933 ilable in [tslib](https://gith**ub.com/Microsoft/tslib/).**
1935 hub.com/microsoft/TypeScript/pull/31166).
1939 improvements for when Promis**es are mis-handled.**
2068 mparameter in othercreate*Program` functions).
2070 rns an instance of the new type SolutionBuilder.
2221 { done: true, value: number }**.**
2284 cript 3.4's inference allows **newFn** to be generic.
2340 subsequent builds with the --**incremental flag**
2342 TypeScript 3.4 introduces a new flag called --incremental whi
2342 introduces a new flag called **--incremental which tells** TypeScript to save informatio
2342 --incremental which tells T**ypeScript to save information about the project graph from the last **compilation.
2342 t graph from the last compilation.
2343 The next time TypeScript is invoked with --incremental, it will us
2343 ime TypeScript is invoked with** --incremental, it will use that information to detect the least costly way **to type-check and emit changes
2343 detect the least costly way to** type-check and emit changes to your project.**
2514 introduces a new syntax for **ReadonlyArray using a new readonly modifier for array types.**
2536 ... Tn > - **readonly tuples are types that extend from Rea**donlyArray. So a readonly t
2538 ### **readonly mapped type modifiers and readonly arrays**
2634 f the type name (e.g. 123 as **const).**
2637 . no going from "hello" to **string)**
2789 range", and return either a numberor astring`.
2811 ew parameter of type Fruit & **Color.**
2812 Fruit & **Color** is really the same as `("app
2818 ethods on `number[]
2880 ** of the original --build --**watch times.**
2881 hange](https://github.com/Micr**osoft/TypeScript/**pull/29161) to see specific nu
2881 ub.com/Microsoft/TypeScript/pull/29161) to see specific numbers, but we believe most composite project users
2881 cific numbers, but we believe most composite project users will see significant wins here.
2881 will see significant wins here.
3005 ypeofoperator: the string"bigint"`.
3006 ript correctly narrows using **typeof as y**ou'd expect.
3024 feature doesn't exist (like **es2017 and below) would involve rewriting each of these operations.**
3057 the "extends" field in tsc**o**nfig.json, TypeScript will di
3057 e "extends" field in tsconf**i**g.json, TypeScript will dive
3057 xtends"field intsconfig.json`, TypeScript will dive into
3057 , TypeScript will dive into n**o**de_modules packages for us.
3057 ypeScript will dive into node**_**modules packages for us.
3057 eScript will dive into node_m**o**dules packages for us.
3057 cript will dive into node_mod**u**les packages for us.
3070 e, TypeScript will climb up n**o**de_modules folders looking fo
3070 TypeScript will climb up node**_**modules folders looking for a
3070 peScript will climb up node_m**o**dules folders looking for a `
3070 Script will climb up node_mod**u**les folders looking for a `@m
3070 limb up node_modules folders** looking for a @my-**team/tsconfig-base package. F
3070 folders looking for a@my-t**eam/**tsconfig-base` package. For ea
3070 r package.json contains a "**tsconfig**" field, and if it does, Type
3070 ript will try to read from a **tsconfig.json at the** root. This is similar to the
3070 rom a tsconfig.json at the r**oot. This is similar to the **lookup process for .js files
3077 When running tsc --**showConfig, TypeScript will calculate the effective tsconfig.json (after calculatin**g options inherited from the `
3083 ckJsoption or adding a// @ts-check` comment to the top of your file)
3083 ing a // @ts-check comment to the top of your file).
3119 In &#91;number, number]**, there are two numerically named prope**rties: 0 and 1.
3121 mise, Promise]`.
3189 That's what that { "*": &#91;"**ts3.1**/*"] } means - if you're fami
3191 ll try to resolve from `[...]/node_modules/package-name/ts3.1/index.d.ts
3191 ..]/node_modules/package-name/ts3.1/index.d.ts` (and other releva
3191 de_modules/package-name/ts3.1/**index.d.ts` (and **other relevant paths) when run
3192 we'll try to look for &#91;...]/**node_modules**/package-name/ts3.1/foo.d.ts
3192 ..]/node_modules/package-name/ts3.1/foo.d.tsand[...]/node_mod
3192 de_modules/package-name/ts3.1/foo.d.tsand[...]/node_modules/pack
3192 me/ts3.1/foo.d.tsand[...]/node_modules/package-name/ts3.1/foo/index.
3192 ..]/node_modules/package-name/ts3.1/foo/index.d.ts`.
3192 odules/package-name/ts3.1/foo/index.d.ts`.
3195 will be redirected to &#91;...]/**node_modules**/package-name/index.d.ts.
3195 ..]/node_modules/package-name/index.d.ts`.
3218 h both the >=3.2 and the >=**3.1 matche**rs support TypeScript 3.2 and
3298 s number, &#91;string, boolean]** and v**oid for T, U and V resp
3298 &#91;string, boolean] and void** for T, U a**nd V respectively.
3298 idforT, UandV` respectively.
3328 xample, &#91;number, ...string[]]** means tuples with a number element followed by any number of string elements.**
3542 tation is added, e.g. static **defaultProps**: Partial<Props>; the compile
3542 defaultProps: Partial;` the compiler will not be able to identify which pro
3544 Use static **defaultProps**: Pick<Props, "name">; as an
3556 orresponding changes to add L**i**braryManagedAttributes defini
3556 ges to add LibraryManagedAttr**i**butes definition to the JSX
3556 s to add LibraryManagedAttrib**u**tes definition to the JSX n
3563 sconfig.json_ (e.g. use lib="**es2015**" and not `lib="lib.es2015.d.
3563 lib="es2015" and not lib="**lib.es2015.d.ts**", etc.).
3565 S run-time constructors like **Symbol or It**erable, triple-slash-referenc
3569 lent to compiling with --lib **es2017.string.**
3586 - An index type keyof **T for s**ome type T is a subtype of `
3587 mapped type { &#91;P in K]: XXX }** permi**ts any K assignable to `stri
3587 ignable to `string
3588 - I**n a for**...in statement for an object
3588 ariable was previously keyof **T but i**s now `Extract<keyof T, string
3588 keyof T but is now Extract<**keyof** T, string>. (In other words,
3588 r words, the subset of keyof **T that** includes only string-like val
3590 en an object type X, keyof **X is r**esolved as follows:
3592 tring index signature, keyof **X is a union of s**tring, number, and the lite
3593 meric index signature, keyof **X is a unio**n of number and the literal
3602 mapped type { &#91;P in K]: XXX }**, each string literal type in K **introduces a property with a s
3639 pes such as Partial<T> and **Readonly**<T> work correctly when appli
3654 Furthermore, with the **keyof operator's support for nu**mber and symbol named keys,
3691 umed values typed with keyof **T were always** strings, will now be flagge
3719 - Otherwise use --**keyofStringsOnly compiler option **to disable the new behavior.
3774 Using import("mod")** in a type anno**tation allows for reaching in
3774 import("mod")` in a type annotation allows for reaching in a module and accessing its exported declaration without importing it.
3778 G**iven a declaration of **a class Pet in a module file
3778 Given a declaration of a class Pet in a module file:
3778 of a class Pet in a module file:
3900 ommand line or set "pretty": **false in your ts**config.json to disable `--pre
3900 "pretty": falsein yourtsconfig.jsonto disable--pretty` output.
3902 ## New --**declarationMap**
3904 Enabling --declarationMap alongside --declaration causes
3922 ional type T extends U ? X : **Y is either resolved to X or Y, or deferred beca**use the condition depends on o
3966 ional type T extends U ? X : **Y, reference**s to T within the conditiona
3981 ype of the array as T&#91;number]**. Also, notice how the conditional t**ype is distributed over the un
4124 clude<T, U>-- Exclude from**Tthose **types that are assignable to
4125 tract<T, U>-- Extract from**Tthose type**s that are assignable toU`.
4126 NonNullable<T> -- Exclude **null and undefined fr**om T.
4128 - **InstanceType**<T> -- Obtain the instance ty
4168 > Note: The **Exclude type is a proper **implementation of the Diff t
4172 apped types support adding a **readonly** or ? modifier to a mapped
4172 es support adding a readonly** or ? **modifier to a mapped property,
4172 ing a readonly or ? modifi**er to a mapped **property, but they did not pro
4191 Using this ability, **lib.d.ts now ha**s a new Required<T> type.
4192 This type strips ?** modifiers from al**l properties of T, thus maki
4192 strips ? modifiers from all** properties of T, thus maki**ng all properties required.
4212 pes of the form keyof (A & B)** are** transformed to be `keyof A
4212 transformed to be `keyof A
4213 ncies with inference from key**o**f expressions.
4240 in other words, a var or c**o**nst declaration is not requir
4240 ther words, a var or const** de**claration is not required.
4377 ### unique **symbol**
4379 e literals a new type unique **symbol is a**vailable.
4380 unique **symbol is are sub**type of symbol, and are prod
4380 unique symbol is are subty**pe of sym**bol, and are produced only fr
4380 mbolis are subtype ofsymbo**l, and are p**roduced only from calling Sym
4381 tdeclarations andreadonly static` properties, and in order to reference a
4382 Each reference to a unique **symbol impl**ies a completely unique identi
4402 Because each unique **symbol has **a completely separate identity
4402 rate identity, no two unique **symbol types are assignable or comparable to each othe**r.
4437 d it with the type `boolean
4439 an be initialized indirectly (perhaps by a helper method or dependency injection library), in which case you
4520 der the type &#91;number, string]** to be equivalent to t**he following declaration of `N
4520 ring]to be equivalent to the** following declaration ofNumStrTuple`:**
4623 For a n in **x expressi**on, where n is a string lite
4643 # Support for import d from "**cjs**" form CommonJS modules with
4643 form CommonJS modules with --**esModuleInterop**
4650 /UMD module as equivalent to **const** foo = require("foo").
4650 to const foo = require("foo")**.**
4654 /UMD module as equivalent to **const** d = require("foo").default.
4654 to const d = require("foo").**default.**
4657 Under the new --**esModuleInterop thes**e two issues should be address
4663 s from "express"; express();`).
4667 tfor import*and importdefault` respectively.
4730 etting --strictFunctionTypes **false on your command line or **in your tsconfig.json.
4738 e following example in which **Animal is t**he supertype of Dog and `Cat
4753 e is that the type (x: T) => **void is bivar**iant (i.e. covariant or con
4771 equire variance annotations (**out/**in or +/-), variance eme
4771 riance annotations (out/in** or +/-), variance emerges natu**rally from the actual use of a
4826 attern, React introduced the **React.Fragment** component, which provides a
4841 Under --**jsx** preserve, the new syntax is
4841 Under --jsx **preserve, th**e new syntax is left untouched
4841 , <>...</>is compiled toReact.createElement(React.Fragment, null, ...)`,
4841 piled to React.createElement(**React.Fragment**, null, ...), where `React.cr
4841 ent(React.Fragment, null, ...), where React.createElementrespects--jsxFac
4841 ull, ...), where React.creat**eElement**respects--jsxFactory`.
4842 ror to use <>...</> when --**jsx** react and --jsxFactory are
4842 to use <>...</> when --jsx **react and --jsxFactory are both enabled.**
4973 rrors in .js files using // @**ts-ignore** comments placed above the of
4984 A // @ts-**i**gnore comment suppresses all
4984 A // @ts-ign**o**re comment suppresses all err
4984 A // @ts-ignore** comment sup**presses all errors that origin
5001 evised implementation the --n**o**UnusedLocals and `--noUnusedP
5001 sed implementation the --noUn**u**sedLocals and `--noUnusedPara
5001 mplementation the --noUnusedL**o**cals and `--noUnusedParameter
5001 he --noUnusedLocals and --n**o**UnusedParameters [compiler op
5001 --noUnusedLocals and --noUn**u**sedParameters [compiler optio
5036 ot end up using the SyntaxErr**o**r that gets thrown when input
5048 rtion/cast syntax in checkJs**/@ts-ch**eck mode
5051 ntax is an /** @type {...} */** annotation comment followed by a pare**nthesized expression whose typ
5051 n comment followed by a parenthesized expression whose type needs to be re-evaluated.
5052 For** example:**
5078 Dynamic **import expressions are a new** feature and part of ECMAScrip
5143 **y would** have the type any.
5143 y would have the type any.
5237 ture to the weak type (i.e. &#91;**propName**: string]: {}).
5238 type assertion (i.e. opts as **Options).**
5242 ## Generators and Iteration** for ES5/ES3**
5275 #### New --**downlevelIteration**
5277 Previously generators were only supported if the target is ES6/ES2015 or l
5282 ior that attempts to call a &#91;**Symbol.iterator**]() method on the iterated ob
5284 that this requires a native **Symbol.iterator or Symbol.iterat**or shim at runtime for any no
5284 l.iteratororSymbol.iterator` shim at runtime for any non-array values.
5284 bol.iterator` shim at runtime for any non-array values.
5324 tors require a valid, global **Promise implementation (eithe**r native or an ES2015-compatib
5324 romise` implementation (either** native or **an ES2015-compatible polyfill)
5324 mentation (either native or an** ES20**15-compatible polyfill), in ad
5324 her native or an ES2015-compat**ible **polyfill), in addition to a va
5324 an ES2015-compatible polyfill)**, in addition to a valid Symbol.asyncIter**ator reference (either a nati
5344 s simple as: `(Symbol as any).asyncIterator = Symbol.asyncIterator
5344 ymbol as any).asyncIterator = Symbol.asyncIterator
5344 tor = Symbol.asyncIterator
5344 asyncIterator
5344 .from("Symbol.asyncIterator");`
5346 t is ES5 or ES3, you'll also n**eed to **set the --downlevelIterators
5403 fig.jsongenerated bytsc --initincludes a"strict": true`
5403 rict": truesetting in the"compilerOptions"` section. Thus, new projects
5403 s, new projects started with **tsc** --init will by default have
5403 projects started with tsc --**init will by default** have the highest level of typ
5407 stricton by default,tsc --**inithas an enhance**d output. Defaulttsconfig.js
5407 onfiles generated bytsc --init` now include a set of the common compiler optio
5407 tsc --init now include a set** of the com**mon compiler options along wit
5413 ing some files by adding // @**ts-nocheck** comment to them; conversely
5413 les by adding // @ts-nocheck** c**omment to them; conversely you
5413 ew .js files by adding // @**ts-check comment** to them without setting `--ch
5413 specific lines by adding // @**ts-ignore** on the preceding line.
5413 ines by adding // @ts-ignore** on the pre**ceding line.
5427 e rest argument of type any&#91;]** an**d an object-like return type.
5427 bject-like type X, new (...**args**: any&#91;]) => X is a mixin cons
5427 X, new (...args: any&#91;]) => **X is a mixin const**ructor type with an instance t
5432 ameter of type any&#91;] and must use the spread operator to pass
5432 r of type any&#91;] and must use** the spread** operator to pass those parame
5434 ss class C extends Base {...}** is proces**sed as if Base had type X
5436 e intersection type `{ new(...args: any[]) => A } & { new(s: str
5436 nature new(s: string) => A & **B.**
5449 ype Constructor = new (...args: any[]) => T;
5568 erand of a <, >, <=, >=**, or in o**perator is nullable.
5570 operand of a +, -, ~, **++, or -- unary operator is nullable.**
5576 can be indexed using the &#91;] notation, but were not allowed to
5613 ## New jsx: react-native****
5615 React-native build** pipeline expects** all files to have a .js ext
5624 An indexed type query keyof **T yiel**ds the type of permitted prope
5625 A keyof **T type is co**nsidered a subtype of string
5789 that don't get picked up when destructuring an element:
5797 ## Downlevel Async Functions
5797 ## Downlevel Async Functions
5803 hat might involve grabbing [a polyfill](https://github.com/stefanpen
5808 ##### tsconfig.json
5818 ##### dramaticWelcome.ts
5841 should result in the correct behavior on an ES3/ES5 engine.
5845 elements, and __awaiter for async functions.
5909 the compiler not to transform ES2016-specific features, e.g. ** operator.
5911 the compiler not to transform ES2017-specific features like async/await
6003 or false and the containing enum for enum literal types.
6003 ` and the containing enum for enum literal types.
6022 iteral type is inferred for a const location without a type annot
6076 change entails a break in the behavior of extending built-in classes
6087 en by those in the inheriting config file.
6089 exclude from the inheriting config file overwrite those from t
6089 verwrite_ those from the base config file.
6343 l flow based type analysis is particuarly relevant in `--strictNullChec
6518 roperty declared with a get accessor and no set accessor is cons
6518 a get accessor and no set accessor is considered read-only.
6519 - In the type of an enum object, enum members are cons
6519 n the type of an enum object, enum members are considered read-o
6646 dule resolution enhancements: BaseUrl, Path mapping, rootDirs and t
6646 ments: BaseUrl, Path mapping, rootDirs and tracing
6648 additional module resolution knops to inform the compiler wher
6675 e not directly located under baseUrl.
6676 es to files at run-time, see [RequireJs documentation](http://require
6676 s/api.html#config-paths) and [SystemJS documentation](https://github
6699 Using 'rootDirs', you can inform the compiler
6744 #### declarations.d.ts
6759 /master/LoaderPlugins.md) or [SystemJS](https://github.com/systemjs/
6787 useful when migrating from an un-typed code base.
6813 ##### math-lib.d.ts
6813 ##### math-lib.d.ts
6943 - dom
6944 - webworker
6945 - es5
6946 - es6 / es2015
6946 - es6 / es2015
6947 - es2015.core
6948 - es2015.collection
6949 - es2015.iterable
6950 - es2015.promise
6951 - es2015.proxy
6952 - es2015.reflect
6953 - es2015.generator
6954 - es2015.symbol
6955 - es2015.symbol.wellknown
6956 - es2016
6957 - es2016.array.include
6958 - es2017
6959 - es2017.object
6960 - es2017.sharedmemory
6961 - scripthost
6979 cals` flags any unused local (un-exported) declaration like variables,
7009 bundling/loading tools like [SystemJS](https://github.com/systemjs/
7013 ## Support 'target : es5' with 'module: es6'
7013 'target : es5' with 'module: es6'
7015 n, target: es5 and 'module: es6' is now supported.
7016 This should facilitate using ES2015-based tree shakers like [rollup](ht
7016 2015-based tree shakers like [rollup](https://github.com/rollup/ro
7021 s is an implementation for a [Stage-3 ECMAScript proposal](https://
7166 ### Case clause fall-throughs
7214 be use the [latest version of react.d.ts](https://github.com/Definitel
7218 .8 with the latest version of react.d.ts (see above), we've also great
7413 Support for default import interop with SystemJS
7413 default import interop with SystemJS
7415 Module loaders like SystemJS wrap CommonJS modules and exp
7415 le loaders like SystemJS wrap CommonJS modules and expose then as a
7415 definition files between the SystemJS and CommonJS implementation o
7415 iles between the SystemJS and CommonJS implementation of the module
7417 ot indicated in the imported .ts or .d.ts. The compiler will i
7417 cated in the imported .ts or .d.ts. The compiler will infer the e
7485 rict mode as per ES6, but for non-ES6 targets this was not respecte
7570 ## Official TypeScript NuGet package
7572 with TypeScript 1.8, official NuGet packages are available for th
7572 er (tsc.exe) as well as the MSBuild integration (`Microsoft.TypeS
7576 - [Microsoft.TypeScript.Compiler](https://www.nuget.org/packag
7577 - [Microsoft.TypeScript.MSBuild](https://www.nuget.org/packag
7579 Also, a nightly NuGet package to match the [nightly
7579 package to match the [nightly npm package](http://blogs.msdn.co
7586 Colors can help discern where a mess
7588 option, TypeScript gives more colorful output with context about whe
7592 ## Colorization of JSX code in VS 2015
7594 X tags are now classified and colorized in Visual Studio 2015.
7598 ized by changing the font and color settings for the VB XML col
7598 lor settings for the VB XML color and font settings through `To
7604 ht want to target ES2015 with CommonJS modules for Node 5, but ES5 w
7605 one without having to perform hacky workarounds like placing `tsc
7607 The old behavior still remains the same if giv
7609 ## Allow comments in tsconfig.json
7629 ## Support output to IPC-driven files
7641 t into a pretty printer like [pretty-js](https://www.npmjs.com/packag
7650 This includes ASP.NET v4 projects, _Console Applica
7650 This includes ASP.NET v4 projects, _Console Applicatio
7667 support in ES6 targets (Node v4+)
7669 for ES6 generators, e.g. Node v4 and above.
7674 nted out one at a time with a 200ms delay:
7699 For more information see [Async Functions](http://blogs.msdn.
7703 features you want in specific runtimes.
7799 in describing libraries (e.g. Ember.js) that use mixin-style pattern
7799 ries (e.g. Ember.js) that use mixin-style patterns to describe inherita
7829 ## Improved checking for destructuring object literal
7831 eScript 1.7 makes checking of destructuring patterns with an object liter
7868 3. TypeScript 1.7 removes the ES5-specific use of reduceRight from the
7888 To use JSX-support with React you should use the
7888 act you should use the [React typings](https://github.com/borisyank
7888 ped/tree/master/react). These typings define the JSX namespace so
7980 Local class, interface, enum, and type alias declarations
8205 functions when targeting ES6. Async functions are expected to inv
8205 plished through the use of an ES6-compatible Promise implementation, and
8207 An async function is a function or me
8207 await` should be treated as a unary expression instead of an iden
8207 instead of an identifier. An Async Function must provide a retu
8248 module names when targeting 'commonjs'. These [rules](https://githu
8248 include information about its typings and TypeScript compiler will
8289 exclude property support in tsconfig.json
8291 A tsconfig.json file that doesn't specify a f
8291 implicitly references all *.ts files in all subdirectories)
8291 lative to the location of the tsconfig.json file. For example:
8302 xclude` list does not support wilcards. It must simply be a list of
8306 to be stored in your initial tsconfig.json on creation.
8384 e see the [ES6 module support spec](https://github.com/Microsoft
8386 ## Destructuring in declarations and assignmen
8388 cript 1.5 adds support to ES6 destructuring declarations and assignments.
8392 A destructuring declaration introduces one or
8400 Destructuring declarations also works for e
8406 Similarly, destructuring can be used in function param
8420 Destructuring patterns can also be used in
8420 es can be written as a single destructuring assignment:
8454 #### Const
8479 for Iterator interfaces when targetting ES6.
8513 augment the descriptor to be writable: false and enumerable: false.
8548 a variable to hold on to the neighbor-map so that we can initialize it.
8567 > tsc --module umd
8567 > tsc --module umd
8571 > tsc --module system
8573 ## Unicode codepoint escapes in strings
8575 users to represent a Unicode codepoint using just a single escape.
8577 that you'd have to escape the codepoint as "\uD842\uDFB7". This has
8579 With ES6’s codepoint escapes, you can cleanly repr
8583 e considerable work done by [@ivogabe](https://github.com/ivogabe),
8611 informs the compiler about a non-TS module dependency that needs
8613 ssing an optional name for an amd-dependency:
8635 of a TypeScript project. The tsconfig.json file specifies the root files
8637 - By invoking tsc with no input files, in which
8637 the compiler searches for the tsconfig.json file starting in the current
8638 - By invoking tsc with no input files and a -pr
8638 h of a directory containing a tsconfig.json file.
8652 See the [tsconfig.json wiki page](https://github.com
8664 lace, or override the default behavior, use --noEmitHelpers to ins
8668 e flag allows overriding this behavior and specifying the new line c
8680 unning a program that takes a commandline as either a string, a `stri
8733 u can now specify the desired behavior at both the function declarat
8804 When compiling to pre-ES6 targets, the string is decomp
8867 nst enum` (completely inlined enums)
8869 Enums are very useful, but some pro
8869 ply inlining all instances of enum members with their numeric eq
8887 eScript will also now compute enum values when possible:
8900 ## -noEmitOnError commandline option
8902 The default behavior for the TypeScript compiler i
8902 pt compiler is to still emit .js files if there were type erro
8902 s the compiler from emitting .js code if there were any errors
8904 This is now the default for MSBuild projects; this allows MSBuild
8904 MSBuild projects; this allows MSBuild incremental build to work as
8986 compiler is typically around 4x faster than any previous rele

Typos for Templates.md

Line Typo
8 [global-modifying-module.d.ts](./templates/global-modifying
10 - [global-plugin.d.ts](/docs/handbook/declarat
10 - [global-plugin.d.ts](/docs/handbook/declaration-f
11 - [global.d.ts](/docs/handbook/declaration-f
12 - [module-class.d.ts](/docs/handbook/declaration-f
13 - [module-function.d.ts](/docs/handbook/declaration-f
14 - [module-plugin.d.ts](/docs/handbook/declarat
14 - [module-plugin.d.ts](/docs/handbook/declaration-f
15 - [module.d.ts](/docs/handbook/declaration-f

Typos for Publishing.md

Line Typo
8 , it is time to publish it to npm.
9 ish your declaration files to npm:
11 1. bundling with your npm package, or
12 ps://www.npmjs.com/~types) on npm.
14 pt then the first approach is favored.
20 ncluding declarations in your npm package
42 l dependencies are managed by npm.
44 authored a package that used Browserify and TypeScript.
62 ts declaration files with its npm packages, so we needed to dep
80 Do use `/// <reference types="..
95 - Do depend on the npm type declar
95 - Do depend on the npm type declaration package if i
124 ## Matching behavior
126 e matches is by using Node's [semver ranges](https://github.com/np
145 he order could have different behavior, so the above sample would no
162 published automatically from [DefinitelyTyped](https://github.com/Definitel
163 ase submit a pull request to [DefinitelyTyped](https://github.com/Definitel

Typos for Library Structures.md

Line Typo
31 r example, if you were using [jQuery](https://jquery.com/), the `$
77 - CommonJS/Node.js-style imports of the
77 - CommonJS/Node.js-style imports of the form `va
84 and require the DOM (or have no dependencies) may still be gl
94 mple, express only works in Node.js and must be loaded using the
94 and must be loaded using the CommonJS require function.
96 2015, ECMAScript 6, and ES6), CommonJS, and RequireJS have similar n
96 pt 6, and ES6), CommonJS, and RequireJS have similar notions of _impo
97 In JavaScript CommonJS (Node.js), for example, you w
97 In JavaScript CommonJS (Node.js), for example, you would writ
139 Many popular Node.js libraries are in the module f
144 y popular libraries, such as [Moment.js](http://momentjs.com/), are w
145 For example, in Node.js or using RequireJS, you would
145 example, in Node.js or using RequireJS, you would write:
177 often demonstrate a "Using in Node.js" example showing require,
183 Examples include [jQuery](https://jquery.com/), [Momen
183 Query](https://jquery.com/), [Moment.js](http://momentjs.com/), [loda
183 t.js](http://momentjs.com/), [lodash](https://lodash.com/), and ma
212 ## Module Plugin or UMD Plugin
212 ## Module Plugin or UMD Plugin
214 A module plugin changes the shape of another
215 For example, in Moment.js, moment-range adds a new `r
223 ## Global Plugin
225 A global plugin is global code that changes
230 ### Identifying global plugins
232 Global plugins are generally easy to identif
260 al, they're similar to global plugins, but need a require call to
337 low is to only declare types namespaced by whatever global variable
355 # The Impact of ES6 on Module Plugins
357 Some plugins add or modify top-level expor
358 While this is legal in CommonJS and other loaders, ES6 module

Typos for Introduction.md

Line Typo
33 The [Do's and Don'ts](/docs/handbook/declaration-f
50 ## Publish to npm
52 your declaration files to an npm package, and shows how to man

Typos for Do's and Don'ts.md

Line Typo
20 Do use the types number, `stri
57 Do use the return type void fo
91 Do write callback parameters as
102 that differ only on callback arity:
113 Do write a single overload using
113 le overload using the maximum arity:
142 Do sort overloads by putting the
170 Do use optional parameters whene
219 Do use union types whenever poss

Typos for Deep Dive.md

Line Typo
31 - An enum declaration (`enum E { A, B,
68 ful aspects of this combining behavior.
76 Enum declarations behave similarly
108 s a very good opportunity for destructuring in the consuming code:
182 We could also add a namespaced type to a class:
197 hows all sorts of interesting behavior:

Typos for Creating DTS files From JS.md

Line Typo
9 added support for generating .d.ts files from JavaScript using J
9 s files from JavaScript using JSDoc syntax.
11 cript, or having to maintain .d.ts files in your codebase.
12 TypeScript supports most JSDoc tags, you can find [the refer
14 ting up your Project to emit .d.ts files
16 To add creation of .d.ts files in your project, you wi
20 to generate the corresponding d.ts files for JS files
21 - (optional) Edit your package.json to reference the types
27 ### TSConfig
29 The TSConfig is a json5 file which configu
29 The TSConfig is a json5 file which configures both yo
54 ore about the options in the [tsconfig reference](/reference).
55 An alternative to using a TSConfig file is the CLI, this is the
55 is the CLI, this is the same behavior as a CLI command.
66 ## Editing the package.json
68 additional step for finding .d.ts files.
71
71
73
74
74
75
75
75 s": "./dist/main.js"
79
79
81
82
82
83
83
83 "main":"./dist/index.js"
83 n":"./dist/index.js"
87 like to write tests for your .d.ts files, try [tsd](https://gith
87 ts for your .d.ts files, try [tsd](https://github.com/SamVersch

Typos for Consumption.md

Line Typo
10 requires no tools apart from npm.
12 clarations for a library like lodash takes nothing more than the f
18 t is worth noting that if the npm package already includes its
22 m there you’ll be able to use lodash in your TypeScript code with
41 to find the package for your favorite library.
44 > Please see the DefinitelyTyped [contribution guidelines page

Typos for By Example.md

Line Typo
120 > 3 - color: Optional string, e.g. '#ff00
120 olor: Optional string, e.g. '#ff00ff'
179 > You can provide LogOptions to .log(...) and alert opti

Typos for Variable Declarations.md

Line Typo
11 to avoid some of the common "gotchas" that users run into in JavaS
151 intimately familiar with this behavior, but if you're surprised, you
371 ns have drastically different behavior when declared as part of a lo
448 # Destructuring
450 eature that TypeScript has is destructuring.
454 ## Array destructuring
456 The simplest form of destructuring is array destructuring assign
456 orm of destructuring is array destructuring assignment:
473 Destructuring works with already-declared v
513 ## Tuple destructuring
515 Tuples may be destructured like arrays; the destructurin
515 destructured like arrays; the destructuring variables get the types of th
523 It's an error to destructure a tuple beyond the range of i
529 As with arrays, you can destructure the rest of the tuple with `.
543 ## Object destructuring
545 You can also destructure objects:
559 Like array destructuring, you can have assignment with
593 o be written after the entire destructuring:
614 Destructuring also works in function declar
624 d getting defaults right with destructuring can be tricky.
636 or optional properties on the destructured property instead of the main
648 Use destructuring with care.
649 es, anything but the simplest destructuring expression is confusing.
650 ially true with deeply nested destructuring, which gets really hard to
651 Try to keep destructuring expressions small and simple.
652 ys write the assignments that destructuring would generate yourself.
656 d operator is the opposite of destructuring.
666 This gives bothPlus the value `[0, 1, 2, 3, 4, 5]

Typos for Type Inference.md

Line Typo
70 pt knows that uiEvent is a [UIEvent](https://developer.mozilla.or
70 /Web/API/UIEvent), and not a [MouseEvent](https://developer.mozilla.or

Typos for Type Compatibility.md

Line Typo
10 Script is based on structural subtyping.
36 ere TypeScript allows unsound behavior were carefully considered, an
117 ## Function Parameter Bivariance
188 # Enums
190 Enums are compatible with numbers,
190 d numbers are compatible with enums. Enum values from different e
190 rs are compatible with enums. Enum values from different enum ty
190 s. Enum values from different enum types are considered incompat
286 term defined in the language spec.

Typos for Type Checking JavaScript Files.md

Line Typo
39 ation in the constructor with JSDoc to specify the type.
61 Before ES2015, Javascript used constructor functions in
78 ## CommonJS modules are supported
80 e, TypeScript understands the CommonJS module format.
94 The module support in Javascript is much more syntactically fo
107 And, for pre-ES2015 code, it can be used to simul
163 ike other special JS checking behaviors, this behavior can be changed
163 l JS checking behaviors, this behavior can be changed by specifying
163 an be changed by specifying a JSDoc type for the variable. For ex
194 optionality on parameters in pre-ES2015 Javascript, all function para
194 y on parameters in pre-ES2015 Javascript, all function parameters in `
214 JSDoc annotated functions are exclu
215 Use JSDoc optional parameter syntax (`[
231 ## Var-args parameter declaration inferre
233 plicitly considered to have a var-arg parameter (i.e. `(...arg: any
233 (...arg: any[]) => any`). Use JSDoc var-arg syntax to specify the
233 g: any[]) => any`). Use JSDoc var-arg syntax to specify the type of
248 ng generic type parameters in Javascript, an unspecified type paramete
265 Use JSDoc @augments to specify the ty
280 ### In JSDoc references
282 unspecified type argument in JSDoc defaults to any:
310 of the features available in JSDoc, see [the reference](/docs/ha

Typos for Triple-Slash Directives.md

Line Typo
36 ve to the containing file, if unrooted.
69 e "lib" compiler option in tsconfig.json (e.g. use lib="es2015" and
71 ecommended. Previously these .d.ts files had to add forward/dupl
94 he resulting modules, such as bundlers (e.g. r.js).
98 ##### amdModule.ts
107 ##### amdModule.js
123 informs the compiler about a non-TS module dependency that needs
125 ssing an optional name for an amd-dependency:

Typos for The Handbook.md

Line Typo
10 ding trivial interactivity to webpages, JavaScript has grown to be a
10 a language of choice for both frontend and backend applications of e
10 choice for both frontend and backend applications of every size. W
12 ect assumptions about runtime behavior, or other errors. The goal of
12 TypeScript is to be a static typechecker for JavaScript programs - in
12 s of the program are correct (typechecked).
25 f the language's features and behaviors.
27 A reader who completes the walkthrough should be able to:
31 Correctly predict type system behavior in most cases
32 - Write a .d.ts declaration for a simple func
46 ses or formal descriptions of behavior will be skipped in favor of h
46 f behavior will be skipped in favor of high-level, easier-to-unde
46 many aspects of TypeScript's behavior. The reference pages are not
48 to configure TypeScript with webpack, rollup, parcel, react, babel
48 gure TypeScript with webpack, rollup, parcel, react, babel, closur
48 arcel, react, babel, closure, lerna, rush, bazel, preact, vue, an
48 babel, closure, lerna, rush, bazel, preact, vue, angular, svelte
48 closure, lerna, rush, bazel, preact, vue, angular, svelte, jquery
48 , lerna, rush, bazel, preact, vue, angular, svelte, jquery, yar
48 preact, vue, angular, svelte, jquery, yarn, or npm are out of scop
48 lar, svelte, jquery, yarn, or npm are out of scope - you can fi
52 s between TypeScript and your favored programming language, and cle

Typos for Symbols.md

Line Typo
59 o represent internal language behaviors.
65 alled by the semantics of the instanceof operator.
69 ened to its array elements by Array.prototype.concat.

Typos for Project References.md

Line Typo
36 ork with if you used a single tsconfig file:
40 mplementation files required typechecking the tests again, even though
41 nging just the tests required typechecking the implementation again, eve
43 You could use multiple tsconfig files to solve some of thos
46 oking tsc twice incurs more startup time overhead
47 tsc -w` can't run on multiple config files at once
66 sconfig.json` file, or to the config file itself (which may have a
74 greatly improve the speed of typechecking and compiling, reduce memory
123 heck in certain build outputs or build a project after cloning
124 rking on a behind-the-scenes .d.ts generation process that shoul
141 rovide tsc -b with multiple config file paths (e.g. `tsc -b src
142 like tsc -p, specifying the config file name itself is unnecessa
144 ## tsc -b Commandline
146 You can specify any number of config files:
154 ing the files you pass on the commandline - tsc will re-order them if
172 # MSBuild
174 If you have an msbuild project, you can enable build
180 to your proj file. This will enable automa
182 should be managed using your tsconfig file.
184 Some teams have set up msbuild-based workflows wherein tsconfig fi
184 build-based workflows wherein tsconfig files have the same _implicit
203 and add references to these config files to match the intended l
206 ## Structuring for outFiles

Typos for Nightly Builds.md

Line Typo
8 published by midnight PST to npm and NuGet.
8 ed by midnight PST to npm and NuGet.
11 ## Using npm
17 ## Using NuGet with MSBuild
17 ## Using NuGet with MSBuild
19 igure your project to use the NuGet packages.
20 > Please see [Configuring MSBuild projects to use NuGet](https:
20 uring MSBuild projects to use NuGet](https://github.com/Microsoft
22 e nightlies are available on [**www.myget.org**](https://www.myget.org/galler
27 : Tools as above, as well as **MSBuild** tasks and targets (Microsoft
32 o install the package through npm.
33 You can either install the npm package globally or to a loca
45 information is available at [VSCode documentation](https://code.v
55 available at the [TypeScript Plugin for Sublime Text installation
59 version of the VS TypeScript plugin.
61 tly does not include the full plugin setup, but we are working on
63 1. Download the [VSDevMode.ps1](https://github.com/Microsoft
67 2. From a PowerShell command window, run:
81 ### IntelliJ IDEA (Mac)
85 ersion: If you installed with npm: `/usr/local/lib/node_modules
87 ### IntelliJ IDEA (Windows)
91 ersion: If you installed with npm: `C:\Users\USERNAME\AppData\R

Typos for Namespaces.md

Line Typo
23 a user's input on a form in a webpage or check the format of an ext
64 # Namespacing
71 ion details, so they are left unexported and will not be visible to co
74 ## Namespaced Validators
129 ##### Validation.ts
139 ##### LettersOnlyValidator.ts
153 ##### ZipCodeValidator.ts
167 ##### Test.ts
210 to use <script> tags on our webpage to load each emitted file in
212 ##### MyTestPage.html (excerpt)
260 ##### D3.d.ts (simplified excerpt)

Typos for Namespaces and Modules.md

Line Typo
22 y on a module loader (such as CommonJs/Require.js) or a runtime whic
22 dule loader (such as CommonJs/Require.js) or a runtime which supports
25 s also worth noting that, for Node.js applications, modules are the
44 ## /// <reference>-ing a module
72 ## Needless Namespacing
102 contents, the general idea of namespacing is to provide logical groupin

Typos for Modules.md

Line Typo
19 oaders used in JavaScript are Node.js's loader for [CommonJS](https
19 ipt are Node.js's loader for [CommonJS](https://wikipedia.org/wiki/C
19 ki/CommonJS) modules and the [RequireJS](http://requirejs.org/) loade
30 ##### StringValidator.ts
38 ##### ZipCodeValidator.ts
71 ##### ParseIntBasedZipCodeValidator.ts
86 ##### AllValidators.ts
157 For instance, a library like jQuery might have a default export o
159 ##### [JQuery.d.ts](https://github.com/Definitel
166 ##### App.ts
177 ##### ZipCodeValidator.ts
188 ##### Test.ts
198 ##### StaticZipCodeValidator.ts
208 ##### Test.ts
223 ##### OneTwoThree.ts
229 ##### Log.ts
253 Both CommonJS and AMD generally have the co
256 act as a replacement for this behavior; however, the two are incompa
257 t =` to model the traditional CommonJS and AMD workflow.
260 face, namespace, function, or enum.
264 ##### ZipCodeValidator.ts
276 ##### Test.ts
297 generate appropriate code for Node.js ([CommonJS](http://wiki.commo
297 ppropriate code for Node.js ([CommonJS](http://wiki.commonjs.org/wik
297 commonjs.org/wiki/CommonJS)), require.js ([AMD](https://github.com/amd
297 tps://github.com/umdjs/umd), [SystemJS](https://github.com/systemjs/
302 ##### SimpleModule.ts
309 ##### AMD / RequireJS SimpleModule.js
309 ##### AMD / RequireJS SimpleModule.js
317 ##### CommonJS / Node SimpleModule.js
317 ##### CommonJS / Node SimpleModule.js
324 ##### UMD SimpleModule.js
340 ##### System SimpleModule.js
359 ative ECMAScript 2015 modules SimpleModule.js
370 rget on the command line. For Node.js, use --module commonjs;
371 for require.js, use --module amd. For exam
380 ##### Validation.ts
388 ##### LettersOnlyValidator.ts
402 ##### ZipCodeValidator.ts
416 ##### Test.ts
460 ### Dynamic Module Loading in Node.js
476 le: Dynamic Module Loading in require.js
496 le: Dynamic Module Loading in System.js
524 In Node.js, most tasks are accomplished
529 ##### node.d.ts (simplified excerpt)
565 ##### declarations.d.ts
580 Some module loaders such as [SystemJS](https://github.com/systemjs/
612 ##### math-lib.d.ts
612 ##### math-lib.d.ts
646 Unless it increases expressivity or intent in a clearly useful
655 #### MyClass.ts
663 #### MyFunc.ts
671 #### Consumer.ts
684 #### MyThings.ts
699 #### Consumer.ts
709 #### MyLargeModule.ts
718 #### Consumer.ts
728 extensions, similar to how JQuery extensions work.
735 #### Calculator.ts
822 #### TestCalculator.ts
833 #### ProgrammerCalculator.ts
883 Here is a test for our ProgrammerCalculator class:
885 #### TestProgrammerCalculator.ts
901 d all the collection types in System.Collections.

Typos for Module Resolution.md

Line Typo
89 rategy attempts to mimic the [Node.js](https://nodejs.org/) module
90 The full Node.js resolution algorithm is outli
90 ion algorithm is outlined in [Node.js module documentation](https:/
92 #### How Node.js resolves modules
94 portant to shed some light on Node.js modules.
95 Traditionally, imports in Node.js are performed by calling a fu
96 The behavior Node.js takes will differ dep
96 The behavior Node.js takes will differ depending o
100 Node.js resolves that import in the f
105 In our example, if Node.js found the file `/root/src/mod
105 "lib/mainModule.js" }, then **Node.js** will refer to /root/src/modu
110 u can read more about this in Node.js documentation on [file module
132 Notice that Node.js jumped up a directory in step
134 ead more about the process in Node.js documentation on [loading mod
138 TypeScript will mimic the Node.js run-time resolution strategy
152 Recall that Node.js looked for a file named `modu
154 lative import will follow the Node.js resolution logic, first looki
185 lly no more complex than what Node.js itself is doing.
208 Value of baseUrl is determined as either:
210 - value of baseUrl command line argument (if gi
211 - value of baseUrl property in 'tsconfig.json'
211 lue of baseUrl property in 'tsconfig.json' (if given path is relat
211 aseUrl_ property in 'tsconfig.json' (if given path is relative,
211 ted based on the location of 'tsconfig.json')
211 on the location of 'tsconfig.json')
213 e not impacted by setting the baseUrl, as they are always resolved
215 an find more documentation on baseUrl in [RequireJS](http://require
215 documentation on baseUrl in [RequireJS](http://requirejs.org/docs/ap
215 api.html#config-baseUrl) and [SystemJS](https://github.com/systemjs/
219 e not directly located under baseUrl.
221 es to files at run-time, see [RequireJs documentation](http://require
221 s/api.html#config-paths) and [SystemJS documentation](https://github
239 "in the above example, then **jquery** should be mapped to"../node
278 import 'folder1/file2':
278 import 'folder1/file2':
282 ative name - combine it with baseUrl -> `projectRoot/folder1/file
285 import 'folder2/file3':
285 import 'folder2/file3':
289 ative name - combine it with baseUrl -> `projectRoot/folder2/file
292 ative name - combine it with baseUrl -> `projectRoot/generated/fo
300 Using 'rootDirs', you can inform the compiler
336 may include any number of ad hoc, arbitrary directory names, r
336 n and project specific loader plugins in a type safe way.
406 dule 'typescript' from 'src/app.ts'. ========
406 'typescript' from 'src/app.ts'. ========
410 nd is not specified, using 'NodeJs'.
412 - Loading of types from npm packages
414 > 'package.json' has 'types' field './lib
414 has 'types' field './lib/typescript.d.ts' that references 'node_module
414 script.d.ts' that references 'node_modules/typescript/lib/typescript.d.t
414 'node_modules/typescript/lib/typescript.d.ts'.
418 successfully resolved to 'node_modules/typescript/lib/typescript.d.t
418 'node_modules/typescript/lib/typescript.d.ts'. ========
430 #### app.ts

Typos for Mixins.md

Line Typo
9 be familiar with the idea of mixins or traits for languages like
11 ## How Does A Mixin Work?
14 TypeScript's best mixin support is done via the class
17 d a class which will have the mixin's applied on top of:
60 epresents the base class with mixins applied:
98 ## Constrained Mixins
100 In the above form, the mixin's have no underlying knowledge
131 Then you can create mixins which only work when you have
163 nt recommended a way to write mixins where you created both the ru
211 The mixin pattern is supported natively
214 #### Decorators and Mixins [#4881](https://github.com/
216 not use decorators to provide mixins via code flow analysis:
246 #### Static Property Mixins [#17829](https://github.com

Typos for Literal Types.md

Line Typo
34 hese features together to get enum-like behavior with strings.
34 res together to get enum-like behavior with strings.
87 r their use is for describing config values:

Typos for JSX.md

Line Typo
35 corresponding option in your [tsconfig.json](/docs/handbook/tsconfig-json
57 x` files, and is identical in behavior to the angle-bracket type ass
70 element always begins with a lowercase letter, and a value-based ele
70 element always begins with an uppercase letter.
76 However, if this interface is present, then the name of the
305 attributes type_ where child JSXExpressions are taken to be inserted in
334 erride the default type from, eg the [React typings](https://g
334 ault type from, eg the [React typings](https://github.com/Definitel
398 act you should use the [React typings](https://github.com/Definitel
399 These typings define the JSX namespace ap
420 , or an inline @jsx comment pragma to set it on a per-file basis
422 The comment pragma version may be used like so (

Typos for JSDoc Reference.md

Line Typo
9 when using JSDoc annotations to provide type i
24 meaning of the tag given at [jsdoc.app](https://jsdoc.app).
27 se [the playground to explore JSDoc support](/play?useJavaScript=
31 peScript declaration, or in a JSDoc "@typedef" tag).
31 declaration, or in a JSDoc "@typedef" tag).
32 You can use most JSDoc types and any TypeScript type
89 atures, using either standard JSDoc syntax or TypeScript syntax.
152 specific and differs from the JSDoc standard:
440 ow up in JS codebases with [a JSConfig](/docs/handbook/tsconfig-json
462 When Javascript classes extend a generic base
478 nlike most object literals in Javascript, it does not allow other memb
491 However, unlike TypeScript's enums, @enum can have any type:
623 Unlike JSDoc's type system, TypeScript only
624 There is no explicit non-nullability -- if strictNullChecks is on,
624 xplicit non-nullability -- if strictNullChecks is on, then number is not n
629 cript ignores any unsupported JSDoc tags.

Typos for Iterators and Generators.md

Line Typo
8 # Iterables
10 An object is deemed iterable if it has an implementation f
16 for..of loops over an iterable object, invoking the `Symbol.
46 ainly interested in values of iterable objects. Built-in objects lik
65 When targeting an ES5 or ES3-compliant engine, iterators are only al
89 When targeting an ECMAScipt 2015-compliant engine, the co
89 When targeting an ECMAScipt 2015-compliant engine, the compiler will gen

Typos for Intro to JS with TS.md

Line Typo
11 tal typing in JavaScript [via JSDoc](/docs/handbook/jsdoc-support
21 editors which have TypeScript plugins.
23 roviding Type Hints in JS via JSDoc
25 , they can be specified using JSDoc syntax.
27 JSDoc annotations come before a dec
37 nd the full list of supported JSDoc patterns [in JSDoc Supported
37 supported JSDoc patterns [in JSDoc Supported Types](/docs/handbo

Typos for Interfaces.md

Line Typo
9 "duck typing" or "structural subtyping".
107 ## Readonly properties
182 to createSquare is spelled ****colour instead of color.
433 ecause the index signature is readonly.
624 When interacting with 3rd-party JavaScript, you may need to u

Typos for Integrating with Build Tools.md

Line Typo
16 ### .babelrc
30 ### package.json
46 # Browserify
73 More details: [smrq/tsify](https://github.com/smr
73 More details: [smrq/tsify](https://github.com/smrq/tsif
109 More details: [frankwallis/duo-typescript](https://githu
119 ### Basic Gruntfile.js
135 More details: [TypeStrong/grunt-ts](https://github.com/
135 More details: [TypeStrong/grunt-ts](https://github.com/TypeStron
145 ### Basic gulpfile.js
162 More details: [ivogabe/gulp-typescript](https://gith
164 # Jspm
172 rrently TypeScript support in jspm is in 0.16beta_
172 eScript support in jspm is in 0.16beta_
174 More details: [TypeScriptSamples/jspm](https://github.com/Micr
174 e details: [TypeScriptSamples/jspm](https://github.com/Microsoft
176 # Webpack
184 ### Basic webpack.config.js when using Webpack 2
184 webpack.config.js when using Webpack 2
205 ### Basic webpack.config.js when using Webpack 1
205 webpack.config.js when using Webpack 1
226 See [more details on ts-loader here](https://www.npmjs.com/p
232 # MSBuild
261 More details about defining MSBuild compiler options: [Setting Co
261 [Setting Compiler Options in MSBuild projects](/docs/handbook/comp
263 # NuGet
265 - Right-Click -> Manage NuGet Packages
270 be found at [Package Manager Dialog](http://docs.nuget.org/Consum
270 nd [using nightly builds with NuGet](https://github.com/Microsoft

Typos for TS for the New Programmer.md

Line Typo
11 y heard that TypeScript is a "flavor" or "variant" of JavaScript.
25 implementing JS servers using node.js.
32 uments, leading to unexpected behavior:
115 #### Runtime Behavior
117 e that preserves the runtime behavior of JavaScript.
119 never changes the runtime behavior of JavaScript code.
123 Keeping the same runtime behavior as JavaScript is a foundation
136 TypeScript never changes the behavior of your program based on the
155 ipt shares syntax and runtime behavior with JavaScript, so anything
158 le, there about 20 times more StackOverflow questions tagged javascript

Typos for TS for OOPers.md

Line Typo
20 derstand JavaScript's runtime behaviors.
23 o accomplish specific runtime behavior (converting a string to a num
29 c container of all data and behavior at runtime.
55 ### Nominal Reified Type Systems
61 These aspects describe a reified, nominal type system.
115 pt's type system is also not reified: There's nothing at runtime

Typos for TS for JS Programmers.md

Line Typo
297 ](/docs/handbook/intro.html) (30m)

Typos for TS for Functional Programmers.md

Line Typo
12 model code written by native JavaScripters. The
79
155 rs, although Haskell and most MLs are not
171 st give a name to a type; for assignability purposes
232
260 ce JavaScript has no built-in enums, it is common to use a set of
270 supertype — the unit type to the
324 e will work in any order, but intellisense will only
450 single uppercase letters. Type parameters can
478 ### Higher-kinded types
480 peScript does not have higher kinded types, so the following is no
506 You can also import commonjs modules — modules writt
506 — modules written using node.js'
578 You can also use a const-assertion, which operates on arrays and
594 ](/docs/handbook/intro.html) (30m)

Typos for Generics.md

Line Typo
56 `, it's also just as precise (ie, it doesn't lose any informat
200 ot possible to create generic enums and namespaces.

Typos for Functions.md

Line Typo
12 key role in describing how to do things.
244 avaScript, though, first read Yehuda Katz's [Understanding JavaScr
245 Yehuda's article explains the inner wo

Typos for Enums.md

Line Typo
8 Enums are one of the few features T
10 Enums allow a developer to define a
11 Using enums can make it easier to documen
12 both numeric and string-based enums.
14 ## Numeric enums
16 first start off with numeric enums, which are probably more fami
17 An enum can be defined using the `enu
28 Above, we have a numeric enum where Up is initialized wit
44 This auto-incrementing behavior is useful for cases where we
44 from other values in the same enum.
46 Using an enum is simple: just access any me
46 mber as a property off of the enum itself, and declare types usi
46 e types using the name of the enum:
61 Numeric enums can be mixed in [computed and
62 The short story is, enums without initializers either n
62 or have to come after numeric enums initialized with numeric cons
62 c constants or other constant enum members.
72 ## String enums
74 String enums are a similar concept, but ha
75 In a string enum, each member has to be consta
75 teral, or with another string enum member.
86 While string enums don't have auto-incrementing
86 don't have auto-incrementing behavior, string enums have the benefi
86 incrementing behavior, string enums have the benefit that they "s
87 he runtime value of a numeric enum, the value is often opaque -
87 time) can often help), string enums allow you to give a meaningfu
87 ndependent of the name of the enum member itself.
89 ## Heterogeneous enums
91 Technically enums can be mixed with string and
100 ntage of JavaScript's runtime behavior in a clever way, it's advised
104 Each enum member has a value associated
105 An enum member is considered constant
107 It is the first member in the enum and it has no initializer, in
116 initializer and the preceding enum member was a numeric consta
117 case the value of the current enum member will be the value of t
117 be the value of the preceding enum member plus one.
135 - The enum member is initialized with a
135 s initialized with a constant enum expression.
136 A constant enum expression is a subset of Typ
137 An expression is a constant enum expression if it is:
139 1. a literal enum expression (basically a strin
140 o previously defined constant enum member (which can originate f
140 an originate from a different enum)
141 3. a parenthesized constant enum expression
142 4. one of the +, -, ~ unary operators applied to constant
142 operators applied to constant enum expression
143 inary operators with constant enum expressions as operands
145 mpile time error for constant enum expressions to be evaluated t
147 In all other cases enum member is considered computed
161 ## Union enums and enum member types
161 ## Union enums and enum member types
163 a special subset of constant enum members that aren't calculate
163 at aren't calculated: literal enum members.
164 A literal enum member is a constant enum mem
164 ral enum member is a constant enum member with no initialized va
168 - a unary minus applied to any numeric
170 When all members in an enum have literal enum values, som
170 mbers in an enum have literal enum values, some special semantic
172 The first is that enum members also become types as
173 n only have the value of an enum member:
197 The other change is that enum types themselves effectively
197 vely become a union of each enum member.
198 ed to know is that with union enums, the type system is able to l
198 t of values that exist in the enum itself.
220 ## Enums at runtime
222 Enums are real objects that exist a
223 For example, the following enum
244 ## Enums at compile time
246 Even though Enums are real objects that exist a
246 et a Type that represents all Enum keys as strings.
275 ty names for members, numeric enums members also get a _reverse m
275 get a reverse mapping from enum values to enum names.
275 mapping_ from enum values to enum names.
297 In this generated code, an enum is compiled into an object th
298 References to other enum members are always emitted as
300 Keep in mind that string enum members do not get a revers
302 ### const enums
304 In most cases, enums are a perfectly valid solutio
306 al indirection when accessing enum values, it's possible to use
306 it's possible to use const enums.
307 Const enums are defined using the `
307 Const enums are defined using the const
307 g the const modifier on our enums:
316 Const enums can only use constant e
316 Const enums can only use constant enum ex
316 t enums can only use constant enum expressions and unlike regula
316 xpressions and unlike regular enums they are completely removed d
317 Const enum members are inlined at u
317 Const enum members are inlined at use si
318 This is possible since const enums cannot have computed me
318 This is possible since const enums cannot have computed members.
342 ## Ambient enums
344 Ambient enums are used to describe the shap
344 the shape of already existing enum types.
354 tween ambient and non-ambient enums is that, in regular enums, me
354 ent enums is that, in regular enums, members that don't have an i
354 red constant if its preceding enum member is considered constant
355 In contrast, an ambient (and non-const) enum member that does not ha
355 t, an ambient (and non-const) enum member that does not have ini

Typos for Decorators.md

Line Typo
24 tsconfig.json:
37 method](#method-decorators), [accessor](#accessor-decorators), [prop
87 del, when composing functions f and g, the resulting compos
87 n composing functions f and g, the resulting composite (f
87 g, the resulting composite (fg)(x) is equivalent to
87 he resulting composite (fg)(x) is equivalent to f(_g
87 sulting composite (fg)(x) is equivalent to f(g(x
87 g)(x) is equivalent to f(g(x)).
87 g_)(x) is equivalent to f(g(x)).
87 x) is equivalent to f(g(x)).
131 tors_, followed by Method, Accessor, or Property Decorators ar
132 tors_, followed by Method, Accessor, or Property Decorators ar
250 ## Accessor Decorators
252 An Accessor Decorator is declared just b
252 r_ is declared just before an accessor declaration.
253 The accessor decorator is applied to the _
253 Property Descriptor for the accessor and can be used to observe, m
253 bserve, modify, or replace an accessor's definitions.
254 An accessor decorator cannot be used in a
256 ting both the get and set accessor for a single member.
257 must be applied to the first accessor specified in document order.
258 ines both the get and set accessor, not each declaration separat
260 The expression for the accessor decorator will be called as a
268 If the accessor decorator returns a value, it
272 following is an example of an accessor decorator (@configurable) a
455 etadata` library which adds a polyfill for an [experimental metadata
459 can install this library via npm:
474 tsconfig.json:

Typos for Declaration Merging.md

Line Typo
30
162 only visible in the original (un-merged) namespace. This means that a
182 function that shares the same un-merged namespace can see the symbol.
183 l` namespace can not see this un-exported member.
185 with Classes, Functions, and Enums
224 espaces can be used to extend enums with static members:
252 cking class merging, see the [Mixins in TypeScript](/docs/handbook
329 l augmentations have the same behavior and limits as module augmenta

Typos for Configuring Watch.md

Line Typo
14 watches that can be created, eg. linux and we could exhaust i
14 ches that can be created, eg. linux and we could exhaust it prett
14 .watch` to watch directories (eg. source directories included
14 ource directories included by config file, directories in which mo
16 hFile` to watch source files, config files and missing files (miss
49 g intervals for source files, config files and missing files
51 on/deletion. Note that few OS eg. linux has limit on number of
51 eletion. Note that few OS eg. linux has limit on number of watche

Typos for Compiler Options.md

Line Typo
30 out the compiler options in a tsconfig, check out the [TSConfig Refe
30 in a tsconfig, check out the [TSConfig Reference](/tsconfig)**
36 es not affect code emit, just typechecking.
37
49
52
52 bles in for..of, spread and destructuring when targeting ES5 or ES3.
56 wSyntheticDefaultImports` for typesystem compatibility.
60 file`
60 d of a file path will cause a timestamp-named profile to be generated in th
65 Emit the source alongside the sourcemaps within a single file; require
67 ransform-function) or [@babel/plugin-transform-typescript](https://babeljs.io/docs/en/b
77 different location than the .js files. The location specified
77 ified will be embedded in the sourceMap to direct the debugger where
78 endency depth to search under node_modules and load JavaScript files. On
80 resolved. Either "Node" for Node.js/io.js style resolution, or `"
80 . Either "Node" for Node.js/io.js style resolution, or `"Classi
81 "crlf" (windows) or "lf" (unix)."
86
100
100
100 tions in generated code. See [const enums documentation](https://
100 in generated code. See [const enums documentation](https://github
103 ize errors and messages using color and context.
104 tsconfig.json` file.
See [tsconfig.json](/docs/handbook/tsconfig-json
109 odule-resolution.html./Module%20Resolution.md#virtual-directories-with-root
109 .html./Module%20Resolution.md#virtual-directories-with-rootdirs) for more details.
110 h the other input options and config files, show the final implied
110 files, show the final implied config file in the output.
114 ified will be embedded in the sourceMap to direct the debugger where
117
125 ns to include. See [@types, --typeRoots and --types](/tsconfig#types)
126 initions from. See [@types, --typeRoots and --types](/tsconfig#types)
136 Setting compiler options in [MSBuild projects](/docs/handbook/comp
137 - There's also out the [TSConfig Reference](/tsconfig).

Typos for Compiler Options in MSBuild.md

Line Typo
10 ptions can be specified using MSBuild properties within an MSBuild
10 MSBuild properties within an MSBuild project.
30 Option
32
33 yntheticDefaultImports`
34 nreachableCode`
35 nusedLabels`
36 Strict`
37 l`
38 t`
39 ation`
40 ationDir`
41
42
43 M`
44 coratorMetadata`
45 clarationOnly`
46 leInterop`
47 mentalAsyncFunctions`
48 mentalDecorators`
49 onsistentCasingInFileNames`
50
51 Helpers`
52 SourceMap`
53 Sources`
54
55 edModules`
56
57 tory`
58 gmentFactory`
59
60
61
62
63 t`
64
65 `
66 Resolution`
67 e`
68
69 Helpers`
70 OnError`
71 throughCasesInSwitch`
72 icitAny`
73 icitReturns`
74 icitThis`
75 icitUseStrict`
76 ctGenericChecks`
77 edLocals`
78 edParameters`
79
80 lve`
81
82 `
83 e`
84
85 veConstEnums`
86 veSymlinks`
87
88
89 amespace`
90 Comments`
91 r`
92
93 bCheck`
94 faultLibCheck`
95 Map`
96 Root`
97 `
98 FunctionTypes`
99 NullChecks`
100 PropertyInitialization`
101 nternal`
102 ssExcessPropertyErrors`
103 ssImplicitAnyIndexErrors`
104 `
105
106
107
108 ineForClassFields`
109
110
110 only option_
115 uthoritative mappings between MSBuild XML tags and tsc compiler o
117 ## ToolsVersion
126 ## TypeScriptCompileBlocked

Typos for Classes.md

Line Typo
69 ase classes are often called superclasses.
136 hat each member be explicitly labeled public to be visible.
291 # Readonly modifier
293 You can make properties readonly by using the readonly keywo
294 Readonly properties must be initialize
310 example, we had to declare a readonly member name and a construct
379 o prove to ourselves that our accessor is now checking the length of
384 Downleveling to ECMAScript 3 is not suppor

Typos for Basic Types.md

Line Typo
15 The most basic datatype is the simple true/false valu
23 ther floating point values or BigIntegers.
24 get the type number, while BigIntegers get the type bigint.
38 ng programs in JavaScript for webpages and servers alike is working
39 ng` to refer to these textual datatypes.
48 re surrounded by the backtick/backquote (`) character, and embe
128 # Enum
130 dition to the standard set of datatypes from JavaScript is the enum
131 As in languages like C#, an enum is a way of giving more frien
142 By default, enums begin numbering their members
155 lly set all the values in the enum:
166 A handy feature of enums is that you can also go from
166 the name of that value in the enum.
167 that mapped to in the Color enum above, we could look up the c
307 able to, every type; however, no type is a subtype of, or assi

Typos for Advanced Types.md

Line Typo
12 Union types are useful for modeling situations when values can ov
132 These _typeof type guards_ are reco
132 These typeof type **guards** are recognized in two differe
139 _instanceof type guards_ are
139 instanceof type **guards** are a way of narrowing types
140 , let's borrow our industrial string-padder example from earlier:
192 The inventor of null, Tony Hoare, calls this his ["billion dol
374 hese features together to get enum-like behavior with strings.
374 res together to get enum-like behavior with strings.
435 # Enum Member Types
437 mentioned in [our section on enums](./enums.html#union-enums-and
437 enums-and-enum-member-types), enum members have types when every
439 pes", we're referring to both enum member types as well as numer
562 This is called F-bounded polymorphism.
734 Or we might want a readonly version:
824 example, if Person.name was readonly, Partial<Person>.name would
824 artial.name` would be readonly and optional.

Typos for README.md

Line Typo
30 deploys to production of the v1 website, and the v2 of branch
30 on of the v1 website, and the v2 of branch in a [/v2 subfold
41 ## TypeScriptLang-Org
49 To save your time, twoslash is not applied to code-sample
49 - to launch the server with **twoslash** support use:yarn start-twos
53 ll sites which want to show a monaco editor
62 ## TSConfig Reference
64 hensive API reference for the TSConfig JSON file.
87 Originally ported over from [microsoft/TypeScript-Handbook](https://
87 ook/) then intermingled with [microsoft/TypeScript-New-Handbook](http
87 ok), and finally updated for [Twoslash](http://www.staging-typescrip
97 ## TS Twoslash
99 for TypeScript. Available on npm: [@typescript/twoslash](https
99 vailable on npm: [@typescript/twoslash](https://www.npmjs.com/packag
103 ode environment. Available on npm: [@typescript/vfs](https://ww
103 vailable on npm: [@typescript/vfs](https://www.npmjs.com/packag
105 ## Create Playground Plugin
107 r generating a new playground plugin which you can use via `npm in
109 ## Handbook Epub
111 Generates an epub file from the handbook files.
123 you submit a pull request, a CLA-bot will automatically determine
129 contact [o[email protected]](mailto:
129 contact [openco[email protected]](mailto:openc
129 contact [opencode@microsoft.com](mailto:[email protected]

Generated by 🚫 dangerJS against 2d8e28b

@orta orta merged commit a6aa68f into v2 Jul 25, 2020
@jakebailey jakebailey deleted the i8n-handbook branch May 17, 2024 22:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant