create UIManagerAnimationBackend to replace forward declare class AnimationBackend (#54058)

Summary:
Pull Request resolved: #54058

## Changelog:

[Internal] [Changed] - create UIManagerAnimationBackend to replace forward declare `class AnimationBackend`

for other delegates in UIManager, we usually explicitly create an interface in UIManager package with the public APIs we want to expose, we can follow that pattern here, so we avoid the forward declaration without definition situation, and decoupling UIManager with AnimationBackend

also this way, in the future, animation runtimes that consume AnimationBackend can just include `UIManagerAnimationBackend` (where we expose all of public APIs of AnimationBackend) and remain somewhat decoupled too

Reviewed By: sammy-SC

Differential Revision: D83679693

fbshipit-source-id: e58d180b7d36a3f0e766c2914b16128346abe070

Author: zeyap

packages/react-native/ReactCommon/react/renderer/animated/NativeAnimatedNodesManager.cpp

@@ -33,6 +33,7 @@
 #include <react/renderer/animated/nodes/TrackingAnimatedNode.h>
 #include <react/renderer/animated/nodes/TransformAnimatedNode.h>
 #include <react/renderer/animated/nodes/ValueAnimatedNode.h>
+#include <react/renderer/animationbackend/AnimatedPropsBuilder.h>
 #include <react/renderer/core/EventEmitter.h>
 
 namespace facebook::react {
@@ -92,7 +93,7 @@ NativeAnimatedNodesManager::NativeAnimatedNodesManager(
 }
 
 NativeAnimatedNodesManager::NativeAnimatedNodesManager(
-    std::shared_ptr<AnimationBackend> animationBackend) noexcept
+    std::shared_ptr<UIManagerAnimationBackend> animationBackend) noexcept
     : animationBackend_(std::move(animationBackend)) {}
 
 NativeAnimatedNodesManager::~NativeAnimatedNodesManager() noexcept {
@@ -514,8 +515,12 @@ NativeAnimatedNodesManager::ensureEventEmitterListener() noexcept {
 
 void NativeAnimatedNodesManager::startRenderCallbackIfNeeded() {
   if (ReactNativeFeatureFlags::useSharedAnimatedBackend()) {
-    animationBackend_->start(
-        [this](float /*f*/) { return pullAnimationMutations(); });
+    if (auto animationBackend =
+            std::static_pointer_cast<AnimationBackend>(animationBackend_)) {
+      animationBackend->start(
+          [this](float /*f*/) { return pullAnimationMutations(); });
+    }
+
     return;
   }
   // This method can be called from either the UI thread or JavaScript thread.

packages/react-native/ReactCommon/react/renderer/animated/NativeAnimatedNodesManager.h

@@ -19,6 +19,7 @@
 #include <react/renderer/animated/event_drivers/EventAnimationDriver.h>
 #include <react/renderer/animationbackend/AnimationBackend.h>
 #include <react/renderer/core/ReactPrimitives.h>
+#include <react/renderer/uimanager/UIManagerAnimationBackend.h>
 #include <chrono>
 #include <memory>
 #include <mutex>
@@ -68,7 +69,7 @@ class NativeAnimatedNodesManager {
       StopOnRenderCallback&& stopOnRenderCallback = nullptr) noexcept;
 
   explicit NativeAnimatedNodesManager(
-      std::shared_ptr<AnimationBackend> animationBackend) noexcept;
+      std::shared_ptr<UIManagerAnimationBackend> animationBackend) noexcept;
 
   ~NativeAnimatedNodesManager() noexcept;
 
@@ -212,7 +213,7 @@ class NativeAnimatedNodesManager {
       const std::string& eventName,
       const EventPayload& payload) noexcept;
 
-  std::shared_ptr<AnimationBackend> animationBackend_;
+  std::shared_ptr<UIManagerAnimationBackend> animationBackend_;
 
   std::unique_ptr<AnimatedNode> animatedNode(
       Tag tag,

packages/react-native/ReactCommon/react/renderer/animated/NativeAnimatedNodesManagerProvider.h

@@ -46,7 +46,7 @@ class NativeAnimatedNodesManagerProvider {
   std::shared_ptr<EventEmitterListener> getEventEmitterListener();
 
  private:
-  std::shared_ptr<AnimationBackend> animationBackend_;
+  std::shared_ptr<UIManagerAnimationBackend> animationBackend_;
   std::shared_ptr<NativeAnimatedNodesManager> nativeAnimatedNodesManager_;
 
   std::shared_ptr<EventEmitterListenerContainer> eventEmitterListenerContainer_;

packages/react-native/ReactCommon/react/renderer/animationbackend/AnimationBackend.h

@@ -10,6 +10,7 @@
 #include <folly/dynamic.h>
 #include <react/renderer/core/ReactPrimitives.h>
 #include <react/renderer/uimanager/UIManager.h>
+#include <react/renderer/uimanager/UIManagerAnimationBackend.h>
 #include <functional>
 #include <vector>
 #include "AnimatedProps.h"
@@ -25,7 +26,7 @@ struct AnimationMutation {
 
 using AnimationMutations = std::vector<AnimationMutation>;
 
-class AnimationBackend {
+class AnimationBackend : public UIManagerAnimationBackend {
  public:
   using Callback = std::function<AnimationMutations(float)>;
   using StartOnRenderCallback = std::function<void(std::function<void()>&&)>;
@@ -54,8 +55,8 @@ class AnimationBackend {
   void synchronouslyUpdateProps(
       const std::unordered_map<Tag, AnimatedProps>& updates);
 
-  void onAnimationFrame(double timestamp);
+  void onAnimationFrame(double timestamp) override;
   void start(const Callback& callback);
-  void stop();
+  void stop() override;
 };
 } // namespace facebook::react

packages/react-native/ReactCommon/react/renderer/uimanager/UIManager.cpp

@@ -681,11 +681,12 @@ void UIManager::setNativeAnimatedDelegate(
 }
 
 void UIManager::unstable_setAnimationBackend(
-    std::weak_ptr<AnimationBackend> animationBackend) {
+    std::weak_ptr<UIManagerAnimationBackend> animationBackend) {
   animationBackend_ = animationBackend;
 }
 
-std::weak_ptr<AnimationBackend> UIManager::unstable_getAnimationBackend() {
+std::weak_ptr<UIManagerAnimationBackend>
+UIManager::unstable_getAnimationBackend() {
   return animationBackend_;
 }
 

packages/react-native/ReactCommon/react/renderer/uimanager/UIManager.h

@@ -23,6 +23,7 @@
 #include <react/renderer/mounting/ShadowTree.h>
 #include <react/renderer/mounting/ShadowTreeDelegate.h>
 #include <react/renderer/mounting/ShadowTreeRegistry.h>
+#include <react/renderer/uimanager/UIManagerAnimationBackend.h>
 #include <react/renderer/uimanager/UIManagerAnimationDelegate.h>
 #include <react/renderer/uimanager/UIManagerDelegate.h>
 #include <react/renderer/uimanager/UIManagerNativeAnimatedDelegate.h>
@@ -36,7 +37,6 @@ namespace facebook::react {
 class UIManagerBinding;
 class UIManagerCommitHook;
 class UIManagerMountHook;
-class AnimationBackend;
 
 class UIManager final : public ShadowTreeDelegate {
  public:
@@ -63,9 +63,13 @@ class UIManager final : public ShadowTreeDelegate {
    * the pointer before being destroyed.
    */
   void setAnimationDelegate(UIManagerAnimationDelegate* delegate);
+
+  /**
+   * Sets and gets UIManager's AnimationBackend reference.
+   */
   void unstable_setAnimationBackend(
-      std::weak_ptr<AnimationBackend> animationBackend);
-  std::weak_ptr<AnimationBackend> unstable_getAnimationBackend();
+      std::weak_ptr<UIManagerAnimationBackend> animationBackend);
+  std::weak_ptr<UIManagerAnimationBackend> unstable_getAnimationBackend();
 
   /**
    * Execute stopSurface on any UIMAnagerAnimationDelegate.
@@ -263,7 +267,7 @@ class UIManager final : public ShadowTreeDelegate {
   std::unique_ptr<LazyShadowTreeRevisionConsistencyManager>
       lazyShadowTreeRevisionConsistencyManager_;
 
-  std::weak_ptr<AnimationBackend> animationBackend_;
+  std::weak_ptr<UIManagerAnimationBackend> animationBackend_;
 };
 
 } // namespace facebook::react

packages/react-native/ReactCommon/react/renderer/uimanager/UIManagerAnimationBackend.h

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#pragma once
+
+#include <react/renderer/components/view/BaseViewProps.h>
+#include <react/renderer/core/ShadowNodeFamily.h>
+
+namespace facebook::react {
+
+class UIManagerAnimationBackend {
+ public:
+  virtual ~UIManagerAnimationBackend() = default;
+
+  virtual void onAnimationFrame(double timestamp) = 0;
+  // TODO: T240293839 Move over start() function and mutation types
+  virtual void stop() = 0;
+};
+
+} // namespace facebook::react