@expo/ui 58.0.11 → 58.0.13

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/hingeObservation.ts

@@ -0,0 +1,91 @@
+import { getStateId, type WorkletCallback } from '../../State';
+import { createModifier, createModifierWithEventListener } from './createModifier';
+
+/**
+ * Status of the device hinge, as reported by SwiftUI's `DeviceHinge.Status`.
+ * `'unknown'` is reserved for a status this version of Expo UI does not recognize.
+ * @platform ios 27.1+
+ */
+export type HingeStatus = 'closed' | 'partiallyOpen' | 'fullyOpen' | 'unknown';
+
+/**
+ * State of the device hinge. Mirrors SwiftUI's `DeviceHinge`.
+ * @platform ios 27.1+
+ */
+export type Hinge = {
+  /**
+   * The current angle of the hinge in degrees, where `0` is closed and `180` is flat. The rate and
+   * granularity of angle updates are system policy, so do not depend on a particular update
+   * frequency or precision. Prefer `status` when you only need to know whether the hinge is closed,
+   * partially open, or fully open.
+   */
+  angle: number;
+  /**
+   * The current status of the hinge, determined by the system from the angle and device orientation.
+   */
+  status: HingeStatus;
+};
+
+/**
+ * The hinge context of the view hierarchy. Mirrors SwiftUI's `DeviceHingeContext`.
+ * @platform ios 27.1+
+ */
+export type HingeContext = {
+  /**
+   * The current hinge, or `null` when the device has no hinge or the view's hierarchy provides no
+   * hinge updates.
+   */
+  hinge: Hinge | null;
+};
+
+/**
+ * A function called with the old and the new hinge context when the hinge context changes.
+ */
+export type HingeChangeHandler = (oldContext: HingeContext, newContext: HingeContext) => void;
+
+/**
+ * Calls the handler when the hinge context of the view hierarchy changes, such as when the user
+ * folds or unfolds the device. The handler receives the old and the new context. Use hinge
+ * state for interactions and effects, not for layout.
+ *
+ * Pass a plain function to run it on the JS thread, or a callback from
+ * [`useWorkletCallback`](../usenativestate/#useworkletcallback) to run it synchronously on the UI
+ * thread, which suits driving a native state value from the continuous `angle`.
+ *
+ * The first call happens when the view appears, and its old context has a `null` hinge. On devices
+ * without a hinge, both contexts have a `null` hinge. The modifier is a no-op on iOS versions earlier
+ * than 27.1 and in builds made with Xcode earlier than 27.1.
+ *
+ * @param handler - Function or worklet callback called with the old and the new hinge context.
+ * @platform ios 27.1+
+ *
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/onhingechange(isenabled:_:)).
+ *
+ * @example
+ * ```tsx
+ * // JS thread
+ * const [hinge, setHinge] = useState<Hinge | null>(null);
+ * <VStack modifiers={[onHingeChange((_, newContext) => setHinge(newContext.hinge))]} />
+ *
+ * // UI thread
+ * const angle = useNativeState(180);
+ * const onHinge = useWorkletCallback((_, newContext) => {
+ *   'worklet';
+ *   angle.value = newContext.hinge?.angle ?? 180;
+ * });
+ * <VStack modifiers={[onHingeChange(onHinge)]} />
+ * ```
+ */
+export const onHingeChange = (
+  handler: HingeChangeHandler | WorkletCallback<HingeChangeHandler>
+) => {
+  if (typeof handler !== 'function') {
+    return createModifier('onHingeChange', { workletCallback: getStateId(handler) });
+  }
+  const callback = handler as HingeChangeHandler;
+  return createModifierWithEventListener(
+    'onHingeChange',
+    (event: { oldContext: HingeContext; newContext: HingeContext }) =>
+      callback(event.oldContext, event.newContext)
+  );
+};

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

