Cover react/renderer/animated with guards (#58269)

Summary:
Pull Request resolved: #58269

Classifies `react/renderer/animated:animated` as a "for frameworks" target under the C++ stable API three-tier visibility model. Adds `#include <react/cxxstableapi/FrameworksGuard.h>` to the module's 30 non-test headers, and wires the guard dependency into BUCK and CMake. No CocoaPods change is needed: the module ships as a subspec of `React-Fabric`, whose parent spec already declares `React-cxxstableapi` and calls `mark_as_react_native_build`.

Consumers that opt into `RN_STRICT_API` now get a warning if they include these headers directly, which they can acknowledge with `RN_ALLOW_FRAMEWORKS`; without that flag the guards are inert, so no existing build changes behaviour.

Changelog: [Internal]

Reviewed By: christophpurrer

Differential Revision: D118256232

fbshipit-source-id: 5ec898e99858980ff1e69a4a1eac6515740d06f1

Author: j-piasecki

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 #if __has_include("FBReactNativeSpecJSI.h") // CocoaPod headers on Apple
 #include "FBReactNativeSpecJSI.h"
 #else

packages/react-native/ReactCommon/react/renderer/animated/CMakeLists.txt

@@ -20,6 +20,7 @@ target_include_directories(react_renderer_animated PUBLIC ${REACT_COMMON_DIR})
 
 target_link_libraries(react_renderer_animated
       react_codegen_rncore
+      react_cxxstableapi
       react_debug
       react_renderer_core
       react_renderer_graphics

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 #include <mutex>
 #include <shared_mutex>
 

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 #include <folly/dynamic.h>
 #include <react/renderer/core/ReactPrimitives.h>
 #include <functional>

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 #if __has_include("FBReactNativeSpecJSI.h") // CocoaPod headers on Apple
 #include "FBReactNativeSpecJSI.h"
 #else

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 #include <react/renderer/animated/MergedValueDispatcher.h>
 #include <react/renderer/uimanager/UIManagerNativeAnimatedDelegate.h>
 #include "NativeAnimatedNodesManager.h"

packages/react-native/ReactCommon/react/renderer/animated/drivers/AnimationDriver.h

@@ -5,6 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 /*
  * Adapted from react-native-windows under the MIT license.
  */

packages/react-native/ReactCommon/react/renderer/animated/drivers/AnimationDriverUtils.h

@@ -5,6 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 /*
  * Adapted from react-native-windows under the MIT license.
  */

packages/react-native/ReactCommon/react/renderer/animated/drivers/DecayAnimationDriver.h

@@ -5,6 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 /*
  * Adapted from react-native-windows under the MIT license.
  */

packages/react-native/ReactCommon/react/renderer/animated/drivers/FrameAnimationDriver.h

@@ -5,6 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+#include <react/cxxstableapi/FrameworksGuard.h>
+
 /*
  * Adapted from react-native-windows under the MIT license.
  */