expo-router 55.0.3 → 55.0.4

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'expo.modules.router'
-version = '55.0.3'
+version = '55.0.4'
 
 android {
   namespace "expo.modules.router"
   defaultConfig {
     versionCode 1
-    versionName "55.0.3"
+    versionName "55.0.4"
   }
   lintOptions {
     abortOnError false

package/expo-module.config.json

@@ -9,7 +9,7 @@
     "publication": {
       "groupId": "expo.modules.router",
       "artifactId": "expo.modules.router",
-      "version": "55.0.3",
+      "version": "55.0.4",
       "repository": "local-maven-repo"
     }
   }

package/ios/ExpoRouter.podspec

@@ -36,10 +36,16 @@ Pod::Spec.new do |s|
     'OTHER_SWIFT_FLAGS' => "$(inherited) #{compiler_flags}",
   }
 
+  s.exclude_files = 'Tests/**/*'
+
   if !$ExpoUseSources&.include?(package['name']) && ENV['EXPO_USE_SOURCE'].to_i == 0 && File.exist?("#{s.name}.xcframework") && Gem::Version.new(Pod::VERSION) >= Gem::Version.new('1.10.0')
     s.source_files = "**/*.h"
     s.vendored_frameworks = "#{s.name}.xcframework"
   else
     s.source_files = "**/*.{h,m,swift,mm,cpp}"
   end
+
+  s.test_spec 'Tests' do |test_spec|
+    test_spec.source_files = 'Tests/**/*.{m,swift}'
+  end
 end

package/ios/LinkPreview/LinkPreviewNativeNavigation.swift