@@ -18,6 +18,7 @@ import {
 import { datePickerStyle } from './datePickerStyle';
 import { environment } from './environment';
 import { gaugeStyle } from './gaugeStyle';
+import { onHingeChange } from './hingeObservation';
 import { progressViewStyle } from './progressViewStyle';
 import { onScrollPhaseChange, useScrollGeometryChange } from './scrollObservation';
 import { id, scrollPosition } from './scrollPosition';
@@ -1762,6 +1763,41 @@ export const resizable = (
  */
 export const navigationTitle = (title: string) => createModifier('navigationTitle', { title });
 
+/**
+ * Title display modes for the `navigationBarTitleDisplayMode` modifier.
+ * @platform ios
+ */
+export type NavigationBarTitleDisplayMode = 'automatic' | 'inline' | 'large';
+
+/**
+ * Configures the title display mode for a navigation bar.
+ * @param displayMode - The style to use for displaying the navigation bar title.
+ * @platform ios
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/navigationbartitledisplaymode(_:)).
+ */
+export const navigationBarTitleDisplayMode = (displayMode: NavigationBarTitleDisplayMode) =>
+  createModifier('navigationBarTitleDisplayMode', { displayMode });
+
+/**
+ * Title display modes for the `toolbarTitleDisplayMode` modifier. On tvOS, `large` and
+ * `inlineLarge` have no effect. On macOS, `large` has no effect.
+ * @platform ios 17.0+
+ * @platform tvos 17.0+
+ * @platform macos 14.0+
+ */
+export type ToolbarTitleDisplayMode = 'automatic' | 'inline' | 'inlineLarge' | 'large';
+
+/**
+ * Configures the title display mode for a toolbar.
+ * @param mode - The style to use for displaying the toolbar title.
+ * @platform ios 17.0+
+ * @platform tvos 17.0+
+ * @platform macos 14.0+
+ * @see Official [SwiftUI documentation](https://developer.apple.com/documentation/swiftui/view/toolbartitledisplaymode(_:)).
+ */
+export const toolbarTitleDisplayMode = (mode: ToolbarTitleDisplayMode) =>
+  createModifier('toolbarTitleDisplayMode', { mode });
+
 // =============================================================================
 // Type Definitions
 // =============================================================================
@@ -1861,6 +1897,7 @@ export type BuiltInModifier =
   | ReturnType<typeof scrollPosition>
   | ReturnType<typeof onScrollPhaseChange>
   | NonNullable<ReturnType<typeof useScrollGeometryChange>>
+  | ReturnType<typeof onHingeChange>
   | ReturnType<typeof moveDisabled>
   | ReturnType<typeof deleteDisabled>
   | ReturnType<typeof environment>
@@ -1908,7 +1945,9 @@ export type BuiltInModifier =
   | ReturnType<typeof widgetURL>
   | ReturnType<typeof activityBackgroundTint>
   | ReturnType<typeof containerBackground>
-  | ReturnType<typeof navigationTitle>;
+  | ReturnType<typeof navigationTitle>
+  | ReturnType<typeof navigationBarTitleDisplayMode>
+  | ReturnType<typeof toolbarTitleDisplayMode>;
 
 /**
  * Main ViewModifier type that supports both built-in and 3rd party modifiers.
@@ -1952,6 +1991,7 @@ export * from './pickerStyle';
 export * from './menuOrder';
 export * from './tabViewModifiers';
 export * from './navigationModifiers';
+export * from './arrangementModifiers';
 export * from './datePickerStyle';
 export * from './progressViewStyle';
 export * from './gaugeStyle';
@@ -1961,10 +2001,12 @@ export type { ShapeStyle } from './shapeStyle';
 export * from './scrollPosition';
 export * from './symbolEffect';
 export * from './scrollObservation';
+export * from './hingeObservation';
 export * from './widgets';
 export type {
   TimingAnimationParams,
   SpringAnimationParams,
   InterpolatingSpringAnimationParams,
+  SpringPresetAnimationParams,
   ChainableAnimationType,
 } from './animation/types';

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

@@ -1 +0,0 @@
-1302e48111e4d1b9df2e41d53b5aced4

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

@@ -1 +0,0 @@
-35f9c28864e4c66ebf31d87331aaf606420295dd

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

@@ -1 +0,0 @@
-d6b5917f7e254bed3b859860b39f0cf57b943148a0dc5c25282599caaa5bbf7e

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

@@ -1 +0,0 @@
-7325da1dbb0f220f807982fa7797678dba275209f74efde81b39d4ecf3452573708a111629552ae98257631d5c8e9d26438d10a50172c6d731e247d20f8762c0

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

@@ -1 +0,0 @@
-42294a6398d445ac12b85609173d6710

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

@@ -1 +0,0 @@
-552a8fdfc1afb51afb7bf9f742f2917988ccb39d

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

@@ -1 +0,0 @@
-3c1582041a0a49f0df088ad60c5ee3c2333da74afff9a783f4e31984ef5f975d

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

@@ -1 +0,0 @@
-453c085a9a3f87728a04202f8345587720468598c7873813e572b87013ff025c384008e4c77d5ca54db253df56b5545b6180aec60b0164afce10cb1ad8c128cc

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

@@ -1 +0,0 @@
-1a53961016c8ae739d98017577878f41

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

@@ -1 +0,0 @@
-177d63d30567acf8813edf88c6a61165ae8327d9

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

@@ -1 +0,0 @@
-8c9b268c255ce001213ec694e09cb488a61af94350f20dfa4553b6e65c21574c

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

@@ -1 +0,0 @@
-b782bd23e94df6526eeb28aa8c94a5c719d2ffcb329810adf7d76424071de7f4d817203ac96adc5ccfe50665a0551860756aec9484a769e4f5b03b4f9d3bfb7d

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

@@ -1 +0,0 @@
-7e5efd77a13adde1e485cec64e23b052

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

@@ -1 +0,0 @@
-74675a495c2af28ac07bb6a9bff5900800df5f1b

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

@@ -1 +0,0 @@
-87480436c37f4080a36ee31a7192215c066e69d8df32f237ce1c2d172b84d9c8

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

@@ -1 +0,0 @@
-e78b6109060d7761704f0472a04d1ee83bc40d9e31136840bbb8b79888f16c8084d5cda64a9ccb89cb490eceb21c7154e9df30873c4004958203917d0da0a037