react-native-screens 5.0.0-alpha.2 → 5.0.0-alpha.3

package/ios/split/RNSSplitHostProviders.h

@@ -0,0 +1,67 @@
+#pragma once
+
+#import <UIKit/UIKit.h>
+#import "RNSDefines.h"
+#import "RNSEnums.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class RNSSplitScreenController;
+
+/**
+ * @brief Configuration of the UISplitViewController appearance.
+ */
+@protocol RNSSplitHostAppearanceProvider <NSObject>
+
+- (UISplitViewControllerSplitBehavior)preferredSplitBehavior;
+- (UISplitViewControllerPrimaryEdge)primaryEdge;
+- (UISplitViewControllerDisplayMode)preferredDisplayMode;
+- (UISplitViewControllerDisplayModeButtonVisibility)displayModeButtonVisibility;
+#if !TARGET_OS_TV
+- (UISplitViewControllerBackgroundStyle)primaryBackgroundStyle;
+#endif // !TARGET_OS_TV
+- (BOOL)presentsWithGesture;
+- (BOOL)showSecondaryToggleButton;
+- (BOOL)showInspector;
+
+- (double)minimumPrimaryColumnWidth;
+- (double)maximumPrimaryColumnWidth;
+- (double)preferredPrimaryColumnWidthOrFraction;
+- (double)minimumSupplementaryColumnWidth;
+- (double)maximumSupplementaryColumnWidth;
+- (double)preferredSupplementaryColumnWidthOrFraction;
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+- (double)minimumSecondaryColumnWidth;
+- (double)preferredSecondaryColumnWidthOrFraction;
+- (double)minimumInspectorColumnWidth;
+- (double)maximumInspectorColumnWidth;
+- (double)preferredInspectorColumnWidthOrFraction;
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
+- (RNSOrientation)orientation;
+- (UIUserInterfaceStyle)colorScheme;
+
+@end
+
+/**
+ * @brief Behavior consulted by the UISplitViewController delegate callbacks.
+ */
+@protocol RNSSplitHostBehaviorProvider <NSObject>
+
+- (BOOL)hasCustomTopColumnForCollapsing;
+- (UISplitViewControllerColumn)topColumnForCollapsingColumn;
+
+@end
+
+/**
+ * @brief Controllers of the columns mounted in the host, in React order, split by column type.
+ */
+@protocol RNSSplitHostColumnsProvider <NSObject>
+
+- (NSArray<RNSSplitScreenController *> *)columnControllers;
+- (NSArray<RNSSplitScreenController *> *)inspectorControllers;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/split/RNSSplitScreenComponentView.h

@@ -3,8 +3,6 @@
 #import "RNSEnums.h"
 #import "RNSReactBaseView.h"
 #import "RNSSafeAreaProviding.h"
-#import "RNSSplitScreenComponentEventEmitter.h"
-#import "RNSSplitScreenShadowStateProxy.h"
 
 NS_ASSUME_NONNULL_BEGIN
 
@@ -25,26 +23,6 @@ NS_ASSUME_NONNULL_BEGIN
 
 @end
 
-#pragma mark - ShadowTreeState
-
-/**
- * @category ShadowTreeState
- * @brief Interactions between the host component and the associated ShadowNode.
- */
-@interface RNSSplitScreenComponentView ()
-
-/**
- * @brief Getter for the proxy object that interfaces with the Shadow Tree state for this screen.
- *
- * The ShadowStateProxy is the object that's responsible for sending layout updates coming from the Host tree to the
- * ShadowTree.
- *
- * @return A pointer to a RNSSplitScreenShadowStateProxy instance.
- */
-- (nonnull RNSSplitScreenShadowStateProxy *)shadowStateProxy;
-
-@end
-
 #pragma mark - Props
 
 /**
@@ -60,21 +38,4 @@ NS_ASSUME_NONNULL_BEGIN
 
 @end
 
-#pragma mark - Events
-
-/**
- * @category Events
- * @brief APIs related to event emission to React Native.
- */
-@interface RNSSplitScreenComponentView ()
-
-/**
- * @brief Getter for the component's event emitter used for emitting events to React.
- *
- * @return A pointer to RNSSplitScreenComponentEventEmitter instance.
- */
-- (nonnull RNSSplitScreenComponentEventEmitter *)reactEventEmitter;
-
-@end
-
 NS_ASSUME_NONNULL_END

package/ios/split/RNSSplitScreenComponentView.mm

