@expo/ui 57.0.21 → 57.0.22

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

@@ -0,0 +1 @@
+81d467c2d81c5fb4545160a5b5563fcf0f6eb3fbb191a507382ad6b0abde41d6c5506edc2281c1e98dee29eb2c861856f8e34d4208972a2dbf2b547c77143627

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

@@ -0,0 +1 @@
+7220f1074490e12c04ff057048d86124

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

@@ -0,0 +1 @@
+d581a4836a4dd119bfc57aca7152c5f7a45911b8

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

@@ -0,0 +1 @@
+a869c8586462b852b75439dbfeaa7caef538db6eeff7bac5aee0026215a61a06

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

@@ -0,0 +1 @@
+34080b16453bc36824a34471ee76e7da22af80c63cc419ea34d8c2e1e562f72f968ce8faefd5672f33a4c899c0cdf85c2e711318d859ba4d4562b7e0a61482d8

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{57.0.21/expo.modules.ui-57.0.21.module → 57.0.22/expo.modules.ui-57.0.22.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "expo.modules.ui",
     "module": "expo.modules.ui",
-    "version": "57.0.21",
+    "version": "57.0.22",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,13 +24,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-57.0.21.aar",
-          "url": "expo.modules.ui-57.0.21.aar",
-          "size": 2074203,
-          "sha512": "894745399f2255f02b84f664c1e62ab66d71daf4a24e3ce48ecfb7e60d0ba9abfbe31a5d9517953e2d365b786ba9da8ba8f476361777fd57006eb7fb7522c32c",
-          "sha256": "edfc30f6ff0935cee758638ea4443ec247e3628ba4a088f44f58becfca185b6e",
-          "sha1": "b8495e88a2dd3b3386885867acede44c5a99186f",
-          "md5": "8b8ece627534269af4e6dfa665f46f6c"
+          "name": "expo.modules.ui-57.0.22.aar",
+          "url": "expo.modules.ui-57.0.22.aar",
+          "size": 2080513,
+          "sha512": "34080b16453bc36824a34471ee76e7da22af80c63cc419ea34d8c2e1e562f72f968ce8faefd5672f33a4c899c0cdf85c2e711318d859ba4d4562b7e0a61482d8",
+          "sha256": "a869c8586462b852b75439dbfeaa7caef538db6eeff7bac5aee0026215a61a06",
+          "sha1": "d581a4836a4dd119bfc57aca7152c5f7a45911b8",
+          "md5": "7220f1074490e12c04ff057048d86124"
         }
       ]
     },
@@ -141,13 +141,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.ui-57.0.21.aar",
-          "url": "expo.modules.ui-57.0.21.aar",
-          "size": 2074203,
-          "sha512": "894745399f2255f02b84f664c1e62ab66d71daf4a24e3ce48ecfb7e60d0ba9abfbe31a5d9517953e2d365b786ba9da8ba8f476361777fd57006eb7fb7522c32c",
-          "sha256": "edfc30f6ff0935cee758638ea4443ec247e3628ba4a088f44f58becfca185b6e",
-          "sha1": "b8495e88a2dd3b3386885867acede44c5a99186f",
-          "md5": "8b8ece627534269af4e6dfa665f46f6c"
+          "name": "expo.modules.ui-57.0.22.aar",
+          "url": "expo.modules.ui-57.0.22.aar",
+          "size": 2080513,
+          "sha512": "34080b16453bc36824a34471ee76e7da22af80c63cc419ea34d8c2e1e562f72f968ce8faefd5672f33a4c899c0cdf85c2e711318d859ba4d4562b7e0a61482d8",
+          "sha256": "a869c8586462b852b75439dbfeaa7caef538db6eeff7bac5aee0026215a61a06",
+          "sha1": "d581a4836a4dd119bfc57aca7152c5f7a45911b8",
+          "md5": "7220f1074490e12c04ff057048d86124"
         }
       ]
     },
