feat(core): introduce support for animations

Closes #8734

tools/public_api_guard/public_api_spec.ts

@@ -56,6 +56,41 @@ const CORE = [
   'Binding.toClass:any',
   'Binding.toFactory:any',
   'Binding.toValue:any',
+  'AnimationAnimateMetadata',
+  'AnimationAnimateMetadata.constructor(timings:string|number, styles:AnimationStyleMetadata|AnimationKeyframesSequenceMetadata)',
+  'AnimationEntryMetadata',
+  'AnimationEntryMetadata.constructor(name:string, definitions:AnimationStateMetadata[])',
+  'AnimationGroupMetadata',
+  'AnimationGroupMetadata.constructor(_steps:AnimationMetadata[])',
+  'AnimationGroupMetadata.steps:AnimationMetadata[]',
+  'AnimationKeyframesSequenceMetadata',
+  'AnimationKeyframesSequenceMetadata.constructor(steps:AnimationStyleMetadata[])',
+  'AnimationMetadata',
+  'AnimationPlayer',
+  'AnimationPlayer.destroy():void',
+  'AnimationPlayer.finish():void',
+  'AnimationPlayer.getPosition():number',
+  'AnimationPlayer.onDone(fn:Function):void',
+  'AnimationPlayer.parentPlayer:AnimationPlayer',
+  'AnimationPlayer.parentPlayer=(player:AnimationPlayer)',
+  'AnimationPlayer.pause():void',
+  'AnimationPlayer.play():void',
+  'AnimationPlayer.reset():void',
+  'AnimationPlayer.restart():void',
+  'AnimationPlayer.setPosition(p:any):void',
+  'AnimationSequenceMetadata',
+  'AnimationSequenceMetadata.constructor(_steps:AnimationMetadata[])',
+  'AnimationSequenceMetadata.steps:AnimationMetadata[]',
+  'AnimationStateDeclarationMetadata',
+  'AnimationStateDeclarationMetadata.constructor(stateNameExpr:string, styles:AnimationStyleMetadata)',
+  'AnimationStateMetadata',
+  'AnimationStateTransitionMetadata',
+  'AnimationStateTransitionMetadata.constructor(stateChangeExpr:string, animation:AnimationMetadata)',
+  'AnimationStyleMetadata',
+  'AnimationStyleMetadata.constructor(styles:Array<string|{[key:string]:string|number}>, offset:number)',
+  'AnimationWithStepsMetadata',
+  'AnimationWithStepsMetadata.constructor()',
+  'AnimationWithStepsMetadata.steps:AnimationMetadata[]',
   'ChangeDetectionStrategy',
   'ChangeDetectionStrategy.CheckAlways',
   'ChangeDetectionStrategy.Checked',
@@ -79,14 +114,15 @@ const CORE = [
   'CollectionChangeRecord.previousIndex:number',
   'CollectionChangeRecord.toString():string',
   'ComponentDecorator',
-  'ComponentDecorator.View(obj:{templateUrl?:string, template?:string, directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, renderer?:string, styles?:string[], styleUrls?:string[]}):ViewDecorator',
+  'ComponentDecorator.View(obj:{templateUrl?:string, template?:string, directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, renderer?:string, styles?:string[], styleUrls?:string[], animations?:AnimationEntryMetadata[]}):ViewDecorator',
   'ComponentFactory.componentType:Type',
   'ComponentFactory.constructor(selector:string, _viewFactory:Function, _componentType:Type)',
   'ComponentFactory.create(injector:Injector, projectableNodes:any[][], rootSelectorOrNode:string|any):ComponentRef<C>',
   'ComponentFactory<C>',
   'ComponentMetadata',
+  'ComponentMetadata.animations:AnimationEntryMetadata[]',
   'ComponentMetadata.changeDetection:ChangeDetectionStrategy',
-  'ComponentMetadata.constructor({selector,inputs,outputs,properties,events,host,exportAs,moduleId,providers,viewProviders,changeDetection=ChangeDetectionStrategy.Default,queries,templateUrl,template,styleUrls,styles,directives,pipes,encapsulation}:{selector?:string, inputs?:string[], outputs?:string[], properties?:string[], events?:string[], host?:{[key:string]:string}, providers?:any[], exportAs?:string, moduleId?:string, viewProviders?:any[], queries?:{[key:string]:any}, changeDetection?:ChangeDetectionStrategy, templateUrl?:string, template?:string, styleUrls?:string[], styles?:string[], directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, encapsulation?:ViewEncapsulation})',
+  'ComponentMetadata.constructor({selector,inputs,outputs,properties,events,host,exportAs,moduleId,providers,viewProviders,changeDetection=ChangeDetectionStrategy.Default,queries,templateUrl,template,styleUrls,styles,animations,directives,pipes,encapsulation}:{selector?:string, inputs?:string[], outputs?:string[], properties?:string[], events?:string[], host?:{[key:string]:string}, providers?:any[], exportAs?:string, moduleId?:string, viewProviders?:any[], queries?:{[key:string]:any}, changeDetection?:ChangeDetectionStrategy, templateUrl?:string, template?:string, styleUrls?:string[], styles?:string[], animations?:AnimationEntryMetadata[], directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, encapsulation?:ViewEncapsulation})',
   'ComponentMetadata.directives:Array<Type|any[]>',
   'ComponentMetadata.encapsulation:ViewEncapsulation',
   'ComponentMetadata.moduleId:string',
@@ -416,6 +452,7 @@ const CORE = [
   'RenderComponentType',
   'RenderComponentType.constructor(id:string, templateUrl:string, slotCount:number, encapsulation:ViewEncapsulation, styles:Array<string|any[]>)',
   'Renderer',
+  'Renderer.animate(element:any, startingStyles:AnimationStyles, keyframes:AnimationKeyframe[], duration:number, delay:number, easing:string):AnimationPlayer',
   'Renderer.attachViewAfter(node:any, viewRootNodes:any[]):void',
   'Renderer.createElement(parentElement:any, name:string, debugInfo:RenderDebugInfo):any',
   'Renderer.createTemplateAnchor(parentElement:any, debugInfo:RenderDebugInfo):any',
@@ -530,13 +567,14 @@ const CORE = [
   'ViewContainerRef.parentInjector:Injector',
   'ViewContainerRef.remove(index:number):void',
   'ViewDecorator',
-  'ViewDecorator.View(obj:{templateUrl?:string, template?:string, directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, renderer?:string, styles?:string[], styleUrls?:string[]}):ViewDecorator',
+  'ViewDecorator.View(obj:{templateUrl?:string, template?:string, directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, renderer?:string, styles?:string[], styleUrls?:string[], animations?:AnimationEntryMetadata[]}):ViewDecorator',
   'ViewEncapsulation',
   'ViewEncapsulation.Emulated',
   'ViewEncapsulation.Native',
   'ViewEncapsulation.None',
   'ViewMetadata',
-  'ViewMetadata.constructor({templateUrl,template,directives,pipes,encapsulation,styles,styleUrls}:{templateUrl?:string, template?:string, directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, encapsulation?:ViewEncapsulation, styles?:string[], styleUrls?:string[]})',
+  'ViewMetadata.animations:AnimationEntryMetadata[]',
+  'ViewMetadata.constructor({templateUrl,template,directives,pipes,encapsulation,styles,styleUrls,animations}:{templateUrl?:string, template?:string, directives?:Array<Type|any[]>, pipes?:Array<Type|any[]>, encapsulation?:ViewEncapsulation, styles?:string[], styleUrls?:string[], animations?:AnimationEntryMetadata[]})',
   'ViewMetadata.directives:Array<Type|any[]>',
   'ViewMetadata.encapsulation:ViewEncapsulation',
   'ViewMetadata.pipes:Array<Type|any[]>',
@@ -564,7 +602,16 @@ const CORE = [
   'WrappedValue',
   'WrappedValue.constructor(wrapped:any)',
   'WrappedValue.wrap(value:any):WrappedValue',
-  'WtfScopeFn'
+  'WtfScopeFn',
+  'animate(timing:string|number, styles:AnimationStyleMetadata|AnimationKeyframesSequenceMetadata):AnimationAnimateMetadata',
+  'const AUTO_STYLE:any',
+  'group(steps:AnimationMetadata[]):AnimationGroupMetadata',
+  'keyframes(steps:AnimationStyleMetadata|AnimationStyleMetadata[]):AnimationKeyframesSequenceMetadata',
+  'sequence(steps:AnimationMetadata[]):AnimationSequenceMetadata',
+  'state(stateNameExpr:string, styles:AnimationStyleMetadata):AnimationStateDeclarationMetadata',
+  'style(tokens:string|{[key:string]:string|number}|Array<string|{[key:string]:string|number}>):AnimationStyleMetadata',
+  'transition(stateChangeExpr:string, animationData:AnimationMetadata|AnimationMetadata[]):AnimationStateTransitionMetadata',
+  'trigger(name:string, animation:AnimationMetadata|AnimationMetadata[]):AnimationEntryMetadata'
 ];
 
 const COMMON = [
@@ -1030,7 +1077,8 @@ const COMPILER = [
   'CompilerConfig.constructor(genDebugInfo:boolean, logBindingUpdate:boolean, useJit:boolean, renderTypes:RenderTypes)',
   'CompilerConfig.renderTypes:RenderTypes',
   'CompileTemplateMetadata',
-  'CompileTemplateMetadata.constructor({encapsulation,template,templateUrl,styles,styleUrls,ngContentSelectors}:{encapsulation?:ViewEncapsulation, template?:string, templateUrl?:string, styles?:string[], styleUrls?:string[], ngContentSelectors?:string[]})',
+  'CompileTemplateMetadata.animations:CompileAnimationEntryMetadata[]',
+  'CompileTemplateMetadata.constructor({encapsulation,template,templateUrl,styles,styleUrls,animations,ngContentSelectors}:{encapsulation?:ViewEncapsulation, template?:string, templateUrl?:string, styles?:string[], styleUrls?:string[], ngContentSelectors?:string[], animations?:CompileAnimationEntryMetadata[]})',
   'CompileTemplateMetadata.encapsulation:ViewEncapsulation',
   'CompileTemplateMetadata.fromJson(data:{[key:string]:any}):CompileTemplateMetadata',
   'CompileTemplateMetadata.ngContentSelectors:string[]',
@@ -1096,6 +1144,7 @@ const COMPILER = [
   'PipeResolver.constructor(_reflector:ReflectorReader)',
   'PipeResolver.resolve(type:Type):PipeMetadata',
   'PropertyBindingType',
+  'PropertyBindingType.Animation',
   'PropertyBindingType.Attribute',
   'PropertyBindingType.Class',
   'PropertyBindingType.Property',