@@ -1,13 +1,18 @@
 #import "RNSSplitScreenComponentView.h"
 #import <React/RCTAssert.h>
 #import <React/RCTSurfaceTouchHandler.h>
-#import <rnscreens/RNSSplitScreenComponentDescriptor.h>
-#import "RNSConversions.h"
+#import <react/renderer/components/rnscreens/RNSSplitScreenComponentDescriptor.h>
+#import "RNSConversions-SplitView.h"
 #import "RNSSafeAreaViewNotifications.h"
+#import "RNSSplitScreenComponentEventEmitter.h"
 #import "RNSSplitScreenController.h"
+#import "RNSSplitScreenShadowStateProxy.h"
 
 namespace react = facebook::react;
 
+@interface RNSSplitScreenComponentView () <RNSSplitScreenControllerDelegate>
+@end
+
 @implementation RNSSplitScreenComponentView {
   RNSSplitScreenComponentEventEmitter *_Nonnull _reactEventEmitter;
   RNSSplitScreenController *_Nullable _controller;
@@ -49,6 +54,7 @@ namespace react = facebook::react;
 {
   _controller = [[RNSSplitScreenController alloc] initWithSplitScreenComponentView:self];
   _controller.view = self;
+  _controller.delegate = self;
 }
 
 - (void)didMoveToWindow
@@ -108,20 +114,31 @@ namespace react = facebook::react;
   [super layoutSubviews];
 }
 
-#pragma mark - ShadowTreeState
+#pragma mark - RNSSplitScreenControllerDelegate
+
+- (void)splitScreenController:(RNSSplitScreenController *)controller didChangeColumnFrame:(CGRect)frame
+{
+  [_shadowStateProxy updateShadowStateWithFrame:frame];
+}
+
+- (void)splitScreenControllerWillAppear:(RNSSplitScreenController *)controller
+{
+  [_reactEventEmitter emitOnWillAppear];
+}
 
-- (nonnull RNSSplitScreenShadowStateProxy *)shadowStateProxy
+- (void)splitScreenControllerDidAppear:(RNSSplitScreenController *)controller
 {
-  RCTAssert(_shadowStateProxy != nil, @"[RNScreens] Attempt to access uninitialized _shadowStateProxy");
-  return _shadowStateProxy;
+  [_reactEventEmitter emitOnDidAppear];
 }
 
-#pragma mark - Events
+- (void)splitScreenControllerWillDisappear:(RNSSplitScreenController *)controller
+{
+  [_reactEventEmitter emitOnWillDisappear];
+}
 
-- (nonnull RNSSplitScreenComponentEventEmitter *)reactEventEmitter
+- (void)splitScreenControllerDidDisappear:(RNSSplitScreenController *)controller
 {
-  RCTAssert(_reactEventEmitter != nil, @"[RNScreens] Attempt to access uninitialized _reactEventEmitter");
-  return _reactEventEmitter;
+  [_reactEventEmitter emitOnDidDisappear];
 }
 
 #pragma mark - RNSSafeAreaProviding

package/ios/split/RNSSplitScreenController.h

@@ -3,18 +3,41 @@
 #import <UIKit/UIKit.h>
 
 @class RNSSplitScreenComponentView;
+@class RNSSplitScreenController;
 
 NS_ASSUME_NONNULL_BEGIN
 
+/**
+ * @protocol RNSSplitScreenControllerDelegate
+ * @brief Receives layout and lifecycle notifications of a Split column from its controller.
+ */
+@protocol RNSSplitScreenControllerDelegate <NSObject>
+
+/**
+ * @brief Called whenever the column frame changes.
+ *
+ * @param frame The column frame in the coordinate space of the SplitHost controller's view, or the column view frame
+ * as is when the column is presented outside the SplitHost subtree (e.g. the inspector as a modal).
+ */
+- (void)splitScreenController:(RNSSplitScreenController *)controller didChangeColumnFrame:(CGRect)frame;
+
+- (void)splitScreenControllerWillAppear:(RNSSplitScreenController *)controller;
+- (void)splitScreenControllerDidAppear:(RNSSplitScreenController *)controller;
+- (void)splitScreenControllerWillDisappear:(RNSSplitScreenController *)controller;
+- (void)splitScreenControllerDidDisappear:(RNSSplitScreenController *)controller;
+
+@end
+
 /**
  * @class RNSSplitScreenController
  * @brief A UIViewController subclass that manages a Split column in a UISplitViewController.
  *
- * Associated with a RNSSplitScreenComponentView, it handles layout synchronization with the
- * Shadow Tree, emits React lifecycle events, and interacts with the SplitHost hierarchy.
+ * It observes the column layout and lifecycle and reports them to its delegate.
  */
 @interface RNSSplitScreenController : UIViewController
 
