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

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

@@ -1,5 +1,5 @@
-import { Type } from '../../src/facade/lang';
 import { DependencyMetadata } from '../di/metadata';
+import { Type } from '../facade/lang';
 /**
  * Specifies that a constant attribute value should be injected.
  *
@@ -17,6 +17,7 @@ import { DependencyMetadata } from '../di/metadata';
  *
  * {@example core/ts/metadata/metadata.ts region='attributeMetadata'}
  * @ts2dart_const
+ * @stable
  */
 export declare class AttributeMetadata extends DependencyMetadata {
     attributeName: string;
@@ -131,6 +132,7 @@ export declare class AttributeMetadata extends DependencyMetadata {
  * The injected object is an unmodifiable live list.
  * See {@link QueryList} for more details.
  * @ts2dart_const
+ * @deprecated
  */
 export declare class QueryMetadata extends DependencyMetadata {
     private _selector;
@@ -188,6 +190,7 @@ export declare class QueryMetadata extends DependencyMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class ContentChildrenMetadata extends QueryMetadata {
     constructor(_selector: Type | string, {descendants, read}?: {
@@ -215,6 +218,7 @@ export declare class ContentChildrenMetadata extends QueryMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class ContentChildMetadata extends QueryMetadata {
     constructor(_selector: Type | string, {read}?: {
@@ -256,6 +260,7 @@ export declare class ContentChildMetadata extends QueryMetadata {
  * The injected object is an iterable and observable live list.
  * See {@link QueryList} for more details.
  * @ts2dart_const
+ * @deprecated
  */
 export declare class ViewQueryMetadata extends QueryMetadata {
     constructor(_selector: Type | string, {descendants, first, read}?: {
@@ -346,6 +351,7 @@ export declare class ViewQueryMetadata extends QueryMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class ViewChildrenMetadata extends ViewQueryMetadata {
     constructor(_selector: Type | string, {read}?: {
@@ -422,6 +428,7 @@ export declare class ViewChildrenMetadata extends ViewQueryMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class ViewChildMetadata extends ViewQueryMetadata {
     constructor(_selector: Type | string, {read}?: {

package/esm/src/metadata/di.js

@@ -1,6 +1,6 @@
-import { stringify, isString } from '../../src/facade/lang';
-import { DependencyMetadata } from '../di/metadata';
 import { resolveForwardRef } from '../di/forward_ref';
+import { DependencyMetadata } from '../di/metadata';
+import { StringWrapper, isString, stringify } from '../facade/lang';
 /**
  * Specifies that a constant attribute value should be injected.
  *
@@ -18,6 +18,7 @@ import { resolveForwardRef } from '../di/forward_ref';
  *
  * {@example core/ts/metadata/metadata.ts region='attributeMetadata'}
  * @ts2dart_const
+ * @stable
  */
 export class AttributeMetadata extends DependencyMetadata {
     constructor(attributeName) {
@@ -141,6 +142,7 @@ export class AttributeMetadata extends DependencyMetadata {
  * The injected object is an unmodifiable live list.
  * See {@link QueryList} for more details.
  * @ts2dart_const
+ * @deprecated
  */
 export class QueryMetadata extends DependencyMetadata {
     constructor(_selector, { descendants = false, first = false, read = null } = {}) {
@@ -166,7 +168,7 @@ export class QueryMetadata extends DependencyMetadata {
      * returns a list of variable bindings this is querying for.
      * Only applicable if this is a variable bindings query.
      */
-    get varBindings() { return this.selector.split(','); }
+    get varBindings() { return StringWrapper.split(this.selector, /\s*,\s*/g); }
     toString() { return `@Query(${stringify(this.selector)})`; }
 }
 // TODO: add an example after ContentChildren and ViewChildren are in master
@@ -190,6 +192,7 @@ export class QueryMetadata extends DependencyMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class ContentChildrenMetadata extends QueryMetadata {
     constructor(_selector, { descendants = false, read = null } = {}) {
@@ -217,6 +220,7 @@ export class ContentChildrenMetadata extends QueryMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class ContentChildMetadata extends QueryMetadata {
     constructor(_selector, { read = null } = {}) {
@@ -258,6 +262,7 @@ export class ContentChildMetadata extends QueryMetadata {
  * The injected object is an iterable and observable live list.
  * See {@link QueryList} for more details.
  * @ts2dart_const
+ * @deprecated
  */
 export class ViewQueryMetadata extends QueryMetadata {
     constructor(_selector, { descendants = false, first = false, read = null } = {}) {
@@ -346,6 +351,7 @@ export class ViewQueryMetadata extends QueryMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class ViewChildrenMetadata extends ViewQueryMetadata {
     constructor(_selector, { read = null } = {}) {
@@ -422,6 +428,7 @@ export class ViewChildrenMetadata extends ViewQueryMetadata {
  * }
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class ViewChildMetadata extends ViewQueryMetadata {
     constructor(_selector, { read = null } = {}) {

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

@@ -1 +1 @@
-{"version":3,"file":"di.js","sourceRoot":"/Users/iminar/Dev/angular/modules/@angular/core/","sources":["src/metadata/di.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"di.js","sourceRoot":"","sources":["../../../../../../modules/@angular/core/src/metadata/di.ts"],"names":[],"mappings":"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","sourcesContent":["import {resolveForwardRef} from '../di/forward_ref';\nimport {DependencyMetadata} from '../di/metadata';\nimport {StringWrapper, Type, isString, stringify} from '../facade/lang';\n\n\n/**\n * Specifies that a constant attribute value should be injected.\n *\n * The directive can inject constant string literals of host element attributes.\n *\n * ### Example\n *\n * Suppose we have an `<input>` element and want to know its `type`.\n *\n * ```html\n * <input type=\"text\">\n * ```\n *\n * A decorator can inject string literal `text` like so:\n *\n * {@example core/ts/metadata/metadata.ts region='attributeMetadata'}\n * @ts2dart_const\n * @stable\n */\nexport class AttributeMetadata extends DependencyMetadata {\n  constructor(public attributeName: string) { super(); }\n\n  get token(): AttributeMetadata {\n    // Normally one would default a token to a type of an injected value but here\n    // the type of a variable is \"string\" and we can't use primitive type as a return value\n    // so we use instance of Attribute instead. This doesn't matter much in practice as arguments\n    // with @Attribute annotation are injected by ElementInjector that doesn't take tokens into\n    // account.\n    return this;\n  }\n  toString(): string { return `@Attribute(${stringify(this.attributeName)})`; }\n}\n\n/**\n * Declares an injectable parameter to be a live list of directives or variable\n * bindings from the content children of a directive.\n *\n * ### Example ([live demo](http://plnkr.co/edit/lY9m8HLy7z06vDoUaSN2?p=preview))\n *\n * Assume that `<tabs>` component would like to get a list its children `<pane>`\n * components as shown in this example:\n *\n * ```html\n * <tabs>\n *   <pane title=\"Overview\">...</pane>\n *   <pane *ngFor=\"let o of objects\" [title]=\"o.title\">{{o.text}}</pane>\n * </tabs>\n * ```\n *\n * The preferred solution is to query for `Pane` directives using this decorator.\n *\n * ```javascript\n * @Component({\n *   selector: 'pane',\n *   inputs: ['title']\n * })\n * class Pane {\n *   title:string;\n * }\n *\n * @Component({\n *  selector: 'tabs',\n *  template: `\n *    <ul>\n *      <li *ngFor=\"let pane of panes\">{{pane.title}}</li>\n *    </ul>\n *    <ng-content></ng-content>\n *  `\n * })\n * class Tabs {\n *   panes: QueryList<Pane>;\n *   constructor(@Query(Pane) panes:QueryList<Pane>) {\n  *    this.panes = panes;\n  *  }\n * }\n * ```\n *\n * A query can look for variable bindings by passing in a string with desired binding symbol.\n *\n * ### Example ([live demo](http://plnkr.co/edit/sT2j25cH1dURAyBRCKx1?p=preview))\n * ```html\n * <seeker>\n *   <div #findme>...</div>\n * </seeker>\n *\n * @Component({ selector: 'seeker' })\n * class Seeker {\n *   constructor(@Query('findme') elList: QueryList<ElementRef>) {...}\n * }\n * ```\n *\n * In this case the object that is injected depend on the type of the variable\n * binding. It can be an ElementRef, a directive or a component.\n *\n * Passing in a comma separated list of variable bindings will query for all of them.\n *\n * ```html\n * <seeker>\n *   <div #find-me>...</div>\n *   <div #find-me-too>...</div>\n * </seeker>\n *\n *  @Component({\n *   selector: 'seeker'\n * })\n * class Seeker {\n *   constructor(@Query('findMe, findMeToo') elList: QueryList<ElementRef>) {...}\n * }\n * ```\n *\n * Configure whether query looks for direct children or all descendants\n * of the querying element, by using the `descendants` parameter.\n * It is set to `false` by default.\n *\n * ### Example ([live demo](http://plnkr.co/edit/wtGeB977bv7qvA5FTYl9?p=preview))\n * ```html\n * <container #first>\n *   <item>a</item>\n *   <item>b</item>\n *   <container #second>\n *     <item>c</item>\n *   </container>\n * </container>\n * ```\n *\n * When querying for items, the first container will see only `a` and `b` by default,\n * but with `Query(TextDirective, {descendants: true})` it will see `c` too.\n *\n * The queried directives are kept in a depth-first pre-order with respect to their\n * positions in the DOM.\n *\n * Query does not look deep into any subcomponent views.\n *\n * Query is updated as part of the change-detection cycle. Since change detection\n * happens after construction of a directive, QueryList will always be empty when observed in the\n * constructor.\n *\n * The injected object is an unmodifiable live list.\n * See {@link QueryList} for more details.\n * @ts2dart_const\n * @deprecated\n */\nexport class QueryMetadata extends DependencyMetadata {\n  /**\n   * whether we want to query only direct children (false) or all\n   * children (true).\n   */\n  descendants: boolean;\n  first: boolean;\n  /**\n   * The DI token to read from an element that matches the selector.\n   */\n  read: any;\n\n  constructor(private _selector: Type|string, {descendants = false, first = false, read = null}: {\n    descendants?: boolean,\n    first?: boolean,\n    read?: any\n  } = {}) {\n    super();\n    this.descendants = descendants;\n    this.first = first;\n    this.read = read;\n  }\n\n  /**\n   * always `false` to differentiate it with {@link ViewQueryMetadata}.\n   */\n  get isViewQuery(): boolean { return false; }\n\n  /**\n   * what this is querying for.\n   */\n  get selector() { return resolveForwardRef(this._selector); }\n\n  /**\n   * whether this is querying for a variable binding or a directive.\n   */\n  get isVarBindingQuery(): boolean { return isString(this.selector); }\n\n  /**\n   * returns a list of variable bindings this is querying for.\n   * Only applicable if this is a variable bindings query.\n   */\n  get varBindings(): string[] { return StringWrapper.split(this.selector, /\\s*,\\s*/g); }\n\n  toString(): string { return `@Query(${stringify(this.selector)})`; }\n}\n\n// TODO: add an example after ContentChildren and ViewChildren are in master\n/**\n * Configures a content query.\n *\n * Content queries are set before the `ngAfterContentInit` callback is called.\n *\n * ### Example\n *\n * ```\n * @Directive({\n *   selector: 'someDir'\n * })\n * class SomeDir {\n *   @ContentChildren(ChildDirective) contentChildren: QueryList<ChildDirective>;\n *\n *   ngAfterContentInit() {\n *     // contentChildren is set\n *   }\n * }\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class ContentChildrenMetadata extends QueryMetadata {\n  constructor(\n      _selector: Type|string,\n      {descendants = false, read = null}: {descendants?: boolean, read?: any} = {}) {\n    super(_selector, {descendants: descendants, read: read});\n  }\n}\n\n// TODO: add an example after ContentChild and ViewChild are in master\n/**\n * Configures a content query.\n *\n * Content queries are set before the `ngAfterContentInit` callback is called.\n *\n * ### Example\n *\n * ```\n * @Directive({\n *   selector: 'someDir'\n * })\n * class SomeDir {\n *   @ContentChild(ChildDirective) contentChild;\n *\n *   ngAfterContentInit() {\n *     // contentChild is set\n *   }\n * }\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class ContentChildMetadata extends QueryMetadata {\n  constructor(_selector: Type|string, {read = null}: {read?: any} = {}) {\n    super(_selector, {descendants: true, first: true, read: read});\n  }\n}\n\n/**\n * Similar to {@link QueryMetadata}, but querying the component view, instead of\n * the content children.\n *\n * ### Example ([live demo](http://plnkr.co/edit/eNsFHDf7YjyM6IzKxM1j?p=preview))\n *\n * ```javascript\n * @Component({\n *   ...,\n *   template: `\n *     <item> a </item>\n *     <item> b </item>\n *     <item> c </item>\n *   `\n * })\n * class MyComponent {\n *   shown: boolean;\n *\n *   constructor(private @ViewQuery(Item) items:QueryList<Item>) {\n *     items.changes.subscribe(() => console.log(items.length));\n *   }\n * }\n * ```\n *\n * Supports the same querying parameters as {@link QueryMetadata}, except\n * `descendants`. This always queries the whole view.\n *\n * As `shown` is flipped between true and false, items will contain zero of one\n * items.\n *\n * Specifies that a {@link QueryList} should be injected.\n *\n * The injected object is an iterable and observable live list.\n * See {@link QueryList} for more details.\n * @ts2dart_const\n * @deprecated\n */\nexport class ViewQueryMetadata extends QueryMetadata {\n  constructor(\n      _selector: Type|string, {descendants = false, first = false, read = null}:\n                                  {descendants?: boolean, first?: boolean, read?: any} = {}) {\n    super(_selector, {descendants: descendants, first: first, read: read});\n  }\n\n  /**\n   * always `true` to differentiate it with {@link QueryMetadata}.\n   */\n  get isViewQuery() { return true; }\n  toString(): string { return `@ViewQuery(${stringify(this.selector)})`; }\n}\n\n/**\n * Declares a list of child element references.\n *\n * Angular automatically updates the list when the DOM is updated.\n *\n * `ViewChildren` takes an argument to select elements.\n *\n * - If the argument is a type, directives or components with the type will be bound.\n *\n * - If the argument is a string, the string is interpreted as a list of comma-separated selectors.\n * For each selector, an element containing the matching template variable (e.g. `#child`) will be\n * bound.\n *\n * View children are set before the `ngAfterViewInit` callback is called.\n *\n * ### Example\n *\n * With type selector:\n *\n * ```\n * @Component({\n *   selector: 'child-cmp',\n *   template: '<p>child</p>'\n * })\n * class ChildCmp {\n *   doSomething() {}\n * }\n *\n * @Component({\n *   selector: 'some-cmp',\n *   template: `\n *     <child-cmp></child-cmp>\n *     <child-cmp></child-cmp>\n *     <child-cmp></child-cmp>\n *   `,\n *   directives: [ChildCmp]\n * })\n * class SomeCmp {\n *   @ViewChildren(ChildCmp) children:QueryList<ChildCmp>;\n *\n *   ngAfterViewInit() {\n *     // children are set\n *     this.children.toArray().forEach((child)=>child.doSomething());\n *   }\n * }\n * ```\n *\n * With string selector:\n *\n * ```\n * @Component({\n *   selector: 'child-cmp',\n *   template: '<p>child</p>'\n * })\n * class ChildCmp {\n *   doSomething() {}\n * }\n *\n * @Component({\n *   selector: 'some-cmp',\n *   template: `\n *     <child-cmp #child1></child-cmp>\n *     <child-cmp #child2></child-cmp>\n *     <child-cmp #child3></child-cmp>\n *   `,\n *   directives: [ChildCmp]\n * })\n * class SomeCmp {\n *   @ViewChildren('child1,child2,child3') children:QueryList<ChildCmp>;\n *\n *   ngAfterViewInit() {\n *     // children are set\n *     this.children.toArray().forEach((child)=>child.doSomething());\n *   }\n * }\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class ViewChildrenMetadata extends ViewQueryMetadata {\n  constructor(_selector: Type|string, {read = null}: {read?: any} = {}) {\n    super(_selector, {descendants: true, read: read});\n  }\n}\n\n/**\n *\n * Declares a reference of child element.\n *\n * `ViewChildren` takes an argument to select elements.\n *\n * - If the argument is a type, a directive or a component with the type will be bound.\n *\n If the argument is a string, the string is interpreted as a selector. An element containing the\n matching template variable (e.g. `#child`) will be bound.\n *\n * In either case, `@ViewChild()` assigns the first (looking from above) element if there are\n multiple matches.\n *\n * View child is set before the `ngAfterViewInit` callback is called.\n *\n * ### Example\n *\n * With type selector:\n *\n * ```\n * @Component({\n *   selector: 'child-cmp',\n *   template: '<p>child</p>'\n * })\n * class ChildCmp {\n *   doSomething() {}\n * }\n *\n * @Component({\n *   selector: 'some-cmp',\n *   template: '<child-cmp></child-cmp>',\n *   directives: [ChildCmp]\n * })\n * class SomeCmp {\n *   @ViewChild(ChildCmp) child:ChildCmp;\n *\n *   ngAfterViewInit() {\n *     // child is set\n *     this.child.doSomething();\n *   }\n * }\n * ```\n *\n * With string selector:\n *\n * ```\n * @Component({\n *   selector: 'child-cmp',\n *   template: '<p>child</p>'\n * })\n * class ChildCmp {\n *   doSomething() {}\n * }\n *\n * @Component({\n *   selector: 'some-cmp',\n *   template: '<child-cmp #child></child-cmp>',\n *   directives: [ChildCmp]\n * })\n * class SomeCmp {\n *   @ViewChild('child') child:ChildCmp;\n *\n *   ngAfterViewInit() {\n *     // child is set\n *     this.child.doSomething();\n *   }\n * }\n * ```\n * @ts2dart_const\n * @stable\n */\nexport class ViewChildMetadata extends ViewQueryMetadata {\n  constructor(_selector: Type|string, {read = null}: {read?: any} = {}) {\n    super(_selector, {descendants: true, first: true, read: read});\n  }\n}\n\ninterface DecoratorInvocation {\n  type: Function;\n  args?: any[];\n}\n"]}

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

@@ -1,7 +1,8 @@
-import { Type } from '../../src/facade/lang';
+import { AnimationEntryMetadata } from '../animation/metadata';
+import { ChangeDetectionStrategy } from '../change_detection/constants';
 import { InjectableMetadata } from '../di/metadata';
+import { Type } from '../facade/lang';
 import { ViewEncapsulation } from './view';
-import { ChangeDetectionStrategy } from '../change_detection/constants';
 /**
  * Directives allow you to attach behavior to elements in the DOM.
  *
@@ -380,6 +381,7 @@ import { ChangeDetectionStrategy } from '../change_detection/constants';
  * the instantiated
  * view occurs on the second `<li></li>` which is a sibling to the `<template>` element.
  * @ts2dart_const
+ * @stable
  */
 export declare class DirectiveMetadata extends InjectableMetadata {
     /**
@@ -463,6 +465,11 @@ export declare class DirectiveMetadata extends InjectableMetadata {
      *
      */
     readonly inputs: string[];
+    /**
+     * Use `inputs` instead
+     *
+     * @deprecated
+     */
     readonly properties: string[];
     private _inputs;
     private _properties;
@@ -512,6 +519,11 @@ export declare class DirectiveMetadata extends InjectableMetadata {
      *
      */
     readonly outputs: string[];
+    /**
+     * Use `outputs` instead
+     *
+     * @deprecated
+     */
     readonly events: string[];
     private _outputs;
     private _events;
@@ -641,7 +653,7 @@ export declare class DirectiveMetadata extends InjectableMetadata {
      *
      * @Directive({
      *   selector: 'greet',
-     *   bindings: [
+     *   providers: [
      *     Greeter
      *   ]
      * })
@@ -655,10 +667,7 @@ export declare class DirectiveMetadata extends InjectableMetadata {
      * ```
      */
     readonly providers: any[];
-    /** @deprecated */
-    readonly bindings: any[];
     private _providers;
-    private _bindings;
     /**
      * Defines the name that can be used in the template to assign this directive to a variable.
      *
@@ -718,17 +727,16 @@ export declare class DirectiveMetadata extends InjectableMetadata {
     queries: {
         [key: string]: any;
     };
-    constructor({selector, inputs, outputs, properties, events, host, bindings, providers, exportAs, queries}?: {
+    constructor({selector, inputs, outputs, properties, events, host, providers, exportAs, queries}?: {
         selector?: string;
         inputs?: string[];
         outputs?: string[];
-        properties?: string[];
-        events?: string[];
+        /** @deprecated */ properties?: string[];
+        /** @deprecated */ events?: string[];
         host?: {
             [key: string]: string;
         };
         providers?: any[];
-        /** @deprecated */ bindings?: any[];
         exportAs?: string;
         queries?: {
             [key: string]: any;
@@ -761,6 +769,7 @@ export declare class DirectiveMetadata extends InjectableMetadata {
  *
  * {@example core/ts/metadata/metadata.ts region='component'}
  * @ts2dart_const
+ * @stable
  */
 export declare class ComponentMetadata extends DirectiveMetadata {
     /**
@@ -812,14 +821,15 @@ export declare class ComponentMetadata extends DirectiveMetadata {
      * ```
      */
     readonly viewProviders: any[];
-    readonly viewBindings: any[];
     private _viewProviders;
-    private _viewBindings;
     /**
      * The module id of the module that contains the component.
      * Needed to be able to resolve relative urls for templates and styles.
+     * In CommonJS, this can always be set to `module.id`, similarly SystemJS exposes `__moduleName`
+     * variable within each module.
+     *
      * In Dart, this can be determined automatically and does not need to be set.
-     * In CommonJS, this can always be set to `module.id`.
+  
      *
      * ## Simple Example
      *
@@ -838,23 +848,93 @@ export declare class ComponentMetadata extends DirectiveMetadata {
     template: string;
     styleUrls: string[];
     styles: string[];
+    /**
+     * Animations are defined on components via an animation-like DSL. This DSL approach to describing
+     * animations allows for a flexibility that both benefits developers and the framework.
+     *
+     * Animations work by listening on state changes that occur on an element within
+     * the template. When a state change occurs, Angular can then take advantage and animate the
+     * arc in between. This works similar to how CSS transitions work, however, by having a
+     * programmatic DSL, animations are not limited to environments that are DOM-specific.
+     * (Angular can also perform optimizations behind the scenes to make animations more performant.)
+     *
+     * For animations to be available for use, animation state changes are placed within
+     * {@link trigger animation triggers} which are housed inside of the `animations` annotation
+     * metadata. Within a trigger both {@link state state} and {@link transition transition} entries
+     * can be placed.
+     *
+     * ```typescript
+     * @Component({
+     *   selector: 'animation-cmp',
+     *   templateUrl: 'animation-cmp.html',
+     *   animations: [
+     *     // this here is our animation trigger that
+     *     // will contain our state change animations.
+     *     trigger('myTriggerName', [
+     *       // the styles defined for the `on` and `off`
+     *       // states declared below are persisted on the
+     *       // element once the animation completes.
+     *       state('on', style({ opacity: 1 }),
+     *       state('off', style({ opacity: 0 }),
+     *
+     *       // this here is our animation that kicks off when
+     *       // this state change jump is true
+     *       transition('on => off', [
+     *         animate("1s")
+     *       ])
+     *     ])
+     *   ]
+     * })
+     * ```
+     *
+     * As depicted in the code above, a group of related animation states are all contained within
+     * an animation `trigger` (the code example above called the trigger `myTriggerName`).
+     * When a trigger is created then it can be bound onto an element within the component's
+     * template via a property prefixed by an `@` symbol followed by trigger name and an expression
+     * that
+     * is used to determine the state value for that trigger.
+     *
+     * ```html
+     * <!-- animation-cmp.html -->
+     * <div @myTriggerName="expression">...</div>
+     * ```
+     *
+     * For state changes to be executed, the `expression` value must change value from its existing
+     * value
+     * to something that we have set an animation to animate on (in the example above we are listening
+     * to a change of state between `on` and `off`). The `expression` value attached to the trigger
+     * must be something that can be evaluated with the template/component context.
+     *
+     * ### DSL Animation Functions
+     *
+     * Please visit each of the animation DSL functions listed below to gain a better understanding
+     * of how and why they are used for crafting animations in Angular2:
+     *
+     * - {@link trigger trigger()}
+     * - {@link state state()}
+     * - {@link transition transition()}
+     * - {@link group group()}
+     * - {@link sequence sequence()}
+     * - {@link style style()}
+     * - {@link animate animate()}
+     * - {@link keyframes keyframes()}
+     */
+    animations: AnimationEntryMetadata[];
     directives: Array<Type | any[]>;
     pipes: Array<Type | any[]>;
     encapsulation: ViewEncapsulation;
-    constructor({selector, inputs, outputs, properties, events, host, exportAs, moduleId, bindings, providers, viewBindings, viewProviders, changeDetection, queries, templateUrl, template, styleUrls, styles, directives, pipes, encapsulation}?: {
+    constructor({selector, inputs, outputs, properties, events, host, exportAs, moduleId, providers, viewProviders, changeDetection, queries, templateUrl, template, styleUrls, styles, animations, directives, pipes, encapsulation}?: {
         selector?: string;
         inputs?: string[];
         outputs?: string[];
-        properties?: string[];
-        events?: string[];
+        /** @deprecated */ properties?: string[];
+        /** @deprecated */ events?: string[];
         host?: {
             [key: string]: string;
         };
-        /** @deprecated */ bindings?: any[];
         providers?: any[];
         exportAs?: string;
         moduleId?: string;
-        /** @deprecated */ viewBindings?: any[];
         viewProviders?: any[];
         queries?: {
             [key: string]: any;
@@ -864,6 +944,7 @@ export declare class ComponentMetadata extends DirectiveMetadata {
         template?: string;
         styleUrls?: string[];
         styles?: string[];
+        animations?: AnimationEntryMetadata[];
         directives?: Array<Type | any[]>;
         pipes?: Array<Type | any[]>;
         encapsulation?: ViewEncapsulation;
@@ -880,11 +961,10 @@ export declare class ComponentMetadata extends DirectiveMetadata {
  *
  * {@example core/ts/metadata/metadata.ts region='pipe'}
  * @ts2dart_const
+ * @stable
  */
 export declare class PipeMetadata extends InjectableMetadata {
     name: string;
-    /** @internal */
-    _pure: boolean;
     constructor({name, pure}: {
         name: string;
         pure?: boolean;
@@ -932,6 +1012,7 @@ export declare class PipeMetadata extends InjectableMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class InputMetadata {
     /**
@@ -985,6 +1066,7 @@ export declare class InputMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class OutputMetadata {
     bindingPropertyName: string;
@@ -1025,6 +1107,7 @@ export declare class OutputMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class HostBindingMetadata {
     hostPropertyName: string;
@@ -1064,6 +1147,7 @@ export declare class HostBindingMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export declare class HostListenerMetadata {
     eventName: string;

package/esm/src/metadata/directives.js

@@ -1,6 +1,6 @@
-import { isPresent } from '../../src/facade/lang';
-import { InjectableMetadata } from '../di/metadata';
 import { ChangeDetectionStrategy } from '../change_detection/constants';
+import { InjectableMetadata } from '../di/metadata';
+import { isPresent } from '../facade/lang';
 /**
  * Directives allow you to attach behavior to elements in the DOM.
  *
@@ -379,9 +379,10 @@ import { ChangeDetectionStrategy } from '../change_detection/constants';
  * the instantiated
  * view occurs on the second `<li></li>` which is a sibling to the `<template>` element.
  * @ts2dart_const
+ * @stable
  */
 export class DirectiveMetadata extends InjectableMetadata {
-    constructor({ selector, inputs, outputs, properties, events, host, bindings, providers, exportAs, queries } = {}) {
+    constructor({ selector, inputs, outputs, properties, events, host, providers, exportAs, queries } = {}) {
         super();
         this.selector = selector;
         this._inputs = inputs;
@@ -392,7 +393,6 @@ export class DirectiveMetadata extends InjectableMetadata {
         this.exportAs = exportAs;
         this.queries = queries;
         this._providers = providers;
-        this._bindings = bindings;
     }
     /**
      * Enumerates the set of data-bound input properties for a directive
@@ -445,6 +445,11 @@ export class DirectiveMetadata extends InjectableMetadata {
         return isPresent(this._properties) && this._properties.length > 0 ? this._properties :
             this._inputs;
     }
+    /**
+     * Use `inputs` instead
+     *
+     * @deprecated
+     */
     get properties() { return this.inputs; }
     /**
      * Enumerates the set of event-bound output properties.
@@ -494,6 +499,11 @@ export class DirectiveMetadata extends InjectableMetadata {
     get outputs() {
         return isPresent(this._events) && this._events.length > 0 ? this._events : this._outputs;
     }
+    /**
+     * Use `outputs` instead
+     *
+     * @deprecated
+     */
     get events() { return this.outputs; }
     /**
      * Defines the set of injectable objects that are visible to a Directive and its light DOM
@@ -512,7 +522,7 @@ export class DirectiveMetadata extends InjectableMetadata {
      *
      * @Directive({
      *   selector: 'greet',
-     *   bindings: [
+     *   providers: [
      *     Greeter
      *   ]
      * })
@@ -525,12 +535,7 @@ export class DirectiveMetadata extends InjectableMetadata {
      * }
      * ```
      */
-    get providers() {
-        return isPresent(this._bindings) && this._bindings.length > 0 ? this._bindings :
-            this._providers;
-    }
-    /** @deprecated */
-    get bindings() { return this.providers; }
+    get providers() { return this._providers; }
 }
 /**
  * Declare reusable UI building blocks for an application.
@@ -558,9 +563,10 @@ export class DirectiveMetadata extends InjectableMetadata {
  *
  * {@example core/ts/metadata/metadata.ts region='component'}
  * @ts2dart_const
+ * @stable
  */
 export class ComponentMetadata extends DirectiveMetadata {
-    constructor({ selector, inputs, outputs, properties, events, host, exportAs, moduleId, bindings, providers, viewBindings, viewProviders, changeDetection = ChangeDetectionStrategy.Default, queries, templateUrl, template, styleUrls, styles, directives, pipes, encapsulation } = {}) {
+    constructor({ selector, inputs, outputs, properties, events, host, exportAs, moduleId, providers, viewProviders, changeDetection = ChangeDetectionStrategy.Default, queries, templateUrl, template, styleUrls, styles, animations, directives, pipes, encapsulation } = {}) {
         super({
             selector: selector,
             inputs: inputs,
@@ -569,13 +575,11 @@ export class ComponentMetadata extends DirectiveMetadata {
             events: events,
             host: host,
             exportAs: exportAs,
-            bindings: bindings,
             providers: providers,
             queries: queries
         });
         this.changeDetection = changeDetection;
         this._viewProviders = viewProviders;
-        this._viewBindings = viewBindings;
         this.templateUrl = templateUrl;
         this.template = template;
         this.styleUrls = styleUrls;
@@ -584,6 +588,7 @@ export class ComponentMetadata extends DirectiveMetadata {
         this.pipes = pipes;
         this.encapsulation = encapsulation;
         this.moduleId = moduleId;
+        this.animations = animations;
     }
     /**
      * Defines the set of injectable objects that are visible to its view DOM children.
@@ -623,11 +628,7 @@ export class ComponentMetadata extends DirectiveMetadata {
      *
      * ```
      */
-    get viewProviders() {
-        return isPresent(this._viewBindings) && this._viewBindings.length > 0 ? this._viewBindings :
-            this._viewProviders;
-    }
-    get viewBindings() { return this.viewProviders; }
+    get viewProviders() { return this._viewProviders; }
 }
 /**
  * Declare reusable pipe function.
@@ -640,6 +641,7 @@ export class ComponentMetadata extends DirectiveMetadata {
  *
  * {@example core/ts/metadata/metadata.ts region='pipe'}
  * @ts2dart_const
+ * @stable
  */
 export class PipeMetadata extends InjectableMetadata {
     constructor({ name, pure }) {
@@ -690,6 +692,7 @@ export class PipeMetadata extends InjectableMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class InputMetadata {
     constructor(
@@ -741,6 +744,7 @@ export class InputMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class OutputMetadata {
     constructor(bindingPropertyName) {
@@ -782,6 +786,7 @@ export class OutputMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class HostBindingMetadata {
     constructor(hostPropertyName) {
@@ -822,6 +827,7 @@ export class HostBindingMetadata {
  * bootstrap(App);
  * ```
  * @ts2dart_const
+ * @stable
  */
 export class HostListenerMetadata {
     constructor(eventName, args) {