@apexnative/navigation 0.0.0-stage → 1.0.0-alpha.0

package/ios/TopBar/ANNSearchResultsViewController.mm

@@ -0,0 +1,56 @@
+#import "ANNSearchResultsViewController.h"
+#import "ANNScreenInsets.h"
+
+@implementation ANNSearchResultsViewController {
+    NSString *_componentId;
+    ANNEventEmitter *_eventEmitter;
+}
+
+- (instancetype)initWithReactView:(ANNReactView *)reactView
+                      componentId:(NSString *)componentId
+                     eventEmitter:(ANNEventEmitter *)eventEmitter {
+    self = [super initWithNibName:nil bundle:nil];
+    _reactView = reactView;
+    _componentId = [componentId copy];
+    _eventEmitter = eventEmitter;
+    return self;
+}
+
+- (void)viewDidLoad {
+    [super viewDidLoad];
+    self.view.backgroundColor = UIColor.systemBackgroundColor;
+    _reactView.backgroundColor = UIColor.clearColor;
+    [self.view addSubview:_reactView];
+}
+
+// The component covers the whole screen of results, so its background fills it: laid out inside the safe area, it left
+// the system background under the bar and at the bottom. It keeps its content clear of them itself, as a list does
+// with contentInsetAdjustmentBehavior, or with useSafeAreaInsets; its safe area view does not pad it.
+- (void)viewDidLayoutSubviews {
+    [super viewDidLayoutSubviews];
+    _reactView.frame = self.view.bounds;
+    if (_componentId) {
+        [ANNScreenInsets setInsets:self.view.safeAreaInsets
+                           padding:UIEdgeInsetsZero
+                       forScreenId:_componentId
+                      eventEmitter:_eventEmitter];
+    }
+}
+
+// The component gets the lifecycle events of a screen each time the results show and hide.
+- (void)viewWillAppear:(BOOL)animated {
+    [super viewWillAppear:animated];
+    [_reactView componentWillAppear];
+}
+
+- (void)viewDidAppear:(BOOL)animated {
+    [super viewDidAppear:animated];
+    [_reactView componentDidAppear];
+}
+
+- (void)viewDidDisappear:(BOOL)animated {
+    [super viewDidDisappear:animated];
+    [_reactView componentDidDisappear];
+}
+
+@end

package/ios/TopBar/ANNShowTextButton.h

@@ -0,0 +1,22 @@
+#import "ANNButtonOptions.h"
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// A bar button that shows its icon and its text side by side (`topBar.leftButtons[].showText`): a `UIButton` of the
+/// plain configuration (icon padding 6 pt, the symbol in the Body style) that the bar sets on its glass as an icon. Its
+/// color doesn't change on a press (the glass shows the press); without a color it has the bar's label color. The icon
+/// is tinted as an icon button's: a symbol always, an image only with a color; `disableIconTint` or an image without a
+/// color keep their own colors. Disabled: 35 % dimmer, or the explicit disabled color alone.
+@interface ANNShowTextButton : UIButton
+
+/// `color` and `disabledColor` are the button's own over its side's; nil: the defaults above.
++ (instancetype)buttonWithOptions:(ANNButtonOptions *)options
+                            image:(UIImage *)image
+                         isSymbol:(BOOL)isSymbol
+                            color:(nullable UIColor *)color
+                    disabledColor:(nullable UIColor *)disabledColor;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/TopBar/ANNShowTextButton.mm

