feat(build): implement type definition manager for TypeScript

Author: pablodenadai

.gitignore

@@ -3,6 +3,7 @@
 /docs
 /build
 /coverage
+/typings
 /.karma
 /.protractor
 

.travis.yml

@@ -3,10 +3,13 @@ language:
 node_js:
   - '5'
 before_install:
+  # Setup `Chrome` instance.
   - export CHROME_BIN=chromium-browser
   - export DISPLAY=:99.0
   - sh -e /etc/init.d/xvfb start
+
   - npm install gulpjs/gulp-cli#4.0 -g
+  - npm install typings -g
 install:
   - npm install
 before_script:

README.md

@@ -11,6 +11,7 @@ Light-weight and easy to use seed project for Angular 2 apps.
 - [Gulp 4](http://gulpjs.com/)
 - [Angular 2](https://angular.io/)
 - [TypeScript](http://www.typescriptlang.org/)
+- [Typings](https://github.com/typings/typings)
 - [Sass](http://sass-lang.com/)
 - [Karma](http://karma-runner.github.io/)
 - [Protractor](http://www.protractortest.org/)
@@ -20,7 +21,7 @@ Light-weight and easy to use seed project for Angular 2 apps.
 - **Development** and **production** environment targets.
 - **Unit** and **E2E** test samples.
 - **Code coverage** report with TypeScript mapping.
-- **TypeScript** linting, sourcemaps and transpilation (ES5).
+- **TypeScript** definition manager, linting, sourcemaps and transpilation (ES5).
 - **Sass** linting, sourcemaps and transpilation.
 - **TypeDoc** documentation generator.
 - **Change Log** generated based on Git metadata.

gulpfile.js

@@ -87,7 +87,7 @@ function scss() {
 }
 
 function typedoc() {
-	return gulp.src('src/scripts/**/*.ts')
+	return gulp.src(['src/scripts/**/*.ts', 'typings/main.d.ts'])
 		.pipe(plugins.typedoc({
 			module: 'commonjs',
 			target: 'es5',
@@ -102,7 +102,7 @@ var tsProject = plugins.typescript.createProject('tsconfig.json', {
 });
 
 function ts() {
-	var tsResult = gulp.src('src/scripts/**/*.ts')
+	var tsResult = gulp.src(['src/scripts/**/*.ts', 'typings/main.d.ts'])
 		.pipe(plugins.tslint())
 		.pipe(plugins.tslint.report('verbose'))
 		.pipe(plugins.preprocess({ context: env }))
@@ -164,7 +164,7 @@ function karmaTs(root) {
 
 	var caller = arguments.callee.caller.name;
 
-	var tsResult = gulp.src(path.join(root, '/**/*.ts'))
+	var tsResult = gulp.src([path.join(root, '/**/*.ts'), 'typings/main.d.ts'])
 		.pipe(plugins.preprocess({ context: env }))
 		.pipe(plugins.inlineNg2Template({ useRelativePaths: true }))
 		.pipe(plugins.sourcemaps.init())
@@ -210,7 +210,7 @@ var protractorTsProject = plugins.typescript.createProject('tsconfig.json', {
 });
 
 function protractorTsSpec() {
-	var tsResult = gulp.src('test/e2e/**/*.ts')
+	var tsResult = gulp.src(['test/e2e/**/*.ts', 'typings/main.d.ts'])
 		.pipe(plugins.typescript(protractorTsProject));
 
 	return tsResult.js

gulpfile.paths.js

@@ -7,7 +7,8 @@ let baseLibs = [
 	'node_modules/angular2/bundles/angular2-polyfills.js',
 	'node_modules/angular2/bundles/angular2.dev.js',
 	'node_modules/angular2/bundles/router.dev.js',
-	'node_modules/angular2/bundles/http.dev.js'
+	'node_modules/angular2/bundles/http.dev.js',
+	'node_modules/lodash/index.js'
 ];
 
 module.exports = {

package.json

@@ -8,6 +8,7 @@
   "version": "1.0.1",
   "description": "Angular 2 Seed Project – TypeScript, Gulp, Karma, Protractor, Sass.",
   "scripts": {
+    "postinstall": "typings install",
     "start": "gulp build serve",
     "changelog": "conventional-changelog -p angular -i CHANGELOG.md -w"
   },
@@ -17,6 +18,7 @@
     "bootstrap": "4.0.0-alpha.2",
     "es6-promise": "3.0.2",
     "es6-shim": "0.33.3",
+    "lodash": "3.10.1",
     "reflect-metadata": "0.1.2",
     "rxjs": "5.0.0-beta.0",
     "systemjs": "0.19.6",

src/scripts/about/about.component.ts

@@ -6,4 +6,15 @@ import {Component, View} from 'angular2/core';
 @View({
 	templateUrl: './about.template.html'
 })
-export class AboutComponent {}
+export class AboutComponent {
+	constructor() {
+		/**
+		 * This snippet shows how third-party libraries ie. Lodash can be consumed
+		 * using Typings - the type definition manager.
+		 */
+		let filtered: Array<number>;
+		filtered = _.filter([0, 1, 2, 3], (number: number) => (number % 2 === 0));
+
+		console.log('filtered', filtered);
+	}
+}

typings.json

@@ -0,0 +1,7 @@
+{
+  "dependencies": {},
+  "devDependencies": {},
+  "ambientDependencies": {
+    "lodash": "github:DefinitelyTyped/DefinitelyTyped/lodash/lodash.d.ts#1469ae2d0c260c082517bfb971be8c14e2389fe5"
+  }
+}