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

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/lib/typescript/interfaces/options/bottomTabs.d.ts

@@ -204,7 +204,8 @@ export interface OptionsBottomTabs {
      * When the screens of the tabs are created: `'together'` creates and draws every tab at the start, and the tabs are
      * ready when all of them are; `'afterInitialTab'` creates the selected tab first and the others right after it;
      * `'onSwitchToTab'` creates a tab the first time it is selected. The screens of tabs not yet selected get no appear
-     * events in any mode. It applies when the tabs are created; `mergeOptions` does not change it.
+     * events in any mode. On iOS a text input's `autoFocus` in a tab drawn before it is selected does nothing: focus it in
+     * `useScreenAppear`. It applies when the tabs are created; `mergeOptions` does not change it.
      * @default 'together'
      */
     tabsAttachMode?: 'together' | 'afterInitialTab' | 'onSwitchToTab';

package/lib/typescript/interfaces/options/bottomTabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bottomTabs.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/options/bottomTabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAU,CAAC;AAExF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,oHAAoH;IACpH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,SAAS,CAAC,EAAE,mCAAmC,CAAC;IAChD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACtC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,UAAU,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAClE;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,YAAY,GAAG,gBAAgB,GAAG,YAAY,GAAG,qBAAqB,CAAC;IAC1F,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,cAAc,GAAG,YAAY,CAAC;IACzE,iDAAiD;IACjD,eAAe,CAAC,EAAE,0BAA0B,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB;;OAEG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAC1B,oCAAoC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,EACD,QAAQ,GACR,WAAW,GACX,UAAU,GACV,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,UAAU,CAAC;IACf;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC5E;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}
+{"version":3,"file":"bottomTabs.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/options/bottomTabs.ts"],"names":[],"mappings":"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"}

package/lib/typescript/interfaces/options/sideMenu.d.ts

@@ -92,6 +92,8 @@ export type SideMenuOpenGestureMode = 'bezel' | 'entireScreen';
  * the center.
  */
 export type SideMenuAnimationType = 'parallax' | 'slide' | 'slide-and-scale' | 'door';
+/** When the screens of the menus of a side menu are created: see `sideMenu.menusAttachMode`. */
+export type SideMenuAttachMode = 'together' | 'afterCenter' | 'onOpen';
 /**
  * The options of a side menu: a center with a menu on the left, on the right or on both sides. They are set in the
  * options of the side menu, in the options of the screens inside it (through `mergeOptions` or the screen definition)
@@ -119,6 +121,20 @@ export interface OptionsSideMenu {
      * the center moves. It does nothing in `'aboveContent'` mode. A change applies at once. Android doesn't read it.
      */
     animationType?: SideMenuAnimationType;
+    /**
+     * When the screens of the menus are created, together with their React content: `'together'` creates them with the
+     * center; `'afterCenter'` creates them right after the center first appears, so they don't compete with its first
+     * render and still show at once on the first open; `'onOpen'` creates a menu the first time it starts to open — from
+     * a swipe, from `visible: true` or from `visible` in the layout — and until React draws its screen the menu shows its
+     * background. A command to a screen of a menu not created yet works: a push into its stack and `mergeOptions` wait
+     * for the menu like a tab not yet selected. The screens of a menu get appear events only when it opens, in every
+     * mode. With `appProvider` the screens render in the app's React tree at once in every mode, and the mode delays only
+     * their native containers. On iOS a menu's test identifier (`<testID>.left`, `<testID>.right`) is there once the menu
+     * is created; on Android from the start. It applies when the side menu is created, from its own options or the default options;
+     * `mergeOptions` does not change it.
+     * @default 'together'
+     */
+    menusAttachMode?: SideMenuAttachMode;
     /**
      * The test identifier of the side menu's container (on iOS its view, on Android the drawer). The parts derive from
      * it: `<testID>.center`, `<testID>.left`, `<testID>.right`, and on iOS `<testID>.scrim` for the dimming over the

package/lib/typescript/interfaces/options/sideMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sideMenu.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/options/sideMenu.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC;IAC1C;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,cAAc,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,OAAO,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,sBAAsB;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"sideMenu.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/options/sideMenu.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC;IAC1C;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,cAAc,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,OAAO,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAEtF,gGAAgG;AAChG,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,sBAAsB;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apexnative/navigation",
-  "version": "1.0.0-alpha.8",
+  "version": "1.0.0-alpha.9",
   "description": "Native navigation for React Native: platform stacks, tabs, modals and side menus on iOS, iPadOS and Android",
   "keywords": [
     "react-native",

package/src/interfaces/options/bottomTabs.ts

@@ -211,7 +211,8 @@ export interface OptionsBottomTabs {
    * When the screens of the tabs are created: `'together'` creates and draws every tab at the start, and the tabs are
    * ready when all of them are; `'afterInitialTab'` creates the selected tab first and the others right after it;
    * `'onSwitchToTab'` creates a tab the first time it is selected. The screens of tabs not yet selected get no appear
-   * events in any mode. It applies when the tabs are created; `mergeOptions` does not change it.
+   * events in any mode. On iOS a text input's `autoFocus` in a tab drawn before it is selected does nothing: focus it in
+   * `useScreenAppear`. It applies when the tabs are created; `mergeOptions` does not change it.
    * @default 'together'
    */
   tabsAttachMode?: 'together' | 'afterInitialTab' | 'onSwitchToTab';