+@property (nonatomic, weak, nullable) id<RNSSplitScreenControllerDelegate> delegate;
+
 - (instancetype)initWithSplitScreenComponentView:(RNSSplitScreenComponentView *)splitScreenComponentView;
 
 #pragma mark - Signals
@@ -33,7 +56,7 @@ NS_ASSUME_NONNULL_BEGIN
 #pragma mark - Layout
 
 /**
- * @brief Request ShadowNode state update when the Split screen frame origin has changed.
+ * @brief Reports the column frame change after the Split repositioned its columns.
  *
  * @param splitViewController The UISplitViewController whose layout positioning changed, represented by
  * RNSSplitHostController.

package/ios/split/RNSSplitScreenController.mm

@@ -18,16 +18,6 @@
   return self;
 }
 
-- (RNSSplitScreenShadowStateProxy *)shadowStateProxy
-{
-  return [_splitScreenComponentView shadowStateProxy];
-}
-
-- (RNSSplitScreenComponentEventEmitter *)reactEventEmitter
-{
-  return [_splitScreenComponentView reactEventEmitter];
-}
-
 /**
  * @brief Searching for the SplitHost controller
  *
@@ -69,36 +59,29 @@
 {
   [super viewDidLayoutSubviews];
 
-  [self updateShadowTreeState];
-}
-
-/**
- * @brief Handles frame layout changes and updates Shadow Tree accordingly.
- *
- * Requests for the ShadowNode updates through the shadow state proxy.
- * Differentiates cases when we're in the Host hierarchy to calculate frame relatively
- * to the Host view from the modal case where we're passing absolute layout metrics to the ShadowNode.
- */
-- (void)updateShadowTreeState
-{
   // For modals, which are presented outside the SplitHost subtree (and RN hierarchy),
   // we're attaching our touch handler and we don't need to apply any offset corrections,
   // because it's positioned relatively to our RNSSplitScreenComponentView
   if (![self isInSplitHostSubtree]) {
-    [[self shadowStateProxy] updateShadowStateOfComponent:_splitScreenComponentView];
+    [_delegate splitScreenController:self didChangeColumnFrame:self.view.frame];
     return;
   }
 
   UIView *ancestorView = [self findSplitHostController].view;
   RCTAssert(ancestorView != nil, @"[RNScreens] Expected to find RNSSplitHost component for RNSSplitScreen component");
 
-  [[self shadowStateProxy] updateShadowStateOfComponent:_splitScreenComponentView inContextOfAncestorView:ancestorView];
+  [self reportColumnFrameInContextOfView:ancestorView];
 }
 
 - (void)columnPositioningDidChangeInSplitViewController:(UISplitViewController *)splitViewController
 {
-  [[self shadowStateProxy] updateShadowStateOfComponent:_splitScreenComponentView
-                                inContextOfAncestorView:splitViewController.view];
+  [self reportColumnFrameInContextOfView:splitViewController.view];
+}
+
+- (void)reportColumnFrameInContextOfView:(UIView *)ancestorView
+{
+  CGRect frame = [self.view convertRect:self.view.frame toView:ancestorView];
+  [_delegate splitScreenController:self didChangeColumnFrame:frame];
 }
 
 #pragma mark - Events
@@ -106,25 +89,25 @@
 - (void)viewWillAppear:(BOOL)animated
 {
   [super viewWillAppear:animated];
-  [[self reactEventEmitter] emitOnWillAppear];
+  [_delegate splitScreenControllerWillAppear:self];
 }
 
 - (void)viewDidAppear:(BOOL)animated
 {
   [super viewDidAppear:animated];
-  [[self reactEventEmitter] emitOnDidAppear];
+  [_delegate splitScreenControllerDidAppear:self];
 }
 
 - (void)viewWillDisappear:(BOOL)animated
 {
   [super viewWillDisappear:animated];
-  [[self reactEventEmitter] emitOnWillDisappear];
+  [_delegate splitScreenControllerWillDisappear:self];
 }
 
 - (void)viewDidDisappear:(BOOL)animated
 {
   [super viewDidDisappear:animated];
-  [[self reactEventEmitter] emitOnDidDisappear];
+  [_delegate splitScreenControllerDidDisappear:self];
 }
 
 @end

