react-native-navigation 8.8.6-snapshot.2569 → 8.8.6-snapshot.2571

package/ios/ARCHITECTURE.md

@@ -28,6 +28,11 @@ Base class that user's AppDelegate must extend. Handles React Native and navigat
 - Creates `RCTRootViewFactory` and `ReactHost`
 - Calls `[ReactNativeNavigation bootstrapWithHost:]` to initialize navigation
 - Handles RN version differences (0.77, 0.78, 0.79+) via compile-time macros
+- **Deep linking plumbing**:
+  - Implements `application:openURL:options:` and `application:continueUserActivity:restorationHandler:`; both call `-dispatchDeepLinkURL:`.
+  - `-dispatchDeepLinkURL:` posts `RCTOpenURLNotification` directly if the React runtime is ready, otherwise enqueues the URL.
+  - Observes `RCTContentDidAppearNotification` (the Fabric/bridgeless signal) to flush the queue. This solves the cold-start race where URLs (push notifications, OS link launches) arrive before `RCTLinkingManager` is listening.
+  - Subclasses can call `-dispatchDeepLinkURL:` manually from notification delegates or any other URL source; the queueing behavior is reused automatically.
 
 ### ReactNativeNavigation Bootstrap
 **File**: `ReactNativeNavigation.h/mm`

package/ios/RNNAppDelegate.h

@@ -56,4 +56,20 @@
 @property(nonatomic) BOOL bridgelessEnabled;
 #endif
 
+/**
+ * Dispatch a deep link URL through React Native's Linking module so JS
+ * subscribers (including RNN's built-in deep linking framework) receive it.
+ *
+ * Safe to call before the JS bridge is ready: URLs that arrive early
+ * (e.g. cold-start notification taps) are queued natively and flushed
+ * automatically once Fabric/React content first appears.
+ *
+ * Custom-scheme and universal-link openings dispatched by the OS are
+ * forwarded through this method automatically; call it manually only
+ * when your app receives a deep link from a source RNN can't intercept
+ * (e.g. a custom `UNUserNotificationCenterDelegate`, a third-party push
+ * SDK callback, etc.).
+ */
+- (void)dispatchDeepLinkURL:(NSURL *)url;
+
 @end

package/ios/RNNAppDelegate.mm

@@ -8,6 +8,8 @@
 #import <React/RCTCxxBridgeDelegate.h>
 #endif
 #import <React/RCTLegacyViewManagerInteropComponentView.h>
+#import <React/RCTLinkingManager.h>
+#import <React/RCTRootView.h>
 #import <React/RCTSurfacePresenter.h>
 #if __has_include(<React/RCTSurfacePresenterStub.h>)
 #import <React/RCTSurfacePresenterStub.h>
@@ -36,6 +38,13 @@
 
 #import <React/RCTComponentViewFactory.h>
 
+// Deep-link URLs that arrive (openURL, universal link, or external dispatch)
+// before the React runtime is ready are queued here and flushed when Fabric
+// posts `RCTContentDidAppearNotification` — by which point
+// `RCTLinkingManager` is instantiated and JS subscribers are listening.
+static NSMutableArray<NSURL *> *gRNNPendingDeepLinkURLs = nil;
+static BOOL gRNNReactRuntimeReady = NO;
+
 
 static NSString *const kRNConcurrentRoot = @"concurrentRoot";
 
@@ -92,9 +101,73 @@ didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     [ReactNativeNavigation bootstrapWithHost:self.reactNativeFactory.rootViewFactory.reactHost];
 #endif
     
+    [self rnn_installDeepLinkObservers];
+    
     return YES;
 }
 
