Skip to content

Commit 630c02b

Browse files
alexeaglealexeagle
committed
8d2b8db chore(build): let our docker build run as root
1 parent 56160c6 commit 630c02b

798 files changed

Lines changed: 104424 additions & 0 deletions

File tree

Some content is hidden

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

‎.gitignore‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
.DS_STORE
2+
3+
# Don’t commit the following directories created by pub.
4+
packages
5+
pubspec.lock
6+
.pub
7+
.packages
8+
9+
/dist/
10+
.buildlog
11+
node_modules
12+
bower_components
13+
14+
# Or broccoli working directory
15+
tmp
16+
17+
# Or the files created by dart2js.
18+
*.dart.js
19+
*.dart.precompiled.js
20+
*.js_
21+
*.js.deps
22+
*.js.map
23+
24+
# Or type definitions we mirror from github
25+
# (NB: these lines are removed in publish-build-artifacts.sh)
26+
27+
# Include when developing application packages.
28+
pubspec.lock
29+
.c9
30+
.idea/
31+
.settings/
32+
*.swo
33+
modules/.settings
34+
.vscode
35+
modules/.vscode
36+
37+
# Don't check in secret files
38+
*secret.js
39+
40+
# Ignore npm debug log
41+
npm-debug.log
42+
43+
/docs/bower_components/
44+
45+
# build-analytics
46+
.build-analytics
47+
48+
# built dart payload tests
49+
/modules_dart/payload/**/build

‎BUILD_INFO‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
Wed Mar 9 18:02:48 UTC 2016
2+
8d2b8db738314f4f3e3f583b0f4c1c0956ed188b

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
The MIT License
2+
3+
Copyright (c) 2014-2016 Google, Inc. http://angular.io
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in
13+
all copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21+
THE SOFTWARE.

