@expo/ui 56.0.0 → 56.0.2

package/ios/TextFieldView.swift

@@ -204,21 +204,6 @@ private struct StatefulSelectableTextField: View {
         isFocused = true
       }
     }
-    .onChange(of: state.value as? String) { newValue in
-      if let max = props.maxLength, let str = newValue, str.count > max {
-        state.value = String(str.prefix(max))
-        return
-      }
-      props.onTextChange(["value": newValue])
-      props.onTextChangeSync?.invoke(arguments: [newValue])
-    }
-    .onChange(of: textManager.isFocused) { newValue in
-      isFocused = newValue
-    }
-    .onChange(of: isFocused) { newValue in
-      textManager.isFocused = newValue
-      props.onFocusChange(["value": newValue])
-    }
     .onChange(of: localSelection) { newSel in
       let text = (state.value as? String) ?? ""
       var start = text.count
@@ -235,6 +220,21 @@ private struct StatefulSelectableTextField: View {
       selection.value = ["start": start, "end": end]
       props.onSelectionChange(["start": start, "end": end])
     }
+    .onChange(of: state.value as? String) { newValue in
+      if let max = props.maxLength, let str = newValue, str.count > max {
+        state.value = String(str.prefix(max))
+        return
+      }
+      props.onTextChange(["value": newValue])
+      props.onTextChangeSync?.invoke(arguments: [newValue])
+    }
+    .onChange(of: textManager.isFocused) { newValue in
+      isFocused = newValue
+    }
+    .onChange(of: isFocused) { newValue in
+      textManager.isFocused = newValue
+      props.onFocusChange(["value": newValue])
+    }
     .onChange(of: selection.value as? NSDictionary) { _ in
       guard let start = extractInt(selection.value, "start"),
             let end = extractInt(selection.value, "end") else { return }

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2-sources.jar.md5

@@ -0,0 +1 @@
+25616b6077449f887cfccb76c53298bf

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2-sources.jar.sha1

@@ -0,0 +1 @@
+fcc61a62df8eb780a822914cee4b167b6e70519d

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2-sources.jar.sha256

@@ -0,0 +1 @@
+30e043f7f04143f7b44a22ed5db105d71be86f4aa49f21d082d3c9acd84ea32a

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2-sources.jar.sha512

@@ -0,0 +1 @@
+69bc561d70dc77219abb25903821b7f0f170b1a06c4cd40714ece8709b85404ad09bcd4fc9cbe67faf9a04e413a625e4880be8a5c78fd6426ed8f78f4b7ce4f6

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2.aar.md5

@@ -0,0 +1 @@
+c9daa8165fdcd9ceb61785e0c560a949

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2.aar.sha1

@@ -0,0 +1 @@
+a60331ab720130c5c2ab6c627a68c5c8f15aa917

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2.aar.sha256

@@ -0,0 +1 @@
+7c0946b01b4c9e3cc7c3790f36779a0d5ff3bb832562de233badb2168d613e45

package/local-maven-repo/expo/modules/ui/expo.modules.ui/56.0.2/expo.modules.ui-56.0.2.aar.sha512

@@ -0,0 +1 @@
+222495b3d9e3c00846f79962ed79cdd46c2a2a2df76077b8752576200bfd728c3cc885cc0e0762869c57b24391882b9ee65ffa3f02a2c2490faa44e983640dd4

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{56.0.0/expo.modules.ui-56.0.0.module → 56.0.2/expo.modules.ui-56.0.2.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "expo.modules.ui",
     "module": "expo.modules.ui",
-    "version": "56.0.0",
+    "version": "56.0.2",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,13 +24,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-56.0.0.aar",
-          "url": "expo.modules.ui-56.0.0.aar",
-          "size": 1696571,
-          "sha512": "bb6d6f249bf4cfc959b4d91eb99d8e8eef4492f49edd6b5d6129e00dbbba8730fffad57405fe82ed9aa5e9ab5ab35869c8dc2058ebb098b57bd78164d8f120c7",
-          "sha256": "03f3e6dc4e44853be482e14a42715dd60703ec309db644c8a4f2eaf32f48b175",
-          "sha1": "d0d995cd2756336baddf9f1a055a443fb794d766",
-          "md5": "8d84c1fc054ab28580873a3562c0043e"
+          "name": "expo.modules.ui-56.0.2.aar",
+          "url": "expo.modules.ui-56.0.2.aar",
+          "size": 1700493,
+          "sha512": "222495b3d9e3c00846f79962ed79cdd46c2a2a2df76077b8752576200bfd728c3cc885cc0e0762869c57b24391882b9ee65ffa3f02a2c2490faa44e983640dd4",
+          "sha256": "7c0946b01b4c9e3cc7c3790f36779a0d5ff3bb832562de233badb2168d613e45",
+          "sha1": "a60331ab720130c5c2ab6c627a68c5c8f15aa917",
+          "md5": "c9daa8165fdcd9ceb61785e0c560a949"
         }
       ]
     },
