Add CI workflow for validating C++ API snapshot (#56042)

Summary:

Adds CI workflow for validating whether the current C++ API snapshot is equivalent with the generated one.

Differential Revision: D95963515

Author: coado

.github/workflows/validate-cxx-api-snapshots.yml

@@ -0,0 +1,46 @@
+name: Validate C++ API Snapshots
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - "packages/react-native/ReactCommon/**"
+      - "packages/react-native/ReactAndroid/**"
+      - "packages/react-native/React/**"
+      - "packages/react-native/ReactApple/**"
+      - "scripts/cxx-api/**"
+  push:
+    branches:
+      - main
+      - "*-stable"
+    paths:
+      - "packages/react-native/ReactCommon/**"
+      - "packages/react-native/ReactAndroid/**"
+      - "packages/react-native/React/**"
+      - "packages/react-native/ReactApple/**"
+      - "scripts/cxx-api/**"
+
+jobs:
+  validate_cxx_api_snapshots:
+    runs-on: ubuntu-latest
+    if: github.repository == 'facebook/react-native'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      - name: Install Doxygen
+        shell: bash
+        run: sudo apt-get update && sudo apt-get install -y doxygen
+      - name: Setup node.js
+        uses: ./.github/actions/setup-node
+      - name: Run yarn
+        uses: ./.github/actions/yarn-install
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install Python dependencies
+        shell: bash
+        run: pip install doxmlparser natsort pyyaml
+      - name: Validate C++ API snapshots
+        shell: bash
+        run: python -m scripts.cxx-api.parser --check

packages/react-native/React/Views/ScrollView/RCTScrollableProtocol.h

@@ -43,6 +43,6 @@
 
 @end
 
-__attribute__((deprecated("Use RCTCustomRefreshControlProtocol instead")))
-@protocol RCTCustomRefreshContolProtocol<RCTCustomRefreshControlProtocol>
-@end
+// __attribute__((deprecated("Use RCTCustomRefreshControlProtocol instead")))
+// @protocol RCTCustomRefreshContolProtocol<RCTCustomRefreshControlProtocol>
+// @end

scripts/cxx-api/api-snapshots/ReactAndroidDebugCxx.api

@@ -110,6 +110,8 @@ def build_snapshot_for_view(
     verbose: bool = True,
     input_filter: str = None,
 ) -> None:
+    print(f"Generating API view: {api_view}")
+
     # If there is already an output directory, delete it
     if os.path.exists(os.path.join(react_native_dir, "api")):
         if verbose: