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

package/ios/scroll-to-top-guard/RNSScrollToTopGuardGestureRecognizer.mm

@@ -0,0 +1,64 @@
+#import "RNSScrollToTopGuardGestureRecognizer.h"
+#import "RNSDefines.h"
+
+@implementation RNSScrollToTopGuardGestureRecognizer
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
+- (instancetype)init
+{
+  if (self = [super initWithTarget:self action:nil]) {
+    self.cancelsTouchesInView = NO;
+    self.delegate = self;
+  }
+  return self;
+}
+
+#pragma mark - UIGestureRecognizerDelegate
+
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer
+{
+  return YES;
+}
+
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer
+{
+  // We want to target tap gesture recognizers only (one responsible for scroll to top must be one).
+  if (![otherGestureRecognizer isKindOfClass:[UITapGestureRecognizer class]]) {
+    return NO;
+  }
+
+  // We don't know the exact recognizer responsible for scroll to top so we block all
+  // gesture recognizers above us.
+  return ![otherGestureRecognizer.view isDescendantOfView:gestureRecognizer.view];
+}
+
+#pragma mark - Class methods
+
++ (BOOL)shouldGuardScrollToTop
+{
+  // The system scroll-to-top-on-header interaction has been present on iPadOS since iOS 26...
+  if (@available(iOS 26.0, *)) {
+    if (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad) {
+      return YES;
+    }
+  }
+  // ...and was extended to iPhone in iOS 27.
+  if (@available(iOS 27.0, *)) {
+    if (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPhone) {
+      return YES;
+    }
+  }
+  return NO;
+}
+
++ (void)applyToView:(nonnull UIView *)view
+{
+  [view addGestureRecognizer:[RNSScrollToTopGuardGestureRecognizer new]];
+}
+
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
+@end

package/ios/{conversion → scroll-view-marker/conversion}/RNSConversions-ScrollViewMarker.mm

@@ -1,9 +1,6 @@
 #import "RNSConversions-ScrollViewMarker.h"
-
 #import <React/RCTLog.h>
 
-namespace react = facebook::react;
-
 #define SWITCH_EDGE_EFFECT(X)                              \
   switch (edgeEffect) {                                    \
     using enum react::X;                                   \
@@ -29,6 +26,8 @@ namespace react = facebook::react;
 
 namespace rnscreens::conversion {
 
+namespace react = facebook::react;
+
 EDGE_EFFECT_CONV_FUNC_IMPL(Left);
 EDGE_EFFECT_CONV_FUNC_IMPL(Top);
 EDGE_EFFECT_CONV_FUNC_IMPL(Right);

package/ios/split/RNSSplitAppearanceApplicator.h

@@ -0,0 +1,36 @@
+#pragma once
+
+#import <Foundation/Foundation.h>
+#import "RNSSplitAppearanceCoordinator.h"
+#import "RNSSplitHostProviders.h"
+
+@class RNSSplitHostController;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * @brief - Class responsible for applying all upcoming updates to SplitView.
+ *
+ * This class is synchronizing UISplitViewController configuration props which are affecting the SplitView appearance
+ * with the configuration exposed by the appearance provider.
+ */
+@interface RNSSplitAppearanceApplicator : NSObject
+
+/**
+ * @brief Function responsible for applying all updates to SplitView in correct order
+ *
+ * It requests calling proper callbacks with batched SplitView updates on the AppearanceCoordinator object
+ *
+ * @param provider The provider of the appearance configuration.
+ * @param splitHostController The controller associated with the SplitView component which receives updates and
+ * manages the native layer.
+ * @param appearanceCoordinator The coordinator which is checking whether the update needs to be applied and if so, it
+ * executes the callback passed by this class.
+ */
+- (void)updateAppearanceIfNeeded:(id<RNSSplitHostAppearanceProvider>)provider
+             splitHostController:(RNSSplitHostController *)splitHostController
+           appearanceCoordinator:(RNSSplitAppearanceCoordinator *)appearanceCoordinator;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/split/RNSSplitAppearanceApplicator.mm

@@ -0,0 +1,182 @@
+#import "RNSSplitAppearanceApplicator.h"
+
+#import <React/RCTAssert.h>
+#import "RNSDefines.h"
+#import "RNSScreenWindowTraits.h"
+#import "RNSSplitHostController.h"
+
+@implementation RNSSplitAppearanceApplicator
+
+- (void)updateAppearanceIfNeeded:(id<RNSSplitHostAppearanceProvider>)provider
+             splitHostController:(RNSSplitHostController *)splitHostController
+           appearanceCoordinator:(RNSSplitAppearanceCoordinator *)appearanceCoordinator
+{
+  __weak auto weakSelf = self;
+
+  [appearanceCoordinator updateIfNeeded:RNSSplitAppearanceUpdateFlagsGeneralUpdate
+                         updateCallback:^{
+                           auto strongSelf = weakSelf;
+                           if (strongSelf == nil) {
+                             return;
+                           }
+
+                           [strongSelf updateSplitViewConfigurationFor:provider withController:splitHostController];
+                         }];
+
+  [appearanceCoordinator updateIfNeeded:RNSSplitAppearanceUpdateFlagsSecondaryScreenNavBarUpdate
+                         updateCallback:^{
+                           auto strongSelf = weakSelf;
+                           if (strongSelf == nil) {
+                             return;
+                           }
+
+                           [splitHostController refreshSecondaryNavBar];
+                         }];
+
+  [appearanceCoordinator updateIfNeeded:RNSSplitAppearanceUpdateFlagsDisplayModeUpdate
+                         updateCallback:^{
+                           auto strongSelf = weakSelf;
+                           if (strongSelf == nil) {
+                             return;
+                           }
+
+                           [strongSelf updateSplitViewDisplayModeFor:provider withController:splitHostController];
+                         }];
+
+  [appearanceCoordinator updateIfNeeded:RNSSplitAppearanceUpdateFlagsOrientationUpdate
+                         updateCallback:^{
+                           [RNSScreenWindowTraits enforceDesiredDeviceOrientation];
+                         }];
+}
+
+/**
+ * @brief Function that applies all basic updates.
+ *
+ * It calls all setters on RNSSplitHostController that doesn't require any custom logic and conditions to be met.
+ *
+ * @param provider The provider of the appearance configuration.
+ * @param splitHostController The controller associated with the SplitView component which receives updates and
+ * manages the native layer.
+ */
+- (void)updateSplitViewConfigurationFor:(id<RNSSplitHostAppearanceProvider>)provider
+                         withController:(RNSSplitHostController *)splitHostController
+{
+  // Step 1 - general settings
+  splitHostController.displayModeButtonVisibility = provider.displayModeButtonVisibility;
+  splitHostController.preferredSplitBehavior = provider.preferredSplitBehavior;
+  splitHostController.overrideUserInterfaceStyle = provider.colorScheme;
+#if !TARGET_OS_TV
+  splitHostController.primaryBackgroundStyle = provider.primaryBackgroundStyle;
+#endif
+  splitHostController.presentsWithGesture = provider.presentsWithGesture;
+  splitHostController.primaryEdge = provider.primaryEdge;
+  splitHostController.showsSecondaryOnlyButton = provider.showSecondaryToggleButton;
+
+  // Step 2.1 - validating column constraints
+  [self validateColumnConstraintsWithMinWidth:provider.minimumPrimaryColumnWidth
+                                     maxWidth:provider.maximumPrimaryColumnWidth];
+
+  [self validateColumnConstraintsWithMinWidth:provider.minimumSupplementaryColumnWidth
+                                     maxWidth:provider.maximumSupplementaryColumnWidth];
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0) && !TARGET_OS_TV
+  if (@available(iOS 26.0, *)) {
+    [self validateColumnConstraintsWithMinWidth:provider.minimumInspectorColumnWidth
+                                       maxWidth:provider.maximumInspectorColumnWidth];
+  }
+#endif
+
+  // Step 2.2 - applying updates to columns
+  if (provider.minimumPrimaryColumnWidth >= 0) {
+    splitHostController.minimumPrimaryColumnWidth = provider.minimumPrimaryColumnWidth;
+  }
+
+  if (provider.maximumPrimaryColumnWidth >= 0) {
+    splitHostController.maximumPrimaryColumnWidth = provider.maximumPrimaryColumnWidth;
+  }
+
+  if (provider.preferredPrimaryColumnWidthOrFraction >= 0 && provider.preferredPrimaryColumnWidthOrFraction < 1) {
+    splitHostController.preferredPrimaryColumnWidthFraction = provider.preferredPrimaryColumnWidthOrFraction;
+  } else if (provider.preferredPrimaryColumnWidthOrFraction >= 1) {
+    splitHostController.preferredPrimaryColumnWidth = provider.preferredPrimaryColumnWidthOrFraction;
+  }
+
+  if (provider.minimumSupplementaryColumnWidth >= 0) {
+    splitHostController.minimumSupplementaryColumnWidth = provider.minimumSupplementaryColumnWidth;
+  }
+
+  if (provider.maximumSupplementaryColumnWidth >= 0) {
+    splitHostController.maximumSupplementaryColumnWidth = provider.maximumSupplementaryColumnWidth;
+  }
+
+  if (provider.preferredSupplementaryColumnWidthOrFraction >= 0 &&
+      provider.preferredSupplementaryColumnWidthOrFraction < 1) {
+    splitHostController.preferredSupplementaryColumnWidthFraction =
+        provider.preferredSupplementaryColumnWidthOrFraction;
+  } else if (provider.preferredSupplementaryColumnWidthOrFraction >= 1) {
+    splitHostController.preferredSupplementaryColumnWidth = provider.preferredSupplementaryColumnWidthOrFraction;
+  }
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0) && !TARGET_OS_TV
+  if (@available(iOS 26.0, *)) {
+    if (provider.minimumSecondaryColumnWidth >= 0) {
+      splitHostController.minimumSecondaryColumnWidth = provider.minimumSecondaryColumnWidth;
+    }
+
+    if (provider.preferredSecondaryColumnWidthOrFraction >= 0 && provider.preferredSecondaryColumnWidthOrFraction < 1) {
+      splitHostController.preferredSecondaryColumnWidthFraction = provider.preferredSecondaryColumnWidthOrFraction;
+    } else if (provider.preferredSecondaryColumnWidthOrFraction >= 1) {
+      splitHostController.preferredSecondaryColumnWidth = provider.preferredSecondaryColumnWidthOrFraction;
+    }
+
+    if (provider.minimumInspectorColumnWidth >= 0) {
+      splitHostController.minimumInspectorColumnWidth = provider.minimumInspectorColumnWidth;
+    }
+
+    if (provider.maximumInspectorColumnWidth >= 0) {
+      splitHostController.maximumInspectorColumnWidth = provider.maximumInspectorColumnWidth;
+    }
+
+    if (provider.preferredInspectorColumnWidthOrFraction >= 0 && provider.preferredInspectorColumnWidthOrFraction < 1) {
+      splitHostController.preferredInspectorColumnWidthFraction = provider.preferredInspectorColumnWidthOrFraction;
+    } else if (provider.preferredInspectorColumnWidthOrFraction >= 1) {
+      splitHostController.preferredInspectorColumnWidth = provider.preferredInspectorColumnWidthOrFraction;
+    }
+  }
+#endif
+
+  // Step 2.3 - manipulating with inspector column
+  [splitHostController toggleSplitViewInspector:provider.showInspector];
+}
+
+/**
+ * @brief Function that updates `preferredDisplayMode` property on SplitView.
+ *
+ * `preferredDisplayMode` needs to have a dedicated flag to prevent updates from the JS, when other props updates the
+ * appearance. It is crucial in the case, when `preferredDisplayMode` has changed due to some transition that was
+ * executed natively, e. g. after showing/hiding a column by a swipe. In that case, any prop update incoming, would
+ * reset `preferredDisplayMode` to the state from JS, what doesn't look good.
+ *
+ * @param provider The provider of the appearance configuration.
+ * @param splitHostController The controller associated with the SplitView component which receives updates and
+ * manages the native layer.
+ */
+- (void)updateSplitViewDisplayModeFor:(id<RNSSplitHostAppearanceProvider>)provider
+                       withController:(RNSSplitHostController *)splitHostController
+{
+  splitHostController.preferredDisplayMode = provider.preferredDisplayMode;
+}
+
+- (void)validateColumnConstraintsWithMinWidth:(CGFloat)minWidth maxWidth:(CGFloat)maxWidth
+{
+  // Compare values only if both are non-negative.
+  // The default value, which is -1, indicates that the constraint was not provided.
+  if (minWidth >= 0 && maxWidth >= 0) {
+    RCTAssert(minWidth <= maxWidth,
+              @"[RNScreens] Split column constraints are invalid: minWidth %f cannot be greater than maxWidth %f",
+              minWidth,
+              maxWidth);
+  }
+}
+
+@end

package/ios/split/RNSSplitAppearanceCoordinator.h

@@ -0,0 +1,26 @@
+#pragma once
+
+#import <Foundation/Foundation.h>
+#import "RNSSplitAppearanceUpdateFlags.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * @brief - A class that is responsible for coordinating SplitHost appearance updates.
+ *
+ * It collects flags for Split appearance update actions and invalidates them.
+ * It's also responsible for executing callbacks when the action is requested.
+ */
+@interface RNSSplitAppearanceCoordinator : NSObject
+
+@property (nonatomic) RNSSplitAppearanceUpdateFlags updateFlags;
+
+- (void)needs:(RNSSplitAppearanceUpdateFlags)updateFlag;
+
+- (void)updateIfNeeded:(RNSSplitAppearanceUpdateFlags)updateFlag updateCallback:(void (^)(void))updateCallback;
+
+- (BOOL)isNeeded:(RNSSplitAppearanceUpdateFlags)updateFlag;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/split/RNSSplitAppearanceCoordinator.mm

@@ -0,0 +1,27 @@
+#import "RNSSplitAppearanceCoordinator.h"
+
+@implementation RNSSplitAppearanceCoordinator
+
+- (void)needs:(RNSSplitAppearanceUpdateFlags)updateFlag
+{
+  _updateFlags |= updateFlag;
+}
+
+/**
+ * Executes the update callback if the specified flag is set.
+ * The flag is cleared prior to execution to ensure the update only happens once per cycle.
+ */
+- (void)updateIfNeeded:(RNSSplitAppearanceUpdateFlags)updateFlag updateCallback:(void (^)(void))updateCallback
+{
+  if ([self isNeeded:updateFlag]) {
+    _updateFlags &= ~updateFlag;
+    updateCallback();
+  }
+}
+
+- (BOOL)isNeeded:(RNSSplitAppearanceUpdateFlags)updateFlag
+{
+  return (_updateFlags & updateFlag) == updateFlag;
+}
+
+@end

