feat(zone): Use zone-nativescript vendored below ./zone.js

Add a document describing the zone.js upgrade process.

Author: hdeshev

doc/upgrading-zonejs.md

@@ -0,0 +1,15 @@
+# Upgrading Zone.js
+
+`nativescript-angular` uses a fork of the `zone.js` package in order to work around incompatibilities between node, browser, and mobile implementations.
+
+The fork resides at https://github.com/NativeScript/zone.js in the `zone-nativescript` branch. It adds a separate `lib/nativescript/nativescript.ts` entry point that is used to generate a new bundle: `dist/zone-nativescript.js`.
+
+To upgrade to a newer release of `zone.js`:
+
+1. Identify the upgrade target -- most likely a release tag.
+2. Rebase the `zone-nativescript` branch on top of the upgrade target.
+3. Rebuild: `gulp build`
+4. Run the node-based smoke tests: `gulp test/nativescript`
+5. Run the browser tests: `node_modules/.bin/karma start karma.conf.js --single-run` (You need to run node `test/ws-server.js` in a separate console first)
+6. Commit `dist/zone-nativescript.js`, drop the previous `dist/zone-nativescript.js` commit from the branch. Force push the new `zone-nativescript` branch to GitHub.
+7. Update your copy of `nativescript-angular/zone.js/dist/zone-nativescript.js` with the bundle you just built.

nativescript-angular/package.json

@@ -29,7 +29,6 @@
     "@angular/forms": "2.0.0-rc.6",
     "@angular/router": "3.0.0-rc.2",
     "rxjs": "5.0.0-beta.11",
-    "zone.js": "^0.6.17",
     "reflect-metadata": "^0.1.8",
     "parse5": "1.3.2",
     "punycode": "1.3.2",
@@ -38,6 +37,7 @@
   },
   "devDependencies": {
     "tns-core-modules": ">=2.2.0 || >=2.2.0-2016",
+    "zone.js": "^0.6.17",
     "typescript": "^1.8.10"
   },
   "nativescript": {}

nativescript-angular/platform.ts

@@ -1,5 +1,5 @@
 import 'globals';
-import "zone.js/dist/zone-node";
+import "./zone.js/dist/zone-nativescript";
 
 import 'reflect-metadata';
 import './polyfills/array';