@@ -0,0 +1,63 @@
+#import "ANNShowTextButton.h"
+
+static const CGFloat ANNShowTextImagePadding = 6;
+static const CGFloat ANNShowTextDisabledAlpha = 0.35;
+
+@implementation ANNShowTextButton
+
++ (instancetype)buttonWithOptions:(ANNButtonOptions *)options
+                            image:(UIImage *)image
+                         isSymbol:(BOOL)isSymbol
+                            color:(UIColor *)color
+                    disabledColor:(UIColor *)disabledColor {
+    UIButtonConfiguration *configuration = [UIButtonConfiguration plainButtonConfiguration];
+    configuration.imagePadding = ANNShowTextImagePadding;
+    configuration.preferredSymbolConfigurationForImage =
+        [UIImageSymbolConfiguration configurationWithTextStyle:UIFontTextStyleBody];
+    BOOL ownColors = [options.disableIconTint withDefault:NO] || (!isSymbol && !color);
+    UIFont *font = [options.font
+        fontWithPlaceFont:[UIFont preferredFontForTextStyle:UIFontTextStyleBody]]
+                       ?: [UIFont preferredFontForTextStyle:UIFontTextStyleBody];
+    NSString *text = [options.text withDefault:nil] ?: @"";
+    configuration.attributedTitle =
+        [[NSAttributedString alloc] initWithString:text attributes:@{NSFontAttributeName : font}];
+    UIColor *normal = color ?: UIColor.labelColor;
+    BOOL enabled = [options.enabled withDefault:YES];
+    UIColor *shown = normal;
+    if (!enabled) {
+        shown = disabledColor ?: [normal colorWithAlphaComponent:ANNShowTextDisabledAlpha];
+    }
+    configuration.baseForegroundColor = shown;
+    // The icon carries its color itself, as an original image: the tint a bar gives the template image of a custom
+    // view (iOS 26 drew it black) doesn't reach it.
+    configuration.image =
+        ownColors ? [image imageWithRenderingMode:UIImageRenderingModeAlwaysOriginal]
+                  : [image imageWithTintColor:shown
+                                renderingMode:UIImageRenderingModeAlwaysOriginal];
+    // The plain configuration dims and highlights by itself: the colors above are the ones shown in every state.
+    configuration.titleTextAttributesTransformer = ^NSDictionary<NSAttributedStringKey, id> *(
+        NSDictionary<NSAttributedStringKey, id> *attributes) {
+      NSMutableDictionary<NSAttributedStringKey, id> *fixed = [attributes mutableCopy];
+      fixed[NSForegroundColorAttributeName] = shown;
+      return fixed;
+    };
+    ANNShowTextButton *button = [self buttonWithConfiguration:configuration primaryAction:nil];
+    button.configurationUpdateHandler = ^(UIButton *updated) {
+      UIButtonConfiguration *same = updated.configuration;
+      same.baseForegroundColor = shown;
+      updated.configuration = same;
+    };
+    button.enabled = enabled;
+    NSString *testID = [options.testID withDefault:nil];
+    if (testID.length > 0) {
+        button.accessibilityIdentifier = testID;
+    }
+    NSString *label = [options.accessibilityLabel withDefault:nil];
+    if (label.length > 0) {
+        button.accessibilityLabel = label;
+    }
+    [button sizeToFit];
+    return button;
+}
+
+@end

package/ios/TopBar/ANNTitleComponentView.h

@@ -0,0 +1,37 @@
+#import "ANNReactView.h"
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// The container of a React title (`topBar.title.component`) in the item's `titleView`. It takes a content view
+/// (`UIView<ANNComponentProtocol>`), never a class of the roots, so another source of content can plug in later.
+/// `center` (and unset): the size of the content, measured against unbounded space after every mount (Fabric reports no
+/// change of size); a size with a zero side or the one the view has is ignored, another calls `sizeDidChange`, which
+/// sets the view into the item again. `fill`: the frame the presenter gives (the row of the bar), the content laid out
+/// by the view's bounds. The core never measures or moves the views inside the content: only the surface's size is
+/// asked.
+@interface ANNTitleComponentView : UIView
+
+- (instancetype)initWithContent:(UIView<ANNComponentProtocol> *)content;
+
+- (instancetype)initWithFrame:(CGRect)frame NS_UNAVAILABLE;
+- (nullable instancetype)initWithCoder:(NSCoder *)coder NS_UNAVAILABLE;
+
+@property(nonatomic, strong, readonly) UIView<ANNComponentProtocol> *content;
+
+/// `fill`: the view takes the frame the presenter sets; otherwise the content's size.
+@property(nonatomic) BOOL fills;
+
+/// `fill`: the row the presenter placed the view in, the size it asks UIKit for; UIKit may narrow its frame between
+/// the side buttons. Zero until placed, and again when the view stops filling.
+@property(nonatomic) CGSize rowSize;
+
+/// Called after a mount changed the content's size (`center`).
+@property(nonatomic, copy, nullable) dispatch_block_t sizeDidChange;
+
+/// Measures the content again (after a mount or when the place changed).
+- (void)measure;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/TopBar/ANNTitleComponentView.mm