package/ios/split/RNSSplitAppearanceUpdateFlags.h

@@ -0,0 +1,14 @@
+#pragma once
+
+#import <Foundation/Foundation.h>
+
+/**
+ * @brief - A collection of flags, which can be invalidated on RNSSplitHostController to apply proper updates to
+ * SplitView
+ */
+typedef NS_OPTIONS(uint8_t, RNSSplitAppearanceUpdateFlags) {
+  RNSSplitAppearanceUpdateFlagsGeneralUpdate = 1 << 0,
+  RNSSplitAppearanceUpdateFlagsSecondaryScreenNavBarUpdate = 1 << 1,
+  RNSSplitAppearanceUpdateFlagsDisplayModeUpdate = 1 << 2,
+  RNSSplitAppearanceUpdateFlagsOrientationUpdate = 1 << 3,
+};

package/ios/split/RNSSplitHostComponentEventEmitter.h

@@ -1,6 +1,7 @@
 #pragma once
 
 #import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
 
 // Hide C++ symbols from C compiler used when building Swift module
 #if defined(__cplusplus)

package/ios/split/RNSSplitHostComponentEventEmitter.mm

@@ -1,7 +1,7 @@
 #import "RNSSplitHostComponentEventEmitter.h"
 #import <React/RCTConversions.h>
 #import <React/RCTLog.h>
