Add umbrella for react/renderer/uimanager subtree (#58025)

Summary:
Pull Request resolved: #58025

Rolls the umbrella-header + include-guard mechanism across the
`react/renderer/uimanager` module, classifying the target as public.

- Adds `<React/UIManager.h>`, re-exporting the module's public interface headers.
- Adds `<react/cxxstableapi/UmbrellaGuard.h>` to the module's public headers.
- Wires the umbrella header directory into the Buck, CMake, CocoaPods, Gradle,
  and iOS prebuild header configurations.
- Deprecated `SurfaceRegistryBinding.h` does not include umbrella guard because it will fail anyway when included directly (it includes AppRegistryBinding that does include guard).

React Native's own sources keep using the fine-grained
`<react/renderer/uimanager/...>` includes; only outside consumers use the
umbrella.

Changelog: [Internal]

Reviewed By: cipolleschi

Differential Revision: D116763079

fbshipit-source-id: 8994e01d782d0a16677e244f42f573a1583abdda

Author: coado

packages/react-native/ReactAndroid/build.gradle.kts

@@ -160,6 +160,7 @@ val preparePrefab by
                       Pair("../ReactCommon/react/renderer/scheduler/", "react/renderer/scheduler/"),
                       // react_renderer_uimanager
                       Pair("../ReactCommon/react/renderer/uimanager/", "react/renderer/uimanager/"),
+                      Pair("../ReactCommon/react/renderer/uimanager/React/", "React/"),
                       // react_utils
                       Pair("../ReactCommon/react/utils/", "react/utils/"),
                       // rrc_image

packages/react-native/ReactCommon/React-Fabric.podspec

@@ -250,6 +250,12 @@ Pod::Spec.new do |s|
     ss.header_dir           = "react/renderer/uimanager"
   end
 
+  s.subspec "uimanagerUmbrella" do |ss|
+    ss.source_files         = "react/renderer/uimanager/React/*.h"
+    ss.header_dir           = "React"
+    ss.header_mappings_dir  = "react/renderer/uimanager/React"
+  end
+
   s.subspec "leakchecker" do |ss|
     ss.source_files         = podspec_sources("react/renderer/leakchecker/**/*.{cpp,h}", "react/renderer/leakchecker/**/*.h")
     ss.exclude_files        = "react/renderer/leakchecker/tests"

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

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

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

@@ -18,6 +18,7 @@ target_link_libraries(react_renderer_uimanager
         folly_runtime
         jsi
         react_cxxreact
+        react_cxxstableapi
         react_debug
         react_featureflags
         react_renderer_componentregistry

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/UmbrellaGuard.h>
+
 namespace facebook::react {
 
 class LayoutAnimationStatusDelegate {

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/UmbrellaGuard.h>
+
 #include <react/renderer/uimanager/UIManagerCommitHook.h>
 
 namespace facebook::react {

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/UmbrellaGuard.h>
+
 #include <functional>
 
 #include <jsi/jsi.h>

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/UmbrellaGuard.h>
+
 #include <functional>
 #include <initializer_list>
 #include <memory>

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

@@ -0,0 +1,41 @@
+/*
+ * 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
+
+// =============================================================================
+// Umbrella header for the `react/renderer/uimanager` module - public entry
+// point.
+//
+//   #include <React/UIManager.h>
+//
+// Re-exports the module's public interface headers. React Native's own code
+// should keep using the fine-grained `<react/renderer/uimanager/...>` includes;
+// only outside consumers use this umbrella.
+// =============================================================================
+
+// Marks that the following headers are pulled in through the umbrella, so their
+// shared guard (<react/cxxstableapi/UmbrellaGuard.h>) accepts them.
+#define RN_UMBRELLA_CONTEXT
+
+#include <react/renderer/uimanager/AppRegistryBinding.h>
+#include <react/renderer/uimanager/LayoutAnimationStatusDelegate.h>
+#include <react/renderer/uimanager/LayoutEventEmitter.h>
+#include <react/renderer/uimanager/PointerEventsProcessor.h>
+#include <react/renderer/uimanager/PointerHoverTracker.h>
+#include <react/renderer/uimanager/UIManager.h>
+#include <react/renderer/uimanager/UIManagerAnimationBackend.h>
+#include <react/renderer/uimanager/UIManagerAnimationDelegate.h>
+#include <react/renderer/uimanager/UIManagerBinding.h>
+#include <react/renderer/uimanager/UIManagerCommitHook.h>
+#include <react/renderer/uimanager/UIManagerDelegate.h>
+#include <react/renderer/uimanager/UIManagerMountHook.h>
+#include <react/renderer/uimanager/UIManagerNativeAnimatedDelegate.h>
+#include <react/renderer/uimanager/UIManagerViewTransitionDelegate.h>
+#include <react/renderer/uimanager/primitives.h>
+
+#undef RN_UMBRELLA_CONTEXT

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

@@ -7,6 +7,8 @@
 
 #pragma once
 
+#include <react/cxxstableapi/UmbrellaGuard.h>
+
 #include <folly/dynamic.h>
 #include <jsi/jsi.h>