@@ -161,13 +161,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-57.0.21-sources.jar",
-          "url": "expo.modules.ui-57.0.21-sources.jar",
-          "size": 105285,
-          "sha512": "bd014a7ec6f4940b753de1ef54b686c8316d45a4242893e9a508948dd22fc893063a285538d30a3fa943deedbf32915697892ff4a739e17fcb2b194a79f71d8d",
-          "sha256": "352b556c7e482ce79471552b5d73a5f29d92e9a339fd3edecf327c7df9e6576b",
-          "sha1": "ca977e2408458c690c3555514485a6a8e7fade24",
-          "md5": "711eb23ebb503bc13f871f580afcbcf0"
+          "name": "expo.modules.ui-57.0.22-sources.jar",
+          "url": "expo.modules.ui-57.0.22-sources.jar",
+          "size": 105727,
+          "sha512": "81d467c2d81c5fb4545160a5b5563fcf0f6eb3fbb191a507382ad6b0abde41d6c5506edc2281c1e98dee29eb2c861856f8e34d4208972a2dbf2b547c77143627",
+          "sha256": "e1ff6f3760b8699263fd244601e146335a9f853109153f91be6c98d092a9302e",
+          "sha1": "b9f56fabf01aea58b15172683c4a748b8dc3cf55",
+          "md5": "67ccc30c75819937df5e850cb742a4ba"
         }
       ]
     }

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

@@ -0,0 +1 @@
+7fb20f1c978e1a0b3d762c0dd5323bf9

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

@@ -0,0 +1 @@
+14b81e92a813dd3ff42d0b57bc819fe6fe45dbe9

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

@@ -0,0 +1 @@
+4f7022f3602a1162d857c67860c42f26d80c57f0955e815776e0d69da62a6b89

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

@@ -0,0 +1 @@
+f4323dcdf2bd04112993e148d47b98df0245f0679aedb4965f45646c987da2d513b3a312aba6ca5802a411cc07b8260c3b3a944a30da7e4b9c2d2140e9cc0b78

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{57.0.21/expo.modules.ui-57.0.21.pom → 57.0.22/expo.modules.ui-57.0.22.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>expo.modules.ui</groupId>
   <artifactId>expo.modules.ui</artifactId>
-  <version>57.0.21</version>
+  <version>57.0.22</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/57.0.22/expo.modules.ui-57.0.22.pom.md5

@@ -0,0 +1 @@
+bf3cc748e5aba7f0faca9af9cae6ca11

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

@@ -0,0 +1 @@
+64719d73cd6c6e4410f220586d1b900553d8636f

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

@@ -0,0 +1 @@
+b1893b9a45c11ca23be9b083040c6c8e42e5dbf2f83388fb2ecb46ebb759ef43

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

@@ -0,0 +1 @@
+2e7e5260dc6cae8eb8555c1614f8e50394413bd3cc98d8c34ffb9831458a6079516da7c302bac741da5f578dac28c7772d1cf5efd111f007f15639876db47768

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>57.0.21</latest>
-    <release>57.0.21</release>
+    <latest>57.0.22</latest>
+    <release>57.0.22</release>
     <versions>
-      <version>57.0.21</version>
+      <version>57.0.22</version>
     </versions>
-    <lastUpdated>20260929104945</lastUpdated>
+    <lastUpdated>20261006120050</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-d9951eb0ffdbd1f3b4e8c66a9506881d
+ec005e8760fa18717c30f9efdbaf8407

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

@@ -1 +1 @@
-ee273f19364a6847e08cbe5eb1b5daadf787040f
+213f89fcaff64a6fdd6b446eda846a2de8851a2e

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

@@ -1 +1 @@
-950f75c93b0ef32cc69e20471f3a68ac9088427130a66ded938e0c3ded940478
+fd6986f721f0b9289418efa80805a6cf05ffcaccc5f74b409b7953f92f5a053e

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

@@ -1 +1 @@
-ecc49926b4fd4296bc3b844a0f9a313ef93474eeb921d900d082366cb28c80c466c6dc4c5fa1b3445072b1e1bedb4b8cdf62022039209423a27b5d5c9a381a3e
+9461340626636adffd749d7a45d2b9ee7741281f8c1507b97ca59fcf2c1a9cdb97cede810b8aa5dbe7f8d22d6076a512501797a90eb796b321ec3a39624f4241

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/ui",
-  "version": "57.0.21",
+  "version": "57.0.22",
   "description": "A collection of UI components",
   "sideEffects": [
     "*.fx.js",
@@ -96,8 +96,8 @@
     "@types/react": "~19.2.0",
     "react-native-reanimated": "4.5.1",
     "react-native-worklets": "0.10.1",
-    "expo-module-scripts": "56.0.3",
-    "expo": "57.0.26"
+    "expo": "57.0.27",
+    "expo-module-scripts": "56.0.3"
   },
   "jest": {
     "preset": "expo-module-scripts"
@@ -121,7 +121,7 @@
       "optional": true
     }
   },
