expo-router 55.0.3 → 55.0.5

package/android/build.gradle

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

package/build/getReactNavigationConfig.d.ts

@@ -7,7 +7,7 @@ export type Screen = string | {
 };
 export declare function parseRouteSegments(segments: string): string;
 export declare function getReactNavigationScreensConfig(nodes: RouteNode[], metaOnly: boolean): Record<string, Screen>;
-export declare function getReactNavigationConfig(routes: RouteNode, metaOnly: boolean): {
+export declare function getReactNavigationConfig(routeTree: RouteNode | null, metaOnly: boolean): {
     initialRouteName: undefined;
     screens: Record<string, Screen>;
 };

package/build/getReactNavigationConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getReactNavigationConfig.d.ts","sourceRoot":"","sources":["../src/getReactNavigationConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,MAAM,MAAM,MAAM,GACd,MAAM,GACN;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAsBN,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc3D;AAoCD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO;;;EAY5E"}
+{"version":3,"file":"getReactNavigationConfig.d.ts","sourceRoot":"","sources":["../src/getReactNavigationConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,MAAM,MAAM,MAAM,GACd,MAAM,GACN;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAsBN,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc3D;AAoCD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO;;;EAatF"}

package/build/getReactNavigationConfig.js

@@ -71,15 +71,15 @@ function convertRouteNodeToScreen(node, metaOnly) {
 function getReactNavigationScreensConfig(nodes, metaOnly) {
     return Object.fromEntries(nodes.map((node) => [node.route, convertRouteNodeToScreen(node, metaOnly)]));
 }
-function getReactNavigationConfig(routes, metaOnly) {
+function getReactNavigationConfig(routeTree, metaOnly) {
     const config = {
         initialRouteName: undefined,
-        screens: getReactNavigationScreensConfig(routes.children, metaOnly),
+        screens: routeTree ? getReactNavigationScreensConfig(routeTree.children, metaOnly) : {},
     };
-    if (routes.initialRouteName) {
+    if (routeTree?.initialRouteName) {
         // We're using LinkingOptions the generic type is `object` instead of a proper ParamList.
         // So we need to cast the initialRouteName to `any` to avoid type errors.
-        config.initialRouteName = routes.initialRouteName;
+        config.initialRouteName = routeTree.initialRouteName;
     }
     return config;
 }

package/build/getReactNavigationConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"getReactNavigationConfig.js","sourceRoot":"","sources":["../src/getReactNavigationConfig.ts"],"names":[],"mappings":";;AAgCA,gDAcC;AAoCD,0EAOC;AAED,4DAYC;AAtGD,yCAA8C;AAW9C,sBAAsB;AACtB,mBAAmB;AACnB,SAAS,oCAAoC,CAAC,OAAe;IAC3D,wEAAwE;IACxE,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,WAAW,GAAG,IAAA,2BAAgB,EAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;SAAM,IAAI,WAAW,EAAE,IAAI,EAAE,CAAC;QAC7B,OAAO,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,QAAgB;IACjD,OAAO;IACL,gEAAgE;IAChE,yDAAyD;IACzD,qEAAqE;IACrE,QAAQ;SACL,KAAK,CAAC,GAAG,CAAC;QACX,qDAAqD;SACpD,GAAG,CAAC,oCAAoC,CAAC;QAC1C,sDAAsD;SACrD,MAAM,CAAC,OAAO,CAAC;QAChB,4BAA4B;SAC3B,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAe,EAAE,QAAiB;IAClE,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,IAAI;aACb,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,+BAA+B,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAW;QACrB,IAAI;QACJ,OAAO;KACR,CAAC;IAEF,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,mEAAmE;QACnE,kEAAkE;QAClE,6EAA6E;QAC7E,2CAA2C;QAC3C,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,+BAA+B,CAC7C,KAAkB,EAClB,QAAiB;IAEjB,OAAO,MAAM,CAAC,WAAW,CACvB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAU,CAAC,CACrF,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CAAC,MAAiB,EAAE,QAAiB;IAC3E,MAAM,MAAM,GAAG;QACb,gBAAgB,EAAE,SAAS;QAC3B,OAAO,EAAE,+BAA+B,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACpE,CAAC;IAEF,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,yFAAyF;QACzF,yEAAyE;QACzE,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAuB,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { RouteNode } from './Route';\nimport { matchDynamicName } from './matchers';\n\nexport type Screen =\n  | string\n  | {\n      path: string;\n      screens: Record<string, Screen>;\n      _route?: RouteNode;\n      initialRouteName?: string;\n    };\n\n// `[page]` -> `:page`\n// `page` -> `page`\nfunction convertDynamicRouteToReactNavigation(segment: string): string {\n  // NOTE(EvanBacon): To support shared routes we preserve group segments.\n  if (segment === 'index') {\n    return '';\n  }\n  if (segment === '+not-found') {\n    return '*not-found';\n  }\n  const dynamicName = matchDynamicName(segment);\n  if (dynamicName && !dynamicName.deep) {\n    return `:${dynamicName.name}`;\n  } else if (dynamicName?.deep) {\n    return '*' + dynamicName.name;\n  } else {\n    return segment;\n  }\n}\n\nexport function parseRouteSegments(segments: string): string {\n  return (\n    // NOTE(EvanBacon): When there are nested routes without layouts\n    // the node.route will be something like `app/home/index`\n    // this needs to be split to ensure each segment is parsed correctly.\n    segments\n      .split('/')\n      // Convert each segment to a React Navigation format.\n      .map(convertDynamicRouteToReactNavigation)\n      // Remove any empty paths from groups or index routes.\n      .filter(Boolean)\n      // Join to return as a path.\n      .join('/')\n  );\n}\n\nfunction convertRouteNodeToScreen(node: RouteNode, metaOnly: boolean): Screen {\n  const path = parseRouteSegments(node.route);\n  if (!node.children.length) {\n    if (!metaOnly) {\n      return {\n        path,\n        screens: {},\n        _route: node,\n      };\n    }\n    return path;\n  }\n  const screens = getReactNavigationScreensConfig(node.children, metaOnly);\n\n  const screen: Screen = {\n    path,\n    screens,\n  };\n\n  if (node.initialRouteName) {\n    // NOTE(EvanBacon): This is bad because it forces all Layout Routes\n    // to be loaded into memory. We should move towards a system where\n    // the initial route name is either loaded asynchronously in the Layout Route\n    // or defined via a file system convention.\n    screen.initialRouteName = node.initialRouteName;\n  }\n\n  if (!metaOnly) {\n    screen._route = node;\n  }\n\n  return screen;\n}\n\nexport function getReactNavigationScreensConfig(\n  nodes: RouteNode[],\n  metaOnly: boolean\n): Record<string, Screen> {\n  return Object.fromEntries(\n    nodes.map((node) => [node.route, convertRouteNodeToScreen(node, metaOnly)] as const)\n  );\n}\n\nexport function getReactNavigationConfig(routes: RouteNode, metaOnly: boolean) {\n  const config = {\n    initialRouteName: undefined,\n    screens: getReactNavigationScreensConfig(routes.children, metaOnly),\n  };\n\n  if (routes.initialRouteName) {\n    // We're using LinkingOptions the generic type is `object` instead of a proper ParamList.\n    // So we need to cast the initialRouteName to `any` to avoid type errors.\n    config.initialRouteName = routes.initialRouteName as any;\n  }\n  return config;\n}\n"]}
+{"version":3,"file":"getReactNavigationConfig.js","sourceRoot":"","sources":["../src/getReactNavigationConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RouteNode } from './Route';\nimport { matchDynamicName } from './matchers';\n\nexport type Screen =\n  | string\n  | {\n      path: string;\n      screens: Record<string, Screen>;\n      _route?: RouteNode;\n      initialRouteName?: string;\n    };\n\n// `[page]` -> `:page`\n// `page` -> `page`\nfunction convertDynamicRouteToReactNavigation(segment: string): string {\n  // NOTE(EvanBacon): To support shared routes we preserve group segments.\n  if (segment === 'index') {\n    return '';\n  }\n  if (segment === '+not-found') {\n    return '*not-found';\n  }\n  const dynamicName = matchDynamicName(segment);\n  if (dynamicName && !dynamicName.deep) {\n    return `:${dynamicName.name}`;\n  } else if (dynamicName?.deep) {\n    return '*' + dynamicName.name;\n  } else {\n    return segment;\n  }\n}\n\nexport function parseRouteSegments(segments: string): string {\n  return (\n    // NOTE(EvanBacon): When there are nested routes without layouts\n    // the node.route will be something like `app/home/index`\n    // this needs to be split to ensure each segment is parsed correctly.\n    segments\n      .split('/')\n      // Convert each segment to a React Navigation format.\n      .map(convertDynamicRouteToReactNavigation)\n      // Remove any empty paths from groups or index routes.\n      .filter(Boolean)\n      // Join to return as a path.\n      .join('/')\n  );\n}\n\nfunction convertRouteNodeToScreen(node: RouteNode, metaOnly: boolean): Screen {\n  const path = parseRouteSegments(node.route);\n  if (!node.children.length) {\n    if (!metaOnly) {\n      return {\n        path,\n        screens: {},\n        _route: node,\n      };\n    }\n    return path;\n  }\n  const screens = getReactNavigationScreensConfig(node.children, metaOnly);\n\n  const screen: Screen = {\n    path,\n    screens,\n  };\n\n  if (node.initialRouteName) {\n    // NOTE(EvanBacon): This is bad because it forces all Layout Routes\n    // to be loaded into memory. We should move towards a system where\n    // the initial route name is either loaded asynchronously in the Layout Route\n    // or defined via a file system convention.\n    screen.initialRouteName = node.initialRouteName;\n  }\n\n  if (!metaOnly) {\n    screen._route = node;\n  }\n\n  return screen;\n}\n\nexport function getReactNavigationScreensConfig(\n  nodes: RouteNode[],\n  metaOnly: boolean\n): Record<string, Screen> {\n  return Object.fromEntries(\n    nodes.map((node) => [node.route, convertRouteNodeToScreen(node, metaOnly)] as const)\n  );\n}\n\nexport function getReactNavigationConfig(routeTree: RouteNode | null, metaOnly: boolean) {\n  const config = {\n    initialRouteName: undefined,\n    screens: routeTree ? getReactNavigationScreensConfig(routeTree.children, metaOnly) : {},\n  };\n\n  if (routeTree?.initialRouteName) {\n    // We're using LinkingOptions the generic type is `object` instead of a proper ParamList.\n    // So we need to cast the initialRouteName to `any` to avoid type errors.\n    config.initialRouteName = routeTree.initialRouteName as any;\n  }\n\n  return config;\n}\n"]}

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.5",
       "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.5/expo.modules.router-55.0.5.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "expo.modules.router",
     "module": "expo.modules.router",
-    "version": "55.0.3",
+    "version": "55.0.5",
     "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.5.aar",
+          "url": "expo.modules.router-55.0.5.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.5.aar",
+          "url": "expo.modules.router-55.0.5.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.5-sources.jar",
+          "url": "expo.modules.router-55.0.5-sources.jar",
           "size": 2326,
           "sha512": "a1a1537b57bc0d66efbf2bdfd5f514684400b9598e549eaf53c528d1bf32ff42b7826e74fb6e115f8ec0490b9e06ffbb3c3efe9f2f703652c13291ef82b0fa03",
           "sha256": "2add0f802e663eb9b5f90e086dca0e0e337a1442e15fb372a05945e01ee0d289",

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

@@ -0,0 +1 @@
+7f1015ac9bfa1fb23cf80ef3a93d7936

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

@@ -0,0 +1 @@
+795c084bbde2560a4d31bbb8120ab9e3d8871ad3

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

@@ -0,0 +1 @@
+bd938df8799536e5bad775a74e93fb22bfed780edb67ec90c224265d3de22894

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

@@ -0,0 +1 @@
+181c67244df19ea37ff62d66345b8284555e4d864e72467a900d708ce0baf2a8883c793f1b88c0598bb6107547286181c9c27cf71c09d87bc1ac634cf40dfa13

package/local-maven-repo/expo/modules/router/expo.modules.router/{55.0.3/expo.modules.router-55.0.3.pom → 55.0.5/expo.modules.router-55.0.5.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.5</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.5/expo.modules.router-55.0.5.pom.md5

@@ -0,0 +1 @@
+e97db10758542ec585326c3219ed474f

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

@@ -0,0 +1 @@
+412af68f3b0de7e1fe04f4d80a97a59d3f21cbad

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

@@ -0,0 +1 @@
+7c0c7fe3c2b1497588f1ca29d731cf8b9ef31d37738a4b78a0d1360d346bff86

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

@@ -0,0 +1 @@
+223324ba2cf6eaa09fe1c9c7b8fcb5b60b9d8942926b66303034db4acbbcfbdfcfe48343172042381f9fd98e557121a00231393b514ae71173c3d3ada31ab477

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.5</latest>
+    <release>55.0.5</release>
     <versions>
-      <version>55.0.3</version>
+      <version>55.0.5</version>
     </versions>
-    <lastUpdated>20260226223009</lastUpdated>
+    <lastUpdated>20260311141659</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-33890813af54076e08f5b09a86c51921
+30335fecbcab7d367223533228dabb85

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

@@ -1 +1 @@
-82b58ca11e3bddae259556d8a2e863da65b086e2
+0152624c82ad683b9f5143c521d4a4bbbde4594b

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

@@ -1 +1 @@
-5cb61d47baa4af00e9b601c4e4e66691a640d22458791a26e2aa6ffa4da338db
+603335e2005f23bb5072fead26e065ebcf2b51e441325e751da4e66dbb58f26a

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

@@ -1 +1 @@
-a069464ad1b206977dd9abeead380c7bd77577585b4d6838fcb5b1ee82f13602d40351e4055ed501cb138d5e70f98c830599205238da6fdd3fb3581c90d5d699
+9f737311a339e4245c099a3dcc70849dcdb329bbe9441b7f8ccb932d35ec400c3f58ef758070bc34b4a2b40d555fa139ee32eadb5cf0b22eb1687923134984cd

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-router",
-  "version": "55.0.3",
+  "version": "55.0.5",
   "description": "Expo Router is a file-based router for React Native and web applications.",
   "author": "650 Industries, Inc.",
   "license": "MIT",
@@ -143,10 +143,10 @@
     "client-only": "^0.0.1",
     "debug": "^4.3.4",
     "escape-string-regexp": "^4.0.0",
-    "expo-glass-effect": "^55.0.7",
-    "expo-image": "^55.0.5",
+    "expo-glass-effect": "^55.0.8",
+    "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": "bcdd2c239f8a92cdf5140e35cde768352630acd6"
 }

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"}