@angular/core 0.0.0-6 → 2.0.0-rc.2

package/esm/src/di/decorators.js

@@ -1,27 +1,33 @@
-import { InjectMetadata, OptionalMetadata, InjectableMetadata, SelfMetadata, HostMetadata, SkipSelfMetadata } from './metadata';
 import { makeDecorator, makeParamDecorator } from '../util/decorators';
+import { HostMetadata, InjectMetadata, InjectableMetadata, OptionalMetadata, SelfMetadata, SkipSelfMetadata } from './metadata';
 /**
  * Factory for creating {@link InjectMetadata}.
+ * @stable
  */
 export var Inject = makeParamDecorator(InjectMetadata);
 /**
  * Factory for creating {@link OptionalMetadata}.
+ * @stable
  */
 export var Optional = makeParamDecorator(OptionalMetadata);
 /**
  * Factory for creating {@link InjectableMetadata}.
+ * @stable
  */
 export var Injectable = makeDecorator(InjectableMetadata);
 /**
  * Factory for creating {@link SelfMetadata}.
+ * @stable
  */
 export var Self = makeParamDecorator(SelfMetadata);
 /**
  * Factory for creating {@link HostMetadata}.
+ * @stable
  */
 export var Host = makeParamDecorator(HostMetadata);
 /**
  * Factory for creating {@link SkipSelfMetadata}.
+ * @stable
  */
 export var SkipSelf = makeParamDecorator(SkipSelfMetadata);
 //# sourceMappingURL=decorators.js.map

package/esm/src/di/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"/Users/iminar/Dev/angular/modules/@angular/core/","sources":["src/di/decorators.ts"],"names":[],"mappings":"OAIS,EACP,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY;OACZ,EAAC,aAAa,EAAE,kBAAkB,EAAC,MAAM,oBAAoB;AAkDpE;;GAEG;AACH,OAAO,IAAI,MAAM,GAA0B,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAE9E;;GAEG;AACH,OAAO,IAAI,QAAQ,GAA4B,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;AAEpF;;GAEG;AACH,OAAO,IAAI,UAAU,GACU,aAAa,CAAC,kBAAkB,CAAC,CAAC;AAEjE;;GAEG;AACH,OAAO,IAAI,IAAI,GAAwB,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAExE;;GAEG;AACH,OAAO,IAAI,IAAI,GAAwB,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAExE;;GAEG;AACH,OAAO,IAAI,QAAQ,GAA4B,kBAAkB,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../../../../modules/@angular/core/src/di/decorators.ts"],"names":[],"mappings":"OAAO,EAAC,aAAa,EAAE,kBAAkB,EAAC,MAAM,oBAAoB;OAE7D,EAAC,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAC,MAAM,YAAY;AAyD7H;;;GAGG;AACH,OAAO,IAAI,MAAM,GAA0B,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAE9E;;;GAGG;AACH,OAAO,IAAI,QAAQ,GAA4B,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;AAEpF;;;GAGG;AACH,OAAO,IAAI,UAAU,GACU,aAAa,CAAC,kBAAkB,CAAC,CAAC;AAEjE;;;GAGG;AACH,OAAO,IAAI,IAAI,GAAwB,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAExE;;;GAGG;AACH,OAAO,IAAI,IAAI,GAAwB,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAExE;;;GAGG;AACH,OAAO,IAAI,QAAQ,GAA4B,kBAAkB,CAAC,gBAAgB,CAAC,CAAC","sourcesContent":["import {makeDecorator, makeParamDecorator} from '../util/decorators';\n\nimport {HostMetadata, InjectMetadata, InjectableMetadata, OptionalMetadata, SelfMetadata, SkipSelfMetadata} from './metadata';\n\n\n/**\n * Factory for creating {@link InjectMetadata}.\n * @stable\n */\nexport interface InjectMetadataFactory {\n  (token: any): any;\n  new (token: any): InjectMetadata;\n}\n\n/**\n * Factory for creating {@link OptionalMetadata}.\n * @stable\n */\nexport interface OptionalMetadataFactory {\n  (): any;\n  new (): OptionalMetadata;\n}\n\n/**\n * Factory for creating {@link InjectableMetadata}.\n * @stable\n */\nexport interface InjectableMetadataFactory {\n  (): any;\n  new (): InjectableMetadata;\n}\n\n/**\n * Factory for creating {@link SelfMetadata}.\n * @stable\n */\nexport interface SelfMetadataFactory {\n  (): any;\n  new (): SelfMetadata;\n}\n\n/**\n * Factory for creating {@link HostMetadata}.\n * @stable\n */\nexport interface HostMetadataFactory {\n  (): any;\n  new (): HostMetadata;\n}\n\n/**\n * Factory for creating {@link SkipSelfMetadata}.\n * @stable\n */\nexport interface SkipSelfMetadataFactory {\n  (): any;\n  new (): SkipSelfMetadata;\n}\n\n/**\n * Factory for creating {@link InjectMetadata}.\n * @stable\n */\nexport var Inject: InjectMetadataFactory = makeParamDecorator(InjectMetadata);\n\n/**\n * Factory for creating {@link OptionalMetadata}.\n * @stable\n */\nexport var Optional: OptionalMetadataFactory = makeParamDecorator(OptionalMetadata);\n\n/**\n * Factory for creating {@link InjectableMetadata}.\n * @stable\n */\nexport var Injectable: InjectableMetadataFactory =\n    <InjectableMetadataFactory>makeDecorator(InjectableMetadata);\n\n/**\n * Factory for creating {@link SelfMetadata}.\n * @stable\n */\nexport var Self: SelfMetadataFactory = makeParamDecorator(SelfMetadata);\n\n/**\n * Factory for creating {@link HostMetadata}.\n * @stable\n */\nexport var Host: HostMetadataFactory = makeParamDecorator(HostMetadata);\n\n/**\n * Factory for creating {@link SkipSelfMetadata}.\n * @stable\n */\nexport var SkipSelf: SkipSelfMetadataFactory = makeParamDecorator(SkipSelfMetadata);\n\ninterface DecoratorInvocation {\n  type: Function;\n  args?: any[];\n}\n"]}

package/esm/src/di/decorators.metadata.json