package/src/interfaces/options/sideMenu.ts

@@ -95,6 +95,9 @@ export type SideMenuOpenGestureMode = 'bezel' | 'entireScreen';
  */
 export type SideMenuAnimationType = 'parallax' | 'slide' | 'slide-and-scale' | 'door';
 
+/** When the screens of the menus of a side menu are created: see `sideMenu.menusAttachMode`. */
+export type SideMenuAttachMode = 'together' | 'afterCenter' | 'onOpen';
+
 /**
  * The options of a side menu: a center with a menu on the left, on the right or on both sides. They are set in the
  * options of the side menu, in the options of the screens inside it (through `mergeOptions` or the screen definition)
@@ -122,6 +125,20 @@ export interface OptionsSideMenu {
    * the center moves. It does nothing in `'aboveContent'` mode. A change applies at once. Android doesn't read it.
    */
   animationType?: SideMenuAnimationType;
+  /**
+   * When the screens of the menus are created, together with their React content: `'together'` creates them with the
+   * center; `'afterCenter'` creates them right after the center first appears, so they don't compete with its first
+   * render and still show at once on the first open; `'onOpen'` creates a menu the first time it starts to open — from
+   * a swipe, from `visible: true` or from `visible` in the layout — and until React draws its screen the menu shows its
+   * background. A command to a screen of a menu not created yet works: a push into its stack and `mergeOptions` wait
+   * for the menu like a tab not yet selected. The screens of a menu get appear events only when it opens, in every
+   * mode. With `appProvider` the screens render in the app's React tree at once in every mode, and the mode delays only
+   * their native containers. On iOS a menu's test identifier (`<testID>.left`, `<testID>.right`) is there once the menu
+   * is created; on Android from the start. It applies when the side menu is created, from its own options or the default options;
+   * `mergeOptions` does not change it.
+   * @default 'together'
+   */
+  menusAttachMode?: SideMenuAttachMode;
   /**
    * The test identifier of the side menu's container (on iOS its view, on Android the drawer). The parts derive from
    * it: `<testID>.center`, `<testID>.left`, `<testID>.right`, and on iOS `<testID>.scrim` for the dimming over the

package/ios/Layouts/Tabs/ANNTabsPreloadWindow.h

@@ -1,27 +0,0 @@
-#import <UIKit/UIKit.h>
-
-NS_ASSUME_NONNULL_BEGIN
-
-/// Where the React views of unselected tabs mount while the tabs render: a window of zero size that clips what it
-/// holds, hidden from accessibility, in the scene of the navigation's main window. Nothing in it is seen and its safe
-/// area views never lay out there: a tab renders its content where it shows. One per tabs node; it goes when it holds
-/// nothing more or with its tabs. Main queue.
-@interface ANNTabsPreloadWindow : UIWindow
-
-/// A new window in the scene of the main window; when the main window has no scene yet, it joins the scene as the main
-/// window connects (`mainWindowSceneDidConnect:`), before it holds anything that could be seen.
-+ (instancetype)preloadWindow;
-
-/// The main window connected to its scene: every live preload window joins it.
-+ (void)mainWindowSceneDidConnect:(UIWindowScene *)windowScene;
-
-/// A reload of the JavaScript: every live preload window hides at once; its views go with their old tabs after the
-/// reload's hold.
-+ (void)hideAllAfterReload;
-
-/// The window goes: it hides and leaves its scene. Its views are the tabs' to take back first.
-- (void)close;
-
-@end
-
-NS_ASSUME_NONNULL_END