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

package/ios/Contract/ANNCommandAnswer.mm

@@ -1,29 +1,16 @@
 #import "ANNCommandAnswer.h"
 #import "ANNAssert.h"
+#import "ANNCommandContract.h"
 #import "ANNErrorHandler.h"
 #import "ANNErrorTexts.h"
 #import "ANNNavigationState.h"
 #import "ANNReloadCoordinator.h"
 #import "ApexNavigation+Internal.h"
 
-// The commands that send `ANN.CommandCompleted` once they resolved: every one that shows or dismisses, not
-// `setColumnShown`, `preparePush` or `getLaunchLink`.
-static NSSet<NSString *> *ANNCompletedCommandNames(void) {
-    static NSSet<NSString *> *names;
-    static dispatch_once_t once;
-    dispatch_once(&once, ^{
-      names = [NSSet setWithArray:@[
-          @"setRoot", @"push", @"pop", @"popTo", @"popToRoot", @"setStackRoot", @"showInColumn",
-          @"showModal", @"dismissModal", @"dismissAllModals", @"showOverlay", @"dismissOverlay",
-          @"dismissAllOverlays"
-      ]];
-    });
-    return names;
-}
-
 @implementation ANNCommandAnswer {
     RCTPromiseResolveBlock _resolve;
     RCTPromiseRejectBlock _reject;
+    BOOL _stateReported;
 }
 
 - (instancetype)initWithCommandName:(NSString *)commandName
@@ -41,6 +28,16 @@ static NSSet<NSString *> *ANNCompletedCommandNames(void) {
     return self;
 }
 
+// The last reference went without an answer: nothing took the command, or what took it let it go. The promise of a
+// JavaScript that still runs rejects, so it never waits forever. Any thread: the promise blocks are React Native's,
+// safe from any thread, and the generation is readable from any thread.
+- (void)dealloc {
+    if (_answered || !self.isCurrent) {
+        return;
+    }
+    [ANNErrorHandler reject:_reject of:_commandName text:[ANNErrorTexts notAnswered:_commandName]];
+}
+
 - (BOOL)isCurrent {
     return _generation == ANNReloadCoordinator.generation;
 }
@@ -55,6 +52,27 @@ static NSSet<NSString *> *ANNCompletedCommandNames(void) {
     return YES;
 }
 
