feat(router): user metadata in route configs

Provide the ability to attach custom data onto a route and retrieve
that data as an injectable (RouteData) inside the component.

Closes #2777

Closes #3541

modules/angular2/src/router/async_route_handler.ts

@@ -6,7 +6,7 @@ export class AsyncRouteHandler implements RouteHandler {
   _resolvedComponent: Promise<any> = null;
   componentType: Type;
 
-  constructor(private _loader: Function) {}
+  constructor(private _loader: Function, public data?: Object) {}
 
   resolveComponentType(): Promise<any> {
     if (isPresent(this._resolvedComponent)) {

modules/angular2/src/router/instruction.ts

@@ -18,7 +18,6 @@ export class RouteParams {
   get(param: string): string { return normalizeBlank(StringMapWrapper.get(this.params, param)); }
 }
 
-
 /**
  * `Instruction` is a tree of `ComponentInstructions`, with all the information needed
  * to transition each component in the app to a given route, including all auxiliary routes.
@@ -98,4 +97,6 @@ export class ComponentInstruction {
   get specificity() { return this._recognizer.specificity; }
 
   get terminal() { return this._recognizer.terminal; }
+
+  routeData(): Object { return this._recognizer.handler.data; }
 }

modules/angular2/src/router/route_config_decorator.ts

@@ -2,6 +2,13 @@ import {RouteConfig as RouteConfigAnnotation, RouteDefinition} from './route_con
 import {makeDecorator} from 'angular2/src/util/decorators';
 import {List} from 'angular2/src/facade/collection';
 
-export {Route, Redirect, AuxRoute, AsyncRoute, RouteDefinition} from './route_config_impl';
+export {
+  Route,
+  Redirect,
+  AuxRoute,
+  AsyncRoute,
+  RouteDefinition,
+  ROUTE_DATA
+} from './route_config_impl';
 export var RouteConfig: (configs: List<RouteDefinition>) => ClassDecorator =
     makeDecorator(RouteConfigAnnotation);

modules/angular2/src/router/route_config_impl.ts

@@ -1,7 +1,10 @@
-import {CONST, Type} from 'angular2/src/facade/lang';
+import {CONST, CONST_EXPR, Type} from 'angular2/src/facade/lang';
 import {List} from 'angular2/src/facade/collection';
 import {RouteDefinition} from './route_definition';
 export {RouteDefinition} from './route_definition';
+import {OpaqueToken} from 'angular2/di';
+
+export const ROUTE_DATA: OpaqueToken = CONST_EXPR(new OpaqueToken('routeData'));
 
 /**
  * You use the RouteConfig annotation to add routes to a component.
@@ -10,6 +13,7 @@ export {RouteDefinition} from './route_definition';
  * - `path` (required)
  * - `component`, `loader`,  `redirectTo` (requires exactly one of these)
  * - `as` (optional)
+ * - `data` (optional)
  */
 @CONST()
 export class RouteConfig {
@@ -19,23 +23,29 @@ export class RouteConfig {
 
 @CONST()
 export class Route implements RouteDefinition {
+  data: any;
   path: string;
   component: Type;
   as: string;
   // added next two properties to work around https://github.com/Microsoft/TypeScript/issues/4107
   loader: Function;
   redirectTo: string;
-  constructor({path, component, as}: {path: string, component: Type, as?: string}) {
+  constructor({path, component, as, data}:
+                  {path: string, component: Type, as?: string, data?: any}) {
     this.path = path;
     this.component = component;
     this.as = as;
     this.loader = null;
     this.redirectTo = null;
+    this.data = data;
   }
 }
 
+
+
 @CONST()
 export class AuxRoute implements RouteDefinition {
+  data: any = null;
   path: string;
   component: Type;
   as: string;
@@ -51,13 +61,15 @@ export class AuxRoute implements RouteDefinition {
 
 @CONST()
 export class AsyncRoute implements RouteDefinition {
+  data: any;
   path: string;
   loader: Function;
   as: string;
-  constructor({path, loader, as}: {path: string, loader: Function, as?: string}) {
+  constructor({path, loader, as, data}: {path: string, loader: Function, as?: string, data?: any}) {
     this.path = path;
     this.loader = loader;
     this.as = as;
+    this.data = data;
   }
 }
 
@@ -68,6 +80,7 @@ export class Redirect implements RouteDefinition {
   as: string = null;
   // added next property to work around https://github.com/Microsoft/TypeScript/issues/4107
   loader: Function = null;
+  data: any = null;
   constructor({path, redirectTo}: {path: string, redirectTo: string}) {
     this.path = path;
     this.redirectTo = redirectTo;

modules/angular2/src/router/route_definition.ts

@@ -6,6 +6,7 @@ export interface RouteDefinition {
   loader?: Function;
   redirectTo?: string;
   as?: string;
+  data?: any;
 }
 
 export interface ComponentDefinition {

modules/angular2/src/router/route_handler.ts

@@ -4,4 +4,5 @@ import {Type} from 'angular2/src/facade/lang';
 export interface RouteHandler {
   componentType: Type;
   resolveComponentType(): Promise<any>;
+  data?: Object;
 }

modules/angular2/src/router/route_recognizer.ts

@@ -46,7 +46,7 @@ export class RouteRecognizer {
     var handler;
 
     if (config instanceof AuxRoute) {
-      handler = new SyncRouteHandler(config.component);
+      handler = new SyncRouteHandler(config.component, config.data);
       let path = config.path.startsWith('/') ? config.path.substring(1) : config.path;
       var recognizer = new PathRecognizer(config.path, handler);
       this.auxRoutes.set(path, recognizer);
@@ -58,9 +58,9 @@ export class RouteRecognizer {
     }
 
     if (config instanceof Route) {
-      handler = new SyncRouteHandler(config.component);
+      handler = new SyncRouteHandler(config.component, config.data);
     } else if (config instanceof AsyncRoute) {
-      handler = new AsyncRouteHandler(config.loader);
+      handler = new AsyncRouteHandler(config.loader, config.data);
     }
     var recognizer = new PathRecognizer(config.path, handler);
 

modules/angular2/src/router/router_outlet.ts

@@ -8,6 +8,7 @@ import {Injector, bind, Dependency, UNDEFINED} from 'angular2/di';
 
 import * as routerMod from './router';
 import {Instruction, ComponentInstruction, RouteParams} from './instruction';
+import {ROUTE_DATA} from './route_config_impl';
 import * as hookMod from './lifecycle_annotations';
 import {hasLifecycleHook} from './route_lifecycle_reflector';
 
@@ -77,8 +78,9 @@ export class RouterOutlet {
     this.childRouter = this._parentRouter.childRouter(componentType);
 
     var bindings = Injector.resolve([
-      bind(RouteParams)
-          .toValue(new RouteParams(instruction.params)),
+      bind(ROUTE_DATA)
+          .toValue(instruction.routeData()),
+      bind(RouteParams).toValue(new RouteParams(instruction.params)),
       bind(routerMod.Router).toValue(this.childRouter)
     ]);
     return this._loader.loadNextToLocation(componentType, this._elementRef, bindings)

modules/angular2/src/router/sync_route_handler.ts

@@ -5,7 +5,7 @@ import {Type} from 'angular2/src/facade/lang';
 export class SyncRouteHandler implements RouteHandler {
   _resolvedComponent: Promise<any> = null;
 
-  constructor(public componentType: Type) {
+  constructor(public componentType: Type, public data?: Object) {
     this._resolvedComponent = PromiseWrapper.resolve(componentType);
   }