@apexnative/navigation 1.0.0-alpha.7 → 1.0.0-alpha.9

package/ios/Layouts/SideMenu/ANNSideMenuViewController.mm

@@ -12,6 +12,24 @@ static const CGFloat ANNSideMenuDimAlpha = 0.5;
 static const CGFloat ANNSideMenuMaxStretch = 1.1;
 static const NSTimeInterval ANNSideMenuMinimumDuration = 0.1;
 
+// `sideMenu.menusAttachMode` of the side menu's own options, else of the defaults; any other value, and none, is
+// `together`.
+static ANNSideMenuAttachMode ANNSideMenuAttachModeOf(ANNNavigationOptions *options,
+                                                     ANNNavigationOptions *defaultOptions) {
+    Text *value = options.sideMenu.menusAttachMode;
+    if (!value.hasValue) {
+        value = defaultOptions.sideMenu.menusAttachMode;
+    }
+    NSString *mode = [value withDefault:nil];
+    if ([mode isEqualToString:@"afterCenter"]) {
+        return ANNSideMenuAttachModeAfterCenter;
+    }
+    if ([mode isEqualToString:@"onOpen"]) {
+        return ANNSideMenuAttachModeOnOpen;
+    }
+    return ANNSideMenuAttachModeTogether;
+}
+
 static UINavigationController *ANNStackOfResponder(UIResponder *responder) {
     for (; responder; responder = responder.nextResponder) {
         if ([responder isKindOfClass:UINavigationController.class]) {
@@ -65,6 +83,8 @@ typedef NS_ENUM(NSInteger, ANNSideMenuAppearance) {
 @property(nonatomic) BOOL glass;
 @property(nonatomic) ANNSideMenuAppearance appearance;
 @property(nonatomic, copy) NSString *scrimTestID;
+// The menu's part is in its container and renders (`menusAttachMode`).
+@property(nonatomic) BOOL attached;
 @end
 
 @implementation ANNSideMenuSideState
@@ -95,6 +115,8 @@ typedef NS_ENUM(NSInteger, ANNSideMenuAppearance) {
     ANNSideMenuSideState *_leftState;
     ANNSideMenuSideState *_rightState;
     ANNSideMenuOpenGestureMode _openGestureMode;
+    ANNSideMenuAttachMode _attachMode;
+    BOOL _firstAppeared;
     NSString *_animationType;
     UIView *_centerContainer;
     UIView *_leftContainer;
@@ -132,6 +154,7 @@ typedef NS_ENUM(NSInteger, ANNSideMenuAppearance) {
     _leftState = [ANNSideMenuSideState new];
     _rightState = [ANNSideMenuSideState new];
     _openGestureMode = ANNSideMenuOpenGestureModeBezel;
+    _attachMode = ANNSideMenuAttachModeOf(options, defaultOptions);
     [self setSideMenuChildren:childViewControllers];
 
     self.presenter = presenter;
@@ -181,10 +204,15 @@ typedef NS_ENUM(NSInteger, ANNSideMenuAppearance) {
 
 - (void)viewDidLoad {
     [super viewDidLoad];
-    _leftContainer = [self containerForChild:self.left];
-    _rightContainer = [self containerForChild:self.right];
-    _centerContainer = [self containerForChild:self.center];
+    _leftContainer = [self makeContainer];
+    _rightContainer = [self makeContainer];
+    _centerContainer = [self makeContainer];
+    [self putChild:self.center into:_centerContainer];
     _centerContainer.hidden = NO;
+    if (_attachMode == ANNSideMenuAttachModeTogether) {
+        [self attachMenu:ANNSideMenuSideLeft];
+        [self attachMenu:ANNSideMenuSideRight];
+    }
     [self applyGlassOf:ANNSideMenuSideLeft];
     [self applyGlassOf:ANNSideMenuSideRight];
 
@@ -200,32 +228,65 @@ typedef NS_ENUM(NSInteger, ANNSideMenuAppearance) {
     [self.view addGestureRecognizer:_pan];
 }
 
-// A child in a view of its own, which the menu moves; a menu's container is hidden while closed.
-- (UIView *)containerForChild:(UIViewController *)child {
+// The view of a part, which the menu moves; a menu's container is hidden while closed.
+- (UIView *)makeContainer {
     UIView *container = [[UIView alloc] initWithFrame:self.view.bounds];
     container.hidden = YES;
     [self.view addSubview:container];
-    if (child) {
-        [self addChildViewController:child];
-        child.view.frame = container.bounds;
-        child.view.autoresizingMask =
-            UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
-        [container addSubview:child.view];
-        [child didMoveToParentViewController:self];
-    }
     return container;
 }
 
+// A part in its container, over the container's glass. Loading the part's view loads its node's, which renders.
+- (void)putChild:(UIViewController *)child into:(UIView *)container {
+    if (!child) {
+        return;
+    }
+    [self addChildViewController:child];
+    child.view.frame = container.bounds;
+    child.view.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+    [container addSubview:child.view];
+    [child didMoveToParentViewController:self];
+}
+
+// The menu's part goes into its container and renders, once: with the side menu's view (`together`), after its first
+// appearance (`afterCenter`), or as the menu first starts to open (`onOpen`, and any mode for a menu that opens
+// earlier). A menu not attached yet keeps its node and options; only its view and content wait.
+- (void)attachMenu:(ANNSideMenuSide)side {
+    ANNSideMenuChildViewController *menu = [self menuOf:side];
+    if (!menu || [self stateOf:side].attached || self.nodeHelper.destroyed) {
+        return;
+    }
+    [self loadViewIfNeeded];
+    ANNSideMenuSideState *state = [self stateOf:side];
+    if (state.attached) {
+        return;
+    }
+    state.attached = YES;
+    [self putChild:menu into:[self containerOf:side]];
+    [menu render];
+}
+
+// The current part renders, and every other part that is attached or will be with the side menu's view.
 - (void)render {
     [self.nodeHelper render];
     UIViewController *currentChild = self.getCurrentChild;
     for (UIViewController *vc in _sideMenuChildren) {
-        if (vc != currentChild) {
+        if (vc != currentChild && [self rendersPart:vc]) {
             [vc render];
         }
     }
 }
 
+- (BOOL)rendersPart:(UIViewController *)part {
+    if (part == self.left) {
+        return _attachMode == ANNSideMenuAttachModeTogether || _leftState.attached;
+    }
+    if (part == self.right) {
+        return _attachMode == ANNSideMenuAttachModeTogether || _rightState.attached;
+    }
+    return YES;
+}
+
 #pragma mark - Options
 
 - (ANNSideMenuSideState *)stateOf:(ANNSideMenuSide)side {
@@ -380,6 +441,7 @@ typedef NS_ENUM(NSInteger, ANNSideMenuAppearance) {
 
 // The menu on screen in its place under or over the center, its screens about to appear.
 - (void)show:(ANNSideMenuSide)side {
+    [self attachMenu:side];
     _side = side;
     [self orderSide:side];
     [self containerOf:side].hidden = NO;
@@ -586,6 +648,13 @@ typedef NS_ENUM(NSInteger, ANNSideMenuAppearance) {
     if (_side != ANNSideMenuSideNone) {
         [self side:_side transitionEnded:YES];
     }
+    if (!_firstAppeared) {
+        _firstAppeared = YES;
+        if (_attachMode == ANNSideMenuAttachModeAfterCenter) {
+            [self attachMenu:ANNSideMenuSideLeft];
+            [self attachMenu:ANNSideMenuSideRight];
+        }
+    }
 }
 
 - (void)viewWillDisappear:(BOOL)animated {

package/ios/Layouts/Stack/ANNStackController.mm

@@ -3,6 +3,7 @@
 #import "ANNAppDirection.h"
 #import "ANNAppearanceDispatcher.h"
 #import "ANNAssert.h"
+#import "ANNBottomTabsController.h"
 #import "ANNComponentViewController.h"
 #import "ANNElementFinder.h"
 #import "ANNErrorTexts.h"
@@ -1175,10 +1176,12 @@ static const CGFloat ANNOwnSwipeEdgeWidth = 20;
     return self;
 }
 
-// In More the More navigation is what shows the screens.
+// In More the More navigation is what shows the screens. A tab rendered before it shows is in a window while its
+// screens render there, and not on screen.
 - (BOOL)stackIsOnScreen {
     return self.shownNavigationController.viewIfLoaded.window != nil &&
-           ![ANNPendingLayers isWaitingToShow:self];
+           ![ANNPendingLayers isWaitingToShow:self] &&
+           ![ANNBottomTabsController isInUnseenTab:self];
 }
 
 // Only the stack's own transitions (a push, a pop, a replace of its view controllers, the interactive pop): a

package/ios/Layouts/Stack/ANNStackQueue.h

@@ -60,7 +60,8 @@ typedef NS_ENUM(NSInteger, ANNStackChange) {
 /// The stack's own view controller: the layout parent of the nodes it took and doesn't show yet.
 - (UIViewController *)stackViewController;
 
-/// The stack is seen: its view is in a window, and it isn't inside a layer that waits to show (`ANNPendingLayers`).
+/// The stack is seen: its view is in a window, and it isn't inside a layer that waits to show (`ANNPendingLayers`) nor
+/// in a tab that renders before it shows (`isInUnseenTab:` of the tabs).
 - (BOOL)stackIsOnScreen;
 
 /// A transition UIKit runs on the stack now (one the queue didn't start); nil when none runs.

package/ios/Layouts/Tabs/ANNBottomTabsController.h

@@ -45,6 +45,9 @@ typedef NS_ENUM(NSInteger, ANNTabPressSource) {
 /// The nearest tabs among the layout parents of `node` (not `node` itself); nil out of tabs.
 + (nullable ANNBottomTabsController *)tabsOf:(UIViewController *)node;
 
+/// `node` is in a tab rendered before it shows, which renders its content in its tabs' view: in a window, not shown.
++ (BOOL)isInUnseenTab:(UIViewController *)node;
+
 /// The tabs in layout order.
 @property(nonatomic, copy, readonly) NSArray<UIViewController *> *layoutTabs;
 

package/ios/Layouts/Tabs/ANNBottomTabsController.mm

@@ -7,15 +7,17 @@
 #import "ANNMoreNavigationDelegate.h"
 #import "ANNNavigationState.h"
 #import "ANNNodeRegistry.h"
+#import "ANNParking.h"
 #import "ANNPendingLayers.h"
 #import "ANNScreenBars.h"
+#import "ANNScreenPlace.h"
 #import "ANNScrollToTop.h"
 #import "ANNShownScreens.h"
 #import "ANNStackController.h"
+#import "ANNStackQueue.h"
 #import "ANNSystemUI.h"
 #import "ANNTabLongPress.h"
 #import "ANNTabsDesign.h"
-#import "ANNTabsPreloadWindow.h"
 #import "InteractivePopGestureDelegate.h"
 #import <React/RCTLog.h>
 
@@ -23,13 +25,17 @@
 // waits for it; the drive only must not stay).
 static const NSTimeInterval ANNSwitchDriveLimit = 2;
 
-// How long a step of `afterInitialTab` waits for its tab's root to mount before the next one starts, and how long a
-// lent React view stays in the preload window at most without mounting.
+// How long a step of `afterInitialTab` waits for its tab's root to mount before the next one starts.
 static const NSTimeInterval ANNTabMountLimit = 0.5;
 
 // The key of the tabs' ready handlers on the screens of their selected tab (`afterInitialTab`).
 static NSString *const ANNTabsReadyKey = @"ApexNavigation.tabs";
 
+// The key of the tabs' ready handlers on the screens of a parked tab, and the longest such a tab waits for them in the
+// parking: past it, its screens render their content where the tab shows.
+static NSString *const ANNTabsUnseenKey = @"ApexNavigation.tabs.unseen";
+static const NSTimeInterval ANNUnseenRenderLimit = 5;
+
 // Whether UIKit pops the stack of a tab tapped again itself: the core answers "select" and lets it. NO would make the
 // core pop it for every source and answer "don't" (the simulator decides).
 static const BOOL ANNUIKitPopsOnRepeatPress = YES;
@@ -81,8 +87,12 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     // The `UITab` of each tab, in layout order (iOS 18 and later).
     NSArray *_uiTabs;
     NSHashTable<UIViewController *> *_renderedTabs;
-    ANNTabsPreloadWindow *_preloadWindow;
-    NSHashTable<ANNComponentViewController *> *_lentScreens;
+    // The tabs rendered before they show (`together`, the chain of `afterInitialTab`) wait unseen and hidden in the
+    // tabs' view until their screens rendered their content, as on Android: a screen's safe area view lays out only in
+    // a window. They leave it then, since the core takes a view in a window for one that shows, and their screens keep
+    // the place they rendered at until they appear. Those not parked yet wait for the tabs' view in a window.
+    ANNParking *_unseenParking;
+    NSHashTable<UIViewController *> *_tabsToPark;
     // The chain of `afterInitialTab`: started once; a destroy ends it by its number.
     BOOL _chainStarted;
     NSUInteger _chainNumber;
@@ -137,7 +147,8 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     if (self) {
         _tabs = [childViewControllers copy] ?: @[];
         _renderedTabs = [NSHashTable weakObjectsHashTable];
-        _lentScreens = [NSHashTable weakObjectsHashTable];
+        _unseenParking = [ANNParking new];
+        _tabsToPark = [NSHashTable weakObjectsHashTable];
         _staleTabs = [NSHashTable weakObjectsHashTable];
         _pressedIndex = NSNotFound;
         _codeChoiceIndex = NSNotFound;
@@ -444,7 +455,7 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
 }
 
 // The selected tab's waited screens by the command's rule; with `together` the top screen of every other tab too, by
-// the first mount of its root (More's tabs too).
+// its content rendered unseen (More's tabs too).
 - (NSArray<UIViewController *> *)waitedComponentViewControllers {
     NSMutableArray<UIViewController *> *screens =
         [[[self selectedTabNode] waitedComponentViewControllers] mutableCopy]
@@ -464,7 +475,7 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
 
 - (ANNWaitedReadiness)waitedReadinessOfScreen:(UIViewController *)screen {
     NSUInteger index = [self indexOfTabHolding:screen];
-    return index != NSNotFound && index != _selectedTabIndex ? ANNWaitedReadinessRootMounted
+    return index != NSNotFound && index != _selectedTabIndex ? ANNWaitedReadinessUnseen
                                                              : ANNWaitedReadinessContent;
 }
 
@@ -474,12 +485,12 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     if (self.nodeHelper.destroyed) {
         return;
     }
-    [self renderTabAtIndex:_selectedTabIndex preloading:NO];
+    [self renderTabAtIndex:_selectedTabIndex unseen:NO];
     switch (_attachMode) {
         case ANNTabsAttachModeTogether:
             for (NSUInteger index = 0; index < _tabs.count; index++) {
                 if (index != _selectedTabIndex) {
-                    [self renderTabAtIndex:index preloading:YES];
+                    [self renderTabAtIndex:index unseen:YES];
                 }
             }
             break;
@@ -561,6 +572,10 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     }
     [_longPress detach];
     [self.nodeHelper unregisterNode];
+    [_tabsToPark removeAllObjects];
+    for (UIViewController *tab in _unseenParking.parkedNodes) {
+        [self unparkTab:tab showing:NO];
+    }
     for (UIViewController *tab in _tabs) {
         @try {
             [tab destroy];
@@ -569,7 +584,6 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
                        tab.layoutInfo.componentId ?: @"", exception.reason ?: exception.name);
         }
     }
-    [self closePreloadWindow];
     [[self tabsPresenter] tabsWillGo];
     [_components stopAll];
 }
@@ -591,6 +605,13 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
         [[self tabsPresenter] barDidLayOutInWindow];
     }
     [[self tabsPresenter] tabsDidLayOut];
+    // A tab UIKit shows by a way of its own leaves the parking too.
+    UIViewController *shown = self.selectedViewController;
+    if (shown && [_unseenParking isParked:shown]) {
+        [self unparkTab:shown showing:YES];
+    }
+    [self layOutParkedTabs];
+    [self parkUnseenTabs];
 }
 
 - (void)viewWillAppear:(BOOL)animated {
@@ -605,9 +626,10 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     [[self tabsPresenter] tabsDidAppear];
 }
 
-#pragma mark - Rendering and the preload window
+#pragma mark - Rendering
 
-- (void)renderTabAtIndex:(NSUInteger)index preloading:(BOOL)preloading {
+// A tab renders once. `unseen`: it renders before it shows, and waits in the parking until then.
+- (void)renderTabAtIndex:(NSUInteger)index unseen:(BOOL)unseen {
     if (index >= _tabs.count) {
         return;
     }
@@ -617,62 +639,202 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     }
     [_renderedTabs addObject:tab];
     [tab render];
-    if (preloading) {
-        [self lendTopOfTabAtIndex:index];
+    if (unseen) {
+        [_tabsToPark addObject:tab];
+        [self parkUnseenTabs];
     }
 }
 
-// The React view of the tab's top screen mounts in the preload window and comes back into its screen at its mount or
-// when its tab first shows, whichever comes first; a native screen stays where it is.
-- (void)lendTopOfTabAtIndex:(NSUInteger)index {
-    UIViewController *node = [self screenOfTabAtIndex:index];
-    if (![node isKindOfClass:ANNComponentViewController.class]) {
+// The tabs rendered unseen go into the parking once the tabs' view is in a window, at the back of it and hidden, so
+// that a switch's transition never shows them; the shown tab never, nor a tab with nothing to render (native screens).
+- (void)parkUnseenTabs {
+    if (_tabsToPark.count == 0 || !self.viewIfLoaded.window || self.nodeHelper.destroyed) {
         return;
     }
-    ANNComponentViewController *screen = (ANNComponentViewController *)node;
-    UIView<ANNComponentProtocol> *content = screen.reactView;
-    if (![content respondsToSelector:@selector(whenMounted:)] || content.hasMounted) {
-        return;
+    UIViewController *shown = self.selectedViewController;
+    UIViewController *selected = [self selectedTabNode];
+    for (UIViewController *tab in _tabsToPark.allObjects) {
+        [_tabsToPark removeObject:tab];
+        if (tab == shown || tab == selected || tab.viewIfLoaded.window ||
+            [_unseenParking isParked:tab]) {
+            continue;
+        }
+        NSArray<ANNComponentViewController *> *screens = [self unrenderedScreensOfTab:tab];
+        if (screens.count == 0) {
+            continue;
+        }
+        [_unseenParking park:tab inView:self.view];
+        tab.view.hidden = YES;
+        [self layOutParkedTabs];
+        [self placeScreensOfParkedTab:tab shownFirst:screens];
+        [self unparkTab:tab whenScreensRender:screens];
     }
-    if (!_preloadWindow) {
-        _preloadWindow = [ANNTabsPreloadWindow preloadWindow];
+}
+
+// The screens the tab shows first whose content didn't render yet.
+- (NSArray<ANNComponentViewController *> *)unrenderedScreensOfTab:(UIViewController *)tab {
+    NSMutableArray<ANNComponentViewController *> *screens = [NSMutableArray new];
+    for (UIViewController *node in [tab waitedComponentViewControllers]) {
+        if (![node isKindOfClass:ANNComponentViewController.class]) {
+            continue;
+        }
+        ANNComponentViewController *screen = (ANNComponentViewController *)node;
+        if (screen.reactView && !screen.reactView.isReady) {
+            [screens addObject:screen];
+        }
     }
-    if (![screen lendContentTo:_preloadWindow]) {
+    return screens;
+}
+
+// A parked tab lays out where the shown tab is: beside the sidebar on iPad too.
+- (void)layOutParkedTabs {
+    UIView *shownView = self.selectedViewController.viewIfLoaded;
+    if (!shownView.window) {
         return;
     }
-    [_lentScreens addObject:screen];
+    CGRect frame = [self.view convertRect:shownView.bounds fromView:shownView];
+    for (UIViewController *tab in _unseenParking.parkedNodes) {
+        UIView *view = tab.viewIfLoaded;
+        if (view && !CGRectEqualToRect(view.frame, frame)) {
+            view.frame = frame;
+        }
+    }
+}
+
+// UIKit gives the views of a tab not shown no safe area: the screens on top of its stacks lay out with their place
+// there, measured in the view of what the tabs show (`ANNScreenPlace`), the safe area and bars they get as the tab
+// shows. A screen the tab shows first keeps the place it rendered at until it appears: as the tab shows, UIKit first
+// gives it a part of its safe area (the bar without the status bar). The others (a closed side menu's) keep it until
+// UIKit gives them a safe area of their own.
+- (void)placeScreensOfParkedTab:(UIViewController *)tab
+                     shownFirst:(NSArray<ANNComponentViewController *> *)shownFirst {
+    NSHashTable<ANNComponentViewController *> *placed = [NSHashTable weakObjectsHashTable];
+    NSMutableArray<ANNStackController *> *stacks = [NSMutableArray new];
+    ANNStacksOfNode(tab, stacks);
+    for (ANNStackController *stack in stacks) {
+        UIViewController *top = stack.topViewController;
+        for (ANNComponentViewController *screen in top ? ANNStackScreensOfEntry(top) : @[]) {
+            [self placeScreen:screen
+                        onTop:top
+                      ofStack:stack
+                  ofParkedTab:tab
+                         kept:[shownFirst containsObject:screen]];
+            [placed addObject:screen];
+        }
+    }
+    for (ANNComponentViewController *screen in shownFirst) {
+        if (![placed containsObject:screen]) {
+            [self placeScreen:screen onTop:nil ofStack:nil ofParkedTab:tab kept:YES];
+        }
+    }
+}
+
+// The place of one screen of a parked tab: on top of its stack, or a screen of its own. A screen covered since it
+// rendered (a push onto its stack before the tab showed) lays out with its own safe area.
+- (void)placeScreen:(ANNComponentViewController *)screen
+              onTop:(nullable UIViewController *)top
+            ofStack:(nullable UINavigationController *)stack
+        ofParkedTab:(UIViewController *)tab
+               kept:(BOOL)kept {
     __weak ANNBottomTabsController *weakSelf = self;
+    __weak UIViewController *weakTab = tab;
     __weak ANNComponentViewController *weakScreen = screen;
-    [content whenMounted:^{
-      [weakSelf takeBack:weakScreen];
-    }];
-    // A root that never mounts goes back anyway: it renders where its tab shows.
-    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(ANNTabMountLimit * 2 * NSEC_PER_SEC)),
+    __weak UINavigationController *weakStack = stack;
+    __weak UIViewController *weakTop = top;
+    BOOL inStack = stack != nil;
+    __block ANNScreenPlace *last = nil;
+    screen.placeWhileParked = ^ANNScreenPlace * {
+      ANNComponentViewController *placed = weakScreen;
+      UINavigationController *placedStack = weakStack;
+      UIViewController *entry = weakTop;
+      if (inStack && (!placedStack || !entry || placedStack.topViewController != entry)) {
+          return nil;
+      }
+      UIView *host = [weakSelf placeHostForTab:weakTab];
+      if (!placed || !host) {
+          return last;
+      }
+      ANNScreenPlace *measured =
+          inStack ? [ANNScreenPlace placeOfEntry:entry
+                                         inStack:placedStack
+                                      measuredIn:host
+                                         options:[ANNStackOptionsScreen(entry)
+                                                     resolveOptionsWithDefault]]
+                  : [ANNScreenPlace placeOfScreen:placed measuredIn:host];
+      if (measured) {
+          last = measured;
+      }
+      return last;
+    };
+    screen.placeKeptUntilAppearance = kept;
+    [screen updateRootLayout];
+}
+
+// Where the screens of a tab rendered unseen measure their place: the view of what the tabs show now (UIKit's More
+// navigation too). Nil once the tab itself shows.
+- (nullable UIView *)placeHostForTab:(UIViewController *)tab {
+    UIViewController *shown = self.selectedViewController;
+    UIView *host = shown.viewIfLoaded;
+    UIView *tabView = tab.viewIfLoaded;
+    if (!tab || !host.window || shown == tab || [self selectedTabNode] == tab ||
+        (tabView && [host isDescendantOfView:tabView])) {
+        return nil;
+    }
+    return host;
+}
+
+// The parked tab leaves the parking once every screen it waits for rendered its content, or at the limit.
+- (void)unparkTab:(UIViewController *)tab
+    whenScreensRender:(NSArray<ANNComponentViewController *> *)screens {
+    __weak ANNBottomTabsController *weakSelf = self;
+    __weak UIViewController *weakTab = tab;
+    NSHashTable<ANNComponentViewController *> *waited = [NSHashTable weakObjectsHashTable];
+    for (ANNComponentViewController *screen in screens) {
+        [waited addObject:screen];
+    }
+    for (ANNComponentViewController *screen in screens) {
+        [screen
+            setReadyHandler:^{
+              for (ANNComponentViewController *other in waited.allObjects) {
+                  if (other.reactView && !other.reactView.isReady) {
+                      return;
+                  }
+              }
+              [weakSelf unparkTab:weakTab showing:NO];
+            }
+                     forKey:ANNTabsUnseenKey];
+    }
+    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(ANNUnseenRenderLimit * NSEC_PER_SEC)),
                    dispatch_get_main_queue(), ^{
-                     [weakSelf takeBack:weakScreen];
+                     [weakSelf unparkTab:weakTab showing:NO];
                    });
 }
 
-- (void)takeBack:(ANNComponentViewController *)screen {
-    if (screen) {
-        [screen takeContentBack];
-        [_lentScreens removeObject:screen];
+// The tab rendered, is about to show, or the tabs go: it leaves the parking, and UIKit places its view as it shows it.
+// `showing`: it shows in this turn, so UIKit's departure of a tab without a parent (More's, with the tab API) ends
+// here.
+- (void)unparkTab:(UIViewController *)tab showing:(BOOL)showing {
+    if (!tab) {
+        return;
     }
-    for (ANNComponentViewController *lent in _lentScreens.allObjects) {
-        if (lent.contentIsLent) {
-            return;
-        }
+    [_tabsToPark removeObject:tab];
+    if (![_unseenParking isParked:tab]) {
+        return;
     }
-    [self closePreloadWindow];
+    tab.viewIfLoaded.hidden = NO;
+    [_unseenParking unpark:tab endingDeparture:showing && !tab.parentViewController];
 }
 
-- (void)closePreloadWindow {
-    for (ANNComponentViewController *screen in _lentScreens.allObjects) {
-        [screen takeContentBack];
++ (BOOL)isInUnseenTab:(UIViewController *)node {
+    UIViewController *child = node;
+    for (UIViewController *parent = node.layoutParent; parent;
+         child = parent, parent = parent.layoutParent) {
+        if ([parent isKindOfClass:ANNBottomTabsController.class] &&
+            [((ANNBottomTabsController *)parent)->_unseenParking isParked:child]) {
+            return YES;
+        }
     }
-    [_lentScreens removeAllObjects];
-    [_preloadWindow close];
-    _preloadWindow = nil;
+    return NO;
 }
 
 // `afterInitialTab`: the selected tab's shown screens ready (by their content), then the others one by one.
@@ -739,7 +901,7 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     if (next == NSNotFound) {
         return;
     }
-    [self renderTabAtIndex:next preloading:YES];
+    [self renderTabAtIndex:next unseen:YES];
     __block BOOL stepped = NO;
     __weak ANNBottomTabsController *weakSelf = self;
     dispatch_block_t step = ^{
@@ -769,8 +931,17 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     if (index >= _tabs.count) {
         return;
     }
-    [self renderTabAtIndex:index preloading:NO];
+    [self renderTabAtIndex:index unseen:NO];
     UIViewController *tab = _tabs[index];
+    // Its screens rendered unseen measure their place once more while the tab that shows now is still the host: the
+    // device may have turned since, or the shown tab laid out again.
+    for (UIViewController *node in [tab waitedComponentViewControllers]) {
+        if ([node isKindOfClass:ANNComponentViewController.class] &&
+            ((ANNComponentViewController *)node).placeKeptUntilAppearance) {
+            [(ANNComponentViewController *)node updateRootLayout];
+        }
+    }
+    [self unparkTab:tab showing:YES];
     if ([_staleTabs containsObject:tab]) {
         [_staleTabs removeObject:tab];
         [ANNBottomTabsPresenter repaintNode:tab];

package/ios/Options/ANNSideMenuOptions.h

@@ -12,6 +12,8 @@ NS_ASSUME_NONNULL_BEGIN
 @property(nonatomic, strong) Text *openGestureMode;
 /// `'parallax'`, `'slide'`, `'slide-and-scale'` or `'door'`.
 @property(nonatomic, strong) Text *animationType;
+/// `'together'`, `'afterCenter'` or `'onOpen'`.
+@property(nonatomic, strong) Text *menusAttachMode;
 @property(nonatomic, strong) Text *testID;
 
 @end

package/ios/Options/ANNSideMenuOptions.mm

@@ -9,6 +9,8 @@
         [ANNOptionField enumField:@"openGestureMode" values:@[ @"bezel", @"entireScreen" ]],
         [ANNOptionField enumField:@"animationType"
                            values:@[ @"parallax", @"slide", @"slide-and-scale", @"door" ]],
+        [ANNOptionField enumField:@"menusAttachMode"
+                           values:@[ @"together", @"afterCenter", @"onOpen" ]],
         [ANNOptionField textField:@"testID"],
     ];
 }

package/ios/React/ANNSafeAreaViewComponentView.mm

@@ -128,8 +128,8 @@ using namespace facebook::react;
 
 // The screen renders its content once this view is laid out in its place with a size, as
 // react-native-safe-area-context does: a list that is there before the first layout of the top bar
-// makes UIKit start the large title collapsed. The preload window of tabs attached together has no
-// size: a tab renders its content where it shows.
+// makes UIKit start the large title collapsed. A tab rendered before it shows lays out in the
+// tabs' view, unseen, and renders its content there.
 - (void)sendReadyIfLaidOut {
     if (_readySent || _eventEmitter == nullptr || self.superview == nil) {
         return;

package/ios/React/Slots/ANNSlotHost.mm

@@ -35,9 +35,7 @@ static RCTFabricSurface *ANNSlotHostSurface;
 
     // Hidden and without a root view controller: it takes no touches and has no say in the orientation or the status
     // bar (a visible window above the app does). The tree still mounts; the slots move their content into screens.
-    UIWindowScene *scene = ANNUtils.mainWindow.windowScene;
-    UIWindow *window = scene ? [[UIWindow alloc] initWithWindowScene:scene]
-                             : [[UIWindow alloc] initWithFrame:ANNUtils.mainScreen.bounds];
+    UIWindow *window = [ANNUtils makeWindowOfClass:UIWindow.class];
     surfaceView.frame = window.bounds;
     [window addSubview:surfaceView];
     window.hidden = YES;