@expo/ui 58.0.0 → 58.0.1

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 58.0.1 — 2026-09-14
+
+### 💡 Others
+
+- Update the native tabs import path in the `TabView` API reference. ([#50119](https://github.com/expo/expo/pull/50119) by [@Ubax](https://github.com/Ubax))
+
 ## 58.0.0 — 2026-09-10
 
 ### 🛠 Breaking changes
@@ -47,6 +53,7 @@
 - [iOS] Added the `scrollClipDisabled` modifier, which lets content that draws outside a scrollable view's bounds, such as a shadow or a scaled-up card, stay visible instead of being clipped. ([#49780](https://github.com/expo/expo/pull/49780) by [@Den1Marshall](https://github.com/Den1Marshall))
 - [iOS] Taught the `tint`, `border`, `strokeBorder` and `containerBackground` modifiers to paint with any `ShapeStyle`, matching SwiftUI, where all four take a `ShapeStyle` rather than a color. The `color` parameter of `border` and `strokeBorder` is deprecated in favor of `content`, the name SwiftUI gives it. ([#49838](https://github.com/expo/expo/pull/49838) by [@Den1Marshall](https://github.com/Den1Marshall))
 - [iOS] Added the `NavigationStack` and `Toolbar` components, the `navigationTitle` modifier, and the `close` button role. ([#49940](https://github.com/expo/expo/pull/49940) by [@nishan](https://github.com/intergalacticspacehighway))
+- [iOS] Added the `NavigationLink` component, and the `path` and `onPathChange` props and the `NavigationDestination` component, so a stack can push a destination that is built only when the link is followed. ([#49991](https://github.com/expo/expo/pull/49991) by [@nishan](https://github.com/intergalacticspacehighway))
 
 ### 🐛 Bug fixes
 
@@ -78,6 +85,7 @@
 - [Android] Explicitly enable `buildFeatures.buildConfig`, required by AGP 9. ([#47729](https://github.com/expo/expo/pull/47729) by [@gabrieldonadel](https://github.com/gabrieldonadel))
 - Fix `Host` color scheme type errors on React Native 0.87. ([#47729](https://github.com/expo/expo/pull/47729) by [@gabrieldonadel](https://github.com/gabrieldonadel))
 - [iOS] Fixed `PlatformColor` and `DynamicColorIOS` values dropping the `backgroundColor` and `borderColor` of a universal component. Both were stringified to `"[object Object]"`, which the native color converter rejects, so the modifier was discarded without a trace. ([#49746](https://github.com/expo/expo/pull/49746) by [@Den1Marshall](https://github.com/Den1Marshall))
+- [iOS] Preserve string-based child identities in `Overlay`, `Background`, and `Mask`. ([#49734](https://github.com/expo/expo/pull/49734) by [@jakex7](https://github.com/jakex7))
 
 ### 💡 Others
 

package/android/build/intermediates/incremental/release/packageReleaseResources/compile-file-map.properties

@@ -1 +1 @@
-#Thu Sep 10 20:19:44 IST 2026
+#Mon Sep 14 16:00:38 IST 2026

package/android/build/publications/release/module.json

@@ -3,7 +3,7 @@
   "component": {
     "group": "expo.modules.ui",
     "module": "expo.modules.ui",
-    "version": "58.0.0",
+    "version": "58.0.1",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-58.0.0.aar",
-          "url": "expo.modules.ui-58.0.0.aar",
+          "name": "expo.modules.ui-58.0.1.aar",
+          "url": "expo.modules.ui-58.0.1.aar",
           "size": 1789469,
           "sha512": "dfe706437f10aa521a458896b97fa14d945cf66c80dab9cc43fddd444cddd016073b783076f38ba90e07c5076b8752bf66e136ce9c40d85195cf27a231ce7f9d",
           "sha256": "8faeae3cb56c1d29d1a120a9a8c1964e6015ba993519f244283855a066a1704c",
@@ -141,8 +141,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.ui-58.0.0.aar",
-          "url": "expo.modules.ui-58.0.0.aar",
+          "name": "expo.modules.ui-58.0.1.aar",
+          "url": "expo.modules.ui-58.0.1.aar",
           "size": 1789469,
           "sha512": "dfe706437f10aa521a458896b97fa14d945cf66c80dab9cc43fddd444cddd016073b783076f38ba90e07c5076b8752bf66e136ce9c40d85195cf27a231ce7f9d",
           "sha256": "8faeae3cb56c1d29d1a120a9a8c1964e6015ba993519f244283855a066a1704c",
@@ -161,8 +161,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-58.0.0-sources.jar",
-          "url": "expo.modules.ui-58.0.0-sources.jar",
+          "name": "expo.modules.ui-58.0.1-sources.jar",
+          "url": "expo.modules.ui-58.0.1-sources.jar",
           "size": 106165,
           "sha512": "59ec9e524c62a8b77c41e894e4833d24d2c9bb1912ef1be23d81ab6eb04bcf1f8743cdc11528bf2630b0f1f29db20b017e8015ebde418530196d7dcea06a90bc",
           "sha256": "297ecd2b76dbb6908b0b2897c6adba6be5dd10cb16c8ca169525a40e207d52c2",

package/android/build/publications/release/pom-default.xml

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

package/android/build/tmp/publishReleasePublicationToNPMPackageRepository/module-maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>expo.modules.ui</groupId>
   <artifactId>expo.modules.ui</artifactId>
   <versioning>
-    <latest>58.0.0</latest>
-    <release>58.0.0</release>
+    <latest>58.0.1</latest>
+    <release>58.0.1</release>
     <versions>
-      <version>58.0.0</version>
+      <version>58.0.1</version>
     </versions>
-    <lastUpdated>20260910192012</lastUpdated>
+    <lastUpdated>20260914150056</lastUpdated>
   </versioning>
 </metadata>

package/android/build.gradle

@@ -12,13 +12,13 @@ apply plugin: 'expo-module-gradle-plugin'
 apply plugin: 'org.jetbrains.kotlin.plugin.compose'
 
 group = 'expo.modules.ui'
-version = '58.0.0'
+version = '58.0.1'
 
 android {
   namespace "expo.modules.ui"
   defaultConfig {
     versionCode 1
-    versionName "58.0.0"
+    versionName "58.0.1"
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
   }
   buildFeatures {

package/build/swift-ui/NavigationDestination/index.d.ts

@@ -0,0 +1,29 @@
+import { type ReactNode } from 'react';
+export interface NavigationDestinationProps {
+    /**
+     * The `NavigationLink` value this destination is presented for.
+     */
+    value: string;
+    /**
+     * The view pushed onto the stack for `value`.
+     */
+    children: ReactNode;
+}
+/**
+ * Associates a destination view with a `NavigationLink` value, matching SwiftUI's
+ * `navigationDestination(for:destination:)`. It must be a direct child of the `NavigationStack`,
+ * however deeply the link that pushes it is nested inside that stack.
+ *
+ * Keep it mounted so the pushed screen already carries its `navigationTitle` when the slide
+ * starts, or render one for each value on the stack's `path` to build screens on demand.
+ *
+ * @example
+ * ```tsx
+ * <NavigationDestination value="settings">
+ *   <SettingsScreen />
+ * </NavigationDestination>
+ * ```
+ *
+ * @platform ios
+ */
+export declare function NavigationDestination(props: NavigationDestinationProps): import("react/jsx-runtime").JSX.Element;

package/build/swift-ui/NavigationDestination/index.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Slot } from '../SlotView';
+/**
+ * Associates a destination view with a `NavigationLink` value, matching SwiftUI's
+ * `navigationDestination(for:destination:)`. It must be a direct child of the `NavigationStack`,
+ * however deeply the link that pushes it is nested inside that stack.
+ *
+ * Keep it mounted so the pushed screen already carries its `navigationTitle` when the slide
+ * starts, or render one for each value on the stack's `path` to build screens on demand.
+ *
+ * @example
+ * ```tsx
+ * <NavigationDestination value="settings">
+ *   <SettingsScreen />
+ * </NavigationDestination>
+ * ```
+ *
+ * @platform ios
+ */ export function NavigationDestination(props) {
+    return /*#__PURE__*/ _jsx(Slot, {
+        name: "destination",
+        extraProps: {
+            value: props.value
+        },
+        children: props.children
+    });
+}
+
+//# sourceMappingURL=index.js.map

package/build/swift-ui/NavigationDestination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["swift-ui/NavigationDestination/index.tsx"],"sourcesContent":[null],"names":["Slot","NavigationDestination","props","name","extraProps","value","children"],"mappings":";AAEA,SAASA,IAAI,QAAQ,cAAc;AAanC;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASC,sBAAsBC,KAAiC;IACrE,qBACE,KAACF;QAAKG,MAAK;QAAcC,YAAY;YAAEC,OAAOH,MAAMG,KAAK;QAAC;kBACvDH,MAAMI,QAAQ;;AAGrB"}

package/build/swift-ui/NavigationLink/index.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from 'react';
+import { type CommonViewModifierProps } from '../types';
+export interface NavigationLinkProps extends CommonViewModifierProps {
+    /**
+     * The value to append to the enclosing `NavigationStack`'s path when the link is tapped. The
+     * stack presents the `NavigationDestination` whose `value` matches.
+     */
+    value: string;
+    /**
+     * A view that describes the link.
+     */
+    children: ReactNode;
+}
+/**
+ * A view that controls a navigation presentation. In a `List` it renders as a row with a
+ * disclosure chevron, and tapping it pushes the matching `NavigationDestination`.
+ *
+ * The link has to be inside the `NavigationStack` itself. Content presented from the stack, such
+ * as a `BottomSheet` or a `Popover`, is its own presentation context and does not reach the
+ * stack's destinations, so give that content its own `NavigationStack`.
+ *
+ * @example
+ * ```tsx
+ * <NavigationLink value="settings">
+ *   <Text>Settings</Text>
+ * </NavigationLink>
+ * ```
+ *
+ * @platform ios
+ */
+export declare function NavigationLink(props: NavigationLinkProps): import("react/jsx-runtime").JSX.Element;

package/build/swift-ui/NavigationLink/index.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { requireNativeView } from 'expo';
+import { createViewModifierEventListener } from '../modifiers/utils';
+const NavigationLinkNativeView = requireNativeView('ExpoUI', 'NavigationLinkView');
+/**
+ * A view that controls a navigation presentation. In a `List` it renders as a row with a
+ * disclosure chevron, and tapping it pushes the matching `NavigationDestination`.
+ *
+ * The link has to be inside the `NavigationStack` itself. Content presented from the stack, such
+ * as a `BottomSheet` or a `Popover`, is its own presentation context and does not reach the
+ * stack's destinations, so give that content its own `NavigationStack`.
+ *
+ * @example
+ * ```tsx
+ * <NavigationLink value="settings">
+ *   <Text>Settings</Text>
+ * </NavigationLink>
+ * ```
+ *
+ * @platform ios
+ */ export function NavigationLink(props) {
+    const { modifiers, children, ...restProps } = props;
+    return /*#__PURE__*/ _jsx(NavigationLinkNativeView, {
+        modifiers: modifiers,
+        ...modifiers ? createViewModifierEventListener(modifiers) : undefined,
+        ...restProps,
+        children: children
+    });
+}
+
+//# sourceMappingURL=index.js.map

package/build/swift-ui/NavigationLink/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["swift-ui/NavigationLink/index.tsx"],"sourcesContent":[null],"names":["requireNativeView","createViewModifierEventListener","NavigationLinkNativeView","NavigationLink","props","modifiers","children","restProps","undefined"],"mappings":";AAAA,SAASA,iBAAiB,QAAQ,OAAO;AAGzC,SAASC,+BAA+B,QAAQ,qBAAqB;AAerE,MAAMC,2BAA+DF,kBACnE,UACA;AAGF;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASG,eAAeC,KAA0B;IACvD,MAAM,EAAEC,SAAS,EAAEC,QAAQ,EAAE,GAAGC,WAAW,GAAGH;IAC9C,qBACE,KAACF;QACCG,WAAWA;QACV,GAAIA,YAAYJ,gCAAgCI,aAAaG,SAAS;QACtE,GAAGD,SAAS;kBACZD;;AAGP"}

package/build/swift-ui/NavigationStack/index.d.ts

@@ -1,13 +1,44 @@
+import { type ReactNode } from 'react';
 import { type CommonViewModifierProps } from '../types';
 export interface NavigationStackProps extends CommonViewModifierProps {
     /**
-     * The root view of the stack. It is displayed inside a navigation bar.
+     * The root view of the stack, and the `NavigationDestination` views the stack can push. It is
+     * displayed inside a navigation bar.
      */
-    children: React.ReactNode;
+    children: ReactNode;
+    /**
+     * The values of the views pushed on top of the root view, in the order they were pushed.
+     * Leave it undefined to let the stack manage its own path.
+     */
+    path?: string[];
+    /**
+     * Callback function that is called when the stack pushes or pops a view, for example when a
+     * `NavigationLink` is tapped or the user swipes back. Gets called with the new path.
+     *
+     * When `path` is set, the stack is controlled: a push takes effect once the new path comes back
+     * through this prop.
+     */
+    onPathChange?: (path: string[]) => void;
 }
 /**
  * A view that displays a root view and enables you to present additional views over the root view.
  *
+ * @example
+ * ```tsx
+ * const [path, setPath] = useState<string[]>([]);
+ *
+ * <NavigationStack path={path} onPathChange={setPath}>
+ *   <List>
+ *     <NavigationLink value="settings">
+ *       <Text>Settings</Text>
+ *     </NavigationLink>
+ *   </List>
+ *   <NavigationDestination value="settings">
+ *     <SettingsScreen />
+ *   </NavigationDestination>
+ * </NavigationStack>
+ * ```
+ *
  * @platform ios
  */
 export declare function NavigationStack(props: NavigationStackProps): import("react/jsx-runtime").JSX.Element;

package/build/swift-ui/NavigationStack/index.js

@@ -5,13 +5,32 @@ const NavigationStackNativeView = requireNativeView('ExpoUI', 'NavigationStackVi
 /**
  * A view that displays a root view and enables you to present additional views over the root view.
  *
+ * @example
+ * ```tsx
+ * const [path, setPath] = useState<string[]>([]);
+ *
+ * <NavigationStack path={path} onPathChange={setPath}>
+ *   <List>
+ *     <NavigationLink value="settings">
+ *       <Text>Settings</Text>
+ *     </NavigationLink>
+ *   </List>
+ *   <NavigationDestination value="settings">
+ *     <SettingsScreen />
+ *   </NavigationDestination>
+ * </NavigationStack>
+ * ```
+ *
  * @platform ios
  */ export function NavigationStack(props) {
-    const { modifiers, ...restProps } = props;
+    const { modifiers, onPathChange, ...restProps } = props;
     return /*#__PURE__*/ _jsx(NavigationStackNativeView, {
         modifiers: modifiers,
         ...modifiers ? createViewModifierEventListener(modifiers) : undefined,
-        ...restProps
+        ...restProps,
+        onPathChange: onPathChange ? ({ nativeEvent: { path } })=>{
+            onPathChange(path);
+        } : undefined
     });
 }
 

package/build/swift-ui/NavigationStack/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["swift-ui/NavigationStack/index.tsx"],"sourcesContent":[null],"names":["requireNativeView","createViewModifierEventListener","NavigationStackNativeView","NavigationStack","props","modifiers","restProps","undefined"],"mappings":";AAAA,SAASA,iBAAiB,QAAQ,OAAO;AAEzC,SAASC,+BAA+B,QAAQ,qBAAqB;AAUrE,MAAMC,4BAAuEF,kBAC3E,UACA;AAGF;;;;CAIC,GACD,OAAO,SAASG,gBAAgBC,KAA2B;IACzD,MAAM,EAAEC,SAAS,EAAE,GAAGC,WAAW,GAAGF;IACpC,qBACE,KAACF;QACCG,WAAWA;QACV,GAAIA,YAAYJ,gCAAgCI,aAAaE,SAAS;QACtE,GAAGD,SAAS;;AAGnB"}
+{"version":3,"sources":["swift-ui/NavigationStack/index.tsx"],"sourcesContent":[null],"names":["requireNativeView","createViewModifierEventListener","NavigationStackNativeView","NavigationStack","props","modifiers","onPathChange","restProps","undefined","nativeEvent","path"],"mappings":";AAAA,SAASA,iBAAiB,QAAQ,OAAO;AAIzC,SAASC,+BAA+B,QAAQ,qBAAqB;AA4BrE,MAAMC,4BAAuEF,kBAC3E,UACA;AAGF;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASG,gBAAgBC,KAA2B;IACzD,MAAM,EAAEC,SAAS,EAAEC,YAAY,EAAE,GAAGC,WAAW,GAAGH;IAClD,qBACE,KAACF;QACCG,WAAWA;QACV,GAAIA,YAAYJ,gCAAgCI,aAAaG,SAAS;QACtE,GAAGD,SAAS;QACbD,cACEA,eACI,CAAC,EAAEG,aAAa,EAAEC,IAAI,EAAE,EAAE;YACxBJ,aAAaI;QACf,IACAF;;AAIZ"}

package/build/swift-ui/TabView/index.d.ts

@@ -33,7 +33,7 @@ export type { TabProps } from './Tab';
  * `value` prop, which is used for selection.
  *
  * For routed bottom-tab navigation across full-screen routes, prefer
- * `expo-router/unstable-native-tabs`.
+ * `expo-router/native-tabs`.
  *
  * @platform ios
  */

package/build/swift-ui/TabView/index.js

@@ -23,7 +23,7 @@ function TabView(props) {
  * `value` prop, which is used for selection.
  *
  * For routed bottom-tab navigation across full-screen routes, prefer
- * `expo-router/unstable-native-tabs`.
+ * `expo-router/native-tabs`.
  *
  * @platform ios
  */ const _TabView = Object.assign(TabView, {

package/build/swift-ui/index.d.ts

@@ -25,6 +25,8 @@ export * from './ZStack';
 export * from './Group';
 export * from './List';
 export * from './Menu';
+export * from './NavigationDestination';
+export * from './NavigationLink';
 export * from './NavigationStack';
 export * from './Picker';
 export * from './ProgressView';

package/build/swift-ui/index.js

@@ -25,6 +25,8 @@ export * from './ZStack';
 export * from './Group';
 export * from './List';
 export * from './Menu';
+export * from './NavigationDestination';
+export * from './NavigationLink';
 export * from './NavigationStack';
 export * from './Picker';
 export * from './ProgressView';

package/build/swift-ui/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["swift-ui/index.tsx"],"sourcesContent":[null],"names":["useNativeState","withAnimation","TextField"],"mappings":"AAAA,cAAc,8BAA8B;AAC5C,cAAc,UAAU;AACxB,cAAc,gBAAgB;AAC9B,cAAc,WAAW;AACzB,cAAc,UAAU;AACxB,cAAc,gBAAgB;AAC9B,cAAc,2BAA2B;AACzC,cAAc,uBAAuB;AACrC,cAAc,iBAAiB;AAC/B,cAAc,gBAAgB;AAC9B,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,oBAAoB;AAClC,cAAc,SAAS;AACvB,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,UAAU;AACxB,cAAc,UAAU;AACxB,cAAc,mBAAmB;AACjC,cAAc,WAAW;AACzB,cAAc,eAAe;AAC7B,cAAc,eAAe;AAC7B,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,SAAS;AACvB,cAAc,oBAAoB;AAClC,cAAc,WAAW;AACzB,cAAc,iBAAiB;AAC/B,cAAc,YAAY;AAC1B,cAAc,cAAc;AAC5B,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,YAAY;AAC1B,cAAc,iBAAiB;AAC/B,cAAc,SAAS;AACvB,SAASA,cAAc,QAAQ,WAAW;AAC1C,SAASC,aAAa,QAA8C,kBAAkB;AACtF,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,YAAY;AAC1B,cAAc,WAAW;AACzB,SACEC,SAAS,QAIJ,cAAc;AACrB,cAAc,gBAAgB;AAC9B,cAAc,cAAc;AAC5B,cAAc,yBAAyB;AACvC,cAAc,eAAe;AAC7B,cAAc,WAAW;AACzB,cAAc,SAAS;AACvB,cAAc,YAAY;AAC1B,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,SAAS"}
+{"version":3,"sources":["swift-ui/index.tsx"],"sourcesContent":[null],"names":["useNativeState","withAnimation","TextField"],"mappings":"AAAA,cAAc,8BAA8B;AAC5C,cAAc,UAAU;AACxB,cAAc,gBAAgB;AAC9B,cAAc,WAAW;AACzB,cAAc,UAAU;AACxB,cAAc,gBAAgB;AAC9B,cAAc,2BAA2B;AACzC,cAAc,uBAAuB;AACrC,cAAc,iBAAiB;AAC/B,cAAc,gBAAgB;AAC9B,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,oBAAoB;AAClC,cAAc,SAAS;AACvB,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,UAAU;AACxB,cAAc,UAAU;AACxB,cAAc,mBAAmB;AACjC,cAAc,WAAW;AACzB,cAAc,eAAe;AAC7B,cAAc,eAAe;AAC7B,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,SAAS;AACvB,cAAc,0BAA0B;AACxC,cAAc,mBAAmB;AACjC,cAAc,oBAAoB;AAClC,cAAc,WAAW;AACzB,cAAc,iBAAiB;AAC/B,cAAc,YAAY;AAC1B,cAAc,cAAc;AAC5B,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,YAAY;AAC1B,cAAc,iBAAiB;AAC/B,cAAc,SAAS;AACvB,SAASA,cAAc,QAAQ,WAAW;AAC1C,SAASC,aAAa,QAA8C,kBAAkB;AACtF,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,YAAY;AAC1B,cAAc,WAAW;AACzB,SACEC,SAAS,QAIJ,cAAc;AACrB,cAAc,gBAAgB;AAC9B,cAAc,cAAc;AAC5B,cAAc,yBAAyB;AACvC,cAAc,eAAe;AAC7B,cAAc,WAAW;AACzB,cAAc,SAAS;AACvB,cAAc,YAAY;AAC1B,cAAc,eAAe;AAC7B,cAAc,YAAY;AAC1B,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,SAAS"}

package/expo-module.config.json

@@ -10,7 +10,7 @@
     "publication": {
       "groupId": "expo.modules.ui",
       "artifactId": "expo.modules.ui",
-      "version": "58.0.0",
+      "version": "58.0.1",
       "repository": "local-maven-repo"
     }
   }

package/ios/BackgroundView.swift

@@ -3,14 +3,18 @@
 import ExpoModulesCore
 import SwiftUI
 
-internal class BackgroundViewProps: UIBaseViewProps {
+public final class BackgroundViewProps: UIBaseViewProps {
   @Field var alignment: AlignmentOptions?
 }
 
-internal struct BackgroundView: ExpoSwiftUI.View {
-  @ObservedObject var props: BackgroundViewProps
+public struct BackgroundView: ExpoSwiftUI.View {
+  @ObservedObject public var props: BackgroundViewProps
 
-  var body: some View {
+  public init(props: BackgroundViewProps) {
+    self.props = props
+  }
+
+  public var body: some View {
     baseContent
       .background(alignment: props.alignment?.toAlignment() ?? .center) {
         backgroundContent
@@ -19,7 +23,7 @@ internal struct BackgroundView: ExpoSwiftUI.View {
 
   @ViewBuilder
   private var baseContent: some View {
-    ForEach(props.children?.withoutSlots() ?? [], id: \.id) { child in
+    ForEach(props.children?.withoutSlots() ?? [], id: \.childIdentity) { child in
       let view: any View = child.childView
       AnyView(view)
     }
@@ -31,4 +35,4 @@ internal struct BackgroundView: ExpoSwiftUI.View {
       content
     }
   }
-}
+}

package/ios/ExpoUIModule.swift

@@ -157,6 +157,7 @@ public final class ExpoUIModule: Module {
     ExpoUIView(MenuView.self)
 
     ExpoUIView(NavigationStackView.self)
+    ExpoUIView(NavigationLinkView.self)
     ExpoUIView(ToolbarView.self)
 
     ExpoUIView(FormView.self)

package/ios/MaskView.swift

@@ -3,14 +3,18 @@
 import ExpoModulesCore
 import SwiftUI
 
-internal class MaskViewProps: UIBaseViewProps {
+public final class MaskViewProps: UIBaseViewProps {
   @Field var alignment: AlignmentOptions?
 }
 
-internal struct MaskView: ExpoSwiftUI.View {
-  @ObservedObject var props: MaskViewProps
+public struct MaskView: ExpoSwiftUI.View {
+  @ObservedObject public var props: MaskViewProps
 
-  var body: some View {
+  public init(props: MaskViewProps) {
+    self.props = props
+  }
+
+  public var body: some View {
     if let mask = props.children?.slot("content") {
       baseContent.mask(alignment: props.alignment?.toAlignment() ?? .center) {
         mask
@@ -22,7 +26,7 @@ internal struct MaskView: ExpoSwiftUI.View {
 
   @ViewBuilder
   private var baseContent: some View {
-    ForEach(props.children?.withoutSlots() ?? [], id: \.id) { child in
+    ForEach(props.children?.withoutSlots() ?? [], id: \.childIdentity) { child in
       let view: any View = child.childView
       AnyView(view)
     }

package/ios/NavigationLinkView.swift

@@ -0,0 +1,22 @@
+// Copyright 2025-present 650 Industries. All rights reserved.
+
+import SwiftUI
+import ExpoModulesCore
+
+internal final class NavigationLinkViewProps: UIBaseViewProps {
+  @Field var value: String = ""
+}
+
+internal struct NavigationLinkView: ExpoSwiftUI.View {
+  @ObservedObject var props: NavigationLinkViewProps
+
+  init(props: NavigationLinkViewProps) {
+    self.props = props
+  }
+
+  var body: some View {
+    NavigationLink(value: props.value) {
+      Children()
+    }
+  }
+}

package/ios/NavigationStackView.swift

@@ -3,18 +3,61 @@
 import SwiftUI
 import ExpoModulesCore
 
-internal final class NavigationStackViewProps: UIBaseViewProps {}
+internal final class NavigationStackViewProps: UIBaseViewProps {
+  @Field var path: [String]?
+  var onPathChange = EventDispatcher()
+}
+
+private struct NavigationDestinationContent: View {
+  @ObservedObject var props: NavigationStackViewProps
+  let value: String
+
+  var body: some View {
+    props.children?
+      .slots("destination")
+      .first { $0.extra("value", as: String.self) == value }
+  }
+}
 
 internal struct NavigationStackView: ExpoSwiftUI.View {
   @ObservedObject var props: NavigationStackViewProps
+  @State private var uncontrolledPath: [String] = []
 
   init(props: NavigationStackViewProps) {
     self.props = props
   }
 
+  private var pathBinding: Binding<[String]> {
+    let props = props
+    let uncontrolled = $uncontrolledPath
+    return Binding(
+      get: { props.path ?? uncontrolled.wrappedValue },
+      set: { newPath in
+        guard (props.path ?? uncontrolled.wrappedValue) != newPath else {
+          return
+        }
+        if props.path == nil {
+          uncontrolled.wrappedValue = newPath
+        }
+        props.onPathChange(["path": newPath])
+      }
+    )
+  }
+
   var body: some View {
-    NavigationStack {
-      Children()
+    NavigationStack(path: pathBinding) {
+      rootContent
+        .navigationDestination(for: String.self) { value in
+          NavigationDestinationContent(props: props, value: value)
+        }
+    }
+  }
+
+  @ViewBuilder
+  private var rootContent: some View {
+    ForEach(props.children?.withoutSlot("destination") ?? [], id: \.id) { child in
+      let view: any View = child.childView
+      AnyView(view)
     }
   }
 }

package/ios/OverlayView.swift

@@ -3,14 +3,18 @@
 import ExpoModulesCore
 import SwiftUI
 
-internal class OverlayViewProps: UIBaseViewProps {
+public final class OverlayViewProps: UIBaseViewProps {
   @Field var alignment: AlignmentOptions?
 }
 
-internal struct OverlayView: ExpoSwiftUI.View {
-  @ObservedObject var props: OverlayViewProps
+public struct OverlayView: ExpoSwiftUI.View {
+  @ObservedObject public var props: OverlayViewProps
 
-  var body: some View {
+  public init(props: OverlayViewProps) {
+    self.props = props
+  }
+
+  public var body: some View {
     baseContent
       .overlay(alignment: props.alignment?.toAlignment() ?? .center) {
         overlayContent
@@ -19,7 +23,7 @@ internal struct OverlayView: ExpoSwiftUI.View {
 
   @ViewBuilder
   private var baseContent: some View {
-    ForEach(props.children?.withoutSlots() ?? [], id: \.id) { child in
+    ForEach(props.children?.withoutSlots() ?? [], id: \.childIdentity) { child in
       let view: any View = child.childView
       AnyView(view)
     }

package/ios/SlotView.swift

@@ -3,19 +3,19 @@
 import SwiftUI
 import ExpoModulesCore
 
-internal final class SlotViewProps: ExpoSwiftUI.ViewProps {
+public final class SlotViewProps: ExpoSwiftUI.ViewProps {
   @Field var name: String = ""
   @Field var extraProps: [String: Any]?
 }
 
-internal struct SlotView: ExpoSwiftUI.View {
-  @ObservedObject var props: SlotViewProps
+public struct SlotView: ExpoSwiftUI.View {
+  @ObservedObject public var props: SlotViewProps
 
-  init(props: SlotViewProps) {
+  public init(props: SlotViewProps) {
     self.props = props
   }
 
-  var body: some View {
+  public var body: some View {
     Children()
   }
 
@@ -30,6 +30,11 @@ extension [any ExpoSwiftUI.AnyChild] {
       .first { $0.props.name == name }
   }
 
+  func slots(_ name: String) -> [SlotView] {
+    compactMap { $0.childView as? SlotView }
+      .filter { $0.props.name == name }
+  }
+
   func withoutSlot(_ name: String) -> [any ExpoSwiftUI.AnyChild] {
     filter {
       guard let slot = $0.childView as? SlotView else { return true }

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{58.0.0/expo.modules.ui-58.0.0.module → 58.0.1/expo.modules.ui-58.0.1.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "expo.modules.ui",
     "module": "expo.modules.ui",
-    "version": "58.0.0",
+    "version": "58.0.1",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-58.0.0.aar",
-          "url": "expo.modules.ui-58.0.0.aar",
+          "name": "expo.modules.ui-58.0.1.aar",
+          "url": "expo.modules.ui-58.0.1.aar",
           "size": 1789469,
           "sha512": "dfe706437f10aa521a458896b97fa14d945cf66c80dab9cc43fddd444cddd016073b783076f38ba90e07c5076b8752bf66e136ce9c40d85195cf27a231ce7f9d",
           "sha256": "8faeae3cb56c1d29d1a120a9a8c1964e6015ba993519f244283855a066a1704c",
@@ -141,8 +141,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.ui-58.0.0.aar",
-          "url": "expo.modules.ui-58.0.0.aar",
+          "name": "expo.modules.ui-58.0.1.aar",
+          "url": "expo.modules.ui-58.0.1.aar",
           "size": 1789469,
           "sha512": "dfe706437f10aa521a458896b97fa14d945cf66c80dab9cc43fddd444cddd016073b783076f38ba90e07c5076b8752bf66e136ce9c40d85195cf27a231ce7f9d",
           "sha256": "8faeae3cb56c1d29d1a120a9a8c1964e6015ba993519f244283855a066a1704c",
@@ -161,8 +161,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-58.0.0-sources.jar",
-          "url": "expo.modules.ui-58.0.0-sources.jar",
+          "name": "expo.modules.ui-58.0.1-sources.jar",
+          "url": "expo.modules.ui-58.0.1-sources.jar",
           "size": 106165,
           "sha512": "59ec9e524c62a8b77c41e894e4833d24d2c9bb1912ef1be23d81ab6eb04bcf1f8743cdc11528bf2630b0f1f29db20b017e8015ebde418530196d7dcea06a90bc",
           "sha256": "297ecd2b76dbb6908b0b2897c6adba6be5dd10cb16c8ca169525a40e207d52c2",

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.module.md5

@@ -0,0 +1 @@
+ecd8042434fbf78223a97b2e5cca9ac7

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.module.sha1

@@ -0,0 +1 @@
+bb33b2a423bd39ff4c9b62f929b7b19653779f0a

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.module.sha256

@@ -0,0 +1 @@
+e2e5ddebc4739e29b6a0a2490b66f62c035b4c90513828665f499129a403e5ce

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.module.sha512

@@ -0,0 +1 @@
+5c40773634772fa4a4c2351fb536c084383caf1eedec9b538b6bc93586964d9f64a0b4830b829fd99483eba76ad2c67757adbbce39dff40ef277ec883eb8b1d3

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{58.0.0/expo.modules.ui-58.0.0.pom → 58.0.1/expo.modules.ui-58.0.1.pom}

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

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.pom.md5

@@ -0,0 +1 @@
+bd71fac3ede373a83d64e858fd721a3f

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.pom.sha1

@@ -0,0 +1 @@
+4c38eb3e34223e6d9091aea17e5e351b0b478a99

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.pom.sha256

@@ -0,0 +1 @@
+306e2675bfd0ba09e8156499f87079ae52a242e297b094d1d29ca058a8bb254b

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.1/expo.modules.ui-58.0.1.pom.sha512

@@ -0,0 +1 @@
+f6e3b59b8caf48640be922818917d28d85e20da868e4dbf377389e62483073b93b013720c1a2267400abbf38288f2912d409a135d4dc1d7dc4bd0009947cce05

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

@@ -3,11 +3,11 @@
   <groupId>expo.modules.ui</groupId>
   <artifactId>expo.modules.ui</artifactId>
   <versioning>
-    <latest>58.0.0</latest>
-    <release>58.0.0</release>
+    <latest>58.0.1</latest>
+    <release>58.0.1</release>
     <versions>
-      <version>58.0.0</version>
+      <version>58.0.1</version>
     </versions>
-    <lastUpdated>20260910192012</lastUpdated>
+    <lastUpdated>20260914150056</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-aa1c6e7ec7c7463dee9f9fba9aabe6a8
+eb722f5ae70ad3ee64f29cb240354616

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

@@ -1 +1 @@
-823aeec60be8e25e8cff8f331d66984d3a2ea517
+56142e23a77a9066fd7c989581633406a68e0cc8

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

@@ -1 +1 @@
-fe9c8a01f45f367ea994344f942f70d9747c9e61fba2652200d6b2f61a6e5fe1
+fcb1592cf547a24c5204afdbfbd9269826916881acb69e0882a865c18ecad91e

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

@@ -1 +1 @@
-9e00e26460cfb5e9a9ba44adfc4a5c538b4110597f1045ad788e9801d1394c071578239e3b9e819fb189f8fd900dfb805b2d643b4a8946c838e343dcba063aab
+f804a0d6f6328c9f2f60e640becd1362a0be3b2445d0be14c73b7414c6f52d2a8db6dca71b8b37c9549d53e37ae0a00b6815162f94e21294e890a0c7594e9762

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/ui",
-  "version": "58.0.0",
+  "version": "58.0.1",
   "description": "A collection of UI components",
   "keywords": [
     "Jetpack Compose",
@@ -171,7 +171,7 @@
       "optional": true
     }
   },
-  "gitHead": "c543a7181fc32e14f42d89550087b80ac5c490f2",
+  "gitHead": "e4b50c311af4e076b49a532ba2dca72546783e46",
   "scripts": {
     "precompile-ios": "et prebuild-package-for-publish",
     "build": "pnpm run build:lib && pnpm run build:plugin",

package/src/swift-ui/NavigationDestination/index.tsx

@@ -0,0 +1,39 @@
+import { type ReactNode } from 'react';
+
+import { Slot } from '../SlotView';
+
+export interface NavigationDestinationProps {
+  /**
+   * The `NavigationLink` value this destination is presented for.
+   */
+  value: string;
+  /**
+   * The view pushed onto the stack for `value`.
+   */
+  children: ReactNode;
+}
+
+/**
+ * Associates a destination view with a `NavigationLink` value, matching SwiftUI's
+ * `navigationDestination(for:destination:)`. It must be a direct child of the `NavigationStack`,
+ * however deeply the link that pushes it is nested inside that stack.
+ *
+ * Keep it mounted so the pushed screen already carries its `navigationTitle` when the slide
+ * starts, or render one for each value on the stack's `path` to build screens on demand.
+ *
+ * @example
+ * ```tsx
+ * <NavigationDestination value="settings">
+ *   <SettingsScreen />
+ * </NavigationDestination>
+ * ```
+ *
+ * @platform ios
+ */
+export function NavigationDestination(props: NavigationDestinationProps) {
+  return (
+    <Slot name="destination" extraProps={{ value: props.value }}>
+      {props.children}
+    </Slot>
+  );
+}

package/src/swift-ui/NavigationLink/index.tsx

@@ -0,0 +1,51 @@
+import { requireNativeView } from 'expo';
+import { type ComponentType, type ReactNode } from 'react';
+
+import { createViewModifierEventListener } from '../modifiers/utils';
+import { type CommonViewModifierProps } from '../types';
+
+export interface NavigationLinkProps extends CommonViewModifierProps {
+  /**
+   * The value to append to the enclosing `NavigationStack`'s path when the link is tapped. The
+   * stack presents the `NavigationDestination` whose `value` matches.
+   */
+  value: string;
+  /**
+   * A view that describes the link.
+   */
+  children: ReactNode;
+}
+
+const NavigationLinkNativeView: ComponentType<NavigationLinkProps> = requireNativeView(
+  'ExpoUI',
+  'NavigationLinkView'
+);
+
+/**
+ * A view that controls a navigation presentation. In a `List` it renders as a row with a
+ * disclosure chevron, and tapping it pushes the matching `NavigationDestination`.
+ *
+ * The link has to be inside the `NavigationStack` itself. Content presented from the stack, such
+ * as a `BottomSheet` or a `Popover`, is its own presentation context and does not reach the
+ * stack's destinations, so give that content its own `NavigationStack`.
+ *
+ * @example
+ * ```tsx
+ * <NavigationLink value="settings">
+ *   <Text>Settings</Text>
+ * </NavigationLink>
+ * ```
+ *
+ * @platform ios
+ */
+export function NavigationLink(props: NavigationLinkProps) {
+  const { modifiers, children, ...restProps } = props;
+  return (
+    <NavigationLinkNativeView
+      modifiers={modifiers}
+      {...(modifiers ? createViewModifierEventListener(modifiers) : undefined)}
+      {...restProps}>
+      {children}
+    </NavigationLinkNativeView>
+  );
+}

package/src/swift-ui/NavigationStack/index.tsx

@@ -1,16 +1,36 @@
 import { requireNativeView } from 'expo';
+import { type ComponentType, type ReactNode } from 'react';
+import { type NativeSyntheticEvent } from 'react-native';
 
 import { createViewModifierEventListener } from '../modifiers/utils';
 import { type CommonViewModifierProps } from '../types';
 
 export interface NavigationStackProps extends CommonViewModifierProps {
   /**
-   * The root view of the stack. It is displayed inside a navigation bar.
+   * The root view of the stack, and the `NavigationDestination` views the stack can push. It is
+   * displayed inside a navigation bar.
    */
-  children: React.ReactNode;
+  children: ReactNode;
+  /**
+   * The values of the views pushed on top of the root view, in the order they were pushed.
+   * Leave it undefined to let the stack manage its own path.
+   */
+  path?: string[];
+  /**
+   * Callback function that is called when the stack pushes or pops a view, for example when a
+   * `NavigationLink` is tapped or the user swipes back. Gets called with the new path.
+   *
+   * When `path` is set, the stack is controlled: a push takes effect once the new path comes back
+   * through this prop.
+   */
+  onPathChange?: (path: string[]) => void;
 }
 
-const NavigationStackNativeView: React.ComponentType<NavigationStackProps> = requireNativeView(
+type NativeNavigationStackProps = Omit<NavigationStackProps, 'onPathChange'> & {
+  onPathChange?: (event: NativeSyntheticEvent<{ path: string[] }>) => void;
+};
+
+const NavigationStackNativeView: ComponentType<NativeNavigationStackProps> = requireNativeView(
   'ExpoUI',
   'NavigationStackView'
 );
@@ -18,15 +38,38 @@ const NavigationStackNativeView: React.ComponentType<NavigationStackProps> = req
 /**
  * A view that displays a root view and enables you to present additional views over the root view.
  *
+ * @example
+ * ```tsx
+ * const [path, setPath] = useState<string[]>([]);
+ *
+ * <NavigationStack path={path} onPathChange={setPath}>
+ *   <List>
+ *     <NavigationLink value="settings">
+ *       <Text>Settings</Text>
+ *     </NavigationLink>
+ *   </List>
+ *   <NavigationDestination value="settings">
+ *     <SettingsScreen />
+ *   </NavigationDestination>
+ * </NavigationStack>
+ * ```
+ *
  * @platform ios
  */
 export function NavigationStack(props: NavigationStackProps) {
-  const { modifiers, ...restProps } = props;
+  const { modifiers, onPathChange, ...restProps } = props;
   return (
     <NavigationStackNativeView
       modifiers={modifiers}
       {...(modifiers ? createViewModifierEventListener(modifiers) : undefined)}
       {...restProps}
+      onPathChange={
+        onPathChange
+          ? ({ nativeEvent: { path } }) => {
+              onPathChange(path);
+            }
+          : undefined
+      }
     />
   );
 }

package/src/swift-ui/TabView/index.tsx

@@ -63,7 +63,7 @@ export type { TabProps } from './Tab';
  * `value` prop, which is used for selection.
  *
  * For routed bottom-tab navigation across full-screen routes, prefer
- * `expo-router/unstable-native-tabs`.
+ * `expo-router/native-tabs`.
  *
  * @platform ios
  */

package/src/swift-ui/index.tsx

@@ -25,6 +25,8 @@ export * from './ZStack';
 export * from './Group';
 export * from './List';
 export * from './Menu';
+export * from './NavigationDestination';
+export * from './NavigationLink';
 export * from './NavigationStack';
 export * from './Picker';
 export * from './ProgressView';

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.module.md5

@@ -1 +0,0 @@
-92f1cc0329bdc4e5fc26fccbee39556f

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.module.sha1

@@ -1 +0,0 @@
-ed65109583c15437f79af7ec544af70394d5c279

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.module.sha256

@@ -1 +0,0 @@
-1b3593c9dc1b7597f685374585d404d94b6d7119969c24868365b4329070d8c6

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.module.sha512

@@ -1 +0,0 @@
-5f309c672c127bc19ca3ed55b8ef97b8fefc3acd6c9eced30b762cf70ddd94f2f3e8f5a1e363d56873ad01ae1b4206295358bdcde4c061fedf50490fd937f520

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.pom.md5

@@ -1 +0,0 @@
-288729551bfb3ef08d3f22eb6eecdc58

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.pom.sha1

@@ -1 +0,0 @@
-2182f9ea357a66c6e04f5eef6d1423b2ce1f1db6

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.pom.sha256

@@ -1 +0,0 @@
-4d0f823e8a2a57e85d8d6ae9e03f585fe20bd63cb53eee6a5bd07e252c93b1dc

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.0/expo.modules.ui-58.0.0.pom.sha512

@@ -1 +0,0 @@
-4ced04902194b6af012bc167a257864a5b8aa859a7fd6207a5ec1f3c22d7f7d79d0212778c93e7b10c93f8c4b632ab4d731b7bcfcc1cb9f09b752bb218eb2f6b