@@ -0,0 +1,86 @@
+#import "ANNTitleComponentView.h"
+
+// The key of the container's handler on the content's mounts.
+static NSString *const ANNTitleComponentMountKey = @"ANNTitleComponentView";
+
+@implementation ANNTitleComponentView {
+    CGSize _measured;
+}
+
+- (instancetype)initWithContent:(UIView<ANNComponentProtocol> *)content {
+    if (self = [super initWithFrame:CGRectZero]) {
+        _content = content;
+        self.backgroundColor = UIColor.clearColor;
+        content.autoresizingMask =
+            UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+        content.frame = self.bounds;
+        [self addSubview:content];
+        __weak ANNTitleComponentView *weakSelf = self;
+        [content setContentDidMount:^{
+          [weakSelf measure];
+        }
+                             forKey:ANNTitleComponentMountKey];
+        [self measure];
+    }
+    return self;
+}
+
+- (void)measure {
+    if (_fills) {
+        return;
+    }
+    RCTFabricSurface *surface = _content.surface;
+    if (!surface) {
+        return;
+    }
+    // A centred title shows at its own size: the content is measured against unbounded space.
+    CGSize maximum = CGSizeMake(CGFLOAT_MAX, CGFLOAT_MAX);
+    CGSize size = [surface sizeThatFitsMinimumSize:CGSizeZero maximumSize:maximum];
+    size = CGSizeMake(ceil(size.width), ceil(size.height));
+    // A content that has nothing to show for a moment (a render of `null`) keeps the last size, so the title doesn't
+    // vanish; a size the view already has doesn't set the view into the item again.
+    if (size.width <= 0 || size.height <= 0) {
+        return;
+    }
+    if (!CGSizeEqualToSize(size, _measured)) {
+        _measured = size;
+        [self invalidateIntrinsicContentSize];
+    }
+    if (CGSizeEqualToSize(size, self.bounds.size)) {
+        return;
+    }
+    self.frame = CGRectMake(self.frame.origin.x, self.frame.origin.y, size.width, size.height);
+    dispatch_block_t sizeDidChange = _sizeDidChange;
+    if (sizeDidChange) {
+        sizeDidChange();
+    }
+}
+
+// Only a switch from `fill` to `center` measures again: the same place asked again changes nothing.
+- (void)setFills:(BOOL)fills {
+    if (_fills == fills) {
+        return;
+    }
+    _fills = fills;
+    if (!fills) {
+        _rowSize = CGSizeZero;
+        [self measure];
+    }
+}
+
+- (CGSize)intrinsicContentSize {
+    return _fills ? _rowSize : _measured;
+}
+
+- (CGSize)sizeThatFits:(CGSize)size {
+    return [self intrinsicContentSize];
+}
+
+- (void)layoutSubviews {
+    [super layoutSubviews];
+    if (!CGRectEqualToRect(_content.frame, self.bounds)) {
+        _content.frame = self.bounds;
+    }
+}
+
+@end

package/ios/TopBar/ANNTitleGlassView.h

@@ -0,0 +1,33 @@
+#import "ANNNavigationOptions.h"
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// The title on a Liquid Glass capsule (`topBar.title.glass`, iOS 26+): a `UIGlassEffect` in a visual effect view with
+/// capsule corners. A text title shows the title and the subtitle in two lines on it (17 pt semibold, 15 pt with a
+/// subtitle, the label color; the subtitle 12 pt in the secondary label color; the options' fonts and colors over
+/// them), padded 7/16 pt for one line and 4/16 pt for two. A React title sits on it as it is, without padding, the
+/// capsule its size. Id `<topBar.testID>.title` on the capsule.
+API_AVAILABLE(ios(26.0))
+@interface ANNTitleGlassView : UIView
+
+/// Whether `glass` asks for a capsule: `regular` or `clear`.
++ (BOOL)isGlass:(nullable NSString *)glass;
+
+/// A capsule with the text title of `options`.
+- (instancetype)initWithGlass:(NSString *)glass options:(ANNNavigationOptions *)options;
+
+/// A capsule with a React title's container (its own size follows the container's).
+- (instancetype)initWithGlass:(NSString *)glass
+                    component:(UIView *)component
+                      options:(ANNNavigationOptions *)options;
+
+- (instancetype)initWithFrame:(CGRect)frame NS_UNAVAILABLE;
+- (nullable instancetype)initWithCoder:(NSCoder *)coder NS_UNAVAILABLE;
+
+/// The component's size changed: the capsule takes it.
+- (void)componentSizeDidChange;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/TopBar/ANNTitleGlassView.mm