@@ -141,13 +141,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.ui-56.0.0.aar",
-          "url": "expo.modules.ui-56.0.0.aar",
-          "size": 1696571,
-          "sha512": "bb6d6f249bf4cfc959b4d91eb99d8e8eef4492f49edd6b5d6129e00dbbba8730fffad57405fe82ed9aa5e9ab5ab35869c8dc2058ebb098b57bd78164d8f120c7",
-          "sha256": "03f3e6dc4e44853be482e14a42715dd60703ec309db644c8a4f2eaf32f48b175",
-          "sha1": "d0d995cd2756336baddf9f1a055a443fb794d766",
-          "md5": "8d84c1fc054ab28580873a3562c0043e"
+          "name": "expo.modules.ui-56.0.2.aar",
+          "url": "expo.modules.ui-56.0.2.aar",
+          "size": 1700493,
+          "sha512": "222495b3d9e3c00846f79962ed79cdd46c2a2a2df76077b8752576200bfd728c3cc885cc0e0762869c57b24391882b9ee65ffa3f02a2c2490faa44e983640dd4",
+          "sha256": "7c0946b01b4c9e3cc7c3790f36779a0d5ff3bb832562de233badb2168d613e45",
+          "sha1": "a60331ab720130c5c2ab6c627a68c5c8f15aa917",
+          "md5": "c9daa8165fdcd9ceb61785e0c560a949"
         }
       ]
     },
@@ -161,13 +161,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-56.0.0-sources.jar",
-          "url": "expo.modules.ui-56.0.0-sources.jar",
-          "size": 81673,
-          "sha512": "35c1745e420dc897e6ff8ecc87b3e1099f25796b361769b57ea5eda8024f0e78aa6ed32a4372a4a68b3c4b7a0c7d193fd26fcce38b3bdf1931bdaaa0fb187ec7",
-          "sha256": "dd76cece816d055a95f0885ed0ca67518bbb553ea7f943c8df733d9cb85fe6ad",
-          "sha1": "0bd7314ee11fab753cd321e1fc2a5a79a5503783",
-          "md5": "19a4c78efc70fac17522ec1916675616"
+          "name": "expo.modules.ui-56.0.2-sources.jar",
+          "url": "expo.modules.ui-56.0.2-sources.jar",
+          "size": 81393,
+          "sha512": "69bc561d70dc77219abb25903821b7f0f170b1a06c4cd40714ece8709b85404ad09bcd4fc9cbe67faf9a04e413a625e4880be8a5c78fd6426ed8f78f4b7ce4f6",
+          "sha256": "30e043f7f04143f7b44a22ed5db105d71be86f4aa49f21d082d3c9acd84ea32a",
+          "sha1": "fcc61a62df8eb780a822914cee4b167b6e70519d",
+          "md5": "25616b6077449f887cfccb76c53298bf"
         }
       ]
     }

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

@@ -0,0 +1 @@
+fe21a3ebc77261ba42803b0badb6b4b0

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

@@ -0,0 +1 @@
+7462e9cebfaf3618633f57bc7ccb3b20a78b1535

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

