Skip to content

Commit efb7013

Browse files
committed
Merge commits from master
2 parents ebe755b + 8a0077f commit efb7013

File tree

183 files changed

+3832
-2033
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

183 files changed

+3832
-2033
lines changed

CONTRIBUTING.md

Lines changed: 47 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -31,44 +31,75 @@ Your pull request should:
3131
## Running the Tests
3232
To run all tests, invoke the runtests target using jake:
3333

34-
`jake runtests`
34+
```Shell
35+
jake runtests
36+
```
3537

3638
This run will all tests; to run only a specific subset of tests, use:
3739

38-
`jake runtests tests=<regex>`
40+
```Shell
41+
jake runtests tests=<regex>
42+
```
3943

4044
e.g. to run all compiler baseline tests:
4145

42-
`jake runtests tests=compiler`
46+
```Shell
47+
jake runtests tests=compiler
48+
```
4349

44-
or to run specifc test:tests\cases\compiler\2dArrays.ts
50+
or to run specifc test: `tests\cases\compiler\2dArrays.ts`
4551

46-
`jake runtests tests=2dArrays`
52+
```Shell
53+
jake runtests tests=2dArrays
54+
```
4755

4856
## Adding a Test
49-
To add a new testcase, simply place a .ts file in tests\cases\compiler containing code that exemplifies the bugfix or change you are making.
57+
To add a new testcase, simply place a `.ts` file in `tests\cases\compiler` containing code that exemplifies the bugfix or change you are making.
5058

51-
These files support metadata tags in the format // @name: value . The supported names and values are:
59+
These files support metadata tags in the format `// @metaDataName: value`. The supported names and values are:
5260

53-
* comments, sourcemap, noimplicitany, declaration: true or false (corresponds to the compiler command-line options of the same name)
54-
* target: ES3 or ES5 (same as compiler)
55-
* out, outDir: path (same as compiler)
56-
* module: local, commonjs, or amd (local corresponds to not passing any compiler --module flag)
61+
* `comments`, `sourcemap`, `noimplicitany`, `declaration`: true or false (corresponds to the compiler command-line options of the same name)
62+
* `target`: ES3 or ES5 (same as compiler)
63+
* `out`, outDir: path (same as compiler)
64+
* `module`: local, commonjs, or amd (local corresponds to not passing any compiler --module flag)
65+
* `fileName`: path
66+
* These tags delimit sections of a file to be used as separate compilation units. They are useful for tests relating to modules. See below for examples.
5767

58-
**Note** that if you have a test corresponding to a specific spec compliance item, you can place it in tests\cases\conformance in an appropriately-named subfolder.
68+
**Note** that if you have a test corresponding to a specific spec compliance item, you can place it in `tests\cases\conformance` in an appropriately-named subfolder.
5969
**Note** that filenames here must be distinct from all other compiler testcase names, so you may have to work a bit to find a unique name if it's something common.
6070

71+
### Tests for multiple files
72+
73+
When one needs to test for scenarios which require multiple files, it is useful to use the `fileName` metadata tag as such:
74+
75+
```TypeScript
76+
// @fileName: file1.ts
77+
export function f() {
78+
}
79+
80+
// @fileName: file2.ts
81+
import { f as g } from "file1";
82+
83+
var x = g();
84+
```
85+
86+
One can also write a project test, but it is slightly more involved.
87+
6188
## Managing the Baselines
62-
Compiler testcases generate baselines that track the emitted .js, the errors produced by the compiler, and the type of each expression in the file. Additionally, some testcases opt in to baselining the source map output.
89+
Compiler testcases generate baselines that track the emitted `.js`, the errors produced by the compiler, and the type of each expression in the file. Additionally, some testcases opt in to baselining the source map output.
6390

6491
When a change in the baselines is detected, the test will fail. To inspect changes vs the expected baselines, use
6592

66-
`jake diff`
93+
```Shell
94+
jake diff
95+
```
6796

6897
After verifying that the changes in the baselines are correct, run
6998

70-
`jake baseline-accept`
99+
```Shell
100+
jake baseline-accept
101+
```
71102

72-
to establish the new baselines as the desired behavior. This will change the files in tests\baselines\reference, which should be included as part of your commit. It's important to carefully validate changes in the baselines.
103+
to establish the new baselines as the desired behavior. This will change the files in `tests\baselines\reference`, which should be included as part of your commit. It's important to carefully validate changes in the baselines.
73104