@@ -0,0 +1,126 @@
+#import "ANNTitleGlassView.h"
+
+static const CGFloat ANNGlassHorizontalPadding = 16;
+static const CGFloat ANNGlassOneLinePadding = 7;
+static const CGFloat ANNGlassTwoLinesPadding = 4;
+
+static UILabel *ANNGlassLabel(NSString *text, ANNFontOptions *font, Color *color, UIFont *placeFont,
+                              UIColor *placeColor) {
+    UILabel *label = [UILabel new];
+    label.text = text;
+    label.textAlignment = NSTextAlignmentCenter;
+    label.font = [font fontWithPlaceFont:placeFont] ?: placeFont;
+    label.textColor =
+        color.hasValue && !color.isNoColor ? [color withDefault:placeColor] : placeColor;
+    [label sizeToFit];
+    return label;
+}
+
+@implementation ANNTitleGlassView {
+    UIVisualEffectView *_effectView;
+    UILabel *_title;
+    UILabel *_subtitle;
+    UIView *_component;
+}
+
++ (BOOL)isGlass:(NSString *)glass {
+    return [glass isEqualToString:@"regular"] || [glass isEqualToString:@"clear"];
+}
+
+- (instancetype)initWithGlass:(NSString *)glass options:(ANNNavigationOptions *)options {
+    if (self = [super initWithFrame:CGRectZero]) {
+        [self makeEffect:glass options:options];
+        ANNTopBarOptions *topBar = options.topBar;
+        NSString *subtitle = [topBar.subtitle.text withDefault:nil];
+        BOOL twoLines = subtitle.length > 0;
+        UIFont *titleFont = [UIFont systemFontOfSize:twoLines ? 15 : 17
+                                              weight:UIFontWeightSemibold];
+        _title = ANNGlassLabel([topBar.title.text withDefault:nil] ?: @"", topBar.title.font,
+                               topBar.title.color, titleFont, UIColor.labelColor);
+        [_effectView.contentView addSubview:_title];
+        if (twoLines) {
+            _subtitle = ANNGlassLabel(subtitle, topBar.subtitle.font, topBar.subtitle.color,
+                                      [UIFont systemFontOfSize:12], UIColor.secondaryLabelColor);
+            [_effectView.contentView addSubview:_subtitle];
+        }
+        [self sizeToContent];
+    }
+    return self;
+}
+
+- (instancetype)initWithGlass:(NSString *)glass
+                    component:(UIView *)component
+                      options:(ANNNavigationOptions *)options {
+    if (self = [super initWithFrame:CGRectZero]) {
+        [self makeEffect:glass options:options];
+        _component = component;
+        [_effectView.contentView addSubview:component];
+        [self sizeToContent];
+    }
+    return self;
+}
+
+- (void)makeEffect:(NSString *)glass options:(ANNNavigationOptions *)options {
+    UIGlassEffectStyle style =
+        [glass isEqualToString:@"clear"] ? UIGlassEffectStyleClear : UIGlassEffectStyleRegular;
+    _effectView = [[UIVisualEffectView alloc] initWithEffect:[UIGlassEffect effectWithStyle:style]];
+    _effectView.cornerConfiguration = [UICornerConfiguration capsuleConfiguration];
+    _effectView.autoresizingMask =
+        UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+    [self addSubview:_effectView];
+    NSString *testID = [options.topBar.testID withDefault:nil];
+    if (testID.length > 0) {
+        self.accessibilityIdentifier = [testID stringByAppendingString:@".title"];
+    }
+}
+
+- (void)componentSizeDidChange {
+    [self sizeToContent];
+}
+
+- (CGSize)contentSize {
+    if (_component) {
+        // The size the title asks for (its row with `fill`), not the frame UIKit last gave it.
+        return _component.intrinsicContentSize;
+    }
+    CGSize title = _title.bounds.size;
+    CGSize subtitle = _subtitle ? _subtitle.bounds.size : CGSizeZero;
+    CGFloat vertical = _subtitle ? ANNGlassTwoLinesPadding : ANNGlassOneLinePadding;
+    return CGSizeMake(ceil(MAX(title.width, subtitle.width) + 2 * ANNGlassHorizontalPadding),
+                      ceil(title.height + subtitle.height + 2 * vertical));
+}
+
+- (void)sizeToContent {
+    CGSize size = [self contentSize];
+    self.frame = CGRectMake(self.frame.origin.x, self.frame.origin.y, size.width, size.height);
+    _effectView.frame = self.bounds;
+    [self invalidateIntrinsicContentSize];
+    [self setNeedsLayout];
+}
+
+- (CGSize)intrinsicContentSize {
+    return [self contentSize];
+}
+
+- (CGSize)sizeThatFits:(CGSize)size {
+    return [self contentSize];
+}
+
+- (void)layoutSubviews {
+    [super layoutSubviews];
+    CGRect bounds = self.bounds;
+    _effectView.frame = bounds;
+    if (_component) {
+        _component.frame = CGRectMake(0, 0, bounds.size.width, bounds.size.height);
+        return;
+    }
+    CGFloat titleHeight = _title.bounds.size.height;
+    CGFloat subtitleHeight = _subtitle ? _subtitle.bounds.size.height : 0;
+    CGFloat top = MAX(0, (bounds.size.height - titleHeight - subtitleHeight) / 2);
+    CGFloat width = MAX(0, bounds.size.width - 2 * ANNGlassHorizontalPadding);
+    _title.frame = CGRectMake(ANNGlassHorizontalPadding, top, width, titleHeight);
+    _subtitle.frame =
+        CGRectMake(ANNGlassHorizontalPadding, top + titleHeight, width, subtitleHeight);
+}
+
+@end