@@ -1 +1 @@
-{"__symbolic":"module","metadata":{"Inject":{"__symbolic":"call","expression":{"__symbolic":"reference","name":"makeParamDecorator","module":"../util/decorators"},"arguments":[{"__symbolic":"reference","name":"InjectMetadata","module":"./metadata"}]},"Optional":{"__symbolic":"call","expression":{"__symbolic":"reference","name":"makeParamDecorator","module":"../util/decorators"},"arguments":[{"__symbolic":"reference","name":"OptionalMetadata","module":"./metadata"}]},"Injectable":{"__symbolic":"call","expression":{"__symbolic":"reference","name":"makeDecorator","module":"../util/decorators"},"arguments":[{"__symbolic":"reference","name":"InjectableMetadata","module":"./metadata"}]},"Self":{"__symbolic":"call","expression":{"__symbolic":"reference","name":"makeParamDecorator","module":"../util/decorators"},"arguments":[{"__symbolic":"reference","name":"SelfMetadata","module":"./metadata"}]},"Host":{"__symbolic":"call","expression":{"__symbolic":"reference","name":"makeParamDecorator","module":"../util/decorators"},"arguments":[{"__symbolic":"reference","name":"HostMetadata","module":"./metadata"}]},"SkipSelf":{"__symbolic":"call","expression":{"__symbolic":"reference","name":"makeParamDecorator","module":"../util/decorators"},"arguments":[{"__symbolic":"reference","name":"SkipSelfMetadata","module":"./metadata"}]}}}
+{"__symbolic":"module","version":1,"metadata":{"Inject":{"__symbolic":"call","expression":{"__symbolic":"reference","module":"../util/decorators","name":"makeParamDecorator"},"arguments":[{"__symbolic":"reference","module":"./metadata","name":"InjectMetadata"}]},"Optional":{"__symbolic":"call","expression":{"__symbolic":"reference","module":"../util/decorators","name":"makeParamDecorator"},"arguments":[{"__symbolic":"reference","module":"./metadata","name":"OptionalMetadata"}]},"Injectable":{"__symbolic":"call","expression":{"__symbolic":"reference","module":"../util/decorators","name":"makeDecorator"},"arguments":[{"__symbolic":"reference","module":"./metadata","name":"InjectableMetadata"}]},"Self":{"__symbolic":"call","expression":{"__symbolic":"reference","module":"../util/decorators","name":"makeParamDecorator"},"arguments":[{"__symbolic":"reference","module":"./metadata","name":"SelfMetadata"}]},"Host":{"__symbolic":"call","expression":{"__symbolic":"reference","module":"../util/decorators","name":"makeParamDecorator"},"arguments":[{"__symbolic":"reference","module":"./metadata","name":"HostMetadata"}]},"SkipSelf":{"__symbolic":"call","expression":{"__symbolic":"reference","module":"../util/decorators","name":"makeParamDecorator"},"arguments":[{"__symbolic":"reference","module":"./metadata","name":"SkipSelfMetadata"}]}}}

package/esm/src/di/forward_ref.d.ts

@@ -1,4 +1,4 @@
-import { Type } from '../../src/facade/lang';
+import { Type } from '../facade/lang';
 /**
  * An interface that a function passed into {@link forwardRef} has to implement.
  *
@@ -19,6 +19,7 @@ export interface ForwardRefFn {
  *
  * ### Example
  * {@example core/di/ts/forward_ref/forward_ref.ts region='forward_ref'}
+ * @experimental
  */
 export declare function forwardRef(forwardRefFn: ForwardRefFn): Type;
 /**
@@ -35,5 +36,6 @@ export declare function forwardRef(forwardRefFn: ForwardRefFn): Type;
  * ```
  *
  * See: {@link forwardRef}
+ * @experimental
  */
 export declare function resolveForwardRef(type: any): any;

package/esm/src/di/forward_ref.js