package/ios/split/RNSSplitScreenShadowStateProxy.h

@@ -1,6 +1,7 @@
 #pragma once
 
 #import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
 
 #if defined(__cplusplus)
 #import <react/renderer/core/State.h>
@@ -10,8 +11,6 @@ namespace react = facebook::react;
 
 NS_ASSUME_NONNULL_BEGIN
 
-@class RNSSplitScreenComponentView;
-
 /**
  * @class RNSSplitScreenShadowStateProxy
  * @brief Manages communication between native UIView layout and associated React Native ShadowNode state.
@@ -21,44 +20,6 @@ NS_ASSUME_NONNULL_BEGIN
  */
 @interface RNSSplitScreenShadowStateProxy : NSObject
 
-/**
- * @brief Triggers a shadow state update for the given SplitScreen component.
- *
- * Internally uses the component’s frame in UIWindow coordinates to update the Shadow Tree state.
- *
- * @param screenComponentView An instance of RNSSplitScreenComponentView whose state should be updated.
- */
-- (void)updateShadowStateOfComponent:(RNSSplitScreenComponentView *)screenComponentView;
-
-/**
- * @brief Triggers a shadow state update for the given SplitScreen component in the context of a given ancestor
- * view.
- *
- * Converts the split view screen's local frame to coordinates of the specified ancestor view
- * before applying the update to the Shadow Tree. If the ancestor haven't been defined frame is calculated relatively to
- * the UIWindow.
- *
- * @param screenComponentView An instance of RNSSplitScreenComponentView whose state should be updated.
- * @param ancestorView An optional UIView in whose coordinate space the frame should be computed.
- */
-- (void)updateShadowStateOfComponent:(RNSSplitScreenComponentView *)screenComponentView
-             inContextOfAncestorView:(UIView *_Nullable)ancestorView;
-
-/**
- * @brief Send an update to ShadowNode state with given frame if needed.
- *
- * Converts the frame to coordinates of the specified ancestor view,
- * before applying the update to the Shadow Tree.
- *
- * @param screenComponentView an instance of RNSSplitScreenComponentView whose state should be updated,
- * @param frame frame to update the shadow state with; it must be in coordinate system of `screenComponentView`,
- * @param ancestorView coordinate-system provider view, relative to which the frame should be converted before sending
- * the update.
- */
-- (void)updateShadowStateOfComponent:(RNSSplitScreenComponentView *)screenComponentView
-                           withFrame:(CGRect)frame
-             inContextOfAncestorView:(nonnull UIView *)ancestorView;
-
 /**
  * @brief Send an update to ShadowNode state with given layout metrics.
  *

package/ios/split/RNSSplitScreenShadowStateProxy.mm

@@ -1,9 +1,8 @@
 #import "RNSSplitScreenShadowStateProxy.h"
-#import "RNSSplitScreenComponentView.h"
 
 #import <React/RCTAssert.h>
 #import <React/RCTConversions.h>
-#import <rnscreens/RNSSplitScreenShadowNode.h>
+#import <react/renderer/components/rnscreens/RNSSplitScreenShadowNode.h>
 
 namespace react = facebook::react;
 
@@ -21,21 +20,6 @@ namespace react = facebook::react;
   return self;
 }
 
-- (void)updateShadowStateOfComponent:(RNSSplitScreenComponentView *)screenComponentView
-{
-  [self updateShadowStateOfComponent:screenComponentView inContextOfAncestorView:nil];
-}
-
-- (void)updateShadowStateOfComponent:(RNSSplitScreenComponentView *)screenComponentView
-             inContextOfAncestorView:(UIView *_Nullable)ancestorView
-{
-  CGRect frame = screenComponentView.frame;
-  if (ancestorView != nil) {
-    frame = [screenComponentView convertRect:frame toView:ancestorView];
-  }
-  [self updateShadowStateWithFrame:frame];
-}
-
 - (void)updateShadowStateWithFrame:(CGRect)frame
 {
   if (_state == nullptr) {
@@ -50,15 +34,6 @@ namespace react = facebook::react;
   }
 }
 
-- (void)updateShadowStateOfComponent:(RNSSplitScreenComponentView *)screenComponentView
-                           withFrame:(CGRect)frame
-             inContextOfAncestorView:(nonnull UIView *)ancestorView
-{
-  RCTAssert(ancestorView != nil, @"[RNScreens] ancestorView must not be nil");
-  CGRect convertedFrame = [screenComponentView convertRect:frame toView:ancestorView];
-  [self updateShadowStateWithFrame:convertedFrame];
-}
-
 - (void)updateState:(react::State::Shared const &)state oldState:(react::State::Shared const &)oldState
 {
   _state = std::static_pointer_cast<const react::RNSSplitScreenShadowNode::ConcreteState>(state);

package/ios/split/conversion/RNSConversions-SplitView.h

@@ -0,0 +1,56 @@
+#pragma once
+
+#if defined(__cplusplus)
+
+#import <UIKit/UIKit.h>
+#import <react/renderer/components/rnscreens/Props.h>
+#import <optional>
+#import <string>
+#import "RNSEnums.h"
+
+namespace rnscreens::conversion {
+
+namespace react = facebook::react;
+
+#pragma mark SplitHost props
+
+UISplitViewControllerSplitBehavior SplitViewPreferredSplitBehaviorFromHostProp(
+    react::RNSSplitHostPreferredSplitBehavior behavior);
+
+UISplitViewControllerPrimaryEdge SplitViewPrimaryEdgeFromHostProp(
+    react::RNSSplitHostPrimaryEdge primaryEdge);
+
+UISplitViewControllerDisplayMode SplitViewPreferredDisplayModeFromHostProp(
+    react::RNSSplitHostPreferredDisplayMode displayMode);
+
+#if !TARGET_OS_TV
+UISplitViewControllerBackgroundStyle
+SplitViewPrimaryBackgroundStyleFromHostProp(
+    react::RNSSplitHostPrimaryBackgroundStyle primaryBackgroundStyle);
+#endif // !TARGET_OS_TV
+
+UISplitViewControllerDisplayModeButtonVisibility
+SplitViewDisplayModeButtonVisibilityFromHostProp(
+    react::RNSSplitHostDisplayModeButtonVisibility displayModeButtonVisibility);
+
+std::string UISplitViewControllerDisplayModeToString(
+    UISplitViewControllerDisplayMode displayMode);
+
+std::optional<UISplitViewControllerColumn>
+SplitViewTopColumnForCollapsingFromHostProp(
+    react::RNSSplitHostTopColumnForCollapsing topColumnForCollapsing);
+
+RNSOrientation RNSOrientationFromRNSSplitHostOrientation(
+    react::RNSSplitHostOrientation orientation);
+
+UIUserInterfaceStyle UIUserInterfaceStyleFromHostProp(
+    react::RNSSplitHostColorScheme colorScheme);
+
+#pragma mark SplitScreen props
+
+RNSSplitScreenColumnType RNSSplitScreenColumnTypeFromScreenProp(
+    react::RNSSplitScreenColumnType columnType);
+
+}; // namespace rnscreens::conversion
+
+#endif // defined(__cplusplus)

package/ios/{conversion → split/conversion}/RNSConversions-SplitView.mm

@@ -1,7 +1,10 @@
-#import "RNSConversions.h"
+#import "RNSConversions-SplitView.h"
+#import <React/RCTLog.h>
 
 namespace rnscreens::conversion {
 
+namespace react = facebook::react;
+
 #pragma mark SplitHost props
 
 UISplitViewControllerSplitBehavior SplitViewPreferredSplitBehaviorFromHostProp(

package/ios/stack/conversion/RNSConversions-Stack.h

@@ -0,0 +1,32 @@
+#pragma once
+
+#if defined(__cplusplus)
+
+#import <react/renderer/components/rnscreens/Props.h>
+#import "RNSHeaderItemPlacement.h"
+#import "RNSHeaderItemSpacerPlacement.h"
+#import "RNSStackScreenComponentView.h"
+
+namespace rnscreens::conversion {
+
+namespace react = facebook::react;
+
+RNSStackScreenActivityMode
+RNSStackScreenActivityModeFromReactRNSStackScreenActivityMode(
+    react::RNSStackScreenActivityMode mode);
+
+RNSHeaderItemPlacement
+RNSHeaderItemPlacementFromReactRNSStackHeaderItemIOSPlacement(
+    react::RNSStackHeaderItemIOSPlacement placement);
+
+RNSHeaderItemSpacerPlacement
+RNSHeaderItemSpacerPlacementFromReactRNSStackHeaderItemSpacerIOSPlacement(
+    react::RNSStackHeaderItemSpacerIOSPlacement placement);
+
+UINavigationItemBackButtonDisplayMode
+UINavigationItemBackButtonDisplayModeFromReactRNSStackHeaderConfigIOSBackButtonDisplayMode(
+    react::RNSStackHeaderConfigIOSBackButtonDisplayMode displayMode);
+
+}; // namespace rnscreens::conversion
+
+#endif // defined(__cplusplus)

package/ios/stack/conversion/RNSConversions-Stack.mm

@@ -0,0 +1,55 @@
+#import "RNSConversions-Stack.h"
+
+namespace rnscreens::conversion {
+
+namespace react = facebook::react;
+
+RNSStackScreenActivityMode RNSStackScreenActivityModeFromReactRNSStackScreenActivityMode(
+    react::RNSStackScreenActivityMode mode)
+{
+  return static_cast<RNSStackScreenActivityMode>(mode);
+}
+
+RNSHeaderItemPlacement RNSHeaderItemPlacementFromReactRNSStackHeaderItemIOSPlacement(
+    react::RNSStackHeaderItemIOSPlacement placement)
+{
+  switch (placement) {
+    case react::RNSStackHeaderItemIOSPlacement::Leading:
+      return RNSHeaderItemPlacementLeading;
+    case react::RNSStackHeaderItemIOSPlacement::Trailing:
+      return RNSHeaderItemPlacementTrailing;
+    case react::RNSStackHeaderItemIOSPlacement::Title:
+      return RNSHeaderItemPlacementTitle;
+    case react::RNSStackHeaderItemIOSPlacement::Subtitle:
+      return RNSHeaderItemPlacementSubtitle;
+    case react::RNSStackHeaderItemIOSPlacement::LargeSubtitle:
+      return RNSHeaderItemPlacementLargeSubtitle;
+  }
+}
+
+RNSHeaderItemSpacerPlacement RNSHeaderItemSpacerPlacementFromReactRNSStackHeaderItemSpacerIOSPlacement(
+    react::RNSStackHeaderItemSpacerIOSPlacement placement)
+{
+  switch (placement) {
+    case react::RNSStackHeaderItemSpacerIOSPlacement::Leading:
+      return RNSHeaderItemSpacerPlacementLeading;
+    case react::RNSStackHeaderItemSpacerIOSPlacement::Trailing:
+      return RNSHeaderItemSpacerPlacementTrailing;
+  }
+}
+
+UINavigationItemBackButtonDisplayMode
+UINavigationItemBackButtonDisplayModeFromReactRNSStackHeaderConfigIOSBackButtonDisplayMode(
+    react::RNSStackHeaderConfigIOSBackButtonDisplayMode displayMode)
+{
+  switch (displayMode) {
+    case react::RNSStackHeaderConfigIOSBackButtonDisplayMode::Default:
+      return UINavigationItemBackButtonDisplayModeDefault;
+    case react::RNSStackHeaderConfigIOSBackButtonDisplayMode::Generic:
+      return UINavigationItemBackButtonDisplayModeGeneric;
+    case react::RNSStackHeaderConfigIOSBackButtonDisplayMode::Minimal:
+      return UINavigationItemBackButtonDisplayModeMinimal;
+  }
+}
+
+}; // namespace rnscreens::conversion

package/ios/stack/header/RNSStackHeaderAppearanceMapper.h

@@ -0,0 +1,26 @@
+#pragma once
+
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RNSStackHeaderAppearanceMapper : NSObject
+
+/**
+ * Maps appearance props to a UINavigationBarAppearance object.
+ * `appearanceDict` should be an NSDictionary with a flat structure, where entries correspond
+ * to UIKit attributes, e.g. `titleFontFamily`, `subtitleFontColor`, or empty, for UIKit defaults.
+ */
++ (nullable UINavigationBarAppearance *)appearanceFromDictionary:(nullable NSDictionary *)appearanceDict;
+
+/**
+ * Maps scroll edge appearance props to a UINavigationBarAppearance object.
+ * `appearanceDict` should be an NSDictionary with a flat structure, where entries correspond
+ * to UIKit attributes, e.g. `titleFontFamily`, `subtitleFontColor`, or empty, for UIKit defaults.
+ * The appearance object is built with transparent background configured by default, matching UIKit.
+ */
++ (nullable UINavigationBarAppearance *)scrollEdgeAppearanceFromDictionary:(nullable NSDictionary *)appearanceDict;
+
+@end
+
+NS_ASSUME_NONNULL_END