@@ -0,0 +1 @@
+ee0321724e44b775e5f24bf1712946ac3d8e8d71fffb8f567cfd13a631a3fd49

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

@@ -0,0 +1 @@
+30a3a47f5c5c292e336d0eaf7363d8e4efabd422856c4012f90ae524197559a099c8bb06597ab67b976bd35f9dcd6db468520ab1c0460a6a057a1c117cb1ad8d

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{56.0.0/expo.modules.ui-56.0.0.pom → 56.0.2/expo.modules.ui-56.0.2.pom}

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

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

@@ -0,0 +1 @@
+c2c86437b146e2fb044d5ec4d1ecf5fe

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

@@ -0,0 +1 @@
+ae97b3c0a7e08063fe763d3aa22eb4a39d49e893

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

@@ -0,0 +1 @@
+94e0b9c22f4243dd3fae58fdff830551be50f8d9ee42e83c55c1dcb3dd50f6bb

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

@@ -0,0 +1 @@
+e716bb9fb13a6f3a41154d67632da322143d58a8313021c86a7725304a9b6159fb13672249e717876b6750f16d205dde1fd8291903c19e23835a3c626532ecfa

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

@@ -3,11 +3,11 @@
   <groupId>expo.modules.ui</groupId>
   <artifactId>expo.modules.ui</artifactId>
   <versioning>
-    <latest>56.0.0</latest>
-    <release>56.0.0</release>
+    <latest>56.0.2</latest>
+    <release>56.0.2</release>
     <versions>
-      <version>56.0.0</version>
+      <version>56.0.2</version>
     </versions>
-    <lastUpdated>20260505215537</lastUpdated>
+    <lastUpdated>20260506162907</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-55bbe2f0b04c7b515ef2b6458600bae7
+62565e0bc43f40239455f1984b6f2783

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

@@ -1 +1 @@
-927a400c8a6b999d54683344d8f3ba879862f914
+ede29291f881a1a89bcda42bec68cca142494629

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

@@ -1 +1 @@
-6bce79dbe05a0ad31ac167ad639e10b90c4f72b32211fdaaaa5afd613c3ab410
+6b80d88f119d1131b0152eb0c2bc170614baac7a8b4b601c46f98e77b3e6e638

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

@@ -1 +1 @@
-b8af01feb5ccdaadabe3e0e2a5a8a8b6e5f4c3e524732b2a9b50e435dd25241b5393b80106a25f77b128ded820d8f20ba974ae440fd201036afeb91fa9f7b174
+13ed149e856276890b0fdc417974b41e8064a36cf93e2a59e2f8fdc2bb19f3d4df19eb6ea0d10f28194231b9774a27eb05ae835f6ad5a1dcba7c63c3755e11ef

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/ui",
-  "version": "56.0.0",
+  "version": "56.0.2",
   "description": "A collection of UI components",
   "sideEffects": [
     "*.fx.js"
@@ -48,14 +48,6 @@
       "default": "./plugin/babel-plugin.js"
     }
   },
-  "scripts": {
-    "build": "expo-module build",
-    "clean": "expo-module clean",
-    "lint": "expo-module lint",
-    "test": "expo-module test",
-    "prepublishOnly": "expo-module prepublishOnly",
-    "expo-module": "expo-module"
-  },
   "homepage": "https://docs.expo.dev/versions/latest/sdk/ui/",
   "repository": {
     "type": "git",
@@ -85,16 +77,17 @@
     "@types/babel__core": "^7.20.5",
     "@types/node": "^22.14.0",
     "@types/react": "~19.2.0",
-    "expo-module-scripts": "56.0.0",
     "react-native-reanimated": "4.3.0",
-    "react-native-worklets": "0.8.3"
+    "react-native-worklets": "0.8.3",
+    "expo": "56.0.0-preview.3",
+    "expo-module-scripts": "56.0.1"
   },
   "jest": {
     "preset": "expo-module-scripts"
   },
   "peerDependencies": {
     "@babel/core": "*",
-    "expo": "workspace:*",
+    "expo": "*",
     "react": "*",
     "react-dom": "*",
     "react-native": "*",
@@ -115,5 +108,12 @@
       "optional": true
     }
   },
