@apexnative/navigation 1.0.0-alpha.0 → 1.0.0-alpha.10

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 {
@@ -598,15 +619,17 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     [[self tabsPresenter] tabsDidLayOut];
 }
 
-// `afterInitialTab` goes on at the tabs' first appearance at the latest.
+// `afterInitialTab` goes on at the tabs' first appearance at the latest; a dot that waited for the window shows.
 - (void)viewDidAppear:(BOOL)animated {
     [super viewDidAppear:animated];
     [self scheduleChain];
+    [[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;
     }
@@ -616,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.
@@ -738,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 = ^{
@@ -768,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];
@@ -817,7 +989,7 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     if (index >= _tabs.count || self.nodeHelper.destroyed) {
         return NO;
     }
-    [self sendPendingSelected];
+    [self finishEarlierSelection];
     _pressedIndex = NSNotFound;
     // The release of a long press: UIKit would select the tab under the finger.
     if (source == ANNTabPressSourceBar && index == _longPressedIndex) {
@@ -957,6 +1129,14 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     [self sendPendingSelected];
 }
 
+// Before anything newer on these tabs (a press, a long press, a More pick, a choice from code): a switch still running
+// ends with its appearances and schedules its `Selected`, and a `Selected` still waiting goes, as Android's
+// `flushPendingSelected` does.
+- (void)finishEarlierSelection {
+    [self endSwitch];
+    [self sendPendingSelected];
+}
+
 - (void)sendPendingSelected {
     if (!_hasPendingSelected) {
         return;
@@ -980,8 +1160,8 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     if (index >= _tabs.count || self.nodeHelper.destroyed) {
         return;
     }
-    // A pending `Selected` goes before the event of a later press.
-    [self sendPendingSelected];
+    // A running switch and a pending `Selected` go before the event of a later press.
+    [self finishEarlierSelection];
     if (marksSelection) {
         _longPressedIndex = index;
     }
@@ -1024,7 +1204,7 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
 // first, then UIKit's, then the state at once.
 - (void)selectTabFromCode:(NSUInteger)index {
     ANNAssertMainQueue();
-    [self sendPendingSelected];
+    [self finishEarlierSelection];
     _pressedIndex = NSNotFound;
     if (index == _selectedTabIndex || index >= _tabs.count || self.nodeHelper.destroyed) {
         return;
@@ -1235,7 +1415,7 @@ static void ANNStacksOfNode(UIViewController *node, NSMutableArray<ANNStackContr
     if (pick && index == _selectedTabIndex) {
         return;
     }
-    [self sendPendingSelected];
+    [self finishEarlierSelection];
     _pressedIndex = NSNotFound;
     if (pick) {
         [self sendPressedOfTabAtIndex:index wasSelected:NO];

package/ios/Layouts/Tabs/ANNBottomTabsCustomRow.mm

@@ -126,8 +126,13 @@ static const CGFloat ANNWideRowMargin = 16;
     if (self.superview != host) {
         [host addSubview:self];
     }
-    [host bringSubviewToFront:self];
-    // The system bar keeps its place and shows nothing; UIKit makes its subviews anew on a size change.
+    if (host.subviews.lastObject != self) {
+        [host bringSubviewToFront:self];
+    }
+    // The system bar keeps its place and shows nothing; UIKit makes its subviews anew on a size change. Not the bar's
+    // `alpha`: UIKit puts it back to 1 when the bar shows, on a pop with `hidesBottomBarWhenPushed`, and on iOS 27 on
+    // a rotation and a theme change, after the tabs' layout (a check here misses it); alpha 0 also drops the system's
+    // soft fade at the bottom.
     for (UIView *subview in bar.subviews) {
         if (!subview.hidden) {
             subview.hidden = YES;
@@ -193,6 +198,7 @@ static const CGFloat ANNWideRowMargin = 16;
         extra = MAX(0, CGRectGetMinY(barFrame) - CGRectGetMinY(frame));
     }
     BOOL hidden = wide ? _hiddenByOptions : (tabs.barHidden || bar.hidden);
+    // A new size lays the cells out again by itself; the same frame changes nothing.
     if (!CGRectEqualToRect(self.frame, frame)) {
         self.frame = frame;
     }
@@ -203,7 +209,6 @@ static const CGFloat ANNWideRowMargin = 16;
         _background.layer.cornerRadius = radius;
     }
     [self setExtraSafeArea:hidden ? 0 : extra];
-    [self setNeedsLayout];
 }
 
 - (void)setHiddenByOptions:(BOOL)hiddenByOptions {

package/ios/Layouts/Tabs/ANNBottomTabsPresenter.h

@@ -10,8 +10,8 @@ NS_ASSUME_NONNULL_BEGIN
 /// `ANNBottomTabsController`.
 @interface ANNBottomTabsPresenter : ANNNodePresenter
 
-/// The repaint of a node the repaint pass left (a tab not in a window): its subtree, children first, with their
-/// resolved options.
+/// The repaint of a node the repaint pass left (a tab not in a window), as it is about to show: the nodes of its
+/// subtree whose views are in its view (what shows with it), children first, with their resolved options.
 + (void)repaintNode:(UIViewController *)node;
 
 #pragma mark - Creation, in this order
@@ -55,6 +55,10 @@ NS_ASSUME_NONNULL_BEGIN
 /// The tabs laid out (and before they appear): the dots, the buttons' `testID`s, the custom row.
 - (void)tabsDidLayOut;
 
+/// The tabs appeared, in a window: a dot set while they were out of it (under a modal over the whole screen) is
+/// placed now, as no layout may follow.
+- (void)tabsDidAppear;
+
 /// The bar laid out in a window for the first time: the titles are set again, so that the bar measures them at their
 /// real place.
 - (void)barDidLayOutInWindow;