refactor(iOS, FormSheet v5): Move AppearanceCoordinator/Applicator to ContentController (#4074)

## Description

Previously, there was a tight coupling where
`RNSFormSheetContentController` and `RNSFormSheetHostComponentView` had
a direct dependency. By introducing dedicated provider protocols, the
UIKit is now completely agnostic of React.

Closes:
software-mansion/react-native-screens-labs#1454

## Changes

- defining contracts that Host now implements to supply data.
- removed all `RNSFormSheetHostComponentView` dependencies from
`RNSFormSheetContentController` and `RNSFormSheetAppearanceApplicator`
- moved invalidation flags logic from the Host to the Controller

## Before & after - visual documentation

N/A - refactor

## Test plan

No regression in existing examples

## Checklist

- [ ] Included code example that can be used to test this change.
- [ ] For visual changes, included screenshots / GIFs / recordings
documenting the change.
- [ ] For API changes, updated relevant public types.
- [ ] Ensured that CI passes

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Author: t0maboro

ios/gamma/modals/form-sheet/RNSFormSheetAppearanceApplicator.h

@@ -1,18 +1,19 @@
 #pragma once
 
 #import <Foundation/Foundation.h>
+#import "RNSFormSheetProviders.h"
 
 @class RNSFormSheetAppearanceCoordinator;
 @class RNSFormSheetContentController;
-@class RNSFormSheetHostComponentView;
 
 NS_ASSUME_NONNULL_BEGIN
 
 @interface RNSFormSheetAppearanceApplicator : NSObject
 
-- (void)updateAppearanceIfNeededForHost:(RNSFormSheetHostComponentView *)host
-                             controller:(RNSFormSheetContentController *)controller
-                            coordinator:(RNSFormSheetAppearanceCoordinator *)coordinator;
+- (void)updateAppearanceIfNeededWithAppearanceProvider:(id<RNSFormSheetAppearanceProvider>)appearanceProvider
+                                      behaviorProvider:(id<RNSFormSheetBehaviorProvider>)behaviorProvider
+                                            controller:(RNSFormSheetContentController *)controller
+                                           coordinator:(RNSFormSheetAppearanceCoordinator *)coordinator;
 
 - (void)resetInitialDetent;
 

ios/gamma/modals/form-sheet/RNSFormSheetAppearanceApplicator.mm

@@ -6,7 +6,6 @@
 #import "RNSFormSheetAppearanceUpdateFlags.h"
 #import "RNSFormSheetContentController.h"
 #import "RNSFormSheetDetentResolver.h"
-#import "RNSFormSheetHostComponentView.h"
 
 @implementation RNSFormSheetAppearanceApplicator {
   BOOL _initialDetentApplied;
@@ -25,20 +24,24 @@ - (void)resetInitialDetent
   _initialDetentApplied = NO;
 }
 
-- (void)updateAppearanceIfNeededForHost:(RNSFormSheetHostComponentView *)host
-                             controller:(RNSFormSheetContentController *)controller
-                            coordinator:(RNSFormSheetAppearanceCoordinator *)coordinator
+- (void)updateAppearanceIfNeededWithAppearanceProvider:(id<RNSFormSheetAppearanceProvider>)appearanceProvider
+                                      behaviorProvider:(id<RNSFormSheetBehaviorProvider>)behaviorProvider
+                                            controller:(RNSFormSheetContentController *)controller
+                                           coordinator:(RNSFormSheetAppearanceCoordinator *)coordinator
 {
   [coordinator updateIfNeeds:RNSFormSheetAppearanceUpdateFlagsConfiguration
            performOperations:^{
-             [self updateSheetConfigurationForHost:host controller:controller];
+             [self updateSheetConfigurationForAppearanceProvider:appearanceProvider
+                                                behaviorProvider:behaviorProvider
+                                                      controller:controller];
            }];
 }
 
 #pragma mark - Updaters
 
-- (void)updateSheetConfigurationForHost:(RNSFormSheetHostComponentView *)host
-                             controller:(RNSFormSheetContentController *)controller
+- (void)updateSheetConfigurationForAppearanceProvider:(id<RNSFormSheetAppearanceProvider>)appearanceProvider
+                                     behaviorProvider:(id<RNSFormSheetBehaviorProvider>)behaviorProvider
+                                           controller:(RNSFormSheetContentController *)controller
 {
 #if !TARGET_OS_TV
   UISheetPresentationController *sheet = controller.sheetPresentationController;
@@ -47,22 +50,23 @@ - (void)updateSheetConfigurationForHost:(RNSFormSheetHostComponentView *)host
       @"[RNScreens] sheetPresentationController is nil. Ensure modalPresentationStyle is set to UIModalPresentationFormSheet.");
 
   NSArray<UISheetPresentationControllerDetent *> *nativeDetents =
-      [RNSFormSheetDetentResolver buildSheetDetentsForFractions:host.detents];
+      [RNSFormSheetDetentResolver buildSheetDetentsForFractions:behaviorProvider.detents];
 
   UISheetPresentationControllerDetentIdentifier initialDetentIdentifier = nil;
   if (!_initialDetentApplied) {
-    initialDetentIdentifier = [RNSFormSheetDetentResolver initialDetentIdentifierForDetents:nativeDetents
-                                                                           atRequestedIndex:host.initialDetentIndex];
+    initialDetentIdentifier =
+        [RNSFormSheetDetentResolver initialDetentIdentifierForDetents:nativeDetents
+                                                     atRequestedIndex:behaviorProvider.initialDetentIndex];
     _initialDetentApplied = YES;
   }
 
-  UISheetPresentationControllerDetentIdentifier largestUndimmedDetentIdentifier =
-      [RNSFormSheetDetentResolver largestUndimmedDetentIdentifierForDetents:nativeDetents
-                                                           atRequestedIndex:host.largestUndimmedDetentIndex];
+  UISheetPresentationControllerDetentIdentifier largestUndimmedDetentIdentifier = [RNSFormSheetDetentResolver
+      largestUndimmedDetentIdentifierForDetents:nativeDetents
+                               atRequestedIndex:appearanceProvider.largestUndimmedDetentIndex];
 
-  BOOL prefersGrabberVisible = host.prefersGrabberVisible;
-  CGFloat preferredCornerRadius = host.preferredCornerRadius;
-  BOOL prefersScrollingExpandsWhenScrolledToEdge = host.prefersScrollingExpandsWhenScrolledToEdge;
+  BOOL prefersGrabberVisible = appearanceProvider.prefersGrabberVisible;
+  CGFloat preferredCornerRadius = appearanceProvider.preferredCornerRadius;
+  BOOL prefersScrollingExpandsWhenScrolledToEdge = behaviorProvider.prefersScrollingExpandsWhenScrolledToEdge;
 
   [sheet animateChanges:^{
     sheet.detents = nativeDetents;

ios/gamma/modals/form-sheet/RNSFormSheetContentController.h

@@ -1,6 +1,7 @@
 #pragma once
 
 #import <UIKit/UIKit.h>
+#import "RNSFormSheetProviders.h"
 
 NS_ASSUME_NONNULL_BEGIN
 
@@ -20,10 +21,21 @@ NS_ASSUME_NONNULL_BEGIN
 
 @property (nonatomic, weak, nullable) id<RNSFormSheetContentControllerDelegate> delegate;
 
+@property (nonatomic, weak, nullable) id<RNSFormSheetPresentationProvider> presentationProvider;
+@property (nonatomic, weak, nullable) id<RNSFormSheetAppearanceProvider> appearanceProvider;
+@property (nonatomic, weak, nullable) id<RNSFormSheetBehaviorProvider> behaviorProvider;
+
 @property (nonatomic, readonly, nonnull) RNSFormSheetContentView *contentView;
 
-- (void)presentFromWindowIfNeeded:(nonnull UIWindow *)window;
-- (void)dismissIfNeeded;
+#pragma mark - Signals
+
+- (void)setNeedsPresentationUpdate;
+- (void)setNeedsAppearanceUpdate;
+- (void)setNeedsInitialDetentReset;
+
+#pragma mark - Updates
+
+- (void)flushPendingUpdates;
 
 @end
 

ios/gamma/modals/form-sheet/RNSFormSheetContentController.mm

@@ -1,4 +1,7 @@
 #import "RNSFormSheetContentController.h"
+#import "RNSFormSheetAppearanceApplicator.h"
+#import "RNSFormSheetAppearanceCoordinator.h"
+#import "RNSFormSheetAppearanceUpdateFlags.h"
 #import "RNSFormSheetContentView.h"
 #import "RNSPresentationSourceProvider.h"
 
@@ -13,12 +16,22 @@ @interface RNSFormSheetContentController () <UIAdaptivePresentationControllerDel
                                              >
 @end
 
-@implementation RNSFormSheetContentController
+@implementation RNSFormSheetContentController {
+  RNSFormSheetAppearanceCoordinator *_Nonnull _appearanceCoordinator;
+  RNSFormSheetAppearanceApplicator *_Nonnull _appearanceApplicator;
+
+  BOOL _needsInitialDetentReset;
+}
 
 - (instancetype)init
 {
   if (self = [super init]) {
     self.modalPresentationStyle = UIModalPresentationFormSheet;
+
+    _appearanceCoordinator = [RNSFormSheetAppearanceCoordinator new];
+    _appearanceApplicator = [RNSFormSheetAppearanceApplicator new];
+
+    _needsInitialDetentReset = NO;
   }
   return self;
 }
@@ -46,6 +59,27 @@ - (void)viewDidLayoutSubviews
 
 #pragma mark - Presentation
 
+- (void)updatePresentationState
+{
+  id<RNSFormSheetPresentationProvider> presentationProvider = self.presentationProvider;
+
+  RCTAssert(presentationProvider != nil,
+            @"[RNScreens] Presentation provider must be set before updating presentation state.");
+
+  if (presentationProvider == nil) {
+    return;
+  }
+
+  if (presentationProvider.isOpen) {
+    UIWindow *window = presentationProvider.hostWindow;
+    if (window != nil) {
+      [self presentFromWindowIfNeeded:window];
+    }
+  } else {
+    [self dismissIfNeeded];
+  }
+}
+
 - (void)prepareForPresentation
 {
   // The presentation controller is recreated by UIKit on every present/dismiss cycle.
@@ -88,6 +122,62 @@ - (void)dismissIfNeeded
   [self dismissViewControllerAnimated:YES completion:nil];
 }
 
+#pragma mark - Appearance
+
+- (void)updateAppearanceIfNeeded
+{
+  id<RNSFormSheetAppearanceProvider> appearanceProvider = self.appearanceProvider;
+  id<RNSFormSheetBehaviorProvider> behaviorProvider = self.behaviorProvider;
+
+  RCTAssert(appearanceProvider != nil, @"[RNScreens] Appearance provider must be set before updating appearance.");
+
+  RCTAssert(behaviorProvider != nil, @"[RNScreens] Behavior provider must be set before updating appearance.");
+
+  if (appearanceProvider == nil || behaviorProvider == nil) {
+    return;
+  }
+
+  if (_needsInitialDetentReset) {
+    _needsInitialDetentReset = NO;
+    [_appearanceApplicator resetInitialDetent];
+  }
+
+  [_appearanceApplicator updateAppearanceIfNeededWithAppearanceProvider:appearanceProvider
+                                                       behaviorProvider:behaviorProvider
+                                                             controller:self
+                                                            coordinator:_appearanceCoordinator];
+
+  // TODO: @t0maboro - decouple presentation logic from AppearanceCoordinator
+  [_appearanceCoordinator updateIfNeeds:RNSFormSheetAppearanceUpdateFlagsPresentation
+                      performOperations:^{
+                        [self updatePresentationState];
+                      }];
+}
+
+#pragma mark - Signals
+
+- (void)setNeedsPresentationUpdate
+{
+  [_appearanceCoordinator setNeeds:RNSFormSheetAppearanceUpdateFlagsPresentation];
+}
+
+- (void)setNeedsAppearanceUpdate
+{
+  [_appearanceCoordinator setNeeds:RNSFormSheetAppearanceUpdateFlagsConfiguration];
+}
+
+- (void)setNeedsInitialDetentReset
+{
+  _needsInitialDetentReset = YES;
+}
+
+#pragma mark - Updates
+
+- (void)flushPendingUpdates
+{
+  [self updateAppearanceIfNeeded];
+}
+
 #pragma mark - UIAdaptivePresentationControllerDelegate
 
 - (void)presentationControllerDidDismiss:(UIPresentationController *)presentationController

ios/gamma/modals/form-sheet/RNSFormSheetHostComponentView.h

@@ -20,6 +20,7 @@ NS_ASSUME_NONNULL_BEGIN
 - (const std::vector<double> &)detents;
 #endif
 
+@property (nonatomic, readonly) BOOL isOpen;
 @property (nonatomic, readonly) BOOL prefersGrabberVisible;
 @property (nonatomic, readonly) CGFloat preferredCornerRadius;
 @property (nonatomic, readonly) NSInteger largestUndimmedDetentIndex;