Split of "[RN][C++ Stable API] Add template normalizing"

Author: Dawid Małecki

scripts/cxx-api/parser/builders.py

@@ -26,12 +26,7 @@
     TypedefMember,
     VariableMember,
 )
-from .scope import (
-    CategoryScopeKind,
-    InterfaceScopeKind,
-    ProtocolScopeKind,
-    StructLikeScopeKind,
-)
+from .scope import InterfaceScopeKind, ProtocolScopeKind, StructLikeScopeKind
 from .snapshot import Snapshot
 from .template import Template
 from .utils import (
@@ -358,6 +353,17 @@ def get_property_member(
 # Scope creation
 ######################
 
+# Interfaces to skip due to Doxygen misparsing issues.
+# These produce malformed XML that cannot be reliably reconstructed.
+SKIP_INTERFACES = {
+    # Doxygen misparses Objective-C lightweight generics like @interface Foo<T> : NSObject.
+    # It places <T> in the base class list and corrupts subsequent declarations.
+    "RCTGenericDelegateSplitter",
+    # Multi-line interface declarations cause Doxygen to misparse inheritance.
+    # @interface Foo\n    : Bar <Protocol> results in __pad0__ and lost base classes.
+    "RCTScrollViewComponentView",
+}
+
 
 def create_enum_scope(snapshot: Snapshot, enum_def: compound.EnumdefType) -> None:
     """
@@ -469,6 +475,9 @@ def create_interface_scope(
     """
     interface_name = scope_def.compoundname
 
+    if interface_name in SKIP_INTERFACES:
+        return
+
     interface_scope = snapshot.create_interface(interface_name)
     base_classes = get_base_classes(scope_def, base_class=InterfaceScopeKind.Base)
     interface_scope.kind.add_base(base_classes)

scripts/cxx-api/tests/snapshots/should_handle_interface_with_generics/snapshot.api

@@ -0,0 +1 @@
+

scripts/cxx-api/tests/snapshots/should_handle_interface_with_generics/test.h

@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * Test case for Objective-C interface with generic type parameters.
+ *
+ * Doxygen 1.11.0 misparses Objective-C lightweight generics, placing
+ * <DelegateT> in the base class list and corrupting subsequent declarations.
+ *
+ * This interface is SKIPPED in the parser output due to malformed Doxygen XML.
+ * See SKIP_INTERFACES in builders.py.
+ */
+@interface RCTGenericDelegateSplitter<DelegateT> : NSObject
+
+@property (nonatomic, copy, nullable) void (^delegateUpdateBlock)(DelegateT _Nullable delegate);
+
+- (instancetype)initWithDelegateUpdateBlock:(void (^)(DelegateT _Nullable delegate))block;
+- (void)addDelegate:(DelegateT)delegate;
+- (void)removeDelegate:(DelegateT)delegate;
+- (void)removeAllDelegates;
+
+@end

scripts/cxx-api/tests/snapshots/should_handle_multiline_interface/snapshot.api

@@ -0,0 +1,5 @@
+protocol RCTMountingTransactionObserving {
+}
+
+protocol RCTVirtualViewContainerProtocol {
+}

scripts/cxx-api/tests/snapshots/should_handle_multiline_interface/test.h

@@ -0,0 +1,30 @@
+/*
+ * 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.
+ */
+
+@protocol RCTMountingTransactionObserving
+@end
+
+@protocol RCTVirtualViewContainerProtocol
+@end
+
+@class RCTViewComponentView;
+
+/**
+ * Test case for multi-line Objective-C interface declarations.
+ *
+ * Doxygen misparses interface declarations that span multiple lines,
+ * creating __pad0__ members and losing inheritance information.
+ *
+ * This interface is SKIPPED in the parser output due to malformed Doxygen XML.
+ * See SKIP_INTERFACES in builders.py.
+ */
+@interface RCTScrollViewComponentView
+    : RCTViewComponentView <RCTMountingTransactionObserving, RCTVirtualViewContainerProtocol>
+
++ (nullable RCTScrollViewComponentView *)findScrollViewComponentViewForView:(UIView *)view;
+
+@end