-  "gitHead": "6dcd9ce9d615d25df78597f60520492e35e02efb"
-}
+  "gitHead": "71ec800b2fa6133d22d69b70945132e22f1b7ae8",
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "expo-module": "expo-module"
+  }
+}

package/src/community/bottom-sheet/BottomSheet.android.tsx

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
-import { StyleSheet, View } from 'react-native';
+import { StyleSheet, useWindowDimensions, View } from 'react-native';
 
 import { BottomSheetContext, BottomSheetInternalContext } from './context';
 import type { BottomSheetMethods, BottomSheetProps } from './types';
@@ -65,6 +65,7 @@ export function BottomSheet(props: BottomSheetProps) {
     backgroundStyle,
     children,
   } = props;
+  const { width } = useWindowDimensions();
 
   const hasMultipleSnapPoints = snapPointsProp != null && snapPointsProp.length > 1;
   const fitToContents = enableDynamicSizing && (!snapPointsProp || snapPointsProp.length === 0);
@@ -196,7 +197,7 @@ export function BottomSheet(props: BottomSheetProps) {
   return (
     <BottomSheetInternalContext.Provider value={internalContextValue}>
       <BottomSheetContext.Provider value={methods}>
-        <Host matchContents>
+        <Host style={{ position: 'absolute', width }}>
           <ModalBottomSheet
             ref={sheetRef}
             onDismissRequest={handleDismiss}

package/src/community/bottom-sheet/BottomSheet.ios.tsx

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
-import { View } from 'react-native';
+import { useWindowDimensions, View } from 'react-native';
 
 import { BottomSheetContext, BottomSheetInternalContext } from './context';
 import type { BottomSheetMethods, BottomSheetProps } from './types';
@@ -82,6 +82,7 @@ export function BottomSheet(props: BottomSheetProps) {
     handleComponent,
     children,
   } = props;
+  const { width } = useWindowDimensions();
 
   // Two-state pattern for animated close:
   // - isMounted: whether the native sheet tree exists in the React tree
@@ -234,7 +235,7 @@ export function BottomSheet(props: BottomSheetProps) {
   return (
     <BottomSheetInternalContext.Provider value={internalContextValue}>
       <BottomSheetContext.Provider value={methods}>
-        <Host matchContents>
+        <Host style={{ position: 'absolute', width }}>
           <NativeBottomSheet
             isPresented={isPresented}
             onIsPresentedChange={handlePresentedChange}

package/src/jetpack-compose/DropdownMenu/DropdownMenuItem.tsx

@@ -22,12 +22,10 @@ export type DropdownMenuItemElementColors = {
   textColor?: ColorValue;
   /** Color of the text when the menu item is disabled. */
   disabledTextColor?: ColorValue;
-  // TODO: At the moment IconView's tint color defaults to Color.Unspecified instead of LocalContentColor.current.
-  // Thus the color override will not work for icons. At the moment icon color can only be set directly in IconView.
-  // leadingIconColor?: ColorValue;
-  // trailingIconColor?: ColorValue;
-  // disabledLeadingIconColor?: ColorValue;
-  // disabledTrailingIconColor?: ColorValue;
+  leadingIconColor?: ColorValue;
+  trailingIconColor?: ColorValue;
+  disabledLeadingIconColor?: ColorValue;
+  disabledTrailingIconColor?: ColorValue;
 };
 
 /**

package/src/jetpack-compose/HorizontalFloatingToolbar/index.tsx

@@ -10,20 +10,20 @@ export type HorizontalFloatingToolbarColors = {
    */
   toolbarContainerColor?: ColorValue;
 
-  // Color of the toolbar content (icons/text).
-  // TODO: At the moment IconView's tint color defaults to Color.Unspecified instead of LocalContentColor.current.
-  // Thus the color override will not work.
-  // toolbarContentColor?: ColorValue;
+  /**
+   *  Color of the toolbar content (icons/text).
+   */
+  toolbarContentColor?: ColorValue;
 
   /**
    * Color of the floating action button container (background).
    */
   fabContainerColor?: ColorValue;
 
-  // Color of the floating action button content (icon).
-  // TODO: At the moment IconView's tint color defaults to Color.Unspecified instead of LocalContentColor.current.
-  // Thus the color override will not work.
-  // fabContentColor?: ColorValue;
+  /**
+   *  Color of the floating action button content (icon).
+   */
+  fabContentColor?: ColorValue;
 };
 
 export type HorizontalFloatingToolbarProps = {

package/src/jetpack-compose/HorizontalPager/index.tsx

@@ -2,9 +2,11 @@ import { requireNativeView } from 'expo';
 import type { Ref } from 'react';
 
 import { type ModifierConfig, type ViewEvent } from '../../types';
-import type { PaddingValuesRecord } from '../Carousel';
+import { type PaddingValuesRecord } from '../Carousel';
 import { createViewModifierEventListener } from '../modifiers/utils';
 
+export type { PaddingValuesRecord };
+
 export type HorizontalPagerHandle = {
   /**
    * Mirrors Compose's `PagerState.animateScrollToPage`. Resolves when the

package/src/jetpack-compose/Icon/index.tsx

@@ -23,16 +23,22 @@ export type IconProps = {
   source: ImageSourcePropType;
 
   /**
-   * The tint color to apply to the icon.
-   * Accepts hex strings, named colors, or RGB arrays.
+   * The tint color to apply to the icon. Accepts hex strings, named colors,
+   * or RGB arrays.
+   *
+   * - When omitted, the icon inherits the color from the surrounding
+   *   `LocalContentColor` (e.g. the toolbar/FAB content color).
+   * - When set to `null`, no tint is applied — the icon is drawn with its
+   *   original colors (`Color.Unspecified`). Use this for multicolored icons.
    *
    * @example
    * ```tsx
    * <Icon source={require('./assets/star.xml')} tint="#007AFF" />
    * <Icon source={require('./assets/star.xml')} tint="blue" />
+   * <Icon source={require('./assets/multicolor.xml')} tint={null} />
    * ```
    */
-  tint?: ColorValue;
+  tint?: ColorValue | null;
 
   /**
    * The size of the icon in density-independent pixels (dp).
@@ -80,8 +86,10 @@ export type IconProps = {
 /**
  * @hidden
  */
-export type NativeIconProps = Omit<IconProps, 'source'> & {
+export type NativeIconProps = Omit<IconProps, 'source' | 'tint'> & {
   source: ImageResolvedAssetSource;
+  tint?: ColorValue;
+  inheritTint: boolean;
 };
 
 const IconNativeView: React.ComponentType<NativeIconProps> = requireNativeView(
@@ -90,12 +98,17 @@ const IconNativeView: React.ComponentType<NativeIconProps> = requireNativeView(
 );
 
 function transformIconProps(props: IconProps): NativeIconProps {
-  const { source, modifiers, ...restProps } = props;
+  const { source, modifiers, tint, ...restProps } = props;
+  // Differentiate "tint not provided" (inherit `LocalContentColor`) from
+  // "tint explicitly null" (no tint, draw original colors).
+  const tintIsExplicitlyNull = 'tint' in props && tint === null;
 
   return {
     modifiers,
     ...(modifiers ? createViewModifierEventListener(modifiers) : undefined),
     ...restProps,
+    tint: tint ?? undefined,
+    inheritTint: !tintIsExplicitlyNull,
     source: Image.resolveAssetSource(source),
   };
 }

package/src/jetpack-compose/TextField/index.tsx

@@ -126,23 +126,15 @@ export type TextFieldColors = {
   errorSuffixColor?: ColorValue;
 };
 
-export type TextFieldValue = {
-  text: string;
-  selection: { start: number; end: number };
-};
-
-export type TextFieldValueLike = string | TextFieldValue;
-
 /** Shared props between `TextField` and `OutlinedTextField`. */
-type BaseTextFieldProps<T extends TextFieldValueLike = string> = {
+type BaseTextFieldProps = {
   ref?: Ref<TextFieldRef>;
   /**
-   * An observable state that holds the current value. Create one with either:
-   * - `useNativeState('initial text')`.
-   * - `useNativeState<TextFieldValue>({ text: '', selection: { start: 0, end: 0 } })`
-   * If omitted, the field manages its own internal state.
+   * An observable state that holds the current text value. Create one with
+   * `useNativeState('initial text')`. If omitted, the field manages its own
+   * internal state.
    */
-  value?: ObservableState<T>;
+  value?: ObservableState<string>;
   /** If true, the text field will be focused automatically when mounted. @default false */
   autoFocus?: boolean;
   /** @default true */
@@ -173,20 +165,18 @@ type BaseTextFieldProps<T extends TextFieldValueLike = string> = {
   };
 
   /**
-   * Observable state the field writes the current selection to.
-   * Create with `useNativeState({ start: 0, end: 0 })`.
-   * Use `ref.setSelection(start, end)` to set programmatically.
-   * @internal
+   * Observable state holding the current selection range. Create with
+   * `useNativeState({ start: 0, end: 0 })`. The field writes user-driven
+   * changes back to it, and writes from JS (or a worklet) update the
+   * cursor/selection in the field. Use `ref.setSelection(start, end)` for
+   * imperative one-shot updates.
    */
   selection?: ObservableState<{ start: number; end: number }>;
 
   /** Maximum number of characters allowed. Truncates natively as the user types. */
   maxLength?: number;
 
-  /**
-   * Called when the selection range changes.
-   * @internal
-   */
+  /** Called when the selection range changes. */
   onSelectionChange?: (selection: { start: number; end: number }) => void;
 
   /**
@@ -215,15 +205,12 @@ type BaseTextFieldProps<T extends TextFieldValueLike = string> = {
   keyboardOptions?: TextFieldKeyboardOptions;
   keyboardActions?: TextFieldKeyboardActions;
   /**
-   * Fires whenever the value changes. The callback receives the same shape as `value`:
-   * - `string` when `value` is a string observable (typing events only).
-   * - `TextFieldValue` when `value` is a TextFieldValue observable (every gesture:
-   *   typing, tap-to-place, drag, select-all, arrow keys).
-   *
-   * If marked with the `'worklet'` directive, runs synchronously on the UI thread;
-   * otherwise delivered asynchronously as a regular JS event.
+   * Fires whenever the text value changes. If marked with the `'worklet'`
+   * directive, runs synchronously on the UI thread; otherwise delivered
+   * asynchronously as a regular JS event. Use `onSelectionChange` (or read
+   * the `selection` observable) to react to selection-only changes.
    */
-  onValueChange?: (value: T) => void;
+  onValueChange?: (value: string) => void;
   /** A callback triggered when the field gains or loses focus. */
   onFocusChanged?: (focused: boolean) => void;
   shape?: object;
@@ -232,14 +219,13 @@ type BaseTextFieldProps<T extends TextFieldValueLike = string> = {
   children?: React.ReactNode;
 };
 
-export type TextFieldProps<T extends TextFieldValueLike = string> = BaseTextFieldProps<T> & {
+export type TextFieldProps = BaseTextFieldProps & {
   colors?: TextFieldColors;
 };
 
-export type OutlinedTextFieldProps<T extends TextFieldValueLike = string> =
-  BaseTextFieldProps<T> & {
-    colors?: TextFieldColors;
-  };
+export type OutlinedTextFieldProps = BaseTextFieldProps & {
+  colors?: TextFieldColors;
+};
 
 // endregion Types
 
@@ -263,7 +249,7 @@ type NativeTextFieldProps = Omit<
   value?: number | null;
   selection?: number | null;
   onValueChangeSync?: number | null;
-} & ViewEvent<'onValueChange', TextFieldValue> &
+} & ViewEvent<'onValueChange', { text: string; selection: { start: number; end: number } }> &
   ViewEvent<'onFocusChanged', { value: boolean }> &
   ViewEvent<'onSelectionChange', { start: number; end: number }> &
   ViewEvent<'onKeyboardAction', { action: string; value: string }>;
@@ -273,8 +259,8 @@ const TextFieldNativeView: React.ComponentType<NativeTextFieldProps> = requireNa
   'TextFieldView'
 );
 
-function useTransformedProps<T extends TextFieldValueLike>(
-  props: TextFieldProps<T> | OutlinedTextFieldProps<T>,
+function useTransformedProps(
+  props: TextFieldProps | OutlinedTextFieldProps,
   variant: 'filled' | 'outlined'
 ): NativeTextFieldProps {
   const {
@@ -289,8 +275,6 @@ function useTransformedProps<T extends TextFieldValueLike>(
     ...restProps
   } = props;
 
-  const isStringMode = !value || typeof value.value === 'string';
-
   const isWorklet = !!onValueChange && !!worklets?.isWorkletFunction?.(onValueChange);
   const workletCallback = useWorkletProp(isWorklet ? onValueChange : undefined, 'onValueChange');
 
@@ -300,16 +284,11 @@ function useTransformedProps<T extends TextFieldValueLike>(
     ...restProps,
     variant,
     children,
-    value: getStateId(value as ObservableState<TextFieldValueLike>),
+    value: getStateId(value),
     selection: getStateId(selection),
     onValueChangeSync: getStateId(workletCallback),
     onValueChange:
-      !isWorklet && onValueChange
-        ? (event) => {
-            const payload = event.nativeEvent;
-            onValueChange((isStringMode ? payload.text : payload) as T);
-          }
-        : undefined,
+      !isWorklet && onValueChange ? (event) => onValueChange(event.nativeEvent.text) : undefined,
     onFocusChanged: onFocusChanged ? (event) => onFocusChanged(event.nativeEvent.value) : undefined,
     onSelectionChange: onSelectionChange
       ? (event) => onSelectionChange({ start: event.nativeEvent.start, end: event.nativeEvent.end })
@@ -370,7 +349,7 @@ function SupportingText(props: { children: React.ReactNode }) {
 /**
  * A Material3 `TextField`.
  */
-function TextFieldComponent<T extends TextFieldValueLike = string>(props: TextFieldProps<T>) {
+function TextFieldComponent(props: TextFieldProps) {
   return <TextFieldNativeView {...useTransformedProps(props, 'filled')} />;
 }
 
@@ -385,9 +364,7 @@ TextFieldComponent.SupportingText = SupportingText;
 /**
  * A Material3 `OutlinedTextField` with a transparent background and border outline.
  */
-function OutlinedTextFieldComponent<T extends TextFieldValueLike = string>(
-  props: OutlinedTextFieldProps<T>
-) {
+function OutlinedTextFieldComponent(props: OutlinedTextFieldProps) {
   return <TextFieldNativeView {...useTransformedProps(props, 'outlined')} />;
 }
 
@@ -402,3 +379,6 @@ OutlinedTextFieldComponent.SupportingText = SupportingText;
 // endregion Components
 
 export { TextFieldComponent as TextField, OutlinedTextFieldComponent as OutlinedTextField };
+
+// Exported for docs api data
+export { type ObservableState };

package/src/jetpack-compose/index.ts

@@ -27,12 +27,27 @@ export * from './Slider';
 export * from './Spacer';
 export * from './Switch';
 export * from './SyncSwitch';
-export * from './TextField';
+export {
+  TextField,
+  OutlinedTextField,
+  type TextFieldProps,
+  type TextFieldRef,
+  type TextFieldCapitalization,
+  type TextFieldImeAction,
+  type TextFieldKeyboardOptions,
+  type TextFieldKeyboardType,
+  type TextFieldKeyboardActions,
+  type TextFieldColors,
+} from './TextField';
 export * from './ToggleButton';
 export * from './Shape';
 export * from './ModalBottomSheet';
 export * from './Carousel';
-export * from './HorizontalPager';
+export {
+  HorizontalPager,
+  type HorizontalPagerHandle,
+  type HorizontalPagerProps,
+} from './HorizontalPager';
 export * from './SearchBar';
 export * from './DockedSearchBar';
 export * from './HorizontalFloatingToolbar';