‎README.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
Angular2
2+
=========
3+
4+
The sources for this package are in the main [Angular2](https://github.com/angular/angular) repo. Please file issues and pull requests against that repo. This is the repository for the upcoming 2.0 version. If you're looking for the current official version of Angular you should go to [angular/angular.js](https://github.com/angular/angular.js)
5+
6+
License: Apache MIT 2.0

‎_analyzer.dart‎

Lines changed: 521 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/bundles/overview.md‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
# TL;DR;
2+
3+
* If you write ES5 use _one_ of the `UMD` bundles.
4+
* If you experiment with Angular2 using online prototyping tools like [plnkr](http://plnkr.co/) or similar use `System.register` bundles with SystemJS loader.
5+
* If you use build tools like Browserify or WebPack - bundle Angular2 as part of your build.
6+
* For all the above cases you must use `angular2-polyfills.js` in a `script` tag to easily include polyfills and external dependencies.
7+
8+
# Modules, barrels and bundles
9+
10+
Angular2 source code is authored using the ES2015 standardized module format where one module corresponds to exactly one file. Multiple modules (files) can be logically grouped into so-called "barrels".
11+
A bundle is a file that contains all the code for one or more barrels.
12+
13+
Most bundles come in several flavors:
14+
* regular and minified (got `.min` in their name);
15+
* regular and "development" (have `.dev` in their name) - "development" bundles contain in-line source maps and don't have minified flavor (minification removes in-lined source maps).
16+
17+
# Bundles, their content and usage scenarios
18+
19+
Angular 2 distributes several types of bundles targeted at specific usages:
20+
* users writing ES5 code without any transpilation steps
21+
* users experimenting with Angular 2 and TypeScript/ES2015 using online tools like plunker, jsbin or similar
22+
23+
Since each identified scenario has slightly different requirements and constraints there are specific bundles for each use-case.
24+
25+
## ES5 and ngUpgrade users
26+
27+
ES5 users and AngularJS 1.x users interested in the `ngUpgrade` path can take advantage of the bundles in the [UMD format](https://github.com/umdjs/umd).
28+
Those are coarse-grained bundles that combine many barrels in one final file.
29+
30+
filename | list of barrels | dev/prod | minified?
31+
------------|-------------------|----------|-------------|--------------|-------------
32+
`angular2-all.umd.js` | `angular2/core`, `angular2/common`, `angular2/compiler`, `angular2/platform/browser`, `angular2/platform/common_dom`, `angular2/http`, `angular2/router`, `angular2/instrumentation`, `angular2/upgrade`| prod | no
33+
`angular2-all.umd.min.js` | `angular2/core`, `angular2/common`, `angular2/compiler`, `angular2/platform/browser`, `angular2/platform/common_dom`, `angular2/http`, `angular2/router`, `angular2/instrumentation`, `angular2/upgrade` | prod | yes
34+
`angular2-all.umd.dev.js` | `angular2/core`, `angular2/common`, `angular2/compiler`, `angular2/platform/browser`, `angular2/platform/common_dom`, `angular2/http`, `angular2/router`, `angular2/instrumentation`, `angular2/upgrade` | dev | no
35+
`angular2-all-testing.umd.dev.js` | `angular2/core`, `angular2/common`, `angular2/compiler`, `angular2/platform/browser`, `angular2/platform/common_dom`, `angular2/http`, `angular2/router`, `angular2/instrumentation`, `angular2/upgrade`, `angular2/testing`, `angular2/http/testing`, `angular2/router/testing`, `angular2/platform/testing/browser` | dev | no
36+
37+
**Warning**: bundles in the `UMD` format are _not_ "additive". A single application should use only one bundle from the above list.
38+
39+
## SystemJS loader users
40+
41+
[SystemJS loader](https://github.com/systemjs/systemjs) with on-the-fly (in a browser) transpilations support is very useful for quick experiments using tools like plunker, jsbin or similar.
42+
For this scenario Angular 2 is distributed with bundles in the [System.register format](https://github.com/ModuleLoader/es6-module-loader/wiki/System.register-Explained):
43+
44+
filename | list of barrels | dev/prod | minified?
45+
------------|-------------------|----------|-------------|--------------|-------------
46+
`angular2.js` | `angular2/core`, `angular2/common`, `angular2/compiler`, `angular2/platform/browser`, `angular2/platform/common_dom`, `angular2/instrumentation`| prod | no
47+
`angular2.min.js` | `angular2/core`, `angular2/common`, `angular2/compiler`, `angular2/platform/browser`, `angular2/platform/common_dom`, `angular2/instrumentation`| prod | yes
48+
`angular2.dev.js` | `angular2/core`, `angular2/common`, `angular2/compiler`, `angular2/platform/browser`, `angular2/platform/common_dom`, `angular2/instrumentation`| dev | no
49+
`http.js` | `angular2/http` | prod | no
50+
`http.min.js` | `angular2/http` | prod | yes
51+
`http.dev.js` | `angular2/http` | dev | no
52+
`router.js` | `angular2/router` | prod | no
53+
`router.min.js` | `angular2/router` | prod | yes
54+
`router.dev.js` | `angular2/router` | dev | no
55+
`upgrade.js` | `angular2/upgrade` | prod | no
56+
`upgrade.min.js` | `angular2/upgrade` | prod | yes
57+
`upgrade.dev.js` | `angular2/upgrade` | dev | no
58+
`testing.dev.js` | `angular2/testing`, `angular2/http/testing`, `angular2/router/testing`, `angular2/platform/testing/browser` | dev | no
59+
60+
**Note**: bundles in the `System.register` format are "additive" - it is quite common to include several bundles in one application.
61+
For example people using Angular 2 with `http` and `router` would include: `angular2.js`, `http.js` and `router.js`.
62+
63+
## Browserify / JSPM / Rollup / WebPack users
64+
65+
Angular 2 doesn't provide any bundles for use with packaging tools Browserify or WebPack. Those tools are sophisticated enough to build optimal bundles for production use from individual Angular 2 files distributed in the npm package.
66+
An example of an Angular 2 project built with WebPack can be found in the [angular2-seed](https://github.com/angular/angular2-seed) repository.
67+
68+
69+
# Polyfills and external dependencies
70+
71+
## Required Polyfills
72+
73+
Polyfills are required for Angular 2 to function properly (the exact list depends on the browser used) and external dependencies ([zone.js](https://github.com/angular/zone.js)).
74+
To ease setup of Angular 2 applications there is one file - `angular2-polyfills.js` - that combines:
75+
* a pollyfill mandatory for all browsers: [reflect-metadata](https://www.npmjs.com/package/reflect-metadata)
76+
* [zone.js](https://github.com/angular/zone.js)
77+
78+
**Note**: `angular2-polyfills.js` contains code that should be loaded into the browser as the very first code of the web application even before the module loader. The preferred solution is to load the mentioned file in a `script` tag as early as possible.
79+
80+
81+
## RxJS
82+
83+
[RxJS](https://github.com/ReactiveX/RxJS) is a required dependency of Angular 2.
84+
85+
You should include RxJS in your project by declaring a dependency on the [`rxjs` npm package](https://www.npmjs.com/package/rxjs).
86+
87+
Depending on if you are using Angular bundles or not you can either use RxJS bundles from `node_modules/rxjs/bundles/` or configure your bundler to pull in the individual files from the npm package.
88+
89+
90+
## ES6 shims (optional)
91+
92+
Users of pre-ES6 browsers might need to add an ES6 shim (e.g. [es6-shim](https://github.com/paulmillr/es6-shim))

‎docs/change_detection/change_detection.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
@name Change Detection
2+
@description
3+
# Change Detection
4+
5+
* Mechanisms by which changes are detected in the model
6+
* DAG
7+
* Order of evaluation
8+
* Pure Functions
9+
* `onChange` method
10+
* Parser

‎docs/change_detection/expressions.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Expressions
2+
3+
## Binding Semantics
4+
5+
### Formatters
6+
7+
## Statement Semantics

‎docs/change_detection/record.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Record
2+
3+
## RecordRange

‎docs/cheatsheet/bootstrapping.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
@cheatsheetSection
2+
Bootstrapping
3+
@cheatsheetIndex 0
4+
@description
5+
{@target ts}`import {bootstrap} from 'angular2/platform/browser';`{@endtarget}
6+
{@target js}Available from the `ng.platform.browser` namespace{@endtarget}
7+
{@target dart}`import 'package:angular2/bootstrap.dart';`{@endtarget}
8+
9+
@cheatsheetItem
10+
syntax(ts dart):
11+
`bootstrap​(MyAppComponent, [MyService, provide(...)]);`|`provide`
12+
syntax(js):
13+
`document.addEventListener('DOMContentLoaded', function () {
14+
ng.platform.browser.bootstrap(MyAppComponent,
15+
[MyService, ng.core.provide(...)]);
16+
});`|`provide`
17+
description:
18+
Bootstraps an application with MyAppComponent as the root component and configures the DI providers. {@target js}Must be wrapped in the event listener to fire when the page loads.{@endtarget}

0 commit comments

Comments
 (0)