From 9e3db2be1b6e7f41a1677854fd16b7115e1bb0bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?nishan=20=28o=5E=E2=96=BD=5Eo=29?= <nishanbende@gmail.com>
Date: Tue, 12 May 2026 10:29:14 +0530
Subject: [PATCH 1/5] [docs][ui] Universal TextInput (#45571)

# Why

 Adds documentation for the universal TextInput introduced in #45205.

<!--
Please describe the motivation for this PR, and link to relevant GitHub
issues, forums posts, or feature requests.
-->

# How

Adds a new textinput universal component docs and updates some examples
in textfield docs.

<!--
How did you build this feature or fix this bug and why?
-->

# Test Plan

Verified rendered docs locally for unversioned/ and v56.0.0/.


<!--
Please describe how you tested this change and how a reviewer could
reproduce your test, especially if this PR does not include automated
tests! If possible, please also provide terminal output and/or
screenshots demonstrating your test/reproduction.
-->

# Checklist

<!--
Please check the appropriate items below if they apply to your diff.
-->

- [ ] I added a `changelog.md` entry and rebuilt the package sources
according to [this short
guide](https://github.com/expo/expo/blob/main/CONTRIBUTING.md#-before-submitting)
- [ ] This diff will work correctly for `npx expo prebuild` & EAS Build
(eg: updated a module plugin).
- [ ] Conforms with the [Documentation Writing Style
Guide](https://github.com/expo/expo/blob/main/guides/Expo%20Documentation%20Writing%20Style%20Guide.md)

---------

Co-authored-by: Aman Mittal <amandeepmittal@live.com>
Co-authored-by: Kudo Chien <ckchien@gmail.com>
---
 docs/components/plugins/api/APIStaticData.ts  |   2 +
 .../sdk/ui/jetpack-compose/textfield.mdx      |  32 +++--
 .../sdk/ui/jetpack-compose/usenativestate.mdx |  40 +++---
 .../unversioned/sdk/ui/swift-ui/textfield.mdx |  32 +++--
 .../sdk/ui/swift-ui/usenativestate.mdx        |  52 ++++---
 .../sdk/ui/universal/textinput.mdx            | 129 ++++++++++++++++++
 .../sdk/ui/jetpack-compose/textfield.mdx      |  32 +++--
 .../sdk/ui/jetpack-compose/usenativestate.mdx |  40 +++---
 .../v56.0.0/sdk/ui/swift-ui/textfield.mdx     |  32 +++--
 .../sdk/ui/swift-ui/usenativestate.mdx        |  52 ++++---
 .../v56.0.0/sdk/ui/universal/textinput.mdx    | 129 ++++++++++++++++++
 .../expo-ui/universal/textinput.json          |   1 +
 .../v56.0.0/expo-ui/universal/textinput.json  |   1 +
 .../build/universal/TextInput/index.d.ts      |   1 +
 .../build/universal/TextInput/index.d.ts.map  |   2 +-
 packages/expo-ui/build/universal/index.d.ts   |   2 +-
 .../expo-ui/build/universal/index.d.ts.map    |   2 +-
 .../expo-ui/src/universal/TextInput/index.tsx |   1 +
 packages/expo-ui/src/universal/index.ts       |   2 +-
 tools/src/commands/GenerateDocsAPIData.ts     |   1 +
 20 files changed, 435 insertions(+), 150 deletions(-)
 create mode 100644 docs/pages/versions/unversioned/sdk/ui/universal/textinput.mdx
 create mode 100644 docs/pages/versions/v56.0.0/sdk/ui/universal/textinput.mdx
 create mode 100644 docs/public/static/data/unversioned/expo-ui/universal/textinput.json
 create mode 100644 docs/public/static/data/v56.0.0/expo-ui/universal/textinput.json

diff --git a/docs/components/plugins/api/APIStaticData.ts b/docs/components/plugins/api/APIStaticData.ts
index 3a742331af4385..96fe054453cb90 100644
--- a/docs/components/plugins/api/APIStaticData.ts
+++ b/docs/components/plugins/api/APIStaticData.ts
@@ -241,6 +241,7 @@ export const hardcodedTypeLinks: Record<string, string> = {
   IterableIterator:
     'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator',
   KeepAwakeListener: '/versions/latest/sdk/keep-awake/#keepawakelistenerevent',
+  KeyboardTypeOptions: 'https://reactnative.dev/docs/textinput#keyboardtype',
   LocationCallback: '/versions/latest/sdk/location/#locationcallbacklocation',
   LocationErrorCallback: '/versions/latest/sdk/location/#locationerrorcallbackreason',
   LocationHeadingCallback: '/versions/latest/sdk/location/#locationheadingcallbacklocation',
@@ -273,6 +274,7 @@ export const hardcodedTypeLinks: Record<string, string> = {
   RefObject: 'https://react.dev/reference/react/useRef',
   RegExp: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp',
   Required: 'https://www.typescriptlang.org/docs/handbook/utility-types.html#requiredtype',
+  ReturnKeyTypeOptions: 'https://reactnative.dev/docs/textinput#returnkeytype',
   Response: 'https://developer.mozilla.org/en-US/docs/Web/API/Response',
   RootParamList: 'https://reactnavigation.org/docs/typescript/#navigator-specific-types',
   RouteProp: 'https://reactnavigation.org/docs/glossary-of-terms/#route-object',
diff --git a/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/textfield.mdx b/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/textfield.mdx
index 42e834179ea073..8f38d10866dfbb 100644
--- a/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/textfield.mdx
+++ b/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/textfield.mdx
@@ -260,11 +260,28 @@ When `onValueChange` is marked with the `'worklet'` directive, it runs synchrono
 ```tsx WorkletPhoneMaskExample.tsx
 import { Host, TextField, Text, useNativeState } from '@expo/ui/jetpack-compose';
 import { fillMaxWidth } from '@expo/ui/jetpack-compose/modifiers';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
   const phone = useNativeState('');
   const selection = useNativeState({ start: 0, end: 0 });
 
+  const handleValueChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted = digits;
+    if (digits.length > 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    } else if (digits.length > 3) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    }
+    if (formatted !== v) {
+      phone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
   return (
     <Host matchContents>
       <TextField
@@ -272,20 +289,7 @@ export default function WorkletPhoneMaskExample() {
         selection={selection}
         keyboardOptions={{ keyboardType: 'phone' }}
         modifiers={[fillMaxWidth()]}
-        onValueChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted = digits;
-          if (digits.length > 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          } else if (digits.length > 3) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          }
-          if (formatted !== v) {
-            phone.value = formatted;
-            selection.value = { start: formatted.length, end: formatted.length };
-          }
-        }}>
+        onValueChange={handleValueChange}>
         <TextField.Placeholder>
           <Text>(555) 123-4567</Text>
         </TextField.Placeholder>
diff --git a/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/usenativestate.mdx b/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/usenativestate.mdx
index 70767a69360fc0..aa9a1217fa4a7c 100644
--- a/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/usenativestate.mdx
+++ b/docs/pages/versions/unversioned/sdk/ui/jetpack-compose/usenativestate.mdx
@@ -24,11 +24,32 @@ The example below masks a phone number as the user types. The formatting and the
 ```tsx WorkletPhoneMaskExample.tsx
 import { Host, TextField, Text as ComposeText, useNativeState } from '@expo/ui/jetpack-compose';
 import { fillMaxWidth } from '@expo/ui/jetpack-compose/modifiers';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
   const maskedPhone = useNativeState('');
   const selection = useNativeState({ start: 0, end: 0 });
 
+  const handleValueChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted: string;
+    if (digits.length === 0) {
+      formatted = '';
+    } else if (digits.length <= 3) {
+      formatted = digits;
+    } else if (digits.length <= 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    } else {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    }
+    if (formatted !== v) {
+      maskedPhone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
   return (
     <Host matchContents>
       <TextField
@@ -36,24 +57,7 @@ export default function WorkletPhoneMaskExample() {
         selection={selection}
         keyboardOptions={{ keyboardType: 'phone' }}
         modifiers={[fillMaxWidth()]}
-        onValueChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted: string;
-          if (digits.length === 0) {
-            formatted = '';
-          } else if (digits.length <= 3) {
-            formatted = digits;
-          } else if (digits.length <= 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          } else {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          }
-          if (formatted !== v) {
-            maskedPhone.value = formatted;
-            selection.value = { start: formatted.length, end: formatted.length };
-          }
-        }}>
+        onValueChange={handleValueChange}>
         <TextField.Placeholder>
           <ComposeText>(555) 123-4567</ComposeText>
         </TextField.Placeholder>
diff --git a/docs/pages/versions/unversioned/sdk/ui/swift-ui/textfield.mdx b/docs/pages/versions/unversioned/sdk/ui/swift-ui/textfield.mdx
index 7dd6e92b4721fb..fadb32028a87da 100644
--- a/docs/pages/versions/unversioned/sdk/ui/swift-ui/textfield.mdx
+++ b/docs/pages/versions/unversioned/sdk/ui/swift-ui/textfield.mdx
@@ -184,11 +184,28 @@ When `onTextChange` is marked with the `'worklet'` directive, it runs synchronou
 ```tsx WorkletPhoneMaskExample.tsx
 import { Host, TextField, useNativeState } from '@expo/ui/swift-ui';
 import { keyboardType } from '@expo/ui/swift-ui/modifiers';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
   const phone = useNativeState('');
   const selection = useNativeState({ start: 0, end: 0 });
 
+  const handleTextChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted = digits;
+    if (digits.length > 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    } else if (digits.length > 3) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    }
+    if (formatted !== v) {
+      phone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
   return (
     <Host matchContents>
       <TextField
@@ -196,20 +213,7 @@ export default function WorkletPhoneMaskExample() {
         selection={selection}
         placeholder="(555) 123-4567"
         modifiers={[keyboardType('phone-pad')]}
-        onTextChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted = digits;
-          if (digits.length > 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          } else if (digits.length > 3) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          }
-          if (formatted !== v) {
-            phone.value = formatted;
-            selection.value = { start: formatted.length, end: formatted.length };
-          }
-        }}
+        onTextChange={handleTextChange}
       />
     </Host>
   );
diff --git a/docs/pages/versions/unversioned/sdk/ui/swift-ui/usenativestate.mdx b/docs/pages/versions/unversioned/sdk/ui/swift-ui/usenativestate.mdx
index b3d13813f6f9bb..2f9fe889bb0ec8 100644
--- a/docs/pages/versions/unversioned/sdk/ui/swift-ui/usenativestate.mdx
+++ b/docs/pages/versions/unversioned/sdk/ui/swift-ui/usenativestate.mdx
@@ -19,47 +19,45 @@ import { APIInstallSection } from '~/components/plugins/InstallSection';
 
 > **Note:** Using worklets requires installing [`react-native-reanimated`](https://docs.swmansion.com/react-native-reanimated/) and [`react-native-worklets`](https://docs.swmansion.com/react-native-worklets/) in your project. `useNativeState` itself works without them, but the synchronous UI-thread updates shown below depend on the worklet runtime.
 
-The example below masks a phone number as the user types. The formatting and the write to `maskedPhone.value` both happen synchronously on the UI thread, so there is no flicker between the typed value and the masked value.
+The example below masks a phone number as the user types. The formatting and the writes to `maskedPhone.value` (text) and `selection.value` (cursor position) all happen synchronously on the UI thread, so there is no flicker between the typed value and the masked value.
 
 ```tsx WorkletPhoneMaskExample.tsx
-import { Host, TextField, TextFieldRef, useNativeState } from '@expo/ui/swift-ui';
+import { Host, TextField, useNativeState } from '@expo/ui/swift-ui';
 import { keyboardType } from '@expo/ui/swift-ui/modifiers';
-import { useCallback, useRef } from 'react';
-import { runOnJS } from 'react-native-worklets';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
-  const phoneRef = useRef<TextFieldRef>(null);
   const maskedPhone = useNativeState('');
+  const selection = useNativeState({ start: 0, end: 0 });
 
-  const setPhoneCursor = useCallback((position: number) => {
-    phoneRef.current?.setSelection(position, position);
-  }, []);
+  const handleTextChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted: string;
+    if (digits.length === 0) {
+      formatted = '';
+    } else if (digits.length <= 3) {
+      formatted = digits;
+    } else if (digits.length <= 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    } else {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    }
+    if (formatted !== v) {
+      maskedPhone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
 
   return (
     <Host matchContents>
       <TextField
-        ref={phoneRef}
         text={maskedPhone}
+        selection={selection}
         placeholder="(555) 123-4567"
         modifiers={[keyboardType('phone-pad')]}
-        onTextChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted: string;
-          if (digits.length === 0) {
-            formatted = '';
-          } else if (digits.length <= 3) {
-            formatted = digits;
-          } else if (digits.length <= 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          } else {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          }
-          if (formatted !== v) {
-            maskedPhone.value = formatted;
-            runOnJS(setPhoneCursor)(formatted.length);
-          }
-        }}
+        onTextChange={handleTextChange}
       />
     </Host>
   );
diff --git a/docs/pages/versions/unversioned/sdk/ui/universal/textinput.mdx b/docs/pages/versions/unversioned/sdk/ui/universal/textinput.mdx
new file mode 100644
index 00000000000000..228f0d5334d8c7
--- /dev/null
+++ b/docs/pages/versions/unversioned/sdk/ui/universal/textinput.mdx
@@ -0,0 +1,129 @@
+---
+title: TextInput
+description: A text input backed by native SwiftUI and Jetpack Compose components, with a React Native-compatible API.
+sourceCodeUrl: 'https://github.com/expo/expo/tree/main/packages/expo-ui'
+packageName: '@expo/ui'
+platforms: ['android', 'ios', 'web', 'expo-go']
+---
+
+import APISection from '~/components/plugins/APISection';
+import { APIInstallSection } from '~/components/plugins/InstallSection';
+
+A text input that routes to [`TextField`](../jetpack-compose/textfield) from `@expo/ui/jetpack-compose` on Android, [`TextField`](../swift-ui/textfield) from `@expo/ui/swift-ui` on iOS, and React Native's [`TextInput`](https://reactnative.dev/docs/textinput) on web.
+
+The API mirrors React Native's [`TextInput`](https://reactnative.dev/docs/textinput), with two changes: [`value`](#value) and [`selection`](#selection) are observable state objects (created with `useNativeState`), and [`onChangeText`](#onchangetext) can be a worklet for synchronously updating the state on the UI thread.
+
+## Installation
+
+<APIInstallSection />
+
+## Usage
+
+### Uncontrolled
+
+Omit [`value`](#value) and the field manages its own text internally. Use [`onChangeText`](#onchangetext) to observe edits, and use the [ref](#textinputref) for imperative actions like `focus`, `blur`, and `clear`.
+
+```tsx UncontrolledTextInputExample.tsx
+import { Button, Column, Host, TextInput, type TextInputRef } from '@expo/ui';
+import { useRef } from 'react';
+
+export default function UncontrolledTextInputExample() {
+  const inputRef = useRef<TextInputRef>(null);
+
+  return (
+    <Host matchContents={{ vertical: true }}>
+      <Column spacing={8}>
+        <TextInput
+          ref={inputRef}
+          defaultValue="hello"
+          placeholder="Type here"
+          onChangeText={value => console.log(value)}
+        />
+        <Button label="Clear" onPress={() => inputRef.current?.clear()} />
+      </Column>
+    </Host>
+  );
+}
+```
+
+### Controlled
+
+Pass [`value`](#value) to drive the field from a `useNativeState` observable. The example below replaces `Hello` with `World` as you type.
+
+```tsx ControlledTextInputExample.tsx
+import { Host, TextInput, useNativeState } from '@expo/ui';
+import { useEffectEvent } from 'react';
+
+export default function ControlledTextInputExample() {
+  const text = useNativeState('');
+
+  const handleChangeText = useEffectEvent((value: string) => {
+    'worklet';
+    text.value = value === 'Hello' ? 'World' : value;
+  });
+
+  return (
+    <Host matchContents={{ vertical: true }}>
+      <TextInput value={text} placeholder="Type here" onChangeText={handleChangeText} />
+    </Host>
+  );
+}
+```
+
+### Worklet masking
+
+Add the `'worklet'` directive to [`onChangeText`](#onchangetext) for synchronously updating the state on the UI thread. Writes to `value` land without the JS-thread round-trip that can cause cursor flicker.
+
+> **Note:** Worklets require installing [`react-native-reanimated`](https://docs.swmansion.com/react-native-reanimated/) and [`react-native-worklets`](https://docs.swmansion.com/react-native-worklets/).
+
+```tsx PhoneMaskExample.tsx
+import { Host, TextInput, useNativeState } from '@expo/ui';
+import { useEffectEvent } from 'react';
+
+function formatPhone(input: string) {
+  'worklet';
+  const digits = input.replace(/\D/g, '').slice(0, 10);
+  if (digits.length <= 3) return digits;
+  if (digits.length <= 6) return `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+  return `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+}
+
+export default function PhoneMaskExample() {
+  const phone = useNativeState('');
+  const selection = useNativeState({ start: 0, end: 0 });
+
+  const handleChangeText = useEffectEvent((value: string) => {
+    'worklet';
+    const formatted = formatPhone(value);
+    if (formatted !== value) {
+      phone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
+  return (
+    <Host matchContents={{ vertical: true }}>
+      <TextInput
+        value={phone}
+        selection={selection}
+        keyboardType="phone-pad"
+        placeholder="(555) 123-4567"
+        onChangeText={handleChangeText}
+      />
+    </Host>
+  );
+}
+```
+
+## Unsupported React Native props
+
+Some React Native `TextInput` props are not supported, because Compose's `TextField` or SwiftUI's `TextField` does not expose an equivalent, or because the prop is replaced by a different mechanism. See the [API](#api) section below for the supported props. If a missing prop blocks your use case, [open an issue](https://github.com/expo/expo/issues/new/choose) so it can be prioritized.
+
+## API
+
+```tsx
+import { TextInput, useNativeState } from '@expo/ui';
+```
+
+<APISection packageName="expo-ui/universal/textinput" apiName="TextInput" />
diff --git a/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/textfield.mdx b/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/textfield.mdx
index f28fcc5baec6bf..3d85f19e24c338 100644
--- a/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/textfield.mdx
+++ b/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/textfield.mdx
@@ -260,11 +260,28 @@ When `onValueChange` is marked with the `'worklet'` directive, it runs synchrono
 ```tsx WorkletPhoneMaskExample.tsx
 import { Host, TextField, Text, useNativeState } from '@expo/ui/jetpack-compose';
 import { fillMaxWidth } from '@expo/ui/jetpack-compose/modifiers';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
   const phone = useNativeState('');
   const selection = useNativeState({ start: 0, end: 0 });
 
+  const handleValueChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted = digits;
+    if (digits.length > 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    } else if (digits.length > 3) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    }
+    if (formatted !== v) {
+      phone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
   return (
     <Host matchContents>
       <TextField
@@ -272,20 +289,7 @@ export default function WorkletPhoneMaskExample() {
         selection={selection}
         keyboardOptions={{ keyboardType: 'phone' }}
         modifiers={[fillMaxWidth()]}
-        onValueChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted = digits;
-          if (digits.length > 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          } else if (digits.length > 3) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          }
-          if (formatted !== v) {
-            phone.value = formatted;
-            selection.value = { start: formatted.length, end: formatted.length };
-          }
-        }}>
+        onValueChange={handleValueChange}>
         <TextField.Placeholder>
           <Text>(555) 123-4567</Text>
         </TextField.Placeholder>
diff --git a/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/usenativestate.mdx b/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/usenativestate.mdx
index ce2eb7b743d6d7..c02437e5c902fc 100644
--- a/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/usenativestate.mdx
+++ b/docs/pages/versions/v56.0.0/sdk/ui/jetpack-compose/usenativestate.mdx
@@ -24,11 +24,32 @@ The example below masks a phone number as the user types. The formatting and the
 ```tsx WorkletPhoneMaskExample.tsx
 import { Host, TextField, Text as ComposeText, useNativeState } from '@expo/ui/jetpack-compose';
 import { fillMaxWidth } from '@expo/ui/jetpack-compose/modifiers';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
   const maskedPhone = useNativeState('');
   const selection = useNativeState({ start: 0, end: 0 });
 
+  const handleValueChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted: string;
+    if (digits.length === 0) {
+      formatted = '';
+    } else if (digits.length <= 3) {
+      formatted = digits;
+    } else if (digits.length <= 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    } else {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    }
+    if (formatted !== v) {
+      maskedPhone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
   return (
     <Host matchContents>
       <TextField
@@ -36,24 +57,7 @@ export default function WorkletPhoneMaskExample() {
         selection={selection}
         keyboardOptions={{ keyboardType: 'phone' }}
         modifiers={[fillMaxWidth()]}
-        onValueChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted: string;
-          if (digits.length === 0) {
-            formatted = '';
-          } else if (digits.length <= 3) {
-            formatted = digits;
-          } else if (digits.length <= 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          } else {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          }
-          if (formatted !== v) {
-            maskedPhone.value = formatted;
-            selection.value = { start: formatted.length, end: formatted.length };
-          }
-        }}>
+        onValueChange={handleValueChange}>
         <TextField.Placeholder>
           <ComposeText>(555) 123-4567</ComposeText>
         </TextField.Placeholder>
diff --git a/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/textfield.mdx b/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/textfield.mdx
index bb3ccfe2f4be58..59a4fed11a59ec 100644
--- a/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/textfield.mdx
+++ b/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/textfield.mdx
@@ -184,11 +184,28 @@ When `onTextChange` is marked with the `'worklet'` directive, it runs synchronou
 ```tsx WorkletPhoneMaskExample.tsx
 import { Host, TextField, useNativeState } from '@expo/ui/swift-ui';
 import { keyboardType } from '@expo/ui/swift-ui/modifiers';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
   const phone = useNativeState('');
   const selection = useNativeState({ start: 0, end: 0 });
 
+  const handleTextChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted = digits;
+    if (digits.length > 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    } else if (digits.length > 3) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    }
+    if (formatted !== v) {
+      phone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
   return (
     <Host matchContents>
       <TextField
@@ -196,20 +213,7 @@ export default function WorkletPhoneMaskExample() {
         selection={selection}
         placeholder="(555) 123-4567"
         modifiers={[keyboardType('phone-pad')]}
-        onTextChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted = digits;
-          if (digits.length > 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          } else if (digits.length > 3) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          }
-          if (formatted !== v) {
-            phone.value = formatted;
-            selection.value = { start: formatted.length, end: formatted.length };
-          }
-        }}
+        onTextChange={handleTextChange}
       />
     </Host>
   );
diff --git a/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/usenativestate.mdx b/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/usenativestate.mdx
index 194c71edb79dff..fdd764bac1fddf 100644
--- a/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/usenativestate.mdx
+++ b/docs/pages/versions/v56.0.0/sdk/ui/swift-ui/usenativestate.mdx
@@ -19,47 +19,45 @@ import { APIInstallSection } from '~/components/plugins/InstallSection';
 
 > **Note:** Using worklets requires installing [`react-native-reanimated`](https://docs.swmansion.com/react-native-reanimated/) and [`react-native-worklets`](https://docs.swmansion.com/react-native-worklets/) in your project. `useNativeState` itself works without them, but the synchronous UI-thread updates shown below depend on the worklet runtime.
 
-The example below masks a phone number as the user types. The formatting and the write to `maskedPhone.value` both happen synchronously on the UI thread, so there is no flicker between the typed value and the masked value.
+The example below masks a phone number as the user types. The formatting and the writes to `maskedPhone.value` (text) and `selection.value` (cursor position) all happen synchronously on the UI thread, so there is no flicker between the typed value and the masked value.
 
 ```tsx WorkletPhoneMaskExample.tsx
-import { Host, TextField, TextFieldRef, useNativeState } from '@expo/ui/swift-ui';
+import { Host, TextField, useNativeState } from '@expo/ui/swift-ui';
 import { keyboardType } from '@expo/ui/swift-ui/modifiers';
-import { useCallback, useRef } from 'react';
-import { runOnJS } from 'react-native-worklets';
+import { useEffectEvent } from 'react';
 
 export default function WorkletPhoneMaskExample() {
-  const phoneRef = useRef<TextFieldRef>(null);
   const maskedPhone = useNativeState('');
+  const selection = useNativeState({ start: 0, end: 0 });
 
-  const setPhoneCursor = useCallback((position: number) => {
-    phoneRef.current?.setSelection(position, position);
-  }, []);
+  const handleTextChange = useEffectEvent((v: string) => {
+    'worklet';
+    const digits = v.replace(/\D/g, '').slice(0, 10);
+    let formatted: string;
+    if (digits.length === 0) {
+      formatted = '';
+    } else if (digits.length <= 3) {
+      formatted = digits;
+    } else if (digits.length <= 6) {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+    } else {
+      formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+    }
+    if (formatted !== v) {
+      maskedPhone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
 
   return (
     <Host matchContents>
       <TextField
-        ref={phoneRef}
         text={maskedPhone}
+        selection={selection}
         placeholder="(555) 123-4567"
         modifiers={[keyboardType('phone-pad')]}
-        onTextChange={v => {
-          'worklet';
-          const digits = v.replace(/\D/g, '').slice(0, 10);
-          let formatted: string;
-          if (digits.length === 0) {
-            formatted = '';
-          } else if (digits.length <= 3) {
-            formatted = digits;
-          } else if (digits.length <= 6) {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
-          } else {
-            formatted = `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
-          }
-          if (formatted !== v) {
-            maskedPhone.value = formatted;
-            runOnJS(setPhoneCursor)(formatted.length);
-          }
-        }}
+        onTextChange={handleTextChange}
       />
     </Host>
   );
diff --git a/docs/pages/versions/v56.0.0/sdk/ui/universal/textinput.mdx b/docs/pages/versions/v56.0.0/sdk/ui/universal/textinput.mdx
new file mode 100644
index 00000000000000..a23f6631411753
--- /dev/null
+++ b/docs/pages/versions/v56.0.0/sdk/ui/universal/textinput.mdx
@@ -0,0 +1,129 @@
+---
+title: TextInput
+description: A text input backed by native SwiftUI and Jetpack Compose components, with a React Native-compatible API.
+sourceCodeUrl: 'https://github.com/expo/expo/tree/sdk-56/packages/expo-ui'
+packageName: '@expo/ui'
+platforms: ['android', 'ios', 'web', 'expo-go']
+---
+
+import APISection from '~/components/plugins/APISection';
+import { APIInstallSection } from '~/components/plugins/InstallSection';
+
+A text input that routes to [`TextField`](../jetpack-compose/textfield) from `@expo/ui/jetpack-compose` on Android, [`TextField`](../swift-ui/textfield) from `@expo/ui/swift-ui` on iOS, and React Native's [`TextInput`](https://reactnative.dev/docs/textinput) on web.
+
+The API mirrors React Native's [`TextInput`](https://reactnative.dev/docs/textinput), with two changes: [`value`](#value) and [`selection`](#selection) are observable state objects (created with `useNativeState`), and [`onChangeText`](#onchangetext) can be a worklet for synchronously updating the state on the UI thread.
+
+## Installation
+
+<APIInstallSection />
+
+## Usage
+
+### Uncontrolled
+
+Omit [`value`](#value) and the field manages its own text internally. Use [`onChangeText`](#onchangetext) to observe edits, and use the [ref](#textinputref) for imperative actions like `focus`, `blur`, and `clear`.
+
+```tsx UncontrolledTextInputExample.tsx
+import { Button, Column, Host, TextInput, type TextInputRef } from '@expo/ui';
+import { useRef } from 'react';
+
+export default function UncontrolledTextInputExample() {
+  const inputRef = useRef<TextInputRef>(null);
+
+  return (
+    <Host matchContents={{ vertical: true }}>
+      <Column spacing={8}>
+        <TextInput
+          ref={inputRef}
+          defaultValue="hello"
+          placeholder="Type here"
+          onChangeText={value => console.log(value)}
+        />
+        <Button label="Clear" onPress={() => inputRef.current?.clear()} />
+      </Column>
+    </Host>
+  );
+}
+```
+
+### Controlled
+
+Pass [`value`](#value) to drive the field from a `useNativeState` observable. The example below replaces `Hello` with `World` as you type.
+
+```tsx ControlledTextInputExample.tsx
+import { Host, TextInput, useNativeState } from '@expo/ui';
+import { useEffectEvent } from 'react';
+
+export default function ControlledTextInputExample() {
+  const text = useNativeState('');
+
+  const handleChangeText = useEffectEvent((value: string) => {
+    'worklet';
+    text.value = value === 'Hello' ? 'World' : value;
+  });
+
+  return (
+    <Host matchContents={{ vertical: true }}>
+      <TextInput value={text} placeholder="Type here" onChangeText={handleChangeText} />
+    </Host>
+  );
+}
+```
+
+### Worklet masking
+
+Add the `'worklet'` directive to [`onChangeText`](#onchangetext) for synchronously updating the state on the UI thread. Writes to `value` land without the JS-thread round-trip that can cause cursor flicker.
+
+> **Note:** Worklets require installing [`react-native-reanimated`](https://docs.swmansion.com/react-native-reanimated/) and [`react-native-worklets`](https://docs.swmansion.com/react-native-worklets/).
+
+```tsx PhoneMaskExample.tsx
+import { Host, TextInput, useNativeState } from '@expo/ui';
+import { useEffectEvent } from 'react';
+
+function formatPhone(input: string) {
+  'worklet';
+  const digits = input.replace(/\D/g, '').slice(0, 10);
+  if (digits.length <= 3) return digits;
+  if (digits.length <= 6) return `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
+  return `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+}
+
+export default function PhoneMaskExample() {
+  const phone = useNativeState('');
+  const selection = useNativeState({ start: 0, end: 0 });
+
+  const handleChangeText = useEffectEvent((value: string) => {
+    'worklet';
+    const formatted = formatPhone(value);
+    if (formatted !== value) {
+      phone.value = formatted;
+      // Snaps to end for demo. Real masks need smarter cursor handling.
+      selection.value = { start: formatted.length, end: formatted.length };
+    }
+  });
+
+  return (
+    <Host matchContents={{ vertical: true }}>
+      <TextInput
+        value={phone}
+        selection={selection}
+        keyboardType="phone-pad"
+        placeholder="(555) 123-4567"
+        onChangeText={handleChangeText}
+      />
+    </Host>
+  );
+}
+```
+
+## Unsupported React Native props
+
+Some React Native `TextInput` props are not supported, because Compose's `TextField` or SwiftUI's `TextField` does not expose an equivalent, or because the prop is replaced by a different mechanism. See the [API](#api) section below for the supported props. If a missing prop blocks your use case, [open an issue](https://github.com/expo/expo/issues/new/choose) so it can be prioritized.
+
+## API
+
+```tsx
+import { TextInput, useNativeState } from '@expo/ui';
+```
+
+<APISection packageName="expo-ui/universal/textinput" apiName="TextInput" />
diff --git a/docs/public/static/data/unversioned/expo-ui/universal/textinput.json b/docs/public/static/data/unversioned/expo-ui/universal/textinput.json
new file mode 100644
index 00000000000000..bd2f977d8484ce
--- /dev/null
+++ b/docs/public/static/data/unversioned/expo-ui/universal/textinput.json
@@ -0,0 +1 @@
+{"schemaVersion":"2.0","name":"expo-ui/universal/textinput","variant":"project","kind":1,"children":[{"name":"TextInputProps","variant":"declaration","kind":256,"comment":{"summary":[{"kind":"text","text":"Props for the "},{"kind":"code","text":"`TextInput`"},{"kind":"text","text":" component."}]},"children":[{"name":"autoCapitalize","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Controls automatic capitalization of input."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"'sentences'"}]}]},"type":{"type":"union","types":[{"type":"literal","value":"none"},{"type":"literal","value":"words"},{"type":"literal","value":"sentences"},{"type":"literal","value":"characters"}]}},{"name":"autoComplete","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Autofill hint. iOS maps to "},{"kind":"code","text":"`textContentType`"},{"kind":"text","text":"; Android maps to Compose's\n"},{"kind":"code","text":"`Modifier.semantics { contentType = ... }`"},{"kind":"text","text":"."}]},"type":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/universal/TextInput/utils.ts","qualifiedName":"AutoComplete"},"name":"AutoComplete","package":"@expo/ui"}},{"name":"autoCorrect","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If false, disables autocorrect / spellcheck suggestions."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"true"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"autoFocus","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, focuses the input on mount."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"caretHidden","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, the cursor is hidden.\n\nOn iOS, this is implemented via "},{"kind":"code","text":"`tint('transparent')`"},{"kind":"text","text":", which also makes\nthe selection highlight invisible. If you set both "},{"kind":"code","text":"`caretHidden`"},{"kind":"text","text":" and\n"},{"kind":"code","text":"`selectionColor`"},{"kind":"text","text":", the caret-hide wins on iOS."}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"cursorColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the text cursor."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"defaultValue","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Initial text shown when the input mounts and "},{"kind":"code","text":"`value`"},{"kind":"text","text":" is not provided.\nIgnored once the user starts typing or if "},{"kind":"code","text":"`value`"},{"kind":"text","text":" is set."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"editable","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If false, the input cannot be edited. Selection is still allowed so the\nuser can copy text out of the field."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"true"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"enterKeyHint","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"HTML-style hint for the keyboard return key. Maps to "},{"kind":"code","text":"`returnKeyType`"},{"kind":"text","text":".\nWhen both are set, "},{"kind":"code","text":"`returnKeyType`"},{"kind":"text","text":" wins."}]},"type":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/universal/TextInput/utils.ts","qualifiedName":"EnterKeyHint"},"name":"EnterKeyHint","package":"@expo/ui"}},{"name":"inputMode","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"HTML-style hint for the keyboard variant. Maps to "},{"kind":"code","text":"`keyboardType`"},{"kind":"text","text":". When\nboth are set, "},{"kind":"code","text":"`keyboardType`"},{"kind":"text","text":" wins."}]},"type":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/universal/TextInput/utils.ts","qualifiedName":"InputMode"},"name":"InputMode","package":"@expo/ui"}},{"name":"keyboardType","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Determines which keyboard variant is shown.\n\nLacking native support:\n- iOS: "},{"kind":"code","text":"`'visible-password'`"},{"kind":"text","text":" falls back to the default keyboard.\n- Android: iOS-specific values ("},{"kind":"code","text":"`'ascii-capable'`"},{"kind":"text","text":",\n  "},{"kind":"code","text":"`'numbers-and-punctuation'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'name-phone-pad'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'twitter'`"},{"kind":"text","text":",\n  "},{"kind":"code","text":"`'web-search'`"},{"kind":"text","text":") fall back to the text keyboard."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"'default'"}]}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/Components/TextInput/TextInput.d.ts","qualifiedName":"KeyboardTypeOptions"},"name":"KeyboardTypeOptions","package":"react-native"}},{"name":"maxLength","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Maximum number of characters allowed."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"modifiers","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Platform-specific modifier escape hatch. Pass an array of modifier configs\nfrom "},{"kind":"code","text":"`@expo/ui/swift-ui/modifiers`"},{"kind":"text","text":" or "},{"kind":"code","text":"`@expo/ui/jetpack-compose/modifiers`"},{"kind":"text","text":".\nModifiers from the wrong platform are ignored at runtime."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"android"}]},{"tag":"@platform","content":[{"kind":"text","text":"ios"}]}]},"type":{"type":"array","elementType":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/types.ts","qualifiedName":"ModifierConfig"},"name":"ModifierConfig","package":"@expo/ui"}}},{"name":"multiline","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, the field accepts multiple lines of input and grows vertically\nas the user types."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"numberOfLines","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Number of lines the field reserves when "},{"kind":"code","text":"`multiline`"},{"kind":"text","text":" is true. Forces a\nfixed visible height of that many lines.\n\nLacking native support:\n- iOS: requires iOS 16+; below that, the field grows naturally."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"onBlur","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the field loses focus."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onChangeText","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called every time the text value changes. Receives the new string."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"text","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"string"}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onContentSizeChange","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the rendered size of the input changes. Sizes in points/dp.\n\nUnlike RN's "},{"kind":"code","text":"`onContentSizeChange`"},{"kind":"text","text":", this dispatches the *view*'s outer\ngeometry, including any padding/border applied via "},{"kind":"code","text":"`style`"},{"kind":"text","text":" or modifiers.\nIf you use this for autogrow, account for that."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"size","variant":"param","kind":32768,"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"height","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}},{"name":"width","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}}]}}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onFocus","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the field gains focus."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onSelectionChange","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the text selection range changes."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"selection","variant":"param","kind":32768,"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"end","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}},{"name":"start","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}}]}}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onSubmitEditing","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the user taps the keyboard return key. Receives the current\ntext in the input."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"text","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"string"}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"placeholder","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Placeholder text shown when the field is empty."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"placeholderTextColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the placeholder text."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"readOnly","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Alias for "},{"kind":"code","text":"`editable={false}`"},{"kind":"text","text":". When both are set, "},{"kind":"code","text":"`editable`"},{"kind":"text","text":" wins."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"ref","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Ref exposing imperative methods ("},{"kind":"code","text":"`focus`"},{"kind":"text","text":", "},{"kind":"code","text":"`blur`"},{"kind":"text","text":", "},{"kind":"code","text":"`clear`"},{"kind":"text","text":")."}]},"type":{"type":"reference","target":{"packageName":"@types/react","packagePath":"index.d.ts","qualifiedName":"React.Ref"},"typeArguments":[{"type":"reference","name":"TextInputRef","package":"@expo/ui"}],"name":"Ref","package":"@types/react","qualifiedName":"React.Ref"}},{"name":"returnKeyType","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Determines the label of the keyboard return key.\n\nLacking native support:\n- iOS: "},{"kind":"code","text":"`'emergency-call'`"},{"kind":"text","text":" falls back to the default Return key.\n- Android: "},{"kind":"code","text":"`'join'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'route'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'emergency-call'`"},{"kind":"text","text":" fall back to the\n  default action."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/Components/TextInput/TextInput.d.ts","qualifiedName":"ReturnKeyTypeOptions"},"name":"ReturnKeyTypeOptions","package":"react-native"}},{"name":"rows","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"HTML-style alias for "},{"kind":"code","text":"`numberOfLines`"},{"kind":"text","text":". When both are set, "},{"kind":"code","text":"`numberOfLines`"},{"kind":"text","text":" wins."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"secureTextEntry","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, the input obscures its text — used for password fields.\n- iOS: backed by SwiftUI's "},{"kind":"code","text":"`SecureField`"},{"kind":"text","text":". The following props are no-ops\n  in this mode: "},{"kind":"code","text":"`selection`"},{"kind":"text","text":", "},{"kind":"code","text":"`selectTextOnFocus`"},{"kind":"text","text":", "},{"kind":"code","text":"`onSelectionChange`"},{"kind":"text","text":",\n  "},{"kind":"code","text":"`multiline`"},{"kind":"text","text":", "},{"kind":"code","text":"`numberOfLines`"},{"kind":"text","text":".\n- Android: backed by Compose's "},{"kind":"code","text":"`PasswordVisualTransformation`"},{"kind":"text","text":"."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"selection","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Observable state the field writes the current selection to.\nCreate with "},{"kind":"code","text":"`useNativeState({ start: 0, end: 0 })`"},{"kind":"text","text":".\nUse "},{"kind":"code","text":"`ref.setSelection(start, end)`"},{"kind":"text","text":" to set selection programmatically."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"ios 18.0+ — pre-iOS 18 the prop is ignored."}]}]},"type":{"type":"reference","typeArguments":[{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"end","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}},{"name":"start","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}}]}}],"name":"ObservableState","package":"@expo/ui"}},{"name":"selectionColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the selected text highlight. On iOS this also tints the cursor\n(UIKit's "},{"kind":"code","text":"`tintColor`"},{"kind":"text","text":" covers both); pass "},{"kind":"code","text":"`cursorColor`"},{"kind":"text","text":" only if you want\ndifferent cursor color on Android."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"selectionHandleColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the selection drag handles."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"android"}]}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"selectTextOnFocus","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, all text is selected when the field gains focus. Implemented\nvia "},{"kind":"code","text":"`setSelection(0, length)`"},{"kind":"text","text":" on focus, so if you also pass "},{"kind":"code","text":"`selection`"},{"kind":"text","text":",\nits value is overwritten on every focus."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]},{"tag":"@platform","content":[{"kind":"text","text":"ios 18.0+, android, web"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"style","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Box-level style — sizing, padding, background, border, opacity."}]},"type":{"type":"reference","target":{"packageName":"typescript","packagePath":"lib/lib.es5.d.ts","qualifiedName":"Pick"},"typeArguments":[{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheetTypes.d.ts","qualifiedName":"ViewStyle"},"name":"ViewStyle","package":"react-native"},{"type":"union","types":[{"type":"literal","value":"padding"},{"type":"literal","value":"paddingHorizontal"},{"type":"literal","value":"paddingVertical"},{"type":"literal","value":"paddingTop"},{"type":"literal","value":"paddingBottom"},{"type":"literal","value":"paddingLeft"},{"type":"literal","value":"paddingRight"},{"type":"literal","value":"backgroundColor"},{"type":"literal","value":"borderRadius"},{"type":"literal","value":"borderWidth"},{"type":"literal","value":"borderColor"},{"type":"literal","value":"opacity"},{"type":"literal","value":"width"},{"type":"literal","value":"height"}]}],"name":"Pick","package":"typescript"}},{"name":"testID","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Identifier used to locate the component in end-to-end tests."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"textAlign","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Horizontal alignment of the text content.\n\nLacking native support:\n- iOS: "},{"kind":"code","text":"`'justify'`"},{"kind":"text","text":" is not supported by SwiftUI's "},{"kind":"code","text":"`TextField`"},{"kind":"text","text":" and falls\n  back to the default alignment."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"'auto'"}]}]},"type":{"type":"union","types":[{"type":"literal","value":"auto"},{"type":"literal","value":"center"},{"type":"literal","value":"left"},{"type":"literal","value":"right"},{"type":"literal","value":"justify"}]}},{"name":"textStyle","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Text-level style — font, color, alignment, spacing."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"color","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Text color. Accepts any CSS color string."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"fontFamily","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Font family name."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"fontSize","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Font size in points."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"fontWeight","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Weight of the font."}]},"type":{"type":"union","types":[{"type":"literal","value":"normal"},{"type":"literal","value":"bold"},{"type":"literal","value":"100"},{"type":"literal","value":"200"},{"type":"literal","value":"300"},{"type":"literal","value":"400"},{"type":"literal","value":"500"},{"type":"literal","value":"600"},{"type":"literal","value":"700"},{"type":"literal","value":"800"},{"type":"literal","value":"900"}]}},{"name":"letterSpacing","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Spacing between characters in points."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"lineHeight","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Line height in points.\n\nOn iOS this is approximated as "},{"kind":"code","text":"`lineSpacing(lineHeight - fontSize)`"},{"kind":"text","text":" because\nSwiftUI only exposes a true "},{"kind":"code","text":"`lineHeight(_:)`"},{"kind":"text","text":" modifier on iOS 26+. For exact\nspacing on iOS 26+ compose the "},{"kind":"code","text":"`lineHeight`"},{"kind":"text","text":" modifier from\n"},{"kind":"code","text":"`@expo/ui/swift-ui/modifiers`"},{"kind":"text","text":" via the "},{"kind":"code","text":"`modifiers`"},{"kind":"text","text":" prop."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"textAlign","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Horizontal alignment of the text."}]},"type":{"type":"union","types":[{"type":"literal","value":"center"},{"type":"literal","value":"left"},{"type":"literal","value":"right"}]}}]}}},{"name":"underlineColorAndroid","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the underline indicator on Android. iOS / web ignore this."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"android"}]}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"value","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"An observable state holding the current text. Create one with\n"},{"kind":"code","text":"`useNativeState('initial value')`"},{"kind":"text","text":" from "},{"kind":"code","text":"`@expo/ui`"},{"kind":"text","text":".\nOmit to let the field manage its own internal state."}]},"type":{"type":"reference","typeArguments":[{"type":"intrinsic","name":"string"}],"name":"ObservableState","package":"@expo/ui"}}]},{"name":"ObservableState","variant":"declaration","kind":2097152,"children":[{"name":"value","variant":"declaration","kind":1024,"type":{"type":"reference","name":"T","package":"@expo/ui","refersToTypeParameter":true}}],"typeParameters":[{"name":"T","variant":"typeParam","kind":131072}]},{"name":"TextInputRef","variant":"declaration","kind":2097152,"comment":{"summary":[{"kind":"text","text":"Imperative methods exposed via the "},{"kind":"code","text":"`TextInput`"},{"kind":"text","text":" ref."}]},"children":[{"name":"blur","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Programmatically blur the input."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"clear","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Clear the current text."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"focus","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Programmatically focus the input."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"isFocused","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Returns whether the input currently has focus."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"boolean"}}]}}},{"name":"setSelection","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Programmatically set the selection range."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"ios 18.0+"}]}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"start","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"number"}},{"name":"end","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"number"}}],"type":{"type":"reference","target":{"packageName":"typescript","packagePath":"lib/lib.es5.d.ts","qualifiedName":"Promise"},"typeArguments":[{"type":"intrinsic","name":"void"}],"name":"Promise","package":"typescript"}}]}}}]},{"name":"TextInput","variant":"declaration","kind":64,"signatures":[{"name":"TextInput","variant":"signature","kind":4096,"parameters":[{"name":"__namedParameters","variant":"param","kind":32768,"type":{"type":"reference","name":"TextInputProps","package":"@expo/ui"}}],"type":{"type":"reference","target":{"packageName":"@types/react","packagePath":"jsx-runtime.d.ts","qualifiedName":"JSX.Element"},"name":"Element","package":"@types/react","qualifiedName":"JSX.Element"}}]}],"packageName":"@expo/ui"}
\ No newline at end of file
diff --git a/docs/public/static/data/v56.0.0/expo-ui/universal/textinput.json b/docs/public/static/data/v56.0.0/expo-ui/universal/textinput.json
new file mode 100644
index 00000000000000..bd2f977d8484ce
--- /dev/null
+++ b/docs/public/static/data/v56.0.0/expo-ui/universal/textinput.json
@@ -0,0 +1 @@
+{"schemaVersion":"2.0","name":"expo-ui/universal/textinput","variant":"project","kind":1,"children":[{"name":"TextInputProps","variant":"declaration","kind":256,"comment":{"summary":[{"kind":"text","text":"Props for the "},{"kind":"code","text":"`TextInput`"},{"kind":"text","text":" component."}]},"children":[{"name":"autoCapitalize","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Controls automatic capitalization of input."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"'sentences'"}]}]},"type":{"type":"union","types":[{"type":"literal","value":"none"},{"type":"literal","value":"words"},{"type":"literal","value":"sentences"},{"type":"literal","value":"characters"}]}},{"name":"autoComplete","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Autofill hint. iOS maps to "},{"kind":"code","text":"`textContentType`"},{"kind":"text","text":"; Android maps to Compose's\n"},{"kind":"code","text":"`Modifier.semantics { contentType = ... }`"},{"kind":"text","text":"."}]},"type":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/universal/TextInput/utils.ts","qualifiedName":"AutoComplete"},"name":"AutoComplete","package":"@expo/ui"}},{"name":"autoCorrect","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If false, disables autocorrect / spellcheck suggestions."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"true"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"autoFocus","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, focuses the input on mount."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"caretHidden","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, the cursor is hidden.\n\nOn iOS, this is implemented via "},{"kind":"code","text":"`tint('transparent')`"},{"kind":"text","text":", which also makes\nthe selection highlight invisible. If you set both "},{"kind":"code","text":"`caretHidden`"},{"kind":"text","text":" and\n"},{"kind":"code","text":"`selectionColor`"},{"kind":"text","text":", the caret-hide wins on iOS."}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"cursorColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the text cursor."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"defaultValue","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Initial text shown when the input mounts and "},{"kind":"code","text":"`value`"},{"kind":"text","text":" is not provided.\nIgnored once the user starts typing or if "},{"kind":"code","text":"`value`"},{"kind":"text","text":" is set."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"editable","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If false, the input cannot be edited. Selection is still allowed so the\nuser can copy text out of the field."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"true"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"enterKeyHint","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"HTML-style hint for the keyboard return key. Maps to "},{"kind":"code","text":"`returnKeyType`"},{"kind":"text","text":".\nWhen both are set, "},{"kind":"code","text":"`returnKeyType`"},{"kind":"text","text":" wins."}]},"type":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/universal/TextInput/utils.ts","qualifiedName":"EnterKeyHint"},"name":"EnterKeyHint","package":"@expo/ui"}},{"name":"inputMode","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"HTML-style hint for the keyboard variant. Maps to "},{"kind":"code","text":"`keyboardType`"},{"kind":"text","text":". When\nboth are set, "},{"kind":"code","text":"`keyboardType`"},{"kind":"text","text":" wins."}]},"type":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/universal/TextInput/utils.ts","qualifiedName":"InputMode"},"name":"InputMode","package":"@expo/ui"}},{"name":"keyboardType","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Determines which keyboard variant is shown.\n\nLacking native support:\n- iOS: "},{"kind":"code","text":"`'visible-password'`"},{"kind":"text","text":" falls back to the default keyboard.\n- Android: iOS-specific values ("},{"kind":"code","text":"`'ascii-capable'`"},{"kind":"text","text":",\n  "},{"kind":"code","text":"`'numbers-and-punctuation'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'name-phone-pad'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'twitter'`"},{"kind":"text","text":",\n  "},{"kind":"code","text":"`'web-search'`"},{"kind":"text","text":") fall back to the text keyboard."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"'default'"}]}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/Components/TextInput/TextInput.d.ts","qualifiedName":"KeyboardTypeOptions"},"name":"KeyboardTypeOptions","package":"react-native"}},{"name":"maxLength","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Maximum number of characters allowed."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"modifiers","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Platform-specific modifier escape hatch. Pass an array of modifier configs\nfrom "},{"kind":"code","text":"`@expo/ui/swift-ui/modifiers`"},{"kind":"text","text":" or "},{"kind":"code","text":"`@expo/ui/jetpack-compose/modifiers`"},{"kind":"text","text":".\nModifiers from the wrong platform are ignored at runtime."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"android"}]},{"tag":"@platform","content":[{"kind":"text","text":"ios"}]}]},"type":{"type":"array","elementType":{"type":"reference","target":{"packageName":"@expo/ui","packagePath":"src/types.ts","qualifiedName":"ModifierConfig"},"name":"ModifierConfig","package":"@expo/ui"}}},{"name":"multiline","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, the field accepts multiple lines of input and grows vertically\nas the user types."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"numberOfLines","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Number of lines the field reserves when "},{"kind":"code","text":"`multiline`"},{"kind":"text","text":" is true. Forces a\nfixed visible height of that many lines.\n\nLacking native support:\n- iOS: requires iOS 16+; below that, the field grows naturally."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"onBlur","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the field loses focus."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onChangeText","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called every time the text value changes. Receives the new string."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"text","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"string"}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onContentSizeChange","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the rendered size of the input changes. Sizes in points/dp.\n\nUnlike RN's "},{"kind":"code","text":"`onContentSizeChange`"},{"kind":"text","text":", this dispatches the *view*'s outer\ngeometry, including any padding/border applied via "},{"kind":"code","text":"`style`"},{"kind":"text","text":" or modifiers.\nIf you use this for autogrow, account for that."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"size","variant":"param","kind":32768,"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"height","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}},{"name":"width","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}}]}}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onFocus","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the field gains focus."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onSelectionChange","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the text selection range changes."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"selection","variant":"param","kind":32768,"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"end","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}},{"name":"start","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}}]}}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"onSubmitEditing","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Called when the user taps the keyboard return key. Receives the current\ntext in the input."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"text","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"string"}}],"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"placeholder","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Placeholder text shown when the field is empty."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"placeholderTextColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the placeholder text."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"readOnly","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Alias for "},{"kind":"code","text":"`editable={false}`"},{"kind":"text","text":". When both are set, "},{"kind":"code","text":"`editable`"},{"kind":"text","text":" wins."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"ref","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Ref exposing imperative methods ("},{"kind":"code","text":"`focus`"},{"kind":"text","text":", "},{"kind":"code","text":"`blur`"},{"kind":"text","text":", "},{"kind":"code","text":"`clear`"},{"kind":"text","text":")."}]},"type":{"type":"reference","target":{"packageName":"@types/react","packagePath":"index.d.ts","qualifiedName":"React.Ref"},"typeArguments":[{"type":"reference","name":"TextInputRef","package":"@expo/ui"}],"name":"Ref","package":"@types/react","qualifiedName":"React.Ref"}},{"name":"returnKeyType","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Determines the label of the keyboard return key.\n\nLacking native support:\n- iOS: "},{"kind":"code","text":"`'emergency-call'`"},{"kind":"text","text":" falls back to the default Return key.\n- Android: "},{"kind":"code","text":"`'join'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'route'`"},{"kind":"text","text":", "},{"kind":"code","text":"`'emergency-call'`"},{"kind":"text","text":" fall back to the\n  default action."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/Components/TextInput/TextInput.d.ts","qualifiedName":"ReturnKeyTypeOptions"},"name":"ReturnKeyTypeOptions","package":"react-native"}},{"name":"rows","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"HTML-style alias for "},{"kind":"code","text":"`numberOfLines`"},{"kind":"text","text":". When both are set, "},{"kind":"code","text":"`numberOfLines`"},{"kind":"text","text":" wins."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"secureTextEntry","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, the input obscures its text — used for password fields.\n- iOS: backed by SwiftUI's "},{"kind":"code","text":"`SecureField`"},{"kind":"text","text":". The following props are no-ops\n  in this mode: "},{"kind":"code","text":"`selection`"},{"kind":"text","text":", "},{"kind":"code","text":"`selectTextOnFocus`"},{"kind":"text","text":", "},{"kind":"code","text":"`onSelectionChange`"},{"kind":"text","text":",\n  "},{"kind":"code","text":"`multiline`"},{"kind":"text","text":", "},{"kind":"code","text":"`numberOfLines`"},{"kind":"text","text":".\n- Android: backed by Compose's "},{"kind":"code","text":"`PasswordVisualTransformation`"},{"kind":"text","text":"."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"selection","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Observable state the field writes the current selection to.\nCreate with "},{"kind":"code","text":"`useNativeState({ start: 0, end: 0 })`"},{"kind":"text","text":".\nUse "},{"kind":"code","text":"`ref.setSelection(start, end)`"},{"kind":"text","text":" to set selection programmatically."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"ios 18.0+ — pre-iOS 18 the prop is ignored."}]}]},"type":{"type":"reference","typeArguments":[{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"end","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}},{"name":"start","variant":"declaration","kind":1024,"type":{"type":"intrinsic","name":"number"}}]}}],"name":"ObservableState","package":"@expo/ui"}},{"name":"selectionColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the selected text highlight. On iOS this also tints the cursor\n(UIKit's "},{"kind":"code","text":"`tintColor`"},{"kind":"text","text":" covers both); pass "},{"kind":"code","text":"`cursorColor`"},{"kind":"text","text":" only if you want\ndifferent cursor color on Android."}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"selectionHandleColor","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the selection drag handles."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"android"}]}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"selectTextOnFocus","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"If true, all text is selected when the field gains focus. Implemented\nvia "},{"kind":"code","text":"`setSelection(0, length)`"},{"kind":"text","text":" on focus, so if you also pass "},{"kind":"code","text":"`selection`"},{"kind":"text","text":",\nits value is overwritten on every focus."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"false"}]},{"tag":"@platform","content":[{"kind":"text","text":"ios 18.0+, android, web"}]}]},"type":{"type":"intrinsic","name":"boolean"}},{"name":"style","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Box-level style — sizing, padding, background, border, opacity."}]},"type":{"type":"reference","target":{"packageName":"typescript","packagePath":"lib/lib.es5.d.ts","qualifiedName":"Pick"},"typeArguments":[{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheetTypes.d.ts","qualifiedName":"ViewStyle"},"name":"ViewStyle","package":"react-native"},{"type":"union","types":[{"type":"literal","value":"padding"},{"type":"literal","value":"paddingHorizontal"},{"type":"literal","value":"paddingVertical"},{"type":"literal","value":"paddingTop"},{"type":"literal","value":"paddingBottom"},{"type":"literal","value":"paddingLeft"},{"type":"literal","value":"paddingRight"},{"type":"literal","value":"backgroundColor"},{"type":"literal","value":"borderRadius"},{"type":"literal","value":"borderWidth"},{"type":"literal","value":"borderColor"},{"type":"literal","value":"opacity"},{"type":"literal","value":"width"},{"type":"literal","value":"height"}]}],"name":"Pick","package":"typescript"}},{"name":"testID","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Identifier used to locate the component in end-to-end tests."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"textAlign","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Horizontal alignment of the text content.\n\nLacking native support:\n- iOS: "},{"kind":"code","text":"`'justify'`"},{"kind":"text","text":" is not supported by SwiftUI's "},{"kind":"code","text":"`TextField`"},{"kind":"text","text":" and falls\n  back to the default alignment."}],"blockTags":[{"tag":"@default","content":[{"kind":"text","text":"'auto'"}]}]},"type":{"type":"union","types":[{"type":"literal","value":"auto"},{"type":"literal","value":"center"},{"type":"literal","value":"left"},{"type":"literal","value":"right"},{"type":"literal","value":"justify"}]}},{"name":"textStyle","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Text-level style — font, color, alignment, spacing."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"children":[{"name":"color","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Text color. Accepts any CSS color string."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"fontFamily","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Font family name."}]},"type":{"type":"intrinsic","name":"string"}},{"name":"fontSize","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Font size in points."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"fontWeight","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Weight of the font."}]},"type":{"type":"union","types":[{"type":"literal","value":"normal"},{"type":"literal","value":"bold"},{"type":"literal","value":"100"},{"type":"literal","value":"200"},{"type":"literal","value":"300"},{"type":"literal","value":"400"},{"type":"literal","value":"500"},{"type":"literal","value":"600"},{"type":"literal","value":"700"},{"type":"literal","value":"800"},{"type":"literal","value":"900"}]}},{"name":"letterSpacing","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Spacing between characters in points."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"lineHeight","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Line height in points.\n\nOn iOS this is approximated as "},{"kind":"code","text":"`lineSpacing(lineHeight - fontSize)`"},{"kind":"text","text":" because\nSwiftUI only exposes a true "},{"kind":"code","text":"`lineHeight(_:)`"},{"kind":"text","text":" modifier on iOS 26+. For exact\nspacing on iOS 26+ compose the "},{"kind":"code","text":"`lineHeight`"},{"kind":"text","text":" modifier from\n"},{"kind":"code","text":"`@expo/ui/swift-ui/modifiers`"},{"kind":"text","text":" via the "},{"kind":"code","text":"`modifiers`"},{"kind":"text","text":" prop."}]},"type":{"type":"intrinsic","name":"number"}},{"name":"textAlign","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Horizontal alignment of the text."}]},"type":{"type":"union","types":[{"type":"literal","value":"center"},{"type":"literal","value":"left"},{"type":"literal","value":"right"}]}}]}}},{"name":"underlineColorAndroid","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"Color of the underline indicator on Android. iOS / web ignore this."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"android"}]}]},"type":{"type":"reference","target":{"packageName":"react-native","packagePath":"Libraries/StyleSheet/StyleSheet.d.ts","qualifiedName":"ColorValue"},"name":"ColorValue","package":"react-native"}},{"name":"value","variant":"declaration","kind":1024,"flags":{"isOptional":true},"comment":{"summary":[{"kind":"text","text":"An observable state holding the current text. Create one with\n"},{"kind":"code","text":"`useNativeState('initial value')`"},{"kind":"text","text":" from "},{"kind":"code","text":"`@expo/ui`"},{"kind":"text","text":".\nOmit to let the field manage its own internal state."}]},"type":{"type":"reference","typeArguments":[{"type":"intrinsic","name":"string"}],"name":"ObservableState","package":"@expo/ui"}}]},{"name":"ObservableState","variant":"declaration","kind":2097152,"children":[{"name":"value","variant":"declaration","kind":1024,"type":{"type":"reference","name":"T","package":"@expo/ui","refersToTypeParameter":true}}],"typeParameters":[{"name":"T","variant":"typeParam","kind":131072}]},{"name":"TextInputRef","variant":"declaration","kind":2097152,"comment":{"summary":[{"kind":"text","text":"Imperative methods exposed via the "},{"kind":"code","text":"`TextInput`"},{"kind":"text","text":" ref."}]},"children":[{"name":"blur","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Programmatically blur the input."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"clear","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Clear the current text."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"focus","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Programmatically focus the input."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"void"}}]}}},{"name":"isFocused","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Returns whether the input currently has focus."}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"type":{"type":"intrinsic","name":"boolean"}}]}}},{"name":"setSelection","variant":"declaration","kind":1024,"comment":{"summary":[{"kind":"text","text":"Programmatically set the selection range."}],"blockTags":[{"tag":"@platform","content":[{"kind":"text","text":"ios 18.0+"}]}]},"type":{"type":"reflection","declaration":{"name":"__type","variant":"declaration","kind":65536,"signatures":[{"name":"__type","variant":"signature","kind":4096,"parameters":[{"name":"start","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"number"}},{"name":"end","variant":"param","kind":32768,"type":{"type":"intrinsic","name":"number"}}],"type":{"type":"reference","target":{"packageName":"typescript","packagePath":"lib/lib.es5.d.ts","qualifiedName":"Promise"},"typeArguments":[{"type":"intrinsic","name":"void"}],"name":"Promise","package":"typescript"}}]}}}]},{"name":"TextInput","variant":"declaration","kind":64,"signatures":[{"name":"TextInput","variant":"signature","kind":4096,"parameters":[{"name":"__namedParameters","variant":"param","kind":32768,"type":{"type":"reference","name":"TextInputProps","package":"@expo/ui"}}],"type":{"type":"reference","target":{"packageName":"@types/react","packagePath":"jsx-runtime.d.ts","qualifiedName":"JSX.Element"},"name":"Element","package":"@types/react","qualifiedName":"JSX.Element"}}]}],"packageName":"@expo/ui"}
\ No newline at end of file
diff --git a/packages/expo-ui/build/universal/TextInput/index.d.ts b/packages/expo-ui/build/universal/TextInput/index.d.ts
index d3289ab58ec7b7..cc7bc1977969ce 100644
--- a/packages/expo-ui/build/universal/TextInput/index.d.ts
+++ b/packages/expo-ui/build/universal/TextInput/index.d.ts
@@ -1,4 +1,5 @@
 import type { TextInputProps } from './types';
 export declare function TextInput({ ref, value, onChangeText, placeholder, autoFocus, editable, multiline, keyboardType, autoCapitalize, autoCorrect, returnKeyType, onSubmitEditing, onFocus, onBlur, cursorColor, textAlign, readOnly, inputMode, enterKeyHint, defaultValue, numberOfLines, rows, testID, placeholderTextColor, style, textStyle, secureTextEntry, autoComplete, onContentSizeChange, maxLength, caretHidden, selectionColor, selection, onSelectionChange, selectTextOnFocus, }: TextInputProps): import("react/jsx-runtime").JSX.Element;
 export * from './types';
+export { type ObservableState } from '../State';
 //# sourceMappingURL=index.d.ts.map
\ No newline at end of file
diff --git a/packages/expo-ui/build/universal/TextInput/index.d.ts.map b/packages/expo-ui/build/universal/TextInput/index.d.ts.map
index 6e0cb629604e71..3c1532654d477d 100644
--- a/packages/expo-ui/build/universal/TextInput/index.d.ts.map
+++ b/packages/expo-ui/build/universal/TextInput/index.d.ts.map
@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/universal/TextInput/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,SAAS,CAAC,EACxB,GAAG,EACH,KAAK,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,OAAO,EACP,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,MAAM,EACN,oBAAoB,EACpB,KAAK,EACL,SAAS,EACT,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,EAAE,cAAc,2CAiFhB;AAED,cAAc,SAAS,CAAC"}
\ No newline at end of file
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/universal/TextInput/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,SAAS,CAAC,EACxB,GAAG,EACH,KAAK,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,OAAO,EACP,MAAM,EACN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,MAAM,EACN,oBAAoB,EACpB,KAAK,EACL,SAAS,EACT,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,EAAE,cAAc,2CAiFhB;AAED,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC"}
\ No newline at end of file
diff --git a/packages/expo-ui/build/universal/index.d.ts b/packages/expo-ui/build/universal/index.d.ts
index ab7fe29e78f157..32ae8185de8899 100644
--- a/packages/expo-ui/build/universal/index.d.ts
+++ b/packages/expo-ui/build/universal/index.d.ts
@@ -12,6 +12,6 @@ export * from './FieldGroup';
 export * from './Icon';
 export * from './Spacer';
 export * from './State';
-export * from './TextInput';
+export { TextInput, type TextInputProps, type TextInputRef } from './TextInput';
 export type { UniversalStyle, UniversalAlignment, UniversalBaseProps } from './types';
 //# sourceMappingURL=index.d.ts.map
\ No newline at end of file
diff --git a/packages/expo-ui/build/universal/index.d.ts.map b/packages/expo-ui/build/universal/index.d.ts.map
index dee83e6c505cd5..2a2d4817c07f70 100644
--- a/packages/expo-ui/build/universal/index.d.ts.map
+++ b/packages/expo-ui/build/universal/index.d.ts.map
@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/universal/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}
\ No newline at end of file
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/universal/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhF,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}
\ No newline at end of file
diff --git a/packages/expo-ui/src/universal/TextInput/index.tsx b/packages/expo-ui/src/universal/TextInput/index.tsx
index e80962baee4160..c49137320bf105 100644
--- a/packages/expo-ui/src/universal/TextInput/index.tsx
+++ b/packages/expo-ui/src/universal/TextInput/index.tsx
@@ -124,3 +124,4 @@ export function TextInput({
 }
 
 export * from './types';
+export { type ObservableState } from '../State';
diff --git a/packages/expo-ui/src/universal/index.ts b/packages/expo-ui/src/universal/index.ts
index 1a14fa95570c7c..0304320bfeb255 100644
--- a/packages/expo-ui/src/universal/index.ts
+++ b/packages/expo-ui/src/universal/index.ts
@@ -12,6 +12,6 @@ export * from './FieldGroup';
 export * from './Icon';
 export * from './Spacer';
 export * from './State';
-export * from './TextInput';
+export { TextInput, type TextInputProps, type TextInputRef } from './TextInput';
 
 export type { UniversalStyle, UniversalAlignment, UniversalBaseProps } from './types';
diff --git a/tools/src/commands/GenerateDocsAPIData.ts b/tools/src/commands/GenerateDocsAPIData.ts
index 2ecdf60eacc4c5..247aedcd336622 100644
--- a/tools/src/commands/GenerateDocsAPIData.ts
+++ b/tools/src/commands/GenerateDocsAPIData.ts
@@ -165,6 +165,7 @@ const uiPackagesMapping: Record<string, CommandAdditionalParams> = {
   'expo-ui/universal/fieldgroup': ['universal/FieldGroup/index.ts', 'expo-ui'],
   'expo-ui/universal/icon': ['universal/Icon/index.tsx', 'expo-ui'],
   'expo-ui/universal/spacer': ['universal/Spacer/index.tsx', 'expo-ui'],
+  'expo-ui/universal/textinput': ['universal/TextInput/index.tsx', 'expo-ui'],
 };
 
 const PACKAGES_MAPPING: Record<string, CommandAdditionalParams> = {

From acf4d771a748f1bb39f436f4444ee3ca45ac18a9 Mon Sep 17 00:00:00 2001
From: Vojtech Novak <vonovak@gmail.com>
Date: Tue, 12 May 2026 09:54:50 +0200
Subject: [PATCH 2/5] [expo] remove dependency on @expo/vector-icons (#45563)

# Why

the expo package has a dependency on @expo/vector-icons which we don't
want to have.

# How

remove the dep (but add it to the apps that depend on it, I'll migrate
those to the community packages in another PR)

<!--
How did you build this feature or fix this bug and why?
-->

# Test Plan

<!--
Please describe how you tested this change and how a reviewer could
reproduce your test, especially if this PR does not include automated
tests! If possible, please also provide terminal output and/or
screenshots demonstrating your test/reproduction.
-->

# Checklist

<!--
Please check the appropriate items below if they apply to your diff.
-->

- [x] I added a `changelog.md` entry and rebuilt the package sources
according to [this short
guide](https://github.com/expo/expo/blob/main/CONTRIBUTING.md#-before-submitting)
- [ ] This diff will work correctly for `npx expo prebuild` & EAS Build
(eg: updated a module plugin).
- [ ] Conforms with the [Documentation Writing Style
Guide](https://github.com/expo/expo/blob/main/guides/Expo%20Documentation%20Writing%20Style%20Guide.md)
---
 apps/common/package.json              | 1 +
 apps/notification-tester/package.json | 1 +
 packages/expo/CHANGELOG.md            | 2 ++
 packages/expo/package.json            | 1 -
 pnpm-lock.yaml                        | 9 ++++++---
 5 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/apps/common/package.json b/apps/common/package.json
index 9cb00b0293de02..815273bf5c8e36 100644
--- a/apps/common/package.json
+++ b/apps/common/package.json
@@ -4,6 +4,7 @@
   "private": true,
   "dependencies": {
     "@expo/styleguide-base": "^1.0.1",
+    "@expo/vector-icons": "^15.0.2",
     "react-native": "0.85.3",
     "react": "19.2.3"
   },
diff --git a/apps/notification-tester/package.json b/apps/notification-tester/package.json
index 096524a4060f25..81044000d4ab4b 100644
--- a/apps/notification-tester/package.json
+++ b/apps/notification-tester/package.json
@@ -22,6 +22,7 @@
     "@react-navigation/bottom-tabs": "^7.15.5",
     "@react-navigation/native": "^7.1.33",
     "@expo/ui": "workspace:*",
+    "@expo/vector-icons": "^15.0.2",
     "expo": "workspace:*",
     "expo-font": "workspace:*",
     "expo-linking": "workspace:*",
diff --git a/packages/expo/CHANGELOG.md b/packages/expo/CHANGELOG.md
index 54c6726a41ffdf..53f50b1b7e9b3f 100644
--- a/packages/expo/CHANGELOG.md
+++ b/packages/expo/CHANGELOG.md
@@ -4,6 +4,8 @@
 
 ### 🛠 Breaking changes
 
+- Removed `@expo/vector-icons` from the `expo` package's dependencies. Apps that list `@expo/vector-icons` in their own `package.json` are unaffected; this is flagged as breaking only for apps that relied on `expo` transitively pulling it in. ([#45563](https://github.com/expo/expo/pull/45563) by [@vonovak](https://github.com/vonovak))
+
 ### 🎉 New features
 
 ### 🐛 Bug fixes
diff --git a/packages/expo/package.json b/packages/expo/package.json
index aa3b1c64e4ba0f..984b1f220370f4 100644
--- a/packages/expo/package.json
+++ b/packages/expo/package.json
@@ -85,7 +85,6 @@
     "@expo/log-box": "workspace:^56.0.7",
     "@expo/metro": "~56.0.0",
     "@expo/metro-config": "workspace:~56.0.6",
-    "@expo/vector-icons": "^15.0.2",
     "@ungap/structured-clone": "^1.3.0",
     "babel-preset-expo": "workspace:~56.0.6",
     "expo-asset": "workspace:~56.0.7",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 489dcdd49c3eba..06deb12343e6bc 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -415,6 +415,9 @@ importers:
       '@expo/styleguide-base':
         specifier: ^1.0.1
         version: 1.0.1(react@19.2.3)
+      '@expo/vector-icons':
+        specifier: ^15.0.2
+        version: 15.1.1(expo-font@packages+expo-font)(react-native@0.85.3(@babel/core@7.29.0)(@react-native/jest-preset@0.85.3(@babel/core@7.29.0)(react@19.2.3))(@react-native/metro-config@0.85.3(@babel/core@7.29.0))(@types/react@19.2.14)(react@19.2.3))(react@19.2.3)
       react:
         specifier: 19.2.3
         version: 19.2.3
@@ -1243,6 +1246,9 @@ importers:
       '@expo/ui':
         specifier: workspace:*
         version: link:../../packages/expo-ui
+      '@expo/vector-icons':
+        specifier: ^15.0.2
+        version: 15.1.1(expo-font@packages+expo-font)(react-native@0.85.3(@babel/core@7.29.0)(@react-native/jest-preset@0.85.3(@babel/core@7.29.0)(react@19.2.3))(@react-native/metro-config@0.85.3(@babel/core@7.29.0))(@types/react@19.2.14)(react@19.2.3))(react@19.2.3)
       '@react-navigation/bottom-tabs':
         specifier: ^7.15.5
         version: 7.15.5(4cf81f97ae4861b2ec2ba3fb0b222013)
@@ -3466,9 +3472,6 @@ importers:
       '@expo/metro-config':
         specifier: workspace:~56.0.6
         version: link:../@expo/metro-config
-      '@expo/vector-icons':
-        specifier: ^15.0.2
-        version: 15.1.1(expo-font@packages+expo-font)(react-native@0.85.3(@babel/core@7.29.0)(@react-native/jest-preset@0.85.3(@babel/core@7.29.0)(react@19.2.3))(@react-native/metro-config@0.85.3(@babel/core@7.29.0))(@types/react@19.2.14)(react@19.2.3))(react@19.2.3)
       '@ungap/structured-clone':
         specifier: ^1.3.0
         version: 1.3.0

From a37aa2a10fdabede648555b4efd1cee65bee71ce Mon Sep 17 00:00:00 2001
From: Jakub Tkacz <32908614+Ubax@users.noreply.github.com>
Date: Tue, 12 May 2026 09:57:20 +0200
Subject: [PATCH 3/5] [docs] Add react-navigation migration callout to router
 reference page (#45627)

# Why

<!--
Please describe the motivation for this PR, and link to relevant GitHub
issues, forums posts, or feature requests.
-->

# How

<!--
How did you build this feature or fix this bug and why?
-->

# Test Plan

<!--
Please describe how you tested this change and how a reviewer could
reproduce your test, especially if this PR does not include automated
tests! If possible, please also provide terminal output and/or
screenshots demonstrating your test/reproduction.
-->

# Checklist

<!--
Please check the appropriate items below if they apply to your diff.
-->

- [ ] I added a `changelog.md` entry and rebuilt the package sources
according to [this short
guide](https://github.com/expo/expo/blob/main/CONTRIBUTING.md#-before-submitting)
- [ ] This diff will work correctly for `npx expo prebuild` & EAS Build
(eg: updated a module plugin).
- [ ] Conforms with the [Documentation Writing Style
Guide](https://github.com/expo/expo/blob/main/guides/Expo%20Documentation%20Writing%20Style%20Guide.md)
---
 docs/pages/versions/unversioned/sdk/router/index.mdx | 2 ++
 docs/pages/versions/v56.0.0/sdk/router/index.mdx     | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/docs/pages/versions/unversioned/sdk/router/index.mdx b/docs/pages/versions/unversioned/sdk/router/index.mdx
index bf74aa4f135093..722a7d8a535d6e 100644
--- a/docs/pages/versions/unversioned/sdk/router/index.mdx
+++ b/docs/pages/versions/unversioned/sdk/router/index.mdx
@@ -23,6 +23,8 @@ import { ConfigPluginExample, ConfigPluginProperties } from '~/ui/components/Con
   Icon={BookOpen02Icon}
 />
 
+> **Important** In **SDK 56 and later**, Expo Router no longer supports importing from external `@react-navigation/*` packages in application code. Repoint those imports to the matching `expo-router` entry points. Run the [codemod](/router/migrate/sdk-55-to-56#automated-migration) or follow the [SDK 55 to 56 migration guide](/router/migrate/sdk-55-to-56) to update your project.
+
 ## Installation
 
 To use Expo Router in your project, you need to install. Follow the instructions from the Expo Router's installation guide:
diff --git a/docs/pages/versions/v56.0.0/sdk/router/index.mdx b/docs/pages/versions/v56.0.0/sdk/router/index.mdx
index 78d0805a9e1052..32a677830fc276 100644
--- a/docs/pages/versions/v56.0.0/sdk/router/index.mdx
+++ b/docs/pages/versions/v56.0.0/sdk/router/index.mdx
@@ -23,6 +23,8 @@ import { ConfigPluginExample, ConfigPluginProperties } from '~/ui/components/Con
   Icon={BookOpen02Icon}
 />
 
+> **Important** In **SDK 56 and later**, Expo Router no longer supports importing from external `@react-navigation/*` packages in application code. Repoint those imports to the matching `expo-router` entry points. Run the [codemod](/router/migrate/sdk-55-to-56#automated-migration) or follow the [SDK 55 to 56 migration guide](/router/migrate/sdk-55-to-56) to update your project.
+
 ## Installation
 
 To use Expo Router in your project, you need to install. Follow the instructions from the Expo Router's installation guide:

From aad7bf38889ef3f31c0a7f79b4cc470d3412c00f Mon Sep 17 00:00:00 2001
From: Elehiggle <Elehiggle@users.noreply.github.com>
Date: Tue, 12 May 2026 11:24:21 +0200
Subject: [PATCH 4/5] [sharing] Fix shareAsync promise leak on share
 cancellation (#45456)

# Why

`Sharing.shareAsync` on iOS leaks its promise when the user picks an
activity in the share sheet and then cancels the follow-up dialog.
Easiest reproduction: present a share sheet with a PDF, tap **Print**,
then tap **Cancel** in the print dialog. The promise never resolves, and
any caller-side state guarded by `await Sharing.shareAsync(...)` (busy
flags, ref-based sheet tracking) stays stuck and blocks subsequent
calls.

The current `completionWithItemsHandler` in
`packages/expo-sharing/ios/SharingModule.swift` only resolves two of
four `(activityType, completed)` permutations:

```swift
activityController.completionWithItemsHandler = { type, completed, _, _ in
  if type != nil && completed { promise.resolve(nil) }
  if type == nil && !completed { promise.resolve(nil) }
}
```

When the user picks an activity and cancels its follow-up dialog, iOS
calls the handler with `type != nil, completed == false`. Neither branch
matches.

`UIActivityViewController` invokes `completionWithItemsHandler` exactly
once on dismissal for every permutation, so all four cases are terminal
and should settle the promise. Apple docs:
https://developer.apple.com/documentation/uikit/uiactivityviewcontroller/completionwithitemshandler.

Related long-standing reports closed without a fix: #8218, #20567,
#21418, #35835.

# How

Resolve unconditionally inside the handler. `shareAsync` returns
`Promise<void>`, there is no result shape that depends on which branch
fires, and the handler runs at most once per controller lifecycle, so no
double-resolve risk.

```swift
activityController.completionWithItemsHandler = { _, _, _, _ in
  promise.resolve(nil)
}
```

# Test Plan

Verified on iOS with `expo-sharing@55.0.18` (same code as `main`),
patched locally via `pnpm patch` and rebuilt.

| Flow | Before | After |
| --- | --- | --- |
| Tap Print in share sheet, then Cancel in print dialog | Promise never
resolves, subsequent `shareAsync` calls hang | Resolves on dismissal |
| Tap Print, then Print in print dialog | Resolves | Resolves |
| Dismiss share sheet without picking an activity | Resolves | Resolves
|
| Tap an activity, then cancel its compose dialog (Mail, Messages, etc.)
| Same root cause as Print, expected to leak | Resolves on dismissal |

No JS API change. Behavior for callers that already resolved
successfully is unchanged.

# Checklist

- [x] I added a `changelog.md` entry and rebuilt the package sources
according to [this short
guide](https://github.com/expo/expo/blob/main/CONTRIBUTING.md#-before-submitting)
- [x] This diff will work correctly for `npx expo prebuild` & EAS Build
(eg: updated a module plugin).
- [x] Conforms with the [Documentation Writing Style
Guide](https://github.com/expo/expo/blob/main/guides/Expo%20Documentation%20Writing%20Style%20Guide.md)
---
 packages/expo-sharing/CHANGELOG.md            |  2 ++
 packages/expo-sharing/ios/SharingModule.swift | 18 ++++++++----------
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/expo-sharing/CHANGELOG.md b/packages/expo-sharing/CHANGELOG.md
index 8ae7ad8f20b5da..65e9a3ff301283 100644
--- a/packages/expo-sharing/CHANGELOG.md
+++ b/packages/expo-sharing/CHANGELOG.md
@@ -8,6 +8,8 @@
 
 ### 🐛 Bug fixes
 
+- [iOS] Fix `shareAsync` promise leaking when the user picks an activity and then cancels its follow-up dialog (e.g. taps Print, then cancels the print dialog). The completion handler now resolves unconditionally on dismissal. ([@Elehiggle](https://github.com/Elehiggle))
+
 ### 💡 Others
 
 ## 56.0.6 — 2026-05-11
diff --git a/packages/expo-sharing/ios/SharingModule.swift b/packages/expo-sharing/ios/SharingModule.swift
index 71c61a1a9c14b4..3e1772c7799e63 100644
--- a/packages/expo-sharing/ios/SharingModule.swift
+++ b/packages/expo-sharing/ios/SharingModule.swift
@@ -21,16 +21,14 @@ public final class SharingModule: Module {
       let activityController = UIActivityViewController(activityItems: [url], applicationActivities: nil)
       activityController.title = options.dialogTitle
 
-      activityController.completionWithItemsHandler = { type, completed, _, _ in
-        // user shared an item
-        if type != nil && completed {
-          promise.resolve(nil)
-        }
-
-        // dismissed without action
-        if type == nil && !completed {
-          promise.resolve(nil)
-        }
+      activityController.completionWithItemsHandler = { _, _, _, _ in
+        // Resolve unconditionally. UIActivityViewController invokes this once
+        // on dismissal for every (activityType, completed) permutation. The
+        // previous implementation only resolved two of four cases, leaking
+        // the promise when the user picked an activity and then cancelled
+        // its follow-up dialog (e.g. tapped Print, then cancelled the print
+        // dialog: activityType != nil, completed == false).
+        promise.resolve(nil)
       }
 
       guard let currentViewcontroller = appContext?.utilities?.currentViewController() else {

From d62357382df8314077909895d63f9d251642292a Mon Sep 17 00:00:00 2001
From: Ash Wu <hsatac@gmail.com>
Date: Tue, 12 May 2026 17:44:32 +0800
Subject: [PATCH 5/5] [docs] rename smart retry to retry_failed_only (#45666)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

# Why

Rename the `smart_retry` Maestro test job config field to
`retry_failed_only` to match the rename in eas-cli and universe. The new
name is self-explanatory. Linear:
[ENG-21159](https://linear.app/expo/issue/ENG-21159/rename-smart-retry-to-retry-failed-only).

# How

Renamed `smart_retry` → `retry_failed_only` in:

- `docs/pages/eas/workflows/syntax.mdx`
- `docs/pages/eas/workflows/pre-packaged-jobs.mdx` (YAML example +
parameter table)

Docs-only; no behavior change.

# Test Plan

Visual confirmation that the Maestro section in `pre-packaged-jobs.mdx`
and `syntax.mdx` renders with the new field name. Companion PRs land the
matching rename in code:

- expo/eas-cli#3709 (BuildStepInput id)
- expo/universe#27434 (Zod schema + step param)

# Checklist

- [x] Conforms with the [Documentation Writing Style
Guide](https://github.com/expo/expo/blob/main/guides/Expo%20Documentation%20Writing%20Style%20Guide.md)
- [ ] N/A: \`changelog.md\` (docs-only change, no package sources
touched)
- [ ] N/A: \`npx expo prebuild\` & EAS Build (no module plugin)

Signed-off-by: Ash Wu <hsatac@gmail.com>
---
 docs/pages/eas/workflows/pre-packaged-jobs.mdx | 4 ++--
 docs/pages/eas/workflows/syntax.mdx            | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/pages/eas/workflows/pre-packaged-jobs.mdx b/docs/pages/eas/workflows/pre-packaged-jobs.mdx
index 0ba9a811b003dc..0f46b3af22dce8 100644
--- a/docs/pages/eas/workflows/pre-packaged-jobs.mdx
+++ b/docs/pages/eas/workflows/pre-packaged-jobs.mdx
@@ -856,7 +856,7 @@ jobs:
       flow_path: string | string[] # required
       shards: number # optional - defaults to 1
       retries: number # optional - defaults to 0
-      smart_retry: boolean # optional - defaults to true
+      retry_failed_only: boolean # optional - defaults to true
       record_screen: boolean # optional - defaults to false
       include_tags: string | string[] # optional
       exclude_tags: string | string[] # optional
@@ -876,7 +876,7 @@ You can pass the following parameters into the `params` list:
 | flow_path                    | string or string[]                                    | Required. The path to the Maestro flow file(s) or directory to run.                                                                                                                                                                                                                                                                                                                                                                   |
 | shards                       | number                                                | Optional and experimental. The number of shards to split the tests into. Defaults to 1.                                                                                                                                                                                                                                                                                                                                               |
 | retries                      | number                                                | Optional. The number of times to retry the tests if they fail. Defaults to 0.                                                                                                                                                                                                                                                                                                                                                         |
-| smart_retry                  | boolean                                               | Optional. When true (default), retries will attempt to re-run only the flows that failed on the previous attempt when applicable. Set to false to re-run all flows on every retry.                                                                                                                                                                                                                                                    |
+| retry_failed_only            | boolean                                               | Optional. When true (default), retries will attempt to re-run only the flows that failed on the previous attempt when applicable. Set to false to re-run all flows on every retry.                                                                                                                                                                                                                                                    |
 | record_screen                | boolean                                               | Optional. Whether to record the screen. Defaults to false. Note: recording screen may impact emulator performance. You may want to use large runners when recording screen.                                                                                                                                                                                                                                                           |
 | include_tags                 | string or string[]                                    | Optional. Flow tags to include in the tests. Will be passed to Maestro as `--include-tags`.                                                                                                                                                                                                                                                                                                                                           |
 | exclude_tags                 | string or string[]                                    | Optional. Flow tags to exclude from the tests. Will be passed to Maestro as `--exclude-tags`.                                                                                                                                                                                                                                                                                                                                         |
diff --git a/docs/pages/eas/workflows/syntax.mdx b/docs/pages/eas/workflows/syntax.mdx
index 88a330a7f16a40..73a3b29b4f8cfb 100644
--- a/docs/pages/eas/workflows/syntax.mdx
+++ b/docs/pages/eas/workflows/syntax.mdx
@@ -1240,7 +1240,7 @@ jobs:
       flow_path: string | string[] # required
       shards: number # optional, defaults to 1
       retries: number # optional, defaults to 0
-      smart_retry: boolean # optional, defaults to true. When true, retries will attempt to re-run only the flows that failed on the previous attempt when applicable.
+      retry_failed_only: boolean # optional, defaults to true. When true, retries will attempt to re-run only the flows that failed on the previous attempt when applicable.
       record_screen: boolean # optional, defaults to false. If true, uploads a screen recording of the tests.
       include_tags: string | string[] # optional. Tags to include in the tests. Will be passed to Maestro as `--include-tags`.
       exclude_tags: string | string[] # optional. Tags to exclude from the tests. Will be passed to Maestro as `--exclude-tags`.