package/ios/TopBar/ANNTitleView.h

@@ -0,0 +1,18 @@
+#import "ANNNavigationOptions.h"
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// The title with a subtitle before iOS 26 (`topBar.subtitle.text`): two centred labels in the item's `titleView`, the
+/// title 16 pt semibold and the subtitle 12 pt by default, the options' fonts and colors over them; each label its own
+/// color. Ids `<topBar.testID>.title` and `.subtitle`.
+@interface ANNTitleView : UIView
+
+- (instancetype)initWithOptions:(ANNNavigationOptions *)options;
+
+- (instancetype)initWithFrame:(CGRect)frame NS_UNAVAILABLE;
+- (nullable instancetype)initWithCoder:(NSCoder *)coder NS_UNAVAILABLE;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/TopBar/ANNTitleView.mm

@@ -0,0 +1,63 @@
+#import "ANNTitleView.h"
+
+static const CGFloat ANNTitleViewTitleSize = 16;
+static const CGFloat ANNTitleViewSubtitleSize = 12;
+
+static UILabel *ANNTitleLabel(NSString *text, ANNFontOptions *font, Color *color,
+                              UIFont *placeFont) {
+    UILabel *label = [UILabel new];
+    label.text = text;
+    label.textAlignment = NSTextAlignmentCenter;
+    label.font = [font fontWithPlaceFont:placeFont] ?: placeFont;
+    label.textColor = color.hasValue && !color.isNoColor ? [color withDefault:UIColor.labelColor]
+                                                         : UIColor.labelColor;
+    label.lineBreakMode = NSLineBreakByTruncatingTail;
+    [label sizeToFit];
+    return label;
+}
+
+@implementation ANNTitleView {
+    UILabel *_title;
+    UILabel *_subtitle;
+}
+
+- (instancetype)initWithOptions:(ANNNavigationOptions *)options {
+    if (self = [super initWithFrame:CGRectZero]) {
+        ANNTopBarOptions *topBar = options.topBar;
+        UIFont *titleFont = [UIFont systemFontOfSize:ANNTitleViewTitleSize
+                                              weight:UIFontWeightSemibold];
+        _title = ANNTitleLabel([topBar.title.text withDefault:nil] ?: @"", topBar.title.font,
+                               topBar.title.color, titleFont);
+        _subtitle = ANNTitleLabel([topBar.subtitle.text withDefault:nil] ?: @"",
+                                  topBar.subtitle.font, topBar.subtitle.color,
+                                  [UIFont systemFontOfSize:ANNTitleViewSubtitleSize]);
+        NSString *testID = [topBar.testID withDefault:nil];
+        if (testID.length > 0) {
+            _title.accessibilityIdentifier = [testID stringByAppendingString:@".title"];
+            _subtitle.accessibilityIdentifier = [testID stringByAppendingString:@".subtitle"];
+        }
+        [self addSubview:_title];
+        [self addSubview:_subtitle];
+        CGSize size = [self intrinsicContentSize];
+        self.frame = CGRectMake(0, 0, size.width, size.height);
+    }
+    return self;
+}
+
+- (CGSize)intrinsicContentSize {
+    CGSize title = _title.bounds.size;
+    CGSize subtitle = _subtitle.bounds.size;
+    return CGSizeMake(ceil(MAX(title.width, subtitle.width)), ceil(title.height + subtitle.height));
+}
+
+- (void)layoutSubviews {
+    [super layoutSubviews];
+    CGRect bounds = self.bounds;
+    CGFloat titleHeight = _title.bounds.size.height;
+    CGFloat subtitleHeight = _subtitle.bounds.size.height;
+    CGFloat top = MAX(0, (bounds.size.height - titleHeight - subtitleHeight) / 2);
+    _title.frame = CGRectMake(0, top, bounds.size.width, titleHeight);
+    _subtitle.frame = CGRectMake(0, top + titleHeight, bounds.size.width, subtitleHeight);
+}
+
+@end