74105
**Note** that baseline-accept should only be run after a full test run! Accepting baselines after running a subset of tests will delete baseline files for the tests that didn't run.

Jakefile.js

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,8 @@ var harnessSources = [
129129
"services/preProcessFile.ts",
130130
"services/patternMatcher.ts",
131131
"versionCache.ts",
132-
"convertToBase64.ts"
132+
"convertToBase64.ts",
133+
"transpile.ts"
133134
].map(function (f) {
134135
return path.join(unittestsDirectory, f);
135136
})).concat([
@@ -506,7 +507,7 @@ function cleanTestDirs() {
506507
// used to pass data from jake command line directly to run.js
507508
function writeTestConfigFile(tests, testConfigFile) {
508509
console.log('Running test(s): ' + tests);
509-
var testConfigContents = '{\n' + '\ttest: [\'' + tests + '\']\n}';
510+
var testConfigContents = JSON.stringify({ test: [tests]});
510511
fs.writeFileSync('test.config', testConfigContents);
511512
}
512513

@@ -689,4 +690,4 @@ task('tsc-instrumented', [loggedIOJsPath, instrumenterJsPath, tscFile], function
689690
complete();
690691
});
691692
ex.run();
692-
}, { async: true });
693+
}, { async: true });

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@
55
[![Downloads](http://img.shields.io/npm/dm/TypeScript.svg)](https://npmjs.org/package/typescript)
66

77
# TypeScript
8-
9-
[![Join the chat at https://gitter.im/Microsoft/TypeScript](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Microsoft/TypeScript?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
8+
9+
[![Join the chat at https://gitter.im/Microsoft/TypeScript](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Microsoft/TypeScript?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
1010

1111
[TypeScript](http://www.typescriptlang.org/) is a language for application-scale JavaScript. TypeScript adds optional types, classes, and modules to JavaScript. TypeScript supports tools for large-scale JavaScript applications for any browser, for any host, on any OS. TypeScript compiles to readable, standards-based JavaScript. Try it out at the [playground](http://www.typescriptlang.org/Playground), and stay up to date via [our blog](http://blogs.msdn.com/typescript) and [twitter account](https://twitter.com/typescriptlang).
1212

@@ -31,7 +31,7 @@ There are many ways to [contribute](https://github.com/Microsoft/TypeScript/blob
3131

3232
## Building
3333

34-
In order to build the TypeScript compiler, ensure that you have [Git](http://git-scm.com/downloads) and [Node.js](http://nodejs.org/) installed. Note that you need to have autocrlf off as we track whitespace changes (`git config --global core.autocrlf false`).
34+
In order to build the TypeScript compiler, ensure that you have [Git](http://git-scm.com/downloads) and [Node.js](http://nodejs.org/) installed.
3535

3636
Clone a copy of the repo:
3737

bin/lib.d.ts

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11335,10 +11335,10 @@ declare var MediaQueryList: {
1133511335
interface MediaSource extends EventTarget {
1133611336
activeSourceBuffers: SourceBufferList;
1133711337
duration: number;
11338-
readyState: string;
11338+
readyState: number;
1133911339
sourceBuffers: SourceBufferList;
1134011340
addSourceBuffer(type: string): SourceBuffer;
11341-
endOfStream(error?: string): void;
11341+
endOfStream(error?: number): void;
1134211342
removeSourceBuffer(sourceBuffer: SourceBuffer): void;
1134311343
}
1134411344

@@ -12067,7 +12067,7 @@ declare var PopStateEvent: {
1206712067

1206812068
interface Position {
1206912069
coords: Coordinates;
12070-
timestamp: Date;
12070+
timestamp: number;
1207112071
}
1207212072

1207312073
declare var Position: {
@@ -14748,9 +14748,17 @@ interface WebGLRenderingContext {
1474814748
stencilMaskSeparate(face: number, mask: number): void;
1474914749
stencilOp(fail: number, zfail: number, zpass: number): void;
1475014750
stencilOpSeparate(face: number, fail: number, zfail: number, zpass: number): void;
14751+
texImage2D(target: number, level: number, internalformat: number, width: number, height: number, border: number, format: number, type: number, pixels: ArrayBufferView): void;
14752+
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, image: HTMLImageElement): void;
14753+
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, canvas: HTMLCanvasElement): void;
14754+
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, video: HTMLVideoElement): void;
1475114755
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, pixels: ImageData): void;
1475214756
texParameterf(target: number, pname: number, param: number): void;
1475314757
texParameteri(target: number, pname: number, param: number): void;
14758+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, width: number, height: number, format: number, type: number, pixels: ArrayBufferView): void;
14759+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, image: HTMLImageElement): void;
14760+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, canvas: HTMLCanvasElement): void;
14761+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, video: HTMLVideoElement): void;
1475414762
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, pixels: ImageData): void;
1475514763
uniform1f(location: WebGLUniformLocation, x: number): void;
1475614764
uniform1fv(location: WebGLUniformLocation, v: any): void;
@@ -15990,10 +15998,11 @@ interface DocumentEvent {
1599015998
createEvent(eventInterface:"AriaRequestEvent"): AriaRequestEvent;
1599115999
createEvent(eventInterface:"AudioProcessingEvent"): AudioProcessingEvent;
1599216000
createEvent(eventInterface:"BeforeUnloadEvent"): BeforeUnloadEvent;
16001+
createEvent(eventInterface:"ClipboardEvent"): ClipboardEvent;
1599316002
createEvent(eventInterface:"CloseEvent"): CloseEvent;
1599416003
createEvent(eventInterface:"CommandEvent"): CommandEvent;
1599516004
createEvent(eventInterface:"CompositionEvent"): CompositionEvent;
15996-
createEvent(eventInterface: "CustomEvent"): CustomEvent;
16005+
createEvent(eventInterface:"CustomEvent"): CustomEvent;
1599716006
createEvent(eventInterface:"DeviceMotionEvent"): DeviceMotionEvent;
1599816007
createEvent(eventInterface:"DeviceOrientationEvent"): DeviceOrientationEvent;
1599916008
createEvent(eventInterface:"DragEvent"): DragEvent;
@@ -16016,8 +16025,6 @@ interface DocumentEvent {
1601616025
createEvent(eventInterface:"MouseEvent"): MouseEvent;
1601716026
createEvent(eventInterface:"MouseEvents"): MouseEvent;
1601816027
createEvent(eventInterface:"MouseWheelEvent"): MouseWheelEvent;
16019-
createEvent(eventInterface:"MSGestureEvent"): MSGestureEvent;
16020-
createEvent(eventInterface:"MSPointerEvent"): MSPointerEvent;
1602116028
createEvent(eventInterface:"MutationEvent"): MutationEvent;
1602216029
createEvent(eventInterface:"MutationEvents"): MutationEvent;
1602316030
createEvent(eventInterface:"NavigationCompletedEvent"): NavigationCompletedEvent;
@@ -16630,6 +16637,7 @@ declare function addEventListener(type: "volumechange", listener: (ev: Event) =>
1663016637
declare function addEventListener(type: "waiting", listener: (ev: Event) => any, useCapture?: boolean): void;
1663116638
declare function addEventListener(type: "wheel", listener: (ev: WheelEvent) => any, useCapture?: boolean): void;
1663216639
declare function addEventListener(type: string, listener: EventListenerOrEventListenerObject, useCapture?: boolean): void;
16640+
1663316641
/////////////////////////////
1663416642
/// WorkerGlobalScope APIs
1663516643
/////////////////////////////

bin/lib.dom.d.ts

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10165,10 +10165,10 @@ declare var MediaQueryList: {
1016510165
interface MediaSource extends EventTarget {
1016610166
activeSourceBuffers: SourceBufferList;
1016710167
duration: number;
10168-
readyState: string;
10168+
readyState: number;
1016910169
sourceBuffers: SourceBufferList;
1017010170
addSourceBuffer(type: string): SourceBuffer;
10171-
endOfStream(error?: string): void;
10171+
endOfStream(error?: number): void;
1017210172
removeSourceBuffer(sourceBuffer: SourceBuffer): void;
1017310173
}
1017410174

@@ -10897,7 +10897,7 @@ declare var PopStateEvent: {
1089710897

1089810898
interface Position {
1089910899
coords: Coordinates;
10900-
timestamp: Date;
10900+
timestamp: number;
1090110901
}
1090210902

1090310903
declare var Position: {
@@ -13578,9 +13578,17 @@ interface WebGLRenderingContext {
1357813578
stencilMaskSeparate(face: number, mask: number): void;
1357913579
stencilOp(fail: number, zfail: number, zpass: number): void;
1358013580
stencilOpSeparate(face: number, fail: number, zfail: number, zpass: number): void;
13581+
texImage2D(target: number, level: number, internalformat: number, width: number, height: number, border: number, format: number, type: number, pixels: ArrayBufferView): void;
13582+
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, image: HTMLImageElement): void;
13583+
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, canvas: HTMLCanvasElement): void;
13584+
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, video: HTMLVideoElement): void;
1358113585
texImage2D(target: number, level: number, internalformat: number, format: number, type: number, pixels: ImageData): void;
1358213586
texParameterf(target: number, pname: number, param: number): void;
1358313587
texParameteri(target: number, pname: number, param: number): void;
13588+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, width: number, height: number, format: number, type: number, pixels: ArrayBufferView): void;
13589+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, image: HTMLImageElement): void;
13590+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, canvas: HTMLCanvasElement): void;
13591+
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, video: HTMLVideoElement): void;
1358413592
texSubImage2D(target: number, level: number, xoffset: number, yoffset: number, format: number, type: number, pixels: ImageData): void;
1358513593
uniform1f(location: WebGLUniformLocation, x: number): void;
1358613594
uniform1fv(location: WebGLUniformLocation, v: any): void;
@@ -14820,10 +14828,11 @@ interface DocumentEvent {
1482014828
createEvent(eventInterface:"AriaRequestEvent"): AriaRequestEvent;
1482114829
createEvent(eventInterface:"AudioProcessingEvent"): AudioProcessingEvent;
1482214830
createEvent(eventInterface:"BeforeUnloadEvent"): BeforeUnloadEvent;
14831+
createEvent(eventInterface:"ClipboardEvent"): ClipboardEvent;
1482314832
createEvent(eventInterface:"CloseEvent"): CloseEvent;
1482414833
createEvent(eventInterface:"CommandEvent"): CommandEvent;
1482514834
createEvent(eventInterface:"CompositionEvent"): CompositionEvent;
14826-
createEvent(eventInterface: "CustomEvent"): CustomEvent;
14835+
createEvent(eventInterface:"CustomEvent"): CustomEvent;
1482714836
createEvent(eventInterface:"DeviceMotionEvent"): DeviceMotionEvent;
1482814837
createEvent(eventInterface:"DeviceOrientationEvent"): DeviceOrientationEvent;
1482914838
createEvent(eventInterface:"DragEvent"): DragEvent;
@@ -14846,8 +14855,6 @@ interface DocumentEvent {
1484614855
createEvent(eventInterface:"MouseEvent"): MouseEvent;
1484714856
createEvent(eventInterface:"MouseEvents"): MouseEvent;
1484814857
createEvent(eventInterface:"MouseWheelEvent"): MouseWheelEvent;
14849-
createEvent(eventInterface:"MSGestureEvent"): MSGestureEvent;
14850-
createEvent(eventInterface:"MSPointerEvent"): MSPointerEvent;
1485114858
createEvent(eventInterface:"MutationEvent"): MutationEvent;
1485214859
createEvent(eventInterface:"MutationEvents"): MutationEvent;
1485314860
createEvent(eventInterface:"NavigationCompletedEvent"): NavigationCompletedEvent;
@@ -15459,4 +15466,4 @@ declare function addEventListener(type: "unload", listener: (ev: Event) => any,
1545915466
declare function addEventListener(type: "volumechange", listener: (ev: Event) => any, useCapture?: boolean): void;
1546015467
declare function addEventListener(type: "waiting", listener: (ev: Event) => any, useCapture?: boolean): void;
1546115468
declare function addEventListener(type: "wheel", listener: (ev: WheelEvent) => any, useCapture?: boolean): void;
15462-
declare function addEventListener(type: string, listener: EventListenerOrEventListenerObject, useCapture?: boolean): void;
15469+
declare function addEventListener(type: string, listener: EventListenerOrEventListenerObject, useCapture?: boolean): void;

0 commit comments

Comments
 (0)