@@ -48,12 +48,12 @@ internal class LinkPreviewNativeNavigation {
     guard let stackOrTabView else {
       return
     }
-    if let tabView = stackOrTabView as? RNSBottomTabsScreenComponentView {
+    if RNScreensTabCompat.isTabScreen(stackOrTabView) {
       let newTabKeys = tabPath?.path.map { $0.newTabKey } ?? []
       // The order is important here. findStackViewWithScreenIdInSubViews must be called
       // even if screenId is nil to compute the tabChangeCommands.
       if let stackView = findStackViewWithScreenIdInSubViews(
-        screenId: screenId, tabKeys: newTabKeys, rootView: tabView), let screenId {
+        screenId: screenId, tabKeys: newTabKeys, rootView: stackOrTabView), let screenId {
         setPreloadedView(stackView: stackView, screenId: screenId)
       }
     } else if let stackView = stackOrTabView as? RNSScreenStackView, let screenId {
@@ -150,8 +150,7 @@ internal class LinkPreviewNativeNavigation {
     if let result =
       enumeratedViews
       .first(where: { _, view in
-        guard let tabView = view as? RNSBottomTabsScreenComponentView, let tabKey = tabView.tabKey
-        else {
+        guard let tabKey = RNScreensTabCompat.tabKey(from: view) else {
           return false
         }
         return tabKeys.contains(tabKey)
@@ -162,13 +161,10 @@ internal class LinkPreviewNativeNavigation {
   }
 
   private func getTabBarControllerFromTabView(view: UIView) -> UITabBarController? {
-    if let tabScreenView = view as? RNSBottomTabsScreenComponentView {
-      return tabScreenView.reactViewController()?.tabBarController as? UITabBarController
+    if let tabBarController = RNScreensTabCompat.tabBarController(fromTabScreen: view) {
+      return tabBarController
     }
-    if let tabHostView = view as? RNSBottomTabsHostComponentView {
-      return tabHostView.controller as? UITabBarController
-    }
-    return nil
+    return RNScreensTabCompat.tabBarController(fromTabHost: view)
   }
 
   private func findStackViewWithScreenIdOrTabBarController(
@@ -182,10 +178,10 @@ internal class LinkPreviewNativeNavigation {
         if view.screenIds.contains(screenId) {
           return view
         }
-      } else if let tabView = nextResponder as? RNSBottomTabsScreenComponentView {
-        if let tabKey = tabView.tabKey, tabKeys.contains(tabKey) {
-          return tabView
-        }
+      } else if let nextView = nextResponder as? UIView,
+        let tabKey = RNScreensTabCompat.tabKey(from: nextView),
+        tabKeys.contains(tabKey) {
+          return nextView
       }
       currentResponder = nextResponder
     }

package/ios/LinkPreview/RNScreensTabCompat.swift

@@ -0,0 +1,42 @@
+import UIKit
+
+/// Instead of casting to concrete class names (which break on renames),
+/// we detect tab views by checking `responds(to:)` for expected selectors
+/// and read properties via KVC.
+enum RNScreensTabCompat {
+  private static let tabKeyName = "tabKey"
+  private static let controllerName = "controller"
+  private static let reactViewControllerName = "reactViewController"
+
+  private static let tabKeySelector = NSSelectorFromString(tabKeyName)
+  private static let controllerSelector = NSSelectorFromString(controllerName)
+  private static let reactViewControllerSelector = NSSelectorFromString(reactViewControllerName)
+
+  // MARK: - Type check
+
+  /// A view is a tab screen if it has a `tabKey` property — specific to RNScreens tab views.
+  static func isTabScreen(_ view: UIView) -> Bool {
+    view.responds(to: tabKeySelector)
+  }
+
+  // MARK: - Property access via KVC
+
+  static func tabKey(from view: UIView) -> String? {
+    guard view.responds(to: tabKeySelector) else { return nil }
+    return view.value(forKey: tabKeyName) as? String
+  }
+
+  /// Calls `reactViewController()` dynamically via `perform(_:)`, then returns `.tabBarController`.
+  static func tabBarController(fromTabScreen view: UIView) -> UITabBarController? {
+    guard isTabScreen(view),
+      view.responds(to: reactViewControllerSelector)
+    else { return nil }
+    let vc = view.perform(reactViewControllerSelector)?.takeUnretainedValue() as? UIViewController
+    return vc?.tabBarController
+  }
+
+  static func tabBarController(fromTabHost view: UIView) -> UITabBarController? {
+    guard view.responds(to: controllerSelector) else { return nil }
+    return view.value(forKey: controllerName) as? UITabBarController
+  }
+}

package/ios/Tests/RNScreensTabCompatTests.swift

@@ -0,0 +1,218 @@
+import Testing
+import UIKit
+
+@testable import ExpoRouter
+
+// MARK: - Mock views
+
+/// Mock tab screen: has @objc tabKey property, mimicking RNScreens tab screen views.
+private class MockTabScreenView: UIView {
+  @objc var tabKey: String?
+}
+
+/// Mock tab host: has @objc controller property, mimicking RNScreens tab host views.
+private class MockTabHostView: UIView {
+  @objc var controller: UIViewController?
+}
+
+/// Mock tab host with a non-UIViewController controller property.
+private class MockTabHostWithBadController: UIView {
+  @objc var controller: NSObject? = NSObject()
+}
+
+/// Mock view with a reactViewController() method that returns a UIViewController.
+private class MockTabScreenWithReactVC: UIView {
+  @objc var tabKey: String?
+  private var _reactViewController: UIViewController?
+
+  func configure(reactViewController: UIViewController) {
+    _reactViewController = reactViewController
+  }
+
+  @objc override func reactViewController() -> UIViewController? {
+    return _reactViewController
+  }
+}
+
+// MARK: - Unit tests
+
+@Suite("RNScreensTabCompat unit tests")
+struct RNScreensTabCompatUnitTests {
+
+  @Suite("isTabScreen")
+  struct IsTabScreen {
+    @Test
+    func `detects mock tab screen`() {
+      let tabScreen = MockTabScreenView()
+      #expect(RNScreensTabCompat.isTabScreen(tabScreen))
+    }
+
+    @Test
+    func `rejects plain UIView`() {
+      let plainView = UIView()
+      #expect(!RNScreensTabCompat.isTabScreen(plainView))
+    }
+
+    @Test
+    func `rejects mock tab host`() {
+      let tabHost = MockTabHostView()
+      #expect(!RNScreensTabCompat.isTabScreen(tabHost))
+    }
+  }
+
+  @Suite("tabKey")
+  struct TabKey {
+    @Test
+    func `reads value`() {
+      let tabScreen = MockTabScreenView()
+      tabScreen.tabKey = "home"
+      #expect(RNScreensTabCompat.tabKey(from: tabScreen) == "home")
+    }
+
+    @Test
+    func `returns nil for nil tab key`() {
+      let tabScreen = MockTabScreenView()
+      tabScreen.tabKey = nil
+      #expect(RNScreensTabCompat.tabKey(from: tabScreen) == nil)
+    }
+
+    @Test
+    func `returns nil for plain UIView`() {
+      let plainView = UIView()
+      #expect(RNScreensTabCompat.tabKey(from: plainView) == nil)
+    }
+  }
+
+  @Suite("tabBarController(fromTabHost:)")
+  struct TabBarControllerFromTabHost {
+    @Test
+    func `returns tab bar controller`() {
+      let tabHost = MockTabHostView()
+      let tabBarController = UITabBarController()
+      tabHost.controller = tabBarController
+      #expect(RNScreensTabCompat.tabBarController(fromTabHost: tabHost) === tabBarController)
+    }
+
+    @Test
+    func `returns nil for non-tab bar controller`() {
+      let tabHost = MockTabHostView()
+      tabHost.controller = UIViewController()
+      #expect(RNScreensTabCompat.tabBarController(fromTabHost: tabHost) == nil)
+    }
+
+    @Test
+    func `returns nil for nil controller`() {
+      let tabHost = MockTabHostView()
+      tabHost.controller = nil
+      #expect(RNScreensTabCompat.tabBarController(fromTabHost: tabHost) == nil)
+    }
+
+    @Test
+    func `returns nil for non-UIViewController type`() {
+      let tabHost = MockTabHostWithBadController()
+      #expect(RNScreensTabCompat.tabBarController(fromTabHost: tabHost) == nil)
+    }
+
+    @Test
+    func `returns nil for plain UIView`() {
+      let plainView = UIView()
+      #expect(RNScreensTabCompat.tabBarController(fromTabHost: plainView) == nil)
+    }
+  }
+
+  @Suite("tabBarController(fromTabScreen:)")
+  struct TabBarControllerFromTabScreen {
+    @Test
+    func `returns tab bar controller via reactViewController`() {
+      let tabBarController = UITabBarController()
+      let childVC = UIViewController()
+      tabBarController.viewControllers = [childVC]
+
+      let mockView = MockTabScreenWithReactVC()
+      mockView.tabKey = "tab1"
+      mockView.configure(reactViewController: childVC)
+      childVC.view.addSubview(mockView)
+
+      let result = RNScreensTabCompat.tabBarController(fromTabScreen: mockView)
+      #expect(result === tabBarController)
+    }
+
+    @Test
+    func `returns nil when reactViewController returns nil`() {
+      let mockView = MockTabScreenWithReactVC()
+      mockView.tabKey = "tab1"
+      // Don't configure — reactViewController() returns nil
+      #expect(RNScreensTabCompat.tabBarController(fromTabScreen: mockView) == nil)
+    }
+
+    @Test
+    func `returns nil when no reactViewController method`() {
+      // MockTabScreenView has tabKey but no reactViewController() method
+      let mockView = MockTabScreenView()
+      mockView.tabKey = "tab1"
+      #expect(RNScreensTabCompat.tabBarController(fromTabScreen: mockView) == nil)
+    }
+
+    @Test
+    func `returns nil for plain UIView`() {
+      let plainView = UIView()
+      #expect(RNScreensTabCompat.tabBarController(fromTabScreen: plainView) == nil)
+    }
+
+    @Test
+    func `returns nil when not in tab bar controller`() {
+      let navController = UINavigationController()
+      let childVC = UIViewController()
+      navController.viewControllers = [childVC]
+
+      let mockView = MockTabScreenWithReactVC()
+      mockView.tabKey = "tab1"
+      mockView.configure(reactViewController: childVC)
+      childVC.view.addSubview(mockView)
+
+      #expect(RNScreensTabCompat.tabBarController(fromTabScreen: mockView) == nil)
+    }
+  }
+}
+
+// MARK: - Integration tests (RNScreens API contract)
+
+@Suite("RNScreens API contract")
+struct RNScreensAPIContractTests {
+
+  @Test
+  func `tab screen class responds to tabKey`() throws {
+    let cls = NSClassFromString("RNSTabsScreenComponentView")
+      ?? NSClassFromString("RNSBottomTabsScreenComponentView")
+    guard let cls else {
+      Issue.record("No tab screen class found — neither RNSTabsScreenComponentView nor RNSBottomTabsScreenComponentView")
+      return
+    }
+    let view = try #require((cls as? UIView.Type)?.init(), "Failed to instantiate tab screen class")
+    #expect(view.responds(to: NSSelectorFromString("tabKey")))
+  }
+
+  @Test
+  func `tab host class responds to controller`() throws {
+    let cls = NSClassFromString("RNSTabsHostComponentView")
+      ?? NSClassFromString("RNSBottomTabsHostComponentView")
+    guard let cls else {
+      Issue.record("No tab host class found — neither RNSTabsHostComponentView nor RNSBottomTabsHostComponentView")
+      return
+    }
+    let view = try #require((cls as? UIView.Type)?.init(), "Failed to instantiate tab host class")
+    #expect(view.responds(to: NSSelectorFromString("controller")))
+  }
+
+  @Test
+  func `tab screen class responds to reactViewController`() throws {
+    let cls = NSClassFromString("RNSTabsScreenComponentView")
+      ?? NSClassFromString("RNSBottomTabsScreenComponentView")
+    guard let cls else {
+      Issue.record("No tab screen class found")
+      return
+    }
+    let view = try #require((cls as? UIView.Type)?.init(), "Failed to instantiate tab screen class")
+    #expect(view.responds(to: NSSelectorFromString("reactViewController")))
+  }
+}

package/local-maven-repo/expo/modules/router/expo.modules.router/{55.0.3/expo.modules.router-55.0.3.module → 55.0.4/expo.modules.router-55.0.4.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "expo.modules.router",
     "module": "expo.modules.router",
-    "version": "55.0.3",
+    "version": "55.0.4",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.router-55.0.3.aar",
-          "url": "expo.modules.router-55.0.3.aar",
+          "name": "expo.modules.router-55.0.4.aar",
+          "url": "expo.modules.router-55.0.4.aar",
           "size": 13684,
           "sha512": "096e87bdf28a3c152ae7522330d6395eb967a309de7a888cc9e2654bbed45dc52d89fc7153bda0870732d72a1d938c0508be24b0b213c592e4dd61e3b105f1f2",
           "sha256": "3bdd36a13fbff4fb9fa0e431e2f71ab69c3d52d2fd72e9dad006249c6d447dcb",
@@ -60,8 +60,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.router-55.0.3.aar",
-          "url": "expo.modules.router-55.0.3.aar",
+          "name": "expo.modules.router-55.0.4.aar",
+          "url": "expo.modules.router-55.0.4.aar",
           "size": 13684,
           "sha512": "096e87bdf28a3c152ae7522330d6395eb967a309de7a888cc9e2654bbed45dc52d89fc7153bda0870732d72a1d938c0508be24b0b213c592e4dd61e3b105f1f2",
           "sha256": "3bdd36a13fbff4fb9fa0e431e2f71ab69c3d52d2fd72e9dad006249c6d447dcb",
@@ -80,8 +80,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.router-55.0.3-sources.jar",
-          "url": "expo.modules.router-55.0.3-sources.jar",
+          "name": "expo.modules.router-55.0.4-sources.jar",
+          "url": "expo.modules.router-55.0.4-sources.jar",
           "size": 2326,
           "sha512": "a1a1537b57bc0d66efbf2bdfd5f514684400b9598e549eaf53c528d1bf32ff42b7826e74fb6e115f8ec0490b9e06ffbb3c3efe9f2f703652c13291ef82b0fa03",
           "sha256": "2add0f802e663eb9b5f90e086dca0e0e337a1442e15fb372a05945e01ee0d289",

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.module.md5

@@ -0,0 +1 @@
+82cf2014bdbdf74cb8cf19d9375fc03d

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.module.sha1

@@ -0,0 +1 @@
+e640f9cfac6e95583ed6f9bdba6a006a6240dad0

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.module.sha256

@@ -0,0 +1 @@
+4c93d299d67f15be595a30acad1fabb81eae91a46482905bdb7c9b17413bde3d

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.module.sha512

@@ -0,0 +1 @@
+753a12d23875429f58c10d06635e2b14163efbc4688d9170856d797bdcdb740e3ff2cb5fa47f284c9dbc3790eda1db9630a1a5666e31a16f590b1685a3d20069

package/local-maven-repo/expo/modules/router/expo.modules.router/{55.0.3/expo.modules.router-55.0.3.pom → 55.0.4/expo.modules.router-55.0.4.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>expo.modules.router</groupId>
   <artifactId>expo.modules.router</artifactId>
-  <version>55.0.3</version>
+  <version>55.0.4</version>
   <packaging>aar</packaging>
   <name>expo.modules.router</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.pom.md5

@@ -0,0 +1 @@
+25169469f304d50c77c6a70d12538ec3

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.pom.sha1

@@ -0,0 +1 @@
+ca970068080fc0f997af685eaae7797d9a92dd52

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.pom.sha256

@@ -0,0 +1 @@
+d9eb6b521e8b1ce783fb679caf5bbae203e18a2d18e57489f5e2cf0681d45348

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.4/expo.modules.router-55.0.4.pom.sha512

@@ -0,0 +1 @@
+9df1959265f7c2e7bd5b13c47c4fed04443d49e69d95783dd6fc42394537e6ea94ba189c406f7f8e8bdb9d748e6e4d884b028c5bcab9695bcaa27f166569d34e

package/local-maven-repo/expo/modules/router/expo.modules.router/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>expo.modules.router</groupId>
   <artifactId>expo.modules.router</artifactId>
   <versioning>
-    <latest>55.0.3</latest>
-    <release>55.0.3</release>
+    <latest>55.0.4</latest>
+    <release>55.0.4</release>
     <versions>
-      <version>55.0.3</version>
+      <version>55.0.4</version>
     </versions>
-    <lastUpdated>20260226223009</lastUpdated>
+    <lastUpdated>20260305092617</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/expo/modules/router/expo.modules.router/maven-metadata.xml.md5

@@ -1 +1 @@
-33890813af54076e08f5b09a86c51921
+4496827117cd08e8419ca36d630e4cc6

package/local-maven-repo/expo/modules/router/expo.modules.router/maven-metadata.xml.sha1

@@ -1 +1 @@
-82b58ca11e3bddae259556d8a2e863da65b086e2
+515ffef5b9101c880d698789aa98f91732b50193

package/local-maven-repo/expo/modules/router/expo.modules.router/maven-metadata.xml.sha256

@@ -1 +1 @@
-5cb61d47baa4af00e9b601c4e4e66691a640d22458791a26e2aa6ffa4da338db
+0572e3c0a82989400498bcd939927134a7509d3d2c18a37a9a15b57f444ef6a0

package/local-maven-repo/expo/modules/router/expo.modules.router/maven-metadata.xml.sha512

@@ -1 +1 @@
-a069464ad1b206977dd9abeead380c7bd77577585b4d6838fcb5b1ee82f13602d40351e4055ed501cb138d5e70f98c830599205238da6fdd3fb3581c90d5d699
+ffe8321b14985146d579691e0251330102ab7ae3542a39187b40ff60c7564b3a0c5e4fdad8f9326d100f077d75019b693a2f75bebf8542a0e7d6c35c15691249

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-router",
-  "version": "55.0.3",
+  "version": "55.0.4",
   "description": "Expo Router is a file-based router for React Native and web applications.",
   "author": "650 Industries, Inc.",
   "license": "MIT",
@@ -144,9 +144,9 @@
     "debug": "^4.3.4",
     "escape-string-regexp": "^4.0.0",
     "expo-glass-effect": "^55.0.7",
-    "expo-image": "^55.0.5",
+    "expo-image": "^55.0.6",
     "expo-server": "^55.0.6",
-    "expo-symbols": "^55.0.4",
+    "expo-symbols": "^55.0.5",
     "fast-deep-equal": "^3.1.3",
     "invariant": "^2.2.4",
     "nanoid": "^3.3.8",
@@ -160,5 +160,5 @@
     "use-latest-callback": "^0.2.1",
     "vaul": "^1.1.2"
   },
-  "gitHead": "413b0450434d3e456eb391eca792ee9ac1e1efec"
+  "gitHead": "756404b0eb18d441b54c7136b4142349193f554b"
 }

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.module.md5

@@ -1 +0,0 @@
-dcff82ba1cd5c5dd8b91118d94889523

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.module.sha1

@@ -1 +0,0 @@
-59d22fd3b2a09b409814f02180c86cd228bc8b3d

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.module.sha256

@@ -1 +0,0 @@
-3409f52bea4c41fddd03ab99a0ecefc0fc9e2aa4c89fa17c84c23f823fe00f37

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.module.sha512

@@ -1 +0,0 @@
-3d212a0d2fac1a63ab3ac17b1ebae05e95d4c4e6a7281dc90e7aa7755082ba0534bd746fc69e8e7a1bdd0f7c92e6c55f3e5342694d6151d8d7f060983bc22d9b

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.pom.md5

@@ -1 +0,0 @@
-6d2a83488fc401645471e646e24c9d67

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.pom.sha1

@@ -1 +0,0 @@
-2e08b11a632d6dd6e965271fa67584a72d421278

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.pom.sha256

@@ -1 +0,0 @@
-18b1a4968d3848c5b29a13f8a5f3c02d52cebf864d04a6fff475252e8b1d2ca9

package/local-maven-repo/expo/modules/router/expo.modules.router/55.0.3/expo.modules.router-55.0.3.pom.sha512

@@ -1 +0,0 @@
-ed74b55712827d3be2b41bee0400f652a18b21b20b2fe35c562de840d32c2807f8bbe4a30b293260a7ba4b5b3c2a944638bc9049244eb6a36f7fff4d7243a1ee

package/plugin/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["./src/index.ts"],"version":"5.8.3"}