package/ios/TopBar/ANNToolbarPresenter.h

@@ -0,0 +1,26 @@
+#import "ANNBarButtons.h"
+#import "ANNNavigationOptions.h"
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// The screen's part of the stack's toolbar (`toolbar.*`): the screen's `toolbarItems` from `toolbar.buttons` in the
+/// format of bar buttons, set without an animation at the screen's appearance and animated in merges. The stack shows
+/// or hides the toolbar by the top screen's options (`ANNStackPresenter`); the tab bar is not touched.
+@interface ANNToolbarPresenter : NSObject
+
+- (instancetype)init NS_UNAVAILABLE;
++ (instancetype)new NS_UNAVAILABLE;
+
+/// The items of `options` into `screen`; a screen in a pair tells its pair (`screen:didSetToolbarItemsAnimated:`).
++ (void)applyOptions:(ANNNavigationOptions *)options
+            ofScreen:(UIViewController *)screen
+             buttons:(ANNBarButtons *)buttons
+            animated:(BOOL)animated;
+
+/// Whether a merge changes the toolbar: the module's group has no `hasValue` of its own (correction 14).
++ (BOOL)mergeChangesToolbar:(ANNNavigationOptions *)mergeOptions;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/TopBar/ANNToolbarPresenter.mm

@@ -0,0 +1,24 @@
+#import "ANNToolbarPresenter.h"
+#import "ANNComponentViewController.h"
+
+@implementation ANNToolbarPresenter
+
++ (void)applyOptions:(ANNNavigationOptions *)options
+            ofScreen:(UIViewController *)screen
+             buttons:(ANNBarButtons *)buttons
+            animated:(BOOL)animated {
+    NSArray<UIBarButtonItem *> *items = [buttons toolbarItemsWithOptions:options];
+    [screen setToolbarItems:items.count > 0 ? items : nil animated:animated];
+    // The pair hears that its screen set its toolbar items (the module's delegate).
+    if ([screen isKindOfClass:ANNComponentViewController.class]) {
+        ANNComponentViewController *component = (ANNComponentViewController *)screen;
+        [component.arrangement screen:component didSetToolbarItemsAnimated:animated];
+    }
+}
+
++ (BOOL)mergeChangesToolbar:(ANNNavigationOptions *)mergeOptions {
+    ANNToolbarOptions *toolbar = mergeOptions.toolbar;
+    return toolbar.buttons != nil || toolbar.visible.hasValue || toolbar.testID.hasValue;
+}
+
+@end