+- (void)reportStateNow {
+    ANNAssertMainQueue();
+    if (_stateReported) {
+        return;
+    }
+    _stateReported = YES;
+    // A step made for the JavaScript that went sends nothing, as its answer does.
+    if (!self.isCurrent) {
+        return;
+    }
+    // The command did its work: a failure of the state step costs only the state, never the events and the answer.
+    @try {
+        [ANNNavigationState updateNowFor:_commandName];
+    } @catch (NSException *exception) {
+        NSString *reason = exception.reason.length > 0 ? exception.reason : exception.name;
+        [ANNErrorHandler logFailureOf:_commandName
+                                 text:[ANNErrorTexts couldNot:@"report the navigation state"
+                                                        reason:reason]];
+    }
+}
+
 - (void)resolve:(id)value {
     if (![self takeAnswer]) {
         return;
@@ -62,23 +80,13 @@ static NSSet<NSString *> *ANNCompletedCommandNames(void) {
     RCTPromiseResolveBlock resolve = _resolve;
     _resolve = nil;
     _reject = nil;
-    // A command that may change what shows (the 13 and `setColumnShown`): the state goes before the promise, so that
-    // `getState()` after `await` has the result.
-    BOOL changesWhatShows = [ANNCompletedCommandNames() containsObject:_commandName] ||
-                            [_commandName isEqualToString:@"setColumnShown"];
-    if (changesWhatShows) {
-        // The command did its work: a failure of the state step costs only the state, never the answer.
-        @try {
-            [ANNNavigationState reportBeforeAnswer];
-        } @catch (NSException *exception) {
-            NSString *reason = exception.reason.length > 0 ? exception.reason : exception.name;
-            [ANNErrorHandler logFailureOf:_commandName
-                                     text:[ANNErrorTexts couldNot:@"report the navigation state"
-                                                            reason:reason]];
-        }
+    // A command that may change what shows (`ANNCommandContract`): the state goes before the promise, so that
+    // `getState()` after `await` has the result. Sent at the end of its transition already, it goes no more.
+    if (ANNCommandReportsState(_commandName)) {
+        [self reportStateNow];
     }
-    resolve(value);
-    if (_commandId && [ANNCompletedCommandNames() containsObject:_commandName]) {
+    [ANNErrorHandler resolve:resolve of:_commandName value:value];
+    if (_commandId && ANNCommandSendsCompleted(_commandName)) {
         double completionTime = floor(NSDate.date.timeIntervalSince1970 * 1000);
         [ApexNavigation.eventEmitter sendCommandCompleted:_commandName
                                                 commandId:_commandId
@@ -93,7 +101,7 @@ static NSSet<NSString *> *ANNCompletedCommandNames(void) {
     RCTPromiseRejectBlock reject = _reject;
     _resolve = nil;
     _reject = nil;
-    [ANNErrorHandler reject:reject text:text];
+    [ANNErrorHandler reject:reject of:_commandName text:text];
 }
 
 @end

package/ios/Contract/ANNCommandContract.h

@@ -0,0 +1,15 @@
+// Made by scripts/contract.mjs from src/interfaces/contract/commands.json: change that file and run the script again.
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// Whether the navigation state goes before the answer of the command `name`: every command that may change what
+/// shows. Any thread.
+FOUNDATION_EXPORT BOOL ANNCommandReportsState(NSString *name);
+
+/// Whether `ANN.CommandCompleted` follows the answer of the command `name`: every command that shows or dismisses.
+/// Any thread.
+FOUNDATION_EXPORT BOOL ANNCommandSendsCompleted(NSString *name);
+
+NS_ASSUME_NONNULL_END

package/ios/Contract/ANNCommandContract.mm

@@ -0,0 +1,78 @@
+// Made by scripts/contract.mjs from src/interfaces/contract/commands.json: change that file and run the script again.
+
+#import "ANNCommandContract.h"
+
+// What each command resolves with:
+// - `setRoot`: the id of the root, once the root and the layout's modals and overlays show.
+// - `push`: the id of the screen that shows; of a pair, the pair's id.
+// - `preparePush`: the frame `{ width, height, padding }` of the prepared screen, or null; always
+//   null on iOS.
+// - `pop`: the id of the screen that went.
+// - `popTo`: the id of the screen it went back to.
+// - `popToRoot`: the id of the first screen of the stack.
+// - `setStackRoot`: the id of the new top screen.
+// - `showModal`: the id of the modal's root.
+// - `dismissModal`: the id of the modal's root.
+// - `dismissAllModals`: an empty string.
+// - `showOverlay`: the id of the overlay's root.
+// - `dismissOverlay`: the id of the overlay's root.
+// - `dismissAllOverlays`: an empty string.
+// - `showInColumn`: the id of the screen that shows.
+// - `setColumnShown`: nothing once the columns stopped moving (`undefined` on iOS, `null` on
+//   Android).
+// - `getLaunchLink`: the link that launched the app, or null.
+
+static NSSet<NSString *> *ANNStateCommandNames(void) {
+    static NSSet<NSString *> *names;
+    static dispatch_once_t once;
+    dispatch_once(&once, ^{
+      names = [NSSet setWithArray:@[
+          @"setRoot",
+          @"push",
+          @"pop",
+          @"popTo",
+          @"popToRoot",
+          @"setStackRoot",
+          @"showModal",
+          @"dismissModal",
+          @"dismissAllModals",
+          @"showOverlay",
+          @"dismissOverlay",
+          @"dismissAllOverlays",
+          @"showInColumn",
+          @"setColumnShown",
+      ]];
+    });
+    return names;
+}
+
+static NSSet<NSString *> *ANNCompletedCommandNames(void) {
+    static NSSet<NSString *> *names;
+    static dispatch_once_t once;
+    dispatch_once(&once, ^{
+      names = [NSSet setWithArray:@[
+          @"setRoot",
+          @"push",
+          @"pop",
+          @"popTo",
+          @"popToRoot",
+          @"setStackRoot",
+          @"showModal",
+          @"dismissModal",
+          @"dismissAllModals",
+          @"showOverlay",
+          @"dismissOverlay",
+          @"dismissAllOverlays",
+          @"showInColumn",
+      ]];
+    });
+    return names;
+}
+
+BOOL ANNCommandReportsState(NSString *name) {
+    return [ANNStateCommandNames() containsObject:name];
+}
+
+BOOL ANNCommandSendsCompleted(NSString *name) {
+    return [ANNCompletedCommandNames() containsObject:name];
+}

package/ios/Contract/ANNCommandRunner.h

@@ -3,16 +3,17 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-/// Reads and checks a command's layout on the module's queue: the layout read, or nil with the text of the rejection.
+/// Reads and checks a command's layout before its body, in the same task: the layout read, or nil with the text of the
+/// rejection.
 typedef id _Nullable (^ANNCommandCheck)(NSString *_Nullable *_Nonnull error);
 
-/// The command's own work on the main queue, with the layout its check read (nil without a check). It answers once,
-/// now or later; an exception it throws rejects the command, and undoing what it made by then is the body's.
+/// The command's own work, with the layout its check read (nil without a check). It answers once, now or later; an
+/// exception it throws rejects the command, and undoing what it made by then is the body's.
 typedef void (^ANNCommandBody)(id _Nullable layout, ANNCommandAnswer *answer);
 
-/// The one path of every asynchronous method of `ANNTurboModule`. On the module's queue, at once: the command takes the
-/// generation of its JavaScript and its layout is read and checked whole; a failure rejects it there and nothing is
-/// queued. Then one task on the main queue per command, in the order they came: the command does nothing when its
+/// The one path of every asynchronous method of `ANNTurboModule`, on the main queue (the module's queue), in one task
+/// per command in the order JavaScript made them: the command takes the generation of its JavaScript and its layout is
+/// read and checked whole, a failure rejecting it before anything is made; then the command does nothing when its
 /// JavaScript went, rejects when the navigation has nowhere to show screens, and runs its body inside the protection.
 @interface ANNCommandRunner : NSObject
 
@@ -22,12 +23,12 @@ typedef void (^ANNCommandBody)(id _Nullable layout, ANNCommandAnswer *answer);
 + (void)run:(NSString *)name
     commandId:(nullable NSString *)commandId
          what:(NSString *)what
-      resolve:(RCTPromiseResolveBlock)resolve
-       reject:(RCTPromiseRejectBlock)reject
+      resolve:(nullable RCTPromiseResolveBlock)resolve
+       reject:(nullable RCTPromiseRejectBlock)reject
         check:(nullable ANNCommandCheck)check
          body:(ANNCommandBody)body;
 
-/// A command without a promise: its body on the main queue, inside the protection; a failure is one log line.
+/// A command without a promise: its body at once, inside the protection; a failure is one log line. Main queue.
 + (void)runVoid:(NSString *)name what:(NSString *)what body:(dispatch_block_t)body;
 
 /// The log line of a command without a promise that failed: `[ApexNavigation] <name>: <text>`.

package/ios/Contract/ANNCommandRunner.mm

@@ -1,9 +1,9 @@
 #import "ANNCommandRunner.h"
+#import "ANNAssert.h"
 #import "ANNErrorHandler.h"
 #import "ANNErrorTexts.h"
 #import "ANNReloadCoordinator.h"
 #import "ApexNavigation+Internal.h"
-#import <React/RCTUtils.h>
 
 // Why an exception happened: its message, else its name.
 static NSString *ANNReasonOf(NSException *exception) {
@@ -27,6 +27,8 @@ static NSString *ANNRejectionOf(NSException *exception, NSString *what) {
        reject:(RCTPromiseRejectBlock)reject
         check:(ANNCommandCheck)check
          body:(ANNCommandBody)body {
+    // The module's methods come on the main queue: the check and the body run in this one task.
+    ANNAssertMainQueue();
     NSUInteger generation = ANNReloadCoordinator.generation;
     id layout = nil;
     if (check) {
@@ -37,7 +39,7 @@ static NSString *ANNRejectionOf(NSException *exception, NSString *what) {
             error = ANNRejectionOf(exception, what);
         }
         if (error) {
-            [ANNErrorHandler reject:reject text:error];
+            [ANNErrorHandler reject:reject of:name text:error];
             return;
         }
     }
@@ -46,36 +48,28 @@ static NSString *ANNRejectionOf(NSException *exception, NSString *what) {
                                                                   generation:generation
                                                                      resolve:resolve
                                                                       reject:reject];
-    // At once when the caller is on the main queue already; the module's queue never is.
-    RCTExecuteOnMainQueue(^{
-      if (!answer.isCurrent) {
-          return;
-      }
-      if (commandId && !ApexNavigation.mainWindow) {
-          [answer reject:ANNErrorTexts.nowhereToShow];
-          return;
-      }
-      @try {
-          body(layout, answer);
-      } @catch (NSException *exception) {
-          [answer reject:ANNRejectionOf(exception, what)];
-      }
-    });
+    if (!answer.isCurrent) {
+        return;
+    }
+    if (commandId && !ApexNavigation.mainWindow) {
+        [answer reject:ANNErrorTexts.nowhereToShow];
+        return;
+    }
+    @try {
+        body(layout, answer);
+    } @catch (NSException *exception) {
+        [answer reject:ANNRejectionOf(exception, what)];
+    }
 }
 
 // Before the navigation started a command without a promise has nothing to act on: its body finds nothing.
 + (void)runVoid:(NSString *)name what:(NSString *)what body:(dispatch_block_t)body {
-    NSUInteger generation = ANNReloadCoordinator.generation;
-    RCTExecuteOnMainQueue(^{
-      if (generation != ANNReloadCoordinator.generation) {
-          return;
-      }
-      @try {
-          body();
-      } @catch (NSException *exception) {
-          [self logFailure:name text:[ANNErrorTexts couldNot:what reason:ANNReasonOf(exception)]];
-      }
-    });
+    ANNAssertMainQueue();
+    @try {
+        body();
+    } @catch (NSException *exception) {
+        [self logFailure:name text:[ANNErrorTexts couldNot:what reason:ANNReasonOf(exception)]];
+    }
 }
 
 + (void)logFailure:(NSString *)name text:(NSString *)text {

package/ios/Contract/ANNErrorTexts.h

@@ -1,3 +1,5 @@
+// Made by scripts/contract.mjs from src/interfaces/contract/errors.json: change that file and run the script again.
+
 #import <Foundation/Foundation.h>
 
 NS_ASSUME_NONNULL_BEGIN
@@ -51,12 +53,12 @@ FOUNDATION_EXPORT NSExceptionName const ANNCommandRejectionException;
 + (NSString *)stackTakesScreens:(NSString *)stackId type:(NSString *)type;
 + (NSString *)emptyStack:(NSString *)stackId;
 + (NSString *)emptyTabs:(NSString *)tabsId;
+/// Only Android checks it: its tab bar shows at most 5 tabs.
 + (NSString *)tooManyTabs:(NSString *)tabsId count:(NSUInteger)count;
 + (NSString *)splitViewColumns:(NSString *)splitViewId;
+/// Only iOS checks it: Android has pairs on every version.
 + (NSString *)pairUnsupported:(NSString *)pairId;
 + (NSString *)pairNeedsTwoScreens:(NSString *)pairId;
-
-/// The other cases of the layout check: the texts both platforms use meanwhile.
 + (NSString *)nodeWithoutName:(NSString *)type nodeId:(NSString *)nodeId;
 + (NSString *)rootMissing;
 + (NSString *)tabsInTabs:(NSString *)tabsId;
@@ -77,6 +79,8 @@ FOUNDATION_EXPORT NSExceptionName const ANNCommandRejectionException;
 + (NSString *)couldNot:(NSString *)what reason:(NSString *)reason;
 /// A command whose part of the native core is not written yet.
 + (NSString *)notDoneYet:(NSString *)method;
+/// A command that nothing in the native core answered: what took it let it go, or nothing took it.
++ (NSString *)notAnswered:(NSString *)method;
 
 /// An `ANNCommandRejectionException` with `text` as its reason: the command that runs rejects with `text` as it is.
 + (NSException *)rejection:(NSString *)text;

package/ios/Contract/ANNErrorTexts.mm

@@ -1,3 +1,5 @@
+// Made by scripts/contract.mjs from src/interfaces/contract/errors.json: change that file and run the script again.
+
 #import "ANNErrorTexts.h"
 
 NSExceptionName const ANNCommandRejectionException = @"ANNCommandRejectionException";
@@ -59,8 +61,8 @@ static NSString *ANNText(NSString *format, ...) {
 }
 
 + (NSString *)columnNotStack:(NSString *)componentId column:(NSString *)column {
-    return ANNText(@"the '%@' column of the split view of the screen '%@' is not a stack", column,
-                   componentId);
+    return ANNText(@"the '%@' column of the split view of the screen '%@' is not a stack",
+                   column, componentId);
 }
 
 + (NSString *)noScreensForStack:(NSString *)componentId {
@@ -74,7 +76,8 @@ static NSString *ANNText(NSString *format, ...) {
 #pragma mark - Root, modals, the app
 
 + (NSString *)setRootReplaced:(NSString *)rootId {
-    return ANNText(@"setRoot was replaced by a newer setRoot before the root '%@' finished showing",
+    return ANNText(@"setRoot was replaced by a newer setRoot before the root '%@' finished "
+                   @"showing",
                    rootId);
 }
 
@@ -141,8 +144,8 @@ static NSString *ANNText(NSString *format, ...) {
 }
 
 + (NSString *)tooManyTabs:(NSString *)tabsId count:(NSUInteger)count {
-    return ANNText(@"the tabs '%@' have %lu tabs: Android shows at most 5", tabsId,
-                   (unsigned long)count);
+    return ANNText(@"the tabs '%@' have %lu tabs: Android shows at most 5",
+                   tabsId, (unsigned long)count);
 }
 
 + (NSString *)splitViewColumns:(NSString *)splitViewId {
@@ -181,8 +184,8 @@ static NSString *ANNText(NSString *format, ...) {
 }
 
 + (NSString *)sideMenuInSide:(NSString *)menuId {
-    return ANNText(@"the side menu '%@' has a side menu in a side: a side menu doesn't go inside a "
-                   @"side menu",
+    return ANNText(@"the side menu '%@' has a side menu in a side: a side menu doesn't go inside "
+                   @"a side menu",
                    menuId);
 }
 
@@ -191,8 +194,8 @@ static NSString *ANNText(NSString *format, ...) {
 }
 
 + (NSString *)splitViewInColumn:(NSString *)splitViewId {
-    return ANNText(@"the split view '%@' has a column of type 'SplitView': a split view doesn't go "
-                   @"inside a split view",
+    return ANNText(@"the split view '%@' has a column of type 'SplitView': a split view doesn't "
+                   @"go inside a split view",
                    splitViewId);
 }
 
@@ -208,7 +211,8 @@ static NSString *ANNText(NSString *format, ...) {
 }
 
 + (NSString *)unreadableDefaultOption:(NSString *)path {
-    return ANNText(@"the option '%@' of the default options has a value the navigation can't read", path);
+    return ANNText(@"the option '%@' of the default options has a value the navigation can't read",
+                   path);
 }
 
 + (NSString *)previewGone:(NSString *)previewId {
@@ -223,6 +227,10 @@ static NSString *ANNText(NSString *format, ...) {
     return ANNText(@"could not run '%@': the native core doesn't do it yet", method);
 }
 
++ (NSString *)notAnswered:(NSString *)method {
+    return ANNText(@"could not run '%@': the native core let it go without an answer", method);
+}
+
 + (NSException *)rejection:(NSString *)text {
     return [NSException exceptionWithName:ANNCommandRejectionException reason:text userInfo:nil];
 }

package/ios/Contract/ANNLayoutNode.h

@@ -3,9 +3,9 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-/// One node of a command's layout, as `ANNLayoutReader` read and checked it on the module's queue. Immutable: made off
-/// the main queue, read on it by the command. The data stays the JSON JS sent; the accessors give its fields with the
-/// kind the contract has, or nothing.
+/// One node of a command's layout, as `ANNLayoutReader` read and checked it before the command's body. Immutable: made
+/// once, read by the command and the steps it runs later. The data stays the JSON JS sent; the accessors give its
+/// fields with the kind the contract has, or nothing.
 @interface ANNLayoutNode : NSObject
 
 /// Made by `ANNLayoutReader` only: the id as JS gave it, the type, the node's `data` (empty when missing) and its

package/ios/Contract/ANNLayoutReader.h

@@ -5,9 +5,9 @@
 NS_ASSUME_NONNULL_BEGIN
 
 /// Reads the layout JSON of a command into `ANNLayoutNode`s and checks it whole, before any view is made. It runs on
-/// the module's queue, where the command arrives: a failure rejects the command there with the text of the first error
-/// found, and nothing goes to the main queue. It reads only the stores that are safe from any thread (the registered
-/// native screens, whether the app shows pairs).
+/// the main queue, in the command's task before its body: a failure rejects the command with the text of the first
+/// error found, and nothing is made. The stores it reads are safe from any thread (the registered native screens,
+/// whether the app shows pairs).
 ///
 /// One pass over the tree, depth first, children in order, the same order on both platforms so that the first error
 /// is the same text. At each node: a known `type` (`''` for a node that is no object or has no string type), an `id`

package/ios/Core/ANNAppDelegate.mm

@@ -71,8 +71,6 @@ static BOOL ANNAppUsesScenes(void) {
     rootViewFactory.reactHost = host;
     [ApexNavigation bootstrapWithHost:host];
     self.window = ApexNavigation.mainWindow;
-    // The links that come before React content wait for it; the launch link waits for the scene.
-    [ANNDeepLinkQueue start];
     if (!ANNAppUsesScenes()) {
         [self.window makeKeyAndVisible];
     }

package/ios/Core/ANNAppearanceDispatcher.h

@@ -58,11 +58,12 @@ NS_ASSUME_NONNULL_BEGIN
 
 /// A transition ended, in this order: first a screen a transition began inside a node of `shown` that left the window
 /// and isn't one of that node's shown screens gets its `DidDisappear`; then `DidDisappear` of every screen of `hidden`,
-/// `DidAppear` of what `shown` shows, the navigation state now when it changed, `events` (the transition's own events,
+/// `DidAppear` of what `shown` shows, the navigation state now when it changed (the answer's one state step,
+/// `-[ANNCommandAnswer reportStateNow]`; nothing for a JavaScript that went), `events` (the transition's own events,
 /// `ANN.ScreenPopped` and `ANN.ModalDismissed`, and what must follow them, like stopping the content that went), then
-/// `answer` resolves with `value` (its own state step finds nothing new, then the promise, then
-/// `ANN.CommandCompleted`). A user's action passes no answer. The callbacks of UIKit that come later find the phases
-/// set and send nothing.
+/// `answer` resolves with `value` (the promise, then `ANN.CommandCompleted`; no second state). A user's action passes
+/// no answer, and its state goes all the same. The callbacks of UIKit that come later find the phases set and send
+/// nothing.
 + (void)endTransitionHiding:(NSArray<UIViewController *> *)hidden
                     showing:(NSArray<UIViewController *> *)shown
                      events:(nullable dispatch_block_t)events

package/ios/Core/ANNAppearanceDispatcher.mm

@@ -305,7 +305,18 @@ static BOOL ANNIsInsideNode(UIViewController *screen, UIViewController *node) {
     for (UIViewController *node in shown) {
         [self nodeDidAppear:node];
     }
-    [ANNNavigationState updateNow];
+    // The state before the transition's events, once per answer: the answer's own step before its promise finds it
+    // sent. A user's transition has no answer; one whose answer went before its end (an interrupt) sends the state of
+    // its end itself, as Android does.
+    if (!answer) {
+        [ANNNavigationState updateNow];
+    } else if (answer.answered) {
+        if (answer.isCurrent) {
+            [ANNNavigationState updateNowFor:answer.commandName];
+        }
+    } else {
+        [answer reportStateNow];
+    }
     if (events) {
         events();
     }

package/ios/Core/ANNDeepLinkQueue.h

@@ -1,4 +1,4 @@
-#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
 
 NS_ASSUME_NONNULL_BEGIN
 
@@ -14,12 +14,32 @@ typedef void (^ANNLaunchLinkCompletion)(NSURL *_Nullable url);
  */
 @interface ANNDeepLinkQueue : NSObject
 
-/// Starts the queue as the app launches (`ANNAppDelegate`). An app that never starts it has no launch link.
+/// Starts the queue as the app launches (`+[ApexNavigation bootstrapWithHost:]`, so also under an app delegate of the
+/// app's own). Once: a second call does nothing.
 + (void)start;
 
 /// Hands `url` to `Linking`, or keeps it until React content first appears and no `takeLaunchLink:` waits.
 + (void)dispatchURL:(NSURL *)url;
 
+/**
+ * Runs `forward`, which hands the scene's link to the app delegate (`ANNSceneDelegate`). The URL the app delegate
+ * dispatches in it keeps the scene and its context, which React Native 0.88 and newer need to take a scene's link.
+ */
++ (void)forwardURLContext:(UIOpenURLContext *)context
+                  ofScene:(UIScene *)scene
+                  through:(NS_NOESCAPE dispatch_block_t)forward;
+
+/// `forwardURLContext:ofScene:through:` for a web link (`webpageURL`) of the scene.
++ (void)forwardUserActivity:(NSUserActivity *)activity
+                    ofScene:(UIScene *)scene
+                    through:(NS_NOESCAPE dispatch_block_t)forward;
+
+/// `dispatchURL:` for the scene's link, with its scene and context: for an app delegate that doesn't take links.
++ (void)dispatchURLContext:(UIOpenURLContext *)context ofScene:(UIScene *)scene;
+
+/// `dispatchURLContext:ofScene:` for a web link (`webpageURL`) of the scene; an activity without one does nothing.
++ (void)dispatchUserActivity:(NSUserActivity *)activity ofScene:(UIScene *)scene;
+
 /// The app's window scene connected (`+[ApexNavigation attachToWindowScene:]`).
 + (void)windowSceneDidConnect;