+#pragma mark - Deep linking
+
+// Forward OS-delivered custom-scheme URLs to React Native's Linking module.
+- (BOOL)application:(UIApplication *)application
+            openURL:(NSURL *)url
+            options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
+    [self dispatchDeepLinkURL:url];
+    return YES;
+}
+
+// Forward universal links (associated domains) to React Native's Linking
+// module by extracting the underlying https URL and routing it through the
+// same pre-bridge queue as everything else.
+- (BOOL)application:(UIApplication *)application
+   continueUserActivity:(NSUserActivity *)userActivity
+     restorationHandler:
+         (void (^)(NSArray<id<UIUserActivityRestoring>> *_Nullable))restorationHandler {
+    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
+        [self dispatchDeepLinkURL:userActivity.webpageURL];
+        return YES;
+    }
+    return NO;
+}
+
+- (void)dispatchDeepLinkURL:(NSURL *)url {
+    if (url == nil) {
+        return;
+    }
+    if (gRNNReactRuntimeReady) {
+        [RCTLinkingManager application:[UIApplication sharedApplication]
+                               openURL:url
+                               options:@{}];
+        return;
+    }
+    if (gRNNPendingDeepLinkURLs == nil) {
+        gRNNPendingDeepLinkURLs = [NSMutableArray array];
+    }
+    [gRNNPendingDeepLinkURLs addObject:url];
+}
+
+- (void)rnn_installDeepLinkObservers {
+    // `RCTContentDidAppearNotification` is posted by Fabric's root view
+    // once content has rendered. RNN forces bridgeless/new-arch, so the
+    // legacy `RCTJavaScriptDidLoadNotification` never fires; we rely on
+    // this Fabric signal exclusively.
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(rnn_handleReactRuntimeReady:)
+                                                 name:RCTContentDidAppearNotification
+                                               object:nil];
+}
+
+- (void)rnn_handleReactRuntimeReady:(NSNotification *)notification {
+    gRNNReactRuntimeReady = YES;
+    NSArray<NSURL *> *pending = [gRNNPendingDeepLinkURLs copy];
+    [gRNNPendingDeepLinkURLs removeAllObjects];
+    for (NSURL *url in pending) {
+        [RCTLinkingManager application:[UIApplication sharedApplication]
+                               openURL:url
+                               options:@{}];
+    }
+}
+
 
 #if !RNN_RN_VERSION_79_OR_NEWER
 - (NSURL *)sourceURLForBridge:(RCTBridge *)bridge {

package/lib/module/ARCHITECTURE.md

@@ -18,6 +18,7 @@ src/
 ├── components/              # React component management
 ├── events/                  # Event system
 ├── interfaces/              # TypeScript type definitions
+├── linking/                 # Deep-linking framework (URL → command)
 └── processors/              # Extensibility hooks
 ```
 
@@ -207,6 +208,35 @@ Notifies listeners of command lifecycle (start, complete).
 | `RNN.PreviewCompleted` | 3D Touch preview completed |
 | `RNN.CommandCompleted` | Navigation command finished |
 
+## Linking Layer
+
+Implements URL-to-screen routing on top of the standard command pipeline. The whole feature is JS-only; it consumes URLs from RN's `Linking` module and dispatches `showModal` (or a user-supplied command) when a match is found.
+
+**Public surface** (proxied through `NavigationDelegate`):
+- `Navigation.setLinking(config)` — configure prefixes, screen map, and customization hooks
+- `Navigation.handleDeepLink(url)` — manually feed a URL (push notifications, branch.io, App Clips)
+- `Navigation.setLinkingReady(ready)` — user-controlled gate for deferred deep links
+
+**Internal modules** (`src/linking/`):
+
+| File | Purpose |
+|------|---------|
+| `LinkingHandler.ts` | Orchestrator. Subscribes to `Linking.url`/`getInitialURL`, drives the queue, dispatches matches. Instantiated by `NavigationRoot`. |
+| `URLParser.ts` | Strips prefix (longest match), removes fragment, decodes path segments + query params. |
+| `RouteMatcher.ts` | Compiles `ScreensConfig` into a `RouteNode` tree; matches paths to screen chains with parameter extraction. |
+| `DeferredLinkQueue.ts` | FIFO queue. Holds URLs until both gates open (root-ready + user-ready). |
+| `ModalLayoutBuilder.ts` | Default presentation: wraps the matched chain in a `stack`, merges params into `passProps`, filters React-reserved keys (`ref`, `key`). |
+| `types.ts` | Public types: `LinkingConfig`, `RouteMatch`, `ScreensConfig`, etc. (re-exported via `src/index.ts`). |
+
+**Readiness gates** — a URL is dispatched only when both are true:
+1. **Root-ready** (automatic): the first `Navigation.setRoot()` has resolved. `NavigationRoot.setRoot` calls `linkingHandler.setRootReady()` after the promise resolves.
+2. **User-ready** (optional): `config.isReady()` returns `true`, or `setLinkingReady(true)` was called.
+
+**Resolution priority** when a match is found:
+1. `config.onLink(match)` — full escape hatch, RNN does nothing else
+2. `config.getModal(match)` — custom modal layout
+3. Default `ModalLayoutBuilder` output
+
 ## Processors Layer
 
 ### OptionProcessorsStore

package/lib/module/Navigation.js

@@ -21,6 +21,7 @@ import { Deprecations } from "./commands/Deprecations.js";
 import { LayoutProcessor } from "./processors/LayoutProcessor.js";
 import { LayoutProcessorsStore } from "./processors/LayoutProcessorsStore.js";
 import { OptionsCrawler } from "./commands/OptionsCrawler.js";
+import { LinkingHandler } from "./linking/LinkingHandler.js";
 export class NavigationRoot {
   TouchablePreview = TouchablePreview;
   constructor(nativeCommandsSender, nativeEventsReceiver, appRegistryService) {
@@ -42,6 +43,7 @@ export class NavigationRoot {
     this.optionsCrawler = new OptionsCrawler(this.store, this.uniqueIdProvider);
     this.commands = new Commands(this.store, this.nativeCommandsSender, this.layoutTreeParser, this.layoutTreeCrawler, this.commandsObserver, this.uniqueIdProvider, optionsProcessor, layoutProcessor, this.optionsCrawler);
     this.eventsRegistry = new EventsRegistry(this.nativeEventsReceiver, this.commandsObserver, this.componentEventsObserver);
+    this.linkingHandler = new LinkingHandler(layout => this.commands.showModal(layout));
     this.componentEventsObserver.registerOnceForAllComponentEvents();
   }
 
@@ -84,7 +86,9 @@ export class NavigationRoot {
    * Reset the app to a new layout
    */
   setRoot(layout) {
-    return this.commands.setRoot(layout);
+    const result = this.commands.setRoot(layout);
+    result.then(() => this.linkingHandler.setRootReady()).catch(() => {});
+    return result;
   }
 
   /**
@@ -193,6 +197,35 @@ export class NavigationRoot {
     return this.commands.getLaunchArgs();
   }
 
+  /**
+   * Configure deep link handling. Maps URL prefixes and path patterns to
+   * RNN components. By default each matched link is presented as a modal
+   * (wrapped in a stack so a topBar close button can be configured); supply
+   * `getModal` to customize the modal layout or `onLink` to bypass the
+   * default behavior entirely.
+   */
+  setLinking(config) {
+    this.linkingHandler.configure(config);
+  }
+
+  /**
+   * Manually run a URL through the deep link pipeline as if it had been
+   * delivered by the OS. Useful for URLs received from push notifications
+   * or other non-`Linking` sources.
+   */
+  handleDeepLink(url) {
+    this.linkingHandler.handleURL(url);
+  }
+
+  /**
+   * Signal that the app is ready to process deep links (e.g. after the
+   * user has authenticated). When set to `true`, any links that were
+   * queued while not ready are replayed in order.
+   */
+  setLinkingReady(ready) {
+    this.linkingHandler.setLinkingReady(ready);
+  }
+
   /**
    * Obtain the events registry instance
    */

package/lib/module/Navigation.js.map

@@ -1 +1 @@
-{"version":3,"names":["isArray","UniqueIdProvider","Store","OptionProcessorsStore","ComponentRegistry","Commands","LayoutTreeParser","LayoutTreeCrawler","EventsRegistry","CommandsObserver","Constants","ComponentEventsObserver","TouchablePreview","ComponentWrapper","OptionsProcessor","ColorService","AssetService","Deprecations","LayoutProcessor","LayoutProcessorsStore","OptionsCrawler","NavigationRoot","constructor","nativeCommandsSender","nativeEventsReceiver","appRegistryService","componentWrapper","store","optionProcessorsStore","layoutProcessorsStore","uniqueIdProvider","componentEventsObserver","componentRegistry","layoutTreeParser","optionsProcessor","layoutProcessor","layoutTreeCrawler","commandsObserver","optionsCrawler","commands","eventsRegistry","registerOnceForAllComponentEvents","registerComponent","componentName","componentProvider","concreteComponentProvider","addOptionProcessor","optionPath","processor","addProcessor","addLayoutProcessor","setLazyComponentRegistrator","lazyRegistratorFn","registerComponentWithRedux","getComponentClassFunc","ReduxProvider","reduxStore","console","warn","undefined","setRoot","layout","setDefaultOptions","options","mergeOptions","componentId","updateProps","props","callback","showModal","dismissModal","dismissAllModals","push","pop","popTo","popToRoot","setStackRoot","children","showOverlay","dismissOverlay","dismissAllOverlays","getLaunchArgs","events","constants","get","constantsSync","getSync"],"sourceRoot":"../../src","sources":["Navigation.ts"],"mappings":";;AAAA,OAAOA,OAAO,MAAM,gBAAgB;AAGpC,SAASC,gBAAgB,QAAQ,gCAA6B;AAC9D,SAASC,KAAK,QAAQ,uBAAoB;AAC1C,SAASC,qBAAqB,QAAQ,uCAAoC;AAC1E,SAASC,iBAAiB,QAAQ,mCAAgC;AAClE,SAASC,QAAQ,QAAQ,wBAAqB;AAC9C,SAASC,gBAAgB,QAAQ,gCAA6B;AAC9D,SAASC,iBAAiB,QAAQ,iCAA8B;AAChE,SAASC,cAAc,QAAQ,4BAAyB;AAExD,SAASC,gBAAgB,QAAQ,8BAA2B;AAC5D,SAASC,SAAS,QAA6B,yBAAsB;AACrE,SAASC,uBAAuB,QAAQ,qCAAkC;AAC1E,SAASC,gBAAgB,QAAQ,gCAA6B;AAG9D,SAASC,gBAAgB,QAAQ,kCAA+B;AAChE,SAASC,gBAAgB,QAAQ,gCAA6B;AAC9D,SAASC,YAAY,QAAQ,4BAAyB;AACtD,SAASC,YAAY,QAAQ,6BAA0B;AAEvD,SAASC,YAAY,QAAQ,4BAAyB;AAEtD,SAASC,eAAe,QAAQ,iCAA8B;AAC9D,SAASC,qBAAqB,QAAQ,uCAAoC;AAE1E,SAASC,cAAc,QAAQ,8BAA2B;AAG1D,OAAO,MAAMC,cAAc,CAAC;EACVT,gBAAgB,GAAGA,gBAAgB;EAgBnDU,WAAWA,CACQC,oBAA0C,EAC1CC,oBAA0C,EAC1CC,kBAAsC,EACvD;IAAA,KAHiBF,oBAA0C,GAA1CA,oBAA0C;IAAA,KAC1CC,oBAA0C,GAA1CA,oBAA0C;IAAA,KAC1CC,kBAAsC,GAAtCA,kBAAsC;IAEvD,IAAI,CAACC,gBAAgB,GAAG,IAAIb,gBAAgB,CAAC,CAAC;IAC9C,IAAI,CAACc,KAAK,GAAG,IAAIzB,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC0B,qBAAqB,GAAG,IAAIzB,qBAAqB,CAAC,CAAC;IACxD,IAAI,CAAC0B,qBAAqB,GAAG,IAAIV,qBAAqB,CAAC,CAAC;IACxD,IAAI,CAACW,gBAAgB,GAAG,IAAI7B,gBAAgB,CAAC,CAAC;IAC9C,IAAI,CAAC8B,uBAAuB,GAAG,IAAIpB,uBAAuB,CACxD,IAAI,CAACa,oBAAoB,EACzB,IAAI,CAACG,KACP,CAAC;IAED,IAAI,CAACK,iBAAiB,GAAG,IAAI5B,iBAAiB,CAC5C,IAAI,CAACuB,KAAK,EACV,IAAI,CAACI,uBAAuB,EAC5B,IAAI,CAACL,gBAAgB,EACrB,IAAI,CAACD,kBACP,CAAC;IACD,IAAI,CAACQ,gBAAgB,GAAG,IAAI3B,gBAAgB,CAAC,IAAI,CAACwB,gBAAgB,CAAC;IACnE,MAAMI,gBAAgB,GAAG,IAAIpB,gBAAgB,CAC3C,IAAI,CAACa,KAAK,EACV,IAAI,CAACG,gBAAgB,EACrB,IAAI,CAACF,qBAAqB,EAC1B,IAAIb,YAAY,CAAC,CAAC,EAClB,IAAIC,YAAY,CAAC,CAAC,EAClB,IAAIC,YAAY,CAAC,CACnB,CAAC;IACD,MAAMkB,eAAe,GAAG,IAAIjB,eAAe,CAAC,IAAI,CAACW,qBAAqB,CAAC;IACvE,IAAI,CAACO,iBAAiB,GAAG,IAAI7B,iBAAiB,CAAC,IAAI,CAACoB,KAAK,EAAEO,gBAAgB,CAAC;IAC5E,IAAI,CAACG,gBAAgB,GAAG,IAAI5B,gBAAgB,CAAC,IAAI,CAACqB,gBAAgB,CAAC;IACnE,IAAI,CAACQ,cAAc,GAAG,IAAIlB,cAAc,CAAC,IAAI,CAACO,KAAK,EAAE,IAAI,CAACG,gBAAgB,CAAC;IAC3E,IAAI,CAACS,QAAQ,GAAG,IAAIlC,QAAQ,CAC1B,IAAI,CAACsB,KAAK,EACV,IAAI,CAACJ,oBAAoB,EACzB,IAAI,CAACU,gBAAgB,EACrB,IAAI,CAACG,iBAAiB,EACtB,IAAI,CAACC,gBAAgB,EACrB,IAAI,CAACP,gBAAgB,EACrBI,gBAAgB,EAChBC,eAAe,EACf,IAAI,CAACG,cACP,CAAC;IACD,IAAI,CAACE,cAAc,GAAG,IAAIhC,cAAc,CACtC,IAAI,CAACgB,oBAAoB,EACzB,IAAI,CAACa,gBAAgB,EACrB,IAAI,CAACN,uBACP,CAAC;IAED,IAAI,CAACA,uBAAuB,CAACU,iCAAiC,CAAC,CAAC;EAClE;;EAEA;AACF;AACA;AACA;EACSC,iBAAiBA,CACtBC,aAA8B,EAC9BC,iBAAoC,EACpCC,yBAA6C,EAC1B;IACnB,OAAO,IAAI,CAACb,iBAAiB,CAACU,iBAAiB,CAC7CC,aAAa,EACbC,iBAAiB,EACjBC,yBACF,CAAC;EACH;;EAEA;AACF;AACA;EACSC,kBAAkBA,CACvBC,UAAkB,EAClBC,SAAgC,EACT;IACvB,OAAO,IAAI,CAACpB,qBAAqB,CAACqB,YAAY,CAACF,UAAU,EAAEC,SAAS,CAAC;EACvE;;EAEA;AACF;AACA;EACSE,kBAAkBA,CACvBF,SAA+D,EACxC;IACvB,OAAO,IAAI,CAACnB,qBAAqB,CAACoB,YAAY,CAACD,SAAS,CAAC;EAC3D;EAEOG,2BAA2BA,CAChCC,iBAAkE,EAClE;IACA,IAAI,CAACzB,KAAK,CAACwB,2BAA2B,CAACC,iBAAiB,CAAC;EAC3D;;EAEA;AACF;AACA;AACA;AACA;EACSC,0BAA0BA,CAC/BV,aAA8B,EAC9BW,qBAAwC,EACxCC,aAAkB,EAClBC,UAAe,EACI;IACnBC,OAAO,CAACC,IAAI,CACV,mRACF,CAAC;IACD,OAAO,IAAI,CAAC1B,iBAAiB,CAACU,iBAAiB,CAC7CC,aAAa,EACbW,qBAAqB,EACrBK,SAAS,EACTJ,aAAa,EACbC,UACF,CAAC;EACH;;EAEA;AACF;AACA;EACSI,OAAOA,CAACC,MAAkB,EAAmB;IAClD,OAAO,IAAI,CAACtB,QAAQ,CAACqB,OAAO,CAACC,MAAM,CAAC;EACtC;;EAEA;AACF;AACA;EACSC,iBAAiBA,CAACC,OAAgB,EAAQ;IAC/C,IAAI,CAACxB,QAAQ,CAACuB,iBAAiB,CAACC,OAAO,CAAC;EAC1C;;EAEA;AACF;AACA;EACSC,YAAYA,CAACC,WAAmB,EAAEF,OAAgB,EAAQ;IAC/D,IAAI,CAACxB,QAAQ,CAACyB,YAAY,CAACC,WAAW,EAAEF,OAAO,CAAC;EAClD;;EAEA;AACF;AACA;EACSG,WAAWA,CAACD,WAAmB,EAAEE,KAAa,EAAEC,QAAqB,EAAE;IAC5E,IAAI,CAAC7B,QAAQ,CAAC2B,WAAW,CAACD,WAAW,EAAEE,KAAK,EAAEC,QAAQ,CAAC;EACzD;;EAEA;AACF;AACA;EACSC,SAASA,CAAIR,MAAiB,EAAmB;IACtD,OAAO,IAAI,CAACtB,QAAQ,CAAC8B,SAAS,CAACR,MAAM,CAAC;EACxC;;EAEA;AACF;AACA;EACSS,YAAYA,CAACL,WAAmB,EAAED,YAAsB,EAAmB;IAChF,OAAO,IAAI,CAACzB,QAAQ,CAAC+B,YAAY,CAACL,WAAW,EAAED,YAAY,CAAC;EAC9D;;EAEA;AACF;AACA;EACSO,gBAAgBA,CAACP,YAAsB,EAAmB;IAC/D,OAAO,IAAI,CAACzB,QAAQ,CAACgC,gBAAgB,CAACP,YAAY,CAAC;EACrD;;EAEA;AACF;AACA;EACSQ,IAAIA,CAAIP,WAAmB,EAAEJ,MAAiB,EAAmB;IACtE,OAAO,IAAI,CAACtB,QAAQ,CAACiC,IAAI,CAACP,WAAW,EAAEJ,MAAM,CAAC;EAChD;;EAEA;AACF;AACA;EACSY,GAAGA,CAACR,WAAmB,EAAED,YAAsB,EAAmB;IACvE,OAAO,IAAI,CAACzB,QAAQ,CAACkC,GAAG,CAACR,WAAW,EAAED,YAAY,CAAC;EACrD;;EAEA;AACF;AACA;EACSU,KAAKA,CAACT,WAAmB,EAAED,YAAsB,EAAmB;IACzE,OAAO,IAAI,CAACzB,QAAQ,CAACmC,KAAK,CAACT,WAAW,EAAED,YAAY,CAAC;EACvD;;EAEA;AACF;AACA;EACSW,SAASA,CAACV,WAAmB,EAAED,YAAsB,EAAmB;IAC7E,OAAO,IAAI,CAACzB,QAAQ,CAACoC,SAAS,CAACV,WAAW,EAAED,YAAY,CAAC;EAC3D;;EAEA;AACF;AACA;EACSY,YAAYA,CACjBX,WAAmB,EACnBJ,MAAoC,EACnB;IACjB,MAAMgB,QAA0B,GAAG7E,OAAO,CAAC6D,MAAM,CAAC,GAAGA,MAAM,GAAG,CAACA,MAAM,CAAC;IACtE,OAAO,IAAI,CAACtB,QAAQ,CAACqC,YAAY,CAACX,WAAW,EAAEY,QAAQ,CAAC;EAC1D;;EAEA;AACF;AACA;EACSC,WAAWA,CAAIjB,MAAiB,EAAmB;IACxD,OAAO,IAAI,CAACtB,QAAQ,CAACuC,WAAW,CAACjB,MAAM,CAAC;EAC1C;;EAEA;AACF;AACA;EACSkB,cAAcA,CAACd,WAAmB,EAAmB;IAC1D,OAAO,IAAI,CAAC1B,QAAQ,CAACwC,cAAc,CAACd,WAAW,CAAC;EAClD;;EAEA;AACF;AACA;EACSe,kBAAkBA,CAAA,EAAoB;IAC3C,OAAO,IAAI,CAACzC,QAAQ,CAACyC,kBAAkB,CAAC,CAAC;EAC3C;;EAEA;AACF;AACA;EACSC,aAAaA,CAAA,EAAiB;IACnC,OAAO,IAAI,CAAC1C,QAAQ,CAAC0C,aAAa,CAAC,CAAC;EACtC;;EAEA;AACF;AACA;EACSC,MAAMA,CAAA,EAAmB;IAC9B,OAAO,IAAI,CAAC1C,cAAc;EAC5B;;EAEA;AACF;AACA;EACE,MAAa2C,SAASA,CAAA,EAAiC;IACrD,OAAO,MAAMzE,SAAS,CAAC0E,GAAG,CAAC,IAAI,CAAC7D,oBAAoB,CAAC;EACvD;;EAEA;AACF;AACA;EACS8D,aAAaA,CAAA,EAAwB;IAC1C,OAAO3E,SAAS,CAAC4E,OAAO,CAAC,IAAI,CAAC/D,oBAAoB,CAAC;EACrD;AACF","ignoreList":[]}
+{"version":3,"names":["isArray","UniqueIdProvider","Store","OptionProcessorsStore","ComponentRegistry","Commands","LayoutTreeParser","LayoutTreeCrawler","EventsRegistry","CommandsObserver","Constants","ComponentEventsObserver","TouchablePreview","ComponentWrapper","OptionsProcessor","ColorService","AssetService","Deprecations","LayoutProcessor","LayoutProcessorsStore","OptionsCrawler","LinkingHandler","NavigationRoot","constructor","nativeCommandsSender","nativeEventsReceiver","appRegistryService","componentWrapper","store","optionProcessorsStore","layoutProcessorsStore","uniqueIdProvider","componentEventsObserver","componentRegistry","layoutTreeParser","optionsProcessor","layoutProcessor","layoutTreeCrawler","commandsObserver","optionsCrawler","commands","eventsRegistry","linkingHandler","layout","showModal","registerOnceForAllComponentEvents","registerComponent","componentName","componentProvider","concreteComponentProvider","addOptionProcessor","optionPath","processor","addProcessor","addLayoutProcessor","setLazyComponentRegistrator","lazyRegistratorFn","registerComponentWithRedux","getComponentClassFunc","ReduxProvider","reduxStore","console","warn","undefined","setRoot","result","then","setRootReady","catch","setDefaultOptions","options","mergeOptions","componentId","updateProps","props","callback","dismissModal","dismissAllModals","push","pop","popTo","popToRoot","setStackRoot","children","showOverlay","dismissOverlay","dismissAllOverlays","getLaunchArgs","setLinking","config","configure","handleDeepLink","url","handleURL","setLinkingReady","ready","events","constants","get","constantsSync","getSync"],"sourceRoot":"../../src","sources":["Navigation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/NavigationDelegate.js

@@ -158,6 +158,27 @@ export class NavigationDelegate {
     return this.concreteNavigation.getLaunchArgs();
   }
 
+  /**
+   * Configure deep link handling.
+   */
+  setLinking(config) {
+    this.concreteNavigation.setLinking(config);
+  }
+
+  /**
+   * Manually feed a URL into the deep link pipeline.
+   */
+  handleDeepLink(url) {
+    this.concreteNavigation.handleDeepLink(url);
+  }
+
+  /**
+   * Signal readiness to process deep links. Flushes any queued links.
+   */
+  setLinkingReady(ready) {
+    this.concreteNavigation.setLinkingReady(ready);
+  }
+
   /**
    * Obtain the events registry instance
    */

package/lib/module/NavigationDelegate.js.map

@@ -1 +1 @@
-{"version":3,"names":["NavigationRoot","NativeCommandsSender","NativeEventsReceiver","AppRegistryService","NavigationDelegate","constructor","concreteNavigation","createConcreteNavigation","nativeCommandsSender","nativeEventsReceiver","appRegistryService","registerComponent","componentName","componentProvider","concreteComponentProvider","addOptionProcessor","optionPath","processor","addLayoutProcessor","setLazyComponentRegistrator","lazyRegistratorFn","registerComponentWithRedux","getComponentClassFunc","ReduxProvider","reduxStore","setRoot","layout","setDefaultOptions","options","mergeOptions","componentId","updateProps","props","callback","showModal","dismissModal","dismissAllModals","push","pop","popTo","popToRoot","setStackRoot","showOverlay","dismissOverlay","dismissAllOverlays","getLaunchArgs","events","constants","constantsSync","TouchablePreview","mockNativeComponents","mockedNativeCommandsSender","mockedNativeEventsReceiver","mockedAppRegistryService","mock","store"],"sourceRoot":"../../src","sources":["NavigationDelegate.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NavigationRoot","NativeCommandsSender","NativeEventsReceiver","AppRegistryService","NavigationDelegate","constructor","concreteNavigation","createConcreteNavigation","nativeCommandsSender","nativeEventsReceiver","appRegistryService","registerComponent","componentName","componentProvider","concreteComponentProvider","addOptionProcessor","optionPath","processor","addLayoutProcessor","setLazyComponentRegistrator","lazyRegistratorFn","registerComponentWithRedux","getComponentClassFunc","ReduxProvider","reduxStore","setRoot","layout","setDefaultOptions","options","mergeOptions","componentId","updateProps","props","callback","showModal","dismissModal","dismissAllModals","push","pop","popTo","popToRoot","setStackRoot","showOverlay","dismissOverlay","dismissAllOverlays","getLaunchArgs","setLinking","config","handleDeepLink","url","setLinkingReady","ready","events","constants","constantsSync","TouchablePreview","mockNativeComponents","mockedNativeCommandsSender","mockedNativeEventsReceiver","mockedAppRegistryService","mock","store"],"sourceRoot":"../../src","sources":["NavigationDelegate.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -18,4 +18,5 @@ export * from "./interfaces/NavigationFunctionComponent.js";
 export * from "./interfaces/CommandName.js";
 export * from "./interfaces/Processors.js";
 export * from "./interfaces/ProcessorSubscription.js";
+export * from "./linking/types.js";
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NavigationDelegate","navigationDelegate","Navigation"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,yBAAsB;AACzD,MAAMC,kBAAkB,GAAG,IAAID,kBAAkB,CAAC,CAAC;AACnD,OAAO,MAAME,UAAU,GAAGD,kBAAkB;AAC5C,cAAc,uBAAoB;AAClC,cAAc,4BAAyB;AACvC,cAAc,yBAAsB;AACpC,cAAc,iCAA8B;AAC5C,cAAc,wBAAqB;AACnC,cAAc,mCAAgC;AAC9C,cAAc,wBAAqB;AACnC,cAAc,yBAAsB;AACpC,cAAc,qCAAkC;AAChD,cAAc,0CAAuC;AACrD,cAAc,6CAA0C;AACxD,cAAc,6CAA0C;AACxD,cAAc,6BAA0B;AACxC,cAAc,4BAAyB;AACvC,cAAc,uCAAoC","ignoreList":[]}
+{"version":3,"names":["NavigationDelegate","navigationDelegate","Navigation"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,yBAAsB;AACzD,MAAMC,kBAAkB,GAAG,IAAID,kBAAkB,CAAC,CAAC;AACnD,OAAO,MAAME,UAAU,GAAGD,kBAAkB;AAC5C,cAAc,uBAAoB;AAClC,cAAc,4BAAyB;AACvC,cAAc,yBAAsB;AACpC,cAAc,iCAA8B;AAC5C,cAAc,wBAAqB;AACnC,cAAc,mCAAgC;AAC9C,cAAc,wBAAqB;AACnC,cAAc,yBAAsB;AACpC,cAAc,qCAAkC;AAChD,cAAc,0CAAuC;AACrD,cAAc,6CAA0C;AACxD,cAAc,6CAA0C;AACxD,cAAc,6BAA0B;AACxC,cAAc,4BAAyB;AACvC,cAAc,uCAAoC;AAClD,cAAc,oBAAiB","ignoreList":[]}

package/lib/module/linking/DeferredLinkQueue.js

@@ -0,0 +1,52 @@
+"use strict";
+
+/**
+ * Holds URLs while the linking pipeline is not ready and replays them in
+ * order once it becomes ready.
+ *
+ * Readiness is set by the owning `LinkingHandler` and reflects the combined
+ * state of:
+ *   - whether the first `setRoot` has resolved (so a modal can be presented),
+ *   - whether the user-supplied `isReady` predicate (if any) returns `true`.
+ */
+export class DeferredLinkQueue {
+  queue = [];
+  ready = false;
+  flushCallback = null;
+  setFlushCallback(callback) {
+    this.flushCallback = callback;
+  }
+  setReady(ready) {
+    const becameReady = !this.ready && ready;
+    this.ready = ready;
+    if (becameReady) {
+      this.flush();
+    }
+  }
+  isReady() {
+    return this.ready;
+  }
+
+  /**
+   * Enqueue a URL for later processing. Should only be called when the
+   * queue is not ready; the handler decides when to enqueue vs process.
+   */
+  enqueue(url) {
+    this.queue.push(url);
+  }
+  flush() {
+    if (!this.flushCallback) return;
+    const pending = [...this.queue];
+    this.queue = [];
+    for (const url of pending) {
+      this.flushCallback(url);
+    }
+  }
+  clear() {
+    this.queue = [];
+  }
+  pending() {
+    return [...this.queue];
+  }
+}
+//# sourceMappingURL=DeferredLinkQueue.js.map

package/lib/module/linking/DeferredLinkQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DeferredLinkQueue","queue","ready","flushCallback","setFlushCallback","callback","setReady","becameReady","flush","isReady","enqueue","url","push","pending","clear"],"sourceRoot":"../../../src","sources":["linking/DeferredLinkQueue.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAC;EACrBC,KAAK,GAAa,EAAE;EACpBC,KAAK,GAAG,KAAK;EACbC,aAAa,GAAmC,IAAI;EAErDC,gBAAgBA,CAACC,QAA+B,EAAQ;IAC7D,IAAI,CAACF,aAAa,GAAGE,QAAQ;EAC/B;EAEOC,QAAQA,CAACJ,KAAc,EAAQ;IACpC,MAAMK,WAAW,GAAG,CAAC,IAAI,CAACL,KAAK,IAAIA,KAAK;IACxC,IAAI,CAACA,KAAK,GAAGA,KAAK;IAClB,IAAIK,WAAW,EAAE;MACf,IAAI,CAACC,KAAK,CAAC,CAAC;IACd;EACF;EAEOC,OAAOA,CAAA,EAAY;IACxB,OAAO,IAAI,CAACP,KAAK;EACnB;;EAEA;AACF;AACA;AACA;EACSQ,OAAOA,CAACC,GAAW,EAAQ;IAChC,IAAI,CAACV,KAAK,CAACW,IAAI,CAACD,GAAG,CAAC;EACtB;EAEOH,KAAKA,CAAA,EAAS;IACnB,IAAI,CAAC,IAAI,CAACL,aAAa,EAAE;IACzB,MAAMU,OAAO,GAAG,CAAC,GAAG,IAAI,CAACZ,KAAK,CAAC;IAC/B,IAAI,CAACA,KAAK,GAAG,EAAE;IACf,KAAK,MAAMU,GAAG,IAAIE,OAAO,EAAE;MACzB,IAAI,CAACV,aAAa,CAACQ,GAAG,CAAC;IACzB;EACF;EAEOG,KAAKA,CAAA,EAAS;IACnB,IAAI,CAACb,KAAK,GAAG,EAAE;EACjB;EAEOY,OAAOA,CAAA,EAAa;IACzB,OAAO,CAAC,GAAG,IAAI,CAACZ,KAAK,CAAC;EACxB;AACF","ignoreList":[]}

package/lib/module/linking/DeferredLinkQueue.test.js

@@ -0,0 +1,54 @@
+"use strict";
+
+import { DeferredLinkQueue } from "./DeferredLinkQueue.js";
+describe('DeferredLinkQueue', () => {
+  let uut;
+  let flushed;
+  beforeEach(() => {
+    uut = new DeferredLinkQueue();
+    flushed = [];
+    uut.setFlushCallback(url => flushed.push(url));
+  });
+  it('starts not ready', () => {
+    expect(uut.isReady()).toBe(false);
+  });
+  it('enqueues URLs while not ready', () => {
+    uut.enqueue('myapp://a');
+    uut.enqueue('myapp://b');
+    expect(uut.pending()).toEqual(['myapp://a', 'myapp://b']);
+    expect(flushed).toEqual([]);
+  });
+  it('flushes queued URLs in order when becoming ready', () => {
+    uut.enqueue('myapp://a');
+    uut.enqueue('myapp://b');
+    uut.setReady(true);
+    expect(flushed).toEqual(['myapp://a', 'myapp://b']);
+    expect(uut.pending()).toEqual([]);
+  });
+  it('does not re-flush when already ready', () => {
+    uut.setReady(true);
+    uut.enqueue('myapp://a');
+    uut.setReady(true);
+    expect(flushed).toEqual([]);
+    expect(uut.pending()).toEqual(['myapp://a']);
+  });
+  it('flushes again after toggling not-ready → ready', () => {
+    uut.setReady(true);
+    uut.setReady(false);
+    uut.enqueue('myapp://x');
+    uut.setReady(true);
+    expect(flushed).toEqual(['myapp://x']);
+  });
+  it('clear() drops pending URLs', () => {
+    uut.enqueue('myapp://a');
+    uut.clear();
+    uut.setReady(true);
+    expect(flushed).toEqual([]);
+  });
+  it('flush() is a no-op when no callback is registered', () => {
+    const fresh = new DeferredLinkQueue();
+    fresh.enqueue('myapp://a');
+    expect(() => fresh.flush()).not.toThrow();
+  });
+});
+//# sourceMappingURL=DeferredLinkQueue.test.js.map

package/lib/module/linking/DeferredLinkQueue.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DeferredLinkQueue","describe","uut","flushed","beforeEach","setFlushCallback","url","push","it","expect","isReady","toBe","enqueue","pending","toEqual","setReady","clear","fresh","flush","not","toThrow"],"sourceRoot":"../../../src","sources":["linking/DeferredLinkQueue.test.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/linking/LinkingHandler.js

@@ -0,0 +1,139 @@
+"use strict";
+
+import { Linking } from 'react-native';
+import { URLParser } from "./URLParser.js";
+import { RouteMatcher } from "./RouteMatcher.js";
+import { DeferredLinkQueue } from "./DeferredLinkQueue.js";
+import { ModalLayoutBuilder } from "./ModalLayoutBuilder.js";
+
+/** A function that shows a layout as a modal. Mirrors `Commands.showModal`. */
+
+/**
+ * Minimal abstraction over React Native's `Linking` module so the handler
+ * can be tested without touching native bindings.
+ */
+
+/**
+ * Orchestrates deep linking:
+ *
+ *   1. Subscribes to URL events from `Linking` and the initial URL.
+ *   2. Parses + matches each URL against the configured `screens` tree.
+ *   3. Defers processing until both:
+ *        - the first `setRoot` has resolved (so a modal can be presented), and
+ *        - the user-supplied `isReady` predicate (if any) returns `true`.
+ *   4. Resolves matches in this order:
+ *        - `onLink(match)` if provided (full escape hatch), else
+ *        - `getModal(match)` if provided, else
+ *        - the default `ModalLayoutBuilder` output.
+ *      Result is presented via `showModal`.
+ *   5. Calls `fallback(url)` when a URL has no matching prefix or route.
+ */
+export class LinkingHandler {
+  config = null;
+  linkingSubscription = null;
+  rootReady = false;
+  userReadyOverride = null;
+  constructor(showModal, linkingAPI) {
+    this.urlParser = new URLParser();
+    this.routeMatcher = new RouteMatcher();
+    this.deferredQueue = new DeferredLinkQueue();
+    this.modalLayoutBuilder = new ModalLayoutBuilder();
+    this.showModal = showModal;
+    this.linkingAPI = linkingAPI || Linking;
+    this.deferredQueue.setFlushCallback(url => this.processURL(url));
+  }
+  configure(config) {
+    this.teardown();
+    this.config = config;
+    const tree = this.routeMatcher.buildRouteTree(config.config.screens);
+    this.routeMatcher.setRouteTree(tree);
+    this.refreshReady();
+    this.subscribe();
+  }
+
+  /**
+   * Manually feed a URL into the pipeline as if it came from the OS.
+   * Useful for URLs received from push notifications or other sources.
+   */
+  handleURL(url) {
+    if (!this.config) return;
+    if (!this.isReady()) {
+      this.deferredQueue.enqueue(url);
+      return;
+    }
+    this.processURL(url);
+  }
+
+  /**
+   * Called by `NavigationRoot` after the first `setRoot` resolves. Subsequent
+   * calls are no-ops.
+   */
+  setRootReady() {
+    if (this.rootReady) return;
+    this.rootReady = true;
+    this.refreshReady();
+  }
+
+  /**
+   * Public toggle for the app-supplied readiness gate. Overrides the
+   * `config.isReady` predicate from the moment it's first called.
+   */
+  setLinkingReady(ready) {
+    this.userReadyOverride = ready;
+    this.refreshReady();
+  }
+
+  /**
+   * Resolve a URL to a `RouteMatch` without side effects. Returns `null`
+   * when the URL doesn't match any configured prefix or route.
+   */
+  resolve(url) {
+    if (!this.config) return null;
+    const parsed = this.urlParser.parse(url, this.config.prefixes);
+    if (!parsed) return null;
+    return this.routeMatcher.match(parsed.path, url, parsed.queryParams);
+  }
+  teardown() {
+    if (this.linkingSubscription) {
+      this.linkingSubscription.remove();
+      this.linkingSubscription = null;
+    }
+    this.deferredQueue.clear();
+    this.config = null;
+    this.userReadyOverride = null;
+  }
+  subscribe() {
+    this.linkingSubscription = this.linkingAPI.addEventListener('url', event => {
+      this.handleURL(event.url);
+    });
+    this.linkingAPI.getInitialURL().then(url => {
+      if (url) this.handleURL(url);
+    });
+  }
+  processURL(url) {
+    if (!this.config) return;
+    const match = this.resolve(url);
+    if (!match) {
+      this.config.fallback?.(url);
+      return;
+    }
+    if (this.config.onLink) {
+      this.config.onLink(match);
+      return;
+    }
+    const layout = this.config.getModal ? this.config.getModal(match) : this.modalLayoutBuilder.build(match);
+    if (layout) {
+      this.showModal(layout);
+    }
+  }
+  isReady() {
+    if (!this.rootReady) return false;
+    if (this.userReadyOverride !== null) return this.userReadyOverride;
+    if (this.config?.isReady) return this.config.isReady();
+    return true;
+  }
+  refreshReady() {
+    this.deferredQueue.setReady(this.isReady());
+  }
+}
+//# sourceMappingURL=LinkingHandler.js.map

package/lib/module/linking/LinkingHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Linking","URLParser","RouteMatcher","DeferredLinkQueue","ModalLayoutBuilder","LinkingHandler","config","linkingSubscription","rootReady","userReadyOverride","constructor","showModal","linkingAPI","urlParser","routeMatcher","deferredQueue","modalLayoutBuilder","setFlushCallback","url","processURL","configure","teardown","tree","buildRouteTree","screens","setRouteTree","refreshReady","subscribe","handleURL","isReady","enqueue","setRootReady","setLinkingReady","ready","resolve","parsed","parse","prefixes","match","path","queryParams","remove","clear","addEventListener","event","getInitialURL","then","fallback","onLink","layout","getModal","build","setReady"],"sourceRoot":"../../../src","sources":["linking/LinkingHandler.ts"],"mappings":"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","ignoreList":[]}