@@ -1,4 +1,4 @@
-import { stringify, isFunction } from '../../src/facade/lang';
+import { isFunction, stringify } from '../facade/lang';
 /**
  * Allows to refer to references which are not yet defined.
  *
@@ -9,6 +9,7 @@ import { stringify, isFunction } from '../../src/facade/lang';
  *
  * ### Example
  * {@example core/di/ts/forward_ref/forward_ref.ts region='forward_ref'}
+ * @experimental
  */
 export function forwardRef(forwardRefFn) {
     forwardRefFn.__forward_ref__ = forwardRef;
@@ -29,6 +30,7 @@ export function forwardRef(forwardRefFn) {
  * ```
  *
  * See: {@link forwardRef}
+ * @experimental
  */
 export function resolveForwardRef(type) {
     if (isFunction(type) && type.hasOwnProperty('__forward_ref__') &&

package/esm/src/di/forward_ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"forward_ref.js","sourceRoot":"/Users/iminar/Dev/angular/modules/@angular/core/","sources":["src/di/forward_ref.ts"],"names":[],"mappings":"OAIS,EAAO,SAAS,EAAE,UAAU,EAAC,MAAM,uBAAuB;AAWnE;;;;;;;;;;GAUG;AACH,2BAA2B,YAA0B;IAC7C,YAAa,CAAC,eAAe,GAAG,UAAU,CAAC;IAC3C,YAAa,CAAC,QAAQ,GAAG,cAAa,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,CAAa,YAAa,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,kCAAkC,IAAS;IACzC,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC;QAC1D,IAAI,CAAC,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC;QACxC,MAAM,CAAgB,IAAK,EAAE,CAAC;IAChC,CAAC;IAAC,IAAI,CAAC,CAAC;QACN,MAAM,CAAC,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"forward_ref.js","sourceRoot":"","sources":["../../../../../../modules/@angular/core/src/di/forward_ref.ts"],"names":[],"mappings":"OAAO,EAAO,UAAU,EAAE,SAAS,EAAC,MAAM,gBAAgB;AAY1D;;;;;;;;;;;GAWG;AACH,2BAA2B,YAA0B;IAC7C,YAAa,CAAC,eAAe,GAAG,UAAU,CAAC;IAC3C,YAAa,CAAC,QAAQ,GAAG,cAAa,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,CAAa,YAAa,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,kCAAkC,IAAS;IACzC,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC;QAC1D,IAAI,CAAC,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC;QACxC,MAAM,CAAgB,IAAK,EAAE,CAAC;IAChC,CAAC;IAAC,IAAI,CAAC,CAAC;QACN,MAAM,CAAC,IAAI,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import {Type, isFunction, stringify} from '../facade/lang';\n\n\n/**\n * An interface that a function passed into {@link forwardRef} has to implement.\n *\n * ### Example\n *\n * {@example core/di/ts/forward_ref/forward_ref.ts region='forward_ref_fn'}\n */\nexport interface ForwardRefFn { (): any; }\n\n/**\n * Allows to refer to references which are not yet defined.\n *\n * For instance, `forwardRef` is used when the `token` which we need to refer to for the purposes of\n * DI is declared,\n * but not yet defined. It is also used when the `token` which we use when creating a query is not\n * yet defined.\n *\n * ### Example\n * {@example core/di/ts/forward_ref/forward_ref.ts region='forward_ref'}\n * @experimental\n */\nexport function forwardRef(forwardRefFn: ForwardRefFn): Type {\n  (<any>forwardRefFn).__forward_ref__ = forwardRef;\n  (<any>forwardRefFn).toString = function() { return stringify(this()); };\n  return (<Type><any>forwardRefFn);\n}\n\n/**\n * Lazily retrieves the reference value from a forwardRef.\n *\n * Acts as the identity function when given a non-forward-ref value.\n *\n * ### Example ([live demo](http://plnkr.co/edit/GU72mJrk1fiodChcmiDR?p=preview))\n *\n * ```typescript\n * var ref = forwardRef(() => \"refValue\");\n * expect(resolveForwardRef(ref)).toEqual(\"refValue\");\n * expect(resolveForwardRef(\"regularValue\")).toEqual(\"regularValue\");\n * ```\n *\n * See: {@link forwardRef}\n * @experimental\n */\nexport function resolveForwardRef(type: any): any {\n  if (isFunction(type) && type.hasOwnProperty('__forward_ref__') &&\n      type.__forward_ref__ === forwardRef) {\n    return (<ForwardRefFn>type)();\n  } else {\n    return type;\n  }\n}\n\ninterface DecoratorInvocation {\n  type: Function;\n  args?: any[];\n}\n"]}

package/esm/src/di/injector.d.ts

@@ -1,4 +1,7 @@
 export declare const THROW_IF_NOT_FOUND: Object;
+/**
+ * @stable
+ */
 export declare abstract class Injector {
     static THROW_IF_NOT_FOUND: Object;
     /**
@@ -12,7 +15,7 @@ export declare abstract class Injector {
      *
      * ```typescript
      * var injector = ReflectiveInjector.resolveAndCreate([
-     *   provide("validToken", {useValue: "Value"})
+     *   {provide: "validToken", useValue: "Value"}
      * ]);
      * expect(injector.get("validToken")).toEqual("Value");
      * expect(() => injector.get("invalidToken")).toThrowError();

package/esm/src/di/injector.js

@@ -1,6 +1,9 @@
-import { unimplemented } from '../../src/facade/exceptions';
+import { unimplemented } from '../facade/exceptions';
 const _THROW_IF_NOT_FOUND = new Object();
 export const THROW_IF_NOT_FOUND = _THROW_IF_NOT_FOUND;
+/**
+ * @stable
+ */
 export class Injector {
     /**
      * Retrieves an instance from the injector based on the provided token.
@@ -13,7 +16,7 @@ export class Injector {
      *
      * ```typescript
      * var injector = ReflectiveInjector.resolveAndCreate([
-     *   provide("validToken", {useValue: "Value"})
+     *   {provide: "validToken", useValue: "Value"}
      * ]);
      * expect(injector.get("validToken")).toEqual("Value");
      * expect(() => injector.get("invalidToken")).toThrowError();

package/esm/src/di/injector.js.map

@@ -1 +1 @@
-{"version":3,"file":"injector.js","sourceRoot":"/Users/iminar/Dev/angular/modules/@angular/core/","sources":["src/di/injector.ts"],"names":[],"mappings":"OAIS,EAAC,aAAa,EAAC,MAAM,6BAA6B;AAE3D,MAAM,mBAAmB,GAAsB,IAAI,MAAM,EAAE,CAAC;AAC5D,OAAO,MAAM,kBAAkB,GAAsB,mBAAmB,CAAC;AAEzE;IAGE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CAAC,KAAU,EAAE,aAAmB,IAAS,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AA3BQ,2BAAkB,GAAG,mBAAmB,CA2BhD"}
+{"version":3,"file":"injector.js","sourceRoot":"","sources":["../../../../../../modules/@angular/core/src/di/injector.ts"],"names":[],"mappings":"OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB;AAElD,MAAM,mBAAmB,GAAsB,IAAI,MAAM,EAAE,CAAC;AAC5D,OAAO,MAAM,kBAAkB,GAAsB,mBAAmB,CAAC;AAEzE;;GAEG;AACH;IAGE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CAAC,KAAU,EAAE,aAAmB,IAAS,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AA3BQ,2BAAkB,GAAG,mBAAmB,CA2BhD","sourcesContent":["import {unimplemented} from '../facade/exceptions';\n\nconst _THROW_IF_NOT_FOUND = /*@ts2dart_const*/ new Object();\nexport const THROW_IF_NOT_FOUND = /*@ts2dart_const*/ _THROW_IF_NOT_FOUND;\n\n/**\n * @stable\n */\nexport abstract class Injector {\n  static THROW_IF_NOT_FOUND = _THROW_IF_NOT_FOUND;\n\n  /**\n   * Retrieves an instance from the injector based on the provided token.\n   * If not found:\n   * - Throws {@link NoProviderError} if no `notFoundValue` that is not equal to\n   * Injector.THROW_IF_NOT_FOUND is given\n   * - Returns the `notFoundValue` otherwise\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/HeXSHg?p=preview))\n   *\n   * ```typescript\n   * var injector = ReflectiveInjector.resolveAndCreate([\n   *   {provide: \"validToken\", useValue: \"Value\"}\n   * ]);\n   * expect(injector.get(\"validToken\")).toEqual(\"Value\");\n   * expect(() => injector.get(\"invalidToken\")).toThrowError();\n   * ```\n   *\n   * `Injector` returns itself when given `Injector` as a token.\n   *\n   * ```typescript\n   * var injector = ReflectiveInjector.resolveAndCreate([]);\n   * expect(injector.get(Injector)).toBe(injector);\n   * ```\n   */\n  get(token: any, notFoundValue?: any): any { return unimplemented(); }\n}\n\ninterface DecoratorInvocation {\n  type: Function;\n  args?: any[];\n}\n"]}

package/esm/src/di/injector.metadata.json

@@ -1 +1 @@
-{"__symbolic":"module","metadata":{"THROW_IF_NOT_FOUND":{"__symbolic":"reference","name":"_THROW_IF_NOT_FOUND"}}}
+{"__symbolic":"module","version":1,"metadata":{"THROW_IF_NOT_FOUND":{"__symbolic":"reference","name":"_THROW_IF_NOT_FOUND"}}}

package/esm/src/di/metadata.d.ts

@@ -15,7 +15,7 @@
  * }
  *
  * var injector = Injector.resolveAndCreate([
- *  provide("MyEngine", {useClass: Engine}),
+ *  {provide: "MyEngine", useClass: Engine},
  *  Car
  * ]);
  *
@@ -38,6 +38,7 @@
  * expect(injector.get(Car).engine instanceof Engine).toBe(true);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class InjectMetadata {
     token: any;
@@ -65,6 +66,7 @@ export declare class InjectMetadata {
  * expect(injector.get(Car).engine).toBeNull();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class OptionalMetadata {
     toString(): string;
@@ -73,6 +75,7 @@ export declare class OptionalMetadata {
  * `DependencyMetadata` is used by the framework to extend DI.
  * This is internal to Angular and should not be used directly.
  * @ts2dart_const
+ * @stable
  */
 export declare class DependencyMetadata {
     readonly token: any;
@@ -108,6 +111,7 @@ export declare class DependencyMetadata {
  * expect(() => injector.get(NeedsService)).toThrowError();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class InjectableMetadata {
     constructor();
@@ -139,6 +143,7 @@ export declare class InjectableMetadata {
  * expect(() => child.get(NeedsDependency)).toThrowError();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class SelfMetadata {
     toString(): string;
@@ -168,6 +173,7 @@ export declare class SelfMetadata {
  * expect(() => inj.get(NeedsDependency)).toThrowError();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class SkipSelfMetadata {
     toString(): string;
@@ -226,6 +232,7 @@ export declare class SkipSelfMetadata {
  * bootstrap(App);
  *```
  * @ts2dart_const
+ * @stable
  */
 export declare class HostMetadata {
     toString(): string;

package/esm/src/di/metadata.js

@@ -1,4 +1,4 @@
-import { stringify } from '../../src/facade/lang';
+import { stringify } from '../facade/lang';
 /**
  * A parameter metadata that specifies a dependency.
  *
@@ -16,7 +16,7 @@ import { stringify } from '../../src/facade/lang';
  * }
  *
  * var injector = Injector.resolveAndCreate([
- *  provide("MyEngine", {useClass: Engine}),
+ *  {provide: "MyEngine", useClass: Engine},
  *  Car
  * ]);
  *
@@ -39,9 +39,10 @@ import { stringify } from '../../src/facade/lang';
  * expect(injector.get(Car).engine instanceof Engine).toBe(true);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class InjectMetadata {
-    constructor(token) {
+    constructor(token /** TODO #9100 */) {
         this.token = token;
     }
     toString() { return `@Inject(${stringify(this.token)})`; }
@@ -67,6 +68,7 @@ export class InjectMetadata {
  * expect(injector.get(Car).engine).toBeNull();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class OptionalMetadata {
     toString() { return `@Optional()`; }
@@ -75,6 +77,7 @@ export class OptionalMetadata {
  * `DependencyMetadata` is used by the framework to extend DI.
  * This is internal to Angular and should not be used directly.
  * @ts2dart_const
+ * @stable
  */
 export class DependencyMetadata {
     get token() { return null; }
@@ -110,6 +113,7 @@ export class DependencyMetadata {
  * expect(() => injector.get(NeedsService)).toThrowError();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class InjectableMetadata {
     constructor() {
@@ -142,6 +146,7 @@ export class InjectableMetadata {
  * expect(() => child.get(NeedsDependency)).toThrowError();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class SelfMetadata {
     toString() { return `@Self()`; }
@@ -171,6 +176,7 @@ export class SelfMetadata {
  * expect(() => inj.get(NeedsDependency)).toThrowError();
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class SkipSelfMetadata {
     toString() { return `@SkipSelf()`; }
@@ -229,6 +235,7 @@ export class SkipSelfMetadata {
  * bootstrap(App);
  *```
  * @ts2dart_const
+ * @stable
  */
 export class HostMetadata {
     toString() { return `@Host()`; }

package/esm/src/di/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"/Users/iminar/Dev/angular/modules/@angular/core/","sources":["src/di/metadata.ts"],"names":[],"mappings":"OAIS,EAAC,SAAS,EAAC,MAAM,uBAAuB;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH;IACE,YAAmB,KAAK;QAAL,UAAK,GAAL,KAAK,CAAA;IAAG,CAAC;IAC5B,QAAQ,KAAa,MAAM,CAAC,WAAW,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH;IACE,IAAI,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH;IACE;IAAe,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1C,CAAC;AAAA"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../../../modules/@angular/core/src/di/metadata.ts"],"names":[],"mappings":"OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH;IACE,YAAmB,KAAU,CAAC,iBAAiB;QAA5B,UAAK,GAAL,KAAK,CAAK;IAAqB,CAAC;IACnD,QAAQ,KAAa,MAAM,CAAC,WAAW,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH;IACE,IAAI,KAAK,KAA4B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH;IACE;IAAe,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH;IACE,QAAQ,KAAa,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1C,CAAC;AAAA","sourcesContent":["import {stringify} from '../facade/lang';\n\n/**\n * A parameter metadata that specifies a dependency.\n *\n * ### Example ([live demo](http://plnkr.co/edit/6uHYJK?p=preview))\n *\n * ```typescript\n * class Engine {}\n *\n * @Injectable()\n * class Car {\n *   engine;\n *   constructor(@Inject(\"MyEngine\") engine:Engine) {\n *     this.engine = engine;\n *   }\n * }\n *\n * var injector = Injector.resolveAndCreate([\n *  {provide: \"MyEngine\", useClass: Engine},\n *  Car\n * ]);\n *\n * expect(injector.get(Car).engine instanceof Engine).toBe(true);\n * ```\n *\n * When `@Inject()` is not present, {@link Injector} will use the type annotation of the parameter.\n *\n * ### Example\n *\n * ```typescript\n * class Engine {}\n *\n * @Injectable()\n * class Car {\n *   constructor(public engine: Engine) {} //same as constructor(@Inject(Engine) engine:Engine)\n * }\n *\n * var injector = Injector.resolveAndCreate([Engine, Car]);\n * expect(injector.get(Car).engine instanceof Engine).toBe(true);\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class InjectMetadata {\n  constructor(public token: any /** TODO #9100 */) {}\n  toString(): string { return `@Inject(${stringify(this.token)})`; }\n}\n\n/**\n * A parameter metadata that marks a dependency as optional. {@link Injector} provides `null` if\n * the dependency is not found.\n *\n * ### Example ([live demo](http://plnkr.co/edit/AsryOm?p=preview))\n *\n * ```typescript\n * class Engine {}\n *\n * @Injectable()\n * class Car {\n *   engine;\n *   constructor(@Optional() engine:Engine) {\n *     this.engine = engine;\n *   }\n * }\n *\n * var injector = Injector.resolveAndCreate([Car]);\n * expect(injector.get(Car).engine).toBeNull();\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class OptionalMetadata {\n  toString(): string { return `@Optional()`; }\n}\n\n/**\n * `DependencyMetadata` is used by the framework to extend DI.\n * This is internal to Angular and should not be used directly.\n * @ts2dart_const\n * @stable\n */\nexport class DependencyMetadata {\n  get token(): any /** TODO #9100 */ { return null; }\n}\n\n/**\n * A marker metadata that marks a class as available to {@link Injector} for creation.\n *\n * ### Example ([live demo](http://plnkr.co/edit/Wk4DMQ?p=preview))\n *\n * ```typescript\n * @Injectable()\n * class UsefulService {}\n *\n * @Injectable()\n * class NeedsService {\n *   constructor(public service:UsefulService) {}\n * }\n *\n * var injector = Injector.resolveAndCreate([NeedsService, UsefulService]);\n * expect(injector.get(NeedsService).service instanceof UsefulService).toBe(true);\n * ```\n * {@link Injector} will throw {@link NoAnnotationError} when trying to instantiate a class that\n * does not have `@Injectable` marker, as shown in the example below.\n *\n * ```typescript\n * class UsefulService {}\n *\n * class NeedsService {\n *   constructor(public service:UsefulService) {}\n * }\n *\n * var injector = Injector.resolveAndCreate([NeedsService, UsefulService]);\n * expect(() => injector.get(NeedsService)).toThrowError();\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class InjectableMetadata {\n  constructor() {}\n}\n\n/**\n * Specifies that an {@link Injector} should retrieve a dependency only from itself.\n *\n * ### Example ([live demo](http://plnkr.co/edit/NeagAg?p=preview))\n *\n * ```typescript\n * class Dependency {\n * }\n *\n * @Injectable()\n * class NeedsDependency {\n *   dependency;\n *   constructor(@Self() dependency:Dependency) {\n *     this.dependency = dependency;\n *   }\n * }\n *\n * var inj = Injector.resolveAndCreate([Dependency, NeedsDependency]);\n * var nd = inj.get(NeedsDependency);\n *\n * expect(nd.dependency instanceof Dependency).toBe(true);\n *\n * var inj = Injector.resolveAndCreate([Dependency]);\n * var child = inj.resolveAndCreateChild([NeedsDependency]);\n * expect(() => child.get(NeedsDependency)).toThrowError();\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class SelfMetadata {\n  toString(): string { return `@Self()`; }\n}\n\n/**\n * Specifies that the dependency resolution should start from the parent injector.\n *\n * ### Example ([live demo](http://plnkr.co/edit/Wchdzb?p=preview))\n *\n * ```typescript\n * class Dependency {\n * }\n *\n * @Injectable()\n * class NeedsDependency {\n *   dependency;\n *   constructor(@SkipSelf() dependency:Dependency) {\n *     this.dependency = dependency;\n *   }\n * }\n *\n * var parent = Injector.resolveAndCreate([Dependency]);\n * var child = parent.resolveAndCreateChild([NeedsDependency]);\n * expect(child.get(NeedsDependency).dependency instanceof Depedency).toBe(true);\n *\n * var inj = Injector.resolveAndCreate([Dependency, NeedsDependency]);\n * expect(() => inj.get(NeedsDependency)).toThrowError();\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class SkipSelfMetadata {\n  toString(): string { return `@SkipSelf()`; }\n}\n\n/**\n * Specifies that an injector should retrieve a dependency from any injector until reaching the\n * closest host.\n *\n * In Angular, a component element is automatically declared as a host for all the injectors in\n * its view.\n *\n * ### Example ([live demo](http://plnkr.co/edit/GX79pV?p=preview))\n *\n * In the following example `App` contains `ParentCmp`, which contains `ChildDirective`.\n * So `ParentCmp` is the host of `ChildDirective`.\n *\n * `ChildDirective` depends on two services: `HostService` and `OtherService`.\n * `HostService` is defined at `ParentCmp`, and `OtherService` is defined at `App`.\n *\n *```typescript\n * class OtherService {}\n * class HostService {}\n *\n * @Directive({\n *   selector: 'child-directive'\n * })\n * class ChildDirective {\n *   constructor(@Optional() @Host() os:OtherService, @Optional() @Host() hs:HostService){\n *     console.log(\"os is null\", os);\n *     console.log(\"hs is NOT null\", hs);\n *   }\n * }\n *\n * @Component({\n *   selector: 'parent-cmp',\n *   providers: [HostService],\n *   template: `\n *     Dir: <child-directive></child-directive>\n *   `,\n *   directives: [ChildDirective]\n * })\n * class ParentCmp {\n * }\n *\n * @Component({\n *   selector: 'app',\n *   providers: [OtherService],\n *   template: `\n *     Parent: <parent-cmp></parent-cmp>\n *   `,\n *   directives: [ParentCmp]\n * })\n * class App {\n * }\n *\n * bootstrap(App);\n *```\n * @ts2dart_const\n * @stable\n */\nexport class HostMetadata {\n  toString(): string { return `@Host()`; }\n}\n\ninterface DecoratorInvocation {\n  type: Function;\n  args?: any[];\n}\n"]}

package/esm/src/di/opaque_token.d.ts

@@ -7,7 +7,7 @@
  * var t = new OpaqueToken("value");
  *
  * var injector = Injector.resolveAndCreate([
- *   provide(t, {useValue: "bindingValue"})
+ *   {provide: t, useValue: "bindingValue"}
  * ]);
  *
  * expect(injector.get(t)).toEqual("bindingValue");
@@ -19,6 +19,7 @@
  * Using an `OpaqueToken` is preferable to using an `Object` as tokens because it provides better
  * error messages.
  * @ts2dart_const
+ * @stable
  */
 export declare class OpaqueToken {
     private _desc;

package/esm/src/di/opaque_token.js

@@ -1,25 +1,26 @@
 /**
-* Creates a token that can be used in a DI Provider.
-*
-* ### Example ([live demo](http://plnkr.co/edit/Ys9ezXpj2Mnoy3Uc8KBp?p=preview))
-*
-* ```typescript
-* var t = new OpaqueToken("value");
-*
-* var injector = Injector.resolveAndCreate([
-*   provide(t, {useValue: "bindingValue"})
-* ]);
-*
-* expect(injector.get(t)).toEqual("bindingValue");
-* ```
-*
-* Using an `OpaqueToken` is preferable to using strings as tokens because of possible collisions
-* caused by multiple providers using the same string as two different tokens.
-*
-* Using an `OpaqueToken` is preferable to using an `Object` as tokens because it provides better
-* error messages.
-* @ts2dart_const
-*/
+ * Creates a token that can be used in a DI Provider.
+ *
+ * ### Example ([live demo](http://plnkr.co/edit/Ys9ezXpj2Mnoy3Uc8KBp?p=preview))
+ *
+ * ```typescript
+ * var t = new OpaqueToken("value");
+ *
+ * var injector = Injector.resolveAndCreate([
+ *   {provide: t, useValue: "bindingValue"}
+ * ]);
+ *
+ * expect(injector.get(t)).toEqual("bindingValue");
+ * ```
+ *
+ * Using an `OpaqueToken` is preferable to using strings as tokens because of possible collisions
+ * caused by multiple providers using the same string as two different tokens.
+ *
+ * Using an `OpaqueToken` is preferable to using an `Object` as tokens because it provides better
+ * error messages.
+ * @ts2dart_const
+ * @stable
+ */
 export class OpaqueToken {
     constructor(_desc) {
         this._desc = _desc;

package/esm/src/di/opaque_token.js.map

@@ -1 +1 @@
-{"version":3,"file":"opaque_token.js","sourceRoot":"/Users/iminar/Dev/angular/modules/@angular/core/","sources":["src/di/opaque_token.ts"],"names":[],"mappings":"AAIE;;;;;;;;;;;;;;;;;;;;;EAqBC;AACH;IACE,YAAoB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAErC,QAAQ,KAAa,MAAM,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAAA"}
+{"version":3,"file":"opaque_token.js","sourceRoot":"","sources":["../../../../../../modules/@angular/core/src/di/opaque_token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IACE,YAAoB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAErC,QAAQ,KAAa,MAAM,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAAA","sourcesContent":["/**\n * Creates a token that can be used in a DI Provider.\n *\n * ### Example ([live demo](http://plnkr.co/edit/Ys9ezXpj2Mnoy3Uc8KBp?p=preview))\n *\n * ```typescript\n * var t = new OpaqueToken(\"value\");\n *\n * var injector = Injector.resolveAndCreate([\n *   {provide: t, useValue: \"bindingValue\"}\n * ]);\n *\n * expect(injector.get(t)).toEqual(\"bindingValue\");\n * ```\n *\n * Using an `OpaqueToken` is preferable to using strings as tokens because of possible collisions\n * caused by multiple providers using the same string as two different tokens.\n *\n * Using an `OpaqueToken` is preferable to using an `Object` as tokens because it provides better\n * error messages.\n * @ts2dart_const\n * @stable\n */\nexport class OpaqueToken {\n  constructor(private _desc: string) {}\n\n  toString(): string { return `Token ${this._desc}`; }\n}\n\ninterface DecoratorInvocation {\n  type: Function;\n  args?: any[];\n}\n"]}

package/esm/src/di/provider.d.ts

@@ -1,4 +1,4 @@
-import { Type } from '../../src/facade/lang';
+import { Type } from '../facade/lang';
 /**
  * Describes how the {@link Injector} should instantiate a given token.
  *
@@ -14,6 +14,7 @@ import { Type } from '../../src/facade/lang';
  * expect(injector.get("message")).toEqual('Hello');
  * ```
  * @ts2dart_const
+ * @deprecated
  */
 export declare class Provider {
     /**
@@ -136,8 +137,6 @@ export declare class Provider {
      * Used in conjunction with `useFactory`.
      */
     dependencies: Object[];
-    /** @internal */
-    _multi: boolean;
     constructor(token: any, {useClass, useValue, useExisting, useFactory, deps, multi}: {
         useClass?: Type;
         useValue?: any;
@@ -224,6 +223,7 @@ export declare class Binding extends Provider {
 export declare function bind(token: any): ProviderBuilder;
 /**
  * Helper class for the {@link bind} function.
+ * @deprecated
  */
 export declare class ProviderBuilder {
     token: any;
@@ -243,11 +243,11 @@ export declare class ProviderBuilder {
      *
      * var injectorClass = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useClass: Car})
+     *   {provide: Vehicle, useClass: Car}
      * ]);
      * var injectorAlias = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useExisting: Car})
+     *   {provide: Vehicle, useExisting: Car}
      * ]);
      *
      * expect(injectorClass.get(Vehicle)).not.toBe(injectorClass.get(Car));
@@ -265,7 +265,7 @@ export declare class ProviderBuilder {
      *
      * ```typescript
      * var injector = Injector.resolveAndCreate([
-     *   provide('message', {useValue: 'Hello'})
+     *   {provide: 'message', useValue: 'Hello'}
      * ]);
      *
      * expect(injector.get('message')).toEqual('Hello');
@@ -290,11 +290,11 @@ export declare class ProviderBuilder {
      *
      * var injectorAlias = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useExisting: Car})
+     *   {provide: Vehicle, useExisting: Car}
      * ]);
      * var injectorClass = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useClass: Car})
+     *   {provide: Vehicle, useClass: Car})
      * ]);
      *
      * expect(injectorAlias.get(Vehicle)).toBe(injectorAlias.get(Car));
@@ -312,8 +312,8 @@ export declare class ProviderBuilder {
      *
      * ```typescript
      * var injector = Injector.resolveAndCreate([
-     *   provide(Number, {useFactory: () => { return 1+2; }}),
-     *   provide(String, {useFactory: (v) => { return "Value: " + v; }, deps: [Number]})
+     *   {provide: Number, useFactory: () => { return 1+2; }},
+     *   {provide: String, useFactory: (v) => { return "Value: " + v; }, deps: [Number]}
      * ]);
      *
      * expect(injector.get(Number)).toEqual(3);
@@ -328,6 +328,7 @@ export declare class ProviderBuilder {
  * See {@link Provider} for more details.
  *
  * <!-- TODO: improve the docs -->
+ * @deprecated
  */
 export declare function provide(token: any, {useClass, useValue, useExisting, useFactory, deps, multi}: {
     useClass?: Type;

package/esm/src/di/provider.js

@@ -1,5 +1,5 @@
-import { normalizeBool, isType, isBlank, isFunction, stringify } from '../../src/facade/lang';
-import { BaseException } from '../../src/facade/exceptions';
+import { BaseException } from '../facade/exceptions';
+import { isBlank, isFunction, isType, normalizeBool, stringify } from '../facade/lang';
 /**
  * Describes how the {@link Injector} should instantiate a given token.
  *
@@ -15,9 +15,10 @@ import { BaseException } from '../../src/facade/exceptions';
  * expect(injector.get("message")).toEqual('Hello');
  * ```
  * @ts2dart_const
+ * @deprecated
  */
 export class Provider {
-    constructor(token, { useClass, useValue, useExisting, useFactory, deps, multi }) {
+    constructor(token /** TODO #9100 */, { useClass, useValue, useExisting, useFactory, deps, multi }) {
         this.token = token;
         this.useClass = useClass;
         this.useValue = useValue;
@@ -65,7 +66,7 @@ export class Provider {
  * @ts2dart_const
  */
 export class Binding extends Provider {
-    constructor(token, { toClass, toValue, toAlias, toFactory, deps, multi }) {
+    constructor(token /** TODO #9100 */, { toClass, toValue, toAlias, toFactory, deps, multi }) {
         super(token, {
             useClass: toClass,
             useValue: toValue,
@@ -104,14 +105,15 @@ export class Binding extends Provider {
  *
  * @deprecated
  */
-export function bind(token) {
+export function bind(token /** TODO #9100 */) {
     return new ProviderBuilder(token);
 }
 /**
  * Helper class for the {@link bind} function.
+ * @deprecated
  */
 export class ProviderBuilder {
-    constructor(token) {
+    constructor(token /** TODO #9100 */) {
         this.token = token;
     }
     /**
@@ -129,11 +131,11 @@ export class ProviderBuilder {
      *
      * var injectorClass = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useClass: Car})
+     *   {provide: Vehicle, useClass: Car}
      * ]);
      * var injectorAlias = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useExisting: Car})
+     *   {provide: Vehicle, useExisting: Car}
      * ]);
      *
      * expect(injectorClass.get(Vehicle)).not.toBe(injectorClass.get(Car));
@@ -156,7 +158,7 @@ export class ProviderBuilder {
      *
      * ```typescript
      * var injector = Injector.resolveAndCreate([
-     *   provide('message', {useValue: 'Hello'})
+     *   {provide: 'message', useValue: 'Hello'}
      * ]);
      *
      * expect(injector.get('message')).toEqual('Hello');
@@ -181,11 +183,11 @@ export class ProviderBuilder {
      *
      * var injectorAlias = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useExisting: Car})
+     *   {provide: Vehicle, useExisting: Car}
      * ]);
      * var injectorClass = Injector.resolveAndCreate([
      *   Car,
-     *   provide(Vehicle, {useClass: Car})
+     *   {provide: Vehicle, useClass: Car})
      * ]);
      *
      * expect(injectorAlias.get(Vehicle)).toBe(injectorAlias.get(Car));
@@ -208,8 +210,8 @@ export class ProviderBuilder {
      *
      * ```typescript
      * var injector = Injector.resolveAndCreate([
-     *   provide(Number, {useFactory: () => { return 1+2; }}),
-     *   provide(String, {useFactory: (v) => { return "Value: " + v; }, deps: [Number]})
+     *   {provide: Number, useFactory: () => { return 1+2; }},
+     *   {provide: String, useFactory: (v) => { return "Value: " + v; }, deps: [Number]}
      * ]);
      *
      * expect(injector.get(Number)).toEqual(3);
@@ -229,8 +231,9 @@ export class ProviderBuilder {
  * See {@link Provider} for more details.
  *
  * <!-- TODO: improve the docs -->
+ * @deprecated
  */
-export function provide(token, { useClass, useValue, useExisting, useFactory, deps, multi }) {
+export function provide(token /** TODO #9100 */, { useClass, useValue, useExisting, useFactory, deps, multi }) {
     return new Provider(token, {
         useClass: useClass,
         useValue: useValue,

package/esm/src/di/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"/Users/iminar/Dev/angular/modules/@angular/core/","sources":["src/di/provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../../../modules/@angular/core/src/di/provider.ts"],"names":[],"mappings":"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","sourcesContent":["import {BaseException} from '../facade/exceptions';\nimport {Type, isBlank, isFunction, isType, normalizeBool, stringify} from '../facade/lang';\n\n\n/**\n * Describes how the {@link Injector} should instantiate a given token.\n *\n * See {@link provide}.\n *\n * ### Example ([live demo](http://plnkr.co/edit/GNAyj6K6PfYg2NBzgwZ5?p%3Dpreview&p=preview))\n *\n * ```javascript\n * var injector = Injector.resolveAndCreate([\n *   new Provider(\"message\", { useValue: 'Hello' })\n * ]);\n *\n * expect(injector.get(\"message\")).toEqual('Hello');\n * ```\n * @ts2dart_const\n * @deprecated\n */\nexport class Provider {\n  /**\n   * Token used when retrieving this provider. Usually, it is a type {@link Type}.\n   */\n  token: any /** TODO #9100 */;\n\n  /**\n   * Binds a DI token to an implementation class.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/RSTG86qgmoxCyj9SWPwY?p=preview))\n   *\n   * Because `useExisting` and `useClass` are often confused, the example contains\n   * both use cases for easy comparison.\n   *\n   * ```typescript\n   * class Vehicle {}\n   *\n   * class Car extends Vehicle {}\n   *\n   * var injectorClass = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle,  useClass: Car }\n   * ]);\n   * var injectorAlias = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle,  useExisting: Car }\n   * ]);\n   *\n   * expect(injectorClass.get(Vehicle)).not.toBe(injectorClass.get(Car));\n   * expect(injectorClass.get(Vehicle) instanceof Car).toBe(true);\n   *\n   * expect(injectorAlias.get(Vehicle)).toBe(injectorAlias.get(Car));\n   * expect(injectorAlias.get(Vehicle) instanceof Car).toBe(true);\n   * ```\n   */\n  useClass: Type;\n\n  /**\n   * Binds a DI token to a value.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/UFVsMVQIDe7l4waWziES?p=preview))\n   *\n   * ```javascript\n   * var injector = Injector.resolveAndCreate([\n   *   new Provider(\"message\", { useValue: 'Hello' })\n   * ]);\n   *\n   * expect(injector.get(\"message\")).toEqual('Hello');\n   * ```\n   */\n  useValue: any /** TODO #9100 */;\n\n  /**\n   * Binds a DI token to an existing token.\n   *\n   * {@link Injector} returns the same instance as if the provided token was used.\n   * This is in contrast to `useClass` where a separate instance of `useClass` is returned.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/QsatsOJJ6P8T2fMe9gr8?p=preview))\n   *\n   * Because `useExisting` and `useClass` are often confused the example contains\n   * both use cases for easy comparison.\n   *\n   * ```typescript\n   * class Vehicle {}\n   *\n   * class Car extends Vehicle {}\n   *\n   * var injectorAlias = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle,  useExisting: Car }\n   * ]);\n   * var injectorClass = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle,  useClass: Car }\n   * ]);\n   *\n   * expect(injectorAlias.get(Vehicle)).toBe(injectorAlias.get(Car));\n   * expect(injectorAlias.get(Vehicle) instanceof Car).toBe(true);\n   *\n   * expect(injectorClass.get(Vehicle)).not.toBe(injectorClass.get(Car));\n   * expect(injectorClass.get(Vehicle) instanceof Car).toBe(true);\n   * ```\n   */\n  useExisting: any /** TODO #9100 */;\n\n  /**\n   * Binds a DI token to a function which computes the value.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/Scoxy0pJNqKGAPZY1VVC?p=preview))\n   *\n   * ```typescript\n   * var injector = Injector.resolveAndCreate([\n   *   {provide: Number,  useFactory: () => { return 1+2; }},\n   *   new Provider(String, { useFactory: (value) => { return \"Value: \" + value; },\n   *                       deps: [Number] })\n   * ]);\n   *\n   * expect(injector.get(Number)).toEqual(3);\n   * expect(injector.get(String)).toEqual('Value: 3');\n   * ```\n   *\n   * Used in conjunction with dependencies.\n   */\n  useFactory: Function;\n\n  /**\n   * Specifies a set of dependencies\n   * (as `token`s) which should be injected into the factory function.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/Scoxy0pJNqKGAPZY1VVC?p=preview))\n   *\n   * ```typescript\n   * var injector = Injector.resolveAndCreate([\n   *   {provide: Number,  useFactory: () => { return 1+2; }},\n   *   new Provider(String, { useFactory: (value) => { return \"Value: \" + value; },\n   *                       deps: [Number] })\n   * ]);\n   *\n   * expect(injector.get(Number)).toEqual(3);\n   * expect(injector.get(String)).toEqual('Value: 3');\n   * ```\n   *\n   * Used in conjunction with `useFactory`.\n   */\n  dependencies: Object[];\n\n  /** @internal */\n  _multi: boolean;\n\n  constructor(\n      token: any /** TODO #9100 */, {useClass, useValue, useExisting, useFactory, deps, multi}: {\n        useClass?: Type,\n        useValue?: any,\n        useExisting?: any,\n        useFactory?: Function,\n        deps?: Object[],\n        multi?: boolean\n      }) {\n    this.token = token;\n    this.useClass = useClass;\n    this.useValue = useValue;\n    this.useExisting = useExisting;\n    this.useFactory = useFactory;\n    this.dependencies = deps;\n    this._multi = multi;\n  }\n\n  // TODO: Provide a full working example after alpha38 is released.\n  /**\n   * Creates multiple providers matching the same token (a multi-provider).\n   *\n   * Multi-providers are used for creating pluggable service, where the system comes\n   * with some default providers, and the user can register additional providers.\n   * The combination of the default providers and the additional providers will be\n   * used to drive the behavior of the system.\n   *\n   * ### Example\n   *\n   * ```typescript\n   * var injector = Injector.resolveAndCreate([\n   *   new Provider(\"Strings\", { useValue: \"String1\", multi: true}),\n   *   new Provider(\"Strings\", { useValue: \"String2\", multi: true})\n   * ]);\n   *\n   * expect(injector.get(\"Strings\")).toEqual([\"String1\", \"String2\"]);\n   * ```\n   *\n   * Multi-providers and regular providers cannot be mixed. The following\n   * will throw an exception:\n   *\n   * ```typescript\n   * var injector = Injector.resolveAndCreate([\n   *   new Provider(\"Strings\", { useValue: \"String1\", multi: true }),\n   *   new Provider(\"Strings\", { useValue: \"String2\"})\n   * ]);\n   * ```\n   */\n  get multi(): boolean { return normalizeBool(this._multi); }\n}\n\n/**\n * See {@link Provider} instead.\n *\n * @deprecated\n * @ts2dart_const\n */\nexport class Binding extends Provider {\n  constructor(token: any /** TODO #9100 */, {toClass, toValue, toAlias, toFactory, deps, multi}: {\n    toClass?: Type,\n    toValue?: any,\n    toAlias?: any,\n    toFactory: Function, deps?: Object[], multi?: boolean\n  }) {\n    super(token, {\n      useClass: toClass,\n      useValue: toValue,\n      useExisting: toAlias,\n      useFactory: toFactory,\n      deps: deps,\n      multi: multi\n    });\n  }\n\n  /**\n   * @deprecated\n   */\n  get toClass() { return this.useClass; }\n\n  /**\n   * @deprecated\n   */\n  get toAlias() { return this.useExisting; }\n\n  /**\n   * @deprecated\n   */\n  get toFactory() { return this.useFactory; }\n\n  /**\n   * @deprecated\n   */\n  get toValue() { return this.useValue; }\n}\n\n/**\n * Creates a {@link Provider}.\n *\n * To construct a {@link Provider}, bind a `token` to either a class, a value, a factory function,\n * or\n * to an existing `token`.\n * See {@link ProviderBuilder} for more details.\n *\n * The `token` is most commonly a class or {@link OpaqueToken-class.html}.\n *\n * @deprecated\n */\nexport function bind(token: any /** TODO #9100 */): ProviderBuilder {\n  return new ProviderBuilder(token);\n}\n\n/**\n * Helper class for the {@link bind} function.\n * @deprecated\n */\nexport class ProviderBuilder {\n  constructor(public token: any /** TODO #9100 */) {}\n\n  /**\n   * Binds a DI token to a class.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/ZpBCSYqv6e2ud5KXLdxQ?p=preview))\n   *\n   * Because `toAlias` and `toClass` are often confused, the example contains\n   * both use cases for easy comparison.\n   *\n   * ```typescript\n   * class Vehicle {}\n   *\n   * class Car extends Vehicle {}\n   *\n   * var injectorClass = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle, useClass: Car}\n   * ]);\n   * var injectorAlias = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle, useExisting: Car}\n   * ]);\n   *\n   * expect(injectorClass.get(Vehicle)).not.toBe(injectorClass.get(Car));\n   * expect(injectorClass.get(Vehicle) instanceof Car).toBe(true);\n   *\n   * expect(injectorAlias.get(Vehicle)).toBe(injectorAlias.get(Car));\n   * expect(injectorAlias.get(Vehicle) instanceof Car).toBe(true);\n   * ```\n   */\n  toClass(type: Type): Provider {\n    if (!isType(type)) {\n      throw new BaseException(\n          `Trying to create a class provider but \"${stringify(type)}\" is not a class!`);\n    }\n    return new Provider(this.token, {useClass: type});\n  }\n\n  /**\n   * Binds a DI token to a value.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/G024PFHmDL0cJFgfZK8O?p=preview))\n   *\n   * ```typescript\n   * var injector = Injector.resolveAndCreate([\n   *   {provide: 'message', useValue: 'Hello'}\n   * ]);\n   *\n   * expect(injector.get('message')).toEqual('Hello');\n   * ```\n   */\n  toValue(value: any): Provider { return new Provider(this.token, {useValue: value}); }\n\n  /**\n   * Binds a DI token to an existing token.\n   *\n   * Angular will return the same instance as if the provided token was used. (This is\n   * in contrast to `useClass` where a separate instance of `useClass` will be returned.)\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/uBaoF2pN5cfc5AfZapNw?p=preview))\n   *\n   * Because `toAlias` and `toClass` are often confused, the example contains\n   * both use cases for easy comparison.\n   *\n   * ```typescript\n   * class Vehicle {}\n   *\n   * class Car extends Vehicle {}\n   *\n   * var injectorAlias = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle, useExisting: Car}\n   * ]);\n   * var injectorClass = Injector.resolveAndCreate([\n   *   Car,\n   *   {provide: Vehicle, useClass: Car})\n   * ]);\n   *\n   * expect(injectorAlias.get(Vehicle)).toBe(injectorAlias.get(Car));\n   * expect(injectorAlias.get(Vehicle) instanceof Car).toBe(true);\n   *\n   * expect(injectorClass.get(Vehicle)).not.toBe(injectorClass.get(Car));\n   * expect(injectorClass.get(Vehicle) instanceof Car).toBe(true);\n   * ```\n   */\n  toAlias(aliasToken: /*Type*/ any): Provider {\n    if (isBlank(aliasToken)) {\n      throw new BaseException(`Can not alias ${stringify(this.token)} to a blank value!`);\n    }\n    return new Provider(this.token, {useExisting: aliasToken});\n  }\n\n  /**\n   * Binds a DI token to a function which computes the value.\n   *\n   * ### Example ([live demo](http://plnkr.co/edit/OejNIfTT3zb1iBxaIYOb?p=preview))\n   *\n   * ```typescript\n   * var injector = Injector.resolveAndCreate([\n   *   {provide: Number, useFactory: () => { return 1+2; }},\n   *   {provide: String, useFactory: (v) => { return \"Value: \" + v; }, deps: [Number]}\n   * ]);\n   *\n   * expect(injector.get(Number)).toEqual(3);\n   * expect(injector.get(String)).toEqual('Value: 3');\n   * ```\n   */\n  toFactory(factory: Function, dependencies?: any[]): Provider {\n    if (!isFunction(factory)) {\n      throw new BaseException(\n          `Trying to create a factory provider but \"${stringify(factory)}\" is not a function!`);\n    }\n    return new Provider(this.token, {useFactory: factory, deps: dependencies});\n  }\n}\n\n/**\n * Creates a {@link Provider}.\n *\n * See {@link Provider} for more details.\n *\n * <!-- TODO: improve the docs -->\n * @deprecated\n */\nexport function provide(\n    token: any /** TODO #9100 */, {useClass, useValue, useExisting, useFactory, deps, multi}: {\n      useClass?: Type,\n      useValue?: any,\n      useExisting?: any,\n      useFactory?: Function,\n      deps?: Object[],\n      multi?: boolean\n    }): Provider {\n  return new Provider(token, {\n    useClass: useClass,\n    useValue: useValue,\n    useExisting: useExisting,\n    useFactory: useFactory,\n    deps: deps,\n    multi: multi\n  });\n}\n\ninterface DecoratorInvocation {\n  type: Function;\n  args?: any[];\n}\n"]}

package/esm/src/di/provider.metadata.json

@@ -0,0 +1 @@
+{"__symbolic":"module","version":1,"metadata":{"bind":{"__symbolic":"function","parameters":["token"],"value":{"__symbolic":"new","expression":{"__symbolic":"reference","name":"ProviderBuilder"},"arguments":[{"__symbolic":"reference","name":"token"}]}},"provide":{"__symbolic":"function","parameters":["token","useClass","useValue","useExisting","useFactory","deps","multi"],"value":{"__symbolic":"new","expression":{"__symbolic":"reference","name":"Provider"},"arguments":[{"__symbolic":"reference","name":"token"},{"useClass":{"__symbolic":"reference","name":"useClass"},"useValue":{"__symbolic":"reference","name":"useValue"},"useExisting":{"__symbolic":"reference","name":"useExisting"},"useFactory":{"__symbolic":"reference","name":"useFactory"},"deps":{"__symbolic":"reference","name":"deps"},"multi":{"__symbolic":"reference","name":"multi"}}]}}}}