-  "gitHead": "ad1efa3fa5802156660198ba5d787f91014d8df3",
+  "gitHead": "50ac74f1ab5682c8e32b24da6e5e97dd4dbbb80f",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",

package/src/community/datetime-picker/DateTimePicker.android.tsx

@@ -1,4 +1,5 @@
 import { buildEvent, buildChangeEvent, type DateTimePickerProps } from './types';
+import { localDateToUtcDayISOString, utcDayToLocalDate } from './utils';
 import {
   DateTimePicker as AndroidPicker,
   DatePickerDialog as AndroidDatePickerDialog,
@@ -52,6 +53,14 @@ export function DateTimePicker(props: DateTimePickerProps) {
     negativeButton,
   } = props;
 
+  // Material3 date pickers work in UTC days, while `value` and the reported date are local —
+  // matching `@react-native-community/datetimepicker`. Send `value`'s local calendar day as a UTC
+  // day and convert the picked UTC day back, keeping `value`'s time of day. The native side
+  // already converts `minimumDate`/`maximumDate` by their local calendar day. Time pickers read
+  // local hours from the instant, so they take `value` unchanged.
+  const usesDateComponents = mode !== 'time';
+  const initialDate = usesDateComponents ? localDateToUtcDayISOString(value) : value.toISOString();
+
   const onDismissed = () => {
     if (onDismissProp) {
       onDismissProp();
@@ -70,10 +79,11 @@ export function DateTimePicker(props: DateTimePickerProps) {
   };
 
   const onDateSelected = (date: Date) => {
+    const selected = usesDateComponents ? utcDayToLocalDate(date, value) : date;
     if (onValueChange) {
-      onValueChange(buildChangeEvent(date), date);
+      onValueChange(buildChangeEvent(selected), selected);
     } else {
-      onChange?.(buildEvent(date), date);
+      onChange?.(buildEvent(selected), selected);
     }
   };
 
@@ -81,7 +91,7 @@ export function DateTimePicker(props: DateTimePickerProps) {
     minimumDate || maximumDate ? { start: minimumDate, end: maximumDate } : undefined;
 
   const dialogProps = {
-    initialDate: value.toISOString(),
+    initialDate,
     color: accentColor,
     confirmButtonLabel: positiveButton?.label,
     dismissButtonLabel: negativeButton?.label,
@@ -111,7 +121,7 @@ export function DateTimePicker(props: DateTimePickerProps) {
   return (
     <Host matchContents={{ vertical: true }} style={style}>
       <AndroidPicker
-        initialDate={value.toISOString()}
+        initialDate={initialDate}
         displayedComponents={modeToDisplayedComponents(mode)}
         variant={displayToAndroidVariant(display)}
         selectableDates={selectableDates}

package/src/community/datetime-picker/utils.ts

@@ -0,0 +1,21 @@
+// Material3's DatePicker (and the native side's `toUtcDayMillis` bounds conversion) works in UTC
+// days, while `value`, `minimumDate`, and `maximumDate` are local dates — matching
+// `@react-native-community/datetimepicker`. These helpers convert between the two.
+
+/**
+ * Returns the ISO string of the UTC midnight of `value`'s local calendar day, so Material3 shows
+ * the same day the user sees locally.
+ */
+export function localDateToUtcDayISOString(value: Date): string {
+  return new Date(Date.UTC(value.getFullYear(), value.getMonth(), value.getDate())).toISOString();
+}
+
+/**
+ * Converts the UTC-midnight day reported by Material3 back into a local date, keeping the time of
+ * day from `timeOfDay`.
+ */
+export function utcDayToLocalDate(utcDay: Date, timeOfDay: Date): Date {
+  const result = new Date(timeOfDay);
+  result.setFullYear(utcDay.getUTCFullYear(), utcDay.getUTCMonth(), utcDay.getUTCDate());
+  return result;
+}

package/src/community/picker/Picker.android.tsx

@@ -36,6 +36,11 @@ export function Picker<T extends PickerItemValue>(props: PickerProps<T>) {
   const selectedLabel = selectedItem?.label ?? '';
   const labelState = useNativeState(selectedLabel);
 
+  // `useNativeState` only captures its initial value, so push later changes to the field.
+  React.useEffect(() => {
+    labelState.set(selectedLabel);
+  }, [labelState, selectedLabel]);
+
   return (
     <Host style={style} matchContents={{ vertical: true }}>
       <ExposedDropdownMenuBox

package/src/jetpack-compose/modifiers/index.ts

@@ -79,10 +79,24 @@ export const fillMaxWidth = (fraction?: number) => createModifier('fillMaxWidth'
 export const fillMaxHeight = (fraction?: number) => createModifier('fillMaxHeight', { fraction });
 
 /**
- * Sets the exact width of the view.
- * @param value - Width in dp.
+ * Intrinsic width values for the `width` modifier. `Min` is the smallest width at which the content
+ * still draws correctly, and `Max` is the width the content needs when nothing limits it.
  */
-export const width = (value: number) => createModifier('width', { width: value });
+export const IntrinsicSize = { Min: 'min', Max: 'max' } as const;
+// eslint-disable-next-line @typescript-eslint/no-redeclare -- value and type share the name, like an enum
+export type IntrinsicSize = (typeof IntrinsicSize)[keyof typeof IntrinsicSize];
+
+/**
+ * Sets the width of the view to an exact value, or to the minimum or maximum intrinsic width of its
+ * content. The incoming constraints can still make the view narrower or wider than that width.
+ * @param value - Width in dp, or an `IntrinsicSize`. `IntrinsicSize.Min` uses the minimum intrinsic
+ * width, the smallest width at which the content still draws correctly (for a text, its widest word).
+ * `IntrinsicSize.Max` uses the maximum intrinsic width, the width the content needs when nothing
+ * limits it (for a text, a single line).
+ * @see [Compose `width(IntrinsicSize)` modifier](https://developer.android.com/reference/kotlin/androidx/compose/foundation/layout/width.modifier#(androidx.compose.ui.Modifier).width(androidx.compose.foundation.layout.IntrinsicSize))
+ * @see [Intrinsic measurements in Compose layouts](https://developer.android.com/develop/ui/compose/layouts/intrinsic-measurements)
+ */
+export const width = (value: number | IntrinsicSize) => createModifier('width', { width: value });
 
 /**
  * Sets the exact height of the view.

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

@@ -0,0 +1,70 @@
+import { requireNativeView } from 'expo';
+
+import { Slot } from '../SlotView';
+import { createViewModifierEventListener } from '../modifiers/utils';
+import { type CommonViewModifierProps } from '../types';
+
+export interface ArrangementViewProps extends CommonViewModifierProps {
+  /**
+   * The views to arrange. Provide `ArrangementView.Primary` and `ArrangementView.Secondary`.
+   */
+  children: React.ReactNode;
+}
+
+const ArrangementViewNativeView: React.ComponentType<ArrangementViewProps> = requireNativeView(
+  'ExpoUI',
+  'ArrangementViewView'
+);
+
+/**
+ * The primary view of the arrangement.
+ */
+function ArrangementViewPrimary(props: { children: React.ReactNode }) {
+  return <Slot name="primary">{props.children}</Slot>;
+}
+
+/**
+ * The secondary view of the arrangement.
+ */
+function ArrangementViewSecondary(props: { children: React.ReactNode }) {
+  return <Slot name="secondary">{props.children}</Slot>;
+}
+
+ArrangementView.Primary = ArrangementViewPrimary;
+ArrangementView.Secondary = ArrangementViewSecondary;
+
+/**
+ * ArrangementView uses the native [ArrangementView](https://developer.apple.com/documentation/swiftui/arrangementview) view.
+ *
+ * A view that arranges primary and secondary content using an adaptive layout that responds to
+ * the environment.
+ *
+ * > **Note:** Below iOS 27.1, the children render without a container.
+ * @example
+ * ```tsx
+ * <Host style={{ flex: 1 }}>
+ *   <ArrangementView modifiers={[arrangementViewStyle('split')]}>
+ *     <ArrangementView.Primary>
+ *       <NowPlaying />
+ *     </ArrangementView.Primary>
+ *     <ArrangementView.Secondary>
+ *       <Lyrics />
+ *     </ArrangementView.Secondary>
+ *   </ArrangementView>
+ * </Host>
+ * ```
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ */
+export function ArrangementView(props: ArrangementViewProps) {
+  const { modifiers, children, ...restProps } = props;
+
+  return (
+    <ArrangementViewNativeView
+      modifiers={modifiers}
+      {...(modifiers ? createViewModifierEventListener(modifiers) : undefined)}
+      {...restProps}>
+      {children}
+    </ArrangementViewNativeView>
+  );
+}

package/src/swift-ui/index.tsx

@@ -28,6 +28,7 @@ export * from './Menu';
 export * from './NavigationDestination';
 export * from './NavigationLink';
 export * from './NavigationSplitView';
+export * from './ArrangementView';
 export * from './NavigationStack';
 export * from './Picker';
 export * from './ProgressView';

package/src/swift-ui/modifiers/animation/index.ts

@@ -5,6 +5,7 @@ import type {
   ChainableAnimationType,
   InterpolatingSpringAnimationParams,
   SpringAnimationParams,
+  SpringPresetAnimationParams,
   TimingAnimationParams,
 } from './types';
 
@@ -16,6 +17,8 @@ import type {
  * - `spring` accepts [`SpringAnimationParams`](#springanimationparams).
  * - `interpolatingSpring` accepts
  * [`InterpolatingSpringAnimationParams`](#interpolatingspringanimationparams).
+ * - Spring presets (`smooth`, `snappy`, `bouncy`) accept
+ * [`SpringPresetAnimationParams`](#springpresetanimationparams).
  * - Chaining returns [`ChainableAnimationType`](#chainableanimationtype).
  *
  * @example
@@ -80,23 +83,33 @@ export const Animation = {
       duration: params?.duration,
       bounce: params?.bounce,
     }),
+  smooth: (params?: SpringPresetAnimationParams) =>
+    ChainableAnimation({
+      type: 'smooth',
+      duration: params?.duration,
+      extraBounce: params?.extraBounce,
+    }),
+  snappy: (params?: SpringPresetAnimationParams) =>
+    ChainableAnimation({
+      type: 'snappy',
+      duration: params?.duration,
+      extraBounce: params?.extraBounce,
+    }),
+  bouncy: (params?: SpringPresetAnimationParams) =>
+    ChainableAnimation({
+      type: 'bouncy',
+      duration: params?.duration,
+      extraBounce: params?.extraBounce,
+    }),
 
   default: ChainableAnimation({ type: 'default' }),
 };
 
 function ChainableAnimation(animation: AnimationObject): ChainableAnimationType {
-  let _animation: AnimationObject = animation;
-
   return {
-    delay: (delay) => {
-      _animation = { ..._animation, delay };
-      return ChainableAnimation(_animation);
-    },
-    repeat: (params) => {
-      _animation = { ..._animation, ...params };
-      return ChainableAnimation(_animation);
-    },
-    [VALUE_SYMBOL]: () => _animation,
+    delay: (delay) => ChainableAnimation({ ...animation, delay }),
+    repeat: (params) => ChainableAnimation({ ...animation, ...params }),
+    [VALUE_SYMBOL]: () => animation,
   };
 }
 

package/src/swift-ui/modifiers/animation/types.ts

@@ -12,6 +12,9 @@ export type AnimationObject = {
     | 'linear'
     | 'spring'
     | 'interpolatingSpring'
+    | 'smooth'
+    | 'snappy'
+    | 'bouncy'
     | 'default';
   duration?: number;
   response?: number;
@@ -22,6 +25,7 @@ export type AnimationObject = {
   stiffness?: number;
   damping?: number;
   initialVelocity?: number;
+  extraBounce?: number;
   delay?: number;
   repeatCount?: number;
   autoreverses?: boolean;
@@ -84,6 +88,20 @@ export type InterpolatingSpringAnimationParams = {
   bounce?: number;
 };
 
+export type SpringPresetAnimationParams = {
+  /**
+   * The perceptual duration, which defines the pace of the spring (in seconds). This is
+   * approximately equal to the settling duration, but for very bouncy springs, it is the period of
+   * oscillation of the spring.
+   */
+  duration?: number;
+  /**
+   * Bounce added to the base bounce of the preset: 0 for `smooth`, 0.15 for `snappy`, and 0.3 for
+   * `bouncy`. Keep the total below 1: at 1 and above, the spring oscillates without settling.
+   */
+  extraBounce?: number;
+};
+
 export type ChainableAnimationType = {
   /** Adds a delay before the animation starts (in seconds). */
   delay: (delay: number) => ChainableAnimationType;

package/src/swift-ui/modifiers/arrangementModifiers.ts

@@ -0,0 +1,142 @@
+import { createModifier } from './createModifier';
+
+/**
+ * A style that configures an `ArrangementView` with an arrangement.
+ * - `'automatic'`: The default style, which resolves to `'split'`.
+ * - `'split'`: An arrangement view style that places the primary and secondary views side by side along one or more axes.
+ * - `'overlay'`: An arrangement view style that layers the primary view over the secondary view in z-order.
+ */
+export type ArrangementViewStyle = 'automatic' | 'split' | 'overlay';
+
+/**
+ * Sets the style for arrangement views within this view.
+ * @param style - The style to apply.
+ * @param options - The `axes` the arrangement supports. With `'split'`, creates a split arrangement
+ * that supports the given axes. With `'overlay'`, creates an overlay arrangement that supports
+ * laying out its views along the given axes.
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/arrangementviewstyle(_:)).
+ */
+export function arrangementViewStyle(style: 'automatic'): ReturnType<typeof createModifier>;
+export function arrangementViewStyle(
+  style: 'split' | 'overlay',
+  options?: { axes?: 'horizontal' | 'vertical' | 'both' }
+): ReturnType<typeof createModifier>;
+export function arrangementViewStyle(
+  style: ArrangementViewStyle,
+  options?: { axes?: 'horizontal' | 'vertical' | 'both' }
+) {
+  return createModifier('arrangementViewStyle', { style, axes: options?.axes });
+}
+
+/**
+ * The minimum, ideal, and maximum ratios for `splitArrangementLayoutRatio`.
+ */
+export type SplitArrangementLayoutRatioParams = {
+  minHorizontal?: number;
+  idealHorizontal?: number;
+  maxHorizontal?: number;
+  minVertical?: number;
+  idealVertical?: number;
+  maxVertical?: number;
+};
+
+/**
+ * Sets the preferred size ratio for the content of `ArrangementView.Primary` or
+ * `ArrangementView.Secondary` in a split arrangement.
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/splitarrangementlayoutratio(_:)).
+ */
+export function splitArrangementLayoutRatio(ratio: number): ReturnType<typeof createModifier>;
+/**
+ * Sets the size ratio for the content of `ArrangementView.Primary` or `ArrangementView.Secondary`
+ * in a split arrangement.
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/splitarrangementlayoutratio(minhorizontal:idealhorizontal:maxhorizontal:minvertical:idealvertical:maxvertical:)).
+ */
+export function splitArrangementLayoutRatio(
+  ratios: SplitArrangementLayoutRatioParams
+): ReturnType<typeof createModifier>;
+export function splitArrangementLayoutRatio(
+  ratioOrParams: number | SplitArrangementLayoutRatioParams
+) {
+  return createModifier(
+    'splitArrangementLayoutRatio',
+    typeof ratioOrParams === 'number' ? { ratio: ratioOrParams } : ratioOrParams
+  );
+}
+
+/**
+ * The minimum, ideal, and maximum sizes for `splitArrangementLayoutSize`.
+ */
+export type SplitArrangementLayoutSizeParams = {
+  minWidth?: number;
+  idealWidth?: number;
+  maxWidth?: number;
+  minHeight?: number;
+  idealHeight?: number;
+  maxHeight?: number;
+};
+
+/**
+ * Sets the size constraints for the content of `ArrangementView.Primary` or
+ * `ArrangementView.Secondary` in a split arrangement.
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/splitarrangementlayoutsize(minwidth:idealwidth:maxwidth:minheight:idealheight:maxheight:)).
+ */
+export const splitArrangementLayoutSize = (constraints: SplitArrangementLayoutSizeParams) =>
+  createModifier('splitArrangementLayoutSize', constraints);
+
+/**
+ * The split axes on which `splitArrangementFixedLayoutSize` prefers the ideal size of the view.
+ */
+export type SplitArrangementFixedLayoutSizeParams = {
+  /**
+   * Whether to prefer a fixed width for the view in a horizontal split.
+   * @default true
+   */
+  horizontal?: boolean;
+  /**
+   * Whether to prefer a fixed height for the view in a vertical split.
+   * @default true
+   */
+  vertical?: boolean;
+};
+
+/**
+ * Sets the preferred size constraint for the content of `ArrangementView.Primary` or
+ * `ArrangementView.Secondary` in a split arrangement to the ideal size of the view within its
+ * container. The arrangement view prefers this size, but may resize to a smaller size depending on
+ * the priority of the view.
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/splitarrangementfixedlayoutsize(horizontal:vertical:)).
+ */
+export const splitArrangementFixedLayoutSize = (options?: SplitArrangementFixedLayoutSizeParams) =>
+  createModifier('splitArrangementFixedLayoutSize', options);
+
+/**
+ * Sets the horizontal edge that a view in an overlay arrangement occupies when the arrangement
+ * transitions to a horizontal layout.
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/overlayarrangementedge(_:)).
+ */
+export function overlayArrangementEdge(
+  edge: 'leading' | 'trailing'
+): ReturnType<typeof createModifier>;
+/**
+ * Sets the vertical edge that a view in an overlay arrangement occupies when the arrangement
+ * transitions to a vertical layout.
+ * @platform ios 27.1+
+ * @platform tvos 27.1+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/overlayarrangementedge(_:)-4tjwn).
+ */
+export function overlayArrangementEdge(edge: 'top' | 'bottom'): ReturnType<typeof createModifier>;
+export function overlayArrangementEdge(edge: 'top' | 'bottom' | 'leading' | 'trailing') {
+  return createModifier('overlayArrangementEdge', { edge });
+}

package/src/swift-ui/modifiers/containerBackground.ts

@@ -6,8 +6,8 @@ export type ContainerBackgroundPlacement = 'widget' | 'navigation' | 'navigation
 /**
  * Sets the container background of the enclosing container.
  *
- * > **Note:** `navigation` and `navigationSplitView` require iOS 18. On iOS 17 they fall back to
- * > the `widget` placement.
+ * > **Note:** `navigation` and `navigationSplitView` require iOS 18. The `widget` placement works
+ * > only in `expo-widgets` widgets, where the other placements fall back to it on iOS 17.
  *
  * @param style - Any [`ShapeStyle`](#shapestyle): a color, a hierarchical style, a material, or a gradient.
  * @param container - The type of container to apply the background to.