refactor(core): deprecate animations field on component interface (#62895)

thePunderWoman · thePunderWoman · commit 320de4e96d25 · 2025-07-30T10:35:29.000Z
This deprecates the animations field on the component decorator in favor of animate.enter and leave. DEPRECATED: @angular/animations PR Close #62895
diff --git a/goldens/public-api/core/index.api.md b/goldens/public-api/core/index.api.md
@@ -266,6 +266,7 @@ export type CompilerOptions = {
 
 // @public
 export interface Component extends Directive {
+    // @deprecated
     animations?: any[];
     changeDetection?: ChangeDetectionStrategy;
     encapsulation?: ViewEncapsulation;
diff --git a/packages/core/src/metadata/directives.ts b/packages/core/src/metadata/directives.ts
@@ -604,6 +604,7 @@ export interface Component extends Directive {
    * [`state()`](api/animations/state) and `transition()` definitions.
    * See the [Animations guide](guide/animations) and animations API documentation.
    *
+   * @deprecated 20.2 Use `animate.enter` or `animate.leave` instead. Intent to remove in v23
    */
   animations?: any[];
 

Original file line number	Diff line number	Diff line change
`@@ -604,6 +604,7 @@ export interface Component extends Directive {`
`604`	`604`	* [`state()`](api/animations/state) and `transition()` definitions.
`605`	`605`	`* See the [Animations guide](guide/animations) and animations API documentation.`
`606`	`606`	`*`
	`607`	+ * @deprecated 20.2 Use `animate.enter` or `animate.leave` instead. Intent to remove in v23
`607`	`608`	`*/`
`608`	`609`	`animations?: any[];`
`609`	`610`