-#import "RNSConversions.h"
+#import "RNSConversions-SplitView.h"
 
 @implementation RNSSplitHostComponentEventEmitter {
   std::shared_ptr<const react::RNSSplitHostEventEmitter> _reactEventEmitter;

package/ios/split/RNSSplitHostComponentView.h

@@ -3,7 +3,7 @@
 #import "RNSDefines.h"
 #import "RNSEnums.h"
 #import "RNSReactBaseView.h"
-#import "RNSSplitHostComponentEventEmitter.h"
+#import "RNSSplitHostProviders.h"
 
 NS_ASSUME_NONNULL_BEGIN
 
@@ -17,7 +17,8 @@ NS_ASSUME_NONNULL_BEGIN
  * Responsible for managing multi-column layouts via associated native UISplitViewController.
  * Manages updates to the layout properties, column configuration, and event emission.
  */
-@interface RNSSplitHostComponentView : RNSReactBaseView
+@interface RNSSplitHostComponentView
+    : RNSReactBaseView <RNSSplitHostAppearanceProvider, RNSSplitHostBehaviorProvider, RNSSplitHostColumnsProvider>
 
 - (nonnull NSMutableArray<RNSSplitScreenComponentView *> *)reactSubviews;
 
@@ -29,7 +30,8 @@ NS_ASSUME_NONNULL_BEGIN
 
 /**
  * @category Props
- * @brief Definitions for React Native props.
+ * @brief Definitions for React Native props. They back the appearance and behavior providers of the Split host
+ * controller.
  */
 @interface RNSSplitHostComponentView ()
 
@@ -66,16 +68,4 @@ NS_ASSUME_NONNULL_BEGIN
 
 @end
 
-#pragma mark - Events
-
-/**
- * @category Events
- * @brief APIs related to event emission to React Native.
- */
-@interface RNSSplitHostComponentView ()
-
-- (nonnull RNSSplitHostComponentEventEmitter *)reactEventEmitter;
-
-@end
-
 NS_ASSUME_NONNULL_END

package/ios/split/RNSSplitHostComponentView.mm

@@ -6,10 +6,12 @@
 #import <react/renderer/components/rnscreens/RCTComponentViewHelpers.h>
 
 #import "RNSContainerHelpers.h"
-#import "RNSConversions.h"
+#import "RNSConversions-SplitView.h"
 #import "RNSDefines.h"
+#import "RNSSplitHostComponentEventEmitter.h"
+#import "RNSSplitHostController.h"
 #import "RNSSplitScreenComponentView.h"
-#import "Swift-Bridging.h"
+#import "RNSSplitScreenController.h"
 
 namespace react = facebook::react;
 
@@ -18,7 +20,9 @@ static const CGFloat epsilon = 1e-6;
 #define COLUMN_METRIC_CHANGED(OLD, NEW, PROPERTY_NAME, EPSILON) \
   (fabs((OLD).columnMetrics.PROPERTY_NAME - (NEW).columnMetrics.PROPERTY_NAME) > (EPSILON))
 
-@interface RNSSplitHostComponentView () <RCTMountingTransactionObserving, RCTRNSSplitHostViewProtocol>
+@interface RNSSplitHostComponentView () <RCTMountingTransactionObserving,
+                                         RCTRNSSplitHostViewProtocol,
+                                         RNSSplitHostControllerEventsDelegate>
 @end
 
 @implementation RNSSplitHostComponentView {
@@ -116,7 +120,11 @@ static const CGFloat epsilon = 1e-6;
   if (_controller == nil) {
     int numberOfColumns = [self getNumberOfColumns];
 
-    _controller = [[RNSSplitHostController alloc] initWithSplitHostComponentView:self numberOfColumns:numberOfColumns];
+    _controller = [[RNSSplitHostController alloc] initWithNumberOfColumns:numberOfColumns];
+    _controller.eventsDelegate = self;
+    _controller.appearanceProvider = self;
+    _controller.behaviorProvider = self;
+    _controller.columnsProvider = self;
   }
 }
 
@@ -399,10 +407,51 @@ RNS_IGNORE_SUPER_CALL_END
 
 #pragma mark - Events
 
-- (nonnull RNSSplitHostComponentEventEmitter *)reactEventEmitter
+#pragma mark - RNSSplitHostColumnsProvider
+
+- (NSArray<RNSSplitScreenController *> *)columnControllers
+{
+  return [self controllersOfColumnsWithType:RNSSplitScreenColumnTypeColumn];
+}
+
+- (NSArray<RNSSplitScreenController *> *)inspectorControllers
+{
+  return [self controllersOfColumnsWithType:RNSSplitScreenColumnTypeInspector];
+}
+
+- (NSArray<RNSSplitScreenController *> *)controllersOfColumnsWithType:(RNSSplitScreenColumnType)columnType
+{
+  NSMutableArray<RNSSplitScreenController *> *controllers = [NSMutableArray array];
+  for (RNSSplitScreenComponentView *column in _reactSubviews) {
+    if (column.columnType == columnType) {
+      [controllers addObject:column.controller];
+    }
+  }
+  return controllers;
+}
+
+#pragma mark - RNSSplitHostControllerEventsDelegate
+
+- (void)splitHostControllerDidCollapse:(RNSSplitHostController *)controller
+{
+  [_reactEventEmitter emitOnCollapse];
+}
+
+- (void)splitHostControllerDidExpand:(RNSSplitHostController *)controller
+{
+  [_reactEventEmitter emitOnExpand];
+}
+
+- (void)splitHostController:(RNSSplitHostController *)controller
+    willChangeDisplayModeFrom:(UISplitViewControllerDisplayMode)fromDisplayMode
+                           to:(UISplitViewControllerDisplayMode)toDisplayMode
+{
+  [_reactEventEmitter emitOnDisplayModeWillChangeFrom:fromDisplayMode to:toDisplayMode];
+}
+
+- (void)splitHostControllerDidHideInspector:(RNSSplitHostController *)controller
 {
-  RCTAssert(_reactEventEmitter != nil, @"[RNScreens] Attempt to access uninitialized _reactEventEmitter");
-  return _reactEventEmitter;
+  [_reactEventEmitter emitOnHideInspector];
 }
 
 #pragma mark - Dynamic frameworks support

package/ios/split/RNSSplitHostController.h

@@ -0,0 +1,105 @@
+#pragma once
+
+#import <UIKit/UIKit.h>
+#import "RNSOrientationProviding.h"
+#import "RNSReactMountingTransactionObserving.h"
+#import "RNSSplitHostProviders.h"
+
+@class RNSSplitHostController;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * @protocol RNSSplitHostControllerEventsDelegate
+ * @brief Receives UISplitViewController lifecycle notifications from the Split host controller.
+ */
+@protocol RNSSplitHostControllerEventsDelegate <NSObject>
+
+- (void)splitHostControllerDidCollapse:(RNSSplitHostController *)controller;
+- (void)splitHostControllerDidExpand:(RNSSplitHostController *)controller;
+- (void)splitHostController:(RNSSplitHostController *)controller
+    willChangeDisplayModeFrom:(UISplitViewControllerDisplayMode)fromDisplayMode
+                           to:(UISplitViewControllerDisplayMode)toDisplayMode;
+- (void)splitHostControllerDidHideInspector:(RNSSplitHostController *)controller;
+
+@end
+
+/**
+ * @class RNSSplitHostController
+ * @brief A controller associated with the RN native component representing Split host.
+ *
+ * Installs the column controllers, synchronizes appearance settings with the configuration exposed by the providers,
+ * observes the UISplitViewController lifecycle and reports it to the delegate.
+ */
+@interface RNSSplitHostController
+    : UISplitViewController <RNSReactMountingTransactionObserving, RNSOrientationProviding>
+
+@property (nonatomic, weak, nullable) id<RNSSplitHostControllerEventsDelegate> eventsDelegate;
+@property (nonatomic, weak, nullable) id<RNSSplitHostAppearanceProvider> appearanceProvider;
+@property (nonatomic, weak, nullable) id<RNSSplitHostBehaviorProvider> behaviorProvider;
+@property (nonatomic, weak, nullable) id<RNSSplitHostColumnsProvider> columnsProvider;
+
+/**
+ * @brief Initializes the Split host controller with provided style.
+ *
+ * The style for the Split component can be passed only in the initialization method and cannot be changed dynamically.
+ *
+ * @param numberOfColumns Expected number of visible columns.
+ */
+- (instancetype)initWithNumberOfColumns:(NSInteger)numberOfColumns;
+
+#pragma mark - Signals
+
+- (void)setNeedsUpdateOfChildViewControllers;
+
+- (void)setNeedsAppearanceUpdate;
+
+- (void)setNeedsSecondaryScreenNavBarUpdate;
+
+- (void)setNeedsDisplayModeUpdate;
+
+- (void)setNeedsOrientationUpdate;
+
+#pragma mark - Updating
+
+- (void)updateChildViewControllersIfNeeded;
+
+/**
+ * @brief Creates and attaches the Split child controllers based on the current React subviews.
+ *
+ * It validates constraints for Split hierarchy and it will crash after recognizing an invalid state,
+ * e. g. dynamically changed number of columns or number of columns that isn't between defined bounds.
+ * If Split constraints are met, it attaches SplitScreen representatives to SplitHost component.
+ */
+- (void)updateChildViewControllers;
+
+/**
+ * @brief Triggering appearance updates on secondary column's UINavigationBar component
+ *
+ * It validates that the secondary VC is valid UINavigationController and it updates the navbar
+ * state by toggling it's visibility, what should be performed in a single batch of updates.
+ */
+- (void)refreshSecondaryNavBar;
+
+#pragma mark - Public setters
+
+/**
+ * @brief Shows or hides the inspector screen.
+ * @remarks Inspector column is only available for iOS 26 or higher.
+ *
+ * @param showInspector Determines whether the inspector column should be visible.
+ */
+- (void)toggleSplitViewInspector:(BOOL)showInspector;
+
+/**
+ * @brief Programmatically shows a specific column identified by its string name.
+ *
+ * Maps the string column name to the corresponding `UISplitViewController.Column` and calls `show(_:)`.
+ *
+ * @param columnName A string representing the column to show: `"primary"`, `"supplementary"`, or `"secondary"`.
+ */
+- (void)showColumnNamed:(NSString *)columnName;
+
+@end
+
+NS_ASSUME_NONNULL_END